@delicity/capacitor-thermal-printer 7.0.0

package/dist/esm/core/imaging.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Stratégie de largeur d'impression et utilitaires raster ESC/POS.
+ *
+ * Ce module est une référence TypeScript PURE (sans dépendance native) :
+ *   - documente le mapping largeur papier (mm) -> points imprimables,
+ *   - fournit un encodeur raster GS v 0 testable,
+ *   - sert de spécification que les implémentations Android/iOS doivent suivre.
+ *
+ * Le rendu réel (decode PNG, resize, dithering) est fait en natif pour la perf,
+ * mais l'algorithme de tramage et le format raster sont identiques.
+ */
+/**
+ * Mapping largeur papier -> points imprimables @203 dpi (8 dots/mm).
+ *
+ * Valeurs DE RÉFÉRENCE (les plus courantes), à confirmer via le SDK/profil :
+ *   - 58 mm  : 384 dots  (zone imprimable ~48mm)
+ *   - 80 mm  : 576 dots  (zone imprimable ~72mm)
+ *   - 80 mm  : 640 dots  sur certains modèles (zone imprimable ~80mm) -> override profil
+ *   - 112 mm : 832 dots
+ *
+ * Recommandation : TOUJOURS préférer la valeur `printableDots` du profil/SDK
+ * quand elle est connue. Ce mapping n'est qu'un défaut sûr.
+ */
+export declare const PAPER_WIDTH_PRESETS: Record<number, number>;
+/** Déduit la largeur en points à partir de la largeur papier (fallback 80mm). */
+export declare function dotsForPaperWidth(paperWidthMm: number): number;
+/**
+ * Représentation 1-bit d'une image : un tableau de pixels noir/blanc.
+ * `data[i] = 1` => point ENCRE (noir). width et height en pixels.
+ */
+export interface MonoBitmap {
+    width: number;
+    height: number;
+    /** 1 octet par pixel pour la lisibilité (0 = blanc, 1 = noir). */
+    data: Uint8Array;
+}
+/**
+ * Binarisation par seuil simple. À partir d'une image en niveaux de gris (0-255,
+ * 0 = noir), produit un MonoBitmap. `threshold` par défaut 128.
+ */
+export declare function thresholdToMono(gray: Uint8Array, width: number, height: number, threshold?: number): MonoBitmap;
+/**
+ * Tramage Floyd–Steinberg (diffusion d'erreur). Recommandé pour logos/photos.
+ * Mute une copie du buffer gris. Retourne un MonoBitmap.
+ */
+export declare function floydSteinbergToMono(grayInput: Uint8Array, width: number, height: number): MonoBitmap;
+/**
+ * Tramage Atkinson (diffuse 6/8 de l'erreur). Rendu plus contrasté, agréable
+ * sur tickets de caisse.
+ */
+export declare function atkinsonToMono(grayInput: Uint8Array, width: number, height: number): MonoBitmap;
+/**
+ * Encode un MonoBitmap au format raster ESC/POS `GS v 0`.
+ *
+ * Format de la commande (mode normal m=0) :
+ *   GS 'v' '0' m xL xH yL yH d1...dk
+ *   - GS = 0x1D, 'v' = 0x76, '0' = 0x30
+ *   - m  = 0 (normal) | 1 (double largeur) | 2 (double hauteur) | 3 (quad)
+ *   - xL,xH = nombre d'OCTETS par ligne (width/8) en little-endian
+ *   - yL,yH = nombre de LIGNES (height) en little-endian
+ *   - data  = octets bitmap, bit de poids fort = pixel le plus à gauche
+ *
+ * IMPORTANT : la largeur DOIT être paddée à un multiple de 8 pixels.
+ */
+export declare function encodeEscPosRaster(mono: MonoBitmap, mode?: 0 | 1 | 2 | 3): Uint8Array;
+/** Commandes ESC/POS de base (init, feed, cut, drawer). */
+export declare const EscPos: {
+    INIT: Uint8Array;
+    feed(lines: number): Uint8Array;
+    alignLeft: Uint8Array;
+    alignCenter: Uint8Array;
+    alignRight: Uint8Array;
+    cutFull: Uint8Array;
+    cutPartial: Uint8Array;
+    cutFeed(n?: number): Uint8Array;
+    openDrawerPin2: Uint8Array;
+    openDrawerPin5: Uint8Array;
+    /** Statut temps réel : DLE EOT n (1=printer,2=offline,3=error,4=paper). */
+    realtimeStatus(n: 1 | 2 | 3 | 4): Uint8Array;
+};
+/**
+ * Assemble un job ESC/POS complet (init + align + raster + feed + cut + drawer).
+ * `chunkRowsForLargeImage` : sur de très grandes images, certaines imprimantes
+ * BT/série préfèrent recevoir le raster en bandes pour éviter les overflows de buffer.
+ */
+export declare function buildEscPosImageJob(mono: MonoBitmap, opts?: {
+    align?: 'left' | 'center' | 'right';
+    cut?: boolean;
+    feedLines?: number;
+    openCashDrawer?: boolean;
+}): Uint8Array;

package/dist/esm/core/imaging.js

