@rowsncolumns/spreadsheet 10.3.1 → 10.4.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"calculated-column-fill.atom.d.ts","sourceRoot":"","sources":["../../../atoms/calculated-column-fill.atom.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAE1E;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB;;CAA0C,CAAC;AAEhF,eAAO,MAAM,4BAA4B,2JAA0C,CAAC;AACpF,eAAO,MAAM,4BAA4B,mCAA+C,CAAC;AACzF,eAAO,MAAM,0BAA0B,4HAA6C,CAAC"}

package/dist/cjs/atoms/calculated-column-fill.atom.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useSetCalculatedColumnFill = exports.useCalculatedColumnFillValue = exports.useCalculatedColumnFillState = exports.calculatedColumnFillAtom = void 0;
+var jotai_1 = require("jotai");
+/**
+ * The calculated column a typed formula just created (or could create), waiting for Excel's
+ * AutoCorrect smart tag ("Undo Calculated Column" / "Overwrite all cells in this column with this
+ * formula" / "Stop automatically creating calculated columns"). Set by the engines' calculated-column
+ * path (`useOnChangeCalculatedColumn` in `@rowsncolumns/spreadsheet-state`; the rnc engine's commit
+ * fold), read by `CanvasGrid`. Dropped when the user moves away from the column or switches sheet.
+ */
+exports.calculatedColumnFillAtom = (0, jotai_1.atom)(null);
+var useCalculatedColumnFillState = function () { return (0, jotai_1.useAtom)(exports.calculatedColumnFillAtom); };
+exports.useCalculatedColumnFillState = useCalculatedColumnFillState;
+var useCalculatedColumnFillValue = function () { return (0, jotai_1.useAtomValue)(exports.calculatedColumnFillAtom); };
+exports.useCalculatedColumnFillValue = useCalculatedColumnFillValue;
+var useSetCalculatedColumnFill = function () { return (0, jotai_1.useSetAtom)(exports.calculatedColumnFillAtom); };
+exports.useSetCalculatedColumnFill = useSetCalculatedColumnFill;

package/dist/cjs/atoms/chart-actions.atom.d.ts

@@ -0,0 +1,40 @@
+import type { EmbeddedChart } from "../types";
+/**
+ * Actions only the chart renderer can perform (they need the live chart
+ * instance or the host's editor). A renderer registers them per chart so
+ * the grid's right-click menu can offer them without knowing the renderer.
+ */
+export type EmbeddedChartActions = {
+    /** Open the host's chart editor for this chart. */
+    requestEdit?(): void;
+    /** Rasterise the chart as it is drawn and download it as a PNG. */
+    downloadPng?(): void;
+    /**
+     * Rasterise the chart as it is drawn to a PNG blob — Copy as Picture and
+     * the print preview draw from it. Resolves `undefined` when the renderer
+     * has no live instance to capture.
+     */
+    exportPng?(): Promise<Blob | undefined>;
+    /**
+     * Excel's "Switch Row/Column": re-derive the series the other way
+     * through the data range and persist the chart. Absent when the chart's
+     * sources cannot be transposed or the host gave the renderer no update
+     * callback.
+     */
+    switchRowColumn?(): void;
+};
+export declare const chartActionsAtom: import("jotai").PrimitiveAtom<Record<string, EmbeddedChartActions | undefined>> & {
+    init: Record<string, EmbeddedChartActions | undefined>;
+};
+/**
+ * Register the renderer-side actions of a chart for the lifetime of the
+ * component. Callers pass fresh closures every render; the registered
+ * entry only changes when an action appears or disappears.
+ */
+export declare const useRegisterChartActions: (chartId: EmbeddedChart["chartId"], actions: EmbeddedChartActions) => void;
+/**
+ * Non-subscribing reader: the grid looks actions up when a menu opens, so
+ * registrations never re-render the grid.
+ */
+export declare const useGetChartActions: () => (chartId: EmbeddedChart["chartId"]) => EmbeddedChartActions | undefined;
+//# sourceMappingURL=chart-actions.atom.d.ts.map

package/dist/cjs/atoms/chart-actions.atom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart-actions.atom.d.ts","sourceRoot":"","sources":["../../../atoms/chart-actions.atom.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE9C;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,mDAAmD;IACnD,WAAW,CAAC,IAAI,IAAI,CAAC;IACrB,mEAAmE;IACnE,WAAW,CAAC,IAAI,IAAI,CAAC;IACrB;;;;OAIG;IACH,SAAS,CAAC,IAAI,OAAO,CAAC,IAAI,GAAG,SAAS,CAAC,CAAC;IACxC;;;;;OAKG;IACH,eAAe,CAAC,IAAI,IAAI,CAAC;CAC1B,CAAC;AAEF,eAAO,MAAM,gBAAgB;;CAExB,CAAC;AAEN;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,GAClC,SAAS,aAAa,CAAC,SAAS,CAAC,EACjC,SAAS,oBAAoB,SA4C9B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,kBAAkB,kBAGjB,aAAa,CAAC,SAAS,CAAC,KAAG,oBAAoB,GAAG,SAI/D,CAAC"}

