tauri-plugin-thermal-printer 1.3.1 → 1.3.3

package/README.md

@@ -90,7 +90,7 @@ pub fn generate_document(&mut self, print_job: &PrintJobRequest) -> Result<Vec<u
 #### 4. **OS Integration** (`src/desktop_printers/` and `android/`)
 - **Linux/macOS**: Uses CUPS system (`lpstat`, `lp` commands)
 - **Windows**: Uses WinAPI (Windows API) to directly access system printers via functions such as EnumPrintersW for listing printers, OpenPrinterW for opening printer handles, and WritePrinter for sending raw data
-- **Android**: Kotlin plugin with Bluetooth SPP and USB printer discovery and printing
+- **Android**: Kotlin plugin with Bluetooth SPP, USB, and Network (TCP/IP) printer discovery and printing
 
 ### Workflow
 
@@ -106,8 +106,8 @@ pub fn generate_document(&mut self, print_job: &PrintJobRequest) -> Result<Vec<u
 
 1. **Frontend** sends `PrintJobRequest` with sections and configuration
 2. **Rust** generates ESC/POS binary data using the same `ProcessPrint` pipeline
-3. **Kotlin plugin** receives the binary data and the printer MAC address
-4. **Bluetooth SPP** connection is established to the printer
+3. **Kotlin plugin** receives the binary data and the printer identifier (MAC, USB VID:PID, or IP:PORT)
+4. Connection is established via **Bluetooth SPP**, **USB Bulk Transfer**, or **TCP Socket**
 5. **Thermal Printer** interprets ESC/POS commands and prints
 
 #### Print Structure Example:
