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

package/src/devices.generated.ts

@@ -0,0 +1,840 @@
+// AUTO-GENERATED by scripts/compile-data.mjs — do not edit by hand.
+// Regenerate with `pnpm --filter @thermal-label/brother-ql-core compile-data`.
+import type { DeviceRegistry } from '@thermal-label/contracts';
+import type { BrotherQLDevice } from './types.js';
+
+export const DEVICE_REGISTRY = {
+  "schemaVersion": 1,
+  "driver": "brother-ql",
+  "devices": [
+    {
+      "key": "PT_E550W",
+      "name": "PT-E550W",
+      "family": "brother-ql",
+      "transports": {
+        "usb": {
+          "vid": "0x04f9",
+          "pid": "0x2060"
+        },
+        "tcp": {
+          "port": 9100
+        }
+      },
+      "engines": [
+        {
+          "role": "primary",
+          "protocol": "pt-raster",
+          "dpi": 180,
+          "headDots": 128,
+          "mediaCompatibility": [
+            "tze",
+            "hse-2to1",
+            "hse-3to1"
+          ],
+          "capabilities": {
+            "autocut": true,
+            "mediaDetection": true,
+            "highResDpi": 360
+          }
+        }
+      ],
+      "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.",
+      "support": {
+        "status": "untested"
+      }
+    },
+    {
+      "key": "PT_P750W",
+      "name": "PT-P750W",
+      "family": "brother-ql",
+      "transports": {
+        "usb": {
+          "vid": "0x04f9",
+          "pid": "0x2062"
+        },
+        "tcp": {
+          "port": 9100
+        }
+      },
+      "engines": [
+        {
+          "role": "primary",
+          "protocol": "pt-raster",
+          "dpi": 180,
+          "headDots": 128,
+          "mediaCompatibility": [
+            "tze",
+            "hse-2to1",
+            "hse-3to1"
+          ],
+          "capabilities": {
+            "autocut": true,
+            "mediaDetection": true,
+            "highResDpi": 360
+          }
+        }
+      ],
+      "capabilities": {
+        "massStoragePid": "0x2065"
+      },
+      "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.",
+      "support": {
+        "status": "untested"
+      }
+    },
+    {
+      "key": "PT_P900",
+      "name": "PT-P900",
+      "family": "brother-ql",
+      "transports": {
+        "usb": {
+          "vid": "0x04f9",
+          "pid": "0x2083"
+        }
+      },
+      "engines": [
+        {
+          "role": "primary",
+          "protocol": "pt-raster",
+          "dpi": 360,
+          "headDots": 560,
+          "mediaCompatibility": [
+            "tze",
+            "hse-2to1",
+            "hse-3to1"
+          ],
+          "capabilities": {
+            "autocut": true,
+            "mediaDetection": true,
+            "highResDpi": 720
+          }
+        }
+      ],
+      "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.",
+      "support": {
+        "status": "untested"
+      }
+    },
+    {
+      "key": "PT_P900W",
+      "name": "PT-P900W",
+      "family": "brother-ql",
+      "transports": {
+        "usb": {
+          "vid": "0x04f9",
+          "pid": "0x2085"
+        },
+        "tcp": {
+          "port": 9100
+        }
+      },
+      "engines": [
+        {
+          "role": "primary",
+          "protocol": "pt-raster",
+          "dpi": 360,
+          "headDots": 560,
+          "mediaCompatibility": [
+            "tze",
+            "hse-2to1",
+            "hse-3to1"
+          ],
+          "capabilities": {
+            "autocut": true,
+            "mediaDetection": true,
+            "highResDpi": 720
+          }
+        }
+      ],
+      "hardwareQuirks": "PID 0x2085 sourced from nbuchwitz/ptouch:PTP900W; not in most public USB-ID databases — phase 4 hardware verification should confirm.",
+      "support": {
+        "status": "untested"
+      }
+    },
+    {
+      "key": "PT_P910BT",
+      "name": "PT-P910BT",
+      "family": "brother-ql",
+      "transports": {
+        "usb": {
+          "vid": "0x04f9",
+          "pid": "0x20c7"
+        },
+        "bluetooth-spp": {
+          "namePrefix": "PT-P910"
+        }
+      },
+      "engines": [
+        {
+          "role": "primary",
+          "protocol": "pt-raster",
+          "dpi": 360,
+          "headDots": 560,
+          "mediaCompatibility": [
+            "tze"
+          ],
+          "capabilities": {
+            "autocut": true,
+            "mediaDetection": true,
+            "highResDpi": 720
+          }
+        }
+      ],
+      "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.",
+      "support": {
+        "status": "untested"
+      }
+    },
+    {
+      "key": "PT_P950NW",
+      "name": "PT-P950NW",
+      "family": "brother-ql",
+      "transports": {
+        "usb": {
+          "vid": "0x04f9",
+          "pid": "0x2086"
+        },
+        "tcp": {
+          "port": 9100
+        }
+      },
+      "engines": [
+        {
+          "role": "primary",
+          "protocol": "pt-raster",
+          "dpi": 360,
+          "headDots": 560,
+          "mediaCompatibility": [
+            "tze",
+            "hse-2to1",
+            "hse-3to1"
+          ],
+          "capabilities": {
+            "autocut": true,
+            "mediaDetection": true,
+            "highResDpi": 720
+          }
+        }
+      ],
+      "hardwareQuirks": "PID 0x2086 sourced from nbuchwitz/ptouch:PTP950NW. Pin configurations from Brother spec cv_ptp900_eng_raster_102.pdf via nbuchwitz/ptouch.",
+      "support": {
+        "status": "untested"
+      }
+    },
+    {
+      "key": "QL_1050",
+      "name": "QL-1050",
+      "family": "brother-ql",
+      "transports": {
+        "usb": {
+          "vid": "0x04f9",
+          "pid": "0x2027"
+        }
+      },
+      "engines": [
+        {
+          "role": "primary",
+          "protocol": "ql-raster",
+          "dpi": 300,
+          "headDots": 1296,
+          "mediaCompatibility": [
+            "dk",
+            "dk-wide"
+          ],
+          "capabilities": {
+            "autocut": true,
+            "mediaDetection": true
+          }
+        }
+      ],
+      "support": {
+        "status": "untested"
+      }
+    },
+    {
+      "key": "QL_1060N",
+      "name": "QL-1060N",
+      "family": "brother-ql",
+      "transports": {
+        "usb": {
+          "vid": "0x04f9",
+          "pid": "0x2028"
+        },
+        "tcp": {
+          "port": 9100
+        }
+      },
+      "engines": [
+        {
+          "role": "primary",
+          "protocol": "ql-raster",
+          "dpi": 300,
+          "headDots": 1296,
+          "mediaCompatibility": [
+            "dk",
+            "dk-wide"
+          ],
+          "capabilities": {
+            "autocut": true,
+            "mediaDetection": true
+          }
+        }
+      ],
+      "support": {
+        "status": "untested"
+      }
+    },
+    {
+      "key": "QL_1100",
+      "name": "QL-1100",
+      "family": "brother-ql",
+      "transports": {
+        "usb": {
+          "vid": "0x04f9",
+          "pid": "0x20a7"
+        }
+      },
+      "engines": [
+        {
+          "role": "primary",
+          "protocol": "ql-raster",
+          "dpi": 300,
+          "headDots": 1296,
+          "mediaCompatibility": [
+            "dk",
+            "dk-wide"
+          ],
+          "capabilities": {
+            "autocut": true,
+            "mediaDetection": true
+          }
+        }
+      ],
+      "capabilities": {
+        "editorLite": true,
+        "massStoragePid": "0x20a9"
+      },
+      "support": {
+        "status": "untested"
+      }
+    },
+    {
+      "key": "QL_1110NWB",
+      "name": "QL-1110NWB",
+      "family": "brother-ql",
+      "transports": {
+        "usb": {
+          "vid": "0x04f9",
+          "pid": "0x20a8"
+        },
+        "tcp": {
+          "port": 9100
+        }
+      },
+      "engines": [
+        {
+          "role": "primary",
+          "protocol": "ql-raster",
+          "dpi": 300,
+          "headDots": 1296,
+          "mediaCompatibility": [
+            "dk",
+            "dk-wide"
+          ],
+          "capabilities": {
+            "autocut": true,
+            "mediaDetection": true
+          }
+        }
+      ],
+      "capabilities": {
+        "editorLite": true,
+        "massStoragePid": "0x20aa"
+      },
+      "support": {
+        "status": "untested"
+      }
+    },
+    {
+      "key": "QL_1115NWB",
+      "name": "QL-1115NWB",
+      "family": "brother-ql",
+      "transports": {
+        "usb": {
+          "vid": "0x04f9",
+          "pid": "0x20ab"
+        },
+        "tcp": {
+          "port": 9100
+        }
+      },
+      "engines": [
+        {
+          "role": "primary",
+          "protocol": "ql-raster",
+          "dpi": 300,
+          "headDots": 1296,
+          "mediaCompatibility": [
+            "dk",
+            "dk-wide"
+          ],
+          "capabilities": {
+            "autocut": true,
+            "mediaDetection": true
+          }
+        }
+      ],
+      "capabilities": {
+        "editorLite": true,
+        "massStoragePid": "0x20ac"
+      },
+      "support": {
+        "status": "untested"
+      }
+    },
+    {
+      "key": "QL_500",
+      "name": "QL-500",
+      "family": "brother-ql",
+      "transports": {
+        "usb": {
+          "vid": "0x04f9",
+          "pid": "0x2013"
+        }
+      },
+      "engines": [
+        {
+          "role": "primary",
+          "protocol": "ql-raster",
+          "dpi": 300,
+          "headDots": 720,
+          "mediaCompatibility": [
+            "dk"
+          ],
+          "capabilities": {
+            "mediaDetection": true
+          }
+        }
+      ],
+      "support": {
+        "status": "untested"
+      }
+    },
+    {
+      "key": "QL_550",
+      "name": "QL-550",
+      "family": "brother-ql",
+      "transports": {
+        "usb": {
+          "vid": "0x04f9",
+          "pid": "0x2016"
+        }
+      },
+      "engines": [
+        {
+          "role": "primary",
+          "protocol": "ql-raster",
+          "dpi": 300,
+          "headDots": 720,
+          "mediaCompatibility": [
+            "dk"
+          ],
+          "capabilities": {
+            "mediaDetection": true
+          }
+        }
+      ],
+      "support": {
+        "status": "untested"
+      }
+    },
+    {
+      "key": "QL_560",
+      "name": "QL-560",
+      "family": "brother-ql",
+      "transports": {
+        "usb": {
+          "vid": "0x04f9",
+          "pid": "0x2018"
+        }
+      },
+      "engines": [
+        {
+          "role": "primary",
+          "protocol": "ql-raster",
+          "dpi": 300,
+          "headDots": 720,
+          "mediaCompatibility": [
+            "dk"
+          ],
+          "capabilities": {
+            "autocut": true,
+            "mediaDetection": true
+          }
+        }
+      ],
+      "support": {
+        "status": "untested"
+      }
+    },
+    {
+      "key": "QL_570",
+      "name": "QL-570",
+      "family": "brother-ql",
+      "transports": {
+        "usb": {
+          "vid": "0x04f9",
+          "pid": "0x2019"
+        }
+      },
+      "engines": [
+        {
+          "role": "primary",
+          "protocol": "ql-raster",
+          "dpi": 300,
+          "headDots": 720,
+          "mediaCompatibility": [
+            "dk"
+          ],
+          "capabilities": {
+            "autocut": true,
+            "mediaDetection": true
+          }
+        }
+      ],
+      "support": {
+        "status": "untested"
+      }
+    },
+    {
+      "key": "QL_580N",
+      "name": "QL-580N",
+      "family": "brother-ql",
+      "transports": {
+        "usb": {
+          "vid": "0x04f9",
+          "pid": "0x201b"
+        },
+        "tcp": {
+          "port": 9100
+        }
+      },
+      "engines": [
+        {
+          "role": "primary",
+          "protocol": "ql-raster",
+          "dpi": 300,
+          "headDots": 720,
+          "mediaCompatibility": [
+            "dk"
+          ],
+          "capabilities": {
+            "autocut": true,
+            "mediaDetection": true
+          }
+        }
+      ],
+      "support": {
+        "status": "untested"
+      }
+    },
+    {
+      "key": "QL_600",
+      "name": "QL-600",
+      "family": "brother-ql",
+      "transports": {
+        "usb": {
+          "vid": "0x04f9",
+          "pid": "0x2100"
+        }
+      },
+      "engines": [
+        {
+          "role": "primary",
+          "protocol": "ql-raster",
+          "dpi": 300,
+          "headDots": 720,
+          "mediaCompatibility": [
+            "dk"
+          ],
+          "capabilities": {
+            "autocut": true,
+            "mediaDetection": true
+          }
+        }
+      ],
+      "support": {
+        "status": "untested"
+      }
+    },
+    {
+      "key": "QL_650TD",
+      "name": "QL-650TD",
+      "family": "brother-ql",
+      "transports": {
+        "usb": {
+          "vid": "0x04f9",
+          "pid": "0x201c"
+        }
+      },
+      "engines": [
+        {
+          "role": "primary",
+          "protocol": "ql-raster",
+          "dpi": 300,
+          "headDots": 720,
+          "mediaCompatibility": [
+            "dk"
+          ],
+          "capabilities": {
+            "autocut": true,
+            "mediaDetection": true
+          }
+        }
+      ],
+      "support": {
+        "status": "untested"
+      }
+    },
+    {
+      "key": "QL_700",
+      "name": "QL-700",
+      "family": "brother-ql",
+      "transports": {
+        "usb": {
+          "vid": "0x04f9",
+          "pid": "0x2042"
+        }
+      },
+      "engines": [
+        {
+          "role": "primary",
+          "protocol": "ql-raster",
+          "dpi": 300,
+          "headDots": 720,
+          "mediaCompatibility": [
+            "dk"
+          ],
+          "capabilities": {
+            "autocut": true,
+            "mediaDetection": true
+          }
+        }
+      ],
+      "capabilities": {
+        "editorLite": true
+      },
+      "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.",
+      "support": {
+        "status": "untested"
+      }
+    },
+    {
+      "key": "QL_710W",
+      "name": "QL-710W",
+      "family": "brother-ql",
+      "transports": {
+        "usb": {
+          "vid": "0x04f9",
+          "pid": "0x2044"
+        },
+        "tcp": {
+          "port": 9100
+        }
+      },
+      "engines": [
+        {
+          "role": "primary",
+          "protocol": "ql-raster",
+          "dpi": 300,
+          "headDots": 720,
+          "mediaCompatibility": [
+            "dk"
+          ],
+          "capabilities": {
+            "autocut": true,
+            "mediaDetection": true
+          }
+        }
+      ],
+      "capabilities": {
+        "editorLite": true
+      },
+      "support": {
+        "status": "untested"
+      }
+    },
+    {
+      "key": "QL_720NW",
+      "name": "QL-720NW",
+      "family": "brother-ql",
+      "transports": {
+        "usb": {
+          "vid": "0x04f9",
+          "pid": "0x2045"
+        },
+        "tcp": {
+          "port": 9100
+        }
+      },
+      "engines": [
+        {
+          "role": "primary",
+          "protocol": "ql-raster",
+          "dpi": 300,
+          "headDots": 720,
+          "mediaCompatibility": [
+            "dk"
+          ],
+          "capabilities": {
+            "autocut": true,
+            "mediaDetection": true
+          }
+        }
+      ],
+      "support": {
+        "status": "untested"
+      }
+    },
+    {
+      "key": "QL_800",
+      "name": "QL-800",
+      "family": "brother-ql",
+      "transports": {
+        "usb": {
+          "vid": "0x04f9",
+          "pid": "0x209b"
+        }
+      },
+      "engines": [
+        {
+          "role": "primary",
+          "protocol": "ql-raster",
+          "dpi": 300,
+          "headDots": 720,
+          "mediaCompatibility": [
+            "dk"
+          ],
+          "capabilities": {
+            "autocut": true,
+            "mediaDetection": true,
+            "twoColor": true
+          }
+        }
+      ],
+      "capabilities": {
+        "editorLite": true
+      },
+      "support": {
+        "status": "untested"
+      }
+    },
+    {
+      "key": "QL_810W",
+      "name": "QL-810W",
+      "family": "brother-ql",
+      "transports": {
+        "usb": {
+          "vid": "0x04f9",
+          "pid": "0x209c"
+        },
+        "tcp": {
+          "port": 9100
+        }
+      },
+      "engines": [
+        {
+          "role": "primary",
+          "protocol": "ql-raster",
+          "dpi": 300,
+          "headDots": 720,
+          "mediaCompatibility": [
+            "dk"
+          ],
+          "capabilities": {
+            "autocut": true,
+            "mediaDetection": true,
+            "twoColor": true
+          }
+        }
+      ],
+      "capabilities": {
+        "editorLite": true
+      },
+      "support": {
+        "status": "untested"
+      }
+    },
+    {
+      "key": "QL_820NWBc",
+      "name": "QL-820NWBc",
+      "family": "brother-ql",
+      "transports": {
+        "usb": {
+          "vid": "0x04f9",
+          "pid": "0x209d"
+        },
+        "tcp": {
+          "port": 9100
+        },
+        "bluetooth-spp": {
+          "namePrefix": "QL-820NWB"
+        }
+      },
+      "engines": [
+        {
+          "role": "primary",
+          "protocol": "ql-raster",
+          "dpi": 300,
+          "headDots": 720,
+          "mediaCompatibility": [
+            "dk"
+          ],
+          "capabilities": {
+            "autocut": true,
+            "mediaDetection": true,
+            "twoColor": true
+          }
+        }
+      ],
+      "capabilities": {
+        "editorLite": true
+      },
+      "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.",
+      "support": {
+        "status": "verified",
+        "transports": {
+          "usb": "verified",
+          "tcp": "verified",
+          "bluetooth-spp": "untested"
+        },
+        "lastVerified": "2026-04-27",
+        "packageVersion": "0.2.1",
+        "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.",
+        "reports": [
+          {
+            "issue": 0,
+            "reporter": "@mannes",
+            "date": "2026-04-27",
+            "result": "verified",
+            "os": "Linux",
+            "selfVerified": true,
+            "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."
+          }
+        ]
+      }
+    }
+  ]
+} as const satisfies DeviceRegistry;
+
+type DeviceKey = (typeof DEVICE_REGISTRY)['devices'][number]['key'];
+
+/**
+ * Per-key map of device entries. Built from the registry array via
+ * `Object.fromEntries`, but typed as `Record<DeviceKey, BrotherQLDevice>`
+ * so consumers can write `DEVICES.QL_820NWBc` and get a precise type
+ * back without literal narrowing leaking into engine capability access.
+ */
+export const DEVICES = Object.fromEntries(
+  DEVICE_REGISTRY.devices.map(d => [d.key, d]),
+) as unknown as Record<DeviceKey, BrotherQLDevice>;