@aglyn/plugins-commerce 1.0.0-beta.230 → 1.0.0-beta.231

package/src/lib/pos-ops-config.js

@@ -0,0 +1,88 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ /*==========================================
+ * HOW THE REGISTER IS RUN (AGL-3609): shifts, refunds at the till, the
+ * staff lock and what the receipt prints. Pure data, spread into
+ * `COMMERCE_CONFIG_SCHEMA`, so the settings form, the routes and the
+ * register read one set of keys with one set of bounds.
+ *=========================================*/ /**
+ * The most a register refund may be without a manager's PIN, by default:
+ * nothing. Before this, only an admin of the whole workspace could refund at
+ * all, so a default above zero would hand every cashier refunds on the day it
+ * shipped. A merchant who trusts the till raises it.
+ */ export const POS_REFUND_LIMIT_DEFAULT = 0;
+export const POS_OPS_CONFIG_FIELDS = [
+    {
+        key: 'posRequireOpenShift',
+        label: 'Require an open shift to sell',
+        type: 'boolean',
+        description: 'A register refuses sales and cash refunds until someone opens a shift ' + 'with a starting float, so every sale is counted in a drawer.'
+    },
+    {
+        key: 'posRefundLimit',
+        label: 'Cashier refund limit ($)',
+        type: 'number',
+        min: 0,
+        max: 100000,
+        description: 'The largest return a cashier may refund at the register without a ' + 'manager entering their PIN. Workspace admins have no limit. Set to 0 to ' + 'have a manager approve every register refund.'
+    },
+    {
+        key: 'posAutoLockMinutes',
+        label: 'Lock the register after (minutes idle)',
+        type: 'number',
+        min: 0,
+        max: 240,
+        description: 'After this many minutes without a tap the register locks and asks for ' + 'a staff PIN. Set to 0 to never lock.'
+    },
+    {
+        key: 'posReceiptAddress',
+        label: 'Address on printed receipts',
+        type: 'string',
+        description: 'Printed under your store name. Put each line on its own line.'
+    },
+    {
+        key: 'posReturnPolicy',
+        label: 'Return policy on printed receipts',
+        type: 'string',
+        description: 'Printed at the foot of every receipt and gift receipt.'
+    }
+];
+export const POS_OPS_CONFIG_DEFAULTS = {
+    posRequireOpenShift: false,
+    posRefundLimit: POS_REFUND_LIMIT_DEFAULT,
+    posAutoLockMinutes: 0,
+    posReceiptAddress: '',
+    posReturnPolicy: ''
+};
+/**
+ * Read defensively: the framework has already clamped a schema'd value, and
+ * this second bound is for a config read without the schema.
+ */ export function posOpsSettings(config) {
+    var _ref, _ref1;
+    const number = (key, max, fallback)=>{
+        const raw = Number(config == null ? void 0 : config[key]);
+        return Number.isFinite(raw) ? Math.min(max, Math.max(0, raw)) : fallback;
+    };
+    return {
+        requireOpenShift: (config == null ? void 0 : config['posRequireOpenShift']) === true,
+        refundLimitCents: Math.round(number('posRefundLimit', 100000, POS_REFUND_LIMIT_DEFAULT) * 100),
+        autoLockMinutes: Math.round(number('posAutoLockMinutes', 240, 0)),
+        receiptAddress: String((_ref = config == null ? void 0 : config['posReceiptAddress']) != null ? _ref : '').slice(0, 500),
+        returnPolicy: String((_ref1 = config == null ? void 0 : config['posReturnPolicy']) != null ? _ref1 : '').slice(0, 1000)
+    };
+}
+
+//# sourceMappingURL=pos-ops-config.js.map

