@kreiseck/kasseneck-api 0.13.2 → 0.14.0

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.

package/dist/cjs/receipt/layout-escpos.js

@@ -1,9 +1,41 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.pruefeLogoRaster = pruefeLogoRaster;
+exports.blattFuerDruck = blattFuerDruck;
 exports.escPosLayoutBytes = escPosLayoutBytes;
 exports.escPosLayoutErgebnis = escPosLayoutErgebnis;
 const index_js_1 = require("../printing/index.js");
+const blatt_js_1 = require("./blatt.js");
 const grid_js_1 = require("./grid.js");
+/** Das Rasterbild muss genau so gross sein, wie das Blatt das Logo setzt -- sonst stuende am Bon ein anderes Logo als am Schirm. */
+function pruefeLogoRaster(logo, mass, zeichen) {
+    const soll = (0, blatt_js_1.logoRasterMass)(mass, zeichen);
+    if (logo.raster.breite !== soll.breite || logo.raster.hoehe !== soll.hoehe) {
+        throw new Error(`Logo-Raster ${logo.raster.breite}x${logo.raster.hoehe} passt nicht zum Blatt (${soll.breite}x${soll.hoehe})`);
+    }
+}
+/**
+ * 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.
+ */
+function blattFuerDruck(layout, optionen) {
+    const blattOptionen = {
+        zeichen: optionen.zeichen,
+        marke: optionen.marke === true,
+        qrGroesse: optionen.qrGroesse,
+    };
+    if (optionen.logo)
+        blattOptionen.logo = { stufe: optionen.logo.stufe, pxBreite: optionen.logo.pxBreite, pxHoehe: optionen.logo.pxHoehe };
+    const blatt = (0, blatt_js_1.belegBlatt)(layout, blattOptionen);
+    const logoBlock = blatt.bloecke.find((b) => b.art === 'logo');
+    if (optionen.logo && logoBlock && logoBlock.art === 'logo')
+        pruefeLogoRaster(optionen.logo, logoBlock, blatt.zeichen);
+    return blatt;
+}
 /**
  * Druckbar gemachtes Layout: Texte durch [escPosPrintableText] (Codepage,
  * "EUR" statt "€", Striche), damit das Raster mit den Zeichen rechnet, die
@@ -72,6 +104,13 @@ function escPosLayoutErgebnis(layout, options = {}) {
      * `qrFehler` aus `escPosQrCode`, und der Beleg geht ohne QR hinaus.
      */
     const qrZeile = (nutzlast) => {
+        // Ein Inhalt, der in keine QR-Version passt, laesst sich weder als Befehl
+        // noch als Bild drucken -- beide Wege wuerfen. Der Beleg geht ohne QR
+        // hinaus und sagt es ueber `qrFehler`, wie das Blatt (Anteil 0).
+        if (nutzlast !== '' && !(0, index_js_1.qrPasstInVersion)(nutzlast)) {
+            doc.qrFehler = 'QR-Inhalt passt in keine QR-Version -- Beleg ohne QR';
+            return;
+        }
         const raster = options.qrMatrix;
         if (nutzlast !== '' && raster !== undefined) {
             if (modus === 'imageRaster') {
@@ -98,27 +137,28 @@ function escPosLayoutErgebnis(layout, options = {}) {
         }
         (0, index_js_1.escPosQrCode)(doc, nutzlast, qrOptionen);
     };
-    const grid = (0, grid_js_1.renderReceiptGrid)(druckbaresLayout(layout), { zeichen: grid_js_1.ZEICHEN_JE_PAPIER[paperSize] });
-    for (const zeile of grid.lines) {
-        switch (zeile.kind) {
-            case 'space':
-                (0, index_js_1.escPosFeed)(doc, 1);
-                break;
+    // `blattFuerDruck` prueft das Logo-Raster bereits VOR der Rueckgabe -- die
+    // Schleife unten schreibt darum nie ein Byte auf ein falsch grosses Logo.
+    const blatt = blattFuerDruck(druckbaresLayout(layout), {
+        zeichen: grid_js_1.ZEICHEN_JE_PAPIER[paperSize],
+        logo: options.logo,
+        marke: options.marke,
+        qrGroesse: options.qrGroesse ?? 'auto',
+    });
+    for (const block of blatt.bloecke) {
+        switch (block.art) {
             case 'qr':
-                qrZeile(zeile.qr ?? '');
+                qrZeile(block.nutzlast);
                 break;
-            case 'banner': {
-                // Belegart/Warnung: fett zwischen zwei Volllinien — derselbe Rahmen-
-                // Stil wie im Beleg-Viewer und im PDF (frueher druckte der Bon invers
-                // weiss-auf-schwarz und sah damit anders aus als jede Anzeige).
-                const rahmen = '='.repeat(grid_js_1.ZEICHEN_JE_PAPIER[paperSize]);
-                (0, index_js_1.escPosText)(doc, rahmen, { styles: { align: 'left', bold: true } });
-                (0, index_js_1.escPosText)(doc, zeile.text.trimEnd(), { styles: { align: 'left', bold: true, height: 2 } });
-                (0, index_js_1.escPosText)(doc, rahmen, { styles: { align: 'left', bold: true } });
+            case 'logo':
+                if (options.logo)
+                    (0, index_js_1.escPosRasterBild)(doc, options.logo.raster, { align: 'center' });
                 break;
-            }
-            default:
-                (0, index_js_1.escPosText)(doc, zeile.text.trimEnd(), { styles: { align: 'left', bold: zeile.bold } });
+            case 'zeile':
+                if (block.leer)
+                    (0, index_js_1.escPosFeed)(doc, 1);
+                else
+                    (0, index_js_1.escPosText)(doc, block.text.trimEnd(), { styles: { align: 'left', bold: block.fett } });
                 break;
         }
     }

package/dist/esm/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/esm/client/receipts.js

@@ -567,5 +567,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/esm/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/esm/kasse/drucker.js

@@ -1,3 +1,4 @@
+import { rasterZeilenBase64 } from '../printing/index.js';
 const text = (v) => (typeof v === 'string' && v ? v : null);
 const zahl = (v) => (typeof v === 'number' && Number.isFinite(v) ? v : null);
 export async function listMyPrinters(rufen) {
@@ -22,6 +23,14 @@ export 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: 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/esm/kasse/settings.js

@@ -112,8 +112,11 @@ export const KASSE_TASTEN_STANDARD = Object.freeze({
     korbLeeren: ['Mod+C'],
 });
 export const 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/esm/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/esm/printing/escpos.js

@@ -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 { QR_DRUCK_PUNKTE, QR_MINDEST_PUNKTE, QR_MODUL_DECKEL, QR_RUHEZONE_MODULE, qrGroesseFuer, } from './qr-groesse.js';
 // -------------------------------------------------------------- Befehlsbytes
@@ -581,13 +582,19 @@ export 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.
  */
 export 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)}`);
@@ -628,8 +635,8 @@ export 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
@@ -714,9 +721,10 @@ export 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)
@@ -728,18 +736,14 @@ export 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' });
@@ -755,3 +759,68 @@ export function qrRasterPunkte(paperSize, moduleAnzahl, options = {}) {
     const deckel = QR_MODUL_DECKEL[options.groesse ?? 'auto'];
     return Math.max(1, Math.min(deckel, Math.floor(QR_DRUCK_PUNKTE[paperSize] / (moduleAnzahl + 2 * ruhezone))));
 }
+/** Die Rasterzeilen als Bytes: MSB zuerst, jede Zeile auf volle Bytes aufgefuellt. */
+export 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.
+ */
+export 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.
+ */
+export 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_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/esm/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/esm/printing/index.js

@@ -1,4 +1,4 @@
-export { createEscPosDocument, escPosBytes, escPosReset, escPosSetGlobalCodeTable, escPosSetGlobalFont, escPosSetStyles, escPosText, escPosEmptyLines, escPosFeed, escPosCut, escPosHr, escPosRow, escPosQrCode, escPosQrRaster, qrRasterPunkte, encodeEscPosText, qrCodeBytes, escPosMaxCharsPerLine, escPosWortzeilen, wortzeilenText, } from './escpos.js';
-export { 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 { createEscPosDocument, escPosBytes, escPosReset, escPosSetGlobalCodeTable, escPosSetGlobalFont, escPosSetStyles, escPosText, escPosEmptyLines, escPosFeed, escPosCut, escPosHr, escPosRow, escPosQrCode, escPosQrRaster, qrRasterPunkte, rasterZeilenBytes, rasterZeilenBase64, escPosRasterBild, encodeEscPosText, qrCodeBytes, escPosMaxCharsPerLine, escPosWortzeilen, wortzeilenText, } from './escpos.js';
+export { 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 { USB_VENDOR_EPSON, USB_CLASS_PRINTER, UsbTimeoutError, usbDeviceKey, usbFindPrinterEndpoint, usbWriteAll, usbConnectPrinter, usbPrint, usbDisconnect, } from './webusb.js';