ooxml-core 1.24.3 → 1.25.1

package/dist/chart/data-sheet.d.ts

@@ -0,0 +1,86 @@
+/**
+ * The chart data sheet: the categories x series table behind every product's "Edit Data" view
+ * (PowerPoint and Word open it for an embedded chart, Excel edits the cells themselves). This is
+ * the format-neutral model of that table and the edits a person can make to it; a product maps
+ * the edits onto its own chart model (pptx: `applyChartDataSheetEdits` in the pptx area), so
+ * formatting that lives on a series or a point is kept by the product, not rebuilt from here.
+ *
+ * Grid coordinates used by the sheet UI: row 0 is the header row (series names), column 0 the
+ * category column; row `r >= 1` is category `r - 1` and column `c >= 1` is series `c - 1`.
+ *
+ * @module chart/data-sheet
+ */
+/**
+ * One value of a series: a number, or `null` for a blank cell (written as a missing cached point).
+ * The one series-values shape of the chart core: the data sheet holds it and the `chart/edit`
+ * series operations (`setChartSeriesValues`, `addChartSeries`...) take it.
+ */
+export type ChartSeriesValue = number | null;
+/** One series column: its name and one value per category (`null` for a blank cell). */
+export interface ChartDataSheetSeries {
+    name: string;
+    values: readonly ChartSeriesValue[];
+}
+/** The neutral chart data shape: category labels down the rows, series across the columns. */
+export interface ChartDataSheet {
+    categories: readonly string[];
+    series: readonly ChartDataSheetSeries[];
+}
+/** One edit of the sheet. A product applies these in order to its own chart model. */
+export type ChartDataSheetEdit = {
+    kind: 'value';
+    series: number;
+    category: number;
+    value: number;
+} | {
+    kind: 'series-name';
+    series: number;
+    name: string;
+} | {
+    kind: 'category-label';
+    category: number;
+    label: string;
+} | {
+    kind: 'add-series';
+} | {
+    kind: 'remove-series';
+    series: number;
+} | {
+    kind: 'add-category';
+} | {
+    kind: 'remove-category';
+    category: number;
+};
+/** The name a new series gets: `Series N`, PowerPoint's own naming. */
+export declare function nextChartSeriesName(seriesCount: number): string;
+/** The label a new category gets: `Cat N`, as the PowerPoint editor has always named it. */
+export declare function nextChartCategoryName(categoryCount: number): string;
+/**
+ * Whether `edit` can be applied to `sheet`: indices in range, a finite value, and never removing
+ * the last series or category (a chart with no series or no category has nothing to plot, and
+ * the sheet would have no row or column to add data back into).
+ */
+export declare function canApplyChartDataSheetEdit(sheet: ChartDataSheet, edit: ChartDataSheetEdit): boolean;
+/** Applies one edit, or returns `null` when {@link canApplyChartDataSheetEdit} refuses it. */
+export declare function applyChartDataSheetEdit(sheet: ChartDataSheet, edit: ChartDataSheetEdit): ChartDataSheet | null;
+/** Applies edits in order, skipping any the sheet refuses at that point. */
+export declare function applyChartDataSheetEdits(sheet: ChartDataSheet, edits: readonly ChartDataSheetEdit[]): ChartDataSheet;
+/** A cell of the sheet in grid coordinates (see the module comment). */
+export interface ChartDataSheetCell {
+    row: number;
+    col: number;
+}
+/**
+ * The edit that writes `raw` into one grid cell: a series name in the header row, a category
+ * label in the category column, a value elsewhere. `parseNumber` reads a value cell (pass a
+ * locale-aware parser); a value that does not parse gives `null`, as does the corner cell.
+ */
+export declare function chartDataSheetCellEdit(cell: ChartDataSheetCell, raw: string, parseNumber: (raw: string) => number | null): ChartDataSheetEdit | null;
+/**
+ * The edits that paste a block of cells (rows of text, as `parseTsv` reads the clipboard) with
+ * its top-left corner on `anchor`. Like the spreadsheet behind PowerPoint's chart, a block that
+ * runs past the last series or category adds the series and categories it needs first; a value
+ * cell that does not parse is skipped, and the corner cell is never written.
+ */
+export declare function chartDataSheetPasteEdits(sheet: ChartDataSheet, anchor: ChartDataSheetCell, block: readonly (readonly string[])[], parseNumber: (raw: string) => number | null): ChartDataSheetEdit[];
+//# sourceMappingURL=data-sheet.d.ts.map

package/dist/chart/data-sheet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-sheet.d.ts","sourceRoot":"","sources":["../../chart/data-sheet.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,IAAI,CAAC;AAE7C,wFAAwF;AACxF,MAAM,WAAW,oBAAoB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,SAAS,gBAAgB,EAAE,CAAC;CACpC;AAED,8FAA8F;AAC9F,MAAM,WAAW,cAAc;IAC9B,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,MAAM,EAAE,SAAS,oBAAoB,EAAE,CAAC;CACxC;AAED,sFAAsF;AACtF,MAAM,MAAM,kBAAkB,GAC3B;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAClE;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACrD;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC3D;IAAE,IAAI,EAAE,YAAY,CAAA;CAAE,GACtB;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACzC;IAAE,IAAI,EAAE,cAAc,CAAA;CAAE,GACxB;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjD,uEAAuE;AACvE,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED,4FAA4F;AAC5F,wBAAgB,qBAAqB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAEnE;AAMD;;;;GAIG;AACH,wBAAgB,0BAA0B,CACzC,KAAK,EAAE,cAAc,EACrB,IAAI,EAAE,kBAAkB,GACtB,OAAO,CAqBT;AAQD,8FAA8F;AAC9F,wBAAgB,uBAAuB,CACtC,KAAK,EAAE,cAAc,EACrB,IAAI,EAAE,kBAAkB,GACtB,cAAc,GAAG,IAAI,CAuDvB;AAED,4EAA4E;AAC5E,wBAAgB,wBAAwB,CACvC,KAAK,EAAE,cAAc,EACrB,KAAK,EAAE,SAAS,kBAAkB,EAAE,GAClC,cAAc,CAIhB;AAED,wEAAwE;AACxE,MAAM,WAAW,kBAAkB;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;CACZ;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACrC,IAAI,EAAE,kBAAkB,EACxB,GAAG,EAAE,MAAM,EACX,WAAW,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,GACzC,kBAAkB,GAAG,IAAI,CAO3B;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACvC,KAAK,EAAE,cAAc,EACrB,MAAM,EAAE,kBAAkB,EAC1B,KAAK,EAAE,SAAS,CAAC,SAAS,MAAM,EAAE,CAAC,EAAE,EACrC,WAAW,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,GACzC,kBAAkB,EAAE,CAmBtB"}

