retail-print-kit 0.0.0-stage → 0.2.0

package/dist/label/builder.d.ts

@@ -0,0 +1,39 @@
+import { BarcodeType } from '../core/ops';
+import { Bitmap } from '../core/bitmap';
+import { Label, LabelOp, Rotation } from './types';
+export interface LabelSize {
+    /** Width and height in millimetres. */
+    widthMm: number;
+    heightMm: number;
+    dpi?: 203 | 300 | 600;
+    gapMm?: number;
+}
+/** Records label elements in dots; `mm()` converts millimetres at the label's dpi. */
+export declare class LabelBuilder {
+    readonly label: Label;
+    constructor(size: LabelSize);
+    mm(mm: number): number;
+    copies(n: number): this;
+    darkness(n: number): this;
+    speed(ips: number): this;
+    push(op: LabelOp): this;
+    text(x: number, y: number, text: string, height: number, opts?: {
+        width?: number;
+        rotation?: Rotation;
+        bold?: boolean;
+        invert?: boolean;
+    }): this;
+    barcode(x: number, y: number, data: string, type: BarcodeType, height: number, opts?: {
+        module?: number;
+        rotation?: Rotation;
+        text?: boolean;
+    }): this;
+    qr(x: number, y: number, data: string, opts?: {
+        module?: number;
+        correction?: 'L' | 'M' | 'Q' | 'H';
+        rotation?: Rotation;
+    }): this;
+    box(x: number, y: number, width: number, height: number, thickness?: number): this;
+    rect(x: number, y: number, width: number, height: number): this;
+    image(x: number, y: number, bitmap: Bitmap): this;
+}

package/dist/label/builder.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LabelBuilder = void 0;
+const types_1 = require("./types");
+/** Records label elements in dots; `mm()` converts millimetres at the label's dpi. */
+class LabelBuilder {
+    constructor(size) {
+        const dpi = size.dpi ?? 203;
+        this.label = { width: (0, types_1.mmToDots)(size.widthMm, dpi), height: (0, types_1.mmToDots)(size.heightMm, dpi), dpi, gap: size.gapMm ?? 3, copies: 1, ops: [] };
+    }
+    mm(mm) {
+        return (0, types_1.mmToDots)(mm, this.label.dpi);
+    }
+    copies(n) { this.label.copies = Math.max(1, Math.floor(n)); return this; }
+    darkness(n) { this.label.darkness = n; return this; }
+    speed(ips) { this.label.speed = ips; return this; }
+    push(op) { this.label.ops.push(op); return this; }
+    text(x, y, text, height, opts = {}) {
+        return this.push({ kind: 'text', x, y, text, height, ...opts });
+    }
+    barcode(x, y, data, type, height, opts = {}) {
+        return this.push({ kind: 'barcode', x, y, data, type, height, ...opts });
+    }
+    qr(x, y, data, opts = {}) {
+        return this.push({ kind: 'qr', x, y, data, ...opts });
+    }
+    box(x, y, width, height, thickness = 2) {
+        return this.push({ kind: 'box', x, y, width, height, thickness });
+    }
+    rect(x, y, width, height) {
+        return this.push({ kind: 'rect', x, y, width, height });
+    }
+    image(x, y, bitmap) {
+        return this.push({ kind: 'image', x, y, bitmap });
+    }
+}
+exports.LabelBuilder = LabelBuilder;

package/dist/label/ezpl.d.ts

@@ -0,0 +1,6 @@
+import { Label } from './types';
+/**
+ * Godex EZPL. The header and text/barcode shapes match the field format the POS sends to Godex
+ * units (^Q/^W/^H/^P/^S/^L ... E). Text uses internal fonts chosen by height.
+ */
+export declare function encodeEzpl(label: Label): string;

package/dist/label/ezpl.js

