@levischuck/receiptline 0.0.5 → 0.1.0

package/dist/parse.d.ts

@@ -69,5 +69,5 @@ export declare function parseLine(columns: string, state: ParseState): ParsedCol
  * @param state state variables
  * @returns printer command fragment or SVG image fragment
  */
-export declare function createLine(line: ParsedColumn[], printer: ParsedPrinter, state: ParseState): string;
+export declare function createLine(line: ParsedColumn[], printer: ParsedPrinter, state: ParseState): Promise<string>;
 export {};

package/dist/targets/audit.d.ts

@@ -0,0 +1,157 @@
+import { BaseTarget } from './base.ts';
+import { Encoding, ParsedPrinter, QRCode, Barcode } from '../types.ts';
+/**
+ * Audit target class for ReceiptLine commands.
+ * Logs all method calls instead of implementing them.
+ */
+export declare class AuditTarget extends BaseTarget {
+    private logs;
+    /**
+     * Start printing.
+     * @param {object} printer printer configuration
+     * @returns {Promise<string>} empty string
+     */
+    open(printer: ParsedPrinter): Promise<string>;
+    /**
+     * Finish printing.
+     * @returns {Promise<string>} all logs joined with newlines
+     */
+    close(): Promise<string>;
+    /**
+     * Set print area.
+     * @param {number} left left margin (unit: characters)
+     * @param {number} width print area (unit: characters)
+     * @param {number} right right margin (unit: characters)
+     * @returns {Promise<string>} empty string
+     */
+    area(left: number, width: number, right: number): Promise<string>;
+    /**
+     * Set line alignment.
+     * @param {number} align line alignment (0: left, 1: center, 2: right)
+     * @returns {Promise<string>} empty string
+     */
+    align(align: number): Promise<string>;
+    /**
+     * Set absolute print position.
+     * @param {number} position absolute position (unit: characters)
+     * @returns {Promise<string>} empty string
+     */
+    absolute(position: number): Promise<string>;
+    /**
+     * Set relative print position.
+     * @param {number} position relative position (unit: characters)
+     * @returns {Promise<string>} empty string
+     */
+    relative(position: number): Promise<string>;
+    /**
+     * Print horizontal rule.
+     * @param {number} width line width (unit: characters)
+     * @returns {Promise<string>} empty string
+     */
+    hr(width: number): Promise<string>;
+    /**
+     * Print vertical rules.
+     * @param {number[]} widths vertical line spacing
+     * @param {number} height text height (1-6)
+     * @returns {Promise<string>} empty string
+     */
+    vr(widths: number[], height: number): Promise<string>;
+    /**
+     * Start rules.
+     * @param {number[]} widths vertical line spacing
+     * @returns {Promise<string>} empty string
+     */
+    vrstart(widths: number[]): Promise<string>;
+    /**
+     * Stop rules.
+     * @param {number[]} widths vertical line spacing
+     * @returns {Promise<string>} empty string
+     */
+    vrstop(widths: number[]): Promise<string>;
+    /**
+     * Print vertical and horizontal rules.
+     * @param {number[]} widths1 vertical line spacing (stop)
+     * @param {number[]} widths2 vertical line spacing (start)
+     * @param {number} dl difference in left position
+     * @param {number} dr difference in right position
+     * @returns {Promise<string>} empty string
+     */
+    vrhr(widths1: number[], widths2: number[], dl: number, dr: number): Promise<string>;
+    /**
+     * Set line spacing and feed new line.
+     * @param {boolean} vr whether vertical ruled lines are printed
+     * @returns {Promise<string>} empty string
+     */
+    vrlf(vr: boolean): Promise<string>;
+    /**
+     * Cut paper.
+     * @returns {Promise<string>} empty string
+     */
+    cut(): Promise<string>;
+    /**
+     * Underline text.
+     * @returns {Promise<string>} empty string
+     */
+    ul(): Promise<string>;
+    /**
+     * Emphasize text.
+     * @returns {Promise<string>} empty string
+     */
+    em(): Promise<string>;
+    /**
+     * Invert text.
+     * @returns {Promise<string>} empty string
+     */
+    iv(): Promise<string>;
+    /**
+     * Scale up text.
+     * @param {number} wh number of special character '^' (1-7)
+     * @returns {Promise<string>} empty string
+     */
+    wh(wh: number): Promise<string>;
+    /**
+     * Cancel text decoration.
+     * @returns {Promise<string>} empty string
+     */
+    normal(): Promise<string>;
+    /**
+     * Print text.
+     * @param {string} text string to print
+     * @param {string} encoding codepage
+     * @returns {Promise<string>} empty string
+     */
+    text(text: string, encoding: Encoding): Promise<string>;
+    /**
+     * Feed new line.
+     * @returns {Promise<string>} empty string
+     */
+    lf(): Promise<string>;
+    /**
+     * Insert commands.
+     * @param {string} command commands to insert
+     * @returns {Promise<string>} empty string
+     */
+    command(command: string): Promise<string>;
+    /**
+     * Print image.
+     * @param {string} image image data (base64 png format)
+     * @returns {Promise<string>} empty string
+     */
+    image(image: string): Promise<string>;
+    /**
+     * Print QR Code.
+     * @param {object} symbol QR Code information (data, type, cell, level)
+     * @param {string} encoding codepage
+     * @returns {Promise<string>} empty string
+     */
+    qrcode(symbol: QRCode, encoding: Encoding): Promise<string>;
+    /**
+     * Print barcode.
+     * @param {object} symbol barcode information (data, type, width, height, hri)
+     * @param {string} encoding codepage
+     * @returns {Promise<string>} empty string
+     */
+    barcode(symbol: Barcode, encoding: Encoding): Promise<string>;
+    calculatedWidth(): number;
+    calculatedHeight(): number;
+}

