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

package/src/preview.ts

@@ -1,24 +1,25 @@
-/* eslint-disable import-x/consistent-type-specifier-style */
-import { renderImage, type RawImageData } from '@mbtech-nl/bitmap';
+import { renderImage, renderMultiPlaneImage } from '@mbtech-nl/bitmap';
+import type { LabelBitmap, RawImageData } from '@mbtech-nl/bitmap';
 import type { PreviewResult } from '@thermal-label/contracts';
-import { splitTwoColor } from './colour.js';
-import { type BrotherQLMedia } from './types.js';
+import type { BrotherQLMedia } from './types.js';
 
 /**
  * Offline preview without a live printer connection.
  *
- * Two-colour aware: when `media.colorCapable` is true (DK-22251), the
- * image is split into a black and a red plane via `splitTwoColor()` —
- * exactly what `print()` does for that media. Single-colour media
- * returns one black plane.
+ * 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: RawImageData, media: BrotherQLMedia): PreviewResult {
-  if (media.colorCapable) {
-    const { black, red } = splitTwoColor(image);
+  if (media.palette) {
+    const planes = renderMultiPlaneImage(image, {
+      palette: media.palette,
+    }) as Record<'black' | 'red', LabelBitmap>;
     return {
       planes: [
-        { name: 'black', bitmap: black, displayColor: '#000000' },
-        { name: 'red', bitmap: red, displayColor: '#ff0000' },
+        { name: 'black', bitmap: planes.black, displayColor: '#000000' },
+        { name: 'red', bitmap: planes.red, displayColor: '#ff0000' },
       ],
       media,
       assumed: false,

package/src/protocol.ts

@@ -1,5 +1,6 @@
 import { getRow, createBitmap } from '@mbtech-nl/bitmap';
-import { type BrotherQLMedia, type PageData, type JobOptions, type PageOptions } from './types.js';
+import { packBits } from './pack-bits.js';
+import type { BrotherQLMedia, PageData, JobOptions, PageOptions } from './types.js';
 
 export function buildInvalidate(): Uint8Array {
   return new Uint8Array(200);
@@ -161,12 +162,12 @@ export function encodeJob(pages: PageData[], options: JobOptions = {}): Uint8Arr
     const compress = opts.compress ?? false;
     const { bitmap, media } = page;
 
-    // colorCapable 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.colorCapable;
+    const multiInk = media.palette !== undefined;
+    const twoColor = page.redBitmap !== undefined || multiInk;
     const redBitmap =
-      page.redBitmap ??
-      (media.colorCapable ? createBitmap(bitmap.widthPx, bitmap.heightPx) : undefined);
+      page.redBitmap ?? (multiInk ? createBitmap(bitmap.widthPx, bitmap.heightPx) : undefined);
 
     if (twoColor && redBitmap !== undefined) {
       if (bitmap.widthPx !== redBitmap.widthPx || bitmap.heightPx !== redBitmap.heightPx) {
@@ -192,17 +193,23 @@ export function encodeJob(pages: PageData[], options: JobOptions = {}): Uint8Arr
 
     // 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));
       }
     }
 

package/src/status.ts

@@ -1,6 +1,5 @@
-/* eslint-disable import-x/consistent-type-specifier-style */
 import type { PrinterError } from '@thermal-label/contracts';
-import { type BrotherQLStatus } from './types.js';
+import type { BrotherQLStatus } from './types.js';
 import { findMediaByDimensions } from './media.js';
 
 export const STATUS_REQUEST = new Uint8Array([0x1b, 0x69, 0x53]);

package/src/types.ts

@@ -1,6 +1,10 @@
-/* eslint-disable import-x/consistent-type-specifier-style */
-import { type LabelBitmap } from '@mbtech-nl/bitmap';
-import type { DeviceDescriptor, MediaDescriptor, PrinterStatus } from '@thermal-label/contracts';
+import type { LabelBitmap } from '@mbtech-nl/bitmap';
+import type {
+  DeviceDescriptor,
+  MediaDescriptor,
+  PrintOptions,
+  PrinterStatus,
+} from '@thermal-label/contracts';
 
 export type MediaType = 'continuous' | 'die-cut';
 export type HeadWidth = 720 | 1296;
