agent-client-sdk 0.1.0

package/README.md

@@ -0,0 +1,199 @@
+# Agent Client SDK
+
+智能页面控制 Agent 的前端 SDK，提供与 Agent Server 的 WebSocket 通信能力，实现"所说即所得"的页面控制体验。
+
+## 安装
+
+```bash
+npm install agent-client-sdk
+```
+
+## 快速开始
+
+### 1. 初始化 SDK
+
+```typescript
+import { initAgent } from 'agent-client-sdk';
+
+initAgent({
+  serverUrl: 'ws://localhost:8987/ws/agent',
+  routes: [
+    { path: '/dashboard', name: '仪表盘', description: '系统数据总览' },
+    { path: '/users', name: '用户管理', description: '管理用户账号' },
+  ],
+});
+```
+
+### 2. 在组件中注册能力
+
+```vue
+<script setup lang="ts">
+import { useAgentForm, useAgentButton } from 'agent-client-sdk';
+
+// 注册表单能力
+useAgentForm(
+  'user-form',           // 组件ID
+  '用户信息表单',         // 组件名称
+  '用于编辑用户基本信息',  // 描述
+  ['name', 'email', 'phone'], // 字段列表
+  '#user-form'           // CSS选择器
+);
+
+// 注册按钮能力
+useAgentButton(
+  'submit-btn',
+  '提交按钮',
+  '提交表单数据'
+);
+</script>
+```
+
+## API 参考
+
+### 核心函数
+
+#### `initAgent(config: AgentConfig)`
+
+初始化 Agent SDK。
+
+**参数：**
+
+| 属性 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `serverUrl` | `string` | 是 | WebSocket 服务端地址 |
+| `routes` | `RouteInfo[]` | 否 | 应用路由表 |
+| `debug` | `boolean` | 否 | 是否开启调试日志 |
+
+#### `useAgentForm(id, name, description, fields, selector)`
+
+注册表单组件能力，让 Agent 能够操作该表单。
+
+#### `useAgentButton(id, name, description)`
+
+注册按钮组件能力，让 Agent 能够触发点击。
+
+#### `useAgentInput(id, name, description, selector)`
+
+注册输入框组件能力。
+
+#### `useAgentSelect(id, name, description, options, selector)`
+
+注册下拉选择框组件能力。
+
+### 类型定义
+
+```typescript
+interface AgentConfig {
+  serverUrl: string;
+  routes?: RouteInfo[];
+  debug?: boolean;
+}
+
+interface RouteInfo {
+  path: string;
+  name: string;
+  description?: string;
+}
+```
+
+## 完整示例
+
+```vue
+<template>
+  <div class="user-management">
+    <h1>用户管理</h1>
+
+    <form id="user-form" @submit.prevent="handleSubmit">
+      <div class="form-group">
+        <label>用户名</label>
+        <input v-model="form.username" id="username" />
+      </div>
+
+      <div class="form-group">
+        <label>邮箱</label>
+        <input v-model="form.email" id="email" type="email" />
+      </div>
+
+      <div class="form-group">
+        <label>角色</label>
+        <select v-model="form.role" id="role">
+          <option value="admin">管理员</option>
+          <option value="user">普通用户</option>
+        </select>
+      </div>
+
+      <button id="submit-btn" type="submit">保存</button>
+    </form>
+  </div>
+</template>
+
+<script setup lang="ts">
+import { reactive } from 'vue';
+import {
+  initAgent,
+  useAgentForm,
+  useAgentButton,
+  useAgentSelect,
+} from 'agent-client-sdk';
+
+// 初始化 Agent
+initAgent({
+  serverUrl: 'ws://localhost:8987/ws/agent',
+  routes: [
+    { path: '/users', name: '用户管理', description: '管理系统用户' },
+    { path: '/settings', name: '系统设置', description: '配置系统参数' },
+  ],
+  debug: true,
+});
+
+// 注册组件能力
+useAgentForm(
+  'user-form',
+  '用户表单',
+  '用于创建或编辑用户信息',
+  ['username', 'email', 'role'],
+  '#user-form'
+);
+
+useAgentSelect(
+  'role-select',
+  '角色选择',
+  '选择用户角色',
+  [
+    { value: 'admin', label: '管理员' },
+    { value: 'user', label: '普通用户' },
+  ],
+  '#role'
+);
+
+useAgentButton('submit-btn', '保存按钮', '提交表单保存用户数据');
+
+// 表单数据
+const form = reactive({
+  username: '',
+  email: '',
+  role: 'user',
+});
+
+const handleSubmit = () => {
+  console.log('提交表单:', form);
+  // 发送请求...
+};
+</script>
+</template>
+```
+
+## 调试
+
+开启调试模式查看详细日志：
+
+```typescript
+initAgent({
+  serverUrl: 'ws://localhost:8987/ws/agent',
+  debug: true, // 开启调试
+});
+```
+
+## License
+
+MIT