@@ -0,0 +1,184 @@
+/**
+ * Stratégie de largeur d'impression et utilitaires raster ESC/POS.
+ *
+ * Ce module est une référence TypeScript PURE (sans dépendance native) :
+ *   - documente le mapping largeur papier (mm) -> points imprimables,
+ *   - fournit un encodeur raster GS v 0 testable,
+ *   - sert de spécification que les implémentations Android/iOS doivent suivre.
+ *
+ * Le rendu réel (decode PNG, resize, dithering) est fait en natif pour la perf,
+ * mais l'algorithme de tramage et le format raster sont identiques.
+ */
+/**
+ * Mapping largeur papier -> points imprimables @203 dpi (8 dots/mm).
+ *
+ * Valeurs DE RÉFÉRENCE (les plus courantes), à confirmer via le SDK/profil :
+ *   - 58 mm  : 384 dots  (zone imprimable ~48mm)
+ *   - 80 mm  : 576 dots  (zone imprimable ~72mm)
+ *   - 80 mm  : 640 dots  sur certains modèles (zone imprimable ~80mm) -> override profil
+ *   - 112 mm : 832 dots
+ *
+ * Recommandation : TOUJOURS préférer la valeur `printableDots` du profil/SDK
+ * quand elle est connue. Ce mapping n'est qu'un défaut sûr.
+ */
+export const PAPER_WIDTH_PRESETS = {
+    58: 384,
+    80: 576,
+    112: 832,
+};
+/** Déduit la largeur en points à partir de la largeur papier (fallback 80mm). */
+export function dotsForPaperWidth(paperWidthMm) {
+    var _a;
+    return (_a = PAPER_WIDTH_PRESETS[paperWidthMm]) !== null && _a !== void 0 ? _a : PAPER_WIDTH_PRESETS[80];
+}
+/**
+ * Binarisation par seuil simple. À partir d'une image en niveaux de gris (0-255,
+ * 0 = noir), produit un MonoBitmap. `threshold` par défaut 128.
+ */
+export function thresholdToMono(gray, width, height, threshold = 128) {
+    const out = new Uint8Array(width * height);
+    for (let i = 0; i < out.length; i++) {
+        out[i] = gray[i] < threshold ? 1 : 0;
+    }
+    return { width, height, data: out };
+}
+/**
+ * Tramage Floyd–Steinberg (diffusion d'erreur). Recommandé pour logos/photos.
+ * Mute une copie du buffer gris. Retourne un MonoBitmap.
+ */
+export function floydSteinbergToMono(grayInput, width, height) {
+    const gray = Float32Array.from(grayInput);
+    const out = new Uint8Array(width * height);
+    const at = (x, y) => y * width + x;
+    for (let y = 0; y < height; y++) {
+        for (let x = 0; x < width; x++) {
+            const idx = at(x, y);
+            const oldPixel = gray[idx];
+            const newPixel = oldPixel < 128 ? 0 : 255;
+            out[idx] = newPixel === 0 ? 1 : 0;
+            const err = oldPixel - newPixel;
+            if (x + 1 < width)
+                gray[at(x + 1, y)] += (err * 7) / 16;
+            if (x - 1 >= 0 && y + 1 < height)
+                gray[at(x - 1, y + 1)] += (err * 3) / 16;
+            if (y + 1 < height)
+                gray[at(x, y + 1)] += (err * 5) / 16;
+            if (x + 1 < width && y + 1 < height)
+                gray[at(x + 1, y + 1)] += (err * 1) / 16;
+        }
+    }
+    return { width, height, data: out };
+}
+/**
+ * Tramage Atkinson (diffuse 6/8 de l'erreur). Rendu plus contrasté, agréable
+ * sur tickets de caisse.
+ */
+export function atkinsonToMono(grayInput, width, height) {
+    const gray = Float32Array.from(grayInput);
+    const out = new Uint8Array(width * height);
+    const at = (x, y) => y * width + x;
+    const spread = (x, y, e) => {
+        if (x >= 0 && x < width && y >= 0 && y < height)
+            gray[at(x, y)] += e;
+    };
+    for (let y = 0; y < height; y++) {
+        for (let x = 0; x < width; x++) {
+            const idx = at(x, y);
+            const oldPixel = gray[idx];
+            const newPixel = oldPixel < 128 ? 0 : 255;
+            out[idx] = newPixel === 0 ? 1 : 0;
+            const err = (oldPixel - newPixel) / 8;
+            spread(x + 1, y, err);
+            spread(x + 2, y, err);
+            spread(x - 1, y + 1, err);
+            spread(x, y + 1, err);
+            spread(x + 1, y + 1, err);
+            spread(x, y + 2, err);
+        }
+    }
+    return { width, height, data: out };
+}
+/**
+ * Encode un MonoBitmap au format raster ESC/POS `GS v 0`.
+ *
+ * Format de la commande (mode normal m=0) :
+ *   GS 'v' '0' m xL xH yL yH d1...dk
+ *   - GS = 0x1D, 'v' = 0x76, '0' = 0x30
+ *   - m  = 0 (normal) | 1 (double largeur) | 2 (double hauteur) | 3 (quad)
+ *   - xL,xH = nombre d'OCTETS par ligne (width/8) en little-endian
+ *   - yL,yH = nombre de LIGNES (height) en little-endian
+ *   - data  = octets bitmap, bit de poids fort = pixel le plus à gauche
+ *
+ * IMPORTANT : la largeur DOIT être paddée à un multiple de 8 pixels.
+ */
+export function encodeEscPosRaster(mono, mode = 0) {
+    const { width, height, data } = mono;
+    const bytesPerRow = Math.ceil(width / 8);
+    const xL = bytesPerRow & 0xff;
+    const xH = (bytesPerRow >> 8) & 0xff;
+    const yL = height & 0xff;
+    const yH = (height >> 8) & 0xff;
+    const header = new Uint8Array([0x1d, 0x76, 0x30, mode, xL, xH, yL, yH]);
+    const body = new Uint8Array(bytesPerRow * height);
+    for (let y = 0; y < height; y++) {
+        for (let x = 0; x < width; x++) {
+            if (data[y * width + x] === 1) {
+                const byteIndex = y * bytesPerRow + (x >> 3);
+                const bit = 7 - (x & 7);
+                body[byteIndex] |= 1 << bit;
+            }
+        }
+    }
+    const out = new Uint8Array(header.length + body.length);
+    out.set(header, 0);
+    out.set(body, header.length);
+    return out;
+}
+/** Commandes ESC/POS de base (init, feed, cut, drawer). */
+export const EscPos = {
+    INIT: new Uint8Array([0x1b, 0x40]), // ESC @
+    feed(lines) {
+        // ESC d n
+        return new Uint8Array([0x1b, 0x64, Math.max(0, Math.min(255, lines))]);
+    },
+    alignLeft: new Uint8Array([0x1b, 0x61, 0x00]),
+    alignCenter: new Uint8Array([0x1b, 0x61, 0x01]),
+    alignRight: new Uint8Array([0x1b, 0x61, 0x02]),
+    cutFull: new Uint8Array([0x1d, 0x56, 0x00]), // GS V 0
+    cutPartial: new Uint8Array([0x1d, 0x56, 0x01]), // GS V 1
+    // GS V 66 n : feed + partial cut
+    cutFeed(n = 3) {
+        return new Uint8Array([0x1d, 0x56, 0x42, n]);
+    },
+    openDrawerPin2: new Uint8Array([0x1b, 0x70, 0x00, 0x19, 0xfa]), // ESC p 0
+    openDrawerPin5: new Uint8Array([0x1b, 0x70, 0x01, 0x19, 0xfa]), // ESC p 1
+    /** Statut temps réel : DLE EOT n (1=printer,2=offline,3=error,4=paper). */
+    realtimeStatus(n) {
+        return new Uint8Array([0x10, 0x04, n]);
+    },
+};
+/**
+ * Assemble un job ESC/POS complet (init + align + raster + feed + cut + drawer).
+ * `chunkRowsForLargeImage` : sur de très grandes images, certaines imprimantes
+ * BT/série préfèrent recevoir le raster en bandes pour éviter les overflows de buffer.
+ */
+export function buildEscPosImageJob(mono, opts = {}) {
+    const { align = 'center', cut = true, feedLines = 3, openCashDrawer = false } = opts;
+    const parts = [EscPos.INIT];
+    parts.push(align === 'center' ? EscPos.alignCenter : align === 'right' ? EscPos.alignRight : EscPos.alignLeft);
+    parts.push(encodeEscPosRaster(mono));
+    parts.push(EscPos.feed(feedLines));
+    if (cut)
+        parts.push(EscPos.cutPartial);
+    if (openCashDrawer)
+        parts.push(EscPos.openDrawerPin2);
+    const total = parts.reduce((n, p) => n + p.length, 0);
+    const out = new Uint8Array(total);
+    let off = 0;
+    for (const p of parts) {
+        out.set(p, off);
+        off += p.length;
+    }
+    return out;
+}
+//# sourceMappingURL=imaging.js.map

