retail-print-kit 0.2.2 → 0.3.0

package/dist/label-design/builtins.d.ts

@@ -0,0 +1,13 @@
+import { BUILTIN_TEMPLATES } from './builtins-data';
+import { BuiltinTemplate, LabelData, LabelDesign, PrinterLanguage } from './types';
+export { BUILTIN_TEMPLATES };
+export declare function normalizeSize(size: string | undefined | null): string;
+/** The built-in layout a printer uses for a size and price type, with the same fallbacks the layouts always had. */
+export declare function findBuiltinTemplate(size: string | undefined | null, labelType: string | undefined | null, language: PrinterLanguage): BuiltinTemplate | undefined;
+export declare function encodeBuiltinLabel(template: BuiltinTemplate, language: PrinterLanguage, data: LabelData): string;
+export declare function newId(): string;
+/** An editable design that prints exactly like the built-in layout until it is changed. */
+export declare function designFromBuiltin(builtin: BuiltinTemplate, language: PrinterLanguage): LabelDesign;
+export declare function blankDesign(widthMm: number, heightMm: number, dpi: number, printer: PrinterLanguage, gapMm: number): LabelDesign;
+/** The same layout stretched to a new size; printer-font elements become designer text. */
+export declare function scaleDesign(design: LabelDesign, widthMm: number, heightMm: number): LabelDesign;

package/dist/label-design/builtins.js

