pptx-angular-viewer 4.10.1 → 4.11.0

package/types/pptx-angular-viewer.d.ts

@@ -1,5 +1,5 @@
 import * as pptx_viewer_core from 'pptx-viewer-core';
-import { PptxThemePreset, PptxElement, PptxSlide, ShapeStyle, PptxTextWarpPreset, XmlObject, PptxChartSeries, PptxChartLegendTextStyle, PptxChartMarkerSymbol, PptxChartDataPointPicture, PptxChartData, PptxChartDataLabelPosition, PptxChartType, PptxElementAnimation, PptxAnimationPreset, PptxAnimationSequence, PptxAnimationTrigger, PptxAnimationTimingCurve, PptxAnimationRepeatMode, PptxAnimationDirection, PptxAfterAnimationAction, ParsedTableStyleMap, PptxThemeColorScheme, PptxThemeFontScheme, TablePptxElement, PptxSection, OlePptxElement, TextSegment, TextStyle, PptxTransitionType, PptxSlideTransition, PptxBar3DShape, SmartArtLayoutType, PptxSmartArtDrawingShape, SmartArtColorScheme, PptxSmartArtChrome, SmartArtStyle, PptxSmartArtData, PptxThemeColorRef, PlaceholderDefaults, PptxEmbeddedFont, SmartArtLayout, AccessibilityIssueSeverity, AccessibilityIssue, AccessibilityIssueType, AccessibilityCheckOptions, ElementActionType, InkPptxElement, PptxComment, PptxChartBarDirection, ImagePptxElement, MasterViewTab, PptxHeaderFooter, PptxPresentationProperties, PptxViewProperties, PptxCustomShow, PptxCoreProperties, PptxAppProperties, PptxCustomProperty, PptxTagCollection, PptxSlideMaster, PptxNotesMaster, PptxHandoutMaster, PptxSlideSize, PptxSaveFormat, MediaPptxElement, PptxTheme, PptxHandler, PptxData, PptxHandlerSaveOptions, PptxModernCommentAuthor, PptxCommentMention, PptxThemeOption, ParsedSignature, PptxLayoutPreview, PptxTableCell, PptxTableCellStyle, PptxTableRow, PptxTableData, SvgExportOptions, PptxLayoutOption, PptxGridSpacing, ChartPptxElement, RenderedNode, RenderedCircleNode, RenderedPolygonNode, RenderedRectNode, SmartArtLayoutResult, Model3DPptxElement, ZoomPptxElement, SmartArtPptxElement, PptxAnimationTimelineAnchor, MaterialPresetType, Text3DStyle, BevelPresetType, PptxChartDataLabelOptions, PptxChartAxisType, PptxChartAxisFormatting, PptxChartMarker, PptxChartDataPoint, PptxChartTrendline, PptxChartErrBars, PptxTextStyleLevels, SignatureStatus, ElementAction, PptxImageEffects, MediaBookmark, ColorMapAliasKey, ChartAxisEdit, ChartDataPointLabelEdit, PptxChartLegendPosition, PptxChartStyle, ChartAxisTitleStyleEdit, ChartGridlineStyleEdit, PptxSmartArtNode, PptxSmartArtNodeStyle, MediaCaptionTrack, PptxMediaType } from 'pptx-viewer-core';
+import { PptxThemePreset, PptxElement, PptxSlide, ShapeStyle, PptxTextWarpPreset, XmlObject, PptxChartSeries, PptxChartLegendTextStyle, PptxChartData, PptxChartDataLabelPosition, PptxChartType, PptxElementAnimation, PptxAnimationPreset, PptxAnimationSequence, PptxAnimationTrigger, PptxAnimationTimingCurve, PptxAnimationRepeatMode, PptxAnimationDirection, PptxAfterAnimationAction, ParsedTableStyleMap, PptxThemeColorScheme, PptxThemeFontScheme, TablePptxElement, PptxSection, OlePptxElement, TextSegment, TextStyle, PptxTransitionType, PptxSlideTransition, PptxBar3DShape, SmartArtLayoutType, PptxSmartArtDrawingShape, SmartArtColorScheme, PptxSmartArtChrome, SmartArtStyle, PptxSmartArtData, PptxThemeColorRef, PlaceholderDefaults, PptxEmbeddedFont, SmartArtLayout, AccessibilityIssueSeverity, AccessibilityIssue, AccessibilityIssueType, AccessibilityCheckOptions, ElementActionType, InkPptxElement, PptxComment, PptxChartBarDirection, ImagePptxElement, MasterViewTab, PptxHeaderFooter, PptxPresentationProperties, PptxViewProperties, PptxCustomShow, PptxCoreProperties, PptxAppProperties, PptxCustomProperty, PptxTagCollection, PptxSlideMaster, PptxNotesMaster, PptxHandoutMaster, PptxSlideSize, PptxSaveFormat, MediaPptxElement, PptxTheme, PptxHandler, PptxData, PptxHandlerSaveOptions, PptxModernCommentAuthor, PptxCommentMention, PptxThemeOption, ParsedSignature, PptxLayoutPreview, PptxTableCell, PptxTableCellStyle, PptxTableRow, PptxTableData, SvgExportOptions, PptxLayoutOption, PptxGridSpacing, ChartPptxElement, RenderedNode, RenderedCircleNode, RenderedPolygonNode, RenderedRectNode, SmartArtLayoutResult, Model3DPptxElement, ZoomPptxElement, SmartArtPptxElement, PptxAnimationTimelineAnchor, MaterialPresetType, Text3DStyle, BevelPresetType, PptxChartDataLabelOptions, PptxChartAxisType, PptxChartAxisFormatting, PptxChartMarker, PptxChartDataPoint, PptxChartTrendline, PptxChartErrBars, PptxTextStyleLevels, SignatureStatus, ElementAction, PptxImageEffects, MediaBookmark, ColorMapAliasKey, ChartAxisEdit, ChartDataPointLabelEdit, PptxChartLegendPosition, PptxChartStyle, ChartAxisTitleStyleEdit, PptxChartMarkerSymbol, ChartGridlineStyleEdit, PptxSmartArtNode, PptxSmartArtNodeStyle, MediaCaptionTrack, PptxMediaType } from 'pptx-viewer-core';
 export { GroupResult, SWITCHABLE_LAYOUT_TYPES, UngroupResult, addSmartArtNode, addSmartArtNodeAsChild, chartDataChangeType, chartDataUpdatePoint, demoteSmartArtNode, formatAutoNumberMarker as formatAutoNumber, groupElements, promoteSmartArtNode, removeSmartArtNode, reorderSmartArtNode, switchSmartArtLayout, ungroupElements, updateSmartArtNodeText } from 'pptx-viewer-core';
 import { Doc } from 'yjs';
 import * as _angular_core from '@angular/core';
