Hello World
',\n orientation: 'portrait', // or 'landscape'\n paperSize: { width: 80, height: 297, unit: 'mm' },\n copies: 1,\n});\n```\n\n### `printImage(options)`\n\nPrints an image to a thermal printer using ESC/POS raster format.\n\n```typescript\nawait PMSPrinter.printImage({\n printerId: 'built-in',\n imageBase64: 'data:image/png;base64,iVBOR...',\n width: 384, // Pixel width\n align: 'center', // left, center, right\n paperWidth: 80,\n});\n```\n\n### `printViaSystemDialog(options)`\n\nOpens the system print dialog (AirPrint on iOS, PrintManager on Android).\n\n```typescript\nawait PMSPrinter.printViaSystemDialog({\n html: 'Content here
',\n name: 'Invoice #1234',\n orientation: 'portrait',\n copies: 2,\n monochrome: false,\n});\n```\n\n### `getPrinterStatus(options)`\n\nGets the connection status of a specific printer.\n\n```typescript\nconst status = await PMSPrinter.getPrinterStatus({\n printerId: 'built-in',\n});\n// status: PrinterStatus\n```\n\n### `getBuiltInPrinterStatus()`\n\nGets detailed status of built-in POS printer (Sunmi/PAX/Newland/iMin).\n\n```typescript\nconst status = await PMSPrinter.getBuiltInPrinterStatus();\n// status: BuiltInPrinterStatus\n// { hasBuiltInPrinter: true, manufacturer: 'sunmi', model: 'S2', isReady: true, paperStatus: 'ok' }\n```\n\n### `printParkingReceipt(options)`\n\nPrints a formatted parking receipt with exception, refund, and adjustment handling support.\n\n```typescript\nawait PMSPrinter.printParkingReceipt({\n printerId: 'built-in',\n logoBase64: 'iVBORw0KGgo...', // Logo image as base64 string\n logoPath: '/storage/emulated/0/logo.jpeg', // OR local file path\n // logoPath: 'https://example.com/logo.png', // OR server URL\n logoWidth: 300, // Logo width in pixels\n logoHeight: 150, // Logo height in pixels\n header: 'NEOLYSI PARKING',\n date: 'May 20, 2026',\n ticketNo: 'TKT-001234',\n vehicleType: 'Car',\n vehicleNo: 'TN 01 AB 1234',\n driverName: 'John Doe',\n mobileNo: '9876543210',\n inTime: '10:30 AM',\n outTime: '2:45 PM',\n parkingType: 'PREPAID', // PREPAID or POSTPAID\n duration: '4h 15m',\n amount: '50.00',\n footer: 'Thank You - Drive Safe',\n additionalFareDetails: 'Overnight surcharge applied',\n paperWidth: 58, // 58 or 80 mm\n copies: 1,\n cutPaper: true,\n qrCode: JSON.stringify({ ticketId: 1234, vehicleNo: 'TN 01 AB 1234' }),\n qrCodeSize: 8, // QR module size\n qrCodeAlign: 'center', // left, center, right\n isException: false, // Mark as exception ticket\n exceptionType: '', // e.g. 'Lost Ticket', 'Damaged Vehicle'\n refundReason: '', // e.g. 'Duplicate Entry', 'User Cancellation'\n isAdjustment: false, // Mark as adjustment (prints Yes/No)\n watermark: { // Optional watermark\n type: 'text',\n content: 'PAID',\n density: 30,\n position: 'body',\n },\n});\n```\n\n> **Parking receipt layout:** The header, divider lines, and footer are **centered**. Date, Ticket No, and the detail rows (V.Type / V.No / Driver Name / Mobile No / In Time / Out Time / Exception / Refund / Adjustment / Type / Duration) are printed **left-aligned** in a fixed label column at the **default 1x font**, with the field labels + values in **bold**. The **Paid Amount** line is printed **centered + bold**. To print the body larger, pass `style: { size: { width: 2, height: 2 } }`. When `isException` is set, an **Exception** row prints `exceptionType`; when `refundReason` is set, a **Refund** row prints it; and an **Adjustment** row prints `Yes`/`No` from `isAdjustment`. These fields appear as rows after **Out Time**.\n\n### `getConnectedPrinters()`\n\nLists all currently connected printers.\n\n```typescript\nconst { printers } = await PMSPrinter.getConnectedPrinters();\n```\n\n### Events\n\n```typescript\n// Fired when a BLE printer is discovered during scan\nPMSPrinter.addListener('printerDiscovered', (event: PrinterDiscoveredEvent) => {\n console.log('Printer:', event.printer);\n});\n\n// Fired when a printer connects or disconnects\nPMSPrinter.addListener('connectionStateChanged', (event: ConnectionStateChange) => {\n console.log('State:', event.printerId, event.state);\n});\n\n// Fired when print job progress changes\nPMSPrinter.addListener('printJobStatus', (event: PrintJobStatus) => {\n console.log('Job:', event.jobId, event.status, event.progress);\n});\n\n// Clean up when leaving page\nPMSPrinter.removeAllListeners();\n```\n\n---\n\n## Type Definitions\n\n```typescript\ntype ConnectionType = 'bluetooth_classic' | 'bluetooth_le' | 'wifi' | 'usb' | 'airprint' | 'built_in';\ntype PrinterType = 'thermal' | 'laser' | 'inkjet' | 'label' | 'unknown';\ntype BuiltInManufacturer = 'sunmi' | 'pax' | 'newland' | 'imin' | 'unknown';\ntype PaperWidth = 58 | 80;\ntype PrintOrientation = 'portrait' | 'landscape';\ntype PrintJobState = 'queued' | 'printing' | 'completed' | 'failed';\ntype ConnectionState = 'connected' | 'disconnected' | 'connecting' | 'error';\ntype PaperStatus = 'ok' | 'low' | 'empty' | 'cover_open' | 'overheated' | 'disconnected';\n\ninterface PrinterInfo {\n id: string;\n name: string;\n address?: string;\n connectionType: ConnectionType;\n printerType: PrinterType;\n manufacturer?: string;\n model?: string;\n isConnected: boolean;\n}\n\ninterface PrinterStatus {\n printerId: string;\n isConnected: boolean;\n connectionType: ConnectionType;\n isReady: boolean;\n paperStatus?: PaperStatus;\n batteryLevel?: number;\n error?: string;\n}\n\ninterface BuiltInPrinterStatus {\n hasBuiltInPrinter: boolean;\n manufacturer: BuiltInManufacturer;\n model: string;\n sdkVersion?: string;\n isReady: boolean;\n paperStatus?: PaperStatus;\n}\n\ntype TextAlign = 'left' | 'center' | 'right';\n\ntype FontType = 'font_a' | 'font_b' | 'font_c' | 'font_d' | 'font_e';\n\ninterface FontStyle {\n font?: FontType;\n size?: {\n width: number;\n height: number;\n };\n bold?: boolean;\n underline?: boolean;\n align?: TextAlign;\n}\n\ninterface WatermarkOptions {\n type: 'text' | 'image';\n content: string;\n density?: number;\n position?: 'header' | 'body' | 'footer' | 'all';\n}\n\ninterface ReceiptItem {\n name: string;\n qty?: number;\n price?: number;\n}\n\ninterface ReceiptOptions {\n printerId: string;\n header?: string;\n items?: ReceiptItem[];\n footer?: string;\n qrCode?: string;\n barcode?: string;\n paperWidth: PaperWidth;\n showLogo?: boolean;\n logoBase64?: string;\n logoWidth?: number;\n logoHeight?: number;\n copies?: number;\n cutPaper?: boolean;\n style?: FontStyle;\n headerStyle?: FontStyle;\n footerStyle?: FontStyle;\n qrCodeSize?: number;\n qrCodeAlign?: TextAlign;\n watermark?: WatermarkOptions;\n}\n\ninterface PrintRawOptions {\n printerId: string;\n data: string; // Hex-encoded ESC/POS bytes\n encoding?: 'cp437' | 'cp850' | 'utf8';\n feedLines?: number;\n cutPaper?: boolean;\n}\n\ninterface PrintHtmlOptions {\n printerId?: string; // Omit to use system print dialog\n html: string;\n paperSize?: { width: number; height: number; unit: 'mm' | 'inch' | 'pt' };\n orientation?: PrintOrientation;\n copies?: number;\n}\n\ninterface PrintImageOptions {\n printerId: string;\n imageBase64: string;\n width?: number;\n height?: number;\n align?: 'left' | 'center' | 'right';\n paperWidth?: PaperWidth;\n}\n\ninterface SystemPrintOptions {\n html?: string;\n filePath?: string;\n name?: string;\n orientation?: PrintOrientation;\n copies?: number;\n monochrome?: boolean;\n}\n\ninterface ParkingReceiptOptions {\n printerId: string;\n logoBase64?: string; // Logo image as base64 string\n logoPath?: string; // OR local file path or HTTP(S) URL (auto-converted to base64)\n logoWidth?: number;\n logoHeight?: number;\n header?: string;\n date?: string;\n ticketNo?: string;\n vehicleType?: string;\n vehicleNo?: string;\n driverName?: string;\n mobileNo?: string;\n inTime?: string;\n outTime?: string;\n parkingType?: string;\n duration?: string;\n amount?: string;\n footer?: string;\n additionalFareDetails?: string;\n paperWidth: PaperWidth;\n copies?: number;\n cutPaper?: boolean;\n qrCode?: string;\n qrCodeSize?: number;\n qrCodeAlign?: TextAlign;\n isException?: boolean;\n exceptionType?: string;\n refundReason?: string;\n isAdjustment?: boolean;\n style?: FontStyle;\n headerStyle?: FontStyle;\n footerStyle?: FontStyle;\n watermark?: WatermarkOptions;\n}\n\ninterface DiscoveryOptions {\n timeout?: number;\n connectionTypes?: ConnectionType[];\n}\n```\n\n---\n\n## Platform-Specific Setup\n\n### Android Permissions\n\nAdd to `android/app/src/main/AndroidManifest.xml` (auto-added by the plugin):\n\n```xml\n\nDate: ${new Date().toLocaleDateString()}
\nCustomer: John Doe
\n| Item | Qty | Price |
|---|---|---|
| Widget A | 2 | $19.99 |
Total: $39.98
\n \n \n`;\n\nawait PMSPrinter.printViaSystemDialog({\n html: receiptHtml,\n name: 'Invoice #1234',\n orientation: 'portrait',\n});\n```\n\n### 7. Angular Service Example\n\n```typescript\n// print.service.ts\nimport { Injectable } from '@angular/core';\nimport { PMSPrinter } from '@azarudeen-ahamed/neo-pms-printer';\nimport type { PrinterInfo, ReceiptItem } from '@azarudeen-ahamed/neo-pms-printer';\n\n@Injectable({ providedIn: 'root' })\nexport class PrintService {\n async getBuiltInPrinter() {\n return PMSPrinter.getBuiltInPrinterStatus();\n }\n\n async printReceipt(\n printerId: string,\n header: string,\n items: ReceiptItem[],\n footer: string,\n ) {\n return PMSPrinter.printReceipt({\n printerId,\n header,\n items,\n footer,\n paperWidth: 80,\n cutPaper: true,\n });\n }\n\n async getStatus() {\n return PMSPrinter.getConnectedPrinters();\n }\n}\n```\n\n### 8. React Hook Example\n\n```typescript\n// usePrinter.ts\nimport { useState, useEffect } from 'react';\nimport { PMSPrinter } from '@azarudeen-ahamed/neo-pms-printer';\nimport type { PrinterInfo } from '@azarudeen-ahamed/neo-pms-printer';\n\nexport function usePrinterDiscovery() {\n const [printers, setPrinters] = useState{status}
\n