@openpresentation/opf 0.17.0 → 0.18.1

package/dist/{finding-CDQ_wH8j.d.ts → finding-CT_f_vbD.d.ts}

@@ -209,4 +209,4 @@ interface ValidationIssue {
     };
 }
 
-export type { Finding as F, JsonPatchOperation as J, ValidationIssue as V, FindingCategory as a, FindingFix as b, FindingFocus as c, FindingLocation as d, FindingReport as e, FindingSeverity as f, FindingSuggestion as g };
+export type { FindingReport as F, JsonPatchOperation as J, ValidationIssue as V, Finding as a, FindingLocation as b, FindingSeverity as c, FindingCategory as d, FindingFix as e, FindingFocus as f, FindingSuggestion as g };

package/dist/format.js

@@ -1,2 +1,2 @@
-export { OPFFormatError, format, isFormatted, sortPresentationKeys } from './chunk-YT7FMQER.js';
-import './chunk-RA64UQKI.js';
+export { OPFFormatError, format, isFormatted, sortPresentationKeys } from './chunk-JXVS7BJK.js';
+import './chunk-6WW2EDUW.js';

package/dist/index.d.ts

@@ -1,24 +1,30 @@
 export { SchemaEntry, SchemaName, audience, chartType, colorScheme, fontScheme, language, layout, narrative, presentation, purpose, schemaEntries, schemaNames, schemas, socialPlatform, theme, tone } from './schemas.js';
-export { DEFAULT_CHART_PALETTE, DEFAULT_VALIDATION_THRESHOLDS, OPFValidationError, assertValid, assertValidCatalogRecord, findValidationRule, validate, validateCatalogRecord, validationRules } from './validator.js';
-export { B as BuiltinVariableInfo, C as Contract, D as DEFAULT_VARIABLE_DATE_FORMAT, O as OPFVariableError, R as ResolveVariablesOptions, a as ResolveVariablesResult, V as VARIABLE_KINDS, b as ValidateFonts, c as ValidateOptions, d as ValidationCategory, e as ValidationChecks, f as ValidationReport, g as ValidationRuleCost, h as ValidationRuleInfo, i as ValidationThresholds, j as VariableDeclaration, k as VariableDiagnostic, l as VariableDiagnosticCode, m as VariableDiagnosticSeverity, n as VariableInfo, o as VariableKind, p as VariableUse, q as VariableUseForm, r as VariableValues, s as coerceVariableValue, t as formatVariableNumber, u as hasContentVariables, v as isTemplate, w as listBuiltinVariables, x as listVariables, y as resolveVariables, z as validationCategories, A as variableDeclarations } from './validation-types-iZbXfES6.js';
+import { a2 as ConvertInput, a3 as ConvertOptions, a4 as ConvertResult, a5 as ConvertFormat, a6 as OpenOptions, a7 as SaveOptions, a8 as SaveResult } from './conversion-C5foedh6.js';
+export { a9 as ConvertedFile, h as ExportFormat, F as FontsHandle, O as OPFApiError, n as OPFExportError, o as OPFImportError, S as SlideSelection, T as parseSlideSelection } from './conversion-C5foedh6.js';
+import { validate as validate$1 } from './validator.js';
+export { DEFAULT_CHART_PALETTE, DEFAULT_VALIDATION_THRESHOLDS, OPFValidationError, assertValid, assertValidCatalogRecord, findValidationRule, validateCatalogRecord, validationRules } from './validator.js';
+import { R as ResolveVariablesOptions, h as VariableDiagnostic } from './validation-types-PbGDrNUr.js';
+export { B as BuiltinVariableInfo, C as Contract, D as DEFAULT_VARIABLE_DATE_FORMAT, O as OPFVariableError, i as ResolveVariablesResult, j as VARIABLE_KINDS, d as ValidateFonts, a as ValidateOptions, e as ValidationCategory, f as ValidationChecks, V as ValidationReport, g as ValidationRuleCost, c as ValidationRuleInfo, b as ValidationThresholds, k as VariableDeclaration, l as VariableDiagnosticCode, m as VariableDiagnosticSeverity, n as VariableInfo, o as VariableKind, p as VariableUse, q as VariableUseForm, r as VariableValues, s as coerceVariableValue, t as formatVariableNumber, u as hasContentVariables, w as isTemplate, x as listBuiltinVariables, y as listVariables, z as resolveVariables, v as validationCategories, A as variableDeclarations } from './validation-types-PbGDrNUr.js';
+export { a as CHART_TYPES, C as ComposeSlideOptions, E as ENGINE_DEFAULT_CHART_TYPES, b as ENGINE_DEFAULT_COLOR_SCHEME, c as ENGINE_DEFAULT_FONT_SCHEME, d as ENGINE_DEFAULT_THEME, e as FontFamilies, F as Fonts, f as LANGUAGES, g as LOGO_SHAPES, h as LanguageFamilyName, i as LanguageVocabulary, L as LayoutDiagnostic, j as LogoShape, k as LogoVariant, M as MeasureTextWidth, R as ResolveLogoOptions, l as ResolvedLogo, S as SOCIAL_PLATFORMS, m as SocialPlatformVocabulary, T as TextMeasurement, n as TextStyle, o as normalizeLanguageFamily } from './composition-C-OoqvAr.js';
 export { SpecFileEntry, SpecFileKind, SpecFilePath, specFileEntries, specFileKinds, specFilePaths } from './spec-files.js';
-import { P as Presentation } from './presentation-fb8CZmRq.js';
+import { P as Presentation } from './presentation-HondgJ3l.js';
 export { Audience, ChartType, ColorScheme, FontScheme, Language, Layout, Narrative, Purpose, SocialPlatform, Theme, Tone } from './types.js';