package/dist/targets/base.d.ts

@@ -3,6 +3,26 @@ import { Encoding, ParsedPrinter, QRCode, Barcode, BaseTargetInterface } from '.
  * Base target class for ReceiptLine commands.
  */
 export declare class BaseTarget implements BaseTargetInterface {
+    private locked;
+    private lockPromise;
+    private lockResolve;
+    protected _cpl: number;
+    /**
+     * Get characters per line.
+     * @returns {number} characters per line
+     */
+    get cpl(): number;
+    /**
+     * Lock the target for exclusive use.
+     * @param {number} [timeout] timeout in milliseconds (default: 5000)
+     * @returns {Promise<void>} resolves when lock is acquired
+     * @throws {Error} if timeout occurs
+     */
+    lock(timeout?: number): Promise<void>;
+    /**
+     * Unlock the target.
+     */
+    unlock(): void;
     /**
      * Measure text width.
      * @param {string} text string to measure
@@ -20,149 +40,149 @@ export declare class BaseTarget implements BaseTargetInterface {
     /**
      * Start printing.
      * @param {object} printer printer configuration
-     * @returns {string} commands
+     * @returns {Promise<string>} commands
      */
-    open(printer: ParsedPrinter): string;
+    open(printer: ParsedPrinter): Promise<string>;
     /**
      * Finish printing.
-     * @returns {string} commands
+     * @returns {Promise<string>} commands
      */
-    close(): string;
+    close(): Promise<string>;
     /**
      * Set print area.
      * @param {number} left left margin (unit: characters)
      * @param {number} width print area (unit: characters)
      * @param {number} right right margin (unit: characters)
-     * @returns {string} commands
+     * @returns {Promise<string>} commands
      */
-    area(left: number, width: number, right: number): string;
+    area(left: number, width: number, right: number): Promise<string>;
     /**
      * Set line alignment.
      * @param {number} align line alignment (0: left, 1: center, 2: right)
-     * @returns {string} commands
+     * @returns {Promise<string>} commands
      */
-    align(align: number): string;
+    align(align: number): Promise<string>;
     /**
      * Set absolute print position.
      * @param {number} position absolute position (unit: characters)
-     * @returns {string} commands
+     * @returns {Promise<string>} commands
      */
-    absolute(position: number): string;
+    absolute(position: number): Promise<string>;
     /**
      * Set relative print position.
      * @param {number} position relative position (unit: characters)
-     * @returns {string} commands
+     * @returns {Promise<string>} commands
      */
-    relative(position: number): string;
+    relative(position: number): Promise<string>;
     /**
      * Print horizontal rule.
      * @param {number} width line width (unit: characters)
-     * @returns {string} commands
+     * @returns {Promise<string>} commands
      */
-    hr(width: number): string;
+    hr(width: number): Promise<string>;
     /**
      * Print vertical rules.
      * @param {number[]} widths vertical line spacing
      * @param {number} height text height (1-6)
-     * @returns {string} commands
+     * @returns {Promise<string>} commands
      */
-    vr(widths: number[], height: number): string;
+    vr(widths: number[], height: number): Promise<string>;
     /**
      * Start rules.
      * @param {number[]} widths vertical line spacing
-     * @returns {string} commands
+     * @returns {Promise<string>} commands
      */
-    vrstart(widths: number[]): string;
+    vrstart(widths: number[]): Promise<string>;
     /**
      * Stop rules.
      * @param {number[]} widths vertical line spacing
-     * @returns {string} commands
+     * @returns {Promise<string>} commands
      */
-    vrstop(widths: number[]): string;
+    vrstop(widths: number[]): Promise<string>;
     /**
      * Print vertical and horizontal rules.
      * @param {number[]} widths1 vertical line spacing (stop)
      * @param {number[]} widths2 vertical line spacing (start)
      * @param {number} dl difference in left position
      * @param {number} dr difference in right position
-     * @returns {string} commands
+     * @returns {Promise<string>} commands
      */
-    vrhr(widths1: number[], widths2: number[], dl: number, dr: number): string;
+    vrhr(widths1: number[], widths2: number[], dl: number, dr: number): Promise<string>;
     /**
      * Set line spacing and feed new line.
      * @param {boolean} vr whether vertical ruled lines are printed
-     * @returns {string} commands
+     * @returns {Promise<string>} commands
      */
-    vrlf(vr: boolean): string;
+    vrlf(vr: boolean): Promise<string>;
     /**
      * Cut paper.
-     * @returns {string} commands
+     * @returns {Promise<string>} commands
      */
-    cut(): string;
+    cut(): Promise<string>;
     /**
      * Underline text.
-     * @returns {string} commands
+     * @returns {Promise<string>} commands
      */
-    ul(): string;
+    ul(): Promise<string>;
     /**
      * Emphasize text.
-     * @returns {string} commands
+     * @returns {Promise<string>} commands
      */
-    em(): string;
+    em(): Promise<string>;
     /**
      * Invert text.
-     * @returns {string} commands
+     * @returns {Promise<string>} commands
      */
-    iv(): string;
+    iv(): Promise<string>;
     /**
      * Scale up text.
      * @param {number} wh number of special character '^' (1-7)
-     * @returns {string} commands
+     * @returns {Promise<string>} commands
      */
-    wh(wh: number): string;
+    wh(wh: number): Promise<string>;
     /**
      * Cancel text decoration.
-     * @returns {string} commands
+     * @returns {Promise<string>} commands
      */
-    normal(): string;
+    normal(): Promise<string>;
     /**
      * Print text.
      * @param {string} text string to print
      * @param {string} encoding codepage
-     * @returns {string} commands
+     * @returns {Promise<string>} commands
      */
-    text(text: string, encoding: Encoding): string;
+    text(text: string, encoding: Encoding): Promise<string>;
     /**
      * Feed new line.
-     * @returns {string} commands
+     * @returns {Promise<string>} commands
      */
-    lf(): string;
+    lf(): Promise<string>;
     /**
      * Insert commands.
      * @param {string} command commands to insert
-     * @returns {string} commands
+     * @returns {Promise<string>} commands
      */
-    command(command: string): string;
+    command(command: string): Promise<string>;
     /**
      * Print image.
      * @param {string} image image data (base64 png format)
-     * @returns {string} commands
+     * @returns {Promise<string>} commands
      */
-    image(image: string): string;
+    image(image: string): Promise<string>;
     /**
      * Print QR Code.
      * @param {object} symbol QR Code information (data, type, cell, level)
      * @param {string} encoding codepage
-     * @returns {string} commands
+     * @returns {Promise<string>} commands
      */
-    qrcode(symbol: QRCode, encoding: Encoding): string;
+    qrcode(symbol: QRCode, encoding: Encoding): Promise<string>;
     /**
      * Print barcode.
      * @param {object} symbol barcode information (data, type, width, height, hri)
      * @param {string} encoding codepage
-     * @returns {string} commands
+     * @returns {Promise<string>} commands
      */
-    barcode(symbol: Barcode, encoding: Encoding): string;
+    barcode(symbol: Barcode, encoding: Encoding): Promise<string>;
     calculatedWidth(): number;
     calculatedHeight(): number;
 }

