@kreiseck/kasseneck-api 0.13.1 → 0.14.0

package/dist/cjs/receipt/blatt.d.ts

@@ -0,0 +1,107 @@
+import type { PosPaperSize } from '../printing/escpos.js';
+import { type QrModulGroesse } from '../printing/index.js';
+import type { ReceiptLayout } from './layout.js';
+/**
+ * Das Beleg-Blatt: die vollstaendige Folge dessen, was auf dem Papier steht --
+ * Rasterzeilen, Firmenlogo, QR und Marke, mit Groessen als Anteil der
+ * Blattbreite und in Zeilen.
+ *
+ * Bis 0.13 setzte jeder Zeichner das Raster selbst zusammen und entschied
+ * Logo-Ort, Logo-Groesse, Rahmen und QR-Groesse fuer sich. Heraus kamen
+ * fuenf verschiedene Belege (Panel: Logo ueber dem Testkassen-Rahmen, PDF:
+ * Logo auf dem Rahmen, App: kein Logo). Hier steht das jetzt einmal.
+ *
+ * Masseinheit ist der Druckkopf (Epson Font A, 203 dpi): ein Zeichen ist 12
+ * Punkte breit, eine Zeile 24 Punkte hoch. Am Bildschirm ist eine Zeile `2ch`,
+ * im PDF zwei Zeichenbreiten.
+ */
+export type LogoStufe = 'S' | 'M' | 'L' | 'XL';
+/** Kasten je Stufe: Anteil der Blattbreite und Hoehe in Zeilen (Werte der Web-Kasse). */
+export declare const LOGO_STUFEN: Readonly<Record<LogoStufe, {
+    readonly breiteAnteil: number;
+    readonly hoeheZeilen: number;
+}>>;
+export declare const PUNKTE_JE_ZEICHEN = 12;
+export declare const PUNKTE_JE_ZEILE = 24;
+/** Die Marke am Belegende (Konto-Flag `kreiseck_logo`) -- Text, damit jeder Weg sie gleich setzt. */
+export declare const MARKE_TEXT = "erstellt mit Kasseneck";
+export interface BlattLogo {
+    stufe: LogoStufe;
+    /** Pixelmass des Originalbilds -- ohne das laesst sich nicht einpassen. */
+    pxBreite: number;
+    pxHoehe: number;
+}
+export interface LogoMass {
+    /** Anteil der Blattbreite (0..1). */
+    breiteAnteil: number;
+    /** Hoehe in Zeilen (nicht ganzzahlig). */
+    hoeheZeilen: number;
+}
+export type BlattBlock = {
+    readonly art: 'zeile';
+    readonly text: string;
+    readonly fett: boolean;
+    readonly leer: boolean;
+} | {
+    readonly art: 'logo';
+    readonly breiteAnteil: number;
+    readonly hoeheZeilen: number;
+} | {
+    readonly art: 'qr';
+    readonly nutzlast: string;
+    readonly breiteAnteil: number;
+};
+export interface BelegBlatt {
+    readonly zeichen: number;
+    readonly bloecke: readonly BlattBlock[];
+}
+export interface BelegBlattOptionen {
+    /** Zeichen je Zeile; Vorgabe nach `layout.paperSize` (32/48). */
+    zeichen?: number;
+    /** Firmenlogo; ohne Angabe kein Logo-Block. */
+    logo?: BlattLogo | null;
+    /** "erstellt mit Kasseneck" am Ende. */
+    marke?: boolean;
+    /** Geraete-Einstellung fuer die QR-Modulgroesse; Vorgabe `auto` (hoechstens 6 Punkte je Modul) — wie die Druckwege. */
+    qrGroesse?: QrModulGroesse;
+}
+/**
+ * 32 Zeichen sind 58 mm, 48 sind 80 mm; andere Breiten behalten das Papier des
+ * Layouts. Der QR-Anteil (`qrBlattAnteil`) wird dann fuer die Kopfbreite
+ * DIESES Papiers gerechnet, nicht fuer die gewaehlte Zeichenzahl.
+ */
+export declare function papierFuerZeichen(zeichen: number, vorgabe: PosPaperSize): PosPaperSize;
+/**
+ * Obergrenze der Logo-Pixel, die der Bildschirm noch anzeigen darf -- exakt
+ * dieselbe Grenze wie im Druck-Kit (`LOGO_PIXEL_MAX` in `druck-logo.ts`):
+ * Bon und ePOS lehnen ein Logo ueber 4096x4096px schon beim Rastern ab (ein
+ * grosses Bild blockiert das Geraet). Ohne diese Grenze wuerde der
+ * Bildschirm ein Logo zeigen, das der Bon nie druckt -- Bildschirm und
+ * Papier waeren sich uneins, genau das soll das Beleg-Blatt verhindern.
+ */
+export declare const LOGO_PIXEL_MAX = 4096;
+/** Reine Pruefung, ob ein Logo dieser Pixelmasse noch angezeigt/gedruckt werden darf. */
+export declare function logoPixelZulaessig(breite: number, hoehe: number): boolean;
+/**
+ * Das Logo in den Kasten seiner Stufe einpassen -- **nie hochrechnen**: ein
+ * Bildpixel wird hoechstens ein Druckpunkt. Ein kleines Logo bleibt klein,
+ * statt am Bon verwaschen zu werden (so hielten es PDF und Web-Kasse schon).
+ */
+export declare function logoMass(logo: BlattLogo, zeichen: number): LogoMass;
+/** Das Mass in ganzen Druckpunkten -- so gross muss das Rasterbild fuer den Bon sein. */
+export declare function logoRasterMass(mass: LogoMass, zeichen: number): {
+    breite: number;
+    hoehe: number;
+};
+/**
+ * Anteil der Blattbreite, den der QR am Drucker einnimmt -- dieselbe Rechnung
+ * wie der Druckweg (nativ, sonst der Bildweg). Bildschirm und PDF zeigen den
+ * QR in genau dieser Groesse. Leere Nutzlast: 0 (kein Symbol).
+ *
+ * Der Kasten **schliesst die Ruhezone von 4 Modulen je Seite ein** und setzt
+ * Fehlerkorrektur M voraus. Ein Zeichner (`renderQr`, PDF) muss das Symbol
+ * darum mit Fehlerkorrektur M und einer Ruhezone von 4 Modulen zeichnen, die
+ * den Kasten ganz ausfuellt -- sonst stimmt die Modulgroesse nicht mit dem Bon.
+ */
+export declare function qrBlattAnteil(nutzlast: string, papier: PosPaperSize, groesse?: QrModulGroesse): number;
+export declare function belegBlatt(layout: ReceiptLayout, optionen?: BelegBlattOptionen): BelegBlatt;

