pptx-kit 0.3.0 → 0.4.0

package/CHANGELOG.md

@@ -1,5 +1,35 @@
 # pptx-kit
 
+## 0.4.0
+
+### Minor Changes
+
+- 9809441: Chart label fonts, table cell merging, and aspect-ratio-preserving image placement
+
+  **`ChartTextStyle.font`** — chart titles, axis titles, axis tick labels,
+  legends, and data labels now accept a font face
+  (`titleStyle: { font: 'Yu Gothic' }`). The builder writes both
+  `<a:latin typeface>` and `<a:ea typeface>` so CJK families render
+  correctly in PowerPoint, and `getSlideCharts` / `getShapeChartSpec` read
+  the face back for round-trips. Works through both `addSlideChart` and
+  `setChartSpec`. (The SVG preview keeps its fixed substitution font set —
+  authored chart faces affect the emitted PPTX, not the preview raster.)
+
+  **`mergeTableCells(table, { row, col, rowSpan, colSpan })`** — the write
+  counterpart to `getTableCellSpan`. Merges a rectangular block into its
+  top-left anchor, emitting `gridSpan` / `rowSpan` on the anchor and
+  `hMerge` / `vMerge` on the covered cells per ECMA-376 §21.1.3.18.
+  Out-of-range blocks, 1×1 blocks, and overlaps with existing merges are
+  rejected with descriptive errors before anything is mutated.
+
+  **`fit: 'contain'` on `addSlideImage` / `setShapeImage`** — preserve the
+  image's aspect ratio instead of stretching to the target box. `'contain'`
+  inscribes and centers the image (natural size read from the PNG / JPEG
+  header); other formats fall back to the default `'fill'` (the existing
+  stretch behavior) rather than erroring. On `setShapeImage`,
+  `fit: 'contain'` re-fits the replacement image inside the picture's
+  current box.
+
 ## 0.3.0
 
 ### Minor Changes

package/dist/index.d.ts

@@ -1847,14 +1847,29 @@ declare const getCommentPosition: (comment: SlideCommentData) => CommentPosition
  */
 declare const getCommentSlide: (comment: SlideCommentData) => SlideData;
 
+/**
+ * How an image fills its target box:
+ *
+ *   - `'fill'` — stretch to the exact `w × h`, ignoring aspect ratio
+ *     (the historical behavior, and the default for back-compat).
+ *   - `'contain'` — scale to fit inside the box preserving aspect ratio,
+ *     then center the result. The box's empty margins stay transparent.
+ */
+type ImageFit = 'fill' | 'contain';
 /**
  * Replaces a picture's media with `bytes`. Same-format replacements
  * write in place; cross-format replacements allocate a new media part
- * and repoint the rel. The original geometry — crop, sizing, transform —
- * is preserved.
+ * and repoint the rel. The geometry — crop, transform — is preserved.
+ *
+ * Pass `options.fit: 'contain'` to re-fit the picture's extent to the
+ * replacement image's aspect ratio, inscribed and centered in the shape's
+ * current `(off, ext)` box. The default `'fill'` leaves the extent as-is
+ * (the historical behavior). When the new image's natural size can't be
+ * measured (non-PNG/JPEG), `'contain'` is a no-op rather than an error.
  */
 declare const setShapeImage: (shape: SlideShapeData, bytes: Uint8Array, options?: {
     format?: ImageFormat;
+    fit?: ImageFit;
 }) => void;
 
 /** What clicking the shape should do. */
