portakal-lite 0.0.1

package/dist/raster.js

@@ -0,0 +1,204 @@
+/**
+ * Rasterization helpers — turn etiket's raw encodings into a 1-bit
+ * MonochromeBitmap that compilers emit as TSC BITMAP / ZPL ^GFA graphics.
+ *
+ * etiket raw encoders return:
+ *  - 1D:  `bars: number[]` — alternating bar/space widths in modules
+ *  - 2D:  `matrix: boolean[][]` — module grid
+ *  - postal: height-modulated bars (POSTNET/PLANET/RM4SCC/...)
+ *
+ * All content is rendered as pixels, so it is inherently injection-safe.
+ */
+import { InvalidConfigError } from "./errors.js";
+import { encodeBars } from "etiket/barcode";
+import { encodeQR } from "etiket/qr";
+import { encodeDataMatrix } from "etiket/datamatrix";
+import { encodePDF417 } from "etiket/pdf417";
+import { encodeAztec } from "etiket/aztec";
+/** Hard cap on rasterized dimensions (protects ZPL ^GFA 16-bit fields). */
+const MAX_RASTER_DOTS = 65535;
+/** Total raster bytes cap (DoS guard against huge matrices). */
+const MAX_RASTER_BYTES = 2000000;
+/**
+ * Rasterize a 1D bar pattern (`bars` = alternating bar/space module widths,
+ * starting with a bar) into a monochrome bitmap.
+ */
+export function rasterizeBars(bars, opts = {}) {
+    const moduleWidth = opts.moduleWidth ?? 2;
+    const height = opts.height ?? 80;
+    const rotation = opts.rotation ?? 0;
+    if (!Number.isInteger(moduleWidth) || moduleWidth < 1 || moduleWidth > 10) {
+        throw new InvalidConfigError("moduleWidth must be an integer between 1 and 10");
+    }
+    if (!Number.isInteger(height) || height < 1 || height > MAX_RASTER_DOTS) {
+        throw new InvalidConfigError(`height must be an integer between 1 and ${MAX_RASTER_DOTS}`);
+    }
+    if (![0, 90, 180, 270].includes(rotation)) {
+        throw new InvalidConfigError("rotation must be one of 0, 90, 180, 270");
+    }
+    let totalModules = 0;
+    for (const w of bars) {
+        if (!Number.isInteger(w) || w < 1) {
+            throw new InvalidConfigError(`invalid bar width ${String(w)}`);
+        }
+        totalModules += w;
+    }
+    const width = totalModules * moduleWidth;
+    // Fill the bitmap: bars (even indices) are black, spaces (odd) are white.
+    const raw = packRaster(width, height, (x) => {
+        let acc = 0;
+        let i = 0;
+        while (i < bars.length && acc <= x / moduleWidth) {
+            const span = bars[i];
+            if (acc <= x / moduleWidth && x / moduleWidth < acc + span) {
+                return i % 2 === 0;
+            }
+            acc += span;
+            i++;
+        }
+        return false;
+    });
+    return applyRotation(raw, rotation);
+}
+/**
+ * Rasterize a 2D module matrix into a monochrome bitmap.
+ * Each cell becomes `cellSize`×`cellSize` dots.
+ */
+export function rasterizeMatrix(matrix, opts = {}) {
+    const cellSize = opts.moduleWidth ?? 6;
+    const rotation = opts.rotation ?? 0;
+    if (!Number.isInteger(cellSize) || cellSize < 1 || cellSize > 32) {
+        throw new InvalidConfigError("cellSize must be an integer between 1 and 32");
+    }
+    if (![0, 90, 180, 270].includes(rotation)) {
+        throw new InvalidConfigError("rotation must be one of 0, 90, 180, 270");
+    }
+    const rows = matrix.length;
+    const cols = matrix[0]?.length ?? 0;
+    if (rows === 0 || cols === 0) {
+        throw new InvalidConfigError("empty matrix");
+    }
+    const width = cols * cellSize;
+    const height = rows * cellSize;
+    const raw = packRaster(width, height, (x, y) => {
+        const cx = Math.floor(x / cellSize);
+        const cy = Math.floor(y / cellSize);
+        return matrix[cy]?.[cx] === true;
+    });
+    return applyRotation(raw, rotation);
+}
+/** Pack a black/white raster (given by a predicate) into a MonochromeBitmap. */
+function packRaster(width, height, isBlack) {
+    if (width < 1 || height < 1 || width > MAX_RASTER_DOTS || height > MAX_RASTER_DOTS) {
+        throw new InvalidConfigError("raster dimensions out of range");
+    }
+    const bytesPerRow = Math.ceil(width / 8);
+    const totalBytes = bytesPerRow * height;
+    if (totalBytes > MAX_RASTER_BYTES) {
+        throw new InvalidConfigError(`raster too large (${totalBytes} bytes > ${MAX_RASTER_BYTES})`);
+    }
+    const data = new Uint8Array(totalBytes);
+    for (let y = 0; y < height; y++) {
+        for (let x = 0; x < width; x++) {
+            if (isBlack(x, y)) {
+                const byteIdx = y * bytesPerRow + (x >> 3);
+                data[byteIdx] |= 0x80 >> (x & 7);
+            }
+        }
+    }
+    return { data, width, height, bytesPerRow };
+}
+/** Rotate a bitmap 90/180/270 degrees clockwise (0 = identity). */
+function applyRotation(bmp, rotation) {
+    if (rotation === 0)
+        return bmp;
+    const { width, height, data } = bmp;
+    const isBlack = (x, y) => (data[y * bmp.bytesPerRow + (x >> 3)] & (0x80 >> (x & 7))) !== 0;
+    if (rotation === 90) {
+        // dest(x,y) = src(y, width-1-x)
+        return packRaster(height, width, (x, y) => isBlack(y, width - 1 - x));
+    }
+    if (rotation === 180) {
+        return packRaster(width, height, (x, y) => isBlack(width - 1 - x, height - 1 - y));
+    }
+    // 270 = 90 CCW: dest(x,y) = src(height-1-y, x)
+    return packRaster(height, width, (x, y) => isBlack(height - 1 - y, x));
+}
+/**
+ * Rasterize a barcode/QR/matrix element into a MonochromeBitmap using etiket's
+ * raw encoders. Throws InvalidConfigError on empty/invalid encodings.
+ */
+export function rasterizeElement(el) {
+    if (el.type === "barcode") {
+        const { symbology, content, options } = el;
+        const { encodeOpts, moduleWidth, height, rotation } = extractBarcodeOpts(options);
+        const bars = encodeBars(content, { type: symbology, ...encodeOpts });
+        return rasterizeBars(bars, { moduleWidth, height, rotation });
+    }
+    if (el.type === "qrcode") {
+        const { content, options } = el;
+        const cellSize = options.cellSize ?? 6;
+        const rotation = options.rotation ?? 0;
+        const matrix = encodeQR(content, {
+            ecLevel: options.ecc ?? "M",
+            version: options.version,
+            mode: options.mode,
+            mask: options.mask,
+            eci: options.eci,
+            gs1: options.gs1,
+        });
+        return rasterizeMatrix(matrix, { moduleWidth: cellSize, rotation });
+    }
+    // matrix element (narrowed: barcode and qrcode handled above)
+    if (el.type !== "matrix") {
+        throw new InvalidConfigError(`cannot rasterize element type ${el.type}`);
+    }
+    const { symbology, content, options } = el;
+    const cellSize = (options.cellSize ?? 6);
+    const rotation = (options.rotation ?? 0);
+    const matOpts = { moduleWidth: cellSize, rotation };
+    switch (symbology) {
+        case "datamatrix": {
+            const matrix = encodeDataMatrix(content, options.datamatrix);
+            return rasterizeMatrix(matrix, matOpts);
+        }
+        case "pdf417": {
+            const { matrix } = encodePDF417(content, options.pdf417);
+            return rasterizeMatrix(matrix, matOpts);
+        }
+        case "aztec": {
+            const matrix = encodeAztec(content, options.aztec);
+            return rasterizeMatrix(matrix, matOpts);
+        }
+        default:
+            throw new InvalidConfigError(`unsupported matrix symbology: ${String(symbology)}`);
+    }
+}
+function extractBarcodeOpts(options) {
+    const { x: _x, y: _y, height, moduleWidth, ratio: _ratio, rotation, readable: _readable, fontSize: _fontSize, ...encodeOpts } = options;
+    void _x;
+    void _y;
+    void _ratio;
+    void _readable;
+    void _fontSize;
+    return { encodeOpts, moduleWidth: moduleWidth, height: height, rotation: rotation };
+}
+/** Convert a Uint8Array to a TSC BITMAP data payload (comma-separated bytes). */
+export function bytesToTSC(data) {
+    let out = "";
+    for (let i = 0; i < data.length; i++) {
+        if (i > 0)
+            out += ",";
+        out += String(data[i]);
+    }
+    return out;
+}
+/** Convert a Uint8Array to uppercase hex (ZPL ^GFA payload). */
+export function bytesToHex(data) {
+    let out = "";
+    for (let i = 0; i < data.length; i++) {
+        out += data[i].toString(16).padStart(2, "0").toUpperCase();
+    }
+    return out;
+}
+//# sourceMappingURL=raster.js.map

