@openpresentation/opf 0.12.2 → 0.13.0

package/dist/{chunk-AUM5MXBR.js → chunk-RAYB46AB.js}

@@ -1,5 +1,5 @@
-import { assertValidPresentation } from './chunk-JKVKYVWL.js';
-import { DEFAULT_FONT_SCHEME, resolveFontSchemeReference, resolveFontFamilies, resolveCanvasDimensions, composeSlide, tableRowBoundaries, visitContentPayloads, sliceNumberedItems } from './chunk-HOBSL7AJ.js';
+import { assertValidPresentation } from './chunk-IYCJUKWD.js';
+import { DEFAULT_FONT_SCHEME, resolveFontSchemeReference, resolveFontFamilies, resolveCanvasDimensions, composeSlide, tableRowBoundaries, visitContentPayloads, sliceNumberedItems } from './chunk-MPM7NRG7.js';
 import { catalogs } from './chunk-E34DJ5LL.js';
 
 // src/pagination.ts
@@ -35,6 +35,10 @@ function sliceRichText(value, start, end) {
     return [typeof run === "string" ? text.slice(left, right) : { ...run, text: text.slice(left, right) }];
   });
 }
+var deckContext = (presentation) => {
+  const deck = isRecord(presentation) ? presentation : {};
+  return { ...Array.isArray(deck.references) ? { references: deck.references } : {}, ...isRecord(deck.datasets) ? { datasets: deck.datasets } : {} };
+};
 function leafFor(path, field, value) {
   const leaf = { path, field, value };
   let text;
@@ -66,8 +70,7 @@ function leafFor(path, field, value) {
   return leaf;
 }
 function paginateSlide(input, options = {}) {
-  const deckReferences = options.presentation?.references;
-  assertValidPresentation({ ...Array.isArray(deckReferences) ? { references: deckReferences } : {}, slides: [input] });
+  assertValidPresentation({ ...deckContext(options.presentation), slides: [input] });
   let source = clone(input);
   const maxSlides = options.maxSlides ?? 100;
   if (!Number.isInteger(maxSlides) || maxSlides < 1 || maxSlides > 1e4) throw new RangeError("maxSlides must be an integer between 1 and 10000.");
@@ -180,8 +183,7 @@ function paginateSlide(input, options = {}) {
     const issues = fit(geometry(slide, slides.length).diagnostics);
     if (issues.length) throw new OPFPaginationError("A continuation page does not fit at its final page number. No partial result was returned.", issues);
     assignPageIds(slide, slides.length);
-    const references = options.presentation?.references;
-    assertValidPresentation({ ...Array.isArray(references) ? { references } : {}, slides: [slide] });
+    assertValidPresentation({ ...deckContext(options.presentation), slides: [slide] });
     slides.push(slide);
     pages.push({ slideIndex: sourceIndex + slides.length - 1, mappings, ...initial.furniture ? { repeatedMappings: repeatedMappings(slides.length - 1) } : {} });
     selected = /* @__PURE__ */ new Map();

package/dist/{composition-DWbCiMwF.d.ts → composition-D7we69Tr.d.ts}

@@ -1,3 +1,5 @@
+import './chart-data-Cdr6rRVV.js';
+
 /** Canonical table grid. No renderer, fonts, DOM or network dependencies. */
 interface TableBorder {
     color: string;
@@ -911,6 +913,7 @@ interface ComposeSlideOptions {
         slides?: unknown;
         catalogs?: unknown;
         references?: unknown;
+        datasets?: unknown;
     };
     /**
      * Whether the slide background is dark, by the host's own luminance test. Selects the light logo
@@ -1471,6 +1474,10 @@ interface TableLayoutOptions {
     fontFamily?: string;
     textMeasurement?: TextMeasurement;
     path?: string;
+    /** RR-54: the document, for a dataset-backed table (`{ dataset }`): its headers, rows and column formats come from `datasets`. */
+    presentation?: {
+        datasets?: unknown;
+    };
     /**
      * Deck direction. A right-to-left deck lays the columns out right to left: the first column is the rightmost
      * and each cell's text reports its paragraph direction (RR-05).

package/dist/composition.d.ts

@@ -1 +1,2 @@
-export { A as AnnotatedRun, a as AnnotationFitter, b as AnnotationLayoutOptions, c as CAPTIONABLE_FIELDS, d as CAPTION_FONT_RATIO, e as CAPTION_MAX_RATIO, f as CHART_SERIES_MIN_DIFFERENCE, g as CHART_SERIES_MIN_LIGHTNESS_STEP, h as CITATION_MARKER_RAISE, i as CITATION_MARKER_SCALE, j as Caption, k as CaptionAlignment, l as CaptionObject, m as CaptionPosition, n as CaptionSettings, o as ChartLabelContent, p as ChartLabelPosition, q as ChartLegendPosition, r as ChartOptionDiagnostic, s as ChartOptionKind, t as ChartOptionSupport, u as ChartOptionTarget, v as CitationMarker, w as CitationNote, x as CodeContent, y as CodeLayout, z as CodeLayoutDiagnostic, B as CodeLayoutOptions, D as CodeLineSegment, E as CodeLineSource, G as CodeTextFit, H as CodeTextPart, C as ComposeSlideOptions, I as ComposedCaption, J as ComposedFlow, K as ComposedFootnoteEntry, N as ComposedFootnotes, O as ComposedGroup, P as ComposedItem, Q as ComposedLogo, R as ComposedSlideImage, S as Composition, U as CompositionCandidate, V as CompositionDecision, W as CompositionExplanation, X as CompositionPenalties, Y as CompositionTrack, Z as DEFAULT_CHART_LABEL_SEPARATOR, _ as DEFAULT_FONT_SCHEME, $ as DEFAULT_FURNITURE_DATE_FORMAT, a0 as DEFAULT_SLIDE_NUMBER_FORMAT, a1 as DeckCitations, a2 as FONT_SIZE_GRID_PER_PX, a3 as FOOTNOTE_MAX_RATIO, c7 as FontFaceSelection, a4 as FontFamilies, F as FontSchemeDiagnostic, a5 as FootnoteLayoutOptions, a6 as FurnitureField, a7 as FurnitureImagePart, a8 as FurnitureLayout, a9 as FurniturePart, aa as FurniturePartBase, ab as FurnitureSocialLink, ac as FurnitureTextExtras, ad as FurnitureTextPart, ae as LayoutBox, L as LayoutDiagnostic, af as ListBulletImage, ag as ListEntryLayout, ah as ListFit, ai as ListFitOptions, aj as ListNumber, ak as ListText, al as ListValue, am as LogoSlot, an as MAX_COMPOSITION_DEPTH, ao as MAX_NUMBERING_LEVELS, ap as MAX_NUMBERING_VALUE, aq as MAX_ROMAN_VALUE, ar as MeasureTextWidth, as as MetricContent, M as MetricLayout, at as MetricLayoutDiagnostic, au as MetricLayoutOptions, av as MetricTextPart, aw as MetricTextSource, ax as NUMBERING_STYLES, ay as NUMBERING_SUFFIXES, az as Numbering, aA as NumberingInput, aB as NumberingStyleName, aC as NumberingSuffix, aD as OPFCompositionError, aE as PICTURE_BULLET_SCALE, aF as PhysicalAlignment, aG as QuoteContent, aH as QuoteLayout, aI as QuoteLayoutDiagnostic, aJ as QuoteLayoutOptions, aK as QuoteTextPart, aL as QuoteTextSource, c8 as ReadingBox, aM as Reference, aN as ReferencesSlideOptions, aQ as ResolveLogoOptions, aR as ResolvedChartDataLabels, aS as ResolvedChartOptions, aT as ResolvedFontScheme, aU as ResolvedLogo, aV as ResolvedNumbering, aW as RichText, aX as RichTextFit, aY as RichTextFragment, aZ as RichTextLine, a_ as RichTextOptions, a$ as RichTextRun, b0 as SlideCitations, b1 as SlideComposition, b2 as SlideImageShape, b3 as SocialPlatformRecord, b4 as SocialProfile, c9 as SourceTextFit, ca as TableBorder, cb as TableCellLayout, cc as TableCellStyle, cd as TableGrid, ce as TableGridCell, cf as TableGridIssue, cg as TableLayout, ch as TableLayoutOptions, ci as TableRowLayout, b5 as TextDirection, b6 as TextFit, b7 as TextLineInk, cj as TextLineSegment, ck as TextLineSource, T as TextMeasurement, b8 as TextPlacement, b9 as TextPlacementLine, ba as TextStyle, bb as TimelineContent, bc as TimelineEvent, bd as TimelineLayout, be as TimelineLayoutDiagnostic, bf as TimelineLayoutOptions, bg as TimelineTextPart, bh as annotationText, bi as captionSettings, bj as chartColorForFill, bk as chartLabelText, bl as chartOptionSupport, bm as chartOptionTarget, bn as chartPaletteForFill, bo as citationMarkerText, bp as collectCitations, bq as colorContrast, br as composeSlide, bs as fitList, bt as fitRichText, bu as fitText, bv as formatChartLabelNumber, bw as formatChartLabelPercent, bx as formatFurnitureDate, by as formatListNumber, bz as formatSlideNumber, bA as layoutCaption, bB as layoutCode, bC as layoutFootnotes, bD as layoutFurniture, bE as layoutMetric, bF as layoutQuote, cl as layoutTable, bG as layoutTimeline, bH as listNumbers, bI as measureText, bJ as measureTextOutline, bL as numberingAtLevel, bM as numberingStyleDraws, bN as paragraphDirection, bO as paragraphDirectionAt, bP as physicalAlignment, bQ as placeTextLines, bR as referencesSlide, bS as resolveCanvasDimensions, bT as resolveChartOptions, bV as resolveFontFamilies, bW as resolveFontSchemeReference, bX as resolveLogo, bY as resolveNumbering, bZ as resolveSocialProfile, b_ as resolveTextStyle, b$ as sliceNumberedItems, c0 as slideCitations, cm as slideImageShape, c1 as snapFontSizeDown, c2 as snapFontSizeUp, cn as tableGrid, co as tableRowBoundaries, c3 as textColorForFill, c4 as textWidthMeasurer, cp as visualReadingOrder, c5 as walkCitationRuns, c6 as wrapText } from './composition-DWbCiMwF.js';
+export { A as AnnotatedRun, a as AnnotationFitter, b as AnnotationLayoutOptions, c as CAPTIONABLE_FIELDS, d as CAPTION_FONT_RATIO, e as CAPTION_MAX_RATIO, f as CHART_SERIES_MIN_DIFFERENCE, g as CHART_SERIES_MIN_LIGHTNESS_STEP, h as CITATION_MARKER_RAISE, i as CITATION_MARKER_SCALE, j as Caption, k as CaptionAlignment, l as CaptionObject, m as CaptionPosition, n as CaptionSettings, o as ChartLabelContent, p as ChartLabelPosition, q as ChartLegendPosition, r as ChartOptionDiagnostic, s as ChartOptionKind, t as ChartOptionSupport, u as ChartOptionTarget, v as CitationMarker, w as CitationNote, x as CodeContent, y as CodeLayout, z as CodeLayoutDiagnostic, B as CodeLayoutOptions, D as CodeLineSegment, E as CodeLineSource, G as CodeTextFit, H as CodeTextPart, C as ComposeSlideOptions, I as ComposedCaption, J as ComposedFlow, K as ComposedFootnoteEntry, N as ComposedFootnotes, O as ComposedGroup, P as ComposedItem, Q as ComposedLogo, R as ComposedSlideImage, S as Composition, U as CompositionCandidate, V as CompositionDecision, W as CompositionExplanation, X as CompositionPenalties, Y as CompositionTrack, Z as DEFAULT_CHART_LABEL_SEPARATOR, _ as DEFAULT_FONT_SCHEME, $ as DEFAULT_FURNITURE_DATE_FORMAT, a0 as DEFAULT_SLIDE_NUMBER_FORMAT, a1 as DeckCitations, a2 as FONT_SIZE_GRID_PER_PX, a3 as FOOTNOTE_MAX_RATIO, c7 as FontFaceSelection, a4 as FontFamilies, F as FontSchemeDiagnostic, a5 as FootnoteLayoutOptions, a6 as FurnitureField, a7 as FurnitureImagePart, a8 as FurnitureLayout, a9 as FurniturePart, aa as FurniturePartBase, ab as FurnitureSocialLink, ac as FurnitureTextExtras, ad as FurnitureTextPart, ae as LayoutBox, L as LayoutDiagnostic, af as ListBulletImage, ag as ListEntryLayout, ah as ListFit, ai as ListFitOptions, aj as ListNumber, ak as ListText, al as ListValue, am as LogoSlot, an as MAX_COMPOSITION_DEPTH, ao as MAX_NUMBERING_LEVELS, ap as MAX_NUMBERING_VALUE, aq as MAX_ROMAN_VALUE, ar as MeasureTextWidth, as as MetricContent, M as MetricLayout, at as MetricLayoutDiagnostic, au as MetricLayoutOptions, av as MetricTextPart, aw as MetricTextSource, ax as NUMBERING_STYLES, ay as NUMBERING_SUFFIXES, az as Numbering, aA as NumberingInput, aB as NumberingStyleName, aC as NumberingSuffix, aD as OPFCompositionError, aE as PICTURE_BULLET_SCALE, aF as PhysicalAlignment, aG as QuoteContent, aH as QuoteLayout, aI as QuoteLayoutDiagnostic, aJ as QuoteLayoutOptions, aK as QuoteTextPart, aL as QuoteTextSource, c8 as ReadingBox, aM as Reference, aN as ReferencesSlideOptions, aQ as ResolveLogoOptions, aR as ResolvedChartDataLabels, aS as ResolvedChartOptions, aT as ResolvedFontScheme, aU as ResolvedLogo, aV as ResolvedNumbering, aW as RichText, aX as RichTextFit, aY as RichTextFragment, aZ as RichTextLine, a_ as RichTextOptions, a$ as RichTextRun, b0 as SlideCitations, b1 as SlideComposition, b2 as SlideImageShape, b3 as SocialPlatformRecord, b4 as SocialProfile, c9 as SourceTextFit, ca as TableBorder, cb as TableCellLayout, cc as TableCellStyle, cd as TableGrid, ce as TableGridCell, cf as TableGridIssue, cg as TableLayout, ch as TableLayoutOptions, ci as TableRowLayout, b5 as TextDirection, b6 as TextFit, b7 as TextLineInk, cj as TextLineSegment, ck as TextLineSource, T as TextMeasurement, b8 as TextPlacement, b9 as TextPlacementLine, ba as TextStyle, bb as TimelineContent, bc as TimelineEvent, bd as TimelineLayout, be as TimelineLayoutDiagnostic, bf as TimelineLayoutOptions, bg as TimelineTextPart, bh as annotationText, bi as captionSettings, bj as chartColorForFill, bk as chartLabelText, bl as chartOptionSupport, bm as chartOptionTarget, bn as chartPaletteForFill, bo as citationMarkerText, bp as collectCitations, bq as colorContrast, br as composeSlide, bs as fitList, bt as fitRichText, bu as fitText, bv as formatChartLabelNumber, bw as formatChartLabelPercent, bx as formatFurnitureDate, by as formatListNumber, bz as formatSlideNumber, bA as layoutCaption, bB as layoutCode, bC as layoutFootnotes, bD as layoutFurniture, bE as layoutMetric, bF as layoutQuote, cl as layoutTable, bG as layoutTimeline, bH as listNumbers, bI as measureText, bJ as measureTextOutline, bL as numberingAtLevel, bM as numberingStyleDraws, bN as paragraphDirection, bO as paragraphDirectionAt, bP as physicalAlignment, bQ as placeTextLines, bR as referencesSlide, bS as resolveCanvasDimensions, bT as resolveChartOptions, bV as resolveFontFamilies, bW as resolveFontSchemeReference, bX as resolveLogo, bY as resolveNumbering, bZ as resolveSocialProfile, b_ as resolveTextStyle, b$ as sliceNumberedItems, c0 as slideCitations, cm as slideImageShape, c1 as snapFontSizeDown, c2 as snapFontSizeUp, cn as tableGrid, co as tableRowBoundaries, c3 as textColorForFill, c4 as textWidthMeasurer, cp as visualReadingOrder, c5 as walkCitationRuns, c6 as wrapText } from './composition-D7we69Tr.js';
+export { C as ChartMapping, D as DataCellValue, d as DataColumn, e as DataDiagnostic, h as DataSourceRef, j as DataTableCell, k as DataTableHeader, n as Dataset, o as DatasetRef, R as ResolvedChartData, p as ResolvedTableData, q as chartNumber, s as excelNumberFormat, t as formatDataNumber, u as inlineChartData, v as inlineDatasets, w as inlineTableData, x as isDatasetRef, y as isXYChartType, z as numberFormatError, A as numberFormatFromExcel, B as resolveChartData, E as resolveTableData, G as tableCellDisplayValue } from './chart-data-Cdr6rRVV.js';

package/dist/composition.js

@@ -1,2 +1,2 @@
-export { CAPTIONABLE_FIELDS, CAPTION_FONT_RATIO, CAPTION_MAX_RATIO, CHART_SERIES_MIN_DIFFERENCE, CHART_SERIES_MIN_LIGHTNESS_STEP, CITATION_MARKER_RAISE, CITATION_MARKER_SCALE, DEFAULT_CHART_LABEL_SEPARATOR, DEFAULT_FONT_SCHEME, DEFAULT_FURNITURE_DATE_FORMAT, DEFAULT_SLIDE_NUMBER_FORMAT, FONT_SIZE_GRID_PER_PX, FOOTNOTE_MAX_RATIO, MAX_COMPOSITION_DEPTH, MAX_NUMBERING_LEVELS, MAX_NUMBERING_VALUE, MAX_ROMAN_VALUE, NUMBERING_STYLES, NUMBERING_SUFFIXES, OPFCompositionError, PICTURE_BULLET_SCALE, annotationText, captionSettings, chartColorForFill, chartLabelText, chartOptionSupport, chartOptionTarget, chartPaletteForFill, citationMarkerText, collectCitations, colorContrast, composeSlide, fitList, fitRichText, fitText, formatChartLabelNumber, formatChartLabelPercent, formatFurnitureDate, formatListNumber, formatSlideNumber, layoutCaption, layoutCode, layoutFootnotes, layoutFurniture, layoutMetric, layoutQuote, layoutTable, layoutTimeline, listNumbers, measureText, measureTextOutline, numberingAtLevel, numberingStyleDraws, paragraphDirection, paragraphDirectionAt, physicalAlignment, placeTextLines, referencesSlide, resolveCanvasDimensions, resolveChartOptions, resolveFontFamilies, resolveFontSchemeReference, resolveLogo, resolveNumbering, resolveSocialProfile, resolveTextStyle, sliceNumberedItems, slideCitations, slideImageShape, snapFontSizeDown, snapFontSizeUp, tableGrid, tableRowBoundaries, textColorForFill, textWidthMeasurer, visualReadingOrder, walkCitationRuns, wrapText } from './chunk-HOBSL7AJ.js';
+export { CAPTIONABLE_FIELDS, CAPTION_FONT_RATIO, CAPTION_MAX_RATIO, CHART_SERIES_MIN_DIFFERENCE, CHART_SERIES_MIN_LIGHTNESS_STEP, CITATION_MARKER_RAISE, CITATION_MARKER_SCALE, DEFAULT_CHART_LABEL_SEPARATOR, DEFAULT_FONT_SCHEME, DEFAULT_FURNITURE_DATE_FORMAT, DEFAULT_SLIDE_NUMBER_FORMAT, FONT_SIZE_GRID_PER_PX, FOOTNOTE_MAX_RATIO, MAX_COMPOSITION_DEPTH, MAX_NUMBERING_LEVELS, MAX_NUMBERING_VALUE, MAX_ROMAN_VALUE, NUMBERING_STYLES, NUMBERING_SUFFIXES, OPFCompositionError, PICTURE_BULLET_SCALE, annotationText, captionSettings, chartColorForFill, chartLabelText, chartNumber, chartOptionSupport, chartOptionTarget, chartPaletteForFill, citationMarkerText, collectCitations, colorContrast, composeSlide, excelNumberFormat, fitList, fitRichText, fitText, formatChartLabelNumber, formatChartLabelPercent, formatDataNumber, formatFurnitureDate, formatListNumber, formatSlideNumber, inlineChartData, inlineDatasets, inlineTableData, isDatasetRef, isXYChartType, layoutCaption, layoutCode, layoutFootnotes, layoutFurniture, layoutMetric, layoutQuote, layoutTable, layoutTimeline, listNumbers, measureText, measureTextOutline, numberFormatError, numberFormatFromExcel, numberingAtLevel, numberingStyleDraws, paragraphDirection, paragraphDirectionAt, physicalAlignment, placeTextLines, referencesSlide, resolveCanvasDimensions, resolveChartData, resolveChartOptions, resolveFontFamilies, resolveFontSchemeReference, resolveLogo, resolveNumbering, resolveSocialProfile, resolveTableData, resolveTextStyle, sliceNumberedItems, slideCitations, slideImageShape, snapFontSizeDown, snapFontSizeUp, tableCellDisplayValue, tableGrid, tableRowBoundaries, textColorForFill, textWidthMeasurer, visualReadingOrder, walkCitationRuns, wrapText } from './chunk-MPM7NRG7.js';
 import './chunk-E34DJ5LL.js';

package/dist/convert.d.ts

@@ -1,5 +1,6 @@
 import { PaginatedPage, PresentationPaginationOptions } from './pagination.js';
-import './composition-DWbCiMwF.js';
+import './composition-D7we69Tr.js';
+import './chart-data-Cdr6rRVV.js';
 
 type Json = any;
 type Obj = Record<string, any>;
@@ -46,6 +47,8 @@ declare const CONTENT_KIND_LABELS: Readonly<Record<ContentKind, string>>;
  */
 declare const CONTENT_CONVERSIONS: Readonly<Record<string, readonly ContentKind[]>>;
 interface ConvertOptions extends TableOptions {
+    /** RR-54: the document the payload belongs to. A dataset-backed chart or table needs it (its `datasets`) to convert to another kind or to validate. */
+    document?: unknown;
     /** Text to timeline: also read `label: text` with any short label as the date (default: only date-like labels). */
     looseWhen?: boolean;
     /** Code to text: `auto` (default) writes a fenced block when the code has a language or file name so nothing is lost; `never` writes the bare source and reports the loss. */

package/dist/convert.js

@@ -1,17 +1,18 @@
-import { paginatePresentation, OPFPaginationError } from './chunk-AUM5MXBR.js';
-import { CONTENT_KEYS, isRecord, contentKeysOf, refuse, clone, Loss, isSlideLike, assertValidOwner, report, OPFConversionError, plainOf, assertValidOutput, same, splitRuns, runsOf, lineIsPlain, linePlain, concatText, parseQuoteLines, parseCodeFence, splitWhen, parseListLine, levelsFromIndents, lineValue, joinLines, hasFormatting, fenceCode } from './chunk-V2537ENL.js';
-export { OPFConversionError } from './chunk-V2537ENL.js';
-import './chunk-JKVKYVWL.js';
-import { promotedRegionKeys, visitContentPayloads } from './chunk-HOBSL7AJ.js';
+import { paginatePresentation, OPFPaginationError } from './chunk-RAYB46AB.js';
+import { CONTENT_KEYS, isRecord, contentKeysOf, refuse, clone, Loss, isSlideLike, assertValidOwner, report, OPFConversionError, plainOf, assertValidOutput, same, splitRuns, runsOf, lineIsPlain, linePlain, concatText, parseQuoteLines, parseCodeFence, splitWhen, parseListLine, levelsFromIndents, lineValue, joinLines, hasFormatting, fenceCode } from './chunk-II5EYKZU.js';
+export { OPFConversionError } from './chunk-II5EYKZU.js';
+import './chunk-IYCJUKWD.js';
+import { promotedRegionKeys, isDatasetRef, inlineTableData, visitContentPayloads, chartNumber } from './chunk-MPM7NRG7.js';
 import './chunk-S5W34SIJ.js';
 import './chunk-E34DJ5LL.js';
-import './chunk-4LAM3N6S.js';
+import './chunk-7QBCWNWL.js';
 
 // src/convert/tables.ts
 function cellOf(raw) {
   if (isRecord(raw) && Object.hasOwn(raw, "value")) {
-    return { value: raw.value, styled: isRecord(raw.style) && Object.keys(raw.style).length > 0, merged: (raw.colSpan ?? 1) > 1 || (raw.rowSpan ?? 1) > 1 };
+    return { value: raw.value, styled: isRecord(raw.style) && Object.keys(raw.style).length > 0, merged: (raw.colSpan ?? 1) > 1 || (raw.rowSpan ?? 1) > 1, formatted: typeof raw.format === "string" };
   }
+  if (isRecord(raw) && typeof raw.name === "string") return { value: raw.name, styled: false, merged: false, formatted: typeof raw.format === "string" };
   return { value: raw, styled: false, merged: false };
 }
 function valueText(value) {
@@ -33,6 +34,7 @@ function readCells(table, loss, purpose, allowMerged = false) {
         loss.note("merged cells");
       }
       if (cell.styled) loss.note("cell styles");
+      if (cell.formatted) loss.note("number formats");
     }
   }
   return { columns: Array.isArray(table.columns) ? table.columns.map((cell) => cellOf(cell).value) : void 0, rows: rows.map((row) => row.map((cell) => cellOf(cell).value)) };
@@ -454,13 +456,21 @@ function timelineToList(timeline, loss) {
 }
 function chartToTable(chart, loss) {
   const data = chart?.data;
+  if (chart?.mapping !== void 0) loss.note("series mapping");
+  if (isDatasetRef(data)) {
+    if (chart.type) loss.note("chart type");
+    return { key: "table", value: { dataset: data.dataset, ...Array.isArray(data.fields) ? { fields: clone(data.fields) } : {} } };
+  }
   if (!data || !Array.isArray(data.columns) || !Array.isArray(data.rows)) throw refuse("This chart reads external data. Only a chart with inline columns and rows converts to a table.");
   if (chart.type) loss.note("chart type");
+  if (data.source !== void 0) loss.note("data source");
   return { key: "table", value: { columns: clone(data.columns), rows: clone(data.rows) } };
 }
 function tableToChart(table) {
+  if (isDatasetRef(table)) return { key: "chart", value: { type: "column", data: { dataset: table.dataset, ...Array.isArray(table.fields) ? { fields: clone(table.fields) } : {} } } };
   const { columns, rows } = table ?? {};
-  if (!Array.isArray(columns) || !columns.length || columns.some((label) => typeof label !== "string" || label === "")) throw refuse("A chart needs a plain text label for every column. Add column labels to the table first.");
+  const label = (column) => isRecord(column) && !Object.hasOwn(column, "value") && typeof column.name === "string" ? column.name : column;
+  if (!Array.isArray(columns) || !columns.length || columns.some((column) => typeof label(column) !== "string" || label(column) === "")) throw refuse("A chart needs a plain text label for every column. Add column labels to the table first.");
   const body = rows.map((row, rowIndex) => {
     if (row.length !== columns.length) throw refuse(`Row ${rowIndex + 1} does not have ${columns.length} cells.`, { row: rowIndex });
     return row.map((cell, columnIndex) => {
@@ -468,12 +478,13 @@ function tableToChart(table) {
       if (columnIndex === 0) return cell;
       if (cell === null || cell === "") return null;
       if (typeof cell === "number") return cell;
-      if (typeof cell === "string" && cell.trim() !== "" && Number.isFinite(Number(cell)) && String(Number(cell)) === cell.trim()) return Number(cell);
+      const number = chartNumber(cell);
+      if (number !== null) return number;
       throw refuse(`Row ${rowIndex + 1}, column ${columnIndex + 1} ("${String(cell)}") is not a number, so it cannot be a chart value.`, { row: rowIndex, column: columnIndex });
     });
   });
   if (!body.length) throw refuse("A chart needs at least one row.");
-  return { key: "chart", value: { type: "column", data: { columns: [...columns], rows: body } } };
+  return { key: "chart", value: { type: "column", data: { columns: clone(columns), rows: body } } };
 }
 function convertField(from, to, content, options, loss) {
   if (from === "chart") return chartToTable(content, loss);
@@ -517,7 +528,13 @@ function convertContent(payload, to, options = {}) {
     throw refuse(`${label} content cannot be converted to ${CONTENT_KIND_LABELS[to]?.toLowerCase() ?? to}. ${targets.length ? `It converts to: ${targets.map((target) => CONTENT_KIND_LABELS[target].toLowerCase()).join(", ")}.` : "It has no text to convert."}`, { from: info.kind, to });
   }
   const loss = new Loss();
-  const { key, value } = convertField(info.kind, to, info.content, options, loss);
+  let content = info.content;
+  if (info.kind === "table" && to !== "chart" && isDatasetRef(content)) {
+    content = inlineTableData(content, options.document);
+    if (isDatasetRef(content)) throw refuse(`This table shows dataset '${content.dataset}'. Pass the document (options.document) so its rows can be converted.`);
+    loss.note("dataset reference (the rows are copied)");
+  }
+  const { key, value } = convertField(info.kind, to, content, options, loss);
   const out = {};
   for (const [name, entry] of Object.entries(owner)) {
     if (CONTENT_KEYS.includes(name) || name === "type" || name === "blocks") continue;
@@ -529,7 +546,7 @@ function convertContent(payload, to, options = {}) {
   }
   if (owner.type !== void 0) out.type = TYPE_OF_KIND[to] ?? to;
   out[key] = value;
-  assertValidOwner(out);
+  assertValidOwner(out, isRecord(options.document) ? options.document : {});
   return { payload: out, from: info.kind, to, key, changed: true, ...report(loss.list) };
 }
 function contentConversionTargets(payload, options = {}) {
@@ -921,7 +938,7 @@ function splitSlide(presentation, slideIndex, options = {}) {
     slide.blocks = clone(blocks.slice(from, bounds[part + 1]));
     return slide;
   });
-  assertValidOutput(slides, "slides");
+  assertValidOutput(slides, "slides", presentation);
   return { presentation: replaceSlides(presentation, slideIndex, 1, slides), slides, range: { start: slideIndex, deleteCount: 1 }, changed: true, ...report(loss.list) };
 }
 var remapPath = (path, from, to) => path.replace(new RegExp(`^slides\\.${from}(?=\\.|$)`), `slides.${to}`);
@@ -959,7 +976,7 @@ function splitSlideOnOverflow(presentation, slideIndex, options = {}) {
     mappings: page.mappings.map((mapping) => ({ ...mapping, sourcePath: remapPath(mapping.sourcePath, 0, slideIndex), outputPath: remapPath(mapping.outputPath, 0, slideIndex + page.slideIndex) })),
     ...page.repeatedMappings ? { repeatedMappings: page.repeatedMappings.map((mapping) => ({ ...mapping, sourcePath: remapPath(mapping.sourcePath, 0, slideIndex), outputPath: remapPath(mapping.outputPath, 0, slideIndex + page.slideIndex) })) } : {}
   }));
-  assertValidOutput(paginated, "slides");
+  assertValidOutput(paginated, "slides", presentation);
   return { presentation: replaceSlides(whole, slideIndex, 1, paginated), slides: paginated, range: { start: slideIndex, deleteCount: 1 }, changed: true, pages, ...report([]) };
 }
 function mergeSlides(presentation, start, count = 2) {
@@ -986,7 +1003,7 @@ function mergeSlides(presentation, start, count = 2) {
   if (blocks.length) merged.blocks = blocks;
   const notes = slides.map((slide) => slide.notes).filter((note) => typeof note === "string" && note !== "");
   if (notes.length) merged.notes = notes.join("\n\n");
-  assertValidOutput(merged, "slide");
+  assertValidOutput(merged, "slide", presentation);
   return { presentation: replaceSlides(presentation, start, count, [merged]), slides: [merged], range: { start, deleteCount: count }, changed: true, ...report(loss.list) };
 }
 var segments = (path) => path.split(".");
@@ -1035,7 +1052,7 @@ function unpaginate(presentation, pages, options = {}) {
     end = Math.max(end, indexes[0] + indexes.length);
     removed += indexes.length - 1;
   }
-  assertValidOutput(current.slides, "slides");
+  assertValidOutput(current.slides, "slides", presentation);
   const deleteCount = end - first;
   return { presentation: current, slides: current.slides.slice(first, first + deleteCount - removed), range: { start: first, deleteCount }, changed: true, ...report([]) };
 }

package/dist/data.d.ts

@@ -1,4 +1,5 @@
-/** Local CSV/TSV/JSON ingestion. No file access or network requests. */
+export { C as ChartMapping, a as ChartNumberFix, b as ChartNumberFixOperation, c as ChartNumberFixOptions, D as DataCellValue, d as DataColumn, e as DataDiagnostic, f as DataDiagnosticCode, g as DataResolveOptions, h as DataSourceRef, i as DataStyledCell, j as DataTableCell, k as DataTableHeader, l as DataTableValue, m as DataTextRun, n as Dataset, o as DatasetRef, R as ResolvedChartData, p as ResolvedTableData, q as chartNumber, r as datasetDiagnostics, s as excelNumberFormat, t as formatDataNumber, u as inlineChartData, v as inlineDatasets, w as inlineTableData, x as isDatasetRef, y as isXYChartType, z as numberFormatError, A as numberFormatFromExcel, B as resolveChartData, E as resolveTableData, F as suggestChartNumberFix, G as tableCellDisplayValue, H as unusedDatasets } from './chart-data-Cdr6rRVV.js';
+
 type DataCell = string | number | boolean | null;
 interface TabularData {
     columns: string[];

package/dist/data.js

@@ -1 +1,3 @@
-export { OPFDataImportError, createDataContent, parseTabularData } from './chunk-SOSOBKQ2.js';
+export { OPFDataImportError, createDataContent, parseTabularData } from './chunk-ATGDDJPX.js';
+export { chartNumber, datasetDiagnostics, excelNumberFormat, formatDataNumber, inlineChartData, inlineDatasets, inlineTableData, isDatasetRef, isXYChartType, numberFormatError, numberFormatFromExcel, resolveChartData, resolveTableData, suggestChartNumberFix, tableCellDisplayValue, unusedDatasets } from './chunk-MPM7NRG7.js';
+import './chunk-E34DJ5LL.js';

package/dist/diff.d.ts

@@ -78,7 +78,7 @@ declare function mergePresentations(base: unknown, ours: unknown, theirs: unknow
 
 type DiffChangeType = "added" | "removed" | "changed" | "moved";
 /** What kind of thing changed. */
-type DiffCategory = "slide" | "block" | "field" | "design" | "metadata" | "assets" | "catalogs" | "variables" | "narrative" | "extensions";
+type DiffCategory = "slide" | "block" | "field" | "design" | "metadata" | "assets" | "datasets" | "catalogs" | "variables" | "narrative" | "extensions";
 interface DiffSlideRef {
     id?: string;
     title?: string;

package/dist/diff.js

@@ -1,9 +1,9 @@
-import { jsonEqual, formatPointer } from './chunk-RUC7L5DJ.js';
-import './chunk-JKVKYVWL.js';
-import './chunk-HOBSL7AJ.js';
+import { jsonEqual, formatPointer } 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';
 
 // src/diff-match.ts
 var DEFAULT_MATCH_THRESHOLD = 0.5;
@@ -373,7 +373,7 @@ function mergePresentations(base, ours, theirs, options = {}) {
 // src/diff.ts
 var isObject3 = (value) => !!value && typeof value === "object" && !Array.isArray(value);
 var REGION_KEY = /^(top|middle|bottom|left|center|right)([:+].*)?$/u;
-var ROOT_CATEGORIES = { design: "design", assets: "assets", catalogs: "catalogs", variables: "variables", narrative: "narrative", extensions: "extensions" };
+var ROOT_CATEGORIES = { design: "design", assets: "assets", datasets: "datasets", catalogs: "catalogs", variables: "variables", narrative: "narrative", extensions: "extensions" };
 function categoryOf(tokens) {
   const [root] = tokens;
   if (root === void 0) return "metadata";
@@ -550,6 +550,7 @@ var SECTION_TITLES = {
   variables: "Variables",
   narrative: "Narrative",
   assets: "Assets",
+  datasets: "Datasets",
   catalogs: "Catalogs",
   extensions: "Extensions",
   slide: "Slides",
@@ -563,12 +564,12 @@ function formatDiffReport(diff) {
   const headline = [];
   const slideParts = [[s.added, "added"], [s.removed, "removed"], [s.moved, "moved"], [s.modified, "modified"]].filter(([n]) => n > 0).map(([n, label]) => `${n} ${label}`);
   if (slideParts.length) headline.push(`slides: ${slideParts.join(", ")}`);
-  for (const category of ["metadata", "design", "variables", "narrative", "assets", "catalogs", "extensions"]) {
+  for (const category of ["metadata", "design", "variables", "narrative", "assets", "datasets", "catalogs", "extensions"]) {
     const count = diff.summary.byCategory[category];
     if (count) headline.push(`${category}: ${count}`);
   }
   lines.push(`${diff.summary.total} change${diff.summary.total === 1 ? "" : "s"} (${headline.join("; ")})`, "");
-  for (const category of ["metadata", "design", "variables", "narrative", "assets", "catalogs", "extensions"]) {
+  for (const category of ["metadata", "design", "variables", "narrative", "assets", "datasets", "catalogs", "extensions"]) {
     const section = diff.changes.filter((change) => change.category === category);
     if (!section.length) continue;
     lines.push(SECTION_TITLES[category]);