@thermal-print/escpos 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 NUVEL
+
+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

@@ -0,0 +1,193 @@
+# @thermal-print/escpos
+
+ESC/POS command generation and thermal printer control.
+
+## 📦 Installation
+
+```bash
+pnpm add @thermal-print/escpos
+```
+
+## 🎯 Purpose
+
+Converts `PrintNode` trees (universal IR) to ESC/POS command buffers for thermal printers.
+
+**Architecture:**
+
+```
+PrintNode → ESCPOSGenerator → Buffer (ESC/POS commands)
+```
+
+## 🚀 Quick Start
+
+```typescript
+import { printNodesToESCPOS } from "@thermal-print/escpos";
+import { PrintNode } from "@thermal-print/core";
+
+const printNode: PrintNode = {
+  type: "document",
+  props: {},
+  children: [
+    {
+      type: "text",
+      props: { children: "Hello World" },
+      children: [],
+      style: { textAlign: "center", fontSize: 20 },
+    },
+  ],
+  style: {},
+};
+
+// Convert to ESC/POS buffer
+const buffer = await printNodesToESCPOS(printNode, {
+  paperWidth: 48,
+  cut: "full",
+});
+
+// Send to printer
+await printer.write(buffer);
+```
+
+## 📖 API
+
+### printNodesToESCPOS(printNode, options)
+
+Main conversion function.
+
+**Parameters:**
+
+- `printNode: PrintNode` - Root node of the tree to convert
+- `options?: PrintNodeToESCPOSOptions` - Conversion options
+
+**Options:**
+
+```typescript
+interface PrintNodeToESCPOSOptions {
+  paperWidth?: number; // Characters per line (default: 48)
+  encoding?: string; // Character encoding (default: 'utf-8')
+  debug?: boolean; // Enable debug output
+  cut?: boolean | "full" | "partial"; // Paper cut (default: 'full')
+  feedBeforeCut?: number; // Lines to feed before cut (default: 3)
+  commandAdapter?: "escpos" | "escbematech"; // Protocol (default: 'escpos')
+}
+```
+
+**Returns:** `Promise<Buffer>` - ESC/POS command buffer
+
+## 🎛 Command Adapters
+
+### ESC/POS (Default)
+
+Standard ESC/POS protocol compatible with most thermal printers.
+
+```typescript
+const buffer = await printNodesToESCPOS(printNode, {
+  commandAdapter: "escpos",
+});
+```
+
+### ESC/Bematech
+
+Bematech MP-4200 TH specific protocol.
+
+```typescript
+const buffer = await printNodesToESCPOS(printNode, {
+  commandAdapter: "escbematech",
+});
+```
+
+## 🔧 Advanced Usage
+
+### Custom Command Adapter
+
+```typescript
+import { CommandAdapter, ESCPOSGenerator } from "@thermal-print/escpos";
+
+class CustomAdapter implements CommandAdapter {
+  getName(): string {
+    return "custom";
+  }
+
+  getInitCommand(): number[] {
+    return [0x1b, 0x40]; // ESC @
+  }
+
+  // ... implement other methods
+}
+
+const buffer = await printNodesToESCPOS(printNode, {
+  commandAdapter: new CustomAdapter(),
+});
+```
+
+### Direct Generator Usage
+
+```typescript
+import { ESCPOSGenerator, TreeTraverser } from "@thermal-print/escpos";
+
+const generator = new ESCPOSGenerator(48, "utf-8");
+generator.initialize();
+
+const traverser = new TreeTraverser(generator);
+await traverser.traverse(printNode);
+
+generator.cutFullWithFeed(3);
+const buffer = generator.getBuffer();
+```
+
+## 🎨 Styling Support
+
+### Text Styles
+
+- **fontSize**: Maps to character sizes (1x1, 1x2, 2x1, 2x2)
+- **fontWeight**: 'bold' or numeric ≥700
+- **textAlign**: 'left', 'center', 'right'
+
+### Layout Styles
+
+- **flexDirection**: 'row' (side-by-side), 'column' (stacked)
+- **justifyContent**: 'space-between', 'center', etc.
+- **padding/margin**: Top and bottom spacing (converted to line feeds)
+- **borderTop/borderBottom**: Divider lines (solid or dashed)
+- **width**: Column width (percentage or fixed characters)
+
+## 🌍 Character Encoding
+
+### CP860 (Default)
+
+Brazilian Portuguese support with special characters: ç, á, é, í, ó, ú, ã, õ
+
+```typescript
+const buffer = await printNodesToESCPOS(printNode, {
+  encoding: "cp860",
+});
+```
+
+## 📏 Paper Widths
+
+Common thermal printer paper widths:
+
+- **58mm** = 32 characters
+- **80mm** = 48 characters (default)
+- **112mm** = 64 characters
+
+```typescript
+const buffer = await printNodesToESCPOS(printNode, {
+  paperWidth: 48, // 80mm paper
+});
+```
+
+## 🖼 Image Support
+
+Images are automatically:
+
+- Resized to fit paper width
+- Converted to grayscale
+- Converted to monochrome (1-bit)
+- Printed using ESC/POS raster graphics
+
+Requires `jimp` for image processing (optional dependency).
+
+## 📄 License
+
+MIT © Gabriel Martinusso

