@hirokisakabe/pom 5.4.0 → 5.5.1

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,EAAc,MAAM,aAAa,CAAC;AACvD,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を収集する
@@ -72,40 +83,89 @@ async function getYoga() {
         yogaP = loadYoga();
     return yogaP;
 }
+/**
+ * ノードが交差軸方向（幅）で確定サイズを持つかを判定する
+ * - 明示的な w がある場合は確定
+ * - alignSelf で stretch 以外が指定されている場合は不確定
+ * - 親の alignItems で stretch（デフォルト）以外が指定されている場合は不確定
+ */
+function nodeHasDefiniteWidth(node, parentNode) {
+    // 明示的な幅がある
+    if (node.w !== undefined)
+        return true;
+    // alignSelf で stretch 以外が明示されている場合は不確定
+    if (node.alignSelf !== undefined &&
+        node.alignSelf !== "stretch" &&
+        node.alignSelf !== "auto") {
+        return false;
+    }
+    // 親がいない場合（ルートノード）は確定
+    if (!parentNode)
+        return true;
+    // 親の alignItems を取得（VStack/HStack のみ持つ、Box 等は undefined でデフォルト stretch）
+    let parentAlignItems;
+    if (parentNode.type === "vstack") {
+        parentAlignItems = parentNode.alignItems;
+    }
+    else if (parentNode.type === "hstack") {
+        parentAlignItems = parentNode.alignItems;
+    }
+    // VStack/Box（column 方向）の子の場合、交差軸は水平方向
+    // alignItems が stretch（デフォルト）なら子は親幅に伸長される
+    if (parentNode.type === "vstack" ||
+        parentNode.type === "box" ||
+        parentNode.type === "layer") {
+        return parentAlignItems === undefined || parentAlignItems === "stretch";
+    }
+    // HStack の子の場合、幅は主軸方向で flex により決まるため確定とみなす
+    if (parentNode.type === "hstack") {
+        return true;
+    }
+    return true;
+}
 /**
  * POMNode ツリーを再帰的に走査し、YogaNode ツリーを構築する
  */
-async function buildPomWithYogaTree(node, parentYoga, ctx, parentNode) {
+async function buildPomWithYogaTree(node, parentYoga, ctx, map, parentNode, grandparentNode) {
     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);
+        // HStack が確定幅を持つ場合のみ flexBasis=0 で均等分割
+        // HStack が auto-sized（親の alignItems が center/start/end 等）の場合、
+        // flexBasis=0 だと子要素の自然な幅が失われてレイアウトが崩れるため、
+        // flexBasis=auto（デフォルト）のまま維持する
+        if (nodeHasDefiniteWidth(parentNode, grandparentNode)) {
+            yn.setFlexBasis(0);
+        }
     }
     parentYoga.insertChild(yn, parentYoga.getChildCount());
     const def = getNodeDef(node.type);
     switch (def.category) {
         case "single-child": {
             const boxNode = node;
-            await buildPomWithYogaTree(boxNode.children, yn, ctx, node);
+            await buildPomWithYogaTree(boxNode.children, yn, ctx, map, node, parentNode);
             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, parentNode);
             }
             break;
         }

package/dist/calcYogaLayout/fontLoader.d.ts

@@ -2,6 +2,10 @@
  * opentype.js を使用したフォント読み込みモジュール
  * Node.js とブラウザ両方で動作する
  */
+/**
+ * 指定されたフォントがバンドル済みかどうかを判定する
+ */
+export declare function isBundledFont(fontFamily: string): boolean;
 /**
  * 指定したテキストの幅を計測する
  * @param text 計測するテキスト

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

@@ -1 +1 @@
-{"version":3,"file":"fontLoader.d.ts","sourceRoot":"","sources":["../../src/calcYogaLayout/fontLoader.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA2DH;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,QAAQ,GAAG,MAAM,GACxB,MAAM,CAGR;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,QAAQ,GAAG,MAAM,GAAG,MAAM,CAgB5E"}
+{"version":3,"file":"fontLoader.d.ts","sourceRoot":"","sources":["../../src/calcYogaLayout/fontLoader.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA8DH;;GAEG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,QAAQ,GAAG,MAAM,GACxB,MAAM,CAGR;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,QAAQ,GAAG,MAAM,GAAG,MAAM,CAgB5E"}

package/dist/calcYogaLayout/fontLoader.js

@@ -46,6 +46,14 @@ function getFont(weight) {
     fontCache.set(cacheKey, font);
     return font;
 }
+/** バンドル済みフォント名の一覧 */
+const BUNDLED_FONT_NAMES = new Set(["Noto Sans JP"]);
+/**
+ * 指定されたフォントがバンドル済みかどうかを判定する
+ */
+export function isBundledFont(fontFamily) {
+    return BUNDLED_FONT_NAMES.has(fontFamily);
+}
 /**
  * 指定したテキストの幅を計測する
  * @param text 計測するテキスト

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

@@ -1 +1 @@
-{"version":3,"file":"measureText.d.ts","sourceRoot":"","sources":["../../src/calcYogaLayout/measureText.ts"],"names":[],"mappings":"AAEA,KAAK,cAAc,GAAG;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;IACxC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG,UAAU,GAAG,UAAU,GAAG,MAAM,CAAC;AA6HnE;;GAEG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,cAAc,EACpB,IAAI,GAAE,mBAA4B,GACjC;IACD,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAmBA"}
+{"version":3,"file":"measureText.d.ts","sourceRoot":"","sources":["../../src/calcYogaLayout/measureText.ts"],"names":[],"mappings":"AAKA,KAAK,cAAc,GAAG;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;IACxC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG,UAAU,GAAG,UAAU,GAAG,MAAM,CAAC;AA6HnE;;GAEG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,cAAc,EACpB,IAAI,GAAE,mBAA4B,GACjC;IACD,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAoBA"}

package/dist/calcYogaLayout/measureText.js

@@ -1,4 +1,4 @@
-import { measureTextWidth as measureTextWidthOpentype } from "./fontLoader.js";
+import { measureTextWidth as measureTextWidthOpentype, isBundledFont, } from "./fontLoader.js";
 /**
  * 文字がCJK（日本語・中国語・韓国語）文字かどうかを判定する
  */
@@ -108,6 +108,8 @@ function normalizeFontWeight(weight) {
  */
 export function measureText(text, maxWidthPx, opts, mode = "auto") {
     // 計測方法を決定
+    // "opentype" / "fallback" が明示指定された場合はそれを優先
+    // "auto" の場合はバンドル外フォントならフォールバック計測を使用
     const shouldUseFallback = (() => {
         switch (mode) {
             case "opentype":
@@ -115,8 +117,7 @@ export function measureText(text, maxWidthPx, opts, mode = "auto") {
             case "fallback":
                 return true;
             case "auto":
-                // opentype.js はバンドルされたフォントを使うため常に利用可能
-                return false;
+                return !isBundledFont(opts.fontFamily);
         }
     })();
     if (shouldUseFallback) {

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"}