pptx-vanilla-viewer 3.8.0 → 3.9.0

package/dist/{transition-overlay-DB7RDVkV.d.ts → transition-overlay-D57AQXCk.d.ts}

@@ -2,7 +2,7 @@ import "fast-xml-parser";
 import "jszip";
 import { Doc } from "yjs";
 import "opentype.js";
-//#region ../core/dist/text-operations-CDPmF5Pl.d.ts
+//#region ../core/dist/text-operations-ClQyeifS.d.ts
 //#region src/core/types/actions.d.ts
 /**
  * Action types: hyperlinks, slide jumps, macros, and action buttons.
@@ -2017,6 +2017,16 @@ interface TextStyle {
   textReflectionEndOpacity?: number;
   /** Text reflection offset distance in px. */
   textReflectionOffset?: number;
+  /**
+   * Text reflection end position (`@endPos`) as a 0-1 fraction of the text
+   * height the fade reaches. Mirrors `ShapeStyle.reflectionEndPosition`.
+   */
+  textReflectionEndPosition?: number;
+  /**
+   * Text reflection offset direction (`@dir`) in degrees. Mirrors
+   * `ShapeStyle.reflectionDirection`.
+   */
+  textReflectionDirection?: number;
   /**
    * Text reflection fade direction (`a:rPr/a:effectLst/a:reflection/@fadeDir`)
    * in degrees. Mirrors `ShapeStyle.reflectionFadeDirection`.
@@ -2335,6 +2345,21 @@ interface TextSegment {
    * populated; unrelated fields fall back to the shape-level style.
    */
   paragraphProperties?: TextStyle;
+  /**
+   * The paragraph this segment starts authored an EMPTY `<a:pPr/>`. Only
+   * meaningful on the first segment of a paragraph. The writer re-emits the
+   * empty element when it has no paragraph property of its own to write, so
+   * a rewritten slide keeps the markup PowerPoint wrote.
+   */
+  emptyParagraphPropertiesAuthored?: boolean;
+  /**
+   * The paragraph this segment starts has no run content and authored no
+   * `a:endParaRPr` (a bare `<a:p/>`, possibly with an `a:pPr`). Only
+   * meaningful on the first segment of a paragraph. It stops the writer
+   * inventing an empty run or an `<a:endParaRPr lang="en-US"/>` stub for a
+   * paragraph that still has no content when saved.
+   */
+  bareParagraph?: boolean;
   /**
    * Phonetic annotation text from `a:ruby > a:rt` (e.g. furigana, pinyin).
    * When present, the renderer should wrap the base text with an HTML `<ruby>` tag.
@@ -7939,6 +7964,84 @@ interface PptxThemeOption {
   name?: string;
 }
 //#endregion
+//#region src/core/types/animation-behavior.d.ts
+/** Timing of one behaviour, from its own `p:cBhvr/p:cTn`. */
+interface PptxAnimationBehaviorTiming {
+  /** `p:cTn/@dur` in ms; absent when `indefinite` or unset. */
+  durationMs?: number;
+  /** Start offset in ms from `p:stCondLst/p:cond/@delay`, relative to the effect start. */
+  delayMs?: number;
+  /** `p:cTn/@accel` as a 0..1 fraction of the behaviour's duration. */
+  accel?: number;
+  /** `p:cTn/@decel` as a 0..1 fraction of the behaviour's duration. */
+  decel?: number;
+  /** `p:cTn/@autoRev`: play forward, then backward, doubling the active time. */
+  autoReverse?: boolean;
+  /** `p:cTn/@repeatCount` in plain iterations (OOXML stores thousandths). */
+  repeatCount?: number;
+  /** `p:cTn/@tmFilter`: the raw `"t,v; t,v; ..."` time remapping list. */
+  tmFilter?: string;
+}
+interface BehaviorBase {
+  /** Lower-cased `p:attrNameLst` entries, in document order. */
+  attrNames: string[];
+  /** `p:cBhvr/@additive` (`base`, `sum`, `repl`, `mult`, `none`). */
+  additive?: string;
+  timing: PptxAnimationBehaviorTiming;
+}
+/** `p:set`: a discrete value held from the behaviour's start. */
+interface PptxSetBehavior extends BehaviorBase {
+  kind: 'set';
+  value: string | number | boolean;
+}
+/** `p:anim`: a `p:tavLst` ramp or a `from`/`to`/`by` formula ramp. */
+interface PptxAnimBehavior extends BehaviorBase {
+  kind: 'anim';
+  calcMode?: 'discrete' | 'lin' | 'fmla';
+  valueType?: string;
+  from?: string;
+  to?: string;
+  by?: string;
+  keyframes: PptxAnimationKeyframe[];
+}
+/** `p:animEffect`: a filter transition (`fade`, `wipe(down)`...). */
+interface PptxAnimEffectBehavior extends BehaviorBase {
+  kind: 'animEffect';
+  filter?: string;
+  transition?: 'in' | 'out' | 'none';
+}
+/** A `p:animScale` factor pair (1 = unscaled) or a `p:animMotion` offset (slide fractions). */
+interface PptxBehaviorPoint {
+  x: number;
+  y: number;
+}
+/** `p:animScale`: scale factors as fractions (OOXML stores percent*1000, so `100000` = 1). */
+interface PptxAnimScaleBehavior extends BehaviorBase {
+  kind: 'animScale';
+  from?: PptxBehaviorPoint;
+  to?: PptxBehaviorPoint;
+  by?: PptxBehaviorPoint;
+  zoomContents?: boolean;
+}
+/** `p:animRot`: rotation in degrees (OOXML stores 60000ths). */
+interface PptxAnimRotBehavior extends BehaviorBase {
+  kind: 'animRot';
+  from?: number;
+  to?: number;
+  by?: number;
+}
+/** `p:animMotion`: a path (slide fractions) or a `from`/`to`/`by` offset. */
+interface PptxAnimMotionBehavior extends BehaviorBase {
+  kind: 'animMotion';
+  path?: string;
+  origin?: string;
+  from?: PptxBehaviorPoint;
+  to?: PptxBehaviorPoint;
+  by?: PptxBehaviorPoint;
+}
+/** One behaviour child of an effect, tagged by its OOXML element. */
+type PptxAnimationBehavior = PptxSetBehavior | PptxAnimBehavior | PptxAnimEffectBehavior | PptxAnimScaleBehavior | PptxAnimRotBehavior | PptxAnimMotionBehavior;
+//#endregion
 //#region src/core/types/animation.d.ts
 /**
  * Built-in animation preset names used for entrance, exit, and emphasis effects.
@@ -8490,6 +8593,14 @@ interface PptxNativeAnimation {
    * shared playback (round-trip/typed-model only so far).
    */
   setAnimations?: PptxSetAnimation[];
