@openpresentation/opf 0.11.4 → 0.12.1

package/dist/composition.d.ts

@@ -1 +1 @@
-export { a as CodeContent, b as CodeLayout, c as CodeLayoutDiagnostic, d as CodeLayoutOptions, e as CodeLineSegment, f as CodeLineSource, g as CodeTextFit, h as CodeTextPart, C as ComposeSlideOptions, i as ComposedFlow, j as ComposedGroup, k as ComposedItem, l as ComposedLogo, m as ComposedSlideImage, n as Composition, o as CompositionCandidate, p as CompositionDecision, q as CompositionExplanation, r as CompositionPenalties, s as CompositionTrack, D as DEFAULT_FONT_SCHEME, t as DEFAULT_FURNITURE_DATE_FORMAT, u as DEFAULT_SLIDE_NUMBER_FORMAT, aV as FontFaceSelection, v as FontFamilies, F as FontSchemeDiagnostic, w as FurnitureField, x as FurnitureImagePart, y as FurnitureLayout, z as FurniturePart, A as FurniturePartBase, B as FurnitureSocialLink, E as FurnitureTextExtras, G as FurnitureTextPart, H as LayoutBox, L as LayoutDiagnostic, I as ListBulletImage, J as ListEntryLayout, K as ListFit, M as ListFitOptions, N as ListText, O as ListValue, P as LogoSlot, Q as MAX_COMPOSITION_DEPTH, R as MeasureTextWidth, S as MetricContent, U as MetricLayout, V as MetricLayoutDiagnostic, W as MetricLayoutOptions, X as MetricTextPart, Y as MetricTextSource, Z as OPFCompositionError, _ as PICTURE_BULLET_SCALE, $ as QuoteContent, a0 as QuoteLayout, a1 as QuoteLayoutDiagnostic, a2 as QuoteLayoutOptions, a3 as QuoteTextPart, a4 as QuoteTextSource, a7 as ResolveLogoOptions, a8 as ResolvedFontScheme, a9 as ResolvedLogo, aa as RichTextFit, ab as RichTextFragment, ac as RichTextLine, ad as RichTextOptions, ae as RichTextRun, af as SlideComposition, ag as SlideImageShape, ah as SocialPlatformRecord, ai as SocialProfile, aW as SourceTextFit, aX as TableBorder, aY as TableCellLayout, aZ as TableCellStyle, a_ as TableGrid, a$ as TableGridCell, b0 as TableGridIssue, b1 as TableLayout, b2 as TableLayoutOptions, b3 as TableRowLayout, aj as TextFit, ak as TextLineInk, b4 as TextLineSegment, b5 as TextLineSource, T as TextMeasurement, al as TextPlacement, am as TextPlacementLine, an as TextStyle, ao as TimelineContent, ap as TimelineEvent, aq as TimelineLayout, ar as TimelineLayoutDiagnostic, as as TimelineLayoutOptions, at as TimelineTextPart, au as chartColorForFill, av as colorContrast, aw as composeSlide, ax as fitList, ay as fitRichText, az as fitText, aA as formatFurnitureDate, aB as formatSlideNumber, aC as layoutCode, aD as layoutFurniture, aE as layoutMetric, aF as layoutQuote, b6 as layoutTable, aG as layoutTimeline, aH as measureText, aI as measureTextOutline, aK as placeTextLines, aL as resolveCanvasDimensions, aN as resolveFontFamilies, aO as resolveFontSchemeReference, aP as resolveLogo, aQ as resolveSocialProfile, aR as resolveTextStyle, b7 as slideImageShape, b8 as tableGrid, b9 as tableRowBoundaries, aS as textColorForFill, aT as textWidthMeasurer, aU as wrapText } from './composition-Dl-d9FRj.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-DWbCiMwF.js';

package/dist/composition.js

