@kreiseck/kasseneck-api 0.6.8 → 0.6.44

package/README.md

@@ -118,6 +118,10 @@ const { receipt, company } = await api.sellReceiptWithCompany({
     { name: 'Café Latte', quantity: 2, vat: VatRate.vat20, priceCents: 390 },
     { name: 'Marmeladeweckerl', quantity: 1, vat: VatRate.vat10, priceCents: 250 },
   ],
+  // Trinkgeld in Cent (optional): das Backend bucht daraus eine signierte
+  // Position „Trinkgeld“ — Mitarbeiter 0 % als Durchläufer, Inhaber als Umsatz.
+  // Als Objekt mit eigener Zahlart/Empfängern: { cents, paymentMethod, recipients }.
+  tip: 100,
 });
 
 // Layout bauen (reines Datenmodell: Zeilen, Ausrichtung, Spalten, QR-Code) …

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

@@ -1,7 +1,7 @@
 export { type AuthCredentials, type KasseneckAuth, type ApiKeyAuthOptions, type RegisterUserAuthOptions, apiKeyAuth, registerUserAuth, } from './auth.js';
 export { DEFAULT_BASE_URL, DEFAULT_TIMEOUT_MS, type HttpResponseLike, type HttpRequestInit, type FetchLike, type TransportOptions, type TransportBodyFields, type KasseneckTransport, type KasseneckBinaryTransport, createTransport, createBinaryTransport, } from './transport.js';
 export { KasseneckApiError, KasseneckAuthError, KasseneckHttpError, KasseneckNetworkError, KasseneckValidationError, type ValidationScope, type KasseneckError, type HttpFailureReason, type CauseDigest, isKasseneckApiError, isKasseneckAuthError, isKasseneckHttpError, isKasseneckNetworkError, isKasseneckValidationError, } from './errors.js';
-export { type ReceiptCommonOptions, type SellReceiptOptions, type CancelReceiptOptions, type CreateCancelReceiptOptions, type ReceiptWithCompany, sellReceipt, sellReceiptWithCompany, cancelReceipt, type CancelReceiptResult, createCancelReceipt, zeroReceipt, getReceipt, getReceiptWithCompany, generateFullReceiptId, getFirstReceiptDate, listMyReceipts, type ListMyReceiptsOptions, type ReceiptList, type ReceiptListStats, checkVoucherCombinationError, } from './receipts.js';
+export { type ReceiptCommonOptions, type SellReceiptOptions, type TipOptions, type TipRecipientShare, type CancelReceiptOptions, type CreateCancelReceiptOptions, type ReceiptWithCompany, sellReceipt, sellReceiptWithCompany, cancelReceipt, type CancelReceiptResult, createCancelReceipt, zeroReceipt, getReceipt, getReceiptWithCompany, generateFullReceiptId, getFirstReceiptDate, listMyReceipts, type ListMyReceiptsOptions, type ReceiptList, type ReceiptListStats, checkVoucherCombinationError, } from './receipts.js';
 export { listMyCashregisters } from './cashregisters.js';
 export { downloadDailyReport, downloadMonthlyReport } from './reports.js';
 export { type CashboxStatus, type SignatureStatus, getCashboxStatus, getSignatureStatus, } from './status.js';

package/dist/cjs/client/receipts.d.ts

@@ -39,6 +39,25 @@ export interface ReceiptCommonOptions {
     customProjectId?: string;
     /** Rohdaten der Kartenzahlung (Terminal-/Anbieterantwort). */
     cardPaymentData?: Record<string, unknown>;
+    /**
+     * Trinkgeld in Cent — als Zahl (an den angemeldeten Kassen-Benutzer, Zahlart
+     * des Belegs) oder als [TipOptions]. Das Backend bucht daraus signierte
+     * Positionen `kind:'tip'` (Mitarbeiter 0 % als Durchlaeufer, Inhaber
+     * anteilig je Steuersatz). Nur auf `standard` und `training`.
+     */
+    tip?: number | TipOptions;
+}
+/** Trinkgeld mit eigener Zahlart und/oder Empfaengern (Kassen-Benutzer-IDs, Summe = cents). */
+export interface TipOptions {
+    cents: number;
+    /** Zahlart des Trinkgelds; ohne Angabe gilt die des Belegs. */
+    paymentMethod?: KeckPaymentMethod | KeckPaymentMethodKey;
+    /** Empfaenger; ohne Angabe der angemeldete Kassen-Benutzer. Summe der cents = cents. */
+    recipients?: TipRecipientShare[];
+}
+export interface TipRecipientShare {
+    registerUserId: string;
+    cents: number;
 }
 /** Belegtyp und Inhalt — die vollstaendige Eingabe von [createReceipt]. */
 export interface CreateReceiptOptions extends ReceiptCommonOptions {

package/dist/cjs/client/receipts.js

@@ -87,6 +87,12 @@ function createReceiptParams(options) {
             }
         }
     }
+    if (options.tip != null) {
+        if (typ.value !== index_js_1.ReceiptType.standard.value && typ.value !== index_js_1.ReceiptType.training.value) {
+            throw eingabefehler(`Trinkgeld ist nur bei receiptType standard oder training moeglich, nicht bei "${typ.value}".`);
+        }
+        params['tip'] = gepruefterTip(options.tip);
+    }
     if (options.customProjectId != null) {
         params['customProjectId'] = options.customProjectId;
     }
@@ -372,6 +378,51 @@ function alsNutzlast(werte, wandeln) {
         throw eingabefehler(ursache instanceof Error ? ursache.message : 'Ungueltige Nutzlast uebergeben.');
     }
 }
