@openpresentation/opf 0.12.2 → 0.14.0

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, e as AnnotationFitter, f as AnnotationLayoutOptions, g as CAPTIONABLE_FIELDS, h as CAPTION_FONT_RATIO, i as CAPTION_MAX_RATIO, j as CHART_HIGHLIGHT_MUTED_MIN_CONTRAST, k as CHART_HIGHLIGHT_MUTED_MIX, l as CHART_SERIES_MIN_DIFFERENCE, m as CHART_SERIES_MIN_LIGHTNESS_STEP, o as CITATION_MARKER_RAISE, p as CITATION_MARKER_SCALE, q as CODE_HIGHLIGHT_LANGUAGES, r as CODE_HIGHLIGHT_MAX_LENGTH, s as CODE_PANEL_BACKGROUND, t as CODE_PANEL_FOREGROUND, u as CODE_SYNTAX_MIN_CONTRAST, v as Caption, w as CaptionAlignment, x as CaptionObject, y as CaptionPosition, z as CaptionSettings, B as ChartHighlightMarks, D as ChartLabelContent, E as ChartLabelPosition, G as ChartLegendPosition, H as ChartOptionDiagnostic, I as ChartOptionKind, J as ChartOptionSupport, K as ChartOptionTarget, N as CitationMarker, O as CitationNote, P as CodeContent, Q as CodeHighlightBand, R as CodeHighlightColors, S as CodeHighlightEntry, U as CodeHighlightIssue, V as CodeHighlightLines, W as CodeLayout, X as CodeLayoutDiagnostic, Y as CodeLayoutOptions, Z as CodeLineSegment, _ as CodeLineSource, $ as CodeRun, a0 as CodeSyntaxPalette, a1 as CodeSyntaxPaletteOptions, a2 as CodeSyntaxPaletteTheme, a3 as CodeTextFit, a4 as CodeTextPart, a5 as CodeToken, a6 as CodeTokenKind, C as ComposeSlideOptions, a7 as ComposedCaption, a8 as ComposedFlow, a9 as ComposedFootnoteEntry, aa as ComposedFootnotes, ab as ComposedGroup, ac as ComposedItem, ad as ComposedLogo, ae as ComposedSlideImage, af as Composition, ag as CompositionCandidate, ah as CompositionDecision, ai as CompositionExplanation, aj as CompositionPenalties, ak as CompositionTrack, al as DARK_BACKGROUND_LUMINANCE, am as DEFAULT_CHART_LABEL_SEPARATOR, an as DEFAULT_FONT_SCHEME, ao as DEFAULT_FURNITURE_DATE_FORMAT, ap as DEFAULT_SLIDE_NUMBER_FORMAT, aq as DESIGN_HINT_KEYS, ar as DeckCitations, as as DesignHintKey, at as DesignHintSource, au as DesignHints, av as FONT_SIZE_GRID_PER_PX, aw as FOOTNOTE_MAX_RATIO, ax as FontFaceSelection, F as FontFamilies, a as FontSchemeDiagnostic, b as Fonts, ay as FootnoteLayoutOptions, az as FurnitureField, aA as FurnitureImagePart, aB as FurnitureLayout, aC as FurniturePart, aD as FurniturePartBase, aE as FurnitureSocialLink, aF as FurnitureTextExtras, aG as FurnitureTextPart, aH as LAYOUT_BODY_KINDS, aI as LayoutBodyKind, aJ as LayoutBox, aK as LayoutContent, c as LayoutDiagnostic, aL as ListBulletImage, aM as ListEntryLayout, aN as ListFit, aO as ListFitOptions, aP as ListNumber, aQ as ListText, aR as ListValue, aS as LogoSlot, aT as MAX_COMPOSITION_DEPTH, aU as MAX_NUMBERING_LEVELS, aV as MAX_NUMBERING_VALUE, aW as MAX_ROMAN_VALUE, aX as METRIC_TREND_MIN_CONTRAST, aY as METRIC_TREND_SHAPES, M as MeasureTextWidth, aZ as MetricContent, a_ as MetricLayout, a$ as MetricLayoutDiagnostic, b0 as MetricLayoutOptions, b1 as MetricSentiment, b2 as MetricTextPart, b3 as MetricTextSource, b4 as MetricTrend, b5 as MetricTrendColorOptions, b6 as MetricTrendMark, b7 as NUMBERING_STYLES, b8 as NUMBERING_SUFFIXES, b9 as Numbering, ba as NumberingInput, bb as NumberingStyleName, bc as NumberingSuffix, bd as OPFCompositionError, be as PATTERN_PRESETS, bf as PATTERN_PRESET_ALIASES, bg as PATTERN_TILE_SIZE, bh as PICTURE_BULLET_SCALE, bi as PhysicalAlignment, bj as QuoteContent, bk as QuoteLayout, bl as QuoteLayoutDiagnostic, bm as QuoteLayoutOptions, bn as QuotePhoto, bo as QuoteTextPart, bp as QuoteTextSource, bq as ReadingBox, br as Reference, bs as ReferencesSlideOptions, bt as ResolveColorRefOptions, bu as ResolveColorRefRoles, bv as ResolveColorRolesOptions, bw as ResolveDesignHintsOptions, bx as ResolveLogoOptions, by as ResolveScriptFontsOptions, bz as ResolvedChartDataLabels, bA as ResolvedChartHighlight, bB as ResolvedChartOptions, bC as ResolvedColorRoles, bD as ResolvedDesignHints, bE as ResolvedFontScheme, bF as ResolvedLogo, bG as ResolvedNumbering, bH as ResolvedScriptFonts, bI as RichText, bJ as RichTextFit, bK as RichTextFragment, bL as RichTextLine, bM as RichTextOptions, bN as RichTextRun, bO as SURFACE_ALT_MIN_CONTRAST, bP as SURFACE_ALT_MIX, bQ as ScriptFontApp, bR as ScriptFontSlots, bS as ScriptFontSource, bT as ScriptFontSupplement, bU as ScriptRole, bV as SlideCitations, bW as SlideComposition, bX as SlideImageShape, bY as SocialPlatformRecord, bZ as SocialProfile, b_ as SourceTextFit, b$ as TIMELINE_OUTLINE_MIN_CONTRAST, c0 as TIMELINE_STATUSES, c1 as TIMELINE_TEXT_MIN_CONTRAST, c2 as TableBorder, c3 as TableCellLayout, c4 as TableCellStyle, c5 as TableGrid, c6 as TableGridCell, c7 as TableGridIssue, c8 as TableLayout, c9 as TableLayoutOptions, ca as TableRowLayout, cb as TextDirection, cc as TextFit, cd as TextLineInk, ce as TextLineSegment, cf as TextLineSource, T as TextMeasurement, cg as TextPlacement, ch as TextPlacementLine, d as TextStyle, ci as TimelineContent, cj as TimelineEvent, ck as TimelineLayout, cl as TimelineLayoutDiagnostic, cm as TimelineLayoutOptions, cn as TimelineMarkerShape, co as TimelineStatus, cp as TimelineStatusColors, cq as TimelineTextPart, cr as WatermarkTextLayout, cs as WatermarkTextOptions, ct as annotationText, cu as captionSettings, cv as chartColorForFill, cw as chartHighlightColors, cx as chartHighlightMarks, cy as chartLabelText, cz as chartOptionSupport, cA as chartOptionTarget, cB as chartPaletteForFill, cC as citationMarkerText, cD as codeHighlightBands, cE as codeHighlightColors, cF as codeHighlightLines, cG as codeLineNumbers, cH as codeLineRuns, cI as codeSyntaxPalette, cJ as codeSyntaxPaletteForScheme, cK as collectCitations, cL as colorContrast, cM as composeSlide, cN as defaultSlideBackground, cO as fitList, cP as fitRichText, cQ as fitText, cR as formatChartLabelNumber, cS as formatChartLabelPercent, cT as formatFurnitureDate, cU as formatListNumber, cV as formatSlideNumber, cW as isDarkColor, cX as layoutCaption, cY as layoutCode, cZ as layoutContent, c_ as layoutFootnotes, c$ as layoutFurniture, d0 as layoutMetric, d1 as layoutQuote, d2 as layoutTable, d3 as layoutTimeline, d4 as layoutWatermark, d5 as listNumbers, d6 as measureText, d7 as measureTextOutline, d8 as metricTrendColor, d9 as metricTrendMark, da as metricTrendPoints, db as normalizeHexColor, dc as numberingAtLevel, dd as numberingStyleDraws, de as paragraphDirection, df as paragraphDirectionAt, dg as patternBitmap, dh as patternRuns, di as physicalAlignment, dj as placeTextLines, dk as referencesSlide, dl as resolveCanvasDimensions, dm as resolveChartOptions, dn as resolveCodeLanguage, dp as resolveColorRef, dq as resolveColorRoles, dr as resolveDesignHints, ds as resolveFontFamilies, dt as resolveFontSchemeReference, du as resolveLogo, dv as resolveNumbering, dw as resolvePatternPreset, dx as resolveScriptFonts, dy as resolveSlideDirection, dz as resolveSocialProfile, dA as resolveTextStyle, dB as scriptFontRole, dC as sliceNumberedItems, dD as slideCitations, dE as slideImageShape, dF as snapFontSizeDown, dG as snapFontSizeUp, dH as surfaceAltColor, dI as tableGrid, dJ as tableRowBoundaries, dK as textColorForFill, dL as textWidthMeasurer, dM as timelineMarkerShapes, dN as timelineTextColor, dO as tokenizeCode, dP as visualReadingOrder, dQ as walkCitationRuns, dR as wrapText } from './composition-_WEwBe2a.js';
+export { I as ChartComboSeries, 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 formatDataNumber, t as fromExcelNumberFormat, u as inlineChartData, v as inlineDatasets, w as inlineTableData, x as isDatasetRef, y as isXYChartType, z as numberFormatError, A as resolveChartData, B as resolveTableData, F as tableCellDisplayValue, G as toExcelNumberFormat } from './chart-data-B_3z9VTb.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';
-import './chunk-E34DJ5LL.js';
+export { CAPTIONABLE_FIELDS, CAPTION_FONT_RATIO, CAPTION_MAX_RATIO, CHART_HIGHLIGHT_MUTED_MIN_CONTRAST, CHART_HIGHLIGHT_MUTED_MIX, CHART_SERIES_MIN_DIFFERENCE, CHART_SERIES_MIN_LIGHTNESS_STEP, CITATION_MARKER_RAISE, CITATION_MARKER_SCALE, CODE_HIGHLIGHT_LANGUAGES, CODE_HIGHLIGHT_MAX_LENGTH, CODE_PANEL_BACKGROUND, CODE_PANEL_FOREGROUND, CODE_SYNTAX_MIN_CONTRAST, DARK_BACKGROUND_LUMINANCE, DEFAULT_CHART_LABEL_SEPARATOR, DEFAULT_FONT_SCHEME, DEFAULT_FURNITURE_DATE_FORMAT, DEFAULT_SLIDE_NUMBER_FORMAT, DESIGN_HINT_KEYS, FONT_SIZE_GRID_PER_PX, FOOTNOTE_MAX_RATIO, LAYOUT_BODY_KINDS, MAX_COMPOSITION_DEPTH, MAX_NUMBERING_LEVELS, MAX_NUMBERING_VALUE, MAX_ROMAN_VALUE, METRIC_TREND_MIN_CONTRAST, METRIC_TREND_SHAPES, NUMBERING_STYLES, NUMBERING_SUFFIXES, OPFCompositionError, PATTERN_PRESETS, PATTERN_PRESET_ALIASES, PATTERN_TILE_SIZE, PICTURE_BULLET_SCALE, SURFACE_ALT_MIN_CONTRAST, SURFACE_ALT_MIX, TIMELINE_OUTLINE_MIN_CONTRAST, TIMELINE_STATUSES, TIMELINE_TEXT_MIN_CONTRAST, annotationText, captionSettings, chartColorForFill, chartHighlightColors, chartHighlightMarks, chartLabelText, chartNumber, chartOptionSupport, chartOptionTarget, chartPaletteForFill, citationMarkerText, codeHighlightBands, codeHighlightColors, codeHighlightLines, codeLineNumbers, codeLineRuns, codeSyntaxPalette, codeSyntaxPaletteForScheme, collectCitations, colorContrast, composeSlide, defaultSlideBackground, fitList, fitRichText, fitText, formatChartLabelNumber, formatChartLabelPercent, formatDataNumber, formatFurnitureDate, formatListNumber, formatSlideNumber, fromExcelNumberFormat, inlineChartData, inlineDatasets, inlineTableData, isDarkColor, isDatasetRef, isXYChartType, layoutCaption, layoutCode, layoutContent, layoutFootnotes, layoutFurniture, layoutMetric, layoutQuote, layoutTable, layoutTimeline, layoutWatermark, listNumbers, measureText, measureTextOutline, metricTrendColor, metricTrendMark, metricTrendPoints, normalizeHexColor, numberFormatError, numberingAtLevel, numberingStyleDraws, paragraphDirection, paragraphDirectionAt, patternBitmap, patternRuns, physicalAlignment, placeTextLines, referencesSlide, resolveCanvasDimensions, resolveChartData, resolveChartOptions, resolveCodeLanguage, resolveColorRef, resolveColorRoles, resolveDesignHints, resolveFontFamilies, resolveFontSchemeReference, resolveLogo, resolveNumbering, resolvePatternPreset, resolveScriptFonts, resolveSlideDirection, resolveSocialProfile, resolveTableData, resolveTextStyle, scriptFontRole, sliceNumberedItems, slideCitations, slideImageShape, snapFontSizeDown, snapFontSizeUp, surfaceAltColor, tableCellDisplayValue, tableGrid, tableRowBoundaries, textColorForFill, textWidthMeasurer, timelineMarkerShapes, timelineTextColor, toExcelNumberFormat, tokenizeCode, visualReadingOrder, walkCitationRuns, wrapText } from './chunk-6OXY2CP3.js';
+import './chunk-XOZ4KMSR.js';

