@hidemikimura/receipt-html-to-pdf 0.1.0

package/types/font/cid.d.ts

@@ -0,0 +1,40 @@
+/** @param {number} n */
+export function hex4(n: number): string;
+/**
+ * PDF に埋め込む 1 フォント分の使用状況。
+ * 走査中に addGlyph でグリフを集め、最後に embed で PDF オブジェクトを生成する。
+ */
+export class EmbeddedFont {
+    /**
+     * @param {import('./parse.js').ParsedFont} font
+     * @param {string} resourceName ページリソース名（F1 など）
+     */
+    constructor(font: import("./parse.js").ParsedFont, resourceName: string);
+    font: import("./parse.js").ParsedFont;
+    resourceName: string;
+    /** @type {Map<number, number>} 旧 GID → 代表コードポイント（ToUnicode 用） */
+    usedGids: Map<number, number>;
+    /** @type {import('./subset.js').SubsetResult|null} */
+    subset: import("./subset.js").SubsetResult | null;
+    /**
+     * @param {number} gid 旧 GID
+     * @param {number} codePoint
+     */
+    addGlyph(gid: number, codePoint: number): void;
+    /**
+     * 旧 GID を PDF 上の CID（サブセット後 GID）へ変換する。embed 後にのみ有効。
+     * @param {number} gid
+     * @returns {number}
+     */
+    cid(gid: number): number;
+    /**
+     * サブセット化を確定させる。以後 cid() が使える。
+     */
+    finalize(): import("./subset.js").SubsetResult;
+    /**
+     * PDF オブジェクト群を書き込み、Type0 フォント辞書への参照を返す。
+     * @param {import('../pdf/writer.js').PdfWriter} writer
+     * @returns {Promise<import('../pdf/writer.js').Ref>}
+     */
+    embed(writer: import("../pdf/writer.js").PdfWriter): Promise<import("../pdf/writer.js").Ref>;
+}

package/types/font/parse.d.ts

@@ -0,0 +1,113 @@
+/**
+ * TrueType (sfnt / glyf アウトライン) フォントの最小パーサー。
+ * サブセット化と PDF 埋め込みに必要なテーブルだけを読む。
+ */
+/**
+ * @typedef {object} ParsedFont
+ * @property {Uint8Array} data
+ * @property {Map<string, {offset: number, length: number}>} tables
+ * @property {number} unitsPerEm
+ * @property {number} indexToLocFormat
+ * @property {[number, number, number, number]} bbox  xMin yMin xMax yMax (font units)
+ * @property {number} ascender       hhea
+ * @property {number} descender      hhea（負値）
+ * @property {number} lineGap
+ * @property {number} numGlyphs
+ * @property {Uint16Array} advances  グリフごとの advance width (font units)
+ * @property {Uint32Array} loca      numGlyphs + 1 要素
+ * @property {Map<number, number>} cmap  コードポイント → GID
+ * @property {number} capHeight      OS/2 sCapHeight（なければ ascender * 0.7）
+ * @property {number} italicAngle
+ * @property {boolean} useTypoMetrics OS/2 fsSelection bit 7
+ * @property {number} typoAscender
+ * @property {number} typoDescender
+ * @property {number} winAscent
+ * @property {number} winDescent
+ * @property {string} postScriptName
+ * @property {boolean} bold
+ * @property {boolean} italic
+ * @property {boolean} variable  fvar テーブルを持つ可変フォントか
+ */
+/**
+ * @param {ArrayBuffer|Uint8Array} buffer
+ * @returns {ParsedFont}
+ */
+export function parseFont(buffer: ArrayBuffer | Uint8Array): ParsedFont;
+/**
+ * グリフの生バイト列を返す（空グリフは長さ 0）。
+ * @param {ParsedFont} font
+ * @param {number} gid
+ * @returns {Uint8Array}
+ */
+export function glyphData(font: ParsedFont, gid: number): Uint8Array;
+/**
+ * 複合グリフが参照するコンポーネント GID を返す（単純グリフなら空）。
+ * @param {Uint8Array} g
+ * @returns {number[]}
+ */
+export function componentGids(g: Uint8Array): number[];
+/**
+ * ブラウザが行ボックス計算に使うアセント／ディセントに近い値（font units）を返す。
+ * Chrome/Firefox は OS/2 USE_TYPO_METRICS が立っていれば typo、そうでなければ hhea を使う。
+ * @param {ParsedFont} font
+ * @returns {{ascent: number, descent: number}} descent は正値
+ */
+export function browserMetrics(font: ParsedFont): {
+    ascent: number;
+    descent: number;
+};
+export type ParsedFont = {
+    data: Uint8Array;
+    tables: Map<string, {
+        offset: number;
+        length: number;
+    }>;
+    unitsPerEm: number;
+    indexToLocFormat: number;
+    /**
+     * xMin yMin xMax yMax (font units)
+     */
+    bbox: [number, number, number, number];
+    /**
+     * hhea
+     */
+    ascender: number;
+    /**
+     * hhea（負値）
+     */
+    descender: number;
+    lineGap: number;
+    numGlyphs: number;
+    /**
+     * グリフごとの advance width (font units)
+     */
+    advances: Uint16Array;
+    /**
+     * numGlyphs + 1 要素
+     */
+    loca: Uint32Array;
+    /**
+     * コードポイント → GID
+     */
+    cmap: Map<number, number>;
+    /**
+     * OS/2 sCapHeight（なければ ascender * 0.7）
+     */
+    capHeight: number;
+    italicAngle: number;
+    /**
+     * OS/2 fsSelection bit 7
+     */
+    useTypoMetrics: boolean;
+    typoAscender: number;
+    typoDescender: number;
+    winAscent: number;
+    winDescent: number;
+    postScriptName: string;
+    bold: boolean;
+    italic: boolean;
+    /**
+     * fvar テーブルを持つ可変フォントか
+     */
+    variable: boolean;
+};