package/dist/targets/html.d.ts

@@ -0,0 +1,72 @@
+import { BaseTarget } from './base.ts';
+import { Encoding, ParsedPrinter, QRCode, Barcode } from '../types.ts';
+import { HtmlNode, HtmlStyle, HtmlElement } from '@levischuck/tiny-html';
+/**
+ * Represents a text segment queued for rendering on a line.
+ * Receipt printers accumulate positioning and text commands, then render on linefeed.
+ */
+interface LineSegment {
+    position: number;
+    text: string;
+    styles: HtmlStyle;
+    scale: number;
+    charWidth: number;
+}
+/**
+ * HTML target class for ReceiptLine commands.
+ * Uses CSS for natural text flow and word wrapping instead of absolute positioning.
+ */
+export declare class HtmlTarget extends BaseTarget {
+    charWidth: number;
+    charHeight: number;
+    containerWidth: number;
+    estimatedHeight: number;
+    lineMargin: number;
+    lineAlign: number;
+    lineWidth: number;
+    lineHeight: number;
+    textEncoding: Encoding;
+    feedMinimum: number;
+    spacing: boolean;
+    defaultFont: string;
+    actualFontCharacterWidth: number | undefined;
+    private explicitCharHeight;
+    contentNodes: HtmlNode[];
+    currentStyles: HtmlStyle;
+    textScale: number;
+    currentPosition: number;
+    lineSegments: LineSegment[];
+    pendingVrSvg: HtmlElement | null;
+    open(printer: ParsedPrinter): Promise<string>;
+    setDefaultFont(font: string): string;
+    setActualFontCharacterWidth(width: number | undefined): void;
+    setCharHeight(height: number | undefined): void;
+    close(): Promise<string>;
+    area(left: number, width: number, _right: number): Promise<string>;
+    align(align: number): Promise<string>;
+    absolute(position: number): Promise<string>;
+    relative(position: number): Promise<string>;
+    hr(width: number): Promise<string>;
+    vr(widths: number[], height: number): Promise<string>;
+    vrstart(widths: number[]): Promise<string>;
+    private buildVrStartPath;
+    vrstop(widths: number[]): Promise<string>;
+    private buildVrStopPath;
+    vrhr(widths1: number[], widths2: number[], dl: number, dr: number): Promise<string>;
+    vrlf(vr: boolean): Promise<string>;
+    cut(): Promise<string>;
+    ul(): Promise<string>;
+    em(): Promise<string>;
+    iv(): Promise<string>;
+    wh(wh: number): Promise<string>;
+    normal(): Promise<string>;
+    text(text: string, encoding: Encoding): Promise<string>;
+    lf(): Promise<string>;
+    command(_command: string): Promise<string>;
+    image(image: string): Promise<string>;
+    qrcode(symbol: QRCode, _encoding: Encoding): Promise<string>;
+    barcode(symbol: Barcode, _encoding: Encoding): Promise<string>;
+    calculatedWidth(): number;
+    calculatedHeight(): number;
+}
+export {};