+  /**
+   * Every behaviour child of this effect (`p:set`, `p:anim`, `p:animEffect`,
+   * `p:animScale`, `p:animRot`, `p:animMotion`) with its own timing, as
+   * authored. The single-valued fields above flatten a composed preset;
+   * this keeps the whole tree so playback can follow what PowerPoint wrote
+   * (see `animation-behavior-player` in `pptx-viewer-shared`).
+   */
+  behaviors?: PptxAnimationBehavior[];
 }
 /**
  * One `p:set` discrete (non-interpolated) attribute assignment composed
@@ -10590,7 +10701,7 @@ interface PptxEmbeddedFont {
   originalPartBytes?: Uint8Array;
 }
 //#endregion
-//#region ../core/dist/index-Dzh1gMIm.d.ts
+//#region ../core/dist/index-DmVG5xJ8.d.ts
 //#region src/core/types/theme-presets.d.ts
 /**
  * A complete theme preset that can be applied to a presentation.
@@ -12106,7 +12217,7 @@ interface AccessibilityIssue {
 /** Supported merge shape operations (matching PowerPoint's Merge Shapes menu). */
 type MergeShapeOperation = 'union' | 'intersect' | 'subtract' | 'fragment' | 'combine';
 //#endregion
-//#region ../shared/dist/index-BbHsvey8.d.ts
+//#region ../shared/dist/index-DDHixrsQ.d.ts
 //#region src/theme/types.d.ts
 /**
  * Theme configuration types for the PowerPoint viewer.
@@ -13980,6 +14091,13 @@ type ToolbarButtonId = 'share' | 'broadcast' | 'export' | 'undo' | 'redo' | 'rec
 /** 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;
+/**
+ * PowerPoint's contextual tabs: they join the tab row only while the
+ * selection is of their kind (see `contextualTabsForElement` in
+ * `ribbon-galleries/`). Kept apart from `ToolbarTabId` because they are not
+ * part of the fixed tab order every binding renders.
+ */
+type RibbonContextualTabId = 'shapeFormat' | 'pictureFormat' | 'tableDesign' | 'chartDesign' | 'smartArtDesign';
 //#endregion
 //#region src/render/options/viewer-options.d.ts
 /**
@@ -14196,6 +14314,511 @@ type FreeformToolKind = 'freeformShape' | 'curve';
  */
 type ViewerOptionsTabId = 'general' | 'proofing' | 'save' | 'language' | 'accessibility' | 'advanced' | 'ribbon' | 'quickAccess' | 'addIns' | 'trust';
 //#endregion
