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

package/src/lib/components/console/pos-ops/pos-receipt.d.ts

@@ -0,0 +1,39 @@
+/**
+ * @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 PosReceipt } from '../../../model/commerce-pos-ops';
+export declare const POS_RECEIPT_STYLES = "\n@page { size: 80mm auto; margin: 0; }\n* { box-sizing: border-box; }\nhtml, body { margin: 0; padding: 0; background: #fff; color: #000; }\nbody { width: 80mm; padding: 4mm; font: 12px/1.35 ui-monospace, 'SFMono-Regular', Menlo, Consolas, 'Liberation Mono', monospace; }\n.receipt { width: 72mm; }\n.center { text-align: center; }\n.logo { display: block; max-width: 48mm; max-height: 20mm; margin: 0 auto 2mm; }\n.store { font-size: 15px; font-weight: 700; }\n.muted { font-size: 11px; }\n.rule { border: 0; border-top: 1px dashed #000; margin: 2mm 0; }\n.row { display: flex; justify-content: space-between; gap: 2mm; }\n.row > span:first-child { flex: 1; overflow-wrap: anywhere; }\n.row > span:last-child { white-space: nowrap; }\n.item { margin-bottom: 1mm; }\n.total { font-size: 14px; font-weight: 700; }\n.barcode { margin: 3mm auto 1mm; text-align: center; }\n.barcode svg { width: 60mm; height: 12mm; }\n.title { font-weight: 700; letter-spacing: 0.1em; }\n@media screen { body { margin: 0 auto; } }\n";
+/**
+ * The logo a receipt prints, from the site's stored `logoUrl`.
+ *
+ * A logo picked from the media library is stored as a `media:` reference,
+ * which the customer display resolves through `resolveMediaSrc`. The receipt
+ * resolves it the same way and makes it absolute against the console's
+ * origin, because the print window is not the page the reference was read on.
+ * Only an `https:` URL is printed: anything else is a stored value no resolver
+ * recognized, or a page served over plain HTTP.
+ */
+export declare function posReceiptLogoUrl(stored: unknown, hostId: string, origin: string | null | undefined): string | undefined;
+/** The receipt's body as HTML, every value escaped. */
+export declare function posReceiptHtml(receipt: PosReceipt): string;
+/** A whole printable document: the receipt and its 80 mm page. */
+export declare function posReceiptDocument(receipt: PosReceipt): string;
+/**
+ * Prints the receipt through the browser's print dialog from a hidden frame,
+ * so the register page itself never reflows. Waits for the logo (if any) so
+ * the first print is not missing it, and removes the frame afterwards.
+ */
+export declare function printPosReceipt(receipt: PosReceipt): void;

package/src/lib/components/console/pos-ops/pos-receipt.js