package/types/font/registry.d.ts

@@ -0,0 +1,63 @@
+/**
+ * @param {string} family
+ * @returns {string}
+ */
+export function normalizeFamily(family: string): string;
+/**
+ * getComputedStyle().fontFamily（'"BIZ UDPGothic", sans-serif'）をリストに分割する。
+ * @param {string} value
+ * @returns {string[]}
+ */
+export function splitFamilies(value: string): string[];
+/**
+ * getComputedStyle().fontWeight（'400' / '700' / 'bold'）を数値にする。
+ * @param {string} value
+ * @returns {number}
+ */
+export function parseWeight(value: string): number;
+/**
+ * @typedef {object} RegisteredFont
+ * @property {string} family      正規化済み（小文字・引用符なし）
+ * @property {string} displayFamily
+ * @property {number} weight
+ * @property {'normal'|'italic'} style
+ * @property {import('./parse.js').ParsedFont} parsed
+ */
+export class FontRegistry {
+    /** @type {RegisteredFont[]} */
+    fonts: RegisteredFont[];
+    /**
+     * @param {import('../index.js').FontSource} source
+     * @returns {Promise<RegisteredFont>}
+     */
+    register(source: import("../index.js").FontSource): Promise<RegisteredFont>;
+    /** @param {string} family */
+    hasFamily(family: string): boolean;
+    /**
+     * CSS の指定に最も近い登録フォントを返す。
+     * @param {string[]} families   font-family リスト（優先順）
+     * @param {number} weight
+     * @param {'normal'|'italic'} style
+     * @param {number} [codePoint]  指定するとこの文字のグリフを持つフォントに限定する
+     * @returns {RegisteredFont|null}
+     */
+    match(families: string[], weight: number, style: "normal" | "italic", codePoint?: number): RegisteredFont | null;
+    /**
+     * 登録済みの全ファミリーの中から、指定文字のグリフを持つものを探す（最終フォールバック）。
+     * @param {number} codePoint
+     * @param {number} weight
+     * @param {'normal'|'italic'} style
+     * @returns {RegisteredFont|null}
+     */
+    anyWithGlyph(codePoint: number, weight: number, style: "normal" | "italic"): RegisteredFont | null;
+}
+export type RegisteredFont = {
+    /**
+     * 正規化済み（小文字・引用符なし）
+     */
+    family: string;
+    displayFamily: string;
+    weight: number;
+    style: "normal" | "italic";
+    parsed: import("./parse.js").ParsedFont;
+};

package/types/font/subset.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @typedef {object} SubsetResult
+ * @property {Uint8Array} data          サブセット化されたフォントファイル
+ * @property {Map<number, number>} gidMap  旧 GID → 新 GID
+ * @property {number[]} oldGids         新 GID 順に並んだ旧 GID
+ */
+/**
+ * @param {import('./parse.js').ParsedFont} font
+ * @param {Iterable<number>} usedGids
+ * @returns {SubsetResult}
+ */
+export function subsetFont(font: import("./parse.js").ParsedFont, usedGids: Iterable<number>): SubsetResult;
+export type SubsetResult = {
+    /**
+     * サブセット化されたフォントファイル
+     */
+    data: Uint8Array;
+    /**
+     * 旧 GID → 新 GID
+     */
+    gidMap: Map<number, number>;
+    /**
+     * 新 GID 順に並んだ旧 GID
+     */
+    oldGids: number[];
+};

