Strichcode mit dem Kassenartikel auf den Bon drucken

Der Kassierer musste den Artikel bisher von Hand in der Kasse suchen. Jetzt
steht er als Strichcode unter dem Betrag und wird gescannt.

CODE128 in Zeichensatz B, nicht das sonst uebliche CODE39: dort sind nur
Grossbuchstaben erlaubt, ein Artikel namens "techniker" waere damit nicht
darstellbar. Die Modulbreite waehlt escpos.js so gross, wie die Papierbreite
zulaesst - breitere Balken liest ein Handscanner zuverlaessiger, gerade auf
Thermopapier, das einen Tag in einer Hosentasche hinter sich hat. Daraus
ergibt sich die Laengengrenze von 17 Zeichen bei 80 mm Papier.

Artikelname und An/Aus liegen in den Einstellungen, nicht im Code: der Name
haengt am Artikelstamm der Kasse und kann sich aendern, ohne dass jemand an
die App muss.

Zwei Faelle, die sonst still danebengingen, melden sich jetzt:
- Umlaute und Sonderzeichen weist das Speichern ab, statt sie zu verschlucken
  und einen Code zu drucken, der einen anderen Artikel bedeutet.
- Passt der Name nicht auf die Papierbreite, druckt receipt.js ihn nur in
  Klarschrift. Ein abgeschnittener Code wird von keinem Scanner gelesen.

Geprueft auf dem Epson TM-T88IV: Zwischenbeleg und Endbeleg, ausgeschalteter
Strichcode, Laengengrenze, geschweifte Klammer im Namen (wird verdoppelt,
sonst liest der Drucker sie als Umschaltbefehl).

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

backend/escpos.js

@@ -20,6 +20,24 @@ const GS = 0x1d;
 // von Node plus diese eine Sonderbehandlung.
 const CODEPAGE_WPC1252 = 16;
 
+// Breite eines Zeichens in Schriftart A, in Druckpunkten. Daraus ergibt sich,
+// wie viel Platz ein Strichcode quer ueber das Papier hat.
+const ZEICHENBREITE = 12;
+
+// Ruhezone links und rechts vom Strichcode, in Modulen. Ohne diesen Abstand
+// findet ein Scanner den Anfang des Codes nicht zuverlaessig.
+const RUHEZONE = 10;
+
+/**
+ * Wie viele Zeichen ein CODE128-Strichcode auf dieser Papierbreite noch
+ * verkraeftet. Bei der schmalsten noch lesbaren Modulbreite (2 Punkte)
+ * gerechnet, also der guenstigste Fall.
+ */
+function barcodeMaxLength(width = 42) {
+    const module = Math.floor((width * ZEICHENBREITE) / 2) - 35 - 2 * RUHEZONE;
+    return Math.max(0, Math.floor(module / 11));
+}
+
 /** Zeichen, die WPC1252 nicht kennt, auf etwas Druckbares abbilden. */
 const ERSATZ = {
     '€': '\x80',
@@ -131,6 +149,52 @@ class Bon {
         return this;
     }
 
+    /**
+     * Strichcode in CODE128, Zeichensatz B.
+     *
+     * CODE128 statt des sonst ueblichen CODE39, weil CODE39 nur
+     * Grossbuchstaben kennt - ein Artikel namens "techniker" liesse sich damit
+     * nicht abbilden. Zeichensatz B deckt den druckbaren ASCII-Bereich ab und
+     * wird von jedem Handscanner gelesen.
+     *
+     * Die Modulbreite - die Breite des schmalsten Balkens - wird so gross
+     * gewaehlt, wie das Papier es zulaesst. Breitere Balken liest ein Scanner
+     * zuverlaessiger, gerade auf Thermopapier, das schon einen Tag in einer
+     * Hosentasche hinter sich hat.
+     *
+     * @param {string} text Nutzdaten, druckbares ASCII
+     * @param {object}  [o]
+     * @param {number}  [o.hoehe]        Hoehe in Druckpunkten (8 Punkte = 1 mm)
+     * @param {boolean} [o.klarschrift]  Nutzdaten zusaetzlich lesbar darunter
+     */
+    barcode(text, { hoehe = 64, klarschrift = true } = {}) {
+        // Was der Zeichensatz nicht kann, wuerde der Drucker stillschweigend
+        // verschlucken und einen Code ausgeben, der etwas anderes bedeutet.
+        const daten = String(text == null ? '' : text).replace(/[^\x20-\x7e]/g, '');
+        if (!daten) return this;
+
+        // Ein CODE128-Zeichen belegt 11 Module, dazu kommen Start, Pruefzeichen
+        // und Stopp (zusammen 35) sowie die Ruhezone auf beiden Seiten.
+        const module = 11 * daten.length + 35 + 2 * RUHEZONE;
+        const modul = Math.max(2, Math.min(4, Math.floor((this.width * ZEICHENBREITE) / module)));
+
+        this.raw(GS, 0x68, Math.max(1, Math.min(255, hoehe)));  // GS h  Hoehe
+        this.raw(GS, 0x77, modul);                              // GS w  Modulbreite
+        this.raw(GS, 0x66, 0);                                  // GS f  Schrift der Klarschrift
+        this.raw(GS, 0x48, klarschrift ? 2 : 0);                // GS H  Klarschrift darunter
+
+        // "{B" waehlt den Zeichensatz. Eine geschweifte Klammer in den Daten
+        // muss deshalb verdoppelt werden, sonst liest der Drucker sie als
+        // Umschaltbefehl und der Code enthaelt am Ende etwas anderes.
+        const nutz = Buffer.from('{B' + daten.split('{').join('{{'), 'latin1');
+
+        // Form 2 von GS k: die Laenge steht als Byte davor, statt die Daten mit
+        // einem Nullbyte abzuschliessen. Nur so darf jedes Zeichen vorkommen.
+        this.raw(GS, 0x6b, 73, nutz.length);
+        this.parts.push(nutz);
+        return this;
+    }
+
     feed(n = 1) {
         return this.raw(ESC, 0x64, Math.max(0, Math.min(255, n)));
     }
@@ -149,4 +213,4 @@ class Bon {
     }
 }
 
-module.exports = { Bon, encodeText };
+module.exports = { Bon, encodeText, barcodeMaxLength };