vite-plugin-aipanel 1.3.4 → 1.3.6

package/es/core/framework.d.ts

@@ -1,14 +1,30 @@
 /**
- * 构建期框架检测：从已解析的 Vite 插件列表推断项目框架。
+ * 构建期框架检测：从 Vite 插件列表推断项目框架。
  * 依据官方插件命名约定（@vitejs/plugin-vue → "vite:vue*"，plugin-react / plugin-react-swc →
  * "vite:react*"），用于门控 Vue DevTools 桥注入与各框架 inspector 集成；
  * 标识复用 INSPECTOR_ADAPTER_IDS，与运行时适配器注册表对齐。
  */
-import type { ResolvedConfig } from "vite";
+import type { Plugin } from "vite";
 import { INSPECTOR_ADAPTER_IDS } from "@aipanel/core";
 export type ViteFramework = (typeof INSPECTOR_ADAPTER_IDS)[keyof typeof INSPECTOR_ADAPTER_IDS];
+/**
+ * 框架判定所需的配置形态：configResolved 拿到的是已解析配置（ResolvedConfig），
+ * apply 阶段（Vite 解析插件列表时）拿到的是用户原始配置（UserConfig），两者都满足。
+ */
+export interface FrameworkDetectionConfig {
+    readonly plugins?: readonly unknown[];
+}
 /**
  * 检测项目框架：vue / react 同时存在时以 vue 优先（与运行时适配器解析顺序一致）；
  * 无法识别（solid、svelte、纯原生等）返回 null，调用方按保守策略处理。
  */
-export declare function detectViteFramework(config: ResolvedConfig): ViteFramework | null;
+export declare function detectViteFramework(config: FrameworkDetectionConfig): ViteFramework | null;
+/**
+ * 把构建期插件收窄到框架判定通过的项目，并保留插件原有的 apply 条件（如仅 dev server）。
+ *
+ * 只能在这一步拦截：Vite 解析插件列表时即调用 apply，此时拿到的是用户原始配置；
+ * 一旦插件被注册，第三方注入插件（unplugin-vue-inspector 会在 index.html 注入依赖 vue
+ * 的运行时）在 configResolved 阶段已撤销不了，React 等未安装 vue 的项目会直接报
+ * `Failed to resolve import "vue"`。框架判定与 configResolved 侧共用 detectViteFramework。
+ */
+export declare function restrictPluginsToFramework(plugins: Plugin[], accepts: (framework: ViteFramework | null) => boolean): Plugin[];

package/es/core/framework.mjs

@@ -22,6 +22,20 @@ function detectViteFramework(config) {
   }
   return null;
 }
+function restrictPluginsToFramework(plugins, accepts) {
+  return plugins.map((plugin) => {
+    const inner = plugin.apply;
+    return {
+      ...plugin,
+      apply: (config, env) => {
+        if (!accepts(detectViteFramework(config))) return false;
+        if (!inner) return true;
+        return typeof inner === "function" ? inner(config, env) : inner === env.command;
+      }
+    };
+  });
+}
 export {
-  detectViteFramework
+  detectViteFramework,
+  restrictPluginsToFramework
 };

package/es/inspectors/vue.d.ts

@@ -3,5 +3,8 @@ import type { InspectorIntegration } from "./types";
  * Vue 集成：注入 unplugin-vue-inspector 运行时。
  * 常驻但默认不启用（enabled: false），由挂件进入选择模式时开启；
  * 同时隐藏其自带的切换按钮与快捷键，避免与挂件交互冲突。
+ *
+ * 只对 Vue 项目注册：该插件会向 index.html 注入依赖 vue 的运行时，注册到未安装 vue 的
+ * 项目（React 等）会让浏览器直接报 Failed to resolve import "vue"。
  */
 export declare const vueInspectorIntegration: InspectorIntegration;

package/es/inspectors/vue.mjs

@@ -1,12 +1,16 @@
 import Inspector from "unplugin-vue-inspector/vite";
 import { INSPECTOR_ADAPTER_IDS } from "@aipanel/core";
+import { restrictPluginsToFramework } from "../core/framework.mjs";
 const vueInspectorIntegration = {
   id: INSPECTOR_ADAPTER_IDS.vue,
-  plugins: () => Inspector({
-    enabled: false,
-    toggleButtonVisibility: "never",
-    toggleComboKey: false
-  })
+  plugins: () => restrictPluginsToFramework(
+    Inspector({
+      enabled: false,
+      toggleButtonVisibility: "never",
+      toggleComboKey: false
+    }),
+    (framework) => framework === INSPECTOR_ADAPTER_IDS.vue
+  )
 };
 export {
   vueInspectorIntegration

package/lib/core/framework.cjs

@@ -17,7 +17,8 @@ var __copyProps = (to, from, except, desc) => {
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var framework_exports = {};
 __export(framework_exports, {
-  detectViteFramework: () => detectViteFramework
+  detectViteFramework: () => detectViteFramework,
+  restrictPluginsToFramework: () => restrictPluginsToFramework
 });
 module.exports = __toCommonJS(framework_exports);
 var import_core = require("@aipanel/core");
@@ -44,7 +45,21 @@ function detectViteFramework(config) {
   }
   return null;
 }
+function restrictPluginsToFramework(plugins, accepts) {
+  return plugins.map((plugin) => {
+    const inner = plugin.apply;
+    return {
+      ...plugin,
+      apply: (config, env) => {
+        if (!accepts(detectViteFramework(config))) return false;
+        if (!inner) return true;
+        return typeof inner === "function" ? inner(config, env) : inner === env.command;
+      }
+    };
+  });
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  detectViteFramework
+  detectViteFramework,
+  restrictPluginsToFramework
 });

