@thermal-print/escpos 0.2.0 → 0.3.1-beta.0

package/dist/styles.js

@@ -1,22 +1,8 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.extractTextStyle = extractTextStyle;
-exports.extractViewStyle = extractViewStyle;
-exports.isBold = isBold;
-exports.mapFontSizeToESCPOS = mapFontSizeToESCPOS;
-exports.mapTextAlign = mapTextAlign;
-exports.calculateSpacing = calculateSpacing;
-exports.isDashedBorder = isDashedBorder;
-exports.generateDividerLine = generateDividerLine;
-exports.mergeStyles = mergeStyles;
-exports.parseWidth = parseWidth;
-exports.alignTextInColumn = alignTextInColumn;
-exports.wrapText = wrapText;
-const cp860_1 = require("./encodings/cp860");
+import { encodeCP860 } from "./encodings/cp860";
 /**
  * Extracts text style from a style object
  */
-function extractTextStyle(style) {
+export function extractTextStyle(style) {
     return {
         fontSize: style?.fontSize,
         fontWeight: style?.fontWeight,
@@ -27,7 +13,7 @@ function extractTextStyle(style) {
 /**
  * Extracts view/layout style from a style object
  */
-function extractViewStyle(style) {
+export function extractViewStyle(style) {
     return {
         display: style?.display,
         flexDirection: style?.flexDirection || "column",
@@ -51,49 +37,43 @@ function extractViewStyle(style) {
 /**
  * Determines if text should be bold
  */
-function isBold(style) {
+export function isBold(style) {
     return (style.fontWeight === "bold" ||
         style.fontWeight === 700 ||
         style.fontWeight === "Helvetica-Bold" ||
         style.fontFamily === "Helvetica-Bold");
 }
 /**
- * Maps fontSize to ESC/POS character size (width x height multipliers)
+ * Maps fontSize to ESC/POS font selection + character size multipliers
  *
- * Font size mapping using ESC ! command (limited to 2x2 maximum):
- * - 8-12px  → 1x1 (normal)
- * - 13-18px → 1x2 (normal width, double height)
- * - 19-24px → 2x1 (double width, normal height)
- * - 25+px   → 2x2 (double width, double height)
+ * Three visual levels using standard ESC/POS fonts:
+ * - Condensada: Font B 1x1 (9x17, 64 cols) — fontSize <= 10
+ * - Normal:     Font A 1x1 (12x24, 48 cols) — fontSize 11-19
+ * - Expandida:  Font A 2x2 (12x24, 24 cols) — fontSize >= 20
  *
  * Note: ESC ! command only supports up to 2x2 character size.
- * Larger sizes (3x, 4x, etc.) would require GS ! command which may not
- * be supported on all thermal printers (e.g., Bematech MP-4200 TH).
- *
- * PDF uses zoom factor (default 0.46), so actual sizes are smaller:
- * - 16 * 0.46 = 7.36 (normal text)
- * - 18 * 0.46 = 8.28 (medium text)
- * - 20 * 0.46 = 9.2 (title text)
- *
- * We use raw fontSize values (ignoring zoom) for better differentiation
  */
-function mapFontSizeToESCPOS(fontSize) {
-    // Default to 1x1 (normal size)
+export function mapFontSizeToESCPOS(fontSize) {
+    // Default: Font A normal (48 cols)
     if (!fontSize)
-        return { width: 1, height: 1 };
-    // Parse fontSize if it's a string  (e.g., "8.28px")
+        return { font: 0, width: 1, height: 1 };
+    // Parse fontSize if it's a string (e.g., "8.28px")
     const size = typeof fontSize === "string" ? parseFloat(fontSize) : fontSize;
     if (isNaN(size))
-        return { width: 1, height: 1 };
-    // Map font size to character multipliers (max 2x2 for ESC ! compatibility)
-    if (size >= 20)
-        return { width: 2, height: 2 }; // 25+px → 2x2 (maximum)
-    return { width: 1, height: 1 }; // 8-12px → 1x1 (normal)
+        return { font: 0, width: 1, height: 1 };
+    // Condensada: Font B (64 cols) — fontSize <= 10
+    if (size <= 10)
+        return { font: 1, width: 1, height: 1 };
+    // Normal: Font A (48 cols) — fontSize 11-19
+    if (size <= 19)
+        return { font: 0, width: 1, height: 1 };
+    // Expandida: Font A 2x2 (24 cols) — fontSize >= 20
+    return { font: 0, width: 2, height: 2 };
 }
 /**
  * Maps textAlign to ESC/POS alignment
  */
-function mapTextAlign(textAlign) {
+export function mapTextAlign(textAlign) {
     if (textAlign === "center")
         return "center";
     if (textAlign === "right")
@@ -104,7 +84,7 @@ function mapTextAlign(textAlign) {
  * Calculates spacing (margin/padding) in lines
  * Approximates pixels to line feeds
  */
-function calculateSpacing(value) {
+export function calculateSpacing(value) {
     if (!value)
         return 0;
     // Rough approximation: ~20 pixels = 1 line feed
@@ -113,27 +93,27 @@ function calculateSpacing(value) {
 /**
  * Determines if a border is dashed
  */
-function isDashedBorder(border) {
+export function isDashedBorder(border) {
     return border?.includes("dashed") ?? false;
 }
 /**
  * Generates a divider line based on border style
  */
-function generateDividerLine(width, dashed = false) {
+export function generateDividerLine(width, dashed = false) {
     const char = dashed ? "-" : "─";
     return char.repeat(width);
 }
 /**
  * Merges multiple style objects (handles spread syntax)
  */
-function mergeStyles(...styles) {
+export function mergeStyles(...styles) {
     return Object.assign({}, ...styles.filter((s) => s));
 }
 /**
  * Parses width percentage to column width in characters
  * Uses Math.round() to minimize rounding errors
  */
-function parseWidth(width, totalWidth) {
+export function parseWidth(width, totalWidth) {
     if (!width)
         return totalWidth;
     if (typeof width === "number")
@@ -149,14 +129,14 @@ function parseWidth(width, totalWidth) {
 /**
  * Aligns text within a column width (using CP860 byte length for accurate padding)
  */
-function alignTextInColumn(text, width, align) {
+export function alignTextInColumn(text, width, align) {
     // Get actual byte length when encoded to CP860
-    let encodedLength = (0, cp860_1.encodeCP860)(text).length;
+    let encodedLength = encodeCP860(text).length;
     let truncatedText = text;
     // Truncate if too long (character by character until it fits)
     while (encodedLength > width && truncatedText.length > 0) {
         truncatedText = truncatedText.substring(0, truncatedText.length - 1);
-        encodedLength = (0, cp860_1.encodeCP860)(truncatedText).length;
+        encodedLength = encodeCP860(truncatedText).length;
     }
     // Calculate padding based on actual encoded byte length
     const padding = width - encodedLength;
@@ -181,7 +161,7 @@ function alignTextInColumn(text, width, align) {
 /**
  * Splits text into multiple lines if it exceeds width
  */
-function wrapText(text, width) {
+export function wrapText(text, width) {
     if (text.length <= width) {
         return [text];
     }

package/dist/traverser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"traverser.d.ts","sourceRoot":"","sources":["../src/traverser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAG9C;;;GAGG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,SAAS,CAAkB;gBAEvB,SAAS,EAAE,eAAe;IAItC;;OAEG;IACG,QAAQ,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IA+BvD;;OAEG;YACW,cAAc;IAO5B;;OAEG;YACW,UAAU;IAIxB;;OAEG;YACW,UAAU;IAkBxB;;;OAGG;YACW,kBAAkB;IAchC;;OAEG;YACW,eAAe;IAiH7B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAczB;;OAEG;YACW,kBAAkB;IAmBhC;;OAEG;YACW,UAAU;IAgCxB;;OAEG;YACW,cAAc;IAM5B;;OAEG;YACW,WAAW;IA+BzB;;OAEG;YACW,gBAAgB;CAK/B"}
+{"version":3,"file":"traverser.d.ts","sourceRoot":"","sources":["../src/traverser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAG9C;;;GAGG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,SAAS,CAAkB;gBAEvB,SAAS,EAAE,eAAe;IAItC;;OAEG;IACG,QAAQ,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IA+BvD;;OAEG;YACW,cAAc;IAO5B;;OAEG;YACW,UAAU;IAIxB;;OAEG;YACW,UAAU;IAkBxB;;;OAGG;YACW,kBAAkB;IAchC;;OAEG;YACW,eAAe;IA0I7B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAczB;;OAEG;YACW,kBAAkB;IAmBhC;;OAEG;YACW,UAAU;IAiCxB;;OAEG;YACW,cAAc;IAM5B;;OAEG;YACW,WAAW;IA+BzB;;OAEG;YACW,gBAAgB;CAK/B"}

package/dist/traverser.js

@@ -1,12 +1,9 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.TreeTraverser = void 0;
-const styles_1 = require("./styles");
+import { alignTextInColumn, extractTextStyle, extractViewStyle, mapFontSizeToESCPOS, mapTextAlign, mergeStyles, parseWidth } from "./styles";
 /**
  * Tree Traverser
  * Walks through the element tree and generates ESC/POS commands
  */
-class TreeTraverser {
+export class TreeTraverser {
     constructor(generator) {
         this.generator = generator;
     }
@@ -61,7 +58,7 @@ class TreeTraverser {
      * Handle View element (container with layout)
      */
     async handleView(node) {
-        const viewStyle = (0, styles_1.extractViewStyle)(node.style);
+        const viewStyle = extractViewStyle(node.style);
         // Apply spacing before
         this.generator.applyViewSpacing(node.style, "before");
         // Handle different layout modes
@@ -103,8 +100,7 @@ class TreeTraverser {
             await this.traverse(children[0]);
             return;
         }
-        const viewStyle = (0, styles_1.extractViewStyle)(node.style);
-        const paperWidth = this.generator.getPaperWidth();
+        const viewStyle = extractViewStyle(node.style);
         // Check layout justification mode
         const isSpaceBetween = viewStyle.justifyContent === "space-between";
         const isCentered = viewStyle.justifyContent === "center";
@@ -115,23 +111,42 @@ class TreeTraverser {
         let rowTextStyle = null;
         const firstTextNode = this.findFirstTextNode(children[0]);
         if (firstTextNode && firstTextNode.style) {
-            rowTextStyle = (0, styles_1.mergeStyles)(firstTextNode.style);
+            rowTextStyle = mergeStyles(firstTextNode.style);
         }
+        // Calculate effective paper width based on the row's font/size
+        let paperWidth = this.generator.getPaperWidth();
+        if (rowTextStyle) {
+            const rowFontSize = mapFontSizeToESCPOS(rowTextStyle.fontSize);
+            if (rowFontSize.font === 1) {
+                paperWidth = 64; // Font B: 64 cols
+            }
+            else if (rowFontSize.width >= 2) {
+                paperWidth = Math.floor(this.generator.getPaperWidth() / 2); // Font A 2x: 24 cols
+            }
+            else {
+                paperWidth = 48; // Font A normal: 48 cols
+            }
+        }
+        // First pass: calculate explicit widths and track remaining space
+        let usedWidth = 0;
+        let columnsWithoutWidth = 0;
+        const childData = [];
         for (const child of children) {
-            const childStyle = (0, styles_1.extractViewStyle)(child.style);
-            const width = (0, styles_1.parseWidth)(childStyle.width, paperWidth);
-            // Collect text content from child
+            const childStyle = extractViewStyle(child.style);
+            const hasWidth = childStyle.width !== undefined;
+            const explicitWidth = hasWidth ? parseWidth(childStyle.width, paperWidth) : 0;
+            if (hasWidth)
+                usedWidth += explicitWidth;
+            else
+                columnsWithoutWidth++;
             const content = await this.collectTextContent(child);
-            // Determine alignment - check for Text node textAlign first
             let align = "left";
-            // Look for Text element with textAlign
             const textNode = this.findFirstTextNode(child);
             if (textNode && textNode.style) {
-                const textStyle = (0, styles_1.extractTextStyle)(textNode.style);
-                align = (0, styles_1.mapTextAlign)(textStyle.textAlign);
+                const textStyle = extractTextStyle(textNode.style);
+                align = mapTextAlign(textStyle.textAlign);
             }
             else {
-                // Fall back to View alignment
                 if (childStyle.alignItems === "center" || childStyle.justifyContent === "center") {
                     align = "center";
                 }
@@ -139,18 +154,26 @@ class TreeTraverser {
                     align = "right";
                 }
             }
-            columns.push({ node: child, width, content, align });
+            childData.push({ childStyle, hasWidth, explicitWidth, content, align, node: child });
+        }
+        // Second pass: distribute remaining width to columns without explicit widths
+        const remainingWidth = Math.max(0, paperWidth - usedWidth);
+        const autoWidth = columnsWithoutWidth > 0 ? Math.floor(remainingWidth / columnsWithoutWidth) : paperWidth;
+        for (const data of childData) {
+            const width = data.hasWidth ? data.explicitWidth : autoWidth;
+            columns.push({ node: data.node, width, content: data.content, align: data.align });
         }
         // Build row text
         let rowText = "";
         // Check if columns have explicit widths (table layout) or should use space-between
         const hasExplicitWidths = columns.some((col) => {
-            const childStyle = (0, styles_1.extractViewStyle)(col.node.style);
+            const childStyle = extractViewStyle(col.node.style);
             return childStyle.width !== undefined;
         });
-        if (isSpaceBetween && columns.length === 2 && !hasExplicitWidths) {
-            // Special handling for space-between layout (payment summary style) WITHOUT explicit widths
-            // Calculate space between
+        if (columns.length === 2 && !hasExplicitWidths) {
+            // 2-column layout without explicit widths: treat as space-between
+            // This covers both explicit space-between and flexGrow patterns
+            // (common receipt pattern: label on left, value on right)
             const usedSpace = columns[0].content.length + columns[1].content.length;
             const gap = Math.max(1, paperWidth - usedSpace);
             rowText = columns[0].content + " ".repeat(gap) + columns[1].content;
@@ -176,7 +199,7 @@ class TreeTraverser {
             // Normal column layout OR space-between with explicit widths (use column padding)
             for (let i = 0; i < columns.length; i++) {
                 const col = columns[i];
-                const cellText = (0, styles_1.alignTextInColumn)(col.content, col.width, col.align);
+                const cellText = alignTextInColumn(col.content, col.width, col.align);
                 rowText += cellText;
             }
         }
@@ -229,7 +252,7 @@ class TreeTraverser {
      */
     async handleText(node) {
         // Merge styles from parent if needed
-        const style = (0, styles_1.mergeStyles)(node.style);
+        const style = mergeStyles(node.style);
         // Apply text styling (sets alignment, bold, size)
         this.generator.applyTextStyle(style);
         // Get text content
@@ -246,10 +269,11 @@ class TreeTraverser {
         }
         // Traverse children (nested Text elements)
         await this.traverseChildren(node);
-        // Reset formatting after text (especially bold)
-        this.generator.resetFormatting();
-        // Add newline after text element
+        // Add newline BEFORE resetting formatting so alignment takes effect at LF
+        // (ESC/POS applies alignment at print time, i.e. when LF is sent)
         this.generator.addNewline();
+        // Reset formatting after the line is printed
+        this.generator.resetFormatting();
     }
     /**
      * Handle TextNode (raw text)
@@ -266,13 +290,13 @@ class TreeTraverser {
         const source = node.props.source || node.props.src;
         if (source) {
             // Apply alignment from style (check both node style and parent style)
-            const style = (0, styles_1.mergeStyles)(node.style);
-            const viewStyle = (0, styles_1.extractViewStyle)(style);
-            const textStyle = (0, styles_1.extractTextStyle)(style);
+            const style = mergeStyles(node.style);
+            const viewStyle = extractViewStyle(style);
+            const textStyle = extractTextStyle(style);
             // Determine alignment from textAlign or justifyContent
             let align = "left";
             if (textStyle.textAlign) {
-                align = (0, styles_1.mapTextAlign)(textStyle.textAlign);
+                align = mapTextAlign(textStyle.textAlign);
             }
             else if (viewStyle.justifyContent === "center" || viewStyle.alignItems === "center") {
                 align = "center";
@@ -297,4 +321,3 @@ class TreeTraverser {
         }
     }
 }
-exports.TreeTraverser = TreeTraverser;

package/dist/types.d.ts

@@ -8,11 +8,13 @@ export interface ESCPOSCommand {
 }
 export interface ConversionContext {
     paperWidth: number;
+    basePaperWidth: number;
     currentAlign: 'left' | 'center' | 'right';
     currentSize: {
         width: number;
         height: number;
     };
+    currentFont: 0 | 1;
     currentBold: boolean;
     encoding: string;
     debug: boolean;

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,IAAI,CAAC;IACvD,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;IAC1C,WAAW,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/C,WAAW,EAAE,OAAO,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,IAAI,CAAC;IACvD,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;IAC1C,WAAW,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/C,WAAW,EAAE,CAAC,GAAG,CAAC,CAAC;IACnB,WAAW,EAAE,OAAO,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB"}

package/dist/types.js

@@ -1,5 +1,4 @@
-"use strict";
 /**
  * ESC/POS-specific type definitions
  */
-Object.defineProperty(exports, "__esModule", { value: true });
+export {};

package/package.json

@@ -1,9 +1,22 @@
 {
   "name": "@thermal-print/escpos",
-  "version": "0.2.0",
+  "version": "0.3.1-beta.0",
+  "type": "module",
   "description": "ESC/POS command generation and thermal printer control",
   "main": "dist/index.js",
+  "module": "dist/index.js",
   "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc --build",
+    "build:watch": "tsc --build --watch"
+  },
   "keywords": [
     "thermal-printer",
     "escpos",
@@ -13,8 +26,8 @@
   "author": "",
   "license": "MIT",
   "dependencies": {
-    "jimp": "^1.6.0",
-    "@thermal-print/core": "0.2.0"
+    "@thermal-print/core": "0.3.1-beta.0",
+    "jimp": "^1.6.0"
   },
   "devDependencies": {
     "typescript": "^5.0.0"
@@ -24,9 +37,5 @@
   },
   "files": [
     "dist"
-  ],
-  "scripts": {
-    "build": "tsc --build",
-    "build:watch": "tsc --build --watch"
-  }
-}
+  ]
+}

package/LICENSE

@@ -1,21 +0,0 @@
-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.