package/src/lib/pos-ops-config.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../libs/plugins/commerce/src/lib/pos-ops-config.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type { PluginConfigField } from '@aglyn/aglyn'\n\n/*==========================================\n * HOW THE REGISTER IS RUN (AGL-3609): shifts, refunds at the till, the\n * staff lock and what the receipt prints. Pure data, spread into\n * `COMMERCE_CONFIG_SCHEMA`, so the settings form, the routes and the\n * register read one set of keys with one set of bounds.\n *=========================================*/\n\n/**\n * The most a register refund may be without a manager's PIN, by default:\n * nothing. Before this, only an admin of the whole workspace could refund at\n * all, so a default above zero would hand every cashier refunds on the day it\n * shipped. A merchant who trusts the till raises it.\n */\nexport const POS_REFUND_LIMIT_DEFAULT = 0\n\nexport const POS_OPS_CONFIG_FIELDS: PluginConfigField[] = [\n  {\n    key: 'posRequireOpenShift',\n    label: 'Require an open shift to sell',\n    type: 'boolean',\n    description:\n      'A register refuses sales and cash refunds until someone opens a shift ' +\n      'with a starting float, so every sale is counted in a drawer.',\n  },\n  {\n    key: 'posRefundLimit',\n    label: 'Cashier refund limit ($)',\n    type: 'number',\n    min: 0,\n    max: 100000,\n    description:\n      'The largest return a cashier may refund at the register without a ' +\n      'manager entering their PIN. Workspace admins have no limit. Set to 0 to ' +\n      'have a manager approve every register refund.',\n  },\n  {\n    key: 'posAutoLockMinutes',\n    label: 'Lock the register after (minutes idle)',\n    type: 'number',\n    min: 0,\n    max: 240,\n    description:\n      'After this many minutes without a tap the register locks and asks for ' +\n      'a staff PIN. Set to 0 to never lock.',\n  },\n  {\n    key: 'posReceiptAddress',\n    label: 'Address on printed receipts',\n    type: 'string',\n    description: 'Printed under your store name. Put each line on its own line.',\n  },\n  {\n    key: 'posReturnPolicy',\n    label: 'Return policy on printed receipts',\n    type: 'string',\n    description: 'Printed at the foot of every receipt and gift receipt.',\n  },\n]\n\nexport const POS_OPS_CONFIG_DEFAULTS: Record<string, unknown> = {\n  posRequireOpenShift: false,\n  posRefundLimit: POS_REFUND_LIMIT_DEFAULT,\n  posAutoLockMinutes: 0,\n  posReceiptAddress: '',\n  posReturnPolicy: '',\n}\n\n/** The register settings, typed and bounded, for one site's merged config. */\nexport interface PosOpsSettings {\n  requireOpenShift: boolean\n  refundLimitCents: number\n  autoLockMinutes: number\n  receiptAddress: string\n  returnPolicy: string\n}\n\n/**\n * Read defensively: the framework has already clamped a schema'd value, and\n * this second bound is for a config read without the schema.\n */\nexport function posOpsSettings(config: Record<string, unknown> | null | undefined): PosOpsSettings {\n  const number = (key: string, max: number, fallback: number) => {\n    const raw = Number(config?.[key])\n    return Number.isFinite(raw) ? Math.min(max, Math.max(0, raw)) : fallback\n  }\n  return {\n    requireOpenShift: config?.['posRequireOpenShift'] === true,\n    refundLimitCents: Math.round(number('posRefundLimit', 100000, POS_REFUND_LIMIT_DEFAULT) * 100),\n    autoLockMinutes: Math.round(number('posAutoLockMinutes', 240, 0)),\n    receiptAddress: String(config?.['posReceiptAddress'] ?? '').slice(0, 500),\n    returnPolicy: String(config?.['posReturnPolicy'] ?? '').slice(0, 1000),\n  }\n}\n"],"names":["POS_REFUND_LIMIT_DEFAULT","POS_OPS_CONFIG_FIELDS","key","label","type","description","min","max","POS_OPS_CONFIG_DEFAULTS","posRequireOpenShift","posRefundLimit","posAutoLockMinutes","posReceiptAddress","posReturnPolicy","posOpsSettings","config","number","fallback","raw","Number","isFinite","Math","requireOpenShift","refundLimitCents","round","autoLockMinutes","receiptAddress","String","slice","returnPolicy"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAID;;;;;2CAK2C,GAE3C;;;;;CAKC,GACD,OAAO,MAAMA,2BAA2B,EAAC;AAEzC,OAAO,MAAMC,wBAA6C;IACxD;QACEC,KAAK;QACLC,OAAO;QACPC,MAAM;QACNC,aACE,2EACA;IACJ;IACA;QACEH,KAAK;QACLC,OAAO;QACPC,MAAM;QACNE,KAAK;QACLC,KAAK;QACLF,aACE,uEACA,6EACA;IACJ;IACA;QACEH,KAAK;QACLC,OAAO;QACPC,MAAM;QACNE,KAAK;QACLC,KAAK;QACLF,aACE,2EACA;IACJ;IACA;QACEH,KAAK;QACLC,OAAO;QACPC,MAAM;QACNC,aAAa;IACf;IACA;QACEH,KAAK;QACLC,OAAO;QACPC,MAAM;QACNC,aAAa;IACf;CACD,CAAA;AAED,OAAO,MAAMG,0BAAmD;IAC9DC,qBAAqB;IACrBC,gBAAgBV;IAChBW,oBAAoB;IACpBC,mBAAmB;IACnBC,iBAAiB;AACnB,EAAC;AAWD;;;CAGC,GACD,OAAO,SAASC,eAAeC,MAAkD;;IAC/E,MAAMC,SAAS,CAACd,KAAaK,KAAaU;QACxC,MAAMC,MAAMC,OAAOJ,0BAAAA,MAAQ,CAACb,IAAI;QAChC,OAAOiB,OAAOC,QAAQ,CAACF,OAAOG,KAAKf,GAAG,CAACC,KAAKc,KAAKd,GAAG,CAAC,GAAGW,QAAQD;IAClE;IACA,OAAO;QACLK,kBAAkBP,CAAAA,0BAAAA,MAAQ,CAAC,sBAAsB,MAAK;QACtDQ,kBAAkBF,KAAKG,KAAK,CAACR,OAAO,kBAAkB,QAAQhB,4BAA4B;QAC1FyB,iBAAiBJ,KAAKG,KAAK,CAACR,OAAO,sBAAsB,KAAK;QAC9DU,gBAAgBC,eAAOZ,0BAAAA,MAAQ,CAAC,oBAAoB,mBAAI,IAAIa,KAAK,CAAC,GAAG;QACrEC,cAAcF,gBAAOZ,0BAAAA,MAAQ,CAAC,kBAAkB,oBAAI,IAAIa,KAAK,CAAC,GAAG;IACnE;AACF"}