package/lib/core/framework.d.ts

@@ -1,14 +1,30 @@
 /**
- * 构建期框架检测：从已解析的 Vite 插件列表推断项目框架。
+ * 构建期框架检测：从 Vite 插件列表推断项目框架。
  * 依据官方插件命名约定（@vitejs/plugin-vue → "vite:vue*"，plugin-react / plugin-react-swc →
  * "vite:react*"），用于门控 Vue DevTools 桥注入与各框架 inspector 集成；
  * 标识复用 INSPECTOR_ADAPTER_IDS，与运行时适配器注册表对齐。
  */
-import type { ResolvedConfig } from "vite";
+import type { Plugin } from "vite";
 import { INSPECTOR_ADAPTER_IDS } from "@aipanel/core";
 export type ViteFramework = (typeof INSPECTOR_ADAPTER_IDS)[keyof typeof INSPECTOR_ADAPTER_IDS];
+/**
+ * 框架判定所需的配置形态：configResolved 拿到的是已解析配置（ResolvedConfig），
+ * apply 阶段（Vite 解析插件列表时）拿到的是用户原始配置（UserConfig），两者都满足。
+ */
+export interface FrameworkDetectionConfig {
+    readonly plugins?: readonly unknown[];
+}
 /**
  * 检测项目框架：vue / react 同时存在时以 vue 优先（与运行时适配器解析顺序一致）；
  * 无法识别（solid、svelte、纯原生等）返回 null，调用方按保守策略处理。
  */
-export declare function detectViteFramework(config: ResolvedConfig): ViteFramework | null;
+export declare function detectViteFramework(config: FrameworkDetectionConfig): ViteFramework | null;
+/**
+ * 把构建期插件收窄到框架判定通过的项目，并保留插件原有的 apply 条件（如仅 dev server）。
+ *
+ * 只能在这一步拦截：Vite 解析插件列表时即调用 apply，此时拿到的是用户原始配置；
+ * 一旦插件被注册，第三方注入插件（unplugin-vue-inspector 会在 index.html 注入依赖 vue
+ * 的运行时）在 configResolved 阶段已撤销不了，React 等未安装 vue 的项目会直接报
+ * `Failed to resolve import "vue"`。框架判定与 configResolved 侧共用 detectViteFramework。
+ */
+export declare function restrictPluginsToFramework(plugins: Plugin[], accepts: (framework: ViteFramework | null) => boolean): Plugin[];

package/lib/inspectors/vue.cjs

@@ -32,13 +32,17 @@ __export(vue_exports, {
 module.exports = __toCommonJS(vue_exports);
 var import_vite = __toESM(require("unplugin-vue-inspector/vite"));
 var import_core = require("@aipanel/core");
+var import_framework = require("../core/framework.cjs");
 const vueInspectorIntegration = {
   id: import_core.INSPECTOR_ADAPTER_IDS.vue,
-  plugins: () => (0, import_vite.default)({
-    enabled: false,
-    toggleButtonVisibility: "never",
-    toggleComboKey: false
-  })
+  plugins: () => (0, import_framework.restrictPluginsToFramework)(
+    (0, import_vite.default)({
+      enabled: false,
+      toggleButtonVisibility: "never",
+      toggleComboKey: false
+    }),
+    (framework) => framework === import_core.INSPECTOR_ADAPTER_IDS.vue
+  )
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/lib/inspectors/vue.d.ts

@@ -3,5 +3,8 @@ import type { InspectorIntegration } from "./types";
  * Vue 集成：注入 unplugin-vue-inspector 运行时。
  * 常驻但默认不启用（enabled: false），由挂件进入选择模式时开启；
  * 同时隐藏其自带的切换按钮与快捷键，避免与挂件交互冲突。
+ *
+ * 只对 Vue 项目注册：该插件会向 index.html 注入依赖 vue 的运行时，注册到未安装 vue 的
+ * 项目（React 等）会让浏览器直接报 Failed to resolve import "vue"。
  */
 export declare const vueInspectorIntegration: InspectorIntegration;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vite-plugin-aipanel",
-  "version": "1.3.4",
+  "version": "1.3.6",
   "description": "Embed OpenCode Web UI in your Vite dev server for real-time code modification and preview",
   "type": "module",
   "main": "lib/index.cjs",
@@ -35,8 +35,8 @@
   "author": "",
   "license": "MIT",
   "dependencies": {
-    "@aipanel/core": "1.3.4",
-    "@aipanel/provider-opencode": "1.3.4",
+    "@aipanel/core": "1.3.6",
+    "@aipanel/provider-opencode": "1.3.6",
     "@code-inspector/core": "^2.0.9",
     "@vue/devtools-kit": "^8.0.0",
     "@vue/language-server": "^3.3.7",
@@ -47,7 +47,7 @@
     "unplugin-vue-inspector": "^3.0.0"
   },
   "peerDependencies": {
-    "@aipanel/provider-deepseek": "1.3.4",
+    "@aipanel/provider-deepseek": "1.3.6",
     "vite": ">=5.0.0"
   },
   "peerDependenciesMeta": {
@@ -56,7 +56,7 @@
     }
   },
   "devDependencies": {
-    "@aipanel/client": "1.3.4",
+    "@aipanel/client": "1.3.6",
     "@types/picomatch": "^4.0.0",
     "sharp": "^0.34.5"
   },