pptx-react-viewer 3.16.7 → 3.17.1

package/dist/{chunk-B3YVURJB.mjs → chunk-VYSMTC5C.mjs}

@@ -1,5 +1,5 @@
-import { SHAPE_PRESET_DEFS, VIEWER_SHORTCUT_REFERENCE, STROKE_DASH_OPTIONS, getAnimationInitialStyle, cloneHistorySnapshot, hasShapeProperties, getImageFitStyle, getComputedFillStyle, isImageLikeElement, getCropShapeClipPath, getImageTilingStyle, mediaPlaybackAttributes, buildTextBlockStyle, hasTextProperties, toCssWritingMode, toCssTextOrientation, toCssVerticalDirection, buildTextBodyLayoutStyle, buildTextBody3DSceneStyle, buildParagraphs, colorWithOpacity, normalizeHexColor, hexToRgbUnit, build3DExtrusionData, getComputedEffectStyle, getComputedStrokeStyle, getAnimationColorBaseStyle, isStrokeOnlyPresetElement, resolveShapeGeometry, normalizeStrokeDashType, getSvgStrokeDasharray, buildSvgGradientDef, buildStrokeOutline, getPresetShapeVectorGeometry, isWedgeCalloutPresetShape, svgGradientFillRef, isCalloutShape, getCalloutLeaderLineGeometry, buildCalloutLeaderLineSvgPath, getCalloutViewBoxBounds, svgLineCap, getCompoundLineOffsets, getCompoundLineWidths, canDrillDown, computeSelectionRect, DEFAULT_FONT_FAMILY, cellStyleToCss, rectToCells, isCellInRect, tableContainerCss, buildChartViewModel, resolveChartKind, chartPreserveAspectRatio, buildNotesPdfBytes, buildTiledSlidesPdfBytes, buildPreviewAnimation, buildMotionPathPreview, mediaFallbackVisual, scheduleMediaTrimAndFade, registerCrossSlideAudio, resolveAutoFitFontScale, resolveFontKerning, getSubstituteFontFamily, parsePanoseString, resolveScriptFontSet, hasDistinctScriptFonts, nestedTextDecorationStyle, pieceLetterSpacing, resolveMetricTrackingPx, hollowTextFillStyle, stripUnderlineDecoration, buildTabContext, TEXT_BUILD_ID_SEP, buildTextBuildSpec, textBuildSpanStyle, apply3dEffects, clampUnitInterval, customGeometryPathsToSvgSubpaths, buildSubpathPaints, computeColumnBoundaries, getTableCellBandStyle, parseDrawingColor, parseDrawingColorOpacity, getCellDiagonalBorders, xmlText, cellRunStyle, getChartStylePalette, computeChartLegendLayout, mediaFallbackIcon, mediaFallbackLabelKey, MEDIA_CHROME_ATTRIBUTE, convertOmmlToMathMl, sanitizeMathMl, tableCellCss, computeResizedColumnWidths, computeResizedRowHeight, DEFAULT_ROW_HEIGHT, ooxmlGradientAngleToCssDegrees, buildRectPathGradient, buildRunTabLines, chartPartToAttrs, splitWordsForUnderline, splitRunForMetrics, splitRunByScriptFont } from './chunk-XMD6ZWUO.mjs';
-import { translationsEn } from './chunk-HMX3MQR7.mjs';
+import { SHAPE_PRESET_DEFS, VIEWER_SHORTCUT_REFERENCE, STROKE_DASH_OPTIONS, getAnimationInitialStyle, cloneHistorySnapshot, hasShapeProperties, getImageFitStyle, getComputedFillStyle, isImageLikeElement, getCropShapeClipPath, getImageTilingStyle, mediaPlaybackAttributes, buildTextBlockStyle, hasTextProperties, toCssWritingMode, toCssTextOrientation, toCssVerticalDirection, buildTextBodyLayoutStyle, buildTextBody3DSceneStyle, buildParagraphs, colorWithOpacity, normalizeHexColor, hexToRgbUnit, build3DExtrusionData, getComputedEffectStyle, getComputedStrokeStyle, getAnimationColorBaseStyle, isStrokeOnlyPresetElement, resolveShapeGeometry, normalizeStrokeDashType, getSvgStrokeDasharray, buildSvgGradientDef, buildStrokeOutline, getPresetShapeVectorGeometry, isWedgeCalloutPresetShape, svgGradientFillRef, isCalloutShape, getCalloutLeaderLineGeometry, buildCalloutLeaderLineSvgPath, getCalloutViewBoxBounds, svgLineCap, getCompoundLineOffsets, getCompoundLineWidths, canDrillDown, computeSelectionRect, DEFAULT_FONT_FAMILY, cellStyleToCss, rectToCells, isCellInRect, tableContainerCss, buildChartViewModel, resolveChartKind, chartPreserveAspectRatio, buildNotesPdfBytes, buildTiledSlidesPdfBytes, buildPreviewAnimation, buildMotionPathPreview, mediaFallbackVisual, scheduleMediaTrimAndFade, registerCrossSlideAudio, resolveAutoFitFontScale, resolveFontKerning, getSubstituteFontFamily, parsePanoseString, resolveScriptFontSet, hasDistinctScriptFonts, nestedTextDecorationStyle, pieceLetterSpacing, resolveMetricTrackingPx, hollowTextFillStyle, stripUnderlineDecoration, buildTabContext, TEXT_BUILD_ID_SEP, buildTextBuildSpec, textBuildSpanStyle, apply3dEffects, clampUnitInterval, customGeometryPathsToSvgSubpaths, buildSubpathPaints, computeColumnBoundaries, getTableCellBandStyle, parseDrawingColor, parseDrawingColorOpacity, getCellDiagonalBorders, xmlText, cellRunStyle, getChartStylePalette, computeChartLegendLayout, mediaFallbackIcon, mediaFallbackLabelKey, MEDIA_CHROME_ATTRIBUTE, convertOmmlToMathMl, sanitizeMathMl, tableCellCss, computeResizedColumnWidths, computeResizedRowHeight, DEFAULT_ROW_HEIGHT, ooxmlGradientAngleToCssDegrees, buildRectPathGradient, buildRunTabLines, chartPartToAttrs, splitWordsForUnderline, splitRunForMetrics, splitRunByScriptFont } from './chunk-QTGCOL5H.mjs';
+import { translationsEn } from './chunk-LAU34UMB.mjs';
 import { clsx } from 'clsx';
 import { twMerge } from 'tailwind-merge';
 import React7, { useRef, useState, useEffect, useCallback, useMemo, useLayoutEffect } from 'react';