@@ -0,0 +1,78 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.encodeEzpl = encodeEzpl;
+const types_1 = require("./types");
+/**
+ * Godex internal fonts by approximate cap height in dots at 203 dpi. Used when a text op does not
+ * name a font; sizes between entries round down. Approximate: check against a printed sample.
+ */
+const FONTS = [['A', 12], ['B', 16], ['C', 20], ['D', 24], ['E', 32], ['F', 40], ['G', 48], ['H', 64]];
+/** Godex barcode letters; H (UPC-A) is field-proven, the rest follow the EZPL manual. */
+const BARCODE = {
+    CODE39: 'A', CODE128: 'C', EAN13: 'E', EAN8: 'F', UPC_E: 'G', UPC_A: 'H', ITF: 'I', CODABAR: 'J',
+};
+function fontFor(height) {
+    let font = FONTS[0][0];
+    let size = FONTS[0][1];
+    for (const [f, h] of FONTS)
+        if (h <= height) {
+            font = f;
+            size = h;
+        }
+    const mul = Math.max(1, Math.min(9, Math.floor(height / size)));
+    return { font, mul };
+}
+function op(o) {
+    const x = Math.round(o.x);
+    const y = Math.round(o.y);
+    const rot = o.rotation ?? 0;
+    switch (o.kind) {
+        case 'text': {
+            const { font, mul } = fontFor(o.height);
+            return `A${font},${x},${y},${mul},${mul},${rot / 90},0${o.invert ? 'R' : 'E'},${o.text}`;
+        }
+        case 'barcode': {
+            const code = BARCODE[o.type];
+            if (!code)
+                throw new Error(`retail-print-kit: EZPL has no ${o.type}`);
+            const narrow = o.module ?? 2;
+            return `B${code},${x},${y},${narrow},${narrow * 2},${Math.round(o.height)},${rot / 90},${o.text === false ? 0 : 1},${o.data}`;
+        }
+        case 'qr': {
+            const ec = { L: 'L', M: 'M', Q: 'Q', H: 'H' }[o.correction ?? 'M'];
+            return `W${x},${y},5,2,${ec},${o.module ?? 4},${rot / 90},${o.data.length}\n${o.data}`;
+        }
+        case 'box':
+            return `R${x},${y},${x + Math.round(o.width)},${y + Math.round(o.height)},${o.thickness ?? 2},${o.thickness ?? 2}`;
+        case 'rect':
+            return `R${x},${y},${x + Math.round(o.width)},${y + Math.round(o.height)},${Math.round(o.width)},${Math.round(o.height)}`;
+        case 'image':
+            throw new Error('retail-print-kit: EZPL images are not implemented yet');
+    }
+}
+/**
+ * Godex EZPL. The header and text/barcode shapes match the field format the POS sends to Godex
+ * units (^Q/^W/^H/^P/^S/^L ... E). Text uses internal fonts chosen by height.
+ */
+function encodeEzpl(label) {
+    const lines = [
+        `^Q${(0, types_1.dotsToMm)(label.height, label.dpi).toFixed(2)},${label.gap.toFixed(0)}`,
+        `^W${(0, types_1.dotsToMm)(label.width, label.dpi).toFixed(2)}`,
+        `^H${label.darkness ?? 10}`,
+        `^P${label.copies}`,
+        `^S${label.speed ?? 2}`,
+        '^AD',
+        '^C1',
+        '^R0',
+        '~Q+0',
+        '^O0',
+        '^D0',
+        '^E18',
+        '~R255',
+        '^L',
+    ];
+    for (const o of label.ops)
+        lines.push(op(o));
+    lines.push('E');
+    return lines.join('\n') + '\n';
+}

package/dist/label/index.d.ts

@@ -0,0 +1,12 @@
+import { Label, LabelLanguage } from './types';
+export * from './types';
+export { LabelBuilder } from './builder';
+export type { LabelSize } from './builder';
+export { encodeZpl } from './zpl';
+export { encodeTspl } from './tspl';
+export { encodeEzpl } from './ezpl';
+export { labelToSvg } from './svg';
+export { renderLabel } from './template';
+export type { LabelTemplate, LabelElement } from './template';
+/** Bytes for the label in the given language; ZPL and EZPL are plain text, TSPL may carry binary images. */
+export declare function encodeLabel(label: Label, language: LabelLanguage): Uint8Array;

