pptx-angular-viewer 3.19.1 → 3.20.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, PptxChartData, PptxChartDataLabelPosition, PptxChartType, PptxElementAnimation, PptxAnimationPreset, PptxAnimationSequence, PptxAnimationTrigger, PptxAnimationTimingCurve, PptxAnimationRepeatMode, PptxAnimationDirection, PptxAfterAnimationAction, ParsedTableStyleMap, PptxThemeColorScheme, PptxThemeFontScheme, TablePptxElement, PptxSection, OlePptxElement, TextSegment, TextStyle, PptxTransitionType, PptxSlideTransition, SmartArtLayoutType, SmartArtColorScheme, PptxSmartArtChrome, PptxSmartArtDrawingShape, SmartArtStyle, PptxSmartArtData, PptxThemeColorRef, PlaceholderDefaults, PptxEmbeddedFont, SmartArtLayout, AccessibilityIssueSeverity, AccessibilityIssue, AccessibilityIssueType, AccessibilityCheckOptions, ElementActionType, InkPptxElement, PptxComment, PptxChartBarDirection, ImagePptxElement, MasterViewTab, MediaPptxElement, PptxTheme, PptxHandler, PptxData, PptxHandlerSaveOptions, PptxModernCommentAuthor, PptxCommentMention, PptxHeaderFooter, PptxCustomShow, PptxSlideMaster, PptxNotesMaster, PptxHandoutMaster, PptxPresentationProperties, PptxViewProperties, PptxCoreProperties, PptxAppProperties, PptxThemeOption, PptxCustomProperty, PptxTagCollection, ParsedSignature, PptxSaveFormat, PptxTableCell, PptxTableCellStyle, PptxTableRow, PptxTableData, SvgExportOptions, PptxGridSpacing, RenderedNode, RenderedCircleNode, RenderedPolygonNode, RenderedRectNode, SmartArtLayoutResult, Model3DPptxElement, ZoomPptxElement, ChartPptxElement, SmartArtPptxElement, PptxAnimationTimelineAnchor, MaterialPresetType, Text3DStyle, BevelPresetType, PptxBar3DShape, PptxChartDataLabelOptions, PptxChartAxisType, PptxChartAxisFormatting, PptxChartMarker, PptxChartDataPoint, PptxChartTrendline, PptxChartErrBars, PptxTextStyleLevels, SignatureStatus, ElementAction, PptxImageEffects, MediaBookmark, ColorMapAliasKey, ChartAxisEdit, ChartDataPointLabelEdit, PptxChartLegendPosition, PptxChartStyle, ChartAxisTitleStyleEdit, PptxChartMarkerSymbol, ChartGridlineStyleEdit, PptxSmartArtNode, PptxSmartArtNodeStyle, PptxLayoutPreview, 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, SmartArtLayoutType, SmartArtColorScheme, PptxSmartArtChrome, PptxSmartArtDrawingShape, SmartArtStyle, PptxSmartArtData, PptxThemeColorRef, PlaceholderDefaults, PptxEmbeddedFont, SmartArtLayout, AccessibilityIssueSeverity, AccessibilityIssue, AccessibilityIssueType, AccessibilityCheckOptions, ElementActionType, InkPptxElement, PptxComment, PptxChartBarDirection, ImagePptxElement, MasterViewTab, MediaPptxElement, PptxTheme, PptxHandler, PptxData, PptxHandlerSaveOptions, PptxModernCommentAuthor, PptxCommentMention, PptxHeaderFooter, PptxCustomShow, PptxSlideMaster, PptxNotesMaster, PptxHandoutMaster, PptxPresentationProperties, PptxViewProperties, PptxCoreProperties, PptxAppProperties, PptxThemeOption, PptxCustomProperty, PptxTagCollection, ParsedSignature, PptxSaveFormat, PptxTableCell, PptxTableCellStyle, PptxTableRow, PptxTableData, SvgExportOptions, PptxGridSpacing, ChartPptxElement, RenderedNode, RenderedCircleNode, RenderedPolygonNode, RenderedRectNode, SmartArtLayoutResult, Model3DPptxElement, ZoomPptxElement, SmartArtPptxElement, PptxAnimationTimelineAnchor, MaterialPresetType, Text3DStyle, BevelPresetType, PptxBar3DShape, PptxChartDataLabelOptions, PptxChartAxisType, PptxChartAxisFormatting, PptxChartMarker, PptxChartDataPoint, PptxChartTrendline, PptxChartErrBars, PptxTextStyleLevels, SignatureStatus, ElementAction, PptxImageEffects, MediaBookmark, ColorMapAliasKey, ChartAxisEdit, ChartDataPointLabelEdit, PptxChartLegendPosition, PptxChartStyle, ChartAxisTitleStyleEdit, PptxChartMarkerSymbol, ChartGridlineStyleEdit, PptxSmartArtNode, PptxSmartArtNodeStyle, PptxLayoutPreview, 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 * as _angular_core from '@angular/core';
 import { Signal, WritableSignal, OnDestroy, OnInit, AfterViewInit, OnChanges, SimpleChanges, InjectionToken, Provider } from '@angular/core';
