ooxml-core 1.17.0 → 1.19.0

package/dist/chart/axis-range-auto.d.ts

@@ -0,0 +1,10 @@
+import type { ChartAxisRange, ChartAxisSeries } from './axis-range-types.js';
+export declare function computeAxisValueRange(series: ReadonlyArray<ChartAxisSeries>, plotHeightPx?: number): ChartAxisRange;
+/**
+ * Value range for a stacked bar: the per-category sums, then the same automatic
+ * scale as any other value axis.
+ *
+ * @param plotHeightPx See `computeChartAxisRange`'s parameter of the same name.
+ */
+export declare function computeAxisStackedValueRange(series: ReadonlyArray<ChartAxisSeries>, catCount: number, plotHeightPx?: number): ChartAxisRange;
+//# sourceMappingURL=axis-range-auto.d.ts.map

package/dist/chart/axis-range-auto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"axis-range-auto.d.ts","sourceRoot":"","sources":["../../chart/axis-range-auto.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1E,wBAAgB,qBAAqB,CACpC,MAAM,EAAE,aAAa,CAAC,eAAe,CAAC,EACtC,YAAY,CAAC,EAAE,MAAM,GACnB,cAAc,CAsBhB;AAED;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAC3C,MAAM,EAAE,aAAa,CAAC,eAAe,CAAC,EACtC,QAAQ,EAAE,MAAM,EAChB,YAAY,CAAC,EAAE,MAAM,GACnB,cAAc,CAuBhB"}

package/dist/chart/axis-range-types.d.ts

@@ -0,0 +1,27 @@
+/** Numeric series required by the shared axis algorithms. */
+export interface ChartAxisSeries {
+    values: readonly (number | null)[];
+}
+/** Axis scaling inputs; adapters map native chart models onto these fields. */
+export interface ChartAxisOptions {
+    axisType?: string;
+    axPos?: string;
+    min?: number;
+    max?: number;
+    logScale?: boolean;
+    logBase?: number;
+    orientation?: string;
+    majorUnit?: number;
+    minorUnit?: number;
+}
+/** Data-space bounds, with a logarithmic span when requested. */
+export interface ChartAxisRange {
+    min: number;
+    max: number;
+    span: number;
+    logScale?: boolean;
+    logBase?: number;
+    reverseOrder?: boolean;
+    majorUnit?: number;
+}
+//# sourceMappingURL=axis-range-types.d.ts.map

package/dist/chart/axis-range-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"axis-range-types.d.ts","sourceRoot":"","sources":["../../chart/axis-range-types.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,MAAM,WAAW,eAAe;IAC/B,MAAM,EAAE,SAAS,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC;CACnC;AACD,+EAA+E;AAC/E,MAAM,WAAW,gBAAgB;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AACD,iEAAiE;AACjE,MAAM,WAAW,cAAc;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB"}

package/dist/chart/axis-range.d.ts