package/dist/label/index.js

@@ -0,0 +1,42 @@
+"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.renderLabel = exports.labelToSvg = exports.encodeEzpl = exports.encodeTspl = exports.encodeZpl = exports.LabelBuilder = void 0;
+exports.encodeLabel = encodeLabel;
+const zpl_1 = require("./zpl");
+const tspl_1 = require("./tspl");
+const ezpl_1 = require("./ezpl");
+__exportStar(require("./types"), exports);
+var builder_1 = require("./builder");
+Object.defineProperty(exports, "LabelBuilder", { enumerable: true, get: function () { return builder_1.LabelBuilder; } });
+var zpl_2 = require("./zpl");
+Object.defineProperty(exports, "encodeZpl", { enumerable: true, get: function () { return zpl_2.encodeZpl; } });
+var tspl_2 = require("./tspl");
+Object.defineProperty(exports, "encodeTspl", { enumerable: true, get: function () { return tspl_2.encodeTspl; } });
+var ezpl_2 = require("./ezpl");
+Object.defineProperty(exports, "encodeEzpl", { enumerable: true, get: function () { return ezpl_2.encodeEzpl; } });
+var svg_1 = require("./svg");
+Object.defineProperty(exports, "labelToSvg", { enumerable: true, get: function () { return svg_1.labelToSvg; } });
+var template_1 = require("./template");
+Object.defineProperty(exports, "renderLabel", { enumerable: true, get: function () { return template_1.renderLabel; } });
+/** Bytes for the label in the given language; ZPL and EZPL are plain text, TSPL may carry binary images. */
+function encodeLabel(label, language) {
+    switch (language) {
+        case 'zpl': return new TextEncoder().encode((0, zpl_1.encodeZpl)(label));
+        case 'ezpl': return new TextEncoder().encode((0, ezpl_1.encodeEzpl)(label));
+        case 'tspl': return (0, tspl_1.encodeTspl)(label);
+    }
+}

package/dist/label/svg.d.ts

@@ -0,0 +1,3 @@
+import { Label } from './types';
+/** SVG of the label at 1 unit per dot; `viewBox` is the label size so it scales anywhere. */
+export declare function labelToSvg(label: Label): string;

