ooxml-ui 0.30.1 → 1.0.0

package/dist/pptx/render/chart-view-model-types.d.ts

@@ -0,0 +1,189 @@
+/**
+ * chart-view-model-types.ts: the framework-neutral descriptor types of the
+ * chart engine (plot layout, interactive part refs, SVG primitives, legend
+ * entries and the `ChartViewModel` every binding projects into its own SVG).
+ * Split out of `chart-view-model.ts`, which re-exports everything here.
+ *
+ * @module chart-view-model-types
+ */
+import type { PptxChartLegendTextStyle } from 'ooxml-core/pptx';
+import type { LegendLineSwatch } from './chart-legend-swatch.js';
+import type { ChartSvgDef } from './chart-svg-def-types.js';
+import type { SvgLine, SvgPrimitive, SvgText } from './chart-svg-primitives.js';
+import type { ChartTitleRunSpan } from './chart-title-runs.js';
+import type { ChartTitleTextStyle } from './chart-title-style.js';
+import type { ValueRange } from './chart-view-model-scale.js';
+export type { ChartSvgDef, ChartSvgGradientDef, ChartSvgGradientStop, ChartSvgPatternDef, } from './chart-svg-def-types.js';
+export * from './chart-svg-primitives.js';
+/** Bounding-box of the chart's usable plot area in SVG coordinates. */
+export interface PlotLayout {
+    svgWidth: number;
+    svgHeight: number;
+    plotLeft: number;
+    plotTop: number;
+    plotRight: number;
+    plotBottom: number;
+    plotWidth: number;
+    plotHeight: number;
+    /**
+     * `plotHeight` before any `c:plotArea/c:layout/c:manualLayout` override is
+     * applied. PowerPoint's automatic gridline-count decision (see
+     * `axisTargetIntervals` in chart-axis-nice.ts) is driven by the chart's
+     * natural size, not by where the author later dragged the plot rectangle;
+     * an `inner`-target manual layout in particular reserves no axis-label
+     * band at all, so `plotHeight` alone can read far taller than the chart
+     * PowerPoint actually sized its gridline count against (issue #132: a
+     * manually-laid-out percent chart got 7 gridlines here, 4 in PowerPoint).
+     */
+    autoPlotHeight: number;
+}
+/**
+ * Reserved-space options for `computePlotLayout` (secondary axes + data table).
+ * Structurally identical to `LayoutOptions` in `chart-axis.ts`; declared locally
+ * to avoid a circular import (chart-axis depends on this module's `ValueRange`).
+ */
+export 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;
+    /**
+     * Pixel width of the widest category label, for a horizontal-bar chart's
+     * LEFT axis band (PowerPoint's "Bar" type transposes the chart, so text
+     * category labels, not short numeric ticks, sit on the left). The default
+     * left inset is sized for numbers; a caller that draws text there must
+     * pass this (see `widestCategoryLabelWidth` in
+     * `chart-horizontal-bars-helpers.ts`) or long category text clips against
+     * the chart's own left edge.
+     */
+    leftCategoryLabelWidth?: number;
+}
+/**
+ * Reference to an interactive chart sub-part, carried by the primitives that
+ * represent data marks (bars, dots, slices, series lines). Bindings use it to
+ * make marks clickable/draggable in edit mode and to sync selection with the
+ * chart inspector; primitives without a `part` stay purely decorative.
+ */
+export interface ChartPartRef {
+    /** 'dataPoint' targets one (series, category) cell; 'series' the whole series. */
+    role: 'dataPoint' | 'series';
+    seriesIndex: number;
+    /** Category/point index. Absent when the primitive spans the whole series. */
+    pointIndex?: number;
+}
+/**
+ * Vertical drag-to-value context, present on cartesian view-models whose data
+ * marks can be dragged vertically to change their value (clustered bar, line,
+ * scatter, bubble). `secondarySeriesIndexes` lists series plotted against
+ * `secondaryRange` instead of `range`.
+ */
+export interface ChartValueDrag {
+    range: ValueRange;
+    secondaryRange?: ValueRange;
+    secondarySeriesIndexes?: number[];
+    plotTop: number;
+    plotBottom: number;
+}
+export 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;
+}
+export interface ChartViewModel {
+    svgWidth: number;
+    svgHeight: number;
+    title: string | undefined;
+    titleX: number;
+    titleY: number;
+    gridlines: SvgLine[];
+    axisLabels: SvgText[];
+    zeroLine: SvgLine | undefined;
+    categoryLabels: SvgText[];
+    primitives: SvgPrimitive[];
+    dataLabels: SvgText[];
+    legend: LegendEntry[];
+    legendX: number;
+    legendY: number;
+    legendAnchor: 'start' | 'middle' | 'end';
+    /**
+     * Right-side (secondary) value-axis gridlines, emitted only when one or more
+     * series are mapped to a secondary value axis. Absent otherwise so existing
+     * projectors that ignore this field keep working unchanged.
+     */
+    secondaryGridlines?: SvgLine[];
+    /** Right-side (secondary) value-axis tick labels. Present only with a secondary axis. */
+    secondaryAxisLabels?: SvgText[];
+    /**
+     * SVG `fill` for the full-bleed chart-area rect, resolved from
+     * `c:chartSpace/c:spPr`. `undefined` means the chart declared `a:noFill` and
+     * NOTHING should be painted behind it. See `chart-area-fill.ts`.
+     */
+    areaFill?: string;
+    /**
+     * SVG `rx`/`ry` corner radius for the chart-area rect, when
+     * `c:chartSpace/c:roundedCorners` is set. `undefined` (square corners) is
+     * the default PowerPoint uses for a chart with no fill at all, so a
+     * projector should omit the attribute rather than pass `0`.
+     */
+    areaRadius?: number;
+    /**
+     * Font the title is drawn with (`c:title` run properties, then the chart
+     * style part, then the viewer defaults). See `chart-title-style.ts`.
+     */
+    titleStyle?: ChartTitleTextStyle;
+    /**
+     * Per-run `<tspan>` descriptors for a title with typed rich text
+     * (`c:title/c:tx/c:rich`, `PptxChartData.titleRuns`). Present only when the
+     * title carries typed runs; a projector should draw these INSTEAD of a
+     * single flat `vm.title` text node when set, and fall back to `title` /
+     * `titleStyle` otherwise. See `chart-title-runs.ts`.
+     */
+    titleRunSpans?: ChartTitleRunSpan[];
+    /**
+     * SVG `fill` for the plot-area rect, resolved from `c:plotArea/c:spPr`.
+     * `undefined` means paint nothing and let the chart area show through.
+     */
+    plotFill?: string;
+    /**
+     * Overlay primitives (regression trendlines, error bars, axis titles) layered
+     * on top of the base cartesian primitives. Already appended to `primitives`;
+     * surfaced separately so a projector can style/segregate them if desired.
+     */
+    overlays?: SvgPrimitive[];
+    /**
+     * Data-table primitives rendered below the plot area (when `chartData.dataTable`
+     * is set). Already appended to `primitives`; surfaced separately for projectors.
+     */
+    dataTable?: SvgPrimitive[];
+    /**
+     * Present when the chart's data marks support vertical drag-to-value editing
+     * (clustered bar / line / scatter / bubble). Absent for stacked, polar, and
+     * hierarchical kinds, where a vertical drag has no single-value meaning.
+     */
+    valueDrag?: ChartValueDrag;
+    /**
+     * Drawing-overlay primitives resolved from the chart's `c:userShapes`
+     * (shapes/text drawn on top of the plot). Already appended to `primitives`;
+     * surfaced separately so projectors can segregate them if desired. Absent
+     * when the chart has no overlay.
+     */
+    userShapes?: SvgPrimitive[];
+    /**
+     * `<defs>` a binding must render before `primitives`, so a primitive's
+     * `fill: 'url(#id)'` resolves. Currently populated only by data-point
+     * picture fills (`c:dPt/c:pictureOptions`, C2-G9); absent when the chart
+     * has none, so a projector that ignores this field paints exactly as
+     * before.
+     */
+    defs?: ChartSvgDef[];
+}
+//# sourceMappingURL=chart-view-model-types.d.ts.map