package/dist/cjs/receipt/blatt.js

@@ -0,0 +1,137 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LOGO_PIXEL_MAX = exports.MARKE_TEXT = exports.PUNKTE_JE_ZEILE = exports.PUNKTE_JE_ZEICHEN = exports.LOGO_STUFEN = void 0;
+exports.papierFuerZeichen = papierFuerZeichen;
+exports.logoPixelZulaessig = logoPixelZulaessig;
+exports.logoMass = logoMass;
+exports.logoRasterMass = logoRasterMass;
+exports.qrBlattAnteil = qrBlattAnteil;
+exports.belegBlatt = belegBlatt;
+const index_js_1 = require("../printing/index.js");
+const grid_js_1 = require("./grid.js");
+/** Kasten je Stufe: Anteil der Blattbreite und Hoehe in Zeilen (Werte der Web-Kasse). */
+exports.LOGO_STUFEN = {
+    S: { breiteAnteil: 0.42, hoeheZeilen: 5 },
+    M: { breiteAnteil: 0.62, hoeheZeilen: 8 },
+    L: { breiteAnteil: 0.8, hoeheZeilen: 12 },
+    XL: { breiteAnteil: 0.94, hoeheZeilen: 16 },
+};
+exports.PUNKTE_JE_ZEICHEN = 12;
+exports.PUNKTE_JE_ZEILE = 24;
+/** Die Marke am Belegende (Konto-Flag `kreiseck_logo`) -- Text, damit jeder Weg sie gleich setzt. */
+exports.MARKE_TEXT = 'erstellt mit Kasseneck';
+/**
+ * 32 Zeichen sind 58 mm, 48 sind 80 mm; andere Breiten behalten das Papier des
+ * Layouts. Der QR-Anteil (`qrBlattAnteil`) wird dann fuer die Kopfbreite
+ * DIESES Papiers gerechnet, nicht fuer die gewaehlte Zeichenzahl.
+ */
+function papierFuerZeichen(zeichen, vorgabe) {
+    if (zeichen === grid_js_1.ZEICHEN_JE_PAPIER.mm58)
+        return 'mm58';
+    if (zeichen === grid_js_1.ZEICHEN_JE_PAPIER.mm80)
+        return 'mm80';
+    return vorgabe;
+}
+/**
+ * Obergrenze der Logo-Pixel, die der Bildschirm noch anzeigen darf -- exakt
+ * dieselbe Grenze wie im Druck-Kit (`LOGO_PIXEL_MAX` in `druck-logo.ts`):
+ * Bon und ePOS lehnen ein Logo ueber 4096x4096px schon beim Rastern ab (ein
+ * grosses Bild blockiert das Geraet). Ohne diese Grenze wuerde der
+ * Bildschirm ein Logo zeigen, das der Bon nie druckt -- Bildschirm und
+ * Papier waeren sich uneins, genau das soll das Beleg-Blatt verhindern.
+ */
+exports.LOGO_PIXEL_MAX = 4096;
+/** Reine Pruefung, ob ein Logo dieser Pixelmasse noch angezeigt/gedruckt werden darf. */
+function logoPixelZulaessig(breite, hoehe) {
+    return breite > 0 && hoehe > 0 && breite <= exports.LOGO_PIXEL_MAX && hoehe <= exports.LOGO_PIXEL_MAX;
+}
+/**
+ * Das Logo in den Kasten seiner Stufe einpassen -- **nie hochrechnen**: ein
+ * Bildpixel wird hoechstens ein Druckpunkt. Ein kleines Logo bleibt klein,
+ * statt am Bon verwaschen zu werden (so hielten es PDF und Web-Kasse schon).
+ */
+function logoMass(logo, zeichen) {
+    if (!(logo.pxBreite > 0) || !(logo.pxHoehe > 0))
+        throw new Error('Logo ohne Pixelmass');
+    const stufe = exports.LOGO_STUFEN[logo.stufe];
+    if (stufe === undefined)
+        throw new Error(`Unbekannte Logo-Stufe: ${String(logo.stufe)}`);
+    const blattPunkte = zeichen * exports.PUNKTE_JE_ZEICHEN;
+    const faktor = Math.min((stufe.breiteAnteil * blattPunkte) / logo.pxBreite, (stufe.hoeheZeilen * exports.PUNKTE_JE_ZEILE) / logo.pxHoehe, 1);
+    return {
+        breiteAnteil: (logo.pxBreite * faktor) / blattPunkte,
+        hoeheZeilen: (logo.pxHoehe * faktor) / exports.PUNKTE_JE_ZEILE,
+    };
+}
+/** Das Mass in ganzen Druckpunkten -- so gross muss das Rasterbild fuer den Bon sein. */
+function logoRasterMass(mass, zeichen) {
+    return {
+        breite: Math.max(1, Math.round(mass.breiteAnteil * zeichen * exports.PUNKTE_JE_ZEICHEN)),
+        hoehe: Math.max(1, Math.round(mass.hoeheZeilen * exports.PUNKTE_JE_ZEILE)),
+    };
+}
+/**
+ * Anteil der Blattbreite, den der QR am Drucker einnimmt -- dieselbe Rechnung
+ * wie der Druckweg (nativ, sonst der Bildweg). Bildschirm und PDF zeigen den
+ * QR in genau dieser Groesse. Leere Nutzlast: 0 (kein Symbol).
+ *
+ * Der Kasten **schliesst die Ruhezone von 4 Modulen je Seite ein** und setzt
+ * Fehlerkorrektur M voraus. Ein Zeichner (`renderQr`, PDF) muss das Symbol
+ * darum mit Fehlerkorrektur M und einer Ruhezone von 4 Modulen zeichnen, die
+ * den Kasten ganz ausfuellt -- sonst stimmt die Modulgroesse nicht mit dem Bon.
+ */
+function qrBlattAnteil(nutzlast, papier, groesse = 'auto') {
+    if (nutzlast === '')
+        return 0;
+    // Ein Inhalt, der in keine QR-Version passt (Fehlerkorrektur M, hoechstens
+    // 2331 Byte), wuerde hier `qrGroesseFuer` -> `qrModulAnzahl` zum Werfen
+    // bringen -- und riss damit jeden Zeichner mit, der das Blatt baut
+    // (Bildschirm, Bon, PDF). 0, wie bei leerer Nutzlast: der Beleg steht ohne
+    // QR, statt gar nicht zu stehen. `qrModulAnzahl` selbst wirft weiter -- wer
+    // es ausserhalb des Blatts aufruft, soll den Fehler sehen.
+    if (!(0, index_js_1.qrPasstInVersion)(nutzlast))
+        return 0;
+    const papierPunkte = index_js_1.QR_DRUCK_PUNKTE[papier];
+    const mass = (0, index_js_1.qrGroesseFuer)({ nutzlast, papierbreitePunkte: papierPunkte, groesse });
+    if (mass.passt)
+        return mass.breitePunkte / papierPunkte;
+    return ((mass.module + 2 * index_js_1.QR_RUHEZONE_MODULE) * (0, index_js_1.qrRasterPunkte)(papier, mass.module, { groesse })) / papierPunkte;
+}
+function zentriert(text, zeichen) {
+    const t = text.length > zeichen ? text.slice(0, zeichen) : text;
+    const links = Math.floor((zeichen - t.length) / 2);
+    return ' '.repeat(links) + t + ' '.repeat(zeichen - t.length - links);
+}
+function belegBlatt(layout, optionen = {}) {
+    const grid = (0, grid_js_1.renderReceiptGrid)(layout, optionen.zeichen === undefined ? {} : { zeichen: optionen.zeichen });
+    const zeichen = grid.zeichen;
+    const papier = papierFuerZeichen(zeichen, layout.paperSize);
+    const qrGroesse = optionen.qrGroesse ?? 'auto';
+    const leerzeile = { art: 'zeile', text: ' '.repeat(zeichen), fett: false, leer: true };
+    const block = (z) => z.kind === 'qr'
+        ? { art: 'qr', nutzlast: z.qr ?? '', breiteAnteil: qrBlattAnteil(z.qr ?? '', papier, qrGroesse) }
+        : { art: 'zeile', text: z.text, fett: z.bold, leer: z.kind === 'space' };
+    const bloecke = [];
+    let i = 0;
+    if (optionen.logo) {
+        // Fuehrende Aufdrucke (Testkasse, Testsignatur) bleiben ganz oben: wer den
+        // Beleg sieht, sieht zuerst, dass er nicht gilt.
+        while (i < grid.lines.length && grid.lines[i].kind === 'banner') {
+            bloecke.push(block(grid.lines[i]));
+            i += 1;
+        }
+        // Die Leerzeilen gehoeren zum Vertrag: kein Zeichner kann das Logo an einen
+        // Rahmen oder an den Firmennamen kleben.
+        if (i > 0)
+            bloecke.push(leerzeile);
+        bloecke.push({ art: 'logo', ...logoMass(optionen.logo, zeichen) });
+        bloecke.push(leerzeile);
+    }
+    for (; i < grid.lines.length; i += 1)
+        bloecke.push(block(grid.lines[i]));
+    if (optionen.marke === true) {
+        bloecke.push(leerzeile);
+        bloecke.push({ art: 'zeile', text: zentriert(exports.MARKE_TEXT, zeichen), fett: false, leer: false });
+    }
+    return { zeichen, bloecke };
+}