@@ -854,6 +854,189 @@ interface ChartTitleTextStyle {
     fontFamily?: string;
 }
 
+/**
+ * chart-svg-primitives.ts: the SVG primitive descriptor types a chart
+ * view-model's `primitives` array is built from (rect / path / polyline /
+ * circle / line / polygon / text / areaGradient). Split out of
+ * `chart-view-model-types.ts` to keep it within the repo's ~300-LOC limit;
+ * `chart-view-model.ts` re-exports everything here.
+ *
+ * @module chart-svg-primitives
+ */
+
+/**
+ * Hover tooltip / accessible name, projected as each primitive's SVG `<title>`
+ * child. Every primitive kind that can represent a data mark (rect, path,
+ * polyline, circle, line, polygon) carries this field so any chart mark, not
+ * just the region map's choropleth patches, can surface a tooltip. Projectors
+ * that ignore the field simply render no tooltip.
+ */
+interface SvgRect {
+    kind: 'rect';
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+    fill: string;
+    rx?: number;
+    opacity?: number;
+    part?: ChartPartRef;
+    title?: string;
+}
+interface SvgPath {
+    kind: 'path';
+    d: string;
+    fill: string;
+    stroke?: string;
+    strokeWidth?: number;
+    opacity?: number;
+    part?: ChartPartRef;
+    /**
+     * Hover tooltip / accessible name, projected as an SVG `<title>` child.
+     *
+     * The region map (chart-waterfall-map.ts) was the first to set it: a
+     * choropleth patch carries no label of its own, so without a tooltip the
+     * reader cannot tell which region a colour belongs to. Every other primitive
+     * kind now carries the same field for the same reason on the mainstream chart
+     * kinds (bar / line / area / scatter / bubble / pie / radar). Projectors that
+     * ignore the field simply render no tooltip.
+     */
+    title?: string;
+}
+interface SvgPolyline {
+    kind: 'polyline';
+    points: string;
+    stroke: string;
+    strokeWidth: number;
+    fill: string;
+    opacity?: number;
+    part?: ChartPartRef;
+    title?: string;
+}
+interface SvgCircle {
+    kind: 'circle';
+    cx: number;
+    cy: number;
+    r: number;
+    fill: string;
+    opacity?: number;
+    part?: ChartPartRef;
+    title?: string;
+}
+interface SvgLine {
+    kind: 'line';
+    x1: number;
+    y1: number;
+    x2: number;
+    y2: number;
+    stroke: string;
+    strokeWidth: number;
+    dashArray?: string;
+    opacity?: number;
+    title?: string;
+    /** Optional SVG transform (e.g. a chart-overlay connector's own rotation about its box centre). */
+    transform?: string;
+}
+interface SvgText {
+    kind: 'text';
+    x: number;
+    y: number;
+    text: string;
+    fontSize: number;
+    fill: string;
+    textAnchor: 'start' | 'middle' | 'end';
+    fontWeight?: 'normal' | 'bold';
+    fontFamily?: string;
+    /** Italic styling, e.g. from a chart data-table or legend-entry `c:txPr` override. */
+    fontStyle?: 'normal' | 'italic';
+    dominantBaseline?: string;
+    opacity?: number;
+    /** Optional SVG transform (e.g. `rotate(-90, x, y)` for a vertical axis title). */
+    transform?: string;
+}
+interface SvgPolygon {
+    kind: 'polygon';
+    points: string;
+    fill: string;
+    stroke: string;
+    strokeWidth: number;
+    opacity?: number;
+    dashArray?: string;
+    part?: ChartPartRef;
+    title?: string;
+    /** Optional SVG transform (e.g. a chart-overlay shape's own rotation/flip about its box centre). */
+    transform?: string;
+}
+interface SvgAreaGradient {
+    kind: 'areaGradient';
+    id: string;
+    color: string;
+}
+type SvgPrimitive = SvgRect | SvgPath | SvgPolyline | SvgCircle | SvgLine | SvgPolygon | SvgText | SvgAreaGradient;
+
+/**
+ * chart-view-model-kinds.ts: the supported chart kinds, their preserveAspectRatio
+ * and the chart-type to kind resolver. Split out of `chart-view-model.ts`,
+ * which re-exports everything here.
+ *
+ * @module chart-view-model-kinds
+ */
+type SupportedChartKind = 'bar' | 'line' | 'area' | 'pie' | 'doughnut' | 'scatter' | 'bubble' | 'radar' | 'combo' | 'stock' | 'surface' | 'treemap' | 'waterfall' | 'regionMap' | 'funnel' | 'sunburst' | 'histogram' | 'boxWhisker';
+/**
+ * The `preserveAspectRatio` a chart kind's `<svg>` must carry.
+ *
+ * Cartesian charts stretch to fill the element box (`none`); the kinds whose
+ * geometry is round or laid out on a fixed-ratio canvas (pie, doughnut, radar,
+ * and the region map's 1000x500 world outline) keep their proportions instead.
+ *
+ * A pure decision function because all five bindings need the same answer and
+ * four of them had written their own copy of the `kind === 'pie' || ...` chain;
+ * one of the copies (React's) disagreed with the rest.
+ */
+declare function chartPreserveAspectRatio(kind: SupportedChartKind | 'unsupported'): 'none' | 'xMidYMid meet';
+declare function resolveChartKind(chartType: string): SupportedChartKind | 'unsupported';
+
+/**
+ * chart-legend-swatch.ts: legend swatch shape for line-drawn chart kinds
+ * (line, scatter, and the line series of a bar+line combo).
+ *
+ * PowerPoint draws two different legend swatch shapes depending on how a
+ * series is plotted: a filled rectangle for area-like series (bar, area,
+ * pie, ...), and a short line segment with the series' own point marker for
+ * a line-drawn series (line, scatter). The shared engine used to draw a
+ * plain rect for every chart kind, so a line chart's legend never showed the
+ * line/marker sample PowerPoint does, even though the plotted series itself
+ * rendered correctly.
+ *
+ * This is a pure decision function (CLAUDE.md Rule 2), one step further than
+ * a plain descriptor: `buildLineLegendSwatch` returns ready-to-render
+ * `SvgPrimitive`s (a `line` plus the series' own marker shape, via the same
+ * `buildMarkerPrimitive` the chart's data points use), positioned in a local
+ * 10x10 box matching the existing rect swatch's origin/size. Every binding
+ * already has a generic primitive -> JSX/template mapper for the main chart
+ * primitives, so drawing a line-style swatch is just running these through
+ * that SAME mapper instead of a per-binding reimplementation of line/marker
+ * shape logic. `resolveLegendSwatchKind` is the single place that decides
+ * which chart kinds get a line sample instead of a rect, so a new binding (or
+ * a future chart kind) cannot diverge on the answer.
+ *
+ * @module chart-legend-swatch
+ */
+
+/** Which shape a binding draws for one legend entry's colour swatch. */
+type LegendSwatchKind = 'rect' | 'line';
+/** Ready-to-render primitives for a line-style legend swatch (see module doc). */
+interface LegendLineSwatch {
+    /**
+     * Positioned in the same local box the rect swatch uses (`x: 0, y: -7,
+     * width: 10, height: 10`): a horizontal line across its vertical centre,
+     * plus the series' own marker shape at the box's centre. Empty only when
+     * the series draws neither (`a:ln/a:noFill` AND `c:symbol="none"`), which
+     * never happens for an un-authored series (the default marker is a circle).
+     */
+    primitives: SvgPrimitive[];
+}
+
 /**
  * chart-svg-def-types.ts: `<defs>` descriptor types for the chart engine,
  * split out of `chart-view-model-types.ts` to keep it within the repo's
@@ -968,13 +1151,19 @@ interface ValueRange {
 /**
  * Automatic Y-axis range, on PowerPoint's terms. See `chart-axis-nice.ts`; this
  * mirrors `computeValueRange` in `chart-helpers.ts`.
+ *
+ * @param plotHeightPx The chart's plot-area height (`PlotLayout.plotHeight`),
+ *   when the caller has it; see `axisTargetIntervals`'s doc comment for why
+ *   this changes the gridline count PowerPoint's automatic scale picks.
  */
