pptx-svelte-viewer 4.6.0 → 4.7.0

package/dist/{translator-DC6tH5v7.js → translator-D5VddVYr.js}

@@ -1132,6 +1132,13 @@ var n = {
   "pptx.shape.quickStyleSubtle": "Subtle",
   "pptx.shape.quickStyleOutline": "Outline",
   "pptx.shape.quickStyleDark": "Dark",
+  "pptx.shape.mergeShapes": "Merge Shapes",
+  "pptx.shape.mergeShapesHint": "Select two or more shapes to merge them",
+  "pptx.shape.mergeUnion": "Union",
+  "pptx.shape.mergeCombine": "Combine",
+  "pptx.shape.mergeFragment": "Fragment",
+  "pptx.shape.mergeIntersect": "Intersect",
+  "pptx.shape.mergeSubtract": "Subtract",
   "pptx.slideBackground.colour": "Colour",
   "pptx.slideBackground.colourAriaLabel": "Slide background colour",
   "pptx.slideBackground.image": "Image",
@@ -1173,6 +1180,10 @@ var n = {
   "pptx.animation.trigger": "Trigger",
   "pptx.animation.trigger.selectShape": "Select a shape",
   "pptx.animation.trigger.shapeLabel": "Trigger shape",
+  "pptx.animation.trigger.onMediaBookmark": "On bookmark",
+  "pptx.animation.trigger.bookmarkLabel": "Bookmark",
+  "pptx.animation.trigger.selectBookmark": "Select a bookmark",
+  "pptx.animation.trigger.noBookmarks": "No media bookmarks on this slide",
   "pptx.chart.heading": "Chart",
   "pptx.comments.addOnElement": "Add a comment on {{element}}...",
   "pptx.comments.addPlaceholder": "Add a comment...",
@@ -1220,6 +1231,12 @@ var n = {
   "pptx.contextMenu.sizeAndPosition": "Size and Position...",
   "pptx.contextMenu.splitCell": "Split Cell",
   "pptx.contextMenu.ungroup": "Ungroup",
+  "pptx.contextMenu.crop": "Crop",
+  "pptx.contextMenu.mergeUnion": "Union Shapes",
+  "pptx.contextMenu.mergeCombine": "Combine Shapes",
+  "pptx.contextMenu.mergeFragment": "Fragment Shapes",
+  "pptx.contextMenu.mergeIntersect": "Intersect Shapes",
+  "pptx.contextMenu.mergeSubtract": "Subtract Shapes",
   "pptx.pasteSpecial.dialogTitle": "Paste Special",
   "pptx.pasteSpecial.keepSourceFormatting": "Keep Source Formatting",
   "pptx.pasteSpecial.keepTextOnly": "Keep Text Only",
@@ -1555,6 +1572,21 @@ var n = {
   "pptx.transition.pattern.rectangle": "Rectangles",
   "pptx.transition.thruBlk": "Through black",
   "pptx.contextMenu.ariaLabel": "Context menu",
+  "pptx.contextMenu.editPoints": "Edit Points",
+  "pptx.editPoints.addPoint": "Add Point",
+  "pptx.editPoints.closePath": "Close Path",
+  "pptx.editPoints.cornerPoint": "Corner Point",
+  "pptx.editPoints.curvedSegment": "Curved Segment",
+  "pptx.editPoints.deletePoint": "Delete Point",
+  "pptx.editPoints.deleteSegment": "Delete Segment",
+  "pptx.editPoints.exit": "Exit Edit Points",
+  "pptx.editPoints.menu": "Edit Points commands",
+  "pptx.editPoints.openPath": "Open Path",
+  "pptx.editPoints.overlay": "Edit points of the selected shape",
+  "pptx.editPoints.smoothPoint": "Smooth Point",
+  "pptx.editPoints.straightPoint": "Straight Point",
+  "pptx.editPoints.straightSegment": "Straight Segment",
+  "pptx.freeformTool.overlay": "Click to add points; double-click or press Enter to finish",
   "pptx.editorToolbar.ariaLabel": "Editor toolbar",
   "pptx.editorToolbar.insert": "Insert",
   "pptx.editorToolbar.insertTextBox": "Insert Text Box",
@@ -2785,6 +2817,16 @@ Item 3`,
   "pptx.image.cropLeft": "Crop Left",
   "pptx.image.cropRight": "Crop Right",
   "pptx.image.cropTop": "Crop Top",
+  "pptx.image.crop": "Crop",
+  "pptx.image.cropToAspectRatio": "Crop to Aspect Ratio",
+  "pptx.image.cropFill": "Fill",
+  "pptx.image.cropFit": "Fit",
+  "pptx.image.cropSquare": "Square",
+  "pptx.image.cropPortrait": "Portrait",
+  "pptx.image.cropLandscape": "Landscape",
+  "pptx.image.cropHandle": "Crop handle",
+  "pptx.image.cropModeHint": "Drag the black handles to crop. Press Enter to apply or Esc to cancel.",
+  "pptx.image.cropHint": "Select a picture to crop it",
   "pptx.imageTransform.altTextPlaceholder": "Describe this image for accessibility",
   "pptx.ink.contentPartFallback": "Content Part",
   "pptx.ink.groupChildAlt": "Group child",
@@ -2817,9 +2859,11 @@ Item 3`,
   "pptx.shapePresets.chevron": "Chevron",
   "pptx.shapePresets.circle": "Circle",
   "pptx.shapePresets.cloud": "Cloud",
+  "pptx.shapePresets.curve": "Curve",
   "pptx.shapePresets.cylinder": "Cylinder",
   "pptx.shapePresets.diamond": "Diamond",
   "pptx.shapePresets.downArrow": "Down Arrow",
+  "pptx.shapePresets.freeformShape": "Freeform: Shape",
   "pptx.shapePresets.heart": "Heart",
   "pptx.shapePresets.hexagon": "Hexagon",
   "pptx.shapePresets.leftArrow": "Left Arrow",

package/dist/viewer/index.d.ts

@@ -1484,8 +1484,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`). */
@@ -1519,6 +1527,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;
@@ -1604,6 +1631,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/>`
@@ -1967,6 +2001,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}
@@ -3235,6 +3282,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;
@@ -3560,6 +3627,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).
    *
@@ -3734,6 +3807,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`). */
@@ -3859,6 +3938,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`). */
@@ -7737,7 +7820,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`,
@@ -7890,8 +7981,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. */
@@ -8390,12 +8486,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;
 }
@@ -8573,9 +8672,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;
@@ -11830,6 +11944,9 @@ interface SvgExportOptions {
   defaultFontSize?: number;
 }
 
+/** Supported merge shape operations (matching PowerPoint's Merge Shapes menu). */
+type MergeShapeOperation = 'union' | 'intersect' | 'subtract' | 'fragment' | 'combine';
+
 //#region src/theme/types.d.ts
 /**
  * Theme configuration types for the PowerPoint viewer.
@@ -13276,8 +13393,12 @@ interface PresentationInkStroke {
 }
 /** 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
 /**
@@ -13735,7 +13856,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;
@@ -13942,6 +14063,12 @@ interface PrintSettings {
    */
   scaleToFit?: boolean;
 }
+/** 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
 /**
@@ -14012,6 +14139,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. */
@@ -14041,7 +14173,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. */
@@ -14064,6 +14201,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/options/viewer-options-constraints.d.ts
@@ -14109,6 +14248,8 @@ interface ResolvedCustomization {
   hiddenBackstageCards: ReadonlySet<BackstageCardId>;
   hiddenElementCommands: ReadonlySet<ContextMenuCommandId>;
   hiddenCanvasCommands: ReadonlySet<CanvasContextMenuCommandId>;
+  hiddenEditPointsCommands: ReadonlySet<EditPointsCommandId>;
+  hiddenDrawingTools: ReadonlySet<ViewerDrawingToolId>;
   elementMenuEnabled: boolean;
   canvasMenuEnabled: boolean;
   hiddenPanels: ReadonlySet<ViewerPanelId>;
@@ -14274,6 +14415,33 @@ interface ViewportFitOptions {
   /** Positive fit-factor ceiling; null allows enlargement without a ceiling. */
   maxFitScale?: number | null;
 }
+/** The element fields an Edit Points commit writes. */
+type EditPointsElementPatch = Pick<ShapePptxElement, 'x' | 'y' | 'width' | 'height' | 'shapeType' | 'shapeAdjustments' | 'pathData' | 'pathWidth' | 'pathHeight' | 'customGeometryPaths' | 'customGeometryRawData' | 'customGeometryAdjustHandlesXY' | 'customGeometryAdjustHandlesPolar' | 'customGeometryConnectionSites' | 'customGeometryTextRect'>;
+//#endregion
+//#region src/render/picture-crop/crop-geometry.d.ts
+/** An axis-aligned rectangle in slide pixels. */
+interface CropRect {
+  x: number;
+  y: number;
+  width: number;
+  height: number;
+}
+/** The four `a:srcRect` insets as fractions of the image (negative pads). */
+interface CropInsets {
+  cropLeft: number;
+  cropTop: number;
+  cropRight: number;
+  cropBottom: number;
+}
+/** What a crop edit writes back onto the picture element. */
+type CropElementUpdate = CropInsets & CropRect;
+/** The snapshot a crop session restores on cancel. */
+interface CropSession {
+  elementId: string;
+  original: CropElementUpdate;
+  /** Insets the picture did not carry at all (no `a:srcRect` opinion). */
+  absentInsets: readonly (keyof CropInsets)[];
+}
 //#endregion
 //#region src/export/rasterize-element-strategy.d.ts
 /** Which path actually produced the tile, for telemetry/tests. */
@@ -15568,6 +15736,12 @@ declare class EditorArrangeController {
     groupSelected(): void;
     /** Ungroup the primary selected group element. Selects the ungrouped children. */
     ungroupSelected(): void;
+    /**
+     * Merge Shapes (Union / Combine / Fragment / Intersect / Subtract) over the
+     * selection IN SELECTION ORDER, so the first-selected shape's formatting
+     * survives. One undo step; selects the new shape(s). False when a no-op.
+     */
+    mergeSelected(operation: MergeShapeOperation): boolean;
 }
 
 /**
@@ -15624,6 +15798,53 @@ declare class EditorClipboardController {
     replaceElement(elementId: string, next: PptxElement): void;
 }
 
+/**
+ * On-canvas picture crop mode (Picture Format > Crop), driven by the shared
+ * `picture-crop` lifecycle:
+ *
+ * - {@link enter}: the ribbon Crop button or the picture context menu's Crop.
+ * - {@link preview}: handle and pan drags write the picture LIVE, with no
+ *   history, so the normal renderer shows the new `a:srcRect` as it changes.
+ * - {@link commit}: Enter, a click outside, a selection or slide change, or
+ *   Crop again. Rewinds the picture to the entry snapshot, records history
+ *   there, then re-applies the result: exactly ONE undo step, whose undo
+ *   restores the pre-crop picture (none when nothing changed).
+ * - {@link cancel}: Escape writes the snapshot back and leaves no undo step.
+ */
+declare class EditorCropController {
+    #private;
+    session: CropSession | null;
+    constructor(editor: EditorState);
+    get active(): boolean;
+    /** The picture being cropped, as it is right now. */
+    get element(): PptxElement | undefined;
+    /** Editable, exactly one element selected, and it is a croppable picture. */
+    get canCrop(): boolean;
+    /** Enter crop mode on the selected picture. False when it cannot be cropped. */
+    enter(): boolean;
+    /** The ribbon Crop toggle: enter, or commit when already cropping. */
+    toggle(): void;
+    /** Apply a live crop update onto the picture without recording history. */
+    preview(update: CropElementUpdate): void;
+    /** End the session, leaving one undo step when the picture changed. */
+    commit(): void;
+    /** End the session and restore the picture as it was on entry, with no undo step. */
+    cancel(): void;
+    /**
+     * Enter commits and Escape cancels while cropping; the key is consumed so
+     * the editor's own Enter/Escape action does not also run. True when handled.
+     */
+    handleKey(event: KeyboardEvent): boolean;
+    /** Commit when the selection moved off the picture or the slide changed. */
+    syncContext(selectedIds: readonly string[], slideIndex: number): void;
+    /**
+     * A one-click crop (aspect ratio, Fill, Fit) on the selected picture. Inside
+     * a session it joins the session's single undo step; otherwise it is one
+     * undoable update of its own.
+     */
+    applyOnce(update: CropElementUpdate): void;
+}
+
 interface EditorSnapshot {
     slides: PptxSlide[];
     templateElementsBySlideId: TemplateElementMap;
@@ -15875,6 +16096,36 @@ declare class EditorMasterCrudController {
     run(id: MasterViewCrudActionId, prompts: MasterViewCrudPrompts): Promise<boolean>;
 }
 
+/**
+ * EditorOutlineController: state for the two outline-authoring modes, Edit
+ * Points on one shape and the armed Freeform: Shape / Curve drawing tool
+ * (Svelte counterpart of React's `useEditPointsState` + `useOutlineAuthoring`).
+ * At most one is active: arming a tool ends Edit Points and starting Edit
+ * Points disarms the tool. Every behaviour (hit targets, drags, the vertex /
+ * segment menu, the element patch) lives in the shared sessions; this only
+ * holds which mode is on and routes their results through `EditorState`, so
+ * each commit is one undo step. Instantiated as `EditorState.outlineOps`.
+ */
+declare class EditorOutlineController {
+    #private;
+    /** The shape in Edit Points mode, or null. */
+    editPointsId: string | null;
+    /** The armed click-to-place drawing tool, or null. */
+    freeformTool: FreeformToolKind | null;
+    constructor(editor: EditorState);
+    /** The shape being edited, while it still exists on the active layer. */
+    get editPointsElement(): PptxElement | undefined;
+    /** Enter Edit Points on `id` when the shape allows it (not `noEditPoints`). */
+    startEditPoints(id: string): void;
+    exitEditPoints(): void;
+    /** Apply one Edit Points edit as one undo step. */
+    commitEditPoints(id: string, patch: EditPointsElementPatch): void;
+    /** Arm (or, with null, disarm) a drawing tool. */
+    armFreeformTool(tool: FreeformToolKind | null): void;
+    /** Insert a drawn freeform (selected, one undo step) and disarm. */
+    commitFreeform(shape: ShapePptxElement): void;
+}
+
 interface PresentationMetadataHost {
     readonly editable: boolean;
     pushHistory(): void;
@@ -16294,10 +16545,14 @@ declare class EditorState {
     readonly slidesOps: EditorSlidesController;
     readonly sectionOps: EditorSectionController;
     readonly arrangeOps: EditorArrangeController;
+    /** On-canvas picture crop mode (ribbon Crop / context-menu Crop). */
+    readonly cropOps: EditorCropController;
     readonly backgroundOps: EditorBackgroundController;
     readonly transitionOps: EditorTransitionController;
     readonly animationOps: EditorAnimationController;
     readonly inkOps: EditorInkController;
+    /** Edit Points and the Freeform: Shape / Curve tools. */
+    readonly outlineOps: EditorOutlineController;
     readonly masterOps: EditorMasterController;
     readonly masterCrud: EditorMasterCrudController;
     readonly formatPainter: EditorFormatPainterController;

package/dist/viewer/index.js

@@ -1,24 +1,24 @@
-import { Mg as l, jg as S } from "../transition-overlay-Dkooknvn.js";
-import { A as e, I as a, N as o, P as r, a as n, c as d, d as b, f as p, i as c, j as s, k as t, l as g, n as m, o as x, p as w, r as C, s as P, t as T, u as $ } from "../export-zzqiDncO.js";
+import { E_ as l, T_ as S } from "../transition-overlay-BjAhkWT1.js";
+import { A as e, I as a, N as o, P as r, a as n, c as d, d as b, f as p, i as c, j as s, k as t, l as m, n as g, o as x, p as T, r as w, s as C, t as P, u as $ } from "../export-BmYgdMk2.js";
 var y = a, A = r, V = s, f = e, u = t, R = o;
 export {
   f as CollaborationCursors,
   R as EditorLayer,
-  T as PowerPointViewer,
+  P as PowerPointViewer,
   c as PresentationLoader,
   u as RemoteSelectionOverlay,
   y as Ribbon,
   V as SlideCanvas,
-  C as ViewerState,
+  w as ViewerState,
   A as ViewerToolbar,
   $ as clampSlideIndex,
-  w as createSvelteAiBridge,
-  m as createViewerState,
+  T as createSvelteAiBridge,
+  g as createViewerState,
   n as exportAllSlidesToSvg,
   x as exportAllSlidesToSvgBlobs,
-  P as exportSlideAsSvg,
+  C as exportSlideAsSvg,
   d as exportSlideToSvg,
-  g as exportSlideToSvgBlob,
+  m as exportSlideToSvgBlob,
   b as fitScale,
   p as resolveNavigationKey,
   S as zoomInPercent,

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "pptx-svelte-viewer",
-	"version": "4.6.0",
+	"version": "4.7.0",
 	"description": "Svelte 5 PowerPoint viewer and editor component: render, edit, present, and export PPTX slides in the browser.",
 	"keywords": [
 		"office",