@hidemikimura/receipt-html-to-pdf 0.1.0

package/src/pdf/content.js

@@ -0,0 +1,192 @@
+// @ts-check
+/**
+ * ページコンテンツストリームのビルダー。
+ * 座標は PDF 座標系（左下原点、pt）で受け取る。CSS 座標からの変換は呼び出し側（page.js）が行う。
+ */
+import { num } from '../units.js';
+
+export class ContentStream {
+  constructor() {
+    /** @type {string[]} */
+    this.ops = [];
+    this.depth = 0;
+  }
+
+  save() {
+    this.ops.push('q');
+    this.depth++;
+    return this;
+  }
+
+  restore() {
+    if (this.depth <= 0) throw new Error('ContentStream: unbalanced Q');
+    this.ops.push('Q');
+    this.depth--;
+    return this;
+  }
+
+  /** @param {number} a @param {number} b @param {number} c @param {number} d @param {number} e @param {number} f */
+  transform(a, b, c, d, e, f) {
+    this.ops.push(`${num(a)} ${num(b)} ${num(c)} ${num(d)} ${num(e)} ${num(f)} cm`);
+    return this;
+  }
+
+  /** @param {string} gsName ExtGState リソース名 */
+  setGState(gsName) {
+    this.ops.push(`/${gsName} gs`);
+    return this;
+  }
+
+  /** @param {number} r @param {number} g @param {number} b */
+  fillColor(r, g, b) {
+    this.ops.push(`${num(r)} ${num(g)} ${num(b)} rg`);
+    return this;
+  }
+
+  /** @param {number} r @param {number} g @param {number} b */
+  strokeColor(r, g, b) {
+    this.ops.push(`${num(r)} ${num(g)} ${num(b)} RG`);
+    return this;
+  }
+
+  /** @param {number} w */
+  lineWidth(w) {
+    this.ops.push(`${num(w)} w`);
+    return this;
+  }
+
+  /** @param {number[]} pattern @param {number} [phase] */
+  dash(pattern, phase = 0) {
+    this.ops.push(`[${pattern.map(num).join(' ')}] ${num(phase)} d`);
+    return this;
+  }
+
+  /** @param {0|1|2} cap */
+  lineCap(cap) {
+    this.ops.push(`${cap} J`);
+    return this;
+  }
+
+  /** @param {number} x @param {number} y @param {number} w @param {number} h */
+  rect(x, y, w, h) {
+    this.ops.push(`${num(x)} ${num(y)} ${num(w)} ${num(h)} re`);
+    return this;
+  }
+
+  /** @param {number} x @param {number} y */
+  moveTo(x, y) {
+    this.ops.push(`${num(x)} ${num(y)} m`);
+    return this;
+  }
+
+  /** @param {number} x @param {number} y */
+  lineTo(x, y) {
+    this.ops.push(`${num(x)} ${num(y)} l`);
+    return this;
+  }
+
+  /**
+   * 3 次ベジェ曲線
+   * @param {number} x1 @param {number} y1 @param {number} x2 @param {number} y2 @param {number} x3 @param {number} y3
+   */
+  curveTo(x1, y1, x2, y2, x3, y3) {
+    this.ops.push(`${num(x1)} ${num(y1)} ${num(x2)} ${num(y2)} ${num(x3)} ${num(y3)} c`);
+    return this;
+  }
+
+  closePath() {
+    this.ops.push('h');
+    return this;
+  }
+
+  /**
+   * 角丸矩形のパスを追加する（PDF 座標: y 上向き、(x, y) は左下）。
+   * @param {number} x @param {number} y @param {number} w @param {number} h
+   * @param {[number, number, number, number]} r  [左上, 右上, 右下, 左下] の半径（pt）。CSS の順序
+   */
+  roundedRect(x, y, w, h, r) {
+    const k = 0.5523; // 4/3·(√2−1)
+    const max = Math.min(w, h) / 2;
+    const clamp = (/** @type {number} */ v) => Math.max(0, Math.min(v, max));
+    const tl = clamp(r[0]);
+    const tr = clamp(r[1]);
+    const br = clamp(r[2]);
+    const bl = clamp(r[3]);
+    const top = y + h;
+    const right = x + w;
+    // 左上から時計回り（PDF 座標では上辺が y+h）
+    this.moveTo(x + tl, top);
+    this.lineTo(right - tr, top);
+    if (tr) this.curveTo(right - tr + tr * k, top, right, top - tr + tr * k, right, top - tr);
+    this.lineTo(right, y + br);
+    if (br) this.curveTo(right, y + br - br * k, right - br + br * k, y, right - br, y);
+    this.lineTo(x + bl, y);
+    if (bl) this.curveTo(x + bl - bl * k, y, x, y + bl - bl * k, x, y + bl);
+    this.lineTo(x, top - tl);
+    if (tl) this.curveTo(x, top - tl + tl * k, x + tl - tl * k, top, x + tl, top);
+    return this.closePath();
+  }
+
+  /**
+   * 画像 XObject を (x, y) を左下として w×h で描く。
+   * @param {string} name @param {number} x @param {number} y @param {number} w @param {number} h
+   */
+  image(name, x, y, w, h) {
+    this.ops.push(`q ${num(w)} 0 0 ${num(h)} ${num(x)} ${num(y)} cm /${name} Do Q`);
+    return this;
+  }
+
+  fill() {
+    this.ops.push('f');
+    return this;
+  }
+
+  stroke() {
+    this.ops.push('S');
+    return this;
+  }
+
+  /** 現在のパスでクリップして新しいパスを開始する */
+  clip() {
+    this.ops.push('W n');
+    return this;
+  }
+
+  /** @param {number} x @param {number} y @param {number} w @param {number} h */
+  fillRect(x, y, w, h) {
+    return this.rect(x, y, w, h).fill();
+  }
+
+  /**
+   * テキストを描画する。
+   * @param {string} fontName  リソース名（F1 など）
+   * @param {number} size      フォントサイズ (pt)
+   * @param {number} x         ベースライン始点 x (pt)
+   * @param {number} y         ベースライン y (pt)
+   * @param {Array<string|number>} tj  TJ 配列。文字列は 16 進 CID 列（<...> なし）、数値は 1/1000 単位の位置調整
+   * @param {{charSpacing?: number, rise?: number}} [opts]
+   */
+  text(fontName, size, x, y, tj, opts = {}) {
+    const parts = [];
+    for (const t of tj) {
+      if (typeof t === 'string') {
+        if (t.length) parts.push(`<${t}>`);
+      } else if (t !== 0) parts.push(num(t));
+    }
+    if (!parts.length) return this;
+    this.ops.push('BT');
+    this.ops.push(`/${fontName} ${num(size)} Tf`);
+    if (opts.charSpacing) this.ops.push(`${num(opts.charSpacing)} Tc`);
+    if (opts.rise) this.ops.push(`${num(opts.rise)} Ts`);
+    this.ops.push(`1 0 0 1 ${num(x)} ${num(y)} Tm`);
+    this.ops.push(`[${parts.join(' ')}] TJ`);
+    this.ops.push('ET');
+    return this;
+  }
+
+  /** @returns {Uint8Array} */
+  toBytes() {
+    if (this.depth !== 0) throw new Error(`ContentStream: ${this.depth} unclosed q`);
+    return new TextEncoder().encode(this.ops.join('\n') + '\n');
+  }
+}

