@kreiseck/kasseneck-api 0.23.0 → 0.25.0

package/CHANGELOG.md

@@ -4,6 +4,21 @@ Was vor 0.7.0 geschah, steht in der Commit-Historie (`git log`); ab hier wird
 es hier geführt. Ein Eintrag nennt die Änderung **und ihren Grund** —
 nur der Grund überlebt den nächsten Umbau.
 
+## 0.25.0
+
+- ESC/POS: den Sofort-Reset der Ausrichtung direkt nach QR-Code, QR-Rasterbild und
+  Logo-Rasterbild entfernt. Er behandelte nur ein Symptom: seit 0.24.0 steht `ESC a`
+  ohnehin vor `ESC $`, und eine volle Zeile bekommt gar keinen Positionsbefehl mehr —
+  der Ausrichtungsbefehl des naechsten Elements steht damit selbst immer am
+  Zeilenanfang und gilt. Der erzeugte Bytestrom ist dadurch wieder deckungsgleich mit
+  dem Dart-Zwilling; bisher war dieser Reset der einzige Unterschied zwischen beiden.
+
+## 0.24.0
+
+- ESC/POS: `ESC a` steht vor `ESC $`, eine volle Zeile bekommt keinen Positionsbefehl mehr.
+  Der Drucker nimmt die Ausrichtung nur am Zeilenanfang an; bisher blieb nach dem QR-Code die
+  Zentrierung stehen und zentrierte jede Zeile darunter ein zweites Mal.
+
 ## 0.23.0
 
 ### Rechnung: der Rechenkern in ganzen Zahlen

package/dist/cjs/printing/escpos.d.ts

