ooxml-core 1.19.1 → 1.20.0

package/dist/{chunk-ZJ2OKIJN.mjs → chunk-WXY5EDGT.mjs}

@@ -1,4 +1,4 @@
-import { NS, SMART_ART_DEFINITION_PARTS, VML_SHAPE_TAGS, isAlternateContentChoiceXmlSupported, parseVmlElement, unwrapAlternateContent, xmlChild, xmlAttr, parseDrawingMediaReference, cropShapeForPresetGeometry, isHeaderFooterPlaceholder, xmlPath, inheritedPlaceholderFieldType, parseParagraphLevel, xmlHasChild, parseParagraphExtraAttributes, parseParagraphMargins, parseAlignmentAttr, parseParagraphRtl, parseTabStops, resolveParagraphAlignment, xmlText, parseBodyPrBooleanAttrs, selectAlternateContentBranch, parseBulletSizePercent, extractColorChoiceXml, themeColorRefFromColorChoice, formatAutoNumberMarker, cloneXmlObject, parseParagraphSpacingPx, parseOoxmlPercent, createBuiltinVariables, resolveCoordinate, readPathListCommandOrder, parseAdjustmentValues, parseGuideDefinitions, evaluateGuides, orderedPathCommandEntries, ooxmlArcToSvg, inheritCustomGeometryCommandOrder, parseInkMlContent, parseModel3DScene, remapElementShapeIds, parseShapeId, isTemplateElementId, remapShapeIdReferences, reapplyAlternateContentToTree, openPptxZip, buildOle2, SHAPE_TREE_ELEMENT_TAGS, MAX_SHAPE_ID, orderedXmlKey, safeResolveZipPath, parseXml, elements, parseDataUrlToBytes, base64Decode, reorderObjectKeys, encodeCompressedPng, zlibStore, hash, concatArrays, encodePasswordUtf16LE, COLOR_MAP_ALIAS_KEYS, DEFAULT_COLOR_MAP, uint32LE, pptxActionToElementAction, buildClrMapOverrideXml, applyActiveXControlsToSlide, BLIP_FILL_ORDER, SP_PR_ORDER, ensureXmlChild, inkElementToStrokes, buildInkMlContent, ensureXmlChildOrCreate, isXmlNode, applyChartLayouts, stripXmlOrderSuffix, serializeTabStop, colorsEqual, generateFontGuid, applyBubbleChartOptions, applyChartUpDownBars, applyDataLabelsRangeToDLbls, applyChartAxisScaling, applyChartAxisLabelFormatting, upsertChartAxisChild, applyChartDateAxisUnits, applyChartAxisDisplayUnitsToXml, writeChartShapeProps, resolveTxPrDefRPr, buildDefRPrTextProperties, buildChartGradFillXml, applySeriesMarkerToXml, applySeriesDataPointsToXml, chartColorHex, applyChartManualLayout, chartTrendlineType, buildTrendlineLabel, serializeColorChoice, replaceOleEmbedding, findKey, collectAllText, buildNodeGuidMap, buildPresentationGuidMap, regenerateSmartArtDrawingShapes, buildFabricatedDrawingXml, buildFabricatedDiagramDataXml, DIAGRAM_DRAWING_CONTENT_TYPE, DIAGRAM_DRAWING_REL_TYPE, applyDiagramRelationshipIds, applyDrawingMediaReference, XML_PROLOG, DGM_XMLNS, xmlEscape, writeBodyPrBooleanAttrs, applyTextBodySp3d, customGeometryPathsToXml, ensureArrayValue, lookupPresetShape, writeShapeEffects, SHAPE_STYLE_ORDER, roundCoordinate, scaleVectorToIntegers, P14_GUIDE_URI, P15_GUIDE_URI, buildGuideListExtension, resetSpPrFormattingForStyleMatrix, restorePathListCommandOrder, fillIsPurelyStyleMatrix, serializeColorChoiceWithRef, createLineStyleGate, applyDrawingLineDash, getSignaturePathsToStrip, DIGITAL_SIGNATURE_ORIGIN_REL_TYPE, mergeSmartArtPointXml, mergeSmartArtConnectionXml, applySmartArtLayoutDefinition, obfuscateFont, containsConvertibleStrictNamespaceAttribute, convertXmlToStrict, applySeriesPictureOptionsToXml, findChartExtByUri, findChildByLocalName, regenerateClonedUniqueId, buildChartUniqueIdExtLst, createOfficeGuid, isContentPoint, newSmartArtGuid, parseChartUserShapesDrawing, DEFAULT_ROW_HEIGHT_EMU, createDefaultXmlCell, xmlChildren, applyChartGradientToSpPr, setAutoTitleDeleted, insertAt, replaceFirstText, shouldRebuildFromParagraphs, buildPointFromParagraphs, shouldRebuildFromRuns, buildPointFromRuns, buildPointText, tableCellTextBodyMatches, ensureXmlChildren, TC_PR_BORDERS_ORDER, writeChartColorChoice, openNestedZip, stripParentDirSegments, parseChartUniqueId, buildChartMarkerXml, chartGradientsEqual, chartColorChoiceValue, preservesSpreadsheetXmlWhitespace, buildEffectDagTreeFromXml, syncPictureShapeTypeWithCropShape, buildSrgbColorChoice, fetchUrlToBytes, parseChartWideTextStyle, parseDefRPrTextStyle, parseChartDataLabelOptions, shadowOffsetToDistanceAndDirection, positiveFixedAngleAttribute, xmlAttrNumber, parseCustomShows, parseShapeProps, parseActiveXControlsFromSlide, convertMetafileToDataUrl, first, children, ooxmlGradientAngleToCssDegrees, isAlternateContentChoiceSupported, detectStrictConformance, normalizeStrictXml, relayoutSmartArt, themeColorRefToSolidFillWithOpacity, FONT_ADVANCE_TABLES, DEFAULT_FONT_ADVANCE_TABLE, measureTextWidth, applyDrawingColorTransforms, applyThemeToData, detectFileFormat, parseOle2, EncryptedFileError, decryptPptx, encryptPptx, encodeXmlAttributeValue, encodeXmlTextValue, svgToCustomGeometryPaths, IncorrectPasswordError, parseEncryptionInfo, RC4_ALG_ID, isOle2CompoundFile, ENTRY_TYPE_ROOT, supportsChartGradientFill, DEFAULT_CHART_GRADIENT_ANGLE, backgroundRefNode, backgroundStylePreset, isDarkColorMap, backgroundStyleColorMap, reResolveElementsForColorMapChange, decodeXmlEntities, preservesXmlWhitespace, annotateCustomGeometryCommandOrder, annotateSmartArtTextOrder, stripXmlOrderMarkers, normalizeStShapeType, applyCustomShows, applySections, reorderObjectKeysByLocalName, PRESENTATION_CHILD_ORDER, applyKinsokuToXml, normalizeNamespaceUri, backgroundStyleRefIsCurrent, captureStyleBaseline, STYLE_MATRIX_FILL_KEYS, STYLE_MATRIX_LINE_KEYS, STYLE_MATRIX_EFFECT_KEYS, detectOleObjectType, inferOleExtensionFromTarget, findThemeEffectScheme, wrapFormatSchemeXml, effectIsPurelyStyleMatrix, deriveSlideTitles, parseP14DirectChild, parseP14FromExtLst, P14_TRANSITION_TYPES, parseSlideDrawingGuides, slideBackgroundStyleRefFromNode, cloneSlide, parseDrawingFraction, scrgbLinearToSrgb8, parseDrawingHueDegrees, hslToRgb, themeColorRefToXml, effectChild, mergeEffectNode, mergeAttributeEffectNode, prismFamilyFlags, prismFamilyTypeOfNode, prismFamilyTypeForFlags, P14_DIR_IS_ORIENTATION_TYPE, estimateMediaDurationMs, parseVmlElements, parseDrawingLineDash, parseLineSpacingMultiplier, parseLineSpacingExactPt, loadThemeVariants, parsePresentationDrawingGuides, parsePresentationSmartTags, resolveLayoutDisplayName, DEFAULT_MAX_UNCOMPRESSED_BYTES, guardZip, ZipBombError, MAX_ZIP_ENTRY_COUNT, detectDigitalSignatures, unwrapOleEmbedding, mimeTypeForOleFile, oleBytesToDataUrl, extractGuidFromPartName, deobfuscateFont, detectFontFormat, themeColorRefFromSchemeClr, parseKinsoku, parseLineStyle, parseChartUpDownBars, parseDataTable, parseChart3DSurfaces, parseChartAxes, parseBubbleChartOptions, parseChartLayouts, parseCxChartSeries, parseChartDataPointPictureBlipRel, parseSeriesDataPoints, parseMarker, parseSeriesDataLabels, parseChartDataPointPicture, parseImplicitBlipPictureFill, parseEmbeddedXlsx, relAttr, buildXml, chartTrendlineKind, parseChartManualLayout, parseDiagramRelationshipIds, parseSmartArtTextParagraphs, firstParagraphRuns, smartArtParagraphsText, parseSmartArtLayoutDefinition, parseSmartArtPresLayoutVars, readChartManualLayoutValues, parseSmartArtConnection, projectSmartArtNodeText, resolveSmartArtNodeStyleRoles, resolveSmartArtNodeCoherent3DOff, parseSmartArtDefinitionMetadata, parseSmartArtColorStyleLabels, buildSmartArtColorLists, buildSmartArtColorRoleMap, parseSmartArtQuickStyleLabels, resolveSmartArtEffectIntensity, parseSmartArtStyleLabelRefs, extractStyleReferenceColorXml, withThemePlaceholderColor, blendColorOntoWhite, CHART_ERROR_VALUE_TYPES, CHART_ERROR_BAR_TYPES, CHART_ERROR_BAR_DIRECTIONS } from './chunk-XTSHZGSM.mjs';
+import { NS, SMART_ART_DEFINITION_PARTS, VML_SHAPE_TAGS, isAlternateContentChoiceXmlSupported, parseVmlElement, unwrapAlternateContent, xmlChild, xmlAttr, parseDrawingMediaReference, cropShapeForPresetGeometry, isHeaderFooterPlaceholder, xmlPath, inheritedPlaceholderFieldType, parseParagraphLevel, xmlHasChild, parseParagraphExtraAttributes, parseParagraphMargins, parseAlignmentAttr, parseParagraphRtl, parseTabStops, resolveParagraphAlignment, xmlText, parseBodyPrBooleanAttrs, selectAlternateContentBranch, parseBulletSizePercent, extractColorChoiceXml, themeColorRefFromColorChoice, formatAutoNumberMarker, cloneXmlObject, parseParagraphSpacingPx, parseOoxmlPercent, createBuiltinVariables, resolveCoordinate, readPathListCommandOrder, parseAdjustmentValues, parseGuideDefinitions, evaluateGuides, orderedPathCommandEntries, ooxmlArcToSvg, inheritCustomGeometryCommandOrder, parseInkMlContent, parseModel3DScene, remapElementShapeIds, parseShapeId, isTemplateElementId, remapShapeIdReferences, reapplyAlternateContentToTree, openPptxZip, buildOle2, SHAPE_TREE_ELEMENT_TAGS, MAX_SHAPE_ID, orderedXmlKey, safeResolveZipPath, parseXml, elements, parseDataUrlToBytes, base64Decode, reorderObjectKeys, encodeCompressedPng, zlibStore, hash, concatArrays, encodePasswordUtf16LE, COLOR_MAP_ALIAS_KEYS, DEFAULT_COLOR_MAP, uint32LE, pptxActionToElementAction, buildClrMapOverrideXml, applyActiveXControlsToSlide, BLIP_FILL_ORDER, SP_PR_ORDER, ensureXmlChild, inkElementToStrokes, buildInkMlContent, ensureXmlChildOrCreate, isXmlNode, applyChartLayouts, stripXmlOrderSuffix, serializeTabStop, colorsEqual, generateFontGuid, applyBubbleChartOptions, applyChartUpDownBars, applyDataLabelsRangeToDLbls, applyChartAxisScaling, applyChartAxisLabelFormatting, upsertChartAxisChild, applyChartDateAxisUnits, applyChartAxisDisplayUnitsToXml, writeChartShapeProps, resolveTxPrDefRPr, buildDefRPrTextProperties, buildChartGradFillXml, applySeriesMarkerToXml, applySeriesDataPointsToXml, chartColorHex, applyChartManualLayout, chartTrendlineType, buildTrendlineLabel, serializeColorChoice, replaceOleEmbedding, findKey, collectAllText, buildNodeGuidMap, buildPresentationGuidMap, regenerateSmartArtDrawingShapes, buildFabricatedDrawingXml, buildFabricatedDiagramDataXml, DIAGRAM_DRAWING_CONTENT_TYPE, DIAGRAM_DRAWING_REL_TYPE, applyDiagramRelationshipIds, applyDrawingMediaReference, XML_PROLOG, DGM_XMLNS, xmlEscape, writeBodyPrBooleanAttrs, applyTextBodySp3d, customGeometryPathsToXml, ensureArrayValue, lookupPresetShape, writeShapeEffects, SHAPE_STYLE_ORDER, roundCoordinate, scaleVectorToIntegers, P14_GUIDE_URI, P15_GUIDE_URI, buildGuideListExtension, resetSpPrFormattingForStyleMatrix, restorePathListCommandOrder, fillIsPurelyStyleMatrix, serializeColorChoiceWithRef, createLineStyleGate, applyDrawingLineDash, getSignaturePathsToStrip, DIGITAL_SIGNATURE_ORIGIN_REL_TYPE, mergeSmartArtPointXml, mergeSmartArtConnectionXml, applySmartArtLayoutDefinition, obfuscateFont, containsConvertibleStrictNamespaceAttribute, convertXmlToStrict, applySeriesPictureOptionsToXml, findChartExtByUri, findChildByLocalName, regenerateClonedUniqueId, buildChartUniqueIdExtLst, createOfficeGuid, isContentPoint, newSmartArtGuid, parseChartUserShapesDrawing, DEFAULT_ROW_HEIGHT_EMU, createDefaultXmlCell, xmlChildren, applyChartGradientToSpPr, setAutoTitleDeleted, insertAt, replaceFirstText, shouldRebuildFromParagraphs, buildPointFromParagraphs, shouldRebuildFromRuns, buildPointFromRuns, buildPointText, tableCellTextBodyMatches, ensureXmlChildren, TC_PR_BORDERS_ORDER, writeChartColorChoice, openNestedZip, stripParentDirSegments, parseChartUniqueId, buildChartMarkerXml, chartGradientsEqual, chartColorChoiceValue, preservesSpreadsheetXmlWhitespace, buildEffectDagTreeFromXml, syncPictureShapeTypeWithCropShape, buildSrgbColorChoice, fetchUrlToBytes, parseChartWideTextStyle, parseDefRPrTextStyle, parseChartDataLabelOptions, shadowOffsetToDistanceAndDirection, positiveFixedAngleAttribute, xmlAttrNumber, parseCustomShows, parseShapeProps, parseActiveXControlsFromSlide, convertMetafileToDataUrl, first, children, ooxmlGradientAngleToCssDegrees, isAlternateContentChoiceSupported, detectStrictConformance, normalizeStrictXml, relayoutSmartArt, themeColorRefToSolidFillWithOpacity, FONT_ADVANCE_TABLES, DEFAULT_FONT_ADVANCE_TABLE, measureTextWidth, applyDrawingColorTransforms, applyThemeToData, detectFileFormat, parseOle2, EncryptedFileError, decryptPptx, encryptPptx, encodeXmlAttributeValue, encodeXmlTextValue, svgToCustomGeometryPaths, IncorrectPasswordError, parseEncryptionInfo, RC4_ALG_ID, isOle2CompoundFile, ENTRY_TYPE_ROOT, supportsChartGradientFill, DEFAULT_CHART_GRADIENT_ANGLE, decodeXmlEntities, preservesXmlWhitespace, annotateCustomGeometryCommandOrder, annotateSmartArtTextOrder, stripXmlOrderMarkers, normalizeStShapeType, applyCustomShows, applySections, reorderObjectKeysByLocalName, PRESENTATION_CHILD_ORDER, applyKinsokuToXml, normalizeNamespaceUri, backgroundStyleRefIsCurrent, backgroundRefNode, captureStyleBaseline, STYLE_MATRIX_FILL_KEYS, STYLE_MATRIX_LINE_KEYS, STYLE_MATRIX_EFFECT_KEYS, detectOleObjectType, inferOleExtensionFromTarget, backgroundStylePreset, isDarkColorMap, backgroundStyleColorMap, reResolveElementsForColorMapChange, deriveSlideTitles, parseP14DirectChild, parseP14FromExtLst, P14_TRANSITION_TYPES, parseSlideDrawingGuides, slideBackgroundStyleRefFromNode, cloneSlide, parseDrawingFraction, scrgbLinearToSrgb8, parseDrawingHueDegrees, hslToRgb, themeColorRefToXml, effectChild, mergeEffectNode, mergeAttributeEffectNode, findThemeEffectScheme, wrapFormatSchemeXml, effectIsPurelyStyleMatrix, prismFamilyFlags, prismFamilyTypeOfNode, prismFamilyTypeForFlags, P14_DIR_IS_ORIENTATION_TYPE, estimateMediaDurationMs, parseVmlElements, parseDrawingLineDash, parseLineSpacingMultiplier, parseLineSpacingExactPt, loadThemeVariants, parsePresentationDrawingGuides, parsePresentationSmartTags, resolveLayoutDisplayName, DEFAULT_MAX_UNCOMPRESSED_BYTES, guardZip, ZipBombError, MAX_ZIP_ENTRY_COUNT, detectDigitalSignatures, unwrapOleEmbedding, mimeTypeForOleFile, oleBytesToDataUrl, themeColorRefFromSchemeClr, extractGuidFromPartName, deobfuscateFont, detectFontFormat, parseKinsoku, parseLineStyle, parseChartUpDownBars, parseDataTable, parseChart3DSurfaces, parseChartAxes, parseBubbleChartOptions, parseChartLayouts, parseCxChartSeries, parseChartDataPointPictureBlipRel, parseSeriesDataPoints, parseMarker, parseSeriesDataLabels, parseChartDataPointPicture, parseImplicitBlipPictureFill, parseEmbeddedXlsx, relAttr, buildXml, chartTrendlineKind, parseChartManualLayout, parseDiagramRelationshipIds, parseSmartArtTextParagraphs, firstParagraphRuns, smartArtParagraphsText, parseSmartArtLayoutDefinition, parseSmartArtPresLayoutVars, readChartManualLayoutValues, parseSmartArtConnection, projectSmartArtNodeText, resolveSmartArtNodeStyleRoles, resolveSmartArtNodeCoherent3DOff, parseSmartArtDefinitionMetadata, parseSmartArtColorStyleLabels, buildSmartArtColorLists, buildSmartArtColorRoleMap, parseSmartArtQuickStyleLabels, resolveSmartArtEffectIntensity, parseSmartArtStyleLabelRefs, extractStyleReferenceColorXml, withThemePlaceholderColor, blendColorOntoWhite, CHART_ERROR_VALUE_TYPES, CHART_ERROR_BAR_TYPES, CHART_ERROR_BAR_DIRECTIONS } from './chunk-CC5UNZOO.mjs';
 import { hasShapeProperties, hasTextProperties } from './chunk-GXHKNSZX.mjs';
 import { EMU_PER_PX, EMU_PER_PIXEL, SYSTEM_COLOR_MAP, PRESET_COLOR_MAP, OOXML_PERCENT_UNITS, EMU_PER_POINT } from './chunk-CA7KCNL3.mjs';
 import JSZip from 'jszip';