package/dist/chart/edit/axes.d.ts

@@ -0,0 +1,49 @@
+import type { ChartAxis, ChartAxisKind, ChartSpace } from '../model.js';
+import type { ChartShapeProperties } from '../model-series.js';
+/**
+ * The first axis of a kind (PowerPoint's addressing), the axis with an id, or the axis at a
+ * position of `plotArea.axes` (a Format pane's `axis:N` target).
+ */
+export type ChartAxisTarget = ChartAxisKind | {
+    id: number;
+} | {
+    index: number;
+};
+export interface ChartAxisEdit {
+    /** `c:delete` is the inverse. */
+    visible?: boolean;
+    /** Axis title text; `null` or `''` removes the title. */
+    title?: string | null;
+    min?: number | null;
+    max?: number | null;
+    majorUnit?: number | null;
+    minorUnit?: number | null;
+    /** Date axis: the unit of the major and minor units (`days`, `months`, `years`). */
+    majorTimeUnit?: string | null;
+    minorTimeUnit?: string | null;
+    /** Logarithmic scale base (2..1000); `null` returns to a linear scale. */
+    logBase?: number | null;
+    /** Categories or values in reverse order (`c:orientation val="maxMin"`). */
+    reverse?: boolean;
+    /** A format code not linked to the source; `''` removes `c:numFmt` (the axis follows its data). */
+    numberFormat?: string;
+    majorTickMark?: 'cross' | 'in' | 'out' | 'none';
+    minorTickMark?: 'cross' | 'in' | 'out' | 'none';
+    tickLabelPosition?: 'high' | 'low' | 'nextTo' | 'none';
+    /** Where the other axis crosses: `autoZero`, `min`, `max`, or a value. */
+    crosses?: 'autoZero' | 'min' | 'max' | number;
+    majorGridlines?: boolean;
+    minorGridlines?: boolean;
+    /** Value axis: a built-in unit (`thousands`, `millions`...) or a custom divisor; `null` clears. */
+    displayUnits?: string | number | null;
+}
+/** The axis an edit targets; throws when the part has no such axis. */
+export declare function chartAxisAt(space: ChartSpace, target: ChartAxisTarget): ChartAxis;
+/** Edits one axis. */
+export declare function setChartAxis(space: ChartSpace, target: ChartAxisTarget, edit: ChartAxisEdit): ChartSpace;
+/**
+ * Sets the outline of an axis's major or minor gridlines (colour, width, dash), keeping the rest
+ * of their shape; styling gridlines turns them on, as in PowerPoint. `null` removes the styling.
+ */
+export declare function setChartGridlineShape(space: ChartSpace, target: ChartAxisTarget, which: 'major' | 'minor', shape: Pick<ChartShapeProperties, 'line' | 'fill'> | null): ChartSpace;
+//# sourceMappingURL=axes.d.ts.map

package/dist/chart/edit/axes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"axes.d.ts","sourceRoot":"","sources":["../../../chart/edit/axes.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACrE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAI5D;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,aAAa,GAAG;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjF,MAAM,WAAW,aAAa;IAC7B,iCAAiC;IACjC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,yDAAyD;IACzD,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,oFAAoF;IACpF,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,0EAA0E;IAC1E,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,4EAA4E;IAC5E,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,mGAAmG;IACnG,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,OAAO,GAAG,IAAI,GAAG,KAAK,GAAG,MAAM,CAAC;IAChD,aAAa,CAAC,EAAE,OAAO,GAAG,IAAI,GAAG,KAAK,GAAG,MAAM,CAAC;IAChD,iBAAiB,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IACvD,0EAA0E;IAC1E,OAAO,CAAC,EAAE,UAAU,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC;IAC9C,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,mGAAmG;IACnG,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;CACtC;AAED,uEAAuE;AACvE,wBAAgB,WAAW,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,eAAe,GAAG,SAAS,CAUjF;AAoFD,sBAAsB;AACtB,wBAAgB,YAAY,CAC3B,KAAK,EAAE,UAAU,EACjB,MAAM,EAAE,eAAe,EACvB,IAAI,EAAE,aAAa,GACjB,UAAU,CAEZ;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACpC,KAAK,EAAE,UAAU,EACjB,MAAM,EAAE,eAAe,EACvB,KAAK,EAAE,OAAO,GAAG,OAAO,EACxB,KAAK,EAAE,IAAI,CAAC,oBAAoB,EAAE,MAAM,GAAG,MAAM,CAAC,GAAG,IAAI,GACvD,UAAU,CAcZ"}

package/dist/chart/edit/chartex-data.d.ts

@@ -0,0 +1,15 @@
+import type { ChartSeriesValue } from '../data-sheet.js';
+import type { ChartExSpace } from '../ex/model.js';
+/** The numeric dimension type a layout draws: `size` (treemap, sunburst), `colorVal`, `val`. */
+export declare function chartExValueType(layoutId: string): string;
+/**
+ * Sets the values of the series at `index` (numbers, or `null` for a blank). Semantics: PowerPoint.
+ */
+export declare function setChartExSeriesValues(space: ChartExSpace, index: number, values: readonly ChartSeriesValue[]): ChartExSpace;
+/**
+ * Sets the categories of every series: one list, or the levels of a hierarchy (treemap, sunburst;
+ * leaf level first). Semantics: PowerPoint (categories belong to the chart, so each series' data
+ * gets them).
+ */
+export declare function setChartExCategories(space: ChartExSpace, categories: readonly (readonly string[])[] | readonly string[]): ChartExSpace;
+//# sourceMappingURL=chartex-data.d.ts.map

