@thermal-label/brother-ql-core 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Mannes Brak
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,23 @@
+# @thermal-label/brother-ql-core
+
+Protocol encoding, device registry, and media registry for Brother QL label printers.
+
+> Consumers rarely import this package directly — use `@thermal-label/brother-ql-node` (Node.js) or `@thermal-label/brother-ql-web` (browser) instead. This package is for porting or advanced use cases.
+
+## Key Exports
+
+- `encodeJob(pages, options?)` — encode a complete print job to a `Uint8Array` byte stream
+- `DEVICES` — registry of all supported Brother QL devices
+- `MEDIA` — registry of all supported label media
+- `findDevice(vid, pid)` — look up a device descriptor by USB VID+PID
+- `findMedia(id)` — look up a media descriptor by ID
+- `renderText`, `renderImage` — re-exported from `@mbtech-nl/bitmap`
+
+## Requirements
+
+- Node.js `>=24.0.0`
+- Runs in browser and Node.js — no Node.js built-ins used
+
+## License
+
+MIT © Mannes Brak

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

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

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

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

package/dist/__tests__/devices.test.js

@@ -0,0 +1,63 @@
+import { describe, it, expect } from 'vitest';
+import { DEVICES, findDevice, isMassStorageMode } from '../devices.js';
+describe('findDevice', () => {
+    it('returns correct descriptor for QL-820NWB', () => {
+        const dev = findDevice(0x04f9, 0x20a7);
+        expect(dev).toBeDefined();
+        expect(dev.name).toBe('QL-820NWB');
+        expect(dev.twoColor).toBe(true);
+    });
+    it('returns correct descriptor for QL-820NWBc', () => {
+        const dev = findDevice(0x04f9, 0x209d);
+        expect(dev).toBeDefined();
+        expect(dev.name).toBe('QL-820NWBc');
+        expect(dev.twoColor).toBe(true);
+    });
+    it('returns correct descriptor for QL-500', () => {
+        const dev = findDevice(0x04f9, 0x2013);
+        expect(dev).toBeDefined();
+        expect(dev.name).toBe('QL-500');
+        expect(dev.autocut).toBe(false);
+    });
+    it('returns undefined for unknown PID', () => {
+        expect(findDevice(0x04f9, 0x9999)).toBeUndefined();
+    });
+    it('returns undefined for unknown VID', () => {
+        expect(findDevice(0x1234, 0x20a7)).toBeUndefined();
+    });
+});
+describe('isMassStorageMode', () => {
+    it('returns true for 0x20AA (QL-1100 mass storage)', () => {
+        expect(isMassStorageMode(0x20aa)).toBe(true);
+    });
+    it('returns true for 0x20AB (QL-1110NWB mass storage)', () => {
+        expect(isMassStorageMode(0x20ab)).toBe(true);
+    });
+    it('returns false for all printer-class PIDs', () => {
+        for (const dev of Object.values(DEVICES)) {
+            expect(isMassStorageMode(dev.pid)).toBe(false);
+        }
+    });
+});
+describe('Device registry invariants', () => {
+    it('every two-color device has bytesPerRow 90', () => {
+        for (const dev of Object.values(DEVICES)) {
+            if (dev.twoColor) {
+                expect(dev.bytesPerRow).toBe(90);
+            }
+        }
+    });
+    it('every device with headPins 1296 has bytesPerRow 162', () => {
+        for (const dev of Object.values(DEVICES)) {
+            if (dev.headPins === 1296) {
+                expect(dev.bytesPerRow).toBe(162);
+            }
+        }
+    });
+    it('every device has bluetooth: false (BT out of scope)', () => {
+        for (const dev of Object.values(DEVICES)) {
+            expect(dev.bluetooth).toBe(false);
+        }
+    });
+});
+//# sourceMappingURL=devices.test.js.map

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

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

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

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

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

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

package/dist/__tests__/media.test.js

