@sheetxl/sdk 0.8.0-beta.12 → 0.8.0-beta.14

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

@@ -330,7 +330,6 @@ export declare class ChartAxis implements IChart.IAxis {
     setCustomDisplayUnit(unit: number, options?: ITransaction.OperationOptions): this;
     getShowDisplayUnitLabel(): boolean;
     setShowDisplayUnitLabel(show: boolean, options?: ITransaction.OperationOptions): this;
-    /** The axis crossing this one: where VBA's `Crosses` is written (DESIGN-CHART §3.6). */
     private _crossing;
     getCrosses(): IChart.AxisCrosses;
     setCrosses(crosses: IChart.AxisCrosses, options?: ITransaction.OperationOptions): this;
@@ -362,7 +361,6 @@ export declare class ChartAxis implements IChart.IAxis {
     setCategoryType(type: IChart.AxisCategoryType, options?: ITransaction.OperationOptions): this;
     /** The dates of the first series on the axis, as numbers; `null` where its categories are not all dates. */
     private _dates;
-    /** The base unit Excel chooses for the axis's dates (DESIGN-CHART §4.2), `days` without any. */
     private _automaticBaseUnit;
     /** The axis's categories from a setter's input. @throws ExpectedError where the axis has none. */
     private _categoriesEdit;
@@ -509,16 +507,6 @@ export declare class ChartSeries implements IChart.ISeries {
      * size (5-200).
      */
     private _groupOption;
-    /**
-     * The series given `type`, as one edit: moved to its group by `_Grouping`'s measured moves, and
-     * drawn as a series of the type is (`drawSeriesAsType`). Every series whose group changed type is
-     * drawn anew, as Excel does when bubble or 3-D types take the whole chart; one that stays in its
-     * group changes its markers, and a scatter its line, keeping its own fill and line otherwise. A
-     * series that becomes a scatter's states its categories and values as x and y values, and the
-     * other way round. No series can be given a stock type: Excel refuses one
-     * (`probe-chart-stock-refusals.ps1`); nor an of-pie, which is not measured; nor a 3-D form, a
-     * surface or a 2016 type, which take the whole chart (`IChart.setChartType`).
-     */
     private _typeEdit;
     private _axisGroupEdit;
     getFormula(): string;
@@ -546,11 +534,6 @@ export declare class ChartSeries implements IChart.ISeries {
      * plot order, the sizes for a bubble.
      */
     private _formulaEdits;
-    /**
-     * The categories set through this series: a scatter's or bubble's x values are its own; a
-     * category chart's categories are shared by every series on its axis, so each takes them, and
-     * `null` clears them all (measured 2026-10-18, `probe-chart-api.ps1` S01-S04).
-     */
     private _categoriesEdit;
     /** A dimension's source, from a setter's input. */
     private _source;
@@ -751,17 +734,7 @@ export declare class ChartErrorBars implements IChart.IErrorBars {
     edits(update: IChart.IErrorBars.Update): ModelEdit[];
     update(update: IChart.IErrorBars.Update, options?: ITransaction.OperationOptions): this;
 }
-/**
- * Whether Excel draws up/down bars and high-low lines for a group: a 2-D line or stock group
- * (`probe-chart-lines.ps1`; 3-D lines refused by belief).
- */
 export declare const takesUpDownBars: (group: ChartModel.Group) => boolean;
-/**
- * Whether Excel draws a group's lines of `kind` (`probe-chart-lines.ps1`): high-low lines on a line
- * or stock group; drop lines on a line, area or stock group (D09: COM takes them on a scatter and
- * writes none); series lines on stacked and 100% stacked bars and pie of pie (V06: COM takes them on
- * clustered columns and writes none). 3-D groups are refused by belief.
- */
 export declare const takesLines: (group: ChartModel.Group, kind: Edits.GroupLinesKind) => boolean;
 export declare class ChartGroupLines implements IChart.ILines {
     private readonly _host;
@@ -995,11 +968,6 @@ export declare class ChartGroup implements IChart.IChartGroup {
     getVaryByCategories(): boolean;
     setVaryByCategories(vary: boolean, options?: ITransaction.OperationOptions): this;
 }
-/**
- * Every series' data labels at once (Office Scripts' `chart.getDataLabels()`, VBA's
- * `ApplyDataLabels`, `probe-chart-api.ps1` L01): reads answer the first series', each setter sets
- * every series as one step.
- */
 export declare class ChartAllLabels implements IChart.IDataLabels {
     private readonly _host;
     private readonly _all;
@@ -1054,13 +1022,6 @@ export interface ChartElementParts {
     plotArea: ChartPlotArea;
     dataTable: ChartDataTable;
 }
-/**
- * The edits of a chart element (VBA's `SetElement`, measured 2026-10-18, `probe-chart-elements.ps1`):
- * each `msoElement…` as the setters above make it. A data label element sets every series; a
- * trendline, error bar, line or up/down bar element every series or group that takes one. What
- * Excel refuses (an element of axes the chart has none of, a label position its type has none of,
- * a trendline on a pie) throws `ExpectedError`.
- */
 export declare const elementEdits: (parts: ChartElementParts, element: IChart.Element) => ModelEdit[];
 export {};
 //# sourceMappingURL=_ChartParts.d.ts.map

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/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