package/dist/esm/core/imaging.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"imaging.js","sourceRoot":"","sources":["../../../src/core/imaging.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Stratégie de largeur d'impression et utilitaires raster ESC/POS.\n *\n * Ce module est une référence TypeScript PURE (sans dépendance native) :\n *   - documente le mapping largeur papier (mm) -> points imprimables,\n *   - fournit un encodeur raster GS v 0 testable,\n *   - sert de spécification que les implémentations Android/iOS doivent suivre.\n *\n * Le rendu réel (decode PNG, resize, dithering) est fait en natif pour la perf,\n * mais l'algorithme de tramage et le format raster sont identiques.\n */\n\n/**\n * Mapping largeur papier -> points imprimables @203 dpi (8 dots/mm).\n *\n * Valeurs DE RÉFÉRENCE (les plus courantes), à confirmer via le SDK/profil :\n *   - 58 mm  : 384 dots  (zone imprimable ~48mm)\n *   - 80 mm  : 576 dots  (zone imprimable ~72mm)\n *   - 80 mm  : 640 dots  sur certains modèles (zone imprimable ~80mm) -> override profil\n *   - 112 mm : 832 dots\n *\n * Recommandation : TOUJOURS préférer la valeur `printableDots` du profil/SDK\n * quand elle est connue. Ce mapping n'est qu'un défaut sûr.\n */\nexport const PAPER_WIDTH_PRESETS: Record<number, number> = {\n  58: 384,\n  80: 576,\n  112: 832,\n};\n\n/** Déduit la largeur en points à partir de la largeur papier (fallback 80mm). */\nexport function dotsForPaperWidth(paperWidthMm: number): number {\n  return PAPER_WIDTH_PRESETS[paperWidthMm] ?? PAPER_WIDTH_PRESETS[80];\n}\n\n/**\n * Représentation 1-bit d'une image : un tableau de pixels noir/blanc.\n * `data[i] = 1` => point ENCRE (noir). width et height en pixels.\n */\nexport interface MonoBitmap {\n  width: number;\n  height: number;\n  /** 1 octet par pixel pour la lisibilité (0 = blanc, 1 = noir). */\n  data: Uint8Array;\n}\n\n/**\n * Binarisation par seuil simple. À partir d'une image en niveaux de gris (0-255,\n * 0 = noir), produit un MonoBitmap. `threshold` par défaut 128.\n */\nexport function thresholdToMono(gray: Uint8Array, width: number, height: number, threshold = 128): MonoBitmap {\n  const out = new Uint8Array(width * height);\n  for (let i = 0; i < out.length; i++) {\n    out[i] = gray[i] < threshold ? 1 : 0;\n  }\n  return { width, height, data: out };\n}\n\n/**\n * Tramage Floyd–Steinberg (diffusion d'erreur). Recommandé pour logos/photos.\n * Mute une copie du buffer gris. Retourne un MonoBitmap.\n */\nexport function floydSteinbergToMono(grayInput: Uint8Array, width: number, height: number): MonoBitmap {\n  const gray = Float32Array.from(grayInput);\n  const out = new Uint8Array(width * height);\n  const at = (x: number, y: number) => y * width + x;\n\n  for (let y = 0; y < height; y++) {\n    for (let x = 0; x < width; x++) {\n      const idx = at(x, y);\n      const oldPixel = gray[idx];\n      const newPixel = oldPixel < 128 ? 0 : 255;\n      out[idx] = newPixel === 0 ? 1 : 0;\n      const err = oldPixel - newPixel;\n\n      if (x + 1 < width) gray[at(x + 1, y)] += (err * 7) / 16;\n      if (x - 1 >= 0 && y + 1 < height) gray[at(x - 1, y + 1)] += (err * 3) / 16;\n      if (y + 1 < height) gray[at(x, y + 1)] += (err * 5) / 16;\n      if (x + 1 < width && y + 1 < height) gray[at(x + 1, y + 1)] += (err * 1) / 16;\n    }\n  }\n  return { width, height, data: out };\n}\n\n/**\n * Tramage Atkinson (diffuse 6/8 de l'erreur). Rendu plus contrasté, agréable\n * sur tickets de caisse.\n */\nexport function atkinsonToMono(grayInput: Uint8Array, width: number, height: number): MonoBitmap {\n  const gray = Float32Array.from(grayInput);\n  const out = new Uint8Array(width * height);\n  const at = (x: number, y: number) => y * width + x;\n  const spread = (x: number, y: number, e: number) => {\n    if (x >= 0 && x < width && y >= 0 && y < height) gray[at(x, y)] += e;\n  };\n\n  for (let y = 0; y < height; y++) {\n    for (let x = 0; x < width; x++) {\n      const idx = at(x, y);\n      const oldPixel = gray[idx];\n      const newPixel = oldPixel < 128 ? 0 : 255;\n      out[idx] = newPixel === 0 ? 1 : 0;\n      const err = (oldPixel - newPixel) / 8;\n      spread(x + 1, y, err);\n      spread(x + 2, y, err);\n      spread(x - 1, y + 1, err);\n      spread(x, y + 1, err);\n      spread(x + 1, y + 1, err);\n      spread(x, y + 2, err);\n    }\n  }\n  return { width, height, data: out };\n}\n\n/**\n * Encode un MonoBitmap au format raster ESC/POS `GS v 0`.\n *\n * Format de la commande (mode normal m=0) :\n *   GS 'v' '0' m xL xH yL yH d1...dk\n *   - GS = 0x1D, 'v' = 0x76, '0' = 0x30\n *   - m  = 0 (normal) | 1 (double largeur) | 2 (double hauteur) | 3 (quad)\n *   - xL,xH = nombre d'OCTETS par ligne (width/8) en little-endian\n *   - yL,yH = nombre de LIGNES (height) en little-endian\n *   - data  = octets bitmap, bit de poids fort = pixel le plus à gauche\n *\n * IMPORTANT : la largeur DOIT être paddée à un multiple de 8 pixels.\n */\nexport function encodeEscPosRaster(mono: MonoBitmap, mode: 0 | 1 | 2 | 3 = 0): Uint8Array {\n  const { width, height, data } = mono;\n  const bytesPerRow = Math.ceil(width / 8);\n  const xL = bytesPerRow & 0xff;\n  const xH = (bytesPerRow >> 8) & 0xff;\n  const yL = height & 0xff;\n  const yH = (height >> 8) & 0xff;\n\n  const header = new Uint8Array([0x1d, 0x76, 0x30, mode, xL, xH, yL, yH]);\n  const body = new Uint8Array(bytesPerRow * height);\n\n  for (let y = 0; y < height; y++) {\n    for (let x = 0; x < width; x++) {\n      if (data[y * width + x] === 1) {\n        const byteIndex = y * bytesPerRow + (x >> 3);\n        const bit = 7 - (x & 7);\n        body[byteIndex] |= 1 << bit;\n      }\n    }\n  }\n\n  const out = new Uint8Array(header.length + body.length);\n  out.set(header, 0);\n  out.set(body, header.length);\n  return out;\n}\n\n/** Commandes ESC/POS de base (init, feed, cut, drawer). */\nexport const EscPos = {\n  INIT: new Uint8Array([0x1b, 0x40]), // ESC @\n  feed(lines: number): Uint8Array {\n    // ESC d n\n    return new Uint8Array([0x1b, 0x64, Math.max(0, Math.min(255, lines))]);\n  },\n  alignLeft: new Uint8Array([0x1b, 0x61, 0x00]),\n  alignCenter: new Uint8Array([0x1b, 0x61, 0x01]),\n  alignRight: new Uint8Array([0x1b, 0x61, 0x02]),\n  cutFull: new Uint8Array([0x1d, 0x56, 0x00]), // GS V 0\n  cutPartial: new Uint8Array([0x1d, 0x56, 0x01]), // GS V 1\n  // GS V 66 n : feed + partial cut\n  cutFeed(n = 3): Uint8Array {\n    return new Uint8Array([0x1d, 0x56, 0x42, n]);\n  },\n  openDrawerPin2: new Uint8Array([0x1b, 0x70, 0x00, 0x19, 0xfa]), // ESC p 0\n  openDrawerPin5: new Uint8Array([0x1b, 0x70, 0x01, 0x19, 0xfa]), // ESC p 1\n  /** Statut temps réel : DLE EOT n (1=printer,2=offline,3=error,4=paper). */\n  realtimeStatus(n: 1 | 2 | 3 | 4): Uint8Array {\n    return new Uint8Array([0x10, 0x04, n]);\n  },\n};\n\n/**\n * Assemble un job ESC/POS complet (init + align + raster + feed + cut + drawer).\n * `chunkRowsForLargeImage` : sur de très grandes images, certaines imprimantes\n * BT/série préfèrent recevoir le raster en bandes pour éviter les overflows de buffer.\n */\nexport function buildEscPosImageJob(\n  mono: MonoBitmap,\n  opts: {\n    align?: 'left' | 'center' | 'right';\n    cut?: boolean;\n    feedLines?: number;\n    openCashDrawer?: boolean;\n  } = {},\n): Uint8Array {\n  const { align = 'center', cut = true, feedLines = 3, openCashDrawer = false } = opts;\n  const parts: Uint8Array[] = [EscPos.INIT];\n\n  parts.push(align === 'center' ? EscPos.alignCenter : align === 'right' ? EscPos.alignRight : EscPos.alignLeft);\n  parts.push(encodeEscPosRaster(mono));\n  parts.push(EscPos.feed(feedLines));\n  if (cut) parts.push(EscPos.cutPartial);\n  if (openCashDrawer) parts.push(EscPos.openDrawerPin2);\n\n  const total = parts.reduce((n, p) => n + p.length, 0);\n  const out = new Uint8Array(total);\n  let off = 0;\n  for (const p of parts) {\n    out.set(p, off);\n    off += p.length;\n  }\n  return out;\n}\n"]}

