vite-plugin-opencode-assistant 1.0.3 → 1.0.5

package/README.md

@@ -1,282 +0,0 @@
-# vite-plugin-opencode
-
-A Vite plugin that embeds OpenCode Web UI in your development environment, enabling real-time code modification through AI chat.
-
-## Features
-
-- 🚀 **Auto-start OpenCode services** - Automatically starts OpenCode Server and Web UI
-- 💬 **Embedded Chat Interface** - Customer support-like chat widget in your app
-- 🔄 **Real-time Code Modification** - AI can modify your code and see changes instantly via HMR
-- 🎨 **Customizable** - Configurable position, theme, and behavior
-- ⚡ **Zero Configuration** - Works out of the box with sensible defaults
-- 🔧 **Framework Agnostic** - Works with React, Vue, Svelte, and more
-
-## Installation
-
-```bash
-npm install -D vite-plugin-opencode
-```
-
-## Prerequisites
-
-This plugin requires [OpenCode](https://opencode.ai) to be installed on your system.
-
-### Install OpenCode
-
-**Using Homebrew (macOS):**
-```bash
-brew install opencode-ai/tap/opencode
-```
-
-**Using the install script:**
-```bash
-curl -fsSL https://raw.githubusercontent.com/opencode-ai/opencode/main/install | bash
-```
-
-**Using Go:**
-```bash
-go install github.com/opencode-ai/opencode@latest
-```
-
-## Usage
-
-### Basic Setup
-
-Add the plugin to your `vite.config.ts`:
-
-```typescript
-import { defineConfig } from 'vite'
-import opencode from 'vite-plugin-opencode'
-
-export default defineConfig({
-  plugins: [
-    opencode(),
-  ],
-})
-```
-
-### With Configuration
-
-```typescript
-import { defineConfig } from 'vite'
-import opencode from 'vite-plugin-opencode'
-
-export default defineConfig({
-  plugins: [
-    opencode({
-      serverPort: 4096,      // OpenCode Server port
-      webPort: 4097,         // OpenCode Web UI port
-      hostname: 'localhost',
-      position: 'bottom-right',
-      theme: 'auto',
-      open: false,
-      autoReload: true,
-    }),
-  ],
-})
-```
-
-### Start Development
-
-```bash
-npm run dev
-```
-
-You'll see a floating button in the bottom-right corner of your app. Click it to open the AI chat interface!
-
-## How It Works
-
-```
-┌─────────────────────────────────────────────────┐
-│           Vite Dev Server (5173)                │
-│                                                 │
-│  ┌───────────────────────────────────────────┐ │
-│  │   Your App (with HMR)                     │ │
-│  │   - Embedded OpenCode Widget              │ │
-│  └───────────────────────────────────────────┘ │
-│                                                 │
-│  ┌───────────────────────────────────────────┐ │
-│  │   vite-plugin-opencode                    │ │
-│  │   - OpenCode Server (4096)                │ │
-│  │   - OpenCode Web (4097)                   │ │
-│  └───────────────────────────────────────────┘ │
-└─────────────────────────────────────────────────┘
-```
-
-### Workflow
-
-1. **User** asks AI to modify code (e.g., "Change button color to red")
-2. **OpenCode Web** sends request to OpenCode Server
-3. **OpenCode Server** reads and modifies the file
-4. **Vite HMR** detects file change and hot-reloads the page
-5. **User** sees the change instantly!
-
-## Configuration Options
-
-```typescript
-interface OpenCodeOptions {
-  // Enable/disable the plugin (default: true)
-  enabled?: boolean
-  
-  // OpenCode Server port (default: 4096)
-  serverPort?: number
-  
-  // OpenCode Web UI port (default: 4097)
-  webPort?: number
-  
-  // Hostname (default: 'localhost')
-  hostname?: string
-  
-  // Widget position (default: 'bottom-right')
-  position?: 'bottom-right' | 'bottom-left' | 'top-right' | 'top-left'
-  
-  // Theme (default: 'auto')
-  theme?: 'light' | 'dark' | 'auto'
-  
-  // Auto-open chat window (default: false)
-  open?: boolean
-  
-  // Enable auto-reload notifications (default: true)
-  autoReload?: boolean
-}
-```
-
-## Examples
-
-### React
-
-```typescript
-// vite.config.ts
-import { defineConfig } from 'vite'
-import react from '@vitejs/plugin-react'
-import opencode from 'vite-plugin-opencode'
-
-export default defineConfig({
-  plugins: [
-    react(),
-    opencode(),
-  ],
-})
-```
-
-### Vue
-
-```typescript
-// vite.config.ts
-import { defineConfig } from 'vite'
-import vue from '@vitejs/plugin-vue'
-import opencode from 'vite-plugin-opencode'
-
-export default defineConfig({
-  plugins: [
-    vue(),
-    opencode(),
-  ],
-})
-```
-
-## Use Cases
-
-### 1. Style Modifications
-```
-User: "Change the button color to red"
-AI: Modifies App.css
-Result: Button turns red instantly
-```
-
-### 2. Component Creation
-```
-User: "Add a login form"
-AI: Creates LoginForm.jsx
-Result: Login form appears on page
-```
-
-### 3. Bug Fixes
-```
-User: "Fix the counter not working"
-AI: Modifies App.jsx
-Result: Counter works correctly
-```
-
-## API
-
-The plugin exposes a global API that you can use in your code:
-
-```javascript
-// Open the chat widget
-window.OpenCodeWidget.open()
-
-// Close the chat widget
-window.OpenCodeWidget.close()
-
-// Toggle the chat widget
-window.OpenCodeWidget.toggle()
-
-// Show a notification
-window.OpenCodeWidget.showNotification('Code updated!')
-```
-
-## Keyboard Shortcuts
-
-- `Ctrl/Cmd + K` - Toggle chat widget
-
-## Troubleshooting
-
-### OpenCode not installed
-
-If you see an error message about OpenCode not being installed, follow the installation instructions above.
-
-### Port conflicts
-
-If ports 4096 or 4097 are already in use, you can configure different ports:
-
-```typescript
-opencode({
-  serverPort: 5000,
-  webPort: 5001,
-})
-```
-
-### CORS issues
-
-The plugin automatically configures CORS for local development. If you encounter CORS issues, make sure you're using the correct hostname and ports.
-
-## Development
-
-### Build the plugin
-
-```bash
-npm run build
-```
-
-### Run tests
-
-```bash
-npm test
-```
-
-### Run the example
-
-```bash
-cd example
-npm install
-npm run dev
-```
-
-## Contributing
-
-Contributions are welcome! Please feel free to submit a Pull Request.
-
-## License
-
-MIT
-
-## Links
-
-- [OpenCode Documentation](https://opencode.ai/docs)
-- [OpenCode GitHub](https://github.com/opencode-ai/opencode)
-- [Vite Plugin API](https://vite.dev/guide/api-plugin.html)
-
-## Acknowledgments
-
-This plugin is built on top of [OpenCode](https://opencode.ai), an open-source AI coding assistant.

package/dist/constants.d.ts

@@ -1,73 +0,0 @@
-/**
- * @fileoverview OpenCode 插件常量定义
- */
-/** ==================== 网络相关 ==================== */
-/** 默认主机名 */
-export declare const DEFAULT_HOSTNAME = "127.0.0.1";
-/** 默认 Web 服务端口 */
-export declare const DEFAULT_WEB_PORT = 4097;
-/** 服务器启动超时时间（毫秒） */
-export declare const SERVER_START_TIMEOUT = 15000;
-/** 服务器检查间隔（毫秒） */
-export declare const SERVER_CHECK_INTERVAL = 100;
-/** ==================== 重试相关 ==================== */
-/** 默认重试次数 */
-export declare const DEFAULT_RETRIES = 5;
-/** 重试延迟（毫秒） */
-export declare const RETRY_DELAY = 500;
-/** ==================== 端口查找 ==================== */
-/** 最大端口尝试次数 */
-export declare const MAX_PORT_TRIES = 10;
-/** ==================== 日志相关 ==================== */
-/** 插件日志前缀 */
-export declare const LOG_PREFIX = "[vite-plugin-opencode]";
-/** OpenCode Web 日志前缀 */
-export declare const WEB_LOG_PREFIX = "[OpenCode Web]";
-/** OpenCode Web 错误日志前缀 */
-export declare const WEB_ERROR_PREFIX = "[OpenCode Web Error]";
-/** ==================== 挂件相关 ==================== */
-/** 挂件脚本路径 */
-export declare const WIDGET_SCRIPT_PATH = "/__opencode_widget__.js";
-/** 配置数据属性名 */
-export declare const CONFIG_DATA_ATTR = "data-opencode-config";
-/** 上下文 API 路径 */
-export declare const CONTEXT_API_PATH = "/__opencode_context__";
-/** 启动 API 路径 */
-export declare const START_API_PATH = "/__opencode_start__";
-/** 会话列表 API 路径 */
-export declare const SESSIONS_API_PATH = "/__opencode_sessions__";
-/** SSE 事件流路径 */
-export declare const SSE_EVENTS_PATH = "/__opencode_events__";
-/** 上下文更新间隔（毫秒） */
-export declare const CONTEXT_UPDATE_INTERVAL = 500;
-/** 服务器同步间隔（毫秒） */
-export declare const SERVER_SYNC_INTERVAL = 2000;
-/** Vue Inspector 检查间隔（毫秒） */
-export declare const INSPECTOR_CHECK_INTERVAL = 500;
-/** 自动打开延迟（毫秒） */
-export declare const AUTO_OPEN_DELAY = 1000;
-/** 通知显示时间（毫秒） */
-export declare const NOTIFICATION_DURATION = 3000;
-/** ==================== 存储相关 ==================== */
-/** 初始化标记 */
-export declare const INIT_MARKER = "__OPENCODE_INITIALIZED__";
-/** 选中元素存储键 */
-export declare const SELECTED_ELEMENTS_KEY = "__opencode_selected_elements__";
-/** ==================== 文本处理 ==================== */
-/** 元素文本最大显示长度 */
-export declare const MAX_TEXT_LENGTH = 100;
-/** 元素上下文标记 */
-export declare const CONTEXT_MARKER = "[\u5143\u7D20\u4E0A\u4E0B\u6587]";
-/** ==================== 默认配置 ==================== */
-/** 默认插件配置 */
-export declare const DEFAULT_CONFIG: {
-    enabled: boolean;
-    webPort: number;
-    hostname: string;
-    position: "bottom-right";
-    theme: "auto";
-    open: boolean;
-    autoReload: boolean;
-    verbose: boolean;
-    hotkey: string;
-};

package/dist/constants.js

@@ -1,74 +0,0 @@
-/**
- * @fileoverview OpenCode 插件常量定义
- */
-/** ==================== 网络相关 ==================== */
-/** 默认主机名 */
-export const DEFAULT_HOSTNAME = '127.0.0.1';
-/** 默认 Web 服务端口 */
-export const DEFAULT_WEB_PORT = 4097;
-/** 服务器启动超时时间（毫秒） */
-export const SERVER_START_TIMEOUT = 15000;
-/** 服务器检查间隔（毫秒） */
-export const SERVER_CHECK_INTERVAL = 100;
-/** ==================== 重试相关 ==================== */
-/** 默认重试次数 */
-export const DEFAULT_RETRIES = 5;
-/** 重试延迟（毫秒） */
-export const RETRY_DELAY = 500;
-/** ==================== 端口查找 ==================== */
-/** 最大端口尝试次数 */
-export const MAX_PORT_TRIES = 10;
-/** ==================== 日志相关 ==================== */
-/** 插件日志前缀 */
-export const LOG_PREFIX = '[vite-plugin-opencode]';
-/** OpenCode Web 日志前缀 */
-export const WEB_LOG_PREFIX = '[OpenCode Web]';
-/** OpenCode Web 错误日志前缀 */
-export const WEB_ERROR_PREFIX = '[OpenCode Web Error]';
-/** ==================== 挂件相关 ==================== */
-/** 挂件脚本路径 */
-export const WIDGET_SCRIPT_PATH = '/__opencode_widget__.js';
-/** 配置数据属性名 */
-export const CONFIG_DATA_ATTR = 'data-opencode-config';
-/** 上下文 API 路径 */
-export const CONTEXT_API_PATH = '/__opencode_context__';
-/** 启动 API 路径 */
-export const START_API_PATH = '/__opencode_start__';
-/** 会话列表 API 路径 */
-export const SESSIONS_API_PATH = '/__opencode_sessions__';
-/** SSE 事件流路径 */
-export const SSE_EVENTS_PATH = '/__opencode_events__';
-/** 上下文更新间隔（毫秒） */
-export const CONTEXT_UPDATE_INTERVAL = 500;
-/** 服务器同步间隔（毫秒） */
-export const SERVER_SYNC_INTERVAL = 2000;
-/** Vue Inspector 检查间隔（毫秒） */
-export const INSPECTOR_CHECK_INTERVAL = 500;
-/** 自动打开延迟（毫秒） */
-export const AUTO_OPEN_DELAY = 1000;
-/** 通知显示时间（毫秒） */
-export const NOTIFICATION_DURATION = 3000;
-/** ==================== 存储相关 ==================== */
-/** 初始化标记 */
-export const INIT_MARKER = '__OPENCODE_INITIALIZED__';
-/** 选中元素存储键 */
-export const SELECTED_ELEMENTS_KEY = '__opencode_selected_elements__';
-/** ==================== 文本处理 ==================== */
-/** 元素文本最大显示长度 */
-export const MAX_TEXT_LENGTH = 100;
-/** 元素上下文标记 */
-export const CONTEXT_MARKER = '[元素上下文]';
-/** ==================== 默认配置 ==================== */
-/** 默认插件配置 */
-export const DEFAULT_CONFIG = {
-    enabled: true,
-    webPort: DEFAULT_WEB_PORT,
-    hostname: DEFAULT_HOSTNAME,
-    position: 'bottom-right',
-    theme: 'auto',
-    open: false,
-    autoReload: true,
-    verbose: false,
-    hotkey: 'ctrl+k',
-};
-//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,qDAAqD;AAErD,YAAY;AACZ,MAAM,CAAC,MAAM,gBAAgB,GAAG,WAAW,CAAA;AAE3C,kBAAkB;AAClB,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,CAAA;AAEpC,oBAAoB;AACpB,MAAM,CAAC,MAAM,oBAAoB,GAAG,KAAK,CAAA;AAEzC,kBAAkB;AAClB,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAG,CAAA;AAExC,qDAAqD;AAErD,aAAa;AACb,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAA;AAEhC,eAAe;AACf,MAAM,CAAC,MAAM,WAAW,GAAG,GAAG,CAAA;AAE9B,qDAAqD;AAErD,eAAe;AACf,MAAM,CAAC,MAAM,cAAc,GAAG,EAAE,CAAA;AAEhC,qDAAqD;AAErD,aAAa;AACb,MAAM,CAAC,MAAM,UAAU,GAAG,wBAAwB,CAAA;AAElD,wBAAwB;AACxB,MAAM,CAAC,MAAM,cAAc,GAAG,gBAAgB,CAAA;AAE9C,0BAA0B;AAC1B,MAAM,CAAC,MAAM,gBAAgB,GAAG,sBAAsB,CAAA;AAEtD,qDAAqD;AAErD,aAAa;AACb,MAAM,CAAC,MAAM,kBAAkB,GAAG,yBAAyB,CAAA;AAE3D,cAAc;AACd,MAAM,CAAC,MAAM,gBAAgB,GAAG,sBAAsB,CAAA;AAEtD,iBAAiB;AACjB,MAAM,CAAC,MAAM,gBAAgB,GAAG,uBAAuB,CAAA;AAEvD,gBAAgB;AAChB,MAAM,CAAC,MAAM,cAAc,GAAG,qBAAqB,CAAA;AAEnD,kBAAkB;AAClB,MAAM,CAAC,MAAM,iBAAiB,GAAG,wBAAwB,CAAA;AAEzD,gBAAgB;AAChB,MAAM,CAAC,MAAM,eAAe,GAAG,sBAAsB,CAAA;AAErD,kBAAkB;AAClB,MAAM,CAAC,MAAM,uBAAuB,GAAG,GAAG,CAAA;AAE1C,kBAAkB;AAClB,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAI,CAAA;AAExC,6BAA6B;AAC7B,MAAM,CAAC,MAAM,wBAAwB,GAAG,GAAG,CAAA;AAE3C,iBAAiB;AACjB,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,CAAA;AAEnC,iBAAiB;AACjB,MAAM,CAAC,MAAM,qBAAqB,GAAG,IAAI,CAAA;AAEzC,qDAAqD;AAErD,YAAY;AACZ,MAAM,CAAC,MAAM,WAAW,GAAG,0BAA0B,CAAA;AAErD,cAAc;AACd,MAAM,CAAC,MAAM,qBAAqB,GAAG,gCAAgC,CAAA;AAErE,qDAAqD;AAErD,iBAAiB;AACjB,MAAM,CAAC,MAAM,eAAe,GAAG,GAAG,CAAA;AAElC,cAAc;AACd,MAAM,CAAC,MAAM,cAAc,GAAG,SAAS,CAAA;AAEvC,qDAAqD;AAErD,aAAa;AACb,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,OAAO,EAAE,IAAI;IACb,OAAO,EAAE,gBAAgB;IACzB,QAAQ,EAAE,gBAAgB;IAC1B,QAAQ,EAAE,cAAuB;IACjC,KAAK,EAAE,MAAe;IACtB,IAAI,EAAE,KAAK;IACX,UAAU,EAAE,IAAI;IAChB,OAAO,EAAE,KAAK;IACd,MAAM,EAAE,QAAQ;CACjB,CAAA","sourcesContent":["/**\n * @fileoverview OpenCode 插件常量定义\n */\n\n/** ==================== 网络相关 ==================== */\n\n/** 默认主机名 */\nexport const DEFAULT_HOSTNAME = '127.0.0.1'\n\n/** 默认 Web 服务端口 */\nexport const DEFAULT_WEB_PORT = 4097\n\n/** 服务器启动超时时间（毫秒） */\nexport const SERVER_START_TIMEOUT = 15000\n\n/** 服务器检查间隔（毫秒） */\nexport const SERVER_CHECK_INTERVAL = 100\n\n/** ==================== 重试相关 ==================== */\n\n/** 默认重试次数 */\nexport const DEFAULT_RETRIES = 5\n\n/** 重试延迟（毫秒） */\nexport const RETRY_DELAY = 500\n\n/** ==================== 端口查找 ==================== */\n\n/** 最大端口尝试次数 */\nexport const MAX_PORT_TRIES = 10\n\n/** ==================== 日志相关 ==================== */\n\n/** 插件日志前缀 */\nexport const LOG_PREFIX = '[vite-plugin-opencode]'\n\n/** OpenCode Web 日志前缀 */\nexport const WEB_LOG_PREFIX = '[OpenCode Web]'\n\n/** OpenCode Web 错误日志前缀 */\nexport const WEB_ERROR_PREFIX = '[OpenCode Web Error]'\n\n/** ==================== 挂件相关 ==================== */\n\n/** 挂件脚本路径 */\nexport const WIDGET_SCRIPT_PATH = '/__opencode_widget__.js'\n\n/** 配置数据属性名 */\nexport const CONFIG_DATA_ATTR = 'data-opencode-config'\n\n/** 上下文 API 路径 */\nexport const CONTEXT_API_PATH = '/__opencode_context__'\n\n/** 启动 API 路径 */\nexport const START_API_PATH = '/__opencode_start__'\n\n/** 会话列表 API 路径 */\nexport const SESSIONS_API_PATH = '/__opencode_sessions__'\n\n/** SSE 事件流路径 */\nexport const SSE_EVENTS_PATH = '/__opencode_events__'\n\n/** 上下文更新间隔（毫秒） */\nexport const CONTEXT_UPDATE_INTERVAL = 500\n\n/** 服务器同步间隔（毫秒） */\nexport const SERVER_SYNC_INTERVAL = 2000\n\n/** Vue Inspector 检查间隔（毫秒） */\nexport const INSPECTOR_CHECK_INTERVAL = 500\n\n/** 自动打开延迟（毫秒） */\nexport const AUTO_OPEN_DELAY = 1000\n\n/** 通知显示时间（毫秒） */\nexport const NOTIFICATION_DURATION = 3000\n\n/** ==================== 存储相关 ==================== */\n\n/** 初始化标记 */\nexport const INIT_MARKER = '__OPENCODE_INITIALIZED__'\n\n/** 选中元素存储键 */\nexport const SELECTED_ELEMENTS_KEY = '__opencode_selected_elements__'\n\n/** ==================== 文本处理 ==================== */\n\n/** 元素文本最大显示长度 */\nexport const MAX_TEXT_LENGTH = 100\n\n/** 元素上下文标记 */\nexport const CONTEXT_MARKER = '[元素上下文]'\n\n/** ==================== 默认配置 ==================== */\n\n/** 默认插件配置 */\nexport const DEFAULT_CONFIG = {\n  enabled: true,\n  webPort: DEFAULT_WEB_PORT,\n  hostname: DEFAULT_HOSTNAME,\n  position: 'bottom-right' as const,\n  theme: 'auto' as const,\n  open: false,\n  autoReload: true,\n  verbose: false,\n  hotkey: 'ctrl+k',\n}\n"]}

package/dist/logger.d.ts

@@ -1,64 +0,0 @@
-export declare enum LogLevel {
-    DEBUG = 0,
-    INFO = 1,
-    WARN = 2,
-    ERROR = 3,
-    NONE = 4
-}
-export interface LogContext {
-    module?: string;
-    operation?: string;
-    traceId?: string;
-    duration?: number;
-    error?: Error | unknown;
-    [key: string]: unknown;
-}
-interface LoggerConfig {
-    verbose: boolean;
-    level: LogLevel;
-    showTimestamp: boolean;
-    showCaller: boolean;
-    showTrace: boolean;
-    indent: string;
-}
-export declare function configureLogger(options: Partial<LoggerConfig>): void;
-export declare function setVerbose(verbose: boolean): void;
-export declare const logger: {
-    debug(message: string, context?: LogContext, ...args: unknown[]): void;
-    info(message: string, context?: LogContext, ...args: unknown[]): void;
-    warn(message: string, context?: LogContext, ...args: unknown[]): void;
-    error(message: string, context?: LogContext, ...args: unknown[]): void;
-    group(label: string, context?: LogContext): void;
-    groupEnd(): void;
-};
-export declare function generateTraceId(): string;
-export declare class PerformanceTimer {
-    private startTime;
-    private context;
-    private operation;
-    constructor(operation: string, context?: LogContext);
-    end(message?: string): number;
-    checkpoint(label: string): number;
-}
-export declare class RequestContext {
-    traceId: string;
-    method: string;
-    path: string;
-    startTime: number;
-    private checkpoints;
-    constructor(method: string, path: string);
-    checkpoint(label: string): void;
-    end(statusCode: number): void;
-    error(error: Error | unknown): void;
-}
-export declare function createLogger(module: string): {
-    debug(message: string, context?: Omit<LogContext, "module">, ...args: unknown[]): void;
-    info(message: string, context?: Omit<LogContext, "module">, ...args: unknown[]): void;
-    warn(message: string, context?: Omit<LogContext, "module">, ...args: unknown[]): void;
-    error(message: string, context?: Omit<LogContext, "module">, ...args: unknown[]): void;
-    timer(operation: string, context?: Omit<LogContext, "module">): PerformanceTimer;
-};
-export declare function logMethod(target: unknown, propertyKey: string, descriptor: PropertyDescriptor): PropertyDescriptor;
-export declare function formatBytes(bytes: number): string;
-export declare function formatDuration(ms: number): string;
-export {};