@@ -0,0 +1,62 @@
+import { describe, it, expect } from 'vitest';
+import { MEDIA, findMedia, findMediaByWidth } from '../media.js';
+describe('findMedia', () => {
+    it('returns correct descriptor for 62mm continuous (ID 259)', () => {
+        const m = findMedia(259);
+        expect(m).toBeDefined();
+        expect(m.widthMm).toBe(62);
+        expect(m.type).toBe('continuous');
+        expect(m.lengthMm).toBe(0);
+    });
+    it('returns correct descriptor for 62x29mm die-cut (ID 274)', () => {
+        const m = findMedia(274);
+        expect(m).toBeDefined();
+        expect(m.type).toBe('die-cut');
+        expect(m.lengthMm).toBeGreaterThan(0);
+    });
+    it('returns undefined for unknown ID', () => {
+        expect(findMedia(9999)).toBeUndefined();
+    });
+});
+describe('findMediaByWidth', () => {
+    it('returns all 62mm continuous options', () => {
+        const results = findMediaByWidth(62, 'continuous');
+        expect(results.length).toBeGreaterThan(0);
+        for (const m of results) {
+            expect(m.widthMm).toBe(62);
+            expect(m.type).toBe('continuous');
+        }
+    });
+    it('returns die-cut for 62mm die-cut', () => {
+        const results = findMediaByWidth(62, 'die-cut');
+        expect(results.length).toBeGreaterThan(0);
+        for (const m of results) {
+            expect(m.type).toBe('die-cut');
+        }
+    });
+    it('returns empty array for unknown width', () => {
+        expect(findMediaByWidth(999, 'continuous')).toHaveLength(0);
+    });
+});
+describe('Media registry invariants', () => {
+    it('die-cut media has non-zero lengthMm', () => {
+        for (const m of Object.values(MEDIA)) {
+            if (m.type === 'die-cut') {
+                expect(m.lengthMm).toBeGreaterThan(0);
+            }
+        }
+    });
+    it('continuous media has lengthMm === 0', () => {
+        for (const m of Object.values(MEDIA)) {
+            if (m.type === 'continuous') {
+                expect(m.lengthMm).toBe(0);
+            }
+        }
+    });
+    it('all IDs are unique', () => {
+        const ids = Object.values(MEDIA).map(m => m.id);
+        const unique = new Set(ids);
+        expect(unique.size).toBe(ids.length);
+    });
+});
+//# sourceMappingURL=media.test.js.map

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

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

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

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

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

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

package/dist/__tests__/protocol.test.js