package/dist/label/svg.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.labelToSvg = labelToSvg;
+const barcode1d_1 = require("../core/barcode1d");
+const bitmap_1 = require("../core/bitmap");
+const png_1 = require("../preview/png");
+const base64_1 = require("../util/base64");
+function esc(s) {
+    return s.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;');
+}
+function rotate(o) {
+    return o.rotation ? ` transform="rotate(${o.rotation} ${o.x} ${o.y})"` : '';
+}
+function png(b) {
+    return `data:image/png;base64,${(0, base64_1.toBase64)((0, png_1.bitmapToPng)(b))}`;
+}
+function op(o) {
+    switch (o.kind) {
+        case 'text': {
+            const w = o.width ?? o.height * 0.9;
+            const len = o.text.length * w * 0.62;
+            const bg = o.invert ? `<rect x="${o.x}" y="${o.y}" width="${len}" height="${o.height}" fill="#000"/>` : '';
+            return `${bg}<text x="${o.x}" y="${o.y + o.height * 0.82}" font-size="${o.height}" textLength="${len}" lengthAdjust="spacingAndGlyphs" font-family="Helvetica, Arial, sans-serif"${o.bold ? ' font-weight="bold"' : ''} fill="${o.invert ? '#fff' : '#000'}"${rotate(o)}>${esc(o.text)}</text>`;
+        }
+        case 'barcode': {
+            const b = (0, barcode1d_1.barcodeBitmap)(o.type, o.data, o.module ?? 2, Math.round(o.height));
+            const hri = o.text === false ? '' : `<text x="${o.x + b.width / 2}" y="${o.y + o.height + 14}" font-size="14" text-anchor="middle" font-family="Helvetica, Arial, sans-serif">${esc(o.data)}</text>`;
+            return `<image x="${o.x}" y="${o.y}" width="${b.width}" height="${b.height}" href="${png(b)}" style="image-rendering:pixelated"${rotate(o)}/>${hri}`;
+        }
+        case 'qr': {
+            const b = (0, bitmap_1.qrBitmap)(o.data, { size: o.module ?? 4, correction: o.correction });
+            return `<image x="${o.x}" y="${o.y}" width="${b.width}" height="${b.height}" href="${png(b)}" style="image-rendering:pixelated"${rotate(o)}/>`;
+        }
+        case 'box':
+            return `<rect x="${o.x}" y="${o.y}" width="${o.width}" height="${o.height}" fill="none" stroke="#000" stroke-width="${o.thickness ?? 2}"/>`;
+        case 'rect':
+            return `<rect x="${o.x}" y="${o.y}" width="${o.width}" height="${o.height}" fill="#000"/>`;
+        case 'image':
+            return `<image x="${o.x}" y="${o.y}" width="${o.bitmap.width}" height="${o.bitmap.height}" href="${png(o.bitmap)}" style="image-rendering:pixelated"/>`;
+    }
+}
+/** SVG of the label at 1 unit per dot; `viewBox` is the label size so it scales anywhere. */
+function labelToSvg(label) {
+    const body = label.ops.map(op).join('');
+    return `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 ${label.width} ${label.height}" width="${label.width}" height="${label.height}"><rect width="${label.width}" height="${label.height}" fill="#fff"/>${body}</svg>`;
+}

package/dist/label/template.d.ts

@@ -0,0 +1,61 @@
+import { BarcodeType } from '../core/ops';
+import { Label, Rotation } from './types';
+export type LabelElement = {
+    type: 'text';
+    x: number;
+    y: number;
+    value: string;
+    height: number;
+    width?: number;
+    rotation?: Rotation;
+    bold?: boolean;
+    invert?: boolean;
+    when?: string;
+} | {
+    type: 'barcode';
+    x: number;
+    y: number;
+    value: string;
+    format?: BarcodeType;
+    height: number;
+    module?: number;
+    rotation?: Rotation;
+    text?: boolean;
+    when?: string;
+} | {
+    type: 'qr';
+    x: number;
+    y: number;
+    value: string;
+    module?: number;
+    correction?: 'L' | 'M' | 'Q' | 'H';
+    rotation?: Rotation;
+    when?: string;
+} | {
+    type: 'box';
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    thickness?: number;
+    when?: string;
+} | {
+    type: 'rect';
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    when?: string;
+};
+/** A label layout: positions in dots at `dpi`, values are `{{path | filter}}` strings. */
+export interface LabelTemplate {
+    name: string;
+    version: 1;
+    kind: 'label';
+    widthMm: number;
+    heightMm: number;
+    dpi?: 203 | 300 | 600;
+    gapMm?: number;
+    elements: LabelElement[];
+}
+export declare function renderLabel(template: LabelTemplate, data: unknown): Label;

