@route-forge/vue 1.1.1 → 1.2.0

package/README.md

@@ -65,7 +65,6 @@ forge.route('show', { user: 1 })                   // → forge.route('admin', '
 forge.load('admin')                                // 加载层级
 forge.isLoaded('admin')                            // 检查缓存
 forge.invalidate('admin')                          // 失效缓存
-forge.interceptors.request.use(...)                // 拦截器管理
 ```
 
 > **注意**：`useForge()` 无 level 时 **不提供** `route`/`url`/`hasRoute`/`getRoutes` 同步方法，
@@ -129,9 +128,9 @@ const url = useForgeRoute('public', 'login.show')
 
 ## 文档
 
-- 仓库主页: https://github.com/xyj2156/route-forge
-- 设计文档: https://github.com/xyj2156/route-forge/blob/main/.docs/DESIGN.md
-- 规范: https://github.com/xyj2156/route-forge/blob/main/.docs/SPEC.md
+- 仓库主页: https://github.com/route-forge/route-forge
+- 设计文档: https://github.com/route-forge/route-forge/blob/main/.docs/DESIGN.md
+- 规范: https://github.com/route-forge/route-forge/blob/main/.docs/SPEC.md
 
 ## License
 

package/dist/index.cjs

@@ -2,25 +2,7 @@
 
 var vue = require('vue');
 var core = require('@route-forge/core');
-
-// src/plugin.ts
-async function resolveRouteName(forge, level, prefix, suffix, separator = ".") {
-  if (!suffix) return prefix;
-  const joined = `${prefix}${separator}${suffix}`;
-  if (!suffix.startsWith(`${prefix}${separator}`)) return joined;
-  await forge.load(level);
-  if (forge.hasRoute(level, joined)) return joined;
-  if (forge.hasRoute(level, suffix)) return suffix;
-  throw new core.UnknownRouteError(joined, level);
-}
-function resolveRouteNameSync(forge, level, prefix, suffix, separator = ".") {
-  if (!suffix) return prefix;
-  const joined = `${prefix}${separator}${suffix}`;
-  if (!suffix.startsWith(`${prefix}${separator}`)) return joined;
-  if (forge.hasRoute(level, joined)) return joined;
-  if (forge.hasRoute(level, suffix)) return suffix;
-  throw new core.UnknownRouteError(joined, level);
-}
+var internal = require('@route-forge/core/internal');
 
 // src/plugin.ts
 var FORGE_INJECTION_KEY = /* @__PURE__ */ Symbol("route-forge");
@@ -53,22 +35,21 @@ function useForge(level, prefix) {
       levelLoaded.value = true;
       unsub();
     });
-    const callable2 = prefix ? async (name, params) => forge.api(level, await resolveRouteName(forge, level, prefix, name), params) : (name, params) => forge.api(level, name, params);
-    defineImmutableProps(callable2, {
+    const callable2 = prefix ? async (name, params) => forge.api(level, await core.resolveRouteName(forge, level, prefix, name), params) : (name, params) => forge.api(level, name, params);
+    internal.defineImmutableProps(callable2, {
       level,
       // 未传 prefix 时不定义该属性，与 React 包行为保持一致（'prefix' in forge === false）
       ...prefix !== void 0 ? { prefix } : {},
-      api: prefix ? async (name, params) => forge.api(level, await resolveRouteName(forge, level, prefix, name), params) : (name, params) => forge.api(level, name, params),
-      route: prefix ? (name, params) => forge.route(level, resolveRouteNameSync(forge, level, prefix, name), params) : (name, params) => forge.route(level, name, params),
-      url: prefix ? (name, params) => forge.route(level, resolveRouteNameSync(forge, level, prefix, name), params) : (name, params) => forge.route(level, name, params),
+      api: prefix ? async (name, params) => forge.api(level, await core.resolveRouteName(forge, level, prefix, name), params) : (name, params) => forge.api(level, name, params),
+      route: prefix ? (name, params) => forge.route(level, core.resolveRouteNameSync(forge, level, prefix, name), params) : (name, params) => forge.route(level, name, params),
+      url: prefix ? (name, params) => forge.route(level, core.resolveRouteNameSync(forge, level, prefix, name), params) : (name, params) => forge.route(level, name, params),
       load: forge.load.bind(forge),
       invalidate: forge.invalidate.bind(forge),
       isLoaded: forge.isLoaded.bind(forge),
       hasRoute: forge.hasRoute.bind(forge),
       isLoading: forge.isLoading.bind(forge),
       onLoadingChange: forge.onLoadingChange.bind(forge),
-      getRoutes: forge.getRoutes.bind(forge),
-      interceptors: forge.interceptors
+      getRoutes: forge.getRoutes.bind(forge)
     });
     Object.defineProperty(callable2, "levelLoaded", {
       value: levelLoaded,
@@ -79,31 +60,18 @@ function useForge(level, prefix) {
     return callable2;
   }
   const callable = (lvl, name, params) => forge.api(lvl, name, params);
-  defineImmutableProps(callable, {
+  internal.defineImmutableProps(callable, {
     api: forge.api.bind(forge),
     load: forge.load.bind(forge),
     invalidate: forge.invalidate.bind(forge),
     isLoaded: forge.isLoaded.bind(forge),
     isLoading: forge.isLoading.bind(forge),
     onLoadingChange: forge.onLoadingChange.bind(forge),
-    interceptors: forge.interceptors,
     ready: forge.ready,
     onLevelLoaded: forge.onLevelLoaded.bind(forge)
   });
   return callable;
 }
-function defineImmutableProps(target, props) {
-  for (const key of Object.keys(props)) {
-    const val = props[key];
-    Object.defineProperty(target, key, {
-      value: val !== null && typeof val === "object" ? Object.freeze(val) : val,
-      writable: false,
-      enumerable: false,
-      configurable: false
-    });
-  }
-  return target;
-}
 function useForgeApi(level, prefix) {
   const forge = level !== void 0 ? useForge(level, prefix) : useForge();
   const pending = vue.ref(false);
@@ -146,12 +114,12 @@ function useForgeRoute(level, name, params) {
 function useForgeByPrefix(level, prefix, separator = ".") {
   const forge = vue.inject(FORGE_INJECTION_KEY);
   return {
-    api: (suffix, params) => resolveRouteName(forge, level, prefix, suffix, separator).then(
+    api: (suffix, params) => core.resolveRouteName(forge, level, prefix, suffix, separator).then(
       (name) => forge.api(level, name, params)
     ),
     route: (suffix, params) => {
       if (!forge.isLoaded(level)) return "";
-      return forge.route(level, resolveRouteNameSync(forge, level, prefix, suffix, separator), params);
+      return forge.route(level, core.resolveRouteNameSync(forge, level, prefix, suffix, separator), params);
     }
   };
 }

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/utils/resolveRouteName.ts","../src/plugin.ts","../src/composables/useForgeApi.ts","../src/composables/useForgeRoute.ts","../src/composables/useForgeByPrefix.ts"],"names":["UnknownRouteError","createRouteForge","inject","ref","callable","onMounted","computed"],"mappings":";;;;;;AA6BA,eAAsB,iBACpB,KAAA,EACA,KAAA,EACA,MAAA,EACA,MAAA,EACA,YAAY,GAAA,EACK;AAEjB,EAAA,IAAI,CAAC,QAAQ,OAAO,MAAA;AAEpB,EAAA,MAAM,SAAS,CAAA,EAAG,MAAM,CAAA,EAAG,SAAS,GAAG,MAAM,CAAA,CAAA;AAG7C,EAAA,IAAI,CAAC,OAAO,UAAA,CAAW,CAAA,EAAG,MAAM,CAAA,EAAG,SAAS,CAAA,CAAE,CAAA,EAAG,OAAO,MAAA;AAGxD,EAAA,MAAM,KAAA,CAAM,KAAK,KAAK,CAAA;AAGtB,EAAA,IAAI,KAAA,CAAM,QAAA,CAAS,KAAA,EAAO,MAAM,GAAG,OAAO,MAAA;AAE1C,EAAA,IAAI,KAAA,CAAM,QAAA,CAAS,KAAA,EAAO,MAAM,GAAG,OAAO,MAAA;AAG1C,EAAA,MAAM,IAAIA,sBAAA,CAAkB,MAAA,EAAQ,KAAK,CAAA;AAC3C;AAMO,SAAS,qBACd,KAAA,EACA,KAAA,EACA,MAAA,EACA,MAAA,EACA,YAAY,GAAA,EACJ;AACR,EAAA,IAAI,CAAC,QAAQ,OAAO,MAAA;AAEpB,EAAA,MAAM,SAAS,CAAA,EAAG,MAAM,CAAA,EAAG,SAAS,GAAG,MAAM,CAAA,CAAA;AAC7C,EAAA,IAAI,CAAC,OAAO,UAAA,CAAW,CAAA,EAAG,MAAM,CAAA,EAAG,SAAS,CAAA,CAAE,CAAA,EAAG,OAAO,MAAA;AAGxD,EAAA,IAAI,KAAA,CAAM,QAAA,CAAS,KAAA,EAAO,MAAM,GAAG,OAAO,MAAA;AAC1C,EAAA,IAAI,KAAA,CAAM,QAAA,CAAS,KAAA,EAAO,MAAM,GAAG,OAAO,MAAA;AAE1C,EAAA,MAAM,IAAIA,sBAAA,CAAkB,MAAA,EAAQ,KAAK,CAAA;AAC3C;;;AC1CO,IAAM,mBAAA,0BAAuD,aAAa;AAkF1E,SAAS,uBAAuB,OAAA,EAErC;AACA,EAAA,MAAM,KAAA,GAAQC,sBAAiB,OAAO,CAAA;AAEtC,EAAA,OAAO;AAAA,IACL,OAAO,KAAA,CAAM,KAAA;AAAA,IACb,QAAQ,GAAA,EAAU;AAChB,MAAA,GAAA,CAAI,OAAA,CAAQ,qBAAqB,KAAK,CAAA;AACtC,MAAA,GAAA,CAAI,MAAA,CAAO,iBAAiB,MAAA,GAAS;AAAA,QACnC,KAAA,EAAO,CAAC,KAAA,EAAe,IAAA,EAAc,WACnC,KAAA,CAAM,KAAA,CAAM,KAAA,EAAO,IAAA,EAAM,MAAM;AAAA,OACnC;AAAA,IACF;AAAA,GACF;AACF;AA8BO,SAAS,QAAA,CAAS,OAAgB,MAAA,EAA+D;AACtG,EAAA,MAAM,KAAA,GAAQC,WAAO,mBAAmB,CAAA;AACxC,EAAA,IAAI,CAAC,KAAA,EAAO;AACV,IAAA,MAAM,IAAI,KAAA;AAAA,MACR;AAAA,KACF;AAAA,EACF;AAEA,EAAA,IAAI,UAAU,MAAA,EAAW;AAEvB,IAAA,MAAM,WAAA,GAAcC,OAAA,CAAI,KAAA,CAAM,QAAA,CAAS,KAAK,CAAC,CAAA;AAC7C,IAAA,KAAA,CAAM,IAAA,CAAK,KAAK,CAAA,CAAE,IAAA,CAAK,MAAM;AAC3B,MAAA,WAAA,CAAY,KAAA,GAAQ,IAAA;AAAA,IACtB,CAAC,CAAA,CAAE,KAAA,CAAM,MAAM;AAAA,IACf,CAAC,CAAA;AAED,IAAA,MAAM,KAAA,GAAQ,KAAA,CAAM,aAAA,CAAc,KAAA,EAAO,MAAM;AAC7C,MAAA,WAAA,CAAY,KAAA,GAAQ,IAAA;AACpB,MAAA,KAAA,EAAM;AAAA,IACR,CAAC,CAAA;AAED,IAAA,MAAMC,SAAAA,GAAW,MAAA,GACb,OAAO,IAAA,EAAc,MAAA,KACrB,MAAM,GAAA,CAAI,KAAA,EAAO,MAAM,gBAAA,CAAiB,KAAA,EAAO,KAAA,EAAO,QAAQ,IAAI,CAAA,EAAG,MAAM,CAAA,GAC3E,CAAC,IAAA,EAAc,WACf,KAAA,CAAM,GAAA,CAAI,KAAA,EAAO,IAAA,EAAM,MAAM,CAAA;AACjC,IAAA,oBAAA,CAAqBA,SAAAA,EAAU;AAAA,MAC7B,KAAA;AAAA;AAAA,MAEA,GAAI,MAAA,KAAW,MAAA,GAAY,EAAE,MAAA,KAAW,EAAC;AAAA,MACzC,GAAA,EAAK,MAAA,GACD,OAAO,IAAA,EAAc,MAAA,KACrB,MAAM,GAAA,CAAI,KAAA,EAAO,MAAM,gBAAA,CAAiB,KAAA,EAAO,KAAA,EAAO,QAAQ,IAAI,CAAA,EAAG,MAAM,CAAA,GAC3E,CAAC,IAAA,EAAc,WAA2B,KAAA,CAAM,GAAA,CAAI,KAAA,EAAO,IAAA,EAAM,MAAM,CAAA;AAAA,MAC3E,KAAA,EAAO,SACH,CAAC,IAAA,EAAc,WACf,KAAA,CAAM,KAAA,CAAM,KAAA,EAAO,oBAAA,CAAqB,KAAA,EAAO,KAAA,EAAO,QAAQ,IAAI,CAAA,EAAG,MAAM,CAAA,GAC3E,CAAC,IAAA,EAAc,WAAqC,KAAA,CAAM,KAAA,CAAM,KAAA,EAAO,IAAA,EAAM,MAAM,CAAA;AAAA,MACvF,GAAA,EAAK,SACD,CAAC,IAAA,EAAc,WACf,KAAA,CAAM,KAAA,CAAM,KAAA,EAAO,oBAAA,CAAqB,KAAA,EAAO,KAAA,EAAO,QAAQ,IAAI,CAAA,EAAG,MAAM,CAAA,GAC3E,CAAC,IAAA,EAAc,WAAqC,KAAA,CAAM,KAAA,CAAM,KAAA,EAAO,IAAA,EAAM,MAAM,CAAA;AAAA,MACvF,IAAA,EAAM,KAAA,CAAM,IAAA,CAAK,IAAA,CAAK,KAAK,CAAA;AAAA,MAC3B,UAAA,EAAY,KAAA,CAAM,UAAA,CAAW,IAAA,CAAK,KAAK,CAAA;AAAA,MACvC,QAAA,EAAU,KAAA,CAAM,QAAA,CAAS,IAAA,CAAK,KAAK,CAAA;AAAA,MACnC,QAAA,EAAU,KAAA,CAAM,QAAA,CAAS,IAAA,CAAK,KAAK,CAAA;AAAA,MACnC,SAAA,EAAW,KAAA,CAAM,SAAA,CAAU,IAAA,CAAK,KAAK,CAAA;AAAA,MACrC,eAAA,EAAiB,KAAA,CAAM,eAAA,CAAgB,IAAA,CAAK,KAAK,CAAA;AAAA,MACjD,SAAA,EAAW,KAAA,CAAM,SAAA,CAAU,IAAA,CAAK,KAAK,CAAA;AAAA,MACrC,cAAc,KAAA,CAAM;AAAA,KACrB,CAAA;AAED,IAAA,MAAA,CAAO,cAAA,CAAeA,WAAU,aAAA,EAAe;AAAA,MAC7C,KAAA,EAAO,WAAA;AAAA,MACP,QAAA,EAAU,KAAA;AAAA,MACV,UAAA,EAAY,IAAA;AAAA,MACZ,YAAA,EAAc;AAAA,KACf,CAAA;AACD,IAAA,OAAOA,SAAAA;AAAA,EACT;AAEA,EAAA,MAAM,QAAA,GAAW,CAAC,GAAA,EAAa,IAAA,EAAc,WAC3C,KAAA,CAAM,GAAA,CAAI,GAAA,EAAK,IAAA,EAAM,MAAM,CAAA;AAC7B,EAAA,oBAAA,CAAqB,QAAA,EAAU;AAAA,IAC7B,GAAA,EAAK,KAAA,CAAM,GAAA,CAAI,IAAA,CAAK,KAAK,CAAA;AAAA,IACzB,IAAA,EAAM,KAAA,CAAM,IAAA,CAAK,IAAA,CAAK,KAAK,CAAA;AAAA,IAC3B,UAAA,EAAY,KAAA,CAAM,UAAA,CAAW,IAAA,CAAK,KAAK,CAAA;AAAA,IACvC,QAAA,EAAU,KAAA,CAAM,QAAA,CAAS,IAAA,CAAK,KAAK,CAAA;AAAA,IACnC,SAAA,EAAW,KAAA,CAAM,SAAA,CAAU,IAAA,CAAK,KAAK,CAAA;AAAA,IACrC,eAAA,EAAiB,KAAA,CAAM,eAAA,CAAgB,IAAA,CAAK,KAAK,CAAA;AAAA,IACjD,cAAc,KAAA,CAAM,YAAA;AAAA,IACpB,OAAO,KAAA,CAAM,KAAA;AAAA,IACb,aAAA,EAAe,KAAA,CAAM,aAAA,CAAc,IAAA,CAAK,KAAK;AAAA,GAC9C,CAAA;AACD,EAAA,OAAO,QAAA;AACT;AAQA,SAAS,oBAAA,CAAuC,QAAW,KAAA,EAAmC;AAC5F,EAAA,KAAA,MAAW,GAAA,IAAO,MAAA,CAAO,IAAA,CAAK,KAAK,CAAA,EAAG;AACpC,IAAA,MAAM,GAAA,GAAM,MAAM,GAAG,CAAA;AACrB,IAAA,MAAA,CAAO,cAAA,CAAe,QAAQ,GAAA,EAAK;AAAA,MACjC,KAAA,EAAO,QAAQ,IAAA,IAAQ,OAAO,QAAQ,QAAA,GAAW,MAAA,CAAO,MAAA,CAAO,GAAG,CAAA,GAAI,GAAA;AAAA,MACtE,QAAA,EAAU,KAAA;AAAA,MACV,UAAA,EAAY,KAAA;AAAA,MACZ,YAAA,EAAc;AAAA,KACf,CAAA;AAAA,EACH;AACA,EAAA,OAAO,MAAA;AACT;ACvMO,SAAS,WAAA,CAAY,OAAgB,MAAA,EAAqE;AAC/G,EAAA,MAAM,QAAQ,KAAA,KAAU,MAAA,GAAY,SAAS,KAAA,EAAO,MAAgB,IAAI,QAAA,EAAS;AACjF,EAAA,MAAM,OAAA,GAAUD,QAAI,KAAK,CAAA;AACzB,EAAA,MAAM,KAAA,GAAQA,QAAa,IAAI,CAAA;AAE/B,EAAA,eAAe,QAAQ,IAAA,EAA6D;AAClF,IAAA,OAAA,CAAQ,KAAA,GAAQ,IAAA;AAChB,IAAA,KAAA,CAAM,KAAA,GAAQ,IAAA;AACd,IAAA,IAAI;AAEF,MAAA,MAAM,IAAA,GAAO,MAAO,KAAA,CAAc,GAAA,CAAI,GAAG,IAAI,CAAA;AAC7C,MAAA,OAAO,EAAE,IAAA,EAAM,KAAA,EAAO,IAAA,EAAK;AAAA,IAC7B,SAAS,CAAA,EAAG;AACV,MAAA,KAAA,CAAM,KAAA,GAAQ,CAAA;AACd,MAAA,OAAO,EAAE,IAAA,EAAM,MAAA,EAAW,KAAA,EAAO,CAAA,EAAE;AAAA,IACrC,CAAA,SAAE;AACA,MAAA,OAAA,CAAQ,KAAA,GAAQ,KAAA;AAAA,IAClB;AAAA,EACF;AAEA,EAAA,OAAO,EAAE,OAAA,EAAS,KAAA,EAAO,IAAA,EAAkB;AAC7C;ACjEO,SAAS,aAAA,CACd,KAAA,EACA,IAAA,EACA,MAAA,EACqB;AACrB,EAAA,MAAM,KAAA,GAAQD,WAAO,mBAAmB,CAAA;AAGxC,EAAA,MAAM,WAAA,GAAcC,OAAAA,CAAI,KAAA,CAAM,QAAA,CAAS,OAAO,UAAU,UAAA,GAAa,KAAA,EAAM,GAAI,KAAK,CAAC,CAAA;AAErF,EAAA,MAAM,GAAA,GAAM,OAAO,KAAA,KAAU,UAAA,GAAa,OAAM,GAAI,KAAA;AACpD,EAAA,IAAI,CAAC,YAAY,KAAA,EAAO;AACtB,IAAAE,aAAA,CAAU,MAAM;AACd,MAAA,KAAA,CAAM,IAAA,CAAK,GAAG,CAAA,CAAE,IAAA,CAAK,MAAM;AACzB,QAAA,WAAA,CAAY,KAAA,GAAQ,IAAA;AAAA,MACtB,CAAC,CAAA,CAAE,KAAA,CAAM,MAAM;AAAA,MACf,CAAC,CAAA;AAAA,IACH,CAAC,CAAA;AAAA,EACH;AAEA,EAAA,OAAOC,aAAS,MAAM;AAEpB,IAAA,IAAI,CAAC,WAAA,CAAY,KAAA,EAAO,OAAO,EAAA;AAC/B,IAAA,MAAM,CAAA,GAAI,OAAO,KAAA,KAAU,UAAA,GAAa,OAAM,GAAI,KAAA;AAClD,IAAA,MAAM,CAAA,GAAI,OAAO,IAAA,KAAS,UAAA,GAAa,MAAK,GAAI,IAAA;AAChD,IAAA,MAAM,CAAA,GAAI,MAAA,GAAS,MAAA,EAAO,GAAI,MAAA;AAC9B,IAAA,OAAO,KAAA,CAAM,KAAA,CAAM,CAAA,EAAG,CAAA,EAAG,CAAC,CAAA;AAAA,EAC5B,CAAC,CAAA;AACH;AChBO,SAAS,gBAAA,CAAiB,KAAA,EAAe,MAAA,EAAgB,SAAA,GAAY,GAAA,EAA6B;AACvG,EAAA,MAAM,KAAA,GAAQJ,WAAO,mBAAmB,CAAA;AAExC,EAAA,OAAO;AAAA,IACL,GAAA,EAAK,CAAC,MAAA,EAAQ,MAAA,KACZ,gBAAA,CAAiB,OAAO,KAAA,EAAO,MAAA,EAAQ,MAAA,EAAQ,SAAS,CAAA,CAAE,IAAA;AAAA,MACxD,CAAC,IAAA,KAAS,KAAA,CAAM,GAAA,CAAI,KAAA,EAAO,MAAM,MAAM;AAAA,KACzC;AAAA,IACF,KAAA,EAAO,CAAC,MAAA,EAAQ,MAAA,KAAW;AAEzB,MAAA,IAAI,CAAC,KAAA,CAAM,QAAA,CAAS,KAAK,GAAG,OAAO,EAAA;AACnC,MAAA,OAAO,KAAA,CAAM,KAAA,CAAM,KAAA,EAAO,oBAAA,CAAqB,KAAA,EAAO,OAAO,MAAA,EAAQ,MAAA,EAAQ,SAAS,CAAA,EAAG,MAAM,CAAA;AAAA,IACjG;AAAA,GACF;AACF","file":"index.cjs","sourcesContent":["/**\n * 智能路由名前缀解析\n *\n * 当前缀与后缀拼接产生歧义时（后缀本身已以前缀开头），\n * 通过查询已加载路由表来判定正确名称：\n *   - 优先尝试 prefix + sep + suffix（完整拼接）\n *   - 若不存在则回退到 suffix（视为已含前缀）\n *   - 均不存在则抛 UnknownRouteError\n *\n * @see .docs/SPEC.md §4.1.7\n */\n\nimport { UnknownRouteError } from '@route-forge/core';\n\n/**\n * 路由名解析所需的最小 forge 接口。\n * 仅依赖 load() 和 hasRoute()，不依赖拦截器等完整能力。\n * 兼容 RouteForge、BoundForgeTyped、ForgeInstanceTyped 等所有形态。\n */\ninterface RouteResolver {\n  load(level: string | string[]): Promise<void>;\n\n  hasRoute(level: string, name: string): boolean;\n}\n\n/**\n * 异步版本：先确保层级已加载，再做歧义消解。\n * 适用于 api() 调用路径。\n */\nexport async function resolveRouteName(\n  forge: RouteResolver,\n  level: string,\n  prefix: string,\n  suffix: string,\n  separator = '.',\n): Promise<string> {\n  // 后缀为空 → 直接返回前缀\n  if (!suffix) return prefix;\n\n  const joined = `${prefix}${separator}${suffix}`;\n\n  // 后缀不以前缀开头 → 无歧义，直接拼接\n  if (!suffix.startsWith(`${prefix}${separator}`)) return joined;\n\n  // 歧义场景：先确保层级已加载\n  await forge.load(level);\n\n  // 优先尝试完整拼接\n  if (forge.hasRoute(level, joined)) return joined;\n  // 回退到后缀本身（视为已含前缀）\n  if (forge.hasRoute(level, suffix)) return suffix;\n\n  // 均不存在 → 报错\n  throw new UnknownRouteError(joined, level);\n}\n\n/**\n * 同步版本：基于已加载缓存做歧义消解。\n * 适用于 route() / url() 调用路径（要求层级已加载）。\n */\nexport function resolveRouteNameSync(\n  forge: RouteResolver,\n  level: string,\n  prefix: string,\n  suffix: string,\n  separator = '.',\n): string {\n  if (!suffix) return prefix;\n\n  const joined = `${prefix}${separator}${suffix}`;\n  if (!suffix.startsWith(`${prefix}${separator}`)) return joined;\n\n  // 歧义场景：基于已加载缓存判定\n  if (forge.hasRoute(level, joined)) return joined;\n  if (forge.hasRoute(level, suffix)) return suffix;\n\n  throw new UnknownRouteError(joined, level);\n}\n","/**\n * Vue 3 插件入口\n * @see .docs/SPEC.md §4.1.7\n *\n * 提供：\n *   - 全局属性 $forge（route() 工具）\n *   - inject symbol 注入 RouteForge 实例供 composable 使用\n *   - useForge() / useForge(level) / useForge(level, prefix) 返回统一方法的 forge 实例\n *     • 不传 level：forge(level, name, params?) 直接调用\n *     • 传 level：forge(name, params?) 直接调用，自动绑定层级\n *     • 传 level + prefix：forge(suffix, params?) 自动拼接 prefix\n *\n * 类型推断：\n *   当 ForgeRouteMap 通过 codegen 或 module augmentation 定义时，\n *   level / name / params 均自动推断，IDE 提供补全提示。\n */\n\nimport type { App, InjectionKey, Plugin, Ref } from 'vue';\nimport { inject, ref } from 'vue';\nimport {\n  type ApiCallParams,\n  createRouteForge,\n  type ForgeApiParams,\n  type ForgeApiResponse,\n  type ForgeRouteName,\n  type InterceptorHandler,\n  type LoadingChangeCallback,\n  type RequestConfig,\n  type ResponseData,\n  type RouteForge,\n  type RouteForgeOptions,\n  type RouteMeta,\n} from '@route-forge/core';\nimport { resolveRouteName, resolveRouteNameSync } from './utils/resolveRouteName.js';\n\nexport const FORGE_INJECTION_KEY: InjectionKey<RouteForge> = Symbol('route-forge');\n\nexport interface RouteForgePluginOptions extends RouteForgeOptions {}\n\n/** 只读拦截器管理器：仅暴露查询方法，隐藏 use/eject/clear */\ninterface ReadOnlyInterceptorManager<TIn, TOut = TIn> {\n  readonly size: number;\n\n  forEach(fn: (handler: InterceptorHandler<TIn, TOut>) => void): void;\n}\n\n/**\n * 共享方法集（level 已绑定时的方法签名）\n * .api() / .route() / .url() — name 和 params 根据 ForgeRouteMap 自动推断\n * .load() / .invalidate() / .isLoaded() / .interceptors\n */\nexport interface BoundForgeMethods<L extends string = string> {\n  interceptors: {\n    request: ReadOnlyInterceptorManager<RequestConfig>;\n    response: ReadOnlyInterceptorManager<ResponseData>;\n  };\n\n  api(name: ForgeRouteName<L>, params?: ForgeApiParams<L, ForgeRouteName<L>>): Promise<ForgeApiResponse<L, ForgeRouteName<L>>>;\n\n  route(name: ForgeRouteName<L>, params?: ForgeApiParams<L, ForgeRouteName<L>>): string;\n\n  url(name: ForgeRouteName<L>, params?: ForgeApiParams<L, ForgeRouteName<L>>): string;\n\n  load(level: string | string[]): Promise<void>;\n\n  invalidate(level?: string | string[]): void;\n\n  isLoaded(level?: string): boolean;\n\n  hasRoute(level: string, name: string): boolean;\n\n  /** 查询加载中标识状态 */\n  isLoading(): boolean;\n\n  /** 订阅加载状态变更，返回取消订阅函数 */\n  onLoadingChange(cb: LoadingChangeCallback): () => void;\n\n  /** 获取指定层级下全部路由元信息（深拷贝，修改不影响内部缓存） */\n  getRoutes(level: string): Record<string, RouteMeta>;\n\n  /** 指定层级的路由元数据是否已加载完成（响应式） */\n  levelLoaded: Ref<boolean>;\n}\n\n/** 已绑定 level — 直接调用无需 level，api/route/url 的 name 自动限定到该层级 */\nexport interface BoundForgeTyped<L extends string> extends BoundForgeMethods<L> {\n  (name: ForgeRouteName<L>, params?: ForgeApiParams<L, ForgeRouteName<L>>): Promise<ForgeApiResponse<L, ForgeRouteName<L>>>;\n  /** 当前绑定的 level 值 */\n  readonly level: L;\n  /** 路由名前缀（仅在 useForge(level, prefix) 传入 prefix 时存在） */\n  readonly prefix?: string;\n}\n\n/** 未绑定 level — 直接调用需要传 level（不提供 route/url/hasRoute/getRoutes 等同步方法） */\nexport interface ForgeInstanceTyped {\n  (level: string, name: string, params?: ApiCallParams): Promise<unknown>;\n  api(level: string, name: string, params?: ApiCallParams): Promise<unknown>;\n\n  interceptors: {\n    request: ReadOnlyInterceptorManager<RequestConfig>;\n    response: ReadOnlyInterceptorManager<ResponseData>;\n  };\n  ready: Promise<void>;\n\n  load(level: string | string[]): Promise<void>;\n\n  invalidate(level?: string | string[]): void;\n\n  isLoaded(level?: string): boolean;\n\n  isLoading(): boolean;\n\n  onLoadingChange(cb: LoadingChangeCallback): () => void;\n\n  onLevelLoaded(level: string, cb: () => void): () => void;\n}\n\nexport function createRouteForgePlugin(options: RouteForgePluginOptions): Plugin<[]> & {\n  ready: Promise<void>\n} {\n  const forge = createRouteForge(options);\n\n  return {\n    ready: forge.ready,\n    install(app: App) {\n      app.provide(FORGE_INJECTION_KEY, forge);\n      app.config.globalProperties.$forge = {\n        route: (level: string, name: string, params?: Record<string, unknown>) =>\n          forge.route(level, name, params),\n      };\n    },\n  };\n}\n\n/**\n * 获取 forge 实例。\n *\n * @example\n * // 不绑定层级\n * const forge = useForge()\n * forge('admin', 'users.show', { user: 1 })\n * forge.api('admin', 'users.show')\n *\n * @example\n * // 绑定层级 — 直接调用和 api/route/url 均无需传 level\n * const forge = useForge('admin')\n * forge.level                    // → 'admin'\n * forge('users.show', { user: 1 })\n * forge.api('users.show')\n *\n * @example\n * // 绑定层级 + 前缀 — 路由名自动拼接\n * const forge = useForge('admin', 'users')\n * forge.level                    // → 'admin'\n * forge.prefix                   // → 'users'\n * forge('show', { user: 1 })           // → forge.api('admin', 'users.show', ...)\n * forge.api('index')                   // → forge.api('admin', 'users.index')\n * forge.route('show', { user: 1 })     // → forge.route('admin', 'users.show', ...)\n */\nexport function useForge<L extends string>(level: L, prefix: string): BoundForgeTyped<L>;\nexport function useForge<L extends string>(level: L): BoundForgeTyped<L>;\nexport function useForge(): ForgeInstanceTyped;\nexport function useForge(level?: string, prefix?: string): ForgeInstanceTyped | BoundForgeTyped<string> {\n  const forge = inject(FORGE_INJECTION_KEY);\n  if (!forge) {\n    throw new Error(\n      '[route-forge/vue] useForge() must be used inside an app with createRouteForgePlugin() installed',\n    );\n  }\n\n  if (level !== undefined) {\n    // 自动触发 level 加载 + 响应式 levelLoaded 状态\n    const levelLoaded = ref(forge.isLoaded(level));\n    forge.load(level).then(() => {\n      levelLoaded.value = true;\n    }).catch(() => { /* 加载失败时 levelLoaded 保持 false */\n    });\n    // 订阅 level 加载完成事件（兜底：如果 load() 在 ref 赋值后才完成）\n    const unsub = forge.onLevelLoaded(level, () => {\n      levelLoaded.value = true;\n      unsub();\n    });\n\n    const callable = prefix\n      ? async (name: string, params?: ApiCallParams) =>\n        forge.api(level, await resolveRouteName(forge, level, prefix, name), params)\n      : (name: string, params?: ApiCallParams) =>\n        forge.api(level, name, params);\n    defineImmutableProps(callable, {\n      level,\n      // 未传 prefix 时不定义该属性，与 React 包行为保持一致（'prefix' in forge === false）\n      ...(prefix !== undefined ? { prefix } : {}),\n      api: prefix\n        ? async (name: string, params?: ApiCallParams) =>\n          forge.api(level, await resolveRouteName(forge, level, prefix, name), params)\n        : (name: string, params?: ApiCallParams) => forge.api(level, name, params),\n      route: prefix\n        ? (name: string, params?: Record<string, unknown>) =>\n          forge.route(level, resolveRouteNameSync(forge, level, prefix, name), params)\n        : (name: string, params?: Record<string, unknown>) => forge.route(level, name, params),\n      url: prefix\n        ? (name: string, params?: Record<string, unknown>) =>\n          forge.route(level, resolveRouteNameSync(forge, level, prefix, name), params)\n        : (name: string, params?: Record<string, unknown>) => forge.route(level, name, params),\n      load: forge.load.bind(forge),\n      invalidate: forge.invalidate.bind(forge),\n      isLoaded: forge.isLoaded.bind(forge),\n      hasRoute: forge.hasRoute.bind(forge),\n      isLoading: forge.isLoading.bind(forge),\n      onLoadingChange: forge.onLoadingChange.bind(forge),\n      getRoutes: forge.getRoutes.bind(forge),\n      interceptors: forge.interceptors,\n    });\n    // levelLoaded 需要保持响应式，不能通过 defineImmutableProps（会 Object.freeze）\n    Object.defineProperty(callable, 'levelLoaded', {\n      value: levelLoaded,\n      writable: false,\n      enumerable: true,\n      configurable: false,\n    });\n    return callable as unknown as BoundForgeTyped<string>;\n  }\n\n  const callable = (lvl: string, name: string, params?: ApiCallParams) =>\n    forge.api(lvl, name, params);\n  defineImmutableProps(callable, {\n    api: forge.api.bind(forge),\n    load: forge.load.bind(forge),\n    invalidate: forge.invalidate.bind(forge),\n    isLoaded: forge.isLoaded.bind(forge),\n    isLoading: forge.isLoading.bind(forge),\n    onLoadingChange: forge.onLoadingChange.bind(forge),\n    interceptors: forge.interceptors,\n    ready: forge.ready,\n    onLevelLoaded: forge.onLevelLoaded.bind(forge),\n  });\n  return callable as ForgeInstanceTyped;\n}\n\n\n/**\n * 以不可变、不可枚举、不可重配置的方式将属性挂载到目标对象上。\n * 相比 Object.assign 更安全——外部无法通过遍历/删除/重写篡改这些方法。\n * 对象类型的值会浅冻结（Object.freeze），防止内部键被增删改。\n */\nfunction defineImmutableProps<T extends object>(target: T, props: Record<string, unknown>): T {\n  for (const key of Object.keys(props)) {\n    const val = props[key];\n    Object.defineProperty(target, key, {\n      value: val !== null && typeof val === 'object' ? Object.freeze(val) : val,\n      writable: false,\n      enumerable: false,\n      configurable: false,\n    });\n  }\n  return target;\n}\n","/**\n * useForgeApi：包装 forge.api()，自动管理 loading/error 状态\n * @see .docs/SPEC.md §4.1.7\n *\n * 支持：\n *   - useForgeApi()             — call(level, name, params)\n *   - useForgeApi(level)        — call(name, params)，自动绑定层级\n *   - useForgeApi(level, prefix) — call(suffix, params)，自动绑定层级 + 拼接前缀\n *\n * 类型推断：\n *   当 ForgeRouteMap 通过 codegen 或 module augmentation 定义时，\n *   level / name / params 均自动推断，IDE 提供补全提示。\n */\n\nimport { ref } from 'vue';\nimport { useForge } from '../plugin.js';\nimport type {\n  ApiCallParams,\n  ForgeApiParams,\n  ForgeApiResponse,\n  ForgeRouteName,\n} from '@route-forge/core';\n\n/** call 函数签名 — 未绑定 level，需要显式传入 */\nexport interface UseForgeApiCall {\n  (level: string, name: string, params?: ApiCallParams): Promise<{\n    data: unknown;\n    error: unknown;\n  }>;\n}\n\n/** call 函数签名 — 已绑定 level，无需再传 */\nexport interface UseForgeApiBoundCall<L extends string> {\n  (name: ForgeRouteName<L>, params?: ForgeApiParams<L, ForgeRouteName<L>>): Promise<{\n    data: ForgeApiResponse<L, ForgeRouteName<L>>;\n    error: unknown;\n  }>;\n}\n\nexport interface UseForgeApiReturn {\n  pending: ReturnType<typeof ref<boolean>>;\n  error: ReturnType<typeof ref<unknown>>;\n  call: UseForgeApiCall;\n}\n\nexport interface UseForgeApiBoundReturn<L extends string> {\n  pending: ReturnType<typeof ref<boolean>>;\n  error: ReturnType<typeof ref<unknown>>;\n  call: UseForgeApiBoundCall<L>;\n}\n\n/** 不绑定层级 — call 需要传 level */\nexport function useForgeApi(): UseForgeApiReturn;\n/** 绑定层级 — call 无需传 level */\nexport function useForgeApi<L extends string>(level: L): UseForgeApiBoundReturn<L>;\n/** 绑定层级 + 前缀 — call 无需传 level，路由名自动拼接 prefix */\nexport function useForgeApi<L extends string>(level: L, prefix: string): UseForgeApiBoundReturn<L>;\nexport function useForgeApi(level?: string, prefix?: string): UseForgeApiReturn | UseForgeApiBoundReturn<string> {\n  const forge = level !== undefined ? useForge(level, prefix as string) : useForge();\n  const pending = ref(false);\n  const error = ref<unknown>(null);\n\n  async function call(...args: unknown[]): Promise<{ data: unknown; error: unknown }> {\n    pending.value = true;\n    error.value = null;\n    try {\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      const data = await (forge as any).api(...args);\n      return { data, error: null };\n    } catch (e) {\n      error.value = e;\n      return { data: undefined, error: e };\n    } finally {\n      pending.value = false;\n    }\n  }\n\n  return { pending, error, call: call as any };\n}\n","/**\n * useForgeRoute：响应式 URL 生成器，内部处理 level 加载状态\n * @see .docs/SPEC.md §4.1.7\n *\n * - level 未加载时返回空字符串 ''（不抛错，模板不崩）\n * - level 加载完成后自动重新计算并返回正确 URL\n * - 用户无需关心 levelLoaded 状态，直接用即可\n */\n\nimport { computed, type ComputedRef, inject, onMounted, ref } from 'vue';\nimport { FORGE_INJECTION_KEY } from '../plugin.js';\nimport type { RouteForge } from '@route-forge/core';\n\nexport function useForgeRoute(\n  level: string | (() => string),\n  name: string | (() => string),\n  params?: () => Record<string, unknown>,\n): ComputedRef<string> {\n  const forge = inject(FORGE_INJECTION_KEY) as RouteForge;\n\n  // 响应式追踪 level 加载状态（computed 依赖此 ref 触发重新计算）\n  const levelLoaded = ref(forge.isLoaded(typeof level === 'function' ? level() : level));\n\n  const lvl = typeof level === 'function' ? level() : level;\n  if (!levelLoaded.value) {\n    onMounted(() => {\n      forge.load(lvl).then(() => {\n        levelLoaded.value = true;\n      }).catch(() => { /* 加载失败时 computed 返回 '' */\n      });\n    });\n  }\n\n  return computed(() => {\n    // level 未加载 → 返回空字符串，不抛错\n    if (!levelLoaded.value) return '';\n    const l = typeof level === 'function' ? level() : level;\n    const n = typeof name === 'function' ? name() : name;\n    const p = params ? params() : undefined;\n    return forge.route(l, n, p);\n  });\n}\n","/**\n * useForgeByPrefix：带层级 + 名字前缀的封装，方便后续减少名称传入\n * @see .docs/SPEC.md §4.1.7\n *\n * 智能前缀解析：\n *   - 传入后缀不以前缀开头 → 自动拼接 prefix.suffix\n *   - 传入后缀已以前缀开头（歧义） → 优先尝试完整拼接，\n *     若不存在则视为已含前缀直接使用，均不存在则报错\n *\n * 示例（prefix = 'test'）：\n *   api('1')        → test.1\n *   api('test1.1')  → test.test1.1\n *   api('test.1')   → 歧义：优先 test.test.1，回退 test.1\n */\n\nimport { inject } from 'vue';\nimport { FORGE_INJECTION_KEY } from '../plugin.js';\nimport { resolveRouteName, resolveRouteNameSync } from '../utils/resolveRouteName.js';\nimport type { ApiCallParams, RouteForge } from '@route-forge/core';\n\nexport interface UseForgeByPrefixReturn {\n  api: (suffix: string, params?: ApiCallParams) => Promise<unknown>;\n  route: (suffix: string, params?: Record<string, unknown>) => string;\n}\n\nexport function useForgeByPrefix(level: string, prefix: string, separator = '.'): UseForgeByPrefixReturn {\n  const forge = inject(FORGE_INJECTION_KEY) as RouteForge;\n\n  return {\n    api: (suffix, params) =>\n      resolveRouteName(forge, level, prefix, suffix, separator).then(\n        (name) => forge.api(level, name, params),\n      ),\n    route: (suffix, params) => {\n      // level 未加载时返回空字符串，避免 resolveRouteNameSync 内部 hasRoute() 抛错\n      if (!forge.isLoaded(level)) return '';\n      return forge.route(level, resolveRouteNameSync(forge, level, prefix, suffix, separator), params);\n    },\n  };\n}\n"]}
+{"version":3,"sources":["../src/plugin.ts","../src/composables/useForgeApi.ts","../src/composables/useForgeRoute.ts","../src/composables/useForgeByPrefix.ts"],"names":["createRouteForge","inject","ref","callable","resolveRouteName","defineImmutableProps","resolveRouteNameSync","onMounted","computed"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * Vue 3 插件入口\n * @see .docs/SPEC.md §4.1.7\n *\n * 提供：\n *   - 全局属性 $forge（route() 工具）\n *   - inject symbol 注入 RouteForge 实例供 composable 使用\n *   - useForge() / useForge(level) / useForge(level, prefix) 返回统一方法的 forge 实例\n *     • 不传 level：forge(level, name, params?) 直接调用\n *     • 传 level：forge(name, params?) 直接调用，自动绑定层级\n *     • 传 level + prefix：forge(suffix, params?) 自动拼接 prefix\n *\n * 类型推断：\n *   当 ForgeRouteMap 通过 codegen 或 module augmentation 定义时，\n *   level / name / params 均自动推断，IDE 提供补全提示。\n */\n\nimport type { App, InjectionKey, Plugin, Ref } from 'vue';\nimport { inject, ref } from 'vue';\nimport {\n  type ApiCallParams,\n  createRouteForge,\n  type ForgeInstanceTyped,\n  type RouteForge,\n  type RouteForgeOptions,\n  resolveRouteName,\n  resolveRouteNameSync,\n} from '@route-forge/core';\nimport { defineImmutableProps } from '@route-forge/core/internal';\n\nexport const FORGE_INJECTION_KEY: InjectionKey<RouteForge> = Symbol('route-forge');\n\nexport interface RouteForgePluginOptions extends RouteForgeOptions {}\n\n/** 已绑定 level — 直接调用无需 level，api/route/url 的 name 自动限定到该层级 */\nexport type BoundForgeTyped<L extends string> = import('@route-forge/core').BoundForgeTyped<L, Ref<boolean>>;\n\n/** 未绑定 level — 直接调用需要传 level（不提供 route/url/hasRoute/getRoutes 等同步方法） */\nexport type { ForgeInstanceTyped } from '@route-forge/core';\n\nexport function createRouteForgePlugin(options: RouteForgePluginOptions): Plugin<[]> & {\n  ready: Promise<void>\n} {\n  const forge = createRouteForge(options);\n\n  return {\n    ready: forge.ready,\n    install(app: App) {\n      app.provide(FORGE_INJECTION_KEY, forge);\n      app.config.globalProperties.$forge = {\n        route: (level: string, name: string, params?: Record<string, unknown>) =>\n          forge.route(level, name, params),\n      };\n    },\n  };\n}\n\n/**\n * 获取 forge 实例。\n *\n * @example\n * // 不绑定层级\n * const forge = useForge()\n * forge('admin', 'users.show', { user: 1 })\n * forge.api('admin', 'users.show')\n *\n * @example\n * // 绑定层级 — 直接调用和 api/route/url 均无需传 level\n * const forge = useForge('admin')\n * forge.level                    // → 'admin'\n * forge('users.show', { user: 1 })\n * forge.api('users.show')\n *\n * @example\n * // 绑定层级 + 前缀 — 路由名自动拼接\n * const forge = useForge('admin', 'users')\n * forge.level                    // → 'admin'\n * forge.prefix                   // → 'users'\n * forge('show', { user: 1 })           // → forge.api('admin', 'users.show', ...)\n * forge.api('index')                   // → forge.api('admin', 'users.index')\n * forge.route('show', { user: 1 })     // → forge.route('admin', 'users.show', ...)\n */\nexport function useForge<L extends string>(level: L, prefix: string): BoundForgeTyped<L>;\nexport function useForge<L extends string>(level: L): BoundForgeTyped<L>;\nexport function useForge(): ForgeInstanceTyped;\nexport function useForge(level?: string, prefix?: string): ForgeInstanceTyped | BoundForgeTyped<string> {\n  const forge = inject(FORGE_INJECTION_KEY);\n  if (!forge) {\n    throw new Error(\n      '[route-forge/vue] useForge() must be used inside an app with createRouteForgePlugin() installed',\n    );\n  }\n\n  if (level !== undefined) {\n    // 自动触发 level 加载 + 响应式 levelLoaded 状态\n    const levelLoaded = ref(forge.isLoaded(level));\n    forge.load(level).then(() => {\n      levelLoaded.value = true;\n    }).catch(() => { /* 加载失败时 levelLoaded 保持 false */\n    });\n    // 订阅 level 加载完成事件（兜底：如果 load() 在 ref 赋值后才完成）\n    const unsub = forge.onLevelLoaded(level, () => {\n      levelLoaded.value = true;\n      unsub();\n    });\n\n    const callable = prefix\n      ? async (name: string, params?: ApiCallParams) =>\n        forge.api(level, await resolveRouteName(forge, level, prefix, name), params)\n      : (name: string, params?: ApiCallParams) =>\n        forge.api(level, name, params);\n    defineImmutableProps(callable, {\n      level,\n      // 未传 prefix 时不定义该属性，与 React 包行为保持一致（'prefix' in forge === false）\n      ...(prefix !== undefined ? { prefix } : {}),\n      api: prefix\n        ? async (name: string, params?: ApiCallParams) =>\n          forge.api(level, await resolveRouteName(forge, level, prefix, name), params)\n        : (name: string, params?: ApiCallParams) => forge.api(level, name, params),\n      route: prefix\n        ? (name: string, params?: Record<string, unknown>) =>\n          forge.route(level, resolveRouteNameSync(forge, level, prefix, name), params)\n        : (name: string, params?: Record<string, unknown>) => forge.route(level, name, params),\n      url: prefix\n        ? (name: string, params?: Record<string, unknown>) =>\n          forge.route(level, resolveRouteNameSync(forge, level, prefix, name), params)\n        : (name: string, params?: Record<string, unknown>) => forge.route(level, name, params),\n      load: forge.load.bind(forge),\n      invalidate: forge.invalidate.bind(forge),\n      isLoaded: forge.isLoaded.bind(forge),\n      hasRoute: forge.hasRoute.bind(forge),\n      isLoading: forge.isLoading.bind(forge),\n      onLoadingChange: forge.onLoadingChange.bind(forge),\n      getRoutes: forge.getRoutes.bind(forge),\n    });\n    // levelLoaded 需要保持响应式，不能通过 defineImmutableProps（会 Object.freeze）\n    Object.defineProperty(callable, 'levelLoaded', {\n      value: levelLoaded,\n      writable: false,\n      enumerable: true,\n      configurable: false,\n    });\n    return callable as unknown as BoundForgeTyped<string>;\n  }\n\n  const callable = (lvl: string, name: string, params?: ApiCallParams) =>\n    forge.api(lvl, name, params);\n  defineImmutableProps(callable, {\n    api: forge.api.bind(forge),\n    load: forge.load.bind(forge),\n    invalidate: forge.invalidate.bind(forge),\n    isLoaded: forge.isLoaded.bind(forge),\n    isLoading: forge.isLoading.bind(forge),\n    onLoadingChange: forge.onLoadingChange.bind(forge),\n    ready: forge.ready,\n    onLevelLoaded: forge.onLevelLoaded.bind(forge),\n  });\n  return callable as unknown as ForgeInstanceTyped;\n}\n\n\n","/**\n * useForgeApi：包装 forge.api()，自动管理 loading/error 状态\n * @see .docs/SPEC.md §4.1.7\n *\n * 支持：\n *   - useForgeApi()             — call(level, name, params)\n *   - useForgeApi(level)        — call(name, params)，自动绑定层级\n *   - useForgeApi(level, prefix) — call(suffix, params)，自动绑定层级 + 拼接前缀\n *\n * 类型推断：\n *   当 ForgeRouteMap 通过 codegen 或 module augmentation 定义时，\n *   level / name / params 均自动推断，IDE 提供补全提示。\n */\n\nimport { ref } from 'vue';\nimport { useForge } from '../plugin.js';\nimport type { Ref } from 'vue';\nimport type {\n  UseForgeApiCall,\n  UseForgeApiBoundCall,\n  UseForgeApiReturn,\n  UseForgeApiBoundReturn,\n} from '@route-forge/core';\n\n// Vue 特化类型：pending/error 为 Ref\nexport type { UseForgeApiCall, UseForgeApiBoundCall };\nexport type UseForgeApiReturnVue = UseForgeApiReturn<Ref<boolean>, Ref<unknown>>;\nexport type UseForgeApiBoundReturnVue<L extends string> = UseForgeApiBoundReturn<L, Ref<boolean>, Ref<unknown>>;\n\n/** 不绑定层级 — call 需要传 level */\nexport function useForgeApi(): UseForgeApiReturnVue;\n/** 绑定层级 — call 无需传 level */\nexport function useForgeApi<L extends string>(level: L): UseForgeApiBoundReturnVue<L>;\n/** 绑定层级 + 前缀 — call 无需传 level，路由名自动拼接 prefix */\nexport function useForgeApi<L extends string>(level: L, prefix: string): UseForgeApiBoundReturnVue<L>;\nexport function useForgeApi(level?: string, prefix?: string): UseForgeApiReturnVue | UseForgeApiBoundReturnVue<string> {\n  const forge = level !== undefined ? useForge(level, prefix as string) : useForge();\n  const pending = ref(false);\n  const error = ref<unknown>(null);\n\n  async function call(...args: unknown[]): Promise<{ data: unknown; error: unknown }> {\n    pending.value = true;\n    error.value = null;\n    try {\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      const data = await (forge as any).api(...args);\n      return { data, error: null };\n    } catch (e) {\n      error.value = e;\n      return { data: undefined, error: e };\n    } finally {\n      pending.value = false;\n    }\n  }\n\n  return { pending, error, call: call as any };\n}\n","/**\n * useForgeRoute：响应式 URL 生成器，内部处理 level 加载状态\n * @see .docs/SPEC.md §4.1.7\n *\n * - level 未加载时返回空字符串 ''（不抛错，模板不崩）\n * - level 加载完成后自动重新计算并返回正确 URL\n * - 用户无需关心 levelLoaded 状态，直接用即可\n */\n\nimport { computed, type ComputedRef, inject, onMounted, ref } from 'vue';\nimport { FORGE_INJECTION_KEY } from '../plugin.js';\nimport type { RouteForge } from '@route-forge/core';\n\nexport function useForgeRoute(\n  level: string | (() => string),\n  name: string | (() => string),\n  params?: () => Record<string, unknown>,\n): ComputedRef<string> {\n  const forge = inject(FORGE_INJECTION_KEY) as RouteForge;\n\n  // 响应式追踪 level 加载状态（computed 依赖此 ref 触发重新计算）\n  const levelLoaded = ref(forge.isLoaded(typeof level === 'function' ? level() : level));\n\n  const lvl = typeof level === 'function' ? level() : level;\n  if (!levelLoaded.value) {\n    onMounted(() => {\n      forge.load(lvl).then(() => {\n        levelLoaded.value = true;\n      }).catch(() => { /* 加载失败时 computed 返回 '' */\n      });\n    });\n  }\n\n  return computed(() => {\n    // level 未加载 → 返回空字符串，不抛错\n    if (!levelLoaded.value) return '';\n    const l = typeof level === 'function' ? level() : level;\n    const n = typeof name === 'function' ? name() : name;\n    const p = params ? params() : undefined;\n    return forge.route(l, n, p);\n  });\n}\n","/**\n * useForgeByPrefix：带层级 + 名字前缀的封装，方便后续减少名称传入\n * @see .docs/SPEC.md §4.1.7\n *\n * 智能前缀解析：\n *   - 传入后缀不以前缀开头 → 自动拼接 prefix.suffix\n *   - 传入后缀已以前缀开头（歧义） → 优先尝试完整拼接，\n *     若不存在则视为已含前缀直接使用，均不存在则报错\n *\n * 示例（prefix = 'test'）：\n *   api('1')        → test.1\n *   api('test1.1')  → test.test1.1\n *   api('test.1')   → 歧义：优先 test.test.1，回退 test.1\n */\n\nimport { inject } from 'vue';\nimport { FORGE_INJECTION_KEY } from '../plugin.js';\nimport {\n  resolveRouteName,\n  resolveRouteNameSync,\n  type ApiCallParams,\n  type RouteForge,\n  type UseForgeByPrefixReturn,\n} from '@route-forge/core';\n\nexport type { UseForgeByPrefixReturn };\n\nexport function useForgeByPrefix(level: string, prefix: string, separator = '.'): UseForgeByPrefixReturn {\n  const forge = inject(FORGE_INJECTION_KEY) as RouteForge;\n\n  return {\n    api: (suffix, params) =>\n      resolveRouteName(forge, level, prefix, suffix, separator).then(\n        (name) => forge.api(level, name, params),\n      ),\n    route: (suffix, params) => {\n      // level 未加载时返回空字符串，避免 resolveRouteNameSync 内部 hasRoute() 抛错\n      if (!forge.isLoaded(level)) return '';\n      return forge.route(level, resolveRouteNameSync(forge, level, prefix, suffix, separator), params);\n    },\n  };\n}\n"]}

package/dist/index.d.cts

@@ -1,81 +1,14 @@
-import { Ref, InjectionKey, Plugin, ref, ComputedRef } from 'vue';
-import { InterceptorHandler, RequestConfig, ResponseData, ForgeRouteName, ForgeApiParams, ForgeApiResponse, LoadingChangeCallback, RouteMeta, RouteForge, ApiCallParams, RouteForgeOptions } from '@route-forge/core';
-
-/**
- * Vue 3 插件入口
- * @see .docs/SPEC.md §4.1.7
- *
- * 提供：
- *   - 全局属性 $forge（route() 工具）
- *   - inject symbol 注入 RouteForge 实例供 composable 使用
- *   - useForge() / useForge(level) / useForge(level, prefix) 返回统一方法的 forge 实例
- *     • 不传 level：forge(level, name, params?) 直接调用
- *     • 传 level：forge(name, params?) 直接调用，自动绑定层级
- *     • 传 level + prefix：forge(suffix, params?) 自动拼接 prefix
- *
- * 类型推断：
- *   当 ForgeRouteMap 通过 codegen 或 module augmentation 定义时，
- *   level / name / params 均自动推断，IDE 提供补全提示。
- */
+import * as _route_forge_core from '@route-forge/core';
+import { RouteForge, RouteForgeOptions, ForgeInstanceTyped, UseForgeApiBoundReturn, UseForgeApiReturn, UseForgeByPrefixReturn } from '@route-forge/core';
+export { ForgeInstanceTyped, UseForgeApiBoundCall, UseForgeApiCall, UseForgeByPrefixReturn } from '@route-forge/core';
+import { Ref, InjectionKey, Plugin, ComputedRef } from 'vue';
 
 declare const FORGE_INJECTION_KEY: InjectionKey<RouteForge>;
 interface RouteForgePluginOptions extends RouteForgeOptions {
 }
-/** 只读拦截器管理器：仅暴露查询方法，隐藏 use/eject/clear */
-interface ReadOnlyInterceptorManager<TIn, TOut = TIn> {
-    readonly size: number;
-    forEach(fn: (handler: InterceptorHandler<TIn, TOut>) => void): void;
-}
-/**
- * 共享方法集（level 已绑定时的方法签名）
- * .api() / .route() / .url() — name 和 params 根据 ForgeRouteMap 自动推断
- * .load() / .invalidate() / .isLoaded() / .interceptors
- */
-interface BoundForgeMethods<L extends string = string> {
-    interceptors: {
-        request: ReadOnlyInterceptorManager<RequestConfig>;
-        response: ReadOnlyInterceptorManager<ResponseData>;
-    };
-    api(name: ForgeRouteName<L>, params?: ForgeApiParams<L, ForgeRouteName<L>>): Promise<ForgeApiResponse<L, ForgeRouteName<L>>>;
-    route(name: ForgeRouteName<L>, params?: ForgeApiParams<L, ForgeRouteName<L>>): string;
-    url(name: ForgeRouteName<L>, params?: ForgeApiParams<L, ForgeRouteName<L>>): string;
-    load(level: string | string[]): Promise<void>;
-    invalidate(level?: string | string[]): void;
-    isLoaded(level?: string): boolean;
-    hasRoute(level: string, name: string): boolean;
-    /** 查询加载中标识状态 */
-    isLoading(): boolean;
-    /** 订阅加载状态变更，返回取消订阅函数 */
-    onLoadingChange(cb: LoadingChangeCallback): () => void;
-    /** 获取指定层级下全部路由元信息（深拷贝，修改不影响内部缓存） */
-    getRoutes(level: string): Record<string, RouteMeta>;
-    /** 指定层级的路由元数据是否已加载完成（响应式） */
-    levelLoaded: Ref<boolean>;
-}
 /** 已绑定 level — 直接调用无需 level，api/route/url 的 name 自动限定到该层级 */
-interface BoundForgeTyped<L extends string> extends BoundForgeMethods<L> {
-    (name: ForgeRouteName<L>, params?: ForgeApiParams<L, ForgeRouteName<L>>): Promise<ForgeApiResponse<L, ForgeRouteName<L>>>;
-    /** 当前绑定的 level 值 */
-    readonly level: L;
-    /** 路由名前缀（仅在 useForge(level, prefix) 传入 prefix 时存在） */
-    readonly prefix?: string;
-}
-/** 未绑定 level — 直接调用需要传 level（不提供 route/url/hasRoute/getRoutes 等同步方法） */
-interface ForgeInstanceTyped {
-    (level: string, name: string, params?: ApiCallParams): Promise<unknown>;
-    api(level: string, name: string, params?: ApiCallParams): Promise<unknown>;
-    interceptors: {
-        request: ReadOnlyInterceptorManager<RequestConfig>;
-        response: ReadOnlyInterceptorManager<ResponseData>;
-    };
-    ready: Promise<void>;
-    load(level: string | string[]): Promise<void>;
-    invalidate(level?: string | string[]): void;
-    isLoaded(level?: string): boolean;
-    isLoading(): boolean;
-    onLoadingChange(cb: LoadingChangeCallback): () => void;
-    onLevelLoaded(level: string, cb: () => void): () => void;
-}
+type BoundForgeTyped<L extends string> = _route_forge_core.BoundForgeTyped<L, Ref<boolean>>;
+
 declare function createRouteForgePlugin(options: RouteForgePluginOptions): Plugin<[]> & {
     ready: Promise<void>;
 };
@@ -122,36 +55,14 @@ declare function useForge(): ForgeInstanceTyped;
  *   level / name / params 均自动推断，IDE 提供补全提示。
  */
 
-/** call 函数签名 — 未绑定 level，需要显式传入 */
-interface UseForgeApiCall {
-    (level: string, name: string, params?: ApiCallParams): Promise<{
-        data: unknown;
-        error: unknown;
-    }>;
-}
-/** call 函数签名 — 已绑定 level，无需再传 */
-interface UseForgeApiBoundCall<L extends string> {
-    (name: ForgeRouteName<L>, params?: ForgeApiParams<L, ForgeRouteName<L>>): Promise<{
-        data: ForgeApiResponse<L, ForgeRouteName<L>>;
-        error: unknown;
-    }>;
-}
-interface UseForgeApiReturn {
-    pending: ReturnType<typeof ref<boolean>>;
-    error: ReturnType<typeof ref<unknown>>;
-    call: UseForgeApiCall;
-}
-interface UseForgeApiBoundReturn<L extends string> {
-    pending: ReturnType<typeof ref<boolean>>;
-    error: ReturnType<typeof ref<unknown>>;
-    call: UseForgeApiBoundCall<L>;
-}
+type UseForgeApiReturnVue = UseForgeApiReturn<Ref<boolean>, Ref<unknown>>;
+type UseForgeApiBoundReturnVue<L extends string> = UseForgeApiBoundReturn<L, Ref<boolean>, Ref<unknown>>;
 /** 不绑定层级 — call 需要传 level */
-declare function useForgeApi(): UseForgeApiReturn;
+declare function useForgeApi(): UseForgeApiReturnVue;
 /** 绑定层级 — call 无需传 level */
-declare function useForgeApi<L extends string>(level: L): UseForgeApiBoundReturn<L>;
+declare function useForgeApi<L extends string>(level: L): UseForgeApiBoundReturnVue<L>;
 /** 绑定层级 + 前缀 — call 无需传 level，路由名自动拼接 prefix */
-declare function useForgeApi<L extends string>(level: L, prefix: string): UseForgeApiBoundReturn<L>;
+declare function useForgeApi<L extends string>(level: L, prefix: string): UseForgeApiBoundReturnVue<L>;
 
 /**
  * useForgeRoute：响应式 URL 生成器，内部处理 level 加载状态
@@ -179,10 +90,6 @@ declare function useForgeRoute(level: string | (() => string), name: string | ((
  *   api('test.1')   → 歧义：优先 test.test.1，回退 test.1
  */
 
-interface UseForgeByPrefixReturn {
-    api: (suffix: string, params?: ApiCallParams) => Promise<unknown>;
-    route: (suffix: string, params?: Record<string, unknown>) => string;
-}
 declare function useForgeByPrefix(level: string, prefix: string, separator?: string): UseForgeByPrefixReturn;
 
-export { type BoundForgeMethods, type BoundForgeTyped, FORGE_INJECTION_KEY, type ForgeInstanceTyped, type RouteForgePluginOptions, type UseForgeApiBoundCall, type UseForgeApiBoundReturn, type UseForgeApiCall, type UseForgeApiReturn, type UseForgeByPrefixReturn, createRouteForgePlugin, useForge, useForgeApi, useForgeByPrefix, useForgeRoute };
+export { type BoundForgeTyped, FORGE_INJECTION_KEY, type RouteForgePluginOptions, type UseForgeApiBoundReturnVue, type UseForgeApiReturnVue, createRouteForgePlugin, useForge, useForgeApi, useForgeByPrefix, useForgeRoute };

package/dist/index.d.ts

@@ -1,81 +1,14 @@
-import { Ref, InjectionKey, Plugin, ref, ComputedRef } from 'vue';
-import { InterceptorHandler, RequestConfig, ResponseData, ForgeRouteName, ForgeApiParams, ForgeApiResponse, LoadingChangeCallback, RouteMeta, RouteForge, ApiCallParams, RouteForgeOptions } from '@route-forge/core';
-
-/**
- * Vue 3 插件入口
- * @see .docs/SPEC.md §4.1.7
- *
- * 提供：
- *   - 全局属性 $forge（route() 工具）
- *   - inject symbol 注入 RouteForge 实例供 composable 使用
- *   - useForge() / useForge(level) / useForge(level, prefix) 返回统一方法的 forge 实例
- *     • 不传 level：forge(level, name, params?) 直接调用
- *     • 传 level：forge(name, params?) 直接调用，自动绑定层级
- *     • 传 level + prefix：forge(suffix, params?) 自动拼接 prefix
- *
- * 类型推断：
- *   当 ForgeRouteMap 通过 codegen 或 module augmentation 定义时，
- *   level / name / params 均自动推断，IDE 提供补全提示。
- */
+import * as _route_forge_core from '@route-forge/core';
+import { RouteForge, RouteForgeOptions, ForgeInstanceTyped, UseForgeApiBoundReturn, UseForgeApiReturn, UseForgeByPrefixReturn } from '@route-forge/core';
+export { ForgeInstanceTyped, UseForgeApiBoundCall, UseForgeApiCall, UseForgeByPrefixReturn } from '@route-forge/core';
+import { Ref, InjectionKey, Plugin, ComputedRef } from 'vue';
 
 declare const FORGE_INJECTION_KEY: InjectionKey<RouteForge>;
 interface RouteForgePluginOptions extends RouteForgeOptions {
 }
-/** 只读拦截器管理器：仅暴露查询方法，隐藏 use/eject/clear */
-interface ReadOnlyInterceptorManager<TIn, TOut = TIn> {
-    readonly size: number;
-    forEach(fn: (handler: InterceptorHandler<TIn, TOut>) => void): void;
-}
-/**
- * 共享方法集（level 已绑定时的方法签名）
- * .api() / .route() / .url() — name 和 params 根据 ForgeRouteMap 自动推断
- * .load() / .invalidate() / .isLoaded() / .interceptors
- */
-interface BoundForgeMethods<L extends string = string> {
-    interceptors: {
-        request: ReadOnlyInterceptorManager<RequestConfig>;
-        response: ReadOnlyInterceptorManager<ResponseData>;
-    };
-    api(name: ForgeRouteName<L>, params?: ForgeApiParams<L, ForgeRouteName<L>>): Promise<ForgeApiResponse<L, ForgeRouteName<L>>>;
-    route(name: ForgeRouteName<L>, params?: ForgeApiParams<L, ForgeRouteName<L>>): string;
-    url(name: ForgeRouteName<L>, params?: ForgeApiParams<L, ForgeRouteName<L>>): string;
-    load(level: string | string[]): Promise<void>;
-    invalidate(level?: string | string[]): void;
-    isLoaded(level?: string): boolean;
-    hasRoute(level: string, name: string): boolean;
-    /** 查询加载中标识状态 */
-    isLoading(): boolean;
-    /** 订阅加载状态变更，返回取消订阅函数 */
-    onLoadingChange(cb: LoadingChangeCallback): () => void;
-    /** 获取指定层级下全部路由元信息（深拷贝，修改不影响内部缓存） */
-    getRoutes(level: string): Record<string, RouteMeta>;
-    /** 指定层级的路由元数据是否已加载完成（响应式） */
-    levelLoaded: Ref<boolean>;
-}
 /** 已绑定 level — 直接调用无需 level，api/route/url 的 name 自动限定到该层级 */
-interface BoundForgeTyped<L extends string> extends BoundForgeMethods<L> {
-    (name: ForgeRouteName<L>, params?: ForgeApiParams<L, ForgeRouteName<L>>): Promise<ForgeApiResponse<L, ForgeRouteName<L>>>;
-    /** 当前绑定的 level 值 */
-    readonly level: L;
-    /** 路由名前缀（仅在 useForge(level, prefix) 传入 prefix 时存在） */
-    readonly prefix?: string;
-}
-/** 未绑定 level — 直接调用需要传 level（不提供 route/url/hasRoute/getRoutes 等同步方法） */
-interface ForgeInstanceTyped {
-    (level: string, name: string, params?: ApiCallParams): Promise<unknown>;
-    api(level: string, name: string, params?: ApiCallParams): Promise<unknown>;
-    interceptors: {
-        request: ReadOnlyInterceptorManager<RequestConfig>;
-        response: ReadOnlyInterceptorManager<ResponseData>;
-    };
-    ready: Promise<void>;
-    load(level: string | string[]): Promise<void>;
-    invalidate(level?: string | string[]): void;
-    isLoaded(level?: string): boolean;
-    isLoading(): boolean;
-    onLoadingChange(cb: LoadingChangeCallback): () => void;
-    onLevelLoaded(level: string, cb: () => void): () => void;
-}
+type BoundForgeTyped<L extends string> = _route_forge_core.BoundForgeTyped<L, Ref<boolean>>;
+
 declare function createRouteForgePlugin(options: RouteForgePluginOptions): Plugin<[]> & {
     ready: Promise<void>;
 };
@@ -122,36 +55,14 @@ declare function useForge(): ForgeInstanceTyped;
  *   level / name / params 均自动推断，IDE 提供补全提示。
  */
 
-/** call 函数签名 — 未绑定 level，需要显式传入 */
-interface UseForgeApiCall {
-    (level: string, name: string, params?: ApiCallParams): Promise<{
-        data: unknown;
-        error: unknown;
-    }>;
-}
-/** call 函数签名 — 已绑定 level，无需再传 */
-interface UseForgeApiBoundCall<L extends string> {
-    (name: ForgeRouteName<L>, params?: ForgeApiParams<L, ForgeRouteName<L>>): Promise<{
-        data: ForgeApiResponse<L, ForgeRouteName<L>>;
-        error: unknown;
-    }>;
-}
-interface UseForgeApiReturn {
-    pending: ReturnType<typeof ref<boolean>>;
-    error: ReturnType<typeof ref<unknown>>;
-    call: UseForgeApiCall;
-}
-interface UseForgeApiBoundReturn<L extends string> {
-    pending: ReturnType<typeof ref<boolean>>;
-    error: ReturnType<typeof ref<unknown>>;
-    call: UseForgeApiBoundCall<L>;
-}
+type UseForgeApiReturnVue = UseForgeApiReturn<Ref<boolean>, Ref<unknown>>;
+type UseForgeApiBoundReturnVue<L extends string> = UseForgeApiBoundReturn<L, Ref<boolean>, Ref<unknown>>;
 /** 不绑定层级 — call 需要传 level */
-declare function useForgeApi(): UseForgeApiReturn;
+declare function useForgeApi(): UseForgeApiReturnVue;
 /** 绑定层级 — call 无需传 level */
-declare function useForgeApi<L extends string>(level: L): UseForgeApiBoundReturn<L>;
+declare function useForgeApi<L extends string>(level: L): UseForgeApiBoundReturnVue<L>;
 /** 绑定层级 + 前缀 — call 无需传 level，路由名自动拼接 prefix */
-declare function useForgeApi<L extends string>(level: L, prefix: string): UseForgeApiBoundReturn<L>;
+declare function useForgeApi<L extends string>(level: L, prefix: string): UseForgeApiBoundReturnVue<L>;
 
 /**
  * useForgeRoute：响应式 URL 生成器，内部处理 level 加载状态
@@ -179,10 +90,6 @@ declare function useForgeRoute(level: string | (() => string), name: string | ((
  *   api('test.1')   → 歧义：优先 test.test.1，回退 test.1
  */
 
-interface UseForgeByPrefixReturn {
-    api: (suffix: string, params?: ApiCallParams) => Promise<unknown>;
-    route: (suffix: string, params?: Record<string, unknown>) => string;
-}
 declare function useForgeByPrefix(level: string, prefix: string, separator?: string): UseForgeByPrefixReturn;
 
-export { type BoundForgeMethods, type BoundForgeTyped, FORGE_INJECTION_KEY, type ForgeInstanceTyped, type RouteForgePluginOptions, type UseForgeApiBoundCall, type UseForgeApiBoundReturn, type UseForgeApiCall, type UseForgeApiReturn, type UseForgeByPrefixReturn, createRouteForgePlugin, useForge, useForgeApi, useForgeByPrefix, useForgeRoute };
+export { type BoundForgeTyped, FORGE_INJECTION_KEY, type RouteForgePluginOptions, type UseForgeApiBoundReturnVue, type UseForgeApiReturnVue, createRouteForgePlugin, useForge, useForgeApi, useForgeByPrefix, useForgeRoute };

package/dist/index.js

@@ -1,24 +1,6 @@
 import { inject, ref, onMounted, computed } from 'vue';
-import { createRouteForge, UnknownRouteError } from '@route-forge/core';
-
-// src/plugin.ts
-async function resolveRouteName(forge, level, prefix, suffix, separator = ".") {
-  if (!suffix) return prefix;
-  const joined = `${prefix}${separator}${suffix}`;
-  if (!suffix.startsWith(`${prefix}${separator}`)) return joined;
-  await forge.load(level);
-  if (forge.hasRoute(level, joined)) return joined;
-  if (forge.hasRoute(level, suffix)) return suffix;
-  throw new UnknownRouteError(joined, level);
-}
-function resolveRouteNameSync(forge, level, prefix, suffix, separator = ".") {
-  if (!suffix) return prefix;
-  const joined = `${prefix}${separator}${suffix}`;
-  if (!suffix.startsWith(`${prefix}${separator}`)) return joined;
-  if (forge.hasRoute(level, joined)) return joined;
-  if (forge.hasRoute(level, suffix)) return suffix;
-  throw new UnknownRouteError(joined, level);
-}
+import { createRouteForge, resolveRouteNameSync, resolveRouteName } from '@route-forge/core';
+import { defineImmutableProps } from '@route-forge/core/internal';
 
 // src/plugin.ts
 var FORGE_INJECTION_KEY = /* @__PURE__ */ Symbol("route-forge");
@@ -65,8 +47,7 @@ function useForge(level, prefix) {
       hasRoute: forge.hasRoute.bind(forge),
       isLoading: forge.isLoading.bind(forge),
       onLoadingChange: forge.onLoadingChange.bind(forge),
-      getRoutes: forge.getRoutes.bind(forge),
-      interceptors: forge.interceptors
+      getRoutes: forge.getRoutes.bind(forge)
     });
     Object.defineProperty(callable2, "levelLoaded", {
       value: levelLoaded,
@@ -84,24 +65,11 @@ function useForge(level, prefix) {
     isLoaded: forge.isLoaded.bind(forge),
     isLoading: forge.isLoading.bind(forge),
     onLoadingChange: forge.onLoadingChange.bind(forge),
-    interceptors: forge.interceptors,
     ready: forge.ready,
     onLevelLoaded: forge.onLevelLoaded.bind(forge)
   });
   return callable;
 }
-function defineImmutableProps(target, props) {
-  for (const key of Object.keys(props)) {
-    const val = props[key];
-    Object.defineProperty(target, key, {
-      value: val !== null && typeof val === "object" ? Object.freeze(val) : val,
-      writable: false,
-      enumerable: false,
-      configurable: false
-    });
-  }
-  return target;
-}
 function useForgeApi(level, prefix) {
   const forge = level !== void 0 ? useForge(level, prefix) : useForge();
   const pending = ref(false);

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/utils/resolveRouteName.ts","../src/plugin.ts","../src/composables/useForgeApi.ts","../src/composables/useForgeRoute.ts","../src/composables/useForgeByPrefix.ts"],"names":["callable","ref","inject"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * 智能路由名前缀解析\n *\n * 当前缀与后缀拼接产生歧义时（后缀本身已以前缀开头），\n * 通过查询已加载路由表来判定正确名称：\n *   - 优先尝试 prefix + sep + suffix（完整拼接）\n *   - 若不存在则回退到 suffix（视为已含前缀）\n *   - 均不存在则抛 UnknownRouteError\n *\n * @see .docs/SPEC.md §4.1.7\n */\n\nimport { UnknownRouteError } from '@route-forge/core';\n\n/**\n * 路由名解析所需的最小 forge 接口。\n * 仅依赖 load() 和 hasRoute()，不依赖拦截器等完整能力。\n * 兼容 RouteForge、BoundForgeTyped、ForgeInstanceTyped 等所有形态。\n */\ninterface RouteResolver {\n  load(level: string | string[]): Promise<void>;\n\n  hasRoute(level: string, name: string): boolean;\n}\n\n/**\n * 异步版本：先确保层级已加载，再做歧义消解。\n * 适用于 api() 调用路径。\n */\nexport async function resolveRouteName(\n  forge: RouteResolver,\n  level: string,\n  prefix: string,\n  suffix: string,\n  separator = '.',\n): Promise<string> {\n  // 后缀为空 → 直接返回前缀\n  if (!suffix) return prefix;\n\n  const joined = `${prefix}${separator}${suffix}`;\n\n  // 后缀不以前缀开头 → 无歧义，直接拼接\n  if (!suffix.startsWith(`${prefix}${separator}`)) return joined;\n\n  // 歧义场景：先确保层级已加载\n  await forge.load(level);\n\n  // 优先尝试完整拼接\n  if (forge.hasRoute(level, joined)) return joined;\n  // 回退到后缀本身（视为已含前缀）\n  if (forge.hasRoute(level, suffix)) return suffix;\n\n  // 均不存在 → 报错\n  throw new UnknownRouteError(joined, level);\n}\n\n/**\n * 同步版本：基于已加载缓存做歧义消解。\n * 适用于 route() / url() 调用路径（要求层级已加载）。\n */\nexport function resolveRouteNameSync(\n  forge: RouteResolver,\n  level: string,\n  prefix: string,\n  suffix: string,\n  separator = '.',\n): string {\n  if (!suffix) return prefix;\n\n  const joined = `${prefix}${separator}${suffix}`;\n  if (!suffix.startsWith(`${prefix}${separator}`)) return joined;\n\n  // 歧义场景：基于已加载缓存判定\n  if (forge.hasRoute(level, joined)) return joined;\n  if (forge.hasRoute(level, suffix)) return suffix;\n\n  throw new UnknownRouteError(joined, level);\n}\n","/**\n * Vue 3 插件入口\n * @see .docs/SPEC.md §4.1.7\n *\n * 提供：\n *   - 全局属性 $forge（route() 工具）\n *   - inject symbol 注入 RouteForge 实例供 composable 使用\n *   - useForge() / useForge(level) / useForge(level, prefix) 返回统一方法的 forge 实例\n *     • 不传 level：forge(level, name, params?) 直接调用\n *     • 传 level：forge(name, params?) 直接调用，自动绑定层级\n *     • 传 level + prefix：forge(suffix, params?) 自动拼接 prefix\n *\n * 类型推断：\n *   当 ForgeRouteMap 通过 codegen 或 module augmentation 定义时，\n *   level / name / params 均自动推断，IDE 提供补全提示。\n */\n\nimport type { App, InjectionKey, Plugin, Ref } from 'vue';\nimport { inject, ref } from 'vue';\nimport {\n  type ApiCallParams,\n  createRouteForge,\n  type ForgeApiParams,\n  type ForgeApiResponse,\n  type ForgeRouteName,\n  type InterceptorHandler,\n  type LoadingChangeCallback,\n  type RequestConfig,\n  type ResponseData,\n  type RouteForge,\n  type RouteForgeOptions,\n  type RouteMeta,\n} from '@route-forge/core';\nimport { resolveRouteName, resolveRouteNameSync } from './utils/resolveRouteName.js';\n\nexport const FORGE_INJECTION_KEY: InjectionKey<RouteForge> = Symbol('route-forge');\n\nexport interface RouteForgePluginOptions extends RouteForgeOptions {}\n\n/** 只读拦截器管理器：仅暴露查询方法，隐藏 use/eject/clear */\ninterface ReadOnlyInterceptorManager<TIn, TOut = TIn> {\n  readonly size: number;\n\n  forEach(fn: (handler: InterceptorHandler<TIn, TOut>) => void): void;\n}\n\n/**\n * 共享方法集（level 已绑定时的方法签名）\n * .api() / .route() / .url() — name 和 params 根据 ForgeRouteMap 自动推断\n * .load() / .invalidate() / .isLoaded() / .interceptors\n */\nexport interface BoundForgeMethods<L extends string = string> {\n  interceptors: {\n    request: ReadOnlyInterceptorManager<RequestConfig>;\n    response: ReadOnlyInterceptorManager<ResponseData>;\n  };\n\n  api(name: ForgeRouteName<L>, params?: ForgeApiParams<L, ForgeRouteName<L>>): Promise<ForgeApiResponse<L, ForgeRouteName<L>>>;\n\n  route(name: ForgeRouteName<L>, params?: ForgeApiParams<L, ForgeRouteName<L>>): string;\n\n  url(name: ForgeRouteName<L>, params?: ForgeApiParams<L, ForgeRouteName<L>>): string;\n\n  load(level: string | string[]): Promise<void>;\n\n  invalidate(level?: string | string[]): void;\n\n  isLoaded(level?: string): boolean;\n\n  hasRoute(level: string, name: string): boolean;\n\n  /** 查询加载中标识状态 */\n  isLoading(): boolean;\n\n  /** 订阅加载状态变更，返回取消订阅函数 */\n  onLoadingChange(cb: LoadingChangeCallback): () => void;\n\n  /** 获取指定层级下全部路由元信息（深拷贝，修改不影响内部缓存） */\n  getRoutes(level: string): Record<string, RouteMeta>;\n\n  /** 指定层级的路由元数据是否已加载完成（响应式） */\n  levelLoaded: Ref<boolean>;\n}\n\n/** 已绑定 level — 直接调用无需 level，api/route/url 的 name 自动限定到该层级 */\nexport interface BoundForgeTyped<L extends string> extends BoundForgeMethods<L> {\n  (name: ForgeRouteName<L>, params?: ForgeApiParams<L, ForgeRouteName<L>>): Promise<ForgeApiResponse<L, ForgeRouteName<L>>>;\n  /** 当前绑定的 level 值 */\n  readonly level: L;\n  /** 路由名前缀（仅在 useForge(level, prefix) 传入 prefix 时存在） */\n  readonly prefix?: string;\n}\n\n/** 未绑定 level — 直接调用需要传 level（不提供 route/url/hasRoute/getRoutes 等同步方法） */\nexport interface ForgeInstanceTyped {\n  (level: string, name: string, params?: ApiCallParams): Promise<unknown>;\n  api(level: string, name: string, params?: ApiCallParams): Promise<unknown>;\n\n  interceptors: {\n    request: ReadOnlyInterceptorManager<RequestConfig>;\n    response: ReadOnlyInterceptorManager<ResponseData>;\n  };\n  ready: Promise<void>;\n\n  load(level: string | string[]): Promise<void>;\n\n  invalidate(level?: string | string[]): void;\n\n  isLoaded(level?: string): boolean;\n\n  isLoading(): boolean;\n\n  onLoadingChange(cb: LoadingChangeCallback): () => void;\n\n  onLevelLoaded(level: string, cb: () => void): () => void;\n}\n\nexport function createRouteForgePlugin(options: RouteForgePluginOptions): Plugin<[]> & {\n  ready: Promise<void>\n} {\n  const forge = createRouteForge(options);\n\n  return {\n    ready: forge.ready,\n    install(app: App) {\n      app.provide(FORGE_INJECTION_KEY, forge);\n      app.config.globalProperties.$forge = {\n        route: (level: string, name: string, params?: Record<string, unknown>) =>\n          forge.route(level, name, params),\n      };\n    },\n  };\n}\n\n/**\n * 获取 forge 实例。\n *\n * @example\n * // 不绑定层级\n * const forge = useForge()\n * forge('admin', 'users.show', { user: 1 })\n * forge.api('admin', 'users.show')\n *\n * @example\n * // 绑定层级 — 直接调用和 api/route/url 均无需传 level\n * const forge = useForge('admin')\n * forge.level                    // → 'admin'\n * forge('users.show', { user: 1 })\n * forge.api('users.show')\n *\n * @example\n * // 绑定层级 + 前缀 — 路由名自动拼接\n * const forge = useForge('admin', 'users')\n * forge.level                    // → 'admin'\n * forge.prefix                   // → 'users'\n * forge('show', { user: 1 })           // → forge.api('admin', 'users.show', ...)\n * forge.api('index')                   // → forge.api('admin', 'users.index')\n * forge.route('show', { user: 1 })     // → forge.route('admin', 'users.show', ...)\n */\nexport function useForge<L extends string>(level: L, prefix: string): BoundForgeTyped<L>;\nexport function useForge<L extends string>(level: L): BoundForgeTyped<L>;\nexport function useForge(): ForgeInstanceTyped;\nexport function useForge(level?: string, prefix?: string): ForgeInstanceTyped | BoundForgeTyped<string> {\n  const forge = inject(FORGE_INJECTION_KEY);\n  if (!forge) {\n    throw new Error(\n      '[route-forge/vue] useForge() must be used inside an app with createRouteForgePlugin() installed',\n    );\n  }\n\n  if (level !== undefined) {\n    // 自动触发 level 加载 + 响应式 levelLoaded 状态\n    const levelLoaded = ref(forge.isLoaded(level));\n    forge.load(level).then(() => {\n      levelLoaded.value = true;\n    }).catch(() => { /* 加载失败时 levelLoaded 保持 false */\n    });\n    // 订阅 level 加载完成事件（兜底：如果 load() 在 ref 赋值后才完成）\n    const unsub = forge.onLevelLoaded(level, () => {\n      levelLoaded.value = true;\n      unsub();\n    });\n\n    const callable = prefix\n      ? async (name: string, params?: ApiCallParams) =>\n        forge.api(level, await resolveRouteName(forge, level, prefix, name), params)\n      : (name: string, params?: ApiCallParams) =>\n        forge.api(level, name, params);\n    defineImmutableProps(callable, {\n      level,\n      // 未传 prefix 时不定义该属性，与 React 包行为保持一致（'prefix' in forge === false）\n      ...(prefix !== undefined ? { prefix } : {}),\n      api: prefix\n        ? async (name: string, params?: ApiCallParams) =>\n          forge.api(level, await resolveRouteName(forge, level, prefix, name), params)\n        : (name: string, params?: ApiCallParams) => forge.api(level, name, params),\n      route: prefix\n        ? (name: string, params?: Record<string, unknown>) =>\n          forge.route(level, resolveRouteNameSync(forge, level, prefix, name), params)\n        : (name: string, params?: Record<string, unknown>) => forge.route(level, name, params),\n      url: prefix\n        ? (name: string, params?: Record<string, unknown>) =>\n          forge.route(level, resolveRouteNameSync(forge, level, prefix, name), params)\n        : (name: string, params?: Record<string, unknown>) => forge.route(level, name, params),\n      load: forge.load.bind(forge),\n      invalidate: forge.invalidate.bind(forge),\n      isLoaded: forge.isLoaded.bind(forge),\n      hasRoute: forge.hasRoute.bind(forge),\n      isLoading: forge.isLoading.bind(forge),\n      onLoadingChange: forge.onLoadingChange.bind(forge),\n      getRoutes: forge.getRoutes.bind(forge),\n      interceptors: forge.interceptors,\n    });\n    // levelLoaded 需要保持响应式，不能通过 defineImmutableProps（会 Object.freeze）\n    Object.defineProperty(callable, 'levelLoaded', {\n      value: levelLoaded,\n      writable: false,\n      enumerable: true,\n      configurable: false,\n    });\n    return callable as unknown as BoundForgeTyped<string>;\n  }\n\n  const callable = (lvl: string, name: string, params?: ApiCallParams) =>\n    forge.api(lvl, name, params);\n  defineImmutableProps(callable, {\n    api: forge.api.bind(forge),\n    load: forge.load.bind(forge),\n    invalidate: forge.invalidate.bind(forge),\n    isLoaded: forge.isLoaded.bind(forge),\n    isLoading: forge.isLoading.bind(forge),\n    onLoadingChange: forge.onLoadingChange.bind(forge),\n    interceptors: forge.interceptors,\n    ready: forge.ready,\n    onLevelLoaded: forge.onLevelLoaded.bind(forge),\n  });\n  return callable as ForgeInstanceTyped;\n}\n\n\n/**\n * 以不可变、不可枚举、不可重配置的方式将属性挂载到目标对象上。\n * 相比 Object.assign 更安全——外部无法通过遍历/删除/重写篡改这些方法。\n * 对象类型的值会浅冻结（Object.freeze），防止内部键被增删改。\n */\nfunction defineImmutableProps<T extends object>(target: T, props: Record<string, unknown>): T {\n  for (const key of Object.keys(props)) {\n    const val = props[key];\n    Object.defineProperty(target, key, {\n      value: val !== null && typeof val === 'object' ? Object.freeze(val) : val,\n      writable: false,\n      enumerable: false,\n      configurable: false,\n    });\n  }\n  return target;\n}\n","/**\n * useForgeApi：包装 forge.api()，自动管理 loading/error 状态\n * @see .docs/SPEC.md §4.1.7\n *\n * 支持：\n *   - useForgeApi()             — call(level, name, params)\n *   - useForgeApi(level)        — call(name, params)，自动绑定层级\n *   - useForgeApi(level, prefix) — call(suffix, params)，自动绑定层级 + 拼接前缀\n *\n * 类型推断：\n *   当 ForgeRouteMap 通过 codegen 或 module augmentation 定义时，\n *   level / name / params 均自动推断，IDE 提供补全提示。\n */\n\nimport { ref } from 'vue';\nimport { useForge } from '../plugin.js';\nimport type {\n  ApiCallParams,\n  ForgeApiParams,\n  ForgeApiResponse,\n  ForgeRouteName,\n} from '@route-forge/core';\n\n/** call 函数签名 — 未绑定 level，需要显式传入 */\nexport interface UseForgeApiCall {\n  (level: string, name: string, params?: ApiCallParams): Promise<{\n    data: unknown;\n    error: unknown;\n  }>;\n}\n\n/** call 函数签名 — 已绑定 level，无需再传 */\nexport interface UseForgeApiBoundCall<L extends string> {\n  (name: ForgeRouteName<L>, params?: ForgeApiParams<L, ForgeRouteName<L>>): Promise<{\n    data: ForgeApiResponse<L, ForgeRouteName<L>>;\n    error: unknown;\n  }>;\n}\n\nexport interface UseForgeApiReturn {\n  pending: ReturnType<typeof ref<boolean>>;\n  error: ReturnType<typeof ref<unknown>>;\n  call: UseForgeApiCall;\n}\n\nexport interface UseForgeApiBoundReturn<L extends string> {\n  pending: ReturnType<typeof ref<boolean>>;\n  error: ReturnType<typeof ref<unknown>>;\n  call: UseForgeApiBoundCall<L>;\n}\n\n/** 不绑定层级 — call 需要传 level */\nexport function useForgeApi(): UseForgeApiReturn;\n/** 绑定层级 — call 无需传 level */\nexport function useForgeApi<L extends string>(level: L): UseForgeApiBoundReturn<L>;\n/** 绑定层级 + 前缀 — call 无需传 level，路由名自动拼接 prefix */\nexport function useForgeApi<L extends string>(level: L, prefix: string): UseForgeApiBoundReturn<L>;\nexport function useForgeApi(level?: string, prefix?: string): UseForgeApiReturn | UseForgeApiBoundReturn<string> {\n  const forge = level !== undefined ? useForge(level, prefix as string) : useForge();\n  const pending = ref(false);\n  const error = ref<unknown>(null);\n\n  async function call(...args: unknown[]): Promise<{ data: unknown; error: unknown }> {\n    pending.value = true;\n    error.value = null;\n    try {\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      const data = await (forge as any).api(...args);\n      return { data, error: null };\n    } catch (e) {\n      error.value = e;\n      return { data: undefined, error: e };\n    } finally {\n      pending.value = false;\n    }\n  }\n\n  return { pending, error, call: call as any };\n}\n","/**\n * useForgeRoute：响应式 URL 生成器，内部处理 level 加载状态\n * @see .docs/SPEC.md §4.1.7\n *\n * - level 未加载时返回空字符串 ''（不抛错，模板不崩）\n * - level 加载完成后自动重新计算并返回正确 URL\n * - 用户无需关心 levelLoaded 状态，直接用即可\n */\n\nimport { computed, type ComputedRef, inject, onMounted, ref } from 'vue';\nimport { FORGE_INJECTION_KEY } from '../plugin.js';\nimport type { RouteForge } from '@route-forge/core';\n\nexport function useForgeRoute(\n  level: string | (() => string),\n  name: string | (() => string),\n  params?: () => Record<string, unknown>,\n): ComputedRef<string> {\n  const forge = inject(FORGE_INJECTION_KEY) as RouteForge;\n\n  // 响应式追踪 level 加载状态（computed 依赖此 ref 触发重新计算）\n  const levelLoaded = ref(forge.isLoaded(typeof level === 'function' ? level() : level));\n\n  const lvl = typeof level === 'function' ? level() : level;\n  if (!levelLoaded.value) {\n    onMounted(() => {\n      forge.load(lvl).then(() => {\n        levelLoaded.value = true;\n      }).catch(() => { /* 加载失败时 computed 返回 '' */\n      });\n    });\n  }\n\n  return computed(() => {\n    // level 未加载 → 返回空字符串，不抛错\n    if (!levelLoaded.value) return '';\n    const l = typeof level === 'function' ? level() : level;\n    const n = typeof name === 'function' ? name() : name;\n    const p = params ? params() : undefined;\n    return forge.route(l, n, p);\n  });\n}\n","/**\n * useForgeByPrefix：带层级 + 名字前缀的封装，方便后续减少名称传入\n * @see .docs/SPEC.md §4.1.7\n *\n * 智能前缀解析：\n *   - 传入后缀不以前缀开头 → 自动拼接 prefix.suffix\n *   - 传入后缀已以前缀开头（歧义） → 优先尝试完整拼接，\n *     若不存在则视为已含前缀直接使用，均不存在则报错\n *\n * 示例（prefix = 'test'）：\n *   api('1')        → test.1\n *   api('test1.1')  → test.test1.1\n *   api('test.1')   → 歧义：优先 test.test.1，回退 test.1\n */\n\nimport { inject } from 'vue';\nimport { FORGE_INJECTION_KEY } from '../plugin.js';\nimport { resolveRouteName, resolveRouteNameSync } from '../utils/resolveRouteName.js';\nimport type { ApiCallParams, RouteForge } from '@route-forge/core';\n\nexport interface UseForgeByPrefixReturn {\n  api: (suffix: string, params?: ApiCallParams) => Promise<unknown>;\n  route: (suffix: string, params?: Record<string, unknown>) => string;\n}\n\nexport function useForgeByPrefix(level: string, prefix: string, separator = '.'): UseForgeByPrefixReturn {\n  const forge = inject(FORGE_INJECTION_KEY) as RouteForge;\n\n  return {\n    api: (suffix, params) =>\n      resolveRouteName(forge, level, prefix, suffix, separator).then(\n        (name) => forge.api(level, name, params),\n      ),\n    route: (suffix, params) => {\n      // level 未加载时返回空字符串，避免 resolveRouteNameSync 内部 hasRoute() 抛错\n      if (!forge.isLoaded(level)) return '';\n      return forge.route(level, resolveRouteNameSync(forge, level, prefix, suffix, separator), params);\n    },\n  };\n}\n"]}
+{"version":3,"sources":["../src/plugin.ts","../src/composables/useForgeApi.ts","../src/composables/useForgeRoute.ts","../src/composables/useForgeByPrefix.ts"],"names":["callable","ref","inject","resolveRouteName","resolveRouteNameSync"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Vue 3 插件入口\n * @see .docs/SPEC.md §4.1.7\n *\n * 提供：\n *   - 全局属性 $forge（route() 工具）\n *   - inject symbol 注入 RouteForge 实例供 composable 使用\n *   - useForge() / useForge(level) / useForge(level, prefix) 返回统一方法的 forge 实例\n *     • 不传 level：forge(level, name, params?) 直接调用\n *     • 传 level：forge(name, params?) 直接调用，自动绑定层级\n *     • 传 level + prefix：forge(suffix, params?) 自动拼接 prefix\n *\n * 类型推断：\n *   当 ForgeRouteMap 通过 codegen 或 module augmentation 定义时，\n *   level / name / params 均自动推断，IDE 提供补全提示。\n */\n\nimport type { App, InjectionKey, Plugin, Ref } from 'vue';\nimport { inject, ref } from 'vue';\nimport {\n  type ApiCallParams,\n  createRouteForge,\n  type ForgeInstanceTyped,\n  type RouteForge,\n  type RouteForgeOptions,\n  resolveRouteName,\n  resolveRouteNameSync,\n} from '@route-forge/core';\nimport { defineImmutableProps } from '@route-forge/core/internal';\n\nexport const FORGE_INJECTION_KEY: InjectionKey<RouteForge> = Symbol('route-forge');\n\nexport interface RouteForgePluginOptions extends RouteForgeOptions {}\n\n/** 已绑定 level — 直接调用无需 level，api/route/url 的 name 自动限定到该层级 */\nexport type BoundForgeTyped<L extends string> = import('@route-forge/core').BoundForgeTyped<L, Ref<boolean>>;\n\n/** 未绑定 level — 直接调用需要传 level（不提供 route/url/hasRoute/getRoutes 等同步方法） */\nexport type { ForgeInstanceTyped } from '@route-forge/core';\n\nexport function createRouteForgePlugin(options: RouteForgePluginOptions): Plugin<[]> & {\n  ready: Promise<void>\n} {\n  const forge = createRouteForge(options);\n\n  return {\n    ready: forge.ready,\n    install(app: App) {\n      app.provide(FORGE_INJECTION_KEY, forge);\n      app.config.globalProperties.$forge = {\n        route: (level: string, name: string, params?: Record<string, unknown>) =>\n          forge.route(level, name, params),\n      };\n    },\n  };\n}\n\n/**\n * 获取 forge 实例。\n *\n * @example\n * // 不绑定层级\n * const forge = useForge()\n * forge('admin', 'users.show', { user: 1 })\n * forge.api('admin', 'users.show')\n *\n * @example\n * // 绑定层级 — 直接调用和 api/route/url 均无需传 level\n * const forge = useForge('admin')\n * forge.level                    // → 'admin'\n * forge('users.show', { user: 1 })\n * forge.api('users.show')\n *\n * @example\n * // 绑定层级 + 前缀 — 路由名自动拼接\n * const forge = useForge('admin', 'users')\n * forge.level                    // → 'admin'\n * forge.prefix                   // → 'users'\n * forge('show', { user: 1 })           // → forge.api('admin', 'users.show', ...)\n * forge.api('index')                   // → forge.api('admin', 'users.index')\n * forge.route('show', { user: 1 })     // → forge.route('admin', 'users.show', ...)\n */\nexport function useForge<L extends string>(level: L, prefix: string): BoundForgeTyped<L>;\nexport function useForge<L extends string>(level: L): BoundForgeTyped<L>;\nexport function useForge(): ForgeInstanceTyped;\nexport function useForge(level?: string, prefix?: string): ForgeInstanceTyped | BoundForgeTyped<string> {\n  const forge = inject(FORGE_INJECTION_KEY);\n  if (!forge) {\n    throw new Error(\n      '[route-forge/vue] useForge() must be used inside an app with createRouteForgePlugin() installed',\n    );\n  }\n\n  if (level !== undefined) {\n    // 自动触发 level 加载 + 响应式 levelLoaded 状态\n    const levelLoaded = ref(forge.isLoaded(level));\n    forge.load(level).then(() => {\n      levelLoaded.value = true;\n    }).catch(() => { /* 加载失败时 levelLoaded 保持 false */\n    });\n    // 订阅 level 加载完成事件（兜底：如果 load() 在 ref 赋值后才完成）\n    const unsub = forge.onLevelLoaded(level, () => {\n      levelLoaded.value = true;\n      unsub();\n    });\n\n    const callable = prefix\n      ? async (name: string, params?: ApiCallParams) =>\n        forge.api(level, await resolveRouteName(forge, level, prefix, name), params)\n      : (name: string, params?: ApiCallParams) =>\n        forge.api(level, name, params);\n    defineImmutableProps(callable, {\n      level,\n      // 未传 prefix 时不定义该属性，与 React 包行为保持一致（'prefix' in forge === false）\n      ...(prefix !== undefined ? { prefix } : {}),\n      api: prefix\n        ? async (name: string, params?: ApiCallParams) =>\n          forge.api(level, await resolveRouteName(forge, level, prefix, name), params)\n        : (name: string, params?: ApiCallParams) => forge.api(level, name, params),\n      route: prefix\n        ? (name: string, params?: Record<string, unknown>) =>\n          forge.route(level, resolveRouteNameSync(forge, level, prefix, name), params)\n        : (name: string, params?: Record<string, unknown>) => forge.route(level, name, params),\n      url: prefix\n        ? (name: string, params?: Record<string, unknown>) =>\n          forge.route(level, resolveRouteNameSync(forge, level, prefix, name), params)\n        : (name: string, params?: Record<string, unknown>) => forge.route(level, name, params),\n      load: forge.load.bind(forge),\n      invalidate: forge.invalidate.bind(forge),\n      isLoaded: forge.isLoaded.bind(forge),\n      hasRoute: forge.hasRoute.bind(forge),\n      isLoading: forge.isLoading.bind(forge),\n      onLoadingChange: forge.onLoadingChange.bind(forge),\n      getRoutes: forge.getRoutes.bind(forge),\n    });\n    // levelLoaded 需要保持响应式，不能通过 defineImmutableProps（会 Object.freeze）\n    Object.defineProperty(callable, 'levelLoaded', {\n      value: levelLoaded,\n      writable: false,\n      enumerable: true,\n      configurable: false,\n    });\n    return callable as unknown as BoundForgeTyped<string>;\n  }\n\n  const callable = (lvl: string, name: string, params?: ApiCallParams) =>\n    forge.api(lvl, name, params);\n  defineImmutableProps(callable, {\n    api: forge.api.bind(forge),\n    load: forge.load.bind(forge),\n    invalidate: forge.invalidate.bind(forge),\n    isLoaded: forge.isLoaded.bind(forge),\n    isLoading: forge.isLoading.bind(forge),\n    onLoadingChange: forge.onLoadingChange.bind(forge),\n    ready: forge.ready,\n    onLevelLoaded: forge.onLevelLoaded.bind(forge),\n  });\n  return callable as unknown as ForgeInstanceTyped;\n}\n\n\n","/**\n * useForgeApi：包装 forge.api()，自动管理 loading/error 状态\n * @see .docs/SPEC.md §4.1.7\n *\n * 支持：\n *   - useForgeApi()             — call(level, name, params)\n *   - useForgeApi(level)        — call(name, params)，自动绑定层级\n *   - useForgeApi(level, prefix) — call(suffix, params)，自动绑定层级 + 拼接前缀\n *\n * 类型推断：\n *   当 ForgeRouteMap 通过 codegen 或 module augmentation 定义时，\n *   level / name / params 均自动推断，IDE 提供补全提示。\n */\n\nimport { ref } from 'vue';\nimport { useForge } from '../plugin.js';\nimport type { Ref } from 'vue';\nimport type {\n  UseForgeApiCall,\n  UseForgeApiBoundCall,\n  UseForgeApiReturn,\n  UseForgeApiBoundReturn,\n} from '@route-forge/core';\n\n// Vue 特化类型：pending/error 为 Ref\nexport type { UseForgeApiCall, UseForgeApiBoundCall };\nexport type UseForgeApiReturnVue = UseForgeApiReturn<Ref<boolean>, Ref<unknown>>;\nexport type UseForgeApiBoundReturnVue<L extends string> = UseForgeApiBoundReturn<L, Ref<boolean>, Ref<unknown>>;\n\n/** 不绑定层级 — call 需要传 level */\nexport function useForgeApi(): UseForgeApiReturnVue;\n/** 绑定层级 — call 无需传 level */\nexport function useForgeApi<L extends string>(level: L): UseForgeApiBoundReturnVue<L>;\n/** 绑定层级 + 前缀 — call 无需传 level，路由名自动拼接 prefix */\nexport function useForgeApi<L extends string>(level: L, prefix: string): UseForgeApiBoundReturnVue<L>;\nexport function useForgeApi(level?: string, prefix?: string): UseForgeApiReturnVue | UseForgeApiBoundReturnVue<string> {\n  const forge = level !== undefined ? useForge(level, prefix as string) : useForge();\n  const pending = ref(false);\n  const error = ref<unknown>(null);\n\n  async function call(...args: unknown[]): Promise<{ data: unknown; error: unknown }> {\n    pending.value = true;\n    error.value = null;\n    try {\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      const data = await (forge as any).api(...args);\n      return { data, error: null };\n    } catch (e) {\n      error.value = e;\n      return { data: undefined, error: e };\n    } finally {\n      pending.value = false;\n    }\n  }\n\n  return { pending, error, call: call as any };\n}\n","/**\n * useForgeRoute：响应式 URL 生成器，内部处理 level 加载状态\n * @see .docs/SPEC.md §4.1.7\n *\n * - level 未加载时返回空字符串 ''（不抛错，模板不崩）\n * - level 加载完成后自动重新计算并返回正确 URL\n * - 用户无需关心 levelLoaded 状态，直接用即可\n */\n\nimport { computed, type ComputedRef, inject, onMounted, ref } from 'vue';\nimport { FORGE_INJECTION_KEY } from '../plugin.js';\nimport type { RouteForge } from '@route-forge/core';\n\nexport function useForgeRoute(\n  level: string | (() => string),\n  name: string | (() => string),\n  params?: () => Record<string, unknown>,\n): ComputedRef<string> {\n  const forge = inject(FORGE_INJECTION_KEY) as RouteForge;\n\n  // 响应式追踪 level 加载状态（computed 依赖此 ref 触发重新计算）\n  const levelLoaded = ref(forge.isLoaded(typeof level === 'function' ? level() : level));\n\n  const lvl = typeof level === 'function' ? level() : level;\n  if (!levelLoaded.value) {\n    onMounted(() => {\n      forge.load(lvl).then(() => {\n        levelLoaded.value = true;\n      }).catch(() => { /* 加载失败时 computed 返回 '' */\n      });\n    });\n  }\n\n  return computed(() => {\n    // level 未加载 → 返回空字符串，不抛错\n    if (!levelLoaded.value) return '';\n    const l = typeof level === 'function' ? level() : level;\n    const n = typeof name === 'function' ? name() : name;\n    const p = params ? params() : undefined;\n    return forge.route(l, n, p);\n  });\n}\n","/**\n * useForgeByPrefix：带层级 + 名字前缀的封装，方便后续减少名称传入\n * @see .docs/SPEC.md §4.1.7\n *\n * 智能前缀解析：\n *   - 传入后缀不以前缀开头 → 自动拼接 prefix.suffix\n *   - 传入后缀已以前缀开头（歧义） → 优先尝试完整拼接，\n *     若不存在则视为已含前缀直接使用，均不存在则报错\n *\n * 示例（prefix = 'test'）：\n *   api('1')        → test.1\n *   api('test1.1')  → test.test1.1\n *   api('test.1')   → 歧义：优先 test.test.1，回退 test.1\n */\n\nimport { inject } from 'vue';\nimport { FORGE_INJECTION_KEY } from '../plugin.js';\nimport {\n  resolveRouteName,\n  resolveRouteNameSync,\n  type ApiCallParams,\n  type RouteForge,\n  type UseForgeByPrefixReturn,\n} from '@route-forge/core';\n\nexport type { UseForgeByPrefixReturn };\n\nexport function useForgeByPrefix(level: string, prefix: string, separator = '.'): UseForgeByPrefixReturn {\n  const forge = inject(FORGE_INJECTION_KEY) as RouteForge;\n\n  return {\n    api: (suffix, params) =>\n      resolveRouteName(forge, level, prefix, suffix, separator).then(\n        (name) => forge.api(level, name, params),\n      ),\n    route: (suffix, params) => {\n      // level 未加载时返回空字符串，避免 resolveRouteNameSync 内部 hasRoute() 抛错\n      if (!forge.isLoaded(level)) return '';\n      return forge.route(level, resolveRouteNameSync(forge, level, prefix, suffix, separator), params);\n    },\n  };\n}\n"]}

package/package.json

@@ -1,17 +1,17 @@
 {
   "name": "@route-forge/vue",
-  "version": "1.1.1",
+  "version": "1.2.0",
   "description": "Route Forge 的 Vue 3 集成：插件 + composable（useForge/useForgeApi/useForgeLevel/useForgeRoute/useForgeByPrefix）",
   "license": "MIT",
   "author": "阿杰很厉害 <506907958@qq.com>",
-  "homepage": "https://github.com/xyj2156/route-forge",
+  "homepage": "https://github.com/route-forge/route-forge",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/xyj2156/route-forge.git",
+    "url": "git+https://github.com/route-forge/route-forge.git",
     "directory": "packages/vue"
   },
   "bugs": {
-    "url": "https://github.com/xyj2156/route-forge/issues"
+    "url": "https://github.com/route-forge/route-forge/issues"
   },
   "type": "module",
   "sideEffects": false,
@@ -40,7 +40,7 @@
     "vue": "^3.4.0"
   },
   "dependencies": {
-    "@route-forge/core": "1.1.1"
+    "@route-forge/core": "1.2.0"
   },
   "publishConfig": {
     "access": "public"