tauri-plugin-thermal-printer 1.2.2 → 1.3.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Luis Andres Gonzalez Corzo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -881,29 +881,23 @@ 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 numbers to code pages, so `CodePage` accepts the raw page number directly via `codePage(n)`. Check your printer's manual for the correct value.
+
 ```typescript
-import { CODE_PAGE, type CodePage } from "tauri-plugin-thermal-printer";
+import { codePage, CODE_PAGE, type CodePage } from "tauri-plugin-thermal-printer";
 
-// In your PrintJobRequest:
 const options = {
   cut_paper: true,
   beep: false,
   open_cash_drawer: false,
-  code_page: CODE_PAGE.SPANISH,  // enables á é í ó ú ñ ü ¿ ¡
+  code_page: codePage(2),  // sends ESC t 2 — CP850 on most Epson-compatible printers
 };
 ```
 
-| Constant | Value | Code Page | Languages |
-|---|---|---|---|
-| `CODE_PAGE.DEFAULT` | `"Default"` | CP437 | ASCII only — no accented characters |
-| `CODE_PAGE.SPANISH` | `"Spanish"` | CP850 | **Spanish**, French, Italian, German, Portuguese |
-| `CODE_PAGE.FRENCH` | `"French"` | CP850 | Alias of Spanish |
-| `CODE_PAGE.PORTUGUESE` | `"Portuguese"` | CP860 | **Portuguese** (ã, õ) |
-| `CODE_PAGE.CANADIAN_FRENCH` | `"CanadianFrench"` | CP863 | Canadian French |
-| `CODE_PAGE.NORDIC` | `"Nordic"` | CP865 | Swedish, Norwegian, Danish, Finnish (å, ø, æ) |
-| `CODE_PAGE.WINDOWS_LATIN` | `"WindowsLatin"` | CP1252 | Wide Western European — includes € |
-| `CODE_PAGE.RUSSIAN` | `"Russian"` | CP866 | **Russian** / Cyrillic |
-| `CODE_PAGE.EASTERN_EUROPE` | `"EasternEurope"` | CP852 | **Polish**, Czech, Slovak, Hungarian |
+| Value | Description |
+|---|---|
+| `codePage(n)` | Sends `ESC t n` with the given number. The user is responsible for choosing the correct value for their printer model. |
+| `CODE_PAGE.ACCENT_REMOVER` | Removes accents and special characters by converting them to their ASCII equivalents (á→a, ß→ss, ¿→?, €→EUR). Useful when printers do not support alternative code pages. |
 
 > **Note**: Without a `code_page`, accented characters (á, ñ, ü, etc.) will print as `?`. Set it once in `options` and it applies to the entire document.
 

package/dist-js/index.cjs