@@ -0,0 +1,37 @@
+import type { ChartAxisOptions, ChartAxisRange, ChartAxisSeries } from './axis-range-types.js';
+type ValueRange = ChartAxisRange;
+/** Compute a logarithmic range snapped to powers of the requested base. */
+export declare function computeLogValueRange(series: ReadonlyArray<ChartAxisSeries>, logBase: number): ValueRange;
+/**
+ * Compute a value range using one parsed value axis's scale and bounds.
+ *
+ * @param plotHeightPx The chart's plot-area height, when known; forwarded to
+ *   `computeValueRange`'s automatic-scale gridline count (see
+ *   `axisTargetIntervals`'s doc comment). Not used on the log-scale branch,
+ *   which snaps to powers of the log base regardless of chart size.
+ */
+export declare function computeValueRangeForAxis(series: ReadonlyArray<ChartAxisSeries>, axis: ChartAxisOptions | undefined, plotHeightPx?: number): ValueRange;
+/**
+ * Compute a stacked chart's value range on its value axis: the category
+ * totals, scaled by an explicit `c:min` / `c:max` the same way an unstacked
+ * range is, or percentStacked's 0 to 100 (see {@link percentStackedRange}).
+ * Both follow `c:orientation`.
+ */
+export declare function computeStackedValueRangeForAxis(series: ReadonlyArray<ChartAxisSeries>, catCount: number, axis: ChartAxisOptions | undefined, isPercent: boolean, plotSizePx?: number): ValueRange;
+/**
+ * Apply a value axis's explicit `c:min` / `c:max` and `c:orientation` to an
+ * automatic range, stacked or not.
+ */
+export declare function withAxisBounds(automatic: ValueRange, axis: ChartAxisOptions | undefined, logBase?: number): ValueRange;
+/** Map a data value to a logarithmic Y coordinate. */
+export declare function valueToYLog(val: number, range: ValueRange, topY: number, bottomY: number): number;
+/** Find any parsed logarithmic value axis. */
+export declare function findLogAxis<T extends ChartAxisOptions>(axes: T[] | undefined): T | undefined;
+/**
+ * Compute the primary value range for a chart.
+ *
+ * @param plotHeightPx See `computeValueRangeForAxis`'s parameter of the same name.
+ */
+export declare function computeValueRangeForChart(series: ReadonlyArray<ChartAxisSeries>, axes?: ChartAxisOptions[], plotHeightPx?: number): ValueRange;
+export {};
+//# sourceMappingURL=axis-range.d.ts.map

package/dist/chart/axis-range.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"axis-range.d.ts","sourceRoot":"","sources":["../../chart/axis-range.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC5F,KAAK,UAAU,GAAG,cAAc,CAAC;AAEjC,2EAA2E;AAC3E,wBAAgB,oBAAoB,CACnC,MAAM,EAAE,aAAa,CAAC,eAAe,CAAC,EACtC,OAAO,EAAE,MAAM,GACb,UAAU,CAoBZ;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CACvC,MAAM,EAAE,aAAa,CAAC,eAAe,CAAC,EACtC,IAAI,EAAE,gBAAgB,GAAG,SAAS,EAClC,YAAY,CAAC,EAAE,MAAM,GACnB,UAAU,CAYZ;AAED;;;;;GAKG;AACH,wBAAgB,+BAA+B,CAC9C,MAAM,EAAE,aAAa,CAAC,eAAe,CAAC,EACtC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,gBAAgB,GAAG,SAAS,EAClC,SAAS,EAAE,OAAO,EAClB,UAAU,CAAC,EAAE,MAAM,GACjB,UAAU,CAQZ;AAkCD;;;GAGG;AACH,wBAAgB,cAAc,CAC7B,SAAS,EAAE,UAAU,EACrB,IAAI,EAAE,gBAAgB,GAAG,SAAS,EAClC,OAAO,CAAC,EAAE,MAAM,GACd,UAAU,CA6BZ;AAED,sDAAsD;AACtD,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAMjG;AAED,8CAA8C;AAC9C,wBAAgB,WAAW,CAAC,CAAC,SAAS,gBAAgB,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,SAAS,GAAG,CAAC,GAAG,SAAS,CAE5F;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CACxC,MAAM,EAAE,aAAa,CAAC,eAAe,CAAC,EACtC,IAAI,CAAC,EAAE,gBAAgB,EAAE,EACzB,YAAY,CAAC,EAAE,MAAM,GACnB,UAAU,CAKZ"}

package/dist/chart/axis-ticks.d.ts

@@ -0,0 +1,8 @@
+import type { ChartAxisOptions, ChartAxisRange as ValueRange } from './axis-range-types.js';
+/** Generate one tick for each power of the range's logarithmic base. */
+export declare function generateLogTicks(range: ValueRange): number[];
+/** Generate major tick values, honoring an explicit `c:majorUnit`. */
+export declare function generateAxisTicks(range: ValueRange, axis: ChartAxisOptions | undefined, defaultIntervals: number): number[];
+/** Generate minor gridline values, excluding positions occupied by major ticks. */
+export declare function generateMinorAxisTicks(range: ValueRange, axis: ChartAxisOptions | undefined): number[];
+//# sourceMappingURL=axis-ticks.d.ts.map