package/dist/chart/edit/chartex-data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chartex-data.d.ts","sourceRoot":"","sources":["../../../chart/edit/chartex-data.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,KAAK,EAA+C,YAAY,EAAE,MAAM,aAAa,CAAC;AAG7F,gGAAgG;AAChG,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAMzD;AA+CD;;GAEG;AACH,wBAAgB,sBAAsB,CACrC,KAAK,EAAE,YAAY,EACnB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,SAAS,gBAAgB,EAAE,GACjC,YAAY,CASd;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CACnC,KAAK,EAAE,YAAY,EACnB,UAAU,EAAE,SAAS,CAAC,SAAS,MAAM,EAAE,CAAC,EAAE,GAAG,SAAS,MAAM,EAAE,GAC5D,YAAY,CAgBd"}

package/dist/chart/edit/chartex.d.ts

@@ -0,0 +1,61 @@
+import type { DrawingFill } from '../../drawingml/types.js';
+import type { ChartExBinning, ChartExSeries, ChartExSpace } from '../ex/model.js';
+/** A copy of `space` changed by `recipe`; `space` itself is never mutated. */
+export declare function editChartExSpace(space: ChartExSpace, recipe: (draft: ChartExSpace) => void): ChartExSpace;
+/** The series at `index` (compared as a position, never used as a property key). */
+export declare function chartExSeriesAt(space: ChartExSpace, index: number): ChartExSeries;
+/**
+ * Sets the chart title text, or removes the title (`undefined`). An existing rich title keeps its
+ * formatting and its first run takes the text; a title linked to a cell (`cx:txData`) or a new one
+ * becomes one rich run, as PowerPoint writes it (with the `a:bodyPr` the schema requires, which
+ * PowerPoint's builder leaves out). Semantics: PowerPoint.
+ */
+export declare function setChartExTitle(space: ChartExSpace, text: string | undefined): ChartExSpace;
+/**
+ * Shows, moves or hides the legend. A shown legend keeps its alignment, overlay and formatting; a
+ * new one is centred and not overlaid. Semantics: PowerPoint.
+ */
+export declare function setChartExLegend(space: ChartExSpace, options: {
+    visible: boolean;
+    position?: string;
+}): ChartExSpace;
+/**
+ * Shows or hides the data labels of every series. Hiding removes `cx:dataLabels`; showing keeps
+ * existing labels and gives the others category name and value. Semantics: PowerPoint.
+ */
+export declare function setChartExDataLabelsVisible(space: ChartExSpace, visible: boolean): ChartExSpace;
+/**
+ * Renames the series at `index`. A name linked to a cell keeps its formula with the new cached
+ * text (pass `keepReference: false` to drop the link); a rich or missing name becomes cached text.
+ * Semantics: PowerPoint.
+ */
+export declare function renameChartExSeries(space: ChartExSpace, index: number, name: string, options?: {
+    keepReference?: boolean;
+}): ChartExSpace;
+/** Sets (or, with `undefined`, removes) the fill of the series at `index`; the outline stays. */
+export declare function setChartExSeriesFill(space: ChartExSpace, index: number, fill: DrawingFill | undefined): ChartExSpace;
+/**
+ * Waterfall options of the series at `index`: the point indexes drawn as totals (`subtotals`, an
+ * empty list removes them) and whether connector lines show. Semantics: PowerPoint.
+ */
+export declare function setChartExWaterfall(space: ChartExSpace, index: number, options: {
+    subtotals?: readonly number[];
+    connectorLines?: boolean;
+}): ChartExSpace;
+/**
+ * Histogram binning of the series at `index`: by category (`'category'`), or numeric bins with
+ * either a bin size or a bin count (the size wins, as PowerPoint writes only one). Semantics:
+ * PowerPoint.
+ */
+export declare function setChartExBinning(space: ChartExSpace, index: number, binning: ChartExBinning | 'category'): ChartExSpace;
+/** Treemap parent label layout (`none`, `banner`, `overlapping`) of the series at `index`. */
+export declare function setChartExParentLabelLayout(space: ChartExSpace, index: number, parentLabelLayout: 'none' | 'banner' | 'overlapping'): ChartExSpace;
+/** Box and whisker options of the series at `index`. Semantics: PowerPoint. */
+export declare function setChartExBoxWhisker(space: ChartExSpace, index: number, options: {
+    quartileMethod?: 'inclusive' | 'exclusive';
+    meanLine?: boolean;
+    meanMarker?: boolean;
+    nonoutliers?: boolean;
+    outliers?: boolean;
+}): ChartExSpace;
+//# sourceMappingURL=chartex.d.ts.map

package/dist/chart/edit/chartex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chartex.d.ts","sourceRoot":"","sources":["../../../chart/edit/chartex.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EACX,cAAc,EAEd,aAAa,EAEb,YAAY,EACZ,MAAM,aAAa,CAAC;AAKrB,8EAA8E;AAC9E,wBAAgB,gBAAgB,CAC/B,KAAK,EAAE,YAAY,EACnB,MAAM,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,GACnC,YAAY,CAId;AAED,oFAAoF;AACpF,wBAAgB,eAAe,CAAC,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,GAAG,aAAa,CAOjF;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,YAAY,CAY3F;AAMD;;;GAGG;AACH,wBAAgB,gBAAgB,CAC/B,KAAK,EAAE,YAAY,EACnB,OAAO,EAAE;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAC9C,YAAY,CAYd;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,GAAG,YAAY,CAY/F;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAClC,KAAK,EAAE,YAAY,EACnB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE;IAAE,aAAa,CAAC,EAAE,OAAO,CAAA;CAAO,GACvC,YAAY,CAMd;AAED,iGAAiG;AACjG,wBAAgB,oBAAoB,CACnC,KAAK,EAAE,YAAY,EACnB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,WAAW,GAAG,SAAS,GAC3B,YAAY,CAMd;AAqBD;;;GAGG;AACH,wBAAgB,mBAAmB,CAClC,KAAK,EAAE,YAAY,EACnB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE;IAAE,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAAC,cAAc,CAAC,EAAE,OAAO,CAAA;CAAE,GAClE,YAAY,CAYd;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAChC,KAAK,EAAE,YAAY,EACnB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,cAAc,GAAG,UAAU,GAClC,YAAY,CAYd;AAED,8FAA8F;AAC9F,wBAAgB,2BAA2B,CAC1C,KAAK,EAAE,YAAY,EACnB,KAAK,EAAE,MAAM,EACb,iBAAiB,EAAE,MAAM,GAAG,QAAQ,GAAG,aAAa,GAClD,YAAY,CAId;AAED,+EAA+E;AAC/E,wBAAgB,oBAAoB,CACnC,KAAK,EAAE,YAAY,EACnB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE;IACR,cAAc,CAAC,EAAE,WAAW,GAAG,WAAW,CAAC;IAC3C,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACnB,GACC,YAAY,CAMd"}

