@sheetpane/charts 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Arpit Arya
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,128 @@
-# Temporary Holding Version
+# @sheetpane/charts
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+**Charts for sheetpane — each chart in a workbook shown at its anchor: a frame with its title, type, series count and Show source cells (stage 1), drawn as our own SVG for bar, column, line, pie and scatter (stage 2) — through the `overlay` hook.**
+
+A plugin: it registers against the one in-memory workbook of `@sheetpane/grid`
+(`createWorkbook({ plugins: [...] })`, or `plugins="charts"` on the element), so
+`<sheetpane-excel>` and `<sheetpane-errors>` both see its effect. Versioned in
+lockstep with `@sheetpane/grid`.
+
+```ts
+import { createWorkbook } from '@sheetpane/grid';
+import { charts } from '@sheetpane/charts';
+import { ui } from '@sheetpane/charts/ui';
+
+el.workbook = createWorkbook({ plugins: [charts(), ui()] });
+// stage 1 only (frames, no plot):  charts({ draw: false })
+// or: import '@sheetpane/charts/ui'  and  <sheetpane-excel plugins="charts">
+```
+
+- `@sheetpane/charts` — the headless plugin: the `overlay` provider.
+- `@sheetpane/charts/ui` — the status line and a keyboard shortcut; opt-in.
+
+No runtime dependencies, no chart library. Importing is safe in Node: nothing touches the DOM
+until a chart renders.
+
+## The frame (stage 1)
+
+Every `graphicFrame` in a sheet's drawing that holds a chart (`c:chart r:id` → the chart part)
+becomes one overlay item at its anchor, scrolling and zooming with its cells. The frame shows:
+
+- the **title** — `c:title` rich text (runs joined, paragraphs joined by a space), a title
+  reference's cached text, the only series' name when the title has no text, else `Chart`;
+- the **type and series count** — `column · 2 series`, `stacked bar · 3 series`,
+  `100% stacked column`, `line`, `pie`, `doughnut`, `scatter`, `area`, `radar`, `3-D column`,
+  `column + line` (a combination) …;
+- **Show source cells** — selects the plotted cells (see below), in View and in Edit;
+- **data changed — Excel will redraw**, once a user change (`value` or `formula`) lands in a
+  cell the chart reads — a series' values, categories or name. Undo takes it away again.
+
+A chart that is not drawn lists `Not drawn here: area chart.` and, per series, the cells it
+reads: `Sales — Data!A2:A5, Data!B2:B5`.
+
+**Show source cells** selects the union of the series' `c:f` ranges when they tile one
+rectangle (categories in A, values in B and C → `A2:C5`). The grid's selection is one
+rectangle, so ranges that do not tile one (categories in E, values in H) select the first
+series' values. A chart whose data is literal (`c:numLit`, no `c:f`) has nothing to select and
+its button is disabled.
+
+In Edit, a click on the chart away from its button selects the cell under the click, so that
+cell can be flagged — as pictures do.
+
+## The drawing (stage 2)
+
+| type | drawn |
+|---|---|
+| `c:barChart`, `c:barDir="col"` | column — clustered, stacked or 100 % stacked |
+| `c:barChart`, `c:barDir="bar"` | bar — the same groupings; the first category at the bottom, as in Excel |
+| `c:lineChart` | line — standard, stacked or 100 % stacked; a missing point breaks the line |
+| `c:pieChart`, `c:doughnutChart` | pie and doughnut — the first series, clockwise from `c:firstSliceAng` (12 o'clock) |
+| `c:scatterChart` | scatter — x from `c:xVal` (text x values plot at 1, 2, 3 … as in Excel); lines when the style and the series' line say so |
+
+Everything else — area, radar, stock, surface, bubble, 3-D, pie-of-pie, combination charts and
+pivot charts — stays a stage-1 frame.
+
+The SVG has a title band, a value axis with "nice" ticks (1, 2, 2.5 or 5 × 10ⁿ; zero included
+unless the data sit in a narrow band far from it, as Excel does), category labels thinned so
+they do not overlap, and a legend where the chart has one (`c:legend`: right, or bottom when
+`legendPos` is top or bottom, or the chart is narrow). A negative bar is drawn in the error red
+(the design board). Percent axes follow a `%` in the value axis' number format.
+
+**Colours** come from the series' explicit fill (`c:spPr/a:solidFill` — `a:srgbClr`,
+`a:schemeClr` through the workbook theme, `a:sysClr`, with `lumMod`, `lumOff`, `tint`,
+`shade`), a line chart's line colour, per-point fills (`c:dPt`), else Excel's default style:
+the theme's accents 1–6 by series index (`c:idx`) — or by point for `varyColors` pies — then
+darker and lighter rounds. A workbook without a theme gets Office's accents.
+
+**Values** are the series' cached points (`c:numCache`, `c:strCache`): what Excel drew when the
+file was saved. With a `derive` plugin on the pane (`@sheetpane/formulas`), the chart reads the
+live cells instead (`store.value`, `store.text` for labels) and redraws as they change; the SVG
+carries `data-values="live"` or `"cache"`. Without one, an edit leaves the drawing as Excel
+saved it, and the tag says so.
+
+The SVG uses a `viewBox` the size of the anchor at 100 % and fills the item, so it scales with
+zoom exactly as the cells do. Every mark carries what it stands for (`data-series`,
+`data-point`, `data-value`; slices `data-start`/`data-end` in degrees), so tests compare the
+drawing with the values rather than with pixels. No font is named anywhere (SR-LAW-5): the text
+is the host's. Text from the file is escaped; colours from the file are validated `#RRGGBB`.
+
+## Names
+
+The item is `role="img"`; its `aria-label` is the chart's title once the part is read (the
+drawing's description or name before that), and the SVG carries the same `role`, `aria-label`
+and `<title>`.
+
+## `@sheetpane/charts/ui`
+
+- **Status line:** `Chart source: Data!A2:A5, Data!B2:B5, Data!C2:C5` while the selection lies in
+  a chart's plotted cells or under its frame; otherwise `2 charts` on a sheet that has some.
+- **Mod+Shift+U** shows the source of the chart over the active cell, or of the sheet's only
+  chart — listed in the grid's keyboard help. The frame's own button sits inside the grid's
+  `role="img"` overlay wrapper, where assistive technology does not reach it; the shortcut is the
+  accessible route to the same action.
+
+There is no `selbar` button: a selbar control has no "applies here" test, so it would show on
+every selection, chart or not.
+
+## Export
+
+Nothing. Patch-mode export copies the chart parts byte for byte, so Excel redraws each chart
+from the (possibly changed) cells when the file is opened.
+
+## Limits
+
+- **Placement uses the grid's geometry** (28 px rows, every row and column shown), as pictures
+  do — not Excel's row heights. Past the last column the grid draws, columns count 64 px each.
+- One rectangle per selection (above). Data labels, trendlines, error bars, axis titles,
+  secondary axes, log scales and date axes are not drawn.
+- Only charts on worksheets; chartsheets hold no cells and are not read.
+- No chart is ever edited: no type switcher, no series editor, no resize.
+
+## Dependencies
+
+Anchors are placed with `@sheetpane/images`' `anchorRect` and `cellAt` (SR-IMAGES decision 3); `@sheetpane/images` is a peer.
+
+Spec: [`work/open/W-21-charts.md`](../../work/open/W-21-charts.md).
+How plugins plug in: [`work/compare/plugins.compare.md`](../../work/compare/plugins.compare.md).
+
+**Using an AI coding agent?** `npx sheetpane-skills install` puts sheetpane's skills for Claude Code, Kiro and Codex into your repository.