package/dist/command-adapters/escbematech-adapter.d.ts

@@ -0,0 +1,30 @@
+/**
+ * ESC/Bematech Command Adapter
+ *
+ * ESC/Bematech (ESC/Bema) command implementation for Bematech thermal printers.
+ * The MP-4200 TH supports both ESC/Bema and ESC/POS modes - only one active at a time.
+ *
+ * Note: ESC/Bema has limited command support compared to ESC/POS.
+ * Some advanced features (like QR codes) may not be available.
+ *
+ * Reference: Bematech MP-4200 TH Programming Manual
+ */
+import { CommandAdapter, CharacterSize } from './types';
+/**
+ * ESC/Bematech Command Adapter
+ * For Bematech printers in ESC/Bema mode
+ */
+export declare class ESCBematechCommandAdapter implements CommandAdapter {
+    getName(): string;
+    getMaxCharacterSize(): CharacterSize;
+    getInitCommand(): number[];
+    getAlignCommand(align: 'left' | 'center' | 'right'): number[];
+    getCharacterSizeCommand(width: number, height: number, bold: boolean): number[];
+    getLineSpacingCommand(dots?: number): number[];
+    getCutCommand(type: 'full' | 'partial', feedLines?: number): number[];
+    getQRCodeCommand(data: string, size: number): number[];
+    getRasterImageCommand(imageData: number[], width: number, height: number): number[];
+    getLineFeedCommand(lines?: number): number[];
+    getFeedLinesCommand(lines: number): number[];
+}
+//# sourceMappingURL=escbematech-adapter.d.ts.map

package/dist/command-adapters/escbematech-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"escbematech-adapter.d.ts","sourceRoot":"","sources":["../../src/command-adapters/escbematech-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAGxD;;;GAGG;AACH,qBAAa,yBAA0B,YAAW,cAAc;IAC9D,OAAO,IAAI,MAAM;IAIjB,mBAAmB,IAAI,aAAa;IAMpC,cAAc,IAAI,MAAM,EAAE;IAK1B,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,EAAE;IAY7D,uBAAuB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,MAAM,EAAE;IAiB/E,qBAAqB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE;IAW9C,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE;IAqBrE,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE;IAgBtD,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE;IAuBnF,kBAAkB,CAAC,KAAK,GAAE,MAAU,GAAG,MAAM,EAAE;IAU/C,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE;CAa7C"}

package/dist/command-adapters/escbematech-adapter.js

