@kreiseck/kasseneck-api 0.13.2 → 0.14.0

package/CHANGELOG.md

@@ -4,6 +4,76 @@ 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.14.0
+
+### Das Beleg-Blatt: ein Beleg, der überall gleich aussieht
+
+**Anlass:** Derselbe Beleg sah in der App, am Bon, in der Web-Kasse, im Panel
+und im PDF verschieden aus. Das Raster war als einzige Wahrheit gedacht, aber
+jeder Zeichner setzte Rahmen, Logo und QR selbst: das Panel stellte das Logo
+über den Testkassen-Rahmen, das PDF legte es darauf, die App zeigte keins, der
+Bon druckte Warnungen invers und doppelt hoch.
+
+- `renderReceiptGrid` gibt Aufdrucke als drei Rasterzeilen aus (`====`, Text,
+  `====`). ESC/POS und ePOS drucken sie als normale fette Zeilen — keine doppelte
+  Höhe, kein Invertieren mehr. `grid32`/`grid48` der Belege mit Aufdruck ändern
+  sich, das Zeilenmodell nicht.
+- Bekannter Unterschied, bleibt so: ESC/POS druckt `EUR` statt `€` (die
+  Ein-Byte-Codepage des Bondruckers kennt das Zeichen nicht). Bildschirm, PDF
+  und ePOS zeigen `€`; die Zeilen sind dadurch am Bon an diesen Stellen anders
+  gefüllt, das Raster bleibt gleich breit.
+- Neu `belegBlatt(layout, { zeichen, logo, marke, qrGroesse })`: Reihenfolge
+  (Aufdrucke oben, Leerzeile, Logo, Leerzeile, Beleg, Marke), Logo-Maß je Stufe
+  S/M/L/XL (nie hochgerechnet), QR-Anteil wie am Drucker.
+- Ein QR-Inhalt, der in keine QR-Version passt (Korrektur M, mehr als 2331
+  Byte), bekommt im Blatt den Anteil 0, statt dass `belegBlatt` wirft. ESC/POS
+  und ePOS lassen den QR dann weg und melden es über `qrFehler`; der Beleg steht
+  ohne QR. Die Bildschirm-Ansicht ruft `renderQr` weiter mit der Nutzlast, damit
+  die Oberfläche den fehlenden QR anzeigen kann (Papierbeleg-Hinweis). **Grund:** Ein Wurf riss jeden Zeichner mit — die Bon-Ansicht der
+  Web-Kasse fiel ganz aus, Bon und PDF ebenso. Neu `qrPasstInVersion(nutzlast)`
+  (`./printing`); `qrModulAnzahl` wirft weiter.
+- Neu `logoRaster` (RGBA → einfarbiges Rasterbild), `escPosRasterBild`,
+  `eposBildXml`; `escPosLayoutBytes` und `eposPrintXml` nehmen `logo` und `marke`.
+- Neu `BelegBlattView` / `BelegBlattZeilen` (`./react`); `ReceiptLayoutView` ist
+  `@deprecated`. `BelegBlattView` zeigt ein Logo ueber 4096x4096px (oder 0)
+  ebenso wenig wie ein nicht geladenes -- neu `LOGO_PIXEL_MAX`,
+  `logoPixelZulaessig` (`./receipt`). **Grund:** Bildschirm und Bon zeigen
+  dasselbe Logo; das Druck-Kit lehnt ein zu grosses Logo beim Rastern fuer
+  den Bon schon ab (dieselbe Grenze), der Bildschirm bisher nicht -- ein
+  5000x1200px-Logo erschien am Bildschirm und im PDF, aber nie auf dem
+  gedruckten Beleg.
+- Neu `ReceiptWithCompany.logoStufe` (aus `logo_skala` der Beleg-Antwort,
+  Vorgabe `M`): Panel und App kannten die Logo-Stufe des Betriebs bisher nicht.
+- `createPrintJob` nimmt `logo` und `marke`: der Netzwerk-Drucker (Connect)
+  druckt dasselbe Blatt wie USB, Bluetooth und ePOS direkt. Neu
+  `rasterZeilenBase64` (gemeinsam für ePOS-`<image>` und den Druckjob).
+- Goldens `erwartet/<name>.blatt32.json`/`.blatt48.json`,
+  `erwartet/logo-probe.raster32.txt` (mit Teiltransparenz) und
+  `erwartet/logo-probe-hoch.raster32.txt` (höhenbegrenzt) für den Dart-Zwilling.
+- `escPosRasterBild` wirft bei einer Bildhöhe über 65535 Punkten (`GS v 0` trägt
+  die Höhe in zwei Bytes).
+
+### Achtung: Brüche
+
+- **Aufdrucke im Raster.** `renderReceiptGrid` gibt jeden Aufdruck als drei
+  Zeilen `kind:'banner'` aus (`====`, Text, `====`). *Umstellen:* eigene
+  Rahmen oder Sonderstile für Aufdrucke entfernen (sie stünden sonst doppelt)
+  und nicht annehmen, dass die erste `banner`-Zeile die einzige ist — der Text
+  steht in der mittleren.
+- **`ReceiptWithCompany.logoStufe` ist Pflicht.** `getReceiptWithCompany` füllt
+  es selbst. *Umstellen:* von Hand gebaute Objekte (Tests, Vorschauen) brauchen
+  `logoStufe: 'M'`.
+- **QR-Vorgabe `auto` deckelt bei 6 Punkten je Modul (vorher 4)** — in npm und
+  Dart dasselbe. Am ESC/POS-Bon wird der QR ohne ausdrückliche Wahl größer
+  (80 mm: rund 55 % statt 37 % der Breite). *Umstellen:* wer die alte Größe
+  will, stellt `qrGroesse: 'klein'`.
+- **Nativer ESC/POS-QR mit Fehlerkorrektur M (vorher L)**, wie ePOS, Bildweg
+  und Blatt — der Kasten am Bildschirm ist damit genau der gedruckte QR.
+  Manche Nutzlasten brauchen eine Version mehr. *Umstellen:* den alten
+  Bytestrom liefert `qrCorrection: 'L'` (zusammen mit `qrGroesse: 'klein'`).
+- **ePOS-Vorgabe `qrGroesse` ist `auto`** (vorher `mittel`). Derselbe Wert,
+  kein Byte anders; nur wer die Vorgabe ausliest oder dokumentiert, merkt es.
+
 ## 0.13.2
 
 ### Die Paketseite erklaert, wofuer das Paket da ist