package/dist/targets/index.d.ts

@@ -1,7 +1,11 @@
 import { BaseTarget } from './base.ts';
 import { SvgTarget } from './svg.ts';
+import { HtmlTarget } from './html.ts';
+import { AuditTarget } from './audit.ts';
 declare const _default: {
     base: BaseTarget;
     svg: SvgTarget;
+    html: HtmlTarget;
+    audit: AuditTarget;
 };
 export default _default;

package/dist/targets/svg.d.ts

@@ -22,31 +22,31 @@ export declare class SvgTarget extends BaseTarget {
     spacing: boolean;
     defaultFont: string;
     fontSize: number;
-    open(printer: ParsedPrinter): string;
+    open(printer: ParsedPrinter): Promise<string>;
     setDefaultFont(font: string): string;
-    close(): string;
-    area(left: number, width: number, right: number): string;
-    align(align: number): string;
-    absolute(position: number): string;
-    relative(position: number): string;
-    hr(width: number): string;
-    vr(widths: number[], height: number): string;
-    vrstart(widths: number[]): string;
-    vrstop(widths: number[]): string;
-    vrhr(widths1: number[], widths2: number[], dl: number, dr: number): string;
-    vrlf(vr: boolean): string;
-    cut(): string;
-    ul(): string;
-    em(): string;
-    iv(): string;
-    wh(wh: number): string;
-    normal(): string;
-    text(text: string, encoding: Encoding): string;
-    lf(): string;
-    command(command: string): string;
-    image(image: string): string;
-    qrcode(symbol: QRCode, _encoding: Encoding): string;
-    barcode(symbol: Barcode, encoding: Encoding): string;
+    close(): Promise<string>;
+    area(left: number, width: number, right: number): Promise<string>;
+    align(align: number): Promise<string>;
+    absolute(position: number): Promise<string>;
+    relative(position: number): Promise<string>;
+    hr(width: number): Promise<string>;
+    vr(widths: number[], height: number): Promise<string>;
+    vrstart(widths: number[]): Promise<string>;
+    vrstop(widths: number[]): Promise<string>;
+    vrhr(widths1: number[], widths2: number[], dl: number, dr: number): Promise<string>;
+    vrlf(vr: boolean): Promise<string>;
+    cut(): Promise<string>;
+    ul(): Promise<string>;
+    em(): Promise<string>;
+    iv(): Promise<string>;
+    wh(wh: number): Promise<string>;
+    normal(): Promise<string>;
+    text(text: string, encoding: Encoding): Promise<string>;
+    lf(): Promise<string>;
+    command(command: string): Promise<string>;
+    image(image: string): Promise<string>;
+    qrcode(symbol: QRCode, _encoding: Encoding): Promise<string>;
+    barcode(symbol: Barcode, encoding: Encoding): Promise<string>;
     calculatedWidth(): number;
     calculatedHeight(): number;
 }