package/dist/cjs/atoms/chart-actions.atom.js

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useGetChartActions = exports.useRegisterChartActions = exports.chartActionsAtom = void 0;
+var tslib_1 = require("tslib");
+var jotai_1 = require("jotai");
+var react_1 = require("react");
+exports.chartActionsAtom = (0, jotai_1.atom)({});
+/**
+ * Register the renderer-side actions of a chart for the lifetime of the
+ * component. Callers pass fresh closures every render; the registered
+ * entry only changes when an action appears or disappears.
+ */
+var useRegisterChartActions = function (chartId, actions) {
+    var setChartActions = (0, jotai_1.useSetAtom)(exports.chartActionsAtom);
+    var actionsRef = (0, react_1.useRef)(actions);
+    actionsRef.current = actions;
+    var hasRequestEdit = !!actions.requestEdit;
+    var hasDownloadPng = !!actions.downloadPng;
+    var hasExportPng = !!actions.exportPng;
+    var hasSwitchRowColumn = !!actions.switchRowColumn;
+    (0, react_1.useEffect)(function () {
+        var key = String(chartId);
+        setChartActions(function (prev) {
+            var _a;
+            return (tslib_1.__assign(tslib_1.__assign({}, prev), (_a = {}, _a[key] = {
+                requestEdit: hasRequestEdit
+                    ? function () { var _a, _b; return (_b = (_a = actionsRef.current).requestEdit) === null || _b === void 0 ? void 0 : _b.call(_a); }
+                    : undefined,
+                downloadPng: hasDownloadPng
+                    ? function () { var _a, _b; return (_b = (_a = actionsRef.current).downloadPng) === null || _b === void 0 ? void 0 : _b.call(_a); }
+                    : undefined,
+                exportPng: hasExportPng
+                    ? function () { var _a, _b, _c; return (_c = (_b = (_a = actionsRef.current).exportPng) === null || _b === void 0 ? void 0 : _b.call(_a)) !== null && _c !== void 0 ? _c : Promise.resolve(undefined); }
+                    : undefined,
+                switchRowColumn: hasSwitchRowColumn
+                    ? function () { var _a, _b; return (_b = (_a = actionsRef.current).switchRowColumn) === null || _b === void 0 ? void 0 : _b.call(_a); }
+                    : undefined,
+            }, _a)));
+        });
+        return function () {
+            setChartActions(function (prev) {
+                var _a = prev, _b = key, _removed = _a[_b], rest = tslib_1.__rest(_a, [typeof _b === "symbol" ? _b : _b + ""]);
+                return rest;
+            });
+        };
+    }, [
+        chartId,
+        hasRequestEdit,
+        hasDownloadPng,
+        hasExportPng,
+        hasSwitchRowColumn,
+        setChartActions,
+    ]);
+};
+exports.useRegisterChartActions = useRegisterChartActions;
+/**
+ * Non-subscribing reader: the grid looks actions up when a menu opens, so
+ * registrations never re-render the grid.
+ */
+var useGetChartActions = function () {
+    var store = (0, jotai_1.useStore)();
+    return (0, react_1.useCallback)(function (chartId) {
+        return store.get(exports.chartActionsAtom)[String(chartId)];
+    }, [store]);
+};
+exports.useGetChartActions = useGetChartActions;

package/dist/cjs/atoms/index.d.ts

@@ -10,6 +10,7 @@ export * from "./sheet-status-display.atom";
 export * from "./spreadsheet-api.atom";
 export { useLoadingIndicator } from "./loading-indicator.atom";
 export * from "./selected-chart-embed.atom";
+export * from "./selected-chart-series.atom";
 export * from "./popover.atom";
 export * from "./paste-menu.atom";
 export * from "./fill-options.atom";
@@ -25,4 +26,8 @@ export * from "./remove-duplicates-dialog.atom";
 export * from "./watch-window.atom";
 export * from "./insert-cells-dialog.atom";
 export * from "./insert-options.atom";
+export * from "./chart-actions.atom";
+export * from "./table-auto-expansion.atom";
+export * from "./calculated-column-fill.atom";
+export * from "./sparkline-dialog.atom";
 //# sourceMappingURL=index.d.ts.map

package/dist/cjs/atoms/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../atoms/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iCAAiC,CAAC;AAChD,cAAc,qBAAqB,CAAC;AACpC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,sBAAsB,CAAC;AACrC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,wBAAwB,CAAC;AACvC,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,cAAc,6BAA6B,CAAC;AAC5C,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,qBAAqB,CAAC;AACpC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,iCAAiC,CAAC;AAChD,cAAc,qBAAqB,CAAC;AACpC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../atoms/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iCAAiC,CAAC;AAChD,cAAc,qBAAqB,CAAC;AACpC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,sBAAsB,CAAC;AACrC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,wBAAwB,CAAC;AACvC,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,cAAc,6BAA6B,CAAC;AAC5C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,qBAAqB,CAAC;AACpC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,iCAAiC,CAAC;AAChD,cAAc,qBAAqB,CAAC;AACpC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,yBAAyB,CAAC"}

package/dist/cjs/atoms/index.js

@@ -15,6 +15,7 @@ tslib_1.__exportStar(require("./spreadsheet-api.atom"), exports);
 var loading_indicator_atom_1 = require("./loading-indicator.atom");
 Object.defineProperty(exports, "useLoadingIndicator", { enumerable: true, get: function () { return loading_indicator_atom_1.useLoadingIndicator; } });
 tslib_1.__exportStar(require("./selected-chart-embed.atom"), exports);
+tslib_1.__exportStar(require("./selected-chart-series.atom"), exports);
 tslib_1.__exportStar(require("./popover.atom"), exports);
 tslib_1.__exportStar(require("./paste-menu.atom"), exports);
 tslib_1.__exportStar(require("./fill-options.atom"), exports);
@@ -30,3 +31,7 @@ tslib_1.__exportStar(require("./remove-duplicates-dialog.atom"), exports);
 tslib_1.__exportStar(require("./watch-window.atom"), exports);
 tslib_1.__exportStar(require("./insert-cells-dialog.atom"), exports);
 tslib_1.__exportStar(require("./insert-options.atom"), exports);
+tslib_1.__exportStar(require("./chart-actions.atom"), exports);
+tslib_1.__exportStar(require("./table-auto-expansion.atom"), exports);
+tslib_1.__exportStar(require("./calculated-column-fill.atom"), exports);
+tslib_1.__exportStar(require("./sparkline-dialog.atom"), exports);

package/dist/cjs/atoms/move-chart-dialog.atom.d.ts

@@ -0,0 +1,28 @@
+import type { EmbeddedChart } from "../types";
+/**
+ * Open-state + payload for Excel's "Move Chart…" dialog (chart context menu /
+ * chart editor). The grid opens it with the chart; the host-mounted dialog
+ * routes the chosen target through the host's `onMoveChartToSheet`.
+ */
+export type MoveChartDialogRequest = {
+    chart: EmbeddedChart;
+};
+export declare const moveChartDialogAtom: import("jotai").PrimitiveAtom<MoveChartDialogRequest | null> & {
+    init: MoveChartDialogRequest | null;
+};
+export declare const useMoveChartDialogState: () => [MoveChartDialogRequest | null, (args_0: MoveChartDialogRequest | ((prev: MoveChartDialogRequest | null) => MoveChartDialogRequest | null) | null) => void];
+/**
+ * Number of mounted `MoveChartDialogHost`s. The chart context menu only
+ * offers "Move chart…" while a host is mounted, so a host that has not
+ * adopted the dialog never gets a dead item.
+ */
+export declare const moveChartDialogHostCountAtom: import("jotai").PrimitiveAtom<number> & {
+    init: number;
+};
+/** True when at least one `MoveChartDialogHost` is mounted. */
+export declare const useIsMoveChartDialogMounted: () => boolean;
+/** Registers the calling component as a dialog host for its lifetime. */
+export declare const useRegisterMoveChartDialogHost: () => void;
+/** Returns a function that opens the host-mounted "Move Chart…" dialog. */
+export declare const useOpenMoveChartDialog: () => (request: MoveChartDialogRequest) => void;
+//# sourceMappingURL=move-chart-dialog.atom.d.ts.map

