@naphatjm/cdh-thermal-printer 1.0.0

package/README.md

@@ -0,0 +1,65 @@
+# CDH Thermal Printer
+
+A JavaScript library for controlling ESC/POS thermal printers with support for Thai text rendering.
+
+## Installation
+
+```bash
+npm install cdh-thermal-printer
+```
+
+## Usage
+
+### Basic Setup
+
+```javascript
+import { ThermalPrinter } from "cdh-thermal-printer";
+
+const printer = new ThermalPrinter("http://localhost:9123", 384);
+
+printer
+    .init()
+    .align(1) // center
+    .bold(true)
+    .printThaiText("สวัสดีครับ")
+    .feed(2)
+    .cut()
+    .print("Printer Name");
+```
+
+## ⚠️ Important: Font Setup for Thai Text
+
+When using `printThaiText()`, you **must** load the Sarabun font in your HTML file:
+
+```html
+<link
+    href="https://fonts.googleapis.com/css2?family=Sarabun:wght@400;700&display=swap"
+    rel="stylesheet" />
+```
+
+Without this link, the printer will use the default system font instead of Sarabun.
+
+## API
+
+### Constructor
+
+```javascript
+new ThermalPrinter((driverApiUrl = "http://localhost:9123"), (width = 384));
+```
+
+- `driverApiUrl`: URL of the thermal printer driver API
+- `width`: Printer width in dots (384 = 58mm, 576 = 80mm)
+
+### Methods
+
+- `init()` - Initialize printer
+- `align(alignment)` - Set text alignment (0=Left, 1=Center, 2=Right)
+- `bold(enable)` - Enable/disable bold text
+- `feed(lines)` - Feed paper by specified lines
+- `cut(partial)` - Cut paper (partial or full)
+- `image(imageData)` - Print image from canvas ImageData
+- `printThaiText(text, fontSize)` - Print Thai text (automatically renders as image)
+- `clear()` - Clear buffer
+- `getBuffer()` - Get current buffer as Uint8Array
+- `print(printerName)` - Send buffer to printer
+- `static getPrinters(apiUrl)` - Get list of available printers

package/dist/thermal-printer.es.js

@@ -0,0 +1,119 @@
+const o = {
+  LF: 10,
+  // Commands
+  INIT: [27, 64],
+  // Initialize printer
+  CUT_FULL: [29, 86, 66, 0],
+  // Full cut
+  CUT_PARTIAL: [29, 86, 65, 0],
+  // Partial cut
+  // Formatting
+  BOLD_ON: [27, 69, 1],
+  BOLD_OFF: [27, 69, 0],
+  ALIGN_LEFT: [27, 97, 0]
+};
+function p(u) {
+  const e = u.width, t = u.height, s = u.data, r = e / 8;
+  let n = [];
+  n.push(29, 118, 48, 0), n.push(r % 256, Math.floor(r / 256)), n.push(t % 256, Math.floor(t / 256));
+  for (let h = 0; h < t; h++)
+    for (let c = 0; c < r; c++) {
+      let f = 0;
+      for (let i = 0; i < 8; i++) {
+        const a = (h * e + c * 8 + i) * 4;
+        s[a] + s[a + 1] + s[a + 2] < 380 && (f |= 1 << 7 - i);
+      }
+      n.push(f);
+    }
+  return n;
+}
+class x {
+  constructor(e = "http://localhost:9123", t = 384) {
+    this.driverApi = e, this.printerWidth = t, this.buffer = [];
+  }
+  // --- Basic Commands ---
+  init() {
+    return this.buffer.push(...o.INIT), this;
+  }
+  align(e = 1) {
+    const t = [...o.ALIGN_LEFT];
+    return t[2] = e, this.buffer.push(...t), this;
+  }
+  bold(e = !0) {
+    return this.buffer.push(...e ? o.BOLD_ON : o.BOLD_OFF), this;
+  }
+  feed(e = 1) {
+    for (let t = 0; t < e; t++) this.buffer.push(o.LF);
+    return this;
+  }
+  cut(e = !1) {
+    return this.buffer.push(...e ? o.CUT_PARTIAL : o.CUT_FULL), this;
+  }
+  // --- Image & Thai Text Logic ---
+  image(e) {
+    const t = p(e);
+    return this.buffer.push(...t), this;
+  }
+  /**
+   * พิมพ์ข้อความภาษาไทย (Render เป็นรูปภาพอัตโนมัติ)
+   *
+   * ⚠️ REQUIRED: Sarabun font must be loaded in your HTML file:
+   * <link href="https://fonts.googleapis.com/css2?family=Sarabun:wght@400;700&display=swap" rel="stylesheet">
+   *
+   * Without this link, the system will use the default font instead.
+   *
+   * @param {string} text - Thai text to print
+   * @param {number} fontSize - Font size in pixels (default: 22)
+   */
+  printThaiText(e, t = 22) {
+    if (typeof document > "u")
+      return console.error("Browser environment required for printThaiText"), this;
+    const s = document.createElement("canvas"), r = s.getContext("2d"), n = "'Sarabun', sans-serif", h = t + 12, c = e.split(`
+`), f = c.length * h + 20;
+    s.width = this.printerWidth, s.height = f, r.fillStyle = "white", r.fillRect(0, 0, s.width, s.height), r.fillStyle = "black", r.font = `${t}px ${n}`, r.textBaseline = "top";
+    let i = 10;
+    for (let l of c)
+      r.fillText(l, 10, i), i += h;
+    const a = r.getImageData(0, 0, this.printerWidth, f);
+    return this.image(a);
+  }
+  // --- Execution ---
+  clear() {
+    return this.buffer = [], this;
+  }
+  getBuffer() {
+    return new Uint8Array(this.buffer);
+  }
+  async print(e) {
+    if (!e) {
+      const t = await x.getPrinters(this.driverApi);
+      if (t.length > 0) e = t[0];
+      else throw new Error("No printer found.");
+    }
+    try {
+      const t = this.getBuffer(), s = encodeURIComponent(e);
+      if (!(await fetch(
+        `${this.driverApi}/print?printer=${s}`,
+        {
+          method: "POST",
+          headers: { "Content-Type": "application/octet-stream" },
+          body: t
+        }
+      )).ok) throw new Error("Driver Error");
+      return this.clear(), { success: !0 };
+    } catch (t) {
+      throw console.error("Print Failed:", t), t;
+    }
+  }
+  // --- Static Methods ---
+  static async getPrinters(e = "http://localhost:9123") {
+    try {
+      return await (await fetch(`${e}/printers`)).json();
+    } catch (t) {
+      return console.error("Connection Error:", t), [];
+    }
+  }
+}
+export {
+  x as ThermalPrinter
+};