-declare function computeValueRange(series: ReadonlyArray<PptxChartSeries>): ValueRange;
+declare function computeValueRange(series: ReadonlyArray<PptxChartSeries>, plotHeightPx?: number): ValueRange;
 /**
  * Value range for a stacked bar: the per-category sums, then the same automatic
  * scale as any other value axis.
+ *
+ * @param plotHeightPx See `computeValueRange`'s parameter of the same name.
  */
-declare function computeStackedValueRange(series: ReadonlyArray<PptxChartSeries>, catCount: number): ValueRange;
+declare function computeStackedValueRange(series: ReadonlyArray<PptxChartSeries>, catCount: number, plotHeightPx?: number): ValueRange;
 /**
  * Map a data value to a Y pixel coordinate (top = max, bottom = min).
  * Routes through logarithmic scaling when `range.logScale` is set (the branch is
@@ -1029,6 +1218,8 @@ interface PlotLayout {
 interface PlotLayoutOptions {
     hasSecondaryValueAxis?: boolean;
     hasSecondaryCategoryAxis?: boolean;
+    /** The primary (only, in the common case) category axis sits at the top. */
+    categoryAxisAtTop?: boolean;
     hasDataTable?: boolean;
     dataTableRowCount?: number;
 }
@@ -1058,120 +1249,17 @@ interface ChartValueDrag {
     plotTop: number;
     plotBottom: number;
 }
