@kreiseck/kasseneck-api 0.30.0 → 1.0.0-rc.1

package/dist/cjs/receipt/grid.js

@@ -1,9 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ZEICHEN_JE_PAPIER = void 0;
-exports.gridSpaltenBreiten = gridSpaltenBreiten;
+exports.CHARS_PER_PAPER_SIZE = void 0;
+exports.gridColumnWidths = gridColumnWidths;
 exports.renderReceiptGrid = renderReceiptGrid;
-exports.gridAlsText = gridAlsText;
+exports.gridToText = gridToText;
 const escpos_js_1 = require("../printing/escpos.js");
 /**
  * Zeichenraster: der Beleg als Zeilen mit **exakt N Zeichen** -- die einzige
@@ -16,7 +16,7 @@ const escpos_js_1 = require("../printing/escpos.js");
  *   letzte Spalte, jede mindestens 1. Zwischen zwei Spalten steht immer
  *   mindestens ein Leerzeichen (letztes Zeichen jeder nicht-letzten Spalte).
  *   Die letzte Spalte endet buendig am rechten Rand.
- * - Text/Aufdruck/Spalteninhalt bricht **wortweise** um (`wortzeilenText`,
+ * - Text/Aufdruck/Spalteninhalt bricht **wortweise** um (`wrapText`,
  *   dieselbe Regel wie der ESC/POS-Kern); ueberlange Woerter nach einem
  *   Bindestrich, sonst hart; geschuetztes Leerzeichen bricht nie.
  * - Fliessregel: laeuft in einer Spaltenzeile nur eine Spalte ueber die erste
@@ -25,14 +25,14 @@ const escpos_js_1 = require("../printing/escpos.js");
  * - Trennlinie ueber die volle Breite, Leerraum als Leerzeilen, QR als eigene
  *   Zeile mit Nutzlast (der Zeichner setzt das Bild).
  */
-exports.ZEICHEN_JE_PAPIER = { mm58: 32, mm80: 48 };
+exports.CHARS_PER_PAPER_SIZE = { mm58: 32, mm80: 48 };
 /** Zwoelftel -> Zeichen je Spalte (ganze Zeichen, Rest an die letzte, mindestens 1). */