package/dist/chart/edit/data-sheet.d.ts

@@ -0,0 +1,10 @@
+import { type ChartDataSheet, type ChartDataSheetEdit } from '../data-sheet.js';
+import type { ChartSpace } from '../model.js';
+/** The data sheet of `space`: the first series' categories, every series' name and values. */
+export declare function chartSpaceDataSheet(space: ChartSpace): ChartDataSheet;
+/**
+ * Applies data sheet edits to `space` in order, skipping any the sheet refuses at that point
+ * (`canApplyChartDataSheetEdit`). Returns `space` itself when nothing applied.
+ */
+export declare function applyChartSpaceDataSheetEdits(space: ChartSpace, edits: readonly ChartDataSheetEdit[]): ChartSpace;
+//# sourceMappingURL=data-sheet.d.ts.map

package/dist/chart/edit/data-sheet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-sheet.d.ts","sourceRoot":"","sources":["../../../chart/edit/data-sheet.ts"],"names":[],"mappings":"AASA,OAAO,EAIN,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAkB3C,8FAA8F;AAC9F,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,UAAU,GAAG,cAAc,CA8BrE;AA6DD;;;GAGG;AACH,wBAAgB,6BAA6B,CAC5C,KAAK,EAAE,UAAU,EACjB,KAAK,EAAE,SAAS,kBAAkB,EAAE,GAClC,UAAU,CAaZ"}

package/dist/chart/edit/draft.d.ts

@@ -0,0 +1,27 @@
+import type { ChartPlotGroup, ChartSpace } from '../model.js';
+import type { ChartSpaceSeries } from '../model-series.js';
+/** A copy of `space` changed by `recipe`; `space` itself is never mutated. */
+export declare function editChartSpace(space: ChartSpace, recipe: (draft: ChartSpace) => void): ChartSpace;
+/** One series with the group that holds it. */
+export interface ChartSeriesEntry {
+    group: ChartPlotGroup;
+    groupIndex: number;
+    series: ChartSpaceSeries;
+    /** Position inside the group's series list. */
+    position: number;
+}
+/** Every series of every group, in document order. */
+export declare function chartSeriesEntries(space: ChartSpace): ChartSeriesEntry[];
+/** Every series of every group, in document order. */
+export declare const chartSpaceSeries: (space: ChartSpace) => ChartSpaceSeries[];
+/**
+ * The series at flattened position `index`. The index comes from callers at run time, so it is
+ * compared as a position and never used as a property key (a key such as `__proto__` must not
+ * select an object to write through).
+ */
+export declare function chartSeriesEntryAt(space: ChartSpace, index: number): ChartSeriesEntry;
+/** The first chart group; edits that need one throw when the plot area has none. */
+export declare function firstChartGroup(space: ChartSpace): ChartPlotGroup;
+/** Sets `key` to `value`, or removes it when `value` is `undefined` (exact optional properties). */
+export declare function assignOrDelete<T extends object, K extends keyof T>(target: T, key: K, value: T[K] | undefined): void;
+//# sourceMappingURL=draft.d.ts.map

package/dist/chart/edit/draft.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"draft.d.ts","sourceRoot":"","sources":["../../../chart/edit/draft.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC3D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAExD,8EAA8E;AAC9E,wBAAgB,cAAc,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,GAAG,UAAU,CAIjG;AAED,+CAA+C;AAC/C,MAAM,WAAW,gBAAgB;IAChC,KAAK,EAAE,cAAc,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,gBAAgB,CAAC;IACzB,+CAA+C;IAC/C,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED,sDAAsD;AACtD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,UAAU,GAAG,gBAAgB,EAAE,CAIxE;AAED,sDAAsD;AACtD,eAAO,MAAM,gBAAgB,UAAW,UAAU,KAAG,gBAAgB,EACd,CAAC;AAExD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,gBAAgB,CAQrF;AAED,oFAAoF;AACpF,wBAAgB,eAAe,CAAC,KAAK,EAAE,UAAU,GAAG,cAAc,CAIjE;AAED,oGAAoG;AACpG,wBAAgB,cAAc,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,CAAC,EACjE,MAAM,EAAE,CAAC,EACT,GAAG,EAAE,CAAC,EACN,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS,GACrB,IAAI,CAGN"}

package/dist/chart/edit/fill.d.ts

@@ -0,0 +1,47 @@
+import type { DrawingColor, DrawingFill, DrawingLine } from '../../drawingml/types.js';
+import type { ChartPlotGroup, ChartSpace } from '../model.js';
+import type { ChartShapeProperties, ChartSpaceSeries } from '../model-series.js';
+import { type ChartGradientFillEdit } from './gradient.js';
+/** Chart elements with their own shape properties. */
+export declare const CHART_ELEMENT_PARTS: readonly ['chartArea', 'plotArea', 'title', 'legend', 'floor', 'sideWall', 'backWall'];
+export type ChartElementPart = (typeof CHART_ELEMENT_PARTS)[number];
+/** The fill an element declares, if any (an inherited style fill is not seen here). */
+export declare function chartElementShape(space: ChartSpace, part: ChartElementPart): ChartShapeProperties | undefined;
+/** Sets (or, with `undefined`, removes so the style applies) an element's fill. */
+export declare function setChartElementFill(space: ChartSpace, part: ChartElementPart, fill: DrawingFill | undefined): ChartSpace;
+/** Sets (or removes) an element's outline. */
+export declare function setChartElementLine(space: ChartSpace, part: ChartElementPart, line: DrawingLine | undefined): ChartSpace;
+/** Whether a group's series are coloured by their line (line, stock, scatter, unfilled radar). */
+export declare function chartGroupPaintsLine(group: Pick<ChartPlotGroup, 'kind' | 'radarStyle'>): boolean;
+/**
+ * A series moving between a filled family (bar, area, pie) and a line family keeps its colour:
+ * the fill becomes the line (Excel's 2.25 pt round-capped series line) or the line the fill, when
+ * the other paint is not set. Semantics: PowerPoint's writer, which paints a line series by its
+ * series colour; Excel's line width and cap.
+ */
+export declare function repaintSeriesForFamily(series: ChartSpaceSeries, toLine: boolean): void;
+/** Sets a series' fill (`undefined` returns it to the automatic colour); points lose their own. */
+export declare function setChartSeriesFill(space: ChartSpace, index: number, fill: DrawingFill | undefined): ChartSpace;
+/** Sets a series' outline, merged into the current one (`null` removes it). */
+export declare function setChartSeriesLine(space: ChartSpace, index: number, line: DrawingLine | null): ChartSpace;
+/**
+ * Sets the colour of a series as the Format pane's colour picker does: the fill, or the line of a
+ * series drawn as a line, keeping the previous colour's transparency. `null` removes the paint so
+ * the series takes its automatic colour again.
+ */
+export declare function setChartSeriesColor(space: ChartSpace, index: number, color: DrawingColor | null): ChartSpace;
+/** Sets a solid series fill's transparency (0..100); other fills are left alone. */
+export declare function setChartSeriesTransparency(space: ChartSpace, index: number, percent: number): ChartSpace;
+/** Sets (or removes, with `undefined`) one data point's fill, through its `c:dPt` override. */
+export declare function setChartDataPointFill(space: ChartSpace, index: number, point: number, fill: DrawingFill | undefined): ChartSpace;
+/** A gradient edit of a series fill; `undefined` when it does not apply or changes nothing. */
+export declare function editChartSeriesGradient(space: ChartSpace, index: number, edit: ChartGradientFillEdit, defaultColor: DrawingColor): {
+    space: ChartSpace;
+    stopIndex: number;
+} | undefined;
+/** A gradient edit of an element fill (a new gradient starts from its solid colour, else white). */
+export declare function editChartElementGradient(space: ChartSpace, part: ChartElementPart, edit: ChartGradientFillEdit): {
+    space: ChartSpace;
+    stopIndex: number;
+} | undefined;
+//# sourceMappingURL=fill.d.ts.map

