@cj-tech-master/excelts 9.4.2 → 9.5.0

package/dist/browser/modules/excel/chart/index.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Public entry for the excelts chart module.
+ *
+ * Two complementary usage styles are supported:
+ *
+ * 1. **Functional, zero-side-effect** — tree-shakeable access to
+ *    chart builders, renderers, presets and parsers:
+ *    ```ts
+ *    import { buildChartModel, renderChartSvg } from "@cj-tech-master/excelts/chart";
+ *    const model = buildChartModel(options);
+ *    const svg   = renderChartSvg(model);
+ *    ```
+ *    Bundlers drop everything the consumer does not reference.
+ *
+ * 2. **Support installation** — enables `worksheet.addChart()`,
+ *    `workbook.xlsx.writeFile()` chart-cache population, and chart
+ *    reconstruction during XLSX load:
+ *    ```ts
+ *    import { installChartSupport } from "@cj-tech-master/excelts/chart";
+ *    installChartSupport();                    // once, at startup
+ *    worksheet.addChart(options, "A1:D20");    // now works
+ *    ```
+ *
+ * Chart support is **never installed implicitly** — consumers pay for
+ * what they ask for. The package's root `sideEffects: false` contract
+ * stays intact, so bundles that only use the functional API include
+ * exactly the code paths reachable from the exports they reference.
+ *
+ * `installChartSupport` lives in a separate module (`./install.ts`) so
+ * its host-registry wiring and the full chart builder/renderer pipeline
+ * don't get pulled in by consumers who only import one or two
+ * functional helpers.
+ */
+export { installChartSupport, uninstallChartSupport } from "./install.js";
+export { Chart, buildChartModel } from "./chart.js";
+export { buildComboChartModel } from "./chart-builder.js";
+export { fillChartCaches, fillChartExCaches, fillNumRef, fillStrRef } from "./cache-populator.js";
+export { parseChartColors, buildChartColors, parseChartStyle, buildChartStyle } from "./chart-sidecar.js";
+export { buildChartExModel } from "./chart-ex-builder.js";
+export { parseChartEx } from "./chart-ex-parser.js";
+export { canRenderChartExAsVectorPdf, drawChartExPdf, renderChartEx, renderChartExPng, renderChartExSvg, VECTOR_PDF_CHART_EX_LAYOUT_IDS } from "./chart-ex-renderer.js";
+export { applyChartExPreset, applyChartPreset, CHART_EX_PRESETS, CHART_PRESETS, EXCEL_CHART_EX_PRESETS, EXCEL_CHART_PRESETS } from "./chart-presets.js";
+export { chartExOptionsFromRows, chartExOptionsFromTable, chartOptionsFromRows, chartOptionsFromTable, seriesFromColumns } from "./chart-api.js";
+export type { AddChartExFromRowsOptions, AddChartExFromTableOptions, AddChartFromRowsOptions, AddChartFromTableOptions, SeriesFromColumnsOptions } from "./chart-api.js";
+export type { ExcelChartExPreset, ExcelChartPreset } from "./chart-presets.js";
+export { applyAxisTransform, buildChartScene, buildEffectFilter, drawChartPdf, renderChartPng, renderChartSvg } from "./chart-renderer.js";
+export type { ChartPdfDrawingSurface, ChartPdfPathOp, ChartRenderOptions, ChartScene, ChartSceneLegend, ChartSceneLine, ChartScenePieSlice, ChartSceneSeries, ChartSceneText, PdfChartRenderOptions, PdfColor, RegionMapDataOptions, RegionMapMatchRule } from "./chart-renderer.js";
+export { resolveTopologyObject } from "./topojson.js";
+export type { ResolvedRing, TopoGeometry, TopoGeometryCollection, TopologyLike } from "./topojson.js";
+export type { ChartExModel, ChartExSpace, ChartExData, ChartExDataEntry, ChartExStringDimension, ChartExNumericDimension, ChartExDimensionType, ChartExChart, ChartExPlotArea, ChartExSeries, ChartExSeriesType, ChartExDataLabels, ChartExLayoutProperties, ChartExAxis, AddChartExOptions, AddChartExHistogramOptions, AddChartExWaterfallOptions, AddChartExBoxWhiskerOptions, AddChartExSeriesOptions, ChartExType } from "./chart-ex-types.js";
+export type { ChartExEntry } from "./chart.js";
+export type { ChartEntry, ChartAnchorModel } from "./chart.js";
+export type { ChartModel, ChartType, ChartData, PlotArea, ChartTypeGroup, ChartAxis, ChartTitle, ChartLegend, AddChartOptions, AddBarChartOptions, AddBarChartSeriesOptions, AddPieChartOptions, AddPieChartSeriesOptions, AddScatterChartOptions, AddScatterChartSeriesOptions, AddSurfaceChartOptions, AddSurfaceChartSeriesOptions, AddChartSeriesOptions, AddChartRange, AddComboChartOptions, ComboChartGroupOptions, ChartStyleModel, ChartColorsModel, ChartColorsEntry, ShapeProperties, ChartTextProperties, ChartColor, ChartFill, ChartLine, PivotChartSource, SeriesBase, AddChartMarkerOptions, AddDataLabelsOptions, AddTrendlineOptions, AddErrorBarsOptions, AddDataPointOptions, AddAxisOptions, AddShapeFillOptions, AddTitleOptions, AddLegendOptions, AddPlotAreaOptions, AddTrendlineLabelOptions, AddDataLabelEntryOptions, BarChartGroup, LineChartGroup, PieChartGroup, DoughnutChartGroup, AreaChartGroup, ScatterChartGroup, BubbleChartGroup, RadarChartGroup, SurfaceChartGroup, StockChartGroup, OfPieChartGroup, BarSeries, LineSeries, PieSeries, AreaSeries, ScatterSeries, BubbleSeries, RadarSeries, SurfaceSeries, CategoryAxis, ValueAxis, DateAxis, SeriesAxis, DataLabels, DataLabelEntry, DataPoint, DataTable, Trendline, TrendlineLabel, ErrorBars, ChartMarker, ChartRichText, ChartBodyProperties, ChartParagraphProperties, ChartBullet, ChartLineSpacing, UnderlineStyle, StrikeStyle, CapStyle, ParagraphAlignment, EffectList, Shadow, Scene3D, ShapeProperties3D, Bevel, NumberReference, StringReference, NumberDataSource, AxisDataSource, View3D, BarGrouping, LineGrouping, ChartLayout, ChartParagraph, ChartTextRun, DisplayUnits, ManualLayout, LegendEntry, DataLabelPosition, LegendPosition, TrendlineType, ErrorBarType, ErrorBarDirection, ErrorBarValueType, BandFormat, UpDownBars, PictureOptions, PictureFormat, NumberLiteral, StringLiteral, MultiLevelStringReference, MultiLevelStringCache, NumberCache, StringCache, ScatterStyle, RadarStyle, StockSeries, BarDirection, BarShape, OfPieType, SplitType, AxisCrosses, AxisPosition, AxisOrientation, TickMark, TickLabelPosition, TimeUnit, LabelAlignment, DisplayBlanksAs, PrintSettings, PivotFormat, DataLabelsRange, AxisBase, PresetGeometry, CustomGeometry, CustomGeometryPath, CustomGeometryCommand, ShapeTransform, ChartBlipFill, ChartColorVariation, AddChartPictureFillImage, ChartPictureFillImageData, PivotChartOptions, ChartUnknownElement, ChartStyleElement, ChartRange } from "./types.js";
+export { parseSpPr, parseTxPr, getSpPrFillColor, getSpPrLine, getSpPrGradient, getSpPrPattern, getTxPrFontSize, getTxPrColor, buildSpPr, buildTxPr, setSpPrFill, setSpPrLine } from "./shape-properties.js";

