@rowsncolumns/spreadsheet 10.3.0 → 10.4.0

package/dist/cjs/utils/copy-as-picture.js

@@ -0,0 +1,70 @@
+"use strict";
+/**
+ * Excel's "Copy as Picture" for a chart: put the renderer's PNG on the
+ * system clipboard. The capture is asynchronous, but browsers only allow
+ * a clipboard write inside the user gesture that requested it — so the
+ * pending capture is handed to `ClipboardItem` as a promise (the shape
+ * Safari requires and Chromium ≥ 98 / Firefox ≥ 127 accept); an engine
+ * that rejects promise values gets the resolved blob written while the
+ * gesture's transient activation still lasts.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.copyPngToClipboard = exports.canCopyImageToClipboard = void 0;
+var tslib_1 = require("tslib");
+var canCopyImageToClipboard = function () {
+    var _a;
+    return typeof ClipboardItem !== "undefined" &&
+        typeof navigator !== "undefined" &&
+        typeof ((_a = navigator.clipboard) === null || _a === void 0 ? void 0 : _a.write) === "function";
+};
+exports.canCopyImageToClipboard = canCopyImageToClipboard;
+/** Resolves `true` when the PNG reached the clipboard. */
+var copyPngToClipboard = function (png) { return tslib_1.__awaiter(void 0, void 0, void 0, function () {
+    var blob, _a, captured, _b;
+    return tslib_1.__generator(this, function (_c) {
+        switch (_c.label) {
+            case 0:
+                if (!(0, exports.canCopyImageToClipboard)())
+                    return [2 /*return*/, false];
+                blob = png.then(function (captured) {
+                    if (!captured)
+                        throw new Error("Chart image could not be captured");
+                    return captured;
+                });
+                // The engine consumes the rejection through the ClipboardItem; keep it
+                // from surfacing as an unhandled rejection as well.
+                blob.catch(function () { return undefined; });
+                _c.label = 1;
+            case 1:
+                _c.trys.push([1, 3, , 9]);
+                return [4 /*yield*/, navigator.clipboard.write([
+                        new ClipboardItem({ "image/png": blob }),
+                    ])];
+            case 2:
+                _c.sent();
+                return [2 /*return*/, true];
+            case 3:
+                _a = _c.sent();
+                return [4 /*yield*/, blob.catch(function () { return undefined; })];
+            case 4:
+                captured = _c.sent();
+                if (!captured)
+                    return [2 /*return*/, false];
+                _c.label = 5;
+            case 5:
+                _c.trys.push([5, 7, , 8]);
+                return [4 /*yield*/, navigator.clipboard.write([
+                        new ClipboardItem({ "image/png": captured }),
+                    ])];
+            case 6:
+                _c.sent();
+                return [2 /*return*/, true];
+            case 7:
+                _b = _c.sent();
+                return [2 /*return*/, false];
+            case 8: return [3 /*break*/, 9];
+            case 9: return [2 /*return*/];
+        }
+    });
+}); };
+exports.copyPngToClipboard = copyPngToClipboard;

package/dist/cjs/utils/pivot-chart-field-buttons.d.ts

@@ -0,0 +1,19 @@
+import type { ChartSpec, PivotChartFieldButtons } from "../types";
+/** The four button kinds Excel draws on a PivotChart frame. */
+export type PivotChartFieldButtonKind = Exclude<keyof PivotChartFieldButtons, "visible">;
+type FieldButtonSpec = Pick<ChartSpec, "pivotTableId" | "pivotFieldButtons">;
+/**
+ * Whether a PivotChart shows its field buttons at all — Excel's "Hide All
+ * Field Buttons" flips this. A chart that is not bound to a pivot never
+ * shows any.
+ */
+export declare const pivotChartFieldButtonsVisible: (spec: FieldButtonSpec) => boolean;
+/** Whether one kind of field button shows (every kind defaults to shown). */
+export declare const isPivotChartFieldButtonShown: (spec: FieldButtonSpec, kind: PivotChartFieldButtonKind) => boolean;
+/**
+ * The spec change behind Show / Hide All Field Buttons: only `visible`
+ * flips, the per-kind choices survive so re-showing restores them.
+ */
+export declare const togglePivotChartFieldButtons: (spec: FieldButtonSpec) => Pick<ChartSpec, "pivotFieldButtons">;
+export {};
+//# sourceMappingURL=pivot-chart-field-buttons.d.ts.map