@@ -0,0 +1,182 @@
+/**
+ * @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 { absoluteMediaSrc } from "@aglyn/aglyn/app-utils/media-ref";
+import { posMoney } from "../../../model/commerce-pos-ops.js";
+import { code128Svg } from "../../../utils/code128.js";
+import { escapeHtml } from "../../../utils/escape-html.js";
+/*==========================================
+ * THE THERMAL RECEIPT (AGL-3609).
+ *
+ * An 80 mm roll prints a 72 mm column. The page is sized to the roll and has
+ * no margin, so the printer driver feeds exactly as much paper as the receipt
+ * needs; everything is black on white because a thermal head prints nothing
+ * else, and the type is the printer's own monospace stack so columns line up.
+ *
+ * Most network receipt printers open the cash drawer wired to them when they
+ * print, so printing the receipt for a cash sale is also what opens the
+ * drawer. That is the printer's setting, not this page's.
+ *=========================================*/ // Thermal paper prints one ink, so the receipt is black on white and never
+// takes the console theme's colors.
+export const POS_RECEIPT_STYLES = `
+@page { size: 80mm auto; margin: 0; }
+* { box-sizing: border-box; }
+html, body { margin: 0; padding: 0; background: #fff; color: #000; }
+body { width: 80mm; padding: 4mm; font: 12px/1.35 ui-monospace, 'SFMono-Regular', Menlo, Consolas, 'Liberation Mono', monospace; }
+.receipt { width: 72mm; }
+.center { text-align: center; }
+.logo { display: block; max-width: 48mm; max-height: 20mm; margin: 0 auto 2mm; }
+.store { font-size: 15px; font-weight: 700; }
+.muted { font-size: 11px; }
+.rule { border: 0; border-top: 1px dashed #000; margin: 2mm 0; }
+.row { display: flex; justify-content: space-between; gap: 2mm; }
+.row > span:first-child { flex: 1; overflow-wrap: anywhere; }
+.row > span:last-child { white-space: nowrap; }
+.item { margin-bottom: 1mm; }
+.total { font-size: 14px; font-weight: 700; }
+.barcode { margin: 3mm auto 1mm; text-align: center; }
+.barcode svg { width: 60mm; height: 12mm; }
+.title { font-weight: 700; letter-spacing: 0.1em; }
+@media screen { body { margin: 0 auto; } }
+`;
+const row = (left, right, className = 'row')=>`<div class="${className}"><span>${escapeHtml(left)}</span><span>${escapeHtml(right)}</span></div>`;
+/**
+ * The logo a receipt prints, from the site's stored `logoUrl`.
+ *
+ * A logo picked from the media library is stored as a `media:` reference,
+ * which the customer display resolves through `resolveMediaSrc`. The receipt
+ * resolves it the same way and makes it absolute against the console's
+ * origin, because the print window is not the page the reference was read on.
+ * Only an `https:` URL is printed: anything else is a stored value no resolver
+ * recognized, or a page served over plain HTTP.
+ */ export function posReceiptLogoUrl(stored, hostId, origin) {
+    if (typeof stored !== 'string' || !stored) return undefined;
+    const url = absoluteMediaSrc(stored, {
+        hostId,
+        origin: origin != null ? origin : null
+    });
+    return url && /^https:\/\//.test(url) ? url : undefined;
+}
+/** The receipt's body as HTML, every value escaped. */ export function posReceiptHtml(receipt) {
+    const parts = [
+        '<div class="receipt">',
+        '<div class="center">'
+    ];
+    if (receipt.logoUrl && /^https:\/\//.test(receipt.logoUrl)) {
+        parts.push(`<img class="logo" src="${escapeHtml(receipt.logoUrl)}" alt="">`);
+    }
+    parts.push(`<div class="store">${escapeHtml(receipt.storeName)}</div>`);
+    for (const line of receipt.addressLines)parts.push(`<div class="muted">${escapeHtml(line)}</div>`);
+    if (receipt.gift) parts.push('<div class="title">GIFT RECEIPT</div>');
+    parts.push('</div><hr class="rule">');
+    parts.push(row(`Order ${receipt.orderNumber}`, receipt.dateLabel, 'row muted'));
+    if (receipt.registerName) parts.push(row('Register', receipt.registerName, 'row muted'));
+    if (receipt.cashierName) parts.push(row('Cashier', receipt.cashierName, 'row muted'));
+    if (receipt.customerName) parts.push(row('Customer', receipt.customerName, 'row muted'));
+    parts.push('<hr class="rule">');
+    for (const line of receipt.lines){
+        const label = `${line.quantity} × ${line.name}${line.variantLabel ? ` (${line.variantLabel})` : ''}`;
+        parts.push(receipt.gift ? `<div class="item">${escapeHtml(label)}</div>` : `<div class="item">${row(label, posMoney(line.lineCents))}${line.quantity > 1 ? `<div class="muted">&nbsp;&nbsp;${escapeHtml(posMoney(line.unitAmountCents))} each</div>` : ''}</div>`);
+    }
+    if (!receipt.gift) {
+        parts.push('<hr class="rule">');
+        parts.push(row('Subtotal', posMoney(receipt.subtotalCents)));
+        if (receipt.discountCents > 0) parts.push(row('Discount', `-${posMoney(receipt.discountCents)}`));
+        if (receipt.taxCents > 0) parts.push(row('Tax', posMoney(receipt.taxCents)));
+        parts.push(row('Total', posMoney(receipt.totalCents), 'row total'));
+        if (receipt.tipCents > 0) parts.push(row('Tip', posMoney(receipt.tipCents)));
+        if (receipt.tenders.length) {
+            parts.push('<hr class="rule">');
+            for (const tender of receipt.tenders)parts.push(row(tender.label, posMoney(tender.amountCents)));
+            if (receipt.changeCents > 0) parts.push(row('Change', posMoney(receipt.changeCents)));
+        }
+        if (receipt.refundedCents > 0) parts.push(row('Refunded', `-${posMoney(receipt.refundedCents)}`));
+    }
+    try {
+        parts.push(`<div class="barcode">${code128Svg(receipt.barcodeValue, {
+            height: 48,
+            moduleWidth: 2,
+            title: receipt.orderNumber
+        })}<div class="muted">${escapeHtml(receipt.orderNumber)}</div></div>`);
+    } catch (unused) {
+    // An order id code 128 cannot carry prints its number alone.
+    }
+    if (receipt.footer || receipt.returnPolicy) parts.push('<hr class="rule">');
+    if (receipt.footer) parts.push(`<div class="center muted">${escapeHtml(receipt.footer)}</div>`);
+    if (receipt.returnPolicy) {
+        parts.push(`<div class="center muted">${escapeHtml(receipt.returnPolicy)}</div>`);
+    }
+    parts.push('</div>');
+    return parts.join('');
+}
+/** A whole printable document: the receipt and its 80 mm page. */ export function posReceiptDocument(receipt) {
+    return '<!doctype html><html><head><meta charset="utf-8">' + `<title>${escapeHtml(`Receipt ${receipt.orderNumber}`)}</title>` + `<style>${POS_RECEIPT_STYLES}</style></head><body>${posReceiptHtml(receipt)}</body></html>`;
+}
+/**
+ * Prints the receipt through the browser's print dialog from a hidden frame,
+ * so the register page itself never reflows. Waits for the logo (if any) so
+ * the first print is not missing it, and removes the frame afterwards.
+ */ export function printPosReceipt(receipt) {
+    var _frame_contentDocument;
+    if (typeof document === 'undefined') return;
+    const frame = document.createElement('iframe');
+    frame.setAttribute('aria-hidden', 'true');
+    frame.style.position = 'fixed';
+    frame.style.width = '0';
+    frame.style.height = '0';
+    frame.style.border = '0';
+    frame.style.right = '0';
+    frame.style.bottom = '0';
+    document.body.appendChild(frame);
+    const win = frame.contentWindow;
+    const doc = (_frame_contentDocument = frame.contentDocument) != null ? _frame_contentDocument : win == null ? void 0 : win.document;
+    if (!win || !doc) {
+        frame.remove();
+        return;
+    }
+    doc.open();
+    doc.write(posReceiptDocument(receipt));
+    doc.close();
+    const cleanup = ()=>window.setTimeout(()=>frame.remove(), 1000);
+    const go = ()=>{
+        win.addEventListener('afterprint', cleanup, {
+            once: true
+        });
+        win.focus();
+        win.print();
+        // Browsers that never fire `afterprint` still drop the frame.
+        window.setTimeout(()=>frame.isConnected && frame.remove(), 60000);
+    };
+    const images = Array.from(doc.images);
+    if (!images.length) return go();
+    let waiting = images.length;
+    const done = ()=>{
+        waiting -= 1;
+        if (waiting === 0) go();
+    };
+    for (const image of images){
+        if (image.complete) done();
+        else {
+            image.addEventListener('load', done, {
+                once: true
+            });
+            image.addEventListener('error', done, {
+                once: true
+            });
+        }
+    }
+}
+
+//# sourceMappingURL=pos-receipt.js.map

