@rowsncolumns/charts 28.0.0 → 28.1.0

package/dist/esm/config.js

@@ -1,3 +1,4 @@
+import { DEFAULT_PIE_EXPLOSION } from "./utils/pie-explosion";
 // Excel's 3-D chart classes degrade to a 2-D chartType with the authored
 // class kept as `sourceChartType` (BAR_3D, LINE_3D, PIE_3D, AREA_3D,
 // SURFACE, SURFACE_3D). The renderer draws BAR_3D / LINE_3D / AREA_3D /
@@ -5,14 +6,85 @@
 // 2-D pie) and both exporters write the matching `<c:…3DChart>` element.
 // A 2-D preset in the same family carries no token, and mergeChartSpec
 // clears a picker-authored one on that pick.
+//
+// Every preset in a family sets every field that distinguishes its
+// siblings (PRESET_DISCRIMINATORS): a preset that omits one keeps whatever
+// the previous pick left behind — rowsncolumns/spreadsheet#85 was "Line"
+// staying stacked after "Stacked line" because it never wrote stackedType.
 const LINE_CHART_TYPES = [
-    ["Line", { chartType: "line", smooth: false }],
+    [
+        "Line",
+        {
+            chartType: "line",
+            smooth: false,
+            stackedType: "UNSTACKED",
+            showMarkers: false,
+        },
+    ],
     [
         "Stacked line",
-        { chartType: "line", smooth: false, stackedType: "STACKED" },
+        {
+            chartType: "line",
+            smooth: false,
+            stackedType: "STACKED",
+            showMarkers: false,
+        },
+    ],
+    [
+        "100% stacked line",
+        {
+            chartType: "line",
+            smooth: false,
+            stackedType: "PERCENT_STACKED",
+            showMarkers: false,
+        },
+    ],
+    [
+        "Line with markers",
+        {
+            chartType: "line",
+            smooth: false,
+            stackedType: "UNSTACKED",
+            showMarkers: true,
+        },
+    ],
+    [
+        "Stacked line with markers",
+        {
+            chartType: "line",
+            smooth: false,
+            stackedType: "STACKED",
+            showMarkers: true,
+        },
+    ],
+    [
+        "100% stacked line with markers",
+        {
+            chartType: "line",
+            smooth: false,
+            stackedType: "PERCENT_STACKED",
+            showMarkers: true,
+        },
+    ],
+    [
+        "Smooth line",
+        {
+            chartType: "line",
+            smooth: true,
+            stackedType: "UNSTACKED",
+            showMarkers: false,
+        },
+    ],
+    [
+        "3-D Line",
+        {
+            chartType: "line",
+            smooth: false,
+            stackedType: "UNSTACKED",
+            showMarkers: false,
+            sourceChartType: "LINE_3D",
+        },
     ],
-    ["Smooth line", { chartType: "line", smooth: true }],
-    ["3-D Line", { chartType: "line", smooth: false, sourceChartType: "LINE_3D" }],
 ];
 const COLUMN_CHART_TYPES = [
     ["Clustered Column", { chartType: "column", stackedType: "UNSTACKED" }],
@@ -25,6 +97,18 @@ const COLUMN_CHART_TYPES = [
         "3-D Column",
         { chartType: "column", stackedType: "UNSTACKED", sourceChartType: "BAR_3D" },
     ],
+    [
+        "3-D Stacked column",
+        { chartType: "column", stackedType: "STACKED", sourceChartType: "BAR_3D" },
+    ],
+    [
+        "3-D 100% stacked column",
+        {
+            chartType: "column",
+            stackedType: "PERCENT_STACKED",
+            sourceChartType: "BAR_3D",
+        },
+    ],
 ];
 const BAR_CHART_TYPES = [
     ["Clustered Bar", { chartType: "bar", stackedType: "UNSTACKED" }],
@@ -34,6 +118,18 @@ const BAR_CHART_TYPES = [
         "3-D Bar",
         { chartType: "bar", stackedType: "UNSTACKED", sourceChartType: "BAR_3D" },
     ],
+    [
+        "3-D Stacked Bar",
+        { chartType: "bar", stackedType: "STACKED", sourceChartType: "BAR_3D" },
+    ],
+    [
+        "3-D 100% stacked Bar",
+        {
+            chartType: "bar",
+            stackedType: "PERCENT_STACKED",
+            sourceChartType: "BAR_3D",
+        },
+    ],
 ];
 const AREA_CHART_TYPES = [
     ["Area", { chartType: "area", stackedType: "UNSTACKED" }],
@@ -50,16 +146,43 @@ const SURFACE_CHART_TYPES = [
     ["3-D Surface", { chartType: "area", sourceChartType: "SURFACE_3D" }],
     ["Contour", { chartType: "area", sourceChartType: "SURFACE" }],
 ];
+// Pie presets set `explosion` explicitly (0 vs Excel's 25) so picking
+// "2D Pie" after "Exploded pie" pulls the slices back together.
 const PIE_CHART_TYPES = [
     [
         "2D Pie",
-        { chartType: "pie", stackedType: "UNSTACKED", radius: [0, "75%"] },
+        {
+            chartType: "pie",
+            stackedType: "UNSTACKED",
+            radius: [0, "75%"],
+            explosion: 0,
+        },
+    ],
+    [
+        "Exploded pie",
+        {
+            chartType: "pie",
+            stackedType: "UNSTACKED",
+            radius: [0, "75%"],
+            explosion: DEFAULT_PIE_EXPLOSION,
+        },
     ],
     // A first-class doughnut token. The hole is controlled by
     // spec.doughnutHoleSize (0-1 fraction, renderer default 0.5) via the
     // editor's "Chart options" section; the preset deliberately omits it
     // so re-picking "Doughnut" never clobbers an authored hole size.
-    ["Doughnut", { chartType: "doughnut", stackedType: "UNSTACKED" }],
+    [
+        "Doughnut",
+        { chartType: "doughnut", stackedType: "UNSTACKED", explosion: 0 },
+    ],
+    [
+        "Exploded doughnut",
+        {
+            chartType: "doughnut",
+            stackedType: "UNSTACKED",
+            explosion: DEFAULT_PIE_EXPLOSION,
+        },
+    ],
     [
         "3-D Pie",
         {
@@ -123,9 +246,13 @@ const RADAR_CHART_TYPES = [
     ["Radar with markers", { chartType: "radar", radarStyle: "marker" }],
     ["Filled radar", { chartType: "radar", radarStyle: "filled" }],
 ];
+// Excel's four stock layouts, named by the series they take in order.
+// The V-variants lead with a volume series drawn as a column sub-pane.
 const STOCK_CHART_TYPES = [
     ["Stock (HLC)", { chartType: "stock", stockVariant: "HLC" }],
     ["Stock (OHLC)", { chartType: "stock", stockVariant: "OHLC" }],
+    ["Stock (VHLC)", { chartType: "stock", stockVariant: "VHLC" }],
+    ["Stock (VOHLC)", { chartType: "stock", stockVariant: "VOHLC" }],
 ];
 export const CHART_TYPES = [
     ["Bar", BAR_CHART_TYPES],
@@ -175,16 +302,20 @@ export const isDoughnutSpec = (spec) => {
 /**
  * Fields that distinguish presets sharing a chartType, with the value
  * an absent field is equivalent to (e.g. no stackedType renders
- * unstacked, so `{ chartType: "column" }` is "Clustered Column").
+ * unstacked, so `{ chartType: "column" }` is "Clustered Column"). An
+ * optional normalizer folds a range of authored values onto the preset's
+ * (any explosion percentage is "exploded").
  */
 const PRESET_DISCRIMINATORS = [
     ["stackedType", "UNSTACKED"],
     ["smooth", false],
+    ["showMarkers", false],
     ["radarStyle", "standard"],
     ["stockVariant", "HLC"],
     // 3-D / of-pie variants share a chartType with their 2-D preset.
     ["sourceChartType", undefined],
     ["ofPieType", "pie"],
+    ["explosion", 0, (value) => typeof value === "number" && value > 0],
 ];
 /**
  * Derive the picker label for an existing spec — the inverse of the
@@ -194,20 +325,26 @@ const PRESET_DISCRIMINATORS = [
  * Falls back to the capitalized chartType when no preset matches.
  */
 export const getChartPresetLabel = (spec) => {
+    const loose = spec;
     // Doughnut first — it has several encodings (see isDoughnutSpec) and
     // the legacy pie-based ones would otherwise match the pie presets.
-    if (isDoughnutSpec(spec))
-        return "Doughnut";
-    const loose = spec;
+    if (isDoughnutSpec(spec)) {
+        const explosion = loose.explosion;
+        return typeof explosion === "number" && explosion > 0
+            ? "Exploded doughnut"
+            : "Doughnut";
+    }
     for (const [, presets] of CHART_TYPES) {
         for (const [name, config] of presets) {
             if (config.chartType !== spec.chartType)
                 continue;
             const looseConfig = config;
-            const matches = PRESET_DISCRIMINATORS.every(([key, absentValue]) => {
+            const matches = PRESET_DISCRIMINATORS.every(([key, absentValue, normalize]) => {
                 const presetValue = looseConfig[key] ?? absentValue;
                 const specValue = loose[key] ?? absentValue;
-                return presetValue === specValue;
+                return normalize
+                    ? normalize(presetValue) === normalize(specValue)
+                    : presetValue === specValue;
             });
             if (matches)
                 return name;

package/dist/esm/hooks/use-charts.d.ts

@@ -1,10 +1,24 @@
-import type { EmbeddedChart } from "@rowsncolumns/spreadsheet";
-import type { UseSpreadsheetProps, useSpreadsheetState } from "@rowsncolumns/spreadsheet-state";
-export type UseChartsProps = {
+import type { EmbeddedChart, Sheet } from "@rowsncolumns/spreadsheet";
+import type { GeneratedNames, UseSpreadsheetProps, useSpreadsheetState } from "@rowsncolumns/spreadsheet-state";
+export type UseChartsProps<S extends Sheet = Sheet> = {
     /**
      * Callback when chart state is changed
      */
     onChangeCharts?: React.Dispatch<React.SetStateAction<EmbeddedChart[]>>;
+    /**
+     * Callback when sheets change. Required for `onMoveChartToSheet` (Excel's
+     * "Move Chart…"), which adds / removes chartsheets.
+     */
+    onChangeSheets?: React.Dispatch<React.SetStateAction<S[]>>;
+    /**
+     * Switch the active sheet — `onMoveChartToSheet` follows the chart to its
+     * destination sheet like Excel.
+     */
+    onChangeActiveSheet?: (sheetId: number) => void;
+    /**
+     * Generated-name formatters (`Chart1` for a new chartsheet).
+     */
+    generatedNames?: GeneratedNames;
     /**
      * Create a spreadsheet history
      */
@@ -22,14 +36,15 @@ export type UseChartsProps = {
      */
     idCreationStrategy?: UseSpreadsheetProps["idCreationStrategy"];
 };
-export declare const useCharts: ({ onChangeCharts, getFormattedValue, getEffectiveValue, createHistory, idCreationStrategy, }: UseChartsProps) => {
+export declare const useCharts: <S extends Sheet = Sheet>({ onChangeCharts, onChangeSheets, onChangeActiveSheet, getFormattedValue, getEffectiveValue, createHistory, idCreationStrategy, generatedNames, }: UseChartsProps<S>) => {
     selectedChart: EmbeddedChart | undefined;
     onRequestEditChart: (chart: EmbeddedChart) => void;
     updateSelectedChartPosition: (chartId: string | number, overlayPosition: Partial<import("@rowsncolumns/spreadsheet").OverlayPosition>) => void;
     onCreateChart: (sheetId: number, activeCell: import("@rowsncolumns/grid").CellInterface, selections: import("@rowsncolumns/grid").SelectionArea<import("@rowsncolumns/spreadsheet").SelectionAttributes>[], chartSpec?: EmbeddedChart) => EmbeddedChart;
     onDeleteChart: (chartId: string | number) => void;
-    onMoveChart: (chartId: string | number, anchorCell: import("@rowsncolumns/grid").CellInterface, offsetXPixels: number, offsetYPixels: number) => void;
-    onResizeChart: (chartId: string | number, anchorCell: import("@rowsncolumns/grid").CellInterface, offsetXPixels: number, offsetYPixels: number, width: number, height: number) => void;
+    onMoveChart: (chartId: string | number, anchorCell: import("@rowsncolumns/grid").CellInterface, offsetXPixels: number, offsetYPixels: number, toAnchor?: import("@rowsncolumns/spreadsheet").OverlayToAnchor) => void;
+    onMoveChartToSheet: ((chart: EmbeddedChart, target: import("@rowsncolumns/spreadsheet").MoveChartTarget) => number | undefined) | undefined;
+    onResizeChart: (chartId: string | number, anchorCell: import("@rowsncolumns/grid").CellInterface, offsetXPixels: number, offsetYPixels: number, width: number, height: number, toAnchor?: import("@rowsncolumns/spreadsheet").OverlayToAnchor) => void;
     onUpdateChart: (chart: EmbeddedChart) => void;
 };
 //# sourceMappingURL=use-charts.d.ts.map

package/dist/esm/hooks/use-charts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-charts.d.ts","sourceRoot":"","sources":["../../../hooks/use-charts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAmB,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAChF,OAAO,KAAK,EACV,mBAAmB,EACnB,mBAAmB,EACpB,MAAM,iCAAiC,CAAC;AAUzC,MAAM,MAAM,cAAc,GAAG;IAC3B;;OAEG;IACH,cAAc,CAAC,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC;IACvE;;OAEG;IACH,aAAa,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC,eAAe,CAAC,CAAC;IACvE;;OAEG;IACH,iBAAiB,EAAE,UAAU,CAC3B,OAAO,mBAAmB,CAC3B,CAAC,mBAAmB,CAAC,CAAC;IACvB;;OAEG;IACH,iBAAiB,EAAE,UAAU,CAC3B,OAAO,mBAAmB,CAC3B,CAAC,mBAAmB,CAAC,CAAC;IACvB;;OAEG;IACH,kBAAkB,CAAC,EAAE,mBAAmB,CAAC,oBAAoB,CAAC,CAAC;CAChE,CAAC;AAEF,eAAO,MAAM,SAAS,GAAI,8FAMvB,cAAc;;;;;;;;;CA6EhB,CAAC"}
+{"version":3,"file":"use-charts.d.ts","sourceRoot":"","sources":["../../../hooks/use-charts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,aAAa,EACb,KAAK,EACN,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EACV,cAAc,EACd,mBAAmB,EACnB,mBAAmB,EACpB,MAAM,iCAAiC,CAAC;AAWzC,MAAM,MAAM,cAAc,CAAC,CAAC,SAAS,KAAK,GAAG,KAAK,IAAI;IACpD;;OAEG;IACH,cAAc,CAAC,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC;IACvE;;;OAGG;IACH,cAAc,CAAC,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC3D;;;OAGG;IACH,mBAAmB,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAChD;;OAEG;IACH,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC;;OAEG;IACH,aAAa,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC,eAAe,CAAC,CAAC;IACvE;;OAEG;IACH,iBAAiB,EAAE,UAAU,CAC3B,OAAO,mBAAmB,CAC3B,CAAC,mBAAmB,CAAC,CAAC;IACvB;;OAEG;IACH,iBAAiB,EAAE,UAAU,CAC3B,OAAO,mBAAmB,CAC3B,CAAC,mBAAmB,CAAC,CAAC;IACvB;;OAEG;IACH,kBAAkB,CAAC,EAAE,mBAAmB,CAAC,oBAAoB,CAAC,CAAC;CAChE,CAAC;AAEF,eAAO,MAAM,SAAS,GAAI,CAAC,SAAS,KAAK,GAAG,KAAK,EAAE,mJAShD,cAAc,CAAC,CAAC,CAAC;;;;;;;;;;CAwFnB,CAAC"}

package/dist/esm/hooks/use-charts.js

@@ -2,10 +2,11 @@ import { useCallback } from "react";
 import { useChartEditor } from "./use-chart-editor";
 import { useOnDeleteChart } from "./use-on-delete-chart";
 import { useOnMoveChart } from "./use-on-move-chart";
+import { useOnMoveChartToSheet } from "./use-on-move-chart-to-sheet";
 import { useOnResizeChart } from "./use-on-resize-chart";
 import { useOnUpdateChart } from "./use-on-update-chart";
 import { useOnCreateChart } from "./use-on-create-chart";
-export const useCharts = ({ onChangeCharts, getFormattedValue, getEffectiveValue, createHistory, idCreationStrategy, }) => {
+export const useCharts = ({ onChangeCharts, onChangeSheets, onChangeActiveSheet, getFormattedValue, getEffectiveValue, createHistory, idCreationStrategy, generatedNames, }) => {
     const { selectedChart, onRequestEditChart, updateSelectedChartPosition } = useChartEditor();
     const onDeleteChart = useOnDeleteChart({
         onChangeCharts,
@@ -42,6 +43,15 @@ export const useCharts = ({ onChangeCharts, getFormattedValue, getEffectiveValue
         onChangeCharts,
         createHistory,
     });
+    const handleMoveChartToSheet = useOnMoveChartToSheet({
+        onChangeCharts,
+        onChangeSheets: onChangeSheets ?? noopDispatch,
+        onChangeActiveSheet,
+        createHistory,
+        idCreationStrategy,
+        generatedNames,
+    });
+    const onMoveChartToSheet = onChangeSheets ? handleMoveChartToSheet : undefined;
     const onCreateChart = useOnCreateChart({
         onChangeCharts,
         createHistory,
@@ -56,7 +66,9 @@ export const useCharts = ({ onChangeCharts, getFormattedValue, getEffectiveValue
         onCreateChart,
         onDeleteChart,
         onMoveChart,
+        onMoveChartToSheet,
         onResizeChart,
         onUpdateChart,
     };
 };
+const noopDispatch = () => { };

package/dist/esm/hooks/use-on-create-chart.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-on-create-chart.d.ts","sourceRoot":"","sources":["../../../hooks/use-on-create-chart.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAClE,OAAO,EACL,KAAK,QAAQ,EACb,mBAAmB,EACnB,aAAa,EACd,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EACV,mBAAmB,EACnB,mBAAmB,EACpB,MAAM,iCAAiC,CAAC;AAIzC,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,MAAM,MAAM,qBAAqB,CAAC,CAAC,SAAS,QAAQ,IAAI;IACtD,cAAc,EAAE,mBAAmB,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC;IACzD,aAAa,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC,eAAe,CAAC,CAAC;IACvE,iBAAiB,EAAE,UAAU,CAC3B,OAAO,mBAAmB,CAC3B,CAAC,mBAAmB,CAAC,CAAC;IACvB,iBAAiB,EAAE,UAAU,CAC3B,OAAO,mBAAmB,CAC3B,CAAC,mBAAmB,CAAC,CAAC;IACvB,kBAAkB,CAAC,EAAE,cAAc,CAAC,oBAAoB,CAAC,CAAC;CAC3D,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAI,CAAC,SAAS,QAAQ,EAAE,8FAMlD,qBAAqB,CAAC,CAAC,CAAC,eAGZ,MAAM,cACH,aAAa,cACb,aAAa,CAAC,mBAAmB,CAAC,EAAE,cACpC,aAAa,kBAkB9B,CAAC"}
+{"version":3,"file":"use-on-create-chart.d.ts","sourceRoot":"","sources":["../../../hooks/use-on-create-chart.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAClE,OAAO,EACL,KAAK,QAAQ,EACb,mBAAmB,EACnB,aAAa,EAEd,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EACV,mBAAmB,EACnB,mBAAmB,EACpB,MAAM,iCAAiC,CAAC;AAIzC,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,MAAM,MAAM,qBAAqB,CAAC,CAAC,SAAS,QAAQ,IAAI;IACtD,cAAc,EAAE,mBAAmB,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC;IACzD,aAAa,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC,eAAe,CAAC,CAAC;IACvE,iBAAiB,EAAE,UAAU,CAC3B,OAAO,mBAAmB,CAC3B,CAAC,mBAAmB,CAAC,CAAC;IACvB,iBAAiB,EAAE,UAAU,CAC3B,OAAO,mBAAmB,CAC3B,CAAC,mBAAmB,CAAC,CAAC;IACvB,kBAAkB,CAAC,EAAE,cAAc,CAAC,oBAAoB,CAAC,CAAC;CAC3D,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAI,CAAC,SAAS,QAAQ,EAAE,8FAMlD,qBAAqB,CAAC,CAAC,CAAC,eAIZ,MAAM,cACH,aAAa,cACb,aAAa,CAAC,mBAAmB,CAAC,EAAE,cACpC,aAAa,kBAsB9B,CAAC"}

package/dist/esm/hooks/use-on-create-chart.js

@@ -1,19 +1,25 @@
+import { useFocusEmbedOrChart, } from "@rowsncolumns/spreadsheet";
 import { useCallback } from "react";
 import { createChart } from "../interface/create-chart";
 export const useOnCreateChart = ({ onChangeCharts, getFormattedValue, getEffectiveValue, createHistory, idCreationStrategy, }) => {
+    const focusEmbedOrChart = useFocusEmbedOrChart();
     return useCallback((sheetId, activeCell, selections, chartSpec) => {
-        return createChart({
+        const chart = createChart({
             onChangeCharts,
             getFormattedValue,
             getEffectiveValue,
             createHistory,
             idCreationStrategy,
         })(sheetId, activeCell, selections, chartSpec);
+        // Excel selects a freshly inserted chart.
+        focusEmbedOrChart(chart.chartId);
+        return chart;
     }, [
         onChangeCharts,
         getFormattedValue,
         getEffectiveValue,
         createHistory,
         idCreationStrategy,
+        focusEmbedOrChart,
     ]);
 };

package/dist/esm/hooks/use-on-move-chart-to-sheet.d.ts

@@ -0,0 +1,12 @@
+import type { CellData, EmbeddedChart, MoveChartTarget, Sheet } from "@rowsncolumns/spreadsheet";
+import type { GeneratedNames, UseSpreadsheetProps, useSpreadsheetState } from "@rowsncolumns/spreadsheet-state";
+export type UseOnMoveChartToSheetProps<T extends CellData, S extends Sheet = Sheet> = {
+    onChangeCharts: UseSpreadsheetProps<T>["onChangeCharts"];
+    onChangeSheets: React.Dispatch<React.SetStateAction<S[]>>;
+    onChangeActiveSheet?: (sheetId: number) => void;
+    createHistory: ReturnType<typeof useSpreadsheetState>["createHistory"];
+    idCreationStrategy?: UseSpreadsheetProps<T>["idCreationStrategy"];
+    generatedNames?: GeneratedNames;
+};
+export declare const useOnMoveChartToSheet: <T extends CellData, S extends Sheet = Sheet>({ onChangeCharts, onChangeSheets, onChangeActiveSheet, createHistory, idCreationStrategy, generatedNames, }: UseOnMoveChartToSheetProps<T, S>) => (chart: EmbeddedChart, target: MoveChartTarget) => number | undefined;
+//# sourceMappingURL=use-on-move-chart-to-sheet.d.ts.map

package/dist/esm/hooks/use-on-move-chart-to-sheet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-on-move-chart-to-sheet.d.ts","sourceRoot":"","sources":["../../../hooks/use-on-move-chart-to-sheet.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,QAAQ,EACR,aAAa,EACb,eAAe,EACf,KAAK,EACN,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EACV,cAAc,EACd,mBAAmB,EACnB,mBAAmB,EACpB,MAAM,iCAAiC,CAAC;AAKzC,MAAM,MAAM,0BAA0B,CACpC,CAAC,SAAS,QAAQ,EAClB,CAAC,SAAS,KAAK,GAAG,KAAK,IACrB;IACF,cAAc,EAAE,mBAAmB,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC;IACzD,cAAc,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC1D,mBAAmB,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAChD,aAAa,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC,eAAe,CAAC,CAAC;IACvE,kBAAkB,CAAC,EAAE,mBAAmB,CAAC,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC;IAClE,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAChC,CAAC,SAAS,QAAQ,EAClB,CAAC,SAAS,KAAK,GAAG,KAAK,EACvB,6GAOC,0BAA0B,CAAC,CAAC,EAAE,CAAC,CAAC,aAEvB,aAAa,UAAU,eAAe,uBAkBjD,CAAC"}

package/dist/esm/hooks/use-on-move-chart-to-sheet.js

@@ -0,0 +1,19 @@
+import { useCallback } from "react";
+import { moveChartToSheet } from "../interface/move-chart-to-sheet";
+export const useOnMoveChartToSheet = ({ onChangeCharts, onChangeSheets, onChangeActiveSheet, createHistory, idCreationStrategy, generatedNames, }) => {
+    return useCallback((chart, target) => moveChartToSheet({
+        onChangeCharts,
+        onChangeSheets,
+        onChangeActiveSheet,
+        createHistory,
+        idCreationStrategy,
+        generatedNames,
+    })(chart, target), [
+        onChangeCharts,
+        onChangeSheets,
+        onChangeActiveSheet,
+        createHistory,
+        idCreationStrategy,
+        generatedNames,
+    ]);
+};

package/dist/esm/hooks/use-on-move-chart.d.ts

@@ -4,5 +4,5 @@ export type UseOnMoveChartProps<T extends CellData> = {
     onChangeCharts: UseSpreadsheetProps<T>["onChangeCharts"];
     createHistory: ReturnType<typeof useSpreadsheetState>["createHistory"];
 };
-export declare const useOnMoveChart: <T extends CellData>({ onChangeCharts, createHistory, }: UseOnMoveChartProps<T>) => (chartId: string | number, anchorCell: import("@rowsncolumns/grid").CellInterface, offsetXPixels: number, offsetYPixels: number) => void;
+export declare const useOnMoveChart: <T extends CellData>({ onChangeCharts, createHistory, }: UseOnMoveChartProps<T>) => (chartId: string | number, anchorCell: import("@rowsncolumns/grid").CellInterface, offsetXPixels: number, offsetYPixels: number, toAnchor?: import("@rowsncolumns/spreadsheet").OverlayToAnchor) => void;
 //# sourceMappingURL=use-on-move-chart.d.ts.map

package/dist/esm/hooks/use-on-move-chart.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-on-move-chart.d.ts","sourceRoot":"","sources":["../../../hooks/use-on-move-chart.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAmB,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAC3E,OAAO,KAAK,EACV,mBAAmB,EACnB,mBAAmB,EACpB,MAAM,iCAAiC,CAAC;AAKzC,MAAM,MAAM,mBAAmB,CAAC,CAAC,SAAS,QAAQ,IAAI;IACpD,cAAc,EAAE,mBAAmB,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC;IACzD,aAAa,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC,eAAe,CAAC,CAAC;CACxE,CAAC;AAEF,eAAO,MAAM,cAAc,GAAI,CAAC,SAAS,QAAQ,EAAE,oCAGhD,mBAAmB,CAAC,CAAC,CAAC,6IAUxB,CAAC"}
+{"version":3,"file":"use-on-move-chart.d.ts","sourceRoot":"","sources":["../../../hooks/use-on-move-chart.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAmB,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAC3E,OAAO,KAAK,EACV,mBAAmB,EACnB,mBAAmB,EACpB,MAAM,iCAAiC,CAAC;AAKzC,MAAM,MAAM,mBAAmB,CAAC,CAAC,SAAS,QAAQ,IAAI;IACpD,cAAc,EAAE,mBAAmB,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC;IACzD,aAAa,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC,eAAe,CAAC,CAAC;CACxE,CAAC;AAEF,eAAO,MAAM,cAAc,GAAI,CAAC,SAAS,QAAQ,EAAE,oCAGhD,mBAAmB,CAAC,CAAC,CAAC,6MAUxB,CAAC"}

package/dist/esm/hooks/use-on-move-chart.js

@@ -1,10 +1,10 @@
 import { useCallback } from "react";
 import { moveChart } from "../interface/move-chart";
 export const useOnMoveChart = ({ onChangeCharts, createHistory, }) => {
-    return useCallback((chartId, anchorCell, offsetXPixels, offsetYPixels) => {
+    return useCallback((chartId, anchorCell, offsetXPixels, offsetYPixels, toAnchor) => {
         moveChart({
             onChangeCharts,
             createHistory,
-        })(chartId, anchorCell, offsetXPixels, offsetYPixels);
+        })(chartId, anchorCell, offsetXPixels, offsetYPixels, toAnchor);
     }, [onChangeCharts, createHistory]);
 };

package/dist/esm/hooks/use-on-resize-chart.d.ts

@@ -4,5 +4,5 @@ export type UseOnResizeChartProps<T extends CellData> = {
     onChangeCharts: UseSpreadsheetProps<T>["onChangeCharts"];
     createHistory: ReturnType<typeof useSpreadsheetState>["createHistory"];
 };
-export declare const useOnResizeChart: <T extends CellData>({ onChangeCharts, createHistory, }: UseOnResizeChartProps<T>) => (chartId: string | number, anchorCell: import("@rowsncolumns/grid").CellInterface, offsetXPixels: number, offsetYPixels: number, width: number, height: number) => void;
+export declare const useOnResizeChart: <T extends CellData>({ onChangeCharts, createHistory, }: UseOnResizeChartProps<T>) => (chartId: string | number, anchorCell: import("@rowsncolumns/grid").CellInterface, offsetXPixels: number, offsetYPixels: number, width: number, height: number, toAnchor?: import("@rowsncolumns/spreadsheet").OverlayToAnchor) => void;
 //# sourceMappingURL=use-on-resize-chart.d.ts.map

package/dist/esm/hooks/use-on-resize-chart.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-on-resize-chart.d.ts","sourceRoot":"","sources":["../../../hooks/use-on-resize-chart.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAmB,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAC3E,OAAO,KAAK,EACV,mBAAmB,EACnB,mBAAmB,EACpB,MAAM,iCAAiC,CAAC;AAKzC,MAAM,MAAM,qBAAqB,CAAC,CAAC,SAAS,QAAQ,IAAI;IACtD,cAAc,EAAE,mBAAmB,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC;IACzD,aAAa,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC,eAAe,CAAC,CAAC;CACxE,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAI,CAAC,SAAS,QAAQ,EAAE,oCAGlD,qBAAqB,CAAC,CAAC,CAAC,4KAU1B,CAAC"}
+{"version":3,"file":"use-on-resize-chart.d.ts","sourceRoot":"","sources":["../../../hooks/use-on-resize-chart.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAmB,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAC3E,OAAO,KAAK,EACV,mBAAmB,EACnB,mBAAmB,EACpB,MAAM,iCAAiC,CAAC;AAKzC,MAAM,MAAM,qBAAqB,CAAC,CAAC,SAAS,QAAQ,IAAI;IACtD,cAAc,EAAE,mBAAmB,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC;IACzD,aAAa,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC,eAAe,CAAC,CAAC;CACxE,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAI,CAAC,SAAS,QAAQ,EAAE,oCAGlD,qBAAqB,CAAC,CAAC,CAAC,4OA0B1B,CAAC"}

package/dist/esm/hooks/use-on-resize-chart.js

@@ -1,10 +1,10 @@
 import { useCallback } from "react";
 import { resizeChart } from "../interface/resize-chart";
 export const useOnResizeChart = ({ onChangeCharts, createHistory, }) => {
-    return useCallback((chartId, anchorCell, offsetXPixels, offsetYPixels, width, height) => {
+    return useCallback((chartId, anchorCell, offsetXPixels, offsetYPixels, width, height, toAnchor) => {
         resizeChart({
             onChangeCharts,
             createHistory,
-        })(chartId, anchorCell, offsetXPixels, offsetYPixels, width, height);
+        })(chartId, anchorCell, offsetXPixels, offsetYPixels, width, height, toAnchor);
     }, [onChangeCharts, createHistory]);
 };

package/dist/esm/index.d.ts

@@ -2,11 +2,22 @@ export * from "./hooks/use-charts";
 export * from "./components/dialogs/chart-editor-dialog";
 export * from "./components/editors/chart-editor";
 export * from "./basic-chart";
+export { canSwitchRowColumn, deriveChartSeriesFromRange, inferSeriesOrientation, pickSeriesOrientationForRange, switchRowColumn, } from "./utils/chart-orientation";
+export type { ChartCellLabelGetter, SeriesOrientation, } from "./utils/chart-orientation";
+export { applyEmptyCellsPolicy, connectsAcrossEmptyCells, getEmptyCellsPolicy, } from "./utils/empty-cells";
+export type { EmptyCellsPolicy } from "./utils/empty-cells";
 export { registerChartGeoMap } from "./utils/region-map-loader";
 export * from "./interface/create-chart";
 export * from "./interface/delete-chart";
 export * from "./interface/move-chart";
+export * from "./interface/move-chart-to-sheet";
+export * from "./hooks/use-on-move-chart-to-sheet";
 export * from "./interface/resize-chart";
 export * from "./interface/shift-chart-ranges";
 export * from "./interface/update-chart";
+export { applyChartColorPalette, applyChartQuickLayout, applyChartStyle, CHART_COLOR_PALETTES, CHART_QUICK_LAYOUTS, CHART_STYLES, getChartPalette, resetChartToMatchStyle, } from "./utils/chart-styles";
+export type { ChartColorPalette, ChartQuickLayout, ChartStylePreset, } from "./utils/chart-styles";
+export * from "./components/dialogs/pivot-chart-dialog";
+export { pivotChartRequestAtom, usePivotChartRequest, useSetPivotChartRequest, } from "./atoms/pivot-chart.atom";
+export type { PivotChartRequest } from "./atoms/pivot-chart.atom";
 //# sourceMappingURL=index.d.ts.map

package/dist/esm/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,0CAA0C,CAAC;AACzD,cAAc,mCAAmC,CAAC;AAClD,cAAc,eAAe,CAAC;AAI9B,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAGhE,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC;AACzC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,0BAA0B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,0CAA0C,CAAC;AACzD,cAAc,mCAAmC,CAAC;AAClD,cAAc,eAAe,CAAC;AAI9B,OAAO,EACL,kBAAkB,EAClB,0BAA0B,EAC1B,sBAAsB,EACtB,6BAA6B,EAC7B,eAAe,GAChB,MAAM,2BAA2B,CAAC;AACnC,YAAY,EACV,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,qBAAqB,EACrB,wBAAwB,EACxB,mBAAmB,GACpB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAI5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAGhE,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,iCAAiC,CAAC;AAChD,cAAc,oCAAoC,CAAC;AACnD,cAAc,0BAA0B,CAAC;AACzC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,0BAA0B,CAAC;AAKzC,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,eAAe,EACf,oBAAoB,EACpB,mBAAmB,EACnB,YAAY,EACZ,eAAe,EACf,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,sBAAsB,CAAC;AAI9B,cAAc,yCAAyC,CAAC;AACxD,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,uBAAuB,GACxB,MAAM,0BAA0B,CAAC;AAClC,YAAY,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/esm/index.js

@@ -2,6 +2,10 @@ export * from "./hooks/use-charts";
 export * from "./components/dialogs/chart-editor-dialog";
 export * from "./components/editors/chart-editor";
 export * from "./basic-chart";
+// Series orientation (Excel's Switch Row/Column) and the "Hidden and
+// Empty Cells" policy — pure spec utilities hosts can drive themselves.
+export { canSwitchRowColumn, deriveChartSeriesFromRange, inferSeriesOrientation, pickSeriesOrientationForRange, switchRowColumn, } from "./utils/chart-orientation";
+export { applyEmptyCellsPolicy, connectsAcrossEmptyCells, getEmptyCellsPolicy, } from "./utils/empty-cells";
 // Region-map (filled map / choropleth) host API — register additional
 // geo scopes (e.g. a US-states GeoJSON) for `chartType: "regionMap"`.
 export { registerChartGeoMap } from "./utils/region-map-loader";
@@ -9,6 +13,16 @@ export { registerChartGeoMap } from "./utils/region-map-loader";
 export * from "./interface/create-chart";
 export * from "./interface/delete-chart";
 export * from "./interface/move-chart";
+export * from "./interface/move-chart-to-sheet";
+export * from "./hooks/use-on-move-chart-to-sheet";
 export * from "./interface/resize-chart";
 export * from "./interface/shift-chart-ranges";
 export * from "./interface/update-chart";
+// Excel's Chart Design tab as spec transforms — Chart Styles, Change
+// Colors, Quick Layouts, Reset to Match Style — and the palette both
+// renderers resolve series colours through.
+export { applyChartColorPalette, applyChartQuickLayout, applyChartStyle, CHART_COLOR_PALETTES, CHART_QUICK_LAYOUTS, CHART_STYLES, getChartPalette, resetChartToMatchStyle, } from "./utils/chart-styles";
+// Excel's Insert → PivotChart: the pick-a-pivot dialog and the request atom
+// hosts drive it with (#668 C-23).
+export * from "./components/dialogs/pivot-chart-dialog";
+export { pivotChartRequestAtom, usePivotChartRequest, useSetPivotChartRequest, } from "./atoms/pivot-chart.atom";

package/dist/esm/interface/create-chart.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-chart.d.ts","sourceRoot":"","sources":["../../../interface/create-chart.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAClE,OAAO,EACL,KAAK,QAAQ,EACb,mBAAmB,EACnB,aAAa,EAKd,MAAM,2BAA2B,CAAC;AAInC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAa1E;;GAEG;AACH,eAAO,MAAM,mBAAmB,GAC9B,UAAU,MAAM,GAAG,SAAS,EAC5B,UAAU,MAAM,KACf,MAAkF,CAAC;AAEtF,eAAO,MAAM,WAAW,GAAI,CAAC,SAAS,QAAQ,EAAE,8FAM7C,qBAAqB,CAAC,CAAC,CAAC,MAEvB,SAAS,MAAM,EACf,YAAY,aAAa,EACzB,YAAY,aAAa,CAAC,mBAAmB,CAAC,EAAE,EAChD,YAAY,aAAa,kBAyJ5B,CAAC"}
+{"version":3,"file":"create-chart.d.ts","sourceRoot":"","sources":["../../../interface/create-chart.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAClE,OAAO,EACL,KAAK,QAAQ,EACb,mBAAmB,EACnB,aAAa,EAKd,MAAM,2BAA2B,CAAC;AAInC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAiB1E;;GAEG;AACH,eAAO,MAAM,mBAAmB,GAC9B,UAAU,MAAM,GAAG,SAAS,EAC5B,UAAU,MAAM,KACf,MAAkF,CAAC;AAEtF,eAAO,MAAM,WAAW,GAAI,CAAC,SAAS,QAAQ,EAAE,8FAM7C,qBAAqB,CAAC,CAAC,CAAC,MAEvB,SAAS,MAAM,EACf,YAAY,aAAa,EACzB,YAAY,aAAa,CAAC,mBAAmB,CAAC,EAAE,EAChD,YAAY,aAAa,kBAuH5B,CAAC"}