libniimai 0.5.0 → 0.6.0

package/README.md

@@ -1,6 +1,6 @@
 # libniimai
 
-Print from the browser on four families of thermal printers: **NIIMBOT**, **TSPL label printers**, **ESC/POS receipt printers** and **cat printers**. One API connects, detects the printer and prints any canvas, over Web Bluetooth or Web Serial. No server, no drivers, no app.
+Print from the browser on four families of thermal printers: **NIIMBOT**, **TSPL label printers**, **ESC/POS receipt printers** and **cat printers**. One API connects, detects the printer and prints any canvas, over Web Bluetooth, Web Serial or WebUSB. No server, no drivers, no app.
 
 libniimai powers [niimai](https://niimai.app), the label designer.
 
@@ -9,8 +9,8 @@ libniimai powers [niimai](https://niimai.app), the label designer.
 | Family | Paper | Print width | Connection | Models |
 |---|---|---|---|---|
 | **NIIMBOT** | Labels with gaps, black mark, continuous, transparent | 12 mm and up, by model | Bluetooth, USB | D11, D110, D101, B1, B18, B21, B3S and more |
-| **TSPL label printers** | Labels with gaps, black mark, continuous | Up to 80 mm | Bluetooth | QR380A (sold as CC390), Gprinter GP-M322 |
-| **ESC/POS receipt printers** | 58 or 80 mm, continuous or stickers with gaps | 48 or 72 mm | Bluetooth | MP583, MPT-II, Xprinter XP-58IIL, PT-210, RPP02, MPT-3, RPP300 and more |
+| **TSPL label printers** | Labels with gaps, black mark, continuous | Up to 80 mm | Bluetooth, USB | QR380A (sold as CC390), Gprinter GP-M322 |
+| **ESC/POS receipt printers** | 58 or 80 mm, continuous or stickers with gaps | 48 or 72 mm | Bluetooth, USB | MP583, MPT-II, Xprinter XP-58IIL, PT-210, RPP02, MPT-3, RPP300 and more |
 | **Cat printers** | 58 mm continuous, stickers with gaps | 48 mm | Bluetooth | GB01, GB02, GB03, MX05, MX06, MX10 and more |
 
 The family is found from the device the user picks: by its Bluetooth name in `PRINTER_CATALOG`, then checked against the services it offers. A name that matches no family is treated as a NIIMBOT, unless a type from `PRINTER_TYPES` is set for unrecognised printers. Every family gets the same treatment:
@@ -90,7 +90,7 @@ Returns a `PrinterService`, which owns one printer connection.
 
 | Member | What it does |
 | --- | --- |
-| `connect(kind)` | Opens the browser's device picker and connects. `kind` is `'bluetooth'` (every family), `'serial'` (NIIMBOT over USB) or `'demo'` (a printer in memory, for trying things out). |
+| `connect(kind)` | Opens the browser's device picker and connects. `kind` is `'bluetooth'` (every family), `'serial'` (NIIMBOT over USB, as a serial port), `'usb'` (label and receipt printers that show up as standard USB printers) or `'demo'` (a printer in memory, for trying things out). |
 | `disconnect()` | Closes the connection. |
 | `print(source, options)` | Prints a canvas, or a `{ count, page(i) }` source for a batch of different labels. |
 | `getStatus()` | The current `PrinterStatus`. |
@@ -159,14 +159,15 @@ Every piece is exported, for building your own flow:
 - `createClient(kind)` returns a raw client for one connection.
 - `TsplPrinterClient`, `EscPosPrinterClient` and `CatPrinterClient` take any `ThermalTransport`, so they also work over other links.
 - `tsplJob`, `escposJob` and `catJob` build the bytes for one page; `escposFeed` and `catFeed` the bytes that move the paper.
-- `identifyPrinter(name)` matches a Bluetooth name to a known model across every family, from `PRINTER_CATALOG`; `tsplModelFor`, `escposModelFor` and `catModelFor` look in one family.
-- `supportIssue(kind)` says why a connection type cannot be used in the current browser, as `{ reason, topic }`, or null when it can. `topic` names what fixes it: `linux` (a Chrome flag), `brave` (Brave flags), `ios`, `https` or `browsers`. `unsupportedReason(kind)` returns the reason alone.
+- `identifyPrinter(name)` matches a Bluetooth name to a known model across every family, from `PRINTER_CATALOG`; `tsplModelFor`, `escposModelFor` and `catModelFor` look in one family. `identifyUsbPrinter(device)` does the same for a USB device, by vendor and product ID, then product name.
+- `UsbPrinter` connects over WebUSB to a printer-class device (`USB_PRINTER_CLASS`, 7). The family comes from the catalog, then from a type set with `unrecognisedAs` when the printer speaks it, then from the printer's IEEE 1284 device ID (`familiesFromDeviceId`). A printer the site already uses connects without the chooser when it is the only one plugged in; `rememberedUsbPrinters()` lists them. `usbTransport(device)` gives the raw `ThermalTransport`.
+- `supportIssue(kind)` says why a connection type cannot be used in the current browser, as `{ reason, topic }`, or null when it can. `topic` names what fixes it: `linux` (a Chrome flag), `brave` (Brave flags), `ios`, `https`, `usb` (Windows and Linux drivers holding a USB printer) or `browsers`. `unsupportedReason(kind)` returns the reason alone.
 - `detectBrowser()` returns the system, the browser and whether it is built on Chromium.
-- `connectErrorTopic(err)` maps a connect error from a browser that has Bluetooth but cannot use it (adapter off, API turned off) to the same topics.
+- `connectErrorTopic(err)` maps a connect error from a browser that has Bluetooth or USB but cannot use it (adapter off, API turned off, a system driver holding the printer) to the same topics.
 
 ## Browsers
 
-Needs Web Bluetooth or Web Serial: Chrome or Edge on desktop, or Chrome on Android. On iPhone and iPad, the Bluefy browser adds Web Bluetooth. On Linux, Chrome needs `chrome://flags/#enable-web-bluetooth` turned on; Brave keeps both APIs behind `brave://flags`.
+Needs Web Bluetooth, Web Serial or WebUSB: Chrome or Edge on desktop, or Chrome on Android. On iPhone and iPad, the Bluefy browser adds Web Bluetooth. On Linux, Chrome needs `chrome://flags/#enable-web-bluetooth` turned on; Brave keeps Bluetooth and serial behind `brave://flags`. For USB printers, Windows needs the WinUSB driver (Zadig installs it), and Linux needs the `usblp` module unloaded and a udev rule granting access.
 
 ## Feedback
 

package/dist/bluetooth.d.ts

@@ -1,4 +1,4 @@
-import type { ClientLike } from './client.js';
+import { RoutedClient } from './routed.js';
 type Lib = typeof import('@mmote/niimbluelib');
 /**
  * The Bluetooth printer behind the Connect button. One chooser lists NIIMBOT
@@ -9,55 +9,14 @@ type Lib = typeof import('@mmote/niimbluelib');
  * the TSPL client; and everything else the NIIMBOT client exactly as before.
  * Known names never overlap, so each printer matches one client at most.
  */
-export declare class BluetoothPrinter implements ClientLike {
+export declare class BluetoothPrinter extends RoutedClient {
     private lib;
-    private inner;
     constructor(lib: () => Promise<Lib>);
-    private get client();
     /** The kind of printer to treat an unrecognised one as; null leaves it to NIIMBOT. */
     private fallback;
     unrecognisedAs(typeId: string | null): void;
     connect(): Promise<{
         deviceName?: string;
     }>;
-    disconnect(): Promise<void>;
-    isConnected(): boolean;
-    on(event: string, fn: (e: any) => void): unknown;
-    off(event: string, fn: (e: any) => void): unknown;
-    getPrinterInfo(): {
-        batteryPercents?: number;
-        modelId?: number;
-        printheadWidth?: number;
-        protocolVersion?: number;
-    };
-    getModelMetadata(): import("@mmote/niimbluelib").PrinterModelMeta | undefined;
-    getPrintTaskType(): "B1" | "B21_L2B" | "B21_V1" | "D110" | "D110M_V4" | "D11_V1" | "H1S" | undefined;
-    getRfidInfo(): {
-        labelRfidInfo?: {
-            tagPresent?: boolean;
-            barCode?: string;
-            allPaper?: number;
-            usedPaper?: number;
-            consumablesType?: number;
-        };
-        paperInfo?: {
-            valid?: boolean;
-            paperWidth?: number;
-            paperHeight?: number;
-            paperType?: number;
-        };
-    };
-    fetchRfidInfo(): Promise<unknown>;
-    startHeartbeat(): void;
-    stopHeartbeat(): void;
-    isHeartbeatStarted(): boolean;
-    get protocol(): {
-        newPrintTask(name: import("@mmote/niimbluelib").PrintTaskName, options: Record<string, unknown>): import("./client.js").PrintTaskLike;
-        printEnd(): Promise<boolean>;
-    };
-    get encodePage(): ((canvas: HTMLCanvasElement) => unknown) | undefined;
-    get rollKey(): (() => string) | undefined;
-    get feedPaper(): ((dots: number) => Promise<void>) | undefined;
-    get feedsBack(): boolean | undefined;
 }
 export {};

package/dist/catalog.d.ts

@@ -1,4 +1,12 @@
-import { type ThermalModel } from './thermal.js';
+/**
+ * Every printer outside NIIMBOT that libniimai knows, by Bluetooth name, in
+ * one lookup across families. A name matches one family at most, and a name
+ * that matches none is known to be unknown before anything is sent to it.
+ * The models themselves live with their family: ESCPOS_MODELS, TSPL_MODELS
+ * and CAT_MODELS.
+ */
+import type { ClientLike } from './client.js';
+import { type Pace, type ThermalModel, type ThermalTransport } from './thermal.js';
 export type PrinterFamily = 'escpos' | 'tspl' | 'cat';
 export interface CatalogEntry {
     family: PrinterFamily;
@@ -7,6 +15,18 @@ export interface CatalogEntry {
 export declare const PRINTER_CATALOG: CatalogEntry[];
 /** The known printer a Bluetooth name belongs to, longest prefix first across every family. */
 export declare function identifyPrinter(name: string | undefined): CatalogEntry | null;
+/** The known printer behind a USB device: by its vendor and product IDs, then by its product name. */
+export declare function identifyUsbPrinter({ vendorId, productId, productName }: {
+    vendorId: number;
+    productId: number;
+    productName?: string;
+}): CatalogEntry | null;
+/**
+ * The client for a thermal printer over a cable link. Cat printers are
+ * Bluetooth only, so they get null. `ackTimeoutMs`: how long a label printer
+ * waits for its "OK" before asking for its status.
+ */
+export declare function cableClient({ family, model }: CatalogEntry, transport: ThermalTransport, pace: Pace, ackTimeoutMs: number): ClientLike | null;
 /** A kind of printer to pick for one niimai does not recognise. */
 export interface PrinterType extends CatalogEntry {
     id: string;

package/dist/client.d.ts

@@ -67,9 +67,11 @@ export interface ClientLike {
      */
     unrecognisedAs?(typeId: string | null): void;
 }
-export type ConnectionKind = 'bluetooth' | 'serial' | 'demo';
+/** `serial`: a printer on a USB cable that shows up as a serial port, as NIIMBOT printers do. `usb`: one that shows up as a standard USB printer. */
+export type ConnectionKind = 'bluetooth' | 'serial' | 'usb' | 'demo';
 export declare const supportsBluetooth: () => boolean;
 export declare const supportsSerial: () => boolean;
+export declare const supportsUsb: () => boolean;
 export type Platform = 'ios' | 'android' | 'desktop';
 export declare function detectPlatform(ua?: string, touchPoints?: number): Platform;
 export type OperatingSystem = 'ios' | 'android' | 'chromeos' | 'linux' | 'mac' | 'windows' | 'other';
@@ -77,7 +79,7 @@ export type BrowserName = 'chrome' | 'edge' | 'opera' | 'brave' | 'samsung' | 'b
 export interface BrowserInfo {
     os: OperatingSystem;
     browser: BrowserName;
-    /** Built on Chromium, so Web Bluetooth and Web Serial can be there. */
+    /** Built on Chromium, so Web Bluetooth, Web Serial and WebUSB can be there. */
     chromium: boolean;
     /** Served over https or from localhost; browsers hide both APIs elsewhere. */
     secure: boolean;
@@ -98,8 +100,9 @@ export declare function detectBrowser(env?: Partial<BrowserEnv>): BrowserInfo;
  * - `ios`: iPhone and iPad browsers, and Bluefy.
  * - `https`: the page has to be served over https.
  * - `browsers`: which browsers work.
+ * - `usb`: Windows and Linux hold on to USB printers until told to let the browser have them.
  */
-export type SetupTopic = 'linux' | 'brave' | 'ios' | 'https' | 'browsers';
+export type SetupTopic = 'linux' | 'brave' | 'ios' | 'https' | 'browsers' | 'usb';
 export interface SupportIssue {
     /** In a few words, what is missing or what to do. */
     reason: string;
@@ -113,8 +116,8 @@ export declare function supportIssue(kind: ConnectionKind, env?: Partial<Browser
 /** supportIssue's reason alone. */
 export declare function unsupportedReason(kind: ConnectionKind, platform?: Platform): string | null;
 /**
- * Errors browsers raise when Bluetooth is there but cannot be used: the
- * adapter is off or missing, or the browser turned the API off. The Help topic
- * to point to, or null.
+ * Errors browsers raise when Bluetooth or USB is there but cannot be used:
+ * the adapter is off or missing, the browser turned the API off, or the
+ * system keeps a USB printer for itself. The Help topic to point to, or null.
  */
 export declare function connectErrorTopic(err: unknown): SetupTopic | null;

package/dist/index.d.ts

@@ -1,11 +1,13 @@
 /// <reference types="web-bluetooth" preserve="true" />
 /// <reference types="w3c-web-serial" preserve="true" />
+/// <reference types="w3c-web-usb" preserve="true" />
 import type { ClientLike, ConnectionKind } from './client.js';
 import { PrinterService, type ClientFactory } from './service.js';
 /**
  * A client for one kind of connection. Bluetooth finds the printer family
- * from the device the user picks; serial is NIIMBOT only; demo is a printer
- * in memory.
+ * from the device the user picks; serial is NIIMBOT only; usb is for label
+ * and receipt printers that show up as standard USB printers; demo is a
+ * printer in memory.
  */
 export declare function createClient(kind: ConnectionKind): Promise<ClientLike>;
 export interface CreatePrinterOptions {
@@ -19,15 +21,16 @@ export interface CreatePrinterOptions {
 export declare function createPrinter(options?: CreatePrinterOptions): PrinterService;
 export { PrinterService, DEMO_NAME, friendlyError, fitToPrinthead, rotateCanvas, shiftCanvas } from './service.js';
 export type { ClientFactory, PageSource, PrinterState, PrinterStatus, PrintOffset, PrintOptions, Rotation } from './service.js';
-export { connectErrorTopic, detectBrowser, detectPlatform, supportIssue, supportsBluetooth, supportsSerial, unsupportedReason } from './client.js';
+export { connectErrorTopic, detectBrowser, detectPlatform, supportIssue, supportsBluetooth, supportsSerial, supportsUsb, unsupportedReason } from './client.js';
 export type { BrowserEnv, BrowserInfo, BrowserName, ClientLike, ConnectionKind, OperatingSystem, Platform, PrintTaskLike, SetupTopic, SupportIssue } from './client.js';
 export { correctTask, findManualProfile, inkOutsideHead, MANUAL_PROFILES, printheadCrop, printheadMm, resolveProfile } from './profiles.js';
 export type { LabelSize, PrintDirection, PrinterProfile } from './profiles.js';
 export { effectivePaper, labelTypeOf, PAPER_TYPES, paperFromLabelType, paperName } from './paper.js';
 export type { PaperType } from './paper.js';
-export { findPrinterType, identifyPrinter, PRINTER_CATALOG, PRINTER_TYPES } from './catalog.js';
+export { findPrinterType, identifyPrinter, identifyUsbPrinter, PRINTER_CATALOG, PRINTER_TYPES } from './catalog.js';
 export type { CatalogEntry, PrinterFamily, PrinterType } from './catalog.js';
 export { BluetoothPrinter } from './bluetooth.js';
+export { familiesFromDeviceId, parseDeviceId, rememberedUsbPrinters, UsbPrinter, usbTransport, USB_PRINTER_CLASS } from './usb.js';
 export { describeBleError } from './ble.js';
 export { DEMO_META, MockClient } from './mock.js';
 export { modelFor, THERMAL_DEFAULT_SIZE, THERMAL_HEAD_DOTS, THERMAL_HEAD_MM, THERMAL_SIZES, ThermalPrinterClient, webTransport } from './thermal.js';

package/dist/libniimai.js

@@ -227,7 +227,7 @@ var ThermalPrinterClient = class {
 	constructor(transport, pace, firstChunk) {
 		this.transport = transport;
 		this.pace = pace;
-		this.chunk = firstChunk;
+		this.chunk = transport.chunkBytes ?? firstChunk;
 		transport.onDisconnect(() => {
 			this.connected = false;
 			this.emit("disconnect", {});
@@ -868,7 +868,8 @@ var DOTS_PER_MM = 8;
 var TSPL_MODELS = [{
 	prefix: "QR380A",
 	confidence: "tested",
-	note: "Sold as CC390"
+	note: "Sold as CC390",
+	usbIds: [[10473, 649]]
 }, {
 	prefix: "GP-M322",
 	confidence: "medium",
@@ -1033,13 +1034,6 @@ var TsplPrinterClient = class extends ThermalPrinterClient {
 	}
 };
 // src/catalog.ts
-/**
-* Every printer outside NIIMBOT that libniimai knows, by Bluetooth name, in
-* one lookup across families. A name matches one family at most, and a name
-* that matches none is known to be unknown before anything is sent to it.
-* The models themselves live with their family: ESCPOS_MODELS, TSPL_MODELS
-* and CAT_MODELS.
-*/
 var PRINTER_CATALOG = [
 	...ESCPOS_MODELS.map((model) => ({
 		family: "escpos",
@@ -1061,6 +1055,20 @@ function identifyPrinter(name) {
 	for (const entry of PRINTER_CATALOG) if (name.startsWith(entry.model.prefix) && entry.model.prefix.length > (best?.model.prefix.length ?? 0)) best = entry;
 	return best;
 }
+/** The known printer behind a USB device: by its vendor and product IDs, then by its product name. */
+function identifyUsbPrinter({ vendorId, productId, productName }) {
+	return PRINTER_CATALOG.find((e) => e.model.usbIds?.some(([v, p]) => v === vendorId && p === productId)) ?? identifyPrinter(productName);
+}
+/**
+* The client for a thermal printer over a cable link. Cat printers are
+* Bluetooth only, so they get null. `ackTimeoutMs`: how long a label printer
+* waits for its "OK" before asking for its status.
+*/
+function cableClient({ family, model }, transport, pace, ackTimeoutMs) {
+	if (family === "tspl") return new TsplPrinterClient(transport, model, pace, ackTimeoutMs);
+	if (family === "escpos") return new EscPosPrinterClient(transport, model, pace);
+	return null;
+}
 /** The kinds of printer an unrecognised one can be set to, alongside NIIMBOT's MANUAL_PROFILES. */
 var PRINTER_TYPES = [
 	{
@@ -1108,6 +1116,70 @@ var PRINTER_TYPES = [
 	}
 ];
 var findPrinterType = (id) => PRINTER_TYPES.find((t) => t.id === id) ?? null;
+// src/routed.ts
+/**
+* A client that picks the real client when it connects, then passes
+* everything through to it: the Bluetooth and USB printers behind the
+* Connect buttons.
+*/
+var RoutedClient = class {
+	inner = null;
+	get client() {
+		if (!this.inner) throw new Error("Not connected");
+		return this.inner;
+	}
+	async disconnect() {
+		await this.inner?.disconnect();
+	}
+	isConnected() {
+		return !!this.inner?.isConnected();
+	}
+	on(event, fn) {
+		return this.client.on(event, fn);
+	}
+	off(event, fn) {
+		return this.inner?.off(event, fn);
+	}
+	getPrinterInfo() {
+		return this.inner?.getPrinterInfo() ?? {};
+	}
+	getModelMetadata() {
+		return this.inner?.getModelMetadata();
+	}
+	getPrintTaskType() {
+		return this.inner?.getPrintTaskType();
+	}
+	getRfidInfo() {
+		return this.inner?.getRfidInfo() ?? {};
+	}
+	fetchRfidInfo() {
+		return this.client.fetchRfidInfo();
+	}
+	startHeartbeat() {
+		this.inner?.startHeartbeat();
+	}
+	stopHeartbeat() {
+		this.inner?.stopHeartbeat();
+	}
+	isHeartbeatStarted() {
+		return !!this.inner?.isHeartbeatStarted?.();
+	}
+	get protocol() {
+		return this.client.protocol;
+	}
+	get encodePage() {
+		return this.inner?.encodePage?.bind(this.inner);
+	}
+	get rollKey() {
+		return this.inner?.rollKey?.bind(this.inner);
+	}
+	get feedPaper() {
+		return this.inner?.feedPaper?.bind(this.inner);
+	}
+	get feedsBack() {
+		return this.inner?.feedsBack;
+	}
+};
 // src/bluetooth.ts
 /**
 * A writable characteristic on one of the serial services budget printers
@@ -1124,7 +1196,7 @@ async function writeChannel(server, services) {
 	}
 	return null;
 }
-var PRINTER_TYPE_NAMES = {
+var PRINTER_TYPE_NAMES$1 = {
 	escpos: "receipt printer",
 	tspl: "label printer",
 	cat: "cat printer"
@@ -1164,16 +1236,12 @@ function looksNiimbot(lib, name) {
 * the TSPL client; and everything else the NIIMBOT client exactly as before.
 * Known names never overlap, so each printer matches one client at most.
 */
-var BluetoothPrinter = class {
+var BluetoothPrinter = class extends RoutedClient {
 	lib;
-	inner = null;
 	constructor(lib) {
+		super();
 		this.lib = lib;
 	}
-	get client() {
-		if (!this.inner) throw new Error("Not connected");
-		return this.inner;
-	}
 	/** The kind of printer to treat an unrecognised one as; null leaves it to NIIMBOT. */
 	fallback = null;
 	unrecognisedAs(typeId) {
@@ -1189,7 +1257,7 @@ var BluetoothPrinter = class {
 			const services = (await server.getPrimaryServices().catch(() => [])).map((s) => s.uuid);
 			this.inner = await thermalClient(device, server, services, entry);
 			if (this.inner) return this.inner.connect();
-			if (!known) throw new Error(`${device.name ?? "This printer"} does not offer a ${PRINTER_TYPE_NAMES[entry.family]} service`);
+			if (!known) throw new Error(`${device.name ?? "This printer"} does not offer a ${PRINTER_TYPE_NAMES$1[entry.family]} service`);
 		}
 		const lib = await this.lib();
 		this.inner = createBleClient(lib, device);
@@ -1200,57 +1268,6 @@ var BluetoothPrinter = class {
 			throw new Error(`${device.name ?? "This printer"} did not answer as a NIIMBOT. If it is another kind, pick its type under Advanced and connect again.`);
 		}
 	}
-	async disconnect() {
-		await this.inner?.disconnect();
-	}
-	isConnected() {
-		return !!this.inner?.isConnected();
-	}
-	on(event, fn) {
-		return this.client.on(event, fn);
-	}
-	off(event, fn) {
-		return this.inner?.off(event, fn);
-	}
-	getPrinterInfo() {
-		return this.inner?.getPrinterInfo() ?? {};
-	}
-	getModelMetadata() {
-		return this.inner?.getModelMetadata();
-	}
-	getPrintTaskType() {
-		return this.inner?.getPrintTaskType();
-	}
-	getRfidInfo() {
-		return this.inner?.getRfidInfo() ?? {};
-	}
-	fetchRfidInfo() {
-		return this.client.fetchRfidInfo();
-	}
-	startHeartbeat() {
-		this.inner?.startHeartbeat();
-	}
-	stopHeartbeat() {
-		this.inner?.stopHeartbeat();
-	}
-	isHeartbeatStarted() {
-		return !!this.inner?.isHeartbeatStarted?.();
-	}
-	get protocol() {
-		return this.client.protocol;
-	}
-	get encodePage() {
-		return this.inner?.encodePage?.bind(this.inner);
-	}
-	get rollKey() {
-		return this.inner?.rollKey?.bind(this.inner);
-	}
-	get feedPaper() {
-		return this.inner?.feedPaper?.bind(this.inner);
-	}
-	get feedsBack() {
-		return this.inner?.feedsBack;
-	}
 };
 // src/mock.ts
 /** A printer that only exists in memory. Used by the demo mode and the tests. */
@@ -1621,7 +1638,7 @@ function withTimeout(p, ms) {
 /** Translates the library's error codes and messages into short, readable ones. */
 function friendlyError(err) {
 	const msg = err instanceof Error ? err.message : String(err);
-	if (/user cancelled|no device selected|chooser/i.test(msg)) return "Connection cancelled";
+	if (/user cancelled|no (device|port) selected|chooser/i.test(msg)) return "Connection cancelled";
 	if (/timeout waiting for the printer to finish/i.test(msg)) return "The printer did not confirm the print";
 	if (/timeout/i.test(msg)) return "Printer stopped responding";
 	if (/lid|cover/i.test(msg)) return "Close the printer lid";
@@ -1883,6 +1900,12 @@ var PrinterService = class {
 // src/client.ts
 var supportsBluetooth = () => typeof navigator !== "undefined" && "bluetooth" in navigator;
 var supportsSerial = () => typeof navigator !== "undefined" && "serial" in navigator;
+var supportsUsb = () => typeof navigator !== "undefined" && "usb" in navigator;
+var SUPPORTS = {
+	bluetooth: supportsBluetooth,
+	serial: supportsSerial,
+	usb: supportsUsb
+};
 function detectPlatform(ua = typeof navigator === "undefined" ? "" : navigator.userAgent, touchPoints = typeof navigator === "undefined" ? 0 : navigator.maxTouchPoints) {
 	if (/iPhone|iPad|iPod/.test(ua) || /Macintosh/.test(ua) && touchPoints > 1) return "ios";
 	if (/Android/.test(ua)) return "android";
@@ -1928,7 +1951,7 @@ var BROWSER_NAMES = {
 */
 function supportIssue(kind, env = {}) {
 	if (kind === "demo") return null;
-	if (kind === "bluetooth" ? supportsBluetooth() : supportsSerial()) return null;
+	if (SUPPORTS[kind]()) return null;
 	const { os, browser, chromium, secure } = detectBrowser(env);
 	const bluetooth = kind === "bluetooth";
 	if (os === "ios") return {
@@ -1994,36 +2017,182 @@ function unsupportedReason(kind, platform) {
 	return supportIssue(kind, platform ? PLATFORM_ENVS[platform] : {})?.reason ?? null;
 }
 /**
-* Errors browsers raise when Bluetooth is there but cannot be used: the
-* adapter is off or missing, or the browser turned the API off. The Help topic
-* to point to, or null.
+* Errors browsers raise when Bluetooth or USB is there but cannot be used:
+* the adapter is off or missing, the browser turned the API off, or the
+* system keeps a USB printer for itself. The Help topic to point to, or null.
 */
 function connectErrorTopic(err) {
 	const message = err instanceof Error ? err.message : String(err);
 	if (/globally disabled/i.test(message)) return "brave";
+	if (/claim interface|Access denied|Unable to open device/i.test(message)) return "usb";
 	if (/adapter not available|Bluetooth adapter|Bluetooth is (turned off|disabled|not available)/i.test(message)) return detectBrowser().os === "linux" ? "linux" : "browsers";
 	return null;
 }
+// src/usb.ts
+/**
+* Label and receipt printers on a USB cable that show up as standard USB
+* printers (interface class 7), which Web Serial cannot see. They take the
+* same TSPL or ESC/POS bytes as over Bluetooth, through WebUSB. NIIMBOT
+* printers show up as serial ports and keep using Web Serial.
+*/
+var USB_PRINTER_CLASS = 7;
+/** USB moves data far faster than Bluetooth and paces itself, so writes are large and back to back. */
+var USB_PACE = {
+	chunkMs: 0,
+	pauseMs: 100
+};
+var USB_CHUNK = 4096;
+/** Label printers may not send "OK" over USB; a status query after this long tells a fault from a quiet printer. */
+var USB_ACK_TIMEOUT_MS = 5e3;
+/**
+* The fields of an IEEE 1284 device ID, keys in capitals:
+* "MFG:ACME;COMMAND SET:TSC/ESC/POS;MODEL:CC390;" → { MFG, 'COMMAND SET', MODEL }.
+*/
+function parseDeviceId(text) {
+	const fields = {};
+	for (const part of text.split(";")) {
+		const at = part.indexOf(":");
+		if (at > 0) fields[part.slice(0, at).trim().toUpperCase()] = part.slice(at + 1).trim();
+	}
+	return fields;
+}
+/** The printer languages a device ID names, TSPL first: label printers often take ESC/POS as well. */
+function familiesFromDeviceId(text) {
+	const id = parseDeviceId(text);
+	const commands = id.CMD ?? id["COMMAND SET"] ?? "";
+	const families = [];
+	if (/\b(TSPL2?|TSC)\b/i.test(commands)) families.push("tspl");
+	if (/ESC\/?POS|\bEPSON\b/i.test(commands)) families.push("escpos");
+	return families;
+}
+var isPrinter = (device) => device.configuration?.interfaces.some((i) => i.alternates.some((a) => a.interfaceClass === 7)) ?? true;
+/** USB printers this site may already use that are plugged in. */
+async function rememberedUsbPrinters() {
+	if (!supportsUsb()) return [];
+	return (await navigator.usb.getDevices().catch(() => [])).filter(isPrinter);
+}
+/** Opens a USB printer and claims its printer interface. Also reads the printer's device ID. */
+async function usbTransport(device) {
+	await device.open();
+	if (!device.configuration) await device.selectConfiguration(1);
+	const iface = device.configuration.interfaces.find((i) => i.alternates.some((a) => a.interfaceClass === 7));
+	if (!iface) throw new Error(`${device.productName ?? "This device"} is not a USB printer`);
+	const alt = iface.alternates.find((a) => a.interfaceClass === 7);
+	await device.claimInterface(iface.interfaceNumber);
+	if (alt.alternateSetting !== 0) await device.selectAlternateInterface(iface.interfaceNumber, alt.alternateSetting);
+	const out = alt.endpoints.find((e) => e.direction === "out" && e.type === "bulk");
+	const back = alt.endpoints.find((e) => e.direction === "in" && e.type === "bulk");
+	if (!out) throw new Error(`${device.productName ?? "This printer"} has no way to send it data`);
+	const deviceId = await device.controlTransferIn({
+		requestType: "class",
+		recipient: "interface",
+		request: 0,
+		value: 0,
+		index: iface.interfaceNumber << 8 | alt.alternateSetting
+	}, 1024).then((r) => r.data ? new TextDecoder().decode(new Uint8Array(r.data.buffer, r.data.byteOffset + 2, Math.max(0, r.data.byteLength - 2))) : "").catch(() => "");
+	const notify = [];
+	const gone = [];
+	let open = true;
+	if (back) (async () => {
+		while (open) {
+			const r = await device.transferIn(back.endpointNumber, back.packetSize).catch(() => null);
+			if (!r) break;
+			if (r.data?.byteLength) notify.forEach((fn) => fn(new Uint8Array(r.data.buffer.slice(r.data.byteOffset, r.data.byteOffset + r.data.byteLength))));
+		}
+	})();
+	const onUnplug = (e) => {
+		if (e.device !== device) return;
+		open = false;
+		navigator.usb.removeEventListener("disconnect", onUnplug);
+		gone.forEach((fn) => fn());
+	};
+	navigator.usb.addEventListener("disconnect", onUnplug);
+	return {
+		deviceId,
+		transport: {
+			name: device.productName || void 0,
+			chunkBytes: USB_CHUNK,
+			write: async (chunk) => {
+				if ((await device.transferOut(out.endpointNumber, chunk.slice())).status !== "ok") throw new Error("The printer did not take the data");
+			},
+			onNotify: (fn) => notify.push(fn),
+			onDisconnect: (fn) => gone.push(fn),
+			disconnect: async () => {
+				open = false;
+				navigator.usb.removeEventListener("disconnect", onUnplug);
+				await device.releaseInterface(iface.interfaceNumber).catch(() => {});
+				await device.close().catch(() => {});
+			}
+		}
+	};
+}
+var PRINTER_TYPE_NAMES = {
+	escpos: "receipt printer",
+	tspl: "label printer",
+	cat: "cat printer"
+};
+/**
+* The USB printer behind the USB button for label and receipt printers. A
+* printer this site already uses connects straight away when it is the only
+* one plugged in; otherwise the browser lists USB printers. The printer's
+* language comes from the catalog, then from the type picked under Advanced
+* when the printer speaks it (or does not say), then from the device ID the
+* printer reports.
+*/
+var UsbPrinter = class extends RoutedClient {
+	fallback = null;
+	unrecognisedAs(typeId) {
+		this.fallback = findPrinterType(typeId);
+	}
+	async connect() {
+		const remembered = await rememberedUsbPrinters();
+		const device = remembered.length === 1 ? remembered[0] : await navigator.usb.requestDevice({ filters: [{ classCode: 7 }] });
+		const { transport, deviceId } = await usbTransport(device);
+		const name = device.productName || "This printer";
+		const families = familiesFromDeviceId(deviceId);
+		const picked = this.fallback && (!families.length || families.includes(this.fallback.family)) ? this.fallback : null;
+		const entry = identifyUsbPrinter(device) ?? picked ?? (families.length ? {
+			family: families[0],
+			model: {
+				prefix: "",
+				confidence: "medium",
+				generic: true
+			}
+		} : null);
+		if (!entry) {
+			await transport.disconnect();
+			throw new Error(`${name} did not say which printer language it speaks. Pick its type under Advanced and connect again.`);
+		}
+		this.inner = cableClient(entry, transport, USB_PACE, USB_ACK_TIMEOUT_MS);
+		if (!this.inner) {
+			await transport.disconnect();
+			throw new Error(`A ${PRINTER_TYPE_NAMES[entry.family]} cannot print over USB`);
+		}
+		return this.inner.connect();
+	}
+};
 // src/index.ts
 /**
 * libniimai: connect to NIIMBOT, TSPL, ESC/POS and cat printers from the
-* browser over Web Bluetooth or Web Serial, and print a canvas on them.
+* browser over Web Bluetooth, Web Serial or WebUSB, and print a canvas on them.
 */
 var niimbot = () => import("@mmote/niimbluelib");
 /**
 * A client for one kind of connection. Bluetooth finds the printer family
-* from the device the user picks; serial is NIIMBOT only; demo is a printer
-* in memory.
+* from the device the user picks; serial is NIIMBOT only; usb is for label
+* and receipt printers that show up as standard USB printers; demo is a
+* printer in memory.
 */
 async function createClient(kind) {
 	if (kind === "demo") return new MockClient();
 	if (kind === "bluetooth") return new BluetoothPrinter(niimbot);
+	if (kind === "usb") return new UsbPrinter();
 	return new (await (niimbot())).NiimbotSerialClient();
 }
 /** A ready printer service: connect, watch its status, print canvases. */
 function createPrinter(options = {}) {
 	return new PrinterService(options.createClient ?? createClient, async (canvas, direction) => (await niimbot()).ImageEncoder.encodeCanvas(canvas, 0, direction));
 }
-export { BluetoothPrinter, CAT_MODELS, CAT_UNSUPPORTED, CatPrinterClient, DEMO_META, DEMO_NAME, ESCPOS_MODELS, EscPosPrinterClient, MANUAL_PROFILES, MockClient, PAPER_TYPES, PRINTER_CATALOG, PRINTER_TYPES, PrinterService, THERMAL_DEFAULT_SIZE, THERMAL_HEAD_DOTS, THERMAL_HEAD_MM, THERMAL_SIZES, TSPL_MODELS, TSPL_SIZES, ThermalPrinterClient, TsplPrinterClient, catFeed, printJob as catJob, catModelFor, connectErrorTopic, correctTask, createClient, createPrinter, describeBleError, detectBrowser, detectPlatform, effectivePaper, escposFeed, escposJob, escposModelFor, findManualProfile, findPrinterType, fitToPrinthead, friendlyError, identifyPrinter, inkOutsideHead, labelTypeOf, modelFor, paperFromLabelType, paperName, printheadCrop, printheadMm, resolveProfile, rotateCanvas, shiftCanvas, supportIssue, supportsBluetooth, supportsSerial, tsplJob, tsplModelFor, unsupportedReason, webTransport };
+export { BluetoothPrinter, CAT_MODELS, CAT_UNSUPPORTED, CatPrinterClient, DEMO_META, DEMO_NAME, ESCPOS_MODELS, EscPosPrinterClient, MANUAL_PROFILES, MockClient, PAPER_TYPES, PRINTER_CATALOG, PRINTER_TYPES, PrinterService, THERMAL_DEFAULT_SIZE, THERMAL_HEAD_DOTS, THERMAL_HEAD_MM, THERMAL_SIZES, TSPL_MODELS, TSPL_SIZES, ThermalPrinterClient, TsplPrinterClient, USB_PRINTER_CLASS, UsbPrinter, catFeed, printJob as catJob, catModelFor, connectErrorTopic, correctTask, createClient, createPrinter, describeBleError, detectBrowser, detectPlatform, effectivePaper, escposFeed, escposJob, escposModelFor, familiesFromDeviceId, findManualProfile, findPrinterType, fitToPrinthead, friendlyError, identifyPrinter, identifyUsbPrinter, inkOutsideHead, labelTypeOf, modelFor, paperFromLabelType, paperName, parseDeviceId, printheadCrop, printheadMm, rememberedUsbPrinters, resolveProfile, rotateCanvas, shiftCanvas, supportIssue, supportsBluetooth, supportsSerial, supportsUsb, tsplJob, tsplModelFor, unsupportedReason, usbTransport, webTransport };
 
 //# sourceMappingURL=libniimai.js.map