package/dist/cjs/atoms/move-chart-dialog.atom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"move-chart-dialog.atom.d.ts","sourceRoot":"","sources":["../../../atoms/move-chart-dialog.atom.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE9C;;;;GAIG;AACH,MAAM,MAAM,sBAAsB,GAAG;IAAE,KAAK,EAAE,aAAa,CAAA;CAAE,CAAC;AAE9D,eAAO,MAAM,mBAAmB;;CAA4C,CAAC;AAE7E,eAAO,MAAM,uBAAuB,mKAAqC,CAAC;AAE1E;;;;GAIG;AACH,eAAO,MAAM,4BAA4B;;CAAU,CAAC;AAEpD,+DAA+D;AAC/D,eAAO,MAAM,2BAA2B,eACQ,CAAC;AAEjD,yEAAyE;AACzE,eAAO,MAAM,8BAA8B,YAM1C,CAAC;AAEF,2EAA2E;AAC3E,eAAO,MAAM,sBAAsB,kBAGrB,sBAAsB,SAGnC,CAAC"}

package/dist/cjs/atoms/move-chart-dialog.atom.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useOpenMoveChartDialog = exports.useRegisterMoveChartDialogHost = exports.useIsMoveChartDialogMounted = exports.moveChartDialogHostCountAtom = exports.useMoveChartDialogState = exports.moveChartDialogAtom = void 0;
+var jotai_1 = require("jotai");
+var react_1 = require("react");
+exports.moveChartDialogAtom = (0, jotai_1.atom)(null);
+var useMoveChartDialogState = function () { return (0, jotai_1.useAtom)(exports.moveChartDialogAtom); };
+exports.useMoveChartDialogState = useMoveChartDialogState;
+/**
+ * Number of mounted `MoveChartDialogHost`s. The chart context menu only
+ * offers "Move chart…" while a host is mounted, so a host that has not
+ * adopted the dialog never gets a dead item.
+ */
+exports.moveChartDialogHostCountAtom = (0, jotai_1.atom)(0);
+/** True when at least one `MoveChartDialogHost` is mounted. */
+var useIsMoveChartDialogMounted = function () {
+    return (0, jotai_1.useAtomValue)(exports.moveChartDialogHostCountAtom) > 0;
+};
+exports.useIsMoveChartDialogMounted = useIsMoveChartDialogMounted;
+/** Registers the calling component as a dialog host for its lifetime. */
+var useRegisterMoveChartDialogHost = function () {
+    var setCount = (0, jotai_1.useSetAtom)(exports.moveChartDialogHostCountAtom);
+    (0, react_1.useEffect)(function () {
+        setCount(function (count) { return count + 1; });
+        return function () { return setCount(function (count) { return count - 1; }); };
+    }, [setCount]);
+};
+exports.useRegisterMoveChartDialogHost = useRegisterMoveChartDialogHost;
+/** Returns a function that opens the host-mounted "Move Chart…" dialog. */
+var useOpenMoveChartDialog = function () {
+    var setRequest = (0, jotai_1.useSetAtom)(exports.moveChartDialogAtom);
+    return (0, react_1.useCallback)(function (request) { return setRequest(request); }, [setRequest]);
+};
+exports.useOpenMoveChartDialog = useOpenMoveChartDialog;

package/dist/cjs/atoms/selected-chart-embed.atom.d.ts

@@ -1,6 +1,14 @@
+import type { SetStateAction } from "react";
+import type { EmbeddedObject } from "../types";
 export declare const selectedChartEmbedAtom: import("jotai").PrimitiveAtom<string | number | undefined> & {
     init: string | number | undefined;
 };
 export declare const useSelectedChartEmbed: () => [string | number | undefined, (args_0: string | number | ((prev: string | number | undefined) => string | number | undefined) | undefined) => void];
-export declare const useFocusEmbedOrChart: () => (args_0: string | number | ((prev: string | number | undefined) => string | number | undefined) | undefined) => void;
+/**
+ * Select a chart / picture the way Excel does after inserting or restoring one: the object is
+ * selected and scrolled into view (`CanvasGridMethods.scrollToChart`, once the grid renders it).
+ * A functional update only re-derives the selection (an undo step deselecting a removed object)
+ * and clearing it never scrolls.
+ */
+export declare const useFocusEmbedOrChart: () => (update: SetStateAction<EmbeddedObject["embedId"] | undefined>) => void;
 //# sourceMappingURL=selected-chart-embed.atom.d.ts.map

