@shibayama/pdgkit 0.1.0 → 0.1.1

package/README.md

@@ -154,48 +154,60 @@ pdgkit の主な使い方は、AI に日本語で頼んで図を作らせるこ
 
 #### ステップ 2: あとは日本語で頼むだけ
 
-「準備完了」と返ってきたら、作りたい図を言葉で伝えるだけです。図種も出力形式も、指定しなければ AI が内容から選びます。
+「準備完了」と返ってきたら、作りたい図を言葉で伝えるだけです。図種も出力形式も、指定しなければ AI が内容から選びます。下はそのまま使える依頼文の例です（コードボックス 1 つが 1 つの依頼。コピーして送ってください）。
 
-構成・装置(ブロック図になりやすい):
+**構成・装置（ブロック図になりやすい）** — 何が何を含み、何がどこへ流れるかを書く:
 
 ```text
-制御装置が CPU、メモリ、I/O インターフェースを内蔵し、I/O インターフェースが外部機器へ信号を送る図を描いて
-センサ端末の構成図を描いて。検出部（温度センサと加速度センサ）、処理部（取得部と判定部）、通信部を備え、検出部→処理部→通信部の順にデータが流れ、通信部からゲートウェイへ無線送信する。日英併記で
-制御部・駆動部・センサ部・対象装置から成る制御ループの図。指令で駆動し、センサが状態を検出して制御部へフィードバック
+制御装置の構成図を描いて。制御装置は CPU、メモリ、I/O インターフェースを内蔵し、I/O インターフェースが外部機器へ信号を送る。
 ```
 
-処理・方法(フローチャートになりやすい):
+```text
+センサ端末の構成図を描いて。検出部（温度センサと加速度センサ）、処理部（取得部と判定部）、通信部を備え、検出部から処理部、処理部から通信部の順にデータが流れ、通信部からゲートウェイへ無線送信する。日英併記で。
+```
 
 ```text
-画像取得→前処理→特徴抽出→欠陥あり?（Yes/No）→警告出力／正常記録→終了 のフローチャートにして
-ログイン処理のフローを描いて。入力→認証成功?で分岐、失敗ならリトライ、成功ならホームへ
+制御ループの図を描いて。制御システムは制御部・駆動部・センサ部・対象装置から成り、制御部が指令で駆動部を動かし、駆動部が対象装置を駆動し、センサ部が状態を検出して制御部へフィードバックする。
 ```
 
-状態・やりとり:
+**処理・方法（フローチャートになりやすい）** — 手順と分岐・ループを書く:
+
+```text
+検査方法のフローチャートを描いて。画像取得→前処理→特徴抽出→欠陥あり? と進み、欠陥ありなら警告出力、無しなら正常記録、いずれも終了へ。
+```
 
 ```text
-待機・動作中・エラーの状態遷移図。起動で動作中、停止で待機、異常でエラー、リセットで待機に戻る
-クライアントとサーバの、認証からリソース取得までのシーケンス図
+ログイン処理のフローチャートを描いて。入力→認証成功? で分岐し、成功ならホーム画面へ、失敗なら入力へ戻って再試行する。
 ```
 
-クレーム文からの変換:
+**状態・やりとり:**
 
 ```text
-次の装置クレームを構成図にして: 撮像部と、前記撮像部が取得した画像を処理する画像処理部と、処理結果を表示する表示部と、を備える撮像装置。
-この方法クレームをフローチャートにして: 画像を取得するステップと、特徴量を抽出するステップと、欠陥の有無を判定するステップと、…を含む検査方法。
+装置の状態遷移図を描いて。待機・動作中・エラーの3状態があり、起動で動作中、停止で待機、異常でエラー、リセットで待機に戻る。
 ```
 
-出力形式の指定(続けて頼める):
+```text
+クライアントとサーバの、認証からリソース取得までのシーケンス図を描いて。認証要求→トークン応答→リソース要求→リソース応答の順。
+```
+
+**クレーム文からの変換** — クレーム本文をそのまま貼って図種を指定する:
 
 ```text
-さっきの図を PDF にして（出願用）
-編集できる PPTX にして
-PowerPoint のスライドにして
-PNG で出して
-日英併記で出して
-符号表（符号の説明）も Markdown で出して
+次の装置クレームを構成図にして。「撮像部と、前記撮像部が取得した画像を処理する画像処理部と、処理結果を表示する表示部と、を備える撮像装置。」
 ```
 
