pptx-angular-viewer 4.7.0 → 4.8.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, SmartArtColorScheme, PptxSmartArtChrome, PptxSmartArtDrawingShape, 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, 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';
 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';
@@ -4124,6 +4124,51 @@ interface ElementBulletPatch {
     textStyle?: TextStyle;
 }
 
+/**
+ * East Asian line breaking the browser cannot be asked for in CSS: PowerPoint's
+ * hanging punctuation (`a:pPr/@hangingPunct`) and its kinsoku switch
+ * (`a:pPr/@eaLnBrk`).
+ *
+ * Ground truth (PowerPoint COM, Slide.Export of 20pt Yu Gothic paragraphs in
+ * boxes a fraction of an em too narrow for the next character):
+ *
+ *  - `hangingPunct="1"` keeps an overflowing `、` `。` `，` `．` on the line,
+ *    drawn past the right margin. NOTHING else hangs: closing brackets
+ *    (`）` `」` `』` `】` `〉` `》`), `！` `？` `：` `・`, the prolonged-sound
+ *    mark and small kana all wrap exactly as with `hangingPunct="0"`, pulling
+ *    the preceding character down with them.
+ *  - `eaLnBrk="0"` switches the kinsoku rules off: a line may then start with
+ *    `」`, `。`, `、` or a small kana, i.e. East Asian text breaks between any
+ *    two characters. Latin words still break only between words.
+ *
+ * Only Safari implements CSS `hanging-punctuation`, and CSS `line-break:
+ * anywhere` / `word-break: break-all` also split Latin words, so both are done
+ * in the run text instead, as pieces every binding already renders:
+ *
+ *  - A hanging character becomes a zero-inline-size `inline-block` (so the
+ *    line breaker never counts it), glued to the character before it with a
+ *    WORD JOINER (so it cannot be pushed to the next line on its own), and
+ *    followed by an ordinary space whose `word-spacing` makes it exactly the
+ *    punctuation's own advance. Mid-line that space restores the advance, so
+ *    nothing moves; at a line end it is trailing white space, which CSS hangs
+ *    or collapses, so the punctuation paints past the margin, as in PowerPoint.
+ *    (A negative margin does not work: Chromium decides a break before
+ *    applying an inline's end margin.)
+ *  - With kinsoku off, a ZERO WIDTH SPACE between two East Asian characters
+ *    is a break opportunity no kinsoku rule can veto (UAX #14 LB8 outranks the
+ *    "no break before closing punctuation" rules).
+ *
+ * @module text-east-asian-breaks
+ */
+
+/** 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;
+}
+
 /**
  * Per-run facts a rendered paragraph carries besides its text and CSS: the
  * run's HYPERLINK and its inline EQUATION (framework-agnostic).
@@ -4354,6 +4399,8 @@ interface ParagraphRun {
      * `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
@@ -4437,6 +4484,12 @@ interface RenderParagraph {
      * 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;
 }
 
 /** Current editor payload. Missing segments explicitly denotes plain-text fallback. */
@@ -5974,6 +6027,92 @@ declare const P14_TRANSITION_KEYFRAMES_ALL = "\n/* \u2500\u2500 Conveyor (transl
  */
 declare function getP14TransitionAnimations(type: PptxTransitionType, durationMs: number, direction: string | undefined, orient?: string | undefined, pattern?: string | undefined): SlideTransitionAnimations | undefined;
 