package/dist/pptx/render/chart-view-model-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart-view-model-types.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/chart-view-model-types.ts"],"names":[],"mappings":"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"}

package/dist/pptx/render/chart-view-model.cjs

@@ -0,0 +1,166 @@
+'use strict';
+
+var chunkAIL3BNZS_cjs = require('../chunk-AIL3BNZS.cjs');
+
+
+
+Object.defineProperty(exports, "AXIS_LABEL_COLOR", {
+  enumerable: true,
+  get: function () { return chunkAIL3BNZS_cjs.AXIS_LABEL_COLOR; }
+});
+Object.defineProperty(exports, "DEFAULT_PALETTE", {
+  enumerable: true,
+  get: function () { return chunkAIL3BNZS_cjs.DEFAULT_PALETTE; }
+});
+Object.defineProperty(exports, "GRIDLINE_COLOR", {
+  enumerable: true,
+  get: function () { return chunkAIL3BNZS_cjs.GRIDLINE_COLOR; }
+});
+Object.defineProperty(exports, "PIE_AUTO_INSET_PX", {
+  enumerable: true,
+  get: function () { return chunkAIL3BNZS_cjs.PIE_AUTO_INSET_PX; }
+});
+Object.defineProperty(exports, "ZERO_LINE_COLOR", {
+  enumerable: true,
+  get: function () { return chunkAIL3BNZS_cjs.ZERO_LINE_COLOR; }
+});
+Object.defineProperty(exports, "axisTickValues", {
+  enumerable: true,
+  get: function () { return chunkAIL3BNZS_cjs.axisTickValues; }
+});
+Object.defineProperty(exports, "buildCategoryLabels", {
+  enumerable: true,
+  get: function () { return chunkAIL3BNZS_cjs.buildCategoryLabels; }
+});
+Object.defineProperty(exports, "buildChartViewModel", {
+  enumerable: true,
+  get: function () { return chunkAIL3BNZS_cjs.buildChartViewModel; }
+});
+Object.defineProperty(exports, "buildFallbackViewModel", {
+  enumerable: true,
+  get: function () { return chunkAIL3BNZS_cjs.buildFallbackViewModel; }
+});
+Object.defineProperty(exports, "buildGridlinesAndLabels", {
+  enumerable: true,
+  get: function () { return chunkAIL3BNZS_cjs.buildGridlinesAndLabels; }
+});
+Object.defineProperty(exports, "buildLegend", {
+  enumerable: true,
+  get: function () { return chunkAIL3BNZS_cjs.buildLegend; }
+});
+Object.defineProperty(exports, "buildMarkTooltip", {
+  enumerable: true,
+  get: function () { return chunkAIL3BNZS_cjs.buildMarkTooltip; }
+});
+Object.defineProperty(exports, "buildPieViewModel", {
+  enumerable: true,
+  get: function () { return chunkAIL3BNZS_cjs.buildPieViewModel; }
+});
+Object.defineProperty(exports, "buildRadarViewModel", {
+  enumerable: true,
+  get: function () { return chunkAIL3BNZS_cjs.buildRadarViewModel; }
+});
+Object.defineProperty(exports, "buildZeroLine", {
+  enumerable: true,
+  get: function () { return chunkAIL3BNZS_cjs.buildZeroLine; }
+});
+Object.defineProperty(exports, "chartPreserveAspectRatio", {
+  enumerable: true,
+  get: function () { return chunkAIL3BNZS_cjs.chartPreserveAspectRatio; }
+});
+Object.defineProperty(exports, "computeBarRects", {
+  enumerable: true,
+  get: function () { return chunkAIL3BNZS_cjs.computeBarRects; }
+});
+Object.defineProperty(exports, "computeBubbleRadius", {
+  enumerable: true,
+  get: function () { return chunkAIL3BNZS_cjs.computeBubbleRadius; }
+});
+Object.defineProperty(exports, "computeLinePoints", {
+  enumerable: true,
+  get: function () { return chunkAIL3BNZS_cjs.computeLinePoints; }
+});
+Object.defineProperty(exports, "computePieLayout", {
+  enumerable: true,
+  get: function () { return chunkAIL3BNZS_cjs.computePieLayout; }
+});
+Object.defineProperty(exports, "computePieSlicePath", {
+  enumerable: true,
+  get: function () { return chunkAIL3BNZS_cjs.computePieSlicePath; }
+});
+Object.defineProperty(exports, "computePieSlices", {
+  enumerable: true,
+  get: function () { return chunkAIL3BNZS_cjs.computePieSlices; }
+});
+Object.defineProperty(exports, "computePlotLayout", {
+  enumerable: true,
+  get: function () { return chunkAIL3BNZS_cjs.computePlotLayout; }
+});
+Object.defineProperty(exports, "computeRadarPoints", {
+  enumerable: true,
+  get: function () { return chunkAIL3BNZS_cjs.computeRadarPoints; }
+});
+Object.defineProperty(exports, "computeScatterDots", {
+  enumerable: true,
+  get: function () { return chunkAIL3BNZS_cjs.computeScatterDots; }
+});
+Object.defineProperty(exports, "computeScatterXDomain", {
+  enumerable: true,
+  get: function () { return chunkAIL3BNZS_cjs.computeScatterXDomain; }
+});
+Object.defineProperty(exports, "computeStackedBarRects", {
+  enumerable: true,
+  get: function () { return chunkAIL3BNZS_cjs.computeStackedBarRects; }
+});
+Object.defineProperty(exports, "computeStackedValueRange", {
+  enumerable: true,
+  get: function () { return chunkAIL3BNZS_cjs.computeStackedValueRange; }
+});
+Object.defineProperty(exports, "computeValueRange", {
+  enumerable: true,
+  get: function () { return chunkAIL3BNZS_cjs.computeValueRange2; }
+});
+Object.defineProperty(exports, "formatAxisValue", {
+  enumerable: true,
+  get: function () { return chunkAIL3BNZS_cjs.formatAxisValue2; }
+});
+Object.defineProperty(exports, "linePointsToSvgString", {
+  enumerable: true,
+  get: function () { return chunkAIL3BNZS_cjs.linePointsToSvgString; }
+});
+Object.defineProperty(exports, "paletteColor", {
+  enumerable: true,
+  get: function () { return chunkAIL3BNZS_cjs.paletteColor2; }
+});
+Object.defineProperty(exports, "radarAngle", {
+  enumerable: true,
+  get: function () { return chunkAIL3BNZS_cjs.radarAngle; }
+});
+Object.defineProperty(exports, "radarRingPoints", {
+  enumerable: true,
+  get: function () { return chunkAIL3BNZS_cjs.radarRingPoints; }
+});
+Object.defineProperty(exports, "resolveChartKind", {
+  enumerable: true,
+  get: function () { return chunkAIL3BNZS_cjs.resolveChartKind; }
+});
+Object.defineProperty(exports, "resolveLegendAnchorPosition", {
+  enumerable: true,
+  get: function () { return chunkAIL3BNZS_cjs.resolveLegendAnchorPosition; }
+});
+Object.defineProperty(exports, "seriesColor", {
+  enumerable: true,
+  get: function () { return chunkAIL3BNZS_cjs.seriesColor2; }
+});
+Object.defineProperty(exports, "seriesXValues", {
+  enumerable: true,
+  get: function () { return chunkAIL3BNZS_cjs.seriesXValues; }
+});
+Object.defineProperty(exports, "valueToY", {
+  enumerable: true,
+  get: function () { return chunkAIL3BNZS_cjs.valueToY2; }
+});
+Object.defineProperty(exports, "withManualLayouts", {
+  enumerable: true,
+  get: function () { return chunkAIL3BNZS_cjs.withManualLayouts; }
+});