@@ -0,0 +1,202 @@
+import { describe, it, expect } from 'vitest';
+import { createBitmap } from '@mbtech-nl/bitmap';
+import { buildInvalidate, buildInitialize, buildRasterMode, buildRasterRow, buildPrintCommand, buildPrintInfo, buildZeroRow, buildCompression, buildStatusNotification, buildVariousMode, buildExpandedMode, encodeJob, } from '../protocol.js';
+import {} from '../types.js';
+import { MEDIA } from '../media.js';
+describe('buildInvalidate', () => {
+    it('returns exactly 200 zero bytes', () => {
+        const buf = buildInvalidate();
+        expect(buf.length).toBe(200);
+        expect(buf.every(b => b === 0)).toBe(true);
+    });
+});
+describe('buildInitialize', () => {
+    it('returns [0x1B, 0x40]', () => {
+        expect(Array.from(buildInitialize())).toEqual([0x1b, 0x40]);
+    });
+});
+describe('buildRasterRow', () => {
+    it('single-color black: [0x67][0x00][len][data]', () => {
+        const payload = new Uint8Array(90).fill(0xaa);
+        const row = buildRasterRow(payload, 'black');
+        expect(row[0]).toBe(0x67);
+        expect(row[1]).toBe(0x00);
+        expect(row[2]).toBe(90);
+        expect(row.length).toBe(93);
+    });
+    it('two-color black: [0x77][0x01][len][data]', () => {
+        const payload = new Uint8Array(90);
+        const row = buildRasterRow(payload, 'black', true);
+        expect(row[0]).toBe(0x77);
+        expect(row[1]).toBe(0x01);
+        expect(row[2]).toBe(90);
+    });
+    it('two-color red: [0x77][0x02][len][data]', () => {
+        const payload = new Uint8Array(90);
+        const row = buildRasterRow(payload, 'red', true);
+        expect(row[0]).toBe(0x77);
+        expect(row[1]).toBe(0x02);
+        expect(row[2]).toBe(90);
+    });
+});
+describe('buildPrintCommand', () => {
+    it('last page returns [0x1A]', () => {
+        expect(Array.from(buildPrintCommand(true))).toEqual([0x1a]);
+    });
+    it('non-last page returns [0x0C]', () => {
+        expect(Array.from(buildPrintCommand(false))).toEqual([0x0c]);
+    });
+});
+describe('buildPrintInfo', () => {
+    it('byte 5 contains correct media width, bytes 7-8 correct row count LE', () => {
+        const media = MEDIA[259]; // 62mm continuous
+        const buf = buildPrintInfo(media, 200, 0);
+        expect(buf[5]).toBe(62); // widthMm
+        // rowCount 200 = 0xC8 at bytes 7-8
+        expect(buf[7]).toBe(0xc8);
+        expect(buf[8]).toBe(0x00);
+    });
+    it('page index is at byte 9', () => {
+        const media = MEDIA[259];
+        const buf = buildPrintInfo(media, 100, 3);
+        expect(buf[9]).toBe(3);
+    });
+    it('die-cut media sets mediaType byte to 0x0b', () => {
+        const media = MEDIA[271]; // 29x90mm die-cut
+        const buf = buildPrintInfo(media, 100, 0);
+        expect(buf[4]).toBe(0x0b);
+    });
+});
+describe('encodeJob', () => {
+    const media62 = MEDIA[259]; // 62mm, 696 printAreaDots
+    function makePage(widthPx, heightPx) {
+        const bitmap = createBitmap(widthPx, heightPx);
+        return { bitmap, media: media62 };
+    }
+    it('single page: contains ESC i a + 200 zero invalidate, ends with 0x1A', () => {
+        const page = makePage(696, 50);
+        const buf = encodeJob([page]);
+        // Starts with ESC i a 01 (raster mode, 4 bytes) then 200 zero invalidate bytes
+        expect(buf[0]).toBe(0x1b);
+        expect(buf[1]).toBe(0x69);
+        expect(buf[2]).toBe(0x61);
+        expect(buf[3]).toBe(0x01);
+        for (let i = 4; i < 204; i++)
+            expect(buf[i]).toBe(0);
+        expect(buf.at(-1)).toBe(0x1a);
+    });
+    it('two-page job: second page has control codes, ends with 0x1A', () => {
+        const page1 = makePage(696, 10);
+        const page2 = makePage(696, 10);
+        const buf = encodeJob([page1, page2]);
+        expect(buf.at(-1)).toBe(0x1a);
+        // 0x0C should appear as the inter-page print command somewhere before the last byte
+        const printCmds = [];
+        for (let i = 0; i < buf.length; i++) {
+            if (buf[i] === 0x0c)
+                printCmds.push(i);
+        }
+        expect(printCmds.length).toBeGreaterThan(0);
+    });
+    it('two-color job: black rows [0x77,0x01,len], red rows [0x77,0x02,len], interleaved', () => {
+        const bitmap = createBitmap(696, 5);
+        const redBitmap = createBitmap(696, 5);
+        const page = { bitmap, redBitmap, media: media62 };
+        const buf = encodeJob([page]);
+        const rowLen = 90;
+        const blackRows = [];
+        const redRows = [];
+        for (let i = 0; i < buf.length - 2; i++) {
+            if (buf[i] === 0x77 && buf[i + 1] === 0x01 && buf[i + 2] === rowLen)
+                blackRows.push(i);
+            if (buf[i] === 0x77 && buf[i + 1] === 0x02 && buf[i + 2] === rowLen)
+                redRows.push(i);
+        }
+        expect(blackRows.length).toBe(5);
+        expect(redRows.length).toBe(5);
+        // Verify interleaving: each black row is immediately followed by a red row (93 bytes apart)
+        for (let r = 0; r < 5; r++) {
+            expect(redRows[r] - blackRows[r]).toBe(93); // 3 header + 90 data
+        }
+    });
+    it('two-color job: throws if red bitmap dimensions mismatch', () => {
+        const bitmap = createBitmap(720, 5);
+        const redBitmap = createBitmap(720, 10); // different height
+        const page = { bitmap, redBitmap, media: media62 };
+        expect(() => encodeJob([page])).toThrow('identical dimensions');
+    });
+    it('copies option repeats the job', () => {
+        const page = makePage(720, 2);
+        const buf1 = encodeJob([page]);
+        const buf2 = encodeJob([page], { copies: 2 });
+        expect(buf2.length).toBeGreaterThan(buf1.length);
+    });
+    it('compress option includes compression command [0x4D, 0x02]', () => {
+        const page = { ...makePage(696, 5), options: { compress: true } };
+        const buf = encodeJob([page]);
+        let found = false;
+        for (let i = 0; i < buf.length - 1; i++) {
+            if (buf[i] === 0x4d && buf[i + 1] === 0x02) {
+                found = true;
+                break;
+            }
+        }
+        expect(found).toBe(true);
+    });
+});
+describe('buildRasterMode', () => {
+    it('returns correct bytes', () => {
+        expect(Array.from(buildRasterMode())).toEqual([0x1b, 0x69, 0x61, 0x01]);
+    });
+});
+describe('buildStatusNotification', () => {
+    it('disabled returns [0x1B, 0x69, 0x21, 0x00]', () => {
+        expect(Array.from(buildStatusNotification(false))).toEqual([0x1b, 0x69, 0x21, 0x00]);
+    });
+    it('enabled returns [0x1B, 0x69, 0x21, 0x01]', () => {
+        expect(Array.from(buildStatusNotification(true))).toEqual([0x1b, 0x69, 0x21, 0x01]);
+    });
+});
+describe('buildVariousMode', () => {
+    it('autoCut=true returns 0x40 flag', () => {
+        expect(buildVariousMode(true)[3]).toBe(0x40);
+    });
+    it('autoCut=false returns 0x00 flag', () => {
+        expect(buildVariousMode(false)[3]).toBe(0x00);
+    });
+});
+describe('buildExpandedMode', () => {
+    it('cutAtEnd=true sets bit 3', () => {
+        expect((buildExpandedMode(true, false)[3] ?? 0) & 0x08).toBe(0x08);
+    });
+    it('highRes=true sets bit 4', () => {
+        expect((buildExpandedMode(false, true)[3] ?? 0) & 0x10).toBe(0x10);
+    });
+    it('twoColor=true sets bit 0', () => {
+        expect((buildExpandedMode(false, false, true)[3] ?? 0) & 0x01).toBe(0x01);
+    });
+    it('both false returns 0x00 flags', () => {
+        expect(buildExpandedMode(false, false)[3]).toBe(0x00);
+    });
+});
+describe('buildPrintInfo twoColor flag', () => {
+    it('always uses 0xCE valid flags (Python brother_ql behaviour for two-color capable models)', () => {
+        const media = MEDIA[259];
+        const buf = buildPrintInfo(media, 100, 0);
+        expect(buf[3]).toBe(0xce);
+    });
+});
+describe('buildZeroRow', () => {
+    it('returns [0x5A]', () => {
+        expect(Array.from(buildZeroRow())).toEqual([0x5a]);
+    });
+});
+describe('buildCompression', () => {
+    it('enabled returns [0x4D, 0x02]', () => {
+        expect(Array.from(buildCompression(true))).toEqual([0x4d, 0x02]);
+    });
+    it('disabled returns [0x4D, 0x00]', () => {
+        expect(Array.from(buildCompression(false))).toEqual([0x4d, 0x00]);
+    });
+});
+//# sourceMappingURL=protocol.test.js.map

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

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

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

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

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

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

