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

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

@@ -1,19 +1,19 @@
 /** Groesste Modulgroesse in Druckpunkten, die der jeweilige Deckel zulaesst. */
-export const QR_MODUL_DECKEL = {
+export const 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). */
-export const QR_RUHEZONE_MODULE = 4;
+export const QR_QUIET_ZONE_MODULES = 4;
 /** Untergrenze: 4 Punkte sind bei 203 dpi rund 0,5 mm je Modul. */
-export const QR_MINDEST_PUNKTE = 4;
-/** Ausnahme, wenn `QR_MINDEST_PUNKTE` nicht passt — gemeldet, nicht still. */
-export const QR_AUSNAHME_PUNKTE = 3;
+export const QR_MIN_MODULE_DOTS = 4;
+/** Ausnahme, wenn `QR_MIN_MODULE_DOTS` nicht passt – gemeldet, nicht still. */
+export const QR_EXCEPTION_MODULE_DOTS = 3;
 /** Obergrenze des Druckbefehls in diesem Stack (`GS ( k` Funktion 167: 1..8). */
-export const QR_HOECHST_PUNKTE = 8;
+export const QR_MAX_MODULE_DOTS = 8;
 /**
  * Druckbreite des Kopfes in Punkten (203 dpi): 58 mm = 384, 80 mm = 576 —
  * Zwilling von `KeckPaperSize.druckPunkte`.
@@ -24,7 +24,7 @@ export 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 const QR_DRUCK_PUNKTE = { mm58: 384, mm80: 576 };
+export const 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).
@@ -41,7 +41,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
@@ -56,8 +56,8 @@ const BYTE_KAPAZITAET_M = [
  * langem Inhalt. Ein still zurueckgegebenes "passt nicht" haette den
  * Datenfehler als Papierfehler getarnt.
  */
-export function qrModulAnzahl(nutzlast) {
-    const laenge = new TextEncoder().encode(nutzlast).length;
+export 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);
@@ -65,69 +65,69 @@ export 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).
  */
