pptx-react-viewer 4.5.0 → 4.7.0

package/dist/internals.d.ts

@@ -1483,8 +1483,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`). */
@@ -1518,6 +1526,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;
@@ -1603,6 +1630,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/>`
@@ -1966,6 +2000,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}
@@ -3234,6 +3281,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;
@@ -3559,6 +3626,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).
    *
@@ -3733,6 +3806,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`). */
@@ -3858,6 +3937,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`). */
@@ -7736,7 +7819,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`,
@@ -7889,8 +7980,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. */
@@ -8389,12 +8485,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;
 }
@@ -8572,9 +8671,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;
@@ -13354,6 +13468,31 @@ interface PresentationInkStroke {
   width: number;
   points: PresentationInkPoint[];
 }
+/** 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' | '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
+/**
+ * The right-click menu for the empty slide canvas (no element under the
+ * cursor), as distinct from {@link ./context-menu-commands}'s per-element menu.
+ *
+ * Right-clicking empty canvas used to do nothing at all in every binding: React
+ * and Vue both bailed out early (`getElementIdFromEvent` returns `null`, so the
+ * handler just returns) rather than opening a menu, and the other three never
+ * wired a handler for it either. PowerPoint offers Paste, Layout, Reset,
+ * Format Background and view toggles (Grid and Guides, Ruler) from this menu;
+ * this module is the one list every binding renders instead of five omissions.
+ *
+ * @module render/canvas-context-menu-commands
+ */
+/** Every command the empty-canvas context menu can offer, in no particular order. */
+type CanvasContextMenuCommandId = 'paste' | 'layout' | 'reset-slide' | 'format-background' | 'grid-and-guides' | 'ruler';
 //#endregion
 //#region src/render/paste-special.d.ts
 /** The four paste formats PowerPoint's Paste Options / Paste Special offer. */
@@ -13487,6 +13626,21 @@ interface AutosaveRecoveryPrompt {
   readonly restoreKey: string;
   readonly discardKey: string;
 }
+type BackstagePage = 'home' | 'new' | 'open' | 'info' | 'save' | 'saveAs' | 'print' | 'share' | 'export' | 'close' | 'account' | 'options';
+//#endregion
+//#region src/render/backstage-cards.d.ts
+/**
+ * Every action card the File-tab backstage can show, keyed by the operation it
+ * triggers rather than by its wording.
+ *
+ * The five bindings used to hardcode a title and a body string each, which made
+ * the whole backstage untranslatable and let the copy drift: the same card
+ * carried four different descriptions depending on which binding you opened it
+ * in. Both halves now live here as a dictionary key plus an English fallback,
+ * so a wording change lands everywhere at once and a translator only has to
+ * translate it once.
+ */
+type BackstageCardId = 'protect' | 'inspect' | 'embedFonts' | 'signatures' | 'versionHistory' | 'saveAsPptx' | 'saveAsPpsx' | 'saveAsPptm' | 'saveAsPpt' | 'pdf' | 'png' | 'video' | 'gif' | 'json' | 'copyImage' | 'print' | 'share';
 //#endregion
 //#region src/render/master-view.d.ts
 /** Which part the master view is currently pointed at. */
@@ -13585,7 +13739,7 @@ interface AuthoredSlideRange {
  * 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;
@@ -13791,6 +13945,154 @@ 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
+/**
+ * Control/section/tab descriptor types for the File > Options schema, plus
+ * the terse constructors the tab-definition modules build panes with.
+ */
+type ViewerOptionsTabId = 'general' | 'proofing' | 'save' | 'language' | 'accessibility' | 'advanced' | 'ribbon' | 'quickAccess' | 'addIns' | 'trust';
+//#endregion
+//#region src/render/customization/customization-types.d.ts
+/** Keys of an options group whose value is a primitive (not an array). */
+type PrimitiveKeys<T> = { [K in keyof T]: T[K] extends ViewerOptionPrimitive ? K : never; }[keyof T] & string;
+/**
+ * One File > Options setting, addressed as `<group>.<key>`, for example
+ * `general.userName` or `advanced.showGrid`. The union is derived from the
+ * `ViewerOptions` model itself, so a typo is a compile error.
+ */
+type OptionsSettingId = { [G in ViewerOptionsGroupId]: `${G}.${PrimitiveKeys<ViewerOptions[G]>}`; }[ViewerOptionsGroupId];
+/**
+ * A File > Options page: the ten PowerPoint categories plus `ai`, the AI
+ * assistant page a binding adds when the host configured an assistant.
+ */
+type OptionsPageId = ViewerOptionsTabId | 'ai';
+/**
+ * One section of an Options page, addressed as `<page>.<section>`, for
+ * example `general.personalize` or `advanced.print`. The full list is
+ * `OPTIONS_SECTION_IDS` (derived from the schema at runtime).
+ */
+type OptionsSectionId = `${ViewerOptionsTabId}.${string}`;
+/** Values a host forces onto settings. */
+type OptionsSettingValues = Partial<Record<OptionsSettingId, ViewerOptionPrimitive>>;
+/** Ribbon and toolbar customisation. */
+interface RibbonCustomization {
+  /** Ribbon tabs to remove (the File tab included, unlike Customize Ribbon). */
+  hiddenTabs?: readonly ToolbarTabId[];
+  /** Top-level toolbar buttons / control clusters to remove. */
+  hiddenButtons?: readonly ToolbarButtonId[];
+}
+/** File > Options (the Settings dialog) customisation. */
+interface OptionsCustomization {
+  /** Whole pages to remove from the dialog's category rail. */
+  hiddenPages?: readonly OptionsPageId[];
+  /** Sections (`<page>.<section>`) to remove from their page. */
+  hiddenSections?: readonly OptionsSectionId[];
+  /** Individual settings (`<group>.<key>`) to remove wherever they appear. */
+  hiddenSettings?: readonly OptionsSettingId[];
+  /**
+   * Settings pinned to a fixed value. The value is forced into the options
+   * store, user edits to it are ignored, and the control renders read-only.
+   * Add the id to `hiddenSettings` too to lock it invisibly.
+   */
+  locked?: OptionsSettingValues;
+  /**
+   * Host defaults: the value a setting starts at when the user has not saved
+   * a choice of their own. "Reset" returns to these, not to the built-ins.
+   */
+  defaults?: OptionsSettingValues;
+}
+/** File tab (backstage) customisation. */
+interface BackstageCustomization {
+  /** Navigation entries (pages) to remove from the File tab. */
+  hiddenPages?: readonly BackstagePage[];
+  /** Action cards to remove from the pages that show them. */
+  hiddenCards?: readonly BackstageCardId[];
+}
+/** Right-click menu customisation. */
+interface ContextMenuCustomization {
+  /** Entries to remove from the element (right-click on a shape) menu. */
+  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. */
+  disableCanvasMenu?: boolean;
+}
+/**
+ * A shortcut chord in the form `Mod+Shift+D`: modifiers `Mod` (Ctrl on
+ * Windows/Linux, Cmd on macOS), `Ctrl`, `Meta`, `Alt`, `Shift`, joined by `+`,
+ * followed by a `KeyboardEvent.key` value (`D`, `Delete`, `ArrowLeft`, `F2`).
+ */
+type ShortcutChord = string;
+/** Editor keyboard-shortcut customisation. */
+interface KeyboardCustomization {
+  /** Turn every editor shortcut off (the host owns the keyboard). */
+  disableAll?: boolean;
+  /** Editor commands whose shortcut is turned off. */
+  disabled?: readonly EditorKeyActionName[];
+  /**
+   * Replacement chords per command. A remapped command no longer answers to
+   * its built-in chord; it answers to the chord(s) given here instead.
+   */
+  remap?: Partial<Record<EditorKeyActionName, ShortcutChord | readonly ShortcutChord[]>>;
+}
+/**
+ * Chrome regions a host can remove. Each id maps onto one region in every
+ * binding; see `VIEWER_PANEL_IDS` for the catalogue.
+ */
+type ViewerPanelId = 'statusBar' | 'slidesPane' | 'inspector' | 'notes' | 'quickAccessToolbar' | 'titleBar';
+/** Feature areas that can be switched off as a whole. */
+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. */
+type ViewerExportFormatId = 'pdf' | 'png' | 'video' | 'gif' | 'json' | 'copyImage';
+/**
+ * The whole customisation object. Every field is optional; omitted fields hide
+ * nothing and lock nothing.
+ */
+interface ViewerCustomization {
+  ribbon?: RibbonCustomization;
+  options?: OptionsCustomization;
+  backstage?: BackstageCustomization;
+  contextMenu?: ContextMenuCustomization;
+  keyboard?: KeyboardCustomization;
+  /** Chrome regions to remove (`true` hides). */
+  hiddenPanels?: readonly ViewerPanelId[];
+  /** Feature areas to switch off (their buttons, menus, pages and panels). */
+  disabledFeatures?: readonly ViewerFeatureId[];
+  /** Dialogs to remove, along with every entry point that opens them. */
+  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
+/** Locks and host defaults, both keyed `<group>.<key>`. */
+interface ViewerOptionsConstraints {
+  locked?: OptionsSettingValues;
+  defaults?: OptionsSettingValues;
+}
 //#endregion
 //#region src/render/options/viewer-options-store.d.ts
 /**
@@ -13835,6 +14137,98 @@ interface ViewerOptionsStore {
    * operation costs a single render instead of one per field.
    */
   batch(write: () => void): void;
+  /**
+   * Apply host constraints (see `ViewerOptionsConstraints`): `locked` values
+   * are forced in and every later write to them is ignored; `defaults`
+   * replace the built-in defaults for settings the user never saved, and
+   * become what `reset` returns to. Replaces any previous constraints.
+   */
+  setConstraints(constraints: ViewerOptionsConstraints): void;
+  /** True when the host locked `<group>.<key>`. */
+  isLocked(group: ViewerOptionsGroupId, key: string): boolean;
+}
+//#endregion
+//#region src/render/customization/customization-keymap.d.ts
+/** A parsed `Mod+Shift+D` chord. */
+interface ParsedShortcutChord {
+  key: string;
+  mod: boolean;
+  ctrl: boolean;
+  meta: boolean;
+  alt: boolean;
+  shift: boolean;
+}
+/** The normalised keyboard slice of a resolved customisation. */
+interface ResolvedKeyboardCustomization {
+  disableAll: boolean;
+  disabled: ReadonlySet<EditorKeyActionName>;
+  remap: ReadonlyMap<EditorKeyActionName, readonly ParsedShortcutChord[]>;
+}
+//#endregion
+//#region src/render/customization/customization-resolve.d.ts
+/** The normalised, set-based view of a customisation. Treat as immutable. */
+interface ResolvedCustomization {
+  hiddenActions: ReadonlySet<ToolbarActionId>;
+  hiddenOptionsPages: ReadonlySet<OptionsPageId>;
+  hiddenOptionsSections: ReadonlySet<OptionsSectionId>;
+  hiddenSettings: ReadonlySet<OptionsSettingId>;
+  lockedSettings: OptionsSettingValues;
+  defaultSettings: OptionsSettingValues;
+  hiddenBackstagePages: ReadonlySet<BackstagePage>;
+  hiddenBackstageCards: ReadonlySet<BackstageCardId>;
+  hiddenElementCommands: ReadonlySet<ContextMenuCommandId>;
+  hiddenCanvasCommands: ReadonlySet<CanvasContextMenuCommandId>;
+  hiddenEditPointsCommands: ReadonlySet<EditPointsCommandId>;
+  hiddenDrawingTools: ReadonlySet<ViewerDrawingToolId>;
+  elementMenuEnabled: boolean;
+  canvasMenuEnabled: boolean;
+  hiddenPanels: ReadonlySet<ViewerPanelId>;
+  disabledFeatures: ReadonlySet<ViewerFeatureId>;
+  hiddenDialogs: ReadonlySet<ViewerDialogId>;
+  keyboard: ResolvedKeyboardCustomization;
+}
+//#endregion
+//#region src/render/customization/customization-controller.d.ts
+/** The imperative methods every binding's component handle exposes. */
+interface ViewerCustomizationApi {
+  /** The current customisation object (a snapshot; do not mutate). */
+  getCustomization(): ViewerCustomization;
+  /** Replace the whole customisation. */
+  setCustomization(next: ViewerCustomization): void;
+  /** Merge a partial customisation (see `mergeCustomization`). */
+  updateCustomization(patch: ViewerCustomization): void;
+  /** Drop every customisation, back to the stock UI. */
+  resetCustomization(): void;
+  hideRibbonTab(tab: ToolbarTabId): void;
+  showRibbonTab(tab: ToolbarTabId): void;
+  hideToolbarButton(button: ToolbarButtonId): void;
+  showToolbarButton(button: ToolbarButtonId): void;
+  hideOptionsPage(page: OptionsPageId): void;
+  showOptionsPage(page: OptionsPageId): void;
+  hideOptionsSection(section: OptionsSectionId): void;
+  showOptionsSection(section: OptionsSectionId): void;
+  hideSetting(setting: OptionsSettingId): void;
+  showSetting(setting: OptionsSettingId): void;
+  /** Pin a setting to `value`; `hidden` also removes it from the dialog. */
+  lockSetting(setting: OptionsSettingId, value: ViewerOptionPrimitive, hidden?: boolean): void;
+  unlockSetting(setting: OptionsSettingId): void;
+  /** Set (or with `undefined`, clear) the host default for a setting. */
+  setSettingDefault(setting: OptionsSettingId, value: ViewerOptionPrimitive | undefined): void;
+  hideBackstagePage(page: BackstagePage): void;
+  showBackstagePage(page: BackstagePage): void;
+  hideBackstageCard(card: BackstageCardId): void;
+  showBackstageCard(card: BackstageCardId): void;
+  hideContextMenuCommand(command: ContextMenuCommandId): void;
+  showContextMenuCommand(command: ContextMenuCommandId): void;
+  hideCanvasContextMenuCommand(command: CanvasContextMenuCommandId): void;
+  showCanvasContextMenuCommand(command: CanvasContextMenuCommandId): void;
+  disableShortcut(action: EditorKeyActionName): void;
+  enableShortcut(action: EditorKeyActionName): void;
+  /** Move a command onto new chord(s); `undefined` restores the built-in chord. */
+  remapShortcut(action: EditorKeyActionName, chords: ShortcutChord | readonly ShortcutChord[] | undefined): void;
+  setPanelVisible(panel: ViewerPanelId, visible: boolean): void;
+  setFeatureEnabled(feature: ViewerFeatureId, enabled: boolean): void;
+  setDialogAvailable(dialog: ViewerDialogId, available: boolean): void;
 }
 type ReadOnlyRecommendationKind = 'modifyVerifier' | 'markedFinal' | null;
 interface ReadOnlyRecommendation {
@@ -13910,6 +14304,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/web-components/select-value.d.ts
 /** Public DOM shape used by all bindings; the element is not a native select. */
@@ -14103,7 +14524,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,
@@ -14159,7 +14580,7 @@ interface AccessibilityIssue {
   severity: 'error' | 'warning' | 'info';
   message: string;
 }
-interface PowerPointViewerHandle extends FileViewerHandle, PowerPointViewerAPI {
+interface PowerPointViewerHandle extends FileViewerHandle, PowerPointViewerAPI, ViewerCustomizationApi {
   getContent: () => Promise<Uint8Array>;
 }
 
@@ -14192,6 +14613,8 @@ interface ToolbarProps {
   tableEditorState?: TableCellEditorState | null;
   editTemplateMode: boolean;
   newShapeType: SupportedShapeType;
+  /** The armed Freeform: Shape / Curve tool, or null. */
+  activeFreeformTool?: FreeformToolKind | null;
   activeTool: DrawingTool;
   drawingColor: string;
   drawingWidth: number;
@@ -14225,6 +14648,8 @@ interface ToolbarProps {
   onRedo: () => void;
   onToggleFindReplace: () => void;
   onSetNewShapeType: (type: SupportedShapeType) => void;
+  /** Arm (or, with null, disarm) a Freeform: Shape / Curve tool. */
+  onArmFreeformTool?: (tool: FreeformToolKind | null) => void;
   onAddTextBox: () => void;
   onAddShape: () => void;
   onAddTable: () => void;
@@ -14725,6 +15150,8 @@ interface UseElementManipulationInput {
    * production, only in tests that do not exercise "Edit Text".
    */
   onEditText?: (elementId: string) => void;
+  /** Enter Edit Points mode on `elementId` (context menu "Edit Points"). */
+  onEditPoints?: (elementId: string) => void;
   /**
    * Rasterise `elementId`'s own DOM node and download it as PNG ("Save as
    * Picture"). Lives outside this hook because it needs the binding's
@@ -14792,6 +15219,8 @@ interface UseFindReplaceInput {
   onSetSelectedElementId: (id: string | null) => void;
   onUpdateSlides: (updater: (slides: PptxSlide[]) => PptxSlide[]) => void;
   onMarkDirty: () => void;
+  /** Host keyboard customisation (disabled / remapped Find shortcuts). */
+  keyboard?: ResolvedKeyboardCustomization;
 }
 interface UseFindReplaceResult {
   findReplaceOpen: boolean;
@@ -14809,7 +15238,7 @@ interface UseFindReplaceResult {
   handleReplace: () => void;
   handleReplaceAll: () => void;
 }
-declare function useFindReplace({ slides, mode, onSetActiveSlideIndex, onSetSelectedElementId, onUpdateSlides, onMarkDirty }: UseFindReplaceInput): UseFindReplaceResult;
+declare function useFindReplace({ slides, mode, onSetActiveSlideIndex, onSetSelectedElementId, onUpdateSlides, onMarkDirty, keyboard }: UseFindReplaceInput): UseFindReplaceResult;
 //#endregion
 //#region src/viewer/components/hyperlink-edit-types.d.ts
 /** The type of hyperlink target. */
@@ -15411,6 +15840,31 @@ interface ViewerDialogsResult {
 //#region src/viewer/hooks/useViewerDialogs.d.ts
 declare function useViewerDialogs(input: UseViewerDialogsInput): ViewerDialogsResult;
 //#endregion
+//#region src/viewer/hooks/useCropSessionState.d.ts
+interface CropSessionState {
+  /** The open crop session, or null outside crop mode. */
+  cropSession: CropSession | null;
+  /** Mirror of `cropSession`, readable synchronously by the history gate. */
+  cropSessionRef: React.MutableRefObject<CropSession | null>;
+  /** Open or close the session; keeps the ref and the state in step. */
+  setCropSession: (session: CropSession | null) => void;
+}
+//#endregion
+//#region src/viewer/hooks/useEditPointsState.d.ts
+/**
+ * Viewer state for the two outline-authoring modes: Edit Points on one shape,
+ * and the armed Freeform: Shape / Curve drawing tool. At most one is active;
+ * arming a tool ends Edit Points and starting Edit Points disarms the tool.
+ */
+interface EditPointsModeState {
+  /** The shape in Edit Points mode, or null. */
+  editPointsElementId: string | null;
+  setEditPointsElementId: (id: string | null) => void;
+  /** The armed click-to-place drawing tool, or null. */
+  activeFreeformTool: FreeformToolKind | null;
+  setActiveFreeformTool: (tool: FreeformToolKind | null) => void;
+}
+//#endregion
 //#region src/viewer/hooks/viewer-core-state-types.d.ts
 /**
  * Input parameters for the {@link useViewerCoreState} hook.
@@ -15429,7 +15883,7 @@ interface UseViewerCoreStateInput {
  * that comprises the core viewer state. It is merged with {@link ViewerUIState}
  * inside {@link useViewerState} to produce the unified {@link ViewerState}.
  */
-interface ViewerCoreState extends InlineEditingState {
+interface ViewerCoreState extends InlineEditingState, EditPointsModeState {
   /** Ref to the outermost container `<div>` wrapping the viewer. */
   containerRef: React$1.RefObject<HTMLDivElement | null>;
   /** Hidden `<input type="file">` used to trigger image file selection. */
@@ -15776,7 +16230,7 @@ interface UseViewerStateInput {
  * The unified viewer state: intersection of core state (slides, elements,
  * refs, presentation metadata) and UI state (panel toggles, tools, grid/snap).
  */
-type ViewerState = ViewerCoreState & ViewerUIState;
+type ViewerState = ViewerCoreState & ViewerUIState & CropSessionState;
 /**
  * Composes core and UI state into a single unified state object.
  *
@@ -15814,6 +16268,8 @@ interface UseEditorOperationsInput {
   handlerRef?: React$1.RefObject<PptxHandler | null> | React$1.MutableRefObject<PptxHandler | null>;
   /** AutoCorrect transform applied to committed inline text edits. */
   transformCommittedText?: (text: string) => string;
+  /** Host keyboard customisation, forwarded to the Find shortcut. */
+  keyboard?: ResolvedKeyboardCustomization;
 }
 interface EditorOperationsResult {
   ops: ElementOperations;
@@ -15864,6 +16320,23 @@ interface TableStyleContext {
   theme?: PptxTheme;
 }
 //#endregion
+//#region src/viewer/components/canvas/OutlineAuthoringLayer.d.ts
+/** Wiring for Edit Points and the Freeform: Shape / Curve tools. */
+interface OutlineAuthoringProps {
+  /** The shape in Edit Points mode, or null. */
+  editPointsElementId: string | null;
+  /** Edit Points menu commands the host hid. */
+  hiddenEditPointsCommands?: ReadonlySet<EditPointsCommandId>;
+  /** Apply one Edit Points edit (one undo step). */
+  onCommitEditPoints: (elementId: string, patch: EditPointsElementPatch) => void;
+  onExitEditPoints: () => void;
+  /** The armed drawing tool, or null. */
+  freeformTool: FreeformToolKind | null;
+  /** Insert a drawn freeform (the tool then disarms). */
+  onFreeformCommit: (element: ShapePptxElement) => void;
+  onFreeformCancel: () => void;
+}
+//#endregion
 //#region src/viewer/components/canvas/canvas-types.d.ts
 interface ZoomViewport {
   canvasViewportRef: React$1.RefObject<HTMLDivElement | null>;
@@ -16011,6 +16484,7 @@ interface SlideCanvasProps {
    * changes tween while the AI assistant is working (see AiFocusHighlightOverlay).
    */
   aiActive?: boolean;
+  outlineAuthoring?: OutlineAuthoringProps;
 }
 //#endregion
 //#region src/viewer/hooks/useAutosave.d.ts
@@ -17395,6 +17869,8 @@ interface UseKeyboardShortcutWiringInput {
   pasteFormatToSelection: (targetIds: string[]) => void;
   /** Ctrl/Cmd+Alt+V: open the Paste Special dialog. */
   onPasteSpecial: () => void;
+  /** Host UI customisation forwarded to `useKeyboardShortcuts`. */
+  customization?: ResolvedCustomization;
 }
 declare function useKeyboardShortcutWiring(input: UseKeyboardShortcutWiringInput): void;
 //#endregion
@@ -17474,6 +17950,10 @@ interface UseViewerIntegrationInput {
   onZoomChange: ((zoom: number) => void) | undefined;
   onSelectionChange: ((ids: string[]) => void) | undefined;
   onSlideCountChange: ((count: number) => void) | undefined;
+  /** Host UI customisation helpers, spread onto the imperative handle. */
+  customizationApi?: ViewerCustomizationApi;
+  /** Resolved host UI customisation, read by the keyboard shortcuts. */
+  customization?: ResolvedCustomization;
 }
 interface ViewerIntegrationResult {
   exportHandlers: IOHandlersResult['exportHandlers'];
@@ -17874,6 +18354,11 @@ interface UseKeyboardShortcutsInput {
   activeTool: DrawingTool;
   /** Whether at least one element is selected. */
   hasSelection: boolean;
+  /**
+   * Host UI customisation: disabled / remapped editor shortcuts, and the
+   * `presentMode` feature gate for F5 / Shift+F5. Omitted customises nothing.
+   */
+  customization?: ResolvedCustomization;
   /** The IDs of the currently selected elements (effective). */
   effectiveSelectedIds: string[];
   onDelete: () => void;
@@ -17946,6 +18431,7 @@ declare function useKeyboardShortcuts(input: UseKeyboardShortcutsInput): void;
 interface MergeShapesHandlerInput {
   activeSlide: PptxSlide | undefined;
   activeSlideIndex: number;
+  /** The selection in SELECTION order: the first entry's formatting survives. */
   selectedElements: PptxElement[];
   effectiveSelectedIds: string[];
   setSelectedElementIds: React.Dispatch<React.SetStateAction<string[]>>;