package/dist/__tests__/status.test.js

@@ -0,0 +1,74 @@
+import { describe, it, expect } from 'vitest';
+import { parseStatus, STATUS_REQUEST } from '../status.js';
+function makeStatusBytes(overrides) {
+    const bytes = new Uint8Array(32);
+    bytes[0] = 0x80;
+    bytes[1] = 0x20;
+    bytes[2] = 0x42;
+    bytes[3] = 0x30;
+    bytes[8] = overrides?.errInfo1 ?? 0;
+    bytes[9] = overrides?.errInfo2 ?? 0;
+    bytes[10] = overrides?.mediaWidthMm ?? 62;
+    bytes[11] = overrides?.mediaTypeByte ?? 0x0a;
+    bytes[17] = overrides?.mediaLengthMm ?? 0;
+    bytes[18] = overrides?.statusType ?? 0x00;
+    return bytes;
+}
+describe('parseStatus', () => {
+    it('throws on short input', () => {
+        expect(() => parseStatus(new Uint8Array(10))).toThrow('too short');
+    });
+    it('returns ready=true with no errors', () => {
+        const status = parseStatus(makeStatusBytes());
+        expect(status.ready).toBe(true);
+        expect(status.errors).toHaveLength(0);
+    });
+    it('parses media width and type', () => {
+        const status = parseStatus(makeStatusBytes({ mediaWidthMm: 62, mediaTypeByte: 0x0a }));
+        expect(status.mediaWidthMm).toBe(62);
+        expect(status.mediaType).toBe('continuous');
+    });
+    it('parses media length from byte 17 (0 for continuous, mm for die-cut)', () => {
+        const cont = parseStatus(makeStatusBytes({ mediaLengthMm: 0 }));
+        expect(cont.mediaLengthMm).toBe(0);
+        const diecut = parseStatus(makeStatusBytes({ mediaTypeByte: 0x0b, mediaLengthMm: 90 }));
+        expect(diecut.mediaLengthMm).toBe(90);
+    });
+    it('parses die-cut media type', () => {
+        const status = parseStatus(makeStatusBytes({ mediaTypeByte: 0x0b }));
+        expect(status.mediaType).toBe('die-cut');
+    });
+    it('returns null mediaType for unknown byte', () => {
+        const status = parseStatus(makeStatusBytes({ mediaTypeByte: 0xff }));
+        expect(status.mediaType).toBeNull();
+    });
+    it('parses error info 1 bits', () => {
+        const status = parseStatus(makeStatusBytes({ errInfo1: 0b00000001 })); // No media
+        expect(status.errors).toContain('No media');
+        expect(status.ready).toBe(false);
+    });
+    it('parses error info 2 bits', () => {
+        const status = parseStatus(makeStatusBytes({ errInfo2: 0b00010000 })); // Cover open
+        expect(status.errors).toContain('Cover open');
+        expect(status.ready).toBe(false);
+    });
+    it('ready=false when statusType is error (0x02)', () => {
+        const status = parseStatus(makeStatusBytes({ statusType: 0x02 }));
+        expect(status.ready).toBe(false);
+    });
+    it('rawBytes contains the full 32-byte input', () => {
+        const bytes = makeStatusBytes();
+        const status = parseStatus(bytes);
+        expect(status.rawBytes).toEqual(bytes);
+    });
+    it('editorLiteMode is false (detected at discovery time, not from status bytes)', () => {
+        const status = parseStatus(makeStatusBytes());
+        expect(status.editorLiteMode).toBe(false);
+    });
+});
+describe('STATUS_REQUEST', () => {
+    it('is the correct byte sequence', () => {
+        expect(Array.from(STATUS_REQUEST)).toEqual([0x1b, 0x69, 0x53]);
+    });
+});
+//# sourceMappingURL=status.test.js.map

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

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