package/dist/cjs/receipt/epos.d.ts

@@ -1,11 +1,12 @@
 import type { ReceiptLayout } from './layout.js';
 import type { PosPaperSize } from '../printing/escpos.js';
-import { type QrModulGroesse } from '../printing/index.js';
+import { type QrModulGroesse, type RasterBild } from '../printing/index.js';
+import { type DruckLogo } from './layout-escpos.js';
 /**
  * ePOS-Print XML (Epson TM-Drucker: Server Direct Print, ePOS-Print ueber
  * HTTP) -- **aus dem Zeichenraster**: jede Rasterzeile wird eine <text>-Zeile
- * mit exakt N Zeichen und Zeilenumbruch, Aufdrucke doppelt hoch (Warnungen
- * invers), QR als <symbol>, Leerraum als <feed>, am Ende Schnitt. Kein
+ * mit exakt N Zeichen und Zeilenumbruch, Aufdrucke als Rahmen aus
+ * Rasterzeilen, QR als <symbol>, Leerraum als <feed>, am Ende Schnitt. Kein
  * eigenes Setzen -- was Bildschirm, ESC/POS und PDF zeigen, druckt der Epson
  * Zeile fuer Zeile genauso.
  *
@@ -22,16 +23,20 @@ export interface EposPrintXmlOptions {
      */
     qrBreite?: number;
     /**
-     * Deckel fuer die gerechnete QR-Modulgroesse; Vorgabe `mittel`.
+     * Deckel fuer die gerechnete QR-Modulgroesse; Vorgabe `auto` (hoechstens 6
+     * Punkte je Modul) -- wie ESC/POS, Blatt und der Flutter-Zwilling.
      *
-     * Warum `mittel` und nicht `auto`: `auto` deckelt beim Bestandswert des
-     * **ESC/POS**-Befehls dieses Pakets (4), dieser Weg druckt aber seit jeher
-     * mit 6. Die Vorgabe nennt den Bestandswert dieses Wegs also ausdruecklich,
-     * damit ohne Wahl kein Byte anders herauskommt.
+     * Bis 0.13 stand hier `mittel`, weil `auto` damals beim ESC/POS-Wert 4
+     * deckelte und dieser Weg seit jeher mit 6 druckt. Seit `auto` ueberall 6
+     * heisst, ist das derselbe Wert: ohne Wahl kommt kein Byte anders heraus.
      */
     qrGroesse?: QrModulGroesse;
     /** Papierschnitt am Ende, Vorgabe true. */
     cut?: boolean;