-/**
- * Hover tooltip / accessible name, projected as each primitive's SVG `<title>`
- * child. Every primitive kind that can represent a data mark (rect, path,
- * polyline, circle, line, polygon) carries this field so any chart mark, not
- * just the region map's choropleth patches, can surface a tooltip. Projectors
- * that ignore the field simply render no tooltip.
- */
-interface SvgRect {
-    kind: 'rect';
-    x: number;
-    y: number;
-    w: number;
-    h: number;
-    fill: string;
-    rx?: number;
-    opacity?: number;
-    part?: ChartPartRef;
-    title?: string;
-}
-interface SvgPath {
-    kind: 'path';
-    d: string;
-    fill: string;
-    stroke?: string;
-    strokeWidth?: number;
-    opacity?: number;
-    part?: ChartPartRef;
-    /**
-     * Hover tooltip / accessible name, projected as an SVG `<title>` child.
-     *
-     * The region map (chart-waterfall-map.ts) was the first to set it: a
-     * choropleth patch carries no label of its own, so without a tooltip the
-     * reader cannot tell which region a colour belongs to. Every other primitive
-     * kind now carries the same field for the same reason on the mainstream chart
-     * kinds (bar / line / area / scatter / bubble / pie / radar). Projectors that
-     * ignore the field simply render no tooltip.
-     */
-    title?: string;
-}
-interface SvgPolyline {
-    kind: 'polyline';
-    points: string;
-    stroke: string;
-    strokeWidth: number;
-    fill: string;
-    opacity?: number;
-    part?: ChartPartRef;
-    title?: string;
-}
-interface SvgCircle {
-    kind: 'circle';
-    cx: number;
-    cy: number;
-    r: number;
-    fill: string;
-    opacity?: number;
-    part?: ChartPartRef;
-    title?: string;
-}
-interface SvgLine {
-    kind: 'line';
-    x1: number;
-    y1: number;
-    x2: number;
-    y2: number;
-    stroke: string;
-    strokeWidth: number;
-    dashArray?: string;
-    opacity?: number;
-    title?: string;
-    /** Optional SVG transform (e.g. a chart-overlay connector's own rotation about its box centre). */
-    transform?: string;
-}
-interface SvgText {
-    kind: 'text';
-    x: number;
-    y: number;
-    text: string;
-    fontSize: number;
-    fill: string;
-    textAnchor: 'start' | 'middle' | 'end';
-    fontWeight?: 'normal' | 'bold';
-    fontFamily?: string;
-    /** Italic styling, e.g. from a chart data-table or legend-entry `c:txPr` override. */
-    fontStyle?: 'normal' | 'italic';
-    dominantBaseline?: string;
-    opacity?: number;
-    /** Optional SVG transform (e.g. `rotate(-90, x, y)` for a vertical axis title). */
-    transform?: string;
-}
-interface SvgPolygon {
-    kind: 'polygon';
-    points: string;
-    fill: string;
-    stroke: string;
-    strokeWidth: number;
-    opacity?: number;
-    dashArray?: string;
-    part?: ChartPartRef;
-    title?: string;
-    /** Optional SVG transform (e.g. a chart-overlay shape's own rotation/flip about its box centre). */
-    transform?: string;
-}
-interface SvgAreaGradient {
-    kind: 'areaGradient';
-    id: string;
-    color: string;
-}
-type SvgPrimitive = SvgRect | SvgPath | SvgPolyline | SvgCircle | SvgLine | SvgPolygon | SvgText | SvgAreaGradient;
 interface LegendEntry {
     color: string;
     label: string;
     /** Per-entry text override from `c:legendEntry/c:txPr`, applied by `applyLegendEntryOverrides`. */
     textStyle?: PptxChartLegendTextStyle;
+    /**
+     * Present only for a line-drawn series (line / scatter, or a combo chart's
+     * line series): draw a line + marker sample instead of the default filled
+     * rect, matching PowerPoint. See `chart-legend-swatch.ts`.
+     */
+    lineSwatch?: LegendLineSwatch;
 }
 interface ChartViewModel {
     svgWidth: number;
@@ -1262,6 +1350,32 @@ interface ChartViewModel {
     defs?: ChartSvgDef[];
 }
 
+/**
+ * chart-legend-build.ts: builds the base `LegendEntry[]` (colour + label +
+ * optional line-style swatch) and the legend's anchor position for a chart
+ * view-model. Split out of `chart-view-model-layout.ts` to keep it within the
+ * repo's ~300-LOC limit.
+ *
+ * @module chart-legend-build
+ */
+
+/**
+ * Build the base legend entries + anchor position for a chart view model.
+ *
+ * @param swatchKind Which legend entries draw a line + marker sample instead
+ *   of the default filled rect (see `chart-legend-swatch.ts`). A single value
+ *   applies to every entry (the whole-chart line/scatter case); an array
+ *   resolves per series index (a bar+line combo, where only the line series
+ *   get the line sample). Defaults to `'rect'` for every existing caller that
+ *   predates line-aware legends.
+ */
+declare function buildLegend(series: ReadonlyArray<PptxChartSeries>, colorPalette: readonly string[] | undefined, svgWidth: number, legendPos: string, svgHeight: number, plotTop: number, swatchKind?: LegendSwatchKind | ReadonlyArray<LegendSwatchKind>): {
+    legend: LegendEntry[];
+    legendX: number;
+    legendY: number;
+    legendAnchor: 'start' | 'middle' | 'end';
+};
+
 /**
  * chart-view-model-bars.ts: bar / column rectangle and line-point geometry of
  * the chart engine. Split out of `chart-view-model.ts`, which re-exports
@@ -1302,36 +1416,15 @@ declare function linePointsToSvgString(points: ReadonlyArray<LinePoint>): string
 declare function buildChartViewModel(element: PptxElement): ChartViewModel;
 
 /**
- * chart-view-model-kinds.ts: the supported chart kinds, their preserveAspectRatio
- * and the chart-type to kind resolver. Split out of `chart-view-model.ts`,
- * which re-exports everything here.
+ * chart-view-model-chrome.ts: chart chrome (value-axis gridlines/labels, zero
+ * line, category labels) shared by the cartesian chart kinds. Split out of
+ * `chart-view-model-layout.ts` to keep that module's plot layout math under
+ * the repo's 300-LOC file guideline; re-exported by `chart-view-model.ts`.
+ * Legend building (`buildLegend`) lives in `chart-legend-build.ts`, not here.
  *
- * @module chart-view-model-kinds
- */
-type SupportedChartKind = 'bar' | 'line' | 'area' | 'pie' | 'doughnut' | 'scatter' | 'bubble' | 'radar' | 'combo' | 'stock' | 'surface' | 'treemap' | 'waterfall' | 'regionMap' | 'funnel' | 'sunburst' | 'histogram' | 'boxWhisker';
-/**
- * The `preserveAspectRatio` a chart kind's `<svg>` must carry.
- *
- * Cartesian charts stretch to fill the element box (`none`); the kinds whose
- * geometry is round or laid out on a fixed-ratio canvas (pie, doughnut, radar,
- * and the region map's 1000x500 world outline) keep their proportions instead.
- *
- * A pure decision function because all five bindings need the same answer and
- * four of them had written their own copy of the `kind === 'pie' || ...` chain;
- * one of the copies (React's) disagreed with the rest.
- */
-declare function chartPreserveAspectRatio(kind: SupportedChartKind | 'unsupported'): 'none' | 'xMidYMid meet';
-declare function resolveChartKind(chartType: string): SupportedChartKind | 'unsupported';
-
-/**
- * chart-view-model-layout.ts: plot-area layout and chart chrome (gridlines,
- * axis / category labels, legend placement) of the chart engine. Split out of
- * `chart-view-model.ts`, which re-exports everything here.
- *
- * @module chart-view-model-layout
+ * @module chart-view-model-chrome
  */
 
-declare function computePlotLayout(elementWidth: number, elementHeight: number, chartData: PptxChartData, hasAxes: boolean, options?: PlotLayoutOptions): PlotLayout;
 declare const GRIDLINE_COLOR = "#e2e8f0";
 declare const AXIS_LABEL_COLOR = "#64748b";
 declare const ZERO_LINE_COLOR = "#94a3b8";
@@ -1353,12 +1446,19 @@ showMajorGridlines?: boolean): {
 };
 declare function buildZeroLine(range: ValueRange, layout: PlotLayout): SvgLine | undefined;
 declare function buildCategoryLabels(categoryLabels: ReadonlyArray<string>, layout: PlotLayout, catSpacing: 'bar' | 'line'): SvgText[];
