@openpresentation/opf 0.12.1 → 0.13.0

package/dist/lint-B7azdiuE.d.ts

@@ -0,0 +1,197 @@
+import { C as CatalogKind } from './catalogs-ywCamd8C.js';
+import { V as ValidationIssue } from './validator-CIylxoIm.js';
+import { J as JsonPrimitive } from './schemas-BbPonsTz.js';
+import { T as TextMeasurement } from './composition-D7we69Tr.js';
+
+/** Same three levels as `lintSource`. */
+type AuditSeverity = LintSeverity;
+type AuditCategory = 'accessibility' | 'design' | 'content';
+/** One JSON Patch operation (RFC 6902 subset) a quick fix applies. Paths are JSON Pointers into the audited document. */
+interface AuditPatchOperation {
+    op: 'add' | 'replace' | 'remove';
+    path: string;
+    value?: unknown;
+}
+/**
+ * A suggested repair. Core never applies it: a host shows it and applies it through its own undoable edit path.
+ * `focus` fixes only name the field the author must fill in; `patch` fixes are small, deterministic and leave
+ * every unrelated field untouched.
+ */
+interface AuditFix {
+    /** Stable id within one diagnostic, such as `focus-alt` or `inherit-text-color`. */
+    id: string;
+    label: string;
+    kind: 'patch' | 'focus';
+    /** True when applying the fix cannot change the meaning of the content (a colour switched to a readable one, a field focused). */
+    safe: boolean;
+    patch?: AuditPatchOperation[];
+    /** For `focus`: the JSON Pointer of the field to edit and a hint of what it is. */
+    focus?: {
+        path: string;
+        field: 'alt' | 'title' | 'text' | 'link' | 'language' | 'fontSize';
+        value?: unknown;
+    };
+}
+interface AuditDiagnostic extends LintDiagnostic {
+    /** `audit/<rule>`; ids are stable across releases. */
+    ruleId: string;
+    /** Zero-based slide index when the finding belongs to one slide. */
+    slide?: number;
+    slideId?: string;
+    category: AuditCategory;
+    /** Measured values behind the finding (ratios, sizes, counts), for reporters and tests. */
+    measured?: Record<string, number | string | boolean | null>;
+    fixes?: AuditFix[];
+}
+interface AuditThresholds {
+    /** Minimum WCAG contrast ratio for normal text. WCAG 2.x AA: 4.5. */
+    contrastNormal: number;
+    /** Minimum ratio for large text (at least 18 pt, or 14 pt bold). WCAG 2.x AA: 3. */
+    contrastLarge: number;
+    /** Smallest rendered text size, in points, before `audit/min-font-size` reports. */
+    minFontSizePt: number;
+    /** Words on one slide above which `audit/slide-word-count` reports. */
+    maxWordsPerSlide: number;
+    /** Distinct font families across the deck above which `audit/font-family-count` reports. */
+    maxFontFamilies: number;
+    /** Minimum effective pixels per inch of an embedded raster image at its displayed size. */
+    minImagePpi: number;
+    /** Largest title offset between slides of the same layout, as a fraction of the slide width/height. */
+    titlePositionTolerance: number;
+    /** Smallest CIE76 colour difference between two chart series (after colour-vision simulation) before they count as confusable. */
+    minSeriesColorDifference: number;
+}
+interface AuditOptions {
+    /** Per-rule severity, or `off`. Keys are full ids (`audit/text-contrast`) or the bare name (`text-contrast`). */
+    rules?: Record<string, AuditSeverity | 'off'>;
+    /** Rules not to run (full ids or bare names). */
+    ignore?: readonly string[];
+    /** When set, run only these rules (full ids or bare names). */
+    only?: readonly string[];
+    /**
+     * Suppress a rule below a JSON Pointer prefix, for one accepted exception, for example
+     * `{rule: 'audit/text-contrast', path: '/slides/3'}`. A prefix matches whole path segments.
+     */
+    ignorePaths?: readonly {
+        rule: string;
+        path: string;
+    }[];
+    thresholds?: Partial<AuditThresholds>;
+    /** Loaded catalog records, consulted after the document's own `catalogs` and before the bundled ones. */
+    catalogs?: Partial<Record<CatalogKind, readonly unknown[]>>;
+    /**
+     * The host's measured fonts. Without it composition uses core's portable estimate; see docs/audit.md.
+     * A function receives the zero-based slide index, so a host can supply a script-aware measurement per slide.
+     */
+    textMeasurement?: TextMeasurement | ((slideIndex: number) => TextMeasurement | undefined);
+    /** Chart series palette (opaque `#RRGGBB`), in the engine's order. Default: the palette opf-render and opf-pptx use. */
+    chartPalette?: readonly string[];
+}
+interface AuditRuleInfo {
+    /** Stable `audit/<name>` id. */
+    id: string;
+    name: string;
+    category: AuditCategory;
+    /** Default severity. */
+    severity: AuditSeverity;
+    summary: string;
+    /** Why the rule exists. */
+    rationale: string;
+    /** The accessibility or design standard it follows, when there is one. */
+    standard?: string;
+    /** What the check cannot see or approximates. */
+    approximations?: string;
+    /** Threshold names (`AuditThresholds`) the rule reads. */
+    thresholds?: (keyof AuditThresholds)[];
+}
+interface AuditReport {
+    /** True when no finding has severity `error` (the same meaning as lint's `valid`). */
+    valid: boolean;
+    /** False when the document failed schema validation, so no design rule was run. */
+    documentValid: boolean;
+    diagnostics: AuditDiagnostic[];
+    counts: Record<AuditSeverity, number>;
+    /** Rule ids that ran, in registry order. */
+    rulesRun: string[];
+    slideCount: number;
+    thresholds: AuditThresholds;
+    checks: {
+        /** `estimated` unless the host supplied `textMeasurement`. */
+        textMeasurement: 'estimated' | 'provided';
+        /** Text contrast is computed against solid, gradient and pattern backgrounds; picture pixels are never read. */
+        backgroundPixels: 'not-read';
+        /** Image resolution reads only embedded `data:` images; URLs are never fetched. */
+        imageBytes: 'embedded-only';
+        nativeExport: 'not-checked';
+    };
+}
+
+type LintSeverity = 'error' | 'warning' | 'info';
+interface LintLocation {
+    offset: number;
+    length: number;
+    line: number;
+    column: number;
+}
+interface LintSuggestion {
+    value: JsonPrimitive;
+    label: string;
+    origin: 'schema' | 'built-in' | 'loaded' | 'document' | 'contract';
+    definition: string;
+}
+interface LintDiagnostic {
+    ruleId: string;
+    severity: LintSeverity;
+    /** JSON Pointer into the document, or the explicitly supplied lint context. */
+    path: string;
+    scope: 'document' | 'context';
+    message: string;
+    help: string;
+    definition?: string;
+    lookup?: string[];
+    suggestions?: LintSuggestion[];
+    /** Full validation issue retained, including errors inside union alternatives. */
+    validation?: ValidationIssue;
+    /** Original-source UTF-16 offsets and one-based line/column. */
+    location?: LintLocation;
+    /**
+     * Suggested repairs (the audit fix shape: JSON Patch that core never applies). RR-54: an
+     * `opf/chart-value-not-numeric` cell whose column is written in one display style carries the column's fix.
+     */
+    fixes?: AuditFix[];
+}
+interface LintContract {
+    /** JSON Pointer pattern; a complete '*' segment matches one path segment. */
+    path: string;
+    allowedValues: JsonPrimitive[];
+    severity?: LintSeverity;
+    message?: string;
+    documentation?: string;
+}
+interface LintOptions {
+    /** Records already loaded by the host. This API never fetches catalog URLs. */
+    catalogs?: Partial<Record<CatalogKind, readonly unknown[]>>;
+    /** Explicit host policy. Document metadata is never interpreted as policy. */
+    contracts?: readonly LintContract[];
+}
+interface LintReport {
+    valid: boolean;
+    schemaValid: boolean | null;
+    diagnostics: LintDiagnostic[];
+    counts: Record<LintSeverity, number>;
+    checks: {
+        syntax: 'checked' | 'not-applicable';
+        schema: 'checked' | 'not-run';
+        catalogReferences: 'local-context' | 'not-run';
+        assetReferences: 'registry-only' | 'not-run';
+        contracts: 'checked' | 'not-run';
+        layout: 'not-checked';
+        fonts: 'not-checked';
+        nativeExport: 'not-checked';
+    };
+}
+declare function lintPresentation(document: unknown, options?: LintOptions): LintReport;
+/** Lint strict JSON source without normalizing whitespace or duplicate keys. */
+declare function lintSource(source: string, options?: LintOptions): LintReport;
+
+export { type AuditThresholds as A, type LintDiagnostic as L, type AuditOptions as a, type AuditReport as b, type AuditRuleInfo as c, type AuditCategory as d, type AuditDiagnostic as e, type AuditFix as f, type AuditPatchOperation as g, type AuditSeverity as h, type LintLocation as i, type LintSeverity as j, type LintContract as k, type LintOptions as l, type LintReport as m, type LintSuggestion as n, lintPresentation as o, lintSource as p };