package/dist/cjs/atoms/selected-chart-embed.atom.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"selected-chart-embed.atom.d.ts","sourceRoot":"","sources":["../../../atoms/selected-chart-embed.atom.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,sBAAsB;;CAEvB,CAAC;AAEb,eAAO,MAAM,qBAAqB,2JAAwC,CAAC;AAE3E,eAAO,MAAM,oBAAoB,4HAA2C,CAAC"}
+{"version":3,"file":"selected-chart-embed.atom.d.ts","sourceRoot":"","sources":["../../../atoms/selected-chart-embed.atom.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAG5C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAG/C,eAAO,MAAM,sBAAsB;;CAEvB,CAAC;AAEb,eAAO,MAAM,qBAAqB,2JAAwC,CAAC;AAE3E;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,iBAIpB,cAAc,CAAC,cAAc,CAAC,SAAS,CAAC,GAAG,SAAS,CAAC,SAQjE,CAAC"}

package/dist/cjs/atoms/selected-chart-embed.atom.js

@@ -2,8 +2,25 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.useFocusEmbedOrChart = exports.useSelectedChartEmbed = exports.selectedChartEmbedAtom = void 0;
 var jotai_1 = require("jotai");
+var react_1 = require("react");
+var sheet_context_atom_1 = require("./sheet-context.atom");
 exports.selectedChartEmbedAtom = (0, jotai_1.atom)(undefined);
 var useSelectedChartEmbed = function () { return (0, jotai_1.useAtom)(exports.selectedChartEmbedAtom); };
 exports.useSelectedChartEmbed = useSelectedChartEmbed;
-var useFocusEmbedOrChart = function () { return (0, jotai_1.useSetAtom)(exports.selectedChartEmbedAtom); };
+/**
+ * Select a chart / picture the way Excel does after inserting or restoring one: the object is
+ * selected and scrolled into view (`CanvasGridMethods.scrollToChart`, once the grid renders it).
+ * A functional update only re-derives the selection (an undo step deselecting a removed object)
+ * and clearing it never scrolls.
+ */
+var useFocusEmbedOrChart = function () {
+    var setSelected = (0, jotai_1.useSetAtom)(exports.selectedChartEmbedAtom);
+    var scrollToChart = (0, jotai_1.useAtomValue)(sheet_context_atom_1.scrollToChartSelector);
+    return (0, react_1.useCallback)(function (update) {
+        setSelected(update);
+        if (typeof update !== "function" && update !== undefined) {
+            scrollToChart === null || scrollToChart === void 0 ? void 0 : scrollToChart(update);
+        }
+    }, [setSelected, scrollToChart]);
+};
 exports.useFocusEmbedOrChart = useFocusEmbedOrChart;

package/dist/cjs/atoms/selected-chart-series.atom.d.ts

@@ -0,0 +1,24 @@
+import type { EmbeddedChart } from "../types";
+/**
+ * The data series a user clicked inside a chart, like Excel's series
+ * selection: the grid narrows the chart's source-range outlines to that
+ * series (plus the categories). Cleared by clicking empty chart area or
+ * pressing Escape; ignored once another chart is selected.
+ */
+export type SelectedChartSeries = {
+    chartId: EmbeddedChart["chartId"];
+    /** Index into `spec.series`. */
+    seriesIndex: number;
+    /**
+     * Position of the clicked data point along the series (a category
+     * index). Excel narrows the outline further to that point's value and
+     * category cells; absent when the whole series is selected.
+     */
+    dataIndex?: number;
+};
+export declare const selectedChartSeriesAtom: import("jotai").PrimitiveAtom<SelectedChartSeries | undefined> & {
+    init: SelectedChartSeries | undefined;
+};
+export declare const useSelectedChartSeries: () => [SelectedChartSeries | undefined, (args_0: SelectedChartSeries | ((prev: SelectedChartSeries | undefined) => SelectedChartSeries | undefined) | undefined) => void];
+export declare const useSetSelectedChartSeries: () => (args_0: SelectedChartSeries | ((prev: SelectedChartSeries | undefined) => SelectedChartSeries | undefined) | undefined) => void;
+//# sourceMappingURL=selected-chart-series.atom.d.ts.map

package/dist/cjs/atoms/selected-chart-series.atom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selected-chart-series.atom.d.ts","sourceRoot":"","sources":["../../../atoms/selected-chart-series.atom.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE9C;;;;;GAKG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,OAAO,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;IAClC,gCAAgC;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,eAAO,MAAM,uBAAuB;;CAEnC,CAAC;AAEF,eAAO,MAAM,sBAAsB,2KAAyC,CAAC;AAE7E,eAAO,MAAM,yBAAyB,wIACD,CAAC"}

package/dist/cjs/atoms/selected-chart-series.atom.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useSetSelectedChartSeries = exports.useSelectedChartSeries = exports.selectedChartSeriesAtom = void 0;
+var jotai_1 = require("jotai");
+exports.selectedChartSeriesAtom = (0, jotai_1.atom)(undefined);
+var useSelectedChartSeries = function () { return (0, jotai_1.useAtom)(exports.selectedChartSeriesAtom); };
+exports.useSelectedChartSeries = useSelectedChartSeries;
+var useSetSelectedChartSeries = function () {
+    return (0, jotai_1.useSetAtom)(exports.selectedChartSeriesAtom);
+};
+exports.useSetSelectedChartSeries = useSetSelectedChartSeries;

package/dist/cjs/atoms/sheet-context.atom.d.ts

@@ -55,6 +55,8 @@ export declare const getShowCellPopoverSelector: import("jotai").Atom<((popoverR
 export declare const useShowCellPopover: () => ((popoverRange: import("@rowsncolumns/common-types").SheetRange | import("@rowsncolumns/common-types").SheetCoordinate, content: import("..").Maybe<React.ReactNode | React.ComponentType>) => void) | undefined;
 export declare const scrollToCellSelector: import("jotai").Atom<((cell: import("@rowsncolumns/grid").OptionalCellInterface, align?: import("@rowsncolumns/grid").Align) => void) | undefined>;
 export declare const useScrollToCell: () => ((cell: import("@rowsncolumns/grid").OptionalCellInterface, align?: import("@rowsncolumns/grid").Align) => void) | undefined;
+export declare const scrollToChartSelector: import("jotai").Atom<((id: import("..").EmbeddedObject["embedId"]) => void) | undefined>;
+export declare const useScrollToChart: () => ((id: import("..").EmbeddedObject["embedId"]) => void) | undefined;
 export declare const redrawGridSelector: import("jotai").Atom<(() => void) | undefined>;
 export declare const useRedrawGrid: () => (() => void) | undefined;
 export declare const getViewPortSelector: import("jotai").Atom<(() => import("@rowsncolumns/grid").ViewPortProps) | undefined>;

package/dist/cjs/atoms/sheet-context.atom.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sheet-context.atom.d.ts","sourceRoot":"","sources":["../../../atoms/sheet-context.atom.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAE3E,eAAO,MAAM,sBAAsB;;CAEjC,CAAC;AAEH,eAAO,MAAM,cAAc,yBAA6C,CAAC;AAGzE,eAAO,MAAM,iBAAiB,mEAE7B,CAAC;AAEF,eAAO,MAAM,YAAY,mDAAwC,CAAC;AAQlE,eAAO,MAAM,kBAAkB,mDAA8C,CAAC;AAO9E,eAAO,MAAM,gBAAgB,mDAA4C,CAAC;AAE1E,eAAO,MAAM,wBAAwB,8FACD,CAAC;AAOrC,eAAO,MAAM,gBAAgB,sJAA4C,CAAC;AAO1E,eAAO,MAAM,2BAA2B,+MACK,CAAC;AAO9C,eAAO,MAAM,0BAA0B,uQACM,CAAC;AAO9C,eAAO,MAAM,8BAA8B,+GACM,CAAC;AAMlD,eAAO,MAAM,oBAAoB;;;cACQ,CAAC;AAM1C,eAAO,MAAM,eAAe,+GAA2C,CAAC;AAMxE,eAAO,MAAM,iBAAiB;;;;yBAA6C,CAAC;AAM5E,eAAO,MAAM,+BAA+B,wIACY,CAAC;AAMzD,eAAO,MAAM,0BAA0B,8HACQ,CAAC;AAMhD,eAAO,MAAM,0BAA0B,iIACQ,CAAC;AAEhD,eAAO,MAAM,wCAAwC,oPAEpD,CAAC;AAEF,eAAO,MAAM,mCAAmC,oOACQ,CAAC;AAEzD,eAAO,MAAM,mBAAmB,oHAE/B,CAAC;AAEF,eAAO,MAAM,cAAc,oGAA0C,CAAC;AAEtE,eAAO,MAAM,wBAAwB,kEAEpC,CAAC;AAEF,eAAO,MAAM,mBAAmB,kDAA+C,CAAC;AAEhF,eAAO,MAAM,2BAA2B,mDAEvC,CAAC;AAEF,eAAO,MAAM,sBAAsB,mCACQ,CAAC;AAE5C,eAAO,MAAM,0BAA0B,0GAEtC,CAAC;AAEF,eAAO,MAAM,qBAAqB,0FACQ,CAAC;AAE3C,eAAO,MAAM,mCAAmC,gHAE/C,CAAC;AAEF,eAAO,MAAM,8BAA8B,gGACQ,CAAC;AAEpD,eAAO,MAAM,kBAAkB,4OAE9B,CAAC;AAEF,eAAO,MAAM,aAAa,4NAAyC,CAAC;AAEpE,eAAO,MAAM,kBAAkB,gDAE9B,CAAC;AAEF,eAAO,MAAM,aAAa,gCAAyC,CAAC;AAEpE,eAAO,MAAM,0BAA0B,oFAEtC,CAAC;AAEF,eAAO,MAAM,qBAAqB,oEACQ,CAAC;AAE3C,eAAO,MAAM,yBAAyB,oMAErC,CAAC;AAEF,eAAO,MAAM,oBAAoB,oLACQ,CAAC;AAE1C,eAAO,MAAM,uBAAuB,sFAEnC,CAAC;AAEF,eAAO,MAAM,kBAAkB,sEAA8C,CAAC;AAE9E,eAAO,MAAM,oBAAoB,iEAEhC,CAAC;AAEF,eAAO,MAAM,eAAe,iDAA2C,CAAC;AAExE,eAAO,MAAM,kBAAkB,+EAE9B,CAAC;AAEF,eAAO,MAAM,aAAa,+DAAyC,CAAC;AAEpE,eAAO,MAAM,0BAA0B,wOAEtC,CAAC;AAEF,eAAO,MAAM,kBAAkB,wNACW,CAAC;AAE3C,eAAO,MAAM,oBAAoB,oJAEhC,CAAC;AAEF,eAAO,MAAM,eAAe,oIAA2C,CAAC;AAExE,eAAO,MAAM,kBAAkB,gDAE9B,CAAC;AAEF,eAAO,MAAM,aAAa,gCAAyC,CAAC;AAEpE,eAAO,MAAM,mBAAmB,sFAE/B,CAAC;AAEF,eAAO,MAAM,cAAc,sEAA0C,CAAC;AAEtE,eAAO,MAAM,sBAAsB,+FAElC,CAAC;AAEF,eAAO,MAAM,iBAAiB,+EAA6C,CAAC;AAE5E,eAAO,MAAM,kBAAkB,uFAE9B,CAAC;AACF,eAAO,MAAM,aAAa,uEAAyC,CAAC;AAEpE,eAAO,MAAM,4BAA4B,kLAExC,CAAC;AACF,eAAO,MAAM,uBAAuB,kKACQ,CAAC"}
+{"version":3,"file":"sheet-context.atom.d.ts","sourceRoot":"","sources":["../../../atoms/sheet-context.atom.ts"],"names":[],"mappings":"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"}

package/dist/cjs/atoms/sheet-context.atom.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getViewPortSelector = exports.useRedrawGrid = exports.redrawGridSelector = exports.useScrollToCell = exports.scrollToCellSelector = exports.useShowCellPopover = exports.getShowCellPopoverSelector = exports.useGetSheetId = exports.getSheetIdSelector = exports.useGetSheetName = exports.getSheetNameSelector = exports.useOnEditorKeyDown = exports.onEditorKeyDownSelector = exports.useGetFinalRowHeight = exports.getFinalRowHeightSelector = exports.useGetSheetDimensions = exports.getSheetDimensionsSelector = exports.useFocusSheet = exports.focusSheetSelector = exports.useInsertNote = exports.insertNoteSelector = exports.useGetEffectiveValuesFromRange = exports.getEffectiveValuesFromRangeSelector = exports.useGetSheetProtection = exports.getSheetProtectionSelector = exports.useIsWorkbookProtected = exports.isWorkbookProtectedSelector = exports.useIsSheetProtected = exports.isSheetProtectedSelector = exports.useCanEditCell = exports.canEditCellSelector = exports.useUpdateSelectionStartEndReference = exports.updateSelectionStartEndReferenceSelector = exports.useGetCellOffsetFromCoords = exports.useGetCellCoordsFromOffset = exports.useGetContentfulRangeAroundCell = exports.useGetColumnWidth = exports.useGetRowHeight = exports.useGetCellDimensions = exports.useGetR1C1AddressFromSelection = exports.useGetAddressFromSelection = exports.useGetSelectionsFromFormula = exports.useGetCellBounds = exports.useSetSpreadsheetContext = exports.useFormulaLocale = exports.useLocaleTokenizer = exports.useTokenizer = exports.tokenizerSelector = exports.useSpreadsheet = exports.spreadsheetContextAtom = void 0;
-exports.useNavigateToSheetRange = exports.navigateToSheetRangeSelector = exports.useGetGridRef = exports.getGridRefSelector = exports.useGetNamedRanges = exports.getNamedRangesSelector = exports.useGetViewPort = void 0;
+exports.redrawGridSelector = exports.useScrollToChart = exports.scrollToChartSelector = exports.useScrollToCell = exports.scrollToCellSelector = exports.useShowCellPopover = exports.getShowCellPopoverSelector = exports.useGetSheetId = exports.getSheetIdSelector = exports.useGetSheetName = exports.getSheetNameSelector = exports.useOnEditorKeyDown = exports.onEditorKeyDownSelector = exports.useGetFinalRowHeight = exports.getFinalRowHeightSelector = exports.useGetSheetDimensions = exports.getSheetDimensionsSelector = exports.useFocusSheet = exports.focusSheetSelector = exports.useInsertNote = exports.insertNoteSelector = exports.useGetEffectiveValuesFromRange = exports.getEffectiveValuesFromRangeSelector = exports.useGetSheetProtection = exports.getSheetProtectionSelector = exports.useIsWorkbookProtected = exports.isWorkbookProtectedSelector = exports.useIsSheetProtected = exports.isSheetProtectedSelector = exports.useCanEditCell = exports.canEditCellSelector = exports.useUpdateSelectionStartEndReference = exports.updateSelectionStartEndReferenceSelector = exports.useGetCellOffsetFromCoords = exports.useGetCellCoordsFromOffset = exports.useGetContentfulRangeAroundCell = exports.useGetColumnWidth = exports.useGetRowHeight = exports.useGetCellDimensions = exports.useGetR1C1AddressFromSelection = exports.useGetAddressFromSelection = exports.useGetSelectionsFromFormula = exports.useGetCellBounds = exports.useSetSpreadsheetContext = exports.useFormulaLocale = exports.useLocaleTokenizer = exports.useTokenizer = exports.tokenizerSelector = exports.useSpreadsheet = exports.spreadsheetContextAtom = void 0;
+exports.useNavigateToSheetRange = exports.navigateToSheetRangeSelector = exports.useGetGridRef = exports.getGridRefSelector = exports.useGetNamedRanges = exports.getNamedRangesSelector = exports.useGetViewPort = exports.getViewPortSelector = exports.useRedrawGrid = void 0;
 var utils_1 = require("@rowsncolumns/utils");
 var jotai_1 = require("jotai");
 exports.spreadsheetContextAtom = (0, jotai_1.atom)({
@@ -136,6 +136,9 @@ exports.useShowCellPopover = useShowCellPopover;
 exports.scrollToCellSelector = (0, jotai_1.atom)(function (get) { return get(exports.spreadsheetContextAtom).scrollToCell; });
 var useScrollToCell = function () { return (0, jotai_1.useAtomValue)(exports.scrollToCellSelector); };
 exports.useScrollToCell = useScrollToCell;
+exports.scrollToChartSelector = (0, jotai_1.atom)(function (get) { return get(exports.spreadsheetContextAtom).scrollToChart; });
+var useScrollToChart = function () { return (0, jotai_1.useAtomValue)(exports.scrollToChartSelector); };
+exports.useScrollToChart = useScrollToChart;
 exports.redrawGridSelector = (0, jotai_1.atom)(function (get) { return get(exports.spreadsheetContextAtom).redrawGrid; });
 var useRedrawGrid = function () { return (0, jotai_1.useAtomValue)(exports.redrawGridSelector); };
 exports.useRedrawGrid = useRedrawGrid;

package/dist/cjs/atoms/sparkline-dialog.atom.d.ts

@@ -0,0 +1,34 @@
+import type { CellInterface, SelectionArea } from "@rowsncolumns/grid";
+import type { SparklineGroup, SparklineGroupType } from "@rowsncolumns/utils";
+import type { SelectionAttributes } from "../components/canvas-grid/typings";
+/**
+ * Open-state + payload for Excel's Create Sparklines dialog (Insert → Sparklines → Line / Column /
+ * Win-Loss) and its Edit Sparklines twin (Sparkline Design → Edit Data → Edit Group Location &
+ * Data…). The dialog is host-mounted (`SparklineDialogHost`) and submits through the state hook's
+ * `onCreateSparklineGroup` / `onUpdateSparklineGroup`.
+ */
+export type SparklineDialogRequest = {
+    mode: "create";
+    sheetId: number;
+    type: SparklineGroupType;
+    activeCell: CellInterface;
+    selections: SelectionArea<SelectionAttributes>[];
+} | {
+    mode: "edit";
+    group: SparklineGroup;
+};
+export declare const sparklineDialogAtom: import("jotai").PrimitiveAtom<SparklineDialogRequest | null> & {
+    init: SparklineDialogRequest | null;
+};
+export declare const useSparklineDialogState: () => [SparklineDialogRequest | null, (args_0: SparklineDialogRequest | ((prev: SparklineDialogRequest | null) => SparklineDialogRequest | null) | null) => void];
+/** Number of mounted `SparklineDialogHost`s — menus only offer sparkline entries while one exists. */
+export declare const sparklineDialogHostCountAtom: import("jotai").PrimitiveAtom<number> & {
+    init: number;
+};
+/** True when at least one `SparklineDialogHost` is mounted. */
+export declare const useIsSparklineDialogMounted: () => boolean;
+/** Registers the calling component as a dialog host for its lifetime. */
+export declare const useRegisterSparklineDialogHost: () => void;
+/** Returns a function that opens the host-mounted Create / Edit Sparklines dialog. */
+export declare const useOpenSparklineDialog: () => (request: SparklineDialogRequest) => void;
+//# sourceMappingURL=sparkline-dialog.atom.d.ts.map

package/dist/cjs/atoms/sparkline-dialog.atom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sparkline-dialog.atom.d.ts","sourceRoot":"","sources":["../../../atoms/sparkline-dialog.atom.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACvE,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAI9E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAE7E;;;;;GAKG;AACH,MAAM,MAAM,sBAAsB,GAC9B;IACE,IAAI,EAAE,QAAQ,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,kBAAkB,CAAC;IACzB,UAAU,EAAE,aAAa,CAAC;IAC1B,UAAU,EAAE,aAAa,CAAC,mBAAmB,CAAC,EAAE,CAAC;CAClD,GACD;IACE,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,cAAc,CAAC;CACvB,CAAC;AAEN,eAAO,MAAM,mBAAmB;;CAA4C,CAAC;AAE7E,eAAO,MAAM,uBAAuB,mKAAqC,CAAC;AAE1E,sGAAsG;AACtG,eAAO,MAAM,4BAA4B;;CAAU,CAAC;AAEpD,+DAA+D;AAC/D,eAAO,MAAM,2BAA2B,eACQ,CAAC;AAEjD,yEAAyE;AACzE,eAAO,MAAM,8BAA8B,YAM1C,CAAC;AAEF,sFAAsF;AACtF,eAAO,MAAM,sBAAsB,kBAGrB,sBAAsB,SAGnC,CAAC"}

package/dist/cjs/atoms/sparkline-dialog.atom.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useOpenSparklineDialog = exports.useRegisterSparklineDialogHost = exports.useIsSparklineDialogMounted = exports.sparklineDialogHostCountAtom = exports.useSparklineDialogState = exports.sparklineDialogAtom = void 0;
+var jotai_1 = require("jotai");
+var react_1 = require("react");
+exports.sparklineDialogAtom = (0, jotai_1.atom)(null);
+var useSparklineDialogState = function () { return (0, jotai_1.useAtom)(exports.sparklineDialogAtom); };
+exports.useSparklineDialogState = useSparklineDialogState;
+/** Number of mounted `SparklineDialogHost`s — menus only offer sparkline entries while one exists. */
+exports.sparklineDialogHostCountAtom = (0, jotai_1.atom)(0);
+/** True when at least one `SparklineDialogHost` is mounted. */
+var useIsSparklineDialogMounted = function () {
+    return (0, jotai_1.useAtomValue)(exports.sparklineDialogHostCountAtom) > 0;
+};
+exports.useIsSparklineDialogMounted = useIsSparklineDialogMounted;
+/** Registers the calling component as a dialog host for its lifetime. */
+var useRegisterSparklineDialogHost = function () {
+    var setCount = (0, jotai_1.useSetAtom)(exports.sparklineDialogHostCountAtom);
+    (0, react_1.useEffect)(function () {
+        setCount(function (count) { return count + 1; });
+        return function () { return setCount(function (count) { return count - 1; }); };
+    }, [setCount]);
+};
+exports.useRegisterSparklineDialogHost = useRegisterSparklineDialogHost;
+/** Returns a function that opens the host-mounted Create / Edit Sparklines dialog. */
+var useOpenSparklineDialog = function () {
+    var setRequest = (0, jotai_1.useSetAtom)(exports.sparklineDialogAtom);
+    return (0, react_1.useCallback)(function (request) { return setRequest(request); }, [setRequest]);
+};
+exports.useOpenSparklineDialog = useOpenSparklineDialog;

package/dist/cjs/atoms/table-auto-expansion.atom.d.ts

@@ -0,0 +1,14 @@
+import type { TableAutoExpansion } from "../api/table-auto-expansion";
+/**
+ * The table that just auto-expanded, waiting for Excel's AutoCorrect smart tag ("Undo Table
+ * AutoExpansion" / "Stop Automatically Expanding Tables"). Set by the engines' table-growth path
+ * (`useOnChangeTableColumn` in `@rowsncolumns/spreadsheet-state`; the rnc engine's commit fold),
+ * read by `CanvasGrid`. Dropped when the user moves away from the grown table or switches sheet.
+ */
+export declare const tableAutoExpansionAtom: import("jotai").PrimitiveAtom<TableAutoExpansion | null> & {
+    init: TableAutoExpansion | null;
+};
+export declare const useTableAutoExpansionState: () => [TableAutoExpansion | null, (args_0: TableAutoExpansion | ((prev: TableAutoExpansion | null) => TableAutoExpansion | null) | null) => void];
+export declare const useTableAutoExpansionValue: () => TableAutoExpansion | null;
+export declare const useSetTableAutoExpansion: () => (args_0: TableAutoExpansion | ((prev: TableAutoExpansion | null) => TableAutoExpansion | null) | null) => void;
+//# sourceMappingURL=table-auto-expansion.atom.d.ts.map

package/dist/cjs/atoms/table-auto-expansion.atom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"table-auto-expansion.atom.d.ts","sourceRoot":"","sources":["../../../atoms/table-auto-expansion.atom.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAEtE;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB;;CAAwC,CAAC;AAE5E,eAAO,MAAM,0BAA0B,mJAAwC,CAAC;AAChF,eAAO,MAAM,0BAA0B,iCAA6C,CAAC;AACrF,eAAO,MAAM,wBAAwB,sHAA2C,CAAC"}

package/dist/cjs/atoms/table-auto-expansion.atom.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useSetTableAutoExpansion = exports.useTableAutoExpansionValue = exports.useTableAutoExpansionState = exports.tableAutoExpansionAtom = void 0;
+var jotai_1 = require("jotai");
+/**
+ * The table that just auto-expanded, waiting for Excel's AutoCorrect smart tag ("Undo Table
+ * AutoExpansion" / "Stop Automatically Expanding Tables"). Set by the engines' table-growth path
+ * (`useOnChangeTableColumn` in `@rowsncolumns/spreadsheet-state`; the rnc engine's commit fold),
+ * read by `CanvasGrid`. Dropped when the user moves away from the grown table or switches sheet.
+ */
+exports.tableAutoExpansionAtom = (0, jotai_1.atom)(null);
+var useTableAutoExpansionState = function () { return (0, jotai_1.useAtom)(exports.tableAutoExpansionAtom); };
+exports.useTableAutoExpansionState = useTableAutoExpansionState;
+var useTableAutoExpansionValue = function () { return (0, jotai_1.useAtomValue)(exports.tableAutoExpansionAtom); };
+exports.useTableAutoExpansionValue = useTableAutoExpansionValue;
+var useSetTableAutoExpansion = function () { return (0, jotai_1.useSetAtom)(exports.tableAutoExpansionAtom); };
+exports.useSetTableAutoExpansion = useSetTableAutoExpansion;

package/dist/cjs/components/calculated-column-smart-tag/index.d.ts

@@ -0,0 +1,25 @@
+import React from "react";
+import type { CalculatedColumnFillKind, CalculatedColumnOption } from "../../api/calculated-column-fill";
+export type CalculatedColumnSmartTagProps = {
+    /** Position/size of the selection the tag is anchored to (bottom-left). */
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    kind: CalculatedColumnFillKind;
+    /** Whether the host can turn calculated columns off ("Stop automatically creating calculated columns"). */
+    canStop: boolean;
+    onChooseOption(option: CalculatedColumnOption): void;
+};
+/**
+ * Excel's AutoCorrect Options smart tag after a formula typed into a table column: "Undo Calculated
+ * Column" when the formula filled the column (the fill alone reverts, the typed cell stays),
+ * "Overwrite all cells in this column with this formula" when the column held cells that kept it
+ * from filling, and "Stop automatically creating calculated columns" (when the host wires
+ * `onChangeAutoCalculatedColumns`). Same skin as the Table AutoExpansion tag.
+ */
+export declare const CalculatedColumnSmartTag: {
+    ({ x, y, width: _width, height, kind, canStop, onChooseOption, }: CalculatedColumnSmartTagProps): React.JSX.Element;
+    displayName: string;
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/components/calculated-column-smart-tag/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../components/calculated-column-smart-tag/index.tsx"],"names":[],"mappings":"AAQA,OAAO,KAAmB,MAAM,OAAO,CAAC;AAExC,OAAO,KAAK,EACV,wBAAwB,EACxB,sBAAsB,EACvB,MAAM,kCAAkC,CAAC;AAE1C,MAAM,MAAM,6BAA6B,GAAG;IAC1C,2EAA2E;IAC3E,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,wBAAwB,CAAC;IAC/B,2GAA2G;IAC3G,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,CAAC,MAAM,EAAE,sBAAsB,GAAG,IAAI,CAAC;CACtD,CAAC;AASF;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB;sEAQlC,6BAA6B;;CA2C/B,CAAC"}

package/dist/cjs/components/calculated-column-smart-tag/index.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CalculatedColumnSmartTag = void 0;
+var tslib_1 = require("tslib");
+var ui_1 = require("@rowsncolumns/ui");
+var react_1 = tslib_1.__importStar(require("react"));
+/** Excel's AutoCorrect Options lightning bolt. */
+var LightningIcon = function () { return (react_1.default.createElement("svg", { width: "14", height: "14", viewBox: "0 0 24 24", fill: "currentColor", "aria-hidden": "true" },
+    react_1.default.createElement("path", { d: "M13 2 4 14h6l-1 8 9-12h-6l1-8z" }))); };
+/**
+ * Excel's AutoCorrect Options smart tag after a formula typed into a table column: "Undo Calculated
+ * Column" when the formula filled the column (the fill alone reverts, the typed cell stays),
+ * "Overwrite all cells in this column with this formula" when the column held cells that kept it
+ * from filling, and "Stop automatically creating calculated columns" (when the host wires
+ * `onChangeAutoCalculatedColumns`). Same skin as the Table AutoExpansion tag.
+ */
+var CalculatedColumnSmartTag = function (_a) {
+    var x = _a.x, y = _a.y, _width = _a.width, height = _a.height, kind = _a.kind, canStop = _a.canStop, onChooseOption = _a.onChooseOption;
+    var _b = tslib_1.__read((0, react_1.useState)(false), 2), open = _b[0], setOpen = _b[1];
+    return (react_1.default.createElement("div", { className: "absolute pointer-events-auto flex items-start justify-start", style: { left: x, top: y + height }, onMouseDown: function (e) { return e.stopPropagation(); }, "data-testid": "calculated-column" },
+        react_1.default.createElement(ui_1.DropdownMenu, { modal: false, open: open, onOpenChange: setOpen },
+            react_1.default.createElement(ui_1.DropdownMenuTrigger, { asChild: true },
+                react_1.default.createElement(ui_1.IconButton, { tooltip: "AutoCorrect Options", "aria-label": "AutoCorrect Options", className: "shadow-sm bg-rnc-background border-rnc-border border border-solid rounded-md" },
+                    react_1.default.createElement(LightningIcon, null))),
+            react_1.default.createElement(ui_1.DropdownMenuPortal, null,
+                react_1.default.createElement(ui_1.DropdownMenuContent, { align: "start", onCloseAutoFocus: function (event) { return event.preventDefault(); } },
+                    kind === "filled" ? (react_1.default.createElement(ui_1.DropdownMenuItem, { onSelect: function () { return onChooseOption("undo"); } }, "Undo Calculated Column")) : (react_1.default.createElement(ui_1.DropdownMenuItem, { onSelect: function () { return onChooseOption("overwrite"); } }, "Overwrite all cells in this column with this formula")),
+                    canStop ? (react_1.default.createElement(ui_1.DropdownMenuItem, { onSelect: function () { return onChooseOption("stop"); } }, "Stop automatically creating calculated columns")) : null)))));
+};
+exports.CalculatedColumnSmartTag = CalculatedColumnSmartTag;
+exports.CalculatedColumnSmartTag.displayName = "CalculatedColumnSmartTag";

package/dist/cjs/components/canvas-grid/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../components/canvas-grid/index.tsx"],"names":[],"mappings":"AA+CA,OAAO,KASN,MAAM,OAAO,CAAC;AAuMf,OAAO,KAAK,EAGV,QAAQ,EAUT,MAAM,aAAa,CAAC;AAcrB,OAAO,KAAK,EACV,wBAAwB,EACxB,iBAAiB,EACjB,eAAe,EAEhB,MAAM,WAAW,CAAC;AAy1KnB,eAAO,MAAM,UAAU,EAA4C,CACjE,CAAC,SAAS,QAAQ,CAAC,GAAG,CAAC,EAEvB,KAAK,EAAE,eAAe,CAAC,CAAC,CAAC,GACvB,wBAAwB,GAAG;IAAE,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAA;CAAE,KAChE,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../components/canvas-grid/index.tsx"],"names":[],"mappings":"AAoDA,OAAO,KASN,MAAM,OAAO,CAAC;AAsNf,OAAO,KAAK,EAGV,QAAQ,EAWT,MAAM,aAAa,CAAC;AAiBrB,OAAO,KAAK,EACV,wBAAwB,EACxB,iBAAiB,EACjB,eAAe,EAEhB,MAAM,WAAW,CAAC;AAgyLnB,eAAO,MAAM,UAAU,EAA4C,CACjE,CAAC,SAAS,QAAQ,CAAC,GAAG,CAAC,EAEvB,KAAK,EAAE,eAAe,CAAC,CAAC,CAAC,GACvB,wBAAwB,GAAG;IAAE,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAA;CAAE,KAChE,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC"}