package/src/lib/components/console/pos-ops/pos-receipt.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../../libs/plugins/commerce/src/lib/components/console/pos-ops/pos-receipt.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 { absoluteMediaSrc } from '@aglyn/aglyn/app-utils/media-ref'\nimport { posMoney, type PosReceipt } from '../../../model/commerce-pos-ops'\nimport { code128Svg } from '../../../utils/code128'\nimport { escapeHtml } from '../../../utils/escape-html'\n\n/*==========================================\n * THE THERMAL RECEIPT (AGL-3609).\n *\n * An 80 mm roll prints a 72 mm column. The page is sized to the roll and has\n * no margin, so the printer driver feeds exactly as much paper as the receipt\n * needs; everything is black on white because a thermal head prints nothing\n * else, and the type is the printer's own monospace stack so columns line up.\n *\n * Most network receipt printers open the cash drawer wired to them when they\n * print, so printing the receipt for a cash sale is also what opens the\n * drawer. That is the printer's setting, not this page's.\n *=========================================*/\n\n// Thermal paper prints one ink, so the receipt is black on white and never\n// takes the console theme's colors.\nexport const POS_RECEIPT_STYLES = `\n@page { size: 80mm auto; margin: 0; }\n* { box-sizing: border-box; }\nhtml, body { margin: 0; padding: 0; background: #fff; color: #000; }\nbody { width: 80mm; padding: 4mm; font: 12px/1.35 ui-monospace, 'SFMono-Regular', Menlo, Consolas, 'Liberation Mono', monospace; }\n.receipt { width: 72mm; }\n.center { text-align: center; }\n.logo { display: block; max-width: 48mm; max-height: 20mm; margin: 0 auto 2mm; }\n.store { font-size: 15px; font-weight: 700; }\n.muted { font-size: 11px; }\n.rule { border: 0; border-top: 1px dashed #000; margin: 2mm 0; }\n.row { display: flex; justify-content: space-between; gap: 2mm; }\n.row > span:first-child { flex: 1; overflow-wrap: anywhere; }\n.row > span:last-child { white-space: nowrap; }\n.item { margin-bottom: 1mm; }\n.total { font-size: 14px; font-weight: 700; }\n.barcode { margin: 3mm auto 1mm; text-align: center; }\n.barcode svg { width: 60mm; height: 12mm; }\n.title { font-weight: 700; letter-spacing: 0.1em; }\n@media screen { body { margin: 0 auto; } }\n`\n\nconst row = (left: string, right: string, className = 'row') =>\n  `<div class=\"${className}\"><span>${escapeHtml(left)}</span><span>${escapeHtml(right)}</span></div>`\n\n/**\n * The logo a receipt prints, from the site's stored `logoUrl`.\n *\n * A logo picked from the media library is stored as a `media:` reference,\n * which the customer display resolves through `resolveMediaSrc`. The receipt\n * resolves it the same way and makes it absolute against the console's\n * origin, because the print window is not the page the reference was read on.\n * Only an `https:` URL is printed: anything else is a stored value no resolver\n * recognized, or a page served over plain HTTP.\n */\nexport function posReceiptLogoUrl(\n  stored: unknown,\n  hostId: string,\n  origin: string | null | undefined,\n): string | undefined {\n  if (typeof stored !== 'string' || !stored) return undefined\n  const url = absoluteMediaSrc(stored, { hostId, origin: origin ?? null })\n  return url && /^https:\\/\\//.test(url) ? url : undefined\n}\n\n/** The receipt's body as HTML, every value escaped. */\nexport function posReceiptHtml(receipt: PosReceipt): string {\n  const parts: string[] = ['<div class=\"receipt\">', '<div class=\"center\">']\n  if (receipt.logoUrl && /^https:\\/\\//.test(receipt.logoUrl)) {\n    parts.push(`<img class=\"logo\" src=\"${escapeHtml(receipt.logoUrl)}\" alt=\"\">`)\n  }\n  parts.push(`<div class=\"store\">${escapeHtml(receipt.storeName)}</div>`)\n  for (const line of receipt.addressLines) parts.push(`<div class=\"muted\">${escapeHtml(line)}</div>`)\n  if (receipt.gift) parts.push('<div class=\"title\">GIFT RECEIPT</div>')\n  parts.push('</div><hr class=\"rule\">')\n  parts.push(row(`Order ${receipt.orderNumber}`, receipt.dateLabel, 'row muted'))\n  if (receipt.registerName) parts.push(row('Register', receipt.registerName, 'row muted'))\n  if (receipt.cashierName) parts.push(row('Cashier', receipt.cashierName, 'row muted'))\n  if (receipt.customerName) parts.push(row('Customer', receipt.customerName, 'row muted'))\n  parts.push('<hr class=\"rule\">')\n  for (const line of receipt.lines) {\n    const label = `${line.quantity} × ${line.name}${line.variantLabel ? ` (${line.variantLabel})` : ''}`\n    parts.push(\n      receipt.gift\n        ? `<div class=\"item\">${escapeHtml(label)}</div>`\n        : `<div class=\"item\">${row(label, posMoney(line.lineCents))}${\n            line.quantity > 1\n              ? `<div class=\"muted\">&nbsp;&nbsp;${escapeHtml(posMoney(line.unitAmountCents))} each</div>`\n              : ''\n          }</div>`,\n    )\n  }\n  if (!receipt.gift) {\n    parts.push('<hr class=\"rule\">')\n    parts.push(row('Subtotal', posMoney(receipt.subtotalCents)))\n    if (receipt.discountCents > 0) parts.push(row('Discount', `-${posMoney(receipt.discountCents)}`))\n    if (receipt.taxCents > 0) parts.push(row('Tax', posMoney(receipt.taxCents)))\n    parts.push(row('Total', posMoney(receipt.totalCents), 'row total'))\n    if (receipt.tipCents > 0) parts.push(row('Tip', posMoney(receipt.tipCents)))\n    if (receipt.tenders.length) {\n      parts.push('<hr class=\"rule\">')\n      for (const tender of receipt.tenders) parts.push(row(tender.label, posMoney(tender.amountCents)))\n      if (receipt.changeCents > 0) parts.push(row('Change', posMoney(receipt.changeCents)))\n    }\n    if (receipt.refundedCents > 0) parts.push(row('Refunded', `-${posMoney(receipt.refundedCents)}`))\n  }\n  try {\n    parts.push(\n      `<div class=\"barcode\">${code128Svg(receipt.barcodeValue, {\n        height: 48,\n        moduleWidth: 2,\n        title: receipt.orderNumber,\n      })}<div class=\"muted\">${escapeHtml(receipt.orderNumber)}</div></div>`,\n    )\n  } catch {\n    // An order id code 128 cannot carry prints its number alone.\n  }\n  if (receipt.footer || receipt.returnPolicy) parts.push('<hr class=\"rule\">')\n  if (receipt.footer) parts.push(`<div class=\"center muted\">${escapeHtml(receipt.footer)}</div>`)\n  if (receipt.returnPolicy) {\n    parts.push(`<div class=\"center muted\">${escapeHtml(receipt.returnPolicy)}</div>`)\n  }\n  parts.push('</div>')\n  return parts.join('')\n}\n\n/** A whole printable document: the receipt and its 80 mm page. */\nexport function posReceiptDocument(receipt: PosReceipt): string {\n  return (\n    '<!doctype html><html><head><meta charset=\"utf-8\">' +\n    `<title>${escapeHtml(`Receipt ${receipt.orderNumber}`)}</title>` +\n    `<style>${POS_RECEIPT_STYLES}</style></head><body>${posReceiptHtml(receipt)}</body></html>`\n  )\n}\n\n/**\n * Prints the receipt through the browser's print dialog from a hidden frame,\n * so the register page itself never reflows. Waits for the logo (if any) so\n * the first print is not missing it, and removes the frame afterwards.\n */\nexport function printPosReceipt(receipt: PosReceipt): void {\n  if (typeof document === 'undefined') return\n  const frame = document.createElement('iframe')\n  frame.setAttribute('aria-hidden', 'true')\n  frame.style.position = 'fixed'\n  frame.style.width = '0'\n  frame.style.height = '0'\n  frame.style.border = '0'\n  frame.style.right = '0'\n  frame.style.bottom = '0'\n  document.body.appendChild(frame)\n  const win = frame.contentWindow\n  const doc = frame.contentDocument ?? win?.document\n  if (!win || !doc) {\n    frame.remove()\n    return\n  }\n  doc.open()\n  doc.write(posReceiptDocument(receipt))\n  doc.close()\n  const cleanup = () => window.setTimeout(() => frame.remove(), 1000)\n  const go = () => {\n    win.addEventListener('afterprint', cleanup, { once: true })\n    win.focus()\n    win.print()\n    // Browsers that never fire `afterprint` still drop the frame.\n    window.setTimeout(() => frame.isConnected && frame.remove(), 60_000)\n  }\n  const images = Array.from(doc.images)\n  if (!images.length) return go()\n  let waiting = images.length\n  const done = () => {\n    waiting -= 1\n    if (waiting === 0) go()\n  }\n  for (const image of images) {\n    if (image.complete) done()\n    else {\n      image.addEventListener('load', done, { once: true })\n      image.addEventListener('error', done, { once: true })\n    }\n  }\n}\n"],"names":["absoluteMediaSrc","posMoney","code128Svg","escapeHtml","POS_RECEIPT_STYLES","row","left","right","className","posReceiptLogoUrl","stored","hostId","origin","undefined","url","test","posReceiptHtml","receipt","parts","logoUrl","push","storeName","line","addressLines","gift","orderNumber","dateLabel","registerName","cashierName","customerName","lines","label","quantity","name","variantLabel","lineCents","unitAmountCents","subtotalCents","discountCents","taxCents","totalCents","tipCents","tenders","length","tender","amountCents","changeCents","refundedCents","barcodeValue","height","moduleWidth","title","footer","returnPolicy","join","posReceiptDocument","printPosReceipt","frame","document","createElement","setAttribute","style","position","width","border","bottom","body","appendChild","win","contentWindow","doc","contentDocument","remove","open","write","close","cleanup","window","setTimeout","go","addEventListener","once","focus","print","isConnected","images","Array","from","waiting","done","image","complete"],"mappings":"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"}

package/src/lib/components/console/pos-ops/pos-return-dialog.component.d.ts

@@ -0,0 +1,40 @@
+/**
+ * @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.
+ */
+export interface PosReturnDialogProps {
+    open: boolean;
+    hostId: string;
+    registerId: string;
+    cashierAssertion?: string;
+    onClose: () => void;
+    /** Ring the exchange: a new sale for the same customer. */
+    onExchange?: (customer: {
+        email: string | null;
+        name: string | null;
+    }) => void;
+}
+/**
+ * A return at the register (AGL-3609): find the sale by its number — typed or
+ * scanned off the receipt's barcode — or by the customer's email, pick what
+ * came back, and refund it to the payments the sale was made with. Above
+ * the cashier's limit it asks for a manager's PIN, and when it is done it
+ * says exactly how much cash to hand over.
+ */
+export declare function PosReturnDialog(props: PosReturnDialogProps): import("react").JSX.Element;
+export declare namespace PosReturnDialog {
+    var displayName: string;
+}
+export default PosReturnDialog;