package/dist/label/template.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderLabel = renderLabel;
+const builder_1 = require("./builder");
+const expr_1 = require("../template/expr");
+function renderLabel(template, data) {
+    if (template.version !== 1 || template.kind !== 'label')
+        throw new Error('retail-print-kit: not a version 1 label template');
+    const b = new builder_1.LabelBuilder({ widthMm: template.widthMm, heightMm: template.heightMm, dpi: template.dpi, gapMm: template.gapMm });
+    const scope = { root: data, current: data };
+    for (const e of template.elements) {
+        if (e.when && !(0, expr_1.truthy)(e.when, scope))
+            continue;
+        switch (e.type) {
+            case 'text':
+                b.text(e.x, e.y, (0, expr_1.interpolate)(e.value, scope), e.height, { width: e.width, rotation: e.rotation, bold: e.bold, invert: e.invert });
+                break;
+            case 'barcode':
+                b.barcode(e.x, e.y, (0, expr_1.interpolate)(e.value, scope), e.format ?? 'CODE128', e.height, { module: e.module, rotation: e.rotation, text: e.text });
+                break;
+            case 'qr':
+                b.qr(e.x, e.y, (0, expr_1.interpolate)(e.value, scope), { module: e.module, correction: e.correction, rotation: e.rotation });
+                break;
+            case 'box':
+                b.box(e.x, e.y, e.width, e.height, e.thickness);
+                break;
+            case 'rect':
+                b.rect(e.x, e.y, e.width, e.height);
+                break;
+        }
+    }
+    return b.label;
+}

package/dist/label/tspl.d.ts

@@ -0,0 +1,3 @@
+import { Label } from './types';
+/** TSC / TSPL2 (TSC, Xprinter and Rongta label units). Images are binary, so the result is bytes. */
+export declare function encodeTspl(label: Label): Uint8Array;

package/dist/label/tspl.js

@@ -0,0 +1,83 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.encodeTspl = encodeTspl;
+const types_1 = require("./types");
+const BARCODE = {
+    CODE128: '128', EAN13: 'EAN13', EAN8: 'EAN8', UPC_A: 'UPCA', UPC_E: 'UPCE', CODE39: '39', ITF: 'ITF', CODABAR: 'CODA',
+};
+function q(text) {
+    return `"${text.replace(/"/g, '\\["]')}"`;
+}
+function mm(dots, dpi) {
+    return (0, types_1.dotsToMm)(dots, dpi).toFixed(2);
+}
+/** TSPL BITMAP data: 1 bits are white, so the bitmap is inverted. */
+function bitmapBytes(b) {
+    const out = new Uint8Array(b.bits.length);
+    for (let i = 0; i < b.bits.length; i++)
+        out[i] = ~b.bits[i] & 0xff;
+    return out;
+}
+function op(o, dpi) {
+    const x = Math.round(o.x);
+    const y = Math.round(o.y);
+    const rot = (r) => r ?? 0;
+    switch (o.kind) {
+        case 'text': {
+            const h = Math.round(o.height);
+            const w = Math.round(o.width ?? o.height * 0.9);
+            const line = `TEXT ${x},${y},"0",${rot(o.rotation)},${w},${h},${q(o.text)}`;
+            return o.invert ? `${line}\nREVERSE ${x},${y},${Math.round(w * o.text.length * 0.6)},${h}` : line;
+        }
+        case 'barcode': {
+            const code = BARCODE[o.type];
+            if (!code)
+                throw new Error(`retail-print-kit: TSPL has no ${o.type}`);
+            const narrow = o.module ?? 2;
+            return `BARCODE ${x},${y},"${code}",${Math.round(o.height)},${o.text === false ? 0 : 1},${rot(o.rotation)},${narrow},${narrow * 2},${q(o.data)}`;
+        }
+        case 'qr':
+            return `QRCODE ${x},${y},${o.correction ?? 'M'},${o.module ?? 4},A,${rot(o.rotation)},${q(o.data)}`;
+        case 'box':
+            return `BOX ${x},${y},${x + Math.round(o.width)},${y + Math.round(o.height)},${o.thickness ?? 2}`;
+        case 'rect':
+            return `BAR ${x},${y},${Math.round(o.width)},${Math.round(o.height)}`;
+        case 'image': {
+            const rowBytes = Math.ceil(o.bitmap.width / 8);
+            const head = `BITMAP ${x},${y},${rowBytes},${o.bitmap.height},0,`;
+            const bytes = bitmapBytes(o.bitmap);
+            const out = new Uint8Array(head.length + bytes.length + 1);
+            for (let i = 0; i < head.length; i++)
+                out[i] = head.charCodeAt(i);
+            out.set(bytes, head.length);
+            out[out.length - 1] = 0x0a;
+            return out;
+        }
+    }
+    void dpi;
+}
+/** TSC / TSPL2 (TSC, Xprinter and Rongta label units). Images are binary, so the result is bytes. */
+function encodeTspl(label) {
+    const parts = [
+        `SIZE ${mm(label.width, label.dpi)} mm,${mm(label.height, label.dpi)} mm`,
+        `GAP ${label.gap.toFixed(2)} mm,0 mm`,
+        'DIRECTION 1,0',
+        'REFERENCE 0,0',
+    ];
+    if (label.speed !== undefined)
+        parts.push(`SPEED ${label.speed}`);
+    if (label.darkness !== undefined)
+        parts.push(`DENSITY ${Math.round(label.darkness)}`);
+    parts.push('CLS');
+    for (const o of label.ops)
+        parts.push(op(o, label.dpi));
+    parts.push(`PRINT ${label.copies},1`);
+    const chunks = parts.map((p) => (typeof p === 'string' ? new TextEncoder().encode(p + '\n') : p));
+    const out = new Uint8Array(chunks.reduce((n, c) => n + c.length, 0));
+    let o = 0;
+    for (const c of chunks) {
+        out.set(c, o);
+        o += c.length;
+    }
+    return out;
+}