package/dist/pptx/render/chart-view-model.d.ts

@@ -0,0 +1,68 @@
+/**
+ * chart-view-model.ts - framework-agnostic SVG-primitive chart engine.
+ *
+ * A single `buildChartViewModel(element)` projects a chart `PptxElement` into a
+ * `ChartViewModel` of pure `SvgPrimitive` descriptors (rect / path / polyline /
+ * circle / line / polygon / text). Each binding (React / Vue / Angular) iterates
+ * that descriptor list to emit its own SVG; only the EMISSION is per-framework;
+ * all geometry / data / palette / layout math lives here.
+ *
+ * Originally extracted from the Angular `chart-renderer-helpers.ts`, which was
+ * itself ported from the React `viewer/utils/chart-*.tsx` renderers. Sibling
+ * modules (`chart-combo-stock`, `chart-surface-treemap`, `chart-waterfall-map`,
+ * `chart-overlays`) build the advanced chart kinds and overlays on top of the
+ * primitives and helpers defined here.
+ *
+ * Note: this engine's palette helpers (`seriesColor(series, index, palette)`,
+ * `paletteColor(index, palette)`) and `DEFAULT_PALETTE` (Office accent set)
+ * deliberately differ from the style-id-aware variants in `chart-helpers.ts`
+ * (`seriesColor(series, index, styleId?, palette?)`, `DEFAULT_CHART_PALETTE`,
+ * tailwind set). They are NOT re-exported through the barrel to avoid name
+ * collisions; consume them from this module directly.
+ *
+ * Supported chart kinds (viewer-first):
+ *   bar / column (clustered, stacked, percentStacked) -> bar rects
+ *   line / line3D -> polyline + dots
+ *   area / area3D -> polygon fill + polyline
+ *   pie / doughnut / pie3D / ofPie -> arc paths
+ *   scatter -> circle dots
+ *   bubble -> circle dots sized by each series' own c:bubbleSize
+ *   radar / radar3D -> polar polygons + spokes
+ *   combo / stock / surface / treemap / waterfall / regionMap -> sibling modules
+ *   funnel / sunburst / histogram / boxWhisker -> sibling modules
+ *
+ *
+ * Deferred (fallback box rendered instead):
+ *   bar3D (complex 3-D shading), secondary axes.
+ *
+ * The engine is split into focused sibling modules and re-exported from here
+ * so every existing `./chart-view-model` import keeps working:
+ *
+ *   chart-view-model-types    descriptor types (primitives, view-model, layout)
+ *   chart-view-model-scale    palette, value ranges, axis value formatting
+ *   chart-view-model-layout   plot layout math (inset + reservations)
+ *   chart-view-model-chrome   gridlines, axis/category labels
+ *   chart-legend-build        legend entries (colour/line swatch) + anchor position
+ *   chart-view-model-bars     bar / column rects, line points
+ *   chart-view-model-points   pie, scatter, bubble, radar geometry
+ *   chart-view-model-kinds    supported kinds + preserveAspectRatio
+ *   chart-view-model-pie      fallback + pie / doughnut builders
+ *   chart-view-model-radar    radar builder
+ *   chart-view-model-manual   `c:manualLayout` title / legend post-pass
+ *   chart-view-model-build    `buildChartViewModel` + shared post-passes
+ *
+ * @module chart-view-model
+ */
+export * from './chart-legend-build.js';
+export * from './chart-view-model-bars.js';
+export * from './chart-view-model-build.js';
+export * from './chart-view-model-chrome.js';
+export * from './chart-view-model-kinds.js';
+export * from './chart-view-model-layout.js';
+export * from './chart-view-model-manual.js';
+export { buildFallbackViewModel, buildPieViewModel } from './chart-view-model-pie.js';
+export * from './chart-view-model-points.js';
+export { buildRadarViewModel } from './chart-view-model-radar.js';
+export * from './chart-view-model-scale.js';
+export * from './chart-view-model-types.js';
+//# sourceMappingURL=chart-view-model.d.ts.map

