pptx-react-viewer 4.6.0 → 4.8.0

package/dist/viewer/index.d.ts

@@ -1297,6 +1297,27 @@ interface ShapeStyle {
    * `authored-shape-style.ts`'s `effectIsPurelyStyleMatrix`.
    */
   inheritedEffectStyle?: ShapeStyle;
+  /**
+   * Set by a style-matrix pick (the Shape Styles gallery): the shape's own
+   * `spPr` fill, outline and effects were replaced by `<p:style>`, so the
+   * writer clears whatever the retained `spPr` still authored before it
+   * writes the (now reference-owned) style. Never parsed; editor state only.
+   */
+  styleMatrixReset?: boolean;
+}
+/**
+ * The result of resolving a `<p:style>` block against the loaded theme.
+ *
+ * `shapeStyle` is exactly what the load pipeline would have produced for a
+ * shape whose `spPr` authors nothing and whose `<p:style>` is `styleXml`:
+ * the flat fill/outline/effect values a renderer needs, the reference indices
+ * and colours the writer re-emits, and the inheritance baselines that tell the
+ * writer to leave `spPr` empty while the flat values still agree with them.
+ */
+interface ResolvedStyleMatrix {
+  shapeStyle: ShapeStyle;
+  /** The text colour `<a:fontRef>` names, resolved to hex. */
+  fontColor?: string;
 }
 //#endregion
 //#region src/core/types/text.d.ts
@@ -1485,8 +1506,16 @@ interface TextStyle {
   textOutlineWidth?: number;
   /** Text outline colour as hex string (`a:rPr > a:ln > a:solidFill`). */
   textOutlineColor?: string;
+  /** Text outline dash preset (`a:rPr > a:ln > a:prstDash/@val`), e.g. `dash`; absent for solid. */
+  textOutlineDash?: string;
   /** When true, the text body has no fill (`a:rPr > a:noFill`), producing hollow/outline-only text. */
   textFillNone?: boolean;
+  /**
+   * When true, the run authored an EMPTY `<a:effectLst/>`: an explicit "no
+   * effects" override that blocks an inherited shadow or glow. Kept so a
+   * rewrite re-emits it instead of letting the inherited effect return.
+   */
+  textEffectsExplicitNone?: boolean;
   /** Superscript/subscript baseline shift as percentage (`a:rPr/@baseline`). Positive = super, negative = sub. */
   baseline?: number;
   /** Character spacing in hundredths of a point (`a:rPr/@spc`). */
@@ -1520,6 +1549,25 @@ interface TextStyle {
   textFillPatternForeground?: string;
   /** Text-level pattern background colour. */
   textFillPatternBackground?: string;
+  /**
+   * Raw `a:rPr > a:blipFill` XML, preserved verbatim for round-trip
+   * serialization AND as the input to the image resolution pass that fills
+   * in {@link textFillBlipUrl} (parsing a run's fill happens synchronously,
+   * with no zip/relationship access at that point; resolving the blip to a
+   * displayable URL needs both, so it happens in a later async pass over
+   * the slide's parsed elements, mirroring how a shape's OWN image fill is
+   * resolved). A picture-filled text run (`a:rPr > a:blipFill`) was
+   * documented as handled ("Handles gradient fills, pattern fills, and
+   * image fills on text runs") but never actually parsed, so it silently
+   * fell through to the run's plain `color` and rendered solid black
+   * (COM-verified: `audit-text` slide 13's "PICTURE FILL" run shows the
+   * fill image through the glyphs in PowerPoint).
+   */
+  textFillBlipXml?: XmlObject;
+  /** Resolved displayable URL for {@link textFillBlipXml}, or the archive-relative path when unresolved (lazy decode). */
+  textFillBlipUrl?: string;
+  /** Tiling mode for {@link textFillBlipUrl} (`a:blipFill/a:tile` present -> 'tile', else 'stretch'). */
+  textFillBlipMode?: 'stretch' | 'tile';
   hyperlink?: string;
   /** Relationship ID for the hyperlink (`a:hlinkClick/@r:id`) — preserved for round-trip serialization. */
   hyperlinkRId?: string;
@@ -1605,6 +1653,13 @@ interface TextStyle {
     position: number;
     align: 'l' | 'ctr' | 'r' | 'dec';
     leader?: 'none' | 'dot' | 'hyphen' | 'underscore';
+    /**
+     * True when the source spelled out the schema-default `@algn="l"`, so the
+     * writer re-emits it instead of treating it as an omitted default.
+     */
+    alignAuthored?: boolean;
+    /** True when the source spelled out the schema-default `@leader="none"`. */
+    leaderAuthored?: boolean;
   }>;
   /**
    * True when the paragraph's own `a:pPr` authored an EMPTY `<a:tabLst/>`
@@ -1968,6 +2023,19 @@ interface TextStyle {
    * convention used for {@link bulletInfo} / {@link endParaRunProperties}).
    */
   paragraphDefaultRunPropertiesXml?: XmlObject;
+  /**
+   * The bullet colour / size / typeface children (`a:buClrTx`, `a:buClr`,
+   * `a:buSzTx`, `a:buSzPct`, `a:buSzPts`, `a:buFontTx`, `a:buFont`) a
+   * paragraph authored in its own `<a:pPr>` WITHOUT a bullet type
+   * (`a:buNone` / `a:buChar` / `a:buAutoNum` / `a:buBlip`), captured
+   * verbatim in source order. Such a paragraph restyles an inherited bullet
+   * rather than declaring one, so its {@link BulletInfo} resolves from the
+   * cascade and is (correctly) not written back; without this capture the
+   * paragraph's own override vanished on every rewrite.
+   *
+   * Only meaningful on a paragraph's own authored properties.
+   */
+  paragraphBulletPropertiesXml?: XmlObject;
 }
 /**
  * Structured bullet metadata attached to the first {@link TextSegment}
@@ -2224,6 +2292,22 @@ interface TextSegment {
    * Used by the renderer to apply font family, colour, etc. to the `<rt>` element.
    */
   rubyStyle?: TextStyle;
+  /**
+   * The parsed `a:rubyPr` node, kept verbatim so its attributes (`hps`,
+   * `hpsRaise`, `hpsBaseText`, `lid`, ...) round-trip exactly; only an
+   * edited {@link rubyAlignment} is written over it on save.
+   */
+  rubyPropertiesXml?: XmlObject;
+  /**
+   * What each of a ruby run's two base-side `a:rPr`s authored on its own:
+   * `outer` is the containing `a:r`'s, `base` the `a:rubyBase` run's. The
+   * flat {@link style} merges both for rendering; these let the writer give
+   * each `a:rPr` back only its own properties (plus any later edit).
+   */
+  rubyRunAuthoredStyles?: {
+    outer?: TextStyle;
+    base?: TextStyle;
+  };
 }
 //#endregion
 //#region src/core/types/element-base.d.ts
