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

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

@@ -23,46 +23,46 @@ import type { PosPaperSize, QrSize } from './escpos.js';
  * alten Wert des nativen ESC/POS-Wegs), in Dart bei 6; derselbe Beleg kam
  * dadurch je nach Paket verschieden gross aus dem Drucker. Einheitlich gilt
  * jetzt 6: der Wert von Dart und vom Epson-Weg, und ein groesseres Modul
- * liest sich besser. `klein` (4) druckt den QR so gross wie frueher `auto`;
- * `mittel` (6) und `gross` (8) waehlt ein Mensch.
+ * liest sich besser. `small` (4) druckt den QR so gross wie frueher `auto`;
+ * `medium` (6) und `large` (8) waehlt ein Mensch.
  */
-export type QrModulGroesse = 'auto' | 'klein' | 'mittel' | 'gross';
+export type QrModuleSize = 'auto' | 'small' | 'medium' | 'large';
 /** Groesste Modulgroesse in Druckpunkten, die der jeweilige Deckel zulaesst. */
-export declare const QR_MODUL_DECKEL: Readonly<Record<QrModulGroesse, number>>;
+export declare const QR_MODULE_SIZE_CAP: Readonly<Record<QrModuleSize, number>>;
 /**
  * Ergebnis der Modulgroessen-Rechnung.
  *
- * Traegt bewusst mehr als die Zahl: ob ueberhaupt etwas passt (`passt`), ob
- * nur unter der Mindestgroesse (`unterMindestmass`) und wie breit das Symbol
- * wird (`breitePunkte`). Eine blosse Zahl haette die Ausnahme verschwiegen.
+ * Traegt bewusst mehr als die Zahl: ob ueberhaupt etwas passt (`fits`), ob
+ * nur unter der Mindestgroesse (`belowMinimum`) und wie breit das Symbol
+ * wird (`widthDots`). Eine blosse Zahl haette die Ausnahme verschwiegen.
  */
