@thermal-label/brother-ql-web 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,80 @@
+# @thermal-label/brother-ql-web
+
+WebUSB browser driver for Brother QL label printers.
+
+## Browser Support
+
+| Browser       | Support |
+| ------------- | ------- |
+| Chrome / Edge | ✅      |
+| Firefox       | ❌      |
+| Safari        | ❌      |
+
+Requires a [secure context](https://developer.mozilla.org/en-US/docs/Web/Security/Secure_Contexts) (`https://` or `localhost`).
+
+## Install
+
+```bash
+pnpm add @thermal-label/brother-ql-web
+```
+
+## Quick Start
+
+```ts
+import { requestPrinter, findMedia } from '@thermal-label/brother-ql-web';
+
+const media = findMedia(259)!; // 62mm continuous
+const printer = await requestPrinter();
+await printer.printText('Hello WebUSB', media);
+```
+
+## Two-Color Printing
+
+Requires a QL-800, QL-810W, or QL-820NWB with DK-22251 labels.
+
+```ts
+const blackCanvas = document.getElementById('black-layer') as HTMLCanvasElement;
+const redCanvas = document.getElementById('red-layer') as HTMLCanvasElement;
+const blackCtx = blackCanvas.getContext('2d')!;
+const redCtx = redCanvas.getContext('2d')!;
+
+await printer.printTwoColor(
+  blackCtx.getImageData(0, 0, blackCanvas.width, blackCanvas.height),
+  redCtx.getImageData(0, 0, redCanvas.width, redCanvas.height),
+  media,
+);
+```
+
+## API
+
+### `requestPrinter(options?)`
+
+Opens the browser's USB device picker filtered to all known Brother QL PIDs.
+Returns a `WebBrotherQLPrinter`.
+
+### `fromUSBDevice(device)`
+
+Wraps an already-obtained `USBDevice`. The caller is responsible for opening and claiming the interface.
+
+### `WebBrotherQLPrinter`
+
+| Method                                       | Description                              |
+| -------------------------------------------- | ---------------------------------------- |
+| `print(pages, options?)`                     | Send a pre-encoded job                   |
+| `printText(text, media, options?)`           | Render and print a text label            |
+| `printImage(imageData, media, options?)`     | Print from `ImageData`                   |
+| `printImageURL(url, media, options?)`        | Fetch URL and print                      |
+| `printTwoColor(black, red, media, options?)` | Two-color label (QL-800 series)          |
+| `getStatus()`                                | Query printer status                     |
+| `isConnected()`                              | Returns `true` if the USB device is open |
+| `disconnect()`                               | Release interface and close device       |
+
+## Requirements
+
+- Chromium-based browser (Chrome 61+, Edge 79+)
+- Secure context (`https://` or `localhost`)
+- User gesture required to call `requestPrinter()`
+
+## License
+
+MIT © Mannes Brak

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

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

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

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

package/dist/__tests__/printer.test.js

@@ -0,0 +1,156 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import { WebBrotherQLPrinter, openWebDevice } from '../printer.js';
+import { DEVICES, findMedia } from '@thermal-label/brother-ql-core';
+import { createMockUSBDevice } from './webusb-mock.js';
+const media62mm = findMedia(259);
+function makeImageData(width = 10, height = 10) {
+    return { width, height, data: new Uint8ClampedArray(width * height * 4) };
+}
+describe('WebBrotherQLPrinter', () => {
+    let mock;
+    beforeEach(() => {
+        mock = createMockUSBDevice({ productId: 0x20a7 }); // QL-820NWB
+    });
+    afterEach(() => {
+        vi.unstubAllGlobals();
+    });
+    it('openWebDevice opens and claims interface', async () => {
+        const printer = await openWebDevice(mock.device);
+        expect(mock.spies.open).toHaveBeenCalledOnce();
+        expect(mock.spies.selectConfiguration).toHaveBeenCalledWith(1);
+        expect(mock.spies.claimInterface).toHaveBeenCalledWith(0);
+        expect(printer.descriptor.name).toBe('QL-820NWB');
+    });
+    it('openWebDevice throws for unknown device', async () => {
+        const { device } = createMockUSBDevice({ vendorId: 0x04f9, productId: 0x9999 });
+        await expect(openWebDevice(device)).rejects.toThrow('Unsupported device');
+    });
+    it('print writes encoded bytes via transferOut', async () => {
+        const printer = new WebBrotherQLPrinter(mock.device, DEVICES.QL_820NWB);
+        const bitmap = { widthPx: 720, heightPx: 10, data: new Uint8Array(90 * 10) };
+        await printer.print([{ bitmap, media: media62mm }]);
+        expect(mock.spies.transferOut).toHaveBeenCalled();
+        const bytes = mock.spies.transferOut.mock.calls[0]?.[1];
+        // Job starts with ESC i a 01 (raster mode) then 200-byte invalidate
+        expect(bytes[0]).toBe(0x1b);
+        expect(bytes[1]).toBe(0x69);
+        expect(bytes[2]).toBe(0x61);
+        // Ends with 0x1A (print last page)
+        expect(bytes.at(-1)).toBe(0x1a);
+    });
+    it('getStatus sends status request and parses response', async () => {
+        const statusBytes = new Uint8Array(32);
+        statusBytes[0] = 0x80;
+        statusBytes[10] = 62; // 62mm media
+        statusBytes[11] = 0x0a; // continuous
+        mock.spies.transferIn.mockResolvedValueOnce({
+            status: 'ok',
+            data: new DataView(statusBytes.buffer),
+        });
+        const printer = new WebBrotherQLPrinter(mock.device, DEVICES.QL_820NWB);
+        const status = await printer.getStatus();
+        const outBytes = mock.spies.transferOut.mock.calls[0]?.[1];
+        expect(outBytes).toEqual(new Uint8Array([0x1b, 0x69, 0x53]));
+        expect(status.mediaWidthMm).toBe(62);
+        expect(status.mediaType).toBe('continuous');
+    });
+    it('getStatus throws when no data is returned', async () => {
+        mock.spies.transferIn.mockResolvedValueOnce({ status: 'ok', data: null });
+        const printer = new WebBrotherQLPrinter(mock.device, DEVICES.QL_820NWB);
+        await expect(printer.getStatus()).rejects.toThrow('No status data received');
+    });
+    it('disconnect releases interface and closes device', async () => {
+        const printer = new WebBrotherQLPrinter(mock.device, DEVICES.QL_820NWB);
+        await printer.disconnect();
+        expect(mock.spies.releaseInterface).toHaveBeenCalledWith(0);
+        expect(mock.spies.close).toHaveBeenCalledOnce();
+    });
+    it('isConnected reflects device opened state', async () => {
+        const printer = new WebBrotherQLPrinter(mock.device, DEVICES.QL_820NWB);
+        expect(printer.isConnected()).toBe(false);
+        await mock.device.open();
+        expect(printer.isConnected()).toBe(true);
+    });
+    it('printText() renders text and sends to device', async () => {
+        const printer = new WebBrotherQLPrinter(mock.device, DEVICES.QL_820NWB);
+        await printer.printText('hello', media62mm);
+        expect(mock.spies.transferOut).toHaveBeenCalled();
+    });
+    it('printText() passes PageOptions through to print', async () => {
+        const printer = new WebBrotherQLPrinter(mock.device, DEVICES.QL_820NWB);
+        await printer.printText('hi', media62mm, { autoCut: true });
+        expect(mock.spies.transferOut).toHaveBeenCalled();
+    });
+    it('printText() forwards invert and scale options', async () => {
+        const printer = new WebBrotherQLPrinter(mock.device, DEVICES.QL_820NWB);
+        await printer.printText('test', media62mm, { invert: true, scaleX: 2, scaleY: 2 });
+        expect(mock.spies.transferOut).toHaveBeenCalled();
+    });
+    it('printImage() renders ImageData and sends to device', async () => {
+        const printer = new WebBrotherQLPrinter(mock.device, DEVICES.QL_820NWB);
+        await printer.printImage(makeImageData(), media62mm);
+        expect(mock.spies.transferOut).toHaveBeenCalled();
+    });
+    it('printImage() passes renderImage options', async () => {
+        const printer = new WebBrotherQLPrinter(mock.device, DEVICES.QL_820NWB);
+        await printer.printImage(makeImageData(), media62mm, {
+            threshold: 100,
+            dither: true,
+            invert: true,
+        });
+        expect(mock.spies.transferOut).toHaveBeenCalled();
+    });
+    it('printImage() applies explicit rotation when provided', async () => {
+        const printer = new WebBrotherQLPrinter(mock.device, DEVICES.QL_820NWB);
+        await printer.printImage(makeImageData(), media62mm, { rotate: 180 });
+        expect(mock.spies.transferOut).toHaveBeenCalled();
+    });
+    it('printImage() passes PageOptions through to print', async () => {
+        const printer = new WebBrotherQLPrinter(mock.device, DEVICES.QL_820NWB);
+        await printer.printImage(makeImageData(), media62mm, { autoCut: true });
+        expect(mock.spies.transferOut).toHaveBeenCalled();
+    });
+    it('printImageURL() fetches URL and prints via canvas', async () => {
+        const blobMock = new Blob();
+        const bmpMock = { width: 10, height: 10 };
+        const ctxMock = {
+            drawImage: vi.fn(),
+            getImageData: vi.fn().mockReturnValue(makeImageData()),
+        };
+        const canvasMock = { getContext: vi.fn().mockReturnValue(ctxMock) };
+        vi.stubGlobal('fetch', vi.fn().mockResolvedValue({ blob: vi.fn().mockResolvedValue(blobMock) }));
+        vi.stubGlobal('createImageBitmap', vi.fn().mockResolvedValue(bmpMock));
+        vi.stubGlobal('OffscreenCanvas', vi.fn().mockReturnValue(canvasMock));
+        const printer = new WebBrotherQLPrinter(mock.device, DEVICES.QL_820NWB);
+        await printer.printImageURL('https://example.com/label.png', media62mm);
+        expect(mock.spies.transferOut).toHaveBeenCalled();
+    });
+    it('printImageURL() throws when canvas context cannot be obtained', async () => {
+        const blobMock = new Blob();
+        const bmpMock = { width: 10, height: 10 };
+        const canvasMock = { getContext: vi.fn().mockReturnValue(null) };
+        vi.stubGlobal('fetch', vi.fn().mockResolvedValue({ blob: vi.fn().mockResolvedValue(blobMock) }));
+        vi.stubGlobal('createImageBitmap', vi.fn().mockResolvedValue(bmpMock));
+        vi.stubGlobal('OffscreenCanvas', vi.fn().mockReturnValue(canvasMock));
+        const printer = new WebBrotherQLPrinter(mock.device, DEVICES.QL_820NWB);
+        await expect(printer.printImageURL('https://example.com/label.png', media62mm)).rejects.toThrow('Could not get canvas context');
+    });
+    it('printTwoColor throws on non-two-color device', async () => {
+        const printer = new WebBrotherQLPrinter(mock.device, DEVICES.QL_700);
+        const imgData = makeImageData();
+        await expect(printer.printTwoColor(imgData, imgData, media62mm)).rejects.toThrow('does not support two-color');
+    });
+    it('printTwoColor() renders and prints both channels', async () => {
+        const printer = new WebBrotherQLPrinter(mock.device, DEVICES.QL_820NWB);
+        const imgData = makeImageData();
+        await printer.printTwoColor(imgData, imgData, media62mm);
+        expect(mock.spies.transferOut).toHaveBeenCalled();
+    });
+    it('printTwoColor() passes options through to print', async () => {
+        const printer = new WebBrotherQLPrinter(mock.device, DEVICES.QL_820NWB);
+        const imgData = makeImageData();
+        await printer.printTwoColor(imgData, imgData, media62mm, { autoCut: true });
+        expect(mock.spies.transferOut).toHaveBeenCalled();
+    });
+});
+//# sourceMappingURL=printer.test.js.map

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

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

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

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

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

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

package/dist/__tests__/request.test.js

@@ -0,0 +1,57 @@
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { DEVICES } from '@thermal-label/brother-ql-core';
+import { fromUSBDevice } from '../request.js';
+import { createMockUSBDevice } from './webusb-mock.js';
+const mockRequestDevice = vi.fn();
+Object.defineProperty(globalThis, 'navigator', {
+    value: { usb: { requestDevice: mockRequestDevice } },
+    writable: true,
+});
+beforeEach(() => {
+    mockRequestDevice.mockClear();
+});
+describe('requestPrinter', () => {
+    it('passes all known printer-class PIDs to requestDevice', async () => {
+        const { device } = createMockUSBDevice({ productId: 0x20a7 });
+        mockRequestDevice.mockResolvedValueOnce(device);
+        const { requestPrinter } = await import('../request.js');
+        await requestPrinter();
+        expect(mockRequestDevice).toHaveBeenCalledOnce();
+        const [opts] = mockRequestDevice.mock.calls[0];
+        const pids = opts.filters.map(f => f.productId);
+        for (const d of Object.values(DEVICES)) {
+            expect(pids).toContain(d.pid);
+        }
+    });
+    it('does not include mass-storage PIDs in filters', async () => {
+        const { device } = createMockUSBDevice({ productId: 0x20a7 });
+        mockRequestDevice.mockResolvedValueOnce(device);
+        const { requestPrinter } = await import('../request.js');
+        await requestPrinter();
+        const [opts] = mockRequestDevice.mock.calls[0];
+        const pids = opts.filters.map(f => f.productId);
+        expect(pids).not.toContain(0x20aa);
+        expect(pids).not.toContain(0x20ab);
+    });
+    it('uses custom filters when provided', async () => {
+        const { device } = createMockUSBDevice({ productId: 0x20a7 });
+        mockRequestDevice.mockResolvedValueOnce(device);
+        const customFilters = [{ vendorId: 0x04f9, productId: 0x20a7 }];
+        const { requestPrinter } = await import('../request.js');
+        await requestPrinter({ filters: customFilters });
+        const [opts] = mockRequestDevice.mock.calls[0];
+        expect(opts.filters).toEqual(customFilters);
+    });
+});
+describe('fromUSBDevice', () => {
+    it('returns WebBrotherQLPrinter for known device', () => {
+        const { device } = createMockUSBDevice({ productId: 0x20a7 });
+        const printer = fromUSBDevice(device);
+        expect(printer.descriptor.name).toBe('QL-820NWB');
+    });
+    it('throws for unknown product ID', () => {
+        const { device } = createMockUSBDevice({ productId: 0x9999 });
+        expect(() => fromUSBDevice(device)).toThrow('Unsupported device');
+    });
+});
+//# sourceMappingURL=request.test.js.map

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

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

package/dist/__tests__/webusb-mock.d.ts

@@ -0,0 +1,21 @@
+import { vi } from 'vitest';
+export interface MockUSBDeviceSpies {
+    open: ReturnType<typeof vi.fn>;
+    close: ReturnType<typeof vi.fn>;
+    selectConfiguration: ReturnType<typeof vi.fn>;
+    claimInterface: ReturnType<typeof vi.fn>;
+    releaseInterface: ReturnType<typeof vi.fn>;
+    transferOut: ReturnType<typeof vi.fn>;
+    transferIn: ReturnType<typeof vi.fn>;
+}
+export interface MockUSBDevice {
+    device: USBDevice;
+    spies: MockUSBDeviceSpies;
+}
+export declare function createMockUSBDevice(overrides?: {
+    vendorId?: number;
+    productId?: number;
+    serialNumber?: string;
+    statusBytes?: Uint8Array;
+}): MockUSBDevice;
+//# sourceMappingURL=webusb-mock.d.ts.map

package/dist/__tests__/webusb-mock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webusb-mock.d.ts","sourceRoot":"","sources":["../../src/__tests__/webusb-mock.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAE5B,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,UAAU,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC;IAC/B,KAAK,EAAE,UAAU,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC;IAChC,mBAAmB,EAAE,UAAU,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC;IAC9C,cAAc,EAAE,UAAU,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC;IACzC,gBAAgB,EAAE,UAAU,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC;IAC3C,WAAW,EAAE,UAAU,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC;IACtC,UAAU,EAAE,UAAU,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,SAAS,CAAC;IAClB,KAAK,EAAE,kBAAkB,CAAC;CAC3B;AAED,wBAAgB,mBAAmB,CAAC,SAAS,CAAC,EAAE;IAC9C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,UAAU,CAAC;CAC1B,GAAG,aAAa,CA8ChB"}

package/dist/__tests__/webusb-mock.js

@@ -0,0 +1,44 @@
+import { vi } from 'vitest';
+export function createMockUSBDevice(overrides) {
+    const spies = {
+        open: vi.fn().mockImplementation(() => Promise.resolve()),
+        close: vi.fn().mockImplementation(() => Promise.resolve()),
+        selectConfiguration: vi.fn().mockImplementation(() => Promise.resolve()),
+        claimInterface: vi.fn().mockImplementation(() => Promise.resolve()),
+        releaseInterface: vi.fn().mockImplementation(() => Promise.resolve()),
+        transferOut: vi
+            .fn()
+            .mockImplementation(() => Promise.resolve({ bytesWritten: 0, status: 'ok' })),
+        transferIn: vi.fn().mockImplementation(() => Promise.resolve({
+            status: 'ok',
+            data: new DataView((overrides?.statusBytes ?? new Uint8Array(32)).buffer),
+        })),
+    };
+    let opened = false;
+    spies.open.mockImplementation(() => {
+        opened = true;
+        return Promise.resolve();
+    });
+    spies.close.mockImplementation(() => {
+        opened = false;
+        return Promise.resolve();
+    });
+    const device = {
+        vendorId: overrides?.vendorId ?? 0x04f9,
+        productId: overrides?.productId ?? 0x20a7,
+        serialNumber: overrides?.serialNumber,
+        configuration: { interfaces: [{ interfaceNumber: 0, claimed: false }] },
+        get opened() {
+            return opened;
+        },
+        open: spies.open,
+        close: spies.close,
+        selectConfiguration: spies.selectConfiguration,
+        claimInterface: spies.claimInterface,
+        releaseInterface: spies.releaseInterface,
+        transferOut: spies.transferOut,
+        transferIn: spies.transferIn,
+    };
+    return { device, spies };
+}
+//# sourceMappingURL=webusb-mock.js.map

package/dist/__tests__/webusb-mock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webusb-mock.js","sourceRoot":"","sources":["../../src/__tests__/webusb-mock.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAiB5B,MAAM,UAAU,mBAAmB,CAAC,SAKnC;IACC,MAAM,KAAK,GAAuB;QAChC,IAAI,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,kBAAkB,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QACzD,KAAK,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,kBAAkB,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QAC1D,mBAAmB,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,kBAAkB,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QACxE,cAAc,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,kBAAkB,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QACnE,gBAAgB,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,kBAAkB,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QACrE,WAAW,EAAE,EAAE;aACZ,EAAE,EAAE;aACJ,kBAAkB,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/E,UAAU,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,kBAAkB,CAAC,GAAG,EAAE,CAC1C,OAAO,CAAC,OAAO,CAAC;YACd,MAAM,EAAE,IAAI;YACZ,IAAI,EAAE,IAAI,QAAQ,CAAC,CAAC,SAAS,EAAE,WAAW,IAAI,IAAI,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;SAC1E,CAAC,CACH;KACF,CAAC;IAEF,IAAI,MAAM,GAAG,KAAK,CAAC;IACnB,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,GAAG,EAAE;QACjC,MAAM,GAAG,IAAI,CAAC;QACd,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC3B,CAAC,CAAC,CAAC;IACH,KAAK,CAAC,KAAK,CAAC,kBAAkB,CAAC,GAAG,EAAE;QAClC,MAAM,GAAG,KAAK,CAAC;QACf,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC3B,CAAC,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG;QACb,QAAQ,EAAE,SAAS,EAAE,QAAQ,IAAI,MAAM;QACvC,SAAS,EAAE,SAAS,EAAE,SAAS,IAAI,MAAM;QACzC,YAAY,EAAE,SAAS,EAAE,YAAY;QACrC,aAAa,EAAE,EAAE,UAAU,EAAE,CAAC,EAAE,eAAe,EAAE,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE;QACvE,IAAI,MAAM;YACR,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,mBAAmB,EAAE,KAAK,CAAC,mBAAmB;QAC9C,cAAc,EAAE,KAAK,CAAC,cAAc;QACpC,gBAAgB,EAAE,KAAK,CAAC,gBAAgB;QACxC,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,UAAU,EAAE,KAAK,CAAC,UAAU;KACL,CAAC;IAE1B,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;AAC3B,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { WebBrotherQLPrinter } from './printer.js';
+export { requestPrinter, fromUSBDevice } from './request.js';
+export type { RequestOptions } from './request.js';
+export type { DeviceDescriptor, MediaDescriptor, PageData, PageOptions, JobOptions, PrinterStatus, TextPrintOptions, ImagePrintOptions, MediaType, } from '@thermal-label/brother-ql-core';
+export { DEVICES, MEDIA, findDevice, findMedia, findMediaByWidth, renderText, renderImage, rotateBitmap, } from '@thermal-label/brother-ql-core';
+export type { LabelBitmap, RawImageData } from '@thermal-label/brother-ql-core';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7D,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,YAAY,EACV,gBAAgB,EAChB,eAAe,EACf,QAAQ,EACR,WAAW,EACX,UAAU,EACV,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EACjB,SAAS,GACV,MAAM,gCAAgC,CAAC;AAExC,OAAO,EACL,OAAO,EACP,KAAK,EACL,UAAU,EACV,SAAS,EACT,gBAAgB,EAChB,UAAU,EACV,WAAW,EACX,YAAY,GACb,MAAM,gCAAgC,CAAC;AACxC,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { WebBrotherQLPrinter } from './printer.js';
+export { requestPrinter, fromUSBDevice } from './request.js';
+export { DEVICES, MEDIA, findDevice, findMedia, findMediaByWidth, renderText, renderImage, rotateBitmap, } from '@thermal-label/brother-ql-core';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAe7D,OAAO,EACL,OAAO,EACP,KAAK,EACL,UAAU,EACV,SAAS,EACT,gBAAgB,EAChB,UAAU,EACV,WAAW,EACX,YAAY,GACb,MAAM,gCAAgC,CAAC"}

package/dist/printer.d.ts

@@ -0,0 +1,16 @@
+import { type DeviceDescriptor, type JobOptions, type MediaDescriptor, type PageData, type PageOptions, type PrinterStatus, type TextPrintOptions, type ImagePrintOptions } from '@thermal-label/brother-ql-core';
+export declare class WebBrotherQLPrinter {
+    readonly device: USBDevice;
+    readonly descriptor: DeviceDescriptor;
+    constructor(device: USBDevice, descriptor: DeviceDescriptor);
+    isConnected(): boolean;
+    getStatus(): Promise<PrinterStatus>;
+    print(pages: PageData[], options?: JobOptions): Promise<void>;
+    printText(text: string, media: MediaDescriptor, options?: TextPrintOptions): Promise<void>;
+    printImage(imageData: ImageData, media: MediaDescriptor, options?: ImagePrintOptions): Promise<void>;
+    printImageURL(url: string, media: MediaDescriptor, options?: ImagePrintOptions): Promise<void>;
+    printTwoColor(blackImageData: ImageData, redImageData: ImageData, media: MediaDescriptor, options?: PageOptions): Promise<void>;
+    disconnect(): Promise<void>;
+}
+export declare function openWebDevice(device: USBDevice): Promise<WebBrotherQLPrinter>;
+//# sourceMappingURL=printer.d.ts.map

package/dist/printer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"printer.d.ts","sourceRoot":"","sources":["../src/printer.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,gBAAgB,EACrB,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,KAAK,QAAQ,EACb,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EAQvB,MAAM,gCAAgC,CAAC;AASxC,qBAAa,mBAAmB;IAC9B,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,gBAAgB,CAAC;gBAE1B,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,gBAAgB;IAK3D,WAAW,IAAI,OAAO;IAIhB,SAAS,IAAI,OAAO,CAAC,aAAa,CAAC;IAOnC,KAAK,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAK7D,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAqB1F,UAAU,CACd,SAAS,EAAE,SAAS,EACpB,KAAK,EAAE,eAAe,EACtB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,IAAI,CAAC;IAuBV,aAAa,CACjB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,eAAe,EACtB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,IAAI,CAAC;IAYV,aAAa,CACjB,cAAc,EAAE,SAAS,EACzB,YAAY,EAAE,SAAS,EACvB,KAAK,EAAE,eAAe,EACtB,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,IAAI,CAAC;IAuBV,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;CAIlC;AAED,wBAAsB,aAAa,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAWnF"}

package/dist/printer.js

@@ -0,0 +1,114 @@
+import { encodeJob, findDevice, parseStatus, renderImage, renderText, rotateBitmap, STATUS_REQUEST, } from '@thermal-label/brother-ql-core';
+const BROTHER_VID = 0x04f9;
+const USB_INTERFACE = 0;
+const BULK_OUT_ENDPOINT = 2;
+const BULK_IN_ENDPOINT = 1;
+const STATUS_BYTE_COUNT = 32;
+const CONFIGURATION_VALUE = 1;
+export class WebBrotherQLPrinter {
+    device;
+    descriptor;
+    constructor(device, descriptor) {
+        this.device = device;
+        this.descriptor = descriptor;
+    }
+    isConnected() {
+        return this.device.opened;
+    }
+    async getStatus() {
+        await this.device.transferOut(BULK_OUT_ENDPOINT, STATUS_REQUEST);
+        const result = await this.device.transferIn(BULK_IN_ENDPOINT, STATUS_BYTE_COUNT);
+        if (!result.data)
+            throw new Error('No status data received');
+        return parseStatus(new Uint8Array(result.data.buffer));
+    }
+    async print(pages, options) {
+        const bytes = encodeJob(pages, options);
+        await this.device.transferOut(BULK_OUT_ENDPOINT, bytes);
+    }
+    async printText(text, media, options) {
+        const { invert, scaleX, scaleY, ...pageOptions } = options ?? {};
+        const base = renderText(text, { scaleX: 1, scaleY: 1 });
+        const autoScale = Math.max(1, Math.floor(media.printAreaDots / Math.max(base.widthPx, base.heightPx)));
+        const rawBitmap = renderText(text, {
+            ...(invert !== undefined ? { invert } : {}),
+            scaleX: scaleX ?? autoScale,
+            scaleY: scaleY ?? autoScale,
+        });
+        const bitmap = rotateBitmap(rawBitmap, 270);
+        const page = {
+            bitmap,
+            media,
+            ...(Object.keys(pageOptions).length > 0 ? { options: pageOptions } : {}),
+        };
+        await this.print([page]);
+    }
+    async printImage(imageData, media, options) {
+        const { threshold, dither, invert, rotate, ...pageOptions } = options ?? {};
+        const rawImage = {
+            width: imageData.width,
+            height: imageData.height,
+            data: new Uint8Array(imageData.data.buffer),
+        };
+        const rawBitmap = renderImage(rawImage, {
+            ...(threshold !== undefined ? { threshold } : {}),
+            ...(dither ? { dither: true } : {}),
+            ...(invert ? { invert: true } : {}),
+        });
+        const rotationAngle = rotate ?? 0;
+        const bitmap = rotationAngle === 0 ? rotateBitmap(rawBitmap, 270) : rotateBitmap(rawBitmap, rotationAngle);
+        const page = {
+            bitmap,
+            media,
+            ...(Object.keys(pageOptions).length > 0 ? { options: pageOptions } : {}),
+        };
+        await this.print([page]);
+    }
+    async printImageURL(url, media, options) {
+        const response = await fetch(url);
+        const blob = await response.blob();
+        const bmp = await createImageBitmap(blob);
+        const canvas = new OffscreenCanvas(bmp.width, bmp.height);
+        const ctx = canvas.getContext('2d');
+        if (!ctx)
+            throw new Error('Could not get canvas context');
+        ctx.drawImage(bmp, 0, 0);
+        const imageData = ctx.getImageData(0, 0, bmp.width, bmp.height);
+        await this.printImage(imageData, media, options);
+    }
+    async printTwoColor(blackImageData, redImageData, media, options) {
+        if (!this.descriptor.twoColor) {
+            throw new Error(`Device ${this.descriptor.name} does not support two-color printing. ` +
+                'Use a QL-800, QL-810W, or QL-820NWB.');
+        }
+        const toRaw = (img) => ({
+            width: img.width,
+            height: img.height,
+            data: new Uint8Array(img.data.buffer),
+        });
+        const blackBitmap = rotateBitmap(renderImage(toRaw(blackImageData)), 270);
+        const redBitmap = rotateBitmap(renderImage(toRaw(redImageData)), 270);
+        const page = {
+            bitmap: blackBitmap,
+            redBitmap,
+            media,
+            ...(options !== undefined ? { options } : {}),
+        };
+        await this.print([page]);
+    }
+    async disconnect() {
+        await this.device.releaseInterface(USB_INTERFACE);
+        await this.device.close();
+    }
+}
+export async function openWebDevice(device) {
+    const descriptor = findDevice(BROTHER_VID, device.productId);
+    if (!descriptor) {
+        throw new Error(`Unsupported device: VID=${BROTHER_VID.toString(16)} PID=${device.productId.toString(16)}`);
+    }
+    await device.open();
+    await device.selectConfiguration(CONFIGURATION_VALUE);
+    await device.claimInterface(USB_INTERFACE);
+    return new WebBrotherQLPrinter(device, descriptor);
+}
+//# sourceMappingURL=printer.js.map

package/dist/printer.js.map

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

package/dist/request.d.ts

@@ -0,0 +1,7 @@
+import { WebBrotherQLPrinter } from './printer.js';
+export interface RequestOptions {
+    filters?: USBDeviceFilter[];
+}
+export declare function requestPrinter(options?: RequestOptions): Promise<WebBrotherQLPrinter>;
+export declare function fromUSBDevice(device: USBDevice): WebBrotherQLPrinter;
+//# sourceMappingURL=request.d.ts.map

package/dist/request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.d.ts","sourceRoot":"","sources":["../src/request.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAiB,MAAM,cAAc,CAAC;AAElE,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,EAAE,eAAe,EAAE,CAAC;CAC7B;AAMD,wBAAsB,cAAc,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAI3F;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,GAAG,mBAAmB,CAMpE"}

package/dist/request.js

@@ -0,0 +1,18 @@
+import { DEVICES, findDevice } from '@thermal-label/brother-ql-core';
+import { WebBrotherQLPrinter, openWebDevice } from './printer.js';
+function defaultFilters() {
+    return Object.values(DEVICES).map(d => ({ vendorId: d.vid, productId: d.pid }));
+}
+export async function requestPrinter(options) {
+    const filters = options?.filters ?? defaultFilters();
+    const device = await navigator.usb.requestDevice({ filters });
+    return openWebDevice(device);
+}
+export function fromUSBDevice(device) {
+    const descriptor = findDevice(0x04f9, device.productId);
+    if (!descriptor) {
+        throw new Error(`Unsupported device: productId=0x${device.productId.toString(16)}`);
+    }
+    return new WebBrotherQLPrinter(device, descriptor);
+}
+//# sourceMappingURL=request.js.map

package/dist/request.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.js","sourceRoot":"","sources":["../src/request.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAMlE,SAAS,cAAc;IACrB,OAAO,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,GAAG,EAAE,SAAS,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;AAClF,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,OAAwB;IAC3D,MAAM,OAAO,GAAG,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,CAAC;IACrD,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;IAC9D,OAAO,aAAa,CAAC,MAAM,CAAC,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,MAAiB;IAC7C,MAAM,UAAU,GAAG,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;IACxD,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,mCAAmC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IACtF,CAAC;IACD,OAAO,IAAI,mBAAmB,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;AACrD,CAAC"}

package/package.json

@@ -0,0 +1,73 @@
+{
+  "name": "@thermal-label/brother-ql-web",
+  "version": "0.0.1",
+  "description": "WebUSB browser driver for Brother QL label printers",
+  "keywords": [
+    "brother",
+    "brother-ql",
+    "label-printer",
+    "thermal-label",
+    "webusb",
+    "browser"
+  ],
+  "type": "module",
+  "author": "Mannes Brak",
+  "license": "MIT",
+  "homepage": "https://thermal-label.github.io/brother-ql/",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/thermal-label/brother-ql.git",
+    "directory": "packages/web"
+  },
+  "bugs": {
+    "url": "https://github.com/thermal-label/brother-ql/issues"
+  },
+  "funding": [
+    {
+      "type": "github",
+      "url": "https://github.com/sponsors/mannes"
+    },
+    {
+      "type": "ko-fi",
+      "url": "https://ko-fi.com/mannes"
+    }
+  ],
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=24.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "types": "./src/index.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./src/index.ts"
+    }
+  },
+  "dependencies": {
+    "@thermal-label/brother-ql-core": "0.0.1"
+  },
+  "peerDependencies": {
+    "typescript": ">=5.0"
+  },
+  "devDependencies": {
+    "@mbtech-nl/tsconfig": "^1.0.0",
+    "@vitest/coverage-v8": "^2.1.9",
+    "jsdom": "^26.1.0",
+    "typescript": "~5.5.0",
+    "vitest": "^2.0.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage"
+  }
+}