package/dist/pptx/render/chart-view-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart-view-model.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/chart-view-model.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsDG;AAEH,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC;AACzC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,2BAA2B,CAAC;AAC1C,OAAO,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AACnF,cAAc,2BAA2B,CAAC;AAC1C,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC"}

package/dist/pptx/render/chart-view-model.mjs

@@ -0,0 +1 @@
+export { AXIS_LABEL_COLOR, DEFAULT_PALETTE, GRIDLINE_COLOR, PIE_AUTO_INSET_PX, ZERO_LINE_COLOR, axisTickValues, buildCategoryLabels, buildChartViewModel, buildFallbackViewModel, buildGridlinesAndLabels, buildLegend, buildMarkTooltip, buildPieViewModel, buildRadarViewModel, buildZeroLine, chartPreserveAspectRatio, computeBarRects, computeBubbleRadius, computeLinePoints, computePieLayout, computePieSlicePath, computePieSlices, computePlotLayout, computeRadarPoints, computeScatterDots, computeScatterXDomain, computeStackedBarRects, computeStackedValueRange, computeValueRange2 as computeValueRange, formatAxisValue2 as formatAxisValue, linePointsToSvgString, paletteColor2 as paletteColor, radarAngle, radarRingPoints, resolveChartKind, resolveLegendAnchorPosition, seriesColor2 as seriesColor, seriesXValues, valueToY2 as valueToY, withManualLayouts } from '../chunk-YARCML7O.mjs';

