@shuji-bonji/pdf-writer-mcp 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 shuji-bonji
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,208 @@
+# pdf-writer-mcp
+
+テキスト / Markdown / 表データからの **PDF 生成** と、既存 PDF の **編集**（メタデータ・ページ操作）を行う
+MCP (Model Context Protocol) サーバです。
+[pdf-lib](https://pdf-lib.js.org/) をコアに、日本語フォントの埋め込み（サブセット）に対応します。
+
+## 位置づけ
+
+`shuji-bonji` の PDF 系 MCP エコシステムにおける「生成（write）」担当です。
+読み取り・検証系とは責務を分けています。
+
+```mermaid
+graph LR
+  subgraph 生成
+    W[pdf-writer-mcp<br/>text/md/table→PDF]
+  end
+  subgraph 読取
+    R[pdf-reader-mcp<br/>抽出・検査]
+  end
+  subgraph 検証
+    V[pdf-verify-mcp<br/>署名・準拠性]
+  end
+  subgraph 仕様参照
+    S[pdf-spec-mcp<br/>ISO 32000]
+  end
+  W --> R
+  R --> V
+  S -.仕様根拠.-> W
+  S -.仕様根拠.-> V
+```
+
+## 特徴
+
+- **3 つの生成ツール**: プレーンテキスト / Markdown / 表
+- **7 つの編集ツール**: メタデータ更新、結合・分割・抽出・削除・並べ替え・回転
+- **署名ガード**: 電子署名済み PDF（`/ByteRange` 検知）の編集は既定でエラーにし、
+  署名の意図しない無効化を防止（`allowBreakingSignatures: true` で明示的に続行可能）
+- **日本語対応**: `.ttf` / `.otf` フォントを fontkit でサブセット埋め込み（16MB のフォントでも出力は数十 KB）
+- **抽出・検索・コピー可能**: 埋め込みフォントでも ToUnicode CMap が付与されるため、
+  生成した PDF のテキストは選択・コピー・全文検索・スクリーンリーダ読み上げが可能
+- **自動レイアウト**: テキスト折り返し（日英混在・長語の強制分割）、改ページ、表の改ページ時ヘッダ再描画
+- **出力先の柔軟性**: ファイル保存 / base64 返却の両対応
+- **堅牢な入力検査**: `asserts` によるバリデーションで不正値を早期に弾く
+
+## MCP クライアント設定
+
+`claude_desktop_config.json`（例、npm 公開版を npx で起動）:
+
+```json
+{
+  "mcpServers": {
+    "pdf-writer": {
+      "command": "npx",
+      "args": ["-y", "@shuji-bonji/pdf-writer-mcp"],
+      "env": {
+        "PDF_WRITER_FONT": "/absolute/path/to/NotoSansJP-Regular.otf"
+      }
+    }
+  }
+}
+```
+
+ローカルのソースから起動する場合:
+
+```json
+{
+  "mcpServers": {
+    "pdf-writer": {
+      "command": "node",
+      "args": ["/absolute/path/to/pdf-writer-mcp/dist/index.js"],
+      "env": {
+        "PDF_WRITER_FONT": "/absolute/path/to/NotoSansJP-Regular.otf"
+      }
+    }
+  }
+}
+```
+
+`PDF_WRITER_FONT` を設定しておくと、各ツールで `fontPath` を省略しても日本語が出せます。
+
+## 開発
+
+```bash
+npm install
+npm run build      # dist/ に出力
+npm test           # vitest
+npm run typecheck  # tsc --noEmit
+```
+
+## フォントについて（重要）
+
+- 標準フォント（Helvetica）は **ASCII のみ**。日本語を含む場合は `fontPath` か `PDF_WRITER_FONT` で
+  埋め込み可能な **単一フォント（`.ttf` / `.otf`）** を指定してください。
+- **`.ttc`（TrueTypeCollection）は非対応**です（pdf-lib がサブセット化できないため、検知してエラーにします）。
+  `.ttc` しか手元にない場合は、単一フェイスを抽出してください。
+
+  ```bash
+  # 例: Noto Sans CJK の .ttc から日本語フェイス(index 0)を .otf として取り出す
+  python3 -c "from fontTools.ttLib import TTCollection; \
+    TTCollection('NotoSansCJK-Regular.ttc').fonts[0].save('NotoSansCJKjp-Regular.otf')"
+  ```
+
+- 日本語フォントの入手先の例: [Noto Sans JP](https://fonts.google.com/noto/specimen/Noto+Sans+JP)（SIL OFL）。
+
+## ツール
+
+### `create_text_pdf`
+
+プレーンテキスト → PDF。`\n` で改行、空行で段落区切り。長い行は自動折り返し。
+
+| 引数 | 型 | 必須 | 説明 |
+|------|----|:---:|------|
+| `text` | string | ✓ | 本文 |
+| `outputPath` | string |  | 保存先。省略時は base64 を返す |
+| `returnBase64` | boolean |  | 保存に加えて base64 も返す |
+| `fontPath` | string |  | 埋め込むフォント（日本語は必須） |
+| `fontSize` | number |  | 本文サイズ pt（既定 11、4〜96） |
+| `pageSize` | enum |  | A4/A3/A5/LETTER/LEGAL（既定 A4） |
+| `margin` | number |  | 余白 pt（既定 56、0〜300） |
+| `title` | string |  | タイトル（メタデータ＋冒頭見出し） |
+| `author` | string |  | 作成者（メタデータ） |
+
+### `create_markdown_pdf`
+
+Markdown → PDF。対応要素: 見出し / 段落 / 箇条書き・番号リスト / コードブロック / 引用 / 水平線 / 表。
+インライン装飾（`**bold**` など）は単一フォントのため **記号を除去して字面のみ** 反映します。
+
+引数は `text` の代わりに `markdown`（string, 必須）。その他は共通。
+
+### `create_table_pdf`
+
+ヘッダ + 行データ → 罫線付きの表 PDF。列幅は内容から自動算出、セル内は折り返し、改ページ時はヘッダを再描画。
+
+| 引数 | 型 | 必須 | 説明 |
+|------|----|:---:|------|
+| `headers` | string[] | ✓ | 列見出し |
+| `rows` | string[][] | ✓ | データ行（各行は headers と同数の列を推奨） |
+
+その他は共通引数。
+
+## 編集ツール（v0.2.0〜）
+
+既存 PDF に対する操作です。共通引数: `outputPath`（省略時は base64 返却）/ `returnBase64` /
+`allowBreakingSignatures`（署名済み PDF の編集続行フラグ、既定 false）。
+
+ページ指定は `"1,3-5,8-"` 形式（1 始まり。`-3` = 先頭から 3 まで、`8-` = 8 から最終まで）。
+
+| ツール | 主な引数 | 説明 |
+|--------|----------|------|
+| `set_metadata` | `inputPath`, `title` / `author` / `subject` / `keywords` / `creator` | 指定フィールドのみ更新、他は保持 |
+| `merge_pdfs` | `inputPaths: string[]` | 指定順に結合（2〜50 ファイル） |
+| `split_pdf` | `inputPath`, `ranges: string[]`, `outputDir`, `prefix?` | 範囲ごとに連番ファイルへ分割 |
+| `extract_pages` | `inputPath`, `pages` | 指定順を保持して抽出（並べ替えを兼ねる） |
+| `delete_pages` | `inputPath`, `pages` | ページ削除（全削除はエラー） |
+| `reorder_pages` | `inputPath`, `order: number[]` | 全ページの順列で並べ替え |
+| `rotate_pages` | `inputPath`, `rotation: 90\|180\|270`, `pages?` | 時計回りに回転（既存回転に加算） |
+
+> **署名について**: pdf-lib はファイル全体を再構築して保存するため、編集すると既存の電子署名は
+> 必ず無効化されます。署名（`/ByteRange`）を検知した場合は既定でエラーとし、
+> `allowBreakingSignatures: true` を指定したときのみ続行します。
+> 署名を保持する増分更新は将来対応（ロードマップ参照）。
+
+### 返り値（共通）
+
+```jsonc
+{
+  "path": "/abs/out.pdf",   // outputPath 指定時
+  "base64": "JVBERi0xLj...", // returnBase64 or outputPath 未指定時
+  "pageCount": 3,
+  "bytes": 91788,
+  "font": "NotoSansJP-Regular.otf"
+}
+```
+
+## テキスト抽出・検索について
+
+生成される PDF は **テキストの選択・コピー・全文検索が可能** です。
+埋め込みフォント使用時も pdf-lib が ToUnicode CMap（CID→Unicode の逆引き）を出力するため、
+`pdftotext` 等で本文を抽出できます。この性質は `tests/extract.test.ts` の回帰テストで担保しています
+（ToUnicode に `日 → U+65E5` のマッピングが含まれることを検証）。
+
+> 補足: 一部の PDF ビューア（poppler 系）は埋め込み CFF サブセットに対して
+> `Embedded font file may be invalid` という警告を表示することがありますが、
+> 表示・抽出・`qpdf --check` はいずれも正常で、実害はありません。
+
+## 既知の制約
+
+- **インライン装飾**: 太字・斜体などはサイズ/字面のみで、書体としては反映されません
+  （見出し/本文/太字を別フェイスで埋め分ける対応はロードマップ参照）。
+- **`.ttc` 非対応**: 単一フェイスへの抽出が必要です（上記参照）。
+- **サブセット名の接頭辞**: pdf-lib は慣習的な `ABCDEF+` 接頭辞を付けないため、
+  一部ツールがサブセットでないと誤認します（表示・抽出には無影響。PDF/A 厳密対応時の項目）。
+
+## ロードマップ
+
+- [x] 編集系 Tier A 第1波（メタデータ・ページ操作）— v0.2.0
+- [ ] 編集系 Tier A 第2波（しおり・注釈）
+- [ ] 編集系 Tier B（フォーム記入・フラット化 / 透かし / 添付ファイル / ページ番号スタンプ）
+- [ ] タグ付き PDF / PDF/UA 対応（スクリーンリーダ向けの構造タグ。抽出可否とは別レイヤの本格対応）
+- [ ] `.ttc` からのフェイス自動抽出（Node だけで完結）
+- [ ] 見出し用と本文用のフォント分け（太字フェイス埋め込み）
+- [ ] 画像埋め込み / ヘッダー・フッター
+- [ ] 署名を保持する増分更新・本文テキスト編集・タグ木保守（Tier C）
+- [ ] PDF/A 変換（サブセット命名の正規化を含む・外部ツール連携）
+
+## ライセンス
+
+MIT © shuji-bonji

package/dist/config.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Application Configuration
+ * バージョンは package.json から動的取得（config と package.json の不一致を防ぐ）
+ */
+/**
+ * Package information (dynamically loaded from package.json)
+ */
+export declare const PACKAGE_INFO: {
+    readonly name: string;
+    readonly version: string;
+};
+/**
+ * 環境変数キー
+ */
+export declare const ENV_KEYS: {
+    /** デフォルトで埋め込むフォントファイルのパス（.ttf / .otf） */
+    readonly DEFAULT_FONT: 'PDF_WRITER_FONT';
+};
+/**
+ * PDF 生成のデフォルト値
+ * 単位はすべて pt（1pt = 1/72 inch）
+ */
+export declare const DEFAULTS: {
+    /** ページサイズ名 */
+    readonly pageSize: 'A4';
+    /** 上下左右マージン */
+    readonly margin: 56;
+    /** 本文フォントサイズ */
+    readonly fontSize: 11;
+    /** 行間係数（fontSize に対する倍率。行送り = fontSize * lineHeight） */
+    readonly lineHeight: 1.45;
+    /** 段落間の追加余白 */
+    readonly paragraphGap: 6;
+};

package/dist/config.js

@@ -0,0 +1,38 @@
+/**
+ * Application Configuration
+ * バージョンは package.json から動的取得（config と package.json の不一致を防ぐ）
+ */
+import { createRequire } from 'module';
+const require = createRequire(import.meta.url);
+const packageJson = require('../package.json');
+/**
+ * Package information (dynamically loaded from package.json)
+ */
+export const PACKAGE_INFO = {
+    name: packageJson.name,
+    version: packageJson.version,
+};
+/**
+ * 環境変数キー
+ */
+export const ENV_KEYS = {
+    /** デフォルトで埋め込むフォントファイルのパス（.ttf / .otf） */
+    DEFAULT_FONT: 'PDF_WRITER_FONT',
+};
+/**
+ * PDF 生成のデフォルト値
+ * 単位はすべて pt（1pt = 1/72 inch）
+ */
+export const DEFAULTS = {
+    /** ページサイズ名 */
+    pageSize: 'A4',
+    /** 上下左右マージン */
+    margin: 56, // ≒ 20mm
+    /** 本文フォントサイズ */
+    fontSize: 11,
+    /** 行間係数（fontSize に対する倍率。行送り = fontSize * lineHeight） */
+    lineHeight: 1.45,
+    /** 段落間の追加余白 */
+    paragraphGap: 6,
+};
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAEvC,MAAM,OAAO,GAAG,aAAa,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,MAAM,WAAW,GAAG,OAAO,CAAC,iBAAiB,CAG5C,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,IAAI,EAAE,WAAW,CAAC,IAAI;IACtB,OAAO,EAAE,WAAW,CAAC,OAAO;CACpB,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,yCAAyC;IACzC,YAAY,EAAE,iBAAiB;CACvB,CAAC;AAEX;;;GAGG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,cAAc;IACd,QAAQ,EAAE,IAAI;IACd,eAAe;IACf,MAAM,EAAE,EAAE,EAAE,SAAS;IACrB,gBAAgB;IAChB,QAAQ,EAAE,EAAE;IACZ,wDAAwD;IACxD,UAAU,EAAE,IAAI;IAChB,eAAe;IACf,YAAY,EAAE,CAAC;CACP,CAAC"}

package/dist/constants.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Constants
+ * マジックナンバー・上限値を一元管理（根拠はコメントで明示）
+ */
+/**
+ * 標準ページサイズ [width, height]（pt, 縦向き）
+ * ISO 216 (A系) と US サイズ
+ */
+export declare const PAGE_SIZES: {
+    readonly A4: readonly [595.28, 841.89];
+    readonly A3: readonly [841.89, 1190.55];
+    readonly A5: readonly [419.53, 595.28];
+    readonly LETTER: readonly [612, 792];
+    readonly LEGAL: readonly [612, 1008];
+};
+export type PageSizeName = keyof typeof PAGE_SIZES;
+/**
+ * 入力バリデーションの上限値
+ */
+export declare const LIMITS: {
+    /** フォントサイズの範囲（pt） */
+    readonly FONT_SIZE_MIN: 4;
+    readonly FONT_SIZE_MAX: 96;
+    /** マージンの範囲（pt）。0 は全面利用、上限はページの暴走防止 */
+    readonly MARGIN_MIN: 0;
+    readonly MARGIN_MAX: 300;
+    /** 1 回の生成で受け付ける本文テキストの最大長（文字）。DoS/巨大PDF防止 */
+    readonly TEXT_MAX_LENGTH: 500000;
+    /** 表の最大列数・行数。レイアウト破綻と巨大化の防止 */
+    readonly TABLE_MAX_COLS: 40;
+    readonly TABLE_MAX_ROWS: 5000;
+    /** merge の最大入力ファイル数。暴走防止 */
+    readonly MERGE_MAX_INPUTS: 50;
+    /** split の最大分割数。暴走防止 */
+    readonly SPLIT_MAX_PARTS: 200;
+};
+/** rotate_pages が受け付ける回転角（時計回り・度） */
+export declare const ROTATION_ANGLES: readonly [90, 180, 270];
+/**
+ * フォントファイルのマジックナンバー（先頭 4 bytes）
+ * .ttc（TrueTypeCollection）は pdf-lib がサブセット化できないため検知して弾く
+ */
+export declare const FONT_MAGIC: {
+    /** 'ttcf' — TrueType Collection */
+    readonly TTC: 'ttcf';
+};

package/dist/constants.js

@@ -0,0 +1,46 @@
+/**
+ * Constants
+ * マジックナンバー・上限値を一元管理（根拠はコメントで明示）
+ */
+/**
+ * 標準ページサイズ [width, height]（pt, 縦向き）
+ * ISO 216 (A系) と US サイズ
+ */
+export const PAGE_SIZES = {
+    A4: [595.28, 841.89],
+    A3: [841.89, 1190.55],
+    A5: [419.53, 595.28],
+    LETTER: [612, 792],
+    LEGAL: [612, 1008],
+};
+/**
+ * 入力バリデーションの上限値
+ */
+export const LIMITS = {
+    /** フォントサイズの範囲（pt） */
+    FONT_SIZE_MIN: 4,
+    FONT_SIZE_MAX: 96,
+    /** マージンの範囲（pt）。0 は全面利用、上限はページの暴走防止 */
+    MARGIN_MIN: 0,
+    MARGIN_MAX: 300,
+    /** 1 回の生成で受け付ける本文テキストの最大長（文字）。DoS/巨大PDF防止 */
+    TEXT_MAX_LENGTH: 500_000,
+    /** 表の最大列数・行数。レイアウト破綻と巨大化の防止 */
+    TABLE_MAX_COLS: 40,
+    TABLE_MAX_ROWS: 5_000,
+    /** merge の最大入力ファイル数。暴走防止 */
+    MERGE_MAX_INPUTS: 50,
+    /** split の最大分割数。暴走防止 */
+    SPLIT_MAX_PARTS: 200,
+};
+/** rotate_pages が受け付ける回転角（時計回り・度） */
+export const ROTATION_ANGLES = [90, 180, 270];
+/**
+ * フォントファイルのマジックナンバー（先頭 4 bytes）
+ * .ttc（TrueTypeCollection）は pdf-lib がサブセット化できないため検知して弾く
+ */
+export const FONT_MAGIC = {
+    /** 'ttcf' — TrueType Collection */
+    TTC: 'ttcf',
+};
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,EAAE,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC;IACpB,EAAE,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC;IACrB,EAAE,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;IAClB,KAAK,EAAE,CAAC,GAAG,EAAE,IAAI,CAAC;CACV,CAAC;AAIX;;GAEG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,qBAAqB;IACrB,aAAa,EAAE,CAAC;IAChB,aAAa,EAAE,EAAE;IACjB,sCAAsC;IACtC,UAAU,EAAE,CAAC;IACb,UAAU,EAAE,GAAG;IACf,6CAA6C;IAC7C,eAAe,EAAE,OAAO;IACxB,+BAA+B;IAC/B,cAAc,EAAE,EAAE;IAClB,cAAc,EAAE,KAAK;IACrB,4BAA4B;IAC5B,gBAAgB,EAAE,EAAE;IACpB,wBAAwB;IACxB,eAAe,EAAE,GAAG;CACZ,CAAC;AAEX,qCAAqC;AACrC,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,EAAE,EAAE,GAAG,EAAE,GAAG,CAAU,CAAC;AAEvD;;;GAGG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,mCAAmC;IACnC,GAAG,EAAE,MAAM;CACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+/**
+ * pdf-writer-mcp — MCP server entry
+ * テキスト / Markdown / 表データから PDF を生成する。
+ */
+export {};

package/dist/index.js

@@ -0,0 +1,52 @@
+#!/usr/bin/env node
+/**
+ * pdf-writer-mcp — MCP server entry
+ * テキスト / Markdown / 表データから PDF を生成する。
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { PACKAGE_INFO } from './config.js';
+import { tools } from './tools/definitions.js';
+import { toolHandlers } from './tools/handlers.js';
+import { logger } from './utils/logger.js';
+const server = new Server({
+    name: PACKAGE_INFO.name,
+    version: PACKAGE_INFO.version,
+}, {
+    capabilities: { tools: {} },
+});
+server.setRequestHandler(ListToolsRequestSchema, async () => ({
+    tools,
+}));
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    try {
+        const handler = toolHandlers[name];
+        if (!handler) {
+            throw new Error(`Unknown tool: ${name}`);
+        }
+        const result = await handler(args);
+        return {
+            content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        logger.error(name, message, error instanceof Error ? error : undefined);
+        return {
+            content: [{ type: 'text', text: JSON.stringify({ error: message }, null, 2) }],
+            isError: true,
+        };
+    }
+});
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    logger.info(PACKAGE_INFO.name, `v${PACKAGE_INFO.version} started (stdio)`);
+}
+main().catch((error) => {
+    logger.error('Startup', 'Failed to start server', error instanceof Error ? error : undefined);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;GAGG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EACL,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE3C,MAAM,MAAM,GAAG,IAAI,MAAM,CACvB;IACE,IAAI,EAAE,YAAY,CAAC,IAAI;IACvB,OAAO,EAAE,YAAY,CAAC,OAAO;CAC9B,EACD;IACE,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE;CAC5B,CACF,CAAC;AAEF,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;IAC5D,KAAK;CACN,CAAC,CAAC,CAAC;AAEJ,MAAM,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;IAChE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAEjD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;QACnC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC;QAC3C,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;QACnC,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;SACnE,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QACxE,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;YAC9E,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,KAAK,UAAU,IAAI;IACjB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,IAAI,YAAY,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAC7E,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,MAAM,CAAC,KAAK,CAAC,SAAS,EAAE,wBAAwB,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAC9F,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/services/builder.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Builder
+ * 「doc 生成 → フォント埋め込み → レイアウトエンジン → 描画 → 保存」の共通フロー。
+ * 各ツールハンドラは render コールバックだけ差し替えて使う。
+ */
+import type { CommonCreateOptions, CreateResult } from '../types/index.js';
+import { type LoadedFont } from './font-manager.js';
+import { LayoutEngine } from './layout.js';
+export type RenderFn = (engine: LayoutEngine, loaded: LoadedFont) => void;
+export declare function buildPdf(opts: CommonCreateOptions, render: RenderFn): Promise<CreateResult>;

package/dist/services/builder.js

@@ -0,0 +1,40 @@
+/**
+ * Builder
+ * 「doc 生成 → フォント埋め込み → レイアウトエンジン → 描画 → 保存」の共通フロー。
+ * 各ツールハンドラは render コールバックだけ差し替えて使う。
+ */
+import { PDFDocument, rgb } from 'pdf-lib';
+import { PAGE_SIZES } from '../constants.js';
+import { DEFAULTS } from '../config.js';
+import { loadFont } from './font-manager.js';
+import { LayoutEngine } from './layout.js';
+import { finalizePdf } from './output.js';
+import { assertRenderable } from './renderers/text.js';
+export async function buildPdf(opts, render) {
+    const doc = await PDFDocument.create();
+    const loaded = await loadFont(doc, opts.fontPath);
+    const pageName = opts.pageSize ?? DEFAULTS.pageSize;
+    const [pageWidth, pageHeight] = PAGE_SIZES[pageName];
+    const fontSize = opts.fontSize ?? DEFAULTS.fontSize;
+    const engine = new LayoutEngine(doc, {
+        pageWidth,
+        pageHeight,
+        margin: opts.margin ?? DEFAULTS.margin,
+        font: loaded.font,
+        fontSize,
+        lineHeight: DEFAULTS.lineHeight,
+    });
+    // タイトルが指定されていれば本文冒頭に見出しとして描画（メタデータにも finalizePdf で設定）
+    if (opts.title) {
+        assertRenderable(opts.title, loaded);
+        engine.drawParagraph(opts.title, {
+            size: fontSize + 7,
+            color: rgb(0, 0, 0),
+            lineHeight: 1.2,
+            spaceAfter: 12,
+        });
+    }
+    render(engine, loaded);
+    return finalizePdf(doc, opts, loaded.name);
+}
+//# sourceMappingURL=builder.js.map

package/dist/services/builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.js","sourceRoot":"","sources":["../../src/services/builder.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAqB,MAAM,iBAAiB,CAAC;AAChE,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAExC,OAAO,EAAE,QAAQ,EAAmB,MAAM,mBAAmB,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAIvD,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,IAAyB,EACzB,MAAgB;IAEhB,MAAM,GAAG,GAAG,MAAM,WAAW,CAAC,MAAM,EAAE,CAAC;IACvC,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IAElD,MAAM,QAAQ,GAAiB,IAAI,CAAC,QAAQ,IAAK,QAAQ,CAAC,QAAyB,CAAC;IACpF,MAAM,CAAC,SAAS,EAAE,UAAU,CAAC,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;IACrD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,QAAQ,CAAC;IAEpD,MAAM,MAAM,GAAG,IAAI,YAAY,CAAC,GAAG,EAAE;QACnC,SAAS;QACT,UAAU;QACV,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,QAAQ,CAAC,MAAM;QACtC,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,QAAQ;QACR,UAAU,EAAE,QAAQ,CAAC,UAAU;KAChC,CAAC,CAAC;IAEH,sDAAsD;IACtD,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QACf,gBAAgB,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QACrC,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,KAAK,EAAE;YAC/B,IAAI,EAAE,QAAQ,GAAG,CAAC;YAClB,KAAK,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;YACnB,UAAU,EAAE,GAAG;YACf,UAAU,EAAE,EAAE;SACf,CAAC,CAAC;IACL,CAAC;IAED,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEvB,OAAO,WAAW,CAAC,GAAG,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;AAC7C,CAAC"}

package/dist/services/editor.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Editor
+ * 既存 PDF の編集（Tier A: メタデータ・ページ操作）を担う。
+ *
+ * create 系（builder → font → layout → renderer）とはフローが異なり、
+ *   読込（loadForEdit: 署名ガード込み）→ 操作 → 保存（saveEdited）
+ * の 3 段で完結する。
+ *
+ * 署名保全について（specs/05 §3-1）:
+ *   pdf-lib の save() はファイル全体を再構築するため、既存の電子署名は必ず無効化される。
+ *   署名（/ByteRange）を検知した場合は既定でエラーとし、明示フラグ
+ *   allowBreakingSignatures: true があるときのみ続行する。
+ *   署名を保持する増分更新（incremental_save）は Tier C の課題。
+ */
+import type { CommonEditOptions, EditResult, SetMetadataArgs, SplitResult } from '../types/index.js';
+/** 入力バイト列に電子署名（/ByteRange）が含まれるかの軽量検査 */
+export declare function containsSignature(bytes: Uint8Array): boolean;
+export declare function setMetadata(args: SetMetadataArgs): Promise<EditResult>;
+export declare function mergePdfs(inputPaths: string[], opts: CommonEditOptions): Promise<EditResult>;
+export declare function extractPages(inputPath: string, pages: string, opts: CommonEditOptions): Promise<EditResult>;
+export declare function deletePages(inputPath: string, pages: string, opts: CommonEditOptions): Promise<EditResult>;
+export declare function reorderPages(inputPath: string, order: number[], opts: CommonEditOptions): Promise<EditResult>;
+export declare function rotatePages(inputPath: string, rotation: number, pages: string | undefined, opts: CommonEditOptions): Promise<EditResult>;
+export declare function splitPdf(inputPath: string, ranges: string[], outputDir: string, prefix: string | undefined, opts: CommonEditOptions): Promise<SplitResult>;