package/dist/label/types.d.ts

@@ -0,0 +1,69 @@
+import { BarcodeType } from '../core/ops';
+import { Bitmap } from '../core/bitmap';
+export type Rotation = 0 | 90 | 180 | 270;
+export type LabelLanguage = 'zpl' | 'tspl' | 'ezpl';
+/** Everything is in dots at the label's dpi; (0,0) is the top-left corner. */
+export type LabelOp = {
+    kind: 'text';
+    x: number;
+    y: number;
+    text: string;
+    height: number;
+    width?: number;
+    rotation?: Rotation;
+    bold?: boolean;
+    invert?: boolean;
+} | {
+    kind: 'barcode';
+    x: number;
+    y: number;
+    data: string;
+    type: BarcodeType;
+    height: number;
+    module?: number;
+    rotation?: Rotation;
+    text?: boolean;
+} | {
+    kind: 'qr';
+    x: number;
+    y: number;
+    data: string;
+    module?: number;
+    correction?: 'L' | 'M' | 'Q' | 'H';
+    rotation?: Rotation;
+} | {
+    kind: 'box';
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    thickness?: number;
+} | {
+    kind: 'rect';
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+} | {
+    kind: 'image';
+    x: number;
+    y: number;
+    bitmap: Bitmap;
+};
+export interface Label {
+    /** Dots across the label. */
+    width: number;
+    /** Dots down the label. */
+    height: number;
+    dpi: 203 | 300 | 600;
+    /** Gap between labels in millimetres (0 for continuous stock). */
+    gap: number;
+    copies: number;
+    /** Print darkness 0..15 where the language has it. */
+    darkness?: number;
+    /** Print speed in inches per second where the language has it. */
+    speed?: number;
+    ops: LabelOp[];
+}
+export declare function mmToDots(mm: number, dpi: number): number;
+export declare function dotsToMm(dots: number, dpi: number): number;

package/dist/label/types.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mmToDots = mmToDots;
+exports.dotsToMm = dotsToMm;
+function mmToDots(mm, dpi) {
+    return Math.round((mm / 25.4) * dpi);
+}
+function dotsToMm(dots, dpi) {
+    return (dots / dpi) * 25.4;
+}

package/dist/label/zpl.d.ts

@@ -0,0 +1,3 @@
+import { Label } from './types';
+/** Zebra ZPL II. Verified against the field format the POS sends to Zebra units (^A0N text, ^BUN barcodes). */
+export declare function encodeZpl(label: Label): string;