package/dist/esm/core/models.d.ts

@@ -0,0 +1,131 @@
+import type { ConnectionState, HoldReason, JobState, PaperStatus, PrinterAdapterId, PrinterTransport, PrintErrorCode } from './enums';
+import type { PrintRenderOptions } from './options';
+/**
+ * Capacités matérielles/logicielles d'une imprimante.
+ * Renseignées au mieux à la découverte, complétées après un premier print réussi.
+ */
+export interface PrinterCapabilities {
+    /** Largeur papier physique en millimètres (58, 80, 112...). */
+    paperWidthMm: number;
+    /** Nombre de points imprimables sur la largeur (ex: 384 pour 58mm, 576 pour 80mm @203dpi). */
+    printableDots: number;
+    /** Résolution en points par pouce (généralement 203). */
+    dpi: number;
+    /** L'imprimante possède un massicot. */
+    supportsCut: boolean;
+    /** L'imprimante peut piloter un tiroir-caisse. */
+    supportsCashDrawer: boolean;
+    /** L'imprimante remonte un statut temps réel (papier, capot, erreurs). */
+    supportsStatus: boolean;
+    /** L'imprimante accepte l'impression d'images raster. */
+    supportsRasterImage: boolean;
+    /** L'imprimante peut générer des QR codes nativement (sinon: imprimés via image). */
+    supportsQrCode?: boolean;
+    /** L'imprimante peut générer des codes-barres nativement. */
+    supportsBarcode?: boolean;
+}
+/**
+ * Imprimante telle que remontée par la découverte agrégée, après dédoublonnage.
+ */
+export interface DiscoveredPrinter {
+    /** Identifiant interne stable construit par le plugin (voir buildStableId). */
+    id: string;
+    /** Nom lisible (nom Bluetooth, hostname, ou modèle SDK). */
+    name: string;
+    /** Marque détectée si connue ("Epson", "Star", "Generic", ...). */
+    brand?: string;
+    /** Modèle détecté si connu ("TM-m30", "mC-Print3", ...). */
+    model?: string;
+    /** Transport physique utilisé pour joindre l'imprimante. */
+    transport: PrinterTransport;
+    /** Adapter retenu par le moteur de priorité. */
+    adapter: PrinterAdapterId;
+    /**
+     * Adresse de joignabilité, dépendante du transport :
+     * - wifi/ethernet : "192.168.1.50:9100"
+     * - bluetooth     : "AA:BB:CC:DD:EE:FF" (MAC)
+     * - ble           : UUID périphérique (iOS) ou MAC (Android)
+     * - usb           : "vendorId:productId" ou device name
+     */
+    address: string;
+    /** Capacités connues (best effort à la découverte). */
+    capabilities?: Partial<PrinterCapabilities>;
+    /** Source(s) de découverte ayant remonté cette imprimante (pour debug / fusion). */
+    discoveredBy?: PrinterAdapterId[];
+    /** Timestamp (ms epoch) de dernière détection. */
+    lastSeenAt: number;
+    /** Vrai si c'est l'imprimante par défaut enregistrée. */
+    isDefault: boolean;
+    /** Vrai si le plugin a une connexion active ouverte. */
+    isConnected: boolean;
+}
+/**
+ * Profil persistant d'une imprimante enregistrée (sauvegardé après test réussi).
+ * Contient tout le nécessaire pour la reconnexion automatique sans re-découverte.
+ */
+export interface PrinterProfile {
+    id: string;
+    adapter: PrinterAdapterId;
+    transport: PrinterTransport;
+    address: string;
+    brand?: string;
+    model?: string;
+    name: string;
+    capabilities: PrinterCapabilities;
+    /** Options par défaut d'impression mémorisées pour cette imprimante. */
+    defaultPrintOptions?: PrintRenderOptions;
+    /** Données opaques propres à l'adapter pour reconnexion (ex: identifiant SDK). */
+    adapterMeta?: Record<string, string | number | boolean>;
+    isDefault: boolean;
+    createdAt: number;
+    updatedAt: number;
+}
+/**
+ * Statut temps réel d'une imprimante.
+ */
+export interface PrinterStatus {
+    id: string;
+    connection: ConnectionState;
+    online: boolean;
+    paper: PaperStatus;
+    coverOpen?: boolean;
+    /** Erreur courante si l'imprimante est en faute. */
+    errorCode?: PrintErrorCode;
+    /** Message brut du SDK/transport (debug). */
+    rawStatus?: string;
+    checkedAt: number;
+}
+/**
+ * Statut temps réel d'un job d'impression, émis via l'event `printJobStatus`.
+ */
+export interface PrintJobStatus {
+    /** Identifiant unique du job (retourné aussi dans PrintResult). */
+    jobId: string;
+    printerId: string;
+    state: JobState;
+    /** Raison si l'état est `hold`. */
+    holdReason?: HoldReason;
+    /** Progression 0..1 (best-effort : avancement de l'envoi des octets). */
+    progress?: number;
+    errorCode?: PrintErrorCode;
+    message?: string;
+    updatedAt: number;
+}
+/**
+ * Résultat normalisé d'une impression (image ou texte).
+ */
+export interface PrintResult {
+    success: boolean;
+    printerId: string;
+    adapter: PrinterAdapterId;
+    /** Identifiant du job (corrélé aux events printJobStatus). */
+    jobId: string;
+    /** État final du job (`completed` si succès). */
+    state: JobState;
+    /** Nombre d'octets effectivement envoyés au transport. */
+    bytesSent?: number;
+    /** Durée totale (ms) de l'opération print (reconnexion incluse). */
+    durationMs?: number;
+    /** Statut imprimante lu après impression, si disponible. */
+    status?: PrinterStatus;
+}