@@ -0,0 +1,175 @@
+"use strict";
+/**
+ * ESC/Bematech Command Adapter
+ *
+ * ESC/Bematech (ESC/Bema) command implementation for Bematech thermal printers.
+ * The MP-4200 TH supports both ESC/Bema and ESC/POS modes - only one active at a time.
+ *
+ * Note: ESC/Bema has limited command support compared to ESC/POS.
+ * Some advanced features (like QR codes) may not be available.
+ *
+ * Reference: Bematech MP-4200 TH Programming Manual
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ESCBematechCommandAdapter = void 0;
+const ESCBema = __importStar(require("../commands/escbematech"));
+/**
+ * ESC/Bematech Command Adapter
+ * For Bematech printers in ESC/Bema mode
+ */
+class ESCBematechCommandAdapter {
+    getName() {
+        return 'ESC/Bematech';
+    }
+    getMaxCharacterSize() {
+        // ESC/Bema supports double width and double height
+        // but typically not independent control like ESC/POS
+        return { width: 2, height: 2 };
+    }
+    getInitCommand() {
+        // ESC @ - Reset printer
+        return ESCBema.INIT;
+    }
+    getAlignCommand(align) {
+        // ESC a n - Set text alignment (ESC/Bema uses same command as ESC/POS)
+        switch (align) {
+            case 'left':
+                return ESCBema.ALIGN_LEFT;
+            case 'center':
+                return ESCBema.ALIGN_CENTER;
+            case 'right':
+                return ESCBema.ALIGN_RIGHT;
+        }
+    }
+    getCharacterSizeCommand(width, height, bold) {
+        /**
+         * ESC/Bema character sizing:
+         * - Uses ESC ! n for combined mode (emphasis, double-height, double-width)
+         * - Also supports separate commands: ESC E/F (bold), ESC W (width), ESC d (height)
+         *
+         * We'll use the combined ESC ! command for better efficiency
+         * Max size: 2x2 (same as ESC/POS compatibility mode)
+         */
+        return ESCBema.calculatePrintMode({
+            emphasized: bold,
+            doubleHeight: height >= 2,
+            doubleWidth: width >= 2,
+            underline: false
+        });
+    }
+    getLineSpacingCommand(dots) {
+        if (dots === undefined) {
+            // ESC 2 - Reset to default spacing (1/6 inches)
+            return ESCBema.SET_LINE_HEIGHT_DEFAULT;
+        }
+        else {
+            // ESC 3 n - Set line spacing to n/144 inches
+            // Range: 18 ≤ n ≤ 255
+            return ESCBema.setLineSpacing(dots);
+        }
+    }
+    getCutCommand(type, feedLines) {
+        const commands = [];
+        // Feed paper if requested
+        if (feedLines && feedLines > 0) {
+            commands.push(...this.getLineFeedCommand(feedLines));
+        }
+        // ESC/Bema cut commands
+        // ESC i or ESC w: Full cut (both work, ESC i is primary)
+        // Note: Partial cut (ESC m) is ESC/POS command, not documented in ESC/Bema manual
+        if (type === 'full') {
+            commands.push(...ESCBema.CUT_FULL);
+        }
+        else {
+            // Partial cut not available in ESC/Bema, use full cut instead
+            commands.push(...ESCBema.CUT_FULL);
+        }
+        return commands;
+    }
+    getQRCodeCommand(data, size) {
+        /**
+         * QR Code support is NOT documented in ESC/Bematech manual Chapter 3.
+         * QR codes require ESC/POS mode with GS ( k commands.
+         *
+         * Recommendation: Switch printer to ESC/POS mode temporarily:
+         *   1. Send GS F9h SP 1 (temp switch to ESC/POS)
+         *   2. Print QR code using ESC/POS commands
+         *   3. Send GS F9h 1Fh 1 (return to previous mode)
+         *
+         * For now, we return empty array and log a warning.
+         */
+        console.warn('QR Code generation is not supported in ESC/Bematech mode. Switch to ESC/POS mode using GS F9h SP 1.');
+        return [];
+    }
+    getRasterImageCommand(imageData, width, height) {
+        /**
+         * ESC/Bematech supports multiple graphics formats:
+         * - GS v 0 m: Raster bitmap (documented, preferred)
+         * - ESC * !: 24-bit graphics (documented)
+         * - ESC K: 8-bit graphics (documented, lower quality)
+         *
+         * We'll use GS v 0 format (raster bitmap) which is explicitly documented
+         * in the Bematech manual and provides best compatibility.
+         */
+        const bytesPerLine = Math.ceil(width / 8);
+        // Use raster bitmap format with normal mode (203 dpi × 203 dpi)
+        const commands = ESCBema.printRasterBitmap(ESCBema.RasterMode.NORMAL, bytesPerLine, height, imageData);
+        return commands;
+    }
+    getLineFeedCommand(lines = 1) {
+        // LF (0x0A) - Feed one line
+        // Repeat for multiple lines
+        const commands = [];
+        for (let i = 0; i < lines; i++) {
+            commands.push(...ESCBema.FEED_LINE);
+        }
+        return commands;
+    }
+    getFeedLinesCommand(lines) {
+        /**
+         * IMPORTANT FIX: ESC d in ESC/Bema is for DOUBLE-HEIGHT, not line feed!
+         *
+         * For paper feeding in ESC/Bema, use:
+         * - LF (0x0A): Feed one line (preferred for multiple lines)
+         * - ESC A n: Feed paper by [n × 0.375mm]
+         * - ESC J n: Fine line feed [(n-48) × 0.125mm]
+         *
+         * We'll use LF for simplicity
+         */
+        return this.getLineFeedCommand(lines);
+    }
+}
+exports.ESCBematechCommandAdapter = ESCBematechCommandAdapter;