package/dist/anchors.d.ts

@@ -0,0 +1,42 @@
+import type { Geometry } from '@sheetpane/grid';
+export declare const EMU_PER_PX = 9525;
+export interface AnchorPoint {
+    col: number;
+    colOff: number;
+    row: number;
+    rowOff: number;
+}
+export interface Anchor {
+    anchor: 'twoCell' | 'oneCell' | 'absolute';
+    from?: AnchorPoint;
+    to?: AnchorPoint;
+    ext?: {
+        cx: number;
+        cy: number;
+    };
+    pos?: {
+        x: number;
+        y: number;
+    };
+}
+export interface Rect {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+/** The rectangle an anchor covers, or `undefined` when the anchor lacks what its kind needs. */
+export declare function anchorRect(a: Anchor, g: Geometry): Rect | undefined;
+/** The zero-based cell under a point in sheet space (px at 100 %). */
+export declare function cellAt(g: Geometry, x: number, y: number): {
+    row: number;
+    col: number;
+};
+/**
+ * The grid's `Geometry` stops at the last column it draws: past it, `colX` returns that column's
+ * edge for every index while `colWidth` says 64 px. A chart is often anchored to the right of the
+ * data, so columns past the edge are extended here at 64 px each — what the grid's own fallback
+ * intends. A geometry that keeps growing is returned as it is.
+ */
+export declare function extendColumns(g: Geometry): Geometry;
+//# sourceMappingURL=anchors.d.ts.map

package/dist/anchors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anchors.d.ts","sourceRoot":"","sources":["../src/anchors.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAEhD,eAAO,MAAM,UAAU,OAAO,CAAC;AAG/B,MAAM,WAAW,WAAW;IAAG,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE;AACzF,MAAM,WAAW,MAAM;IACrB,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,UAAU,CAAC;IAC3C,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,EAAE,CAAC,EAAE,WAAW,CAAC;IACjB,GAAG,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IACjC,GAAG,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAChC;AACD,MAAM,WAAW,IAAI;IAAG,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE;AAY7E,gGAAgG;AAChG,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,QAAQ,GAAG,IAAI,GAAG,SAAS,CAenE;AAWD,sEAAsE;AACtE,wBAAgB,MAAM,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAEtF;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAYnD"}

package/dist/anchors.js

@@ -0,0 +1,73 @@
+export const EMU_PER_PX = 9525;
+const emuToPx = (emu) => emu / EMU_PER_PX;
+const clamp = (v, lo, hi) => Math.min(Math.max(v, lo), hi);
+const finite = (n) => (Number.isFinite(n) ? n : 0);
+function pointToPx(g, p) {
+    return {
+        x: g.colX(p.col) + clamp(emuToPx(finite(p.colOff)), 0, g.colWidth(p.col)),
+        y: g.rowY(p.row) + clamp(emuToPx(finite(p.rowOff)), 0, g.rowHeight(p.row)),
+    };
+}
+/** The rectangle an anchor covers, or `undefined` when the anchor lacks what its kind needs. */
+export function anchorRect(a, g) {
+    if (a.anchor === 'twoCell') {
+        if (!a.from || !a.to)
+            return undefined;
+        const p0 = pointToPx(g, a.from), p1 = pointToPx(g, a.to);
+        return { x: Math.min(p0.x, p1.x), y: Math.min(p0.y, p1.y), width: Math.abs(p1.x - p0.x), height: Math.abs(p1.y - p0.y) };
+    }
+    if (!a.ext)
+        return undefined;
+    const width = emuToPx(finite(a.ext.cx)), height = emuToPx(finite(a.ext.cy));
+    if (a.anchor === 'oneCell') {
+        if (!a.from)
+            return undefined;
+        const p = pointToPx(g, a.from);
+        return { x: p.x, y: p.y, width, height };
+    }
+    if (!a.pos)
+        return undefined;
+    return { x: emuToPx(finite(a.pos.x)), y: emuToPx(finite(a.pos.y)), width, height };
+}
+function indexAt(at, v, max) {
+    let lo = 0, hi = max - 1;
+    while (lo < hi) {
+        const mid = (lo + hi + 1) >> 1;
+        if (at(mid) <= v)
+            lo = mid;
+        else
+            hi = mid - 1;
+    }
+    return lo;
+}
+/** The zero-based cell under a point in sheet space (px at 100 %). */
+export function cellAt(g, x, y) {
+    return { col: indexAt((c) => g.colX(c), Math.max(0, x), 16384), row: indexAt((r) => g.rowY(r), Math.max(0, y), 1048576) };
+}
+/**
+ * The grid's `Geometry` stops at the last column it draws: past it, `colX` returns that column's
+ * edge for every index while `colWidth` says 64 px. A chart is often anchored to the right of the
+ * data, so columns past the edge are extended here at 64 px each — what the grid's own fallback
+ * intends. A geometry that keeps growing is returned as it is.
+ */
+export function extendColumns(g) {
+    const flat = (c) => g.colX(c + 1) <= g.colX(c);
+    if (!flat(16383))
+        return g;
+    let lo = 0, hi = 16383; // the first column whose right edge does not move
+    while (lo < hi) {
+        const mid = (lo + hi) >> 1;
+        if (flat(mid))
+            hi = mid;
+        else
+            lo = mid + 1;
+    }
+    const edge = lo, x = g.colX(edge);
+    return {
+        colX: (c) => (c <= edge ? g.colX(c) : x + (c - edge) * 64),
+        colWidth: (c) => (c < edge ? g.colWidth(c) : 64),
+        rowY: (r) => g.rowY(r),
+        rowHeight: (r) => g.rowHeight(r),
+    };
+}
+//# sourceMappingURL=anchors.js.map

package/dist/anchors.js.map

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

package/dist/colors.d.ts

@@ -0,0 +1,48 @@
+/** Office's default accents, for a workbook whose theme names none. */
+export declare const OFFICE_ACCENTS: readonly ['4472C4', 'ED7D31', 'A5A5A5', 'FFC000', '5B9BD5', '70AD47'];
+/** A colour element as the model keeps it, before the theme resolves it. */
+export interface ColorSpec {
+    kind: 'srgb' | 'scheme' | 'sys';
+    val: string;
+    mods: {
+        name: string;
+        val: number;
+    }[];
+}
+/**
+ * The theme's six accents, Office's where the workbook has none.
+ *
+ * @param themeColors - The workbook's theme colours by SpreadsheetML index (accents at 4–9), `RRGGBB`.
+ * @returns Six `RRGGBB` accents.
+ */
+export declare function accents(themeColors: readonly string[]): string[];
+/**
+ * Applies DrawingML colour modifiers: `lumMod` / `lumOff` in HSL, then `shade` and `tint` (values in 1/1000 of a
+ * percent: 75000 = 75 %). Other modifiers are ignored.
+ *
+ * @param hex - The base colour, `RRGGBB`.
+ * @param mods - The modifiers in file order, each `{ name, val }`.
+ * @returns The modified colour, `RRGGBB`.
+ */
+export declare function modify(hex: string, mods: readonly {
+    name: string;
+    val: number;
+}[]): string;
+/**
+ * Resolves a chart colour (`srgbClr`, `schemeClr`, `sysClr` with its modifiers) to `#RRGGBB`.
+ *
+ * @param c - The colour spec, or `undefined`.
+ * @param themeColors - The workbook's theme colours, for a scheme colour.
+ * @returns `#RRGGBB`, or `undefined` when it names nothing this resolver knows.
+ */
+export declare function resolveColor(c: ColorSpec | undefined, themeColors: readonly string[]): string | undefined;
+/**
+ * The colour Excel's default chart style gives the n-th series (or pie slice) when the part
+ * names none: accents 1–6, then the same six darker, then lighter.
+ *
+ * @param n - The series' `c:idx` (or the slice's index).
+ * @param themeColors - The workbook's theme colours.
+ * @returns `#RRGGBB`.
+ */
+export declare function defaultColor(n: number, themeColors: readonly string[]): string;
+//# sourceMappingURL=colors.d.ts.map

package/dist/colors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"colors.d.ts","sourceRoot":"","sources":["../src/colors.ts"],"names":[],"mappings":"AAGA,uEAAuE;AACvE,eAAO,MAAM,cAAc,YAAI,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAU,CAAC;AAEpG,4EAA4E;AAC5E,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACvC;AAWD;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE,CAEhE;AAoCD;;;;;;;GAOG;AACH,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,EAAE,GAAG,MAAM,CAc1F;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,SAAS,GAAG,SAAS,EAAE,WAAW,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,GAAG,SAAS,CAIzG;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAI9E"}