-declare function buildLegend(series: ReadonlyArray<PptxChartSeries>, colorPalette: readonly string[] | undefined, svgWidth: number, legendPos: string, svgHeight: number, plotTop: number): {
-    legend: LegendEntry[];
-    legendX: number;
-    legendY: number;
-    legendAnchor: 'start' | 'middle' | 'end';
-};
+
+/**
+ * chart-view-model-layout.ts: plot-area layout math for the chart engine
+ * (the plot inset, legend/title/data-table/secondary-axis reservations, and
+ * `c:plotArea/c:layout/c:manualLayout` overrides). Chart chrome (gridlines,
+ * axis / category labels) lives in `chart-view-model-chrome.ts`; legend
+ * building lives in `chart-legend-build.ts`. All three are re-exported by
+ * `chart-view-model.ts`.
+ *
+ * @module chart-view-model-layout
+ */
+
+declare function computePlotLayout(elementWidth: number, elementHeight: number, chartData: PptxChartData, hasAxes: boolean, options?: PlotLayoutOptions): PlotLayout;
 
 /**
  * chart-manual-layout.ts: pure conversion of `c:layout/c:manualLayout`
@@ -1549,6 +1649,8 @@ interface ChartLegendLayoutItem {
     fontWeight: 'normal' | 'bold';
     fontStyle: 'normal' | 'italic';
     fontFamily?: string;
+    /** Present for a line-drawn series: draw a line + marker sample instead of the rect swatch. */
+    lineSwatch?: LegendLineSwatch;
 }
 
 /**
@@ -1604,6 +1706,9 @@ interface ChartOption<V> {
  */
 type ChartTypeSelectValue = PptxChartType | 'pareto';
 