package/dist/cjs/utils/pivot-chart-field-buttons.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pivot-chart-field-buttons.d.ts","sourceRoot":"","sources":["../../../utils/pivot-chart-field-buttons.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAElE,+DAA+D;AAC/D,MAAM,MAAM,yBAAyB,GAAG,OAAO,CAC7C,MAAM,sBAAsB,EAC5B,SAAS,CACV,CAAC;AAEF,KAAK,eAAe,GAAG,IAAI,CAAC,SAAS,EAAE,cAAc,GAAG,mBAAmB,CAAC,CAAC;AAE7E;;;;GAIG;AACH,eAAO,MAAM,6BAA6B,GAAI,MAAM,eAAe,KAAG,OACE,CAAC;AAEzE,6EAA6E;AAC7E,eAAO,MAAM,4BAA4B,GACvC,MAAM,eAAe,EACrB,MAAM,yBAAyB,KAC9B,OAC8E,CAAC;AAElF;;;GAGG;AACH,eAAO,MAAM,4BAA4B,GACvC,MAAM,eAAe,KACpB,IAAI,CAAC,SAAS,EAAE,mBAAmB,CAKpC,CAAC"}

package/dist/cjs/utils/pivot-chart-field-buttons.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.togglePivotChartFieldButtons = exports.isPivotChartFieldButtonShown = exports.pivotChartFieldButtonsVisible = void 0;
+var tslib_1 = require("tslib");
+/**
+ * Whether a PivotChart shows its field buttons at all — Excel's "Hide All
+ * Field Buttons" flips this. A chart that is not bound to a pivot never
+ * shows any.
+ */
+var pivotChartFieldButtonsVisible = function (spec) { var _a; return spec.pivotTableId != null && ((_a = spec.pivotFieldButtons) === null || _a === void 0 ? void 0 : _a.visible) !== false; };
+exports.pivotChartFieldButtonsVisible = pivotChartFieldButtonsVisible;
+/** Whether one kind of field button shows (every kind defaults to shown). */
+var isPivotChartFieldButtonShown = function (spec, kind) { var _a; return (0, exports.pivotChartFieldButtonsVisible)(spec) && ((_a = spec.pivotFieldButtons) === null || _a === void 0 ? void 0 : _a[kind]) !== false; };
+exports.isPivotChartFieldButtonShown = isPivotChartFieldButtonShown;
+/**
+ * The spec change behind Show / Hide All Field Buttons: only `visible`
+ * flips, the per-kind choices survive so re-showing restores them.
+ */
+var togglePivotChartFieldButtons = function (spec) {
+    var _a;
+    return ({
+        pivotFieldButtons: tslib_1.__assign(tslib_1.__assign({}, ((_a = spec.pivotFieldButtons) !== null && _a !== void 0 ? _a : {})), { visible: !(0, exports.pivotChartFieldButtonsVisible)(spec) }),
+    });
+};
+exports.togglePivotChartFieldButtons = togglePivotChartFieldButtons;

package/dist/cjs/utils/z-order.d.ts

