@kreiseck/kasseneck-api 0.31.0 → 1.0.0-rc.2

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

@@ -26,9 +26,9 @@
  *
  * Nicht enthalten (bewusst): Bilddekodierung (PNG/JPEG liest die Huelle),
  * Capability-Profile einzelner Druckermodelle, Kassenlade, 1D-Barcodes.
- * Fertige einfarbige Rasterbilder (Logo) gehen ueber [escPosRasterBild].
+ * Fertige einfarbige Rasterbilder (Logo) gehen ueber [escPosRasterImage].
  */
-import { type QrModulGroesse } from './qr-groesse.js';
+import { type QrModuleSize } from './qr-groesse.js';
 /** Papierbreite der Bonrolle. */
 export type PosPaperSize = 'mm58' | 'mm80';
 /** Ausrichtung einer Textzeile bzw. innerhalb einer Spalte. */
@@ -107,18 +107,18 @@ export interface EscPosQrOptions {
     /** Fehlerkorrektur; Vorgabe `M` wie auf allen Druckwegen (siehe `qrCodeBytes`). */
     correction?: QrCorrection;
     /** Deckel fuer die gerechnete Modulgroesse; wirkungslos neben `size`. */
-    groesse?: QrModulGroesse;
+    moduleSize?: QrModuleSize;
     /** Modell 1 des Symbols ausdruecklich waehlen — siehe `qrCodeBytes`. */
-    modell1?: boolean;
+    model1?: boolean;
 }
 export interface EscPosQrRasterOptions {
     align?: PosAlign;
     /** Feste Punkte je Modul; ohne Angabe gerechnet (mindestens 1). */
-    punkteJeModul?: number;
+    dotsPerModule?: number;
     /** Deckel fuer die gerechnete Groesse. */
-    groesse?: QrModulGroesse;
-    /** Ruhezone je Seite in Modulen; Vorgabe `QR_RUHEZONE_MODULE` (4). */
-    ruhezoneModule?: number;
+    moduleSize?: QrModuleSize;
+    /** Ruhezone je Seite in Modulen; Vorgabe `QR_QUIET_ZONE_MODULES` (4). */
+    quietZoneModules?: number;
 }
 /** Interner Stilzustand — immer vollstaendig, nie teilbefuellt. */
 interface AktuelleStile {
@@ -147,18 +147,18 @@ export interface EscPosDocument {
      * ist der QR die maschinenlesbare Signatur: das muss der Aufrufer erfahren,
      * ohne den Bytestrom zu durchsuchen.
      */
-    qrFehler: string | null;
+    qrError: string | null;
     /**
      * Der QR steht auf dem Papier, aber nicht so wie eingestellt — `null`,
      * solange nichts abgewichen ist. Zwei Faelle, beide mit Grund im Text: das
      * Symbol war fuer den nativen Befehl zu breit und ging als Bild hinaus, oder
      * es passte nur unter der Mindest-Modulgroesse.
      *
-     * Getrennt von `qrFehler`, weil die Handlung eine andere ist: dort heisst es
+     * Getrennt von `qrError`, weil die Handlung eine andere ist: dort heisst es
      * "Beleg ohne QR, nachdrucken oder elektronisch ausgeben", hier "gedruckt,
      * aber der eingestellte Weg taugt fuer dieses Geraet nicht".
      */
-    qrAusweich: string | null;
+    qrFallback: string | null;
     /** intern: bisher erzeugte Bytes */
     readonly bytes: number[];
     /** intern: global gesetzte Codepage (ueberlebt `escPosReset`) */
@@ -226,7 +226,7 @@ export declare function escPosSetGlobalFont(doc: EscPosDocument, font: PosFont |
  * geaendert haben. Fehlende Felder in [styles] gelten als Vorgabe: wer fett
  * weglaesst, schaltet fett also ab.
  *
- * `zeilenanfang` (Vorgabe `true`) sagt, ob dieser Aufruf am Anfang einer
+ * `atLineStart` (Vorgabe `true`) sagt, ob dieser Aufruf am Anfang einer
  * Druckzeile steht. Nur dort nimmt der Drucker `ESC a` (Ausrichtung)
  * ueberhaupt an; mitten in der Zeile verwirft er den Befehl wortlos. Der
  * Bytestrom bekommt ihn trotzdem -- die Bytefolge soll sich dadurch nicht
@@ -234,8 +234,8 @@ export declare function escPosSetGlobalFont(doc: EscPosDocument, font: PosFont |
  * Wert stellen: sonst haelt eine spaetere, echte Zeile die Ausrichtung
  * faelschlich schon fuer gesetzt und unterlaesst den Befehl.
  */
-export declare function escPosSetStyles(doc: EscPosDocument, styles?: PosStyles, optionen?: {
-    zeilenanfang?: boolean;
+export declare function escPosSetStyles(doc: EscPosDocument, styles?: PosStyles, options?: {
+    atLineStart?: boolean;
 }): void;
 /**
  * Wortweiser Umbruch von (kodierten) Text-Bytes auf hoechstens `max` Zeichen
@@ -244,7 +244,7 @@ export declare function escPosSetStyles(doc: EscPosDocument, styles?: PosStyles,
  * sonst kaeme die Zeile nie voran. Ein Bondrucker bricht sonst hart mitten
  * im Wort ("Kleinunter|nehmer", "0,7|9"); das soll nie aufs Papier.
  */
-export declare function escPosWortzeilen(textBytes: Uint8Array, max: number): Uint8Array[];
+export declare function escPosWrapLines(textBytes: Uint8Array, max: number): Uint8Array[];
 /**
  * Dieselbe Regel fuer Zeichenketten -- fuer Bildschirm-Vorschauen, die das
  * Papier nachstellen, und fuer das Zeichenraster. Zusaetzlich:
@@ -253,7 +253,7 @@ export declare function escPosWortzeilen(textBytes: Uint8Array, max: number): Ui
  * - ein ueberlanges Wort bricht nach einem Bindestrich, wenn es einen hat
  *   ("Bio-" / "Dinkelvollkornsemmel"), sonst hart.
  */
-export declare function wortzeilenText(text: string, max: number): string[];
+export declare function wrapText(text: string, max: number): string[];
 /**
  * Druckt Text und schliesst die Zeile ab. Nach dem Text folgt immer genau ein
  * Zeilenumbruch, `linesAfter` haengt weitere an.
@@ -284,7 +284,7 @@ export declare function escPosRow(doc: EscPosDocument, columns: readonly PosColu
  * 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
+ * (`qrModuleCount`), 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.
@@ -292,7 +292,7 @@ export declare function escPosRow(doc: EscPosDocument, columns: readonly PosColu
 export declare function qrCodeBytes(text: string, options?: {
     size?: QrSize;
     correction?: QrCorrection;
-    modell1?: boolean;
+    model1?: boolean;
 }): Uint8Array;
 /**
  * Setzt die Ausrichtung und haengt den nativen QR-Befehl an — mit
@@ -329,26 +329,26 @@ export declare function escPosQrRaster(doc: EscPosDocument, matrix: QrMatrix, op
  * dieses Papier bringt — dieselbe Rechnung, nur ohne Untergrenze 3: ein Bild
  * darf bis auf einen Punkt je Modul schrumpfen und passt darum immer.
  */
-export declare function qrRasterPunkte(paperSize: PosPaperSize, moduleAnzahl: number, options?: {
-    groesse?: QrModulGroesse;
-    ruhezoneModule?: number;
+export declare function qrRasterDots(paperSize: PosPaperSize, moduleCount: number, options?: {
+    moduleSize?: QrModuleSize;
+    quietZoneModules?: number;
 }): number;
 /**
  * Einfarbiges Rasterbild in Druckpunkten, zeilenweise: `punkte[y * breite + x]`,
- * 1 = schwarz. Entsteht fuer das Firmenlogo in `logoRaster` (receipt/bild.ts).
+ * 1 = schwarz. Entsteht fuer das Firmenlogo in `rasterizeLogo` (receipt/bild.ts).
  */
-export interface RasterBild {
-    readonly breite: number;
-    readonly hoehe: number;
-    readonly punkte: Uint8Array;
+export interface RasterImage {
+    readonly width: number;
+    readonly height: number;
+    readonly dots: Uint8Array;
 }
 /** Die Rasterzeilen als Bytes: MSB zuerst, jede Zeile auf volle Bytes aufgefuellt. */
-export declare function rasterZeilenBytes(bild: RasterBild): Uint8Array;
+export declare function rasterRowsBytes(image: RasterImage): 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;
+export declare function rasterRowsBase64(image: RasterImage): string;
 /**
  * Ein Rasterbild (`GS v 0`) -- das Firmenlogo am Bon.
  *
@@ -356,7 +356,7 @@ export declare function rasterZeilenBase64(bild: RasterBild): string;
  * 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?: {
+export declare function escPosRasterImage(doc: EscPosDocument, image: RasterImage, options?: {
     align?: PosAlign;
 }): void;
 export {};

package/dist/cjs/printing/escpos.js

@@ -27,7 +27,7 @@
  *
  * Nicht enthalten (bewusst): Bilddekodierung (PNG/JPEG liest die Huelle),
  * Capability-Profile einzelner Druckermodelle, Kassenlade, 1D-Barcodes.
- * Fertige einfarbige Rasterbilder (Logo) gehen ueber [escPosRasterBild].
+ * Fertige einfarbige Rasterbilder (Logo) gehen ueber [escPosRasterImage].
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.encodeEscPosText = encodeEscPosText;
@@ -39,8 +39,8 @@ exports.escPosSetDruckbereich = escPosSetDruckbereich;
 exports.escPosSetGlobalCodeTable = escPosSetGlobalCodeTable;
 exports.escPosSetGlobalFont = escPosSetGlobalFont;
 exports.escPosSetStyles = escPosSetStyles;
-exports.escPosWortzeilen = escPosWortzeilen;
-exports.wortzeilenText = wortzeilenText;
+exports.escPosWrapLines = escPosWrapLines;
+exports.wrapText = wrapText;
 exports.escPosText = escPosText;
 exports.escPosEmptyLines = escPosEmptyLines;
 exports.escPosFeed = escPosFeed;
@@ -50,10 +50,10 @@ exports.escPosRow = escPosRow;
 exports.qrCodeBytes = qrCodeBytes;
 exports.escPosQrCode = escPosQrCode;
 exports.escPosQrRaster = escPosQrRaster;
-exports.qrRasterPunkte = qrRasterPunkte;
-exports.rasterZeilenBytes = rasterZeilenBytes;
-exports.rasterZeilenBase64 = rasterZeilenBase64;
-exports.escPosRasterBild = escPosRasterBild;
+exports.qrRasterDots = qrRasterDots;
+exports.rasterRowsBytes = rasterRowsBytes;
+exports.rasterRowsBase64 = rasterRowsBase64;
+exports.escPosRasterImage = escPosRasterImage;
 const qr_groesse_js_1 = require("./qr-groesse.js");
 // -------------------------------------------------------------- Befehlsbytes
 // Wortwoertlich aus commands.dart. Die Zahlen sind ASCII-Codes der dortigen
@@ -251,8 +251,8 @@ function createEscPosDocument(options = {}) {
         globalFont: null,
         maxCharsPerLine: null,
         styles: vollstaendigeStile(),
-        qrFehler: null,
-        qrAusweich: null,
+        qrError: null,
+        qrFallback: null,
     };
 }
 /** Die bisher erzeugten Bytes als Kopie. */
@@ -270,8 +270,8 @@ function escPosReset(doc) {
     doc.styles = vollstaendigeStile();
     // Wie `PrintPaper.reset()` im Flutter-Zwilling: ein neu begonnener Beleg
     // erbt die QR-Meldungen des vorigen nicht.
-    doc.qrFehler = null;
-    doc.qrAusweich = null;
+    doc.qrError = null;
+    doc.qrFallback = null;
     escPosSetGlobalCodeTable(doc, doc.globalCodeTable);
     escPosSetGlobalFont(doc, doc.globalFont);
 }
@@ -334,7 +334,7 @@ function escPosSetGlobalFont(doc, font, options = {}) {
  * geaendert haben. Fehlende Felder in [styles] gelten als Vorgabe: wer fett
  * weglaesst, schaltet fett also ab.
  *
- * `zeilenanfang` (Vorgabe `true`) sagt, ob dieser Aufruf am Anfang einer
+ * `atLineStart` (Vorgabe `true`) sagt, ob dieser Aufruf am Anfang einer
  * Druckzeile steht. Nur dort nimmt der Drucker `ESC a` (Ausrichtung)
  * ueberhaupt an; mitten in der Zeile verwirft er den Befehl wortlos. Der
  * Bytestrom bekommt ihn trotzdem -- die Bytefolge soll sich dadurch nicht
@@ -342,10 +342,10 @@ function escPosSetGlobalFont(doc, font, options = {}) {
  * Wert stellen: sonst haelt eine spaetere, echte Zeile die Ausrichtung
  * faelschlich schon fuer gesetzt und unterlaesst den Befehl.
  */
-function escPosSetStyles(doc, styles = {}, optionen = {}) {
+function escPosSetStyles(doc, styles = {}, options = {}) {
     const neu = vollstaendigeStile(styles);
     const alt = doc.styles;
-    const zeilenanfang = optionen.zeilenanfang ?? true;
+    const zeilenanfang = options.atLineStart ?? true;
     if (neu.align !== alt.align) {
         anhaengen(doc, neu.align === 'left' ? C_ALIGN_LEFT : neu.align === 'center' ? C_ALIGN_CENTER : C_ALIGN_RIGHT);
         if (zeilenanfang)
@@ -396,7 +396,7 @@ function escPosSetStyles(doc, styles = {}, optionen = {}) {
  * sonst kaeme die Zeile nie voran. Ein Bondrucker bricht sonst hart mitten
  * im Wort ("Kleinunter|nehmer", "0,7|9"); das soll nie aufs Papier.
  */
-function escPosWortzeilen(textBytes, max) {
+function escPosWrapLines(textBytes, max) {
     const grenze = Math.max(1, Math.floor(max));
     const out = [];
     let rest = textBytes;
@@ -460,7 +460,7 @@ function verketten(teile) {
  * - ein ueberlanges Wort bricht nach einem Bindestrich, wenn es einen hat
  *   ("Bio-" / "Dinkelvollkornsemmel"), sonst hart.
  */
-function wortzeilenText(text, max) {
+function wrapText(text, max) {
     const grenze = Math.max(1, Math.floor(max));
     const out = [];
     let rest = text;
@@ -512,7 +512,7 @@ function textIntern(doc, textBytes, optionen = {}) {
     const stileFuerDrucker = colInd === 0 && !volleZeile ? { ...optionen.styles, align: 'left' } : optionen.styles;
     // Ausrichtung vor Position -- `ESC a` gilt nur am Zeilenanfang, nach `ESC $`
     // verwirft der Drucker ihn. Zwilling von `_text` in generator.dart.
-    escPosSetStyles(doc, stileFuerDrucker, { zeilenanfang: colInd === 0 });
+    escPosSetStyles(doc, stileFuerDrucker, { atLineStart: colInd === 0 });
     // Eine volle Zeile beginnt am linken Rand; ein Positionsbefehl dafuer waere
     // nicht nur ueberfluessig, er entwertet die Ausrichtung.
     if (!volleZeile) {
@@ -548,7 +548,7 @@ function escPosText(doc, text, options = {}) {
     // selbst wuerde hart mitten im Wort umbrechen.
     const stile = vollstaendigeStile(options.styles);
     const zeichenJeZeile = Math.max(1, Math.floor(zeichenProZeile(doc, stile) / (stile.width === 2 ? 2 : 1)));
-    const zeilen = escPosWortzeilen(encodeEscPosText(text, doc.globalCodeTable ?? 'CP1252'), zeichenJeZeile);
+    const zeilen = escPosWrapLines(encodeEscPosText(text, doc.globalCodeTable ?? 'CP1252'), zeichenJeZeile);
     zeilen.forEach((z, i) => {
         textIntern(doc, z, { styles: options.styles });
         if (i < zeilen.length - 1)
@@ -639,7 +639,7 @@ function escPosRow(doc, columns) {
             if (zuDrucken.length > maxZeichen) {
                 // Wortweise: erste Zeile bis zum letzten Leerzeichen innerhalb der
                 // Spalte, der Rest (ohne fuehrende Leerzeichen) in die Folgezeile.
-                const [erste, ...weitere] = escPosWortzeilen(zuDrucken, maxZeichen);
+                const [erste, ...weitere] = escPosWrapLines(zuDrucken, maxZeichen);
                 const rest = weitere.length ? verketten(weitere) : new Uint8Array(0);
                 folge.textEncoded = rest;
                 zuDrucken = erste;
@@ -672,7 +672,7 @@ function escPosRow(doc, columns) {
  * 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
+ * (`qrModuleCount`), 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.
@@ -700,7 +700,7 @@ function qrCodeBytes(text, options = {}) {
     // Befehl erkannt hat. Der Befehl geht deshalb nur hinaus, wenn er
     // ausdruecklich verlangt ist; ein aufgedraengtes "Modell 2 fuer alle" waere
     // eine stille Umstellung an jedem Bestandsgeraet.
-    if (options.modell1 === true) {
+    if (options.model1 === true) {
         bytes.push(...C_QR_HEADER, 0x04, 0x00, 0x31, 0x41, 0x31, 0x00);
     }
     // Funktion 167: Modulgroesse
@@ -740,31 +740,31 @@ function escPosQrCode(doc, text, options = {}) {
     const qrOptionen = {};
     if (options.correction !== undefined)
         qrOptionen.correction = options.correction;
-    if (options.modell1 !== undefined)
-        qrOptionen.modell1 = options.modell1;
+    if (options.model1 !== undefined)
+        qrOptionen.model1 = options.model1;
     let drucken = true;
     if (options.size !== undefined) {
         qrOptionen.size = options.size;
     }
     else if (text !== '') {
-        const mass = (0, qr_groesse_js_1.qrGroesseFuer)({
-            nutzlast: text,
-            papierbreitePunkte: qr_groesse_js_1.QR_DRUCK_PUNKTE[doc.paperSize],
-            groesse: options.groesse ?? 'auto',
+        const mass = (0, qr_groesse_js_1.qrSizingFor)({
+            payload: text,
+            paperWidthDots: qr_groesse_js_1.QR_PRINT_WIDTH_DOTS[doc.paperSize],
+            moduleSize: options.moduleSize ?? 'auto',
         });
-        if (!mass.passt) {
-            doc.qrFehler =
-                `QR mit ${mass.module} Modulen ist fuer ${PAPIER_MM[doc.paperSize]} mm ` +
-                    `(${qr_groesse_js_1.QR_DRUCK_PUNKTE[doc.paperSize]} Punkte) zu breit`;
+        if (!mass.fits) {
+            doc.qrError =
+                `QR mit ${mass.modules} Modulen ist fuer ${PAPIER_MM[doc.paperSize]} mm ` +
+                    `(${qr_groesse_js_1.QR_PRINT_WIDTH_DOTS[doc.paperSize]} Punkte) zu breit`;
             drucken = false;
         }
         else {
-            if (mass.unterMindestmass) {
-                doc.qrAusweich =
-                    `QR mit ${mass.module} Modulen passt nur mit ${String(mass.punkte)} Punkten ` +
-                        `je Modul — unter dem Mindestmass von ${qr_groesse_js_1.QR_MINDEST_PUNKTE}`;
+            if (mass.belowMinimum) {
+                doc.qrFallback =
+                    `QR mit ${mass.modules} Modulen passt nur mit ${String(mass.moduleDots)} Punkten ` +
+                        `je Modul — unter dem Mindestmass von ${qr_groesse_js_1.QR_MIN_MODULE_DOTS}`;
             }
-            qrOptionen.size = mass.punkte;
+            qrOptionen.size = mass.moduleDots;
         }
     }
     if (drucken)
@@ -789,15 +789,15 @@ function escPosQrRaster(doc, matrix, options = {}) {
         if (zeile.length !== module)
             throw new Error('QR-Raster ist nicht quadratisch');
     }
-    const ruhezone = options.ruhezoneModule ?? qr_groesse_js_1.QR_RUHEZONE_MODULE;
+    const ruhezone = options.quietZoneModules ?? qr_groesse_js_1.QR_QUIET_ZONE_MODULES;
     if (!istGanzzahl(ruhezone) || ruhezone < 0) {
         throw new Error('ruhezoneModule muss eine Ganzzahl >= 0 sein');
     }
     const gesamtModule = module + 2 * ruhezone;
-    let punkte = options.punkteJeModul;
+    let punkte = options.dotsPerModule;
     if (punkte === undefined) {
-        const deckel = qr_groesse_js_1.QR_MODUL_DECKEL[options.groesse ?? 'auto'];
-        punkte = Math.max(1, Math.min(deckel, Math.floor(qr_groesse_js_1.QR_DRUCK_PUNKTE[doc.paperSize] / gesamtModule)));
+        const deckel = qr_groesse_js_1.QR_MODULE_SIZE_CAP[options.moduleSize ?? 'auto'];
+        punkte = Math.max(1, Math.min(deckel, Math.floor(qr_groesse_js_1.QR_PRINT_WIDTH_DOTS[doc.paperSize] / gesamtModule)));
     }
     if (!istGanzzahl(punkte) || punkte < 1) {
         throw new Error('punkteJeModul muss eine Ganzzahl >= 1 sein');
@@ -820,7 +820,7 @@ function escPosQrRaster(doc, matrix, options = {}) {
             bildpunkte[y * breite + x] = 1;
         }
     }
-    const daten = rasterZeilenBytes({ breite, hoehe: breite, punkte: bildpunkte });
+    const daten = rasterRowsBytes({ width: breite, height: breite, dots: 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, rasterBildKopf(breite, breite));
@@ -832,23 +832,23 @@ function escPosQrRaster(doc, matrix, options = {}) {
  * dieses Papier bringt — dieselbe Rechnung, nur ohne Untergrenze 3: ein Bild
  * darf bis auf einen Punkt je Modul schrumpfen und passt darum immer.
  */
-function qrRasterPunkte(paperSize, moduleAnzahl, options = {}) {
-    const ruhezone = options.ruhezoneModule ?? qr_groesse_js_1.QR_RUHEZONE_MODULE;
-    const deckel = qr_groesse_js_1.QR_MODUL_DECKEL[options.groesse ?? 'auto'];
-    return Math.max(1, Math.min(deckel, Math.floor(qr_groesse_js_1.QR_DRUCK_PUNKTE[paperSize] / (moduleAnzahl + 2 * ruhezone))));
+function qrRasterDots(paperSize, moduleCount, options = {}) {
+    const ruhezone = options.quietZoneModules ?? qr_groesse_js_1.QR_QUIET_ZONE_MODULES;
+    const deckel = qr_groesse_js_1.QR_MODULE_SIZE_CAP[options.moduleSize ?? 'auto'];
+    return Math.max(1, Math.min(deckel, Math.floor(qr_groesse_js_1.QR_PRINT_WIDTH_DOTS[paperSize] / (moduleCount + 2 * ruhezone))));
 }
 /** Die Rasterzeilen als Bytes: MSB zuerst, jede Zeile auf volle Bytes aufgefuellt. */
-function rasterZeilenBytes(bild) {
-    if (!istGanzzahl(bild.breite) || bild.breite < 1 || !istGanzzahl(bild.hoehe) || bild.hoehe < 1) {
+function rasterRowsBytes(image) {
+    if (!istGanzzahl(image.width) || image.width < 1 || !istGanzzahl(image.height) || image.height < 1) {
         throw new Error('Rasterbild ohne gueltiges Mass');
     }
-    if (bild.punkte.length !== bild.breite * bild.hoehe)
+    if (image.dots.length !== image.width * image.height)
         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)
+    const byteJeZeile = Math.ceil(image.width / 8);
+    const daten = new Uint8Array(byteJeZeile * image.height);
+    for (let y = 0; y < image.height; y++) {
+        for (let x = 0; x < image.width; x++) {
+            if (image.dots[y * image.width + x] !== 1)
                 continue;
             const i = y * byteJeZeile + (x >> 3);
             daten[i] = daten[i] | (0x80 >> (x & 7));
@@ -860,8 +860,8 @@ function rasterZeilenBytes(bild) {
  * Die Rasterzeilen als Base64 -- ohne Buffer, laeuft im Browser und in Node.
  * Eine Stelle fuer ePOS-`<image>` und den Druckjob an den Server.
  */
-function rasterZeilenBase64(bild) {
-    const bytes = rasterZeilenBytes(bild);
+function rasterRowsBase64(image) {
+    const bytes = rasterRowsBytes(image);
     let binaer = '';
     for (let i = 0; i < bytes.length; i += 0x8000) {
         binaer += String.fromCharCode(...bytes.subarray(i, i + 0x8000));
@@ -870,7 +870,7 @@ function rasterZeilenBase64(bild) {
 }
 /**
  * Der `GS v 0`-Kopf (Byte-Breite, Zeilenhoehe) -- die Rasterzeilen selbst
- * haengt der Aufrufer an. Gemeinsame Rahmung fuer das Logo (`escPosRasterBild`)
+ * haengt der Aufrufer an. Gemeinsame Rahmung fuer das Logo (`escPosRasterImage`)
  * und den QR-Bildweg (`escPosQrRaster`): beide drucken dasselbe Bildkommando,
  * nur mit unterschiedlichem Nachlauf (Zeilenvorschub ja/nein).
  */
@@ -885,17 +885,17 @@ function rasterBildKopf(breite, hoehe) {
  * Papier um die Bildhoehe, ein LF danach waere eine zusaetzliche Leerzeile,
  * die Bildschirm und PDF nicht haben. Die Luft um das Logo kommt aus dem Blatt.
  */
-function escPosRasterBild(doc, bild, options = {}) {
+function escPosRasterImage(doc, image, options = {}) {
     // Masse pruefen, BEVOR gepackt wird: ein zu breites Bild soll nicht erst
     // Speicher fuer seine Rasterzeilen belegen. `GS v 0` traegt die Hoehe in zwei
     // Bytes (yL yH) -- ueber 65535 Punkte liefe sie still ueber und der Drucker
     // laese den Rest des Bilds als Befehle.
-    if (bild.breite > qr_groesse_js_1.QR_DRUCK_PUNKTE[doc.paperSize])
+    if (image.width > qr_groesse_js_1.QR_PRINT_WIDTH_DOTS[doc.paperSize])
         throw new Error('Rasterbild breiter als der Druckkopf');
-    if (bild.hoehe > 0xffff)
+    if (image.height > 0xffff)
         throw new Error('Rasterbild hoeher als 65535 Punkte');
-    const daten = rasterZeilenBytes(bild);
+    const daten = rasterRowsBytes(image);
     escPosSetStyles(doc, { align: options.align ?? 'center' });
-    anhaengen(doc, rasterBildKopf(bild.breite, bild.hoehe));
+    anhaengen(doc, rasterBildKopf(image.width, image.height));
     anhaengen(doc, daten);
 }

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

@@ -1,4 +1,4 @@
-export { type PosPaperSize, type PosAlign, type PosFont, type PosCutMode, type PosCodeTable, type PosTextSize, type QrSize, type QrCorrection, type QrMatrix, type PosStyles, type PosColumn, type EscPosOptions, type EscPosTextOptions, type EscPosHrOptions, type EscPosQrOptions, type EscPosQrRasterOptions, type EscPosDocument, createEscPosDocument, escPosBytes, escPosReset, escPosSetGlobalCodeTable, escPosSetGlobalFont, escPosSetStyles, escPosText, escPosEmptyLines, escPosFeed, escPosCut, escPosHr, escPosRow, escPosQrCode, escPosQrRaster, qrRasterPunkte, 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 { 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, qrRasterDots, type RasterImage, rasterRowsBytes, rasterRowsBase64, escPosRasterImage, encodeEscPosText, qrCodeBytes, escPosMaxCharsPerLine, escPosWrapLines, wrapText, } from './escpos.js';
+export { type QrModuleSize, type QrSizing, QR_MODULE_SIZE_CAP, QR_QUIET_ZONE_MODULES, QR_MIN_MODULE_DOTS, QR_EXCEPTION_MODULE_DOTS, QR_MAX_MODULE_DOTS, QR_PRINT_WIDTH_DOTS, qrModuleCount, qrFitsInVersion, computeQrSizing, qrSizingFor, } from './qr-groesse.js';
 export { escPosPrintableText } from './printable.js';
 export { type UsbEndpointLike, type UsbAlternateLike, type UsbInterfaceLike, type UsbConfigurationLike, type UsbTransferOutResultLike, type UsbWriterLike, type UsbIdentityLike, type UsbDeviceLike, type UsbPrinterEndpoint, type UsbPrinterConnection, USB_VENDOR_EPSON, USB_CLASS_PRINTER, UsbTimeoutError, usbDeviceKey, usbFindPrinterEndpoint, usbWriteAll, usbConnectPrinter, usbPrint, usbDisconnect, } from './webusb.js';

package/dist/cjs/printing/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.usbDisconnect = exports.usbPrint = exports.usbConnectPrinter = exports.usbWriteAll = exports.usbFindPrinterEndpoint = exports.usbDeviceKey = exports.UsbTimeoutError = exports.USB_CLASS_PRINTER = exports.USB_VENDOR_EPSON = exports.escPosPrintableText = exports.qrGroesseFuer = exports.qrGroesseBerechnen = exports.qrPasstInVersion = exports.qrModulAnzahl = exports.QR_DRUCK_PUNKTE = exports.QR_HOECHST_PUNKTE = exports.QR_AUSNAHME_PUNKTE = exports.QR_MINDEST_PUNKTE = exports.QR_RUHEZONE_MODULE = exports.QR_MODUL_DECKEL = exports.wortzeilenText = exports.escPosWortzeilen = exports.escPosMaxCharsPerLine = exports.qrCodeBytes = exports.encodeEscPosText = exports.escPosRasterBild = exports.rasterZeilenBase64 = exports.rasterZeilenBytes = exports.qrRasterPunkte = exports.escPosQrRaster = exports.escPosQrCode = exports.escPosRow = exports.escPosHr = exports.escPosCut = exports.escPosFeed = exports.escPosEmptyLines = exports.escPosText = exports.escPosSetStyles = exports.escPosSetGlobalFont = exports.escPosSetGlobalCodeTable = exports.escPosReset = exports.escPosBytes = exports.createEscPosDocument = void 0;
+exports.usbDisconnect = exports.usbPrint = exports.usbConnectPrinter = exports.usbWriteAll = exports.usbFindPrinterEndpoint = exports.usbDeviceKey = exports.UsbTimeoutError = exports.USB_CLASS_PRINTER = exports.USB_VENDOR_EPSON = exports.escPosPrintableText = exports.qrSizingFor = exports.computeQrSizing = exports.qrFitsInVersion = exports.qrModuleCount = exports.QR_PRINT_WIDTH_DOTS = exports.QR_MAX_MODULE_DOTS = exports.QR_EXCEPTION_MODULE_DOTS = exports.QR_MIN_MODULE_DOTS = exports.QR_QUIET_ZONE_MODULES = exports.QR_MODULE_SIZE_CAP = exports.wrapText = exports.escPosWrapLines = exports.escPosMaxCharsPerLine = exports.qrCodeBytes = exports.encodeEscPosText = exports.escPosRasterImage = exports.rasterRowsBase64 = exports.rasterRowsBytes = exports.qrRasterDots = exports.escPosQrRaster = exports.escPosQrCode = exports.escPosRow = exports.escPosHr = exports.escPosCut = exports.escPosFeed = exports.escPosEmptyLines = exports.escPosText = exports.escPosSetStyles = exports.escPosSetGlobalFont = exports.escPosSetGlobalCodeTable = exports.escPosReset = exports.escPosBytes = exports.createEscPosDocument = void 0;
 var escpos_js_1 = require("./escpos.js");
 Object.defineProperty(exports, "createEscPosDocument", { enumerable: true, get: function () { return escpos_js_1.createEscPosDocument; } });
 Object.defineProperty(exports, "escPosBytes", { enumerable: true, get: function () { return escpos_js_1.escPosBytes; } });
@@ -16,26 +16,26 @@ Object.defineProperty(exports, "escPosHr", { enumerable: true, get: function ()
 Object.defineProperty(exports, "escPosRow", { enumerable: true, get: function () { return escpos_js_1.escPosRow; } });
 Object.defineProperty(exports, "escPosQrCode", { enumerable: true, get: function () { return escpos_js_1.escPosQrCode; } });
 Object.defineProperty(exports, "escPosQrRaster", { enumerable: true, get: function () { return escpos_js_1.escPosQrRaster; } });
-Object.defineProperty(exports, "qrRasterPunkte", { enumerable: true, get: function () { return escpos_js_1.qrRasterPunkte; } });
-Object.defineProperty(exports, "rasterZeilenBytes", { enumerable: true, get: function () { return escpos_js_1.rasterZeilenBytes; } });
-Object.defineProperty(exports, "rasterZeilenBase64", { enumerable: true, get: function () { return escpos_js_1.rasterZeilenBase64; } });
-Object.defineProperty(exports, "escPosRasterBild", { enumerable: true, get: function () { return escpos_js_1.escPosRasterBild; } });
+Object.defineProperty(exports, "qrRasterDots", { enumerable: true, get: function () { return escpos_js_1.qrRasterDots; } });
+Object.defineProperty(exports, "rasterRowsBytes", { enumerable: true, get: function () { return escpos_js_1.rasterRowsBytes; } });
+Object.defineProperty(exports, "rasterRowsBase64", { enumerable: true, get: function () { return escpos_js_1.rasterRowsBase64; } });
+Object.defineProperty(exports, "escPosRasterImage", { enumerable: true, get: function () { return escpos_js_1.escPosRasterImage; } });
 Object.defineProperty(exports, "encodeEscPosText", { enumerable: true, get: function () { return escpos_js_1.encodeEscPosText; } });
 Object.defineProperty(exports, "qrCodeBytes", { enumerable: true, get: function () { return escpos_js_1.qrCodeBytes; } });
 Object.defineProperty(exports, "escPosMaxCharsPerLine", { enumerable: true, get: function () { return escpos_js_1.escPosMaxCharsPerLine; } });
-Object.defineProperty(exports, "escPosWortzeilen", { enumerable: true, get: function () { return escpos_js_1.escPosWortzeilen; } });
-Object.defineProperty(exports, "wortzeilenText", { enumerable: true, get: function () { return escpos_js_1.wortzeilenText; } });
+Object.defineProperty(exports, "escPosWrapLines", { enumerable: true, get: function () { return escpos_js_1.escPosWrapLines; } });
+Object.defineProperty(exports, "wrapText", { enumerable: true, get: function () { return escpos_js_1.wrapText; } });
 var qr_groesse_js_1 = require("./qr-groesse.js");
-Object.defineProperty(exports, "QR_MODUL_DECKEL", { enumerable: true, get: function () { return qr_groesse_js_1.QR_MODUL_DECKEL; } });
-Object.defineProperty(exports, "QR_RUHEZONE_MODULE", { enumerable: true, get: function () { return qr_groesse_js_1.QR_RUHEZONE_MODULE; } });
-Object.defineProperty(exports, "QR_MINDEST_PUNKTE", { enumerable: true, get: function () { return qr_groesse_js_1.QR_MINDEST_PUNKTE; } });
-Object.defineProperty(exports, "QR_AUSNAHME_PUNKTE", { enumerable: true, get: function () { return qr_groesse_js_1.QR_AUSNAHME_PUNKTE; } });
-Object.defineProperty(exports, "QR_HOECHST_PUNKTE", { enumerable: true, get: function () { return qr_groesse_js_1.QR_HOECHST_PUNKTE; } });
-Object.defineProperty(exports, "QR_DRUCK_PUNKTE", { enumerable: true, get: function () { return qr_groesse_js_1.QR_DRUCK_PUNKTE; } });
-Object.defineProperty(exports, "qrModulAnzahl", { enumerable: true, get: function () { return qr_groesse_js_1.qrModulAnzahl; } });
-Object.defineProperty(exports, "qrPasstInVersion", { enumerable: true, get: function () { return qr_groesse_js_1.qrPasstInVersion; } });
-Object.defineProperty(exports, "qrGroesseBerechnen", { enumerable: true, get: function () { return qr_groesse_js_1.qrGroesseBerechnen; } });
-Object.defineProperty(exports, "qrGroesseFuer", { enumerable: true, get: function () { return qr_groesse_js_1.qrGroesseFuer; } });
+Object.defineProperty(exports, "QR_MODULE_SIZE_CAP", { enumerable: true, get: function () { return qr_groesse_js_1.QR_MODULE_SIZE_CAP; } });
+Object.defineProperty(exports, "QR_QUIET_ZONE_MODULES", { enumerable: true, get: function () { return qr_groesse_js_1.QR_QUIET_ZONE_MODULES; } });
+Object.defineProperty(exports, "QR_MIN_MODULE_DOTS", { enumerable: true, get: function () { return qr_groesse_js_1.QR_MIN_MODULE_DOTS; } });
+Object.defineProperty(exports, "QR_EXCEPTION_MODULE_DOTS", { enumerable: true, get: function () { return qr_groesse_js_1.QR_EXCEPTION_MODULE_DOTS; } });
+Object.defineProperty(exports, "QR_MAX_MODULE_DOTS", { enumerable: true, get: function () { return qr_groesse_js_1.QR_MAX_MODULE_DOTS; } });
+Object.defineProperty(exports, "QR_PRINT_WIDTH_DOTS", { enumerable: true, get: function () { return qr_groesse_js_1.QR_PRINT_WIDTH_DOTS; } });
+Object.defineProperty(exports, "qrModuleCount", { enumerable: true, get: function () { return qr_groesse_js_1.qrModuleCount; } });
+Object.defineProperty(exports, "qrFitsInVersion", { enumerable: true, get: function () { return qr_groesse_js_1.qrFitsInVersion; } });
+Object.defineProperty(exports, "computeQrSizing", { enumerable: true, get: function () { return qr_groesse_js_1.computeQrSizing; } });
+Object.defineProperty(exports, "qrSizingFor", { enumerable: true, get: function () { return qr_groesse_js_1.qrSizingFor; } });
 var printable_js_1 = require("./printable.js");
 Object.defineProperty(exports, "escPosPrintableText", { enumerable: true, get: function () { return printable_js_1.escPosPrintableText; } });
 var webusb_js_1 = require("./webusb.js");