-function gridSpaltenBreiten(zwoelftel, zeichen) {
+function gridColumnWidths(twelfths, chars) {
     const out = [];
     let vergeben = 0;
-    zwoelftel.forEach((w, i) => {
-        const letzte = i === zwoelftel.length - 1;
-        const b = letzte ? Math.max(1, zeichen - vergeben) : Math.max(1, Math.floor((zeichen * w) / 12));
+    twelfths.forEach((w, i) => {
+        const letzte = i === twelfths.length - 1;
+        const b = letzte ? Math.max(1, chars - vergeben) : Math.max(1, Math.floor((chars * w) / 12));
         out.push(b);
         vergeben += b;
     });
@@ -58,13 +58,13 @@ function restNach(text, erste) {
     return text.slice(i);
 }
 function renderReceiptGrid(layout, options = {}) {
-    const zeichen = Math.max(8, Math.floor(options.zeichen ?? exports.ZEICHEN_JE_PAPIER[layout.paperSize] ?? 32));
+    const zeichen = Math.max(8, Math.floor(options.charsPerLine ?? exports.CHARS_PER_PAPER_SIZE[layout.paperSize] ?? 32));
     const leer = ' '.repeat(zeichen);
     const lines = [];
     for (const z of layout.lines) {
         switch (z.kind) {
             case 'text':
-                for (const t of (0, escpos_js_1.wortzeilenText)(z.text, zeichen))
+                for (const t of (0, escpos_js_1.wrapText)(z.text, zeichen))
                     lines.push({ text: ausrichten(t, zeichen, z.align), kind: 'text', bold: z.bold });
                 break;
             case 'banner': {
@@ -73,10 +73,10 @@ function renderReceiptGrid(layout, options = {}) {
                 // 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 });
+                lines.push({ text: rahmen, kind: 'banner', bold: true, tone: z.tone });
+                for (const t of (0, escpos_js_1.wrapText)(z.text, zeichen))
+                    lines.push({ text: ausrichten(t, zeichen, 'center'), kind: 'banner', bold: true, tone: z.tone });
+                lines.push({ text: rahmen, kind: 'banner', bold: true, tone: z.tone });
                 break;
             }
             case 'rule':
@@ -90,10 +90,10 @@ function renderReceiptGrid(layout, options = {}) {
                 lines.push({ text: ausrichten(QR_PLATZHALTER, zeichen, 'center'), kind: 'qr', bold: false, qr: z.data });
                 break;
             case 'columns': {
-                const breiten = gridSpaltenBreiten(z.columns.map((c) => c.width), zeichen);
+                const breiten = gridColumnWidths(z.columns.map((c) => c.width), zeichen);
                 // Inhalt jeder nicht-letzten Spalte um 1 Zeichen schmaler: garantierter Abstand.
                 const inhalt = breiten.map((b, i) => (i < breiten.length - 1 ? Math.max(1, b - 1) : b));
-                const teile = z.columns.map((c, i) => (0, escpos_js_1.wortzeilenText)(c.text, inhalt[i]));
+                const teile = z.columns.map((c, i) => (0, escpos_js_1.wrapText)(c.text, inhalt[i]));
                 // Fliessregel: laeuft nach der ersten Zeile nur noch EINE Spalte weiter (die anderen sind
                 // fertig), bekommt ihr Rest die volle Breite -- auf 58 mm sonst 18-Zeichen-Schnipsel.
                 // Laufen mehrere weiter, bleibt das Raster (sonst verschoeben sich die Nachbarn).
@@ -113,7 +113,7 @@ function renderReceiptGrid(layout, options = {}) {
                     // Rest aus dem Originaltext (nicht aus den schmal umbrochenen Stuecken), damit
                     // Bindestrich-/Hartbrueche der schmalen Spalte nicht als Leerzeichen zurueckbleiben.
                     const rest = restNach(z.columns[i].text, teile[i][0]);
-                    for (const t of (0, escpos_js_1.wortzeilenText)(rest, zeichen))
+                    for (const t of (0, escpos_js_1.wrapText)(rest, zeichen))
                         lines.push({ text: ausrichten(t, zeichen, z.columns[i].align), kind: 'columns', bold: false });
                 }
                 break;
@@ -122,9 +122,9 @@ function renderReceiptGrid(layout, options = {}) {
                 break;
         }
     }
-    return { lines, zeichen };
+    return { lines, charsPerLine: zeichen };
 }
 /** Klartext (eine Zeile je Rasterzeile) -- fuer Golden-Dateien und Logs. QR als Platzhalter. */
-function gridAlsText(grid) {
+function gridToText(grid) {
     return grid.lines.map((z) => z.text).join('\n');
 }

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

@@ -1,8 +1,9 @@
-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, 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, 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, papierFuerZeichen, logoMass, logoPixelZulaessig, logoRasterMass, qrBlattAnteil, belegBlatt, } from './blatt.js';
-export { logoRaster } from './bild.js';
-export { type MarkeRasterDaten, MARKE_RASTER, MARKE_PFADE } from './marke-daten.js';
-export { markeBild } from './marke.js';
+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, CURRENT_LAYOUT_RULESET, type LayoutBannerLine, type LayoutBannerTone, type LayoutRuleset, SMALL_BUSINESS_NOTICE, formatCents, } from './layout.js';
+export { type EscPosLayoutOptions, type EscPosLayoutResult, type QrPrintMode, type PrintLogo, assertLogoRaster, escPosLayoutBytes, escPosLayoutResult, } from './layout-escpos.js';
+export { type GridLine, type GridLineKind, type ReceiptGrid, type RenderReceiptGridOptions, renderReceiptGrid, gridColumnWidths, gridToText, CHARS_PER_PAPER_SIZE, } from './grid.js';
+export { type EposPrintXmlOptions, type EposPrintResult, type EposDirectOptions, type EposResponse, EposConnectionError, eposPrintXml, eposPrintXmlResult, eposXmlEscape, eposImageXml, eposServiceUrl, eposSoapEnvelope, eposParseResponse, eposDirectPrint, eposDirectStatus } from './epos.js';
+export { type SheetLogoSize, type SheetLogo, type LogoDimensions, type SheetBlock, type ReceiptSheet, type ReceiptSheetOptions, SHEET_LOGO_SIZES, LOGO_MAX_PIXELS, DOTS_PER_CHAR, DOTS_PER_LINE, paperSizeForChars, logoDimensions, isLogoPixelSizeAllowed, logoRasterSize, qrSheetWidthFraction, receiptSheet, } from './blatt.js';
+export { rasterizeLogo } from './bild.js';
+export { type BrandMarkRaster, BRAND_MARK_RASTERS, BRAND_MARK_PATHS } from './marke-daten.js';
+export { brandMarkImage } from './marke.js';
+export { type ReceiptDueTip, type ReceiptDueTipRecipient, type ReceiptDueOptions, type ReceiptDueBuckets, type ReceiptDueBreakdown, receiptDueCents, receiptDueBreakdown, } from './due.js';

package/dist/cjs/receipt/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.markeBild = exports.MARKE_PFADE = exports.MARKE_RASTER = exports.logoRaster = exports.belegBlatt = exports.qrBlattAnteil = exports.logoRasterMass = exports.logoPixelZulaessig = exports.logoMass = exports.papierFuerZeichen = 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;
+exports.receiptDueBreakdown = exports.receiptDueCents = exports.brandMarkImage = exports.BRAND_MARK_PATHS = exports.BRAND_MARK_RASTERS = exports.rasterizeLogo = exports.receiptSheet = exports.qrSheetWidthFraction = exports.logoRasterSize = exports.isLogoPixelSizeAllowed = exports.logoDimensions = exports.paperSizeForChars = exports.DOTS_PER_LINE = exports.DOTS_PER_CHAR = exports.LOGO_MAX_PIXELS = exports.SHEET_LOGO_SIZES = exports.eposDirectStatus = exports.eposDirectPrint = exports.eposParseResponse = exports.eposSoapEnvelope = exports.eposServiceUrl = exports.eposImageXml = exports.eposXmlEscape = exports.eposPrintXmlResult = exports.eposPrintXml = exports.EposConnectionError = exports.CHARS_PER_PAPER_SIZE = exports.gridToText = exports.gridColumnWidths = exports.renderReceiptGrid = exports.escPosLayoutResult = exports.escPosLayoutBytes = exports.assertLogoRaster = exports.formatCents = exports.SMALL_BUSINESS_NOTICE = exports.CURRENT_LAYOUT_RULESET = 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; } });
@@ -9,44 +9,47 @@ Object.defineProperty(exports, "receiptIsZero", { enumerable: true, get: functio
 Object.defineProperty(exports, "receiptAmountsAreZero", { enumerable: true, get: function () { return layout_js_1.receiptAmountsAreZero; } });
 Object.defineProperty(exports, "receiptIsSmallBusinessConsistent", { enumerable: true, get: function () { return layout_js_1.receiptIsSmallBusinessConsistent; } });
 Object.defineProperty(exports, "receiptZdaText", { enumerable: true, get: function () { return layout_js_1.receiptZdaText; } });
-Object.defineProperty(exports, "AKTUELLES_REGELWERK", { enumerable: true, get: function () { return layout_js_1.AKTUELLES_REGELWERK; } });
+Object.defineProperty(exports, "CURRENT_LAYOUT_RULESET", { enumerable: true, get: function () { return layout_js_1.CURRENT_LAYOUT_RULESET; } });
 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, "assertLogoRaster", { enumerable: true, get: function () { return layout_escpos_js_1.assertLogoRaster; } });
 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; } });
+Object.defineProperty(exports, "escPosLayoutResult", { enumerable: true, get: function () { return layout_escpos_js_1.escPosLayoutResult; } });
 var grid_js_1 = require("./grid.js");
 Object.defineProperty(exports, "renderReceiptGrid", { enumerable: true, get: function () { return grid_js_1.renderReceiptGrid; } });
-Object.defineProperty(exports, "gridSpaltenBreiten", { enumerable: true, get: function () { return grid_js_1.gridSpaltenBreiten; } });
-Object.defineProperty(exports, "gridAlsText", { enumerable: true, get: function () { return grid_js_1.gridAlsText; } });
-Object.defineProperty(exports, "ZEICHEN_JE_PAPIER", { enumerable: true, get: function () { return grid_js_1.ZEICHEN_JE_PAPIER; } });
+Object.defineProperty(exports, "gridColumnWidths", { enumerable: true, get: function () { return grid_js_1.gridColumnWidths; } });
+Object.defineProperty(exports, "gridToText", { enumerable: true, get: function () { return grid_js_1.gridToText; } });
+Object.defineProperty(exports, "CHARS_PER_PAPER_SIZE", { enumerable: true, get: function () { return grid_js_1.CHARS_PER_PAPER_SIZE; } });
 var epos_js_1 = require("./epos.js");
 Object.defineProperty(exports, "EposConnectionError", { enumerable: true, get: function () { return epos_js_1.EposConnectionError; } });
 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, "eposPrintXmlResult", { enumerable: true, get: function () { return epos_js_1.eposPrintXmlResult; } });
 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, "eposImageXml", { enumerable: true, get: function () { return epos_js_1.eposImageXml; } });
 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, "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; } });