@@ -0,0 +1,47 @@
+import type { EmbeddedChart, EmbeddedObject } from "../types";
+/**
+ * Excel's Arrange menu for floating objects. Charts and embedded objects
+ * (pictures, shapes, text boxes) live in two host arrays but share one
+ * stacking order per sheet; `position.zOrder` carries it and, when absent,
+ * creation order applies — charts below embeds, each in array order (the
+ * paint order before z-order existed).
+ */
+export type ZOrderDirection = "bringForward" | "sendBackward" | "bringToFront" | "sendToBack";
+export type ZOrderTarget = {
+    kind: "chart";
+    id: EmbeddedChart["chartId"];
+} | {
+    kind: "embed";
+    id: EmbeddedObject["embedId"];
+};
+/** One object with its new `position.zOrder` already applied — what the host persists. */
+export type ZOrderChange = {
+    kind: "chart";
+    chart: EmbeddedChart;
+} | {
+    kind: "embed";
+    embed: EmbeddedObject;
+};
+export type StackedObject = ZOrderTarget & {
+    /** Effective stacking value (explicit `zOrder`, else the creation-order default). */
+    zOrder: number;
+};
+/**
+ * The sheet's floating objects back-to-front. Explicit `zOrder` wins; an
+ * object without one sits at its creation-order slot (charts first, then
+ * embeds, both in array order), so a document authored before z-order
+ * keeps painting exactly as it did. Ties keep that same default order.
+ */
+export declare const getStackingOrder: (charts: readonly EmbeddedChart[] | null | undefined, embeds: readonly EmbeddedObject[] | null | undefined, sheetId: number) => StackedObject[];
+/** Stacking rank (1 = back-most) per object key — what the grid paints as `z-index`. */
+export declare const getStackingRanks: (charts: readonly EmbeddedChart[] | null | undefined, embeds: readonly EmbeddedObject[] | null | undefined, sheetId: number) => Map<string, number>;
+export declare const stackingKey: (target: ZOrderTarget) => string;
+/**
+ * The objects to rewrite for one Arrange command, with their new `zOrder`:
+ * Bring Forward / Send Backward swap the target with its neighbour (two
+ * objects), Bring to Front / Send to Back put it past the current extreme
+ * (one object). `undefined` when the command is a no-op — the target is
+ * already at that end, or is not on the sheet.
+ */
+export declare const planZOrderChange: (charts: readonly EmbeddedChart[] | null | undefined, embeds: readonly EmbeddedObject[] | null | undefined, sheetId: number, target: ZOrderTarget, direction: ZOrderDirection) => ZOrderChange[] | undefined;
+//# sourceMappingURL=z-order.d.ts.map

package/dist/cjs/utils/z-order.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"z-order.d.ts","sourceRoot":"","sources":["../../../utils/z-order.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE9D;;;;;;GAMG;AAEH,MAAM,MAAM,eAAe,GACvB,cAAc,GACd,cAAc,GACd,cAAc,GACd,YAAY,CAAC;AAEjB,MAAM,MAAM,YAAY,GACpB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,EAAE,EAAE,aAAa,CAAC,SAAS,CAAC,CAAA;CAAE,GAC/C;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,EAAE,EAAE,cAAc,CAAC,SAAS,CAAC,CAAA;CAAE,CAAC;AAErD,0FAA0F;AAC1F,MAAM,MAAM,YAAY,GACpB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,aAAa,CAAA;CAAE,GACvC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,cAAc,CAAA;CAAE,CAAC;AAE7C,MAAM,MAAM,aAAa,GAAG,YAAY,GAAG;IACzC,qFAAqF;IACrF,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAIF;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,GAC3B,QAAQ,SAAS,aAAa,EAAE,GAAG,IAAI,GAAG,SAAS,EACnD,QAAQ,SAAS,cAAc,EAAE,GAAG,IAAI,GAAG,SAAS,EACpD,SAAS,MAAM,KACd,aAAa,EAuBf,CAAC;AAEF,wFAAwF;AACxF,eAAO,MAAM,gBAAgB,GAC3B,QAAQ,SAAS,aAAa,EAAE,GAAG,IAAI,GAAG,SAAS,EACnD,QAAQ,SAAS,cAAc,EAAE,GAAG,IAAI,GAAG,SAAS,EACpD,SAAS,MAAM,KACd,GAAG,CAAC,MAAM,EAAE,MAAM,CAMpB,CAAC;AAEF,eAAO,MAAM,WAAW,WAlDH,YAAY,WAkDH,CAAC;AAoB/B;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,GAC3B,QAAQ,SAAS,aAAa,EAAE,GAAG,IAAI,GAAG,SAAS,EACnD,QAAQ,SAAS,cAAc,EAAE,GAAG,IAAI,GAAG,SAAS,EACpD,SAAS,MAAM,EACf,QAAQ,YAAY,EACpB,WAAW,eAAe,KACzB,YAAY,EAAE,GAAG,SA4CnB,CAAC"}

