@thermal-label/brother-ql-core 0.5.0 → 0.6.0

package/dist/devices.d.ts

@@ -1,6 +1,715 @@
 import type { BrotherQLDevice } from './types.js';
-import { DEVICES, DEVICE_REGISTRY } from './devices.generated.js';
-export { DEVICE_REGISTRY, DEVICES };
+import { DEVICES } from './devices.generated.js';
+export declare const DEVICE_REGISTRY: {
+    readonly schemaVersion: 1;
+    readonly driver: "brother-ql";
+    readonly devices: readonly [{
+        readonly key: "PT_E550W";
+        readonly name: "PT-E550W";
+        readonly family: "brother-ql";
+        readonly transports: {
+            readonly usb: {
+                readonly vid: "0x04f9";
+                readonly pid: "0x2060";
+            };
+            readonly tcp: {
+                readonly port: 9100;
+            };
+        };
+        readonly engines: readonly [{
+            readonly role: "primary";
+            readonly protocol: "pt-raster";
+            readonly dpi: 180;
+            readonly headDots: 128;
+            readonly mediaCompatibility: readonly ["tze", "hse-2to1", "hse-3to1"];
+            readonly capabilities: {
+                readonly autocut: true;
+                readonly mediaDetection: true;
+                readonly highResDpi: 360;
+            };
+        }];
+        readonly hardwareQuirks: "Cutter requires compression to be enabled — encoder enforces this when (autocut: true && compress: false). Source: nbuchwitz/ptouch:PTE550W (\"E550W requires compression ON for cutting to work\"). Pin configurations from Brother spec cv_pte550wp750wp710bt_eng_raster_102.pdf p.20 §2.3, transcribed into media.json5 via nbuchwitz/ptouch.";
+        readonly support: {
+            readonly status: "untested";
+        };
+        readonly supportStatus: "unverified";
+    }, {
+        readonly key: "PT_P750W";
+        readonly name: "PT-P750W";
+        readonly family: "brother-ql";
+        readonly transports: {
+            readonly usb: {
+                readonly vid: "0x04f9";
+                readonly pid: "0x2062";
+            };
+            readonly tcp: {
+                readonly port: 9100;
+            };
+        };
+        readonly engines: readonly [{
+            readonly role: "primary";
+            readonly protocol: "pt-raster";
+            readonly dpi: 180;
+            readonly headDots: 128;
+            readonly mediaCompatibility: readonly ["tze", "hse-2to1", "hse-3to1"];
+            readonly capabilities: {
+                readonly autocut: true;
+                readonly mediaDetection: true;
+                readonly highResDpi: 360;
+            };
+        }];
+        readonly capabilities: {
+            readonly massStoragePid: "0x2065";
+        };
+        readonly hardwareQuirks: "PID disagreement between driver projects on which mode 0x2062 vs 0x2065 represents: libptouch.c says 0x2062 is the printer PID and 0x2065 is PLite mass-storage; nbuchwitz/ptouch says 0x2065 is the printer PID. We treat libptouch.c as authoritative; flip via a contributor report if discovery fails on real hardware. Pin configurations from Brother spec cv_pte550wp750wp710bt_eng_raster_102.pdf p.20 §2.3.";
+        readonly support: {
+            readonly status: "untested";
+        };
+        readonly supportStatus: "unverified";
+    }, {
+        readonly key: "PT_P900";
+        readonly name: "PT-P900";
+        readonly family: "brother-ql";
+        readonly transports: {
+            readonly usb: {
+                readonly vid: "0x04f9";
+                readonly pid: "0x2083";
+            };
+        };
+        readonly engines: readonly [{
+            readonly role: "primary";
+            readonly protocol: "pt-raster";
+            readonly dpi: 360;
+            readonly headDots: 560;
+            readonly mediaCompatibility: readonly ["tze", "hse-2to1", "hse-3to1"];
+            readonly capabilities: {
+                readonly autocut: true;
+                readonly mediaDetection: true;
+                readonly highResDpi: 720;
+            };
+        }];
+        readonly hardwareQuirks: "Pin configurations from Brother spec cv_ptp900_eng_raster_102.pdf pp.23-24 §2.3.5, transcribed into media.json5 via nbuchwitz/ptouch:PTP900Series. Note nbuchwitz/ptouch:PTP900Series.DEFAULT_USE_COMPRESSION = False — unlike PT-E550W, P900 does NOT require compression for the cutter.";
+        readonly support: {
+            readonly status: "untested";
+        };
+        readonly supportStatus: "unverified";
+    }, {
+        readonly key: "PT_P900W";
+        readonly name: "PT-P900W";
+        readonly family: "brother-ql";
+        readonly transports: {
+            readonly usb: {
+                readonly vid: "0x04f9";
+                readonly pid: "0x2085";
+            };
+            readonly tcp: {
+                readonly port: 9100;
+            };
+        };
+        readonly engines: readonly [{
+            readonly role: "primary";
+            readonly protocol: "pt-raster";
+            readonly dpi: 360;
+            readonly headDots: 560;
+            readonly mediaCompatibility: readonly ["tze", "hse-2to1", "hse-3to1"];
+            readonly capabilities: {
+                readonly autocut: true;
+                readonly mediaDetection: true;
+                readonly highResDpi: 720;
+            };
+        }];
+        readonly hardwareQuirks: "PID 0x2085 sourced from nbuchwitz/ptouch:PTP900W; not in most public USB-ID databases — phase 4 hardware verification should confirm.";
+        readonly support: {
+            readonly status: "untested";
+        };
+        readonly supportStatus: "unverified";
+    }, {
+        readonly key: "PT_P910BT";
+        readonly name: "PT-P910BT";
+        readonly family: "brother-ql";
+        readonly transports: {
+            readonly usb: {
+                readonly vid: "0x04f9";
+                readonly pid: "0x20c7";
+            };
+            readonly "bluetooth-spp": {
+                readonly namePrefix: "PT-P910";
+            };
+        };
+        readonly engines: readonly [{
+            readonly role: "primary";
+            readonly protocol: "pt-raster";
+            readonly dpi: 360;
+            readonly headDots: 560;
+            readonly mediaCompatibility: readonly ["tze"];
+            readonly capabilities: {
+                readonly autocut: true;
+                readonly mediaDetection: true;
+                readonly highResDpi: 720;
+            };
+        }];
+        readonly hardwareQuirks: "Bluetooth assumed classic SPP per nbuchwitz/ptouch — phase 4 hardware verification should confirm classic vs BLE GATT before users rely on it. HSe heat-shrink unsupported (TZe-only); engine.mediaCompatibility excludes hse-2to1 and hse-3to1 so the lookup never returns those entries.";
+        readonly support: {
+            readonly status: "untested";
+        };
+        readonly supportStatus: "unverified";
+    }, {
+        readonly key: "PT_P950NW";
+        readonly name: "PT-P950NW";
+        readonly family: "brother-ql";
+        readonly transports: {
+            readonly usb: {
+                readonly vid: "0x04f9";
+                readonly pid: "0x2086";
+            };
+            readonly tcp: {
+                readonly port: 9100;
+            };
+        };
+        readonly engines: readonly [{
+            readonly role: "primary";
+            readonly protocol: "pt-raster";
+            readonly dpi: 360;
+            readonly headDots: 560;
+            readonly mediaCompatibility: readonly ["tze", "hse-2to1", "hse-3to1"];
+            readonly capabilities: {
+                readonly autocut: true;
+                readonly mediaDetection: true;
+                readonly highResDpi: 720;
+            };
+        }];
+        readonly hardwareQuirks: "PID 0x2086 sourced from nbuchwitz/ptouch:PTP950NW. Pin configurations from Brother spec cv_ptp900_eng_raster_102.pdf via nbuchwitz/ptouch.";
+        readonly support: {
+            readonly status: "untested";
+        };
+        readonly supportStatus: "unverified";
+    }, {
+        readonly key: "QL_1050";
+        readonly name: "QL-1050";
+        readonly family: "brother-ql";
+        readonly transports: {
+            readonly usb: {
+                readonly vid: "0x04f9";
+                readonly pid: "0x2027";
+            };
+        };
+        readonly engines: readonly [{
+            readonly role: "primary";
+            readonly protocol: "ql-raster";
+            readonly dpi: 300;
+            readonly headDots: 1296;
+            readonly mediaCompatibility: readonly ["dk", "dk-wide"];
+            readonly capabilities: {
+                readonly autocut: true;
+                readonly mediaDetection: true;
+            };
+        }];
+        readonly support: {
+            readonly status: "untested";
+        };
+        readonly supportStatus: "expected";
+    }, {
+        readonly key: "QL_1060N";
+        readonly name: "QL-1060N";
+        readonly family: "brother-ql";
+        readonly transports: {
+            readonly usb: {
+                readonly vid: "0x04f9";
+                readonly pid: "0x2028";
+            };
+            readonly tcp: {
+                readonly port: 9100;
+            };
+        };
+        readonly engines: readonly [{
+            readonly role: "primary";
+            readonly protocol: "ql-raster";
+            readonly dpi: 300;
+            readonly headDots: 1296;
+            readonly mediaCompatibility: readonly ["dk", "dk-wide"];
+            readonly capabilities: {
+                readonly autocut: true;
+                readonly mediaDetection: true;
+            };
+        }];
+        readonly support: {
+            readonly status: "untested";
+        };
+        readonly supportStatus: "expected";
+    }, {
+        readonly key: "QL_1100";
+        readonly name: "QL-1100";
+        readonly family: "brother-ql";
+        readonly transports: {
+            readonly usb: {
+                readonly vid: "0x04f9";
+                readonly pid: "0x20a7";
+            };
+        };
+        readonly engines: readonly [{
+            readonly role: "primary";
+            readonly protocol: "ql-raster";
+            readonly dpi: 300;
+            readonly headDots: 1296;
+            readonly mediaCompatibility: readonly ["dk", "dk-wide"];
+            readonly capabilities: {
+                readonly autocut: true;
+                readonly mediaDetection: true;
+            };
+        }];
+        readonly capabilities: {
+            readonly editorLite: true;
+            readonly massStoragePid: "0x20a9";
+        };
+        readonly support: {
+            readonly status: "untested";
+        };
+        readonly supportStatus: "expected";
+    }, {
+        readonly key: "QL_1110NWB";
+        readonly name: "QL-1110NWB";
+        readonly family: "brother-ql";
+        readonly transports: {
+            readonly usb: {
+                readonly vid: "0x04f9";
+                readonly pid: "0x20a8";
+            };
+            readonly tcp: {
+                readonly port: 9100;
+            };
+        };
+        readonly engines: readonly [{
+            readonly role: "primary";
+            readonly protocol: "ql-raster";
+            readonly dpi: 300;
+            readonly headDots: 1296;
+            readonly mediaCompatibility: readonly ["dk", "dk-wide"];
+            readonly capabilities: {
+                readonly autocut: true;
+                readonly mediaDetection: true;
+            };
+        }];
+        readonly capabilities: {
+            readonly editorLite: true;
+            readonly massStoragePid: "0x20aa";
+        };
+        readonly support: {
+            readonly status: "untested";
+        };
+        readonly supportStatus: "expected";
+    }, {
+        readonly key: "QL_1115NWB";
+        readonly name: "QL-1115NWB";
+        readonly family: "brother-ql";
+        readonly transports: {
+            readonly usb: {
+                readonly vid: "0x04f9";
+                readonly pid: "0x20ab";
+            };
+            readonly tcp: {
+                readonly port: 9100;
+            };
+        };
+        readonly engines: readonly [{
+            readonly role: "primary";
+            readonly protocol: "ql-raster";
+            readonly dpi: 300;
+            readonly headDots: 1296;
+            readonly mediaCompatibility: readonly ["dk", "dk-wide"];
+            readonly capabilities: {
+                readonly autocut: true;
+                readonly mediaDetection: true;
+            };
+        }];
+        readonly capabilities: {
+            readonly editorLite: true;
+            readonly massStoragePid: "0x20ac";
+        };
+        readonly support: {
+            readonly status: "untested";
+        };
+        readonly supportStatus: "expected";
+    }, {
+        readonly key: "QL_500";
+        readonly name: "QL-500";
+        readonly family: "brother-ql";
+        readonly transports: {
+            readonly usb: {
+                readonly vid: "0x04f9";
+                readonly pid: "0x2013";
+            };
+        };
+        readonly engines: readonly [{
+            readonly role: "primary";
+            readonly protocol: "ql-raster";
+            readonly dpi: 300;
+            readonly headDots: 720;
+            readonly mediaCompatibility: readonly ["dk"];
+            readonly capabilities: {
+                readonly mediaDetection: true;
+            };
+        }];
+        readonly support: {
+            readonly status: "untested";
+        };
+        readonly supportStatus: "expected";
+    }, {
+        readonly key: "QL_550";
+        readonly name: "QL-550";
+        readonly family: "brother-ql";
+        readonly transports: {
+            readonly usb: {
+                readonly vid: "0x04f9";
+                readonly pid: "0x2016";
+            };
+        };
+        readonly engines: readonly [{
+            readonly role: "primary";
+            readonly protocol: "ql-raster";
+            readonly dpi: 300;
+            readonly headDots: 720;
+            readonly mediaCompatibility: readonly ["dk"];
+            readonly capabilities: {
+                readonly mediaDetection: true;
+            };
+        }];
+        readonly support: {
+            readonly status: "untested";
+        };
+        readonly supportStatus: "expected";
+    }, {
+        readonly key: "QL_560";
+        readonly name: "QL-560";
+        readonly family: "brother-ql";
+        readonly transports: {
+            readonly usb: {
+                readonly vid: "0x04f9";
+                readonly pid: "0x2018";
+            };
+        };
+        readonly engines: readonly [{
+            readonly role: "primary";
+            readonly protocol: "ql-raster";
+            readonly dpi: 300;
+            readonly headDots: 720;
+            readonly mediaCompatibility: readonly ["dk"];
+            readonly capabilities: {
+                readonly autocut: true;
+                readonly mediaDetection: true;
+            };
+        }];
+        readonly support: {
+            readonly status: "untested";
+        };
+        readonly supportStatus: "expected";
+    }, {
+        readonly key: "QL_570";
+        readonly name: "QL-570";
+        readonly family: "brother-ql";
+        readonly transports: {
+            readonly usb: {
+                readonly vid: "0x04f9";
+                readonly pid: "0x2019";
+            };
+        };
+        readonly engines: readonly [{
+            readonly role: "primary";
+            readonly protocol: "ql-raster";
+            readonly dpi: 300;
+            readonly headDots: 720;
+            readonly mediaCompatibility: readonly ["dk"];
+            readonly capabilities: {
+                readonly autocut: true;
+                readonly mediaDetection: true;
+            };
+        }];
+        readonly support: {
+            readonly status: "untested";
+        };
+        readonly supportStatus: "expected";
+    }, {
+        readonly key: "QL_580N";
+        readonly name: "QL-580N";
+        readonly family: "brother-ql";
+        readonly transports: {
+            readonly usb: {
+                readonly vid: "0x04f9";
+                readonly pid: "0x201b";
+            };
+            readonly tcp: {
+                readonly port: 9100;
+            };
+        };
+        readonly engines: readonly [{
+            readonly role: "primary";
+            readonly protocol: "ql-raster";
+            readonly dpi: 300;
+            readonly headDots: 720;
+            readonly mediaCompatibility: readonly ["dk"];
+            readonly capabilities: {
+                readonly autocut: true;
+                readonly mediaDetection: true;
+            };
+        }];
+        readonly support: {
+            readonly status: "untested";
+        };
+        readonly supportStatus: "expected";
+    }, {
+        readonly key: "QL_600";
+        readonly name: "QL-600";
+        readonly family: "brother-ql";
+        readonly transports: {
+            readonly usb: {
+                readonly vid: "0x04f9";
+                readonly pid: "0x2100";
+            };
+        };
+        readonly engines: readonly [{
+            readonly role: "primary";
+            readonly protocol: "ql-raster";
+            readonly dpi: 300;
+            readonly headDots: 720;
+            readonly mediaCompatibility: readonly ["dk"];
+            readonly capabilities: {
+                readonly autocut: true;
+                readonly mediaDetection: true;
+            };
+        }];
+        readonly support: {
+            readonly status: "untested";
+        };
+        readonly supportStatus: "expected";
+    }, {
+        readonly key: "QL_650TD";
+        readonly name: "QL-650TD";
+        readonly family: "brother-ql";
+        readonly transports: {
+            readonly usb: {
+                readonly vid: "0x04f9";
+                readonly pid: "0x201c";
+            };
+        };
+        readonly engines: readonly [{
+            readonly role: "primary";
+            readonly protocol: "ql-raster";
+            readonly dpi: 300;
+            readonly headDots: 720;
+            readonly mediaCompatibility: readonly ["dk"];
+            readonly capabilities: {
+                readonly autocut: true;
+                readonly mediaDetection: true;
+            };
+        }];
+        readonly support: {
+            readonly status: "untested";
+        };
+        readonly supportStatus: "expected";
+    }, {
+        readonly key: "QL_700";
+        readonly name: "QL-700";
+        readonly family: "brother-ql";
+        readonly transports: {
+            readonly usb: {
+                readonly vid: "0x04f9";
+                readonly pid: "0x2042";
+            };
+        };
+        readonly engines: readonly [{
+            readonly role: "primary";
+            readonly protocol: "ql-raster";
+            readonly dpi: 300;
+            readonly headDots: 720;
+            readonly mediaCompatibility: readonly ["dk"];
+            readonly capabilities: {
+                readonly autocut: true;
+                readonly mediaDetection: true;
+            };
+        }];
+        readonly capabilities: {
+            readonly editorLite: true;
+        };
+        readonly hardwareQuirks: "Cassette-based media detection. Printer hard-rejects with an error code if the host job dimensions do not match the loaded DK cassette. Apps that compare detected vs selected media should switch to the matching cassette before sending.";
+        readonly support: {
+            readonly status: "untested";
+        };
+        readonly supportStatus: "expected";
+    }, {
+        readonly key: "QL_710W";
+        readonly name: "QL-710W";
+        readonly family: "brother-ql";
+        readonly transports: {
+            readonly usb: {
+                readonly vid: "0x04f9";
+                readonly pid: "0x2044";
+            };
+            readonly tcp: {
+                readonly port: 9100;
+            };
+        };
+        readonly engines: readonly [{
+            readonly role: "primary";
+            readonly protocol: "ql-raster";
+            readonly dpi: 300;
+            readonly headDots: 720;
+            readonly mediaCompatibility: readonly ["dk"];
+            readonly capabilities: {
+                readonly autocut: true;
+                readonly mediaDetection: true;
+            };
+        }];
+        readonly capabilities: {
+            readonly editorLite: true;
+        };
+        readonly support: {
+            readonly status: "untested";
+        };
+        readonly supportStatus: "expected";
+    }, {
+        readonly key: "QL_720NW";
+        readonly name: "QL-720NW";
+        readonly family: "brother-ql";
+        readonly transports: {
+            readonly usb: {
+                readonly vid: "0x04f9";
+                readonly pid: "0x2045";
+            };
+            readonly tcp: {
+                readonly port: 9100;
+            };
+        };
+        readonly engines: readonly [{
+            readonly role: "primary";
+            readonly protocol: "ql-raster";
+            readonly dpi: 300;
+            readonly headDots: 720;
+            readonly mediaCompatibility: readonly ["dk"];
+            readonly capabilities: {
+                readonly autocut: true;
+                readonly mediaDetection: true;
+            };
+        }];
+        readonly support: {
+            readonly status: "untested";
+        };
+        readonly supportStatus: "expected";
+    }, {
+        readonly key: "QL_800";
+        readonly name: "QL-800";
+        readonly family: "brother-ql";
+        readonly transports: {
+            readonly usb: {
+                readonly vid: "0x04f9";
+                readonly pid: "0x209b";
+            };
+        };
+        readonly engines: readonly [{
+            readonly role: "primary";
+            readonly protocol: "ql-raster";
+            readonly dpi: 300;
+            readonly headDots: 720;
+            readonly mediaCompatibility: readonly ["dk"];
+            readonly capabilities: {
+                readonly autocut: true;
+                readonly mediaDetection: true;
+                readonly twoColor: true;
+            };
+        }];
+        readonly capabilities: {
+            readonly editorLite: true;
+        };
+        readonly support: {
+            readonly status: "untested";
+        };
+        readonly supportStatus: "expected";
+    }, {
+        readonly key: "QL_810W";
+        readonly name: "QL-810W";
+        readonly family: "brother-ql";
+        readonly transports: {
+            readonly usb: {
+                readonly vid: "0x04f9";
+                readonly pid: "0x209c";
+            };
+            readonly tcp: {
+                readonly port: 9100;
+            };
+        };
+        readonly engines: readonly [{
+            readonly role: "primary";
+            readonly protocol: "ql-raster";
+            readonly dpi: 300;
+            readonly headDots: 720;
+            readonly mediaCompatibility: readonly ["dk"];
+            readonly capabilities: {
+                readonly autocut: true;
+                readonly mediaDetection: true;
+                readonly twoColor: true;
+            };
+        }];
+        readonly capabilities: {
+            readonly editorLite: true;
+        };
+        readonly support: {
+            readonly status: "untested";
+        };
+        readonly supportStatus: "expected";
+    }, {
+        readonly key: "QL_820NWBc";
+        readonly name: "QL-820NWBc";
+        readonly family: "brother-ql";
+        readonly transports: {
+            readonly usb: {
+                readonly vid: "0x04f9";
+                readonly pid: "0x209d";
+            };
+            readonly tcp: {
+                readonly port: 9100;
+            };
+            readonly "bluetooth-spp": {
+                readonly namePrefix: "QL-820NWB";
+            };
+        };
+        readonly engines: readonly [{
+            readonly role: "primary";
+            readonly protocol: "ql-raster";
+            readonly dpi: 300;
+            readonly headDots: 720;
+            readonly mediaCompatibility: readonly ["dk"];
+            readonly capabilities: {
+                readonly autocut: true;
+                readonly mediaDetection: true;
+                readonly twoColor: true;
+            };
+        }];
+        readonly capabilities: {
+            readonly editorLite: true;
+        };
+        readonly hardwareQuirks: "QL-820NWB and QL-820NWBc share PID 0x209d; this entry covers both marketing names. Bluetooth on this device is classic SPP (paired at the OS level via RFCOMM), not GATT — the runtime serial implementation opens the OS-paired RFCOMM device path. macOS dropped classic Bluetooth SPP support so that route is unavailable there; Linux and Windows both work.";
+        readonly support: {
+            readonly status: "verified";
+            readonly transports: {
+                readonly usb: "verified";
+                readonly tcp: "verified";
+                readonly "bluetooth-spp": "untested";
+            };
+            readonly lastVerified: "2026-04-27";
+            readonly packageVersion: "0.2.1";
+            readonly quirks: "Reference test device. Two-colour printing on DK-22251 confirmed, auto-cut works on USB and TCP, WebUSB demo prints correctly. The QL-820NWB and QL-820NWBc share PID 0x209d; this entry covers both marketing names.";
+            readonly reports: readonly [{
+                readonly issue: 0;
+                readonly reporter: "@mannes";
+                readonly date: "2026-04-27";
+                readonly result: "verified";
+                readonly os: "Linux";
+                readonly selfVerified: true;
+                readonly notes: "Bench verification by the maintainer at the time of seeding this entry. Issue #0 is a placeholder — replace with the real issue number when a public verification report is filed.";
+            }];
+        };
+        readonly supportStatus: "verified";
+    }];
+};
+export { DEVICES };
 /**
  * Numeric VID/PID extracted from a device's USB transport.
  *