+    /** Firmenlogo; ohne Angabe kein Logo. */
+    logo?: DruckLogo | null;
+    /** "erstellt mit Kasseneck" am Ende. */
+    marke?: boolean;
 }
 /**
  * Das XML **samt** dem, was dem QR unterwegs zugestossen ist -- dieselbe
@@ -45,6 +50,8 @@ export interface EposPrintErgebnis {
     qrAusweich: string | null;
 }
 export declare function eposXmlEscape(text: string): string;
+/** Ein Rasterbild als ePOS-`<image>` (einfarbig, Punktmass, Rasterzeilen Base64). */
+export declare function eposBildXml(bild: RasterBild): string;
 /** Nur das XML; wer die QR-Meldungen braucht, nimmt [eposPrintXmlErgebnis]. */
 export declare function eposPrintXml(layout: ReceiptLayout, options?: EposPrintXmlOptions): string;
 /**
@@ -77,6 +84,10 @@ export interface EposDirectOptions {
     qrBreite?: number;
     /** Deckel fuer die gerechnete QR-Modulgroesse; siehe [EposPrintXmlOptions.qrGroesse]. */
     qrGroesse?: QrModulGroesse;
+    /** Firmenlogo; ohne Angabe kein Logo. */
+    logo?: DruckLogo | null;
+    /** "erstellt mit Kasseneck" am Ende. */
+    marke?: boolean;
     timeoutMs?: number;
 }
 export interface EposResponse {

package/dist/cjs/receipt/epos.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.EposConnectionError = void 0;
 exports.eposXmlEscape = eposXmlEscape;
+exports.eposBildXml = eposBildXml;
 exports.eposPrintXml = eposPrintXml;
 exports.eposPrintXmlErgebnis = eposPrintXmlErgebnis;
 exports.eposServiceUrl = eposServiceUrl;
@@ -11,9 +12,14 @@ exports.eposDirectPrint = eposDirectPrint;
 exports.eposDirectStatus = eposDirectStatus;
 const index_js_1 = require("../printing/index.js");
 const grid_js_1 = require("./grid.js");
+const layout_escpos_js_1 = require("./layout-escpos.js");
 function eposXmlEscape(text) {
     return text.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;').replace(/'/g, '&apos;');
 }