@@ -39,13 +43,12 @@ export interface BrotherQLDevice extends DeviceDescriptor {
  * Brother QL media descriptor.
  *
  * Extends `MediaDescriptor` with the dots-based geometry the raster
- * encoder needs. `colorCapable: true` flips the driver into
- * two-colour mode — only DK-22251 has this set in the registry.
+ * encoder needs. The base `palette` field flips the driver into
+ * multi-plane mode — only DK-22251 declares one in the registry.
  */
 export interface BrotherQLMedia extends MediaDescriptor {
   id: number;
   type: MediaType;
-  colorCapable: boolean;
   printAreaDots: number;
   leftMarginPins: number;
   rightMarginPins: number;
@@ -80,3 +83,15 @@ export interface PageOptions {
 export interface JobOptions {
   copies?: number;
 }
+
+/**
+ * Per-call print options for `BrotherQLPrinter.print()`.
+ *
+ * Extends the cross-driver `PrintOptions` with QL-specific knobs. The
+ * `rotate` override picks the rotation angle passed to
+ * `renderImage` / `renderMultiPlaneImage` — `'auto'` (the default)
+ * defers to the media's `defaultOrientation` heuristic.
+ */
+export interface BrotherQLPrintOptions extends PrintOptions {
+  rotate?: 'auto' | 0 | 90 | 180 | 270;
+}

package/dist/__tests__/colour.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=colour.test.d.ts.map

package/dist/__tests__/colour.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"colour.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/colour.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/colour.test.js

@@ -1,106 +0,0 @@
-import { describe, expect, it } from 'vitest';
-import { getPixel } from '@mbtech-nl/bitmap';
-import { isRedish, splitTwoColor } from '../colour.js';
-function rgbaOf(width, height, [r, g, b, a]) {
-    const data = new Uint8Array(width * height * 4);
-    for (let i = 0; i < data.length; i += 4) {
-        data[i] = r;
-        data[i + 1] = g;
-        data[i + 2] = b;
-        data[i + 3] = a;
-    }
-    return { width, height, data };
-}
-function countInkPixels(bitmap) {
-    let n = 0;
-    for (let y = 0; y < bitmap.heightPx; y++) {
-        for (let x = 0; x < bitmap.widthPx; x++) {
-            if (getPixel(bitmap, x, y))
-                n++;
-        }
-    }
-    return n;
-}
-describe('isRedish', () => {
-    it('treats a strong red as red', () => {
-        expect(isRedish(255, 0, 0, 255)).toBe(true);
-    });
-    it('rejects red when green is too high (threshold g < 100)', () => {
-        expect(isRedish(255, 100, 0, 255)).toBe(false);
-        expect(isRedish(255, 99, 0, 255)).toBe(true);
-    });
-    it('rejects red when blue is too high (threshold b < 100)', () => {
-        expect(isRedish(255, 0, 100, 255)).toBe(false);
-        expect(isRedish(255, 0, 99, 255)).toBe(true);
-    });
-    it('rejects red when the red channel is too low (threshold r > 180)', () => {
-        expect(isRedish(180, 0, 0, 255)).toBe(false);
-        expect(isRedish(181, 0, 0, 255)).toBe(true);
-    });
-    it('rejects transparent pixels (alpha < 128)', () => {
-        expect(isRedish(255, 0, 0, 127)).toBe(false);
-        expect(isRedish(255, 0, 0, 128)).toBe(true);
-    });
-    it('rejects black (no red dominance)', () => {
-        expect(isRedish(0, 0, 0, 255)).toBe(false);
-    });
-    it('rejects white', () => {
-        expect(isRedish(255, 255, 255, 255)).toBe(false);
-    });
-});
-describe('splitTwoColor', () => {
-    it('routes a solid red image to the red plane, nothing to black', () => {
-        const { black, red } = splitTwoColor(rgbaOf(8, 8, [255, 0, 0, 255]));
-        expect(countInkPixels(red)).toBeGreaterThan(0);
-        expect(countInkPixels(black)).toBe(0);
-    });
-    it('routes a solid black image to the black plane, nothing to red', () => {
-        const { black, red } = splitTwoColor(rgbaOf(8, 8, [0, 0, 0, 255]));
-        expect(countInkPixels(black)).toBeGreaterThan(0);
-        expect(countInkPixels(red)).toBe(0);
-    });
-    it('produces bitmaps matching the source dimensions', () => {
-        const { black, red } = splitTwoColor(rgbaOf(16, 12, [128, 128, 128, 255]));
-        expect(black.widthPx).toBe(16);
-        expect(black.heightPx).toBe(12);
-        expect(red.widthPx).toBe(16);
-        expect(red.heightPx).toBe(12);
-    });
-    it('resolves overlapping bits in favour of black (red bit cleared)', () => {
-        // Construct a mixed image: one row red, one row black.
-        const data = new Uint8Array(8 * 2 * 4);
-        // Row 0: red
-        for (let i = 0; i < 8; i++) {
-            data[i * 4] = 255;
-            data[i * 4 + 3] = 255;
-        }
-        // Row 1: black
-        for (let i = 0; i < 8; i++) {
-            const offset = (8 + i) * 4;
-            data[offset] = 0;
-            data[offset + 1] = 0;
-            data[offset + 2] = 0;
-            data[offset + 3] = 255;
-        }
-        const image = { width: 8, height: 2, data };
-        const { black, red } = splitTwoColor(image);
-        // Every non-transparent pixel should land on exactly one plane —
-        // resolveOverlap guarantees no bit is set in both.
-        for (let y = 0; y < 2; y++) {
-            for (let x = 0; x < 8; x++) {
-                const inBlack = getPixel(black, x, y);
-                const inRed = getPixel(red, x, y);
-                expect(inBlack && inRed).toBe(false);
-            }
-        }
-    });
-    it('accepts custom threshold + dither options', () => {
-        const { black, red } = splitTwoColor(rgbaOf(4, 4, [0, 0, 0, 255]), {
-            threshold: 64,
-            dither: false,
-        });
-        expect(black.widthPx).toBe(4);
-        expect(red.widthPx).toBe(4);
-    });
-});
-//# sourceMappingURL=colour.test.js.map

package/dist/__tests__/colour.test.js.map

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

package/dist/colour.d.ts

@@ -1,26 +0,0 @@
-import { type LabelBitmap, type RawImageData } from '@mbtech-nl/bitmap';
-export interface TwoColorResult {
-    black: LabelBitmap;
-    red: LabelBitmap;
-}
-export interface TwoColorOptions {
-    threshold?: number;
-    dither?: boolean;
-}
-/**
- * A pixel is "red-ish" when the red channel clearly dominates and
- * alpha is opaque enough to matter. The thresholds come from testing
- * against DK-22251 output — wider tolerances let non-red warm tones
- * bleed into the red plane.
- */
-export declare function isRedish(r: number, g: number, b: number, a: number): boolean;
-/**
- * Split an RGBA image into black and red 1bpp planes for Brother QL
- * two-colour media (DK-22251).
- *
- * The rendering path matches `renderImage(image, { dither: true })`
- * used by `print()` for single-colour media, so overall print density
- * stays consistent regardless of media.
- */
-export declare function splitTwoColor(image: RawImageData, options?: TwoColorOptions): TwoColorResult;
-//# sourceMappingURL=colour.d.ts.map

package/dist/colour.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"colour.d.ts","sourceRoot":"","sources":["../src/colour.ts"],"names":[],"mappings":"AAQA,OAAO,EAAe,KAAK,WAAW,EAAE,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAErF,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,WAAW,CAAC;IACnB,GAAG,EAAE,WAAW,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAG5E;AAmDD;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,cAAc,CAY5F"}

package/dist/colour.js

@@ -1,84 +0,0 @@
-/* eslint-disable @typescript-eslint/no-non-null-assertion --
- *   Uint8Array indexed reads are typed `number | undefined` under
- *   `noUncheckedIndexedAccess`, but every index in this file is bounded
- *   by `src.length` (a multiple of 4) or `Math.min(a.length, b.length)`.
- *   The `!` assertions collapse the unreachable `undefined` branches so
- *   branch coverage doesn't count them. See also `non-nullable-type-
- *   assertion-style` which rules out the alternative `as number` form.
- */
-import { renderImage } from '@mbtech-nl/bitmap';
-/**
- * A pixel is "red-ish" when the red channel clearly dominates and
- * alpha is opaque enough to matter. The thresholds come from testing
- * against DK-22251 output — wider tolerances let non-red warm tones
- * bleed into the red plane.
- */
-export function isRedish(r, g, b, a) {
-    if (a < 128)
-        return false;
-    return r > 180 && g < 100 && b < 100;
-}
-function extractRedPixels(image) {
-    const src = image.data;
-    const dst = new Uint8Array(src.length);
-    for (let i = 0; i < src.length; i += 4) {
-        const r = src[i];
-        const g = src[i + 1];
-        const b = src[i + 2];
-        const a = src[i + 3];
-        if (isRedish(r, g, b, a)) {
-            dst[i] = r;
-            dst[i + 1] = g;
-            dst[i + 2] = b;
-            dst[i + 3] = a;
-        }
-    }
-    return { data: dst, width: image.width, height: image.height };
-}
-function extractNonRedPixels(image) {
-    const src = image.data;
-    const dst = new Uint8Array(src.length);
-    for (let i = 0; i < src.length; i += 4) {
-        const r = src[i];
-        const g = src[i + 1];
-        const b = src[i + 2];
-        const a = src[i + 3];
-        if (!isRedish(r, g, b, a)) {
-            dst[i] = r;
-            dst[i + 1] = g;
-            dst[i + 2] = b;
-            dst[i + 3] = a;
-        }
-    }
-    return { data: dst, width: image.width, height: image.height };
-}
-/**
- * Where both planes have a set bit at the same position, black wins.
- * Done by masking the red bits with the inverse of the black bits.
- */
-function resolveOverlap(black, red) {
-    const blackData = black.data;
-    const redData = red.data;
-    const len = Math.min(blackData.length, redData.length);
-    for (let i = 0; i < len; i++) {
-        redData[i] = redData[i] & ~blackData[i];
-    }
-}
-/**
- * Split an RGBA image into black and red 1bpp planes for Brother QL
- * two-colour media (DK-22251).
- *
- * The rendering path matches `renderImage(image, { dither: true })`
- * used by `print()` for single-colour media, so overall print density
- * stays consistent regardless of media.
- */
-export function splitTwoColor(image, options) {
-    const { threshold = 128, dither = true } = options ?? {};
-    const blackImage = extractNonRedPixels(image);
-    const redImage = extractRedPixels(image);
-    const black = renderImage(blackImage, { threshold, dither });
-    const red = renderImage(redImage, { threshold, dither });
-    resolveOverlap(black, red);
-    return { black, red };
-}
-//# sourceMappingURL=colour.js.map

package/dist/colour.js.map

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

package/src/__tests__/colour.test.ts

@@ -1,126 +0,0 @@
-import { describe, expect, it } from 'vitest';
-import { getPixel } from '@mbtech-nl/bitmap';
-import { isRedish, splitTwoColor } from '../colour.js';
-
-function rgbaOf(
-  width: number,
-  height: number,
-  [r, g, b, a]: [number, number, number, number],
-): {
-  width: number;
-  height: number;
-  data: Uint8Array;
-} {
-  const data = new Uint8Array(width * height * 4);
-  for (let i = 0; i < data.length; i += 4) {
-    data[i] = r;
-    data[i + 1] = g;
-    data[i + 2] = b;
-    data[i + 3] = a;
-  }
-  return { width, height, data };
-}
-
-function countInkPixels(bitmap: { widthPx: number; heightPx: number; data: Uint8Array }): number {
-  let n = 0;
-  for (let y = 0; y < bitmap.heightPx; y++) {
-    for (let x = 0; x < bitmap.widthPx; x++) {
-      if (getPixel(bitmap, x, y)) n++;
-    }
-  }
-  return n;
-}
-
-describe('isRedish', () => {
-  it('treats a strong red as red', () => {
-    expect(isRedish(255, 0, 0, 255)).toBe(true);
-  });
-
-  it('rejects red when green is too high (threshold g < 100)', () => {
-    expect(isRedish(255, 100, 0, 255)).toBe(false);
-    expect(isRedish(255, 99, 0, 255)).toBe(true);
-  });
-
-  it('rejects red when blue is too high (threshold b < 100)', () => {
-    expect(isRedish(255, 0, 100, 255)).toBe(false);
-    expect(isRedish(255, 0, 99, 255)).toBe(true);
-  });
-
-  it('rejects red when the red channel is too low (threshold r > 180)', () => {
-    expect(isRedish(180, 0, 0, 255)).toBe(false);
-    expect(isRedish(181, 0, 0, 255)).toBe(true);
-  });
-
-  it('rejects transparent pixels (alpha < 128)', () => {
-    expect(isRedish(255, 0, 0, 127)).toBe(false);
-    expect(isRedish(255, 0, 0, 128)).toBe(true);
-  });
-
-  it('rejects black (no red dominance)', () => {
-    expect(isRedish(0, 0, 0, 255)).toBe(false);
-  });
-
-  it('rejects white', () => {
-    expect(isRedish(255, 255, 255, 255)).toBe(false);
-  });
-});
-
-describe('splitTwoColor', () => {
-  it('routes a solid red image to the red plane, nothing to black', () => {
-    const { black, red } = splitTwoColor(rgbaOf(8, 8, [255, 0, 0, 255]));
-    expect(countInkPixels(red)).toBeGreaterThan(0);
-    expect(countInkPixels(black)).toBe(0);
-  });
-
-  it('routes a solid black image to the black plane, nothing to red', () => {
-    const { black, red } = splitTwoColor(rgbaOf(8, 8, [0, 0, 0, 255]));
-    expect(countInkPixels(black)).toBeGreaterThan(0);
-    expect(countInkPixels(red)).toBe(0);
-  });
-
-  it('produces bitmaps matching the source dimensions', () => {
-    const { black, red } = splitTwoColor(rgbaOf(16, 12, [128, 128, 128, 255]));
-    expect(black.widthPx).toBe(16);
-    expect(black.heightPx).toBe(12);
-    expect(red.widthPx).toBe(16);
-    expect(red.heightPx).toBe(12);
-  });
-
-  it('resolves overlapping bits in favour of black (red bit cleared)', () => {
-    // Construct a mixed image: one row red, one row black.
-    const data = new Uint8Array(8 * 2 * 4);
-    // Row 0: red
-    for (let i = 0; i < 8; i++) {
-      data[i * 4] = 255;
-      data[i * 4 + 3] = 255;
-    }
-    // Row 1: black
-    for (let i = 0; i < 8; i++) {
-      const offset = (8 + i) * 4;
-      data[offset] = 0;
-      data[offset + 1] = 0;
-      data[offset + 2] = 0;
-      data[offset + 3] = 255;
-    }
-    const image = { width: 8, height: 2, data };
-    const { black, red } = splitTwoColor(image);
-    // Every non-transparent pixel should land on exactly one plane —
-    // resolveOverlap guarantees no bit is set in both.
-    for (let y = 0; y < 2; y++) {
-      for (let x = 0; x < 8; x++) {
-        const inBlack = getPixel(black, x, y);
-        const inRed = getPixel(red, x, y);
-        expect(inBlack && inRed).toBe(false);
-      }
-    }
-  });
-
-  it('accepts custom threshold + dither options', () => {
-    const { black, red } = splitTwoColor(rgbaOf(4, 4, [0, 0, 0, 255]), {
-      threshold: 64,
-      dither: false,
-    });
-    expect(black.widthPx).toBe(4);
-    expect(red.widthPx).toBe(4);
-  });
-});

package/src/colour.ts

@@ -1,101 +0,0 @@
-/* eslint-disable @typescript-eslint/no-non-null-assertion --
- *   Uint8Array indexed reads are typed `number | undefined` under
- *   `noUncheckedIndexedAccess`, but every index in this file is bounded
- *   by `src.length` (a multiple of 4) or `Math.min(a.length, b.length)`.
- *   The `!` assertions collapse the unreachable `undefined` branches so
- *   branch coverage doesn't count them. See also `non-nullable-type-
- *   assertion-style` which rules out the alternative `as number` form.
- */
-import { renderImage, type LabelBitmap, type RawImageData } from '@mbtech-nl/bitmap';
-
-export interface TwoColorResult {
-  black: LabelBitmap;
-  red: LabelBitmap;
-}
-
-export interface TwoColorOptions {
-  threshold?: number;
-  dither?: boolean;
-}
-
-/**
- * A pixel is "red-ish" when the red channel clearly dominates and
- * alpha is opaque enough to matter. The thresholds come from testing
- * against DK-22251 output — wider tolerances let non-red warm tones
- * bleed into the red plane.
- */
-export function isRedish(r: number, g: number, b: number, a: number): boolean {
-  if (a < 128) return false;
-  return r > 180 && g < 100 && b < 100;
-}
-
-function extractRedPixels(image: RawImageData): RawImageData {
-  const src = image.data;
-  const dst = new Uint8Array(src.length);
-  for (let i = 0; i < src.length; i += 4) {
-    const r = src[i]!;
-    const g = src[i + 1]!;
-    const b = src[i + 2]!;
-    const a = src[i + 3]!;
-    if (isRedish(r, g, b, a)) {
-      dst[i] = r;
-      dst[i + 1] = g;
-      dst[i + 2] = b;
-      dst[i + 3] = a;
-    }
-  }
-  return { data: dst, width: image.width, height: image.height };
-}
-
-function extractNonRedPixels(image: RawImageData): RawImageData {
-  const src = image.data;
-  const dst = new Uint8Array(src.length);
-  for (let i = 0; i < src.length; i += 4) {
-    const r = src[i]!;
-    const g = src[i + 1]!;
-    const b = src[i + 2]!;
-    const a = src[i + 3]!;
-    if (!isRedish(r, g, b, a)) {
-      dst[i] = r;
-      dst[i + 1] = g;
-      dst[i + 2] = b;
-      dst[i + 3] = a;
-    }
-  }
-  return { data: dst, width: image.width, height: image.height };
-}
-
-/**
- * Where both planes have a set bit at the same position, black wins.
- * Done by masking the red bits with the inverse of the black bits.
- */
-function resolveOverlap(black: LabelBitmap, red: LabelBitmap): void {
-  const blackData = black.data;
-  const redData = red.data;
-  const len = Math.min(blackData.length, redData.length);
-  for (let i = 0; i < len; i++) {
-    redData[i] = redData[i]! & ~blackData[i]!;
-  }
-}
-
-/**
- * Split an RGBA image into black and red 1bpp planes for Brother QL
- * two-colour media (DK-22251).
- *
- * The rendering path matches `renderImage(image, { dither: true })`
- * used by `print()` for single-colour media, so overall print density
- * stays consistent regardless of media.
- */
-export function splitTwoColor(image: RawImageData, options?: TwoColorOptions): TwoColorResult {
-  const { threshold = 128, dither = true } = options ?? {};
-
-  const blackImage = extractNonRedPixels(image);
-  const redImage = extractRedPixels(image);
-
-  const black = renderImage(blackImage, { threshold, dither });
-  const red = renderImage(redImage, { threshold, dither });
-
-  resolveOverlap(black, red);
-
-  return { black, red };
-}