ooxml-ui 0.30.1 → 1.0.0

package/dist/pptx/render/chart-datapoint-style.d.ts

@@ -0,0 +1,144 @@
+/**
+ * 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
+ */
+import type { PptxChartDataPointPicture, PptxChartMarkerSymbol } from 'ooxml-core/pptx';
+/** Minimal shape props subset needed to resolve a point fill. */
+interface PointShapeProps {
+    fillColor?: string;
+    strokeColor?: string;
+    /** Outline width in points. */
+    strokeWidth?: number;
+}
+/** Minimal marker shape consumed here (mirrors `PptxChartMarker`). */
+export interface ChartMarkerLike {
+    symbol?: PptxChartMarkerSymbol;
+    size?: number;
+    spPr?: PointShapeProps;
+}
+/** Minimal data-point shape consumed here (mirrors `PptxChartDataPoint`). */
+export 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`). */
+export 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;
+}
+/** The marker attributes actually drawn for one data point. */
+export interface ResolvedPointMarker {
+    symbol: PptxChartMarkerSymbol | undefined;
+    size: number | undefined;
+    /** Marker-specific fill, when the point or series pins one. */
+    fill: string | undefined;
+    /** Marker outline colour (`c:marker/c:spPr/a:ln`), when the point or series pins one. */
+    stroke: string | undefined;
+    /** Marker outline width in points. */
+    strokeWidth: number | undefined;
+}
+/** Look up the `c:dPt` override for a point index, if any. */
+export declare function findDataPoint(series: ChartSeriesLike, pointIndex: number): ChartDataPointLike | undefined;
+/**
+ * Resolve the effective fill colour for a single data point: the per-point
+ * `c:dPt` fill when present, otherwise the series colour, otherwise
+ * `fallbackColor`. Returns `undefined` only when nothing is set.
+ */
+export declare function resolveDataPointFill(series: ChartSeriesLike, pointIndex: number, fallbackColor?: string): string | undefined;
+/**
+ * Resolve the fill for a data point in a "vary colours" context, where every
+ * point in a single series is drawn with a distinct palette colour (pie /
+ * doughnut slices, or a bar/column series with `c:varyColors=1`). A per-point
+ * `c:dPt` fill still wins; otherwise the supplied per-point `paletteColor` is
+ * used (NOT the single series colour, which would make every point identical).
+ */
+export declare function resolveVaryColorFill(series: ChartSeriesLike, pointIndex: number, paletteColor: string): string;
+/**
+ * Resolve the slice explosion (pull-out distance, 0-100) for a pie/doughnut
+ * data point: the per-point `c:dPt` explosion when present, otherwise the
+ * series-level explosion, otherwise `0`.
+ */
+export declare function resolveDataPointExplosion(series: ChartSeriesLike & {
+    explosion?: number;
+}, pointIndex: number): number;
+/**
+ * Resolve the marker actually drawn for one data point.
+ *
+ * OOXML lets a `c:dPt` carry its own `c:marker`, which overrides the series
+ * `c:ser/c:marker` for that point alone: the classic use is highlighting a
+ * single outlier with a bigger star while the rest of the line keeps its small
+ * circles. Every field falls back independently, matching PowerPoint: a point
+ * marker that sets only `c:symbol` keeps the series size and fill.
+ *
+ * This exists because the per-point marker was a write-only feature. The core
+ * parser read `c:dPt/c:marker`, the save writer round-tripped it, and three
+ * bindings shipped an inspector control for it, but the renderer only ever
+ * looked at `series.marker`, so editing a point marker changed the file and
+ * left the canvas untouched. Resolving it here fixes every binding at once,
+ * since they all paint the same shared view model.
+ *
+ * A resolved symbol of `'auto'` (or a marker present with no `c:symbol` at
+ * all, which the core parser also normalises to `'auto'`) is resolved to a
+ * concrete shape via {@link automaticMarkerSymbol}, keyed by `series.idx`
+ * (falling back to `seriesPosition`, the series' array index, when the chart
+ * carries no `c:idx`). A series/point with NO marker element at all
+ * (`marker` and `point` both `undefined`) keeps `symbol: undefined`
+ * unchanged: that is a chart type that draws no marker at all, not an
+ * automatic one, and must not start cycling shapes.
+ */
+export declare function resolveDataPointMarker(series: ChartSeriesLike, pointIndex: number, seriesPosition?: number): ResolvedPointMarker;
+/**
+ * Insert or replace the `c:dPt` override carrying `point.idx`, returning a NEW
+ * array (the input is never mutated).
+ *
+ * WHY this is shared rather than open-coded per inspector: `c:dPt` entries are
+ * SPARSE and unordered. A deck may carry a single override for point 7 and
+ * nothing else, so `dataPoints[n] = ...` retargets the edit at whichever point
+ * happens to occupy that slot, and `dataPoints[0]` pins every edit to the first
+ * override regardless of which point the user picked. The renderer resolves a
+ * point through {@link findDataPoint}, which keys on `c:idx`, so any editor that
+ * writes by array position disagrees with what gets painted. Keeping the write
+ * next to the lookup it has to agree with is what stops the two drifting.
+ */
+export declare function upsertDataPoint<P extends ChartDataPointLike>(dataPoints: readonly P[] | undefined, point: P): P[];
+export {};
+//# sourceMappingURL=chart-datapoint-style.d.ts.map

package/dist/pptx/render/chart-datapoint-style.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart-datapoint-style.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/chart-datapoint-style.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,yBAAyB,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAIxF,iEAAiE;AACjE,UAAU,eAAe;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+BAA+B;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,sEAAsE;AACtE,MAAM,WAAW,eAAe;IAC/B,MAAM,CAAC,EAAE,qBAAqB,CAAC;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,eAAe,CAAC;CACvB;AAED,6EAA6E;AAC7E,MAAM,WAAW,kBAAkB;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,eAAe,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,OAAO,CAAC,EAAE,yBAAyB,CAAC;IACpC;;;;;OAKG;IACH,cAAc,CAAC,EAAE,yBAAyB,CAAC;CAC3C;AAED,sEAAsE;AACtE,MAAM,WAAW,eAAe;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,UAAU,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAClC;;;;;;OAMG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,OAAO,CAAC,EAAE,yBAAyB,CAAC;IACpC;;;OAGG;IACH,cAAc,CAAC,EAAE,yBAAyB,CAAC;CAC3C;AAED,+DAA+D;AAC/D,MAAM,WAAW,mBAAmB;IACnC,MAAM,EAAE,qBAAqB,GAAG,SAAS,CAAC;IAC1C,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,+DAA+D;IAC/D,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,yFAAyF;IACzF,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,sCAAsC;IACtC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;CAChC;AAED,8DAA8D;AAC9D,wBAAgB,aAAa,CAC5B,MAAM,EAAE,eAAe,EACvB,UAAU,EAAE,MAAM,GAChB,kBAAkB,GAAG,SAAS,CAEhC;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CACnC,MAAM,EAAE,eAAe,EACvB,UAAU,EAAE,MAAM,EAClB,aAAa,CAAC,EAAE,MAAM,GACpB,MAAM,GAAG,SAAS,CAGpB;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CACnC,MAAM,EAAE,eAAe,EACvB,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,GAClB,MAAM,CAER;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CACxC,MAAM,EAAE,eAAe,GAAG;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,EAChD,UAAU,EAAE,MAAM,GAChB,MAAM,CAGR;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,sBAAsB,CACrC,MAAM,EAAE,eAAe,EACvB,UAAU,EAAE,MAAM,EAClB,cAAc,SAAI,GAChB,mBAAmB,CAerB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,kBAAkB,EAC3D,UAAU,EAAE,SAAS,CAAC,EAAE,GAAG,SAAS,EACpC,KAAK,EAAE,CAAC,GACN,CAAC,EAAE,CASL"}

package/dist/pptx/render/chart-date-axis.d.ts

@@ -0,0 +1,12 @@
+import type { PptxChartAxisFormatting, PptxChartData } from 'ooxml-core/pptx';
+import type { PlotLayout, SvgLine, SvgText } from './chart-view-model.js';
+export interface DateAxisPlan {
+    sourceIndices: number[];
+    xPositions: number[];
+    labels: SvgText[];
+    tickMarks: SvgLine[];
+}
+export declare function excelSerialToDate(serial: number, date1904?: boolean): Date;
+/** Build a continuous calendar scale for classic ChartML date categories. */
+export declare function buildDateAxisPlan(chartData: PptxChartData, layout: PlotLayout, selectedAxis?: PptxChartAxisFormatting, axisY?: number): DateAxisPlan | undefined;
+//# sourceMappingURL=chart-date-axis.d.ts.map

package/dist/pptx/render/chart-date-axis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart-date-axis.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/chart-date-axis.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAI9E,OAAO,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAIvE,MAAM,WAAW,YAAY;IAC5B,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,MAAM,EAAE,OAAO,EAAE,CAAC;IAClB,SAAS,EAAE,OAAO,EAAE,CAAC;CACrB;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,UAAQ,GAAG,IAAI,CAGxE;AAwED,6EAA6E;AAC7E,wBAAgB,iBAAiB,CAChC,SAAS,EAAE,aAAa,EACxB,MAAM,EAAE,UAAU,EAClB,YAAY,CAAC,EAAE,uBAAuB,EACtC,KAAK,CAAC,EAAE,MAAM,GACZ,YAAY,GAAG,SAAS,CA4G1B"}

package/dist/pptx/render/chart-date-format.d.ts

@@ -0,0 +1,31 @@
+/**
+ * chart-date-format.ts: a small Excel/ECMA-376 date-format-code renderer for
+ * date-axis labels and date-valued data labels.
+ *
+ * `chart-date-axis.ts`'s `formatDate` used to only sniff whether a format code
+ * CONTAINED the substrings `"yyyy"`/`"d"` and always emit one of three fixed
+ * shapes (`"D Mon"`, `"Mon YYYY"`, `"YYYY"`) via a hardcoded `en-US` short-month
+ * `toLocaleString`. It ignored the code's actual punctuation/order and
+ * numeric-vs-name choice entirely, so `mm/dd/yyyy` rendered as `"5 Jan 2024"`
+ * instead of `"01/05/2024"`, and `mmmm yyyy` (full month name) rendered
+ * identically to `mmm yyyy`.
+ *
+ * This module renders the tokens charts actually use: `yyyy`/`yy`,
+ * `mmmm`/`mmm`/`mm`/`m`, `dddd`/`ddd`/`dd`/`d`, `hh`/`h`, `mm`/`m` (minutes,
+ * when adjacent to an hour or second token), `ss`/`s`, `AM/PM`/`A/P`, plus
+ * quoted literal text and `\`-escapes. Anything the tokenizer finds no
+ * `y`/`m`/`d`/`h`/`s` letter in falls back to the historical calendar-unit
+ * heuristic, so an absent or unusable code degrades to today's output rather
+ * than to garbage.
+ *
+ * @module chart-date-format
+ */
+/**
+ * Format a date-axis / date-valued label. Tries the source `format` code
+ * (when it contains at least one recognised date/time letter) through the
+ * token renderer above; falls back to a calendar-unit-sized heuristic
+ * (`"D Mon"` / `"Mon YYYY"` / `"YYYY"`) when the code is absent or unusable,
+ * matching the engine's pre-token-renderer output.
+ */
+export declare function formatDate(date: Date, unit: 'days' | 'months' | 'years', format?: string): string;
+//# sourceMappingURL=chart-date-format.d.ts.map

package/dist/pptx/render/chart-date-format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart-date-format.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/chart-date-format.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAqLH;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAiBjG"}

package/dist/pptx/render/chart-distribution-range.d.ts

@@ -0,0 +1,5 @@
+import type { PptxChartSeries } from 'ooxml-core/pptx';
+import type { ValueRange } from './chart-view-model.js';
+/** Range with zero included and the upper bound floored at one. */
+export declare function distributionRange(series: ReadonlyArray<PptxChartSeries>): ValueRange;
+//# sourceMappingURL=chart-distribution-range.d.ts.map

package/dist/pptx/render/chart-distribution-range.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart-distribution-range.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/chart-distribution-range.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEvD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD,mEAAmE;AACnE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,aAAa,CAAC,eAAe,CAAC,GAAG,UAAU,CAKpF"}

package/dist/pptx/render/chart-distribution.d.ts

@@ -0,0 +1,5 @@
+/** Shared histogram and box-and-whisker view-model entry points. */
+export * from './chart-box-whisker.js';
+export * from './chart-box-whisker-stats.js';
+export * from './chart-histogram.js';
+//# sourceMappingURL=chart-distribution.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chart-distribution.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/chart-distribution.ts"],"names":[],"mappings":"AAAA,oEAAoE;AAEpE,cAAc,qBAAqB,CAAC;AACpC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mBAAmB,CAAC"}

package/dist/pptx/render/chart-editor-options.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Chart-inspector option catalogues: the pure, framework-agnostic value lists
+ * (and supported-type Sets) that drive the advanced chart editor's selects and
+ * conditional sections. Lifted out of the per-binding inspector code so React,
+ * Vue, and Angular consume one source of truth instead of duplicating the
+ * (long) option arrays.
+ *
+ * Each option carries both a plain-ASCII `label` (for non-i18n consumers) and
+ * a `labelKey` (a `pptx.chart.*` dotted key resolvable via each binding's
+ * translation function, defined in `pptx-viewer-shared/i18n`). The `labelKey`
+ * values mirror React's local `chart-panel-constants.ts`, which keeps its own
+ * copy of these tables for historical reasons but resolves to the same keys.
+ */
+import type { PptxChartData, PptxChartDataLabelPosition, PptxChartType } from 'ooxml-core/pptx';
+/** Display units selectable for a value axis (empty string = none). */
+export type ChartDisplayUnitsValue = '' | 'hundreds' | 'thousands' | 'tenThousands' | 'hundredThousands' | 'millions' | 'tenMillions' | 'hundredMillions' | 'billions' | 'trillions';
+/** Tick-label positions for an axis. */
+export type ChartTickLabelPosition = 'nextTo' | 'high' | 'low' | 'none';
+/** Data-label content flags (chart-level `c:show*`). */
+export type ChartDataLabelContentKey = 'showValue' | 'showCategory' | 'showSeriesName' | 'showPercent' | 'showLegendKey';
+/**
+ * Data-label position values (empty string = type default). The non-empty
+ * members are exactly the nine `c:dLblPos` schema values core models as
+ * {@link PptxChartDataLabelPosition}; the select used to offer five of them,
+ * so a line/scatter chart's "Above" / "Left" labels could not be authored.
+ */
+export type ChartDataLabelPositionValue = '' | PptxChartDataLabelPosition;
+/** Trendline regression types (empty string = none). */
+export type ChartTrendlineValue = '' | 'linear' | 'exponential' | 'logarithmic' | 'polynomial' | 'power' | 'movingAvg';
+/** Error-bar value calculation types (empty string = none). */
+export type ChartErrorBarValType = '' | 'fixedVal' | 'percentage' | 'stdDev' | 'stdErr';
+/** Error-bar display directions. */
+export type ChartErrorBarType = 'both' | 'plus' | 'minus';
+/** Marker symbols (empty string = auto, omits the marker). */
+export type ChartMarkerSymbolValue = '' | 'none' | 'circle' | 'square' | 'diamond' | 'triangle' | 'x' | 'star' | 'plus' | 'dot' | 'dash';
+/** Gridline dash styles (empty string = default). */
+export type ChartGridlineDashValue = '' | 'solid' | 'dash' | 'dot' | 'dashDot' | 'lgDash' | 'sysDash' | 'sysDot';
+/** A simple value/label option for a `<select>`. */
+export interface ChartOption<V> {
+    value: V;
+    label: string;
+    labelKey: string;
+}
+/**
+ * The value a "Change Chart Type" select may carry. Widens {@link PptxChartType}
+ * with `'pareto'`, a `histogram`-family entry that has no `PptxChartType` of
+ * its own (see docs/guide/limitations.md's ChartEx row): selecting it converts
+ * to `chartType: 'histogram'` and appends the cumulative-percentage series
+ * `applyParetoConversion` builds, rather than being stored verbatim on
+ * `PptxChartData.chartType`.
+ */
+export type ChartTypeSelectValue = PptxChartType | 'pareto';
+export declare const CHART_TYPE_OPTIONS: ReadonlyArray<ChartOption<ChartTypeSelectValue>>;
+export declare const GROUPING_OPTIONS: ReadonlyArray<ChartOption<PptxChartData['grouping']>>;
+export declare const LEGEND_POSITION_OPTIONS: ReadonlyArray<ChartOption<string>>;
+export declare const TICK_LABEL_POSITION_OPTIONS: ReadonlyArray<ChartOption<ChartTickLabelPosition>>;
+export declare const DISPLAY_UNITS_OPTIONS: ReadonlyArray<ChartOption<ChartDisplayUnitsValue>>;
+export declare const DATA_LABEL_CONTENT_OPTIONS: ReadonlyArray<{
+    key: ChartDataLabelContentKey;
+    label: string;
+    labelKey: string;
+}>;
+export declare const DATA_LABEL_POSITION_OPTIONS: ReadonlyArray<ChartOption<ChartDataLabelPositionValue>>;
+export declare const TRENDLINE_TYPE_OPTIONS: ReadonlyArray<ChartOption<ChartTrendlineValue>>;
+export declare const ERROR_BAR_VALTYPE_OPTIONS: ReadonlyArray<ChartOption<ChartErrorBarValType>>;
+export declare const ERROR_BAR_TYPE_OPTIONS: ReadonlyArray<ChartOption<ChartErrorBarType>>;
+export declare const MARKER_SYMBOL_OPTIONS: ReadonlyArray<ChartOption<ChartMarkerSymbolValue>>;
+export declare const GRIDLINE_DASH_OPTIONS: ReadonlyArray<ChartOption<ChartGridlineDashValue>>;
+export declare const COMBO_SERIES_TYPE_OPTIONS: ReadonlyArray<ChartOption<'' | PptxChartType>>;
+export * from './chart-editor-support.js';
+/**
+ * Apply an inspector patch to a chart's data, routing a `chartType` change
+ * through core's {@link chartDataChangeType} (which clears grouping the new
+ * type doesn't support and adapts the category/series shape) instead of a
+ * plain shallow merge. A `chartType` of `'pareto'` (see
+ * {@link ChartTypeSelectValue}) is routed through {@link applyParetoConversion}
+ * instead, since it has no `chartDataChangeType` target of its own. Every
+ * other field is a plain merge.
+ *
+ * Every binding's chart type/title/grouping selector needs exactly this
+ * "is this patch a type change?" branch; it was independently re-implemented
+ * in React and Vue with identical logic before being centralized here.
+ */
+export declare function patchChartData(data: PptxChartData, patch: Omit<Partial<PptxChartData>, 'chartType'> & {
+    chartType?: ChartTypeSelectValue;
+}): PptxChartData;
+//# sourceMappingURL=chart-editor-options.d.ts.map

package/dist/pptx/render/chart-editor-options.d.ts.map

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

package/dist/pptx/render/chart-editor-support.d.ts

@@ -0,0 +1,29 @@
+/**
+ * chart-editor-support.ts: the axis rows the advanced chart inspector exposes
+ * and which chart types each of its conditional sections applies to. Split out of `chart-editor-options.ts`
+ * (which re-exports everything here) to keep that catalogue under the file
+ * size limit; consumers keep importing from the options module or the barrel.
+ */
+import type { PptxChartType } from 'ooxml-core/pptx';
+/** Axis kinds the inspector exposes, with whether they carry a numeric scale. */
+export declare const EDITABLE_AXIS_ROWS: ReadonlyArray<{
+    type: 'valAx' | 'dateAx' | 'catAx';
+    label: string;
+    labelKey: string;
+    hasScale: boolean;
+}>;
+/** Chart types that support clustered/stacked grouping modes. */
+export declare const GROUPING_SUPPORTED_TYPES: ReadonlySet<PptxChartType>;
+/** Chart types where trendlines are meaningful. */
+export declare const TRENDLINE_SUPPORTED_TYPES: ReadonlySet<PptxChartType>;
+/** Chart types where error bars are meaningful. */
+export declare const ERROR_BAR_SUPPORTED_TYPES: ReadonlySet<PptxChartType>;
+/** Value types that take a numeric amount (stdErr does not). */
+export declare const ERROR_BAR_VALUE_TYPES: ReadonlySet<string>;
+/** Chart types where series markers are meaningful. */
+export declare const MARKER_SUPPORTED_TYPES: ReadonlySet<PptxChartType>;
+/** Cartesian chart types where a per-series combo type makes sense. */
+export declare const COMBO_SUPPORTED_TYPES: ReadonlySet<PptxChartType>;
+/** Chart types where per-point slice explosion (pull-out) is meaningful. */
+export declare const EXPLOSION_SUPPORTED_TYPES: ReadonlySet<PptxChartType>;
+//# sourceMappingURL=chart-editor-support.d.ts.map

package/dist/pptx/render/chart-editor-support.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart-editor-support.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/chart-editor-support.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD,iFAAiF;AACjF,eAAO,MAAM,kBAAkB,EAAE,aAAa,CAAC;IAC9C,IAAI,EAAE,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;CAClB,CAIA,CAAC;AAEF,iEAAiE;AACjE,eAAO,MAAM,wBAAwB,EAAE,WAAW,CAAC,aAAa,CAI9D,CAAC;AAEH,mDAAmD;AACnD,eAAO,MAAM,yBAAyB,EAAE,WAAW,CAAC,aAAa,CAM/D,CAAC;AAEH,mDAAmD;AACnD,eAAO,MAAM,yBAAyB,EAAE,WAAW,CAAC,aAAa,CAM/D,CAAC;AAEH,gEAAgE;AAChE,eAAO,MAAM,qBAAqB,EAAE,WAAW,CAAC,MAAM,CAIpD,CAAC;AAEH,uDAAuD;AACvD,eAAO,MAAM,sBAAsB,EAAE,WAAW,CAAC,aAAa,CAK5D,CAAC;AAEH,uEAAuE;AACvE,eAAO,MAAM,qBAAqB,EAAE,WAAW,CAAC,aAAa,CAK3D,CAAC;AAEH,4EAA4E;AAC5E,eAAO,MAAM,yBAAyB,EAAE,WAAW,CAAC,aAAa,CAK/D,CAAC"}

package/dist/pptx/render/chart-error-bars.d.ts

@@ -0,0 +1,24 @@
+import type { PptxChartData } from 'ooxml-core/pptx';
+import type { PlotLayout, SvgPrimitive, ValueRange } from './chart-view-model.js';
+export interface ErrorBarRenderOptions {
+    /** Source point indexes in display order after category/date-axis filtering. */
+    sourceIndices?: ReadonlyArray<number>;
+    /** Exact display X positions for reordered category/date points. */
+    xPositions?: ReadonlyArray<number>;
+    /** Per-series Y ranges, used by secondary-axis combo series. */
+    seriesRanges?: ReadonlyArray<ValueRange | undefined>;
+    /** Per-series category mapping mode for mixed bar/line charts. */
+    seriesModes?: ReadonlyArray<'line' | 'bar' | undefined>;
+    /**
+     * A scatter/bubble chart's own nice-scaled X-axis range (see
+     * `chart-scatter-x-axis.ts`), shared across every series so an X error bar
+     * anchors to the SAME domain the plotted points use. Without it each
+     * series fell back to its own tight per-series min/max (`numericXRange`),
+     * which drifted from the chart-wide domain the dots share once that
+     * domain gained the automatic scale's headroom/rounding.
+     */
+    scatterXRange?: ValueRange;
+}
+/** Build X- and Y-direction ChartML error-bar primitives for cartesian series. */
+export declare function computeErrorBarPrimitives(chartData: PptxChartData, catCount: number, layout: PlotLayout, range: ValueRange, mode?: 'line' | 'bar', options?: ErrorBarRenderOptions): SvgPrimitive[];
+//# sourceMappingURL=chart-error-bars.d.ts.map

package/dist/pptx/render/chart-error-bars.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart-error-bars.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/chart-error-bars.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAqC,MAAM,iBAAiB,CAAC;AAExF,OAAO,KAAK,EAAE,UAAU,EAAW,YAAY,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAMxF,MAAM,WAAW,qBAAqB;IACrC,gFAAgF;IAChF,aAAa,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACtC,oEAAoE;IACpE,UAAU,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACnC,gEAAgE;IAChE,YAAY,CAAC,EAAE,aAAa,CAAC,UAAU,GAAG,SAAS,CAAC,CAAC;IACrD,kEAAkE;IAClE,WAAW,CAAC,EAAE,aAAa,CAAC,MAAM,GAAG,KAAK,GAAG,SAAS,CAAC,CAAC;IACxD;;;;;;;OAOG;IACH,aAAa,CAAC,EAAE,UAAU,CAAC;CAC3B;AAkJD,kFAAkF;AAClF,wBAAgB,yBAAyB,CACxC,SAAS,EAAE,aAAa,EACxB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,UAAU,EAClB,KAAK,EAAE,UAAU,EACjB,IAAI,GAAE,MAAM,GAAG,KAAc,EAC7B,OAAO,GAAE,qBAA0B,GACjC,YAAY,EAAE,CAwChB"}

package/dist/pptx/render/chart-event-target.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Chart-part hit-testing from a DOM event, shadow-DOM aware.
+ *
+ * A 3D chart renders inside `<pptx-three-view>`, whose canvas and HTML/SVG
+ * chrome live in the element's (open) shadow root. An event from inside it is
+ * retargeted to the host by the time a binding's listener sees it, so
+ * `event.target.closest('[data-chart-part]')` never reaches a tagged node in
+ * the chrome. `event.composedPath()` still lists every node the event passed
+ * through, shadow internals included, so every binding resolves chart parts
+ * from the path instead of from `event.target`.
+ *
+ * @module chart-event-target
+ */
+import type { ChartPartElement } from './chart-interaction.js';
+import type { ChartPartRef } from './chart-view-model.js';
+/** The minimal event surface these helpers read (a DOM `Event` satisfies it). */
+export interface ChartPathEvent {
+    readonly target: unknown;
+    composedPath?: () => readonly unknown[];
+}
+/**
+ * The elements an event travelled through, innermost first, crossing open
+ * shadow roots. Falls back to walking `target`'s ancestors when the event has
+ * no composed path (a synthetic event built in a test, or after dispatch).
+ */
+export declare function chartEventPathElements(event: ChartPathEvent): ChartPartElement[];
+/** The nearest `[data-chart-part]` element on the event's path, or `null`. */
+export declare function findChartPartElementInEvent(event: ChartPathEvent): ChartPartElement | null;
+/**
+ * The chart data part (series / data point) under the event, or `null`.
+ * Shadow-DOM aware replacement for `findChartPartTarget(event.target)`.
+ */
+export declare function findChartPartInEvent(event: ChartPathEvent): ChartPartRef | null;
+/** Whether the event landed on the chart title (`[data-chart-part='title']`). */
+export declare function isChartTitleEvent(event: ChartPathEvent): boolean;
+//# sourceMappingURL=chart-event-target.d.ts.map

package/dist/pptx/render/chart-event-target.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart-event-target.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/chart-event-target.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,iFAAiF;AACjF,MAAM,WAAW,cAAc;IAC9B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,SAAS,OAAO,EAAE,CAAC;CACxC;AAUD;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,cAAc,GAAG,gBAAgB,EAAE,CAYhF;AAED,8EAA8E;AAC9E,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,cAAc,GAAG,gBAAgB,GAAG,IAAI,CAO1F;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,cAAc,GAAG,YAAY,GAAG,IAAI,CAE/E;AAED,iFAAiF;AACjF,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAEhE"}

package/dist/pptx/render/chart-ex-insert-defaults.d.ts

@@ -0,0 +1,54 @@
+/**
+ * chart-ex-insert-defaults.ts: sensible default `categories` / `series` /
+ * `categoryLevels` shapes for the six Office 2016+ ChartEx types that were
+ * creatable at the core level (`createChartElement`, `ChartBuilder`, the MCP
+ * `createChart` / `updateChart` tools) but never reachable from any binding's
+ * Insert Chart or Change Chart Type UI: histogram, funnel, treemap, sunburst,
+ * boxWhisker, regionMap. Also builds the `'pareto'` insert-time shape: not a
+ * seventh ChartEx type (there is no standalone `PptxChartType` for it, see
+ * docs/guide/limitations.md's ChartEx row) but a distinct dropdown entry that
+ * asks for the same histogram-plus-cumulative-percentage-line representation
+ * the MCP `createChart`/`updateChart` tools build for their `chartType:
+ * "pareto"` alias.
+ *
+ * `insert-chart.ts`'s one-size-fits-all default (three generic categories,
+ * one ascending series) does not look like any of these once rendered:
+ * a histogram needs raw observations rather than pre-binned categories, a
+ * treemap/sunburst needs a two-level hierarchy, a box-and-whisker needs
+ * several observations per category (each series contributes one sample per
+ * category, per `computeBoxWhiskerGeometry` in `chart-box-whisker.ts`), a
+ * region map needs category labels that actually resolve to a region code
+ * (see `REGION_ALIAS_MAP` in `chart-region-map-alias.ts`) or it renders as an
+ * empty map with every row in the "unmatched" fallback table, and a Pareto
+ * chart needs a second series carrying the cumulative-percentage line.
+ *
+ * Kept separate from `insert-chart.ts` so that file stays a thin dispatcher;
+ * this module owns only the per-type sample data.
+ *
+ * @module render/chart-ex-insert-defaults
+ */
+import type { ChartSeriesInput, PptxChartType } from 'ooxml-core/pptx';
+/**
+ * The chart-family tokens `buildChartExInsertData` can be asked to shape.
+ * Widens {@link PptxChartType} with `'pareto'`, the Insert Chart / Change
+ * Chart Type dropdown entry for docs/guide/limitations.md's histogram +
+ * paretoLine representation: "Pareto" is not a distinct `PptxChartType` (see
+ * that doc's ChartEx row), so it only ever exists as this insert-time shape
+ * request, never as a value stored in `PptxChartData.chartType`.
+ */
+export type ChartExInsertKind = PptxChartType | 'pareto';
+/** The insert-time default data shape for one chart type. */
+export interface ChartExInsertData {
+    categories: string[];
+    series: ChartSeriesInput[];
+    /** ChartEx hierarchy levels in leaf-to-root order (treemap / sunburst only). */
+    categoryLevels?: string[][];
+}
+/**
+ * Build the default `categories` / `series` (and, for hierarchical types,
+ * `categoryLevels`) for a ChartEx type that needs a shape other than the
+ * generic ascending three-category series. Returns `undefined` for every
+ * other {@link PptxChartType}, so callers fall back to the generic default.
+ */
+export declare function buildChartExInsertData(chartType: ChartExInsertKind): ChartExInsertData | undefined;
+//# sourceMappingURL=chart-ex-insert-defaults.d.ts.map

package/dist/pptx/render/chart-ex-insert-defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart-ex-insert-defaults.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/chart-ex-insert-defaults.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAA6B,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAKlG;;;;;;;GAOG;AACH,MAAM,MAAM,iBAAiB,GAAG,aAAa,GAAG,QAAQ,CAAC;AAEzD,6DAA6D;AAC7D,MAAM,WAAW,iBAAiB;IACjC,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,MAAM,EAAE,gBAAgB,EAAE,CAAC;IAC3B,gFAAgF;IAChF,cAAc,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC;CAC5B;AAgHD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACrC,SAAS,EAAE,iBAAiB,GAC1B,iBAAiB,GAAG,SAAS,CAmD/B"}

package/dist/pptx/render/chart-ext-editor-actions.d.ts

@@ -0,0 +1,69 @@
+/**
+ * chart-ext-editor-actions.ts: editor-facing actions for the three
+ * previously passthrough-only chart15 extension families (limitations.md
+ * "Office chart extensions" row):
+ *
+ * - {@link hideChartSeries} / {@link restoreFilteredSeries}: PowerPoint's
+ *   "Chart Filters" series toggle (`c15:filteredBarSeries` et al, modelled
+ *   as {@link PptxChartData.filteredSeries} in core). Restoring a series
+ *   whose own cached name/categories were empty (the auto-generated-title
+ *   case) falls back to `c15:filteredSeriesTitle`/`filteredCategoryTitle`
+ *   (`chartData.filteredSeriesTitle`/`filteredCategoryTitle`), which exist
+ *   for exactly this scenario.
+ * - {@link setDataLabelsRangeCache}: edits one cached label string of a
+ *   series' `c15:datalabelsRange` ("Value From Cells"), keeping the range
+ *   formula itself untouched (core re-derives `c15:dlblRangeCache` on save,
+ *   see `chart-data-labels-range.ts`).
+ *
+ * Every function is a pure decision function returning a new `PptxChartData`
+ * (or `null` when the edit does not apply), so each binding's chart editor
+ * only has to map user intent onto these calls.
+ *
+ * @module render/chart-ext-editor-actions
+ */
+import type { PptxChartData, PptxChartSeries } from 'ooxml-core/pptx';
+/**
+ * Hide a currently-visible series (PowerPoint's Chart Filters "uncheck a
+ * series"): moves it out of {@link PptxChartData.series} into
+ * {@link PptxChartData.filteredSeries}, keeping its data and identity. The
+ * chart must keep at least one visible series.
+ *
+ * The new filtered entry's `idx`/`order` reuse the series' OWN `c:idx` when
+ * it has one (every real OOXML `c:ser` does): this value is what
+ * {@link restoreFilteredSeries} and the Chart Filters popover
+ * (`chart-quick-actions.ts`'s `buildFilters`) key a series' position on, so a
+ * chart with non-sequential idx values (a filtered series in the original
+ * file, or one authored idx 1/2 rather than 0/1, both real-world cases)
+ * keeps its true identity instead of being renumbered to "the smallest idx
+ * not yet taken," which used to reorder the Chart Filters list and lose a
+ * restored series' original position. Only a source series with no idx at
+ * all (a synthetic/malformed chart) falls back to that smallest-free-slot
+ * scheme, to guarantee every idx in the combined visible+filtered set stays
+ * distinct.
+ */
+export declare function hideChartSeries(data: PptxChartData, seriesIndex: number): PptxChartData | null;
+/**
+ * Restore a series PowerPoint's Chart Filters hid (the reverse of
+ * {@link hideChartSeries}): moves it from {@link PptxChartData.filteredSeries}
+ * back into {@link PptxChartData.series}, reinserted at the position its
+ * `idx` puts it among the currently-visible series (not always appended
+ * last, which used to leave a restored series permanently reordered to the
+ * end of the chart, its legend, and its plot/stacking order). When the
+ * filtered entry itself carries no cached name (PowerPoint auto-generated
+ * one, e.g. "Series 3"), falls back to {@link PptxChartData.filteredSeriesTitle};
+ * when it carries no cached categories, falls back to
+ * {@link PptxChartData.filteredCategoryTitle} or the chart's current
+ * categories.
+ */
+export declare function restoreFilteredSeries(data: PptxChartData, filteredIndex: number): PptxChartData | null;
+/**
+ * Edit one cached label string of a series' `c15:datalabelsRange` ("Value
+ * From Cells"). `pointIndex` is padded with empty strings if it falls beyond
+ * the current cache length. The range formula (`dataLabelsRange.formula`)
+ * is left untouched: only the cache PowerPoint shows without the source
+ * workbook changes. Returns the ORIGINAL series unchanged (not `null`) when
+ * it has no `dataLabelsRange` to edit, so a caller can always assign the
+ * result.
+ */
+export declare function setDataLabelsRangeCache(series: PptxChartSeries, pointIndex: number, text: string): PptxChartSeries;
+//# sourceMappingURL=chart-ext-editor-actions.d.ts.map

package/dist/pptx/render/chart-ext-editor-actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart-ext-editor-actions.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/chart-ext-editor-actions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,OAAO,KAAK,EAAE,aAAa,EAA2B,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAE/F;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAkC9F;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,qBAAqB,CACpC,IAAI,EAAE,aAAa,EACnB,aAAa,EAAE,MAAM,GACnB,aAAa,GAAG,IAAI,CA0CtB;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CACtC,MAAM,EAAE,eAAe,EACvB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,GACV,eAAe,CAcjB"}

package/dist/pptx/render/chart-font.d.ts

@@ -0,0 +1,56 @@
+/**
+ * chart-font.ts: the single pt -> px boundary for chart text.
+ *
+ * Core parses every chart font size in POINTS (`c:txPr` run sizes are stored
+ * as `sz / 100`, e.g. `sz="1195"` -> 11.95 pt; see core's chart-axis-parser),
+ * and that unit is part of core's public model: editors and inspectors read
+ * and write points. The SVG chart view-model, however, lives in slide-pixel
+ * space (96 dpi), where PowerPoint paints one point as 4/3 px. Rendering the
+ * parsed number directly as `SvgText.fontSize` therefore drew ALL chart text
+ * at 75% of its true size (issue #132).
+ *
+ * Every parsed chart font size must cross the pt -> px boundary exactly once,
+ * at the moment it enters an `SvgText` descriptor, and that conversion lives
+ * here. Do NOT convert in core (its unit is points by contract) and do NOT
+ * convert again in a binding projector (the view-model is already px).
+ *
+ * The default constants are PowerPoint's chart text defaults expressed in px:
+ * 10 pt body text (axis ticks, category labels, axis titles) and 9 pt data
+ * labels.
+ *
+ * @module chart-font
+ */
+import type { PptxChartLegendTextStyle } from 'ooxml-core/pptx';
+/** CSS pixels per typographic point (96 dpi / 72 dpi = 4/3). */
+export declare const CHART_PX_PER_PT: number;
+/**
+ * Convert a chart font size parsed in points (core's unit) to slide-px for
+ * `SvgText.fontSize`. E.g. 11.95 pt -> 15.93 px.
+ */
+export declare function chartFontPx(sizePt: number): number;
+/**
+ * PowerPoint's default chart body text size (10 pt) in slide-px (13.33):
+ * axis tick labels, category labels, axis titles, and display-unit captions
+ * fall back to this when the chart XML declares no explicit size.
+ */
+export declare const DEFAULT_CHART_TEXT_PX: number;
+/**
+ * PowerPoint's default data-label text size (9 pt) in slide-px (12): value /
+ * category / percent labels attached to data marks fall back to this.
+ */
+export declare const DEFAULT_CHART_DATA_LABEL_PX: number;
+/**
+ * CSS `font-family` for chart text from its `a:latin` and `a:ea` faces.
+ * PowerPoint draws CJK characters in the East Asian face and the rest in the
+ * Latin one. Listing the Latin face first lets the browser fall through to the
+ * East Asian face for characters the Latin face has no glyph for, which
+ * approximates that split.
+ *
+ * Each face brings its substitutes (as shape text does), so a theme font that
+ * is not installed, such as Calibri, falls back to a look-alike instead of the
+ * browser's serif. Generic families go last: one in the middle would catch
+ * CJK characters before they reach the East Asian face. Every name is quoted,
+ * so a name such as `HY견고딕` does not invalidate the declaration.
+ */
+export declare function chartTextFontFamily(style: Pick<PptxChartLegendTextStyle, 'fontFamily' | 'eastAsiaFontFamily'> | undefined): string | undefined;
+//# sourceMappingURL=chart-font.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chart-font.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/chart-font.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAGhE,gEAAgE;AAChE,eAAO,MAAM,eAAe,QAAQ,CAAC;AAErC;;;GAGG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAElD;AAED;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,QAAkB,CAAC;AAErD;;;GAGG;AACH,eAAO,MAAM,2BAA2B,QAAiB,CAAC;AAS1D;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CAClC,KAAK,EAAE,IAAI,CAAC,wBAAwB,EAAE,YAAY,GAAG,oBAAoB,CAAC,GAAG,SAAS,GACpF,MAAM,GAAG,SAAS,CAkBpB"}