@hirokisakabe/pom 0.1.10 → 0.1.12

package/README.md

@@ -1,34 +1,34 @@
 # pom
 
-**pom (PowerPoint Object Model)** は、PowerPoint プレゼンテーション（pptx）を TypeScript で宣言的に記述するためのライブラリです。生成 AI に出力させた POM 形式の JSON を、PowerPoint ファイルに変換するユースケースを想定しています。
+**pom (PowerPoint Object Model)** is a library for declaratively describing PowerPoint presentations (pptx) in TypeScript. It is designed for use cases where JSON in POM format generated by AI is converted into PowerPoint files.
 
-## 動作環境
+## Requirements
 
-- Node.js 18 以上
+- Node.js 18 or higher
 
 > [!NOTE]
-> PPTX生成機能（`buildPptx`）は Node.js 環境でのみ動作します。ただし、入力スキーマのみを使用する場合は `@hirokisakabe/pom/schema` からブラウザ環境でもimport可能です。
+> The PPTX generation feature (`buildPptx`) only works in Node.js environments. However, if you only need the input schema, you can import it from `@hirokisakabe/pom/schema` for use in browser environments.
 
-## 目次
+## Table of Contents
 
-- [動作環境](#動作環境)
-- [インストール](#インストール)
-- [クイックスタート](#クイックスタート)
-- [特徴](#特徴)
-- [ノード](#ノード)
-- [マスタースライド](#マスタースライド)
-- [サーバーレス環境での利用](#サーバーレス環境での利用)
-- [LLM 連携](#llm-連携)
-  - [ブラウザ環境での入力検証](#ブラウザ環境での入力検証)
-- [ライセンス](#ライセンス)
+- [Requirements](#requirements)
+- [Installation](#installation)
+- [Quick Start](#quick-start)
+- [Features](#features)
+- [Nodes](#nodes)
+- [Master Slide](#master-slide)
+- [Serverless Environments](#serverless-environments)
+- [LLM Integration](#llm-integration)
+  - [Input Validation in Browser Environments](#input-validation-in-browser-environments)
+- [License](#license)
 
-## インストール
+## Installation
 
 ```bash
 npm install @hirokisakabe/pom
 ```
 
-## クイックスタート
+## Quick Start
 
 ```typescript
 import { buildPptx, POMNode } from "@hirokisakabe/pom";
@@ -43,13 +43,13 @@ const slide: POMNode = {
   children: [
     {
       type: "text",
-      text: "プレゼンテーションタイトル",
+      text: "Presentation Title",
       fontPx: 48,
       bold: true,
     },
     {
       type: "text",
-      text: "サブタイトル",
+      text: "Subtitle",
       fontPx: 24,
       color: "666666",
     },
@@ -60,21 +60,21 @@ const pptx = await buildPptx([slide], { w: 1280, h: 720 });
 await pptx.writeFile({ fileName: "presentation.pptx" });
 ```
 
-## 特徴
+## Features
 
-- **型安全**: TypeScript による厳密な型定義
-- **宣言的**: JSON ライクなオブジェクトでスライドを記述
-- **PowerPoint ファースト**: Shape 機能をネイティブサポート
-- **柔軟なレイアウト**: VStack/HStack/Box による自動レイアウト
-- **ピクセル単位**: 直感的なピクセル単位での指定（内部でインチに変換）
-- **マスタースライド**: 全ページ共通のヘッダー・フッター・ページ番号を自動挿入
-- **AI フレンドリー**: LLM がコード生成しやすいシンプルな構造
+- **Type-safe**: Strict type definitions with TypeScript
+- **Declarative**: Describe slides with JSON-like objects
+- **PowerPoint First**: Native support for Shape features
+- **Flexible Layout**: Automatic layout with VStack/HStack/Box
+- **Pixel Units**: Intuitive pixel-based sizing (internally converted to inches)
+- **Master Slide**: Automatically insert common headers, footers, and page numbers across all pages
+- **AI Friendly**: Simple structure that makes it easy for LLMs to generate code
 
-## ノード
+## Nodes
 
-### 共通プロパティ
+### Common Properties
 
-すべてのノードが共通して持てるレイアウト属性。
+Layout attributes that all nodes can have.
 
 ```typescript
 {
@@ -91,17 +91,19 @@ await pptx.writeFile({ fileName: "presentation.pptx" });
     width?: number;
     dashType?: "solid" | "dash" | "dashDot" | "lgDash" | "lgDashDot" | "lgDashDotDot" | "sysDash" | "sysDot";
   };
+  borderRadius?: number;
 }
 ```
 
-- `backgroundColor` はノード全体に塗りつぶしを適用します（例: `"F8F9FA"`）。
-- `border.width` は px 単位で指定し、色や `dashType` と組み合わせて枠線を制御できます。
+- `backgroundColor` applies a fill to the entire node (e.g., `"F8F9FA"`).
+- `border.width` is specified in px and can be combined with color and `dashType` to control the border.
+- `borderRadius` specifies the corner radius in px. When specified, the background/border shape becomes a rounded rectangle.
 
-### ノード一覧
+### Node List
 
 #### 1. Text
 
-テキストを表示するノード。
+A node for displaying text.
 
 ```typescript
 {
@@ -115,79 +117,79 @@ await pptx.writeFile({ fileName: "presentation.pptx" });
   lineSpacingMultiple?: number;
   bullet?: boolean | BulletOptions;
 
-  // 共通プロパティ
+  // Common properties
   w?: number | "max" | `${number}%`;
   h?: number | "max" | `${number}%`;
   ...
 }
 ```
 
-- `color` で文字色を 16 進カラーコード（例: `"FF0000"`）として指定できます。
-- `bold` で太字を指定できます。
-- `fontFamily` でフォントファミリーを指定できます（デフォルト: `"Noto Sans JP"`）。
-- `lineSpacingMultiple` で行間倍率を指定できます（デフォルト: `1.3`）。
-- `bullet` で箇条書きを指定できます。`true` を指定するとデフォルトの箇条書き、オブジェクトで詳細設定が可能です。
+- `color` specifies the text color as a hex color code (e.g., `"FF0000"`).
+- `bold` enables bold text.
+- `fontFamily` specifies the font family (default: `"Noto Sans JP"`).
+- `lineSpacingMultiple` specifies the line spacing multiplier (default: `1.3`).
+- `bullet` enables bullet points. Use `true` for default bullets, or an object for detailed settings.
 
 **BulletOptions:**
 
 ```typescript
 {
-  type?: "bullet" | "number";  // "bullet": 記号、"number": 番号付き
-  indent?: number;             // インデントレベル
+  type?: "bullet" | "number";  // "bullet": symbol, "number": numbered
+  indent?: number;             // Indent level
   numberType?: "alphaLcParenBoth" | "alphaLcParenR" | "alphaLcPeriod" |
                "alphaUcParenBoth" | "alphaUcParenR" | "alphaUcPeriod" |
                "arabicParenBoth" | "arabicParenR" | "arabicPeriod" | "arabicPlain" |
                "romanLcParenBoth" | "romanLcParenR" | "romanLcPeriod" |
                "romanUcParenBoth" | "romanUcParenR" | "romanUcPeriod";
-  numberStartAt?: number;      // 番号の開始値
+  numberStartAt?: number;      // Starting number
 }
 ```
 
-**使用例:**
+**Usage Examples:**
 
 ```typescript
-// シンプルな箇条書き
+// Simple bullet list
 {
   type: "text",
-  text: "項目1\n項目2\n項目3",
+  text: "Item 1\nItem 2\nItem 3",
   bullet: true,
 }
 
-// 番号付きリスト
+// Numbered list
 {
   type: "text",
-  text: "ステップ1\nステップ2\nステップ3",
+  text: "Step 1\nStep 2\nStep 3",
   bullet: { type: "number" },
 }
 
-// アルファベット小文字（a. b. c.）
+// Lowercase alphabet (a. b. c.)
 {
   type: "text",
-  text: "項目A\n項目B\n項目C",
+  text: "Item A\nItem B\nItem C",
   bullet: { type: "number", numberType: "alphaLcPeriod" },
 }
 
-// 5から始まる番号リスト
+// Numbered list starting from 5
 {
   type: "text",
-  text: "5番目\n6番目\n7番目",
+  text: "Fifth\nSixth\nSeventh",
   bullet: { type: "number", numberStartAt: 5 },
 }
 ```
 
 #### 2. Image
 
-画像を表示するノード。
+A node for displaying images.
 
-- `w` と `h` を指定しない場合、画像の実際のサイズが自動的に取得されます
-- サイズを指定した場合、そのサイズで表示されます（アスペクト比は保持されません）
+- If `w` and `h` are not specified, the actual image size is automatically used
+- If size is specified, the image is displayed at that size (aspect ratio is not preserved)
 
 ```typescript
 {
   type: "image";
-  src: string;  // 画像のパス（ローカルパス、URL、base64データ）
+  src: string;  // Image path (local path, URL, or base64 data)
 
-  // 共通プロパティ
+  // Common properties
   w?: number | "max" | `${number}%`;
   h?: number | "max" | `${number}%`;
   ...
@@ -196,7 +198,7 @@ await pptx.writeFile({ fileName: "presentation.pptx" });
 
 #### 3. Table
 
-表を描画するノード。列幅・行高を px 単位で宣言し、セル単位で装飾を細かく制御できます。
+A node for drawing tables. Column widths and row heights are declared in px, with fine-grained control over cell decoration.
 
 ```typescript
 {
@@ -215,27 +217,27 @@ await pptx.writeFile({ fileName: "presentation.pptx" });
   }[];
   defaultRowHeight?: number;
 
-  // 共通プロパティ
+  // Common properties
   w?: number | "max" | `${number}%`;
   h?: number | "max" | `${number}%`;
   ...
 }
 ```
 
-- `columns[].width` を省略すると、テーブル全体の幅から均等分割されます。
-- `columns` の合計がテーブルの自然幅になります（必要であれば `w` で上書きできます）。
-- `rows` の `height` を省略すると `defaultRowHeight`（未指定なら32px）が適用されます。
-- セル背景やフォント装飾を `cells` の各要素で個別に指定できます。
+- If `columns[].width` is omitted, columns are evenly distributed across the table width.
+- The sum of `columns` becomes the natural width of the table (can be overridden with `w` if needed).
+- If `rows` `height` is omitted, `defaultRowHeight` is applied (32px if unspecified).
+- Cell background and font decoration can be specified individually for each element in `cells`.
 
 #### 4. Shape
 
-図形を描画するノード。テキスト付き/なしで異なる表現が可能で、複雑なビジュアル効果をサポートしています。
+A node for drawing shapes. Different representations are possible with or without text, supporting complex visual effects.
 
 ```typescript
 {
   type: "shape";
-  shapeType: PptxGenJS.SHAPE_NAME;  // 例: "roundRect", "ellipse", "cloud", "star5" など
-  text?: string;                     // 図形内に表示するテキスト（オプション）
+  shapeType: PptxGenJS.SHAPE_NAME;  // e.g., "roundRect", "ellipse", "cloud", "star5"
+  text?: string;                     // Text to display inside the shape (optional)
   fill?: {
     color?: string;
     transparency?: number;
@@ -257,36 +259,36 @@ await pptx.writeFile({ fileName: "presentation.pptx" });
   color?: string;
   alignText?: "left" | "center" | "right";
 
-  // 共通プロパティ
+  // Common properties
   w?: number | "max" | `${number}%`;
   h?: number | "max" | `${number}%`;
   ...
 }
 ```
 
-**主な図形タイプの例:**
+**Common Shape Types:**
 
-- `roundRect`: 角丸長方形（タイトルボックス、カテゴリ表示）
-- `ellipse`: 楕円/円（ステップ番号、バッジ）
-- `cloud`: 雲型（コメント、重要ポイント）
-- `wedgeRectCallout`: 矢印付き吹き出し（注記）
-- `cloudCallout`: 雲吹き出し（コメント）
-- `star5`: 5つ星（強調、デコレーション）
-- `downArrow`: 下矢印（フロー図）
+- `roundRect`: Rounded rectangle (title boxes, category displays)
+- `ellipse`: Ellipse/circle (step numbers, badges)
+- `cloud`: Cloud shape (comments, key points)
+- `wedgeRectCallout`: Callout with arrow (annotations)
+- `cloudCallout`: Cloud callout (comments)
+- `star5`: 5-pointed star (emphasis, decoration)
+- `downArrow`: Down arrow (flow diagrams)
 
 #### 5. Box
 
-単一の子要素をラップする汎用コンテナ。
+A generic container that wraps a single child element.
 
-- 子要素は **1つ**
-- padding や固定サイズを与えてグルーピングに使う
+- Only **one** child element
+- Used for grouping with padding or fixed size
 
 ```typescript
 {
   type: "box";
   children: POMNode;
 
-  // 共通プロパティ
+  // Common properties
   w?: number | "max" | `${number}%`;
   h?: number | "max" | `${number}%`;
   ...
@@ -295,7 +297,7 @@ await pptx.writeFile({ fileName: "presentation.pptx" });
 
 #### 6. VStack
 
-子要素を **縦方向** に並べる。
+Arranges child elements **vertically**.
 
 ```typescript
 {
@@ -305,7 +307,7 @@ await pptx.writeFile({ fileName: "presentation.pptx" });
   justifyContent: "start" | "center" | "end" | "spaceBetween";
   gap?: number;
 
-  // 共通プロパティ
+  // Common properties
   w?: number | "max" | `${number}%`;
   h?: number | "max" | `${number}%`;
   ...
@@ -314,7 +316,7 @@ await pptx.writeFile({ fileName: "presentation.pptx" });
 
 #### 7. HStack
 
-子要素を **横方向** に並べる。
+Arranges child elements **horizontally**.
 
 ```typescript
 {
@@ -324,7 +326,7 @@ await pptx.writeFile({ fileName: "presentation.pptx" });
   justifyContent: "start" | "center" | "end" | "spaceBetween";
   gap?: number;
 
-  // 共通プロパティ
+  // Common properties
   w?: number | "max" | `${number}%`;
   h?: number | "max" | `${number}%`;
   ...
@@ -333,33 +335,34 @@ await pptx.writeFile({ fileName: "presentation.pptx" });
 
 #### 8. Chart
 
-グラフを描画するノード。棒グラフ、折れ線グラフ、円グラフをサポート。
+A node for drawing charts. Supports bar charts, line charts, pie charts, area charts, doughnut charts, and radar charts.
 
 ```typescript
 {
   type: "chart";
-  chartType: "bar" | "line" | "pie";
+  chartType: "bar" | "line" | "pie" | "area" | "doughnut" | "radar";
   data: {
-    name?: string;           // 系列名
-    labels: string[];        // カテゴリラベル
-    values: number[];        // 値
+    name?: string;           // Series name
+    labels: string[];        // Category labels
+    values: number[];        // Values
   }[];
-  showLegend?: boolean;      // 凡例表示（デフォルト: false）
-  showTitle?: boolean;       // タイトル表示（デフォルト: false）
-  title?: string;            // タイトル文字列
-  chartColors?: string[];    // データカラー配列（16進カラーコード）
+  showLegend?: boolean;      // Show legend (default: false)
+  showTitle?: boolean;       // Show title (default: false)
+  title?: string;            // Title string
+  chartColors?: string[];    // Data color array (hex color codes)
+  radarStyle?: "standard" | "marker" | "filled";  // Radar-only: chart style
 
-  // 共通プロパティ
+  // Common properties
   w?: number | "max" | `${number}%`;
   h?: number | "max" | `${number}%`;
   ...
 }
 ```
 
-**使用例:**
+**Usage Examples:**
 
 ```typescript
-// 棒グラフ
+// Bar chart
 {
   type: "chart",
   chartType: "bar",
@@ -367,23 +370,23 @@ await pptx.writeFile({ fileName: "presentation.pptx" });
   h: 400,
   data: [
     {
-      name: "売上",
-      labels: ["1月", "2月", "3月", "4月"],
+      name: "Sales",
+      labels: ["Jan", "Feb", "Mar", "Apr"],
       values: [100, 200, 150, 300],
     },
     {
-      name: "利益",
-      labels: ["1月", "2月", "3月", "4月"],
+      name: "Profit",
+      labels: ["Jan", "Feb", "Mar", "Apr"],
       values: [30, 60, 45, 90],
     },
   ],
   showLegend: true,
   showTitle: true,
-  title: "月別売上・利益",
+  title: "Monthly Sales & Profit",
   chartColors: ["0088CC", "00AA00"],
 }
 
-// 円グラフ
+// Pie chart
 {
   type: "chart",
   chartType: "pie",
@@ -391,21 +394,39 @@ await pptx.writeFile({ fileName: "presentation.pptx" });
   h: 300,
   data: [
     {
-      name: "市場シェア",
-      labels: ["製品A", "製品B", "製品C", "その他"],
+      name: "Market Share",
+      labels: ["Product A", "Product B", "Product C", "Others"],
       values: [40, 30, 20, 10],
     },
   ],
   showLegend: true,
   chartColors: ["0088CC", "00AA00", "FF6600", "888888"],
 }
+
+// Radar chart
+{
+  type: "chart",
+  chartType: "radar",
+  w: 400,
+  h: 300,
+  data: [
+    {
+      name: "Skill Assessment",
+      labels: ["Technical", "Design", "PM", "Sales", "Support"],
+      values: [80, 60, 70, 50, 90],
+    },
+  ],
+  showLegend: true,
+  radarStyle: "filled",
+  chartColors: ["0088CC"],
+}
 ```
 
-## マスタースライド
+## Master Slide
 
-全ページに共通のヘッダー・フッター・ページ番号を自動挿入できます。
+You can automatically insert common headers, footers, and page numbers across all pages.
 
-### 基本的な使い方
+### Basic Usage
 
 ```typescript
 import { buildPptx } from "@hirokisakabe/pom";
@@ -425,7 +446,7 @@ const pptx = await buildPptx(
         children: [
           {
             type: "text",
-            text: "会社名",
+            text: "Company Name",
             fontPx: 14,
             color: "FFFFFF",
           },
@@ -460,50 +481,50 @@ const pptx = await buildPptx(
         ],
       },
       date: {
-        format: "YYYY/MM/DD", // または "locale"
+        format: "YYYY/MM/DD", // or "locale"
       },
     },
   },
 );
 ```
 
-### マスタースライドのオプション
+### Master Slide Options
 
 ```typescript
 type MasterSlideOptions = {
-  header?: POMNode; // ヘッダー（任意の POMNode を指定可能）
-  footer?: POMNode; // フッター（任意の POMNode を指定可能）
+  header?: POMNode; // Header (any POMNode can be specified)
+  footer?: POMNode; // Footer (any POMNode can be specified)
   pageNumber?: {
-    position: "left" | "center" | "right"; // ページ番号の位置
+    position: "left" | "center" | "right"; // Page number position
   };
   date?: {
-    format: "YYYY/MM/DD" | "locale"; // 日付のフォーマット
+    format: "YYYY/MM/DD" | "locale"; // Date format
   };
 };
 ```
 
-### プレースホルダー
+### Placeholders
 
-ヘッダー・フッター内のテキストで以下のプレースホルダーが使用できます：
+The following placeholders can be used in text within headers and footers:
 
-- `{{page}}`: 現在のページ番号
-- `{{totalPages}}`: 総ページ数
-- `{{date}}`: 日付（`date.format` で指定した形式）
+- `{{page}}`: Current page number
+- `{{totalPages}}`: Total number of pages
+- `{{date}}`: Date (in the format specified by `date.format`)
 
-### 特徴
+### Features
 
-- **柔軟性**: ヘッダー・フッターには任意の POMNode（VStack、HStack、Box など）を使用可能
-- **自動合成**: 各ページのコンテンツに自動的にヘッダー・フッターが追加されます
-- **動的置換**: プレースホルダーはページごとに自動的に置換されます
-- **後方互換性**: master オプションは省略可能で、既存コードへの影響はありません
+- **Flexibility**: Headers and footers can use any POMNode (VStack, HStack, Box, etc.)
+- **Automatic Composition**: Headers and footers are automatically added to each page's content
+- **Dynamic Replacement**: Placeholders are automatically replaced per page
+- **Backward Compatibility**: The master option is optional and has no impact on existing code
 
-## サーバーレス環境での利用
+## Serverless Environments
 
-pom はデフォルトで `canvas` パッケージを使用してテキストの幅を計測し、折り返し位置を決定しています。しかし、Vercel や AWS Lambda などのサーバーレス環境では日本語フォント（Noto Sans JP など）がインストールされていないため、テキストの折り返し位置がずれる場合があります。
+pom uses the `canvas` package by default to measure text width and determine line break positions. However, in serverless environments like Vercel or AWS Lambda, Japanese fonts (such as Noto Sans JP) are not installed, which may cause text line breaks to be misaligned.
 
-この問題に対処するため、`textMeasurement` オプションでテキスト計測の方法を指定できます。
+To address this issue, you can specify the text measurement method using the `textMeasurement` option.
 
-### textMeasurement オプション
+### textMeasurement Option
 
 ```typescript
 const pptx = await buildPptx(
@@ -515,48 +536,48 @@ const pptx = await buildPptx(
 );
 ```
 
-| 値           | 説明                                                                               |
-| ------------ | ---------------------------------------------------------------------------------- |
-| `"canvas"`   | 常に canvas を使用してテキスト幅を計測（フォントがインストールされている環境向け） |
-| `"fallback"` | 常にフォールバック計算を使用（CJK文字は1em、英数字は0.5emで推定）                  |
-| `"auto"`     | フォントの利用可否を自動検出し、利用できない場合はフォールバック（デフォルト）     |
+| Value        | Description                                                                            |
+| ------------ | -------------------------------------------------------------------------------------- |
+| `"canvas"`   | Always use canvas for text width measurement (for environments with fonts installed)   |
+| `"fallback"` | Always use fallback calculation (CJK characters = 1em, alphanumeric = 0.5em estimated) |
+| `"auto"`     | Auto-detect font availability and fall back if unavailable (default)                   |
 
-### 推奨設定
+### Recommended Settings
 
-- **ローカル開発環境・Docker**: デフォルト（`"auto"`）のままで問題ありません
-- **サーバーレス環境**: デフォルトの `"auto"` で自動的にフォールバックされます
-- **フォントがインストールされている環境**: `"canvas"` を明示的に指定するとより正確な計測が可能です
+- **Local development / Docker**: Default (`"auto"`) works fine
+- **Serverless environments**: Default `"auto"` will automatically fall back
+- **Environments with fonts installed**: Explicitly specifying `"canvas"` enables more accurate measurement
 
-## LLM 連携
+## LLM Integration
 
-pom は LLM（GPT-4o、Claude など）で生成した JSON からスライドを作成するユースケースに対応しています。
+pom supports use cases where slides are created from JSON generated by LLMs (GPT-4o, Claude, etc.).
 
-### LLM 向け仕様ガイド
+### LLM Specification Guide
 
-[`llm-guide.md`](./llm-guide.md) は、LLM に pom 形式の JSON を生成させるためのコンパクトな仕様書です。システムプロンプトに含めて使用してください。
+[`llm-guide.md`](./llm-guide.md) is a compact specification document for having LLMs generate JSON in pom format. Include it in your system prompt.
 
-**含まれる内容:**
+**Contents:**
 
-- ノード一覧と主要プロパティ
-- 標準設定（スライドサイズ、padding、gap、フォントサイズ目安）
-- パターン例（基本構造、2 カラム、テーブル、図形、グラフなど）
-- よくある間違いと正しい書き方
+- Node list and main properties
+- Standard settings (slide size, padding, gap, font size guidelines)
+- Pattern examples (basic structure, 2-column, table, shapes, charts, etc.)
+- Common mistakes and correct usage
 
-### 入力用スキーマ
+### Input Schema
 
-`inputPomNodeSchema` を使って、LLM が生成した JSON を検証できます。
+Use `inputPomNodeSchema` to validate JSON generated by LLMs.
 
 ```typescript
 import { inputPomNodeSchema, buildPptx, InputPOMNode } from "@hirokisakabe/pom";
 
-// LLMからのJSON出力を検証
+// Validate JSON output from LLM
 const jsonFromLLM = `{
   "type": "vstack",
   "padding": 48,
   "gap": 24,
   "children": [
-    { "type": "text", "text": "タイトル", "fontPx": 32, "bold": true },
-    { "type": "text", "text": "本文テキスト", "fontPx": 16 }
+    { "type": "text", "text": "Title", "fontPx": 32, "bold": true },
+    { "type": "text", "text": "Body text", "fontPx": 16 }
   ]
 }`;
 
@@ -564,61 +585,61 @@ const parsed = JSON.parse(jsonFromLLM);
 const result = inputPomNodeSchema.safeParse(parsed);
 
 if (result.success) {
-  // 検証成功 - PPTXを生成
+  // Validation successful - generate PPTX
   const pptx = await buildPptx([result.data], { w: 1280, h: 720 });
   await pptx.writeFile({ fileName: "output.pptx" });
 } else {
-  // 検証失敗 - エラー内容を確認
+  // Validation failed - check error details
   console.error("Validation failed:", result.error.format());
 }
 ```
 
-### 利用可能な入力用スキーマ
+### Available Input Schemas
 
-| スキーマ                        | 説明                                           |
-| ------------------------------- | ---------------------------------------------- |
-| `inputPomNodeSchema`            | メインのノードスキーマ（全ノードタイプを含む） |
-| `inputTextNodeSchema`           | テキストノード用                               |
-| `inputImageNodeSchema`          | 画像ノード用                                   |
-| `inputTableNodeSchema`          | テーブルノード用                               |
-| `inputShapeNodeSchema`          | 図形ノード用                                   |
-| `inputChartNodeSchema`          | チャートノード用                               |
-| `inputBoxNodeSchema`            | Boxノード用                                    |
-| `inputVStackNodeSchema`         | VStackノード用                                 |
-| `inputHStackNodeSchema`         | HStackノード用                                 |
-| `inputMasterSlideOptionsSchema` | マスタースライド設定用                         |
+| Schema                          | Description                                |
+| ------------------------------- | ------------------------------------------ |
+| `inputPomNodeSchema`            | Main node schema (includes all node types) |
+| `inputTextNodeSchema`           | For text nodes                             |
+| `inputImageNodeSchema`          | For image nodes                            |
+| `inputTableNodeSchema`          | For table nodes                            |
+| `inputShapeNodeSchema`          | For shape nodes                            |
+| `inputChartNodeSchema`          | For chart nodes                            |
+| `inputBoxNodeSchema`            | For Box nodes                              |
+| `inputVStackNodeSchema`         | For VStack nodes                           |
+| `inputHStackNodeSchema`         | For HStack nodes                           |
+| `inputMasterSlideOptionsSchema` | For master slide settings                  |
 
-### ブラウザ環境での入力検証
+### Input Validation in Browser Environments
 
-ブラウザ環境（React、Vue、SvelteなどのSPA）で LLM の出力を検証したい場合は、`@hirokisakabe/pom/schema` からスキーマをimportできます。このサブパスは Node.js 依存のないスキーマのみをエクスポートするため、ブラウザでも問題なく動作します。
+If you want to validate LLM output in browser environments (SPAs like React, Vue, Svelte), you can import schemas from `@hirokisakabe/pom/schema`. This subpath exports only schemas without Node.js dependencies, so it works in browsers.
 
 ```typescript
-// ブラウザ環境で使用可能
+// Available in browser environments
 import { inputPomNodeSchema } from "@hirokisakabe/pom/schema";
 
-// LLMからのレスポンスを検証
+// Validate response from LLM
 const result = inputPomNodeSchema.safeParse(llmResponse);
 
 if (result.success) {
-  // 検証成功 - サーバーサイドに送信してPPTX生成
+  // Validation successful - send to server for PPTX generation
   await fetch("/api/generate-pptx", {
     method: "POST",
     headers: { "Content-Type": "application/json" },
     body: JSON.stringify(result.data),
   });
 } else {
-  // 検証失敗 - エラーをユーザーに表示
+  // Validation failed - show error to user
   console.error("Validation failed:", result.error.format());
 }
 ```
 
-**`@hirokisakabe/pom` vs `@hirokisakabe/pom/schema` の違い:**
+**Difference between `@hirokisakabe/pom` and `@hirokisakabe/pom/schema`:**
 
-| インポートパス             | 環境       | 含まれる機能                               |
-| -------------------------- | ---------- | ------------------------------------------ |
-| `@hirokisakabe/pom`        | Node.js    | すべて（PPTX生成、スキーマ、型定義）       |
-| `@hirokisakabe/pom/schema` | ブラウザ可 | スキーマと型定義のみ（PPTX生成は含まない） |
+| Import Path                | Environment     | Included Features                            |
+| -------------------------- | --------------- | -------------------------------------------- |
+| `@hirokisakabe/pom`        | Node.js         | Everything (PPTX generation, schemas, types) |
+| `@hirokisakabe/pom/schema` | Browser-capable | Schemas and types only (no PPTX generation)  |
 
-## ライセンス
+## License
 
 MIT