@rowsncolumns/charts 27.0.34 → 28.1.0

package/dist/cjs/utils/chart-orientation.js

@@ -0,0 +1,265 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.switchRowColumn = exports.canSwitchRowColumn = exports.rectangularSeriesBounds = exports.deriveChartSeriesFromRange = exports.pickSeriesOrientationForRange = exports.flipSeriesOrientation = exports.inferSeriesOrientation = exports.cellLabelGetterFromRangeReader = void 0;
+var tslib_1 = require("tslib");
+var chart_spec_utils_1 = require("./chart-spec-utils");
+/**
+ * Adapt a range reader (the renderers' `getDomainValuesFromRange`) into
+ * the single-cell label getter the orientation helpers take.
+ */
+var cellLabelGetterFromRangeReader = function (readRange) {
+    return function (sheetId, rowIndex, columnIndex) {
+        var _a = tslib_1.__read(readRange({
+            sheetId: sheetId,
+            startRowIndex: rowIndex,
+            endRowIndex: rowIndex,
+            startColumnIndex: columnIndex,
+            endColumnIndex: columnIndex,
+        }, "SHOW_ALL"), 1), value = _a[0];
+        return value == null ? undefined : String(value);
+    };
+};
+exports.cellLabelGetterFromRangeReader = cellLabelGetterFromRangeReader;
+var isSingleRow = function (range) {
+    return range.startRowIndex === range.endRowIndex;
+};
+var isSingleColumn = function (range) {
+    return range.startColumnIndex === range.endColumnIndex;
+};
+/**
+ * Which way a chart's series run. The explicit flag wins; otherwise a
+ * chart whose every series is a single row spanning several columns is
+ * Excel's series-in-rows shape (OOXML carries no flag — each `<c:ser>` is
+ * its own reference — so imported charts are read this way).
+ */
+var inferSeriesOrientation = function (spec) {
+    if (spec.seriesOrientation)
+        return spec.seriesOrientation;
+    if (!(0, chart_spec_utils_1.isBasicChartSpec)(spec))
+        return "columns";
+    var sources = spec.series.flatMap(function (entry) { var _a; return (_a = entry.sources) !== null && _a !== void 0 ? _a : []; });
+    if (sources.length === 0)
+        return "columns";
+    return sources.every(function (range) { return isSingleRow(range) && !isSingleColumn(range); })
+        ? "rows"
+        : "columns";
+};
+exports.inferSeriesOrientation = inferSeriesOrientation;
+var flipSeriesOrientation = function (orientation) { return (orientation === "rows" ? "columns" : "rows"); };
+exports.flipSeriesOrientation = flipSeriesOrientation;
+/**
+ * Excel's chart wizard picks series-in-rows when the selection is wider
+ * than it is tall.
+ */
+var pickSeriesOrientationForRange = function (range) {
+    return range.endColumnIndex - range.startColumnIndex >
+        range.endRowIndex - range.startRowIndex
+        ? "rows"
+        : "columns";
+};
+exports.pickSeriesOrientationForRange = pickSeriesOrientationForRange;
+/**
+ * Split a data range the way Excel's chart wizard does. Series in
+ * columns: the first column (beneath the header row) is the category
+ * axis and every further column is one series named by its header cell.
+ * Series in rows is the transpose: the first row (right of the header
+ * column) is the category axis and every further row is a series named
+ * by its first cell. A range only one row (column) tall still yields a
+ * one-cell-deep axis so the chart has something to plot.
+ */
+var deriveChartSeriesFromRange = function (_a) {
+    var range = _a.range, orientation = _a.orientation, getFormattedValue = _a.getFormattedValue;
+    var sheetId = range.sheetId, startRowIndex = range.startRowIndex, startColumnIndex = range.startColumnIndex;
+    var endRowIndex = Math.max(range.endRowIndex, startRowIndex);
+    var endColumnIndex = Math.max(range.endColumnIndex, startColumnIndex);
+    var label = function (rowIndex, columnIndex) { var _a; return (_a = getFormattedValue === null || getFormattedValue === void 0 ? void 0 : getFormattedValue(sheetId, rowIndex, columnIndex)) !== null && _a !== void 0 ? _a : undefined; };
+    if (orientation === "rows") {
+        var categoryAxis_1 = {
+            sheetId: sheetId,
+            startRowIndex: startRowIndex,
+            endRowIndex: startRowIndex,
+            startColumnIndex: startColumnIndex + 1,
+            endColumnIndex: Math.max(endColumnIndex, startColumnIndex + 1),
+        };
+        var series_1 = [];
+        for (var rowIndex = startRowIndex + 1; rowIndex <= endRowIndex; rowIndex++) {
+            series_1.push({
+                dataLabel: label(rowIndex, startColumnIndex),
+                sources: [
+                    {
+                        sheetId: sheetId,
+                        startRowIndex: rowIndex,
+                        endRowIndex: rowIndex,
+                        startColumnIndex: categoryAxis_1.startColumnIndex,
+                        endColumnIndex: categoryAxis_1.endColumnIndex,
+                    },
+                ],
+            });
+        }
+        return { domains: [{ sources: [categoryAxis_1] }], series: series_1 };
+    }
+    var categoryAxis = {
+        sheetId: sheetId,
+        startRowIndex: startRowIndex + 1,
+        endRowIndex: Math.max(endRowIndex, startRowIndex + 1),
+        startColumnIndex: startColumnIndex,
+        endColumnIndex: startColumnIndex,
+    };
+    var series = [];
+    for (var columnIndex = startColumnIndex + 1; columnIndex <= endColumnIndex; columnIndex++) {
+        series.push({
+            dataLabel: label(startRowIndex, columnIndex),
+            sources: [
+                {
+                    sheetId: sheetId,
+                    startRowIndex: categoryAxis.startRowIndex,
+                    endRowIndex: categoryAxis.endRowIndex,
+                    startColumnIndex: columnIndex,
+                    endColumnIndex: columnIndex,
+                },
+            ],
+        });
+    }
+    return { domains: [{ sources: [categoryAxis] }], series: series };
+};
+exports.deriveChartSeriesFromRange = deriveChartSeriesFromRange;
+/**
+ * The block the series tile when they form one rectangle: every series
+ * is a single source on the same sheet, all single columns sharing one
+ * row span (series in columns) or all single rows sharing one column
+ * span (series in rows), and adjacent to each other in order. Undefined
+ * for anything else — there is no meaningful transpose of scattered
+ * sources.
+ */
+var rectangularSeriesBounds = function (spec, orientation) {
+    var e_1, _a;
+    if (!(0, chart_spec_utils_1.isBasicChartSpec)(spec) || spec.series.length === 0)
+        return undefined;
+    var sources = [];
+    try {
+        for (var _b = tslib_1.__values(spec.series), _c = _b.next(); !_c.done; _c = _b.next()) {
+            var entry = _c.value;
+            if (!entry.sources || entry.sources.length !== 1)
+                return undefined;
+            sources.push(entry.sources[0]);
+        }
+    }
+    catch (e_1_1) { e_1 = { error: e_1_1 }; }
+    finally {
+        try {
+            if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
+        }
+        finally { if (e_1) throw e_1.error; }
+    }
+    var _d = tslib_1.__read(sources, 1), first = _d[0];
+    var alongRows = orientation === "columns";
+    for (var i = 0; i < sources.length; i++) {
+        var range = sources[i];
+        if (range.sheetId !== first.sheetId)
+            return undefined;
+        if (alongRows) {
+            if (!isSingleColumn(range) ||
+                range.startRowIndex !== first.startRowIndex ||
+                range.endRowIndex !== first.endRowIndex ||
+                range.startColumnIndex !== first.startColumnIndex + i) {
+                return undefined;
+            }
+        }
+        else if (!isSingleRow(range) ||
+            range.startColumnIndex !== first.startColumnIndex ||
+            range.endColumnIndex !== first.endColumnIndex ||
+            range.startRowIndex !== first.startRowIndex + i) {
+            return undefined;
+        }
+    }
+    var last = sources[sources.length - 1];
+    return {
+        sheetId: first.sheetId,
+        startRowIndex: first.startRowIndex,
+        endRowIndex: last.endRowIndex,
+        startColumnIndex: first.startColumnIndex,
+        endColumnIndex: last.endColumnIndex,
+    };
+};
+exports.rectangularSeriesBounds = rectangularSeriesBounds;
+/** Whether `switchRowColumn` has a transpose to offer for this chart. */
+var canSwitchRowColumn = function (spec) {
+    return (0, chart_spec_utils_1.isBasicChartSpec)(spec) &&
+        (!!spec.dataRange ||
+            (0, exports.rectangularSeriesBounds)(spec, (0, exports.inferSeriesOrientation)(spec)) !==
+                undefined);
+};
+exports.canSwitchRowColumn = canSwitchRowColumn;
+/**
+ * Excel's "Switch Row/Column". With a `dataRange` the series and
+ * category axis are re-derived from it the other way round. Without one,
+ * rectangular series sources are transposed: each row (column) of the
+ * block becomes a series, named after the old category cell beside it,
+ * and the old series names become the categories (Excel's behaviour —
+ * the names are carried as inline values because the spec stores them
+ * as text, not as a cell reference). Per-series presentation (colours,
+ * trendlines, …) does not survive the transpose, as in Excel. Returns
+ * undefined when the sources cannot be transposed.
+ */
+var switchRowColumn = function (spec, _a) {
+    var _b, _c, _d, _e, _f;
+    var _g = _a === void 0 ? {} : _a, getFormattedValue = _g.getFormattedValue;
+    if (!(0, chart_spec_utils_1.isBasicChartSpec)(spec))
+        return undefined;
+    var current = (0, exports.inferSeriesOrientation)(spec);
+    var next = (0, exports.flipSeriesOrientation)(current);
+    if (spec.dataRange) {
+        var _h = (0, exports.deriveChartSeriesFromRange)({
+            range: spec.dataRange,
+            orientation: next,
+            getFormattedValue: getFormattedValue,
+        }), domains = _h.domains, series_2 = _h.series;
+        return tslib_1.__assign(tslib_1.__assign({}, spec), { seriesOrientation: next, domains: domains, series: series_2 });
+    }
+    var block = (0, exports.rectangularSeriesBounds)(spec, current);
+    if (!block)
+        return undefined;
+    var categorySource = (_d = (_c = (_b = spec.domains) === null || _b === void 0 ? void 0 : _b[0]) === null || _c === void 0 ? void 0 : _c.sources) === null || _d === void 0 ? void 0 : _d[0];
+    var series = [];
+    if (next === "rows") {
+        for (var rowIndex = block.startRowIndex; rowIndex <= block.endRowIndex; rowIndex++) {
+            var offset = rowIndex - block.startRowIndex;
+            series.push({
+                dataLabel: categorySource && getFormattedValue
+                    ? (_e = getFormattedValue(categorySource.sheetId, categorySource.startRowIndex + offset, categorySource.startColumnIndex)) !== null && _e !== void 0 ? _e : undefined
+                    : undefined,
+                sources: [
+                    {
+                        sheetId: block.sheetId,
+                        startRowIndex: rowIndex,
+                        endRowIndex: rowIndex,
+                        startColumnIndex: block.startColumnIndex,
+                        endColumnIndex: block.endColumnIndex,
+                    },
+                ],
+            });
+        }
+    }
+    else {
+        for (var columnIndex = block.startColumnIndex; columnIndex <= block.endColumnIndex; columnIndex++) {
+            var offset = columnIndex - block.startColumnIndex;
+            series.push({
+                dataLabel: categorySource && getFormattedValue
+                    ? (_f = getFormattedValue(categorySource.sheetId, categorySource.startRowIndex, categorySource.startColumnIndex + offset)) !== null && _f !== void 0 ? _f : undefined
+                    : undefined,
+                sources: [
+                    {
+                        sheetId: block.sheetId,
+                        startRowIndex: block.startRowIndex,
+                        endRowIndex: block.endRowIndex,
+                        startColumnIndex: columnIndex,
+                        endColumnIndex: columnIndex,
+                    },
+                ],
+            });
+        }
+    }
+    var categories = spec.series.map(function (entry, index) { var _a; return (_a = entry.dataLabel) !== null && _a !== void 0 ? _a : "Series ".concat(index + 1); });
+    return tslib_1.__assign(tslib_1.__assign({}, spec), { seriesOrientation: next, domains: [{ sources: [], inlineValues: categories }], series: series });
+};
+exports.switchRowColumn = switchRowColumn;