-export function qrPasstInVersion(nutzlast) {
-    const laenge = new TextEncoder().encode(nutzlast).length;
+export 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.
  */
-export function qrGroesseBerechnen(options) {
-    const { papierbreitePunkte, moduleAnzahl } = options;
-    const groesse = options.groesse ?? 'auto';
+export 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 = QR_MODUL_DECKEL[groesse];
+    const roh = QR_MODULE_SIZE_CAP[groesse];
     if (roh === undefined) {
         throw new Error(`Unbekannte QR-Modulgroesse: ${String(groesse)}`);
     }
-    const gesamtModule = moduleAnzahl + QR_RUHEZONE_MODULE * 2;
+    const gesamtModule = moduleAnzahl + QR_QUIET_ZONE_MODULES * 2;
     const passend = Math.floor(papierbreitePunkte / gesamtModule);
-    if (passend < QR_AUSNAHME_PUNKTE) {
-        return { punkte: null, module: moduleAnzahl, breitePunkte: 0, unterMindestmass: false, passt: false };
+    if (passend < QR_EXCEPTION_MODULE_DOTS) {
+        return { moduleDots: null, modules: moduleAnzahl, widthDots: 0, belowMinimum: false, fits: false };
     }
-    const deckel = Math.min(Math.max(roh, QR_AUSNAHME_PUNKTE), QR_HOECHST_PUNKTE);
-    const punkte = passend < QR_MINDEST_PUNKTE ? QR_AUSNAHME_PUNKTE : Math.min(passend, deckel);
+    const deckel = Math.min(Math.max(roh, QR_EXCEPTION_MODULE_DOTS), QR_MAX_MODULE_DOTS);
+    const punkte = passend < QR_MIN_MODULE_DOTS ? QR_EXCEPTION_MODULE_DOTS : Math.min(passend, deckel);
     return {
-        punkte: punkte,
-        module: moduleAnzahl,
-        breitePunkte: gesamtModule * punkte,
-        unterMindestmass: punkte < QR_MINDEST_PUNKTE,
-        passt: true,
+        moduleDots: punkte,
+        modules: moduleAnzahl,
+        widthDots: gesamtModule * punkte,
+        belowMinimum: punkte < 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).
  */
-export function qrGroesseFuer(options) {
-    if (options.nutzlast === '') {
-        return { punkte: null, module: 0, breitePunkte: 0, unterMindestmass: false, passt: false };
+export 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/esm/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/esm/printing/webusb.js

@@ -47,11 +47,11 @@ export function usbFindPrinterEndpoint(d) {
  */
 export 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/esm/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/esm/react/index.js

@@ -1,18 +1,28 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { useEffect, useState } from 'react';
-import { belegBlatt, logoPixelZulaessig, PUNKTE_JE_ZEICHEN } from '../receipt/blatt.js';
-import { MARKE_PFADE } from '../receipt/marke-daten.js';
+import { receiptSheet, isLogoPixelSizeAllowed, DOTS_PER_CHAR } from '../receipt/blatt.js';
+import { BRAND_MARK_PATHS } from '../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.
  */
-export function ReceiptLayoutView({ layout, className, renderQr, qrVerdeckt = false, qrVerdecktText }) {
+export function ReceiptLayoutView({ layout, className, renderQr, qrHidden: qrVerdeckt = false, qrHiddenText: qrVerdecktText }) {
     const klasse = className === undefined ? 'keck-receipt' : `keck-receipt ${className}`;
     return (_jsx("div", { className: klasse, "data-paper-size": layout.paperSize, children: layout.lines.map((zeile, index) => (_jsx(Zeile, { zeile: zeile, renderQr: renderQr, qrVerdeckt: qrVerdeckt, qrVerdecktText: qrVerdecktText }, index))) }));
 }
@@ -21,7 +31,7 @@ export function ReceiptLayoutView({ layout, className, renderQr, qrVerdeckt = fa
  * antippt. Die Nutzlast bleibt trotzdem als `data-qr` am Element -- fuer Tests
  * und Werkzeuge, nicht fuers Auge.
  */
-export function QrVerdeckt({ data, text = 'Antippen zum Anzeigen', children }) {
+export function HiddenQr({ data, text = 'Antippen zum Anzeigen', children }) {
     const [offen, setOffen] = useState(false);
     return (_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: [_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.
@@ -54,47 +64,47 @@ function Zeile({ zeile, renderQr, qrVerdeckt, qrVerdecktText }) {
         case 'space':
             return _jsx("div", { className: "keck-receipt-space", style: { height: `${zeile.lines}em` } });
         case 'banner':
-            return (_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 (_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) : _jsx("div", { "data-qr": zeile.data, "aria-label": "RKSV-QR-Code" });
-                return (_jsx("div", { className: "keck-receipt-qr", style: { textAlign: 'center' }, children: qrVerdeckt ? _jsx(QrVerdeckt, { data: zeile.data, text: qrVerdecktText, children: bild }) : bild }));
+                return (_jsx("div", { className: "keck-receipt-qr", style: { textAlign: 'center' }, children: qrVerdeckt ? _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.
  */
-export function BelegBlattZeilen({ blatt, logoUrl, renderQr, qrVerdeckt = false, qrVerdecktText, className }) {
-    const z = blatt.zeichen;
+export 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 (_jsx("div", { className: klasse, "data-zeichen": z, style: blattStil, children: blatt.bloecke.map((b, i) => {
-            switch (b.art) {
-                case 'zeile':
-                    return (_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 (_jsx("div", { className: klasse, "data-zeichen": z, style: blattStil, children: blatt.blocks.map((b, i) => {
+            switch (b.kind) {
+                case 'line':
+                    return (_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 (_jsx("div", { className: "keck-blatt-logo", style: { height: `${b.hoeheZeilen * 2}ch`, display: 'flex', justifyContent: 'center' }, children: logoUrl === undefined ? null : (_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 (_jsx("div", { className: "keck-blatt-logo", style: { height: `${b.heightLines * 2}ch`, display: 'flex', justifyContent: 'center' }, children: logoUrl === undefined ? null : (_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 (_jsx("div", { className: "keck-blatt-marke", style: { height: `${b.hoehe / PUNKTE_JE_ZEICHEN}ch`, display: 'flex', justifyContent: 'center' }, children: _jsx("svg", { viewBox: `0 0 ${MARKE_PFADE.breite} ${MARKE_PFADE.hoehe}`, width: `${b.breite / PUNKTE_JE_ZEICHEN}ch`, height: `${b.hoehe / PUNKTE_JE_ZEICHEN}ch`, role: "img", "aria-label": "Kasseneck", fill: "currentColor", children: MARKE_PFADE.pfade.map((d, j) => _jsx("path", { d: d }, j)) }) }, i));
+                    return (_jsx("div", { className: "keck-blatt-marke", style: { height: `${b.height / DOTS_PER_CHAR}ch`, display: 'flex', justifyContent: 'center' }, children: _jsx("svg", { viewBox: `0 0 ${BRAND_MARK_PATHS.width} ${BRAND_MARK_PATHS.height}`, width: `${b.width / DOTS_PER_CHAR}ch`, height: `${b.height / DOTS_PER_CHAR}ch`, role: "img", "aria-label": "Kasseneck", fill: "currentColor", children: BRAND_MARK_PATHS.paths.map((d, j) => _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) : _jsx("div", { "data-qr": b.nutzlast, "aria-label": "RKSV-QR-Code" });
-                    return (_jsx("div", { className: "keck-blatt-qr", style: { display: 'flex', justifyContent: 'center' }, children: _jsx("div", { style: { width: `${b.breiteAnteil * z}ch`, aspectRatio: '1 / 1' }, children: qrVerdeckt ? _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) : _jsx("div", { "data-qr": b.payload, "aria-label": "RKSV-QR-Code" });
+                    return (_jsx("div", { className: "keck-blatt-qr", style: { display: 'flex', justifyContent: 'center' }, children: _jsx("div", { style: { width: `${b.widthFraction * z}ch`, aspectRatio: '1 / 1' }, children: qrVerdeckt ? _jsx(HiddenQr, { data: b.payload, text: qrVerdecktText, children: bild }) : bild }) }, i));
                 }
             }
         }) }));
@@ -104,12 +114,12 @@ export function BelegBlattZeilen({ blatt, logoUrl, renderQr, qrVerdeckt = false,
  * 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 function BelegBlattView({ layout, zeichen, logo, marke = false, qrGroesse, ...rest }) {
+export function ReceiptSheetView({ layout, charsPerLine: zeichen, logo, brandMark: marke = false, qrModuleSize: qrGroesse, ...rest }) {
     const [mass, setMass] = useState(null);
     const url = logo?.url;
     useEffect(() => {
@@ -121,7 +131,7 @@ export function BelegBlattView({ layout, zeichen, logo, marke = false, qrGroesse
             return undefined;
         const bild = new Bild();
         bild.onload = () => {
-            if (aktiv && logoPixelZulaessig(bild.naturalWidth, bild.naturalHeight))
+            if (aktiv && isLogoPixelSizeAllowed(bild.naturalWidth, bild.naturalHeight))
                 setMass({ url, breite: bild.naturalWidth, hoehe: bild.naturalHeight });
         };
         bild.src = url;
@@ -129,14 +139,14 @@ export function BelegBlattView({ layout, zeichen, logo, marke = false, qrGroesse
             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 = belegBlatt(layout, optionen);
-    return geladen ? _jsx(BelegBlattZeilen, { blatt: blatt, logoUrl: logo.url, ...rest }) : _jsx(BelegBlattZeilen, { blatt: blatt, ...rest });
+        optionen.logo = { size: logo.size, pixelWidth: mass.breite, pixelHeight: mass.hoehe };
+    const blatt = receiptSheet(layout, optionen);
+    return geladen ? _jsx(ReceiptSheetLines, { sheet: blatt, logoUrl: logo.url, ...rest }) : _jsx(ReceiptSheetLines, { sheet: blatt, ...rest });
 }

package/dist/esm/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;

package/dist/esm/receipt/bild.js

@@ -1,34 +1,34 @@
-import { logoRasterMass } from './blatt.js';
+import { logoRasterSize } 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 function logoRaster(rgba, pxBreite, pxHoehe, mass, zeichen) {
-    if (!Number.isInteger(pxBreite) || !Number.isInteger(pxHoehe) || pxBreite < 1 || pxHoehe < 1 || rgba.length !== pxBreite * pxHoehe * 4) {
+export function rasterizeLogo(rgba, pxWidth, pxHeight, dimensions, chars) {
+    if (!Number.isInteger(pxWidth) || !Number.isInteger(pxHeight) || pxWidth < 1 || pxHeight < 1 || rgba.length !== pxWidth * pxHeight * 4) {
         throw new Error('RGBA-Laenge passt nicht zum Pixelmass');
     }
-    const { breite, hoehe } = logoRasterMass(mass, zeichen);
+    const { width: breite, height: hoehe } = logoRasterSize(dimensions, chars);
     const grau = new Float64Array(breite * hoehe);
-    const sx = pxBreite / breite;
-    const sy = pxHoehe / hoehe;
+    const sx = pxWidth / breite;
+    const sy = pxHeight / hoehe;
     for (let y = 0; y < hoehe; y++) {
         const y0 = Math.floor(y * sy);
-        const y1 = Math.min(pxHoehe, Math.max(y0 + 1, Math.floor((y + 1) * sy)));
+        const y1 = Math.min(pxHeight, Math.max(y0 + 1, Math.floor((y + 1) * sy)));
         for (let x = 0; x < breite; x++) {
             const x0 = Math.floor(x * sx);
-            const x1 = Math.min(pxBreite, Math.max(x0 + 1, Math.floor((x + 1) * sx)));
+            const x1 = Math.min(pxWidth, Math.max(x0 + 1, Math.floor((x + 1) * sx)));
             let summe = 0;
             let anzahl = 0;
             for (let py = y0; py < y1; py++) {
                 for (let px = x0; px < x1; px++) {
-                    const i = (py * pxBreite + px) * 4;
+                    const i = (py * pxWidth + px) * 4;
                     const deckung = rgba[i + 3] / 255;
                     const hell = 0.299 * rgba[i] + 0.587 * rgba[i + 1] + 0.114 * rgba[i + 2];
                     summe += hell * deckung + 255 * (1 - deckung);
@@ -58,5 +58,5 @@ export function logoRaster(rgba, pxBreite, pxHoehe, mass, zeichen) {
             }
         }
     }
-    return { breite, hoehe, punkte };
+    return { width: breite, height: hoehe, dots: punkte };
 }