@kreiseck/kasseneck-api 1.0.0 → 1.1.0

package/dist/cjs/printing/printable.js

@@ -18,6 +18,7 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.escPosPrintableText = escPosPrintableText;
+const code_tables_js_1 = require("./code-tables.js");
 /** Ersetzungen aus print_paper.dart, Schluessel sind Unicode-Codepunkte. */
 const ERSETZUNGEN = new Map([
     [0x2013, '-'], // – Halbgeviertstrich
@@ -66,12 +67,34 @@ function istEmojiOderNullbreite(codepunkt) {
  * Vor `escPosText`/`escPosRow` anwenden, wenn der Text aus fremder Hand kommt
  * (Artikelstamm, ERP-Uebernahme, Kundenname). `•` wird hier zu `*`, und der
  * Erzeuger sagt dasselbe — auch wer diese Funktion weglaesst, bekommt also
- * dasselbe Zeichen (siehe ZEICHEN_ERSATZ in escpos.ts).
+ * dasselbe Zeichen (siehe ZEICHEN_ERSATZ in code-tables.ts).
+ *
+ * Mit `codeTable` wird der Text fuer genau diese Tabelle fertig gemacht:
+ * - eine Tabelle des Katalogs (`CodeTableId`): `€` bleibt stehen, wenn die
+ *   Tabelle es hat (der Drucker bekommt das echte Byte), sonst `EUR`; jedes
+ *   der zehn Zeichen, das der Tabelle fehlt (`§` auf pc437, alle Umlaute auf
+ *   `replacement` ...), wird schon hier zu seinen Ersatzbuchstaben. Danach
+ *   ist jedes Zeichen genau ein Byte, und Spalten, die am Text gerechnet
+ *   werden, stimmen auch am Papier.
+ * - `CP437` (alter Name): wie `pc437`, also `§` -> `Par.`.
+ * - ohne Angabe, `null` oder `CP1252`: genau wie bisher (Bons ohne gewaehlte
+ *   Tabelle bleiben byte-gleich).
  */
-function escPosPrintableText(text) {
+function escPosPrintableText(text, codeTable) {
+    const tabelle = tabelleFuerErsatz(codeTable);
+    const fehlend = tabelle === null ? [] : (0, code_tables_js_1.codeTableById)(tabelle).missing;
+    const echtesEuro = tabelle !== null && !fehlend.includes('€');
     let ergebnis = '';
     for (const zeichen of text) {
         const codepunkt = zeichen.codePointAt(0);
+        if (fehlend.includes(zeichen)) {
+            ergebnis += (0, code_tables_js_1.ersatzBuchstaben)(zeichen);
+            continue;
+        }
+        if (codepunkt === 0x20ac && echtesEuro) {
+            ergebnis += zeichen;
+            continue;
+        }
         const ersatz = ERSETZUNGEN.get(codepunkt);
         if (ersatz !== undefined) {
             ergebnis += ersatz;
@@ -88,3 +111,14 @@ function escPosPrintableText(text) {
     }
     return ergebnis;
 }
+/**
+ * Tabelle, deren fehlende Zeichen schon am Text ersetzt werden. `null` heisst
+ * alter Weg ohne Aenderung (keine Wahl, `null`, `CP1252`).
+ */
+function tabelleFuerErsatz(codeTable) {
+    if (codeTable === undefined || codeTable === null || codeTable === 'CP1252')
+        return null;
+    if (codeTable === 'CP437')
+        return 'pc437';
+    return codeTable;
+}

package/dist/cjs/react/index.js

@@ -96,6 +96,13 @@ function ReceiptSheetLines({ sheet: blatt, logoUrl, renderQr, qrHidden: qrVerdec
     return ((0, jsx_runtime_1.jsx)("div", { className: klasse, "data-zeichen": z, style: blattStil, children: blatt.blocks.map((b, i) => {
             switch (b.kind) {
                 case 'line':
+                    if (b.doubleSizeLead !== undefined && b.doubleSizeLead > 0) {
+                        // Wie am Papier (`GS !` doppelt): die Nummernzelle in doppelter
+                        // Schrift, die Zeile zwei Zeilen hoch, der Rest auf der Grundlinie.
+                        // `ch` im Span misst die doppelte Schrift, darum die halbe Zahl.
+                        const n = b.doubleSizeLead;
+                        return ((0, jsx_runtime_1.jsxs)("div", { className: "keck-blatt-zeile keck-blatt-zeile--gross", style: { display: 'flex', alignItems: 'flex-end', whiteSpace: 'pre', height: '4ch', overflow: 'hidden', fontWeight: b.bold ? 'bold' : 'normal' }, children: [(0, jsx_runtime_1.jsx)("span", { style: { fontSize: '2em', width: `${n / 2}ch`, lineHeight: '2ch', fontWeight: 'bold', textAlign: 'center', flex: 'none' }, children: b.text.slice(0, n).trim() }), (0, jsx_runtime_1.jsx)("span", { style: { lineHeight: '2ch' }, children: b.text.slice(n) })] }, i));
+                    }
                     return ((0, jsx_runtime_1.jsx)("div", { className: "keck-blatt-zeile", style: { whiteSpace: 'pre', height: '2ch', lineHeight: '2ch', overflow: 'hidden', fontWeight: b.bold ? 'bold' : 'normal' }, children: b.text }, i));
                 case 'logo':
                     return ((0, jsx_runtime_1.jsx)("div", { className: "keck-blatt-logo", style: { height: `${b.heightLines * 2}ch`, display: 'flex', justifyContent: 'center' }, children: logoUrl === undefined ? null : ((0, jsx_runtime_1.jsx)("img", { src: logoUrl, alt: "", "aria-hidden": "true", style: { width: `${b.widthFraction * z}ch`, height: `${b.heightLines * 2}ch`, objectFit: 'contain' } })) }, i));

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

@@ -40,6 +40,15 @@ export type SheetBlock = {
     readonly text: string;
     readonly bold: boolean;
     readonly blank: boolean;
+    /**
+     * Die ersten n Spalten sind EINE Zelle, deren Inhalt (ohne Leerraum)
+     * doppelt breit und doppelt hoch steht -- die Zeile ist dann zwei
+     * Zeilen hoch. Nur das Testblatt des Zeichensatzes setzt das (Nummern
+     * links); fehlt es, ist alles einfach gross. Ein Zeichner, der das Feld
+     * nicht kennt, zeigt die Zeile in einfacher Groesse, die Spalten
+     * bleiben dieselben.
+     */
+    readonly doubleSizeLead?: number;
 } | {
     readonly kind: 'logo';
     readonly widthFraction: number;

package/dist/cjs/receipt/code-table-reference-data.d.ts

@@ -0,0 +1,6 @@
+/** Die Vorlage-Zeile als Rasterbild: 384 x 24 Punkte, MSB zuerst, je Zeile auf volle Bytes aufgefuellt; base64. */
+export declare const CODE_TABLE_REFERENCE_RASTER: {
+    readonly width: number;
+    readonly height: number;
+    readonly bits: string;
+};

package/dist/cjs/receipt/code-table-reference-data.js

@@ -0,0 +1,11 @@
+"use strict";
+// Erzeugt von scripts/zeichensatz-vorlage.py -- nicht von Hand aendern.
+// Schrift: Menlo Regular 20 px (sha256 dc256e0b39c2a6fec947129d421fef41b8b429f58f9b6e5d1b148c87f775c1f6), Schwelle 160.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CODE_TABLE_REFERENCE_RASTER = void 0;
+/** Die Vorlage-Zeile als Rasterbild: 384 x 24 Punkte, MSB zuerst, je Zeile auf volle Bytes aufgefuellt; base64. */
+exports.CODE_TABLE_REFERENCE_RASTER = {
+    width: 384,
+    height: 24,
+    bits: "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAGYAAGYAAGYAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAGYAAGYAAGYAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAGYAAGYAAGYAABgAADwAAIEAAH4AAB8AAD4AADwAAAAAAAAAAAAAAAAAAAAAAAAAAGYAAGYAAGYAADwAAH4AAcOAAOcAAD8AAH4AAH4AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAADwAAMMAAcOAAMMAAHAAAGAAAEIAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAADwAAMMAAcOAAMMAAOAAAGAAAEIAAAAAAAAAAAAAAAAAAAAAAAAAAP4AAH4AAMMAAGYAAcOAAcOAAMwAAMAAAHAAAGYAAAAAAAAAAAAAAAAAAAAAAAAAAOcAAOcAAMMAAGYAAYGAAcOAANgAAfwAAHgAADwAAAAAAAAAAAAAAAAAAAAAAAAAAAMAAMMAAMMAAGYAAYGAAcOAANgAAfwAAM4AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAMAAcOAAMMAAGcAAYGAAcOAANwAAMAAAMcAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAH8AAYGAAMMAAMMAAYGAAcOAAM4AAfgAAMMAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAP8AAYGAAMMAAP8AAYGAAcOAAMcAA/gAAOMAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAcMAAYGAAMMAAP8AAcGAAcOAAMGAAMAAAHsAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAYMAAcOAAMMAAcOAAcOAAcOAAMGAAOAAAB4AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAYMAAMMAAMMAAYGAAMMAAMMAAMGAAGAAAAYAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAO8AAOcAAP8AAYGAAP8AAP8AAPOAAH8AAAcAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAP8AAH4AAH8AA4HAAH4AAH4AAP8AAD8AAAcAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAH4AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAHwAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA",
+};

package/dist/cjs/receipt/code-table-test-sheet.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Das Testblatt fuer den Zeichensatz: welche Code-Tabelle druckt auf diesem
+ * Drucker die Umlaute richtig?
+ *
+ * Oben steht die Vorlage-Zeile als Rasterbild -- ein Bild druckt jeder
+ * Drucker gleich, egal welche Tabelle er gerade hat. Darunter je Tabelle des
+ * Katalogs eine Zeile mit ihrer Nummer (gross), umgeschaltet mit `ESC t n`
+ * und mit den Bytes dieser Tabelle. Die erste Zeile, die aussieht wie die
+ * Vorlage, ist die richtige; Zeile 6 (Ersatzbuchstaben) passt immer.
+ *
+ * Bildschirm und Papier zeigen dasselbe Blatt: `codeTableTestSheet` liefert
+ * es im Zeilenmodell des Beleg-Blatts (`ReceiptSheet`), `codeTableTestSheetBytes`
+ * druckt genau diese Zeilen. Das Blatt hat immer 32 Spalten (58 mm); auf
+ * 80 mm steht der Block ueber den linken Rand (`GS L`) mittig.
+ *
+ * Gemeinsamer Prueffall mit dem Dart-Zwilling:
+ * `fixtures/expected/code-table-test-sheet.{mm58,mm80}.hex` und `.lines.json`.
+ */
+import type { ReceiptSheet } from './blatt.js';
+import { type CodeTable, type CodeTableId } from '../printing/code-tables.js';
+import { type PosPaperSize, type RasterImage } from '../printing/escpos.js';
+/** Spalten des Testblatts -- immer 58-mm-Format. */
+export declare const CODE_TABLE_TEST_SHEET_CHARS = 32;
+export interface CodeTableTestSheetInput {
+    /** Kassen-Kennung fuer die Kopfzeile (keine Personendaten). */
+    cashregisterLabel: string;
+    /** Zeitpunkt des Drucks; die Kopfzeile zeigt ihn in Wiener Zeit. */
+    time: Date;
+    /** Papier des Druckers; das Blatt bleibt 32 Spalten, auf 80 mm mittig. */
+    paper: PosPaperSize;
+}
+/** Eine Testzeile: Nummer, Tabelle und die Zeichen, die ihr fehlen (fuer „ohne €“ am Bildschirm). */
+export interface CodeTableTestSheetRow {
+    readonly number: CodeTable['number'];
+    readonly codeTable: CodeTableId;
+    readonly missing: readonly string[];
+}
+/** Das Testblatt im Zeilenmodell des Beleg-Blatts, dazu die Testzeilen. */
+export interface CodeTableTestSheet extends ReceiptSheet {
+    readonly rows: readonly CodeTableTestSheetRow[];
+}
+/** Die Vorlage-Zeile als Rasterbild (384 x 24 Punkte), wie sie am Papier steht. */
+export declare function codeTableReferenceImage(): RasterImage;
+/** Das Testblatt im Zeilenmodell des Beleg-Blatts -- dieselben Zeilen wie am Papier. */
+export declare function codeTableTestSheet(options: CodeTableTestSheetInput): CodeTableTestSheet;
+/**
+ * Das Testblatt als ESC/POS-Bytes. Jede Testzeile schaltet nach ihrer
+ * Nummer einmal mit `FS .` + `ESC t n` auf ihre Tabelle und traegt deren Bytes (`encodeForCodeTable`,
+ * also das echte €-Byte, wo die Tabelle es hat). Die Nummer steht doppelt
+ * breit und hoch (`GS !`), die Vorlage als Rasterbild (`GS v 0`).
+ */
+export declare function codeTableTestSheetBytes(options: CodeTableTestSheetInput): Uint8Array;

package/dist/cjs/receipt/code-table-test-sheet.js

@@ -0,0 +1,153 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CODE_TABLE_TEST_SHEET_CHARS = void 0;
+exports.codeTableReferenceImage = codeTableReferenceImage;
+exports.codeTableTestSheet = codeTableTestSheet;
+exports.codeTableTestSheetBytes = codeTableTestSheetBytes;
+const marke_js_1 = require("./marke.js");
+const vienna_time_js_1 = require("../vienna-time.js");
+const texte_js_1 = require("../pos/texte.js");
+const code_tables_js_1 = require("../printing/code-tables.js");
+const code_table_reference_data_js_1 = require("./code-table-reference-data.js");
+const escpos_js_1 = require("../printing/escpos.js");
+/** Spalten des Testblatts -- immer 58-mm-Format. */
+exports.CODE_TABLE_TEST_SHEET_CHARS = 32;
+/** Die zehn Zeichen der Vorlage, in der Reihenfolge des Katalogs. */
+const VORLAGE = ['ä', 'ö', 'ü', 'Ä', 'Ö', 'Ü', 'ß', '€', '§', '°'];
+/** Spalte des ersten Zeichens; danach jede zweite. Muss zu scripts/zeichensatz-vorlage.py passen. */
+const ERSTE_SPALTE = 5;
+/** Breite der Nummernzelle: eine Ziffer doppelt breit. */
+const NUMMER_SPALTEN = 2;
+const TRENNER = ' | ';
+/** Punkte je Blatt-Zeile: 32 Zeichen zu 12 Punkten. */
+const BLATT_PUNKTE = exports.CODE_TABLE_TEST_SHEET_CHARS * 12;
+/** Linker Rand, der den 32-Spalten-Block auf 80 mm (576 Punkte) mittig setzt. */
+const RAND_80 = (576 - BLATT_PUNKTE) / 2;
+const GS = 0x1d;
+const ESC = 0x1b;
+/** `ESC t` der Vorgabe ohne gewaehlte Tabelle (WPC1252). */
+const VORGABE_ESC_T = 16;
+/** Die Vorlage-Zeile als Rasterbild (384 x 24 Punkte), wie sie am Papier steht. */
+function codeTableReferenceImage() {
+    const r = code_table_reference_data_js_1.CODE_TABLE_REFERENCE_RASTER;
+    return (0, marke_js_1.entpackeRasterBits)(r.bits, r.width, r.height);
+}
+/** Text in reines ASCII (Ersatzbuchstaben): steht auf jedem Drucker gleich, egal welche Tabelle gilt. */
+function nurAscii(text) {
+    return String.fromCharCode(...(0, code_tables_js_1.encodeForCodeTable)(text, 'replacement'));
+}
+function zeile(text, bold = false, ausrichtung = 'left') {
+    const rest = exports.CODE_TABLE_TEST_SHEET_CHARS - text.length;
+    const links = ausrichtung === 'center' ? Math.floor(rest / 2) : 0;
+    return { kind: 'line', text: ' '.repeat(links) + text + ' '.repeat(rest - links), bold, blank: false };
+}
+function zeilen(text, bold = false, ausrichtung = 'left') {
+    return (0, escpos_js_1.wrapText)(nurAscii(text), exports.CODE_TABLE_TEST_SHEET_CHARS).map((t) => zeile(t, bold, ausrichtung));
+}
+/** Die Zeichen einer Tabelle an ihren Spalten; ein fehlendes Zeichen laesst seine Luecke. */
+function zeichenDerTabelle(tabelle) {
+    return VORLAGE.map((z) => (tabelle.missing.includes(z) ? ' ' : z)).join(' ').trimEnd();
+}
+function nummernZeile(nummer, text) {
+    const kopf = String(nummer).padStart(NUMMER_SPALTEN, ' ') + TRENNER;
+    return { ...zeile(kopf + text), doubleSizeLead: NUMMER_SPALTEN };
+}
+const zweistellig = (n) => String(n).padStart(2, '0');
+/** Das Testblatt im Zeilenmodell des Beleg-Blatts -- dieselben Zeilen wie am Papier. */
+function codeTableTestSheet(options) {
+    return blattBauen(options).blatt;
+}
+/**
+ * Baut das Blatt und merkt sich dabei, welcher Block die Vorlage-Zeile ist.
+ * Die Bytes suchen sie nicht am Text (der ist `nurAscii` und kann sich
+ * aendern), sondern nehmen genau diese Stelle.
+ */
+function blattBauen(options) {
+    const z = exports.CODE_TABLE_TEST_SHEET_CHARS;
+    const uhr = (0, vienna_time_js_1.toViennaWallClock)(options.time);
+    const zeit = `${zweistellig(uhr.day)}.${zweistellig(uhr.month)}. ${zweistellig(uhr.hour)}:${zweistellig(uhr.minute)}`;
+    const doppelt = zeile('='.repeat(z));
+    const einfach = zeile('-'.repeat(z));
+    const einzug = ' '.repeat(ERSTE_SPALTE);
+    const bloecke = [
+        doppelt,
+        ...zeilen((0, texte_js_1.labelText)('codetable.title'), true, 'center'),
+        ...zeilen(`${options.cashregisterLabel.trim()}  ${zeit}`, false, 'center'),
+        doppelt,
+        ...zeilen((0, texte_js_1.labelText)('codetable.reference')),
+    ];
+    // Am Papier ein Bild (`codeTableReferenceImage`), am Bildschirm Text.
+    const vorlage = bloecke.length;
+    bloecke.push(zeile(einzug + VORLAGE.join(' ')), einfach);
+    const ersatz = code_tables_js_1.CODE_TABLES.find((t) => t.id === 'replacement');
+    for (const t of code_tables_js_1.CODE_TABLES) {
+        if (t === ersatz)
+            continue;
+        bloecke.push(nummernZeile(t.number, zeichenDerTabelle(t)));
+    }
+    bloecke.push(einfach);
+    const ersatzText = String.fromCharCode(...(0, code_tables_js_1.encodeForCodeTable)(VORLAGE.join(' '), 'replacement'));
+    const [ersteErsatz = '', ...restErsatz] = (0, escpos_js_1.wrapText)(ersatzText, z - ERSTE_SPALTE);
+    bloecke.push(nummernZeile(ersatz.number, ersteErsatz));
+    for (const t of restErsatz)
+        bloecke.push(zeile(einzug + t));
+    bloecke.push(zeile(einzug + nurAscii((0, texte_js_1.labelText)('codetable.replacement_note'))));
+    bloecke.push(doppelt);
+    bloecke.push(...zeilen((0, texte_js_1.messageText)('codetable.instruction')));
+    bloecke.push(doppelt);
+    return {
+        blatt: {
+            charsPerLine: z,
+            blocks: bloecke,
+            rows: code_tables_js_1.CODE_TABLES.map((t) => ({ number: t.number, codeTable: t.id, missing: t.missing })),
+        },
+        vorlage,
+    };
+}
+/**
+ * Das Testblatt als ESC/POS-Bytes. Jede Testzeile schaltet nach ihrer
+ * Nummer einmal mit `FS .` + `ESC t n` auf ihre Tabelle und traegt deren Bytes (`encodeForCodeTable`,
+ * also das echte €-Byte, wo die Tabelle es hat). Die Nummer steht doppelt
+ * breit und hoch (`GS !`), die Vorlage als Rasterbild (`GS v 0`).
+ */
+function codeTableTestSheetBytes(options) {
+    const { blatt, vorlage: vorlageIndex } = blattBauen(options);
+    const vorlage = blatt.blocks[vorlageIndex];
+    if (vorlage === undefined || vorlage.kind !== 'line')
+        throw new Error(`Testblatt: Vorlage-Zeile fehlt (Block ${vorlageIndex})`);
+    // Das Dokument ist immer 58 mm: 32 Spalten, Druckbereich 384 Punkte.
+    const doc = (0, escpos_js_1.createEscPosDocument)({ paperSize: 'mm58', codeTable: null });
+    (0, escpos_js_1.escPosReset)(doc);
+    if (options.paper === 'mm80')
+        doc.bytes.push(GS, 0x4c, RAND_80 & 0xff, RAND_80 >> 8);
+    let tabellen = 0;
+    for (const block of blatt.blocks) {
+        if (block.kind !== 'line')
+            continue;
+        if (block === vorlage) {
+            (0, escpos_js_1.escPosRasterImage)(doc, codeTableReferenceImage(), { align: 'left' });
+            continue;
+        }
+        if (block.doubleSizeLead === undefined) {
+            (0, escpos_js_1.escPosText)(doc, block.text.trimEnd(), { styles: { align: 'left', bold: block.bold } });
+            continue;
+        }
+        const tabelle = blatt.rows[tabellen];
+        tabellen += 1;
+        const nummer = block.text.slice(0, block.doubleSizeLead).trim();
+        // Die Ziffer ist ASCII und steht in jeder Tabelle gleich: keine Umschaltung
+        // davor, die Zeile schaltet genau einmal, vor ihren eigenen Bytes.
+        (0, escpos_js_1.escPosSetStyles)(doc, { align: 'left', bold: true, width: 2, height: 2 });
+        doc.bytes.push(...(0, code_tables_js_1.encodeForCodeTable)(nummer, 'replacement'));
+        (0, escpos_js_1.escPosSetStyles)(doc, { align: 'left', codeTable: tabelle.codeTable });
+        doc.bytes.push(...(0, code_tables_js_1.encodeForCodeTable)(block.text.slice(block.doubleSizeLead).trimEnd(), tabelle.codeTable), 0x0a);
+    }
+    // Endzustand wie ohne Wahl: Tabelle 16 (WPC1252) und auf 80 mm Rand 0.
+    // Ein Druck danach ohne `ESC @` steht sonst in der Tabelle der letzten
+    // Testzeile und um den Rand verschoben.
+    doc.bytes.push(ESC, 0x74, VORGABE_ESC_T);
+    if (options.paper === 'mm80')
+        doc.bytes.push(GS, 0x4c, 0, 0);
+    (0, escpos_js_1.escPosCut)(doc, 'full');
+    return (0, escpos_js_1.escPosBytes)(doc);
+}

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

@@ -6,4 +6,5 @@ export { type SheetLogoSize, type SheetLogo, type LogoDimensions, type SheetBloc
 export { rasterizeLogo } from './bild.js';
 export { type BrandMarkRaster, BRAND_MARK_RASTERS, BRAND_MARK_PATHS } from './marke-daten.js';
 export { brandMarkImage } from './marke.js';
+export { type CodeTableTestSheetInput, type CodeTableTestSheetRow, type CodeTableTestSheet, CODE_TABLE_TEST_SHEET_CHARS, codeTableTestSheet, codeTableTestSheetBytes, codeTableReferenceImage, } from './code-table-test-sheet.js';
 export { type ReceiptDueTip, type ReceiptDueTipRecipient, type ReceiptDueOptions, type ReceiptDueBuckets, type ReceiptDueBreakdown, type ReceiptDueErrorReason, receiptDueCents, receiptDueBreakdown, ReceiptDueError, RECEIPT_DUE_ERROR_REASONS, isReceiptDueError, } from './due.js';

package/dist/cjs/receipt/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isReceiptDueError = exports.RECEIPT_DUE_ERROR_REASONS = exports.ReceiptDueError = exports.receiptDueBreakdown = exports.receiptDueCents = exports.brandMarkImage = exports.BRAND_MARK_PATHS = exports.BRAND_MARK_RASTERS = exports.rasterizeLogo = exports.receiptSheet = exports.qrSheetWidthFraction = exports.logoRasterSize = exports.isLogoPixelSizeAllowed = exports.logoDimensions = exports.paperSizeForChars = exports.DOTS_PER_LINE = exports.DOTS_PER_CHAR = exports.LOGO_MAX_PIXELS = exports.SHEET_LOGO_SIZES = exports.eposDirectStatus = exports.eposDirectPrint = exports.eposParseResponse = exports.eposSoapEnvelope = exports.eposServiceUrl = exports.eposImageXml = exports.eposXmlEscape = exports.eposPrintXmlResult = exports.eposPrintXml = exports.EposConnectionError = exports.CHARS_PER_PAPER_SIZE = exports.gridToText = exports.gridColumnWidths = exports.renderReceiptGrid = exports.escPosLayoutResult = exports.escPosLayoutBytes = exports.assertLogoRaster = exports.formatCents = exports.SMALL_BUSINESS_NOTICE = exports.CURRENT_LAYOUT_RULESET = exports.receiptZdaText = exports.receiptIsSmallBusinessConsistent = exports.receiptAmountsAreZero = exports.receiptIsZero = exports.receiptSignatureIsTest = exports.receiptSignatureFailed = exports.buildReceiptLayout = void 0;
+exports.isReceiptDueError = exports.RECEIPT_DUE_ERROR_REASONS = exports.ReceiptDueError = exports.receiptDueBreakdown = exports.receiptDueCents = exports.codeTableReferenceImage = exports.codeTableTestSheetBytes = exports.codeTableTestSheet = exports.CODE_TABLE_TEST_SHEET_CHARS = exports.brandMarkImage = exports.BRAND_MARK_PATHS = exports.BRAND_MARK_RASTERS = exports.rasterizeLogo = exports.receiptSheet = exports.qrSheetWidthFraction = exports.logoRasterSize = exports.isLogoPixelSizeAllowed = exports.logoDimensions = exports.paperSizeForChars = exports.DOTS_PER_LINE = exports.DOTS_PER_CHAR = exports.LOGO_MAX_PIXELS = exports.SHEET_LOGO_SIZES = exports.eposDirectStatus = exports.eposDirectPrint = exports.eposParseResponse = exports.eposSoapEnvelope = exports.eposServiceUrl = exports.eposImageXml = exports.eposXmlEscape = exports.eposPrintXmlResult = exports.eposPrintXml = exports.EposConnectionError = exports.CHARS_PER_PAPER_SIZE = exports.gridToText = exports.gridColumnWidths = exports.renderReceiptGrid = exports.escPosLayoutResult = exports.escPosLayoutBytes = exports.assertLogoRaster = exports.formatCents = exports.SMALL_BUSINESS_NOTICE = exports.CURRENT_LAYOUT_RULESET = exports.receiptZdaText = exports.receiptIsSmallBusinessConsistent = exports.receiptAmountsAreZero = exports.receiptIsZero = exports.receiptSignatureIsTest = exports.receiptSignatureFailed = exports.buildReceiptLayout = void 0;
 var layout_js_1 = require("./layout.js");
 Object.defineProperty(exports, "buildReceiptLayout", { enumerable: true, get: function () { return layout_js_1.buildReceiptLayout; } });
 Object.defineProperty(exports, "receiptSignatureFailed", { enumerable: true, get: function () { return layout_js_1.receiptSignatureFailed; } });
@@ -50,6 +50,11 @@ Object.defineProperty(exports, "BRAND_MARK_RASTERS", { enumerable: true, get: fu
 Object.defineProperty(exports, "BRAND_MARK_PATHS", { enumerable: true, get: function () { return marke_daten_js_1.BRAND_MARK_PATHS; } });
 var marke_js_1 = require("./marke.js");
 Object.defineProperty(exports, "brandMarkImage", { enumerable: true, get: function () { return marke_js_1.brandMarkImage; } });
+var code_table_test_sheet_js_1 = require("./code-table-test-sheet.js");
+Object.defineProperty(exports, "CODE_TABLE_TEST_SHEET_CHARS", { enumerable: true, get: function () { return code_table_test_sheet_js_1.CODE_TABLE_TEST_SHEET_CHARS; } });
+Object.defineProperty(exports, "codeTableTestSheet", { enumerable: true, get: function () { return code_table_test_sheet_js_1.codeTableTestSheet; } });
+Object.defineProperty(exports, "codeTableTestSheetBytes", { enumerable: true, get: function () { return code_table_test_sheet_js_1.codeTableTestSheetBytes; } });
+Object.defineProperty(exports, "codeTableReferenceImage", { enumerable: true, get: function () { return code_table_test_sheet_js_1.codeTableReferenceImage; } });
 var due_js_1 = require("./due.js");
 Object.defineProperty(exports, "receiptDueCents", { enumerable: true, get: function () { return due_js_1.receiptDueCents; } });
 Object.defineProperty(exports, "receiptDueBreakdown", { enumerable: true, get: function () { return due_js_1.receiptDueBreakdown; } });

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

@@ -55,7 +55,12 @@ export declare function blattFuerDruck(layout: ReceiptLayout, optionen: {
 export interface EscPosLayoutOptions {
     /** Papierbreite; Vorgabe ist die des Layouts (dessen Spaltenbreiten daran haengen). */
     paperSize?: PosPaperSize;
-    /** Codepage des Druckers, Vorgabe `CP1252`; `null` laesst die des Geraets stehen. */
+    /**
+     * Codepage des Druckers, Vorgabe `CP1252`; `null` laesst die des Geraets
+     * stehen. Eine Tabelle des Katalogs (`CodeTableId`, im Drucker-Wizard
+     * gewaehlt) druckt `€`, `§`, `°` als echtes Byte, wo die Tabelle sie hat,
+     * sonst als Ersatzbuchstaben; ohne Wahl bleibt der Bon byte-gleich.
+     */
     codeTable?: PosCodeTable | null;
     /** Papierschnitt am Ende: `true` (voll), `'partial'` oder `false`. Vorgabe `true`. */
     cut?: boolean | PosCutMode;

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

@@ -40,17 +40,21 @@ function blattFuerDruck(layout, optionen) {
 /**
  * Druckbar gemachtes Layout: Texte durch [escPosPrintableText] (Codepage,
  * "EUR" statt "€", Striche), damit das Raster mit den Zeichen rechnet, die
- * wirklich aufs Papier gehen. Der QR-Inhalt bleibt unveraendert.
+ * wirklich aufs Papier gehen. Mit gewaehlter Tabelle bleibt "€", wo die
+ * Tabelle es hat, und fehlende Zeichen werden schon hier zu
+ * Ersatzbuchstaben: jedes Zeichen ist danach genau ein Byte. Der QR-Inhalt
+ * bleibt unveraendert.
  */
-function druckbaresLayout(layout) {
+function druckbaresLayout(layout, codeTable) {
+    const druckbar = (text) => (0, index_js_1.escPosPrintableText)(text, codeTable);
     return {
         ...layout,
         lines: layout.lines.map((z) => {
             switch (z.kind) {
-                case 'text': return { ...z, text: (0, index_js_1.escPosPrintableText)(z.text) };
-                case 'banner': return { ...z, text: (0, index_js_1.escPosPrintableText)(z.text) };
-                case 'columns': return { ...z, columns: z.columns.map((c) => ({ ...c, text: (0, index_js_1.escPosPrintableText)(c.text) })) };
-                case 'rule': return { ...z, char: (0, index_js_1.escPosPrintableText)(z.char) || '-' };
+                case 'text': return { ...z, text: druckbar(z.text) };
+                case 'banner': return { ...z, text: druckbar(z.text) };
+                case 'columns': return { ...z, columns: z.columns.map((c) => ({ ...c, text: druckbar(c.text) })) };
+                case 'rule': return { ...z, char: druckbar(z.char) || '-' };
                 default: return z;
             }
         }),
@@ -140,7 +144,7 @@ function escPosLayoutResult(layout, options = {}) {
     };
     // `blattFuerDruck` prueft das Logo-Raster bereits VOR der Rueckgabe -- die
     // Schleife unten schreibt darum nie ein Byte auf ein falsch grosses Logo.
-    const blatt = blattFuerDruck(druckbaresLayout(layout), {
+    const blatt = blattFuerDruck(druckbaresLayout(layout, options.codeTable), {
         zeichen: grid_js_1.CHARS_PER_PAPER_SIZE[paperSize],
         logo: options.logo,
         marke: options.brandMark,

package/dist/cjs/version.d.ts

@@ -4,4 +4,4 @@
  * Client-Version, Nachtrag §6). Ein Test haelt sie gleich mit `package.json`;
  * beim Anheben der Version beide Stellen aendern.
  */
-export declare const PACKAGE_VERSION = "1.0.0";
+export declare const PACKAGE_VERSION = "1.1.0";

package/dist/cjs/version.js

@@ -7,4 +7,4 @@ exports.PACKAGE_VERSION = void 0;
  * Client-Version, Nachtrag §6). Ein Test haelt sie gleich mit `package.json`;
  * beim Anheben der Version beide Stellen aendern.
  */
-exports.PACKAGE_VERSION = '1.0.0';
+exports.PACKAGE_VERSION = '1.1.0';

package/dist/esm/pos/texte.d.ts

@@ -469,6 +469,12 @@ declare const MELDUNGEN_ROH: {
     readonly 'print.wizard_cancelled': {
         readonly text: "Nichts gespeichert.";
     };
+    readonly 'codetable.question': {
+        readonly text: "Welche Zeile sieht auf dem Papier aus wie oben?";
+    };
+    readonly 'codetable.instruction': {
+        readonly text: "Die Nummer der ersten Zeile, die genau wie oben aussieht, in der Kasse antippen.";
+    };
     readonly 'bluetooth.off': {
         readonly text: "Bluetooth ist ausgeschaltet. Bitte einschalten und erneut suchen.";
         readonly only: readonly ["app"];
@@ -964,6 +970,32 @@ declare const BESCHRIFTUNGEN_ROH: {
     readonly 'cancellation.difference': {
         readonly text: "Differenz";
     };
+    readonly 'codetable.title': {
+        readonly text: "ZEICHENSATZ-TEST";
+    };
+    readonly 'codetable.reference': {
+        readonly text: "So muss jede Zeile aussehen:";
+    };
+    readonly 'codetable.replacement_note': {
+        readonly text: "(Ersatz, passt immer)";
+    };
+    readonly 'codetable.missing': {
+        readonly text: "ohne {chars}";
+        readonly placeholders: readonly ["chars"];
+    };
+    readonly 'codetable.print_again': {
+        readonly text: "Nochmal drucken";
+    };
+    readonly 'codetable.not_checked': {
+        readonly text: "Umlaute noch nicht geprüft";
+    };
+    readonly 'codetable.check': {
+        readonly text: "Umlaute prüfen";
+    };
+    readonly 'codetable.current': {
+        readonly text: "Zeichensatz: Nr. {number}";
+        readonly placeholders: readonly ["number"];
+    };
 };
 export type LabelKey = keyof typeof BESCHRIFTUNGEN_ROH;
 export declare const LABELS: Record<LabelKey, TextEntry>;

package/dist/esm/pos/texte.js

@@ -245,6 +245,10 @@ const MELDUNGEN_ROH = {
     // Abbrechen an jeder Stelle: nichts gespeichert. Der Satz sagt genau das,
     // damit niemand einen halb eingerichteten Drucker vermutet.
     'print.wizard_cancelled': { text: 'Nichts gespeichert.' },
+    // Zeichensatz-Test im Drucker-Wizard: das Testblatt nennt die Anleitung,
+    // der Bildschirm stellt die Frage daneben.
+    'codetable.question': { text: 'Welche Zeile sieht auf dem Papier aus wie oben?' },
+    'codetable.instruction': { text: 'Die Nummer der ersten Zeile, die genau wie oben aussieht, in der Kasse antippen.' },
     'bluetooth.off': { text: 'Bluetooth ist ausgeschaltet. Bitte einschalten und erneut suchen.', only: ['app'] },
     'bluetooth.permission_missing': { text: 'Bitte die Freigabe in den Geräte-Einstellungen erteilen.', only: ['app'] },
     'bluetooth.search_failed': { text: 'Die Suche ist fehlgeschlagen: {reason}', placeholders: ['reason'], only: ['app'] },
@@ -556,6 +560,18 @@ const BESCHRIFTUNGEN_ROH = {
     'cancellation.all_cash': { text: 'Alles bar' },
     'cancellation.payment_remainder': { text: 'Rest {amount}', placeholders: ['amount'] },
     'cancellation.difference': { text: 'Differenz' },
+    // --- Zeichensatz-Test (Testblatt und Drucker & Lade) ----------------------
+    // Das Testblatt druckt diese Texte; sie bleiben reines ASCII bis auf die
+    // Knoepfe am Bildschirm. `{chars}` sind die fehlenden Zeichen einer Zeile
+    // („€“ bzw. „€ §“), `{number}` die gewaehlte Zeile (1-6).
+    'codetable.title': { text: 'ZEICHENSATZ-TEST' },
+    'codetable.reference': { text: 'So muss jede Zeile aussehen:' },
+    'codetable.replacement_note': { text: '(Ersatz, passt immer)' },
+    'codetable.missing': { text: 'ohne {chars}', placeholders: ['chars'] },
+    'codetable.print_again': { text: 'Nochmal drucken' },
+    'codetable.not_checked': { text: 'Umlaute noch nicht geprüft' },
+    'codetable.check': { text: 'Umlaute prüfen' },
+    'codetable.current': { text: 'Zeichensatz: Nr. {number}', placeholders: ['number'] },
 };
 export const LABELS = BESCHRIFTUNGEN_ROH;
 /** Die Beschriftung zum Schluessel, Platzhalter ersetzt; fehlt ein Wert, wirft es wie `messageText`. */

package/dist/esm/printing/code-tables.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Katalog der Code-Tabellen fuer Bondrucker und die Umwandlung von Text in
+ * Bytes je Tabelle.
+ *
+ * Warum ein Katalog: `ESC t n` waehlt die Zeichentabelle, aber die Nummer n
+ * ist nicht einheitlich. Epson legt WPC1252 auf 16, viele guenstige Drucker
+ * nummerieren anders oder kennen die Tabelle gar nicht. Wer am Testblatt
+ * sieht, welche Nummer seine Umlaute richtig druckt, waehlt hier die
+ * passende Tabelle. Gemeinsamer Prueffall mit dem Dart-Zwilling:
+ * `fixtures/code-tables.json`.
+ *
+ * Jede Tabelle setzt die zehn deutschen Zeichen (Umlaute, ß, €, §, °) auf
+ * ein Byte oder, wo die Tabelle das Zeichen nicht hat, auf Ersatzbuchstaben
+ * (`€` -> `EUR`). Fuer diese zehn Zeichen kommt nie `?` heraus.
+ */
+/** Kennung einer Code-Tabelle. */
+export type CodeTableId = 'wpc1252' | 'pc858' | 'pc850' | 'pc437' | 'iso8859_15' | 'replacement';
+/** Eine Code-Tabelle des Katalogs. */
+export interface CodeTable {
+    /** Kennung. */
+    id: CodeTableId;
+    /** Nummer auf dem Testblatt (1-6). */
+    number: 1 | 2 | 3 | 4 | 5 | 6;
+    /** n fuer `ESC t n`. */
+    escT: number;
+    /** Zeichen der zehn, die diese Tabelle nicht hat und durch Ersatzbuchstaben druckt. */
+    missing: readonly string[];
+}
+/**
+ * Ersatzbuchstaben fuer eines der zehn Zeichen (paketintern, fuer
+ * `escPosPrintableText` mit gewaehlter Tabelle).
+ */
+export declare function ersatzBuchstaben(zeichen: string): string;
+/** Alle Code-Tabellen in der Reihenfolge des Testblatts (Nummer 1-6). */
+export declare const CODE_TABLES: readonly CodeTable[];
+/** Die Tabelle zu einer Kennung; eine unbekannte Kennung wird gemeldet. */
+export declare function codeTableById(id: CodeTableId): CodeTable;
+/**
+ * Tabelle aus der gespeicherten Einstellung (`cp1252`/`cp437`). Alles andere,
+ * auch keine Einstellung, ist die Vorgabe `wpc1252`.
+ */
+export declare function codeTableFromSetting(setting: 'cp1252' | 'cp437' | null | undefined): CodeTableId;
+/**
+ * Zeichen, die das Vorbild vor dem Kodieren ersetzt (generator.dart `_encode`).
+ *
+ * **Eine bewusste Abweichung:** Fuer `•` sagt generator.dart `.`,
+ * print_paper.dart (portiert als `escPosPrintableText`) dagegen `*`. In Darts
+ * eigener Kette faellt das nie auf, weil print_paper vor dem Erzeuger ersetzt
+ * und der Erzeuger den Punkt nie zu sehen bekommt -- die gedruckte Antwort ist
+ * dort also `*`. Ein Verbraucher dieses Pakets kann `escPosText` aber auch
+ * direkt aufrufen, und dann duerfen nicht zwei Zeichen fuer dasselbe Zeichen
+ * herauskommen. Deshalb gilt hier dieselbe Antwort wie dort.
+ */
+export declare const ZEICHEN_ERSATZ: ReadonlyArray<readonly [string, string]>;
+/**
+ * Latin-1-Byte -> CP437-Byte fuer die Zeichen, die CP437 kennt (deutsche
+ * Umlaute, ß, westeuropaeische Akzente, Waehrungs-/Sonderzeichen). Alles
+ * andere ab 0x80 hat in CP437 keinen Platz und wird zu "?".
+ */
+export declare const CP437_AUS_LATIN1: ReadonlyMap<number, number>;
+/**
+ * Wandelt Text in die Bytes einer Code-Tabelle: erst die vorhandenen
+ * Ersetzungen (`ZEICHEN_ERSATZ`), dann die zehn deutschen Zeichen je Tabelle
+ * (Byte oder Ersatzbuchstaben), ASCII unveraendert, alles uebrige ueber die
+ * Abbildung der Tabelle, sonst `?`. Ein Zeichen, das die Tabelle nicht
+ * kennt, ist genau ein Byte; nur die Ersatzbuchstaben machen aus einem
+ * Zeichen mehrere. Spalten darum immer an den fertigen Bytes messen.
+ */
+export declare function encodeForCodeTable(text: string, table: CodeTableId): Uint8Array;
+/** Wendet `ZEICHEN_ERSATZ` an (paketintern, nicht exportiert ueber den Einstieg). */
+export declare function replaceKnownCharacters(text: string): string;
+/**
+ * Wie `encodeForCodeTable`, aber fuer Text, der `ZEICHEN_ERSATZ` schon hinter
+ * sich hat (paketintern: der alte Pfad in `encodeEscPosText` ersetzt vor der
+ * Latin-1-Pruefung und soll nicht zweimal ersetzen).
+ */
+export declare function encodeReplaced(aufbereitet: string, table: CodeTableId): Uint8Array;