@thermal-label/brother-ql-core 0.0.1 → 0.3.0

package/dist/media.d.ts

@@ -1,5 +1,44 @@
-import { type MediaDescriptor, type MediaType } from './types.js';
-export declare const MEDIA: Record<number, MediaDescriptor>;
-export declare function findMedia(id: number): MediaDescriptor | undefined;
-export declare function findMediaByWidth(widthMm: number, type: MediaType): MediaDescriptor[];
+import type { BrotherQLMedia, MediaType } from './types.js';
+/**
+ * Registry of supported Brother QL consumables.
+ *
+ * Entries are keyed by the firmware media id — the same number the
+ * printer reports in the 32-byte status response. `heightMm` is omitted
+ * for continuous media (variable length) and set for die-cut labels
+ * (fixed length).
+ *
+ * `palette` is set on multi-ink media (DK-22251, today's only entry) —
+ * the driver routes those through `renderMultiPlaneImage` and emits the
+ * second plane in the raster job. Single-ink rolls leave it undefined
+ * and route through `renderImage` (dithered single-plane).
+ *
+ * Rectangular die-cut entries declare `defaultOrientation: 'horizontal'`
+ * so landscape input auto-rotates to read along the tape feed direction.
+ * Continuous wide tape leaves the hint undefined — users may go either
+ * way.
+ *
+ * `cornerRadiusMm` is informational; previews use it to render the
+ * actual paper outline. Round die-cut labels set the radius to
+ * `widthMm / 2` so the rounded rectangle degenerates to a circle.
+ */
+export declare const MEDIA: Record<number, BrotherQLMedia>;
+/**
+ * Default media when `createPreview()` is called without media and
+ * without a detected roll. 62mm continuous (DK-22205) is the common
+ * single-colour shipping roll.
+ */
+export declare const DEFAULT_MEDIA: BrotherQLMedia;
+export declare function findMedia(id: number): BrotherQLMedia | undefined;
+export declare function findMediaByWidth(widthMm: number, type: MediaType): BrotherQLMedia[];
+/**
+ * Match status-response dimensions to a media registry entry.
+ *
+ * @param widthMm     media width in mm (status byte 10)
+ * @param heightMm    media length in mm (status byte 17) — 0 = continuous
+ * @param twoColorMode true when the status response indicates the
+ *                     printer is configured for two-colour media. When
+ *                     both DK-22205 (259) and DK-22251 (251) match the
+ *                     dimensions, the flag picks the right one.
+ */
+export declare function findMediaByDimensions(widthMm: number, heightMm: number, twoColorMode?: boolean): BrotherQLMedia | undefined;
 //# sourceMappingURL=media.d.ts.map