package/types/index.d.ts

@@ -0,0 +1,198 @@
+/**
+ * フォントを登録する。同じ family/weight/style を再登録した場合は上書きする。
+ * パース結果はモジュール内にキャッシュされ、以降の htmlToPdf 呼び出しで再利用される。
+ *
+ * @param {FontSource} font
+ * @returns {Promise<void>}
+ */
+export function registerFont(font: FontSource): Promise<void>;
+/**
+ * 登録済みフォントの一覧（デバッグ用）。
+ * @returns {{family: string, weight: number, style: string, glyphs: number}[]}
+ */
+export function listFonts(): {
+    family: string;
+    weight: number;
+    style: string;
+    glyphs: number;
+}[];
+/**
+ * HTML を PDF に変換する。
+ *
+ * @param {ConvertInput} input
+ * @param {ConvertOptions} [options]
+ * @returns {Promise<Blob|Uint8Array|string>} options.output に応じた PDF
+ */
+export function htmlToPdf(input: ConvertInput, options?: ConvertOptions): Promise<Blob | Uint8Array | string>;
+/**
+ * 生成した PDF をブラウザでダウンロードさせる補助関数。
+ *
+ * @param {Blob|Uint8Array} pdf
+ * @param {string} filename
+ * @returns {void}
+ */
+export function downloadPdf(pdf: Blob | Uint8Array, filename: string): void;
+export { expandPrintMediaCss } from "./renderer.js";
+/**
+ * 登録するフォントの定義。
+ * `src` は TrueType アウトライン（glyf）を持つ静的 TTF のみ対応。
+ *
+ * @typedef {object} FontSource
+ * @property {string} family        CSS の font-family と一致させる名前
+ * @property {number} [weight=400]  100〜900
+ * @property {'normal'|'italic'} [style='normal']
+ * @property {string|ArrayBuffer|Uint8Array} src  URL または フォントファイルのバイト列
+ */
+/**
+ * 用紙サイズ。既定名か、幅・高さを CSS 長さ（'80mm' など）で指定する。
+ *
+ * @typedef {'A3'|'A4'|'A5'|'B4'|'B5'|'Letter'|'Legal'|{width: string, height: string}} PageSize
+ */
+/**
+ * @typedef {object} PageOptions
+ * @property {PageSize} [size='A4']
+ * @property {'portrait'|'landscape'} [orientation='portrait']
+ * @property {string|{top: string, right: string, bottom: string, left: string}} [margin='15mm']
+ */
+/**
+ * @typedef {object} PdfMetadata
+ * @property {string} [title]
+ * @property {string} [author]
+ * @property {string} [subject]
+ * @property {string} [keywords]
+ * @property {string} [creator]
+ * @property {Date}   [creationDate]
+ */
+/**
+ * 変換中に発生した非致命的な問題。例外にはせず onWarning に流す。
+ *
+ * @typedef {object} ConversionWarning
+ * @property {'unsupported-css'|'missing-font'|'missing-glyph'|'image-failed'|'other'} code
+ * @property {string} message
+ * @property {Element} [element]
+ * @property {string} [property]   unsupported-css のときの CSS プロパティ名
+ * @property {string} [text]       missing-glyph のときの該当文字
+ */
+/**
+ * @typedef {object} ConvertOptions
+ * @property {PageOptions} [page]
+ * @property {string[]} [fontFallback]           未登録ファミリーが要求されたときに試す family の順序
+ * @property {'inherit'|'none'|string[]} [stylesheets='inherit']  親文書のスタイルを継承するか、URL/CSS テキストを明示するか
+ * @property {boolean} [mediaPrint=false]        `@media print` ルールを通常ルールとして適用する
+ * @property {boolean} [compress=true]           CompressionStream が使えれば FlateDecode を適用する
+ * @property {PdfMetadata} [metadata]
+ * @property {string|null} [header=null]         各ページ上部の HTML テンプレート。{{pageNumber}} {{totalPages}} を置換する
+ * @property {string|null} [footer=null]         各ページ下部の HTML テンプレート。同上
+ * @property {'font'|'measure'|'auto'} [textMeasure='auto']  グリフ位置の決め方（現在は常に実測）
+ * @property {'blob'|'uint8array'|'dataurl'} [output='blob']
+ * @property {string} [baseUrl]                  相対 URL（フォント・画像）の基準。既定は現在の文書
+ * @property {(warning: ConversionWarning) => void} [onWarning]
+ */
+/**
+ * 変換の入力。DOM 要素、または HTML 文字列。
+ * @typedef {Element|string} ConvertInput
+ */
+/** ライブラリのバージョン（package.json と同期） */
+export const version: "0.1.0";
+/**
+ * 登録するフォントの定義。
+ * `src` は TrueType アウトライン（glyf）を持つ静的 TTF のみ対応。
+ */
+export type FontSource = {
+    /**
+     * CSS の font-family と一致させる名前
+     */
+    family: string;
+    /**
+     * 100〜900
+     */
+    weight?: number | undefined;
+    style?: "normal" | "italic" | undefined;
+    /**
+     * URL または フォントファイルのバイト列
+     */
+    src: string | ArrayBuffer | Uint8Array;
+};
+/**
+ * 用紙サイズ。既定名か、幅・高さを CSS 長さ（'80mm' など）で指定する。
+ */
+export type PageSize = "A3" | "A4" | "A5" | "B4" | "B5" | "Letter" | "Legal" | {
+    width: string;
+    height: string;
+};
+export type PageOptions = {
+    size?: PageSize | undefined;
+    orientation?: "portrait" | "landscape" | undefined;
+    margin?: string | {
+        top: string;
+        right: string;
+        bottom: string;
+        left: string;
+    } | undefined;
+};
+export type PdfMetadata = {
+    title?: string | undefined;
+    author?: string | undefined;
+    subject?: string | undefined;
+    keywords?: string | undefined;
+    creator?: string | undefined;
+    creationDate?: Date | undefined;
+};
+/**
+ * 変換中に発生した非致命的な問題。例外にはせず onWarning に流す。
+ */
+export type ConversionWarning = {
+    code: "unsupported-css" | "missing-font" | "missing-glyph" | "image-failed" | "other";
+    message: string;
+    element?: Element | undefined;
+    /**
+     * unsupported-css のときの CSS プロパティ名
+     */
+    property?: string | undefined;
+    /**
+     * missing-glyph のときの該当文字
+     */
+    text?: string | undefined;
+};
+export type ConvertOptions = {
+    page?: PageOptions | undefined;
+    /**
+     * 未登録ファミリーが要求されたときに試す family の順序
+     */
+    fontFallback?: string[] | undefined;
+    /**
+     * 親文書のスタイルを継承するか、URL/CSS テキストを明示するか
+     */
+    stylesheets?: string[] | "inherit" | "none" | undefined;
+    /**
+     * `@media print` ルールを通常ルールとして適用する
+     */
+    mediaPrint?: boolean | undefined;
+    /**
+     * CompressionStream が使えれば FlateDecode を適用する
+     */
+    compress?: boolean | undefined;
+    metadata?: PdfMetadata | undefined;
+    /**
+     * 各ページ上部の HTML テンプレート。{{pageNumber}} {{totalPages}} を置換する
+     */
+    header?: string | null | undefined;
+    /**
+     * 各ページ下部の HTML テンプレート。同上
+     */
+    footer?: string | null | undefined;
+    /**
+     * グリフ位置の決め方（現在は常に実測）
+     */
+    textMeasure?: "font" | "measure" | "auto" | undefined;
+    output?: "blob" | "uint8array" | "dataurl" | undefined;
+    /**
+     * 相対 URL（フォント・画像）の基準。既定は現在の文書
+     */
+    baseUrl?: string | undefined;
+    onWarning?: ((warning: ConversionWarning) => void) | undefined;
+};
+/**
+ * 変換の入力。DOM 要素、または HTML 文字列。
+ */
+export type ConvertInput = Element | string;