package/dist/colors.js

@@ -0,0 +1,115 @@
+// DrawingML colours → `#RRGGBB`. Pure, no DOM: `srgbClr`, `schemeClr` (through the workbook
+// theme) and `sysClr` with the modifiers Excel writes most (`lumMod`, `lumOff`, `tint`, `shade`).
+/** Office's default accents, for a workbook whose theme names none. */
+export const OFFICE_ACCENTS = ['4472C4', 'ED7D31', 'A5A5A5', 'FFC000', '5B9BD5', '70AD47'];
+/** DrawingML scheme names → SpreadsheetML theme index (0 lt1, 1 dk1, 2 lt2, 3 dk2, 4–9 accents, 10 hlink, 11 folHlink). */
+const SCHEME = {
+    lt1: 0, bg1: 0, dk1: 1, tx1: 1, lt2: 2, bg2: 2, dk2: 3, tx2: 3,
+    accent1: 4, accent2: 5, accent3: 6, accent4: 7, accent5: 8, accent6: 9, hlink: 10, folHlink: 11,
+};
+const SCHEME_FALLBACK = { 0: 'FFFFFF', 1: '000000', 2: 'E7E6E6', 3: '44546A', 10: '0563C1', 11: '954F72' };
+const hex6 = (s) => (s && /^[0-9A-Fa-f]{6}$/.test(s) ? s.toUpperCase() : undefined);
+/**
+ * The theme's six accents, Office's where the workbook has none.
+ *
+ * @param themeColors - The workbook's theme colours by SpreadsheetML index (accents at 4–9), `RRGGBB`.
+ * @returns Six `RRGGBB` accents.
+ */
+export function accents(themeColors) {
+    return OFFICE_ACCENTS.map((d, i) => hex6(themeColors[4 + i]) ?? d);
+}
+function themeColor(themeColors, name) {
+    const i = SCHEME[name];
+    if (i === undefined)
+        return undefined;
+    if (i >= 4 && i <= 9)
+        return accents(themeColors)[i - 4];
+    return hex6(themeColors[i]) ?? SCHEME_FALLBACK[i];
+}
+function toRgb(h) {
+    return [parseInt(h.slice(0, 2), 16), parseInt(h.slice(2, 4), 16), parseInt(h.slice(4, 6), 16)];
+}
+const toHex = (rgb) => rgb.map((v) => Math.round(Math.min(255, Math.max(0, v))).toString(16).padStart(2, '0')).join('').toUpperCase();
+function rgbToHsl([r, g, b]) {
+    r /= 255;
+    g /= 255;
+    b /= 255;
+    const max = Math.max(r, g, b), min = Math.min(r, g, b), l = (max + min) / 2;
+    if (max === min)
+        return [0, 0, l];
+    const d = max - min, s = l > 0.5 ? d / (2 - max - min) : d / (max + min);
+    const h = max === r ? (g - b) / d + (g < b ? 6 : 0) : max === g ? (b - r) / d + 2 : (r - g) / d + 4;
+    return [h / 6, s, l];
+}
+function hslToRgb([h, s, l]) {
+    if (s === 0)
+        return [l * 255, l * 255, l * 255];
+    const q = l < 0.5 ? l * (1 + s) : l + s - l * s, p = 2 * l - q;
+    const f = (t) => {
+        if (t < 0)
+            t += 1;
+        if (t > 1)
+            t -= 1;
+        if (t < 1 / 6)
+            return p + (q - p) * 6 * t;
+        if (t < 1 / 2)
+            return q;
+        if (t < 2 / 3)
+            return p + (q - p) * (2 / 3 - t) * 6;
+        return p;
+    };
+    return [f(h + 1 / 3) * 255, f(h) * 255, f(h - 1 / 3) * 255];
+}
+/**
+ * Applies DrawingML colour modifiers: `lumMod` / `lumOff` in HSL, then `shade` and `tint` (values in 1/1000 of a
+ * percent: 75000 = 75 %). Other modifiers are ignored.
+ *
+ * @param hex - The base colour, `RRGGBB`.
+ * @param mods - The modifiers in file order, each `{ name, val }`.
+ * @returns The modified colour, `RRGGBB`.
+ */
+export function modify(hex, mods) {
+    let rgb = toRgb(hex);
+    const lumMod = mods.find((m) => m.name === 'lumMod'), lumOff = mods.find((m) => m.name === 'lumOff');
+    if (lumMod || lumOff) {
+        const hsl = rgbToHsl(rgb);
+        hsl[2] = Math.min(1, Math.max(0, hsl[2] * ((lumMod?.val ?? 100000) / 100000) + (lumOff?.val ?? 0) / 100000));
+        rgb = hslToRgb(hsl);
+    }
+    for (const m of mods) {
+        const k = m.val / 100000;
+        if (m.name === 'shade')
+            rgb = rgb.map((v) => v * k);
+        else if (m.name === 'tint')
+            rgb = rgb.map((v) => v + (255 - v) * (1 - k));
+    }
+    return toHex(rgb);
+}
+/**
+ * Resolves a chart colour (`srgbClr`, `schemeClr`, `sysClr` with its modifiers) to `#RRGGBB`.
+ *
+ * @param c - The colour spec, or `undefined`.
+ * @param themeColors - The workbook's theme colours, for a scheme colour.
+ * @returns `#RRGGBB`, or `undefined` when it names nothing this resolver knows.
+ */
+export function resolveColor(c, themeColors) {
+    if (!c)
+        return undefined;
+    const base = c.kind === 'srgb' ? hex6(c.val) : c.kind === 'scheme' ? themeColor(themeColors, c.val) : hex6(c.val);
+    return base ? `#${modify(base, c.mods)}` : undefined;
+}
+/**
+ * The colour Excel's default chart style gives the n-th series (or pie slice) when the part
+ * names none: accents 1–6, then the same six darker, then lighter.
+ *
+ * @param n - The series' `c:idx` (or the slice's index).
+ * @param themeColors - The workbook's theme colours.
+ * @returns `#RRGGBB`.
+ */
+export function defaultColor(n, themeColors) {
+    const a = accents(themeColors)[n % 6], round = Math.floor(n / 6) % 3;
+    if (round === 0)
+        return `#${a}`;
+    return `#${modify(a, round === 1 ? [{ name: 'lumMod', val: 60000 }] : [{ name: 'lumMod', val: 80000 }, { name: 'lumOff', val: 20000 }])}`;
+}
+//# sourceMappingURL=colors.js.map