package/dist/pptx/render/chart-waterfall-layout.d.ts

@@ -0,0 +1,20 @@
+import type { PptxChartWaterfallOptions } from 'ooxml-core/pptx';
+import type { ValueRange } from './chart-view-model.js';
+export interface WaterfallStep {
+    sourceIndex: number;
+    value: number;
+    startValue: number;
+    endValue: number;
+    isSubtotal: boolean;
+}
+/** Resolve ChartEx waterfall deltas and absolute subtotal bars. */
+export declare function buildWaterfallSteps(values: ReadonlyArray<number>, options: PptxChartWaterfallOptions | undefined): WaterfallStep[];
+/**
+ * Compute a value range containing every cumulative and absolute bar endpoint.
+ *
+ * @param plotHeightPx The chart's plot-area height, when known; see
+ *   `axisTargetIntervals`'s doc comment for why this changes the automatic
+ *   scale's gridline count.
+ */
+export declare function computeWaterfallRange(steps: ReadonlyArray<WaterfallStep>, plotHeightPx?: number): ValueRange;
+//# sourceMappingURL=chart-waterfall-layout.d.ts.map

package/dist/pptx/render/chart-waterfall-layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart-waterfall-layout.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/chart-waterfall-layout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAEjE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAGrD,MAAM,WAAW,aAAa;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,OAAO,CAAC;CACpB;AAED,mEAAmE;AACnE,wBAAgB,mBAAmB,CAClC,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,EAC7B,OAAO,EAAE,yBAAyB,GAAG,SAAS,GAC5C,aAAa,EAAE,CAejB;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACpC,KAAK,EAAE,aAAa,CAAC,aAAa,CAAC,EACnC,YAAY,CAAC,EAAE,MAAM,GACnB,UAAU,CAUZ"}