package/dist/command-adapters/escpos-adapter.d.ts

@@ -0,0 +1,25 @@
+/**
+ * ESC/POS Command Adapter
+ *
+ * Standard ESC/POS command implementation using ESC ! for character sizing.
+ * Compatible with most thermal printers that support ESC/POS protocol.
+ */
+import { CommandAdapter, CharacterSize } from "./types";
+/**
+ * ESC/POS Command Adapter
+ * Uses ESC ! for character sizing (max 2x2) for better compatibility
+ */
+export declare class ESCPOSCommandAdapter implements CommandAdapter {
+    getName(): string;
+    getMaxCharacterSize(): CharacterSize;
+    getInitCommand(): number[];
+    getAlignCommand(align: "left" | "center" | "right"): number[];
+    getCharacterSizeCommand(width: number, height: number, bold: boolean): number[];
+    getLineSpacingCommand(dots?: number): number[];
+    getCutCommand(type: "full" | "partial", feedLines?: number): number[];
+    getQRCodeCommand(data: string, size: number): number[];
+    getRasterImageCommand(imageData: number[], width: number, height: number): number[];
+    getLineFeedCommand(lines?: number): number[];
+    getFeedLinesCommand(lines: number): number[];
+}
+//# sourceMappingURL=escpos-adapter.d.ts.map

package/dist/command-adapters/escpos-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"escpos-adapter.d.ts","sourceRoot":"","sources":["../../src/command-adapters/escpos-adapter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAQxD;;;GAGG;AACH,qBAAa,oBAAqB,YAAW,cAAc;IACzD,OAAO,IAAI,MAAM;IAIjB,mBAAmB,IAAI,aAAa;IAMpC,cAAc,IAAI,MAAM,EAAE;IAoB1B,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,EAAE;IAY7D,uBAAuB,CACrB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,OAAO,GACZ,MAAM,EAAE;IASX,qBAAqB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE;IAU9C,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE;IAoBrE,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE;IAKtD,qBAAqB,CACnB,SAAS,EAAE,MAAM,EAAE,EACnB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb,MAAM,EAAE;IAKX,kBAAkB,CAAC,KAAK,GAAE,MAAU,GAAG,MAAM,EAAE;IAU/C,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE;CAI7C"}

package/dist/command-adapters/escpos-adapter.js