package/dist/chart/edit/fill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fill.d.ts","sourceRoot":"","sources":["../../../chart/edit/fill.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpF,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC3D,OAAO,KAAK,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAE9E,OAAO,EAAyB,KAAK,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAG/E,sDAAsD;AACtD,eAAO,MAAM,mBAAmB,YAC/B,WAAW,EACX,UAAU,EACV,OAAO,EACP,QAAQ,EACR,OAAO,EACP,UAAU,EACV,UAAU,CACD,CAAC;AACX,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC;AAoBpE,uFAAuF;AACvF,wBAAgB,iBAAiB,CAChC,KAAK,EAAE,UAAU,EACjB,IAAI,EAAE,gBAAgB,GACpB,oBAAoB,GAAG,SAAS,CAalC;AAED,mFAAmF;AACnF,wBAAgB,mBAAmB,CAClC,KAAK,EAAE,UAAU,EACjB,IAAI,EAAE,gBAAgB,EACtB,IAAI,EAAE,WAAW,GAAG,SAAS,GAC3B,UAAU,CAIZ;AAED,8CAA8C;AAC9C,wBAAgB,mBAAmB,CAClC,KAAK,EAAE,UAAU,EACjB,IAAI,EAAE,gBAAgB,EACtB,IAAI,EAAE,WAAW,GAAG,SAAS,GAC3B,UAAU,CAIZ;AAED,kGAAkG;AAClG,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,IAAI,CAAC,cAAc,EAAE,MAAM,GAAG,YAAY,CAAC,GAAG,OAAO,CAGhG;AAQD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,CAYtF;AAMD,mGAAmG;AACnG,wBAAgB,kBAAkB,CACjC,KAAK,EAAE,UAAU,EACjB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,WAAW,GAAG,SAAS,GAC3B,UAAU,CAMZ;AAED,+EAA+E;AAC/E,wBAAgB,kBAAkB,CACjC,KAAK,EAAE,UAAU,EACjB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,WAAW,GAAG,IAAI,GACtB,UAAU,CASZ;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAClC,KAAK,EAAE,UAAU,EACjB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,YAAY,GAAG,IAAI,GACxB,UAAU,CAcZ;AAED,oFAAoF;AACpF,wBAAgB,0BAA0B,CACzC,KAAK,EAAE,UAAU,EACjB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,GACb,UAAU,CAUZ;AAED,+FAA+F;AAC/F,wBAAgB,qBAAqB,CACpC,KAAK,EAAE,UAAU,EACjB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,WAAW,GAAG,SAAS,GAC3B,UAAU,CAkBZ;AAED,+FAA+F;AAC/F,wBAAgB,uBAAuB,CACtC,KAAK,EAAE,UAAU,EACjB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,qBAAqB,EAC3B,YAAY,EAAE,YAAY,GACxB;IAAE,KAAK,EAAE,UAAU,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAOtD;AAED,oGAAoG;AACpG,wBAAgB,wBAAwB,CACvC,KAAK,EAAE,UAAU,EACjB,IAAI,EAAE,gBAAgB,EACtB,IAAI,EAAE,qBAAqB,GACzB;IAAE,KAAK,EAAE,UAAU,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAQtD"}

package/dist/chart/edit/gradient.d.ts

@@ -0,0 +1,44 @@
+import { type DrawingGradientGeometryType, type RectGradientDirection } from '../../drawingml/gradient-geometry.js';
+import type { DrawingColor, DrawingFill } from '../../drawingml/types.js';
+/** One gradient edit; `C` is the colour type a stop colour is given in. */
+export type ChartGradientFillEdit<C = DrawingColor> = {
+    kind: 'create';
+} | {
+    kind: 'preset';
+    id: number;
+} | {
+    kind: 'angle';
+    value: number;
+} | {
+    kind: 'geometry';
+    type: DrawingGradientGeometryType;
+    direction?: RectGradientDirection;
+} | {
+    kind: 'stop';
+    index: number;
+    position?: number;
+    color?: C;
+    transparency?: number;
+    brightness?: number;
+} | {
+    kind: 'add';
+    index: number;
+} | {
+    kind: 'remove';
+    index: number;
+};
+export type ChartGradientFillValue = Extract<DrawingFill, {
+    kind: 'gradient';
+}>;
+/** Transparency of a gradient stop in percent (0 when the stop is missing). */
+export declare function chartGradientStopTransparency(fill: ChartGradientFillValue, index: number): number;
+/**
+ * The gradient after `edit`, and the stop the editor should select, or `undefined` when the edit
+ * does not apply (a stop edit on a non-gradient fill) or changes nothing. `defaultColor` is the
+ * first stop of a gradient created from a non-gradient fill.
+ */
+export declare function editChartGradientFill<C = DrawingColor>(old: DrawingFill | undefined, edit: ChartGradientFillEdit<C>, defaultColor: DrawingColor, toColor?: (color: C) => DrawingColor): {
+    fill: ChartGradientFillValue;
+    stopIndex: number;
+} | undefined;
+//# sourceMappingURL=gradient.d.ts.map