@@ -150,18 +150,18 @@ The plugin translates all sections into **ESC/POS** (Escape Sequence for Point o
 - ✅ **Linux**: Fully functional (CUPS)
 - ✅ **macOS**: Fully functional (CUPS)
 - ✅ **Windows**: Fully functional (WinAPI)
-- ✅ **Android**: Bluetooth and USB printer discovery and printing
+- ✅ **Android**: Bluetooth, USB, and Network printer discovery and printing
 - ❌ **iOS**: Not implemented
 
 ### Supported Connections
 
 | Connection | Linux | macOS | Windows | Android |
 | ---------- | ----- | ----- | ------- | ------- |
-| USB        | ✅    | ✅    | ✅      | ✅ (discovery only) |
-| Network    | ✅    | ✅    | ✅      | ❌      |
+| USB        | ✅    | ✅    | ✅      | ✅      |
+| Network    | ✅    | ✅    | ✅      | ✅      |
 | Bluetooth  | ❌    | ❌    | ❌      | ✅      |
 
-> **Android note**: The `printer` field in `PrintJobRequest` must be the Bluetooth MAC address of the printer (e.g. `"AA:BB:CC:DD:EE:FF"`). The printer must be previously paired in the Android Bluetooth settings. Bluetooth permissions are requested automatically at runtime.
+> **Android note**: The `printer` field in `PrintJobRequest` must be the printer identifier returned by `list_thermal_printers`. For Bluetooth, it's the MAC address (e.g. `"AA:BB:CC:DD:EE:FF"`). For USB, it's `"VID:xxxx/PID:yyyy"`. For Network, it's `"IP:PORT"` (e.g. `"192.168.1.100:9100"`). Required permissions (Bluetooth, USB, Internet) are handled automatically at runtime.
 
 ## Installation
 
@@ -285,7 +285,7 @@ try { await test_thermal_printer({
       "beep": true,
       "open_cash_drawer": false,
       "code_page": {
-        "codepage": 6,
+        "code_page": 6,
         "encode": ENCODE.WINDOWS_1252,
         "use_gbk": false
       }
@@ -356,7 +356,7 @@ try { await print_thermal_printer({
     "beep": false,
     "open_cash_drawer": false,
     "code_page": {
-      "codepage": 6,
+      "code_page": 6,
       "encode": ENCODE.WINDOWS_1252,
       "use_gbk": false
     }
@@ -391,12 +391,14 @@ Returns `Promise<void>`. Resolves when printing completes successfully. **Throws
 | `printer` | string | ✅ Yes | Printer name |
 | `paper_size` | PaperSize | ❌ No | Paper size (default: `"Mm80"`) — see [Paper Sizes](#paper-sizes) |
 | `options` | PrinterOptions | ❌ No | Configuration options |
-| `options.cut_paper` | boolean | ❌ No | Cut paper after printing (default: `true`) |
-| `options.beep` | boolean | ❌ No | Beep after printing (default: `false`) |
-| `options.open_cash_drawer` | boolean | ❌ No | Open cash drawer after printing (default: `false`) |
+| `options.cut_paper` | boolean | ❌ No | Append a tail `Cut` section equivalent to `{ "Cut": { "mode": "partial", "feed": 0 } }` (default: `true`) |
+| `options.beep` | boolean | ❌ No | Append a tail `Beep` section equivalent to `{ "Beep": { "times": 1, "duration": 3 } }` (default: `false`) |
+| `options.open_cash_drawer` | boolean | ❌ No | Append a tail `Drawer` section equivalent to `{ "Drawer": { "pin": 2, "pulse_time": 100 } }` (default: `false`) |
 | `options.code_page` | CodePage | ✅ Yes | Required ESC/POS page selection plus host-side encoding strategy — see [CodePage](#codepage) |
 | `sections` | array | ✅ Yes | Array of sections to print (see [Section Types](#section-types)) |
 
+`options.cut_paper`, `options.beep`, and `options.open_cash_drawer` are tail-action shorthands. They append sections at the end of the document in this fixed order: `Beep` → `Cut` → `Drawer`. They do **not** disable or replace manually declared sections, so if you specify both, both actions are emitted.
+
 #### Paper Sizes
 
 | Value | Paper width | Chars/line | Typical use |
@@ -891,7 +893,7 @@ The plugin exports typed constants and builder functions so you never have to ty
 
 Set the character encoding once in `PrinterOptions.code_page` and all text sections (`Title`, `Subtitle`, `Text`, `Table`) will use it automatically.
 
-Each printer model assigns its own `ESC t n` values, so `CodePage.codepage` accepts the raw page number directly. `CodePage.encode` controls the host-side encoding used before bytes are sent to the printer. `CodePage.use_gbk` explicitly controls whether characters that the selected `encode` cannot represent should be retried with GBK before falling back to the original UTF-8 bytes.
+Each printer model assigns its own `ESC t n` values, so `CodePage.code_page` accepts the raw page number directly. `CodePage.encode` controls the host-side encoding used before bytes are sent to the printer. `CodePage.use_gbk` explicitly controls whether characters that the selected `encode` cannot represent should be retried with GBK before falling back to the original UTF-8 bytes.
 
 ```typescript
 import { ENCODE, type CodePage } from "tauri-plugin-thermal-printer";
@@ -901,7 +903,7 @@ const options = {
   beep: false,
   open_cash_drawer: false,
   code_page: {
-    codepage: 6,
+    code_page: 6,
     encode: ENCODE.WINDOWS_1252,
     use_gbk: false,
   }, // sends ESC t 6
@@ -912,7 +914,7 @@ const options = {
 
 | Field | Required | Description |
 |---|---|---|
-| `codepage` | ✅ Yes | Raw `ESC t n` value sent to the printer. |
+| `code_page` | ✅ Yes | Raw `ESC t n` value sent to the printer. |
 | `encode` | ❌ No | Host-side encoding strategy. Defaults to `ENCODE.ACCENT_REMOVER`. |
 | `use_gbk` | ❌ No | Retries GBK for characters that `encode` cannot represent before falling back to the original UTF-8 bytes. Defaults to `false`. |
 
@@ -1072,7 +1074,7 @@ const job: PrintJobRequest = {
     beep: false,
     open_cash_drawer: false,
     code_page: {
-      codepage: 6,
+      code_page: 6,
       encode: ENCODE.WINDOWS_1252,
       use_gbk: false,
     },
@@ -1144,7 +1146,7 @@ await print_thermal_printer(job);
 
 This section contains practical examples for different use cases. Each example demonstrates how to structure print jobs for various business scenarios.
 
-> **NOTE:** Paper is automatically cut at the end of printing with a full cut. You don't need to add a `Cut` section manually unless you want a specific partial cut.
+> **NOTE:** With default options, a tail `Cut` section is appended automatically as `{ "Cut": { "mode": "partial", "feed": 0 } }`. Add your own `Cut` section when you need an extra cut or different parameters.
 
 ### 🛒 Long Receipt (Supermarket - 80mm)
 
@@ -1625,5 +1627,6 @@ const paymentReceipt: PrintJobRequest = {
 - No need to manually reset styles
 
 #### Paper Cutting
-- **Automatic**: Paper is automatically cut at the end with a full cut
-- **Manual** (optional): Add a `Cut` section if you need a specific partial cut
+- **Automatic**: `options.cut_paper = true` appends a tail `Cut` section with `mode: "partial"` and `feed: 0`
+- **Manual**: Add a `Cut` section anywhere in `sections` to issue explicit cut commands
+- **Combined**: Automatic and manual cuts are both emitted when both are present

package/dist-js/index.d.ts

@@ -17,7 +17,7 @@ export declare function getPaperSizePixelsWidth(paperSize: PaperSize): number;
  *   to GBK. It defaults to `false`.
  */
 export interface CodePage {
-    codepage: number;
+    code_page: number;
     encode?: Encode;
     use_gbk?: boolean;
 }
@@ -93,8 +93,11 @@ export declare const CUT_MODE: {
     readonly PARTIAL: CutMode;
 };
 export interface PrinterOptions {
+    /** Append a tail `Cut` section with mode `"partial"` and feed `0`. */
     cut_paper: boolean;
+    /** Append a tail `Beep` section with times `1` and duration `3`. */
     beep: boolean;
+    /** Append a tail `Drawer` section with pin `2` and pulse time `100`. */
     open_cash_drawer: boolean;
     /** Required ESC/POS page plus host-side encoding strategy. */
     code_page: CodePage;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tauri-plugin-thermal-printer",
-  "version": "1.3.1",
+  "version": "1.3.3",
   "author": "luis3132",
   "description": "Plugin for Tauri to send esc/pos commands to thermal_printer",
   "type": "module",