vite-plugin-opencode-assistant 1.0.4 → 1.0.6

package/README.md

@@ -1,287 +0,0 @@
-# vite-plugin-opencode-assistant
-
-一个面向 Vite 开发环境的插件：在页面内注入 OpenCode 对话挂件，自动启动 OpenCode Web，并把当前页面 URL、标题以及选中的页面节点同步给 AI，便于一边聊天一边改代码、立即通过 HMR 看到结果。
-
-## 它能做什么
-
-- 在 `vite serve` 时自动注入一个悬浮 AI 按钮和对话面板
-- 自动启动本地 OpenCode Web 服务，并为当前项目复用或创建会话
-- 把当前页面 URL、标题同步到 OpenCode 会话上下文
-- 支持把页面上选中的节点信息同步给 AI，帮助它直接定位组件文件与行号
-- 内置会话列表，可在挂件中切换、新建、删除当前项目的 OpenCode 会话
-- 支持快捷键、主题、初始展开状态、悬浮位置等配置
-- 支持启动后预热 Chrome DevTools MCP，减少首次使用浏览器工具时的等待
-
-## 工作方式
-
-启动 Vite 开发服务器后，插件会做这几件事：
-
-1. 在 HTML 中注入浏览器端挂件脚本
-2. 检查本机是否已安装 `opencode`
-3. 启动 OpenCode Web 服务，默认使用 `127.0.0.1:4097`
-4. 在当前项目目录下查找已有会话；如果没有，则创建新会话
-5. 把页面上下文通过本地接口同步给 OpenCode
-6. 页面代码被 OpenCode 修改后，由 Vite HMR 立即刷新效果
-
-当前实现只在开发模式生效：
-
-- 仅在 `vite serve` 时启用
-- `build` 阶段不会注入挂件
-- `enabled` 默认值是 `false`，需要显式开启
-
-## 安装
-
-```bash
-npm install -D vite-plugin-opencode-assistant
-```
-
-## 前置条件
-
-本插件依赖本机已安装 [OpenCode](https://opencode.ai) CLI。
-
-推荐安装方式：
-
-```bash
-curl -fsSL https://opencode.ai/install | bash
-```
-
-也可以使用包管理器：
-
-```bash
-npm i -g opencode-ai@latest
-brew install anomalyco/tap/opencode
-```
-
-如果你保留默认的 `warmupChromeMcp: true`，首次启动时还会通过 `npx` 拉起 `chrome-devtools-mcp` 来预热浏览器工具链。
-
-## 快速开始
-
-由于当前实现默认 `enabled: false`，最小可用配置如下：
-
-```ts
-import { defineConfig } from "vite";
-import opencodeAssistant from "vite-plugin-opencode-assistant";
-
-export default defineConfig({
-  plugins: [
-    opencodeAssistant({
-      enabled: true,
-    }),
-  ],
-});
-```
-
-启动开发服务器：
-
-```bash
-npm run dev
-```
-
-启动后页面右下角会出现悬浮按钮，点击即可打开 OpenCode 面板。
-
-## 推荐配置示例
-
-```ts
-import { defineConfig } from "vite";
-import vue from "@vitejs/plugin-vue";
-import opencodeAssistant from "vite-plugin-opencode-assistant";
-
-export default defineConfig({
-  plugins: [
-    vue(),
-    opencodeAssistant({
-      enabled: true,
-      webPort: 4097,
-      hostname: "127.0.0.1",
-      position: "bottom-right",
-      theme: "auto",
-      open: false,
-      autoReload: true,
-      verbose: false,
-      hotkey: "ctrl+k",
-      warmupChromeMcp: true,
-    }),
-  ],
-});
-```
-
-## 配置项
-
-```ts
-interface OpenCodeOptions {
-  enabled?: boolean;
-  webPort?: number;
-  hostname?: string;
-  position?: "bottom-right" | "bottom-left" | "top-right" | "top-left";
-  theme?: "light" | "dark" | "auto";
-  open?: boolean;
-  autoReload?: boolean;
-  verbose?: boolean;
-  hotkey?: string;
-  warmupChromeMcp?: boolean;
-}
-```
-
-配置说明：
-
-| 配置项            | 默认值           | 说明                                                                |
-| ----------------- | ---------------- | ------------------------------------------------------------------- |
-| `enabled`         | `false`          | 是否启用插件。当前版本必须手动设为 `true` 才会生效                  |
-| `webPort`         | `4097`           | OpenCode Web 端口。如果端口被占用，会从当前端口开始向后寻找可用端口 |
-| `hostname`        | `127.0.0.1`      | OpenCode Web 绑定地址                                               |
-| `position`        | `"bottom-right"` | 悬浮挂件位置                                                        |
-| `theme`           | `"auto"`         | 挂件主题，`auto` 会跟随系统明暗色                                   |
-| `open`            | `false`          | 页面初始化后是否自动展开挂件                                        |
-| `autoReload`      | `true`           | 控制挂件侧的自动重载提示行为                                        |
-| `verbose`         | `false`          | 是否输出更详细的插件日志                                            |
-| `hotkey`          | `"ctrl+k"`       | 切换挂件的快捷键，macOS 下同样支持 `cmd+k`                          |
-| `warmupChromeMcp` | `true`           | 启动后是否预热 Chrome DevTools MCP                                  |
-
-## 使用说明
-
-### 1. 打开对话挂件
-
-- 点击页面右下角悬浮按钮
-- 或使用默认快捷键 `Ctrl/Cmd + K`
-
-### 2. 切换会话
-
-挂件左侧带有当前项目的会话列表，支持：
-
-- 查看当前项目下已有会话
-- 新建会话
-- 切换会话
-- 删除会话
-
-### 3. 同步页面上下文
-
-挂件会自动同步以下信息：
-
-- 当前页面 URL
-- 当前页面标题
-- 当前选中的页面节点
-
-它会监听：
-
-- `history.pushState`
-- `history.replaceState`
-- `popstate`
-- `hashchange`
-- `document.title` 变化
-
-这意味着在 SPA 场景下切页后，上下文也会自动更新。
-
-### 4. 选择页面节点
-
-当前实现支持把页面节点作为上下文传给 AI，节点信息包括：
-
-- 源文件路径
-- 行号和列号
-- 节点文本
-- 节点描述
-
-默认通过 `Ctrl/Cmd + P` 进入选择模式。
-
-需要注意：
-
-- 这项能力依赖页面中可用的 Vue Inspector 钩子
-- 如果页面中没有可用的 Inspector，挂件会提示“Vue Inspector 未加载，无法使用元素选择功能”
-- 选中的节点会暂存在 `sessionStorage` 中
-
-## 浏览器端全局 API
-
-挂件会暴露一个全局对象：
-
-```js
-window.OpenCodeWidget.open();
-window.OpenCodeWidget.close();
-window.OpenCodeWidget.toggle();
-window.OpenCodeWidget.showNotification("Code updated!");
-window.OpenCodeWidget.updateContext();
-```
-
-适用场景：
-
-- 从你自己的调试面板中主动打开挂件
-- 在页面状态发生重要变化后手动触发一次上下文同步
-- 在自定义流程中复用现有的通知能力
-
-## 本地接口
-
-插件会在 Vite 开发服务器上挂出几个内部接口，供挂件与 OpenCode 协作使用：
-
-| 路径                      | 说明                                       |
-| ------------------------- | ------------------------------------------ |
-| `/__opencode_widget__.js` | 浏览器端挂件脚本                           |
-| `/__opencode_start__`     | 返回当前服务启动状态与会话地址             |
-| `/__opencode_context__`   | 读写页面上下文、清空已选节点               |
-| `/__opencode_sessions__`  | 查询、创建、删除 OpenCode 会话             |
-| `/__opencode_events__`    | SSE 事件流，用于同步会话就绪和节点清空事件 |
-
-这些接口是插件内部实现细节，通常不需要业务代码直接调用。
-
-## 常见问题
-
-### OpenCode not installed
-
-如果控制台提示未安装 OpenCode，先确认命令行里可以正常执行：
-
-```bash
-opencode --version
-```
-
-若无法执行，请先完成 OpenCode CLI 安装。
-
-### 端口冲突
-
-当前实现只开放了 `webPort` 配置项，没有单独暴露 server 端口配置。
-
-如果默认端口被占用，可以改成：
-
-```ts
-opencodeAssistant({
-  enabled: true,
-  webPort: 5001,
-});
-```
-
-如果你不改配置，插件也会从 `webPort` 开始继续向后寻找可用端口。
-
-### 页面里没有节点选择能力
-
-这通常意味着当前页面里没有可用的 Vue Inspector 钩子。挂件仍然可以正常聊天和同步 URL/标题，只是无法通过页面点选节点来辅助定位代码。
-
-### 构建产物里为什么没有挂件
-
-这是当前实现的预期行为。插件只在开发服务器模式下工作，不会影响生产构建结果。
-
-## 示例项目
-
-仓库自带了一个 `example` 工作区用于本地联调。
-
-由于示例直接引用 `../dist/vite/index`，请先在仓库根目录构建插件：
-
-```bash
-npm install
-npm run build
-cd example
-npm install
-npm run dev
-```
-
-## 开发
-
-```bash
-npm run build
-npm test
-```
-
-## License
-
-MIT
-
-## 相关链接
-
-- [OpenCode](https://opencode.ai)
-- [OpenCode GitHub](https://github.com/opencode-ai/opencode)
-- [Vite Plugin API](https://vite.dev/guide/api-plugin.html)

package/dist/constants.d.ts

@@ -1,74 +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 = 300000;
-/** 服务器检查间隔（毫秒） */
-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;
-    warmupChromeMcp: boolean;
-};

package/dist/constants.js

@@ -1,75 +0,0 @@
-/**
- * @fileoverview OpenCode 插件常量定义
- */
-/** ==================== 网络相关 ==================== */
-/** 默认主机名 */
-export const DEFAULT_HOSTNAME = "127.0.0.1";
-/** 默认 Web 服务端口 */
-export const DEFAULT_WEB_PORT = 4097;
-/** 服务器启动超时时间（毫秒） */
-export const SERVER_START_TIMEOUT = 300000;
-/** 服务器检查间隔（毫秒） */
-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: false,
-    webPort: DEFAULT_WEB_PORT,
-    hostname: DEFAULT_HOSTNAME,
-    position: "bottom-right",
-    theme: "auto",
-    open: false,
-    autoReload: true,
-    verbose: false,
-    hotkey: "ctrl+k",
-    warmupChromeMcp: true,
-};
-//# 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,CAAC;AAE5C,kBAAkB;AAClB,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,CAAC;AAErC,oBAAoB;AACpB,MAAM,CAAC,MAAM,oBAAoB,GAAG,MAAM,CAAC;AAE3C,kBAAkB;AAClB,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAG,CAAC;AAEzC,qDAAqD;AAErD,aAAa;AACb,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC;AAEjC,eAAe;AACf,MAAM,CAAC,MAAM,WAAW,GAAG,GAAG,CAAC;AAE/B,qDAAqD;AAErD,eAAe;AACf,MAAM,CAAC,MAAM,cAAc,GAAG,EAAE,CAAC;AAEjC,qDAAqD;AAErD,aAAa;AACb,MAAM,CAAC,MAAM,UAAU,GAAG,wBAAwB,CAAC;AAEnD,wBAAwB;AACxB,MAAM,CAAC,MAAM,cAAc,GAAG,gBAAgB,CAAC;AAE/C,0BAA0B;AAC1B,MAAM,CAAC,MAAM,gBAAgB,GAAG,sBAAsB,CAAC;AAEvD,qDAAqD;AAErD,aAAa;AACb,MAAM,CAAC,MAAM,kBAAkB,GAAG,yBAAyB,CAAC;AAE5D,cAAc;AACd,MAAM,CAAC,MAAM,gBAAgB,GAAG,sBAAsB,CAAC;AAEvD,iBAAiB;AACjB,MAAM,CAAC,MAAM,gBAAgB,GAAG,uBAAuB,CAAC;AAExD,gBAAgB;AAChB,MAAM,CAAC,MAAM,cAAc,GAAG,qBAAqB,CAAC;AAEpD,kBAAkB;AAClB,MAAM,CAAC,MAAM,iBAAiB,GAAG,wBAAwB,CAAC;AAE1D,gBAAgB;AAChB,MAAM,CAAC,MAAM,eAAe,GAAG,sBAAsB,CAAC;AAEtD,kBAAkB;AAClB,MAAM,CAAC,MAAM,uBAAuB,GAAG,GAAG,CAAC;AAE3C,kBAAkB;AAClB,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAI,CAAC;AAEzC,6BAA6B;AAC7B,MAAM,CAAC,MAAM,wBAAwB,GAAG,GAAG,CAAC;AAE5C,iBAAiB;AACjB,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,CAAC;AAEpC,iBAAiB;AACjB,MAAM,CAAC,MAAM,qBAAqB,GAAG,IAAI,CAAC;AAE1C,qDAAqD;AAErD,YAAY;AACZ,MAAM,CAAC,MAAM,WAAW,GAAG,0BAA0B,CAAC;AAEtD,cAAc;AACd,MAAM,CAAC,MAAM,qBAAqB,GAAG,gCAAgC,CAAC;AAEtE,qDAAqD;AAErD,iBAAiB;AACjB,MAAM,CAAC,MAAM,eAAe,GAAG,GAAG,CAAC;AAEnC,cAAc;AACd,MAAM,CAAC,MAAM,cAAc,GAAG,SAAS,CAAC;AAExC,qDAAqD;AAErD,aAAa;AACb,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,OAAO,EAAE,KAAK;IACd,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;IAChB,eAAe,EAAE,IAAI;CACtB,CAAC","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 = 300000;\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: false,\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  warmupChromeMcp: true,\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 {};