@@ -1 +1,2 @@
-export { DEFAULT_FONT_SCHEME, DEFAULT_FURNITURE_DATE_FORMAT, DEFAULT_SLIDE_NUMBER_FORMAT, MAX_COMPOSITION_DEPTH, OPFCompositionError, PICTURE_BULLET_SCALE, chartColorForFill, colorContrast, composeSlide, fitList, fitRichText, fitText, formatFurnitureDate, formatSlideNumber, layoutCode, layoutFurniture, layoutMetric, layoutQuote, layoutTable, layoutTimeline, measureText, measureTextOutline, placeTextLines, resolveCanvasDimensions, resolveFontFamilies, resolveFontSchemeReference, resolveLogo, resolveSocialProfile, resolveTextStyle, slideImageShape, tableGrid, tableRowBoundaries, textColorForFill, textWidthMeasurer, wrapText } from './chunk-3H2U7FDR.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, 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';

package/dist/convert.d.ts

@@ -0,0 +1,261 @@
+import { PaginatedPage, PresentationPaginationOptions } from './pagination.js';
+import './composition-DWbCiMwF.js';
+
+type Json = any;
+type Obj = Record<string, any>;
+/**
+ * Raised when a conversion is refused. `code` is `not-convertible` when the pair or the content has no
+ * safe mapping (the message says why and what to change) and `invalid-output` when the result would not
+ * validate as OPF (a bug in a converter or an input outside the supported shapes).
+ */
+declare class OPFConversionError extends Error {
+    readonly code: "not-convertible" | "invalid-output";
+    readonly details: Record<string, unknown>;
+    constructor(code: "not-convertible" | "invalid-output", message: string, details?: Record<string, unknown>);
+}
+/** What every conversion reports: nothing is lost when `lossless` is true, otherwise `loss` names what is not carried over. */
+interface ConversionReport {
+    /** True when everything in the source is carried over (formatting, structure and metadata included). */
+    lossless: boolean;
+    /** Human-readable names of what the result cannot carry, for example `text formatting` or `list nesting levels`. Empty when lossless. */
+    loss: string[];
+}
+
+interface TableOptions {
+    /** Timeline and metrics to table: write the column headings (default true). A table without headings cannot be read back by role. */
+    headings?: boolean;
+    /** Table to timeline: the column index of each role, overriding the heading names. */
+    columns?: {
+        when?: number;
+        what?: number;
+        description?: number;
+    };
+    /** Text to table: the cell delimiter when the text is not a tab or pipe table, for example "," or ";". */
+    delimiter?: string;
+    /** Text to table with tabs or a delimiter: read the first row as the column headings. Pipe tables use their separator row. */
+    header?: boolean;
+}
+
+type ContentKind = "text" | "list" | "quote" | "metric" | "code" | "timeline" | "chart" | "table" | "image" | "video" | "group" | "metrics";
+/** Display label of every content kind. `metrics` is the target "a group of metric blocks". */
+declare const CONTENT_KIND_LABELS: Readonly<Record<ContentKind, string>>;
+/**
+ * The conversion matrix: source kind to the kinds it converts to. A conversion never invents content; what
+ * the target cannot carry is reported. `group` is a group whose blocks are all metrics; `metrics` is that
+ * group as a target.
+ */
+declare const CONTENT_CONVERSIONS: Readonly<Record<string, readonly ContentKind[]>>;
+interface ConvertOptions extends TableOptions {
+    /** 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. */
+    fences?: "auto" | "never";
+}
+interface ContentInfo {
+    /** The content field (`items` and `bullets` are both "list"; a group holds `blocks`). */
+    key: string;
+    kind: ContentKind;
+    content: Json;
+}
+/**
+ * The single content payload of an object (a block or a slide or region holding one content field), or
+ * undefined when it holds none or several. A payload with `blocks` is a `group`.
+ */
+declare function readContent(payload: unknown): ContentInfo | undefined;
+interface ConvertedContent extends ConversionReport {
+    /** The new payload: the old one with its content field replaced (its `id`, `extensions` and any slide fields are kept). */
+    payload: Obj;
+    from: ContentKind;
+    to: ContentKind;
+    /** The content field the payload now holds (`blocks` for a group of metrics). */
+    key: string;
+    /** False when the payload already has the requested kind (then `payload` is a copy of the input). */
+    changed: boolean;
+}
+/**
+ * Convert the content of one payload to another kind. The payload is a block (`{ text }`), a slide or region
+ * that holds one content field, or a group of metric blocks (`{ blocks: [{ metric }, ...] }`, to `table`).
+ * Throws `OPFConversionError` (`not-convertible`) for a pair without a mapping or content that does not fit,
+ * with a message that says why. The result is validated as OPF.
+ */
+declare function convertContent(payload: unknown, to: ContentKind, options?: ConvertOptions): ConvertedContent;
+interface ContentConversionTarget extends ConversionReport {
+    kind: ContentKind;
+    label: string;
+    /** False when the content does not fit this target; `reason` says why. */
+    available: boolean;
+    reason?: string;
+}
+/**
+ * The kinds the payload can convert to, each with whether the conversion keeps everything (`lossless`),
+ * what it cannot carry (`loss`), or why it is unavailable (`available: false`). Returns [] for a payload
+ * with no convertible content (an image, a video, a group that is not a set of metrics, several fields).
+ */
+declare function contentConversionTargets(payload: unknown, options?: ConvertOptions): ContentConversionTarget[];
+
+interface ListLevelOptions {
+    /** Move the items nested under each selected item with it (default true), so a subtree keeps its shape. */
+    withChildren?: boolean;
+}
+interface ListLevelChange extends ConversionReport {
+    /** The list payload with the new levels. */
+    payload: Obj;
+    /** False when nothing could move; `reason` says why. */
+    changed: boolean;
+    reason?: string;
+    /** The nesting level of every item after the change. */
+    levels: number[];
+}
+/**
+ * Raise (`delta` > 0, "demote", Tab) or lower (`delta` < 0, "promote", Shift+Tab) the nesting level of the
+ * items at `indices`. A level never exceeds one more than the item before it and never goes below 0, so the
+ * outline stays valid; the first item cannot be nested. Items under a selected item move with it unless
+ * `withChildren` is false. Nothing in the text changes, so the change is lossless.
+ */
+declare function shiftListLevels(payload: unknown, indices: number[], delta: number, options?: ListLevelOptions): ListLevelChange;
+/** Nest the items one level deeper (the Tab key in a list). See `shiftListLevels`. */
+declare const demoteListItems: (payload: unknown, indices: number[], options?: ListLevelOptions) => ListLevelChange;
+/** Move the items one level up (Shift+Tab). See `shiftListLevels`. */
+declare const promoteListItems: (payload: unknown, indices: number[], options?: ListLevelOptions) => ListLevelChange;
+interface ListFormChange extends ConversionReport {
+    payload: Obj;
+    changed: boolean;
+}
+/**
+ * Switch a list between the `items` form (ListItem: text, description, level) and the `bullets` form
+ * (BulletItem: text and level, which infers a text slide). Item descriptions have no place in bullets and are
+ * reported as lost.
+ */
+declare function convertListForm(payload: unknown, to: "items" | "bullets"): ListFormChange;
+
+/** A path inside one slide: `["blocks", 1]` is its second block, `["left"]` the payload of its `left` region, `[]` the slide itself. */
+type SlidePath = (string | number)[];
+interface StructureChange extends ConversionReport {
+    /** The slide after the change. */
+    slide: Obj;
+    changed: boolean;
+    /** Where the affected block now is (the new group, the first unwrapped child, the moved image block). */
+    path?: SlidePath;
+}
+/**
+ * Wrap the blocks at `indices` of a container (the slide by default, or a group or region group named by
+ * `container`) in a new group placed where the first of them was. The blocks keep their order; the group
+ * takes the optional `composition`. Nothing is lost.
+ */
+declare function wrapBlocks(slide: unknown, indices: number[], options?: {
+    container?: SlidePath;
+    composition?: Obj;
+}): StructureChange;
+/**
+ * Replace the group at `path` (a group inside a `blocks` array) by its blocks. The group's own `composition`,
+ * `id` and `extensions` cannot be kept and are reported.
+ */
+declare function unwrapGroup(slide: unknown, path: SlidePath): StructureChange;
+/**
+ * Move every block of a slide into its own named region. `regions[i]` is the region key of block i (`left`,
+ * `right`, `top:left`, ...); every block needs a distinct region and the regions may not overlap, because a
+ * slide cannot hold both `blocks` and regions. Nothing is lost.
+ */
+declare function blocksToRegions(slide: unknown, regions: string[]): StructureChange;
+/**
+ * Turn the named regions of a slide into ordinary blocks, in reading order (top to bottom, left to right).
+ * The position each region gave its content cannot be kept and is reported.
+ */
+declare function regionsToBlocks(slide: unknown): StructureChange;
+/** Move the content of region `from` to region `to`, or swap the two when `to` is taken and `swap` is true. */
+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"];
+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.
+ */
+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.
+ */
+declare function demoteImage(slide: unknown, from: ImageTarget, options?: {
+    index?: number;
+    region?: string;
+}): StructureChange;
+
+interface SlideEdit extends ConversionReport {
+    /** The presentation after the change. */
+    presentation: Obj;
+    /** The slides that replace `range`. */
+    slides: Obj[];
+    /** The slides of the old presentation that were replaced: `deleteCount` slides from `start`. */
+    range: {
+        start: number;
+        deleteCount: number;
+    };
+    /** False when the slide already fits or nothing needed to change (then `slides` is the original). */
+    changed: boolean;
+}
+interface SplitSlideOptions {
+    /** Block indexes where a new slide starts, for example `[2]` puts blocks 0 and 1 on the first slide and the rest on the second. */
+    at?: number[];
+    /** One block per slide (alternative to `at`). */
+    each?: boolean;
+    /** Repeat the title, subtitle and tag on every new slide (default true, the way pagination repeats headings). */
+    repeatHeadings?: boolean;
+}
+/**
+ * Split one slide into several by its blocks. The slide's design, layout, composition, section and other slide
+ * fields are copied to each part, its first part keeps its `id` and notes, later parts get ids ending `--2`,
+ * `--3`, ... that no other slide uses, and every block (with its own id) moves to exactly one part. A slide that
+ * uses named regions is split region by region and loses the regions' placement (reported).
+ */
+declare function splitSlide(presentation: unknown, slideIndex: number, options?: SplitSlideOptions): SlideEdit;
+interface SplitOverflowResult extends SlideEdit {
+    /** The pagination mapping of the new slides, with paths for the returned presentation; pass it to `unpaginate` to undo the split. */
+    pages: (PaginatedPage & {
+        sourceSlideIndex: number;
+    })[];
+}
+/**
+ * Split a slide that does not fit into continuation slides with the existing pagination (`paginatePresentation`):
+ * 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
+ * cannot resolve it (for example one item that cannot fit a slide).
+ */
+declare function splitSlideOnOverflow(presentation: unknown, slideIndex: number, options?: PresentationPaginationOptions): SplitOverflowResult;
+/**
+ * Merge `count` consecutive slides starting at `start` into one. The first slide's `id`, title, layout, design
+ * and other slide fields win; where a later slide differs, what is dropped is reported. The blocks of all the
+ * slides follow each other in one `blocks` list (a slide's inline content becomes blocks) and speaker notes are
+ * joined with a blank line. Slides that use named regions cannot be merged.
+ */
+declare function mergeSlides(presentation: unknown, start: number, count?: number): SlideEdit;
+interface UnpaginateOptions {
+    /** Only put back the slides cut from this source slide (an index into the pagination's source presentation). Default: every one. */
+    sourceSlideIndex?: number;
+}
+/**
+ * The inverse of `paginatePresentation` 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
+ * pagination wrote into `composition.minFontSize` stays, because the original value is not recorded.
+ */
+declare function unpaginate(presentation: unknown, pages: readonly (PaginatedPage & {
+    sourceSlideIndex: number;
+})[], options?: UnpaginateOptions): SlideEdit;
+
+export { CONTENT_CONVERSIONS, CONTENT_KIND_LABELS, type ContentConversionTarget, type ContentInfo, type ContentKind, type ConversionReport, type ConvertOptions, type ConvertedContent, type ImageTarget, type ListFormChange, type ListLevelChange, type ListLevelOptions, OPFConversionError, type PromoteImageOptions, type SlideEdit, type SlidePath, type SplitOverflowResult, type SplitSlideOptions, type StructureChange, type TableOptions, type UnpaginateOptions, blocksToRegions, contentConversionTargets, convertContent, convertListForm, demoteImage, demoteListItems, mergeSlides, moveRegion, promoteImage, promoteListItems, readContent, regionsToBlocks, shiftListLevels, splitSlide, splitSlideOnOverflow, unpaginate, unwrapGroup, wrapBlocks };