+/**
+ * Pure model types for the lit (bevel / scene quick style) SmartArt 3D path.
+ *
+ * Split out of `smartart-3d-types.ts` to keep both under the repo's LOC
+ * budget. Every length is in layout pixels (the drawing's own EMU / 9525),
+ * every angle in degrees, and every point in the mesh-local, y-up space the
+ * mesh's `outline` uses.
+ *
+ * @module render/smartart-3d-solid-types
+ */
+/** A point in mesh-local 2D space (y-up). */
+interface SolidPoint2 {
+    x: number;
+    y: number;
+}
+/** One `a:bevelT` / `a:bevelB`, in layout pixels. */
+interface SmartArt3DBevel {
+    /** Inset of the bevel from the outline (`@w`). */
+    width: number;
+    /** Relief of the bevel (`@h`). */
+    height: number;
+    /** `@prst` profile token (`circle` when absent, per ECMA-376). */
+    profile: string;
+}
+/** A shape's resolved `a:sp3d`, in layout pixels. */
+interface SmartArt3DSolid {
+    bevelTop?: SmartArt3DBevel;
+    bevelBottom?: SmartArt3DBevel;
+    /** Extrusion depth behind the front face (`@extrusionH`). */
+    extrusion: number;
+    /** Side-wall colour (`a:extrusionClr`), `#rrggbb`; the fill colour when absent. */
+    extrusionColor?: string;
+    /** Contour rim width around the whole solid (`@contourW`). */
+    contourWidth: number;
+    /** Contour colour (`a:contourClr`), `#rrggbb`. */
+    contourColor?: string;
+    /** `@prstMaterial` token. */
+    material: string;
+}
+/** One gradient stop, `offset` in 0..1. */
+interface SmartArt3DGradientStop {
+    offset: number;
+    color: string;
+}
+/**
+ * A shape's gradient fill, in mesh-local space: linear from `from` to `to`,
+ * or radial around `from` with the distance to `to` as its radius.
+ */
+interface SmartArt3DGradient {
+    kind: 'linear' | 'radial';
+    from: SolidPoint2;
+    to: SolidPoint2;
+    stops: SmartArt3DGradientStop[];
+}
+/** The light rig (`a:lightRig`) a lit SmartArt scene is shaded with. */
+interface SmartArt3DLighting {
+    /** `@rig` token, e.g. `threePt`, `flat`, `morning`. */
+    rig: string;
+    /** `@dir` token, e.g. `t`, `tl`. */
+    direction: string;
+    /** Rig revolution about the view axis (`a:rot/@rev`), degrees. */
+    revDeg: number;
+}
+/**
+ * The whole-diagram camera of a scene quick style (`dgm:styleDef/dgm:scene3d`).
+ *
+ * The diagram is rotated about its own centre by `latDeg` (about x), `lonDeg`
+ * (about y) and `revDeg` (roll about the view axis), then projected either in
+ * parallel or through a pinhole placed `distance` layout px away, and
+ * finally scaled by `zoom`.
+ */
+interface SmartArt3DCamera {
+    projection: 'orthographic' | 'perspective';
+    latDeg: number;
+    lonDeg: number;
+    revDeg: number;
+    /**
+     * Camera distance from the diagram centre in layout px (`perspective`
+     * only). Absolute, like PowerPoint's: a larger diagram shows stronger
+     * perspective under the same preset.
+     */
+    distance: number;
+    /** `a:camera/@zoom` as a fraction (1 = 100%). */
+    zoom: number;
+}
+
 /**
  * Three.js SmartArt renderer - pure model types (phase 1: extruded layouts).
  *
@@ -5987,6 +6126,7 @@ declare function getP14TransitionAnimations(type: PptxTransitionType, durationMs
  * front face of every extruded block facing +z. Layout (SVG) space is y-down
  * with the origin at the top-left; the model builder performs the flip.
  */