-import { c as CatalogKind, U as UnresolvedReferenceDiagnostic, d as CatalogOptions, b as Catalog, R as RecordProvenance } from './catalog-refs-C4K4y-vh.js';
-export { C as CATALOG_GROUP_PATTERN, a as CATALOG_REFERENCE_PATTERN, e as CatalogRecordMap, f as CatalogRecords, g as CatalogReferenceSite, O as OPFCatalogsOptionError, h as OPFUnresolvedReferenceError, i as ResolvedReference, j as catalogGroupSource, k as catalogKinds, l as catalogRecords, m as catalogReferenceSites, p as parseReference, r as resolveReference, u as unresolvedReference } from './catalog-refs-C4K4y-vh.js';
-export { F as Finding, a as FindingCategory, b as FindingFix, c as FindingFocus, d as FindingLocation, e as FindingReport, f as FindingSeverity, g as FindingSuggestion, J as JsonPatchOperation, V as ValidationIssue } from './finding-CDQ_wH8j.js';
-export { C as CHART_TYPES, a as ComposeSlideOptions, E as ENGINE_DEFAULT_CHART_TYPES, b as ENGINE_DEFAULT_COLOR_SCHEME, c as ENGINE_DEFAULT_FONT_SCHEME, d as ENGINE_DEFAULT_THEME, F as FontFamilies, e as Fonts, L as LANGUAGES, f as LanguageFamilyName, g as LanguageVocabulary, h as LayoutDiagnostic, M as MeasureTextWidth, S as SOCIAL_PLATFORMS, i as SocialPlatformVocabulary, T as TextMeasurement, j as TextStyle, n as normalizeLanguageFamily } from './composition-BbZ_9C-c.js';
-export { C as CatalogDisplayKind, a as CatalogRecordKind, c as catalogDisplayKinds, b as catalogSchemaNames } from './catalog-schemas-g7RFQBdc.js';
-export { O as OPFPaginationError, P as PaginatedPage, a as PaginationMapping, b as PaginationOptions, c as PaginationResult, d as PresentationPaginationOptions, e as PresentationPaginationResult, S as SlideContext, f as SlideContextDiagnostic, g as SlideContextOptions, p as paginate, h as paginateSlide, r as resolveSlideContext } from './pagination-BhX4M48Y.js';
+import { C as CatalogKind, U as UnresolvedReferenceDiagnostic, b as CatalogOptions, a as Catalog, R as RecordProvenance } from './catalog-refs-BSfGELpt.js';
+export { c as CATALOG_GROUP_PATTERN, d as CATALOG_REFERENCE_PATTERN, e as CatalogRecordMap, f as CatalogRecords, g as CatalogReferenceSite, O as OPFCatalogsOptionError, h as OPFUnresolvedReferenceError, i as ResolvedReference, j as catalogGroupSource, k as catalogKinds, l as catalogRecords, m as catalogReferenceSites, p as parseReference, r as resolveReference, u as unresolvedReference } from './catalog-refs-BSfGELpt.js';
+import { a as Finding, J as JsonPatchOperation } from './finding-CT_f_vbD.js';
+export { d as FindingCategory, e as FindingFix, f as FindingFocus, b as FindingLocation, F as FindingReport, c as FindingSeverity, g as FindingSuggestion, V as ValidationIssue } from './finding-CT_f_vbD.js';
+export { C as CatalogDisplayKind, a as CatalogRecordKind, c as catalogDisplayKinds, b as catalogSchemaNames } from './catalog-schemas-CinPh5WA.js';
+import { p as paginate$1 } from './pagination-BaUjDrTz.js';
+export { O as OPFPaginationError, a as PaginatedPage, c as PaginationMapping, d as PaginationOptions, e as PaginationResult, b as PresentationPaginationOptions, P as PresentationPaginationResult, S as SlideContext, f as SlideContextDiagnostic, g as SlideContextOptions, h as paginateSlide, r as resolveSlideContext } from './pagination-BaUjDrTz.js';
 export { ApplyPatchOptions, OPFPatchError, OPFPatchValidationError, PatchResult, applyPatch } from './patch.js';
 export { DiffOptions, MergeConflict, MergeOptions, MergeResult, PresentationDiff, diff, merge } from './diff.js';
 export { FormatOptions, OPFFormatError, format } from './format.js';
 export { FromMarkdownOptions, FromMarkdownResult, OPFMarkdownError, ToMarkdownOptions, ToMarkdownResult, fromMarkdown, toMarkdown } from './markdown.js';
 export { StringifyOptions, parse, stringify } from './deck.js';
-export { DataCell, DataImportOptions, ImportDataOptions, ImportedChart, ImportedChartData, ImportedChartType, ImportedTable, OPFDataImportError, TabularData, importData, parseTabularData } from './data.js';
-export { C as ChartComboSeries, a as ChartMapping, b as ChartNumberFix, c as ChartNumberFixOperation, d as ChartNumberFixOptions, D as DataCellValue, e as DataColumn, f as DataDiagnostic, g as DataDiagnosticCode, h as DataResolveOptions, i as DataSourceRef, j as DataStyledCell, k as DataTableCell, l as DataTableHeader, m as DataTableValue, n as DataTextRun, o as Dataset, p as DatasetRef, R as ResolvedChartData, q as ResolvedTableData, r as chartNumber, s as datasetDiagnostics, t as formatDataNumber, u as fromExcelNumberFormat, v as inlineChartData, w as inlineDatasets, x as inlineTableData, y as isDatasetRef, z as isXYChartType, A as numberFormatError, B as resolveChartData, E as resolveTableData, F as suggestChartNumberFix, G as tableCellDisplayValue, H as toExcelNumberFormat, I as unusedDatasets } from './chart-data-DTxdRRT1.js';
+export { DataCell, DataImportOptions, ImportedChart, ImportedChartData, ImportedChartType, ImportedTable, IngestOptions, OPFDataImportError, TabularData, ingest, parseTabularData } from './data.js';
+export { I as ChartComboSeries, 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';
 export { FONT_POLICY, FontAvailability, FontAvailabilityCode, FontAvailabilityDiagnostic, FontLicenseClass, FontPolicyDecision, FontPolicyEntry, FontPolicyTable, FontReplacement, FontReplacementCompatibility, FontReplacementMeasurement, applyFontPolicyDecisions, fontAvailabilityDiagnostics, fontPolicyFor } from './font-policy.js';
-export { D as DECK_FORMATS, a as DeckFormat, P as ParseOptions, d as deckFormatOf } from './deck-report-Bx3naFlF.js';
+export { a as DECK_FORMATS, D as DeckFormat, P as ParseOptions, d as deckFormatOf } from './deck-report-wszX7uo8.js';
 import './json-BFSdESOE.js';
 
 /**
@@ -28,6 +34,9 @@ import './json-BFSdESOE.js';
  * `resolveVariables` leaves them as written (with an escaped `\{{slide.number}}` kept escaped) and they resolve
  * here, per output slide: `resolveSlideVariables` for a slide's own strings and `substituteSlideTokens` for
  * header and footer text, which `layoutFurniture` substitutes so it can mark each slide number as a live field.
+ * The organization logo references (`var:organization.logo.icon`, RR-71) are slide-scoped too, because the
+ * `onLight`/`onDark` choice follows each slide's background: `resolveSlideVariables` resolves them in a slide's own
+ * fields when it is given the presentation, and `layoutFurniture` in zone images.
  * Pure: no clock, locale or I/O. See docs/templates-and-variables.md.
  */
 /** The slide-scoped built-in names, in picker order. */
@@ -41,13 +50,22 @@ type SlideScopedBuiltin = (typeof SLIDE_SCOPED_BUILTINS)[number];
  * text when it has none). The slide's own `design.header` and `design.footer` are left as written:
  * `layoutFurniture` substitutes header and footer text itself and marks each slide number as a live field.
  *