package/dist/media.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"media.d.ts","sourceRoot":"","sources":["../src/media.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,eAAe,EAAE,KAAK,SAAS,EAAE,MAAM,YAAY,CAAC;AAElE,eAAO,MAAM,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CA+OjD,CAAC;AAEF,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAEjE;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,eAAe,EAAE,CAEpF"}
+{"version":3,"file":"media.d.ts","sourceRoot":"","sources":["../src/media.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5D;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAmQhD,CAAC;AAEF;;;;GAIG;AAEH,eAAO,MAAM,aAAa,EAAE,cAA4B,CAAC;AAEzD,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAEhE;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,cAAc,EAAE,CAEnF;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,YAAY,UAAQ,GACnB,cAAc,GAAG,SAAS,CAY5B"}

package/dist/media.js

@@ -1,4 +1,25 @@
-import {} from './types.js';
+/**
+ * Registry of supported Brother QL consumables.
+ *
+ * Entries are keyed by the firmware media id — the same number the
+ * printer reports in the 32-byte status response. `heightMm` is omitted
+ * for continuous media (variable length) and set for die-cut labels
+ * (fixed length).
+ *
+ * `palette` is set on multi-ink media (DK-22251, today's only entry) —
+ * the driver routes those through `renderMultiPlaneImage` and emits the
+ * second plane in the raster job. Single-ink rolls leave it undefined
+ * and route through `renderImage` (dithered single-plane).
+ *
+ * Rectangular die-cut entries declare `defaultOrientation: 'horizontal'`
+ * so landscape input auto-rotates to read along the tape feed direction.
+ * Continuous wide tape leaves the hint undefined — users may go either
+ * way.
+ *
+ * `cornerRadiusMm` is informational; previews use it to render the
+ * actual paper outline. Round die-cut labels set the radius to
+ * `widthMm / 2` so the rounded rectangle degenerates to a circle.
+ */
 export const MEDIA = {
     // Continuous length tape
     257: {
@@ -6,7 +27,6 @@ export const MEDIA = {
         name: '12mm continuous',
         type: 'continuous',
         widthMm: 12,
-        lengthMm: 0,
         printAreaDots: 106,
         leftMarginPins: 585,
         rightMarginPins: 29,
@@ -16,7 +36,6 @@ export const MEDIA = {
         name: '29mm continuous (DK-22210)',
         type: 'continuous',
         widthMm: 29,
-        lengthMm: 0,
         printAreaDots: 306,
         leftMarginPins: 408,
         rightMarginPins: 6,
@@ -26,7 +45,6 @@ export const MEDIA = {
         name: '38mm continuous (DK-22225)',
         type: 'continuous',
         widthMm: 38,
-        lengthMm: 0,
         printAreaDots: 413,
         leftMarginPins: 295,
         rightMarginPins: 12,
@@ -36,7 +54,6 @@ export const MEDIA = {
         name: '50mm continuous (DK-22246)',
         type: 'continuous',
         widthMm: 50,
-        lengthMm: 0,
         printAreaDots: 554,
         leftMarginPins: 154,
         rightMarginPins: 12,
@@ -46,7 +63,6 @@ export const MEDIA = {
         name: '54mm continuous (DK-22214)',
         type: 'continuous',
         widthMm: 54,
-        lengthMm: 0,
         printAreaDots: 590,
         leftMarginPins: 130,
         rightMarginPins: 0,
@@ -56,7 +72,6 @@ export const MEDIA = {
         name: '62mm continuous (DK-22205)',
         type: 'continuous',
         widthMm: 62,
-        lengthMm: 0,
         printAreaDots: 696,
         leftMarginPins: 12,
         rightMarginPins: 12,
@@ -66,18 +81,19 @@ export const MEDIA = {
         name: '62mm continuous two-color (DK-22251)',
         type: 'continuous',
         widthMm: 62,
-        lengthMm: 0,
+        palette: [
+            { name: 'black', rgb: [0, 0, 0] },
+            { name: 'red', rgb: [255, 0, 0] },
+        ],
         printAreaDots: 696,
         leftMarginPins: 12,
         rightMarginPins: 12,
-        twoColorTape: true,
     },
     260: {
         id: 260,
         name: '102mm continuous (DK-22243)',
         type: 'continuous',
         widthMm: 102,
-        lengthMm: 0,
         printAreaDots: 1164,
         leftMarginPins: 76,
         rightMarginPins: 56,
@@ -88,7 +104,9 @@ export const MEDIA = {
         name: '17×54mm die-cut (DK-11204)',
         type: 'die-cut',
         widthMm: 17,
-        lengthMm: 54,
+        heightMm: 54,
+        defaultOrientation: 'horizontal',
+        cornerRadiusMm: 3,
         printAreaDots: 165,
         leftMarginPins: 0,
         rightMarginPins: 0,
@@ -99,7 +117,9 @@ export const MEDIA = {
         name: '17×87mm die-cut (DK-11203)',
         type: 'die-cut',
         widthMm: 17,
-        lengthMm: 87,
+        heightMm: 87,
+        defaultOrientation: 'horizontal',
+        cornerRadiusMm: 3,
         printAreaDots: 165,
         leftMarginPins: 0,
         rightMarginPins: 0,
@@ -110,7 +130,9 @@ export const MEDIA = {
         name: '23×23mm die-cut',
         type: 'die-cut',
         widthMm: 23,
-        lengthMm: 23,
+        heightMm: 23,
+        defaultOrientation: 'horizontal',
+        cornerRadiusMm: 3,
         printAreaDots: 236,
         leftMarginPins: 0,
         rightMarginPins: 0,
@@ -121,7 +143,9 @@ export const MEDIA = {
         name: '29×90mm die-cut (DK-11201)',
         type: 'die-cut',
         widthMm: 29,
-        lengthMm: 90,
+        heightMm: 90,
+        defaultOrientation: 'horizontal',
+        cornerRadiusMm: 3,
         printAreaDots: 306,
         leftMarginPins: 0,
         rightMarginPins: 0,
@@ -132,7 +156,9 @@ export const MEDIA = {
         name: '38×90mm die-cut (DK-11218)',
         type: 'die-cut',
         widthMm: 38,
-        lengthMm: 90,
+        heightMm: 90,
+        defaultOrientation: 'horizontal',
+        cornerRadiusMm: 3,
         printAreaDots: 413,
         leftMarginPins: 0,
         rightMarginPins: 0,
@@ -143,7 +169,9 @@ export const MEDIA = {
         name: '39×48mm die-cut (DK-11219)',
         type: 'die-cut',
         widthMm: 39,
-        lengthMm: 48,
+        heightMm: 48,
+        defaultOrientation: 'horizontal',
+        cornerRadiusMm: 3,
         printAreaDots: 425,
         leftMarginPins: 0,
         rightMarginPins: 0,
@@ -154,7 +182,9 @@ export const MEDIA = {
         name: '52×29mm die-cut',
         type: 'die-cut',
         widthMm: 52,
-        lengthMm: 29,
+        heightMm: 29,
+        defaultOrientation: 'horizontal',
+        cornerRadiusMm: 3,
         printAreaDots: 578,
         leftMarginPins: 0,
         rightMarginPins: 0,
@@ -165,7 +195,9 @@ export const MEDIA = {
         name: '62×29mm die-cut (DK-11209)',
         type: 'die-cut',
         widthMm: 62,
-        lengthMm: 29,
+        heightMm: 29,
+        defaultOrientation: 'horizontal',
+        cornerRadiusMm: 3,
         printAreaDots: 696,
         leftMarginPins: 0,
         rightMarginPins: 0,
@@ -176,7 +208,9 @@ export const MEDIA = {
         name: '62×100mm die-cut (DK-11202)',
         type: 'die-cut',
         widthMm: 62,
-        lengthMm: 100,
+        heightMm: 100,
+        defaultOrientation: 'horizontal',
+        cornerRadiusMm: 3,
         printAreaDots: 696,
         leftMarginPins: 0,
         rightMarginPins: 0,
@@ -187,7 +221,9 @@ export const MEDIA = {
         name: '102×51mm die-cut (DK-11240)',
         type: 'die-cut',
         widthMm: 102,
-        lengthMm: 51,
+        heightMm: 51,
+        defaultOrientation: 'horizontal',
+        cornerRadiusMm: 3,
         printAreaDots: 1164,
         leftMarginPins: 0,
         rightMarginPins: 0,
@@ -198,7 +234,9 @@ export const MEDIA = {
         name: '102×152mm die-cut (DK-11241)',
         type: 'die-cut',
         widthMm: 102,
-        lengthMm: 152,
+        heightMm: 152,
+        defaultOrientation: 'horizontal',
+        cornerRadiusMm: 3,
         printAreaDots: 1164,
         leftMarginPins: 0,
         rightMarginPins: 0,
@@ -209,7 +247,8 @@ export const MEDIA = {
         name: '12mm Ø die-cut',
         type: 'die-cut',
         widthMm: 12,
-        lengthMm: 12,
+        heightMm: 12,
+        cornerRadiusMm: 6,
         printAreaDots: 94,
         leftMarginPins: 0,
         rightMarginPins: 0,
@@ -220,7 +259,8 @@ export const MEDIA = {
         name: '24mm Ø die-cut (DK-11221)',
         type: 'die-cut',
         widthMm: 24,
-        lengthMm: 24,
+        heightMm: 24,
+        cornerRadiusMm: 12,
         printAreaDots: 236,
         leftMarginPins: 0,
         rightMarginPins: 0,
@@ -231,17 +271,45 @@ export const MEDIA = {
         name: '58mm Ø die-cut (DK-11207)',
         type: 'die-cut',
         widthMm: 58,
-        lengthMm: 58,
+        heightMm: 58,
+        cornerRadiusMm: 29,
         printAreaDots: 618,
         leftMarginPins: 0,
         rightMarginPins: 0,
         dieCutMaskedAreaDots: 618,
     },
 };
+/**
+ * Default media when `createPreview()` is called without media and
+ * without a detected roll. 62mm continuous (DK-22205) is the common
+ * single-colour shipping roll.
+ */
+// eslint-disable-next-line @typescript-eslint/no-non-null-assertion -- DK-22205 is a hard-coded registry key
+export const DEFAULT_MEDIA = MEDIA[259];
 export function findMedia(id) {
     return MEDIA[id];
 }
 export function findMediaByWidth(widthMm, type) {
     return Object.values(MEDIA).filter(m => m.widthMm === widthMm && m.type === type);
 }
+/**
+ * Match status-response dimensions to a media registry entry.
+ *
+ * @param widthMm     media width in mm (status byte 10)
+ * @param heightMm    media length in mm (status byte 17) — 0 = continuous
+ * @param twoColorMode true when the status response indicates the
+ *                     printer is configured for two-colour media. When
+ *                     both DK-22205 (259) and DK-22251 (251) match the
+ *                     dimensions, the flag picks the right one.
+ */
+export function findMediaByDimensions(widthMm, heightMm, twoColorMode = false) {
+    if (heightMm === 0) {
+        const continuousMatches = Object.values(MEDIA).filter(m => m.type === 'continuous' && m.widthMm === widthMm);
+        if (continuousMatches.length === 0)
+            return undefined;
+        const preferred = continuousMatches.find(m => (m.palette !== undefined) === twoColorMode);
+        return preferred ?? continuousMatches[0];
+    }
+    return Object.values(MEDIA).find(m => m.type === 'die-cut' && m.widthMm === widthMm && m.heightMm === heightMm);
+}
 //# sourceMappingURL=media.js.map

package/dist/media.js.map

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

package/dist/orientation.d.ts

@@ -0,0 +1,11 @@
+import type { RotateDirection } from '@thermal-label/contracts';
+/**
+ * Direction the Brother QL print head rotates landscape input.
+ *
+ * `90` = clockwise. Verified once on hardware with a die-cut "F"
+ * landscape print (see plan §6 step 1). Identical across every QL
+ * model — this is a print-head/leading-edge mechanical fact, not a
+ * per-media setting.
+ */
+export declare const ROTATE_DIRECTION: RotateDirection;
+//# sourceMappingURL=orientation.d.ts.map

package/dist/orientation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orientation.d.ts","sourceRoot":"","sources":["../src/orientation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAEhE;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB,EAAE,eAAoB,CAAC"}

package/dist/orientation.js

@@ -0,0 +1,10 @@
+/**
+ * Direction the Brother QL print head rotates landscape input.
+ *
+ * `90` = clockwise. Verified once on hardware with a die-cut "F"
+ * landscape print (see plan §6 step 1). Identical across every QL
+ * model — this is a print-head/leading-edge mechanical fact, not a
+ * per-media setting.
+ */
+export const ROTATE_DIRECTION = 90;
+//# sourceMappingURL=orientation.js.map

package/dist/orientation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orientation.js","sourceRoot":"","sources":["../src/orientation.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAoB,EAAE,CAAC"}

package/dist/pack-bits.d.ts

@@ -0,0 +1,20 @@
+/**
+ * TIFF-style PackBits row encoder used by Brother QL when compression
+ * mode (`M 02`, emitted by `buildCompression(true)`) is enabled for a job.
+ *
+ * Header byte `n` (interpreted as a signed int8):
+ *   n in [0, 127]:    literal run — the next `n + 1` bytes follow verbatim.
+ *   n in [-127, -1]:  repeat run — the next byte is repeated `1 - n` times.
+ *   n = -128:         no-op. Unused by this encoder.
+ *
+ * The encoder switches to repeat mode for runs of two or more identical
+ * bytes (a 2-byte repeat costs 2 wire bytes; the equivalent 2-byte literal
+ * would cost 3). Both run kinds are capped at 128 bytes to fit the header.
+ *
+ * For a typical Brother QL raster row (90 bytes, mostly zeros in margins
+ * and long runs of `0x00` / `0xff` in print area), this compresses to 5–15
+ * bytes — a 6–18× reduction. Worst-case for highly random input is one
+ * extra byte per 128 (the literal-mode header), i.e. < 1 % expansion.
+ */
+export declare function packBits(input: Uint8Array): Uint8Array;
+//# sourceMappingURL=pack-bits.d.ts.map

package/dist/pack-bits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pack-bits.d.ts","sourceRoot":"","sources":["../src/pack-bits.ts"],"names":[],"mappings":"AAOA;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU,CAsCtD"}

package/dist/pack-bits.js

@@ -0,0 +1,61 @@
+/* eslint-disable @typescript-eslint/no-non-null-assertion --
+ *   `noUncheckedIndexedAccess` types Uint8Array reads as `number | undefined`
+ *   but every index in this file is bounded by `i < input.length` or
+ *   `runEnd < input.length` checks. The `!` assertions collapse the
+ *   unreachable `undefined` branches so branch coverage doesn't count them.
+ */
+/**
+ * TIFF-style PackBits row encoder used by Brother QL when compression
+ * mode (`M 02`, emitted by `buildCompression(true)`) is enabled for a job.
+ *
+ * Header byte `n` (interpreted as a signed int8):
+ *   n in [0, 127]:    literal run — the next `n + 1` bytes follow verbatim.
+ *   n in [-127, -1]:  repeat run — the next byte is repeated `1 - n` times.
+ *   n = -128:         no-op. Unused by this encoder.
+ *
+ * The encoder switches to repeat mode for runs of two or more identical
+ * bytes (a 2-byte repeat costs 2 wire bytes; the equivalent 2-byte literal
+ * would cost 3). Both run kinds are capped at 128 bytes to fit the header.
+ *
+ * For a typical Brother QL raster row (90 bytes, mostly zeros in margins
+ * and long runs of `0x00` / `0xff` in print area), this compresses to 5–15
+ * bytes — a 6–18× reduction. Worst-case for highly random input is one
+ * extra byte per 128 (the literal-mode header), i.e. < 1 % expansion.
+ */
+export function packBits(input) {
+    if (input.length === 0)
+        return new Uint8Array(0);
+    const out = [];
+    let i = 0;
+    while (i < input.length) {
+        // How many identical bytes start at position i (cap at 128).
+        let runEnd = i + 1;
+        while (runEnd < input.length && runEnd - i < 128 && input[runEnd] === input[i]) {
+            runEnd++;
+        }
+        const runLen = runEnd - i;
+        if (runLen >= 2) {
+            // Repeat run: header is signed -(runLen - 1).
+            out.push((1 - runLen) & 0xff);
+            out.push(input[i]);
+            i = runEnd;
+            continue;
+        }
+        // Otherwise emit a literal run. Stop at 128 bytes, or right before a
+        // 2+ repeat run starts (cheaper to encode that separately).
+        let litEnd = i + 1;
+        while (litEnd < input.length && litEnd - i < 128) {
+            if (litEnd + 1 < input.length && input[litEnd] === input[litEnd + 1]) {
+                break;
+            }
+            litEnd++;
+        }
+        const litLen = litEnd - i;
+        out.push(litLen - 1);
+        for (let x = i; x < litEnd; x++)
+            out.push(input[x]);
+        i = litEnd;
+    }
+    return new Uint8Array(out);
+}
+//# sourceMappingURL=pack-bits.js.map

package/dist/pack-bits.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pack-bits.js","sourceRoot":"","sources":["../src/pack-bits.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAiB;IACxC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC;IAEjD,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,IAAI,CAAC,GAAG,CAAC,CAAC;IAEV,OAAO,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;QACxB,6DAA6D;QAC7D,IAAI,MAAM,GAAG,CAAC,GAAG,CAAC,CAAC;QACnB,OAAO,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,MAAM,GAAG,CAAC,GAAG,GAAG,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;YAC/E,MAAM,EAAE,CAAC;QACX,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,CAAC;QAE1B,IAAI,MAAM,IAAI,CAAC,EAAE,CAAC;YAChB,8CAA8C;YAC9C,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC;YAC9B,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,CAAC;YACpB,CAAC,GAAG,MAAM,CAAC;YACX,SAAS;QACX,CAAC;QAED,qEAAqE;QACrE,4DAA4D;QAC5D,IAAI,MAAM,GAAG,CAAC,GAAG,CAAC,CAAC;QACnB,OAAO,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,MAAM,GAAG,CAAC,GAAG,GAAG,EAAE,CAAC;YACjD,IAAI,MAAM,GAAG,CAAC,GAAG,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,CAAC;gBACrE,MAAM;YACR,CAAC;YACD,MAAM,EAAE,CAAC;QACX,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,CAAC;QAC1B,GAAG,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACrB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC,EAAE;YAAE,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,CAAC;QACrD,CAAC,GAAG,MAAM,CAAC;IACb,CAAC;IAED,OAAO,IAAI,UAAU,CAAC,GAAG,CAAC,CAAC;AAC7B,CAAC"}

package/dist/preview.d.ts

@@ -0,0 +1,13 @@
+import type { RawImageData } from '@mbtech-nl/bitmap';
+import type { PreviewResult } from '@thermal-label/contracts';
+import type { BrotherQLMedia } from './types.js';
+/**
+ * Offline preview without a live printer connection.
+ *
+ * Multi-ink aware: when `media.palette` is defined (DK-22251 today),
+ * the image is split per-plane via `renderMultiPlaneImage()` — the
+ * same code path `print()` takes for that media. Single-ink media
+ * returns one black plane via dithered `renderImage`.
+ */
+export declare function createPreviewOffline(image: RawImageData, media: BrotherQLMedia): PreviewResult;
+//# sourceMappingURL=preview.d.ts.map

package/dist/preview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview.d.ts","sourceRoot":"","sources":["../src/preview.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAe,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,cAAc,GAAG,aAAa,CAqB9F"}

package/dist/preview.js

@@ -0,0 +1,31 @@
+import { renderImage, renderMultiPlaneImage } from '@mbtech-nl/bitmap';
+/**
+ * Offline preview without a live printer connection.
+ *
+ * Multi-ink aware: when `media.palette` is defined (DK-22251 today),
+ * the image is split per-plane via `renderMultiPlaneImage()` — the
+ * same code path `print()` takes for that media. Single-ink media
+ * returns one black plane via dithered `renderImage`.
+ */
+export function createPreviewOffline(image, media) {
+    if (media.palette) {
+        const planes = renderMultiPlaneImage(image, {
+            palette: media.palette,
+        });
+        return {
+            planes: [
+                { name: 'black', bitmap: planes.black, displayColor: '#000000' },
+                { name: 'red', bitmap: planes.red, displayColor: '#ff0000' },
+            ],
+            media,
+            assumed: false,
+        };
+    }
+    const bitmap = renderImage(image, { dither: true });
+    return {
+        planes: [{ name: 'black', bitmap, displayColor: '#000000' }],
+        media,
+        assumed: false,
+    };
+}
+//# sourceMappingURL=preview.js.map

package/dist/preview.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview.js","sourceRoot":"","sources":["../src/preview.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAKvE;;;;;;;GAOG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAmB,EAAE,KAAqB;IAC7E,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;QAClB,MAAM,MAAM,GAAG,qBAAqB,CAAC,KAAK,EAAE;YAC1C,OAAO,EAAE,KAAK,CAAC,OAAO;SACvB,CAAyC,CAAC;QAC3C,OAAO;YACL,MAAM,EAAE;gBACN,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE;gBAChE,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,EAAE,YAAY,EAAE,SAAS,EAAE;aAC7D;YACD,KAAK;YACL,OAAO,EAAE,KAAK;SACf,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,WAAW,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IACpD,OAAO;QACL,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,SAAS,EAAE,CAAC;QAC5D,KAAK;QACL,OAAO,EAAE,KAAK;KACf,CAAC;AACJ,CAAC"}

package/dist/protocol.d.ts

@@ -1,10 +1,10 @@
-import { type MediaDescriptor, type PageData, type JobOptions } from './types.js';
+import type { BrotherQLMedia, PageData, JobOptions } from './types.js';
 export declare function buildInvalidate(): Uint8Array;
 export declare function buildStatusRequest(): Uint8Array;
 export declare function buildInitialize(): Uint8Array;
 export declare function buildRasterMode(): Uint8Array;
 export declare function buildStatusNotification(enabled: boolean): Uint8Array;
-export declare function buildPrintInfo(media: MediaDescriptor, rowCount: number, pageIndex: number): Uint8Array;
+export declare function buildPrintInfo(media: BrotherQLMedia, rowCount: number, pageIndex: number): Uint8Array;
 export declare function buildVariousMode(autoCut: boolean): Uint8Array;
 export declare function buildExpandedMode(cutAtEnd: boolean, highRes: boolean, twoColor?: boolean): Uint8Array;
 export declare function buildCutEach(n: number): Uint8Array;

package/dist/protocol.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,eAAe,EAAE,KAAK,QAAQ,EAAE,KAAK,UAAU,EAAoB,MAAM,YAAY,CAAC;AAEpG,wBAAgB,eAAe,IAAI,UAAU,CAE5C;AAED,wBAAgB,kBAAkB,IAAI,UAAU,CAE/C;AAED,wBAAgB,eAAe,IAAI,UAAU,CAE5C;AAED,wBAAgB,eAAe,IAAI,UAAU,CAE5C;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,UAAU,CAEpE;AAED,wBAAgB,cAAc,CAC5B,KAAK,EAAE,eAAe,EACtB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAChB,UAAU,CAsBZ;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,UAAU,CAE7D;AAED,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,OAAO,EACjB,OAAO,EAAE,OAAO,EAChB,QAAQ,UAAQ,GACf,UAAU,CAMZ;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,UAAU,CAElD;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAEpD;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,UAAU,CAE7D;AAKD,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,UAAU,EACpB,KAAK,EAAE,OAAO,GAAG,KAAK,EACtB,QAAQ,UAAQ,GACf,UAAU,CAYZ;AAED,wBAAgB,YAAY,IAAI,UAAU,CAEzC;AAED,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,OAAO,GAAG,UAAU,CAEjE;AA8BD,wBAAgB,SAAS,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,OAAO,GAAE,UAAe,GAAG,UAAU,CA4EjF"}
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,UAAU,EAAe,MAAM,YAAY,CAAC;AAEpF,wBAAgB,eAAe,IAAI,UAAU,CAE5C;AAED,wBAAgB,kBAAkB,IAAI,UAAU,CAE/C;AAED,wBAAgB,eAAe,IAAI,UAAU,CAE5C;AAED,wBAAgB,eAAe,IAAI,UAAU,CAE5C;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,UAAU,CAEpE;AAED,wBAAgB,cAAc,CAC5B,KAAK,EAAE,cAAc,EACrB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAChB,UAAU,CAsBZ;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,UAAU,CAE7D;AAED,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,OAAO,EACjB,OAAO,EAAE,OAAO,EAChB,QAAQ,UAAQ,GACf,UAAU,CAMZ;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,UAAU,CAElD;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAEpD;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,UAAU,CAE7D;AAKD,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,UAAU,EACpB,KAAK,EAAE,OAAO,GAAG,KAAK,EACtB,QAAQ,UAAQ,GACf,UAAU,CAYZ;AAED,wBAAgB,YAAY,IAAI,UAAU,CAEzC;AAED,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,OAAO,GAAG,UAAU,CAEjE;AA8BD,wBAAgB,SAAS,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,OAAO,GAAE,UAAe,GAAG,UAAU,CAkFjF"}

package/dist/protocol.js

@@ -1,5 +1,5 @@
 import { getRow, createBitmap } from '@mbtech-nl/bitmap';
-import {} from './types.js';
+import { packBits } from './pack-bits.js';
 export function buildInvalidate() {
     return new Uint8Array(200);
 }
@@ -28,7 +28,7 @@ export function buildPrintInfo(media, rowCount, pageIndex) {
     buf[3] = validFlags;
     buf[4] = mediaType;
     buf[5] = media.widthMm;
-    buf[6] = media.lengthMm;
+    buf[6] = media.heightMm ?? 0;
     // rowCount little-endian at bytes 7-8 (offsets 4-5 in param block)
     buf[7] = rowCount & 0xff;
     buf[8] = (rowCount >> 8) & 0xff;
@@ -128,11 +128,11 @@ export function encodeJob(pages, options = {}) {
         const marginDots = opts.marginDots ?? 35;
         const compress = opts.compress ?? false;
         const { bitmap, media } = page;
-        // twoColorTape media (e.g. DK-22251) requires two-color mode even for black-only jobs.
+        // Multi-ink media (e.g. DK-22251) requires two-color mode even for black-only jobs.
         // Auto-create an empty red plane when the tape demands it but caller didn't supply one.
-        const twoColor = page.redBitmap !== undefined || media.twoColorTape === true;
-        const redBitmap = page.redBitmap ??
-            (media.twoColorTape ? createBitmap(bitmap.widthPx, bitmap.heightPx) : undefined);
+        const multiInk = media.palette !== undefined;
+        const twoColor = page.redBitmap !== undefined || multiInk;
+        const redBitmap = page.redBitmap ?? (multiInk ? createBitmap(bitmap.widthPx, bitmap.heightPx) : undefined);
         if (twoColor && redBitmap !== undefined) {
             if (bitmap.widthPx !== redBitmap.widthPx || bitmap.heightPx !== redBitmap.heightPx) {
                 throw new Error('Two-color bitmaps must have identical dimensions');
@@ -154,16 +154,22 @@ export function encodeJob(pages, options = {}) {
         const rowByteLen = Math.ceil(totalPins / 8);
         // Rows interleaved per raster line (matches Python brother_ql behaviour).
         // Two-color: black row then red row for each line. Single-color: black only.
+        // When `compress` is on, each row's bytes are PackBits-encoded and the
+        // raster-row LEN byte carries the compressed length. The printer was
+        // already switched into compression mode by `buildCompression(true)`
+        // above, so it expects every subsequent row to be PackBits.
         for (let r = 0; r < rowCount; r++) {
             const blackSrc = getRow(bitmap, r);
             const blackBytes = new Uint8Array(rowByteLen);
             placeBits(blackSrc, bitmap.widthPx, blackBytes, media.leftMarginPins);
-            chunks.push(buildRasterRow(blackBytes, 'black', twoColor));
+            const blackPayload = compress ? packBits(blackBytes) : blackBytes;
+            chunks.push(buildRasterRow(blackPayload, 'black', twoColor));
             if (twoColor && redBitmap !== undefined) {
                 const redSrc = getRow(redBitmap, r);
                 const redBytes = new Uint8Array(rowByteLen);
                 placeBits(redSrc, redBitmap.widthPx, redBytes, media.leftMarginPins);
-                chunks.push(buildRasterRow(redBytes, 'red', twoColor));
+                const redPayload = compress ? packBits(redBytes) : redBytes;
+                chunks.push(buildRasterRow(redPayload, 'red', twoColor));
             }
         }
         chunks.push(buildPrintCommand(isLastPage));