package/dist/thermal-printer.umd.js

@@ -0,0 +1,2 @@
+(function(h,n){typeof exports=="object"&&typeof module<"u"?n(exports):typeof define=="function"&&define.amd?define(["exports"],n):(h=typeof globalThis<"u"?globalThis:h||self,n(h.ThermalPrinter={}))})(this,(function(h){"use strict";const n={LF:10,INIT:[27,64],CUT_FULL:[29,86,66,0],CUT_PARTIAL:[29,86,65,0],BOLD_ON:[27,69,1],BOLD_OFF:[27,69,0],ALIGN_LEFT:[27,97,0]};function x(d){const e=d.width,t=d.height,i=d.data,r=e/8;let s=[];s.push(29,118,48,0),s.push(r%256,Math.floor(r/256)),s.push(t%256,Math.floor(t/256));for(let c=0;c<t;c++)for(let f=0;f<r;f++){let u=0;for(let o=0;o<8;o++){const l=(c*e+f*8+o)*4;i[l]+i[l+1]+i[l+2]<380&&(u|=1<<7-o)}s.push(u)}return s}class a{constructor(e="http://localhost:9123",t=384){this.driverApi=e,this.printerWidth=t,this.buffer=[]}init(){return this.buffer.push(...n.INIT),this}align(e=1){const t=[...n.ALIGN_LEFT];return t[2]=e,this.buffer.push(...t),this}bold(e=!0){return this.buffer.push(...e?n.BOLD_ON:n.BOLD_OFF),this}feed(e=1){for(let t=0;t<e;t++)this.buffer.push(n.LF);return this}cut(e=!1){return this.buffer.push(...e?n.CUT_PARTIAL:n.CUT_FULL),this}image(e){const t=x(e);return this.buffer.push(...t),this}printThaiText(e,t=22){if(typeof document>"u")return console.error("Browser environment required for printThaiText"),this;const i=document.createElement("canvas"),r=i.getContext("2d"),s="'Sarabun', sans-serif",c=t+12,f=e.split(`
+`),u=f.length*c+20;i.width=this.printerWidth,i.height=u,r.fillStyle="white",r.fillRect(0,0,i.width,i.height),r.fillStyle="black",r.font=`${t}px ${s}`,r.textBaseline="top";let o=10;for(let p of f)r.fillText(p,10,o),o+=c;const l=r.getImageData(0,0,this.printerWidth,u);return this.image(l)}clear(){return this.buffer=[],this}getBuffer(){return new Uint8Array(this.buffer)}async print(e){if(!e){const t=await a.getPrinters(this.driverApi);if(t.length>0)e=t[0];else throw new Error("No printer found.")}try{const t=this.getBuffer(),i=encodeURIComponent(e);if(!(await fetch(`${this.driverApi}/print?printer=${i}`,{method:"POST",headers:{"Content-Type":"application/octet-stream"},body:t})).ok)throw new Error("Driver Error");return this.clear(),{success:!0}}catch(t){throw console.error("Print Failed:",t),t}}static async getPrinters(e="http://localhost:9123"){try{return await(await fetch(`${e}/printers`)).json()}catch(t){return console.error("Connection Error:",t),[]}}}h.ThermalPrinter=a,Object.defineProperty(h,Symbol.toStringTag,{value:"Module"})}));

package/package.json

@@ -0,0 +1,34 @@
+{
+    "name": "@naphatjm/cdh-thermal-printer",
+    "version": "1.0.0",
+    "description": "Thai Thermal Printer Library via Local Driver",
+    "type": "module",
+    "files": [
+        "dist"
+    ],
+    "main": "./dist/thermal-printer.umd.js",
+    "module": "./dist/thermal-printer.es.js",
+    "exports": {
+        ".": {
+            "import": "./dist/thermal-printer.es.js",
+            "require": "./dist/thermal-printer.umd.js"
+        }
+    },
+    "scripts": {
+        "dev": "vite",
+        "build": "vite build",
+        "preview": "vite preview"
+    },
+    "keywords": [
+        "thermal",
+        "printer",
+        "escpos",
+        "thai",
+        "driver"
+    ],
+    "author": "CDH",
+    "license": "ISC",
+    "devDependencies": {
+        "vite": "^7.3.1"
+    }
+}