package/dist/chart/axis-ticks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"axis-ticks.d.ts","sourceRoot":"","sources":["../../chart/axis-ticks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,IAAI,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAGzF,wEAAwE;AACxE,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,EAAE,CAgB5D;AAaD,sEAAsE;AACtE,wBAAgB,iBAAiB,CAChC,KAAK,EAAE,UAAU,EACjB,IAAI,EAAE,gBAAgB,GAAG,SAAS,EAClC,gBAAgB,EAAE,MAAM,GACtB,MAAM,EAAE,CAoBV;AAED,mFAAmF;AACnF,wBAAgB,sBAAsB,CACrC,KAAK,EAAE,UAAU,EACjB,IAAI,EAAE,gBAAgB,GAAG,SAAS,GAChC,MAAM,EAAE,CAaV"}

package/dist/chart/data-label-text.d.ts

@@ -0,0 +1,70 @@
+/** The content switches one cascade level (a `c:dLbl`, a series' or a group's `c:dLbls`) writes. */
+export interface DataLabelFlagLevel {
+    showValue?: boolean | undefined;
+    showCategory?: boolean | undefined;
+    showSeriesName?: boolean | undefined;
+    showPercent?: boolean | undefined;
+    showBubbleSize?: boolean | undefined;
+    separator?: string | undefined;
+}
+/** The levels a point's label reads, highest priority first. */
+export interface DataLabelFlagLevels {
+    point?: DataLabelFlagLevel | undefined;
+    series?: DataLabelFlagLevel | undefined;
+    chart?: DataLabelFlagLevel | undefined;
+    /**
+     * No level here declares anything, but another series writes its own labels: this series then
+     * shows none, rather than falling back to the value.
+     */
+    siblingOwnsLabels?: boolean | undefined;
+}
+/** The label content flags once the cascade has been applied. */
+export interface DataLabelFlags {
+    showValue: boolean;
+    showCategory: boolean;
+    showSeriesName: boolean;
+    showPercent: boolean;
+    showBubbleSize: boolean;
+    /** Text joining the enabled components. */
+    separator: string;
+}
+/** Office's default separator between combined label components. */
+export declare const DATA_LABEL_SEPARATOR = ", ";
+/** Office's default when a label shows the category name and the percentage: a line break. */
+export declare const DATA_LABEL_CATEGORY_PERCENT_SEPARATOR = "\n";
+/**
+ * Applies the point > series > group cascade to the content flags.
+ *
+ * A flag counts as declared when any level writes it, even as `0`: Office writes an all-zero
+ * group level on every chart it authors, and that means "no labels", never "fall back to the
+ * value". When nothing is declared anywhere the label shows the value only.
+ */
+export declare function resolveDataLabelFlags(levels: DataLabelFlagLevels): DataLabelFlags;
+/** What one label is built from. */
+export interface DataLabelTextInput {
+    flags: DataLabelFlags;
+    seriesName?: string | undefined;
+    category?: string | undefined;
+    value: number;
+    /** Number format code of the label (point, series, group or source cells). */
+    numberFormat?: string | undefined;
+    /** Denominator of `showPercent`: the sum of the series' absolute values on a pie. */
+    percentBase: number;
+    bubbleSize?: number | undefined;
+    /** Value text when the format code is absent, `General` or unsupported. Default `String`. */
+    formatValue?: ((value: number, numberFormat: string | undefined) => string) | undefined;
+    /** Bubble size text. Default `String`. */
+    formatBubbleSize?: ((size: number) => string) | undefined;
+}
+/** A built data label: its text and the `[Red]`/`[Blue]` colour of its number format, if any. */
+export interface DataLabelText {
+    text: string;
+    /** Only set when the label is the formatted value alone (a joined label cannot tint one part). */
+    color?: string | undefined;
+}
+/**
+ * The text of one label in Office's component order (series name, category, value, percentage,
+ * bubble size), or `undefined` when it resolves to nothing.
+ */
+export declare function composeDataLabelText(input: DataLabelTextInput): DataLabelText | undefined;
+//# sourceMappingURL=data-label-text.d.ts.map

