@sheetxl/sdk 0.8.0-beta.11 → 0.8.0-beta.13

package/types/src/chart/_ChartSource.d.ts

@@ -15,14 +15,6 @@ export declare function newChartType(type: IChart.Type | string | undefined): Ne
 export declare const toFormatCode: (format: string, locale?: string) => string;
 /** A range as a chart's formula names it: sheet-qualified and absolute. */
 export declare const formulaOfRange: (range: ICellRange) => string;
-/**
- * What a series setter's input states for a dimension: an array constant as values written into the
- * chart, else a reference. Values are always numbers (`numRef`); categories are numbers when every
- * cell they name holds a number or a date, two lines deep a multi-level reference, else text, as a
- * new chart states them (DESIGN-CHART §3.5).
- *
- * @param host The sheet a bare address is on.
- */
 export declare function sourceFromInput(input: ICellRange | string, dimension: 'values' | 'categories', host: IWorksheet): ChartModel.DataSource;
 /** How many cells (or array values) a setter's input names; 0 where it names none. */
 export declare function cellCountOf(input: ICellRange | string, host: IWorksheet | null): number;
@@ -37,11 +29,5 @@ export declare function categoriesFromInput(input: ICellRange | string, host: IW
     source: ChartModel.DataSource;
     axis: CategoryAxisFields | null;
 };
-/**
- * The series of a chart of `type` over `source`, and the chart's model, as Excel makes a new chart
- * (DESIGN-CHART §3.5).
- *
- * @param host The sheet a bare address is on.
- */
 export declare function createModelFromSource(type: NewChartType, source: ICellRange | ICellRanges | string, host: IWorksheet, seriesBy?: IChart.SeriesBy): ChartModel.ChartSpace;
 //# sourceMappingURL=_ChartSource.d.ts.map

package/types/src/chart/createChart.d.ts