package/dist/pptx/render/chart-waterfall-map.cjs

@@ -0,0 +1,26 @@
+'use strict';
+
+var chunkAIL3BNZS_cjs = require('../chunk-AIL3BNZS.cjs');
+
+
+
+Object.defineProperty(exports, "buildRegionMapViewModel", {
+  enumerable: true,
+  get: function () { return chunkAIL3BNZS_cjs.buildRegionMapViewModel; }
+});
+Object.defineProperty(exports, "buildWaterfallViewModel", {
+  enumerable: true,
+  get: function () { return chunkAIL3BNZS_cjs.buildWaterfallViewModel; }
+});
+Object.defineProperty(exports, "normalizeValue", {
+  enumerable: true,
+  get: function () { return chunkAIL3BNZS_cjs.normalizeValue; }
+});
+Object.defineProperty(exports, "resolveRegionCode", {
+  enumerable: true,
+  get: function () { return chunkAIL3BNZS_cjs.resolveRegionCode; }
+});
+Object.defineProperty(exports, "sequentialColorScale", {
+  enumerable: true,
+  get: function () { return chunkAIL3BNZS_cjs.sequentialColorScale; }
+});

package/dist/pptx/render/chart-waterfall-map.d.ts

@@ -0,0 +1,30 @@
+/**
+ * View-model builders for waterfall and regionMap chart kinds.
+ *
+ * Ported from:
+ *   packages/react/src/viewer/utils/chart-waterfall-combo.tsx  (waterfall only)
+ *   packages/react/src/viewer/utils/chart-map.tsx               (regionMap)
+ *
+ * Produces a `ChartViewModel` (SVG primitives only, zero Angular dependencies)
+ * that the Angular ChartRendererComponent template iterates over.
+ *
+ * Waterfall - running-total bars with positive/negative/total colouring and
+ *             dashed connector lines between bars. See `chart-waterfall-view.ts`.
+ * RegionMap  - choropleth SVG with simplified world region outlines coloured by
+ *              the first data series; unmatched regions fall back to a table.
+ *              See `chart-region-map-view.ts` and its supporting modules
+ *              (`chart-region-map-alias.ts`, `chart-region-map-colors.ts`,
+ *              `chart-region-map-fallback-table.ts`, `chart-map-projection.ts`).
+ *
+ * This file is a thin barrel: it exists so every existing import of
+ * `./chart-waterfall-map` keeps working after the two chart kinds (each with
+ * their own supporting helpers) were split into focused modules to stay
+ * under the repo's per-file line budget.
+ *
+ * @module chart-waterfall-map
+ */
+export { resolveRegionCode } from './chart-region-map-alias.js';
+export { normalizeValue, sequentialColorScale } from './chart-region-map-colors.js';
+export { buildRegionMapViewModel } from './chart-region-map-view.js';
+export { buildWaterfallViewModel } from './chart-waterfall-view.js';
+//# sourceMappingURL=chart-waterfall-map.d.ts.map