@@ -25,6 +25,10 @@ function getPaperSizeCharsPerLine(paperSize) {
 function getPaperSizePixelsWidth(paperSize) {
     return PAPER_SIZE_PIXELS_WIDTH[paperSize];
 }
+/** Creates a `CodePage` that sends the given ESC/POS code page number. */
+function codePage(n) {
+    return { Page: n };
+}
 // ─── Convenience style presets ────────────────────────────────────────────────
 const TEXT_ALIGN = {
     LEFT: 'left',
@@ -80,24 +84,6 @@ const CUT_MODE = {
     PARTIAL: 'partial',
 };
 const CODE_PAGE = {
-    /** CP437 — ASCII only, no accented characters */
-    DEFAULT: 'Default',
-    /** CP850 — Spanish, French, Italian, German */
-    SPANISH: 'Spanish',
-    /** CP850 — Alias of Spanish */
-    FRENCH: 'French',
-    /** CP860 — Portuguese (ã, õ) */
-    PORTUGUESE: 'Portuguese',
-    /** CP863 — Canadian French */
-    CANADIAN_FRENCH: 'CanadianFrench',
-    /** CP865 — Nordic languages (å, ø, æ) */
-    NORDIC: 'Nordic',
-    /** CP1252 — Wide Western European, includes € */
-    WINDOWS_LATIN: 'WindowsLatin',
-    /** CP866 — Russian / Cyrillic */
-    RUSSIAN: 'Russian',
-    /** CP852 — Eastern Europe (Polish, Czech, Slovak, Hungarian) */
-    EASTERN_EUROPE: 'EasternEurope',
     /** Strips accents and special chars to plain ASCII. Use when the printer
      *  ignores ESC t commands. á→a, é→e, ñ→n, ß→ss, ¿→?, €→EUR, etc. */
     ACCENT_REMOVER: 'AccentRemover',
@@ -260,6 +246,7 @@ exports.TEXT_FONT = TEXT_FONT;
 exports.TEXT_SIZE = TEXT_SIZE;
 exports.barcode = barcode;
 exports.beep = beep;
+exports.codePage = codePage;
 exports.cut = cut;
 exports.dataMatrix = dataMatrix;
 exports.drawer = drawer;

package/dist-js/index.d.ts

@@ -6,21 +6,19 @@ export declare function getPaperSizeCharsPerLine(paperSize: PaperSize): number;
 export declare function getPaperSizePixelsWidth(paperSize: PaperSize): number;
 /**
  * Character encoding page to use for printing.
- * Select by language/region — no need to know ESC/POS code page numbers.
  *
- * | Value           | Code Page | Languages                                      |
- * |-----------------|-----------|------------------------------------------------|
- * | Default         | CP437     | ASCII only — no accented characters            |
- * | Spanish         | CP850     | Spanish, French, Italian, German, Portuguese   |
- * | French          | CP850     | Alias of Spanish                               |
- * | Portuguese      | CP860     | Portuguese (includes ã, õ)                     |
- * | CanadianFrench  | CP863     | Canadian French                                |
- * | Nordic          | CP865     | Swedish, Norwegian, Danish, Finnish (å, ø, æ) |
- * | WindowsLatin    | CP1252    | Wide Western European coverage (includes €)    |
- * | Russian         | CP866     | Russian / Cyrillic                             |
- * | EasternEurope   | CP852     | Polish, Czech, Slovak, Hungarian               |
+ * - `{ Page: n }` — sends `ESC t n` to the printer; the user is responsible
+ *   for choosing the correct number for their printer model and ensuring the
+ *   text is already encoded accordingly.
+ * - `"AccentRemover"` — strips accents/diacritics to plain ASCII before
+ *   sending. Use when the printer ignores `ESC t` or has no alternate code
+ *   page. Examples: á→a, é→e, ñ→n, ß→ss, ¿→?, €→EUR.
  */
-export type CodePage = 'Default' | 'Spanish' | 'French' | 'Portuguese' | 'CanadianFrench' | 'Nordic' | 'WindowsLatin' | 'Russian' | 'EasternEurope' | 'AccentRemover';
+export type CodePage = {
+    Page: number;
+} | 'AccentRemover';
+/** Creates a `CodePage` that sends the given ESC/POS code page number. */
+export declare function codePage(n: number): CodePage;
 /** Text alignment options */
 export type TextAlign = 'left' | 'center' | 'right';
 /** Text size options */
@@ -93,24 +91,6 @@ export declare const CUT_MODE: {
     readonly PARTIAL: CutMode;
 };
 export declare const CODE_PAGE: {
-    /** CP437 — ASCII only, no accented characters */
-    readonly DEFAULT: CodePage;
-    /** CP850 — Spanish, French, Italian, German */
-    readonly SPANISH: CodePage;
-    /** CP850 — Alias of Spanish */
-    readonly FRENCH: CodePage;
-    /** CP860 — Portuguese (ã, õ) */
-    readonly PORTUGUESE: CodePage;
-    /** CP863 — Canadian French */
-    readonly CANADIAN_FRENCH: CodePage;
-    /** CP865 — Nordic languages (å, ø, æ) */
-    readonly NORDIC: CodePage;
-    /** CP1252 — Wide Western European, includes € */
-    readonly WINDOWS_LATIN: CodePage;
-    /** CP866 — Russian / Cyrillic */
-    readonly RUSSIAN: CodePage;
-    /** CP852 — Eastern Europe (Polish, Czech, Slovak, Hungarian) */
-    readonly EASTERN_EUROPE: CodePage;
     /** Strips accents and special chars to plain ASCII. Use when the printer
      *  ignores ESC t commands. á→a, é→e, ñ→n, ß→ss, ¿→?, €→EUR, etc. */
     readonly ACCENT_REMOVER: CodePage;
@@ -119,7 +99,7 @@ export interface PrinterOptions {
     cut_paper: boolean;
     beep: boolean;
     open_cash_drawer: boolean;
-    /** Character encoding for the printer. Default: 'Default' (ASCII only). */
+    /** Character encoding for the printer. Default: `{ Page: 0 }` (CP437, ASCII only). */
     code_page?: CodePage;
 }
 export interface GlobalStyles {

package/dist-js/index.js

@@ -23,6 +23,10 @@ function getPaperSizeCharsPerLine(paperSize) {
 function getPaperSizePixelsWidth(paperSize) {
     return PAPER_SIZE_PIXELS_WIDTH[paperSize];
 }
+/** Creates a `CodePage` that sends the given ESC/POS code page number. */
+function codePage(n) {
+    return { Page: n };
+}
 // ─── Convenience style presets ────────────────────────────────────────────────
 const TEXT_ALIGN = {
     LEFT: 'left',
@@ -78,24 +82,6 @@ const CUT_MODE = {
     PARTIAL: 'partial',
 };
 const CODE_PAGE = {
-    /** CP437 — ASCII only, no accented characters */
-    DEFAULT: 'Default',
-    /** CP850 — Spanish, French, Italian, German */
-    SPANISH: 'Spanish',
-    /** CP850 — Alias of Spanish */
-    FRENCH: 'French',
-    /** CP860 — Portuguese (ã, õ) */
-    PORTUGUESE: 'Portuguese',
-    /** CP863 — Canadian French */
-    CANADIAN_FRENCH: 'CanadianFrench',
-    /** CP865 — Nordic languages (å, ø, æ) */
-    NORDIC: 'Nordic',
-    /** CP1252 — Wide Western European, includes € */
-    WINDOWS_LATIN: 'WindowsLatin',
-    /** CP866 — Russian / Cyrillic */
-    RUSSIAN: 'Russian',
-    /** CP852 — Eastern Europe (Polish, Czech, Slovak, Hungarian) */
-    EASTERN_EUROPE: 'EasternEurope',
     /** Strips accents and special chars to plain ASCII. Use when the printer
      *  ignores ESC t commands. á→a, é→e, ñ→n, ß→ss, ¿→?, €→EUR, etc. */
     ACCENT_REMOVER: 'AccentRemover',
@@ -244,4 +230,4 @@ async function test_thermal_printer(testPrintRequest) {
     });
 }
 
-export { BARCODE_TEXT_POSITION, BARCODE_TYPE, CODE_PAGE, CUT_MODE, DEFAULT_PAPER_SIZE, IMAGE_MODE, PAPER_SIZE_CHARS_PER_LINE, PAPER_SIZE_PIXELS_WIDTH, QR_ERROR_CORRECTION, TEXT_ALIGN, TEXT_FONT, TEXT_SIZE, barcode, beep, cut, dataMatrix, drawer, feed, getPaperSizeCharsPerLine, getPaperSizePixelsWidth, globalStyles, image, line, list_thermal_printers, logo, pdf417, print_thermal_printer, qr, subtitle, table, test_thermal_printer, text, title };
+export { BARCODE_TEXT_POSITION, BARCODE_TYPE, CODE_PAGE, CUT_MODE, DEFAULT_PAPER_SIZE, IMAGE_MODE, PAPER_SIZE_CHARS_PER_LINE, PAPER_SIZE_PIXELS_WIDTH, QR_ERROR_CORRECTION, TEXT_ALIGN, TEXT_FONT, TEXT_SIZE, barcode, beep, codePage, cut, dataMatrix, drawer, feed, getPaperSizeCharsPerLine, getPaperSizePixelsWidth, globalStyles, image, line, list_thermal_printers, logo, pdf417, print_thermal_printer, qr, subtitle, table, test_thermal_printer, text, title };

package/package.json

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