package/dist/convert.d.ts

@@ -1,5 +1,8 @@
-import { PaginatedPage, PresentationPaginationOptions } from './pagination.js';
-import './composition-DWbCiMwF.js';
+import { P as PaginatedPage, d as PresentationPaginationOptions } from './pagination-BZpXLvFL.js';
+import './composition-_WEwBe2a.js';
+import './chart-data-B_3z9VTb.js';
+import './catalogs-D-yyQWCQ.js';
+import './schemas-DDpqAgyS.js';
 
 type Json = any;
 type Obj = Record<string, any>;
@@ -46,6 +49,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 presentation the payload belongs to. A dataset-backed chart or table needs it (its `datasets`) to convert to another kind or to validate. */
+    presentation?: 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. */
@@ -229,7 +234,7 @@ interface SplitOverflowResult extends SlideEdit {
     })[];
 }
 /**
- * Split a slide that does not fit into continuation slides with the existing pagination (`paginatePresentation`):
+ * Split a slide that does not fit into continuation slides with the existing pagination (`paginate`):
  * text, lists, tables and timelines break at item or sentence boundaries, headings are repeated and nothing is
  * dropped. The slide is paginated on its own, as slide 1 of 1, with the host's `options` (fonts, text
  * measurement); a slide that already fits is returned unchanged. Throws `not-convertible` when pagination
@@ -248,7 +253,7 @@ interface UnpaginateOptions {
     sourceSlideIndex?: number;
 }
 /**
- * The inverse of `paginatePresentation` for slides still as it returned them: given its `pages` mapping, join the
+ * The inverse of `paginate` for slides still as it returned them: given its `pages` mapping, join the
  * slices of each source slide back into the original leaves (text, list items, table rows, timeline events, code
  * lines) and replace the continuation slides by one slide. The first slide's id, headings and design are kept; the
  * slides must not have been edited or reordered since (a gap between two slices is refused). The readability floor

package/dist/convert.js

@@ -1,17 +1,19 @@
-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 { paginate, OPFPaginationError } from './chunk-XIZUK2XM.js';
+import { parseQuoteLines, parseCodeFence, splitWhen, parseListLine, levelsFromIndents, fenceCode } from './chunk-4VJDTF55.js';
+import { CONTENT_KEYS, isRecord, contentKeysOf, refuse, clone, Loss, isSlideLike, assertValidOwner, report, OPFConversionError, plainOf, assertValidOutput, same, splitRuns, runsOf, lineIsPlain, linePlain, concatText, lineValue, joinLines, hasFormatting } from './chunk-CSQHPVGL.js';
+export { OPFConversionError } from './chunk-CSQHPVGL.js';
+import './chunk-JDJBDYSR.js';
+import { promotedRegionKeys, isDatasetRef, inlineTableData, visitContentPayloads, chartNumber } from './chunk-6OXY2CP3.js';
 import './chunk-S5W34SIJ.js';
-import './chunk-E34DJ5LL.js';
-import './chunk-4LAM3N6S.js';
+import './chunk-XOZ4KMSR.js';
+import './chunk-LS2FMPI5.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 +35,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)) };
@@ -71,6 +74,7 @@ function timelineToTable(timeline, options, loss) {
     if (timeline.name) loss.note("timeline name");
     if (timeline.description) loss.note("timeline description");
   }
+  if (events.some((event) => event.status)) loss.note("timeline event status");
   const hasWhen = events.some((event) => event.when);
   const hasDescription = events.some((event) => event.description);
   const columns = [...hasWhen ? ["When"] : [], "What", ...hasDescription ? ["Description"] : []];
@@ -128,13 +132,14 @@ function tableToTimeline(table, options, loss) {
   });
   return events;
 }
-var COLUMN_LABELS = { label: "Label", value: "Value", unit: "Unit", delta: "Delta", trend: "Trend", description: "Description" };
+var COLUMN_LABELS = { label: "Label", value: "Value", unit: "Unit", delta: "Delta", trend: "Trend", sentiment: "Sentiment", description: "Description" };
 var METRIC_HEADINGS = {
   label: ["label", "metric", "name", "kpi", "measure", "indicator"],
   value: ["value", "amount", "number", "result", "actual", "current"],
   unit: ["unit", "units"],
   delta: ["delta", "change", "growth", "difference", "vs", "vs."],
   trend: ["trend", "direction"],
+  sentiment: ["sentiment"],
   description: ["description", "details", "detail", "notes", "note", "context"]
 };
 function metricsToTable(blocks, options, loss) {
@@ -154,9 +159,9 @@ function metricsToTable(blocks, options, loss) {
 }
 function tableToMetrics(table, loss) {
   const { columns, rows } = readCells(table, loss, "a set of metrics");
-  if (!columns) throw refuse('Metrics read their columns by their headings. Add a heading row that names a "Value" column, and optionally "Label", "Unit", "Delta", "Trend" and "Description".');
+  if (!columns) throw refuse('Metrics read their columns by their headings. Add a heading row that names a "Value" column, and optionally "Label", "Unit", "Delta", "Trend", "Sentiment" and "Description".');
   const roles = rolesFrom(columns, METRIC_HEADINGS, void 0);
-  if (roles.value === void 0) throw refuse('No column holds the metric value. Name one column "Value" (headings it understands: value, amount, number, result, label, unit, delta, change, trend, description).');
+  if (roles.value === void 0) throw refuse('No column holds the metric value. Name one column "Value" (headings it understands: value, amount, number, result, label, unit, delta, change, trend, sentiment, description).');
   if (!rows.length) throw refuse("A set of metrics needs at least one row, and this table has no rows.");
   const used = new Set(Object.values(roles));
   columns.forEach((value, index) => {
@@ -179,6 +184,11 @@ function tableToMetrics(table, loss) {
       if (trend === "up" || trend === "down" || trend === "flat") metric.trend = trend;
       else loss.note("trend values other than up, down or flat");
     }
+    if (roles.sentiment !== void 0 && !valueEmpty(row[roles.sentiment])) {
+      const sentiment = text(row[roles.sentiment]).trim().toLowerCase();
+      if (sentiment === "positive" || sentiment === "negative" || sentiment === "neutral") metric.sentiment = sentiment;
+      else loss.note("sentiment values other than positive, negative or neutral");
+    }
     if (roles.description !== void 0 && !valueEmpty(row[roles.description])) metric.description = text(row[roles.description]);
     return { metric };
   });
@@ -313,9 +323,11 @@ function toLines(kind, content, options, loss) {
     }
     case "quote": {
       const quote = typeof content === "string" ? { text: content } : content;
-      const lines = splitRuns([quote.text]);
-      if (quote.attribution) lines.push([`\u2014 ${quote.attribution}`]);
-      if (quote.source) lines.push([quote.attribution ? `\u2014 ${quote.source}` : quote.source]);
+      const lines = splitRuns(runsOf(quote.text));
+      const credit = [quote.attribution, quote.role].filter(Boolean).join(", ");
+      if (quote.photo !== void 0) loss.note("quote photo");
+      if (credit) lines.push([`\u2014 ${credit}`]);
+      if (quote.source) lines.push([credit ? `\u2014 ${quote.source}` : quote.source]);
       return lines;
     }
     case "metric": {
@@ -324,6 +336,7 @@ function toLines(kind, content, options, loss) {
       const lines = [[value]];
       for (const part of [metric.label, metric.description, metric.delta === void 0 ? void 0 : String(metric.delta)]) if (part !== void 0 && part !== "") lines.push(...splitRuns([part]));
       if (metric.trend) loss.note("metric trend");
+      if (metric.sentiment) loss.note("metric sentiment");
       return lines;
     }
     case "code": {
@@ -339,6 +352,7 @@ function toLines(kind, content, options, loss) {
         if (content.name) loss.note("timeline name");
         if (content.description) loss.note("timeline description");
       }
+      if (events.some((event) => event.status)) loss.note("timeline event status");
       const lines = [];
       for (const event of events) {
         lines.push([event.when ? `${event.when}: ${event.what}` : event.what]);
@@ -444,6 +458,7 @@ function timelineToList(timeline, loss) {
     if (timeline.name) loss.note("timeline name");
     if (timeline.description) loss.note("timeline description");
   }
+  if (events.some((event) => event.status)) loss.note("timeline event status");
   return {
     key: "items",
     value: events.map((event) => {
@@ -454,13 +469,21 @@ function timelineToList(timeline, loss) {
 }
 function chartToTable(chart, loss) {
   const data = chart?.data;
-  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?.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 has no inline columns and rows. Only a chart with inline columns and rows, or a dataset, 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 +491,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 +541,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.presentation);
+    if (isDatasetRef(content)) throw refuse(`This table shows dataset '${content.dataset}'. Pass the presentation (options.presentation) 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 +559,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.presentation) ? options.presentation : {});
   return { payload: out, from: info.kind, to, key, changed: true, ...report(loss.list) };
 }
 function contentConversionTargets(payload, options = {}) {
@@ -921,7 +951,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}`);
@@ -930,7 +960,7 @@ function splitSlideOnOverflow(presentation, slideIndex, options = {}) {
   const whole = presentation;
   let result;
   try {
-    result = paginatePresentation({ ...clone(whole), slides: [clone(source)] }, options);
+    result = paginate({ ...clone(whole), slides: [clone(source)] }, options);
   } catch (error) {
     if (error instanceof OPFPaginationError) throw refuse(error.message, { diagnostics: error.diagnostics });
     throw error;
@@ -959,7 +989,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 +1016,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(".");
@@ -1003,7 +1033,8 @@ function joinSlices(field, slices) {
     case "code":
     case "quote": {
       const key = field === "code" ? "source" : "text";
-      const text = slices.map((slice) => typeof slice === "string" ? slice : slice[key]).join("");
+      const parts = slices.map((slice) => typeof slice === "string" ? slice : slice[key]);
+      const text = field === "quote" ? parts.slice(1).reduce((joined, part) => concatText(joined, part), clone(parts[0])) : parts.join("");
       return typeof first === "string" ? text : { ...clone(first), [key]: text };
     }
     case "table":
@@ -1035,7 +1066,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 formatDataNumber, t as fromExcelNumberFormat, u as inlineChartData, v as inlineDatasets, w as inlineTableData, x as isDatasetRef, y as isXYChartType, z as numberFormatError, A as resolveChartData, B as resolveTableData, E as suggestChartNumberFix, F as tableCellDisplayValue, G as toExcelNumberFormat, H as unusedDatasets } from './chart-data-B_3z9VTb.js';
+
 type DataCell = string | number | boolean | null;
 interface TabularData {
     columns: string[];
@@ -10,7 +11,7 @@ interface DataImportOptions {
     header?: boolean;
     columns?: string[];
 }
-interface DataContentOptions extends DataImportOptions {
+interface ImportDataOptions extends DataImportOptions {
     as: 'table' | 'chart';
     chartType?: string;
     category?: string;
@@ -20,7 +21,7 @@ declare class OPFDataImportError extends Error {
     constructor(message: string);
 }
 declare function parseTabularData(input: unknown, options?: DataImportOptions): TabularData;
-declare function createDataContent(input: unknown, options: DataContentOptions): {
+declare function importData(input: unknown, options: ImportDataOptions): {
     table: TabularData;
 } | {
     chart: {
@@ -29,4 +30,4 @@ declare function createDataContent(input: unknown, options: DataContentOptions):
     };
 };
 
-export { type DataCell, type DataContentOptions, type DataImportOptions, OPFDataImportError, type TabularData, createDataContent, parseTabularData };
+export { type DataCell, type DataImportOptions, type ImportDataOptions, OPFDataImportError, type TabularData, importData, parseTabularData };

package/dist/data.js

@@ -1 +1,3 @@
-export { OPFDataImportError, createDataContent, parseTabularData } from './chunk-SOSOBKQ2.js';
+export { OPFDataImportError, importData, parseTabularData } from './chunk-Q2TCMN56.js';
+export { chartNumber, datasetDiagnostics, formatDataNumber, fromExcelNumberFormat, inlineChartData, inlineDatasets, inlineTableData, isDatasetRef, isXYChartType, numberFormatError, resolveChartData, resolveTableData, suggestChartNumberFix, tableCellDisplayValue, toExcelNumberFormat, unusedDatasets } from './chunk-6OXY2CP3.js';
+import './chunk-XOZ4KMSR.js';

package/dist/diff.d.ts

@@ -1,4 +1,4 @@
-import { JsonPatchOperation } from './patch.js';
+import { J as JsonPatchOperation } from './finding-C_por275.js';
 
 type MatchedBy = "id" | "equal" | "similar" | "position";
 interface MatchPair {
@@ -74,11 +74,11 @@ interface MergeResult {
  * collision is listed in `conflicts` with the base, our value and their value.
  * The merged document is not validated; callers validate it before saving.
  */
