@kreiseck/kasseneck-api 0.6.9 → 0.6.45

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

@@ -7,41 +7,95 @@
  * Backend; ein Test in beiden Repos haelt sie deckungsgleich. Trinkgeld ist
  * bewusst AUS, bis die Buchung geklaert ist (Spec kachel-kasse § 9).
  */
-export type KasseStil = 'klar' | 'warm' | 'nacht' | 'kontrast';
-export type KasseSchrift = 'S' | 'M' | 'L' | 'XL';
-export type KasseWasserzeichen = 'aus' | 'anmeldung' | 'ueberall';
-export type KasseMenge = 'aus' | 'x' | 'kg';
-export type KasseTgModus = 'betrag' | 'gesamt' | 'beides';
-export type KasseKassierenModus = 'seite' | 'panel';
+export declare const STIL: readonly ["klar", "warm", "nacht", "kontrast"];
+export type KasseStil = typeof STIL[number];
+export declare const SCHRIFT: readonly ["S", "M", "L", "XL"];
+export type KasseSchrift = typeof SCHRIFT[number];
+export declare const WASSERZEICHEN: readonly ["aus", "anmeldung", "ueberall"];
+export type KasseWasserzeichen = typeof WASSERZEICHEN[number];
+export declare const MENGE: readonly ["aus", "x", "kg"];
+export type KasseMenge = typeof MENGE[number];
+export declare const TG_MODUS: readonly ["betrag", "gesamt", "beides"];
+export type KasseTgModus = typeof TG_MODUS[number];
+export declare const KASSIEREN_MODUS: readonly ["seite", "panel"];
+export type KasseKassierenModus = typeof KASSIEREN_MODUS[number];
 /** Kartenanbieter: Karte gibt es erst mit eingerichtetem Anbieter; 'extern' = eigenes Terminal ohne Anbindung. */