@@ -20,7 +20,7 @@ export interface CreateChartOptions {
  * of {@link IChart} works, `getLayout` lays it out at a size, and `@sheetxl/react`'s `ChartElement`
  * draws it. Its writes are not undoable: it has no transaction store.
  *
- * The chart's code is loaded with the first chart, so this is asynchronous (DESIGN-CHART §7).
+ * The chart's code is loaded with the first chart, so this is asynchronous.
  */
 export declare function createChart(json: IChart.JSON, options?: CreateChartOptions): Promise<IChart>;
 //# sourceMappingURL=createChart.d.ts.map

package/types/src/chart/kinds/ChartKind.d.ts

@@ -15,8 +15,8 @@ import { DateSlots } from '../math/DateUnitCalcs';
  * asks each group's kind for the group: where its bars, points, slices or whatever it draws go.
  *
  * @beta The context a kind is given speaks the layout's frame units today: points from the frame's
- * origin, as the layout works in them (DESIGN-CHART §4), with `at` and `px` to convert. It will
- * speak px, as {@link ChartLayout} does, before the contract is settled.
+ * origin, as the layout works in them, with `at` and `px` to convert. This may change to px, as
+ * {@link ChartLayout} uses, while the API is in beta.
  *
  * `coordinates` says what the chrome lays out for the kind: `cartesian`, a pair of axes
  * (category and value, or a scatter's two value axes) whose scales are fit to what
@@ -177,7 +177,7 @@ export declare namespace ChartKind {
         xOfValue(scale: ValueScale, axis: ResolvedChart.Axis, value: number): number;
         /** The series layout every kind states: id, name, values, slots, fill, stroke and trendlines. */
         base(series: ResolvedChart.Series): Omit<ChartLayout.SeriesLayout, 'marker'>;
-        /** A line or area group's up/down bars, high-low lines and drop lines (DESIGN-CHART §4.7). */
+        /** A line or area group's up/down bars, high-low lines and drop lines. */
         analysisLines(scale: ValueScale, tops: (number | null)[][], baseValue: number): Pick<ChartLayout.LineGroupLayout, 'upDownBars' | 'hiLowLines' | 'dropLines'>;
         /** Lines in the frame cut to the plot, in px. */
         segments(lines: Pt[][]): ChartLayout.Segment[];
@@ -219,7 +219,7 @@ export declare namespace ChartKind {
  * The kinds of chart group, by group type: the built-ins, and any a host registers.
  *
  * @remarks
- * The built-in kinds register when the chart module loads (with the first chart, DESIGN-CHART §7),
+ * The built-in kinds register when the chart module loads (with the first chart),
  * so before that {@link get} answers `undefined` for `'bar'`; a host's kind registered under a
  * built-in type keeps its place when they do. A registration is a call, never a side effect of an
  * import: the package declares no side effects, so a bundler drops a module imported only for one.

package/types/src/chart/kinds/_Placeholder.d.ts

@@ -1,5 +1,4 @@
 import { ChartKind } from './ChartKind';
-/** The 2016 types not drawn: the region map, laid out as a placeholder (PLAN-CHART §4). */
 export declare const PLACEHOLDER_TYPES: readonly ["regionMap"];
 /** A region map: a label in the plot saying the type is not drawn. */
 export declare const PlaceholderKind: ChartKind;

package/types/src/chart/layout/ChartLayout.d.ts

@@ -24,7 +24,11 @@ export interface ChartLayout {
     width: number;
     height: number;
     chartArea: {
-        fill: IFill.JSON | null;
+        /**
+         * `undefined` where the chart states no fill: the chart area is the background of where it is
+         * drawn (Excel draws it in the theme's background color).
+         */
+        fill: IFill.JSON | null | undefined;
         border: IStroke.JSON | null;
         /** The radius of the chart area's corners, measured along the border's path; 0 for square corners. */
         cornerRadius: number;

package/types/src/chart/layout/TextMeasurer.d.ts

@@ -1,14 +1,4 @@
 import { IFontCollection } from '../../font/IFontCollection';
-/**
- * How chart layout measures text: one line's advance width and its height, in points.
- *
- * @remarks
- * Excel lays chart text out with DirectWrite's numbers, not GDI's: advances unhinted and unkerned,
- * and a line as tall as the font's ascent plus descent at the exact size, from the typo metrics
- * when the font sets `USE_TYPO_METRICS` and from `usWinAscent`/`usWinDescent` otherwise (measured,
- * DESIGN-CHART §4). Every host measures through this one interface, so a server and a browser lay
- * a chart out alike.
- */
 export interface TextMeasurer {
     /** The advance width of `text` on one line, in pt. */
     width(text: string, font: TextMeasurer.Font): number;
@@ -24,15 +14,5 @@ export declare namespace TextMeasurer {
         italic?: boolean;
     }
 }
-/**
- * Measures with the font tables of `fonts`: the family's own table, a related family's, or a
- * built-in one (DESIGN-FONTS §3).
- *
- * @remarks
- * A table keeps `usWinAscent`/`usWinDescent` only, so a family that sets `USE_TYPO_METRICS` and has
- * typo metrics that differ from them measures taller than Excel draws it. Aptos Narrow, the default
- * chart font, has no table: it is measured with Calibri's, whose width differs by up to 8% per
- * string and whose line height (1.2207 em) is Aptos Narrow's.
- */
 export declare function createTableMeasurer(fonts?: IFontCollection): TextMeasurer;
 //# sourceMappingURL=TextMeasurer.d.ts.map

package/types/src/chart/layout/_LayoutUtils.d.ts

@@ -5,26 +5,10 @@ import { ChartLayout } from './ChartLayout';
 import { ResolvedChart } from '../resolve/_ResolvedChart';
 import { AxisLimits } from '../math/UnitCalcs';
 import { TrendlineTextRun } from '../math/Trendlines';
-/**
- * What the layout and the kinds share: the frame's units and the conversions to px, and the small
- * questions every kind asks of an axis or a group.
- *
- * @remarks
- * Lengths are points until the end, where they become px. Element positions are relative to a
- * frame inset {@link FRAME_INSET} from the chart on every side: COM reports them in it, the title
- * centers in it, and the margins are symmetric about it, at every chart size and border width
- * probed (DESIGN-CHART §4, `probe-chart-layout.ps1`, Excel 16.0, 2026-10-16).
- */
 export declare const FRAME_INSET = 4;
 export declare const PX_PER_PT: number;
 /** How far a value axis's end labels may reach past the plot area's outer rect. */
 export declare const LABEL_OVERHANG = 6;
-/**
- * The band axis labels take beside the plot: the widest label (vertical value axis) or one line
- * (horizontal axis) plus `perLine` lines, less 4.5 pt. Fit on Aptos Narrow from 6 to 28 pt to
- * 0.012 pt; Calibri and Arial at 18 pt fall within 0.15 pt and 0.54 pt. A scatter's x axis takes the
- * horizontal band too (`probe-chart-area-scatter.ps1` S0).
- */
 export declare const VALUE_LABEL_BAND: {
     perLine: number;
     offset: number;

package/types/src/chart/math/BoxStats.d.ts

@@ -1,11 +1,3 @@
-/**
- * The statistics a box and whisker draws for one set of values, as Excel computes them (measured
- * 2026-10-22, `probe-chart-2016-types.ps1` B01-B13 and `probe-chart-2016-types-reopen.ps1` B05-B07;
- * DESIGN-CHART §4.17): quartiles by Excel's exclusive (`QUARTILE.EXC`) or inclusive
- * (`QUARTILE.INC`) method, the median the same either way; whiskers to the furthest values within
- * 1.5 interquartile ranges of the box, and the values beyond them outliers (B09: 60 beyond a box of
- * 15..25).
- */
 export type QuartileMethod = 'inclusive' | 'exclusive';
 export interface BoxStats {
     count: number;

package/types/src/chart/math/DateUnitCalcs.d.ts

@@ -1,13 +1,3 @@
-/**
- * Excel's date axis (measured 2026-10-17, `probe-chart-dates.ps1` and `probe-chart-dates-units.ps1`,
- * DESIGN-CHART §4.2). Dates are serials, in the 1900 or 1904 system; lengths are points.
- *
- * @remarks
- * A date axis has one slot per base unit (a day, a month or a year) from its first date, snapped to
- * the start of its unit, to its last; each point is drawn in the slot of its date, so a gap in the
- * dates is a gap on the axis and two points of one date share a slot. Labels are drawn on the
- * major ticks only, from the first slot on, in the axis's number format.
- */
 export type TimeUnit = 'days' | 'months' | 'years';
 /** A length of time: `count` of `unit`. */
 export interface DateUnit {

package/types/src/chart/math/Histogram.d.ts

@@ -1,20 +1,3 @@
-/**
- * How a histogram bins its values, as Excel does (measured 2026-10-22,
- * `probe-chart-2016-types.ps1` H01-H16 and `probe-chart-2016-types-reopen.ps1` H04-H07, H13;
- * DESIGN-CHART §4.16).
- *
- * - The automatic bin width is Scott's rule, 3.5·s/∛n for the sample standard deviation s, rounded
- *   to two significant digits (27.32 → 27, 14.75 → 15, 18.88 → 19, 0.4001 → 0.40, 81.32 → 81);
- *   {@link REPEATED_VALUE_WIDTH} when every value is the same (H15: one value, [7, 12]).
- * - A stated bin count divides the values' range into that many bins (H05: 81/5 = 16.2).
- * - The bins start at the minimum, or at the underflow bound where one is stated, and run up by
- *   the width until they reach the maximum, or the overflow bound, where the last bin is cut
- *   (H06: (30, 57], (57, 60]; H07: [12, 39], (39, 60]). An underflow bin takes the values at or
- *   below its bound, an overflow bin those above (`intervalClosed r`), or below and at or above
- *   (`l`).
- * - Closed on the right, the first bin takes its lower bound too, `[12, 39]`, the others `(39, 66]`;
- *   closed on the left, every bin is `[30, 40)` (H13), and a value at the maximum has a bin of its own.
- */
 /** The bin width when the values have no spread: belief, from one value repeated (H15). */
 export declare const REPEATED_VALUE_WIDTH = 5;
 export interface HistogramOptions {

package/types/src/chart/math/OrdUnitCalcs.d.ts

@@ -1,14 +1,4 @@
 import { TextMeasurer } from '../layout/TextMeasurer';
-/**
- * Excel's fit of category axis labels: as they are, wrapped, turned to 45 and then 90 degrees, and
- * then only every nth one shown (measured 2026-10-17, `probe-chart-categories.ps1`, DESIGN-CHART
- * §4.1). Lengths are points.
- *
- * @remarks
- * Rescued from exhibit-master's `OrdUnitCalcs.js` and typed over {@link TextMeasurer}: the same
- * order of trials, with the spacing each angle needs taken from {@link calcDistanceNeededAtAxis}
- * of the labels' own width, and the label interval from how many labels the axis holds.
- */
 /** What is drawn for a label cut short. */
 export declare const LABEL_ELLIPSIS = "\u2026";
 /** How to fit one axis's labels. */
@@ -35,11 +25,6 @@ export interface CategoryFitOptions {
     reversed?: boolean;
     /** The labels are stacked letter over letter (`vert="wordArtVert"`). */
     vertical?: boolean;
-    /**
-     * The labels are the innermost level of multi-level categories. Excel then turns them straight
-     * to 90 degrees when it chooses, never 45 (measured 2026-10-17, `probe-chart-multilevel.ps1`: every
-     * turn of four sweeps, where 45 degrees would have fit; a stated 45 is kept).
-     */
     innermost?: boolean;
 }
 /** An axis's labels as fitted. */
@@ -74,18 +59,6 @@ export declare function findLargestWord(text: string, measure: (text: string) =>
  * line).
  */
 export declare function wrapLabel(text: string, width: number, measure: (text: string) => number, breakWords?: boolean): string[];
-/**
- * Stacked labels (`vert="wordArtVert"`, measured 2026-10-22, `probe-chart-axes.ps1` V01-V09): each
- * letter on its own line, {@link STACKED_LETTER_PITCH} lines apart (12.82 pt at 9 pt, fitted there
- * and held within 0.2 pt at 6, 14 and 18 pt); along the bottom a label taller than half the plot's
- * outer height breaks into columns of as many letters as fit, {@link STACKED_COLUMN_PITCH} font
- * sizes apart (from the pictures at 9 and 14 pt), centered on the category. The last label reaches
- * past its category along the axis by {@link STACKED_REACH} of its own column's height, the
- * letters' drawn pitch (V01, V02, V06, V07, V09: 0.939 to 0.940 at 9, 14 and 18 pt); the first
- * reaches nowhere (V02, V06, V09: two columns over the value axis's band, which stays).
- * Up a side, a label is one column as deep as a letter's pitch, whatever its letters (V03, V04 at
- * 9 pt: 12.82 pt for "Jan".."Jun" and for "0".."30").
- */
 export declare const STACKED_LETTER_PITCH: number;
 export declare const STACKED_COLUMN_PITCH = 0.95;
 /**
@@ -109,13 +82,6 @@ export interface CategoryGroup {
     /** The label; `null` for the blanks before a level's first label, a group with none. */
     text: string | null;
 }
-/**
- * The groups of each level of multi-level categories beyond the innermost, the nearest the axis
- * first. `levels` are by level, the innermost first, each by category with `''` for a blank. A
- * label starts a group, and a blank continues the one before it; blanks before a level's first
- * label are a group with no label (measured 2026-10-17, `probe-chart-multilevel.ps1` L21). A group
- * also ends where a group of a level further out does (believed).
- */
 export declare function groupCategories(levels: readonly (readonly string[])[], count: number): CategoryGroup[][];
 /** How to fit one outer level of multi-level categories. */
 export interface LevelFitOptions {
@@ -137,30 +103,11 @@ export interface LevelFit {
     /** How far the level's labels reach away from the axis: their lines' height. */
     depth: number;
 }
-/**
- * Fits the labels of one outer level of multi-level categories to their groups, a group having its
- * categories' share of the axis (measured 2026-10-17, `probe-chart-multilevel.ps1`):
- * - Along the bottom, each label wraps between words to its group's share, its lines centered,
- *   when every word of the level fits its group; else every label of the level wraps to
- *   {@link OVERRUN_WRAP} of the axis and may overrun its group (the long outer sweep).
- * - Up a side, the labels are turned to read up and wrap to their group's share, inside words too
- *   (L16, the bar height sweep).
- * - A stated interval shows a group's label only where its first category's label is shown (L27,
- *   L38-L41); Excel's own interval leaves every outer label shown (L4).
- */
 export declare function fitCategoryLevel(groups: readonly CategoryGroup[], font: TextMeasurer.Font, measurer: TextMeasurer, options: LevelFitOptions): LevelFit;
 /** How to fit a date axis's labels. */
 export interface DateFitOptions extends Omit<CategoryFitOptions, 'skip'> {
     /** A wide date in the axis's format (December 13th, 2000): what Excel measures to decide whether labels stay level. */
     sample: string;
 }
-/**
- * Fits a date axis's labels, `texts` one per slot and `null` for a slot with no major tick
- * (measured 2026-10-17, `probe-chart-dates.ps1`), by the room the labels have: level
- * when each has room for {@link DATE_LEVEL}, at 45 degrees when two ticks are √2 × {@link DATE_LABEL_SPAN}
- * × the size apart, else at 90 degrees, which needs the span the major unit is fit to (every move between
- * 45 and 90 degrees in the sweeps within 0.2 pt). A level label stays on one line (believed). Up a
- * side the labels stay level.
- */
 export declare function fitDateLabels(texts: readonly (string | null)[], font: TextMeasurer.Font, measurer: TextMeasurer, options: DateFitOptions): CategoryLabelFit;
 //# sourceMappingURL=OrdUnitCalcs.d.ts.map

package/types/src/chart/math/Treemap.d.ts

@@ -1,18 +1,3 @@
-/**
- * How Excel tiles a treemap (measured 2026-10-22, `probe-chart-2016-types.ps1` T01-T11 and the
- * 168 pictures of `probe-chart-treemap-sweep.ps1`; DESIGN-CHART §4.18). The children of a node,
- * largest first, each take a strip of the rect left: a column of the rect's full height as wide
- * as the child's share, unless the rect is taller than wide and a row of its full width would be no
- * wider than {@link TREEMAP_ASPECT} times its height, when the child takes that row. The last child
- * takes what is left.
- *
- * @remarks
- * The rule is not squarified: two near-equal children of a rect 1.12 times taller than wide sit
- * side by side (T01's Europe, T06), as a squarified layout never would, while children of 50 and
- * 30 stack in a square (the sweep). Across the sweep's eight pairs the row's aspect at which the
- * children turn from side by side to stacked lies between 1.587 and 1.639 for every pair: the
- * golden ratio.
- */
 export declare const TREEMAP_ASPECT = 1.618;
 export interface TreemapRect {
     x: number;

package/types/src/chart/math/Trendlines.d.ts

@@ -1,11 +1,3 @@
-/**
- * Excel's trendlines: the fits, their R², the moving average, and the label's equation.
- *
- * @remarks
- * Measured against Excel 16.0 (DESIGN-CHART §4.5, `probe-chart-trendlines.ps1`): every coefficient
- * of the nine types on a line chart and a scatter, a set intercept, and a sweep of numbers through
- * the label's General format.
- */
 export type TrendlineType = 'exp' | 'linear' | 'log' | 'movingAvg' | 'poly' | 'power';
 /** A fitted trendline. */
 export interface TrendlineFit {

package/types/src/chart/math/UnitCalcs.d.ts

@@ -1,12 +1,3 @@
-/**
- * Excel's automatic axis scales: bounds, major and minor units, and ticks for linear, logarithmic
- * and percent value axes.
- *
- * @remarks
- * Rescued from exhibit-master and typed. The linear rules are KB 214075's (the 16.667% zero rule,
- * 5% headroom, the straddling cases), checked by `unitCalcs.test.ts` against values observed in
- * Excel. Label fitting ({@link fitMajorUnitLinear}) follows the probe in DESIGN-CHART §4.
- */
 /** `undefined` and `null` both mean "not stated". */
 type Maybe = number | null | undefined;
 /** The scale of one axis. */
@@ -57,19 +48,6 @@ export declare function calcAxisLimitsLog(minIn?: number, maxIn?: number, explic
  * - the bounds snap outward to whole major units.
  */
 export declare function calcAxisLimitsLinear(minIn: Maybe, maxIn: Maybe, explicitMin?: Maybe, explicitMax?: Maybe, explicitMinorUnits?: Maybe, explicitMajorUnits?: Maybe, isScatterOrBubble?: boolean, headroom?: number, majorHeadroom?: number): AxisLimits;
-/**
- * The major unit at which the labels of a linear axis fit: the automatic unit, else the next on
- * Excel's 1, 2, 5 ladder ({@link nextMajorUnit}), until `fits` accepts the ticks.
- *
- * @param majorUnit The automatic major unit.
- * @param boundsAt The axis's bounds at a major unit: they snap to it.
- * @param fits Whether labels at these tick values fit along the axis.
- *
- * @remarks
- * Measured (DESIGN-CHART §4): at 16 pt the K1 secondary axis goes from 0.1 to 0.2; at 28 pt the
- * primary goes 50 → 100 → 200 and the secondary 0.1 → 0.2 → 0.5. A unit that leaves two ticks or
- * fewer is the last one tried.
- */
 export declare function fitMajorUnitLinear(majorUnit: number, boundsAt: (unit: number) => {
     min: number;
     max: number;

package/types/src/chart/model/_Edits.d.ts

@@ -93,11 +93,6 @@ export declare const setSeriesMarker: (idx: number, marker: {
 }) => ModelEdit;
 /** A group option set through one of its series, as Office Scripts sets it: gap width, overlap, an of-pie's second plot size. */
 export declare const setGroupOption: <K extends "gapWidth" | "overlap" | "secondPieSize">(idx: number, key: K, value: number) => ModelEdit;
-/**
- * A bubble group's option set through one of its series, as Excel writes it (`probe-chart-bubble.ps1`
- * B02, B04, B06): `bubbleScale`, `showNegBubbles`, and `sizeRepresents` `w` (by area, Excel's
- * default, it states none: by belief, as B01 states none).
- */
 export declare const setBubbleOption: (idx: number, option: {
     bubbleScale?: number;
     showNegBubbles?: boolean;
@@ -111,17 +106,6 @@ export type OfPieSplitChange = {
 } | {
     points: readonly number[];
 };
-/**
- * An of-pie's split changed as Excel writes it (measured 2026-10-18, `probe-chart-ofpie.ps1`), worked
- * out from the group it is applied to, so a type and a value set together compose as Excel's two
- * writes do (O03-O05). `values` are the series' points, by which the points now in the second plot
- * are found:
- * - a type: by value writes a split value of 1 (O27; by percent, and from a type other than the
- *   automatic, the same by belief); by position the number of points in the second plot now (by
- *   belief); by hand, the points in the second plot now (O29);
- * - a value: on the automatic split it becomes one by position (O28);
- * - the points: a split by hand of them (O30: one point moved there adds it to those there).
- */
 export declare const setOfPieSplit: (idx: number, change: OfPieSplitChange, values: readonly (number | null)[]) => ModelEdit;
 /** The flags a data label shows. */
 export type LabelFlag = 'showVal' | 'showCatName' | 'showSerName' | 'showPercent' | 'showBubbleSize' | 'showLegendKey';
@@ -133,10 +117,6 @@ export declare const showsLabels: (labels: ChartModel.DataLabelOptions | undefin
  * Excel's own markup for a label turned off is not measured.
  */
 export declare const setLabelsVisible: (idx: number, visible: boolean, chartLevel?: boolean) => ModelEdit;
-/**
- * What a group's own labels state, set with every series' by `SetElement` (`probe-chart-elements.ps1`
- * E201, E202: the group's `showVal 1` and `dLblPos`); `ApplyDataLabels` leaves the group's alone (L01).
- */
 export declare const setGroupLabels: (idx: number, options: {
     showVal?: boolean;
     dLblPos?: ChartModel.DataLabelOptions["dLblPos"];
@@ -222,10 +202,6 @@ export declare const setErrorBarsShape: (idx: number, direction: ErrorBarsDirect
 }) => ModelEdit;
 /** A group's lines of one kind: `c:hiLowLines`, `c:dropLines`, `c:serLines`. */
 export type GroupLinesKind = 'hiLowLines' | 'dropLines' | 'serLines';
-/**
- * The line of the lines Excel adds (`probe-chart-lines.ps1` H01, D01, D03, V01, V03): 0.75 pt with
- * flat ends, high-low lines darker than drop and series lines.
- */
 export declare const LINES_COLORS: Readonly<Record<GroupLinesKind, string>>;
 /** The lines of `kind` Excel adds: its line, no fill. */
 export declare const newGroupLines: (kind: GroupLinesKind) => ChartModel.ChartLines;
@@ -361,10 +337,6 @@ export declare const setAxisShape: (axId: number, patch: {
 }) => ModelEdit;
 /** The axis labels' font (X38-X42, X59). */
 export declare const setAxisFont: (axId: number, patch: FontPatch) => ModelEdit;
-/**
- * Shows the axis's title with Excel's own text (`probe-chart-elements.ps1` 301-311: a title with
- * no `tx`, 10 pt, read up a side), or removes it.
- */
 export declare const setAxisTitleVisible: (axId: number, visible: boolean) => ModelEdit;
 /** Whether the axis title is drawn over the plot area (`c:overlay`, as the chart title's). */
 export declare const setAxisTitleOverlay: (axId: number, overlay: boolean) => ModelEdit;
@@ -375,7 +347,6 @@ export declare const setAxisTitleShape: (axId: number, patch: {
     fill?: IFill.JSON;
     stroke?: IStroke.JSON;
 }) => ModelEdit;
-/** The axis title's orientation (`probe-chart-elements.ps1` 301-311: rotated reads up, vertical is stacked, horizontal level). */
 export declare const setAxisTitleRotation: (axId: number, rotation: number | "vertical" | "auto") => ModelEdit;
 /** A category axis's label or tick mark spacing (X43, X44: `tickLblSkip`, `tickMarkSkip`); `null` for automatic. */
 export declare const setAxisSkip: (axId: number, which: "tickLblSkip" | "tickMarkSkip", count: number | null) => ModelEdit;
@@ -477,10 +448,6 @@ export declare const setLabelsFont: (idx: number, patch: FontPatch) => ModelEdit
 export declare const setLabelsRotation: (idx: number, rotation: number | "vertical" | "auto") => ModelEdit;
 /** Whether a series' labels take the values' format (L15: off writes `General` unlinked). */
 export declare const setLabelsLinkNumberFormat: (idx: number, linked: boolean) => ModelEdit;
-/**
- * The cells a series' labels show (Excel's "Value From Cells", L07 and `probe-chart-values.ps1`
- * W8): the series' `c15:datalabelsRange` and its labels' `c15:showDataLabelsRange`; `null` removes both.
- */
 export declare const setLabelsRange: (idx: number, source: ChartModel.DataReference | null) => ModelEdit;
 /** The `c:ext` uri of a series' `c15:datalabelsRange`, and of its labels' `c15:showDataLabelsRange`. */
 export declare const DATALABELS_RANGE_URI = "{02D57815-91ED-43cb-92C2-25804820EDAC}";

package/types/src/chart/model/_Grouping.d.ts

@@ -9,13 +9,6 @@ export interface GroupTarget {
 export type AxisGroup = 'primary' | 'secondary';
 /** Makes an `axId` no axis of the chart has. */
 export type NewAxisId = () => number;
-/**
- * Types that do not combine. Measured: setting one series of a chart to bubble, a 3-D type or
- * surface converts every series, and setting one series of such a chart to anything converts every
- * series too. Of-pie is treated the same way; that is a belief, not measured. Stock is not: no
- * series can be given a stock type (Excel refuses), and a stock series given another type leaves
- * the stock group alone (measured 2026-10-18, `probe-chart-stock-refusals.ps1`).
- */
 export declare const isWholeChartType: (group: GroupTarget) => boolean;
 /**
  * The axis group a group draws against, or `null` for a group with no axes (a pie).
@@ -50,24 +43,6 @@ export declare const seriesKeys: (plotArea: ChartModel.PlotArea | undefined) =>
  * leaves them all on the primary axes in one group).
  */
 export declare const tidyPlotArea: (plotArea: ChartModel.PlotArea) => ChartModel.PlotArea;
-/**
- * Gives the series `idx` the type `target`, moving it to the group of that type on the axes it can
- * share, as Excel does.
- *
- * @remarks
- * - Changing only a group option (clustered to stacked, area to stacked area) changes the whole
- *   group, every series in it (measured): grouping is per group.
- * - The series joins the group of the target type on its own axes when it can share them, else on
- *   the other pair; when neither fits it gets the secondary axes, made for it. A pie or doughnut has
- *   no axes.
- * - A category series added to a scatter chart shares the scatter group's axes, whose horizontal
- *   axis becomes a category axis (measured).
- * - Joining an existing column group this way drops that group's `overlap` (measured, and odd:
- *   moving a series back by its axis group keeps it).
- * - The group it leaves is removed when empty, and with it any axes no group uses.
- *
- * @throws When the move is one the probes did not measure: a third pair of axes would be needed.
- */
 export declare const setSeriesType: (plotArea: ChartModel.PlotArea, idx: number, target: GroupTarget, newAxisId: NewAxisId) => ChartModel.PlotArea;
 /**
  * Moves the series `idx` to the primary or secondary axes, keeping its type.

package/types/src/chart/model/_Inference.d.ts

@@ -1,15 +1,4 @@
 import { IRange } from '@sheetxl/primitives';
-/**
- * Which series a chart makes of a selection, as Excel's Insert Chart decides (measured 2026-10-17,
- * `probe-chart-insert.ps1`, 83 selections through `AddChart2`, DESIGN-CHART §3.5). Ported from
- * exhibit-master's `ChartSelection.ts`, whose header scan Excel agrees with; what it lacked (several
- * areas side by side, a bubble's sizes) is Excel's measured behavior.
- *
- * @remarks
- * Pure: it reads the cells through a {@link CellKind} callback and answers coordinates, so it runs
- * on any grid. The caller turns a selection into areas first (a single cell becomes its current
- * region, whole rows or columns their used cells).
- */
 /** A cell as inference reads it: a date is a number in a date format. */
 export type CellKind = 'blank' | 'text' | 'number' | 'date';
 /** Whether each series is a row or a column of the data. */
@@ -41,12 +30,5 @@ export interface Inference {
  * @param seriesBy The direction, or `undefined` to let the cells decide.
  */
 export declare function inferSeries(areas: readonly IRange.Coords[], kindAt: (rowIndex: number, colIndex: number) => CellKind, family?: InferenceFamily, seriesBy?: SeriesBy): Inference;
-/**
- * The cells around `cell` up to blank rows and columns on every side, diagonals included: what
- * Excel charts when one cell is selected (Excel's `CurrentRegion`, measured on a table, I21). A
- * blank cell with nothing around it is itself.
- *
- * @param last The last row and column that hold anything; nothing past them is read.
- */
 export declare function currentRegion(cell: IRange.CellCoords, kindAt: (rowIndex: number, colIndex: number) => CellKind, last: IRange.CellCoords): IRange.Coords;
 //# sourceMappingURL=_Inference.d.ts.map

package/types/src/chart/model/_NewChart.d.ts

@@ -3,12 +3,6 @@ import { IFill } from '../../fill/IFill';
 import { IStroke } from '../../fill/IStroke';
 import { ChartModel } from './ChartModel';
 import { CellKind, Inference, InferenceFamily } from './_Inference';
-/**
- * The model Excel makes for a new chart (measured 2026-10-17, `probe-chart-insert.ps1`: the part
- * Excel 16 writes for each gallery type through `AddChart2`, `fixtures/insert/parts/`; held to them by
- * io-xlsx's `chart.insert.node.test.ts`). Excel's chart style for the type (`c14:style` 102, the
- * series fills of `colors10`, the text sizes of T1) is stated on every element, as Excel states it.
- */
 /** The gallery types a new chart can be, by Office Scripts' names. */
 export type NewChartType = 'columnClustered' | 'columnStacked' | 'columnStacked100' | 'barClustered' | 'barStacked' | 'barStacked100' | 'line' | 'lineStacked' | 'lineStacked100' | 'lineMarkers' | 'lineMarkersStacked' | 'lineMarkersStacked100' | 'pie' | 'pieExploded' | 'doughnut' | 'pieOfPie' | 'barOfPie' | 'area' | 'areaStacked' | 'areaStacked100' | 'xyscatter' | 'xyscatterLines' | 'xyscatterLinesNoMarkers' | 'xyscatterSmooth' | 'xyscatterSmoothNoMarkers' | 'bubble' | 'bubble3DEffect' | 'radar' | 'radarMarkers' | 'radarFilled' | 'stockHLC' | 'stockOHLC' | 'stockVHLC' | 'stockVOHLC' | 'doughnutExploded' | 'surface' | 'surfaceWireframe' | 'surfaceTopView' | 'surfaceTopViewWireframe' | '3DColumn' | '3DColumnClustered' | '3DColumnStacked' | '3DColumnStacked100' | '3DBarClustered' | '3DBarStacked' | '3DBarStacked100' | '3DLine' | '3DPie' | '3DPieExploded' | '3DArea' | '3DAreaStacked' | '3DAreaStacked100' | 'waterfall' | 'treemap' | 'sunburst' | 'histogram' | 'pareto' | 'boxwhisker' | 'funnel' | 'regionMap';
 /** What the builder reads of the cells the series name. */
@@ -66,13 +60,7 @@ export interface TypeSpec {
 export declare const typeSpec: (type: NewChartType) => TypeSpec;
 /** Whether `type` is a gallery type a new chart can be. */
 export declare const isNewChartType: (type: string) => type is NewChartType;
-/** A stock type, which no series can be given (Excel refuses one, `probe-chart-stock-refusals.ps1`). */
 export declare const isStockType: (type: NewChartType) => boolean;
-/**
- * How many series a new chart of a stock type is made of: its volume, open, high, low and close as
- * it has them. Excel makes a stock chart of no other count (`probe-chart-stock-refusals.ps1`);
- * `null` for any other type.
- */
 export declare const stockSeriesCount: (type: NewChartType) => number | null;
 /** How a type takes its series from the cells. */
 export declare const familyOf: (type: NewChartType) => InferenceFamily;
@@ -131,13 +119,6 @@ export interface SeriesTypeTarget {
 }
 /** The group a series of `type` is drawn in, as `_Grouping` takes it. */
 export declare const seriesTypeTarget: (type: NewChartType) => SeriesTypeTarget;
-/**
- * `series` drawn as a series of `type` in its own color, as Excel restates it when one series of a
- * chart changes type (measured 2026-10-17, `probe-chart-edits.ps1` SD5: a column series made a line
- * with markers states a 2.25 pt line of its fill's color, a 5 pt circle marker of it, `smooth 0`, and
- * no `invertIfNegative`). The other directions restate what a new chart of `type` states: believed.
- * A series whose drawing already belongs to `type` is returned as it is.
- */
 export declare const drawSeriesAsType: (series: ChartModel.Series, type: NewChartType, valueCount: number) => ChartModel.Series;
 /** What a category axis states of its categories. */
 export type CategoryAxisFields = Pick<ChartModel.Axis, 'type' | 'numFmt' | 'lblAlgn' | 'lblOffset' | 'noMultiLvlLbl' | 'baseTimeUnit'>;
@@ -147,16 +128,6 @@ export type CategoryAxisFields = Pick<ChartModel.Axis, 'type' | 'numFmt' | 'lblA
  * linked, where there are categories (I03).
  */
 export declare function categoryAxisOf(areas: readonly IRange.Coords[] | null, cells: NewChartCells): CategoryAxisFields;
-/**
- * The model of a new chart of `type` over the series `inference` found.
- *
- * @remarks
- * Every series states its fill (Excel's `colors10` in order), the axes and text state Excel's
- * style, a chart of two series or more or a pie has a legend at the bottom (at the top for radar), and the
- * title is automatic: it shows a single series' name, else "Chart Title" (I01-B23). Categories that
- * are all dates make a date axis with the base unit Excel chooses (DESIGN-CHART §4.2). The caches
- * are left out: a save restates them from the cells.
- */
 export declare function createChartModel(type: NewChartType, inference: Inference, cells: NewChartCells): ChartModel.ChartSpace;
 /**
  * The series axis of a 3-D column, line or area, or of a surface: along the bottom, crossing the
@@ -176,18 +147,6 @@ export interface ChartExEntry {
     /** The formula of the cell at the categories' head: what a region map names its categories by. */
     catName?: string;
 }
-/**
- * A 2016 chart's model, as Excel makes it for the type (measured 2026-10-22, `probe-chart-insert.ps1`,
- * the gallery; `chart-insert-gallery.xlsx`): one series drawn and the rest hidden (a box and
- * whisker draws them all), each with the type's labels and layout options; a treemap's and a
- * sunburst's values are their tiles' sizes, and a region map colors its regions by its values.
- * Only a waterfall, a histogram and a box and whisker state a value axis; a treemap, a sunburst
- * and a region map no axis at all. A pareto's series sum by category and each draws its running
- * total on a percentage axis. Its title and legend are Excel's; the part's style and colors are the
- * writer's.
- *
- * @param rows Whether the series read their cells along rows, which each reference says.
- */
 export declare function chartExModel(spec: TypeSpec, entries: readonly ChartExEntry[], rows: boolean): ChartModel.ChartSpace;
 /** A value axis: a scatter's two, or a category chart's one. `formatCode` `null` states no number format. */
 export declare function valueAxis(axId: number, crossAx: number, axPos: 'b' | 'l' | 'r', formatCode: string | null, xy: boolean): ChartModel.Axis;

package/types/src/chart/model/_OfPie.d.ts

@@ -7,12 +7,5 @@ export interface OfPieSplit {
 }
 /** How many points Excel's automatic split puts in the second plot: the last third, rounded up. */
 export declare const automaticSplitCount: (count: number) => number;
-/**
- * By point, whether it is in an of-pie's second plot (measured 2026-10-18, `probe-chart-ofpie.ps1`):
- * the last `splitPos` by position, those of a value less than `splitPos`, or less than `splitPos`
- * percent of the total, or those listed (`custSplit`). Excel's automatic split takes the last third
- * by position, rounded up (O01, O17, O21-O24: 3 of 7, 2 of 4, 4 of 10, 2 of 6, 1 of 3 and of 2; COM
- * reads it as a split by position).
- */
 export declare const secondPlotPoints: (split: OfPieSplit, values: readonly (number | null)[]) => boolean[];
 //# sourceMappingURL=_OfPie.d.ts.map

package/types/src/chart/resolve/_LegacyStyles.d.ts

@@ -1,15 +1,3 @@
-/**
- * The legacy chart styles (`c:style` 1-48): the colors Excel draws for what a chart does not state.
- *
- * @remarks
- * Measured (DESIGN-CHART §3.4, S3): a series with no fill of its own takes its color from these
- * tables, not from the chart's `colorsN.xml`, even when that part is present. With more series than
- * a style has colors, the colors repeat in bands, and the bands fade: the middle band is the plain
- * color, bands before it are shaded and bands after it tinted, by a step that shrinks as bands are
- * added. Rescued from exhibit-master's `ChartStyles.js`.
- *
- * Colors are written as the shapes model writes them (`accent1 shade 54`), for the theme to resolve.
- */
 /**
  * The fill of series `offset` (its `c:idx`) of `total` in a chart drawn in a legacy style, as a
  * color string for the theme.
@@ -36,13 +24,5 @@ export interface LegacyElementDefaults {
  * border, and gridlines take that border's color too; the resolver states those itself.
  */
 export declare function legacyElementDefaults(style: number | undefined): LegacyElementDefaults;
-/**
- * The width of a line series that states none, in pt, by the style's row of Excel's gallery (1-8,
- * 9-16, ... 41-48): 3 in the first, 7 in the fourth, 5 in the others.
- *
- * @remarks
- * Measured on lines and scatters in styles 2, 7, 10, 18, 26, 34 and 42 (DESIGN-CHART §3.4,
- * `probe-chart-markers.ps1`).
- */
 export declare function legacyLineWidth(style: number | undefined): number;
 //# sourceMappingURL=_LegacyStyles.d.ts.map