package/dist/composables/useAgent.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Agent全局状态管理组合式函数
+ *
+ * 提供响应式的连接状态、聊天记录等全局状态
+ */
+import { type Ref, type DeepReadonly } from 'vue';
+import { AgentClient } from '../core/AgentClient';
+import { AgentClientConfig, ConnectionStatus, ChatMessage } from '../core/types';
+export interface UseAgentReturn {
+    /** 连接状态 */
+    status: DeepReadonly<Ref<ConnectionStatus>>;
+    /** 是否已连接 */
+    isConnected: DeepReadonly<Ref<boolean>>;
+    /** 聊天记录 */
+    messages: DeepReadonly<Ref<ChatMessage[]>>;
+    /** 发送消息 */
+    sendMessage: (text: string) => void;
+    /** 清空聊天记录 */
+    clearMessages: () => void;
+    /** 连接 */
+    connect: () => void;
+    /** 断开连接 */
+    disconnect: () => void;
+}
+/**
+ * 使用Agent全局状态
+ *
+ * @param config - 可选的配置，仅在首次调用时生效
+ * @returns Agent状态和操作方法
+ *
+ * @example
+ * ```ts
+ * // 在main.ts中初始化
+ * const { connect } = useAgent({
+ *   serverUrl: 'ws://localhost:8987/ws/agent',
+ *   routes: [...]
+ * });
+ * connect();
+ *
+ * // 在组件中使用
+ * const { status, messages, sendMessage } = useAgent();
+ * ```
+ */
+export declare function useAgent(config?: AgentClientConfig): UseAgentReturn;
+/**
+ * 初始化AgentClient
+ *
+ * 应在应用入口（如main.ts）中调用一次
+ *
+ * @param config - SDK配置
+ * @returns AgentClient实例
+ *
+ * @example
+ * ```ts
+ * // main.ts
+ * import { createApp } from 'vue';
+ * import { initAgent } from 'agent-client-sdk';
+ * import App from './App.vue';
+ * import router from './router';
+ *
+ * const app = createApp(App);
+ * app.use(router);
+ *
+ * // 初始化Agent
+ * initAgent({
+ *   serverUrl: 'ws://localhost:8987/ws/agent',
+ *   routes: router.getRoutes().map(r => ({
+ *     path: r.path,
+ *     name: String(r.name || r.path),
+ *     title: r.meta?.title || String(r.name || r.path)
+ *   })),
+ *   debug: true
+ * });
+ *
+ * app.mount('#app');
+ * ```
+ */
+export declare function initAgent(config: AgentClientConfig): AgentClient;
+//# sourceMappingURL=useAgent.d.ts.map

package/dist/composables/useAgent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAgent.d.ts","sourceRoot":"","sources":["../../src/composables/useAgent.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAwC,KAAK,GAAG,EAAE,KAAK,YAAY,EAAE,MAAM,KAAK,CAAC;AACxF,OAAO,EACL,WAAW,EAGZ,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,WAAW,EAEZ,MAAM,eAAe,CAAC;AAOvB,MAAM,WAAW,cAAc;IAC7B,WAAW;IACX,MAAM,EAAE,YAAY,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC,CAAC;IAC5C,YAAY;IACZ,WAAW,EAAE,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;IACxC,WAAW;IACX,QAAQ,EAAE,YAAY,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;IAC3C,WAAW;IACX,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,aAAa;IACb,aAAa,EAAE,MAAM,IAAI,CAAC;IAC1B,SAAS;IACT,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,WAAW;IACX,UAAU,EAAE,MAAM,IAAI,CAAC;CACxB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,QAAQ,CAAC,MAAM,CAAC,EAAE,iBAAiB,GAAG,cAAc,CA6DnE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,iBAAiB,GAAG,WAAW,CAsBhE"}

package/dist/composables/useAgentAction.d.ts