@@ -2153,6 +2168,14 @@ type ChartGrouping = 'clustered' | 'stacked' | 'percentStacked' | 'standard';
  * renderer's default for this label position."
  */
 interface ChartTextStyle {
+    /**
+     * Font face applied to both the latin and east-asian typeface slots —
+     * `<a:rPr><a:latin typeface="…"/><a:ea typeface="…"/>`. East-asian is
+     * set alongside latin so a Japanese / CJK family (e.g. `'Yu Gothic'`)
+     * renders the labels instead of the renderer's latin-only fallback.
+     * Mirrors the latin/ea pairing PowerPoint emits for CJK chart fonts.
+     */
+    readonly font?: string;
     /** Font size in points. From `<a:rPr sz="N"/>` where N is in 100ths of a pt. */
     readonly sizePt?: number;
     /** Bold flag from `<a:rPr b="1"/>`. */
@@ -2830,6 +2853,34 @@ declare const getTableCellSpan: (cell: TableCellData) => {
     hMerge: boolean;
     vMerge: boolean;
 };
+/**
+ * Merges a rectangular block of table cells into a single visual cell.
+ *
+ * The block's top-left cell `(row, col)` becomes the anchor and carries
+ * `gridSpan` (= `colSpan`) / `rowSpan`; the cells it covers are marked
+ * `hMerge` / `vMerge` per ECMA-376 §21.1.3.18 (`CT_TableCell`) so the
+ * grid stays rectangular while PowerPoint paints only the anchor. This
+ * is the write counterpart to {@link getTableCellSpan}.
+ *
+ * Constraints, enforced loudly (these are authoring-boundary inputs):
+ *
+ *   - `rowSpan` / `colSpan` must be ≥ 1, and at least one must be > 1
+ *     (a 1×1 "merge" is a no-op the caller didn't mean).
+ *   - The block must lie fully inside the table grid.
+ *   - No cell in the block may already participate in another merge —
+ *     overlapping merges corrupt the grid and trip PowerPoint's repair
+ *     dialog. Split the existing merge first.
+ *
+ * The anchor cell's text is preserved; covered cells keep their own
+ * `<a:txBody>` in the XML (PowerPoint ignores it while the merge marker
+ * is set) so the operation stays losslessly reversible.
+ */
+declare const mergeTableCells: (table: SlideShapeData, block: {
+    readonly row: number;
+    readonly col: number;
+    readonly rowSpan: number;
+    readonly colSpan: number;
+}) => void;
 /**
  * One side of a cell's border, as read from `<a:tcPr><a:ln{L|R|T|B}>`.
  * `widthEmu` is the line width in EMU; `color` is `#RRGGBB` or `null`
@@ -3945,6 +3996,13 @@ declare const addSlideTable: (slide: SlideData, opts: {
  * rel, and appends a `<p:pic>` element to the slide's `<p:spTree>`.
  *
  * Format is detected from magic bytes; pass `opts.format` to override.
+ *
+ * `opts.fit` controls how the image fills the `w × h` box. `'fill'` (the
+ * default) stretches to the exact box, ignoring aspect ratio. `'contain'`
+ * scales the image to fit inside the box preserving its aspect ratio and
+ * centers it — measured from the PNG / JPEG header. For other formats (or
+ * an unreadable header) `'contain'` falls back to `'fill'` rather than
+ * erroring, since the natural size is unknown.
  */
 declare const addSlideImage: (slide: SlideData, bytes: Uint8Array, opts: {
     x: Emu;
@@ -3953,6 +4011,7 @@ declare const addSlideImage: (slide: SlideData, bytes: Uint8Array, opts: {
     h: Emu;
     format?: ImageFormat;
     name?: string;
+    fit?: ImageFit;
 }) => SlideShapeData;
 
 /** PowerPoint's user-visible layout name. */
@@ -5115,4 +5174,4 @@ declare const SLIDE_SIZE_16_10: SlideSize;
 
 declare const VERSION: string;
 
-export { type AllShapesEntry, type AnimationEffect, type AnimationOptions, type ArrowOptions, type BulletStyle, type ChartAxisScaling, type ChartDataLabelPosition, type ChartDataLabels, type ChartGrouping, type ChartKind, type ChartSeries, type ChartSpec, type ChartTextStyle, type ChartTrendline, type CommentAuthor, type CommentPosition, type CoreProperties, type CustomGeometry, type Emu, type ExtendedProperties, type GeomCommand, type GeomPath, type GeomPoint, type GlowOptions, type GradientFillOptions, type GradientStop, type ImageCrop, type ImageFormat, type IssueSeverity, type LineDash, type LineEndSize, type LineEndType, type MediaPart, type PackagePartInfo, type ParagraphAlignment, type ParagraphProperties, type PathFillMode, type PatternFillOptions, type PatternPreset, type PresentationChartEntry, type PresentationCommentEntry, type PresentationData, type PresentationFonts, type PresentationHyperlinkEntry, type PresentationImageEntry, type PresentationInput, type PresentationNotesEntry, type PresentationSize, type PresentationSummary, type PresentationTableEntry, type PresentationTheme, type PresentationThumbnail, type PresetShape, SLIDE_SIZE_16_10, SLIDE_SIZE_16_9, SLIDE_SIZE_4_3, type ShadowOptions, type ShapeBounds, type ShapeClickAction, type ShapeEffect, type ShapeEffectAny, type ShapeFill, type ShapeParagraphElement, type ShapeStroke, type SlideBackground, type SlideChartData, type SlideComment, type SlideCommentData, type SlideData, type SlideInfo, type SlideLayoutBackgroundShape, type SlideLayoutData, type SlideLayoutPlaceholder, type SlideOutlineEntry, type SlideSection, type SlideShapeData, type SlideSize, type TableCellBorder, type TableCellBorders, type TableCellData, type TableCellParagraph, type TextAnchor, type TextAutoFit, type TextFormat, type TextWrap, type TransitionEffect, type TransitionOptions, VERSION, type ValidationIssue, _internalPackageOf, addBlankSlide, addContentSlide, addSectionHeaderSlide, addSlide, addSlideAt, addSlideChart, addSlideComment, addSlideImage, addSlideLine, addSlideShape, addSlideTable, addSlideTextBox, addTitleSlide, appendShapeText, appendSlideNotes, bringShapeForward, bringShapeToFront, centerShapeOnSlide, clearAllHyperlinks, clearAllSlideComments, clearAllSlideNotes, clearShapeEffects, clearShapeFill, clearShapeStroke, clearSlideAnimations, clearSlideBackground, clearSlideComments, clearSlideHyperlinks, clearSlideShapes, clearSlideTransition, clearTableCellFill, cm, compactPackage, copyShape, createPresentation, duplicateSlide, duplicateSlideAt, emu, findChartByKind, findChartsBySeriesName, findChartsWithDataLabels, findChartsWithTrendlines, findCommentAuthorByName, findCommentsAfter, findCommentsBefore, findCommentsByAuthor, findCommentsByText, findEmptyPlaceholders, findFlippedShapes, findLayoutsWithPlaceholderType, findOverlappingShapePairs, findShapeById, findShapeByName, findShapeByText, findShapeInPresentation, findShapesAtPoint, findShapesByEffect, findShapesByHyperlink, findShapesByKind, findShapesByName, findShapesByPreset, findShapesByText, findShapesInRect, findShapesOutsideCanvas, findShapesWithAnimation, findShapesWithHyperlinks, findSlideByPartName, findSlideByText, findSlideByTitle, findSlideLayout, findSlideLayoutByPartName, findSlideLayoutByType, findSlidePlaceholder, findSlidePlaceholderByIdx, findSlidePlaceholders, findSlidesByHyperlink, findSlidesByLayoutName, findSlidesByLayoutPartName, findSlidesByLayoutType, findSlidesByNotes, findSlidesByText, findSlidesWithChartKind, findSlidesWithChartTrendlines, findSlidesWithCommentsByAuthor, getAllCharts, getAllComments, getAllHyperlinks, getAllImages, getAllNotes, getAllShapes, getAllTables, getCommentAuthor, getCommentAuthors, getCommentDate, getCommentPosition, getCommentSlide, getCommentText, getCommentsSortedByDate, getCoreProperties, getDistinctHyperlinkUrls, getEmptySlides, getExtendedProperties, getGroupChildren, getGroupTransform, getHiddenSlides, getMaxShapeId, getMaxShapeIdInPresentation, getMediaParts, getOrphanMediaPartNames, getOutlineText, getPackageSize, getParagraphAlignment, getParagraphBullet, getParagraphBulletImageBytes, getParagraphBulletStyle, getParagraphIndent, getParagraphLevel, getParagraphLineSpacing, getParagraphPropertiesEffective, getParagraphSpacing, getPresentationChartCountsBySlide, getPresentationChartKindCounts, getPresentationCommentCountsByAuthor, getPresentationCommentCountsBySlide, getPresentationCommenters, getPresentationCreated, getPresentationFonts, getPresentationHyperlinkCountsBySlide, getPresentationImageCountsBySlide, getPresentationModified, getPresentationNotesLength, getPresentationNotesLengthsBySlide, getPresentationNotesText, getPresentationShapeCountsBySlide, getPresentationSummary, getPresentationTableCountsBySlide, getPresentationText, getPresentationTextLength, getPresentationTextLengthsBySlide, getPresentationTheme, getShapeAdjustValues, getShapeAltTitle, getShapeAnimation, getShapeAt, getShapeBodyPrEffective, getShapeBounds, getShapeBoundsResolved, getShapeCenter, getShapeChartCategories, getShapeChartKind, getShapeChartSeriesNames, getShapeChartSeriesValues, getShapeChartSpec, getShapeClickAction, getShapeCustomGeometry, getShapeDescription, getShapeEffect, getShapeEffects, getShapeEffectsEffective, getShapeFill, getShapeFillColor, getShapeFillColorResolved, getShapeFillEffective, getShapeFlip, getShapeGradientFill, getShapeGradientFillEffective, getShapeHyperlink, getShapeHyperlinkTooltip, getShapeId, getShapeImageBiLevelThreshold, getShapeImageBrightness, getShapeImageBytes, getShapeImageContrast, getShapeImageCrop, getShapeImageDuotone, getShapeImageFillBytes, getShapeImageFormat, getShapeImageLinkUrl, getShapeImageOpacity, getShapeImagePartName, getShapeIndex, getShapeKind, getShapeName, getShapeParagraphCount, getShapeParagraphElements, getShapePatternFill, getShapePlaceholderIdx, getShapePlaceholderType, getShapePosition, getShapePreset, getShapeRotation, getShapeRunClickAction, getShapeRunCount, getShapeRunFormat, getShapeRunFormatEffective, getShapeRunHyperlink, getShapeRunHyperlinkTooltip, getShapeRunText, getShapeSize, getShapeSlide, getShapeStroke, getShapeStrokeArrow, getShapeStrokeCap, getShapeStrokeColor, getShapeStrokeColorResolved, getShapeStrokeCompound, getShapeStrokeDash, getShapeStrokeEffective, getShapeStrokeJoin, getShapeStrokeWidth, getShapeText, getShapeTextAnchor, getShapeTextAutoFit, getShapeTextAutoFitParams, getShapeTextBodyRotationDeg, getShapeTextColumns, getShapeTextDirection, getShapeTextMargins, getShapeTextWrap, getShapeXmlString, getShapeZIndex, getShapesBounds, getSlideAt, getSlideBackground, getSlideBackgroundGradientFill, getSlideBackgroundImageBytes, getSlideBackgroundPatternFill, getSlideBody, getSlideCharts, getSlideColorMapOverride, getSlideCommentAuthors, getSlideComments, getSlideCount, getSlideIndex, getSlideInfo, getSlideLayout, getSlideLayoutBackground, getSlideLayoutBackgroundGradientFill, getSlideLayoutBackgroundImageBytes, getSlideLayoutBackgroundPatternFill, getSlideLayoutBackgroundShapes, getSlideLayoutCount, getSlideLayoutName, getSlideLayoutPartName, getSlideLayoutPlaceholders, getSlideLayoutShapes, getSlideLayoutType, getSlideLayoutUsageCounts, getSlideLayoutUsageCountsByType, getSlideLayouts, getSlideMasterBackground, getSlideMasterBackgroundGradientFill, getSlideMasterBackgroundImageBytes, getSlideMasterBackgroundPatternFill, getSlideMasterCount, getSlideMasterPartName, getSlideMasterPartNames, getSlideMasterShapes, getSlideMasterUsageCounts, getSlideMediaPartNames, getSlideNotes, getSlideNotesLength, getSlideOutline, getSlidePartName, getSlideSections, getSlideShapes, getSlideSize, getSlideTables, getSlideText, getSlideTextLength, getSlideTitle, getSlideTransition, getSlideXmlString, getSlides, getSlidesByLayout, getSlidesWithCharts, getSlidesWithComments, getSlidesWithEmptyPlaceholders, getSlidesWithHyperlinks, getSlidesWithImages, getSlidesWithNotes, getSlidesWithOverlap, getSlidesWithTables, getTableCell, getTableCellAlignment, getTableCellAnchor, getTableCellBorders, getTableCellFill, getTableCellMargins, getTableCellParagraphs, getTableCellPosition, getTableCellSpan, getTableCellText, getTableCellTextDirection, getTableCells, getTableColumnWidths, getTableDimensions, getTableRowHeights, getTableSize, getTableStyleFlags, getTableStyleId, getThumbnail, getUnusedSlideLayouts, getUnusedSlideMasters, getVisibleSlides, hasShapeImage, hasShapeText, hasSlideNotes, importSlide, inches, incrementRevision, insertTableColumn, insertTableRow, isChartShape, isParagraphBulletPicture, isShapeHidden, isShapeImageGrayscale, isShapePlaceholder, isShapeTextBox, isSlideHidden, isTableShape, listPackageParts, loadPresentation, mergePresentations, mm, moveSlide, pointInShape, pt, readPackagePart, removeShape, removeSlide, removeSlideComment, removeSlideNotes, removeTableColumn, removeTableRow, removeThumbnail, renameShape, replaceHyperlink, replaceTextInNotes, replaceTextInPresentation, replaceTextInSlide, replaceTextInSlideNotes, replaceTokensInPresentation, replaceTokensInSlide, resolveDrawingColor, reverseSlides, savePresentation, searchSlides, sendShapeBackward, sendShapeToBack, setChartSpec, setCoreProperties, setExtendedProperties, setMediaPartBytes, setParagraphAlignment, setParagraphBullet, setParagraphLevel, setParagraphSpacing, setShapeAlignment, setShapeAltTitle, setShapeAnimation, setShapeBounds, setShapeBullets, setShapeClickAction, setShapeDescription, setShapeFill, setShapeFlip, setShapeGlow, setShapeGradientFill, setShapeHidden, setShapeHyperlink, setShapeImage, setShapeImageBrightness, setShapeImageContrast, setShapeImageCrop, setShapeImageFill, setShapeImageOpacity, setShapeNoFill, setShapeNoStroke, setShapePatternFill, setShapePosition, setShapeRotation, setShapeRunFormat, setShapeRunHyperlink, setShapeRunText, setShapeShadow, setShapeSize, setShapeStroke, setShapeStrokeArrow, setShapeStrokeCap, setShapeStrokeCompound, setShapeStrokeDash, setShapeStrokeJoin, setShapeText, setShapeTextAnchor, setShapeTextAutoFit, setShapeTextBodyRotationDeg, setShapeTextColumns, setShapeTextDirection, setShapeTextFormat, setShapeTextMargins, setShapeTextWrap, setShapeZIndex, setSlideBackground, setSlideBackgroundImage, setSlideBody, setSlideHidden, setSlideLayout, setSlideNotes, setSlidePlaceholders, setSlideSections, setSlideSize, setSlideTitle, setSlideTransition, setTableCellAlignment, setTableCellAnchor, setTableCellBorders, setTableCellFill, setTableCellMargins, setTableCellText, setTableCellTextDirection, setTableCellTextFormat, setTableColumnWidth, setTableRowHeight, setTableStyleFlags, setTableStyleId, setThumbnail, shapesOverlap, slideHasAnimations, slidesUsingMediaPart, sortSlides, swapSlides, touchModified, translateShapes, validatePresentation };
+export { type AllShapesEntry, type AnimationEffect, type AnimationOptions, type ArrowOptions, type BulletStyle, type ChartAxisScaling, type ChartDataLabelPosition, type ChartDataLabels, type ChartGrouping, type ChartKind, type ChartSeries, type ChartSpec, type ChartTextStyle, type ChartTrendline, type CommentAuthor, type CommentPosition, type CoreProperties, type CustomGeometry, type Emu, type ExtendedProperties, type GeomCommand, type GeomPath, type GeomPoint, type GlowOptions, type GradientFillOptions, type GradientStop, type ImageCrop, type ImageFit, type ImageFormat, type IssueSeverity, type LineDash, type LineEndSize, type LineEndType, type MediaPart, type PackagePartInfo, type ParagraphAlignment, type ParagraphProperties, type PathFillMode, type PatternFillOptions, type PatternPreset, type PresentationChartEntry, type PresentationCommentEntry, type PresentationData, type PresentationFonts, type PresentationHyperlinkEntry, type PresentationImageEntry, type PresentationInput, type PresentationNotesEntry, type PresentationSize, type PresentationSummary, type PresentationTableEntry, type PresentationTheme, type PresentationThumbnail, type PresetShape, SLIDE_SIZE_16_10, SLIDE_SIZE_16_9, SLIDE_SIZE_4_3, type ShadowOptions, type ShapeBounds, type ShapeClickAction, type ShapeEffect, type ShapeEffectAny, type ShapeFill, type ShapeParagraphElement, type ShapeStroke, type SlideBackground, type SlideChartData, type SlideComment, type SlideCommentData, type SlideData, type SlideInfo, type SlideLayoutBackgroundShape, type SlideLayoutData, type SlideLayoutPlaceholder, type SlideOutlineEntry, type SlideSection, type SlideShapeData, type SlideSize, type TableCellBorder, type TableCellBorders, type TableCellData, type TableCellParagraph, type TextAnchor, type TextAutoFit, type TextFormat, type TextWrap, type TransitionEffect, type TransitionOptions, VERSION, type ValidationIssue, _internalPackageOf, addBlankSlide, addContentSlide, addSectionHeaderSlide, addSlide, addSlideAt, addSlideChart, addSlideComment, addSlideImage, addSlideLine, addSlideShape, addSlideTable, addSlideTextBox, addTitleSlide, appendShapeText, appendSlideNotes, bringShapeForward, bringShapeToFront, centerShapeOnSlide, clearAllHyperlinks, clearAllSlideComments, clearAllSlideNotes, clearShapeEffects, clearShapeFill, clearShapeStroke, clearSlideAnimations, clearSlideBackground, clearSlideComments, clearSlideHyperlinks, clearSlideShapes, clearSlideTransition, clearTableCellFill, cm, compactPackage, copyShape, createPresentation, duplicateSlide, duplicateSlideAt, emu, findChartByKind, findChartsBySeriesName, findChartsWithDataLabels, findChartsWithTrendlines, findCommentAuthorByName, findCommentsAfter, findCommentsBefore, findCommentsByAuthor, findCommentsByText, findEmptyPlaceholders, findFlippedShapes, findLayoutsWithPlaceholderType, findOverlappingShapePairs, findShapeById, findShapeByName, findShapeByText, findShapeInPresentation, findShapesAtPoint, findShapesByEffect, findShapesByHyperlink, findShapesByKind, findShapesByName, findShapesByPreset, findShapesByText, findShapesInRect, findShapesOutsideCanvas, findShapesWithAnimation, findShapesWithHyperlinks, findSlideByPartName, findSlideByText, findSlideByTitle, findSlideLayout, findSlideLayoutByPartName, findSlideLayoutByType, findSlidePlaceholder, findSlidePlaceholderByIdx, findSlidePlaceholders, findSlidesByHyperlink, findSlidesByLayoutName, findSlidesByLayoutPartName, findSlidesByLayoutType, findSlidesByNotes, findSlidesByText, findSlidesWithChartKind, findSlidesWithChartTrendlines, findSlidesWithCommentsByAuthor, getAllCharts, getAllComments, getAllHyperlinks, getAllImages, getAllNotes, getAllShapes, getAllTables, getCommentAuthor, getCommentAuthors, getCommentDate, getCommentPosition, getCommentSlide, getCommentText, getCommentsSortedByDate, getCoreProperties, getDistinctHyperlinkUrls, getEmptySlides, getExtendedProperties, getGroupChildren, getGroupTransform, getHiddenSlides, getMaxShapeId, getMaxShapeIdInPresentation, getMediaParts, getOrphanMediaPartNames, getOutlineText, getPackageSize, getParagraphAlignment, getParagraphBullet, getParagraphBulletImageBytes, getParagraphBulletStyle, getParagraphIndent, getParagraphLevel, getParagraphLineSpacing, getParagraphPropertiesEffective, getParagraphSpacing, getPresentationChartCountsBySlide, getPresentationChartKindCounts, getPresentationCommentCountsByAuthor, getPresentationCommentCountsBySlide, getPresentationCommenters, getPresentationCreated, getPresentationFonts, getPresentationHyperlinkCountsBySlide, getPresentationImageCountsBySlide, getPresentationModified, getPresentationNotesLength, getPresentationNotesLengthsBySlide, getPresentationNotesText, getPresentationShapeCountsBySlide, getPresentationSummary, getPresentationTableCountsBySlide, getPresentationText, getPresentationTextLength, getPresentationTextLengthsBySlide, getPresentationTheme, getShapeAdjustValues, getShapeAltTitle, getShapeAnimation, getShapeAt, getShapeBodyPrEffective, getShapeBounds, getShapeBoundsResolved, getShapeCenter, getShapeChartCategories, getShapeChartKind, getShapeChartSeriesNames, getShapeChartSeriesValues, getShapeChartSpec, getShapeClickAction, getShapeCustomGeometry, getShapeDescription, getShapeEffect, getShapeEffects, getShapeEffectsEffective, getShapeFill, getShapeFillColor, getShapeFillColorResolved, getShapeFillEffective, getShapeFlip, getShapeGradientFill, getShapeGradientFillEffective, getShapeHyperlink, getShapeHyperlinkTooltip, getShapeId, getShapeImageBiLevelThreshold, getShapeImageBrightness, getShapeImageBytes, getShapeImageContrast, getShapeImageCrop, getShapeImageDuotone, getShapeImageFillBytes, getShapeImageFormat, getShapeImageLinkUrl, getShapeImageOpacity, getShapeImagePartName, getShapeIndex, getShapeKind, getShapeName, getShapeParagraphCount, getShapeParagraphElements, getShapePatternFill, getShapePlaceholderIdx, getShapePlaceholderType, getShapePosition, getShapePreset, getShapeRotation, getShapeRunClickAction, getShapeRunCount, getShapeRunFormat, getShapeRunFormatEffective, getShapeRunHyperlink, getShapeRunHyperlinkTooltip, getShapeRunText, getShapeSize, getShapeSlide, getShapeStroke, getShapeStrokeArrow, getShapeStrokeCap, getShapeStrokeColor, getShapeStrokeColorResolved, getShapeStrokeCompound, getShapeStrokeDash, getShapeStrokeEffective, getShapeStrokeJoin, getShapeStrokeWidth, getShapeText, getShapeTextAnchor, getShapeTextAutoFit, getShapeTextAutoFitParams, getShapeTextBodyRotationDeg, getShapeTextColumns, getShapeTextDirection, getShapeTextMargins, getShapeTextWrap, getShapeXmlString, getShapeZIndex, getShapesBounds, getSlideAt, getSlideBackground, getSlideBackgroundGradientFill, getSlideBackgroundImageBytes, getSlideBackgroundPatternFill, getSlideBody, getSlideCharts, getSlideColorMapOverride, getSlideCommentAuthors, getSlideComments, getSlideCount, getSlideIndex, getSlideInfo, getSlideLayout, getSlideLayoutBackground, getSlideLayoutBackgroundGradientFill, getSlideLayoutBackgroundImageBytes, getSlideLayoutBackgroundPatternFill, getSlideLayoutBackgroundShapes, getSlideLayoutCount, getSlideLayoutName, getSlideLayoutPartName, getSlideLayoutPlaceholders, getSlideLayoutShapes, getSlideLayoutType, getSlideLayoutUsageCounts, getSlideLayoutUsageCountsByType, getSlideLayouts, getSlideMasterBackground, getSlideMasterBackgroundGradientFill, getSlideMasterBackgroundImageBytes, getSlideMasterBackgroundPatternFill, getSlideMasterCount, getSlideMasterPartName, getSlideMasterPartNames, getSlideMasterShapes, getSlideMasterUsageCounts, getSlideMediaPartNames, getSlideNotes, getSlideNotesLength, getSlideOutline, getSlidePartName, getSlideSections, getSlideShapes, getSlideSize, getSlideTables, getSlideText, getSlideTextLength, getSlideTitle, getSlideTransition, getSlideXmlString, getSlides, getSlidesByLayout, getSlidesWithCharts, getSlidesWithComments, getSlidesWithEmptyPlaceholders, getSlidesWithHyperlinks, getSlidesWithImages, getSlidesWithNotes, getSlidesWithOverlap, getSlidesWithTables, getTableCell, getTableCellAlignment, getTableCellAnchor, getTableCellBorders, getTableCellFill, getTableCellMargins, getTableCellParagraphs, getTableCellPosition, getTableCellSpan, getTableCellText, getTableCellTextDirection, getTableCells, getTableColumnWidths, getTableDimensions, getTableRowHeights, getTableSize, getTableStyleFlags, getTableStyleId, getThumbnail, getUnusedSlideLayouts, getUnusedSlideMasters, getVisibleSlides, hasShapeImage, hasShapeText, hasSlideNotes, importSlide, inches, incrementRevision, insertTableColumn, insertTableRow, isChartShape, isParagraphBulletPicture, isShapeHidden, isShapeImageGrayscale, isShapePlaceholder, isShapeTextBox, isSlideHidden, isTableShape, listPackageParts, loadPresentation, mergePresentations, mergeTableCells, mm, moveSlide, pointInShape, pt, readPackagePart, removeShape, removeSlide, removeSlideComment, removeSlideNotes, removeTableColumn, removeTableRow, removeThumbnail, renameShape, replaceHyperlink, replaceTextInNotes, replaceTextInPresentation, replaceTextInSlide, replaceTextInSlideNotes, replaceTokensInPresentation, replaceTokensInSlide, resolveDrawingColor, reverseSlides, savePresentation, searchSlides, sendShapeBackward, sendShapeToBack, setChartSpec, setCoreProperties, setExtendedProperties, setMediaPartBytes, setParagraphAlignment, setParagraphBullet, setParagraphLevel, setParagraphSpacing, setShapeAlignment, setShapeAltTitle, setShapeAnimation, setShapeBounds, setShapeBullets, setShapeClickAction, setShapeDescription, setShapeFill, setShapeFlip, setShapeGlow, setShapeGradientFill, setShapeHidden, setShapeHyperlink, setShapeImage, setShapeImageBrightness, setShapeImageContrast, setShapeImageCrop, setShapeImageFill, setShapeImageOpacity, setShapeNoFill, setShapeNoStroke, setShapePatternFill, setShapePosition, setShapeRotation, setShapeRunFormat, setShapeRunHyperlink, setShapeRunText, setShapeShadow, setShapeSize, setShapeStroke, setShapeStrokeArrow, setShapeStrokeCap, setShapeStrokeCompound, setShapeStrokeDash, setShapeStrokeJoin, setShapeText, setShapeTextAnchor, setShapeTextAutoFit, setShapeTextBodyRotationDeg, setShapeTextColumns, setShapeTextDirection, setShapeTextFormat, setShapeTextMargins, setShapeTextWrap, setShapeZIndex, setSlideBackground, setSlideBackgroundImage, setSlideBody, setSlideHidden, setSlideLayout, setSlideNotes, setSlidePlaceholders, setSlideSections, setSlideSize, setSlideTitle, setSlideTransition, setTableCellAlignment, setTableCellAnchor, setTableCellBorders, setTableCellFill, setTableCellMargins, setTableCellText, setTableCellTextDirection, setTableCellTextFormat, setTableColumnWidth, setTableRowHeight, setTableStyleFlags, setTableStyleId, setThumbnail, shapesOverlap, slideHasAnimations, slidesUsingMediaPart, sortSlides, swapSlides, touchModified, translateShapes, validatePresentation };

package/dist/index.js

@@ -850,6 +850,50 @@ var detectImageFormat = (bytes) => {
   if (/<svg[\s>]/.test(head)) return "svg";
   return null;
 };
+var readUint16Be = (bytes, at) => bytes[at] << 8 | bytes[at + 1];
+var readUint32Be = (bytes, at) => (
+  // `>>> 0` keeps the result an unsigned 32-bit int (a 4-byte PNG dimension
+  // with the high bit set would otherwise read as negative).
+  (bytes[at] << 24 | bytes[at + 1] << 16 | bytes[at + 2] << 8 | bytes[at + 3]) >>> 0
+);
+var pngSize = (bytes) => {
+  if (bytes.length < 24) return null;
+  const width = readUint32Be(bytes, 16);
+  const height = readUint32Be(bytes, 20);
+  if (width <= 0 || height <= 0) return null;
+  return { width, height };
+};
+var JPEG_SOF_EXCLUDED = /* @__PURE__ */ new Set([196, 200, 204]);
+var jpegSize = (bytes) => {
+  let offset = 2;
+  while (offset + 9 < bytes.length) {
+    if (bytes[offset] !== 255) {
+      offset++;
+      continue;
+    }
+    const marker = bytes[offset + 1];
+    if (marker === 255 || marker >= 208 && marker <= 217 || marker === 1) {
+      offset += 2;
+      continue;
+    }
+    const segmentLength = readUint16Be(bytes, offset + 2);
+    if (segmentLength < 2) return null;
+    if (marker >= 192 && marker <= 207 && !JPEG_SOF_EXCLUDED.has(marker)) {
+      const height = readUint16Be(bytes, offset + 5);
+      const width = readUint16Be(bytes, offset + 7);
+      if (width <= 0 || height <= 0) return null;
+      return { width, height };
+    }
+    offset += 2 + segmentLength;
+  }
+  return null;
+};
+var readImagePixelSize = (bytes) => {
+  const format = detectImageFormat(bytes);
+  if (format === "png") return pngSize(bytes);
+  if (format === "jpeg") return jpegSize(bytes);
+  return null;
+};
 var extensionForFormat = (format) => {
   switch (format) {
     case "jpeg":
@@ -3972,6 +4016,15 @@ var getCommentPosition = (comment2) => comment2[COMMENT_SNAPSHOT].position;
 var getCommentSlide = (comment2) => comment2[COMMENT_SLIDE];
 
 // src/api/fn/shape-image.ts
+var fitImageRect = (box, fit, naturalSize) => {
+  if (fit === "fill" || naturalSize === null) return box;
+  const scale = Math.min(box.w / naturalSize.width, box.h / naturalSize.height);
+  const w = Math.round(naturalSize.width * scale);
+  const h = Math.round(naturalSize.height * scale);
+  const x = box.x + Math.round((box.w - w) / 2);
+  const y = box.y + Math.round((box.h - h) / 2);
+  return { x, y, w, h };
+};
 var setShapeImage = (shape, bytes, options = {}) => {
   if (shape[SHAPE_SNAPSHOT].kind !== "picture") {
     throw new Error(
@@ -4004,27 +4057,43 @@ var setShapeImage = (shape, bytes, options = {}) => {
     if (!part) throw new Error(`media part missing: ${mediaName}`);
     part.data = bytes;
     part.contentType = newContentType;
-    return;
-  }
-  let nextN = 1;
-  const mediaPathRegex = /^\/ppt\/media\/image(\d+)\./;
-  for (const p of pkg.parts) {
-    const m = p.name.match(mediaPathRegex);
-    if (m?.[1] !== void 0) {
-      const num = Number.parseInt(m[1], 10);
-      if (Number.isFinite(num) && num >= nextN) nextN = num + 1;
+  } else {
+    let nextN = 1;
+    const mediaPathRegex = /^\/ppt\/media\/image(\d+)\./;
+    for (const p of pkg.parts) {
+      const m = p.name.match(mediaPathRegex);
+      if (m?.[1] !== void 0) {
+        const num = Number.parseInt(m[1], 10);
+        if (Number.isFinite(num) && num >= nextN) nextN = num + 1;
+      }
+    }
+    const newPartName = partName(`/ppt/media/image${nextN}.${newExtension}`);
+    const hasDefault = pkg.contentTypes.defaults.some(
+      (d) => d.extension.toLowerCase() === newExtension
+    );
+    if (!hasDefault) {
+      pkg.contentTypes.defaults.push({ extension: newExtension, contentType: newContentType });
+    }
+    pkg.addPart(newPartName, newContentType, bytes);
+    rel.target = `../media/image${nextN}.${newExtension}`;
+    pkg.setRels(slide[SLIDE_PART_NAME], rels);
+  }
+  if (options.fit === "contain") {
+    const pos = readPosition(shape[SHAPE_ELEMENT], "picture");
+    const size = readSize2(shape[SHAPE_ELEMENT], "picture");
+    const natural = readImagePixelSize(bytes);
+    if (pos !== null && size !== null && natural !== null) {
+      const fitted = fitImageRect(
+        { x: pos.x, y: pos.y, w: size.w, h: size.h },
+        "contain",
+        natural
+      );
+      setPosition(shape[SHAPE_ELEMENT], "picture", fitted.x, fitted.y);
+      setSize(shape[SHAPE_ELEMENT], "picture", fitted.w, fitted.h);
+      commitSlideData(slide);
+      refreshSlideData(slide);
     }
   }
-  const newPartName = partName(`/ppt/media/image${nextN}.${newExtension}`);
-  const hasDefault = pkg.contentTypes.defaults.some(
-    (d) => d.extension.toLowerCase() === newExtension
-  );
-  if (!hasDefault) {
-    pkg.contentTypes.defaults.push({ extension: newExtension, contentType: newContentType });
-  }
-  pkg.addPart(newPartName, newContentType, bytes);
-  rel.target = `../media/image${nextN}.${newExtension}`;
-  pkg.setRels(slide[SLIDE_PART_NAME], rels);
 };
 
 // src/api/fn/shape-click-action.ts
@@ -4666,6 +4735,11 @@ var rPrAttrsFromStyle = (style) => {
       })
     );
   }
+  if (style?.font !== void 0) {
+    const typeface = attr(qname("", "typeface", ""), style.font);
+    children.push(elem(a("latin"), { attrs: [typeface] }));
+    children.push(elem(a("ea"), { attrs: [typeface] }));
+  }
   return { attrs, children };
 };
 var titleElement = (title, style, rotationDeg) => {
@@ -5148,7 +5222,10 @@ var NAME_A_RPR = qname("a", "rPr", NS_A2);
 var NAME_A_DEF_RPR = qname("a", "defRPr", NS_A2);
 var NAME_A_PPR = qname("a", "pPr", NS_A2);
 var NAME_A_SRGB = qname("a", "srgbClr", NS_A2);
+var NAME_A_LATIN = qname("a", "latin", NS_A2);
+var ATTR_TYPEFACE2 = qname("", "typeface", "");
 var readRunStyle = (rPr) => {
+  let font;
   let sizePt;
   let bold;
   let italic;
@@ -5170,10 +5247,16 @@ var readRunStyle = (rPr) => {
       if (v !== null) color = `#${v.toUpperCase()}`;
     }
   }
-  if (sizePt === void 0 && bold === void 0 && italic === void 0 && color === void 0) {
+  const latin = firstChildElement(rPr, NAME_A_LATIN);
+  if (latin) {
+    const tf = getAttrValue(latin, ATTR_TYPEFACE2);
+    if (tf !== null && tf !== "") font = tf;
+  }
+  if (font === void 0 && sizePt === void 0 && bold === void 0 && italic === void 0 && color === void 0) {
     return void 0;
   }
   return {
+    ...font !== void 0 ? { font } : {},
     ...sizePt !== void 0 ? { sizePt } : {},
     ...bold !== void 0 ? { bold } : {},
     ...italic !== void 0 ? { italic } : {},
@@ -7309,6 +7392,78 @@ var getTableCellSpan = (cell) => {
     vMerge: vm === "1" || vm === "true"
   };
 };
+var ATTR_GRID_SPAN = qname("", "gridSpan", "");
+var ATTR_ROW_SPAN = qname("", "rowSpan", "");
+var ATTR_H_MERGE = qname("", "hMerge", "");
+var ATTR_V_MERGE = qname("", "vMerge", "");
+var setSpanAttr = (tc, name, value) => {
+  tc.attrs = tc.attrs.filter(
+    (a2) => !(a2.name.namespaceURI === "" && a2.name.localName === name.localName)
+  );
+  tc.attrs.push(attr(name, value));
+};
+var cellIsMergedAlready = (tc) => {
+  const gs = getAttrValue(tc, ATTR_GRID_SPAN);
+  const rs = getAttrValue(tc, ATTR_ROW_SPAN);
+  const hm = getAttrValue(tc, ATTR_H_MERGE);
+  const vm = getAttrValue(tc, ATTR_V_MERGE);
+  return gs !== null && Number.parseInt(gs, 10) > 1 || rs !== null && Number.parseInt(rs, 10) > 1 || hm === "1" || hm === "true" || vm === "1" || vm === "true";
+};
+var mergeTableCells = (table, block) => {
+  const { row, col, rowSpan, colSpan } = block;
+  if (!Number.isInteger(rowSpan) || !Number.isInteger(colSpan) || rowSpan < 1 || colSpan < 1) {
+    throw new RangeError(
+      `mergeTableCells: rowSpan / colSpan must be integers \u2265 1 (got ${rowSpan} \xD7 ${colSpan})`
+    );
+  }
+  if (rowSpan === 1 && colSpan === 1) {
+    throw new RangeError("mergeTableCells: a 1\xD71 block is not a merge");
+  }
+  if (!Number.isInteger(row) || !Number.isInteger(col) || row < 0 || col < 0) {
+    throw new RangeError(
+      `mergeTableCells: row / col must be non-negative integers (got ${row}, ${col})`
+    );
+  }
+  const cells = getTableCells(table);
+  const lastRow = row + rowSpan - 1;
+  const lastCol = col + colSpan - 1;
+  if (lastRow >= cells.length) {
+    throw new RangeError(
+      `mergeTableCells: block rows ${row}..${lastRow} exceed table height ${cells.length}`
+    );
+  }
+  for (let r2 = row; r2 <= lastRow; r2++) {
+    const rowCellsArr = cells[r2];
+    if (lastCol >= rowCellsArr.length) {
+      throw new RangeError(
+        `mergeTableCells: block cols ${col}..${lastCol} exceed row ${r2} width ${rowCellsArr.length}`
+      );
+    }
+  }
+  for (let r2 = row; r2 <= lastRow; r2++) {
+    for (let c2 = col; c2 <= lastCol; c2++) {
+      if (cellIsMergedAlready(cells[r2][c2][CELL_ELEMENT])) {
+        throw new Error(
+          `mergeTableCells: cell (${r2}, ${c2}) is already part of a merge; split it before re-merging`
+        );
+      }
+    }
+  }
+  for (let r2 = row; r2 <= lastRow; r2++) {
+    for (let c2 = col; c2 <= lastCol; c2++) {
+      const tc = cells[r2][c2][CELL_ELEMENT];
+      if (r2 === row && c2 === col) {
+        if (colSpan > 1) setSpanAttr(tc, ATTR_GRID_SPAN, String(colSpan));
+        if (rowSpan > 1) setSpanAttr(tc, ATTR_ROW_SPAN, String(rowSpan));
+        continue;
+      }
+      if (c2 > col) setSpanAttr(tc, ATTR_H_MERGE, "1");
+      if (r2 > row) setSpanAttr(tc, ATTR_V_MERGE, "1");
+    }
+  }
+  commitSlideData(table[SHAPE_SLIDE]);
+  refreshSlideData(table[SHAPE_SLIDE]);
+};
 var getTableCellBorders = (pres, cell) => {
   const tcPr = firstChildElement(cell[CELL_ELEMENT], NAME_A_TC_PR);
   const theme = getPresentationTheme(pres);
@@ -12513,14 +12668,19 @@ var addSlideImage = (slide, bytes, opts) => {
     targetMode: "Internal"
   });
   pkg.setRels(slide[SLIDE_PART_NAME], rels);
+  const rect = fitImageRect(
+    { x: opts.x, y: opts.y, w: opts.w, h: opts.h },
+    opts.fit ?? "fill",
+    readImagePixelSize(bytes)
+  );
   const pic = buildPicture({
     id: nextShapeId(slide),
     ...opts.name !== void 0 ? { name: opts.name } : {},
     rEmbed: newRId,
-    x: opts.x,
-    y: opts.y,
-    w: opts.w,
-    h: opts.h
+    x: rect.x,
+    y: rect.y,
+    w: rect.w,
+    h: rect.h
   });
   return appendAndReturnNewShape(slide, pic);
 };
@@ -13370,8 +13530,8 @@ var mergePresentations = (targetPres, sourcePres, targetLayout) => {
 };
 
 // src/api/index.ts
-var VERSION = "0.3.0" ;
+var VERSION = "0.4.0" ;
 
-export { SLIDE_SIZE_16_10, SLIDE_SIZE_16_9, SLIDE_SIZE_4_3, VERSION, _internalPackageOf, addBlankSlide, addContentSlide, addSectionHeaderSlide, addSlide, addSlideAt, addSlideChart, addSlideComment, addSlideImage, addSlideLine, addSlideShape, addSlideTable, addSlideTextBox, addTitleSlide, appendShapeText, appendSlideNotes, bringShapeForward, bringShapeToFront, centerShapeOnSlide, clearAllHyperlinks, clearAllSlideComments, clearAllSlideNotes, clearShapeEffects, clearShapeFill, clearShapeStroke, clearSlideAnimations, clearSlideBackground, clearSlideComments, clearSlideHyperlinks, clearSlideShapes, clearSlideTransition, clearTableCellFill, cm, compactPackage, copyShape, createPresentation, duplicateSlide, duplicateSlideAt, emu, findChartByKind, findChartsBySeriesName, findChartsWithDataLabels, findChartsWithTrendlines, findCommentAuthorByName, findCommentsAfter, findCommentsBefore, findCommentsByAuthor, findCommentsByText, findEmptyPlaceholders, findFlippedShapes, findLayoutsWithPlaceholderType, findOverlappingShapePairs, findShapeById, findShapeByName, findShapeByText, findShapeInPresentation, findShapesAtPoint, findShapesByEffect, findShapesByHyperlink, findShapesByKind, findShapesByName, findShapesByPreset, findShapesByText, findShapesInRect, findShapesOutsideCanvas, findShapesWithAnimation, findShapesWithHyperlinks, findSlideByPartName, findSlideByText, findSlideByTitle, findSlideLayout, findSlideLayoutByPartName, findSlideLayoutByType, findSlidePlaceholder, findSlidePlaceholderByIdx, findSlidePlaceholders, findSlidesByHyperlink, findSlidesByLayoutName, findSlidesByLayoutPartName, findSlidesByLayoutType, findSlidesByNotes, findSlidesByText, findSlidesWithChartKind, findSlidesWithChartTrendlines, findSlidesWithCommentsByAuthor, getAllCharts, getAllComments, getAllHyperlinks, getAllImages, getAllNotes, getAllShapes, getAllTables, getCommentAuthor, getCommentAuthors, getCommentDate, getCommentPosition, getCommentSlide, getCommentText, getCommentsSortedByDate, getCoreProperties, getDistinctHyperlinkUrls, getEmptySlides, getExtendedProperties, getGroupChildren, getGroupTransform, getHiddenSlides, getMaxShapeId, getMaxShapeIdInPresentation, getMediaParts, getOrphanMediaPartNames, getOutlineText, getPackageSize, getParagraphAlignment, getParagraphBullet, getParagraphBulletImageBytes, getParagraphBulletStyle, getParagraphIndent, getParagraphLevel, getParagraphLineSpacing, getParagraphPropertiesEffective, getParagraphSpacing, getPresentationChartCountsBySlide, getPresentationChartKindCounts, getPresentationCommentCountsByAuthor, getPresentationCommentCountsBySlide, getPresentationCommenters, getPresentationCreated, getPresentationFonts, getPresentationHyperlinkCountsBySlide, getPresentationImageCountsBySlide, getPresentationModified, getPresentationNotesLength, getPresentationNotesLengthsBySlide, getPresentationNotesText, getPresentationShapeCountsBySlide, getPresentationSummary, getPresentationTableCountsBySlide, getPresentationText, getPresentationTextLength, getPresentationTextLengthsBySlide, getPresentationTheme, getShapeAdjustValues, getShapeAltTitle, getShapeAnimation, getShapeAt, getShapeBodyPrEffective, getShapeBounds, getShapeBoundsResolved, getShapeCenter, getShapeChartCategories, getShapeChartKind, getShapeChartSeriesNames, getShapeChartSeriesValues, getShapeChartSpec, getShapeClickAction, getShapeCustomGeometry, getShapeDescription, getShapeEffect, getShapeEffects, getShapeEffectsEffective, getShapeFill, getShapeFillColor, getShapeFillColorResolved, getShapeFillEffective, getShapeFlip, getShapeGradientFill, getShapeGradientFillEffective, getShapeHyperlink, getShapeHyperlinkTooltip, getShapeId, getShapeImageBiLevelThreshold, getShapeImageBrightness, getShapeImageBytes, getShapeImageContrast, getShapeImageCrop, getShapeImageDuotone, getShapeImageFillBytes, getShapeImageFormat, getShapeImageLinkUrl, getShapeImageOpacity, getShapeImagePartName, getShapeIndex, getShapeKind, getShapeName, getShapeParagraphCount, getShapeParagraphElements, getShapePatternFill, getShapePlaceholderIdx, getShapePlaceholderType, getShapePosition, getShapePreset, getShapeRotation, getShapeRunClickAction, getShapeRunCount, getShapeRunFormat, getShapeRunFormatEffective, getShapeRunHyperlink, getShapeRunHyperlinkTooltip, getShapeRunText, getShapeSize, getShapeSlide, getShapeStroke, getShapeStrokeArrow, getShapeStrokeCap, getShapeStrokeColor, getShapeStrokeColorResolved, getShapeStrokeCompound, getShapeStrokeDash, getShapeStrokeEffective, getShapeStrokeJoin, getShapeStrokeWidth, getShapeText, getShapeTextAnchor, getShapeTextAutoFit, getShapeTextAutoFitParams, getShapeTextBodyRotationDeg, getShapeTextColumns, getShapeTextDirection, getShapeTextMargins, getShapeTextWrap, getShapeXmlString, getShapeZIndex, getShapesBounds, getSlideAt, getSlideBackground, getSlideBackgroundGradientFill, getSlideBackgroundImageBytes, getSlideBackgroundPatternFill, getSlideBody, getSlideCharts, getSlideColorMapOverride, getSlideCommentAuthors, getSlideComments, getSlideCount, getSlideIndex, getSlideInfo, getSlideLayout, getSlideLayoutBackground, getSlideLayoutBackgroundGradientFill, getSlideLayoutBackgroundImageBytes, getSlideLayoutBackgroundPatternFill, getSlideLayoutBackgroundShapes, getSlideLayoutCount, getSlideLayoutName, getSlideLayoutPartName, getSlideLayoutPlaceholders, getSlideLayoutShapes, getSlideLayoutType, getSlideLayoutUsageCounts, getSlideLayoutUsageCountsByType, getSlideLayouts, getSlideMasterBackground, getSlideMasterBackgroundGradientFill, getSlideMasterBackgroundImageBytes, getSlideMasterBackgroundPatternFill, getSlideMasterCount, getSlideMasterPartName, getSlideMasterPartNames, getSlideMasterShapes, getSlideMasterUsageCounts, getSlideMediaPartNames, getSlideNotes, getSlideNotesLength, getSlideOutline, getSlidePartName, getSlideSections, getSlideShapes, getSlideSize, getSlideTables, getSlideText, getSlideTextLength, getSlideTitle, getSlideTransition, getSlideXmlString, getSlides, getSlidesByLayout, getSlidesWithCharts, getSlidesWithComments, getSlidesWithEmptyPlaceholders, getSlidesWithHyperlinks, getSlidesWithImages, getSlidesWithNotes, getSlidesWithOverlap, getSlidesWithTables, getTableCell, getTableCellAlignment, getTableCellAnchor, getTableCellBorders, getTableCellFill, getTableCellMargins, getTableCellParagraphs, getTableCellPosition, getTableCellSpan, getTableCellText, getTableCellTextDirection, getTableCells, getTableColumnWidths, getTableDimensions, getTableRowHeights, getTableSize, getTableStyleFlags, getTableStyleId, getThumbnail, getUnusedSlideLayouts, getUnusedSlideMasters, getVisibleSlides, hasShapeImage, hasShapeText, hasSlideNotes, importSlide, inches, incrementRevision, insertTableColumn, insertTableRow, isChartShape, isParagraphBulletPicture, isShapeHidden, isShapeImageGrayscale, isShapePlaceholder, isShapeTextBox, isSlideHidden, isTableShape, listPackageParts, loadPresentation, mergePresentations, mm, moveSlide, pointInShape, pt, readPackagePart, removeShape, removeSlide, removeSlideComment, removeSlideNotes, removeTableColumn, removeTableRow, removeThumbnail, renameShape, replaceHyperlink, replaceTextInNotes, replaceTextInPresentation, replaceTextInSlide, replaceTextInSlideNotes, replaceTokensInPresentation, replaceTokensInSlide, resolveDrawingColor, reverseSlides, savePresentation, searchSlides, sendShapeBackward, sendShapeToBack, setChartSpec, setCoreProperties, setExtendedProperties, setMediaPartBytes, setParagraphAlignment, setParagraphBullet, setParagraphLevel, setParagraphSpacing, setShapeAlignment, setShapeAltTitle, setShapeAnimation, setShapeBounds, setShapeBullets, setShapeClickAction, setShapeDescription, setShapeFill, setShapeFlip, setShapeGlow, setShapeGradientFill, setShapeHidden, setShapeHyperlink, setShapeImage, setShapeImageBrightness, setShapeImageContrast, setShapeImageCrop, setShapeImageFill, setShapeImageOpacity, setShapeNoFill, setShapeNoStroke, setShapePatternFill, setShapePosition, setShapeRotation, setShapeRunFormat, setShapeRunHyperlink, setShapeRunText, setShapeShadow, setShapeSize, setShapeStroke, setShapeStrokeArrow, setShapeStrokeCap, setShapeStrokeCompound, setShapeStrokeDash, setShapeStrokeJoin, setShapeText, setShapeTextAnchor, setShapeTextAutoFit, setShapeTextBodyRotationDeg, setShapeTextColumns, setShapeTextDirection, setShapeTextFormat, setShapeTextMargins, setShapeTextWrap, setShapeZIndex, setSlideBackground, setSlideBackgroundImage, setSlideBody, setSlideHidden, setSlideLayout, setSlideNotes, setSlidePlaceholders, setSlideSections, setSlideSize, setSlideTitle, setSlideTransition, setTableCellAlignment, setTableCellAnchor, setTableCellBorders, setTableCellFill, setTableCellMargins, setTableCellText, setTableCellTextDirection, setTableCellTextFormat, setTableColumnWidth, setTableRowHeight, setTableStyleFlags, setTableStyleId, setThumbnail, shapesOverlap, slideHasAnimations, slidesUsingMediaPart, sortSlides, swapSlides, touchModified, translateShapes, validatePresentation };
+export { SLIDE_SIZE_16_10, SLIDE_SIZE_16_9, SLIDE_SIZE_4_3, VERSION, _internalPackageOf, addBlankSlide, addContentSlide, addSectionHeaderSlide, addSlide, addSlideAt, addSlideChart, addSlideComment, addSlideImage, addSlideLine, addSlideShape, addSlideTable, addSlideTextBox, addTitleSlide, appendShapeText, appendSlideNotes, bringShapeForward, bringShapeToFront, centerShapeOnSlide, clearAllHyperlinks, clearAllSlideComments, clearAllSlideNotes, clearShapeEffects, clearShapeFill, clearShapeStroke, clearSlideAnimations, clearSlideBackground, clearSlideComments, clearSlideHyperlinks, clearSlideShapes, clearSlideTransition, clearTableCellFill, cm, compactPackage, copyShape, createPresentation, duplicateSlide, duplicateSlideAt, emu, findChartByKind, findChartsBySeriesName, findChartsWithDataLabels, findChartsWithTrendlines, findCommentAuthorByName, findCommentsAfter, findCommentsBefore, findCommentsByAuthor, findCommentsByText, findEmptyPlaceholders, findFlippedShapes, findLayoutsWithPlaceholderType, findOverlappingShapePairs, findShapeById, findShapeByName, findShapeByText, findShapeInPresentation, findShapesAtPoint, findShapesByEffect, findShapesByHyperlink, findShapesByKind, findShapesByName, findShapesByPreset, findShapesByText, findShapesInRect, findShapesOutsideCanvas, findShapesWithAnimation, findShapesWithHyperlinks, findSlideByPartName, findSlideByText, findSlideByTitle, findSlideLayout, findSlideLayoutByPartName, findSlideLayoutByType, findSlidePlaceholder, findSlidePlaceholderByIdx, findSlidePlaceholders, findSlidesByHyperlink, findSlidesByLayoutName, findSlidesByLayoutPartName, findSlidesByLayoutType, findSlidesByNotes, findSlidesByText, findSlidesWithChartKind, findSlidesWithChartTrendlines, findSlidesWithCommentsByAuthor, getAllCharts, getAllComments, getAllHyperlinks, getAllImages, getAllNotes, getAllShapes, getAllTables, getCommentAuthor, getCommentAuthors, getCommentDate, getCommentPosition, getCommentSlide, getCommentText, getCommentsSortedByDate, getCoreProperties, getDistinctHyperlinkUrls, getEmptySlides, getExtendedProperties, getGroupChildren, getGroupTransform, getHiddenSlides, getMaxShapeId, getMaxShapeIdInPresentation, getMediaParts, getOrphanMediaPartNames, getOutlineText, getPackageSize, getParagraphAlignment, getParagraphBullet, getParagraphBulletImageBytes, getParagraphBulletStyle, getParagraphIndent, getParagraphLevel, getParagraphLineSpacing, getParagraphPropertiesEffective, getParagraphSpacing, getPresentationChartCountsBySlide, getPresentationChartKindCounts, getPresentationCommentCountsByAuthor, getPresentationCommentCountsBySlide, getPresentationCommenters, getPresentationCreated, getPresentationFonts, getPresentationHyperlinkCountsBySlide, getPresentationImageCountsBySlide, getPresentationModified, getPresentationNotesLength, getPresentationNotesLengthsBySlide, getPresentationNotesText, getPresentationShapeCountsBySlide, getPresentationSummary, getPresentationTableCountsBySlide, getPresentationText, getPresentationTextLength, getPresentationTextLengthsBySlide, getPresentationTheme, getShapeAdjustValues, getShapeAltTitle, getShapeAnimation, getShapeAt, getShapeBodyPrEffective, getShapeBounds, getShapeBoundsResolved, getShapeCenter, getShapeChartCategories, getShapeChartKind, getShapeChartSeriesNames, getShapeChartSeriesValues, getShapeChartSpec, getShapeClickAction, getShapeCustomGeometry, getShapeDescription, getShapeEffect, getShapeEffects, getShapeEffectsEffective, getShapeFill, getShapeFillColor, getShapeFillColorResolved, getShapeFillEffective, getShapeFlip, getShapeGradientFill, getShapeGradientFillEffective, getShapeHyperlink, getShapeHyperlinkTooltip, getShapeId, getShapeImageBiLevelThreshold, getShapeImageBrightness, getShapeImageBytes, getShapeImageContrast, getShapeImageCrop, getShapeImageDuotone, getShapeImageFillBytes, getShapeImageFormat, getShapeImageLinkUrl, getShapeImageOpacity, getShapeImagePartName, getShapeIndex, getShapeKind, getShapeName, getShapeParagraphCount, getShapeParagraphElements, getShapePatternFill, getShapePlaceholderIdx, getShapePlaceholderType, getShapePosition, getShapePreset, getShapeRotation, getShapeRunClickAction, getShapeRunCount, getShapeRunFormat, getShapeRunFormatEffective, getShapeRunHyperlink, getShapeRunHyperlinkTooltip, getShapeRunText, getShapeSize, getShapeSlide, getShapeStroke, getShapeStrokeArrow, getShapeStrokeCap, getShapeStrokeColor, getShapeStrokeColorResolved, getShapeStrokeCompound, getShapeStrokeDash, getShapeStrokeEffective, getShapeStrokeJoin, getShapeStrokeWidth, getShapeText, getShapeTextAnchor, getShapeTextAutoFit, getShapeTextAutoFitParams, getShapeTextBodyRotationDeg, getShapeTextColumns, getShapeTextDirection, getShapeTextMargins, getShapeTextWrap, getShapeXmlString, getShapeZIndex, getShapesBounds, getSlideAt, getSlideBackground, getSlideBackgroundGradientFill, getSlideBackgroundImageBytes, getSlideBackgroundPatternFill, getSlideBody, getSlideCharts, getSlideColorMapOverride, getSlideCommentAuthors, getSlideComments, getSlideCount, getSlideIndex, getSlideInfo, getSlideLayout, getSlideLayoutBackground, getSlideLayoutBackgroundGradientFill, getSlideLayoutBackgroundImageBytes, getSlideLayoutBackgroundPatternFill, getSlideLayoutBackgroundShapes, getSlideLayoutCount, getSlideLayoutName, getSlideLayoutPartName, getSlideLayoutPlaceholders, getSlideLayoutShapes, getSlideLayoutType, getSlideLayoutUsageCounts, getSlideLayoutUsageCountsByType, getSlideLayouts, getSlideMasterBackground, getSlideMasterBackgroundGradientFill, getSlideMasterBackgroundImageBytes, getSlideMasterBackgroundPatternFill, getSlideMasterCount, getSlideMasterPartName, getSlideMasterPartNames, getSlideMasterShapes, getSlideMasterUsageCounts, getSlideMediaPartNames, getSlideNotes, getSlideNotesLength, getSlideOutline, getSlidePartName, getSlideSections, getSlideShapes, getSlideSize, getSlideTables, getSlideText, getSlideTextLength, getSlideTitle, getSlideTransition, getSlideXmlString, getSlides, getSlidesByLayout, getSlidesWithCharts, getSlidesWithComments, getSlidesWithEmptyPlaceholders, getSlidesWithHyperlinks, getSlidesWithImages, getSlidesWithNotes, getSlidesWithOverlap, getSlidesWithTables, getTableCell, getTableCellAlignment, getTableCellAnchor, getTableCellBorders, getTableCellFill, getTableCellMargins, getTableCellParagraphs, getTableCellPosition, getTableCellSpan, getTableCellText, getTableCellTextDirection, getTableCells, getTableColumnWidths, getTableDimensions, getTableRowHeights, getTableSize, getTableStyleFlags, getTableStyleId, getThumbnail, getUnusedSlideLayouts, getUnusedSlideMasters, getVisibleSlides, hasShapeImage, hasShapeText, hasSlideNotes, importSlide, inches, incrementRevision, insertTableColumn, insertTableRow, isChartShape, isParagraphBulletPicture, isShapeHidden, isShapeImageGrayscale, isShapePlaceholder, isShapeTextBox, isSlideHidden, isTableShape, listPackageParts, loadPresentation, mergePresentations, mergeTableCells, mm, moveSlide, pointInShape, pt, readPackagePart, removeShape, removeSlide, removeSlideComment, removeSlideNotes, removeTableColumn, removeTableRow, removeThumbnail, renameShape, replaceHyperlink, replaceTextInNotes, replaceTextInPresentation, replaceTextInSlide, replaceTextInSlideNotes, replaceTokensInPresentation, replaceTokensInSlide, resolveDrawingColor, reverseSlides, savePresentation, searchSlides, sendShapeBackward, sendShapeToBack, setChartSpec, setCoreProperties, setExtendedProperties, setMediaPartBytes, setParagraphAlignment, setParagraphBullet, setParagraphLevel, setParagraphSpacing, setShapeAlignment, setShapeAltTitle, setShapeAnimation, setShapeBounds, setShapeBullets, setShapeClickAction, setShapeDescription, setShapeFill, setShapeFlip, setShapeGlow, setShapeGradientFill, setShapeHidden, setShapeHyperlink, setShapeImage, setShapeImageBrightness, setShapeImageContrast, setShapeImageCrop, setShapeImageFill, setShapeImageOpacity, setShapeNoFill, setShapeNoStroke, setShapePatternFill, setShapePosition, setShapeRotation, setShapeRunFormat, setShapeRunHyperlink, setShapeRunText, setShapeShadow, setShapeSize, setShapeStroke, setShapeStrokeArrow, setShapeStrokeCap, setShapeStrokeCompound, setShapeStrokeDash, setShapeStrokeJoin, setShapeText, setShapeTextAnchor, setShapeTextAutoFit, setShapeTextBodyRotationDeg, setShapeTextColumns, setShapeTextDirection, setShapeTextFormat, setShapeTextMargins, setShapeTextWrap, setShapeZIndex, setSlideBackground, setSlideBackgroundImage, setSlideBody, setSlideHidden, setSlideLayout, setSlideNotes, setSlidePlaceholders, setSlideSections, setSlideSize, setSlideTitle, setSlideTransition, setTableCellAlignment, setTableCellAnchor, setTableCellBorders, setTableCellFill, setTableCellMargins, setTableCellText, setTableCellTextDirection, setTableCellTextFormat, setTableColumnWidth, setTableRowHeight, setTableStyleFlags, setTableStyleId, setThumbnail, shapesOverlap, slideHasAnimations, slidesUsingMediaPart, sortSlides, swapSlides, touchModified, translateShapes, validatePresentation };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map