refactor: rename print SDK to printer across repo

Author: hackycy

docs/advanced/print-drivers.md

@@ -292,7 +292,7 @@ context.onDiagnostic?.({
 
 ## Playground 参考
 
-Playground 已迁移到高层 print SDK，不再维护业务侧驱动包装。可以直接对照两个 hook：
+Playground 已迁移到高层打印器，不再维护业务侧驱动包装。可以直接对照两个 hook：
 
-- `playground/src/hooks/useEasyInkPrint.ts`：创建 EasyInk Printer client 和托管 print SDK
-- `playground/src/hooks/useHiPrint.ts`：创建 HiPrint client 和托管 print SDK
+- `playground/src/hooks/useEasyInkPrint.ts`：创建 EasyInk Printer client 和托管打印器
+- `playground/src/hooks/useHiPrint.ts`：创建 HiPrint client 和托管打印器

docs/dotnet/getting-started.md

@@ -6,7 +6,7 @@ EasyInk Printer 是 Windows 本地静默打印服务，适合需要稳定 PDF 
 
 1. 在 Windows 机器上启动 `EasyInk.Printer.exe`。
 2. 确认服务已经能返回打印机列表。
-3. 前端创建 `@easyink/print-integration-easyink-printer` 的 print SDK。
+3. 前端创建 `@easyink/print-integration-easyink-printer` 的打印器。
 4. 调用 `printer.print({ schema, data })`。
 
 这篇文档只覆盖浏览器如何接入本地打印服务。如果你要部署、配置端口或启用 API Key，继续看 [Printer 应用](./printer) 和 [API 参考](./api-reference)。
@@ -58,18 +58,18 @@ curl http://localhost:18080/api/printers
 - 端口是否被改过
 - 当前机器是否真的安装了打印机驱动
 
-## 第四步：创建 SDK 并打印
+## 第四步：创建打印器并打印
 
 ```ts
-import { createEasyInkPrinterClient, createEasyInkPrinterPrintSdk } from '@easyink/print-integration-easyink-printer'
+import { createEasyInkPrinterClient, createEasyInkPrinter } from '@easyink/print-integration-easyink-printer'
 
 const client = createEasyInkPrinterClient({
   serviceUrl: 'http://localhost:18080',
   reconnect: true,
   maxReconnectAttempts: 3,
 })
 
-const printer = createEasyInkPrinterPrintSdk({
+const printer = createEasyInkPrinter({
   client,
   viewer: 'iframe',
 })
@@ -78,13 +78,13 @@ await client.useDefaultPrinter()
 await printer.print({ schema, data })
 ```
 
-`createEasyInkPrinterPrintSdk()` 默认使用 `pageSizeMode: 'fixed'`，会自动创建托管 Viewer、把页面生成 PDF，再发送给 EasyInk.Printer。调用方不用再处理 Viewer 生命周期、PDF 导出插件、WebSocket 二进制帧、分块上传或任务轮询。
+`createEasyInkPrinter()` 默认使用 `pageSizeMode: 'fixed'`，会自动创建托管 Viewer、把页面生成 PDF，再发送给 EasyInk.Printer。调用方不用再处理 Viewer 生命周期、PDF 导出插件、WebSocket 二进制帧、分块上传或任务轮询。
 
 客户端内部使用 VueUse 的 `useWebSocket` 管理长连接。连接意外断开时会进入 `reconnecting`，按配置重试；达到最大重连次数后进入 `error`，并把原因写入 `lastError`。
 
 如果这段代码跑通，意味着下面几层都已经工作正常：
 
-- SDK 已经用托管 Viewer 渲染出页面
+- 打印器已经用托管 Viewer 渲染出页面
 - 前端能连接本地打印服务
 - 本地服务能选中打印机并创建任务
 - PDF 生成和上传链路没有问题
@@ -101,7 +101,7 @@ const client = createEasyInkPrinterClient({
   defaultCopies: settings.copies,
 })
 
-const printer = createEasyInkPrinterPrintSdk({
+const printer = createEasyInkPrinter({
   client,
   viewer: 'iframe',
   printerName: () => settings.printerName,
@@ -119,14 +119,14 @@ const printer = createEasyInkPrinterPrintSdk({
 await printer.print({ schema, data })
 ```
 
-这里推荐传函数而不是静态值。原因是用户切换打印机或份数后，不需要重新创建 SDK。
+这里推荐传函数而不是静态值。原因是用户切换打印机或份数后，不需要重新创建打印器。
 
 这里的参数可以分成两类来看：
 
 - `serviceUrl`、`apiKey`、重连参数属于“怎么连服务”
 - `printerName`、`copies`、`forcePageSize`、`dpi`、`userData` 属于“这次打印怎么投递”
 
-如果服务端启用了 API Key，前端只需要在创建客户端时传 `apiKey`。SDK 会自动把它带到 HTTP Header 和 WebSocket 查询参数里，不需要业务代码自己拼认证逻辑。
+如果服务端启用了 API Key，前端只需要在创建客户端时传 `apiKey`。客户端会自动把它带到 HTTP Header 和 WebSocket 查询参数里，不需要业务代码自己拼认证逻辑。
 
 ## 业务里最常用的打印参数
 
@@ -253,7 +253,7 @@ await printer.printPdfAndWait(file, {
 标签机必须显式按模板尺寸打印时再开启：
 
 ```ts
-const printer = createEasyInkPrinterPrintSdk({
+const printer = createEasyInkPrinter({
   client,
   viewer: 'iframe',
   forcePageSize: true,
@@ -277,7 +277,7 @@ const printer = createEasyInkPrinterPrintSdk({
 Playground 已使用官方包集成：
 
 - [playground/src/hooks/useEasyInkPrint.ts](../../playground/src/hooks/useEasyInkPrint.ts) 只保留 Vue 状态和设置持久化
-- 预览页调用 hook 暴露的 `easyInkPrint.print({ schema, data })`，由 SDK 自动创建和销毁托管 Viewer
+- 预览页调用 hook 暴露的 `easyInkPrint.print({ schema, data })`，由打印器自动创建和销毁托管 Viewer
 - Playground 的 EasyInk Printer 设置面板里还提供了 `UserId` 和 `LabelType` 演示字段，方便直接验证审计日志链路
 
 ## 常见问题

docs/hiprint/getting-started.md

@@ -9,7 +9,7 @@ HiPrint 通道适合跨平台静默打印，尤其适合标签、小票、卡片
 
 1. 启动 electron-hiprint。
 2. 确认本机能刷新到打印机列表。
-3. 前端创建 `@easyink/print-integration-hiprint` 的 print SDK。
+3. 前端创建 `@easyink/print-integration-hiprint` 的打印器。
 4. 调用 `printer.print({ schema, data })`。
 
 这篇文档只讲浏览器如何接入 HiPrint。electron-hiprint 本身的安装和系统打印驱动问题，仍然以它的发行包和操作系统配置为准。
@@ -44,16 +44,16 @@ console.log(printers)
 
 如果这里拿不到打印机，优先排查本地环境，而不是继续调模板渲染。
 
-## 第四步：创建 SDK 并打印
+## 第四步：创建打印器并打印
 
 ```ts
-import { createHiPrintClient, createHiPrintPrintSdk } from '@easyink/print-integration-hiprint'
+import { createHiPrintClient, createHiPrintPrinter } from '@easyink/print-integration-hiprint'
 
 const hiPrint = createHiPrintClient({
   serviceUrl: 'http://localhost:17521',
 })
 
-const printer = createHiPrintPrintSdk({
+const printer = createHiPrintPrinter({
   client: hiPrint,
   viewer: 'iframe',
 })
@@ -62,11 +62,11 @@ await hiPrint.useDefaultPrinter()
 await printer.print({ schema, data })
 ```
 
-`createHiPrintPrintSdk()` 默认使用 `pageSizeMode: 'driver'`，适合小票机、连续纸和由驱动决定介质的场景。用户只需要选择打印机，不需要理解 Viewer 的底层打印策略。
+`createHiPrintPrinter()` 默认使用 `pageSizeMode: 'driver'`，适合小票机、连续纸和由驱动决定介质的场景。用户只需要选择打印机，不需要理解 Viewer 的底层打印策略。
 
 如果这段代码能跑通，说明这条链路已经成立：
 
-- SDK 已经用托管 Viewer 渲染出可打印页面
+- 打印器已经用托管 Viewer 渲染出可打印页面
 - electron-hiprint 已建立连接
 - 当前机器能发现系统打印机
 - HiPrint 已经按页提交 HTML 到本地打印运行时
@@ -78,7 +78,7 @@ await printer.print({ schema, data })
 ```ts
 import { hiprint } from 'vue-plugin-hiprint'
 import {
-  createHiPrintPrintSdk,
+  createHiPrintPrinter,
   createHiPrintRuntimeClient,
 } from '@easyink/print-integration-hiprint'
 
@@ -89,7 +89,7 @@ const hiPrint = createHiPrintRuntimeClient({
   forcePageSize: settings.forcePageSize,
 })
 
-const printer = createHiPrintPrintSdk({
+const printer = createHiPrintPrinter({
   client: hiPrint,
   viewer: 'iframe',
   resolveRequestOptions: () => ({
@@ -131,7 +131,7 @@ const hiPrint = createHiPrintClient({
   defaultCopies: settings.copies,
 })
 
-const printer = createHiPrintPrintSdk({
+const printer = createHiPrintPrinter({
   client: hiPrint,
   viewer: 'iframe',
   printerName: () => settings.printerName,
@@ -184,14 +184,14 @@ await printer.print({ schema, data })
 Playground 已使用官方包集成：
 
 - [playground/src/hooks/useHiPrint.ts](../../playground/src/hooks/useHiPrint.ts) 只保留 Vue 状态和设置持久化
-- 预览页调用 hook 暴露的 `hiPrint.print({ schema, data })`，由 SDK 自动创建和销毁托管 Viewer
+- 预览页调用 hook 暴露的 `hiPrint.print({ schema, data })`，由打印器自动创建和销毁托管 Viewer
 
 ## 常见问题
 
 **连接超时**：确认 electron-hiprint 客户端已启动并监听 17521 端口。
 
 **未发现打印机**：先确认系统打印机已正常安装，再调用 `hiPrint.refreshPrinters()`；如果这里拿不到设备，问题通常不在模板渲染。
 
-**标签内容缩印到 A4**：确认当前打印任务需要显式纸张尺寸时，调用 `hiPrint.setForcePageSize(true)` 或在 SDK 配置里传 `forcePageSize`。
+**标签内容缩印到 A4**：确认当前打印任务需要显式纸张尺寸时，调用 `hiPrint.setForcePageSize(true)` 或在打印器配置里传 `forcePageSize`。
 
 **第一张单应该怎么验收**：最小验收标准不是前端 Promise resolve，而是设备确实打印出预期尺寸的纸张，且没有被驱动缩放到默认 A4。

docs/printing/index.md

@@ -15,7 +15,7 @@ EasyInk 的本地打印目标很明确：让业务代码只关心“打印什么
 
 1. 安装对应的打印包。
 2. 创建打印客户端，管理连接地址、默认打印机和份数。
-3. 创建对应的 print SDK，选择 `viewer: 'iframe'` 或 `viewer: 'dom'`。
+3. 创建对应的打印器，选择 `viewer: 'iframe'` 或 `viewer: 'dom'`。
 4. 调用 `printer.print({ schema, data })`。
 5. 在设置页暴露打印机列表、连接状态和错误信息。
 
@@ -36,7 +36,7 @@ EasyInk 的本地打印目标很明确：让业务代码只关心“打印什么
 | **渲染质量** | 适合对矢量质量要求高的正式单据 | 适合标签、小票、跨平台打印 |
 | **通信方式** | HTTP + WebSocket | WebSocket |
 | **典型场景** | 面单、正式报表、A4 文档 | 小票、标签、嵌入 Electron 的桌面应用 |
-| **SDK 默认 pageSizeMode** | `fixed` | `driver` |
+| **打印器默认 pageSizeMode** | `fixed` | `driver` |
 | **官方包** | `@easyink/print-integration-easyink-printer` | `@easyink/print-integration-hiprint` |
 
 ## 如何选择
@@ -55,7 +55,7 @@ EasyInk 的本地打印目标很明确：让业务代码只关心“打印什么
 
 ### 不要自己实现驱动的情况
 
-如果你的打印目标只是“把 schema/data 打给本地服务”，官方 SDK 已经覆盖了绝大多数需求。只有在下面这些情况才建议写自定义驱动：
+如果你的打印目标只是“把 schema/data 打给本地服务”，官方打印器已经覆盖了绝大多数需求。只有在下面这些情况才建议写自定义驱动：
 
 - 你有独立的企业打印网关，需要走自定义协议。
 - 你要接专用硬件或厂商 SDK。
@@ -67,7 +67,7 @@ EasyInk 的本地打印目标很明确：让业务代码只关心“打印什么
 
 ```ts
 const client = createEasyInkPrinterClient(...)
-const printer = createEasyInkPrinterPrintSdk({
+const printer = createEasyInkPrinter({
   client,
   viewer: 'iframe',
 })
@@ -91,7 +91,7 @@ export function usePrintService() {
 
 这样做的原因有两个：
 
-- print SDK 负责“本次 schema/data 如何渲染并提交”，不负责“配置存在哪、何时重连”。
+- 打印器负责“本次 schema/data 如何渲染并提交”，不负责“配置存在哪、何时重连”。
 - 打印设置页、诊断页、预览页都能共享同一份连接状态。
 
 EasyInk Printer 官方客户端内部使用 VueUse `useWebSocket` 管理长连接。默认会自动重连 3 次，初始延迟 500ms，按 2 倍退避，最大延迟 5000ms；达到上限后进入 `error`，错误信息写入 `lastError`。

packages/print/core/README.md

@@ -1,9 +1,9 @@
 # @easyink/print-core
 
-Shared utilities for EasyInk print SDKs.
+Shared utilities for EasyInk printers.
 
 This package is intended for official and custom print integration packages. It
 contains shared unit conversion, Viewer page extraction, diagnostics mapping,
-and the managed `iframe` / `dom` Viewer lifecycle used by high-level print SDKs.
+and the managed `iframe` / `dom` Viewer lifecycle used by high-level printers.
 Application code usually consumes `@easyink/print-integration-easyink-printer`
 or `@easyink/print-integration-hiprint` instead.

packages/print/core/src/index.ts

@@ -49,7 +49,7 @@ export interface PrintDriverBaseOptions<TClient, TRequestOptions> {
 }
 
 /**
- * Selects the managed rendering surface used by high-level print SDKs.
+ * Selects the managed rendering surface used by high-level printers.
  *
  * - `iframe`: isolated document, default and recommended for production.
  * - `dom`: regular DOM element in the current document, useful for tests or
@@ -235,8 +235,8 @@ export function resolvePrintDriverValue<T>(value: PrintDriverValue<T> | undefine
 }
 
 /**
- * Creates a small managed Viewer runtime for print SDKs. Application code can
- * stay focused on client connection + print input while the SDK owns the
+ * Creates a small managed Viewer runtime for printers. Application code can
+ * stay focused on client connection + print input while the printer owns the
  * transient render surface.
  */
 export function createManagedPrintViewer(options: ManagedPrintViewerOptions = {}): ManagedPrintViewer {

packages/print/integration-easyink-printer/README.md

@@ -1,19 +1,19 @@
 # @easyink/print-integration-easyink-printer
 
-Official EasyInk Printer client and managed print SDK.
+Official EasyInk Printer client and managed document printer.
 
 ```ts
 import {
+  createEasyInkPrinter,
   createEasyInkPrinterClient,
-  createEasyInkPrinterPrintSdk,
 } from '@easyink/print-integration-easyink-printer'
 
 const client = createEasyInkPrinterClient({
   serviceUrl: 'http://localhost:18080',
   reconnect: true,
 })
 
-const printer = createEasyInkPrinterPrintSdk({
+const printer = createEasyInkPrinter({
   client,
   viewer: 'iframe',
 })
@@ -33,7 +33,7 @@ await printer.print({
 })
 ```
 
-The SDK owns the Viewer render lifecycle and PDF pipeline. Each `print()` call
+The printer owns the Viewer render lifecycle and PDF pipeline. Each `print()` call
 creates the configured render surface, opens the schema/data, renders Viewer
 pages to PDF, uploads the PDF through EasyInk Printer, waits for completion by
 default, and destroys the render surface.

packages/print/integration-easyink-printer/package.json

@@ -2,7 +2,7 @@
   "name": "@easyink/print-integration-easyink-printer",
   "type": "module",
   "version": "0.0.13",
-  "description": "Official EasyInk Printer client and managed EasyInk print SDK",
+  "description": "Official EasyInk Printer client and managed document printer",
   "author": "hackycy <hackycy@outlook.com>",
   "license": "MIT",
   "publishConfig": {

packages/print/integration-easyink-printer/src/index.ts

@@ -13,8 +13,8 @@ export {
 } from './client'
 
 export {
-  createEasyInkPrinterPrintSdk,
-  type EasyInkPrinterPrintInput,
-  type EasyInkPrinterPrintSdk,
-  type EasyInkPrinterPrintSdkOptions,
+  createEasyInkPrinter,
+  type EasyInkPrinter,
+  type EasyInkPrinterOptions,
+  type EasyInkPrinterPrintRequest,
 } from './sdk'

packages/print/integration-easyink-printer/src/sdk.test.ts

@@ -1,6 +1,6 @@
 import type { DocumentSchema } from '@easyink/viewer'
 import { beforeEach, describe, expect, it, vi } from 'vitest'
-import { createEasyInkPrinterPrintSdk } from './sdk'
+import { createEasyInkPrinter } from './sdk'
 
 const { renderPagesToPdfBlob } = vi.hoisted(() => ({
   renderPagesToPdfBlob: vi.fn(async () => new Blob(['pdf'])),
@@ -28,21 +28,21 @@ beforeEach(() => {
   renderPagesToPdfBlob.mockClear()
 })
 
-describe('easy ink printer print sdk', () => {
+describe('easy ink printer', () => {
   it('creates the managed viewer, renders PDF, and submits the job', async () => {
     const client = {
       printPdf: vi.fn(async () => 'job-12345678'),
       waitForJob: vi.fn(async () => ({ jobId: 'job-12345678', status: 'completed' })),
     }
-    const sdk = createEasyInkPrinterPrintSdk({
+    const printer = createEasyInkPrinter({
       client: client as never,
       viewer: 'dom',
       printerName: () => 'Printer A',
       copies: () => 3,
       forcePageSize: () => true,
     })
 
-    await sdk.print({
+    await printer.print({
       schema: createFixedSchema(),
       data: {},
     })