@@ -0,0 +1,144 @@
+"use strict";
+/**
+ * ESC/POS Command Adapter
+ *
+ * Standard ESC/POS command implementation using ESC ! for character sizing.
+ * Compatible with most thermal printers that support ESC/POS protocol.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ESCPOSCommandAdapter = void 0;
+const ESCPOS = __importStar(require("../commands/escpos"));
+// Control characters (for backward compatibility)
+const ESC = ESCPOS.ESC;
+const GS = ESCPOS.GS;
+const LF = ESCPOS.LF;
+/**
+ * ESC/POS Command Adapter
+ * Uses ESC ! for character sizing (max 2x2) for better compatibility
+ */
+class ESCPOSCommandAdapter {
+    getName() {
+        return "ESC/POS";
+    }
+    getMaxCharacterSize() {
+        // ESC ! command supports up to 2x2 for compatibility
+        // Note: GS ! supports up to 8x8, but ESC ! is more widely supported
+        return { width: 2, height: 2 };
+    }
+    getInitCommand() {
+        const commands = [];
+        // ESC @ - Reset printer to default state
+        commands.push(...ESCPOS.INIT);
+        // GS P x y - Set horizontal and vertical motion units
+        // Set both to 203 DPI (standard thermal printer resolution)
+        // This ensures GS W and other commands use 1/203 inch per unit
+        commands.push(0x1D, 0x50, 203, 203);
+        // GS W nL nH - Set printing area width
+        // For 80mm paper at 203 DPI: 80mm ≈ 3.15" × 203 = 640 dots
+        // Using 640 dots to match physical paper width
+        const width = 640;
+        commands.push(0x1D, 0x57, width & 0xFF, (width >> 8) & 0xFF);
+        return commands;
+    }
+    getAlignCommand(align) {
+        // ESC a n - Set text alignment (n: 0=left, 1=center, 2=right)
+        switch (align) {
+            case "left":
+                return ESCPOS.ALIGN_LEFT;
+            case "center":
+                return ESCPOS.ALIGN_CENTER;
+            case "right":
+                return ESCPOS.ALIGN_RIGHT;
+        }
+    }
+    getCharacterSizeCommand(width, height, bold) {
+        /**
+         * ESC ! n - Select print mode
+         * Uses the calculateCharacterSize function from escpos.ts
+         * This provides character sizing up to 2x2 with optional bold
+         */
+        return ESCPOS.calculateCharacterSize(width, height, bold);
+    }
+    getLineSpacingCommand(dots) {
+        if (dots === undefined) {
+            // ESC 2 - Reset to default spacing (1/6 inch)
+            return ESCPOS.LINE_SPACING_DEFAULT_ALT;
+        }
+        else {
+            // ESC 3 n - Set line spacing to n dots
+            return ESCPOS.setLineSpacing(dots);
+        }
+    }
+    getCutCommand(type, feedLines) {
+        const commands = [];
+        // Feed paper if requested
+        if (feedLines && feedLines > 0) {
+            commands.push(...this.getFeedLinesCommand(feedLines));
+        }
+        // Cut command - using commands from escpos.ts
+        if (type === "full") {
+            // ESC i - Full cut
+            commands.push(...ESCPOS.CUT_FULL_ESC);
+        }
+        else {
+            // ESC m - Partial cut
+            commands.push(...ESCPOS.CUT_PARTIAL_ESC);
+        }
+        return commands;
+    }
+    getQRCodeCommand(data, size) {
+        // Use the generateQRCode function from escpos.ts
+        return ESCPOS.generateQRCode(data, size);
+    }
+    getRasterImageCommand(imageData, width, height) {
+        // Use the generateRasterImage function from escpos.ts
+        return ESCPOS.generateRasterImage(imageData, width, height);
+    }
+    getLineFeedCommand(lines = 1) {
+        // LF - Line feed (0x0A)
+        // Repeat LF command for multiple lines
+        const commands = [];
+        for (let i = 0; i < lines; i++) {
+            commands.push(...ESCPOS.LINE_FEED);
+        }
+        return commands;
+    }
+    getFeedLinesCommand(lines) {
+        // ESC d n - Print and feed n lines
+        return ESCPOS.feedLines(lines);
+    }
+}
+exports.ESCPOSCommandAdapter = ESCPOSCommandAdapter;

package/dist/command-adapters/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Command Adapters
+ *
+ * Provides printer protocol abstraction for different command sets:
+ * - ESC/POS: Standard thermal printer protocol
+ * - ESC/Bematech: Bematech-specific protocol
+ */
+export { CommandAdapter, CharacterSize } from './types';
+export { ESCPOSCommandAdapter } from './escpos-adapter';
+export { ESCBematechCommandAdapter } from './escbematech-adapter';
+//# sourceMappingURL=index.d.ts.map

package/dist/command-adapters/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/command-adapters/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/command-adapters/index.js

@@ -0,0 +1,14 @@
+"use strict";
+/**
+ * Command Adapters
+ *
+ * Provides printer protocol abstraction for different command sets:
+ * - ESC/POS: Standard thermal printer protocol
+ * - ESC/Bematech: Bematech-specific protocol
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ESCBematechCommandAdapter = exports.ESCPOSCommandAdapter = void 0;
+var escpos_adapter_1 = require("./escpos-adapter");
+Object.defineProperty(exports, "ESCPOSCommandAdapter", { enumerable: true, get: function () { return escpos_adapter_1.ESCPOSCommandAdapter; } });
+var escbematech_adapter_1 = require("./escbematech-adapter");
+Object.defineProperty(exports, "ESCBematechCommandAdapter", { enumerable: true, get: function () { return escbematech_adapter_1.ESCBematechCommandAdapter; } });