package/types/page.d.ts

@@ -0,0 +1,64 @@
+/**
+ * @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?: import("./index.js").PageOptions | undefined): PageGeometry;
+/**
+ * @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 function buildPdf(body: import("./walker/walk.js").WalkResult, geo: PageGeometry, opts: {
+    compress: boolean;
+    metadata?: import("./index.js").PdfMetadata;
+    header?: PageDecoration | null;
+    footer?: PageDecoration | null;
+}): Promise<Uint8Array>;
+export type PageGeometry = {
+    /**
+     * pt
+     */
+    width: number;
+    /**
+     * pt
+     */
+    height: number;
+    /**
+     * pt  上余白
+     */
+    top: number;
+    /**
+     * pt
+     */
+    right: number;
+    /**
+     * pt  下余白
+     */
+    bottom: number;
+    /**
+     * pt
+     */
+    left: number;
+};
+/**
+ * ヘッダー／フッター（ページごとに描画済みの走査結果）
+ */
+export type PageDecoration = {
+    heightPx: number;
+    render: (pageNumber: number, totalPages: number) => Promise<import("./walker/walk.js").WalkResult>;
+};

package/types/paginate.d.ts

@@ -0,0 +1,59 @@
+/**
+ * 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: import("./walker/walk.js").WalkResult, pageHeightPx: number): PageRange[];
+export type RepeatedHead = {
+    table: import("./walker/walk.js").TableInfo;
+    /**
+     * このページで thead を描く位置（ページ先頭からの px オフセット）
+     */
+    shift: number;
+};
+export type PageRange = {
+    /**
+     * 本文の描き始め y（ドキュメント px）
+     */
+    start: number;
+    /**
+     * 本文の描き終わり y（この値未満を描く）
+     */
+    end: number;
+    /**
+     * ページ先頭で繰り返す thead
+     */
+    heads: RepeatedHead[];
+    /**
+     * 繰り返し thead の合計高さ（本文はこの分だけ下がる）
+     */
+    headShift: number;
+    /**
+     * ページ末尾で繰り返す tfoot（表が次ページへ続くとき）
+     */
+    feet: RepeatedHead[];
+    /**
+     * 繰り返し tfoot の合計高さ（本文領域はこの分だけ縮む）
+     */
+    footShift: number;
+};