package/dist/esm/core/models.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=models.js.map

package/dist/esm/core/models.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.js","sourceRoot":"","sources":["../../../src/core/models.ts"],"names":[],"mappings":"","sourcesContent":["import type {\n  ConnectionState,\n  HoldReason,\n  JobState,\n  PaperStatus,\n  PrinterAdapterId,\n  PrinterTransport,\n  PrintErrorCode,\n} from './enums';\nimport type { PrintRenderOptions } from './options';\n\n/**\n * Capacités matérielles/logicielles d'une imprimante.\n * Renseignées au mieux à la découverte, complétées après un premier print réussi.\n */\nexport interface PrinterCapabilities {\n  /** Largeur papier physique en millimètres (58, 80, 112...). */\n  paperWidthMm: number;\n  /** Nombre de points imprimables sur la largeur (ex: 384 pour 58mm, 576 pour 80mm @203dpi). */\n  printableDots: number;\n  /** Résolution en points par pouce (généralement 203). */\n  dpi: number;\n  /** L'imprimante possède un massicot. */\n  supportsCut: boolean;\n  /** L'imprimante peut piloter un tiroir-caisse. */\n  supportsCashDrawer: boolean;\n  /** L'imprimante remonte un statut temps réel (papier, capot, erreurs). */\n  supportsStatus: boolean;\n  /** L'imprimante accepte l'impression d'images raster. */\n  supportsRasterImage: boolean;\n  /** L'imprimante peut générer des QR codes nativement (sinon: imprimés via image). */\n  supportsQrCode?: boolean;\n  /** L'imprimante peut générer des codes-barres nativement. */\n  supportsBarcode?: boolean;\n}\n\n/**\n * Imprimante telle que remontée par la découverte agrégée, après dédoublonnage.\n */\nexport interface DiscoveredPrinter {\n  /** Identifiant interne stable construit par le plugin (voir buildStableId). */\n  id: string;\n  /** Nom lisible (nom Bluetooth, hostname, ou modèle SDK). */\n  name: string;\n  /** Marque détectée si connue (\"Epson\", \"Star\", \"Generic\", ...). */\n  brand?: string;\n  /** Modèle détecté si connu (\"TM-m30\", \"mC-Print3\", ...). */\n  model?: string;\n  /** Transport physique utilisé pour joindre l'imprimante. */\n  transport: PrinterTransport;\n  /** Adapter retenu par le moteur de priorité. */\n  adapter: PrinterAdapterId;\n  /**\n   * Adresse de joignabilité, dépendante du transport :\n   * - wifi/ethernet : \"192.168.1.50:9100\"\n   * - bluetooth     : \"AA:BB:CC:DD:EE:FF\" (MAC)\n   * - ble           : UUID périphérique (iOS) ou MAC (Android)\n   * - usb           : \"vendorId:productId\" ou device name\n   */\n  address: string;\n  /** Capacités connues (best effort à la découverte). */\n  capabilities?: Partial<PrinterCapabilities>;\n  /** Source(s) de découverte ayant remonté cette imprimante (pour debug / fusion). */\n  discoveredBy?: PrinterAdapterId[];\n  /** Timestamp (ms epoch) de dernière détection. */\n  lastSeenAt: number;\n  /** Vrai si c'est l'imprimante par défaut enregistrée. */\n  isDefault: boolean;\n  /** Vrai si le plugin a une connexion active ouverte. */\n  isConnected: boolean;\n}\n\n/**\n * Profil persistant d'une imprimante enregistrée (sauvegardé après test réussi).\n * Contient tout le nécessaire pour la reconnexion automatique sans re-découverte.\n */\nexport interface PrinterProfile {\n  id: string;\n  adapter: PrinterAdapterId;\n  transport: PrinterTransport;\n  address: string;\n  brand?: string;\n  model?: string;\n  name: string;\n  capabilities: PrinterCapabilities;\n  /** Options par défaut d'impression mémorisées pour cette imprimante. */\n  defaultPrintOptions?: PrintRenderOptions;\n  /** Données opaques propres à l'adapter pour reconnexion (ex: identifiant SDK). */\n  adapterMeta?: Record<string, string | number | boolean>;\n  isDefault: boolean;\n  createdAt: number;\n  updatedAt: number;\n}\n\n/**\n * Statut temps réel d'une imprimante.\n */\nexport interface PrinterStatus {\n  id: string;\n  connection: ConnectionState;\n  online: boolean;\n  paper: PaperStatus;\n  coverOpen?: boolean;\n  /** Erreur courante si l'imprimante est en faute. */\n  errorCode?: PrintErrorCode;\n  /** Message brut du SDK/transport (debug). */\n  rawStatus?: string;\n  checkedAt: number;\n}\n\n/**\n * Statut temps réel d'un job d'impression, émis via l'event `printJobStatus`.\n */\nexport interface PrintJobStatus {\n  /** Identifiant unique du job (retourné aussi dans PrintResult). */\n  jobId: string;\n  printerId: string;\n  state: JobState;\n  /** Raison si l'état est `hold`. */\n  holdReason?: HoldReason;\n  /** Progression 0..1 (best-effort : avancement de l'envoi des octets). */\n  progress?: number;\n  errorCode?: PrintErrorCode;\n  message?: string;\n  updatedAt: number;\n}\n\n/**\n * Résultat normalisé d'une impression (image ou texte).\n */\nexport interface PrintResult {\n  success: boolean;\n  printerId: string;\n  adapter: PrinterAdapterId;\n  /** Identifiant du job (corrélé aux events printJobStatus). */\n  jobId: string;\n  /** État final du job (`completed` si succès). */\n  state: JobState;\n  /** Nombre d'octets effectivement envoyés au transport. */\n  bytesSent?: number;\n  /** Durée totale (ms) de l'opération print (reconnexion incluse). */\n  durationMs?: number;\n  /** Statut imprimante lu après impression, si disponible. */\n  status?: PrinterStatus;\n}\n"]}

