ooxml-core 1.16.1 → 1.18.0

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"}