@hirokisakabe/pom 7.4.0 → 8.0.0

package/README.md

@@ -58,16 +58,20 @@ npm install @hirokisakabe/pom
 import { buildPptx } from "@hirokisakabe/pom";
 
 const xml = `
-<VStack w="100%" h="max" padding="48" gap="24" alignItems="start">
-  <Text fontSize="48" bold="true">Presentation Title</Text>
-  <Text fontSize="24" color="666666">Subtitle</Text>
-</VStack>
+<Slide>
+  <VStack w="100%" h="max" padding="48" gap="24" alignItems="start">
+    <Text fontSize="48" bold="true">Presentation Title</Text>
+    <Text fontSize="24" color="666666">Subtitle</Text>
+  </VStack>
+</Slide>
 `;
 
 const { pptx } = await buildPptx(xml, { w: 1280, h: 720 });
 await pptx.writeFile({ fileName: "presentation.pptx" });
 ```
 
+Each slide must be wrapped in a `<Slide>` element. To produce multiple slides, list multiple `<Slide>` elements at the top level.
+
 ## Available Nodes
 
 | Node         | Description                                                                                             |

package/dist/parseXml/parseXml.d.ts

@@ -7,6 +7,10 @@ export declare const TAG_TO_TYPE: Record<string, string>;
 /**
  * XML 文字列を POMNode 配列に変換する。
  *
+ * 最上位は `<Slide>` 要素のみが許容される。各 `<Slide>` が 1 つのスライドに
+ * 対応し、その子要素がスライドのルート POMNode となる。子要素が複数ある場合は
+ * 暗黙的に VStack でラップされる。
+ *
  * XML タグは POM ノードタイプにマッピングされ、属性値は Zod スキーマを参照して
  * 適切な型（number, boolean, array, object）に変換される。
  * 未知のタグ名が指定された場合はエラーがスローされる。
@@ -16,9 +20,11 @@ export declare const TAG_TO_TYPE: Record<string, string>;
  * import { parseXml, buildPptx } from "@hirokisakabe/pom";
  *
  * const xml = `
- *   <VStack gap="16" padding="32">
- *     <Text fontSize="32" bold="true">売上レポート</Text>
- *   </VStack>
+ *   <Slide>
+ *     <VStack gap="16" padding="32">
+ *       <Text fontSize="32" bold="true">売上レポート</Text>
+ *     </VStack>
+ *   </Slide>
  * `;
  *
  * const nodes = parseXml(xml);

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,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;AAGD,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAoB9C,CAAC;AA6pCF;;;;;;;;;;;;;;;;;;;;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;AAGD,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAoB9C,CAAC;AA6pCF;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,EAAE,CA6DrD"}

package/dist/parseXml/parseXml.js

@@ -867,6 +867,10 @@ function convertPomNode(nodeType, tagName, attrs, childElements, textContent, er
 /**
  * XML 文字列を POMNode 配列に変換する。
  *
+ * 最上位は `<Slide>` 要素のみが許容される。各 `<Slide>` が 1 つのスライドに
+ * 対応し、その子要素がスライドのルート POMNode となる。子要素が複数ある場合は
+ * 暗黙的に VStack でラップされる。
+ *
  * XML タグは POM ノードタイプにマッピングされ、属性値は Zod スキーマを参照して
  * 適切な型（number, boolean, array, object）に変換される。
  * 未知のタグ名が指定された場合はエラーがスローされる。
@@ -876,9 +880,11 @@ function convertPomNode(nodeType, tagName, attrs, childElements, textContent, er
  * import { parseXml, buildPptx } from "@hirokisakabe/pom";
  *
  * const xml = `
- *   <VStack gap="16" padding="32">
- *     <Text fontSize="32" bold="true">売上レポート</Text>
- *   </VStack>
+ *   <Slide>
+ *     <VStack gap="16" padding="32">
+ *       <Text fontSize="32" bold="true">売上レポート</Text>
+ *     </VStack>
+ *   </Slide>
  * `;
  *
  * const nodes = parseXml(xml);
@@ -903,10 +909,37 @@ export function parseXml(xmlString) {
     const rootElement = parsed[0];
     const rootChildren = (rootElement["__root__"] ?? []);
     const errors = [];
-    const nodes = rootChildren
-        .filter((child) => !isTextNode(child))
-        .map((child) => convertElement(child, errors))
-        .filter((child) => child !== null);
+    const slideElements = rootChildren.filter((child) => !isTextNode(child));
+    const nodes = [];
+    for (const slideEl of slideElements) {
+        const tagName = getTagName(slideEl);
+        if (tagName !== "Slide") {
+            errors.push(`Top-level element must be <Slide>, but got <${tagName}>. Wrap your slide content in <Slide>...</Slide>.`);
+            continue;
+        }
+        if (Object.keys(getAttributes(slideEl)).length > 0) {
+            errors.push(`<Slide>: Attributes are not supported`);
+        }
+        const slideChildren = getChildElements(slideEl);
+        if (slideChildren.length === 0) {
+            errors.push(`<Slide> must contain at least one child element`);
+            continue;
+        }
+        const converted = slideChildren
+            .map((child) => convertElement(child, errors))
+            .filter((c) => c !== null);
+        if (converted.length === 0)
+            continue;
+        if (converted.length === 1) {
+            nodes.push(converted[0]);
+        }
+        else {
+            nodes.push({
+                type: "vstack",
+                children: converted,
+            });
+        }
+    }
     if (errors.length > 0) {
         throw new ParseXmlError(errors);
     }

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,cA8D1B,CAAC"}
+{"version":3,"file":"layer.d.ts","sourceRoot":"","sources":["../../../src/registry/definitions/layer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGlD,eAAO,MAAM,YAAY,EAAE,cA8D1B,CAAC"}

package/dist/registry/definitions/layer.js

@@ -44,7 +44,7 @@ export const layerNodeDef = {
                 }
                 const adjustedParentX = absoluteX + childX - childLayout.left;
                 const adjustedParentY = absoluteY + childY - childLayout.top;
-                return (await toPositioned(child, ctx, map, adjustedParentX, adjustedParentY));
+                return await toPositioned(child, ctx, map, adjustedParentX, adjustedParentY);
             })),
         };
     },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hirokisakabe/pom",
-  "version": "7.4.0",
+  "version": "8.0.0",
   "description": "AI-friendly PowerPoint generation with a Flexbox layout engine.",
   "type": "module",
   "main": "./dist/index.js",
@@ -45,18 +45,18 @@
     "access": "public"
   },
   "devDependencies": {
-    "@size-limit/file": "^12.0.1",
-    "@types/node": "^25.5.2",
+    "@size-limit/file": "^12.1.0",
+    "@types/node": "^25.6.0",
     "@types/opentype.js": "^1.3.8",
     "@types/pngjs": "6.0.5",
-    "@vitest/coverage-v8": "^4.1.2",
-    "@vitest/ui": "^4.1.2",
-    "lucide-static": "^1.7.0",
+    "@vitest/coverage-v8": "^4.1.5",
+    "@vitest/ui": "^4.1.5",
+    "lucide-static": "^1.11.0",
     "pixelmatch": "7.1.0",
     "pngjs": "7.0.0",
-    "size-limit": "^12.0.1",
+    "size-limit": "^12.1.0",
     "tsx": "4.21.0",
-    "typescript-eslint": "^8.58.0"
+    "typescript-eslint": "^8.59.0"
   },
   "dependencies": {
     "@resvg/resvg-wasm": "^2.6.2",