package/src/lib/printing/print-document.d.ts

@@ -0,0 +1,106 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { type ReceiptData } from '../model/commerce-receipt';
+import type { PrintReport } from '../model/commerce-printers';
+/**
+ * A printer-neutral document (AGL-3619): what a receipt, a test page or a
+ * drawer kick IS, laid out in fixed columns, before any vendor's bytes. Each
+ * renderer (`render-star.ts`, `render-epson.ts`, `render-text.ts`) translates
+ * these operations one for one, so the layout is decided once and a Star and
+ * an Epson print the same receipt.
+ *
+ * Text operations are one printed LINE each and already fit the paper: the
+ * layout wraps and pads here, because a thermal printer's own wrapping breaks
+ * mid-word and cannot right-align a price.
+ */
+export type PrintAlign = 'left' | 'center' | 'right';
+export type PrintOp = {
+    op: 'text';
+    text: string;
+    align?: PrintAlign;
+    bold?: boolean;
+    size?: 1 | 2;
+} | {
+    op: 'feed';
+    lines: number;
+} | {
+    op: 'barcode';
+    data: string;
+} | {
+    op: 'logo';
+} | {
+    op: 'drawer';
+} | {
+    op: 'cut';
+};
+export interface PrintDocument {
+    /** Characters per line at size 1. */
+    columns: number;
+    ops: PrintOp[];
+}
+/**
+ * Text as the printer's built-in ASCII font can print it. Accents are folded
+ * (`Crème brûlée` → `Creme brulee`), the punctuation a product name or a money
+ * format carries is spelled in ASCII, and anything left becomes `?` rather
+ * than the mojibake a raw UTF-8 byte prints as on a code-page printer.
+ */
+export declare function toPrintable(value: unknown): string;
+/** Words wrapped to `width`, breaking a word only when it alone is too long. */
+export declare function wrapText(text: string, width: number): string[];
+/**
+ * A left label and a right amount on one line; a label too long to share the
+ * line wraps above, so the amount always lands flush right.
+ */
+export declare function twoColumnLines(left: string, right: string, width: number): string[];
+export interface LayoutOptions {
+    columns: number;
+    /** Print the logo stored in the printer. */
+    logo?: boolean;
+    /** Kick the cash drawer as the receipt starts printing. */
+    openDrawer?: boolean;
+}
+/** The customer receipt. */
+export declare function layoutReceipt(receipt: ReceiptData, options: LayoutOptions): PrintDocument;
+/**
+ * The ticket the kitchen, the bar or the packing bench works from: the order
+ * number large enough to call out, when it was rung and on which register,
+ * then each item with its quantity and options. No prices, no tenders and no
+ * barcode: the people reading it are making the order, not paying for it.
+ */
+export declare function layoutKitchenTicket(receipt: ReceiptData, options: {
+    columns: number;
+}): PrintDocument;
+/**
+ * Code128 code set B carries printable ASCII, and a scanner reads a short
+ * symbol more reliably than a long one, so the data is the order number
+ * reduced to those characters and capped well under a receipt's width.
+ */
+export declare function code128Printable(value: unknown): string;
+/** The page "Print test" sends: proves the URL, the paper, the cutter and, if asked, the drawer. */
+export declare function layoutTestPage(input: {
+    columns: number;
+    printerName: string;
+    storeName: string;
+    atMs: number;
+    timeZone?: string;
+    logo?: boolean;
+    openDrawer?: boolean;
+}): PrintDocument;
+/** A titled report on the receipt roll: a shift's X or Z report (AGL-3609). */
+export declare function layoutReport(report: PrintReport, options: Pick<LayoutOptions, 'columns' | 'logo'>): PrintDocument;
+/** A drawer kick with nothing printed: a paid-out, a cash refund, "Open drawer". */
+export declare function layoutDrawerKick(columns: number): PrintDocument;