@@ -0,0 +1,140 @@
+/**
+ * 组件能力注册组合式函数
+ *
+ * 在Vue组件中注册页面能力，供Agent调用
+ */
+import { PageCapability, RouteInfo } from '../core/types';
+export interface UseAgentActionOptions {
+    /** 是否在挂载时自动注册 */
+    autoRegister?: boolean;
+    /** 是否在卸载时自动注销 */
+    autoUnregister?: boolean;
+    /** 当前路由信息 */
+    route?: RouteInfo;
+}
+/**
+ * 注册组件能力给Agent
+ *
+ * 在组件挂载时自动注册能力，卸载时自动注销
+ *
+ * @param capabilities - 页面能力列表
+ * @param options - 配置选项
+ *
+ * @example
+ * ```vue
+ * <script setup>
+ * import { useAgentAction } from 'agent-client-sdk';
+ *
+ * // 注册表单能力
+ * useAgentAction([
+ *   {
+ *     id: 'profile-form',
+ *     type: 'form',
+ *     name: '个人资料表单',
+ *     description: '用于编辑用户个人资料信息',
+ *     selector: '#profile-form',
+ *     actions: ['fill', 'submit'],
+ *     metadata: {
+ *       fields: ['name', 'email', 'phone']
+ *     }
+ *   }
+ * ]);
+ * </script>
+ *
+ * <template>
+ *   <form id="profile-form">
+ *     <input name="name" />
+ *     <input name="email" />
+ *     <button type="submit">保存</button>
+ *   </form>
+ * </template>
+ * ```
+ */
+export declare function useAgentAction(capabilities: PageCapability[], options?: UseAgentActionOptions): {
+    /** 手动注册能力 */
+    register: () => void;
+    /** 手动注销能力 */
+    unregister: () => void;
+    /** 更新能力 */
+    update: (newCapabilities: PageCapability[]) => void;
+};
+/**
+ * 注册按钮能力
+ *
+ * 便捷方法，用于快速注册按钮点击能力
+ *
+ * @param id - 按钮ID
+ * @param name - 按钮名称
+ * @param description - 按钮描述
+ * @param selector - CSS选择器（可选，默认使用ID）
+ *
+ * @example
+ * ```vue
+ * <script setup>
+ * import { useAgentButton } from 'agent-client-sdk';
+ *
+ * useAgentButton('save-btn', '保存按钮', '点击保存表单数据');
+ * </script>
+ *
+ * <template>
+ *   <button id="save-btn">保存</button>
+ * </template>
+ * ```
+ */
+export declare function useAgentButton(id: string, name: string, description: string, selector?: string): void;
+/**
+ * 注册表单能力
+ *
+ * 便捷方法，用于快速注册表单填充能力
+ *
+ * @param id - 表单ID
+ * @param name - 表单名称
+ * @param description - 表单描述
+ * @param fields - 表单字段列表
+ * @param selector - CSS选择器（可选，默认使用ID）
+ * @param options - 额外选项
+ *
+ * @example
+ * ```vue
+ * <script setup>
+ * import { useAgentForm } from 'agent-client-sdk';
+ *
+ * useAgentForm(
+ *   'profile-form',
+ *   '个人资料表单',
+ *   '编辑用户个人资料',
+ *   ['name', 'email', 'phone'],
+ *   '#profile-form',
+ *   { canSubmit: true }
+ * );
+ * </script>
+ * ```
+ */
+export declare function useAgentForm(id: string, name: string, description: string, fields: string[], selector?: string, options?: {
+    canSubmit?: boolean;
+}): void;
+/**
+ * 注册输入框能力
+ *
+ * 便捷方法，用于快速注册输入框设置值能力
+ *
+ * @param id - 输入框ID
+ * @param name - 输入框名称
+ * @param description - 输入框描述
+ * @param selector - CSS选择器（可选，默认使用ID）
+ *
+ * @example
+ * ```vue
+ * <script setup>
+ * import { useAgentInput } from 'agent-client-sdk';
+ *
+ * useAgentInput('username', '用户名', '输入用户名');
+ * </script>
+ *
+ * <template>
+ *   <input id="username" name="username" />
+ * </template>
+ * ```
+ */
+export declare function useAgentInput(id: string, name: string, description: string, selector?: string): void;
+//# sourceMappingURL=useAgentAction.d.ts.map

package/dist/composables/useAgentAction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAgentAction.d.ts","sourceRoot":"","sources":["../../src/composables/useAgentAction.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE1D,MAAM,WAAW,qBAAqB;IACpC,iBAAiB;IACjB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,iBAAiB;IACjB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,aAAa;IACb,KAAK,CAAC,EAAE,SAAS,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,wBAAgB,cAAc,CAC5B,YAAY,EAAE,cAAc,EAAE,EAC9B,OAAO,GAAE,qBAA0B,GAClC;IACD,aAAa;IACb,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,aAAa;IACb,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,WAAW;IACX,MAAM,EAAE,CAAC,eAAe,EAAE,cAAc,EAAE,KAAK,IAAI,CAAC;CACrD,CAgFA;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,cAAc,CAC5B,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,QAAQ,CAAC,EAAE,MAAM,GAChB,IAAI,CAWN;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,YAAY,CAC1B,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EAAE,EAChB,QAAQ,CAAC,EAAE,MAAM,EACjB,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,OAAO,CAAA;CAAO,GACpC,IAAI,CAiBN;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,aAAa,CAC3B,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,QAAQ,CAAC,EAAE,MAAM,GAChB,IAAI,CAWN"}