package/dist/colors.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,142 @@
+import { type Geometry, type OverlayItem, type Plugin, type PluginContext, type Snapshot } from '@sheetpane/grid';
+import { type ChartModel } from './model.js';
+import { type SourceRange } from './refs.js';
+import { type PlotData } from './svg.js';
+export { parseChart } from './model.js';
+export type { ChartModel, SeriesModel, GroupModel, DataRef, DrawKind, Grouping } from './model.js';
+export { parseFormulaRefs, selectionFor, qualified, cellsOf, type SourceRange } from './refs.js';
+export { resolveColor, defaultColor, accents, modify, OFFICE_ACCENTS, type ColorSpec } from './colors.js';
+export { drawChart, frameSvg, niceScale, stackedValues, formatNumber, withZero, HEAD, CHANGED_TAG, type PlotData, type PlotSeries, type Scale } from './svg.js';
+/** The plugin's id, and the name `plugins="…"` takes. */
+export declare const PLUGIN_ID = "charts";
+type Book = PluginContext['book'];
+type Store = PluginContext['store'];
+type Drawing = Book['sheets'][number]['drawings'][number];
+/** Options for {@link charts}. */
+export interface ChartsOptions {
+    /** `false` keeps every chart a stage-1 frame (no SVG plot). Default `true`. */
+    draw?: boolean;
+}
+/**
+ * The parsed chart part, read through `book.part()` on first ask and cached per workbook.
+ *
+ * @param book - The workbook.
+ * @param path - The chart part's path, e.g. `xl/charts/chart1.xml`.
+ * @returns The model; `undefined` when the part is missing or unreadable.
+ */
+export declare function chartModel(book: Book, path: string): Promise<ChartModel | undefined>;
+/**
+ * The chart model if it is parsed already, without reading anything.
+ *
+ * @param book - The workbook.
+ * @param path - The chart part's path.
+ * @returns The model, `null` (unreadable) or `undefined` (not read yet).
+ */
+export declare function chartModelNow(book: Book, path: string): ChartModel | null | undefined;
+/**
+ * The chart drawings of a sheet, with their index among the sheet's drawings.
+ *
+ * @param book - The workbook, or `undefined`.
+ * @param sheet - The sheet's name.
+ * @returns One `{ drawing, index, path }` per chart; empty for none.
+ */
+export declare function chartsOn(book: Book | undefined, sheet: string): {
+    drawing: Drawing;
+    index: number;
+    path: string;
+}[];
+/** True when the pane computes formulas (a `derive` plugin), so the cells are live. */
+export declare const isLive: (store: Store) => boolean;
+/**
+ * What stage 2 draws: the chart's one group, its series coloured and valued — the cached points, or the live cells
+ * when `live` and the ranges are readable.
+ *
+ * @param m - The chart model.
+ * @param book - The workbook (its theme and sheets).
+ * @param store - The store, for live values; `undefined` uses the cache.
+ * @param live - Whether the pane computes formulas (a `derive` plugin), so the cells are current.
+ * @returns The plot data, or `undefined` when the chart is not drawable.
+ */
+export declare function plotData(m: ChartModel, book: Book, store: Store | undefined, live: boolean): PlotData | undefined;
+/**
+ * Whether a user changed a value inside one of the ranges (snapshot `changes`, kinds `value` and `formula`).
+ *
+ * @param snap - A snapshot of the store.
+ * @param ranges - The ranges a chart reads.
+ * @returns `true` when at least one such change lies in them.
+ */
+export declare function changedInside(snap: Snapshot, ranges: readonly SourceRange[]): boolean;
+/**
+ * The chart's plotted ranges that exist in this workbook, as one selection (see {@link selectionFor}).
+ *
+ * @param m - The chart model.
+ * @param book - The workbook.
+ * @returns A selection for `store.select()`, or `undefined` when the data is literal or names no sheet here.
+ */
+export declare function sourceSelection(m: ChartModel, book: Book): {
+    sheet: string;
+    ref: string;
+    range?: string;
+} | undefined;
+/**
+ * Shows a chart's source: selects the union of its plotted ranges (or the first one — see {@link selectionFor}).
+ *
+ * @param store - The workbook store.
+ * @param m - The chart model.
+ * @returns `true` when something was selected; `false` when there was nothing to select.
+ */
+export declare function showSource(store: Store, m: ChartModel): boolean;
+/** `bar · 2 series`. */
+export declare const metaOf: (m: ChartModel) => string;
+/**
+ * The chart whose frame covers the middle of a cell (the topmost), once the grid has drawn that sheet.
+ *
+ * @param book - The workbook, or `undefined`.
+ * @param sheet - The sheet's name.
+ * @param row - The cell's row, 0-based.
+ * @param col - The cell's column, 0-based.
+ * @returns `{ path, index }` of the chart, or `undefined`.
+ */
+export declare function chartAt(book: Book | undefined, sheet: string, row: number, col: number): {
+    path: string;
+    index: number;
+} | undefined;
+/**
+ * The chart items of one sheet, with their rectangles in sheet space: one item per chart drawing with an area.
+ *
+ * @param sheet - The sheet's name.
+ * @param ctx - The plugin context with the grid's geometry, as the `overlay` hook receives it.
+ * @param o - The plugin's options (`draw: false` keeps every chart a frame).
+ * @returns The overlay items.
+ */
+export declare function chartItems(sheet: string, ctx: PluginContext & {
+    geometry: Geometry;
+}, o?: ChartsOptions): OverlayItem[];
+/**
+ * The charts plugin: draws each chart of the workbook at its anchor through the `overlay` hook, view only. Every
+ * chart gets a frame with its title, type and series count and a Show source cells button; bar, column, line, pie,
+ * doughnut and scatter charts are drawn as SVG (no chart library, no font named), from the cached points or, with a
+ * `derive` plugin such as `@sheetpane/formulas`, the live cells. A "data changed — Excel will redraw" tag shows once a
+ * plotted cell is edited. Export copies the chart parts unchanged. Importing this module registers it as `charts`;
+ * add `ui()` from `@sheetpane/charts/ui` for the status line and the shortcut.
+ *
+ * @param o - `draw: false` keeps every chart a frame.
+ * @returns The plugin (`id: 'charts'`).
+ * @see https://github.com/arpitarya/sheetpane/blob/main/records/0113_CHARTS.md
+ * @example
+ * ```ts
+ * import { createWorkbook } from '@sheetpane/grid';
+ * import { charts } from '@sheetpane/charts';
+ * import { formulas } from '@sheetpane/formulas';
+ *
+ * const book = createWorkbook({ plugins: [charts(), formulas()] });
+ * await book.load(bytes, 'dashboard.xlsx');
+ * ```
+ * @example
+ * ```ts
+ * import '@sheetpane/charts'; // registers `charts`
+ * excel.setAttribute('plugins', 'charts');
+ * ```
+ */
+export declare function charts(o?: ChartsOptions): Plugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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