@hidemikimura/receipt-html-to-pdf 0.2.0 → 0.3.0

package/types/walker/image.d.ts

@@ -47,6 +47,42 @@ export function fitImage(box: {
  * @returns {string}
  */
 export function objectFitToSize(fit: string): string;
+/**
+ * `background-repeat` の computed 値を軸ごとに分ける。
+ * `repeat-x` / `repeat-y` は 2 値表記に展開する。
+ * @param {string} value
+ * @returns {['repeat'|'no-repeat'|'space'|'round', 'repeat'|'no-repeat'|'space'|'round']}
+ */
+export function splitRepeat(value: string): ["repeat" | "no-repeat" | "space" | "round", "repeat" | "no-repeat" | "space" | "round"];
+/**
+ * 1 軸ぶんのタイル位置を求める。
+ *
+ * - `repeat`: 指定位置を基準に、描画領域を覆うまで両方向へ並べる
+ * - `no-repeat`: 指定位置に 1 枚
+ * - `round`: 描画領域に整数個収まるようタイルの大きさを調整して並べる（大きさが変わる）
+ * - `space`: 整数個を等間隔に置き、余りを隙間に配る。1 枚しか入らないなら先頭に 1 枚
+ *
+ * @param {'repeat'|'no-repeat'|'space'|'round'} mode
+ * @param {number} start      指定位置（background-position の結果）
+ * @param {number} size       タイルの大きさ
+ * @param {number} areaStart  描画領域の開始
+ * @param {number} areaEnd    描画領域の終わり
+ * @returns {{positions: number[], size: number}}
+ */
+export function tileAxis(mode: "repeat" | "no-repeat" | "space" | "round", start: number, size: number, areaStart: number, areaEnd: number): {
+    positions: number[];
+    size: number;
+};
+/**
+ * 埋め込みが済んだ画像のピクセルデータを手放す。
+ * デコード結果（RGB・アルファ・JPEG のバイト列）は元画像より桁違いに大きいので、
+ * PDF に書き出したあとも抱えていると大きな文書でピーク使用量が跳ね上がる。
+ *
+ * キャッシュからも外すので、次の変換では読み直しになる（速度よりメモリを優先する）。
+ *
+ * @param {DecodedImage} img
+ */
+export function releasePixels(img: DecodedImage): void;
 export type DecodedImage = {
     /**
      * 重複排除キー（URL）

package/types/walker/svg-path.d.ts

@@ -0,0 +1,31 @@
+/**
+ * SVG のパスデータと基本図形を、PDF に出せる形（絶対座標の M / L / C / Z）へ正規化する。
+ *
+ * 円弧（A）は 3 次ベジェへ、二次ベジェ（Q / T）も 3 次へ変換する。
+ * 座標は要素のユーザー単位のまま（変換行列は描画時に cm で適用する）。
+ */
+/**
+ * @typedef {['M', number, number]|['L', number, number]|['C', number, number, number, number, number, number]|['Z']} PathSeg
+ */
+/**
+ * `d` 属性を絶対座標の M / L / C / Z 列にする。
+ * @param {string} d
+ * @returns {PathSeg[]}
+ */
+export function parsePathData(d: string): PathSeg[];
+/**
+ * 楕円円弧を 3 次ベジェ列にする（SVG 仕様 F.6 の実装）。
+ * @param {number} x1 @param {number} y1 @param {number} x2 @param {number} y2
+ * @param {number} rx @param {number} ry @param {number} rotDeg
+ * @param {boolean} large @param {boolean} sweep
+ * @returns {PathSeg[]}
+ */
+export function arcToCurves(x1: number, y1: number, x2: number, y2: number, rx: number, ry: number, rotDeg: number, large: boolean, sweep: boolean): PathSeg[];
+/**
+ * 基本図形をパスにする。対応しない要素は null。
+ * @param {Element} el
+ * @param {(name: string) => string} attr  属性値（プレゼンテーション属性は computed style を優先しない純粋な幾何属性）
+ * @returns {PathSeg[]|null}
+ */
+export function shapeToPath(el: Element, attr: (name: string) => string): PathSeg[] | null;
+export type PathSeg = ["M", number, number] | ["L", number, number] | ["C", number, number, number, number, number, number] | ["Z"];

package/types/walker/text.d.ts

@@ -33,6 +33,10 @@ export type MeasureOptions = {
      */
     size: number;
     textMeasure: "font" | "measure" | "auto";
+    /**
+     * ブラウザが有効にしている OpenType 機能タグ（GSUB の単一置換を再現する）
+     */
+    features: string[];
     warn: (w: import("../index.js").ConversionWarning) => void;
     element: Element;
 };

package/types/walker/walk.d.ts

@@ -117,7 +117,43 @@ export type ClipItem = {
     z: number;
     seq: number;
 };
-export type DisplayItem = RectItem | LineItem | StrokeRRectItem | ImageItem | TextItem | GroupItem | ClipItem;
+/**
+ * linear-gradient（box はグラデーションの基準領域、clip は描画範囲）
+ */
+export type GradientItem = {
+    type: "gradient";
+    box: Box;
+    clip: Box;
+    gradient: import("./gradient.js").LinearGradient;
+    alpha: number;
+    z: number;
+    seq: number;
+};
+export type PathStroke = {
+    color: Rgba;
+    width: number;
+    cap: 0 | 1 | 2;
+    join: 0 | 1 | 2;
+    miter: number;
+    dash: number[] | null;
+    dashOffset: number;
+};
+/**
+ * インライン SVG の図形（matrix はユーザー単位 → ドキュメント px）
+ */
+export type PathItem = {
+    type: "path";
+    segs: import("./svg-path.js").PathSeg[];
+    matrix: [number, number, number, number, number, number];
+    fill: Rgba | null;
+    evenOdd: boolean;
+    stroke: PathStroke | null;
+    top: number;
+    bottom: number;
+    z: number;
+    seq: number;
+};
+export type DisplayItem = RectItem | LineItem | StrokeRRectItem | ImageItem | TextItem | GroupItem | ClipItem | GradientItem | PathItem;
 /**
  * ページ境界を跨いではいけない縦範囲（行・表の行・画像・break-inside: avoid）
  */
@@ -135,10 +171,19 @@ export type TableInfo = {
     footBottom: number;
     footItems: DisplayItem[];
 };
+/**
+ * break-before/after: avoid — [start, end] に境界を置かず、置きそうなら pullTo まで戻す
+ */
+export type Join = {
+    start: number;
+    end: number;
+    pullTo: number;
+};
 export type WalkResult = {
     items: DisplayItem[];
     atoms: Atom[];
     breaks: number[];
+    joins: Join[];
     tables: TableInfo[];
     height: number;
 };
@@ -147,4 +192,8 @@ export type WalkContext = {
     fontFallback: string[];
     warn: (w: import("../index.js").ConversionWarning) => void;
     textMeasure: "font" | "measure" | "auto";
+    /**
+     * 長い走査で途中イベントループへ戻すための譲渡
+     */
+    pacer?: import("../pacer.js").Pacer | undefined;
 };