package/dist/browser/modules/excel/chart/index.js

@@ -0,0 +1,46 @@
+/**
+ * Public entry for the excelts chart module.
+ *
+ * Two complementary usage styles are supported:
+ *
+ * 1. **Functional, zero-side-effect** — tree-shakeable access to
+ *    chart builders, renderers, presets and parsers:
+ *    ```ts
+ *    import { buildChartModel, renderChartSvg } from "@cj-tech-master/excelts/chart";
+ *    const model = buildChartModel(options);
+ *    const svg   = renderChartSvg(model);
+ *    ```
+ *    Bundlers drop everything the consumer does not reference.
+ *
+ * 2. **Support installation** — enables `worksheet.addChart()`,
+ *    `workbook.xlsx.writeFile()` chart-cache population, and chart
+ *    reconstruction during XLSX load:
+ *    ```ts
+ *    import { installChartSupport } from "@cj-tech-master/excelts/chart";
+ *    installChartSupport();                    // once, at startup
+ *    worksheet.addChart(options, "A1:D20");    // now works
+ *    ```
+ *
+ * Chart support is **never installed implicitly** — consumers pay for
+ * what they ask for. The package's root `sideEffects: false` contract
+ * stays intact, so bundles that only use the functional API include
+ * exactly the code paths reachable from the exports they reference.
+ *
+ * `installChartSupport` lives in a separate module (`./install.ts`) so
+ * its host-registry wiring and the full chart builder/renderer pipeline
+ * don't get pulled in by consumers who only import one or two
+ * functional helpers.
+ */
+export { installChartSupport, uninstallChartSupport } from "./install.js";
+export { Chart, buildChartModel } from "./chart.js";
+export { buildComboChartModel } from "./chart-builder.js";
+export { fillChartCaches, fillChartExCaches, fillNumRef, fillStrRef } from "./cache-populator.js";
+export { parseChartColors, buildChartColors, parseChartStyle, buildChartStyle } from "./chart-sidecar.js";
+export { buildChartExModel } from "./chart-ex-builder.js";
+export { parseChartEx } from "./chart-ex-parser.js";
+export { canRenderChartExAsVectorPdf, drawChartExPdf, renderChartEx, renderChartExPng, renderChartExSvg, VECTOR_PDF_CHART_EX_LAYOUT_IDS } from "./chart-ex-renderer.js";
+export { applyChartExPreset, applyChartPreset, CHART_EX_PRESETS, CHART_PRESETS, EXCEL_CHART_EX_PRESETS, EXCEL_CHART_PRESETS } from "./chart-presets.js";
+export { chartExOptionsFromRows, chartExOptionsFromTable, chartOptionsFromRows, chartOptionsFromTable, seriesFromColumns } from "./chart-api.js";
+export { applyAxisTransform, buildChartScene, buildEffectFilter, drawChartPdf, renderChartPng, renderChartSvg } from "./chart-renderer.js";
+export { resolveTopologyObject } from "./topojson.js";
+export { parseSpPr, parseTxPr, getSpPrFillColor, getSpPrLine, getSpPrGradient, getSpPrPattern, getTxPrFontSize, getTxPrColor, buildSpPr, buildTxPr, setSpPrFill, setSpPrLine } from "./shape-properties.js";