package/dist/cjs/utils/chart-spec-utils.d.ts

@@ -39,6 +39,9 @@ export declare const getDefaultChartTypeSpec: (chartType: ChartType) => Partial<
 export declare const getPropertiesToRemove: (fromType: ChartType, toType: ChartType) => string[];
 /**
  * Checks if chart data array is empty or contains only placeholder entries.
+ * An entry carrying inline values (`<c:strLit>` / `<c:numLit>` categories,
+ * or the series names Switch Row/Column turns into categories) is real
+ * data even though it references no cells.
  */
 export declare const isPlaceholderChartData: (data?: ChartData[]) => boolean;
 /**

package/dist/cjs/utils/chart-spec-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chart-spec-utils.d.ts","sourceRoot":"","sources":["../../../utils/chart-spec-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,SAAS,EACT,aAAa,EACb,UAAU,EACV,YAAY,EACb,MAAM,2BAA2B,CAAC;AAEnC,KAAK,SAAS,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,WAAW,CAAC,CAAC;AACpD,KAAK,aAAa,GAAG,OAAO,GAAG,QAAQ,GAAG,WAAW,CAAC;AACtD,KAAK,SAAS,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;AAEvC,eAAO,MAAM,iBAAiB,6MAe5B,CAAC;AAEH,eAAO,MAAM,kBAAkB,6MAA4C,CAAC;AAE5E,eAAO,MAAM,qBAAqB,6MAGhC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,gBAAgB,GAAI,WAAW,SAAS,KAAG,aAKvD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,GAC3B,MAAM,SAAS,KACd,IAAI,IAAI,SAAS,GAAG,cAAuD,CAAC;AAE/E,MAAM,MAAM,qBAAqB,GAAG;IAClC,SAAS,EAAE,QAAQ,GAAG,SAAS,CAAC;IAChC,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,YAAY,CAAC,EAAE,SAAS,EAAE,CAAC;IAC3B,WAAW,CAAC,EAAE,SAAS,EAAE,CAAC;IAC1B,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,yEAAyE;IACzE,YAAY,CAAC,EACT,MAAM,GACN,QAAQ,GACR,YAAY,GACZ,cAAc,GACd,QAAQ,GACR,MAAM,GACN,IAAI,CAAC;CACV,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAC5B,MAAM,SAAS,KACd,IAAI,IAAI,SAAS,GAAG,qBACiB,CAAC;AAEzC,MAAM,MAAM,kBAAkB,GAAG,YAAY,GAAG;IAC9C,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAC/B,MAAM,SAAS,KACd,IAAI,IAAI,SAAS,GAAG,kBACoB,CAAC;AAwC5C;;GAEG;AACH,eAAO,MAAM,uBAAuB,GAClC,WAAW,SAAS,KACnB,OAAO,CAAC,SAAS,CAEnB,CAAC;AA8EF;;;GAGG;AACH,eAAO,MAAM,qBAAqB,GAChC,UAAU,SAAS,EACnB,QAAQ,SAAS,KAChB,MAAM,EAoBR,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,sBAAsB,GAAI,OAAO,SAAS,EAAE,KAAG,OAM3D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,mBAAmB,GAC9B,UAAU,SAAS,EAAE,EACrB,WAAW,SAAS,EAAE,KACrB,SAAS,EAKX,CAAC;AA+BF;;;;GAIG;AACH,eAAO,MAAM,cAAc,GACzB,cAAc,SAAS,EACvB,cAAc,OAAO,CAAC,SAAS,CAAC,KAC/B,SA0EF,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,kBAAkB,GAAI,MAAM,SAAS,KAAG,UAAU,EAsB9D,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,GAAI,QAAQ,OAAO,KAAG,MAQvD,CAAC"}
+{"version":3,"file":"chart-spec-utils.d.ts","sourceRoot":"","sources":["../../../utils/chart-spec-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,SAAS,EACT,aAAa,EACb,UAAU,EACV,YAAY,EACb,MAAM,2BAA2B,CAAC;AAEnC,KAAK,SAAS,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,WAAW,CAAC,CAAC;AACpD,KAAK,aAAa,GAAG,OAAO,GAAG,QAAQ,GAAG,WAAW,CAAC;AACtD,KAAK,SAAS,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;AAEvC,eAAO,MAAM,iBAAiB,6MAe5B,CAAC;AAEH,eAAO,MAAM,kBAAkB,6MAA4C,CAAC;AAE5E,eAAO,MAAM,qBAAqB,6MAGhC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,gBAAgB,GAAI,WAAW,SAAS,KAAG,aAKvD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,GAC3B,MAAM,SAAS,KACd,IAAI,IAAI,SAAS,GAAG,cAAuD,CAAC;AAE/E,MAAM,MAAM,qBAAqB,GAAG;IAClC,SAAS,EAAE,QAAQ,GAAG,SAAS,CAAC;IAChC,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,YAAY,CAAC,EAAE,SAAS,EAAE,CAAC;IAC3B,WAAW,CAAC,EAAE,SAAS,EAAE,CAAC;IAC1B,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,yEAAyE;IACzE,YAAY,CAAC,EACT,MAAM,GACN,QAAQ,GACR,YAAY,GACZ,cAAc,GACd,QAAQ,GACR,MAAM,GACN,IAAI,CAAC;CACV,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAC5B,MAAM,SAAS,KACd,IAAI,IAAI,SAAS,GAAG,qBACiB,CAAC;AAEzC,MAAM,MAAM,kBAAkB,GAAG,YAAY,GAAG;IAC9C,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAC/B,MAAM,SAAS,KACd,IAAI,IAAI,SAAS,GAAG,kBACoB,CAAC;AAwC5C;;GAEG;AACH,eAAO,MAAM,uBAAuB,GAClC,WAAW,SAAS,KACnB,OAAO,CAAC,SAAS,CAEnB,CAAC;AAiFF;;;GAGG;AACH,eAAO,MAAM,qBAAqB,GAChC,UAAU,SAAS,EACnB,QAAQ,SAAS,KAChB,MAAM,EAoBR,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,GAAI,OAAO,SAAS,EAAE,KAAG,OAO3D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,mBAAmB,GAC9B,UAAU,SAAS,EAAE,EACrB,WAAW,SAAS,EAAE,KACrB,SAAS,EAKX,CAAC;AA+BF;;;;GAIG;AACH,eAAO,MAAM,cAAc,GACzB,cAAc,SAAS,EACvB,cAAc,OAAO,CAAC,SAAS,CAAC,KAC/B,SA0EF,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,kBAAkB,GAAI,MAAM,SAAS,KAAG,UAAU,EAsB9D,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,GAAI,QAAQ,OAAO,KAAG,MAQvD,CAAC"}

package/dist/cjs/utils/chart-spec-utils.js

@@ -98,12 +98,13 @@ exports.getDefaultChartTypeSpec = getDefaultChartTypeSpec;
  * These should be cleared when switching between chart types within basic charts.
  */
 var BASIC_CHART_TYPE_PROPERTIES = {
-    line: ["smooth"],
+    line: ["smooth", "showMarkers"],
     // `doughnutHoleSize` is deliberately NOT cleared when leaving pie so
     // upgrading a legacy pie-based doughnut (pie + doughnutHoleSize) to
     // the first-class doughnut token keeps the authored hole size.
     pie: [
         "radius",
+        "explosion",
         // Of-pie composite fields (pie-of-pie / bar-of-pie) — meaningless
         // on any other chart type, so drop them on transition.
         "sourceChartType",
@@ -112,7 +113,7 @@ var BASIC_CHART_TYPE_PROPERTIES = {
         "splitPos",
         "secondPieSize",
     ],
-    doughnut: ["doughnutHoleSize"],
+    doughnut: ["doughnutHoleSize", "explosion"],
     waterfall: ["totalIndices"],
     boxplot: ["quartileMethod", "showOutliers", "showMeanMarker"],
     // Region map (filled map / choropleth) — the geo scope and the
@@ -126,7 +127,9 @@ var BASIC_CHART_TYPE_PROPERTIES = {
 var CATEGORY_SPECIFIC_PROPERTIES = {
     basic: [
         "smooth",
+        "showMarkers",
         "radius",
+        "explosion",
         "stackedType",
         "doughnutHoleSize",
         "totalIndices",
@@ -190,13 +193,18 @@ var getPropertiesToRemove = function (fromType, toType) {
 exports.getPropertiesToRemove = getPropertiesToRemove;
 /**
  * Checks if chart data array is empty or contains only placeholder entries.
+ * An entry carrying inline values (`<c:strLit>` / `<c:numLit>` categories,
+ * or the series names Switch Row/Column turns into categories) is real
+ * data even though it references no cells.
  */
 var isPlaceholderChartData = function (data) {
     if (!data || data.length === 0)
         return true;
     return data.every(function (entry) {
-        var _a;
-        var sources = (_a = entry === null || entry === void 0 ? void 0 : entry.sources) !== null && _a !== void 0 ? _a : [];
+        var _a, _b;
+        if ((_a = entry === null || entry === void 0 ? void 0 : entry.inlineValues) === null || _a === void 0 ? void 0 : _a.length)
+            return false;
+        var sources = (_b = entry === null || entry === void 0 ? void 0 : entry.sources) !== null && _b !== void 0 ? _b : [];
         return sources.length === 0 || sources.every(function (source) { return !source; });
     });
 };

package/dist/cjs/utils/chart-styles.d.ts

@@ -0,0 +1,75 @@
+import type { ChartSpec } from "@rowsncolumns/spreadsheet";
+/**
+ * Excel's Chart Design tab as pure spec transforms: Chart Styles, Change
+ * Colors, Quick Layouts and Reset to Match Style. Every transform returns
+ * a new spec and writes only the fields the gallery entry defines, so the
+ * result renders identically on both renderers (they read the same spec)
+ * and survives the XLSX round-trip field by field.
+ */
+/** A "Change Colors" gallery entry. `colors` omitted = the workbook theme's accents. */
+export type ChartColorPalette = {
+    id: string;
+    label: string;
+    kind: "colorful" | "monochromatic";
+    colors?: string[];
+};
+/**
+ * Office's Change Colors gallery. Colorful 1 is the theme itself (no
+ * `colors` — the renderer keeps its accent fallback); the rest are the
+ * default Office theme's derived palettes.
+ */
+export declare const CHART_COLOR_PALETTES: readonly ChartColorPalette[];
+/**
+ * Change Colors: set the palette and clear every series' own colour so the
+ * palette applies (a series colour always wins over the palette).
+ */
+export declare const applyChartColorPalette: (spec: ChartSpec, palette: ChartColorPalette) => ChartSpec;
+/**
+ * Reset to Match Style: drop the per-series formatting overrides so the
+ * series follow the chart style's palette again. Chart-level fields are
+ * untouched — they *are* the style.
+ */
+export declare const resetChartToMatchStyle: (spec: ChartSpec) => ChartSpec;
+/**
+ * The series colour cycle a renderer should use: the spec's palette when
+ * one is set, else the caller's theme accents.
+ */
+export declare const getChartPalette: (spec: Pick<ChartSpec, "palette"> | undefined, fallback: readonly string[]) => string[];
+/**
+ * A Chart Styles gallery entry. `id` is the OOXML `<c:style>` value the
+ * style is written as (§21.2.3.46 ST_Style: 1 grayscale, 2 colourful, 3
+ * monochromatic accent 1, +8 per row of increasing emphasis, 33-40 on a
+ * dark-gray frame, 41-48 on black).
+ */
+export type ChartStylePreset = {
+    id: number;
+    label: string;
+    /** Swatch colours for the gallery tile. */
+    preview: {
+        background: string;
+        bars: string[];
+    };
+    apply(spec: ChartSpec): ChartSpec;
+};
+/**
+ * The Chart Styles gallery. Each entry pins the look Excel's style of that
+ * id implies onto the spec fields both renderers read: chart-area fill,
+ * gridlines, data labels, legend placement, title font and — for the
+ * grayscale / monochromatic rows — the palette. Per-series colours are
+ * left alone (Reset to Match Style clears them).
+ */
+export declare const CHART_STYLES: readonly ChartStylePreset[];
+export declare const applyChartStyle: (spec: ChartSpec, style: ChartStylePreset) => ChartSpec;
+/** A Quick Layouts gallery entry — where the title, legend, labels and axis titles go. */
+export type ChartQuickLayout = {
+    id: number;
+    label: string;
+    apply(spec: ChartSpec): ChartSpec;
+};
+/**
+ * Excel's Quick Layout gallery (the first six of the column-chart set).
+ * Layouts arrange the existing elements; they never touch colours.
+ */
+export declare const CHART_QUICK_LAYOUTS: readonly ChartQuickLayout[];
+export declare const applyChartQuickLayout: (spec: ChartSpec, layout: ChartQuickLayout) => ChartSpec;
+//# sourceMappingURL=chart-styles.d.ts.map

package/dist/cjs/utils/chart-styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart-styles.d.ts","sourceRoot":"","sources":["../../../utils/chart-styles.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,SAAS,EAEV,MAAM,2BAA2B,CAAC;AAEnC;;;;;;GAMG;AAEH,wFAAwF;AACxF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,UAAU,GAAG,eAAe,CAAC;IACnC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,EAAE,SAAS,iBAAiB,EA4C5D,CAAC;AAsBF;;;GAGG;AACH,eAAO,MAAM,sBAAsB,GACjC,MAAM,SAAS,EACf,SAAS,iBAAiB,KACzB,SAGD,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,GAAI,MAAM,SAAS,KAAG,SAC9B,CAAC;AAE5B;;;GAGG;AACH,eAAO,MAAM,eAAe,GAC1B,MAAM,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC,GAAG,SAAS,EAC5C,UAAU,SAAS,MAAM,EAAE,KAC1B,MAAM,EAGU,CAAC;AAEpB;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,2CAA2C;IAC3C,OAAO,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAChD,KAAK,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,CAAC;CACnC,CAAC;AAmDF;;;;;;GAMG;AACH,eAAO,MAAM,YAAY,EAAE,SAAS,gBAAgB,EAwInD,CAAC;AAEF,eAAO,MAAM,eAAe,GAC1B,MAAM,SAAS,EACf,OAAO,gBAAgB,KACtB,SAA8B,CAAC;AAElC,0FAA0F;AAC1F,MAAM,MAAM,gBAAgB,GAAG;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,CAAC;CACnC,CAAC;AA0BF;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE,SAAS,gBAAgB,EAqE1D,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAChC,MAAM,SAAS,EACf,QAAQ,gBAAgB,KACvB,SAA+B,CAAC"}