package/dist/chart/edit/gradient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gradient.d.ts","sourceRoot":"","sources":["../../../chart/edit/gradient.ts"],"names":[],"mappings":"AAMA,OAAO,EAEN,KAAK,2BAA2B,EAChC,KAAK,qBAAqB,EAC1B,MAAM,mCAAmC,CAAC;AAE3C,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AASvE,2EAA2E;AAC3E,MAAM,MAAM,qBAAqB,CAAC,CAAC,GAAG,YAAY,IAC/C;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAClB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAChC;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,2BAA2B,CAAC;IAAC,SAAS,CAAC,EAAE,qBAAqB,CAAA;CAAE,GAC1F;IACA,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,CAAC,CAAC;IACV,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;CACnB,GACD;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAErC,MAAM,MAAM,sBAAsB,GAAG,OAAO,CAAC,WAAW,EAAE;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,CAAC,CAAC;AAEhF,+EAA+E;AAC/E,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,sBAAsB,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAGjG;AAOD;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,GAAG,YAAY,EACrD,GAAG,EAAE,WAAW,GAAG,SAAS,EAC5B,IAAI,EAAE,qBAAqB,CAAC,CAAC,CAAC,EAC9B,YAAY,EAAE,YAAY,EAC1B,OAAO,GAAE,CAAC,KAAK,EAAE,CAAC,KAAK,YAAuB,GAC5C;IAAE,IAAI,EAAE,sBAAsB,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CA+DjE"}

package/dist/chart/edit/group-options.d.ts

@@ -0,0 +1,14 @@
+import type { ChartSpace } from '../model.js';
+export interface ChartGroupOptionsEdit {
+    /** Gap between categories, percent of a bar's width (bar, 3-D bar, bar of pie). */
+    gapWidth?: number;
+    /** Overlap of a category's bars, percent (2-D bar). */
+    overlap?: number;
+    /** Angle of the first slice, degrees (pie, doughnut). */
+    firstSliceAngle?: number;
+    /** Doughnut hole size, percent of the diameter. */
+    holeSize?: number;
+}
+/** Edits the options of the group holding series `seriesIndex`. */
+export declare function setChartGroupOptions(space: ChartSpace, seriesIndex: number, edit: ChartGroupOptionsEdit): ChartSpace;
+//# sourceMappingURL=group-options.d.ts.map

package/dist/chart/edit/group-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"group-options.d.ts","sourceRoot":"","sources":["../../../chart/edit/group-options.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAI3C,MAAM,WAAW,qBAAqB;IACrC,mFAAmF;IACnF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yDAAyD;IACzD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,mDAAmD;IACnD,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB;AASD,mEAAmE;AACnE,wBAAgB,oBAAoB,CACnC,KAAK,EAAE,UAAU,EACjB,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,qBAAqB,GACzB,UAAU,CAcZ"}

package/dist/chart/edit/index.d.ts

@@ -0,0 +1,23 @@
+export * from './draft.js';
+export * from './paint.js';
+export * from './gradient.js';
+export * from './title.js';
+export * from './legend-labels.js';
+export * from './axes.js';
+export * from './series.js';
+export * from './series-data.js';
+export * from './type.js';
+export * from './type-axes.js';
+export { GROUP_FIELDS as CHART_GROUP_FIELDS, groupHasAxes as chartGroupHasAxes, stripSeriesForKind as chartSeriesForKind, } from './type-schema.js';
+export * from './fill.js';
+export * from './style.js';
+export * from './quick-layout.js';
+export * from './target.js';
+export * from './target-paint.js';
+export * from './group-options.js';
+export * from './intent.js';
+export * from './data-sheet.js';
+export * from './new-chart.js';
+export * from './chartex.js';
+export * from './chartex-data.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/chart/edit/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../chart/edit/index.ts"],"names":[],"mappings":"AAGA,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,cAAc,iBAAiB,CAAC;AAChC,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC;AAC9B,cAAc,QAAQ,CAAC;AACvB,cAAc,aAAa,CAAC;AAC5B,OAAO,EACN,YAAY,IAAI,kBAAkB,EAClC,YAAY,IAAI,iBAAiB,EACjC,kBAAkB,IAAI,kBAAkB,GACxC,MAAM,eAAe,CAAC;AACvB,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC"}

package/dist/chart/edit/intent.d.ts

@@ -0,0 +1,72 @@
+import type { DrawingFill, DrawingLine } from '../../drawingml/types.js';
+import type { ChartSpace } from '../model.js';
+import { type ChartAxisEdit } from './axes.js';
+import { type ChartGroupOptionsEdit } from './group-options.js';
+import { type ChartDataLabelsEdit, type ChartLegendEdit } from './legend-labels.js';
+import type { ChartFormatTarget } from './target.js';
+export type ChartEditIntent = 
+/** Replace a target's fill; `undefined` returns it to the chart style ("Automatic"). */
+{
+    op: 'fill';
+    target: ChartFormatTarget;
+    fill: DrawingFill | undefined;
+}
+/** Replace a target's outline, or with `merge` change only the given outline settings. */
+ | {
+    op: 'line';
+    target: ChartFormatTarget;
+    line: DrawingLine | undefined;
+    merge?: boolean;
+}
+/** Transparency (0..100) of a target's solid fill or solid outline, keeping its colour. */
+ | {
+    op: 'transparency';
+    target: ChartFormatTarget;
+    paint: 'fill' | 'line';
+    percent: number;
+}
+/** Axis options of the axis at `axisIndex` of `plotArea.axes`. */
+ | {
+    op: 'axis';
+    axisIndex: number;
+    edit: ChartAxisEdit;
+} | {
+    op: 'legend';
+    edit: ChartLegendEdit;
+}
+/** The chart's data labels, or one series' own labels. */
+ | {
+    op: 'dataLabels';
+    seriesIndex?: number;
+    edit: ChartDataLabelsEdit;
+}
+/** Series Options of the group holding series `seriesIndex`. */
+ | {
+    op: 'groupOptions';
+    seriesIndex: number;
+    edit: ChartGroupOptionsEdit;
+}
+/** A built-in chart style: 1..48 (`c:style`) or 101..148 (`c14:style`). */
+ | {
+    op: 'style';
+    id: number;
+}
+/** A curated Chart Styles preset (`chart/style-presets`). */
+ | {
+    op: 'stylePreset';
+    preset: string;
+}
+/** Change Colors: recolour from palette `from` to palette `to` (the caller records `to`). */
+ | {
+    op: 'colorPalette';
+    from: number;
+    to: number;
+}
+/** Quick Layout `layout` (1..11). */
+ | {
+    op: 'quickLayout';
+    layout: number;
+};
+/** Applies `intent`, returning a new model; throws like the operation it names. */
+export declare function applyChartEditIntent(space: ChartSpace, intent: ChartEditIntent): ChartSpace;
+//# sourceMappingURL=intent.d.ts.map