+//#region src/render/customization/ribbon-control-catalog.d.ts
+declare const RIBBON_CONTROL_CATALOG: {
+  readonly home: {
+    readonly clipboard: {
+      readonly label: 'Clipboard';
+      readonly controls: {
+        readonly paste: 'Paste';
+        readonly cut: 'Cut';
+        readonly copy: 'Copy';
+        readonly formatPainter: 'Format Painter';
+      };
+    };
+    readonly slides: {
+      readonly label: 'Slides';
+      readonly controls: {
+        readonly newSlide: 'New Slide';
+        readonly layout: 'Layout';
+        readonly reset: 'Reset';
+        readonly section: 'Section';
+        readonly slideTemplates: 'Slide templates';
+      };
+    };
+    readonly font: {
+      readonly label: 'Font';
+      readonly controls: {
+        readonly fontFamily: 'Font';
+        readonly fontSize: 'Font Size';
+        readonly increaseFontSize: 'Increase Font Size';
+        readonly decreaseFontSize: 'Decrease Font Size';
+        readonly clearFormatting: 'Clear All Formatting';
+        readonly bold: 'Bold';
+        readonly italic: 'Italic';
+        readonly underline: 'Underline';
+        readonly strikethrough: 'Strikethrough';
+        readonly shadow: 'Text Shadow';
+        readonly characterSpacing: 'Character Spacing';
+        readonly changeCase: 'Change Case';
+        readonly fontColor: 'Font Color';
+        readonly highlightColor: 'Text Highlight Color';
+        readonly superscript: 'Superscript';
+        readonly subscript: 'Subscript';
+      };
+    };
+    readonly paragraph: {
+      readonly label: 'Paragraph';
+      readonly controls: {
+        readonly bullets: 'Bullets (toggle and gallery)';
+        readonly numbering: 'Numbering (toggle and gallery)';
+        readonly decreaseIndent: 'Decrease List Level';
+        readonly increaseIndent: 'Increase List Level';
+        readonly lineSpacing: 'Line Spacing';
+        readonly alignLeft: 'Align Left';
+        readonly alignCenter: 'Center';
+        readonly alignRight: 'Align Right';
+        readonly justify: 'Justify';
+        readonly columns: 'Columns';
+        readonly textDirection: 'Text Direction';
+        readonly alignText: 'Align Text';
+      };
+    };
+    readonly drawing: {
+      readonly label: 'Drawing';
+      readonly controls: {
+        readonly shapes: 'Shapes';
+        readonly arrange: 'Arrange';
+        readonly quickStyles: 'Quick Styles (Shape Styles gallery)';
+        readonly shapeFill: 'Shape Fill';
+        readonly shapeOutline: 'Shape Outline';
+        readonly shapeEffects: 'Shape Effects gallery';
+      };
+    };
+    readonly arrange: {
+      readonly label: 'Arrange';
+      readonly controls: {
+        readonly bringForward: 'Bring Forward';
+        readonly sendBackward: 'Send Backward';
+        readonly bringToFront: 'Bring to Front';
+        readonly sendToBack: 'Send to Back';
+        readonly flipHorizontal: 'Flip Horizontal';
+        readonly flipVertical: 'Flip Vertical';
+        readonly duplicate: 'Duplicate';
+        readonly delete: 'Delete';
+        readonly group: 'Group';
+        readonly ungroup: 'Ungroup';
+        readonly align: 'Align';
+        readonly mergeShapes: 'Merge Shapes';
+        readonly crop: 'Crop';
+        readonly outlineWidth: 'Outline width';
+      };
+    };
+    readonly editing: {
+      readonly label: 'Editing';
+      readonly controls: {
+        readonly find: 'Find';
+        readonly replace: 'Replace';
+        readonly select: 'Select';
+      };
+    };
+  };
+  readonly insert: {
+    readonly slides: {
+      readonly label: 'Slides';
+      readonly controls: {
+        readonly newSlide: 'New Slide';
+      };
+    };
+    readonly tables: {
+      readonly label: 'Tables';
+      readonly controls: {
+        readonly table: 'Table';
+      };
+    };
+    readonly images: {
+      readonly label: 'Images';
+      readonly controls: {
+        readonly pictures: 'Pictures';
+      };
+    };
+    readonly illustrations: {
+      readonly label: 'Illustrations';
+      readonly controls: {
+        readonly shapes: 'Shapes';
+        readonly smartArt: 'SmartArt';
+        readonly chart: 'Chart';
+      };
+    };
+    readonly links: {
+      readonly label: 'Links';
+      readonly controls: {
+        readonly link: 'Link';
+        readonly action: 'Action button';
+      };
+    };
+    readonly comments: {
+      readonly label: 'Comments';
+      readonly controls: {
+        readonly comment: 'Comment';
+      };
+    };
+    readonly text: {
+      readonly label: 'Text';
+      readonly controls: {
+        readonly textBox: 'Text Box';
+        readonly field: 'Header, date, slide number field';
+      };
+    };
+    readonly symbols: {
+      readonly label: 'Symbols';
+      readonly controls: {
+        readonly equation: 'Equation';
+        readonly symbol: 'Symbol';
+      };
+    };
+    readonly media: {
+      readonly label: 'Media';
+      readonly controls: {
+        readonly media: 'Video / Audio';
+      };
+    };
+  };
+  readonly draw: {
+    readonly tools: {
+      readonly label: 'Drawing Tools';
+      readonly controls: {
+        readonly select: 'Select';
+        readonly pen: 'Pen';
+        readonly highlighter: 'Highlighter';
+        readonly eraser: 'Eraser';
+        readonly penColor: 'Pen colour';
+        readonly penWidth: 'Pen width';
+      };
+    };
+    readonly convert: {
+      readonly label: 'Convert';
+      readonly controls: {
+        readonly inkToShape: 'Ink to Shape';
+      };
+    };
+  };
+  readonly design: {
+    readonly themes: {
+      readonly label: 'Themes';
+      readonly controls: {
+        readonly browseThemes: 'Themes gallery';
+        readonly editTheme: 'Edit theme';
+      };
+    };
+    readonly variants: {
+      readonly label: 'Variants';
+      readonly controls: {
+        readonly colors: 'Variants: Colors gallery';
+        readonly fonts: 'Variants: Fonts gallery';
+      };
+    };
+    readonly customize: {
+      readonly label: 'Customize';
+      readonly controls: {
+        readonly slideSize: 'Slide Size';
+        readonly formatBackground: 'Format Background';
+      };
+    };
+  };
+  readonly transitions: {
+    readonly preview: {
+      readonly label: 'Preview';
+      readonly controls: {
+        readonly preview: 'Preview';
+      };
+    };
+    readonly transitionToThisSlide: {
+      readonly label: 'Transition to This Slide';
+      readonly controls: {
+        readonly gallery: 'Transition gallery';
+        readonly effectOptions: 'Effect Options';
+      };
+    };
+    readonly timing: {
+      readonly label: 'Timing';
+      readonly controls: {
+        readonly sound: 'Sound';
+        readonly duration: 'Duration';
+        readonly applyToAll: 'Apply To All';
+        readonly advanceOnClick: 'On Mouse Click';
+        readonly advanceAfter: 'After';
+      };
+    };
+  };
+  readonly animations: {
+    readonly preview: {
+      readonly label: 'Preview';
+      readonly controls: {
+        readonly preview: 'Preview';
+      };
+    };
+    readonly animation: {
+      readonly label: 'Animation';
+      readonly controls: {
+        readonly gallery: 'Animation gallery';
+        readonly effectOptions: 'Effect Options';
+      };
+    };
+    readonly motionPath: {
+      readonly label: 'Motion Paths';
+      readonly controls: {
+        readonly gallery: 'Motion path gallery';
+      };
+    };
+    readonly advancedAnimation: {
+      readonly label: 'Advanced Animation';
+      readonly controls: {
+        readonly addAnimation: 'Add Animation';
+        readonly animationPane: 'Animation Pane';
+        readonly trigger: 'Trigger';
+        readonly animationPainter: 'Animation Painter';
+        readonly remove: 'Remove animation';
+      };
+    };
+    readonly timing: {
+      readonly label: 'Timing';
+      readonly controls: {
+        readonly start: 'Start';
+        readonly duration: 'Duration';
+        readonly delay: 'Delay';
+        readonly reorder: 'Reorder';
+      };
+    };
+  };
+  readonly slideShow: {
+    readonly startSlideShow: {
+      readonly label: 'Start Slide Show';
+      readonly controls: {
+        readonly fromBeginning: 'From Beginning';
+        readonly fromCurrent: 'From Current Slide';
+        readonly customShow: 'Custom Slide Show';
+      };
+    };
+    readonly present: {
+      readonly label: 'Present';
+      readonly controls: {
+        readonly presenterView: 'Presenter View';
+        readonly broadcast: 'Present Online';
+      };
+    };
+    readonly setUp: {
+      readonly label: 'Set Up';
+      readonly controls: {
+        readonly setUpSlideShow: 'Set Up Slide Show';
+        readonly hideSlide: 'Hide Slide';
+        readonly rehearseTimings: 'Rehearse Timings';
+        readonly record: 'Record';
+        readonly rehearseWithCoach: 'Rehearse with Coach';
+      };
+    };
+    readonly captions: {
+      readonly label: 'Captions & Subtitles';
+      readonly controls: {
+        readonly subtitles: 'Always Use Subtitles';
+        readonly subtitleSettings: 'Subtitle Settings';
+      };
+    };
+  };
+  readonly record: {
+    readonly camera: {
+      readonly label: 'Camera';
+      readonly controls: {
+        readonly cameo: 'Cameo';
+      };
+    };
+    readonly record: {
+      readonly label: 'Record';
+      readonly controls: {
+        readonly fromBeginning: 'From Beginning';
+        readonly fromCurrent: 'From Current Slide';
+      };
+    };
+    readonly manage: {
+      readonly label: 'Manage';
+      readonly controls: {
+        readonly clear: 'Clear';
+        readonly reset: 'Reset to Cameo';
+      };
+    };
+    readonly help: {
+      readonly label: 'Help';
+      readonly controls: {
+        readonly learnMore: 'Learn more';
+      };
+    };
+  };
+  readonly review: {
+    readonly proofing: {
+      readonly label: 'Proofing';
+      readonly controls: {
+        readonly spelling: 'Spelling';
+        readonly thesaurus: 'Thesaurus';
+      };
+    };
+    readonly accessibility: {
+      readonly label: 'Accessibility';
+      readonly controls: {
+        readonly check: 'Check Accessibility';
+      };
+    };
+    readonly language: {
+      readonly label: 'Language';
+      readonly controls: {
+        readonly translate: 'Translate';
+      };
+    };
+    readonly comments: {
+      readonly label: 'Comments';
+      readonly controls: {
+        readonly newComment: 'New Comment';
+        readonly delete: 'Delete';
+        readonly previous: 'Previous';
+        readonly next: 'Next';
+        readonly showComments: 'Show Comments';
+      };
+    };
+    readonly compare: {
+      readonly label: 'Compare';
+      readonly controls: {
+        readonly compare: 'Compare';
+        readonly markAllRead: 'Mark all read';
+      };
+    };
+    readonly protect: {
+      readonly label: 'Protect';
+      readonly controls: {
+        readonly readOnly: 'Read-only';
+        readonly restrictPermission: 'Restrict Permission';
+      };
+    };
+    readonly ink: {
+      readonly label: 'Ink';
+      readonly controls: {
+        readonly hideInk: 'Hide Ink';
+      };
+    };
+  };
+  readonly view: {
+    readonly presentationViews: {
+      readonly label: 'Presentation Views';
+      readonly controls: {
+        readonly normal: 'Normal';
+        readonly outline: 'Outline View';
+        readonly slideSorter: 'Slide Sorter';
+        readonly notesPage: 'Notes Page';
+        readonly readingView: 'Reading View';
+      };
+    };
+    readonly masterViews: {
+      readonly label: 'Master Views';
+      readonly controls: {
+        readonly slideMaster: 'Slide Master';
+        readonly handoutMaster: 'Handout Master';
+        readonly notesMaster: 'Notes Master';
+      };
+    };
+    readonly show: {
+      readonly label: 'Show';
+      readonly controls: {
+        readonly ruler: 'Ruler';
+        readonly gridlines: 'Gridlines';
+        readonly guides: 'Guides';
+        readonly snapToGrid: 'Snap to Grid';
+        readonly snapToShape: 'Snap to Shape';
+        readonly addGuide: 'Add horizontal / vertical guide';
+        readonly selectionPane: 'Selection Pane';
+        readonly eyedropper: 'Eyedropper';
+        readonly notes: 'Notes';
+      };
+    };
+    readonly zoom: {
+      readonly label: 'Zoom';
+      readonly controls: {
+        readonly zoom: 'Zoom';
+        readonly fitToWindow: 'Fit to Window';
+      };
+    };
+    readonly window: {
+      readonly label: 'Window';
+      readonly controls: {
+        readonly templateEditing: 'Edit template elements';
+        readonly macros: 'Macros';
+      };
+    };
+  };
+  readonly help: {
+    readonly help: {
+      readonly label: 'Help';
+      readonly controls: {
+        readonly options: 'Options';
+        readonly keyboardShortcuts: 'Keyboard shortcuts';
+        readonly accessibility: 'Accessibility checker';
+      };
+    };
+  };
+  readonly shapeFormat: {
+    readonly shapeStyles: {
+      readonly label: 'Shape Styles';
+      readonly controls: {
+        readonly gallery: 'Shape Styles gallery';
+        readonly shapeEffects: 'Shape Effects gallery';
+      };
+    };
+    readonly wordArtStyles: {
+      readonly label: 'WordArt Styles';
+      readonly controls: {
+        readonly gallery: 'WordArt Styles gallery';
+      };
+    };
+  };
+  readonly pictureFormat: {
+    readonly pictureStyles: {
+      readonly label: 'Picture Styles';
+      readonly controls: {
+        readonly gallery: 'Picture Styles gallery';
+        readonly pictureEffects: 'Picture Effects gallery';
+      };
+    };
+  };
+  readonly tableDesign: {
+    readonly tableStyles: {
+      readonly label: 'Table Styles';
+      readonly controls: {
+        readonly gallery: 'Table Styles gallery';
+      };
+    };
+  };
+  readonly chartDesign: {
+    readonly chartLayouts: {
+      readonly label: 'Chart Layouts';
+      readonly controls: {
+        readonly quickLayout: 'Quick Layout gallery';
+      };
+    };
+    readonly chartStyles: {
+      readonly label: 'Chart Styles';
+      readonly controls: {
+        readonly changeColors: 'Change Colors gallery';
+        readonly gallery: 'Chart Styles gallery';
+      };
+    };
+  };
+  readonly smartArtDesign: {
+    readonly smartArtStyles: {
+      readonly label: 'SmartArt Styles';
+      readonly controls: {
+        readonly changeColors: 'Change Colors gallery';
+        readonly gallery: 'SmartArt Styles gallery';
+      };
+    };
+  };
+};
+//#endregion
+//#region src/render/customization/ribbon-control-ids.d.ts
+type Catalog = typeof RIBBON_CONTROL_CATALOG;
+/** `<tab>.<group>`, for example `home.font`. */
+type RibbonGroupId = { [T in keyof Catalog]: { [G in keyof Catalog[T]]: `${T & string}.${G & string}`; }[keyof Catalog[T]]; }[keyof Catalog];
+/** `<tab>.<group>.<control>`, for example `home.font.bold`. */
+type RibbonControlId = { [T in keyof Catalog]: { [G in keyof Catalog[T]]: Catalog[T][G] extends {
+  controls: infer C;
+} ? `${T & string}.${G & string}.${keyof C & string}` : never; }[keyof Catalog[T]]; }[keyof Catalog];
+//#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;
@@ -14220,10 +14843,20 @@ type OptionsSectionId = `${ViewerOptionsTabId}.${string}`;
 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[];