package/dist/browser/modules/excel/chart/install.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Opt-in chart-support installer.
+ *
+ * This file carries the static imports that wire the concrete chart
+ * implementation (cache populator, chart builder, ChartEx builder,
+ * preset engine, sidecar serialisers, `Chart` class and chart-api
+ * helpers) into the excel host. Keep these imports isolated in a
+ * separate module so callers who import only the types, the SVG/PNG
+ * renderers, or the parser from `./index` do not trigger the entire
+ * builder pipeline at bundle time.
+ *
+ * A single process-wide slot is populated:
+ *
+ * - The chart-support slot (`@excel/chart-host-registry`) — enables
+ *   `worksheet.addChart()`, `worksheet.addLineChart()`, chart cache
+ *   population during `workbook.xlsx.writeFile()`, and `Chart`
+ *   reconstruction during XLSX load.
+ *
+ * The slot accepts `null` to uninstall. See
+ * {@link uninstallChartSupport} for tests that need to exercise the
+ * "no chart support" error path.
+ */
+/**
+ * Install the chart runtime into the excel host.
+ *
+ * After calling this once, chart-manipulating APIs on `Worksheet`,
+ * `Workbook` and `Chartsheet` run the full chart builder and renderer
+ * pipeline instead of throwing. Subsequently-loaded workbooks also
+ * reconstruct `Chart` instances for their existing charts so consumer
+ * code can inspect / mutate them.
+ *
+ * Safe to call more than once — the registry accepts the last
+ * registration. Calling is idempotent and cheap; no shared state is
+ * mutated beyond the host-registry slot.
+ */
+export declare function installChartSupport(): void;
+/**
+ * Uninstall the chart runtime, restoring the cold-start state where
+ * chart-manipulating APIs throw. Mainly useful for tests that exercise
+ * the "no chart support" error path. In production, calling this is
+ * rarely necessary — subsequent `installChartSupport()` calls simply
+ * overwrite the previous registration.
+ */
+export declare function uninstallChartSupport(): void;