package/dist/core/AgentClient.d.ts

@@ -0,0 +1,141 @@
+/**
+ * Agent客户端核心类
+ *
+ * 管理WebSocket连接、消息收发、命令执行
+ */
+import { AgentClientConfig, ConnectionStatus, WebSocketMessage, RouteInfo, PageCapability, ChatMessage, CommandHandler } from './types';
+export declare class AgentClient {
+    private ws;
+    private config;
+    private status;
+    private reconnectAttempts;
+    private reconnectTimer;
+    private heartbeatTimer;
+    private sessionId;
+    private messageListeners;
+    private statusListeners;
+    private commandHandlers;
+    private chatMessages;
+    private messageListenersChat;
+    private pendingCommands;
+    private messageQueue;
+    private static readonly DEFAULT_CONFIG;
+    constructor(config: AgentClientConfig);
+    /**
+     * 生成会话ID
+     */
+    private generateSessionId;
+    /**
+     * 日志输出
+     */
+    private log;
+    /**
+     * 注册默认命令处理器
+     */
+    private registerDefaultCommandHandlers;
+    /**
+     * 连接到WebSocket服务器
+     */
+    connect(): void;
+    /**
+     * 断开连接
+     */
+    disconnect(): void;
+    /**
+     * 尝试重连
+     */
+    private attemptReconnect;
+    /**
+     * 清除重连定时器
+     */
+    private clearReconnectTimer;
+    /**
+     * 启动心跳
+     */
+    private startHeartbeat;
+    /**
+     * 停止心跳
+     */
+    private stopHeartbeat;
+    /**
+     * 发送握手消息
+     */
+    private sendHandshake;
+    /**
+     * 发送消息
+     */
+    sendMessage(message: WebSocketMessage): boolean;
+    /**
+     * 处理接收到的消息
+     */
+    private handleMessage;
+    /**
+     * 处理Agent消息
+     */
+    private handleAgentMessage;
+    /**
+     * 处理Agent控制指令
+     */
+    private handleAgentCommand;
+    /**
+     * 发送用户输入
+     */
+    sendInput(text: string, context?: Record<string, any>): void;
+    /**
+     * 更新页面能力
+     */
+    updateCapabilities(action: 'mount' | 'unmount' | 'update' | 'route_change', currentRoute?: RouteInfo, capabilities?: PageCapability[]): void;
+    /**
+     * 设置连接状态
+     */
+    private setStatus;
+    /**
+     * 获取当前连接状态
+     */
+    getStatus(): ConnectionStatus;
+    /**
+     * 获取会话ID
+     */
+    getSessionId(): string;
+    /**
+     * 获取聊天记录
+     */
+    getChatMessages(): ChatMessage[];
+    /**
+     * 清空聊天记录
+     */
+    clearChatMessages(): void;
+    /**
+     * 注册消息监听器
+     */
+    onMessage(listener: (message: WebSocketMessage) => void): () => void;
+    /**
+     * 注册状态监听器
+     */
+    onStatusChange(listener: (status: ConnectionStatus) => void): () => void;
+    /**
+     * 注册聊天消息监听器
+     */
+    onChatMessages(listener: (messages: ChatMessage[]) => void): () => void;
+    /**
+     * 通知聊天监听器
+     */
+    private notifyChatListeners;
+    /**
+     * 注册自定义命令处理器
+     */
+    registerCommandHandler(action: string, handler: CommandHandler): void;
+    /**
+     * 注销命令处理器
+     */
+    unregisterCommandHandler(action: string): void;
+}
+/**
+ * 获取全局AgentClient实例
+ */
+export declare function getGlobalClient(): AgentClient | null;
+/**
+ * 设置全局AgentClient实例
+ */
+export declare function setGlobalClient(client: AgentClient): void;
+//# sourceMappingURL=AgentClient.d.ts.map

package/dist/core/AgentClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentClient.d.ts","sourceRoot":"","sources":["../../src/core/AgentClient.ts"],"names":[],"mappings":"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"}