@@ -3236,6 +3320,26 @@ type PptxChartMarkerSymbol = 'circle' | 'dash' | 'diamond' | 'dot' | 'none' | 'p
  */
 type PptxChartScatterStyle = 'none' | 'line' | 'lineMarker' | 'marker' | 'smooth' | 'smoothMarker';
 /** Shape properties extracted from c:spPr for chart formatting. */
+/**
+ * A render-ready gradient fill from a chart `c:spPr/a:gradFill` (chart area,
+ * plot area or series). Positions are 0..100; a linear gradient's `angle` is
+ * in degrees clockwise from left-to-right (`a:lin/@ang`); a radial (`a:path`)
+ * gradient centres on `focalPoint` (0..1 fractions of the box), the middle
+ * when absent.
+ */
+interface PptxChartGradientFill {
+  type: 'linear' | 'radial';
+  stops: Array<{
+    color: string;
+    position: number;
+    opacity?: number;
+  }>;
+  angle?: number;
+  focalPoint?: {
+    x: number;
+    y: number;
+  };
+}
 interface PptxChartShapeProps {
   fillColor?: string;
   strokeColor?: string;
@@ -3561,6 +3665,12 @@ interface PptxChartSeries {
    */
   idx?: number;
   values: number[];
+  /**
+   * Series gradient fill (`c:ser/c:spPr/a:gradFill`), painted on every mark
+   * of the series that has no per-point override. Render-only: the series'
+   * own `c:spPr` round-trips untouched.
+   */
+  gradientFill?: PptxChartGradientFill;
   /**
    * Per-series x values from `c:ser/c:xVal` (scatter and bubble series only).
    *
@@ -3735,6 +3845,12 @@ interface PptxChartFilteredSeries {
  * and `c:dLblPos`.
  */
 interface PptxChartDataLabelOptions {
+  /** Label box fill/outline (`c:dLbls/c:spPr`), see `chart-data-label-box.ts`. */
+  labelShape?: PptxChartShapeProps;
+  /** Callout geometry of the label box (`c15:spPr/a:prstGeom/@prst`, e.g. `wedgeRectCallout`). */
+  calloutShape?: string;
+  /** The chart15 extension's `c15:showLeaderLines`, which wins for a moved label's leader line. */
+  extLeaderLines?: boolean;
   /** Show the numeric value (`c:showVal`). */
   showValue?: boolean;
   /** Show the category name (`c:showCatName`). */
@@ -3860,6 +3976,10 @@ interface PptxChartStyle {
   chartAreaFill?: string;
   /** Plot-area fill from `c:plotArea/c:spPr`. See {@link chartAreaFill}. */
   plotAreaFill?: string;
+  /** Chart-area gradient (`c:chartSpace/c:spPr/a:gradFill`); wins over {@link chartAreaFill}. */
+  chartAreaGradient?: PptxChartGradientFill;
+  /** Plot-area gradient (`c:plotArea/c:spPr/a:gradFill`); wins over {@link plotAreaFill}. */
+  plotAreaGradient?: PptxChartGradientFill;
   /** Whether data labels are shown. */
   hasDataLabels?: boolean;
   /** Chart-level data-label content/position options (when `hasDataLabels`). */
@@ -4099,6 +4219,14 @@ interface PptxChartData {
   style?: PptxChartStyle;
   /** Grouping mode for bar/area/line charts: 'clustered' | 'stacked' | 'percentStacked' */
   grouping?: 'clustered' | 'stacked' | 'percentStacked';
+  /**
+   * The source `c:grouping` was `standard`, which {@link grouping} folds into
+   * `'clustered'` (a 2D bar chart draws the two the same). A 3D chart draws
+   * `standard` differently: each series on its own depth row. The writer
+   * emits `standard` again while `grouping` is still `'clustered'`, so the
+   * chart round-trips unchanged.
+   */
+  groupingStandard?: boolean;
   /**
    * Whether the first (or only) series varies its point colours
    * (`c:varyColors/@val`). Pie/doughnut default this on; single-series
@@ -5496,6 +5624,14 @@ interface PptxSmartArtNode {
    * quick-style variation) applied to every other node.
    */
   coherent3DOff?: boolean;
+  /**
+   * The layout variables PowerPoint recorded for each presentation node
+   * this point drives (`dgm:prSet/@presName` -> `dgm:presLayoutVars`
+   * variable -> `@val`), e.g. `{ hierRoot1: { hierBranch: 'l' } }` for an
+   * org-chart manager set to "Left Hanging". Read-only: the presentation
+   * points themselves round-trip verbatim.
+   */
+  presLayoutVarsByName?: Record<string, Record<string, string>>;
   /**
    * Per-run text + run-properties for the node's first paragraph, captured at
    * parse time. When the joined run text still equals {@link text} (the node
@@ -5565,6 +5701,16 @@ interface PptxSmartArtQuickStyleLabel {
   name: string;
   /** Theme-resolved `dgm:style` refs for this label's role, when available. */
   resolvedStyle?: PptxSmartArtResolvedStyleRef;
+  /**
+   * The label's own `dgm:scene3d` (per-shape camera + light rig). PowerPoint
+   * copies it onto a shape's cached `a:scene3d` unless it is the default
+   * front camera with a `threePt` light (see `applySmartArtQuickStyle3d`).
+   */
+  scene3d?: Pptx3DScene;
+  /** The label's own `dgm:sp3d` (bevel / extrusion / contour / material); absent when empty. */
+  shape3d?: Pptx3DShape;
+  /** The label's `dgm:txPr/a:sp3d` label-text extrusion (Bird's Eye Scene). */
+  text3d?: Text3DStyle;
 }
 /** CT_CTStyleLabel metadata from a color-transform definition. */
 interface PptxSmartArtColorStyleLabel {
@@ -5632,9 +5778,10 @@ interface PptxSmartArtQuickStyle extends PptxSmartArtDefinitionMetadata {
    * for the "Scene" quick styles (Brick, Flat, Metallic, Sunset, Bird's Eye
    * Scene). One camera renders the whole diagram; per-shape `a:scene3d` is
    * absent for those styles (see `PptxSmartArtDrawingShape.scene3d`). Each
-   * `dgm:styleLbl` also carries its own per-label `dgm:scene3d`/`dgm:sp3d`,
-   * but PowerPoint bakes those fully resolved onto each cached shape's own
-   * `dsp:spPr/a:sp3d`, so only the diagram-level scene is exposed here.
+   * `dgm:styleLbl` also carries its own per-label `dgm:scene3d`/`dgm:sp3d`
+   * ({@link PptxSmartArtQuickStyleLabel.scene3d} / `shape3d` / `text3d`),
+   * which PowerPoint bakes onto each cached shape; they are re-applied when a
+   * structural edit regenerates the shapes.
    */
   scene3d?: Pptx3DScene;
 }
@@ -5765,6 +5912,11 @@ interface PptxSmartArtDrawingShape extends PptxCustomPathProperties {
   fillNone?: boolean;
   /** Solid fill colour (hex). */
   fillColor?: string;
+  /**
+   * Opacity (0..1) of the solid fill, from the colour's `a:alpha` (Basic Venn
+   * paints its circles at 50% so overlaps blend). Absent when opaque.
+   */
+  fillOpacity?: number;
   /**
    * Gradient fill stops when the cached shape uses `a:gradFill`. Positions are
    * 0..100 (percent). Renderers emit an SVG/CSS gradient instead of a flat box.
@@ -7728,7 +7880,15 @@ type PptxAnimationTimingCurve = 'ease' | 'ease-in' | 'ease-out' | 'linear';
 /** Repeat mode for animations. */
 type PptxAnimationRepeatMode = 'untilNextClick' | 'untilEndOfSlide';
 /** Animation trigger type from OOXML `p:cTn`. */
-type PptxAnimationTrigger = 'onClick' | 'onShapeClick' | 'onHover' | 'afterPrevious' | 'withPrevious' | 'afterDelay';
+type PptxAnimationTrigger = 'onClick' | 'onShapeClick' | 'onHover' | 'afterPrevious' | 'withPrevious' | 'afterDelay' |
+/**
+ * Starts when a media element's playback reaches a named bookmark
+ * (PowerPoint's "Trigger > On Bookmark"). The media element is
+ * {@link PptxElementAnimation.triggerShapeId} and the bookmark
+ * {@link PptxElementAnimation.triggerBookmark}; saved as an interactive
+ * sequence gated on `p:cond evt="onMediaBookmark"` with a `p14:bmkTgt`.
+ */
+'onMediaBookmark';
 /**
  * Native animation kind. The historic shape-targeted preset animations are
  * implicitly the default kind (`undefined`). Media animations (`p:audio`,
@@ -7881,8 +8041,13 @@ interface PptxNativeAnimation {
   target?: PptxAnimationTarget;
   /** Trigger type. */
   trigger?: PptxAnimationTrigger;
-  /** Shape ID that triggers this animation when clicked (interactive sequence). */
+  /**
+   * Shape ID that triggers this animation: the clicked shape of an
+   * interactive sequence, or the media element of an `onMediaBookmark` one.
+   */
   triggerShapeId?: string;
+  /** Bookmark name an `onMediaBookmark` interactive sequence waits for. */
+  triggerBookmark?: string;
   /** Whether this effect belongs to an OOXML `interactiveSeq`. */
   interactiveSequence?: boolean;
   /** Whether `p:endSync/p:rtn[@val="all"]` makes that sequence replayable. */
@@ -8381,12 +8546,15 @@ interface PptxAttributeAnimation {
   /**
    * `p:anim/@_p14:bounceEnd` (Office 2010 `p14` extension attribute,
    * MS-OI29500), normalized to a 0-1 fraction of this behaviour's own
-   * duration. PowerPoint's Fly In "Bounce End" effect option writes this on
-   * the position-ramp `p:anim` node(s): the fraction of the duration at
-   * which the primary travel completes, with the remainder spent bouncing
-   * and settling at the final value. Mirrored verbatim by PowerPoint onto
-   * the enclosing `p:cTn/@_p14:presetBounceEnd`. Absent for every animation
-   * that doesn't use this effect option (the overwhelming majority).
+   * duration. PowerPoint's "Bounce End" effect option (COM:
+   * `Effect.Timing.BounceEnd` + `BounceEndIntensity`) writes this on the
+   * position-ramp `p:anim` node(s): the share of the duration spent
+   * BOUNCING at the end. Measured from PowerPoint's own CreateVideo frames,
+   * the travel completes at `1 - bounceEnd` and the rest is a damped
+   * oscillation about the final value (see shared's `animation-bounce-end`).
+   * Mirrored verbatim by PowerPoint onto the enclosing
+   * `p:cTn/@_p14:presetBounceEnd`. Absent for every animation that doesn't
+   * use this effect option (the overwhelming majority).
    */
   bounceEnd?: number;
 }
@@ -8564,9 +8732,24 @@ interface PptxElementAnimation {
   durationMs?: number;
   delayMs?: number;
   order?: number;
+  /**
+   * The {@link order} the loader derived from the slide's `p:timing` tree for
+   * an entry whose `pptx:editorMeta` record authored no `@order`. The tree
+   * already expresses that position (and every load re-derives it), so the
+   * writer omits `@order` while `order` still equals this value; a reorder
+   * changes `order` and the attribute is written again. Load-time bookkeeping
+   * only; never set it by hand.
+   */
+  orderFromTimeline?: number;
   trigger?: PptxAnimationTrigger;
-  /** Shape ID that triggers this animation when clicked (interactive sequence). */
+  /**
+   * Shape ID that triggers this animation: the shape clicked for
+   * `onShapeClick`, or the media element whose bookmark fires it for
+   * `onMediaBookmark`.
+   */
   triggerShapeId?: string;
+  /** Bookmark name (`p14:bmk/@name`) an `onMediaBookmark` trigger waits for. */
+  triggerBookmark?: string;
   timingCurve?: PptxAnimationTimingCurve;
   repeatCount?: number;
   repeatMode?: PptxAnimationRepeatMode;
@@ -11142,6 +11325,8 @@ interface IPptxHandlerRuntime {
   updateThemeColorScheme(colorScheme: PptxThemeColorScheme): Promise<void>;
   updateThemeFontScheme(fontScheme: PptxThemeFontScheme): Promise<void>;
   updateThemeName(name: string): Promise<void>;
+  /** Resolve a `<p:style>` node against the loaded theme (see PptxHandlerRuntimeStyleMatrixResolve). */
+  resolveStyleMatrixReferences(styleXml: XmlObject): ResolvedStyleMatrix;
   applyTheme(colorScheme: PptxThemeColorScheme, fontScheme: PptxThemeFontScheme, themeName?: string): Promise<void>;
   load(data: ArrayBuffer, options?: PptxHandlerLoadOptions): Promise<PptxData>;
   getChartDataForGraphicFrame(slidePath: string, graphicFrame: XmlObject | undefined): Promise<PptxChartData | undefined>;
@@ -11437,6 +11622,14 @@ declare class PptxHandlerCore {
    * @param name - New display name for the theme.
    */
   updateThemeName(name: string): Promise<void>;
+  /**
+   * Resolve a `<p:style>` block (`a:lnRef` / `a:fillRef` / `a:effectRef` /
+   * `a:fontRef`) against the loaded theme, exactly as the load path would for
+   * a shape whose `spPr` authors nothing. Apply the returned `shapeStyle` to a
+   * shape and it renders like PowerPoint's Shape Styles entry and saves as a
+   * bare `<p:style>` with an empty `spPr`, which is what PowerPoint writes.
+   */
+  resolveStyleMatrixReferences(styleXml: XmlObject): ResolvedStyleMatrix;
   /**
    * Apply a complete theme in one call (colour scheme + font scheme + optional name).
    *
@@ -12315,8 +12508,12 @@ declare function loadAudienceContent(sessionId?: string): Promise<Uint8Array | n
 declare function clearAudienceContent(sessionId?: string): Promise<void>;
 /** A logical editor command produced by one key press. */
 type EditorKeyActionName = 'undo' | 'redo' | 'copy' | 'cut' | 'paste' | 'duplicate' | 'delete' | 'selectAll' | 'group' | 'ungroup' | 'nudge' | 'prevSlide' | 'nextSlide' | 'escape' | 'find' | 'findReplace' | 'toggleShortcuts' | 'alignLeft' | 'alignCenter' | 'alignRight' | 'alignJustify' | 'increaseFontSize' | 'decreaseFontSize' | 'copyFormat' | 'pasteFormat' | 'newSlide' | 'hyperlink' | 'clearFormatting' | 'cycleSelectionNext' | 'cycleSelectionPrev' | 'pasteSpecial';
+//#endregion
+//#region src/render/merge-shapes/merge-shapes-menu.d.ts
+/** The right-click command id for each operation. */
+type MergeShapesCommandId = 'merge-union' | 'merge-combine' | 'merge-fragment' | 'merge-intersect' | 'merge-subtract';
 /** Every command a canvas context menu can offer, in no particular order. */
-type ContextMenuCommandId = 'copy' | 'cut' | 'paste' | 'duplicate' | 'edit-text' | 'bring-forward' | 'send-backward' | 'bring-front' | 'send-back' | 'ai-ask' | 'ai-fix' | 'comment' | 'hyperlink' | 'table-insert-row-above' | 'table-insert-row-below' | 'table-delete-row' | 'table-insert-col-left' | 'table-insert-col-right' | 'table-delete-col' | 'table-merge-selected' | 'table-merge-right' | 'table-merge-down' | 'table-split' | 'group' | 'ungroup' | 'save-as-picture' | 'edit-alt-text' | 'size-and-position' | 'format-shape' | 'delete';
+type ContextMenuCommandId = 'copy' | 'cut' | 'paste' | 'duplicate' | 'edit-text' | 'edit-points' | 'bring-forward' | 'send-backward' | 'bring-front' | 'send-back' | 'ai-ask' | 'ai-fix' | 'comment' | 'hyperlink' | 'table-insert-row-above' | 'table-insert-row-below' | 'table-delete-row' | 'table-insert-col-left' | 'table-insert-col-right' | 'table-delete-col' | 'table-merge-selected' | 'table-merge-right' | 'table-merge-down' | 'table-split' | 'group' | 'ungroup' | 'crop' | MergeShapesCommandId | 'save-as-picture' | 'edit-alt-text' | 'size-and-position' | 'format-shape' | 'delete';
 //#endregion
 //#region src/render/canvas-context-menu-commands.d.ts
 /**
@@ -12391,7 +12588,7 @@ interface AccountAuthConfig {
  * whole control cluster (zoom in/out/fit, prev/next) rather than each button
  * in it, matching how hosts actually want to hide/keep them as a unit.
  */
-type ToolbarButtonId = 'share' | 'broadcast' | 'export' | 'undo' | 'redo' | 'record' | 'notes' | 'fullscreen' | 'zoom' | 'navigation';
+type ToolbarButtonId = 'share' | 'broadcast' | 'export' | 'undo' | 'redo' | 'record' | 'notes' | 'fullscreen' | 'zoom' | 'navigation' | 'mergeShapes' | 'crop';
 /** A top-level ribbon tab. `record` intentionally shares its id with the quick-access Record button above: both surface the same recording feature, so hiding one hides the other. */
 type ToolbarTabId = 'file' | 'home' | 'insert' | 'draw' | 'design' | 'transitions' | 'animations' | 'slideShow' | 'record' | 'review' | 'view' | 'help';
 type ToolbarActionId = ToolbarButtonId | ToolbarTabId;
@@ -12554,6 +12751,12 @@ interface ViewerOptions {
 }
 type ViewerOptionsGroupId = keyof ViewerOptions;
 type ViewerOptionPrimitive = boolean | number | string;
+/** Every command the Edit Points right-click menu can offer. */
+type EditPointsCommandId = 'add-point' | 'delete-point' | 'delete-segment' | 'open-path' | 'close-path' | 'smooth-point' | 'straight-point' | 'corner-point' | 'straight-segment' | 'curved-segment' | 'exit';
+//#endregion
+//#region src/render/edit-points/freeform-tool-geometry.d.ts
+/** The two click-to-place drawing tools. */
+type FreeformToolKind = 'freeformShape' | 'curve';
 //#endregion
 //#region src/render/options/viewer-options-controls.d.ts
 /**
@@ -12624,6 +12827,11 @@ interface ContextMenuCustomization {
   hiddenElementCommands?: readonly ContextMenuCommandId[];
   /** Entries to remove from the empty-canvas menu. */
   hiddenCanvasCommands?: readonly CanvasContextMenuCommandId[];
+  /**
+   * Entries to remove from the Edit Points menu (right-click a vertex or a
+   * segment while editing a shape's points).
+   */
+  hiddenEditPointsCommands?: readonly EditPointsCommandId[];
   /** Remove the element context menu entirely. */
   disableElementMenu?: boolean;
   /** Remove the empty-canvas context menu entirely. */
@@ -12653,7 +12861,12 @@ interface KeyboardCustomization {
  */
 type ViewerPanelId = 'statusBar' | 'slidesPane' | 'inspector' | 'notes' | 'quickAccessToolbar' | 'titleBar';
 /** Feature areas that can be switched off as a whole. */
-type ViewerFeatureId = 'ai' | 'collaboration' | 'comments' | 'presentMode';
+type ViewerFeatureId = 'ai' | 'collaboration' | 'comments' | 'presentMode' | 'editPoints';
+/**
+ * The click-to-place drawing tools of Insert > Shapes > Lines: Freeform:
+ * Shape and Curve.
+ */
+type ViewerDrawingToolId = FreeformToolKind;
 /** Dialogs (and the entry points that open them) a host can remove. */
 type ViewerDialogId = 'options' | 'share' | 'broadcast' | 'print' | 'export';
 /** Export formats offered by the File > Export page. */
@@ -12676,6 +12889,8 @@ interface ViewerCustomization {
   hiddenDialogs?: readonly ViewerDialogId[];
   /** Export formats to remove from File > Export. */
   hiddenExportFormats?: readonly ViewerExportFormatId[];
+  /** Drawing tools to remove from the Insert > Shapes gallery. */
+  hiddenDrawingTools?: readonly ViewerDrawingToolId[];
 }
 //#endregion
 //#region src/render/customization/customization-controller.d.ts
@@ -13185,7 +13400,7 @@ interface CanvasContextMenuState {
   y: number;
 }
 /** Identifies an action triggered from the element right-click context menu. */
-type ElementContextMenuAction = 'copy' | 'cut' | 'paste' | 'duplicate' | 'delete' | 'bring-forward' | 'send-backward' | 'bring-front' | 'send-back' | 'bringForward' | 'sendBackward' | 'bringToFront' | 'sendToBack' | 'comment' | 'addComment' | 'group' | 'ungroup' | 'editPoints' | 'editHyperlink' | 'edit-text' | 'save-as-picture' | 'edit-alt-text' | 'size-and-position' | 'format-shape';
+type ElementContextMenuAction = 'copy' | 'cut' | 'paste' | 'duplicate' | 'delete' | 'bring-forward' | 'send-backward' | 'bring-front' | 'send-back' | 'bringForward' | 'sendBackward' | 'bringToFront' | 'sendToBack' | 'comment' | 'addComment' | 'group' | 'ungroup' | 'editPoints' | 'edit-points' | 'editHyperlink' | 'edit-text' | 'save-as-picture' | 'edit-alt-text' | 'size-and-position' | 'format-shape';
 /**
  * State of an active marquee (rubber-band) selection rectangle.
  * Created when the user clicks and drags on the canvas background,

package/dist/viewer/index.js

@@ -1,96 +1,96 @@
 'use strict';
 
-var chunkDFSWCVRW_js = require('../chunk-DFSWCVRW.js');
-require('../chunk-5V5SMT5A.js');
-var chunkIBHIXBC5_js = require('../chunk-IBHIXBC5.js');
-var chunkY4QUVWZC_js = require('../chunk-Y4QUVWZC.js');
-var chunkFZSYLXJT_js = require('../chunk-FZSYLXJT.js');
-require('../chunk-3JUZOKFI.js');
+var chunkNV2H57Q4_js = require('../chunk-NV2H57Q4.js');
+require('../chunk-UTP22QYH.js');
+var chunkQ7NWWIPQ_js = require('../chunk-Q7NWWIPQ.js');
+var chunkSAYZSUNQ_js = require('../chunk-SAYZSUNQ.js');
+var chunkYF2BQIW3_js = require('../chunk-YF2BQIW3.js');
+require('../chunk-LTBTG2QB.js');
 require('../chunk-4VNS5WPM.js');
 
 
 
 Object.defineProperty(exports, "CollaborationStatusIndicator", {
   enumerable: true,
-  get: function () { return chunkDFSWCVRW_js.CollaborationStatusIndicator; }
+  get: function () { return chunkNV2H57Q4_js.CollaborationStatusIndicator; }
 });
 Object.defineProperty(exports, "PowerPointViewer", {
   enumerable: true,
-  get: function () { return chunkDFSWCVRW_js.PowerPointViewer; }
+  get: function () { return chunkNV2H57Q4_js.PowerPointViewer; }
 });
 Object.defineProperty(exports, "UserAvatarBar", {
   enumerable: true,
-  get: function () { return chunkDFSWCVRW_js.UserAvatarBar; }
+  get: function () { return chunkNV2H57Q4_js.UserAvatarBar; }
 });
 Object.defineProperty(exports, "CollaborationProvider", {
   enumerable: true,
-  get: function () { return chunkIBHIXBC5_js.CollaborationProvider; }
+  get: function () { return chunkQ7NWWIPQ_js.CollaborationProvider; }
 });
 Object.defineProperty(exports, "RemoteUserCursors", {
   enumerable: true,
-  get: function () { return chunkIBHIXBC5_js.RemoteUserCursors; }
+  get: function () { return chunkQ7NWWIPQ_js.RemoteUserCursors; }
 });
 Object.defineProperty(exports, "isAudienceTab", {
   enumerable: true,
-  get: function () { return chunkIBHIXBC5_js.isAudienceTab; }
+  get: function () { return chunkQ7NWWIPQ_js.isAudienceTab; }
 });
 Object.defineProperty(exports, "parseAudienceNonce", {
   enumerable: true,
-  get: function () { return chunkIBHIXBC5_js.parseAudienceNonce; }
+  get: function () { return chunkQ7NWWIPQ_js.parseAudienceNonce; }
 });
 Object.defineProperty(exports, "useCollaborativeHistory", {
   enumerable: true,
-  get: function () { return chunkIBHIXBC5_js.useCollaborativeHistory; }
+  get: function () { return chunkQ7NWWIPQ_js.useCollaborativeHistory; }
 });
 Object.defineProperty(exports, "useCollaborativeState", {
   enumerable: true,
-  get: function () { return chunkIBHIXBC5_js.useCollaborativeState; }
+  get: function () { return chunkQ7NWWIPQ_js.useCollaborativeState; }
 });
 Object.defineProperty(exports, "usePresenceTracking", {
   enumerable: true,
-  get: function () { return chunkIBHIXBC5_js.usePresenceTracking; }
+  get: function () { return chunkQ7NWWIPQ_js.usePresenceTracking; }
 });
 Object.defineProperty(exports, "useThemeSwitching", {
   enumerable: true,
-  get: function () { return chunkIBHIXBC5_js.useThemeSwitching; }
+  get: function () { return chunkQ7NWWIPQ_js.useThemeSwitching; }
 });
 Object.defineProperty(exports, "useYjsProvider", {
   enumerable: true,
-  get: function () { return chunkIBHIXBC5_js.useYjsProvider; }
+  get: function () { return chunkQ7NWWIPQ_js.useYjsProvider; }
 });
 Object.defineProperty(exports, "getAnimationInitialStyle", {
   enumerable: true,
-  get: function () { return chunkY4QUVWZC_js.getAnimationInitialStyle; }
+  get: function () { return chunkSAYZSUNQ_js.getAnimationInitialStyle; }
 });
 Object.defineProperty(exports, "clearAudienceContent", {
   enumerable: true,
-  get: function () { return chunkFZSYLXJT_js.clearAudienceContent; }
+  get: function () { return chunkYF2BQIW3_js.clearAudienceContent; }
 });
 Object.defineProperty(exports, "forgetSessionDeck", {
   enumerable: true,
-  get: function () { return chunkFZSYLXJT_js.forgetSessionDeck; }
+  get: function () { return chunkYF2BQIW3_js.forgetSessionDeck; }
 });
 Object.defineProperty(exports, "getSessionTabId", {
   enumerable: true,
-  get: function () { return chunkFZSYLXJT_js.getSessionTabId; }
+  get: function () { return chunkYF2BQIW3_js.getSessionTabId; }
 });
 Object.defineProperty(exports, "loadAudienceContent", {
   enumerable: true,
-  get: function () { return chunkFZSYLXJT_js.loadAudienceContent; }
+  get: function () { return chunkYF2BQIW3_js.loadAudienceContent; }
 });
 Object.defineProperty(exports, "loadSessionDeck", {
   enumerable: true,
-  get: function () { return chunkFZSYLXJT_js.loadSessionDeck; }
+  get: function () { return chunkYF2BQIW3_js.loadSessionDeck; }
 });
 Object.defineProperty(exports, "rememberSessionDeck", {
   enumerable: true,
-  get: function () { return chunkFZSYLXJT_js.rememberSessionDeck; }
+  get: function () { return chunkYF2BQIW3_js.rememberSessionDeck; }
 });
 Object.defineProperty(exports, "restoreSessionDeck", {
   enumerable: true,
-  get: function () { return chunkFZSYLXJT_js.restoreSessionDeck; }
+  get: function () { return chunkYF2BQIW3_js.restoreSessionDeck; }
 });
 Object.defineProperty(exports, "storeAudienceContent", {
   enumerable: true,
-  get: function () { return chunkFZSYLXJT_js.storeAudienceContent; }
+  get: function () { return chunkYF2BQIW3_js.storeAudienceContent; }
 });

package/dist/viewer/index.mjs

@@ -1,7 +1,7 @@
-export { CollaborationStatusIndicator, PowerPointViewer, UserAvatarBar } from '../chunk-ZAQFTO4P.mjs';
-import '../chunk-VCAQSSGD.mjs';
-export { CollaborationProvider, RemoteUserCursors, isAudienceTab, parseAudienceNonce, useCollaborativeHistory, useCollaborativeState, usePresenceTracking, useThemeSwitching, useYjsProvider } from '../chunk-INX3E37P.mjs';
-export { getAnimationInitialStyle } from '../chunk-K6QHGABT.mjs';
-export { clearAudienceContent, forgetSessionDeck, getSessionTabId, loadAudienceContent, loadSessionDeck, rememberSessionDeck, restoreSessionDeck, storeAudienceContent } from '../chunk-ICEZL4TM.mjs';
-import '../chunk-OOO4JL2N.mjs';
+export { CollaborationStatusIndicator, PowerPointViewer, UserAvatarBar } from '../chunk-KHEJXP4I.mjs';
+import '../chunk-Q4XJSJYI.mjs';
+export { CollaborationProvider, RemoteUserCursors, isAudienceTab, parseAudienceNonce, useCollaborativeHistory, useCollaborativeState, usePresenceTracking, useThemeSwitching, useYjsProvider } from '../chunk-SOMUGI3Y.mjs';
+export { getAnimationInitialStyle } from '../chunk-SSXGPYBF.mjs';
+export { clearAudienceContent, forgetSessionDeck, getSessionTabId, loadAudienceContent, loadSessionDeck, rememberSessionDeck, restoreSessionDeck, storeAudienceContent } from '../chunk-NPZOVIHG.mjs';
+import '../chunk-YPDPSXPK.mjs';
 import '../chunk-XGB3TDIC.mjs';

package/dist/viewer/index.mjs.br

@@ -1,3 +1,2 @@
-����8��ݣ�u��vT��7Ra�m��6��^�a���x$�m[D챷�-��@���ɰ߽�ȶ�ƣ�����!��x���0Q��^���?D�T��[��c#��|s���a'P�r����`��1
-~�.W���*k;ܑEI�T����Ǩ��V�J]�+;��BE~a%J'��:�9��vPq:'1ɚ�x��>�'dp3�]1�LYɐr���XH|�5g��F]hc��
����[��B-���TB�9ΨL
-_�z��o<|7���@e*\��*
+�@��w���\W�k��ڧ�����
+'{}�������[�EsX��7@"���mIA�ە��c��ĉ�Ʉ

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "pptx-react-viewer",
-	"version": "4.6.0",
+	"version": "4.8.0",
 	"description": "React PowerPoint viewer and editor component: render, edit, and export PPTX slides in the browser.",
 	"keywords": [
 		"editor",