+/** Positive ganze Cent? */
+function istCentBetrag(wert) {
+    return typeof wert === 'number' && Number.isInteger(wert) && wert > 0;
+}
+/**
+ * Trinkgeld pruefen und in die Nutzlast-Form bringen (Zahl bleibt Zahl; das
+ * Objekt geht mit geprueftem Zahlart-Wert und Empfaengern hinaus). Dieselben
+ * Regeln wie das Backend (tip-core.normalizeTip) — nur frueher.
+ */
+function gepruefterTip(tip) {
+    if (typeof tip === 'number') {
+        if (!istCentBetrag(tip))
+            throw eingabefehler('Trinkgeld: Betrag muss eine ganze Zahl in Cent > 0 sein.');
+        return tip;
+    }
+    if (tip == null || typeof tip !== 'object' || !istCentBetrag(tip.cents)) {
+        throw eingabefehler('Trinkgeld: Betrag muss eine ganze Zahl in Cent > 0 sein.');
+    }
+    const nutzlast = { cents: tip.cents };
+    if (tip.paymentMethod != null)
+        nutzlast['paymentMethod'] = gepruefteZahlungsart(tip.paymentMethod);
+    if (tip.recipients != null) {
+        if (!Array.isArray(tip.recipients) || tip.recipients.length === 0) {
+            throw eingabefehler('Trinkgeld: recipients darf nicht leer sein.');
+        }
+        let summe = 0;
+        const gesehen = new Set();
+        for (const r of tip.recipients) {
+            if (r == null || typeof r.registerUserId !== 'string' || r.registerUserId === '') {
+                throw eingabefehler('Trinkgeld: recipients[].registerUserId fehlt.');
+            }
+            if (!istCentBetrag(r.cents))
+                throw eingabefehler('Trinkgeld: recipients[].cents muss eine ganze Zahl > 0 sein.');
+            if (gesehen.has(r.registerUserId))
+                throw eingabefehler(`Trinkgeld: Kassen-Benutzer ${r.registerUserId} doppelt.`);
+            gesehen.add(r.registerUserId);
+            summe += r.cents;
+        }
+        if (summe !== tip.cents) {
+            throw eingabefehler(`Trinkgeld: Summe der Empfaenger (${summe}) entspricht nicht dem Betrag (${tip.cents}).`);
+        }
+        nutzlast['recipients'] = tip.recipients.map((r) => ({ registerUserId: r.registerUserId, cents: r.cents }));
+    }
+    return nutzlast;
+}
 /** Zahlungsart des Aufrufers pruefen — unbekannt wirft, bevor etwas rausgeht. */
 function gepruefteZahlungsart(wert) {
     if (typeof wert === 'object') {

package/dist/cjs/index.d.ts

@@ -1,5 +1,5 @@
 export { ReceiptType, type ReceiptTypeKey, VatRate, type VatRateKey, KeckPaymentMethod, type KeckPaymentMethodKey, CreditCardProvider, type CreditCardProviderKey, VoucherType, type VoucherTypeKey, VoucherAction, type VoucherActionKey, StripeLinkMode, type StripeLinkModeKey, } from './enums/index.js';
-export { type ReceiptItem, type ReceiptItemPayload, type ReceiptItemPayloadRead, toReceiptItemPayload, fromReceiptItemPayload, receiptItemTotalCents, receiptItemIsValid, negateReceiptItem, type Voucher, type VoucherPayload, toVoucherPayload, fromVoucherPayload, voucherIsValid, type Receipt, type ReceiptPayload, type ReceiptPayloadRead, toReceiptPayload, fromReceiptPayload, receiptSubSumCents, receiptSumCents, type CancellationOf, type CancellationItem, type Cancellation, type CancellationReason, CANCELLATION_REASONS, CANCELLATION_RESERVATION_MS, isCancellationReason, remainingQuantities, type ReceiptCompany, type ReceiptCompanyPayload, fromReceiptCompanyPayload, receiptCompanyTaxInfo, type Cashregister, type CashregisterOnboarding, type CashregisterPayload, type CashregisterOnboardingPayload, fromCashregisterPayload, type ReceiptSummary, type ReceiptSummaryPayload, fromReceiptSummaryPayload, type ZeroKind, ZERO_KINDS, istZeroKind, type ReportMonth, reportMonthFromDate, previousReportMonth, nextReportMonth, reportMonthKey, reportMonthReadable, type StripeUrlSession, type StripeUrlSessionPayload, toStripeUrlSessionPayload, fromStripeUrlSessionPayload, type HobexReceipt, type HobexReceiptPayload, toHobexReceiptPayload, fromHobexReceiptPayload, hobexReceiptToCardPaymentData, hobexReceiptNeedsSignature, } from './models/index.js';
-export { type AuthCredentials, type KasseneckAuth, type ApiKeyAuthOptions, type RegisterUserAuthOptions, apiKeyAuth, registerUserAuth, DEFAULT_BASE_URL, DEFAULT_TIMEOUT_MS, type HttpResponseLike, type HttpRequestInit, type FetchLike, type TransportOptions, type TransportBodyFields, type KasseneckTransport, type KasseneckBinaryTransport, createTransport, createBinaryTransport, KasseneckApiError, KasseneckAuthError, KasseneckHttpError, KasseneckNetworkError, KasseneckValidationError, type ValidationScope, type KasseneckError, type HttpFailureReason, type CauseDigest, isKasseneckApiError, isKasseneckAuthError, isKasseneckHttpError, isKasseneckNetworkError, isKasseneckValidationError, type ReceiptCommonOptions, type SellReceiptOptions, type CancelReceiptOptions, type CancelReceiptResult, type CreateCancelReceiptOptions, type ReceiptWithCompany, sellReceipt, sellReceiptWithCompany, cancelReceipt, createCancelReceipt, zeroReceipt, getReceipt, getReceiptWithCompany, generateFullReceiptId, getFirstReceiptDate, listMyReceipts, type ListMyReceiptsOptions, type ReceiptList, type ReceiptListStats, listMyCashregisters, checkVoucherCombinationError, downloadDailyReport, downloadMonthlyReport, type CashboxStatus, type SignatureStatus, getCashboxStatus, getSignatureStatus, type KasseneckApi, createKasseneckApi, } from './client/index.js';
+export { type ReceiptItem, type ReceiptItemPayload, type ReceiptItemPayloadRead, toReceiptItemPayload, fromReceiptItemPayload, receiptItemTotalCents, receiptItemIsValid, negateReceiptItem, type TipRecipient, isTipItem, type Voucher, type VoucherPayload, toVoucherPayload, fromVoucherPayload, voucherIsValid, type Receipt, type ReceiptPayload, type ReceiptPayloadRead, toReceiptPayload, fromReceiptPayload, receiptSubSumCents, receiptSumCents, type CancellationOf, type CancellationItem, type Cancellation, type CancellationReason, CANCELLATION_REASONS, CANCELLATION_RESERVATION_MS, isCancellationReason, remainingQuantities, type ReceiptCompany, type ReceiptCompanyPayload, fromReceiptCompanyPayload, receiptCompanyTaxInfo, type Cashregister, type CashregisterOnboarding, type CashregisterPayload, type CashregisterOnboardingPayload, fromCashregisterPayload, type ReceiptSummary, type ReceiptSummaryPayload, fromReceiptSummaryPayload, type ZeroKind, ZERO_KINDS, istZeroKind, type ReportMonth, reportMonthFromDate, previousReportMonth, nextReportMonth, reportMonthKey, reportMonthReadable, type StripeUrlSession, type StripeUrlSessionPayload, toStripeUrlSessionPayload, fromStripeUrlSessionPayload, type HobexReceipt, type HobexReceiptPayload, toHobexReceiptPayload, fromHobexReceiptPayload, hobexReceiptToCardPaymentData, hobexReceiptNeedsSignature, } from './models/index.js';
+export { type AuthCredentials, type KasseneckAuth, type ApiKeyAuthOptions, type RegisterUserAuthOptions, apiKeyAuth, registerUserAuth, DEFAULT_BASE_URL, DEFAULT_TIMEOUT_MS, type HttpResponseLike, type HttpRequestInit, type FetchLike, type TransportOptions, type TransportBodyFields, type KasseneckTransport, type KasseneckBinaryTransport, createTransport, createBinaryTransport, KasseneckApiError, KasseneckAuthError, KasseneckHttpError, KasseneckNetworkError, KasseneckValidationError, type ValidationScope, type KasseneckError, type HttpFailureReason, type CauseDigest, isKasseneckApiError, isKasseneckAuthError, isKasseneckHttpError, isKasseneckNetworkError, isKasseneckValidationError, type ReceiptCommonOptions, type SellReceiptOptions, type TipOptions, type TipRecipientShare, type CancelReceiptOptions, type CancelReceiptResult, type CreateCancelReceiptOptions, type ReceiptWithCompany, sellReceipt, sellReceiptWithCompany, cancelReceipt, createCancelReceipt, zeroReceipt, getReceipt, getReceiptWithCompany, generateFullReceiptId, getFirstReceiptDate, listMyReceipts, type ListMyReceiptsOptions, type ReceiptList, type ReceiptListStats, listMyCashregisters, checkVoucherCombinationError, downloadDailyReport, downloadMonthlyReport, type CashboxStatus, type SignatureStatus, getCashboxStatus, getSignatureStatus, type KasseneckApi, createKasseneckApi, } from './client/index.js';
 export { parseServerTimeStamp, toViennaWallClock, type ViennaWallClock } from './vienna-time.js';
 export { type KasseSettingsBetrieb, type KasseSettingsGeraet, type KasseSettings, type ArticleGroup, type KasseArtikel, KASSE_BETRIEB_STANDARD, KASSE_GERAET_STANDARD, mergeKasseSettings, fromArticleGroupPayload, fromKasseArtikelPayload, listMyArticleGroups, listMyArticles, getKasseSettings, setMyKasseSettings, setMyRegisterDeviceSettings, verteileRabatt, cancelScopeOf, receiptsScopeOf, } from './kasse/index.js';

package/dist/cjs/index.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.KasseneckNetworkError = exports.KasseneckHttpError = exports.KasseneckAuthError = exports.KasseneckApiError = exports.createBinaryTransport = exports.createTransport = exports.DEFAULT_TIMEOUT_MS = exports.DEFAULT_BASE_URL = exports.registerUserAuth = exports.apiKeyAuth = exports.hobexReceiptNeedsSignature = exports.hobexReceiptToCardPaymentData = exports.fromHobexReceiptPayload = exports.toHobexReceiptPayload = exports.fromStripeUrlSessionPayload = exports.toStripeUrlSessionPayload = exports.reportMonthReadable = exports.reportMonthKey = exports.nextReportMonth = exports.previousReportMonth = exports.reportMonthFromDate = exports.istZeroKind = exports.ZERO_KINDS = exports.fromReceiptSummaryPayload = exports.fromCashregisterPayload = exports.receiptCompanyTaxInfo = exports.fromReceiptCompanyPayload = exports.remainingQuantities = exports.isCancellationReason = exports.CANCELLATION_RESERVATION_MS = exports.CANCELLATION_REASONS = exports.receiptSumCents = exports.receiptSubSumCents = exports.fromReceiptPayload = exports.toReceiptPayload = exports.voucherIsValid = exports.fromVoucherPayload = exports.toVoucherPayload = exports.negateReceiptItem = exports.receiptItemIsValid = exports.receiptItemTotalCents = exports.fromReceiptItemPayload = exports.toReceiptItemPayload = exports.StripeLinkMode = exports.VoucherAction = exports.VoucherType = exports.CreditCardProvider = exports.KeckPaymentMethod = exports.VatRate = exports.ReceiptType = void 0;
-exports.receiptsScopeOf = exports.cancelScopeOf = exports.verteileRabatt = exports.setMyRegisterDeviceSettings = exports.setMyKasseSettings = exports.getKasseSettings = exports.listMyArticles = exports.listMyArticleGroups = exports.fromKasseArtikelPayload = exports.fromArticleGroupPayload = exports.mergeKasseSettings = exports.KASSE_GERAET_STANDARD = exports.KASSE_BETRIEB_STANDARD = exports.toViennaWallClock = exports.parseServerTimeStamp = exports.createKasseneckApi = exports.getSignatureStatus = exports.getCashboxStatus = exports.downloadMonthlyReport = exports.downloadDailyReport = exports.checkVoucherCombinationError = exports.listMyCashregisters = exports.listMyReceipts = exports.getFirstReceiptDate = exports.generateFullReceiptId = exports.getReceiptWithCompany = exports.getReceipt = exports.zeroReceipt = exports.createCancelReceipt = exports.cancelReceipt = exports.sellReceiptWithCompany = exports.sellReceipt = exports.isKasseneckValidationError = exports.isKasseneckNetworkError = exports.isKasseneckHttpError = exports.isKasseneckAuthError = exports.isKasseneckApiError = exports.KasseneckValidationError = void 0;
+exports.KasseneckHttpError = exports.KasseneckAuthError = exports.KasseneckApiError = exports.createBinaryTransport = exports.createTransport = exports.DEFAULT_TIMEOUT_MS = exports.DEFAULT_BASE_URL = exports.registerUserAuth = exports.apiKeyAuth = exports.hobexReceiptNeedsSignature = exports.hobexReceiptToCardPaymentData = exports.fromHobexReceiptPayload = exports.toHobexReceiptPayload = exports.fromStripeUrlSessionPayload = exports.toStripeUrlSessionPayload = exports.reportMonthReadable = exports.reportMonthKey = exports.nextReportMonth = exports.previousReportMonth = exports.reportMonthFromDate = exports.istZeroKind = exports.ZERO_KINDS = exports.fromReceiptSummaryPayload = exports.fromCashregisterPayload = exports.receiptCompanyTaxInfo = exports.fromReceiptCompanyPayload = exports.remainingQuantities = exports.isCancellationReason = exports.CANCELLATION_RESERVATION_MS = exports.CANCELLATION_REASONS = exports.receiptSumCents = exports.receiptSubSumCents = exports.fromReceiptPayload = exports.toReceiptPayload = exports.voucherIsValid = exports.fromVoucherPayload = exports.toVoucherPayload = exports.isTipItem = exports.negateReceiptItem = exports.receiptItemIsValid = exports.receiptItemTotalCents = exports.fromReceiptItemPayload = exports.toReceiptItemPayload = exports.StripeLinkMode = exports.VoucherAction = exports.VoucherType = exports.CreditCardProvider = exports.KeckPaymentMethod = exports.VatRate = exports.ReceiptType = void 0;
+exports.receiptsScopeOf = exports.cancelScopeOf = exports.verteileRabatt = exports.setMyRegisterDeviceSettings = exports.setMyKasseSettings = exports.getKasseSettings = exports.listMyArticles = exports.listMyArticleGroups = exports.fromKasseArtikelPayload = exports.fromArticleGroupPayload = exports.mergeKasseSettings = exports.KASSE_GERAET_STANDARD = exports.KASSE_BETRIEB_STANDARD = exports.toViennaWallClock = exports.parseServerTimeStamp = exports.createKasseneckApi = exports.getSignatureStatus = exports.getCashboxStatus = exports.downloadMonthlyReport = exports.downloadDailyReport = exports.checkVoucherCombinationError = exports.listMyCashregisters = exports.listMyReceipts = exports.getFirstReceiptDate = exports.generateFullReceiptId = exports.getReceiptWithCompany = exports.getReceipt = exports.zeroReceipt = exports.createCancelReceipt = exports.cancelReceipt = exports.sellReceiptWithCompany = exports.sellReceipt = exports.isKasseneckValidationError = exports.isKasseneckNetworkError = exports.isKasseneckHttpError = exports.isKasseneckAuthError = exports.isKasseneckApiError = exports.KasseneckValidationError = exports.KasseneckNetworkError = void 0;
 var index_js_1 = require("./enums/index.js");
 Object.defineProperty(exports, "ReceiptType", { enumerable: true, get: function () { return index_js_1.ReceiptType; } });
 Object.defineProperty(exports, "VatRate", { enumerable: true, get: function () { return index_js_1.VatRate; } });
@@ -16,6 +16,7 @@ Object.defineProperty(exports, "fromReceiptItemPayload", { enumerable: true, get
 Object.defineProperty(exports, "receiptItemTotalCents", { enumerable: true, get: function () { return index_js_2.receiptItemTotalCents; } });
 Object.defineProperty(exports, "receiptItemIsValid", { enumerable: true, get: function () { return index_js_2.receiptItemIsValid; } });
 Object.defineProperty(exports, "negateReceiptItem", { enumerable: true, get: function () { return index_js_2.negateReceiptItem; } });
+Object.defineProperty(exports, "isTipItem", { enumerable: true, get: function () { return index_js_2.isTipItem; } });
 Object.defineProperty(exports, "toVoucherPayload", { enumerable: true, get: function () { return index_js_2.toVoucherPayload; } });
 Object.defineProperty(exports, "fromVoucherPayload", { enumerable: true, get: function () { return index_js_2.fromVoucherPayload; } });
 Object.defineProperty(exports, "voucherIsValid", { enumerable: true, get: function () { return index_js_2.voucherIsValid; } });

package/dist/cjs/kasse/settings.d.ts

@@ -20,8 +20,15 @@ export type KasseBelegAusgabe = 'qr' | 'druck' | 'mail' | 'sms' | 'fragen';
 export type KasseLayout = 'rechts' | 'links' | 'vollbild';
 export type KasseKatpos = 'oben' | 'links';
 export type KasseHoehe = 'S' | 'M' | 'L';
-/** `sdp` = Netzwerk ueber Epson Server Direct Print (der Drucker holt Jobs vom Backend, jeder Browser druckt). */
-export type KasseDruckerArt = 'sdp' | 'netz' | 'bt' | 'usb';
+/**
+ * `sdp` = Netzwerk ueber Epson Server Direct Print (der Drucker holt Jobs vom Backend, jeder Browser druckt).
+ * `connect` = Kasseneck Connect (lokaler Agent auf dem Kassen-Rechner druckt fuer die Browser-Kasse).
+ */
+export type KasseDruckerArt = 'sdp' | 'netz' | 'bt' | 'usb' | 'connect';
+/** Terminal-Ansprache: direkt per IP (wie bisher) oder ueber Kasseneck Connect (Agent leitet weiter). */
+export type KasseTerminalVia = 'direkt' | 'connect';
+/** Art des Kartenterminals an dieser Kasse: keines oder Hobex HPS (JSON-REST am Geraet). */
+export type KasseTerminalArt = 'keins' | 'hps';
 export type KassePapier = 'mm58' | 'mm80';
 export type KasseZeichensatz = 'CP1252' | 'CP437';
 export type KasseSchnitt = 'partial' | 'full' | 'none';
@@ -55,6 +62,20 @@ export interface KasseSettingsBetrieb {
     notiz: boolean;
     suche: boolean;
     rabatt: 'aus' | 'an';
+    /** Bild-Logo (Download-URL aus dem Kasse-Upload); '' = Kuerzel verwenden. */
+    logoBild: string;
+    /** Seite des Wasserzeichens — ALT: abgeloest von wzPos, bleibt fuers Mischen alter Staende. */
+    wzSeite: 'links' | 'mitte' | 'rechts';
+    /** Horizontale Lage der Wasserzeichen-MITTE in Prozent (-25 bis 125 — darf ueber den Rand hinaus). */
+    wzPos: number;
+    /** Vertikale Lage der Wasserzeichen-Mitte in Prozent (-25 bis 125). */
+    wzPosV: number;
+    /** Deckkraft des Wasserzeichens in Prozent — bewusst Stufen, kein Schieberegler. */
+    wzStaerke: 3 | 6 | 10 | 16;
+    /** Groesse des Bild-Logos am BELEG (Ansicht, PDF, Kopfzeile). */
+    logoSkala: 'S' | 'M' | 'L' | 'XL';
+    /** Groesse des Wasserzeichens — getrennt vom Beleg-Logo. */
+    wzSkala: 'S' | 'M' | 'L' | 'XL';
     zahlBar: boolean;
     zahlKarte: boolean;
     kartenanbieter: KasseKartenanbieter;
@@ -67,11 +88,17 @@ export interface KasseSettingsBetrieb {
     kassierenModus: KasseKassierenModus;
     /** Trinkgeld-Chips in Prozent (eine Nachkommastelle, max 5, eindeutig, Reihenfolge des Chefs). */
     tgChips: number[];
+    /** Rabatt-Chips in Prozent — dieselben Regeln wie tgChips, vom Chef einstellbar. */
+    rabattChips: number[];
     belegAusgabe: KasseBelegAusgabe;
     fertigSekunden: 0 | 3 | 5 | 10 | 15 | 30 | 60;
+    /** Glas-Optik: Kacheln und Korb leicht durchscheinend (Wasserzeichen schimmert). */
+    glas: boolean;
+    /** Hilfetexte in den Chef-Einstellungen anzeigen. */
+    hinweise: boolean;
 }
 /** Aktionen der Kasse, die eine Taste bekommen koennen. */
-export type KasseTastenAktion = 'kassieren' | 'abschliessen' | 'abbrechen' | 'frei' | 'bar' | 'karte' | 'passend' | 'belege' | 'letzteZurueck';
+export type KasseTastenAktion = 'kassieren' | 'abschliessen' | 'abbrechen' | 'frei' | 'bar' | 'karte' | 'passend' | 'belege' | 'letzteZurueck' | 'einstellungen' | 'abmelden' | 'trinkgeld' | 'vollbild' | 'gegebenLeeren' | 'korbLeeren';
 export declare const KASSE_TASTEN_AKTIONEN: readonly KasseTastenAktion[];
 /** Tastenkarte: Aktion -> Tasten (`Mod+F`, `Enter`, `Escape`, `F5` ...; `Mod` = ⌘ auf dem Mac, Strg sonst). */
 export type KasseTastenkarte = Record<KasseTastenAktion, string[]>;
@@ -93,6 +120,8 @@ export interface KasseSettingsGeraet {
     druckerId: string;
     /** ePOS Device-ID bei `druckerArt 'netz'` (Epson direkt per IP), Vorgabe `local_printer`. */
     druckerDevid: string;
+    /** Kennung des Druckers im lokalen Kasseneck-Connect-Agenten, bei `druckerArt 'connect'`. */
+    connectDruckerId: string;
     papier: KassePapier;
     zeichensatz: KasseZeichensatz;
     schnitt: KasseSchnitt;
@@ -100,6 +129,13 @@ export interface KasseSettingsGeraet {
     ladeAuto: KasseLadeAuto;
     terminalIp: string;
     terminalPort: number;
+    terminalVia: KasseTerminalVia;
+    /** Art des Terminals ('keins' = Kartenzahlung ohne Terminal-Anbindung gesperrt, sofern zahlKarte an). */
+    terminalArt: KasseTerminalArt;
+    /** Tastenmarken (die kleinen Kuerzel an den Knoepfen) anzeigen. */
+    tastenMarken: boolean;
+    /** Terminal-ID aus dem Hobex-Vertrag (ohne fuehrende Null); noetig fuer Diagnose und Zahlung. */
+    terminalTid: string;
 }
 export interface KasseSettings {
     betrieb: KasseSettingsBetrieb;

package/dist/cjs/kasse/settings.js

@@ -12,14 +12,30 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.KASSE_GERAET_STANDARD = exports.KASSE_BETRIEB_STANDARD = exports.KASSE_TASTEN_STANDARD = exports.KASSE_TASTEN_AKTIONEN = exports.KARTENANBIETER = void 0;
 exports.mergeKasseSettings = mergeKasseSettings;
 exports.KARTENANBIETER = ['keiner', 'extern', 'hobex', 'mypos', 'stripe'];
-exports.KASSE_TASTEN_AKTIONEN = ['kassieren', 'abschliessen', 'abbrechen', 'frei', 'bar', 'karte', 'passend', 'belege', 'letzteZurueck'];
+exports.KASSE_TASTEN_AKTIONEN = ['kassieren', 'abschliessen', 'abbrechen', 'frei', 'bar', 'karte', 'passend', 'belege', 'letzteZurueck', 'einstellungen', 'abmelden', 'trinkgeld', 'vollbild', 'gegebenLeeren', 'korbLeeren'];
 exports.KASSE_TASTEN_STANDARD = Object.freeze({
     kassieren: ['Enter'], abschliessen: ['Enter'], abbrechen: ['Escape'],
-    frei: ['Mod+F'], bar: ['Mod+B'], karte: ['Mod+K'], passend: ['Mod+P'],
-    belege: ['Mod+E'], letzteZurueck: ['Mod+Backspace'],
+    // Mod+F gehoert dem Vollbild; Betrag frei liegt auf D. Bar bleibt auf B,
+    // Belege auf E (Entscheidung vom 21.8., der Tausch von 0.6.25 ist zurueck).
+    frei: ['Mod+D'], bar: ['Mod+B'], karte: ['Mod+K'], passend: ['Mod+P'],
+    // NICHT Mod+E: das faengt Chrome auf dem Mac selbst ab („Auswahl fuer
+    // Suche verwenden") — am Geraet belegt. J wie Journal laesst er durch.
+    belege: ['Mod+J'], letzteZurueck: ['Mod+Backspace'],
+    // NICHT Mod+T: die Taste ist im Browser reserviert (neuer Tab) und kommt
+    // nie bei der Seite an. Mod+G laesst Chrome durch.
+    einstellungen: ['Mod+S'], abmelden: ['Mod+L'], trinkgeld: ['Mod+G'],
+    vollbild: ['Mod+F'],
+    // Mod+C = Kopieren des Browsers — im Kassieren-Schritt ist Kopieren fern,
+    // und die Bindung gilt nur dort (Bar + Rueckgeld-Rechner an).
+    gegebenLeeren: ['Mod+C'],
+    // Bewusst DIESELBE Taste wie gegebenLeeren: die beiden leben in
+    // verschiedenen Momenten (Korb vor dem Kassieren, Gegeben-Feld darin) —
+    // der Verteiler laesst die nicht zustaendige Aktion durchfallen.
+    korbLeeren: ['Mod+C'],
 });
 exports.KASSE_BETRIEB_STANDARD = Object.freeze({
-    logoText: 'K', logoAn: true, logoGroesse: 'M', wasserzeichen: 'anmeldung', farbe: '#1B46F5',
+    // Kasseneck-Teal aus dem Branding-Guide — nicht mehr das alte Blau.
+    logoText: 'K', logoAn: true, logoGroesse: 'M', wasserzeichen: 'anmeldung', farbe: '#0F6B72',
     stil: 'klar', schrift: 'M', schriftEinst: 'S', kachelstil: 'streifen', uhr: true,
     sperrbild: true, foto: true, autoAbMin: 0, abNachVerkauf: false, schnellLogin: true,
     preisAnzeigen: true, ustAnzeigen: false, emoji: true, katFarben: true, freiErlaubt: true,
@@ -28,15 +44,21 @@ exports.KASSE_BETRIEB_STANDARD = Object.freeze({
     zahlBar: true, zahlKarte: false, kartenanbieter: 'keiner', trinkgeld: false, tgModus: 'beides',
     tgStufen: { 5: true, 10: true, 15: false, 20: false }, tgChips: [5, 10], tgSplit: true, rueckgeld: true,
     schnellbar: false, kassierenModus: 'seite',
-    belegAusgabe: 'qr', fertigSekunden: 0,
+    // 'fragen' = Fertig-Seite bietet QR und Bon an — sicherster Standard.
+    logoBild: '', wzSeite: 'mitte', wzPos: 50, wzPosV: 50, wzStaerke: 6, logoSkala: 'M', wzSkala: 'M',
+    glas: true, hinweise: true,
+    rabattChips: [5, 10, 15, 20],
+    belegAusgabe: 'fragen', fertigSekunden: 0,
 });
 exports.KASSE_GERAET_STANDARD = Object.freeze({
     layout: 'rechts', katpos: 'oben', spaltenExtra: 0, hoehe: 'M', touch: false,
     tasten: { ...exports.KASSE_TASTEN_STANDARD },
     druckerAn: false, druckerArt: 'sdp', druckerIp: '', druckerPort: 9100, druckerBt: '', druckerId: '', druckerDevid: 'local_printer',
+    connectDruckerId: '',
     papier: 'mm80', zeichensatz: 'CP1252', schnitt: 'partial',
     ladeAn: false, ladeAuto: 'bar',
-    terminalIp: '', terminalPort: 20008,
+    terminalIp: '', terminalPort: 8080, terminalVia: 'direkt',
+    terminalArt: 'keins', terminalTid: '', tastenMarken: true,
 });
 /**
  * Standard + gespeichert. Landkarten (`saetze`, `tgStufen`) werden je Schluessel

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

@@ -1,4 +1,4 @@
-export { type ReceiptItem, type ReceiptItemPayload, type ReceiptItemPayloadRead, toReceiptItemPayload, fromReceiptItemPayload, receiptItemTotalCents, receiptItemIsValid, negateReceiptItem, } from './receipt-item.js';
+export { type ReceiptItem, type ReceiptItemPayload, type ReceiptItemPayloadRead, toReceiptItemPayload, fromReceiptItemPayload, receiptItemTotalCents, receiptItemIsValid, negateReceiptItem, type TipRecipient, isTipItem, isDiscountItem, } from './receipt-item.js';
 export { type Voucher, type VoucherPayload, toVoucherPayload, fromVoucherPayload, voucherIsValid } from './voucher.js';
 export { type Receipt, type ReceiptPayload, type ReceiptPayloadRead, toReceiptPayload, fromReceiptPayload, receiptSubSumCents, receiptSumCents, } from './receipt.js';
 export { type CancellationOf, type CancellationItem, type Cancellation, type CancellationReason, CANCELLATION_REASONS, CANCELLATION_RESERVATION_MS, isCancellationReason, remainingQuantities, } from './cancellation.js';

package/dist/cjs/models/index.js

@@ -1,12 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.hobexReceiptNeedsSignature = exports.hobexReceiptToCardPaymentData = exports.fromHobexReceiptPayload = exports.toHobexReceiptPayload = exports.fromStripeUrlSessionPayload = exports.toStripeUrlSessionPayload = exports.reportMonthReadable = exports.reportMonthKey = exports.nextReportMonth = exports.previousReportMonth = exports.reportMonthFromDate = exports.istZeroKind = exports.ZERO_KINDS = exports.fromReceiptSummaryPayload = exports.fromCashregisterPayload = exports.receiptCompanyTaxInfo = exports.fromReceiptCompanyPayload = exports.remainingQuantities = exports.isCancellationReason = exports.CANCELLATION_RESERVATION_MS = exports.CANCELLATION_REASONS = exports.receiptSumCents = exports.receiptSubSumCents = exports.fromReceiptPayload = exports.toReceiptPayload = exports.voucherIsValid = exports.fromVoucherPayload = exports.toVoucherPayload = exports.negateReceiptItem = exports.receiptItemIsValid = exports.receiptItemTotalCents = exports.fromReceiptItemPayload = exports.toReceiptItemPayload = void 0;
+exports.hobexReceiptNeedsSignature = exports.hobexReceiptToCardPaymentData = exports.fromHobexReceiptPayload = exports.toHobexReceiptPayload = exports.fromStripeUrlSessionPayload = exports.toStripeUrlSessionPayload = exports.reportMonthReadable = exports.reportMonthKey = exports.nextReportMonth = exports.previousReportMonth = exports.reportMonthFromDate = exports.istZeroKind = exports.ZERO_KINDS = exports.fromReceiptSummaryPayload = exports.fromCashregisterPayload = exports.receiptCompanyTaxInfo = exports.fromReceiptCompanyPayload = exports.remainingQuantities = exports.isCancellationReason = exports.CANCELLATION_RESERVATION_MS = exports.CANCELLATION_REASONS = exports.receiptSumCents = exports.receiptSubSumCents = exports.fromReceiptPayload = exports.toReceiptPayload = exports.voucherIsValid = exports.fromVoucherPayload = exports.toVoucherPayload = exports.isDiscountItem = exports.isTipItem = exports.negateReceiptItem = exports.receiptItemIsValid = exports.receiptItemTotalCents = exports.fromReceiptItemPayload = exports.toReceiptItemPayload = void 0;
 var receipt_item_js_1 = require("./receipt-item.js");
 Object.defineProperty(exports, "toReceiptItemPayload", { enumerable: true, get: function () { return receipt_item_js_1.toReceiptItemPayload; } });
 Object.defineProperty(exports, "fromReceiptItemPayload", { enumerable: true, get: function () { return receipt_item_js_1.fromReceiptItemPayload; } });
 Object.defineProperty(exports, "receiptItemTotalCents", { enumerable: true, get: function () { return receipt_item_js_1.receiptItemTotalCents; } });
 Object.defineProperty(exports, "receiptItemIsValid", { enumerable: true, get: function () { return receipt_item_js_1.receiptItemIsValid; } });
 Object.defineProperty(exports, "negateReceiptItem", { enumerable: true, get: function () { return receipt_item_js_1.negateReceiptItem; } });
+Object.defineProperty(exports, "isTipItem", { enumerable: true, get: function () { return receipt_item_js_1.isTipItem; } });
+Object.defineProperty(exports, "isDiscountItem", { enumerable: true, get: function () { return receipt_item_js_1.isDiscountItem; } });
 var voucher_js_1 = require("./voucher.js");
 Object.defineProperty(exports, "toVoucherPayload", { enumerable: true, get: function () { return voucher_js_1.toVoucherPayload; } });
 Object.defineProperty(exports, "fromVoucherPayload", { enumerable: true, get: function () { return voucher_js_1.fromVoucherPayload; } });

package/dist/cjs/models/receipt-item.d.ts

@@ -27,7 +27,36 @@ export interface ReceiptItem {
     quantity: number;
     vat: VatRate | number;
     priceCents: number;
+    /**
+     * Trinkgeld-Position (vom Backend aus dem Parameter `tip` erzeugt, siehe
+     * [ReceiptCommonOptions.tip]) oder Rabatt-Position (`verteileRabatt`).
+     * Mitarbeiter-Trinkgeld ist Durchlaeufer (0 %, kein Umsatz),
+     * Inhaber-Trinkgeld (`recipient.owner`) Umsatz. Rabatt-Positionen sind
+     * negative Entgeltminderungen je Steuersatz; die Kennzeichnung steuert nur
+     * die Bon-Darstellung (Summenzeile mit Aufteilung), nie die Beträge.
+     */
+    kind?: 'tip' | 'discount';
+    /** Empfaenger der Trinkgeld-Position; `null` = nicht zugeordnet. */
+    recipient?: TipRecipient | null;
+    /** Zahlart der Trinkgeld-Position (kann von der des Belegs abweichen). */
+    paymentMethod?: string;
+    /**
+     * Artikel-Verweis (Artikelstamm) — Grundlage der Erloesgruppen-Zuordnung
+     * im Bericht. Optional; Handeingaben haben keinen.
+     */
+    articleId?: string;
 }
+/** Empfaenger einer Trinkgeld-Position (Kassen-Benutzer, Snapshot des Namens). */
+export interface TipRecipient {
+    registerUserId: string;
+    name: string;
+    /** true: Inhaber — das Trinkgeld ist Umsatz mit USt. */
+    owner?: boolean;
+}
+/** Trinkgeld-Position? Die eine Erkennungsstelle — niemand prueft `kind` selbst. */
+export declare function isTipItem(item: ReceiptItem | ReceiptItemPayloadRead): boolean;
+/** Rabatt-Position? Die eine Erkennungsstelle — niemand prueft `kind` selbst. */
+export declare function isDiscountItem(item: ReceiptItem | ReceiptItemPayloadRead): boolean;
 /**
  * Nutzlast-Form, die dieses Paket **schreibt** (v2):
  * `{ name, quantity, unitPriceCents, vatRate }`.
@@ -37,6 +66,12 @@ export interface ReceiptItemPayload {
     quantity: number;
     unitPriceCents: number;
     vatRate: number;
+    /** Trinkgeld-/Rabatt-Kennzeichnung, siehe [ReceiptItem.kind]. */
+    kind?: 'tip' | 'discount';
+    recipient?: TipRecipient | null;
+    paymentMethod?: string;
+    /** Artikel-Verweis, siehe [ReceiptItem.articleId]. */
+    articleId?: string;
 }
 /**
  * Nutzlast-Form, die dieses Paket **liest** — v2 und v1 nebeneinander, alles
@@ -54,6 +89,10 @@ export interface ReceiptItemPayload {
  */
 export interface ReceiptItemPayloadRead {
     name?: string | null;
+    /** Trinkgeld-Position (Backend), siehe [ReceiptItem.kind]. */
+    kind?: string | null;
+    recipient?: TipRecipient | null;
+    paymentMethod?: string | null;
     /** v2: Menge */
     quantity?: number | null;
     /** v2: Einzelpreis in Cent */
@@ -68,6 +107,8 @@ export interface ReceiptItemPayloadRead {
     priceOne?: number | null;
     /** v1: Steuersatz */
     vat?: number | null;
+    /** Artikel-Verweis, siehe [ReceiptItem.articleId]. */
+    articleId?: string | null;
 }
 export declare function toReceiptItemPayload(item: ReceiptItem): ReceiptItemPayload;
 /**

package/dist/cjs/models/receipt-item.js

@@ -1,5 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.isTipItem = isTipItem;
+exports.isDiscountItem = isDiscountItem;
 exports.toReceiptItemPayload = toReceiptItemPayload;
 exports.fromReceiptItemPayload = fromReceiptItemPayload;
 exports.receiptItemTotalCents = receiptItemTotalCents;
@@ -7,17 +9,42 @@ exports.receiptItemIsValid = receiptItemIsValid;
 exports.negateReceiptItem = negateReceiptItem;
 const index_js_1 = require("../enums/index.js");
 const enum_payload_js_1 = require("./enum-payload.js");
+/** Trinkgeld-Position? Die eine Erkennungsstelle — niemand prueft `kind` selbst. */
+function isTipItem(item) {
+    return item != null && item.kind === 'tip';
+}
+/** Rabatt-Position? Die eine Erkennungsstelle — niemand prueft `kind` selbst. */
+function isDiscountItem(item) {
+    return item != null && item.kind === 'discount';
+}
 function toReceiptItemPayload(item) {
     // Schreibpfad bleibt streng: ein unaufgeloester (unbekannter) Steuersatz
     // darf nicht unbesehen wieder hinausgehen.
     const vat = typeof item.vat === 'number' ? (0, enum_payload_js_1.requireVatRateByRate)(item.vat) : item.vat;
     pruefeMenge(item.quantity);
-    return {
+    const nutzlast = {
         name: item.name,
         quantity: item.quantity,
         unitPriceCents: item.priceCents,
         vatRate: vat.rate,
     };
+    // Trinkgeld-Kennzeichnung reist mit — sonst wuerde ein Storno dieser
+    // Position am Backend als Warenzeile ankommen und aus den Trinkgeld-
+    // Aggregaten nicht wieder herausgerechnet.
+    if (item.kind === 'tip') {
+        nutzlast.kind = 'tip';
+        nutzlast.recipient = item.recipient ?? null;
+        if (item.paymentMethod != null)
+            nutzlast.paymentMethod = item.paymentMethod;
+    }
+    // Rabatt-Kennzeichnung reist mit — sonst kaeme ein Storno dieser Position
+    // am Bon wieder als gewoehnliche Warenzeile mit "1 x" an.
+    if (item.kind === 'discount')
+        nutzlast.kind = 'discount';
+    // Artikel-Verweis reist mit (Erloesgruppen im Bericht); leere Werte nicht.
+    if (item.articleId != null && item.articleId !== '')
+        nutzlast.articleId = item.articleId;
+    return nutzlast;
 }
 /**
  * Liest beide Nutzlast-Formen (siehe [ReceiptItemPayloadRead]). Reihenfolge
@@ -46,6 +73,19 @@ function fromReceiptItemPayload(payload) {
         // der Fall entsteht also nur bei einer kaputten Nutzlast).
         vat: satz != null ? (0, enum_payload_js_1.readVatRateByRate)(satz) : index_js_1.VatRate.vat0,
         priceCents: cents != null ? Math.round(cents) : euro != null ? Math.round(euro * 100) : 0,
+        // Trinkgeld-Felder nur, wenn es wirklich eine Tip-Position ist: eine
+        // Warenzeile bleibt so schlank wie bisher (Golden-Belege, deepEqual).
+        ...(payload.kind === 'tip'
+            ? {
+                kind: 'tip',
+                recipient: payload.recipient ?? null,
+                ...(payload.paymentMethod != null ? { paymentMethod: payload.paymentMethod } : {}),
+            }
+            : payload.kind === 'discount'
+                ? { kind: 'discount' }
+                : {}),
+        // Artikel-Verweis erhalten (Storno-Spiegelung schreibt ihn wieder mit).
+        ...(typeof payload.articleId === 'string' && payload.articleId !== '' ? { articleId: payload.articleId } : {}),
     };
 }
 /** Erster brauchbarer Zahlenwert der Reihe; `null`/`undefined`/NaN zaehlen nicht. */

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

@@ -41,6 +41,11 @@ export interface Receipt {
     legalMessage: string[];
     signatureSuccess?: boolean;
     customProjectId?: string;
+    /**
+     * Summe aller Trinkgeld-Positionen in Cent (Storno negativ) — abgeleitetes
+     * Lesefeld des Backends, nur vorhanden, wenn der Beleg Trinkgeld traegt.
+     */
+    tipCents?: number;
     /** Nur am Storno-Beleg: das stornierte Original. */
     cancellationOf?: CancellationOf;
     /** Nur am Storno-Beleg: Grund-Code aus [CANCELLATION_REASONS]. */
@@ -71,6 +76,8 @@ export interface ReceiptPayload {
     legalMessage: string;
     signatureSuccess: boolean | null;
     customProjectId: string | null;
+    /** Nur bei Belegen mit Trinkgeld (siehe [Receipt.tipCents]). */
+    tipCents?: number | null;
 }
 /**
  * Nutzlast-Form, die dieses Paket **liest**. Unterscheidet sich von

package/dist/cjs/models/receipt.js

@@ -48,6 +48,7 @@ function toReceiptPayload(receipt) {
         legalMessage: receipt.legalMessage.join('\n'),
         signatureSuccess: receipt.signatureSuccess ?? null,
         customProjectId: receipt.customProjectId ?? null,
+        ...(receipt.tipCents != null ? { tipCents: receipt.tipCents } : {}),
     };
 }
 // Nullbelege haben keine Positionen -> items kann fehlen/null sein (siehe Dart-Vorbild).
@@ -74,6 +75,7 @@ function fromReceiptPayload(payload) {
         legalMessage: leereZeile(payload.legalMessage),
         signatureSuccess: payload.signatureSuccess ?? undefined,
         customProjectId: payload.customProjectId ?? undefined,
+        ...(typeof payload.tipCents === 'number' ? { tipCents: payload.tipCents } : {}),
         ...(payload.cancellationOf ? { cancellationOf: { receiptId: payload.cancellationOf.receiptId, fullReceiptId: payload.cancellationOf.fullReceiptId ?? null } } : {}),
         ...(payload.cancellationReason ? { cancellationReason: payload.cancellationReason } : {}),
         ...((0, receipt_summary_js_1.istZeroKind)(payload.zeroKind) ? { zeroKind: payload.zeroKind } : {}),

package/dist/cjs/printing/escpos.js

@@ -633,4 +633,11 @@ function escPosQrCode(doc, text, options = {}) {
     if (options.correction !== undefined)
         qrOptionen.correction = options.correction;
     anhaengen(doc, qrCodeBytes(text, qrOptionen));
+    // Ausrichtung SOFORT zuruecksetzen: `ESC a` gilt nur am Zeilenanfang. Die
+    // Spalten-Positionierung (`ESC $`) schickt ihren Reset sonst mitten in der
+    // Zeile — Epson ignoriert ihn, und alles nach dem QR rueckte nach rechts
+    // (belegt am TM-T20, 2026-08-20).
+    if ((options.align ?? 'center') !== 'left') {
+        escPosSetStyles(doc, { align: 'left' });
+    }
 }

package/dist/cjs/react/index.js

@@ -20,7 +20,12 @@ function ReceiptLayoutView({ layout, className, renderQr, qrVerdeckt = false, qr
  */
 function QrVerdeckt({ 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' : 'QR-Code anzeigen', "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(6px)', transition: 'filter .15s ease' }, children: children }), !offen && ((0, jsx_runtime_1.jsx)("span", { className: "keck-receipt-qr-toggle-text", style: { position: 'absolute', inset: 0, display: 'grid', placeItems: 'center', fontSize: '0.75em', fontWeight: 700 }, children: text }))] }));
+    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.
+            // Der Text bleibt als aria-label fuer Hilfsmittel. Einfarbige
+            // Strichzeichnung statt Emoji — Emojis rendern je Plattform anders
+            // und stechen farblich aus dem Beleg heraus.
+            (0, jsx_runtime_1.jsx)("span", { "aria-hidden": "true", className: "keck-receipt-qr-toggle-text", style: { position: 'absolute', inset: 0, display: 'grid', placeItems: 'center' }, children: (0, jsx_runtime_1.jsx)("span", { style: { display: 'grid', placeItems: 'center', width: '2.2em', height: '2.2em', borderRadius: '50%', background: 'rgba(255,255,255,.92)', boxShadow: '0 1px 4px rgba(0,0,0,.25)', color: 'rgba(0,0,0,.72)' }, children: (0, jsx_runtime_1.jsxs)("svg", { className: "keck-receipt-qr-toggle-finger", width: "1.25em", height: "1.25em", viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: 2, strokeLinecap: "round", strokeLinejoin: "round", children: [(0, jsx_runtime_1.jsx)("path", { d: "M10 9.5V4a2 2 0 0 0-2-2a2 2 0 0 0-2 2v10" }), (0, jsx_runtime_1.jsx)("path", { d: "M14 10V9a2 2 0 0 0-2-2a2 2 0 0 0-2 2v1" }), (0, jsx_runtime_1.jsx)("path", { d: "M18 11v-1a2 2 0 0 0-2-2a2 2 0 0 0-2 2" }), (0, jsx_runtime_1.jsx)("path", { d: "M18 11a2 2 0 1 1 4 0v3a8 8 0 0 1-8 8h-2c-2.8 0-4.5-.86-5.99-2.34l-3.6-3.6a2 2 0 0 1 2.83-2.82L7 15" })] }) }) }))] }));
 }
 function Zeile({ zeile, renderQr, qrVerdeckt, qrVerdecktText }) {
     switch (zeile.kind) {
@@ -32,6 +37,11 @@ function Zeile({ zeile, renderQr, qrVerdeckt, qrVerdecktText }) {
                         // so bleibt die Aufteilung auf allen Ausgabewegen dieselbe.
                         flex: `0 0 ${((spalte.width / 12) * 100).toFixed(4)}%`,
                         textAlign: AUSRICHTUNG[spalte.align],
+                        // minWidth 0: Flex-Zellen haben sonst min-content-Breite --
+                        // ein langes Wort ohne Leerzeichen (Hex-Seriennummer der
+                        // Signaturkarte) wuerde die Zelle sprengen und abgeschnitten,
+                        // statt per break-word umzubrechen.
+                        minWidth: 0,
                         overflowWrap: 'break-word',
                     }, children: spalte.text }, index))) }));
         case 'rule':