+/** Ein Rasterbild als ePOS-`<image>` (einfarbig, Punktmass, Rasterzeilen Base64). */
+function eposBildXml(bild) {
+    return `<image width="${bild.breite}" height="${bild.hoehe}" color="color_1" mode="mono">${(0, index_js_1.rasterZeilenBase64)(bild)}</image>`;
+}
 const NS = 'http://www.epson-pos.com/schemas/2011/03/epos-print';
 /** Nur das XML; wer die QR-Meldungen braucht, nimmt [eposPrintXmlErgebnis]. */
 function eposPrintXml(layout, options = {}) {
@@ -30,8 +36,9 @@ function eposPrintXml(layout, options = {}) {
  * laesst es weg; genau daran fehlte am echten Beleg der QR.
  */
 function eposPrintXmlErgebnis(layout, options = {}) {
-    const grid = (0, grid_js_1.renderReceiptGrid)(layout, { zeichen: options.zeichen ?? grid_js_1.ZEICHEN_JE_PAPIER[layout.paperSize] });
-    const deckel = options.qrGroesse ?? 'mittel';
+    const zeichen = options.zeichen ?? grid_js_1.ZEICHEN_JE_PAPIER[layout.paperSize];
+    const deckel = options.qrGroesse ?? 'auto';
+    const blatt = (0, layout_escpos_js_1.blattFuerDruck)(layout, { zeichen, logo: options.logo, marke: options.marke, qrGroesse: deckel });
     const fest = options.qrBreite === undefined
         ? null
         : Math.min(16, Math.max(3, Math.floor(options.qrBreite)));
@@ -50,6 +57,12 @@ function eposPrintXmlErgebnis(layout, options = {}) {
             return fest;
         if (nutzlast === '')
             return index_js_1.QR_MODUL_DECKEL[deckel];
+        // Passt der Inhalt in keine QR-Version, gibt es kein Symbol, das der
+        // Drucker setzen koennte -- wie beim Blatt (Anteil 0) geht der Beleg ohne QR.
+        if (!(0, index_js_1.qrPasstInVersion)(nutzlast)) {
+            qrFehler = 'QR-Inhalt passt in keine QR-Version -- Beleg ohne QR';
+            return null;
+        }
         const mass = (0, index_js_1.qrGroesseFuer)({
             nutzlast,
             papierbreitePunkte: index_js_1.QR_DRUCK_PUNKTE[layout.paperSize],
@@ -74,32 +87,34 @@ function eposPrintXmlErgebnis(layout, options = {}) {
     out.push('<text font="font_a"/>');
     out.push('<text align="left"/>');
     out.push('<text width="1" height="1" reverse="false" em="false"/>');
-    for (const z of grid.lines) {
-        switch (z.kind) {
-            case 'space':
-                out.push('<feed line="1"/>');
+    for (const block of blatt.bloecke) {
+        switch (block.art) {
+            case 'zeile':
+                if (block.leer)
+                    out.push('<feed line="1"/>');
+                else if (block.fett) {
+                    out.push(`<text em="true">${eposXmlEscape(block.text)}&#10;</text>`);
+                    out.push('<text em="false"/>');
+                }
+                else
+                    out.push(`<text>${eposXmlEscape(block.text)}&#10;</text>`);
+                break;
+            case 'logo':
+                if (options.logo) {
+                    out.push('<text align="center"/>');
+                    out.push(eposBildXml(options.logo.raster));
+                    out.push('<text align="left"/>');
+                }
                 break;
             case 'qr': {
-                const breite = qrBreiteFuer(z.qr ?? '');
+                const breite = qrBreiteFuer(block.nutzlast);
                 if (breite === null)
                     break;
                 out.push('<text align="center"/>');
-                out.push(`<symbol type="qrcode_model_2" level="level_m" width="${breite}" height="0" size="0">${eposXmlEscape(z.qr ?? '')}</symbol>`);
+                out.push(`<symbol type="qrcode_model_2" level="level_m" width="${breite}" height="0" size="0">${eposXmlEscape(block.nutzlast)}</symbol>`);
                 out.push('<text align="left"/>');
                 break;
             }
-            case 'banner':
-                out.push(`<text width="1" height="2" reverse="${z.ton === 'warnung' ? 'true' : 'false'}" em="true">${eposXmlEscape(z.text)}&#10;</text>`);
-                out.push('<text width="1" height="1" reverse="false" em="false"/>');
-                break;
-            default:
-                if (z.bold)
-                    out.push(`<text em="true">${eposXmlEscape(z.text)}&#10;</text>`);
-                else
-                    out.push(`<text>${eposXmlEscape(z.text)}&#10;</text>`);
-                if (z.bold)
-                    out.push('<text em="false"/>');
-                break;
         }
     }
     if (options.cut !== false) {
@@ -220,6 +235,10 @@ function eposDirectPrint(layout, o, fetchFn = fetch) {
         xmlOptionen.qrBreite = o.qrBreite;
     if (o.qrGroesse !== undefined)
         xmlOptionen.qrGroesse = o.qrGroesse;
+    if (o.logo)
+        xmlOptionen.logo = o.logo;
+    if (o.marke !== undefined)
+        xmlOptionen.marke = o.marke;
     return eposDirectSend(eposPrintXml({ ...layout, paperSize: papier }, xmlOptionen), o, fetchFn);
 }
 /** Verbindungstest: leeres Dokument, druckt nichts, liefert den Druckerstatus. */

package/dist/cjs/receipt/grid.d.ts

@@ -27,7 +27,7 @@ export interface GridLine {
     text: string;
     kind: GridLineKind;
     bold: boolean;
-    /** Bei `banner`: `warnung` = invers/auffaellig, `belegart` = Rahmen. */
+    /** Bei `banner` (Rahmen- und Textzeilen): `warnung` = Test/Ausfall, `belegart` = Storno, Nullbeleg … */
     ton?: 'belegart' | 'warnung';
     /** Bei `qr`: die Nutzlast. */
     qr?: string;

package/dist/cjs/receipt/grid.js

@@ -67,10 +67,18 @@ function renderReceiptGrid(layout, options = {}) {
                 for (const t of (0, escpos_js_1.wortzeilenText)(z.text, zeichen))
                     lines.push({ text: ausrichten(t, zeichen, z.align), kind: 'text', bold: z.bold });
                 break;
-            case 'banner':
+            case 'banner': {
+                // Der Rahmen ist Teil des Rasters: eine Zeile '=' ueber die volle Breite
+                // davor und danach. So setzt ihn jeder Weg -- Bildschirm, Bon, ePOS, PDF,
+                // myPOS -- Zeichen fuer Zeichen gleich. Vorher zeichnete jeder Weg seinen
+                // eigenen Rahmen (Rechteck, doppelt hoch, invers, gefuellt).
+                const rahmen = '='.repeat(zeichen);
+                lines.push({ text: rahmen, kind: 'banner', bold: true, ton: z.ton });
                 for (const t of (0, escpos_js_1.wortzeilenText)(z.text, zeichen))
                     lines.push({ text: ausrichten(t, zeichen, 'center'), kind: 'banner', bold: true, ton: z.ton });
+                lines.push({ text: rahmen, kind: 'banner', bold: true, ton: z.ton });
                 break;
+            }
             case 'rule':
                 lines.push({ text: (z.char || '-').charAt(0).repeat(zeichen), kind: 'rule', bold: false });
                 break;

package/dist/cjs/receipt/index.d.ts

@@ -1,4 +1,6 @@
 export { type LayoutAlign, type LayoutColumn, type LayoutTextLine, type LayoutColumnsLine, type LayoutRuleLine, type LayoutSpaceLine, type LayoutQrLine, type LayoutLine, type ReceiptLayout, type BuildReceiptLayoutOptions, buildReceiptLayout, receiptSignatureFailed, receiptSignatureIsTest, receiptIsZero, receiptAmountsAreZero, receiptIsSmallBusinessConsistent, receiptZdaText, type Pruefangaben, AKTUELLES_REGELWERK, type LayoutBannerLine, type LayoutRegelwerk, SMALL_BUSINESS_NOTICE, formatCents, } from './layout.js';
-export { type EscPosLayoutOptions, type EscPosLayoutErgebnis, type QrPrintMode, escPosLayoutBytes, escPosLayoutErgebnis, } from './layout-escpos.js';
+export { type EscPosLayoutOptions, type EscPosLayoutErgebnis, type QrPrintMode, type DruckLogo, pruefeLogoRaster, escPosLayoutBytes, escPosLayoutErgebnis, } from './layout-escpos.js';
 export { type GridLine, type GridLineKind, type ReceiptGrid, type RenderReceiptGridOptions, renderReceiptGrid, gridSpaltenBreiten, gridAlsText, ZEICHEN_JE_PAPIER, } from './grid.js';
-export { type EposPrintXmlOptions, type EposPrintErgebnis, type EposDirectOptions, type EposResponse, EposConnectionError, eposPrintXml, eposPrintXmlErgebnis, eposXmlEscape, eposServiceUrl, eposSoapEnvelope, eposParseResponse, eposDirectPrint, eposDirectStatus } from './epos.js';
+export { type EposPrintXmlOptions, type EposPrintErgebnis, type EposDirectOptions, type EposResponse, EposConnectionError, eposPrintXml, eposPrintXmlErgebnis, eposXmlEscape, eposBildXml, eposServiceUrl, eposSoapEnvelope, eposParseResponse, eposDirectPrint, eposDirectStatus } from './epos.js';
+export { type LogoStufe, type BlattLogo, type LogoMass, type BlattBlock, type BelegBlatt, type BelegBlattOptionen, LOGO_STUFEN, LOGO_PIXEL_MAX, PUNKTE_JE_ZEICHEN, PUNKTE_JE_ZEILE, MARKE_TEXT, papierFuerZeichen, logoMass, logoPixelZulaessig, logoRasterMass, qrBlattAnteil, belegBlatt, } from './blatt.js';
+export { logoRaster } from './bild.js';

package/dist/cjs/receipt/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.eposDirectStatus = exports.eposDirectPrint = exports.eposParseResponse = exports.eposSoapEnvelope = exports.eposServiceUrl = exports.eposXmlEscape = exports.eposPrintXmlErgebnis = exports.eposPrintXml = exports.EposConnectionError = exports.ZEICHEN_JE_PAPIER = exports.gridAlsText = exports.gridSpaltenBreiten = exports.renderReceiptGrid = exports.escPosLayoutErgebnis = exports.escPosLayoutBytes = exports.formatCents = exports.SMALL_BUSINESS_NOTICE = exports.AKTUELLES_REGELWERK = exports.receiptZdaText = exports.receiptIsSmallBusinessConsistent = exports.receiptAmountsAreZero = exports.receiptIsZero = exports.receiptSignatureIsTest = exports.receiptSignatureFailed = exports.buildReceiptLayout = void 0;
+exports.logoRaster = exports.belegBlatt = exports.qrBlattAnteil = exports.logoRasterMass = exports.logoPixelZulaessig = exports.logoMass = exports.papierFuerZeichen = exports.MARKE_TEXT = exports.PUNKTE_JE_ZEILE = exports.PUNKTE_JE_ZEICHEN = exports.LOGO_PIXEL_MAX = exports.LOGO_STUFEN = exports.eposDirectStatus = exports.eposDirectPrint = exports.eposParseResponse = exports.eposSoapEnvelope = exports.eposServiceUrl = exports.eposBildXml = exports.eposXmlEscape = exports.eposPrintXmlErgebnis = exports.eposPrintXml = exports.EposConnectionError = exports.ZEICHEN_JE_PAPIER = exports.gridAlsText = exports.gridSpaltenBreiten = exports.renderReceiptGrid = exports.escPosLayoutErgebnis = exports.escPosLayoutBytes = exports.pruefeLogoRaster = exports.formatCents = exports.SMALL_BUSINESS_NOTICE = exports.AKTUELLES_REGELWERK = exports.receiptZdaText = exports.receiptIsSmallBusinessConsistent = exports.receiptAmountsAreZero = exports.receiptIsZero = exports.receiptSignatureIsTest = exports.receiptSignatureFailed = exports.buildReceiptLayout = void 0;
 var layout_js_1 = require("./layout.js");
 Object.defineProperty(exports, "buildReceiptLayout", { enumerable: true, get: function () { return layout_js_1.buildReceiptLayout; } });
 Object.defineProperty(exports, "receiptSignatureFailed", { enumerable: true, get: function () { return layout_js_1.receiptSignatureFailed; } });
@@ -13,6 +13,7 @@ Object.defineProperty(exports, "AKTUELLES_REGELWERK", { enumerable: true, get: f
 Object.defineProperty(exports, "SMALL_BUSINESS_NOTICE", { enumerable: true, get: function () { return layout_js_1.SMALL_BUSINESS_NOTICE; } });
 Object.defineProperty(exports, "formatCents", { enumerable: true, get: function () { return layout_js_1.formatCents; } });
 var layout_escpos_js_1 = require("./layout-escpos.js");
+Object.defineProperty(exports, "pruefeLogoRaster", { enumerable: true, get: function () { return layout_escpos_js_1.pruefeLogoRaster; } });
 Object.defineProperty(exports, "escPosLayoutBytes", { enumerable: true, get: function () { return layout_escpos_js_1.escPosLayoutBytes; } });
 Object.defineProperty(exports, "escPosLayoutErgebnis", { enumerable: true, get: function () { return layout_escpos_js_1.escPosLayoutErgebnis; } });
 var grid_js_1 = require("./grid.js");
@@ -25,8 +26,23 @@ Object.defineProperty(exports, "EposConnectionError", { enumerable: true, get: f
 Object.defineProperty(exports, "eposPrintXml", { enumerable: true, get: function () { return epos_js_1.eposPrintXml; } });
 Object.defineProperty(exports, "eposPrintXmlErgebnis", { enumerable: true, get: function () { return epos_js_1.eposPrintXmlErgebnis; } });
 Object.defineProperty(exports, "eposXmlEscape", { enumerable: true, get: function () { return epos_js_1.eposXmlEscape; } });
+Object.defineProperty(exports, "eposBildXml", { enumerable: true, get: function () { return epos_js_1.eposBildXml; } });
 Object.defineProperty(exports, "eposServiceUrl", { enumerable: true, get: function () { return epos_js_1.eposServiceUrl; } });
 Object.defineProperty(exports, "eposSoapEnvelope", { enumerable: true, get: function () { return epos_js_1.eposSoapEnvelope; } });
 Object.defineProperty(exports, "eposParseResponse", { enumerable: true, get: function () { return epos_js_1.eposParseResponse; } });
 Object.defineProperty(exports, "eposDirectPrint", { enumerable: true, get: function () { return epos_js_1.eposDirectPrint; } });
 Object.defineProperty(exports, "eposDirectStatus", { enumerable: true, get: function () { return epos_js_1.eposDirectStatus; } });
+var blatt_js_1 = require("./blatt.js");
+Object.defineProperty(exports, "LOGO_STUFEN", { enumerable: true, get: function () { return blatt_js_1.LOGO_STUFEN; } });
+Object.defineProperty(exports, "LOGO_PIXEL_MAX", { enumerable: true, get: function () { return blatt_js_1.LOGO_PIXEL_MAX; } });
+Object.defineProperty(exports, "PUNKTE_JE_ZEICHEN", { enumerable: true, get: function () { return blatt_js_1.PUNKTE_JE_ZEICHEN; } });
+Object.defineProperty(exports, "PUNKTE_JE_ZEILE", { enumerable: true, get: function () { return blatt_js_1.PUNKTE_JE_ZEILE; } });
+Object.defineProperty(exports, "MARKE_TEXT", { enumerable: true, get: function () { return blatt_js_1.MARKE_TEXT; } });
+Object.defineProperty(exports, "papierFuerZeichen", { enumerable: true, get: function () { return blatt_js_1.papierFuerZeichen; } });
+Object.defineProperty(exports, "logoMass", { enumerable: true, get: function () { return blatt_js_1.logoMass; } });
+Object.defineProperty(exports, "logoPixelZulaessig", { enumerable: true, get: function () { return blatt_js_1.logoPixelZulaessig; } });
+Object.defineProperty(exports, "logoRasterMass", { enumerable: true, get: function () { return blatt_js_1.logoRasterMass; } });
+Object.defineProperty(exports, "qrBlattAnteil", { enumerable: true, get: function () { return blatt_js_1.qrBlattAnteil; } });
+Object.defineProperty(exports, "belegBlatt", { enumerable: true, get: function () { return blatt_js_1.belegBlatt; } });
+var bild_js_1 = require("./bild.js");
+Object.defineProperty(exports, "logoRaster", { enumerable: true, get: function () { return bild_js_1.logoRaster; } });

package/dist/cjs/receipt/layout-escpos.d.ts

@@ -1,5 +1,6 @@
-import { type PosCodeTable, type PosCutMode, type PosPaperSize, type QrCorrection, type QrMatrix, type QrModulGroesse, type QrSize } from '../printing/index.js';
+import { type PosCodeTable, type PosCutMode, type PosPaperSize, type QrCorrection, type QrMatrix, type QrModulGroesse, type QrSize, type RasterBild } from '../printing/index.js';
 import type { ReceiptLayout } from './layout.js';
+import { type BelegBlatt, type LogoStufe, type LogoMass } from './blatt.js';
 /**
  * Bruecke vom Layout-Modell zu ESC/POS-Bytes — der Bondrucker-Ausgabeweg.
  *
@@ -28,6 +29,29 @@ import type { ReceiptLayout } from './layout.js';
  *                   (`qrMatrix`), weil dieses Paket keine QR-Codes rechnet.
  */
 export type QrPrintMode = 'native' | 'nativeModel1' | 'imageRaster';
+/** Firmenlogo fuer den Druck: Stufe, Pixelmass des Originals und das fertige Rasterbild (`logoRaster`). */
+export interface DruckLogo {
+    stufe: LogoStufe;
+    pxBreite: number;
+    pxHoehe: number;
+    raster: RasterBild;
+}
+/** Das Rasterbild muss genau so gross sein, wie das Blatt das Logo setzt -- sonst stuende am Bon ein anderes Logo als am Schirm. */
+export declare function pruefeLogoRaster(logo: DruckLogo, mass: LogoMass, zeichen: number): void;
+/**
+ * Baut das Blatt fuer einen Druckweg (ESC/POS, ePOS) an EINER Stelle: die
+ * Zuordnung `DruckLogo` -> `BlattLogo` und die Groessenpruefung des mitgebrachten
+ * Rasterbilds teilen sich beide Wege -- ohne das muesste eine Aenderung daran an
+ * zwei Stellen nachgezogen werden. Wirft VOR jeder Ausgabe (also bevor der
+ * Aufrufer auch nur ein Byte/Zeichen geschrieben hat), wenn das Rasterbild nicht
+ * zur Logo-Stufe passt.
+ */
+export declare function blattFuerDruck(layout: ReceiptLayout, optionen: {
+    zeichen: number;
+    logo?: DruckLogo | null;
+    marke?: boolean;
+    qrGroesse: QrModulGroesse;
+}): BelegBlatt;
 export interface EscPosLayoutOptions {
     /** Papierbreite; Vorgabe ist die des Layouts (dessen Spaltenbreiten daran haengen). */
     paperSize?: PosPaperSize;
@@ -40,9 +64,9 @@ export interface EscPosLayoutOptions {
      * dann passt der Aufrufer selbst auf, dass das Symbol aufs Papier geht.
      */
     qrSize?: QrSize;
-    /** Fehlerkorrekturstufe des QR-Codes. */
+    /** Fehlerkorrekturstufe des QR-Codes; Vorgabe `M` (wie ePOS, Bildweg und Blatt). */
     qrCorrection?: QrCorrection;
-    /** Deckel fuer die gerechnete Modulgroesse; Vorgabe `auto`. */
+    /** Deckel fuer die gerechnete Modulgroesse; Vorgabe `auto` (hoechstens 6 Punkte je Modul). */
     qrGroesse?: QrModulGroesse;
     /** Druckweg des QR; Vorgabe `native` (der Bestandsweg). */
     qrModus?: QrPrintMode;
@@ -54,6 +78,10 @@ export interface EscPosLayoutOptions {
      * aus der QR-Bibliothek, die er ohnehin fuer den Bildschirm benutzt.
      */
     qrMatrix?: (nutzlast: string) => QrMatrix;
+    /** Firmenlogo; ohne Angabe kein Logo (Bestand). */
+    logo?: DruckLogo | null;
+    /** "erstellt mit Kasseneck" am Ende (Konto-Flag `kreiseck_logo`). */
+    marke?: boolean;
 }
 /**
  * Der Bytestrom **samt** dem, was dem QR unterwegs zugestossen ist.