+Object.defineProperty(exports, "SHEET_LOGO_SIZES", { enumerable: true, get: function () { return blatt_js_1.SHEET_LOGO_SIZES; } });
+Object.defineProperty(exports, "LOGO_MAX_PIXELS", { enumerable: true, get: function () { return blatt_js_1.LOGO_MAX_PIXELS; } });
+Object.defineProperty(exports, "DOTS_PER_CHAR", { enumerable: true, get: function () { return blatt_js_1.DOTS_PER_CHAR; } });
+Object.defineProperty(exports, "DOTS_PER_LINE", { enumerable: true, get: function () { return blatt_js_1.DOTS_PER_LINE; } });
+Object.defineProperty(exports, "paperSizeForChars", { enumerable: true, get: function () { return blatt_js_1.paperSizeForChars; } });
+Object.defineProperty(exports, "logoDimensions", { enumerable: true, get: function () { return blatt_js_1.logoDimensions; } });
+Object.defineProperty(exports, "isLogoPixelSizeAllowed", { enumerable: true, get: function () { return blatt_js_1.isLogoPixelSizeAllowed; } });
+Object.defineProperty(exports, "logoRasterSize", { enumerable: true, get: function () { return blatt_js_1.logoRasterSize; } });
+Object.defineProperty(exports, "qrSheetWidthFraction", { enumerable: true, get: function () { return blatt_js_1.qrSheetWidthFraction; } });
+Object.defineProperty(exports, "receiptSheet", { enumerable: true, get: function () { return blatt_js_1.receiptSheet; } });
 var bild_js_1 = require("./bild.js");