package/types/pdf/compress.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Web 標準 CompressionStream による zlib (FlateDecode) 圧縮。
+ * 未対応環境では null を返し、呼び出し側は無圧縮で出力する。
+ */
+/**
+ * @returns {boolean}
+ */
+export function canCompress(): boolean;
+/**
+ * @param {Uint8Array} bytes
+ * @returns {Promise<Uint8Array|null>} zlib 形式（PDF の FlateDecode が期待する形式）
+ */
+export function deflate(bytes: Uint8Array): Promise<Uint8Array | null>;

package/types/pdf/content.d.ts

@@ -0,0 +1,65 @@
+export class ContentStream {
+    /** @type {string[]} */
+    ops: string[];
+    depth: number;
+    save(): this;
+    restore(): this;
+    /** @param {number} a @param {number} b @param {number} c @param {number} d @param {number} e @param {number} f */
+    transform(a: number, b: number, c: number, d: number, e: number, f: number): this;
+    /** @param {string} gsName ExtGState リソース名 */
+    setGState(gsName: string): this;
+    /** @param {number} r @param {number} g @param {number} b */
+    fillColor(r: number, g: number, b: number): this;
+    /** @param {number} r @param {number} g @param {number} b */
+    strokeColor(r: number, g: number, b: number): this;
+    /** @param {number} w */
+    lineWidth(w: number): this;
+    /** @param {number[]} pattern @param {number} [phase] */
+    dash(pattern: number[], phase?: number): this;
+    /** @param {0|1|2} cap */
+    lineCap(cap: 0 | 1 | 2): this;
+    /** @param {number} x @param {number} y @param {number} w @param {number} h */
+    rect(x: number, y: number, w: number, h: number): this;
+    /** @param {number} x @param {number} y */
+    moveTo(x: number, y: number): this;
+    /** @param {number} x @param {number} y */
+    lineTo(x: number, y: number): this;
+    /**
+     * 3 次ベジェ曲線
+     * @param {number} x1 @param {number} y1 @param {number} x2 @param {number} y2 @param {number} x3 @param {number} y3
+     */
+    curveTo(x1: number, y1: number, x2: number, y2: number, x3: number, y3: number): this;
+    closePath(): 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: number, y: number, w: number, h: number, r: [number, number, number, number]): this;
+    /**
+     * 画像 XObject を (x, y) を左下として w×h で描く。
+     * @param {string} name @param {number} x @param {number} y @param {number} w @param {number} h
+     */
+    image(name: string, x: number, y: number, w: number, h: number): this;
+    fill(): this;
+    stroke(): this;
+    /** 現在のパスでクリップして新しいパスを開始する */
+    clip(): this;
+    /** @param {number} x @param {number} y @param {number} w @param {number} h */
+    fillRect(x: number, y: number, w: number, h: number): this;
+    /**
+     * テキストを描画する。
+     * @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: string, size: number, x: number, y: number, tj: Array<string | number>, opts?: {
+        charSpacing?: number;
+        rise?: number;
+    }): this;
+    /** @returns {Uint8Array} */
+    toBytes(): Uint8Array;
+}

package/types/pdf/image.d.ts

@@ -0,0 +1,9 @@
+/**
+ * デコード済み画像を 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 function embedImage(writer: import("../pdf/writer.js").PdfWriter, img: import("../walker/image.js").DecodedImage): Promise<import("../pdf/writer.js").Ref>;