rerobe-js-orm 4.9.8 → 4.9.9

package/lib/helpers/ReceiptXmlHelpers.d.ts

@@ -1,6 +1,16 @@
+export type ReceiptPreviewLine = {
+    align: 'left' | 'center' | 'right';
+    bold: boolean;
+    size: number;
+    text: string;
+    cut?: boolean;
+};
 export default class ReceiptXmlHelpers {
     static escapeXML(text: any): string;
     private static variantLabelForReceipt;
     static formatLineItemXML(lineItem: any): string;
     static buildReceiptContentXML(receiptData: any): string;
+    private static decodeXML;
+    private static parseAttrs;
+    static parseReceiptXml(xml: string): ReceiptPreviewLine[];
 }

package/lib/helpers/ReceiptXmlHelpers.js

@@ -231,5 +231,89 @@ class ReceiptXmlHelpers {
         receipt += '</epos-print>';
         return receipt;
     }
+    // Decode the 5 XML entities escapeXML produces, back to their characters.
+    // `&amp;` is decoded last so `&amp;lt;` round-trips to `&lt;`, not `<`.
+    static decodeXML(text) {
+        return String(text)
+            .replace(/&lt;/g, '<')
+            .replace(/&gt;/g, '>')
+            .replace(/&quot;/g, '"')
+            .replace(/&#39;/g, "'")
+            .replace(/&amp;/g, '&');
+    }
+    // Parse `attr="value"` pairs out of a tag's attribute string.
+    static parseAttrs(raw) {
+        const attrs = {};
+        const re = /(\w+)="([^"]*)"/g;
+        let m = re.exec(raw);
+        while (m) {
+            attrs[m[1]] = m[2];
+            m = re.exec(raw);
+        }
+        return attrs;
+    }
+    // Inverse of buildReceiptContentXML for PREVIEW rendering: turn the exact
+    // ePOS-Print XML the printer receives into an ordered list of styled lines, so
+    // a simulator can render byte-for-byte what will print without re-deriving the
+    // layout from raw receipt fields (which silently drifts when a field is added).
+    //
+    // ePOS-Print printer state (align, double width/height, emphasis) is sticky —
+    // it persists across <text> elements until changed — so we carry it forward.
+    // <feed/> ends a line; <cut/> is emitted as a cut marker. Spaces are preserved
+    // verbatim (line items pad to a fixed column width), so render with a
+    // fixed-width font and white-space: pre to reproduce the columns.
+    //
+    // Returns styled lines ({ align, bold, size (1|2), text, cut? }) in print order.
+    static parseReceiptXml(xml) {
+        const lines = [];
+        if (!xml)
+            return lines;
+        // Sticky printer state.
+        let align = 'left';
+        let bold = false;
+        let size = 1;
+        // Current line buffer (reflects the state at the time text was appended).
+        let buf = '';
+        let hasText = false;
+        const flush = () => {
+            lines.push({ align, bold, size, text: buf });
+            buf = '';
+            hasText = false;
+        };
+        const tokenRe = /<text\b([^>]*?)\/>|<text\b([^>]*)>([\s\S]*?)<\/text>|<feed\s*\/>|<cut\b[^>]*?\/>/g;
+        let t = tokenRe.exec(xml);
+        while (t) {
+            const whole = t[0];
+            if (whole.indexOf('<feed') === 0) {
+                flush();
+            }
+            else if (whole.indexOf('<cut') === 0) {
+                if (hasText || buf)
+                    flush();
+                lines.push({ align: 'center', bold: false, size: 1, text: '', cut: true });
+            }
+            else {
+                // A <text> element: self-closing (state only) or with content.
+                const selfClosing = t[1] !== undefined;
+                const attrs = this.parseAttrs(selfClosing ? t[1] : t[2]);
+                if (attrs.align === 'left' || attrs.align === 'center' || attrs.align === 'right') {
+                    align = attrs.align;
+                }
+                if (attrs.width)
+                    size = parseInt(attrs.width, 10) >= 2 ? 2 : 1;
+                if (attrs.em !== undefined)
+                    bold = attrs.em === 'true';
+                if (!selfClosing && t[3]) {
+                    buf += this.decodeXML(t[3]);
+                    hasText = true;
+                }
+            }
+            t = tokenRe.exec(xml);
+        }
+        // Trailing content with no closing <feed/>.
+        if (hasText || buf)
+            flush();
+        return lines;
+    }
 }
 exports.default = ReceiptXmlHelpers;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rerobe-js-orm",
-  "version": "4.9.8",
+  "version": "4.9.9",
   "description": "ReRobe's Javascript ORM Framework",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",