-export type KasseKartenanbieter = 'keiner' | 'extern' | 'hobex' | 'mypos' | 'stripe';
-export declare const KARTENANBIETER: readonly KasseKartenanbieter[];
-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';
-export type KassePapier = 'mm58' | 'mm80';
-export type KasseZeichensatz = 'CP1252' | 'CP437';
-export type KasseSchnitt = 'partial' | 'full' | 'none';
-export type KasseLadeAuto = 'bar' | 'immer' | 'nie';
+export declare const KARTENANBIETER: readonly ["keiner", "extern", "gptom", "hobex", "mypos", "stripe"];
+export type KasseKartenanbieter = typeof KARTENANBIETER[number];
+export declare const BELEG_AUSGABE: readonly ["qr", "druck", "mail", "sms", "fragen"];
+export type KasseBelegAusgabe = typeof BELEG_AUSGABE[number];
+export declare const LAYOUT: readonly ["rechts", "links", "vollbild"];
+export type KasseLayout = typeof LAYOUT[number];
+export declare const KATPOS: readonly ["oben", "links"];
+export type KasseKatpos = typeof KATPOS[number];
+export declare const HOEHE: readonly ["S", "M", "L"];
+export type KasseHoehe = typeof HOEHE[number];
+/**
+ * `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 declare const DRUCKER_ART: readonly ["sdp", "netz", "bt", "usb", "connect"];
+export type KasseDruckerArt = typeof DRUCKER_ART[number];
+/** Terminal-Ansprache: direkt per IP (wie bisher) oder ueber Kasseneck Connect (Agent leitet weiter). */
+export declare const TERMINAL_VIA: readonly ["direkt", "connect"];
+export type KasseTerminalVia = typeof TERMINAL_VIA[number];
+/** Art des Kartenterminals an dieser Kasse: keines oder Hobex HPS (JSON-REST am Geraet). */
+export declare const TERMINAL_ART: readonly ["keins", "hps"];
+export type KasseTerminalArt = typeof TERMINAL_ART[number];
+export declare const PAPIER: readonly ["mm58", "mm80"];
+export type KassePapier = typeof PAPIER[number];
+export declare const ZEICHENSATZ: readonly ["CP1252", "CP437"];
+export type KasseZeichensatz = typeof ZEICHENSATZ[number];
+export declare const SCHNITT: readonly ["partial", "full", "none"];
+export type KasseSchnitt = typeof SCHNITT[number];
+export declare const LADE_AUTO: readonly ["bar", "immer", "nie"];
+export type KasseLadeAuto = typeof LADE_AUTO[number];
+/** Groesse des Kuerzel-Logos in der Kopfzeile der Kasse. */
+export declare const LOGO_GROESSE: readonly ["S", "M", "L"];
+export type KasseLogoGroesse = typeof LOGO_GROESSE[number];
+/** Schriftgroesse in den Chef-Einstellungen — getrennt von der Schrift der Kasse. */
+export declare const SCHRIFT_EINST: readonly ["S", "M", "L"];
+export type KasseSchriftEinst = typeof SCHRIFT_EINST[number];
+/** Kachel-Optik: farbiger Streifen am Rand oder ganz gefuellte Kachel. */
+export declare const KACHELSTIL: readonly ["streifen", "voll"];
+export type KasseKachelstil = typeof KACHELSTIL[number];
+/** Automatisches Abmelden nach Minuten Ruhe; 0 = nie. */
+export declare const AUTO_AB_MIN: readonly [0, 1, 5, 15, 30];
+export type KasseAutoAbMin = typeof AUTO_AB_MIN[number];
+/** Rabatt am Beleg erlaubt. */
+export declare const RABATT: readonly ["aus", "an"];
+export type KasseRabatt = typeof RABATT[number];
+/** Seite des Wasserzeichens — ALT, abgeloest von wzPos. */
+export declare const WZ_SEITE: readonly ["links", "mitte", "rechts"];
+export type KasseWzSeite = typeof WZ_SEITE[number];
+/** Deckkraft des Wasserzeichens in Prozent — bewusst Stufen, kein Schieberegler. */
+export declare const WZ_STAERKE: readonly [3, 6, 10, 16];
+export type KasseWzStaerke = typeof WZ_STAERKE[number];
+/** Groesse des Bild-Logos am Beleg. */
+export declare const LOGO_SKALA: readonly ["S", "M", "L", "XL"];
+export type KasseLogoSkala = typeof LOGO_SKALA[number];
+/** Groesse des Wasserzeichens — getrennt vom Beleg-Logo. */
+export declare const WZ_SKALA: readonly ["S", "M", "L", "XL"];
+export type KasseWzSkala = typeof WZ_SKALA[number];
+/** Wie lange die Fertig-Seite stehen bleibt, in Sekunden; 0 = bis zum Tippen. */
+export declare const FERTIG_SEKUNDEN: readonly [0, 3, 5, 10, 15, 30, 60];
+export type KasseFertigSekunden = typeof FERTIG_SEKUNDEN[number];
 /** Schalter-Landkarte: Steuersaetze / Trinkgeldstufen (Schluessel = Wert als Text). */
 export type Schalterkarte = Record<string, boolean>;
 export interface KasseSettingsBetrieb {
     logoText: string;
     logoAn: boolean;
-    logoGroesse: 'S' | 'M' | 'L';
+    logoGroesse: KasseLogoGroesse;
     wasserzeichen: KasseWasserzeichen;
     farbe: string;
     stil: KasseStil;
     schrift: KasseSchrift;
-    schriftEinst: 'S' | 'M' | 'L';
-    kachelstil: 'streifen' | 'voll';
+    schriftEinst: KasseSchriftEinst;
+    kachelstil: KasseKachelstil;
     uhr: boolean;
     sperrbild: boolean;
     foto: boolean;
-    autoAbMin: 0 | 1 | 5 | 15 | 30;
+    autoAbMin: KasseAutoAbMin;
     abNachVerkauf: boolean;
     /** Schnelles Entsperren mit gemerkter PIN (lokal, Server-Login laeuft nach); aus = streng, jeder Login wartet. */
     schnellLogin: boolean;
@@ -54,7 +108,21 @@ export interface KasseSettingsBetrieb {
     menge: KasseMenge;
     notiz: boolean;
     suche: boolean;
-    rabatt: 'aus' | 'an';
+    rabatt: KasseRabatt;
+    /** 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: KasseWzSeite;
+    /** 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: KasseWzStaerke;
+    /** Groesse des Bild-Logos am BELEG (Ansicht, PDF, Kopfzeile). */
+    logoSkala: KasseLogoSkala;
+    /** Groesse des Wasserzeichens — getrennt vom Beleg-Logo. */
+    wzSkala: KasseWzSkala;
     zahlBar: boolean;
     zahlKarte: boolean;
     kartenanbieter: KasseKartenanbieter;
@@ -67,12 +135,20 @@ 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;
+    fertigSekunden: KasseFertigSekunden;
+    /** 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 declare const KASSE_TASTEN_AKTIONEN: readonly KasseTastenAktion[];
+export declare const KASSE_TASTEN_AKTIONEN: readonly ["kassieren", "abschliessen", "abbrechen", "frei", "bar", "karte", "passend", "belege", "letzteZurueck", "einstellungen", "abmelden", "trinkgeld", "vollbild", "gegebenLeeren", "korbLeeren"];
+export type KasseTastenAktion = typeof KASSE_TASTEN_AKTIONEN[number];
+/** Kurzer Name, damit alle Enum-Listen gleich heissen; der alte bleibt gueltig. */
+export declare const TASTEN_AKTIONEN: readonly ["kassieren", "abschliessen", "abbrechen", "frei", "bar", "karte", "passend", "belege", "letzteZurueck", "einstellungen", "abmelden", "trinkgeld", "vollbild", "gegebenLeeren", "korbLeeren"];
 /** Tastenkarte: Aktion -> Tasten (`Mod+F`, `Enter`, `Escape`, `F5` ...; `Mod` = ⌘ auf dem Mac, Strg sonst). */
 export type KasseTastenkarte = Record<KasseTastenAktion, string[]>;
 export declare const KASSE_TASTEN_STANDARD: Readonly<KasseTastenkarte>;
@@ -89,10 +165,14 @@ export interface KasseSettingsGeraet {
     druckerIp: string;
     druckerPort: number;
     druckerBt: string;
+    /** Klartextname des gemerkten Druckers; sonst stuende dort eine nackte Bluetooth-Adresse. */
+    druckerName: string;
     /** Kennung des Netzwerk-Druckers (Server Direct Print) aus `listMyPrinters`; '' = keiner gewaehlt. */
     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 +180,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

@@ -9,17 +9,93 @@
  * bewusst AUS, bis die Buchung geklaert ist (Spec kachel-kasse § 9).
  */
 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.KASSE_GERAET_STANDARD = exports.KASSE_BETRIEB_STANDARD = exports.KASSE_TASTEN_STANDARD = exports.TASTEN_AKTIONEN = exports.KASSE_TASTEN_AKTIONEN = exports.FERTIG_SEKUNDEN = exports.WZ_SKALA = exports.LOGO_SKALA = exports.WZ_STAERKE = exports.WZ_SEITE = exports.RABATT = exports.AUTO_AB_MIN = exports.KACHELSTIL = exports.SCHRIFT_EINST = exports.LOGO_GROESSE = exports.LADE_AUTO = exports.SCHNITT = exports.ZEICHENSATZ = exports.PAPIER = exports.TERMINAL_ART = exports.TERMINAL_VIA = exports.DRUCKER_ART = exports.HOEHE = exports.KATPOS = exports.LAYOUT = exports.BELEG_AUSGABE = exports.KARTENANBIETER = exports.KASSIEREN_MODUS = exports.TG_MODUS = exports.MENGE = exports.WASSERZEICHEN = exports.SCHRIFT = exports.STIL = 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'];
+/*
+ * Jedes Enum steht als Liste zur Laufzeit da, der Typ leitet sich daraus ab
+ * (`typeof LISTE[number]`). So gibt es die Werte nur einmal, und die Zwillinge
+ * (Backend-Validator, Flutter-Paket) koennen gegen dieselben Listen pruefen,
+ * statt sie abzuschreiben.
+ */
+exports.STIL = ['klar', 'warm', 'nacht', 'kontrast'];
+exports.SCHRIFT = ['S', 'M', 'L', 'XL'];
+exports.WASSERZEICHEN = ['aus', 'anmeldung', 'ueberall'];
+exports.MENGE = ['aus', 'x', 'kg'];
+exports.TG_MODUS = ['betrag', 'gesamt', 'beides'];
+exports.KASSIEREN_MODUS = ['seite', 'panel'];
+/** Kartenanbieter: Karte gibt es erst mit eingerichtetem Anbieter; 'extern' = eigenes Terminal ohne Anbindung. */
+exports.KARTENANBIETER = ['keiner', 'extern', 'gptom', 'hobex', 'mypos', 'stripe'];
+exports.BELEG_AUSGABE = ['qr', 'druck', 'mail', 'sms', 'fragen'];
+exports.LAYOUT = ['rechts', 'links', 'vollbild'];
+exports.KATPOS = ['oben', 'links'];
+exports.HOEHE = ['S', 'M', 'L'];
+/**
+ * `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).
+ */
+exports.DRUCKER_ART = ['sdp', 'netz', 'bt', 'usb', 'connect'];
+/** Terminal-Ansprache: direkt per IP (wie bisher) oder ueber Kasseneck Connect (Agent leitet weiter). */
+exports.TERMINAL_VIA = ['direkt', 'connect'];
+/** Art des Kartenterminals an dieser Kasse: keines oder Hobex HPS (JSON-REST am Geraet). */
+exports.TERMINAL_ART = ['keins', 'hps'];
+exports.PAPIER = ['mm58', 'mm80'];
+exports.ZEICHENSATZ = ['CP1252', 'CP437'];
+exports.SCHNITT = ['partial', 'full', 'none'];
+exports.LADE_AUTO = ['bar', 'immer', 'nie'];
+/*
+ * Auch die uebrigen Wertemengen der Einstellungen stehen jetzt als Liste da —
+ * vorher waren sie nur als Union am Feld ausgeschrieben. Ein Zwilling konnte
+ * dadurch einen Wert (etwa `kachelstil: 'voll'`) gar nicht kennen, ohne dass es
+ * auffiel: der Vertrag fuehrte die Menge nicht, und die Standardwerte-Datei
+ * pinnt je Feld nur einen einzigen Wert.
+ */
+/** Groesse des Kuerzel-Logos in der Kopfzeile der Kasse. */
+exports.LOGO_GROESSE = ['S', 'M', 'L'];
+/** Schriftgroesse in den Chef-Einstellungen — getrennt von der Schrift der Kasse. */
+exports.SCHRIFT_EINST = ['S', 'M', 'L'];
+/** Kachel-Optik: farbiger Streifen am Rand oder ganz gefuellte Kachel. */
+exports.KACHELSTIL = ['streifen', 'voll'];
+/** Automatisches Abmelden nach Minuten Ruhe; 0 = nie. */
+exports.AUTO_AB_MIN = [0, 1, 5, 15, 30];
+/** Rabatt am Beleg erlaubt. */
+exports.RABATT = ['aus', 'an'];
+/** Seite des Wasserzeichens — ALT, abgeloest von wzPos. */
+exports.WZ_SEITE = ['links', 'mitte', 'rechts'];
+/** Deckkraft des Wasserzeichens in Prozent — bewusst Stufen, kein Schieberegler. */
+exports.WZ_STAERKE = [3, 6, 10, 16];
+/** Groesse des Bild-Logos am Beleg. */
+exports.LOGO_SKALA = ['S', 'M', 'L', 'XL'];
+/** Groesse des Wasserzeichens — getrennt vom Beleg-Logo. */
+exports.WZ_SKALA = ['S', 'M', 'L', 'XL'];
+/** Wie lange die Fertig-Seite stehen bleibt, in Sekunden; 0 = bis zum Tippen. */
+exports.FERTIG_SEKUNDEN = [0, 3, 5, 10, 15, 30, 60];
+/** Aktionen der Kasse, die eine Taste bekommen koennen. */
+exports.KASSE_TASTEN_AKTIONEN = ['kassieren', 'abschliessen', 'abbrechen', 'frei', 'bar', 'karte', 'passend', 'belege', 'letzteZurueck', 'einstellungen', 'abmelden', 'trinkgeld', 'vollbild', 'gegebenLeeren', 'korbLeeren'];
+/** Kurzer Name, damit alle Enum-Listen gleich heissen; der alte bleibt gueltig. */
+exports.TASTEN_AKTIONEN = exports.KASSE_TASTEN_AKTIONEN;
 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',
+    // Petrol aus der Markenpalette ("Ecke, Aktion") — nicht das alte Blau.
+    logoText: 'K', logoAn: true, logoGroesse: 'M', wasserzeichen: 'anmeldung', farbe: '#116B6B',
     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 +104,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',
+    druckerAn: false, druckerArt: 'sdp', druckerIp: '', druckerPort: 9100, druckerBt: '', druckerName: '', 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/payments/hobex.d.ts

@@ -1,5 +1,5 @@
 import { type HobexReceipt } from '../models/index.js';
-import type { KasseneckTransport } from '../client/transport.js';
+import type { InternerTransport } from '../client/aufrufe.js';
 /**
  * Cent -> Euro. **Die einzige Umrechnungsstelle dieses Moduls.** Betraege
  * werden im ganzen Paket in Cent gefuehrt (exakte Ganzzahl-Arithmetik); die
@@ -46,7 +46,7 @@ export interface HobexTransactionIdOptions {
  * **Der Endpunkt heisst `hobexPayApi`** — mit Suffix; ohne ihn gibt es ihn
  * nicht.
  */
-export declare function hobexPay(rufen: KasseneckTransport, options: HobexPayOptions): Promise<HobexReceipt>;
+export declare function hobexPay(rufen: InternerTransport, options: HobexPayOptions): Promise<HobexReceipt>;
 /**
  * Erstattet eine zuvor ueber die Hobex-Cloud getaetigte Zahlung. Das Backend
  * storniert zuerst (Void, solange der Tagesabschluss aussteht) und erstattet
@@ -61,7 +61,7 @@ export declare function hobexPay(rufen: KasseneckTransport, options: HobexPayOpt
  *
  * **Der Endpunkt heisst `hobexRefundApi`** — mit Suffix.
  */
-export declare function hobexRefund(rufen: KasseneckTransport, options: HobexRefundOptions): Promise<void>;
+export declare function hobexRefund(rufen: InternerTransport, options: HobexRefundOptions): Promise<void>;
 /**
  * Erzeugt eine neue Hobex-Transaktionskennung: 19 Ziffern aus Zeitanteil und
  * Zufall (Zwilling von `newHobexTransactionId` im Vorbild, Zeile 522).

package/dist/cjs/payments/stripe.d.ts

@@ -1,6 +1,6 @@
 import { StripeLinkMode, type StripeLinkModeKey } from '../enums/index.js';
 import { type ReceiptItem, type StripeUrlSession } from '../models/index.js';
-import type { KasseneckTransport } from '../client/transport.js';
+import type { InternerTransport } from '../client/aufrufe.js';
 export interface CreateStripeLinkOptions {
     /** Positionen des Zahlungslinks; mindestens eine, alle gueltig. */
     items: ReceiptItem[];
@@ -50,7 +50,7 @@ export interface StripeCaptureResult {
  * Methodenname und Endpunktname fallen wie schon beim Monatsbericht
  * auseinander (siehe client/reports.ts).
  */
-export declare function createStripeLink(rufen: KasseneckTransport, options: CreateStripeLinkOptions): Promise<StripeUrlSession>;
+export declare function createStripeLink(rufen: InternerTransport, options: CreateStripeLinkOptions): Promise<StripeUrlSession>;
 /**
  * Zieht die zuvor nur reservierte Zahlung einer `authorization`-Sitzung ein.
  *
@@ -58,4 +58,4 @@ export declare function createStripeLink(rufen: KasseneckTransport, options: Cre
  * das Vorbild und so das Backend. Der naheliegende Singular waere ein fehlender
  * Pflichtparameter.
  */
-export declare function stripeCaptureIntent(rufen: KasseneckTransport, stripeSessionId: string): Promise<StripeCaptureResult>;
+export declare function stripeCaptureIntent(rufen: InternerTransport, stripeSessionId: string): Promise<StripeCaptureResult>;

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':