@route-forge/vue 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 阿杰很厉害
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,42 @@
+# @route-forge/vue
+
+Route Forge 的 Vue 3 集成:插件 + composable(`useForgeApi` / `useForgeLevel` / `useForgeRoute` / `useForgeByPrefix`)。
+
+## 安装
+
+```bash
+pnpm add @route-forge/vue @route-forge/core
+```
+
+## 基本用法
+
+```ts
+// main.ts
+import { createApp } from 'vue'
+import { ForgePlugin } from '@route-forge/vue'
+import App from './App.vue'
+
+const app = createApp(App)
+app.use(ForgePlugin, {
+  endpoint: '/_forge/routes',
+})
+app.mount('#app')
+```
+
+```vue
+<script setup lang="ts">
+import { useForgeRoute } from '@route-forge/vue'
+
+const { data: route } = useForgeRoute('login.show')
+</script>
+```
+
+## 文档
+
+- 仓库主页: 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
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,88 @@
+'use strict';
+
+var vue = require('vue');
+var core = require('@route-forge/core');
+
+// src/plugin.ts
+var FORGE_INJECTION_KEY = /* @__PURE__ */ Symbol("route-forge");
+function createRouteForgePlugin(options) {
+  const forge = core.createRouteForge(options);
+  return {
+    install(app) {
+      app.provide(FORGE_INJECTION_KEY, forge);
+      app.config.globalProperties.$forge = {
+        route: (name, params) => forge.route(name, params)
+      };
+    }
+  };
+}
+function useForge() {
+  const forge = vue.inject(FORGE_INJECTION_KEY);
+  if (!forge) {
+    throw new Error(
+      "[route-forge/vue] useForge() must be used inside an app with createRouteForgePlugin() installed"
+    );
+  }
+  return forge;
+}
+function useForgeApi() {
+  const forge = useForge();
+  const pending = vue.ref(false);
+  const error = vue.ref(null);
+  async function call(name, params) {
+    pending.value = true;
+    error.value = null;
+    try {
+      const data = await forge.api(name, params);
+      return { data, error: null };
+    } catch (e) {
+      error.value = e;
+      return { data: void 0, error: e };
+    } finally {
+      pending.value = false;
+    }
+  }
+  return { pending, error, call };
+}
+function useForgeLevel(level) {
+  const forge = useForge();
+  const loaded = vue.ref(false);
+  const error = vue.ref(null);
+  vue.onMounted(async () => {
+    try {
+      await forge.load(level);
+      loaded.value = true;
+    } catch (e) {
+      error.value = e;
+    }
+  });
+  return { loaded, error };
+}
+function useForgeRoute(name, params) {
+  const forge = useForge();
+  return vue.computed(() => {
+    const n = typeof name === "function" ? name() : name;
+    const p = params ? params() : void 0;
+    return forge.route(n, p);
+  });
+}
+
+// src/composables/useForgeByPrefix.ts
+function useForgeByPrefix(prefix, separator = ".") {
+  const forge = useForge();
+  const join = (suffix) => suffix ? `${prefix}${separator}${suffix}` : prefix;
+  return {
+    api: (suffix, params) => forge.api(join(suffix), params),
+    route: (suffix, params) => forge.route(join(suffix), params)
+  };
+}
+
+exports.FORGE_INJECTION_KEY = FORGE_INJECTION_KEY;
+exports.createRouteForgePlugin = createRouteForgePlugin;
+exports.useForge = useForge;
+exports.useForgeApi = useForgeApi;
+exports.useForgeByPrefix = useForgeByPrefix;
+exports.useForgeLevel = useForgeLevel;
+exports.useForgeRoute = useForgeRoute;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/plugin.ts","../src/composables/useForgeApi.ts","../src/composables/useForgeLevel.ts","../src/composables/useForgeRoute.ts","../src/composables/useForgeByPrefix.ts"],"names":["createRouteForge","inject","ref","onMounted","computed"],"mappings":";;;;;;AAiBO,IAAM,mBAAA,0BAAuD,aAAa;AAI1E,SAAS,uBAAuB,OAAA,EAAkC;AACvE,EAAA,MAAM,KAAA,GAAQA,sBAAiB,OAAO,CAAA;AAEtC,EAAA,OAAO;AAAA,IACL,QAAQ,GAAA,EAAU;AAChB,MAAA,GAAA,CAAI,OAAA,CAAQ,qBAAqB,KAAK,CAAA;AACtC,MAAA,GAAA,CAAI,MAAA,CAAO,iBAAiB,MAAA,GAAS;AAAA,QACnC,OAAO,CAAC,IAAA,EAAc,WACpB,KAAA,CAAM,KAAA,CAAM,MAAM,MAAM;AAAA,OAC5B;AAAA,IACF;AAAA,GACF;AACF;AAEO,SAAS,QAAA,GAAuB;AACrC,EAAA,MAAM,KAAA,GAAQC,WAAO,mBAAmB,CAAA;AACxC,EAAA,IAAI,CAAC,KAAA,EAAO;AACV,IAAA,MAAM,IAAI,KAAA;AAAA,MACR;AAAA,KACF;AAAA,EACF;AACA,EAAA,OAAO,KAAA;AACT;ACzBO,SAAS,WAAA,GAAiC;AAC/C,EAAA,MAAM,QAAQ,QAAA,EAAS;AACvB,EAAA,MAAM,OAAA,GAAUC,QAAI,KAAK,CAAA;AACzB,EAAA,MAAM,KAAA,GAAQA,QAAa,IAAI,CAAA;AAE/B,EAAA,eAAe,IAAA,CAAK,MAAc,MAAA,EAAwB;AACxD,IAAA,OAAA,CAAQ,KAAA,GAAQ,IAAA;AAChB,IAAA,KAAA,CAAM,KAAA,GAAQ,IAAA;AACd,IAAA,IAAI;AACF,MAAA,MAAM,IAAA,GAAO,MAAM,KAAA,CAAM,GAAA,CAAI,MAAM,MAAM,CAAA;AACzC,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,EAAK;AAChC;ACzBO,SAAS,cAAc,KAAA,EAAoC;AAChE,EAAA,MAAM,QAAQ,QAAA,EAAS;AACvB,EAAA,MAAM,MAAA,GAASA,QAAI,KAAK,CAAA;AACxB,EAAA,MAAM,KAAA,GAAQA,QAAa,IAAI,CAAA;AAE/B,EAAAC,aAAA,CAAU,YAAY;AACpB,IAAA,IAAI;AACF,MAAA,MAAM,KAAA,CAAM,KAAK,KAAK,CAAA;AACtB,MAAA,MAAA,CAAO,KAAA,GAAQ,IAAA;AAAA,IACjB,SAAS,CAAA,EAAG;AACV,MAAA,KAAA,CAAM,KAAA,GAAQ,CAAA;AAAA,IAChB;AAAA,EACF,CAAC,CAAA;AAED,EAAA,OAAO,EAAE,QAAQ,KAAA,EAAM;AACzB;ACpBO,SAAS,aAAA,CACd,MACA,MAAA,EACqB;AACrB,EAAA,MAAM,QAAQ,QAAA,EAAS;AACvB,EAAA,OAAOC,aAAS,MAAM;AACpB,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,CAAC,CAAA;AAAA,EACzB,CAAC,CAAA;AACH;;;ACDO,SAAS,gBAAA,CAAiB,MAAA,EAAgB,SAAA,GAAY,GAAA,EAA6B;AACxF,EAAA,MAAM,QAAQ,QAAA,EAAS;AAEvB,EAAA,MAAM,IAAA,GAAO,CAAC,MAAA,KAAoB,MAAA,GAAS,CAAA,EAAG,MAAM,CAAA,EAAG,SAAS,CAAA,EAAG,MAAM,CAAA,CAAA,GAAK,MAAA;AAE9E,EAAA,OAAO;AAAA,IACL,GAAA,EAAK,CAAC,MAAA,EAAQ,MAAA,KAAW,MAAM,GAAA,CAAI,IAAA,CAAK,MAAM,CAAA,EAAG,MAAM,CAAA;AAAA,IACvD,KAAA,EAAO,CAAC,MAAA,EAAQ,MAAA,KAAW,MAAM,KAAA,CAAM,IAAA,CAAK,MAAM,CAAA,EAAG,MAAM;AAAA,GAC7D;AACF","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 */\n\nimport type { App, InjectionKey } from 'vue';\nimport { inject, reactive, readonly } from 'vue';\nimport {\n  createRouteForge,\n  type RouteForge,\n  type RouteForgeOptions,\n} from '@route-forge/core';\n\nexport const FORGE_INJECTION_KEY: InjectionKey<RouteForge> = Symbol('route-forge');\n\nexport interface RouteForgePluginOptions extends RouteForgeOptions {}\n\nexport function createRouteForgePlugin(options: RouteForgePluginOptions) {\n  const forge = createRouteForge(options);\n\n  return {\n    install(app: App) {\n      app.provide(FORGE_INJECTION_KEY, forge);\n      app.config.globalProperties.$forge = {\n        route: (name: string, params?: Record<string, unknown>) =>\n          forge.route(name, params),\n      };\n    },\n  };\n}\n\nexport function useForge(): RouteForge {\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  return forge;\n}\n\nexport { readonly, reactive };\n","/**\n * useForgeApi：包装 forge.api()，自动管理 loading/error 状态\n * @see .docs/SPEC.md §4.1.7\n */\n\nimport { ref } from 'vue';\nimport { useForge } from '../plugin.js';\nimport type { ApiCallParams } from '@route-forge/core';\n\nexport interface UseForgeApiReturn {\n  pending: ReturnType<typeof ref<boolean>>;\n  error: ReturnType<typeof ref<unknown>>;\n  call: (name: string, params?: ApiCallParams) => Promise<{\n    data: unknown;\n    error: unknown;\n  }>;\n}\n\nexport function useForgeApi(): UseForgeApiReturn {\n  const forge = useForge();\n  const pending = ref(false);\n  const error = ref<unknown>(null);\n\n  async function call(name: string, params?: ApiCallParams) {\n    pending.value = true;\n    error.value = null;\n    try {\n      const data = await forge.api(name, params);\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 };\n}\n","/**\n * useForgeLevel：声明组件依赖某层级，挂载时自动 forge.load(level)，销毁时不主动失效\n * @see .docs/SPEC.md §4.1.7\n */\n\nimport { onMounted, ref } from 'vue';\nimport { useForge } from '../plugin.js';\n\nexport interface UseForgeLevelReturn {\n  loaded: ReturnType<typeof ref<boolean>>;\n  error: ReturnType<typeof ref<unknown>>;\n}\n\nexport function useForgeLevel(level: string): UseForgeLevelReturn {\n  const forge = useForge();\n  const loaded = ref(false);\n  const error = ref<unknown>(null);\n\n  onMounted(async () => {\n    try {\n      await forge.load(level);\n      loaded.value = true;\n    } catch (e) {\n      error.value = e;\n    }\n  });\n\n  return { loaded, error };\n}\n","/**\n * useForgeRoute：仅生成 URL，不发请求（用于 <a href>、外部跳转等）\n * @see .docs/SPEC.md §4.1.7\n */\n\nimport { computed, type ComputedRef } from 'vue';\nimport { useForge } from '../plugin.js';\n\nexport function useForgeRoute(\n  name: string | (() => string),\n  params?: () => Record<string, unknown>,\n): ComputedRef<string> {\n  const forge = useForge();\n  return computed(() => {\n    const n = typeof name === 'function' ? name() : name;\n    const p = params ? params() : undefined;\n    return forge.route(n, p);\n  });\n}\n","/**\n * useForgeByPrefix：带名字前缀的封装，方便后续减少名称传入\n * @see .docs/SPEC.md §4.1.7\n *\n * 示例：\n *   const { api } = useForgeByPrefix('admin.users');\n *   await api('show', { user: 1 });   // 等价于 forge.api('admin.users.show', { user: 1 })\n */\n\nimport { useForge } from '../plugin.js';\nimport type { ApiCallParams } 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(prefix: string, separator = '.'): UseForgeByPrefixReturn {\n  const forge = useForge();\n\n  const join = (suffix: string) => (suffix ? `${prefix}${separator}${suffix}` : prefix);\n\n  return {\n    api: (suffix, params) => forge.api(join(suffix), params),\n    route: (suffix, params) => forge.route(join(suffix), params),\n  };\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,69 @@
+import { InjectionKey, App, ref, ComputedRef } from 'vue';
+import { RouteForge, RouteForgeOptions, ApiCallParams } from '@route-forge/core';
+
+/**
+ * Vue 3 插件入口
+ * @see .docs/SPEC.md §4.1.7
+ *
+ * 提供：
+ *   - 全局属性 $forge（route() 工具）
+ *   - inject symbol 注入 RouteForge 实例供 composable 使用
+ */
+
+declare const FORGE_INJECTION_KEY: InjectionKey<RouteForge>;
+interface RouteForgePluginOptions extends RouteForgeOptions {
+}
+declare function createRouteForgePlugin(options: RouteForgePluginOptions): {
+    install(app: App): void;
+};
+declare function useForge(): RouteForge;
+
+/**
+ * useForgeApi：包装 forge.api()，自动管理 loading/error 状态
+ * @see .docs/SPEC.md §4.1.7
+ */
+
+interface UseForgeApiReturn {
+    pending: ReturnType<typeof ref<boolean>>;
+    error: ReturnType<typeof ref<unknown>>;
+    call: (name: string, params?: ApiCallParams) => Promise<{
+        data: unknown;
+        error: unknown;
+    }>;
+}
+declare function useForgeApi(): UseForgeApiReturn;
+
+/**
+ * useForgeLevel：声明组件依赖某层级，挂载时自动 forge.load(level)，销毁时不主动失效
+ * @see .docs/SPEC.md §4.1.7
+ */
+
+interface UseForgeLevelReturn {
+    loaded: ReturnType<typeof ref<boolean>>;
+    error: ReturnType<typeof ref<unknown>>;
+}
+declare function useForgeLevel(level: string): UseForgeLevelReturn;
+
+/**
+ * useForgeRoute：仅生成 URL，不发请求（用于 <a href>、外部跳转等）
+ * @see .docs/SPEC.md §4.1.7
+ */
+
+declare function useForgeRoute(name: string | (() => string), params?: () => Record<string, unknown>): ComputedRef<string>;
+
+/**
+ * useForgeByPrefix：带名字前缀的封装，方便后续减少名称传入
+ * @see .docs/SPEC.md §4.1.7
+ *
+ * 示例：
+ *   const { api } = useForgeByPrefix('admin.users');
+ *   await api('show', { user: 1 });   // 等价于 forge.api('admin.users.show', { user: 1 })
+ */
+
+interface UseForgeByPrefixReturn {
+    api: (suffix: string, params?: ApiCallParams) => Promise<unknown>;
+    route: (suffix: string, params?: Record<string, unknown>) => string;
+}
+declare function useForgeByPrefix(prefix: string, separator?: string): UseForgeByPrefixReturn;
+
+export { FORGE_INJECTION_KEY, type RouteForgePluginOptions, type UseForgeApiReturn, type UseForgeByPrefixReturn, type UseForgeLevelReturn, createRouteForgePlugin, useForge, useForgeApi, useForgeByPrefix, useForgeLevel, useForgeRoute };

package/dist/index.d.ts

@@ -0,0 +1,69 @@
+import { InjectionKey, App, ref, ComputedRef } from 'vue';
+import { RouteForge, RouteForgeOptions, ApiCallParams } from '@route-forge/core';
+
+/**
+ * Vue 3 插件入口
+ * @see .docs/SPEC.md §4.1.7
+ *
+ * 提供：
+ *   - 全局属性 $forge（route() 工具）
+ *   - inject symbol 注入 RouteForge 实例供 composable 使用
+ */
+
+declare const FORGE_INJECTION_KEY: InjectionKey<RouteForge>;
+interface RouteForgePluginOptions extends RouteForgeOptions {
+}
+declare function createRouteForgePlugin(options: RouteForgePluginOptions): {
+    install(app: App): void;
+};
+declare function useForge(): RouteForge;
+
+/**
+ * useForgeApi：包装 forge.api()，自动管理 loading/error 状态
+ * @see .docs/SPEC.md §4.1.7
+ */
+
+interface UseForgeApiReturn {
+    pending: ReturnType<typeof ref<boolean>>;
+    error: ReturnType<typeof ref<unknown>>;
+    call: (name: string, params?: ApiCallParams) => Promise<{
+        data: unknown;
+        error: unknown;
+    }>;
+}
+declare function useForgeApi(): UseForgeApiReturn;
+
+/**
+ * useForgeLevel：声明组件依赖某层级，挂载时自动 forge.load(level)，销毁时不主动失效
+ * @see .docs/SPEC.md §4.1.7
+ */
+
+interface UseForgeLevelReturn {
+    loaded: ReturnType<typeof ref<boolean>>;
+    error: ReturnType<typeof ref<unknown>>;
+}
+declare function useForgeLevel(level: string): UseForgeLevelReturn;
+
+/**
+ * useForgeRoute：仅生成 URL，不发请求（用于 <a href>、外部跳转等）
+ * @see .docs/SPEC.md §4.1.7
+ */
+
+declare function useForgeRoute(name: string | (() => string), params?: () => Record<string, unknown>): ComputedRef<string>;
+
+/**
+ * useForgeByPrefix：带名字前缀的封装，方便后续减少名称传入
+ * @see .docs/SPEC.md §4.1.7
+ *
+ * 示例：
+ *   const { api } = useForgeByPrefix('admin.users');
+ *   await api('show', { user: 1 });   // 等价于 forge.api('admin.users.show', { user: 1 })
+ */
+
+interface UseForgeByPrefixReturn {
+    api: (suffix: string, params?: ApiCallParams) => Promise<unknown>;
+    route: (suffix: string, params?: Record<string, unknown>) => string;
+}
+declare function useForgeByPrefix(prefix: string, separator?: string): UseForgeByPrefixReturn;
+
+export { FORGE_INJECTION_KEY, type RouteForgePluginOptions, type UseForgeApiReturn, type UseForgeByPrefixReturn, type UseForgeLevelReturn, createRouteForgePlugin, useForge, useForgeApi, useForgeByPrefix, useForgeLevel, useForgeRoute };

package/dist/index.js

@@ -0,0 +1,80 @@
+import { inject, ref, onMounted, computed } from 'vue';
+import { createRouteForge } from '@route-forge/core';
+
+// src/plugin.ts
+var FORGE_INJECTION_KEY = /* @__PURE__ */ Symbol("route-forge");
+function createRouteForgePlugin(options) {
+  const forge = createRouteForge(options);
+  return {
+    install(app) {
+      app.provide(FORGE_INJECTION_KEY, forge);
+      app.config.globalProperties.$forge = {
+        route: (name, params) => forge.route(name, params)
+      };
+    }
+  };
+}
+function useForge() {
+  const forge = inject(FORGE_INJECTION_KEY);
+  if (!forge) {
+    throw new Error(
+      "[route-forge/vue] useForge() must be used inside an app with createRouteForgePlugin() installed"
+    );
+  }
+  return forge;
+}
+function useForgeApi() {
+  const forge = useForge();
+  const pending = ref(false);
+  const error = ref(null);
+  async function call(name, params) {
+    pending.value = true;
+    error.value = null;
+    try {
+      const data = await forge.api(name, params);
+      return { data, error: null };
+    } catch (e) {
+      error.value = e;
+      return { data: void 0, error: e };
+    } finally {
+      pending.value = false;
+    }
+  }
+  return { pending, error, call };
+}
+function useForgeLevel(level) {
+  const forge = useForge();
+  const loaded = ref(false);
+  const error = ref(null);
+  onMounted(async () => {
+    try {
+      await forge.load(level);
+      loaded.value = true;
+    } catch (e) {
+      error.value = e;
+    }
+  });
+  return { loaded, error };
+}
+function useForgeRoute(name, params) {
+  const forge = useForge();
+  return computed(() => {
+    const n = typeof name === "function" ? name() : name;
+    const p = params ? params() : void 0;
+    return forge.route(n, p);
+  });
+}
+
+// src/composables/useForgeByPrefix.ts
+function useForgeByPrefix(prefix, separator = ".") {
+  const forge = useForge();
+  const join = (suffix) => suffix ? `${prefix}${separator}${suffix}` : prefix;
+  return {
+    api: (suffix, params) => forge.api(join(suffix), params),
+    route: (suffix, params) => forge.route(join(suffix), params)
+  };
+}
+
+export { FORGE_INJECTION_KEY, createRouteForgePlugin, useForge, useForgeApi, useForgeByPrefix, useForgeLevel, useForgeRoute };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/plugin.ts","../src/composables/useForgeApi.ts","../src/composables/useForgeLevel.ts","../src/composables/useForgeRoute.ts","../src/composables/useForgeByPrefix.ts"],"names":["ref"],"mappings":";;;;AAiBO,IAAM,mBAAA,0BAAuD,aAAa;AAI1E,SAAS,uBAAuB,OAAA,EAAkC;AACvE,EAAA,MAAM,KAAA,GAAQ,iBAAiB,OAAO,CAAA;AAEtC,EAAA,OAAO;AAAA,IACL,QAAQ,GAAA,EAAU;AAChB,MAAA,GAAA,CAAI,OAAA,CAAQ,qBAAqB,KAAK,CAAA;AACtC,MAAA,GAAA,CAAI,MAAA,CAAO,iBAAiB,MAAA,GAAS;AAAA,QACnC,OAAO,CAAC,IAAA,EAAc,WACpB,KAAA,CAAM,KAAA,CAAM,MAAM,MAAM;AAAA,OAC5B;AAAA,IACF;AAAA,GACF;AACF;AAEO,SAAS,QAAA,GAAuB;AACrC,EAAA,MAAM,KAAA,GAAQ,OAAO,mBAAmB,CAAA;AACxC,EAAA,IAAI,CAAC,KAAA,EAAO;AACV,IAAA,MAAM,IAAI,KAAA;AAAA,MACR;AAAA,KACF;AAAA,EACF;AACA,EAAA,OAAO,KAAA;AACT;ACzBO,SAAS,WAAA,GAAiC;AAC/C,EAAA,MAAM,QAAQ,QAAA,EAAS;AACvB,EAAA,MAAM,OAAA,GAAU,IAAI,KAAK,CAAA;AACzB,EAAA,MAAM,KAAA,GAAQ,IAAa,IAAI,CAAA;AAE/B,EAAA,eAAe,IAAA,CAAK,MAAc,MAAA,EAAwB;AACxD,IAAA,OAAA,CAAQ,KAAA,GAAQ,IAAA;AAChB,IAAA,KAAA,CAAM,KAAA,GAAQ,IAAA;AACd,IAAA,IAAI;AACF,MAAA,MAAM,IAAA,GAAO,MAAM,KAAA,CAAM,GAAA,CAAI,MAAM,MAAM,CAAA;AACzC,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,EAAK;AAChC;ACzBO,SAAS,cAAc,KAAA,EAAoC;AAChE,EAAA,MAAM,QAAQ,QAAA,EAAS;AACvB,EAAA,MAAM,MAAA,GAASA,IAAI,KAAK,CAAA;AACxB,EAAA,MAAM,KAAA,GAAQA,IAAa,IAAI,CAAA;AAE/B,EAAA,SAAA,CAAU,YAAY;AACpB,IAAA,IAAI;AACF,MAAA,MAAM,KAAA,CAAM,KAAK,KAAK,CAAA;AACtB,MAAA,MAAA,CAAO,KAAA,GAAQ,IAAA;AAAA,IACjB,SAAS,CAAA,EAAG;AACV,MAAA,KAAA,CAAM,KAAA,GAAQ,CAAA;AAAA,IAChB;AAAA,EACF,CAAC,CAAA;AAED,EAAA,OAAO,EAAE,QAAQ,KAAA,EAAM;AACzB;ACpBO,SAAS,aAAA,CACd,MACA,MAAA,EACqB;AACrB,EAAA,MAAM,QAAQ,QAAA,EAAS;AACvB,EAAA,OAAO,SAAS,MAAM;AACpB,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,CAAC,CAAA;AAAA,EACzB,CAAC,CAAA;AACH;;;ACDO,SAAS,gBAAA,CAAiB,MAAA,EAAgB,SAAA,GAAY,GAAA,EAA6B;AACxF,EAAA,MAAM,QAAQ,QAAA,EAAS;AAEvB,EAAA,MAAM,IAAA,GAAO,CAAC,MAAA,KAAoB,MAAA,GAAS,CAAA,EAAG,MAAM,CAAA,EAAG,SAAS,CAAA,EAAG,MAAM,CAAA,CAAA,GAAK,MAAA;AAE9E,EAAA,OAAO;AAAA,IACL,GAAA,EAAK,CAAC,MAAA,EAAQ,MAAA,KAAW,MAAM,GAAA,CAAI,IAAA,CAAK,MAAM,CAAA,EAAG,MAAM,CAAA;AAAA,IACvD,KAAA,EAAO,CAAC,MAAA,EAAQ,MAAA,KAAW,MAAM,KAAA,CAAM,IAAA,CAAK,MAAM,CAAA,EAAG,MAAM;AAAA,GAC7D;AACF","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 */\n\nimport type { App, InjectionKey } from 'vue';\nimport { inject, reactive, readonly } from 'vue';\nimport {\n  createRouteForge,\n  type RouteForge,\n  type RouteForgeOptions,\n} from '@route-forge/core';\n\nexport const FORGE_INJECTION_KEY: InjectionKey<RouteForge> = Symbol('route-forge');\n\nexport interface RouteForgePluginOptions extends RouteForgeOptions {}\n\nexport function createRouteForgePlugin(options: RouteForgePluginOptions) {\n  const forge = createRouteForge(options);\n\n  return {\n    install(app: App) {\n      app.provide(FORGE_INJECTION_KEY, forge);\n      app.config.globalProperties.$forge = {\n        route: (name: string, params?: Record<string, unknown>) =>\n          forge.route(name, params),\n      };\n    },\n  };\n}\n\nexport function useForge(): RouteForge {\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  return forge;\n}\n\nexport { readonly, reactive };\n","/**\n * useForgeApi：包装 forge.api()，自动管理 loading/error 状态\n * @see .docs/SPEC.md §4.1.7\n */\n\nimport { ref } from 'vue';\nimport { useForge } from '../plugin.js';\nimport type { ApiCallParams } from '@route-forge/core';\n\nexport interface UseForgeApiReturn {\n  pending: ReturnType<typeof ref<boolean>>;\n  error: ReturnType<typeof ref<unknown>>;\n  call: (name: string, params?: ApiCallParams) => Promise<{\n    data: unknown;\n    error: unknown;\n  }>;\n}\n\nexport function useForgeApi(): UseForgeApiReturn {\n  const forge = useForge();\n  const pending = ref(false);\n  const error = ref<unknown>(null);\n\n  async function call(name: string, params?: ApiCallParams) {\n    pending.value = true;\n    error.value = null;\n    try {\n      const data = await forge.api(name, params);\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 };\n}\n","/**\n * useForgeLevel：声明组件依赖某层级，挂载时自动 forge.load(level)，销毁时不主动失效\n * @see .docs/SPEC.md §4.1.7\n */\n\nimport { onMounted, ref } from 'vue';\nimport { useForge } from '../plugin.js';\n\nexport interface UseForgeLevelReturn {\n  loaded: ReturnType<typeof ref<boolean>>;\n  error: ReturnType<typeof ref<unknown>>;\n}\n\nexport function useForgeLevel(level: string): UseForgeLevelReturn {\n  const forge = useForge();\n  const loaded = ref(false);\n  const error = ref<unknown>(null);\n\n  onMounted(async () => {\n    try {\n      await forge.load(level);\n      loaded.value = true;\n    } catch (e) {\n      error.value = e;\n    }\n  });\n\n  return { loaded, error };\n}\n","/**\n * useForgeRoute：仅生成 URL，不发请求（用于 <a href>、外部跳转等）\n * @see .docs/SPEC.md §4.1.7\n */\n\nimport { computed, type ComputedRef } from 'vue';\nimport { useForge } from '../plugin.js';\n\nexport function useForgeRoute(\n  name: string | (() => string),\n  params?: () => Record<string, unknown>,\n): ComputedRef<string> {\n  const forge = useForge();\n  return computed(() => {\n    const n = typeof name === 'function' ? name() : name;\n    const p = params ? params() : undefined;\n    return forge.route(n, p);\n  });\n}\n","/**\n * useForgeByPrefix：带名字前缀的封装，方便后续减少名称传入\n * @see .docs/SPEC.md §4.1.7\n *\n * 示例：\n *   const { api } = useForgeByPrefix('admin.users');\n *   await api('show', { user: 1 });   // 等价于 forge.api('admin.users.show', { user: 1 })\n */\n\nimport { useForge } from '../plugin.js';\nimport type { ApiCallParams } 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(prefix: string, separator = '.'): UseForgeByPrefixReturn {\n  const forge = useForge();\n\n  const join = (suffix: string) => (suffix ? `${prefix}${separator}${suffix}` : prefix);\n\n  return {\n    api: (suffix, params) => forge.api(join(suffix), params),\n    route: (suffix, params) => forge.route(join(suffix), params),\n  };\n}\n"]}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@route-forge/vue",
+  "version": "0.1.0",
+  "description": "Route Forge 的 Vue 3 集成：插件 + composable（useForgeApi/useForgeLevel/useForgeRoute/useForgeByPrefix）",
+  "license": "MIT",
+  "author": "阿杰很厉害 <506907958@qq.com>",
+  "homepage": "https://github.com/xyj2156/route-forge",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/xyj2156/route-forge.git",
+    "directory": "packages/vue"
+  },
+  "bugs": {
+    "url": "https://github.com/xyj2156/route-forge/issues"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist"
+  ],
+  "peerDependencies": {
+    "vue": "^3.3.0"
+  },
+  "devDependencies": {
+    "@vue/test-utils": "^2.4.0",
+    "jsdom": "^24.0.0",
+    "tsup": "^8.0.0",
+    "vitest": "^1.4.0",
+    "vue": "^3.4.0"
+  },
+  "dependencies": {
+    "@route-forge/core": "0.1.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "tsc --noEmit",
+    "typecheck": "tsc --noEmit",
+    "clean": "rimraf dist .turbo"
+  }
+}