- * Engines call it on each output slide after pagination, with the same `slideNumber` and `slideCount` they pass to
- * `composeSlide`, and compose and draw the result; `resolveSlideContext` returns it as `slide`. Returns the input
- * object itself when nothing changes; never mutates it.
+ * With `presentation` (RR-71) it also resolves the slide-scoped logo references, a whole string
+ * `var:organization.logo[.<shape>]` or `var:organization.<id>.logo[.<shape>]` in any field (an image block, the slide
+ * `image`), to the organization's asset for this slide's background (`darkBackground`, the host's luminance test:
+ * `onDark` first, else `onLight`); a reference whose organization has no logo is omitted, like an unfilled optional
+ * variable, and an unknown one stays as written (validation reports it). The slide's own `design.logo` is left for
+ * `resolveLogo`, and zone images for `layoutFurniture`.
+ *
+ * Engines call it on each output slide after pagination, with the same `slideNumber`, `slideCount` and
+ * `darkBackground` they pass to `composeSlide`, and compose and draw the result; `resolveSlideContext` returns it as
+ * `slide`. Returns the input object itself when nothing changes; never mutates it.
  */
 declare function resolveSlideVariables<T>(slide: T, values: {
     slideNumber: number;
     slideCount?: number;
+    presentation?: unknown;
+    darkBackground?: boolean;
 }): T;
 
 /** Whether two records have the same content once embedded (`$schema`, `id` and `x-*` ignored). */
