@ubean/routes 0.4.5 → 0.4.6

package/dist/index.d.ts

@@ -8,15 +8,15 @@ import { FetchAdapter } from "@soybeanjs/fetch";
 interface MiddlewareChain extends Array<MiddlewareHandler> {
   __routeMeta?: RouteMeta$1;
 }
-declare function defineHandler<I extends Input$1 = {}, R extends HandlerResponse<any> = any>(handler1: H<UbeanEnv$1, any, I, R>): [H<UbeanEnv$1, any, I, R>];
-declare function defineHandler<I extends Input$1 = {}, I2 extends Input$1 = I, R extends HandlerResponse<any> = any, R2 extends HandlerResponse<any> = any>(handler1: H<UbeanEnv$1, any, I, R>, handler2: H<UbeanEnv$1, any, I & I2, R2>): [H<UbeanEnv$1, any, I, R>, H<UbeanEnv$1, any, I & I2, R2>];
-declare function defineHandler<I extends Input$1 = {}, I2 extends Input$1 = I, I3 extends Input$1 = I & I2, R extends HandlerResponse<any> = any, R2 extends HandlerResponse<any> = any, R3 extends HandlerResponse<any> = any>(handler1: H<UbeanEnv$1, any, I, R>, handler2: H<UbeanEnv$1, any, I2, R2>, handler3: H<UbeanEnv$1, any, I3, R3>): [H<UbeanEnv$1, any, I, R>, H<UbeanEnv$1, any, I2, R2>, H<UbeanEnv$1, any, I3, R3>];
-declare function defineHandler<I extends Input$1 = {}, I2 extends Input$1 = I, I3 extends Input$1 = I & I2, I4 extends Input$1 = I & I2 & I3, R extends HandlerResponse<any> = any, R2 extends HandlerResponse<any> = any, R3 extends HandlerResponse<any> = any, R4 extends HandlerResponse<any> = any>(handler1: H<UbeanEnv$1, any, I, R>, handler2: H<UbeanEnv$1, any, I2, R2>, handler3: H<UbeanEnv$1, any, I3, R3>, handler4: H<UbeanEnv$1, any, I4, R4>): [H<UbeanEnv$1, any, I, R>, H<UbeanEnv$1, any, I2, R2>, H<UbeanEnv$1, any, I3, R3>, H<UbeanEnv$1, any, I4, R4>];
-declare function defineHandler<I extends Input$1 = {}, I2 extends Input$1 = I, I3 extends Input$1 = I & I2, I4 extends Input$1 = I & I2 & I3, I5 extends Input$1 = I & I2 & I3 & I4, R extends HandlerResponse<any> = any, R2 extends HandlerResponse<any> = any, R3 extends HandlerResponse<any> = any, R4 extends HandlerResponse<any> = any, R5 extends HandlerResponse<any> = any>(handler1: H<UbeanEnv$1, any, I, R>, handler2: H<UbeanEnv$1, any, I2, R2>, handler3: H<UbeanEnv$1, any, I3, R3>, handler4: H<UbeanEnv$1, any, I4, R4>, handler5: H<UbeanEnv$1, any, I5, R5>): [H<UbeanEnv$1, any, I, R>, H<UbeanEnv$1, any, I2, R2>, H<UbeanEnv$1, any, I3, R3>, H<UbeanEnv$1, any, I4, R4>, H<UbeanEnv$1, any, I5, R5>];
-declare function isHandlerChain(obj: unknown): obj is MiddlewareChain;
-declare function extractRouteMeta(handlers: MiddlewareHandler[]): RouteMeta$1;
-declare function defineHandlerMeta(meta: Partial<RouteMeta$1>): (_c: Context<UbeanEnv$1>, next: Next) => Promise<void>;
-declare function defineMiddleware(handler: MiddlewareHandler<UbeanEnv$1>): MiddlewareHandler<UbeanEnv$1>;
+export declare function defineHandler<I extends Input$1 = {}, R extends HandlerResponse<any> = any>(handler1: H<UbeanEnv$1, any, I, R>): [H<UbeanEnv$1, any, I, R>];
+export declare function defineHandler<I extends Input$1 = {}, I2 extends Input$1 = I, R extends HandlerResponse<any> = any, R2 extends HandlerResponse<any> = any>(handler1: H<UbeanEnv$1, any, I, R>, handler2: H<UbeanEnv$1, any, I & I2, R2>): [H<UbeanEnv$1, any, I, R>, H<UbeanEnv$1, any, I & I2, R2>];
+export declare function defineHandler<I extends Input$1 = {}, I2 extends Input$1 = I, I3 extends Input$1 = I & I2, R extends HandlerResponse<any> = any, R2 extends HandlerResponse<any> = any, R3 extends HandlerResponse<any> = any>(handler1: H<UbeanEnv$1, any, I, R>, handler2: H<UbeanEnv$1, any, I2, R2>, handler3: H<UbeanEnv$1, any, I3, R3>): [H<UbeanEnv$1, any, I, R>, H<UbeanEnv$1, any, I2, R2>, H<UbeanEnv$1, any, I3, R3>];
+export declare function defineHandler<I extends Input$1 = {}, I2 extends Input$1 = I, I3 extends Input$1 = I & I2, I4 extends Input$1 = I & I2 & I3, R extends HandlerResponse<any> = any, R2 extends HandlerResponse<any> = any, R3 extends HandlerResponse<any> = any, R4 extends HandlerResponse<any> = any>(handler1: H<UbeanEnv$1, any, I, R>, handler2: H<UbeanEnv$1, any, I2, R2>, handler3: H<UbeanEnv$1, any, I3, R3>, handler4: H<UbeanEnv$1, any, I4, R4>): [H<UbeanEnv$1, any, I, R>, H<UbeanEnv$1, any, I2, R2>, H<UbeanEnv$1, any, I3, R3>, H<UbeanEnv$1, any, I4, R4>];
+export declare function defineHandler<I extends Input$1 = {}, I2 extends Input$1 = I, I3 extends Input$1 = I & I2, I4 extends Input$1 = I & I2 & I3, I5 extends Input$1 = I & I2 & I3 & I4, R extends HandlerResponse<any> = any, R2 extends HandlerResponse<any> = any, R3 extends HandlerResponse<any> = any, R4 extends HandlerResponse<any> = any, R5 extends HandlerResponse<any> = any>(handler1: H<UbeanEnv$1, any, I, R>, handler2: H<UbeanEnv$1, any, I2, R2>, handler3: H<UbeanEnv$1, any, I3, R3>, handler4: H<UbeanEnv$1, any, I4, R4>, handler5: H<UbeanEnv$1, any, I5, R5>): [H<UbeanEnv$1, any, I, R>, H<UbeanEnv$1, any, I2, R2>, H<UbeanEnv$1, any, I3, R3>, H<UbeanEnv$1, any, I4, R4>, H<UbeanEnv$1, any, I5, R5>];
+export declare function isHandlerChain(obj: unknown): obj is MiddlewareChain;
+export declare function extractRouteMeta(handlers: MiddlewareHandler[]): RouteMeta$1;
+export declare function defineHandlerMeta(meta: Partial<RouteMeta$1>): (_c: Context<UbeanEnv$1>, next: Next) => Promise<void>;
+export declare function defineMiddleware(handler: MiddlewareHandler<UbeanEnv$1>): MiddlewareHandler<UbeanEnv$1>;
 //#endregion
 //#region src/server-router.d.ts
 interface CompiledRoute {
@@ -44,7 +44,7 @@ interface CompiledLayout {
   filePath: string;
   isDefault: boolean;
 }
-declare class UbeanRouter {
+export declare class UbeanRouter {
   private apiContext;
   private middlewares;
   private pages;
@@ -63,14 +63,14 @@ declare class UbeanRouter {
   getLayouts(): CompiledLayout[];
   getPageRouteNames(): string[];
 }
-declare function useRouter(): UbeanRouter;
+export declare function useRouter(): UbeanRouter;
 /**
  * 创建服务端 rou3 router 实例(无参数)。
  *
  * 命名说明:与 `@ubean/client` 的 `createUbeanRouter`(Vue Router 工厂,
  * 接受 options)曾是同名冲突,服务端版本改名 `createServerRouter` 彻底消歧。
  */
-declare function createServerRouter(): UbeanRouter;
+export declare function createServerRouter(): UbeanRouter;
 //#endregion
 //#region src/isr.d.ts
 /**
@@ -115,34 +115,34 @@ interface IsrServeOptions {
   /** cache store(必传 —— 由调用方通过 RegisterOptions.cacheStore 注入) */
   store: IsrCacheStore;
 }
-declare function buildIsrCacheKey(pathname: string): string;
+export declare function buildIsrCacheKey(pathname: string): string;
 /**
  * 读取缓存的 ISR entry(仅未过期)。
  */
-declare function getIsrCache(store: IsrCacheStore, pathname: string): Promise<IsrCacheEntry | undefined>;
+export declare function getIsrCache(store: IsrCacheStore, pathname: string): Promise<IsrCacheEntry | undefined>;
 /**
  * 读取缓存的 ISR entry(即使已过期,用于 SWR)。
  * 后端不支持 `peek` 时退化为 `get`(无 SWR)。
  */
-declare function getStaleIsrCache(store: IsrCacheStore, pathname: string): Promise<IsrCacheEntry | undefined>;
+export declare function getStaleIsrCache(store: IsrCacheStore, pathname: string): Promise<IsrCacheEntry | undefined>;
 /**
  * 写入 ISR 缓存。
  */
-declare function setIsrCache(store: IsrCacheStore, pathname: string, entry: IsrCacheEntry, ttl: number): Promise<void>;
+export declare function setIsrCache(store: IsrCacheStore, pathname: string, entry: IsrCacheEntry, ttl: number): Promise<void>;
 /**
  * 失效指定路径的 ISR 缓存。需要调用方提供 store(避免本包依赖全局单例)。
  */
-declare function invalidateIsrCache(store: IsrCacheStore, pathname: string): Promise<boolean>;
+export declare function invalidateIsrCache(store: IsrCacheStore, pathname: string): Promise<boolean>;
 /**
  * 失效所有匹配模式的 ISR 缓存。仅对内存存储有效(读取底层 Map)。
  */
-declare function invalidateIsrCachePattern(store: IsrCacheStore, pattern: RegExp): Promise<number>;
+export declare function invalidateIsrCachePattern(store: IsrCacheStore, pattern: RegExp): Promise<number>;
 /**
  * 判断 entry 是否已过期。配合 `getStaleIsrCache` 用于 SWR 判定。
  * 仅内存存储可用 —— 其他后端在 `getStaleIsrCache` 已退化为 `get`(永远 fresh),
  * 不会进入此分支。
  */
-declare function isIsrEntryStale(pathname: string, store: IsrCacheStore): boolean;
+export declare function isIsrEntryStale(pathname: string, store: IsrCacheStore): boolean;
 /**
  * ISR 主入口:检查缓存 → 命中则返回,未命中/过期则调用 render 重新生成。
  *
@@ -153,12 +153,12 @@ declare function isIsrEntryStale(pathname: string, store: IsrCacheStore): boolea
  * 过期时删除 entry 导致 SWR 无法读取旧内容。后端不支持 `peek` 时退化为 `get`
  * (SWR 自动降级为同步重新生成)。
  */
-declare function serveIsr(_c: Context<UbeanEnv$1>, options: IsrServeOptions): Promise<Response | undefined>;
+export declare function serveIsr(_c: Context<UbeanEnv$1>, options: IsrServeOptions): Promise<Response | undefined>;
 /**
  * 从 context 读取匹配到的 routeRule,提取 ISR 规则。
  * 返回 `undefined` 表示该路由未启用 ISR。
  */
-declare function getIsrRuleFromContext(c: Context<UbeanEnv$1>): IsrRule$1 | undefined;
+export declare function getIsrRuleFromContext(c: Context<UbeanEnv$1>): IsrRule$1 | undefined;
 //#endregion
 //#region src/router.d.ts
 /**
@@ -234,14 +234,14 @@ interface RegisterOptions {
    */
   colorModeScript?: string;
 }
-declare function convertUbeanRoutePath(path: string): string;
-declare function sortPagesForRegistration<T extends {
+export declare function convertUbeanRoutePath(path: string): string;
+export declare function sortPagesForRegistration<T extends {
   route: string;
 }>(pages: readonly T[]): T[];
-declare function registerApiRoutes(app: RouteRegistrar, options: RegisterOptions): Promise<void>;
-declare function registerPageRoutes(app: RouteRegistrar, options: RegisterOptions): Promise<void>;
-declare function registerRoutes(app: RouteRegistrar, options: RegisterOptions): Promise<void>;
-declare function createRouteLoader(importMetaGlob: Record<string, () => Promise<any>>): {
+export declare function registerApiRoutes(app: RouteRegistrar, options: RegisterOptions): Promise<void>;
+export declare function registerPageRoutes(app: RouteRegistrar, options: RegisterOptions): Promise<void>;
+export declare function registerRoutes(app: RouteRegistrar, options: RegisterOptions): Promise<void>;
+export declare function createRouteLoader(importMetaGlob: Record<string, () => Promise<any>>): {
   [k: string]: () => Promise<any>;
 };
 //#endregion
@@ -254,7 +254,7 @@ declare function createRouteLoader(importMetaGlob: Record<string, () => Promise<
  * - target containing `$1` receives the captured suffix without a leading slash
  * - absolute `https://…` targets keep the origin and transform the pathname
  */
-declare function applyPathTransform(requestPath: string, rulePath: string, target: string): string;
+export declare function applyPathTransform(requestPath: string, rulePath: string, target: string): string;
 //#endregion
 //#region src/route-rules.d.ts
 interface CompiledRouteRule {
@@ -270,14 +270,14 @@ interface RouteRulesMiddlewareOptions {
    */
   dispatch?: (request: Request) => Promise<Response>;
 }
-declare function compileRouteRules(rules: Record<string, RouteRule$1>): CompiledRouteRule[];
+export declare function compileRouteRules(rules: Record<string, RouteRule$1>): CompiledRouteRule[];
 /**
  * 规范化 `isr` 字段为 `IsrRule` 对象形式。
  * `number` → `{ ttl: n }`,`undefined` → `undefined`。
  */
-declare function normalizeIsrRule(isr: RouteRule$1['isr']): IsrRule$1 | undefined;
-declare function matchRouteRules(path: string, compiledRules: CompiledRouteRule[]): RouteRule$1;
-declare function createRouteRulesMiddleware(rules: Record<string, RouteRule$1>, options?: RouteRulesMiddlewareOptions): (c: Context, next: Next) => Promise<Response | undefined>;
+export declare function normalizeIsrRule(isr: RouteRule$1['isr']): IsrRule$1 | undefined;
+export declare function matchRouteRules(path: string, compiledRules: CompiledRouteRule[]): RouteRule$1;
+export declare function createRouteRulesMiddleware(rules: Record<string, RouteRule$1>, options?: RouteRulesMiddlewareOptions): (c: Context, next: Next) => Promise<Response | undefined>;
 //#endregion
 //#region src/select-ssr.d.ts
 type SelectSsrValue = boolean | 'streaming' | 'data-only';
@@ -299,8 +299,8 @@ interface ResolvedSelectSsr {
  * the global exclude list. Glob exclude stays backward-compatible (CSR shell
  * still runs loader). Explicit `ssr: false` skips the loader.
  */
-declare function resolveSelectSsr(input: ResolveSelectSsrInput): ResolvedSelectSsr;
-declare function ssrModeHeader(mode: SelectSsrMode): string;
+export declare function resolveSelectSsr(input: ResolveSelectSsrInput): ResolvedSelectSsr;
+export declare function ssrModeHeader(mode: SelectSsrMode): string;
 //#endregion
 //#region src/actions/define.d.ts
 interface DefineActionOptions {
@@ -330,19 +330,19 @@ interface DefineActionOptions {
  * output). On validation failure, the action returns an `ActionResult`
  * with `errors` set to the schema's issue messages.
  */
-declare function defineAction<TOutput>(schema: ActionSchema$1<TOutput>, handler: ActionHandler$1<TOutput, unknown>, options?: DefineActionOptions): ServerAction$1<TOutput, unknown>;
+export declare function defineAction<TOutput>(schema: ActionSchema$1<TOutput>, handler: ActionHandler$1<TOutput, unknown>, options?: DefineActionOptions): ServerAction$1<TOutput, unknown>;
 /**
  * Define a server action without a schema.
  *
  * The handler receives the raw input (FormData or parsed JSON object).
  */
-declare function defineAction<TInput = unknown, TOutput = unknown>(handler: ActionHandler$1<TInput, TOutput>, options?: DefineActionOptions): ServerAction$1<TInput, TOutput>;
+export declare function defineAction<TInput = unknown, TOutput = unknown>(handler: ActionHandler$1<TInput, TOutput>, options?: DefineActionOptions): ServerAction$1<TInput, TOutput>;
 /**
  * Type-safe server function. Same ID, registry, and `POST /__actions` RPC as
  * `defineAction` — use this alias when the function is a loader/query as well
  * as a mutation. Do not invent a second RPC.
  */
-declare const defineServerFn: typeof defineAction;
+export declare const defineServerFn: typeof defineAction;
 /**
  * Parse a Request body into a plain object suitable for action handlers.
  *
@@ -351,8 +351,8 @@ declare const defineServerFn: typeof defineAction;
  *   from FormData entries (string values, files skipped)
  * - Otherwise → empty object (handler can read `ctx.request` directly)
  */
-declare function parseActionInput(request: Request): Promise<Record<string, unknown>>;
-declare function validateActionInput<T>(schema: ActionSchema$1<T>, input: unknown): {
+export declare function parseActionInput(request: Request): Promise<Record<string, unknown>>;
+export declare function validateActionInput<T>(schema: ActionSchema$1<T>, input: unknown): {
   success: true;
   data: T;
 } | {
@@ -367,7 +367,7 @@ declare function validateActionInput<T>(schema: ActionSchema$1<T>, input: unknow
  * - Other thrown error → `{ error: { message }, status: 500 }`
  * - Plain value → `{ data: value, status: 200 }`
  */
-declare function normalizeActionResult(result: unknown, error: unknown, failureStatus?: number): {
+export declare function normalizeActionResult(result: unknown, error: unknown, failureStatus?: number): {
   data?: unknown;
   error?: {
     message: string;
@@ -383,17 +383,17 @@ declare function normalizeActionResult(result: unknown, error: unknown, failureS
  * - `context`: the Hono context (for `c.set`, `c.get`, etc.)
  * - `params`: route params from `c.req.param()`
  */
-declare function buildActionContext(c: Context<UbeanEnv$1>): ActionContext$1;
+export declare function buildActionContext(c: Context<UbeanEnv$1>): ActionContext$1;
 //#endregion
 //#region src/actions/request-context.d.ts
 interface ActionContextStorage {
   getStore(): ActionContext$1 | undefined;
   run<T>(ctx: ActionContext$1, fn: () => T): T;
 }
-declare function bindActionContextStorage(storage: ActionContextStorage): void;
-declare function getActionContext(): ActionContext$1 | undefined;
-declare function runWithActionContext<T>(ctx: ActionContext$1, fn: () => T): T;
-declare function createDetachedActionContext(request?: Request): ActionContext$1;
+export declare function bindActionContextStorage(storage: ActionContextStorage): void;
+export declare function getActionContext(): ActionContext$1 | undefined;
+export declare function runWithActionContext<T>(ctx: ActionContext$1, fn: () => T): T;
+export declare function createDetachedActionContext(request?: Request): ActionContext$1;
 //#endregion
 //#region src/actions/openapi.d.ts
 /**
@@ -402,7 +402,7 @@ declare function createDetachedActionContext(request?: Request): ActionContext$1
  * Per-action operations stay on the same endpoint (id in the body) so this
  * does not create a second RPC surface.
  */
-declare function describeActionsOpenApi(): {
+export declare function describeActionsOpenApi(): {
   paths: Record<string, {
     post: {
       summary: string;
@@ -435,13 +435,13 @@ declare function describeActionsOpenApi(): {
  * @param exportName The export name (e.g. `login`, `default`)
  * @returns A stable action ID string
  */
-declare function createActionId(filePath: string, exportName: string): string;
+export declare function createActionId(filePath: string, exportName: string): string;
 /**
  * Validate that a string is a well-formed action ID.
  *
  * Used by the dispatcher to reject malformed requests early.
  */
-declare function isValidActionId(id: string): boolean;
+export declare function isValidActionId(id: string): boolean;
 //#endregion
 //#region src/actions/registry.d.ts
 /**
@@ -454,31 +454,31 @@ declare function isValidActionId(id: string): boolean;
  * no-op (HMR-safe: re-registering the same action on hot reload doesn't
  * throw).
  */
-declare function registerAction(action: ServerAction$1): void;
+export declare function registerAction(action: ServerAction$1): void;
 /**
  * Look up a registered server action by ID.
  */
-declare function getAction(id: ActionId$1): ServerAction$1 | undefined;
+export declare function getAction(id: ActionId$1): ServerAction$1 | undefined;
 /**
  * Check whether an action with the given ID is registered.
  */
-declare function hasAction(id: ActionId$1): boolean;
+export declare function hasAction(id: ActionId$1): boolean;
 /**
  * List all registered actions (for debugging / DevTools).
  */
-declare function listActions(): ServerAction$1[];
+export declare function listActions(): ServerAction$1[];
 /**
  * Clear the registry (for tests).
  *
  * Not intended for application code — actions are registered once at
  * module load and remain for the lifetime of the process.
  */
-declare function clearActions(): void;
+export declare function clearActions(): void;
 /**
  * Register a map of actions at once (bulk registration helper for the
  * Vite plugin's virtual module).
  */
-declare function registerActions(actions: ServerAction$1[]): void;
+export declare function registerActions(actions: ServerAction$1[]): void;
 //#endregion
 //#region src/actions/dispatch.d.ts
 /**
@@ -495,7 +495,7 @@ declare function registerActions(actions: ServerAction$1[]): void;
  * Returns an `ActionResult` (serializable). When the action ID is unknown
  * or invalid, returns a 404 error result without throwing.
  */
-declare function dispatchAction(actionId: string, c: Context<UbeanEnv$1>, preParsedInput?: unknown): Promise<ActionResult$1>;
+export declare function dispatchAction(actionId: string, c: Context<UbeanEnv$1>, preParsedInput?: unknown): Promise<ActionResult$1>;
 /**
  * Run an arbitrary `ServerAction` against the given Hono context.
  *
@@ -507,7 +507,7 @@ declare function dispatchAction(actionId: string, c: Context<UbeanEnv$1>, prePar
  * has already read the request body — e.g. the RPC middleware extracting
  * the `{ id, args }` envelope).
  */
-declare function runAction<TInput, TOutput>(action: ServerAction$1<TInput, TOutput>, c: Context<UbeanEnv$1>, preParsedInput?: unknown): Promise<ActionResult$1<TOutput>>;
+export declare function runAction<TInput, TOutput>(action: ServerAction$1<TInput, TOutput>, c: Context<UbeanEnv$1>, preParsedInput?: unknown): Promise<ActionResult$1<TOutput>>;
 /**
  * Run a page-level form action by name (SvelteKit-style `?/name` convention).
  *
@@ -533,7 +533,7 @@ declare function runAction<TInput, TOutput>(action: ServerAction$1<TInput, TOutp
  * `ActionResult` into an HTTP response (HTML for browser navigation,
  * JSON for SPA `submit()` calls).
  */
-declare function runPageAction(actions: Record<string, ServerAction$1>, actionName: string, c: Context<UbeanEnv$1>): Promise<ActionResult$1 | null>;
+export declare function runPageAction(actions: Record<string, ServerAction$1>, actionName: string, c: Context<UbeanEnv$1>): Promise<ActionResult$1 | null>;
 //#endregion
 //#region src/actions/constants.d.ts
 /**
@@ -542,8 +542,8 @@ declare function runPageAction(actions: Record<string, ServerAction$1>, actionNa
  * Kept in a leaf module so the browser runtime can import them without
  * pulling the Hono middleware barrel.
  */
-declare const ACTIONS_ENDPOINT = "/__actions";
-declare const ACTION_RESPONSE_HEADER = "x-ubean-action";
+export declare const ACTIONS_ENDPOINT = "/__actions";
+export declare const ACTION_RESPONSE_HEADER = "x-ubean-action";
 //#endregion
 //#region src/actions/middleware.d.ts
 /**
@@ -563,14 +563,14 @@ declare const ACTION_RESPONSE_HEADER = "x-ubean-action";
  * The middleware is auto-registered by ubean's dev server / production
  * server setup — users don't need to mount it manually.
  */
-declare function createActionsMiddleware(): MiddlewareHandler<UbeanEnv$1>;
+export declare function createActionsMiddleware(): MiddlewareHandler<UbeanEnv$1>;
 /**
  * Check whether a request targets the actions endpoint.
  *
  * Used by route registrars to skip registering regular API routes for
  * the `/__actions` path.
  */
-declare function isActionsRequest(c: {
+export declare function isActionsRequest(c: {
   req: {
     path: string;
     method: string;
@@ -581,7 +581,7 @@ declare function isActionsRequest(c: {
  *
  * Used by the client `callAction()` to validate the response shape.
  */
-declare function isActionResponse(response: Response): boolean;
+export declare function isActionResponse(response: Response): boolean;
 //#endregion
 //#region src/actions/form-action.d.ts
 /**
@@ -614,7 +614,7 @@ declare function isActionResponse(response: Response): boolean;
  * @returns The action name, or `'default'` when no specific action is
  *          specified.
  */
-declare function parseFormActionName(url: string | URL): string;
+export declare function parseFormActionName(url: string | URL): string;
 /**
  * Build a form action URL for the current page.
  *
@@ -629,12 +629,12 @@ declare function parseFormActionName(url: string | URL): string;
  * the browser submits to the current page URL with the action name
  * appended as a query parameter.
  */
-declare function buildFormActionUrl(actionName?: string): string;
+export declare function buildFormActionUrl(actionName?: string): string;
 /**
  * Check whether a URL's query string contains a form action specifier
  * (`?/<name>` pattern).
  */
-declare function hasFormAction(url: string | URL): boolean;
+export declare function hasFormAction(url: string | URL): boolean;
 //#endregion
 //#region src/internal-fetch.d.ts
 interface InternalFetchOptions {
@@ -644,9 +644,9 @@ interface InternalFetchOptions {
   forwardHeaders?: string[];
 }
 type AppFetcher = (request: Request) => Response | Promise<Response>;
-declare function setInternalFetcher(fetcher: AppFetcher): void;
-declare function getInternalFetcher(): AppFetcher | null;
-declare function clearInternalFetcher(): void;
+export declare function setInternalFetcher(fetcher: AppFetcher): void;
+export declare function getInternalFetcher(): AppFetcher | null;
+export declare function clearInternalFetcher(): void;
 /**
  * 创建进程内调度适配器。
  *
@@ -667,7 +667,7 @@ declare function clearInternalFetcher(): void;
  * @param c - Hono Context(可选,用于转发 cookie/authorization 等请求头)
  * @param options - 选项(`headers` 自定义额外 header,`forwardHeaders` 自定义转发 header 列表)
  */
-declare function createInternalAdapter(c?: Context<UbeanEnv$1>, options?: InternalFetchOptions): FetchAdapter;
+export declare function createInternalAdapter(c?: Context<UbeanEnv$1>, options?: InternalFetchOptions): FetchAdapter;
 //#endregion
 //#region src/bot-detection.d.ts
 /**
@@ -688,7 +688,7 @@ declare function createInternalAdapter(c?: Context<UbeanEnv$1>, options?: Intern
  * @param ua User-Agent 字符串(来自 `c.req.header('user-agent')`)
  * @returns `true` 表示疑似爬虫,应降级为缓冲渲染以保证 metadata 完整
  */
-declare function isBotUserAgent(ua: string | undefined | null): boolean;
+export declare function isBotUserAgent(ua: string | undefined | null): boolean;
 //#endregion
 //#region src/openapi.d.ts
 interface OpenAPIGenerationOptions {
@@ -697,9 +697,9 @@ interface OpenAPIGenerationOptions {
   description?: string;
   baseURL?: string;
 }
-declare function registerOpenAPIRoutes(app: Hono<UbeanEnv$1>, options?: OpenAPIGenerationOptions & {
+export declare function registerOpenAPIRoutes(app: Hono<UbeanEnv$1>, options?: OpenAPIGenerationOptions & {
   scalarPath?: string;
   openAPIPath?: string;
 }): void;
 //#endregion
-export { ACTIONS_ENDPOINT, ACTION_BRAND, ACTION_RESPONSE_HEADER, type ActionContext, type ActionContextStorage, ActionError, type ActionFailure, type ActionHandler, type ActionId, type ActionResult, type ActionSchema, type CompiledLayout, type CompiledMiddleware, type CompiledPage, type CompiledRoute, type CompiledRouteRule, type ComposedHandler, type DefineActionOptions, type GenericSchema, type Input, type InternalFetchOptions, type IsrCacheEntry, type IsrCacheEntryInternal, type IsrCacheStore, type IsrRule, type IsrServeOptions, type OpenAPIGenerationOptions, type RegisterOptions, type ResolveSelectSsrInput, type ResolvedSelectSsr, type RouteMeta, type RouteRegistrar, type RouteRule, type RouteRulesMiddlewareOptions, type SelectSsrMode, type SelectSsrValue, type ServerAction, type Span, type SpanAttributes, type SpanContext, type SpanEndOptions, type SpanEvent, type SpanOptions, type SpanStatus, type UbeanBindings, type UbeanContext, type UbeanEnv, type UbeanHandler, type UbeanMiddleware, UbeanRouter, type UbeanVariables, applyPathTransform, bindActionContextStorage, buildActionContext, buildFormActionUrl, buildIsrCacheKey, clearActions, clearInternalFetcher, compileRouteRules, convertUbeanRoutePath, createActionId, createActionsMiddleware, createDetachedActionContext, createInternalAdapter, createRouteLoader, createRouteRulesMiddleware, createServerRouter, defineAction, defineHandler, defineHandlerMeta, defineMiddleware, defineServerFn, describeActionsOpenApi, dispatchAction, extractRouteMeta, fail, getAction, getActionContext, getInternalFetcher, getIsrCache, getIsrRuleFromContext, getStaleIsrCache, hasAction, hasFormAction, invalidateIsrCache, invalidateIsrCachePattern, invokeServerFn, isActionFailure, isActionResponse, isActionsRequest, isBotUserAgent, isHandlerChain, isIsrEntryStale, isServerAction, isValidActionId, listActions, matchRouteRules, normalizeActionResult, normalizeIsrRule, parseActionInput, parseFormActionName, registerAction, registerActions, registerApiRoutes, registerOpenAPIRoutes, registerPageRoutes, registerRoutes, resolveSelectSsr, runAction, runPageAction, runWithActionContext, serveIsr, setInternalFetcher, setIsrCache, sortPagesForRegistration, ssrModeHeader, unwrapActionResult, unwrapServerFnResult, useRouter, validateActionInput };
+export { ACTION_BRAND, type ActionContext, type ActionContextStorage, ActionError, type ActionFailure, type ActionHandler, type ActionId, type ActionResult, type ActionSchema, type CompiledLayout, type CompiledMiddleware, type CompiledPage, type CompiledRoute, type CompiledRouteRule, type ComposedHandler, type DefineActionOptions, type GenericSchema, type Input, type InternalFetchOptions, type IsrCacheEntry, type IsrCacheEntryInternal, type IsrCacheStore, type IsrRule, type IsrServeOptions, type OpenAPIGenerationOptions, type RegisterOptions, type ResolveSelectSsrInput, type ResolvedSelectSsr, type RouteMeta, type RouteRegistrar, type RouteRule, type RouteRulesMiddlewareOptions, type SelectSsrMode, type SelectSsrValue, type ServerAction, type Span, type SpanAttributes, type SpanContext, type SpanEndOptions, type SpanEvent, type SpanOptions, type SpanStatus, type UbeanBindings, type UbeanContext, type UbeanEnv, type UbeanHandler, type UbeanMiddleware, type UbeanVariables, fail, invokeServerFn, isActionFailure, isServerAction, unwrapActionResult, unwrapServerFnResult };

package/dist/runtime.d.ts

@@ -16,7 +16,7 @@ import { Ref } from "vue";
  *
  * @param actionId The stable action ID (e.g. `act_xxxxxxxxxxxx`)
  */
-declare function createActionStub<TInput = unknown, TOutput = unknown>(actionId: string): ServerAction<TInput, TOutput>;
+export declare function createActionStub<TInput = unknown, TOutput = unknown>(actionId: string): ServerAction<TInput, TOutput>;
 /**
  * Low-level RPC: invoke a registered server action by ID.
  *
@@ -28,8 +28,8 @@ declare function createActionStub<TInput = unknown, TOutput = unknown>(actionId:
  * @param args     Arguments to pass to the action handler (serialized as JSON)
  * @returns The `ActionResult` returned by the server
  */
-declare function callAction<T = unknown>(actionId: string, args?: unknown[]): Promise<ActionResult<T>>;
-interface UseActionReturn<TInput = unknown, TOutput = unknown> {
+export declare function callAction<T = unknown>(actionId: string, args?: unknown[]): Promise<ActionResult<T>>;
+export interface UseActionReturn<TInput = unknown, TOutput = unknown> {
   /** Reactive flag: `true` while the action is in flight. */
   pending: Ref<boolean>;
   /** The latest `ActionResult.data` (success), or `null` on error. */
@@ -79,8 +79,8 @@ interface UseActionReturn<TInput = unknown, TOutput = unknown> {
  * await submit(email, password);
  * ```
  */
-declare function useAction<TInput = unknown, TOutput = unknown>(actionOrId: ServerAction<TInput, TOutput> | string): UseActionReturn<TInput, TOutput>;
-interface UseFormActionReturn {
+export declare function useAction<TInput = unknown, TOutput = unknown>(actionOrId: ServerAction<TInput, TOutput> | string): UseActionReturn<TInput, TOutput>;
+export interface UseFormActionReturn {
   /** The form `action` attribute value (e.g. `?/login`). */
   action: string;
   /** Reactive flag: `true` while the form is submitting via SPA. */
@@ -144,6 +144,6 @@ interface UseFormActionReturn {
  * `?/login` — the server renders the result HTML, providing full
  * progressive enhancement.
  */
-declare function useFormAction(actionName?: string): UseFormActionReturn;
+export declare function useFormAction(actionName?: string): UseFormActionReturn;
 //#endregion
-export { UseActionReturn, UseFormActionReturn, callAction, createActionStub, invokeServerFn, unwrapActionResult, unwrapServerFnResult, useAction, useFormAction };
+export { invokeServerFn, unwrapActionResult, unwrapServerFnResult };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ubean/routes",
-  "version": "0.4.5",
+  "version": "0.4.6",
   "description": "Server routes runtime for ubean (defineHandler, defineMiddleware, registerRoutes, Server Actions, rou3 server router, route rules, ISR, internal-fetch, OpenAPI)",
   "files": [
     "dist"
@@ -24,23 +24,23 @@
     "@soybeanjs/fetch": "^0.1.0",
     "@standard-community/standard-json": "^0.3.6",
     "@standard-community/standard-openapi": "^0.2.10",
-    "@ubean/i18n": "0.4.5",
-    "@ubean/shared": "0.4.5",
+    "@ubean/i18n": "0.4.6",
+    "@ubean/shared": "0.4.6",
     "hono": "4.13.7",
     "hono-openapi": "^1.3.2",
     "rou3": "^0.9.2"
   },
   "devDependencies": {
     "@types/node": "^26.5.0",
-    "@ubean/pages": "0.4.5",
-    "@ubean/scan": "0.4.5",
-    "typescript": "7.0.2",
-    "vite-plus": "0.3.0",
+    "@ubean/pages": "0.4.6",
+    "@ubean/scan": "0.4.6",
+    "typescript": "npm:typescript-native-bridge@latest",
+    "vite-plus": "0.3.1",
     "vue": "^3.5.42"
   },
   "peerDependencies": {
-    "@ubean/pages": "0.4.5",
-    "@ubean/scan": "0.4.5",
+    "@ubean/pages": "0.4.6",
+    "@ubean/scan": "0.4.6",
     "vue": "^3.0.0"
   },
   "peerDependenciesMeta": {