package/dist/chart/edit/intent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intent.d.ts","sourceRoot":"","sources":["../../../chart/edit/intent.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACtE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,EAAgB,KAAK,aAAa,EAAE,MAAM,QAAQ,CAAC;AAC1D,OAAO,EAAwB,KAAK,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AACnF,OAAO,EAGN,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACpB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAGlD,MAAM,MAAM,eAAe;AAC1B,wFAAwF;AACtF;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,iBAAiB,CAAC;IAAC,IAAI,EAAE,WAAW,GAAG,SAAS,CAAA;CAAE;AAC1E,0FAA0F;GACxF;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,iBAAiB,CAAC;IAAC,IAAI,EAAE,WAAW,GAAG,SAAS,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE;AAC3F,2FAA2F;GACzF;IAAE,EAAE,EAAE,cAAc,CAAC;IAAC,MAAM,EAAE,iBAAiB,CAAC;IAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE;AAC5F,kEAAkE;GAChE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,aAAa,CAAA;CAAE,GACtD;IAAE,EAAE,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,eAAe,CAAA;CAAE;AACzC,0DAA0D;GACxD;IAAE,EAAE,EAAE,YAAY,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,mBAAmB,CAAA;CAAE;AACvE,gEAAgE;GAC9D;IAAE,EAAE,EAAE,cAAc,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,qBAAqB,CAAA;CAAE;AAC1E,2EAA2E;GACzE;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE;AAC7B,6DAA6D;GAC3D;IAAE,EAAE,EAAE,aAAa,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE;AACvC,6FAA6F;GAC3F;IAAE,EAAE,EAAE,cAAc,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE;AAClD,qCAAqC;GACnC;IAAE,EAAE,EAAE,aAAa,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzC,mFAAmF;AACnF,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,eAAe,GAAG,UAAU,CA6B3F"}

package/dist/chart/edit/legend-labels.d.ts

@@ -0,0 +1,34 @@
+import type { ChartSpace } from '../model.js';
+/** ST_LegendPos. */
+export type ChartLegendPosition = 'b' | 'tr' | 'l' | 'r' | 't';
+export interface ChartLegendEdit {
+    visible?: boolean;
+    position?: ChartLegendPosition;
+    overlay?: boolean;
+}
+/** Shows, hides, places or overlays the legend. Hiding removes `c:legend` and its entries. */
+export declare function setChartLegend(space: ChartSpace, edit: ChartLegendEdit): ChartSpace;
+export interface ChartDataLabelsEdit {
+    show?: boolean;
+    showValue?: boolean;
+    showCategoryName?: boolean;
+    showSeriesName?: boolean;
+    showPercent?: boolean;
+    showBubbleSize?: boolean;
+    showLegendKey?: boolean;
+    /** `c:dLblPos` (`ctr`, `inEnd`, `outEnd`, `bestFit`...); `null` returns to the default. */
+    position?: string | null;
+    /** `null` removes the separator. */
+    separator?: string | null;
+    /** A number format code not linked to the source; `null` removes it. */
+    numberFormat?: string | null;
+}
+/**
+ * Edits the data labels of the whole chart (every group's `c:dLbls`) or of one series. Hiding the
+ * chart's labels also removes every series' own labels, as Office's Chart Elements box does; hiding
+ * one series' labels writes switched-off labels on it so the group's labels do not show through.
+ */
+export declare function setChartDataLabels(space: ChartSpace, edit: ChartDataLabelsEdit, target?: {
+    series?: number;
+}): ChartSpace;
+//# sourceMappingURL=legend-labels.d.ts.map

package/dist/chart/edit/legend-labels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"legend-labels.d.ts","sourceRoot":"","sources":["../../../chart/edit/legend-labels.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAI3C,oBAAoB;AACpB,MAAM,MAAM,mBAAmB,GAAG,GAAG,GAAG,IAAI,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;AAE/D,MAAM,WAAW,eAAe;IAC/B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,mBAAmB,CAAC;IAC/B,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,8FAA8F;AAC9F,wBAAgB,cAAc,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,eAAe,GAAG,UAAU,CAYnF;AAED,MAAM,WAAW,mBAAmB;IACnC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,2FAA2F;IAC3F,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,oCAAoC;IACpC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,wEAAwE;IACxE,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAoDD;;;;GAIG;AACH,wBAAgB,kBAAkB,CACjC,KAAK,EAAE,UAAU,EACjB,IAAI,EAAE,mBAAmB,EACzB,MAAM,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO,GAC9B,UAAU,CAeZ"}

package/dist/chart/edit/new-chart.d.ts

@@ -0,0 +1,14 @@
+import type { ChartDataSheet } from '../data-sheet.js';
+import type { ChartSpace } from '../model.js';
+import { type ChartTypeTarget } from './type.js';
+/** The sample data Word and PowerPoint put behind a new chart. */
+export declare const DEFAULT_CHART_DATA_SHEET: ChartDataSheet;
+export interface NewChartOptions {
+    /** The chart title; absent for no title (`c:autoTitleDeleted`). */
+    title?: string;
+    /** The worksheet the formulas name; Office's `Sheet1` by default. */
+    sheetName?: string;
+}
+/** A new chart part showing `sheet` as `target` (a column chart when `target` is absent). */
+export declare function newChartSpace(sheet?: ChartDataSheet, target?: ChartTypeTarget, options?: NewChartOptions): ChartSpace;
+//# sourceMappingURL=new-chart.d.ts.map