@@ -72,7 +90,7 @@ interface EmbedResult {
  * embedded under `catalogs.default` (whose `source` is set to that catalog's). Records already embedded are kept as
  * they are; catalog display metadata (`x-*`), `$schema` and `id` are stripped from the copies. Idempotent.
  */
-declare function embed(document: unknown, options?: CatalogOptions): EmbedResult;
+declare function embed$1(document: unknown, options?: CatalogOptions): EmbedResult;
 /** A copied record that did not keep its reference. */
 interface CopiedRecordRename {
     kind: CatalogKind;
@@ -280,7 +298,7 @@ interface HeaderFooterFact {
     /** The deck sets it to `false`. */
     suppressed: boolean;
     zones: string[];
-    /** Fields set in any zone: logo, image, text, socials, date. */
+    /** Fields set in any zone: image, text, socials, date. */
     fields: string[];
 }
 interface TableFact {
@@ -433,7 +451,7 @@ interface PresentationStats {
             decorative: number;
             missingAlt: number;
         };
-        /** Logo images: `design.logo` (every LogoSet variant), deck and slides, plus organization logos. */
+        /** Logo images: every asset of every organization's logo (each shape, and each of onLight and onDark). */
         logos: number;
         watermarks: {
             deck: boolean;
@@ -551,6 +569,121 @@ interface StatsOptions extends CatalogOptions {
     /** Speaking pace for the notes estimate. Default 130. */
     wordsPerMinute?: number;
 }
-declare function stats(presentation: unknown, options?: StatsOptions): PresentationStats;
+declare function stats$1(presentation: unknown, options?: StatsOptions): PresentationStats;
+
+interface EditOptions {
+    /** The catalogs the result's references resolve in. In Node the default catalog when omitted, as `opf edit` registers it; in the browser build none. */
+    catalogs?: readonly Catalog[];
+    /** `false` skips the check of the result (work in progress). Default true. */
+    validate?: boolean;
+}
+interface EditResult {
+    /** The patched deck (a copy). */
+    presentation: Presentation;
+    /** The warnings and notes of the format and references check (errors throw). */
+    findings: Finding[];
+    /** The patch that restores the input. */
+    inverse: JsonPatchOperation[];
+}
+/** Apply a JSON Patch (`add`, `remove`, `replace`, `move`, `copy`, `test`) to a deck and check the result's format and references. */
+declare function edit$1(deck: unknown, patch: unknown, options?: EditOptions): EditResult;
+
+/** The values of one deck, keyed by variable id. */
+type FillRecord = Record<string, unknown>;
+interface FillOptions extends Pick<ResolveVariablesOptions, "partial" | "examples"> {
+    /** The form of text data: `csv`, `tsv` or `json`. Omitted: `json` when the text starts with `{` or `[`, else `csv`. */
+    format?: "csv" | "tsv" | "json";
+    /** CSV: the field separator (default `,`; TSV uses a tab). */
+    delimiter?: string;
+    /** CSV and TSV: the first row names the columns (default true). */
+    header?: boolean;
+    /** Join the decks into one: the first deck's fields, then the slides of every deck in order (a repeated slide id gets the record number). */
+    combine?: boolean;
+}
+interface FilledDeck {
+    /** The record's position, from 1. */
+    index: number;
+    record: FillRecord;
+    presentation: Record<string, unknown>;
+    diagnostics: VariableDiagnostic[];
+    /** The variables that kept no value. */
+    unfilled: string[];
+    complete: boolean;
+}
+interface FillResult {
+    /** One deck per record, in order. */
+    decks: FilledDeck[];
+    /** With `combine`: the one deck. */
+    presentation?: Record<string, unknown>;
+    /** Every deck has a value for every variable. */
+    complete: boolean;
+    unfilled: string[];
+    /** The warnings and errors of every deck, one entry per code, variable and path, with the records it hit. An `error` (a required variable with no value, unless `partial`) means the deck is not usable as it is. */
+    diagnostics: (VariableDiagnostic & {
+        records: number[];
+    })[];
+}
+/**
+ * The records of text data. JSON keeps rich values (text runs, lists, image objects): an object is one record and an array of
+ * objects one record each. CSV, TSV and tabular JSON (`{ columns, rows }` or a row matrix) give one record per row, keyed by the
+ * header, with blank cells left unprovided. Throws `OPFDataImportError` for data that has no records.
+ */
+declare function fillRecords(raw: string, options?: Pick<FillOptions, "format" | "delimiter" | "header">): FillRecord[];
+/**
+ * Fill a template: `data` is text (CSV, TSV or JSON), one record or a list of records; omitted, one deck is filled from the
+ * variables' own values (and their examples with `examples`). Each deck is the template resolved with one record
+ * (`resolveVariables`), no longer marked as a template. Throws `OPFDataImportError` for data without records and a `TypeError`
+ * for a template that is not an object.
+ */
+declare function fill(template: unknown, data?: string | FillRecord | readonly FillRecord[], options?: FillOptions): FillResult;
+
+/** `validate` with the default catalog registered when `catalogs` is omitted, as `opf validate` does. */
+declare const validate: typeof validate$1;
+/** `stats` with the default catalog registered when `catalogs` is omitted, as `opf stats` does. */
+declare const stats: typeof stats$1;
+/** `paginate` with the default catalog registered when `catalogs` is omitted, as `opf paginate` does. Pass `fonts` (opf-render's `loadFonts()`) for measured page breaks. */
+declare const paginate: typeof paginate$1;
+/** `embed` with the default catalog registered when `catalogs` is omitted, as `opf embed` does. */
+declare const embed: typeof embed$1;
+/** `edit` with the default catalog registered for the check when `catalogs` is omitted, as `opf edit` does. */
+declare const edit: typeof edit$1;
+/**
+ * Convert a file, a deck or the bytes of a `.pptx` file. With an `output` path the format comes from its extension and the
+ * files are written: `.pdf`, `.pptx`, `.png` and `.svg` are exported (one PNG or SVG per slide, `slides/deck.png` giving
+ * `slides/deck-001.png`, ...; one selected slide is written to `output` itself), `.zip` is one archive of the slides (`format`
+ * `png`, the default, or `svg`), and `.opf.md`, `.yaml`/`.yml` or `.json` writes the deck in that form. Without an output path,
+ * pass `{ format }`: nothing is written and the files come back with their names and bytes.
+ *
+ * A `.pptx` input is imported first. Local images resolve next to the input file unless `assetDir` says otherwise; URLs are
+ * never fetched. Everything is produced before anything is written, and each file is written atomically, replacing an existing
+ * output (`overwrite: false` refuses one with `output-exists`, as the commands do without `--force`). Throws `OPFApiError` for the request and the files (`invalid-option`, `input-not-found`,
+ * `input-unreadable`, `invalid-presentation`, `output-exists`, `output-not-file`, `output-unwritable`), `OPFImportError` for the
+ * import step and `OPFExportError` for the export step (`peer-not-installed`, `peer-too-old`, `peer-load-failed`,
+ * `invalid-presentation`, `no-slides`, `all-slides-hidden`, `export-failed`, `import-failed`).
+ *
+ * Node only (also Bun and Deno): the browser build of the root rejects with `OPFApiError` `node-only`.
+ */
+declare function convert(input: ConvertInput, output: string, options?: ConvertOptions): Promise<ConvertResult>;
+declare function convert(input: ConvertInput, options: ConvertOptions & {
+    format: ConvertFormat;
+}): Promise<ConvertResult>;
+/**
+ * Open a deck: a `.opf.md`, `.yaml`/`.yml` or `.json` file (the form named by the extension), or a PowerPoint file (a `.pptx`
+ * path or its bytes), imported. Returns the presentation. A deck file that fails the format and references check throws
+ * `OPFValidationError` (its findings located by line and column in the file); a PowerPoint file that cannot be imported throws
+ * `OPFImportError`; a missing file throws `OPFApiError` `input-not-found`. Warnings are not returned: `validate` reports them,
+ * and `convert("deck.pptx", "deck.opf.yaml")` returns what an import could not keep.
+ *
+ * Node only (also Bun and Deno): the browser build of the root rejects with `OPFApiError` `node-only`.
+ */
+declare function open(input: string | Uint8Array | ArrayBuffer, options?: OpenOptions): Promise<Presentation>;
+/**
+ * Save a deck in the form its file name names (`.opf.md`, `.yaml`/`.yml` or `.json`), atomically, creating folders, replacing
+ * the file. It is checked for format and references first and an invalid deck is refused with `OPFValidationError`;
+ * `validate: false` writes work in progress, as an editor's autosave does. Returns `{ path, format }`.
+ *
+ * Node only (also Bun and Deno): the browser build of the root rejects with `OPFApiError` `node-only`.
+ */
+declare function save(deck: Presentation, path: string, options?: SaveOptions): Promise<SaveResult>;
 
-export { Catalog, CatalogKind, CatalogOptions, type CatalogPatchOperation, type CatalogRecordChange, type CatalogRef, type CatalogUpdate, type CopiedRecordRename, type CopySlidesResult, type DatasetFact, type EmbedResult, type EmbeddedRecord, type HeaderFooterFact, type MoveToCustomErrorCode, type MoveToCustomPatchOperation, type MoveToCustomResult, type MovedRecord, OPFMoveToCustomError, Presentation, type PresentationStats, RecordProvenance, type ReferenceFact, type ResolvedDesignRecords, SLIDE_SCOPED_BUILTINS, type SlideScopedBuiltin, type SlideSizeFact, type SlideStats, type StatsOptions, type StatsSlideRef, type TableFact, UnresolvedReferenceDiagnostic, copySlides, embed, moveToCustom, resolveDesignRecords, resolveFontScheme, resolveSlideVariables, sameRecord, stats, updateFromCatalog };
+export { Catalog, CatalogKind, CatalogOptions, type CatalogPatchOperation, type CatalogRecordChange, type CatalogRef, type CatalogUpdate, ConvertFormat, ConvertInput, ConvertOptions, ConvertResult, type CopiedRecordRename, type CopySlidesResult, type DatasetFact, type EditOptions, type EditResult, type EmbedResult, type EmbeddedRecord, type FillOptions, type FillRecord, type FillResult, type FilledDeck, Finding, type HeaderFooterFact, JsonPatchOperation, type MoveToCustomErrorCode, type MoveToCustomPatchOperation, type MoveToCustomResult, type MovedRecord, OPFMoveToCustomError, OpenOptions, Presentation, type PresentationStats, RecordProvenance, type ReferenceFact, ResolveVariablesOptions, type ResolvedDesignRecords, SLIDE_SCOPED_BUILTINS, SaveOptions, SaveResult, type SlideScopedBuiltin, type SlideSizeFact, type SlideStats, type StatsOptions, type StatsSlideRef, type TableFact, UnresolvedReferenceDiagnostic, VariableDiagnostic, convert, copySlides, edit, embed, fill, fillRecords, moveToCustom, open, paginate, resolveDesignRecords, resolveFontScheme, resolveSlideVariables, sameRecord, save, stats, updateFromCatalog, validate };

package/dist/index.js

@@ -1,19 +1,66 @@
-export { OPFMoveToCustomError, copySlides, embed, moveToCustom, sameRecord, stats, updateFromCatalog } from './chunk-WWYWFVOI.js';
+import { stats, embed, edit, OPFApiError, asApiError } from './chunk-QLFWWHRF.js';
+export { OPFApiError, OPFExportError, OPFImportError, OPFMoveToCustomError, copySlides, fill, fillRecords, moveToCustom, parseSlideSelection, sameRecord, updateFromCatalog } from './chunk-QLFWWHRF.js';
 export { specFileEntries, specFileKinds, specFilePaths } from './chunk-HXHOZ7AH.js';
-export { OPFDataImportError, importData, parseTabularData } from './chunk-O263APNI.js';
-export { DECK_FORMATS, deckFormatOf, parse, stringify } from './chunk-N4EVOFEA.js';
-export { fromMarkdown, toMarkdown } from './chunk-BIC3SWPK.js';
-import './chunk-TCD2FB2K.js';
-export { OPFMarkdownError } from './chunk-IS5H5JKH.js';
-export { diff, merge } from './chunk-M4UR3NPN.js';
-export { OPFPatchError, OPFPatchValidationError, applyPatch } from './chunk-O3CVNJTL.js';
-export { OPFFormatError, format } from './chunk-YT7FMQER.js';
-export { OPFPaginationError, paginate, paginateSlide } from './chunk-O2CX5NEH.js';
-import './chunk-ESRYBYLY.js';
-import './chunk-PPROJP2E.js';
-export { DEFAULT_CHART_PALETTE, DEFAULT_VALIDATION_THRESHOLDS, OPFValidationError, assertValid, assertValidCatalogRecord, findValidationRule, resolveSlideContext, validate, validateCatalogRecord, validationCategories, validationRules } from './chunk-NLNYNBTS.js';
-export { CHART_TYPES, DEFAULT_VARIABLE_DATE_FORMAT, ENGINE_DEFAULT_CHART_TYPES, ENGINE_DEFAULT_COLOR_SCHEME, ENGINE_DEFAULT_FONT_SCHEME, ENGINE_DEFAULT_THEME, LANGUAGES, OPFVariableError, SLIDE_SCOPED_BUILTINS, SOCIAL_PLATFORMS, VARIABLE_KINDS, chartNumber, coerceVariableValue, datasetDiagnostics, formatDataNumber, formatVariableNumber, fromExcelNumberFormat, hasContentVariables, inlineChartData, inlineDatasets, inlineTableData, isDatasetRef, isTemplate, isXYChartType, listBuiltinVariables, listVariables, normalizeLanguageFamily, numberFormatError, resolveChartData, resolveDesignRecords, resolveFontScheme, resolveSlideVariables, resolveTableData, resolveVariables, suggestChartNumberFix, tableCellDisplayValue, toExcelNumberFormat, unusedDatasets, variableDeclarations } from './chunk-CW7GEAV3.js';
+export { OPFDataImportError, ingest, parseTabularData } from './chunk-ZCFSDSUX.js';
+import { defaultCatalog } from './chunk-WCG3THTD.js';
+export { DECK_FORMATS, deckFormatOf, parse, stringify } from './chunk-ZOHFLP3O.js';
+export { fromMarkdown, toMarkdown } from './chunk-DBYZI75U.js';
+import './chunk-NS3VYB57.js';
+export { OPFMarkdownError } from './chunk-CJPDTLGD.js';
+export { diff, merge } from './chunk-YWXB4XAT.js';
+export { OPFPatchError, OPFPatchValidationError, applyPatch } from './chunk-YZXTXX2D.js';
+export { OPFFormatError, format } from './chunk-JXVS7BJK.js';
+import { paginate } from './chunk-64YSJZDH.js';
+export { OPFPaginationError, paginateSlide } from './chunk-64YSJZDH.js';
+import './chunk-VCGRMNY2.js';
+import './chunk-RAKEVM52.js';
+import { validate, OPFValidationError } from './chunk-JT3QXA22.js';
+export { DEFAULT_CHART_PALETTE, DEFAULT_VALIDATION_THRESHOLDS, OPFValidationError, assertValid, assertValidCatalogRecord, findValidationRule, resolveSlideContext, validateCatalogRecord, validationCategories, validationRules } from './chunk-JT3QXA22.js';
+export { CHART_TYPES, DEFAULT_VARIABLE_DATE_FORMAT, ENGINE_DEFAULT_CHART_TYPES, ENGINE_DEFAULT_COLOR_SCHEME, ENGINE_DEFAULT_FONT_SCHEME, ENGINE_DEFAULT_THEME, LANGUAGES, LOGO_SHAPES, OPFVariableError, SLIDE_SCOPED_BUILTINS, SOCIAL_PLATFORMS, VARIABLE_KINDS, chartNumber, coerceVariableValue, datasetDiagnostics, formatDataNumber, formatVariableNumber, fromExcelNumberFormat, hasContentVariables, inlineChartData, inlineDatasets, inlineTableData, isDatasetRef, isTemplate, isXYChartType, listBuiltinVariables, listVariables, normalizeLanguageFamily, numberFormatError, resolveChartData, resolveDesignRecords, resolveFontScheme, resolveSlideVariables, resolveTableData, resolveVariables, suggestChartNumberFix, tableCellDisplayValue, toExcelNumberFormat, unusedDatasets, variableDeclarations } from './chunk-MBU42S5Y.js';
 export { catalogDisplayKinds, catalogSchemaNames } from './chunk-TRDXRRQK.js';
 export { CATALOG_GROUP_PATTERN, CATALOG_REFERENCE_PATTERN, OPFCatalogsOptionError, OPFUnresolvedReferenceError, catalogGroupSource, catalogKinds, catalogRecords, catalogReferenceSites, parseReference, resolveReference, unresolvedReference } from './chunk-SPFV27O5.js';
-export { audience, chartType, colorScheme, fontScheme, language, layout, narrative, presentation, purpose, schemaEntries, schemaNames, schemas, socialPlatform, theme, tone } from './chunk-RA64UQKI.js';
+export { audience, chartType, colorScheme, fontScheme, language, layout, narrative, presentation, purpose, schemaEntries, schemaNames, schemas, socialPlatform, theme, tone } from './chunk-6WW2EDUW.js';
 export { FONT_POLICY, applyFontPolicyDecisions, fontAvailabilityDiagnostics, fontPolicyFor } from './chunk-WXSPETQ6.js';
+
+// src/index.ts
+var DEFAULT_CATALOGS = [defaultCatalog];
+var withDefaultCatalog = (options) => {
+  if (options === void 0) return { catalogs: DEFAULT_CATALOGS };
+  if (options === null || typeof options !== "object" || Array.isArray(options) || options.catalogs !== void 0) return options;
+  return { ...options, catalogs: DEFAULT_CATALOGS };
+};
+var validate2 = (input, options) => validate(input, withDefaultCatalog(options));
+var stats2 = (presentation2, options) => stats(presentation2, withDefaultCatalog(options));
+var paginate2 = (input, options) => paginate(input, withDefaultCatalog(options));
+var embed2 = (document, options) => embed(document, withDefaultCatalog(options));
+var edit2 = (deck, patch, options) => edit(deck, patch, withDefaultCatalog(options));
+var engine = () => import('./conversion-KGDVJM75.js');
+var rethrow = (error, fallback) => {
+  if (error instanceof OPFValidationError) throw error;
+  throw asApiError(OPFApiError, error, fallback);
+};
+async function convert(input, output, options = {}) {
+  try {
+    if (output !== null && typeof output === "object") return await (await engine()).convertFiles(input, void 0, output);
+    if (typeof output !== "string") throw new OPFApiError("convert takes an output file path, or options with a format.", "invalid-option");
+    return await (await engine()).convertFiles(input, output, options);
+  } catch (error) {
+    return rethrow(error, "convert-failed");
+  }
+}
+async function open(input, options = {}) {
+  try {
+    return await (await engine()).openDeck(input, options);
+  } catch (error) {
+    return rethrow(error, "input-unreadable");
+  }
+}
+async function save(deck, path, options = {}) {
+  try {
+    return await (await engine()).saveDeck(deck, path, options);
+  } catch (error) {
+    return rethrow(error, "output-unwritable");
+  }
+}
+
+export { convert, edit2 as edit, embed2 as embed, open, paginate2 as paginate, save, stats2 as stats, validate2 as validate };

package/dist/markdown.d.ts

@@ -1,9 +1,9 @@
-import { b as Catalog } from './catalog-refs-C4K4y-vh.js';
-import { P as Presentation } from './presentation-fb8CZmRq.js';
-import { F as Finding, d as FindingLocation } from './finding-CDQ_wH8j.js';
-import { c as ValidateOptions, f as ValidationReport } from './validation-types-iZbXfES6.js';
-import './composition-BbZ_9C-c.js';
-import './chart-data-DTxdRRT1.js';
+import { a as Catalog } from './catalog-refs-BSfGELpt.js';
+import { P as Presentation } from './presentation-HondgJ3l.js';
+import { a as Finding, b as FindingLocation } from './finding-CT_f_vbD.js';
+import { a as ValidateOptions, V as ValidationReport } from './validation-types-PbGDrNUr.js';
+import './composition-C-OoqvAr.js';
+import './chart-data-BnNqgnC-.js';
 import './json-BFSdESOE.js';
 
 interface EmbeddedPart {
@@ -20,8 +20,12 @@ declare class OPFMarkdownError extends Error {
 }
 
 interface ParseOptions {
-    /** `rules` (default): slides are separated by `---` lines. `headings`: a `# ` heading also starts a new slide (outline input). */
-    split?: "rules" | "headings";
+    /**
+     * How the Markdown is cut into slides. `auto` (the default): by `---` lines, and an outline (no `---` line, and two or more `# `
+     * headings outside fences, comments and notes) by its headings. `rules`: by `---` lines only, so a second `# ` heading on a slide is a second title.
+     * `headings`: a `# ` heading also starts a new slide (outline input).
+     */
+    split?: "auto" | "rules" | "headings";
 }
 
 /**

package/dist/markdown.js

@@ -1,9 +1,9 @@
-export { fromMarkdown, toMarkdown } from './chunk-BIC3SWPK.js';
-export { OPFMarkdownError } from './chunk-IS5H5JKH.js';
-import './chunk-ESRYBYLY.js';
-import './chunk-PPROJP2E.js';
-import './chunk-NLNYNBTS.js';
-import './chunk-CW7GEAV3.js';
+export { fromMarkdown, toMarkdown } from './chunk-DBYZI75U.js';
+export { OPFMarkdownError } from './chunk-CJPDTLGD.js';
+import './chunk-VCGRMNY2.js';
+import './chunk-RAKEVM52.js';
+import './chunk-JT3QXA22.js';
+import './chunk-MBU42S5Y.js';
 import './chunk-TRDXRRQK.js';
 import './chunk-SPFV27O5.js';
-import './chunk-RA64UQKI.js';
+import './chunk-6WW2EDUW.js';

package/dist/node-engine.d.ts

@@ -1,16 +1,15 @@
-export { b as DeckReport, c as DeckReportOptions, r as readDeckReport } from './deck-report-Bx3naFlF.js';
-import { F as FontsHandle, i as EmbeddedFace, R as Renderer, j as Reporter, P as Peer, k as PptxModule } from './conversion-SBpTOwdg.js';
-export { l as ConversionPlan, D as Diagnostic, m as EXPORT_FORMATS, n as ExportContext, o as ExportFile, p as ExportFontSummary, E as ExportFormat, q as ExportOptions, r as ExportResult, s as ExportRun, I as ImportOptions, t as ImportResult, f as OPFApiError, g as OPFExportError, h as OPFImportError, u as PEER_RANGES, v as PPTX_PACKAGE, w as PreparedExport, x as RENDER_PACKAGE, y as ReportFinding, z as Source, V as VERSIONS, A as asApiError, B as checkDate, G as checkOptions, H as checkScale, J as deckFileFormat, K as exportFormatOf, L as finishReport, M as importPresentation, N as loadPptx, Q as loadRenderer, T as missingPeerFrom, U as planConversion, W as prepareExport, X as reaches, Y as readInput, Z as reportThrown, _ as resolveExportOptions, $ as runExport, a0 as runPreparedExport, a1 as writePlanned } from './conversion-SBpTOwdg.js';
-import './catalog-refs-C4K4y-vh.js';
-import './presentation-fb8CZmRq.js';
-import './validation-types-iZbXfES6.js';
-import './composition-BbZ_9C-c.js';
-import './chart-data-DTxdRRT1.js';
-import './finding-CDQ_wH8j.js';
+export { b as DeckReport, c as DeckReportOptions, r as readDeckReport } from './deck-report-wszX7uo8.js';
+import { F as FontsHandle, E as EmbeddedFace, R as Renderer, a as Reporter, P as Peer, b as PptxModule, O as OPFApiError } from './conversion-C5foedh6.js';
+export { C as ConversionPlan, D as Diagnostic, c as EXPORT_FORMATS, d as EXPORT_TEXT, e as ExportContext, f as ExportFile, g as ExportFontSummary, h as ExportFormat, i as ExportOptions, j as ExportResult, k as ExportRun, l as ExportText, I as ImportOptions, m as ImportResult, n as OPFExportError, o as OPFImportError, p as PEER_RANGES, q as PPTX_PACKAGE, r as PreparedExport, s as RENDER_EXTRAS, t as RENDER_PACKAGE, u as ReportFinding, v as ResolvedExportOptions, S as SlideSelection, w as Source, V as VERSIONS, x as asApiError, y as checkDate, z as checkOptions, A as checkRenamedOptions, B as checkScale, G as deckFileFormat, H as exportFormatOf, J as finishReport, K as importPresentation, L as loadPptx, M as loadRenderer, N as locatePackage, Q as missingPeerFrom, T as parseSlideSelection, U as planConversion, W as prepareExport, X as reaches, Y as readInput, Z as reportThrown, _ as resolveExportOptions, $ as runExport, a0 as runPreparedExport, a1 as writePlanned } from './conversion-C5foedh6.js';
+import { a as Catalog } from './catalog-refs-BSfGELpt.js';
+import { P as PresentationPaginationResult } from './pagination-BaUjDrTz.js';
+import './presentation-HondgJ3l.js';
+import './validation-types-PbGDrNUr.js';
+import './composition-C-OoqvAr.js';
+import './chart-data-BnNqgnC-.js';
+import './finding-CT_f_vbD.js';
 import './json-BFSdESOE.js';
 
-/** `1,3-5`, `2-` (to the end) and `-3` (from the start), one-based, in ascending order without repeats. */
-declare function parseSlideSelection(spec: string, total: number, label?: string): number[];
 /** `deck.opf.json` and `deck.pptx` both give `deck`; stdin gives `deck`. */
 declare function stemOf(input: string): string;
 /**
@@ -36,7 +35,7 @@ declare function pointerOf(location: string): string;
 interface PreparedFonts {
     /** The fonts handle of opf-render `loadFonts()`: passed as `{ fonts }` to every deck-level call. */
     handle: FontsHandle;
-    /** Absolute paths of the --font-dir files, in load order. */
+    /** Absolute paths of the --fonts files, in load order. */
     userFonts: string[];
 }
 /** Font files directly inside each directory (no recursion), sorted by name so the load order is the same everywhere. */
@@ -44,7 +43,7 @@ declare function listFontDirectories(directories: string[], label?: string): Pro
 /**
  * The office pack (Carlito, Intos, the open families font schemes select and the open replacements the font policy
  * routes to, with lazy faces loaded on demand), visual substitution, and Noto script packages for the scripts the
- * deck's text draws when they are installed. `faces` are the --font-dir files, loaded first.
+ * deck's text draws when they are installed. `faces` are the --fonts files, loaded first.
  */
 declare function prepareFonts(renderer: Renderer, presentation: unknown, userFonts: string[], reporter: Reporter, embedScriptFonts?: boolean): Promise<PreparedFonts>;
 /** A fonts handle lent to one export. `release` returns it; until then no other export uses the shared handle. */
@@ -61,10 +60,11 @@ interface FontsLease {
  */
 declare function leaseSharedFonts(renderer: Renderer, presentation: unknown, userFonts: string[], reporter: Reporter, embedScriptFonts?: boolean): Promise<FontsLease | undefined>;
 /**
- * Faces an SVG should carry. Marking every face `embed: "used"` makes the renderer embed a face only when the slide's
- * text names its family, so a slide in one family ships kilobytes of font rather than the whole pack.
+ * Faces an SVG should carry for `text`. `"fonts"` (the default) marks every face `embed: "used"`, so the renderer embeds a face only
+ * when the slide's text names its family and a slide in one family ships kilobytes of font rather than the whole pack. `"system"`
+ * embeds none, and `"paths"` draws the text as outlines from the fonts handle itself, so it has no faces to list.
  */
-declare function embeddedFor(handle: FontsHandle, mode: "used" | "none"): (EmbeddedFace & {
+declare function embeddedFor(handle: FontsHandle, text?: "fonts" | "system" | "paths"): (EmbeddedFace & {
     embed?: "used";
 })[];
 
@@ -91,4 +91,24 @@ declare function createZip(entries: {
     bytes: Uint8Array;
 }[]): Uint8Array;
 
-export { FontsHandle, type ImportRun, Peer, type PlannedFile, PptxModule, Renderer, Reporter, checkDestinations, createZip, deckStem, embeddedFor, leaseSharedFonts, listFontDirectories, parseSlideSelection, pointerOf, prepareFonts, runImport, stemOf, writeFiles };
+interface PaginateDeckOptions {
+    /** Folders of `.ttf` and `.otf` files, loaded before the bundled pack (as `--fonts`). They need opf-render. */
+    fontFolders?: readonly string[];
+    catalogs?: readonly Catalog[];
+    /** Receives the font diagnostics. */
+    reporter: Reporter;
+    /** Name options as the command's flags in messages. */
+    flags?: boolean;
+}
+interface PaginatedDeck {
+    result: PresentationPaginationResult;
+    /** Why the layout is estimated: the missing or too old peer (`peer-not-installed`, `peer-too-old`) that measuring needs. */
+    estimated?: OPFApiError;
+}
+/**
+ * Paginate with measured text when opf-render and its fonts load, else with core's estimate (and `estimated` saying why). With
+ * `fontFolders` the fonts are required, so a missing renderer throws. Throws `OPFPaginationError` when content cannot fit.
+ */
+declare function paginateDeck(deck: unknown, options: PaginateDeckOptions): Promise<PaginatedDeck>;
+
+export { FontsHandle, type ImportRun, OPFApiError, type PaginateDeckOptions, type PaginatedDeck, Peer, type PlannedFile, PptxModule, Renderer, Reporter, checkDestinations, createZip, deckStem, embeddedFor, leaseSharedFonts, listFontDirectories, paginateDeck, pointerOf, prepareFonts, runImport, stemOf, writeFiles };

package/dist/node-engine.js

@@ -1,21 +1,44 @@
-export { EXPORT_FORMATS, OPFApiError, OPFExportError, OPFImportError, PEER_RANGES, PPTX_PACKAGE, RENDER_PACKAGE, Reporter, VERSIONS, asApiError, checkDate, checkDestinations, checkOptions, checkScale, createZip, deckFileFormat, deckStem, embeddedFor, exportFormatOf, finishReport, importPresentation, leaseSharedFonts, listFontDirectories, loadPptx, loadRenderer, missingPeerFrom, parseSlideSelection, planConversion, pointerOf, prepareExport, prepareFonts, reaches, readInput, reportThrown, resolveExportOptions, runExport, runImport, runPreparedExport, stemOf, writeFiles, writePlanned } from './chunk-IPW5BS3X.js';
-import './chunk-WWYWFVOI.js';
+import { DEFAULT_CATALOGS, loadRenderer, listFontDirectories, leaseSharedFonts, prepareFonts } from './chunk-KXBZ6ZSB.js';
+export { EXPORT_FORMATS, EXPORT_TEXT, PEER_RANGES, PPTX_PACKAGE, RENDER_EXTRAS, RENDER_PACKAGE, Reporter, VERSIONS, checkDate, checkDestinations, checkOptions, checkRenamedOptions, checkScale, createZip, deckFileFormat, deckStem, embeddedFor, exportFormatOf, finishReport, importPresentation, leaseSharedFonts, listFontDirectories, loadPptx, loadRenderer, locatePackage, missingPeerFrom, planConversion, pointerOf, prepareExport, prepareFonts, reaches, readInput, reportThrown, resolveExportOptions, runExport, runImport, runPreparedExport, stemOf, writeFiles, writePlanned } from './chunk-KXBZ6ZSB.js';
+import { OPFApiError } from './chunk-QLFWWHRF.js';
+export { OPFApiError, OPFExportError, OPFImportError, asApiError, parseSlideSelection } from './chunk-QLFWWHRF.js';
 import './chunk-HXHOZ7AH.js';
-import './chunk-O263APNI.js';
+import './chunk-ZCFSDSUX.js';
 import './chunk-WCG3THTD.js';
-export { readDeckReport } from './chunk-N4EVOFEA.js';
-import './chunk-BIC3SWPK.js';
-import './chunk-TCD2FB2K.js';
-import './chunk-IS5H5JKH.js';
-import './chunk-M4UR3NPN.js';
-import './chunk-O3CVNJTL.js';
-import './chunk-YT7FMQER.js';
-import './chunk-O2CX5NEH.js';
-import './chunk-ESRYBYLY.js';
-import './chunk-PPROJP2E.js';
-import './chunk-NLNYNBTS.js';
-import './chunk-CW7GEAV3.js';
+export { readDeckReport } from './chunk-ZOHFLP3O.js';
+import './chunk-DBYZI75U.js';
+import './chunk-NS3VYB57.js';
+import './chunk-CJPDTLGD.js';
+import './chunk-YWXB4XAT.js';
+import './chunk-YZXTXX2D.js';
+import './chunk-JXVS7BJK.js';
+import { paginate } from './chunk-64YSJZDH.js';
+import './chunk-VCGRMNY2.js';
+import './chunk-RAKEVM52.js';
+import './chunk-JT3QXA22.js';
+import './chunk-MBU42S5Y.js';
 import './chunk-TRDXRRQK.js';
 import './chunk-SPFV27O5.js';
-import './chunk-RA64UQKI.js';
+import './chunk-6WW2EDUW.js';
 import './chunk-WXSPETQ6.js';
+
+// src/node/paginate.ts
+async function paginateDeck(deck, options) {
+  const catalogs = options.catalogs ?? DEFAULT_CATALOGS;
+  const folders = options.fontFolders ?? [];
+  let lease;
+  try {
+    const renderer = await loadRenderer();
+    const userFonts = await listFontDirectories([...folders], options.flags ? "--fonts" : "fonts");
+    lease = await leaseSharedFonts(renderer, deck, userFonts, options.reporter);
+    const handle = lease?.handle ?? (await prepareFonts(renderer, deck, userFonts, options.reporter)).handle;
+    return { result: paginate(deck, { fonts: handle, catalogs }) };
+  } catch (error) {
+    if (error instanceof OPFApiError && (error.code === "peer-not-installed" || error.code === "peer-too-old") && !folders.length) return { result: paginate(deck, { catalogs }), estimated: error };
+    throw error;
+  } finally {
+    lease?.release();
+  }
+}
+
+export { paginateDeck };

package/dist/{pagination-BhX4M48Y.d.ts → pagination-BaUjDrTz.d.ts}

@@ -1,5 +1,5 @@
-import { a as ComposeSlideOptions, e as Fonts, h as LayoutDiagnostic } from './composition-BbZ_9C-c.js';
-import { U as UnresolvedReferenceDiagnostic, R as RecordProvenance, d as CatalogOptions, b as Catalog } from './catalog-refs-C4K4y-vh.js';
+import { C as ComposeSlideOptions, F as Fonts, L as LayoutDiagnostic } from './composition-C-OoqvAr.js';
+import { U as UnresolvedReferenceDiagnostic, R as RecordProvenance, b as CatalogOptions, a as Catalog } from './catalog-refs-BSfGELpt.js';
 
 /**
  * One slide's composition context: the layout, canvas, theme and font families that `composeSlide` needs,
@@ -25,7 +25,8 @@ interface SlideContextOptions extends CatalogOptions {
 interface SlideContext {
     /**
      * The slide to compose and draw: slide `index` with `{{slide.number}}`, `{{slide.section}}` and
-     * `{{deck.slideCount}}` substituted (`resolveSlideVariables`) for `options.slideNumber` and `options.slideCount`.
+     * `{{deck.slideCount}}` substituted (`resolveSlideVariables`) for `options.slideNumber` and `options.slideCount`, and its
+     * logo references (`var:organization.logo.icon` in an image field) resolved for `options.darkBackground`.
      * Its own header and footer text keeps the tokens: `layoutFurniture` substitutes them and marks each slide number
      * as a live field. The source slide object itself when it carries no slide-scoped token.
      */
@@ -126,8 +127,10 @@ interface PresentationPaginationResult {
     pages: (PaginatedPage & {
         sourceSlideIndex: number;
     })[];
+    /** How the page breaks were chosen: `measured` with the `fonts` handle's text measurement, `estimated` with core's portable estimate (no `fonts`). */
+    layout: 'measured' | 'estimated';
 }
 /** Resolve the slides' references (the document's catalogs groups, then the registered catalogs) and paginate a complete presentation without mutating it. */
 declare function paginate(input: unknown, options?: PresentationPaginationOptions): PresentationPaginationResult;
 
-export { OPFPaginationError as O, type PaginatedPage as P, type SlideContext as S, type PaginationMapping as a, type PaginationOptions as b, type PaginationResult as c, type PresentationPaginationOptions as d, type PresentationPaginationResult as e, type SlideContextDiagnostic as f, type SlideContextOptions as g, paginateSlide as h, paginate as p, resolveSlideContext as r };
+export { OPFPaginationError as O, type PresentationPaginationResult as P, type SlideContext as S, type PaginatedPage as a, type PresentationPaginationOptions as b, type PaginationMapping as c, type PaginationOptions as d, type PaginationResult as e, type SlideContextDiagnostic as f, type SlideContextOptions as g, paginateSlide as h, paginate as p, resolveSlideContext as r };

package/dist/pagination.d.ts

@@ -1,4 +1,4 @@
-import './composition-BbZ_9C-c.js';
-import './catalog-refs-C4K4y-vh.js';
-export { O as OPFPaginationError, P as PaginatedPage, a as PaginationMapping, b as PaginationOptions, c as PaginationResult, d as PresentationPaginationOptions, e as PresentationPaginationResult, p as paginate, h as paginateSlide } from './pagination-BhX4M48Y.js';
-import './chart-data-DTxdRRT1.js';
+import './composition-C-OoqvAr.js';
+import './catalog-refs-BSfGELpt.js';
+export { O as OPFPaginationError, a as PaginatedPage, c as PaginationMapping, d as PaginationOptions, e as PaginationResult, b as PresentationPaginationOptions, P as PresentationPaginationResult, p as paginate, h as paginateSlide } from './pagination-BaUjDrTz.js';
+import './chart-data-BnNqgnC-.js';

package/dist/pagination.js

@@ -1,6 +1,6 @@
-export { OPFPaginationError, paginate, paginateSlide } from './chunk-O2CX5NEH.js';
-import './chunk-NLNYNBTS.js';
-import './chunk-CW7GEAV3.js';
+export { OPFPaginationError, paginate, paginateSlide } from './chunk-64YSJZDH.js';
+import './chunk-JT3QXA22.js';
+import './chunk-MBU42S5Y.js';
 import './chunk-TRDXRRQK.js';
 import './chunk-SPFV27O5.js';
-import './chunk-RA64UQKI.js';
+import './chunk-6WW2EDUW.js';

package/dist/patch.d.ts

@@ -1,4 +1,4 @@
-import { e as FindingReport, F as Finding, J as JsonPatchOperation } from './finding-CDQ_wH8j.js';
+import { F as FindingReport, a as Finding, J as JsonPatchOperation } from './finding-CT_f_vbD.js';
 
 type JsonPointer = string;
 type PatchErrorCode = "invalid-patch" | "invalid-patch-operation" | "unsupported-patch-operation" | "invalid-json-pointer" | "patch-path-missing" | "patch-parent-missing" | "invalid-array-index" | "patch-test-failed" | "patch-invalid-move" | "patch-root-remove" | "patch-invalid-document";