package/dist/browser/modules/excel/chart/install.js

@@ -0,0 +1,91 @@
+/**
+ * Opt-in chart-support installer.
+ *
+ * This file carries the static imports that wire the concrete chart
+ * implementation (cache populator, chart builder, ChartEx builder,
+ * preset engine, sidecar serialisers, `Chart` class and chart-api
+ * helpers) into the excel host. Keep these imports isolated in a
+ * separate module so callers who import only the types, the SVG/PNG
+ * renderers, or the parser from `./index` do not trigger the entire
+ * builder pipeline at bundle time.
+ *
+ * A single process-wide slot is populated:
+ *
+ * - The chart-support slot (`@excel/chart-host-registry`) — enables
+ *   `worksheet.addChart()`, `worksheet.addLineChart()`, chart cache
+ *   population during `workbook.xlsx.writeFile()`, and `Chart`
+ *   reconstruction during XLSX load.
+ *
+ * The slot accepts `null` to uninstall. See
+ * {@link uninstallChartSupport} for tests that need to exercise the
+ * "no chart support" error path.
+ */
+import { registerChartSupport } from "../chart-host-registry.js";
+import { ChartSpaceXform } from "../xlsx/xform/chart/chart-space-xform.js";
+import { fillChartCaches, fillChartExCaches } from "./cache-populator.js";
+import { Chart } from "./chart.js";
+import { chartExOptionsFromRows, chartExOptionsFromTable, chartOptionsFromRows, chartOptionsFromTable, seriesFromColumns } from "./chart-api.js";
+import { buildChartModel, buildComboChartModel } from "./chart-builder.js";
+import { buildChartExModel } from "./chart-ex-builder.js";
+import { parseChartEx } from "./chart-ex-parser.js";
+import { canRenderChartExAsVectorPdf, drawChartExPdf, renderChartEx, renderChartExLegendXml, renderChartExPng, rewriteChartExDataRefsToDefinedNames } from "./chart-ex-renderer.js";
+import { resolvePendingChartImages } from "./chart-images.js";
+import { applyChartExPreset, applyChartPreset } from "./chart-presets.js";
+import { drawChartPdf, renderChartPng } from "./chart-renderer.js";
+import { buildChartColors, buildChartStyle } from "./chart-sidecar.js";
+import { themeIndexToName } from "./chart-utils.js";
+/**
+ * Install the chart runtime into the excel host.
+ *
+ * After calling this once, chart-manipulating APIs on `Worksheet`,
+ * `Workbook` and `Chartsheet` run the full chart builder and renderer
+ * pipeline instead of throwing. Subsequently-loaded workbooks also
+ * reconstruct `Chart` instances for their existing charts so consumer
+ * code can inspect / mutate them.
+ *
+ * Safe to call more than once — the registry accepts the last
+ * registration. Calling is idempotent and cheap; no shared state is
+ * mutated beyond the host-registry slot.
+ */
+export function installChartSupport() {
+    const support = {
+        buildChartModel,
+        buildComboChartModel,
+        buildChartExModel,
+        applyChartPreset,
+        applyChartExPreset,
+        fillChartCaches: fillChartCaches,
+        fillChartExCaches: fillChartExCaches,
+        resolvePendingChartImages: resolvePendingChartImages,
+        buildChartStyle,
+        buildChartColors,
+        createChart: (worksheet, ids, range) => new Chart(worksheet, ids, range),
+        chartOptionsFromTable: chartOptionsFromTable,
+        chartOptionsFromRows: chartOptionsFromRows,
+        chartExOptionsFromTable: chartExOptionsFromTable,
+        chartExOptionsFromRows: chartExOptionsFromRows,
+        seriesFromColumns: seriesFromColumns,
+        parseChartEx,
+        renderChartEx,
+        renderChartExLegendXml,
+        rewriteChartExDataRefsToDefinedNames,
+        themeIndexToName,
+        createChartSpaceXform: () => new ChartSpaceXform(),
+        drawChartPdf,
+        drawChartExPdf,
+        renderChartPng,
+        renderChartExPng,
+        canRenderChartExAsVectorPdf
+    };
+    registerChartSupport(support);
+}
+/**
+ * Uninstall the chart runtime, restoring the cold-start state where
+ * chart-manipulating APIs throw. Mainly useful for tests that exercise
+ * the "no chart support" error path. In production, calling this is
+ * rarely necessary — subsequent `installChartSupport()` calls simply
+ * overwrite the previous registration.
+ */
+export function uninstallChartSupport() {
+    registerChartSupport(null);
+}