@@ -1598,71 +1598,6 @@ interface SvgAreaGradient {
 }
 type SvgPrimitive = SvgRect | SvgPath | SvgPolyline | SvgCircle | SvgLine | SvgPolygon | SvgText | SvgAreaGradient;
 
-/**
- * chart-datapoint-style.ts: framework-agnostic resolution of per-data-point
- * formatting overrides (`c:dPt`).
- *
- * A chart series may override the appearance of individual data points: a
- * per-point fill colour, or (for pie/doughnut) a slice "explosion" pull-out
- * distance. These helpers resolve the effective value for a given point index,
- * falling back to the series-level default, so every binding (React/Vue/Angular)
- * can render edited per-point formatting identically without re-implementing the
- * lookup.
- *
- * @module chart-datapoint-style
- */
-
-/** Minimal shape props subset needed to resolve a point fill. */
-interface PointShapeProps {
-    fillColor?: string;
-}
-/** Minimal marker shape consumed here (mirrors `PptxChartMarker`). */
-interface ChartMarkerLike {
-    symbol?: PptxChartMarkerSymbol;
-    size?: number;
-    spPr?: PointShapeProps;
-}
-/** Minimal data-point shape consumed here (mirrors `PptxChartDataPoint`). */
-interface ChartDataPointLike {
-    idx: number;
-    spPr?: PointShapeProps;
-    explosion?: number;
-    marker?: ChartMarkerLike;
-    picture?: PptxChartDataPointPicture;
-    /**
-     * A picture fill implied by a bare `c:dPt/c:spPr/a:blipFill` with no
-     * sibling `c:pictureOptions` (mirrors `PptxChartDataPoint.impliedPicture`).
-     * {@link resolveActiveDataPointPicture} falls back to this only when
-     * {@link picture} did not resolve an image of its own.
-     */
-    impliedPicture?: PptxChartDataPointPicture;
-}
-/** Minimal series shape consumed here (mirrors `PptxChartSeries`). */
-interface ChartSeriesLike {
-    color?: string;
-    marker?: ChartMarkerLike;
-    dataPoints?: ChartDataPointLike[];
-    /**
-     * This series' `c:ser/c:idx/@val` (mirrors `PptxChartSeries.idx`). Used to
-     * key the automatic marker-symbol cycle so a chart with non-sequential or
-     * gapped indices (a deleted/filtered series) still lands on the same shape
-     * PowerPoint does; falls back to the caller-supplied array position when
-     * absent.
-     */
-    idx?: number;
-    /**
-     * Series-level picture-fill flags (`c:ser/c:pictureOptions`): paints every
-     * point in the series with one picture unless a `c:dPt` resolves its own
-     * (see {@link resolveActiveDataPointPicture}).
-     */
-    picture?: PptxChartDataPointPicture;
-    /**
-     * A picture fill implied by a bare `c:ser/c:spPr/a:blipFill` with no
-     * sibling `c:pictureOptions` (mirrors `PptxChartSeries.impliedPicture`).
-     */
-    impliedPicture?: PptxChartDataPointPicture;
-}
-
 /**
  * chart-legend-build.ts: builds the base `LegendEntry[]` (colour + label +
  * optional line-style swatch) and the legend's anchor position for a chart
@@ -6323,256 +6258,6 @@ interface SmartArt3DModel {
     lighting?: SmartArt3DLighting;
 }
 
-/**
- * Pure surface-chart 3D geometry helpers (framework- and three-agnostic).
- *
- * The hosted surface scene ({@link createSurfaceChart3DScene}) feeds these
- * the `three` module `<pptx-three-view>` loaded, so the library stays an
- * optional import while the grid maths (plane subdivision -> height/colour displacement,
- * world-space label anchors) lives here as small, separately testable units.
- */
-
-/** The `c:view3D` fields the camera placement cares about. */
-interface SurfaceCameraView3D {
-    /** X-axis rotation in degrees (-90...90); PowerPoint's "elevation". */
-    rotX?: number;
-    /** Y-axis rotation in degrees (0...360); PowerPoint's "rotation". */
-    rotY?: number;
-}
-
-/** The `c:view3D` fields a cartesian 3D scene's camera placement cares about. */
-interface CartesianCameraView3D {
-    /** X-axis rotation in degrees (-90...90); PowerPoint's "elevation". */
-    rotX?: number;
-    /** Y-axis rotation in degrees (0...360); PowerPoint's "rotation". */
-    rotY?: number;
-    /** Perspective angle in degrees (0...240, `c:view3D/c:perspective`). Ignored when `rAngAx` is set. */
-    rperspective?: number;
-    /** Chart depth as a percentage of base width (`c:view3D/@depthPercent`). */
-    depthPercent?: number;
-    /** Right-angle axes (`c:view3D/@rAngAx`): PowerPoint renders near-orthographically. */
-    rAngAx?: boolean;
-}
-
-/** One path vertex, positioned in true 3D world space. */
-interface CartesianLine3DVertex {
-    seriesIndex: number;
-    categoryIndex: number;
-    value: number;
-    position: readonly [number, number, number];
-}
-/** One series' full 3D path: its depth plane + ordered (by category) vertices. */
-interface CartesianLine3DSeriesPath {
-    seriesIndex: number;
-    color: string;
-    vertices: CartesianLine3DVertex[];
-    /** World Z this series' depth plane sits at. */
-    depthZ: number;
-    /** World Y for value = 0 on this plane (area3D ribbon baseline / floor). */
-    baselineY: number;
-}
-
-/**
- * Floor/side-wall/back-wall backdrop planes for an interactive 3D chart scene.
- *
- * `c:floor`, `c:sideWall`, and `c:backWall` are parsed onto `PptxChartData`
- * but, before this module, only the flat SVG isometric renderer painted
- * them; a WebGL scene showed a fixed grey `GridHelper` regardless of what
- * was authored. Each authored surface becomes one semi-transparent plane
- * mesh so the interactive view agrees with the SVG one. A surface with no
- * authored fill colour gets no plane, so an untouched chart's WebGL scene is
- * unchanged.
- *
- * Shared by every interactive chart scene that has a category/series grid to
- * wall in: the surface chart ({@link ./surface-chart-3d-scene.ts}) and the
- * cartesian bar3D scene ({@link ./bar-chart-3d-scene.ts}), and (pending
- * follow-up) line3D/area3D. Each caller passes its OWN grid extent (a
- * cartesian chart's depth axis is scaled by `c:view3D/@depthPercent`, unlike
- * the surface chart's 1:1 row spacing), so this module never recomputes an
- * extent that could disagree with the caller's own mesh layout.
- *
- * @module surface-chart-3d-walls
- */
-
-/** `c:floor`/`c:sideWall`/`c:backWall` fill colours (`#RRGGBB`), when authored. */
-interface SurfaceWallColors {
-    floor?: string;
-    sideWall?: string;
-    backWall?: string;
-}
-
-/**
- * Shared point/series data-shaping for the interactive `line3D` and `area3D`
- * true-3D scenes ({@link ./line-chart-3d-data.ts}, {@link ./area-chart-3d-data.ts}).
- *
- * Both chart kinds share IDENTICAL per-series depth-plane geometry (see
- * {@link ./cartesian-line-chart-3d-layout.ts}): the only difference is
- * presentation, line3D draws a tube along each series' path, area3D
- * additionally fills a ribbon from that path down to its baseline. Colour
- * resolution (`seriesColor` / `resolveDataPointFill`) and value-range maths
- * (`computeValueRange`) are the SAME functions the flat SVG oblique-projection
- * engine uses ({@link ./chart-cartesian-line-area.ts}), so a chart's true-3D
- * and 2D-fallback presentations always agree on colour and scale (mirrors
- * {@link ./bar-chart-3d-data.ts}).
- *
- * @module cartesian-line-chart-3d-data
- */
-
-/** Inputs the interactive line3D/area3D scene needs to mount. */
-interface CartesianLine3DSceneOptions {
-    cols: number;
-    rows: number;
-    series: CartesianLine3DSeriesPath[];
-    categoryLabels: ReadonlyArray<string>;
-    seriesNames: ReadonlyArray<string>;
-    numberFormats?: ReadonlyArray<string | undefined>;
-    width: number;
-    height: number;
-    /** Authored `c:view3D` driving the initial camera + depth extent. */
-    view3D?: CartesianCameraView3D;
-    /** Authored `c:floor`/`c:sideWall`/`c:backWall` fill colours, when set. */
-    wallColors?: SurfaceWallColors;
-    /** Active font-style emphasis override (bold/italic/underline/size/colour) for the axis labels. */
-    textStyle?: TextStyleAnimationDescriptor;
-}
-
-/**
- * `area3D`-specific entry point onto the shared cartesian line/area 3D data
- * shaping ({@link ./cartesian-line-chart-3d-data.ts}).
- *
- * @module area-chart-3d-data
- */
-
-type AreaChart3DSceneOptions = CartesianLine3DSceneOptions;
-
-/**
- * Box-mesh layout maths for the interactive `bar3D` scene
- * ({@link ./bar-chart-3d-data.ts}). Split out of that module to stay under the
- * repo's ~300-LOC file cap.
- *
- * Clustered layout gives every series its own depth ("Z") plane, side by
- * side along the series axis, matching PowerPoint's real 3-D Column chart.
- * Stacked/percentStacked keeps every series coplanar (one Z plane) and
- * stacks segments vertically, matching the flat engine's
- * `chart-bar3d-series-depth.ts` semantics (a stacked 3D column has no
- * per-series depth stagger; only clustered does).
- *
- * @module bar-chart-3d-layout
- */
-
-/** One box mesh: world-space center + size (width=X, height=Y, depth=Z). */
-interface BarChart3DBox {
-    seriesIndex: number;
-    categoryIndex: number;
-    value: number;
-    color: string;
-    center: readonly [number, number, number];
-    size: readonly [number, number, number];
-    /** See {@link CartesianChart3DPoint.shape}. */
-    shape?: PptxBar3DShape;
-    /**
-     * `coneToMax` / `pyramidToMax` only: the mesh's top radius as a fraction
-     * (0-1) of its base radius, so the geometry looks like a slice of one
-     * imaginary cone/pyramid whose apex sits exactly at the value-axis
-     * maximum: `0` (a full point) when this box's value equals the axis max,
-     * approaching `1` (nearly cylindrical) as the value approaches zero.
-     */
-    coneToMaxTopRadiusFactor?: number;
-}
-
-/**
- * bar-chart-3d-materials.ts: turns {@link resolveBarBoxFaceFills}'s (or, for a
- * round shape, {@link resolveBarRoundFaceFills}'s) pure per-face fill
- * descriptors into the actual `THREE.Material`(s) for one bar3D mesh, loading
- * `c:pictureOptions` picture-fill textures asynchronously.
- *
- * A mesh with no picture fill anywhere keeps the pre-existing single uniform
- * `MeshPhongMaterial` (no behaviour change, no texture-loader overhead) - see
- * {@link resolveBarBoxFaceFills}/{@link resolveBarRoundFaceFills}'s own "all
- * plain colour" fast path. Once a picture is resolved for at least one face,
- * this always builds a face-material array (a 6-entry array in three's own
- * `BoxGeometry` per-face order, `+x,-x,+y,-y,+z,-z`, for a `box`; a 3-entry
- * array in `CylinderGeometry`/`ConeGeometry`'s own material-group order,
- * lateral surface/top cap/bottom cap, for a round shape), even for faces that
- * stay plain-coloured, since a `THREE.Mesh` cannot mix a single material with
- * a per-face array on the same geometry.
- *
- * Texture loads are async: every picture-targeted face mounts with a plain
- * white `MeshPhongMaterial` (so the box is never invisible/black while
- * loading) and swaps in `material.map` once the image decodes. The scene's
- * own render loop is continuous (`requestAnimationFrame` every frame, not
- * on-demand), so the swapped-in texture appears on the very next frame with
- * no extra "re-render" plumbing needed here.
- *
- * @module bar-chart-3d-materials
- */
-
-/** `c:ser`/`c:dPt` picture-fill inputs threaded into the interactive bar3D scene. */
-interface BarBoxPictureContext {
-    series: ReadonlyArray<ChartSeriesLike>;
-}
-
-/**
- * Adapts a `bar3D` chart's `PptxChartData` into the box-mesh layout the
- * interactive 3D scene ({@link ./bar-chart-3d-scene.ts}, `createBarChart3DScene`)
- * needs to mount: one {@link BarChart3DBox} per (series, category) data point,
- * positioned in true 3D space (category = X, value = Y, series = Z/depth for
- * the default vertical `c:barDir val="col"`; a horizontal `val="bar"` chart
- * remaps every box center into value = X, category = Y, series unchanged on
- * Z, see `layoutBarChart3D`'s `horizontal` flag and `BarChart3DSceneOptions
- * .horizontal`).
- *
- * Colour resolution (`seriesColor` / `resolveDataPointFill`) and value-range
- * maths (`computeValueRange` / `computeStackedValueRange`) are the SAME
- * functions the flat SVG oblique-projection engine uses
- * ({@link ./chart-cartesian-bars.ts}), so a bar3D chart's true-3D and 2D-
- * fallback presentations always agree on colour and scale: one set of chart
- * maths, two presentations (mirrors {@link ./surface-chart-3d-data.ts}).
- *
- * Clustered layout gives every series its own depth ("Z") plane, side by
- * side along the series axis, matching PowerPoint's real 3-D Column chart.
- * Stacked/percentStacked keeps every series coplanar (one Z plane) and
- * stacks segments vertically, matching the flat engine's
- * `chart-bar3d-series-depth.ts` semantics (a stacked 3D column has no
- * per-series depth stagger; only clustered does).
- *
- * @module bar-chart-3d-data
- */
-
-/** Inputs the interactive bar3D scene needs to mount. */
-interface BarChart3DSceneOptions {
-    cols: number;
-    rows: number;
-    boxes: BarChart3DBox[];
-    categoryLabels: ReadonlyArray<string>;
-    seriesNames: ReadonlyArray<string>;
-    numberFormats?: ReadonlyArray<string | undefined>;
-    grouping: 'clustered' | 'stacked' | 'percentStacked';
-    width: number;
-    height: number;
-    /** Authored `c:view3D` driving the initial camera + depth extent. */
-    view3D?: CartesianCameraView3D;
-    /** Authored `c:floor`/`c:sideWall`/`c:backWall` fill colours, when set. */
-    wallColors?: SurfaceWallColors;
-    /**
-     * `c:barDir val="bar"`: a horizontal 3-D Bar chart. Box centers are already
-     * remapped into the horizontal frame (see `layoutBarChart3D`); the scene
-     * mounter uses this flag only to rotate every box mesh `-Math.PI / 2` about
-     * Z so non-box shapes (cylinder/cone/pyramid) keep a true cross-section.
-     */
-    horizontal?: boolean;
-    /** Active font-style emphasis override (bold/italic/underline/size/colour) for the axis labels. */
-    textStyle?: TextStyleAnimationDescriptor;
-    /**
-     * `c:ser`/`c:dPt` picture-fill inputs for `c:pictureOptions` face
-     * targeting (see `bar-chart-3d-face-fill.ts`). Always populated by
-     * {@link buildBarChart3DData} (the chart's own series list); a hand-built
-     * `BarChart3DSceneOptions` fixture may omit it, which keeps every box a
-     * single uniform coloured material (the pre-existing behaviour).
-     */
-    picture?: BarBoxPictureContext;
-}
-
 /**
  * Axis labels for the right-angle-axes 3D bar chart
  * (`chart-3d-oblique-layout.ts`), placed where PowerPoint puts them: off the
@@ -6914,166 +6599,6 @@ interface Chart3DPerspectiveProjection {
 }
 type Chart3DProjection = Chart3DObliqueProjection | Chart3DPerspectiveProjection;
 
-/**
- * `line3D`-specific entry point onto the shared cartesian line/area 3D data
- * shaping ({@link ./cartesian-line-chart-3d-data.ts}).
- *
- * @module line-chart-3d-data
- */
-
-type LineChart3DSceneOptions = CartesianLine3DSceneOptions;
-
-/**
- * Pure geometry helpers for an interactive 3D `pie3D` chart scene, three-agnostic
- * so the wedge-angle / explosion / camera maths is unit-testable without
- * mocking WebGL.
- *
- * A pie chart has no category/series grid to speak of, so this module does NOT
- * reuse {@link ./cartesian-chart-3d-geom.ts} wholesale; it reuses only the
- * generic piece of that module that fits (the sphere camera placement,
- * {@link computeSphericalCameraPlacement}) and supplies pie-appropriate
- * siblings for the rest: a fixed disc radius, a thickness driven by the
- * authored `c:view3D/@hPercent` (height as a percentage of chart width - the
- * ECMA-376 field pie3D actually authors for its "puck" thickness, distinct
- * from `depthPercent` which only applies to cartesian 3D kinds), and per-slice
- * wedge angles that mirror the flat SVG engine's `computePieSlices` angle
- * bookkeeping (see `./chart-view-model.ts`) so the true-3D and 2D-fallback
- * presentations always agree on slice proportions, start angle, and explosion
- * direction.
- *
- * @module pie-chart-3d-geom
- */
-
-/** The `c:view3D` fields a pie3D scene's camera + wedge thickness care about. */
-interface PieChart3DView3D extends CartesianCameraView3D {
-    /** Pie "puck" height as a percentage of chart width (`c:view3D/@hPercent`). */
-    hPercent?: number;
-}
-/** One pie3D wedge's angle range + explosion pull-out direction. */
-interface PieChart3DSliceAngle {
-    pointIndex: number;
-    value: number;
-    /**
-     * Arc start angle in radians, in the SAME convention `computePieSlices`
-     * uses (`-PI/2` = 12 o'clock, increasing clockwise-on-screen), passed
-     * straight through to `THREE.CylinderGeometry`'s `thetaStart`. A
-     * documented approximation of PowerPoint's own pie3D orientation, not a
-     * claimed pixel-exact camera-frame match (mirrors this module's other
-     * `c:view3D` maths).
-     */
-    startAngle: number;
-    /** Arc sweep in radians (`CylinderGeometry`'s `thetaLength`). */
-    thetaLength: number;
-    /** World-space [x, z] offset applied to the wedge centre for `c:explosion` pull-out. */
-    explodeOffset: readonly [number, number];
-}
-
-/**
- * Adapts a `pie3D` chart's `PptxChartData` into the wedge-mesh layout the
- * interactive 3D scene ({@link ./pie-chart-3d-scene.ts}, `createPieChart3DScene`)
- * needs to mount: one {@link PieChart3DWedge} per data point, positioned
- * around a shared centre in true 3D space.
- *
- * Colour resolution (`resolveVaryColorFill` / `paletteColor`) and explosion
- * resolution (`resolveDataPointExplosion`) are the SAME functions the flat
- * SVG oblique-projection pie3D engine uses (`buildPieViewModel` in
- * `./chart-view-model.ts`), so a pie3D chart's true-3D and 2D-fallback
- * presentations always agree on colour, value, and pull-out distance: one set
- * of chart maths, two presentations (mirrors {@link ./bar-chart-3d-data.ts}).
- *
- * @module pie-chart-3d-data
- */
-
-/** One resolved wedge mesh: angle range, explosion offset, colour, and tooltip data. */
-interface PieChart3DWedge extends PieChart3DSliceAngle {
-    color: string;
-}
-/** Inputs the interactive pie3D scene needs to mount. */
-interface PieChart3DSceneOptions {
-    wedges: PieChart3DWedge[];
-    categoryLabels: ReadonlyArray<string>;
-    seriesName: string | undefined;
-    numberFormat: string | undefined;
-    outerRadius: number;
-    thickness: number;
-    width: number;
-    height: number;
-    /** Authored `c:view3D` driving the initial camera + wedge thickness. */
-    view3D?: PieChart3DView3D;
-    /**
-     * Series 0's raw values, `c:explosion` percentages (index-aligned with
-     * `wedges`), and `c:firstSliceAng` - everything
-     * `computePieChart3DSliceAngles` needs to recompute every wedge's angle
-     * from a live-dragged value, so a value drag can renormalise the WHOLE
-     * disc locally (rebuilding wedge geometry in the scene) rather than only
-     * the dragged wedge.
-     */
-    values: ReadonlyArray<number>;
-    explosions: ReadonlyArray<number>;
-    firstSliceAngleDeg: number | undefined;
-}
-
-/** A value drag on a chart mark, in progress (`move`) or finished (`commit`). */
-interface ThreeViewDragDetail {
-    part: ChartPartRef;
-    value: number;
-    phase: 'move' | 'commit';
-}
-/** Everything `<pptx-three-view>` can show; `kind` picks the lazily-loaded scene module. */
-type ThreeViewSpec = {
-    kind: 'chart';
-    spec: Chart3DSpec;
-} | {
-    kind: 'smartart';
-    spec: SmartArt3DModel;
-};
-
-/**
- * three.js 3D surface-chart scene for `<pptx-three-view>` (framework-agnostic).
- *
- * Builds an interactive surface chart as a `<pptx-three-view>` scene: a
- * colour-displaced surface mesh (with optional wireframe), grid floor,
- * lights, an isometric camera, and DOM axis labels re-projected to screen
- * after each frame. Raycasts pointer moves against the mesh for a native
- * hover tooltip (see {@link ./surface-chart-3d-hit-test.ts}) and clicks/drags
- * for selection and value editing (see
- * {@link ./surface-chart-3d-interaction-wiring.ts}).
- *
- * @module surface-chart-3d-scene
- */
-
-/** Inputs describing the surface to render and its container size. */
-interface SurfaceChart3DSceneOptions {
-    cols: number;
-    rows: number;
-    /** Normalised heights, row-major, length rows*cols, each in [0, 1]. */
-    heightMap: Float32Array;
-    /** Flat RGB triplets, length rows*cols*3, each channel in [0, 1]. */
-    colorMap: Float32Array;
-    /** Draw wireframe grid lines over the surface. */
-    wireframe: boolean;
-    categoryLabels: ReadonlyArray<string>;
-    seriesNames: ReadonlyArray<string>;
-    width: number;
-    height: number;
-    /** Device pixel-ratio cap. Default `2`. */
-    maxPixelRatio?: number;
-    /** Authored `c:view3D` rotation (`rotX`/`rotY`) driving the initial camera. */
-    view3D?: SurfaceCameraView3D;
-    /** Authored `c:floor`/`c:sideWall`/`c:backWall` fill colours, when set. */
-    surfaceColors?: SurfaceWallColors;
-    /**
-     * Raw (un-normalised) values, row-major, length rows*cols. Feeds the
-     * pointer-raycast hover tooltip (see {@link buildSurfaceHoverTooltip}); a
-     * caller that omits it gets a mesh with no hover tooltip.
-     */
-    values?: Float32Array;
-    /** Per-series number-format codes, aligned to `seriesNames`. */
-    numberFormats?: ReadonlyArray<string | undefined>;
-    /** Active font-style emphasis override (bold/italic/underline/size/colour) for the axis labels. */
-    textStyle?: TextStyleAnimationDescriptor;
-}
-
 /**
  * The pure, three-free description of a 3D chart that `<pptx-three-view>`
  * mounts (`kind: 'chart'`). Built from a chart element by
@@ -7111,30 +6636,8 @@ interface Chart3DPieGeometry {
     kind: 'pie';
     layout: PieChartLayout;
 }
-/** `null` until a chart type's geometry is implemented; the scene then uses {@link Chart3DSpec.perspective}. */
+/** A chart's 3D geometry; `null` when it has nothing to draw (no series or categories). */
 type Chart3DGeometry = Chart3DObliqueGeometry | Chart3DPerspGeometry | Chart3DPieGeometry | null;
