@openpresentation/opf 0.14.0 → 0.16.0

package/dist/composition.d.ts

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

package/dist/composition.js

@@ -1,2 +1,2 @@
-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';
+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, CHART_TYPES, 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_FURNITURE_DATE_FORMAT, DEFAULT_SLIDE_NUMBER_FORMAT, DESIGN_HINT_KEYS, ENGINE_DEFAULT_CHART_TYPES, ENGINE_DEFAULT_COLOR_SCHEME, ENGINE_DEFAULT_FONT_SCHEME, ENGINE_DEFAULT_THEME, FONT_SIZE_GRID_PER_PX, FOOTNOTE_MAX_RATIO, LANGUAGES, LAYOUT_BODY_KINDS, MAX_COMPOSITION_DEPTH, MAX_NUMBERING_LEVELS, MAX_NUMBERING_VALUE, MAX_PLACEHOLDER_GROUP_DEPTH, 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, SOCIAL_PLATFORMS, 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, chartPrimaryLayout, citationMarkerText, codeHighlightBands, codeHighlightColors, codeHighlightLines, codeLineNumbers, codeLineRuns, codeSyntaxPalette, codeSyntaxPaletteForScheme, collectCitations, colorContrast, composeSlide, defaultSlideBackground, fitImage, fitList, fitRichText, fitText, formatChartLabelNumber, formatChartLabelPercent, formatDataNumber, formatFurnitureDate, formatListNumber, formatSlideNumber, fromExcelNumberFormat, hasPlaceholderGroups, imageBackground, imageShape, inlineChartData, inlineDatasets, inlineTableData, intrinsicImageAspect, intrinsicImageSize, isDarkColor, isDatasetRef, isPlaceholderGroup, isXYChartType, layoutCaption, layoutCode, layoutContent, layoutFootnotes, layoutFurniture, layoutLeaves, layoutMetric, layoutQuote, layoutSlots, layoutStructure, 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, resolveLogo, resolveNumbering, resolvePatternPreset, resolveScriptFonts, resolveSlideDirection, resolveSocialProfile, resolveTableData, resolveTextStyle, scriptFontRole, sliceNumberedItems, slideCitations, snapFontSizeDown, snapFontSizeUp, surfaceAltColor, tableCellDisplayValue, tableGrid, tableRowBoundaries, textColorForFill, textWidthMeasurer, timelineMarkerShapes, timelineTextColor, toExcelNumberFormat, tokenizeCode, visualReadingOrder, walkCitationRuns, wrapText } from './chunk-5PDN7BN6.js';
+export { CATALOG_REFERENCE_PATTERN, OPFCatalogsOptionError, OPFUnresolvedReferenceError, catalogGroupSource, catalogKinds, catalogRecords, catalogReferenceSites, parseReference, resolveReference, unresolvedReference } from './chunk-SPFV27O5.js';

package/dist/convert.d.ts

@@ -1,8 +1,7 @@
-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';
+import { P as PaginatedPage, d as PresentationPaginationOptions } from './pagination-DzZPFheM.js';
+import './composition-D4ADF5c-.js';
+import './catalog-refs-_anZs-Qz.js';
+import './chart-data-BnNqgnC-.js';
 
 type Json = any;
 type Obj = Record<string, any>;
@@ -171,28 +170,26 @@ declare function regionsToBlocks(slide: unknown): StructureChange;
 declare function moveRegion(slide: unknown, from: string, to: string, options?: {
     swap?: boolean;
 }): StructureChange;
