reamkit 1.15.4 → 1.17.0

package/dist/esm/core/drawingml/chart-geometry.d.ts

@@ -1,4 +1,4 @@
-import { Chart, ChartSeries } from '../document-model/index.js';
+import { Chart, ChartSeries, ShapeDash } from '../document-model/index.js';
 /**
  * An axis-aligned rectangle in the scene's local y-up frame: bars, scatter
  * point markers, legend swatches. Position is the bottom-left corner.
@@ -11,6 +11,8 @@ export interface ChartRect {
     readonly fillHex?: string;
     readonly strokeHex?: string;
     readonly strokeWidthPt?: number;
+    /** §20.1.10.49 — the outline's preset dash, when it names one. */
+    readonly strokeDash?: ShapeDash;
 }
 /** An open stroked polyline: line-chart series, gridlines and axis lines. */
 export interface ChartPolyline {
@@ -51,6 +53,13 @@ export interface ChartLabel {
     readonly sizePt: number;
     readonly colorHex: string;
     readonly align: LabelAlign;
+    /**
+     * §21.2.2.216 `c:title/c:txPr/a:bodyPr@rot` — a value-axis title reads
+     * bottom-to-top (`rot="-5400000"`, the default every reader applies). Degrees
+     * counter-clockwise about the anchor; `align` then runs along the ROTATED
+     * reading direction.
+     */
+    readonly rotationDeg?: number;
 }
 /**
  * The fully laid-out chart: rectangles, polylines, wedges and labels (plus
@@ -64,6 +73,20 @@ export interface ChartScene {
     readonly wedges: ReadonlyArray<ChartWedge>;
     readonly labels: ReadonlyArray<ChartLabel>;
     readonly polygons?: ReadonlyArray<ChartPolygon>;
+    /** §21.2.2.198 chart-space fill + outline: drawn under everything else. */
+    readonly background?: ChartRect;
+    /**
+     * §21.2.2.145 the PLOT rectangle's own fill + outline, drawn over the chart
+     * frame and under the gridlines.
+     */
+    readonly plotBackground?: ChartRect;
+    /**
+     * Major gridlines, drawn UNDER the plotted data. Kept apart from the other
+     * polylines because z-order is the whole point: gridlines over the bars strip
+     * every one of them with the axis's own ruling, which is not what any
+     * spreadsheet draws.
+     */
+    readonly gridlines?: ReadonlyArray<ChartPolyline>;
 }
 /**
  * Injected text-width measurer: the rendered advance width (points) of `text` at
@@ -115,18 +138,19 @@ export declare function niceScale(dataMin: number, dataMax: number, maxTicks?: n
  * @returns The label text.
  */
 export declare function formatTick(v: number, step: number): string;
+export declare function buildBarScene(chart: Chart, wPt: number, hPt: number, measure: MeasureText): ChartScene;
 /**
- * Lay out a bar/column {@link Chart} into a {@link ChartScene}. Honours
- * `chart.grouping` (clustered / stacked / percentStacked) and `chart.barDir`
- * (column vs horizontal bar), over the shared cartesian frame.
+ * The name a series shows in the legend: its own `c:tx`, or Excel's positional
+ * `SeriesN` when it has none. Exported because the SUBSET has to know it too —
+ * a name invented at draw time is a name no glyph collector ever saw, and
+ * 57362.xlsx drew its unnamed series as "eries1", the capital S appearing
+ * nowhere else on the page and so nowhere in the font.
  *
- * @param chart   The bar/column chart.
- * @param wPt     Frame width in points.
- * @param hPt     Frame height in points.
- * @param measure Text measurer used to size labels and reserve axis gutters.
- * @returns The positioned scene primitives.
+ * @param series The series.
+ * @param index  Its zero-based index in the chart.
+ * @returns The legend text.
  */
-export declare function buildBarScene(chart: Chart, wPt: number, hPt: number, measure: MeasureText): ChartScene;
+export declare function legendSeriesName(series: ChartSeries, index: number): string;
 /**
  * Lay out an area {@link Chart} into a {@link ChartScene}: each series becomes a
  * filled polygon down to the value baseline (stacked when `chart.grouping` is