@angadie/chittie-text 0.1.0 → 0.2.0

package/dist/index.d.mts

@@ -10,6 +10,8 @@ type Codepage = Parameters<typeof CodepageEncoder.encode>[1];
  * must be printed as a raster image (see VENDOR research: non-latin-printing).
  */
 declare function needsRaster(text: string, codepage?: Codepage): boolean;
+/** Fold common typographic punctuation to ASCII so receipts don't choke on a code page (× → x, … → ...). */
+declare function foldTypographic(text: string): string;
 /** Options handed to the injected rasterizer. */
 interface RasterOptions {
   fontSize?: number;
@@ -48,7 +50,7 @@ interface SmartTextOptions {
  * rasterized image when it isn't (Sinhala/Tamil/…). If a raster is needed but no
  * rasterizer was supplied, it throws a clear error instead of silently printing "?".
  */
-declare function smartText(encoder: EncoderLike, text: string, options?: SmartTextOptions): void;
+declare function smartText(encoder: EncoderLike, raw: string, options?: SmartTextOptions): void;
 /**
  * Render a two-column row (left flush-left, right flush-right) to one
  * printer-width image — the correct way to print non-Latin text inside a
@@ -59,4 +61,4 @@ declare function rasterizeRow(rasterizer: TextRasterizer, left: string, right: s
   dotWidth: number;
 } & RasterOptions): ImageData;
 //#endregion
-export { Codepage, RasterOptions, SmartTextOptions, TextRasterizer, needsRaster, padTo8, rasterizeRow, smartText };
+export { Codepage, RasterOptions, SmartTextOptions, TextRasterizer, foldTypographic, needsRaster, padTo8, rasterizeRow, smartText };

package/dist/index.mjs

@@ -14,6 +14,28 @@ function needsRaster(text, codepage = "cp437") {
 	}
 	return false;
 }
+const TYPOGRAPHIC = {
+	"×": "x",
+	"–": "-",
+	"—": "-",
+	"−": "-",
+	"‘": "'",
+	"’": "'",
+	"′": "'",
+	"“": "\"",
+	"”": "\"",
+	"″": "\"",
+	"…": "...",
+	"•": "*",
+	"→": "->",
+	"\xA0": " "
+};
+/** Fold common typographic punctuation to ASCII so receipts don't choke on a code page (× → x, … → ...). */
+function foldTypographic(text) {
+	let out = "";
+	for (const ch of text) out += TYPOGRAPHIC[ch] ?? ch;
+	return out;
+}
 /**
 * ESC/POS raster requires dimensions that are multiples of 8. Pad right/bottom
 * with white so any image "just works". Platform-neutral: reuses the input's own
@@ -35,8 +57,10 @@ function padTo8(img) {
 * rasterized image when it isn't (Sinhala/Tamil/…). If a raster is needed but no
 * rasterizer was supplied, it throws a clear error instead of silently printing "?".
 */
-function smartText(encoder, text, options = {}) {
-	if (!needsRaster(text, options.codepage ?? "cp437")) {
+function smartText(encoder, raw, options = {}) {
+	const codepage = options.codepage ?? "cp437";
+	const text = foldTypographic(raw);
+	if (!needsRaster(text, codepage)) {
 		encoder.text(text);
 		return;
 	}
@@ -79,4 +103,4 @@ function blankImage(w, h) {
 	return new Ctor(new Uint8ClampedArray(w * h * 4).fill(255), w, h);
 }
 //#endregion
-export { needsRaster, padTo8, rasterizeRow, smartText };
+export { foldTypographic, needsRaster, padTo8, rasterizeRow, smartText };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@angadie/chittie-text",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Smart text for chittie: print code-page text when representable, auto-rasterize complex scripts (Sinhala/Tamil/…) via an injected rasterizer, never silently print '?'. Platform-neutral.",
   "license": "MIT",
   "type": "module",
@@ -15,11 +15,11 @@
     "dist"
   ],
   "dependencies": {
-    "@angadie/chittie-codepage": "0.1.0"
+    "@angadie/chittie-codepage": "0.2.0"
   },
   "devDependencies": {
     "@canvas/image-data": "^1.1.0",
-    "@angadie/chittie-core": "0.1.0"
+    "@angadie/chittie-core": "0.2.0"
   },
   "publishConfig": {
     "access": "public"