+
 /** A point in the world's XZ-agnostic 2D outline space (y-up). */
 interface Point2 {
     x: number;
@@ -6067,6 +6207,13 @@ interface SmartArt3DMesh {
     halfWidth: number;
     /** Half-height of the footprint. */
     halfHeight: number;
+    /**
+     * Lit solid (bevel / extrusion / contour) from the cached shape's `a:sp3d`,
+     * for the `'bevel'` and `'scene'` style categories. Absent: a flat face.
+     */
+    solid?: SmartArt3DSolid;
+    /** Gradient fill to paint instead of {@link fill}, when the shape has one. */
+    gradient?: SmartArt3DGradient;
 }
 /**
  * A multi-line text label, pre-laid-out to match the 2D SVG projection
@@ -6093,6 +6240,14 @@ interface SmartArt3DTextBlock {
     fontFamily?: string;
     fontWeight?: number;
     fontStyle?: 'normal' | 'italic';
+    /**
+     * The label's own extrusion (`a:bodyPr/a:sp3d`, e.g. Bird's Eye Scene),
+     * in layout px toward the viewer: the letters stand this far off the
+     * shape face, and their sides are drawn in {@link extrusionColor} (the
+     * text colour when absent).
+     */
+    extrusion?: number;
+    extrusionColor?: string;
 }
 /** A connector poly-line drawn between meshes on the base plane. */
 interface SmartArt3DConnector {
@@ -6115,10 +6270,11 @@ type SmartArt3DFamily = 'list' | 'process' | 'cycle' | 'hierarchy' | 'matrix' |
  * Which PowerPoint quick-style family this model was built for, so the scene
  * builder can pick the right camera/shading/geometry pipeline: `'flat'`
  * (unlit, zero-depth, orthographic matching the 2D viewBox), `'bevel'`
- * (per-shape `orthographicFront` camera + `shape3d` bevel/material, not yet
- * built by any model builder), or `'scene'` (one whole-diagram camera from
- * the quick style, not yet built). Undefined for the legacy layout-engine
- * model (`buildSmartArt3DModel`), which predates this distinction.
+ * (per-shape `orthographicFront` camera + lit `a:sp3d` bevel/material), or
+ * `'scene'` (one whole-diagram camera from the quick style, lit extruded
+ * solids). See `resolveSmartArt3DStylePath`. Undefined for the legacy
+ * layout-engine model (`buildSmartArt3DModel`), which predates this
+ * distinction.
  */
 type SmartArt3DStyleCategory = 'flat' | 'bevel' | 'scene';
 /** The complete pure 3D model for one SmartArt element. */
@@ -6132,6 +6288,10 @@ interface SmartArt3DModel {
     background?: string;
     /** See {@link SmartArt3DStyleCategory}. */
     styleCategory?: SmartArt3DStyleCategory;
+    /** Whole-diagram camera (`'scene'` only). */
+    camera?: SmartArt3DCamera;
+    /** Light rig the lit solids are shaded with (`'bevel'` / `'scene'`). */
+    lighting?: SmartArt3DLighting;
 }
 
 /**
@@ -6384,6 +6544,267 @@ interface BarChart3DSceneOptions {
     picture?: BarBoxPictureContext;
 }
 
+/**
+ * Axis labels for the right-angle-axes 3D bar chart
+ * (`chart-3d-oblique-layout.ts`), placed where PowerPoint puts them: off the
+ * FRONT edges of the box, not off the back wall.
+ *
+ * - Value labels: along the front edge of the wall that carries the value
+ *   gridlines (left edge for columns, bottom edge for a horizontal chart).
+ * - Category labels: centred on each category along the other front edge.
+ * - `standard` grouping: one series label per depth row, off the right end of
+ *   the floor (columns only; PowerPoint's horizontal standard bar has no row
+ *   axis labels in its default layout).
+ *
+ * @module chart-3d-oblique-labels
+ */
+
+/** One label, in chart px. */
+interface ObliqueLabel {
+    role: 'value' | 'category' | 'series';
+    text: string;
+    x: number;
+    y: number;
+    anchor: 'start' | 'middle' | 'end';
+    /** `central` centres the text on `y`. */
+    baseline: 'central' | 'hanging';
+    fontSize: number;
+}
+
+/**
+ * World-space types of the right-angle-axes 3D bar chart layout
+ * (`chart-3d-oblique-layout.ts`).
+ *
+ * @module chart-3d-oblique-types
+ */
+
+/** One bar as a world-space box. */
+interface ObliqueBar {
+    x: number;
+    y: number;
+    z: number;
+    /** Extent along world X / Y / Z. */
+    w: number;
+    h: number;
+    d: number;
+    color: string;
+    seriesIndex: number;
+    categoryIndex: number;
+    value: number;
+    /** Resolved `c:shape` (per-series `c:ser/c:shape`, else the chart's). */
+    shape: PptxBar3DShape;
+    /** Cross-section radius at the bar's baseline / value end, as a fraction of the full footprint. */
+    taper: ObliqueTaper;
+}
+/** How a shaped bar narrows along the value axis (1 = full footprint, 0 = a point). */
+interface ObliqueTaper {
+    bottom: number;
+    top: number;
+}
+/** A gridline segment in world space. */
+interface ObliqueGridline {
+    from: readonly [number, number, number];
+    to: readonly [number, number, number];
+}
+interface ObliqueChartLayout {
+    horizontal: boolean;
+    grouping: 'clustered' | 'stacked' | 'percentStacked' | 'standard';
+    /** Chart px of world (0, 0, 0): the front-bottom-left corner of the floor. */
+    origin: {
+        x: number;
+        y: number;
+    };
+    /** Screen shift per world unit of depth: `(sin rotY, -sin rotX)`. */
+    shear: {
+        x: number;
+        y: number;
+    };
+    box: {
+        w: number;
+        h: number;
+        d: number;
+    };
+    range: {
+        min: number;
+        max: number;
+        majorUnit: number;
+    };
+    /** Chart px per value unit along the value axis. */
+    valueScale: number;
+    bars: ObliqueBar[];
+    gridlines: ObliqueGridline[];
+    labels: ObliqueLabel[];
+}
+
+/**
+ * Axis labels for the perspective 3D chart layout (`chart-3d-persp-layout.ts`),
+ * placed where PowerPoint puts them (offsets measured on `gt/chart-10,11`):
+ *
+ * - Value labels: right-aligned 8pt left of the box's front-left edge.
+ * - Category labels: centred below the front floor edge, 9pt left and 17pt
+ *   down from their point on it.
+ * - Series (depth-row) labels: left-aligned off the right floor edge, 9pt right
+ *   and 4pt up from their row's centre on it.
+ *
+ * @module chart-3d-persp-labels
+ */
+
+/** One label, in chart px. */
+interface PerspLabel {
+    role: 'value' | 'category' | 'series';
+    text: string;
+    x: number;
+    y: number;
+    anchor: 'start' | 'middle' | 'end';
+    fontSize: number;
+}
+
+/**
+ * PowerPoint's perspective 3D chart camera (`c:view3D/@rAngAx=0`: line3D,
+ * area3D, surface3D), as a pure projection plus its three.js camera.
+ *
+ * Fitted to PowerPoint's own exports of the three-d-parity deck: the ends and
+ * corners of every wall gridline in `gt/chart-10..12,16` were traced and a
+ * camera fitted to them (0.4-2pt RMS per chart):
+ *
+ * - The plot is a box `w x h x d` (x categories, y values, z depth away from
+ *   the viewer). It is yawed by `rotY` about its vertical centre line, then
+ *   pitched toward the viewer by `0.92 * rotX` (the fitted pitch was
+ *   13.6-14.0 degrees for every `rotX = 15` chart).
+ * - The camera looks at the box centre from `diagonal / (2 tan(fov / 2))`
+ *   away, `fov` being `c:view3D/c:perspective` in degrees (default 30): the
+ *   box's bounding sphere just fills the field of view. The fitted distances
+ *   were 1.8-1.9 box diagonals.
+ *
+ * A box point `(x, y, z)` (origin at the front-bottom-left corner) lands at
+ * chart px `(cx + f X / Z, cy - f Y / Z)`, `(X, Y, Z)` being the point in
+ * camera space; {@link fitPerspView} picks `f`, `cx`, `cy` so the box fills a
+ * target rect.
+ *
+ * @module chart-3d-persp-view
+ */
+
+interface PerspBox {
+    w: number;
+    h: number;
+    d: number;
+}
+interface PerspCamera {
+    box: PerspBox;
+    /** Yaw (`rotY`) in radians: positive brings the box's right end toward the viewer. */
+    yaw: number;
+    /** Pitch in radians: positive tips the top of the box away (the viewer looks down). */
+    pitch: number;
+    /** Camera distance from the box centre, world units. */
+    dist: number;
+}
+interface PerspView extends PerspCamera {
+    /** Focal length: chart px per world unit at unit depth. */
+    focal: number;
+    /** Chart px of the box centre. */
+    cx: number;
+    cy: number;
+}
+
+/**
+ * PowerPoint's perspective 3D chart layout (`c:view3D/@rAngAx=0`) for the
+ * cartesian families (line3D, area3D, surface3D): the plot box, the camera
+ * that frames it (`chart-3d-persp-view.ts`), the value axis, where each
+ * category and depth row sits, and the wall gridlines.
+ *
+ * Calibrated against `gt/chart-10..13,16`:
+ *
+ * - The box is 1 unit wide (categories), `boxHeight` tall and one category
+ *   slot deep per depth row: a mark (area slab, line ribbon) is
+ *   `slot / (1 + gapWidth)` deep and each row `mark * (1 + gapDepth)`, which
+ *   with the 150/150 defaults is exactly one slot (fitted: 0.94-1.04).
+ *   `standard` grouping (and line3D) gives each series a row, series 1 in
+ *   front; stacked groupings share one row. A surface spans the whole floor.
+ * - Categories sit at the slot centres (`c:crossBetween="between"`) or on the
+ *   slot edges, first and last on the walls (`midCat`, area and surface's
+ *   default).
+ * - The value axis has no headroom (data topping out at 35 gets 0..35).
+ * - The box fills a plot rect calibrated from the same exports, centred and
+ *   floor-aligned; walls carry gridlines only, the floor its two outer edges.
+ *
+ * @module chart-3d-persp-layout
+ */
+
+type PerspKind = 'line' | 'area' | 'surface' | 'bar';
+type PerspGrouping = 'standard' | 'clustered' | 'stacked' | 'percentStacked';
+/** A gridline segment in box space. */
+interface PerspGridline {
+    from: readonly [number, number, number];
+    to: readonly [number, number, number];
+}
+interface PerspChartLayout {
+    kind: PerspKind;
+    grouping: PerspGrouping;
+    view: PerspView;
+    range: {
+        min: number;
+        max: number;
+        majorUnit: number;
+    };
+    /** Box units per value unit. */
+    valueScale: number;
+    /** Box x of each category. */
+    categoryX: number[];
+    /** Number of depth rows and each row's depth. */
+    rows: number;
+    rowDepth: number;
+    /** Depth of a slab or ribbon, centred in its row. */
+    markDepth: number;
+    /** Series colours, by series index. */
+    colors: string[];
+    gridlines: PerspGridline[];
+    labels: PerspLabel[];
+}
+
+/**
+ * PowerPoint's 3-D Pie (`c:pie3DChart`) as a disc in the perspective chart
+ * camera (`chart-3d-persp-view.ts`), fitted to `gt/chart-14,15`:
+ *
+ * - The pie is a puck of radius 1 and thickness `0.23` (box `2 x 0.23 x 2`,
+ *   scaled by `c:view3D/@hPercent`), pitched `0.91 * rotX` toward the viewer
+ *   (27.2 degrees fitted for rotX 30) and seen from `1.38` box diagonals: a
+ *   closer camera than the cartesian charts use, so the front of the pie is
+ *   visibly larger than the back.
+ * - The first slice starts at 12 o'clock (plus `c:firstSliceAng`) and slices
+ *   run clockwise seen from above.
+ * - The unexploded puck fits the plot rect; exploding shrinks the radius by
+ *   `1 / (1 + explosion)` and moves each slice out along its bisector by its
+ *   own explosion, so an exploded pie keeps the same footprint.
+ *
+ * @module chart-3d-pie-layout
+ */
+
+interface PieSlice {
+    pointIndex: number;
+    value: number;
+    color: string;
+    /** Clockwise from 12 o'clock, radians. */
+    startAngle: number;
+    endAngle: number;
+    /** Box-space offset of the exploded slice. */
+    offset: {
+        x: number;
+        z: number;
+    };
+}
+interface PieChartLayout {
+    view: PerspView;
+    /** Box-space centre of the pie's top face (its bottom face sits on y = 0). */
+    center: {
+        x: number;
+        y: number;
+        z: number;
+    };
+    radius: number;
+    thickness: number;
+    slices: PieSlice[];
+}
+
 /**
  * chart-3d-projection.ts: resolve a chart's `c:view3D` into the projection
  * PowerPoint actually draws it with.
@@ -6616,43 +7037,29 @@ interface SurfaceChart3DSceneOptions {
  */
 
 /**
- * One `bar3D` box: front-face rectangle in the flat 2D view-model's own SVG
- * pixel space (already gap-width/clustering/stacking-correct), extruded
- * backward in world Z by `depthMagnitude`.
+ * A right-angle-axes `bar3D` chart laid out as a real box in world space
+ * (walls, gridlines, bars, axis labels); see `chart-3d-oblique-layout.ts`.
  */
-interface Chart3DBarBox {
-    x: number;
-    y: number;
-    w: number;
-    h: number;
-    color: string;
-    seriesIndex: number;
-    categoryIndex: number;
-    /** The point's authored value (hover tooltip, drag start). */
-    value: number;
-    shape: PptxBar3DShape | undefined;
-    /**
-     * World-Z extrusion depth (SVG px units), the SAME quantity the flat 2D
-     * fallback's `chart-3d-depth.ts#computeDepthVector` uses for its
-     * `magnitude`. Every box in a supported (`clustered` / `stacked` /
-     * `percentStacked`) grouping shares one chart-wide depth: those groupings
-     * keep every series COPLANAR (one Z plane), matching PowerPoint's own
-     * `gt/chart-01.webp` (no visible per-series depth separation). `standard`
-     * grouping (each series its own full depth ROW, see `gt/chart-04.webp`)
-     * is NOT yet modelled; see the chart track's progress log.
-     */
-    depthMagnitude: number;
+interface Chart3DObliqueGeometry {
+    kind: 'oblique';
+    layout: ObliqueChartLayout;
 }
-interface Chart3DBarGeometry {
-    kind: 'bar';
-    boxes: readonly Chart3DBarBox[];
+/** A perspective (`rAngAx=0`) line / area chart on PowerPoint's box (`chart-3d-persp-layout.ts`). */
+interface Chart3DPerspGeometry {
+    kind: 'perspective';
+    layout: PerspChartLayout;
 }
-/** `null` until a chart type/grouping's oblique geometry is implemented; the scene then uses {@link Chart3DSpec.perspective}. */
-type Chart3DGeometry = Chart3DBarGeometry | null;
+/** A 3-D Pie on PowerPoint's fitted perspective camera (`chart-3d-pie-layout.ts`). */
+interface Chart3DPieGeometry {
+    kind: 'pie';
+    layout: PieChartLayout;
+}
+/** `null` until a chart type's geometry is implemented; the scene then uses {@link Chart3DSpec.perspective}. */
+type Chart3DGeometry = Chart3DObliqueGeometry | Chart3DPerspGeometry | Chart3DPieGeometry | null;
 /**
  * The perspective scene a chart falls back to when the oblique geometry does
- * not cover it yet (line/area/pie/surface, and bar3D's `standard` grouping,
- * horizontal bars and round shapes). Each is a hosted scene module from the
+ * 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 = {
@@ -6761,6 +7168,61 @@ declare function canAddTopLevelNode(layout: SmartArtLayoutType | undefined, topL
 /** Whether removing a top-level node keeps the count at or above the min. */
 declare function canRemoveTopLevelNode(layout: SmartArtLayoutType | undefined, topLevelCount: number): boolean;
 
+/**
+ * SVG gradient paint servers for cached SmartArt drawing shapes (`a:gradFill`).
+ * Split out of `smartart-drawing.ts`.
+ *
+ * @module render/smartart-drawing-gradient
+ */
+
+/** One stop of a cached shape's gradient fill, ready to place as an SVG `<stop>`. */
+interface RenderedGradientStop {
+    /** Percentage offset, e.g. `"37%"`. */
+    offset: string;
+    color: string;
+    opacity?: number;
+}
+/**
+ * A gradient paint server for a cached shape, in SVG terms.
+ *
+ * The OOXML angle is already converted to the axis endpoints here, because a
+ * gradient is not expressible as a plain `fill` string: the binding has to emit
+ * a `<defs>` entry and reference it. Keeping the geometry on this side means the
+ * conversion happens once instead of once per binding.
+ */
+interface RenderedGradient {
+    /** Element id to emit and reference; unique within the diagram. */
+    id: string;
+    kind: 'linear' | 'radial';
+    /** Axis endpoints as percentages (`kind === 'linear'`). */
+    x1?: string;
+    y1?: string;
+    x2?: string;
+    y2?: string;
+    /** Centre and radius as percentages (`kind === 'radial'`). */
+    cx?: string;
+    cy?: string;
+    r?: string;
+    stops: RenderedGradientStop[];
+}
+
+/**
+ * The SVG `viewBox` that fits a SmartArt drawing's cached shapes. Split out of
+ * `smartart-drawing.ts`.
+ *
+ * @module render/smartart-drawing-viewbox
+ */
+
+/** SVG `viewBox` bounding-box derived from all drawing shapes. */
+interface DrawingViewBox {
+    minX: number;
+    minY: number;
+    width: number;
+    height: number;
+}
+/** Compute the SVG viewBox that fits all drawing shapes, rebasing to (0, 0). */
+declare function computeDrawingViewBox(shapes: readonly PptxSmartArtDrawingShape[]): DrawingViewBox;
+
 /**
  * Line layout for centred SVG labels (SmartArt nodes and cached shapes).
  *
@@ -6793,6 +7255,7 @@ interface SvgTextLine {
 
 /** Built-in named colour palettes (mirrors the Vue/React `PALETTES`). */
 declare const PALETTES: Record<SmartArtColorScheme, string[]>;
+
 declare const DEFAULT_PALETTE: string[];
 /** Pick a colour from `palette`, wrapping `index` around its length. */
 declare function paletteColour(index: number, palette: string[]): string;
@@ -6813,36 +7276,6 @@ declare function buildChromeStyle(chrome: PptxSmartArtChrome | undefined): CssSt
  * primitive cannot leave four bindings behind.
  */
 type RenderedShapeKind = 'image' | 'ellipse' | 'path' | 'rect';
-/** One stop of a cached shape's gradient fill, ready to place as an SVG `<stop>`. */
-interface RenderedGradientStop {
-    /** Percentage offset, e.g. `"37%"`. */
-    offset: string;
-    color: string;
-    opacity?: number;
-}
-/**
- * A gradient paint server for a cached shape, in SVG terms.
- *
- * The OOXML angle is already converted to the axis endpoints here, because a
- * gradient is not expressible as a plain `fill` string: the binding has to emit
- * a `<defs>` entry and reference it. Keeping the geometry on this side means the
- * conversion happens once instead of once per binding.
- */
-interface RenderedGradient {
-    /** Element id to emit and reference; unique within the diagram. */
-    id: string;
-    kind: 'linear' | 'radial';
-    /** Axis endpoints as percentages (`kind === 'linear'`). */
-    x1?: string;
-    y1?: string;
-    x2?: string;
-    y2?: string;
-    /** Centre and radius as percentages (`kind === 'radial'`). */
-    cx?: string;
-    cy?: string;
-    r?: string;
-    stops: RenderedGradientStop[];
-}
 /** Projected view-model for a single pre-computed drawing shape. */
 interface RenderedShape {
     key: string;
@@ -6865,6 +7298,11 @@ interface RenderedShape {
     cy: number;
     /** Paint for the body, or `'none'` when the shape declares `a:noFill`. */
     fill: string;
+    /**
+     * Opacity (0..1) to paint a solid {@link fill} at, from the cached colour's
+     * `a:alpha`; absent when opaque. Maps onto SVG `fill-opacity`.
+     */
+    fillOpacity?: number;
     stroke: string;
     strokeWidth: number;
     transform: string | undefined;
@@ -6892,15 +7330,6 @@ interface RenderedShape {
     fontWeight?: number;
     fontStyle?: 'normal' | 'italic';
 }
-/** SVG `viewBox` bounding-box derived from all drawing shapes. */
-interface DrawingViewBox {
-    minX: number;
-    minY: number;
-    width: number;
-    height: number;
-}
-/** Compute the SVG viewBox that fits all drawing shapes, rebasing to (0, 0). */
-declare function computeDrawingViewBox(shapes: readonly PptxSmartArtDrawingShape[]): DrawingViewBox;
 /**
  * Project raw `PptxSmartArtDrawingShape`s into `RenderedShape` view-models,
  * rebasing positions relative to the viewBox origin.
@@ -21661,6 +22090,8 @@ declare class AnimationAuthorPanelComponent {
     protected readonly elementKey: _angular_core.Signal<string>;
     /** The animation entry for the currently selected element, if any. */
     protected readonly current: _angular_core.Signal<PptxElementAnimation | undefined>;
+    /** Unset curve shows as `linear`: that is what the writer saves and PowerPoint plays. */
+    protected readonly currentTimingCurve: _angular_core.Signal<pptx_viewer_core.PptxAnimationTimingCurve>;
     /** True when the element has at least one effect (entrance/exit/emphasis). */
     protected readonly currentHasAnimation: _angular_core.Signal<boolean>;
     /** True when the active preset exposes a direction picker. */
@@ -23710,7 +24141,7 @@ declare class AccountPageComponent {
     readonly accountAuth: _angular_core.InputSignal<AccountAuthConfig | undefined>;
     private readonly translate;
     protected readonly swatches: readonly string[];
-    protected readonly version = "4.6.0";
+    protected readonly version = "4.7.0";
     protected readonly profile: _angular_core.WritableSignal<ViewerProfile>;
     protected readonly initial: _angular_core.Signal<string>;
     protected readonly usage: _angular_core.WritableSignal<LocalStorageUsageSummary | null>;