-/**
- * The perspective scene a chart falls back to when the oblique geometry does
- * not cover it (line/area/pie/surface, and a bar3D chart without right-angle
- * axes). Each is a hosted scene module from the
- * pre-`<pptx-three-view>` renderer, now drawn through the shared renderer.
- */
-type Chart3DPerspectiveScene = {
-    kind: 'bar';
-    options: BarChart3DSceneOptions;
-} | {
-    kind: 'line';
-    options: LineChart3DSceneOptions;
-} | {
-    kind: 'area';
-    options: AreaChart3DSceneOptions;
-} | {
-    kind: 'pie';
-    options: PieChart3DSceneOptions;
-} | {
-    kind: 'surface';
-    options: SurfaceChart3DSceneOptions;
-};
 interface Chart3DSpec {
     /** The chart element the spec was built from (identity drives remounts). */
     element: PptxElement;
@@ -7153,8 +6656,6 @@ interface Chart3DSpec {
     geometry: Chart3DGeometry;
     /** Category labels (authored, or 1..n when the chart has none). */
     categoryLabels: readonly string[];
-    /** The perspective scene used when `geometry` is `null`; `null` when neither applies (the 2D fallback stays). */
-    perspective: Chart3DPerspectiveScene | null;
 }
 
 /**
@@ -11719,6 +11220,21 @@ interface CropSession {
     absentInsets: readonly (keyof CropInsets)[];
 }
 
+/** A value drag on a chart mark, in progress (`move`) or finished (`commit`). */
+interface ThreeViewDragDetail {
+    part: ChartPartRef;
+    value: number;
+    phase: 'move' | 'commit';
+}
+/** Everything `<pptx-three-view>` can show; `kind` picks the lazily-loaded scene module. */
+type ThreeViewSpec = {
+    kind: 'chart';
+    spec: Chart3DSpec;
+} | {
+    kind: 'smartart';
+    spec: SmartArt3DModel;
+};
+
 /**
  * Minimal GIF89a encoder (pure JS, no external dependency) plus pure
  * frame-planning helpers — shared by the React, Vue, and Angular bindings.
@@ -24800,7 +24316,7 @@ declare class AccountPageComponent {
     readonly accountAuth: _angular_core.InputSignal<AccountAuthConfig | undefined>;
     private readonly translate;
     protected readonly swatches: readonly string[];
-    protected readonly version = "4.10.0";
+    protected readonly version = "4.10.1";
     protected readonly profile: _angular_core.WritableSignal<ViewerProfile>;
     protected readonly initial: _angular_core.Signal<string>;
     protected readonly usage: _angular_core.WritableSignal<LocalStorageUsageSummary | null>;