package/dist/core/types.d.ts

@@ -0,0 +1,97 @@
+/**
+ * 类型定义
+ */
+/** 路由信息 */
+export interface RouteInfo {
+    path: string;
+    name: string;
+    title: string;
+    meta?: Record<string, any>;
+}
+/** 页面能力 */
+export interface PageCapability {
+    id: string;
+    type: 'form' | 'button' | 'input' | 'table' | 'select' | 'other';
+    name: string;
+    description: string;
+    selector: string;
+    actions: string[];
+    metadata?: Record<string, any>;
+}
+/** 消息类型 */
+export declare enum MessageType {
+    CLIENT_HANDSHAKE = "CLIENT_HANDSHAKE",
+    CLIENT_UPDATE = "CLIENT_UPDATE",
+    CLIENT_INPUT = "CLIENT_INPUT",
+    CLIENT_RESULT = "CLIENT_RESULT",
+    CLIENT_HEARTBEAT = "CLIENT_HEARTBEAT",
+    AGENT_MESSAGE = "AGENT_MESSAGE",
+    AGENT_COMMAND = "AGENT_COMMAND",
+    SERVER_ACK = "SERVER_ACK",
+    SERVER_ERROR = "SERVER_ERROR",
+    SERVER_HEARTBEAT = "SERVER_HEARTBEAT"
+}
+/** WebSocket消息 */
+export interface WebSocketMessage {
+    type: MessageType;
+    sessionId: string;
+    timestamp: string;
+    payload?: any;
+}
+/** Agent控制指令 */
+export interface AgentCommand {
+    commandId: string;
+    action: 'navigate' | 'fillForm' | 'click' | 'setValue' | 'scroll';
+    target: string;
+    params?: Record<string, any>;
+    description: string;
+}
+/** Agent消息 */
+export interface AgentMessage {
+    text: string;
+    type: 'text' | 'markdown' | 'html';
+    suggestions?: string[];
+}
+/** SDK配置 */
+export interface AgentClientConfig {
+    /** WebSocket服务器地址 */
+    serverUrl: string;
+    /** 应用路由列表 */
+    routes: RouteInfo[];
+    /** 自动重连间隔（毫秒） */
+    reconnectInterval?: number;
+    /** 最大重连次数 */
+    maxReconnectAttempts?: number;
+    /** 心跳间隔（毫秒） */
+    heartbeatInterval?: number;
+    /** 调试模式 */
+    debug?: boolean;
+    /** 会话ID（可选，不提供则自动生成） */
+    sessionId?: string;
+}
+/** 聊天消息 */
+export interface ChatMessage {
+    id: string;
+    role: 'user' | 'agent';
+    content: string;
+    timestamp: number;
+    type?: 'text' | 'command';
+    command?: AgentCommand;
+}
+/** 连接状态 */
+export declare enum ConnectionStatus {
+    DISCONNECTED = "disconnected",
+    CONNECTING = "connecting",
+    CONNECTED = "connected",
+    RECONNECTING = "reconnecting",
+    ERROR = "error"
+}
+/** 命令执行结果 */
+export interface CommandResult {
+    success: boolean;
+    result?: any;
+    error?: string;
+}
+/** 命令处理器 */
+export type CommandHandler = (command: AgentCommand) => Promise<CommandResult> | CommandResult;
+//# sourceMappingURL=types.d.ts.map

package/dist/core/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Agent Client SDK
+ *
+ * 智能页面控制Agent前端SDK
+ * 提供WebSocket连接管理、页面能力注册、命令执行等功能
+ */
+export { AgentClient, getGlobalClient, setGlobalClient } from './core/AgentClient';
+export { useAgent, initAgent, type UseAgentReturn } from './composables/useAgent';
+export { useAgentAction, useAgentButton, useAgentForm, useAgentInput, type UseAgentActionOptions, } from './composables/useAgentAction';
+export { MessageType, ConnectionStatus, type RouteInfo, type PageCapability, type WebSocketMessage, type AgentCommand, type AgentMessage, type AgentClientConfig, type ChatMessage, type CommandResult, type CommandHandler, } from './core/types';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAGnF,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAClF,OAAO,EACL,cAAc,EACd,cAAc,EACd,YAAY,EACZ,aAAa,EACb,KAAK,qBAAqB,GAC3B,MAAM,8BAA8B,CAAC;AAGtC,OAAO,EAEL,WAAW,EACX,gBAAgB,EAGhB,KAAK,SAAS,EACd,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,cAAc,GACpB,MAAM,cAAc,CAAC"}