package/dist/browser/modules/excel/chart/shape-properties.d.ts

@@ -0,0 +1,156 @@
+/**
+ * Shape property (spPr) and text property (txPr) utilities.
+ *
+ * During chart parsing, spPr and txPr elements are captured as raw XML strings
+ * for perfect round-trip fidelity. These utilities provide structured read/write
+ * access to the most commonly used properties:
+ *
+ * - Fill color (solid sRGB / theme)
+ * - Line/outline color and width
+ * - Font size, bold, italic, color, family
+ *
+ * The approach: parse raw XML on demand using regex extraction (no full DOM),
+ * and generate raw XML from structured models when creating new properties.
+ */
+import type { ShapeProperties, ChartTextProperties, ChartColor, ChartFill, ChartLine } from "./types.js";
+/**
+ * Check if the object is purely a raw XML capture — `_rawXml` is set
+ * and NO structured fields have been populated. The parser produces
+ * dual-state objects (both `_rawXml` and structured) from raw bytes so
+ * downstream consumers get the best of both worlds: cheap byte-perfect
+ * round-trip PLUS typed access. Getters (`getSpPrFillColor` et al.)
+ * must prefer structured when present; setters must NOT reparse from
+ * `_rawXml` because doing so wipes any prior structured mutation.
+ *
+ * Writers must ALSO consult this predicate before short-circuiting to
+ * the raw bytes: if the model has been mutated through a direct
+ * property assignment (`spPr.fill = {...}` without routing through
+ * `setSpPrFill`), the raw bytes are stale and the structured path
+ * must win. Exported for use by `_renderSpPr` in both the classic
+ * chart-space xform and the ChartEx renderer.
+ *
+ * Previously `isRawXml` returned `true` whenever `_rawXml` was a
+ * string, which caused `setSpPrFill` → `parseSpPr` to re-read from
+ * raw and discard pending `line.width` / `fill.solid` assignments.
+ */
+export declare function isRawXmlShape(obj: {
+    _rawXml?: string;
+} | undefined): boolean;
+/**
+ * Whether a `ChartTextProperties` object is a pure raw-XML capture
+ * with no structured fields set. Analogous to {@link isRawXmlShape}
+ * for shape properties: when a caller directly assigns `txPr.color`,
+ * `txPr.size`, etc., the stale `_rawXml` must NOT win — the writer
+ * should fall through to the structured rendering path.
+ */
+export declare function isRawXmlTxPr(obj: {
+    _rawXml?: string;
+} | undefined): boolean;
+/**
+ * Extract structured fill and line properties from a raw spPr XML string.
+ * Returns the structured ShapeProperties if extraction succeeds.
+ */
+export declare function parseSpPr(spPr: ShapeProperties): ShapeProperties;
+/**
+ * Get the solid fill color from a ShapeProperties object.
+ * Works for both raw XML and structured models.
+ */
+export declare function getSpPrFillColor(spPr: ShapeProperties): ChartColor | undefined;
+/**
+ * Get the complete fill (solid / gradient / pattern / noFill) from a
+ * ShapeProperties object. Works for both raw XML and structured models.
+ * Prefer this over {@link getSpPrFillColor} when the caller needs to
+ * distinguish between "no fill", "gradient", etc. — the color-only
+ * accessor collapses all three to `undefined`.
+ */
+export declare function getSpPrFill(spPr: ShapeProperties): ChartFill | undefined;
+/**
+ * Get the line/outline properties from a ShapeProperties object.
+ */
+export declare function getSpPrLine(spPr: ShapeProperties): ChartLine | undefined;
+/**
+ * Get the gradient fill from a ShapeProperties object.
+ */
+export declare function getSpPrGradient(spPr: ShapeProperties): ChartFill["gradient"] | undefined;
+/**
+ * Get the pattern fill from a ShapeProperties object.
+ */
+export declare function getSpPrPattern(spPr: ShapeProperties): ChartFill["pattern"] | undefined;
+/**
+ * Extract structured text properties from a raw txPr XML string.
+ *
+ * Parses the fields the structured {@link ChartTextProperties} model
+ * declares:
+ *   - `size`, `bold`, `italic`, `underline`, `strike`, `cap`, `baseline`,
+ *     `kern`, `spacing`, `lang` (from the first `<a:defRPr>` / `<a:rPr>`)
+ *   - `color` (from `<a:solidFill>` inside the same element)
+ *   - `fontFamily`, `eastAsianFamily`, `complexScriptFamily`
+ *     (from `<a:latin>` / `<a:ea>` / `<a:cs>` children)
+ *   - `rotation` (from `<a:bodyPr/@rot>`)
+ *
+ * Callers that want to preserve every attribute OOXML might carry
+ * (e.g. `spc="100"`, `u="sng"`, `baseline="30000"`) must not rely on
+ * this function round-tripping via structured fields alone — keep the
+ * `_rawXml` on the txPr. This parser is a best-effort structural view
+ * for consumers that want to READ the common properties; `_rawXml`
+ * remains authoritative for write-side fidelity.
+ */
+export declare function parseTxPr(txPr: ChartTextProperties): ChartTextProperties;
+/**
+ * Get font size from a ChartTextProperties object (returns points, e.g. 10).
+ */
+export declare function getTxPrFontSize(txPr: ChartTextProperties): number | undefined;
+/**
+ * Get font color from a ChartTextProperties object.
+ */
+export declare function getTxPrColor(txPr: ChartTextProperties): ChartColor | undefined;
+/**
+ * Get the font family (typeface) declared on `<a:latin>` / `<a:cs>`
+ * within a `txPr` raw or structured object. Returns `undefined` if the
+ * properties do not carry a typeface, in which case renderers should
+ * use their own default.
+ */
+export declare function getTxPrFontFamily(txPr: ChartTextProperties): string | undefined;
+/**
+ * Get the boolean bold flag from a `txPr`'s first `a:defRPr`/`a:rPr`.
+ */
+export declare function getTxPrBold(txPr: ChartTextProperties): boolean | undefined;
+/**
+ * Get the boolean italic flag from a `txPr`'s first `a:defRPr`/`a:rPr`.
+ */
+export declare function getTxPrItalic(txPr: ChartTextProperties): boolean | undefined;
+/**
+ * Build a structured ShapeProperties object, preserving every field that
+ * `parseSpPr` can produce (fill, line, effectList, scene3d, sp3d, transform,
+ * presetGeometry, customGeometry, bwMode).
+ *
+ * Previous versions only copied a five-field subset, which caused
+ * `setSpPrFill` / `setSpPrLine` to silently strip `xfrm` / `prstGeom` /
+ * `custGeom` off the returned spPr whenever the input had been parsed from
+ * raw XML. The earlier `_rawXml` round-trip path was dropped because it lost
+ * effectList/scene3d/sp3d; we now keep all structured fields and intentionally
+ * omit `_rawXml` so that `_renderSpPr` (chart-space-xform) re-emits the spPr
+ * from the structured data.
+ */
+export declare function buildSpPr(props: ShapeProperties): ShapeProperties;
+/**
+ * Build a structured {@link ChartTextProperties} object.
+ *
+ * Returns a plain structured copy (no `_rawXml`) so downstream mutations
+ * (`props.size = 1400`) take effect when the txPr is later serialised.
+ * The writer (`_renderTxPr` / `_renderRunProperties` in
+ * `chart-space-xform.ts`) fully supports structured txPr data and only
+ * falls back to raw XML pass-through when `_rawXml` is present; returning
+ * `_rawXml` here would freeze the txPr and silently discard subsequent
+ * edits, which is a trap API.
+ */
+export declare function buildTxPr(props: ChartTextProperties): ChartTextProperties;
+/**
+ * Modify a property on an existing spPr (raw or structured).
+ * Returns a new ShapeProperties object with the modification applied.
+ */
+export declare function setSpPrFill(spPr: ShapeProperties | undefined, fill: ChartFill): ShapeProperties;
+/**
+ * Modify line properties on an existing spPr.
+ */
+export declare function setSpPrLine(spPr: ShapeProperties | undefined, line: ChartLine): ShapeProperties;