@thermal-label/brother-ql-core 0.6.1 → 0.6.2

package/dist/types.d.ts

@@ -98,7 +98,11 @@ export interface BrotherQLMedia extends MediaDescriptor {
     printableDots?: number;
     leftMarginPins?: number;
     rightMarginPins?: number;
-    /** Die-cut masked area in dots (registration windows). */
+    /**
+     * Die-cut page length in dots at 300 dpi: the reference's "print area
+     * length" (§2.3.2(b) column 4). The encoder sends exactly this many
+     * rows for die-cut media; see DECISIONS D20.
+     */
     dieCutMaskedAreaDots?: number;
 }
 /**

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EACV,WAAW,EACX,eAAe,EACf,uBAAuB,EACvB,YAAY,EACZ,aAAa,EACd,MAAM,0BAA0B,CAAC;AAElC,MAAM,MAAM,SAAS,GAAG,YAAY,GAAG,SAAS,CAAC;AACjD,MAAM,MAAM,SAAS,GAAG,GAAG,GAAG,IAAI,CAAC;AACnC,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,WAAW,CAAC;AAE/C;;;;;;GAMG;AACH,MAAM,MAAM,UAAU,GAAG,IAAI,GAAG,KAAK,GAAG,UAAU,GAAG,UAAU,CAAC;AAEhE;;;;;;;;;GASG;AACH,MAAM,WAAW,YAAY;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,yBAA0B,SAAQ,uBAAuB;IACxE,kEAAkE;IAClE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,GAAG,GAAG,GAAG,CAAC;CACxB;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,eAAe,GAAG,WAAW,CAAC;AAE1C;;;;;;GAMG;AACH,MAAM,WAAW,cAAe,SAAQ,eAAe;IACrD,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,SAAS,CAAC;IAChB;;;;OAIG;IACH,UAAU,EAAE,UAAU,CAAC;IACvB;;;;;;;;OAQG;IACH,QAAQ,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,YAAY,CAAC;QAAC,IAAI,CAAC,EAAE,YAAY,CAAA;KAAE,CAAC;IAC1D,uEAAuE;IACvE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,0DAA0D;IAC1D,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;;;GAIG;AACH,MAAM,MAAM,eAAe,GAAG,aAAa,CAAC;AAE5C,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,WAAW,CAAC;IACpB,SAAS,CAAC,EAAE,WAAW,CAAC;IACxB,KAAK,EAAE,cAAc,CAAC;IACtB,OAAO,CAAC,EAAE,WAAW,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,qBAAsB,SAAQ,YAAY;IACzD,MAAM,CAAC,EAAE,MAAM,GAAG,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,GAAG,CAAC;IACrC;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EACV,WAAW,EACX,eAAe,EACf,uBAAuB,EACvB,YAAY,EACZ,aAAa,EACd,MAAM,0BAA0B,CAAC;AAElC,MAAM,MAAM,SAAS,GAAG,YAAY,GAAG,SAAS,CAAC;AACjD,MAAM,MAAM,SAAS,GAAG,GAAG,GAAG,IAAI,CAAC;AACnC,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,WAAW,CAAC;AAE/C;;;;;;GAMG;AACH,MAAM,MAAM,UAAU,GAAG,IAAI,GAAG,KAAK,GAAG,UAAU,GAAG,UAAU,CAAC;AAEhE;;;;;;;;;GASG;AACH,MAAM,WAAW,YAAY;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,yBAA0B,SAAQ,uBAAuB;IACxE,kEAAkE;IAClE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,GAAG,GAAG,GAAG,CAAC;CACxB;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,eAAe,GAAG,WAAW,CAAC;AAE1C;;;;;;GAMG;AACH,MAAM,WAAW,cAAe,SAAQ,eAAe;IACrD,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,SAAS,CAAC;IAChB;;;;OAIG;IACH,UAAU,EAAE,UAAU,CAAC;IACvB;;;;;;;;OAQG;IACH,QAAQ,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,YAAY,CAAC;QAAC,IAAI,CAAC,EAAE,YAAY,CAAA;KAAE,CAAC;IAC1D,uEAAuE;IACvE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;;;GAIG;AACH,MAAM,MAAM,eAAe,GAAG,aAAa,CAAC;AAE5C,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,WAAW,CAAC;IACpB,SAAS,CAAC,EAAE,WAAW,CAAC;IACxB,KAAK,EAAE,cAAc,CAAC;IACtB,OAAO,CAAC,EAAE,WAAW,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,qBAAsB,SAAQ,YAAY;IACzD,MAAM,CAAC,EAAE,MAAM,GAAG,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,GAAG,CAAC;IACrC;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thermal-label/brother-ql-core",
-  "version": "0.6.1",
+  "version": "0.6.2",
   "description": "Protocol encoding, device registry, and media registry for Brother QL label printers",
   "keywords": [
     "brother",
@@ -56,7 +56,7 @@
   },
   "dependencies": {
     "@mbtech-nl/bitmap": "^1.3.0",
-    "@thermal-label/contracts": "^0.6.0"
+    "@thermal-label/contracts": "^0.6.2"
   },
   "devDependencies": {
     "@mbtech-nl/tsconfig": "^1.1.0",

package/src/__tests__/devices.test.ts

@@ -1,5 +1,5 @@
 import { describe, it, expect } from 'vitest';
-import { DEVICES, findDevice, getUsbIds, isMassStorageMode } from '../devices.js';
+import { DEVICES, findDevice } from '../devices.js';
 
 describe('findDevice', () => {
   it('returns correct entry for QL-820NWBc (PID shared with QL-820NWB)', () => {
@@ -33,27 +33,6 @@ describe('findDevice', () => {
   });
 });
 
-describe('isMassStorageMode', () => {
-  it('returns true for 0x20a9 (QL-1100 mass storage)', () => {
-    expect(isMassStorageMode(0x20a9)).toBe(true);
-  });
-
-  it('returns true for 0x20aa (QL-1110NWB mass storage)', () => {
-    expect(isMassStorageMode(0x20aa)).toBe(true);
-  });
-
-  it('returns true for 0x20ac (QL-1115NWB mass storage)', () => {
-    expect(isMassStorageMode(0x20ac)).toBe(true);
-  });
-
-  it('returns false for all printer-class PIDs', () => {
-    for (const dev of Object.values(DEVICES)) {
-      const ids = getUsbIds(dev);
-      if (ids) expect(isMassStorageMode(ids.pid)).toBe(false);
-    }
-  });
-});
-
 describe('Device registry invariants', () => {
   it('every two-color device has a 720-dot engine', () => {
     for (const dev of Object.values(DEVICES)) {
@@ -77,6 +56,18 @@ describe('Device registry invariants', () => {
     }
   });
 
+  it('modelNames, where set, includes the marketing name and only distinct wire names', () => {
+    for (const dev of Object.values(DEVICES)) {
+      if (dev.modelNames === undefined) continue;
+      expect(dev.modelNames).toContain(dev.name);
+      expect(new Set(dev.modelNames).size).toBe(dev.modelNames.length);
+    }
+  });
+
+  it('QL-820NWBc reports itself as QL-820NWB on the wire', () => {
+    expect(DEVICES.QL_820NWBc.modelNames).toEqual(['QL-820NWB', 'QL-820NWBc']);
+  });
+
   it('every device declares a USB transport with hex-string vid+pid', () => {
     for (const dev of Object.values(DEVICES)) {
       expect(dev.transports.usb).toBeDefined();
@@ -164,7 +155,6 @@ describe('PT-* device entries', () => {
     const dev = DEVICES.PT_P750W;
     expect(dev.transports.usb?.pid).toBe('0x2062');
     expect(dev.capabilities?.massStoragePid).toBe('0x2065');
-    expect(isMassStorageMode(0x2065)).toBe(true);
   });
 
   it('PT-P910BT declares bluetooth-spp transport', () => {

package/src/__tests__/network-status.test.ts

@@ -0,0 +1,165 @@
+import { describe, it, expect } from 'vitest';
+import { parseMediaName, statusFromPrinterMib, type PrinterMibStatus } from '../network-status.js';
+
+/** Bench values, QL-820NWBc 2026-09-15 (plan 17 Context). */
+const DK_11201_NAME = '29mm x 90mm / 1.1" x 3.5"';
+const DK_22205_NAME = '62mm / 2.4"';
+
+function mib(overrides: Partial<PrinterMibStatus> = {}): PrinterMibStatus {
+  return {
+    printerStatus: 3,
+    errorState: new Uint8Array([0x00]),
+    mediaName: DK_22205_NAME,
+    feedDir: -1,
+    xFeedDir: -1,
+    ...overrides,
+  };
+}
+
+/** Octets with the given RFC 2790 bit numbers set (bit 0 = MSB of octet 0). */
+function errorBits(...bits: number[]): Uint8Array {
+  const octets = new Uint8Array(2);
+  for (const bit of bits) octets[bit >> 3] = (octets[bit >> 3] ?? 0) | (0x80 >> (bit & 7));
+  return octets;
+}
+
+describe('parseMediaName', () => {
+  it.each([
+    [DK_11201_NAME, { widthMm: 29, heightMm: 90 }],
+    [DK_22205_NAME, { widthMm: 62 }],
+    ['17mm x 54mm / 0.66" x 2.1"', { widthMm: 17, heightMm: 54 }],
+    ['62mm', { widthMm: 62 }],
+    ['24mm Dia / 0.9" Dia', { widthMm: 24, heightMm: 24 }],
+    ['29 mm × 90 mm', { widthMm: 29, heightMm: 90 }],
+  ])('%s', (name, expected) => {
+    expect(parseMediaName(name)).toEqual(expected);
+  });
+
+  it.each(['', 'garbage', '2.4"', 'mm', '62 / 2.4"', 'Roll 62'])('rejects %j', name => {
+    expect(parseMediaName(name)).toBeUndefined();
+  });
+});
+
+describe('statusFromPrinterMib', () => {
+  it('idle, no errors, 62 mm continuous → ready with DK-22205 and the two-colour warning', () => {
+    const status = statusFromPrinterMib(mib());
+    expect(status.ready).toBe(true);
+    expect(status.errors).toEqual([]);
+    expect(status.mediaLoaded).toBe(true);
+    expect(status.detectedMedia?.id).toBe(259);
+    expect(status.rawBytes).toHaveLength(0);
+    expect(status.details).toContainEqual({
+      label: 'Two-colour',
+      value: 'not detectable over network',
+      severity: 'warn',
+    });
+    expect(status.details?.find(d => d.label === 'Printer state')?.value).toBe('idle');
+  });
+
+  it('29×90 die-cut → DK-11201, no two-colour row', () => {
+    const status = statusFromPrinterMib(mib({ mediaName: DK_11201_NAME }));
+    expect(status.detectedMedia?.id).toBe(271);
+    expect(status.details?.some(d => d.label === 'Two-colour')).toBe(false);
+  });
+
+  it('printing counts as ready; warmup, other and unknown do not', () => {
+    expect(statusFromPrinterMib(mib({ printerStatus: 4 })).ready).toBe(true);
+    expect(statusFromPrinterMib(mib({ printerStatus: 5 })).ready).toBe(false);
+    expect(statusFromPrinterMib(mib({ printerStatus: 1 })).ready).toBe(false);
+    expect(statusFromPrinterMib(mib({ printerStatus: 99 })).ready).toBe(false);
+    expect(
+      statusFromPrinterMib(mib({ printerStatus: 99 })).details?.find(
+        d => d.label === 'Printer state',
+      )?.value,
+    ).toBe('unknown');
+  });
+
+  it.each([
+    [1, 'no_media', 'No media'],
+    [4, 'cover_open', 'Cover open'],
+    [5, 'cutter_jam', 'Jammed'],
+    [6, 'not_ready', 'Offline'],
+    [7, 'system_error', 'Service requested'],
+    [13, 'no_media', 'Input tray empty'],
+    [8, 'system_error', 'inputTrayMissing'],
+    [14, 'system_error', 'overduePreventMaint'],
+  ])('error-state bit %i → %s', (bit, code, message) => {
+    const status = statusFromPrinterMib(mib({ errorState: errorBits(bit) }));
+    expect(status.errors).toEqual([{ code, message }]);
+    expect(status.ready).toBe(false);
+  });
+
+  it('lowPaper is a warning row, not an error', () => {
+    const status = statusFromPrinterMib(mib({ errorState: errorBits(0) }));
+    expect(status.errors).toEqual([]);
+    expect(status.ready).toBe(true);
+    expect(status.details).toContainEqual({ label: 'Media', value: 'Media low', severity: 'warn' });
+  });
+
+  it('reads error state from 0, 1 and 2 octets', () => {
+    expect(statusFromPrinterMib(mib({ errorState: new Uint8Array(0) })).errors).toEqual([]);
+    expect(statusFromPrinterMib(mib({ errorState: new Uint8Array([0x08]) })).errors).toEqual([
+      { code: 'cover_open', message: 'Cover open' },
+    ]);
+    expect(statusFromPrinterMib(mib({ errorState: new Uint8Array([0x00, 0x04]) })).errors).toEqual([
+      { code: 'no_media', message: 'Input tray empty' },
+    ]);
+  });
+
+  it('the name wins over Dim OIDs (bench: unit 4 claimed, 1/100 mm sent)', () => {
+    const status = statusFromPrinterMib(
+      mib({ mediaName: DK_11201_NAME, xFeedDir: 2900, feedDir: 9000, dimUnit: 4 }),
+    );
+    expect(status.detectedMedia?.id).toBe(271);
+  });
+
+  it('falls back to Dim OIDs in ten-thousandths of an inch (unit 3)', () => {
+    // 29 mm = 11417, 90 mm = 35433 ten-thousandths of an inch.
+    const status = statusFromPrinterMib(
+      mib({ mediaName: 'nonsense', xFeedDir: 11417, feedDir: 35433, dimUnit: 3 }),
+    );
+    expect(status.detectedMedia?.id).toBe(271);
+  });
+
+  it('falls back to Dim OIDs in micrometres (unit 4)', () => {
+    const status = statusFromPrinterMib(
+      mib({ mediaName: 'nonsense', xFeedDir: 62000, feedDir: -1, dimUnit: 4 }),
+    );
+    expect(status.detectedMedia?.id).toBe(259);
+  });
+
+  it('no media when the name is unparseable and the Dim OIDs are negative or unitless', () => {
+    expect(
+      statusFromPrinterMib(mib({ mediaName: 'nonsense', xFeedDir: -1, feedDir: -1, dimUnit: 3 }))
+        .detectedMedia,
+    ).toBeUndefined();
+    expect(
+      statusFromPrinterMib(mib({ mediaName: 'nonsense', xFeedDir: 11417, feedDir: 35433 }))
+        .detectedMedia,
+    ).toBeUndefined();
+    // RFC 3805 only defines 3 and 4; anything else is not converted.
+    expect(
+      statusFromPrinterMib(
+        mib({ mediaName: 'nonsense', xFeedDir: 11417, feedDir: 35433, dimUnit: 1 }),
+      ).detectedMedia,
+    ).toBeUndefined();
+  });
+
+  it('unrecognised media name → no media, warn row with the raw string', () => {
+    const status = statusFromPrinterMib(mib({ mediaName: 'Roll 62' }));
+    expect(status.mediaLoaded).toBe(false);
+    expect(status.detectedMedia).toBeUndefined();
+    expect(status.details).toContainEqual({
+      label: 'Media',
+      value: 'not recognised: "Roll 62"',
+      severity: 'warn',
+    });
+    expect(status.ready).toBe(true);
+  });
+
+  it('a recognised size with no registry entry → warn row, no media', () => {
+    const status = statusFromPrinterMib(mib({ mediaName: '99mm x 99mm / x' }));
+    expect(status.detectedMedia).toBeUndefined();
+    expect(status.details?.some(d => d.value.startsWith('not recognised'))).toBe(true);
+  });
+});

