@hirokisakabe/pom 0.1.6 → 0.1.8

package/README.md

@@ -2,13 +2,22 @@
 
 **pom (PowerPoint Object Model)** は、PowerPoint プレゼンテーション（pptx）を TypeScript で宣言的に記述するためのライブラリです。生成 AI に出力させた POM 形式の JSON を、PowerPoint ファイルに変換するユースケースを想定しています。
 
+## 動作環境
+
+- Node.js 18 以上
+
+> [!NOTE]
+> pom は Node.js 環境でのみ動作します。ブラウザ環境では動作しません。
+
 ## 目次
 
+- [動作環境](#動作環境)
 - [インストール](#インストール)
 - [クイックスタート](#クイックスタート)
 - [特徴](#特徴)
 - [ノード](#ノード)
 - [マスタースライド](#マスタースライド)
+- [サーバーレス環境での利用](#サーバーレス環境での利用)
 - [LLM 連携](#llm-連携)
 - [ライセンス](#ライセンス)
 
@@ -103,6 +112,7 @@ await pptx.writeFile({ fileName: "presentation.pptx" });
   bold?: boolean;
   fontFamily?: string;
   lineSpacingMultiple?: number;
+  bullet?: boolean | BulletOptions;
 
   // 共通プロパティ
   w?: number | "max" | `${number}%`;
@@ -115,6 +125,54 @@ await pptx.writeFile({ fileName: "presentation.pptx" });
 - `bold` で太字を指定できます。
 - `fontFamily` でフォントファミリーを指定できます（デフォルト: `"Noto Sans JP"`）。
 - `lineSpacingMultiple` で行間倍率を指定できます（デフォルト: `1.3`）。
+- `bullet` で箇条書きを指定できます。`true` を指定するとデフォルトの箇条書き、オブジェクトで詳細設定が可能です。
+
+**BulletOptions:**
+
+```typescript
+{
+  type?: "bullet" | "number";  // "bullet": 記号、"number": 番号付き
+  indent?: number;             // インデントレベル
+  numberType?: "alphaLcParenBoth" | "alphaLcParenR" | "alphaLcPeriod" |
+               "alphaUcParenBoth" | "alphaUcParenR" | "alphaUcPeriod" |
+               "arabicParenBoth" | "arabicParenR" | "arabicPeriod" | "arabicPlain" |
+               "romanLcParenBoth" | "romanLcParenR" | "romanLcPeriod" |
+               "romanUcParenBoth" | "romanUcParenR" | "romanUcPeriod";
+  numberStartAt?: number;      // 番号の開始値
+}
+```
+
+**使用例:**
+
+```typescript
+// シンプルな箇条書き
+{
+  type: "text",
+  text: "項目1\n項目2\n項目3",
+  bullet: true,
+}
+
+// 番号付きリスト
+{
+  type: "text",
+  text: "ステップ1\nステップ2\nステップ3",
+  bullet: { type: "number" },
+}
+
+// アルファベット小文字（a. b. c.）
+{
+  type: "text",
+  text: "項目A\n項目B\n項目C",
+  bullet: { type: "number", numberType: "alphaLcPeriod" },
+}
+
+// 5から始まる番号リスト
+{
+  type: "text",
+  text: "5番目\n6番目\n7番目",
+  bullet: { type: "number", numberStartAt: 5 },
+}
+```
 
 #### 2. Image
 
@@ -142,7 +200,7 @@ await pptx.writeFile({ fileName: "presentation.pptx" });
 ```typescript
 {
   type: "table";
-  columns: { width: number }[];
+  columns: { width?: number }[];
   rows: {
     height?: number;
     cells: {
@@ -163,6 +221,7 @@ await pptx.writeFile({ fileName: "presentation.pptx" });
 }
 ```
 
+- `columns[].width` を省略すると、テーブル全体の幅から均等分割されます。
 - `columns` の合計がテーブルの自然幅になります（必要であれば `w` で上書きできます）。
 - `rows` の `height` を省略すると `defaultRowHeight`（未指定なら32px）が適用されます。
 - セル背景やフォント装飾を `cells` の各要素で個別に指定できます。
@@ -194,7 +253,7 @@ await pptx.writeFile({ fileName: "presentation.pptx" });
     color?: string;
   };
   fontPx?: number;
-  fontColor?: string;
+  color?: string;
   alignText?: "left" | "center" | "right";
 
   // 共通プロパティ
@@ -271,6 +330,76 @@ await pptx.writeFile({ fileName: "presentation.pptx" });
 }
 ```
 
+#### 8. Chart
+
+グラフを描画するノード。棒グラフ、折れ線グラフ、円グラフをサポート。
+
+```typescript
+{
+  type: "chart";
+  chartType: "bar" | "line" | "pie";
+  data: {
+    name?: string;           // 系列名
+    labels: string[];        // カテゴリラベル
+    values: number[];        // 値
+  }[];
+  showLegend?: boolean;      // 凡例表示（デフォルト: false）
+  showTitle?: boolean;       // タイトル表示（デフォルト: false）
+  title?: string;            // タイトル文字列
+  chartColors?: string[];    // データカラー配列（16進カラーコード）
+
+  // 共通プロパティ
+  w?: number | "max" | `${number}%`;
+  h?: number | "max" | `${number}%`;
+  ...
+}
+```
+
+**使用例:**
+
+```typescript
+// 棒グラフ
+{
+  type: "chart",
+  chartType: "bar",
+  w: 600,
+  h: 400,
+  data: [
+    {
+      name: "売上",
+      labels: ["1月", "2月", "3月", "4月"],
+      values: [100, 200, 150, 300],
+    },
+    {
+      name: "利益",
+      labels: ["1月", "2月", "3月", "4月"],
+      values: [30, 60, 45, 90],
+    },
+  ],
+  showLegend: true,
+  showTitle: true,
+  title: "月別売上・利益",
+  chartColors: ["0088CC", "00AA00"],
+}
+
+// 円グラフ
+{
+  type: "chart",
+  chartType: "pie",
+  w: 400,
+  h: 300,
+  data: [
+    {
+      name: "市場シェア",
+      labels: ["製品A", "製品B", "製品C", "その他"],
+      values: [40, 30, 20, 10],
+    },
+  ],
+  showLegend: true,
+  chartColors: ["0088CC", "00AA00", "FF6600", "888888"],
+}
+```
+
 ## マスタースライド
 
 全ページに共通のヘッダー・フッター・ページ番号を自動挿入できます。
@@ -367,10 +496,51 @@ type MasterSlideOptions = {
 - **動的置換**: プレースホルダーはページごとに自動的に置換されます
 - **後方互換性**: master オプションは省略可能で、既存コードへの影響はありません
 
+## サーバーレス環境での利用
+
+pom はデフォルトで `canvas` パッケージを使用してテキストの幅を計測し、折り返し位置を決定しています。しかし、Vercel や AWS Lambda などのサーバーレス環境では日本語フォント（Noto Sans JP など）がインストールされていないため、テキストの折り返し位置がずれる場合があります。
+
+この問題に対処するため、`textMeasurement` オプションでテキスト計測の方法を指定できます。
+
+### textMeasurement オプション
+
+```typescript
+const pptx = await buildPptx(
+  [slide],
+  { w: 1280, h: 720 },
+  {
+    textMeasurement: "auto", // "canvas" | "fallback" | "auto"
+  },
+);
+```
+
+| 値           | 説明                                                                               |
+| ------------ | ---------------------------------------------------------------------------------- |
+| `"canvas"`   | 常に canvas を使用してテキスト幅を計測（フォントがインストールされている環境向け） |
+| `"fallback"` | 常にフォールバック計算を使用（CJK文字は1em、英数字は0.5emで推定）                  |
+| `"auto"`     | フォントの利用可否を自動検出し、利用できない場合はフォールバック（デフォルト）     |
+
+### 推奨設定
+
+- **ローカル開発環境・Docker**: デフォルト（`"auto"`）のままで問題ありません
+- **サーバーレス環境**: デフォルトの `"auto"` で自動的にフォールバックされます
+- **フォントがインストールされている環境**: `"canvas"` を明示的に指定するとより正確な計測が可能です
+
 ## LLM 連携
 
 pom は LLM（GPT-4o、Claude など）で生成した JSON からスライドを作成するユースケースに対応しています。
 
+### LLM 向け仕様ガイド
+
+[`llm-guide.md`](./llm-guide.md) は、LLM に pom 形式の JSON を生成させるためのコンパクトな仕様書です。システムプロンプトに含めて使用してください。
+
+**含まれる内容:**
+
+- ノード一覧と主要プロパティ
+- 標準設定（スライドサイズ、padding、gap、フォントサイズ目安）
+- パターン例（基本構造、2 カラム、テーブル、図形、グラフなど）
+- よくある間違いと正しい書き方
+
 ### 入力用スキーマ
 
 `inputPomNodeSchema` を使って、LLM が生成した JSON を検証できます。
@@ -402,39 +572,6 @@ if (result.success) {
 }
 ```
 
-### OpenAI Structured Outputs との連携
-
-OpenAI SDK の `zodResponseFormat` を使用して、LLM に直接スキーマ準拠の JSON を生成させることができます。
-
-```typescript
-import { inputPomNodeSchema, buildPptx } from "@hirokisakabe/pom";
-import OpenAI from "openai";
-import { zodResponseFormat } from "openai/helpers/zod";
-
-const openai = new OpenAI();
-
-const response = await openai.chat.completions.create({
-  model: "gpt-4o",
-  messages: [
-    {
-      role: "system",
-      content:
-        "あなたはプレゼンテーション作成アシスタントです。指定されたスキーマに従ってスライドのJSONを生成してください。",
-    },
-    {
-      role: "user",
-      content:
-        "売上報告のスライドを作成して。タイトルと3つの箇条書きを含めて。",
-    },
-  ],
-  response_format: zodResponseFormat(inputPomNodeSchema, "slide"),
-});
-
-const slideData = JSON.parse(response.choices[0].message.content!);
-const pptx = await buildPptx([slideData], { w: 1280, h: 720 });
-await pptx.writeFile({ fileName: "sales-report.pptx" });
-```
-
 ### 利用可能な入力用スキーマ
 
 | スキーマ                        | 説明                                           |
@@ -444,6 +581,7 @@ await pptx.writeFile({ fileName: "sales-report.pptx" });
 | `inputImageNodeSchema`          | 画像ノード用                                   |
 | `inputTableNodeSchema`          | テーブルノード用                               |
 | `inputShapeNodeSchema`          | 図形ノード用                                   |
+| `inputChartNodeSchema`          | チャートノード用                               |
 | `inputBoxNodeSchema`            | Boxノード用                                    |
 | `inputVStackNodeSchema`         | VStackノード用                                 |
 | `inputHStackNodeSchema`         | HStackノード用                                 |

package/dist/buildPptx.d.ts

@@ -1,8 +1,11 @@
+import { TextMeasurementMode } from "./calcYogaLayout/measureText";
 import { POMNode, MasterSlideOptions } from "./types";
+export type { TextMeasurementMode };
 export declare function buildPptx(nodes: POMNode[], slideSize: {
     w: number;
     h: number;
 }, options?: {
     master?: MasterSlideOptions;
+    textMeasurement?: TextMeasurementMode;
 }): Promise<import("pptxgenjs").default>;
 //# sourceMappingURL=buildPptx.d.ts.map

package/dist/buildPptx.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"buildPptx.d.ts","sourceRoot":"","sources":["../src/buildPptx.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,OAAO,EAAkB,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAiGtE,wBAAsB,SAAS,CAC7B,KAAK,EAAE,OAAO,EAAE,EAChB,SAAS,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,EACnC,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,kBAAkB,CAAA;CAAE,wCAgB1C"}
+{"version":3,"file":"buildPptx.d.ts","sourceRoot":"","sources":["../src/buildPptx.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,mBAAmB,EACpB,MAAM,8BAA8B,CAAC;AAGtC,OAAO,EAAE,OAAO,EAAkB,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAEtE,YAAY,EAAE,mBAAmB,EAAE,CAAC;AA8FpC,wBAAsB,SAAS,CAC7B,KAAK,EAAE,OAAO,EAAE,EAChB,SAAS,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,EACnC,OAAO,CAAC,EAAE;IACR,MAAM,CAAC,EAAE,kBAAkB,CAAC;IAC5B,eAAe,CAAC,EAAE,mBAAmB,CAAC;CACvC,wCAsBF"}

package/dist/buildPptx.js

@@ -1,4 +1,5 @@
 import { calcYogaLayout } from "./calcYogaLayout/calcYogaLayout";
+import { setTextMeasurementMode, } from "./calcYogaLayout/measureText";
 import { renderPptx } from "./renderPptx/renderPptx";
 import { toPositioned } from "./toPositioned/toPositioned";
 function replacePlaceholders(node, pageNumber, totalPages, date) {
@@ -29,9 +30,7 @@ function composePage(content, master, pageNumber, totalPages) {
     if (!master) {
         return content;
     }
-    const date = master.date?.format === "locale"
-        ? new Date().toLocaleDateString()
-        : new Date().toISOString().split("T")[0].replace(/-/g, "/");
+    const date = master.date?.value ?? "";
     const children = [];
     // ヘッダーを追加
     if (master.header) {
@@ -63,6 +62,13 @@ function composePage(content, master, pageNumber, totalPages) {
     };
 }
 export async function buildPptx(nodes, slideSize, options) {
+    // テキスト計測モードを設定（デフォルトは auto）
+    if (options?.textMeasurement) {
+        setTextMeasurementMode(options.textMeasurement);
+    }
+    else {
+        setTextMeasurementMode("auto");
+    }
     const positionedPages = [];
     const totalPages = nodes.length;
     for (let i = 0; i < nodes.length; i++) {

package/dist/calcYogaLayout/calcYogaLayout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"calcYogaLayout.d.ts","sourceRoot":"","sources":["../../src/calcYogaLayout/calcYogaLayout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAOxC;;;;;;GAMG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,OAAO,EACb,SAAS,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,iBAcpC"}
+{"version":3,"file":"calcYogaLayout.d.ts","sourceRoot":"","sources":["../../src/calcYogaLayout/calcYogaLayout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAOxC;;;;;;GAMG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,OAAO,EACb,SAAS,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,iBAiBpC"}

package/dist/calcYogaLayout/calcYogaLayout.js

@@ -1,6 +1,6 @@
 import { loadYoga } from "yoga-layout/load";
 import { measureText } from "./measureText";
-import { measureImage } from "./measureImage";
+import { measureImage, prefetchImageSize } from "./measureImage";
 import { calcTableIntrinsicSize } from "../table/utils";
 /**
  * POMNode ツリーを Yoga でレイアウト計算する
@@ -11,6 +11,8 @@ import { calcTableIntrinsicSize } from "../table/utils";
  */
 export async function calcYogaLayout(root, slideSize) {
     const Yoga = await getYoga();
+    // 事前に全画像のサイズを取得（HTTPS対応のため）
+    await prefetchAllImageSizes(root);
     const rootYoga = Yoga.Node.create();
     root.yogaNode = rootYoga;
     await buildPomWithYogaTree(root, rootYoga);
@@ -19,6 +21,34 @@ export async function calcYogaLayout(root, slideSize) {
     rootYoga.setHeight(slideSize.h);
     rootYoga.calculateLayout(slideSize.w, slideSize.h, Yoga.DIRECTION_LTR);
 }
+/**
+ * POMNode ツリー内のすべての画像のサイズを事前取得する
+ */
+async function prefetchAllImageSizes(node) {
+    const imageSources = collectImageSources(node);
+    await Promise.all(imageSources.map((src) => prefetchImageSize(src)));
+}
+/**
+ * POMNode ツリー内のすべての画像のsrcを収集する
+ */
+function collectImageSources(node) {
+    const sources = [];
+    function traverse(n) {
+        if (n.type === "image") {
+            sources.push(n.src);
+        }
+        else if (n.type === "box") {
+            traverse(n.children);
+        }
+        else if (n.type === "vstack" || n.type === "hstack") {
+            for (const child of n.children) {
+                traverse(child);
+            }
+        }
+    }
+    traverse(node);
+    return sources;
+}
 /**
  * Yogaシングルトン
  */
@@ -31,21 +61,26 @@ async function getYoga() {
 /**
  * POMNode ツリーを再帰的に走査し、YogaNode ツリーを構築する
  */
-async function buildPomWithYogaTree(node, parentYoga) {
+async function buildPomWithYogaTree(node, parentYoga, parentNode) {
     const yoga = await getYoga();
     const yn = yoga.Node.create();
     node.yogaNode = yn; // 対応する YogaNode をセット
     await applyStyleToYogaNode(node, yn);
+    // HStack の子要素で幅が指定されていない場合、デフォルトで均等分割
+    if (parentNode?.type === "hstack" && node.w === undefined) {
+        yn.setFlexGrow(1);
+        yn.setFlexBasis(0);
+    }
     parentYoga.insertChild(yn, parentYoga.getChildCount());
     switch (node.type) {
         case "box": {
-            await buildPomWithYogaTree(node.children, yn);
+            await buildPomWithYogaTree(node.children, yn, node);
             break;
         }
         case "vstack":
         case "hstack": {
             for (const child of node.children) {
-                await buildPomWithYogaTree(child, yn);
+                await buildPomWithYogaTree(child, yn, node);
             }
             break;
         }
@@ -227,7 +262,7 @@ async function applyStyleToYogaNode(node, yn) {
                 const text = node.text;
                 const fontSizePx = node.fontPx ?? 24;
                 const fontFamily = "Noto Sans JP";
-                const fontWeight = "normal";
+                const fontWeight = node.bold ? "bold" : "normal";
                 const lineHeight = 1.3;
                 yn.setMeasureFunc((width, widthMode) => {
                     const maxWidthPx = (() => {
@@ -283,7 +318,7 @@ async function applyStyleToYogaNode(node, yn) {
                     const text = node.text;
                     const fontSizePx = node.fontPx ?? 24;
                     const fontFamily = "Noto Sans JP";
-                    const fontWeight = "normal";
+                    const fontWeight = node.bold ? "bold" : "normal";
                     const lineHeight = 1.3;
                     yn.setMeasureFunc((width, widthMode) => {
                         const maxWidthPx = (() => {

package/dist/calcYogaLayout/measureImage.d.ts

@@ -1,6 +1,17 @@
 /**
- * 画像ファイルのサイズを取得する
- * @param src 画像のパス（ローカルパス、またはbase64データ）
+ * 画像サイズを事前取得してキャッシュする（非同期）
+ * HTTPS URLの画像を処理する際に使用
+ * @param src 画像のパス（ローカルパス、base64データ、またはHTTPS URL）
+ * @returns 画像の幅と高さ（px）
+ */
+export declare function prefetchImageSize(src: string): Promise<{
+    widthPx: number;
+    heightPx: number;
+}>;
+/**
+ * 画像ファイルのサイズを取得する（同期）
+ * 事前にprefetchImageSizeでキャッシュしておくこと
+ * @param src 画像のパス（ローカルパス、base64データ、またはHTTPS URL）
  * @returns 画像の幅と高さ（px）
  */
 export declare function measureImage(src: string): {

package/dist/calcYogaLayout/measureImage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"measureImage.d.ts","sourceRoot":"","sources":["../../src/calcYogaLayout/measureImage.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB,CA+BA"}
+{"version":3,"file":"measureImage.d.ts","sourceRoot":"","sources":["../../src/calcYogaLayout/measureImage.ts"],"names":[],"mappings":"AAQA;;;;;GAKG;AACH,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAC5D,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC,CAqDD;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAqDA"}

package/dist/calcYogaLayout/measureImage.js

@@ -1,11 +1,76 @@
 import imageSize from "image-size";
 import * as fs from "fs";
 /**
- * 画像ファイルのサイズを取得する
- * @param src 画像のパス（ローカルパス、またはbase64データ）
+ * 画像サイズのキャッシュ（事前取得した画像サイズを保持）
+ */
+const imageSizeCache = new Map();
+/**
+ * 画像サイズを事前取得してキャッシュする（非同期）
+ * HTTPS URLの画像を処理する際に使用
+ * @param src 画像のパス（ローカルパス、base64データ、またはHTTPS URL）
+ * @returns 画像の幅と高さ（px）
+ */
+export async function prefetchImageSize(src) {
+    // キャッシュにあればそれを返す
+    const cached = imageSizeCache.get(src);
+    if (cached) {
+        return cached;
+    }
+    try {
+        let buffer;
+        // base64データの場合
+        if (src.startsWith("data:")) {
+            const base64Data = src.split(",")[1];
+            buffer = new Uint8Array(Buffer.from(base64Data, "base64"));
+        }
+        // HTTPS/HTTP URLの場合
+        else if (src.startsWith("https://") || src.startsWith("http://")) {
+            const response = await fetch(src);
+            if (!response.ok) {
+                throw new Error(`Failed to fetch image: ${response.status}`);
+            }
+            const arrayBuffer = await response.arrayBuffer();
+            buffer = new Uint8Array(arrayBuffer);
+        }
+        // ローカルファイルパスの場合
+        else {
+            buffer = new Uint8Array(fs.readFileSync(src));
+        }
+        const dimensions = imageSize(buffer);
+        const width = dimensions.width ?? 100; // デフォルト100px
+        const height = dimensions.height ?? 100; // デフォルト100px
+        const result = {
+            widthPx: width,
+            heightPx: height,
+        };
+        // キャッシュに保存
+        imageSizeCache.set(src, result);
+        return result;
+    }
+    catch (error) {
+        // エラーが発生した場合はデフォルトサイズを返す
+        console.warn(`Failed to measure image size for ${src}:`, error);
+        const result = {
+            widthPx: 100,
+            heightPx: 100,
+        };
+        imageSizeCache.set(src, result);
+        return result;
+    }
+}
+/**
+ * 画像ファイルのサイズを取得する（同期）
+ * 事前にprefetchImageSizeでキャッシュしておくこと
+ * @param src 画像のパス（ローカルパス、base64データ、またはHTTPS URL）
  * @returns 画像の幅と高さ（px）
  */
 export function measureImage(src) {
+    // キャッシュにあればそれを返す
+    const cached = imageSizeCache.get(src);
+    if (cached) {
+        return cached;
+    }
+    // キャッシュにない場合（ローカルファイルやbase64のみ同期処理可能）
     try {
         let buffer;
         // base64データの場合
@@ -13,6 +78,14 @@ export function measureImage(src) {
             const base64Data = src.split(",")[1];
             buffer = new Uint8Array(Buffer.from(base64Data, "base64"));
         }
+        // HTTPS/HTTP URLの場合はキャッシュがないとデフォルト値を返す
+        else if (src.startsWith("https://") || src.startsWith("http://")) {
+            console.warn(`Image size for URL ${src} was not prefetched. Using default size.`);
+            return {
+                widthPx: 100,
+                heightPx: 100,
+            };
+        }
         // ローカルファイルパスの場合
         else {
             buffer = new Uint8Array(fs.readFileSync(src));
@@ -20,10 +93,13 @@ export function measureImage(src) {
         const dimensions = imageSize(buffer);
         const width = dimensions.width ?? 100; // デフォルト100px
         const height = dimensions.height ?? 100; // デフォルト100px
-        return {
+        const result = {
             widthPx: width,
             heightPx: height,
         };
+        // キャッシュに保存
+        imageSizeCache.set(src, result);
+        return result;
     }
     catch (error) {
         // エラーが発生した場合はデフォルトサイズを返す

package/dist/calcYogaLayout/measureText.d.ts

@@ -4,6 +4,15 @@ type MeasureOptions = {
     fontWeight?: "normal" | "bold" | number;
     lineHeight?: number;
 };
+export type TextMeasurementMode = "canvas" | "fallback" | "auto";
+/**
+ * テキスト計測モードを設定する
+ */
+export declare function setTextMeasurementMode(mode: TextMeasurementMode): void;
+/**
+ * 現在のテキスト計測モードを取得する
+ */
+export declare function getTextMeasurementMode(): TextMeasurementMode;
 /**
  * テキストを折り返し付きでレイアウトし、そのサイズを測定する
  */

package/dist/calcYogaLayout/measureText.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"measureText.d.ts","sourceRoot":"","sources":["../../src/calcYogaLayout/measureText.ts"],"names":[],"mappings":"AAEA,KAAK,cAAc,GAAG;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;IACxC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAKF;;GAEG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,cAAc,GACnB;IACD,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB,CA+CA"}
+{"version":3,"file":"measureText.d.ts","sourceRoot":"","sources":["../../src/calcYogaLayout/measureText.ts"],"names":[],"mappings":"AAEA,KAAK,cAAc,GAAG;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;IACxC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG,QAAQ,GAAG,UAAU,GAAG,MAAM,CAAC;AA0FjE;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,mBAAmB,GAAG,IAAI,CAEtE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,mBAAmB,CAE5D;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,cAAc,GACnB;IACD,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAoBA"}