vg-print 1.1.304 → 1.1.305

package/README.en.md

@@ -32,6 +32,20 @@ https://download.csdn.net/download/github_38400706/92538739
 ```bash
 npm i vg-print
 ```
+If you need client direct printing (`hiwebSocket`), install the optional dependency in your host app:
+
+```bash
+npm i socket.io-client
+```
+
+In your main entry file (e.g., `main.ts`):
+
+```js
+import { io } from 'socket.io-client'
+import { setSocketIo } from 'vg-print'
+
+setSocketIo(io)
+```
 
 ## Header Component
 

package/README.md

@@ -106,6 +106,26 @@ hiprint.register({
 npm i vg-print
 ```
 
+### 可选依赖：直连打印/客户端连接（socket.io-client）
+
+- 本库默认不内置 `socket.io-client`，以减少默认安装体积。
+- 仅当你需要“直连打印/客户端连接（hiwebSocket）”能力（如 `print()` / `print2()` / 自动连接）时，才需要安装并注入：
+
+```bash
+npm i socket.io-client
+```
+
+在项目入口（如 `main.ts`）注入：
+
+```js
+import { io } from 'socket.io-client'
+import { setSocketIo } from 'vg-print'
+
+setSocketIo(io)
+```
+
+也可直接使用 `window.io = io`（等价）。
+
 ## Header 顶部工具栏组件
 
 - 用于页面一级头部区域，内置常用操作按钮与打印机设置；支持通过 `props` 与 `slots` 定制。
@@ -765,6 +785,8 @@ return (result.data || []).map(item => ({
 
 本库导出 `hiprint`，可直接创建与操作模板对象（`hiprint.PrintTemplate`）：
 
+若需要使用“直连打印/客户端连接（hiwebSocket）”相关能力，请先按上文注入 `io`；否则会提示缺失并导致连接失败。
+
 ```js
 import { hiprint, defaultElementTypeProvider } from 'vg-print'
 // 全局配置