package/dist/cjs/receipt/discount.js

@@ -49,6 +49,6 @@ function verteileRabatt(positionen, rabattCents, name = 'Rabatt') {
         }
     }
     return liste
-        .map((g, i) => ({ name, quantity: 1, vat: g.vat, priceCents: -anteile[i] }))
+        .map((g, i) => ({ name, quantity: 1, vat: g.vat, priceCents: -anteile[i], kind: 'discount' }))
         .filter((z) => z.priceCents < 0);
 }

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

@@ -50,11 +50,16 @@ function escPosLayoutBytes(layout, options = {}) {
             case 'qr':
                 (0, index_js_1.escPosQrCode)(doc, zeile.qr ?? '', qrOptionen);
                 break;
-            case 'banner':
-                // Belegart/Warnung: fett, doppelte Hoehe; Warnungen zusaetzlich invers.
-                // Der Text ist bereits zentriert aufgefuellt (Raster).
-                (0, index_js_1.escPosText)(doc, zeile.text.trimEnd(), { styles: { align: 'left', bold: true, height: 2, reverse: zeile.ton === 'warnung' } });
+            case 'banner': {
+                // Belegart/Warnung: fett zwischen zwei Volllinien — derselbe Rahmen-
+                // Stil wie im Beleg-Viewer und im PDF (frueher druckte der Bon invers
+                // weiss-auf-schwarz und sah damit anders aus als jede Anzeige).
+                const rahmen = '='.repeat(grid_js_1.ZEICHEN_JE_PAPIER[paperSize]);
+                (0, index_js_1.escPosText)(doc, rahmen, { styles: { align: 'left', bold: true } });
+                (0, index_js_1.escPosText)(doc, zeile.text.trimEnd(), { styles: { align: 'left', bold: true, height: 2 } });
+                (0, index_js_1.escPosText)(doc, rahmen, { styles: { align: 'left', bold: true } });
                 break;
+            }
             default:
                 (0, index_js_1.escPosText)(doc, zeile.text.trimEnd(), { styles: { align: 'left', bold: zeile.bold } });
                 break;

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

@@ -21,9 +21,12 @@ import type { PosPaperSize } from '../printing/escpos.js';
  * stuende auch auf dem Bildschirm „EUR".
  *
  * Bewusst **nicht** enthalten: Firmenlogo und Rasterbilder (brauchen
- * Bildverarbeitung, die im Browser anders aussieht als in Node), PDF-Erzeugung,
- * Druckeransteuerung und die anbieterspezifischen Kartenzahlungsbloecke des
- * Vorbilds (GP Tom, Hobex, SumUp, myPOS, Stripe).
+ * Bildverarbeitung, die im Browser anders aussieht als in Node), PDF-Erzeugung
+ * und Druckeransteuerung. Von den anbieterspezifischen Kartenzahlungsbloecken
+ * des Vorbilds (GP Tom, SumUp, myPOS, Stripe) ist nur der **Hobex-Block**
+ * enthalten: die Browser-Kasse bedient das HPS-Terminal selbst (via Kasseneck
+ * Connect) und druckt den Bon aus genau diesem Modell — die uebrigen Anbieter
+ * drucken in ihren eigenen Apps.
  */
 /** Ausrichtung einer Zeile bzw. einer Spalte. */
 export type LayoutAlign = 'left' | 'center' | 'right';