package/dist/i18n.js

@@ -1,19 +1,19 @@
 'use strict';
 
-var chunk3AJ54EAB_js = require('./chunk-3AJ54EAB.js');
+var chunk64FUV37N_js = require('./chunk-64FUV37N.js');
 require('./chunk-4VNS5WPM.js');
 
 
 
 Object.defineProperty(exports, "LOCALE_CATALOG", {
   enumerable: true,
-  get: function () { return chunk3AJ54EAB_js.LOCALE_CATALOG; }
+  get: function () { return chunk64FUV37N_js.LOCALE_CATALOG; }
 });
 Object.defineProperty(exports, "keyToLabel", {
   enumerable: true,
-  get: function () { return chunk3AJ54EAB_js.keyToLabel; }
+  get: function () { return chunk64FUV37N_js.keyToLabel; }
 });
 Object.defineProperty(exports, "translationsEn", {
   enumerable: true,
-  get: function () { return chunk3AJ54EAB_js.translationsEn; }
+  get: function () { return chunk64FUV37N_js.translationsEn; }
 });

package/dist/i18n.mjs

@@ -1,2 +1,2 @@
-export { LOCALE_CATALOG, keyToLabel, translationsEn } from './chunk-HMX3MQR7.mjs';
+export { LOCALE_CATALOG, keyToLabel, translationsEn } from './chunk-LAU34UMB.mjs';
 import './chunk-XGB3TDIC.mjs';

package/dist/index.d.ts