package/dist/label/zpl.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.encodeZpl = encodeZpl;
+const ROT = { 0: 'N', 90: 'R', 180: 'I', 270: 'B' };
+const BARCODE = {
+    CODE128: 'BC', EAN13: 'BE', EAN8: 'B8', UPC_A: 'BU', UPC_E: 'B9', CODE39: 'B3', ITF: 'B2', CODABAR: 'BK',
+};
+function fd(text) {
+    return text.replace(/[\^~\\]/g, (c) => `\\${c}`);
+}
+function hexRows(b) {
+    const rowBytes = Math.ceil(b.width / 8);
+    let out = '';
+    for (let i = 0; i < b.bits.length; i++)
+        out += b.bits[i].toString(16).padStart(2, '0').toUpperCase();
+    return `${rowBytes * b.height},${rowBytes * b.height},${rowBytes},${out}`;
+}
+function op(o) {
+    const at = `^FO${Math.round(o.x)},${Math.round(o.y)}`;
+    switch (o.kind) {
+        case 'text': {
+            const w = Math.round(o.width ?? o.height * 0.9);
+            const rev = o.invert ? '^FR' : '';
+            return `${at}${rev}^A0${ROT[o.rotation ?? 0]},${Math.round(o.height)},${w}^FD${fd(o.text)}^FS`;
+        }
+        case 'barcode': {
+            const code = BARCODE[o.type];
+            if (!code)
+                throw new Error(`retail-print-kit: ZPL has no ${o.type}`);
+            const hri = o.text === false ? 'N' : 'Y';
+            const extra = o.type === 'CODE128' ? `,${hri},N,N` : `,${hri},N`;
+            return `${at}^BY${o.module ?? 2},2,${Math.round(o.height)}^${code}${ROT[o.rotation ?? 0]},${Math.round(o.height)}${extra}^FD${fd(o.data)}^FS`;
+        }
+        case 'qr': {
+            const ec = o.correction ?? 'M';
+            return `${at}^BQ${ROT[o.rotation ?? 0]},2,${o.module ?? 4}^FD${ec}A,${fd(o.data)}^FS`;
+        }
+        case 'box':
+            return `${at}^GB${Math.round(o.width)},${Math.round(o.height)},${o.thickness ?? 2}^FS`;
+        case 'rect':
+            return `${at}^GB${Math.round(o.width)},${Math.round(o.height)},${Math.round(Math.min(o.width, o.height))}^FS`;
+        case 'image':
+            return `${at}^GFA,${hexRows(o.bitmap)}^FS`;
+    }
+}
+/** Zebra ZPL II. Verified against the field format the POS sends to Zebra units (^A0N text, ^BUN barcodes). */
+function encodeZpl(label) {
+    const lines = ['^XA', '^CI28', `^PW${label.width}`, `^LL${label.height}`, '^LH0,0'];
+    if (label.speed !== undefined)
+        lines.push(`^PR${Math.round(label.speed)}`);
+    if (label.darkness !== undefined)
+        lines.push(`^MD${Math.round(label.darkness * 2 - 15)}`);
+    for (const o of label.ops)
+        lines.push(op(o));
+    lines.push(`^PQ${label.copies},0,1,Y`, '^XZ');
+    return lines.join('\n') + '\n';
+}

package/dist/preview/html.d.ts

@@ -0,0 +1,14 @@
+import { Op } from '../core/ops';
+import { Profile } from '../profiles/types';
+export interface HtmlPreviewOptions {
+    /** Wrap in a full document with the receipt styles. Default true. */
+    document?: boolean;
+    /** CSS pixels per character cell of font A. Default 8. */
+    cellWidth?: number;
+}
+/**
+ * Paper-like HTML of the ops: monospaced lines at the profile's column count, with size, style,
+ * alignment and font honoured, and QR / barcodes / images inlined as PNG. Meant for on-screen
+ * preview and for a designer; not byte-exact with any printer.
+ */
+export declare function opsToHtml(ops: Op[], profile: Profile, options?: HtmlPreviewOptions): string;