+```text
+次の方法クレームをフローチャートにして。「画像を取得するステップと、前記画像から特徴量を抽出するステップと、欠陥の有無を判定するステップと、欠陥が有る場合に警告を出力するステップと、を含む検査方法。」
+```
+
+**出力形式を指定したいとき** — 続けて一言頼むだけです（指定しなければ SVG）:
+
+- 出願用の PDF にする → 「さっきの図を PDF にして」
+- 編集できる PowerPoint にする → 「編集できる PPTX にして」
+- 画像（PNG）にする → 「PNG で出して」
+- 日英併記にする → 「日英併記で出して」
+- 符号表（符号の説明）も出す → 「符号表も Markdown で出して」
+
 > うまくいかないときは、AI に「`npx @shibayama/pdgkit guide` をもう一度読んで、`npx @shibayama/pdgkit validate` のエラーが無くなるまで直して」と伝えてください。PNG / PDF / PPTX は環境により失敗することがありますが、SVG は確実に出ます。
 
 ### ライブラリとして（Node / TypeScript）
@@ -500,12 +512,18 @@ command = "pdgkit-mcp"
 
 #### 3. 使う
 
-あとは普通に日本語で頼むだけです。例:
+あとは普通に日本語で頼むだけです（1 つずつ送れます）。例:
+
+```text
+制御装置の構成図を描いて。制御装置は CPU、メモリ、I/O インターフェースを内蔵し、I/O インターフェースが外部機器へ信号を送る。
+```
+
+```text
+さっきの図を PNG で見せて。
+```
 
 ```text
-制御装置が CPU、メモリ、I/O インターフェースを内蔵し、I/O インターフェースが外部機器へ信号を送るブロック図を描いて
-さっきの図を PNG で見せて
-編集できる PPTX にして
+編集できる PPTX にして。
 ```
 
 Claude は内容に応じて次のツールを使い分けます（あなたが意識する必要はありません）。
@@ -655,7 +673,7 @@ src/core  純粋・依存ゼロ（PatentDSL から移植、唯一の真実源）
 
 ## 本家との忠実性
 
-- [src/core](src/core) は PatentDSL のソースをそのまま移植している（唯一の変更は、コンテンツボックス計算で再利用するための `estimateTextWidth` の `export` 追加のみ）。
+- [src/core](src/core) は PatentDSL のソースを基に移植している。本家からの変更は次の 2 点のみ: (1) コンテンツボックス計算で再利用するための `estimateTextWidth` の `export` 追加、(2) フローチャート・状態遷移図で前のランクへ戻る辺（ループ・リトライ）を側方のレーンへ回し、前進線との重なりを避けるレイアウト改良。
 - 本家のテスト（構文解析・レイアウト・レイアウト回帰・ラベル配置）を移植し、すべて合格している。
 - SVG の切り出し余白（3 単位）・表示寸法（長辺 1600px 以上）は本家の定数と一致する。
 
