pptx-vanilla-viewer 3.26.0 → 3.27.0

package/dist/{transition-overlay-C_wuJuse.d.ts → transition-overlay-CxqDHlcC.d.ts}

@@ -1,8 +1,5 @@
 import "fast-xml-parser";
 import "jszip";
-import { Doc } from "yjs";
-import "opentype.js";
-import "ooxml-ui/controls";
 //#region ../../../../src/core/dist/pptx/chunks/color-ref-DT599vEx.d.ts
 //#region pptx/core/types/color-ref.d.ts
 /**
@@ -2948,7 +2945,7 @@ interface PptxSmartArtData {
   drawingDirty?: boolean;
 }
 //#endregion
-//#region ../../../../src/core/dist/pptx/chunks/text-operations-DM2_DC-I.d.ts
+//#region ../../../../src/core/dist/pptx/chunks/text-operations-BmD0XMO2.d.ts
 //#region pptx/core/types/shape-style.d.ts
 interface PptxCustomDashSegment {
   /** Dash length as a non-negative percentage in thousandths of one percent. */
@@ -3874,6 +3871,21 @@ interface PptxChartAxisLabelFormatting {
   noMultiLevelLabels?: boolean;
 }
 //#endregion
+//#region chart/gradient-definition.d.ts
+interface ChartGradientFill {
+  type: 'linear' | 'radial';
+  stops: Array<{
+    color: string;
+    position: number;
+    opacity?: number;
+  }>;
+  angle?: number;
+  focalPoint?: {
+    x: number;
+    y: number;
+  };
+}
+//#endregion
 //#region pptx/core/types/chart-ex.d.ts
 /**
  * Chart-formatting types that don't fit an existing, owned type module for
@@ -4065,64 +4077,21 @@ interface PptxChartProtection {
   rawXml?: XmlObject;
 }
 //#endregion
-//#region pptx/core/types/chart-style-definition.d.ts
-/**
- * Typed subset of an Office 2013+ chart-style part (`ppt/charts/style#.xml`,
- * root element `cs:chartStyle`, relationship type
- * `.../2012/relationships/chartStyle`).
- *
- * PowerPoint's Design-tab "Chart Styles" gallery (1-48) writes `c:style/@val`
- * on the chart part itself (already modeled as `PptxChartStyle.styleId`) and,
- * for most styles, this SEPARATE part spelling out the per-element
- * `cs:lnRef`/`cs:fillRef`/`cs:effectRef`/`cs:fontRef`/`cs:defRPr` defaults a
- * chart element falls back to when its own XML leaves it unstyled. Without
- * parsing this part, styles beyond the one PowerPoint happens to have baked
- * inline are visually inert.
- *
- * @module pptx-types/chart-style-definition
- */
-/**
- * One styled chart-element entry (`cs:title`, `cs:axisTitle`,
- * `cs:categoryAxis`, ...). Colours are resolved to hex at parse time (scheme
- * colour references via `cs:fontRef`/`cs:lnRef`/`cs:fillRef` are already
- * flattened against the theme, matching how classic chart colours resolve
- * elsewhere in this codebase). Fields are present only when the source XML
- * carried a value for them.
- */
-interface PptxChartStylePartEntry {
-  /** Text size in points, from `cs:defRPr/@sz` (hundredths of a point). */
+//#region chart/style-definition.d.ts
+/** Chart elements consumed by the current Office chart painters. */
+declare const CHART_STYLE_PARTS: readonly ['title', 'axisTitle', 'categoryAxis', 'valueAxis', 'legend', 'dataLabel', 'dataPoint', 'dataPointLine', 'gridlineMajor', 'gridlineMinor', 'chartArea', 'plotArea'];
+type ChartStylePart = (typeof CHART_STYLE_PARTS)[number];
+/** Resolved subset consumed by existing chart painters, with sizes and widths in points. */
+interface ResolvedChartStyleEntry {
   fontSize?: number;
   bold?: boolean;
   italic?: boolean;
-  /** Resolved text colour: `cs:defRPr/a:solidFill`, or `cs:fontRef`'s scheme colour. */
   color?: string;
-  /** Resolved line colour from `cs:lnRef`'s scheme colour reference. */
   lineColor?: string;
-  /** Line width in points, when directly authored (rare; most styles reference a theme line style by index only). */
   lineWidth?: number;
-  /** Resolved fill colour from `cs:fillRef`'s scheme colour reference. */
   fillColor?: string;
 }
-/**
- * Parsed per-element style defaults from a chart-style part. Only the
- * elements this viewer actually renders distinct defaults for are modeled;
- * elements PowerPoint's style gallery also styles (data table, trendlines,
- * up/down bars, ...) are out of scope until a renderer needs them.
- */
-interface PptxChartStyleDefinition {
-  title?: PptxChartStylePartEntry;
-  axisTitle?: PptxChartStylePartEntry;
-  categoryAxis?: PptxChartStylePartEntry;
-  valueAxis?: PptxChartStylePartEntry;
-  legend?: PptxChartStylePartEntry;
-  dataLabel?: PptxChartStylePartEntry;
-  dataPoint?: PptxChartStylePartEntry;
-  dataPointLine?: PptxChartStylePartEntry;
-  gridlineMajor?: PptxChartStylePartEntry;
-  gridlineMinor?: PptxChartStylePartEntry;
-  chartArea?: PptxChartStylePartEntry;
-  plotArea?: PptxChartStylePartEntry;
-}
+type ResolvedChartStyleDefinition = Partial<Record<ChartStylePart, ResolvedChartStyleEntry>>;
 //#endregion
 //#region pptx/core/types/chart-title.d.ts
 /**
@@ -4558,19 +4527,7 @@ type PptxChartScatterStyle = 'none' | 'line' | 'lineMarker' | 'marker' | 'smooth
  * 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;
-  };
-}
+type PptxChartGradientFill = ChartGradientFill;
 interface PptxChartShapeProps {
   fillColor?: string;
   strokeColor?: string;
@@ -4658,6 +4615,12 @@ interface PptxChartDataLabel {
   showBubbleSize?: boolean;
   position?: PptxChartDataLabelPosition;
   text?: string;
+  /**
+   * {@link text} was read from the cells of a "Value From Cells" range, not
+   * from a literal `c:tx`. The save path keeps such a label linked to its
+   * cells and writes no `c:tx`; clear this to save the text as literal.
+   */
+  textFromCells?: boolean;
   separator?: string;
   showLeaderLines?: boolean;
   /**
@@ -4680,6 +4643,14 @@ interface PptxChartDataLabel {
    * `.../a:p/a:pPr/a:defRPr` default-run-property style.
    */
   txPr?: PptxChartLegendTextStyle;
+  /**
+   * Font of this label's literal rich text (`c:dLbl/c:tx/c:rich`): the first
+   * run's `a:rPr` over its paragraph's `a:pPr/a:defRPr`. PowerPoint draws
+   * {@link text} with these run properties, so each field set here wins over
+   * the same field of {@link txPr}. Parsed for drawing only; saving does not
+   * write it back from here.
+   */
+  richTextStyle?: PptxChartLegendTextStyle;
   /**
    * This label's own shape formatting (`c:dLbl/c:spPr`): fill/line colour,
    * width, and dash style for the label's callout box, taking precedence
@@ -4738,6 +4709,8 @@ interface PptxChartAxisFormatting extends PptxChartAxisLabelFormatting {
   titleText?: string;
   spPr?: PptxChartShapeProps;
   fontFamily?: string;
+  /** East Asian typeface of the axis text (`a:ea/@typeface`). */
+  eastAsiaFontFamily?: string;
   fontSize?: number;
   fontBold?: boolean;
   fontColor?: string;
@@ -5182,6 +5155,11 @@ interface PptxChartDataLabelOptions {
 /** Typed text defaults for a single chart legend entry. */
 interface PptxChartLegendTextStyle {
   fontFamily?: string;
+  /**
+   * East Asian typeface (`a:ea/@typeface`). PowerPoint draws CJK characters
+   * in this face and everything else in {@link fontFamily}.
+   */
+  eastAsiaFontFamily?: string;
   fontSize?: number;
   bold?: boolean;
   italic?: boolean;
@@ -5236,6 +5214,13 @@ interface PptxChartStyle {
    * which always wins over this chart-level default.
    */
   legendTextStyle?: PptxChartLegendTextStyle;
+  /**
+   * The chart-wide default text style: `c:chartSpace/c:txPr` over the theme's
+   * minor (body) fonts. PowerPoint uses it for any chart text whose own
+   * `txPr` leaves a field unset, such as axis labels and data labels. Not
+   * written back on save: the authored `c:txPr` is kept as it is.
+   */
+  textStyle?: PptxChartLegendTextStyle;
   /** Whether the chart has a title. */
   hasTitle?: boolean;
   /** Whether gridlines are visible. */
@@ -5273,6 +5258,8 @@ interface PptxChartStyle {
    * from an axis title's styling (`PptxChartAxisFormatting.fontFamily` etc.).
    */
   titleFontFamily?: string;
+  /** East Asian typeface of the title (`a:ea/@typeface`). */
+  titleEastAsiaFontFamily?: string;
   titleFontSize?: number;
   titleFontBold?: boolean;
   titleFontColor?: string;
@@ -5760,7 +5747,7 @@ interface PptxChartData {
    * automation-authored charts, where PowerPoint still implies style 2's
    * look via its own bundled defaults).
    */
-  chartStyleDefinition?: PptxChartStyleDefinition;
+  chartStyleDefinition?: ResolvedChartStyleDefinition;
 }
 //#endregion
 //#region pptx/core/types/table-style-edit.d.ts
@@ -6067,6 +6054,8 @@ interface PptxTableCellTextRun {
   fontSize?: number;
   /** Run font family from `a:rPr/a:latin@typeface` (or `a:ea` / `a:cs`). */
   fontFamily?: string;
+  /** Run language from `a:rPr/@lang`, such as `ko-KR`. */
+  language?: string;
   /**
    * Run baseline shift from `a:rPr/@baseline`, in thousandths of a percent
    * (`-25000` is a 25% subscript). Positive raises the run, negative lowers it.
@@ -10837,7 +10826,7 @@ interface PptxEmbeddedFont {
   originalPartBytes?: Uint8Array;
 }
 //#endregion
-//#region ../../../../src/core/dist/pptx/chunks/index-CEyiW7oo.d.ts
+//#region ../../../../src/core/dist/pptx/chunks/index-C9mtdQca.d.ts
 //#region pptx/core/types/theme-presets.d.ts
 /**
  * A complete theme preset that can be applied to a presentation.
@@ -12437,6 +12426,14 @@ declare class PptxHandler extends PptxHandlerCore {
   loadFromJson(text: string, options?: PptxHandlerLoadOptions): Promise<PptxData>;
 }
 //#endregion
+//#region pptx/converter/svg-text-lines.d.ts
+type SvgTextMeasurer = (text: string, font: {
+  family: string;
+  size: number;
+  bold: boolean;
+  italic: boolean;
+}) => number;
+//#endregion
 //#region pptx/converter/SvgExporter.d.ts
 /**
  * Options controlling SVG export behaviour.
@@ -12450,9 +12447,11 @@ interface SvgExportOptions {
   defaultFontFamily?: string;
   /** Default font size in points when the element does not specify one. */
   defaultFontSize?: number;
+  /** Optional host font metrics. Headless exports fall back to measured font tables. */
+  measureText?: SvgTextMeasurer;
 }
 //#endregion
-//#region ../../../../src/core/dist/pptx/chunks/index-CvtFF9SI.d.ts
+//#region ../../../../src/core/dist/pptx/chunks/index-DEZWeMcu.d.ts
 //#endregion
 //#region pptx/core/utils/accessibility-checker.d.ts
 type AccessibilityIssueType = 'missingAltText' | 'missingSlideTitle' | 'lowContrast' | 'complexTable' | 'duplicateTitle' | 'blankSlide';
@@ -12468,3923 +12467,6 @@ interface AccessibilityIssue {
 /** Supported merge shape operations (matching PowerPoint's Merge Shapes menu). */
 type MergeShapeOperation = 'union' | 'intersect' | 'subtract' | 'fragment' | 'combine';
 //#endregion
-//#region ../shared/dist/index-DDHixrsQ.d.ts
-//#region src/theme/types.d.ts
-/**
- * Theme configuration types for the PowerPoint viewer.
- *
- * All color values accept any valid CSS color string:
- * hex (`#6366f1`), rgb (`rgb(99 102 241)`), hsl (`hsl(239 84% 67%)`),
- * oklch (`oklch(0.585 0.233 277)`), named colors, etc.
- *
- * Framework-agnostic — shared by the React, Vue, and Angular bindings.
- */
-/**
- * Semantic color tokens for the viewer UI.
- *
- * These map to CSS custom properties (`--pptx-<token>`) and drive all
- * UI component colors. The naming follows the shadcn/ui convention so
- * that Tailwind + shadcn users get a familiar experience.
- */
-interface ViewerThemeColors {
-  /** Page / root background */
-  background: string;
-  /** Default text color */
-  foreground: string;
-  /** Card / panel surface */
-  card: string;
-  /** Text on card surfaces */
-  cardForeground: string;
-  /** Popover / dropdown surface */
-  popover: string;
-  /** Text inside popovers */
-  popoverForeground: string;
-  /** Primary action color (buttons, active indicators) */
-  primary: string;
-  /** Text on primary-colored backgrounds */
-  primaryForeground: string;
-  /** Secondary / subdued action color */
-  secondary: string;
-  /** Text on secondary backgrounds */
-  secondaryForeground: string;
-  /** Muted / disabled surface */
-  muted: string;
-  /** Text on muted surfaces (also used for secondary text) */
-  mutedForeground: string;
-  /** Accent / hover-highlight surface */
-  accent: string;
-  /** Text on accent surfaces */
-  accentForeground: string;
-  /** Destructive / danger action color */
-  destructive: string;
-  /** Text on destructive backgrounds */
-  destructiveForeground: string;
-  /** Default border color */
-  border: string;
-  /** Input field border color */
-  input: string;
-  /** Focus ring color */
-  ring: string;
-}
-/**
- * Full viewer theme configuration.
- *
- * Every property is optional — unset values fall back to the built-in
- * dark theme defaults.
- */
-interface ViewerTheme {
-  /** Semantic UI colors. Each key maps to a `--pptx-<key>` CSS custom property. */
-  colors?: Partial<ViewerThemeColors>;
-  /** Base border-radius value (e.g. `"0.5rem"`, `"8px"`). */
-  radius?: string;
-  /**
-   * Escape hatch: arbitrary CSS custom properties to set on the viewer
-   * root element. Keys should include the `--` prefix.
-   *
-   * @example
-   * ```ts
-   * { "--my-custom-shadow": "0 4px 12px rgba(0,0,0,0.5)" }
-   * ```
-   */
-  cssVars?: Record<string, string>;
-}
-//#endregion
-//#region src/theme/defaults.d.ts
-/**
- * Default dark-theme color values.
- *
- * These correspond to the built-in dark UI of the PowerPoint viewer and
- * use Tailwind's gray palette as the neutral scale with indigo as the
- * primary accent.
- */
-declare const defaultThemeColors: ViewerThemeColors;
-/** Default border-radius. */
-declare const defaultRadius = "0.5rem";
-//#endregion
-//#region src/theme/css-vars.d.ts
-/**
- * Convert a `ViewerTheme` into a flat `Record<string, string>` of CSS
- * custom properties (including the `--` prefix) ready to be spread onto
- * a `style` attribute.
- *
- * Only properties that differ from the built-in defaults are emitted when
- * `omitDefaults` is true (the default).
- */
-declare function themeToCssVars(theme: ViewerTheme | undefined, omitDefaults?: boolean): Record<string, string>;
-/**
- * Build the complete set of CSS custom properties with all defaults.
- * Useful for generating a full fallback stylesheet.
- */
-declare function defaultCssVars(): Record<string, string>;
-/** Light vermilion theme, ready for the viewer's `theme` prop. */
-declare const vermilionLightTheme: ViewerTheme;
-/** Dark vermilion theme, ready for the viewer's `theme` prop. */
-declare const vermilionDarkTheme: ViewerTheme;
-//#endregion
-//#region src/theme/theme-catalog.d.ts
-/** One selectable entry in the viewer chrome's built-in theme picker (File > Options > Appearance). */
-interface ThemeCatalogEntry {
-  /** Stable identifier persisted to storage and passed to `onThemeChange`. */
-  key: string;
-  /** `pptx.*` translation key for the entry's display label. */
-  labelKey: string;
-  /** The theme to apply, or `undefined` to reset to the built-in default. */
-  theme: ViewerTheme | undefined;
-}
-//#endregion
-//#region ../shared/dist/index.d.ts
-//#region src/render/collaboration-presence.d.ts
-/** Connection lifecycle states for the Yjs WebSocket provider. */
-type ConnectionStatus = 'disconnected' | 'connecting' | 'connected' | 'error';
-/** A single remote collaborator's cursor, in unscaled slide coordinates. */
-interface RemoteCursor {
-  /** Stable id for the remote client (awareness clientId or peer id). */
-  clientId: number | string;
-  /** Display name shown in the label chip. */
-  userName: string;
-  /** Cursor + chip colour (any CSS colour string). */
-  color: string;
-  /** Unscaled slide-space X coordinate (px). */
-  x: number;
-  /** Unscaled slide-space Y coordinate (px). */
-  y: number;
-  /** Optional ids of elements this user has selected. */
-  selectionIds?: string[];
-}
-/**
- * Presence data for a remote collaborator, sanitised from the awareness
- * protocol. Returned by {@link sanitizePresence}; coordinates are in unscaled
- * slide pixels, clamped to the supplied canvas bounds.
- */
-interface SanitizedPresence {
-  clientId: number;
-  userName: string;
-  userAvatar?: string;
-  userColor: string;
-  activeSlideIndex: number;
-  cursorX: number;
-  cursorY: number;
-  lastUpdated: string;
-  selectedElementId?: string;
-  role?: CollaborationRole;
-}
-//#endregion
-//#region src/render/collaboration-presence-publisher.d.ts
-/**
- * Structural interface for the lazily-imported Yjs awareness surface. Every
- * binding's live `y-protocols/awareness` `Awareness` instance satisfies this.
- */
-interface AwarenessLike {
-  clientID?: number;
-  setLocalStateField: (field: string, value: unknown) => void;
-  getStates: () => Map<number, Record<string, unknown>>;
-  on: (event: string, cb: () => void) => void;
-  off?: (event: string, cb: () => void) => void;
-}
-//#endregion
-//#region src/render/collaboration-external-session.d.ts
-/** Connection state reported by the host, independent of the viewer lifetime. */
-interface ExternalCollaborationSnapshot {
-  status: ConnectionStatus;
-  /**
-   * The host has loaded the authoritative document and permits local edits.
-   * Keep true while offline to allow ordinary Yjs offline edits, or set false
-   * to suspend writes until a fresh sync. The viewer never infers this from
-   * `status` and never opens it after a timeout.
-   */
-  synced: boolean;
-}
-/** The public y-protocols Awareness surface needed by a borrowed session. */
-interface ExternalCollaborationAwareness extends AwarenessLike {
-  clientID: number;
-  getLocalState: () => Record<string, unknown> | null;
-  setLocalState: (state: Record<string, unknown> | null) => void;
-  off: (event: string, callback: () => void) => void;
-}
-/**
- * Host-owned Yjs resources. The host creates, connects and destroys them.
- * Keep this object and its resources stable for a session; report connection
- * changes through subscribe instead of replacing the collaboration config.
- */
-interface ExternalCollaborationSession {
-  readonly doc: Doc;
-  /** Awareness must belong to doc. One viewer publishes slide presence at a time. */
-  readonly awareness: ExternalCollaborationAwareness;
-  getSnapshot: () => ExternalCollaborationSnapshot;
-  /** Subscribe to status or synced changes; return an unsubscribe function. */
-  subscribe: (listener: () => void) => () => void;
-}
-//#endregion
-//#region src/render/element-update-batch.d.ts
-/** A shallow property patch for a top-level element on an ordinary slide. */
-interface ElementUpdate {
-  slideId: string;
-  elementId: string;
-  patch: Partial<PptxElement>;
-}
-interface ElementUpdateOptions {
-  /** Optional description for the undo entry. */
-  label?: string;
-}
-//#endregion
-//#region src/types.d.ts
-/** Canvas dimensions in pixels. */
-interface CanvasSize {
-  width: number;
-  height: number;
-}
-/** Viewer interaction mode: read-only, edit, presentation, or master-view. */
-type ViewerMode = 'preview' | 'edit' | 'present' | 'master';
-/**
- * Framework-agnostic imperative API contract for the PowerPoint viewer.
- *
- * Each binding (React `forwardRef` handle, Vue `defineExpose`, Angular public
- * methods) implements this interface so consumers get a consistent progressive
- * API regardless of framework.
- */
-interface PowerPointViewerAPI {
-  /** Serialise the current presentation to `.pptx` bytes. */
-  getContent: () => Promise<Uint8Array>;
-  /** Navigate to a specific slide by zero-based index. */
-  goTo: (slideIndex: number) => void;
-  /** Navigate to the previous slide. */
-  goPrev: () => void;
-  /** Navigate to the next slide. */
-  goNext: () => void;
-  /** Undo the last editing action. No-op when nothing to undo. */
-  undo: () => void;
-  /** Redo the last undone action. No-op when nothing to redo. */
-  redo: () => void;
-  /** Whether an undo action is available. */
-  canUndo: () => boolean;
-  /** Whether a redo action is available. */
-  canRedo: () => boolean;
-  /** Get the current zoom level (1 = 100%). */
-  getZoom: () => number;
-  /** Set the zoom level (clamped to min/max bounds). */
-  setZoom: (level: number) => void;
-  /** Zoom in by one step. */
-  zoomIn: () => void;
-  /** Zoom out by one step. */
-  zoomOut: () => void;
-  /** Reset zoom to 100%. */
-  zoomReset: () => void;
-  /** Get the current viewer mode. */
-  getMode: () => ViewerMode;
-  /** Switch the viewer mode (e.g. 'edit', 'preview', 'present'). */
-  setMode: (mode: ViewerMode) => void;
-  /** Get the zero-based active slide index. */
-  getActiveSlideIndex: () => number;
-  /** Set the active slide by zero-based index (alias of goTo). */
-  setActiveSlideIndex: (index: number) => void;
-  /** Get the total number of slides. */
-  getSlideCount: () => number;
-  /** Whether the document has unsaved changes. */
-  isDirty: () => boolean;
-  /**
-   * Get the full slide array. Returns the actual `PptxSlide[]` from the
-   * internal model with full type information (elements, notes, transitions,
-   * animations, etc.). The returned reference is a snapshot; mutations are
-   * not reflected back unless done via the manipulation methods.
-   */
-  getSlides: () => readonly PptxSlide[];
-  /** Get a single slide by zero-based index, or undefined if out of range. */
-  getSlide: (index: number) => PptxSlide | undefined;
-  /** Get the currently active slide. */
-  getActiveSlide: () => PptxSlide | undefined;
-  /** Add a blank slide after the given index (or at end if omitted). */
-  addSlide: (afterIndex?: number) => void;
-  /** Delete slides at the given zero-based indexes. At least one slide is kept. */
-  deleteSlides: (indexes: number[]) => void;
-  /** Duplicate slides at the given zero-based indexes. */
-  duplicateSlides: (indexes: number[]) => void;
-  /** Move a slide from one position to another. */
-  moveSlide: (fromIndex: number, toIndex: number) => void;
-  /** Toggle the hidden flag on slides at the given indexes. */
-  toggleHideSlides: (indexes: number[]) => void;
-  /**
-   * Get the elements on a slide. Defaults to the active slide when
-   * `slideIndex` is omitted. Returns the full `PptxElement[]` with
-   * all type-specific properties intact.
-   */
-  getElements: (slideIndex?: number) => readonly PptxElement[];
-  /** Get a single element by ID from the active slide (or a specified slide). */
-  getElementById: (elementId: string, slideIndex?: number) => PptxElement | undefined;
-  /**
-   * Append and select a deep copy on the active ordinary editable slide.
-   * Assigns fresh element IDs without offsetting the supplied geometry.
-   * Returns the new root ID, or undefined when insertion is unavailable.
-   * Uses normal Undo/Redo grouping. Models must be self-contained or refer to
-   * assets in this document; this does not import foreign PPTX relationships.
-   */
-  addElement: (element: PptxElement) => string | undefined;
-  /**
-   * Update one or more properties of an element by ID on the active slide.
-   * Accepts a `Partial<PptxElement>` patch (e.g. `{ x: 100, width: 300 }`).
-   */
-  updateElement: (elementId: string, updates: Partial<PptxElement>) => void;
-  /** Atomically patch ordinary slide elements as one independent undo step. Rejects invalid batches. */
-  updateElements: (updates: readonly ElementUpdate[], options?: ElementUpdateOptions) => Promise<void>;
-  /** Delete elements by their IDs from the active slide. */
-  deleteElements: (elementIds: string[]) => void;
-  /**
-   * Duplicate an element on the active slide.
-   * Returns the new element's ID, or undefined if the source was not found.
-   */
-  duplicateElement: (elementId: string) => string | undefined;
-  /** Get the IDs of currently selected elements. */
-  getSelectedElementIds: () => string[];
-  /** Programmatically select elements by their IDs. */
-  selectElements: (ids: string[]) => void;
-  /** Clear the current selection. */
-  clearSelection: () => void;
-}
-/** Collaboration role within a session. */
-type CollaborationRole = 'owner' | 'collaborator' | 'viewer';
-/**
- * Collaboration transport.
- *
- * - `'websocket'` (default): y-websocket against `serverUrl`.
- * - `'webrtc'`: y-webrtc peer-to-peer; needs no document server. Peers meet
- *   through the `signaling` servers (WebRTC signaling only, no document data)
- *   and same-browser tabs additionally sync via BroadcastChannel even without
- *   any signaling server, which makes this mode usable from static hosting.
- */
-type CollaborationTransport = 'websocket' | 'webrtc';
-/** How the local user entered a collaboration session. */
-type CollaborationSessionIntent = 'create' | 'join';
-/**
- * Real-time collaboration configuration.
- *
- * The same shape is accepted by every framework binding.
- */
-interface CollaborationConfig {
-  /** Unique identifier for the collaboration room (alphanumeric, hyphens, underscores). */
-  roomId: string;
-  /**
-   * WebSocket server URL for the Yjs provider (e.g. "wss://collab.example.com").
-   * Ignored (may be empty) for `externalSession` or when `transport` is `'webrtc'`.
-   */
-  serverUrl: string;
-  /** Transport to use. Defaults to `'websocket'`. */
-  transport?: CollaborationTransport;
-  /**
-   * Use the host's document, awareness and transport instead of creating a
-   * provider. Transport, serverUrl, signaling and authToken are ignored. The
-   * viewer only detaches its listeners and presence on stop; it never destroys
-   * these resources. Keep this object stable and report readiness via subscribe.
-   */
-  externalSession?: ExternalCollaborationSession;
-  /**
-   * WebRTC signaling server URLs (only used when `transport` is `'webrtc'`).
-   * Defaults to y-webrtc's built-in public signaling list. Same-browser tabs
-   * sync via BroadcastChannel regardless of signaling availability.
-   */
-  signaling?: string[];
-  /** Display name for the local user. */
-  userName: string;
-  /** Avatar URL for the local user (optional). */
-  userAvatar?: string;
-  /** Hex colour for the local user's cursor/presence indicator. */
-  userColor?: string;
-  /** Optional authentication token sent with the WebSocket handshake. */
-  authToken?: string;
-  /** Role in the session; defaults to `'collaborator'`. */
-  role?: CollaborationRole;
-  /**
-   * Whether this client created the room or joined an existing room. Providers
-   * do not use this value, but hosts can use it to avoid publishing local file
-   * bytes when handling a join request. Omitted values retain the legacy
-   * create-session behaviour.
-   */
-  sessionIntent?: CollaborationSessionIntent;
-  /**
-   * Elected-writer write-back callback (Area 3 of the C3 hardening plan).
-   *
-   * When the local user has `role: 'owner'`, the binding debounces changes and
-   * serializes the current Y.Doc state to a PPTX byte array, then calls this
-   * callback so the host can persist the snapshot. Only one writer (the owner)
-   * does this; other collaborators never trigger write-back, eliminating the
-   * last-save-wins problem.
-   */
-  onWriteBack?: (bytes: Uint8Array) => void;
-  /**
-   * Debounce delay (ms) between the last Y.Doc change and the write-back
-   * invocation. Defaults to 5000 ms. Set to 0 to write back on every change
-   * (not recommended for large documents).
-   */
-  writeBackDebounceMs?: number;
-}
-/** A neutral CSS map (framework `CSSProperties` are structurally compatible). */
-type CssStyleMap = Record<string, string | number>;
-//#endregion
-//#region src/render/text-run-style.d.ts
-/** A plain CSS style map (keys are CSS properties; binding-agnostic). */
-type RunStyle = Record<string, string | number>;
-/** One script-tagged piece of a run's text, ready for a binding's nested span. */
-interface ScriptFontPiece {
-  text: string;
-  /**
-   * CSS for a nested span wrapping `text`, or `undefined` when this piece
-   * needs no span at all (its script's font equals the run's own, so plain
-   * text renders identically). When present it carries the `fontFamily`
-   * override plus the run's own decoration subset, repeated because
-   * `text-decoration-*` does not inherit into a nested span (see
-   * `nestedTextDecorationStyle`).
-   */
-  style?: RunStyle;
-}
-//#endregion
-//#region src/render/reflection.d.ts
-/**
- * CSS `mask-image`/`-webkit-mask-image` value plus the raw `transform` for a
- * mirrored reflection sibling. Every value is a ready-to-apply CSS string (or
- * `'none'` sentinel avoided - fields are omitted when the browser default
- * already matches), so a binding can spread this directly onto its own style
- * object with no further per-framework logic.
- */
-interface ReflectionWrapperStyle {
-  position: 'absolute';
-  left: string;
-  /** `calc(100% + <dist>px)`: sits `@dist` px below the source element's box. */
-  top: string;
-  width: string;
-  height: string;
-  /** `scale(@sx, @sy)` (the sign of `@sy` IS the mirror) composed with `@kx`/`@ky`/`@rot`. */
-  transform: string;
-  /** Anchor point for the transform above, from `@algn` (default `center top`). */
-  transformOrigin: string;
-  maskImage: string;
-  WebkitMaskImage: string;
-  pointerEvents: 'none';
-}
-/**
- * Reference to an interactive chart sub-part, carried by the primitives that
- * represent data marks (bars, dots, slices, series lines). Bindings use it to
- * make marks clickable/draggable in edit mode and to sync selection with the
- * chart inspector; primitives without a `part` stay purely decorative.
- */
-interface ChartPartRef {
-  /** 'dataPoint' targets one (series, category) cell; 'series' the whole series. */
-  role: 'dataPoint' | 'series';
-  seriesIndex: number;
-  /** Category/point index. Absent when the primitive spans the whole series. */
-  pointIndex?: number;
-}
-//#endregion
-//#region src/render/animation-authoring.d.ts
-/** One of the three animation buckets a preset can occupy on an element. */
-type AnimationGroup = 'entrance' | 'emphasis' | 'exit';
-//#endregion
-//#region src/render/animation-timeline-build-descriptors.d.ts
-/**
- * `animation-timeline-build-descriptors` - staged-build (`p:bldChart` /
- * `p:bldDgm`) reveal descriptor types, split out of `animation-timeline-types`
- * to keep that module under the file-size limit. Re-exported from
- * `animation-timeline-types` so existing imports are unaffected.
- *
- * @module render/animation-timeline-build-descriptors
- */
-/**
- * Normalized staged-reveal mode for a chart graphic frame, derived from the
- * OOXML `a:bldChart/@bld` (or `p:bldOleChart/@bld`) token:
- *  - `asOne`      the whole chart appears at once (`allAtOnce`).
- *  - `bySeries`   one data series is revealed per stage (`series`).
- *  - `byCategory` one category is revealed per stage (`category`).
- *  - `byElement`  one series/category ELEMENT is revealed per stage
- *                 (`seriesElement` / `categoryElement`).
- */
-type ChartBuildMode = 'asOne' | 'bySeries' | 'byCategory' | 'byElement';
-/**
- * Normalized staged-reveal mode for a SmartArt diagram, derived from the OOXML
- * `a:bldDgm/@bld` or `p:bldDgm/@bld` token:
- *  - `asOne`        the whole diagram appears at once (`whole` / `allAtOnce`).
- *  - `byOne`        one node is revealed per stage (`one`, and the assorted
- *                   `depthBy*` / `breadthBy*` / directional traversals).
- *  - `byLvl`        levels are revealed one element at a time (`lvlOne`).
- *  - `byLvlAtOnce`  a whole level is revealed per stage (`lvlAtOnce`).
- */
-type DiagramBuildMode = 'asOne' | 'byOne' | 'byLvl' | 'byLvlAtOnce';
-/**
- * One authored `p:graphicEl` reveal unit resolved onto a chart, per
- * `TimelineStepGraphicElement`'s "both indices set" case: a single (series,
- * category) cell revealed by a `bldStep="seriesEl"`/`"categoryEl"` effect.
- */
-interface ChartRevealPoint {
-  seriesIdx: number;
-  categoryIdx: number;
-}
-/**
- * Playback-time chart reveal state derived from AUTHORED `p:graphicEl`
- * indices (see `chart-reveal-descriptor`'s `resolveChartRevealDescriptor`),
- * rather than from click-count/time progress. Present on
- * {@link import('./animation-timeline-group').ElementAnimationState.chartReveal}
- * only when every fired chart-build step for the element carried index data;
- * a renderer prefers this over the progress-based `build`/`ElementBuildState`
- * path when present, since it reflects the real authored reveal set (correct
- * even for a reversed-order or gapped chart build), and falls back to `build`
- * when absent.
- */
-interface ChartRevealDescriptor {
-  /**
-   * Whether the chart's background/axes/gridlines/legend should currently be
-   * visible: always `true` when the chart's `animateBackground` is `false`
-   * ("shown throughout"), otherwise `true` from the first revealed stage
-   * onward.
-   */
-  background: boolean;
-  /** Whole series revealed by a `bldStep="series"` effect. */
-  series: ReadonlySet<number>;
-  /** Whole categories revealed by a `bldStep="category"` effect. */
-  categories: ReadonlySet<number>;
-  /** Individual cells revealed by a `bldStep="seriesEl"`/`"categoryEl"` effect. */
-  points: readonly ChartRevealPoint[];
-}
-/**
- * Playback-time SmartArt diagram reveal state derived from AUTHORED
- * `p:graphicEl/p:dgm/@id` indices (see `diagram-reveal-descriptor`'s
- * `resolveDiagramRevealDescriptor`), rather than from click-count/time
- * progress. Present on
- * {@link import('./animation-timeline-group').ElementAnimationState.diagramReveal}
- * only when every fired diagram-build step for the element carried
- * `p:graphicEl` data. A SmartArt renderer prefers this over the
- * progress-based `build` / {@link ElementBuildState} path when present, since
- * it reflects the real authored reveal set (correct even for a
- * reversed-order or by-branch build), and falls back to `build` when absent.
- */
-interface DiagramRevealDescriptor {
-  /**
-   * Whether the diagram's background/connector chrome should currently be
-   * visible: `true` once any node-revealing or background-revealing
-   * (`bldStep="bg"`) step has fired.
-   */
-  background: boolean;
-  /** Data-model point ids (`PptxSmartArtNode.id`) revealed so far. */
-  nodeIds: ReadonlySet<string>;
-}
-/**
- * Playback-time staged-build state surfaced on
- * {@link import('./animation-timeline-group').ElementAnimationState}.
- * `progress` is the 0..1 fraction of the build revealed at the current
- * playback time; a consumer maps it to its own item COUNT (see
- * `revealedStageCount`).
- */
-type ElementBuildState = {
-  kind: 'chart';
-  mode: ChartBuildMode;
-  progress: number;
-} | {
-  kind: 'diagram';
-  mode: DiagramBuildMode;
-  progress: number;
-};
-//#endregion
-//#region src/render/animation-text-style-resolve.d.ts
-/**
- * Framework-neutral text-style override a font-style emphasis effect applies
- * on top of its target's own authored per-run bold/italic/underline/size/
- * colour. Every binding maps this onto its own text container so it OVERRIDES
- * the runs' inline styles (the runs carry explicit inline styles of their
- * own, so plain CSS inheritance cannot reach them).
- */
-interface TextStyleAnimationDescriptor {
-  bold?: boolean;
-  italic?: boolean;
-  underline?: boolean;
-  /** Relative multiplier against each run's own authored font size. */
-  fontScale?: number;
-  color?: string;
-}
-/** Snapshot of a single element's animation state at a point in the timeline. */
-interface ElementAnimationState {
-  /** Whether the element should be visible. */
-  visible: boolean;
-  /** CSS animation shorthand to apply (undefined = no active animation). */
-  cssAnimation: string | undefined;
-  /**
-   * Staged-build reveal state, present only when the active animation builds a
-   * chart or SmartArt diagram in stages (`p:bldChart` / `p:bldDgm`) rather than
-   * revealing the whole element at once. A staged renderer multiplies
-   * `build.progress` (0..1) by its own series / category / level COUNT to
-   * decide how many stages are revealed at the current playback time; see
-   * {@link import('./animation-build').revealedStageCount}. Absent for ordinary
-   * whole-element entrances, so existing renderers are unaffected.
-   */
-  build?: ElementBuildState;
-  /**
-   * Authored-index chart reveal state (see {@link ChartRevealDescriptor}),
-   * present only when every fired chart-build step for this element carried
-   * `p:graphicEl` index data. A chart renderer prefers this over `build` when
-   * present; `chart-build`'s `resolveRevealedChartData` picks between the two.
-   */
-  chartReveal?: {
-    mode: ChartBuildMode;
-    descriptor: ChartRevealDescriptor;
-  };
-  /**
-   * Authored-index SmartArt diagram reveal state (see
-   * {@link DiagramRevealDescriptor}), present only when every fired
-   * diagram-build step for this element carried `p:graphicEl` node-id data.
-   * `diagram-build`'s `resolveRevealedSmartArtNodes` prefers this over `build`
-   * when present.
-   */
-  diagramReveal?: {
-    mode: DiagramBuildMode;
-    descriptor: DiagramRevealDescriptor;
-  };
-  /**
-   * True when an active `p:animClr` color animation targets this shape's fill.
-   * A vector renderer should then paint the fill with `fill: inherit` so the
-   * wrapper-level colour keyframes cascade to the SVG path. Absent/false means
-   * no active fill-colour animation.
-   */
-  animatesFill?: boolean;
-  /**
-   * True when an active `p:animClr` color animation targets this shape's
-   * stroke. A vector renderer should then paint the stroke with
-   * `stroke: inherit`. Absent/false means no active stroke-colour animation.
-   */
-  animatesStroke?: boolean;
-  /**
-   * Active discrete font-style / colour / size override (see
-   * {@link import('./animation-timeline-step').TimelineStep.textStyle}) a
-   * font-style emphasis effect currently applies to this element's text,
-   * OVERRIDING the runs' own inline bold/italic/underline/size/colour.
-   * `animation-playback-engine.ts` writes this on step start and again on
-   * cleanup (held in full when the effect's `p:cTn/@fill` holds its end
-   * state, otherwise reverted); a text renderer maps it onto its run markup
-   * via `buildTextStyleOverrideCss` (`animation-text-style-css.ts`). Absent
-   * means no font-style emphasis effect is currently active on this element.
-   */
-  textStyle?: TextStyleAnimationDescriptor;
-}
-//#endregion
-//#region src/render/element-locks.d.ts
-/** A single on-canvas gesture a lock may forbid. */
-type ElementInteraction = 'select' | 'move' | 'resize' | 'rotate' | 'textEdit' | 'group' | 'changeAspect' | 'adjustHandle' | 'editPoints' | 'changeArrowheads' | 'changeShapeType' | 'crop' | 'drilldown';
-/**
- * May `interaction` proceed on `element`?
- *
- * The single-question form of {@link resolveElementInteractivity}, for call
- * sites that gate one gesture (a drag-start handler, a rotate commit) rather
- * than rendering a whole overlay.
- */
-declare function canInteractWithElement(element: PptxElement | null | undefined, interaction: ElementInteraction): boolean;
-//#endregion
-//#region src/render/slide-templates/slide-template-types.d.ts
-/** Discriminated id for every built-in slide template. */
-type SlideTemplateId = 'title' | 'titleAndContent' | 'sectionHeader' | 'agenda' | 'twoContent' | 'comparison' | 'quote' | 'timeline' | 'keyMetrics' | 'titleOnly' | 'blank' | 'closing';
-/** The unit system used for ruler display. */
-type RulerUnit = 'inches' | 'centimetres';
-/** Framework-neutral picture-bullet source, sizing, and accessible fallback. */
-interface PictureBulletMarker {
-  src?: string;
-  sizePx: number;
-  fallbackMarker: string;
-  accessibleLabel: string;
-  imageRelId?: string;
-}
-//#endregion
-//#region src/render/text-east-asian-breaks.d.ts
-/** Which of the two behaviours a paragraph asks for. */
-interface EastAsianBreakOptions {
-  /** `a:pPr/@hangingPunct="1"`. */
-  hangingPunctuation: boolean;
-  /** `a:pPr/@eaLnBrk="0"`: break between any two East Asian characters. */
-  breakAnywhere: boolean;
-}
-//#endregion
-//#region src/render/text-run-meta.d.ts
-/** A run's resolved hyperlink target. */
-interface RunHyperlink {
-  /**
-   * The URL to hand a click handler. For an internal `ppaction://hlinksldjump`
-   * the resolved slide index is appended as a `slideIndex` query parameter, so
-   * the target survives a callback whose only argument is the URL (see
-   * `parsePpactionUrl`, which reads it back off).
-   */
-  url: string;
-  /**
-   * A safe, renderable `href` for a plain `<a>`, or `undefined` when the target
-   * is an internal `ppaction://` action or fails the URL safety check. A
-   * binding with no click handler renders the run as text in that case, which
-   * is what every binding did for every link before this field existed.
-   */
-  href?: string;
-  /** `a:hlinkClick/@tooltip`, for the anchor's `title`. */
-  tooltip?: string;
-  /**
-   * `<a target>` for a real (non-`ppaction://`) hyperlink, from
-   * `a:hlinkClick/@tgtFrame` when authored, else `_blank` (every binding's
-   * pre-existing hardcoded default). Only meaningful alongside {@link href}.
-   */
-  target?: string;
-  /** `<a rel>` paired with {@link target} (see `resolveHyperlinkTargetAttrs`). */
-  rel?: string;
-  /** Resolved target slide for an internal slide jump. */
-  targetSlideIndex?: number;
-  /**
-   * True when the target came from `a:hlinkMouseOver` rather than
-   * `a:hlinkClick`: PowerPoint follows it on hover, not on click, so a binding
-   * that renders a plain anchor should not make it look clickable.
-   */
-  onHover?: boolean;
-}
-/** An inline equation run (`m:oMath`), rendered as MathML rather than text. */
-interface RunEquation {
-  /** The raw OMML node, for `convertOmmlToMathMl`. */
-  xml: Record<string, unknown>;
-  /** Display number for a numbered equation, without its parentheses. */
-  number?: string;
-}
-//#endregion
-//#region src/render/text-run-ruby.d.ts
-/** A run's phonetic guide, ready to render as `<rt>` above the base text. */
-interface RunRuby {
-  /** The annotation itself (`a:ruby/a:rt`), e.g. the furigana reading. */
-  text: string;
-  /** Inline style for the `<rt>` element (size, family, alignment, colour). */
-  style: RunStyle;
-}
-//#endregion
-//#region src/render/text-tab-run-build.d.ts
-/** One tabbed-line piece, ready to spread onto a binding's own span element. */
-interface TabbedRunPiece {
-  text: string;
-  /**
-   * CSS for the span that wraps `text`: inline-block layout, this run's own
-   * decoration repeated, and this piece's own PowerPoint advance-width
-   * correction as `letter-spacing` (see `buildTabbedLine`). The piece is
-   * nested inside the run's own span, and neither property inherits the way a
-   * caller would want: `text-decoration-*` does not inherit into a nested
-   * element at all (an ancestor's underline is drawn *through* its
-   * descendants, but each descendant still computes `none` of its own), so a
-   * caller passes the run's decoration subset (`nestedTextDecorationStyle`) to
-   * have it repeated here; `letter-spacing` DOES inherit, which is exactly why
-   * this piece sets it explicitly rather than only when non-zero - the run's
-   * container span carries its own (wrong, whole-text) correction that would
-   * otherwise leak in.
-   */
-  style: RunStyle;
-  /** CSS for the leader-fill span preceding this piece, or `undefined` when there is no gap to fill. */
-  leaderStyle?: RunStyle;
-  /** Leader glyphs sized to fill `leaderStyle`'s width. Present only alongside `leaderStyle`. */
-  leaderText?: string;
-  /**
-   * `a:rPr/@u="words"` per-word/gap sub-pieces of THIS tab piece's own text
-   * (see `splitWordsForUnderline`), present only when the run's underline is
-   * `words`. A tab-separated piece is otherwise rendered as a single span
-   * (`text` + `style`), which underlines it continuously - correct for a
-   * one-word piece, but wrong for a piece like `"Hello World"` between two tab
-   * stops, which needs a gap under the space. A binding renders one SIBLING
-   * span per entry IN PLACE OF the piece's single `text` span: each entry's
-   * `style` is the piece's own `style` (the same inline-block layout and
-   * advance-width correction, so the line measures exactly as before), with
-   * the underline stripped on a gap entry. They must be siblings, not spans
-   * nested inside the piece span: an ancestor's underline is drawn through
-   * every inline descendant, so a nested gap could not lose it. `text`/`style`
-   * stay the continuous-underline fallback for a binding that does not
-   * render this field.
-   */
-  words?: Array<{
-    text: string;
-    style: RunStyle;
-  }>;
-}
-/** One `\n`-split line of a run's tabbed text. */
-interface TabbedLineRun {
-  pieces: TabbedRunPiece[];
-}
-//#endregion
-//#region src/render/paragraph-types.d.ts
-/** A single rendered run within a paragraph. */
-interface ParagraphRun {
-  text: string;
-  style: RunStyle;
-  /**
-   * The run's hyperlink (`a:hlinkClick` / `a:hlinkMouseOver`), when it has one.
-   * A binding renders the run inside an `<a href>` when {@link RunHyperlink.href}
-   * is set, and routes {@link RunHyperlink.url} to its click handler otherwise
-   * (internal `ppaction://` slide jumps).
-   */
-  hyperlink?: RunHyperlink;
-  /**
-   * An inline equation (`m:oMath`) this run renders INSTEAD of `text`, which is
-   * empty for it. Emitted in the run sequence so the maths lands at its
-   * authored position between the runs around it.
-   */
-  equation?: RunEquation;
-  /**
-   * The run's phonetic guide (`a:ruby`: furigana, pinyin, bopomofo), when it
-   * has one. A binding renders `<ruby>{text}<rt style>{ruby.text}</rt></ruby>`;
-   * a run carrying one is never split per word, so the annotation appears once
-   * over the whole base run.
-   *
-   * Core parsed and saved ruby from the start, but `buildParagraphs` never read
-   * it, so the annotation rendered in React alone.
-   */
-  ruby?: RunRuby;
-  /**
-   * Index of the `textSegments` entry (of the override list when one was
-   * supplied) this run was built from.
-   *
-   * Shared splits one authored run into several per-word runs for PowerPoint's
-   * metric tracking, so this is many-to-one. It is the seam a binding uses to
-   * reach the facts the neutral model does not carry - React's find-match
-   * highlights, per-script font spans, tab stops and ruby all key off the
-   * originating segment - without regrouping the segments itself and drifting
-   * from the grouping here.
-   */
-  segmentIndex?: number;
-  /**
-   * Offset of this run's `text` within its segment's RENDERED text (after field
-   * substitution), so a caller holding per-segment character offsets can map
-   * them onto the split runs.
-   */
-  charStart?: number;
-  /**
-   * Per-script (`a:ea`/`a:cs`/`a:sym`) font-fallback pieces for this run's
-   * text, when a script it contains needs a font distinct from its own. A
-   * binding renders these as nested spans in place of `text` (see
-   * `text-script-fonts.ts`); absent for the common single-font case.
-   */
-  scriptRuns?: ScriptFontPiece[];
-  /**
-   * Measured tab-stop layout for this run's text, present when it contains an
-   * authored `\t` and the paragraph declares explicit tab stops. A binding
-   * renders these lines/pieces in place of `text`, honouring per-stop
-   * alignment and leader glyphs a plain CSS `tab-size` cannot express (see
-   * `text-tab-run-build.ts`). Absent for the common no-tab case.
-   */
-  tabLines?: TabbedLineRun[];
-  /**
-   * `a:rPr/@u="words"` word/gap pieces of a RUBY run's base text, present only
-   * when such a run's underline is `words` (the ordinary per-word split emits
-   * sibling runs instead; a tab piece carries its own `words`). Same shape as
-   * `scriptRuns` and rendered the same way, in place of `text`: a word entry
-   * carries the decoration for its own span, a gap entry is bare text. The
-   * run's own `style` has the underline stripped when this is set (see
-   * `paragraph-run-build.ts`).
-   */
-  underlineWordPieces?: ScriptFontPiece[];
-  /** The advance-carrying space after a hanging `、`/`。` (`text-east-asian-breaks`). */
-  hangingSpace?: true;
-  /**
-   * `a:reflection` mirrored-sibling wrapper style for this run (the text-run
-   * counterpart of a shape/picture's `ComputedEffectStyle.reflection`), or
-   * `undefined` for the common no-reflection case. A binding renders a sibling
-   * node just below the run's own, painted with the same text, positioned and
-   * masked by this style - see `render/reflection.ts`'s
-   * `getTextReflectionWrapperStyle`.
-   */
-  reflection?: ReflectionWrapperStyle;
-}
-/** A rendered paragraph: runs plus resolved bullet + hanging-indent metadata. */
-interface RenderParagraph {
-  runs: ParagraphRun[];
-  /** Bullet glyph / number to render before the runs (or `undefined`). */
-  bulletMarker?: string;
-  /** Picture marker rendered before runs, or fallback metadata when unresolved. */
-  bulletPicture?: PictureBulletMarker;
-  /** Inline style for the bullet marker (font / size / colour). */
-  bulletStyle: RunStyle;
-  /** `margin-left` in px for the whole paragraph (hanging-indent layout). */
-  marginLeftPx?: number;
-  /** `text-indent` in px (first-line / hanging indent). */
-  textIndentPx?: number;
-  /**
-   * Per-paragraph `line-height` from this paragraph's own `a:pPr > a:lnSpc`.
-   * A unitless multiplier for proportional spacing (`a:spcPct`) or a `"<n>pt"`
-   * string for exact spacing (`a:spcPts`). Undefined when the paragraph does
-   * not override spacing (binding keeps the body-level line-height).
-   */
-  lineHeight?: number | string;
-  /** `margin-top` in px from this paragraph's `a:pPr > a:spcBef` (space before). */
-  spaceBeforePx?: number;
-  /** `margin-bottom` in px from this paragraph's `a:pPr > a:spcAft` (space after). */
-  spaceAfterPx?: number;
-  /**
-   * `font-size` in px to set on the paragraph element so its CSS line boxes
-   * are built from its OWN runs rather than the text body's default size.
-   * Undefined when the paragraph already matches the body default.
-   *
-   * See `resolveParagraphStrutFontSize` for why this is needed: without it a
-   * paragraph of small runs inside a larger-defaulting body is laid out on
-   * too-tall lines and overflows its shape.
-   */
-  strutFontSizePx?: number;
-  /**
-   * True when the paragraph has no runs and no bullet: an authored blank line
-   * (`<a:p><a:endParaRPr/></a:p>`).
-   *
-   * PowerPoint gives such a paragraph a full line box, which is how decks
-   * space a heading away from the bullet list under it. A binding must render
-   * something with height for it (a `<br>`), or the gap disappears and the
-   * block reads as one dense run of text (issue #131, slides 13-14).
-   */
-  isEmpty?: boolean;
-  /**
-   * Indices of this paragraph's segments in the rendered segment list (the
-   * override list when one was supplied), in authored order and INCLUDING the
-   * bullet-marker segment the runs drop.
-   *
-   * The seam a binding uses to reach paragraph facts the neutral model does not
-   * carry, without regrouping the segments itself and drifting from the
-   * grouping here - which is exactly how React ended up splitting on every
-   * `"\n"` and treating a soft `a:br` as a paragraph break.
-   */
-  segmentIndices: number[];
-  /**
-   * True when this paragraph resolves right-to-left (`a:pPr/@rtl`, or the text
-   * body's default). A binding that mirrors its hanging indent for RTL reads
-   * this; the direction itself is already in {@link paragraphStyle}.
-   */
-  rtl?: boolean;
-  /**
-   * Extra CSS for the paragraph box, beyond the margin / indent / spacing
-   * fields above: this paragraph's own `text-align` (`a:pPr/@algn`), its BiDi
-   * `direction`, and the kinsoku line-breaking rules (`@eaLnBrk`,
-   * `@latinLnBrk`, `@hangingPunct`). Absent when the paragraph overrides none
-   * of them, which is the common case.
-   *
-   * All three used to be resolved in React's private paragraph renderer only,
-   * so a deck that centred one paragraph of a left-aligned body, or set CJK
-   * break rules, rendered differently in the other four bindings.
-   */
-  paragraphStyle?: RunStyle;
-  /**
-   * `@hangingPunct` / `@eaLnBrk="0"` as resolved for this paragraph. The runs
-   * above already carry their pieces; React, which rebuilds each segment's
-   * pieces inside one span, re-applies `splitEastAsianBreaks` from this.
-   */
-  eastAsianBreaks?: EastAsianBreakOptions;
-}
-//#endregion
-//#region src/render/inline-list-types.d.ts
-/** Current editor payload. Missing segments explicitly denotes plain-text fallback. */
-interface InlineTextEditSnapshot {
-  elementId: string;
-  text: string;
-  textSegments?: TextSegment[];
-}
-type InlineListReadResult = {
-  kind: 'supported';
-  snapshot: InlineTextEditSnapshot;
-  paragraphs: RenderParagraph[];
-} | {
-  kind: 'unsupported';
-  reason: string;
-  text: string;
-};
-//#endregion
-//#region src/render/inline-selection-utils.d.ts
-/** Describes which segments (and offsets within them) are selected. */
-interface InlineTextSelection {
-  startSegIdx: number;
-  startOffset: number;
-  endSegIdx: number;
-  endOffset: number;
-}
-//#endregion
-//#region src/render/text-field-substitution.d.ts
-/**
- * Text-field placeholder substitution, shared by every binding's text
- * renderer.
- *
- * Pure string logic: resolves OOXML field runs (slide number, date/time,
- * header/footer, document properties, slide title) into their display text.
- * Extracted from the React `viewer/utils/text-field-substitution` module so
- * every binding substitutes identically. The locale-aware datetime engine
- * lives in `text-field-datetime.ts`.
- */
-/** Context for substituting field placeholders (slide number, date/time, header/footer, etc.). */
-interface FieldSubstitutionContext {
-  slideNumber?: number;
-  dateTimeText?: string;
-  /**
-   * The deck's master date-field default TYPE (`a:fld/@type` on the slide
-   * master's `dt` placeholder, e.g. "datetime2"; see `header-footer-parts.ts`).
-   * This is a field TYPE, not a format pattern, and is used ONLY as a
-   * fallback for a field authored with the generic, unnumbered `datetime`
-   * type - a field that already names its own `datetime1`-`datetime13` type
-   * always uses that type, never this one (see `substituteFieldText`).
-   */
-  dateFormat?: string;
-  /** Footer text from PptxHeaderFooter settings. */
-  footerText?: string;
-  /** Header text from PptxHeaderFooter settings. */
-  headerText?: string;
-  /** Custom document properties for `docproperty` field substitution (keyed by property name). */
-  customProperties?: ReadonlyArray<{
-    name: string;
-    value: string;
-  }>;
-  /** Locale string for date/time formatting (e.g. "en-US"). Falls back to browser default. */
-  locale?: string;
-  /** Title text extracted from the first title placeholder on the slide. */
-  slideTitle?: string;
-}
-/**
- * Changes to apply to textStyle from the advanced panel.
- * Every key maps 1-to-1 to TextStyle fields.
- */
-type TextAdvancedChanges = Partial<Pick<TextStyle, 'characterSpacing' | 'lineSpacing' | 'lineSpacingExactPt' | 'paragraphSpacingBefore' | 'paragraphSpacingAfter' | 'align' | 'vAlign' | 'paragraphIndent' | 'paragraphMarginLeft' | 'textDirection' | 'rtl'>>;
-//#endregion
-//#region src/render/text-case-transform.d.ts
-type ChangeCaseMode = 'sentence' | 'lower' | 'upper' | 'capitalize' | 'toggle';
-interface CollaborationShellState {
-  canEdit: boolean;
-  status: ConnectionStatus;
-  remoteUsers: readonly SanitizedPresence[];
-  connectedCount: number;
-}
-type CollaborationShellTranslate = (key: string, params?: Record<string, string | number>) => string;
-/**
- * One-line, localised status for a custom shell's `role="status"` readout.
- *
- * Every binding's custom-shell demo renders this same string under the same
- * `Collaboration status` label, so the framework-neutral e2e helper that
- * waits for the shell to become editable (`waitForHostEditing`) reads every
- * binding the same way. Three of five demos once phrased it differently and
- * the helper silently skipped them; on vanilla, that let a peer double-click
- * before its edit gate opened.
- */
-declare function describeCollaborationShellState(state: Pick<CollaborationShellState, 'canEdit' | 'status' | 'connectedCount'>, translate: CollaborationShellTranslate): string;
-//#endregion
-//#region src/render/collaboration-text-codec.d.ts
-/**
- * collaboration-text-codec.ts: TextSegment[] <-> Y.Text delta codec used by the
- * collaboration sync layer. Split out of collaboration-sync.ts to keep both
- * modules focused.
- *
- * Exports:
- *  - DeltaOp / YTextLike: structural Yjs text interfaces (no yjs import)
- *  - encodeTextBody: write TextSegment[] into a live YTextLike
- *  - encodeSegmentsToDelta: pure simulation of the delta Y.Text would produce
- *  - decodeDelta / decodeTextBody: delta -> TextSegment[]
- *  - isYTextLike: runtime guard
- */
-interface DeltaOp {
-  insert?: unknown;
-  attributes?: Record<string, unknown>;
-}
-interface YTextLike {
-  insert: (index: number, text: string, attrs?: Record<string, string>) => void;
-  toDelta: () => DeltaOp[];
-  toString: () => string;
-}
-//#endregion
-//#region src/render/collaboration-text-merge.d.ts
-/** Y.Text surface needed for in-place edits (delete/format on top of insert). */
-interface YTextEditableLike extends YTextLike {
-  delete: (index: number, length: number) => void;
-  format: (index: number, length: number, attributes: Record<string, string | null>) => void;
-}
-//#endregion
-//#region src/render/collaboration-text-positions.d.ts
-interface TextPositionCell {
-  index: number;
-  left?: TextPositionCell;
-  right?: TextPositionCell;
-}
-interface TrackedTextPosition {
-  /** Internal identity, shared by snapshots that observed the same character. */
-  readonly cell: TextPositionCell;
-  readonly association: number;
-}
-//#endregion
-//#region src/render/collaboration-text-session-delta.d.ts
-/** Browser edit range mapped to the editor's pre-input encoded coordinates. */
-interface LocalTextReplacement {
-  from: number;
-  to: number;
-}
-/** Desired UTF-16 units mapped to the editor's previously observed identities. */
-interface TextSessionCorrespondence {
-  readonly retainedIndices: readonly (number | null)[];
-  /** Old carriers for known paragraph attributes, independently of character identity. */
-  readonly paragraphSources?: readonly (number | null)[];
-}
-type LocalTextEdit = LocalTextReplacement | TextSessionCorrespondence;
-//#endregion
-//#region src/render/collaboration-text-session.d.ts
-/** Supplied by the binding's existing Yjs runtime, bound to this exact Y.Text. */
-interface TextSessionPositions<Position> {
-  capture: (index: number, association: number) => Position;
-  resolve: (position: Position) => number | null;
-  /** Synchronize tracked positions once per batch, including in-transaction writes. */
-  refresh?: () => boolean | void;
-  /** Release only resources created for this session. */
-  dispose?: () => void;
-}
-/** Opaque acknowledgement identity for an exact remote snapshot painted by an adapter. */
-interface CollaborationTextSnapshot {
-  readonly delta: readonly DeltaOp[];
-}
-interface CollaborationTextSession {
-  applyLocalDelta: (delta: readonly DeltaOp[], edit?: LocalTextEdit) => boolean;
-  readMerged: () => CollaborationTextSnapshot | undefined;
-  adoptMerged: (snapshot: CollaborationTextSnapshot) => boolean;
-  /** Capture an offset in the last painted/local draft, not the newer remote string. */
-  bookmark: (index: number, association: number) => () => number | null;
-  dispose: () => void;
-}
-//#endregion
-//#region src/render/collaboration-sync.d.ts
-interface YMapLike {
-  get: (key: string) => unknown;
-  set: (key: string, value: unknown) => void;
-  delete: (key: string) => void;
-  forEach: (cb: (value: unknown, key: string) => void) => void;
-}
-/** Shape of the Yjs transaction passed to (deep) observers. */
-interface YTransactionLike {
-  origin?: unknown;
-}
-type YDeepObserver = (events?: unknown, transaction?: YTransactionLike) => void;
-interface YArrayLike {
-  readonly length: number;
-  get: (index: number) => unknown;
-  push: (items: unknown[]) => void;
-  delete: (index: number, length?: number) => void;
-  insert: (index: number, items: unknown[]) => void;
-  toArray: () => unknown[];
-  observe: (handler: () => void) => void;
-  unobserve: (handler: () => void) => void;
-  observeDeep: (handler: YDeepObserver) => void;
-  unobserveDeep: (handler: YDeepObserver) => void;
-}
-interface YDocLike {
-  getMap: (name: string) => YMapLike;
-  getArray: (name: string) => YArrayLike;
-  transact: (fn: () => void, origin?: unknown) => void;
-}
-interface YjsFactories {
-  createMap: () => YMapLike;
-  createArray: () => YArrayLike;
-  createText: () => YTextLike;
-  /** Track character identities using the binding's existing Yjs runtime. */
-  createTextPositions?: (text: YTextEditableLike) => TextSessionPositions<TrackedTextPosition>;
-}
-//#endregion
-//#region src/render/collaboration-live-patch-target.d.ts
-/** Interim geometry for an element mid-gesture. All fields optional. */
-interface LiveGeometryPatch {
-  x?: number;
-  y?: number;
-  width?: number;
-  height?: number;
-  rotation?: number;
-}
-/** The element's pre-edit rich text, used to remap the interim plain text. */
-interface LiveTextSource {
-  textSegments?: TextSegment[];
-  textStyle?: TextStyle;
-}
-//#endregion
-//#region src/render/collaboration-text-target.d.ts
-interface CollaborationInlineSnapshot extends CollaborationTextSnapshot {
-  readonly inline: InlineTextEditSnapshot;
-}
-/** A mounted editor owns this handle, never the document or its provider. */
-interface CollaborationTextTarget extends CollaborationTextSession {
-  readMerged: () => CollaborationInlineSnapshot | undefined;
-  /** A bookmark follows character identity rather than a mutable numeric offset. */
-  bookmark: (index: number, association: number) => () => number | null;
-}
-interface CollaborationLivePatcher {
-  /** Bind a mounted native editor; its handle must be disposed on unmount. */
-  beginTextEdit?: (slideId: string | undefined, elementId: string, onChange?: () => void, ownsModel?: (element: PptxElement) => boolean) => CollaborationTextTarget | undefined;
-  /** Attach a live doc (or `null` to go dormant). Pending patches are dropped. */
-  configure: (doc: YDocLike | null, factories: YjsFactories | null,
-  /** Publish synchronously when the host may revoke write readiness at any time. */
-  immediate?: boolean) => void;
-  /** True when a doc + factories are attached, i.e. patches will be written. */
-  isActive: () => boolean;
-  /** Queue interim geometry for an element. */
-  patchGeometry: (slideId: string | undefined, elementId: string, geometry: LiveGeometryPatch) => void;
-  /** Queue interim text for an element (remapped over `source`'s segments). */
-  patchText: (slideId: string | undefined, elementId: string, text: string, source?: LiveTextSource) => void;
-  /** Write everything queued right now (call on gesture end / edit commit). */
-  flush: () => void;
-  /** Drop pending work, cancel timers and detach the doc. */
-  dispose: () => void;
-}
-//#endregion
-//#region src/render/collaboration-load-origin.d.ts
-/**
- * Who asked for the deck that just finished loading, and what that means for a
- * room that already holds slides.
- *
- * Every binding brackets its content-load with an adoption check: when a load
- * lands while a collaboration session is up and the shared doc already has
- * slides, the ROOM wins and the freshly parsed deck is thrown away. That rule
- * exists for one case only - a late joiner whose bootstrap deck (the blank or
- * sample deck the host mounted the viewer with) finishes parsing after the
- * room's real slides arrived, which would otherwise clobber them with nothing
- * left to repair it, since the doc itself never changed.
- *
- * Applied to EVERY load it also swallows the deck a user deliberately opens
- * during a session. Joining a room and then opening a file left the viewer on
- * the room's blank starter deck: the file parsed, was committed, and was
- * immediately overwritten (reproduced in the vanilla demo - a 7-slide deck
- * opened in a room settled back to the room's 1 slide, and the bigger the file
- * the longer the window). Opening a file is an act of authorship, so it is
- * published to the room instead.
- *
- * @module render/collaboration-load-origin
- */
-/**
- * Why a content load ran.
- *
- * - `bootstrap`: the deck the host handed the viewer at mount (`source`), or a
- *   session restore. Nobody chose it during the session.
- * - `user`: opened during the session - File > Open, a recent file, a dropped
- *   file, or a host calling the load API.
- */
-type CollabLoadOrigin = 'bootstrap' | 'user';
-//#endregion
-//#region src/render/slide-transition-types.d.ts
-/** Resolved CSS `animation` shorthands for the two transition layers. */
-interface SlideTransitionAnimations {
-  /** CSS `animation` value for the outgoing (old) slide layer, or `'none'`. */
-  outgoing: string;
-  /** CSS `animation` value for the incoming (new) slide layer, or `'none'`. */
-  incoming: string;
-  /** Whether the outgoing layer should render above the incoming layer. */
-  outgoingOnTop: boolean;
-}
-/** The four cardinal directions a transition can resolve to. */
-type ResolvedDirection = 'left' | 'right' | 'up' | 'down';
-/** Cardinal directions plus the four diagonals (for cover/uncover/strips). */
-type ResolvedDirection8 = ResolvedDirection | 'lu' | 'ld' | 'ru' | 'rd';
-/** Map an OOXML `dir` token (`l`/`r`/`u`/`d`) to a cardinal direction. */
-declare function resolveDirection(direction: string | undefined, defaultDir: ResolvedDirection): ResolvedDirection;
-/** Map an OOXML `dir` token to a cardinal **or diagonal** direction. */
-declare function resolveDirection8(direction: string | undefined, defaultDir: ResolvedDirection): ResolvedDirection8;
-/** Resolve an orientation from the `orient` or `direction` attribute. */
-declare function resolveOrientation(direction: string | undefined, orient: string | undefined): 'horz' | 'vert';
-/** Transition types eligible for `random` selection (kept deterministic-light). */
-declare const RANDOM_ELIGIBLE_TYPES: readonly PptxTransitionType[];
-/** No-animation sentinel — used for `none`/`cut` (instant slide swap). */
-declare const INSTANT: SlideTransitionAnimations;
-/**
- * Default transition duration (ms) when the transition omits `durationMs`. This
- * is the React/Vue default consumed by `resolveSlideTransition`. The Angular
- * binding uses its own (smaller, floored) duration policy.
- */
-declare const DEFAULT_TRANSITION_DURATION_MS = 1000;
-/**
- * Default Morph duration (ms) for a transition that declares NEITHER an
- * explicit `p14:dur` (which lands in `durationMs` and always wins) NOR a legacy
- * `spd` speed (see {@link TRANSITION_SPEED_DURATION_MS}).
- *
- * A Morph that declares nothing carries no duration hint at all, and desktop
- * PowerPoint then plays it at its own 0.5s fallback (the Duration box shows
- * 0.50 for such slides and the transition measures at half a second); the
- * previous 1.0s/2.0s defaults made those decks play at double PowerPoint
- * speed.
- */
-declare const DEFAULT_MORPH_DURATION_MS = 500;
-/**
- * Duration (ms) for each legacy `p:transition/@spd` speed.
- *
- * Measured against PowerPoint itself: the issue #131 deck's morph slides carry
- * `spd="slow"` and no `p14:dur`, and PowerPoint reports
- * `SlideShowTransition.Duration = 1.0`. Re-authoring that attribute and
- * re-reading it through COM gives fast=0.5s, med=0.75s, slow=1.0s - and the
- * same values for Morph as for every other effect, contradicting the earlier
- * assumption that Morph ignores `spd`.
- */
-declare const TRANSITION_SPEED_DURATION_MS: Readonly<Record<string, number>>;
-/** Easing applied to every transition animation. */
-declare const EASE = "ease-in-out";
-/**
- * `p:wheel/@spokes` (CT_WheelTransition): PowerPoint's Wheel dialog offers
- * exactly these five spoke counts. Any other authored value (or absence, the
- * schema default) snaps to the nearest one so the keyframe lookup always
- * resolves to a real `pptx-tr-wheel-in-N` block.
- */
-declare const WHEEL_SPOKE_COUNTS: readonly number[];
-/** Resolve an authored `spokes` count to the nearest PowerPoint-offered value. */
-declare function resolveWheelSpokeCount(spokes: number | undefined): number;
-//#endregion
-//#region src/render/slide-transition-keyframes.d.ts
-/**
- * `slide-transition-keyframes` — the full `@keyframes` block backing every
- * resolved slide transition. Inject it once per overlay via a `<style>` element
- * (the same pattern the element-animation engine uses for
- * `ANIMATION_KEYFRAMES_CSS`).
- *
- * Keyframe names are `pptx-tr-*`-prefixed so they never collide with the
- * element-animation keyframes (`pptx-vue-*`) or the native-animation timeline
- * keyframes (`pptx-tl-*`).
- *
- * Both {@link SLIDE_TRANSITION_KEYFRAMES} and the `*_CSS` alias point at the
- * same string — the bindings historically exported it under both names, so the
- * alias preserves their public surface.
- *
- * The faithful Office 2010 (`p14`) keyframes are appended (via
- * {@link P14_TRANSITION_KEYFRAMES_ALL}) so the exotic / 3-D transitions routed
- * through `getP14TransitionAnimations` animate wherever this block is injected,
- * with no per-binding wiring. {@link FRAGMENT_TRANSITION_KEYFRAMES} is appended
- * last, backing the seven multi-fragment cinematic presets resolved by
- * `getFragmentedTransitionDescriptor` (`slide-transition-fragments.ts`).
- *
- * @module render/slide-transition-keyframes
- */
-/**
- * The full slide-transition `@keyframes` block: the classic set plus the
- * faithful Office 2010 (`p14`) keyframes, so both the classic and exotic / 3-D
- * transitions animate wherever this single string is injected.
- */
-declare const SLIDE_TRANSITION_KEYFRAMES: string;
-/**
- * Alias of {@link SLIDE_TRANSITION_KEYFRAMES} under the `_CSS` name the Vue
- * binding historically exported.
- */
-declare const SLIDE_TRANSITION_KEYFRAMES_CSS: string;
-//#endregion
-//#region src/render/slide-transition-css.d.ts
-/**
- * Map a {@link PptxTransitionType} (+ duration/direction/orient/spokes) to the
- * concrete CSS `animation` descriptors for the outgoing and incoming layers.
- *
- * Unknown types fall back to a symmetrical cross-fade.
- */
-declare function getSlideTransitionAnimations(type: PptxTransitionType, durationMs: number, direction: string | undefined, orient?: string | undefined, spokes?: number | undefined, pattern?: string | undefined): SlideTransitionAnimations;
-/**
- * Convenience wrapper that reads everything off a {@link PptxSlideTransition},
- * applying the React/Vue default duration when none is set. `none`/`cut` and a
- * transition with a non-positive duration resolve to {@link INSTANT}.
- */
-declare function resolveSlideTransition(transition: PptxSlideTransition | undefined): SlideTransitionAnimations;
-/**
- * The effective duration (ms) for a transition under the React/Vue policy — the
- * configured `durationMs`, or {@link DEFAULT_TRANSITION_DURATION_MS} when
- * unset/invalid. `none`/`cut` resolve to `0` (instant).
- */
-declare function resolveTransitionDurationMs(transition: PptxSlideTransition | undefined): number;
-/** Everything the Transitions tab's controls currently say. */
-interface RibbonTransitionDraft {
-  /** The highlighted gallery entry. */
-  type: PptxTransitionType;
-  /** Duration field, in seconds. */
-  durationSec: number;
-  /** Advance Slide > On Mouse Click. */
-  advanceOnClick: boolean;
-  /** Advance Slide > After (whether the timed advance is armed at all). */
-  advanceAfter: boolean;
-  /** Advance Slide > After, as the `mm:ss.hh` text the field holds. */
-  advanceAfterText: 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/toolbar-actions.d.ts
-/**
- * Toolbar action / ribbon-tab visibility: a single, framework-agnostic
- * catalogue of every top-level toolbar button and ribbon tab a host app can
- * independently hide. Each binding exposes a `hiddenActions?: ToolbarActionId[]`
- * prop, threads it down to the relevant render sites, and gates them with
- * `isActionHidden`. Default (`undefined` / `[]`) hides nothing, matching
- * today's always-visible behaviour.
- *
- * `TOOLBAR_TABS` is also the canonical ribbon-tab list/order, replacing the
- * copy hand-duplicated in each binding (React's `TOOLBAR_SECTIONS`, Vue's
- * `ribbon-constants.ts`, Angular's `RIBBON_TABS`, etc.) so the tab set can't
- * drift between bindings. Per-tab icons stay in each binding (icon libraries
- * differ per framework); only id + i18n key + order are shared here.
- */
-/**
- * A single toolbar button/control that can be hidden independently of the
- * ribbon tab it may also appear inside. `zoom` and `navigation` each cover a
- * 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' | '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;
-/**
- * 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/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/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';
-/** 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/editor-keymap.d.ts
-/** 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/options/viewer-options.d.ts
-/**
- * Full PowerPoint "File > Options" parity model.
- *
- * Groups mirror the ten categories of PowerPoint's Options dialog. Values are
- * flat primitives per group so the dialog panes can be rendered generically
- * from `VIEWER_OPTIONS_SCHEMA` in every binding. The legacy six-toggle
- * `ViewerPreferences` surface stays supported via the mapping helpers below.
- */
-type ScreenTipStyle = 'descriptions' | 'plain' | 'off';
-type DisplayOptimization = 'appearance' | 'compatibility';
-type ImageResolutionPreset = 'highFidelity' | 'ppi330' | 'ppi220' | 'ppi150' | 'ppi96';
-type OpenDocumentsView = 'savedView' | 'normal' | 'outline' | 'slideSorter' | 'notes';
-type DefaultExportFormat = 'pptx' | 'pdf' | 'png';
-type QuickAccessPosition = 'above' | 'below';
-type FeedbackSoundScheme = 'modern' | 'classic';
-type OptionsPrintWhat = 'slides' | 'handouts' | 'notes' | 'outline';
-type OptionsPrintColorMode = 'color' | 'grayscale' | 'blackAndWhite';
-interface ViewerGeneralOptions {
-  displayOptimization: DisplayOptimization;
-  showMiniToolbar: boolean;
-  enableLivePreview: boolean;
-  collapseRibbonAutomatically: boolean;
-  collapseSearchByDefault: boolean;
-  screenTipStyle: ScreenTipStyle;
-  userName: string;
-  userInitials: string;
-  showStartScreen: boolean;
-  /**
-   * Lets the user hand a local font file to the viewer so decks authored
-   * with a font the browser lacks render with the real face.
-   *
-   * Off by default. The registration reads a file the user picks and adds it
-   * to the page's font set for the session, which is a capability a host
-   * embedding the viewer should opt into rather than inherit.
-   */
-  enableCustomFontUpload: boolean;
-}
-interface ViewerProofingOptions {
-  autoCorrectTwoInitialCapitals: boolean;
-  autoCorrectCapitalizeFirstLetter: boolean;
-  autoCorrectCapitalizeDayNames: boolean;
-  autoCorrectSmartQuotes: boolean;
-  autoCorrectHyphensToDash: boolean;
-  autoCorrectFractions: boolean;
-  autoCorrectOrdinals: boolean;
-  ignoreUppercase: boolean;
-  ignoreWordsWithNumbers: boolean;
-  ignoreInternetAddresses: boolean;
-  flagRepeatedWords: boolean;
-  checkSpellingAsYouType: boolean;
-  hideSpellingErrors: boolean;
-}
-/**
- * File > Options > Save.
- *
- * Font embedding deliberately has NO entry here. It is owned by the File >
- * Fonts panel, whose toggle is the one the save path reads (see
- * `render/font-embedding`: `describeFontEmbedding` decides the toggle's start
- * position and whether it can do anything at all, `embeddedFontSaveOptions`
- * turns it into the `PptxHandler.save()` slice). This group used to carry a
- * second `embedFonts` boolean, plus an `embedAllFontCharacters` companion, and
- * neither was read by anything: the pane moved a switch that changed no saved
- * byte, while the panel next door moved the real one. Two switches for one
- * setting, one of them lying, is worse than one switch in a less
- * PowerPoint-shaped place.
- */
-interface ViewerSaveOptions {
-  autoSave: boolean;
-  autoRecoverIntervalMinutes: number;
-  keepLastAutoRecoveredVersion: boolean;
-  defaultExportFormat: DefaultExportFormat;
-  cacheRetentionDays: number;
-  clearCacheOnClose: boolean;
-}
-interface ViewerAccessibilityOptions {
-  /** Browser speech-recognition language; automatic follows the browser language. */
-  subtitleLanguage?: string;
-  showAccessibilityStatus: boolean;
-  feedbackWithSound: boolean;
-  soundScheme: FeedbackSoundScheme;
-  showShortcutKeysInScreenTips: boolean;
-  reducedMotion: boolean;
-}
-interface ViewerAdvancedOptions {
-  autoSelectEntireWord: boolean;
-  allowTextDragAndDrop: boolean;
-  maximumUndoSteps: number;
-  useSmartCutAndPaste: boolean;
-  showPasteOptionsButton: boolean;
-  imageDefaultResolution: ImageResolutionPreset;
-  doNotCompressImages: boolean;
-  chartPropertiesFollowDataPoint: boolean;
-  recentPresentationsCount: number;
-  showVerticalRuler: boolean;
-  showGrid: boolean;
-  snapToGrid: boolean;
-  disableHardwareAcceleration: boolean;
-  /**
-   * Force every opt-in interactive 3D scene (SmartArt, bar/line/area/pie/
-   * surface charts) to fall back to its flat 2D rendering, even when the
-   * host has enabled that scene via its own `smartArt3D`/`*Chart3D` prop.
-   * A host opting in says "this deck may want 3D"; this is the viewer
-   * user's own override for when the WebGL scenes it renders are too much
-   * for their machine. See `resolve3DRenderingFlags`.
-   */
-  disable3DRendering: boolean;
-  /**
-   * `p:animEffect/@filter="pixelate"` defaults to snapping the element to
-   * its end state (`cutIn`/`cutOut`), matching PowerPoint's own behaviour
-   * (COM `CreateVideo` frame-diffing shows PowerPoint performs no animation
-   * at all for this filter value). This turns on the blocky mosaic reveal
-   * this renderer can build instead, for a viewer that would rather show
-   * something animating than PowerPoint's own instant swap. See
-   * `resolveFilterEffect` in `animation-filter-effects.ts` and
-   * `docs/guide/visual-effects.md`.
-   */
-  pixelateMosaicAnimation: boolean;
-  openDocumentsView: OpenDocumentsView;
-  slideShowShowMenuOnRightClick: boolean;
-  slideShowShowPopupToolbar: boolean;
-  slideShowPromptKeepInkAnnotations: boolean;
-  slideShowEndWithBlackSlide: boolean;
-  printInBackground: boolean;
-  printHighQuality: boolean;
-  printUseMostRecentSettings: boolean;
-  printWhat: OptionsPrintWhat;
-  printColorMode: OptionsPrintColorMode;
-  printHiddenSlides: boolean;
-  printScaleToFit: boolean;
-  printFrameSlides: boolean;
-}
-interface ViewerRibbonOptions {
-  /** Ribbon tabs unticked in Customize Ribbon. The File tab can never be hidden. */
-  hiddenTabIds: ToolbarTabId[];
-}
-interface ViewerQuickAccessOptions {
-  visible: boolean;
-  position: QuickAccessPosition;
-  showCommandLabels: boolean;
-  /** Ordered ids from `QUICK_ACCESS_COMMAND_CATALOG`. */
-  commandIds: string[];
-}
-interface ViewerTrustOptions {
-  openInProtectedView: boolean;
-  allowExternalContent: boolean;
-  confirmExternalHyperlinks: boolean;
-}
-interface ViewerOptions {
-  general: ViewerGeneralOptions;
-  proofing: ViewerProofingOptions;
-  save: ViewerSaveOptions;
-  accessibility: ViewerAccessibilityOptions;
-  advanced: ViewerAdvancedOptions;
-  ribbon: ViewerRibbonOptions;
-  quickAccess: ViewerQuickAccessOptions;
-  trust: ViewerTrustOptions;
-}
-type ViewerOptionsGroupId = keyof ViewerOptions;
-type ViewerOptionPrimitive = boolean | number | string;
-//#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/host-menu-commands.d.ts
-/** Snapshot of the slide on which the host command was offered. */
-interface HostCanvasMenuContext {
-  slideIndex: number;
-}
-/** Effective selection, including a single right-clicked element. */
-interface HostElementMenuContext extends HostCanvasMenuContext {
-  elementIds: readonly string[];
-}
-/** Plain text labels work identically in every framework. */
-interface HostMenuCommand<C> {
-  id: string;
-  label: string;
-  /** Default: a separate group above the built-in commands. */
-  group?: 'top' | 'bottom';
-  disabled?: boolean | ((context: C) => boolean);
-  onSelect: (context: C) => void;
-}
-//#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 freeform: 'Freeform';
-        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 language: 'Language';
-      };
-    };
-    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 adjust: {
-      readonly label: 'Adjust';
-      readonly controls: {
-        readonly corrections: 'Corrections gallery';
-        readonly color: 'Color gallery';
-        readonly artisticEffects: 'Artistic Effects gallery';
-      };
-    };
-    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 createGraphic: {
-      readonly label: 'Create Graphic';
-      readonly controls: {
-        readonly addShape: 'Add Shape';
-        readonly addBullet: 'Add Bullet';
-        readonly textPane: 'Text Pane';
-        readonly promote: 'Promote';
-        readonly demote: 'Demote';
-        readonly rightToLeft: 'Right to Left';
-        readonly moveUp: 'Move Up';
-        readonly moveDown: 'Move Down';
-      };
-    };
-    readonly layouts: {
-      readonly label: 'Layouts';
-      readonly controls: {
-        readonly gallery: 'Layouts gallery';
-      };
-    };
-    readonly smartArtStyles: {
-      readonly label: 'SmartArt Styles';
-      readonly controls: {
-        readonly changeColors: 'Change Colors gallery';
-        readonly gallery: 'SmartArt Styles gallery';
-      };
-    };
-    readonly reset: {
-      readonly label: 'Reset';
-      readonly controls: {
-        readonly resetGraphic: 'Reset Graphic';
-        readonly convert: 'Convert';
-      };
-    };
-  };
-};
-//#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;
-/**
- * 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),
-   * 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 {
-  /** 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 {
-  /** Additional host commands, independent of the viewer's AI connection. */
-  extraElementCommands?: readonly HostMenuCommand<HostElementMenuContext>[];
-  extraCanvasCommands?: readonly HostMenuCommand<HostCanvasMenuContext>[];
-  /** 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/customization/customization-catalog.d.ts
-declare const RIBBON_TAB_IDS: readonly ToolbarTabId[];
-declare const TOOLBAR_BUTTON_IDS: readonly ["share", "broadcast", "export", "undo", "redo", "record", "notes", "fullscreen", "zoom", "navigation", "mergeShapes", "crop"];
-declare const OPTIONS_PAGE_IDS: readonly OptionsPageId[];
-declare const OPTIONS_SECTION_IDS: readonly OptionsSectionId[];
-declare const OPTIONS_SETTING_IDS: readonly OptionsSettingId[];
-declare const BACKSTAGE_PAGE_IDS: readonly BackstagePage[];
-declare const BACKSTAGE_CARD_IDS: readonly BackstageCardId[];
-declare const ELEMENT_CONTEXT_MENU_COMMAND_IDS: readonly ["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", "merge-union", "merge-combine", "merge-fragment", "merge-intersect", "merge-subtract", "save-as-picture", "edit-alt-text", "size-and-position", "format-shape", "delete"];
-declare const CANVAS_CONTEXT_MENU_COMMAND_IDS: readonly ["paste", "layout", "reset-slide", "format-background", "grid-and-guides", "ruler"];
-declare const EDITOR_SHORTCUT_ACTION_IDS: readonly ["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"];
-declare const VIEWER_PANEL_IDS: readonly ["statusBar", "slidesPane", "inspector", "notes", "quickAccessToolbar", "titleBar"];
-declare const VIEWER_FEATURE_IDS: readonly ["ai", "collaboration", "comments", "presentMode", "editPoints"];
-declare const VIEWER_DIALOG_IDS: readonly ["options", "share", "broadcast", "print", "export"];
-declare const VIEWER_EXPORT_FORMAT_IDS: readonly ["pdf", "png", "video", "gif", "json", "copyImage"];
-//#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>;
-  /** 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>;
-  lockedSettings: OptionsSettingValues;
-  defaultSettings: OptionsSettingValues;
-  hiddenBackstagePages: ReadonlySet<BackstagePage>;
-  hiddenBackstageCards: ReadonlySet<BackstageCardId>;
-  hiddenElementCommands: ReadonlySet<ContextMenuCommandId>;
-  extraElementCommands: NonNullable<ViewerCustomization['contextMenu']>['extraElementCommands'];
-  extraCanvasCommands: NonNullable<ViewerCustomization['contextMenu']>['extraCanvasCommands'];
-  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;
-  /** 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;
-  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;
-}
-interface ViewerCustomizationController {
-  /** The helper methods, ready to spread onto a component handle. */
-  readonly api: ViewerCustomizationApi;
-  /** The normalised view the render sites read. Stable until the next change. */
-  getResolved(): ResolvedCustomization;
-  /** Subscribe to every change; returns the unsubscribe function. */
-  subscribe(listener: () => void): () => void;
-}
-//#endregion
-//#region src/render/ribbon-command-view.d.ts
-/** A host supplies translated labels and controlled state; shared owns markup. */
-interface RibbonCommandView {
-  id: RibbonControlId;
-  label: string;
-  icon: string;
-  title?: string;
-  disabled?: boolean;
-  active?: boolean;
-  pressed?: boolean;
-  expanded?: boolean;
-  hidden?: boolean;
-  compact?: boolean;
-  /** Opens a menu or panel: draws PowerPoint's drop-down chevron after the label. */
-  caret?: boolean;
-  badge?: number;
-  /** Commands with the same column share a vertical stack. */
-  column?: number;
-}
-interface RibbonGroupView {
-  id: RibbonGroupId;
-  label: string;
-  commands: readonly RibbonCommandView[];
-}
-//#endregion
-//#region src/render/p14-transition-keyframes.d.ts
-/** Part 1: conveyor / doors / ferris / flash / flythrough / gallery / glitter / honeycomb / pan. */
-declare const P14_TRANSITION_KEYFRAMES = "\n/* ── Conveyor (translate X with staggered timing) ──────────────────── */\n@keyframes pptx-tr-conveyor-in-from-right {\n\tfrom { transform: translateX(100%) rotateY(-30deg); }\n\t60%  { transform: translateX(20%) rotateY(-10deg); }\n\tto   { transform: translateX(0) rotateY(0deg); }\n}\n@keyframes pptx-tr-conveyor-out-to-left {\n\tfrom { transform: translateX(0) rotateY(0deg); }\n\t40%  { transform: translateX(-20%) rotateY(10deg); }\n\tto   { transform: translateX(-100%) rotateY(30deg); }\n}\n@keyframes pptx-tr-conveyor-in-from-left {\n\tfrom { transform: translateX(-100%) rotateY(30deg); }\n\t60%  { transform: translateX(-20%) rotateY(10deg); }\n\tto   { transform: translateX(0) rotateY(0deg); }\n}\n@keyframes pptx-tr-conveyor-out-to-right {\n\tfrom { transform: translateX(0) rotateY(0deg); }\n\t40%  { transform: translateX(20%) rotateY(-10deg); }\n\tto   { transform: translateX(100%) rotateY(-30deg); }\n}\n\n/* ── Doors (clip-path from center split) ──────────────────────────────\n   MEASURED via COM CreateVideo: PowerPoint's `dir=\"horz\"` names a\n   HORIZONTAL split line (two panels stacked top/bottom, opening upward and\n   downward), and `dir=\"vert\"` a VERTICAL split line (panels side by side,\n   opening left and right) - the opposite of what \"clips left/right\" vs\n   \"clips top/bottom\" would suggest at a glance. Keep the clip-path bodies\n   matched to the MEASURED direction, not the intuitive one. */\n@keyframes pptx-tr-doors-horz {\n\tfrom { clip-path: inset(50% 0); }\n\tto   { clip-path: inset(0 0); }\n}\n@keyframes pptx-tr-doors-vert {\n\tfrom { clip-path: inset(0 50%); }\n\tto   { clip-path: inset(0 0); }\n}\n\n/* ── Ferris (rotate elements around center) ───────────────────────── */\n@keyframes pptx-tr-ferris-in-from-right {\n\tfrom { transform: translateX(80%) rotate(45deg) scale(0.6); opacity: 0; }\n\tto   { transform: translateX(0) rotate(0deg) scale(1); opacity: 1; }\n}\n@keyframes pptx-tr-ferris-out-to-left {\n\tfrom { transform: translateX(0) rotate(0deg) scale(1); opacity: 1; }\n\tto   { transform: translateX(-80%) rotate(-45deg) scale(0.6); opacity: 0; }\n}\n@keyframes pptx-tr-ferris-in-from-left {\n\tfrom { transform: translateX(-80%) rotate(-45deg) scale(0.6); opacity: 0; }\n\tto   { transform: translateX(0) rotate(0deg) scale(1); opacity: 1; }\n}\n@keyframes pptx-tr-ferris-out-to-right {\n\tfrom { transform: translateX(0) rotate(0deg) scale(1); opacity: 1; }\n\tto   { transform: translateX(80%) rotate(45deg) scale(0.6); opacity: 0; }\n}\n\n/* ── Flash (bright flash opacity burst) ──────────────────────────── */\n@keyframes pptx-tr-flash-white {\n\t0%   { opacity: 1; }\n\t30%  { opacity: 0; }\n\t50%  { opacity: 0; }\n\t100% { opacity: 1; }\n}\n@keyframes pptx-tr-flash-in {\n\t0%   { opacity: 0; }\n\t50%  { opacity: 0; }\n\t70%  { opacity: 1; }\n\t100% { opacity: 1; }\n}\n\n/* ── Flythrough (scale + translate Z-axis feel) ──────────────────── */\n@keyframes pptx-tr-flythrough-in {\n\tfrom { transform: scale(4) translateZ(200px); opacity: 0; filter: blur(8px); }\n\tto   { transform: scale(1) translateZ(0); opacity: 1; filter: blur(0); }\n}\n@keyframes pptx-tr-flythrough-out {\n\tfrom { transform: scale(1) translateZ(0); opacity: 1; filter: blur(0); }\n\tto   { transform: scale(0.1) translateZ(-200px); opacity: 0; filter: blur(8px); }\n}\n@keyframes pptx-tr-flythrough-reverse-in {\n\tfrom { transform: scale(0.1) translateZ(-200px); opacity: 0; filter: blur(8px); }\n\tto   { transform: scale(1) translateZ(0); opacity: 1; filter: blur(0); }\n}\n@keyframes pptx-tr-flythrough-reverse-out {\n\tfrom { transform: scale(1) translateZ(0); opacity: 1; filter: blur(0); }\n\tto   { transform: scale(4) translateZ(200px); opacity: 0; filter: blur(8px); }\n}\n\n/* ── Gallery (translate with perspective) ─────────────────────────── */\n@keyframes pptx-tr-gallery-in-from-right {\n\tfrom { transform: perspective(800px) translateX(100%) rotateY(-45deg); opacity: 0.5; }\n\tto   { transform: perspective(800px) translateX(0) rotateY(0deg); opacity: 1; }\n}\n@keyframes pptx-tr-gallery-out-to-left {\n\tfrom { transform: perspective(800px) translateX(0) rotateY(0deg); opacity: 1; }\n\tto   { transform: perspective(800px) translateX(-100%) rotateY(45deg); opacity: 0.5; }\n}\n@keyframes pptx-tr-gallery-in-from-left {\n\tfrom { transform: perspective(800px) translateX(-100%) rotateY(45deg); opacity: 0.5; }\n\tto   { transform: perspective(800px) translateX(0) rotateY(0deg); opacity: 1; }\n}\n@keyframes pptx-tr-gallery-out-to-right {\n\tfrom { transform: perspective(800px) translateX(0) rotateY(0deg); opacity: 1; }\n\tto   { transform: perspective(800px) translateX(100%) rotateY(-45deg); opacity: 0.5; }\n}\n\n/* ── Glitter (particle dissolve effect) ──────────────────────────── */\n@keyframes pptx-tr-glitter-in {\n\tfrom { opacity: 0; filter: brightness(1.5) contrast(1.3) blur(2px); }\n\t60%  { opacity: 0.7; filter: brightness(1.2) contrast(1.1) blur(1px); }\n\tto   { opacity: 1; filter: brightness(1) contrast(1) blur(0); }\n}\n\n/* ── Honeycomb (hexagonal reveal) ────────────────────────────────── */\n@keyframes pptx-tr-honeycomb-in {\n\tfrom {\n\t\tclip-path: polygon(50% 50%, 50% 50%, 50% 50%, 50% 50%, 50% 50%, 50% 50%);\n\t\topacity: 0;\n\t}\n\tto {\n\t\tclip-path: polygon(50% 0%, 100% 25%, 100% 75%, 50% 100%, 0% 75%, 0% 25%);\n\t\topacity: 1;\n\t}\n}\n@keyframes pptx-tr-honeycomb-out {\n\tfrom { opacity: 1; }\n\tto   { opacity: 0; filter: blur(2px); }\n}\n\n/* ── Pan (large-scale translate) ─────────────────────────────────── */\n@keyframes pptx-tr-pan-from-right {\n\tfrom { transform: translateX(100%); }\n\tto   { transform: translateX(0); }\n}\n@keyframes pptx-tr-pan-to-left {\n\tfrom { transform: translateX(0); }\n\tto   { transform: translateX(-100%); }\n}\n@keyframes pptx-tr-pan-from-left {\n\tfrom { transform: translateX(-100%); }\n\tto   { transform: translateX(0); }\n}\n@keyframes pptx-tr-pan-to-right {\n\tfrom { transform: translateX(0); }\n\tto   { transform: translateX(100%); }\n}\n@keyframes pptx-tr-pan-from-bottom {\n\tfrom { transform: translateY(100%); }\n\tto   { transform: translateY(0); }\n}\n@keyframes pptx-tr-pan-to-top {\n\tfrom { transform: translateY(0); }\n\tto   { transform: translateY(-100%); }\n}\n@keyframes pptx-tr-pan-from-top {\n\tfrom { transform: translateY(-100%); }\n\tto   { transform: translateY(0); }\n}\n@keyframes pptx-tr-pan-to-bottom {\n\tfrom { transform: translateY(0); }\n\tto   { transform: translateY(100%); }\n}\n";
-/** Part 2: prism / reveal / ripple / shred / switch / vortex / warp / wheelReverse / window. */
-declare const P14_TRANSITION_KEYFRAMES_2 = "\n/* ── Prism: see `slide-transition-prism` (split out to keep this module\n   under the per-file LOC budget) ─────────────────────────────────────── */\n\n@keyframes pptx-tr-prism-in-from-right {\n\tfrom { transform: perspective(800px) rotateY(-90deg) translateX(50%); opacity: 0; }\n\tto   { transform: perspective(800px) rotateY(0deg) translateX(0); opacity: 1; }\n}\n@keyframes pptx-tr-prism-out-to-left {\n\tfrom { transform: perspective(800px) rotateY(0deg) translateX(0); opacity: 1; }\n\tto   { transform: perspective(800px) rotateY(90deg) translateX(-50%); opacity: 0; }\n}\n@keyframes pptx-tr-prism-in-from-left {\n\tfrom { transform: perspective(800px) rotateY(90deg) translateX(-50%); opacity: 0; }\n\tto   { transform: perspective(800px) rotateY(0deg) translateX(0); opacity: 1; }\n}\n@keyframes pptx-tr-prism-out-to-right {\n\tfrom { transform: perspective(800px) rotateY(0deg) translateX(0); opacity: 1; }\n\tto   { transform: perspective(800px) rotateY(-90deg) translateX(50%); opacity: 0; }\n}\n@keyframes pptx-tr-prism-in-from-bottom {\n\tfrom { transform: perspective(800px) rotateX(90deg) translateY(50%); opacity: 0; }\n\tto   { transform: perspective(800px) rotateX(0deg) translateY(0); opacity: 1; }\n}\n@keyframes pptx-tr-prism-out-to-top {\n\tfrom { transform: perspective(800px) rotateX(0deg) translateY(0); opacity: 1; }\n\tto   { transform: perspective(800px) rotateX(-90deg) translateY(-50%); opacity: 0; }\n}\n@keyframes pptx-tr-prism-in-from-top {\n\tfrom { transform: perspective(800px) rotateX(-90deg) translateY(-50%); opacity: 0; }\n\tto   { transform: perspective(800px) rotateX(0deg) translateY(0); opacity: 1; }\n}\n@keyframes pptx-tr-prism-out-to-bottom {\n\tfrom { transform: perspective(800px) rotateX(0deg) translateY(0); opacity: 1; }\n\tto   { transform: perspective(800px) rotateX(90deg) translateY(50%); opacity: 0; }\n}\n\n/* ── Reveal (slide away reveal) ──────────────────────────────────── */\n@keyframes pptx-tr-reveal-out-to-right {\n\tfrom { transform: translateX(0); }\n\tto   { transform: translateX(100%); }\n}\n@keyframes pptx-tr-reveal-out-to-left {\n\tfrom { transform: translateX(0); }\n\tto   { transform: translateX(-100%); }\n}\n/* MEASURED: the incoming layer stays hidden for roughly the first half of the\n   transition (a real black/background gap shows through), then fades in -\n   not a flat 0.5->1 fade running the whole duration. */\n@keyframes pptx-tr-reveal-in {\n\t0%   { opacity: 0; }\n\t50%  { opacity: 0; }\n\t100% { opacity: 1; }\n}\n\n/* ── Ripple (expanding ring clip-path) ───────────────────────────── */\n@keyframes pptx-tr-ripple-in {\n\tfrom { clip-path: circle(0% at 50% 50%); opacity: 0.5; }\n\t30%  { clip-path: circle(20% at 50% 50%); opacity: 0.7; }\n\t60%  { clip-path: circle(50% at 50% 50%); opacity: 0.9; }\n\tto   { clip-path: circle(75% at 50% 50%); opacity: 1; }\n}\n\n/* ── Shred (fragmented clip-path pieces) ─────────────────────────── */\n@keyframes pptx-tr-shred-strips-in {\n\tfrom { clip-path: inset(0 100% 0 0); opacity: 0; }\n\t30%  { clip-path: inset(0 60% 0 0); opacity: 0.5; }\n\tto   { clip-path: inset(0); opacity: 1; }\n}\n@keyframes pptx-tr-shred-rectangles-in {\n\tfrom { clip-path: inset(50%); opacity: 0; }\n\t40%  { clip-path: inset(20%); opacity: 0.6; }\n\tto   { clip-path: inset(0); opacity: 1; }\n}\n@keyframes pptx-tr-shred-out {\n\tfrom { opacity: 1; }\n\tto   { opacity: 0; filter: blur(2px); }\n}\n\n/* ── Switch (flip/rotate swap) ───────────────────────────────────── */\n@keyframes pptx-tr-switch-in-from-right {\n\tfrom { transform: perspective(800px) rotateY(-180deg); opacity: 0; }\n\tto   { transform: perspective(800px) rotateY(0deg); opacity: 1; }\n}\n@keyframes pptx-tr-switch-out-to-left {\n\tfrom { transform: perspective(800px) rotateY(0deg); opacity: 1; }\n\tto   { transform: perspective(800px) rotateY(180deg); opacity: 0; }\n}\n@keyframes pptx-tr-switch-in-from-left {\n\tfrom { transform: perspective(800px) rotateY(180deg); opacity: 0; }\n\tto   { transform: perspective(800px) rotateY(0deg); opacity: 1; }\n}\n@keyframes pptx-tr-switch-out-to-right {\n\tfrom { transform: perspective(800px) rotateY(0deg); opacity: 1; }\n\tto   { transform: perspective(800px) rotateY(-180deg); opacity: 0; }\n}\n\n/* ── Vortex (rotate + scale spiral) ──────────────────────────────── */\n@keyframes pptx-tr-vortex-in {\n\tfrom { transform: rotate(720deg) scale(0); opacity: 0; }\n\tto   { transform: rotate(0deg) scale(1); opacity: 1; }\n}\n@keyframes pptx-tr-vortex-out {\n\tfrom { transform: rotate(0deg) scale(1); opacity: 1; }\n\tto   { transform: rotate(-720deg) scale(0); opacity: 0; }\n}\n\n/* ── Warp: see `slide-transition-warp` (COM-measured radial zoom blur,\n   split out to keep this module under the per-file LOC budget) ────────── */\n\n@keyframes pptx-tr-warp-in {\n\t0%   { transform: scale(0.25); opacity: 0; filter: blur(10px) brightness(1.8); }\n\t50%  { transform: scale(0.85); opacity: 0.7; filter: blur(3px) brightness(1.3); }\n\t100% { transform: scale(1); opacity: 1; filter: blur(0) brightness(1); }\n}\n@keyframes pptx-tr-warp-out {\n\t0%   { transform: scale(1); opacity: 1; filter: blur(0) brightness(1); }\n\t50%  { transform: scale(0.85); opacity: 0.7; filter: blur(3px) brightness(1.3); }\n\t100% { transform: scale(0.25); opacity: 0; filter: blur(10px) brightness(1.8); }\n}\n@keyframes pptx-tr-warp-reverse-in {\n\t0%   { transform: scale(3.2); opacity: 0; filter: blur(14px) brightness(2.2); }\n\t50%  { transform: scale(1.7); opacity: 0.7; filter: blur(6px) brightness(1.5); }\n\t100% { transform: scale(1); opacity: 1; filter: blur(0) brightness(1); }\n}\n@keyframes pptx-tr-warp-reverse-out {\n\t0%   { transform: scale(1); opacity: 1; filter: blur(0) brightness(1); }\n\t50%  { transform: scale(1.7); opacity: 0.7; filter: blur(6px) brightness(1.5); }\n\t100% { transform: scale(3.2); opacity: 0; filter: blur(14px) brightness(2.2); }\n}\n\n\n/* ── WheelReverse (reverse wheel rotation) ───────────────────────── */\n@keyframes pptx-tr-wheel-reverse-in {\n\tfrom { clip-path: circle(0% at 50% 50%); transform: rotate(180deg); }\n\tto   { clip-path: circle(75% at 50% 50%); transform: rotate(0deg); }\n}\n\n/* ── Window (scale from center with border) ──────────────────────────\n   Same measured horz/vert meaning as Doors above (horz = horizontal split\n   line opening vertically; vert = vertical split line opening horizontally). */\n@keyframes pptx-tr-window-horz {\n\tfrom { clip-path: inset(50% 0); }\n\tto   { clip-path: inset(0 0); }\n}\n@keyframes pptx-tr-window-vert {\n\tfrom { clip-path: inset(0 50%); }\n\tto   { clip-path: inset(0 0); }\n}\n@keyframes pptx-tr-window-out {\n\tfrom { opacity: 1; transform: scale(1); }\n\tto   { opacity: 0; transform: scale(0.9); }\n}\n";
-/** Both p14 keyframe blocks concatenated, for single `<style>` injection. */
-declare const P14_TRANSITION_KEYFRAMES_ALL = "\n/* ── Conveyor (translate X with staggered timing) ──────────────────── */\n@keyframes pptx-tr-conveyor-in-from-right {\n\tfrom { transform: translateX(100%) rotateY(-30deg); }\n\t60%  { transform: translateX(20%) rotateY(-10deg); }\n\tto   { transform: translateX(0) rotateY(0deg); }\n}\n@keyframes pptx-tr-conveyor-out-to-left {\n\tfrom { transform: translateX(0) rotateY(0deg); }\n\t40%  { transform: translateX(-20%) rotateY(10deg); }\n\tto   { transform: translateX(-100%) rotateY(30deg); }\n}\n@keyframes pptx-tr-conveyor-in-from-left {\n\tfrom { transform: translateX(-100%) rotateY(30deg); }\n\t60%  { transform: translateX(-20%) rotateY(10deg); }\n\tto   { transform: translateX(0) rotateY(0deg); }\n}\n@keyframes pptx-tr-conveyor-out-to-right {\n\tfrom { transform: translateX(0) rotateY(0deg); }\n\t40%  { transform: translateX(20%) rotateY(-10deg); }\n\tto   { transform: translateX(100%) rotateY(-30deg); }\n}\n\n/* ── Doors (clip-path from center split) ──────────────────────────────\n   MEASURED via COM CreateVideo: PowerPoint's `dir=\"horz\"` names a\n   HORIZONTAL split line (two panels stacked top/bottom, opening upward and\n   downward), and `dir=\"vert\"` a VERTICAL split line (panels side by side,\n   opening left and right) - the opposite of what \"clips left/right\" vs\n   \"clips top/bottom\" would suggest at a glance. Keep the clip-path bodies\n   matched to the MEASURED direction, not the intuitive one. */\n@keyframes pptx-tr-doors-horz {\n\tfrom { clip-path: inset(50% 0); }\n\tto   { clip-path: inset(0 0); }\n}\n@keyframes pptx-tr-doors-vert {\n\tfrom { clip-path: inset(0 50%); }\n\tto   { clip-path: inset(0 0); }\n}\n\n/* ── Ferris (rotate elements around center) ───────────────────────── */\n@keyframes pptx-tr-ferris-in-from-right {\n\tfrom { transform: translateX(80%) rotate(45deg) scale(0.6); opacity: 0; }\n\tto   { transform: translateX(0) rotate(0deg) scale(1); opacity: 1; }\n}\n@keyframes pptx-tr-ferris-out-to-left {\n\tfrom { transform: translateX(0) rotate(0deg) scale(1); opacity: 1; }\n\tto   { transform: translateX(-80%) rotate(-45deg) scale(0.6); opacity: 0; }\n}\n@keyframes pptx-tr-ferris-in-from-left {\n\tfrom { transform: translateX(-80%) rotate(-45deg) scale(0.6); opacity: 0; }\n\tto   { transform: translateX(0) rotate(0deg) scale(1); opacity: 1; }\n}\n@keyframes pptx-tr-ferris-out-to-right {\n\tfrom { transform: translateX(0) rotate(0deg) scale(1); opacity: 1; }\n\tto   { transform: translateX(80%) rotate(45deg) scale(0.6); opacity: 0; }\n}\n\n/* ── Flash (bright flash opacity burst) ──────────────────────────── */\n@keyframes pptx-tr-flash-white {\n\t0%   { opacity: 1; }\n\t30%  { opacity: 0; }\n\t50%  { opacity: 0; }\n\t100% { opacity: 1; }\n}\n@keyframes pptx-tr-flash-in {\n\t0%   { opacity: 0; }\n\t50%  { opacity: 0; }\n\t70%  { opacity: 1; }\n\t100% { opacity: 1; }\n}\n\n/* ── Flythrough (scale + translate Z-axis feel) ──────────────────── */\n@keyframes pptx-tr-flythrough-in {\n\tfrom { transform: scale(4) translateZ(200px); opacity: 0; filter: blur(8px); }\n\tto   { transform: scale(1) translateZ(0); opacity: 1; filter: blur(0); }\n}\n@keyframes pptx-tr-flythrough-out {\n\tfrom { transform: scale(1) translateZ(0); opacity: 1; filter: blur(0); }\n\tto   { transform: scale(0.1) translateZ(-200px); opacity: 0; filter: blur(8px); }\n}\n@keyframes pptx-tr-flythrough-reverse-in {\n\tfrom { transform: scale(0.1) translateZ(-200px); opacity: 0; filter: blur(8px); }\n\tto   { transform: scale(1) translateZ(0); opacity: 1; filter: blur(0); }\n}\n@keyframes pptx-tr-flythrough-reverse-out {\n\tfrom { transform: scale(1) translateZ(0); opacity: 1; filter: blur(0); }\n\tto   { transform: scale(4) translateZ(200px); opacity: 0; filter: blur(8px); }\n}\n\n/* ── Gallery (translate with perspective) ─────────────────────────── */\n@keyframes pptx-tr-gallery-in-from-right {\n\tfrom { transform: perspective(800px) translateX(100%) rotateY(-45deg); opacity: 0.5; }\n\tto   { transform: perspective(800px) translateX(0) rotateY(0deg); opacity: 1; }\n}\n@keyframes pptx-tr-gallery-out-to-left {\n\tfrom { transform: perspective(800px) translateX(0) rotateY(0deg); opacity: 1; }\n\tto   { transform: perspective(800px) translateX(-100%) rotateY(45deg); opacity: 0.5; }\n}\n@keyframes pptx-tr-gallery-in-from-left {\n\tfrom { transform: perspective(800px) translateX(-100%) rotateY(45deg); opacity: 0.5; }\n\tto   { transform: perspective(800px) translateX(0) rotateY(0deg); opacity: 1; }\n}\n@keyframes pptx-tr-gallery-out-to-right {\n\tfrom { transform: perspective(800px) translateX(0) rotateY(0deg); opacity: 1; }\n\tto   { transform: perspective(800px) translateX(100%) rotateY(-45deg); opacity: 0.5; }\n}\n\n/* ── Glitter (particle dissolve effect) ──────────────────────────── */\n@keyframes pptx-tr-glitter-in {\n\tfrom { opacity: 0; filter: brightness(1.5) contrast(1.3) blur(2px); }\n\t60%  { opacity: 0.7; filter: brightness(1.2) contrast(1.1) blur(1px); }\n\tto   { opacity: 1; filter: brightness(1) contrast(1) blur(0); }\n}\n\n/* ── Honeycomb (hexagonal reveal) ────────────────────────────────── */\n@keyframes pptx-tr-honeycomb-in {\n\tfrom {\n\t\tclip-path: polygon(50% 50%, 50% 50%, 50% 50%, 50% 50%, 50% 50%, 50% 50%);\n\t\topacity: 0;\n\t}\n\tto {\n\t\tclip-path: polygon(50% 0%, 100% 25%, 100% 75%, 50% 100%, 0% 75%, 0% 25%);\n\t\topacity: 1;\n\t}\n}\n@keyframes pptx-tr-honeycomb-out {\n\tfrom { opacity: 1; }\n\tto   { opacity: 0; filter: blur(2px); }\n}\n\n/* ── Pan (large-scale translate) ─────────────────────────────────── */\n@keyframes pptx-tr-pan-from-right {\n\tfrom { transform: translateX(100%); }\n\tto   { transform: translateX(0); }\n}\n@keyframes pptx-tr-pan-to-left {\n\tfrom { transform: translateX(0); }\n\tto   { transform: translateX(-100%); }\n}\n@keyframes pptx-tr-pan-from-left {\n\tfrom { transform: translateX(-100%); }\n\tto   { transform: translateX(0); }\n}\n@keyframes pptx-tr-pan-to-right {\n\tfrom { transform: translateX(0); }\n\tto   { transform: translateX(100%); }\n}\n@keyframes pptx-tr-pan-from-bottom {\n\tfrom { transform: translateY(100%); }\n\tto   { transform: translateY(0); }\n}\n@keyframes pptx-tr-pan-to-top {\n\tfrom { transform: translateY(0); }\n\tto   { transform: translateY(-100%); }\n}\n@keyframes pptx-tr-pan-from-top {\n\tfrom { transform: translateY(-100%); }\n\tto   { transform: translateY(0); }\n}\n@keyframes pptx-tr-pan-to-bottom {\n\tfrom { transform: translateY(0); }\n\tto   { transform: translateY(100%); }\n}\n\n\n/* ── Prism: see `slide-transition-prism` (split out to keep this module\n   under the per-file LOC budget) ─────────────────────────────────────── */\n\n@keyframes pptx-tr-prism-in-from-right {\n\tfrom { transform: perspective(800px) rotateY(-90deg) translateX(50%); opacity: 0; }\n\tto   { transform: perspective(800px) rotateY(0deg) translateX(0); opacity: 1; }\n}\n@keyframes pptx-tr-prism-out-to-left {\n\tfrom { transform: perspective(800px) rotateY(0deg) translateX(0); opacity: 1; }\n\tto   { transform: perspective(800px) rotateY(90deg) translateX(-50%); opacity: 0; }\n}\n@keyframes pptx-tr-prism-in-from-left {\n\tfrom { transform: perspective(800px) rotateY(90deg) translateX(-50%); opacity: 0; }\n\tto   { transform: perspective(800px) rotateY(0deg) translateX(0); opacity: 1; }\n}\n@keyframes pptx-tr-prism-out-to-right {\n\tfrom { transform: perspective(800px) rotateY(0deg) translateX(0); opacity: 1; }\n\tto   { transform: perspective(800px) rotateY(-90deg) translateX(50%); opacity: 0; }\n}\n@keyframes pptx-tr-prism-in-from-bottom {\n\tfrom { transform: perspective(800px) rotateX(90deg) translateY(50%); opacity: 0; }\n\tto   { transform: perspective(800px) rotateX(0deg) translateY(0); opacity: 1; }\n}\n@keyframes pptx-tr-prism-out-to-top {\n\tfrom { transform: perspective(800px) rotateX(0deg) translateY(0); opacity: 1; }\n\tto   { transform: perspective(800px) rotateX(-90deg) translateY(-50%); opacity: 0; }\n}\n@keyframes pptx-tr-prism-in-from-top {\n\tfrom { transform: perspective(800px) rotateX(-90deg) translateY(-50%); opacity: 0; }\n\tto   { transform: perspective(800px) rotateX(0deg) translateY(0); opacity: 1; }\n}\n@keyframes pptx-tr-prism-out-to-bottom {\n\tfrom { transform: perspective(800px) rotateX(0deg) translateY(0); opacity: 1; }\n\tto   { transform: perspective(800px) rotateX(90deg) translateY(50%); opacity: 0; }\n}\n\n/* ── Reveal (slide away reveal) ──────────────────────────────────── */\n@keyframes pptx-tr-reveal-out-to-right {\n\tfrom { transform: translateX(0); }\n\tto   { transform: translateX(100%); }\n}\n@keyframes pptx-tr-reveal-out-to-left {\n\tfrom { transform: translateX(0); }\n\tto   { transform: translateX(-100%); }\n}\n/* MEASURED: the incoming layer stays hidden for roughly the first half of the\n   transition (a real black/background gap shows through), then fades in -\n   not a flat 0.5->1 fade running the whole duration. */\n@keyframes pptx-tr-reveal-in {\n\t0%   { opacity: 0; }\n\t50%  { opacity: 0; }\n\t100% { opacity: 1; }\n}\n\n/* ── Ripple (expanding ring clip-path) ───────────────────────────── */\n@keyframes pptx-tr-ripple-in {\n\tfrom { clip-path: circle(0% at 50% 50%); opacity: 0.5; }\n\t30%  { clip-path: circle(20% at 50% 50%); opacity: 0.7; }\n\t60%  { clip-path: circle(50% at 50% 50%); opacity: 0.9; }\n\tto   { clip-path: circle(75% at 50% 50%); opacity: 1; }\n}\n\n/* ── Shred (fragmented clip-path pieces) ─────────────────────────── */\n@keyframes pptx-tr-shred-strips-in {\n\tfrom { clip-path: inset(0 100% 0 0); opacity: 0; }\n\t30%  { clip-path: inset(0 60% 0 0); opacity: 0.5; }\n\tto   { clip-path: inset(0); opacity: 1; }\n}\n@keyframes pptx-tr-shred-rectangles-in {\n\tfrom { clip-path: inset(50%); opacity: 0; }\n\t40%  { clip-path: inset(20%); opacity: 0.6; }\n\tto   { clip-path: inset(0); opacity: 1; }\n}\n@keyframes pptx-tr-shred-out {\n\tfrom { opacity: 1; }\n\tto   { opacity: 0; filter: blur(2px); }\n}\n\n/* ── Switch (flip/rotate swap) ───────────────────────────────────── */\n@keyframes pptx-tr-switch-in-from-right {\n\tfrom { transform: perspective(800px) rotateY(-180deg); opacity: 0; }\n\tto   { transform: perspective(800px) rotateY(0deg); opacity: 1; }\n}\n@keyframes pptx-tr-switch-out-to-left {\n\tfrom { transform: perspective(800px) rotateY(0deg); opacity: 1; }\n\tto   { transform: perspective(800px) rotateY(180deg); opacity: 0; }\n}\n@keyframes pptx-tr-switch-in-from-left {\n\tfrom { transform: perspective(800px) rotateY(180deg); opacity: 0; }\n\tto   { transform: perspective(800px) rotateY(0deg); opacity: 1; }\n}\n@keyframes pptx-tr-switch-out-to-right {\n\tfrom { transform: perspective(800px) rotateY(0deg); opacity: 1; }\n\tto   { transform: perspective(800px) rotateY(-180deg); opacity: 0; }\n}\n\n/* ── Vortex (rotate + scale spiral) ──────────────────────────────── */\n@keyframes pptx-tr-vortex-in {\n\tfrom { transform: rotate(720deg) scale(0); opacity: 0; }\n\tto   { transform: rotate(0deg) scale(1); opacity: 1; }\n}\n@keyframes pptx-tr-vortex-out {\n\tfrom { transform: rotate(0deg) scale(1); opacity: 1; }\n\tto   { transform: rotate(-720deg) scale(0); opacity: 0; }\n}\n\n/* ── Warp: see `slide-transition-warp` (COM-measured radial zoom blur,\n   split out to keep this module under the per-file LOC budget) ────────── */\n\n@keyframes pptx-tr-warp-in {\n\t0%   { transform: scale(0.25); opacity: 0; filter: blur(10px) brightness(1.8); }\n\t50%  { transform: scale(0.85); opacity: 0.7; filter: blur(3px) brightness(1.3); }\n\t100% { transform: scale(1); opacity: 1; filter: blur(0) brightness(1); }\n}\n@keyframes pptx-tr-warp-out {\n\t0%   { transform: scale(1); opacity: 1; filter: blur(0) brightness(1); }\n\t50%  { transform: scale(0.85); opacity: 0.7; filter: blur(3px) brightness(1.3); }\n\t100% { transform: scale(0.25); opacity: 0; filter: blur(10px) brightness(1.8); }\n}\n@keyframes pptx-tr-warp-reverse-in {\n\t0%   { transform: scale(3.2); opacity: 0; filter: blur(14px) brightness(2.2); }\n\t50%  { transform: scale(1.7); opacity: 0.7; filter: blur(6px) brightness(1.5); }\n\t100% { transform: scale(1); opacity: 1; filter: blur(0) brightness(1); }\n}\n@keyframes pptx-tr-warp-reverse-out {\n\t0%   { transform: scale(1); opacity: 1; filter: blur(0) brightness(1); }\n\t50%  { transform: scale(1.7); opacity: 0.7; filter: blur(6px) brightness(1.5); }\n\t100% { transform: scale(3.2); opacity: 0; filter: blur(14px) brightness(2.2); }\n}\n\n\n/* ── WheelReverse (reverse wheel rotation) ───────────────────────── */\n@keyframes pptx-tr-wheel-reverse-in {\n\tfrom { clip-path: circle(0% at 50% 50%); transform: rotate(180deg); }\n\tto   { clip-path: circle(75% at 50% 50%); transform: rotate(0deg); }\n}\n\n/* ── Window (scale from center with border) ──────────────────────────\n   Same measured horz/vert meaning as Doors above (horz = horizontal split\n   line opening vertically; vert = vertical split line opening horizontally). */\n@keyframes pptx-tr-window-horz {\n\tfrom { clip-path: inset(50% 0); }\n\tto   { clip-path: inset(0 0); }\n}\n@keyframes pptx-tr-window-vert {\n\tfrom { clip-path: inset(0 50%); }\n\tto   { clip-path: inset(0 0); }\n}\n@keyframes pptx-tr-window-out {\n\tfrom { opacity: 1; transform: scale(1); }\n\tto   { opacity: 0; transform: scale(0.9); }\n}\n\n\n@keyframes pptx-tr-vortex-in-left { from { transform: translateX(-40%) rotate(720deg) scale(0); opacity: 0; } to { transform: translateX(0) rotate(0deg) scale(1); opacity: 1; } }\n@keyframes pptx-tr-vortex-out-left { from { transform: translateX(0) rotate(0deg) scale(1); opacity: 1; } to { transform: translateX(-40%) rotate(-720deg) scale(0); opacity: 0; } }\n@keyframes pptx-tr-vortex-in-right { from { transform: translateX(40%) rotate(-720deg) scale(0); opacity: 0; } to { transform: translateX(0) rotate(0deg) scale(1); opacity: 1; } }\n@keyframes pptx-tr-vortex-out-right { from { transform: translateX(0) rotate(0deg) scale(1); opacity: 1; } to { transform: translateX(40%) rotate(720deg) scale(0); opacity: 0; } }\n@keyframes pptx-tr-vortex-in-up { from { transform: translateY(-40%) rotate(720deg) scale(0); opacity: 0; } to { transform: translateY(0) rotate(0deg) scale(1); opacity: 1; } }\n@keyframes pptx-tr-vortex-out-up { from { transform: translateY(0) rotate(0deg) scale(1); opacity: 1; } to { transform: translateY(-40%) rotate(-720deg) scale(0); opacity: 0; } }\n@keyframes pptx-tr-vortex-in-down { from { transform: translateY(40%) rotate(-720deg) scale(0); opacity: 0; } to { transform: translateY(0) rotate(0deg) scale(1); opacity: 1; } }\n@keyframes pptx-tr-vortex-out-down { from { transform: translateY(0) rotate(0deg) scale(1); opacity: 1; } to { transform: translateY(40%) rotate(720deg) scale(0); opacity: 0; } }\n\n\n@keyframes pptx-tr-ripple-in-lu { from { clip-path: circle(0% at 0% 0%); opacity: 0.5; } 30% { clip-path: circle(20% at 0% 0%); opacity: 0.7; } 60% { clip-path: circle(55% at 0% 0%); opacity: 0.9; } to { clip-path: circle(150% at 0% 0%); opacity: 1; } }\n@keyframes pptx-tr-ripple-in-ru { from { clip-path: circle(0% at 100% 0%); opacity: 0.5; } 30% { clip-path: circle(20% at 100% 0%); opacity: 0.7; } 60% { clip-path: circle(55% at 100% 0%); opacity: 0.9; } to { clip-path: circle(150% at 100% 0%); opacity: 1; } }\n@keyframes pptx-tr-ripple-in-ld { from { clip-path: circle(0% at 0% 100%); opacity: 0.5; } 30% { clip-path: circle(20% at 0% 100%); opacity: 0.7; } 60% { clip-path: circle(55% at 0% 100%); opacity: 0.9; } to { clip-path: circle(150% at 0% 100%); opacity: 1; } }\n@keyframes pptx-tr-ripple-in-rd { from { clip-path: circle(0% at 100% 100%); opacity: 0.5; } 30% { clip-path: circle(20% at 100% 100%); opacity: 0.7; } 60% { clip-path: circle(55% at 100% 100%); opacity: 0.9; } to { clip-path: circle(150% at 100% 100%); opacity: 1; } }\n\n\n@keyframes pptx-tr-glitter-diamond-in-l { from { opacity: 0; transform: translateX(-6%); filter: brightness(1.5) contrast(1.3) blur(2px); } 60% { opacity: 0.7; transform: translateX(-2%); filter: brightness(1.2) contrast(1.1) blur(1px); } to { opacity: 1; transform: translateX(0); filter: brightness(1) contrast(1) blur(0); } }\n@keyframes pptx-tr-glitter-diamond-in-r { from { opacity: 0; transform: translateX(6%); filter: brightness(1.5) contrast(1.3) blur(2px); } 60% { opacity: 0.7; transform: translateX(2%); filter: brightness(1.2) contrast(1.1) blur(1px); } to { opacity: 1; transform: translateX(0); filter: brightness(1) contrast(1) blur(0); } }\n@keyframes pptx-tr-glitter-diamond-in-u { from { opacity: 0; transform: translateY(-6%); filter: brightness(1.5) contrast(1.3) blur(2px); } 60% { opacity: 0.7; transform: translateY(-2%); filter: brightness(1.2) contrast(1.1) blur(1px); } to { opacity: 1; transform: translateY(0); filter: brightness(1) contrast(1) blur(0); } }\n@keyframes pptx-tr-glitter-diamond-in-d { from { opacity: 0; transform: translateY(6%); filter: brightness(1.5) contrast(1.3) blur(2px); } 60% { opacity: 0.7; transform: translateY(2%); filter: brightness(1.2) contrast(1.1) blur(1px); } to { opacity: 1; transform: translateY(0); filter: brightness(1) contrast(1) blur(0); } }\n@keyframes pptx-tr-glitter-hexagon-in-l { from { opacity: 0; transform: translateX(-6%); filter: brightness(1.5) contrast(1.3) blur(2px) hue-rotate(20deg); } 60% { opacity: 0.7; transform: translateX(-2%); filter: brightness(1.2) contrast(1.1) blur(1px) hue-rotate(8deg); } to { opacity: 1; transform: translateX(0); filter: brightness(1) contrast(1) blur(0) hue-rotate(0deg); } }\n@keyframes pptx-tr-glitter-hexagon-in-r { from { opacity: 0; transform: translateX(6%); filter: brightness(1.5) contrast(1.3) blur(2px) hue-rotate(20deg); } 60% { opacity: 0.7; transform: translateX(2%); filter: brightness(1.2) contrast(1.1) blur(1px) hue-rotate(8deg); } to { opacity: 1; transform: translateX(0); filter: brightness(1) contrast(1) blur(0) hue-rotate(0deg); } }\n@keyframes pptx-tr-glitter-hexagon-in-u { from { opacity: 0; transform: translateY(-6%); filter: brightness(1.5) contrast(1.3) blur(2px) hue-rotate(20deg); } 60% { opacity: 0.7; transform: translateY(-2%); filter: brightness(1.2) contrast(1.1) blur(1px) hue-rotate(8deg); } to { opacity: 1; transform: translateY(0); filter: brightness(1) contrast(1) blur(0) hue-rotate(0deg); } }\n@keyframes pptx-tr-glitter-hexagon-in-d { from { opacity: 0; transform: translateY(6%); filter: brightness(1.5) contrast(1.3) blur(2px) hue-rotate(20deg); } 60% { opacity: 0.7; transform: translateY(2%); filter: brightness(1.2) contrast(1.1) blur(1px) hue-rotate(8deg); } to { opacity: 1; transform: translateY(0); filter: brightness(1) contrast(1) blur(0) hue-rotate(0deg); } }\n";
-//#endregion
-//#region src/render/p14-transition-css.d.ts
-/**
- * Return CSS animation descriptors for p14 transition types. Returns
- * `undefined` when the type is not a p14 transition.
- */
-declare function getP14TransitionAnimations(type: PptxTransitionType, durationMs: number, direction: string | undefined, orient?: string | undefined, pattern?: string | undefined): SlideTransitionAnimations | undefined;
-/**
- * A font supplied by the host application. The package never ships fonts:
- * applications provide a licensed URL, data URL, or blob URL for their users.
- */
-interface ViewerFontSource {
-  family: string;
-  src: string;
-  format?: 'truetype' | 'opentype' | 'woff' | 'woff2';
-  weight?: string | number;
-  style?: 'normal' | 'italic';
-}
-interface SlideSizeEmu {
-  widthEmu: number;
-  heightEmu: number;
-  /** ST_SlideSizeType token, or `''` for a size with no preset. */
-  type: string;
-}
-//#endregion
-//#region src/render/presentation-file-kinds.d.ts
-/**
- * presentation-file-kinds: the one place that answers "can the viewer open
- * this file?" and "what should the saved copy be called?".
- *
- * ## Why this is a shared decision and not five allow-lists
- *
- * The loader reads more formats than any single UI advertises. Legacy binary
- * `.ppt` (PowerPoint 97-2003) is the sharp example: `PptxHandler.load()` has
- * detected the OLE compound-file container and converted the binary deck
- * through the regular pptx pipeline for some time, but the product kept saying
- * it was unsupported, and a picker that filters the extension out makes a
- * working loader unreachable in practice. Whenever the loader learns a format,
- * exactly one list has to change.
- *
- * ## Read many, write several
- *
- * Input is a superset of output. We READ `.pptx`, `.ppsx`, `.pptm`, `.potx`,
- * legacy binary `.ppt` and portable `pptx-viewer-json`; we WRITE the OpenXML
- * family plus legacy binary `.ppt` (via `ooxml-core/src/pptx/core/ppt/writer/`,
- * a real MS-PPT/OLE2 encoder, not a stub). `savedPresentationFileName`
- * REPLACES the source extension with the extension of the format actually
- * being written rather than keeping the source's: a deck opened as
- * `report.pptx` and saved back as `.ppt` (or vice versa) must have its name
- * agree with its bytes, which is the kind of mismatch PowerPoint itself
- * refuses to open.
- *
- * This module deliberately imports nothing, so any layer (render, export, a
- * binding, a host app) can depend on it without risking an import cycle.
- *
- * @module render/presentation-file-kinds
- */
-/**
- * Extensions the built-in file picker offers, in the order it offers them.
- *
- * `.ppt` is in the list because the loader genuinely handles it, not as a
- * courtesy: see `ooxml-core/src/pptx/core/ppt/` and the `ppt-import` integration
- * suite, which asserts a `.ppt` loads to the same model as the `.pptx` it was
- * exported from.
- */
-declare const PRESENTATION_OPEN_EXTENSIONS: readonly ['.pptx', '.ppsx', '.pptm', '.potx', '.ppt', '.json'];
-/** Comma-separated `accept` attribute for a presentation file input. */
-declare const PPTX_OPEN_ACCEPT: string;
-/**
- * True when a picked / dropped file's name looks like something the loader can
- * open. Use this instead of a hand-rolled `endsWith` chain: a drop handler that
- * disagrees with the picker's `accept` list is a format that is supported by
- * mouse but not by drag, which is how `.ppt` stayed invisible.
- *
- * Extension-only, by design. The real answer comes from the container sniff in
- * `PptxHandler.load()`; this is only the cheap pre-filter a drop target needs
- * before it hands bytes to the loader.
- */
-declare function isSupportedPresentationFile(name: string | null | undefined): boolean;
-/**
- * True for the binary PowerPoint 97-2003 family. `.ppt` itself is now also a
- * SAVE target (see {@link SavedPresentationFormat}); `.pps`/`.pot` (97-2003
- * show/template) remain read-only siblings sharing the same record format.
- */
-declare function isLegacyBinaryPresentation(name: string | null | undefined): boolean;
-/** The formats the save path can produce. */
-type SavedPresentationFormat = 'pptx' | 'ppsx' | 'pptm' | 'ppt';
-/**
- * The stem of a presentation file name: directories and any loadable extension
- * removed. `C:\decks\report.ppt` becomes `report`; a name with no recognised
- * extension is kept whole, so `Untitled Presentation` survives intact rather
- * than losing everything after its last dot.
- */
-declare function presentationBaseName(sourceName: string | null | undefined, fallback?: string): string;
-/**
- * The name a saved copy should be offered under: the source stem plus the
- * extension of the format actually being written.
- *
- * This is what turns `report.ppt` into `report.pptx` on a regular Save As,
- * and `report.pptx` into `report.ppt` when the user explicitly picks the
- * PowerPoint 97-2003 format. Keeping the source extension would mislabel the
- * bytes either way.
- */
-declare function savedPresentationFileName(sourceName: string | null | undefined, format?: SavedPresentationFormat): string;
-//#endregion
-//#region src/render/session-restore.d.ts
-/**
- * session-restore: keep the deck a host app has open across a page refresh.
- *
- * A host (the demo apps, or any embedder) owns the bytes it hands to the
- * viewer, so a plain reload drops them and the user lands back on the file
- * dropzone with their presentation gone. This store remembers the open deck in
- * IndexedDB and hands it back on the next load.
- *
- * Scope is deliberately per-tab: the record is keyed by an id kept in
- * `sessionStorage`, which survives a reload but NOT a new tab. Refreshing
- * restores the deck this tab had open, while a second tab opened on the same
- * origin still starts on the landing page, and two tabs holding different decks
- * never steal each other's content.
- *
- * `restoreSessionDeck` additionally prefers a NEWER autosave snapshot for the
- * same file (see `./autosave-store`), so a refresh mid-edit comes back with the
- * edited deck rather than the pristine bytes that were first opened.
- *
- * Every operation is best-effort: a blocked IndexedDB, a partitioned
- * `sessionStorage`, or an exhausted quota degrades to "no restore", never to a
- * thrown error in the host.
- */
-/** A deck remembered for the current tab. */
-interface SessionDeck {
-  /** File name the deck was opened under, used as the autosave key. */
-  fileName: string;
-  /** The presentation bytes. */
-  data: Uint8Array;
-  /** When these bytes were remembered (epoch ms). */
-  timestamp: number;
-}
-/**
- * This tab's session id, or `null` when `sessionStorage` is unavailable (a
- * sandboxed iframe, or a browser with storage disabled).
- *
- * @param create Mint and persist an id when the tab does not have one yet.
- *   Reads pass `false` so a fresh tab never claims another tab's record.
- */
-declare function getSessionTabId(create?: boolean): string | null;
-/**
- * Remember `data` as the deck this tab has open, so the next load can restore
- * it. Resolves `false` when the browser refused to store it; callers treat that
- * as "no restore available later", never as an error.
- */
-declare function rememberSessionDeck(fileName: string, data: Uint8Array): Promise<boolean>;
-/** The deck remembered for this tab, or `null` when there is nothing to restore. */
-declare function loadSessionDeck(): Promise<SessionDeck | null>;
-/** Forget this tab's deck (the host closed it, or handed the tab to another flow). */
-declare function forgetSessionDeck(): Promise<void>;
-/**
- * The deck to reopen on load: this tab's remembered bytes, upgraded to a newer
- * autosave snapshot of the same file when the viewer wrote one after they were
- * remembered. Without that upgrade a refresh mid-edit would silently roll the
- * presentation back to the state it was opened in.
- */
-declare function restoreSessionDeck(): Promise<SessionDeck | null>;
-/** Optional seed values for the share start form. */
-interface ShareDefaults {
-  roomId?: string;
-  userName?: string;
-  serverUrl?: string;
-}
-//#endregion
-//#region src/render/presentation-session-types.d.ts
-interface PresentationSnapshot {
-  slideIndex: number;
-  buildStep: number;
-  sequence: number;
-  blackout: 'none' | 'black' | 'white';
-  paused: boolean;
-  elapsedMs: number;
-  zoom?: PresentationZoomState;
-  pointer?: PresentationPointerState;
-  inkStrokes?: PresentationInkStroke[];
-  /**
-   * Whether ink markup is drawn (PowerPoint's Ctrl+M). Undefined means visible,
-   * so existing snapshots keep showing their ink. Hiding never discards the
-   * strokes, which stay in `inkStrokes` and can be kept on exit.
-   */
-  inkMarkupVisible?: boolean;
-  caption?: string;
-  subtitlesVisible?: boolean;
-}
-interface PresentationZoomState {
-  scale: number;
-  originX: number;
-  originY: number;
-}
-type PresentationPointerTool = 'none' | 'laser' | 'pen' | 'highlighter' | 'eraser';
-interface PresentationPointerState {
-  tool: PresentationPointerTool;
-  x: number;
-  y: number;
-  color: string;
-}
-interface PresentationInkPoint {
-  x: number;
-  y: number;
-}
-interface PresentationInkStroke {
-  id: string;
-  slideIndex: number;
-  tool: 'pen' | 'highlighter';
-  color: string;
-  width: number;
-  points: PresentationInkPoint[];
-}
-declare function parsePresentationSessionId(hash: string): string | null;
-declare function loadPresentationDeck(sessionId: string): Promise<Uint8Array | null>;
-//#endregion
-//#region src/render/presentation-blackboard.d.ts
-/** Blackout state, as carried by {@link PresentationSnapshot}. */
-type PresentationBlackout = PresentationSnapshot['blackout'];
-//#endregion
-//#region src/render/paste-special.d.ts
-/** The four paste formats PowerPoint's Paste Options / Paste Special offer. */
-type PasteSpecialFormat = 'keep-source-formatting' | 'use-destination-theme' | 'picture' | 'keep-text-only';
-//#endregion
-//#region src/render/chrome-controls-state.d.ts
-type ChromeTranslate = (key: string, params?: Record<string, string | number>) => string;
-type ReadOnlyBannerPasswordError = 'wrong-password' | 'unsupported-algorithm';
-interface ReadOnlyBannerViewState {
-  /** `ReadOnlyRecommendation.kind`; mirrored onto the host's `data-kind`. */
-  kind: string | null;
-  /** `ReadOnlyRecommendation.messageKey`, translated by `translate`. */
-  messageKey: string;
-  /** Swap the Edit anyway / Dismiss pair for the inline password form. */
-  passwordPromptOpen?: boolean;
-  passwordError?: ReadOnlyBannerPasswordError | null;
-  /** Disables the form while a submitted password is being checked. */
-  checkingPassword?: boolean;
-  translate?: ChromeTranslate;
-}
-interface PasteOptionsViewState {
-  /** Right edge of the pasted element in viewport pixels. */
-  left: number;
-  /** Bottom edge of the pasted element in viewport pixels. */
-  top: number;
-  translate?: ChromeTranslate;
-}
-interface CompatToastViewItem {
-  readonly id: string;
-  readonly code: string;
-  readonly severity: 'info' | 'warning';
-  readonly messageKey: string;
-  readonly params?: Readonly<Record<string, string>>;
-}
-interface CompatToastsViewState {
-  /** Dismiss-filtered toasts. The element shows the first {@link COMPAT_TOAST_VISIBLE_LIMIT}. */
-  toasts: readonly CompatToastViewItem[];
-  /** Extra toasts a host already trimmed off the list it passes. */
-  overflowCount?: number;
-  /** Width of the open right-docked panel (see `compatToastStackStyle`). */
-  rightInset?: number;
-  /** Live height of the docked notes strip (see `compatToastStackStyle`). */
-  bottomInset?: number;
-  translate?: ChromeTranslate;
-}
-type DialogFooterVariant = 'secondary' | 'primary' | 'warning' | 'danger';
-type DialogFooterIcon = 'trash' | 'pen' | 'restore' | 'print' | 'check';
-interface DialogFooterAction {
-  /** Stable id echoed back in the `dialog-footer-request` intent. */
-  id: string;
-  /** Already-translated visible label and accessible name. */
-  label: string;
-  variant?: DialogFooterVariant;
-  icon?: DialogFooterIcon;
-  disabled?: boolean;
-  /** Work in flight: the button is disabled, `aria-busy` and shows a spinner. */
-  busy?: boolean;
-  /** Tooltip (`title`) for an action whose label needs a longer hint. */
-  title?: string;
-  /** `start` pins a tertiary action (Remove link, Reset all) to the left edge. */
-  align?: 'start' | 'end';
-  /** Optional `data-testid` stamped on the button. */
-  testId?: string;
-}
-interface DialogFooterViewState {
-  actions: readonly DialogFooterAction[];
-}
-type MobileBarId = 'slides' | 'insert' | 'inspector' | 'comments' | 'notes';
-interface MobileBarViewState {
-  /** Every button disables at 0 (see `buildBarActions`). */
-  slideCount: number;
-  /** The button whose sheet is open; reflected as `aria-pressed` and a top pill. */
-  activeSheet?: MobileBarId | null;
-  /** Comment count on the badge of Comments (`99+` above 99). */
-  commentCount?: number;
-  /** Buttons dropped entirely, such as Notes when `hiddenActions` hides it. */
-  hidden?: readonly MobileBarId[];
-  /** Buttons disabled beyond the no-slides rule, such as edit-only ones in view mode. */
-  disabled?: readonly MobileBarId[];
-  translate?: ChromeTranslate;
-}
-type MobileToolbarId = 'menu' | 'undo' | 'redo' | 'ai' | 'save' | 'present' | 'share';
-interface MobileToolbarViewState {
-  /** Menu, Undo, Redo, AI and Share only show while editing. */
-  editable: boolean;
-  canUndo: boolean;
-  canRedo: boolean;
-  /** Host opted into the AI assistant; the element draws its toggle. */
-  aiVisible?: boolean;
-  aiActive?: boolean;
-  /** Reflected as `aria-expanded` on Menu when given. */
-  menuOpen?: boolean;
-  /** Buttons dropped entirely (`hiddenActions`, or Share when the host has none). */
-  hidden?: readonly MobileToolbarId[];
-  /** Buttons disabled, such as Present while there is nothing to present. */
-  disabled?: readonly MobileToolbarId[];
-  translate?: ChromeTranslate;
-}
-interface PresentToolbarViewState {
-  /** Zero-based slide on screen. */
-  current: number;
-  total: number;
-  /** The armed annotation tool; `none` leaves every tool unpressed. */
-  tool: PresentationPointerTool;
-  penColor: string;
-  highlighterColor: string;
-  hasAnnotations: boolean;
-  /** With the pen, marks the Blackboard toggle active (`isBlackboardActive`). */
-  blackout: PresentationBlackout;
-  /** Show the presenter-view toggle (default false). */
-  presenterViewVisible?: boolean;
-  presenterViewActive?: boolean;
-  /** Epoch ms the show started. The element ticks the readout; null shows 00:00. */
-  startTime: number | null;
-  translate?: ChromeTranslate;
-}
-interface PresenterConsoleViewState {
-  /** Ids of toggles that read as on (and the resume / close-window variants). */
-  active: readonly string[];
-  /** Ids of controls that are disabled. */
-  disabled: readonly string[];
-  translate?: ChromeTranslate;
-}
-//#endregion
-//#region src/render/alignment-guides.d.ts
-/** A single alignment guide, positioned in authored slide pixels. */
-interface Guide {
-  id: string;
-  axis: 'h' | 'v';
-  position: number;
-}
-//#endregion
-//#region src/render/ink-drawing.d.ts
-/** A 2D point in stage-local coordinates. */
-interface InkPoint {
-  x: number;
-  y: number;
-  /**
-   * Pointer pressure at this point, from `PointerEvent.pressure` (0..1).
-   * Optional: a binding that has not wired pressure capture simply omits
-   * it, and {@link strokeToInkElement} falls back to
-   * {@link DEFAULT_POINTER_PRESSURE}, the constant value mice and other
-   * non-pressure-aware devices report, which reads as "no real pressure
-   * data".
-   */
-  pressure?: number;
-  /**
-   * Pen-tilt lean, in degrees, from `PointerEvent.tiltX`/`tiltY` on
-   * supporting hardware (a mouse, or a stylus with no tilt sensor, reports a
-   * constant 0). Optional and always captured as a pair: a binding that has
-   * not wired tilt capture simply omits both, and {@link strokeToInkElement}
-   * treats a constant `(0, 0)` reading the same way it treats a constant
-   * pressure, i.e. as "no real tilt data" rather than authoring a channel
-   * for it.
-   */
-  tiltX?: number;
-  tiltY?: number;
-}
-/** Options for {@link strokeToInkElement}. */
-interface StrokeToInkElementOpts {
-  points: InkPoint[];
-  color: string;
-  width: number;
-  tool: 'pen' | 'highlighter' | 'freeform';
-}
-//#endregion
-//#region src/render/mobile-chrome.d.ts
-/**
- * Pure helper logic for mobile chrome state, shared by every binding.
- *
- * These helpers capture the sheet open/close state machine that governs which
- * sheet is visible at any given time and which bottom-bar button appears active.
- * Keeping this logic as pure functions makes it straightforward to test and
- * trivial to adapt when each binding wires the components together.
- */
-/** All mobile sheets that can be open at one time. */
-type MobileSheetKey = 'slides' | 'menu' | 'insert' | 'inspector' | 'comments' | 'notes' | null;
-//#endregion
-//#region src/render/gradient-picker.d.ts
-/** A single gradient stop, mirroring the ShapeStyle array item shape. */
-interface GradientStop {
-  color: string;
-  position: number;
-  opacity?: number;
-  /**
-   * Theme colour identity for this stop, mirroring
-   * `ShapeStyle.fillColorRef`. Set by a theme-swatch pick so the stop keeps
-   * following the theme after a later theme change; cleared by a custom hex
-   * pick, which has no theme identity.
-   */
-  colorRef?: PptxThemeColorRef;
-}
-/** The editable gradient state surfaced to the component. */
-interface GradientState {
-  type: 'linear' | 'radial';
-  /** Angle in degrees (only meaningful for linear). */
-  angle: number;
-  stops: GradientStop[];
-}
-//#endregion
-//#region src/render/insert-chart.d.ts
-/**
- * Dropdown ids for the insert-chart menu. Distinct from `PptxChartType`
- * because PowerPoint offers Column (vertical) and Bar (horizontal) as two
- * entries over the same underlying `'bar'` chart type, and because `'pareto'`
- * has no `PptxChartType` of its own: it is a dropdown entry that resolves to
- * `type: 'histogram'` (see docs/guide/limitations.md's ChartEx row) with a
- * frequency-plus-cumulative-percentage default shape. The other six ChartEx
- * ids (`histogram` through `regionMap`) map one-to-one onto their chart type.
- */
-type InsertChartKind = 'column' | 'bar' | 'line' | 'pie' | 'doughnut' | 'area' | 'scatter' | 'histogram' | 'pareto' | 'funnel' | 'treemap' | 'sunburst' | 'boxWhisker' | 'regionMap';
-/** In-memory clipboard payload stored when an element is copied or cut. */
-interface ElementClipboardPayload {
-  element: PptxElement;
-  isTemplate: boolean;
-}
-//#endregion
-//#region src/render/image-file-insertion.d.ts
-/**
- * Decode a local image File/Blob into a centred element, fitting the slide
- * without upscaling. Dimensions are slide pixels; image bytes are preserved.
- *
- * Resolves null for unsupported/unreadable images, invalid bounds, cancellation,
- * or unavailable browser APIs. Importing this module is safe outside a browser.
- * No slide, selection, history, clipboard, or network state is changed. The
- * caller must still validate its document/slide destination before committing.
- */
-declare function createImageElementFromFile(file: Blob, canvasSize: CanvasSize, signal?: AbortSignal): Promise<ImagePptxElement | null>;
-//#endregion
-//#region src/render/shape-preset-catalog.d.ts
-/**
- * shape-preset-catalog.ts: the Insert > Shape picker catalogue shared by every
- * binding's toolbar/inspector.
- *
- * Pure data: each entry carries the preset geometry `type` (OOXML `a:prstGeom`
- * value the editor can insert), an English fallback `label`, the shared-i18n
- * `i18nKey`, and a framework-neutral icon descriptor ({@link ShapePresetGlyph}
- * name + optional utility-class modifier for rotation/skew). Each binding maps
- * the glyph name onto its own icon component/SVG.
- *
- * Order matters: bindings surface the first 12 entries as the quick "top
- * shapes" row, so new presets should be appended, not inserted.
- *
- * @module render/shape-preset-catalog
- */
-/** Shape preset geometry types offered by the insert picker. */
-type ShapePresetType = 'rect' | 'roundRect' | 'ellipse' | 'cylinder' | 'rtArrow' | 'leftArrow' | 'upArrow' | 'downArrow' | 'triangle' | 'rtTriangle' | 'diamond' | 'parallelogram' | 'trapezoid' | 'pentagon' | 'hexagon' | 'octagon' | 'chevron' | 'star5' | 'star6' | 'star8' | 'plus' | 'heart' | 'cloud' | 'sun' | 'moon' | 'pie' | 'plaque' | 'teardrop' | 'line' | 'connector';
-/** One placeholder outline, already positioned in unscaled slide space. */
-interface LayoutPreviewFrame {
-  /** Stable key for list rendering. */
-  key: string;
-  type: string;
-  left: number;
-  top: number;
-  width: number;
-  height: number;
-}
-/** Everything a binding needs to render one thumbnail. */
-interface LayoutPreviewGeometry {
-  /** Outer box, in CSS pixels. */
-  boxWidth: number;
-  boxHeight: number;
-  /** Inner surface size, in unscaled slide pixels. */
-  surfaceWidth: number;
-  surfaceHeight: number;
-  /** Factor to apply as `transform: scale(...)` on the inner surface. */
-  scale: number;
-  backgroundColor: string;
-  /**
-   * Border width for placeholder outlines, pre-divided by {@link scale}.
-   *
-   * The outlines live inside the scaled surface, so a plain 1.5px border
-   * would be multiplied down to a hairline that vanishes at thumbnail size.
-   * Dividing here keeps the drawn width constant on screen whatever the
-   * slide dimensions are.
-   */
-  frameBorderWidth: number;
-  frames: LayoutPreviewFrame[];
-}
-//#endregion
-//#region src/render/zoom-return-navigation.d.ts
-/**
- * The navigation-relevant fields of a Zoom click target, independent of
- * `zoomType`.
- *
- * `returnToParent` is already resolved to its EFFECTIVE value here (not the
- * raw, possibly-`undefined` `ZoomPptxElement`/`SummaryZoomTarget` field):
- * `CT_ZoomObjectProperties/@returnToParent` (MS-PPTX) is `<xsd:attribute
- * name="returnToParent" type="xsd:boolean" use="optional" default="true"/>`,
- * so an ABSENT attribute means true, not false. Core deliberately stores
- * `undefined` rather than fabricating `true` (so a round-trip never invents
- * an attribute the source never had), which makes `Boolean(x)` the wrong way
- * to read it; the two `resolve*NavigationTarget` functions below are the only
- * place that distinction should be made.
- */
-interface ZoomNavigationTarget {
-  targetSlideIndex: number;
-  targetSectionId?: string;
-  returnToParent: boolean;
-  transitionDurationMs?: number;
-}
-//#endregion
-//#region src/render/command-search.d.ts
-/**
- * Command-search data for the PowerPoint-style "Tell me what you want to do"
- * search bar. Provides searchable command entries grouped by category, each
- * mapping a label translation key to a command identifier that bindings can
- * dispatch.
- */
-interface CommandSearchEntry {
-  /** Translation key for the display label. */
-  labelKey: string;
-  /** Command identifier dispatched to the host binding. */
-  command: string;
-  /** Optional icon hint (binding resolves to framework icon component). */
-  icon?: string;
-  /** Category grouping key; hosts with their own short list may omit it. */
-  category?: 'format' | 'insert' | 'view' | 'slideShow' | 'design' | 'arrange';
-}
-interface AutosaveRecord {
-  key: string;
-  data: Uint8Array;
-  timestamp: number;
-  size: number;
-}
-//#endregion
-//#region src/render/master-view-crud.d.ts
-/** One Slide Master view sidebar command. */
-type MasterViewCrudActionId = 'addLayout' | 'duplicateLayout' | 'deleteLayout' | 'renameLayout' | 'addMaster' | 'duplicateMaster' | 'deleteMaster' | 'renameMaster';
-/** A framework-neutral descriptor for one sidebar button. */
-interface MasterViewCrudAction {
-  id: MasterViewCrudActionId;
-  /** i18n key for the button label (`pptx.masterView.<id>`). */
-  labelKey: string;
-  enabled: boolean;
-  /** i18n key explaining why the button is disabled, set only when it is. */
-  disabledReasonKey?: string;
-}
-//#endregion
-//#region src/export/handout-layout.d.ts
-/**
- * Pure handout layout calculations, shared by every binding's print path.
- *
- * Handles distributing slides across pages, computing grid dimensions, and
- * positioning cells within A4 page space. No DOM/framework dependency: callers
- * render the resulting rectangles however their view layer prefers.
- */
-/** Supported slides-per-page values. */
-type HandoutSlidesPerPage = 1 | 2 | 3 | 4 | 6 | 9;
-//#endregion
-//#region src/export/print-document.d.ts
-/** What to print. */
-type PrintWhat = 'slides' | 'handouts' | 'notes' | 'outline';
-/** Page orientation for the printed output. */
-type PrintOrientation = 'portrait' | 'landscape';
-/** Colour mode for the printed output. */
-type PrintColorMode = 'color' | 'grayscale' | 'blackAndWhite';
-/** Slide range mode. */
-type PrintSlideRange = 'all' | 'current' | 'custom';
-/** Resolved print settings emitted on confirm. */
-interface PrintSettings {
-  printWhat: PrintWhat;
-  orientation: PrintOrientation;
-  colorMode: PrintColorMode;
-  frameSlides: boolean;
-  slidesPerPage: HandoutSlidesPerPage;
-  slideRange: PrintSlideRange;
-  customRangeFrom: number;
-  customRangeTo: number;
-  /**
-   * PowerPoint's Print > "Scale to Fit Paper". `true` (the default, and the
-   * only behavior this printed output ever had before this field existed)
-   * shrinks/grows each slide image to fill its page/cell while preserving
-   * aspect ratio. `false` prints at the slide's native pixel size instead,
-   * which may overflow or under-fill the page, exactly like PowerPoint with
-   * the option off. Optional so existing `Partial<PrintSettings>` literals
-   * across every binding keep compiling; `validatePrintSettings` defaults it
-   * to `true`.
-   */
-  scaleToFit?: boolean;
-}
-//#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
-/**
- * Framework-neutral store behind the File > Options dialog.
- *
- * Holds a `ViewerOptions` snapshot, notifies subscribers on change, and
- * persists a sparse diff into the shared `pptx-viewer-prefs` localStorage
- * entry so choices survive reloads in every binding.
- */
-type ViewerOptionsListener = (options: ViewerOptions) => void;
-interface ViewerOptionsStore {
-  getOptions(): ViewerOptions;
-  /** Replace the whole snapshot (e.g. hydrating from a host prop). */
-  setOptions(next: ViewerOptions): void;
-  /** Set one primitive value; ignores unknown keys and mismatched types. */
-  setValue(group: ViewerOptionsGroupId, key: string, value: ViewerOptionPrimitive): void;
-  getValue(group: ViewerOptionsGroupId, key: string): ViewerOptionPrimitive | undefined;
-  /** Toggle a ribbon tab's visibility. The File tab is always kept visible. */
-  setRibbonTabHidden(tabId: ToolbarTabId, hidden: boolean): void;
-  setQuickAccessCommands(commandIds: readonly string[]): void;
-  /** Reset every option (or one tab-group) back to defaults. */
-  reset(group?: ViewerOptionsGroupId): void;
-  subscribe(listener: ViewerOptionsListener): () => void;
-  /**
-   * Subscribe to ONE projection of the options, woken only when that
-   * projection changes.
-   *
-   * `subscribe` above wakes on every option change, which in a binding means
-   * the whole options consumer re-renders because the user toggled something
-   * unrelated. A ribbon control that reads `ribbon.hiddenTabIds` should not
-   * care that an autosave interval moved (issue #145).
-   *
-   * IMPORTANT for array/object slices: every write here deep-clones the whole
-   * options object (`cloneViewerOptions`), so a nested array is a NEW array
-   * after ANY change, even one that did not touch it. Under the default
-   * `Object.is` such a selector would fire on every write and buy nothing.
-   * Pass a value equality for those, e.g. the shared `sameArray`.
-   */
-  subscribeSelector<T>(selector: (options: ViewerOptions) => T, listener: (value: T, previous: T) => void, isEqual?: (a: T, b: T) => boolean): () => void;
-  /**
-   * Apply several option writes as ONE notification, so a multi-field
-   * 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;
-}
-interface SubtitleSettings {
-  spokenLanguage: string;
-}
-interface SubtitleSettingsLabels {
-  title: string;
-  language: string;
-  browserLanguage: string;
-  description: string;
-  apply: string;
-  cancel: string;
-}
-/**
- * Optional hook point for hosts that want to wire a real sign-in flow into
- * File > Account. Disabled by default: the Account page renders nothing
- * extra unless a host explicitly opts in by passing `enabled: true`.
- * See docs/guide for wiring instructions.
- */
-interface AccountAuthConfig {
-  enabled: boolean;
-  onSignIn: () => void;
-  signedInUser?: {
-    name: string;
-    email?: string;
-    avatarUrl?: string;
-  };
-}
-//#endregion
-//#region src/render/ribbon-galleries/gallery-types.d.ts
-/** Every gallery the ribbon offers. */
-type RibbonGalleryId = 'shapeStyles' | 'shapeEffects' | 'wordArtStyles' | 'pictureStyles' | 'pictureCorrections' | 'pictureColor' | 'pictureArtisticEffects' | 'bullets' | 'numbering' | 'tableStyles' | 'chartStyles' | 'chartColors' | 'chartQuickLayout' | 'smartArtStyles' | 'smartArtColors' | 'smartArtLayouts' | 'smartArtAddShape' | 'smartArtAddBullet' | 'smartArtTextPane' | 'smartArtPromote' | 'smartArtDemote' | 'smartArtRightToLeft' | 'smartArtMoveUp' | 'smartArtMoveDown' | 'smartArtResetGraphic' | 'smartArtConvert' | 'themeColors' | 'themeFonts';
-/** One tile. */
-interface RibbonGalleryItem {
-  /** Stable within its gallery; what `applyRibbonGalleryItem` takes. */
-  id: string;
-  /** i18n key of the tile's accessible name / tooltip. */
-  labelKey: string;
-  /** `{{name}}` interpolation values for `labelKey`. */
-  labelParams?: Readonly<Record<string, string | number>>;
-  /** English fallback for bindings whose dictionary lacks `labelKey`. */
-  label: string;
-  /**
-   * A complete, self-contained `<svg>` element (width/height/viewBox set).
-   * Built only from catalogue data and theme colours, never from user text,
-   * so it is safe to inject as markup.
-   */
-  previewSvg: string;
-  /**
-   * CSS `filter` the tile's preview carries (the Picture Adjust galleries),
-   * for a host that draws the thumbnail over a real image instead of
-   * `previewSvg`. Omitted when the preset has no CSS-expressible preview.
-   */
-  previewFilter?: string;
-  /** True when this entry is what the selection currently carries. */
-  applied: boolean;
-}
-/** A titled block of tiles (PowerPoint's "Theme Styles" / "Presets"). */
-interface RibbonGallerySection {
-  id: string;
-  /** i18n key of the section heading; omitted for an untitled section. */
-  titleKey?: string;
-  title?: string;
-  /** Tiles per row in the dropped-down grid. */
-  columns: number;
-  /** Preview tile size in CSS px (the SVG's own width/height). */
-  tileWidth: number;
-  tileHeight: number;
-  items: RibbonGalleryItem[];
-}
-interface RibbonGalleryDescriptor {
-  id: RibbonGalleryId;
-  /** i18n key of the gallery trigger / group caption. */
-  labelKey: string;
-  label: string;
-  sections: RibbonGallerySection[];
-  /** True when the selection cannot take this gallery (trigger disabled). */
-  disabled: boolean;
-  /**
-   * Set when the entry is a one-button command (PowerPoint's Add Shape, Reset
-   * Graphic, ...) rather than a gallery: the element draws a plain command, a
-   * click picks its only item and no panel opens.
-   */
-  command?: RibbonGalleryCommandView;
-}
-/** How a command-style entry draws (see {@link RibbonGalleryDescriptor.command}). */
-interface RibbonGalleryCommandView {
-  /** SVG path data on a 20px grid. */
-  iconPath: string;
-  /** Icon above the label (PowerPoint's large button) instead of beside it. */
-  large?: boolean;
-  /** i18n key and English fallback of the tooltip, e.g. why the command is unavailable. */
-  hintKey?: string;
-  hint?: string;
-}
-/**
- * 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
-/**
- * Reconcile a committed plain-text edit with an element's existing rich runs.
- *
- * Editor surfaces expose plain text, but the model still owns per-run styles,
- * bullets, fields and paragraph properties. An unchanged blur is not an edit;
- * a changed value is remapped onto the authored segments instead of flattening
- * them.
- */
-declare function buildInlineTextCommitPatch(element: PptxElement | undefined, text: string, snapshot?: InlineTextEditSnapshot): Partial<PptxElement> | undefined;
-/** Overlay a current rich list draft for serialization, without committing editor state. */
-declare function overlayInlineTextSnapshot(elements: readonly PptxElement[], snapshot?: InlineTextEditSnapshot, text?: string | undefined): readonly PptxElement[];
-//#endregion
-//#region src/render/slide-size-rescale.d.ts
-type SlideSizeRescaleMode = 'maximize' | 'ensureFit';
-type ReadOnlyRecommendationKind = 'modifyVerifier' | 'markedFinal' | null;
-interface ReadOnlyRecommendation {
-  readonly kind: ReadOnlyRecommendationKind;
-  /** i18n key for the banner/toast a binding shows for this recommendation. */
-  readonly messageKey: string;
-  /** Whether a binding's "read-only" toggle should default to on. */
-  readonly defaultReadOnly: boolean;
-  /**
-   * Whether lifting this recommendation requires a correct password, rather
-   * than a plain "Edit anyway". True only for a `modifyVerifier` that carries
-   * a hash this viewer can actually check (`hashData` plus a resolvable
-   * algorithm, see `checkModifyPassword`; `saltData` is optional and NOT
-   * required, a missing salt is still checkable). "Mark as Final" is purely
-   * advisory and never requires one, and a `modifyVerifier` with no hash at
-   * all, or naming an algorithm this viewer does not implement, cannot be
-   * verified either way, so both fall back to the plain "Edit anyway" a
-   * binding already had.
-   */
-  readonly requiresPassword: boolean;
-}
-//#endregion
-//#region src/render/modify-password-check.d.ts
-type ModifyPasswordCheckResult = {
-  readonly ok: true;
-} | {
-  readonly ok: false;
-  readonly reason: 'wrong-password' | 'unsupported-algorithm';
-};
-interface CompatibilityWarningToast {
-  /** Stable per-code id, since toasts are deduped by code (see module docs). */
-  readonly id: string;
-  readonly code: string;
-  readonly severity: 'info' | 'warning';
-  readonly messageKey: string;
-  /** `{{code}}` for the generic fallback key; `undefined` for a mapped code. */
-  readonly params?: Readonly<Record<string, string>>;
-}
-//#endregion
-//#region src/render/run-program-notice.d.ts
-/**
- * run-program-notice.ts: turn a resolved `ppaction://program` command string
- * into the non-blocking notice a binding should show during a running show.
- *
- * PowerPoint's "Run program" action (`a:hlinkClick` -> `ppaction://program`,
- * `packages/shared/src/render/presentation-action.ts`'s `runProgram` intent)
- * names a free-text "Program to run:" command the author typed, e.g.
- * `notepad.exe C:\temp\notes.txt`. Path and arguments are ONE unstructured
- * string; OOXML has no separate arguments field, so this module does not try
- * to split one out.
- *
- * A browser cannot launch a local executable, so the honest behavior on
- * click is: show the presenter a small, dismissible notice naming the exact
- * command PowerPoint would have run, with a Copy button, rather than doing
- * nothing (silently) or blocking the show with a modal dialog.
- *
- * Framework-agnostic: no React, Vue, Angular, Svelte or DOM imports.
- */
-/** A run-program notice ready for a binding's toast/notice UI to render. */
-interface RunProgramNotice {
-  /** Stable id for this invocation, so a binding can dedupe/key a toast list. */
-  readonly id: string;
-  /** The exact resolved command string (path plus whatever arguments the author typed). */
-  readonly target: string;
-  /** i18n key for the notice body. Interpolates `{{target}}`. */
-  readonly messageKey: string;
-  /** i18n key for the Copy button label. */
-  readonly copyLabelKey: string;
-}
-//#endregion
-//#region src/render/viewport-fit.d.ts
-/** Unscaled CSS pixels reserved on each side of the ordinary viewer viewport. */
-type ViewportFitPadding = number | {
-  horizontal: number;
-  vertical: number;
-};
-/** Host layout policy, independent of authored slide dimensions and user zoom. */
-interface ViewportFitOptions {
-  /** Per-side padding. Omission keeps the binding's existing decorative allowance. */
-  fitPadding?: ViewportFitPadding;
-  /** Positive fit-factor ceiling; null allows enlargement without a ceiling. */
-  maxFitScale?: number | null;
-}
-//#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)[];
-}
-type ThemeEditorLabels = Record<string, string>;
-/**
- * Controlled Animations tab state. Hosts own the slide model, selection,
- * history and the inspector; the view only reflects these values.
- */
-interface RibbonAnimationsViewState {
-  /** False in read-only hosts: every authoring intent is rejected. */
-  editable: boolean;
-  /** Whether an element is selected; effects always target one element. */
-  hasSelection: boolean;
-  /** Whether the Animation Pane (inspector) is open; reflected as pressed. */
-  paneOpen?: boolean;
-  /** Transient highlight while a host's Preview is playing, where it tracks one. */
-  previewActive?: boolean;
-  translate?: (key: string) => string;
-}
-//#endregion
-//#region src/render/ribbon-draw-state.d.ts
-type RibbonDrawTool = 'select' | 'pen' | 'highlighter' | 'eraser' | 'freeform';
-interface RibbonDrawViewState {
-  tool: RibbonDrawTool;
-  color: string;
-  width: number;
-  editable: boolean;
-  recentColors?: readonly string[];
-  translate?: (key: string) => string;
-}
-/**
- * Controlled Insert tab state. Native viewers own the selections, every document
- * mutation, the file/shape/SmartArt/equation/hyperlink dialogs and history.
- */
-interface RibbonInsertState {
-  editable: boolean;
-  /** A hyperlink always attaches to something, so Link tracks the selection. */
-  hasSelection: boolean;
-  /** The shape preset staged in the Shape picker. */
-  shapeType: string;
-  /** The chart entry staged in the Chart picker. */
-  chartKind: string;
-  /** The armed Freeform: Shape / Curve tool. */
-  activeFreeformTool?: string | null;
-  /** Visible Freeform tools; empty hides the buttons (host customization). */
-  freeformTools?: readonly string[];
-  /** Hosts without these capabilities hide the control instead of showing a dead one. */
-  chartAvailable?: boolean;
-  fieldAvailable?: boolean;
-  headerFooterAvailable?: boolean;
-  translate?: (key: string) => string;
-}
-/** One row of a menu or select; labels are translated by the view unless `label` is set. */
-interface RibbonHomeItem {
-  readonly value: string;
-  /** Ready-made text (a font family, a layout name); wins over `labelKey`. */
-  readonly label?: string;
-  readonly labelKey?: string;
-  readonly fallback?: string;
-  readonly description?: string;
-  readonly descriptionKey?: string;
-  /** Heading of the group this row opens; consecutive rows share one heading. */
-  readonly group?: string;
-  readonly groupKey?: string;
-  readonly checked?: boolean;
-  readonly disabled?: boolean;
-  /** Preview typeface of a font row. */
-  readonly fontFamily?: string;
-  /** Shared artwork key shown before the label (a shape glyph or ribbon icon). */
-  readonly icon?: string;
-  /** Preserved test or automation hooks (`data-pptx-merge-op`, ...). */
-  readonly attrs?: Readonly<Record<string, string>>;
-  /** Draws a divider above the row. */
-  readonly separator?: boolean;
-}
-interface RibbonHomeControlState {
-  disabled?: boolean;
-  /** Omit for ordinary commands; a boolean reflects `aria-pressed`. */
-  pressed?: boolean;
-  /** Reserved for hosts that mirror their own popover; shared popovers set it themselves. */
-  expanded?: boolean;
-  hidden?: boolean;
-  /** Select, number, colour bar and checked menu row. */
-  value?: string | number;
-  /** Menu or select rows that replace the spec's static ones. */
-  items?: readonly RibbonHomeItem[];
-  /** Colour popover content; the trigger shows `value` in its bar. */
-  colour?: RibbonHomeColourModel;
-  /** Layout gallery content. */
-  layouts?: RibbonHomeLayoutModel;
-  /** Embedded gallery content. */
-  gallery?: {
-    descriptor: RibbonGalleryDescriptor | undefined;
-    disabled?: boolean;
-  };
-}
-interface RibbonHomeColourModel {
-  /** The deck's theme colour map; the popover derives the theme palette from it. */
-  themeColors?: Readonly<Record<string, string>>;
-  /** Theme reference of the current colour (highlights its swatch). */
-  selectedRef?: PptxThemeColorRef;
-  /** Recently used colours, newest first. */
-  recent?: readonly string[];
-}
-interface RibbonHomeLayoutModel {
-  layouts: readonly {
-    path: string;
-    name: string;
-  }[];
-  /** Marks the active tile; omitted by New Slide. */
-  current?: string;
-  /** Artwork data by layout path; tiles render name-only until it arrives. */
-  previews?: Readonly<Record<string, PptxLayoutPreview>> | ReadonlyMap<string, PptxLayoutPreview>;
-}
-/** State key of a control: its id, or `id#part` when several buttons share one id. */
-type RibbonHomeKey = RibbonControlId | `${RibbonControlId}#${string}`;
-interface RibbonHomeViewState {
-  /** Missing entries are enabled, unpressed and visible. */
-  controls: Readonly<Partial<Record<RibbonHomeKey, RibbonHomeControlState>>>;
-  translate?: (key: string) => string;
-}
-/** Controlled View tab state. Native viewers own the values and every side effect. */
-interface RibbonViewState {
-  editable: boolean;
-  showRulers: boolean;
-  showGrid: boolean;
-  showGuides: boolean;
-  snapToGrid: boolean;
-  snapToShape: boolean;
-  templateEditing: boolean;
-  selectionPaneOpen?: boolean;
-  eyedropperActive?: boolean;
-  /** Hosts without these capabilities hide the control instead of showing a dead one. */
-  selectionPaneAvailable?: boolean;
-  eyedropperAvailable?: boolean;
-  zoomAvailable?: boolean;
-  translate?: (key: string) => string;
-}
-//#endregion
-//#region src/render/ribbon-transitions-state.d.ts
-type RibbonTransitionsTranslate = (key: string, params?: Record<string, string>) => string;
-/** Controlled Transitions tab state. The host derives it from the ACTIVE slide. */
-interface RibbonTransitionsViewState {
-  draft: RibbonTransitionDraft;
-  /** The slide's transition, used only to list and select the Sound entries. */
-  transition?: PptxSlideTransition;
-  editable: boolean;
-  inspectorOpen?: boolean;
-  translate?: RibbonTransitionsTranslate;
-}
-//#endregion
-//#region src/render/status-bar-state.d.ts
-/**
- * Shared model for the bottom status bar (`pptx-ui-status-bar`).
- *
- * The slide counter, save indicator, notes toggle, view-mode buttons and zoom
- * cluster were hand-built five times. The view owns the markup, pressed state
- * and gating; hosts own every effect (notes panel, view switching, zoom).
- */
-type StatusBarTranslate = (key: string, params?: Record<string, string | number>) => string;
-type StatusBarSaveKind = 'idle' | 'saving' | 'error';
-type StatusBarViewMode = 'normal' | 'sorter' | 'slideShow';
-interface StatusBarViewState {
-  slideCount: number;
-  /** Zero-based active slide; clamped into range for display. */
-  activeSlideIndex: number;
-  /** Already-translated save indicator, see {@link resolveStatusBarSave}. */
-  saveText: string;
-  saveKind?: StatusBarSaveKind;
-  /** Omit to hide the whole zoom cluster. */
-  zoomPercent?: number;
-  showNotes?: boolean;
-  notesExpanded?: boolean;
-  /** Default true. False drops the Normal / Sorter / Slide Show cluster. */
-  showViewModes?: boolean;
-  /** Default true. */
-  showSorter?: boolean;
-  /** Default true. */
-  showSlideShow?: boolean;
-  /** The pressed view button; omit when none is active. */
-  viewMode?: StatusBarViewMode;
-  translate?: StatusBarTranslate;
-}
-//#endregion
-//#region src/render/notes-toolbar-state.d.ts
-/**
- * Shared model for the speaker-notes formatting toolbar (`pptx-ui-notes-toolbar`).
- *
- * The toolbar owns the buttons, their order, icons, labels, enabled state and
- * the hyperlink popover. Hosts own the contenteditable editor, selection-based
- * edits, history, printing and persistence, and route typed intents to them.
- */
-type NotesToolbarTranslate = (key: string, params?: Record<string, string | number>) => string;
-interface NotesToolbarViewState {
-  /** True while the rich (contenteditable) surface is active. Drives the mode button label. */
-  rich: boolean;
-  /** Enables the formatting buttons. False in the plain editor, where they cannot act. */
-  canFormat: boolean;
-  /** Shows the Print button. */
-  showPrint: boolean;
-  /** Disables every button, for example while no slide is selected. */
-  disabled?: boolean;
-  /** Host translator; keys are the canonical `pptx.notes.*` set. Omitted: keys are shown. */
-  translate?: NotesToolbarTranslate;
-}
-//#endregion
-//#region src/render/title-bar-state.d.ts
-type TitleBarTranslate = (key: string, params?: Record<string, string | number>) => string;
-type TitleBarPlacement = 'titleBar' | 'belowRibbon';
-type TitleBarTone = 'idle' | 'saving' | 'error';
-interface TitleBarAutosaveView {
-  enabled: boolean;
-  /** Default true. False renders the switch inert (host policy `autosave: false`). */
-  toggleAvailable?: boolean;
-  /** Translation key from `resolveTitleBarStatusKey`. */
-  statusKey: string;
-  /** Colour of the status text; only meaningful while `enabled`. */
-  tone?: TitleBarTone;
-}
-interface TitleBarHistoryState {
-  canUndo: boolean;
-  canRedo: boolean;
-  /** Description of the pending action, e.g. "Delete shape". */
-  undoLabel?: string | null;
-  redoLabel?: string | null;
-  /** Default true. Maps to `hiddenActions: ['undo']`. */
-  showUndo?: boolean;
-  /** Default true. Maps to `hiddenActions: ['redo']`. */
-  showRedo?: boolean;
-}
-interface TitleBarQuickAccessView {
-  visible: boolean;
-  position: QuickAccessPosition;
-  showCommandLabels: boolean;
-  /** Ordered catalog ids (File > Options > Quick Access Toolbar). */
-  commandIds: readonly string[];
-}
-interface TitleBarViewState {
-  /** Edit mode with an editable deck. Gates AutoSave, the strip, status and search. */
-  editing: boolean;
-  /** Whether the command search shows; hosts pass `editing`. */
-  searchVisible: boolean;
-  /** Display name; the translated default shows when empty. */
-  fileName?: string;
-  autosave: TitleBarAutosaveView;
-  history: TitleBarHistoryState;
-  /** Default true. */
-  showSave?: boolean;
-  quickAccess: TitleBarQuickAccessView;
-  /** Search catalogue; defaults to the shared `COMMAND_SEARCH_ENTRIES`. */
-  commands?: readonly CommandSearchEntry[];
-  /** Default true. False drops the "Find in Slides" fallback row. */
-  contentSearch?: boolean;
-  /** ScreenTip rule (Options > General); returning undefined suppresses the title. */
-  screenTip?: (label: string) => string | undefined;
-  translate?: TitleBarTranslate;
-}
-//#endregion
-//#region src/web-components/theme-editor.d.ts
-interface PptxUiThemeEditorElement extends HTMLElement {
-  theme: PptxTheme | undefined;
-  labels: ThemeEditorLabels;
-  disabled: boolean;
-}
-declare global {
-  interface HTMLElementTagNameMap {
-    'pptx-ui-theme-editor': PptxUiThemeEditorElement;
-  }
-}
-/** One row of a context menu. Hosts decide `id`, wording, gating and what activation does. */
-interface ContextMenuViewItem {
-  /** Stable command id, echoed by `menu-request`. */
-  id: string;
-  /** Already-translated visible label. */
-  label: string;
-  /** Draw a rule before this row. */
-  separatorBefore?: boolean;
-  /** Group heading shown before this row; the row and the ones after it join that group. */
-  heading?: string;
-  /** Destructive command (Delete): tinted. */
-  danger?: boolean;
-  /** Offered but unavailable: announced and drawn dim, skipped by arrow keys. */
-  disabled?: boolean;
-  /** A toggle (Grid and Guides, Ruler) in this state; omitted for one-shot commands. */
-  checked?: boolean;
-}
-/** Everything the controlled element needs to draw one menu. */
-interface ContextMenuViewState {
-  /** Pointer position, in viewport pixels. The element clamps it into the window. */
-  x: number;
-  y: number;
-  /** Accessible name of the menu. */
-  label: string;
-  items: readonly ContextMenuViewItem[];
-  /**
-   * Test-hook attributes copied onto the host element (`data-pptx-context-menu`,
-   * `data-pptx-canvas-context-menu`, ...). Only `data-pptx-*` names are accepted.
-   */
-  markers?: readonly string[];
-  /** Stacking order; defaults to {@link CONTEXT_MENU_EDITOR_LAYER}. */
-  zIndex?: number;
-  /** Move focus onto the first command on open. Default true. */
-  autoFocus?: boolean;
-}
-interface PptxUiCompatToastsElement extends HTMLElement {
-  state: CompatToastsViewState;
-}
-interface PptxUiDialogFooterElement extends HTMLElement {
-  state: DialogFooterViewState;
-  /** Move keyboard focus to an action, e.g. the primary one when a dialog opens. */
-  focusAction(id: string): void;
-}
-interface PptxUiPasteOptionsElement extends HTMLElement {
-  state: PasteOptionsViewState;
-}
-interface PptxUiReadOnlyBannerElement extends HTMLElement {
-  state: ReadOnlyBannerViewState;
-}
-interface PptxUiContextMenuElement extends HTMLElement {
-  state: ContextMenuViewState;
-}
-declare global {
-  interface HTMLElementTagNameMap {
-    'pptx-ui-compat-toasts': PptxUiCompatToastsElement;
-    'pptx-ui-context-menu': PptxUiContextMenuElement;
-    'pptx-ui-dialog-footer': PptxUiDialogFooterElement;
-    'pptx-ui-paste-options': PptxUiPasteOptionsElement;
-    'pptx-ui-read-only-banner': PptxUiReadOnlyBannerElement;
-  }
-}
-interface PptxUiMobileBarElement extends HTMLElement {
-  state: MobileBarViewState;
-}
-declare global {
-  interface HTMLElementTagNameMap {
-    'pptx-ui-mobile-bar': PptxUiMobileBarElement;
-  }
-}
-interface PptxUiMobileToolbarElement extends HTMLElement {
-  state: MobileToolbarViewState;
-}
-declare global {
-  interface HTMLElementTagNameMap {
-    'pptx-ui-mobile-toolbar': PptxUiMobileToolbarElement;
-  }
-}
-interface PptxUiPresentToolbarElement extends HTMLElement {
-  state: PresentToolbarViewState;
-  /** Close an open colour palette, e.g. when the host auto-hides the bar. */
-  closePalettes(): void;
-}
-declare global {
-  interface HTMLElementTagNameMap {
-    'pptx-ui-present-toolbar': PptxUiPresentToolbarElement;
-  }
-}
-interface PptxUiPresenterConsoleElement extends HTMLElement {
-  state: PresenterConsoleViewState;
-}
-declare global {
-  interface HTMLElementTagNameMap {
-    'pptx-ui-presenter-console': PptxUiPresenterConsoleElement;
-  }
-}
-interface PptxUiRibbonAnimationsElement extends HTMLElement {
-  state: RibbonAnimationsViewState;
-}
-declare global {
-  interface HTMLElementTagNameMap {
-    'pptx-ui-ribbon-animations': PptxUiRibbonAnimationsElement;
-  }
-}
-interface PptxUiRibbonDrawElement extends HTMLElement {
-  state: RibbonDrawViewState;
-}
-declare global {
-  interface HTMLElementTagNameMap {
-    'pptx-ui-ribbon-draw': PptxUiRibbonDrawElement;
-  }
-}
-//#endregion
-//#region src/web-components/ribbon-home-layout.d.ts
-/**
- * Draws a layout's real artwork inside a tile's scaled surface. The artwork is
- * element rendering that each binding owns; return a disposer to release it.
- */
-type HomeLayoutArtwork = (preview: PptxLayoutPreview, geometry: LayoutPreviewGeometry, container: HTMLElement) => (() => void) | void;
-interface PptxUiRibbonHomeElement extends HTMLElement {
-  state: RibbonHomeViewState;
-  /** Draws a layout's real artwork inside a gallery tile; the host owns element rendering. */
-  layoutArtwork: HomeLayoutArtwork | undefined;
-  /** Wrapper (or button) of a control id. */
-  anchor(id: string): HTMLElement | undefined;
-}
-declare global {
-  interface HTMLElementTagNameMap {
-    'pptx-ui-ribbon-home-clipboard': PptxUiRibbonHomeElement;
-    'pptx-ui-ribbon-home-font': PptxUiRibbonHomeElement;
-    'pptx-ui-ribbon-home-paragraph': PptxUiRibbonHomeElement;
-    'pptx-ui-ribbon-home-editing': PptxUiRibbonHomeElement;
-    'pptx-ui-ribbon-home-slides': PptxUiRibbonHomeElement;
-    'pptx-ui-ribbon-home-drawing': PptxUiRibbonHomeElement;
-    'pptx-ui-ribbon-home-arrange-align': PptxUiRibbonHomeElement;
-    'pptx-ui-ribbon-home-arrange-flip': PptxUiRibbonHomeElement;
-    'pptx-ui-ribbon-home-arrange-order': PptxUiRibbonHomeElement;
-    'pptx-ui-ribbon-home-arrange-edit': PptxUiRibbonHomeElement;
-    'pptx-ui-ribbon-home-font-picker': PptxUiRibbonHomeElement;
-    'pptx-ui-ribbon-home-arrange-painter': PptxUiRibbonHomeElement;
-    'pptx-ui-ribbon-home-arrange-shape': PptxUiRibbonHomeElement;
-  }
-}
-interface PptxUiRibbonTransitionsElement extends HTMLElement {
-  state: RibbonTransitionsViewState;
-}
-declare global {
-  interface HTMLElementTagNameMap {
-    'pptx-ui-ribbon-transitions': PptxUiRibbonTransitionsElement;
-  }
-}
-interface PptxUiRibbonInsertElement extends HTMLElement {
-  state: RibbonInsertState;
-  /** Return focus to a control by its public id, e.g. after a native dialog closes. */
-  focusControl(id: string): void;
-}
-declare global {
-  interface HTMLElementTagNameMap {
-    'pptx-ui-ribbon-insert': PptxUiRibbonInsertElement;
-  }
-}
-interface PptxUiRibbonViewElement extends HTMLElement {
-  state: RibbonViewState;
-}
-declare global {
-  interface HTMLElementTagNameMap {
-    'pptx-ui-ribbon-view': PptxUiRibbonViewElement;
-  }
-}
-//#endregion
-//#region src/web-components/ribbon-section.d.ts
-interface PptxUiRibbonSectionElement extends HTMLElement {
-  groups: readonly RibbonGroupView[];
-}
-declare global {
-  interface HTMLElementTagNameMap {
-    'pptx-ui-ribbon-section': PptxUiRibbonSectionElement;
-  }
-}
-//#endregion
-//#region src/web-components/ribbon-gallery.d.ts
-type GalleryTranslate = (key: string, params?: Readonly<Record<string, string | number>>) => string;
-interface PptxUiRibbonGalleryElement extends HTMLElement {
-  readonly trigger: HTMLButtonElement;
-  readonly popup: HTMLElement;
-  descriptor: RibbonGalleryDescriptor | undefined;
-  translateLabel: GalleryTranslate;
-  disabled: boolean;
-  open: boolean;
-  close(): void;
-}
-declare global {
-  interface HTMLElementTagNameMap {
-    'pptx-ui-ribbon-gallery': PptxUiRibbonGalleryElement;
-  }
-}
-//#endregion
-//#region src/web-components/subtitle-settings.d.ts
-interface PptxUiSubtitleSettingsElement extends HTMLElement {
-  settings: SubtitleSettings;
-  labels: SubtitleSettingsLabels;
-  languageDisabled: boolean;
-}
-declare global {
-  interface HTMLElementTagNameMap {
-    'pptx-ui-subtitle-settings': PptxUiSubtitleSettingsElement;
-  }
-}
-interface PptxUiStatusBarElement extends HTMLElement {
-  state: StatusBarViewState;
-}
-declare global {
-  interface HTMLElementTagNameMap {
-    'pptx-ui-status-bar': PptxUiStatusBarElement;
-  }
-}
-interface PptxUiNotesToolbarElement extends HTMLElement {
-  state: NotesToolbarViewState;
-}
-declare global {
-  interface HTMLElementTagNameMap {
-    'pptx-ui-notes-toolbar': PptxUiNotesToolbarElement;
-  }
-}
-interface PptxUiTitleBarElement extends HTMLElement {
-  state: TitleBarViewState | undefined;
-  placement: TitleBarPlacement;
-}
-declare global {
-  interface HTMLElementTagNameMap {
-    'pptx-ui-title-bar': PptxUiTitleBarElement;
-  }
-}
-//#endregion
-//#region src/web-components/select-value.d.ts
-/**
- * Public DOM shape of `pptx-ui-select`, used by every binding. The element is ooxml-ui's
- * `office-ui-select` under the pptx tag (see `office-aliases.ts`); it is not a native select.
- */
-interface PptxUiSelectElement extends HTMLElement {
-  value: string;
-  disabled: boolean;
-  readonly options: HTMLOptionElement[];
-  selectedIndex: number;
-}
-declare global {
-  interface HTMLElementTagNameMap {
-    'pptx-ui-select': PptxUiSelectElement;
-  }
-}
-//#endregion
-//#region src/render/slide-transition-cinematic.d.ts
-/**
- * Resolve a p15 cinematic transition to its CSS `animation` descriptors, or
- * `undefined` when the type is not a cinematic transition (so the caller can
- * fall through to the classic 2-D / p14 resolvers).
- */
-declare function getCinematicTransitionAnimations(type: PptxTransitionType, durationMs: number, direction: string | undefined, orient?: string | undefined): SlideTransitionAnimations | undefined;
-/**
- * `@keyframes` backing every cinematic transition. Fold into the injected
- * aggregate (`SLIDE_TRANSITION_KEYFRAMES`) so these animate wherever it is
- * injected. `pptx-tr-fade-in` (reused by wind/fracture/airplane incoming) is
- * already defined in the core block, so it is intentionally not redefined here.
- */
-declare const CINEMATIC_TRANSITION_KEYFRAMES: string;
-//#endregion
 //#region src/viewer/animation/transition-overlay.d.ts
 interface TransitionOverlayParams {
   doc: Document;
@@ -16415,5 +12497,5 @@ interface TransitionOverlayParams {
  */
 declare function playTransitionOverlay(params: TransitionOverlayParams): () => void;
 //#endregion
-export { InlineTextSelection as $, ViewerThemeColors as $n, PptxTagCollection as $r, StrokeToInkElementOpts as $t, DEFAULT_MORPH_DURATION_MS as A, forgetSessionDeck as An, PptxCommentMention as Ar, ResolvedDirection as At, ExternalCollaborationAwareness as B, parsePresentationSessionId as Bn, PptxHeaderFooter as Br, RunProgramNotice as Bt, CompatibilityWarningToast as C, ViewportFitPadding as Cn, PptxAnimationTimelineAnchor as Cr, PresentationSnapshot as Ct, CropElementUpdate as D, canInteractWithElement as Dn, PptxChartData as Dr, ReadOnlyRecommendation as Dt, ContextMenuCustomization as E, buildInlineTextCommitPatch as En, PptxAppProperties as Er, RIBBON_TAB_IDS as Et, EditorKeyActionName as F, isLegacyBinaryPresentation as Fn, PptxData as Fr, RibbonGalleryApplyResult as Ft, GradientState as G, resolveOrientation as Gn, PptxNotesMaster as Gr, SessionDeck as Gt, ExternalCollaborationSnapshot as H, rememberSessionDeck as Hn, PptxLayoutPreview as Hr, SLIDE_TRANSITION_KEYFRAMES_CSS as Ht, ElementAnimationState as I, isSupportedPresentationFile as In, PptxElement as Ir, RibbonGalleryContext as It, HostElementMenuContext as J, resolveWheelSpokeCount as Jn, PptxSlide as Jr, ShortcutChord as Jt, Guide as K, resolveSlideTransition as Kn, PptxPresentationProperties as Kr, ShapePresetType as Kt, ElementClipboardPayload as L, loadPresentationDeck as Ln, PptxElementAnimation as Lr, RibbonGroupId as Lt, EASE as M, getP14TransitionAnimations as Mn, PptxCoreProperties as Mr, RibbonContextualTabId as Mt, EDITOR_SHORTCUT_ACTION_IDS as N, getSessionTabId as Nn, PptxCustomProperty as Nr, RibbonControlId as Nt, CropSession as O, createImageElementFromFile as On, PptxComment as Or, RemoteCursor as Ot, ELEMENT_CONTEXT_MENU_COMMAND_IDS as P, getSlideTransitionAnimations as Pn, PptxCustomShow as Pr, RibbonCustomization as Pt, InlineTextEditSnapshot as Q, ViewerTheme as Qn, PptxTableData as Qr, SlideTransitionAnimations as Qt, ElementUpdate as R, loadSessionDeck as Rn, PptxEmbeddedFont as Rr, RibbonTransitionDraft as Rt, CollaborationTransport as S, ViewportFitOptions as Sn, PptxAnimationSequence as Sr, PresentationPointerTool as St, ContextMenuCommandId as T, ZoomNavigationTarget as Tn, PptxAnimationTrigger as Tr, RANDOM_ELIGIBLE_TYPES as Tt, FieldSubstitutionContext as U, resolveDirection as Un, PptxModernCommentAuthor as Ur, SanitizedPresence as Ut, ExternalCollaborationSession as V, presentationBaseName as Vn, PptxImageEffects as Vr, SLIDE_TRANSITION_KEYFRAMES as Vt, FreeformToolKind as W, resolveDirection8 as Wn, PptxModifyVerifier as Wr, SavedPresentationFormat as Wt, INSTANT as X, savedPresentationFileName as Xn, PptxSlideTransition as Xr, SlideSizeRescaleMode as Xt, HostMenuCommand as Y, restoreSessionDeck as Yn, PptxSlideMaster as Yr, SlideSizeEmu as Yt, InlineListReadResult as Z, ThemeCatalogEntry as Zn, PptxTableCellStyle as Zr, SlideTemplateId as Zt, CollabLoadOrigin as _, PptxThemeColorRef as _i, ViewerMode as _n, ParsedTableStyleMap as _r, PPTX_OPEN_ACCEPT as _t, AutosaveRecord as a, PptxTransitionType as ai, ToolbarTabId as an, vermilionLightTheme as ar, ModifyPasswordCheckResult as at, CollaborationRole as b, ViewerPanelId as bn, PptxAnimationPreset as br, PowerPointViewerAPI as bt, BackstageCardId as c, TablePptxElement as ci, VIEWER_FEATURE_IDS as cn, PptxHandler as cr, OPTIONS_SETTING_IDS as ct, CANVAS_CONTEXT_MENU_COMMAND_IDS as d, SmartArtColorScheme as di, ViewerCustomizationApi as dn, SvgExportOptions as dr, OptionsSectionId as dt, PptxTextStyleLevels as ei, TOOLBAR_BUTTON_IDS as en, defaultCssVars as er, InsertChartKind as et, CINEMATIC_TRANSITION_KEYFRAMES as f, SmartArtLayout as fi, ViewerCustomizationController as fn, ElementAction as fr, OptionsSettingId as ft, ChartPartRef as g, XmlObject as gi, ViewerFontSource as gn, OlePptxElement as gr, P14_TRANSITION_KEYFRAMES_ALL as gt, ChangeCaseMode as h, TextStyle as hi, ViewerFeatureId as hn, OleObjectType as hr, P14_TRANSITION_KEYFRAMES_2 as ht, AnimationGroup as i, PptxThemeOption as ii, ToolbarButtonId as in, vermilionDarkTheme as ir, MobileSheetKey as it, DEFAULT_TRANSITION_DURATION_MS as j, getCinematicTransitionAnimations as jn, PptxCompatibilityWarning as jr, ResolvedDirection8 as jt, CssStyleMap as k, describeCollaborationShellState as kn, PptxCommentAuthor as kr, ResolvedCustomization as kt, BackstageCustomization as l, PptxSmartArtData as li, VIEWER_PANEL_IDS as ln, PptxHandlerSaveOptions as lr, OptionsCustomization as lt, CanvasSize as m, TextSegment as mi, ViewerExportFormatId as mn, MediaPptxElement as mr, P14_TRANSITION_KEYFRAMES as mt, playTransitionOverlay as n, PptxThemeColorScheme as ni, TextAdvancedChanges as nn, defaultThemeColors as nr, MasterViewCrudAction as nt, BACKSTAGE_CARD_IDS as o, PptxViewProperties as oi, VIEWER_DIALOG_IDS as on, AccessibilityIssue as or, OPTIONS_PAGE_IDS as ot, CanvasContextMenuCommandId as p, SmartArtLayoutType as pi, ViewerDialogId as pn, MasterViewTab as pr, OptionsSettingValues as pt, HostCanvasMenuContext as q, resolveTransitionDurationMs as qn, PptxSection as qr, ShareDefaults as qt, AccountAuthConfig as r, PptxThemeFontScheme as ri, ToolbarActionId as rn, themeToCssVars as rr, MasterViewCrudActionId as rt, BACKSTAGE_PAGE_IDS as s, ShapeStyle as si, VIEWER_EXPORT_FORMAT_IDS as sn, MergeShapeOperation as sr, OPTIONS_SECTION_IDS as st, TransitionOverlayParams as t, PptxTheme as ti, TRANSITION_SPEED_DURATION_MS as tn, defaultRadius as tr, KeyboardCustomization as tt, BackstagePage as u, PptxSmartArtNodeStyle as ui, ViewerCustomization as un, PptxSaveFormat as ur, OptionsPageId as ut, CollaborationConfig as v, ViewerOptionPrimitive as vn, PptxAfterAnimationAction as vr, PRESENTATION_OPEN_EXTENSIONS as vt, ConnectionStatus as w, WHEEL_SPOKE_COUNTS as wn, PptxAnimationTimingCurve as wr, PrintSettings as wt, CollaborationShellState as x, ViewerQuickAccessOptions as xn, PptxAnimationRepeatMode as xr, PresentationBlackout as xt, CollaborationLivePatcher as y, ViewerOptionsStore as yn, PptxAnimationDirection as yr, PasteSpecialFormat as yt, ElementUpdateOptions as z, overlayInlineTextSnapshot as zn, PptxHandoutMaster as zr, RulerUnit as zt };
-//# sourceMappingURL=transition-overlay-C_wuJuse.d.ts.map
+export { PptxThemeOption as $, PptxCustomShow as A, PptxModifyVerifier as B, PptxAppProperties as C, PptxCommentMention as D, PptxCommentAuthor as E, PptxHandoutMaster as F, PptxSlideMaster as G, PptxPresentationProperties as H, PptxHeaderFooter as I, PptxTableData as J, PptxSlideTransition as K, PptxImageEffects as L, PptxElement as M, PptxElementAnimation as N, PptxCoreProperties as O, PptxEmbeddedFont as P, PptxThemeFontScheme as Q, PptxLayoutPreview as R, PptxAnimationTrigger as S, PptxComment as T, PptxSection as U, PptxNotesMaster as V, PptxSlide as W, PptxTextStyleLevels as X, PptxTagCollection as Y, PptxThemeColorScheme as Z, PptxAnimationPreset as _, PptxHandler as a, PptxSmartArtNodeStyle as at, PptxAnimationTimelineAnchor as b, SvgExportOptions as c, SmartArtLayoutType as ct, MediaPptxElement as d, XmlObject as dt, PptxTransitionType as et, OleObjectType as f, PptxThemeColorRef as ft, PptxAnimationDirection as g, PptxAfterAnimationAction as h, MergeShapeOperation as i, PptxSmartArtData as it, PptxData as j, PptxCustomProperty as k, ElementAction as l, TextSegment as lt, ParsedTableStyleMap as m, playTransitionOverlay as n, ShapeStyle as nt, PptxHandlerSaveOptions as o, SmartArtColorScheme as ot, OlePptxElement as p, PptxTableCellStyle as q, AccessibilityIssue as r, TablePptxElement as rt, PptxSaveFormat as s, SmartArtLayout as st, TransitionOverlayParams as t, PptxViewProperties as tt, MasterViewTab as u, TextStyle as ut, PptxAnimationRepeatMode as v, PptxChartData as w, PptxAnimationTimingCurve as x, PptxAnimationSequence as y, PptxModernCommentAuthor as z };
+//# sourceMappingURL=transition-overlay-CxqDHlcC.d.ts.map