pptx-glimpse 3.2.0 → 3.2.1

package/dist/browser.cjs

@@ -8394,6 +8394,7 @@ var xmlBuilder = new import_fast_xml_parser2.XMLBuilder({
   suppressEmptyNode: true
 });
 function buildTextBoxXml(params) {
+  const paragraphs = params.paragraphs ?? [{ runs: [{ text: params.text ?? "" }] }];
   return xmlBuilder.build({
     "p:sp": {
       "p:nvSpPr": {
@@ -8408,6 +8409,7 @@ function buildTextBoxXml(params) {
       },
       "p:spPr": {
         "a:xfrm": {
+          ...params.rotation !== void 0 ? { "@_rot": String(params.rotation) } : {},
           "a:off": {
             "@_x": String(params.offsetX),
             "@_y": String(params.offsetY)
@@ -8427,20 +8429,142 @@ function buildTextBoxXml(params) {
         }
       },
       "p:txBody": {
-        "a:bodyPr": {
-          "@_wrap": "square"
-        },
+        "a:bodyPr": createTextBodyPropertiesXml(params.body),
         "a:lstStyle": {},
-        "a:p": {
-          "a:r": {
-            "a:t": textElementValue(params.text)
-          },
-          "a:endParaRPr": {}
-        }
+        "a:p": paragraphs.map(createParagraphXml)
       }
     }
   });
 }
+function createTextBodyPropertiesXml(body) {
+  return {
+    "@_wrap": "square",
+    ...body?.anchor !== void 0 ? { "@_anchor": verticalAnchorToken(body.anchor) } : {},
+    ...body?.marginLeft !== void 0 ? { "@_lIns": String(body.marginLeft) } : {},
+    ...body?.marginRight !== void 0 ? { "@_rIns": String(body.marginRight) } : {},
+    ...body?.marginTop !== void 0 ? { "@_tIns": String(body.marginTop) } : {},
+    ...body?.marginBottom !== void 0 ? { "@_bIns": String(body.marginBottom) } : {}
+  };
+}
+function createParagraphXml(paragraph) {
+  return {
+    ...paragraph.properties !== void 0 ? { "a:pPr": createParagraphPropertiesXml(paragraph.properties) } : {},
+    "a:r": paragraph.runs.map(createTextRunXml),
+    "a:endParaRPr": {}
+  };
+}
+function createParagraphPropertiesXml(properties) {
+  return {
+    ...properties.align !== void 0 ? { "@_algn": textAlignToken(properties.align) } : {},
+    ...properties.lineSpacing !== void 0 ? { "a:lnSpc": { "a:spcPts": { "@_val": String(properties.lineSpacing) } } } : {}
+  };
+}
+function createTextRunXml(run) {
+  return {
+    ...run.properties !== void 0 ? { "a:rPr": createTextRunPropertiesXml(run.properties) } : {},
+    "a:t": textElementValue(run.text)
+  };
+}
+function createTextRunPropertiesXml(properties) {
+  return {
+    ...properties.bold !== void 0 ? { "@_b": boolToken(properties.bold) } : {},
+    ...properties.italic !== void 0 ? { "@_i": boolToken(properties.italic) } : {},
+    ...properties.underline !== void 0 ? { "@_u": underlineStyleToken(properties.underline) } : {},
+    ...properties.strike !== void 0 ? { "@_strike": properties.strike ? "sngStrike" : "noStrike" } : {},
+    ...properties.baseline !== void 0 ? { "@_baseline": String(baselineToken(properties.baseline)) } : {},
+    ...properties.fontSize !== void 0 ? { "@_sz": String(Math.round(properties.fontSize * 100)) } : {},
+    ...properties.charSpacing !== void 0 ? { "@_spc": textPointToken(properties.charSpacing) } : {},
+    ...properties.outline !== void 0 ? { "a:ln": createTextOutlineXml(properties.outline) } : {},
+    ...properties.color !== void 0 ? { "a:solidFill": createSolidFillXml(properties.color) } : {},
+    ...properties.gradientFill !== void 0 ? { "a:gradFill": createGradientFillXml(properties.gradientFill) } : {},
+    ...properties.glow !== void 0 ? { "a:effectLst": { "a:glow": createGlowXml(properties.glow) } } : {},
+    ...properties.highlight !== void 0 ? { "a:highlight": createColorXml(properties.highlight) } : {},
+    ...properties.underline !== void 0 && typeof properties.underline !== "boolean" && properties.underline.color !== void 0 ? { "a:uFill": { "a:solidFill": createSolidFillXml(properties.underline.color) } } : {},
+    ...properties.fontFace !== void 0 ? {
+      "a:latin": { "@_typeface": properties.fontFace },
+      "a:ea": { "@_typeface": properties.fontFace },
+      "a:cs": { "@_typeface": properties.fontFace }
+    } : {}
+  };
+}
+function createSolidFillXml(color) {
+  return createColorXml(color);
+}
+function createColorXml(color) {
+  if (!/^[0-9A-Fa-f]{6}$/.test(color.hex)) {
+    throw new Error("buildTextBoxXml: color hex must be a 6-digit RGB value");
+  }
+  return {
+    "a:srgbClr": {
+      "@_val": color.hex.toUpperCase()
+    }
+  };
+}
+function createGradientFillXml(fill) {
+  return {
+    "a:gsLst": {
+      "a:gs": fill.stops.map((stop) => ({
+        "@_pos": String(stop.position),
+        ...createColorXml(stop.color)
+      }))
+    },
+    "a:lin": {
+      "@_ang": String(fill.angle ?? 0),
+      "@_scaled": "1"
+    }
+  };
+}
+function createTextOutlineXml(outline) {
+  return {
+    ...outline.width !== void 0 ? { "@_w": String(outline.width) } : {},
+    ...outline.color !== void 0 ? { "a:solidFill": createSolidFillXml(outline.color) } : {}
+  };
+}
+function createGlowXml(glow) {
+  return {
+    "@_rad": String(glow.radius),
+    ...createColorXml(glow.color)
+  };
+}
+function underlineStyleToken(underline) {
+  if (typeof underline === "boolean") return underline ? "sng" : "none";
+  return underline.style ?? "sng";
+}
+function baselineToken(baseline) {
+  if (baseline === "superscript") return 3e4;
+  return -25e3;
+}
+function textPointToken(value) {
+  if (!Number.isInteger(value) || value < -4e5 || value > 4e5) {
+    throw new Error("buildTextBoxXml: charSpacing must be an integer between -400000 and 400000");
+  }
+  return String(value);
+}
+function boolToken(value) {
+  return value ? "1" : "0";
+}
+function textAlignToken(align) {
+  switch (align) {
+    case "left":
+      return "l";
+    case "center":
+      return "ctr";
+    case "right":
+      return "r";
+    case "justify":
+      return "just";
+  }
+}
+function verticalAnchorToken(anchor) {
+  switch (anchor) {
+    case "top":
+      return "t";
+    case "middle":
+      return "ctr";
+    case "bottom":
+      return "b";
+  }
+}
 function buildConnectorXml(params) {
   return xmlBuilder.build({
     "p:cxnSp": {
@@ -8529,6 +8653,25 @@ var CONNECTOR_PRESETS = /* @__PURE__ */ new Set([
 ]);
 var ARROW_TYPES2 = /* @__PURE__ */ new Set(["triangle", "stealth", "diamond", "oval", "arrow"]);
 var ARROW_SIZES2 = /* @__PURE__ */ new Set(["sm", "med", "lg"]);
+var UNDERLINE_STYLES = /* @__PURE__ */ new Set([
+  "sng",
+  "dbl",
+  "heavy",
+  "dotted",
+  "dottedHeavy",
+  "dash",
+  "dashHeavy",
+  "dashLong",
+  "dashLongHeavy",
+  "dotDash",
+  "dotDashHeavy",
+  "dotDotDash",
+  "dotDotDashHeavy",
+  "wavy",
+  "wavyHeavy",
+  "wavyDbl",
+  "none"
+]);
 function findShapeNodeBySourceHandle(source, handle) {
   for (const slide of source.slides) {
     const shape = findShapeNodeInTree(slide.shapes, handle);
@@ -8698,7 +8841,9 @@ function addTextBox(source, slideHandle, input) {
     offsetY: input.offsetY,
     width: input.width,
     height: input.height,
-    text: input.text
+    ...input.rotation !== void 0 ? { rotation: input.rotation } : {},
+    ...input.paragraphs !== void 0 ? { paragraphs: input.paragraphs } : { text: input.text },
+    ...input.body !== void 0 ? { body: input.body } : {}
   });
   const shape = parseShapeNodeXml(xml, slide.partPath, orderingSlot);
   const slides = source.slides.map(
@@ -8935,13 +9080,208 @@ function assertTextBoxInput(input) {
   assertFiniteEmu(input.offsetY, "addTextBox", "offsetY");
   assertPositiveFiniteEmu(input.width, "addTextBox", "width");
   assertPositiveFiniteEmu(input.height, "addTextBox", "height");
-  if (typeof input.text !== "string") {
-    throw new Error("addTextBox: text must be a string");
+  if (input.rotation !== void 0) {
+    assertFiniteIntegerNumber(input.rotation, "addTextBox", "rotation");
+  }
+  if (input.text !== void 0 && input.paragraphs !== void 0) {
+    throw new Error("addTextBox: specify either text or paragraphs, not both");
+  }
+  if (input.text === void 0 && input.paragraphs === void 0) {
+    throw new Error("addTextBox: text or paragraphs must be provided");
+  }
+  if (input.text !== void 0 && typeof input.text !== "string") {
+    throw new Error("addTextBox: text must be a string when provided");
+  }
+  if (input.paragraphs !== void 0) {
+    assertTextBoxParagraphs(input.paragraphs);
+  }
+  if (input.body !== void 0) {
+    assertTextBoxBody(input.body, "body");
   }
   if (input.name !== void 0 && input.name.trim() === "") {
     throw new Error("addTextBox: name must be a non-empty string when provided");
   }
 }
+function assertTextBoxParagraphs(paragraphs) {
+  if (!isArrayValue(paragraphs) || paragraphs.length === 0) {
+    throw new Error("addTextBox: paragraphs must contain at least one paragraph");
+  }
+  paragraphs.forEach((paragraph, paragraphIndex) => {
+    if (!isPlainRecord(paragraph)) {
+      throw new Error(`addTextBox: paragraphs[${paragraphIndex}] must be an object`);
+    }
+    const runs = paragraph.runs;
+    if (!isArrayValue(runs) || runs.length === 0) {
+      throw new Error(
+        `addTextBox: paragraphs[${paragraphIndex}].runs must contain at least one run`
+      );
+    }
+    assertTextBoxParagraphProperties(paragraph.properties, paragraphIndex);
+    runs.forEach((run, runIndex) => assertTextBoxRun(run, paragraphIndex, runIndex));
+  });
+}
+function assertTextBoxParagraphProperties(properties, paragraphIndex) {
+  if (properties === void 0) return;
+  if (!isPlainRecord(properties)) {
+    throw new Error(`addTextBox: paragraphs[${paragraphIndex}].properties must be an object`);
+  }
+  const align = properties.align;
+  const lineSpacing = properties.lineSpacing;
+  if (align !== void 0 && align !== "left" && align !== "center" && align !== "right" && align !== "justify") {
+    throw new Error(`addTextBox: paragraphs[${paragraphIndex}].properties.align is not supported`);
+  }
+  if (lineSpacing !== void 0) {
+    assertPositiveFiniteIntegerNumber(
+      lineSpacing,
+      "addTextBox",
+      `paragraphs[${paragraphIndex}].properties.lineSpacing`
+    );
+  }
+}
+function assertTextBoxRun(run, paragraphIndex, runIndex) {
+  const path = `paragraphs[${paragraphIndex}].runs[${runIndex}]`;
+  if (!isPlainRecord(run)) {
+    throw new Error(`addTextBox: ${path} must be an object`);
+  }
+  if (typeof run.text !== "string") {
+    throw new Error(`addTextBox: ${path}.text must be a string`);
+  }
+  assertTextBoxRunProperties(run.properties, path);
+}
+function assertTextBoxRunProperties(properties, path) {
+  if (properties === void 0) return;
+  if (!isPlainRecord(properties)) {
+    throw new Error(`addTextBox: ${path}.properties must be an object`);
+  }
+  const fontFace = properties.fontFace;
+  const fontSize = properties.fontSize;
+  const color = properties.color;
+  const gradientFill = properties.gradientFill;
+  const underline = properties.underline;
+  const baseline = properties.baseline;
+  const highlight = properties.highlight;
+  const glow = properties.glow;
+  const outline = properties.outline;
+  const charSpacing = properties.charSpacing;
+  if (fontFace !== void 0 && (typeof fontFace !== "string" || fontFace.trim() === "")) {
+    throw new Error(`addTextBox: ${path}.properties.fontFace must be a non-empty string`);
+  }
+  if (fontSize !== void 0) {
+    assertPositiveFiniteNumber(fontSize, "addTextBox", `${path}.properties.fontSize`);
+  }
+  assertBooleanOrUndefined(properties.bold, "addTextBox", `${path}.properties.bold`);
+  assertBooleanOrUndefined(properties.italic, "addTextBox", `${path}.properties.italic`);
+  assertBooleanOrUndefined(properties.strike, "addTextBox", `${path}.properties.strike`);
+  if (color !== void 0) assertTextBoxColor(color, `${path}.properties.color`);
+  if (gradientFill !== void 0) {
+    if (color !== void 0) {
+      throw new Error(`addTextBox: ${path}.properties cannot set both color and gradientFill`);
+    }
+    assertTextBoxGradientFill(gradientFill, `${path}.properties.gradientFill`);
+  }
+  if (underline !== void 0) {
+    assertTextBoxUnderline(underline, `${path}.properties.underline`);
+  }
+  if (baseline !== void 0) {
+    assertTextBoxBaseline(baseline, `${path}.properties.baseline`);
+  }
+  if (highlight !== void 0) {
+    assertTextBoxColor(highlight, `${path}.properties.highlight`);
+  }
+  if (glow !== void 0) assertTextBoxGlow(glow, `${path}.properties.glow`);
+  if (outline !== void 0) {
+    assertTextBoxOutline(outline, `${path}.properties.outline`);
+  }
+  if (charSpacing !== void 0) {
+    assertTextPointNumber(charSpacing, "addTextBox", `${path}.properties.charSpacing`);
+  }
+}
+function assertTextBoxColor(color, path) {
+  if (!isPlainRecord(color)) {
+    throw new Error(`addTextBox: ${path} must be an srgb 6-digit hex color`);
+  }
+  if (color.kind !== "srgb" || typeof color.hex !== "string" || !/^[0-9A-Fa-f]{6}$/.test(color.hex)) {
+    throw new Error(`addTextBox: ${path} must be an srgb 6-digit hex color`);
+  }
+}
+function assertTextBoxGradientFill(fill, path) {
+  if (!isPlainRecord(fill)) {
+    throw new Error(`addTextBox: ${path} must be a gradient fill object`);
+  }
+  const stops = fill.stops;
+  if (!isArrayValue(stops) || stops.length < 2) {
+    throw new Error(`addTextBox: ${path}.stops must contain at least two stops`);
+  }
+  if (fill.angle !== void 0)
+    assertFiniteIntegerNumber(fill.angle, "addTextBox", `${path}.angle`);
+  stops.forEach((stop, index) => {
+    if (!isPlainRecord(stop)) {
+      throw new Error(`addTextBox: ${path}.stops[${index}] must be an object`);
+    }
+    const position = stop.position;
+    assertFiniteIntegerNumber(position, "addTextBox", `${path}.stops[${index}].position`);
+    if (typeof position !== "number" || position < 0 || position > 1e5) {
+      throw new Error(`addTextBox: ${path}.stops[${index}].position must be between 0 and 100000`);
+    }
+    assertTextBoxColor(stop.color, `${path}.stops[${index}].color`);
+  });
+}
+function isArrayValue(value) {
+  return Array.isArray(value);
+}
+function assertTextBoxUnderline(underline, path) {
+  if (typeof underline === "boolean") return;
+  if (!isPlainRecord(underline)) {
+    throw new Error(`addTextBox: ${path} must be a boolean or underline options object`);
+  }
+  const style = underline.style ?? "sng";
+  if (typeof style !== "string" || !UNDERLINE_STYLES.has(style)) {
+    throw new Error(`addTextBox: ${path}.style is not supported`);
+  }
+  if (underline.color !== void 0) {
+    assertTextBoxColor(underline.color, `${path}.color`);
+  }
+}
+function assertTextBoxBaseline(baseline, path) {
+  if (baseline === "subscript" || baseline === "superscript") return;
+  throw new Error(`addTextBox: ${path} must be subscript or superscript`);
+}
+function assertTextBoxGlow(glow, path) {
+  if (!isPlainRecord(glow)) {
+    throw new Error(`addTextBox: ${path} must be an object`);
+  }
+  assertPositiveFiniteEmu(glow.radius, "addTextBox", `${path}.radius`);
+  assertTextBoxColor(glow.color, `${path}.color`);
+}
+function assertTextBoxOutline(outline, path) {
+  if (!isPlainRecord(outline)) {
+    throw new Error(`addTextBox: ${path} must be an object`);
+  }
+  if (outline.width === void 0 && outline.color === void 0) {
+    throw new Error(`addTextBox: ${path} must set width or color`);
+  }
+  if (outline.width !== void 0) {
+    assertPositiveFiniteEmu(outline.width, "addTextBox", `${path}.width`);
+  }
+  if (outline.color !== void 0) assertTextBoxColor(outline.color, `${path}.color`);
+}
+function assertTextBoxBody(body, path) {
+  if (!isPlainRecord(body)) {
+    throw new Error(`addTextBox: ${path} must be an object`);
+  }
+  if (body.anchor !== void 0 && body.anchor !== "top" && body.anchor !== "middle" && body.anchor !== "bottom") {
+    throw new Error("addTextBox: body.anchor is not supported");
+  }
+  if (body.marginLeft !== void 0)
+    assertFiniteEmu(body.marginLeft, "addTextBox", "body.marginLeft");
+  if (body.marginRight !== void 0) {
+    assertFiniteEmu(body.marginRight, "addTextBox", "body.marginRight");
+  }
+  if (body.marginTop !== void 0) assertFiniteEmu(body.marginTop, "addTextBox", "body.marginTop");
+  if (body.marginBottom !== void 0) {
+    assertFiniteEmu(body.marginBottom, "addTextBox", "body.marginBottom");
+  }
+}
 function assertConnectorInput(input) {
   assertFiniteEmu(input.offsetX, "addConnector", "offsetX");
   assertFiniteEmu(input.offsetY, "addConnector", "offsetY");
@@ -8980,13 +9320,39 @@ function assertArrowEndpoint(endpoint, fieldName) {
     throw new Error(`addConnector: outline.${fieldName}.length is not supported`);
   }
 }
+function assertBooleanOrUndefined(value, operationName, fieldName) {
+  if (value !== void 0 && typeof value !== "boolean") {
+    throw new Error(`${operationName}: ${fieldName} must be a boolean value`);
+  }
+}
+function assertFiniteIntegerNumber(value, operationName, fieldName) {
+  if (!Number.isInteger(value)) {
+    throw new Error(`${operationName}: ${fieldName} must be a finite integer`);
+  }
+}
+function assertPositiveFiniteNumber(value, operationName, fieldName) {
+  if (typeof value !== "number" || !Number.isFinite(value) || value <= 0) {
+    throw new Error(`${operationName}: ${fieldName} must be a finite positive number`);
+  }
+}
+function assertPositiveFiniteIntegerNumber(value, operationName, fieldName) {
+  if (typeof value !== "number" || !Number.isInteger(value) || value <= 0) {
+    throw new Error(`${operationName}: ${fieldName} must be a finite positive integer`);
+  }
+}
+function assertTextPointNumber(value, operationName, fieldName) {
+  assertFiniteIntegerNumber(value, operationName, fieldName);
+  if (typeof value !== "number" || value < -4e5 || value > 4e5) {
+    throw new Error(`${operationName}: ${fieldName} must be between -400000 and 400000`);
+  }
+}
 function assertFiniteEmu(value, operationName, fieldName) {
-  if (!Number.isFinite(value)) {
+  if (typeof value !== "number" || !Number.isFinite(value)) {
     throw new Error(`${operationName}: ${fieldName} must be a finite EMU value`);
   }
 }
 function assertPositiveFiniteEmu(value, operationName, fieldName) {
-  if (!Number.isFinite(value) || value <= 0) {
+  if (typeof value !== "number" || !Number.isFinite(value) || value <= 0) {
     throw new Error(`${operationName}: ${fieldName} must be a finite positive EMU value`);
   }
 }
@@ -16817,7 +17183,7 @@ function addTextBoxCommand(document, command) {
   requireFiniteEmu(command.offsetY, "addTextBox", "offsetY");
   requirePositiveFiniteEmu(command.width, "addTextBox", "width");
   requirePositiveFiniteEmu(command.height, "addTextBox", "height");
-  if (typeof command.text !== "string") {
+  if (command.text !== void 0 && typeof command.text !== "string") {
     throw new Error("addTextBox: text must be a string");
   }
   if (command.name !== void 0 && command.name.trim() === "") {

package/dist/browser.js

@@ -1,6 +1,6 @@
 import {
   collectUsedFonts
-} from "./chunk-KY3SYR3V.js";
+} from "./chunk-OOQWOZHT.js";
 import {
   DEFAULT_OUTPUT_WIDTH,
   addConnector,
@@ -30,7 +30,7 @@ import {
   unsafeBrandAssertion,
   updateShapeTransform,
   writePptx
-} from "./chunk-CX4ZDTKK.js";
+} from "./chunk-VBQRNQOT.js";
 import {
   DEFAULT_FONT_MAPPING,
   clearFontCache,
@@ -3096,7 +3096,7 @@ function addTextBoxCommand(document, command) {
   requireFiniteEmu(command.offsetY, "addTextBox", "offsetY");
   requirePositiveFiniteEmu(command.width, "addTextBox", "width");
   requirePositiveFiniteEmu(command.height, "addTextBox", "height");
-  if (typeof command.text !== "string") {
+  if (command.text !== void 0 && typeof command.text !== "string") {
     throw new Error("addTextBox: text must be a string");
   }
   if (command.name !== void 0 && command.name.trim() === "") {

package/dist/{chunk-KY3SYR3V.js → chunk-OOQWOZHT.js}

@@ -1,7 +1,7 @@
 import {
   createComputedView,
   readPptx
-} from "./chunk-CX4ZDTKK.js";
+} from "./chunk-VBQRNQOT.js";
 
 // src/font/font-collector.ts
 var DEFAULT_THEME_FONTS = {

package/dist/{chunk-KELC7JQK.js → chunk-Q3ZCUUGG.js}

@@ -2,7 +2,7 @@ import {
   DEFAULT_OUTPUT_WIDTH,
   convertPptxToSvg,
   renderPptxSourceModelToSvg
-} from "./chunk-CX4ZDTKK.js";
+} from "./chunk-VBQRNQOT.js";
 
 // src/converter.ts
 async function convertPptxToSvg2(input, options) {

package/dist/{chunk-CX4ZDTKK.js → chunk-VBQRNQOT.js}

@@ -6773,6 +6773,7 @@ var xmlBuilder = new XMLBuilder({
   suppressEmptyNode: true
 });
 function buildTextBoxXml(params) {
+  const paragraphs = params.paragraphs ?? [{ runs: [{ text: params.text ?? "" }] }];
   return xmlBuilder.build({
     "p:sp": {
       "p:nvSpPr": {
@@ -6787,6 +6788,7 @@ function buildTextBoxXml(params) {
       },
       "p:spPr": {
         "a:xfrm": {
+          ...params.rotation !== void 0 ? { "@_rot": String(params.rotation) } : {},
           "a:off": {
             "@_x": String(params.offsetX),
             "@_y": String(params.offsetY)
@@ -6806,20 +6808,142 @@ function buildTextBoxXml(params) {
         }
       },
       "p:txBody": {
-        "a:bodyPr": {
-          "@_wrap": "square"
-        },
+        "a:bodyPr": createTextBodyPropertiesXml(params.body),
         "a:lstStyle": {},
-        "a:p": {
-          "a:r": {
-            "a:t": textElementValue(params.text)
-          },
-          "a:endParaRPr": {}
-        }
+        "a:p": paragraphs.map(createParagraphXml)
       }
     }
   });
 }
+function createTextBodyPropertiesXml(body) {
+  return {
+    "@_wrap": "square",
+    ...body?.anchor !== void 0 ? { "@_anchor": verticalAnchorToken(body.anchor) } : {},
+    ...body?.marginLeft !== void 0 ? { "@_lIns": String(body.marginLeft) } : {},
+    ...body?.marginRight !== void 0 ? { "@_rIns": String(body.marginRight) } : {},
+    ...body?.marginTop !== void 0 ? { "@_tIns": String(body.marginTop) } : {},
+    ...body?.marginBottom !== void 0 ? { "@_bIns": String(body.marginBottom) } : {}
+  };
+}
+function createParagraphXml(paragraph) {
+  return {
+    ...paragraph.properties !== void 0 ? { "a:pPr": createParagraphPropertiesXml(paragraph.properties) } : {},
+    "a:r": paragraph.runs.map(createTextRunXml),
+    "a:endParaRPr": {}
+  };
+}
+function createParagraphPropertiesXml(properties) {
+  return {
+    ...properties.align !== void 0 ? { "@_algn": textAlignToken(properties.align) } : {},
+    ...properties.lineSpacing !== void 0 ? { "a:lnSpc": { "a:spcPts": { "@_val": String(properties.lineSpacing) } } } : {}
+  };
+}
+function createTextRunXml(run) {
+  return {
+    ...run.properties !== void 0 ? { "a:rPr": createTextRunPropertiesXml(run.properties) } : {},
+    "a:t": textElementValue(run.text)
+  };
+}
+function createTextRunPropertiesXml(properties) {
+  return {
+    ...properties.bold !== void 0 ? { "@_b": boolToken(properties.bold) } : {},
+    ...properties.italic !== void 0 ? { "@_i": boolToken(properties.italic) } : {},
+    ...properties.underline !== void 0 ? { "@_u": underlineStyleToken(properties.underline) } : {},
+    ...properties.strike !== void 0 ? { "@_strike": properties.strike ? "sngStrike" : "noStrike" } : {},
+    ...properties.baseline !== void 0 ? { "@_baseline": String(baselineToken(properties.baseline)) } : {},
+    ...properties.fontSize !== void 0 ? { "@_sz": String(Math.round(properties.fontSize * 100)) } : {},
+    ...properties.charSpacing !== void 0 ? { "@_spc": textPointToken(properties.charSpacing) } : {},
+    ...properties.outline !== void 0 ? { "a:ln": createTextOutlineXml(properties.outline) } : {},
+    ...properties.color !== void 0 ? { "a:solidFill": createSolidFillXml(properties.color) } : {},
+    ...properties.gradientFill !== void 0 ? { "a:gradFill": createGradientFillXml(properties.gradientFill) } : {},
+    ...properties.glow !== void 0 ? { "a:effectLst": { "a:glow": createGlowXml(properties.glow) } } : {},
+    ...properties.highlight !== void 0 ? { "a:highlight": createColorXml(properties.highlight) } : {},
+    ...properties.underline !== void 0 && typeof properties.underline !== "boolean" && properties.underline.color !== void 0 ? { "a:uFill": { "a:solidFill": createSolidFillXml(properties.underline.color) } } : {},
+    ...properties.fontFace !== void 0 ? {
+      "a:latin": { "@_typeface": properties.fontFace },
+      "a:ea": { "@_typeface": properties.fontFace },
+      "a:cs": { "@_typeface": properties.fontFace }
+    } : {}
+  };
+}
+function createSolidFillXml(color) {
+  return createColorXml(color);
+}
+function createColorXml(color) {
+  if (!/^[0-9A-Fa-f]{6}$/.test(color.hex)) {
+    throw new Error("buildTextBoxXml: color hex must be a 6-digit RGB value");
+  }
+  return {
+    "a:srgbClr": {
+      "@_val": color.hex.toUpperCase()
+    }
+  };
+}
+function createGradientFillXml(fill) {
+  return {
+    "a:gsLst": {
+      "a:gs": fill.stops.map((stop) => ({
+        "@_pos": String(stop.position),
+        ...createColorXml(stop.color)
+      }))
+    },
+    "a:lin": {
+      "@_ang": String(fill.angle ?? 0),
+      "@_scaled": "1"
+    }
+  };
+}
+function createTextOutlineXml(outline) {
+  return {
+    ...outline.width !== void 0 ? { "@_w": String(outline.width) } : {},
+    ...outline.color !== void 0 ? { "a:solidFill": createSolidFillXml(outline.color) } : {}
+  };
+}
+function createGlowXml(glow) {
+  return {
+    "@_rad": String(glow.radius),
+    ...createColorXml(glow.color)
+  };
+}
+function underlineStyleToken(underline) {
+  if (typeof underline === "boolean") return underline ? "sng" : "none";
+  return underline.style ?? "sng";
+}
+function baselineToken(baseline) {
+  if (baseline === "superscript") return 3e4;
+  return -25e3;
+}
+function textPointToken(value) {
+  if (!Number.isInteger(value) || value < -4e5 || value > 4e5) {
+    throw new Error("buildTextBoxXml: charSpacing must be an integer between -400000 and 400000");
+  }
+  return String(value);
+}
+function boolToken(value) {
+  return value ? "1" : "0";
+}
+function textAlignToken(align) {
+  switch (align) {
+    case "left":
+      return "l";
+    case "center":
+      return "ctr";
+    case "right":
+      return "r";
+    case "justify":
+      return "just";
+  }
+}
+function verticalAnchorToken(anchor) {
+  switch (anchor) {
+    case "top":
+      return "t";
+    case "middle":
+      return "ctr";
+    case "bottom":
+      return "b";
+  }
+}
 function buildConnectorXml(params) {
   return xmlBuilder.build({
     "p:cxnSp": {
@@ -6908,6 +7032,25 @@ var CONNECTOR_PRESETS = /* @__PURE__ */ new Set([
 ]);
 var ARROW_TYPES2 = /* @__PURE__ */ new Set(["triangle", "stealth", "diamond", "oval", "arrow"]);
 var ARROW_SIZES2 = /* @__PURE__ */ new Set(["sm", "med", "lg"]);
+var UNDERLINE_STYLES = /* @__PURE__ */ new Set([
+  "sng",
+  "dbl",
+  "heavy",
+  "dotted",
+  "dottedHeavy",
+  "dash",
+  "dashHeavy",
+  "dashLong",
+  "dashLongHeavy",
+  "dotDash",
+  "dotDashHeavy",
+  "dotDotDash",
+  "dotDotDashHeavy",
+  "wavy",
+  "wavyHeavy",
+  "wavyDbl",
+  "none"
+]);
 function findShapeNodeBySourceHandle(source, handle) {
   for (const slide of source.slides) {
     const shape = findShapeNodeInTree(slide.shapes, handle);
@@ -7077,7 +7220,9 @@ function addTextBox(source, slideHandle, input) {
     offsetY: input.offsetY,
     width: input.width,
     height: input.height,
-    text: input.text
+    ...input.rotation !== void 0 ? { rotation: input.rotation } : {},
+    ...input.paragraphs !== void 0 ? { paragraphs: input.paragraphs } : { text: input.text },
+    ...input.body !== void 0 ? { body: input.body } : {}
   });
   const shape = parseShapeNodeXml(xml, slide.partPath, orderingSlot);
   const slides = source.slides.map(
@@ -7314,13 +7459,208 @@ function assertTextBoxInput(input) {
   assertFiniteEmu(input.offsetY, "addTextBox", "offsetY");
   assertPositiveFiniteEmu(input.width, "addTextBox", "width");
   assertPositiveFiniteEmu(input.height, "addTextBox", "height");
-  if (typeof input.text !== "string") {
-    throw new Error("addTextBox: text must be a string");
+  if (input.rotation !== void 0) {
+    assertFiniteIntegerNumber(input.rotation, "addTextBox", "rotation");
+  }
+  if (input.text !== void 0 && input.paragraphs !== void 0) {
+    throw new Error("addTextBox: specify either text or paragraphs, not both");
+  }
+  if (input.text === void 0 && input.paragraphs === void 0) {
+    throw new Error("addTextBox: text or paragraphs must be provided");
+  }
+  if (input.text !== void 0 && typeof input.text !== "string") {
+    throw new Error("addTextBox: text must be a string when provided");
+  }
+  if (input.paragraphs !== void 0) {
+    assertTextBoxParagraphs(input.paragraphs);
+  }
+  if (input.body !== void 0) {
+    assertTextBoxBody(input.body, "body");
   }
   if (input.name !== void 0 && input.name.trim() === "") {
     throw new Error("addTextBox: name must be a non-empty string when provided");
   }
 }
+function assertTextBoxParagraphs(paragraphs) {
+  if (!isArrayValue(paragraphs) || paragraphs.length === 0) {
+    throw new Error("addTextBox: paragraphs must contain at least one paragraph");
+  }
+  paragraphs.forEach((paragraph, paragraphIndex) => {
+    if (!isPlainRecord(paragraph)) {
+      throw new Error(`addTextBox: paragraphs[${paragraphIndex}] must be an object`);
+    }
+    const runs = paragraph.runs;
+    if (!isArrayValue(runs) || runs.length === 0) {
+      throw new Error(
+        `addTextBox: paragraphs[${paragraphIndex}].runs must contain at least one run`
+      );
+    }
+    assertTextBoxParagraphProperties(paragraph.properties, paragraphIndex);
+    runs.forEach((run, runIndex) => assertTextBoxRun(run, paragraphIndex, runIndex));
+  });
+}
+function assertTextBoxParagraphProperties(properties, paragraphIndex) {
+  if (properties === void 0) return;
+  if (!isPlainRecord(properties)) {
+    throw new Error(`addTextBox: paragraphs[${paragraphIndex}].properties must be an object`);
+  }
+  const align = properties.align;
+  const lineSpacing = properties.lineSpacing;
+  if (align !== void 0 && align !== "left" && align !== "center" && align !== "right" && align !== "justify") {
+    throw new Error(`addTextBox: paragraphs[${paragraphIndex}].properties.align is not supported`);
+  }
+  if (lineSpacing !== void 0) {
+    assertPositiveFiniteIntegerNumber(
+      lineSpacing,
+      "addTextBox",
+      `paragraphs[${paragraphIndex}].properties.lineSpacing`
+    );
+  }
+}
+function assertTextBoxRun(run, paragraphIndex, runIndex) {
+  const path = `paragraphs[${paragraphIndex}].runs[${runIndex}]`;
+  if (!isPlainRecord(run)) {
+    throw new Error(`addTextBox: ${path} must be an object`);
+  }
+  if (typeof run.text !== "string") {
+    throw new Error(`addTextBox: ${path}.text must be a string`);
+  }
+  assertTextBoxRunProperties(run.properties, path);
+}
+function assertTextBoxRunProperties(properties, path) {
+  if (properties === void 0) return;
+  if (!isPlainRecord(properties)) {
+    throw new Error(`addTextBox: ${path}.properties must be an object`);
+  }
+  const fontFace = properties.fontFace;
+  const fontSize = properties.fontSize;
+  const color = properties.color;
+  const gradientFill = properties.gradientFill;
+  const underline = properties.underline;
+  const baseline = properties.baseline;
+  const highlight = properties.highlight;
+  const glow = properties.glow;
+  const outline = properties.outline;
+  const charSpacing = properties.charSpacing;
+  if (fontFace !== void 0 && (typeof fontFace !== "string" || fontFace.trim() === "")) {
+    throw new Error(`addTextBox: ${path}.properties.fontFace must be a non-empty string`);
+  }
+  if (fontSize !== void 0) {
+    assertPositiveFiniteNumber(fontSize, "addTextBox", `${path}.properties.fontSize`);
+  }
+  assertBooleanOrUndefined(properties.bold, "addTextBox", `${path}.properties.bold`);
+  assertBooleanOrUndefined(properties.italic, "addTextBox", `${path}.properties.italic`);
+  assertBooleanOrUndefined(properties.strike, "addTextBox", `${path}.properties.strike`);
+  if (color !== void 0) assertTextBoxColor(color, `${path}.properties.color`);
+  if (gradientFill !== void 0) {
+    if (color !== void 0) {
+      throw new Error(`addTextBox: ${path}.properties cannot set both color and gradientFill`);
+    }
+    assertTextBoxGradientFill(gradientFill, `${path}.properties.gradientFill`);
+  }
+  if (underline !== void 0) {
+    assertTextBoxUnderline(underline, `${path}.properties.underline`);
+  }
+  if (baseline !== void 0) {
+    assertTextBoxBaseline(baseline, `${path}.properties.baseline`);
+  }
+  if (highlight !== void 0) {
+    assertTextBoxColor(highlight, `${path}.properties.highlight`);
+  }
+  if (glow !== void 0) assertTextBoxGlow(glow, `${path}.properties.glow`);
+  if (outline !== void 0) {
+    assertTextBoxOutline(outline, `${path}.properties.outline`);
+  }
+  if (charSpacing !== void 0) {
+    assertTextPointNumber(charSpacing, "addTextBox", `${path}.properties.charSpacing`);
+  }
+}
+function assertTextBoxColor(color, path) {
+  if (!isPlainRecord(color)) {
+    throw new Error(`addTextBox: ${path} must be an srgb 6-digit hex color`);
+  }
+  if (color.kind !== "srgb" || typeof color.hex !== "string" || !/^[0-9A-Fa-f]{6}$/.test(color.hex)) {
+    throw new Error(`addTextBox: ${path} must be an srgb 6-digit hex color`);
+  }
+}
+function assertTextBoxGradientFill(fill, path) {
+  if (!isPlainRecord(fill)) {
+    throw new Error(`addTextBox: ${path} must be a gradient fill object`);
+  }
+  const stops = fill.stops;
+  if (!isArrayValue(stops) || stops.length < 2) {
+    throw new Error(`addTextBox: ${path}.stops must contain at least two stops`);
+  }
+  if (fill.angle !== void 0)
+    assertFiniteIntegerNumber(fill.angle, "addTextBox", `${path}.angle`);
+  stops.forEach((stop, index) => {
+    if (!isPlainRecord(stop)) {
+      throw new Error(`addTextBox: ${path}.stops[${index}] must be an object`);
+    }
+    const position = stop.position;
+    assertFiniteIntegerNumber(position, "addTextBox", `${path}.stops[${index}].position`);
+    if (typeof position !== "number" || position < 0 || position > 1e5) {
+      throw new Error(`addTextBox: ${path}.stops[${index}].position must be between 0 and 100000`);
+    }
+    assertTextBoxColor(stop.color, `${path}.stops[${index}].color`);
+  });
+}
+function isArrayValue(value) {
+  return Array.isArray(value);
+}
+function assertTextBoxUnderline(underline, path) {
+  if (typeof underline === "boolean") return;
+  if (!isPlainRecord(underline)) {
+    throw new Error(`addTextBox: ${path} must be a boolean or underline options object`);
+  }
+  const style = underline.style ?? "sng";
+  if (typeof style !== "string" || !UNDERLINE_STYLES.has(style)) {
+    throw new Error(`addTextBox: ${path}.style is not supported`);
+  }
+  if (underline.color !== void 0) {
+    assertTextBoxColor(underline.color, `${path}.color`);
+  }
+}
+function assertTextBoxBaseline(baseline, path) {
+  if (baseline === "subscript" || baseline === "superscript") return;
+  throw new Error(`addTextBox: ${path} must be subscript or superscript`);
+}
+function assertTextBoxGlow(glow, path) {
+  if (!isPlainRecord(glow)) {
+    throw new Error(`addTextBox: ${path} must be an object`);
+  }
+  assertPositiveFiniteEmu(glow.radius, "addTextBox", `${path}.radius`);
+  assertTextBoxColor(glow.color, `${path}.color`);
+}
+function assertTextBoxOutline(outline, path) {
+  if (!isPlainRecord(outline)) {
+    throw new Error(`addTextBox: ${path} must be an object`);
+  }
+  if (outline.width === void 0 && outline.color === void 0) {
+    throw new Error(`addTextBox: ${path} must set width or color`);
+  }
+  if (outline.width !== void 0) {
+    assertPositiveFiniteEmu(outline.width, "addTextBox", `${path}.width`);
+  }
+  if (outline.color !== void 0) assertTextBoxColor(outline.color, `${path}.color`);
+}
+function assertTextBoxBody(body, path) {
+  if (!isPlainRecord(body)) {
+    throw new Error(`addTextBox: ${path} must be an object`);
+  }
+  if (body.anchor !== void 0 && body.anchor !== "top" && body.anchor !== "middle" && body.anchor !== "bottom") {
+    throw new Error("addTextBox: body.anchor is not supported");
+  }
+  if (body.marginLeft !== void 0)
+    assertFiniteEmu(body.marginLeft, "addTextBox", "body.marginLeft");
+  if (body.marginRight !== void 0) {
+    assertFiniteEmu(body.marginRight, "addTextBox", "body.marginRight");
+  }
+  if (body.marginTop !== void 0) assertFiniteEmu(body.marginTop, "addTextBox", "body.marginTop");
+  if (body.marginBottom !== void 0) {
+    assertFiniteEmu(body.marginBottom, "addTextBox", "body.marginBottom");
+  }
+}
 function assertConnectorInput(input) {
   assertFiniteEmu(input.offsetX, "addConnector", "offsetX");
   assertFiniteEmu(input.offsetY, "addConnector", "offsetY");
@@ -7359,13 +7699,39 @@ function assertArrowEndpoint(endpoint, fieldName) {
     throw new Error(`addConnector: outline.${fieldName}.length is not supported`);
   }
 }
+function assertBooleanOrUndefined(value, operationName, fieldName) {
+  if (value !== void 0 && typeof value !== "boolean") {
+    throw new Error(`${operationName}: ${fieldName} must be a boolean value`);
+  }
+}
+function assertFiniteIntegerNumber(value, operationName, fieldName) {
+  if (!Number.isInteger(value)) {
+    throw new Error(`${operationName}: ${fieldName} must be a finite integer`);
+  }
+}
+function assertPositiveFiniteNumber(value, operationName, fieldName) {
+  if (typeof value !== "number" || !Number.isFinite(value) || value <= 0) {
+    throw new Error(`${operationName}: ${fieldName} must be a finite positive number`);
+  }
+}
+function assertPositiveFiniteIntegerNumber(value, operationName, fieldName) {
+  if (typeof value !== "number" || !Number.isInteger(value) || value <= 0) {
+    throw new Error(`${operationName}: ${fieldName} must be a finite positive integer`);
+  }
+}
+function assertTextPointNumber(value, operationName, fieldName) {
+  assertFiniteIntegerNumber(value, operationName, fieldName);
+  if (typeof value !== "number" || value < -4e5 || value > 4e5) {
+    throw new Error(`${operationName}: ${fieldName} must be between -400000 and 400000`);
+  }
+}
 function assertFiniteEmu(value, operationName, fieldName) {
-  if (!Number.isFinite(value)) {
+  if (typeof value !== "number" || !Number.isFinite(value)) {
     throw new Error(`${operationName}: ${fieldName} must be a finite EMU value`);
   }
 }
 function assertPositiveFiniteEmu(value, operationName, fieldName) {
-  if (!Number.isFinite(value) || value <= 0) {
+  if (typeof value !== "number" || !Number.isFinite(value) || value <= 0) {
     throw new Error(`${operationName}: ${fieldName} must be a finite positive EMU value`);
   }
 }

package/dist/cli.js

@@ -2,8 +2,8 @@
 import {
   convertPptxToPng,
   convertPptxToSvg
-} from "./chunk-KELC7JQK.js";
-import "./chunk-CX4ZDTKK.js";
+} from "./chunk-Q3ZCUUGG.js";
+import "./chunk-VBQRNQOT.js";
 import "./chunk-PGCREQQU.js";
 
 // src/cli-runner.ts

package/dist/index.js

@@ -1,12 +1,12 @@
 import {
   collectUsedFonts
-} from "./chunk-KY3SYR3V.js";
+} from "./chunk-OOQWOZHT.js";
 import {
   convertPptxToPng,
   convertPptxToSvg,
   renderPptxSourceModelToSvg
-} from "./chunk-KELC7JQK.js";
-import "./chunk-CX4ZDTKK.js";
+} from "./chunk-Q3ZCUUGG.js";
+import "./chunk-VBQRNQOT.js";
 import {
   DEFAULT_FONT_MAPPING,
   clearFontCache,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pptx-glimpse",
-  "version": "3.2.0",
+  "version": "3.2.1",
   "description": "A lightweight JavaScript library for rendering PowerPoint (.pptx) files as SVG or PNG in Node.js and the browser. No LibreOffice required.",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -50,10 +50,10 @@
     "fast-xml-parser": "^5.7.3",
     "fflate": "^0.8.2",
     "opentype.js": "1.3.4",
-    "@pptx-glimpse/document": "^0.4.0"
+    "@pptx-glimpse/document": "^0.5.0"
   },
   "devDependencies": {
-    "@pptx-glimpse/editor-core": "0.0.4",
+    "@pptx-glimpse/editor-core": "0.0.5",
     "@pptx-glimpse/renderer": "0.0.0"
   },
   "scripts": {