@hidemikimura/receipt-html-to-pdf 0.1.0

package/src/page.js

@@ -0,0 +1,429 @@
+// @ts-check
+/**
+ * DisplayList を用紙に割り付け、PDF ドキュメントを組み立てる。
+ * ページ範囲の決定は paginate.js、ここでは各ページに「本文（範囲指定）・繰り返し thead・ヘッダー・フッター」を描く。
+ */
+import { PdfWriter, pdfString, pdfDate, Name } from './pdf/writer.js';
+import { ContentStream } from './pdf/content.js';
+import { EmbeddedFont, hex4 } from './font/cid.js';
+import { embedImage } from './pdf/image.js';
+import { PX_TO_PT, PAGE_SIZES, lengthToPt, num } from './units.js';
+import { paginate } from './paginate.js';
+
+/**
+ * @typedef {object} PageGeometry
+ * @property {number} width   pt
+ * @property {number} height  pt
+ * @property {number} top     pt  上余白
+ * @property {number} right   pt
+ * @property {number} bottom  pt  下余白
+ * @property {number} left    pt
+ */
+
+/**
+ * @typedef {object} PageDecoration  ヘッダー／フッター（ページごとに描画済みの走査結果）
+ * @property {number} heightPx
+ * @property {(pageNumber: number, totalPages: number) => Promise<import('./walker/walk.js').WalkResult>} render
+ */
+
+/**
+ * @param {import('./index.js').PageOptions|undefined} page
+ * @returns {PageGeometry}
+ */
+export function resolvePage(page = {}) {
+  const sizeOpt = page.size ?? 'A4';
+  let width;
+  let height;
+  if (typeof sizeOpt === 'string') {
+    const s = PAGE_SIZES[sizeOpt];
+    if (!s) throw new Error(`Unknown page size "${sizeOpt}". Use one of ${Object.keys(PAGE_SIZES).join(', ')} or {width, height}.`);
+    width = s.width;
+    height = s.height;
+  } else {
+    width = lengthToPt(sizeOpt.width);
+    height = lengthToPt(sizeOpt.height);
+  }
+  if ((page.orientation ?? 'portrait') === 'landscape' && width < height) [width, height] = [height, width];
+
+  const m = page.margin ?? '15mm';
+  const margins =
+    typeof m === 'string'
+      ? { top: lengthToPt(m), right: lengthToPt(m), bottom: lengthToPt(m), left: lengthToPt(m) }
+      : { top: lengthToPt(m.top), right: lengthToPt(m.right), bottom: lengthToPt(m.bottom), left: lengthToPt(m.left) };
+  return { width, height, ...margins };
+}
+
+/**
+ * @param {import('./walker/walk.js').WalkResult} body
+ * @param {PageGeometry} geo
+ * @param {{compress: boolean, metadata?: import('./index.js').PdfMetadata, header?: PageDecoration|null, footer?: PageDecoration|null}} opts
+ * @returns {Promise<Uint8Array>}
+ */
+export async function buildPdf(body, geo, opts) {
+  const writer = new PdfWriter({ compress: opts.compress });
+  const headerPt = (opts.header?.heightPx ?? 0) * PX_TO_PT;
+  const footerPt = (opts.footer?.heightPx ?? 0) * PX_TO_PT;
+  const contentW = geo.width - geo.left - geo.right;
+  const contentTop = geo.height - geo.top - headerPt; // 本文領域の上端（PDF 座標）
+  const contentH = geo.height - geo.top - geo.bottom - headerPt - footerPt;
+  if (contentH <= 0) throw new Error('Page content area is empty: margins + header + footer exceed the page height');
+  const contentHpx = contentH / PX_TO_PT;
+
+  // 1. ページ範囲を決める
+  const ranges = paginate(body, contentHpx);
+  const totalPages = ranges.length;
+
+  // 2. ヘッダー／フッターをページごとに描画して走査結果を得る
+  /** @type {(import('./walker/walk.js').WalkResult|null)[]} */
+  const headers = [];
+  /** @type {(import('./walker/walk.js').WalkResult|null)[]} */
+  const footers = [];
+  for (let p = 0; p < totalPages; p++) {
+    headers.push(opts.header ? await opts.header.render(p + 1, totalPages) : null);
+    footers.push(opts.footer ? await opts.footer.render(p + 1, totalPages) : null);
+  }
+
+  // 3. フォント・画像の使用を集める
+  /** @type {Map<import('./font/registry.js').RegisteredFont, EmbeddedFont>} */
+  const fonts = new Map();
+  /** @type {Map<string, {name: string, image: import('./walker/image.js').DecodedImage}>} */
+  const images = new Map();
+  const collect = (/** @type {import('./walker/walk.js').DisplayItem[]} */ list) => {
+    for (const it of list) {
+      if (it.type === 'text') {
+        let ef = fonts.get(it.font);
+        if (!ef) {
+          ef = new EmbeddedFont(it.font.parsed, `F${fonts.size + 1}`);
+          fonts.set(it.font, ef);
+        }
+        for (const g of it.glyphs) ef.addGlyph(g.gid, g.cp);
+      } else if (it.type === 'image') {
+        if (!images.has(it.image.key)) images.set(it.image.key, { name: `Im${images.size + 1}`, image: it.image });
+      } else if (it.type === 'group' || it.type === 'clip') {
+        collect(it.items);
+      }
+    }
+  };
+  collect(body.items);
+  for (const w of [...headers, ...footers]) if (w) collect(w.items);
+  for (const ef of fonts.values()) ef.finalize();
+
+  /** @type {{[key: string]: import('./pdf/writer.js').PdfValue}} */
+  const fontDict = {};
+  for (const ef of fonts.values()) fontDict[ef.resourceName] = await ef.embed(writer);
+  /** @type {{[key: string]: import('./pdf/writer.js').PdfValue}} */
+  const xobjDict = {};
+  for (const im of images.values()) xobjDict[im.name] = await embedImage(writer, im.image);
+
+  // ExtGState（透明度）
+  /** @type {Map<string, string>} */
+  const gstates = new Map();
+  /** @type {{[key: string]: import('./pdf/writer.js').PdfValue}} */
+  const gstateDict = {};
+  const gsName = (/** @type {number} */ a) => {
+    const key = num(a);
+    let name = gstates.get(key);
+    if (!name) {
+      name = `GS${gstates.size + 1}`;
+      gstates.set(key, name);
+      gstateDict[name] = writer.add({ Type: 'ExtGState', ca: a, CA: a });
+    }
+    return name;
+  };
+
+  const pagesRef = writer.reserve();
+  /** @type {import('./pdf/writer.js').Ref[]} */
+  const pageRefs = [];
+
+  // 4. ページごとに描画
+  for (let p = 0; p < totalPages; p++) {
+    const range = /** @type {import('./paginate.js').PageRange} */ (ranges[p]);
+    const cs = new ContentStream();
+    const painter = new Painter(cs, geo, fonts, images, gsName);
+
+    // 本文: ドキュメント y = range.start が本文領域の上端 + 繰り返し thead の高さ に来る
+    const bodyShiftPt = range.headShift * PX_TO_PT;
+    const footShiftPt = range.footShift * PX_TO_PT;
+    cs.save();
+    cs.rect(geo.left, contentTop - contentH + footShiftPt, contentW, contentH - bodyShiftPt - footShiftPt).clip();
+    painter.setOrigin(contentTop - bodyShiftPt, range.start);
+    painter.render(body.items, range);
+    cs.restore();
+
+    // 繰り返し tfoot: ブラウザの印刷と同じく、このページに載った最後の行の直下に置く
+    const bodyEndPt = contentTop - bodyShiftPt - (range.end - range.start) * PX_TO_PT;
+    for (const f of range.feet) {
+      const fPt = (f.table.footBottom - f.table.footTop) * PX_TO_PT;
+      const bottomPt = bodyEndPt - f.shift * PX_TO_PT - fPt;
+      cs.save();
+      cs.rect(geo.left, bottomPt, contentW, fPt).clip();
+      painter.setOrigin(bottomPt + fPt, f.table.footTop);
+      painter.render(f.table.footItems);
+      cs.restore();
+    }
+
+    // 繰り返し thead
+    for (const h of range.heads) {
+      cs.save();
+      const hPt = (h.table.headBottom - h.table.headTop) * PX_TO_PT;
+      cs.rect(geo.left, contentTop - h.shift * PX_TO_PT - hPt, contentW, hPt).clip();
+      painter.setOrigin(contentTop - h.shift * PX_TO_PT, h.table.headTop);
+      painter.render(h.table.headItems);
+      cs.restore();
+    }
+
+    // ヘッダー／フッター
+    const header = headers[p];
+    if (header) {
+      cs.save();
+      cs.rect(geo.left, geo.height - geo.top - headerPt, contentW, headerPt).clip();
+      painter.setOrigin(geo.height - geo.top, 0);
+      painter.render(header.items);
+      cs.restore();
+    }
+    const footer = footers[p];
+    if (footer) {
+      cs.save();
+      cs.rect(geo.left, geo.bottom, contentW, footerPt).clip();
+      painter.setOrigin(geo.bottom + footerPt, 0);
+      painter.render(footer.items);
+      cs.restore();
+    }
+
+    const contentRef = await writer.addStream({}, cs.toBytes());
+    pageRefs.push(
+      writer.add({
+        Type: 'Page',
+        Parent: pagesRef,
+        MediaBox: [0, 0, geo.width, geo.height],
+        Resources: {
+          Font: fontDict,
+          XObject: xobjDict,
+          ExtGState: gstateDict,
+          ProcSet: [new Name('PDF'), new Name('Text'), new Name('ImageC')],
+        },
+        Contents: contentRef,
+      }),
+    );
+  }
+
+  writer.set(pagesRef, { Type: 'Pages', Kids: pageRefs, Count: pageRefs.length });
+  const catalog = writer.add({ Type: 'Catalog', Pages: pagesRef });
+
+  const md = opts.metadata ?? {};
+  /** @type {{[key: string]: import('./pdf/writer.js').PdfValue}} */
+  const info = {
+    Producer: pdfString('receipt-html-to-pdf'),
+    Creator: pdfString(md.creator ?? 'receipt-html-to-pdf'),
+    CreationDate: pdfDate(md.creationDate ?? new Date()),
+  };
+  if (md.title) info.Title = pdfString(md.title);
+  if (md.author) info.Author = pdfString(md.author);
+  if (md.subject) info.Subject = pdfString(md.subject);
+  if (md.keywords) info.Keywords = pdfString(md.keywords);
+  const infoRef = writer.add(info);
+
+  return writer.build(catalog, infoRef);
+}
+
+/**
+ * 命令がページ範囲 [start, end) に属するか。
+ * テキストは行が分割されない前提で行の中心位置で判定し（クリップで消えた文字が抽出テキストに残らないように）、
+ * 矩形・線・画像・グループは範囲と重なれば含める（見えない部分はクリップされる）。
+ * @param {import('./walker/walk.js').DisplayItem} it
+ * @param {{start: number, end: number}} range
+ */
+function inRange(it, range) {
+  const EPS = 0.01;
+  if (it.type === 'text') {
+    const mid = (it.top + it.bottom) / 2;
+    return mid >= range.start - EPS && mid < range.end - EPS;
+  }
+  return itemBottom(it) > range.start + EPS && itemTop(it) < range.end - EPS;
+}
+
+/**
+ * DisplayList を PDF コンテンツストリームへ描く。
+ * setOrigin() で「ドキュメント y = docY を PDF の y = pdfY に置く」対応を切り替える。
+ */
+class Painter {
+  /**
+   * @param {ContentStream} cs
+   * @param {PageGeometry} geo
+   * @param {Map<import('./font/registry.js').RegisteredFont, EmbeddedFont>} fonts
+   * @param {Map<string, {name: string, image: import('./walker/image.js').DecodedImage}>} images
+   * @param {(alpha: number) => string} gsName
+   */
+  constructor(cs, geo, fonts, images, gsName) {
+    this.cs = cs;
+    this.geo = geo;
+    this.fonts = fonts;
+    this.images = images;
+    this.gsName = gsName;
+    this.pdfTop = geo.height - geo.top;
+    this.docTop = 0;
+    this.curAlpha = 1;
+  }
+
+  /**
+   * @param {number} pdfY  PDF 座標（pt, 上向き）
+   * @param {number} docY  ドキュメント座標（px, 下向き）
+   */
+  setOrigin(pdfY, docY) {
+    this.pdfTop = pdfY;
+    this.docTop = docY;
+  }
+
+  /** @param {number} x */
+  X(x) {
+    return this.geo.left + x * PX_TO_PT;
+  }
+
+  /** @param {number} y */
+  Y(y) {
+    return this.pdfTop - (y - this.docTop) * PX_TO_PT;
+  }
+
+  /** @param {number} a */
+  setAlpha(a) {
+    if (Math.abs(a - this.curAlpha) < 0.001) return;
+    this.cs.setGState(this.gsName(a));
+    this.curAlpha = a;
+  }
+
+  /** @param {import('./walker/walk.js').Radius|undefined} r */
+  radiusPt(r) {
+    return /** @type {[number, number, number, number]} */ ((r ?? [0, 0, 0, 0]).map((v) => v * PX_TO_PT));
+  }
+
+  /** @param {import('./walker/walk.js').Box} b */
+  clipBox(b) {
+    const cs = this.cs;
+    if (b.radius) cs.roundedRect(this.X(b.x), this.Y(b.y + b.h), b.w * PX_TO_PT, b.h * PX_TO_PT, this.radiusPt(b.radius));
+    else cs.rect(this.X(b.x), this.Y(b.y + b.h), b.w * PX_TO_PT, b.h * PX_TO_PT);
+    cs.clip();
+  }
+
+  /**
+   * @param {import('./walker/walk.js').DisplayItem[]} list
+   * @param {{start: number, end: number}} [range]  指定するとこの範囲に属する命令だけを描く（子グループにも適用）
+   */
+  render(list, range) {
+    const cs = this.cs;
+    for (const it of list) {
+      if (range && !inRange(it, range)) continue;
+      if (it.type === 'rect') {
+        if (it.w <= 0 || it.h <= 0) continue;
+        cs.save();
+        this.setAlpha(it.color.a);
+        cs.fillColor(it.color.r, it.color.g, it.color.b);
+        if (it.radius) cs.roundedRect(this.X(it.x), this.Y(it.y + it.h), it.w * PX_TO_PT, it.h * PX_TO_PT, this.radiusPt(it.radius)).fill();
+        else cs.fillRect(this.X(it.x), this.Y(it.y + it.h), it.w * PX_TO_PT, it.h * PX_TO_PT);
+        cs.restore();
+        this.curAlpha = 1;
+      } else if (it.type === 'line') {
+        cs.save();
+        this.setAlpha(it.color.a);
+        cs.strokeColor(it.color.r, it.color.g, it.color.b);
+        cs.lineWidth(it.width * PX_TO_PT);
+        if (it.dash) cs.dash(it.dash.map((d) => d * PX_TO_PT));
+        cs.moveTo(this.X(it.x1), this.Y(it.y1)).lineTo(this.X(it.x2), this.Y(it.y2)).stroke();
+        cs.restore();
+        this.curAlpha = 1;
+      } else if (it.type === 'stroke-rrect') {
+        cs.save();
+        this.setAlpha(it.color.a);
+        cs.strokeColor(it.color.r, it.color.g, it.color.b);
+        cs.lineWidth(it.width * PX_TO_PT);
+        if (it.dash) cs.dash(it.dash.map((d) => d * PX_TO_PT));
+        cs.roundedRect(this.X(it.x), this.Y(it.y + it.h), it.w * PX_TO_PT, it.h * PX_TO_PT, this.radiusPt(it.radius)).stroke();
+        cs.restore();
+        this.curAlpha = 1;
+      } else if (it.type === 'image') {
+        const im = this.images.get(it.image.key);
+        if (!im || it.w <= 0 || it.h <= 0) continue;
+        cs.save();
+        this.setAlpha(it.alpha);
+        if (it.clip) this.clipBox(it.clip);
+        cs.image(im.name, this.X(it.x), this.Y(it.y + it.h), it.w * PX_TO_PT, it.h * PX_TO_PT);
+        cs.restore();
+        this.curAlpha = 1;
+      } else if (it.type === 'text') {
+        const ef = /** @type {EmbeddedFont} */ (this.fonts.get(it.font));
+        const tj = buildTJ(it, ef);
+        cs.save();
+        this.setAlpha(it.color.a);
+        cs.fillColor(it.color.r, it.color.g, it.color.b);
+        cs.text(ef.resourceName, it.size * PX_TO_PT, this.X(it.x), this.Y(it.y), tj);
+        cs.restore();
+        this.curAlpha = 1;
+      } else if (it.type === 'group') {
+        // CSS 行列 (a b c d e f) を、PDF 座標（y 反転・0.75 倍）で同じ変換になる行列に写す。
+        // 線形部は y 反転により b, c の符号が反転し、変換の中心 origin は不動点として残す。
+        const [a, b, c, d] = it.matrix;
+        const ox = this.X(it.origin.x);
+        const oy = this.Y(it.origin.y);
+        const a2 = a;
+        const b2 = -b;
+        const c2 = -c;
+        const d2 = d;
+        const e2 = ox - (a2 * ox + c2 * oy) + it.matrix[4] * PX_TO_PT;
+        const f2 = oy - (b2 * ox + d2 * oy) - it.matrix[5] * PX_TO_PT;
+        cs.save();
+        cs.transform(a2, b2, c2, d2, e2, f2);
+        this.render(it.items, range);
+        cs.restore();
+      } else if (it.type === 'clip') {
+        cs.save();
+        this.clipBox(it.box);
+        this.render(it.items, range);
+        cs.restore();
+      }
+    }
+  }
+}
+
+/**
+ * グリフ列を TJ 配列にする。
+ * 実測したペン位置と、フォントの advance から計算した位置との差を 1/1000 単位の調整値として挿入する。
+ * これによりカーニング・letter-spacing・両端揃えがそのまま再現される。
+ * @param {import('./walker/walk.js').TextItem} it
+ * @param {EmbeddedFont} ef
+ * @returns {Array<string|number>}
+ */
+function buildTJ(it, ef) {
+  /** @type {Array<string|number>} */
+  const out = [];
+  let hex = '';
+  for (let i = 0; i < it.glyphs.length; i++) {
+    const g = /** @type {import('./walker/walk.js').Glyph} */ (it.glyphs[i]);
+    hex += hex4(ef.cid(g.gid));
+    const next = it.glyphs[i + 1];
+    if (!next) break;
+    const expected = g.x + g.advance;
+    const gap = next.x - expected; // px
+    const adj = (-gap / it.size) * 1000; // 正の値で左へ寄る
+    if (Math.abs(adj) >= 0.5) {
+      out.push(hex, Math.round(adj * 10) / 10);
+      hex = '';
+    }
+  }
+  if (hex) out.push(hex);
+  return out;
+}
+
+/** @param {import('./walker/walk.js').DisplayItem} it */
+function itemTop(it) {
+  if (it.type === 'rect' || it.type === 'stroke-rrect' || it.type === 'image') return it.y;
+  if (it.type === 'line') return Math.min(it.y1, it.y2) - it.width / 2;
+  if (it.type === 'group' || it.type === 'clip') return it.top;
+  return it.top;
+}
+
+/** @param {import('./walker/walk.js').DisplayItem} it */
+function itemBottom(it) {
+  if (it.type === 'rect' || it.type === 'stroke-rrect' || it.type === 'image') return it.y + it.h;
+  if (it.type === 'line') return Math.max(it.y1, it.y2) + it.width / 2;
+  if (it.type === 'group' || it.type === 'clip') return it.bottom;
+  return it.bottom;
+}

