json2pptx 0.5.1 → 0.5.2

package/README.md

@@ -13,7 +13,7 @@ npm i json2pptx
 ```ts
 import { createPPTX } from 'json2pptx'
 
-const deck = {
+const presentation = {
   title: 'Demo',
   width: 1000,
   height: 562.5,
@@ -34,7 +34,7 @@ const deck = {
   ]
 }
 
-const { blob, fileName } = await createPPTX(deck)
+const { blob, fileName } = await createPPTX(presentation)
 // 在浏览器中下载：
 // const url = URL.createObjectURL(blob)
 // const a = document.createElement('a')
@@ -45,7 +45,7 @@ const { blob, fileName } = await createPPTX(deck)
 
 ## API
 
-### `createPPTX(template: Presentation): Promise<{ blob: Blob; fileName: string }>`
+### `createPPTX(presentation: Presentation): Promise<{ blob: Blob; fileName: string }>`
 
 根据 `Presentation` 数据生成 PPTX 的 `Blob` 与建议文件名。输入会先经过
 `json2pptx-schema` 的迁移、校验和规范化流程。
@@ -68,7 +68,6 @@ const { blob, fileName } = await createPPTX(deck)
 - `background` / `fill` 使用显式联合类型：`solid | gradient | image`。
 - 导出的 `.pptx` 只使用 Office 原生 XML 表达视觉信息，不会嵌入自定义 JSON 文件。
 - 与 `ppt2json` 的视觉 round-trip 优先围绕共享视觉 primitive 和仓库内模板优化。
-- `Deck` / `DeckTheme` 仍保留为兼容别名，但新的推荐命名是 `Presentation` / `PresentationTheme`。
 
 ## 开发
 

package/dist/index.d.mts

@@ -137,8 +137,6 @@ type Presentation = {
     theme?: PresentationTheme;
 };
 type PresentationData = Presentation;
-type DeckTheme = PresentationTheme;
-type Deck = Presentation;
 
 declare const getElementRange: (element: SlideElement) => {
     minX: number;
@@ -150,10 +148,10 @@ declare const getLineElementPath: (element: SlideElement) => string;
 
 declare const resolveImageData: (src: string) => Promise<string>;
 
-declare function createPPTX(template: Presentation): Promise<{
+declare function createPPTX(presentation: Presentation): Promise<{
     blob: Blob;
     fileName: string;
 }>;
 declare const buildPptxBlob: typeof createPPTX;
 
-export { type BaseElement, type Deck, type DeckTheme, type ElementClip, type ElementFilters, type ElementOutline, type ElementShadow, type ImageElement, type LineElement, type Presentation, type PresentationData, type PresentationTheme, type ShapeElement, type Slide, type SlideBackground, type SlideElement, type TextContent, type TextElement, buildPptxBlob, createPPTX, getElementRange, getLineElementPath, resolveImageData };
+export { type BaseElement, type Presentation as Deck, type PresentationTheme as DeckTheme, type ElementClip, type ElementFilters, type ElementOutline, type ElementShadow, type ImageElement, type LineElement, type Presentation, type PresentationData, type PresentationTheme, type ShapeElement, type Slide, type SlideBackground, type SlideElement, type TextContent, type TextElement, buildPptxBlob, createPPTX, getElementRange, getLineElementPath, resolveImageData };

package/dist/index.d.ts

@@ -137,8 +137,6 @@ type Presentation = {
     theme?: PresentationTheme;
 };
 type PresentationData = Presentation;
-type DeckTheme = PresentationTheme;
-type Deck = Presentation;
 
 declare const getElementRange: (element: SlideElement) => {
     minX: number;
@@ -150,10 +148,10 @@ declare const getLineElementPath: (element: SlideElement) => string;
 
 declare const resolveImageData: (src: string) => Promise<string>;
 
-declare function createPPTX(template: Presentation): Promise<{
+declare function createPPTX(presentation: Presentation): Promise<{
     blob: Blob;
     fileName: string;
 }>;
 declare const buildPptxBlob: typeof createPPTX;
 
-export { type BaseElement, type Deck, type DeckTheme, type ElementClip, type ElementFilters, type ElementOutline, type ElementShadow, type ImageElement, type LineElement, type Presentation, type PresentationData, type PresentationTheme, type ShapeElement, type Slide, type SlideBackground, type SlideElement, type TextContent, type TextElement, buildPptxBlob, createPPTX, getElementRange, getLineElementPath, resolveImageData };
+export { type BaseElement, type Presentation as Deck, type PresentationTheme as DeckTheme, type ElementClip, type ElementFilters, type ElementOutline, type ElementShadow, type ImageElement, type LineElement, type Presentation, type PresentationData, type PresentationTheme, type ShapeElement, type Slide, type SlideBackground, type SlideElement, type TextContent, type TextElement, buildPptxBlob, createPPTX, getElementRange, getLineElementPath, resolveImageData };

package/dist/index.js

@@ -1231,7 +1231,7 @@ function getLineArrowType(value) {
 }
 
 // src/renderers/elements.ts
-function addTextElement(slide, element, template, slideIndex, elementIndex, ratioPx2Pt, ratioPx2Inch, textPadding, fillPatches) {
+function addTextElement(slide, element, presentation, slideIndex, elementIndex, ratioPx2Pt, ratioPx2Inch, textPadding, fillPatches) {
   var _a, _b, _c, _d, _e, _f, _g;
   if (element.type !== "text" || !element.content) return;
   const textProps = formatHTML(element.content, ratioPx2Pt);
@@ -1244,7 +1244,7 @@ function addTextElement(slide, element, template, slideIndex, elementIndex, rati
     w: ((_d = element.width) != null ? _d : 0) / ratioPx2Inch,
     h: ((_e = element.height) != null ? _e : 0) / ratioPx2Inch,
     fontSize: DEFAULT_FONT_SIZE / ratioPx2Pt,
-    fontFace: element.defaultFontName || ((_f = template.theme) == null ? void 0 : _f.fontName) || DEFAULT_FONT_FACE,
+    fontFace: element.defaultFontName || ((_f = presentation.theme) == null ? void 0 : _f.fontName) || DEFAULT_FONT_FACE,
     color: "#000000",
     valign: "top",
     // pptxgenjs margin order: [left, right, bottom, top]
@@ -1489,21 +1489,21 @@ function parseDataUrlImage(dataUrl) {
   };
   return { mime, data, ext: (_a = extMap[mime]) != null ? _a : "png" };
 }
-async function createPPTX(template) {
+async function createPPTX(presentation) {
   var _a, _b, _c, _d;
-  const parsedTemplate = (0, import_json2pptx_schema.parseDocument)(template);
-  const renderTemplate = parsedTemplate;
+  const parsedPresentation = (0, import_json2pptx_schema.parseDocument)(presentation);
+  const normalizedPresentation = parsedPresentation;
   const pptx = new import_pptxgenjs.default();
   const fillPatches = [];
-  const width = parsedTemplate.width;
-  const height = parsedTemplate.height;
+  const width = parsedPresentation.width;
+  const height = parsedPresentation.height;
   const ratioPx2Inch = 96 * (width / 960);
   const ratioPx2Pt = 96 / 72 * (width / 960);
   const textPadding = 10 / ratioPx2Pt;
   applyPptxLayout(pptx, width, height);
-  for (const [slideIndex, slideJson] of ((_a = renderTemplate.slides) != null ? _a : []).entries()) {
+  for (const [slideIndex, slideJson] of ((_a = normalizedPresentation.slides) != null ? _a : []).entries()) {
     const slide = pptx.addSlide();
-    applySlideBackground(slide, slideJson, renderTemplate.theme);
+    applySlideBackground(slide, slideJson, normalizedPresentation.theme);
     if (slideJson.background && fillRequiresXmlPatch(slideJson.background)) {
       fillPatches.push({
         kind: "background",
@@ -1515,7 +1515,7 @@ async function createPPTX(template) {
       addTextElement(
         slide,
         element,
-        renderTemplate,
+        normalizedPresentation,
         slideIndex,
         elementIndex,
         ratioPx2Pt,
@@ -1537,7 +1537,7 @@ async function createPPTX(template) {
       addTableElement(slide, element, ratioPx2Pt, ratioPx2Inch);
     }
   }
-  const fileName = `${sanitizeFileName(parsedTemplate.title || "presentation")}.pptx`;
+  const fileName = `${sanitizeFileName(parsedPresentation.title || "presentation")}.pptx`;
   const pptxBuffer = await pptx.write({
     outputType: "arraybuffer",
     compression: true