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

package/dist/cjs/pos/index.js

@@ -0,0 +1,102 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getPosSettings = exports.allowedQuantity = exports.quantityDefaults = exports.quantityRuleForUnit = exports.QUANTITY_RULES = exports.listMyArticles = exports.listMyArticleGroups = exports.fromPosArticlePayload = exports.fromArticleGroupPayload = exports.DONE_SCREEN_SECONDS = exports.WATERMARK_SCALE = exports.LOGO_SCALE = exports.WATERMARK_STRENGTH = exports.WATERMARK_SIDE = exports.DISCOUNT = exports.AUTO_LOGOUT_MINUTES = exports.TILE_STYLE = exports.SETTINGS_FONT_SIZE = exports.LOGO_SIZE = exports.QR_MODE = exports.DRAWER_AUTO_OPEN = exports.CUT = exports.CODE_PAGE = exports.PAPER_SIZE = exports.TERMINAL_TYPE = exports.TERMINAL_VIA = exports.PRINTER_TYPE = exports.TILE_HEIGHT = exports.CATEGORY_POSITION = exports.LAYOUT = exports.RECEIPT_OUTPUT = exports.CARD_PROVIDER = exports.CHECKOUT_MODE = exports.TIP_MODE = exports.QUANTITY = exports.WATERMARK = exports.FONT_SIZE = exports.THEME = exports.posShortcutConflict = exports.POS_SHORTCUT_SHARED_PAIRS = exports.posSettingsChanges = exports.unknownPosSettingValues = exports.sanitizePosSettings = exports.mergePosSettings = exports.POS_DEVICE_VALUES = exports.POS_BUSINESS_VALUES = exports.POS_DEVICE_DEFAULTS = exports.POS_BUSINESS_DEFAULTS = exports.POS_SHORTCUT_DEFAULTS = exports.POS_SHORTCUT_ACTIONS = void 0;
+exports.labelText = exports.LABELS = exports.cancellationPaymentErrorMessage = exports.CANCELLATION_PAYMENT_ERROR_MESSAGES = exports.receiptEmailErrorMessage = exports.RECEIPT_EMAIL_ERROR_MESSAGES = exports.messageAppliesTo = exports.messageText = exports.ERROR_RULES = exports.MESSAGES = exports.listMyTipRecipients = exports.getPrintJob = exports.createPrintJob = exports.listMyPrinters = exports.isPrintJobFinished = exports.PRINT_JOB_SOURCES = exports.PRINT_JOB_STATUSES = exports.receiptsScopeOf = exports.cancelScopeOf = exports.distributeDiscount = exports.posFieldErrors = exports.isPosError = exports.posErrorCode = exports.isPosErrorCode = exports.POS_ERROR_CODES = exports.posSettingsFromWire = exports.setMyPosLogo = exports.setMyRegisterDeviceSettings = exports.setMyPosSettings = void 0;
+/**
+ * Kachel-Kasse: Einstellungen, Artikelgruppen/Artikel fuer Kacheln,
+ * Rabattverteilung, Drucker, Trinkgeld-Empfaenger. Die Aufrufe heissen 1:1 wie
+ * die Backend-Functions (die Rewrites-Waechter der Web-App leiten daraus ab)
+ * und sprechen den Kassenweg `/api/v3` (Schluessel und Werte englisch).
+ */
+var settings_js_1 = require("./settings.js");
+Object.defineProperty(exports, "POS_SHORTCUT_ACTIONS", { enumerable: true, get: function () { return settings_js_1.POS_SHORTCUT_ACTIONS; } });
+Object.defineProperty(exports, "POS_SHORTCUT_DEFAULTS", { enumerable: true, get: function () { return settings_js_1.POS_SHORTCUT_DEFAULTS; } });
+Object.defineProperty(exports, "POS_BUSINESS_DEFAULTS", { enumerable: true, get: function () { return settings_js_1.POS_BUSINESS_DEFAULTS; } });
+Object.defineProperty(exports, "POS_DEVICE_DEFAULTS", { enumerable: true, get: function () { return settings_js_1.POS_DEVICE_DEFAULTS; } });
+Object.defineProperty(exports, "POS_BUSINESS_VALUES", { enumerable: true, get: function () { return settings_js_1.POS_BUSINESS_VALUES; } });
+Object.defineProperty(exports, "POS_DEVICE_VALUES", { enumerable: true, get: function () { return settings_js_1.POS_DEVICE_VALUES; } });
+Object.defineProperty(exports, "mergePosSettings", { enumerable: true, get: function () { return settings_js_1.mergePosSettings; } });
+Object.defineProperty(exports, "sanitizePosSettings", { enumerable: true, get: function () { return settings_js_1.sanitizePosSettings; } });
+Object.defineProperty(exports, "unknownPosSettingValues", { enumerable: true, get: function () { return settings_js_1.unknownPosSettingValues; } });
+Object.defineProperty(exports, "posSettingsChanges", { enumerable: true, get: function () { return settings_js_1.posSettingsChanges; } });
+Object.defineProperty(exports, "POS_SHORTCUT_SHARED_PAIRS", { enumerable: true, get: function () { return settings_js_1.POS_SHORTCUT_SHARED_PAIRS; } });
+Object.defineProperty(exports, "posShortcutConflict", { enumerable: true, get: function () { return settings_js_1.posShortcutConflict; } });
+// Die Enums als Laufzeitlisten, benannt nach ihrem Feld.
+Object.defineProperty(exports, "THEME", { enumerable: true, get: function () { return settings_js_1.THEME; } });
+Object.defineProperty(exports, "FONT_SIZE", { enumerable: true, get: function () { return settings_js_1.FONT_SIZE; } });
+Object.defineProperty(exports, "WATERMARK", { enumerable: true, get: function () { return settings_js_1.WATERMARK; } });
+Object.defineProperty(exports, "QUANTITY", { enumerable: true, get: function () { return settings_js_1.QUANTITY; } });
+Object.defineProperty(exports, "TIP_MODE", { enumerable: true, get: function () { return settings_js_1.TIP_MODE; } });
+Object.defineProperty(exports, "CHECKOUT_MODE", { enumerable: true, get: function () { return settings_js_1.CHECKOUT_MODE; } });
+Object.defineProperty(exports, "CARD_PROVIDER", { enumerable: true, get: function () { return settings_js_1.CARD_PROVIDER; } });
+Object.defineProperty(exports, "RECEIPT_OUTPUT", { enumerable: true, get: function () { return settings_js_1.RECEIPT_OUTPUT; } });
+Object.defineProperty(exports, "LAYOUT", { enumerable: true, get: function () { return settings_js_1.LAYOUT; } });
+Object.defineProperty(exports, "CATEGORY_POSITION", { enumerable: true, get: function () { return settings_js_1.CATEGORY_POSITION; } });
+Object.defineProperty(exports, "TILE_HEIGHT", { enumerable: true, get: function () { return settings_js_1.TILE_HEIGHT; } });
+Object.defineProperty(exports, "PRINTER_TYPE", { enumerable: true, get: function () { return settings_js_1.PRINTER_TYPE; } });
+Object.defineProperty(exports, "TERMINAL_VIA", { enumerable: true, get: function () { return settings_js_1.TERMINAL_VIA; } });
+Object.defineProperty(exports, "TERMINAL_TYPE", { enumerable: true, get: function () { return settings_js_1.TERMINAL_TYPE; } });
+Object.defineProperty(exports, "PAPER_SIZE", { enumerable: true, get: function () { return settings_js_1.PAPER_SIZE; } });
+Object.defineProperty(exports, "CODE_PAGE", { enumerable: true, get: function () { return settings_js_1.CODE_PAGE; } });
+Object.defineProperty(exports, "CUT", { enumerable: true, get: function () { return settings_js_1.CUT; } });
+Object.defineProperty(exports, "DRAWER_AUTO_OPEN", { enumerable: true, get: function () { return settings_js_1.DRAWER_AUTO_OPEN; } });
+Object.defineProperty(exports, "QR_MODE", { enumerable: true, get: function () { return settings_js_1.QR_MODE; } });
+Object.defineProperty(exports, "LOGO_SIZE", { enumerable: true, get: function () { return settings_js_1.LOGO_SIZE; } });
+Object.defineProperty(exports, "SETTINGS_FONT_SIZE", { enumerable: true, get: function () { return settings_js_1.SETTINGS_FONT_SIZE; } });
+Object.defineProperty(exports, "TILE_STYLE", { enumerable: true, get: function () { return settings_js_1.TILE_STYLE; } });
+Object.defineProperty(exports, "AUTO_LOGOUT_MINUTES", { enumerable: true, get: function () { return settings_js_1.AUTO_LOGOUT_MINUTES; } });
+Object.defineProperty(exports, "DISCOUNT", { enumerable: true, get: function () { return settings_js_1.DISCOUNT; } });
+Object.defineProperty(exports, "WATERMARK_SIDE", { enumerable: true, get: function () { return settings_js_1.WATERMARK_SIDE; } });
+Object.defineProperty(exports, "WATERMARK_STRENGTH", { enumerable: true, get: function () { return settings_js_1.WATERMARK_STRENGTH; } });
+Object.defineProperty(exports, "LOGO_SCALE", { enumerable: true, get: function () { return settings_js_1.LOGO_SCALE; } });
+Object.defineProperty(exports, "WATERMARK_SCALE", { enumerable: true, get: function () { return settings_js_1.WATERMARK_SCALE; } });
+Object.defineProperty(exports, "DONE_SCREEN_SECONDS", { enumerable: true, get: function () { return settings_js_1.DONE_SCREEN_SECONDS; } });
+var artikel_js_1 = require("./artikel.js");
+Object.defineProperty(exports, "fromArticleGroupPayload", { enumerable: true, get: function () { return artikel_js_1.fromArticleGroupPayload; } });
+Object.defineProperty(exports, "fromPosArticlePayload", { enumerable: true, get: function () { return artikel_js_1.fromPosArticlePayload; } });
+Object.defineProperty(exports, "listMyArticleGroups", { enumerable: true, get: function () { return artikel_js_1.listMyArticleGroups; } });
+Object.defineProperty(exports, "listMyArticles", { enumerable: true, get: function () { return artikel_js_1.listMyArticles; } });
+Object.defineProperty(exports, "QUANTITY_RULES", { enumerable: true, get: function () { return artikel_js_1.QUANTITY_RULES; } });
+Object.defineProperty(exports, "quantityRuleForUnit", { enumerable: true, get: function () { return artikel_js_1.quantityRuleForUnit; } });
+Object.defineProperty(exports, "quantityDefaults", { enumerable: true, get: function () { return artikel_js_1.quantityDefaults; } });
+Object.defineProperty(exports, "allowedQuantity", { enumerable: true, get: function () { return artikel_js_1.allowedQuantity; } });
+var client_js_1 = require("./client.js");
+Object.defineProperty(exports, "getPosSettings", { enumerable: true, get: function () { return client_js_1.getPosSettings; } });
+Object.defineProperty(exports, "setMyPosSettings", { enumerable: true, get: function () { return client_js_1.setMyPosSettings; } });
+Object.defineProperty(exports, "setMyRegisterDeviceSettings", { enumerable: true, get: function () { return client_js_1.setMyRegisterDeviceSettings; } });
+Object.defineProperty(exports, "setMyPosLogo", { enumerable: true, get: function () { return client_js_1.setMyPosLogo; } });
+Object.defineProperty(exports, "posSettingsFromWire", { enumerable: true, get: function () { return client_js_1.posSettingsFromWire; } });
+var errors_js_1 = require("./errors.js");
+Object.defineProperty(exports, "POS_ERROR_CODES", { enumerable: true, get: function () { return errors_js_1.POS_ERROR_CODES; } });
+Object.defineProperty(exports, "isPosErrorCode", { enumerable: true, get: function () { return errors_js_1.isPosErrorCode; } });
+Object.defineProperty(exports, "posErrorCode", { enumerable: true, get: function () { return errors_js_1.posErrorCode; } });
+Object.defineProperty(exports, "isPosError", { enumerable: true, get: function () { return errors_js_1.isPosError; } });
+Object.defineProperty(exports, "posFieldErrors", { enumerable: true, get: function () { return errors_js_1.posFieldErrors; } });
+var discount_js_1 = require("../receipt/discount.js");
+Object.defineProperty(exports, "distributeDiscount", { enumerable: true, get: function () { return discount_js_1.distributeDiscount; } });
+// Reichweiten der Kassen-Rechte (Migration wie im Backend) -- bewusst NICHT im
+// Register-Unterpfad: dessen Exportnamen sind 1:1 Function-Namen (Rewrites).
+var pairing_js_1 = require("../register/pairing.js");
+Object.defineProperty(exports, "cancelScopeOf", { enumerable: true, get: function () { return pairing_js_1.cancelScopeOf; } });
+Object.defineProperty(exports, "receiptsScopeOf", { enumerable: true, get: function () { return pairing_js_1.receiptsScopeOf; } });
+var drucker_js_1 = require("./drucker.js");
+Object.defineProperty(exports, "PRINT_JOB_STATUSES", { enumerable: true, get: function () { return drucker_js_1.PRINT_JOB_STATUSES; } });
+Object.defineProperty(exports, "PRINT_JOB_SOURCES", { enumerable: true, get: function () { return drucker_js_1.PRINT_JOB_SOURCES; } });
+Object.defineProperty(exports, "isPrintJobFinished", { enumerable: true, get: function () { return drucker_js_1.isPrintJobFinished; } });
+Object.defineProperty(exports, "listMyPrinters", { enumerable: true, get: function () { return drucker_js_1.listMyPrinters; } });
+Object.defineProperty(exports, "createPrintJob", { enumerable: true, get: function () { return drucker_js_1.createPrintJob; } });
+Object.defineProperty(exports, "getPrintJob", { enumerable: true, get: function () { return drucker_js_1.getPrintJob; } });
+var trinkgeld_js_1 = require("./trinkgeld.js");
+Object.defineProperty(exports, "listMyTipRecipients", { enumerable: true, get: function () { return trinkgeld_js_1.listMyTipRecipients; } });
+// Was die Kasse selbst sagt: ein Katalog fuer Browser-Kasse und App.
+var texte_js_1 = require("./texte.js");
+Object.defineProperty(exports, "MESSAGES", { enumerable: true, get: function () { return texte_js_1.MESSAGES; } });
+Object.defineProperty(exports, "ERROR_RULES", { enumerable: true, get: function () { return texte_js_1.ERROR_RULES; } });
+Object.defineProperty(exports, "messageText", { enumerable: true, get: function () { return texte_js_1.messageText; } });
+Object.defineProperty(exports, "messageAppliesTo", { enumerable: true, get: function () { return texte_js_1.messageAppliesTo; } });
+Object.defineProperty(exports, "RECEIPT_EMAIL_ERROR_MESSAGES", { enumerable: true, get: function () { return texte_js_1.RECEIPT_EMAIL_ERROR_MESSAGES; } });
+Object.defineProperty(exports, "receiptEmailErrorMessage", { enumerable: true, get: function () { return texte_js_1.receiptEmailErrorMessage; } });
+Object.defineProperty(exports, "CANCELLATION_PAYMENT_ERROR_MESSAGES", { enumerable: true, get: function () { return texte_js_1.CANCELLATION_PAYMENT_ERROR_MESSAGES; } });
+Object.defineProperty(exports, "cancellationPaymentErrorMessage", { enumerable: true, get: function () { return texte_js_1.cancellationPaymentErrorMessage; } });
+Object.defineProperty(exports, "LABELS", { enumerable: true, get: function () { return texte_js_1.LABELS; } });
+Object.defineProperty(exports, "labelText", { enumerable: true, get: function () { return texte_js_1.labelText; } });

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