package/src/pdf/image.js

@@ -0,0 +1,33 @@
+// @ts-check
+/**
+ * デコード済み画像を PDF の Image XObject として書き出す。
+ */
+
+/**
+ * @param {import('../pdf/writer.js').PdfWriter} writer
+ * @param {import('../walker/image.js').DecodedImage} img
+ * @returns {Promise<import('../pdf/writer.js').Ref>}
+ */
+export async function embedImage(writer, img) {
+  /** @type {{[key: string]: import('../pdf/writer.js').PdfValue}} */
+  const dict = {
+    Type: 'XObject',
+    Subtype: 'Image',
+    Width: img.width,
+    Height: img.height,
+    ColorSpace: 'DeviceRGB',
+    BitsPerComponent: 8,
+  };
+  if (img.jpeg) {
+    dict.Filter = 'DCTDecode';
+    return writer.addStream(dict, img.jpeg, { compress: false });
+  }
+  if (!img.rgb) throw new Error('embedImage: image has no pixel data');
+  if (img.alpha) {
+    dict.SMask = await writer.addStream(
+      { Type: 'XObject', Subtype: 'Image', Width: img.width, Height: img.height, ColorSpace: 'DeviceGray', BitsPerComponent: 8 },
+      img.alpha,
+    );
+  }
+  return writer.addStream(dict, img.rgb);
+}

package/src/pdf/writer.js