package/dist/pptx/render/chart-waterfall-map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart-waterfall-map.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/chart-waterfall-map.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjF,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/pptx/render/chart-waterfall-map.mjs

@@ -0,0 +1 @@
+export { buildRegionMapViewModel, buildWaterfallViewModel, normalizeValue, resolveRegionCode, sequentialColorScale } from '../chunk-YARCML7O.mjs';

package/dist/pptx/render/chart-waterfall-view.d.ts

@@ -0,0 +1,35 @@
+/**
+ * View-model builder for the waterfall chart kind.
+ *
+ * Split out of `chart-waterfall-map.ts` (which re-exports this) to keep that
+ * file's two unrelated chart kinds (waterfall, regionMap) each under the
+ * repo's per-file line budget.
+ *
+ * Ported from:
+ *   packages/react/src/viewer/utils/chart-waterfall-combo.tsx  (waterfall only)
+ *
+ * Waterfall - running-total bars with positive/negative/total colouring and
+ *             dashed connector lines between bars.
+ *
+ * @module chart-waterfall-view
+ */
+import type { PptxChartData, PptxElement } from 'ooxml-core/pptx';
+import type { ChartViewModel } from './chart-view-model.js';
+/** The Increase / Decrease / Total colours for a waterfall's palette. */
+export declare function waterfallRoleColors(colorPalette: readonly string[] | undefined): {
+    increase: string;
+    decrease: string;
+    total: string;
+};
+/**
+ * Build the view-model for a waterfall chart.
+ *
+ * Each bar starts from the running total of all previous values; the last bar
+ * shows the grand total (reset to 0 base).  Positive values get a green fill,
+ * negative values get a red fill, and the final total bar uses indigo.
+ * Dashed connector lines join adjacent bar tops/bottoms.
+ *
+ * Mirrors `renderWaterfallChart` in React's `chart-waterfall-combo.tsx`.
+ */
+export declare function buildWaterfallViewModel(element: PptxElement, chartData: PptxChartData, categoryLabels: ReadonlyArray<string>): ChartViewModel;
+//# sourceMappingURL=chart-waterfall-view.d.ts.map

package/dist/pptx/render/chart-waterfall-view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart-waterfall-view.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/chart-waterfall-view.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAOlE,OAAO,KAAK,EAAE,cAAc,EAA0C,MAAM,oBAAoB,CAAC;AAoBjG,yEAAyE;AACzE,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,GAAG;IACjF,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACd,CAMA;AAMD;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CACtC,OAAO,EAAE,WAAW,EACpB,SAAS,EAAE,aAAa,EACxB,cAAc,EAAE,aAAa,CAAC,MAAM,CAAC,GACnC,cAAc,CA+GhB"}