@@ -208,10 +208,6 @@ export declare function escPosSetGlobalFont(doc: EscPosDocument, font: PosFont |
  * weglaesst, schaltet fett also ab.
  */
 export declare function escPosSetStyles(doc: EscPosDocument, styles?: PosStyles): void;
-/**
- * Interner Textdruck: absolute Position setzen (`ESC $`), Stil senden, Bytes
- * ausgeben. [colInd]/[colWidth] beschreiben die Spalte im Zwoelftel-Raster.
- */
 /**
  * Wortweiser Umbruch von (kodierten) Text-Bytes auf hoechstens `max` Zeichen
  * je Zeile: geschnitten wird am letzten Leerzeichen innerhalb der Grenze

package/dist/cjs/printing/escpos.js

@@ -344,10 +344,6 @@ function escPosSetStyles(doc, styles = {}) {
         alt.codeTable = codepage;
     }
 }
-/**
- * Interner Textdruck: absolute Position setzen (`ESC $`), Stil senden, Bytes
- * ausgeben. [colInd]/[colWidth] beschreiben die Spalte im Zwoelftel-Raster.
- */
 /**
  * Wortweiser Umbruch von (kodierten) Text-Bytes auf hoechstens `max` Zeichen
  * je Zeile: geschnitten wird am letzten Leerzeichen innerhalb der Grenze
@@ -449,27 +445,38 @@ function wortzeilenText(text, max) {
     out.push(rest.replace(/\u00a0/g, ' '));
     return out;
 }
+/**
+ * Interner Textdruck: Stil senden (Ausrichtung zuerst), absolute Position
+ * setzen (`ESC $`, ausser bei einer vollen Zeile), Bytes ausgeben. [colInd]/
+ * [colWidth] beschreiben die Spalte im Zwoelftel-Raster.
+ */
 function textIntern(doc, textBytes, optionen = {}) {
     const stile = vollstaendigeStile(optionen.styles);
     const colInd = optionen.colInd ?? 0;
     const colWidth = optionen.colWidth ?? 12;
-    const breiteJeZeichen = zeichenBreite(doc, stile);
-    let von = spaltenPosition(doc, colInd);
-    if (colWidth !== 12) {
-        const bis = spaltenPosition(doc, colInd + colWidth) - doc.spaceBetweenRows;
-        const textLaenge = textBytes.length * breiteJeZeichen;
-        if (stile.align === 'right') {
-            von = bis - textLaenge;
-        }
-        else if (stile.align === 'center') {
-            von = von + (bis - von) / 2 - textLaenge / 2;
+    // Ausrichtung vor Position -- `ESC a` gilt nur am Zeilenanfang, nach `ESC $`
+    // verwirft der Drucker ihn. Zwilling von `_text` in generator.dart.
+    escPosSetStyles(doc, optionen.styles);
+    // Eine volle Zeile beginnt am linken Rand; ein Positionsbefehl dafuer waere
+    // nicht nur ueberfluessig, er entwertet die Ausrichtung.
+    if (!(colInd === 0 && colWidth === 12)) {
+        const breiteJeZeichen = zeichenBreite(doc, stile);
+        let von = spaltenPosition(doc, colInd);
+        if (colWidth !== 12) {
+            const bis = spaltenPosition(doc, colInd + colWidth) - doc.spaceBetweenRows;
+            const textLaenge = textBytes.length * breiteJeZeichen;
+            if (stile.align === 'right') {
+                von = bis - textLaenge;
+            }
+            else if (stile.align === 'center') {
+                von = von + (bis - von) / 2 - textLaenge / 2;
+            }
+            if (von < 0)
+                von = 0;
         }
-        if (von < 0)
-            von = 0;
+        const position = runden(von);
+        anhaengen(doc, [...C_POS, position & 0xff, (position >> 8) & 0xff]);
     }
-    const position = runden(von);
-    anhaengen(doc, [...C_POS, position & 0xff, (position >> 8) & 0xff]);
-    escPosSetStyles(doc, optionen.styles);
     anhaengen(doc, textBytes);
 }
 /**
@@ -706,13 +713,6 @@ function escPosQrCode(doc, text, options = {}) {
     }
     if (drucken)
         anhaengen(doc, qrCodeBytes(text, qrOptionen));
-    // Ausrichtung SOFORT zuruecksetzen: `ESC a` gilt nur am Zeilenanfang. Die
-    // Spalten-Positionierung (`ESC $`) schickt ihren Reset sonst mitten in der
-    // Zeile — Epson ignoriert ihn, und alles nach dem QR rueckte nach rechts
-    // (belegt am TM-T20, 2026-08-20).
-    if ((options.align ?? 'center') !== 'left') {
-        escPosSetStyles(doc, { align: 'left' });
-    }
 }
 /**
  * Der Bildweg: ein fertiges QR-Raster als Rasterbild (`GS v 0`) — der
@@ -770,9 +770,6 @@ function escPosQrRaster(doc, matrix, options = {}) {
     anhaengen(doc, rasterBildKopf(breite, breite));
     anhaengen(doc, daten);
     anhaengen(doc, [ZEILENUMBRUCH]);
-    if ((options.align ?? 'center') !== 'left') {
-        escPosSetStyles(doc, { align: 'left' });
-    }
 }
 /**
  * Punkte je Modul, mit denen `escPosQrRaster` ein Raster dieser Groesse auf
@@ -845,7 +842,4 @@ function escPosRasterBild(doc, bild, options = {}) {
     escPosSetStyles(doc, { align: options.align ?? 'center' });
     anhaengen(doc, rasterBildKopf(bild.breite, bild.hoehe));
     anhaengen(doc, daten);
-    if ((options.align ?? 'center') !== 'left') {
-        escPosSetStyles(doc, { align: 'left' });
-    }
 }

package/dist/esm/printing/escpos.d.ts

@@ -208,10 +208,6 @@ export declare function escPosSetGlobalFont(doc: EscPosDocument, font: PosFont |
  * weglaesst, schaltet fett also ab.
  */
 export declare function escPosSetStyles(doc: EscPosDocument, styles?: PosStyles): void;
-/**
- * Interner Textdruck: absolute Position setzen (`ESC $`), Stil senden, Bytes
- * ausgeben. [colInd]/[colWidth] beschreiben die Spalte im Zwoelftel-Raster.
- */
 /**
  * Wortweiser Umbruch von (kodierten) Text-Bytes auf hoechstens `max` Zeichen
  * je Zeile: geschnitten wird am letzten Leerzeichen innerhalb der Grenze

package/dist/esm/printing/escpos.js

@@ -319,10 +319,6 @@ export function escPosSetStyles(doc, styles = {}) {
         alt.codeTable = codepage;
     }
 }
-/**
- * Interner Textdruck: absolute Position setzen (`ESC $`), Stil senden, Bytes
- * ausgeben. [colInd]/[colWidth] beschreiben die Spalte im Zwoelftel-Raster.
- */
 /**
  * Wortweiser Umbruch von (kodierten) Text-Bytes auf hoechstens `max` Zeichen
  * je Zeile: geschnitten wird am letzten Leerzeichen innerhalb der Grenze
@@ -424,27 +420,38 @@ export function wortzeilenText(text, max) {
     out.push(rest.replace(/\u00a0/g, ' '));
     return out;
 }
+/**
+ * Interner Textdruck: Stil senden (Ausrichtung zuerst), absolute Position
+ * setzen (`ESC $`, ausser bei einer vollen Zeile), Bytes ausgeben. [colInd]/
+ * [colWidth] beschreiben die Spalte im Zwoelftel-Raster.
+ */
 function textIntern(doc, textBytes, optionen = {}) {
     const stile = vollstaendigeStile(optionen.styles);
     const colInd = optionen.colInd ?? 0;
     const colWidth = optionen.colWidth ?? 12;
-    const breiteJeZeichen = zeichenBreite(doc, stile);
-    let von = spaltenPosition(doc, colInd);
-    if (colWidth !== 12) {
-        const bis = spaltenPosition(doc, colInd + colWidth) - doc.spaceBetweenRows;
-        const textLaenge = textBytes.length * breiteJeZeichen;
-        if (stile.align === 'right') {
-            von = bis - textLaenge;
-        }
-        else if (stile.align === 'center') {
-            von = von + (bis - von) / 2 - textLaenge / 2;
+    // Ausrichtung vor Position -- `ESC a` gilt nur am Zeilenanfang, nach `ESC $`
+    // verwirft der Drucker ihn. Zwilling von `_text` in generator.dart.
+    escPosSetStyles(doc, optionen.styles);
+    // Eine volle Zeile beginnt am linken Rand; ein Positionsbefehl dafuer waere
+    // nicht nur ueberfluessig, er entwertet die Ausrichtung.
+    if (!(colInd === 0 && colWidth === 12)) {
+        const breiteJeZeichen = zeichenBreite(doc, stile);
+        let von = spaltenPosition(doc, colInd);
+        if (colWidth !== 12) {
+            const bis = spaltenPosition(doc, colInd + colWidth) - doc.spaceBetweenRows;
+            const textLaenge = textBytes.length * breiteJeZeichen;
+            if (stile.align === 'right') {
+                von = bis - textLaenge;
+            }
+            else if (stile.align === 'center') {
+                von = von + (bis - von) / 2 - textLaenge / 2;
+            }
+            if (von < 0)
+                von = 0;
         }
-        if (von < 0)
-            von = 0;
+        const position = runden(von);
+        anhaengen(doc, [...C_POS, position & 0xff, (position >> 8) & 0xff]);
     }
-    const position = runden(von);
-    anhaengen(doc, [...C_POS, position & 0xff, (position >> 8) & 0xff]);
-    escPosSetStyles(doc, optionen.styles);
     anhaengen(doc, textBytes);
 }
 /**
@@ -681,13 +688,6 @@ export function escPosQrCode(doc, text, options = {}) {
     }
     if (drucken)
         anhaengen(doc, qrCodeBytes(text, qrOptionen));
-    // Ausrichtung SOFORT zuruecksetzen: `ESC a` gilt nur am Zeilenanfang. Die
-    // Spalten-Positionierung (`ESC $`) schickt ihren Reset sonst mitten in der
-    // Zeile — Epson ignoriert ihn, und alles nach dem QR rueckte nach rechts
-    // (belegt am TM-T20, 2026-08-20).
-    if ((options.align ?? 'center') !== 'left') {
-        escPosSetStyles(doc, { align: 'left' });
-    }
 }
 /**
  * Der Bildweg: ein fertiges QR-Raster als Rasterbild (`GS v 0`) — der
@@ -745,9 +745,6 @@ export function escPosQrRaster(doc, matrix, options = {}) {
     anhaengen(doc, rasterBildKopf(breite, breite));
     anhaengen(doc, daten);
     anhaengen(doc, [ZEILENUMBRUCH]);
-    if ((options.align ?? 'center') !== 'left') {
-        escPosSetStyles(doc, { align: 'left' });
-    }
 }
 /**
  * Punkte je Modul, mit denen `escPosQrRaster` ein Raster dieser Groesse auf
@@ -820,7 +817,4 @@ export function escPosRasterBild(doc, bild, options = {}) {
     escPosSetStyles(doc, { align: options.align ?? 'center' });
     anhaengen(doc, rasterBildKopf(bild.breite, bild.hoehe));
     anhaengen(doc, daten);
-    if ((options.align ?? 'center') !== 'left') {
-        escPosSetStyles(doc, { align: 'left' });
-    }
 }

package/fixtures/hobex-hps-codes.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.23.0",
+  "version": "0.25.0",
   "gemessenAn": {
     "tid": "3600335",
     "hpsVersion": "1.10.0",

package/fixtures/kasse-texte.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.23.0",
+  "version": "0.25.0",
   "meldungen": {
     "netz.keine_verbindung": {
       "text": "Keine Verbindung zum Server. Bitte die Internetverbindung prüfen und erneut versuchen."

package/fixtures/oberflaeche.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.23.0",
+  "version": "0.25.0",
   "aufrufe": [
     "activateCashregister",
     "cancelInvoice",

package/fixtures/rechnung-api.schema.json

@@ -2,7 +2,7 @@
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "title": "Kasseneck Rechnungs-API",
   "version": 1,
-  "paket": "0.23.0",
+  "paket": "0.25.0",
   "aufrufe": {
     "createCustomer": {
       "anfrage": {

package/fixtures/rechnung-texte.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.23.0",
+  "version": "0.25.0",
   "sprachen": [
     "de",
     "en"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kreiseck/kasseneck-api",
-  "version": "0.23.0",
+  "version": "0.25.0",
   "description": "RKSV-Registrierkasse fuer JavaScript und TypeScript: signierte Belege, Storno, Kartenzahlung, Bondruck. Austrian fiscal cash register (RKSV) API client.",
   "license": "Apache-2.0",
   "author": "Kreiseck",