package/dist/chart/data-label-text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-label-text.d.ts","sourceRoot":"","sources":["../../chart/data-label-text.ts"],"names":[],"mappings":"AASA,oGAAoG;AACpG,MAAM,WAAW,kBAAkB;IAClC,SAAS,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAChC,YAAY,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACnC,cAAc,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACrC,WAAW,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAClC,cAAc,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACrC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC/B;AAED,gEAAgE;AAChE,MAAM,WAAW,mBAAmB;IACnC,KAAK,CAAC,EAAE,kBAAkB,GAAG,SAAS,CAAC;IACvC,MAAM,CAAC,EAAE,kBAAkB,GAAG,SAAS,CAAC;IACxC,KAAK,CAAC,EAAE,kBAAkB,GAAG,SAAS,CAAC;IACvC;;;OAGG;IACH,iBAAiB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACxC;AAED,iEAAiE;AACjE,MAAM,WAAW,cAAc;IAC9B,SAAS,EAAE,OAAO,CAAC;IACnB,YAAY,EAAE,OAAO,CAAC;IACtB,cAAc,EAAE,OAAO,CAAC;IACxB,WAAW,EAAE,OAAO,CAAC;IACrB,cAAc,EAAE,OAAO,CAAC;IACxB,2CAA2C;IAC3C,SAAS,EAAE,MAAM,CAAC;CAClB;AAED,oEAAoE;AACpE,eAAO,MAAM,oBAAoB,OAAO,CAAC;AAEzC,8FAA8F;AAC9F,eAAO,MAAM,qCAAqC,OAAO,CAAC;AAU1D;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,mBAAmB,GAAG,cAAc,CAmBjF;AAED,oCAAoC;AACpC,MAAM,WAAW,kBAAkB;IAClC,KAAK,EAAE,cAAc,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,8EAA8E;IAC9E,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,qFAAqF;IACrF,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,6FAA6F;IAC7F,WAAW,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,SAAS,KAAK,MAAM,CAAC,GAAG,SAAS,CAAC;IACxF,0CAA0C;IAC1C,gBAAgB,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC,GAAG,SAAS,CAAC;CAC1D;AAED,iGAAiG;AACjG,MAAM,WAAW,aAAa;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,kGAAkG;IAClG,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3B;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,kBAAkB,GAAG,aAAa,GAAG,SAAS,CAoBzF"}

package/dist/chart/formatting-nodes.d.ts

@@ -1,4 +1,10 @@
 import { type XmlElement } from '../xml/index.js';
+/**
+ * The `c:dLbls` whose text formatting the painter uses for data labels: the first series' (else the
+ * first group's) that switches a label on or carries text properties. Read-only: the formatting
+ * writers do not patch it.
+ */
+export declare function chartDataLabelNode(root: XmlElement): XmlElement | undefined;
 /** Shared element mapping for direct chart formatting, including scatter X/Y axes. */
 export declare function chartFormattingNodes(root: XmlElement): {
     chartArea: Element;

package/dist/chart/formatting-nodes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"formatting-nodes.d.ts","sourceRoot":"","sources":["../../chart/formatting-nodes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,KAAK,UAAU,EAAE,MAAM,QAAQ,CAAC;AAE9D,sFAAsF;AACtF,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,UAAU;IAMnD,SAAS;IACT,QAAQ;IACR,KAAK;IACL,MAAM;IACN,YAAY;IACZ,SAAS;IACT,aAAa;IACb,aAAa;EAEd"}
+{"version":3,"file":"formatting-nodes.d.ts","sourceRoot":"","sources":["../../chart/formatting-nodes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiC,KAAK,UAAU,EAAE,MAAM,QAAQ,CAAC;AAExE;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,UAAU,GAAG,UAAU,GAAG,SAAS,CAe3E;AAED,sFAAsF;AACtF,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,UAAU;IAMnD,SAAS;IACT,QAAQ;IACR,KAAK;IACL,MAAM;IACN,YAAY;IACZ,SAAS;IACT,aAAa;IACb,aAAa;EAEd"}