package/dist/types.d.ts

@@ -9,32 +9,35 @@ export type ParsedPrinter = {
     target: BaseTargetInterface;
 };
 export interface BaseTargetInterface {
+    readonly cpl: number;
+    lock(timeout?: number): Promise<void>;
+    unlock(): void;
     measureText(text: string, encoding: Encoding): number;
     arrayFrom(text: string, encoding: Encoding): string[];
-    open(printer: ParsedPrinter): string;
-    close(): string;
-    area(left: number, width: number, right: number): string;
-    align(align: number): string;
-    absolute(position: number): string;
-    relative(position: number): string;
-    hr(width: number): string;
-    vr(widths: number[], height: number): string;
-    vrstart(widths: number[]): string;
-    vrstop(widths: number[]): string;
-    vrhr(widths1: number[], widths2: number[], dl: number, dr: number): string;
-    vrlf(vr: boolean): string;
-    cut(): string;
-    ul(): string;
-    em(): string;
-    iv(): string;
-    wh(wh: number): string;
-    normal(): string;
-    text(text: string, encoding: Encoding): string;
-    lf(): string;
-    command(command: string): string;
-    image(image: string): string;
-    qrcode(symbol: QRCode, encoding: Encoding): string;
-    barcode(symbol: Barcode, encoding: Encoding): string;
+    open(printer: ParsedPrinter): Promise<string>;
+    close(): Promise<string>;
+    area(left: number, width: number, right: number): Promise<string>;
+    align(align: number): Promise<string>;
+    absolute(position: number): Promise<string>;
+    relative(position: number): Promise<string>;
+    hr(width: number): Promise<string>;
+    vr(widths: number[], height: number): Promise<string>;
+    vrstart(widths: number[]): Promise<string>;
+    vrstop(widths: number[]): Promise<string>;
+    vrhr(widths1: number[], widths2: number[], dl: number, dr: number): Promise<string>;
+    vrlf(vr: boolean): Promise<string>;
+    cut(): Promise<string>;
+    ul(): Promise<string>;
+    em(): Promise<string>;
+    iv(): Promise<string>;
+    wh(wh: number): Promise<string>;
+    normal(): Promise<string>;
+    text(text: string, encoding: Encoding): Promise<string>;
+    lf(): Promise<string>;
+    command(command: string): Promise<string>;
+    image(image: string): Promise<string>;
+    qrcode(symbol: QRCode, encoding: Encoding): Promise<string>;
+    barcode(symbol: Barcode, encoding: Encoding): Promise<string>;
     calculatedWidth(): number;
     calculatedHeight(): number;
 }

package/package.json

@@ -5,7 +5,7 @@
   "type": "module",
   "license": "Apache-2.0",
   "author": "Open Foodservice System Consortium, Levi Schuck",
-  "version": "0.0.5",
+  "version": "0.1.0",
   "devDependencies": {
     "@types/bun": "latest",
     "unplugin-dts": "^1.0.0-beta.6",
@@ -16,8 +16,10 @@
   },
   "dependencies": {
     "@levischuck/tiny-encodings": "^0.2.11",
-    "@levischuck/tiny-qr": "^0.0.5",
-    "@levischuck/tiny-qr-svg": "^0.0.5"
+    "@levischuck/tiny-html": "^0.1.1",
+    "@levischuck/tiny-qr": "^0.0.8",
+    "@levischuck/tiny-qr-png": "^0.0.10",
+    "@levischuck/tiny-qr-svg": "^0.0.8"
   },
   "keywords": [
     "kiosk",
@@ -39,7 +41,7 @@
   },
   "scripts": {
     "build": "vite build",
-    "type-check": "tsc --noEmit"
+    "type-check": "tsc --noEmit && echo 'Type checking examples/react-receiptline' && cd examples/react-receiptline && bun type-check"
   },
   "exports": {
     ".": {