package/dist/raster.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"raster.js","sourceRoot":"","sources":["../src/raster.ts"],"names":[],"mappings":"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"}

package/dist/receipt.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Receipt layout helpers — build aligned text lines for receipts or labels.
+ * Copied verbatim from portakal (https://github.com/productdevbook/portakal) — MIT.
+ * Pure string padding/truncation; output feeds into .text() which sanitizes.
+ */
+/** Column definition for table layout */
+export interface Column {
+    /** Column width in characters */
+    width: number;
+    /** Text alignment within column */
+    align?: "left" | "center" | "right";
+}
+/** Row helper: format text for same-line left+right (or multi-column) alignment */
+export declare function formatRow(columns: Column[], values: string[], totalWidth: number): string;
+/** Format a simple left+right pair on one line (most common receipt pattern) */
+export declare function formatPair(left: string, right: string, totalWidth: number): string;
+/** Format a table with headers and rows */
+export declare function formatTable(columns: Column[], rows: string[][], totalWidth: number): string[];
+/** Create a separator/divider line */
+export declare function separator(char: string, totalWidth: number): string;
+/** Word-wrap text at word boundaries */
+export declare function wordWrap(text: string, maxWidth: number): string[];

package/dist/receipt.js

@@ -0,0 +1,91 @@
+/**
+ * Receipt layout helpers — build aligned text lines for receipts or labels.
+ * Copied verbatim from portakal (https://github.com/productdevbook/portakal) — MIT.
+ * Pure string padding/truncation; output feeds into .text() which sanitizes.
+ */
+/** Row helper: format text for same-line left+right (or multi-column) alignment */
+export function formatRow(columns, values, totalWidth) {
+    if (columns.length === 0 || values.length === 0)
+        return "";
+    // If no explicit widths, auto-distribute
+    let assignedWidth = 0;
+    let autoCount = 0;
+    for (const col of columns) {
+        if (col.width > 0) {
+            assignedWidth += col.width;
+        }
+        else {
+            autoCount++;
+        }
+    }
+    const autoWidth = autoCount > 0 ? Math.floor((totalWidth - assignedWidth) / autoCount) : 0;
+    const parts = [];
+    for (let i = 0; i < columns.length; i++) {
+        const col = columns[i];
+        const val = values[i] ?? "";
+        const w = col.width > 0 ? col.width : autoWidth;
+        parts.push(alignText(val, w, col.align ?? "left"));
+    }
+    return parts.join("");
+}
+/** Format a simple left+right pair on one line (most common receipt pattern) */
+export function formatPair(left, right, totalWidth) {
+    const rightLen = right.length;
+    const leftLen = totalWidth - rightLen;
+    if (leftLen <= 0)
+        return right.slice(0, totalWidth);
+    return padRight(left, leftLen) + right;
+}
+/** Format a table with headers and rows */
+export function formatTable(columns, rows, totalWidth) {
+    return rows.map((row) => formatRow(columns, row, totalWidth));
+}
+/** Create a separator/divider line */
+export function separator(char, totalWidth) {
+    return char.repeat(totalWidth);
+}
+/** Word-wrap text at word boundaries */
+export function wordWrap(text, maxWidth) {
+    if (text.length <= maxWidth)
+        return [text];
+    const words = text.split(" ");
+    const lines = [];
+    let current = "";
+    for (const word of words) {
+        if (current.length === 0) {
+            current = word;
+        }
+        else if (current.length + 1 + word.length <= maxWidth) {
+            current += " " + word;
+        }
+        else {
+            lines.push(current);
+            current = word;
+        }
+    }
+    if (current.length > 0) {
+        lines.push(current);
+    }
+    return lines;
+}
+function alignText(text, width, align) {
+    const truncated = text.length > width ? text.slice(0, width) : text;
+    const padding = width - truncated.length;
+    switch (align) {
+        case "right":
+            return " ".repeat(padding) + truncated;
+        case "center": {
+            const leftPad = Math.floor(padding / 2);
+            const rightPad = padding - leftPad;
+            return " ".repeat(leftPad) + truncated + " ".repeat(rightPad);
+        }
+        default:
+            return truncated + " ".repeat(padding);
+    }
+}
+function padRight(text, width) {
+    if (text.length >= width)
+        return text.slice(0, width);
+    return text + " ".repeat(width - text.length);
+}
+//# sourceMappingURL=receipt.js.map

package/dist/receipt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"receipt.js","sourceRoot":"","sources":["../src/receipt.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAUH,mFAAmF;AACnF,MAAM,UAAU,SAAS,CAAC,OAAiB,EAAE,MAAgB,EAAE,UAAkB;IAC/E,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAE3D,yCAAyC;IACzC,IAAI,aAAa,GAAG,CAAC,CAAC;IACtB,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;QAC1B,IAAI,GAAG,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC;YAClB,aAAa,IAAI,GAAG,CAAC,KAAK,CAAC;QAC7B,CAAC;aAAM,CAAC;YACN,SAAS,EAAE,CAAC;QACd,CAAC;IACH,CAAC;IACD,MAAM,SAAS,GAAG,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,UAAU,GAAG,aAAa,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAE3F,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACxC,MAAM,GAAG,GAAG,OAAO,CAAC,CAAC,CAAE,CAAC;QACxB,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC5B,MAAM,CAAC,GAAG,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;QAChD,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC,EAAE,GAAG,CAAC,KAAK,IAAI,MAAM,CAAC,CAAC,CAAC;IACrD,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACxB,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,UAAU,CAAC,IAAY,EAAE,KAAa,EAAE,UAAkB;IACxE,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC;IAC9B,MAAM,OAAO,GAAG,UAAU,GAAG,QAAQ,CAAC;IACtC,IAAI,OAAO,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;IACpD,OAAO,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,KAAK,CAAC;AACzC,CAAC;AAED,2CAA2C;AAC3C,MAAM,UAAU,WAAW,CAAC,OAAiB,EAAE,IAAgB,EAAE,UAAkB;IACjF,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC;AAChE,CAAC;AAED,sCAAsC;AACtC,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,UAAkB;IACxD,OAAO,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;AACjC,CAAC;AAED,wCAAwC;AACxC,MAAM,UAAU,QAAQ,CAAC,IAAY,EAAE,QAAgB;IACrD,IAAI,IAAI,CAAC,MAAM,IAAI,QAAQ;QAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAE3C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC9B,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,OAAO,GAAG,EAAE,CAAC;IAEjB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO,GAAG,IAAI,CAAC;QACjB,CAAC;aAAM,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,IAAI,QAAQ,EAAE,CAAC;YACxD,OAAO,IAAI,GAAG,GAAG,IAAI,CAAC;QACxB,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACpB,OAAO,GAAG,IAAI,CAAC;QACjB,CAAC;IACH,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACtB,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,SAAS,CAAC,IAAY,EAAE,KAAa,EAAE,KAAkC;IAChF,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACpE,MAAM,OAAO,GAAG,KAAK,GAAG,SAAS,CAAC,MAAM,CAAC;IAEzC,QAAQ,KAAK,EAAE,CAAC;QACd,KAAK,OAAO;YACV,OAAO,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,SAAS,CAAC;QACzC,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC;YACxC,MAAM,QAAQ,GAAG,OAAO,GAAG,OAAO,CAAC;YACnC,OAAO,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,SAAS,GAAG,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAChE,CAAC;QACD;YACE,OAAO,SAAS,GAAG,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC3C,CAAC;AACH,CAAC;AAED,SAAS,QAAQ,CAAC,IAAY,EAAE,KAAa;IAC3C,IAAI,IAAI,CAAC,MAAM,IAAI,KAAK;QAAE,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IACtD,OAAO,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;AAChD,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,336 @@
+/**
+ * Shared types for the label builder and compilers.
+ * Copied from portakal (https://github.com/productdevbook/portakal) — MIT.
+ */
+/** Unit of measurement for label dimensions */
+export type Unit = "mm" | "inch" | "dot";
+/** Print orientation / rotation */
+export type Rotation = 0 | 90 | 180 | 270;
+/** Text alignment */
+export type Alignment = "left" | "center" | "right";
+/** Dithering algorithm for image processing */
+export type DitherAlgorithm = "threshold" | "floyd-steinberg" | "atkinson" | "ordered";
+/** Label configuration */
+export interface LabelConfig {
+    /** Printer profile ID (e.g., "tsc-te200", "zebra-zd420"). Overrides width, dpi, etc. */
+    printer?: string;
+    /** Label width */
+    width: number;
+    /** Label height (optional for receipt/continuous mode) */
+    height?: number;
+    /** Unit of measurement (default: "mm") */
+    unit?: Unit;
+    /** Printer DPI (default: 203) */
+    dpi?: number;
+    /**
+     * TSPL font "0" base character size in dots (width × height).
+     * DPI-dependent: 12×24 @ 203 DPI, 18×36 @ 300 DPI. Inherited from the
+     * printer profile when `printer` is set; overridable here.
+     */
+    fontBase?: {
+        width: number;
+        height: number;
+    };
+    /**
+     * How TSPL font "0" sizes are interpreted: "multiplier" (of `fontBase`)
+     * or "points" (1pt = 1/72in). Firmware varies; default "multiplier".
+     */
+    font0Mode?: "multiplier" | "points";
+    /**
+     * Average glyph width relative to the font height for text width estimates
+     * (default 0.6). Font "0" TrueType runs ~0.5–0.6× the point height; tune
+     * per printer/font if centered text drifts. Overridden per element via
+     * TextOptions.charWidthFactor.
+     */
+    charWidthFactor?: number;
+    /** Gap between labels in mm (label printers only) */
+    gap?: number;
+    /**
+     * Print margin in `unit` (default 0) — a minimum offset the printer keeps
+     * from the media edge. Emitted as `^ML` on ZPL; TSC has no equivalent
+     * command, so the caller insets the layout instead.
+     */
+    margin?: number;
+    /** Print speed (1-10, printer-dependent) */
+    speed?: number;
+    /** Print darkness/density (0-15) */
+    density?: number;
+    /** Print direction */
+    direction?: 0 | 1;
+    /** Number of copies */
+    copies?: number;
+}
+/** Text element options */
+export interface TextOptions {
+    /** X position */
+    x?: number;
+    /** Y position */
+    y?: number;
+    /** Font name or ID */
+    font?: string;
+    /** Font size or magnification */
+    size?: number;
+    /** Horizontal magnification (1-10) */
+    xScale?: number;
+    /** Vertical magnification (1-10) */
+    yScale?: number;
+    /** Rotation */
+    rotation?: Rotation;
+    /** Bold */
+    bold?: boolean;
+    /** Underline */
+    underline?: boolean;
+    /** Reverse (white on black) */
+    reverse?: boolean;
+    /** Alignment */
+    align?: Alignment;
+    /** Max width for word-wrap (in dots) */
+    maxWidth?: number;
+    /** Max height for word-wrap/clipping (in dots) — TSC BLOCK height (default: maxWidth) */
+    maxHeight?: number;
+    /** Line spacing (in dots) */
+    lineSpacing?: number;
+    /**
+     * Average glyph width relative to the font height for text width estimates
+     * in the preview (default: the builder's charWidthFactor, 0.6). Tune per
+     * printer/font if centered text drifts in the preview.
+     */
+    charWidthFactor?: number;
+}
+/** Image element options */
+export interface ImageOptions {
+    /** X position */
+    x?: number;
+    /** Y position */
+    y?: number;
+    /** Target width in dots (auto-scale if set) */
+    width?: number;
+    /** Target height in dots (auto-scale if set) */
+    height?: number;
+    /** Dithering algorithm (default: "threshold") */
+    dither?: DitherAlgorithm;
+    /** Threshold for monochrome conversion (0-255, default: 128) */
+    threshold?: number;
+}
+/** Box/rectangle element options */
+export interface BoxOptions {
+    /** X position */
+    x: number;
+    /** Y position */
+    y: number;
+    /** Width */
+    width: number;
+    /** Height */
+    height: number;
+    /** Border thickness in dots (default: 1) */
+    thickness?: number;
+    /** Corner radius in dots */
+    radius?: number;
+}
+/** Line element options */
+export interface LineOptions {
+    /** Start X */
+    x1: number;
+    /** Start Y */
+    y1: number;
+    /** End X */
+    x2: number;
+    /** End Y */
+    y2: number;
+    /** Line thickness in dots (default: 1) */
+    thickness?: number;
+}
+/** Circle element options */
+export interface CircleOptions {
+    /** Center X */
+    x: number;
+    /** Center Y */
+    y: number;
+    /** Diameter in dots */
+    diameter: number;
+    /** Border thickness in dots (default: 1) */
+    thickness?: number;
+}
+/** 1-bit monochrome bitmap (universal intermediate format for images) */
+export interface MonochromeBitmap {
+    /** Packed 1-bit pixel data, row-major, MSB-first */
+    data: Uint8Array;
+    /** Width in pixels */
+    width: number;
+    /** Height in pixels */
+    height: number;
+    /** Bytes per row = ceil(width / 8) */
+    bytesPerRow: number;
+}
+/** Ellipse element options */
+export interface EllipseOptions {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    thickness?: number;
+}
+/** Reverse region options (invert black/white) */
+export interface ReverseOptions {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+/** Erase region options (clear to white) */
+export interface EraseOptions {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+/**
+ * Barcode symbologies supported by .barcode(). The value is passed to etiket's
+ * encoders, so anything etiket supports works. `code128` uses the printer's
+ * native encoder; everything else is rasterized to a BITMAP/^GFA graphic.
+ */
+export type BarcodeSymbology = string;
+/** 1D barcode element options. */
+export interface BarcodeOptions {
+    /** X position in dots */
+    x?: number;
+    /** Y position in dots */
+    y?: number;
+    /** Bar height in dots (default: 80) */
+    height?: number;
+    /** Narrow element width in dots (default: 2) */
+    moduleWidth?: number;
+    /** Wide:narrow ratio (TSC 1-4, ZPL 2 or 3; default: 2) */
+    ratio?: number;
+    /** Rotation (default: 0) */
+    rotation?: Rotation;
+    /** Human-readable text below the bars (default: true) */
+    readable?: boolean;
+    /** Human-readable font size (TSC 1-10, ZPL 0-5; default: 2) */
+    fontSize?: number;
+    /** etiket encoding passthrough */
+    code128Charset?: "auto" | "A" | "B" | "C";
+    msiCheckDigit?: "mod10" | "mod11" | "mod1010" | "mod1110" | "none";
+    code39CheckDigit?: boolean;
+    codabarStart?: string;
+    codabarStop?: string;
+    /** Render interpretable text (affects SVG preview; default true) */
+    showText?: boolean;
+}
+/** QR code element options. */
+export interface QrCodeOptions {
+    /** X position in dots */
+    x?: number;
+    /** Y position in dots */
+    y?: number;
+    /** Module (cell) width in dots (default: 6) */
+    cellSize?: number;
+    /** Error correction level (default: "M") */
+    ecc?: "L" | "M" | "Q" | "H";
+    /** Rotation (default: 0) */
+    rotation?: Rotation;
+    /** etiket QR encoding passthrough */
+    version?: number;
+    mode?: "numeric" | "alphanumeric" | "byte" | "kanji" | "auto";
+    mask?: 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7;
+    eci?: number;
+    gs1?: boolean;
+}
+/** 2D barcode element options (etiket raster path). */
+export interface MatrixBarcodeOptions {
+    /** X position in dots */
+    x?: number;
+    /** Y position in dots */
+    y?: number;
+    /** Module width in dots (default: 6) */
+    cellSize?: number;
+    /** Rotation (default: 0) */
+    rotation?: Rotation;
+    /** etiket encoding passthrough (per-symbology) */
+    [key: string]: unknown;
+}
+/** Internal label element union type */
+export type LabelElement = {
+    type: "text";
+    content: string;
+    options: TextOptions;
+} | {
+    type: "image";
+    bitmap: MonochromeBitmap;
+    options: ImageOptions;
+} | {
+    type: "box";
+    options: BoxOptions;
+} | {
+    type: "line";
+    options: LineOptions;
+} | {
+    type: "circle";
+    options: CircleOptions;
+} | {
+    type: "ellipse";
+    options: EllipseOptions;
+} | {
+    type: "reverse";
+    options: ReverseOptions;
+} | {
+    type: "erase";
+    options: EraseOptions;
+} | {
+    type: "barcode";
+    content: string;
+    symbology: BarcodeSymbology;
+    options: BarcodeOptions;
+} | {
+    type: "qrcode";
+    content: string;
+    options: QrCodeOptions;
+} | {
+    type: "matrix";
+    content: string;
+    symbology: "datamatrix" | "pdf417" | "aztec";
+    options: MatrixBarcodeOptions;
+} | {
+    type: "raw";
+    content: string | Uint8Array;
+};
+/** Resolved label configuration with computed values */
+export interface ResolvedLabel {
+    /** Width in dots */
+    widthDots: number;
+    /** Height in dots (0 for continuous/receipt) */
+    heightDots: number;
+    /** DPI */
+    dpi: number;
+    /**
+     * TSPL font "0" base size in dots (12×24 @ 203, 18×36 @ 300), from the
+     * printer profile or config override.
+     */
+    fontBase: {
+        width: number;
+        height: number;
+    };
+    /**
+     * TSPL font "0" size mode: "multiplier" (of fontBase) or "points".
+     */
+    font0Mode: "multiplier" | "points";
+    /**
+     * Default average glyph width relative to the font height for text width
+     * estimates (preview centering), from config.
+     */
+    charWidthFactor: number;
+    /** Gap in dots */
+    gapDots: number;
+    /** Print margin in dots */
+    marginDots: number;
+    /** Speed */
+    speed: number;
+    /** Density */
+    density: number;
+    /** Direction */
+    direction: 0 | 1;
+    /** Copies */
+    copies: number;
+    /** All elements to render */
+    elements: LabelElement[];
+}

package/dist/types.js

@@ -0,0 +1,6 @@
+/**
+ * Shared types for the label builder and compilers.
+ * Copied from portakal (https://github.com/productdevbook/portakal) — MIT.
+ */
+export {};
+//# sourceMappingURL=types.js.map