-/** The design slot an image can move to or from. */
-type ImageTarget = "slideImage" | "background" | "watermark";
-declare const IMAGE_POSITIONS: readonly ["background", "top", "bottom", "left", "right"];
+/** The design slot an image can move to or from. Placing an image beside the content is not a move: set the block's `placement`. */
+type ImageTarget = "background" | "watermark";
 interface PromoteImageOptions {
-    /** Slide image: where it sits (default `right`, an image band beside the content). Ignored for background and watermark. */
-    position?: (typeof IMAGE_POSITIONS)[number];
     /** Watermark: opacity from 0 to 1 (default 0.1). */
     opacity?: number;
     /** Replace the slide's existing design value for this slot instead of refusing. */
     replace?: boolean;
 }
 /**
- * Move the image block at `path` out of the content and into the slide's design as its slide image,
- * background or watermark. The block is removed (and any group it leaves empty). Alt text, titles and other
- * asset details a design slot cannot hold are reported. Refuses when the slide already sets that slot,
- * unless `replace` is true.
+ * Move the image block at `path` out of the content and into the slide's design as its background or
+ * watermark. The block is removed (and any group it leaves empty). A background keeps the alt text and the
+ * block's fit, focus, opacity and overlay; asset details and treatments a design slot cannot hold are reported.
+ * Refuses when the slide already sets that slot, unless `replace` is true.
  */
 declare function promoteImage(slide: unknown, path: SlidePath, to: ImageTarget, options?: PromoteImageOptions): StructureChange;
 /**
- * Move a slide's slide image, background image or watermark back into its content as an image block, added
- * after the existing blocks (or at `index`, or in the free region named by `region` on a slide that uses
- * regions). Placement, framing, fit and opacity cannot be kept by a block and are reported.
+ * Move a slide's background image or watermark back into its content as an image block, added after the
+ * existing blocks (or at `index`, or in the free region named by `region` on a slide that uses regions). A
+ * background's alt text, fit, focus, opacity and overlay move onto the block; a tile fit and a watermark's
+ * opacity cannot be kept and are reported.
  */
 declare function demoteImage(slide: unknown, from: ImageTarget, options?: {
     index?: number;

package/dist/convert.js

@@ -1,12 +1,12 @@
-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-XOZ4KMSR.js';
-import './chunk-LS2FMPI5.js';
+import { paginate, OPFPaginationError } from './chunk-BSYQDWT4.js';
+import { parseQuoteLines, parseCodeFence, splitWhen, parseListLine, levelsFromIndents, fenceCode } from './chunk-NAWQR7MN.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-5TO6I3GB.js';
+export { OPFConversionError } from './chunk-5TO6I3GB.js';
+import './chunk-PX5AWL7Y.js';
+import { promotedRegionKeys, isDatasetRef, inlineTableData, visitContentPayloads, chartNumber } from './chunk-5PDN7BN6.js';
+import './chunk-TRDXRRQK.js';
+import './chunk-SPFV27O5.js';
+import './chunk-WEDGVC5W.js';
 
 // src/convert/tables.ts
 function cellOf(raw) {
@@ -653,6 +653,7 @@ function convertListForm(payload, to) {
 }
 
 // src/convert/structure.ts
+var IMAGE_SOURCE = /^(asset:|https:\/\/|data:|\.\/|\.\.\/)/;
 var REGION_KEYS = new Set(promotedRegionKeys);
 var isRegionKey = (key) => REGION_KEYS.has(key);
 var regionKeysOf = (slide) => Object.keys(slide).filter(isRegionKey);
@@ -778,12 +779,14 @@ function moveRegion(slide, from, to, options = {}) {
   if (!occupied) rebuilt[to] = next[from];
   return finish(rebuilt, new Loss(), [to]);
 }
-var IMAGE_POSITIONS = ["background", "top", "bottom", "left", "right"];
-function imageAsset(payload) {
+var BACKGROUND_KEYS = ["fit", "focus", "opacity", "overlay"];
+var TREATMENT_KEYS = ["fit", "focus", "aspectRatio", "shape", "cornerRadius", "border", "opacity", "recolor", "overlay", "placement"];
+function imageBlock(payload) {
   if (!isRecord(payload)) throw refuse("Choose an image block.");
-  const keys = Object.keys(payload).filter((key) => key !== "id" && key !== "extensions" && key !== "type");
+  const keys = Object.keys(payload).filter((key) => key !== "id" && key !== "extensions" && key !== "type" && !TREATMENT_KEYS.includes(key));
   if (keys.length !== 1 || keys[0] !== "image") throw refuse("Choose a block that holds only an image.");
-  return isRecord(payload.image) ? payload.image : { src: payload.image };
+  const treatments = Object.fromEntries(TREATMENT_KEYS.filter((key) => payload[key] !== void 0).map((key) => [key, payload[key]]));
+  return { asset: isRecord(payload.image) ? payload.image : { src: payload.image }, treatments };
 }
 function removePayload(slide, path) {
   if (!path.length) {
@@ -808,29 +811,26 @@ function removePayload(slide, path) {
 function promoteImage(slide, path, to, options = {}) {
   const next = clone(slide);
   const holder = path.length ? at(next, path) : contentKeysOf(next).join() === "image" && !Array.isArray(next.blocks) ? { image: next.image } : void 0;
-  const asset = imageAsset(holder);
+  if (to !== "background" && to !== "watermark") throw refuse("Choose background or watermark.", { slot: to });
+  const { asset, treatments } = imageBlock(holder);
   if (typeof asset.src !== "string" || asset.src === "") throw refuse("This image has no source.");
   const design = isRecord(next.design) ? next.design : {};
-  if (design[to] !== void 0 && design[to] !== false && !options.replace) throw refuse(`This slide already sets its ${to === "slideImage" ? "slide image" : to}. Choose to replace it, or remove it first.`, { slot: to });
+  if (design[to] !== void 0 && design[to] !== false && !options.replace) throw refuse(`This slide already sets its ${to}. Choose to replace it, or remove it first.`, { slot: to });
   const loss = new Loss();
   const extras = ["title", "description", "mediaType", "format"].filter((key) => asset[key] !== void 0);
-  const position = options.position ?? "right";
-  if (!IMAGE_POSITIONS.includes(position)) throw refuse(`Choose a position: ${IMAGE_POSITIONS.join(", ")}.`, { position });
   const alt = typeof asset.alt === "string" && asset.alt !== "" ? asset.alt : void 0;
-  if (to === "slideImage") {
-    design.slideImage = { src: asset.src, position, ...alt ? { alt } : {} };
-    if (extras.length) loss.note(`image ${extras.join(", ")}`);
-  } else if (to === "background") {
-    design.background = { type: "image", image: { src: asset.src, fit: "cover" } };
-    if (alt) loss.note("image alt text");
-    if (extras.length) loss.note(`image ${extras.join(", ")}`);
+  const kept = to === "background" ? BACKGROUND_KEYS.filter((key) => treatments[key] !== void 0) : [];
+  const dropped = Object.keys(treatments).filter((key) => !kept.includes(key));
+  if (to === "background") {
+    design.background = { type: "image", src: asset.src, ...alt ? { alt } : {}, ...Object.fromEntries(kept.map((key) => [key, treatments[key]])) };
   } else {
     const opacity = options.opacity ?? 0.1;
     if (typeof opacity !== "number" || !(opacity >= 0 && opacity <= 1)) throw refuse("Watermark opacity must be between 0 and 1.", { opacity });
     design.watermark = { src: asset.src, opacity };
     if (alt) loss.note("image alt text");
-    if (extras.length) loss.note(`image ${extras.join(", ")}`);
   }
+  if (extras.length) loss.note(`image ${extras.join(", ")}`);
+  if (dropped.length) loss.note(`image ${dropped.join(", ")}`);
   if (path.length) {
     const payload = at(next, path);
     if (payload.id !== void 0) loss.note("block id");
@@ -843,21 +843,18 @@ function promoteImage(slide, path, to, options = {}) {
 function demoteImage(slide, from, options = {}) {
   const next = clone(slide);
   const design = next.design;
+  if (from !== "background" && from !== "watermark") throw refuse("Choose background or watermark.", { slot: from });
   const value = isRecord(design) ? design[from] : void 0;
-  if (value === void 0 || value === false) throw refuse(`This slide does not set its own ${from === "slideImage" ? "slide image" : from}.`, { slot: from });
+  if (value === void 0 || value === false) throw refuse(`This slide does not set its own ${from}.`, { slot: from });
   const loss = new Loss();
   let asset;
-  if (from === "slideImage") {
-    if (typeof value === "string") asset = { src: value };
-    else if (isRecord(value) && "position" in value) {
-      if (typeof value.src !== "string") throw refuse("This slide image only configures placement; it has no image of its own.");
-      asset = { src: value.src, ...value.alt ? { alt: value.alt } : {} };
-      loss.note("image position and framing");
-    } else asset = clone(value);
-  } else if (from === "background") {
-    if (!isRecord(value) || value.type !== "image" || typeof value.image?.src !== "string") throw refuse("This slide's background is not an image.");
-    asset = { src: value.image.src };
-    if (value.opacity !== void 0 || value.image.fit !== void 0 && value.image.fit !== "cover") loss.note("background fit and opacity");
+  let treatments = {};
+  if (from === "background") {
+    const picture = typeof value === "string" && IMAGE_SOURCE.test(value) ? { type: "image", src: value } : value;
+    if (!isRecord(picture) || picture.type !== "image" || typeof picture.src !== "string") throw refuse("This slide's background is not an image.");
+    asset = { src: picture.src, ...typeof picture.alt === "string" ? { alt: picture.alt } : {} };
+    treatments = Object.fromEntries(BACKGROUND_KEYS.filter((key) => picture[key] !== void 0 && !(key === "fit" && picture.fit === "tile")).map((key) => [key, picture[key]]));
+    if (picture.fit === "tile") loss.note("background tile fit");
   } else {
     if (typeof value === "string") asset = { src: value };
     else if (isRecord(value) && typeof value.src === "string") {
@@ -866,7 +863,7 @@ function demoteImage(slide, from, options = {}) {
       if (opacity !== void 0) loss.note("watermark opacity");
     } else throw refuse("This watermark has no image of its own.");
   }
-  const block = { image: Object.keys(asset).length === 1 ? asset.src : asset };
+  const block = { image: Object.keys(asset).length === 1 ? asset.src : asset, ...treatments };
   delete design[from];
   if (!Object.keys(design).length) delete next.design;
   const regions = regionKeysOf(next);
@@ -875,7 +872,7 @@ function demoteImage(slide, from, options = {}) {
     if (!options.region || !isRegionKey(options.region) || regions.some((key) => overlaps(key, options.region))) throw refuse("This slide places its content in regions. Choose a free region for the image.", { region: options.region });
     next[options.region] = block;
     path = [options.region];
-  } else if (Array.isArray(next.blocks) || contentKeysOf(next).length) {
+  } else if (Array.isArray(next.blocks) || contentKeysOf(next).length || Object.keys(treatments).length) {
     const blocks = explicitBlocks(next);
     const index = options.index ?? blocks.length;
     if (!Number.isInteger(index) || index < 0 || index > blocks.length) throw refuse("The position is outside the slide's blocks.", { index });

package/dist/data.d.ts

@@ -1,10 +1,27 @@
-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';
+import { C as Chart } from './presentation-COrFuj2g.js';
+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-BnNqgnC-.js';
 
 type DataCell = string | number | boolean | null;
 interface TabularData {
     columns: string[];
     rows: DataCell[][];
 }
+/** Chart import rejects empty columns and rows before returning a schema-compatible payload. */
+interface ImportedChartData extends TabularData {
+    columns: [string, ...string[]];
+    rows: [DataCell[], ...DataCell[][]];
+}
+/** A `chart.type` value (OPF 0.15: an engine vocabulary, `CHART_TYPES`). */
+type ImportedChartType = Chart['type'];
+interface ImportedTable {
+    table: TabularData;
+}
+interface ImportedChart {
+    chart: {
+        type: ImportedChartType;
+        data: ImportedChartData;
+    };
+}
 interface DataImportOptions {
     format?: 'csv' | 'tsv' | 'json';
     delimiter?: string;
@@ -13,7 +30,8 @@ interface DataImportOptions {
 }
 interface ImportDataOptions extends DataImportOptions {
     as: 'table' | 'chart';
-    chartType?: string;
+    /** Default `column`. Values outside `CHART_TYPES` make an invalid chart; the CLI checks `--chart-type` first. */
+    chartType?: ImportedChartType;
     category?: string;
     series?: string[];
 }
@@ -21,13 +39,12 @@ declare class OPFDataImportError extends Error {
     constructor(message: string);
 }
 declare function parseTabularData(input: unknown, options?: DataImportOptions): TabularData;
-declare function importData(input: unknown, options: ImportDataOptions): {
-    table: TabularData;
-} | {
-    chart: {
-        type: string;
-        data: TabularData;
-    };
-};
+declare function importData(input: unknown, options: ImportDataOptions & {
+    as: 'table';
+}): ImportedTable;
+declare function importData(input: unknown, options: ImportDataOptions & {
+    as: 'chart';
+}): ImportedChart;
+declare function importData(input: unknown, options: ImportDataOptions): ImportedTable | ImportedChart;
 
-export { type DataCell, type DataImportOptions, type ImportDataOptions, OPFDataImportError, type TabularData, importData, parseTabularData };
+export { type DataCell, type DataImportOptions, type ImportDataOptions, type ImportedChart, type ImportedChartData, type ImportedChartType, type ImportedTable, OPFDataImportError, type TabularData, importData, parseTabularData };

package/dist/data.js

@@ -1,3 +1,3 @@
-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';
+export { OPFDataImportError, importData, parseTabularData } from './chunk-SMLMI6IZ.js';
+export { chartNumber, datasetDiagnostics, formatDataNumber, fromExcelNumberFormat, inlineChartData, inlineDatasets, inlineTableData, isDatasetRef, isXYChartType, numberFormatError, resolveChartData, resolveTableData, suggestChartNumberFix, tableCellDisplayValue, toExcelNumberFormat, unusedDatasets } from './chunk-5PDN7BN6.js';
+import './chunk-SPFV27O5.js';

package/dist/deck.d.ts

@@ -0,0 +1,77 @@
+import { C as Catalog } from './catalog-refs-_anZs-Qz.js';
+import { P as Presentation } from './presentation-COrFuj2g.js';
+import { V as ValidateOptions, a as ValidationReport } from './validation-types-HxIgJfKx.js';
+import './composition-D4ADF5c-.js';
+import './chart-data-BnNqgnC-.js';
+import './finding-CT_f_vbD.js';
+import './json-BFSdESOE.js';
+
+/**
+ * One entry point to read and write a deck in any of its three serializations (RR-60): JSON, the canonical and interchange
+ * form, and the two authoring forms of the same data, YAML (`.opf.yaml`, RR-56) and Markdown (`.opf.md`, RR-30). `readDeck`
+ * turns text into a deck and the `validate` report of it, with every finding located in the text that was read; `writeDeck`
+ * turns a deck into text.
+ *
+ * The format comes from the `format` option, else from the file name, and never from the content: a string that starts with
+ * `{` is JSON only because JSON is the default. No renderer, fonts, DOM, network or model calls, and no Node APIs, so it runs in
+ * a browser. The same input always gives the same output.
+ */
+
+/** The serializations of a deck: `json` (canonical), `yaml` (`.opf.yaml`) and `markdown` (`.opf.md`). */
+type DeckFormat = "json" | "yaml" | "markdown";
+/** Every deck format, in the order JSON, YAML, Markdown. */
+declare const DECK_FORMATS: readonly DeckFormat[];
+/**
+ * The format a file name stands for: `.opf.md` is Markdown, `.yaml` and `.yml` are YAML (any case), every other name is JSON.
+ * A plain `.md` file is not a deck: it is Markdown that `fromMarkdown` converts when asked, so it is never detected.
+ */
+declare function deckFormatOf(filename: string | undefined): DeckFormat;
+interface ReadDeckOptions {
+    /** The format of the text. Wins over `filename`. */
+    format?: DeckFormat;
+    /** The file name, for the format only: `.opf.md` is Markdown, `.yaml` and `.yml` are YAML, anything else is JSON. The content is never sniffed. */
+    filename?: string;
+    /** Catalogs the host registered, for the references check. Nothing is fetched. */
+    catalogs?: readonly Catalog[];
+    /**
+     * Check the deck with `validate` and locate its findings in the text: `true` (the default) checks `format` and `references`;
+     * options pick other rules or categories (`{}` runs every rule; `catalogs` above is added when the options name none);
+     * `false` skips the check, so only syntax errors are reported and `schemaValid` is null.
+     */
+    validate?: boolean | ValidateOptions;
+}
+/**
+ * The deck read from the text with the `validate` report of it (`valid`, `schemaValid`, `checks`, `findings`, `counts`, and
+ * `template` and `unfilledVariables` for a deck with content variables), the same whatever the format.
+ */
+interface ReadDeckResult extends ValidationReport {
+    /** The deck. Always a value; when `valid` is false it is a best effort (an empty object after a syntax error). */
+    presentation: Presentation;
+    /** The format the text was read as. */
+    format: DeckFormat;
+}
+/**
+ * Read a deck from JSON, YAML or Markdown text. Never throws for malformed content; read `valid` and `findings`. The findings
+ * of a YAML or Markdown deck carry `location` (the UTF-16 offset and length, one-based line and column of the text that caused
+ * them, a validation finding mapped to the field it names); so do those of a JSON deck. A JSON syntax error is `opf/json-syntax`,
+ * a YAML one `yaml/<rule>` and a Markdown one `markdown/<rule>`. Throws a `TypeError` for text that is not a string, a format
+ * that is none of the three, or a bad option.
+ */
+declare function readDeck(text: string, options?: ReadDeckOptions): ReadDeckResult;
+interface WriteDeckOptions {
+    /** The format to write. Wins over `filename`. */
+    format?: DeckFormat;
+    /** The file name the text is for, for the format only (see `readDeck`). */
+    filename?: string;
+    /** YAML: start with `# yaml-language-server: $schema=...` so editors validate and complete the file. */
+    schemaComment?: boolean;
+}
+/**
+ * Write a deck as text: JSON as two-space JSON with a final newline, YAML in canonical form (`toYaml`) and Markdown in canonical
+ * form (`toMarkdown`, with anything the dialect has no syntax for embedded in `opf-slide` and `opf-block` fences so nothing is
+ * lost). `readDeck` reads each result back to the same deck. YAML and Markdown throw `OPFYamlError` or `OPFMarkdownError`
+ * (`invalid-document`) for a document that is not valid OPF; JSON writes whatever it is given.
+ */
+declare function writeDeck(presentation: unknown, options?: WriteDeckOptions): string;
+
+export { DECK_FORMATS, type DeckFormat, type ReadDeckOptions, type ReadDeckResult, type WriteDeckOptions, deckFormatOf, readDeck, writeDeck };

package/dist/deck.js

@@ -0,0 +1,12 @@
+export { DECK_FORMATS, deckFormatOf, readDeck, writeDeck } from './chunk-KINQFU6X.js';
+import './chunk-FQSIIADJ.js';
+import './chunk-K4DQQIT4.js';
+import './chunk-5UEUAW57.js';
+import './chunk-6OR326EA.js';
+import './chunk-NAWQR7MN.js';
+import './chunk-5TO6I3GB.js';
+import './chunk-PX5AWL7Y.js';
+import './chunk-5PDN7BN6.js';
+import './chunk-TRDXRRQK.js';
+import './chunk-SPFV27O5.js';
+import './chunk-WEDGVC5W.js';

package/dist/diff.d.ts

@@ -1,4 +1,4 @@
-import { J as JsonPatchOperation } from './finding-C_por275.js';
+import { J as JsonPatchOperation } from './finding-CT_f_vbD.js';
 
 type MatchedBy = "id" | "equal" | "similar" | "position";
 interface MatchPair {

package/dist/diff.js

@@ -1,7 +1,7 @@
-export { categoryOf, describeValue, diff, formatDiffReport, matchArrays, merge, similarity } from './chunk-Z65B2B77.js';
-import './chunk-BFLVSVA7.js';
-import './chunk-JDJBDYSR.js';
-import './chunk-6OXY2CP3.js';
-import './chunk-S5W34SIJ.js';
-import './chunk-XOZ4KMSR.js';
-import './chunk-LS2FMPI5.js';
+export { categoryOf, describeValue, diff, formatDiffReport, matchArrays, merge, similarity } from './chunk-UM24JFUE.js';
+import './chunk-3XDRQYWZ.js';
+import './chunk-PX5AWL7Y.js';
+import './chunk-5PDN7BN6.js';
+import './chunk-TRDXRRQK.js';
+import './chunk-SPFV27O5.js';
+import './chunk-WEDGVC5W.js';