package/dist/esm/core/options.d.ts

@@ -0,0 +1,154 @@
+import type { PrinterAdapterId, PrinterTransport, PrintErrorCode } from './enums';
+/**
+ * Algorithme de tramage (dithering) appliqué lors de la conversion 1-bit.
+ * - `none`             : seuillage simple (threshold) — idéal pour texte/ligne nettes.
+ * - `floyd_steinberg`  : tramage par diffusion d'erreur — idéal pour logos/photos.
+ * - `atkinson`         : variante plus contrastée, agréable sur tickets.
+ */
+export type DitheringAlgorithm = 'none' | 'floyd_steinberg' | 'atkinson';
+/** Alignement horizontal de l'image si plus étroite que la zone imprimable. */
+export type ImageAlign = 'left' | 'center' | 'right';
+/**
+ * Options de rendu image -> impression. Indépendantes du transport.
+ */
+export interface PrintRenderOptions {
+    /**
+     * Largeur cible en points (dots). Si omise, déduite du profil/capacités
+     * (ex: 384 pour 58mm, 576 pour 80mm).
+     */
+    widthDots?: number;
+    /**
+     * Redimensionner l'image à la largeur cible. Défaut `true`.
+     * Mettre `false` si l'image est DÉJÀ à la bonne largeur (rendu serveur) :
+     * envoi tel quel, pixel-perfect, plus rapide.
+     */
+    resize?: boolean;
+    /**
+     * Conversion niveaux de gris + dithering. Défaut `true`.
+     * Mettre `false` si l'image est DÉJÀ en 1-bit noir/blanc (pré-traitée serveur) :
+     * un simple seuil est appliqué, sans dithering.
+     */
+    grayscale?: boolean;
+    /** Seuil de binarisation 0-255 (défaut 128) quand dithering = 'none'. */
+    threshold?: number;
+    /** Algorithme de tramage. Défaut: 'floyd_steinberg'. */
+    dithering?: DitheringAlgorithm;
+    /** Alignement si l'image est plus étroite que la largeur imprimable. Défaut 'center'. */
+    align?: ImageAlign;
+    /** Inverser le noir et blanc (impression en négatif). */
+    invert?: boolean;
+    /** Couper le papier après impression (si supportsCut). Défaut true. */
+    cut?: boolean;
+    /** Nombre de lignes de feed avant la coupe. Défaut 3. */
+    feedLines?: number;
+    /** Ouvrir le tiroir-caisse après impression (si supportsCashDrawer). Défaut false. */
+    openCashDrawer?: boolean;
+    /** Nombre de copies. Défaut 1. */
+    copies?: number;
+}
+/**
+ * Source de l'image à imprimer. Une seule des trois clés doit être renseignée.
+ * Ordre de préférence en production : `filePath` > `url` > `base64`.
+ */
+export interface ImageSource {
+    /** Chemin local du fichier (file:// ou chemin absolu). MODE RECOMMANDÉ. */
+    filePath?: string;
+    /** URL distante. Le plugin télécharge (avec cache). */
+    url?: string;
+    /** Données base64 (avec ou sans préfixe data:). Pratique en test. */
+    base64?: string;
+}
+/**
+ * Options de l'appel printImage.
+ */
+export interface PrintImageOptions {
+    /** Imprimante cible. Si omis, utilise l'imprimante par défaut. */
+    printerId?: string;
+    /** Source image. */
+    image: ImageSource;
+    /** Options de rendu (fusionnées avec les defaults du profil). */
+    render?: PrintRenderOptions;
+    /** Timeout global de l'opération en ms (reconnexion + envoi). Défaut 15000. */
+    timeoutMs?: number;
+    /**
+     * Si true, tente une reconnexion automatique si l'imprimante n'est pas connectée.
+     * Défaut true.
+     */
+    autoReconnect?: boolean;
+}
+/**
+ * Options de découverte agrégée.
+ */
+export interface DiscoverOptions {
+    /**
+     * Sous-ensemble de sources à activer. Si omis, toutes les sources disponibles
+     * sur la plateforme sont lancées en parallèle.
+     */
+    sources?: DiscoverySource[];
+    /** Durée max de scan en ms (le scan BT/BLE est borné par ce délai). Défaut 8000. */
+    timeoutMs?: number;
+    /** Inclure les appareils Bluetooth déjà appairés (Android). Défaut true. */
+    includePaired?: boolean;
+    /**
+     * Plage/segment réseau à scanner pour TCP 9100 (ex: "192.168.1.0/24").
+     * Si omis, déduit du réseau courant.
+     */
+    networkCidr?: string;
+    /** Ports TCP à sonder en plus de 9100 (ex: [9100, 6101, 515]). */
+    tcpPorts?: number[];
+    /** Émettre des résultats incrémentaux via l'event 'printerFound'. Défaut true. */
+    emitPartialResults?: boolean;
+}
+/** Sources de découverte activables. */
+export type DiscoverySource = 'epson' | 'star' | 'brother' | 'zebra' | 'tcp' | 'bluetooth' | 'ble' | 'usb';
+/**
+ * Options de l'appel printText.
+ */
+export interface PrintTextOptions {
+    /** Imprimante cible. Si omis, utilise l'imprimante par défaut. */
+    printerId?: string;
+    /** Liste ordonnée d'items à imprimer (texte stylé, QR, code-barres, feed, cut...). */
+    items: import('./text').PrintItem[];
+    /** Page de code par défaut pour les accents (français : 'WPC1252'). */
+    defaultCodePage?: import('./text').CodePage;
+    /** Couper le papier en fin de job (si non géré par un item `cut`). Défaut false. */
+    cut?: boolean;
+    /** Lignes d'avance en fin de job avant la coupe. Défaut 3. */
+    feedLines?: number;
+    /** Timeout global de l'opération en ms. Défaut 15000. */
+    timeoutMs?: number;
+    /** Reconnexion automatique si non connecté. Défaut true. */
+    autoReconnect?: boolean;
+}
+/**
+ * Options de connexion explicite.
+ */
+export interface ConnectOptions {
+    printerId: string;
+    /** Timeout de connexion ms. Défaut 10000. */
+    timeoutMs?: number;
+    /** Forcer un adapter (sinon: celui résolu à la découverte / dans le profil). */
+    forceAdapter?: PrinterAdapterId;
+    /**
+     * Si `true`, enregistre cette imprimante comme imprimante par défaut
+     * UNIQUEMENT si la connexion réussit (persistance du profil incluse).
+     * Défaut `false`.
+     */
+    setAsDefault?: boolean;
+}
+/**
+ * Erreur normalisée transportée dans les rejets de promesse.
+ * Côté JS elle est exposée via PrinterError (classe).
+ */
+export interface NormalizedErrorShape {
+    code: PrintErrorCode;
+    message: string;
+    /** Détail brut (message SDK / exception native). */
+    detail?: string;
+    /** Transport concerné si pertinent. */
+    transport?: PrinterTransport;
+    /** Adapter concerné si pertinent. */
+    adapter?: PrinterAdapterId;
+    /** Indique si une nouvelle tentative a du sens. */
+    retryable?: boolean;
+}

