@thermal-print/escpos 0.1.0

package/dist/commands/escpos.js

@@ -0,0 +1,1048 @@
+"use strict";
+/**
+ * ESC/POS Command Set
+ *
+ * Comprehensive ESC/POS thermal printer command bytes for MP-4200 TH.
+ * Reference: ESC/POS Command Manual
+ *
+ * This file contains all documented ESC/POS commands organized by category.
+ * Commands are compatible with standard ESC/POS thermal printers.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UNDERLINE_2DOT = exports.UNDERLINE_1DOT = exports.UPSIDE_DOWN_OFF = exports.UPSIDE_DOWN_ON = exports.ROTATE_90_OFF = exports.ROTATE_90_ON = exports.SELECT_FONT_D = exports.selectFont = exports.CharacterFont = exports.DOUBLE_STRIKE_OFF = exports.DOUBLE_STRIKE_ON = exports.CLEAR_TABS = exports.setTabPositions = exports.setCharacterSpacing = exports.setRelativePosition = exports.setAbsolutePosition = exports.realtimePulse = exports.realtimeRequest = exports.transmitRealtimeStatus = exports.encodeText = exports.generateRasterImage = exports.generateQRCode = exports.CODEPAGE_WPC1252 = exports.CODEPAGE_CP860 = exports.CODEPAGE_CP437 = exports.cutWithFeed = exports.CUT_PARTIAL = exports.CUT_FULL = exports.feedLines = exports.LINE_FEED = exports.LINE_SPACING_DEFAULT = exports.setLineSpacing = exports.calculateCharacterSize = exports.UNDERLINE_OFF = exports.UNDERLINE_ON = exports.BOLD_OFF = exports.BOLD_ON = exports.ALIGN_RIGHT = exports.ALIGN_CENTER = exports.ALIGN_LEFT = exports.INIT = exports.GS = exports.FS = exports.ESC = exports.CAN = exports.DLE = exports.CR = exports.FF = exports.LF = exports.HT = void 0;
+exports.selectCharacterSize = exports.generatePDF417 = exports.printPDF417 = exports.storePDF417Data = exports.setPDF417ErrorCorrection = exports.setPDF417RowHeight = exports.setPDF417Width = exports.setPDF417Rows = exports.setPDF417Columns = exports.printBarcodeCODE128 = exports.printBarcodeCODE93 = exports.printBarcodeCODABAR = exports.printBarcodeITF = exports.printBarcodeCODE39 = exports.printBarcodeEAN8 = exports.printBarcodeEAN13 = exports.printBarcodeUPCE = exports.printBarcodeUPCA = exports.printBarcodeWithLength = exports.printBarcode = exports.BarcodeType = exports.setBarcodeWidth = exports.setBarcodeHeight = exports.setBarcodeFont = exports.setBarcodeHRI = exports.BarcodeHRIPosition = exports.defineNVBitImage = exports.printNVBitImage = exports.printDownloadedBitImage = exports.DownloadedImageMode = exports.defineDownloadedBitImage = exports.printBitImage = exports.BitImageMode = exports.setCodePage = exports.CodePage = exports.selectInternationalCharset = exports.InternationalCharset = exports.disablePanelButtons = exports.enablePanelButtons = exports.selectPaperSensorStop = exports.selectPaperSensorOutput = exports.generatePulse = exports.selectPeripheral = exports.cutAndFeedPartial = exports.cutAndFeedFull = exports.CUT_PARTIAL_ESC = exports.CUT_FULL_ESC = exports.printAndReverseFeed = exports.printAndFeed = exports.LINE_SPACING_DEFAULT_ALT = void 0;
+exports.executeTestPrint = exports.CANCEL = exports.UNIDIRECTIONAL_OFF = exports.UNIDIRECTIONAL_ON = exports.executeMacro = exports.END_MACRO = exports.START_MACRO = exports.setPrintingAreaWidth = exports.setLeftMargin = exports.requestStatus = exports.StatusType = exports.requestPrinterID = exports.PrinterIDType = exports.disableASB = exports.enableASB = exports.setCharacterSmoothing = exports.setCharacterColor = exports.REVERSE_PRINT_OFF = exports.REVERSE_PRINT_ON = void 0;
+const cp860_1 = require("../encodings/cp860");
+// ============================================================================
+// CONTROL CHARACTERS
+// ============================================================================
+exports.HT = 0x09; // Horizontal Tab
+exports.LF = 0x0a; // Line Feed
+exports.FF = 0x0c; // Form Feed
+exports.CR = 0x0d; // Carriage Return
+exports.DLE = 0x10; // Data Link Escape
+exports.CAN = 0x18; // Cancel
+exports.ESC = 0x1b; // Escape
+exports.FS = 0x1c; // File Separator
+exports.GS = 0x1d; // Group Separator
+// Initialize printer
+// ESC @ - Reset printer to default state
+exports.INIT = [exports.ESC, 0x40];
+// Text alignment
+// ESC a n - Set text alignment (n: 0=left, 1=center, 2=right)
+exports.ALIGN_LEFT = [exports.ESC, 0x61, 0x00];
+exports.ALIGN_CENTER = [exports.ESC, 0x61, 0x01];
+exports.ALIGN_RIGHT = [exports.ESC, 0x61, 0x02];
+// Text emphasis
+// ESC E n - Turn bold on/off (n: 0=off, 1=on)
+exports.BOLD_ON = [exports.ESC, 0x45, 0x01];
+exports.BOLD_OFF = [exports.ESC, 0x45, 0x00];
+// ESC - n - Turn underline on/off (n: 0=off, 1=on, 2=double)
+exports.UNDERLINE_ON = [exports.ESC, 0x2d, 0x01];
+exports.UNDERLINE_OFF = [exports.ESC, 0x2d, 0x00];
+/**
+ * Calculate character size using ESC ! command (compatible with more printers)
+ * ESC ! only supports up to 2x2 character size
+ * @param width - Width multiplier (1 or 2)
+ * @param height - Height multiplier (1 or 2)
+ * @param bold - Whether text should be bold (optional, default: false)
+ * @returns ESC/POS ESC ! n command bytes
+ */
+const calculateCharacterSize = (width, height, bold = false) => {
+    // ESC ! command format:
+    // Bit 0: Character font (0=Font A, 1=Font B)
+    // Bit 3: Emphasis (bold)
+    // Bit 4: Double-height
+    // Bit 5: Double-width
+    // Bit 7: Underline
+    // Use Font B as base (9×17 dots)
+    // Note: Font D (16×24 dots) is selected separately via ESC U command
+    // and will override this font selection
+    let n = 0x01; // Font B
+    // Set double-height bit (bit 4 = 0x10)
+    if (height >= 2) {
+        n |= 0x10;
+    }
+    // Set double-width bit (bit 5 = 0x20)
+    if (width >= 2) {
+        n |= 0x20;
+    }
+    // Set bold/emphasis bit (bit 3 = 0x08)
+    if (bold) {
+        n |= 0x08;
+    }
+    return [exports.ESC, 0x21, n];
+};
+exports.calculateCharacterSize = calculateCharacterSize;
+// Line spacing
+// ESC 3 n - Set line spacing to n dots
+// Note: Using minimum of 18 dots for consistency with ESC/Bematech protocol
+const setLineSpacing = (dots) => {
+    const value = Math.max(18, Math.min(255, dots));
+    return [exports.ESC, 0x33, value];
+};
+exports.setLineSpacing = setLineSpacing;
+// Default line spacing (30 dots = ~3.75mm)
+exports.LINE_SPACING_DEFAULT = [exports.ESC, 0x33, 30];
+// Paper control
+// LF - Line feed (move paper up one line)
+exports.LINE_FEED = [exports.LF];
+// ESC d n - Print and feed n lines
+const feedLines = (lines) => [exports.ESC, 0x64, lines];
+exports.feedLines = feedLines;
+// GS V m - Paper cut
+// m: 0=full cut, 1=partial cut
+exports.CUT_FULL = [exports.GS, 0x56, 0x00];
+exports.CUT_PARTIAL = [exports.GS, 0x56, 0x01];
+// Alternative: GS V m n - Cut with feed
+const cutWithFeed = (lines) => [exports.GS, 0x56, 0x41, lines];
+exports.cutWithFeed = cutWithFeed;
+// Character code table
+// ESC t n - Select character code table
+// Common tables: 0=CP437, 3=CP860 (Portuguese), 16=WPC1252
+exports.CODEPAGE_CP437 = [exports.ESC, 0x74, 0x00]; // USA
+exports.CODEPAGE_CP860 = [exports.ESC, 0x74, 0x03]; // Portuguese
+exports.CODEPAGE_WPC1252 = [exports.ESC, 0x74, 0x10]; // Windows Latin-1
+// Barcode and QR Code
+// QR Code: GS ( k pL pH cn fn n1 n2 [data]
+// This is a complex command, implemented as a function
+/**
+ * Generate QR Code command
+ * @param data - QR code data (URL or text)
+ * @param size - QR code module size (1-16, default 6)
+ * @returns ESC/POS command bytes
+ */
+const generateQRCode = (data, size = 6) => {
+    const commands = [];
+    // QR Code model (function 165, cn=49, fn=65, n=48/49/50)
+    // Model 2 (most common)
+    commands.push(exports.GS, 0x28, 0x6b, 0x04, 0x00, 0x31, 0x41, 0x32, 0x00);
+    // QR Code size (function 167, cn=49, fn=67, n=size)
+    commands.push(exports.GS, 0x28, 0x6b, 0x03, 0x00, 0x31, 0x43, size);
+    // QR Code error correction (function 169, cn=49, fn=69, n=48-51)
+    // 48=L(7%), 49=M(15%), 50=Q(25%), 51=H(30%)
+    commands.push(exports.GS, 0x28, 0x6b, 0x03, 0x00, 0x31, 0x45, 0x31);
+    // Store QR code data (function 180, cn=49, fn=80)
+    const dataBytes = new TextEncoder().encode(data);
+    const pL = (dataBytes.length + 3) % 256;
+    const pH = Math.floor((dataBytes.length + 3) / 256);
+    commands.push(exports.GS, 0x28, 0x6b, pL, pH, 0x31, 0x50, 0x30);
+    commands.push(...Array.from(dataBytes));
+    // Print QR code (function 181, cn=49, fn=81)
+    commands.push(exports.GS, 0x28, 0x6b, 0x03, 0x00, 0x31, 0x51, 0x30);
+    return commands;
+};
+exports.generateQRCode = generateQRCode;
+/**
+ * Generate raster image command (GS v 0)
+ * @param imageData - Monochrome bitmap data (1 bit per pixel, 1=black, 0=white)
+ * @param width - Image width in pixels
+ * @param height - Image height in pixels
+ * @returns ESC/POS command bytes
+ */
+const generateRasterImage = (imageData, width, height) => {
+    const commands = [];
+    // Calculate bytes per line (width in bytes, rounded up to nearest byte)
+    const bytesPerLine = Math.ceil(width / 8);
+    // GS v 0 m xL xH yL yH d1...dk
+    // m = 0 (normal), 1 (double width), 2 (double height), 3 (quadruple)
+    // xL xH = width in bytes (little endian)
+    // yL yH = height in dots (little endian)
+    // d1...dk = raster image data
+    commands.push(exports.GS, 0x76, 0x30, 0x00); // GS v 0 m (m=0: normal)
+    // Width in bytes (little endian)
+    commands.push(bytesPerLine & 0xff);
+    commands.push((bytesPerLine >> 8) & 0xff);
+    // Height in dots (little endian)
+    commands.push(height & 0xff);
+    commands.push((height >> 8) & 0xff);
+    // Add image data
+    commands.push(...imageData);
+    return commands;
+};
+exports.generateRasterImage = generateRasterImage;
+/**
+ * Text encoding helper
+ * Converts string to CP860 byte array for Brazilian Portuguese thermal printers
+ */
+const encodeText = (text) => {
+    // CP860 is the standard codepage for Portuguese thermal printers
+    // Supports: ç Ç á é í ó ú à ã õ â ê ô and other Portuguese characters
+    return (0, cp860_1.encodeCP860)(text);
+};
+exports.encodeText = encodeText;
+// ============================================================================
+// REAL-TIME COMMANDS
+// ============================================================================
+/**
+ * DLE EOT n - Transmit real-time status
+ * n = 1: Transmit printer status
+ * n = 2: Transmit offline status
+ * n = 3: Transmit error status
+ * n = 4: Transmit paper roll sensor status
+ */
+const transmitRealtimeStatus = (n) => [
+    exports.DLE,
+    0x04,
+    n,
+];
+exports.transmitRealtimeStatus = transmitRealtimeStatus;
+/**
+ * DLE ENQ n - Real-time request to printer
+ * n = 1: Recover from error and restart printing
+ * n = 2: Clear buffer
+ */
+const realtimeRequest = (n) => [exports.DLE, 0x05, n];
+exports.realtimeRequest = realtimeRequest;
+/**
+ * DLE DC4 fn a b - Generate pulse in real-time
+ * fn = 1: Generate pulse
+ * a = drawer (0 or 1)
+ * b = pulse time
+ */
+const realtimePulse = (drawer, pulseTime) => [
+    exports.DLE,
+    0x14,
+    0x01,
+    drawer,
+    pulseTime,
+];
+exports.realtimePulse = realtimePulse;
+// ============================================================================
+// TEXT POSITION & LAYOUT
+// ============================================================================
+/**
+ * ESC $ nL nH - Set absolute print position
+ * Position = ((nH × 256) + nL) × (horizontal motion unit)
+ */
+const setAbsolutePosition = (position) => {
+    const nL = position & 0xff;
+    const nH = (position >> 8) & 0xff;
+    return [exports.ESC, 0x24, nL, nH];
+};
+exports.setAbsolutePosition = setAbsolutePosition;
+/**
+ * ESC \ nL nH - Set relative print position
+ * Relative position = ((nH × 256) + nL) × (horizontal motion unit)
+ * Supports negative values (two's complement)
+ */
+const setRelativePosition = (position) => {
+    const nL = position & 0xff;
+    const nH = (position >> 8) & 0xff;
+    return [exports.ESC, 0x5c, nL, nH];
+};
+exports.setRelativePosition = setRelativePosition;
+/**
+ * ESC SP n - Set right-side character spacing
+ * Range: 0 ≤ n ≤ 255
+ * Spacing = n × (horizontal motion unit)
+ */
+const setCharacterSpacing = (dots) => [
+    exports.ESC,
+    0x20,
+    Math.max(0, Math.min(255, dots)),
+];
+exports.setCharacterSpacing = setCharacterSpacing;
+/**
+ * ESC D n1...nk NUL - Set horizontal tab positions
+ * n1-nk: Tab positions (1-255), up to 32 positions
+ * Must be in ascending order, terminated with NUL
+ */
+const setTabPositions = (positions) => {
+    const validPositions = positions
+        .filter((p) => p >= 1 && p <= 255)
+        .slice(0, 32)
+        .sort((a, b) => a - b);
+    return [exports.ESC, 0x44, ...validPositions, 0x00];
+};
+exports.setTabPositions = setTabPositions;
+/**
+ * ESC D NUL - Cancel all horizontal tab positions
+ */
+exports.CLEAR_TABS = [exports.ESC, 0x44, 0x00];
+// ============================================================================
+// TEXT EMPHASIS & STYLES
+// ============================================================================
+/**
+ * ESC G n - Turn double-strike mode on/off
+ * n = 0 or 48: Turn off double-strike mode
+ * n = 1 or 49: Turn on double-strike mode
+ */
+exports.DOUBLE_STRIKE_ON = [exports.ESC, 0x47, 0x01];
+exports.DOUBLE_STRIKE_OFF = [exports.ESC, 0x47, 0x00];
+/**
+ * Character font selection
+ */
+var CharacterFont;
+(function (CharacterFont) {
+    CharacterFont[CharacterFont["FONT_A"] = 0] = "FONT_A";
+    CharacterFont[CharacterFont["FONT_B"] = 1] = "FONT_B";
+    CharacterFont[CharacterFont["FONT_C"] = 2] = "FONT_C";
+})(CharacterFont || (exports.CharacterFont = CharacterFont = {}));
+/**
+ * ESC M n - Select character font
+ * n = 0 or 48: Font A (12×24)
+ * n = 1 or 49: Font B (9×17)
+ * n = 2 or 50: Font C (printer dependent)
+ */
+const selectFont = (font) => [exports.ESC, 0x4d, font];
+exports.selectFont = selectFont;
+/**
+ * ESC U - Select Font D (Phoenix printers only)
+ * Font D: 16×24 dots
+ * Warning: This is a Phoenix-specific feature and may not work on all printers
+ */
+exports.SELECT_FONT_D = [exports.ESC, 0x51];
+/**
+ * ESC V n - Turn 90° clockwise rotation mode on/off
+ * n = 0 or 48: Turn off 90° clockwise rotation mode
+ * n = 1 or 49: Turn on 90° clockwise rotation mode
+ */
+exports.ROTATE_90_ON = [exports.ESC, 0x56, 0x01];
+exports.ROTATE_90_OFF = [exports.ESC, 0x56, 0x00];
+/**
+ * ESC { n - Turn upside-down printing mode on/off
+ * n = 0 or 48: Turn off upside-down printing mode
+ * n = 1 or 49: Turn on upside-down printing mode
+ */
+exports.UPSIDE_DOWN_ON = [exports.ESC, 0x7b, 0x01];
+exports.UPSIDE_DOWN_OFF = [exports.ESC, 0x7b, 0x00];
+/**
+ * ESC - n - Turn underline mode on/off with thickness selection
+ * n = 0 or 48: Turn off underline mode
+ * n = 1 or 49: Turn on underline mode (1-dot thick)
+ * n = 2 or 50: Turn on underline mode (2-dots thick)
+ */
+exports.UNDERLINE_1DOT = [exports.ESC, 0x2d, 0x01];
+exports.UNDERLINE_2DOT = [exports.ESC, 0x2d, 0x02];
+// ============================================================================
+// LINE SPACING & PAPER CONTROL (ADDITIONAL)
+// ============================================================================
+/**
+ * ESC 2 - Select default line spacing
+ * Sets line spacing to approximately 4.23mm (1/6 inch)
+ */
+exports.LINE_SPACING_DEFAULT_ALT = [exports.ESC, 0x32, 0x5];
+/**
+ * ESC J n - Print and feed paper
+ * Range: 0 ≤ n ≤ 255
+ * Feed amount = n × (vertical motion unit)
+ */
+const printAndFeed = (dots) => [
+    exports.ESC,
+    0x4a,
+    Math.max(0, Math.min(255, dots)),
+];
+exports.printAndFeed = printAndFeed;
+/**
+ * ESC K n - Print and reverse feed
+ * Range: 0 ≤ n ≤ 255
+ * Reverse feed amount = n × (vertical motion unit)
+ */
+const printAndReverseFeed = (dots) => [
+    exports.ESC,
+    0x4b,
+    Math.max(0, Math.min(255, dots)),
+];
+exports.printAndReverseFeed = printAndReverseFeed;
+// ============================================================================
+// PAPER CUTTING (ADDITIONAL)
+// ============================================================================
+/**
+ * ESC i - Full cut
+ * Executes a full cut (cuts paper completely)
+ */
+exports.CUT_FULL_ESC = [exports.ESC, 0x69];
+/**
+ * ESC m - Partial cut
+ * Executes a partial cut (leaves connection point)
+ */
+exports.CUT_PARTIAL_ESC = [exports.ESC, 0x6d];
+/**
+ * GS V m n - Cut paper and feed
+ * m = 65 (0x41): Feed then full cut
+ * m = 66 (0x42): Feed then partial cut
+ * n = feed amount before cut
+ */
+const cutAndFeedFull = (dots) => [
+    exports.GS,
+    0x56,
+    0x41,
+    Math.max(0, Math.min(255, dots)),
+];
+exports.cutAndFeedFull = cutAndFeedFull;
+const cutAndFeedPartial = (dots) => [
+    exports.GS,
+    0x56,
+    0x42,
+    Math.max(0, Math.min(255, dots)),
+];
+exports.cutAndFeedPartial = cutAndFeedPartial;
+// ============================================================================
+// PERIPHERAL DEVICE CONTROL
+// ============================================================================
+/**
+ * ESC = n - Select peripheral device
+ * n = 0: Disabled
+ * n = 1: Enabled
+ */
+const selectPeripheral = (enabled) => [
+    exports.ESC,
+    0x3d,
+    enabled ? 0x01 : 0x00,
+];
+exports.selectPeripheral = selectPeripheral;
+/**
+ * ESC p m t1 t2 - Generate pulse
+ * m = 0 or 48: Drawer kick-out connector pin 2
+ * m = 1 or 49: Drawer kick-out connector pin 5
+ * t1 = ON time (0-255, units of 100ms)
+ * t2 = OFF time (0-255, units of 100ms)
+ */
+const generatePulse = (connector, onTime, offTime) => [
+    exports.ESC,
+    0x70,
+    connector,
+    Math.max(0, Math.min(255, onTime)),
+    Math.max(0, Math.min(255, offTime)),
+];
+exports.generatePulse = generatePulse;
+/**
+ * ESC c 3 n - Select paper sensor(s) to output paper-end signals
+ * n is a bitmask for sensor selection
+ */
+const selectPaperSensorOutput = (sensorMask) => [
+    exports.ESC,
+    0x63,
+    0x33,
+    sensorMask,
+];
+exports.selectPaperSensorOutput = selectPaperSensorOutput;
+/**
+ * ESC c 4 n - Select paper sensor(s) to stop printing
+ * n is a bitmask for sensor selection
+ */
+const selectPaperSensorStop = (sensorMask) => [
+    exports.ESC,
+    0x63,
+    0x34,
+    sensorMask,
+];
+exports.selectPaperSensorStop = selectPaperSensorStop;
+/**
+ * ESC c 5 n - Enable/disable panel buttons
+ * n = 0: Enable panel buttons
+ * n = 1: Disable panel buttons
+ */
+const enablePanelButtons = () => [exports.ESC, 0x63, 0x35, 0x00];
+exports.enablePanelButtons = enablePanelButtons;
+const disablePanelButtons = () => [exports.ESC, 0x63, 0x35, 0x01];
+exports.disablePanelButtons = disablePanelButtons;
+// ============================================================================
+// CHARACTER CODE TABLES
+// ============================================================================
+/**
+ * International character set selection
+ */
+var InternationalCharset;
+(function (InternationalCharset) {
+    InternationalCharset[InternationalCharset["USA"] = 0] = "USA";
+    InternationalCharset[InternationalCharset["FRANCE"] = 1] = "FRANCE";
+    InternationalCharset[InternationalCharset["GERMANY"] = 2] = "GERMANY";
+    InternationalCharset[InternationalCharset["UK"] = 3] = "UK";
+    InternationalCharset[InternationalCharset["DENMARK_I"] = 4] = "DENMARK_I";
+    InternationalCharset[InternationalCharset["SWEDEN"] = 5] = "SWEDEN";
+    InternationalCharset[InternationalCharset["ITALY"] = 6] = "ITALY";
+    InternationalCharset[InternationalCharset["SPAIN_I"] = 7] = "SPAIN_I";
+    InternationalCharset[InternationalCharset["JAPAN"] = 8] = "JAPAN";
+    InternationalCharset[InternationalCharset["NORWAY"] = 9] = "NORWAY";
+    InternationalCharset[InternationalCharset["DENMARK_II"] = 10] = "DENMARK_II";
+    InternationalCharset[InternationalCharset["SPAIN_II"] = 11] = "SPAIN_II";
+    InternationalCharset[InternationalCharset["LATIN_AMERICA"] = 12] = "LATIN_AMERICA";
+    InternationalCharset[InternationalCharset["KOREA"] = 13] = "KOREA";
+})(InternationalCharset || (exports.InternationalCharset = InternationalCharset = {}));
+/**
+ * ESC R n - Select international character set
+ */
+const selectInternationalCharset = (charset) => [exports.ESC, 0x52, charset];
+exports.selectInternationalCharset = selectInternationalCharset;
+/**
+ * Extended code page enumeration
+ */
+var CodePage;
+(function (CodePage) {
+    CodePage[CodePage["CP437"] = 0] = "CP437";
+    CodePage[CodePage["CP850"] = 2] = "CP850";
+    CodePage[CodePage["CP860"] = 3] = "CP860";
+    CodePage[CodePage["CP863"] = 4] = "CP863";
+    CodePage[CodePage["CP865"] = 5] = "CP865";
+    CodePage[CodePage["CP851"] = 11] = "CP851";
+    CodePage[CodePage["CP853"] = 12] = "CP853";
+    CodePage[CodePage["CP857"] = 13] = "CP857";
+    CodePage[CodePage["CP737"] = 14] = "CP737";
+    CodePage[CodePage["CP928"] = 16] = "CP928";
+    CodePage[CodePage["CP866"] = 17] = "CP866";
+    CodePage[CodePage["CP852"] = 18] = "CP852";
+    CodePage[CodePage["CP858"] = 19] = "CP858";
+    CodePage[CodePage["WPC1252"] = 16] = "WPC1252";
+})(CodePage || (exports.CodePage = CodePage = {}));
+/**
+ * ESC t n - Select character code table
+ */
+const setCodePage = (page) => [exports.ESC, 0x74, page];
+exports.setCodePage = setCodePage;
+// ============================================================================
+// GRAPHICS - BIT IMAGE
+// ============================================================================
+/**
+ * Bit image modes for ESC *
+ */
+var BitImageMode;
+(function (BitImageMode) {
+    BitImageMode[BitImageMode["MODE_8_SINGLE"] = 0] = "MODE_8_SINGLE";
+    BitImageMode[BitImageMode["MODE_8_DOUBLE"] = 1] = "MODE_8_DOUBLE";
+    BitImageMode[BitImageMode["MODE_24_SINGLE"] = 32] = "MODE_24_SINGLE";
+    BitImageMode[BitImageMode["MODE_24_DOUBLE"] = 33] = "MODE_24_DOUBLE";
+})(BitImageMode || (exports.BitImageMode = BitImageMode = {}));
+/**
+ * ESC * m nL nH d1...dk - Print bit image
+ * m: Bit image mode
+ * nL, nH: Number of data columns (nL + nH × 256)
+ * d1...dk: Bit image data
+ */
+const printBitImage = (mode, width, data) => {
+    const nL = width & 0xff;
+    const nH = (width >> 8) & 0xff;
+    return [exports.ESC, 0x2a, mode, nL, nH, ...data];
+};
+exports.printBitImage = printBitImage;
+// ============================================================================
+// GRAPHICS - DOWNLOADED BIT IMAGE
+// ============================================================================
+/**
+ * GS * x y d1...dk - Define downloaded bit image
+ * x: Number of bytes in horizontal direction (1 ≤ x ≤ 255)
+ * y: Number of bytes in vertical direction (1 ≤ y ≤ 48)
+ * Horizontal dots = x × 8
+ * Vertical dots = y × 8
+ */
+const defineDownloadedBitImage = (x, y, data) => {
+    const xVal = Math.max(1, Math.min(255, x));
+    const yVal = Math.max(1, Math.min(48, y));
+    return [exports.GS, 0x2a, xVal, yVal, ...data];
+};
+exports.defineDownloadedBitImage = defineDownloadedBitImage;
+/**
+ * Downloaded image print modes
+ */
+var DownloadedImageMode;
+(function (DownloadedImageMode) {
+    DownloadedImageMode[DownloadedImageMode["NORMAL"] = 0] = "NORMAL";
+    DownloadedImageMode[DownloadedImageMode["DOUBLE_WIDTH"] = 1] = "DOUBLE_WIDTH";
+    DownloadedImageMode[DownloadedImageMode["DOUBLE_HEIGHT"] = 2] = "DOUBLE_HEIGHT";
+    DownloadedImageMode[DownloadedImageMode["QUADRUPLE"] = 3] = "QUADRUPLE";
+})(DownloadedImageMode || (exports.DownloadedImageMode = DownloadedImageMode = {}));
+/**
+ * GS / m - Print downloaded bit image
+ * m: Print mode (0-3)
+ */
+const printDownloadedBitImage = (mode) => [exports.GS, 0x2f, mode];
+exports.printDownloadedBitImage = printDownloadedBitImage;
+// ============================================================================
+// GRAPHICS - NV BIT IMAGE
+// ============================================================================
+/**
+ * FS p n m - Print NV bit image
+ * n: NV bit image number (1-255)
+ * m: Print mode (0-3, same as DownloadedImageMode)
+ */
+const printNVBitImage = (imageNumber, mode) => [exports.FS, 0x70, Math.max(1, Math.min(255, imageNumber)), mode];
+exports.printNVBitImage = printNVBitImage;
+/**
+ * FS q n [xL xH yL yH d1...dk]1...n - Define NV bit image
+ * n: Number of NV bit images to define (1-255)
+ * For each image:
+ *   xL, xH: Width in bytes ((xH × 256 + xL) × 8 dots)
+ *   yL, yH: Height in bytes ((yH × 256 + yL) × 8 dots)
+ *   d1...dk: Bit image data
+ */
+const defineNVBitImage = (images) => {
+    const result = [exports.FS, 0x71, Math.min(images.length, 255)];
+    for (const img of images.slice(0, 255)) {
+        const xL = img.width & 0xff;
+        const xH = (img.width >> 8) & 0xff;
+        const yL = img.height & 0xff;
+        const yH = (img.height >> 8) & 0xff;
+        result.push(xL, xH, yL, yH, ...img.data);
+    }
+    return result;
+};
+exports.defineNVBitImage = defineNVBitImage;
+// ============================================================================
+// BARCODE CONFIGURATION
+// ============================================================================
+/**
+ * Barcode HRI (Human Readable Interpretation) position
+ */
+var BarcodeHRIPosition;
+(function (BarcodeHRIPosition) {
+    BarcodeHRIPosition[BarcodeHRIPosition["NOT_PRINTED"] = 0] = "NOT_PRINTED";
+    BarcodeHRIPosition[BarcodeHRIPosition["ABOVE"] = 1] = "ABOVE";
+    BarcodeHRIPosition[BarcodeHRIPosition["BELOW"] = 2] = "BELOW";
+    BarcodeHRIPosition[BarcodeHRIPosition["BOTH"] = 3] = "BOTH";
+})(BarcodeHRIPosition || (exports.BarcodeHRIPosition = BarcodeHRIPosition = {}));
+/**
+ * GS H n - Select HRI character print position
+ */
+const setBarcodeHRI = (position) => [
+    exports.GS,
+    0x48,
+    position,
+];
+exports.setBarcodeHRI = setBarcodeHRI;
+/**
+ * GS f n - Select font for HRI characters
+ * n = 0 or 48: Font A
+ * n = 1 or 49: Font B
+ */
+const setBarcodeFont = (fontB) => [
+    exports.GS,
+    0x66,
+    fontB ? 0x01 : 0x00,
+];
+exports.setBarcodeFont = setBarcodeFont;
+/**
+ * GS h n - Set barcode height
+ * Range: 1 ≤ n ≤ 255 (in dots)
+ * Default: 162
+ */
+const setBarcodeHeight = (height) => [
+    exports.GS,
+    0x68,
+    Math.max(1, Math.min(255, height)),
+];
+exports.setBarcodeHeight = setBarcodeHeight;
+/**
+ * GS w n - Set barcode width
+ * Range: 2 ≤ n ≤ 6 (module width in dots)
+ * Default: 3
+ */
+const setBarcodeWidth = (width) => [
+    exports.GS,
+    0x77,
+    Math.max(2, Math.min(6, width)),
+];
+exports.setBarcodeWidth = setBarcodeWidth;
+// ============================================================================
+// BARCODE PRINTING
+// ============================================================================
+/**
+ * Barcode symbologies
+ */
+var BarcodeType;
+(function (BarcodeType) {
+    BarcodeType[BarcodeType["UPC_A"] = 0] = "UPC_A";
+    BarcodeType[BarcodeType["UPC_E"] = 1] = "UPC_E";
+    BarcodeType[BarcodeType["EAN13"] = 2] = "EAN13";
+    BarcodeType[BarcodeType["EAN8"] = 3] = "EAN8";
+    BarcodeType[BarcodeType["CODE39"] = 4] = "CODE39";
+    BarcodeType[BarcodeType["ITF"] = 5] = "ITF";
+    BarcodeType[BarcodeType["CODABAR"] = 6] = "CODABAR";
+    BarcodeType[BarcodeType["CODE93"] = 72] = "CODE93";
+    BarcodeType[BarcodeType["CODE128"] = 73] = "CODE128";
+})(BarcodeType || (exports.BarcodeType = BarcodeType = {}));
+/**
+ * GS k m d1...dk NUL - Print barcode (NUL-terminated)
+ * For barcode types 0-6 (UPC-A, UPC-E, EAN-13, EAN-8, CODE39, ITF, CODABAR)
+ */
+const printBarcode = (type, data) => {
+    const bytes = data.split("").map((c) => c.charCodeAt(0));
+    return [exports.GS, 0x6b, type, ...bytes, 0x00];
+};
+exports.printBarcode = printBarcode;
+/**
+ * GS k m n d1...dn - Print barcode (length-specified)
+ * For barcode types 65-73 (with length prefix)
+ */
+const printBarcodeWithLength = (type, data) => {
+    const bytes = data.split("").map((c) => c.charCodeAt(0));
+    return [exports.GS, 0x6b, type, bytes.length, ...bytes];
+};
+exports.printBarcodeWithLength = printBarcodeWithLength;
+/**
+ * Print UPC-A barcode
+ * Requires 11-12 digits
+ */
+const printBarcodeUPCA = (data) => {
+    if (!/^\d{11,12}$/.test(data)) {
+        throw new Error("UPC-A requires 11-12 digits");
+    }
+    return (0, exports.printBarcode)(BarcodeType.UPC_A, data.slice(0, 12));
+};
+exports.printBarcodeUPCA = printBarcodeUPCA;
+/**
+ * Print UPC-E barcode
+ * Requires 6-8 digits
+ */
+const printBarcodeUPCE = (data) => {
+    if (!/^\d{6,8}$/.test(data)) {
+        throw new Error("UPC-E requires 6-8 digits");
+    }
+    return (0, exports.printBarcode)(BarcodeType.UPC_E, data);
+};
+exports.printBarcodeUPCE = printBarcodeUPCE;
+/**
+ * Print EAN-13 barcode
+ * Requires 12-13 digits
+ */
+const printBarcodeEAN13 = (data) => {
+    if (!/^\d{12,13}$/.test(data)) {
+        throw new Error("EAN-13 requires 12-13 digits");
+    }
+    return (0, exports.printBarcode)(BarcodeType.EAN13, data.slice(0, 13));
+};
+exports.printBarcodeEAN13 = printBarcodeEAN13;
+/**
+ * Print EAN-8 barcode
+ * Requires 7-8 digits
+ */
+const printBarcodeEAN8 = (data) => {
+    if (!/^\d{7,8}$/.test(data)) {
+        throw new Error("EAN-8 requires 7-8 digits");
+    }
+    return (0, exports.printBarcode)(BarcodeType.EAN8, data);
+};
+exports.printBarcodeEAN8 = printBarcodeEAN8;
+/**
+ * Print CODE39 barcode
+ * Supports: 0-9, A-Z, space, and symbols ($ % + - . /)
+ */
+const printBarcodeCODE39 = (data) => {
+    if (!/^[0-9A-Z $%+\-.\/]+$/.test(data)) {
+        throw new Error("CODE39 supports: 0-9, A-Z, space, $%+-./ only");
+    }
+    return (0, exports.printBarcode)(BarcodeType.CODE39, data);
+};
+exports.printBarcodeCODE39 = printBarcodeCODE39;
+/**
+ * Print ITF barcode (Interleaved 2 of 5)
+ * Requires even number of digits
+ */
+const printBarcodeITF = (data) => {
+    if (!/^\d+$/.test(data) || data.length % 2 !== 0) {
+        throw new Error("ITF requires even number of digits");
+    }
+    return (0, exports.printBarcode)(BarcodeType.ITF, data);
+};
+exports.printBarcodeITF = printBarcodeITF;
+/**
+ * Print CODABAR barcode
+ * Supports: 0-9, A-D, and symbols ($ + - . / :)
+ */
+const printBarcodeCODABAR = (data) => {
+    if (!/^[A-D][0-9A-D $+\-.\/:]*[A-D]$/.test(data)) {
+        throw new Error("CODABAR must start and end with A-D, and contain 0-9, A-D, $+-./:");
+    }
+    return (0, exports.printBarcode)(BarcodeType.CODABAR, data);
+};
+exports.printBarcodeCODABAR = printBarcodeCODABAR;
+/**
+ * Print CODE93 barcode
+ * Supports all ASCII characters (0-127)
+ */
+const printBarcodeCODE93 = (data) => {
+    return (0, exports.printBarcodeWithLength)(BarcodeType.CODE93, data);
+};
+exports.printBarcodeCODE93 = printBarcodeCODE93;
+/**
+ * Print CODE128 barcode
+ * Supports all ASCII characters (0-127)
+ */
+const printBarcodeCODE128 = (data) => {
+    return (0, exports.printBarcodeWithLength)(BarcodeType.CODE128, data);
+};
+exports.printBarcodeCODE128 = printBarcodeCODE128;
+// ============================================================================
+// 2D CODES - PDF417
+// ============================================================================
+/**
+ * GS ( k pL pH cn fn [parameters] - PDF417 commands
+ * cn = 0x30 (function code 48 for PDF417)
+ */
+/**
+ * Set PDF417 number of columns
+ * fn = 0x41, n = number of columns (0 or 1-30)
+ */
+const setPDF417Columns = (columns) => {
+    const col = Math.max(0, Math.min(30, columns));
+    return [exports.GS, 0x28, 0x6b, 0x03, 0x00, 0x30, 0x41, col];
+};
+exports.setPDF417Columns = setPDF417Columns;
+/**
+ * Set PDF417 number of rows
+ * fn = 0x42, n = number of rows (0 or 3-90)
+ */
+const setPDF417Rows = (rows) => {
+    const row = rows === 0 ? 0 : Math.max(3, Math.min(90, rows));
+    return [exports.GS, 0x28, 0x6b, 0x03, 0x00, 0x30, 0x42, row];
+};
+exports.setPDF417Rows = setPDF417Rows;
+/**
+ * Set PDF417 module width
+ * fn = 0x43, n = module width (2-8 dots)
+ */
+const setPDF417Width = (width) => {
+    const w = Math.max(2, Math.min(8, width));
+    return [exports.GS, 0x28, 0x6b, 0x03, 0x00, 0x30, 0x43, w];
+};
+exports.setPDF417Width = setPDF417Width;
+/**
+ * Set PDF417 row height
+ * fn = 0x44, n = row height (2-8 dots)
+ */
+const setPDF417RowHeight = (height) => {
+    const h = Math.max(2, Math.min(8, height));
+    return [exports.GS, 0x28, 0x6b, 0x03, 0x00, 0x30, 0x44, h];
+};
+exports.setPDF417RowHeight = setPDF417RowHeight;
+/**
+ * Set PDF417 error correction level
+ * fn = 0x45, m = 48 (standard mode), n = level (0-8)
+ */
+const setPDF417ErrorCorrection = (level) => {
+    const lvl = Math.max(0, Math.min(8, level));
+    return [exports.GS, 0x28, 0x6b, 0x04, 0x00, 0x30, 0x45, 0x30, lvl];
+};
+exports.setPDF417ErrorCorrection = setPDF417ErrorCorrection;
+/**
+ * Store PDF417 data
+ * fn = 0x50, m = 48 (standard mode), followed by data
+ */
+const storePDF417Data = (data) => {
+    const bytes = new TextEncoder().encode(data);
+    const pL = (bytes.length + 3) & 0xff;
+    const pH = ((bytes.length + 3) >> 8) & 0xff;
+    return [exports.GS, 0x28, 0x6b, pL, pH, 0x30, 0x50, 0x30, ...Array.from(bytes)];
+};
+exports.storePDF417Data = storePDF417Data;
+/**
+ * Print PDF417 symbol
+ * fn = 0x51, m = 48 (standard mode)
+ */
+const printPDF417 = () => [
+    exports.GS,
+    0x28,
+    0x6b,
+    0x03,
+    0x00,
+    0x30,
+    0x51,
+    0x30,
+];
+exports.printPDF417 = printPDF417;
+/**
+ * Generate complete PDF417 barcode
+ * Convenience function that combines all PDF417 commands
+ */
+const generatePDF417 = (data, options) => {
+    const commands = [];
+    if (options?.columns !== undefined) {
+        commands.push(...(0, exports.setPDF417Columns)(options.columns));
+    }
+    if (options?.rows !== undefined) {
+        commands.push(...(0, exports.setPDF417Rows)(options.rows));
+    }
+    if (options?.width !== undefined) {
+        commands.push(...(0, exports.setPDF417Width)(options.width));
+    }
+    if (options?.rowHeight !== undefined) {
+        commands.push(...(0, exports.setPDF417RowHeight)(options.rowHeight));
+    }
+    if (options?.errorCorrection !== undefined) {
+        commands.push(...(0, exports.setPDF417ErrorCorrection)(options.errorCorrection));
+    }
+    commands.push(...(0, exports.storePDF417Data)(data));
+    commands.push(...(0, exports.printPDF417)());
+    return commands;
+};
+exports.generatePDF417 = generatePDF417;
+// ============================================================================
+// CHARACTER EFFECTS (ADVANCED)
+// ============================================================================
+/**
+ * GS ! n - Select character size
+ * Supports 1-8x width and height multipliers
+ * Bits 0-2: Width (0-7 for 1x-8x)
+ * Bits 4-6: Height (0-7 for 1x-8x)
+ */
+const selectCharacterSize = (widthMultiplier, heightMultiplier) => {
+    const w = Math.max(0, Math.min(7, widthMultiplier - 1));
+    const h = Math.max(0, Math.min(7, heightMultiplier - 1));
+    const n = (w & 0x07) | ((h & 0x07) << 4);
+    return [exports.GS, 0x21, n];
+};
+exports.selectCharacterSize = selectCharacterSize;
+/**
+ * GS B n - Turn white/black reverse printing mode on/off
+ * n = 0 or 48: Turn off white/black reverse mode
+ * n = 1 or 49: Turn on white/black reverse mode
+ */
+exports.REVERSE_PRINT_ON = [exports.GS, 0x42, 0x01];
+exports.REVERSE_PRINT_OFF = [exports.GS, 0x42, 0x00];
+/**
+ * GS ( N pL pH fn n - Select character effects
+ * fn = 48: Set character color
+ * fn = 49: Set character smoothing
+ */
+const setCharacterColor = (color) => [
+    exports.GS,
+    0x28,
+    0x4e,
+    0x02,
+    0x00,
+    0x30,
+    color,
+];
+exports.setCharacterColor = setCharacterColor;
+const setCharacterSmoothing = (enabled) => [
+    exports.GS,
+    0x28,
+    0x4e,
+    0x02,
+    0x00,
+    0x31,
+    enabled ? 0x01 : 0x00,
+];
+exports.setCharacterSmoothing = setCharacterSmoothing;
+// ============================================================================
+// STATUS COMMANDS
+// ============================================================================
+/**
+ * GS a n - Enable/disable Automatic Status Back (ASB)
+ * n is a bitmask for status types to enable
+ */
+const enableASB = (statusBits) => [
+    exports.GS,
+    0x61,
+    statusBits,
+];
+exports.enableASB = enableASB;
+const disableASB = () => [exports.GS, 0x61, 0x00];
+exports.disableASB = disableASB;
+/**
+ * Printer ID types for GS I command
+ */
+var PrinterIDType;
+(function (PrinterIDType) {
+    PrinterIDType[PrinterIDType["PRINTER_MODEL"] = 1] = "PRINTER_MODEL";
+    PrinterIDType[PrinterIDType["TYPE_ID"] = 2] = "TYPE_ID";
+    PrinterIDType[PrinterIDType["ROM_VERSION"] = 65] = "ROM_VERSION";
+    PrinterIDType[PrinterIDType["FONT_TYPE"] = 66] = "FONT_TYPE";
+    PrinterIDType[PrinterIDType["MANUFACTURER"] = 67] = "MANUFACTURER";
+})(PrinterIDType || (exports.PrinterIDType = PrinterIDType = {}));
+/**
+ * GS I n - Transmit printer ID
+ */
+const requestPrinterID = (type) => [
+    exports.GS,
+    0x49,
+    type,
+];
+exports.requestPrinterID = requestPrinterID;
+/**
+ * Status types for GS r command
+ */
+var StatusType;
+(function (StatusType) {
+    StatusType[StatusType["PAPER_SENSOR"] = 1] = "PAPER_SENSOR";
+    StatusType[StatusType["DRAWER_SENSOR"] = 2] = "DRAWER_SENSOR";
+    StatusType[StatusType["INK_SENSOR"] = 4] = "INK_SENSOR";
+    StatusType[StatusType["PAPER_ROLL_SENSOR"] = 18] = "PAPER_ROLL_SENSOR";
+})(StatusType || (exports.StatusType = StatusType = {}));
+/**
+ * GS r n - Transmit status
+ */
+const requestStatus = (type) => [exports.GS, 0x72, type];
+exports.requestStatus = requestStatus;
+// ============================================================================
+// MARGINS & PRINT AREA
+// ============================================================================
+/**
+ * GS L nL nH - Set left margin
+ * Left margin = ((nH × 256) + nL) × (horizontal motion unit)
+ */
+const setLeftMargin = (dots) => {
+    const nL = dots & 0xff;
+    const nH = (dots >> 8) & 0xff;
+    return [exports.GS, 0x4c, nL, nH];
+};
+exports.setLeftMargin = setLeftMargin;
+/**
+ * GS W nL nH - Set printing area width
+ * Width = ((nH × 256) + nL) × (horizontal motion unit)
+ */
+const setPrintingAreaWidth = (dots) => {
+    const nL = dots & 0xff;
+    const nH = (dots >> 8) & 0xff;
+    return [exports.GS, 0x57, nL, nH];
+};
+exports.setPrintingAreaWidth = setPrintingAreaWidth;
+// ============================================================================
+// MACRO FUNCTIONS
+// ============================================================================
+/**
+ * GS : - Start/end macro definition
+ * First call starts macro definition
+ * Second call ends macro definition
+ */
+exports.START_MACRO = [exports.GS, 0x3a];
+exports.END_MACRO = [exports.GS, 0x3a];
+/**
+ * GS ^ r t m - Execute macro
+ * r: Number of times to execute macro (0-255)
+ * t: Waiting time between executions (0-255, units of 100ms)
+ * m: Macro execution mode (0 or 1)
+ */
+const executeMacro = (repeatCount, waitTime, mode) => [
+    exports.GS,
+    0x5e,
+    Math.max(0, Math.min(255, repeatCount)),
+    Math.max(0, Math.min(255, waitTime)),
+    mode,
+];
+exports.executeMacro = executeMacro;
+// ============================================================================
+// MISCELLANEOUS
+// ============================================================================
+/**
+ * ESC U n - Turn unidirectional printing mode on/off
+ * n = 0 or 48: Turn off unidirectional printing
+ * n = 1 or 49: Turn on unidirectional printing
+ */
+exports.UNIDIRECTIONAL_ON = [exports.ESC, 0x55, 0x01];
+exports.UNIDIRECTIONAL_OFF = [exports.ESC, 0x55, 0x00];
+/**
+ * CAN - Cancel print data in page mode
+ * Deletes all print data in the current printable area
+ */
+exports.CANCEL = [exports.CAN];
+/**
+ * ESC ( A pL pH n m r t - Execute test print
+ * pL pH = 2 (fixed)
+ * n = paper pattern (1-3)
+ * m = mode (0-2)
+ * r = number of times to repeat
+ * t = interval time
+ */
+const executeTestPrint = (pattern, mode, repeat) => [
+    exports.ESC,
+    0x28,
+    0x41,
+    0x02,
+    0x00,
+    Math.max(1, Math.min(3, pattern)),
+    Math.max(0, Math.min(2, mode)),
+    repeat,
+    0x00,
+];
+exports.executeTestPrint = executeTestPrint;