package/dist/cjs/utils/z-order.js

@@ -0,0 +1,124 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.planZOrderChange = exports.stackingKey = exports.getStackingRanks = exports.getStackingOrder = void 0;
+var tslib_1 = require("tslib");
+var key = function (target) { return "".concat(target.kind, ":").concat(String(target.id)); };
+/**
+ * The sheet's floating objects back-to-front. Explicit `zOrder` wins; an
+ * object without one sits at its creation-order slot (charts first, then
+ * embeds, both in array order), so a document authored before z-order
+ * keeps painting exactly as it did. Ties keep that same default order.
+ */
+var getStackingOrder = function (charts, embeds, sheetId) {
+    var _a;
+    var chartCount = (_a = charts === null || charts === void 0 ? void 0 : charts.length) !== null && _a !== void 0 ? _a : 0;
+    var entries = [];
+    charts === null || charts === void 0 ? void 0 : charts.forEach(function (chart, index) {
+        var _a, _b;
+        if (((_a = chart.position) === null || _a === void 0 ? void 0 : _a.sheetId) !== sheetId)
+            return;
+        entries.push({
+            kind: "chart",
+            id: chart.chartId,
+            zOrder: (_b = chart.position.zOrder) !== null && _b !== void 0 ? _b : index,
+            slot: index,
+        });
+    });
+    embeds === null || embeds === void 0 ? void 0 : embeds.forEach(function (embed, index) {
+        var _a, _b;
+        if (((_a = embed.position) === null || _a === void 0 ? void 0 : _a.sheetId) !== sheetId)
+            return;
+        entries.push({
+            kind: "embed",
+            id: embed.embedId,
+            zOrder: (_b = embed.position.zOrder) !== null && _b !== void 0 ? _b : chartCount + index,
+            slot: chartCount + index,
+        });
+    });
+    entries.sort(function (a, b) { return a.zOrder - b.zOrder || a.slot - b.slot; });
+    return entries.map(function (_a) {
+        var _slot = _a.slot, entry = tslib_1.__rest(_a, ["slot"]);
+        return entry;
+    });
+};
+exports.getStackingOrder = getStackingOrder;
+/** Stacking rank (1 = back-most) per object key — what the grid paints as `z-index`. */
+var getStackingRanks = function (charts, embeds, sheetId) {
+    var ranks = new Map();
+    (0, exports.getStackingOrder)(charts, embeds, sheetId).forEach(function (entry, index) {
+        ranks.set(key(entry), index + 1);
+    });
+    return ranks;
+};
+exports.getStackingRanks = getStackingRanks;
+exports.stackingKey = key;
+var withZOrder = function (charts, embeds, target, zOrder) {
+    if (target.kind === "chart") {
+        var chart = charts === null || charts === void 0 ? void 0 : charts.find(function (c) { return c.chartId === target.id; });
+        return chart
+            ? { kind: "chart", chart: tslib_1.__assign(tslib_1.__assign({}, chart), { position: tslib_1.__assign(tslib_1.__assign({}, chart.position), { zOrder: zOrder }) }) }
+            : undefined;
+    }
+    var embed = embeds === null || embeds === void 0 ? void 0 : embeds.find(function (e) { return e.embedId === target.id; });
+    return embed
+        ? { kind: "embed", embed: tslib_1.__assign(tslib_1.__assign({}, embed), { position: tslib_1.__assign(tslib_1.__assign({}, embed.position), { zOrder: zOrder }) }) }
+        : undefined;
+};
+/**
+ * The objects to rewrite for one Arrange command, with their new `zOrder`:
+ * Bring Forward / Send Backward swap the target with its neighbour (two
+ * objects), Bring to Front / Send to Back put it past the current extreme
+ * (one object). `undefined` when the command is a no-op — the target is
+ * already at that end, or is not on the sheet.
+ */
+var planZOrderChange = function (charts, embeds, sheetId, target, direction) {
+    var order = (0, exports.getStackingOrder)(charts, embeds, sheetId);
+    var index = order.findIndex(function (entry) { return key(entry) === key(target); });
+    if (index === -1 || order.length < 2)
+        return undefined;
+    var current = order[index];
+    var changes = [];
+    switch (direction) {
+        case "bringToFront": {
+            if (index === order.length - 1)
+                return undefined;
+            changes.push(withZOrder(charts, embeds, target, order[order.length - 1].zOrder + 1));
+            break;
+        }
+        case "sendToBack": {
+            if (index === 0)
+                return undefined;
+            changes.push(withZOrder(charts, embeds, target, order[0].zOrder - 1));
+            break;
+        }
+        case "bringForward": {
+            if (index === order.length - 1)
+                return undefined;
+            var above = order[index + 1];
+            if (above.zOrder === current.zOrder) {
+                changes.push(withZOrder(charts, embeds, target, above.zOrder + 1));
+            }
+            else {
+                changes.push(withZOrder(charts, embeds, target, above.zOrder));
+                changes.push(withZOrder(charts, embeds, above, current.zOrder));
+            }
+            break;
+        }
+        case "sendBackward": {
+            if (index === 0)
+                return undefined;
+            var below = order[index - 1];
+            if (below.zOrder === current.zOrder) {
+                changes.push(withZOrder(charts, embeds, target, below.zOrder - 1));
+            }
+            else {
+                changes.push(withZOrder(charts, embeds, target, below.zOrder));
+                changes.push(withZOrder(charts, embeds, below, current.zOrder));
+            }
+            break;
+        }
+    }
+    var resolved = changes.filter(function (c) { return !!c; });
+    return resolved.length ? resolved : undefined;
+};
+exports.planZOrderChange = planZOrderChange;