@@ -0,0 +1,253 @@
+// @ts-check
+/**
+ * 最小限の PDF ライター。
+ * オブジェクトをメモリ上に保持し、build() で xref / trailer を含むバイト列を組み立てる。
+ */
+import { deflate } from './compress.js';
+import { num } from '../units.js';
+
+/** 間接オブジェクト参照 */
+export class Ref {
+  /** @param {number} id */
+  constructor(id) {
+    this.id = id;
+  }
+  toString() {
+    return `${this.id} 0 R`;
+  }
+}
+
+/** PDF 名前オブジェクト（/Name） */
+export class Name {
+  /** @param {string} name */
+  constructor(name) {
+    this.name = name;
+  }
+  toString() {
+    // 区切り文字・非 ASCII は #xx でエスケープ
+    let out = '/';
+    for (const ch of this.name) {
+      const c = ch.charCodeAt(0);
+      if (c < 0x21 || c > 0x7e || '#/%()<>[]{}'.includes(ch)) {
+        for (const b of new TextEncoder().encode(ch)) out += '#' + b.toString(16).padStart(2, '0');
+      } else out += ch;
+    }
+    return out;
+  }
+}
+
+/** バイト列そのまま（既にシリアライズ済みの断片） */
+export class Raw {
+  /** @param {string} text */
+  constructor(text) {
+    this.text = text;
+  }
+  toString() {
+    return this.text;
+  }
+}
+
+/**
+ * PDF テキスト文字列。ASCII のみならリテラル文字列、そうでなければ UTF-16BE (BOM 付き) の 16 進文字列。
+ * @param {string} s
+ * @returns {Raw}
+ */
+export function pdfString(s) {
+  // eslint-disable-next-line no-control-regex
+  if (/^[\x20-\x7e]*$/.test(s)) {
+    return new Raw('(' + s.replace(/[\\()]/g, (c) => '\\' + c) + ')');
+  }
+  let hex = 'FEFF';
+  for (let i = 0; i < s.length; i++) hex += s.charCodeAt(i).toString(16).padStart(4, '0');
+  return new Raw('<' + hex + '>');
+}
+
+/**
+ * PDF 日付文字列 (D:YYYYMMDDHHmmSS+HH'mm')
+ * @param {Date} d
+ * @returns {Raw}
+ */
+export function pdfDate(d) {
+  const p = (/** @type {number} */ n) => String(n).padStart(2, '0');
+  const tz = -d.getTimezoneOffset();
+  const sign = tz >= 0 ? '+' : '-';
+  const tzh = p(Math.floor(Math.abs(tz) / 60));
+  const tzm = p(Math.abs(tz) % 60);
+  return new Raw(
+    `(D:${d.getFullYear()}${p(d.getMonth() + 1)}${p(d.getDate())}${p(d.getHours())}${p(d.getMinutes())}${p(d.getSeconds())}${sign}${tzh}'${tzm}')`,
+  );
+}
+
+/**
+ * @typedef {number|string|boolean|null|Ref|Name|Raw|PdfArray|PdfDict} PdfValue
+ */
+/** @typedef {PdfValue[]} PdfArray */
+/** @typedef {{[key: string]: PdfValue}} PdfDict */
+
+/**
+ * 値を PDF 構文にシリアライズする。
+ * - number → 数値、boolean → true/false、null → null
+ * - string → 名前 (/Foo)。テキスト文字列は pdfString() で Raw にして渡す
+ * - 配列 → [ ... ]、プレーンオブジェクト → << /Key value ... >>
+ * @param {PdfValue} v
+ * @returns {string}
+ */
+export function serialize(v) {
+  if (v === null) return 'null';
+  if (typeof v === 'number') return num(v);
+  if (typeof v === 'boolean') return v ? 'true' : 'false';
+  if (typeof v === 'string') return new Name(v).toString();
+  if (v instanceof Ref || v instanceof Name || v instanceof Raw) return v.toString();
+  if (Array.isArray(v)) return '[' + v.map(serialize).join(' ') + ']';
+  const parts = [];
+  for (const [k, val] of Object.entries(v)) {
+    if (val === undefined) continue;
+    parts.push(new Name(k).toString() + ' ' + serialize(val));
+  }
+  return '<< ' + parts.join(' ') + ' >>';
+}
+
+/**
+ * @typedef {object} PdfObject
+ * @property {PdfValue} value
+ * @property {Uint8Array} [stream]
+ */
+
+export class PdfWriter {
+  /**
+   * @param {{compress?: boolean, version?: string}} [options]
+   */
+  constructor(options = {}) {
+    /** @type {(PdfObject|null)[]} 0 番はフリーオブジェクト */
+    this.objects = [null];
+    this.compress = options.compress ?? true;
+    this.version = options.version ?? '1.7';
+  }
+
+  /**
+   * 間接オブジェクトを予約する（後で set で中身を入れる）。
+   * @returns {Ref}
+   */
+  reserve() {
+    this.objects.push({ value: null });
+    return new Ref(this.objects.length - 1);
+  }
+
+  /**
+   * @param {Ref} ref
+   * @param {PdfValue} value
+   * @param {Uint8Array} [stream]
+   */
+  set(ref, value, stream) {
+    this.objects[ref.id] = { value, stream };
+  }
+
+  /**
+   * @param {PdfValue} value
+   * @returns {Ref}
+   */
+  add(value) {
+    const ref = this.reserve();
+    this.set(ref, value);
+    return ref;
+  }
+
+  /**
+   * ストリームオブジェクトを追加する。compress が有効なら FlateDecode を試みる。
+   * @param {{[key: string]: PdfValue}} dict
+   * @param {Uint8Array} bytes
+   * @param {{compress?: boolean}} [opts]
+   * @returns {Promise<Ref>}
+   */
+  async addStream(dict, bytes, opts = {}) {
+    const ref = this.reserve();
+    await this.setStream(ref, dict, bytes, opts);
+    return ref;
+  }
+
+  /**
+   * @param {Ref} ref
+   * @param {{[key: string]: PdfValue}} dict
+   * @param {Uint8Array} bytes
+   * @param {{compress?: boolean}} [opts]
+   */
+  async setStream(ref, dict, bytes, opts = {}) {
+    let data = bytes;
+    const d = { ...dict };
+    const doCompress = opts.compress ?? this.compress;
+    if (doCompress && !('Filter' in d)) {
+      const z = await deflate(bytes);
+      if (z && z.length < bytes.length) {
+        data = z;
+        d.Filter = 'FlateDecode';
+      }
+    }
+    d.Length = data.length;
+    this.set(ref, d, data);
+  }
+
+  /**
+   * ドキュメント全体を組み立てる。
+   * @param {Ref} rootRef  /Catalog への参照
+   * @param {Ref} [infoRef] /Info への参照
+   * @returns {Uint8Array}
+   */
+  build(rootRef, infoRef) {
+    const enc = new TextEncoder();
+    /** @type {Uint8Array[]} */
+    const chunks = [];
+    let offset = 0;
+    const push = (/** @type {Uint8Array|string} */ c) => {
+      const b = typeof c === 'string' ? enc.encode(c) : c;
+      chunks.push(b);
+      offset += b.length;
+    };
+
+    // ヘッダー。2 行目のバイナリコメントはファイルがバイナリであることを転送系に知らせる慣例
+    push(concat([enc.encode(`%PDF-${this.version}\n%`), new Uint8Array([0xe2, 0xe3, 0xcf, 0xd3]), enc.encode('\n')]));
+
+    /** @type {number[]} */
+    const offsets = [];
+    for (let i = 1; i < this.objects.length; i++) {
+      const obj = this.objects[i];
+      if (!obj) throw new Error(`PDF object ${i} was reserved but never set`);
+      offsets[i] = offset;
+      push(`${i} 0 obj\n${serialize(obj.value)}\n`);
+      if (obj.stream) {
+        push('stream\n');
+        push(obj.stream);
+        push('\nendstream\n');
+      }
+      push('endobj\n');
+    }
+
+    const xrefOffset = offset;
+    let xref = `xref\n0 ${this.objects.length}\n0000000000 65535 f \n`;
+    for (let i = 1; i < this.objects.length; i++) {
+      xref += String(offsets[i]).padStart(10, '0') + ' 00000 n \n';
+    }
+    push(xref);
+    /** @type {{[key: string]: PdfValue}} */
+    const trailer = { Size: this.objects.length, Root: rootRef };
+    if (infoRef) trailer.Info = infoRef;
+    push(`trailer\n${serialize(trailer)}\nstartxref\n${xrefOffset}\n%%EOF\n`);
+
+    return concat(chunks);
+  }
+}
+
+/**
+ * @param {Uint8Array[]} chunks
+ * @returns {Uint8Array}
+ */
+export function concat(chunks) {
+  let len = 0;
+  for (const c of chunks) len += c.length;
+  const out = new Uint8Array(len);
+  let o = 0;
+  for (const c of chunks) {
+    out.set(c, o);
+    o += c.length;
+  }
+  return out;
+}