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

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/commerce/src/lib/printing/print-document.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 {\n  formatReceiptMoney,\n  formatReceiptTime,\n  type ReceiptData,\n} from '../model/commerce-receipt'\nimport type { PrintReport } from '../model/commerce-printers'\n\n/**\n * A printer-neutral document (AGL-3619): what a receipt, a test page or a\n * drawer kick IS, laid out in fixed columns, before any vendor's bytes. Each\n * renderer (`render-star.ts`, `render-epson.ts`, `render-text.ts`) translates\n * these operations one for one, so the layout is decided once and a Star and\n * an Epson print the same receipt.\n *\n * Text operations are one printed LINE each and already fit the paper: the\n * layout wraps and pads here, because a thermal printer's own wrapping breaks\n * mid-word and cannot right-align a price.\n */\nexport type PrintAlign = 'left' | 'center' | 'right'\n\nexport type PrintOp =\n  | { op: 'text'; text: string; align?: PrintAlign; bold?: boolean; size?: 1 | 2 }\n  | { op: 'feed'; lines: number }\n  | { op: 'barcode'; data: string }\n  | { op: 'logo' }\n  | { op: 'drawer' }\n  | { op: 'cut' }\n\nexport interface PrintDocument {\n  /** Characters per line at size 1. */\n  columns: number\n  ops: PrintOp[]\n}\n\nconst SYMBOLS: Record<string, string> = {\n  '•': '*', // bullet\n  '·': '*',\n  '–': '-',\n  '—': '-',\n  '‘': \"'\",\n  '’': \"'\",\n  '“': '\"',\n  '”': '\"',\n  '…': '...',\n  ' ': ' ',\n  ' ': ' ',\n  '€': 'EUR',\n  '£': 'GBP',\n  '¥': 'JPY',\n  '₹': 'INR',\n}\n\n/**\n * Text as the printer's built-in ASCII font can print it. Accents are folded\n * (`Crème brûlée` → `Creme brulee`), the punctuation a product name or a money\n * format carries is spelled in ASCII, and anything left becomes `?` rather\n * than the mojibake a raw UTF-8 byte prints as on a code-page printer.\n */\nexport function toPrintable(value: unknown): string {\n  return String(value ?? '')\n    .normalize('NFKD')\n    .replace(/[̀-ͯ]/g, '')\n    .replace(/[^\\x20-\\x7e]/g, (char) => SYMBOLS[char] ?? (/\\s/.test(char) ? ' ' : '?'))\n}\n\n/** Words wrapped to `width`, breaking a word only when it alone is too long. */\nexport function wrapText(text: string, width: number): string[] {\n  const lines: string[] = []\n  let current = ''\n  for (const word of toPrintable(text).split(/\\s+/).filter(Boolean)) {\n    let rest = word\n    while (rest.length > width) {\n      if (current) {\n        lines.push(current)\n        current = ''\n      }\n      lines.push(rest.slice(0, width))\n      rest = rest.slice(width)\n    }\n    if (!rest) continue\n    if (!current) current = rest\n    else if (current.length + 1 + rest.length <= width) current += ` ${rest}`\n    else {\n      lines.push(current)\n      current = rest\n    }\n  }\n  if (current) lines.push(current)\n  return lines.length ? lines : ['']\n}\n\n/**\n * A left label and a right amount on one line; a label too long to share the\n * line wraps above, so the amount always lands flush right.\n */\nexport function twoColumnLines(left: string, right: string, width: number): string[] {\n  const amount = toPrintable(right)\n  const room = Math.max(1, width - amount.length - 1)\n  const wrapped = wrapText(left, room)\n  const last = wrapped.pop() ?? ''\n  return [...wrapped, `${last}${' '.repeat(Math.max(1, width - last.length - amount.length))}${amount}`]\n}\n\nconst rule = (columns: number): PrintOp => ({ op: 'text', text: '-'.repeat(columns) })\n\nexport interface LayoutOptions {\n  columns: number\n  /** Print the logo stored in the printer. */\n  logo?: boolean\n  /** Kick the cash drawer as the receipt starts printing. */\n  openDrawer?: boolean\n}\n\n/** The customer receipt. */\nexport function layoutReceipt(receipt: ReceiptData, options: LayoutOptions): PrintDocument {\n  const { columns } = options\n  const money = (cents: number) => formatReceiptMoney(cents, receipt.currency)\n  const ops: PrintOp[] = []\n  const line = (left: string, right: string, bold = false) => {\n    for (const text of twoColumnLines(left, right, columns)) ops.push({ op: 'text', text, bold })\n  }\n  // The drawer first: the cashier makes change while the receipt prints.\n  if (options.openDrawer) ops.push({ op: 'drawer' })\n  if (options.logo) ops.push({ op: 'logo' })\n  if (receipt.banner) {\n    ops.push({ op: 'text', text: toPrintable(receipt.banner).slice(0, Math.floor(columns / 2)), align: 'center', bold: true, size: 2 })\n  }\n  for (const text of wrapText(receipt.storeName, Math.floor(columns / 2))) {\n    ops.push({ op: 'text', text, align: 'center', bold: true, size: 2 })\n  }\n  for (const storeLine of receipt.storeLines ?? []) {\n    for (const text of wrapText(storeLine, columns)) ops.push({ op: 'text', text, align: 'center' })\n  }\n  ops.push({ op: 'feed', lines: 1 })\n  line(`Order #${receipt.orderNumber}`, formatReceiptTime(receipt.createdAtMs, receipt.timeZone))\n  const who = [receipt.registerName, receipt.cashierName].filter(Boolean).join(' - ')\n  if (who) for (const text of wrapText(who, columns)) ops.push({ op: 'text', text })\n  ops.push(rule(columns))\n  for (const item of receipt.lines) {\n    const label = item.quantity > 1 ? `${item.quantity} x ${item.name}` : item.name\n    line(label, money(item.totalCents))\n    if (item.detail) {\n      for (const text of wrapText(item.detail, columns - 2)) ops.push({ op: 'text', text: `  ${text}` })\n    }\n    if (item.quantity > 1) {\n      ops.push({ op: 'text', text: toPrintable(`  @ ${money(item.unitCents)} each`).slice(0, columns) })\n    }\n  }\n  ops.push(rule(columns))\n  line('Subtotal', money(receipt.subtotalCents))\n  if (receipt.discountCents) line('Discount', `-${money(receipt.discountCents)}`)\n  if (receipt.shippingCents) line('Shipping', money(receipt.shippingCents))\n  if (receipt.taxCents) line('Tax', money(receipt.taxCents))\n  if (receipt.tipCents) line('Tip', money(receipt.tipCents))\n  for (const text of twoColumnLines('TOTAL', money(receipt.totalCents), Math.floor(columns / 2))) {\n    ops.push({ op: 'text', text, bold: true, size: 2 })\n  }\n  if (receipt.tenders?.length || receipt.changeCents) ops.push({ op: 'feed', lines: 1 })\n  for (const tender of receipt.tenders ?? []) line(tender.label, money(tender.amountCents))\n  if (receipt.changeCents) line('Change', money(receipt.changeCents), true)\n  if (receipt.refundedCents) line('Refunded', `-${money(receipt.refundedCents)}`)\n  const barcode = code128Printable(receipt.barcode ?? receipt.orderNumber)\n  if (barcode) {\n    ops.push({ op: 'feed', lines: 1 })\n    ops.push({ op: 'barcode', data: barcode })\n  }\n  if (receipt.footer) {\n    ops.push({ op: 'feed', lines: 1 })\n    for (const text of wrapText(receipt.footer, columns)) ops.push({ op: 'text', text, align: 'center' })\n  }\n  ops.push({ op: 'feed', lines: 2 })\n  ops.push({ op: 'cut' })\n  return { columns, ops }\n}\n\n/**\n * The ticket the kitchen, the bar or the packing bench works from: the order\n * number large enough to call out, when it was rung and on which register,\n * then each item with its quantity and options. No prices, no tenders and no\n * barcode: the people reading it are making the order, not paying for it.\n */\nexport function layoutKitchenTicket(receipt: ReceiptData, options: { columns: number }): PrintDocument {\n  const { columns } = options\n  const half = Math.floor(columns / 2)\n  const ops: PrintOp[] = []\n  if (receipt.banner) {\n    ops.push({ op: 'text', text: toPrintable(receipt.banner).slice(0, half), align: 'center', bold: true, size: 2 })\n  }\n  ops.push({ op: 'text', text: toPrintable(`#${receipt.orderNumber}`).slice(0, half), align: 'center', bold: true, size: 2 })\n  for (const text of twoColumnLines(\n    receipt.registerName ?? '',\n    formatReceiptTime(receipt.createdAtMs, receipt.timeZone),\n    columns,\n  )) {\n    ops.push({ op: 'text', text })\n  }\n  ops.push(rule(columns))\n  for (const item of receipt.lines) {\n    // Quantity first and large: \"2 x Latte\" read across a kitchen.\n    for (const text of wrapText(`${item.quantity} x ${item.name}`, half)) {\n      ops.push({ op: 'text', text, bold: true, size: 2 })\n    }\n    if (item.detail) {\n      for (const text of wrapText(item.detail, columns - 2)) ops.push({ op: 'text', text: `  ${text}` })\n    }\n  }\n  ops.push(rule(columns))\n  const count = receipt.lines.reduce((sum, item) => sum + item.quantity, 0)\n  ops.push({ op: 'text', text: `${count} ${count === 1 ? 'item' : 'items'}`, align: 'right' })\n  ops.push({ op: 'feed', lines: 2 })\n  ops.push({ op: 'cut' })\n  return { columns, ops }\n}\n\n/**\n * Code128 code set B carries printable ASCII, and a scanner reads a short\n * symbol more reliably than a long one, so the data is the order number\n * reduced to those characters and capped well under a receipt's width.\n */\nexport function code128Printable(value: unknown): string {\n  return toPrintable(value).replace(/[^\\x21-\\x7e]/g, '').slice(0, 20)\n}\n\n/** The page \"Print test\" sends: proves the URL, the paper, the cutter and, if asked, the drawer. */\nexport function layoutTestPage(input: {\n  columns: number\n  printerName: string\n  storeName: string\n  atMs: number\n  timeZone?: string\n  logo?: boolean\n  openDrawer?: boolean\n}): PrintDocument {\n  const { columns } = input\n  const ops: PrintOp[] = []\n  if (input.openDrawer) ops.push({ op: 'drawer' })\n  if (input.logo) ops.push({ op: 'logo' })\n  ops.push({ op: 'text', text: 'TEST PRINT', align: 'center', bold: true, size: 2 })\n  for (const text of wrapText(input.storeName, columns)) ops.push({ op: 'text', text, align: 'center' })\n  ops.push({ op: 'feed', lines: 1 })\n  for (const text of twoColumnLines('Printer', input.printerName, columns)) ops.push({ op: 'text', text })\n  for (const text of twoColumnLines('Sent', formatReceiptTime(input.atMs, input.timeZone), columns)) {\n    ops.push({ op: 'text', text })\n  }\n  ops.push({ op: 'text', text: '-'.repeat(columns) })\n  ops.push({ op: 'text', text: 'Left aligned' })\n  ops.push({ op: 'text', text: 'Centered', align: 'center' })\n  ops.push({ op: 'text', text: 'Right aligned', align: 'right' })\n  ops.push({ op: 'text', text: 'Bold text', bold: true })\n  ops.push({ op: 'text', text: 'Large', size: 2 })\n  ops.push({ op: 'text', text: '0123456789'.repeat(Math.ceil(columns / 10)).slice(0, columns) })\n  ops.push({ op: 'feed', lines: 1 })\n  ops.push({ op: 'barcode', data: 'TEST-PRINT' })\n  ops.push({ op: 'feed', lines: 1 })\n  for (const text of wrapText('If you can read this, receipts will print here.', columns)) {\n    ops.push({ op: 'text', text, align: 'center' })\n  }\n  ops.push({ op: 'feed', lines: 2 })\n  ops.push({ op: 'cut' })\n  return { columns, ops }\n}\n\n/** A titled report on the receipt roll: a shift's X or Z report (AGL-3609). */\nexport function layoutReport(report: PrintReport, options: Pick<LayoutOptions, 'columns' | 'logo'>): PrintDocument {\n  const { columns } = options\n  const ops: PrintOp[] = []\n  if (options.logo) ops.push({ op: 'logo' })\n  for (const text of wrapText(report.storeName, Math.floor(columns / 2))) {\n    ops.push({ op: 'text', text, align: 'center', bold: true, size: 2 })\n  }\n  for (const text of wrapText(report.title, Math.floor(columns / 2))) {\n    ops.push({ op: 'text', text, align: 'center', bold: true, size: 2 })\n  }\n  if (report.subtitle) {\n    for (const text of wrapText(report.subtitle, columns)) ops.push({ op: 'text', text, align: 'center' })\n  }\n  for (const section of report.sections) {\n    ops.push(rule(columns))\n    ops.push({ op: 'text', text: toPrintable(section.section.toUpperCase()).slice(0, columns), bold: true })\n    for (const row of section.rows) {\n      for (const text of twoColumnLines(row.label, row.value, columns)) {\n        ops.push({ op: 'text', text, bold: row.strong === true })\n      }\n    }\n  }\n  ops.push({ op: 'feed', lines: 2 })\n  ops.push({ op: 'cut' })\n  return { columns, ops }\n}\n\n/** A drawer kick with nothing printed: a paid-out, a cash refund, \"Open drawer\". */\nexport function layoutDrawerKick(columns: number): PrintDocument {\n  return { columns, ops: [{ op: 'drawer' }] }\n}\n"],"names":["formatReceiptMoney","formatReceiptTime","SYMBOLS","toPrintable","value","String","normalize","replace","char","test","wrapText","text","width","lines","current","word","split","filter","Boolean","rest","length","push","slice","twoColumnLines","left","right","wrapped","amount","room","Math","max","last","pop","repeat","rule","columns","op","layoutReceipt","receipt","options","money","cents","currency","ops","line","bold","openDrawer","logo","banner","floor","align","size","storeName","storeLine","storeLines","orderNumber","createdAtMs","timeZone","who","registerName","cashierName","join","item","label","quantity","name","totalCents","detail","unitCents","subtotalCents","discountCents","shippingCents","taxCents","tipCents","tenders","changeCents","tender","amountCents","refundedCents","barcode","code128Printable","data","footer","layoutKitchenTicket","half","count","reduce","sum","layoutTestPage","input","printerName","atMs","ceil","layoutReport","report","title","subtitle","section","sections","toUpperCase","row","rows","strong","layoutDrawerKick"],"mappings":"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"}

package/src/lib/printing/product-labels.d.ts

@@ -0,0 +1,58 @@
+/**
+ * @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.
+ */
+/**
+ * Product and shelf labels (AGL-3619): a product's name, its options, its
+ * price and a barcode the register scans back, on the small thermal labels
+ * a Zebra, Rollo, DYMO or Brother label printer takes.
+ *
+ * Two outputs from one description. A printable page (one label per page,
+ * the page sized to the label) prints through the label printer's own
+ * driver from any browser. ZPL is the Zebra printer language, sent to a
+ * Zebra as a file; it prints sharper and faster and needs no driver
+ * settings, so a store with a Zebra can skip the print dialog altogether.
+ */
+export interface ProductLabel {
+    name: string;
+    /** A variant's options, e.g. `Large / Blue`. */
+    detail?: string;
+    priceCents?: number;
+    currency?: string;
+    /** The variant's barcode, else its SKU: what the register looks up. */
+    code: string;
+    copies: number;
+}
+export interface LabelSize {
+    id: string;
+    label: string;
+    widthIn: number;
+    heightIn: number;
+}
+/** The two sizes almost every label printer stocks for product labels. */
+export declare const LABEL_SIZES: readonly LabelSize[];
+/** One print run is capped; a typo of 5000 copies should not drain a roll. */
+export declare const MAX_LABEL_COPIES = 500;
+export declare function labelSize(id: string | undefined): LabelSize;
+export declare function productLabelsHtml(labels: ProductLabel[], sizeId?: string): string;
+/** Zebra's desktop printers print at 203 dpi; the 300 dpi models are listed by name. */
+export type ZplDpi = 203 | 300;
+/**
+ * Field text for ZPL. `^FH` makes `_` the escape, so the three characters
+ * ZPL treats as commands or that escape (`^`, `~`, `_`) are written as hex,
+ * and the rest is folded to the printer's ASCII font.
+ */
+export declare function zplText(value: unknown): string;
+export declare function productLabelsZpl(labels: ProductLabel[], sizeId?: string, dpi?: ZplDpi): string;

package/src/lib/printing/product-labels.js

@@ -0,0 +1,116 @@
+/**
+ * @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 { escapeHtml } from "../utils/escape-html.js";
+import { barcodeSvg, encodeBarcode } from "../barcode/barcode-encode.js";
+import { formatReceiptMoney } from "../model/commerce-receipt.js";
+import { toPrintable } from "./print-document.js";
+/** The two sizes almost every label printer stocks for product labels. */ export const LABEL_SIZES = [
+    {
+        id: '2.25x1.25',
+        label: '2.25 x 1.25 in (57 x 32 mm)',
+        widthIn: 2.25,
+        heightIn: 1.25
+    },
+    {
+        id: '2x1',
+        label: '2 x 1 in (51 x 25 mm)',
+        widthIn: 2,
+        heightIn: 1
+    }
+];
+/** One print run is capped; a typo of 5000 copies should not drain a roll. */ export const MAX_LABEL_COPIES = 500;
+export function labelSize(id) {
+    var _LABEL_SIZES_find;
+    return (_LABEL_SIZES_find = LABEL_SIZES.find((size)=>size.id === id)) != null ? _LABEL_SIZES_find : LABEL_SIZES[0];
+}
+const copiesOf = (label)=>Math.max(0, Math.min(MAX_LABEL_COPIES, Math.floor(Number(label.copies) || 0)));
+const priceText = (label)=>{
+    var _label_currency;
+    return label.priceCents != null && Number.isFinite(label.priceCents) ? formatReceiptMoney(Math.round(label.priceCents), (_label_currency = label.currency) != null ? _label_currency : 'usd') : '';
+};
+/*==========================================
+ * The printable page
+ *=========================================*/ export function productLabelsHtml(labels, sizeId) {
+    const size = labelSize(sizeId);
+    const pages = [];
+    for (const label of labels){
+        const encoded = encodeBarcode(label.code);
+        const page = '<section class="label">' + `<div class="name">${escapeHtml(label.name)}</div>` + (label.detail ? `<div class="detail">${escapeHtml(label.detail)}</div>` : '') + (priceText(label) ? `<div class="price">${escapeHtml(priceText(label))}</div>` : '') + (encoded ? `<div class="bars">${barcodeSvg(encoded)}</div><div class="code">${escapeHtml(encoded.text)}</div>` : '') + '</section>';
+        for(let copy = 0; copy < copiesOf(label); copy += 1)pages.push(page);
+    }
+    const width = `${size.widthIn}in`;
+    const height = `${size.heightIn}in`;
+    return '<!doctype html><html><head><meta charset="utf-8"><title>Labels</title><style>' + `@page{size:${width} ${height};margin:0}` + '*{box-sizing:border-box}html,body{margin:0;padding:0;font-family:Arial,Helvetica,sans-serif}' + `.label{width:${width};height:${height};padding:0.06in 0.08in;overflow:hidden;display:flex;flex-direction:column;page-break-after:always;break-after:page}` + '.label:last-child{page-break-after:auto;break-after:auto}' + '.name{font-size:9pt;font-weight:700;line-height:1.1;max-height:2.2em;overflow:hidden}' + '.detail{font-size:7pt;line-height:1.1;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}' + '.price{font-size:11pt;font-weight:700;line-height:1.2}' + '.bars{flex:1;min-height:0.3in}.bars svg{width:100%;height:100%;display:block}' + '.code{font-size:7pt;text-align:center;letter-spacing:0.05em}' + '</style></head><body>' + pages.join('') + '</body></html>';
+}
+/**
+ * Field text for ZPL. `^FH` makes `_` the escape, so the three characters
+ * ZPL treats as commands or that escape (`^`, `~`, `_`) are written as hex,
+ * and the rest is folded to the printer's ASCII font.
+ */ export function zplText(value) {
+    return toPrintable(value).replace(/[_^~]/g, (char)=>`_${char.charCodeAt(0).toString(16).toUpperCase()}`);
+}
+function zplBarcode(encoded, x, y, height, moduleDots) {
+    const at = `^FO${x},${y}^BY${moduleDots}`;
+    switch(encoded.format){
+        case 'ean_13':
+            // ZPL takes the 12 data digits and adds the check digit itself.
+            return `${at}^BEN,${height},Y,N^FD${encoded.text.slice(0, 12)}^FS`;
+        case 'upc_a':
+            return `${at}^BUN,${height},Y,N,Y^FD${encoded.text.slice(0, 11)}^FS`;
+        case 'ean_8':
+            return `${at}^B8N,${height},Y,N^FD${encoded.text.slice(0, 7)}^FS`;
+        default:
+            // Mode A: the printer picks sets B and C itself, as the page does.
+            return `${at}^BCN,${height},Y,N,N,A^FH^FD${zplText(encoded.text)}^FS`;
+    }
+}
+export function productLabelsZpl(labels, sizeId, dpi = 203) {
+    const size = labelSize(sizeId);
+    const width = Math.round(size.widthIn * dpi);
+    const height = Math.round(size.heightIn * dpi);
+    const margin = Math.round(0.08 * dpi);
+    const font = Math.round(dpi / 9);
+    const small = Math.round(dpi / 12);
+    const moduleDots = dpi >= 300 ? 3 : 2;
+    const out = [];
+    for (const label of labels){
+        const copies = copiesOf(label);
+        if (!copies) continue;
+        const encoded = encodeBarcode(label.code);
+        let y = margin;
+        const fields = [];
+        fields.push(`^FO${margin},${y}^A0N,${font},${font}^FB${width - margin * 2},2,0,L^FH^FD${zplText(label.name)}^FS`);
+        y += font * 2 + 2;
+        if (label.detail) {
+            fields.push(`^FO${margin},${y}^A0N,${small},${small}^FB${width - margin * 2},1,0,L^FH^FD${zplText(label.detail)}^FS`);
+            y += small + 2;
+        }
+        const price = priceText(label);
+        if (price) {
+            fields.push(`^FO${margin},${y}^A0N,${font},${font}^FH^FD${zplText(price)}^FS`);
+            y += font + 4;
+        }
+        if (encoded) {
+            // What is left of the label, less the printed digits under the bars.
+            const barHeight = Math.max(Math.round(dpi * 0.2), height - y - margin - small - 4);
+            fields.push(zplBarcode(encoded, margin, y, barHeight, moduleDots));
+        }
+        out.push(`^XA^CI0^PW${width}^LL${height}^LH0,0${fields.join('')}^PQ${copies},0,1,Y^XZ`);
+    }
+    return out.join('\n');
+}
+
+//# sourceMappingURL=product-labels.js.map

package/src/lib/printing/product-labels.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/commerce/src/lib/printing/product-labels.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 { escapeHtml } from '../utils/escape-html'\nimport { barcodeSvg, encodeBarcode, type EncodedBarcode } from '../barcode/barcode-encode'\nimport { formatReceiptMoney } from '../model/commerce-receipt'\nimport { toPrintable } from './print-document'\n\n/**\n * Product and shelf labels (AGL-3619): a product's name, its options, its\n * price and a barcode the register scans back, on the small thermal labels\n * a Zebra, Rollo, DYMO or Brother label printer takes.\n *\n * Two outputs from one description. A printable page (one label per page,\n * the page sized to the label) prints through the label printer's own\n * driver from any browser. ZPL is the Zebra printer language, sent to a\n * Zebra as a file; it prints sharper and faster and needs no driver\n * settings, so a store with a Zebra can skip the print dialog altogether.\n */\n\nexport interface ProductLabel {\n  name: string\n  /** A variant's options, e.g. `Large / Blue`. */\n  detail?: string\n  priceCents?: number\n  currency?: string\n  /** The variant's barcode, else its SKU: what the register looks up. */\n  code: string\n  copies: number\n}\n\nexport interface LabelSize {\n  id: string\n  label: string\n  widthIn: number\n  heightIn: number\n}\n\n/** The two sizes almost every label printer stocks for product labels. */\nexport const LABEL_SIZES: readonly LabelSize[] = [\n  { id: '2.25x1.25', label: '2.25 x 1.25 in (57 x 32 mm)', widthIn: 2.25, heightIn: 1.25 },\n  { id: '2x1', label: '2 x 1 in (51 x 25 mm)', widthIn: 2, heightIn: 1 },\n]\n\n/** One print run is capped; a typo of 5000 copies should not drain a roll. */\nexport const MAX_LABEL_COPIES = 500\n\nexport function labelSize(id: string | undefined): LabelSize {\n  return LABEL_SIZES.find((size) => size.id === id) ?? LABEL_SIZES[0]\n}\n\nconst copiesOf = (label: ProductLabel) => Math.max(0, Math.min(MAX_LABEL_COPIES, Math.floor(Number(label.copies) || 0)))\n\nconst priceText = (label: ProductLabel) =>\n  label.priceCents != null && Number.isFinite(label.priceCents)\n    ? formatReceiptMoney(Math.round(label.priceCents), label.currency ?? 'usd')\n    : ''\n\n/*==========================================\n * The printable page\n *=========================================*/\n\nexport function productLabelsHtml(labels: ProductLabel[], sizeId?: string): string {\n  const size = labelSize(sizeId)\n  const pages: string[] = []\n  for (const label of labels) {\n    const encoded = encodeBarcode(label.code)\n    const page =\n      '<section class=\"label\">' +\n      `<div class=\"name\">${escapeHtml(label.name)}</div>` +\n      (label.detail ? `<div class=\"detail\">${escapeHtml(label.detail)}</div>` : '') +\n      (priceText(label) ? `<div class=\"price\">${escapeHtml(priceText(label))}</div>` : '') +\n      (encoded\n        ? `<div class=\"bars\">${barcodeSvg(encoded)}</div><div class=\"code\">${escapeHtml(encoded.text)}</div>`\n        : '') +\n      '</section>'\n    for (let copy = 0; copy < copiesOf(label); copy += 1) pages.push(page)\n  }\n  const width = `${size.widthIn}in`\n  const height = `${size.heightIn}in`\n  return (\n    '<!doctype html><html><head><meta charset=\"utf-8\"><title>Labels</title><style>' +\n    `@page{size:${width} ${height};margin:0}` +\n    '*{box-sizing:border-box}html,body{margin:0;padding:0;font-family:Arial,Helvetica,sans-serif}' +\n    `.label{width:${width};height:${height};padding:0.06in 0.08in;overflow:hidden;display:flex;flex-direction:column;page-break-after:always;break-after:page}` +\n    '.label:last-child{page-break-after:auto;break-after:auto}' +\n    '.name{font-size:9pt;font-weight:700;line-height:1.1;max-height:2.2em;overflow:hidden}' +\n    '.detail{font-size:7pt;line-height:1.1;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}' +\n    '.price{font-size:11pt;font-weight:700;line-height:1.2}' +\n    '.bars{flex:1;min-height:0.3in}.bars svg{width:100%;height:100%;display:block}' +\n    '.code{font-size:7pt;text-align:center;letter-spacing:0.05em}' +\n    '</style></head><body>' +\n    pages.join('') +\n    '</body></html>'\n  )\n}\n\n/*==========================================\n * ZPL\n *=========================================*/\n\n/** Zebra's desktop printers print at 203 dpi; the 300 dpi models are listed by name. */\nexport type ZplDpi = 203 | 300\n\n/**\n * Field text for ZPL. `^FH` makes `_` the escape, so the three characters\n * ZPL treats as commands or that escape (`^`, `~`, `_`) are written as hex,\n * and the rest is folded to the printer's ASCII font.\n */\nexport function zplText(value: unknown): string {\n  return toPrintable(value).replace(/[_^~]/g, (char) => `_${char.charCodeAt(0).toString(16).toUpperCase()}`)\n}\n\nfunction zplBarcode(encoded: EncodedBarcode, x: number, y: number, height: number, moduleDots: number): string {\n  const at = `^FO${x},${y}^BY${moduleDots}`\n  switch (encoded.format) {\n    case 'ean_13':\n      // ZPL takes the 12 data digits and adds the check digit itself.\n      return `${at}^BEN,${height},Y,N^FD${encoded.text.slice(0, 12)}^FS`\n    case 'upc_a':\n      return `${at}^BUN,${height},Y,N,Y^FD${encoded.text.slice(0, 11)}^FS`\n    case 'ean_8':\n      return `${at}^B8N,${height},Y,N^FD${encoded.text.slice(0, 7)}^FS`\n    default:\n      // Mode A: the printer picks sets B and C itself, as the page does.\n      return `${at}^BCN,${height},Y,N,N,A^FH^FD${zplText(encoded.text)}^FS`\n  }\n}\n\nexport function productLabelsZpl(labels: ProductLabel[], sizeId?: string, dpi: ZplDpi = 203): string {\n  const size = labelSize(sizeId)\n  const width = Math.round(size.widthIn * dpi)\n  const height = Math.round(size.heightIn * dpi)\n  const margin = Math.round(0.08 * dpi)\n  const font = Math.round(dpi / 9)\n  const small = Math.round(dpi / 12)\n  const moduleDots = dpi >= 300 ? 3 : 2\n  const out: string[] = []\n  for (const label of labels) {\n    const copies = copiesOf(label)\n    if (!copies) continue\n    const encoded = encodeBarcode(label.code)\n    let y = margin\n    const fields: string[] = []\n    fields.push(`^FO${margin},${y}^A0N,${font},${font}^FB${width - margin * 2},2,0,L^FH^FD${zplText(label.name)}^FS`)\n    y += font * 2 + 2\n    if (label.detail) {\n      fields.push(`^FO${margin},${y}^A0N,${small},${small}^FB${width - margin * 2},1,0,L^FH^FD${zplText(label.detail)}^FS`)\n      y += small + 2\n    }\n    const price = priceText(label)\n    if (price) {\n      fields.push(`^FO${margin},${y}^A0N,${font},${font}^FH^FD${zplText(price)}^FS`)\n      y += font + 4\n    }\n    if (encoded) {\n      // What is left of the label, less the printed digits under the bars.\n      const barHeight = Math.max(Math.round(dpi * 0.2), height - y - margin - small - 4)\n      fields.push(zplBarcode(encoded, margin, y, barHeight, moduleDots))\n    }\n    out.push(`^XA^CI0^PW${width}^LL${height}^LH0,0${fields.join('')}^PQ${copies},0,1,Y^XZ`)\n  }\n  return out.join('\\n')\n}\n"],"names":["escapeHtml","barcodeSvg","encodeBarcode","formatReceiptMoney","toPrintable","LABEL_SIZES","id","label","widthIn","heightIn","MAX_LABEL_COPIES","labelSize","find","size","copiesOf","Math","max","min","floor","Number","copies","priceText","priceCents","isFinite","round","currency","productLabelsHtml","labels","sizeId","pages","encoded","code","page","name","detail","text","copy","push","width","height","join","zplText","value","replace","char","charCodeAt","toString","toUpperCase","zplBarcode","x","y","moduleDots","at","format","slice","productLabelsZpl","dpi","margin","font","small","out","fields","price","barHeight"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,SAASA,UAAU,QAAQ,0BAAsB;AACjD,SAASC,UAAU,EAAEC,aAAa,QAA6B,+BAA2B;AAC1F,SAASC,kBAAkB,QAAQ,+BAA2B;AAC9D,SAASC,WAAW,QAAQ,sBAAkB;AAgC9C,wEAAwE,GACxE,OAAO,MAAMC,cAAoC;IAC/C;QAAEC,IAAI;QAAaC,OAAO;QAA+BC,SAAS;QAAMC,UAAU;IAAK;IACvF;QAAEH,IAAI;QAAOC,OAAO;QAAyBC,SAAS;QAAGC,UAAU;IAAE;CACtE,CAAA;AAED,4EAA4E,GAC5E,OAAO,MAAMC,mBAAmB,IAAG;AAEnC,OAAO,SAASC,UAAUL,EAAsB;QACvCD;IAAP,QAAOA,oBAAAA,YAAYO,IAAI,CAAC,CAACC,OAASA,KAAKP,EAAE,KAAKA,eAAvCD,oBAA8CA,WAAW,CAAC,EAAE;AACrE;AAEA,MAAMS,WAAW,CAACP,QAAwBQ,KAAKC,GAAG,CAAC,GAAGD,KAAKE,GAAG,CAACP,kBAAkBK,KAAKG,KAAK,CAACC,OAAOZ,MAAMa,MAAM,KAAK;AAEpH,MAAMC,YAAY,CAACd;QAEoCA;WADrDA,MAAMe,UAAU,IAAI,QAAQH,OAAOI,QAAQ,CAAChB,MAAMe,UAAU,IACxDnB,mBAAmBY,KAAKS,KAAK,CAACjB,MAAMe,UAAU,IAAGf,kBAAAA,MAAMkB,QAAQ,YAAdlB,kBAAkB,SACnE;;AAEN;;2CAE2C,GAE3C,OAAO,SAASmB,kBAAkBC,MAAsB,EAAEC,MAAe;IACvE,MAAMf,OAAOF,UAAUiB;IACvB,MAAMC,QAAkB,EAAE;IAC1B,KAAK,MAAMtB,SAASoB,OAAQ;QAC1B,MAAMG,UAAU5B,cAAcK,MAAMwB,IAAI;QACxC,MAAMC,OACJ,4BACA,CAAC,kBAAkB,EAAEhC,WAAWO,MAAM0B,IAAI,EAAE,MAAM,CAAC,GAClD1B,CAAAA,MAAM2B,MAAM,GAAG,CAAC,oBAAoB,EAAElC,WAAWO,MAAM2B,MAAM,EAAE,MAAM,CAAC,GAAG,EAAC,IAC1Eb,CAAAA,UAAUd,SAAS,CAAC,mBAAmB,EAAEP,WAAWqB,UAAUd,QAAQ,MAAM,CAAC,GAAG,EAAC,IACjFuB,CAAAA,UACG,CAAC,kBAAkB,EAAE7B,WAAW6B,SAAS,wBAAwB,EAAE9B,WAAW8B,QAAQK,IAAI,EAAE,MAAM,CAAC,GACnG,EAAC,IACL;QACF,IAAK,IAAIC,OAAO,GAAGA,OAAOtB,SAASP,QAAQ6B,QAAQ,EAAGP,MAAMQ,IAAI,CAACL;IACnE;IACA,MAAMM,QAAQ,GAAGzB,KAAKL,OAAO,CAAC,EAAE,CAAC;IACjC,MAAM+B,SAAS,GAAG1B,KAAKJ,QAAQ,CAAC,EAAE,CAAC;IACnC,OACE,kFACA,CAAC,WAAW,EAAE6B,MAAM,CAAC,EAAEC,OAAO,UAAU,CAAC,GACzC,iGACA,CAAC,aAAa,EAAED,MAAM,QAAQ,EAAEC,OAAO,mHAAmH,CAAC,GAC3J,8DACA,0FACA,qGACA,2DACA,kFACA,iEACA,0BACAV,MAAMW,IAAI,CAAC,MACX;AAEJ;AASA;;;;CAIC,GACD,OAAO,SAASC,QAAQC,KAAc;IACpC,OAAOtC,YAAYsC,OAAOC,OAAO,CAAC,UAAU,CAACC,OAAS,CAAC,CAAC,EAAEA,KAAKC,UAAU,CAAC,GAAGC,QAAQ,CAAC,IAAIC,WAAW,IAAI;AAC3G;AAEA,SAASC,WAAWlB,OAAuB,EAAEmB,CAAS,EAAEC,CAAS,EAAEX,MAAc,EAAEY,UAAkB;IACnG,MAAMC,KAAK,CAAC,GAAG,EAAEH,EAAE,CAAC,EAAEC,EAAE,GAAG,EAAEC,YAAY;IACzC,OAAQrB,QAAQuB,MAAM;QACpB,KAAK;YACH,gEAAgE;YAChE,OAAO,GAAGD,GAAG,KAAK,EAAEb,OAAO,OAAO,EAAET,QAAQK,IAAI,CAACmB,KAAK,CAAC,GAAG,IAAI,GAAG,CAAC;QACpE,KAAK;YACH,OAAO,GAAGF,GAAG,KAAK,EAAEb,OAAO,SAAS,EAAET,QAAQK,IAAI,CAACmB,KAAK,CAAC,GAAG,IAAI,GAAG,CAAC;QACtE,KAAK;YACH,OAAO,GAAGF,GAAG,KAAK,EAAEb,OAAO,OAAO,EAAET,QAAQK,IAAI,CAACmB,KAAK,CAAC,GAAG,GAAG,GAAG,CAAC;QACnE;YACE,mEAAmE;YACnE,OAAO,GAAGF,GAAG,KAAK,EAAEb,OAAO,cAAc,EAAEE,QAAQX,QAAQK,IAAI,EAAE,GAAG,CAAC;IACzE;AACF;AAEA,OAAO,SAASoB,iBAAiB5B,MAAsB,EAAEC,MAAe,EAAE4B,MAAc,GAAG;IACzF,MAAM3C,OAAOF,UAAUiB;IACvB,MAAMU,QAAQvB,KAAKS,KAAK,CAACX,KAAKL,OAAO,GAAGgD;IACxC,MAAMjB,SAASxB,KAAKS,KAAK,CAACX,KAAKJ,QAAQ,GAAG+C;IAC1C,MAAMC,SAAS1C,KAAKS,KAAK,CAAC,OAAOgC;IACjC,MAAME,OAAO3C,KAAKS,KAAK,CAACgC,MAAM;IAC9B,MAAMG,QAAQ5C,KAAKS,KAAK,CAACgC,MAAM;IAC/B,MAAML,aAAaK,OAAO,MAAM,IAAI;IACpC,MAAMI,MAAgB,EAAE;IACxB,KAAK,MAAMrD,SAASoB,OAAQ;QAC1B,MAAMP,SAASN,SAASP;QACxB,IAAI,CAACa,QAAQ;QACb,MAAMU,UAAU5B,cAAcK,MAAMwB,IAAI;QACxC,IAAImB,IAAIO;QACR,MAAMI,SAAmB,EAAE;QAC3BA,OAAOxB,IAAI,CAAC,CAAC,GAAG,EAAEoB,OAAO,CAAC,EAAEP,EAAE,KAAK,EAAEQ,KAAK,CAAC,EAAEA,KAAK,GAAG,EAAEpB,QAAQmB,SAAS,EAAE,YAAY,EAAEhB,QAAQlC,MAAM0B,IAAI,EAAE,GAAG,CAAC;QAChHiB,KAAKQ,OAAO,IAAI;QAChB,IAAInD,MAAM2B,MAAM,EAAE;YAChB2B,OAAOxB,IAAI,CAAC,CAAC,GAAG,EAAEoB,OAAO,CAAC,EAAEP,EAAE,KAAK,EAAES,MAAM,CAAC,EAAEA,MAAM,GAAG,EAAErB,QAAQmB,SAAS,EAAE,YAAY,EAAEhB,QAAQlC,MAAM2B,MAAM,EAAE,GAAG,CAAC;YACpHgB,KAAKS,QAAQ;QACf;QACA,MAAMG,QAAQzC,UAAUd;QACxB,IAAIuD,OAAO;YACTD,OAAOxB,IAAI,CAAC,CAAC,GAAG,EAAEoB,OAAO,CAAC,EAAEP,EAAE,KAAK,EAAEQ,KAAK,CAAC,EAAEA,KAAK,MAAM,EAAEjB,QAAQqB,OAAO,GAAG,CAAC;YAC7EZ,KAAKQ,OAAO;QACd;QACA,IAAI5B,SAAS;YACX,qEAAqE;YACrE,MAAMiC,YAAYhD,KAAKC,GAAG,CAACD,KAAKS,KAAK,CAACgC,MAAM,MAAMjB,SAASW,IAAIO,SAASE,QAAQ;YAChFE,OAAOxB,IAAI,CAACW,WAAWlB,SAAS2B,QAAQP,GAAGa,WAAWZ;QACxD;QACAS,IAAIvB,IAAI,CAAC,CAAC,UAAU,EAAEC,MAAM,GAAG,EAAEC,OAAO,MAAM,EAAEsB,OAAOrB,IAAI,CAAC,IAAI,GAAG,EAAEpB,OAAO,SAAS,CAAC;IACxF;IACA,OAAOwC,IAAIpB,IAAI,CAAC;AAClB"}

package/src/lib/printing/render-epson.d.ts

@@ -0,0 +1,57 @@
+/**
+ * @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 PrintDocument } from './print-document';
+/**
+ * ePOS-Print XML for a {@link PrintDocument} (AGL-3619), wrapped in the
+ * Server Direct Print response an Epson TM printer receives when it polls.
+ *
+ * `<PrintRequestInfo Version="2.00">` so the job carries a `printjobid` that
+ * the printer echoes back in its result: the only way to tell which job a
+ * `SetResponse` is about when a printer has had more than one.
+ */
+export declare const EPOS_PRINT_NAMESPACE = "http://www.epson-pos.com/schemas/2011/03/epos-print";
+/** The drawer kick on its own: pin 2, a 100 ms pulse. */
+export declare const EPSON_DRAWER_KICK = "<pulse drawer=\"drawer_1\" time=\"pulse_100\"/>";
+/** Print job ids are 1-30 of `A-Z a-z 0-9 - _ .`; a Firestore id is 20 of them. */
+export declare function epsonJobId(jobId: string): string;
+export declare function escapeXml(value: string): string;
+/** Epson's two-byte NV logo key, `48,48` → `[48, 48]`; anything else prints no logo. */
+export declare function epsonLogoKeys(logoKey: string | undefined): [number, number] | null;
+/** The `<epos-print>` element alone. */
+export declare function renderEposPrint(document: PrintDocument, options?: {
+    logoKey?: string;
+}): string;
+/** The whole Server Direct Print response body for one job. */
+export declare function renderEpsonServerDirectPrint(document: PrintDocument, options: {
+    jobId: string;
+    logoKey?: string;
+    timeoutMs?: number;
+}): string;
+export interface EpsonPrintResult {
+    jobId: string;
+    success: boolean;
+    code: string;
+    status?: number;
+}
+/**
+ * The results in a printer's `ResponseFile` (`<PrintResponseInfo>`), one per
+ * `<ePOSPrint>`. Read with patterns rather than an XML parser: the document is
+ * small, machine-written and fixed in shape, and nothing in it is trusted
+ * beyond the job id (looked up under the printer that posted it) and the
+ * result it reports for that job.
+ */
+export declare function parseEpsonPrintResults(responseFile: string): EpsonPrintResult[];

package/src/lib/printing/render-epson.js

@@ -0,0 +1,135 @@
+import { _ as _extends } from "@swc/helpers/_/_extends";
+/**
+ * @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 { toPrintable } from "./print-document.js";
+/**
+ * ePOS-Print XML for a {@link PrintDocument} (AGL-3619), wrapped in the
+ * Server Direct Print response an Epson TM printer receives when it polls.
+ *
+ * `<PrintRequestInfo Version="2.00">` so the job carries a `printjobid` that
+ * the printer echoes back in its result: the only way to tell which job a
+ * `SetResponse` is about when a printer has had more than one.
+ */ export const EPOS_PRINT_NAMESPACE = 'http://www.epson-pos.com/schemas/2011/03/epos-print';
+/** The drawer kick on its own: pin 2, a 100 ms pulse. */ export const EPSON_DRAWER_KICK = '<pulse drawer="drawer_1" time="pulse_100"/>';
+/** Print job ids are 1-30 of `A-Z a-z 0-9 - _ .`; a Firestore id is 20 of them. */ export function epsonJobId(jobId) {
+    return String(jobId).replace(/[^A-Za-z0-9._-]/g, '').slice(0, 30);
+}
+export function escapeXml(value) {
+    return value.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;').replace(/'/g, '&apos;');
+}
+/** Epson's two-byte NV logo key, `48,48` → `[48, 48]`; anything else prints no logo. */ export function epsonLogoKeys(logoKey) {
+    const parts = String(logoKey != null ? logoKey : '').split(/[\s,]+/).filter(Boolean).map(Number);
+    if (parts.length !== 2) return null;
+    return parts.every((part)=>Number.isInteger(part) && part >= 32 && part <= 126) ? [
+        parts[0],
+        parts[1]
+    ] : null;
+}
+/** The `<epos-print>` element alone. */ export function renderEposPrint(document, options = {}) {
+    const parts = [
+        `<epos-print xmlns="${EPOS_PRINT_NAMESPACE}">`,
+        '<text lang="en" smooth="true"/>'
+    ];
+    const logo = epsonLogoKeys(options.logoKey);
+    let align = 'left';
+    let bold = false;
+    let size = 1;
+    const setAlign = (next)=>{
+        if (next === align) return;
+        parts.push(`<text align="${next}"/>`);
+        align = next;
+    };
+    for (const op of document.ops){
+        switch(op.op){
+            case 'text':
+                {
+                    var _op_align;
+                    setAlign((_op_align = op.align) != null ? _op_align : 'left');
+                    const nextSize = op.size === 2 ? 2 : 1;
+                    if (nextSize !== size) {
+                        parts.push(`<text width="${nextSize}" height="${nextSize}"/>`);
+                        size = nextSize;
+                    }
+                    const nextBold = Boolean(op.bold);
+                    if (nextBold !== bold) {
+                        parts.push(`<text em="${nextBold}"/>`);
+                        bold = nextBold;
+                    }
+                    parts.push(`<text>${escapeXml(toPrintable(op.text))}&#10;</text>`);
+                    break;
+                }
+            case 'feed':
+                parts.push(`<feed line="${Math.max(1, Math.min(10, op.lines))}"/>`);
+                break;
+            case 'barcode':
+                setAlign('center');
+                // `{B` selects code set B, which carries printable ASCII.
+                parts.push(`<barcode type="code128" hri="below" font="font_a" width="2" height="64">` + `${escapeXml(`{B${toPrintable(op.data)}`)}</barcode>`, '<feed/>');
+                break;
+            case 'logo':
+                if (logo) {
+                    setAlign('center');
+                    parts.push(`<logo key1="${logo[0]}" key2="${logo[1]}"/>`);
+                }
+                break;
+            case 'drawer':
+                parts.push(EPSON_DRAWER_KICK);
+                break;
+            case 'cut':
+                parts.push('<cut type="feed"/>');
+                break;
+        }
+    }
+    parts.push('</epos-print>');
+    return parts.join('');
+}
+/** The whole Server Direct Print response body for one job. */ export function renderEpsonServerDirectPrint(document, options) {
+    var _options_timeoutMs;
+    return '<?xml version="1.0" encoding="utf-8"?>' + '<PrintRequestInfo Version="2.00">' + '<ePOSPrint>' + '<Parameter>' + '<devid>local_printer</devid>' + `<timeout>${Math.round((_options_timeoutMs = options.timeoutMs) != null ? _options_timeoutMs : 10000)}</timeout>` + `<printjobid>${escapeXml(epsonJobId(options.jobId))}</printjobid>` + '</Parameter>' + `<PrintData>${renderEposPrint(document, options)}</PrintData>` + '</ePOSPrint>' + '</PrintRequestInfo>';
+}
+const attribute = (tag, name)=>{
+    var _tag_match;
+    return (_tag_match = tag.match(new RegExp(`\\b${name}\\s*=\\s*"([^"]*)"`))) == null ? void 0 : _tag_match[1];
+};
+/**
+ * The results in a printer's `ResponseFile` (`<PrintResponseInfo>`), one per
+ * `<ePOSPrint>`. Read with patterns rather than an XML parser: the document is
+ * small, machine-written and fixed in shape, and nothing in it is trusted
+ * beyond the job id (looked up under the printer that posted it) and the
+ * result it reports for that job.
+ */ export function parseEpsonPrintResults(responseFile) {
+    var _xml_match;
+    const xml = String(responseFile != null ? responseFile : '').slice(0, 64 * 1024);
+    const results = [];
+    for (const block of (_xml_match = xml.match(/<ePOSPrint\b[\s\S]*?<\/ePOSPrint>/g)) != null ? _xml_match : []){
+        var _ref, _attribute, _attribute1;
+        var _block_match, _block_match1;
+        const jobId = (_ref = (_block_match = block.match(/<printjobid>\s*([^<]*?)\s*<\/printjobid>/)) == null ? void 0 : _block_match[1]) != null ? _ref : '';
+        const response = (_block_match1 = block.match(/<response\b[^>]*>/)) == null ? void 0 : _block_match1[0];
+        if (!jobId || !response) continue;
+        const status = Number(attribute(response, 'status'));
+        results.push(_extends({
+            jobId,
+            success: /^(true|1)$/i.test((_attribute = attribute(response, 'success')) != null ? _attribute : ''),
+            code: (_attribute1 = attribute(response, 'code')) != null ? _attribute1 : ''
+        }, Number.isFinite(status) ? {
+            status
+        } : {}));
+    }
+    return results;
+}
+
+//# sourceMappingURL=render-epson.js.map

package/src/lib/printing/render-epson.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/commerce/src/lib/printing/render-epson.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 { toPrintable, type PrintDocument } from './print-document'\n\n/**\n * ePOS-Print XML for a {@link PrintDocument} (AGL-3619), wrapped in the\n * Server Direct Print response an Epson TM printer receives when it polls.\n *\n * `<PrintRequestInfo Version=\"2.00\">` so the job carries a `printjobid` that\n * the printer echoes back in its result: the only way to tell which job a\n * `SetResponse` is about when a printer has had more than one.\n */\nexport const EPOS_PRINT_NAMESPACE = 'http://www.epson-pos.com/schemas/2011/03/epos-print'\n\n/** The drawer kick on its own: pin 2, a 100 ms pulse. */\nexport const EPSON_DRAWER_KICK = '<pulse drawer=\"drawer_1\" time=\"pulse_100\"/>'\n\n/** Print job ids are 1-30 of `A-Z a-z 0-9 - _ .`; a Firestore id is 20 of them. */\nexport function epsonJobId(jobId: string): string {\n  return String(jobId).replace(/[^A-Za-z0-9._-]/g, '').slice(0, 30)\n}\n\nexport function escapeXml(value: string): string {\n  return value\n    .replace(/&/g, '&amp;')\n    .replace(/</g, '&lt;')\n    .replace(/>/g, '&gt;')\n    .replace(/\"/g, '&quot;')\n    .replace(/'/g, '&apos;')\n}\n\n/** Epson's two-byte NV logo key, `48,48` → `[48, 48]`; anything else prints no logo. */\nexport function epsonLogoKeys(logoKey: string | undefined): [number, number] | null {\n  const parts = String(logoKey ?? '')\n    .split(/[\\s,]+/)\n    .filter(Boolean)\n    .map(Number)\n  if (parts.length !== 2) return null\n  return parts.every((part) => Number.isInteger(part) && part >= 32 && part <= 126)\n    ? [parts[0], parts[1]]\n    : null\n}\n\n/** The `<epos-print>` element alone. */\nexport function renderEposPrint(document: PrintDocument, options: { logoKey?: string } = {}): string {\n  const parts: string[] = [`<epos-print xmlns=\"${EPOS_PRINT_NAMESPACE}\">`, '<text lang=\"en\" smooth=\"true\"/>']\n  const logo = epsonLogoKeys(options.logoKey)\n  let align = 'left'\n  let bold = false\n  let size = 1\n  const setAlign = (next: string) => {\n    if (next === align) return\n    parts.push(`<text align=\"${next}\"/>`)\n    align = next\n  }\n  for (const op of document.ops) {\n    switch (op.op) {\n      case 'text': {\n        setAlign(op.align ?? 'left')\n        const nextSize = op.size === 2 ? 2 : 1\n        if (nextSize !== size) {\n          parts.push(`<text width=\"${nextSize}\" height=\"${nextSize}\"/>`)\n          size = nextSize\n        }\n        const nextBold = Boolean(op.bold)\n        if (nextBold !== bold) {\n          parts.push(`<text em=\"${nextBold}\"/>`)\n          bold = nextBold\n        }\n        parts.push(`<text>${escapeXml(toPrintable(op.text))}&#10;</text>`)\n        break\n      }\n      case 'feed':\n        parts.push(`<feed line=\"${Math.max(1, Math.min(10, op.lines))}\"/>`)\n        break\n      case 'barcode':\n        setAlign('center')\n        // `{B` selects code set B, which carries printable ASCII.\n        parts.push(\n          `<barcode type=\"code128\" hri=\"below\" font=\"font_a\" width=\"2\" height=\"64\">` +\n            `${escapeXml(`{B${toPrintable(op.data)}`)}</barcode>`,\n          '<feed/>',\n        )\n        break\n      case 'logo':\n        if (logo) {\n          setAlign('center')\n          parts.push(`<logo key1=\"${logo[0]}\" key2=\"${logo[1]}\"/>`)\n        }\n        break\n      case 'drawer':\n        parts.push(EPSON_DRAWER_KICK)\n        break\n      case 'cut':\n        parts.push('<cut type=\"feed\"/>')\n        break\n    }\n  }\n  parts.push('</epos-print>')\n  return parts.join('')\n}\n\n/** The whole Server Direct Print response body for one job. */\nexport function renderEpsonServerDirectPrint(\n  document: PrintDocument,\n  options: { jobId: string; logoKey?: string; timeoutMs?: number },\n): string {\n  return (\n    '<?xml version=\"1.0\" encoding=\"utf-8\"?>' +\n    '<PrintRequestInfo Version=\"2.00\">' +\n    '<ePOSPrint>' +\n    '<Parameter>' +\n    '<devid>local_printer</devid>' +\n    `<timeout>${Math.round(options.timeoutMs ?? 10000)}</timeout>` +\n    `<printjobid>${escapeXml(epsonJobId(options.jobId))}</printjobid>` +\n    '</Parameter>' +\n    `<PrintData>${renderEposPrint(document, options)}</PrintData>` +\n    '</ePOSPrint>' +\n    '</PrintRequestInfo>'\n  )\n}\n\nexport interface EpsonPrintResult {\n  jobId: string\n  success: boolean\n  code: string\n  status?: number\n}\n\nconst attribute = (tag: string, name: string): string | undefined =>\n  tag.match(new RegExp(`\\\\b${name}\\\\s*=\\\\s*\"([^\"]*)\"`))?.[1]\n\n/**\n * The results in a printer's `ResponseFile` (`<PrintResponseInfo>`), one per\n * `<ePOSPrint>`. Read with patterns rather than an XML parser: the document is\n * small, machine-written and fixed in shape, and nothing in it is trusted\n * beyond the job id (looked up under the printer that posted it) and the\n * result it reports for that job.\n */\nexport function parseEpsonPrintResults(responseFile: string): EpsonPrintResult[] {\n  const xml = String(responseFile ?? '').slice(0, 64 * 1024)\n  const results: EpsonPrintResult[] = []\n  for (const block of xml.match(/<ePOSPrint\\b[\\s\\S]*?<\\/ePOSPrint>/g) ?? []) {\n    const jobId = block.match(/<printjobid>\\s*([^<]*?)\\s*<\\/printjobid>/)?.[1] ?? ''\n    const response = block.match(/<response\\b[^>]*>/)?.[0]\n    if (!jobId || !response) continue\n    const status = Number(attribute(response, 'status'))\n    results.push({\n      jobId,\n      success: /^(true|1)$/i.test(attribute(response, 'success') ?? ''),\n      code: attribute(response, 'code') ?? '',\n      ...(Number.isFinite(status) ? { status } : {}),\n    })\n  }\n  return results\n}\n"],"names":["toPrintable","EPOS_PRINT_NAMESPACE","EPSON_DRAWER_KICK","epsonJobId","jobId","String","replace","slice","escapeXml","value","epsonLogoKeys","logoKey","parts","split","filter","Boolean","map","Number","length","every","part","isInteger","renderEposPrint","document","options","logo","align","bold","size","setAlign","next","push","op","ops","nextSize","nextBold","text","Math","max","min","lines","data","join","renderEpsonServerDirectPrint","round","timeoutMs","attribute","tag","name","match","RegExp","parseEpsonPrintResults","responseFile","xml","results","block","response","status","success","test","code","isFinite"],"mappings":"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"}

package/src/lib/printing/render-star.d.ts

@@ -0,0 +1,45 @@
+/**
+ * @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 PrintDocument } from './print-document';
+/**
+ * Star command bytes for a {@link PrintDocument} (AGL-3619), served to a
+ * CloudPRNT printer as `application/vnd.star.starprntcore`: the subset of
+ * StarPRNT that both Star Line Mode and StarPRNT emulation execute, so one
+ * job prints on an mC-Print3, a TSP143IV and a legacy TSP650II alike.
+ *
+ * Every command used here is in that common subset:
+ *
+ * | bytes                 | command                                   |
+ * | --------------------- | ----------------------------------------- |
+ * | `1B 40`               | initialize                                |
+ * | `1B 1D 61 n`          | alignment (0 left, 1 center, 2 right)     |
+ * | `1B 45` / `1B 46`     | emphasis on / off                         |
+ * | `1B 69 h w`           | character expansion (0 = normal, 1 = 2x)  |
+ * | `1B 62 06 02 02 h d… 1E` | Code128, text below, 3-dot module, `h` dots tall |
+ * | `1B 1C 70 n 00`       | print NV logo `n`                         |
+ * | `07`                  | drive external device 1 (the cash drawer) |
+ * | `1B 64 03`            | feed to the cutter and partial cut        |
+ * | `0A`                  | line feed                                 |
+ */
+export declare const STAR_MEDIA_TYPE = "application/vnd.star.starprntcore";
+/** The drawer kick on its own, the bytes a "paid out" job sends: BEL drives drawer 1. */
+export declare const STAR_DRAWER_KICK: readonly [7];
+/** Star's NV logo number, 1-255; anything else prints no logo. */
+export declare function starLogoNumber(logoKey: string | undefined): number | null;
+export declare function renderStar(document: PrintDocument, options?: {
+    logoKey?: string;
+}): Uint8Array;

package/src/lib/printing/render-star.js

@@ -0,0 +1,100 @@
+/**
+ * @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 { toPrintable } from "./print-document.js";
+/**
+ * Star command bytes for a {@link PrintDocument} (AGL-3619), served to a
+ * CloudPRNT printer as `application/vnd.star.starprntcore`: the subset of
+ * StarPRNT that both Star Line Mode and StarPRNT emulation execute, so one
+ * job prints on an mC-Print3, a TSP143IV and a legacy TSP650II alike.
+ *
+ * Every command used here is in that common subset:
+ *
+ * | bytes                 | command                                   |
+ * | --------------------- | ----------------------------------------- |
+ * | `1B 40`               | initialize                                |
+ * | `1B 1D 61 n`          | alignment (0 left, 1 center, 2 right)     |
+ * | `1B 45` / `1B 46`     | emphasis on / off                         |
+ * | `1B 69 h w`           | character expansion (0 = normal, 1 = 2x)  |
+ * | `1B 62 06 02 02 h d… 1E` | Code128, text below, 3-dot module, `h` dots tall |
+ * | `1B 1C 70 n 00`       | print NV logo `n`                         |
+ * | `07`                  | drive external device 1 (the cash drawer) |
+ * | `1B 64 03`            | feed to the cutter and partial cut        |
+ * | `0A`                  | line feed                                 |
+ */ export const STAR_MEDIA_TYPE = 'application/vnd.star.starprntcore';
+const ESC = 0x1b;
+const GS = 0x1d;
+const LF = 0x0a;
+/** The drawer kick on its own, the bytes a "paid out" job sends: BEL drives drawer 1. */ export const STAR_DRAWER_KICK = [
+    0x07
+];
+const BARCODE_HEIGHT_DOTS = 80;
+function ascii(text) {
+    return Array.from(toPrintable(text), (char)=>char.charCodeAt(0));
+}
+/** Star's NV logo number, 1-255; anything else prints no logo. */ export function starLogoNumber(logoKey) {
+    const value = Number(String(logoKey != null ? logoKey : '').trim());
+    return Number.isInteger(value) && value >= 1 && value <= 255 ? value : null;
+}
+export function renderStar(document, options = {}) {
+    const bytes = [
+        ESC,
+        0x40
+    ];
+    const logo = starLogoNumber(options.logoKey);
+    let align = 0;
+    const setAlign = (next)=>{
+        if (next === align) return;
+        bytes.push(ESC, GS, 0x61, next);
+        align = next;
+    };
+    for (const op of document.ops){
+        switch(op.op){
+            case 'text':
+                {
+                    setAlign(op.align === 'center' ? 1 : op.align === 'right' ? 2 : 0);
+                    const expand = op.size === 2 ? 1 : 0;
+                    if (expand) bytes.push(ESC, 0x69, expand, expand);
+                    if (op.bold) bytes.push(ESC, 0x45);
+                    bytes.push(...ascii(op.text), LF);
+                    if (op.bold) bytes.push(ESC, 0x46);
+                    if (expand) bytes.push(ESC, 0x69, 0, 0);
+                    break;
+                }
+            case 'feed':
+                for(let index = 0; index < Math.max(0, Math.min(10, op.lines)); index += 1)bytes.push(LF);
+                break;
+            case 'barcode':
+                setAlign(1);
+                bytes.push(ESC, 0x62, 0x06, 0x02, 0x02, BARCODE_HEIGHT_DOTS, ...ascii(op.data), 0x1e, LF);
+                break;
+            case 'logo':
+                if (logo !== null) {
+                    setAlign(1);
+                    bytes.push(ESC, 0x1c, 0x70, logo, 0x00);
+                }
+                break;
+            case 'drawer':
+                bytes.push(...STAR_DRAWER_KICK);
+                break;
+            case 'cut':
+                bytes.push(ESC, 0x64, 0x03);
+                break;
+        }
+    }
+    return Uint8Array.from(bytes);
+}
+
+//# sourceMappingURL=render-star.js.map