@rowsncolumns/spreadsheet 10.3.1 → 10.4.0

package/dist/cjs/api/banded-ranges.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"banded-ranges.d.ts","sourceRoot":"","sources":["../../../api/banded-ranges.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAE1E,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAEtE;;;;;GAKG;AACH,eAAO,MAAM,cAAc,GACzB,cAAc,WAAW,EAAE,EAC3B,OAAO,gBAAgB,EACvB,SAAS,MAAM,EACf,aAAa,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,EAC1C,gBAAgB,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,4BA0HjD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,GAAI,OAAO,KAAK,CAAC,KAAK,GAAG,MAAM,CAAC,iBAE5D,CAAC"}
+{"version":3,"file":"banded-ranges.d.ts","sourceRoot":"","sources":["../../../api/banded-ranges.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAE1E,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAEtE;;;;;GAKG;AACH,eAAO,MAAM,cAAc,GACzB,cAAc,WAAW,EAAE,EAC3B,OAAO,gBAAgB,EACvB,SAAS,MAAM,EACf,aAAa,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,EAC1C,gBAAgB,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,4BAuKjD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,GAAI,OAAO,KAAK,CAAC,KAAK,GAAG,MAAM,CAAC,iBAE5D,CAAC"}

package/dist/cjs/api/banded-ranges.js

@@ -13,18 +13,18 @@ var themes_1 = require("../themes");
  */
 var getBandedCells = function (bandedRanges, theme, sheetId, isHiddenRow, isHiddenColumn) {
     var e_1, _a;
-    var _b, _c;
+    var _b, _c, _d;
     var bandedCells = new Map();
     try {
         for (var bandedRanges_1 = tslib_1.__values(bandedRanges), bandedRanges_1_1 = bandedRanges_1.next(); !bandedRanges_1_1.done; bandedRanges_1_1 = bandedRanges_1.next()) {
-            var _d = bandedRanges_1_1.value, range = _d.range, rowProperties = _d.rowProperties, columnProperties = _d.columnProperties;
+            var _e = bandedRanges_1_1.value, range = _e.range, rowProperties = _e.rowProperties, columnProperties = _e.columnProperties, showFirstColumn = _e.showFirstColumn, showLastColumn = _e.showLastColumn, totalRow = _e.totalRow;
             // Only pick current sheet
             if (range.sheetId !== sheetId) {
                 continue;
             }
             if (rowProperties || columnProperties) {
-                var _e = rowProperties !== null && rowProperties !== void 0 ? rowProperties : {}, headerColor = _e.headerColor, firstBandColor = _e.firstBandColor, secondBandColor = _e.secondBandColor, footerColor = _e.footerColor, headerBorder = _e.headerBorder, firstBandBorder = _e.firstBandBorder, footerBorder = _e.footerBorder;
-                var _f = columnProperties !== null && columnProperties !== void 0 ? columnProperties : {}, firstBandColorColumn = _f.firstBandColor, secondBandColorColumn = _f.secondBandColor;
+                var _f = rowProperties !== null && rowProperties !== void 0 ? rowProperties : {}, headerColor = _f.headerColor, firstBandColor = _f.firstBandColor, secondBandColor = _f.secondBandColor, footerColor = _f.footerColor, headerBorder = _f.headerBorder, firstBandBorder = _f.firstBandBorder, footerBorder = _f.footerBorder, firstColumnColor = _f.firstColumnColor, lastColumnColor = _f.lastColumnColor, totalRowColor = _f.totalRowColor, totalRowBorder = _f.totalRowBorder, totalRowBold = _f.totalRowBold;
+                var _g = columnProperties !== null && columnProperties !== void 0 ? columnProperties : {}, firstBandColorColumn = _g.firstBandColor, secondBandColorColumn = _g.secondBandColor;
                 var parsedFirstBandColor = (0, exports.parseTintedColor)(firstBandColor);
                 var parsedSecondBandColor = (0, exports.parseTintedColor)(secondBandColor);
                 var parsedFirstBandColorColumn = (0, exports.parseTintedColor)(firstBandColorColumn);
@@ -63,27 +63,53 @@ var getBandedCells = function (bandedRanges, theme, sheetId, isHiddenRow, isHidd
                         // Body cells
                         else {
                             var isFooter = rowIndex === lastVisibleRowIndex;
+                            // A table's totals row takes the style's `totalRow` element (Excel):
+                            // its fill, its top rule and a bold font — over the plain footer band.
+                            var isTotalsRow = isFooter && !!totalRow;
                             var stripeRowBackground = isOddRow
                                 ? parsedFirstBandColor
                                 : parsedSecondBandColor;
-                            var backgroundColor = isFooter
+                            // The footer fill belongs to a totals row (a table without one ends in a plain
+                            // stripe); the footer border is the style's table outline and stays on the last row
+                            // either way. A standalone banded range (no `totalRow` flag) keeps Sheets' footer fill.
+                            var footerBackground = isFooter && totalRow !== false
                                 ? footerColor !== null && footerColor !== void 0 ? footerColor : stripeRowBackground
                                 : stripeRowBackground;
+                            var backgroundColor = isTotalsRow
+                                ? totalRowColor !== null && totalRowColor !== void 0 ? totalRowColor : footerBackground
+                                : isFooter
+                                    ? footerBackground
+                                    : stripeRowBackground;
                             // Border
-                            var borders = isFooter
-                                ? footerBorder !== null && footerBorder !== void 0 ? footerBorder : firstBandBorder
-                                : firstBandBorder;
+                            var borders = isTotalsRow
+                                ? (_b = totalRowBorder !== null && totalRowBorder !== void 0 ? totalRowBorder : footerBorder) !== null && _b !== void 0 ? _b : firstBandBorder
+                                : isFooter
+                                    ? footerBorder !== null && footerBorder !== void 0 ? footerBorder : firstBandBorder
+                                    : firstBandBorder;
                             var isEvenColumn = columnRunningIndex % 2 === 0;
-                            var finalBackgroundColor = (_b = (isEvenColumn
+                            var finalBackgroundColor = (_c = (isEvenColumn
                                 ? parsedFirstBandColorColumn
-                                : parsedSecondBandColorColumn)) !== null && _b !== void 0 ? _b : backgroundColor;
-                            var textColor = isFooter
-                                ? footerColor !== null && footerColor !== void 0 ? footerColor : stripeRowBackground
-                                : (_c = parsedFirstBandColor !== null && parsedFirstBandColor !== void 0 ? parsedFirstBandColor : parsedSecondBandColor) !== null && _c !== void 0 ? _c : finalBackgroundColor;
+                                : parsedSecondBandColorColumn)) !== null && _c !== void 0 ? _c : backgroundColor;
+                            // First / Last Column emphasis (Excel: bold, plus the style's fill when it has one).
+                            // First Column outranks Last Column on a one-column table, like Excel's element order.
+                            var edgeColumnColor = showFirstColumn && columnIndex === range.startColumnIndex
+                                ? (0, exports.parseTintedColor)(firstColumnColor)
+                                : showLastColumn && columnIndex === range.endColumnIndex
+                                    ? (0, exports.parseTintedColor)(lastColumnColor)
+                                    : undefined;
+                            var isEdgeColumn = (showFirstColumn && columnIndex === range.startColumnIndex) ||
+                                (showLastColumn && columnIndex === range.endColumnIndex);
+                            var cellBackgroundColor = edgeColumnColor !== null && edgeColumnColor !== void 0 ? edgeColumnColor : finalBackgroundColor;
+                            var textColor = edgeColumnColor !== null && edgeColumnColor !== void 0 ? edgeColumnColor : (isTotalsRow
+                                ? totalRowColor !== null && totalRowColor !== void 0 ? totalRowColor : footerBackground
+                                : isFooter
+                                    ? footerBackground
+                                    : (_d = parsedFirstBandColor !== null && parsedFirstBandColor !== void 0 ? parsedFirstBandColor : parsedSecondBandColor) !== null && _d !== void 0 ? _d : finalBackgroundColor);
                             bandedCells.set(id, {
                                 borders: borders,
-                                backgroundColor: finalBackgroundColor,
+                                backgroundColor: cellBackgroundColor,
                                 textFormat: {
+                                    bold: isEdgeColumn || (isTotalsRow && totalRowBold) ? true : undefined,
                                     color: textColor
                                         ? (0, utils_1.getContrastColor)((0, themes_1.getStringifiedColor)(textColor, theme), (0, themes_1.getStringifiedColor)({ theme: 1 }, theme), (0, themes_1.getStringifiedColor)({ theme: 0 }, theme))
                                         : undefined,

package/dist/cjs/api/calculated-column-fill.d.ts

@@ -0,0 +1,43 @@
+import type { CellInterface, GridRange } from "@rowsncolumns/grid";
+import type { CellData, TableView } from "../types";
+/** A body cell as it was before a calculated-column fill overwrote it (`null` = it was empty). */
+export type CalculatedColumnPreviousCell = {
+    rowIndex: number;
+    columnIndex: number;
+    cell: CellData | null;
+};
+/**
+ * `filled`: the formula typed into a table column filled the whole column (Excel's calculated
+ * column) — the smart tag offers "Undo Calculated Column". `overwrite`: the column held cells that
+ * differ from the typed formula, so nothing filled — the tag offers "Overwrite all cells in this
+ * column with this formula".
+ */
+export type CalculatedColumnFillKind = "filled" | "overwrite";
+/**
+ * A formula typed into a table body cell that created (or could create) a calculated column — the
+ * record behind Excel's AutoCorrect smart tag ("Undo Calculated Column" / "Overwrite all cells in
+ * this column with this formula" / "Stop automatically creating calculated columns").
+ */
+export type CalculatedColumnFill = {
+    sheetId: number;
+    tableId: TableView["id"];
+    /** Absolute sheet column of the calculated column. */
+    columnIndex: number;
+    /** The cell the formula was typed into — the smart tag anchors here. */
+    anchor: CellInterface;
+    /** The column's body range (header and totals rows excluded). */
+    range: GridRange;
+    /** The typed formula, as typed (relative to `anchor`). */
+    formula: string;
+    kind: CalculatedColumnFillKind;
+    /** The body cells the fill overwrote, with what they held before — "Undo Calculated Column" restores them. */
+    previous: CalculatedColumnPreviousCell[];
+};
+export type CalculatedColumnOption = "undo" | "overwrite" | "stop";
+/**
+ * Whether the smart tag stays for the current active cell: it survives the commit's own cursor
+ * advance (Enter moves down the column, Tab moves right) and any cell of the calculated column,
+ * and goes away when the user moves anywhere else or switches sheet.
+ */
+export declare const keepsCalculatedColumnTag: (fill: CalculatedColumnFill, sheetId: number, activeCell: CellInterface) => boolean;
+//# sourceMappingURL=calculated-column-fill.d.ts.map

package/dist/cjs/api/calculated-column-fill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"calculated-column-fill.d.ts","sourceRoot":"","sources":["../../../api/calculated-column-fill.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEnE,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAEpD,kGAAkG;AAClG,MAAM,MAAM,4BAA4B,GAAG;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,QAAQ,GAAG,IAAI,CAAC;CACvB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,wBAAwB,GAAG,QAAQ,GAAG,WAAW,CAAC;AAE9D;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;IACzB,sDAAsD;IACtD,WAAW,EAAE,MAAM,CAAC;IACpB,wEAAwE;IACxE,MAAM,EAAE,aAAa,CAAC;IACtB,iEAAiE;IACjE,KAAK,EAAE,SAAS,CAAC;IACjB,0DAA0D;IAC1D,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,wBAAwB,CAAC;IAC/B,8GAA8G;IAC9G,QAAQ,EAAE,4BAA4B,EAAE,CAAC;CAC1C,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;AAEnE;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,GACnC,MAAM,oBAAoB,EAC1B,SAAS,MAAM,EACf,YAAY,aAAa,KACxB,OAK6C,CAAC"}

package/dist/cjs/api/calculated-column-fill.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.keepsCalculatedColumnTag = void 0;
+/**
+ * Whether the smart tag stays for the current active cell: it survives the commit's own cursor
+ * advance (Enter moves down the column, Tab moves right) and any cell of the calculated column,
+ * and goes away when the user moves anywhere else or switches sheet.
+ */
+var keepsCalculatedColumnTag = function (fill, sheetId, activeCell) {
+    return sheetId === fill.sheetId &&
+        activeCell.rowIndex >= fill.range.startRowIndex &&
+        activeCell.rowIndex <= fill.range.endRowIndex + 1 &&
+        activeCell.columnIndex >= fill.columnIndex &&
+        activeCell.columnIndex <= fill.columnIndex + 1;
+};
+exports.keepsCalculatedColumnTag = keepsCalculatedColumnTag;

package/dist/cjs/api/chart-sheet.d.ts

@@ -0,0 +1,8 @@
+import type { Sheet } from "../types";
+/**
+ * The first unused `Chart${n}` sheet title, like Excel's default name for a
+ * chartsheet created by "Move Chart → New sheet". `formatTitle` lets hosts
+ * localize the pattern.
+ */
+export declare const getNextChartSheetTitle: (sheets: Pick<Sheet, "title">[], formatTitle?: (index: number) => string) => string;
+//# sourceMappingURL=chart-sheet.d.ts.map

package/dist/cjs/api/chart-sheet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart-sheet.d.ts","sourceRoot":"","sources":["../../../api/chart-sheet.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAEtC;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,GACjC,QAAQ,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,EAC9B,cAAa,CAAC,KAAK,EAAE,MAAM,KAAK,MAAmC,WAUpE,CAAC"}

package/dist/cjs/api/chart-sheet.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getNextChartSheetTitle = void 0;
+/**
+ * The first unused `Chart${n}` sheet title, like Excel's default name for a
+ * chartsheet created by "Move Chart → New sheet". `formatTitle` lets hosts
+ * localize the pattern.
+ */
+var getNextChartSheetTitle = function (sheets, formatTitle) {
+    if (formatTitle === void 0) { formatTitle = function (index) { return "Chart".concat(index); }; }
+    var existingTitles = new Set(sheets.map(function (sheet) { return sheet.title; }));
+    var index = 1;
+    var title = formatTitle(index);
+    while (existingTitles.has(title)) {
+        index++;
+        title = formatTitle(index);
+    }
+    return title;
+};
+exports.getNextChartSheetTitle = getNextChartSheetTitle;

package/dist/cjs/api/chart-source-ranges.d.ts

@@ -0,0 +1,64 @@
+import type { GridRange } from "@rowsncolumns/grid";
+import type { EmbeddedChart, SheetRange } from "../types";
+/**
+ * Border-style `type` of a selected chart's source-range outline. Not a
+ * user selection: it never moves the active cell, never shows a fill
+ * handle, and only exposes the corner resize handles when the entry is
+ * re-bindable.
+ */
+export declare const CHART_SOURCE_SELECTION_TYPE = "chartSource";
+/**
+ * Every `ChartData[]` field a spec can carry, in the order Excel colors
+ * them: categories, then values, then the extra bubble / hierarchy
+ * planes.
+ */
+export declare const CHART_SOURCE_FIELDS: readonly ["domains", "series", "bubbleLabels", "bubbleSizes", "labels", "parentLabels", "sizeData"];
+export type ChartSourceField = (typeof CHART_SOURCE_FIELDS)[number];
+export type ChartSourceRole = ChartSourceField | "seriesName";
+export type ChartSourceRangeEntry = {
+    /**
+     * Stable identity for the outline. Doubles as the border-style index and
+     * as the `data-index` of the outline's resize handles.
+     */
+    key: string;
+    role: ChartSourceRole;
+    field: ChartSourceField;
+    dataIndex: number;
+    /** Position in `ChartData.sources`; `-1` for a series-name reference. */
+    sourceIndex: number;
+    range: SheetRange;
+    /** Palette slot — the formula editor's per-reference color scheme. */
+    colorIndex: number;
+    /**
+     * Cell-range sources re-bind when a corner handle is dragged. A
+     * series-name reference is a single cell and only gets the outline.
+     */
+    resizable: boolean;
+};
+/**
+ * Lists every worksheet range a chart reads, in spec order, each with the
+ * palette slot the grid outlines it in. Spec-driven — both chart
+ * renderers read the same `EmbeddedChart.spec`, so the outline is the
+ * same for either.
+ *
+ * `sheetId` / `sheetName` identify the sheet being drawn; they are only
+ * needed to resolve series-name references, which the spec stores as
+ * addresses rather than `SheetRange`s.
+ */
+export declare const getChartSourceRanges: (chart: EmbeddedChart, sheetId: number, sheetName?: string) => ChartSourceRangeEntry[];
+export declare const getChartSourceRangeStroke: (entry: ChartSourceRangeEntry) => string;
+/**
+ * The single cell a data point reads from: the `dataIndex`-th cell along
+ * the range's long axis (a column range walks rows, a row range walks
+ * columns), clamped to the range so a point past the end still outlines
+ * the last cell. Excel narrows a series outline to this cell when one
+ * data point is selected.
+ */
+export declare const getChartSourcePointRange: (range: SheetRange, dataIndex: number) => SheetRange;
+/**
+ * The chart with one source re-bound to `range` (same sheet as before).
+ * Returns a new `EmbeddedChart`; `onUpdateChart` applies it as a single
+ * history entry on both engines.
+ */
+export declare const replaceChartSourceRange: (chart: EmbeddedChart, entry: ChartSourceRangeEntry, range: GridRange) => EmbeddedChart;
+//# sourceMappingURL=chart-source-ranges.d.ts.map

package/dist/cjs/api/chart-source-ranges.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart-source-ranges.d.ts","sourceRoot":"","sources":["../../../api/chart-source-ranges.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAGpD,OAAO,KAAK,EAAa,aAAa,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAGrE;;;;;GAKG;AACH,eAAO,MAAM,2BAA2B,gBAAgB,CAAC;AAIzD;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,qGAQtB,CAAC;AAEX,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEpE,MAAM,MAAM,eAAe,GAAG,gBAAgB,GAAG,YAAY,CAAC;AAc9D,MAAM,MAAM,qBAAqB,GAAG;IAClC;;;OAGG;IACH,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,eAAe,CAAC;IACtB,KAAK,EAAE,gBAAgB,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,yEAAyE;IACzE,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,UAAU,CAAC;IAClB,sEAAsE;IACtE,UAAU,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,SAAS,EAAE,OAAO,CAAC;CACpB,CAAC;AA+BF;;;;;;;;;GASG;AACH,eAAO,MAAM,oBAAoB,GAC/B,OAAO,aAAa,EACpB,SAAS,MAAM,EACf,YAAY,MAAM,KACjB,qBAAqB,EA+CvB,CAAC;AAEF,eAAO,MAAM,yBAAyB,GAAI,OAAO,qBAAqB,WAC1B,CAAC;AAE7C;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB,GACnC,OAAO,UAAU,EACjB,WAAW,MAAM,KAChB,UAsBF,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,GAClC,OAAO,aAAa,EACpB,OAAO,qBAAqB,EAC5B,OAAO,SAAS,KACf,aA8BF,CAAC"}

package/dist/cjs/api/chart-source-ranges.js

@@ -0,0 +1,175 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.replaceChartSourceRange = exports.getChartSourcePointRange = exports.getChartSourceRangeStroke = exports.getChartSourceRanges = exports.CHART_SOURCE_FIELDS = exports.CHART_SOURCE_SELECTION_TYPE = void 0;
+var tslib_1 = require("tslib");
+var utils_1 = require("@rowsncolumns/utils");
+var selections_1 = require("./selections");
+/**
+ * Border-style `type` of a selected chart's source-range outline. Not a
+ * user selection: it never moves the active cell, never shows a fill
+ * handle, and only exposes the corner resize handles when the entry is
+ * re-bindable.
+ */
+exports.CHART_SOURCE_SELECTION_TYPE = "chartSource";
+var CHART_SOURCE_INDEX_PREFIX = "chart-source:";
+/**
+ * Every `ChartData[]` field a spec can carry, in the order Excel colors
+ * them: categories, then values, then the extra bubble / hierarchy
+ * planes.
+ */
+exports.CHART_SOURCE_FIELDS = [
+    "domains",
+    "series",
+    "bubbleLabels",
+    "bubbleSizes",
+    "labels",
+    "parentLabels",
+    "sizeData",
+];
+/**
+ * Resolves a series-name reference (`Sheet1!$B$1`) to a range on the
+ * sheet being drawn. A reference without a sheet prefix belongs to the
+ * chart's own sheet; one that names another sheet is not drawn here.
+ */
+var resolveLabelRef = function (ref, chartSheetId, sheetId, sheetName) {
+    var _a = tslib_1.__read((0, selections_1.generateSelectionsFromFormula)(ref.startsWith("=") ? ref : "=".concat(ref)), 1), selection = _a[0];
+    if (!selection) {
+        return undefined;
+    }
+    var refSheetName = selection.sheetName;
+    if (refSheetName === undefined) {
+        return chartSheetId === sheetId
+            ? tslib_1.__assign(tslib_1.__assign({}, selection.range), { sheetId: sheetId }) : undefined;
+    }
+    if (sheetName !== undefined && refSheetName === sheetName) {
+        return tslib_1.__assign(tslib_1.__assign({}, selection.range), { sheetId: sheetId });
+    }
+    return undefined;
+};
+/**
+ * Lists every worksheet range a chart reads, in spec order, each with the
+ * palette slot the grid outlines it in. Spec-driven — both chart
+ * renderers read the same `EmbeddedChart.spec`, so the outline is the
+ * same for either.
+ *
+ * `sheetId` / `sheetName` identify the sheet being drawn; they are only
+ * needed to resolve series-name references, which the spec stores as
+ * addresses rather than `SheetRange`s.
+ */
+var getChartSourceRanges = function (chart, sheetId, sheetName) {
+    var e_1, _a;
+    var entries = [];
+    var spec = chart.spec;
+    var chartSheetId = chart.position.sheetId;
+    var push = function (entry) {
+        entries.push(tslib_1.__assign(tslib_1.__assign({}, entry), { key: "".concat(CHART_SOURCE_INDEX_PREFIX).concat(entry.field, ":").concat(entry.dataIndex, ":").concat(entry.sourceIndex), colorIndex: entries.length }));
+    };
+    var _loop_1 = function (field) {
+        var chartDataArray = spec[field];
+        if (!chartDataArray)
+            return "continue";
+        chartDataArray.forEach(function (chartData, dataIndex) {
+            var _a;
+            if (!chartData)
+                return;
+            (_a = chartData.sources) === null || _a === void 0 ? void 0 : _a.forEach(function (source, sourceIndex) {
+                if (!source)
+                    return;
+                push({
+                    role: field,
+                    field: field,
+                    dataIndex: dataIndex,
+                    sourceIndex: sourceIndex,
+                    range: source,
+                    resizable: true,
+                });
+            });
+            if (field !== "series")
+                return;
+            var labelRef = chartData.dataLabelRef;
+            if (!labelRef)
+                return;
+            var range = resolveLabelRef(labelRef, chartSheetId, sheetId, sheetName);
+            if (!range)
+                return;
+            push({
+                role: "seriesName",
+                field: field,
+                dataIndex: dataIndex,
+                sourceIndex: -1,
+                range: range,
+                resizable: false,
+            });
+        });
+    };
+    try {
+        for (var CHART_SOURCE_FIELDS_1 = tslib_1.__values(exports.CHART_SOURCE_FIELDS), CHART_SOURCE_FIELDS_1_1 = CHART_SOURCE_FIELDS_1.next(); !CHART_SOURCE_FIELDS_1_1.done; CHART_SOURCE_FIELDS_1_1 = CHART_SOURCE_FIELDS_1.next()) {
+            var field = CHART_SOURCE_FIELDS_1_1.value;
+            _loop_1(field);
+        }
+    }
+    catch (e_1_1) { e_1 = { error: e_1_1 }; }
+    finally {
+        try {
+            if (CHART_SOURCE_FIELDS_1_1 && !CHART_SOURCE_FIELDS_1_1.done && (_a = CHART_SOURCE_FIELDS_1.return)) _a.call(CHART_SOURCE_FIELDS_1);
+        }
+        finally { if (e_1) throw e_1.error; }
+    }
+    return entries;
+};
+exports.getChartSourceRanges = getChartSourceRanges;
+var getChartSourceRangeStroke = function (entry) {
+    return (0, utils_1.getSelectionColorAtIndex)(entry.colorIndex);
+};
+exports.getChartSourceRangeStroke = getChartSourceRangeStroke;
+/**
+ * The single cell a data point reads from: the `dataIndex`-th cell along
+ * the range's long axis (a column range walks rows, a row range walks
+ * columns), clamped to the range so a point past the end still outlines
+ * the last cell. Excel narrows a series outline to this cell when one
+ * data point is selected.
+ */
+var getChartSourcePointRange = function (range, dataIndex) {
+    var rows = range.endRowIndex - range.startRowIndex;
+    var columns = range.endColumnIndex - range.startColumnIndex;
+    var offset = Math.max(0, Math.floor(dataIndex));
+    if (rows >= columns) {
+        var rowIndex = range.startRowIndex + Math.min(offset, rows);
+        return tslib_1.__assign(tslib_1.__assign({}, range), { startRowIndex: rowIndex, endRowIndex: rowIndex, startColumnIndex: range.startColumnIndex, endColumnIndex: range.startColumnIndex });
+    }
+    var columnIndex = range.startColumnIndex + Math.min(offset, columns);
+    return tslib_1.__assign(tslib_1.__assign({}, range), { startRowIndex: range.startRowIndex, endRowIndex: range.startRowIndex, startColumnIndex: columnIndex, endColumnIndex: columnIndex });
+};
+exports.getChartSourcePointRange = getChartSourcePointRange;
+/**
+ * The chart with one source re-bound to `range` (same sheet as before).
+ * Returns a new `EmbeddedChart`; `onUpdateChart` applies it as a single
+ * history entry on both engines.
+ */
+var replaceChartSourceRange = function (chart, entry, range) {
+    var _a;
+    var spec = chart.spec;
+    var chartDataArray = spec[entry.field];
+    if (!chartDataArray || entry.sourceIndex < 0) {
+        return chart;
+    }
+    var chartData = chartDataArray[entry.dataIndex];
+    if (!chartData) {
+        return chart;
+    }
+    var nextSource = {
+        startRowIndex: range.startRowIndex,
+        endRowIndex: range.endRowIndex,
+        startColumnIndex: range.startColumnIndex,
+        endColumnIndex: range.endColumnIndex,
+        sheetId: entry.range.sheetId,
+    };
+    var sources = chartData.sources.map(function (source, index) {
+        return index === entry.sourceIndex ? nextSource : source;
+    });
+    var nextChartDataArray = chartDataArray.map(function (data, index) {
+        return index === entry.dataIndex ? tslib_1.__assign(tslib_1.__assign({}, data), { sources: sources }) : data;
+    });
+    return tslib_1.__assign(tslib_1.__assign({}, chart), { spec: tslib_1.__assign(tslib_1.__assign({}, chart.spec), (_a = {}, _a[entry.field] = nextChartDataArray, _a)) });
+};
+exports.replaceChartSourceRange = replaceChartSourceRange;

package/dist/cjs/api/selections.d.ts

@@ -8,7 +8,7 @@ import type { SheetRange, TableView } from "../types";
  * @param isActiveCell
  * @param isSelection
  */
-export declare const getSelectionStrokeStyle: (formulaMode: boolean, isFill: boolean, isActiveCell: boolean, emptySelections: boolean) => "dashed" | "solid";
+export declare const getSelectionStrokeStyle: (formulaMode: boolean, isFill: boolean, isActiveCell: boolean, emptySelections: boolean) => "solid" | "dashed";
 /**
  * Get selection stroke width
  * @param formulaMode
@@ -16,14 +16,14 @@ export declare const getSelectionStrokeStyle: (formulaMode: boolean, isFill: boo
  * @param isActiveCell
  * @returns
  */
-export declare const getSelectionStrokeWidth: (formulaMode: boolean, isFill: boolean, isActiveCell: boolean, isResizingTable: boolean) => 2 | 1;
+export declare const getSelectionStrokeWidth: (formulaMode: boolean, isFill: boolean, isActiveCell: boolean, isResizingTable: boolean) => 1 | 2;
 /**
  * Get background opacity of selection
  * @param formulaMode
  * @param isFill
  * @returns
  */
-export declare const getSelectionFillOpacity: (formulaMode: boolean, isFill: boolean) => 1 | 0 | 0.2;
+export declare const getSelectionFillOpacity: (formulaMode: boolean, isFill: boolean) => 0 | 1 | 0.2;
 /**
  * Get background color of selection
  * @param formulaMode

package/dist/cjs/api/selections.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"selections.d.ts","sourceRoot":"","sources":["../../../api/selections.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"selections.d.ts","sourceRoot":"","sources":["../../../api/selections.ts"],"names":[],"mappings":"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"}

package/dist/cjs/api/selections.js

@@ -262,6 +262,10 @@ var selectionToTableAddress = function (selection, table, editingCell) {
     var isHeader = headerRow &&
         startRowIndex === tableStartRowIndex &&
         endRowIndex === tableStartRowIndex;
+    // Only the totals row
+    var isTotals = totalRow &&
+        startRowIndex === tableEndRowIndex &&
+        endRowIndex === tableEndRowIndex;
     // Full table
     var isAll = tableStartRowIndex === startRowIndex &&
         tableEndRowIndex === endRowIndex &&
@@ -282,6 +286,18 @@ var selectionToTableAddress = function (selection, table, editingCell) {
         : firstColumn === lastColumn
             ? firstColumn // Full column rnge
             : "[".concat(firstColumn, "]:[").concat(lastColumn, "]");
+    // The column part of a two-part specifier: every column is bracketed there
+    // (`Table[[#Headers],[Col]]`, `Table[[#All],[A]:[B]]`), unlike the lone `Table[Col]`.
+    var columnItem = isFullRowRange
+        ? ""
+        : firstColumn === lastColumn
+            ? "[".concat(firstColumn, "]")
+            : range;
+    var withItem = function (item) {
+        return columnItem
+            ? "".concat(title, "[[").concat(item, "],").concat(columnItem, "]")
+            : "".concat(title, "[").concat(item, "]");
+    };
     var isEditingCellInsideTable = editingCell
         ? (0, grid_1.isCellWithinBounds)(editingCell, table.range)
         : false;
@@ -296,10 +312,13 @@ var selectionToTableAddress = function (selection, table, editingCell) {
         return "".concat(tableName, "[").concat(range, "]");
     }
     if (isFullColumnRange) {
-        return "".concat(tableName, "[[#All],[").concat(range, "]]");
+        return withItem("#All");
     }
     if (isHeader) {
-        return "".concat(tableName, "[[#Headers]").concat(range ? "," + range : "", "]");
+        return withItem("#Headers");
+    }
+    if (isTotals) {
+        return withItem("#Totals");
     }
     return "".concat(isEditingCellInsideTable ? "" : tableName, "[@").concat(range, "]");
 };
@@ -326,6 +345,13 @@ var getTableFromSelection = function (tables, editingCell, selection, sheetName,
     }
     var headerRow = (_a = table === null || table === void 0 ? void 0 : table.headerRow) !== null && _a !== void 0 ? _a : true;
     var totalRow = (_b = table === null || table === void 0 ? void 0 : table.totalRow) !== null && _b !== void 0 ? _b : false;
+    // A click on the totals row is `Table[[#Totals],[Col]]` from anywhere, like the header row.
+    var isTableTotals = totalRow &&
+        (table === null || table === void 0 ? void 0 : table.range.endRowIndex) === selection.range.startRowIndex &&
+        (table === null || table === void 0 ? void 0 : table.range.endRowIndex) === selection.range.endRowIndex;
+    if (isTableTotals) {
+        return table;
+    }
     var tableDataStartRowIndex = ((_c = table === null || table === void 0 ? void 0 : table.range.startRowIndex) !== null && _c !== void 0 ? _c : 0) + (headerRow ? 1 : 0);
     var tableDataEndRowIndex = ((_d = table === null || table === void 0 ? void 0 : table.range.endRowIndex) !== null && _d !== void 0 ? _d : 0) - (totalRow ? 1 : 0);
     // Full column rnge

package/dist/cjs/api/spreadsheet-api.d.ts

@@ -8,7 +8,7 @@ import type { CanvasGridMethods, CanvasGridProps, ChangeBatchOptions, ChangeBatc
 import type { SelectionAttributes as SheetSelectionAttributes } from "../components/canvas-grid/typings";
 import type { BorderLocation } from "../components/toolbar";
 import type { ExportRangeOptions } from "../hooks/use-export-range";
-import type { AXIS, AutoFillType, BandedRange, CellData, CellFormat, ConditionalFormatRule, DataValidationRuleRecord, EmbeddedChart, EmbeddedObject, FillOptions, NamedRange, Sheet as SheetBase, SheetRange, SortOrder, TableTheme, TableView } from "../types";
+import type { AutoFillType, AXIS, BandedRange, CellData, CellFormat, ConditionalFormatRule, CreateTableOptions, DataValidationRuleRecord, EmbeddedChart, EmbeddedObject, FillOptions, NamedRange, Sheet as SheetBase, SheetRange, SortOrder, TableTheme, TableView } from "../types";
 type CallbacksProps<T extends CellData> = RefObject<CanvasGridProps<T> | null>;
 declare class SpreadsheetCallbacks<T extends CellData> {
     callbacks: CallbacksProps<T>;
@@ -20,6 +20,11 @@ type SpreadsheetMethods = {
     commit(): boolean;
     /** Open Excel's Series dialog (Home > Fill > Series…) for the current selection. */
     openFillSeriesDialog(): void;
+    /** Chart clipboard — Ctrl+C / Ctrl+X / Ctrl+V / Ctrl+D on a chart (see `useChartClipboard`). */
+    copyChart(chartId: string | number): boolean;
+    cutChart(chartId: string | number): boolean;
+    pasteChart(): boolean;
+    duplicateChart(chartId: string | number): EmbeddedChart | undefined;
 };
 export declare class SpreadsheetApi<T extends CellData = CellData> extends SpreadsheetCallbacks<T> {
     store: ReturnType<typeof getDefaultStore>;
@@ -174,6 +179,14 @@ export declare class SpreadsheetApi<T extends CellData = CellData> extends Sprea
     isChartsAvailable(): boolean;
     createChart(sheetId: number, activeCell: CellInterface, selections: SelectionArea<SheetSelectionAttributes>[], chartSpec?: EmbeddedChart): void;
     deleteChart(chartId: string | number): void;
+    /** Put the chart on the clipboard (Excel Ctrl+C on a selected chart). */
+    copyChart(chartId: string | number): boolean;
+    /** Copy the chart and remove it (Excel Ctrl+X on a selected chart). */
+    cutChart(chartId: string | number): boolean;
+    /** Paste the copied chart at the active cell of the active sheet; false when none is copied. */
+    pasteChart(): boolean;
+    /** Create a copy of the chart offset from the original (Excel Ctrl+D). */
+    duplicateChart(chartId: string | number): EmbeddedChart | undefined;
     moveChart(chartId: string | number, anchorCell: CellInterface, offsetXPixels: number, offsetYPixels: number): void;
     resizeChart(chartId: string | number, anchorCell: CellInterface, offsetXPixels: number, offsetYPixels: number, width: number, height: number): void;
     updateChart(chart: EmbeddedChart): void;
@@ -196,7 +209,7 @@ export declare class SpreadsheetApi<T extends CellData = CellData> extends Sprea
     copy(e: ClipboardEvent | undefined, sheetId: number, copiedSelections: SelectionArea<SheetSelectionAttributes>[]): void;
     cut(e: ClipboardEvent | undefined, sheetId: number): void;
     paste(e: ClipboardEvent | undefined, sourceSheetId: number | undefined, destinationSheetId: number, copiedSelections: SelectionArea<SheetSelectionAttributes>[] | undefined, activeCell: CellInterface, selections: SelectionArea<SheetSelectionAttributes>[] | undefined, finalSelections: SelectionArea<SheetSelectionAttributes>[] | undefined, shouldDeleteSource: boolean): void;
-    createTable(sheetId: number, activeCell: CellInterface, selections: SelectionArea<SheetSelectionAttributes>[], tableSpec?: Partial<TableView>, theme?: TableTheme, bandedRange?: BandedRange): void;
+    createTable(sheetId: number, activeCell: CellInterface, selections: SelectionArea<SheetSelectionAttributes>[], tableSpec?: Partial<TableView>, theme?: TableTheme, bandedRange?: BandedRange, options?: CreateTableOptions): void;
     createBasicFilter(sheetId: number, activeCell: CellInterface, selections: SelectionArea<SheetSelectionAttributes>[], basicFilterSpec?: any): void;
     protectRange(sheetId: number, cell: CellInterface, selections: SelectionArea<SheetSelectionAttributes>[] | undefined): void;
     unprotectRange(sheetId: number, protectedRangeId: number | string): void;
@@ -262,7 +275,7 @@ declare class CellRange<T extends CellData> extends SpreadsheetCallbacks<T> {
      * Get effective value of a cell
      * @returns
      */
-    getEffectiveValue(): (string | number | boolean | Date | null | undefined)[][] | import("../types").Maybe<string | number | boolean | Date>;
+    getEffectiveValue(): import("../types").Maybe<string | number | boolean | Date> | (string | number | boolean | Date | null | undefined)[][];
     setValues(values: string[][]): this;
     clearFormatting(): this;
     setFormat<T extends FormattingType>(type: T, value: FormattingValue<T>): this;