@finesoft/front 0.1.2 → 0.1.3

package/dist/index.d.ts

@@ -9,35 +9,35 @@ import { ViteDevServer } from 'vite';
  * CompoundAction — 组合多个 Action
  */
 /** Action Kind 常量 */
-declare const ACTION_KINDS$2: {
+declare const ACTION_KINDS: {
     FLOW: "flow";
     EXTERNAL_URL: "externalUrl";
     COMPOUND: "compound";
 };
 /** FlowAction — SPA 导航 */
-interface FlowAction$2 {
-    kind: typeof ACTION_KINDS$2.FLOW;
+interface FlowAction {
+    kind: typeof ACTION_KINDS.FLOW;
     url: string;
     /** 展示方式: 默认 push，modal 弹窗 */
     presentationContext?: "default" | "modal";
 }
 /** ExternalUrlAction — 外部链接 */
-interface ExternalUrlAction$2 {
-    kind: typeof ACTION_KINDS$2.EXTERNAL_URL;
+interface ExternalUrlAction {
+    kind: typeof ACTION_KINDS.EXTERNAL_URL;
     url: string;
 }
 /** CompoundAction — 组合 Action */
-interface CompoundAction$2 {
-    kind: typeof ACTION_KINDS$2.COMPOUND;
-    actions: Action$2[];
+interface CompoundAction {
+    kind: typeof ACTION_KINDS.COMPOUND;
+    actions: Action[];
 }
 /** 所有 Action 的联合类型 */
-type Action$2 = FlowAction$2 | ExternalUrlAction$2 | CompoundAction$2;
-declare function isFlowAction(action: Action$2): action is FlowAction$2;
-declare function isExternalUrlAction(action: Action$2): action is ExternalUrlAction$2;
-declare function isCompoundAction(action: Action$2): action is CompoundAction$2;
-declare function makeFlowAction(url: string, presentationContext?: FlowAction$2["presentationContext"]): FlowAction$2;
-declare function makeExternalUrlAction(url: string): ExternalUrlAction$2;
+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;
 
 /**
  * ActionDispatcher — Action 分发器
@@ -47,24 +47,24 @@ declare function makeExternalUrlAction(url: string): ExternalUrlAction$2;
  */
 
 /** Action 处理器函数类型 */
-type ActionHandler$2<A extends Action$2 = Action$2> = (action: A) => Promise<void> | void;
-declare class ActionDispatcher$2 {
+type ActionHandler<A extends Action = Action> = (action: A) => Promise<void> | void;
+declare class ActionDispatcher {
     private handlers;
     private wiredActions;
     /** 注册指定 kind 的 handler（防止重复注册） */
-    onAction<A extends Action$2>(kind: string, handler: ActionHandler$2<A>): void;
+    onAction<A extends Action>(kind: string, handler: ActionHandler<A>): void;
     /** 执行一个 Action（CompoundAction 递归展开） */
-    perform(action: Action$2): Promise<void>;
+    perform(action: Action): Promise<void>;
 }
 
 /**
  * Container — 通用的依赖注入容器
  */
-type Factory$2<T> = () => T;
-declare class Container$2 {
+type Factory<T> = () => T;
+declare class Container {
     private registrations;
     /** 注册依赖（默认单例） */
-    register<T>(key: string, factory: Factory$2<T>, singleton?: boolean): this;
+    register<T>(key: string, factory: Factory<T>, singleton?: boolean): this;
     /** 解析依赖 */
     resolve<T>(key: string): T;
     /** 检查是否已注册 */
@@ -78,7 +78,7 @@ declare class Container$2 {
  */
 
 /** Intent — 描述一个用户意图 */
-interface Intent$2<T = unknown> {
+interface Intent<T = unknown> {
     /** Intent 标识符（用于匹配 Controller） */
     id: string;
     /** 意图参数 */
@@ -87,11 +87,11 @@ interface Intent$2<T = unknown> {
     _returnType?: T;
 }
 /** Intent Controller — 处理特定 intentId 的业务逻辑 */
-interface IntentController$2<T = unknown> {
+interface IntentController<T = unknown> {
     /** Controller 对应的 Intent ID */
     intentId: string;
     /** 执行意图，返回页面数据 */
-    perform(intent: Intent$2<T>, container: Container$2): Promise<T> | T;
+    perform(intent: Intent<T>, container: Container): Promise<T> | T;
 }
 
 /**
@@ -100,12 +100,12 @@ interface IntentController$2<T = unknown> {
  * 注册 IntentController，按 intentId 分发。
  */
 
-declare class IntentDispatcher$2 {
+declare class IntentDispatcher {
     private controllers;
     /** 注册一个 IntentController */
-    register(controller: IntentController$2): void;
+    register(controller: IntentController): void;
     /** 分发 Intent 到对应 Controller */
-    dispatch<T>(intent: Intent$2<T>, container: Container$2): Promise<T>;
+    dispatch<T>(intent: Intent<T>, container: Container): Promise<T>;
     /** 检查是否已注册某个 Intent */
     has(intentId: string): boolean;
 }
@@ -117,14 +117,14 @@ type Level = "debug" | "info" | "warn" | "error";
  *
  * 所有方法返回空字符串，允许在模板中内联使用而不渲染文本。
  */
-interface Logger$1 {
+interface Logger {
     debug(...args: unknown[]): string;
     info(...args: unknown[]): string;
     warn(...args: unknown[]): string;
     error(...args: unknown[]): string;
 }
 interface LoggerFactory {
-    loggerFor(category: string): Logger$1;
+    loggerFor(category: string): Logger;
 }
 
 /**
@@ -168,29 +168,29 @@ declare const DEP_KEYS: {
     readonly METRICS: "metrics";
     readonly FETCH: "fetch";
 };
-interface MakeDependenciesOptions$2 {
+interface MakeDependenciesOptions {
     fetch?: typeof globalThis.fetch;
     language?: string;
     storefront?: string;
     featureFlags?: Record<string, boolean | string | number>;
 }
-declare function makeDependencies(container: Container$2, options?: MakeDependenciesOptions$2): void;
+declare function makeDependencies(container: Container, options?: MakeDependenciesOptions): void;
 
 /**
  * URL 路由器 — URL pattern → Intent + FlowAction
  */
 
 /** 路由匹配结果 */
-interface RouteMatch$2 {
-    intent: Intent$2;
-    action: FlowAction$2;
+interface RouteMatch {
+    intent: Intent;
+    action: FlowAction;
 }
-declare class Router$2 {
+declare class Router {
     private routes;
     /** 添加路由规则 */
     add(pattern: string, intentId: string): this;
     /** 解析 URL → RouteMatch */
-    resolve(urlOrPath: string): RouteMatch$2 | null;
+    resolve(urlOrPath: string): RouteMatch | null;
     /** 获取所有已注册的路由 */
     getRoutes(): string[];
     private extractPath;
@@ -201,7 +201,7 @@ declare class Router$2 {
  * BaseLogger — 抽象日志基类
  */
 
-declare abstract class BaseLogger implements Logger$1 {
+declare abstract class BaseLogger implements Logger {
     protected category: string;
     constructor(category: string);
     abstract debug(...args: unknown[]): string;
@@ -217,11 +217,11 @@ declare abstract class BaseLogger implements Logger$1 {
 declare class CompositeLoggerFactory implements LoggerFactory {
     private readonly factories;
     constructor(factories: LoggerFactory[]);
-    loggerFor(name: string): Logger$1;
+    loggerFor(name: string): Logger;
 }
-declare class CompositeLogger implements Logger$1 {
+declare class CompositeLogger implements Logger {
     private readonly loggers;
-    constructor(loggers: Logger$1[]);
+    constructor(loggers: Logger[]);
     debug(...args: unknown[]): string;
     info(...args: unknown[]): string;
     warn(...args: unknown[]): string;
@@ -240,7 +240,7 @@ declare class ConsoleLogger extends BaseLogger {
     error(...args: unknown[]): string;
 }
 declare class ConsoleLoggerFactory implements LoggerFactory {
-    loggerFor(category: string): Logger$1;
+    loggerFor(category: string): Logger;
 }
 
 /**
@@ -260,7 +260,7 @@ declare function resetFilterCache(): void;
  *
  * 具体页面类型由应用层定义并扩展此接口。
  */
-interface BasePage$2 {
+interface BasePage {
     id: string;
     pageType: string;
     title: string;
@@ -277,24 +277,24 @@ interface BasePage$2 {
  */
 
 /** 预获取的 Intent-Data 对 */
-interface PrefetchedIntent$2 {
-    intent: Intent$2;
+interface PrefetchedIntent {
+    intent: Intent;
     data: unknown;
 }
-declare class PrefetchedIntents$2 {
+declare class PrefetchedIntents {
     private intents;
     private constructor();
     /** 从 PrefetchedIntent 数组创建缓存实例 */
-    static fromArray(items: PrefetchedIntent$2[]): PrefetchedIntents$2;
+    static fromArray(items: PrefetchedIntent[]): PrefetchedIntents;
     /** 创建空缓存实例 */
-    static empty(): PrefetchedIntents$2;
+    static empty(): PrefetchedIntents;
     /**
      * 获取缓存的 Intent 结果（一次性使用）。
      * 命中后从缓存中删除。
      */
-    get<T>(intent: Intent$2<T>): T | undefined;
+    get<T>(intent: Intent<T>): T | undefined;
     /** 检查缓存中是否有某个 Intent 的数据 */
-    has(intent: Intent$2): boolean;
+    has(intent: Intent): boolean;
     /** 缓存中的条目数 */
     get size(): number;
 }
@@ -307,31 +307,31 @@ declare class PrefetchedIntents$2 {
  */
 
 /** Framework 初始化配置 */
-interface FrameworkConfig$2 extends MakeDependenciesOptions$2 {
-    setupRoutes?: (router: Router$2) => void;
-    prefetchedIntents?: PrefetchedIntents$2;
+interface FrameworkConfig extends MakeDependenciesOptions {
+    setupRoutes?: (router: Router) => void;
+    prefetchedIntents?: PrefetchedIntents;
 }
-declare class Framework$2 {
-    readonly container: Container$2;
-    readonly intentDispatcher: IntentDispatcher$2;
-    readonly actionDispatcher: ActionDispatcher$2;
-    readonly router: Router$2;
-    readonly prefetchedIntents: PrefetchedIntents$2;
+declare class Framework {
+    readonly container: Container;
+    readonly intentDispatcher: IntentDispatcher;
+    readonly actionDispatcher: ActionDispatcher;
+    readonly router: Router;
+    readonly prefetchedIntents: PrefetchedIntents;
     private constructor();
     /** 创建并初始化 Framework 实例 */
-    static create(config?: FrameworkConfig$2): Framework$2;
+    static create(config?: FrameworkConfig): Framework;
     /** 分发 Intent — 获取页面数据 */
-    dispatch<T>(intent: Intent$2<T>): Promise<T>;
+    dispatch<T>(intent: Intent<T>): Promise<T>;
     /** 执行 Action — 处理用户交互 */
-    perform(action: Action$2): Promise<void>;
+    perform(action: Action): Promise<void>;
     /** 路由 URL — 将 URL 解析为 Intent + Action */
-    routeUrl(url: string): RouteMatch$2 | null;
+    routeUrl(url: string): RouteMatch | null;
     /** 记录页面访问事件 */
-    didEnterPage(page: BasePage$2): void;
+    didEnterPage(page: BasePage): void;
     /** 注册 Action 处理器 */
-    onAction<A extends Action$2>(kind: string, handler: ActionHandler$2<A>): void;
+    onAction<A extends Action>(kind: string, handler: ActionHandler<A>): void;
     /** 注册 Intent Controller */
-    registerIntent(controller: IntentController$2): void;
+    registerIntent(controller: IntentController): void;
     /** 销毁 Framework 实例 */
     dispose(): void;
 }
@@ -347,13 +347,13 @@ interface BaseShelf {
     shelfType: string;
     title?: string;
     subtitle?: string;
-    seeAllAction?: Action$2;
+    seeAllAction?: Action;
     isHorizontal?: boolean;
 }
 interface BaseItem {
     id: string;
     itemType: string;
-    clickAction?: Action$2;
+    clickAction?: Action;
 }
 
 /**
@@ -462,7 +462,7 @@ declare abstract class HttpClient {
  * }
  * ```
  */
-declare abstract class BaseController<TParams extends Record<string, string | undefined> = Record<string, string>, TResult = unknown> implements IntentController$2<TResult> {
+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;
     /**
@@ -472,7 +472,7 @@ declare abstract class BaseController<TParams extends Record<string, string | un
      * @param container - DI 容器
      * @returns 页面数据
      */
-    abstract execute(params: TParams, container: Container$2): Promise<TResult> | TResult;
+    abstract execute(params: TParams, container: Container): Promise<TResult> | TResult;
     /**
      * 错误回退 — 子类可选覆写
      *
@@ -489,7 +489,7 @@ declare abstract class BaseController<TParams extends Record<string, string | un
      *
      * 自动 try/catch → fallback 模式。
      */
-    perform(intent: Intent$2<TResult>, container: Container$2): Promise<TResult>;
+    perform(intent: Intent<TResult>, container: Container): Promise<TResult>;
 }
 
 /**
@@ -547,7 +547,7 @@ interface RouteDefinition {
      * Controller 实例（可选）。
      * 同一个 intentId 的多条路由只需在第一条提供 controller。
      */
-    controller?: IntentController$2;
+    controller?: IntentController;
 }
 /**
  * 声明式注册路由和 Controller
@@ -566,7 +566,7 @@ interface RouteDefinition {
  * ]);
  * ```
  */
-declare function defineRoutes(framework: Framework$2, definitions: RouteDefinition[]): void;
+declare function defineRoutes(framework: Framework, definitions: RouteDefinition[]): void;
 
 /**
  * LruMap — 固定容量的 LRU 缓存
@@ -610,235 +610,12 @@ declare function buildUrl(path: string, params?: Record<string, string | undefin
  */
 declare function generateUuid(): string;
 
-/**
- * Action 类型定义
- *
- * FlowAction — SPA 内部导航
- * ExternalUrlAction — 打开外部链接
- * CompoundAction — 组合多个 Action
- */
-/** Action Kind 常量 */
-declare const ACTION_KINDS$1: {
-    FLOW: "flow";
-    EXTERNAL_URL: "externalUrl";
-    COMPOUND: "compound";
-};
-/** FlowAction — SPA 导航 */
-interface FlowAction$1 {
-    kind: typeof ACTION_KINDS$1.FLOW;
-    url: string;
-    /** 展示方式: 默认 push，modal 弹窗 */
-    presentationContext?: "default" | "modal";
-}
-/** ExternalUrlAction — 外部链接 */
-interface ExternalUrlAction$1 {
-    kind: typeof ACTION_KINDS$1.EXTERNAL_URL;
-    url: string;
-}
-/** CompoundAction — 组合 Action */
-interface CompoundAction$1 {
-    kind: typeof ACTION_KINDS$1.COMPOUND;
-    actions: Action$1[];
-}
-/** 所有 Action 的联合类型 */
-type Action$1 = FlowAction$1 | ExternalUrlAction$1 | CompoundAction$1;
-
-/**
- * ActionDispatcher — Action 分发器
- *
- * 注册不同 kind 的 handler，按类型分发。
- * CompoundAction 自动展开递归执行。
- */
-
-/** Action 处理器函数类型 */
-type ActionHandler$1<A extends Action$1 = Action$1> = (action: A) => Promise<void> | void;
-declare class ActionDispatcher$1 {
-    private handlers;
-    private wiredActions;
-    /** 注册指定 kind 的 handler（防止重复注册） */
-    onAction<A extends Action$1>(kind: string, handler: ActionHandler$1<A>): void;
-    /** 执行一个 Action（CompoundAction 递归展开） */
-    perform(action: Action$1): Promise<void>;
-}
-
-/**
- * Container — 通用的依赖注入容器
- */
-type Factory$1<T> = () => T;
-declare class Container$1 {
-    private registrations;
-    /** 注册依赖（默认单例） */
-    register<T>(key: string, factory: Factory$1<T>, singleton?: boolean): this;
-    /** 解析依赖 */
-    resolve<T>(key: string): T;
-    /** 检查是否已注册 */
-    has(key: string): boolean;
-    /** 销毁容器，清除所有缓存 */
-    dispose(): void;
-}
-
-/**
- * Intent 类型定义
- */
-
-/** Intent — 描述一个用户意图 */
-interface Intent$1<T = unknown> {
-    /** Intent 标识符（用于匹配 Controller） */
-    id: string;
-    /** 意图参数 */
-    params?: Record<string, string>;
-    /** 预期返回的数据（仅用于类型推断） */
-    _returnType?: T;
-}
-/** Intent Controller — 处理特定 intentId 的业务逻辑 */
-interface IntentController$1<T = unknown> {
-    /** Controller 对应的 Intent ID */
-    intentId: string;
-    /** 执行意图，返回页面数据 */
-    perform(intent: Intent$1<T>, container: Container$1): Promise<T> | T;
-}
-
-/**
- * IntentDispatcher — Intent 分发器
- *
- * 注册 IntentController，按 intentId 分发。
- */
-
-declare class IntentDispatcher$1 {
-    private controllers;
-    /** 注册一个 IntentController */
-    register(controller: IntentController$1): void;
-    /** 分发 Intent 到对应 Controller */
-    dispatch<T>(intent: Intent$1<T>, container: Container$1): Promise<T>;
-    /** 检查是否已注册某个 Intent */
-    has(intentId: string): boolean;
-}
-/**
- * Logger 接口
- *
- * 所有方法返回空字符串，允许在模板中内联使用而不渲染文本。
- */
-interface Logger {
-    debug(...args: unknown[]): string;
-    info(...args: unknown[]): string;
-    warn(...args: unknown[]): string;
-    error(...args: unknown[]): string;
-}
-interface MakeDependenciesOptions$1 {
-    fetch?: typeof globalThis.fetch;
-    language?: string;
-    storefront?: string;
-    featureFlags?: Record<string, boolean | string | number>;
-}
-
-/**
- * URL 路由器 — URL pattern → Intent + FlowAction
- */
-
-/** 路由匹配结果 */
-interface RouteMatch$1 {
-    intent: Intent$1;
-    action: FlowAction$1;
-}
-declare class Router$1 {
-    private routes;
-    /** 添加路由规则 */
-    add(pattern: string, intentId: string): this;
-    /** 解析 URL → RouteMatch */
-    resolve(urlOrPath: string): RouteMatch$1 | null;
-    /** 获取所有已注册的路由 */
-    getRoutes(): string[];
-    private extractPath;
-    private extractQueryParams;
-}
-
-/**
- * BasePage — 所有页面共享的基础属性
- *
- * 具体页面类型由应用层定义并扩展此接口。
- */
-interface BasePage$1 {
-    id: string;
-    pageType: string;
-    title: string;
-    description?: string;
-    url?: string;
-}
-
-/**
- * PrefetchedIntents — SSR 数据缓存
- *
- * 服务端渲染时将 Intent→Data 映射序列化嵌入 HTML，
- * 客户端 hydrate 时提取缓存。Framework.dispatch() 优先查缓存，
- * 命中则直接返回，未命中则走 Controller 调度。
- */
-
-/** 预获取的 Intent-Data 对 */
-interface PrefetchedIntent$1 {
-    intent: Intent$1;
-    data: unknown;
-}
-declare class PrefetchedIntents$1 {
-    private intents;
-    private constructor();
-    /** 从 PrefetchedIntent 数组创建缓存实例 */
-    static fromArray(items: PrefetchedIntent$1[]): PrefetchedIntents$1;
-    /** 创建空缓存实例 */
-    static empty(): PrefetchedIntents$1;
-    /**
-     * 获取缓存的 Intent 结果（一次性使用）。
-     * 命中后从缓存中删除。
-     */
-    get<T>(intent: Intent$1<T>): T | undefined;
-    /** 检查缓存中是否有某个 Intent 的数据 */
-    has(intent: Intent$1): boolean;
-    /** 缓存中的条目数 */
-    get size(): number;
-}
-
-/**
- * Framework — 框架核心类
- *
- * 对应原版 Jet 类，统一管理: DI 容器、Intent 分发、Action 分发、路由、Metrics。
- * 纯 TypeScript，不依赖任何 UI 框架。
- */
-
-/** Framework 初始化配置 */
-interface FrameworkConfig$1 extends MakeDependenciesOptions$1 {
-    setupRoutes?: (router: Router$1) => void;
-    prefetchedIntents?: PrefetchedIntents$1;
-}
-declare class Framework$1 {
-    readonly container: Container$1;
-    readonly intentDispatcher: IntentDispatcher$1;
-    readonly actionDispatcher: ActionDispatcher$1;
-    readonly router: Router$1;
-    readonly prefetchedIntents: PrefetchedIntents$1;
-    private constructor();
-    /** 创建并初始化 Framework 实例 */
-    static create(config?: FrameworkConfig$1): Framework$1;
-    /** 分发 Intent — 获取页面数据 */
-    dispatch<T>(intent: Intent$1<T>): Promise<T>;
-    /** 执行 Action — 处理用户交互 */
-    perform(action: Action$1): Promise<void>;
-    /** 路由 URL — 将 URL 解析为 Intent + Action */
-    routeUrl(url: string): RouteMatch$1 | null;
-    /** 记录页面访问事件 */
-    didEnterPage(page: BasePage$1): void;
-    /** 注册 Action 处理器 */
-    onAction<A extends Action$1>(kind: string, handler: ActionHandler$1<A>): void;
-    /** 注册 Intent Controller */
-    registerIntent(controller: IntentController$1): void;
-    /** 销毁 Framework 实例 */
-    dispose(): void;
-}
-
 /**
  * ExternalUrl Action Handler — 外部链接处理器
  */
 
 interface ExternalUrlDependencies {
-    framework: Framework$1;
+    framework: Framework;
     log: Logger;
 }
 declare function registerExternalUrlHandler(deps: ExternalUrlDependencies): void;
@@ -855,16 +632,16 @@ interface FlowActionCallbacks {
     /** 导航后更新当前路径（替代 currentPath.set()） */
     onNavigate(pathname: string): void;
     /** 模态页面展示（替代 openModal()） */
-    onModal(page: BasePage$1): void;
+    onModal(page: BasePage): void;
 }
 /** 注册 FlowAction handler 所需的依赖 */
 interface FlowActionDependencies {
-    framework: Framework$1;
+    framework: Framework;
     log: Logger;
     callbacks: FlowActionCallbacks;
     /** 更新应用 UI 的回调，page 可以是 Promise */
     updateApp: (props: {
-        page: Promise<BasePage$1> | BasePage$1;
+        page: Promise<BasePage> | BasePage;
         isFirstPage?: boolean;
     }) => void;
 }
@@ -875,11 +652,11 @@ declare function registerFlowActionHandler(deps: FlowActionDependencies): void;
  */
 
 interface ActionHandlerDependencies {
-    framework: Framework$1;
+    framework: Framework;
     log: Logger;
     callbacks: FlowActionCallbacks;
     updateApp: (props: {
-        page: Promise<BasePage$1> | BasePage$1;
+        page: Promise<BasePage> | BasePage;
         isFirstPage?: boolean;
     }) => void;
 }
@@ -898,7 +675,7 @@ declare function registerActionHandlers(deps: ActionHandlerDependencies): void;
 
 interface BrowserAppConfig {
     /** 注册 controllers 和路由的引导函数 */
-    bootstrap: (framework: Framework$1) => void;
+    bootstrap: (framework: Framework) => void;
     /** 默认语言（回退值） */
     defaultLocale?: string;
     /**
@@ -911,10 +688,10 @@ interface BrowserAppConfig {
      * @returns 更新函数，用于后续页面切换
      */
     mount: (target: HTMLElement, context: {
-        framework: Framework$1;
+        framework: Framework;
         locale: string;
     }) => (props: {
-        page: Promise<BasePage$1> | BasePage$1;
+        page: Promise<BasePage> | BasePage;
         isFirstPage?: boolean;
     }) => void;
     /** FlowAction / ExternalUrl 回调 */
@@ -965,224 +742,12 @@ declare function tryScroll(log: Logger, getScrollableElement: () => HTMLElement
  * 从 DOM 反序列化服务端嵌入的数据。
  * 读取 `<script id="serialized-server-data">` 的内容并移除标签。
  */
-declare function deserializeServerData(): PrefetchedIntent$1[] | undefined;
+declare function deserializeServerData(): PrefetchedIntent[] | undefined;
 /**
  * 从 DOM 提取 SSR 数据并构建 PrefetchedIntents 实例。
  * 替代原来的 PrefetchedIntents.fromDom()。
  */
-declare function createPrefetchedIntentsFromDom(): PrefetchedIntents$1;
-
-/**
- * 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;
-
-/**
- * ActionDispatcher — Action 分发器
- *
- * 注册不同 kind 的 handler，按类型分发。
- * CompoundAction 自动展开递归执行。
- */
-
-/** 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>;
-}
-
-/**
- * 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;
-}
-
-/**
- * Intent 类型定义
- */
-
-/** 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;
-}
-
-/**
- * IntentDispatcher — Intent 分发器
- *
- * 注册 IntentController，按 intentId 分发。
- */
-
-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;
-}
-interface MakeDependenciesOptions {
-    fetch?: typeof globalThis.fetch;
-    language?: string;
-    storefront?: string;
-    featureFlags?: Record<string, boolean | string | number>;
-}
-
-/**
- * URL 路由器 — URL pattern → Intent + FlowAction
- */
-
-/** 路由匹配结果 */
-interface RouteMatch {
-    intent: Intent;
-    action: FlowAction;
-}
-declare class Router {
-    private routes;
-    /** 添加路由规则 */
-    add(pattern: string, intentId: string): this;
-    /** 解析 URL → RouteMatch */
-    resolve(urlOrPath: string): RouteMatch | null;
-    /** 获取所有已注册的路由 */
-    getRoutes(): string[];
-    private extractPath;
-    private extractQueryParams;
-}
-
-/**
- * BasePage — 所有页面共享的基础属性
- *
- * 具体页面类型由应用层定义并扩展此接口。
- */
-interface BasePage {
-    id: string;
-    pageType: string;
-    title: string;
-    description?: string;
-    url?: string;
-}
-
-/**
- * PrefetchedIntents — SSR 数据缓存
- *
- * 服务端渲染时将 Intent→Data 映射序列化嵌入 HTML，
- * 客户端 hydrate 时提取缓存。Framework.dispatch() 优先查缓存，
- * 命中则直接返回，未命中则走 Controller 调度。
- */
-
-/** 预获取的 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;
-}
-
-/**
- * Framework — 框架核心类
- *
- * 对应原版 Jet 类，统一管理: DI 容器、Intent 分发、Action 分发、路由、Metrics。
- * 纯 TypeScript，不依赖任何 UI 框架。
- */
-
-/** 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 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;
-    /** 销毁 Framework 实例 */
-    dispose(): void;
-}
+declare function createPrefetchedIntentsFromDom(): PrefetchedIntents;
 
 /**
  * ssrRender — 通用 SSR 渲染管线
@@ -1392,4 +957,4 @@ declare function startServer(options: StartServerOptions): Promise<{
     vite?: ViteDevServer;
 }>;
 
-export { ACTION_KINDS$2 as ACTION_KINDS, type Action$2 as Action, ActionDispatcher$2 as ActionDispatcher, type ActionHandler$2 as ActionHandler, type ActionHandlerDependencies, type AsyncMapper, BaseController, type BaseItem, BaseLogger, type BasePage$2 as BasePage, type BaseShelf, type BrowserAppConfig, CompositeLogger, CompositeLoggerFactory, type CompoundAction$2 as CompoundAction, ConsoleLogger, ConsoleLoggerFactory, Container$2 as Container, DEP_KEYS, type ExternalUrlAction$2 as ExternalUrlAction, type ExternalUrlDependencies, type FeatureFlags, type FlowAction$2 as FlowAction, type FlowActionCallbacks, type FlowActionDependencies, Framework$2 as Framework, type FrameworkConfig$2 as FrameworkConfig, History, HttpClient, type HttpClientConfig, HttpError, type InjectSSROptions, type Intent$2 as Intent, type IntentController$2 as IntentController, IntentDispatcher$2 as IntentDispatcher, type Locale, type Logger$1 as Logger, type LoggerFactory, type Logger$1 as LoggerInterface, LruMap, type Mapper, type MetricsRecorder, type Net, type None, type Optional, type PrefetchedIntent$2 as PrefetchedIntent, PrefetchedIntents$2 as PrefetchedIntents, type RouteDefinition, type RouteMatch$2 as RouteMatch, Router$2 as Router, type RuntimeInfo, type SSRAppOptions, type SSRModule, type SSRRenderConfig, type SSRRenderOptions, type SSRRenderResult, type ServerConfig, type ServerInstance, type StartServerOptions, type Storage, buildUrl, createPrefetchedIntentsFromDom, createSSRApp, createSSRRender, createServer, defineRoutes, deserializeServerData, detectRuntime, generateUuid, getBaseUrl, injectSSRContent, isCompoundAction, isExternalUrlAction, isFlowAction, isNone, isSome, makeDependencies, makeExternalUrlAction, makeFlowAction, mapEach, parseAcceptLanguage, pipe, pipeAsync, registerActionHandlers, registerExternalUrlHandler, registerFlowActionHandler, removeHost, removeQueryParams, removeScheme, resetFilterCache, resolveRoot, serializeServerData, shouldLog, ssrRender, stableStringify, startBrowserApp, startServer, tryScroll };
+export { ACTION_KINDS, type Action, ActionDispatcher, type ActionHandler, type ActionHandlerDependencies, type AsyncMapper, BaseController, type BaseItem, BaseLogger, type BasePage, type BaseShelf, type BrowserAppConfig, CompositeLogger, CompositeLoggerFactory, type CompoundAction, ConsoleLogger, ConsoleLoggerFactory, Container, DEP_KEYS, type ExternalUrlAction, type ExternalUrlDependencies, type FeatureFlags, type FlowAction, type FlowActionCallbacks, type FlowActionDependencies, Framework, type FrameworkConfig, History, HttpClient, type HttpClientConfig, HttpError, type InjectSSROptions, type Intent, type IntentController, IntentDispatcher, type Locale, type Logger, type LoggerFactory, type Logger as LoggerInterface, LruMap, type Mapper, type MetricsRecorder, type Net, type None, type Optional, type PrefetchedIntent, PrefetchedIntents, type RouteDefinition, type RouteMatch, Router, type RuntimeInfo, type SSRAppOptions, type SSRModule, type SSRRenderConfig, type SSRRenderOptions, type SSRRenderResult, type ServerConfig, type ServerInstance, type StartServerOptions, type Storage, buildUrl, createPrefetchedIntentsFromDom, createSSRApp, createSSRRender, createServer, defineRoutes, deserializeServerData, detectRuntime, generateUuid, getBaseUrl, injectSSRContent, isCompoundAction, isExternalUrlAction, isFlowAction, isNone, isSome, makeDependencies, makeExternalUrlAction, makeFlowAction, mapEach, parseAcceptLanguage, pipe, pipeAsync, registerActionHandlers, registerExternalUrlHandler, registerFlowActionHandler, removeHost, removeQueryParams, removeScheme, resetFilterCache, resolveRoot, serializeServerData, shouldLog, ssrRender, stableStringify, startBrowserApp, startServer, tryScroll };