+  /**
+   * Ribbon tabs to remove (the File tab included, unlike Customize Ribbon),
+   * and contextual tabs (`shapeFormat`, `pictureFormat`, ...) that should
+   * never appear.
+   */
+  hiddenTabs?: readonly (ToolbarTabId | RibbonContextualTabId)[];
+  /** Groups inside a tab to remove, as `<tab>.<group>` (`home.font`). */
+  hiddenGroups?: readonly RibbonGroupId[];
+  /**
+   * Controls to remove: a top-level toolbar button / control cluster
+   * (`share`, `zoom`, ...) or any ribbon control as
+   * `<tab>.<group>.<control>` (`home.font.bold`).
+   */
+  hiddenButtons?: readonly (ToolbarButtonId | RibbonControlId)[];
 }
 /** File > Options (the Settings dialog) customisation. */
 interface OptionsCustomization {
@@ -14422,6 +15055,12 @@ interface ResolvedKeyboardCustomization {
 /** The normalised, set-based view of a customisation. Treat as immutable. */
 interface ResolvedCustomization {
   hiddenActions: ReadonlySet<ToolbarActionId>;
+  /** Contextual tabs (`shapeFormat`, ...) the host never wants shown. */
+  hiddenContextualTabs: ReadonlySet<RibbonContextualTabId>;
+  /** Catalogued ribbon groups to hide (`ribbon.hiddenGroups`). */
+  hiddenRibbonGroups: ReadonlySet<RibbonGroupId>;
+  /** Catalogued ribbon controls to hide (the `<tab>.<group>.<control>` part of `ribbon.hiddenButtons`). */
+  hiddenRibbonControls: ReadonlySet<RibbonControlId>;
   hiddenOptionsPages: ReadonlySet<OptionsPageId>;
   hiddenOptionsSections: ReadonlySet<OptionsSectionId>;
   hiddenSettings: ReadonlySet<OptionsSettingId>;
@@ -14452,10 +15091,18 @@ interface ViewerCustomizationApi {
   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;
+  /** Hide a fixed tab, or stop a contextual tab (`shapeFormat`, ...) from appearing. */
+  hideRibbonTab(tab: ToolbarTabId | RibbonContextualTabId): void;
+  showRibbonTab(tab: ToolbarTabId | RibbonContextualTabId): void;
+  /** Hide a group inside a tab (`home.font`). */
+  hideRibbonGroup(group: RibbonGroupId): void;
+  showRibbonGroup(group: RibbonGroupId): void;
+  /** Hide a top-level toolbar button or any ribbon control (`home.font.bold`). */
+  hideToolbarButton(button: ToolbarButtonId | RibbonControlId): void;
+  showToolbarButton(button: ToolbarButtonId | RibbonControlId): void;
+  /** Alias of `hideToolbarButton` for a ribbon control id. */
+  hideRibbonControl(control: RibbonControlId): void;
+  showRibbonControl(control: RibbonControlId): void;
   hideOptionsPage(page: OptionsPageId): void;
   showOptionsPage(page: OptionsPageId): void;
   hideOptionsSection(section: OptionsSectionId): void;
@@ -14491,6 +15138,39 @@ interface ViewerCustomizationController {
   /** Subscribe to every change; returns the unsubscribe function. */
   subscribe(listener: () => void): () => void;
 }
+/**
+ * What a gallery needs to know about the deck and the selection. Bindings
+ * build it once per render from state they already hold.
+ */
+interface RibbonGalleryContext {
+  /** The primary selected element, or null. */
+  element: PptxElement | null;
+  /** `PptxData.themeColorMap`: scheme key -> hex. */
+  themeColorMap?: Readonly<Record<string, string>>;
+  /** `PptxData.theme`. */
+  theme?: PptxTheme;
+  /**
+   * The handler's `resolveStyleMatrixReferences`, bound. Shape Styles use it
+   * to resolve `<p:style>` exactly as the load path does; without it they
+   * fall back to an approximation from `themeColorMap`.
+   */
+  resolveStyleMatrix?: (styleXml: XmlObject) => ResolvedStyleMatrix;
+}
+/** What a pick asks the binding to do. */
+type RibbonGalleryApplyResult = {
+  kind: 'element';
+  elementId: string;
+  /** Merge onto the element with the binding's normal update + history path. */
+  patch: Partial<PptxElement>;
+} | {
+  kind: 'themeColorScheme';
+  colorScheme: PptxThemeColorScheme;
+  name: string;
+} | {
+  kind: 'themeFontScheme';
+  fontScheme: PptxThemeFontScheme;
+  name: string;
+};
 //#endregion
 //#region src/render/inline-text-commit.d.ts
 /**
@@ -14674,5 +15354,5 @@ interface TransitionOverlayParams {
  */
 declare function playTransitionOverlay(params: TransitionOverlayParams): () => void;
 //#endregion
-export { KeyboardCustomization as $, AccessibilityIssue as $n, PptxThemeFontScheme as $r, VIEWER_DIALOG_IDS as $t, CssStyleMap as A, loadPresentationDeck as An, PptxElementAnimation as Ar, RibbonCustomization as At, ElementUpdateOptions as B, resolveTransitionDurationMs as Bn, PptxSection as Br, ShareDefaults as Bt, CollaborationTransport as C, forgetSessionDeck as Cn, PptxCommentMention as Cr, RANDOM_ELIGIBLE_TYPES as Ct, ContextMenuCustomization as D, getSlideTransitionAnimations as Dn, PptxCustomShow as Dr, ResolvedCustomization as Dt, ContextMenuCommandId as E, getSessionTabId as En, PptxCustomProperty as Er, RemoteCursor as Et, ELEMENT_CONTEXT_MENU_COMMAND_IDS as F, rememberSessionDeck as Fn, PptxLayoutPreview as Fr, SLIDE_TRANSITION_KEYFRAMES_CSS as Ft, FreeformToolKind as G, ViewerTheme as Gn, PptxSmartArtNodeStyle as Gr, SlideTransitionAnimations as Gt, ExternalCollaborationSession as H, restoreSessionDeck as Hn, PptxSlideMaster as Hr, SlideSizeEmu as Ht, EditorKeyActionName as I, resolveDirection as In, PptxModernCommentAuthor as Ir, SanitizedPresence as It, INSTANT as J, defaultRadius as Jn, PptxTagCollection as Jr, TRANSITION_SPEED_DURATION_MS as Jt, GradientState as K, ViewerThemeColors as Kn, PptxTableCellStyle as Kr, StrokeToInkElementOpts as Kt, ElementAnimationState as L, resolveDirection8 as Ln, PptxModifyVerifier as Lr, SavedPresentationFormat as Lt, DEFAULT_TRANSITION_DURATION_MS as M, overlayInlineTextSnapshot as Mn, PptxHandoutMaster as Mr, RulerUnit as Mt, EASE as N, parsePresentationSessionId as Nn, PptxHeaderFooter as Nr, RunProgramNotice as Nt, CropElementUpdate as O, isLegacyBinaryPresentation as On, PptxData as Or, ResolvedDirection as Ot, EDITOR_SHORTCUT_ACTION_IDS as P, presentationBaseName as Pn, PptxImageEffects as Pr, SLIDE_TRANSITION_KEYFRAMES as Pt, InsertChartKind as Q, vermilionLightTheme as Qn, PptxThemeColorScheme as Qr, ToolbarTabId as Qt, ElementClipboardPayload as R, resolveOrientation as Rn, PptxNotesMaster as Rr, SessionDeck as Rt, CollaborationShellState as S, describeCollaborationShellState as Sn, PptxCommentAuthor as Sr, PrintSettings as St, ConnectionStatus as T, getP14TransitionAnimations as Tn, PptxCoreProperties as Tr, ReadOnlyRecommendation as Tt, ExternalCollaborationSnapshot as U, savedPresentationFileName as Un, PptxSlideTransition as Ur, SlideSizeRescaleMode as Ut, ExternalCollaborationAwareness as V, resolveWheelSpokeCount as Vn, PptxSlide as Vr, ShortcutChord as Vt, FieldSubstitutionContext as W, ThemeCatalogEntry as Wn, PptxSmartArtData as Wr, SlideTemplateId as Wt, InlineTextEditSnapshot as X, themeToCssVars as Xn, PptxTheme as Xr, ToolbarActionId as Xt, InlineListReadResult as Y, defaultThemeColors as Yn, PptxTextStyleLevels as Yr, TextAdvancedChanges as Yt, InlineTextSelection as Z, vermilionDarkTheme as Zn, PptxThemeColorRef as Zr, ToolbarButtonId as Zt, ChartPartRef as _, WHEEL_SPOKE_COUNTS as _n, PptxAnimationTimingCurve as _r, PasteSpecialFormat as _t, AnimationGroup as a, SmartArtLayout as ai, ViewerCustomizationController as an, ElementAction as ar, OPTIONS_SECTION_IDS as at, CollaborationLivePatcher as b, canInteractWithElement as bn, PptxChartData as br, PresentationPointerTool as bt, BACKSTAGE_PAGE_IDS as c, TextSegment as ci, ViewerFeatureId as cn, OleObjectType as cr, OptionsPageId as ct, BackstagePage as d, ViewerOptionPrimitive as dn, PptxAfterAnimationAction as dr, OptionsSettingValues as dt, PptxThemeOption as ei, VIEWER_EXPORT_FORMAT_IDS as en, MergeShapeOperation as er, MasterViewCrudAction as et, CANVAS_CONTEXT_MENU_COMMAND_IDS as f, ViewerOptionsStore as fn, PptxAnimationDirection as fr, P14_TRANSITION_KEYFRAMES as ft, ChangeCaseMode as g, ViewportFitPadding as gn, PptxAnimationTimelineAnchor as gr, PRESENTATION_OPEN_EXTENSIONS as gt, CanvasSize as h, ViewportFitOptions as hn, PptxAnimationSequence as hr, PPTX_OPEN_ACCEPT as ht, AlignEdge as i, SmartArtColorScheme as ii, ViewerCustomizationApi as in, SvgExportOptions as ir, OPTIONS_PAGE_IDS as it, DEFAULT_MORPH_DURATION_MS as j, loadSessionDeck as jn, PptxEmbeddedFont as jr, RibbonTransitionDraft as jt, CropSession as k, isSupportedPresentationFile as kn, PptxElement as kr, ResolvedDirection8 as kt, BackstageCardId as l, TextStyle as li, ViewerFontSource as ln, OlePptxElement as lr, OptionsSectionId as lt, CanvasContextMenuCommandId as m, ViewerQuickAccessOptions as mn, PptxAnimationRepeatMode as mr, P14_TRANSITION_KEYFRAMES_ALL as mt, playTransitionOverlay as n, PptxViewProperties as ni, VIEWER_PANEL_IDS as nn, PptxHandlerSaveOptions as nr, MobileSheetKey as nt, AutosaveRecord as o, SmartArtLayoutType as oi, ViewerDialogId as on, MasterViewTab as or, OPTIONS_SETTING_IDS as ot, CINEMATIC_TRANSITION_KEYFRAMES as p, ViewerPanelId as pn, PptxAnimationPreset as pr, P14_TRANSITION_KEYFRAMES_2 as pt, Guide as q, defaultCssVars as qn, PptxTableData as qr, TOOLBAR_BUTTON_IDS as qt, AccountAuthConfig as r, ShapeStyle as ri, ViewerCustomization as rn, PptxSaveFormat as rr, ModifyPasswordCheckResult as rt, BACKSTAGE_CARD_IDS as s, TablePptxElement as si, ViewerExportFormatId as sn, MediaPptxElement as sr, OptionsCustomization as st, TransitionOverlayParams as t, PptxTransitionType as ti, VIEWER_FEATURE_IDS as tn, PptxHandler as tr, MasterViewCrudActionId as tt, BackstageCustomization as u, XmlObject as ui, ViewerMode as un, ParsedTableStyleMap as ur, OptionsSettingId as ut, CollabLoadOrigin as v, ZoomNavigationTarget as vn, PptxAnimationTrigger as vr, PowerPointViewerAPI as vt, CompatibilityWarningToast as w, getCinematicTransitionAnimations as wn, PptxCompatibilityWarning as wr, RIBBON_TAB_IDS as wt, CollaborationRole as x, createImageElementFromFile as xn, PptxComment as xr, PresentationSnapshot as xt, CollaborationConfig as y, buildInlineTextCommitPatch as yn, PptxAppProperties as yr, PresentationBlackout as yt, ElementUpdate as z, resolveSlideTransition as zn, PptxPresentationProperties as zr, ShapePresetType as zt };
-//# sourceMappingURL=transition-overlay-DB7RDVkV.d.ts.map
+export { KeyboardCustomization as $, defaultRadius as $n, PptxTagCollection as $r, TRANSITION_SPEED_DURATION_MS as $t, CssStyleMap as A, getP14TransitionAnimations as An, PptxCoreProperties as Ar, RibbonContextualTabId as At, ElementUpdateOptions as B, rememberSessionDeck as Bn, PptxLayoutPreview as Br, SLIDE_TRANSITION_KEYFRAMES_CSS as Bt, CollaborationTransport as C, ZoomNavigationTarget as Cn, PptxAnimationTrigger as Cr, RANDOM_ELIGIBLE_TYPES as Ct, ContextMenuCustomization as D, describeCollaborationShellState as Dn, PptxCommentAuthor as Dr, ResolvedCustomization as Dt, ContextMenuCommandId as E, createImageElementFromFile as En, PptxComment as Er, RemoteCursor as Et, ELEMENT_CONTEXT_MENU_COMMAND_IDS as F, loadPresentationDeck as Fn, PptxElementAnimation as Fr, RibbonGroupId as Ft, FreeformToolKind as G, resolveTransitionDurationMs as Gn, PptxSection as Gr, ShareDefaults as Gt, ExternalCollaborationSession as H, resolveDirection8 as Hn, PptxModifyVerifier as Hr, SavedPresentationFormat as Ht, EditorKeyActionName as I, loadSessionDeck as In, PptxEmbeddedFont as Ir, RibbonTransitionDraft as It, INSTANT as J, savedPresentationFileName as Jn, PptxSlideTransition as Jr, SlideSizeRescaleMode as Jt, GradientState as K, resolveWheelSpokeCount as Kn, PptxSlide as Kr, ShortcutChord as Kt, ElementAnimationState as L, overlayInlineTextSnapshot as Ln, PptxHandoutMaster as Lr, RulerUnit as Lt, DEFAULT_TRANSITION_DURATION_MS as M, getSlideTransitionAnimations as Mn, PptxCustomShow as Mr, RibbonCustomization as Mt, EASE as N, isLegacyBinaryPresentation as Nn, PptxData as Nr, RibbonGalleryApplyResult as Nt, CropElementUpdate as O, forgetSessionDeck as On, PptxCommentMention as Or, ResolvedDirection as Ot, EDITOR_SHORTCUT_ACTION_IDS as P, isSupportedPresentationFile as Pn, PptxElement as Pr, RibbonGalleryContext as Pt, InsertChartKind as Q, defaultCssVars as Qn, PptxTableData as Qr, TOOLBAR_BUTTON_IDS as Qt, ElementClipboardPayload as R, parsePresentationSessionId as Rn, PptxHeaderFooter as Rr, RunProgramNotice as Rt, CollaborationShellState as S, WHEEL_SPOKE_COUNTS as Sn, PptxAnimationTimingCurve as Sr, PrintSettings as St, ConnectionStatus as T, canInteractWithElement as Tn, PptxChartData as Tr, ReadOnlyRecommendation as Tt, ExternalCollaborationSnapshot as U, resolveOrientation as Un, PptxNotesMaster as Ur, SessionDeck as Ut, ExternalCollaborationAwareness as V, resolveDirection as Vn, PptxModernCommentAuthor as Vr, SanitizedPresence as Vt, FieldSubstitutionContext as W, resolveSlideTransition as Wn, PptxPresentationProperties as Wr, ShapePresetType as Wt, InlineTextEditSnapshot as X, ViewerTheme as Xn, PptxSmartArtNodeStyle as Xr, SlideTransitionAnimations as Xt, InlineListReadResult as Y, ThemeCatalogEntry as Yn, PptxSmartArtData as Yr, SlideTemplateId as Yt, InlineTextSelection as Z, ViewerThemeColors as Zn, PptxTableCellStyle as Zr, StrokeToInkElementOpts as Zt, ChartPartRef as _, ViewerOptionsStore as _n, PptxAnimationDirection as _r, PasteSpecialFormat as _t, AnimationGroup as a, PptxThemeOption as ai, VIEWER_EXPORT_FORMAT_IDS as an, MergeShapeOperation as ar, OPTIONS_SECTION_IDS as at, CollaborationLivePatcher as b, ViewportFitOptions as bn, PptxAnimationSequence as br, PresentationPointerTool as bt, BACKSTAGE_PAGE_IDS as c, ShapeStyle as ci, ViewerCustomization as cn, PptxSaveFormat as cr, OptionsPageId as ct, BackstagePage as d, SmartArtLayoutType as di, ViewerDialogId as dn, MasterViewTab as dr, OptionsSettingValues as dt, PptxTextStyleLevels as ei, TextAdvancedChanges as en, defaultThemeColors as er, MasterViewCrudAction as et, CANVAS_CONTEXT_MENU_COMMAND_IDS as f, TablePptxElement as fi, ViewerExportFormatId as fn, MediaPptxElement as fr, P14_TRANSITION_KEYFRAMES as ft, ChangeCaseMode as g, ViewerOptionPrimitive as gn, PptxAfterAnimationAction as gr, PRESENTATION_OPEN_EXTENSIONS as gt, CanvasSize as h, XmlObject as hi, ViewerMode as hn, ParsedTableStyleMap as hr, PPTX_OPEN_ACCEPT as ht, AlignEdge as i, PptxThemeFontScheme as ii, VIEWER_DIALOG_IDS as in, AccessibilityIssue as ir, OPTIONS_PAGE_IDS as it, DEFAULT_MORPH_DURATION_MS as j, getSessionTabId as jn, PptxCustomProperty as jr, RibbonControlId as jt, CropSession as k, getCinematicTransitionAnimations as kn, PptxCompatibilityWarning as kr, ResolvedDirection8 as kt, BackstageCardId as l, SmartArtColorScheme as li, ViewerCustomizationApi as ln, SvgExportOptions as lr, OptionsSectionId as lt, CanvasContextMenuCommandId as m, TextStyle as mi, ViewerFontSource as mn, OlePptxElement as mr, P14_TRANSITION_KEYFRAMES_ALL as mt, playTransitionOverlay as n, PptxThemeColorRef as ni, ToolbarButtonId as nn, vermilionDarkTheme as nr, MobileSheetKey as nt, AutosaveRecord as o, PptxTransitionType as oi, VIEWER_FEATURE_IDS as on, PptxHandler as or, OPTIONS_SETTING_IDS as ot, CINEMATIC_TRANSITION_KEYFRAMES as p, TextSegment as pi, ViewerFeatureId as pn, OleObjectType as pr, P14_TRANSITION_KEYFRAMES_2 as pt, Guide as q, restoreSessionDeck as qn, PptxSlideMaster as qr, SlideSizeEmu as qt, AccountAuthConfig as r, PptxThemeColorScheme as ri, ToolbarTabId as rn, vermilionLightTheme as rr, ModifyPasswordCheckResult as rt, BACKSTAGE_CARD_IDS as s, PptxViewProperties as si, VIEWER_PANEL_IDS as sn, PptxHandlerSaveOptions as sr, OptionsCustomization as st, TransitionOverlayParams as t, PptxTheme as ti, ToolbarActionId as tn, themeToCssVars as tr, MasterViewCrudActionId as tt, BackstageCustomization as u, SmartArtLayout as ui, ViewerCustomizationController as un, ElementAction as ur, OptionsSettingId as ut, CollabLoadOrigin as v, ViewerPanelId as vn, PptxAnimationPreset as vr, PowerPointViewerAPI as vt, CompatibilityWarningToast as w, buildInlineTextCommitPatch as wn, PptxAppProperties as wr, RIBBON_TAB_IDS as wt, CollaborationRole as x, ViewportFitPadding as xn, PptxAnimationTimelineAnchor as xr, PresentationSnapshot as xt, CollaborationConfig as y, ViewerQuickAccessOptions as yn, PptxAnimationRepeatMode as yr, PresentationBlackout as yt, ElementUpdate as z, presentationBaseName as zn, PptxImageEffects as zr, SLIDE_TRANSITION_KEYFRAMES as zt };
+//# sourceMappingURL=transition-overlay-D57AQXCk.d.ts.map