@@ -0,0 +1,313 @@
+/**
+ * Kassen-Einstellungen der Browser-Kasse und der Kassen-App in der Form des
+ * Drahts `/api/v3` (Nachtrag Stufe 4, §11.7.2): Schluessel und Katalogwerte
+ * englisch. Zwilling von `functions-kasse/kasse-settings-core.js` (Backend,
+ * dort mit Validator und in der inneren, deutschen Form).
+ *
+ * Betriebsweit (`business`, am Konto) und je Geraet (`device`). Die
+ * Standardwerte stehen hier UND im Backend; `fixtures/pos-settings-defaults.json`
+ * ist aus dem Vertrags-Export abgeleitet (Antwort fuer ein Konto ohne
+ * gespeicherte Einstellungen) und haelt beide deckungsgleich. Die innere Form
+ * derselben Werte liegt unter `fixtures/stored/`. Trinkgeld ist bewusst AUS,
+ * bis die Buchung geklaert ist (Spec kachel-kasse § 9).
+ */
+export declare const THEME: readonly ["clear", "warm", "night", "contrast"];
+export type PosTheme = typeof THEME[number];
+export declare const FONT_SIZE: readonly ["S", "M", "L", "XL"];
+export type PosFontSize = typeof FONT_SIZE[number];
+export declare const WATERMARK: readonly ["off", "login", "everywhere"];
+export type PosWatermark = typeof WATERMARK[number];
+export declare const QUANTITY: readonly ["off", "x", "kg"];
+export type PosQuantity = typeof QUANTITY[number];
+export declare const TIP_MODE: readonly ["amount", "total", "both"];
+export type PosTipMode = typeof TIP_MODE[number];
+export declare const CHECKOUT_MODE: readonly ["page", "panel"];
+export type PosCheckoutMode = typeof CHECKOUT_MODE[number];
+/** Kartenanbieter: Karte gibt es erst mit eingerichtetem Anbieter; 'external' = eigenes Terminal ohne Anbindung. */
+export declare const CARD_PROVIDER: readonly ["none", "external", "gptom", "hobex", "mypos", "stripe"];
+export type PosCardProvider = typeof CARD_PROVIDER[number];
+export declare const RECEIPT_OUTPUT: readonly ["qr", "print", "email", "sms", "ask"];
+export type PosReceiptOutput = typeof RECEIPT_OUTPUT[number];
+export declare const LAYOUT: readonly ["right", "left", "fullscreen"];
+export type PosLayout = typeof LAYOUT[number];
+export declare const CATEGORY_POSITION: readonly ["top", "left"];
+export type PosCategoryPosition = typeof CATEGORY_POSITION[number];
+export declare const TILE_HEIGHT: readonly ["S", "M", "L"];
+export type PosTileHeight = typeof TILE_HEIGHT[number];
+/**
+ * `sdp` = Netzwerk ueber Epson Server Direct Print (der Drucker holt Jobs vom Backend, jeder Browser druckt).
+ * `network` = Epson direkt per IP (ePOS). `connect` = Kasseneck Connect (lokaler
+ * Agent auf dem Kassen-Rechner druckt fuer die Browser-Kasse).
+ */
+export declare const PRINTER_TYPE: readonly ["sdp", "network", "bluetooth", "usb", "connect"];
+export type PosPrinterType = typeof PRINTER_TYPE[number];
+/** Terminal-Ansprache: direkt per IP oder ueber Kasseneck Connect (Agent leitet weiter). */
+export declare const TERMINAL_VIA: readonly ["direct", "connect"];
+export type PosTerminalVia = typeof TERMINAL_VIA[number];
+/** Art des Kartenterminals an dieser Kasse: keines oder Hobex HPS (JSON-REST am Geraet). */
+export declare const TERMINAL_TYPE: readonly ["none", "hps"];
+export type PosTerminalType = typeof TERMINAL_TYPE[number];
+export declare const PAPER_SIZE: readonly ["mm58", "mm80"];
+export type PosPaperSize = typeof PAPER_SIZE[number];
+export declare const CODE_PAGE: readonly ["CP1252", "CP437"];
+export type PosCodePage = typeof CODE_PAGE[number];
+export declare const CUT: readonly ["partial", "full", "none"];
+export type PosCut = typeof CUT[number];
+export declare const DRAWER_AUTO_OPEN: readonly ["cash", "always", "never"];
+export type PosDrawerAutoOpen = typeof DRAWER_AUTO_OPEN[number];
+/**
+ * Mit welchem Befehl der Signatur-QR auf den Bon kommt.
+ *
+ * `raster` = der QR wird als Bild gerastert (GS v 0) und geht darum durch jeden
+ * Drucker, der Bilder kann. `escpos` = der native QR-Befehl (GS ( k): schaerfer
+ * und schneller, aber aeltere Geraete drucken dann gar keinen QR oder
+ * Zeichensalat.
+ *
+ * `auto` ist die Vorgabe und heisst **unbestimmt**: an diesem Geraet hat noch
+ * niemand am Papier entschieden. Jede Kasse bleibt dann bei ihrer bisherigen
+ * Praxis, die Browser-Kasse beim ESC/POS-Befehl, die App beim Rasterbild.
+ * Eine harte Vorgabe waere hier eine stille Umstellung des Altbestands
+ * gewesen: jedes Geraet, das nie durch den Drucker-Wizard lief, druckte
+ * ploetzlich anders, und ueber BLE kostet ein Rasterbild mehrere Sekunden je
+ * Bon. Nur ein ausdruecklich gesetzter Wert aendert etwas.
+ *
+ * **Eine Geraete-Einstellung, keine des Betriebs:** derselbe Bon kommt an einer
+ * Kasse sauber heraus und an der Nebenkasse nicht. Und sie ist nicht
+ * kosmetisch: nach § 132a BAO ist der QR Teil des Belegs; wer den falschen
+ * Modus stehen laesst, erteilt Belege ohne lesbare Signatur.
+ */
+export declare const QR_MODE: readonly ["auto", "raster", "escpos"];
+export type PosQrMode = typeof QR_MODE[number];
+/** Groesse des Kuerzel-Logos in der Kopfzeile der Kasse. */
+export declare const LOGO_SIZE: readonly ["S", "M", "L"];
+export type PosLogoSize = typeof LOGO_SIZE[number];
+/** Schriftgroesse in den Chef-Einstellungen, getrennt von der Schrift der Kasse. */
+export declare const SETTINGS_FONT_SIZE: readonly ["S", "M", "L"];
+export type PosSettingsFontSize = typeof SETTINGS_FONT_SIZE[number];
+/** Kachel-Optik: farbiger Streifen am Rand oder ganz gefuellte Kachel. */
+export declare const TILE_STYLE: readonly ["stripe", "full"];
+export type PosTileStyle = typeof TILE_STYLE[number];
+/** Automatisches Abmelden nach Minuten Ruhe; 0 = nie. */
+export declare const AUTO_LOGOUT_MINUTES: readonly [0, 1, 5, 15, 30];
+export type PosAutoLogoutMinutes = typeof AUTO_LOGOUT_MINUTES[number];
+/** Rabatt am Beleg erlaubt. */
+export declare const DISCOUNT: readonly ["off", "on"];
+export type PosDiscount = typeof DISCOUNT[number];
+/** Seite des Wasserzeichens; ALT, abgeloest von watermarkX. */
+export declare const WATERMARK_SIDE: readonly ["left", "center", "right"];
+export type PosWatermarkSide = typeof WATERMARK_SIDE[number];
+/** Deckkraft des Wasserzeichens in Prozent, bewusst Stufen, kein Schieberegler. */
+export declare const WATERMARK_STRENGTH: readonly [3, 6, 10, 16];
+export type PosWatermarkStrength = typeof WATERMARK_STRENGTH[number];
+/** Groesse des Bild-Logos am Beleg. */
+export declare const LOGO_SCALE: readonly ["S", "M", "L", "XL"];
+export type PosLogoScale = typeof LOGO_SCALE[number];
+/** Groesse des Wasserzeichens, getrennt vom Beleg-Logo. */
+export declare const WATERMARK_SCALE: readonly ["S", "M", "L", "XL"];
+export type PosWatermarkScale = typeof WATERMARK_SCALE[number];
+/** Wie lange die Fertig-Seite stehen bleibt, in Sekunden; 0 = bis zum Tippen. */
+export declare const DONE_SCREEN_SECONDS: readonly [0, 3, 5, 10, 15, 30, 60];
+export type PosDoneScreenSeconds = typeof DONE_SCREEN_SECONDS[number];
+/** Schalter-Landkarte: Steuersaetze / Trinkgeldstufen (Schluessel = Wert als Text, z. B. `'4.9'`). */
+export type PosToggleMap = Record<string, boolean>;
+/**
+ * Ein Feld mit Wertemenge, offen fuer Werte, die dieses Paket (noch) nicht
+ * kennt. Kommt vom Server ein neuer Wert (etwa `theme: 'sepia'`), bleibt er im
+ * Modell stehen und geht bei einem Teil-Schreiben nie verloren (der Server
+ * mischt); [unknownPosSettingValues] zeigt, welche Felder das betrifft.
+ */
+export type PosOpen<T extends string | number> = T | (T extends string ? (string & {}) : (number & {}));
+export interface PosBusinessSettings {
+    logoText: string;
+    logoEnabled: boolean;
+    logoSize: PosOpen<PosLogoSize>;
+    watermark: PosOpen<PosWatermark>;
+    color: string;
+    theme: PosOpen<PosTheme>;
+    fontSize: PosOpen<PosFontSize>;
+    settingsFontSize: PosOpen<PosSettingsFontSize>;
+    tileStyle: PosOpen<PosTileStyle>;
+    clock: boolean;
+    lockScreen: boolean;
+    /** Fotos der Mitarbeiter am Anmeldebildschirm zeigen. */
+    staffPhotos: boolean;
+    autoLogoutMinutes: PosOpen<PosAutoLogoutMinutes>;
+    logoutAfterSale: boolean;
+    /** Schnelles Entsperren mit gemerkter PIN (lokal, Server-Login laeuft nach); aus = streng, jeder Login wartet. */
+    fastLogin: boolean;
+    showPrices: boolean;
+    showVat: boolean;
+    emoji: boolean;
+    categoryColors: boolean;
+    customAmountAllowed: boolean;
+    /**
+     * Steuersaetze an der Kasse. Unter `/v3` **immer die ganze Karte senden**
+     * (Nachtrag §11.7.2): das Backend verlangt mindestens einen Satz an und
+     * liest vor dem Pruefen nicht nach.
+     */
+    vatRates: PosToggleMap;
+    quantity: PosOpen<PosQuantity>;
+    note: boolean;
+    search: boolean;
+    discount: PosOpen<PosDiscount>;
+    /** Bild-Logo (Download-URL aus dem Kasse-Upload); '' = Kuerzel verwenden. */
+    logoImage: string;
+    /** Seite des Wasserzeichens; ALT: abgeloest von watermarkX, bleibt fuers Mischen alter Staende. */
+    watermarkSide: PosOpen<PosWatermarkSide>;
+    /** Horizontale Lage der Wasserzeichen-MITTE in Prozent (-25 bis 125, darf ueber den Rand hinaus). */
+    watermarkX: number;
+    /** Vertikale Lage der Wasserzeichen-Mitte in Prozent (-25 bis 125). */
+    watermarkY: number;
+    /** Deckkraft des Wasserzeichens in Prozent, bewusst Stufen, kein Schieberegler. */
+    watermarkStrength: PosOpen<PosWatermarkStrength>;
+    /** Groesse des Bild-Logos am BELEG (Ansicht, PDF, Kopfzeile). */
+    logoScale: PosOpen<PosLogoScale>;
+    /** Groesse des Wasserzeichens, getrennt vom Beleg-Logo. */
+    watermarkScale: PosOpen<PosWatermarkScale>;
+    payCash: boolean;
+    payCard: boolean;
+    cardProvider: PosOpen<PosCardProvider>;
+    tip: boolean;
+    tipMode: PosOpen<PosTipMode>;
+    tipSteps: PosToggleMap;
+    /** Trinkgeld-Feinheit (App); kein Leser in der Web-Kasse, der Name ist Vertrag. */
+    tipSplit: boolean;
+    /** Rueckgeld-Rechner. */
+    change: boolean;
+    /** „Bar passend": schliesst den Betrag ohne Eintippen bar ab. */
+    exactCash: boolean;
+    checkoutMode: PosOpen<PosCheckoutMode>;
+    /** Getrennt zahlen: dritter Knopf neben Bar und Karte, ein Beleg mit mehreren Zahlungen. */
+    paySplit: boolean;
+    /** Trinkgeld-Chips in Prozent (eine Nachkommastelle, max 5, eindeutig, Reihenfolge des Chefs). */
+    tipChips: number[];
+    /** Rabatt-Chips in Prozent, dieselben Regeln wie tipChips, vom Chef einstellbar. */
+    discountChips: number[];
+    receiptOutput: PosOpen<PosReceiptOutput>;
+    doneScreenSeconds: PosOpen<PosDoneScreenSeconds>;
+    /** Glas-Optik: Kacheln und Korb leicht durchscheinend (Wasserzeichen schimmert). */
+    glass: boolean;
+    /** Hilfetexte in den Chef-Einstellungen anzeigen. */
+    hints: boolean;
+}
+/** Aktionen der Kasse, die eine Taste bekommen koennen (Schluessel von `device.shortcuts`). */
+export declare const POS_SHORTCUT_ACTIONS: readonly ["checkout", "complete", "cancel", "customAmount", "cash", "card", "exactAmount", "receipts", "undoLast", "settings", "logout", "tip", "fullscreen", "clearTendered", "clearCart", "splitPayment"];
+export type PosShortcutAction = typeof POS_SHORTCUT_ACTIONS[number];
+/** Tastenkarte: Aktion -> Tasten (`Mod+F`, `Enter`, `Escape`, `F5` ...; `Mod` = ⌘ auf dem Mac, Strg sonst). */
+export type PosShortcutMap = Record<PosShortcutAction, string[]>;
+export declare const POS_SHORTCUT_DEFAULTS: Readonly<PosShortcutMap>;
+/**
+ * Aktionen, die sich eine Taste teilen duerfen (Backend `TASTEN_PAARE`): sie
+ * leben in verschiedenen Momenten, der Verteiler laesst die nicht zustaendige
+ * durchfallen. Jede andere Doppelbelegung weist der Server ab, und dieses
+ * Paket schon vor dem Senden.
+ */
+export declare const POS_SHORTCUT_SHARED_PAIRS: readonly (readonly [PosShortcutAction, PosShortcutAction])[];
+/**
+ * Die erste Doppelbelegung einer Tastenkarte: `{ action, key, heldBy }` oder
+ * `null`. Geprueft wird die ganze Karte, so wie der Server sie nach dem
+ * Speichern haelt (er selbst prueft nur die gesendeten Eintraege).
+ */
+export declare function posShortcutConflict(shortcuts: Readonly<Record<string, readonly string[] | undefined>>): {
+    action: string;
+    key: string;
+    heldBy: string;
+} | null;
+export interface PosDeviceSettings {
+    layout: PosOpen<PosLayout>;
+    categoryPosition: PosOpen<PosCategoryPosition>;
+    extraColumns: number;
+    tileHeight: PosOpen<PosTileHeight>;
+    touch: boolean;
+    /** Tastenbelegung dieses Geraets (Vorgabe POS_SHORTCUT_DEFAULTS, je Aktion mischbar). */
+    shortcuts: PosShortcutMap;
+    printerEnabled: boolean;
+    printerType: PosOpen<PosPrinterType>;
+    printerIp: string;
+    printerPort: number;
+    printerBluetoothId: string;
+    /** Klartextname des gemerkten Druckers; sonst stuende dort eine nackte Bluetooth-Adresse. */
+    printerName: string;
+    /** Kennung des Netzwerk-Druckers (Server Direct Print) aus `listMyPrinters`; '' = keiner gewaehlt. */
+    printerId: string;
+    /** ePOS Device-ID bei `printerType 'network'` (Epson direkt per IP), Vorgabe `local_printer`. */
+    printerDeviceId: string;
+    /** Kennung des Druckers im lokalen Kasseneck-Connect-Agenten, bei `printerType 'connect'`. */
+    connectPrinterId: string;
+    paperSize: PosOpen<PosPaperSize>;
+    codePage: PosOpen<PosCodePage>;
+    cut: PosOpen<PosCut>;
+    /** Befehl fuer den Signatur-QR auf dem Bon; 'auto' = unbestimmt, der Drucker-Wizard probiert beide aus. */
+    qrMode: PosOpen<PosQrMode>;
+    drawerEnabled: boolean;
+    drawerAutoOpen: PosOpen<PosDrawerAutoOpen>;
+    terminalIp: string;
+    terminalPort: number;
+    terminalVia: PosOpen<PosTerminalVia>;
+    /** Art des Terminals ('none' = Kartenzahlung ohne Terminal-Anbindung gesperrt, sofern payCard an). */
+    terminalType: PosOpen<PosTerminalType>;
+    /** Tastenmarken (die kleinen Kuerzel an den Knoepfen) anzeigen. */
+    shortcutHints: boolean;
+    /** Terminal-ID aus dem Hobex-Vertrag (ohne fuehrende Null); noetig fuer Diagnose und Zahlung. */
+    terminalTid: string;
+}
+export interface PosSettings {
+    business: PosBusinessSettings;
+    device: PosDeviceSettings;
+}
+export declare const POS_BUSINESS_DEFAULTS: Readonly<PosBusinessSettings>;
+export declare const POS_DEVICE_DEFAULTS: Readonly<PosDeviceSettings>;
+/**
+ * Die Wertemenge je Feld, soweit das Feld eine hat: dagegen prueft der
+ * Schreibweg vor dem Senden (ein deutscher Wert wie `'nacht'` geht so gar
+ * nicht erst hinaus). Die Wahrheit ueber Gueltigkeit hat weiter das Backend.
+ */
+export declare const POS_BUSINESS_VALUES: Readonly<Partial<Record<keyof PosBusinessSettings, readonly (string | number)[]>>>;
+/** Wie [POS_BUSINESS_VALUES] fuer die Geraete-Einstellungen. */
+export declare const POS_DEVICE_VALUES: Readonly<Partial<Record<keyof PosDeviceSettings, readonly (string | number)[]>>>;
+/** Ein Wert der inneren Form 0.x fuer dieses Feld? (paketintern, fuer die Meldung der Vorab-Pruefung) */
+export declare function _istAltwert0x(feld: string, wert: unknown): boolean;
+/** Nur fuer den Test: die beiden Tabellen der inneren Form. */
+export declare const _ALTFORM_0X: Readonly<{
+    werte: Readonly<Record<string, readonly (string | number)[]>>;
+    aktionen: string[];
+}>;
+/**
+ * Standard + stored. Landkarten (`vatRates`, `tipSteps`, `shortcuts`)
+ * werden je Schluessel gemischt, damit neue Saetze beim Altbestand ankommen;
+ * Schluessel, die der Standard nicht fuehrt, bleiben draussen.
+ *
+ * **Immer** (unabhaengig davon, welches Standard-Objekt uebergeben wird, auch
+ * eine Kopie oder das einer zweiten Paketkopie) faellt ein Wert der inneren
+ * Form 0.x auf den Standard zurueck (`layout: 'rechts'`, `terminalVia:
+ * 'direkt'`), und deutsche Tasten-Aktionen (`kassieren`) kommen nicht in die
+ * Tastenkarte. Ein unbekannter **englischer** Wert (`theme: 'sepia'`) bleibt
+ * dagegen stehen: er kann ein neuer Wert des Servers sein.
+ */
+export declare function mergePosSettings<T extends object>(standard: Readonly<T>, stored: Partial<T> | null | undefined): T;
+/**
+ * Einen gespeicherten oder zwischengespeicherten Stand `{business, device}`
+ * lesen: gemischt mit den Standardwerten, ohne Werte und Tasten-Aktionen der
+ * inneren Form 0.x (siehe [mergePosSettings]). Der Weg fuer jeden Stand, den
+ * ein Verbraucher selbst abgelegt hat; ein Stand in der inneren Form ergibt
+ * die Standardwerte, nie einen deutschen Wert und nie einen Absturz.
+ */
+export declare function sanitizePosSettings(stored: unknown): PosSettings;
+/**
+ * Die Felder, deren Wert dieses Paket nicht kennt (neuer Wert des Servers),
+ * als Pfade (`business.theme`, `device.printerType`). Die Oberflaeche kann sie
+ * als „vom Server, hier nicht einstellbar" zeigen; sie bleiben erhalten, solange
+ * nur geaenderte Felder geschrieben werden ([posSettingsChanges]).
+ */
+export declare function unknownPosSettingValues(settings: PosSettings): string[];
+/**
+ * Was sich zwischen zwei Staenden eines Teils geaendert hat, als Nutzlast fuer
+ * `setMyPosSettings` bzw. `setMyRegisterDeviceSettings`: **nur geaenderte
+ * Felder** (der Server mischt, ein nicht geaenderter, hier unbekannter Wert
+ * geht so nie verloren). `vatRates` geht bei einer Aenderung als ganze Karte
+ * (Nachtrag §11.7.2), `shortcuts` ebenfalls ganz, aber nur mit den Aktionen,
+ * die dieses Paket kennt: so sieht die Doppelbelegungspruefung des Servers die
+ * ganze Belegung, und eine unbekannte Aktion bleibt per Mischen am Server
+ * stehen. `tipSteps` geht nur mit den geaenderten Eintraegen.
+ */
+export declare function posSettingsChanges<T extends object>(before: Readonly<T>, after: Readonly<T>): Partial<T>;