pptx-vanilla-viewer 2.0.2 → 2.1.0

package/dist/index.d.ts

@@ -3,7 +3,7 @@ import "jszip";
 import { ChatTransport, LanguageModel, ToolSet, UIMessage } from "ai";
 import "pptx-viewer-mcp";
 import { Options } from "html2canvas-pro";
-//#region ../core/dist/text-operations-mlsQMjIC.d.ts
+//#region ../core/dist/text-operations-Dg5-_6uo.d.ts
 //#region src/core/types/actions.d.ts
 /**
  * Action types: hyperlinks, slide jumps, macros, and action buttons.
@@ -1722,6 +1722,32 @@ interface TextStyle {
   textReflectionEndOpacity?: number;
   /** Text reflection offset distance in px. */
   textReflectionOffset?: number;
+  /**
+   * Text reflection fade direction (`a:rPr/a:effectLst/a:reflection/@fadeDir`)
+   * in degrees. Mirrors `ShapeStyle.reflectionFadeDirection`.
+   */
+  textReflectionFadeDirection?: number;
+  /**
+   * Text reflection horizontal scaling (`@sx`), same units as
+   * `ShapeStyle.reflectionScaleX` (1000ths of a percent, e.g. 100000 = 100%).
+   */
+  textReflectionScaleX?: number;
+  /** Text reflection vertical scaling (`@sy`). See `ShapeStyle.reflectionScaleY`. */
+  textReflectionScaleY?: number;
+  /**
+   * Text reflection horizontal skew (`@kx`) in 60000ths of a degree. See
+   * `ShapeStyle.reflectionSkewX`.
+   */
+  textReflectionSkewX?: number;
+  /** Text reflection vertical skew (`@ky`). See `ShapeStyle.reflectionSkewY`. */
+  textReflectionSkewY?: number;
+  /**
+   * Text reflection independent rotation (`@rot`) in degrees. See
+   * `ShapeStyle.reflectionRotation`.
+   */
+  textReflectionRotation?: number;
+  /** Text reflection anchor (`@algn`). See `ShapeStyle.reflectionAlignment`. */
+  textReflectionAlignment?: 'tl' | 't' | 'tr' | 'l' | 'ctr' | 'r' | 'bl' | 'b' | 'br';
   /** 3D extrusion/bevel settings on the text body. */
   text3d?: Text3DStyle;
   /** 3D scene (camera + light rig) settings on the text body (`a:bodyPr/a:scene3d`). */
@@ -5423,6 +5449,21 @@ interface ContentPartInkStroke {
    * variable-width strokes that reflect stylus/pen pressure.
    */
   pressures?: number[];
+  /**
+   * Per-point pen-tilt lean direction (radians), decoded from the source
+   * InkML's `OTx`/`OTy` tilt-offset channels or its `AZIMUTH` channel.
+   *
+   * When present (paired with {@link tiltMagnitudes}), the renderer widens
+   * each point perpendicular to the lean direction, approximating a
+   * calligraphic (chisel-tip) nib. Absent when the source declared no tilt
+   * channel, in which case rendering is unaffected.
+   */
+  tiltAngles?: number[];
+  /**
+   * Per-point pen-tilt strength (0 upright, 1 maximally leaned), paired with
+   * {@link tiltAngles}.
+   */
+  tiltMagnitudes?: number[];
 }
 /**
  * A content-part element wrapped in `mc:AlternateContent`.
@@ -5991,6 +6032,19 @@ interface PptxNativeAnimation {
   scaleZoomContents?: boolean;
   /** Parsed `p:tav` keyframes from `p:tavLst` (CT_TLAnimVariantList). */
   keyframes?: PptxAnimationKeyframe[];