package/src/paginate.js

@@ -0,0 +1,119 @@
+// @ts-check
+/**
+ * Paginator — 走査結果（アトム・強制改ページ・テーブル）から各ページの縦範囲を決める。
+ *
+ * 方針: 命令は動かさず、ページごとに「この y 範囲を描く」と決めるだけにする。
+ * 境界は、アトム（テキスト行・表の行・画像・break-inside: avoid）を跨がない位置まで上へ戻す。
+ * テーブルが次ページへ続くときは thead を各ページ先頭で繰り返し、その高さ分だけ本文を下げる。
+ */
+
+/**
+ * @typedef {object} RepeatedHead
+ * @property {import('./walker/walk.js').TableInfo} table
+ * @property {number} shift   このページで thead を描く位置（ページ先頭からの px オフセット）
+ *
+ * @typedef {object} PageRange
+ * @property {number} start   本文の描き始め y（ドキュメント px）
+ * @property {number} end     本文の描き終わり y（この値未満を描く）
+ * @property {RepeatedHead[]} heads  ページ先頭で繰り返す thead
+ * @property {number} headShift  繰り返し thead の合計高さ（本文はこの分だけ下がる）
+ * @property {RepeatedHead[]} feet   ページ末尾で繰り返す tfoot（表が次ページへ続くとき）
+ * @property {number} footShift  繰り返し tfoot の合計高さ（本文領域はこの分だけ縮む）
+ */
+
+/**
+ * @param {import('./walker/walk.js').WalkResult} walk
+ * @param {number} pageHeightPx  本文領域の高さ（px）
+ * @returns {PageRange[]}
+ */
+export function paginate(walk, pageHeightPx) {
+  const H = pageHeightPx;
+  const total = walk.height;
+  const atoms = [...walk.atoms].sort((a, b) => a.top - b.top);
+  const breaks = [...new Set(walk.breaks)].sort((a, b) => a - b);
+  const EPS = 0.01;
+
+  /** @type {PageRange[]} */
+  const pages = [];
+  let start = 0;
+  let guard = 0;
+  while (start < total - EPS && guard++ < 10000) {
+    // このページの先頭で繰り返す thead: ページ開始位置が表の途中にあり、thead が既に前ページで描かれている表
+    /** @type {RepeatedHead[]} */
+    const heads = [];
+    let headShift = 0;
+    for (const t of walk.tables) {
+      if (t.headItems.length && t.headBottom <= start + EPS && start < t.bottom - EPS) {
+        heads.push({ table: t, shift: headShift });
+        headShift += t.headBottom - t.headTop;
+      }
+    }
+    // tfoot の繰り返しは「このページで表が終わらない」ときだけ必要で、それは end に依存する。
+    // まず tfoot 無しで end を求め、繰り返しが必要な表があれば容量を減らして計算し直す（数回で収束する）。
+    /** @type {RepeatedHead[]} */
+    let feet = [];
+    let footShift = 0;
+    let end = start;
+    for (let pass = 0; pass < 4; pass++) {
+      const capacity = Math.max(H - headShift - footShift, H * 0.25); // thead/tfoot が異常に高い場合の下限
+      end = computeEnd(start, capacity);
+      /** @type {RepeatedHead[]} */
+      const needed = [];
+      let shift = 0;
+      for (const t of walk.tables) {
+        // 表がこのページの途中から始まる・または続いていて、かつこのページで終わらない（本来の tfoot が次ページ以降）
+        if (t.footItems.length && t.top < end - EPS && t.footTop >= end - EPS && t.bottom > end + EPS) {
+          needed.push({ table: t, shift });
+          shift += t.footBottom - t.footTop;
+        }
+      }
+      const same = needed.length === feet.length && needed.every((n, i) => n.table === feet[i]?.table);
+      feet = needed;
+      footShift = shift;
+      if (same) break;
+    }
+
+    pages.push({ start, end, heads, headShift, feet, footShift });
+    start = end;
+  }
+  if (!pages.length) pages.push({ start: 0, end: Math.max(total, 1), heads: [], headShift: 0, feet: [], footShift: 0 });
+  return pages;
+
+  /**
+   * start から容量 capacity のページの終端を、強制改ページとアトムを考慮して決める。
+   * @param {number} start
+   * @param {number} capacity
+   */
+  function computeEnd(start, capacity) {
+    let end = Math.min(start + capacity, total);
+
+    // 強制改ページ: (start, end) の中で最初のもの
+    for (const b of breaks) {
+      if (b > start + EPS && b < end - EPS) {
+        end = b;
+        break;
+      }
+    }
+
+    // アトムを跨がない位置まで境界を上げる（他のアトムに連鎖することがあるので繰り返す）
+    if (end < total - EPS) {
+      let moved = true;
+      let iter = 0;
+      while (moved && iter++ < 1000) {
+        moved = false;
+        for (const a of atoms) {
+          if (a.top >= end) break;
+          // ページ容量より大きいアトムはどこかで切らざるを得ないので無視する
+          if (a.bottom - a.top > capacity) continue;
+          if (a.top < end - EPS && a.bottom > end + EPS && a.top > start + EPS) {
+            end = a.top;
+            moved = true;
+          }
+        }
+      }
+      // 上げ過ぎて空ページになる場合（ページより大きいアトム）は容量いっぱいで切る
+      if (end <= start + EPS) end = Math.min(start + capacity, total);
+    }
+    return end;
+  }
+}

package/src/pdf/compress.js

@@ -0,0 +1,30 @@
+// @ts-check
+/**
+ * Web 標準 CompressionStream による zlib (FlateDecode) 圧縮。
+ * 未対応環境では null を返し、呼び出し側は無圧縮で出力する。
+ */
+
+/**
+ * @returns {boolean}
+ */
+export function canCompress() {
+  return typeof CompressionStream === 'function';
+}
+
+/**
+ * @param {Uint8Array} bytes
+ * @returns {Promise<Uint8Array|null>} zlib 形式（PDF の FlateDecode が期待する形式）
+ */
+export async function deflate(bytes) {
+  if (!canCompress()) return null;
+  try {
+    const cs = new CompressionStream('deflate');
+    const writer = cs.writable.getWriter();
+    void writer.write(/** @type {Uint8Array<ArrayBuffer>} */ (bytes));
+    void writer.close();
+    const buf = await new Response(cs.readable).arrayBuffer();
+    return new Uint8Array(buf);
+  } catch {
+    return null;
+  }
+}