@@ -2067,6 +2067,12 @@ interface TextSegment {
    * on the first segment of a paragraph.
    */
   endParaRunProperties?: Record<string, unknown>;
+  /**
+   * Resolved body defaults and optional `a:endParaRPr` of a runless paragraph.
+   * Carried on its first segment (or terminator), separately from marker
+   * styling. Absent when the source contains an authored run or field.
+   */
+  paragraphInsertionStyle?: TextStyle;
   /**
    * Per-paragraph properties (alignment, spacing, margins, indent, tab stops,
    * rtl) authored on this paragraph's own `a:pPr` (#69). Only meaningful on
@@ -2188,6 +2194,8 @@ interface PptxElementBase {
   widthEmu?: number;
   /** The exact EMU integer `height` was parsed from (`a:ext/@_cy`). See {@link xEmu}. */
   heightEmu?: number;
+  /** Resolved load-time transform for a shape with no own a:xfrm. Used only to detect edits. */
+  inheritedTransform?: Pick<PptxElementBase, 'x' | 'y' | 'width' | 'height' | 'rotation' | 'skewX' | 'skewY' | 'flipHorizontal' | 'flipVertical'>;
   rotation?: number;
   /** Skew along the X axis in degrees (parsed from `@_skewX` in 1/60000ths of a degree). */
   skewX?: number;
@@ -11639,6 +11647,14 @@ interface PowerPointViewerAPI {
   getElements: (slideIndex?: number) => readonly PptxElement[];
   /** Get a single element by ID from the active slide (or a specified slide). */
   getElementById: (elementId: string, slideIndex?: number) => PptxElement | undefined;
+  /**
+   * Append and select a deep copy on the active ordinary editable slide.
+   * Assigns fresh element IDs without offsetting the supplied geometry.
+   * Returns the new root ID, or undefined when insertion is unavailable.
+   * Uses normal Undo/Redo grouping. Models must be self-contained or refer to
+   * assets in this document; this does not import foreign PPTX relationships.
+   */
+  addElement: (element: PptxElement) => string | undefined;
   /**
    * Update one or more properties of an element by ID on the active slide.
    * Accepts a `Partial<PptxElement>` patch (e.g. `{ x: 100, width: 300 }`).
@@ -12429,6 +12445,20 @@ declare function readStoredViewerPrefs(): StoredViewerPrefs;
 declare function writeStoredViewerPrefs(patch: Partial<StoredViewerPrefs>): void;
 /** Remove all persisted viewer preferences. Silently no-ops when storage is unavailable. */
 declare function clearStoredViewerPrefs(): void;
+//#endregion
+//#region src/render/viewport-fit.d.ts
+/** Unscaled CSS pixels reserved on each side of the ordinary viewer viewport. */
+type ViewportFitPadding = number | {
+  horizontal: number;
+  vertical: number;
+};
+/** Host layout policy, independent of authored slide dimensions and user zoom. */
+interface ViewportFitOptions {
+  /** Per-side padding. Omission keeps the binding's existing decorative allowance. */
+  fitPadding?: ViewportFitPadding;
+  /** Positive fit-factor ceiling; null allows enlargement without a ceiling. */
+  maxFitScale?: number | null;
+}
 
 //#region src/viewer/types-core.d.ts
 /**
@@ -12727,7 +12757,7 @@ interface TableCellEditorState {
 type ToolbarSection = 'file' | 'home' | 'insert' | 'text' | 'arrange' | 'draw' | 'design' | 'transitions' | 'animations' | 'slideShow' | 'record' | 'review' | 'view' | 'help';
 /** The active drawing/inking tool selected in the Draw toolbar tab. */
 type DrawingTool = 'select' | 'pen' | 'highlighter' | 'eraser' | 'freeform';
-interface PowerPointViewerProps {
+interface PowerPointViewerProps extends ViewportFitOptions {
   /** PowerPoint content as Uint8Array */
   content: Uint8Array;
   /** Licensed fonts supplied by the host application. No fonts are bundled. */
@@ -13447,7 +13477,7 @@ type AutosaveStatus = {
 };
 //#endregion
 //#region src/viewer/hooks/useViewerBuildingBlocks.d.ts
-interface UseViewerBuildingBlocksInput {
+interface UseViewerBuildingBlocksInput extends ViewportFitOptions {
   /** PPTX content as ArrayBuffer/Uint8Array, or null/undefined while no file is loaded. */
   content: ArrayBuffer | Uint8Array | null | undefined;
   /** Whether editing actions are enabled. Defaults to false (view-only). */
@@ -13538,4 +13568,4 @@ declare function SlideTemplatePreview({ templateId, scheme }: SlideTemplatePrevi
 declare function renderToCanvas(element: HTMLElement, options?: Partial<Options>): Promise<HTMLCanvasElement>;
 
 export { AVATAR_COLOR_SWATCHES, DEFAULT_VIEWER_PROFILE, LOCALE_CATALOG, PPTX_OPEN_ACCEPT, PRESENTATION_OPEN_EXTENSIONS, PowerPointViewer, SLIDE_TEMPLATES, SlideCanvas, SlideTemplateGalleryDialog, SlideTemplatePreview, THEME_CATALOG, Toolbar, VIEWER_PREFS_STORAGE_KEY, ViewerThemeProvider, buildSlideTemplateContent, buildSlideTemplateSlide, clearAllLocalViewerData, clearStoredViewerPrefs, defaultCssVars, defaultRadius, defaultThemeColors, getAnimationInitialStyle, getLocalStorageUsageSummary, isLegacyBinaryPresentation, isSupportedPresentationFile, presentationBaseName, readStoredViewerPrefs, renderToCanvas, resolveProfileInitial, resolveThemeCatalogEntry, saveViewerProfile, savedPresentationFileName, themeToCssVars, useViewerBuildingBlocks, useViewerTheme, vermilionDarkColors, vermilionDarkTheme, vermilionLightColors, vermilionLightTheme, vermilionRadius, writeStoredViewerPrefs };
-export type { AccountAuthConfig, LocalStorageUsageSummary, LocaleCatalogEntry, PowerPointViewerAPI, PowerPointViewerHandle, PowerPointViewerProps, PptxAiBridge, PptxAiConfig, PptxAiConnection, PptxAiContextStrategy, PptxAiToolName, PptxAiWritePolicy, SavedPresentationFormat, SlideCanvasProps, SlideTemplateGalleryDialogProps, SlideTemplateId, SlideTemplatePreviewProps, SlideTemplateSpec, StoredViewerPrefs, ThemeCatalogEntry, ToolbarActionId, ToolbarButtonId, ToolbarProps, ToolbarTabId, UseViewerBuildingBlocksInput, ViewerBuildingBlocksResult, ViewerMode, ViewerProfile, ViewerTheme, ViewerThemeColors };
+export type { AccountAuthConfig, LocalStorageUsageSummary, LocaleCatalogEntry, PowerPointViewerAPI, PowerPointViewerHandle, PowerPointViewerProps, PptxAiBridge, PptxAiConfig, PptxAiConnection, PptxAiContextStrategy, PptxAiToolName, PptxAiWritePolicy, SavedPresentationFormat, SlideCanvasProps, SlideTemplateGalleryDialogProps, SlideTemplateId, SlideTemplatePreviewProps, SlideTemplateSpec, StoredViewerPrefs, ThemeCatalogEntry, ToolbarActionId, ToolbarButtonId, ToolbarProps, ToolbarTabId, UseViewerBuildingBlocksInput, ViewerBuildingBlocksResult, ViewerMode, ViewerProfile, ViewerTheme, ViewerThemeColors, ViewportFitOptions, ViewportFitPadding };

package/dist/index.js

@@ -1,176 +1,176 @@
 'use strict';
 
-var chunkSQNEE6AM_js = require('./chunk-SQNEE6AM.js');
-require('./chunk-TYVSLRC7.js');
-var chunk4Q6VIX6M_js = require('./chunk-4Q6VIX6M.js');
-var chunk4NSDMKFE_js = require('./chunk-4NSDMKFE.js');
-var chunk3FVOKV4E_js = require('./chunk-3FVOKV4E.js');
-var chunk3AJ54EAB_js = require('./chunk-3AJ54EAB.js');
+var chunkIRG7SIUX_js = require('./chunk-IRG7SIUX.js');
+require('./chunk-KVXB22D3.js');
+var chunkE55VEC37_js = require('./chunk-E55VEC37.js');
+var chunk7FBKS7OS_js = require('./chunk-7FBKS7OS.js');
+var chunk4SPZ5IZN_js = require('./chunk-4SPZ5IZN.js');
+var chunk64FUV37N_js = require('./chunk-64FUV37N.js');
 require('./chunk-4VNS5WPM.js');
 
 
 
 Object.defineProperty(exports, "PowerPointViewer", {
   enumerable: true,
-  get: function () { return chunkSQNEE6AM_js.PowerPointViewer; }
+  get: function () { return chunkIRG7SIUX_js.PowerPointViewer; }
 });
 Object.defineProperty(exports, "SlideCanvas", {
   enumerable: true,
-  get: function () { return chunkSQNEE6AM_js.SlideCanvas; }
+  get: function () { return chunkIRG7SIUX_js.SlideCanvas; }
 });
 Object.defineProperty(exports, "SlideTemplateGalleryDialog", {
   enumerable: true,
-  get: function () { return chunkSQNEE6AM_js.SlideTemplateGalleryDialog; }
+  get: function () { return chunkIRG7SIUX_js.SlideTemplateGalleryDialog; }
 });
 Object.defineProperty(exports, "SlideTemplatePreview", {
   enumerable: true,
-  get: function () { return chunkSQNEE6AM_js.SlideTemplatePreview; }
+  get: function () { return chunkIRG7SIUX_js.SlideTemplatePreview; }
 });
 Object.defineProperty(exports, "Toolbar", {
   enumerable: true,
-  get: function () { return chunkSQNEE6AM_js.Toolbar; }
+  get: function () { return chunkIRG7SIUX_js.Toolbar; }
 });
 Object.defineProperty(exports, "ViewerThemeProvider", {
   enumerable: true,
-  get: function () { return chunkSQNEE6AM_js.ViewerThemeProvider; }
+  get: function () { return chunkIRG7SIUX_js.ViewerThemeProvider; }
 });
 Object.defineProperty(exports, "useViewerTheme", {
   enumerable: true,
-  get: function () { return chunkSQNEE6AM_js.useViewerTheme; }
+  get: function () { return chunkIRG7SIUX_js.useViewerTheme; }
 });
 Object.defineProperty(exports, "renderToCanvas", {
   enumerable: true,
-  get: function () { return chunk4Q6VIX6M_js.renderToCanvas; }
+  get: function () { return chunkE55VEC37_js.renderToCanvas; }
 });
 Object.defineProperty(exports, "useViewerBuildingBlocks", {
   enumerable: true,
-  get: function () { return chunk4Q6VIX6M_js.useViewerBuildingBlocks; }
+  get: function () { return chunkE55VEC37_js.useViewerBuildingBlocks; }
 });
 Object.defineProperty(exports, "getAnimationInitialStyle", {
   enumerable: true,
-  get: function () { return chunk4NSDMKFE_js.getAnimationInitialStyle; }
+  get: function () { return chunk7FBKS7OS_js.getAnimationInitialStyle; }
 });
 Object.defineProperty(exports, "AVATAR_COLOR_SWATCHES", {
   enumerable: true,
-  get: function () { return chunk3FVOKV4E_js.AVATAR_COLOR_SWATCHES; }
+  get: function () { return chunk4SPZ5IZN_js.AVATAR_COLOR_SWATCHES; }
 });
 Object.defineProperty(exports, "DEFAULT_VIEWER_PROFILE", {
   enumerable: true,
-  get: function () { return chunk3FVOKV4E_js.DEFAULT_VIEWER_PROFILE; }
+  get: function () { return chunk4SPZ5IZN_js.DEFAULT_VIEWER_PROFILE; }
 });
 Object.defineProperty(exports, "PPTX_OPEN_ACCEPT", {
   enumerable: true,
-  get: function () { return chunk3FVOKV4E_js.PPTX_OPEN_ACCEPT; }
+  get: function () { return chunk4SPZ5IZN_js.PPTX_OPEN_ACCEPT; }
 });
 Object.defineProperty(exports, "PRESENTATION_OPEN_EXTENSIONS", {
   enumerable: true,
-  get: function () { return chunk3FVOKV4E_js.PRESENTATION_OPEN_EXTENSIONS; }
+  get: function () { return chunk4SPZ5IZN_js.PRESENTATION_OPEN_EXTENSIONS; }
 });
 Object.defineProperty(exports, "SLIDE_TEMPLATES", {
   enumerable: true,
-  get: function () { return chunk3FVOKV4E_js.SLIDE_TEMPLATES; }
+  get: function () { return chunk4SPZ5IZN_js.SLIDE_TEMPLATES; }
 });
 Object.defineProperty(exports, "THEME_CATALOG", {
   enumerable: true,
-  get: function () { return chunk3FVOKV4E_js.THEME_CATALOG; }
+  get: function () { return chunk4SPZ5IZN_js.THEME_CATALOG; }
 });
 Object.defineProperty(exports, "VIEWER_PREFS_STORAGE_KEY", {
   enumerable: true,
-  get: function () { return chunk3FVOKV4E_js.VIEWER_PREFS_STORAGE_KEY; }
+  get: function () { return chunk4SPZ5IZN_js.VIEWER_PREFS_STORAGE_KEY; }
 });
 Object.defineProperty(exports, "buildSlideTemplateContent", {
   enumerable: true,
-  get: function () { return chunk3FVOKV4E_js.buildSlideTemplateContent; }
+  get: function () { return chunk4SPZ5IZN_js.buildSlideTemplateContent; }
 });
 Object.defineProperty(exports, "buildSlideTemplateSlide", {
   enumerable: true,
-  get: function () { return chunk3FVOKV4E_js.buildSlideTemplateSlide; }
+  get: function () { return chunk4SPZ5IZN_js.buildSlideTemplateSlide; }
 });
 Object.defineProperty(exports, "clearAllLocalViewerData", {
   enumerable: true,
-  get: function () { return chunk3FVOKV4E_js.clearAllLocalViewerData; }
+  get: function () { return chunk4SPZ5IZN_js.clearAllLocalViewerData; }
 });
 Object.defineProperty(exports, "clearStoredViewerPrefs", {
   enumerable: true,
-  get: function () { return chunk3FVOKV4E_js.clearStoredViewerPrefs; }
+  get: function () { return chunk4SPZ5IZN_js.clearStoredViewerPrefs; }
 });
 Object.defineProperty(exports, "defaultCssVars", {
   enumerable: true,
-  get: function () { return chunk3FVOKV4E_js.defaultCssVars; }
+  get: function () { return chunk4SPZ5IZN_js.defaultCssVars; }
 });
 Object.defineProperty(exports, "defaultRadius", {
   enumerable: true,
-  get: function () { return chunk3FVOKV4E_js.defaultRadius; }
+  get: function () { return chunk4SPZ5IZN_js.defaultRadius; }
 });
 Object.defineProperty(exports, "defaultThemeColors", {
   enumerable: true,
-  get: function () { return chunk3FVOKV4E_js.defaultThemeColors; }
+  get: function () { return chunk4SPZ5IZN_js.defaultThemeColors; }
 });
 Object.defineProperty(exports, "getLocalStorageUsageSummary", {
   enumerable: true,
-  get: function () { return chunk3FVOKV4E_js.getLocalStorageUsageSummary; }
+  get: function () { return chunk4SPZ5IZN_js.getLocalStorageUsageSummary; }
 });
 Object.defineProperty(exports, "isLegacyBinaryPresentation", {
   enumerable: true,
-  get: function () { return chunk3FVOKV4E_js.isLegacyBinaryPresentation; }
+  get: function () { return chunk4SPZ5IZN_js.isLegacyBinaryPresentation; }
 });
 Object.defineProperty(exports, "isSupportedPresentationFile", {
   enumerable: true,
-  get: function () { return chunk3FVOKV4E_js.isSupportedPresentationFile; }
+  get: function () { return chunk4SPZ5IZN_js.isSupportedPresentationFile; }
 });
 Object.defineProperty(exports, "presentationBaseName", {
   enumerable: true,
-  get: function () { return chunk3FVOKV4E_js.presentationBaseName; }
+  get: function () { return chunk4SPZ5IZN_js.presentationBaseName; }
 });
 Object.defineProperty(exports, "readStoredViewerPrefs", {
   enumerable: true,
-  get: function () { return chunk3FVOKV4E_js.readStoredViewerPrefs; }
+  get: function () { return chunk4SPZ5IZN_js.readStoredViewerPrefs; }
 });
 Object.defineProperty(exports, "resolveProfileInitial", {
   enumerable: true,
-  get: function () { return chunk3FVOKV4E_js.resolveProfileInitial; }
+  get: function () { return chunk4SPZ5IZN_js.resolveProfileInitial; }
 });
 Object.defineProperty(exports, "resolveThemeCatalogEntry", {
   enumerable: true,
-  get: function () { return chunk3FVOKV4E_js.resolveThemeCatalogEntry; }
+  get: function () { return chunk4SPZ5IZN_js.resolveThemeCatalogEntry; }
 });
 Object.defineProperty(exports, "saveViewerProfile", {
   enumerable: true,
-  get: function () { return chunk3FVOKV4E_js.saveViewerProfile; }
+  get: function () { return chunk4SPZ5IZN_js.saveViewerProfile; }
 });
 Object.defineProperty(exports, "savedPresentationFileName", {
   enumerable: true,
-  get: function () { return chunk3FVOKV4E_js.savedPresentationFileName; }
+  get: function () { return chunk4SPZ5IZN_js.savedPresentationFileName; }
 });
 Object.defineProperty(exports, "themeToCssVars", {
   enumerable: true,
-  get: function () { return chunk3FVOKV4E_js.themeToCssVars; }
+  get: function () { return chunk4SPZ5IZN_js.themeToCssVars; }
 });
 Object.defineProperty(exports, "vermilionDarkColors", {
   enumerable: true,
-  get: function () { return chunk3FVOKV4E_js.vermilionDarkColors; }
+  get: function () { return chunk4SPZ5IZN_js.vermilionDarkColors; }
 });
 Object.defineProperty(exports, "vermilionDarkTheme", {
   enumerable: true,
-  get: function () { return chunk3FVOKV4E_js.vermilionDarkTheme; }
+  get: function () { return chunk4SPZ5IZN_js.vermilionDarkTheme; }
 });
 Object.defineProperty(exports, "vermilionLightColors", {
   enumerable: true,
-  get: function () { return chunk3FVOKV4E_js.vermilionLightColors; }
+  get: function () { return chunk4SPZ5IZN_js.vermilionLightColors; }
 });
 Object.defineProperty(exports, "vermilionLightTheme", {
   enumerable: true,
-  get: function () { return chunk3FVOKV4E_js.vermilionLightTheme; }
+  get: function () { return chunk4SPZ5IZN_js.vermilionLightTheme; }
 });
 Object.defineProperty(exports, "vermilionRadius", {
   enumerable: true,
-  get: function () { return chunk3FVOKV4E_js.vermilionRadius; }
+  get: function () { return chunk4SPZ5IZN_js.vermilionRadius; }
 });
 Object.defineProperty(exports, "writeStoredViewerPrefs", {
   enumerable: true,
-  get: function () { return chunk3FVOKV4E_js.writeStoredViewerPrefs; }
+  get: function () { return chunk4SPZ5IZN_js.writeStoredViewerPrefs; }
 });
 Object.defineProperty(exports, "LOCALE_CATALOG", {
   enumerable: true,
-  get: function () { return chunk3AJ54EAB_js.LOCALE_CATALOG; }
+  get: function () { return chunk64FUV37N_js.LOCALE_CATALOG; }
 });

package/dist/index.mjs

@@ -1,7 +1,7 @@
-export { PowerPointViewer, SlideCanvas, SlideTemplateGalleryDialog, SlideTemplatePreview, Toolbar, ViewerThemeProvider, useViewerTheme } from './chunk-I5YSAIL5.mjs';
-import './chunk-7ELFYC6K.mjs';
-export { renderToCanvas, useViewerBuildingBlocks } from './chunk-3PUFHKXW.mjs';
-export { getAnimationInitialStyle } from './chunk-B3YVURJB.mjs';
-export { AVATAR_COLOR_SWATCHES, DEFAULT_VIEWER_PROFILE, PPTX_OPEN_ACCEPT, PRESENTATION_OPEN_EXTENSIONS, SLIDE_TEMPLATES, THEME_CATALOG, VIEWER_PREFS_STORAGE_KEY, buildSlideTemplateContent, buildSlideTemplateSlide, clearAllLocalViewerData, clearStoredViewerPrefs, defaultCssVars, defaultRadius, defaultThemeColors, getLocalStorageUsageSummary, isLegacyBinaryPresentation, isSupportedPresentationFile, presentationBaseName, readStoredViewerPrefs, resolveProfileInitial, resolveThemeCatalogEntry, saveViewerProfile, savedPresentationFileName, themeToCssVars, vermilionDarkColors, vermilionDarkTheme, vermilionLightColors, vermilionLightTheme, vermilionRadius, writeStoredViewerPrefs } from './chunk-XMD6ZWUO.mjs';
-export { LOCALE_CATALOG } from './chunk-HMX3MQR7.mjs';
+export { PowerPointViewer, SlideCanvas, SlideTemplateGalleryDialog, SlideTemplatePreview, Toolbar, ViewerThemeProvider, useViewerTheme } from './chunk-IXKAIIA2.mjs';
+import './chunk-7YJBRPCT.mjs';
+export { renderToCanvas, useViewerBuildingBlocks } from './chunk-OAKDJYYT.mjs';
+export { getAnimationInitialStyle } from './chunk-VYSMTC5C.mjs';
+export { AVATAR_COLOR_SWATCHES, DEFAULT_VIEWER_PROFILE, PPTX_OPEN_ACCEPT, PRESENTATION_OPEN_EXTENSIONS, SLIDE_TEMPLATES, THEME_CATALOG, VIEWER_PREFS_STORAGE_KEY, buildSlideTemplateContent, buildSlideTemplateSlide, clearAllLocalViewerData, clearStoredViewerPrefs, defaultCssVars, defaultRadius, defaultThemeColors, getLocalStorageUsageSummary, isLegacyBinaryPresentation, isSupportedPresentationFile, presentationBaseName, readStoredViewerPrefs, resolveProfileInitial, resolveThemeCatalogEntry, saveViewerProfile, savedPresentationFileName, themeToCssVars, vermilionDarkColors, vermilionDarkTheme, vermilionLightColors, vermilionLightTheme, vermilionRadius, writeStoredViewerPrefs } from './chunk-QTGCOL5H.mjs';
+export { LOCALE_CATALOG } from './chunk-LAU34UMB.mjs';
 import './chunk-XGB3TDIC.mjs';

package/dist/internals.d.ts

@@ -2047,6 +2047,12 @@ interface TextSegment {
    * on the first segment of a paragraph.
    */
   endParaRunProperties?: Record<string, unknown>;
+  /**
+   * Resolved body defaults and optional `a:endParaRPr` of a runless paragraph.
+   * Carried on its first segment (or terminator), separately from marker
+   * styling. Absent when the source contains an authored run or field.
+   */
+  paragraphInsertionStyle?: TextStyle;
   /**
    * Per-paragraph properties (alignment, spacing, margins, indent, tab stops,
    * rtl) authored on this paragraph's own `a:pPr` (#69). Only meaningful on
@@ -2168,6 +2174,8 @@ interface PptxElementBase {
   widthEmu?: number;
   /** The exact EMU integer `height` was parsed from (`a:ext/@_cy`). See {@link xEmu}. */
   heightEmu?: number;
+  /** Resolved load-time transform for a shape with no own a:xfrm. Used only to detect edits. */
+  inheritedTransform?: Pick<PptxElementBase, 'x' | 'y' | 'width' | 'height' | 'rotation' | 'skewX' | 'skewY' | 'flipHorizontal' | 'flipVertical'>;
   rotation?: number;
   /** Skew along the X axis in degrees (parsed from `@_skewX` in 1/60000ths of a degree). */
   skewX?: number;
@@ -11483,6 +11491,14 @@ interface PowerPointViewerAPI {
   getElements: (slideIndex?: number) => readonly PptxElement[];
   /** Get a single element by ID from the active slide (or a specified slide). */
   getElementById: (elementId: string, slideIndex?: number) => PptxElement | undefined;
+  /**
+   * Append and select a deep copy on the active ordinary editable slide.
+   * Assigns fresh element IDs without offsetting the supplied geometry.
+   * Returns the new root ID, or undefined when insertion is unavailable.
+   * Uses normal Undo/Redo grouping. Models must be self-contained or refer to
+   * assets in this document; this does not import foreign PPTX relationships.
+   */
+  addElement: (element: PptxElement) => string | undefined;
   /**
    * Update one or more properties of an element by ID on the active slide.
    * Accepts a `Partial<PptxElement>` patch (e.g. `{ x: 100, width: 300 }`).
@@ -12715,6 +12731,20 @@ interface RunProgramNotice {
   /** i18n key for the Copy button label. */
   readonly copyLabelKey: string;
 }
+//#endregion
+//#region src/render/viewport-fit.d.ts
+/** Unscaled CSS pixels reserved on each side of the ordinary viewer viewport. */
+type ViewportFitPadding = number | {
+  horizontal: number;
+  vertical: number;
+};
+/** Host layout policy, independent of authored slide dimensions and user zoom. */
+interface ViewportFitOptions {
+  /** Per-side padding. Omission keeps the binding's existing decorative allowance. */
+  fitPadding?: ViewportFitPadding;
+  /** Positive fit-factor ceiling; null allows enlargement without a ceiling. */
+  maxFitScale?: number | null;
+}
 
 //#region src/viewer/types-core.d.ts
 /**
@@ -13402,7 +13432,7 @@ interface UseAutosaveResult {
 declare function useAutosave(input: UseAutosaveInput): UseAutosaveResult;
 //#endregion
 //#region src/viewer/hooks/useViewerBuildingBlocks.d.ts
-interface UseViewerBuildingBlocksInput {
+interface UseViewerBuildingBlocksInput extends ViewportFitOptions {
   /** PPTX content as ArrayBuffer/Uint8Array, or null/undefined while no file is loaded. */
   content: ArrayBuffer | Uint8Array | null | undefined;
   /** Whether editing actions are enabled. Defaults to false (view-only). */
@@ -13895,7 +13925,7 @@ interface SelectionBounds {
   maxX: number;
   maxY: number;
 }
-interface UseZoomViewportInput {
+interface UseZoomViewportInput extends ViewportFitOptions {
   canvasSize: CanvasSize;
   selectedElements: PptxElement[];
 }
@@ -13922,7 +13952,7 @@ interface UseZoomViewportResult {
     y: number;
   } | null;
 }
-declare function useZoomViewport({ canvasSize, selectedElements }: UseZoomViewportInput): UseZoomViewportResult;
+declare function useZoomViewport({ canvasSize, selectedElements, fitPadding, maxFitScale }: UseZoomViewportInput): UseZoomViewportResult;
 //#endregion
 //#region src/viewer/hooks/presentation-mode/useCustomShowRunner.d.ts
 /**
@@ -15089,6 +15119,7 @@ interface UseInsertElementsInput {
   history: EditorHistoryResult;
 }
 interface InsertElementHandlers {
+  addElement: (element: PptxElement) => void;
   handleAddTextBox: () => void;
   handleAddShape: () => void;
   handleAddTable: () => void;
@@ -16097,6 +16128,8 @@ interface UseViewerIntegrationInput {
   /** Forwarded to `useContentLifecycle` -> `useLoadContent`: see `useCompatibilityToastsState`. */
   setCompatToasts: Dispatch<SetStateAction<CompatibilityWarningToast[]>>;
   canEdit: boolean;
+  /** Additional insertion gate for a headless host's loaded read-only recommendation. */
+  canInsertElement?: boolean;
   /**
    * Options > Advanced > "Prompt to keep ink annotations when exiting"
    * (default true). When false, exiting a slide show with annotations
@@ -16513,6 +16546,8 @@ interface UseKeyboardShortcutsInput {
   containerRef: React.RefObject<HTMLDivElement | null>;
   mode: ViewerMode;
   canEdit: boolean;
+  /** Omitted preserves custom callers; false leaves native paste unclaimed. */
+  canPaste?: boolean;
   /** Whether any element is currently being inline-edited (text box). */
   inlineEditingElementId: string | null;
   /** Whether a table cell is being edited. */