package/src/lib/printing/print-document.js

@@ -0,0 +1,464 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ import { formatReceiptMoney, formatReceiptTime } from "../model/commerce-receipt.js";
+const SYMBOLS = {
+    '•': '*',
+    '·': '*',
+    '–': '-',
+    '—': '-',
+    '‘': "'",
+    '’': "'",
+    '“': '"',
+    '”': '"',
+    '…': '...',
+    ' ': ' ',
+    ' ': ' ',
+    '€': 'EUR',
+    '£': 'GBP',
+    '¥': 'JPY',
+    '₹': 'INR'
+};
+/**
+ * Text as the printer's built-in ASCII font can print it. Accents are folded
+ * (`Crème brûlée` → `Creme brulee`), the punctuation a product name or a money
+ * format carries is spelled in ASCII, and anything left becomes `?` rather
+ * than the mojibake a raw UTF-8 byte prints as on a code-page printer.
+ */ export function toPrintable(value) {
+    return String(value != null ? value : '').normalize('NFKD').replace(/[̀-ͯ]/g, '').replace(/[^\x20-\x7e]/g, (char)=>{
+        var _SYMBOLS_char;
+        return (_SYMBOLS_char = SYMBOLS[char]) != null ? _SYMBOLS_char : /\s/.test(char) ? ' ' : '?';
+    });
+}
+/** Words wrapped to `width`, breaking a word only when it alone is too long. */ export function wrapText(text, width) {
+    const lines = [];
+    let current = '';
+    for (const word of toPrintable(text).split(/\s+/).filter(Boolean)){
+        let rest = word;
+        while(rest.length > width){
+            if (current) {
+                lines.push(current);
+                current = '';
+            }
+            lines.push(rest.slice(0, width));
+            rest = rest.slice(width);
+        }
+        if (!rest) continue;
+        if (!current) current = rest;
+        else if (current.length + 1 + rest.length <= width) current += ` ${rest}`;
+        else {
+            lines.push(current);
+            current = rest;
+        }
+    }
+    if (current) lines.push(current);
+    return lines.length ? lines : [
+        ''
+    ];
+}
+/**
+ * A left label and a right amount on one line; a label too long to share the
+ * line wraps above, so the amount always lands flush right.
+ */ export function twoColumnLines(left, right, width) {
+    var _wrapped_pop;
+    const amount = toPrintable(right);
+    const room = Math.max(1, width - amount.length - 1);
+    const wrapped = wrapText(left, room);
+    const last = (_wrapped_pop = wrapped.pop()) != null ? _wrapped_pop : '';
+    return [
+        ...wrapped,
+        `${last}${' '.repeat(Math.max(1, width - last.length - amount.length))}${amount}`
+    ];
+}
+const rule = (columns)=>({
+        op: 'text',
+        text: '-'.repeat(columns)
+    });
+/** The customer receipt. */ export function layoutReceipt(receipt, options) {
+    var _receipt_storeLines, _receipt_tenders, _receipt_barcode;
+    var _receipt_tenders1;
+    const { columns } = options;
+    const money = (cents)=>formatReceiptMoney(cents, receipt.currency);
+    const ops = [];
+    const line = (left, right, bold = false)=>{
+        for (const text of twoColumnLines(left, right, columns))ops.push({
+            op: 'text',
+            text,
+            bold
+        });
+    };
+    // The drawer first: the cashier makes change while the receipt prints.
+    if (options.openDrawer) ops.push({
+        op: 'drawer'
+    });
+    if (options.logo) ops.push({
+        op: 'logo'
+    });
+    if (receipt.banner) {
+        ops.push({
+            op: 'text',
+            text: toPrintable(receipt.banner).slice(0, Math.floor(columns / 2)),
+            align: 'center',
+            bold: true,
+            size: 2
+        });
+    }
+    for (const text of wrapText(receipt.storeName, Math.floor(columns / 2))){
+        ops.push({
+            op: 'text',
+            text,
+            align: 'center',
+            bold: true,
+            size: 2
+        });
+    }
+    for (const storeLine of (_receipt_storeLines = receipt.storeLines) != null ? _receipt_storeLines : []){
+        for (const text of wrapText(storeLine, columns))ops.push({
+            op: 'text',
+            text,
+            align: 'center'
+        });
+    }
+    ops.push({
+        op: 'feed',
+        lines: 1
+    });
+    line(`Order #${receipt.orderNumber}`, formatReceiptTime(receipt.createdAtMs, receipt.timeZone));
+    const who = [
+        receipt.registerName,
+        receipt.cashierName
+    ].filter(Boolean).join(' - ');
+    if (who) for (const text of wrapText(who, columns))ops.push({
+        op: 'text',
+        text
+    });
+    ops.push(rule(columns));
+    for (const item of receipt.lines){
+        const label = item.quantity > 1 ? `${item.quantity} x ${item.name}` : item.name;
+        line(label, money(item.totalCents));
+        if (item.detail) {
+            for (const text of wrapText(item.detail, columns - 2))ops.push({
+                op: 'text',
+                text: `  ${text}`
+            });
+        }
+        if (item.quantity > 1) {
+            ops.push({
+                op: 'text',
+                text: toPrintable(`  @ ${money(item.unitCents)} each`).slice(0, columns)
+            });
+        }
+    }
+    ops.push(rule(columns));
+    line('Subtotal', money(receipt.subtotalCents));
+    if (receipt.discountCents) line('Discount', `-${money(receipt.discountCents)}`);
+    if (receipt.shippingCents) line('Shipping', money(receipt.shippingCents));
+    if (receipt.taxCents) line('Tax', money(receipt.taxCents));
+    if (receipt.tipCents) line('Tip', money(receipt.tipCents));
+    for (const text of twoColumnLines('TOTAL', money(receipt.totalCents), Math.floor(columns / 2))){
+        ops.push({
+            op: 'text',
+            text,
+            bold: true,
+            size: 2
+        });
+    }
+    if (((_receipt_tenders1 = receipt.tenders) == null ? void 0 : _receipt_tenders1.length) || receipt.changeCents) ops.push({
+        op: 'feed',
+        lines: 1
+    });
+    for (const tender of (_receipt_tenders = receipt.tenders) != null ? _receipt_tenders : [])line(tender.label, money(tender.amountCents));
+    if (receipt.changeCents) line('Change', money(receipt.changeCents), true);
+    if (receipt.refundedCents) line('Refunded', `-${money(receipt.refundedCents)}`);
+    const barcode = code128Printable((_receipt_barcode = receipt.barcode) != null ? _receipt_barcode : receipt.orderNumber);
+    if (barcode) {
+        ops.push({
+            op: 'feed',
+            lines: 1
+        });
+        ops.push({
+            op: 'barcode',
+            data: barcode
+        });
+    }
+    if (receipt.footer) {
+        ops.push({
+            op: 'feed',
+            lines: 1
+        });
+        for (const text of wrapText(receipt.footer, columns))ops.push({
+            op: 'text',
+            text,
+            align: 'center'
+        });
+    }
+    ops.push({
+        op: 'feed',
+        lines: 2
+    });
+    ops.push({
+        op: 'cut'
+    });
+    return {
+        columns,
+        ops
+    };
+}
+/**
+ * The ticket the kitchen, the bar or the packing bench works from: the order
+ * number large enough to call out, when it was rung and on which register,
+ * then each item with its quantity and options. No prices, no tenders and no
+ * barcode: the people reading it are making the order, not paying for it.
+ */ export function layoutKitchenTicket(receipt, options) {
+    var _receipt_registerName;
+    const { columns } = options;
+    const half = Math.floor(columns / 2);
+    const ops = [];
+    if (receipt.banner) {
+        ops.push({
+            op: 'text',
+            text: toPrintable(receipt.banner).slice(0, half),
+            align: 'center',
+            bold: true,
+            size: 2
+        });
+    }
+    ops.push({
+        op: 'text',
+        text: toPrintable(`#${receipt.orderNumber}`).slice(0, half),
+        align: 'center',
+        bold: true,
+        size: 2
+    });
+    for (const text of twoColumnLines((_receipt_registerName = receipt.registerName) != null ? _receipt_registerName : '', formatReceiptTime(receipt.createdAtMs, receipt.timeZone), columns)){
+        ops.push({
+            op: 'text',
+            text
+        });
+    }
+    ops.push(rule(columns));
+    for (const item of receipt.lines){
+        // Quantity first and large: "2 x Latte" read across a kitchen.
+        for (const text of wrapText(`${item.quantity} x ${item.name}`, half)){
+            ops.push({
+                op: 'text',
+                text,
+                bold: true,
+                size: 2
+            });
+        }
+        if (item.detail) {
+            for (const text of wrapText(item.detail, columns - 2))ops.push({
+                op: 'text',
+                text: `  ${text}`
+            });
+        }
+    }
+    ops.push(rule(columns));
+    const count = receipt.lines.reduce((sum, item)=>sum + item.quantity, 0);
+    ops.push({
+        op: 'text',
+        text: `${count} ${count === 1 ? 'item' : 'items'}`,
+        align: 'right'
+    });
+    ops.push({
+        op: 'feed',
+        lines: 2
+    });
+    ops.push({
+        op: 'cut'
+    });
+    return {
+        columns,
+        ops
+    };
+}
+/**
+ * Code128 code set B carries printable ASCII, and a scanner reads a short
+ * symbol more reliably than a long one, so the data is the order number
+ * reduced to those characters and capped well under a receipt's width.
+ */ export function code128Printable(value) {
+    return toPrintable(value).replace(/[^\x21-\x7e]/g, '').slice(0, 20);
+}
+/** The page "Print test" sends: proves the URL, the paper, the cutter and, if asked, the drawer. */ export function layoutTestPage(input) {
+    const { columns } = input;
+    const ops = [];
+    if (input.openDrawer) ops.push({
+        op: 'drawer'
+    });
+    if (input.logo) ops.push({
+        op: 'logo'
+    });
+    ops.push({
+        op: 'text',
+        text: 'TEST PRINT',
+        align: 'center',
+        bold: true,
+        size: 2
+    });
+    for (const text of wrapText(input.storeName, columns))ops.push({
+        op: 'text',
+        text,
+        align: 'center'
+    });
+    ops.push({
+        op: 'feed',
+        lines: 1
+    });
+    for (const text of twoColumnLines('Printer', input.printerName, columns))ops.push({
+        op: 'text',
+        text
+    });
+    for (const text of twoColumnLines('Sent', formatReceiptTime(input.atMs, input.timeZone), columns)){
+        ops.push({
+            op: 'text',
+            text
+        });
+    }
+    ops.push({
+        op: 'text',
+        text: '-'.repeat(columns)
+    });
+    ops.push({
+        op: 'text',
+        text: 'Left aligned'
+    });
+    ops.push({
+        op: 'text',
+        text: 'Centered',
+        align: 'center'
+    });
+    ops.push({
+        op: 'text',
+        text: 'Right aligned',
+        align: 'right'
+    });
+    ops.push({
+        op: 'text',
+        text: 'Bold text',
+        bold: true
+    });
+    ops.push({
+        op: 'text',
+        text: 'Large',
+        size: 2
+    });
+    ops.push({
+        op: 'text',
+        text: '0123456789'.repeat(Math.ceil(columns / 10)).slice(0, columns)
+    });
+    ops.push({
+        op: 'feed',
+        lines: 1
+    });
+    ops.push({
+        op: 'barcode',
+        data: 'TEST-PRINT'
+    });
+    ops.push({
+        op: 'feed',
+        lines: 1
+    });
+    for (const text of wrapText('If you can read this, receipts will print here.', columns)){
+        ops.push({
+            op: 'text',
+            text,
+            align: 'center'
+        });
+    }
+    ops.push({
+        op: 'feed',
+        lines: 2
+    });
+    ops.push({
+        op: 'cut'
+    });
+    return {
+        columns,
+        ops
+    };
+}
+/** A titled report on the receipt roll: a shift's X or Z report (AGL-3609). */ export function layoutReport(report, options) {
+    const { columns } = options;
+    const ops = [];
+    if (options.logo) ops.push({
+        op: 'logo'
+    });
+    for (const text of wrapText(report.storeName, Math.floor(columns / 2))){
+        ops.push({
+            op: 'text',
+            text,
+            align: 'center',
+            bold: true,
+            size: 2
+        });
+    }
+    for (const text of wrapText(report.title, Math.floor(columns / 2))){
+        ops.push({
+            op: 'text',
+            text,
+            align: 'center',
+            bold: true,
+            size: 2
+        });
+    }
+    if (report.subtitle) {
+        for (const text of wrapText(report.subtitle, columns))ops.push({
+            op: 'text',
+            text,
+            align: 'center'
+        });
+    }
+    for (const section of report.sections){
+        ops.push(rule(columns));
+        ops.push({
+            op: 'text',
+            text: toPrintable(section.section.toUpperCase()).slice(0, columns),
+            bold: true
+        });
+        for (const row of section.rows){
+            for (const text of twoColumnLines(row.label, row.value, columns)){
+                ops.push({
+                    op: 'text',
+                    text,
+                    bold: row.strong === true
+                });
+            }
+        }
+    }
+    ops.push({
+        op: 'feed',
+        lines: 2
+    });
+    ops.push({
+        op: 'cut'
+    });
+    return {
+        columns,
+        ops
+    };
+}
+/** A drawer kick with nothing printed: a paid-out, a cash refund, "Open drawer". */ export function layoutDrawerKick(columns) {
+    return {
+        columns,
+        ops: [
+            {
+                op: 'drawer'
+            }
+        ]
+    };
+}
+
+//# sourceMappingURL=print-document.js.map