-export interface QrGroesse {
+export interface QrSizing {
     /**
      * Modulgroesse in Druckpunkten, `null` wenn das Symbol auch mit der
      * Ausnahmegroesse nicht aufs Papier passt.
      */
-    readonly punkte: QrSize | null;
+    readonly moduleDots: QrSize | null;
     /** Modulanzahl des Symbols (ohne Ruhezone). */
-    readonly module: number;
+    readonly modules: number;
     /** Gesamtbreite inklusive Ruhezone in Druckpunkten; 0, wenn nichts passt. */
-    readonly breitePunkte: number;
+    readonly widthDots: number;
     /**
-     * Gedruckt wird unter `QR_MINDEST_PUNKTE`. Erlaubt, aber eine Ausnahme, von
+     * Gedruckt wird unter `QR_MIN_MODULE_DOTS`. Erlaubt, aber eine Ausnahme, von
      * der der Aufrufer erfahren muss — billige Thermodrucker und Handykameras
      * tun sich damit schwer, besonders auf gewelltem Papier.
      */
-    readonly unterMindestmass: boolean;
+    readonly belowMinimum: boolean;
     /** Kurz fuer `punkte !== null`. */
-    readonly passt: boolean;
+    readonly fits: boolean;
 }
 /** Ruhezone je Seite, in Modulen (QR-Norm). */
-export declare const QR_RUHEZONE_MODULE = 4;
+export declare const QR_QUIET_ZONE_MODULES = 4;
 /** Untergrenze: 4 Punkte sind bei 203 dpi rund 0,5 mm je Modul. */
-export declare const QR_MINDEST_PUNKTE = 4;
-/** Ausnahme, wenn `QR_MINDEST_PUNKTE` nicht passt — gemeldet, nicht still. */
-export declare const QR_AUSNAHME_PUNKTE = 3;
+export declare const QR_MIN_MODULE_DOTS = 4;
+/** Ausnahme, wenn `QR_MIN_MODULE_DOTS` nicht passt – gemeldet, nicht still. */
+export declare const QR_EXCEPTION_MODULE_DOTS = 3;
 /** Obergrenze des Druckbefehls in diesem Stack (`GS ( k` Funktion 167: 1..8). */
-export declare const QR_HOECHST_PUNKTE = 8;
+export declare const QR_MAX_MODULE_DOTS = 8;
 /**
  * Druckbreite des Kopfes in Punkten (203 dpi): 58 mm = 384, 80 mm = 576 —
  * Zwilling von `KeckPaperSize.druckPunkte`.
@@ -73,9 +73,9 @@ export declare const QR_HOECHST_PUNKTE = 8;
  * die echte Kopfbreite — ein QR, der auch nur einen Punkt zu breit ist, wird
  * von den meisten Geraeten gar nicht gedruckt.
  */
-export declare const QR_DRUCK_PUNKTE: Readonly<Record<PosPaperSize, number>>;
+export declare const QR_PRINT_WIDTH_DOTS: Readonly<Record<PosPaperSize, number>>;
 /**
- * Modulanzahl, die `nutzlast` bei Fehlerkorrektur **M** braucht.
+ * Modulanzahl, die `payload` bei Fehlerkorrektur **M** braucht.
  *
  * Alle Druckwege setzen den QR mit Fehlerkorrektur **M** (nativer
  * ESC/POS-Befehl, ePOS `level_m`; das Raster fuer den Bildweg rechnet der
@@ -90,38 +90,38 @@ export declare const QR_DRUCK_PUNKTE: Readonly<Record<PosPaperSize, number>>;
  * langem Inhalt. Ein still zurueckgegebenes "passt nicht" haette den
  * Datenfehler als Papierfehler getarnt.
  */
-export declare function qrModulAnzahl(nutzlast: string): number;
+export declare function qrModuleCount(payload: string): number;
 /**
- * Ob `nutzlast` in irgendeine QR-Version 1..40 bei Fehlerkorrektur M passt --
- * dieselbe Tabelle wie `qrModulAnzahl`, aber ohne zu werfen.
+ * Ob `payload` in irgendeine QR-Version 1..40 bei Fehlerkorrektur M passt --
+ * dieselbe Tabelle wie `qrModuleCount`, aber ohne zu werfen.
  *
  * Fuer Aufrufer, denen ein zu langer Inhalt kein Programmierfehler ist,
  * sondern ein Datenfehler, den sie selbst behandeln (das Beleg-Blatt: ohne
  * QR weiterbauen statt den ganzen Zeichner mitzureissen).
  */
-export declare function qrPasstInVersion(nutzlast: string): boolean;
+export declare function qrFitsInVersion(payload: string): boolean;
 /**
- * Groesste Modulgroesse, mit der `moduleAnzahl` Module **samt Ruhezone** in
- * `papierbreitePunkte` passen, gedeckelt durch `groesse`.
+ * Groesste Modulgroesse, mit der `moduleCount` Module **samt Ruhezone** in
+ * `paperWidthDots` passen, gedeckelt durch `moduleSize`.
  *
  * Wirft bei sinnlosen Eingaben: eine Papierbreite von 0 oder ein Symbol ohne
  * Module ist ein Programmierfehler, und ein still zurueckgegebenes "passt
  * nicht" haette ihn als Druckerproblem getarnt.
  */
-export declare function qrGroesseBerechnen(options: {
-    papierbreitePunkte: number;
-    moduleAnzahl: number;
-    groesse?: QrModulGroesse;
-}): QrGroesse;
+export declare function computeQrSizing(options: {
+    paperWidthDots: number;
+    moduleCount: number;
+    moduleSize?: QrModuleSize;
+}): QrSizing;
 /**
- * Wie `qrGroesseBerechnen`, nur mit der Modulanzahl aus `nutzlast`.
+ * Wie `computeQrSizing`, nur mit der Modulanzahl aus `payload`.
  *
  * Eine leere Nutzlast ergibt kein Symbol — sie "passt nicht", statt zu
  * werfen: der Aufrufer behandelt den Fall ohnehin schon (leerer QR am Beleg
  * ist ein Datenfehler, kein Papierfehler).
  */
-export declare function qrGroesseFuer(options: {
-    nutzlast: string;
-    papierbreitePunkte: number;
-    groesse?: QrModulGroesse;
-}): QrGroesse;
+export declare function qrSizingFor(options: {
+    payload: string;
+    paperWidthDots: number;
+    moduleSize?: QrModuleSize;
+}): QrSizing;

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

@@ -1,26 +1,26 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.QR_DRUCK_PUNKTE = exports.QR_HOECHST_PUNKTE = exports.QR_AUSNAHME_PUNKTE = exports.QR_MINDEST_PUNKTE = exports.QR_RUHEZONE_MODULE = exports.QR_MODUL_DECKEL = void 0;
-exports.qrModulAnzahl = qrModulAnzahl;
-exports.qrPasstInVersion = qrPasstInVersion;
-exports.qrGroesseBerechnen = qrGroesseBerechnen;
-exports.qrGroesseFuer = qrGroesseFuer;
+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 = void 0;
+exports.qrModuleCount = qrModuleCount;
+exports.qrFitsInVersion = qrFitsInVersion;
+exports.computeQrSizing = computeQrSizing;
+exports.qrSizingFor = qrSizingFor;
 /** Groesste Modulgroesse in Druckpunkten, die der jeweilige Deckel zulaesst. */
-exports.QR_MODUL_DECKEL = {
+exports.QR_MODULE_SIZE_CAP = {
     auto: 6,
-    klein: 4,
-    mittel: 6,
-    gross: 8,
+    small: 4,
+    medium: 6,
+    large: 8,
 };
 // --------------------------------------------------------------- Konstanten
 /** Ruhezone je Seite, in Modulen (QR-Norm). */
-exports.QR_RUHEZONE_MODULE = 4;
+exports.QR_QUIET_ZONE_MODULES = 4;
 /** Untergrenze: 4 Punkte sind bei 203 dpi rund 0,5 mm je Modul. */
-exports.QR_MINDEST_PUNKTE = 4;
-/** Ausnahme, wenn `QR_MINDEST_PUNKTE` nicht passt — gemeldet, nicht still. */
-exports.QR_AUSNAHME_PUNKTE = 3;
+exports.QR_MIN_MODULE_DOTS = 4;
+/** Ausnahme, wenn `QR_MIN_MODULE_DOTS` nicht passt – gemeldet, nicht still. */
+exports.QR_EXCEPTION_MODULE_DOTS = 3;
 /** Obergrenze des Druckbefehls in diesem Stack (`GS ( k` Funktion 167: 1..8). */
-exports.QR_HOECHST_PUNKTE = 8;
+exports.QR_MAX_MODULE_DOTS = 8;
 /**
  * Druckbreite des Kopfes in Punkten (203 dpi): 58 mm = 384, 80 mm = 576 —
  * Zwilling von `KeckPaperSize.druckPunkte`.
@@ -31,7 +31,7 @@ exports.QR_HOECHST_PUNKTE = 8;
  * die echte Kopfbreite — ein QR, der auch nur einen Punkt zu breit ist, wird
  * von den meisten Geraeten gar nicht gedruckt.
  */
-exports.QR_DRUCK_PUNKTE = { mm58: 384, mm80: 576 };
+exports.QR_PRINT_WIDTH_DOTS = { mm58: 384, mm80: 576 };
 /**
  * Nutzlast in Byte, die eine QR-Version 1..40 bei Fehlerkorrektur **M** im
  * Byte-Modus aufnimmt (ISO/IEC 18004, Tabelle 7).
@@ -48,7 +48,7 @@ const BYTE_KAPAZITAET_M = [
 ];
 // ------------------------------------------------------------- oeffentlich
 /**
- * Modulanzahl, die `nutzlast` bei Fehlerkorrektur **M** braucht.
+ * Modulanzahl, die `payload` bei Fehlerkorrektur **M** braucht.
  *
  * Alle Druckwege setzen den QR mit Fehlerkorrektur **M** (nativer
  * ESC/POS-Befehl, ePOS `level_m`; das Raster fuer den Bildweg rechnet der
@@ -63,8 +63,8 @@ const BYTE_KAPAZITAET_M = [
  * langem Inhalt. Ein still zurueckgegebenes "passt nicht" haette den
  * Datenfehler als Papierfehler getarnt.
  */
-function qrModulAnzahl(nutzlast) {
-    const laenge = new TextEncoder().encode(nutzlast).length;
+function qrModuleCount(payload) {
+    const laenge = new TextEncoder().encode(payload).length;
     for (let i = 0; i < BYTE_KAPAZITAET_M.length; i++) {
         if (laenge <= BYTE_KAPAZITAET_M[i])
             return 17 + 4 * (i + 1);
@@ -72,69 +72,69 @@ function qrModulAnzahl(nutzlast) {
     throw new Error('QR-Inhalt ist zu lang');
 }
 /**
- * Ob `nutzlast` in irgendeine QR-Version 1..40 bei Fehlerkorrektur M passt --
- * dieselbe Tabelle wie `qrModulAnzahl`, aber ohne zu werfen.
+ * Ob `payload` in irgendeine QR-Version 1..40 bei Fehlerkorrektur M passt --
+ * dieselbe Tabelle wie `qrModuleCount`, aber ohne zu werfen.
  *
  * Fuer Aufrufer, denen ein zu langer Inhalt kein Programmierfehler ist,
  * sondern ein Datenfehler, den sie selbst behandeln (das Beleg-Blatt: ohne
  * QR weiterbauen statt den ganzen Zeichner mitzureissen).
  */
-function qrPasstInVersion(nutzlast) {
-    const laenge = new TextEncoder().encode(nutzlast).length;
+function qrFitsInVersion(payload) {
+    const laenge = new TextEncoder().encode(payload).length;
     return laenge <= BYTE_KAPAZITAET_M[BYTE_KAPAZITAET_M.length - 1];
 }
 /**
- * Groesste Modulgroesse, mit der `moduleAnzahl` Module **samt Ruhezone** in
- * `papierbreitePunkte` passen, gedeckelt durch `groesse`.
+ * Groesste Modulgroesse, mit der `moduleCount` Module **samt Ruhezone** in
+ * `paperWidthDots` passen, gedeckelt durch `moduleSize`.
  *
  * Wirft bei sinnlosen Eingaben: eine Papierbreite von 0 oder ein Symbol ohne
  * Module ist ein Programmierfehler, und ein still zurueckgegebenes "passt
  * nicht" haette ihn als Druckerproblem getarnt.
  */
-function qrGroesseBerechnen(options) {
-    const { papierbreitePunkte, moduleAnzahl } = options;
-    const groesse = options.groesse ?? 'auto';
+function computeQrSizing(options) {
+    const { paperWidthDots: papierbreitePunkte, moduleCount: moduleAnzahl } = options;
+    const groesse = options.moduleSize ?? 'auto';
     if (!Number.isInteger(papierbreitePunkte) || papierbreitePunkte <= 0) {
         throw new Error('papierbreitePunkte muss eine Ganzzahl > 0 sein');
     }
     if (!Number.isInteger(moduleAnzahl) || moduleAnzahl <= 0) {
         throw new Error('moduleAnzahl muss eine Ganzzahl > 0 sein');
     }
-    const roh = exports.QR_MODUL_DECKEL[groesse];
+    const roh = exports.QR_MODULE_SIZE_CAP[groesse];
     if (roh === undefined) {
         throw new Error(`Unbekannte QR-Modulgroesse: ${String(groesse)}`);
     }
-    const gesamtModule = moduleAnzahl + exports.QR_RUHEZONE_MODULE * 2;
+    const gesamtModule = moduleAnzahl + exports.QR_QUIET_ZONE_MODULES * 2;
     const passend = Math.floor(papierbreitePunkte / gesamtModule);
-    if (passend < exports.QR_AUSNAHME_PUNKTE) {
-        return { punkte: null, module: moduleAnzahl, breitePunkte: 0, unterMindestmass: false, passt: false };
+    if (passend < exports.QR_EXCEPTION_MODULE_DOTS) {
+        return { moduleDots: null, modules: moduleAnzahl, widthDots: 0, belowMinimum: false, fits: false };
     }
-    const deckel = Math.min(Math.max(roh, exports.QR_AUSNAHME_PUNKTE), exports.QR_HOECHST_PUNKTE);
-    const punkte = passend < exports.QR_MINDEST_PUNKTE ? exports.QR_AUSNAHME_PUNKTE : Math.min(passend, deckel);
+    const deckel = Math.min(Math.max(roh, exports.QR_EXCEPTION_MODULE_DOTS), exports.QR_MAX_MODULE_DOTS);
+    const punkte = passend < exports.QR_MIN_MODULE_DOTS ? exports.QR_EXCEPTION_MODULE_DOTS : Math.min(passend, deckel);
     return {
-        punkte: punkte,
-        module: moduleAnzahl,
-        breitePunkte: gesamtModule * punkte,
-        unterMindestmass: punkte < exports.QR_MINDEST_PUNKTE,
-        passt: true,
+        moduleDots: punkte,
+        modules: moduleAnzahl,
+        widthDots: gesamtModule * punkte,
+        belowMinimum: punkte < exports.QR_MIN_MODULE_DOTS,
+        fits: true,
     };
 }
 /**
- * Wie `qrGroesseBerechnen`, nur mit der Modulanzahl aus `nutzlast`.
+ * Wie `computeQrSizing`, nur mit der Modulanzahl aus `payload`.
  *
  * Eine leere Nutzlast ergibt kein Symbol — sie "passt nicht", statt zu
  * werfen: der Aufrufer behandelt den Fall ohnehin schon (leerer QR am Beleg
  * ist ein Datenfehler, kein Papierfehler).
  */
-function qrGroesseFuer(options) {
-    if (options.nutzlast === '') {
-        return { punkte: null, module: 0, breitePunkte: 0, unterMindestmass: false, passt: false };
+function qrSizingFor(options) {
+    if (options.payload === '') {
+        return { moduleDots: null, modules: 0, widthDots: 0, belowMinimum: false, fits: false };
     }
     const weiter = {
-        papierbreitePunkte: options.papierbreitePunkte,
-        moduleAnzahl: qrModulAnzahl(options.nutzlast),
+        paperWidthDots: options.paperWidthDots,
+        moduleCount: qrModuleCount(options.payload),
     };
-    if (options.groesse !== undefined)
-        weiter.groesse = options.groesse;
-    return qrGroesseBerechnen(weiter);
+    if (options.moduleSize !== undefined)
+        weiter.moduleSize = options.moduleSize;
+    return computeQrSizing(weiter);
 }

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

@@ -87,9 +87,9 @@ export declare function usbFindPrinterEndpoint(d: {
  */
 export declare class UsbTimeoutError extends Error {
     readonly name = "UsbTimeoutError";
-    readonly schritt: string;
+    readonly step: string;
     readonly timeoutMs: number;
-    constructor(schritt: string, timeoutMs: number);
+    constructor(step: string, timeoutMs: number);
 }
 /**
  * Bytes blockweise an den OUT-Endpunkt; liefert die geschriebene Gesamtzahl,

package/dist/cjs/printing/webusb.js

@@ -56,11 +56,11 @@ function usbFindPrinterEndpoint(d) {
  */
 class UsbTimeoutError extends Error {
     name = 'UsbTimeoutError';
-    schritt;
+    step;
     timeoutMs;
-    constructor(schritt, timeoutMs) {
-        super(`USB-Drucker antwortet nicht (${schritt}, Zeitlimit ${timeoutMs} ms überschritten) — Kabel/Gerät prüfen.`);
-        this.schritt = schritt;
+    constructor(step, timeoutMs) {
+        super(`USB-Drucker antwortet nicht (${step}, Zeitlimit ${timeoutMs} ms überschritten) — Kabel/Gerät prüfen.`);
+        this.step = step;
         this.timeoutMs = timeoutMs;
     }
 }

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

@@ -1,7 +1,7 @@
 import { type ReactNode } from 'react';
 import type { ReceiptLayout } from '../receipt/layout.js';
-import { type BelegBlatt, type LogoStufe } from '../receipt/blatt.js';
-import type { QrModulGroesse } from '../printing/qr-groesse.js';
+import { type ReceiptSheet, type SheetLogoSize } from '../receipt/blatt.js';
+import type { QrModuleSize } from '../printing/qr-groesse.js';
 /**
  * React-Adapter: zeichnet ein Beleg-Layout (siehe ../receipt/layout.ts).
  *
@@ -31,69 +31,69 @@ export interface ReceiptLayoutViewProps {
      * Fuer Bildschirme, auf denen der Beleg nur zur Kontrolle steht -- der
      * Signatur-QR gehoert dem Kunden und wird erst auf Verlangen freigegeben.
      */
-    qrVerdeckt?: boolean;
+    qrHidden?: boolean;
     /** Text auf dem verdeckten QR (Vorgabe „Antippen zum Anzeigen“). */
-    qrVerdecktText?: string;
+    qrHiddenText?: string;
 }
 /**
- * @deprecated Seit 0.14.0: [BelegBlattView] setzt den Beleg zeichengleich zu
+ * @deprecated Seit 0.14.0: [ReceiptSheetView] setzt den Beleg zeichengleich zu
  * Bon und PDF (Raster, Logo, Marke). Diese Ansicht rechnet Spalten mit Flex
  * und bricht darum anders um als das Papier.
  */
-export declare function ReceiptLayoutView({ layout, className, renderQr, qrVerdeckt, qrVerdecktText }: ReceiptLayoutViewProps): ReactNode;
+export declare function ReceiptLayoutView({ layout, className, renderQr, qrHidden: qrVerdeckt, qrHiddenText: qrVerdecktText }: ReceiptLayoutViewProps): ReactNode;
 /**
  * Verdeckter QR: weichgezeichnet und nicht scannbar, bis der Betrachter ihn
  * antippt. Die Nutzlast bleibt trotzdem als `data-qr` am Element -- fuer Tests
  * und Werkzeuge, nicht fuers Auge.
  */
-export declare function QrVerdeckt({ data, text, children }: {
+export declare function HiddenQr({ data, text, children }: {
     data: string;
     text?: string;
     children: ReactNode;
 }): ReactNode;
-export interface BelegBlattZeilenProps {
-    blatt: BelegBlatt;
+export interface ReceiptSheetLinesProps {
+    sheet: ReceiptSheet;
     /** Adresse des Firmenlogos; ohne sie bleibt der Logo-Block leer (Platz bleibt). */
     logoUrl?: string;
     /**
-     * Zeichnet den QR in seinen Kasten (`qrBlattAnteil`). Der Kasten schliesst
+     * Zeichnet den QR in seinen Kasten (`qrSheetWidthFraction`). Der Kasten schliesst
      * die Ruhezone von 4 Modulen je Seite ein und setzt Fehlerkorrektur M
      * voraus: das Symbol also mit Korrektur M und 4 Modulen Ruhezone zeichnen
      * und den Kasten ganz ausfuellen -- dann ist ein Modul so gross wie am Bon.
      */
     renderQr?: (data: string) => ReactNode;
-    qrVerdeckt?: boolean;
-    qrVerdecktText?: string;
+    qrHidden?: boolean;
+    qrHiddenText?: string;
     className?: string;
 }
 /**
  * Das Blatt am Bildschirm -- Zeile fuer Zeile dieselben Zeichen wie am Bon und
  * im PDF. Masse in `ch`: eine Zeichenbreite ist `1ch`, eine Zeile `2ch`, das
- * Blatt `zeichen`ch breit. Der Verbraucher bestimmt nur Schrift (monospace,
+ * Blatt `charsPerLine`ch breit. Der Verbraucher bestimmt nur Schrift (monospace,
  * Vorgabe ueber `--keck-blatt-schrift`) und Schriftgroesse; alles andere steht
  * im Blatt.
  */
-export declare function BelegBlattZeilen({ blatt, logoUrl, renderQr, qrVerdeckt, qrVerdecktText, className }: BelegBlattZeilenProps): ReactNode;
-export interface BelegBlattViewProps extends Omit<BelegBlattZeilenProps, 'blatt' | 'logoUrl'> {
+export declare function ReceiptSheetLines({ sheet: blatt, logoUrl, renderQr, qrHidden: qrVerdeckt, qrHiddenText: qrVerdecktText, className }: ReceiptSheetLinesProps): ReactNode;
+export interface ReceiptSheetViewProps extends Omit<ReceiptSheetLinesProps, 'sheet' | 'logoUrl'> {
     layout: ReceiptLayout;
-    zeichen?: number;
+    charsPerLine?: number;
     /** Firmenlogo und Stufe (`logoSkala`); das Pixelmass liest die Ansicht selbst. */
     logo?: {
         url: string;
-        stufe: LogoStufe;
+        size: SheetLogoSize;
     } | null;
-    marke?: boolean;
+    brandMark?: boolean;
     /** Geraete-Einstellung fuer die QR-Modulgroesse; Vorgabe `auto` (hoechstens 6 Punkte je Modul) — wie die Druckwege. */
-    qrGroesse?: QrModulGroesse;
+    qrModuleSize?: QrModuleSize;
 }
 /**
  * Laedt das Logo (fuer sein Pixelmass), baut das Blatt und zeichnet es. Bis
  * das Bild geladen ist, fehlt der Logo-Block -- die Kasse laedt das Logo ohnehin
  * vorab in den Browser-Cache.
  *
- * Ein Logo ueber [logoPixelZulaessig] (4096x4096px, dieselbe Grenze wie das
+ * Ein Logo ueber [isLogoPixelSizeAllowed] (4096x4096px, dieselbe Grenze wie das
  * Druck-Kit beim Rastern fuer den Bon) bleibt hier ebenso ohne Logo-Block --
  * sonst zeigte der Bildschirm ein Logo, das nie gedruckt wird: Bildschirm und
  * Bon zeigen dasselbe Logo.
  */
-export declare function BelegBlattView({ layout, zeichen, logo, marke, qrGroesse, ...rest }: BelegBlattViewProps): ReactNode;
+export declare function ReceiptSheetView({ layout, charsPerLine: zeichen, logo, brandMark: marke, qrModuleSize: qrGroesse, ...rest }: ReceiptSheetViewProps): ReactNode;

package/dist/cjs/react/index.js

@@ -1,24 +1,34 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ReceiptLayoutView = ReceiptLayoutView;
-exports.QrVerdeckt = QrVerdeckt;
-exports.BelegBlattZeilen = BelegBlattZeilen;
-exports.BelegBlattView = BelegBlattView;
+exports.HiddenQr = HiddenQr;
+exports.ReceiptSheetLines = ReceiptSheetLines;
+exports.ReceiptSheetView = ReceiptSheetView;
 const jsx_runtime_1 = require("react/jsx-runtime");
 const react_1 = require("react");
 const blatt_js_1 = require("../receipt/blatt.js");
 const marke_daten_js_1 = require("../receipt/marke-daten.js");
+/**
+ * CSS-Klasse je Ton. Die Klassennamen bleiben die von 0.x
+ * (`keck-receipt-banner--belegart`/`--warnung`): Stylesheets der Verbraucher
+ * haengen daran, und das HTML soll durch die englischen Werte kein Byte
+ * anders werden.
+ */
+const BANNER_KLASSE = {
+    receipt_type: 'belegart',
+    warning: 'warnung',
+};
 const AUSRICHTUNG = {
     left: 'left',
     center: 'center',
     right: 'right',
 };
 /**
- * @deprecated Seit 0.14.0: [BelegBlattView] setzt den Beleg zeichengleich zu
+ * @deprecated Seit 0.14.0: [ReceiptSheetView] setzt den Beleg zeichengleich zu
  * Bon und PDF (Raster, Logo, Marke). Diese Ansicht rechnet Spalten mit Flex
  * und bricht darum anders um als das Papier.
  */
-function ReceiptLayoutView({ layout, className, renderQr, qrVerdeckt = false, qrVerdecktText }) {
+function ReceiptLayoutView({ layout, className, renderQr, qrHidden: qrVerdeckt = false, qrHiddenText: qrVerdecktText }) {
     const klasse = className === undefined ? 'keck-receipt' : `keck-receipt ${className}`;
     return ((0, jsx_runtime_1.jsx)("div", { className: klasse, "data-paper-size": layout.paperSize, children: layout.lines.map((zeile, index) => ((0, jsx_runtime_1.jsx)(Zeile, { zeile: zeile, renderQr: renderQr, qrVerdeckt: qrVerdeckt, qrVerdecktText: qrVerdecktText }, index))) }));
 }
@@ -27,7 +37,7 @@ function ReceiptLayoutView({ layout, className, renderQr, qrVerdeckt = false, qr
  * antippt. Die Nutzlast bleibt trotzdem als `data-qr` am Element -- fuer Tests
  * und Werkzeuge, nicht fuers Auge.
  */
-function QrVerdeckt({ data, text = 'Antippen zum Anzeigen', children }) {
+function HiddenQr({ data, text = 'Antippen zum Anzeigen', children }) {
     const [offen, setOffen] = (0, react_1.useState)(false);
     return ((0, jsx_runtime_1.jsxs)("button", { type: "button", className: offen ? 'keck-receipt-qr-toggle keck-receipt-qr-toggle--offen' : 'keck-receipt-qr-toggle', "aria-pressed": offen, "aria-label": offen ? 'QR-Code verdecken' : text, "data-qr": data, onClick: () => setOffen((o) => !o), style: { position: 'relative', display: 'inline-block', border: 'none', background: 'transparent', padding: 0, cursor: 'pointer' }, children: [(0, jsx_runtime_1.jsx)("span", { style: { display: 'inline-block', filter: offen ? undefined : 'blur(3px)', transition: 'filter .15s ease' }, children: children }), !offen && (
             // Tipp-Finger statt Textzeile: versteht jeder, verdeckt fast nichts.
@@ -60,47 +70,47 @@ function Zeile({ zeile, renderQr, qrVerdeckt, qrVerdecktText }) {
         case 'space':
             return (0, jsx_runtime_1.jsx)("div", { className: "keck-receipt-space", style: { height: `${zeile.lines}em` } });
         case 'banner':
-            return ((0, jsx_runtime_1.jsx)("div", { className: `keck-receipt-banner keck-receipt-banner--${zeile.ton}`, role: zeile.ton === 'warnung' ? 'alert' : undefined, style: { textAlign: 'center', fontWeight: 'bold', letterSpacing: '0.06em', padding: '0.2em 0.4em', border: '2px solid currentColor', margin: '0.3em 0' }, children: zeile.text }));
+            return ((0, jsx_runtime_1.jsx)("div", { className: `keck-receipt-banner keck-receipt-banner--${BANNER_KLASSE[zeile.tone] ?? String(zeile.tone)}`, role: zeile.tone === 'warning' ? 'alert' : undefined, style: { textAlign: 'center', fontWeight: 'bold', letterSpacing: '0.06em', padding: '0.2em 0.4em', border: '2px solid currentColor', margin: '0.3em 0' }, children: zeile.text }));
         case 'qr':
             {
                 const bild = renderQr !== undefined ? renderQr(zeile.data) : (0, jsx_runtime_1.jsx)("div", { "data-qr": zeile.data, "aria-label": "RKSV-QR-Code" });
-                return ((0, jsx_runtime_1.jsx)("div", { className: "keck-receipt-qr", style: { textAlign: 'center' }, children: qrVerdeckt ? (0, jsx_runtime_1.jsx)(QrVerdeckt, { data: zeile.data, text: qrVerdecktText, children: bild }) : bild }));
+                return ((0, jsx_runtime_1.jsx)("div", { className: "keck-receipt-qr", style: { textAlign: 'center' }, children: qrVerdeckt ? (0, jsx_runtime_1.jsx)(HiddenQr, { data: zeile.data, text: qrVerdecktText, children: bild }) : bild }));
             }
     }
 }
 /**
  * Das Blatt am Bildschirm -- Zeile fuer Zeile dieselben Zeichen wie am Bon und
  * im PDF. Masse in `ch`: eine Zeichenbreite ist `1ch`, eine Zeile `2ch`, das
- * Blatt `zeichen`ch breit. Der Verbraucher bestimmt nur Schrift (monospace,
+ * Blatt `charsPerLine`ch breit. Der Verbraucher bestimmt nur Schrift (monospace,
  * Vorgabe ueber `--keck-blatt-schrift`) und Schriftgroesse; alles andere steht
  * im Blatt.
  */
-function BelegBlattZeilen({ blatt, logoUrl, renderQr, qrVerdeckt = false, qrVerdecktText, className }) {
-    const z = blatt.zeichen;
+function ReceiptSheetLines({ sheet: blatt, logoUrl, renderQr, qrHidden: qrVerdeckt = false, qrHiddenText: qrVerdecktText, className }) {
+    const z = blatt.charsPerLine;
     const klasse = className === undefined ? 'keck-blatt' : `keck-blatt ${className}`;
     const blattStil = {
         width: `${z}ch`,
         fontFamily: 'var(--keck-blatt-schrift, "DM Mono", ui-monospace, Menlo, Consolas, monospace)',
         fontVariantLigatures: 'none',
     };
-    return ((0, jsx_runtime_1.jsx)("div", { className: klasse, "data-zeichen": z, style: blattStil, children: blatt.bloecke.map((b, i) => {
-            switch (b.art) {
-                case 'zeile':
-                    return ((0, jsx_runtime_1.jsx)("div", { className: "keck-blatt-zeile", style: { whiteSpace: 'pre', height: '2ch', lineHeight: '2ch', overflow: 'hidden', fontWeight: b.fett ? 'bold' : 'normal' }, children: b.text }, i));
+    return ((0, jsx_runtime_1.jsx)("div", { className: klasse, "data-zeichen": z, style: blattStil, children: blatt.blocks.map((b, i) => {
+            switch (b.kind) {
+                case 'line':
+                    return ((0, jsx_runtime_1.jsx)("div", { className: "keck-blatt-zeile", style: { whiteSpace: 'pre', height: '2ch', lineHeight: '2ch', overflow: 'hidden', fontWeight: b.bold ? 'bold' : 'normal' }, children: b.text }, i));
                 case 'logo':
-                    return ((0, jsx_runtime_1.jsx)("div", { className: "keck-blatt-logo", style: { height: `${b.hoeheZeilen * 2}ch`, display: 'flex', justifyContent: 'center' }, children: logoUrl === undefined ? null : ((0, jsx_runtime_1.jsx)("img", { src: logoUrl, alt: "", "aria-hidden": "true", style: { width: `${b.breiteAnteil * z}ch`, height: `${b.hoeheZeilen * 2}ch`, objectFit: 'contain' } })) }, i));
-                case 'marke':
+                    return ((0, jsx_runtime_1.jsx)("div", { className: "keck-blatt-logo", style: { height: `${b.heightLines * 2}ch`, display: 'flex', justifyContent: 'center' }, children: logoUrl === undefined ? null : ((0, jsx_runtime_1.jsx)("img", { src: logoUrl, alt: "", "aria-hidden": "true", style: { width: `${b.widthFraction * z}ch`, height: `${b.heightLines * 2}ch`, objectFit: 'contain' } })) }, i));
+                case 'brandMark':
                     // Kein Rasterbild wie am Bon: Dieses Paket hat bewusst keine
                     // Abhaengigkeiten, und die Pfade liegen ohnehin schon vor (PDF
                     // zeichnet dieselben). Ein SVG bleibt in jeder Aufloesung scharf.
-                    return ((0, jsx_runtime_1.jsx)("div", { className: "keck-blatt-marke", style: { height: `${b.hoehe / blatt_js_1.PUNKTE_JE_ZEICHEN}ch`, display: 'flex', justifyContent: 'center' }, children: (0, jsx_runtime_1.jsx)("svg", { viewBox: `0 0 ${marke_daten_js_1.MARKE_PFADE.breite} ${marke_daten_js_1.MARKE_PFADE.hoehe}`, width: `${b.breite / blatt_js_1.PUNKTE_JE_ZEICHEN}ch`, height: `${b.hoehe / blatt_js_1.PUNKTE_JE_ZEICHEN}ch`, role: "img", "aria-label": "Kasseneck", fill: "currentColor", children: marke_daten_js_1.MARKE_PFADE.pfade.map((d, j) => (0, jsx_runtime_1.jsx)("path", { d: d }, j)) }) }, i));
+                    return ((0, jsx_runtime_1.jsx)("div", { className: "keck-blatt-marke", style: { height: `${b.height / blatt_js_1.DOTS_PER_CHAR}ch`, display: 'flex', justifyContent: 'center' }, children: (0, jsx_runtime_1.jsx)("svg", { viewBox: `0 0 ${marke_daten_js_1.BRAND_MARK_PATHS.width} ${marke_daten_js_1.BRAND_MARK_PATHS.height}`, width: `${b.width / blatt_js_1.DOTS_PER_CHAR}ch`, height: `${b.height / blatt_js_1.DOTS_PER_CHAR}ch`, role: "img", "aria-label": "Kasseneck", fill: "currentColor", children: marke_daten_js_1.BRAND_MARK_PATHS.paths.map((d, j) => (0, jsx_runtime_1.jsx)("path", { d: d }, j)) }) }, i));
                 case 'qr': {
                     // Auch beim Anteil 0 (leer oder in keine Version passend) bekommt
                     // `renderQr` die Nutzlast: die Oberflaeche muss sagen koennen, dass
                     // der QR fehlt und ein Papierbeleg noetig ist. Bon und PDF lassen
-                    // den QR dann weg und melden es ueber `qrFehler`.
-                    const bild = renderQr !== undefined ? renderQr(b.nutzlast) : (0, jsx_runtime_1.jsx)("div", { "data-qr": b.nutzlast, "aria-label": "RKSV-QR-Code" });
-                    return ((0, jsx_runtime_1.jsx)("div", { className: "keck-blatt-qr", style: { display: 'flex', justifyContent: 'center' }, children: (0, jsx_runtime_1.jsx)("div", { style: { width: `${b.breiteAnteil * z}ch`, aspectRatio: '1 / 1' }, children: qrVerdeckt ? (0, jsx_runtime_1.jsx)(QrVerdeckt, { data: b.nutzlast, text: qrVerdecktText, children: bild }) : bild }) }, i));
+                    // den QR dann weg und melden es ueber `qrError`.
+                    const bild = renderQr !== undefined ? renderQr(b.payload) : (0, jsx_runtime_1.jsx)("div", { "data-qr": b.payload, "aria-label": "RKSV-QR-Code" });
+                    return ((0, jsx_runtime_1.jsx)("div", { className: "keck-blatt-qr", style: { display: 'flex', justifyContent: 'center' }, children: (0, jsx_runtime_1.jsx)("div", { style: { width: `${b.widthFraction * z}ch`, aspectRatio: '1 / 1' }, children: qrVerdeckt ? (0, jsx_runtime_1.jsx)(HiddenQr, { data: b.payload, text: qrVerdecktText, children: bild }) : bild }) }, i));
                 }
             }
         }) }));
@@ -110,12 +120,12 @@ function BelegBlattZeilen({ blatt, logoUrl, renderQr, qrVerdeckt = false, qrVerd
  * das Bild geladen ist, fehlt der Logo-Block -- die Kasse laedt das Logo ohnehin
  * vorab in den Browser-Cache.
  *
- * Ein Logo ueber [logoPixelZulaessig] (4096x4096px, dieselbe Grenze wie das
+ * Ein Logo ueber [isLogoPixelSizeAllowed] (4096x4096px, dieselbe Grenze wie das
  * Druck-Kit beim Rastern fuer den Bon) bleibt hier ebenso ohne Logo-Block --
  * sonst zeigte der Bildschirm ein Logo, das nie gedruckt wird: Bildschirm und
  * Bon zeigen dasselbe Logo.
  */
-function BelegBlattView({ layout, zeichen, logo, marke = false, qrGroesse, ...rest }) {
+function ReceiptSheetView({ layout, charsPerLine: zeichen, logo, brandMark: marke = false, qrModuleSize: qrGroesse, ...rest }) {
     const [mass, setMass] = (0, react_1.useState)(null);
     const url = logo?.url;
     (0, react_1.useEffect)(() => {
@@ -127,7 +137,7 @@ function BelegBlattView({ layout, zeichen, logo, marke = false, qrGroesse, ...re
             return undefined;
         const bild = new Bild();
         bild.onload = () => {
-            if (aktiv && (0, blatt_js_1.logoPixelZulaessig)(bild.naturalWidth, bild.naturalHeight))
+            if (aktiv && (0, blatt_js_1.isLogoPixelSizeAllowed)(bild.naturalWidth, bild.naturalHeight))
                 setMass({ url, breite: bild.naturalWidth, hoehe: bild.naturalHeight });
         };
         bild.src = url;
@@ -135,14 +145,14 @@ function BelegBlattView({ layout, zeichen, logo, marke = false, qrGroesse, ...re
             aktiv = false;
         };
     }, [url]);
-    const optionen = { marke };
+    const optionen = { brandMark: marke };
     if (zeichen !== undefined)
-        optionen.zeichen = zeichen;
+        optionen.charsPerLine = zeichen;
     if (qrGroesse !== undefined)
-        optionen.qrGroesse = qrGroesse;
+        optionen.qrModuleSize = qrGroesse;
     const geladen = logo != null && mass !== null && mass.url === logo.url;
     if (geladen)
-        optionen.logo = { stufe: logo.stufe, pxBreite: mass.breite, pxHoehe: mass.hoehe };
-    const blatt = (0, blatt_js_1.belegBlatt)(layout, optionen);
-    return geladen ? (0, jsx_runtime_1.jsx)(BelegBlattZeilen, { blatt: blatt, logoUrl: logo.url, ...rest }) : (0, jsx_runtime_1.jsx)(BelegBlattZeilen, { blatt: blatt, ...rest });
+        optionen.logo = { size: logo.size, pixelWidth: mass.breite, pixelHeight: mass.hoehe };
+    const blatt = (0, blatt_js_1.receiptSheet)(layout, optionen);
+    return geladen ? (0, jsx_runtime_1.jsx)(ReceiptSheetLines, { sheet: blatt, logoUrl: logo.url, ...rest }) : (0, jsx_runtime_1.jsx)(ReceiptSheetLines, { sheet: blatt, ...rest });
 }

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

@@ -1,14 +1,14 @@
-import type { RasterBild } from '../printing/escpos.js';
-import { type LogoMass } from './blatt.js';
+import type { RasterImage } from '../printing/escpos.js';
+import { type LogoDimensions } from './blatt.js';
 /**
  * RGBA-Pixel (wie `ImageData.data` im Browser oder ein dekodiertes PNG in
  * Node/Dart) -> einfarbiges Rasterbild in genau der Groesse, die das Blatt
  * dem Logo gibt.
  *
  * Die Rechnung ist Vertrag und hat einen Dart-Zwilling (Golden
- * `erwartet/logo-probe.raster32.txt`): Flaechenmittel je Druckpunkt,
+ * `expected/logo-sample.raster32.txt`): Flaechenmittel je Druckpunkt,
  * Durchsichtiges auf Papierweiss, Helligkeit nach BT.601, Floyd-Steinberg mit
  * Schwelle 128. Die Reihenfolge der Rechenschritte nicht aendern -- beide
  * Sprachen rechnen mit IEEE-Doubles und kommen nur so auf dieselben Punkte.
  */
-export declare function logoRaster(rgba: ArrayLike<number>, pxBreite: number, pxHoehe: number, mass: LogoMass, zeichen: number): RasterBild;
+export declare function rasterizeLogo(rgba: ArrayLike<number>, pxWidth: number, pxHeight: number, dimensions: LogoDimensions, chars: number): RasterImage;