package/dist/esm/core/options.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=options.js.map

package/dist/esm/core/options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../../../src/core/options.ts"],"names":[],"mappings":"","sourcesContent":["import type { PrinterAdapterId, PrinterTransport, PrintErrorCode } from './enums';\n\n/**\n * Algorithme de tramage (dithering) appliqué lors de la conversion 1-bit.\n * - `none`             : seuillage simple (threshold) — idéal pour texte/ligne nettes.\n * - `floyd_steinberg`  : tramage par diffusion d'erreur — idéal pour logos/photos.\n * - `atkinson`         : variante plus contrastée, agréable sur tickets.\n */\nexport type DitheringAlgorithm = 'none' | 'floyd_steinberg' | 'atkinson';\n\n/** Alignement horizontal de l'image si plus étroite que la zone imprimable. */\nexport type ImageAlign = 'left' | 'center' | 'right';\n\n/**\n * Options de rendu image -> impression. Indépendantes du transport.\n */\nexport interface PrintRenderOptions {\n  /**\n   * Largeur cible en points (dots). Si omise, déduite du profil/capacités\n   * (ex: 384 pour 58mm, 576 pour 80mm).\n   */\n  widthDots?: number;\n  /**\n   * Redimensionner l'image à la largeur cible. Défaut `true`.\n   * Mettre `false` si l'image est DÉJÀ à la bonne largeur (rendu serveur) :\n   * envoi tel quel, pixel-perfect, plus rapide.\n   */\n  resize?: boolean;\n  /**\n   * Conversion niveaux de gris + dithering. Défaut `true`.\n   * Mettre `false` si l'image est DÉJÀ en 1-bit noir/blanc (pré-traitée serveur) :\n   * un simple seuil est appliqué, sans dithering.\n   */\n  grayscale?: boolean;\n  /** Seuil de binarisation 0-255 (défaut 128) quand dithering = 'none'. */\n  threshold?: number;\n  /** Algorithme de tramage. Défaut: 'floyd_steinberg'. */\n  dithering?: DitheringAlgorithm;\n  /** Alignement si l'image est plus étroite que la largeur imprimable. Défaut 'center'. */\n  align?: ImageAlign;\n  /** Inverser le noir et blanc (impression en négatif). */\n  invert?: boolean;\n  /** Couper le papier après impression (si supportsCut). Défaut true. */\n  cut?: boolean;\n  /** Nombre de lignes de feed avant la coupe. Défaut 3. */\n  feedLines?: number;\n  /** Ouvrir le tiroir-caisse après impression (si supportsCashDrawer). Défaut false. */\n  openCashDrawer?: boolean;\n  /** Nombre de copies. Défaut 1. */\n  copies?: number;\n}\n\n/**\n * Source de l'image à imprimer. Une seule des trois clés doit être renseignée.\n * Ordre de préférence en production : `filePath` > `url` > `base64`.\n */\nexport interface ImageSource {\n  /** Chemin local du fichier (file:// ou chemin absolu). MODE RECOMMANDÉ. */\n  filePath?: string;\n  /** URL distante. Le plugin télécharge (avec cache). */\n  url?: string;\n  /** Données base64 (avec ou sans préfixe data:). Pratique en test. */\n  base64?: string;\n}\n\n/**\n * Options de l'appel printImage.\n */\nexport interface PrintImageOptions {\n  /** Imprimante cible. Si omis, utilise l'imprimante par défaut. */\n  printerId?: string;\n  /** Source image. */\n  image: ImageSource;\n  /** Options de rendu (fusionnées avec les defaults du profil). */\n  render?: PrintRenderOptions;\n  /** Timeout global de l'opération en ms (reconnexion + envoi). Défaut 15000. */\n  timeoutMs?: number;\n  /**\n   * Si true, tente une reconnexion automatique si l'imprimante n'est pas connectée.\n   * Défaut true.\n   */\n  autoReconnect?: boolean;\n}\n\n/**\n * Options de découverte agrégée.\n */\nexport interface DiscoverOptions {\n  /**\n   * Sous-ensemble de sources à activer. Si omis, toutes les sources disponibles\n   * sur la plateforme sont lancées en parallèle.\n   */\n  sources?: DiscoverySource[];\n  /** Durée max de scan en ms (le scan BT/BLE est borné par ce délai). Défaut 8000. */\n  timeoutMs?: number;\n  /** Inclure les appareils Bluetooth déjà appairés (Android). Défaut true. */\n  includePaired?: boolean;\n  /**\n   * Plage/segment réseau à scanner pour TCP 9100 (ex: \"192.168.1.0/24\").\n   * Si omis, déduit du réseau courant.\n   */\n  networkCidr?: string;\n  /** Ports TCP à sonder en plus de 9100 (ex: [9100, 6101, 515]). */\n  tcpPorts?: number[];\n  /** Émettre des résultats incrémentaux via l'event 'printerFound'. Défaut true. */\n  emitPartialResults?: boolean;\n}\n\n/** Sources de découverte activables. */\nexport type DiscoverySource =\n  | 'epson'\n  | 'star'\n  | 'brother'\n  | 'zebra'\n  | 'tcp'\n  | 'bluetooth'\n  | 'ble'\n  | 'usb';\n\n/**\n * Options de l'appel printText.\n */\nexport interface PrintTextOptions {\n  /** Imprimante cible. Si omis, utilise l'imprimante par défaut. */\n  printerId?: string;\n  /** Liste ordonnée d'items à imprimer (texte stylé, QR, code-barres, feed, cut...). */\n  items: import('./text').PrintItem[];\n  /** Page de code par défaut pour les accents (français : 'WPC1252'). */\n  defaultCodePage?: import('./text').CodePage;\n  /** Couper le papier en fin de job (si non géré par un item `cut`). Défaut false. */\n  cut?: boolean;\n  /** Lignes d'avance en fin de job avant la coupe. Défaut 3. */\n  feedLines?: number;\n  /** Timeout global de l'opération en ms. Défaut 15000. */\n  timeoutMs?: number;\n  /** Reconnexion automatique si non connecté. Défaut true. */\n  autoReconnect?: boolean;\n}\n\n/**\n * Options de connexion explicite.\n */\nexport interface ConnectOptions {\n  printerId: string;\n  /** Timeout de connexion ms. Défaut 10000. */\n  timeoutMs?: number;\n  /** Forcer un adapter (sinon: celui résolu à la découverte / dans le profil). */\n  forceAdapter?: PrinterAdapterId;\n  /**\n   * Si `true`, enregistre cette imprimante comme imprimante par défaut\n   * UNIQUEMENT si la connexion réussit (persistance du profil incluse).\n   * Défaut `false`.\n   */\n  setAsDefault?: boolean;\n}\n\n/**\n * Erreur normalisée transportée dans les rejets de promesse.\n * Côté JS elle est exposée via PrinterError (classe).\n */\nexport interface NormalizedErrorShape {\n  code: PrintErrorCode;\n  message: string;\n  /** Détail brut (message SDK / exception native). */\n  detail?: string;\n  /** Transport concerné si pertinent. */\n  transport?: PrinterTransport;\n  /** Adapter concerné si pertinent. */\n  adapter?: PrinterAdapterId;\n  /** Indique si une nouvelle tentative a du sens. */\n  retryable?: boolean;\n}\n"]}