@hirokisakabe/pom 5.4.0 → 5.5.0

package/README.md

@@ -35,10 +35,10 @@
 
 ## Features
 
-- **AI Friendly** — Simple XML structure designed for LLM code generation. Pair with [LLM Integration guide](./docs/llm-integration.md) for prompt-ready references.
+- **AI Friendly** — Simple XML structure designed for LLM code generation. Include [llm.txt](./website/public/llm.txt) in your system prompt for XML reference. Also available at `https://pom.pptx.app/llm.txt`.
 - **Declarative** — Describe slides as XML. No imperative API calls needed.
 - **Flexible Layout** — Flexbox-style layout with VStack / HStack / Box, powered by yoga-layout.
-- **Rich Nodes** — 15 built-in node types: charts, flowcharts, tables, timelines, org trees, and more.
+- **Rich Nodes** — 19 built-in node types: charts, flowcharts, tables, timelines, org trees, and more.
 - **Schema-validated** — XML input is validated with Zod schemas at runtime with clear error messages.
 - **PowerPoint Native** — Full access to native PowerPoint shape features (roundRect, ellipse, arrows, etc.).
 - **Pixel Units** — Intuitive pixel-based sizing (internally converted to inches at 96 DPI).
@@ -63,7 +63,7 @@ const xml = `
 </VStack>
 `;
 
-const pptx = await buildPptx(xml, { w: 1280, h: 720 });
+const { pptx } = await buildPptx(xml, { w: 1280, h: 720 });
 await pptx.writeFile({ fileName: "presentation.pptx" });
 ```
 
@@ -89,6 +89,7 @@ await pptx.writeFile({ fileName: "presentation.pptx" });
 | Box          | Container for single child with padding        |
 | VStack       | Vertical stack layout                          |
 | HStack       | Horizontal stack layout                        |
+| Icon         | Lucide icons                                   |
 
 For detailed node documentation, see [Nodes](./docs/nodes.md).
 
@@ -209,7 +210,7 @@ Adjustments are applied in the following priority order:
 To disable:
 
 ```typescript