@@ -4329,6 +4329,153 @@ function materializeInheritedShapeTransform(shape, element) {
   return transform2;
 }
 
+// pptx/core/utils/placeholder-xml.ts
+function findNonVisualProps(rawXml) {
+  for (const container of ["p:nvSpPr", "p:nvPicPr", "p:nvGraphicFramePr"]) {
+    const parent = rawXml[container];
+    const nvPr = parent?.["p:nvPr"];
+    if (nvPr) {
+      return nvPr;
+    }
+  }
+  return void 0;
+}
+function retargetPlaceholder(rawXml, target) {
+  const nvPr = findNonVisualProps(rawXml);
+  if (!nvPr) {
+    return;
+  }
+  const ph = nvPr["p:ph"] ?? {};
+  nvPr["p:ph"] = ph;
+  if (target.type) {
+    ph["@_type"] = target.type;
+  } else {
+    delete ph["@_type"];
+  }
+  if (target.idx !== void 0) {
+    ph["@_idx"] = target.idx;
+  } else {
+    delete ph["@_idx"];
+  }
+}
+function setRawXmlTransform(rawXml, xEmu, yEmu, cxEmu, cyEmu) {
+  const spPr = rawXml["p:spPr"];
+  if (!spPr) {
+    return;
+  }
+  const xfrm = spPr["a:xfrm"] ?? {};
+  spPr["a:xfrm"] = xfrm;
+  const off = xfrm["a:off"] ?? {};
+  xfrm["a:off"] = off;
+  off["@_x"] = String(xEmu);
+  off["@_y"] = String(yEmu);
+  const ext = xfrm["a:ext"] ?? {};
+  xfrm["a:ext"] = ext;
+  ext["@_cx"] = String(cxEmu);
+  ext["@_cy"] = String(cyEmu);
+}
+function createEmptyPlaceholderElement(target, xEmu, yEmu, cxEmu, cyEmu, uniqueId) {
+  if (cxEmu <= 0 || cyEmu <= 0) {
+    return null;
+  }
+  const phNode = {};
+  if (target.type) {
+    phNode["@_type"] = target.type;
+  }
+  if (target.idx !== void 0) {
+    phNode["@_idx"] = target.idx;
+  }
+  const rawXml = {
+    "p:nvSpPr": {
+      "p:cNvPr": {
+        "@_id": uniqueId,
+        "@_name": `Placeholder ${target.type || "content"}`
+      },
+      "p:cNvSpPr": {
+        "a:spLocks": { "@_noGrp": "1" }
+      },
+      "p:nvPr": {
+        "p:ph": phNode
+      }
+    },
+    "p:spPr": {
+      "a:xfrm": {
+        "a:off": { "@_x": String(xEmu), "@_y": String(yEmu) },
+        "a:ext": { "@_cx": String(cxEmu), "@_cy": String(cyEmu) }
+      }
+    },
+    "p:txBody": {
+      "a:bodyPr": {},
+      "a:lstStyle": {},
+      "a:p": { "a:endParaRPr": { "@_lang": "en-US" } }
+    }
+  };
+  return {
+    type: "text",
+    id: `ph-${target.type || "content"}-${target.idx ?? "0"}-${uniqueId}`,
+    x: Math.round(xEmu / EMU_PER_PX),
+    y: Math.round(yEmu / EMU_PER_PX),
+    width: Math.round(cxEmu / EMU_PER_PX),
+    height: Math.round(cyEmu / EMU_PER_PX),
+    text: "",
+    rawXml
+  };
+}
+
+// pptx/core/core/runtime/save-geometry-validation.ts
+var FRAME_FIELDS = ["x", "y", "width", "height"];
+var OPTIONAL_FIELDS = [
+  "xEmu",
+  "yEmu",
+  "widthEmu",
+  "heightEmu",
+  "rotation",
+  "skewX",
+  "skewY",
+  "chOffXEmu",
+  "chOffYEmu",
+  "chExtWidthEmu",
+  "chExtHeightEmu"
+];
+function omitsInheritedFrame(element) {
+  if (!["text", "shape", "picture", "media"].includes(element.type) || !element.rawXml)
+    return false;
+  if (!xmlHasChild(findNonVisualProps(element.rawXml), "p:ph")) return false;
+  if (xmlHasChild(xmlChild(element.rawXml, "p:spPr"), "a:xfrm") || xmlHasChild(element.rawXml, "p:xfrm"))
+    return false;
+  const baseline = element.inheritedTransform;
+  if (!baseline) return FRAME_FIELDS.every((key2) => element[key2] === void 0);
+  return FRAME_FIELDS.every(
+    (key2) => Number.isFinite(baseline[key2]) && (element[key2] === void 0 || element[key2] === baseline[key2])
+  ) && ["rotation", "skewX", "skewY", "flipHorizontal", "flipVertical"].every(
+    (key2) => (element[key2] ?? 0) === (baseline[key2] ?? 0)
+  );
+}
+function validateElementGeometry(element, context, emuPerPx = 9525) {
+  const inherited = omitsInheritedFrame(element);
+  const record2 = element;
+  const fields = [...inherited ? [] : FRAME_FIELDS, ...OPTIONAL_FIELDS];
+  for (const field of fields) {
+    const value = record2[field];
+    if (OPTIONAL_FIELDS.includes(field) && value === void 0) continue;
+    if (typeof value !== "number" || !Number.isFinite(value) || !Number.isFinite(value * emuPerPx)) {
+      throw new Error(
+        `${context}: element '${element.id}' (${element.name ?? "unnamed"}, type=${element.type}) has invalid ${field}=${String(value)}; expected a finite number`
+      );
+    }
+  }
+  if (element.type === "group") {
+    for (const child16 of element.children) validateElementGeometry(child16, context, emuPerPx);
+  }
+}
+function validateSlideGeometry(slides) {
+  for (const slide of slides) {
+    for (const element of slide.elements) {
+      validateElementGeometry(element, `Slide ${slide.slideNumber} (${slide.id})`);
+    }
+  }
+}
+
 // pptx/core/core/builders/PptxElementTransformUpdater.ts
 var PptxElementTransformUpdater = class {
   applyTransform(shape, element, emuPerPx, enclosingGroupChildSpace) {
@@ -4337,6 +4484,7 @@ var PptxElementTransformUpdater = class {
     if (!transform2) {
       return;
     }
+    validateElementGeometry(element, "Transform writer", emuPerPx);
     if (!transform2["a:off"]) {
       transform2["a:off"] = {};
     }
@@ -35491,6 +35639,75 @@ var PptxSaveConstantsFactory = class {
 var defaultPptxSaveConstantsFactory = new PptxSaveConstantsFactory();
 var createPptxSaveConstants = (conformance = "transitional") => defaultPptxSaveConstantsFactory.create(conformance);
 
+// pptx/core/utils/placeholder-remap.ts
+var TITLE_ROLE = /* @__PURE__ */ new Set(["title", "ctrtitle"]);
+var CONTENT_ROLE = /* @__PURE__ */ new Set([
+  "body",
+  "obj",
+  "subtitle",
+  "pic",
+  "chart",
+  "tbl",
+  "media",
+  "clipart",
+  "dgm"
+]);
+function placeholderContentRole(type) {
+  const declared = (type ?? "").trim().toLowerCase() || "body";
+  if (TITLE_ROLE.has(declared)) {
+    return "title";
+  }
+  if (CONTENT_ROLE.has(declared)) {
+    return "content";
+  }
+  return declared;
+}
+function preferredPlaceholderTypes(element) {
+  switch (element.type) {
+    case "image":
+    case "picture":
+      return ["pic", "obj", "body"];
+    case "chart":
+      return ["chart", "obj", "body"];
+    case "table":
+      return ["tbl", "obj", "body"];
+    case "media":
+    case "model3d":
+      return ["media", "pic", "obj", "body"];
+    case "smartArt":
+      return ["dgm", "obj", "body"];
+    case "text":
+      return ["body", "subtitle", "obj"];
+    default:
+      return ["obj", "body"];
+  }
+}
+function scorePlaceholderMatch(element, source, target) {
+  if (placeholderContentRole(source.type) !== placeholderContentRole(target.type)) {
+    return -1;
+  }
+  const sourceType = normalizeType(source.type);
+  const targetType = normalizeType(target.type);
+  let score = 1;
+  if (source.idx !== void 0 && source.idx === target.idx) {
+    score += 100;
+  }
+  if (sourceType === targetType) {
+    score += 50;
+  }
+  const preferred = preferredPlaceholderTypes(element).indexOf(targetType);
+  if (preferred >= 0) {
+    score += 30 - preferred * 5;
+  }
+  if (targetType === "obj") {
+    score += 10;
+  }
+  return score;
+}
+function normalizeType(type) {
+  return (type ?? "").trim().toLowerCase() || "body";
+}
+
 // pptx/core/core/runtime/master-save-helpers.ts
 function applyHeaderFooterFlagsToNode(root, flags) {
   if (!flags || Object.keys(flags).length === 0) {
@@ -53572,168 +53789,6 @@ function buildChartUserShapesDrawingXml(shapes) {
   return { "c:userShapes": root };
 }
 
-// pptx/core/utils/placeholder-remap.ts
-var TITLE_ROLE = /* @__PURE__ */ new Set(["title", "ctrtitle"]);
-var CONTENT_ROLE = /* @__PURE__ */ new Set([
-  "body",
-  "obj",
-  "subtitle",
-  "pic",
-  "chart",
-  "tbl",
-  "media",
-  "clipart",
-  "dgm"
-]);
-function placeholderContentRole(type) {
-  const declared = (type ?? "").trim().toLowerCase() || "body";
-  if (TITLE_ROLE.has(declared)) {
-    return "title";
-  }
-  if (CONTENT_ROLE.has(declared)) {
-    return "content";
-  }
-  return declared;
-}
-function preferredPlaceholderTypes(element) {
-  switch (element.type) {
-    case "image":
-    case "picture":
-      return ["pic", "obj", "body"];
-    case "chart":
-      return ["chart", "obj", "body"];
-    case "table":
-      return ["tbl", "obj", "body"];
-    case "media":
-    case "model3d":
-      return ["media", "pic", "obj", "body"];
-    case "smartArt":
-      return ["dgm", "obj", "body"];
-    case "text":
-      return ["body", "subtitle", "obj"];
-    default:
-      return ["obj", "body"];
-  }
-}
-function scorePlaceholderMatch(element, source, target) {
-  if (placeholderContentRole(source.type) !== placeholderContentRole(target.type)) {
-    return -1;
-  }
-  const sourceType = normalizeType(source.type);
-  const targetType = normalizeType(target.type);
-  let score = 1;
-  if (source.idx !== void 0 && source.idx === target.idx) {
-    score += 100;
-  }
-  if (sourceType === targetType) {
-    score += 50;
-  }
-  const preferred = preferredPlaceholderTypes(element).indexOf(targetType);
-  if (preferred >= 0) {
-    score += 30 - preferred * 5;
-  }
-  if (targetType === "obj") {
-    score += 10;
-  }
-  return score;
-}
-function normalizeType(type) {
-  return (type ?? "").trim().toLowerCase() || "body";
-}
-
-// pptx/core/utils/placeholder-xml.ts
-function findNonVisualProps(rawXml) {
-  for (const container of ["p:nvSpPr", "p:nvPicPr", "p:nvGraphicFramePr"]) {
-    const parent = rawXml[container];
-    const nvPr = parent?.["p:nvPr"];
-    if (nvPr) {
-      return nvPr;
-    }
-  }
-  return void 0;
-}
-function retargetPlaceholder(rawXml, target) {
-  const nvPr = findNonVisualProps(rawXml);
-  if (!nvPr) {
-    return;
-  }
-  const ph = nvPr["p:ph"] ?? {};
-  nvPr["p:ph"] = ph;
-  if (target.type) {
-    ph["@_type"] = target.type;
-  } else {
-    delete ph["@_type"];
-  }
-  if (target.idx !== void 0) {
-    ph["@_idx"] = target.idx;
-  } else {
-    delete ph["@_idx"];
-  }
-}
-function setRawXmlTransform(rawXml, xEmu, yEmu, cxEmu, cyEmu) {
-  const spPr = rawXml["p:spPr"];
-  if (!spPr) {
-    return;
-  }
-  const xfrm = spPr["a:xfrm"] ?? {};
-  spPr["a:xfrm"] = xfrm;
-  const off = xfrm["a:off"] ?? {};
-  xfrm["a:off"] = off;
-  off["@_x"] = String(xEmu);
-  off["@_y"] = String(yEmu);
-  const ext = xfrm["a:ext"] ?? {};
-  xfrm["a:ext"] = ext;
-  ext["@_cx"] = String(cxEmu);
-  ext["@_cy"] = String(cyEmu);
-}
-function createEmptyPlaceholderElement(target, xEmu, yEmu, cxEmu, cyEmu, uniqueId) {
-  if (cxEmu <= 0 || cyEmu <= 0) {
-    return null;
-  }
-  const phNode = {};
-  if (target.type) {
-    phNode["@_type"] = target.type;
-  }
-  if (target.idx !== void 0) {
-    phNode["@_idx"] = target.idx;
-  }
-  const rawXml = {
-    "p:nvSpPr": {
-      "p:cNvPr": {
-        "@_id": uniqueId,
-        "@_name": `Placeholder ${target.type || "content"}`
-      },
-      "p:cNvSpPr": {
-        "a:spLocks": { "@_noGrp": "1" }
-      },
-      "p:nvPr": {
-        "p:ph": phNode
-      }
-    },
-    "p:spPr": {
-      "a:xfrm": {
-        "a:off": { "@_x": String(xEmu), "@_y": String(yEmu) },
-        "a:ext": { "@_cx": String(cxEmu), "@_cy": String(cyEmu) }
-      }
-    },
-    "p:txBody": {
-      "a:bodyPr": {},
-      "a:lstStyle": {},
-      "a:p": { "a:endParaRPr": { "@_lang": "en-US" } }
-    }
-  };
-  return {
-    type: "text",
-    id: `ph-${target.type || "content"}-${target.idx ?? "0"}-${uniqueId}`,
-    x: Math.round(xEmu / EMU_PER_PX),
-    y: Math.round(yEmu / EMU_PER_PX),
-    width: Math.round(cxEmu / EMU_PER_PX),
-    height: Math.round(cyEmu / EMU_PER_PX),
-    text: "",
-    rawXml
-  };
-}
-
 // pptx/core/utils/text-fill-blip.ts
 function resolveTextFillBlip(blipFill, lookupTarget, resolveArchivePath, allowExternal) {
   const blip = blipFill["a:blip"];
@@ -73024,6 +73079,19 @@ var PptxHandlerRuntime54 = class _PptxHandlerRuntime extends PptxHandlerRuntime5
     return this.isStrictOoxml ? "strict" : "transitional";
   }
   async save(slides, options) {
+    validateSlideGeometry(slides);
+    const templates = [
+      ...options?.slideMasters ?? [],
+      ...options?.slideLayouts ?? [],
+      ...options?.slideMasters?.flatMap((master) => master.layouts ?? []) ?? [],
+      ...options?.notesMaster ? [options.notesMaster] : [],
+      ...options?.handoutMaster ? [options.handoutMaster] : []
+    ];
+    for (const template of templates) {
+      for (const element of template.elements ?? []) {
+        validateElementGeometry(element, `Template (${template.path})`);
+      }
+    }
     if (options?.outputFormat === "ppt") {
       return this.saveAsLegacyPpt(
         slides,
@@ -73953,8 +74021,7 @@ var PptxHandlerRuntime59 = class extends PptxHandlerRuntime58 {
     return this.scanPlaceholderBuckets(spTree, (info) => info?.type === type);
   }
   /** The layout and master counterparts of a placeholder, unmerged. */
-  findPlaceholderContexts(slidePath, expected) {
-    const layoutPath = this.resolveLayoutPathForSlide(slidePath);
+  findPlaceholderContexts(slidePath, expected, layoutPath = this.resolveLayoutPathForSlide(slidePath)) {
     if (!layoutPath) {
       return {};
     }
@@ -73966,10 +74033,11 @@ var PptxHandlerRuntime59 = class extends PptxHandlerRuntime58 {
     const master = this.findPlaceholderInShapeTree(masterSpTree, expected) ?? this.findSingletonPlaceholderInShapeTree(masterSpTree, expected);
     return { layout, master };
   }
-  findPlaceholderContext(slidePath, expected) {
+  findPlaceholderContext(slidePath, expected, layoutPath) {
     const { layout: layoutContext, master: masterContext } = this.findPlaceholderContexts(
       slidePath,
-      expected
+      expected,
+      layoutPath
     );
     if (!layoutContext) {
       return masterContext;
@@ -73995,8 +74063,8 @@ var PptxHandlerRuntime59 = class extends PptxHandlerRuntime58 {
    * a master `p:sp`), so the layout keeps winning exactly as it does when
    * both are shapes.
    */
-  findPlaceholderNode(slidePath, expected) {
-    const { layout, master } = this.findPlaceholderContexts(slidePath, expected);
+  findPlaceholderNode(slidePath, expected, layoutPath) {
+    const { layout, master } = this.findPlaceholderContexts(slidePath, expected, layoutPath);
     const firstNode2 = (context) => context?.shape ?? context?.picture ?? context?.graphicFrame;
     const layoutNode = firstNode2(layout);
     const masterNode = firstNode2(master);
@@ -74037,8 +74105,7 @@ var PptxHandlerRuntime59 = class extends PptxHandlerRuntime58 {
    * reference. Checks the layout cache first, then the master cache, and
    * merges them so that layout values take priority over master values.
    */
-  lookupPlaceholderDefaults(slidePath, phInfo) {
-    const layoutPath = this.resolveLayoutPathForSlide(slidePath);
+  lookupPlaceholderDefaults(slidePath, phInfo, layoutPath = this.resolveLayoutPathForSlide(slidePath)) {
     if (!layoutPath) {
       return void 0;
     }
@@ -76124,14 +76191,14 @@ var PptxHandlerRuntime66 = class extends PptxHandlerRuntime65 {
 
 // pptx/core/core/runtime/PptxHandlerRuntimeShapeParsing.ts
 var PptxHandlerRuntime67 = class _PptxHandlerRuntime extends PptxHandlerRuntime66 {
-  parseShape(shape, id, slidePath) {
+  parseShape(shape, id, slidePath, layoutPath) {
     try {
       const spPr = shape["p:spPr"];
       const slideRelationshipMap = slidePath ? this.slideRelsMap.get(slidePath) : void 0;
       const placeholderInfo = this.extractPlaceholderInfo(
         shape?.["p:nvSpPr"]?.["p:nvPr"]
       );
-      const inheritedPlaceholder = slidePath && placeholderInfo ? this.findPlaceholderContext(slidePath, placeholderInfo) : void 0;
+      const inheritedPlaceholder = (slidePath || layoutPath) && placeholderInfo ? this.findPlaceholderContext(slidePath ?? "", placeholderInfo, layoutPath) : void 0;
       const inheritedSpPr = inheritedPlaceholder?.shape?.["p:spPr"] || inheritedPlaceholder?.picture?.["p:spPr"];
       const effectiveSpPr = spPr ? {
         ...spPr,
@@ -76257,7 +76324,7 @@ var PptxHandlerRuntime67 = class _PptxHandlerRuntime extends PptxHandlerRuntime6
       );
       const linkedTxbxId = bodyPropResult.linkedTxbxId;
       const linkedTxbxSeq = bodyPropResult.linkedTxbxSeq;
-      const phDefaults = slidePath && placeholderInfo ? this.lookupPlaceholderDefaults(slidePath, placeholderInfo) : void 0;
+      const phDefaults = (slidePath || layoutPath) && placeholderInfo ? this.lookupPlaceholderDefaults(slidePath ?? "", placeholderInfo, layoutPath) : void 0;
       if (phDefaults) {
         this.applyPlaceholderBodyDefaults(textStyle, phDefaults);
       }
@@ -85226,8 +85293,175 @@ var PptxHandlerRuntime102 = class extends PptxHandlerRuntime101 {
   }
 };
 
-// pptx/core/core/runtime/PptxHandlerRuntimeImplementation.ts
+// pptx/core/core/runtime/sdk-placeholder.ts
+var TEXT_PLACEHOLDER_TYPES = /* @__PURE__ */ new Set([
+  "title",
+  "ctrtitle",
+  "subtitle",
+  "body",
+  "obj",
+  "dt",
+  "ftr",
+  "hdr",
+  "sldnum"
+]);
+function selectTextPlaceholder(input, type, options, slots) {
+  if (!TEXT_PLACEHOLDER_TYPES.has(type.toLowerCase())) {
+    throw new Error(`Unsupported text placeholder type: ${type}`);
+  }
+  if (options.idx !== void 0 && (!Number.isInteger(options.idx) || options.idx < 0 || options.idx > 4294967295)) {
+    throw new Error("Placeholder idx must be an unsigned 32-bit integer");
+  }
+  const source = {
+    type: type.toLowerCase(),
+    ...options.idx !== void 0 ? { idx: String(options.idx) } : {}
+  };
+  let best;
+  let bestScore = 0;
+  for (const slot of slots) {
+    if (!TEXT_PLACEHOLDER_TYPES.has(slot.phInfo.type ?? "obj")) continue;
+    if (source.idx !== void 0 && source.idx !== (slot.phInfo.idx ?? "0")) continue;
+    const score = scorePlaceholderMatch(input, source, slot.phInfo);
+    if (score > bestScore) {
+      best = slot;
+      bestScore = score;
+    }
+  }
+  return best ? { type: canonicalPlaceholderType(best.phInfo.type ?? "obj"), idx: best.phInfo.idx } : { type: canonicalPlaceholderType(source.type), idx: source.idx };
+}
+function withoutFallbackLanguage(properties) {
+  const { "@_lang": language, ...rest } = properties;
+  if (language !== "en-US") return properties;
+  const keys = Object.keys(rest);
+  return keys.length === 0 || keys.length === 1 && rest["@_dirty"] === "0" ? void 0 : rest;
+}
+function stripFallbackLanguage(node, key2) {
+  const properties = node[key2];
+  if (!properties || typeof properties !== "object") return node;
+  const next = withoutFallbackLanguage(properties);
+  if (next === properties) return node;
+  const result = {};
+  for (const [name, value] of Object.entries(node)) {
+    if (name !== key2) result[name] = value;
+    else if (next) result[name] = next;
+  }
+  return result;
+}
+function withoutFallbackLanguages(paragraphs) {
+  return paragraphs.map((paragraph) => {
+    const next = { ...stripFallbackLanguage(paragraph, "a:endParaRPr") };
+    for (const child16 of ["a:r", "a:br", "a:fld"]) {
+      const nodes = next[child16];
+      if (nodes === void 0) continue;
+      next[child16] = Array.isArray(nodes) ? nodes.map((node) => stripFallbackLanguage(node, "a:rPr")) : stripFallbackLanguage(nodes, "a:rPr");
+    }
+    return next;
+  });
+}
+function placeholderShape2(identity, paragraphs) {
+  paragraphs = withoutFallbackLanguages(paragraphs);
+  return {
+    "p:nvSpPr": {
+      "p:cNvPr": { "@_id": "2", "@_name": `Placeholder ${identity.type}` },
+      "p:cNvSpPr": { "a:spLocks": { "@_noGrp": "1" } },
+      "p:nvPr": {
+        "p:ph": {
+          "@_type": identity.type,
+          ...identity.idx !== void 0 ? { "@_idx": identity.idx } : {}
+        }
+      }
+    },
+    "p:spPr": {},
+    "p:txBody": { "a:bodyPr": {}, "a:lstStyle": {}, "a:p": paragraphs }
+  };
+}
+function applyPlaceholderFrame(shape, inherited, options, emuPerPx, materializeFrame = false) {
+  for (const key2 of ["x", "y", "width", "height"]) {
+    if (options[key2] !== void 0 && !Number.isFinite(options[key2])) {
+      throw new Error(`Invalid placeholder frame for ${key2}: expected a finite number`);
+    }
+  }
+  const off = xmlPath(inherited, "p:spPr", "a:xfrm", "a:off");
+  const ext = xmlPath(inherited, "p:spPr", "a:xfrm", "a:ext");
+  const frame = {
+    x: options.x ?? (off?.["@_x"] !== void 0 ? Number(off["@_x"]) / emuPerPx : void 0),
+    y: options.y ?? (off?.["@_y"] !== void 0 ? Number(off["@_y"]) / emuPerPx : void 0),
+    width: options.width ?? (ext?.["@_cx"] !== void 0 ? Number(ext["@_cx"]) / emuPerPx : void 0),
+    height: options.height ?? (ext?.["@_cy"] !== void 0 ? Number(ext["@_cy"]) / emuPerPx : void 0)
+  };
+  for (const [key2, value] of Object.entries(frame)) {
+    if (!Number.isFinite(value)) {
+      throw new Error(
+        `No matching placeholder frame for ${key2}; supply a complete explicit frame or choose a layout containing this slot`
+      );
+    }
+  }
+  if (materializeFrame || ["x", "y", "width", "height"].some((key2) => options[key2] !== void 0)) {
+    setRawXmlTransform(
+      shape,
+      ...["x", "y", "width", "height"].map(
+        (key2) => Math.round(frame[key2] * emuPerPx)
+      )
+    );
+  }
+}
+
+// pptx/core/core/runtime/PptxHandlerRuntimeSdkPlaceholders.ts
 var PptxHandlerRuntime103 = class _PptxHandlerRuntime extends PptxHandlerRuntime102 {
+  createPlaceholderElement(layoutPath, input, type, options) {
+    if (input.type !== "text") throw new Error("Placeholder input must be text");
+    const layout = this.layoutXmlMap.get(layoutPath);
+    if (!layout) throw new Error(`Unknown layout: ${layoutPath}`);
+    const identity = selectTextPlaceholder(
+      input,
+      type,
+      options,
+      this.extractLayoutPlaceholders(layout, layoutPath)
+    );
+    const shape = placeholderShape2(
+      identity,
+      this.createParagraphsFromTextContent(input.text, void 0, input.textSegments)
+    );
+    const inherited = this.findPlaceholderNode(
+      "",
+      { type: identity.type.toLowerCase(), idx: identity.idx },
+      layoutPath
+    );
+    const fallback = this.sdkMasterFrame(layoutPath, identity.type, identity.idx, inherited);
+    applyPlaceholderFrame(
+      shape,
+      fallback ?? inherited,
+      options,
+      _PptxHandlerRuntime.EMU_PER_PX,
+      fallback !== void 0
+    );
+    const element = this.parseShape(shape, input.id, void 0, layoutPath);
+    if (!element) throw new Error("Unable to resolve placeholder content");
+    if ((element.type === "text" || element.type === "shape") && !element.textStyle && element.textSegments?.[0]?.style) {
+      element.textStyle = { ...element.textSegments[0].style };
+    }
+    return element;
+  }
+  sdkMasterFrame(layoutPath, type, idx, inherited) {
+    if (!inherited) return void 0;
+    if (xmlPath(inherited, "p:spPr", "a:xfrm", "a:off") && xmlPath(inherited, "p:spPr", "a:xfrm", "a:ext"))
+      return void 0;
+    const masterPath = this.resolveMasterPathForLayout(layoutPath);
+    const tree = masterPath ? xmlPath(this.masterXmlMap.get(masterPath), "p:sldMaster", "p:cSld", "p:spTree") : void 0;
+    const role = placeholderContentRole(type.toLowerCase());
+    const candidates = this.ensureArray(tree?.["p:sp"]).filter((shape) => {
+      const info = this.extractPlaceholderInfo(xmlPath(shape, "p:nvSpPr", "p:nvPr"));
+      return info && placeholderContentRole(info.type) === role;
+    });
+    const master = candidates.find(
+      (shape) => this.extractPlaceholderInfo(xmlPath(shape, "p:nvSpPr", "p:nvPr"))?.idx === idx
+    ) ?? candidates[0];
+    return master ? this.mergeXmlObjects(master, inherited) : void 0;
+  }
+};
+
+// pptx/core/core/runtime/PptxHandlerRuntimeImplementation.ts
+var PptxHandlerRuntime104 = class _PptxHandlerRuntime extends PptxHandlerRuntime103 {
   constructor(dependencyFactory = new PptxRuntimeDependencyFactory()) {
     super();
     this.dependencyFactory = dependencyFactory;
@@ -85365,11 +85599,11 @@ var PptxHandlerRuntime103 = class _PptxHandlerRuntime extends PptxHandlerRuntime
 };
 
 // pptx/core/core/PptxHandlerRuntime.ts
-var PptxHandlerRuntime104 = class extends PptxHandlerRuntime103 {
+var PptxHandlerRuntime105 = class extends PptxHandlerRuntime104 {
 };
 
 // pptx/core/core/PptxHandlerRuntimeFactory.ts
-var createDefaultPptxHandlerRuntime = () => new PptxHandlerRuntime104();
+var createDefaultPptxHandlerRuntime = () => new PptxHandlerRuntime105();
 
 // pptx/core/ppt/current-user.ts
 var EncryptedPptError = class extends Error {
@@ -88175,6 +88409,13 @@ var PptxHandlerCore = class {
   getLayoutOptions() {
     return this.runtime.getLayoutOptions();
   }
+  /** Resolve a text placeholder in this loaded deck, preserving layout inheritance. */
+  createPlaceholderElement(layoutPath, input, type, options = {}) {
+    if (!this.runtime.createPlaceholderElement) {
+      throw new Error("This runtime does not support creating layout placeholders");
+    }
+    return this.runtime.createPlaceholderElement(layoutPath, input, type, options);
+  }
   /**
    * Build the artwork thumbnails backing the New Slide / Layout galleries.
    *
@@ -89488,13 +89729,14 @@ function createFreeformElement(pathData, options) {
 
 // pptx/core/builders/sdk/SlideBuilder.ts
 var SlideBuilder = class {
-  slide;
   /**
    * @param slideNumber - 1-based slide number.
    * @param layoutPath - Optional layout archive path.
    * @param layoutName - Optional layout display name.
+   * @param handler - Loaded deck context for placeholder geometry and text styles.
    */
-  constructor(slideNumber, layoutPath, layoutName) {
+  constructor(slideNumber, layoutPath, layoutName, handler) {
+    this.handler = handler;
     this.slide = {
       id: `slide${slideNumber}`,
       rId: `rId${slideNumber + 1}`,
@@ -89504,11 +89746,52 @@ var SlideBuilder = class {
       layoutName: layoutName ?? "Title Slide"
     };
   }
+  handler;
+  slide;
   /** Add a text box to the slide. */
   addText(text, options) {
     this.slide.elements.push(createTextElement(text, options));
     return this;
   }
+  /**
+   * Fill a layout placeholder, inheriting its frame and text styles.
+   *
+   * Unlike addText, this writes a real p:ph binding, not a free text box.
+   * Use idx to select repeated slots (for example, Two Content's 1 and 2).
+   * Explicit frame fields override the layout; all other fields inherit.
+   * A standalone builder requires the fourth constructor argument (a loaded
+   * handler), even with an explicit frame, so text styles resolve consistently.
+   * Missing slots without a complete frame throw instead of creating a text box.
+   * Master frames requiring compatible-role fallback are materialized locally
+   * for new content only, keeping existing-deck loading unchanged.
+   *
+   * @example
+   * ```ts
+   * createSlide('Title Slide')
+   *   .addPlaceholder('ctrTitle', 'Quarterly review')
+   *   .addPlaceholder('subTitle', 'October 2026');
+   * createSlide('Two Content').addPlaceholder('body', 'Right column', { idx: 2 });
+   * ```
+   */
+  addPlaceholder(type, text, options = {}) {
+    const input = createTextElement(text);
+    const context = `Slide ${this.slide.slideNumber} (${this.slide.id}), placeholder ${type} idx=${options.idx ?? "auto"}, layout ${this.slide.layoutName} (${this.slide.layoutPath})`;
+    try {
+      if (!this.handler) {
+        throw new Error(
+          "addPlaceholder requires a loaded handler as the fourth SlideBuilder constructor argument"
+        );
+      }
+      this.slide.elements.push(
+        this.handler.createPlaceholderElement(this.slide.layoutPath, input, type, options)
+      );
+    } catch (error) {
+      throw new Error(`${context}: ${error instanceof Error ? error.message : String(error)}`, {
+        cause: error
+      });
+    }
+    return this;
+  }
   /** Add a shape to the slide. */
   addShape(shapeType, options) {
     this.slide.elements.push(createShapeElement(shapeType, options));
@@ -89747,6 +90030,125 @@ var SlideBuilder = class {
   }
 };
 
+// pptx/core/builders/sdk/layout-operations.ts
+var EMU_PER_PIXEL4 = 9525;
+function pxToEmu(px) {
+  return Math.round(px * EMU_PER_PIXEL4);
+}
+function placeholderSpXml(ph, shapeId) {
+  const name = ph.name ?? `${ph.type.charAt(0).toUpperCase() + ph.type.slice(1)} Placeholder ${shapeId - 1}`;
+  const x = pxToEmu(ph.x);
+  const y = pxToEmu(ph.y);
+  const cx = pxToEmu(ph.width);
+  const cy = pxToEmu(ph.height);
+  const idxAttr = ph.idx !== void 0 ? ` idx="${Math.max(0, Math.round(ph.idx))}"` : "";
+  return `      <p:sp>
+        <p:nvSpPr>
+          <p:cNvPr id="${shapeId}" name="${escAttr(name)}"/>
+          <p:cNvSpPr><a:spLocks noGrp="1"/></p:cNvSpPr>
+          <p:nvPr><p:ph type="${escAttr(ph.type)}"${idxAttr}/></p:nvPr>
+        </p:nvSpPr>
+        <p:spPr>
+          <a:xfrm><a:off x="${x}" y="${y}"/><a:ext cx="${cx}" cy="${cy}"/></a:xfrm>
+        </p:spPr>
+        <p:txBody>
+          <a:bodyPr/>
+          <a:lstStyle/>
+          <a:p><a:endParaRPr lang="en-US"/></a:p>
+        </p:txBody>
+      </p:sp>`;
+}
+function normalizeSrgbHex(color2) {
+  if (!color2) {
+    return void 0;
+  }
+  const raw = color2.trim().replace(/^#/, "").toUpperCase();
+  if (/^[0-9A-F]{6}$/.test(raw)) {
+    return raw;
+  }
+  if (/^[0-9A-F]{3}$/.test(raw)) {
+    return raw.replace(/./g, (ch) => ch + ch);
+  }
+  return void 0;
+}
+function generateLayoutXml(definition) {
+  const layoutType = definition.type ?? "obj";
+  const placeholders = definition.placeholders ?? [];
+  const phShapes = placeholders.map((ph, i) => placeholderSpXml(ph, i + 2)).join("\n");
+  let bgXml = "";
+  const hex3 = normalizeSrgbHex(definition.backgroundColor);
+  if (hex3) {
+    bgXml = `    <p:bg><p:bgPr><a:solidFill><a:srgbClr val="${hex3}"/></a:solidFill><a:effectLst/></p:bgPr></p:bg>
+`;
+  }
+  return `<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
+<p:sldLayout xmlns:a="http://schemas.openxmlformats.org/drawingml/2006/main"
+  xmlns:r="http://schemas.openxmlformats.org/officeDocument/2006/relationships"
+  xmlns:p="http://schemas.openxmlformats.org/presentationml/2006/main"
+  type="${escAttr(layoutType)}" preserve="1">
+  <p:cSld name="${escAttr(definition.name)}">
+${bgXml}    <p:spTree>
+      <p:nvGrpSpPr><p:cNvPr id="1" name=""/><p:cNvGrpSpPr/><p:nvPr/></p:nvGrpSpPr>
+      <p:grpSpPr><a:xfrm><a:off x="0" y="0"/><a:ext cx="0" cy="0"/><a:chOff x="0" y="0"/><a:chExt cx="0" cy="0"/></a:xfrm></p:grpSpPr>
+${phShapes}
+    </p:spTree>
+  </p:cSld>
+  <p:clrMapOvr><a:masterClrMapping/></p:clrMapOvr>
+</p:sldLayout>`;
+}
+
+// pptx/core/builders/sdk/standard-layout-placeholders.ts
+function standardLayoutPlaceholders(type, width, height) {
+  if (type === "blank") return [];
+  const box = (type2, idx, x, y, w, h) => ({
+    type: type2,
+    idx,
+    x: x * width,
+    y: y * height,
+    width: w * width,
+    height: h * height
+  });
+  const title = box("title", 0, 0.05, 0.04, 0.9, 0.15);
+  const content2 = box("obj", 1, 0.05, 0.23, 0.9, 0.64);
+  let slots;
+  switch (type) {
+    case "title":
+      slots = [
+        box("ctrTitle", 0, 0.08, 0.24, 0.84, 0.22),
+        box("subTitle", 1, 0.12, 0.49, 0.76, 0.2)
+      ];
+      break;
+    case "secHead":
+      slots = [box("title", 0, 0.05, 0.37, 0.9, 0.2), box("body", 1, 0.05, 0.6, 0.9, 0.23)];
+      break;
+    case "twoObj":
+    case "twoTxTwoObj":
+      slots = [title, box("obj", 1, 0.05, 0.27, 0.43, 0.6), box("obj", 2, 0.52, 0.27, 0.43, 0.6)];
+      if (type === "twoTxTwoObj")
+        slots.push(box("body", 3, 0.05, 0.2, 0.43, 0.07), box("body", 4, 0.52, 0.2, 0.43, 0.07));
+      break;
+    case "titleOnly":
+      slots = [title];
+      break;
+    case "objTx":
+    case "picTx":
+      slots = [
+        title,
+        box(type === "picTx" ? "pic" : "obj", 1, 0.36, 0.23, 0.59, 0.64),
+        box("body", 2, 0.05, 0.23, 0.27, 0.64)
+      ];
+      break;
+    default:
+      slots = [title, content2];
+  }
+  return [
+    ...slots,
+    box("dt", 10, 0.05, 0.92, 0.25, 0.04),
+    box("ftr", 11, 0.33, 0.92, 0.34, 0.04),
+    box("sldNum", 12, 0.75, 0.92, 0.2, 0.04)
+  ];
+}
+
 // pptx/core/builders/sdk/PresentationBuilder.ts
 var DEFAULT_WIDTH = 12192e3;
 var DEFAULT_HEIGHT = 6858e3;
@@ -89766,7 +90168,7 @@ var DEFAULT_COLORS2 = {
 };
 var DEFAULT_MAJOR_FONT = "Calibri Light";
 var DEFAULT_MINOR_FONT = "Calibri";
-function normalizeSrgbHex(color2) {
+function normalizeSrgbHex2(color2) {
   if (!color2) {
     return void 0;
   }
@@ -89782,7 +90184,7 @@ function normalizeSrgbHex(color2) {
 function resolveThemeColors(overrides) {
   const resolved = {};
   for (const [key2, fallback] of Object.entries(DEFAULT_COLORS2)) {
-    resolved[key2] = normalizeSrgbHex(overrides?.[key2]) ?? normalizeSrgbHex(fallback) ?? "000000";
+    resolved[key2] = normalizeSrgbHex2(overrides?.[key2]) ?? normalizeSrgbHex2(fallback) ?? "000000";
   }
   return resolved;
 }
@@ -89939,21 +90341,6 @@ ${layoutRels}
   <Relationship Id="rId${layoutCount + 1}" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/theme" Target="../theme/theme1.xml"/>
 </Relationships>`;
 }
-function slideLayoutXml2(name, layoutType) {
-  return `<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
-<p:sldLayout xmlns:a="http://schemas.openxmlformats.org/drawingml/2006/main"
-  xmlns:r="http://schemas.openxmlformats.org/officeDocument/2006/relationships"
-  xmlns:p="http://schemas.openxmlformats.org/presentationml/2006/main"
-  type="${escAttr(layoutType)}" preserve="1">
-  <p:cSld name="${escAttr(name)}">
-    <p:spTree>
-      <p:nvGrpSpPr><p:cNvPr id="1" name=""/><p:cNvGrpSpPr/><p:nvPr/></p:nvGrpSpPr>
-      <p:grpSpPr><a:xfrm><a:off x="0" y="0"/><a:ext cx="0" cy="0"/><a:chOff x="0" y="0"/><a:chExt cx="0" cy="0"/></a:xfrm></p:grpSpPr>
-    </p:spTree>
-  </p:cSld>
-  <p:clrMapOvr><a:masterClrMapping/></p:clrMapOvr>
-</p:sldLayout>`;
-}
 function slideLayoutRelsXml() {
   return `<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
 <Relationships xmlns="http://schemas.openxmlformats.org/package/2006/relationships">
@@ -90102,7 +90489,14 @@ async function buildBlankPresentationArchive(options) {
   zip.file("ppt/slideMasters/_rels/slideMaster1.xml.rels", slideMasterRelsXml(layoutCount));
   for (let i = 0; i < layoutCount; i++) {
     const layout = STANDARD_LAYOUTS[i];
-    zip.file(`ppt/slideLayouts/slideLayout${i + 1}.xml`, slideLayoutXml2(layout.name, layout.type));
+    zip.file(
+      `ppt/slideLayouts/slideLayout${i + 1}.xml`,
+      generateLayoutXml({
+        name: layout.name,
+        type: layout.type,
+        placeholders: standardLayoutPlaceholders(layout.type, width / 9525, height / 9525)
+      })
+    );
     zip.file(`ppt/slideLayouts/_rels/slideLayout${i + 1}.xml.rels`, slideLayoutRelsXml());
   }
   for (let i = 0; i < initialSlideCount; i++) {
@@ -90139,7 +90533,7 @@ var PresentationBuilder = class {
       const layoutIdx = STANDARD_LAYOUTS.findIndex((l) => l.name === layoutName) + 1 || 7;
       const layoutPath = `ppt/slideLayouts/slideLayout${layoutIdx}.xml`;
       const resolvedName = layoutName ?? STANDARD_LAYOUTS[layoutIdx - 1]?.name ?? "Blank";
-      return new SlideBuilder(slideNum, layoutPath, resolvedName);
+      return new SlideBuilder(slideNum, layoutPath, resolvedName, handler);
     };
     return { handler, data, createSlide };
   }