@@ -0,0 +1,124 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BUILTIN_TEMPLATES = void 0;
+exports.normalizeSize = normalizeSize;
+exports.findBuiltinTemplate = findBuiltinTemplate;
+exports.encodeBuiltinLabel = encodeBuiltinLabel;
+exports.newId = newId;
+exports.designFromBuiltin = designFromBuiltin;
+exports.blankDesign = blankDesign;
+exports.scaleDesign = scaleDesign;
+const builtins_data_1 = require("./builtins-data");
+Object.defineProperty(exports, "BUILTIN_TEMPLATES", { enumerable: true, get: function () { return builtins_data_1.BUILTIN_TEMPLATES; } });
+const encode_1 = require("./encode");
+const fields_1 = require("./fields");
+const printer_text_1 = require("./printer-text");
+const units_1 = require("./units");
+const DEFAULT_SIZE = '2 X 1';
+const SIZE_ALIASES = { '1 X 1.25': '1.25 X 1' };
+const EZPL_FONT_PT = { A: 6, B: 8, C: 10, D: 12, E: 14, F: 18, G: 24, H: 30 };
+function normalizeSize(size) {
+    const key = String(size || '').toUpperCase().replace(/["”]/g, '').replace(/\s+/g, ' ').trim();
+    return SIZE_ALIASES[key] || key;
+}
+/** The built-in layout a printer uses for a size and price type, with the same fallbacks the layouts always had. */
+function findBuiltinTemplate(size, labelType, language) {
+    const printable = builtins_data_1.BUILTIN_TEMPLATES.filter((t) => t.printers[language]);
+    const requested = normalizeSize(size);
+    const chosenSize = printable.some((t) => t.size === requested) ? requested : DEFAULT_SIZE;
+    const layout = labelType === 'dual' && printable.some((t) => t.size === chosenSize && t.layout === 'dual') ? 'dual' : 'single';
+    return printable.find((t) => t.size === chosenSize && t.layout === layout);
+}
+function encodeBuiltinLabel(template, language, data) {
+    const variant = template.printers[language];
+    if (!variant)
+        throw new Error(`retail-print-kit: label template ${template.id} has no ${language} layout`);
+    const lines = language === 'zpl' ? variant.header.slice() : (0, encode_1.ezplHeader)(variant.header);
+    for (const el of variant.elements) {
+        const bound = String(el.value).match(/\{\{(\w+)\}\}/g) || [];
+        if (el.type === 'barcode' && bound.some((b) => b === '{{barcode}}') && String((0, fields_1.fieldValue)(data, 'barcode')).trim() === '')
+            continue;
+        const raw = el.value.replace(/\{\{(\w+)\}\}/g, (m, key) => String((0, fields_1.fieldValue)(data, key)));
+        const value = el.value.replace(/\{\{(\w+)\}\}/g, (m, key) => (0, printer_text_1.cleanForPrinter)((0, fields_1.fieldValue)(data, key), language));
+        const pos = el.fit ? (0, printer_text_1.fitText)(el.fit, raw) : { x: el.x, y: el.y };
+        lines.push(el.native.replace(/\{(x|y|size|value)\}/g, (m, slot) => (slot === 'value' ? value : String(pos[slot]))));
+    }
+    lines.push(language === 'zpl' ? '^XZ' : 'E');
+    return lines.join('\r\n') + '\r\n';
+}
+let idCounter = 0;
+function newId() {
+    idCounter += 1;
+    return `e${Date.now().toString(36)}${idCounter}`;
+}
+function nativeText(pattern, x, y, dpi, fieldValueText, labelWidthMm) {
+    const parts = pattern.split(',');
+    const letter = parts[0].charAt(1);
+    const ymul = Number(parts[4]) || 1;
+    const pt = (EZPL_FONT_PT[letter] || 10) * ymul;
+    const xMm = (0, units_1.dotsToMm)(x, dpi);
+    const hMm = (pt / units_1.PT_PER_INCH) * units_1.MM_PER_INCH * 1.25;
+    return { id: newId(), type: 'text', x: xMm, y: (0, units_1.dotsToMm)(y, dpi), w: Math.max(2, labelWidthMm - xMm - 0.5), h: hMm, value: fieldValueText, font: 'printer', size: pt, weight: 700, align: 'left', fit: 'cut' };
+}
+/** An editable design that prints exactly like the built-in layout until it is changed. */
+function designFromBuiltin(builtin, language) {
+    const variant = builtin.printers[language];
+    if (!variant)
+        throw new Error(`retail-print-kit: label template ${builtin.id} has no ${language} layout`);
+    const dpi = builtin.dpi || 203;
+    const elements = [];
+    for (const el of variant.elements) {
+        const native = { [language]: el.native };
+        if (el.fit) {
+            const fit = el.fit;
+            elements.push({
+                id: newId(), type: 'text', x: (0, units_1.dotsToMm)(fit.left, dpi), y: (0, units_1.dotsToMm)(fit.middle - fit.size / 2, dpi),
+                w: (0, units_1.dotsToMm)(fit.right - fit.left, dpi), h: (0, units_1.dotsToMm)(fit.size, dpi), value: el.value, font: 'printer',
+                size: (fit.size / dpi) * units_1.PT_PER_INCH, weight: 700, align: 'center', fit: 'shrink', native, nativeFit: fit
+            });
+            continue;
+        }
+        if (el.type === 'barcode') {
+            const m = language === 'zpl' ? el.native.match(/\^BY(\d+)/) : el.native.split(',');
+            const module = language === 'zpl' ? Number(m ? m[1] : 2) : Number(m[3]) || 2;
+            const hDots = language === 'zpl' ? Number((el.native.match(/\^BU[NRIB],(\d+)/) || [])[1] || 40) : Number(m[5]) || 40;
+            elements.push({
+                id: newId(), type: 'barcode', x: (0, units_1.dotsToMm)(el.x, dpi), y: (0, units_1.dotsToMm)(el.y, dpi), w: (0, units_1.dotsToMm)(113 * module, dpi), h: (0, units_1.dotsToMm)(hDots * 1.3, dpi),
+                value: el.value, symbology: 'UPC_A', module, hri: true, native
+            });
+            continue;
+        }
+        if (language === 'zpl') {
+            const f = el.native.match(/\^A0[NRIB],(\d+),(\d+)/);
+            const hDots = f ? Number(f[1]) : 24;
+            const xMm = (0, units_1.dotsToMm)(el.x, dpi);
+            elements.push({
+                id: newId(), type: 'text', x: xMm, y: (0, units_1.dotsToMm)(el.y, dpi), w: Math.max(2, builtin.widthMm - xMm - 0.5), h: (0, units_1.dotsToMm)(hDots, dpi),
+                value: el.value, font: 'printer', size: (hDots / dpi) * units_1.PT_PER_INCH, weight: 700, align: 'left', fit: 'cut', native
+            });
+            continue;
+        }
+        const t = nativeText(el.native, el.x, el.y, dpi, el.value, builtin.widthMm);
+        t.native = native;
+        elements.push(t);
+    }
+    return {
+        version: 1, kind: 'label', widthMm: builtin.widthMm, heightMm: builtin.heightMm, dpi, printer: language, gapMm: 3,
+        source: builtin.id, nativeHeader: { [language]: variant.header }, limits: variant.limits, stock: null, elements
+    };
+}
+function blankDesign(widthMm, heightMm, dpi, printer, gapMm) {
+    return { version: 1, kind: 'label', widthMm, heightMm, dpi, printer, gapMm, stock: null, elements: [] };
+}
+/** The same layout stretched to a new size; printer-font elements become designer text. */
+function scaleDesign(design, widthMm, heightMm) {
+    const sx = widthMm / design.widthMm;
+    const sy = heightMm / design.heightMm;
+    return {
+        ...design, widthMm, heightMm, source: design.source, nativeHeader: undefined,
+        elements: design.elements.map((e) => {
+            const { native, nativeFit, ...rest } = e;
+            return { ...rest, id: newId(), x: e.x * sx, y: e.y * sy, w: e.w * sx, h: e.h * sy, font: e.font === 'printer' ? 'sans' : e.font };
+        })
+    };
+}

package/dist/label-design/encode.d.ts

@@ -0,0 +1,11 @@
+import { EzplHeader, LabelData, LabelDesign, PrinterLanguage, Rasterize } from './types';
+export declare function languageForPrinter(printerName: string | undefined | null): PrinterLanguage;
+export declare function ezplHeader(h: EzplHeader): string[];
+/**
+ * Printer commands for one label. Printer-font elements and barcodes, lines and boxes are native commands;
+ * designer fonts, prices, QR codes and images come from `rasterize` as graphics (ZPL ^GFA, EZPL Q).
+ */
+export declare function encodeDesignLabel(design: LabelDesign, language: PrinterLanguage, data: LabelData, rasterize: Rasterize, labelOffset?: {
+    x?: number;
+    y?: number;
+} | null): Uint8Array;

package/dist/label-design/encode.js

@@ -0,0 +1,151 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.languageForPrinter = languageForPrinter;
+exports.ezplHeader = ezplHeader;
+exports.encodeDesignLabel = encodeDesignLabel;
+const printer_text_1 = require("./printer-text");
+const fields_1 = require("./fields");
+const units_1 = require("./units");
+const EZPL_BARCODES = { UPC_A: 'H', EAN13: 'E', CODE128: 'C' };
+const ZPL_BARCODES = { UPC_A: 'BU', EAN13: 'BE', CODE128: 'BC' };
+const encoder = new TextEncoder();
+function languageForPrinter(printerName) {
+    return String(printerName || '').trim().toLowerCase() === 'zebra' ? 'zpl' : 'ezpl';
+}
+function ezplHeader(h) {
+    const lines = [
+        '^XSETCUT,DOUBLECUT,0', `^Q${h.q},${h.gap === undefined ? '3' : h.gap}`, `^W${h.w}`, `^H${h.h}`, '^P1', `^S${h.s}`, '^AD', '^C1',
+        `^R${h.r === undefined ? '0' : h.r}`, `~Q${h.shift === undefined ? '+0' : h.shift}`, '^O0', '^D0', '^E18', '~R255', '^L'
+    ];
+    if (h.includeDateTimeLines !== false) {
+        lines.push('Dy2-me-dd', 'Th:m:s');
+        if (h.addDateTimeTwice)
+            lines.push('Dy2-me-dd', 'Th:m:s');
+    }
+    return lines;
+}
+function gapText(gapMm) {
+    const gap = Number(gapMm);
+    return Number.isFinite(gap) && gap >= 0 ? String(Math.round(gap * 10) / 10) : undefined;
+}
+function headerLines(design, language) {
+    const dpi = design.dpi || 203;
+    const native = design.nativeHeader && design.nativeHeader[language];
+    if (language === 'zpl') {
+        return native ? native.slice() : ['^XA', '^CI28', `^PW${(0, units_1.mmToDots)(design.widthMm, dpi)}`, `^LL${(0, units_1.mmToDots)(design.heightMm, dpi)}`, '^LH0,0', '^PR2', '^MD18'];
+    }
+    return ezplHeader(native || { q: Number(design.heightMm).toFixed(2), w: Number(design.widthMm).toFixed(2), h: '10', s: '3', gap: gapText(design.gapMm), addDateTimeTwice: false });
+}
+function resolveRaw(template, data) {
+    return String(template || '').replace(/\{\{(\w+)\}\}/g, (m, key) => String((0, fields_1.fieldValue)(data, key)));
+}
+function resolveClean(template, data, language) {
+    return String(template || '').replace(/\{\{(\w+)\}\}/g, (m, key) => (0, printer_text_1.cleanForPrinter)((0, fields_1.fieldValue)(data, key), language));
+}
+function nativeLine(el, language, data, dpi, offset) {
+    const pattern = el.native[language];
+    const bound = String(el.value || '').match(/\{\{(\w+)\}\}/g) || [];
+    if (el.type === 'barcode' && bound.includes('{{barcode}}') && String((0, fields_1.fieldValue)(data, 'barcode')).trim() === '')
+        return null;
+    const value = resolveClean(el.value, data, language);
+    let pos;
+    if (el.nativeFit) {
+        const fit = { left: (0, units_1.mmToDots)(el.x, dpi), right: (0, units_1.mmToDots)(el.x + el.w, dpi), middle: (0, units_1.mmToDots)(el.y + el.h / 2, dpi), size: el.nativeFit.size };
+        pos = (0, printer_text_1.fitText)(fit, resolveRaw(el.value, data));
+    }
+    else {
+        pos = { x: (0, units_1.mmToDots)(el.x, dpi), y: (0, units_1.mmToDots)(el.y, dpi) };
+    }
+    pos = { ...pos, x: Math.max(0, pos.x + offset.x), y: Math.max(0, pos.y + offset.y) };
+    return pattern.replace(/\{(x|y|size|value)\}/g, (m, slot) => (slot === 'value' ? value : String(pos[slot])));
+}
+function barcodeLine(el, language, data, dpi, offset) {
+    const value = resolveClean(el.value, data, language).trim();
+    if (!value)
+        return null;
+    const symbology = el.symbology || 'UPC_A';
+    const module = Math.max(1, Math.round(el.module || 2));
+    const hri = el.hri !== false;
+    const height = Math.max(8, (0, units_1.mmToDots)(el.h * (hri ? 0.78 : 1), dpi));
+    const x = Math.max(0, (0, units_1.mmToDots)(el.x, dpi) + offset.x);
+    const y = Math.max(0, (0, units_1.mmToDots)(el.y, dpi) + offset.y);
+    if (language === 'zpl') {
+        const code = ZPL_BARCODES[symbology] || 'BU';
+        const tail = code === 'BC' ? `${hri ? 'Y' : 'N'},N,N` : code === 'BU' ? `${hri ? 'Y' : 'N'},N,Y` : `${hri ? 'Y' : 'N'},N`;
+        return `^FO${x},${y}^BY${module}^${code}N,${height},${tail}^FD${value}^FS`;
+    }
+    const code = EZPL_BARCODES[symbology] || 'H';
+    return `B${code},${x},${y},${module},${module},${height},0,${hri ? 1 : 0},${value}`;
+}
+function shapeLine(el, language, dpi, offset) {
+    const x = Math.max(0, (0, units_1.mmToDots)(el.x, dpi) + offset.x);
+    const y = Math.max(0, (0, units_1.mmToDots)(el.y, dpi) + offset.y);
+    const w = Math.max(1, (0, units_1.mmToDots)(el.w, dpi));
+    const h = Math.max(1, (0, units_1.mmToDots)(el.h, dpi));
+    const t = el.type === 'box' ? Math.max(1, (0, units_1.mmToDots)(el.stroke || 0.3, dpi)) : Math.min(w, h);
+    if (language === 'zpl')
+        return `^FO${x},${y}^GB${w},${h},${t}^FS`;
+    return el.type === 'box' ? `R${x},${y},${x + w},${y + h},${t},${t}` : `R${x},${y},${x + w},${y + h},${w},${h}`;
+}
+function hex(bits) {
+    let out = '';
+    for (let i = 0; i < bits.length; i++)
+        out += (bits[i] < 16 ? '0' : '') + bits[i].toString(16);
+    return out.toUpperCase();
+}
+function zplGraphic(x, y, bitmap) {
+    const rowBytes = Math.ceil(bitmap.width / 8);
+    const total = rowBytes * bitmap.height;
+    return `^FO${x},${y}^GFA,${total},${total},${rowBytes},${hex(bitmap.bits)}^FS`;
+}
+function ezplGraphic(x, y, bitmap) {
+    const rowBytes = Math.ceil(bitmap.width / 8);
+    return concat([encoder.encode(`Q${x},${y},${rowBytes},${bitmap.height}\r\n`), bitmap.bits]);
+}
+function concat(parts) {
+    const out = new Uint8Array(parts.reduce((n, p) => n + p.length, 0));
+    let o = 0;
+    for (const p of parts) {
+        out.set(p, o);
+        o += p.length;
+    }
+    return out;
+}
+/**
+ * Printer commands for one label. Printer-font elements and barcodes, lines and boxes are native commands;
+ * designer fonts, prices, QR codes and images come from `rasterize` as graphics (ZPL ^GFA, EZPL Q).
+ */
+function encodeDesignLabel(design, language, data, rasterize, labelOffset) {
+    const dpi = design.dpi || 203;
+    const offset = { x: Math.round(Number(labelOffset && labelOffset.x) || 0), y: Math.round(Number(labelOffset && labelOffset.y) || 0) };
+    const parts = headerLines(design, language).map((line) => encoder.encode(line));
+    for (const el of design.elements || []) {
+        if (!(0, fields_1.isVisible)(el, data))
+            continue;
+        if (el.native && el.native[language]) {
+            const line = nativeLine(el, language, data, dpi, offset);
+            if (line !== null)
+                parts.push(encoder.encode(line));
+            continue;
+        }
+        if (el.type === 'barcode') {
+            const line = barcodeLine(el, language, data, dpi, offset);
+            if (line !== null)
+                parts.push(encoder.encode(line));
+            continue;
+        }
+        if (el.type === 'box' || el.type === 'fill' || el.type === 'line') {
+            parts.push(encoder.encode(shapeLine(el, language, dpi, offset)));
+            continue;
+        }
+        const bitmap = rasterize(el, data, dpi);
+        if (!bitmap || !bitmap.width || !bitmap.height)
+            continue;
+        const x = Math.max(0, (0, units_1.mmToDots)(el.x, dpi) + offset.x);
+        const y = Math.max(0, (0, units_1.mmToDots)(el.y, dpi) + offset.y);
+        parts.push(language === 'zpl' ? encoder.encode(zplGraphic(x, y, bitmap)) : ezplGraphic(x, y, bitmap));
+    }
+    parts.push(encoder.encode(language === 'zpl' ? '^XZ' : 'E'));
+    const crlf = encoder.encode('\r\n');
+    return concat(parts.reduce((out, part) => out.concat([part, crlf]), []));
+}

package/dist/label-design/fields.d.ts

@@ -0,0 +1,30 @@
+import { FieldOption, LabelData, LabelDesign, LabelElement } from './types';
+export declare const FIELDS: FieldOption[];
+export declare const FONTS: {
+    key: string;
+    label: string;
+    family: string;
+}[];
+export declare function fontFamily(key?: string): string;
+export declare function formatPrice(value: any): string;
+export interface ItemDataOptions {
+    priceType?: string;
+    limits?: {
+        itemName?: number;
+        brand?: number;
+    };
+    storeName?: string;
+    date?: Date;
+}
+/**
+ * Label fields from an item record: `posdecs`/`item_name`, `price`, `surcharge_amount`, `brand`, `size_unit`,
+ * `re_order`, `upc` (string or list), `department`, `vendor`.
+ */
+export declare function labelDataFromItem(item: any, opts?: ItemDataOptions): LabelData;
+export declare function templateData(item: any, design: LabelDesign, storeName?: string, date?: Date): LabelData;
+export declare function sampleData(): LabelData;
+export declare function fieldValue(data: LabelData, key: string): any;
+export declare function resolveValue(template: string | undefined, data: LabelData): string;
+export declare function boundFields(template: string | undefined): string[];
+export declare function isVisible(el: LabelElement, data: LabelData): boolean;
+export declare function fieldsUsed(design: LabelDesign): string[];

package/dist/label-design/fields.js

@@ -0,0 +1,115 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FONTS = exports.FIELDS = void 0;
+exports.fontFamily = fontFamily;
+exports.formatPrice = formatPrice;
+exports.labelDataFromItem = labelDataFromItem;
+exports.templateData = templateData;
+exports.sampleData = sampleData;
+exports.fieldValue = fieldValue;
+exports.resolveValue = resolveValue;
+exports.boundFields = boundFields;
+exports.isVisible = isVisible;
+exports.fieldsUsed = fieldsUsed;
+exports.FIELDS = [
+    { key: 'itemName', label: 'Description', icon: 'text', sample: 'BUDWEISER 12PK 12OZ CAN' },
+    { key: 'price', label: 'Price', icon: 'dollar', sample: '$15.99' },
+    { key: 'cashPrice', label: 'Cash price', icon: 'dollar', sample: '$15.99' },
+    { key: 'creditPrice', label: 'Credit price', icon: 'dollar', sample: '$16.55' },
+    { key: 'unit', label: 'Size / unit', icon: 'box', sample: '12 PK' },
+    { key: 'brand', label: 'Brand', icon: 'store', sample: 'ANHEUSER-BUSCH' },
+    { key: 'department', label: 'Department', icon: 'layers', sample: 'BEER' },
+    { key: 'vendor', label: 'Vendor', icon: 'truck', sample: 'SOUTHERN GLAZER' },
+    { key: 'reorderId', label: 'Reorder #', icon: 'hash', sample: '100482' },
+    { key: 'barcode', label: 'UPC', icon: 'barcode', sample: '018200007712' },
+    { key: 'printDate', label: 'Print date', icon: 'calendar', sample: '10/14/2026' },
+    { key: 'storeName', label: 'Store name', icon: 'store', sample: 'Main Street Market' }
+];
+exports.FONTS = [
+    { key: 'sans', label: 'Sans', family: '"Arimo", Arial, Helvetica, sans-serif' },
+    { key: 'condensed', label: 'Condensed', family: '"Archivo Narrow", "Arial Narrow", sans-serif' },
+    { key: 'display', label: 'Display', family: '"Oswald", "Arial Narrow", sans-serif' },
+    { key: 'serif', label: 'Serif', family: '"Roboto Slab", Georgia, serif' },
+    { key: 'printer', label: 'Printer font', family: '"Arimo", Arial, Helvetica, sans-serif' }
+];
+function fontFamily(key) {
+    const f = exports.FONTS.find((x) => x.key === key);
+    return (f || exports.FONTS[0]).family;
+}
+function formatPrice(value) {
+    if (value === undefined || value === null || String(value).trim() === '')
+        return `$${value}`;
+    const amount = Number(value);
+    return Number.isFinite(amount) ? `$${amount.toFixed(2)}` : `$${value}`;
+}
+function trimTo(value, max) {
+    if (typeof value !== 'string')
+        return value;
+    return value.length > max ? value.substring(0, max) : value;
+}
+function padUpc(raw) {
+    if (raw === undefined || raw === null)
+        return raw;
+    const s = String(raw).trim();
+    if (s === '' || s.length >= 12)
+        return s;
+    return s.padStart(12, '0');
+}
+/**
+ * Label fields from an item record: `posdecs`/`item_name`, `price`, `surcharge_amount`, `brand`, `size_unit`,
+ * `re_order`, `upc` (string or list), `department`, `vendor`.
+ */
+function labelDataFromItem(item, opts = {}) {
+    const limits = { itemName: Infinity, brand: Infinity, ...(opts.limits || {}) };
+    const brandRaw = item.brand && item.brand != '' ? item.brand : '--';
+    const price = formatPrice(item.price);
+    const creditPrice = formatPrice(item.surcharge_amount);
+    const upc = Array.isArray(item.upc) ? item.upc[0] : item.upc;
+    return {
+        itemName: trimTo(item.posdecs && item.posdecs.length ? item.posdecs : item.item_name, limits.itemName),
+        brand: limits.brand > 0 ? trimTo(brandRaw, limits.brand) : '',
+        unit: item.size_unit && item.size_unit != '' ? item.size_unit : '--',
+        reorderId: item.re_order && item.re_order != '' ? item.re_order : '--',
+        barcode: padUpc(upc),
+        price: opts.priceType === 'credit' ? creditPrice : price,
+        cashPrice: price,
+        creditPrice,
+        department: item.department || '',
+        vendor: item.vendor || '',
+        printDate: (opts.date || new Date()).toLocaleDateString('en-US'),
+        storeName: opts.storeName || ''
+    };
+}
+function templateData(item, design, storeName, date) {
+    return labelDataFromItem(item, { priceType: 'single', limits: design && design.limits, storeName, date });
+}
+function sampleData() {
+    const d = {};
+    exports.FIELDS.forEach((f) => (d[f.key] = f.sample));
+    return d;
+}
+function fieldValue(data, key) {
+    const v = data[key];
+    return v === undefined || v === null ? '' : v;
+}
+function resolveValue(template, data) {
+    return String(template || '').replace(/\{\{(\w+)\}\}/g, (m, key) => String(fieldValue(data, key)));
+}
+function boundFields(template) {
+    return (String(template || '').match(/\{\{(\w+)\}\}/g) || []).map((m) => m.slice(2, -2));
+}
+function isVisible(el, data) {
+    if (!el.when)
+        return true;
+    const v = data[el.when];
+    return !(v === undefined || v === null || v === '' || v === false || v === '--');
+}
+function fieldsUsed(design) {
+    const used = new Set();
+    for (const el of design.elements || []) {
+        boundFields(el.value).forEach((f) => used.add(f));
+        if (el.when)
+            used.add(el.when);
+    }
+    return Array.from(used);
+}

package/dist/label-design/fonts.d.ts

@@ -0,0 +1,6 @@
+export declare const LABEL_FONT_FILES: [family: string, file: string, weight: string, style: string][];
+/**
+ * Loads the bundled label fonts in a browser from `baseUrl` (where the app serves
+ * `retail-print-kit/dist/label-fonts/`). Missing fonts fall back to the system font; outside a browser it does nothing.
+ */
+export declare function ensureLabelFonts(baseUrl?: string): Promise<void>;

package/dist/label-design/fonts.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LABEL_FONT_FILES = void 0;
+exports.ensureLabelFonts = ensureLabelFonts;
+exports.LABEL_FONT_FILES = [
+    ['Arimo', 'arimo-400.woff2', '400', 'normal'],
+    ['Arimo', 'arimo-700.woff2', '700', 'normal'],
+    ['Arimo', 'arimo-400-italic.woff2', '400', 'italic'],
+    ['Archivo Narrow', 'archivo-narrow-400.woff2', '400', 'normal'],
+    ['Archivo Narrow', 'archivo-narrow-700.woff2', '700', 'normal'],
+    ['Oswald', 'oswald-500.woff2', '500', 'normal'],
+    ['Oswald', 'oswald-700.woff2', '700', 'normal'],
+    ['Roboto Slab', 'roboto-slab-400.woff2', '400', 'normal'],
+    ['Roboto Slab', 'roboto-slab-700.woff2', '700', 'normal']
+];
+const loading = new Map();
+/**
+ * Loads the bundled label fonts in a browser from `baseUrl` (where the app serves
+ * `retail-print-kit/dist/label-fonts/`). Missing fonts fall back to the system font; outside a browser it does nothing.
+ */
+function ensureLabelFonts(baseUrl = 'assets/label-fonts/') {
+    const g = globalThis;
+    if (typeof g.FontFace !== 'function' || !g.document || !g.document.fonts)
+        return Promise.resolve();
+    const base = baseUrl.endsWith('/') ? baseUrl : `${baseUrl}/`;
+    const hit = loading.get(base);
+    if (hit)
+        return hit;
+    const ready = Promise.all(exports.LABEL_FONT_FILES.map(([family, file, weight, style]) => {
+        const face = new g.FontFace(family, `url(${base}${file})`, { weight, style });
+        return face.load().then((loaded) => { g.document.fonts.add(loaded); }, () => undefined);
+    })).then(() => undefined);
+    loading.set(base, ready);
+    return ready;
+}

package/dist/label-design/image.d.ts

@@ -0,0 +1,4 @@
+import { DesignImage } from './types';
+export declare function decodeImageBits(image: any): Uint8Array | null;
+/** RGBA pixels to a design image, transparent pixels as white; `dither` for photos, `threshold` for logos. */
+export declare function imageFromRgba(rgba: Uint8ClampedArray | Uint8Array, w: number, h: number, mode: 'dither' | 'threshold'): DesignImage;

package/dist/label-design/image.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.decodeImageBits = decodeImageBits;
+exports.imageFromRgba = imageFromRgba;
+const base64_1 = require("../util/base64");
+const validate_1 = require("./validate");
+function decodeImageBits(image) {
+    if (!image || !Number.isInteger(image.w) || !Number.isInteger(image.h) || image.w < 1 || image.h < 1)
+        return null;
+    if (image.w > validate_1.DESIGN_LIMITS.imageMaxDots || image.h > validate_1.DESIGN_LIMITS.imageMaxDots || typeof image.bits !== 'string')
+        return null;
+    if (!/^[A-Za-z0-9+/]*={0,2}$/.test(image.bits) || image.bits.length % 4 !== 0)
+        return null;
+    const raw = (0, base64_1.fromBase64)(image.bits);
+    return raw.length === Math.ceil(image.w / 8) * image.h ? raw : null;
+}
+/** RGBA pixels to a design image, transparent pixels as white; `dither` for photos, `threshold` for logos. */
+function imageFromRgba(rgba, w, h, mode) {
+    const lum = new Float32Array(w * h);
+    for (let i = 0; i < w * h; i++) {
+        const a = rgba[i * 4 + 3] / 255;
+        lum[i] = (rgba[i * 4] * 0.299 + rgba[i * 4 + 1] * 0.587 + rgba[i * 4 + 2] * 0.114) * a + 255 * (1 - a);
+    }
+    const rowBytes = Math.ceil(w / 8);
+    const bytes = new Uint8Array(rowBytes * h);
+    for (let y = 0; y < h; y++) {
+        for (let x = 0; x < w; x++) {
+            const i = y * w + x;
+            const old = lum[i];
+            const black = old < 128;
+            if (black)
+                bytes[y * rowBytes + (x >> 3)] |= 0x80 >> (x & 7);
+            if (mode === 'dither') {
+                const err = old - (black ? 0 : 255);
+                if (x + 1 < w)
+                    lum[i + 1] += (err * 7) / 16;
+                if (y + 1 < h) {
+                    if (x > 0)
+                        lum[i + w - 1] += (err * 3) / 16;
+                    lum[i + w] += (err * 5) / 16;
+                    if (x + 1 < w)
+                        lum[i + w + 1] += err / 16;
+                }
+            }
+        }
+    }
+    return { w, h, bits: (0, base64_1.toBase64)(bytes) };
+}

package/dist/label-design/index.d.ts

@@ -0,0 +1,12 @@
+export * from './types';
+export { MM_PER_INCH, PT_PER_INCH, mmToDots, dotsToMm, snapToDot } from './units';
+export { FIELDS, FONTS, fontFamily, formatPrice, labelDataFromItem, templateData, sampleData, fieldValue, resolveValue, boundFields, isVisible, fieldsUsed } from './fields';
+export type { ItemDataOptions } from './fields';
+export { DESIGN_LIMITS, validateDesign, elementError, imageError } from './validate';
+export { decodeImageBits, imageFromRgba } from './image';
+export { cleanForPrinter, fitText } from './printer-text';
+export { languageForPrinter, ezplHeader, encodeDesignLabel } from './encode';
+export { BUILTIN_TEMPLATES, normalizeSize, findBuiltinTemplate, encodeBuiltinLabel, designFromBuiltin, blankDesign, scaleDesign, newId } from './builtins';
+export { domCanvasFactory, drawLabel, drawPrinterView, createRasterizer, barcodeProblem, barcodeWidthMm, imageFromSource } from './render';
+export type { CanvasLike, CanvasFactory, DrawOptions } from './render';
+export { LABEL_FONT_FILES, ensureLabelFonts } from './fonts';

package/dist/label-design/index.js

@@ -0,0 +1,72 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ensureLabelFonts = exports.LABEL_FONT_FILES = exports.imageFromSource = exports.barcodeWidthMm = exports.barcodeProblem = exports.createRasterizer = exports.drawPrinterView = exports.drawLabel = exports.domCanvasFactory = exports.newId = exports.scaleDesign = exports.blankDesign = exports.designFromBuiltin = exports.encodeBuiltinLabel = exports.findBuiltinTemplate = exports.normalizeSize = exports.BUILTIN_TEMPLATES = exports.encodeDesignLabel = exports.ezplHeader = exports.languageForPrinter = exports.fitText = exports.cleanForPrinter = exports.imageFromRgba = exports.decodeImageBits = exports.imageError = exports.elementError = exports.validateDesign = exports.DESIGN_LIMITS = exports.fieldsUsed = exports.isVisible = exports.boundFields = exports.resolveValue = exports.fieldValue = exports.sampleData = exports.templateData = exports.labelDataFromItem = exports.formatPrice = exports.fontFamily = exports.FONTS = exports.FIELDS = exports.snapToDot = exports.dotsToMm = exports.mmToDots = exports.PT_PER_INCH = exports.MM_PER_INCH = void 0;
+__exportStar(require("./types"), exports);
+var units_1 = require("./units");
+Object.defineProperty(exports, "MM_PER_INCH", { enumerable: true, get: function () { return units_1.MM_PER_INCH; } });
+Object.defineProperty(exports, "PT_PER_INCH", { enumerable: true, get: function () { return units_1.PT_PER_INCH; } });
+Object.defineProperty(exports, "mmToDots", { enumerable: true, get: function () { return units_1.mmToDots; } });
+Object.defineProperty(exports, "dotsToMm", { enumerable: true, get: function () { return units_1.dotsToMm; } });
+Object.defineProperty(exports, "snapToDot", { enumerable: true, get: function () { return units_1.snapToDot; } });
+var fields_1 = require("./fields");
+Object.defineProperty(exports, "FIELDS", { enumerable: true, get: function () { return fields_1.FIELDS; } });
+Object.defineProperty(exports, "FONTS", { enumerable: true, get: function () { return fields_1.FONTS; } });
+Object.defineProperty(exports, "fontFamily", { enumerable: true, get: function () { return fields_1.fontFamily; } });
+Object.defineProperty(exports, "formatPrice", { enumerable: true, get: function () { return fields_1.formatPrice; } });
+Object.defineProperty(exports, "labelDataFromItem", { enumerable: true, get: function () { return fields_1.labelDataFromItem; } });
+Object.defineProperty(exports, "templateData", { enumerable: true, get: function () { return fields_1.templateData; } });
+Object.defineProperty(exports, "sampleData", { enumerable: true, get: function () { return fields_1.sampleData; } });
+Object.defineProperty(exports, "fieldValue", { enumerable: true, get: function () { return fields_1.fieldValue; } });
+Object.defineProperty(exports, "resolveValue", { enumerable: true, get: function () { return fields_1.resolveValue; } });
+Object.defineProperty(exports, "boundFields", { enumerable: true, get: function () { return fields_1.boundFields; } });
+Object.defineProperty(exports, "isVisible", { enumerable: true, get: function () { return fields_1.isVisible; } });
+Object.defineProperty(exports, "fieldsUsed", { enumerable: true, get: function () { return fields_1.fieldsUsed; } });
+var validate_1 = require("./validate");
+Object.defineProperty(exports, "DESIGN_LIMITS", { enumerable: true, get: function () { return validate_1.DESIGN_LIMITS; } });
+Object.defineProperty(exports, "validateDesign", { enumerable: true, get: function () { return validate_1.validateDesign; } });
+Object.defineProperty(exports, "elementError", { enumerable: true, get: function () { return validate_1.elementError; } });
+Object.defineProperty(exports, "imageError", { enumerable: true, get: function () { return validate_1.imageError; } });
+var image_1 = require("./image");
+Object.defineProperty(exports, "decodeImageBits", { enumerable: true, get: function () { return image_1.decodeImageBits; } });
+Object.defineProperty(exports, "imageFromRgba", { enumerable: true, get: function () { return image_1.imageFromRgba; } });
+var printer_text_1 = require("./printer-text");
+Object.defineProperty(exports, "cleanForPrinter", { enumerable: true, get: function () { return printer_text_1.cleanForPrinter; } });
+Object.defineProperty(exports, "fitText", { enumerable: true, get: function () { return printer_text_1.fitText; } });
+var encode_1 = require("./encode");
+Object.defineProperty(exports, "languageForPrinter", { enumerable: true, get: function () { return encode_1.languageForPrinter; } });
+Object.defineProperty(exports, "ezplHeader", { enumerable: true, get: function () { return encode_1.ezplHeader; } });
+Object.defineProperty(exports, "encodeDesignLabel", { enumerable: true, get: function () { return encode_1.encodeDesignLabel; } });
+var builtins_1 = require("./builtins");
+Object.defineProperty(exports, "BUILTIN_TEMPLATES", { enumerable: true, get: function () { return builtins_1.BUILTIN_TEMPLATES; } });
+Object.defineProperty(exports, "normalizeSize", { enumerable: true, get: function () { return builtins_1.normalizeSize; } });
+Object.defineProperty(exports, "findBuiltinTemplate", { enumerable: true, get: function () { return builtins_1.findBuiltinTemplate; } });
+Object.defineProperty(exports, "encodeBuiltinLabel", { enumerable: true, get: function () { return builtins_1.encodeBuiltinLabel; } });
+Object.defineProperty(exports, "designFromBuiltin", { enumerable: true, get: function () { return builtins_1.designFromBuiltin; } });
+Object.defineProperty(exports, "blankDesign", { enumerable: true, get: function () { return builtins_1.blankDesign; } });
+Object.defineProperty(exports, "scaleDesign", { enumerable: true, get: function () { return builtins_1.scaleDesign; } });
+Object.defineProperty(exports, "newId", { enumerable: true, get: function () { return builtins_1.newId; } });
+var render_1 = require("./render");
+Object.defineProperty(exports, "domCanvasFactory", { enumerable: true, get: function () { return render_1.domCanvasFactory; } });
+Object.defineProperty(exports, "drawLabel", { enumerable: true, get: function () { return render_1.drawLabel; } });
+Object.defineProperty(exports, "drawPrinterView", { enumerable: true, get: function () { return render_1.drawPrinterView; } });
+Object.defineProperty(exports, "createRasterizer", { enumerable: true, get: function () { return render_1.createRasterizer; } });
+Object.defineProperty(exports, "barcodeProblem", { enumerable: true, get: function () { return render_1.barcodeProblem; } });
+Object.defineProperty(exports, "barcodeWidthMm", { enumerable: true, get: function () { return render_1.barcodeWidthMm; } });
+Object.defineProperty(exports, "imageFromSource", { enumerable: true, get: function () { return render_1.imageFromSource; } });
+var fonts_1 = require("./fonts");
+Object.defineProperty(exports, "LABEL_FONT_FILES", { enumerable: true, get: function () { return fonts_1.LABEL_FONT_FILES; } });
+Object.defineProperty(exports, "ensureLabelFonts", { enumerable: true, get: function () { return fonts_1.ensureLabelFonts; } });