+/** The eight resize handles, named by compass direction. */
+type ResizeHandleId = 'nw' | 'n' | 'ne' | 'e' | 'se' | 's' | 'sw' | 'w';
+
 /** Build a bar + line combo chart, including independently scaled secondary series. */
 declare function buildComboViewModel(element: PptxElement, chartData: PptxChartData, categoryLabels: ReadonlyArray<string>): ChartViewModel;
 
@@ -2954,9 +3059,6 @@ declare function computeAlign(boxes: readonly AlignBox[], mode: AlignMode, optio
  */
 declare function computeDistribute(boxes: readonly AlignBox[], mode: DistributeMode, options?: AlignOptions): Map<string, PositionUpdate>;
 
-/** The eight resize handles, named by compass direction. */
-type ResizeHandleId = 'nw' | 'n' | 'ne' | 'e' | 'se' | 's' | 'sw' | 'w';
-
 type HitAreaStyle = Partial<Record<'top' | 'right' | 'bottom' | 'left', string>> & {
     position: 'absolute';
     pointerEvents: 'auto';
@@ -15380,6 +15482,12 @@ declare class SlideCanvasComponent implements SlideContext {
     private elementById;
     /** The single selected element itself (not just its box), or null. */
     private readonly singleSelectedElement;
+    /**
+     * The single selected element when (and only when) it is a chart: gates
+     * the "Chart Elements"/"Chart Styles"/"Chart Filters" quick-action overlay,
+     * which only makes sense for exactly one selected chart.
+     */
+    readonly quickActionsChartElement: _angular_core.Signal<ChartPptxElement | null>;
     /**
      * Resize-handle render boxes (stage coords) for the single selection. Empty
      * for an element whose authored `a:spLocks/@noResize` pins its size.
@@ -21431,7 +21539,7 @@ declare class AccountPageComponent {
     readonly accountAuth: _angular_core.InputSignal<AccountAuthConfig | undefined>;
     private readonly translate;
     protected readonly swatches: readonly string[];
-    protected readonly version = "3.19.0";
+    protected readonly version = "3.19.2";
     protected readonly profile: _angular_core.WritableSignal<ViewerProfile>;
     protected readonly initial: _angular_core.Signal<string>;
     protected readonly usage: _angular_core.WritableSignal<LocalStorageUsageSummary | null>;