package/dist/lint.d.ts

@@ -1,70 +1,7 @@
-import { C as CatalogKind } from './catalogs-BnI7JKcn.js';
-import { V as ValidationIssue } from './validator-DfG9yxba.js';
-import { J as JsonPrimitive } from './schemas-BSjlG8-R.js';
-import './presentation-DcF-MZcz.js';
-
-type LintSeverity = 'error' | 'warning' | 'info';
-interface LintLocation {
-    offset: number;
-    length: number;
-    line: number;
-    column: number;
-}
-interface LintSuggestion {
-    value: JsonPrimitive;
-    label: string;
-    origin: 'schema' | 'built-in' | 'loaded' | 'document' | 'contract';
-    definition: string;
-}
-interface LintDiagnostic {
-    ruleId: string;
-    severity: LintSeverity;
-    /** JSON Pointer into the document, or the explicitly supplied lint context. */
-    path: string;
-    scope: 'document' | 'context';
-    message: string;
-    help: string;
-    definition?: string;
-    lookup?: string[];
-    suggestions?: LintSuggestion[];
-    /** Full validation issue retained, including errors inside union alternatives. */
-    validation?: ValidationIssue;
-    /** Original-source UTF-16 offsets and one-based line/column. */
-    location?: LintLocation;
-}
-interface LintContract {
-    /** JSON Pointer pattern; a complete '*' segment matches one path segment. */
-    path: string;
-    allowedValues: JsonPrimitive[];
-    severity?: LintSeverity;
-    message?: string;
-    documentation?: string;
-}
-interface LintOptions {
-    /** Records already loaded by the host. This API never fetches catalog URLs. */
-    catalogs?: Partial<Record<CatalogKind, readonly unknown[]>>;
-    /** Explicit host policy. Document metadata is never interpreted as policy. */
-    contracts?: readonly LintContract[];
-}
-interface LintReport {
-    valid: boolean;
-    schemaValid: boolean | null;
-    diagnostics: LintDiagnostic[];
-    counts: Record<LintSeverity, number>;
-    checks: {
-        syntax: 'checked' | 'not-applicable';
-        schema: 'checked' | 'not-run';
-        catalogReferences: 'local-context' | 'not-run';
-        assetReferences: 'registry-only' | 'not-run';
-        contracts: 'checked' | 'not-run';
-        layout: 'not-checked';
-        fonts: 'not-checked';
-        nativeExport: 'not-checked';
-    };
-}
-/** Read-only lint with actionable schema, local catalog and explicit policy context. */
-declare function lintPresentation(document: unknown, options?: LintOptions): LintReport;
-/** Lint strict JSON source without normalizing whitespace or duplicate keys. */
-declare function lintSource(source: string, options?: LintOptions): LintReport;
-
-export { type LintContract, type LintDiagnostic, type LintLocation, type LintOptions, type LintReport, type LintSeverity, type LintSuggestion, lintPresentation, lintSource };
+import './catalogs-ywCamd8C.js';
+import './validator-CIylxoIm.js';
+import './schemas-BbPonsTz.js';
+export { k as LintContract, L as LintDiagnostic, i as LintLocation, l as LintOptions, m as LintReport, j as LintSeverity, n as LintSuggestion, o as lintPresentation, p as lintSource } from './lint-B7azdiuE.js';
+import './presentation-mG-IYErQ.js';
+import './composition-D7we69Tr.js';
+import './chart-data-Cdr6rRVV.js';