package/dist/chart/edit/new-chart.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"new-chart.d.ts","sourceRoot":"","sources":["../../../chart/edit/new-chart.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,KAAK,EAAkB,UAAU,EAAE,MAAM,UAAU,CAAC;AAM3D,OAAO,EAAgB,KAAK,eAAe,EAAE,MAAM,QAAQ,CAAC;AAG5D,kEAAkE;AAClE,eAAO,MAAM,wBAAwB,EAAE,cAOtC,CAAC;AAEF,MAAM,WAAW,eAAe;IAC/B,mEAAmE;IACnE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qEAAqE;IACrE,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAgBD,6FAA6F;AAC7F,wBAAgB,aAAa,CAC5B,KAAK,GAAE,cAAyC,EAChD,MAAM,CAAC,EAAE,eAAe,EACxB,OAAO,GAAE,eAAoB,GAC3B,UAAU,CA0BZ"}

package/dist/chart/edit/paint.d.ts

@@ -0,0 +1,20 @@
+import type { DrawingColor, DrawingFill } from '../../drawingml/types.js';
+/** Equality of DrawingML colours, including the ordered transform sequence. */
+export declare function sameDrawingColor(a: DrawingColor | undefined, b: DrawingColor | undefined): boolean;
+/** The opacity transforms (`alpha`, `alphaMod`, `alphaOff`) of a colour, cloned. */
+export declare const drawingColorAlphaTransforms: (color: DrawingColor | undefined) => DrawingColor['transforms'];
+/** `color` with the opacity transforms of `from` appended (a recolour keeps transparency). */
+export declare function withAlphaOf(color: DrawingColor, from: DrawingColor | undefined): DrawingColor;
+/** Transparency in percent (0..100) after the ordered transforms; the scheme is irrelevant. */
+export declare function drawingColorTransparency(color: DrawingColor): number | undefined;
+/** Checks a 0..100 percentage, with the message the chart editors show. */
+export declare function assertChartPercent(value: number, message: string): void;
+/** `color` with its opacity transforms replaced by one `a:alpha` for `percent` transparency. */
+export declare function withDrawingColorTransparency(color: DrawingColor, percent: number): DrawingColor;
+/**
+ * A gradient whose every stop is `previous` (plus its own shading transforms) recoloured to `next`;
+ * any other fill comes back unchanged. Palette transforms precede gradient shading transforms in
+ * the XML Office saves, so the stop keeps the transforms after the palette's.
+ */
+export declare function recolorPaletteGradient(fill: DrawingFill | undefined, previous: DrawingColor, next: DrawingColor): DrawingFill | undefined;
+//# sourceMappingURL=paint.d.ts.map

package/dist/chart/edit/paint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paint.d.ts","sourceRoot":"","sources":["../../../chart/edit/paint.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAIvE,+EAA+E;AAC/E,wBAAgB,gBAAgB,CAC/B,CAAC,EAAE,YAAY,GAAG,SAAS,EAC3B,CAAC,EAAE,YAAY,GAAG,SAAS,GACzB,OAAO,CAWT;AAED,oFAAoF;AACpF,eAAO,MAAM,2BAA2B,UAChC,YAAY,GAAG,SAAS,KAC7B,YAAY,CAAC,YAAY,CACoD,CAAC;AAEjF,8FAA8F;AAC9F,wBAAgB,WAAW,CAAC,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,YAAY,GAAG,SAAS,GAAG,YAAY,CAI7F;AAED,+FAA+F;AAC/F,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,GAAG,SAAS,CAOhF;AAED,2EAA2E;AAC3E,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAEvE;AAED,gGAAgG;AAChG,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,GAAG,YAAY,CAO/F;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACrC,IAAI,EAAE,WAAW,GAAG,SAAS,EAC7B,QAAQ,EAAE,YAAY,EACtB,IAAI,EAAE,YAAY,GAChB,WAAW,GAAG,SAAS,CAsBzB"}

package/dist/chart/edit/quick-layout.d.ts

@@ -0,0 +1,16 @@
+import type { ChartSpace } from '../model.js';
+/** The chart group families a Quick Layout applies to. */
+export declare const CHART_QUICK_LAYOUT_KINDS: ReadonlySet<string>;
+/** The parts of a layout; `applyChartQuickLayout` applies every part unless told otherwise. */
+export type ChartQuickLayoutPart = 'title' | 'legend' | 'dataLabels' | 'axes' | 'dataTable' | 'spacing';
+/** Whether the chart's first group takes Quick Layouts (bar, column, line, area). */
+export declare function chartSupportsQuickLayout(space: ChartSpace): boolean;
+/**
+ * Applies Quick Layout `n` (1..11). `only` limits it to some parts (a product that already writes
+ * the title or legend from its own model applies the rest). Throws for an unknown layout or a
+ * chart family without layouts.
+ */
+export declare function applyChartQuickLayout(space: ChartSpace, n: number, only?: readonly ChartQuickLayoutPart[]): ChartSpace;
+/** The Quick Layout the chart currently shows (its number), if its elements match one exactly. */
+export declare function chartQuickLayoutOf(space: ChartSpace): number | undefined;
+//# sourceMappingURL=quick-layout.d.ts.map

package/dist/chart/edit/quick-layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quick-layout.d.ts","sourceRoot":"","sources":["../../../chart/edit/quick-layout.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAW3C,0DAA0D;AAC1D,eAAO,MAAM,wBAAwB,EAAE,WAAW,CAAC,MAAM,CAAoC,CAAC;AAE9F,+FAA+F;AAC/F,MAAM,MAAM,oBAAoB,GAC7B,OAAO,GACP,QAAQ,GACR,YAAY,GACZ,MAAM,GACN,WAAW,GACX,SAAS,CAAC;AAWb,qFAAqF;AACrF,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAGnE;AA6BD;;;;GAIG;AACH,wBAAgB,qBAAqB,CACpC,KAAK,EAAE,UAAU,EACjB,CAAC,EAAE,MAAM,EACT,IAAI,GAAE,SAAS,oBAAoB,EAAc,GAC/C,UAAU,CA+BZ;AA2BD,kGAAkG;AAClG,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,GAAG,SAAS,CAGxE"}