@openpresentation/opf 0.13.0 → 0.15.1

package/dist/{chart-data-Cdr6rRVV.d.ts → chart-data-BnNqgnC-.d.ts}

@@ -33,6 +33,11 @@ interface ChartMapping {
     x?: string;
     series?: string[];
 }
+/** One series of a combo chart: drawn as a clustered column or as a line with markers, against the primary (left) or secondary (right) value axis. */
+interface ChartComboSeries {
+    role: 'bar' | 'line';
+    axis: 'primary' | 'secondary';
+}
 /** A text run as table cells and headers hold them (see the schema `TextRun`). */
 type DataTextRun = string | {
     text: string;
@@ -52,7 +57,7 @@ interface DataStyledCell {
 type DataTableCell = DataTableValue | DataStyledCell;
 /** A table column header: a cell, or a DataColumn. */
 type DataTableHeader = DataTableCell | DataColumn;
-type DataDiagnosticCode = 'chart-value-not-numeric' | 'chart-data-source-unresolved' | 'dataset-unknown' | 'dataset-field-unknown' | 'data-column-duplicate' | 'chart-mapping-unknown-column' | 'chart-mapping-adapted' | 'number-format-invalid';
+type DataDiagnosticCode = 'chart-value-not-numeric' | 'dataset-unknown' | 'dataset-field-unknown' | 'data-column-duplicate' | 'chart-mapping-unknown-column' | 'chart-mapping-adapted' | 'chart-highlight-unknown-name' | 'chart-highlight-adapted' | 'number-format-invalid';
 interface DataDiagnostic {
     code: DataDiagnosticCode;
     severity: 'error' | 'warning';
@@ -80,10 +85,16 @@ type ResolvedChartData = {
     source?: DataSourceRef;
     /** The dataset id when the chart references one. */
     dataset?: string;
+    /**
+     * Combo charts only (FA-15): how each series is drawn, aligned with the series columns (`columns.slice(1)`). The series
+     * are ordered column series first, then the line series on the primary axis, then those on the secondary axis, each in
+     * plotted order, so every engine draws, exports and lists them in the legend alike.
+     */
+    combo?: ChartComboSeries[];
     diagnostics: DataDiagnostic[];
 } | {
     ok: false;
-    reason: 'data-not-inline' | 'dataset-unknown' | 'no-rows' | 'no-columns';
+    reason: 'dataset-unknown' | 'no-rows' | 'no-columns';
     message: string;
     diagnostics: DataDiagnostic[];
 };
@@ -109,9 +120,9 @@ declare function numberFormatError(format: unknown): string | undefined;
 /** Format a number with a NumberFormat; an absent or invalid format prints the General form (String(value)). */
 declare function formatDataNumber(value: number, format?: string): string;
 /** NumberFormat -> Excel format code ("General" when absent or invalid). Literal prefix/suffix text is quoted or escaped; placeholders are written '#' before '0' ("0#" -> "#0"). */
-declare function excelNumberFormat(format?: string): string;
+declare function toExcelNumberFormat(format?: string): string;
 /** Excel format code -> NumberFormat, or undefined when the code has no exact NumberFormat equivalent (General, sections, scaling commas, and placeholder orders Excel reads by position such as "0#" or "0.#0"). */
-declare function numberFormatFromExcel(code: string): string | undefined;
+declare function fromExcelNumberFormat(code: string): string | undefined;
 /** True when the value is a dataset reference (`{ dataset: "<id>" }`). */
 declare function isDatasetRef(value: unknown): value is DatasetRef;
 /** Diagnostics of the top-level datasets themselves: duplicate column names and invalid column formats. */
@@ -128,7 +139,7 @@ declare function inlineTableData<T>(table: T, document?: unknown): T;
 declare function inlineChartData<T>(chart: T, document?: unknown): T;
 /** The ids of top-level datasets that no chart or table references, in declaration order. */
 declare function unusedDatasets(document: unknown): string[];
-/** True for a chart type with an X value axis (scatter; deprecated ids resolve through their replacement first). */
+/** True for a chart type with an X value axis (scatter). */
 declare function isXYChartType(type: unknown): boolean;
 /**
  * Resolve a chart's data to the canonical positional table: [category, (x,) ...series].
@@ -174,4 +185,4 @@ declare function resolveTableData(table: unknown, document?: unknown, options?:
 /** Display value of a table cell: a number with a format (cell, else column) becomes formatted text; anything else is returned unchanged. */
 declare function tableCellDisplayValue(cell: DataTableCell, columnFormat?: string): DataTableCell;
 
-export { numberFormatFromExcel as A, resolveChartData as B, type ChartMapping as C, type DataCellValue as D, resolveTableData as E, suggestChartNumberFix as F, tableCellDisplayValue as G, unusedDatasets as H, type ResolvedChartData as R, type ChartNumberFix as a, type ChartNumberFixOperation as b, type ChartNumberFixOptions as c, type DataColumn as d, type DataDiagnostic as e, type DataDiagnosticCode as f, type DataResolveOptions as g, type DataSourceRef as h, type DataStyledCell as i, type DataTableCell as j, type DataTableHeader as k, type DataTableValue as l, type DataTextRun as m, type Dataset as n, type DatasetRef as o, type ResolvedTableData as p, chartNumber as q, datasetDiagnostics as r, excelNumberFormat as s, formatDataNumber as t, inlineChartData as u, inlineDatasets as v, inlineTableData as w, isDatasetRef as x, isXYChartType as y, numberFormatError as z };
+export { resolveChartData as A, resolveTableData as B, type ChartMapping as C, type DataCellValue as D, suggestChartNumberFix as E, tableCellDisplayValue as F, toExcelNumberFormat as G, unusedDatasets as H, type ChartComboSeries as I, type ResolvedChartData as R, type ChartNumberFix as a, type ChartNumberFixOperation as b, type ChartNumberFixOptions as c, type DataColumn as d, type DataDiagnostic as e, type DataDiagnosticCode as f, type DataResolveOptions as g, type DataSourceRef as h, type DataStyledCell as i, type DataTableCell as j, type DataTableHeader as k, type DataTableValue as l, type DataTextRun as m, type Dataset as n, type DatasetRef as o, type ResolvedTableData as p, chartNumber as q, datasetDiagnostics as r, formatDataNumber as s, fromExcelNumberFormat as t, inlineChartData as u, inlineDatasets as v, inlineTableData as w, isDatasetRef as x, isXYChartType as y, numberFormatError as z };