@route-forge/core 1.0.3 → 1.1.1

package/dist/{types-pHQLqpYF.d.cts → types-CnZrdSEb.d.cts}

@@ -277,6 +277,17 @@ interface RouteForge {
         request: InterceptorManager<RequestConfig, RequestConfig>;
         response: InterceptorManager<ResponseData, unknown>;
     };
+    /**
+     * Promise，auto-discovery + eager load 完成后 resolve。
+     * 推荐用法：await forge.ready 后再调用 route() / hasRoute() 等同步方法。
+     */
+    ready: Promise<void>;
+    /**
+     * 订阅指定层级路由元数据加载完成事件。
+     * 框架层（Vue/React）用于驱动响应式状态更新。
+     * @returns 取消订阅函数
+     */
+    onLevelLoaded(level: string, cb: () => void): () => void;
 }
 /**
  * createRouteForge 配置项
@@ -312,6 +323,16 @@ interface RouteForgeOptions {
     strict?: boolean;
     timeout?: number;
     baseURL?: string;
+    /**
+     * 摘要端点（auto-discovery）完成后的回调。
+     * 推荐用法：在回调中 mount 应用，确保 route() / hasRoute() 等同步方法可用。
+     * @example
+     * createRouteForgePlugin({
+     *   endpoint: '/_forge/routes',
+     *   onSummaryReady: () => app.mount('#app'),
+     * });
+     */
+    onSummaryReady?: () => void;
 }
 /**
  * 二级路由类型映射（可由 codegen 生成或通过 module augmentation 增强）

package/dist/{types-pHQLqpYF.d.ts → types-CnZrdSEb.d.ts}

@@ -277,6 +277,17 @@ interface RouteForge {
         request: InterceptorManager<RequestConfig, RequestConfig>;
         response: InterceptorManager<ResponseData, unknown>;
     };
+    /**
+     * Promise，auto-discovery + eager load 完成后 resolve。
+     * 推荐用法：await forge.ready 后再调用 route() / hasRoute() 等同步方法。
+     */
+    ready: Promise<void>;
+    /**
+     * 订阅指定层级路由元数据加载完成事件。
+     * 框架层（Vue/React）用于驱动响应式状态更新。
+     * @returns 取消订阅函数
+     */
+    onLevelLoaded(level: string, cb: () => void): () => void;
 }
 /**
  * createRouteForge 配置项
@@ -312,6 +323,16 @@ interface RouteForgeOptions {
     strict?: boolean;
     timeout?: number;
     baseURL?: string;
+    /**
+     * 摘要端点（auto-discovery）完成后的回调。
+     * 推荐用法：在回调中 mount 应用，确保 route() / hasRoute() 等同步方法可用。
+     * @example
+     * createRouteForgePlugin({
+     *   endpoint: '/_forge/routes',
+     *   onSummaryReady: () => app.mount('#app'),
+     * });
+     */
+    onSummaryReady?: () => void;
 }
 /**
  * 二级路由类型映射（可由 codegen 生成或通过 module augmentation 增强）

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@route-forge/core",
-  "version": "1.0.3",
+  "version": "1.1.1",
   "description": "框架无关的命名路由客户端核心：分级懒加载、隔离缓存、并发去重、拦截器",
   "license": "MIT",
   "author": "阿杰很厉害 <506907958@qq.com>",
@@ -30,15 +30,6 @@
     "dist",
     "README.md"
   ],
-  "scripts": {
-    "build": "tsup",
-    "dev": "tsup --watch",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "lint": "tsc --noEmit",
-    "typecheck": "tsc --noEmit",
-    "clean": "rimraf dist .turbo"
-  },
   "bin": {
     "route-forge-codegen": "./dist/codegen.js"
   },
@@ -56,5 +47,14 @@
   },
   "publishConfig": {
     "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "tsc --noEmit",
+    "typecheck": "tsc --noEmit",
+    "clean": "rimraf dist .turbo"
   }
-}
+}