@@ -664,7 +682,7 @@ src/core  純粋・依存ゼロ（PatentDSL から移植、唯一の真実源）
 ```bash
 npm install
 npm run typecheck
-npm test          # vitest（コア移植 + Node 層、計 126 テスト）
+npm test          # vitest（コア移植 + Node 層、計 137 テスト）
 npm run cli -- render --sample block -o /tmp/x.svg
 npm run mcp       # MCP サーバを起動
 npm run build     # tsup で dist/（ESM + CJS + 型定義）を生成

package/dist/core.cjs

@@ -228,6 +228,8 @@ var THICK_ARROW_TERMINAL_CLEARANCE = 5.4;
 var VERTICAL_PORT_RATIO = 0.25;
 var PORT_STUB = 6;
 var MAX_ROUTE_LANES = 18;
+var LOOP_LANE_GAP = 10;
+var LOOP_LANE_STEP = 7;
 var EPS = 1e-3;
 function layout(doc) {
   switch (doc.kind) {
@@ -407,7 +409,6 @@ function layoutFlow(doc) {
   const positions = /* @__PURE__ */ new Map();
   const sortedRanks = [...byRank.keys()].sort((a, b) => a - b);
   let y = MARGIN;
-  let maxX = 0;
   for (const r of sortedRanks) {
     const lane = byRank.get(r);
     const widths = lane.map((id) => shapeOf(id) === "diamond" ? NODE_W * 1.2 : NODE_W);
@@ -419,7 +420,6 @@ function layoutFlow(doc) {
       positions.set(lane[i], { x, y, w: widths[i], h: NODE_H });
       x += widths[i] + H_GAP;
     }
-    if (x > maxX) maxX = x;
     y += NODE_H + V_GAP;
   }
   for (const id of ids) {
@@ -439,7 +439,8 @@ function layoutFlow(doc) {
     });
   }
   const edges = makeEdges(doc.edges, positions);
-  return { nodes: placed, edges, width: maxX + MARGIN, height: y + MARGIN, kind: "flow" };
+  const { width, height } = flowExtent(placed, edges);
+  return { nodes: placed, edges, width, height, kind: "flow" };
 }
 function layoutState(doc) {
   const { byRank } = computeRanks(doc);
@@ -451,7 +452,6 @@ function layoutState(doc) {
   const positions = /* @__PURE__ */ new Map();
   const sortedRanks = [...byRank.keys()].sort((a, b) => a - b);
   let y = MARGIN;
-  let maxX = 0;
   for (const r of sortedRanks) {
     const lane = byRank.get(r);
     const widths = lane.map((id) => shapeOf(id) === "circle" ? 6 : NODE_W);
@@ -463,7 +463,6 @@ function layoutState(doc) {
       positions.set(lane[i], { x, y: y + (NODE_H - heights[i]) / 2, w: widths[i], h: heights[i] });
       x += widths[i] + H_GAP;
     }
-    if (x > maxX) maxX = x;
     y += NODE_H + V_GAP;
   }
   for (const id of doc.nodes.keys()) {
@@ -483,7 +482,8 @@ function layoutState(doc) {
     });
   }
   const edges = makeEdges(doc.edges, positions);
-  return { nodes: placed, edges, width: maxX + MARGIN, height: y + MARGIN, kind: "state" };
+  const { width, height } = flowExtent(placed, edges);
+  return { nodes: placed, edges, width, height, kind: "state" };
 }
 function layoutSeq(doc) {
   const seen = /* @__PURE__ */ new Set();
@@ -602,21 +602,50 @@ function computeRanks(doc) {
   return { byRank };
 }
 function makeEdges(srcEdges, positions) {
-  return srcEdges.map((e) => {
+  const boxes = [...positions.values()];
+  const rightLimit = boxes.length ? Math.max(...boxes.map((b) => b.x + b.w)) : MARGIN;
+  const feedback = srcEdges.map((e, index) => ({ index, a: positions.get(e.from), b: positions.get(e.to) })).filter((r) => !!r.a && !!r.b && r.b.y + r.b.h <= r.a.y + EPS).sort((p, q) => feedbackSpan(p.a, p.b) - feedbackSpan(q.a, q.b));
+  const laneOf = /* @__PURE__ */ new Map();
+  feedback.forEach((r, nest) => laneOf.set(r.index, nest));
+  return srcEdges.map((e, index) => {
     const a = positions.get(e.from);
     const b = positions.get(e.to);
     if (!a || !b) {
       return { from: e.from, to: e.to, points: [], label: e.label, op: e.op };
     }
-    return {
-      from: e.from,
-      to: e.to,
-      points: orthogonalRoute(a, b),
-      label: e.label,
-      op: e.op
-    };
+    const nest = laneOf.get(index);
+    const points = nest === void 0 ? orthogonalRoute(a, b) : feedbackRoute(a, b, rightLimit + LOOP_LANE_GAP + nest * LOOP_LANE_STEP);
+    return { from: e.from, to: e.to, points, label: e.label, op: e.op };
   });
 }
+function feedbackSpan(a, b) {
+  return a.y + a.h / 2 - (b.y + b.h / 2);
+}
+function feedbackRoute(a, b, laneX) {
+  const ay = a.y + a.h / 2;
+  const by = b.y + b.h / 2;
+  return [
+    [a.x + a.w, ay],
+    [laneX, ay],
+    [laneX, by],
+    [b.x + b.w, by]
+  ];
+}
+function flowExtent(placed, edges) {
+  let maxX = MARGIN;
+  let maxY = MARGIN;
+  for (const n of placed) {
+    if (n.x + n.w > maxX) maxX = n.x + n.w;
+    if (n.y + n.h > maxY) maxY = n.y + n.h;
+  }
+  for (const e of edges) {
+    for (const [x, y] of e.points) {
+      if (x > maxX) maxX = x;
+      if (y > maxY) maxY = y;
+    }
+  }
+  return { width: maxX + MARGIN, height: maxY + MARGIN };
+}
 function hasLinearChildFlow(children, edges, childMap) {
   const childSet = new Set(children);
   const pairs = /* @__PURE__ */ new Set();

package/dist/core.js

@@ -189,6 +189,8 @@ var THICK_ARROW_TERMINAL_CLEARANCE = 5.4;
 var VERTICAL_PORT_RATIO = 0.25;
 var PORT_STUB = 6;
 var MAX_ROUTE_LANES = 18;
+var LOOP_LANE_GAP = 10;
+var LOOP_LANE_STEP = 7;
 var EPS = 1e-3;
 function layout(doc) {
   switch (doc.kind) {
@@ -368,7 +370,6 @@ function layoutFlow(doc) {
   const positions = /* @__PURE__ */ new Map();
   const sortedRanks = [...byRank.keys()].sort((a, b) => a - b);
   let y = MARGIN;
-  let maxX = 0;
   for (const r of sortedRanks) {
     const lane = byRank.get(r);
     const widths = lane.map((id) => shapeOf(id) === "diamond" ? NODE_W * 1.2 : NODE_W);
@@ -380,7 +381,6 @@ function layoutFlow(doc) {
       positions.set(lane[i], { x, y, w: widths[i], h: NODE_H });
       x += widths[i] + H_GAP;
     }
-    if (x > maxX) maxX = x;
     y += NODE_H + V_GAP;
   }
   for (const id of ids) {
@@ -400,7 +400,8 @@ function layoutFlow(doc) {
     });
   }
   const edges = makeEdges(doc.edges, positions);
-  return { nodes: placed, edges, width: maxX + MARGIN, height: y + MARGIN, kind: "flow" };
+  const { width, height } = flowExtent(placed, edges);
+  return { nodes: placed, edges, width, height, kind: "flow" };
 }
 function layoutState(doc) {
   const { byRank } = computeRanks(doc);
@@ -412,7 +413,6 @@ function layoutState(doc) {
   const positions = /* @__PURE__ */ new Map();
   const sortedRanks = [...byRank.keys()].sort((a, b) => a - b);
   let y = MARGIN;
-  let maxX = 0;
   for (const r of sortedRanks) {
     const lane = byRank.get(r);
     const widths = lane.map((id) => shapeOf(id) === "circle" ? 6 : NODE_W);
@@ -424,7 +424,6 @@ function layoutState(doc) {
       positions.set(lane[i], { x, y: y + (NODE_H - heights[i]) / 2, w: widths[i], h: heights[i] });
       x += widths[i] + H_GAP;
     }
-    if (x > maxX) maxX = x;
     y += NODE_H + V_GAP;
   }
   for (const id of doc.nodes.keys()) {
@@ -444,7 +443,8 @@ function layoutState(doc) {
     });
   }
   const edges = makeEdges(doc.edges, positions);
-  return { nodes: placed, edges, width: maxX + MARGIN, height: y + MARGIN, kind: "state" };
+  const { width, height } = flowExtent(placed, edges);
+  return { nodes: placed, edges, width, height, kind: "state" };
 }
 function layoutSeq(doc) {
   const seen = /* @__PURE__ */ new Set();
@@ -563,21 +563,50 @@ function computeRanks(doc) {
   return { byRank };
 }
 function makeEdges(srcEdges, positions) {
-  return srcEdges.map((e) => {
+  const boxes = [...positions.values()];
+  const rightLimit = boxes.length ? Math.max(...boxes.map((b) => b.x + b.w)) : MARGIN;
+  const feedback = srcEdges.map((e, index) => ({ index, a: positions.get(e.from), b: positions.get(e.to) })).filter((r) => !!r.a && !!r.b && r.b.y + r.b.h <= r.a.y + EPS).sort((p, q) => feedbackSpan(p.a, p.b) - feedbackSpan(q.a, q.b));
+  const laneOf = /* @__PURE__ */ new Map();
+  feedback.forEach((r, nest) => laneOf.set(r.index, nest));
+  return srcEdges.map((e, index) => {
     const a = positions.get(e.from);
     const b = positions.get(e.to);
     if (!a || !b) {
       return { from: e.from, to: e.to, points: [], label: e.label, op: e.op };
     }
-    return {
-      from: e.from,
-      to: e.to,
-      points: orthogonalRoute(a, b),
-      label: e.label,
-      op: e.op
-    };
+    const nest = laneOf.get(index);
+    const points = nest === void 0 ? orthogonalRoute(a, b) : feedbackRoute(a, b, rightLimit + LOOP_LANE_GAP + nest * LOOP_LANE_STEP);
+    return { from: e.from, to: e.to, points, label: e.label, op: e.op };
   });
 }
+function feedbackSpan(a, b) {
+  return a.y + a.h / 2 - (b.y + b.h / 2);
+}
+function feedbackRoute(a, b, laneX) {
+  const ay = a.y + a.h / 2;
+  const by = b.y + b.h / 2;
+  return [
+    [a.x + a.w, ay],
+    [laneX, ay],
+    [laneX, by],
+    [b.x + b.w, by]
+  ];
+}
+function flowExtent(placed, edges) {
+  let maxX = MARGIN;
+  let maxY = MARGIN;
+  for (const n of placed) {
+    if (n.x + n.w > maxX) maxX = n.x + n.w;
+    if (n.y + n.h > maxY) maxY = n.y + n.h;
+  }
+  for (const e of edges) {
+    for (const [x, y] of e.points) {
+      if (x > maxX) maxX = x;
+      if (y > maxY) maxY = y;
+    }
+  }
+  return { width: maxX + MARGIN, height: maxY + MARGIN };
+}
 function hasLinearChildFlow(children, edges, childMap) {
   const childSet = new Set(children);
   const pairs = /* @__PURE__ */ new Set();

package/dist/index.cjs

@@ -251,6 +251,8 @@ var THICK_ARROW_TERMINAL_CLEARANCE = 5.4;
 var VERTICAL_PORT_RATIO = 0.25;
 var PORT_STUB = 6;
 var MAX_ROUTE_LANES = 18;
+var LOOP_LANE_GAP = 10;
+var LOOP_LANE_STEP = 7;
 var EPS = 1e-3;
 function layout(doc) {
   switch (doc.kind) {
@@ -430,7 +432,6 @@ function layoutFlow(doc) {
   const positions = /* @__PURE__ */ new Map();
   const sortedRanks = [...byRank.keys()].sort((a, b) => a - b);
   let y = MARGIN;
-  let maxX = 0;
   for (const r of sortedRanks) {
     const lane = byRank.get(r);
     const widths = lane.map((id) => shapeOf(id) === "diamond" ? NODE_W * 1.2 : NODE_W);
@@ -442,7 +443,6 @@ function layoutFlow(doc) {
       positions.set(lane[i], { x, y, w: widths[i], h: NODE_H });
       x += widths[i] + H_GAP;
     }
-    if (x > maxX) maxX = x;
     y += NODE_H + V_GAP;
   }
   for (const id of ids) {
@@ -462,7 +462,8 @@ function layoutFlow(doc) {
     });
   }
   const edges = makeEdges(doc.edges, positions);
-  return { nodes: placed, edges, width: maxX + MARGIN, height: y + MARGIN, kind: "flow" };
+  const { width, height } = flowExtent(placed, edges);
+  return { nodes: placed, edges, width, height, kind: "flow" };
 }
 function layoutState(doc) {
   const { byRank } = computeRanks(doc);
@@ -474,7 +475,6 @@ function layoutState(doc) {
   const positions = /* @__PURE__ */ new Map();
   const sortedRanks = [...byRank.keys()].sort((a, b) => a - b);
   let y = MARGIN;
-  let maxX = 0;
   for (const r of sortedRanks) {
     const lane = byRank.get(r);
     const widths = lane.map((id) => shapeOf(id) === "circle" ? 6 : NODE_W);
@@ -486,7 +486,6 @@ function layoutState(doc) {
       positions.set(lane[i], { x, y: y + (NODE_H - heights[i]) / 2, w: widths[i], h: heights[i] });
       x += widths[i] + H_GAP;
     }
-    if (x > maxX) maxX = x;
     y += NODE_H + V_GAP;
   }
   for (const id of doc.nodes.keys()) {
@@ -506,7 +505,8 @@ function layoutState(doc) {
     });
   }
   const edges = makeEdges(doc.edges, positions);
-  return { nodes: placed, edges, width: maxX + MARGIN, height: y + MARGIN, kind: "state" };
+  const { width, height } = flowExtent(placed, edges);
+  return { nodes: placed, edges, width, height, kind: "state" };
 }
 function layoutSeq(doc) {
   const seen = /* @__PURE__ */ new Set();
@@ -625,21 +625,50 @@ function computeRanks(doc) {
   return { byRank };
 }
 function makeEdges(srcEdges, positions) {
-  return srcEdges.map((e) => {
+  const boxes = [...positions.values()];
+  const rightLimit = boxes.length ? Math.max(...boxes.map((b) => b.x + b.w)) : MARGIN;
+  const feedback = srcEdges.map((e, index) => ({ index, a: positions.get(e.from), b: positions.get(e.to) })).filter((r) => !!r.a && !!r.b && r.b.y + r.b.h <= r.a.y + EPS).sort((p, q) => feedbackSpan(p.a, p.b) - feedbackSpan(q.a, q.b));
+  const laneOf = /* @__PURE__ */ new Map();
+  feedback.forEach((r, nest) => laneOf.set(r.index, nest));
+  return srcEdges.map((e, index) => {
     const a = positions.get(e.from);
     const b = positions.get(e.to);
     if (!a || !b) {
       return { from: e.from, to: e.to, points: [], label: e.label, op: e.op };
     }
-    return {
-      from: e.from,
-      to: e.to,
-      points: orthogonalRoute(a, b),
-      label: e.label,
-      op: e.op
-    };
+    const nest = laneOf.get(index);
+    const points = nest === void 0 ? orthogonalRoute(a, b) : feedbackRoute(a, b, rightLimit + LOOP_LANE_GAP + nest * LOOP_LANE_STEP);
+    return { from: e.from, to: e.to, points, label: e.label, op: e.op };
   });
 }
+function feedbackSpan(a, b) {
+  return a.y + a.h / 2 - (b.y + b.h / 2);
+}
+function feedbackRoute(a, b, laneX) {
+  const ay = a.y + a.h / 2;
+  const by = b.y + b.h / 2;
+  return [
+    [a.x + a.w, ay],
+    [laneX, ay],
+    [laneX, by],
+    [b.x + b.w, by]
+  ];
+}
+function flowExtent(placed, edges) {
+  let maxX = MARGIN;
+  let maxY = MARGIN;
+  for (const n of placed) {
+    if (n.x + n.w > maxX) maxX = n.x + n.w;
+    if (n.y + n.h > maxY) maxY = n.y + n.h;
+  }
+  for (const e of edges) {
+    for (const [x, y] of e.points) {
+      if (x > maxX) maxX = x;
+      if (y > maxY) maxY = y;
+    }
+  }
+  return { width: maxX + MARGIN, height: maxY + MARGIN };
+}
 function hasLinearChildFlow(children, edges, childMap) {
   const childSet = new Set(children);
   const pairs = /* @__PURE__ */ new Set();
@@ -3500,7 +3529,7 @@ async function renderToPptx(source, opts = {}) {
 }
 
 // src/node/index.ts
-var VERSION = "0.1.0";
+var VERSION = "0.1.1";
 function toSvgString(source, lang = "ja") {
   return renderToSvg(source, { lang }).svg;
 }

package/dist/index.d.cts

@@ -1,21 +1,16 @@
 import { Lang, DiagramKind, Diagnostic } from './core.cjs';
 export { Bilingual, Box, Containment, Doc, Edge, EdgeOp, LabelPlacement, LaidOut, LaidOutEdge, LaidOutNode, Node, OP_TABLE, PATTERN_LABEL, PATTERN_SOURCE, PatternId, RenderOptions, SAMPLES, SAMPLE_ORDER, SampleId, Shape, chooseLabelPlacement, estimateTextWidth, layout, parse, refsToCsv, refsToMarkdown, render, splitBilingual, stripComment } from './core.cjs';
 
-/**
- * Minimal, zero-dependency SVG DOM shim. Implements the few element operations the
- * renderer needs (createElementNS, setAttribute, appendChild, textContent) and
- * serializes the tree to XML. `withShimDocument()` scopes the shim around a render
- * call, so rendering also works in a real browser without altering the page's document.
- */
-/** A serializable SVG node. The shape `render()` actually produces and consumes. */
+/** Minimal, zero-dependency SVG DOM shim: the element operations render() needs, plus XML serialization. */
+/** A serializable SVG node. */
 interface SvgNode {
     readonly nodeType: 'element';
     tagName: string;
     namespaceURI: string;
-    /** Attribute names in insertion order, mapped to string values. */
+    /** Attributes, in insertion order. */
     attrs: Map<string, string>;
     children: SvgNode[];
-    /** Text content, or null when the element holds child elements instead. */
+    /** Text content, or null when the node has element children. */
     text: string | null;
     setAttribute(name: string, value: string): void;
     getAttribute(name: string): string | null;
@@ -24,24 +19,12 @@ interface SvgNode {
     set textContent(value: string);
     get textContent(): string;
 }
-/**
- * Install the shim as `globalThis.document`, idempotently, but only when no DOM
- * with `createElementNS` is already present. In a real browser this is a no-op,
- * so the same code path serves both environments.
- */
+/** Install the shim as `globalThis.document`, unless a real DOM is already present. Idempotent. */
 declare function installDomShim(): void;
-/**
- * Serialize a shim element tree to an XML string. Produces self-closing tags for
- * empty elements and correctly escapes attribute values and text content.
- */
+/** Serialize a shim element tree to an XML string (self-closing empty tags, escaped values). */
 declare function serializeSvg(node: SvgNode): string;
 
-/**
- * Compute the tight content bounding box of a rendered SVG tree analytically
- * (without `getBBox`), by walking the element tree and measuring each primitive;
- * text width reuses {@link estimateTextWidth}. Used to crop exports to the drawn
- * extent. Also provides raster and display dimension helpers.
- */
+/** Tight content bounding box of a rendered SVG tree, computed analytically (no `getBBox`), reusing {@link estimateTextWidth} for text. Also provides raster/display dimension helpers. */
 
 interface ViewBox {
     minX: number;
@@ -49,26 +32,16 @@ interface ViewBox {
     width: number;
     height: number;
 }
-/**
- * Compute the tight content bounding box of a rendered SVG tree, padded by `bleed`
- * (default 3 units).
- */
+/** Tight content bounding box of a rendered SVG tree, padded by `bleed` (default 3 units). */
 declare function computeContentBox(root: SvgNode, bleed?: number): ViewBox;
-/**
- * Display dimensions for a viewBox so the long side is at least `targetSide` px
- * (browser default: 1600). Mirrors `svgDisplayDimensionsForViewBox()`.
- */
+/** Display dimensions for a viewBox so the long side is at least `targetSide` px (default 1600). */
 declare function svgDisplayDimensions(viewBox: Pick<ViewBox, 'width' | 'height'>, targetSide?: number): {
     width: number;
     height: number;
     scale: number;
 };
 
-/**
- * Headless SVG rendering: `.pdg` source -> standalone SVG string.
- * Crops to the real drawn extent (bleed 3) and sizes the document so the long side
- * is at least `targetSide` px (default 1600).
- */
+/** Headless SVG rendering: `.pdg` source → standalone SVG string. */
 
 interface RenderToSvgOptions {
     /** Display language: 'ja' (default), 'en', or 'both' (bilingual two-line labels). */
@@ -100,16 +73,10 @@ interface RenderToSvgResult {
 declare function renderToSvg(source: string, opts?: RenderToSvgOptions): RenderToSvgResult;
 
 /**
- * Validation for AI authoring. Runs the core parser and adds a kind assertion and
- * friendly lints, returning all diagnostics.
- *
- *   - Kind assertion: an optional `#! kind: block|flow|state|seq` directive (written
- *     in a comment) is checked against the kind inferred from structure; a mismatch
- *     is reported as an error. Guards against producing the wrong diagram type.
- *   - Lints: clearer hints for chained connections (`A -> B -> C`) and operators
- *     without surrounding spaces (`11-12`).
- *
- * Run on AI-generated `.pdg` and feed the diagnostics back until there are no errors.
+ * Validation for AI authoring: runs the core parser, checks the optional
+ * `#! kind: block|flow|state|seq` directive against the kind inferred from
+ * structure (mismatch = error), and adds lints for chained connections and
+ * unspaced operators. Feed the diagnostics back to the author until no errors remain.
  */
 
 interface ValidateResult {
@@ -135,11 +102,7 @@ interface ValidateResult {
  */
 declare function validate(source: string): ValidateResult;
 
-/**
- * Raster output (PNG / JPEG) via `@resvg/resvg-js`, with the bundled IPAex Gothic
- * font embedded and a white background. Default scale is 8x the content box (capped
- * to 24000 px/side and 1e8 px total). Native dependencies are imported lazily.
- */
+/** Raster output (PNG / JPEG) via `@resvg/resvg-js` with the bundled IPAex Gothic font and a white background. Native dependencies are imported lazily. */
 
 interface RasterOptions {
     lang?: Lang;
@@ -153,12 +116,7 @@ declare function renderToPng(source: string, opts?: RasterOptions): Promise<Uint
 /** Render `.pdg` source to a JPEG (8× by default, white background). */
 declare function renderToJpeg(source: string, opts?: RasterOptions): Promise<Uint8Array>;
 
-/**
- * PDF output (A4, IPAex font embedded). Vector by default (jsPDF + svg2pdf.js under
- * jsdom, with analytic getBBox / getComputedTextLength shims), falling back to a
- * high-resolution raster PDF if the vector path fails. The figure is centered with
- * a 10 mm margin and the page orientation follows its aspect ratio.
- */
+/** PDF output (A4, IPAex font embedded). Vector by default (jsPDF + svg2pdf.js under jsdom, with analytic getBBox/getComputedTextLength shims), falling back to a high-resolution raster PDF if the vector path fails. */
 
 interface PdfOptions {
     lang?: Lang;
@@ -172,14 +130,7 @@ interface PdfOptions {
 /** Render `.pdg` source to a PDF (A4, IPAex font, vector preferred). */
 declare function renderToPdf(source: string, opts?: PdfOptions): Promise<Uint8Array>;
 
-/**
- * PPTX output: `.pdg` → PowerPoint presentation (one 16:9 slide).
- *
- *   - image mode (default): the figure is rasterized (resvg) and placed as a
- *     centered picture — highest visual fidelity.
- *   - editable mode (`editable: true`): every SVG primitive is converted to an
- *     editable PowerPoint shape / connector / text box, for later tweaking.
- */
+/** PPTX output: `.pdg` → PowerPoint (one 16:9 slide). Image mode (default) places a rasterized picture; editable mode converts each SVG primitive to an editable PowerPoint shape, connector, or text box. */
 
 interface PptxOptions {
     lang?: Lang;
@@ -193,22 +144,13 @@ interface PptxOptions {
 /** Render `.pdg` source to a PPTX (image by default, or editable shapes). */
 declare function renderToPptx(source: string, opts?: PptxOptions): Promise<Uint8Array>;
 
-/**
- * pdgkit Node API — the browser-free rendering surface a host tool calls.
- *
- * Implemented: SVG, PNG, JPEG, PDF, PPTX (image + editable), validation, and the
- * reference-sign table exporters. All run with no browser.
- */
+/** pdgkit Node API — the browser-free rendering surface a host tool calls. */
 
 /** The pdgkit package version. Keep in sync with package.json. */
-declare const VERSION = "0.1.0";
+declare const VERSION = "0.1.1";
 /** Convenience: render to SVG and return just the string. */
 declare function toSvgString(source: string, lang?: Lang): string;
-/**
- * Read the bundled AI authoring guide (docs/ai-authoring-guide.md) as a string.
- * Inject this into an LLM's system prompt so it can write valid `.pdg`, instead of
- * pasting the guide by hand.
- */
+/** Read the bundled AI authoring guide (docs/ai-authoring-guide.md) as a string, for injecting into an LLM's system prompt. */
 declare function loadAuthoringGuide(): string;
 
 export { Diagnostic, DiagramKind, Lang, type PdfOptions, type PptxOptions, type RasterOptions, type RenderToSvgOptions, type RenderToSvgResult, type SvgNode, VERSION, type ValidateResult, type ViewBox, computeContentBox, installDomShim, loadAuthoringGuide, renderToJpeg, renderToPdf, renderToPng, renderToPptx, renderToSvg, serializeSvg, svgDisplayDimensions, toSvgString, validate };