+  /**
+   * The attribute {@link keyframes} drives, from the SAME node's
+   * `p:cBhvr/p:attrNameLst/p:attrName` (ECMA-376 S19.5.4). `p:tavLst` is
+   * schema-generic: without this, playback could see a numeric ramp but not
+   * know whether it targeted opacity, position, colour, or something with
+   * no CSS mapping. Lowercased and trimmed; common values seen in the wild
+   * (and written by this codebase's own animation writer) include
+   * `"style.opacity"`, `"style.color"`, `"style.visibility"`, `"fillcolor"`,
+   * `"stroke.color"`, `"r"` (rotation, only meaningful on `p:animRot`), and
+   * `"ppt_x"` / `"ppt_y"` (position, normally driven via `p:animMotion`
+   * instead). Absent when the behaviour carries no `p:attrNameLst`.
+   */
+  attrName?: string;
   /** Repeat count (e.g. `2`, `Infinity` for indefinite). */
   repeatCount?: number;
   /** Whether the animation plays in reverse after completion. */
@@ -6092,6 +6146,17 @@ interface PptxNativeAnimation {
   textTarget?: PptxTextAnimationTarget;
   /** Whether this animation is inside an exclusive container (`p:excl`). */
   exclusive?: boolean;
+  /**
+   * Identifies which `p:excl` container this animation belongs to, when
+   * {@link exclusive} is set. ECMA-376 S19.5.24 CT_TLExclusiveTimeNode: at
+   * most one direct child of an exclusive container may be active at a
+   * time, so starting one child stops any other currently-playing child of
+   * the SAME container. Two different `p:excl` containers on the same slide
+   * are independent groups; this id (assigned per container encountered
+   * during parsing, stable only within one parse's animation list) lets
+   * playback tell them apart. Absent when {@link exclusive} is unset.
+   */
+  exclGroupId?: number;
   /** Command type from `p:cmd` (@_type: call/evt/verb). */
   commandType?: string;
   /** Command string from `p:cmd` (@_cmd). */
@@ -6375,6 +6440,52 @@ interface PptxElementAnimation {
   soundPath?: string;
   /** Whether to stop any currently playing sound (`p:endSnd`). */
   stopSound?: boolean;
+  /**
+   * Pending, not-yet-embedded sound chosen in the authoring UI, as a
+   * `data:audio/...;base64,...` URL. Mirrors the `imageData` /
+   * `mediaData` pending-embed convention used elsewhere in the typed model:
+   * on save, the writer converts this to real bytes under `ppt/media/`,
+   * mints a relationship, and replaces this field with the resolved
+   * {@link soundRId} / {@link soundPath}. Cleared once embedded.
+   */
+  soundData?: string;
+  /**
+   * Display name for the chosen sound (e.g. the uploaded file's name),
+   * shown by the authoring UI's sound picker. Purely cosmetic; has no
+   * OOXML equivalent and is not required for playback.
+   */
+  soundFileName?: string;
+}
+/**
+ * A read-only anchor representing one of the deck's own effect groups: a
+ * top-level click group (`p:par` under `p:timing`'s main sequence) that this
+ * app did not author, so it is never exposed as an editable
+ * {@link PptxElementAnimation}.
+ *
+ * The authoring UI merges these anchors alongside `PptxSlide.animations` to
+ * render the FULL animation sequence (editor-authored and deck-native
+ * effects together) and lets an editor-authored entry be dragged to any
+ * position relative to them. `order` is the anchor's position among ALL
+ * top-level click groups (editor-owned and native) at load time, in the same
+ * numbering space as {@link PptxElementAnimation.order}, so the two
+ * populations sort into one coherent timeline.
+ *
+ * Anchors are never written back: on save, an untouched anchor's own click
+ * group is repositioned (if an editor-authored effect was dragged past it)
+ * but never mutated, so the deck's own effect stays byte-identical apart
+ * from its position in the sequence.
+ */
+interface PptxAnimationTimelineAnchor {
+  /**
+   * Position of this group among all top-level click groups in the main
+   * animation sequence at load time (dense, shared with editor entries'
+   * `order`).
+   */
+  order: number;
+  /** Shape id(s) this group's effects target, for a readable UI label. */
+  targetIds: string[];
+  /** Effect preset classes present in the group (entr/exit/emph/path). */
+  presetClasses: Array<'entr' | 'exit' | 'emph' | 'path'>;
 }
 //#endregion
 //#region src/core/types/embedded-font.d.ts
@@ -7078,8 +7189,19 @@ interface PptxSlideTransition {
   soundLoop?: boolean;
   /** Resolved transition sound media path within the package. */
   soundPath?: string;
-  /** Human-readable sound file name (extracted from soundPath). */
+  /** Human-readable sound file name (extracted from soundPath, or set by the
+   * UI when a new file is picked, before it has a soundPath at all). */
   soundFileName?: string;
+  /**
+   * A newly-picked local sound file awaiting embedding, as a `data:` URL.
+   * Set by the transitions ribbon's Sound picker (`applyTransitionSoundFile`
+   * in `pptx-viewer-shared`) when the user chooses a file that is not yet
+   * part of the package; mirrors `imageData`/`mediaData` on picture and media
+   * elements. The save pipeline (`embedTransitionSound`) writes the bytes to
+   * `ppt/media/`, mints a relationship, sets `soundRId`/`soundPath`, and
+   * clears this field so a later save does not re-embed the same bytes.
+   */
+  soundData?: string;
   /**
    * When true, the transition stops the currently-playing sound (OOXML `p:sndAc/p:endSnd`).
    * Mutually exclusive with `soundRId`/`soundPath` (which use `p:stSnd`).
@@ -7353,17 +7475,29 @@ interface PptxSlide {
   backgroundPattern?: PptxSlideBackgroundPattern;
   /**
    * `<p:bgPr/@shadeToTitle>`: boolean flag instructing the renderer to
-   * shade the background toward the title placeholder colour. Captured
-   * for lossless round-trip only; no renderer applies the visual effect.
-   * Documented as a known no-op in `docs/guide/limitations.md` (legacy
-   * PowerPoint 97-2003 hint, not observed in any real-world corpus file
-   * and not settable from any modern PowerPoint UI).
+   * shade the background gradient toward the title placeholder's text
+   * colour. Parsed and round-tripped here on the core model; the actual
+   * visual effect is applied by `pptx-viewer-shared`'s
+   * `getSlideBackgroundStyle` (see `render/background-shade-to-title.ts`),
+   * consumed by all five bindings, not by core itself. That module's
+   * docstring explains the approximation: no published ECMA-376 or
+   * MS-ODRAWXML text documents the exact legacy blend. Legacy PowerPoint
+   * 97-2003 hint, not observed in any real-world corpus file this project
+   * has collected and not settable from any modern PowerPoint UI; see
+   * `docs/guide/limitations.md`.
    *
    * ECMA-376 §19.3.1.2 (CT_BackgroundProperties).
    */
   backgroundShadeToTitle?: boolean;
   transition?: PptxSlideTransition;
   animations?: PptxElementAnimation[];
+  /**
+   * Read-only anchors for the deck's own (non-editor-authored) effect
+   * groups, merged with `animations` by the authoring UI so drag-to-reorder
+   * can target any position in the full sequence. See
+   * {@link PptxAnimationTimelineAnchor}.
+   */
+  animationTimelineAnchors?: PptxAnimationTimelineAnchor[];
   /** Native OOXML animation data parsed from `p:timing`. */
   nativeAnimations?: PptxNativeAnimation[];
   /** Preserved raw `p:timing` XML for lossless round-trip of native animations. */
@@ -7916,7 +8050,7 @@ interface PptxEmbeddedFont {
   originalPartBytes?: Uint8Array;
 }
 //#endregion
-//#region ../core/dist/index-DNZI4fvG.d.ts
+//#region ../core/dist/index-Cwwrmmqf.d.ts
 //#region src/core/types/theme-presets.d.ts
 /**
  * A complete theme preset that can be applied to a presentation.
@@ -8756,12 +8890,25 @@ interface IPptxHandlerRuntimeFactory {
  */
 /** Supported encryption algorithms. */
 type EncryptionAlgorithm = 'AES128' | 'AES256';
+/**
+ * Which OOXML encryption scheme to write when creating a password-protected
+ * file. Real PowerPoint can write and open either scheme; this library
+ * defaults to 'agile' (Office 2010+), matching PowerPoint's own default.
+ */
+type EncryptionScheme = 'agile' | 'standard';
 /** Encryption options for creating encrypted files. */
 interface EncryptionOptions {
   /** The encryption algorithm to use (defaults to AES256). */
   algorithm?: EncryptionAlgorithm;
   /** Number of hash iterations for key derivation (defaults to 100000). Lower values speed up tests. */
   spinCount?: number;
+  /**
+   * Which encryption scheme to write (defaults to 'agile'). 'standard'
+   * writes the ECMA-376 Standard scheme (Office 2007-compatible: a single
+   * password-derived AES-CBC key with a zero IV over the whole package),
+   * mirroring the scheme this library already knows how to decrypt.
+   */
+  encryptionScheme?: EncryptionScheme;
 }
 //#endregion
 //#region src/core/PptxHandlerCore.d.ts
@@ -10084,6 +10231,15 @@ interface Guide {
 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;
 }
 /** Options for {@link strokeToInkElement}. */
 interface StrokeToInkElementOpts {
@@ -10124,10 +10280,13 @@ interface GradientState {
 /**
  * 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. The six ChartEx ids
- * (`histogram` through `regionMap`) map one-to-one onto their chart type.
+ * 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' | 'funnel' | 'treemap' | 'sunburst' | 'boxWhisker' | 'regionMap';
+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;
@@ -10354,6 +10513,34 @@ interface ElementRenderContext {
    * when the option is unset.
    */
   readonly surfaceChart3D: boolean;
+  /**
+   * Opt-in flag: render `bar3D` charts as an interactive, camera-orbitable
+   * Three.js box-mesh scene instead of the flat SVG oblique-projection
+   * illusion (see `PptxViewerOptions.barChart3D`). Defaults to `false` when
+   * the option is unset.
+   */
+  readonly barChart3D: boolean;
+  /**
+   * Opt-in flag: render `line3D` charts as an interactive, camera-orbitable
+   * Three.js tube-path scene instead of the flat SVG oblique-projection
+   * illusion (see `PptxViewerOptions.lineChart3D`). Defaults to `false` when
+   * the option is unset.
+   */
+  readonly lineChart3D: boolean;
+  /**
+   * Opt-in flag: render `area3D` charts as an interactive, camera-orbitable
+   * Three.js tube-path + ribbon-fill scene instead of the flat SVG
+   * oblique-projection illusion (see `PptxViewerOptions.areaChart3D`).
+   * Defaults to `false` when the option is unset.
+   */
+  readonly areaChart3D: boolean;
+  /**
+   * Opt-in flag: render `pie3D` charts as an interactive, camera-orbitable
+   * Three.js wedge-mesh scene instead of the flat SVG oblique-projection
+   * illusion (see `PptxViewerOptions.pieChart3D`). Defaults to `false` when
+   * the option is unset.
+   */
+  readonly pieChart3D: boolean;
   /**
    * True only for the live presentation stage (real Fullscreen API active):
    * media renderers use this to autoplay once mounted, matching PowerPoint's
@@ -10511,6 +10698,26 @@ interface SlideStageOptions {
    * `PptxViewerOptions.surfaceChart3D`.
    */
   surfaceChart3D?: boolean;
+  /**
+   * Opt-in interactive WebGL bar3D-chart renderer flag; see
+   * `PptxViewerOptions.barChart3D`.
+   */
+  barChart3D?: boolean;
+  /**
+   * Opt-in interactive WebGL line3D-chart renderer flag; see
+   * `PptxViewerOptions.lineChart3D`.
+   */
+  lineChart3D?: boolean;
+  /**
+   * Opt-in interactive WebGL area3D-chart renderer flag; see
+   * `PptxViewerOptions.areaChart3D`.
+   */
+  areaChart3D?: boolean;
+  /**
+   * Opt-in interactive WebGL pie3D-chart renderer flag; see
+   * `PptxViewerOptions.pieChart3D`.
+   */
+  pieChart3D?: boolean;
   /** True only for the live presentation stage; see `ElementRenderContext.presenting`. */
   presenting?: boolean;
   /** Full deck and active index used by presentation Zoom elements. */
@@ -10813,6 +11020,8 @@ interface AnimationTimingPatch {
   repeatCount?: number;
   repeatMode?: PptxAnimationRepeatMode | 'none';
   triggerShapeId?: string;
+  afterAnimation?: PptxAfterAnimationAction;
+  afterAnimationColor?: string;
 }
 interface AnimationActions {
   addAnimation(group: AnimationGroup, preset: PptxAnimationPreset): void;
@@ -10835,6 +11044,14 @@ interface AnimationActions {
   /** Replace the selected element's raw path (canvas end-handle drag commit). */
   setMotionPathData(path: string): void;
   setAnimationTiming(elementId: string, patch: AnimationTimingPatch): void;
+  /**
+   * Stage a newly-picked effect sound file (a pending `data:` URL, embedded
+   * on save), or clear the sound entirely when `pick` is `undefined`.
+   */
+  setAnimationSound(elementId: string, pick: {
+    dataUrl: string;
+    fileName?: string;
+  } | undefined): void;
   reorderAnimation(elementId: string, direction: 'up' | 'down'): void;
   moveAnimation(elementId: string, index: number): void;
 }
@@ -10965,10 +11182,13 @@ interface InkActions {
    */
   commitStroke(stroke: StrokeToInkElementOpts): void;
   /**
-   * Remove the ink element with `id` from the current slide (Draw tab's
-   * eraser tool). Returns `true` when an ink element was found and removed;
-   * `false` for a missing id, a non-ink element, or a read-only viewer (safe
-   * to call from a generic stage hit-test without a pre-check).
+   * Remove the ink/contentPart element with `id` from the current slide
+   * (Draw tab's eraser tool). `contentPart` is included because ink saved
+   * via the Draw tab reloads in that shape, so it must stay erasable after a
+   * save/reload round-trip. Returns `true` when a matching element was found
+   * and removed; `false` for a missing id, an unrelated element, or a
+   * read-only viewer (safe to call from a generic stage hit-test without a
+   * pre-check).
    */
   eraseInkElement(id: string): boolean;
 }
@@ -11026,6 +11246,8 @@ interface InspectorActions {
   setElementAction(trigger: 'click' | 'hover', action: ElementAction): void;
   /** Set the selection's accessibility description (inspector Alt Text field). */
   setAltText(text: string): void;
+  /** Set the selected OLE element's Object Name (`p:oleObj/@name`). */
+  setOleName(name: string): void;
   setChartData(data: PptxChartData): void;
   setMediaProperties(patch: Partial<MediaPptxElement>): void;
   setTableHeaderRow(enabled: boolean): void;
@@ -11159,6 +11381,13 @@ interface TransitionActions {
    * comes from the shared `ribbonTransitionTargets`.
    */
   applyTransitionDraft(draft: RibbonTransitionDraft, applyToAll: boolean): void;
+  /**
+   * Merge a raw partial change onto the ACTIVE slide's transition, for
+   * controls that write a single field outside the ribbon draft (currently
+   * the Sound picker: a freshly-picked file's `soundData` has no equivalent
+   * in {@link RibbonTransitionDraft}).
+   */
+  applyTransitionChange(changes: Partial<PptxSlideTransition>): void;
 }
 //#endregion
 //#region src/viewer/editor/editor-edit-ops.d.ts
@@ -11264,6 +11493,8 @@ interface InspectorState {
   oleObjectType: OleObjectType | undefined;
   oleFileName: string | undefined;
   oleIsLinked: boolean;
+  /** The OLE object's author-assigned name (`p:oleObj/@name`), if any. */
+  oleName: string | undefined;
   x: number;
   y: number;
   width: number;
@@ -11563,6 +11794,14 @@ interface RibbonTransitionHandlers {
   readDraft(): RibbonTransitionDraft;
   /** Commit the tab's whole draft, onto the active slide or every slide. */
   applyDraft(draft: RibbonTransitionDraft, applyToAll: boolean): void;
+  /** The ACTIVE slide's raw transition, for fields the draft does not carry (the Sound picker). */
+  readTransition(): PptxSlideTransition | undefined;
+  /**
+   * Merge a raw partial change onto the active slide's transition. Used by
+   * the Sound picker: a freshly-picked file's `soundData` has no equivalent
+   * in {@link RibbonTransitionDraft}.
+   */
+  applyChange(changes: Partial<PptxSlideTransition>): void;
 }
 /**
  * Design tab handler: swap the viewer chrome's `ViewerTheme` (the shared
@@ -11649,6 +11888,8 @@ interface RibbonSelectionState {
   formatPainterActive?: boolean;
   selectedElementId?: string;
   animations?: readonly PptxElementAnimation[];
+  /** Read-only anchors for the active slide's deck-native effect groups. */
+  animationTimelineAnchors?: readonly PptxAnimationTimelineAnchor[];
   /** Available slide layouts for the Slides group's New Slide / Layout menus. */
   layouts?: readonly LayoutOption[];
   /** Artwork for the layout gallery thumbnails, keyed by layout path. */
@@ -12668,6 +12909,55 @@ interface PptxViewerOptions extends PptxViewerCallbacks {
    * Vue/React/Angular/Svelte bindings).
    */
   surfaceChart3D?: boolean;
+  /**
+   * Opt in to the interactive Three.js bar3D-chart renderer (default
+   * `false`). When `true`, `bar3D` charts render as camera-orbitable real
+   * box meshes (drag to rotate, scroll to zoom) instead of the flat SVG
+   * oblique-projection illusion. Chart marks are not selectable/draggable in
+   * this mode. `three` is an optional peer dependency, lazily imported only
+   * when this is `true`; when it is unavailable, the chart has no plottable
+   * grid, or it is a horizontal 3-D Bar, the SVG renderer is used instead.
+   * Set once at construction (no runtime setter, mirroring the
+   * Vue/React/Angular/Svelte bindings).
+   */
+  barChart3D?: boolean;
+  /**
+   * Opt in to the interactive Three.js line3D-chart renderer (default
+   * `false`). When `true`, `line3D` charts render as camera-orbitable real
+   * tube-path meshes, one per depth ("series") plane (drag to rotate, scroll
+   * to zoom), instead of the flat SVG oblique-projection illusion. Chart
+   * marks are not selectable/draggable in this mode. `three` is an optional
+   * peer dependency, lazily imported only when this is `true`; when it is
+   * unavailable or the chart has no plottable grid, the SVG renderer is used
+   * instead. Set once at construction (no runtime setter, mirroring the
+   * Vue/React/Angular/Svelte bindings).
+   */
+  lineChart3D?: boolean;
+  /**
+   * Opt in to the interactive Three.js area3D-chart renderer (default
+   * `false`). When `true`, `area3D` charts render as camera-orbitable real
+   * tube-path meshes plus a filled ribbon mesh per series, one per depth
+   * ("series") plane (drag to rotate, scroll to zoom), instead of the flat
+   * SVG oblique-projection illusion. Chart marks are not selectable/draggable
+   * in this mode. `three` is an optional peer dependency, lazily imported
+   * only when this is `true`; when it is unavailable or the chart has no
+   * plottable grid, the SVG renderer is used instead. Set once at
+   * construction (no runtime setter, mirroring the Vue/React/Angular/Svelte
+   * bindings).
+   */
+  areaChart3D?: boolean;
+  /**
+   * Opt in to the interactive Three.js pie3D-chart renderer (default
+   * `false`). When `true`, `pie3D` charts render as camera-orbitable real
+   * wedge meshes (drag to rotate, scroll to zoom) instead of the flat SVG
+   * oblique-projection illusion. Chart marks are not selectable/draggable in
+   * this mode. `three` is an optional peer dependency, lazily imported only
+   * when this is `true`; when it is unavailable or the chart has no
+   * plottable series, the SVG renderer is used instead. Set once at
+   * construction (no runtime setter, mirroring the
+   * Vue/React/Angular/Svelte bindings).
+   */
+  pieChart3D?: boolean;
   /**
    * Whether this application PERMITS recovery autosave (`@default true`).
    *