package/dist/esm/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/esm/api/banded-ranges.js

@@ -9,13 +9,13 @@ import { getStringifiedColor } from "../themes";
  */
 export const getBandedCells = (bandedRanges, theme, sheetId, isHiddenRow, isHiddenColumn) => {
     const bandedCells = new Map();
-    for (const { range, rowProperties, columnProperties } of bandedRanges) {
+    for (const { range, rowProperties, columnProperties, showFirstColumn, showLastColumn, totalRow, } of bandedRanges) {
         // Only pick current sheet
         if (range.sheetId !== sheetId) {
             continue;
         }
         if (rowProperties || columnProperties) {
-            const { headerColor, firstBandColor, secondBandColor, footerColor, headerBorder, firstBandBorder, footerBorder, } = rowProperties ?? {};
+            const { headerColor, firstBandColor, secondBandColor, footerColor, headerBorder, firstBandBorder, footerBorder, firstColumnColor, lastColumnColor, totalRowColor, totalRowBorder, totalRowBold, } = rowProperties ?? {};
             const { firstBandColor: firstBandColorColumn, secondBandColor: secondBandColorColumn, } = columnProperties ?? {};
             const parsedFirstBandColor = parseTintedColor(firstBandColor);
             const parsedSecondBandColor = parseTintedColor(secondBandColor);
@@ -55,29 +55,56 @@ export const getBandedCells = (bandedRanges, theme, sheetId, isHiddenRow, isHidd
                     // Body cells
                     else {
                         const 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.
+                        const isTotalsRow = isFooter && !!totalRow;
                         const stripeRowBackground = isOddRow
                             ? parsedFirstBandColor
                             : parsedSecondBandColor;
-                        const 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.
+                        const footerBackground = isFooter && totalRow !== false
                             ? footerColor ?? stripeRowBackground
                             : stripeRowBackground;
+                        const backgroundColor = isTotalsRow
+                            ? totalRowColor ?? footerBackground
+                            : isFooter
+                                ? footerBackground
+                                : stripeRowBackground;
                         // Border
-                        const borders = isFooter
-                            ? footerBorder ?? firstBandBorder
-                            : firstBandBorder;
+                        const borders = isTotalsRow
+                            ? totalRowBorder ?? footerBorder ?? firstBandBorder
+                            : isFooter
+                                ? footerBorder ?? firstBandBorder
+                                : firstBandBorder;
                         const isEvenColumn = columnRunningIndex % 2 === 0;
                         const finalBackgroundColor = (isEvenColumn
                             ? parsedFirstBandColorColumn
                             : parsedSecondBandColorColumn) ?? backgroundColor;
-                        const textColor = isFooter
-                            ? footerColor ?? stripeRowBackground
-                            : parsedFirstBandColor ??
-                                parsedSecondBandColor ??
-                                finalBackgroundColor;
+                        // 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.
+                        const edgeColumnColor = showFirstColumn && columnIndex === range.startColumnIndex
+                            ? parseTintedColor(firstColumnColor)
+                            : showLastColumn && columnIndex === range.endColumnIndex
+                                ? parseTintedColor(lastColumnColor)
+                                : undefined;
+                        const isEdgeColumn = (showFirstColumn && columnIndex === range.startColumnIndex) ||
+                            (showLastColumn && columnIndex === range.endColumnIndex);
+                        const cellBackgroundColor = edgeColumnColor ?? finalBackgroundColor;
+                        const textColor = edgeColumnColor ??
+                            (isTotalsRow
+                                ? totalRowColor ?? footerBackground
+                                : isFooter
+                                    ? footerBackground
+                                    : parsedFirstBandColor ??
+                                        parsedSecondBandColor ??
+                                        finalBackgroundColor);
                         bandedCells.set(id, {
                             borders,
-                            backgroundColor: finalBackgroundColor,
+                            backgroundColor: cellBackgroundColor,
                             textFormat: {
+                                bold: isEdgeColumn || (isTotalsRow && totalRowBold) ? true : undefined,
                                 color: textColor
                                     ? getContrastColor(getStringifiedColor(textColor, theme), getStringifiedColor({ theme: 1 }, theme), getStringifiedColor({ theme: 0 }, theme))
                                     : undefined,

package/dist/esm/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/esm/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/esm/api/calculated-column-fill.js

@@ -0,0 +1,10 @@
+/**
+ * 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 const keepsCalculatedColumnTag = (fill, sheetId, activeCell) => sheetId === fill.sheetId &&
+    activeCell.rowIndex >= fill.range.startRowIndex &&
+    activeCell.rowIndex <= fill.range.endRowIndex + 1 &&
+    activeCell.columnIndex >= fill.columnIndex &&
+    activeCell.columnIndex <= fill.columnIndex + 1;

package/dist/esm/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/esm/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/esm/api/chart-sheet.js

@@ -0,0 +1,15 @@
+/**
+ * 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 const getNextChartSheetTitle = (sheets, formatTitle = (index) => `Chart${index}`) => {
+    const existingTitles = new Set(sheets.map((sheet) => sheet.title));
+    let index = 1;
+    let title = formatTitle(index);
+    while (existingTitles.has(title)) {
+        index++;
+        title = formatTitle(index);
+    }
+    return title;
+};

package/dist/esm/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/esm/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"}