package/README.md

@@ -460,8 +460,9 @@ const mass = qrGroesseFuer({ nutzlast: beleg.qr, papierbreitePunkte: QR_DRUCK_PU
 
 Am Belegweg passiert das von selbst. `qrGroesse` ist ein **Deckel**, keine
 Vorgabe: gedruckt wird die größte Größe, die noch passt, höchstens aber der
-Deckel. `auto` (Vorgabe) deckelt beim Bestandswert 4 — ohne ausdrückliche Wahl
-ändert sich also kein Byte.
+Deckel. `auto` (Vorgabe) deckelt bei 6 Punkten je Modul — wie im Dart-Zwilling
+und am Epson-Weg; `klein` deckelt bei 4. Alle Druckwege setzen den QR mit
+Fehlerkorrektur M.
 
 ```ts
 import { escPosLayoutErgebnis } from '@kreiseck/kasseneck-api/receipt';
@@ -474,8 +475,8 @@ const { bytes, qrFehler, qrAusweich } = escPosLayoutErgebnis(layout, {
 ```
 
 Der Epson-Weg (`eposPrintXml` / `eposDirectPrint`) rechnet genauso;
-`eposPrintXmlErgebnis` gibt dort `{ xml, qrFehler, qrAusweich }`. Sein
-Bestandswert ist 6, deshalb ist die Vorgabe dort der Deckel `mittel`.
+`eposPrintXmlErgebnis` gibt dort `{ xml, qrFehler, qrAusweich }`. Die Vorgabe
+ist auch dort `auto`.
 
 `qrFehler` heißt „Beleg ohne QR" — das gehört dem Kunden gesagt. `qrAusweich`
 heißt „gedruckt, aber der eingestellte Weg taugt für dieses Gerät nicht" — das
@@ -483,6 +484,30 @@ gehört dem Chef gesagt. Den Bildweg fährt das Paket nur mit einem `qrMatrix`,
 das die Nutzlast in ein fertiges Raster übersetzt: hier wird bewusst weder ein
 QR gerechnet noch ein Bild verarbeitet.
 
+## Das Beleg-Blatt: überall derselbe Beleg
+
+Bildschirm, Bon, ePOS und PDF setzen dasselbe **Blatt**: Rasterzeilen, Firmenlogo,
+QR und die Marke „erstellt mit Kasseneck", mit Größen als Anteil der Blattbreite
+und in Zeilen (eine Zeile = zwei Zeichenbreiten).
+
+```tsx
+import { BelegBlattView } from '@kreiseck/kasseneck-api/react';
+
+<BelegBlattView layout={layout} logo={{ url: company.logoUrl, stufe: 'M' }} marke={company.showKreiseckLogo} renderQr={(d) => <QrSvg data={d} />} />
+```
+
+```ts
+import { escPosLayoutBytes, logoMass, logoRaster } from '@kreiseck/kasseneck-api/receipt';
+
+const mass = logoMass({ stufe: 'M', pxBreite: bild.width, pxHoehe: bild.height }, 48);
+const raster = logoRaster(imageData.data, bild.width, bild.height, mass, 48);
+escPosLayoutBytes(layout, { paperSize: 'mm80', logo: { stufe: 'M', pxBreite: bild.width, pxHoehe: bild.height, raster }, marke: true });
+```
+
+Logo-Stufen: S 42 % × 5 Zeilen, M 62 % × 8, L 80 % × 12, XL 94 % × 16 — eingepasst,
+nie hochgerechnet. Der Aufdruck (TESTKASSE, STORNOBELEG …) ist ein Rahmen aus
+`=`-Zeilen, auf jedem Weg gleich.
+
 ## Hobex HPS über Kasseneck Connect
 
 Ein Browser hat weiterhin keine rohen TCP-Sockets — ein **direkter**
@@ -516,7 +541,8 @@ Android-SDKs ohne Entsprechung hier.
 ## Was hier grundsätzlich nicht dazugehört
 
 Die Druckeransteuerung selbst (dieses Paket erzeugt die Bytes, es verschickt
-sie nicht), Firmenlogos und Rasterbilder, und die PDF-Erzeugung.
+sie nicht) und die PDF-Erzeugung. Bilder dekodieren (PNG/JPEG): das Paket
+rastert fertige RGBA-Pixel, das Laden des Bilds bleibt bei der Anwendung.
 
 ## Entwicklung
 

package/dist/cjs/client/receipts.d.ts

@@ -2,6 +2,7 @@ import { ReceiptType, type ReceiptTypeKey, KeckPaymentMethod, type KeckPaymentMe
 import { type Receipt, type ReceiptCompany, type ReceiptItem, type Voucher, type ReceiptSummary, type ReportMonth, type CancellationItem, type CancellationOf, type CancellationReason } from '../models/index.js';
 import type { InternerTransport } from './aufrufe.js';
 import type { Pruefangaben, ReceiptLayout } from '../receipt/layout.js';
+import type { LogoStufe } from '../receipt/blatt.js';
 /**
  * Beleg-Endpunkte — Zwilling der Beleg-Aufrufe in
  * kasseneck_api/lib/kasseneck_api.dart.
@@ -168,6 +169,12 @@ export interface ReceiptWithCompany {
      * fuer Clients, die das Layout selbst bauen; null bei altem Backend.
      */
     pruefangaben: Pruefangaben | null;
+    /**
+     * Groesse des Firmenlogos am Beleg (Kasse-Einstellung `logoSkala` des
+     * Betriebs). Bildschirm, Bon und PDF setzen das Logo in genau dieser Stufe;
+     * liefert das Backend sie nicht (alt), gilt `M` -- der Bestandswert.
+     */
+    logoStufe: LogoStufe;
 }
 /**
  * Gemeinsame Umsetzung aller Belegarten (Zwilling von `_createReceipt`).

package/dist/cjs/client/receipts.js

@@ -582,5 +582,6 @@ function belegMitFirmaAusHuelle(daten, functionName) {
         kopfId: typeof d.kopfId === 'string' ? d.kopfId : null,
         layout,
         pruefangaben: pa ? { karteRegistriertAm: text(pa.karteRegistriertAm), kasseRegistriertAm: text(pa.kasseRegistriertAm) } : null,
+        logoStufe: d.logo_skala === 'S' || d.logo_skala === 'M' || d.logo_skala === 'L' || d.logo_skala === 'XL' ? d.logo_skala : 'M',
     };
 }

package/dist/cjs/kasse/drucker.d.ts

@@ -1,5 +1,6 @@
 import type { InternerTransport } from '../client/aufrufe.js';
 import type { ReceiptLayout } from '../receipt/layout.js';
+import type { DruckLogo } from '../receipt/layout-escpos.js';
 /**
  * Netzwerk-Bondrucker ueber Epson "Server Direct Print": das Backend fuehrt
  * je Konto Drucker mit einer geheimen Abhol-URL; die Kasse legt Druckjobs
@@ -46,6 +47,10 @@ export interface CreatePrintJobOptions {
     receiptId?: string;
     titel?: string;
     quelle?: string;
+    /** Firmenlogo als fertiges Rasterbild (`logoRaster`); der Server dekodiert keine Bilder. */
+    logo?: DruckLogo | null;
+    /** "erstellt mit Kasseneck" am Ende (Konto-Flag `kreiseck_logo`). */
+    marke?: boolean;
 }
 export declare function createPrintJob(rufen: InternerTransport, o: CreatePrintJobOptions): Promise<DruckJob>;
 export declare function getPrintJob(rufen: InternerTransport, o: {

package/dist/cjs/kasse/drucker.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.listMyPrinters = listMyPrinters;
 exports.createPrintJob = createPrintJob;
 exports.getPrintJob = getPrintJob;
+const index_js_1 = require("../printing/index.js");
 const text = (v) => (typeof v === 'string' && v ? v : null);
 const zahl = (v) => (typeof v === 'number' && Number.isFinite(v) ? v : null);
 async function listMyPrinters(rufen) {
@@ -27,6 +28,14 @@ async function createPrintJob(rufen, o) {
         params.titel = o.titel;
     if (o.quelle)
         params.quelle = o.quelle;
+    if (o.logo) {
+        params.logo = {
+            stufe: o.logo.stufe, pxBreite: o.logo.pxBreite, pxHoehe: o.logo.pxHoehe,
+            breite: o.logo.raster.breite, hoehe: o.logo.raster.hoehe, zeilen: (0, index_js_1.rasterZeilenBase64)(o.logo.raster),
+        };
+    }
+    if (o.marke === true)
+        params.marke = true;
     const daten = await rufen('createPrintJob', params);
     return { jobId: String(daten?.jobId ?? ''), status: text(daten?.status) ?? 'offen', ergebnis: null };
 }

package/dist/cjs/kasse/settings.js

@@ -116,8 +116,11 @@ exports.KASSE_TASTEN_STANDARD = Object.freeze({
     korbLeeren: ['Mod+C'],
 });
 exports.KASSE_BETRIEB_STANDARD = Object.freeze({
-    // Petrol aus der Markenpalette ("Ecke, Aktion") — nicht das alte Blau.
-    logoText: 'K', logoAn: true, logoGroesse: 'M', wasserzeichen: 'anmeldung', farbe: '#116B6B',
+    // Das Petrol der Marke: die Aktionsfarbe des Design-Systems (Rolle `brand`).
+    // Stand bis September 2026 auf dem Wert des alten Markenhandbuchs,
+    // der um 0,07 in OKLab danebenlag. Unsichtbar, aber es war die letzte Stelle
+    // im Haus, an der eine zweite Zahl fuer dieselbe Farbe stand.
+    logoText: 'K', logoAn: true, logoGroesse: 'M', wasserzeichen: 'anmeldung', farbe: '#136B6B',
     stil: 'klar', schrift: 'M', schriftEinst: 'S', kachelstil: 'streifen', uhr: true,
     sperrbild: true, foto: true, autoAbMin: 0, abNachVerkauf: false, schnellLogin: true,
     preisAnzeigen: true, ustAnzeigen: false, emoji: true, katFarben: true, freiErlaubt: true,

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

@@ -24,8 +24,9 @@
  * CP437-Plaetze umkodiert (ä = 0x84, ü = 0x81, ß = 0xE1, ...). Zeichen ohne
  * CP437-Platz werden zu `?` — weiterhin ein Byte je Zeichen.
  *
- * Nicht enthalten (bewusst): Rasterbilder/Logos, Capability-Profile einzelner
- * Druckermodelle, Kassenlade, 1D-Barcodes.
+ * Nicht enthalten (bewusst): Bilddekodierung (PNG/JPEG liest die Huelle),
+ * Capability-Profile einzelner Druckermodelle, Kassenlade, 1D-Barcodes.
+ * Fertige einfarbige Rasterbilder (Logo) gehen ueber [escPosRasterBild].
  */
 import { type QrModulGroesse } from './qr-groesse.js';
 /** Papierbreite der Bonrolle. */
@@ -103,6 +104,7 @@ export interface EscPosQrOptions {
      * die Regel in `qr-groesse.ts`.
      */
     size?: QrSize;
+    /** Fehlerkorrektur; Vorgabe `M` wie auf allen Druckwegen (siehe `qrCodeBytes`). */
     correction?: QrCorrection;
     /** Deckel fuer die gerechnete Modulgroesse; wirkungslos neben `size`. */
     groesse?: QrModulGroesse;
@@ -255,6 +257,12 @@ export declare function escPosRow(doc: EscPosDocument, columns: readonly PosColu
  * es wird kein Bild uebertragen.
  *
  * Bei Kasseneck-Belegen steht hier der maschinenlesbare RKSV-Code.
+ *
+ * Fehlerkorrektur ohne Angabe: **M** (bis 0.13: L). Die Groessenrechnung
+ * (`qrModulAnzahl`), das Blatt (Anteil am Bildschirm und im PDF), der
+ * ePOS-Weg (`level_m`) und der Bildweg rechnen alle mit M — druckte der
+ * native Befehl mit L, kaeme fuer manche Nutzlasten ein kleineres Symbol
+ * heraus als der Bildschirm zeigt.
  */
 export declare function qrCodeBytes(text: string, options?: {
     size?: QrSize;
@@ -266,8 +274,8 @@ export declare function qrCodeBytes(text: string, options?: {
  * **gerechneter** Modulgroesse, sofern `options.size` sie nicht festlegt.
  *
  * Ohne `size` entscheidet die Regel aus `qr-groesse.ts`: so gross wie
- * moeglich, gedeckelt durch `options.groesse` (Vorgabe `auto` = der
- * Bestandswert 4 dieses Pakets). Passt das Symbol auch mit der
+ * moeglich, gedeckelt durch `options.groesse` (Vorgabe `auto` = hoechstens 6
+ * Punkte je Modul, wie im Flutter-Zwilling). Passt das Symbol auch mit der
  * Ausnahmegroesse nicht aufs Papier, geht **kein** QR-Befehl hinaus und
  * `doc.qrFehler` sagt warum: der Drucker schneidet ein zu breites Symbol
  * nicht ab, er laesst es weg — ein Befehl, von dem man weiss, dass er nichts
@@ -300,4 +308,30 @@ export declare function qrRasterPunkte(paperSize: PosPaperSize, moduleAnzahl: nu
     groesse?: QrModulGroesse;
     ruhezoneModule?: number;
 }): number;
+/**
+ * Einfarbiges Rasterbild in Druckpunkten, zeilenweise: `punkte[y * breite + x]`,
+ * 1 = schwarz. Entsteht fuer das Firmenlogo in `logoRaster` (receipt/bild.ts).
+ */
+export interface RasterBild {
+    readonly breite: number;
+    readonly hoehe: number;
+    readonly punkte: Uint8Array;
+}
+/** Die Rasterzeilen als Bytes: MSB zuerst, jede Zeile auf volle Bytes aufgefuellt. */
+export declare function rasterZeilenBytes(bild: RasterBild): Uint8Array;
+/**
+ * Die Rasterzeilen als Base64 -- ohne Buffer, laeuft im Browser und in Node.
+ * Eine Stelle fuer ePOS-`<image>` und den Druckjob an den Server.
+ */
+export declare function rasterZeilenBase64(bild: RasterBild): string;
+/**
+ * Ein Rasterbild (`GS v 0`) -- das Firmenlogo am Bon.
+ *
+ * Anders als `escPosQrRaster` folgt KEIN Zeilenvorschub: `GS v 0` schiebt das
+ * Papier um die Bildhoehe, ein LF danach waere eine zusaetzliche Leerzeile,
+ * die Bildschirm und PDF nicht haben. Die Luft um das Logo kommt aus dem Blatt.
+ */
+export declare function escPosRasterBild(doc: EscPosDocument, bild: RasterBild, options?: {
+    align?: PosAlign;
+}): void;
 export {};

package/dist/cjs/printing/escpos.js

@@ -25,8 +25,9 @@
  * CP437-Plaetze umkodiert (ä = 0x84, ü = 0x81, ß = 0xE1, ...). Zeichen ohne
  * CP437-Platz werden zu `?` — weiterhin ein Byte je Zeichen.
  *
- * Nicht enthalten (bewusst): Rasterbilder/Logos, Capability-Profile einzelner
- * Druckermodelle, Kassenlade, 1D-Barcodes.
+ * Nicht enthalten (bewusst): Bilddekodierung (PNG/JPEG liest die Huelle),
+ * Capability-Profile einzelner Druckermodelle, Kassenlade, 1D-Barcodes.
+ * Fertige einfarbige Rasterbilder (Logo) gehen ueber [escPosRasterBild].
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.encodeEscPosText = encodeEscPosText;
@@ -49,6 +50,9 @@ exports.qrCodeBytes = qrCodeBytes;
 exports.escPosQrCode = escPosQrCode;
 exports.escPosQrRaster = escPosQrRaster;
 exports.qrRasterPunkte = qrRasterPunkte;
+exports.rasterZeilenBytes = rasterZeilenBytes;
+exports.rasterZeilenBase64 = rasterZeilenBase64;
+exports.escPosRasterBild = escPosRasterBild;
 const qr_groesse_js_1 = require("./qr-groesse.js");
 // -------------------------------------------------------------- Befehlsbytes
 // Wortwoertlich aus commands.dart. Die Zahlen sind ASCII-Codes der dortigen
@@ -603,13 +607,19 @@ function escPosRow(doc, columns) {
  * es wird kein Bild uebertragen.
  *
  * Bei Kasseneck-Belegen steht hier der maschinenlesbare RKSV-Code.
+ *
+ * Fehlerkorrektur ohne Angabe: **M** (bis 0.13: L). Die Groessenrechnung
+ * (`qrModulAnzahl`), das Blatt (Anteil am Bildschirm und im PDF), der
+ * ePOS-Weg (`level_m`) und der Bildweg rechnen alle mit M — druckte der
+ * native Befehl mit L, kaeme fuer manche Nutzlasten ein kleineres Symbol
+ * heraus als der Bildschirm zeigt.
  */
 function qrCodeBytes(text, options = {}) {
     const size = options.size ?? 4;
     if (!istGanzzahl(size) || size < 1 || size > 8) {
         throw new Error('QR-Modulgroesse muss eine Ganzzahl im Bereich 1..8 sein');
     }
-    const correction = options.correction ?? 'L';
+    const correction = options.correction ?? 'M';
     const stufe = QR_KORREKTUR[correction];
     if (stufe === undefined) {
         throw new Error(`Unbekannte QR-Fehlerkorrektur: ${String(correction)}`);
@@ -650,8 +660,8 @@ function qrCodeBytes(text, options = {}) {
  * **gerechneter** Modulgroesse, sofern `options.size` sie nicht festlegt.
  *
  * Ohne `size` entscheidet die Regel aus `qr-groesse.ts`: so gross wie
- * moeglich, gedeckelt durch `options.groesse` (Vorgabe `auto` = der
- * Bestandswert 4 dieses Pakets). Passt das Symbol auch mit der
+ * moeglich, gedeckelt durch `options.groesse` (Vorgabe `auto` = hoechstens 6
+ * Punkte je Modul, wie im Flutter-Zwilling). Passt das Symbol auch mit der
  * Ausnahmegroesse nicht aufs Papier, geht **kein** QR-Befehl hinaus und
  * `doc.qrFehler` sagt warum: der Drucker schneidet ein zu breites Symbol
  * nicht ab, er laesst es weg — ein Befehl, von dem man weiss, dass er nichts
@@ -736,9 +746,10 @@ function escPosQrRaster(doc, matrix, options = {}) {
     if (!istGanzzahl(punkte) || punkte < 1) {
         throw new Error('punkteJeModul muss eine Ganzzahl >= 1 sein');
     }
+    // Modulraster (samt Ruhezone) auf Druckpunkte skaliert -- dieselbe Bitquelle
+    // wie das Logo, nur aus einem QR-Modul-Bool statt aus Graustufen gewonnen.
     const breite = gesamtModule * punkte;
-    const byteJeZeile = Math.ceil(breite / 8);
-    const daten = new Uint8Array(byteJeZeile * breite);
+    const bildpunkte = new Uint8Array(breite * breite);
     for (let y = 0; y < breite; y++) {
         const modulY = Math.floor(y / punkte) - ruhezone;
         if (modulY < 0 || modulY >= module)
@@ -750,18 +761,14 @@ function escPosQrRaster(doc, matrix, options = {}) {
                 continue;
             if (zeile[modulX] !== true)
                 continue;
-            const i = y * byteJeZeile + (x >> 3);
-            daten[i] = daten[i] | (0x80 >> (x & 7));
+            bildpunkte[y * breite + x] = 1;
         }
     }
+    const daten = rasterZeilenBytes({ breite, hoehe: breite, punkte: bildpunkte });
     escPosSetStyles(doc, { align: options.align ?? 'center' });
     // GS v 0 m xL xH yL yH d1...dk — m = 0: normale Dichte, 1:1.
-    anhaengen(doc, [
-        GS, 0x76, 0x30, 0x00,
-        byteJeZeile & 0xff, (byteJeZeile >> 8) & 0xff,
-        breite & 0xff, (breite >> 8) & 0xff,
-        ...daten,
-    ]);
+    anhaengen(doc, rasterBildKopf(breite, breite));
+    anhaengen(doc, daten);
     anhaengen(doc, [ZEILENUMBRUCH]);
     if ((options.align ?? 'center') !== 'left') {
         escPosSetStyles(doc, { align: 'left' });
@@ -777,3 +784,68 @@ function qrRasterPunkte(paperSize, moduleAnzahl, options = {}) {
     const deckel = qr_groesse_js_1.QR_MODUL_DECKEL[options.groesse ?? 'auto'];
     return Math.max(1, Math.min(deckel, Math.floor(qr_groesse_js_1.QR_DRUCK_PUNKTE[paperSize] / (moduleAnzahl + 2 * ruhezone))));
 }
+/** Die Rasterzeilen als Bytes: MSB zuerst, jede Zeile auf volle Bytes aufgefuellt. */
+function rasterZeilenBytes(bild) {
+    if (!istGanzzahl(bild.breite) || bild.breite < 1 || !istGanzzahl(bild.hoehe) || bild.hoehe < 1) {
+        throw new Error('Rasterbild ohne gueltiges Mass');
+    }
+    if (bild.punkte.length !== bild.breite * bild.hoehe)
+        throw new Error('Rasterbild: Punkte passen nicht zum Mass');
+    const byteJeZeile = Math.ceil(bild.breite / 8);
+    const daten = new Uint8Array(byteJeZeile * bild.hoehe);
+    for (let y = 0; y < bild.hoehe; y++) {
+        for (let x = 0; x < bild.breite; x++) {
+            if (bild.punkte[y * bild.breite + x] !== 1)
+                continue;
+            const i = y * byteJeZeile + (x >> 3);
+            daten[i] = daten[i] | (0x80 >> (x & 7));
+        }
+    }
+    return daten;
+}
+/**
+ * Die Rasterzeilen als Base64 -- ohne Buffer, laeuft im Browser und in Node.
+ * Eine Stelle fuer ePOS-`<image>` und den Druckjob an den Server.
+ */
+function rasterZeilenBase64(bild) {
+    const bytes = rasterZeilenBytes(bild);
+    let binaer = '';
+    for (let i = 0; i < bytes.length; i += 0x8000) {
+        binaer += String.fromCharCode(...bytes.subarray(i, i + 0x8000));
+    }
+    return btoa(binaer);
+}
+/**
+ * Der `GS v 0`-Kopf (Byte-Breite, Zeilenhoehe) -- die Rasterzeilen selbst
+ * haengt der Aufrufer an. Gemeinsame Rahmung fuer das Logo (`escPosRasterBild`)
+ * und den QR-Bildweg (`escPosQrRaster`): beide drucken dasselbe Bildkommando,
+ * nur mit unterschiedlichem Nachlauf (Zeilenvorschub ja/nein).
+ */
+function rasterBildKopf(breite, hoehe) {
+    const byteJeZeile = Math.ceil(breite / 8);
+    return [GS, 0x76, 0x30, 0x00, byteJeZeile & 0xff, (byteJeZeile >> 8) & 0xff, hoehe & 0xff, (hoehe >> 8) & 0xff];
+}
+/**
+ * Ein Rasterbild (`GS v 0`) -- das Firmenlogo am Bon.
+ *
+ * Anders als `escPosQrRaster` folgt KEIN Zeilenvorschub: `GS v 0` schiebt das
+ * Papier um die Bildhoehe, ein LF danach waere eine zusaetzliche Leerzeile,
+ * die Bildschirm und PDF nicht haben. Die Luft um das Logo kommt aus dem Blatt.
+ */
+function escPosRasterBild(doc, bild, options = {}) {
+    // Masse pruefen, BEVOR gepackt wird: ein zu breites Bild soll nicht erst
+    // Speicher fuer seine Rasterzeilen belegen. `GS v 0` traegt die Hoehe in zwei
+    // Bytes (yL yH) -- ueber 65535 Punkte liefe sie still ueber und der Drucker
+    // laese den Rest des Bilds als Befehle.
+    if (bild.breite > qr_groesse_js_1.QR_DRUCK_PUNKTE[doc.paperSize])
+        throw new Error('Rasterbild breiter als der Druckkopf');
+    if (bild.hoehe > 0xffff)
+        throw new Error('Rasterbild hoeher als 65535 Punkte');
+    const daten = rasterZeilenBytes(bild);
+    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/cjs/printing/index.d.ts

@@ -1,4 +1,4 @@
-export { type PosPaperSize, type PosAlign, type PosFont, type PosCutMode, type PosCodeTable, type PosTextSize, type QrSize, type QrCorrection, type QrMatrix, type PosStyles, type PosColumn, type EscPosOptions, type EscPosTextOptions, type EscPosHrOptions, type EscPosQrOptions, type EscPosQrRasterOptions, type EscPosDocument, createEscPosDocument, escPosBytes, escPosReset, escPosSetGlobalCodeTable, escPosSetGlobalFont, escPosSetStyles, escPosText, escPosEmptyLines, escPosFeed, escPosCut, escPosHr, escPosRow, escPosQrCode, escPosQrRaster, qrRasterPunkte, encodeEscPosText, qrCodeBytes, escPosMaxCharsPerLine, escPosWortzeilen, wortzeilenText, } from './escpos.js';
-export { type QrModulGroesse, type QrGroesse, QR_MODUL_DECKEL, QR_RUHEZONE_MODULE, QR_MINDEST_PUNKTE, QR_AUSNAHME_PUNKTE, QR_HOECHST_PUNKTE, QR_DRUCK_PUNKTE, qrModulAnzahl, qrGroesseBerechnen, qrGroesseFuer, } from './qr-groesse.js';
+export { type PosPaperSize, type PosAlign, type PosFont, type PosCutMode, type PosCodeTable, type PosTextSize, type QrSize, type QrCorrection, type QrMatrix, type PosStyles, type PosColumn, type EscPosOptions, type EscPosTextOptions, type EscPosHrOptions, type EscPosQrOptions, type EscPosQrRasterOptions, type EscPosDocument, createEscPosDocument, escPosBytes, escPosReset, escPosSetGlobalCodeTable, escPosSetGlobalFont, escPosSetStyles, escPosText, escPosEmptyLines, escPosFeed, escPosCut, escPosHr, escPosRow, escPosQrCode, escPosQrRaster, qrRasterPunkte, type RasterBild, rasterZeilenBytes, rasterZeilenBase64, escPosRasterBild, encodeEscPosText, qrCodeBytes, escPosMaxCharsPerLine, escPosWortzeilen, wortzeilenText, } from './escpos.js';
+export { type QrModulGroesse, type QrGroesse, QR_MODUL_DECKEL, QR_RUHEZONE_MODULE, QR_MINDEST_PUNKTE, QR_AUSNAHME_PUNKTE, QR_HOECHST_PUNKTE, QR_DRUCK_PUNKTE, qrModulAnzahl, qrPasstInVersion, qrGroesseBerechnen, qrGroesseFuer, } from './qr-groesse.js';
 export { escPosPrintableText } from './printable.js';
 export { type UsbEndpointLike, type UsbAlternateLike, type UsbInterfaceLike, type UsbConfigurationLike, type UsbTransferOutResultLike, type UsbWriterLike, type UsbIdentityLike, type UsbDeviceLike, type UsbPrinterEndpoint, type UsbPrinterConnection, USB_VENDOR_EPSON, USB_CLASS_PRINTER, UsbTimeoutError, usbDeviceKey, usbFindPrinterEndpoint, usbWriteAll, usbConnectPrinter, usbPrint, usbDisconnect, } from './webusb.js';

package/dist/cjs/printing/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.usbDisconnect = exports.usbPrint = exports.usbConnectPrinter = exports.usbWriteAll = exports.usbFindPrinterEndpoint = exports.usbDeviceKey = exports.UsbTimeoutError = exports.USB_CLASS_PRINTER = exports.USB_VENDOR_EPSON = exports.escPosPrintableText = exports.qrGroesseFuer = exports.qrGroesseBerechnen = exports.qrModulAnzahl = exports.QR_DRUCK_PUNKTE = exports.QR_HOECHST_PUNKTE = exports.QR_AUSNAHME_PUNKTE = exports.QR_MINDEST_PUNKTE = exports.QR_RUHEZONE_MODULE = exports.QR_MODUL_DECKEL = exports.wortzeilenText = exports.escPosWortzeilen = exports.escPosMaxCharsPerLine = exports.qrCodeBytes = exports.encodeEscPosText = exports.qrRasterPunkte = exports.escPosQrRaster = exports.escPosQrCode = exports.escPosRow = exports.escPosHr = exports.escPosCut = exports.escPosFeed = exports.escPosEmptyLines = exports.escPosText = exports.escPosSetStyles = exports.escPosSetGlobalFont = exports.escPosSetGlobalCodeTable = exports.escPosReset = exports.escPosBytes = exports.createEscPosDocument = void 0;
+exports.usbDisconnect = exports.usbPrint = exports.usbConnectPrinter = exports.usbWriteAll = exports.usbFindPrinterEndpoint = exports.usbDeviceKey = exports.UsbTimeoutError = exports.USB_CLASS_PRINTER = exports.USB_VENDOR_EPSON = exports.escPosPrintableText = exports.qrGroesseFuer = exports.qrGroesseBerechnen = exports.qrPasstInVersion = exports.qrModulAnzahl = exports.QR_DRUCK_PUNKTE = exports.QR_HOECHST_PUNKTE = exports.QR_AUSNAHME_PUNKTE = exports.QR_MINDEST_PUNKTE = exports.QR_RUHEZONE_MODULE = exports.QR_MODUL_DECKEL = exports.wortzeilenText = exports.escPosWortzeilen = exports.escPosMaxCharsPerLine = exports.qrCodeBytes = exports.encodeEscPosText = exports.escPosRasterBild = exports.rasterZeilenBase64 = exports.rasterZeilenBytes = exports.qrRasterPunkte = exports.escPosQrRaster = exports.escPosQrCode = exports.escPosRow = exports.escPosHr = exports.escPosCut = exports.escPosFeed = exports.escPosEmptyLines = exports.escPosText = exports.escPosSetStyles = exports.escPosSetGlobalFont = exports.escPosSetGlobalCodeTable = exports.escPosReset = exports.escPosBytes = exports.createEscPosDocument = void 0;
 var escpos_js_1 = require("./escpos.js");
 Object.defineProperty(exports, "createEscPosDocument", { enumerable: true, get: function () { return escpos_js_1.createEscPosDocument; } });
 Object.defineProperty(exports, "escPosBytes", { enumerable: true, get: function () { return escpos_js_1.escPosBytes; } });
@@ -17,6 +17,9 @@ Object.defineProperty(exports, "escPosRow", { enumerable: true, get: function ()
 Object.defineProperty(exports, "escPosQrCode", { enumerable: true, get: function () { return escpos_js_1.escPosQrCode; } });
 Object.defineProperty(exports, "escPosQrRaster", { enumerable: true, get: function () { return escpos_js_1.escPosQrRaster; } });
 Object.defineProperty(exports, "qrRasterPunkte", { enumerable: true, get: function () { return escpos_js_1.qrRasterPunkte; } });
+Object.defineProperty(exports, "rasterZeilenBytes", { enumerable: true, get: function () { return escpos_js_1.rasterZeilenBytes; } });
+Object.defineProperty(exports, "rasterZeilenBase64", { enumerable: true, get: function () { return escpos_js_1.rasterZeilenBase64; } });
+Object.defineProperty(exports, "escPosRasterBild", { enumerable: true, get: function () { return escpos_js_1.escPosRasterBild; } });
 Object.defineProperty(exports, "encodeEscPosText", { enumerable: true, get: function () { return escpos_js_1.encodeEscPosText; } });
 Object.defineProperty(exports, "qrCodeBytes", { enumerable: true, get: function () { return escpos_js_1.qrCodeBytes; } });
 Object.defineProperty(exports, "escPosMaxCharsPerLine", { enumerable: true, get: function () { return escpos_js_1.escPosMaxCharsPerLine; } });
@@ -30,6 +33,7 @@ Object.defineProperty(exports, "QR_AUSNAHME_PUNKTE", { enumerable: true, get: fu
 Object.defineProperty(exports, "QR_HOECHST_PUNKTE", { enumerable: true, get: function () { return qr_groesse_js_1.QR_HOECHST_PUNKTE; } });
 Object.defineProperty(exports, "QR_DRUCK_PUNKTE", { enumerable: true, get: function () { return qr_groesse_js_1.QR_DRUCK_PUNKTE; } });
 Object.defineProperty(exports, "qrModulAnzahl", { enumerable: true, get: function () { return qr_groesse_js_1.qrModulAnzahl; } });
+Object.defineProperty(exports, "qrPasstInVersion", { enumerable: true, get: function () { return qr_groesse_js_1.qrPasstInVersion; } });
 Object.defineProperty(exports, "qrGroesseBerechnen", { enumerable: true, get: function () { return qr_groesse_js_1.qrGroesseBerechnen; } });
 Object.defineProperty(exports, "qrGroesseFuer", { enumerable: true, get: function () { return qr_groesse_js_1.qrGroesseFuer; } });
 var printable_js_1 = require("./printable.js");

package/dist/cjs/printing/qr-groesse.d.ts

@@ -10,26 +10,21 @@ import type { PosPaperSize, QrSize } from './escpos.js';
  * und ein 58-mm-Kopf hat 384. Zu breit heisst bei den meisten Geraeten nicht
  * "abgeschnitten", sondern **gar kein QR** — auf einem Pflichtbeleg der
  * schlechteste aller Ausgaenge. (Im Flutter-Zwilling war genau das der
- * belegte Fehler; dieses Paket druckt seit jeher mit vier Punkten und blieb
- * darum verschont. Die Regel ist trotzdem dieselbe: sie deckelt auch eine
- * ausdruecklich gewaehlte groessere Modulgroesse gegen den Papierrand ab.)
+ * belegte Fehler.) Die Regel deckelt darum auch eine ausdruecklich gewaehlte
+ * groessere Modulgroesse gegen den Papierrand ab.
  */
 /**
  * Wie gross die Module des Beleg-QR werden duerfen — ein **Deckel**, keine
  * Vorgabe: gedruckt wird immer die groesste Groesse, die noch aufs Papier
  * passt, hoechstens aber diese hier.
  *
- * `auto` und `klein` decken beide bei 4 — das ist kein Versehen. 4 ist der
- * Wert, den der native Weg dieses Pakets seit jeher druckt
- * (`qrCodeBytes(..., size ?? 4)`); ohne diesen Deckel bekaeme jedes Geraet ab
- * sofort ungefragt einen groesseren QR als gestern. `auto` heisst also
- * "rechne, aber aendere den Bestand nicht".
- *
- * **Abweichung zum Flutter-Zwilling, bewusst:** dort deckelt `auto` bei 6,
- * weil dort 6 der Bestandswert ist. Die Regel ist in beiden Paketen
- * dieselbe — "so gross wie moeglich, hoechstens der Bestandswert" —, nur der
- * Bestandswert unterscheidet sich. `mittel` (6) und `gross` (8) sind in
- * beiden Paketen gleich; sie waehlt ein Mensch.
+ * `auto` heisst "gerechnet, hoechstens 6 Punkte je Modul" — in diesem Paket
+ * und im Flutter-Zwilling dasselbe. Bis 0.13 deckelte `auto` hier bei 4 (dem
+ * alten Wert des nativen ESC/POS-Wegs), in Dart bei 6; derselbe Beleg kam
+ * dadurch je nach Paket verschieden gross aus dem Drucker. Einheitlich gilt
+ * jetzt 6: der Wert von Dart und vom Epson-Weg, und ein groesseres Modul
+ * liest sich besser. `klein` (4) druckt den QR so gross wie frueher `auto`;
+ * `mittel` (6) und `gross` (8) waehlt ein Mensch.
  */
 export type QrModulGroesse = 'auto' | 'klein' | 'mittel' | 'gross';
 /** Groesste Modulgroesse in Druckpunkten, die der jeweilige Deckel zulaesst. */
@@ -82,19 +77,29 @@ export declare const QR_DRUCK_PUNKTE: Readonly<Record<PosPaperSize, number>>;
 /**
  * Modulanzahl, die `nutzlast` bei Fehlerkorrektur **M** braucht.
  *
- * Warum M, obwohl der native Befehl mit L druckt: M braucht bei gleicher
- * Nutzlast gleich viele oder mehr Module als L. Wer mit M rechnet und mit L
- * druckt, druckt nie breiter als gerechnet — die Rechnung ist konservativ,
- * nie knapp. Umgekehrt waere sie eine Rechnung, die aufgeht, und ein Symbol,
- * das ueber den Papierrand laeuft. Dasselbe gilt fuer die Byte-Zaehlung: hier
- * zaehlt UTF-8 (wie im Flutter-Zwilling), waehrend `qrCodeBytes` die Nutzlast
- * als Latin-1 sendet — UTF-8 ist nie kuerzer, die Rechnung also nie zu klein.
+ * Alle Druckwege setzen den QR mit Fehlerkorrektur **M** (nativer
+ * ESC/POS-Befehl, ePOS `level_m`; das Raster fuer den Bildweg rechnet der
+ * Aufrufer ebenfalls mit M) — rechnet und druckt also mit M: gerechnete und
+ * gedruckte Modulanzahl stimmen ueberein, und der Anteil am Blatt
+ * (Bildschirm, PDF) ist genau der am Bon. Die Byte-Zaehlung ist
+ * konservativ: hier zaehlt UTF-8 (wie im Flutter-Zwilling), waehrend
+ * `qrCodeBytes` die Nutzlast als Latin-1 sendet — UTF-8 ist nie kuerzer, die
+ * Rechnung also nie zu klein.
  *
  * Wirft, wenn die Nutzlast in keine Version passt — wie `qrCodeBytes` bei zu
  * langem Inhalt. Ein still zurueckgegebenes "passt nicht" haette den
  * Datenfehler als Papierfehler getarnt.
  */
 export declare function qrModulAnzahl(nutzlast: string): number;
+/**
+ * Ob `nutzlast` in irgendeine QR-Version 1..40 bei Fehlerkorrektur M passt --
+ * dieselbe Tabelle wie `qrModulAnzahl`, aber ohne zu werfen.
+ *
+ * Fuer Aufrufer, denen ein zu langer Inhalt kein Programmierfehler ist,
+ * sondern ein Datenfehler, den sie selbst behandeln (das Beleg-Blatt: ohne
+ * QR weiterbauen statt den ganzen Zeichner mitzureissen).
+ */
+export declare function qrPasstInVersion(nutzlast: string): boolean;
 /**
  * Groesste Modulgroesse, mit der `moduleAnzahl` Module **samt Ruhezone** in
  * `papierbreitePunkte` passen, gedeckelt durch `groesse`.

package/dist/cjs/printing/qr-groesse.js

@@ -2,11 +2,12 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.QR_DRUCK_PUNKTE = exports.QR_HOECHST_PUNKTE = exports.QR_AUSNAHME_PUNKTE = exports.QR_MINDEST_PUNKTE = exports.QR_RUHEZONE_MODULE = exports.QR_MODUL_DECKEL = void 0;
 exports.qrModulAnzahl = qrModulAnzahl;
+exports.qrPasstInVersion = qrPasstInVersion;
 exports.qrGroesseBerechnen = qrGroesseBerechnen;
 exports.qrGroesseFuer = qrGroesseFuer;
 /** Groesste Modulgroesse in Druckpunkten, die der jeweilige Deckel zulaesst. */
 exports.QR_MODUL_DECKEL = {
-    auto: 4,
+    auto: 6,
     klein: 4,
     mittel: 6,
     gross: 8,
@@ -49,13 +50,14 @@ const BYTE_KAPAZITAET_M = [
 /**
  * Modulanzahl, die `nutzlast` bei Fehlerkorrektur **M** braucht.
  *
- * Warum M, obwohl der native Befehl mit L druckt: M braucht bei gleicher
- * Nutzlast gleich viele oder mehr Module als L. Wer mit M rechnet und mit L
- * druckt, druckt nie breiter als gerechnet — die Rechnung ist konservativ,
- * nie knapp. Umgekehrt waere sie eine Rechnung, die aufgeht, und ein Symbol,
- * das ueber den Papierrand laeuft. Dasselbe gilt fuer die Byte-Zaehlung: hier
- * zaehlt UTF-8 (wie im Flutter-Zwilling), waehrend `qrCodeBytes` die Nutzlast
- * als Latin-1 sendet — UTF-8 ist nie kuerzer, die Rechnung also nie zu klein.
+ * Alle Druckwege setzen den QR mit Fehlerkorrektur **M** (nativer
+ * ESC/POS-Befehl, ePOS `level_m`; das Raster fuer den Bildweg rechnet der
+ * Aufrufer ebenfalls mit M) — rechnet und druckt also mit M: gerechnete und
+ * gedruckte Modulanzahl stimmen ueberein, und der Anteil am Blatt
+ * (Bildschirm, PDF) ist genau der am Bon. Die Byte-Zaehlung ist
+ * konservativ: hier zaehlt UTF-8 (wie im Flutter-Zwilling), waehrend
+ * `qrCodeBytes` die Nutzlast als Latin-1 sendet — UTF-8 ist nie kuerzer, die
+ * Rechnung also nie zu klein.
  *
  * Wirft, wenn die Nutzlast in keine Version passt — wie `qrCodeBytes` bei zu
  * langem Inhalt. Ein still zurueckgegebenes "passt nicht" haette den
@@ -69,6 +71,18 @@ function qrModulAnzahl(nutzlast) {
     }
     throw new Error('QR-Inhalt ist zu lang');
 }
+/**
+ * Ob `nutzlast` in irgendeine QR-Version 1..40 bei Fehlerkorrektur M passt --
+ * dieselbe Tabelle wie `qrModulAnzahl`, aber ohne zu werfen.
+ *
+ * Fuer Aufrufer, denen ein zu langer Inhalt kein Programmierfehler ist,
+ * sondern ein Datenfehler, den sie selbst behandeln (das Beleg-Blatt: ohne
+ * QR weiterbauen statt den ganzen Zeichner mitzureissen).
+ */
+function qrPasstInVersion(nutzlast) {
+    const laenge = new TextEncoder().encode(nutzlast).length;
+    return laenge <= BYTE_KAPAZITAET_M[BYTE_KAPAZITAET_M.length - 1];
+}
 /**
  * Groesste Modulgroesse, mit der `moduleAnzahl` Module **samt Ruhezone** in
  * `papierbreitePunkte` passen, gedeckelt durch `groesse`.