package/src/__tests__/protocol.test.ts

@@ -1,5 +1,5 @@
 import { describe, it, expect } from 'vitest';
-import { createBitmap } from '@mbtech-nl/bitmap';
+import { createBitmap, type LabelBitmap } from '@mbtech-nl/bitmap';
 import {
   buildInvalidate,
   buildInitialize,
@@ -16,7 +16,7 @@ import {
   encodeJobForEngine,
   type EncoderEngine,
 } from '../protocol.js';
-import type { PageData } from '../types.js';
+import type { BrotherQLMedia, PageData } from '../types.js';
 import { MEDIA } from '../media.js';
 
 describe('buildInvalidate', () => {
@@ -494,3 +494,130 @@ describe('encodeJob legacy entry point — back compat', () => {
     expect(out[204]).toBe(0x1b);
   });
 });
+
+describe('die-cut page length (reference §2.3.2(b), §2.3.3, §2.3.4)', () => {
+  const DK_29X90 = MEDIA[271]!; // print area length 991 dots
+  const DK_62MM = MEDIA[259]!;
+  const QL_ENGINE: EncoderEngine = {
+    protocol: 'ql-raster',
+    headDots: 720,
+    capabilities: { autocut: true, mediaDetection: true },
+  };
+
+  /** Bitmap with every pixel of one row set, so the row is recognisable on the wire. */
+  function bitmapWithBlackRow(widthPx: number, heightPx: number, row: number): LabelBitmap {
+    const bitmap = createBitmap(widthPx, heightPx);
+    const bytesPerRow = Math.ceil(widthPx / 8);
+    bitmap.data.fill(0xff, row * bytesPerRow, (row + 1) * bytesPerRow);
+    return bitmap;
+  }
+
+  function findCmd(buf: Uint8Array, third: number): number {
+    for (let i = 0; i < buf.length - 4; i++) {
+      if (buf[i] === 0x1b && buf[i + 1] === 0x69 && buf[i + 2] === third) return i;
+    }
+    return -1;
+  }
+  const rasterNumber = (buf: Uint8Array): number => {
+    const i = findCmd(buf, 0x7a);
+    return (buf[i + 7] ?? 0) | ((buf[i + 8] ?? 0) << 8);
+  };
+  const marginDots = (buf: Uint8Array): number => {
+    const i = findCmd(buf, 0x64);
+    return (buf[i + 3] ?? 0) | ((buf[i + 4] ?? 0) << 8);
+  };
+  /** Raster rows as [opcode, colour, payload] triples, in wire order. */
+  function rasterRows(buf: Uint8Array): { op: number; color: number; payload: Uint8Array }[] {
+    const rows = [];
+    // Rows start after ESC i d (5 bytes) and run until the print command.
+    let i = findCmd(buf, 0x64) + 5;
+    while (i < buf.length && (buf[i] === 0x67 || buf[i] === 0x77)) {
+      const len = buf[i + 2] ?? 0;
+      rows.push({ op: buf[i]!, color: buf[i + 1]!, payload: buf.subarray(i + 3, i + 3 + len) });
+      i += 3 + len;
+    }
+    return rows;
+  }
+
+  it('sends the print-area length as the raster number and margin 0 on DK-11201', () => {
+    const bitmap = createBitmap(306, 608);
+    const out = encodeJobForEngine([{ bitmap, media: DK_29X90 }], {}, QL_ENGINE);
+    expect(rasterNumber(out)).toBe(991);
+    expect(marginDots(out)).toBe(0);
+    expect(rasterRows(out)).toHaveLength(991);
+  });
+
+  it('ignores marginDots on die-cut media', () => {
+    const bitmap = createBitmap(306, 10);
+    const out = encodeJobForEngine(
+      [{ bitmap, media: DK_29X90, options: { marginDots: 100 } }],
+      {},
+      QL_ENGINE,
+    );
+    expect(marginDots(out)).toBe(0);
+  });
+
+  it('centres the bitmap in the page', () => {
+    const bitmap = bitmapWithBlackRow(306, 3, 1);
+    const out = encodeJobForEngine([{ bitmap, media: DK_29X90 }], {}, QL_ENGINE);
+    const rows = rasterRows(out);
+    const black = rows.map((r, i) => (r.payload.some(b => b !== 0) ? i : -1)).filter(i => i >= 0);
+    // padTop = floor((991 - 3) / 2) = 494; the black row is bitmap row 1.
+    expect(black).toEqual([495]);
+  });
+
+  it('doubles the page length when QL high-res rows are supplied', () => {
+    const bitmap = createBitmap(306, 100);
+    const out = encodeJob([{ bitmap, media: DK_29X90, options: { highResolution: true } }]);
+    expect(rasterNumber(out)).toBe(1982);
+    expect(rasterRows(out)).toHaveLength(1982);
+    expect(marginDots(out)).toBe(0);
+  });
+
+  it('rejects a bitmap taller than the page, naming both numbers', () => {
+    const bitmap = createBitmap(306, 1200);
+    expect(() => encodeJobForEngine([{ bitmap, media: DK_29X90 }], {}, QL_ENGINE)).toThrow(
+      /1200 rows.*exactly 991/,
+    );
+  });
+
+  it('pads both planes alike on two-colour die-cut', () => {
+    const bitmap = bitmapWithBlackRow(306, 3, 1);
+    const redBitmap = bitmapWithBlackRow(306, 3, 1);
+    const out = encodeJobForEngine([{ bitmap, redBitmap, media: DK_29X90 }], {}, QL_ENGINE);
+    const rows = rasterRows(out);
+    expect(rows).toHaveLength(991 * 2);
+    const inked = rows
+      .map((r, i) => (r.payload.some(b => b !== 0) ? { i, color: r.color } : undefined))
+      .filter(r => r !== undefined);
+    expect(inked).toEqual([
+      { i: 495 * 2, color: 0x01 },
+      { i: 495 * 2 + 1, color: 0x02 },
+    ]);
+  });
+
+  it('throws when a die-cut entry lacks dieCutMaskedAreaDots', () => {
+    const media: BrotherQLMedia = { ...DK_29X90 };
+    delete media.dieCutMaskedAreaDots;
+    const bitmap = createBitmap(306, 10);
+    expect(() => encodeJobForEngine([{ bitmap, media }], {}, QL_ENGINE)).toThrow(
+      /dieCutMaskedAreaDots/,
+    );
+  });
+
+  it('leaves the continuous path byte-identical', async () => {
+    const { createHash } = await import('node:crypto');
+    const bitmap = bitmapWithBlackRow(696, 40, 7);
+    const out = encodeJobForEngine(
+      [{ bitmap, media: DK_62MM, options: { marginDots: 50 } }],
+      { copies: 2 },
+      QL_ENGINE,
+    );
+    expect(rasterNumber(out)).toBe(40);
+    expect(marginDots(out)).toBe(50);
+    // Digest recorded from the encoder before die-cut padding existed.
+    expect(createHash('sha256').update(out).digest('hex')).toBe(
+      'ebc2b5f467faca133f0f72c6f3123671d4e4dc130f2dd8cad8d9a69fa50e95fc',
+    );
+  });
+});

package/src/__tests__/status.test.ts

@@ -18,7 +18,8 @@ function makeStatusBytes(
   bytes[0] = 0x80;
   bytes[1] = 0x20;
   bytes[2] = 0x42;
-  bytes[3] = 0x30;
+  bytes[3] = 0x34;
+  bytes[4] = 0x41;
   bytes[8] = overrides?.errInfo1 ?? 0;
   bytes[9] = overrides?.errInfo2 ?? 0;
   bytes[10] = overrides?.mediaWidthMm ?? 62;
@@ -150,6 +151,18 @@ describe('parseStatus', () => {
 });
 
 describe('parseStatus — details[]', () => {
+  it('model-code row renders bytes 3/4 as ASCII (4A = QL-820NWB capture)', () => {
+    const status = parseStatus(CAPTURE_DK_22205);
+    expect(status.details?.[0]).toEqual({ label: 'Model code', value: '4A' });
+  });
+
+  it('model-code row falls back to hex for unprintable bytes', () => {
+    const bytes = makeStatusBytes();
+    bytes[3] = 0x00;
+    bytes[4] = 0x41;
+    expect(parseStatus(bytes).details?.[0]?.value).toBe('0x00 0x41');
+  });
+
   it('always emits a Print phase row', () => {
     const status = parseStatus(makeStatusBytes());
     expect(status.details).toBeDefined();
@@ -196,6 +209,7 @@ describe('parseStatus — details[]', () => {
   it('details carries both phase and cooling rows while printing + cooling', () => {
     const status = parseStatus(makeStatusBytes({ phaseType: 0x01, notification: 0x03 }));
     expect(status.details).toEqual([
+      { label: 'Model code', value: '4A' },
       { label: 'Print phase', value: 'printing' },
       { label: 'Head cooling', value: 'cooling started', severity: 'warn' },
     ]);

package/src/devices.generated.ts

@@ -838,6 +838,10 @@ export const REGISTRY = {
     {
       "key": "QL_820NWBc",
       "name": "QL-820NWBc",
+      "modelNames": [
+        "QL-820NWB",
+        "QL-820NWBc"
+      ],
       "family": "brother-ql",
       "transports": {
         "usb": {

package/src/devices.ts

@@ -6,18 +6,6 @@ import { DEVICES, REGISTRY } from './devices.generated.js';
 // labelwriter-aligned `REGISTRY` symbol.
 export const DEVICE_REGISTRY = REGISTRY;
 
-// Mass-storage PIDs aligned to Linux usb-ids (gowdy.us / linux-usb.org).
-// Each large-format printer with Editor Lite enumerates as USB Mass
-// Storage Class on this alternate PID until the user holds the Editor
-// Lite button to switch back to printer-class. Aggregated from each
-// device entry's `capabilities.massStoragePid`.
-const MASS_STORAGE_PIDS = new Set<number>(
-  Object.values(DEVICES).flatMap(d => {
-    const pid = d.capabilities?.massStoragePid;
-    return typeof pid === 'string' ? [parseInt(pid, 16)] : [];
-  }),
-);
-
 export { DEVICES };
 
 /**
@@ -39,7 +27,3 @@ export function findDevice(vid: number, pid: number): BrotherQLDevice | undefine
     return ids?.vid === vid && ids.pid === pid;
   });
 }
-
-export function isMassStorageMode(pid: number): boolean {
-  return MASS_STORAGE_PIDS.has(pid);
-}

package/src/index.ts

@@ -33,7 +33,7 @@ export {
   UnsupportedOperationError,
 } from '@thermal-label/contracts';
 
-export { DEVICE_REGISTRY, DEVICES, findDevice, getUsbIds, isMassStorageMode } from './devices.js';
+export { DEVICE_REGISTRY, DEVICES, findDevice, getUsbIds } from './devices.js';
 
 /**
  * Protocols this core's encoder produces correct wire bytes for.
@@ -63,6 +63,8 @@ export {
 } from './protocol.js';
 export type { EncoderEngine, RasterProtocolConfig } from './protocol.js';
 export { parseStatus, STATUS_REQUEST } from './status.js';
+export { hasTwoColourSibling, parseMediaName, statusFromPrinterMib } from './network-status.js';
+export type { PrinterMibStatus } from './network-status.js';
 export { createPreviewOffline } from './preview.js';
 
 export type {

package/src/network-status.ts

@@ -0,0 +1,173 @@
+import type { PrintEngine, PrinterError, StatusDetail } from '@thermal-label/contracts';
+import type { BrotherQLMedia, BrotherQLStatus } from './types.js';
+import { findMediaByDimensions, MEDIA } from './media.js';
+
+/**
+ * Values read from the standard Printer-MIB / Host-Resources-MIB
+ * (RFC 3805 / RFC 2790) of a network print server. Port 9100 carries
+ * no status, so this is the only status source on TCP; see plan 17.
+ */
+export interface PrinterMibStatus {
+  /** hrPrinterStatus: 1 other, 2 unknown, 3 idle, 4 printing, 5 warmup. */
+  printerStatus: number;
+  /** hrPrinterDetectedErrorState: 0–2 octets, bit 0 = MSB of octet 0. */
+  errorState: Uint8Array;
+  /** prtInputMediaName, e.g. `29mm x 90mm / 1.1" x 3.5"` or `62mm / 2.4"`. */
+  mediaName: string;
+  /** prtInputMediaDimFeedDir (length) / XFeedDir (width) in `dimUnit`; negative = unknown. */
+  feedDir?: number;
+  xFeedDir?: number;
+  /** prtInputDimUnit: 3 = ten-thousandths of an inch, 4 = micrometres. */
+  dimUnit?: number;
+}
+
+const PRINTER_STATE: Record<number, string> = {
+  1: 'other',
+  2: 'unknown',
+  3: 'idle',
+  4: 'printing',
+  5: 'warmup',
+};
+
+/** RFC 2790 hrPrinterDetectedErrorState bit names, index = bit. */
+const ERROR_STATE_BITS = [
+  'lowPaper',
+  'noPaper',
+  'lowToner',
+  'noToner',
+  'doorOpen',
+  'jammed',
+  'offline',
+  'serviceRequested',
+  'inputTrayMissing',
+  'outputTrayMissing',
+  'markerSupplyMissing',
+  'outputNearFull',
+  'outputFull',
+  'inputTrayEmpty',
+  'overduePreventMaint',
+] as const;
+
+/** Bit → contracts error code + message; unlisted set bits become `system_error`. */
+const ERROR_STATE_CODES: Record<number, { code: string; message: string }> = {
+  1: { code: 'no_media', message: 'No media' },
+  4: { code: 'cover_open', message: 'Cover open' },
+  5: { code: 'cutter_jam', message: 'Jammed' },
+  6: { code: 'not_ready', message: 'Offline' },
+  7: { code: 'system_error', message: 'Service requested' },
+  13: { code: 'no_media', message: 'Input tray empty' },
+};
+
+/** Warning-only bits: reported as a details row, never an error. */
+const ERROR_STATE_WARNINGS: Record<number, string> = {
+  0: 'Media low',
+};
+
+function errorStateBit(errorState: Uint8Array, bit: number): boolean {
+  const octet = errorState[bit >> 3];
+  return octet !== undefined && (octet & (0x80 >> (bit & 7))) !== 0;
+}
+
+/**
+ * Parse the metric half of a Brother `prtInputMediaName`.
+ * `"29mm x 90mm / …"` → 29×90 die-cut, `"62mm / …"` → 62 continuous.
+ * The `Dia` form is the reference's naming for round labels and is
+ * unverified on the wire. Anything else → `undefined`.
+ */
+export function parseMediaName(name: string): { widthMm: number; heightMm?: number } | undefined {
+  const metric = name.split('/')[0] ?? '';
+  const m = /^\s*(\d+(?:\.\d+)?)\s*mm(?:\s*(?:[x×]\s*(\d+(?:\.\d+)?)\s*mm|(dia)))?\s*$/i.exec(
+    metric,
+  );
+  if (!m?.[1]) return undefined;
+  const widthMm = Number(m[1]);
+  if (m[3]) return { widthMm, heightMm: widthMm };
+  return m[2] === undefined ? { widthMm } : { widthMm, heightMm: Number(m[2]) };
+}
+
+function dimToMm(value: number, unit: number): number | undefined {
+  if (unit === 3) return Math.round(value * 0.00254);
+  if (unit === 4) return Math.round(value / 1000);
+  return undefined;
+}
+
+/**
+ * The name string wins; the Dim OIDs are the fallback. Bench
+ * (QL-820NWB, DK-11201): `prtInputDimUnit` = 4 (micrometres) with
+ * `2900 × 9000`, which is 1/100 mm, so trusting the unit yields a
+ * 3 × 9 mm label. The name is the only value measured to be right.
+ */
+function resolveDimensions(
+  input: PrinterMibStatus,
+): { widthMm: number; heightMm: number } | undefined {
+  const parsed = parseMediaName(input.mediaName);
+  if (parsed) return { widthMm: parsed.widthMm, heightMm: parsed.heightMm ?? 0 };
+  const { xFeedDir, feedDir, dimUnit } = input;
+  if (xFeedDir === undefined || xFeedDir < 0 || dimUnit === undefined) return undefined;
+  const widthMm = dimToMm(xFeedDir, dimUnit);
+  if (widthMm === undefined) return undefined;
+  const heightMm = feedDir !== undefined && feedDir >= 0 ? dimToMm(feedDir, dimUnit) : 0;
+  return { widthMm, heightMm: heightMm ?? 0 };
+}
+
+/**
+ * Whether a roll of this width and type also exists as a two-colour
+ * variant (62 mm continuous: DK-22205 vs DK-22251). Those are
+ * indistinguishable over the network, so callers warn.
+ */
+export function hasTwoColourSibling(media: BrotherQLMedia): boolean {
+  return Object.values(MEDIA).some(
+    m => m.palette !== undefined && m.type === media.type && m.widthMm === media.widthMm,
+  );
+}
+
+/**
+ * Map Printer-MIB values onto the driver's status. `ready` requires
+ * an idle or printing state and no error bits. Two-colour rolls are
+ * invisible on every network surface (DK-22251 reads as 62 mm
+ * continuous), so the single-colour sibling is resolved and a `warn`
+ * row says so.
+ */
+export function statusFromPrinterMib(
+  input: PrinterMibStatus,
+  engine?: Pick<PrintEngine, 'headDots' | 'mediaCompatibility'>,
+): BrotherQLStatus {
+  const errors: PrinterError[] = [];
+  const details: StatusDetail[] = [
+    { label: 'Printer state', value: PRINTER_STATE[input.printerStatus] ?? 'unknown' },
+  ];
+
+  for (const [bit, name] of ERROR_STATE_BITS.entries()) {
+    if (!errorStateBit(input.errorState, bit)) continue;
+    const warning = ERROR_STATE_WARNINGS[bit];
+    if (warning !== undefined) {
+      details.push({ label: 'Media', value: warning, severity: 'warn' });
+      continue;
+    }
+    errors.push(ERROR_STATE_CODES[bit] ?? { code: 'system_error', message: name });
+  }
+
+  const dims = resolveDimensions(input);
+  const detected = dims
+    ? findMediaByDimensions(dims.widthMm, dims.heightMm, false, engine)
+    : undefined;
+  if (detected === undefined) {
+    details.push({
+      label: 'Media',
+      value: `not recognised: ${JSON.stringify(input.mediaName)}`,
+      severity: 'warn',
+    });
+  } else if (hasTwoColourSibling(detected)) {
+    details.push({ label: 'Two-colour', value: 'not detectable over network', severity: 'warn' });
+  }
+
+  const state = input.printerStatus;
+  return {
+    ready: (state === 3 || state === 4) && errors.length === 0,
+    mediaLoaded: detected !== undefined,
+    ...(detected === undefined ? {} : { detectedMedia: detected }),
+    errors,
+    details,
+    rawBytes: new Uint8Array(0),
+  };
+}