-Object.defineProperty(exports, "logoRaster", { enumerable: true, get: function () { return bild_js_1.logoRaster; } });
+Object.defineProperty(exports, "rasterizeLogo", { enumerable: true, get: function () { return bild_js_1.rasterizeLogo; } });
 var marke_daten_js_1 = require("./marke-daten.js");
-Object.defineProperty(exports, "MARKE_RASTER", { enumerable: true, get: function () { return marke_daten_js_1.MARKE_RASTER; } });
-Object.defineProperty(exports, "MARKE_PFADE", { enumerable: true, get: function () { return marke_daten_js_1.MARKE_PFADE; } });
+Object.defineProperty(exports, "BRAND_MARK_RASTERS", { enumerable: true, get: function () { return marke_daten_js_1.BRAND_MARK_RASTERS; } });
+Object.defineProperty(exports, "BRAND_MARK_PATHS", { enumerable: true, get: function () { return marke_daten_js_1.BRAND_MARK_PATHS; } });
 var marke_js_1 = require("./marke.js");
-Object.defineProperty(exports, "markeBild", { enumerable: true, get: function () { return marke_js_1.markeBild; } });
+Object.defineProperty(exports, "brandMarkImage", { enumerable: true, get: function () { return marke_js_1.brandMarkImage; } });
+var due_js_1 = require("./due.js");
+Object.defineProperty(exports, "receiptDueCents", { enumerable: true, get: function () { return due_js_1.receiptDueCents; } });
+Object.defineProperty(exports, "receiptDueBreakdown", { enumerable: true, get: function () { return due_js_1.receiptDueBreakdown; } });

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

@@ -1,6 +1,6 @@
-import { type PosCodeTable, type PosCutMode, type PosPaperSize, type QrCorrection, type QrMatrix, type QrModulGroesse, type QrSize, type RasterBild } from '../printing/index.js';
+import { type PosCodeTable, type PosCutMode, type PosPaperSize, type QrCorrection, type QrMatrix, type QrModuleSize, type QrSize, type RasterImage } from '../printing/index.js';
 import type { ReceiptLayout } from './layout.js';