package/dist/lint.js

@@ -1,6 +1,6 @@
-export { lintPresentation, lintSource } from './chunk-MWPMJE6P.js';
-import './chunk-JKVKYVWL.js';
-import './chunk-HOBSL7AJ.js';
+export { lintPresentation, lintSource } from './chunk-INU7ZNSB.js';
+import './chunk-IYCJUKWD.js';
+import './chunk-MPM7NRG7.js';
 import './chunk-S5W34SIJ.js';
 import './chunk-E34DJ5LL.js';
-import './chunk-4LAM3N6S.js';
+import './chunk-7QBCWNWL.js';

package/dist/markdown.d.ts

@@ -1,8 +1,10 @@
-import { LintDiagnostic, LintLocation, LintSeverity } from './lint.js';
-import { P as Presentation } from './presentation-DcF-MZcz.js';
-import './catalogs-BnI7JKcn.js';
-import './schemas-BSjlG8-R.js';
-import './validator-DfG9yxba.js';
+import { L as LintDiagnostic, i as LintLocation, j as LintSeverity } from './lint-B7azdiuE.js';
+import { P as Presentation } from './presentation-mG-IYErQ.js';
+import './catalogs-ywCamd8C.js';
+import './schemas-BbPonsTz.js';
+import './validator-CIylxoIm.js';
+import './composition-D7we69Tr.js';
+import './chart-data-Cdr6rRVV.js';
 
 interface EmbeddedPart {
     /** JSON Pointer into the OPF document. */

package/dist/markdown.js

@@ -1,10 +1,10 @@
-import { same, isRecord, parseQuoteLines, levelsFromIndents, parseCodeFence, splitWhen, runText, isPlainRun, FORMATTING, fenceCode } from './chunk-V2537ENL.js';
-import { lintPresentation } from './chunk-MWPMJE6P.js';
-import { validatePresentation } from './chunk-JKVKYVWL.js';
-import './chunk-HOBSL7AJ.js';
+import { same, isRecord, parseQuoteLines, levelsFromIndents, parseCodeFence, splitWhen, runText, isPlainRun, FORMATTING, fenceCode } from './chunk-II5EYKZU.js';
+import { lintPresentation } from './chunk-INU7ZNSB.js';
+import { validatePresentation } from './chunk-IYCJUKWD.js';
+import './chunk-MPM7NRG7.js';
 import './chunk-S5W34SIJ.js';
 import './chunk-E34DJ5LL.js';
-import './chunk-4LAM3N6S.js';
+import './chunk-7QBCWNWL.js';
 import { parseDocument, YAMLMap, Scalar, stringify } from 'yaml';
 
 // src/markdown/canon.ts

package/dist/pagination.d.ts

@@ -1,4 +1,5 @@
-import { T as TextMeasurement, C as ComposeSlideOptions, F as FontSchemeDiagnostic, L as LayoutDiagnostic } from './composition-DWbCiMwF.js';
+import { T as TextMeasurement, C as ComposeSlideOptions, F as FontSchemeDiagnostic, L as LayoutDiagnostic } from './composition-D7we69Tr.js';
+import './chart-data-Cdr6rRVV.js';
 
 interface PaginationOptions extends ComposeSlideOptions {
     /** Readability floor used while choosing page breaks. Default 24 reference pixels. */

package/dist/pagination.js

@@ -1,6 +1,6 @@
-export { OPFPaginationError, paginatePresentation, paginateSlide } from './chunk-AUM5MXBR.js';
-import './chunk-JKVKYVWL.js';
-import './chunk-HOBSL7AJ.js';
+export { OPFPaginationError, paginatePresentation, paginateSlide } from './chunk-RAYB46AB.js';
+import './chunk-IYCJUKWD.js';
+import './chunk-MPM7NRG7.js';
 import './chunk-S5W34SIJ.js';
 import './chunk-E34DJ5LL.js';
-import './chunk-4LAM3N6S.js';
+import './chunk-7QBCWNWL.js';

package/dist/patch.js

@@ -1,6 +1,6 @@
-export { PatchError, PatchValidationError, applyPatch, applyPatchWithInverse, escapePointerToken, formatPointer, getAtPointer, hasPointer, invertPatch, jsonEqual, normalizePatch, parsePointer, pointerFromPath, readPointer, splitPointer, unescapePointerToken } from './chunk-RUC7L5DJ.js';
-import './chunk-JKVKYVWL.js';
-import './chunk-HOBSL7AJ.js';
+export { PatchError, PatchValidationError, applyPatch, applyPatchWithInverse, escapePointerToken, formatPointer, getAtPointer, hasPointer, invertPatch, jsonEqual, normalizePatch, parsePointer, pointerFromPath, readPointer, splitPointer, unescapePointerToken } from './chunk-IS2CPNVJ.js';
+import './chunk-IYCJUKWD.js';
+import './chunk-MPM7NRG7.js';
 import './chunk-S5W34SIJ.js';
 import './chunk-E34DJ5LL.js';
-import './chunk-4LAM3N6S.js';
+import './chunk-7QBCWNWL.js';

package/dist/{presentation-DcF-MZcz.d.ts → presentation-mG-IYErQ.d.ts}

@@ -403,6 +403,12 @@ type NumberingStyle = ("arabic" | "roman-upper" | "roman-lower" | "alpha-upper"
  * via the `definition` "ChartDataCell".
  */
 type ChartDataCell = (string | number | boolean | null);
+/**
+ * The dataset columns to use, by name and in order. Absent uses every column.
+ *
+ * @minItems 1
+ */
+type DatasetFields = [string, ...(string)[]];
 /**
  * A scalar, rich-run array, or styled/spanning cell object. Existing scalar and rich forms remain valid.
  *
@@ -417,6 +423,12 @@ type TableCell = (TableCellValue | StyledTableCell);
  * via the `definition` "TableCellValue".
  */
 type TableCellValue = (string | number | boolean | null | TextRun[]);
+/**
+ * Dataset tables only: the dataset columns to show, by name and in order. Absent shows every column. An unknown name is a 'dataset-field-unknown' error.
+ *
+ * @minItems 1
+ */
+type DatasetFields1 = [string, ...(string)[]];
 /**
  * A content leaf or recursively composed group. A group contains blocks and optional composition; it cannot mix blocks with leaf payload fields. Groups may nest up to 32 levels.
  *
@@ -688,6 +700,7 @@ interface Presentation {
      * Sources that text runs cite with 'cite'. Ids are unique. A cited reference is listed in the footnote area of every slide that cites it, with a marker number assigned per deck in order of first use; a reference no run cites is a lint warning (opf/unused-reference). referencesSlide() turns the cited references into an ordinary list slide.
      */
     references?: Reference[];
+    datasets?: Datasets;
     assets?: Assets;
     catalogs?: Catalogs;
     /**
@@ -2199,7 +2212,7 @@ interface NumberVariable {
      */
     example?: number;
     /**
-     * Display pattern used by '{{<id>}}'. A literal prefix, a numeric part of '#', '0', ',' and '.', and a literal suffix. '0' pads digits, '#' is optional, ',' groups thousands, digits after '.' fix the decimals ('0' required, '#' optional), and a '%' in the suffix scales by 100. English separators only. Absent: the shortest decimal form.
+     * Display pattern used by '{{<id>}}' (the shared NumberFormat syntax). A literal prefix, a numeric part of '#', '0', ',' and '.', and a literal suffix. '0' pads digits, '#' is optional, ',' groups thousands, digits after '.' fix the decimals ('0' required, '#' optional), and a '%' in the suffix scales by 100. English separators only. Absent: the shortest decimal form.
      */
     format?: string;
 }
@@ -2760,9 +2773,10 @@ interface Chart {
      */
     type: string;
     /**
-     * Chart data. Inline data uses a tabular columns/rows shape; renderers convert rows to chart series internally.
+     * Chart data. Inline data uses a tabular columns/rows shape; renderers convert rows to chart series internally. A DatasetRef ({ "dataset": "<id>" }) plots a top-level dataset instead. A ChartDataSource is not resolved by any engine (a 'chart-data-source-unresolved' warning; engines draw a placeholder); prefer inline data with a 'source'.
      */
-    data: (ChartData | ChartDataSource);
+    data: (ChartData | ChartDataSource | DatasetRef);
+    mapping?: ChartMapping;
     axisTitles?: ChartAxisTitles;
     /**
      * Optional legend position. 'none' hides the legend. Absent keeps today's behaviour exactly (a legend at the right of multi-series charts and of pie and doughnut charts, none for single-series charts). A named position shows the legend there even for a single-series chart. Of the Office 2016 constructs only box-and-whisker takes a legend; histogram, pareto, waterfall, funnel, treemap and map drop the option with a 'chart-option-adapted' diagnostic.
@@ -2774,24 +2788,72 @@ interface Chart {
     dataLabels?: (boolean | ChartDataLabels);
 }
 /**
- * Inline tabular data driving a chart. The first column usually supplies category/x-axis labels; subsequent columns are plotted measures unless a chart type or renderer maps them differently.
+ * Inline tabular data driving a chart. The first column usually supplies category/x-axis labels; subsequent columns are plotted measures unless 'chart.mapping' or a chart type maps them differently. Value cells are numbers; a string is read only in strict decimal syntax ('12', '-3.5', '1e6'), and anything else ('12%', '$5', '(5)', '1,234') is a gap and a 'chart-value-not-numeric' warning.
  *
  * This interface was referenced by `Presentation`'s JSON-Schema
  * via the `definition` "ChartData".
  */
 interface ChartData {
     /**
-     * Ordered column labels for the chart data table.
+     * Ordered column labels for the chart data table. A label is a string or a DataColumn ({ "name", "format" }) whose number format the data labels, value axis and exported workbook use.
      *
      * @minItems 1
      */
-    columns: [string, ...(string)[]];
+    columns: [(string | DataColumn), ...((string | DataColumn))[]];
     /**
      * Tabular chart rows. Each row aligns by index with columns.
      *
      * @minItems 1
      */
     rows: [ChartDataCell[], ...(ChartDataCell[])[]];
+    source?: DataSourceRef;
+}
+/**
+ * A named data column with an optional number format. Anywhere a chart or dataset column is a string it may be a DataColumn; the string form is { "name": value } with no format. A table column header may also be a DataColumn.
+ *
+ * This interface was referenced by `Presentation`'s JSON-Schema
+ * via the `definition` "DataColumn".
+ */
+interface DataColumn {
+    /**
+     * Column label, used as the series name, the table header and the name 'fields' and 'chart.mapping' address.
+     */
+    name: string;
+    /**
+     * Number format of the column's number values (data labels, value axis, table cells, exported workbook). Absent: the General form.
+     */
+    format?: string;
+}
+/**
+ * Optional provenance: where this inline data came from. Engines never read, fetch or refresh it; they keep it through editing, export and re-import.
+ */
+interface DataSourceRef {
+    /**
+     * Where the data came from: an 'asset:<id>' reference, a URL, or a relative or local path.
+     */
+    src: string;
+    /**
+     * Sheet or table name inside a spreadsheet source.
+     */
+    sheet?: string;
+    /**
+     * A1-style range inside a spreadsheet source.
+     */
+    range?: string;
+    /**
+     * The source fields the data was taken from, in order.
+     */
+    fields?: string[];
+    /**
+     * When the data was taken from the source: an ISO 8601 date or date-time.
+     */
+    retrieved?: ({
+        [k: string]: unknown;
+    } & string);
+    /**
+     * Free-form note about the source.
+     */
+    description?: string;
 }
 /**
  * Chart data sourced from an asset reference, URL, data URI, relative path, or local path such as CSV, TSV, JSON, or XLSX. The source is interpreted as a table; optional columns select or order fields from that table.
@@ -2817,6 +2879,38 @@ interface ChartDataSource {
      */
     columns?: string[];
 }
+/**
+ * Chart data taken from a top-level dataset. Engines inline it before plotting; 'chart.mapping' names columns after the 'fields' selection.
+ *
+ * This interface was referenced by `Presentation`'s JSON-Schema
+ * via the `definition` "DatasetRef".
+ */
+interface DatasetRef {
+    /**
+     * Id of the dataset. An unknown id is a 'dataset-unknown' error.
+     */
+    dataset: string;
+    fields?: DatasetFields;
+}
+/**
+ * Optional series mapping by column name: which column is the category, which is the X column of a scatter chart, and which columns are plotted, in order. Absent keeps the positional rule (first column the category, then the X column for scatter, every other column a series).
+ */
+interface ChartMapping {
+    /**
+     * The label (category) column. Default: the first column.
+     */
+    category?: string;
+    /**
+     * The X column of an XY (scatter) chart. Default: the second column (the first, when the category is the second column), and only when there are three or more columns: with two, the second column is the one series, plotted against row numbers. An X that leaves no series is plotted as the series with a 'chart-mapping-adapted' warning.
+     */
+    x?: string;
+    /**
+     * The plotted columns, in order. Default: every column that is not the category or the X column.
+     *
+     * @minItems 1
+     */
+    series?: [string, ...(string)[]];
+}
 /**
  * Optional axis titles. Absent keeps today's untitled axes. Supported on the chart types that have a category/value (or X/Y) axis pair (column, bar, line, area, scatter, and the histogram, pareto, waterfall and box-and-whisker constructs; the funnel construct takes a category title only); a title on a type without that axis (pie, doughnut, radar, treemap, map) is dropped with a 'chart-option-adapted' diagnostic by renderers and exporters.
  */
@@ -2857,13 +2951,18 @@ interface ChartDataLabels {
  */
 interface Table {
     /**
-     * Optional column labels. Labels may be strings, rich runs or styled cell objects. Null is an empty label or a placeholder covered by a preceding column span.
+     * Optional column labels. Labels may be strings, rich runs, styled cell objects or DataColumn objects ({ "name", "format" }). A header's 'format' (DataColumn or StyledTableCell) is the column's number format; a body cell's own format wins. Null is an empty label or a placeholder covered by a preceding column span.
      */
-    columns?: (string | TextRun[] | StyledTableCell | null)[];
+    columns?: (string | TextRun[] | StyledTableCell | DataColumn | null)[];
     /**
      * Two-dimensional table row data; each row aligns by index with columns when columns are supplied.
      */
-    rows: TableCell[][];
+    rows?: TableCell[][];
+    /**
+     * Id of a top-level dataset that supplies this table's headers, rows and column formats. Excludes 'rows' and 'columns'. An unknown id is a 'dataset-unknown' error.
+     */
+    dataset?: string;
+    fields?: DatasetFields1;
 }
 /**
  * A cell with explicit visual style or merged geometry. Its position remains its array column index; use null placeholders for every covered grid position.
@@ -2885,6 +2984,10 @@ interface StyledTableCell {
      * Number of grid rows covered, starting at this cell. Covered positions must contain null. Header cells cannot span into body rows. Default 1.
      */
     rowSpan?: number;
+    /**
+     * Number format. On a body cell it formats that cell's number value (and wins over the column's format); on a header cell (in 'columns') it is the column's format, the same as a DataColumn header. Strings, booleans, null and rich runs display unchanged.
+     */
+    format?: string;
 }
 /**
  * Cell appearance. Sizes use reference pixels at a 720-pixel canvas short edge and scale with the slide.
@@ -3053,9 +3156,10 @@ interface Chart1 {
      */
     type: string;
     /**
-     * Chart data. Inline data uses a tabular columns/rows shape; renderers convert rows to chart series internally.
+     * Chart data. Inline data uses a tabular columns/rows shape; renderers convert rows to chart series internally. A DatasetRef ({ "dataset": "<id>" }) plots a top-level dataset instead. A ChartDataSource is not resolved by any engine (a 'chart-data-source-unresolved' warning; engines draw a placeholder); prefer inline data with a 'source'.
      */
-    data: (ChartData | ChartDataSource);
+    data: (ChartData | ChartDataSource | DatasetRef);
+    mapping?: ChartMapping;
     axisTitles?: ChartAxisTitles;
     /**
      * Optional legend position. 'none' hides the legend. Absent keeps today's behaviour exactly (a legend at the right of multi-series charts and of pie and doughnut charts, none for single-series charts). A named position shows the legend there even for a single-series chart. Of the Office 2016 constructs only box-and-whisker takes a legend; histogram, pareto, waterfall, funnel, treemap and map drop the option with a 'chart-option-adapted' diagnostic.
@@ -3071,13 +3175,18 @@ interface Chart1 {
  */
 interface Table1 {
     /**
-     * Optional column labels. Labels may be strings, rich runs or styled cell objects. Null is an empty label or a placeholder covered by a preceding column span.
+     * Optional column labels. Labels may be strings, rich runs, styled cell objects or DataColumn objects ({ "name", "format" }). A header's 'format' (DataColumn or StyledTableCell) is the column's number format; a body cell's own format wins. Null is an empty label or a placeholder covered by a preceding column span.
      */
-    columns?: (string | TextRun[] | StyledTableCell | null)[];
+    columns?: (string | TextRun[] | StyledTableCell | DataColumn | null)[];
     /**
      * Two-dimensional table row data; each row aligns by index with columns when columns are supplied.
      */
-    rows: TableCell[][];
+    rows?: TableCell[][];
+    /**
+     * Id of a top-level dataset that supplies this table's headers, rows and column formats. Excludes 'rows' and 'columns'. An unknown id is a 'dataset-unknown' error.
+     */
+    dataset?: string;
+    fields?: DatasetFields1;
 }
 /**
  * Arrangement within this group. Only minFontSize and overflow inherit from the parent; strict overflow cannot be weakened.
@@ -3350,6 +3459,70 @@ interface Reference {
      */
     url?: string;
 }
+/**
+ * Optional shared data tables, keyed by id. A chart ('chart.data': { "dataset": "<id>" }) or a table ('table': { "dataset": "<id>" }) references one instead of holding its own copy; engines inline the reference before composing, rendering or exporting. A dataset nothing references is a lint warning (opf/unused-dataset). See docs/chart-table-data.md.
+ */
+interface Datasets {
+    [k: string]: Dataset;
+}
+/**
+ * One shared data table: named columns (strings or DataColumn objects with a number format) and rows of scalar cells. Column names are unique ('data-column-duplicate' error). Rich text and styling belong in an inline table.
+ *
+ * This interface was referenced by `Presentation`'s JSON-Schema
+ * via the `definition` "Dataset".
+ */
+interface Dataset {
+    /**
+     * Human name of the dataset, shown by editors.
+     */
+    title?: string;
+    /**
+     * What the dataset holds.
+     */
+    description?: string;
+    /**
+     * Ordered, uniquely named columns.
+     *
+     * @minItems 1
+     */
+    columns: [(string | DataColumn), ...((string | DataColumn))[]];
+    /**
+     * Rows of scalar cells (string, number, boolean, null); each row aligns by index with columns.
+     */
+    rows: ChartDataCell[][];
+    source?: DataSourceRef1;
+}
+/**
+ * Optional provenance. Engines never read, fetch or refresh it.
+ */
+interface DataSourceRef1 {
+    /**
+     * Where the data came from: an 'asset:<id>' reference, a URL, or a relative or local path.
+     */
+    src: string;
+    /**
+     * Sheet or table name inside a spreadsheet source.
+     */
+    sheet?: string;
+    /**
+     * A1-style range inside a spreadsheet source.
+     */
+    range?: string;
+    /**
+     * The source fields the data was taken from, in order.
+     */
+    fields?: string[];
+    /**
+     * When the data was taken from the source: an ISO 8601 date or date-time.
+     */
+    retrieved?: ({
+        [k: string]: unknown;
+    } & string);
+    /**
+     * Free-form note about the source.
+     */
+    description?: string;
+}
 /**
  * Optional reusable asset registry for images, data files, videos, documents, fonts, and other resources referenced elsewhere in the deck via 'asset:<id>' strings.
  */