@ai-matrx/print 0.3.2 → 0.5.0

package/dist/zpl.cjs

@@ -0,0 +1,1040 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/zpl.ts
+var zpl_exports = {};
+__export(zpl_exports, {
+  DEFAULT_ZPL_DPI: () => DEFAULT_ZPL_DPI,
+  ZPL_MAX_MAGNIFICATION: () => ZPL_MAX_MAGNIFICATION,
+  ZPL_MIN_MAGNIFICATION: () => ZPL_MIN_MAGNIFICATION,
+  ZPL_QUIET_ZONE_MODULES: () => ZPL_QUIET_ZONE_MODULES,
+  ZPL_SHEET_STOCK_MESSAGE: () => ZPL_SHEET_STOCK_MESSAGE,
+  assertZplScannable: () => assertZplScannable,
+  labelToZpl: () => labelToZpl,
+  labelsToZpl: () => labelsToZpl,
+  zplFieldData: () => zplFieldData
+});
+module.exports = __toCommonJS(zpl_exports);
+
+// src/core.ts
+var import_html_escape = require("@ai-matrx/kit/html-escape");
+function openPrintWindow(htmlDocument, filename = "print", windowFeatures = "width=920,height=720,scrollbars=yes") {
+  const win = window.open("", "_blank", windowFeatures);
+  if (!win) {
+    const blob = new Blob([htmlDocument], { type: "text/html;charset=utf-8" });
+    const url = URL.createObjectURL(blob);
+    const a = document.createElement("a");
+    a.href = url;
+    a.download = `${filename.replace(/\s+/g, "-").toLowerCase()}.html`;
+    document.body.appendChild(a);
+    a.click();
+    document.body.removeChild(a);
+    setTimeout(() => URL.revokeObjectURL(url), 0);
+    return "downloaded";
+  }
+  win.document.open();
+  win.document.write(htmlDocument);
+  win.document.close();
+  return "opened";
+}
+
+// src/labels.ts
+var import_html_escape2 = require("@ai-matrx/kit/html-escape");
+
+// src/qr.ts
+var QR_MIN_QUIET_ZONE_MODULES = 4;
+var DEFAULT_QR_EC_LEVEL = "M";
+var QR_MIN_VERSION = 1;
+var QR_MAX_VERSION = 40;
+var BYTE_CAPACITY = [
+  /* v1  */
+  [17, 14, 11, 7],
+  /* v2  */
+  [32, 26, 20, 14],
+  /* v3  */
+  [53, 42, 32, 24],
+  /* v4  */
+  [78, 62, 46, 34],
+  /* v5  */
+  [106, 84, 60, 44],
+  /* v6  */
+  [134, 106, 74, 58],
+  /* v7  */
+  [154, 122, 86, 64],
+  /* v8  */
+  [192, 152, 108, 84],
+  /* v9  */
+  [230, 180, 130, 98],
+  /* v10 */
+  [271, 213, 151, 119],
+  /* v11 */
+  [321, 251, 177, 137],
+  /* v12 */
+  [367, 287, 203, 155],
+  /* v13 */
+  [425, 331, 241, 177],
+  /* v14 */
+  [458, 362, 258, 194],
+  /* v15 */
+  [520, 412, 292, 220],
+  /* v16 */
+  [586, 450, 322, 250],
+  /* v17 */
+  [644, 504, 364, 280],
+  /* v18 */
+  [718, 560, 394, 310],
+  /* v19 */
+  [792, 624, 442, 338],
+  /* v20 */
+  [858, 666, 482, 382],
+  /* v21 */
+  [929, 711, 509, 403],
+  /* v22 */
+  [1003, 779, 565, 439],
+  /* v23 */
+  [1091, 857, 611, 461],
+  /* v24 */
+  [1171, 911, 661, 511],
+  /* v25 */
+  [1273, 997, 715, 535],
+  /* v26 */
+  [1367, 1059, 751, 593],
+  /* v27 */
+  [1465, 1125, 805, 625],
+  /* v28 */
+  [1528, 1190, 868, 658],
+  /* v29 */
+  [1628, 1264, 908, 698],
+  /* v30 */
+  [1732, 1370, 982, 742],
+  /* v31 */
+  [1840, 1452, 1030, 790],
+  /* v32 */
+  [1952, 1538, 1112, 842],
+  /* v33 */
+  [2068, 1628, 1168, 898],
+  /* v34 */
+  [2188, 1722, 1228, 958],
+  /* v35 */
+  [2303, 1809, 1283, 983],
+  /* v36 */
+  [2431, 1911, 1351, 1051],
+  /* v37 */
+  [2563, 1989, 1423, 1093],
+  /* v38 */
+  [2699, 2099, 1499, 1139],
+  /* v39 */
+  [2809, 2213, 1579, 1219],
+  /* v40 */
+  [2953, 2331, 1663, 1273]
+];
+var EC_COLUMN = { L: 0, M: 1, Q: 2, H: 3 };
+function assertEcLevel(ecLevel) {
+  const column = EC_COLUMN[ecLevel];
+  if (column === void 0) {
+    throw new Error(`Unknown QR error correction level "${String(ecLevel)}". Expected one of "L", "M", "Q", "H".`);
+  }
+  return column;
+}
+function assertVersion(version) {
+  if (typeof version !== "number" || !Number.isInteger(version) || version < QR_MIN_VERSION || version > QR_MAX_VERSION) {
+    throw new Error(
+      `QR version must be an integer between ${QR_MIN_VERSION} and ${QR_MAX_VERSION}, got ${String(version)}.`
+    );
+  }
+  return version;
+}
+function qrByteCapacity(version, ecLevel) {
+  const column = assertEcLevel(ecLevel);
+  const row = BYTE_CAPACITY[assertVersion(version) - 1];
+  if (row === void 0) {
+    throw new Error(`No QR capacity row for version ${version}.`);
+  }
+  return row[column];
+}
+function qrModuleCount(version) {
+  return 17 + 4 * assertVersion(version);
+}
+function minQrVersion(payloadByteLen, ecLevel) {
+  const column = assertEcLevel(ecLevel);
+  if (typeof payloadByteLen !== "number" || !Number.isInteger(payloadByteLen) || payloadByteLen < 0) {
+    throw new Error(`QR payload byte length must be a non-negative integer, got ${String(payloadByteLen)}.`);
+  }
+  for (let version = QR_MIN_VERSION; version <= QR_MAX_VERSION; version += 1) {
+    const row = BYTE_CAPACITY[version - 1];
+    if (row !== void 0 && row[column] >= payloadByteLen) {
+      return version;
+    }
+  }
+  const max = qrByteCapacity(QR_MAX_VERSION, ecLevel);
+  throw new Error(
+    `QR payload of ${payloadByteLen} bytes does not fit any QR version at error correction level "${ecLevel}" (version ${QR_MAX_VERSION} holds ${max} bytes). Shorten the payload \u2014 a short resolver URL is the intended fix \u2014 or, only for a large clean code, drop to a lower error correction level.`
+  );
+}
+function resolveEcLevel(ecLevel) {
+  if (ecLevel === void 0) return DEFAULT_QR_EC_LEVEL;
+  assertEcLevel(ecLevel);
+  return ecLevel;
+}
+function resolveQuietZone(quietZoneModules) {
+  if (typeof quietZoneModules !== "number" || !Number.isFinite(quietZoneModules)) {
+    return QR_MIN_QUIET_ZONE_MODULES;
+  }
+  return Math.max(QR_MIN_QUIET_ZONE_MODULES, Math.floor(quietZoneModules));
+}
+function resolveWidthPx(widthPx) {
+  if (widthPx === void 0) return void 0;
+  if (typeof widthPx !== "number" || !Number.isFinite(widthPx) || widthPx <= 0) {
+    throw new Error(`QR widthPx must be a positive number, got ${String(widthPx)}.`);
+  }
+  return Math.round(widthPx);
+}
+function assertValue(value) {
+  if (typeof value !== "string" || value.length === 0) {
+    throw new Error("QR value must be a non-empty string.");
+  }
+  return value;
+}
+async function generateQrDataUrl(value, opts) {
+  assertValue(value);
+  const width = resolveWidthPx(opts?.widthPx);
+  const options = {
+    errorCorrectionLevel: resolveEcLevel(opts?.ecLevel),
+    margin: resolveQuietZone(opts?.quietZoneModules)
+  };
+  if (width !== void 0) options.width = width;
+  const QRCode = await import("qrcode");
+  return QRCode.toDataURL(value, options);
+}
+
+// src/labels.ts
+var AVERY_5160 = {
+  id: "avery-5160",
+  name: 'Address 1" \xD7 2\u215D" \u2014 30 per sheet',
+  stockCode: "Avery 5160 / 8160",
+  sheetWIn: 8.5,
+  sheetHIn: 11,
+  marginTopIn: 0.5,
+  marginLeftIn: 0.1875,
+  labelWIn: 2.625,
+  labelHIn: 1,
+  cols: 3,
+  rows: 10,
+  gutterXIn: 0.125,
+  gutterYIn: 0,
+  cornerRadiusIn: 0.1
+};
+var LABEL_TEMPLATES = [
+  AVERY_5160,
+  {
+    id: "avery-5163",
+    name: 'Shipping 2" \xD7 4" \u2014 10 per sheet',
+    stockCode: "Avery 5163 / 8163",
+    sheetWIn: 8.5,
+    sheetHIn: 11,
+    marginTopIn: 0.5,
+    marginLeftIn: 0.15625,
+    labelWIn: 4,
+    labelHIn: 2,
+    cols: 2,
+    rows: 5,
+    gutterXIn: 0.1875,
+    gutterYIn: 0,
+    cornerRadiusIn: 0.125
+  },
+  {
+    id: "avery-5164",
+    name: 'Shipping 3\u2153" \xD7 4" \u2014 6 per sheet',
+    stockCode: "Avery 5164 / 8164",
+    sheetWIn: 8.5,
+    sheetHIn: 11,
+    marginTopIn: 0.5,
+    marginLeftIn: 0.15625,
+    labelWIn: 4,
+    labelHIn: 3.3333333,
+    cols: 2,
+    rows: 3,
+    gutterXIn: 0.1875,
+    gutterYIn: 0,
+    cornerRadiusIn: 0.125
+  },
+  {
+    id: "avery-22806",
+    name: 'Square 2" \xD7 2" \u2014 12 per sheet',
+    stockCode: "Avery 22806",
+    sheetWIn: 8.5,
+    sheetHIn: 11,
+    marginTopIn: 0.75,
+    marginLeftIn: 0.5,
+    labelWIn: 2,
+    labelHIn: 2,
+    cols: 3,
+    rows: 4,
+    gutterXIn: 0.75,
+    gutterYIn: 0.5,
+    cornerRadiusIn: 0.09375
+  },
+  {
+    id: "avery-22807",
+    name: 'Round 2" \u2014 12 per sheet',
+    stockCode: "Avery 22807",
+    sheetWIn: 8.5,
+    sheetHIn: 11,
+    marginTopIn: 0.75,
+    marginLeftIn: 0.5,
+    labelWIn: 2,
+    labelHIn: 2,
+    cols: 3,
+    rows: 4,
+    gutterXIn: 0.75,
+    gutterYIn: 0.5,
+    cornerRadiusIn: 1,
+    round: true
+  },
+  {
+    id: "brother-dk-1202",
+    name: 'Shipping roll 2.4" \xD7 3.9" \u2014 die-cut',
+    stockCode: "Brother DK-1202",
+    sheetWIn: 2.4,
+    sheetHIn: 3.9,
+    marginTopIn: 0,
+    marginLeftIn: 0,
+    labelWIn: 2.4,
+    labelHIn: 3.9,
+    cols: 1,
+    rows: 1,
+    gutterXIn: 0,
+    gutterYIn: 0,
+    kind: "roll"
+  },
+  {
+    id: "brother-dk-11201",
+    name: 'Address roll 1.14" \xD7 3.5" \u2014 die-cut',
+    stockCode: "Brother DK-11201",
+    sheetWIn: 1.14,
+    sheetHIn: 3.5,
+    marginTopIn: 0,
+    marginLeftIn: 0,
+    labelWIn: 1.14,
+    labelHIn: 3.5,
+    cols: 1,
+    rows: 1,
+    gutterXIn: 0,
+    gutterYIn: 0,
+    kind: "roll"
+  },
+  {
+    id: "dymo-30252",
+    name: 'Address roll 1\u215B" \xD7 3\xBD"',
+    stockCode: "DYMO 30252",
+    sheetWIn: 1.125,
+    sheetHIn: 3.5,
+    marginTopIn: 0,
+    marginLeftIn: 0,
+    labelWIn: 1.125,
+    labelHIn: 3.5,
+    cols: 1,
+    rows: 1,
+    gutterXIn: 0,
+    gutterYIn: 0,
+    kind: "roll"
+  },
+  {
+    id: "roll-4x6",
+    name: 'Shipping roll 4" \xD7 6"',
+    stockCode: "Thermal 4x6",
+    sheetWIn: 4,
+    sheetHIn: 6,
+    marginTopIn: 0,
+    marginLeftIn: 0,
+    labelWIn: 4,
+    labelHIn: 6,
+    cols: 1,
+    rows: 1,
+    gutterXIn: 0,
+    gutterYIn: 0,
+    kind: "roll"
+  }
+];
+function getLabelTemplate(id) {
+  return LABEL_TEMPLATES.find((t) => t.id === id);
+}
+function assertTemplateGeometry(t) {
+  const w = t.marginLeftIn * 2 + t.cols * t.labelWIn + (t.cols - 1) * t.gutterXIn;
+  const h = t.marginTopIn * 2 + t.rows * t.labelHIn + (t.rows - 1) * t.gutterYIn;
+  const tol = 1 / 64;
+  if (Math.abs(w - t.sheetWIn) > tol || Math.abs(h - t.sheetHIn) > tol) {
+    console.error(
+      `[label-print] Template ${t.id} does not tile its sheet: grid ${w.toFixed(4)}\xD7${h.toFixed(4)}in vs sheet ${t.sheetWIn}\xD7${t.sheetHIn}in`
+    );
+  }
+}
+if (typeof process === "undefined" || true) {
+  LABEL_TEMPLATES.forEach(assertTemplateGeometry);
+}
+var DEFAULTS = {
+  startAtLabel: 1,
+  copiesPerCode: 1,
+  showCaption: true,
+  showLines: true,
+  rangeFrom: 0,
+  rangeTo: 0,
+  ecLevel: "M",
+  calibrationPage: false
+};
+function resolveSettings(s) {
+  const num = (v, d, min = 0) => typeof v === "number" && !Number.isNaN(v) ? Math.max(min, v) : d;
+  const ec = s?.ecLevel;
+  return {
+    startAtLabel: num(s?.startAtLabel, DEFAULTS.startAtLabel, 1),
+    copiesPerCode: num(s?.copiesPerCode, DEFAULTS.copiesPerCode, 1),
+    showCaption: s?.showCaption ?? DEFAULTS.showCaption,
+    showLines: s?.showLines ?? DEFAULTS.showLines,
+    rangeFrom: num(s?.rangeFrom, 0),
+    rangeTo: num(s?.rangeTo, 0),
+    ecLevel: ec === "L" || ec === "Q" ? ec : "M",
+    calibrationPage: s?.calibrationPage ?? false
+  };
+}
+var PRINT_DPI = 300;
+var QUIET_ZONE_MODULES = 4;
+async function generateQrDataUri(value, ecLevel, sizeInches) {
+  return generateQrDataUrl(value, {
+    ecLevel,
+    quietZoneModules: QUIET_ZONE_MODULES,
+    widthPx: Math.round(sizeInches * PRINT_DPI)
+  });
+}
+function computeCellLayout(t, showCaption, hasBadge = false) {
+  const padIn = Math.min(0.08, t.labelHIn * 0.06);
+  const wide = t.labelWIn / t.labelHIn >= 1.8;
+  const badgeZoneIn = hasBadge ? Math.min(0.4, t.labelHIn * 0.22) : 0;
+  if (wide) {
+    return { wide, qrIn: t.labelHIn - padIn * 2, padIn, badgeZoneIn };
+  }
+  const inset = t.round ? t.labelWIn * 0.15 : 0;
+  const captionZone = showCaption ? Math.min(0.28, t.labelHIn * 0.16) : 0;
+  const qrIn = Math.min(
+    t.labelWIn - padIn * 2 - inset * 2,
+    t.labelHIn - padIn * 2 - inset * 2 - captionZone - badgeZoneIn
+  );
+  return { wide, qrIn, padIn, badgeZoneIn };
+}
+function sheetStyles(t) {
+  const radius = t.round ? `${t.labelWIn / 2}in` : t.cornerRadiusIn ? `${t.cornerRadiusIn}in` : "0";
+  return `
+  @page { size: ${t.sheetWIn}in ${t.sheetHIn}in; margin: 0; }
+  *, *::before, *::after { box-sizing: border-box; margin: 0; padding: 0; }
+  html, body { width: ${t.sheetWIn}in; background: #fff; color: #000;
+    font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Helvetica, Arial, sans-serif; }
+
+  .lp-page {
+    width: ${t.sheetWIn}in; height: ${t.sheetHIn}in;
+    position: relative; overflow: hidden;
+    page-break-after: always; break-after: page;
+    border-bottom: 1px solid #e2e8f0; /* screen-only separator */
+  }
+  .lp-page:last-child { page-break-after: auto; break-after: auto; border-bottom: none; }
+
+  .lp-cell {
+    position: absolute;
+    width: ${t.labelWIn}in; height: ${t.labelHIn}in;
+    border-radius: ${radius};
+    overflow: hidden;
+    -webkit-print-color-adjust: exact; print-color-adjust: exact;
+  }
+  .lp-qr {
+    display: block;
+    image-rendering: pixelated; /* no resampling blur on crisp modules */
+  }
+  .lp-cell-wide { display: flex; align-items: center; }
+  .lp-cell-stacked { display: flex; flex-direction: column; align-items: center; justify-content: center; }
+
+  .lp-text { flex: 1 1 auto; min-width: 0; overflow: hidden; align-self: stretch;
+    display: flex; flex-direction: column; justify-content: center; }
+  .lp-fit-wrap { overflow: hidden; }
+  .lp-caption { font-weight: 700; line-height: 1.15; word-break: break-word; }
+  .lp-line { line-height: 1.25; word-break: break-word; }
+  .lp-caption-stacked { text-align: center; width: 100%; }
+
+  /* Badge \u2014 the LARGE token above the caption (garment size, bin letter). */
+  .lp-badge { font-weight: 800; line-height: 1.05; word-break: break-word;
+    -webkit-print-color-adjust: exact; print-color-adjust: exact; }
+  .lp-badge-stacked { text-align: center; width: 100%; }
+
+  /* Durable http(s) artwork in the lines zone. */
+  .lp-img { display: block; width: 100%; object-fit: contain; }
+
+  /* Calibration */
+  .lp-cal-cell { border: 0.5pt dashed #94a3b8; background: transparent; }
+  .lp-cal-label { position: absolute; inset: 0; display: flex; align-items: center;
+    justify-content: center; font-size: 7pt; color: #94a3b8; text-align: center; padding: 4px; }
+  .lp-crop { position: absolute; background: #94a3b8;
+    -webkit-print-color-adjust: exact; print-color-adjust: exact; }
+
+  @media print {
+    html, body { height: auto; overflow: visible; }
+    .lp-page { border-bottom: none; }
+    .screen-only { display: none !important; }
+  }
+`;
+}
+function cellPosition(t, index) {
+  const col = index % t.cols;
+  const row = Math.floor(index / t.cols);
+  return {
+    x: t.marginLeftIn + col * (t.labelWIn + t.gutterXIn),
+    y: t.marginTopIn + row * (t.labelHIn + t.gutterYIn)
+  };
+}
+var LP_FIT_SCRIPT = `
+<script>
+(function () {
+  function fit(el, box) {
+    var size = parseFloat(window.getComputedStyle(el).fontSize);
+    var min = 4;
+    while (size > min && (el.scrollWidth > box.clientWidth + 1 || el.scrollHeight > box.clientHeight + 1)) {
+      size -= 0.5;
+      el.style.fontSize = size + "px";
+    }
+  }
+  function run() {
+    var els = document.querySelectorAll(".lp-fit-wrap .lp-fit");
+    for (var i = 0; i < els.length; i++) fit(els[i], els[i].parentElement);
+  }
+  if (document.readyState === "loading") document.addEventListener("DOMContentLoaded", run);
+  else setTimeout(run, 0);
+})();
+<\/script>`;
+function isHttpUrl(value) {
+  return typeof value === "string" && /^https?:\/\//i.test(value.trim());
+}
+function buildLabelCellHtml(label, qrDataUri, t, layout, s) {
+  const qr = qrDataUri ? `<img class="lp-qr" src="${qrDataUri}" alt="" style="width:${layout.qrIn}in;height:${layout.qrIn}in;" />` : "";
+  const captionText = s.showCaption ? label.caption ?? label.qrValue : "";
+  const badgeText = label.badge?.trim() ? label.badge.trim() : "";
+  if (layout.wide) {
+    const lines = s.showLines && label.lines?.length ? label.lines.filter((l) => l.trim()).map(
+      (l) => `<div class="lp-line" style="font-size:8pt;">${(0, import_html_escape2.escapeHtml)(l)}</div>`
+    ).join("") : "";
+    const caption2 = captionText ? `<div class="lp-fit-wrap" style="max-height:${(t.labelHIn * 0.3).toFixed(3)}in;"><div class="lp-fit lp-caption" style="font-size:12pt;">${(0, import_html_escape2.escapeHtml)(captionText)}</div></div>` : "";
+    const badge2 = badgeText ? `<div class="lp-fit-wrap" style="max-height:${layout.badgeZoneIn.toFixed(3)}in;"><div class="lp-fit lp-badge" style="font-size:24pt;">${(0, import_html_escape2.escapeHtml)(badgeText)}</div></div>` : "";
+    const image = isHttpUrl(label.imageUrl) ? `<img class="lp-img" src="${(0, import_html_escape2.escapeHtml)(label.imageUrl)}" alt="" style="height:${(t.labelHIn * 0.35).toFixed(3)}in;" />` : "";
+    return `<div class="lp-cell-wide" style="height:100%;padding:${layout.padIn}in;gap:${layout.padIn}in;">
+      ${qr}
+      <div class="lp-text">${badge2}${caption2}${lines}${image}</div>
+    </div>`;
+  }
+  const caption = captionText ? `<div class="lp-fit-wrap lp-caption-stacked" style="height:${Math.min(0.28, t.labelHIn * 0.16).toFixed(3)}in;"><div class="lp-fit lp-caption" style="font-size:9pt;">${(0, import_html_escape2.escapeHtml)(captionText)}</div></div>` : "";
+  const badge = badgeText ? `<div class="lp-fit-wrap lp-badge-stacked" style="height:${layout.badgeZoneIn.toFixed(3)}in;"><div class="lp-fit lp-badge" style="font-size:18pt;">${(0, import_html_escape2.escapeHtml)(badgeText)}</div></div>` : "";
+  return `<div class="lp-cell-stacked" style="height:100%;padding:${layout.padIn}in;">
+    ${qr}
+    ${badge}
+    ${caption}
+  </div>`;
+}
+function renderPages(t, cells) {
+  const perPage = t.cols * t.rows;
+  const pages = [];
+  for (let p = 0; p < Math.max(1, Math.ceil(cells.length / perPage)); p++) {
+    const batch = cells.slice(p * perPage, (p + 1) * perPage);
+    const cellHtml = batch.map((c, i) => {
+      const { x, y } = cellPosition(t, i);
+      return `<div class="lp-cell" style="left:${x}in;top:${y}in;">${c.html}</div>`;
+    }).join("\n");
+    pages.push(`<div class="lp-page">${cellHtml}</div>`);
+  }
+  return pages.join("\n");
+}
+function openSheetWindow(t, bodyHtml, title, withFitScript, warning) {
+  const warningHtml = warning ? `<div class="screen-only lp-warning" style="font-family:sans-serif;font-size:12px;font-weight:600;padding:9px 16px;background:#fef2f2;color:#991b1b;border-bottom:1px solid #fecaca;">${(0, import_html_escape2.escapeHtml)(warning)}</div>` : "";
+  const html = `<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <title>${(0, import_html_escape2.escapeHtml)(title)} \u2014 ${(0, import_html_escape2.escapeHtml)(t.stockCode)}</title>
+  <style>${sheetStyles(t)}</style>
+</head>
+<body>
+${warningHtml}
+<div class="screen-only" style="font-family:sans-serif;font-size:12px;padding:10px 16px;background:#f8fafc;border-bottom:1px solid #e2e8f0;display:flex;gap:10px;align-items:center;flex-wrap:wrap;">
+  <button onclick="window.print()" style="padding:7px 18px;background:#111;color:#fff;border:none;border-radius:6px;font-size:13px;font-weight:600;cursor:pointer;">Print / Save PDF</button>
+  <button onclick="window.close()" style="padding:7px 14px;background:#f1f5f9;border:1px solid #cbd5e1;border-radius:6px;font-size:13px;cursor:pointer;">Close</button>
+  <span style="color:#64748b;font-size:11px;">${(0, import_html_escape2.escapeHtml)(t.stockCode)} \xB7 ${(0, import_html_escape2.escapeHtml)(t.name)} \xB7 set printer to <strong>100% scale (no "fit to page"), no margins, Portrait</strong></span>
+</div>
+${bodyHtml}
+${withFitScript ? LP_FIT_SCRIPT : ""}
+</body>
+</html>`;
+  return openPrintWindow(html, title);
+}
+function expandLabels(labels, s) {
+  const from = s.rangeFrom > 0 ? s.rangeFrom : 1;
+  const to = s.rangeTo > 0 ? Math.min(s.rangeTo, labels.length) : labels.length;
+  const subset = labels.slice(from - 1, to);
+  if (s.copiesPerCode <= 1) return subset;
+  const out = [];
+  for (const l of subset)
+    for (let i = 0; i < s.copiesPerCode; i++) out.push(l);
+  return out;
+}
+function buildCalibrationBody(t) {
+  const perPage = t.cols * t.rows;
+  const cells = [];
+  for (let i = 0; i < perPage; i++) {
+    const { x, y } = cellPosition(t, i);
+    cells.push(
+      `<div class="lp-cell lp-cal-cell" style="left:${x}in;top:${y}in;"><div class="lp-cal-label">${i + 1}</div></div>`
+    );
+  }
+  const gridR = t.sheetWIn - t.marginLeftIn;
+  const gridB = t.sheetHIn - t.marginTopIn;
+  const mark = (x, y, h) => `<div class="lp-crop" style="left:${x}in;top:${y}in;width:${h ? 0.25 : 0.0104}in;height:${h ? 0.0104 : 0.25}in;"></div>`;
+  const marks = [
+    mark(t.marginLeftIn - 0.25, t.marginTopIn, true),
+    mark(t.marginLeftIn, t.marginTopIn - 0.25, false),
+    mark(gridR, t.marginTopIn, true),
+    mark(gridR - 0.0104, t.marginTopIn - 0.25, false),
+    mark(t.marginLeftIn - 0.25, gridB - 0.0104, true),
+    mark(t.marginLeftIn, gridB, false),
+    mark(gridR, gridB - 0.0104, true),
+    mark(gridR - 0.0104, gridB, false)
+  ].join("");
+  const banner = `<div style="position:absolute;left:0;right:0;top:${Math.max(0, t.marginTopIn - 0.3).toFixed(2)}in;text-align:center;font-size:7pt;color:#94a3b8;">Calibration \u2014 ${(0, import_html_escape2.escapeHtml)(t.stockCode)} \xB7 hold against your label sheet: every outline must sit on a label</div>`;
+  return `<div class="lp-page">${banner}${marks}${cells.join("\n")}</div>`;
+}
+function printCalibrationSheet(template) {
+  return openSheetWindow(
+    template,
+    buildCalibrationBody(template),
+    "Label calibration",
+    false
+  );
+}
+var MM_PER_IN = 25.4;
+var MIN_SCANNABLE_MODULE_MM = 0.4;
+function assertScannable(template, payloadByteLen, ecLevel = DEFAULTS.ecLevel) {
+  const layout = computeCellLayout(template, true);
+  const printedSideMm = layout.qrIn * MM_PER_IN;
+  let version;
+  try {
+    version = minQrVersion(payloadByteLen, ecLevel);
+  } catch (err) {
+    return {
+      ok: false,
+      version: 0,
+      moduleSizeMm: 0,
+      minModuleSizeMm: MIN_SCANNABLE_MODULE_MM,
+      message: err instanceof Error ? err.message : String(err)
+    };
+  }
+  const modulesPerSide = qrModuleCount(version) + QUIET_ZONE_MODULES * 2;
+  const moduleSizeMm = printedSideMm / modulesPerSide;
+  if (moduleSizeMm >= MIN_SCANNABLE_MODULE_MM) {
+    return {
+      ok: true,
+      version,
+      moduleSizeMm,
+      minModuleSizeMm: MIN_SCANNABLE_MODULE_MM
+    };
+  }
+  return {
+    ok: false,
+    version,
+    moduleSizeMm,
+    minModuleSizeMm: MIN_SCANNABLE_MODULE_MM,
+    message: `A ${payloadByteLen}-byte payload needs a version ${version} QR, which prints at ${moduleSizeMm.toFixed(3)}mm per module on ${template.stockCode} \u2014 below the ${MIN_SCANNABLE_MODULE_MM}mm floor a scanner can resolve. Shorten the payload (a short resolver URL is the intended fix) or move to larger label stock.`
+  };
+}
+function batchScannabilityWarning(t, labels, ecLevel) {
+  const encoder = new TextEncoder();
+  let worst = -1;
+  for (const l of labels) {
+    if (!l.qrValue) continue;
+    const len = encoder.encode(l.qrValue).length;
+    if (len > worst) worst = len;
+  }
+  if (worst < 0) return void 0;
+  const report = assertScannable(t, worst, ecLevel);
+  return report.ok ? void 0 : report.message;
+}
+function resolveTemplate(data, variantId) {
+  if (variantId && variantId !== "custom") {
+    const t = getLabelTemplate(variantId);
+    if (t) return t;
+  }
+  if (data.templateId === "custom" && data.customTemplate)
+    return data.customTemplate;
+  return getLabelTemplate(data.templateId) ?? data.customTemplate ?? AVERY_5160;
+}
+async function printQrLabelSheet(data, variantId, rawSettings) {
+  const t = resolveTemplate(data, variantId);
+  const s = resolveSettings(rawSettings);
+  if (s.calibrationPage) {
+    return printCalibrationSheet(t);
+  }
+  const labels = expandLabels(data.labels ?? [], s);
+  if (!labels.length) {
+    return openSheetWindow(
+      t,
+      `<div class="lp-page"><div style="position:absolute;inset:0;display:flex;align-items:center;justify-content:center;color:#94a3b8;font-size:11pt;">No labels to print.</div></div>`,
+      "QR labels",
+      false
+    );
+  }
+  const hasBadge = labels.some((l) => (l.badge ?? "").trim() !== "");
+  const layout = computeCellLayout(t, s.showCaption, hasBadge);
+  const uriByValue = /* @__PURE__ */ new Map();
+  for (const l of labels) {
+    if (l.qrValue && !uriByValue.has(l.qrValue)) {
+      uriByValue.set(
+        l.qrValue,
+        await generateQrDataUri(l.qrValue, s.ecLevel, layout.qrIn)
+      );
+    }
+  }
+  const leadingBlanks = Math.max(0, s.startAtLabel - 1) % (t.cols * t.rows);
+  const cells = [
+    ...Array.from({ length: leadingBlanks }, () => ({ html: "" })),
+    ...labels.map((l) => ({
+      html: buildLabelCellHtml(
+        l,
+        uriByValue.get(l.qrValue) ?? "",
+        t,
+        layout,
+        s
+      )
+    }))
+  ];
+  const perPage = t.cols * t.rows;
+  const tail = cells.length % perPage;
+  if (tail > 0)
+    for (let i = 0; i < perPage - tail; i++) cells.push({ html: "" });
+  return openSheetWindow(
+    t,
+    renderPages(t, cells),
+    "QR labels",
+    true,
+    batchScannabilityWarning(t, labels, s.ecLevel)
+  );
+}
+var qrLabelsPrinter = {
+  label: "Print QR label sheet",
+  variants: LABEL_TEMPLATES.map((t) => ({
+    id: t.id,
+    label: t.name,
+    description: t.stockCode
+  })),
+  settings: [
+    {
+      type: "number",
+      id: "startAtLabel",
+      label: "Start at label #",
+      description: "Skip already-used positions on a partial sheet",
+      defaultValue: 1,
+      min: 1
+    },
+    {
+      type: "number",
+      id: "copiesPerCode",
+      label: "Copies per code",
+      defaultValue: 1,
+      min: 1,
+      max: 999
+    },
+    {
+      type: "boolean",
+      id: "showCaption",
+      label: "Show caption",
+      description: "Print the caption (or the code value) beside each QR",
+      defaultValue: true
+    },
+    {
+      type: "boolean",
+      id: "showLines",
+      label: "Show detail lines",
+      description: "Extra text lines on wide labels",
+      defaultValue: true
+    },
+    {
+      type: "range",
+      id: "labelRange",
+      label: "Label range",
+      description: "Print only labels N to M (blank = all)",
+      fromId: "rangeFrom",
+      toId: "rangeTo",
+      defaultFrom: 0,
+      defaultTo: 0
+    },
+    {
+      type: "select",
+      id: "ecLevel",
+      label: "Error correction",
+      description: "Higher survives more damage; M is the warehouse default",
+      options: [
+        { value: "L", label: "L" },
+        { value: "M", label: "M" },
+        { value: "Q", label: "Q" }
+      ],
+      defaultValue: "M"
+    },
+    {
+      type: "boolean",
+      id: "calibrationPage",
+      label: "Calibration test page",
+      description: "Print outlines + crop marks only to verify alignment",
+      defaultValue: false
+    }
+  ],
+  print: (data, variantId, settings) => printQrLabelSheet(data, variantId, settings)
+};
+
+// src/zpl.ts
+var ZPL_MIN_MAGNIFICATION = 1;
+var ZPL_MAX_MAGNIFICATION = 10;
+var ZPL_QUIET_ZONE_MODULES = 4;
+var DEFAULT_ZPL_DPI = 203;
+var DEFAULT_ZPL_EC_LEVEL = "M";
+var MM_PER_IN2 = 25.4;
+var ZPL_SHEET_STOCK_MESSAGE = "ZPL is for roll stock \u2014 use printQrLabelSheet for sheets";
+function resolveOptions(opts) {
+  const dpi = opts?.dpi ?? DEFAULT_ZPL_DPI;
+  if (dpi !== 203 && dpi !== 300) {
+    throw new Error(
+      `ZPL dpi must be 203 (8 dots/mm) or 300 (12 dots/mm), got ${String(dpi)}.`
+    );
+  }
+  const copies = opts?.copies ?? 1;
+  if (!Number.isInteger(copies) || copies < 1 || copies > 9999) {
+    throw new Error(`ZPL copies must be an integer between 1 and 9999, got ${String(copies)}.`);
+  }
+  const rawDarkness = opts?.darkness;
+  let darkness;
+  if (rawDarkness !== void 0) {
+    if (!Number.isInteger(rawDarkness) || rawDarkness < -30 || rawDarkness > 30) {
+      throw new Error(
+        `ZPL darkness (^MD) must be an integer between -30 and 30, got ${String(rawDarkness)}.`
+      );
+    }
+    darkness = rawDarkness;
+  }
+  const ecLevel = opts?.ecLevel ?? DEFAULT_ZPL_EC_LEVEL;
+  if (ecLevel !== "L" && ecLevel !== "M" && ecLevel !== "Q" && ecLevel !== "H") {
+    throw new Error(
+      `ZPL QR error correction must be "L", "M", "Q" or "H", got ${String(ecLevel)}.`
+    );
+  }
+  return { dpi, darkness, copies, ecLevel };
+}
+function assertRollStock(template) {
+  if (template.kind !== "roll") {
+    throw new Error(
+      `${ZPL_SHEET_STOCK_MESSAGE} (template "${template.id}" \u2014 ${template.stockCode} \u2014 is ${template.cols}\xD7${template.rows} sheet stock, which has no ZPL page model).`
+    );
+  }
+}
+var HEX = "0123456789ABCDEF";
+function zplFieldData(text) {
+  if (typeof text !== "string") {
+    throw new Error(`ZPL field data must be a string, got ${String(text)}.`);
+  }
+  if (text === "") return "";
+  const bytes = new TextEncoder().encode(text);
+  let out = "";
+  for (const byte of bytes) {
+    const safe = byte >= 32 && byte <= 126 && byte !== 94 && byte !== 126 && byte !== 95;
+    if (safe) {
+      out += String.fromCharCode(byte);
+    } else {
+      out += `_${HEX[byte >> 4 & 15] ?? "0"}${HEX[byte & 15] ?? "0"}`;
+    }
+  }
+  return out;
+}
+function dots(inches, dpi) {
+  return Math.round(inches * dpi);
+}
+function clampMagnification(value) {
+  if (!Number.isFinite(value)) return ZPL_MIN_MAGNIFICATION;
+  return Math.min(ZPL_MAX_MAGNIFICATION, Math.max(ZPL_MIN_MAGNIFICATION, Math.floor(value)));
+}
+function payloadByteLength(value) {
+  return new TextEncoder().encode(value).length;
+}
+function magnificationFor(qrBoxDots, payloadBytes, ecLevel) {
+  const version = minQrVersion(payloadBytes, ecLevel);
+  const modulesPerSide = qrModuleCount(version) + ZPL_QUIET_ZONE_MODULES * 2;
+  const magnification = clampMagnification(qrBoxDots / modulesPerSide);
+  return { version, magnification, drawnDots: modulesPerSide * magnification };
+}
+function captionZoneIn(t, wide) {
+  return wide ? t.labelHIn * 0.3 : Math.min(0.28, t.labelHIn * 0.16);
+}
+function textField(x, y, widthDots, fontHeightDots, justify, text) {
+  return `^FO${x},${y}^A0N,${fontHeightDots},0^FB${widthDots},1,0,${justify}^FH^FD${zplFieldData(text)}^FS`;
+}
+function qrField(x, y, magnification, ecLevel, value) {
+  return `^FO${x},${y}^BQN,2,${magnification}^FH^FD${ecLevel}A,${zplFieldData(value)}^FS`;
+}
+function cleanLines(lines) {
+  if (lines === void 0) return [];
+  return lines.map((l) => l.trim()).filter((l) => l !== "");
+}
+function labelToZpl(template, label, opts) {
+  assertRollStock(template);
+  const o = resolveOptions(opts);
+  const captionText = (label.caption ?? label.qrValue).trim();
+  const badgeText = (label.badge ?? "").trim();
+  const lines = cleanLines(label.lines);
+  const hasQr = typeof label.qrValue === "string" && label.qrValue !== "";
+  const layout = computeCellLayout(template, captionText !== "", badgeText !== "");
+  const labelWDots = dots(template.labelWIn, o.dpi);
+  const labelHDots = dots(template.labelHIn, o.dpi);
+  const padDots = dots(layout.padIn, o.dpi);
+  const qrBoxDots = hasQr ? dots(layout.qrIn, o.dpi) : 0;
+  const badgeZoneDots = badgeText !== "" ? dots(layout.badgeZoneIn, o.dpi) : 0;
+  const captionZoneDots = captionText !== "" ? dots(captionZoneIn(template, layout.wide), o.dpi) : 0;
+  const lineFontDots = Math.max(8, Math.round(o.dpi * 8 / 72));
+  const lineStepDots = Math.round(lineFontDots * 1.25);
+  const linesHDots = lines.length * lineStepDots;
+  const badgeFontDots = Math.max(10, Math.round(badgeZoneDots * 0.8));
+  const captionFontDots = Math.max(8, Math.round(captionZoneDots * 0.72));
+  const commands = [];
+  commands.push("^XA");
+  commands.push("^CI28");
+  commands.push("^LH0,0");
+  commands.push(`^PW${dots(template.labelWIn, o.dpi)}`);
+  commands.push(`^LL${dots(template.labelHIn, o.dpi)}`);
+  if (o.darkness !== void 0) {
+    commands.push(`^MD${o.darkness}`);
+  }
+  const fit = hasQr ? magnificationFor(qrBoxDots, payloadByteLength(label.qrValue), o.ecLevel) : { version: 0, magnification: 0, drawnDots: 0 };
+  const quietDots = fit.magnification * ZPL_QUIET_ZONE_MODULES;
+  if (layout.wide) {
+    const qrY = Math.max(padDots, Math.round((labelHDots - fit.drawnDots) / 2));
+    if (hasQr) {
+      commands.push(
+        qrField(padDots + quietDots, qrY + quietDots, fit.magnification, o.ecLevel, label.qrValue)
+      );
+    }
+    const textX = padDots + fit.drawnDots + padDots;
+    const textW = Math.max(1, labelWDots - textX - padDots);
+    let y = padDots;
+    if (badgeText !== "") {
+      commands.push(textField(textX, y, textW, badgeFontDots, "L", badgeText));
+      y += badgeZoneDots;
+    }
+    if (captionText !== "") {
+      commands.push(textField(textX, y, textW, captionFontDots, "L", captionText));
+      y += captionZoneDots;
+    }
+    for (const line of lines) {
+      commands.push(textField(textX, y, textW, lineFontDots, "L", line));
+      y += lineStepDots;
+    }
+  } else {
+    const contentH = fit.drawnDots + badgeZoneDots + captionZoneDots + linesHDots;
+    const textW = Math.max(1, labelWDots - padDots * 2);
+    let y = Math.max(padDots, Math.round((labelHDots - contentH) / 2));
+    if (hasQr) {
+      const qrX = Math.max(0, Math.round((labelWDots - fit.drawnDots) / 2));
+      commands.push(
+        qrField(qrX + quietDots, y + quietDots, fit.magnification, o.ecLevel, label.qrValue)
+      );
+      y += fit.drawnDots;
+    }
+    if (badgeText !== "") {
+      commands.push(textField(padDots, y, textW, badgeFontDots, "C", badgeText));
+      y += badgeZoneDots;
+    }
+    if (captionText !== "") {
+      commands.push(textField(padDots, y, textW, captionFontDots, "C", captionText));
+      y += captionZoneDots;
+    }
+    for (const line of lines) {
+      commands.push(textField(padDots, y, textW, lineFontDots, "C", line));
+      y += lineStepDots;
+    }
+  }
+  if (o.copies > 1) {
+    commands.push(`^PQ${o.copies},0,0,N`);
+  }
+  commands.push("^XZ");
+  return commands.join("\n");
+}
+function labelsToZpl(template, labels, opts) {
+  assertRollStock(template);
+  resolveOptions(opts);
+  if (labels.length === 0) return "";
+  return labels.map((label) => labelToZpl(template, label, opts)).join("\n");
+}
+function assertZplScannable(template, payloadByteLen, opts) {
+  const fail = (message, version2 = 0, moduleSizeMm2 = 0) => ({
+    ok: false,
+    version: version2,
+    moduleSizeMm: moduleSizeMm2,
+    minModuleSizeMm: MIN_SCANNABLE_MODULE_MM,
+    message
+  });
+  if (template.kind !== "roll") {
+    return fail(
+      `${ZPL_SHEET_STOCK_MESSAGE} (template "${template.id}" \u2014 ${template.stockCode} \u2014 is sheet stock).`
+    );
+  }
+  let o;
+  try {
+    o = resolveOptions(opts);
+  } catch (err) {
+    return fail(err instanceof Error ? err.message : String(err));
+  }
+  const layout = computeCellLayout(template, true);
+  const qrBoxDots = dots(layout.qrIn, o.dpi);
+  let fit;
+  try {
+    fit = magnificationFor(qrBoxDots, payloadByteLen, o.ecLevel);
+  } catch (err) {
+    return fail(err instanceof Error ? err.message : String(err));
+  }
+  const { version, magnification } = fit;
+  const moduleSizeMm = magnification * MM_PER_IN2 / o.dpi;
+  if (moduleSizeMm >= MIN_SCANNABLE_MODULE_MM) {
+    return {
+      ok: true,
+      version,
+      moduleSizeMm,
+      minModuleSizeMm: MIN_SCANNABLE_MODULE_MM
+    };
+  }
+  return fail(
+    `A ${payloadByteLen}-byte payload needs a version ${version} QR, which ZPL prints at magnification ${magnification} (${moduleSizeMm.toFixed(3)}mm per module) on ${template.stockCode} at ${o.dpi}dpi \u2014 below the ${MIN_SCANNABLE_MODULE_MM}mm floor a scanner can resolve. Shorten the payload (a short resolver URL is the intended fix), move to larger roll stock, or print on a 300dpi head.`,
+    version,
+    moduleSizeMm
+  );
+}
+//# sourceMappingURL=zpl.cjs.map