-import { type BelegBlatt, type LogoStufe, type LogoMass } from './blatt.js';
+import { type ReceiptSheet, type SheetLogoSize, type LogoDimensions } from './blatt.js';
 /**
  * Bruecke vom Layout-Modell zu ESC/POS-Bytes — der Bondrucker-Ausgabeweg.
  *
@@ -29,18 +29,18 @@ import { type BelegBlatt, type LogoStufe, type LogoMass } from './blatt.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;
+/** Firmenlogo fuer den Druck: Stufe, Pixelmass des Originals und das fertige Rasterbild (`rasterizeLogo`). */
+export interface PrintLogo {
+    size: SheetLogoSize;
+    pixelWidth: number;
+    pixelHeight: number;
+    raster: RasterImage;
 }
 /** 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;
+export declare function assertLogoRaster(logo: PrintLogo, dimensions: LogoDimensions, chars: number): void;
 /**
  * Baut das Blatt fuer einen Druckweg (ESC/POS, ePOS) an EINER Stelle: die
- * Zuordnung `DruckLogo` -> `BlattLogo` und die Groessenpruefung des mitgebrachten
+ * Zuordnung `PrintLogo` -> `SheetLogo` 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
@@ -48,10 +48,10 @@ export declare function pruefeLogoRaster(logo: DruckLogo, mass: LogoMass, zeiche
  */
 export declare function blattFuerDruck(layout: ReceiptLayout, optionen: {
     zeichen: number;
-    logo?: DruckLogo | null;
+    logo?: PrintLogo | null;
     marke?: boolean;
-    qrGroesse: QrModulGroesse;
-}): BelegBlatt;
+    qrGroesse: QrModuleSize;
+}): ReceiptSheet;
 export interface EscPosLayoutOptions {
     /** Papierbreite; Vorgabe ist die des Layouts (dessen Spaltenbreiten daran haengen). */
     paperSize?: PosPaperSize;
@@ -67,9 +67,9 @@ export interface EscPosLayoutOptions {
     /** Fehlerkorrekturstufe des QR-Codes; Vorgabe `M` (wie ePOS, Bildweg und Blatt). */
     qrCorrection?: QrCorrection;
     /** Deckel fuer die gerechnete Modulgroesse; Vorgabe `auto` (hoechstens 6 Punkte je Modul). */
-    qrGroesse?: QrModulGroesse;
+    qrModuleSize?: QrModuleSize;
     /** Druckweg des QR; Vorgabe `native` (der Bestandsweg). */
-    qrModus?: QrPrintMode;
+    qrMode?: QrPrintMode;
     /**
      * Raster fuer den Bildweg — ohne das gibt es keinen Notausgang.
      *
@@ -77,24 +77,24 @@ export interface EscPosLayoutOptions {
      * Kopf von `layout.ts`); der Aufrufer bringt das fertige Raster mit, etwa
      * aus der QR-Bibliothek, die er ohnehin fuer den Bildschirm benutzt.
      */
-    qrMatrix?: (nutzlast: string) => QrMatrix;
+    qrMatrix?: (payload: string) => QrMatrix;
     /** Firmenlogo; ohne Angabe kein Logo (Bestand). */
-    logo?: DruckLogo | null;
+    logo?: PrintLogo | null;
     /** Das Kasseneck-Logo am Ende (Konto-Flag `kreiseck_logo`). */
-    marke?: boolean;
+    brandMark?: boolean;
 }
 /**
  * Der Bytestrom **samt** dem, was dem QR unterwegs zugestossen ist.
  *
- * Zwilling von `KeckPrintResult`: `qrFehler` heisst "Beleg ohne QR,
- * nachdrucken oder elektronisch ausgeben", `qrAusweich` heisst "gedruckt,
+ * Zwilling von `KeckPrintResult`: `qrError` heisst "Beleg ohne QR,
+ * nachdrucken oder elektronisch ausgeben", `qrFallback` heisst "gedruckt,
  * aber der eingestellte Weg taugt fuer dieses Geraet nicht" — das eine gehoert
  * dem Kunden gesagt, das andere dem Chef.
  */
-export interface EscPosLayoutErgebnis {
+export interface EscPosLayoutResult {
     bytes: Uint8Array;
-    qrFehler: string | null;
-    qrAusweich: string | null;
+    qrError: string | null;
+    qrFallback: string | null;
 }
 /**
  * Bytes fuer den Bondrucker -- **aus dem Zeichenraster** ([renderReceiptGrid]):
@@ -108,4 +108,4 @@ export declare function escPosLayoutBytes(layout: ReceiptLayout, options?: EscPo
  * zugestossen ist. Die Bytes sind dieselben; wer die Meldungen braucht, nimmt
  * diesen Weg.
  */
-export declare function escPosLayoutErgebnis(layout: ReceiptLayout, options?: EscPosLayoutOptions): EscPosLayoutErgebnis;
+export declare function escPosLayoutResult(layout: ReceiptLayout, options?: EscPosLayoutOptions): EscPosLayoutResult;

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

@@ -1,23 +1,23 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.pruefeLogoRaster = pruefeLogoRaster;
+exports.assertLogoRaster = assertLogoRaster;
 exports.blattFuerDruck = blattFuerDruck;
 exports.escPosLayoutBytes = escPosLayoutBytes;
-exports.escPosLayoutErgebnis = escPosLayoutErgebnis;
+exports.escPosLayoutResult = escPosLayoutResult;
 const index_js_1 = require("../printing/index.js");
 const blatt_js_1 = require("./blatt.js");
 const grid_js_1 = require("./grid.js");
 const marke_js_1 = require("./marke.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})`);
+function assertLogoRaster(logo, dimensions, chars) {
+    const soll = (0, blatt_js_1.logoRasterSize)(dimensions, chars);
+    if (logo.raster.width !== soll.width || logo.raster.height !== soll.height) {
+        throw new Error(`Logo-Raster ${logo.raster.width}x${logo.raster.height} passt nicht zum Blatt (${soll.width}x${soll.height})`);
     }
 }
 /**
  * Baut das Blatt fuer einen Druckweg (ESC/POS, ePOS) an EINER Stelle: die
- * Zuordnung `DruckLogo` -> `BlattLogo` und die Groessenpruefung des mitgebrachten
+ * Zuordnung `PrintLogo` -> `SheetLogo` 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
@@ -25,16 +25,16 @@ function pruefeLogoRaster(logo, mass, zeichen) {
  */
 function blattFuerDruck(layout, optionen) {
     const blattOptionen = {
-        zeichen: optionen.zeichen,
-        marke: optionen.marke === true,
-        qrGroesse: optionen.qrGroesse,
+        charsPerLine: optionen.zeichen,
+        brandMark: optionen.marke === true,
+        qrModuleSize: 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);
+        blattOptionen.logo = { size: optionen.logo.size, pixelWidth: optionen.logo.pixelWidth, pixelHeight: optionen.logo.pixelHeight };
+    const blatt = (0, blatt_js_1.receiptSheet)(layout, blattOptionen);
+    const logoBlock = blatt.blocks.find((b) => b.kind === 'logo');
+    if (optionen.logo && logoBlock && logoBlock.kind === 'logo')
+        assertLogoRaster(optionen.logo, logoBlock, blatt.charsPerLine);
     return blatt;
 }
 /**
@@ -63,14 +63,14 @@ function druckbaresLayout(layout) {
  * zeigt, druckt der Drucker (Monospace, Font A: 32/48 Zeichen).
  */
 function escPosLayoutBytes(layout, options = {}) {
-    return escPosLayoutErgebnis(layout, options).bytes;
+    return escPosLayoutResult(layout, options).bytes;
 }
 /**
  * Wie [escPosLayoutBytes], gibt aber zusaetzlich zurueck, was dem QR
  * zugestossen ist. Die Bytes sind dieselben; wer die Meldungen braucht, nimmt
  * diesen Weg.
  */
-function escPosLayoutErgebnis(layout, options = {}) {
+function escPosLayoutResult(layout, options = {}) {
     const paperSize = options.paperSize ?? layout.paperSize;
     const dokumentOptionen = { paperSize };
     if (options.codeTable !== undefined) {
@@ -78,38 +78,38 @@ function escPosLayoutErgebnis(layout, options = {}) {
     }
     const doc = (0, index_js_1.createEscPosDocument)(dokumentOptionen);
     (0, index_js_1.escPosReset)(doc);
-    const modus = options.qrModus ?? 'native';
+    const modus = options.qrMode ?? 'native';
     const qrOptionen = { align: 'center' };
     if (options.qrSize !== undefined)
         qrOptionen.size = options.qrSize;
     if (options.qrCorrection !== undefined)
         qrOptionen.correction = options.qrCorrection;
-    if (options.qrGroesse !== undefined)
-        qrOptionen.groesse = options.qrGroesse;
+    if (options.qrModuleSize !== undefined)
+        qrOptionen.moduleSize = options.qrModuleSize;
     if (modus === 'nativeModel1')
-        qrOptionen.modell1 = true;
+        qrOptionen.model1 = true;
     if (modus === 'imageRaster' && options.qrMatrix === undefined) {
         throw new Error("qrModus 'imageRaster' braucht ein qrMatrix -- dieses Paket rastert nicht selbst");
     }
     const rasterOptionen = { align: 'center' };
-    if (options.qrGroesse !== undefined)
-        rasterOptionen.groesse = options.qrGroesse;
+    if (options.qrModuleSize !== undefined)
+        rasterOptionen.moduleSize = options.qrModuleSize;
     /**
      * Eine QR-Zeile des Rasters. Hier sitzt der **Notausgang**: passt das Symbol
      * nativ auch mit der Ausnahmegroesse nicht aufs Papier, druckt der Drucker
      * es GAR NICHT -- er schneidet nicht ab, er laesst weg. Ein Pflichtbeleg
      * ohne QR ist der schlechteste aller Ausgaenge, also geht der QR dann als
-     * Bild hinaus, und der Aufrufer erfaehrt es ueber `qrAusweich`.
+     * Bild hinaus, und der Aufrufer erfaehrt es ueber `qrFallback`.
      *
      * Ohne `qrMatrix` gibt es diesen Weg nicht -- dann bleibt nur die Meldung
-     * `qrFehler` aus `escPosQrCode`, und der Beleg geht ohne QR hinaus.
+     * `qrError` 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';
+        // hinaus und sagt es ueber `qrError`, wie das Blatt (Anteil 0).
+        if (nutzlast !== '' && !(0, index_js_1.qrFitsInVersion)(nutzlast)) {
+            doc.qrError = 'QR-Inhalt passt in keine QR-Version -- Beleg ohne QR';
             return;
         }
         const raster = options.qrMatrix;
@@ -121,15 +121,15 @@ function escPosLayoutErgebnis(layout, options = {}) {
             // Feste `qrSize` heisst: der Aufrufer weiss, was er tut -- dann wird
             // weder gerechnet noch ausgewichen.
             if (options.qrSize === undefined) {
-                const mass = (0, index_js_1.qrGroesseFuer)({
-                    nutzlast,
-                    papierbreitePunkte: index_js_1.QR_DRUCK_PUNKTE[paperSize],
-                    groesse: options.qrGroesse ?? 'auto',
+                const mass = (0, index_js_1.qrSizingFor)({
+                    payload: nutzlast,
+                    paperWidthDots: index_js_1.QR_PRINT_WIDTH_DOTS[paperSize],
+                    moduleSize: options.qrModuleSize ?? 'auto',
                 });
-                if (!mass.passt) {
-                    doc.qrAusweich =
-                        `QR mit ${mass.module} Modulen passt nativ nicht auf ` +
-                            `${paperSize === 'mm58' ? 58 : 80} mm (${index_js_1.QR_DRUCK_PUNKTE[paperSize]} Punkte) ` +
+                if (!mass.fits) {
+                    doc.qrFallback =
+                        `QR mit ${mass.modules} Modulen passt nativ nicht auf ` +
+                            `${paperSize === 'mm58' ? 58 : 80} mm (${index_js_1.QR_PRINT_WIDTH_DOTS[paperSize]} Punkte) ` +
                             `-- als Bild gedruckt`;
                     (0, index_js_1.escPosQrRaster)(doc, raster(nutzlast), rasterOptionen);
                     return;
@@ -141,33 +141,33 @@ function escPosLayoutErgebnis(layout, options = {}) {
     // `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],
+        zeichen: grid_js_1.CHARS_PER_PAPER_SIZE[paperSize],
         logo: options.logo,
-        marke: options.marke,
-        qrGroesse: options.qrGroesse ?? 'auto',
+        marke: options.brandMark,
+        qrGroesse: options.qrModuleSize ?? 'auto',
     });
-    for (const block of blatt.bloecke) {
-        switch (block.art) {
+    for (const block of blatt.blocks) {
+        switch (block.kind) {
             case 'qr':
-                qrZeile(block.nutzlast);
+                qrZeile(block.payload);
                 break;
             case 'logo':
                 if (options.logo)
-                    (0, index_js_1.escPosRasterBild)(doc, options.logo.raster, { align: 'center' });
+                    (0, index_js_1.escPosRasterImage)(doc, options.logo.raster, { align: 'center' });
                 break;
-            case 'marke':
-                (0, index_js_1.escPosRasterBild)(doc, (0, marke_js_1.markeBild)(paperSize), { align: 'center' });
+            case 'brandMark':
+                (0, index_js_1.escPosRasterImage)(doc, (0, marke_js_1.brandMarkImage)(paperSize), { align: 'center' });
                 break;
-            case 'zeile':
-                if (block.leer)
+            case 'line':
+                if (block.blank)
                     (0, index_js_1.escPosFeed)(doc, 1);
                 else
-                    (0, index_js_1.escPosText)(doc, block.text.trimEnd(), { styles: { align: 'left', bold: block.fett } });
+                    (0, index_js_1.escPosText)(doc, block.text.trimEnd(), { styles: { align: 'left', bold: block.bold } });
                 break;
         }
     }
     if (options.cut !== false) {
         (0, index_js_1.escPosCut)(doc, options.cut === 'partial' ? 'partial' : 'full');
     }
-    return { bytes: (0, index_js_1.escPosBytes)(doc), qrFehler: doc.qrFehler, qrAusweich: doc.qrAusweich };
+    return { bytes: (0, index_js_1.escPosBytes)(doc), qrError: doc.qrError, qrFallback: doc.qrFallback };
 }

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

@@ -1,4 +1,4 @@
-import { type Receipt, type ReceiptCompany } from '../models/index.js';
+import { type Receipt, type ReceiptCompany, type RegistrationInfo } from '../models/index.js';
 import type { PosPaperSize } from '../printing/escpos.js';
 /**
  * Beleg-Layout — der Bauplan eines Kasseneck-Belegs als reines Datenmodell.
@@ -76,9 +76,14 @@ export interface LayoutQrLine {
 export interface LayoutBannerLine {
     kind: 'banner';
     text: string;
-    /** `warnung` fuer Testkasse/Testsignatur (nicht gueltiger Beleg), sonst `belegart`. */
-    ton: 'belegart' | 'warnung';
+    /**
+     * `warning` fuer Testkasse/Testsignatur (kein gueltiger Beleg), sonst
+     * `receipt_type` (Belegart). Werte wie am `/v3`-Draht (Katalog `LAYOUT_TON`).
+     */
+    tone: LayoutBannerTone;
 }
+/** Ton einer hervorgehobenen Zeile, wie am `/v3`-Draht. */
+export type LayoutBannerTone = 'receipt_type' | 'warning';
 export type LayoutLine = LayoutTextLine | LayoutColumnsLine | LayoutRuleLine | LayoutSpaceLine | LayoutQrLine | LayoutBannerLine;
 /**
  * Version des Layout-Regelwerks. Alte Belege werden mit ihrer gespeicherten
@@ -88,25 +93,15 @@ export type LayoutLine = LayoutTextLine | LayoutColumnsLine | LayoutRuleLine | L
  *   Signaturkarte, Zertifizierungsdienst, Registrierdaten); reduziert nur,
  *   wenn alle Betraege wirklich 0 sind. Vollbelege unveraendert.
  */
-export type LayoutRegelwerk = 1 | 2;
-export declare const AKTUELLES_REGELWERK: LayoutRegelwerk;
-/**
- * Registrierdaten fuer den Block „Prüfangaben“ auf Nullbelegen (Regelwerk 2).
- * Kennt sie nur das Backend (FinanzOnline-Registrierung der Signaturkarte und
- * der Kasse); fehlen sie, entfallen die Zeilen. Datum als „YYYY-MM-DD“ oder
- * ISO-Zeitstempel (Wiener Kalendertag).
- */
-export interface Pruefangaben {
-    karteRegistriertAm?: string | null;
-    kasseRegistriertAm?: string | null;
-}
+export type LayoutRuleset = 1 | 2;
+export declare const CURRENT_LAYOUT_RULESET: LayoutRuleset;
 /** Der fertige Bauplan eines Belegs. */
 export interface ReceiptLayout {
     lines: LayoutLine[];
     /** Papierbreite, nach der die Spaltenbreiten gewaehlt wurden. */
     paperSize: PosPaperSize;
     /** Regelwerk, nach dem gesetzt wurde. */
-    regelwerk: LayoutRegelwerk;
+    ruleset: LayoutRuleset;
 }
 export interface BuildReceiptLayoutOptions {
     /**
@@ -115,17 +110,27 @@ export interface BuildReceiptLayoutOptions {
      */
     paperSize?: PosPaperSize;
     /** Layout-Regelwerk (Vorgabe: aktuelles). Unbekannt -> Fehler, nie stumm anders setzen. */
-    regelwerk?: LayoutRegelwerk;
-    /** Beleg einer Testumgebung: Rahmen „TESTKASSE — kein gültiger Beleg“ oben und unten. */
-    testKasse?: boolean;
+    ruleset?: LayoutRuleset;
+    /**
+     * Beleg einer Testumgebung: Rahmen „TESTKASSE — kein gültiger Beleg“ oben
+     * und unten. Aus einer Antwort: `ReceiptWithCompany.testCashregister`.
+     */
+    testCashregister?: boolean;
     /**
      * Produktionskonto hat mit einer Test-Signatureinheit signiert: Rahmen
      * „TESTSIGNATUR — kein gültiger Beleg“. Der Aufrufer entscheidet (er kennt
-     * das Konto); [receiptSignatureIsTest] sagt nur, OB die Signatur eine Testsignatur ist.
+     * das Konto); [receiptSignatureIsTest] sagt nur, OB die Signatur eine
+     * Testsignatur ist. Aus einer Antwort: `ReceiptWithCompany.testSignature`.
+     */
+    testSignature?: boolean;
+    /**
+     * Registrierdaten fuer den Block „Prüfangaben“ (nur Nullbelege, Regelwerk 2).
+     * Kennt sie nur das Backend (FinanzOnline-Registrierung der Signaturkarte
+     * und der Kasse); fehlen sie, entfallen die Zeilen. Datum als „YYYY-MM-DD“
+     * oder ISO-Zeitstempel (Wiener Kalendertag). Aus einer Antwort:
+     * `ReceiptWithCompany.registrationInfo`.
      */
-    testSignatur?: boolean;
-    /** Registrierdaten fuer den Block „Prüfangaben“ (nur Nullbelege, Regelwerk 2). */
-    pruefangaben?: Pruefangaben | null;
+    registrationInfo?: RegistrationInfo | null;
 }
 /**
  * Cent-Betrag als Anzeigetext: `1234` -> `"12,34"`. Die **einzige** Stelle, an