-const pptx = await buildPptx(xml, { w: 1280, h: 720 }, { autoFit: false });
+const { pptx } = await buildPptx(xml, { w: 1280, h: 720 }, { autoFit: false });
 ```
 
 ## Documentation
@@ -220,7 +221,7 @@ const pptx = await buildPptx(xml, { w: 1280, h: 720 }, { autoFit: false });
 | [Nodes](./docs/nodes.md)                       | Complete reference for all node types |
 | [Master Slide](./docs/master-slide.md)         | Headers, footers, and page numbers    |
 | [Text Measurement](./docs/text-measurement.md) | Text measurement options and settings |
-| [LLM Integration](./docs/llm-integration.md)   | Compact XML reference for LLM prompts |
+| [llm.txt](./website/public/llm.txt)            | Compact XML reference for LLM prompts |
 | [Playground](https://pom.pptx.app/playground)  | Try pom XML in the browser            |
 
 ## License

package/dist/autoFit/autoFit.d.ts

@@ -1,5 +1,6 @@
 import type { POMNode } from "../types.ts";
 import type { BuildContext } from "../buildContext.ts";
+import type { YogaNodeMap } from "../calcYogaLayout/types.ts";
 /**
  * スライドのオーバーフローを検出し、段階的に調整してスライド内に収める。
  *
@@ -12,5 +13,5 @@ import type { BuildContext } from "../buildContext.ts";
 export declare function autoFitSlide(node: POMNode, slideSize: {
     w: number;
     h: number;
-}, ctx: BuildContext): Promise<void>;
+}, ctx: BuildContext): Promise<YogaNodeMap>;
 //# sourceMappingURL=autoFit.d.ts.map

package/dist/autoFit/autoFit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"autoFit.d.ts","sourceRoot":"","sources":["../../src/autoFit/autoFit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAuDvD;;;;;;;;GAQG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,OAAO,EACb,SAAS,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,EACnC,GAAG,EAAE,YAAY,GAChB,OAAO,CAAC,IAAI,CAAC,CA6Bf"}
+{"version":3,"file":"autoFit.d.ts","sourceRoot":"","sources":["../../src/autoFit/autoFit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AA6E9D;;;;;;;;GAQG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,OAAO,EACb,SAAS,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,EACnC,GAAG,EAAE,YAAY,GAChB,OAAO,CAAC,WAAW,CAAC,CAkBtB"}

package/dist/autoFit/autoFit.js

@@ -13,15 +13,27 @@ const strategies = [
     uniformScale,
 ];
 /**
- * 通常の slideSize でレイアウト計算し、コンテンツの占有高さを取得する。
+ * レイアウト計算を実行し、コンテンツのオーバーフロー状態を測定する。
+ */
+async function measureOverflow(node, slideSize, ctx) {
+    const map = await calcYogaLayout(node, slideSize, ctx);
+    const contentHeight = calcContentHeight(map, node);
+    const isOverflowing = contentHeight > slideSize.h * OVERFLOW_TOLERANCE;
+    const targetRatio = isOverflowing ? slideSize.h / contentHeight : 1;
+    return { contentHeight, isOverflowing, targetRatio, map };
+}
+/**
+ * Yoga レイアウト結果からコンテンツの占有高さを算出する。
  *
  * ルートの yogaNode の子要素の (top + height) の最大値を計算し、
  * ルートの padding.bottom を加算してコンテンツの占有高さとする。
  * h="max" や flexGrow の影響を受けず、正確なコンテンツ高さを返す。
  */
-async function measureContentHeight(node, slideSize, ctx) {
-    await calcYogaLayout(node, slideSize, ctx);
-    const rootYoga = node.yogaNode;
+function calcContentHeight(map, node) {
+    const rootYoga = map.get(node);
+    if (!rootYoga) {
+        throw new Error("YogaNode not found in map for root node");
+    }
     const childCount = rootYoga.getChildCount();
     if (childCount === 0) {
         return rootYoga.getComputedHeight();
@@ -49,25 +61,29 @@ async function measureContentHeight(node, slideSize, ctx) {
  * 4. 全体スケーリング（フォールバック）
  */
 export async function autoFitSlide(node, slideSize, ctx) {
+    // Phase 1: 戦略を順次適用してオーバーフローを解消
     for (const strategy of strategies) {
-        freeYogaTree(node);
-        const contentHeight = await measureContentHeight(node, slideSize, ctx);
-        if (contentHeight <= slideSize.h * OVERFLOW_TOLERANCE) {
+        const result = await measureOverflow(node, slideSize, ctx);
+        freeYogaTree(result.map);
+        if (!result.isOverflowing) {
             break;
         }
-        const ratio = slideSize.h / contentHeight;
-        const changed = strategy(node, ratio);
+        const changed = strategy(node, result.targetRatio);
         if (!changed) {
             continue;
         }
     }
-    // 最終的にオーバーフローが解消されたか確認
-    freeYogaTree(node);
-    const finalHeight = await measureContentHeight(node, slideSize, ctx);
-    if (finalHeight > slideSize.h * OVERFLOW_TOLERANCE) {
-        console.warn(`[pom] autoFit: content height (${Math.round(finalHeight)}px) exceeds slide height (${slideSize.h}px) after all adjustments.`);
+    // Phase 2: 最終レイアウト計算とオーバーフロー検証
+    return finalizeLayout(node, slideSize, ctx);
+}
+/**
+ * 最終レイアウトを計算し、オーバーフローが残っていれば警告を出力する。
+ */
+async function finalizeLayout(node, slideSize, ctx) {
+    const result = await measureOverflow(node, slideSize, ctx);
+    if (result.isOverflowing) {
+        ctx.diagnostics.add("AUTOFIT_OVERFLOW", `autoFit: content height (${Math.round(result.contentHeight)}px) exceeds slide height (${slideSize.h}px) after all adjustments.`);
     }
-    // 最終レイアウト（正しい slideSize で）
-    freeYogaTree(node);
-    await calcYogaLayout(node, slideSize, ctx);
+    freeYogaTree(result.map);
+    return calcYogaLayout(node, slideSize, ctx);
 }

package/dist/buildContext.d.ts

@@ -1,4 +1,5 @@
 import type { TextMeasurementMode } from "./calcYogaLayout/measureText.ts";
+import { DiagnosticCollector } from "./diagnostics.ts";
 export interface BuildContext {
     textMeasurementMode: TextMeasurementMode;
     imageSizeCache: Map<string, {
@@ -7,6 +8,7 @@ export interface BuildContext {
     }>;
     imageDataCache: Map<string, string>;
     iconRasterCache: Map<string, string>;
+    diagnostics: DiagnosticCollector;
 }
 export declare function createBuildContext(textMeasurementMode?: TextMeasurementMode): BuildContext;
 //# sourceMappingURL=buildContext.d.ts.map

package/dist/buildContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"buildContext.d.ts","sourceRoot":"","sources":["../src/buildContext.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAE3E,MAAM,WAAW,YAAY;IAC3B,mBAAmB,EAAE,mBAAmB,CAAC;IACzC,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACnE,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACtC;AAED,wBAAgB,kBAAkB,CAChC,mBAAmB,GAAE,mBAA4B,GAChD,YAAY,CAOd"}
+{"version":3,"file":"buildContext.d.ts","sourceRoot":"","sources":["../src/buildContext.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAC3E,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAEvD,MAAM,WAAW,YAAY;IAC3B,mBAAmB,EAAE,mBAAmB,CAAC;IACzC,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACnE,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,WAAW,EAAE,mBAAmB,CAAC;CAClC;AAED,wBAAgB,kBAAkB,CAChC,mBAAmB,GAAE,mBAA4B,GAChD,YAAY,CAQd"}

package/dist/buildContext.js

@@ -1,8 +1,10 @@
+import { DiagnosticCollector } from "./diagnostics.js";
 export function createBuildContext(textMeasurementMode = "auto") {
     return {
         textMeasurementMode,
         imageSizeCache: new Map(),
         imageDataCache: new Map(),
         iconRasterCache: new Map(),
+        diagnostics: new DiagnosticCollector(),
     };
 }

package/dist/buildPptx.d.ts

@@ -1,6 +1,11 @@
 import type { TextMeasurementMode } from "./calcYogaLayout/measureText.ts";
+import type { Diagnostic } from "./diagnostics.ts";
 import { SlideMasterOptions } from "./types.ts";
 export type { TextMeasurementMode };
+export interface BuildPptxResult {
+    pptx: import("pptxgenjs").default;
+    diagnostics: Diagnostic[];
+}
 export declare function buildPptx(xml: string, slideSize: {
     w: number;
     h: number;
@@ -8,5 +13,6 @@ export declare function buildPptx(xml: string, slideSize: {
     master?: SlideMasterOptions;
     textMeasurement?: TextMeasurementMode;
     autoFit?: boolean;
-}): Promise<import("pptxgenjs").default>;
+    strict?: boolean;
+}): Promise<BuildPptxResult>;
 //# 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,KAAK,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAK3E,OAAO,EAAkB,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEhE,YAAY,EAAE,mBAAmB,EAAE,CAAC;AAEpC,wBAAsB,SAAS,CAC7B,GAAG,EAAE,MAAM,EACX,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;IACtC,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,wCAwBF"}
+{"version":3,"file":"buildPptx.d.ts","sourceRoot":"","sources":["../src/buildPptx.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAG3E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAMnD,OAAO,EAAkB,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEhE,YAAY,EAAE,mBAAmB,EAAE,CAAC;AAEpC,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,OAAO,WAAW,EAAE,OAAO,CAAC;IAClC,WAAW,EAAE,UAAU,EAAE,CAAC;CAC3B;AAED,wBAAsB,SAAS,CAC7B,GAAG,EAAE,MAAM,EACX,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;IACtC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,GACA,OAAO,CAAC,eAAe,CAAC,CA8B1B"}

package/dist/buildPptx.js

@@ -1,6 +1,8 @@
 import { autoFitSlide } from "./autoFit/autoFit.js";
 import { createBuildContext } from "./buildContext.js";
 import { calcYogaLayout } from "./calcYogaLayout/calcYogaLayout.js";
+import { extractLayoutResults } from "./calcYogaLayout/types.js";
+import { DiagnosticsError } from "./diagnostics.js";
 import { parseXml } from "./parseXml/parseXml.js";
 import { renderPptx } from "./renderPptx/renderPptx.js";
 import { freeYogaTree } from "./shared/freeYogaTree.js";
@@ -10,20 +12,27 @@ export async function buildPptx(xml, slideSize, options) {
     const nodes = parseXml(xml);
     const positionedPages = [];
     for (const node of nodes) {
+        let map;
         try {
             if (options?.autoFit !== false) {
-                await autoFitSlide(node, slideSize, ctx);
+                map = await autoFitSlide(node, slideSize, ctx);
             }
             else {
-                await calcYogaLayout(node, slideSize, ctx);
+                map = await calcYogaLayout(node, slideSize, ctx);
             }
-            const positioned = toPositioned(node, ctx);
+            const layoutMap = extractLayoutResults(map);
+            const positioned = toPositioned(node, ctx, layoutMap);
             positionedPages.push(positioned);
         }
         finally {
-            freeYogaTree(node);
+            if (map)
+                freeYogaTree(map);
         }
     }
     const pptx = renderPptx(positionedPages, slideSize, ctx, options?.master);
-    return pptx;
+    const diagnostics = ctx.diagnostics.items;
+    if (options?.strict && diagnostics.length > 0) {
+        throw new DiagnosticsError(diagnostics);
+    }
+    return { pptx, diagnostics };
 }

package/dist/calcYogaLayout/calcYogaLayout.d.ts

@@ -1,15 +1,17 @@
 import type { POMNode } from "../types.ts";
 import type { BuildContext } from "../buildContext.ts";
+import type { YogaNodeMap } from "./types.ts";
 /**
  * POMNode ツリーを Yoga でレイアウト計算する
- * POMNode ツリーの各ノードに yogaNode プロパティがセットされる
+ * POMNode と YogaNode の対応を YogaNodeMap として返す
  *
  * @param root 入力 POMNode ツリーのルート
  * @param slideSize スライド全体のサイズ（px）
  * @param ctx BuildContext
+ * @returns YogaNodeMap（POMNode → YogaNode のマッピング）
  */
 export declare function calcYogaLayout(root: POMNode, slideSize: {
     w: number;
     h: number;
-}, ctx: BuildContext): Promise<void>;
+}, ctx: BuildContext): Promise<YogaNodeMap>;
 //# sourceMappingURL=calcYogaLayout.d.ts.map

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,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAMvD;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,OAAO,EACb,SAAS,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,EACnC,GAAG,EAAE,YAAY,iBAiBlB"}
+{"version":3,"file":"calcYogaLayout.d.ts","sourceRoot":"","sources":["../../src/calcYogaLayout/calcYogaLayout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAO9C;;;;;;;;GAQG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,OAAO,EACb,SAAS,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,EACnC,GAAG,EAAE,YAAY,GAChB,OAAO,CAAC,WAAW,CAAC,CA0BtB"}

package/dist/calcYogaLayout/calcYogaLayout.js

@@ -1,32 +1,43 @@
 import { loadYoga } from "yoga-layout/load";
 import { prefetchImageSize } from "../shared/measureImage.js";
+import { freeYogaTree } from "../shared/freeYogaTree.js";
 import { getNodeDef } from "../registry/index.js";
 /**
  * POMNode ツリーを Yoga でレイアウト計算する
- * POMNode ツリーの各ノードに yogaNode プロパティがセットされる
+ * POMNode と YogaNode の対応を YogaNodeMap として返す
  *
  * @param root 入力 POMNode ツリーのルート
  * @param slideSize スライド全体のサイズ（px）
  * @param ctx BuildContext
+ * @returns YogaNodeMap（POMNode → YogaNode のマッピング）
  */
 export async function calcYogaLayout(root, slideSize, ctx) {
     const Yoga = await getYoga();
     // 事前に全画像のサイズを取得（HTTPS対応のため）
     await prefetchAllImageSizes(root, ctx);
-    const rootYoga = Yoga.Node.create();
-    root.yogaNode = rootYoga;
-    await buildPomWithYogaTree(root, rootYoga, ctx);
-    // スライド全体サイズを指定
-    rootYoga.setWidth(slideSize.w);
-    rootYoga.setHeight(slideSize.h);
-    rootYoga.calculateLayout(slideSize.w, slideSize.h, Yoga.DIRECTION_LTR);
+    const map = new Map();
+    try {
+        const rootYoga = Yoga.Node.create();
+        map.set(root, rootYoga);
+        await buildPomWithYogaTree(root, rootYoga, ctx, map);
+        // スライド全体サイズを指定
+        rootYoga.setWidth(slideSize.w);
+        rootYoga.setHeight(slideSize.h);
+        rootYoga.calculateLayout(slideSize.w, slideSize.h, Yoga.DIRECTION_LTR);
+    }
+    catch (e) {
+        // 途中で失敗した場合、作成済みの YogaNode を解放してから再 throw
+        freeYogaTree(map);
+        throw e;
+    }
+    return map;
 }
 /**
  * POMNode ツリー内のすべての画像のサイズを事前取得する
  */
 async function prefetchAllImageSizes(node, ctx) {
     const imageSources = collectImageSources(node);
-    await Promise.all(imageSources.map((src) => prefetchImageSize(src, ctx.imageSizeCache, ctx.imageDataCache)));
+    await Promise.all(imageSources.map((src) => prefetchImageSize(src, ctx.imageSizeCache, ctx.imageDataCache, ctx.diagnostics)));
 }
 /**
  * POMNode ツリー内のすべての画像のsrcを収集する
@@ -75,21 +86,24 @@ async function getYoga() {
 /**
  * POMNode ツリーを再帰的に走査し、YogaNode ツリーを構築する
  */
-async function buildPomWithYogaTree(node, parentYoga, ctx, parentNode) {
+async function buildPomWithYogaTree(node, parentYoga, ctx, map, parentNode) {
     const yoga = await getYoga();
     const yn = yoga.Node.create();
-    node.yogaNode = yn; // 対応する YogaNode をセット
+    map.set(node, yn); // 対応する YogaNode をマップに登録
     await applyStyleToYogaNode(node, yn, ctx);
     // HStack/VStack の子要素に flexShrink=1 をデフォルト設定（CSS Flexbox と同じ挙動）
     // 主軸方向で %サイズ + gap がある場合の overflow を防ぐ
+    // アイコンは固定サイズのコンテンツなので shrink させない
     if (parentNode?.type === "hstack" || parentNode?.type === "vstack") {
-        yn.setFlexShrink(1);
+        yn.setFlexShrink(node.type === "icon" ? 0 : 1);
     }
     // HStack の子要素で幅が指定されていない場合、デフォルトで均等分割
     // テーブルは setMeasureFunc でカラム幅合計を返すため除外
+    // アイコンは固定サイズのコンテンツなので除外
     if (parentNode?.type === "hstack" &&
         node.w === undefined &&
-        node.type !== "table") {
+        node.type !== "table" &&
+        node.type !== "icon") {
         yn.setFlexGrow(1);
         yn.setFlexBasis(0);
     }
@@ -98,14 +112,14 @@ async function buildPomWithYogaTree(node, parentYoga, ctx, parentNode) {
     switch (def.category) {
         case "single-child": {
             const boxNode = node;
-            await buildPomWithYogaTree(boxNode.children, yn, ctx, node);
+            await buildPomWithYogaTree(boxNode.children, yn, ctx, map, node);
             break;
         }
         case "multi-child":
         case "absolute-child": {
             const containerNode = node;
             for (const child of containerNode.children) {
-                await buildPomWithYogaTree(child, yn, ctx, node);
+                await buildPomWithYogaTree(child, yn, ctx, map, node);
             }
             break;
         }

package/dist/calcYogaLayout/types.d.ts

@@ -0,0 +1,16 @@
+import type { Node as YogaNode } from "yoga-layout";
+import type { POMNode } from "../types.ts";
+/** POMNode と対応する YogaNode のマッピング。レイアウト計算フェーズでのみ存在する */
+export type YogaNodeMap = Map<POMNode, YogaNode>;
+/** Yoga 計算結果の軽量表現。Yoga ランタイムへの依存なし */
+export interface LayoutResult {
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+}
+/** POMNode と計算済みレイアウト結果のマッピング */
+export type LayoutResultMap = Map<POMNode, LayoutResult>;
+/** YogaNodeMap から計算済みレイアウト結果を抽出する */
+export declare function extractLayoutResults(yogaMap: YogaNodeMap): LayoutResultMap;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/calcYogaLayout/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,IAAI,QAAQ,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,uDAAuD;AACvD,MAAM,MAAM,WAAW,GAAG,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;AAEjD,sCAAsC;AACtC,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,iCAAiC;AACjC,MAAM,MAAM,eAAe,GAAG,GAAG,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;AAEzD,qCAAqC;AACrC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,WAAW,GAAG,eAAe,CAY1E"}

package/dist/calcYogaLayout/types.js

@@ -0,0 +1,14 @@
+/** YogaNodeMap から計算済みレイアウト結果を抽出する */
+export function extractLayoutResults(yogaMap) {
+    const layoutMap = new Map();
+    for (const [pomNode, yogaNode] of yogaMap) {
+        const computed = yogaNode.getComputedLayout();
+        layoutMap.set(pomNode, {
+            left: computed.left,
+            top: computed.top,
+            width: computed.width,
+            height: computed.height,
+        });
+    }
+    return layoutMap;
+}

package/dist/diagnostics.d.ts

@@ -0,0 +1,14 @@
+export type DiagnosticCode = "IMAGE_MEASURE_FAILED" | "IMAGE_NOT_PREFETCHED" | "AUTOFIT_OVERFLOW" | "SCALE_BELOW_THRESHOLD";
+export interface Diagnostic {
+    code: DiagnosticCode;
+    message: string;
+}
+export declare class DiagnosticCollector {
+    readonly items: Diagnostic[];
+    add(code: DiagnosticCode, message: string): void;
+}
+export declare class DiagnosticsError extends Error {
+    readonly diagnostics: Diagnostic[];
+    constructor(diagnostics: Diagnostic[]);
+}
+//# sourceMappingURL=diagnostics.d.ts.map

package/dist/diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../src/diagnostics.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GACtB,sBAAsB,GACtB,sBAAsB,GACtB,kBAAkB,GAClB,uBAAuB,CAAC;AAE5B,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,cAAc,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,mBAAmB;IAC9B,QAAQ,CAAC,KAAK,EAAE,UAAU,EAAE,CAAM;IAElC,GAAG,CAAC,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;CAGjD;AAED,qBAAa,gBAAiB,SAAQ,KAAK;aACb,WAAW,EAAE,UAAU,EAAE;gBAAzB,WAAW,EAAE,UAAU,EAAE;CAOtD"}

package/dist/diagnostics.js

@@ -0,0 +1,17 @@
+export class DiagnosticCollector {
+    items = [];
+    add(code, message) {
+        this.items.push({ code, message });
+    }
+}
+export class DiagnosticsError extends Error {
+    diagnostics;
+    constructor(diagnostics) {
+        const summary = diagnostics
+            .map((d) => `[${d.code}] ${d.message}`)
+            .join("\n");
+        super(`Build completed with diagnostics:\n${summary}`);
+        this.diagnostics = diagnostics;
+        this.name = "DiagnosticsError";
+    }
+}

package/dist/index.d.ts

@@ -1,5 +1,7 @@
 export { buildPptx } from "./buildPptx.ts";
-export type { TextMeasurementMode } from "./buildPptx.ts";
+export type { BuildPptxResult, TextMeasurementMode } from "./buildPptx.ts";
+export { DiagnosticsError } from "./diagnostics.ts";
+export type { Diagnostic, DiagnosticCode } from "./diagnostics.ts";
 export { ParseXmlError } from "./parseXml/parseXml.ts";
 export type { SlideMasterOptions, SlideMasterBackground, SlideMasterMargin, MasterObject, MasterTextObject, MasterImageObject, MasterRectObject, MasterLineObject, SlideNumberOptions, } from "./types.ts";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,YAAY,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,YAAY,EACV,kBAAkB,EAClB,qBAAqB,EACrB,iBAAiB,EACjB,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,YAAY,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAC3E,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,YAAY,EACV,kBAAkB,EAClB,qBAAqB,EACrB,iBAAiB,EACjB,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -1,2 +1,3 @@
 export { buildPptx } from "./buildPptx.js";
+export { DiagnosticsError } from "./diagnostics.js";
 export { ParseXmlError } from "./parseXml/parseXml.js";

package/dist/parseXml/parseXml.d.ts

@@ -1,4 +1,4 @@
-import type { POMNode } from "../types.ts";
+import { type POMNode } from "../types.ts";
 export declare class ParseXmlError extends Error {
     readonly errors: string[];
     constructor(errors: string[]);

package/dist/parseXml/parseXml.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parseXml.d.ts","sourceRoot":"","sources":["../../src/parseXml/parseXml.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AA6B3C,qBAAa,aAAc,SAAQ,KAAK;IACtC,SAAgB,MAAM,EAAE,MAAM,EAAE,CAAC;gBACrB,MAAM,EAAE,MAAM,EAAE;CAM7B;AAm6BD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,EAAE,CAiCrD"}
+{"version":3,"file":"parseXml.d.ts","sourceRoot":"","sources":["../../src/parseXml/parseXml.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,KAAK,OAAO,EAgBb,MAAM,aAAa,CAAC;AAYrB,qBAAa,aAAc,SAAQ,KAAK;IACtC,SAAgB,MAAM,EAAE,MAAM,EAAE,CAAC;gBACrB,MAAM,EAAE,MAAM,EAAE;CAM7B;AAm6BD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,EAAE,CAiCrD"}

package/dist/parseXml/parseXml.js

@@ -1,5 +1,5 @@
 import { XMLParser } from "fast-xml-parser";
-import { inputTextNodeSchema, inputUlNodeSchema, inputOlNodeSchema, inputImageNodeSchema, inputTableNodeSchema, inputShapeNodeSchema, inputChartNodeSchema, inputTimelineNodeSchema, inputMatrixNodeSchema, inputTreeNodeSchema, inputFlowNodeSchema, inputProcessArrowNodeSchema, inputPyramidNodeSchema, inputLineNodeSchema, inputIconNodeSchema, } from "./inputSchema.js";
+import { textNodeSchema, ulNodeSchema, olNodeSchema, imageNodeSchema, tableNodeSchema, shapeNodeSchema, chartNodeSchema, timelineNodeSchema, matrixNodeSchema, treeNodeSchema, flowNodeSchema, processArrowNodeSchema, pyramidNodeSchema, lineNodeSchema, iconNodeSchema, } from "../types.js";
 import { NODE_COERCION_MAP, CHILD_ELEMENT_COERCION_MAP, coerceWithRule, coerceFallback, getObjectShapeFromRule, isBooleanObjectUnionRule, } from "./coercionRules.js";
 // ===== ParseXmlError =====
 export class ParseXmlError extends Error {
@@ -85,21 +85,21 @@ function getKnownChildAttributes(tagName) {
 }
 // ===== Leaf node Zod validation schemas =====
 const leafNodeValidationSchemas = {
-    text: inputTextNodeSchema,
-    image: inputImageNodeSchema,
-    table: inputTableNodeSchema,
-    shape: inputShapeNodeSchema,
-    chart: inputChartNodeSchema,
-    timeline: inputTimelineNodeSchema,
-    matrix: inputMatrixNodeSchema,
-    tree: inputTreeNodeSchema,
-    flow: inputFlowNodeSchema,
-    processArrow: inputProcessArrowNodeSchema,
-    pyramid: inputPyramidNodeSchema,
-    line: inputLineNodeSchema,
-    ul: inputUlNodeSchema,
-    ol: inputOlNodeSchema,
-    icon: inputIconNodeSchema,
+    text: textNodeSchema,
+    image: imageNodeSchema,
+    table: tableNodeSchema,
+    shape: shapeNodeSchema,
+    chart: chartNodeSchema,
+    timeline: timelineNodeSchema,
+    matrix: matrixNodeSchema,
+    tree: treeNodeSchema,
+    flow: flowNodeSchema,
+    processArrow: processArrowNodeSchema,
+    pyramid: pyramidNodeSchema,
+    line: lineNodeSchema,
+    ul: ulNodeSchema,
+    ol: olNodeSchema,
+    icon: iconNodeSchema,
 };
 function formatZodIssue(issue, tagName) {
     const path = issue.path;

package/dist/registry/definitions/icon.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"icon.d.ts","sourceRoot":"","sources":["../../../src/registry/definitions/icon.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAKlD,eAAO,MAAM,WAAW,EAAE,cAwDzB,CAAC"}
+{"version":3,"file":"icon.d.ts","sourceRoot":"","sources":["../../../src/registry/definitions/icon.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAKlD,eAAO,MAAM,WAAW,EAAE,cAqEzB,CAAC"}

package/dist/registry/definitions/icon.js

@@ -1,6 +1,6 @@
 import { rasterizeIcon } from "../../icons/index.js";
-import { omitYogaNode } from "../../toPositioned/toPositioned.js";
 import { renderIconNode } from "../../renderPptx/nodes/icon.js";
+import { getContentArea } from "../../renderPptx/utils/contentArea.js";
 export const iconNodeDef = {
     type: "icon",
     category: "leaf",
@@ -14,11 +14,19 @@ export const iconNodeDef = {
     toPositioned(pom, absoluteX, absoluteY, layout, ctx) {
         const n = pom;
         const iconSize = n.size ?? 24;
-        const rasterSize = Math.max(Math.ceil(n.variant ? iconSize : layout.width), Math.ceil(n.variant ? iconSize : layout.height), iconSize);
+        // padding を考慮したコンテンツ領域で bg/icon の座標を計算
+        const content = getContentArea({
+            x: absoluteX,
+            y: absoluteY,
+            w: layout.width,
+            h: layout.height,
+            padding: n.padding,
+        });
+        // 実描画サイズに合わせてラスタライズ（不要に大きい PNG を防ぐ）
+        const rasterSize = Math.max(Math.ceil(n.variant ? iconSize : Math.min(content.w, content.h)), iconSize);
         const iconImageData = rasterizeIcon(n.name, rasterSize, n.color ?? "#000000", ctx.iconRasterCache);
-        // variant 指定時はアイコンを中央に配置
         const positioned = {
-            ...omitYogaNode(n),
+            ...n,
             x: absoluteX,
             y: absoluteY,
             w: layout.width,
@@ -27,21 +35,25 @@ export const iconNodeDef = {
         };
         if (n.variant) {
             const totalSize = Math.ceil(iconSize * 1.75);
-            // 背景図形は totalSize の正方形として、layout 領域の中央に配置
-            const bgOffsetX = (layout.width - totalSize) / 2;
-            const bgOffsetY = (layout.height - totalSize) / 2;
-            positioned.bgX = absoluteX + bgOffsetX;
-            positioned.bgY = absoluteY + bgOffsetY;
+            // 背景図形は totalSize の正方形として、コンテンツ領域の中央に配置
+            positioned.bgX = content.x + (content.w - totalSize) / 2;
+            positioned.bgY = content.y + (content.h - totalSize) / 2;
             positioned.bgW = totalSize;
             positioned.bgH = totalSize;
-            // アイコンは背景図形の中央に配置
-            const iconOffsetX = (layout.width - iconSize) / 2;
-            const iconOffsetY = (layout.height - iconSize) / 2;
-            positioned.iconX = absoluteX + iconOffsetX;
-            positioned.iconY = absoluteY + iconOffsetY;
+            // アイコンはコンテンツ領域の中央に配置
+            positioned.iconX = content.x + (content.w - iconSize) / 2;
+            positioned.iconY = content.y + (content.h - iconSize) / 2;
             positioned.iconW = iconSize;
             positioned.iconH = iconSize;
         }
+        else {
+            // variant なしの場合もアスペクト比を維持し、コンテンツ領域の中央に配置
+            const iconSide = Math.min(content.w, content.h);
+            positioned.iconX = content.x + (content.w - iconSide) / 2;
+            positioned.iconY = content.y + (content.h - iconSide) / 2;
+            positioned.iconW = iconSide;
+            positioned.iconH = iconSide;
+        }
         return positioned;
     },
     render(node, ctx) {

package/dist/registry/definitions/image.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"image.d.ts","sourceRoot":"","sources":["../../../src/registry/definitions/image.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAQ,MAAM,aAAa,CAAC;AAOxD,eAAO,MAAM,YAAY,EAAE,cA+B1B,CAAC"}
+{"version":3,"file":"image.d.ts","sourceRoot":"","sources":["../../../src/registry/definitions/image.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAQ,MAAM,aAAa,CAAC;AAMxD,eAAO,MAAM,YAAY,EAAE,cAmC1B,CAAC"}

package/dist/registry/definitions/image.js

@@ -1,6 +1,5 @@
 import { measureImage, getImageData } from "../../shared/measureImage.js";
 import { renderImageNode } from "../../renderPptx/nodes/image.js";
-import { omitYogaNode } from "../../toPositioned/toPositioned.js";
 export const imageNodeDef = {
     type: "image",
     category: "leaf",
@@ -8,7 +7,7 @@ export const imageNodeDef = {
         const n = node;
         const src = n.src;
         yn.setMeasureFunc(() => {
-            const { widthPx, heightPx } = measureImage(src, ctx.imageSizeCache);
+            const { widthPx, heightPx } = measureImage(src, ctx.imageSizeCache, ctx.diagnostics);
             return { width: widthPx, height: heightPx };
         });
     },
@@ -16,7 +15,7 @@ export const imageNodeDef = {
         const n = pom;
         const imageData = getImageData(n.src, ctx.imageDataCache);
         return {
-            ...omitYogaNode(n),
+            ...n,
             x: absoluteX,
             y: absoluteY,
             w: layout.width,

package/dist/registry/definitions/layer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"layer.d.ts","sourceRoot":"","sources":["../../../src/registry/definitions/layer.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGlD,eAAO,MAAM,YAAY,EAAE,cAwD1B,CAAC"}
+{"version":3,"file":"layer.d.ts","sourceRoot":"","sources":["../../../src/registry/definitions/layer.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGlD,eAAO,MAAM,YAAY,EAAE,cA4D1B,CAAC"}