-declare function mergePresentations(base: unknown, ours: unknown, theirs: unknown, options?: MergeOptions): MergeResult;
+declare function merge(base: unknown, ours: unknown, theirs: unknown, options?: MergeOptions): MergeResult;
 
 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;
@@ -136,10 +136,10 @@ declare function categoryOf(tokens: readonly string[]): DiffCategory;
  * rule matches blocks, list items and every other array element. The result
  * lists categorised changes and a JSON Patch from `a` to `b`.
  */
-declare function diffPresentations(a: unknown, b: unknown, options?: DiffOptions): PresentationDiff;
+declare function diff(a: unknown, b: unknown, options?: DiffOptions): PresentationDiff;
 /** A short, single-line description of a value for reports. */
 declare function describeValue(value: unknown): string;
 /** Render a diff as a plain-text report (no colour, stable ordering). */
 declare function formatDiffReport(diff: PresentationDiff): string;
 
-export { type ArrayMatch, type DiffCategory, type DiffChange, type DiffChangeType, type DiffOptions, type DiffSlideRef, type DiffSummary, type MatchOptions, type MatchPair, type MatchedBy, type MergeConflict, type MergeConflictKind, type MergeOptions, type MergeResult, type PresentationDiff, type SlideMatchInfo, categoryOf, describeValue, diffPresentations, formatDiffReport, matchArrays, mergePresentations, similarity };
+export { type ArrayMatch, type DiffCategory, type DiffChange, type DiffChangeType, type DiffOptions, type DiffSlideRef, type DiffSummary, type MatchOptions, type MatchPair, type MatchedBy, type MergeConflict, type MergeConflictKind, type MergeOptions, type MergeResult, type PresentationDiff, type SlideMatchInfo, categoryOf, describeValue, diff, formatDiffReport, matchArrays, merge, similarity };