@openpresentation/opf 0.13.0 → 0.15.1

package/dist/index.d.ts

@@ -1,342 +1,525 @@
-export { S as SchemaEntry, a as SchemaName, b as audience, c as chartType, d as colorScheme, f as fontScheme, l as language, e as layout, n as narrative, p as presentation, g as purpose, s as schemaEntries, h as schemaNames, i as schemas, j as socialPlatform, t as theme, k as tone } from './schemas-BbPonsTz.js';
-import { C as CatalogKind } from './catalogs-ywCamd8C.js';
-export { A as Audience, a as CatalogEntry, b as CatalogIndex, c as CatalogIndexRecord, d as CatalogRecord, e as ChartType, f as ColorScheme, F as FontScheme, L as Language, g as Layout, N as Narrative, P as Purpose, S as SocialPlatform, T as Theme, h as Tone, i as audiences, j as catalogEntries, k as catalogIndexes, l as catalogKinds, m as catalogSchemaNames, n as catalogs, o as chartTypes, p as colorSchemes, q as fontSchemes, r as languages, s as layouts, t as narratives, u as purposes, v as socialPlatforms, w as themes, x as tones } from './catalogs-ywCamd8C.js';
-export { D as DEFAULT_VARIABLE_DATE_FORMAT, O as OPFValidationError, a as OPFVariableError, R as ResolveVariablesOptions, b as ResolveVariablesResult, c as VARIABLE_KINDS, d as ValidateOptions, V as ValidationIssue, e as ValidationResult, f as VariableDeclaration, g as VariableDiagnostic, h as VariableDiagnosticCode, i as VariableDiagnosticSeverity, j as VariableInfo, k as VariableKind, l as VariableUse, m as VariableUseForm, n as VariableValues, o as assertValid, p as assertValidCatalogRecord, q as assertValidPresentation, r as coerceVariableValue, s as formatVariableNumber, t as hasContentVariables, u as isTemplate, v as listVariables, w as resolveVariables, x as validate, y as validateCatalogRecord, z as validatePresentation, A as variableDeclarations } from './validator-CIylxoIm.js';
+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, b as ResolveVariablesResult, c as VARIABLE_KINDS, d as ValidateFonts, V as ValidateOptions, e as ValidationCategory, f as ValidationChecks, a 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-BOcY9GTs.js';
 export { SpecFileEntry, SpecFileKind, SpecFilePath, specFileEntries, specFileKinds, specFilePaths } from './spec-files.js';
-export { LayoutPreviewIndex, LayoutPreviewRecord, getLayoutPreview, hasLayoutPreview, layoutPreviewIndex, layoutPreviewSlugs, layoutPreviews } from './previews.js';
-export { P as Presentation } from './presentation-mG-IYErQ.js';
-export { d as AuditCategory, e as AuditDiagnostic, f as AuditFix, a as AuditOptions, g as AuditPatchOperation, b as AuditReport, c as AuditRuleInfo, h as AuditSeverity, A as AuditThresholds, k as LintContract, L as LintDiagnostic, i as LintLocation, l as LintOptions, m as LintReport, j as LintSeverity, n as LintSuggestion, o as lintPresentation, p as lintSource } from './lint-B7azdiuE.js';
-export { DEFAULT_AUDIT_THRESHOLDS, DEFAULT_CHART_PALETTE, auditPresentation, auditRules, auditSource, findAuditRule } from './audit.js';
-import { M as MetricLayout } from './composition-D7we69Tr.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, 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, 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, aM as Reference, aN as ReferencesSlideOptions, aO as ResolveColorRefOptions, aP as ResolveColorRefRoles, 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, b5 as TextDirection, b6 as TextFit, b7 as TextLineInk, 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, bG as layoutTimeline, bH as listNumbers, bI as measureText, bJ as measureTextOutline, bK as normalizeHexColor, 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, bU as resolveColorRef, bV as resolveFontFamilies, bW as resolveFontSchemeReference, bX as resolveLogo, bY as resolveNumbering, bZ as resolveSocialProfile, b_ as resolveTextStyle, b$ as sliceNumberedItems, c0 as slideCitations, c1 as snapFontSizeDown, c2 as snapFontSizeUp, c3 as textColorForFill, c4 as textWidthMeasurer, c5 as walkCitationRuns, c6 as wrapText } from './composition-D7we69Tr.js';
-export { OPFPaginationError, PaginatedPage, PaginationMapping, PaginationOptions, PaginationResult, PresentationPaginationOptions, PresentationPaginationResult, paginatePresentation, paginateSlide } from './pagination.js';
-export { DataCell, DataContentOptions, DataImportOptions, OPFDataImportError, TabularData, createDataContent, parseTabularData } from './data.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 excelNumberFormat, t as formatDataNumber, u as inlineChartData, v as inlineDatasets, w as inlineTableData, x as isDatasetRef, y as isXYChartType, z as numberFormatError, A as numberFormatFromExcel, B as resolveChartData, E as resolveTableData, F as suggestChartNumberFix, G as tableCellDisplayValue, H as unusedDatasets } from './chart-data-Cdr6rRVV.js';
+import { P as Presentation } from './presentation-CDKQVkyI.js';
+export { Audience, ChartType, ColorScheme, FontScheme, Language, Layout, Narrative, Purpose, SocialPlatform, Theme, Tone } from './types.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';
+export { a as Finding, d as FindingCategory, e as FindingFix, f as FindingFocus, b as FindingLocation, F as FindingReport, c as FindingSeverity, g as FindingSuggestion, J as JsonPatchOperation, V as ValidationIssue } from './finding-CT_f_vbD.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 LanguageFamilyName, h as LanguageVocabulary, L as LayoutDiagnostic, M as MeasureTextWidth, S as SOCIAL_PLATFORMS, i as SocialPlatformVocabulary, T as TextMeasurement, j as TextStyle, n as normalizeLanguageFamily } from './composition-D2tghM82.js';
+export { C as CatalogDisplayKind, a as CatalogRecordKind, c as catalogDisplayKinds, b as catalogSchemaNames } from './catalog-schemas-CinPh5WA.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-wedbe7eq.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 { DataCell, DataImportOptions, ImportDataOptions, OPFDataImportError, TabularData, importData, 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 { SYMBOL_FONT_ENCODINGS, SYMBOL_FONT_FAMILIES, SymbolFontCode, SymbolFontEncoding, SymbolFontEncodingTable, SymbolFontFamily, SymbolTextCharacter, isSymbolEncodedFamily, mapSymbolText, symbolCodeForUnicode, symbolCodeOf, symbolFontEncodingFor, symbolUnicodeFor } from './symbol-font-encodings.js';
+import './json-BFSdESOE.js';
 
+/** Whether two records have the same content once embedded (`$schema`, `id` and `x-*` ignored). */
+declare function sameRecord(a: unknown, b: unknown): boolean;
+/** One record `embed` or `copySlides` added to a document. */
+interface EmbeddedRecord {
+    group: string;
+    kind: CatalogKind;
+    id: string;
+    source?: string;
+}
+interface EmbedResult {
+    document: Presentation;
+    /** The records added, in the order they were embedded. */
+    added: EmbeddedRecord[];
+    /** The references that resolve nowhere: they stay as written. */
+    unresolved: UnresolvedReferenceDiagnostic[];
+}
 /**
- * Local catalog vendoring: resolve every catalog reference a presentation
- * uses and inline the resolved records into `catalogs.<kind>.records`, so the
- * document renders identically with no catalog lookups beyond itself.
- *
- * Resolution is local-only: inline records are kept as-is, ids that belong to
- * a kind's custom `source` are left to that source, and everything else
- * resolves against the bundled default catalogs. Every reference a record
- * carries is chased in turn — whether the record came from the bundled
- * catalogs or was already inline — so no inlined record dangles. Running the
- * bundle twice is a no-op.
+ * Embed every record the document references, once, in the group it resolves in, together with the records those
+ * records reference (a theme's colour and font schemes). A bare id that resolves in the host's default catalog is
+ * 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.
  */
-interface BundleReport {
-    /** Record ids inlined by this run, per kind, in output order. */
-    added: Partial<Record<CatalogKind, string[]>>;
-    /** Referenced ids that were already inline in the document, per kind. */
-    alreadyInline: Partial<Record<CatalogKind, string[]>>;
-    /** Kinds left untouched because the document declares a custom source. */
-    keptSources: CatalogKind[];
+declare function embed(document: unknown, options?: CatalogOptions): EmbedResult;
+/** A copied record that did not keep its reference. */
+interface CopiedRecordRename {
+    kind: CatalogKind;
+    /** The reference in the source document. */
+    from: string;
+    /** The reference the copied slides use in the target. */
+    to: string;
     /**
-     * Referenced bare ids that resolve nowhere locally, per kind — listed for
-     * exactly the positions the validator warns about, so `unresolved` means
-     * "the validator would warn about this": the string shorthand of
-     * `narrative`, bare-id `audience` entries (string or `{ id }` form), the
-     * design references `themes`, `colorSchemes` and `fontSchemes` (string or
-     * `{ id }` form, at deck and slide level), and `chart.type`.
-     *
-     * Every other reference — tones, purposes, languages, layouts,
-     * social platforms, object-form narratives, and anything reached through a
-     * record rather than written by the author — is still resolved and inlined
-     * when it is found, and skipped in silence when it is not, because the
-     * validator does not warn there either.
-     *
-     * Informational: unknown ids are warnings, never errors.
+     * `custom-conflict`: the target's own record of that id differs (or the id is taken); `catalog-revision`: the target
+     * holds a different revision of the same catalog record, so the incoming one moved to `custom`.
      */
-    unresolved: Partial<Record<CatalogKind, string[]>>;
+    reason: 'custom-conflict' | 'catalog-revision';
 }
-interface BundleResult {
-    presentation: unknown;
-    report: BundleReport;
+interface CopySlidesResult {
+    /** The new target document; `to` is not mutated. */
+    document: Presentation;
+    /** Indexes of the copied slides in the target. */
+    slides: number[];
+    /** Every record this call created under another id (`<id>-2` and up), so an author can review it. A reference rewritten to a record an earlier copy created, which this call reuses, is not a rename and is not listed. */
+    renamed: CopiedRecordRename[];
+    /** Catalog groups the target did not have, added for the copied records. */
+    addedGroups: {
+        name: string;
+        source?: string;
+    }[];
+    /** Records added to the target. */
+    added: EmbeddedRecord[];
+    /** References of the copied slides that resolve nowhere in the source: copied as written. */
+    unresolved: UnresolvedReferenceDiagnostic[];
 }
 /**
- * Resolve every catalog reference `value` uses and inline the resolved
- * records, returning a new document plus a report of what changed. The input
- * document is not modified.
- *
- * Anything that is not an object, and any document whose `catalogs` is
- * present but not an object, is returned unchanged with an all-empty report:
- * bundling there would have to overwrite that field, and schema-invalid input
- * deserves a defined no-op over silent data loss. The CLI validates before
- * bundling, so only a direct library call can reach that case.
- *
- * Ids that resolve nowhere are reported as unresolved for the positions the
- * validator warns about, and silently skipped elsewhere; see
- * `BundleReport.unresolved`.
- */
-declare function bundlePresentation(value: unknown): BundleResult;
-
-/**
- * Language/script font model (font-fidelity-everywhere FF-18).
- *
- * Resolves, for a presentation's language and effective font scheme, the font
- * family for each OOXML script slot (`a:latin`, `a:ea`, `a:cs`) of the major
- * (heading) and minor (body) theme fonts, plus the language tags and base
- * direction. Pure: no DOM, fonts, network or mutation. Catalog references
- * resolve against inline `catalogs.<kind>.records[]` first and the bundled
- * catalogs second; a custom `source` is not fetched.
- *
- * Catalog ids and catalog tags resolve deterministically from vendored tables.
- * Only a tag that matches no catalog record may consult the runtime's ICU
- * likely subtags (`Intl.Locale#maximize`) to find its script.
- *
- * Design: docs/programs/font-fidelity-everywhere/script-font-model.md.
+ * Copy slides `indexes` of `from` to the end of `to` (or before `options.at`), with the records they reference.
+ * Groups match by `source`, not by name: references are rewritten to the target's name for that source, and a missing
+ * group is added (renamed when its name is taken). A record whose content the target already has is reused. A `custom`
+ * record whose id the target uses for different content is renamed `<id>-2`. A catalog record whose revision differs
+ * from the one the target resolves goes into `custom` as `<id>-2`, so the copied slides look the same, and is listed in
+ * `renamed`.
  */
-/** OOXML script slot a writing system uses: `a:latin`, `a:ea` or `a:cs`. */
-type ScriptRole = "latin" | "eastAsian" | "complexScript";
-/** Target application whose language font-scheme defaults apply. */
-type ScriptFontApp = "PowerPoint" | "Google Slides";
-/** Font family per OOXML script slot for one theme font (major or minor). */
-interface ScriptFontSlots {
-    latin: string;
-    eastAsian: string;
-    complexScript: string;
+declare function copySlides(from: unknown, to: unknown, indexes: readonly number[], options?: CatalogOptions & {
+    at?: number;
+}): CopySlidesResult;
+/** A reference to update, by kind: `two-column` (a default record) or `acme:hero`. */
+interface CatalogRef {
+    kind: CatalogKind;
+    reference: string;
+}
+/** One embedded record whose registered catalog publishes different content. */
+interface CatalogRecordChange {
+    kind: CatalogKind;
+    /** The reference that names it: a bare id for `default`, `name:id` otherwise. */
+    reference: string;
+    group: string;
+    id: string;
+    source: string;
+    /** The record as the document embeds it. */
+    embedded: Record<string, unknown>;
+    /** The catalog's current record, as it would be embedded. */
+    current: Record<string, unknown>;
+}
+/** An RFC 6902 operation of `CatalogUpdate.patch`. */
+interface CatalogPatchOperation {
+    op: 'replace';
+    path: string;
+    value: Record<string, unknown>;
+}
+/** A reviewable update: nothing is applied until the author applies `patch` (core `applyPatch`). */
+interface CatalogUpdate {
+    changes: CatalogRecordChange[];
+    patch: CatalogPatchOperation[];
 }
 /**
- * Where a resolved eastAsian/complexScript family came from:
- * - `fontScheme`: an explicit `eastAsian`/`complexScript` slot on the effective design font scheme.
- * - `schemeFamily`: the design font scheme's own major/minor, because its `languageFamily` names this
- *   slot and its `languages` list is empty or names the presentation language.
- * - `language`: the presentation language's font scheme (`fontScheme`, or `googleFontScheme` for Google Slides).
- * - `latin`: no script-specific choice exists, so the slot repeats the latin family.
+ * Compare the records a document embeds under `default` and its named groups with the current records of the catalogs
+ * registered for their sources. Returns the differences and the patch that would adopt them; never changes the document.
+ * `refs` limits the check to those references. `custom` records belong to the document and are never compared.
  */
-type ScriptFontSource = "fontScheme" | "schemeFamily" | "language" | "latin";
-/** A per-script supplemental theme font, as in OOXML `<a:font script="Jpan" typeface="..."/>`. */
-interface ScriptFontSupplement {
-    /** OOXML theme script tag (ISO 15924, except Korean uses `Hang`). */
-    script: string;
-    heading: string;
-    body: string;
+declare function updateFromCatalog(document: unknown, catalogs: readonly Catalog[], refs?: readonly CatalogRef[]): CatalogUpdate;
+/** Where a moved record was and where it is now. */
+interface MovedRecord {
+    kind: CatalogKind;
+    group: string;
+    id: string;
+    /** The reference that names it there: a bare id under `default` and `custom`, `name:id` in a named group. */
+    reference: string;
 }
-interface ResolveScriptFontsOptions {
-    /** Which language font-scheme default applies. Defaults to `PowerPoint` (`language.fontScheme`). */
-    app?: ScriptFontApp;
-    /** Merge `slides[slideIndex].design` over the deck design, per field, before resolving the font scheme. */
-    slideIndex?: number;
-    /** Language reference to resolve instead of the document's `language` (catalog id, BCP-47 tag or Language object). */
-    language?: unknown;
-    /** Language tag used when neither the document nor `options.language` names a resolvable language. Defaults to `en-US`. */
-    defaultLanguage?: string;
+/** Error codes of OPFMoveToCustomError. */
+type MoveToCustomErrorCode = 'invalid-reference' | 'already-custom' | 'not-embedded' | 'invalid-id';
+declare class OPFMoveToCustomError extends Error {
+    readonly code: MoveToCustomErrorCode;
+    constructor(code: MoveToCustomErrorCode, message: string);
 }
-interface ResolvedScriptFonts extends ScriptFontSlots {
-    /**
-     * Tag for OOXML `a:rPr/@lang` (and `a:endParaRPr/@lang`): an authored tag that carries a region,
-     * else the language record's curated `ooxmlLang`, else the canonical BCP-47 tag.
-     */
-    lang: string;
-    /** Canonically cased BCP-47 tag for HTML/SVG `lang`: the authored tag, else the record's `bcp47`. */
-    bcp47: string;
-    /** Matched languages catalog record id, when one matched. */
-    languageId?: string;
-    /** `default` when the tag came from `defaultLanguage` because no language resolved. */
-    languageSource: "document" | "option" | "default";
-    /** ISO 15924 script (`Zzzz` when it cannot be determined). */
-    script: string;
-    /** Script slot the language's own text uses. */
-    scriptRole: ScriptRole;
-    direction: "ltr" | "rtl";
-    rtl: boolean;
-    /** Major (heading) theme font slots. */
-    heading: ScriptFontSlots;
-    /** Minor (body) theme font slots. The top-level latin/eastAsian/complexScript repeat these. */
-    body: ScriptFontSlots;
-    /**
-     * Supplemental theme font for the language's script. Present only when an explicit slot, the
-     * design scheme's own script family or the language's font scheme supplies one; absent for
-     * Latin, Cyrillic, Greek and for scripts with no script font. For Armenian, Georgian and
-     * Ethiopic (latin slot) an explicit `complexScript` slot or a design `cs` scheme that serves the
-     * language replaces the language's own font scheme.
-     */
-    supplement?: ScriptFontSupplement;
-    sources: {
-        eastAsian: ScriptFontSource;
-        complexScript: ScriptFontSource;
+/** An RFC 6902 operation of `MoveToCustomResult.patch`. */
+type MoveToCustomPatchOperation = {
+    op: 'add';
+    path: string;
+    value: unknown;
+} | {
+    op: 'remove';
+    path: string;
+} | {
+    op: 'replace';
+    path: string;
+    value: string;
+};
+interface MoveToCustomResult {
+    /** The new document; the input is not mutated. */
+    document: Presentation;
+    from: MovedRecord;
+    to: MovedRecord;
+    /** The references rewritten to name the moved record, as JSON Pointers into the document. */
+    references: string[];
+    /** RFC 6902 operations that turn the input into `document` (apply with core `applyPatch`, for undo and review). */
+    patch: MoveToCustomPatchOperation[];
+    /** Present when `custom` already held a different record under the wanted id, so the record took `<id>-2` (and up). */
+    renamed?: {
+        from: string;
+        to: string;
     };
 }
-
-/** The OOXML script slot for an ISO 15924 script code. Unknown scripts use the latin slot. */
-declare function scriptFontRole(script: string): ScriptRole;
 /**
- * Resolve the per-script theme fonts, language tags and direction for a
- * presentation (or a `{ design, language, catalogs }` subset of one).
+ * Move an embedded record from `catalogs.default` or a named group into `catalogs.custom`: the fix that
+ * `opf/catalog-record-not-in-source` suggests for a record the group's catalog does not publish. Every reference that
+ * resolved to the record (on slides, in the deck, inside other embedded records) is rewritten to name it in `custom`,
+ * and the record's own references keep naming the records they named. The record keeps its id unless `custom` already
+ * holds a different record under it, when it becomes `<id>-2` (and up); an identical custom record is reused.
  *
- * The latin slot follows the effective design font scheme exactly as
- * `resolveFontFamilies` does; when nothing names a font scheme it falls back to
- * the shared `DEFAULT_FONT_SCHEME`. Each of the eastAsian and complexScript slots
- * takes, in order: the design font scheme's explicit slot; the scheme's own
- * families when its `languageFamily` names the slot and its `languages` list
- * is empty or names the language; the language's font scheme when the
- * language's script uses the slot; otherwise the latin family.
- */
-declare function resolveScriptFonts(input: unknown, options?: ResolveScriptFontsOptions): ResolvedScriptFonts;
-/**
- * The deck base direction composition lays a slide out in: the direction of the presentation language's script
- * (`rtl` for Arabic, Hebrew and the other right-to-left scripts), `ltr` when the document names no language or
- * the language does not resolve. Layout, preview and export all read this one value (RR-05).
+ * Fork: with `id`, the record is copied into `custom` under that id instead (an editor calls this on the first edit of a
+ * record under `default` or a named group, then applies the edit to the copy). Every reference is rewritten to the copy,
+ * so nothing references the original any more and it is dropped from its group. A different custom record under the
+ * wanted id (the record's own, or `id`) makes it `<id>-2` and up, reported in `renamed`; an identical one is reused.
+ *
+ * Throws OPFMoveToCustomError (`invalid-reference`, `already-custom`, `not-embedded`, `invalid-id`).
+ * Registered catalogs only matter for how the surrounding references resolve, so pass the host's `catalogs` as for
+ * validate.
  */
-declare function resolveSlideDirection(presentation: unknown, slideIndex?: number): "ltr" | "rtl";
+declare function moveToCustom(document: unknown, ref: CatalogRef, options?: CatalogOptions & {
+    id?: string;
+}): MoveToCustomResult;
 
 /**
- * Deterministic syntax highlighting shared by the SVG preview and the PPTX export (RR-07).
- *
- * `tokenizeCode(source, language)` returns coloured token ranges over the exact source
- * string; everything between tokens is plain. `codeSyntaxPalette` derives one colour per
- * token kind from the deck theme and keeps each at WCAG contrast >= 4.5:1 against the code
- * panel. The scanner is a small hand-written one (no dependency, no network, no locale or
- * clock input): it recognises comments, strings, numbers, keywords, definition names, calls,
- * capitalised types and the structure of JSON, YAML, TOML, HTML/XML and CSS. It never edits
- * the text: callers colour ranges of `code.source` and the concatenated runs equal the source.
- * An unknown or missing language yields no tokens (plain text).
+ * The theme, colour scheme and font scheme one slide (or the deck) is drawn with, resolved the one way every engine
+ * resolves them: the slide's design, then the deck's design, then the theme, then the engine default, per field.
+ * Catalog-free: records come from the document's catalogs groups and the catalogs the host registered.
  */
-type CodeTokenKind = 'comment' | 'keyword' | 'string' | 'number' | 'function' | 'type' | 'property';
-interface CodeToken {
-    start: number;
-    end: number;
-    kind: CodeTokenKind;
-}
-/** A slice of one source line: `kind` is absent for plain text. */
-interface CodeRun {
-    start: number;
-    end: number;
-    kind?: CodeTokenKind;
+type Rec = Record<string, unknown>;
+interface ResolvedDesignRecords {
+    theme: Rec;
+    colorScheme: Rec;
+    fontScheme: Rec;
+    /** Where the theme reference is written, dotted (`design.theme`, `slides.2.design.theme`). */
+    themePath: string;
+    /** Where the colour-scheme reference that applies is written, dotted. */
+    colorSchemePath: string;
+    /** Where the font-scheme reference that applies is written, dotted. */
+    fontSchemePath: string;
+    /** The font-scheme reference that applies (a string, or the `id` of an object reference), if any. */
+    fontSchemeReference?: string;
+    /**
+     * Where each record came from (group, source, `document` or `host`), so an engine records provenance without
+     * resolving again. A kind is absent when its engine default applies (no reference, or one that resolves nowhere).
+     */
+    provenance: {
+        theme?: RecordProvenance;
+        colorScheme?: RecordProvenance;
+        fontScheme?: RecordProvenance;
+    };
+    /** Unresolved references, in the order theme, colour scheme, font scheme. */
+    diagnostics: UnresolvedReferenceDiagnostic[];
 }
-type CodeSyntaxPalette = Record<CodeTokenKind | 'plain', string>;
-/** Source longer than this is left plain: highlighting must stay bounded. */
-declare const CODE_HIGHLIGHT_MAX_LENGTH = 200000;
-/** Contrast the palette keeps against the code panel. */
-declare const CODE_SYNTAX_MIN_CONTRAST = 4.5;
-/** The code panel colour the preview and the PPTX export both draw. */
-declare const CODE_PANEL_BACKGROUND = "#111827";
-declare const CODE_PANEL_FOREGROUND = "#E5E7EB";
-/** Language ids with a scanner (the keys the aliases resolve to). */
-declare const CODE_HIGHLIGHT_LANGUAGES: readonly string[];
-/** The scanner id for a `code.language` value, or undefined when the language is not highlighted. */
-declare function resolveCodeLanguage(language: unknown): string | undefined;
 /**
- * Token ranges of `source` for a `code.language` value, sorted and non-overlapping. Empty for
- * an unknown language, a missing language, or source longer than CODE_HIGHLIGHT_MAX_LENGTH.
+ * The design records slide `slideIndex` is drawn with (the deck's own when `slideIndex` is undefined). Never throws for
+ * an unresolved reference: the engine default applies and `diagnostics` names the reference.
  */
-declare function tokenizeCode(source: string, language?: unknown): CodeToken[];
-/**
- * The runs of one source line `[start, end)`: consecutive slices that cover the line exactly.
- * A token that crosses the line boundary is clipped, so each native text line can be coloured
- * on its own while concatenating the runs returns the line text unchanged. With `source`, a tab
- * character is always its own plain run, as in the preview where a tab is a measured segment: a
- * token (a multi-line string, say) never colours a tab stop.
- */
-declare function codeLineRuns(tokens: readonly CodeToken[], start: number, end: number, source?: string): CodeRun[];
-interface CodeSyntaxPaletteOptions {
-    background?: string;
-    foreground?: string;
-    minimumContrast?: number;
+declare function resolveDesignRecords(document: unknown, slideIndex: number | undefined, options?: CatalogOptions): ResolvedDesignRecords;
+/** Resolve a font-scheme reference (a string, or an object with an optional `id` plus overrides) on its own. */
+declare function resolveFontScheme(document: unknown, reference: unknown, path: string, options?: CatalogOptions & {
+    group?: string;
+}): {
+    scheme: Rec;
+    diagnostics: UnresolvedReferenceDiagnostic[];
+};
+
+/** A reference as authored: the string (a bare id, `name:id`, a tag or free text) or the inline object's id. */
+interface ReferenceFact {
+    id: string | null;
+    inline: boolean;
 }
-interface CodeSyntaxPaletteTheme {
-    primary?: string;
-    secondary?: string;
-    accent?: string;
-    mutedText?: string;
+interface SlideSizeFact {
+    /** The preset name when one is set (`16:9`, `4:3`, `letter`, ...); null for custom inches. */
+    preset: string | null;
+    widthInches: number;
+    heightInches: number;
+    /** width / height, to 3 decimals. */
+    aspectRatio: number;
+    /** Where the size comes from: the deck's `design.dimensions`, its theme record, or the engine default (widescreen). */
+    source: 'design' | 'theme' | 'default';
 }
-/**
- * One colour per token kind from the deck theme: keyword = primary, string = accent,
- * number = secondary, comment = a fixed slate; function, type and property take fixed hues
- * (blue, cyan, pink) rotated away from any theme colour they would collide with. Every
- * colour is lightened until it keeps `minimumContrast` (4.5:1) against the code panel, so a
- * dark theme colour is raised rather than dropped. Deterministic for a given theme.
- */
-declare function codeSyntaxPalette(theme?: CodeSyntaxPaletteTheme, options?: CodeSyntaxPaletteOptions): CodeSyntaxPalette;
-/**
- * The palette for a resolved colour scheme record (`primary`, `secondary`, `accent`, or the
- * `accent1` to `accent3` slots they default to). The preview and the PPTX export both call this
- * with the scheme they resolved, so they cannot disagree on the inputs.
- */
-declare function codeSyntaxPaletteForScheme(scheme: unknown, options?: CodeSyntaxPaletteOptions): CodeSyntaxPalette;
-
-/**
- * Metric trend mark (RR-07): the arrow and colour that show `metric.trend` in the SVG preview
- * and the PPTX export. Core's metric layout places the trend word (up, down, flat) as ordinary
- * text; this derives, from that accepted line geometry, one arrow beside it so both engines draw
- * the same shape in the same place and colour. The word stays the text alternative: the arrow
- * adds a visual cue and an `ariaLabel`, never rewritten source text.
- */
-
-type MetricTrend = 'up' | 'down' | 'flat';
-/** The DrawingML preset geometry that draws each trend (`a:prstGeom prst`). */
-declare const METRIC_TREND_SHAPES: Readonly<Record<MetricTrend, 'upArrow' | 'downArrow' | 'rightArrow'>>;
-declare const METRIC_TREND_MIN_CONTRAST = 4.5;
-interface MetricTrendColorOptions {
-    /** The slide background the metric text sits on. */
-    background: string;
-    /** Neutral colour for a flat trend (the deck's muted text). */
-    neutral?: string;
+interface StatsSlideRef {
+    /** Zero-based position, the same index as `/slides/<index>`. */
+    index: number;
+    id: string | null;
 }
-/** The colour of a trend, kept at >= 4.5:1 against the slide background. */
-declare function metricTrendColor(trend: MetricTrend, options: MetricTrendColorOptions): string;
-interface MetricTrendMark {
-    trend: MetricTrend;
-    /** DrawingML preset name for native export. */
-    shape: 'upArrow' | 'downArrow' | 'rightArrow';
-    /** Arrow bounding box in layout pixels (96 per inch). */
-    box: {
-        x: number;
-        y: number;
-        width: number;
-        height: number;
-    };
-    /** The arrow outline as polygon points in layout pixels: the preset geometry at default adjustments. */
-    points: [number, number][];
-    color: string;
-    /** Text alternative for the arrow. */
-    ariaLabel: string;
-    /** Path of the trend field the mark belongs to. */
+interface HeaderFooterFact {
+    /** The deck sets this furniture. */
+    configured: boolean;
+    /** The deck sets it to `false`. */
+    suppressed: boolean;
+    zones: string[];
+    /** Fields set in any zone: logo, image, text, organization, socials, section, slideNumber, date. */
+    fields: string[];
+}
+interface TableFact {
+    slide: number;
+    /** JSON Pointer of the table. */
     path: string;
+    rows: number;
+    columns: number;
+    /** The top-level dataset the table takes its data from, if any. */
+    dataset: string | null;
 }
-/** Outline of the DrawingML upArrow, downArrow or rightArrow preset (adj1 = adj2 = 50000) in `box`. */
-declare function metricTrendPoints(shape: MetricTrendMark['shape'], box: MetricTrendMark['box']): [number, number][];
-/**
- * The arrow for a laid-out metric, or undefined when the metric has no (visible) trend or the
- * arrow has no room. It is square, as tall as the trend word's capitals, on the baseline, and
- * sits after the word for left-aligned metrics and before it for centred or right-aligned ones,
- * so it grows away from the alignment edge. It never leaves the trend field's box.
- */
-declare function metricTrendMark(layout: MetricLayout, options: MetricTrendColorOptions): MetricTrendMark | undefined;
-
-/**
- * DrawingML preset pattern fills (ECMA-376 20.1.10.51 ST_PresetPatternVal) as 8x8 bitmaps,
- * shared by the SVG preview (RR-07) and the PPTX export, which writes the same names as native
- * `a:pattFill prst="..."`.
- *
- * ECMA-376 names the 54 presets but does not define their pixels. These tiles are MEASURED from
- * desktop PowerPoint (Office 365, Windows, 2026-10-01): each preset was exported as a full-slide
- * pattern background (black on white) to a 1280 x 720 PNG and opf-render's
- * `scripts/derive-pattern-bitmaps.mjs` voted every pixel into its (x mod 8, y mod 8) cell; every
- * tile was uniform across all repeats (confidence 1.00) at one image pixel per pattern pixel, so a
- * pattern pixel is one 1/96 inch unit. The tile is anchored at the slide's top-left corner (the
- * phase of the line, grid and diagonal presets matched at no shift). Measured pixel data is
- * committed as data; no third-party table was used. A tile is one row per line, '#' = foreground,
- * '.' = background, top to bottom, left to right.
- */
-/** ST_PresetPatternVal, in specification order. */
-declare const PATTERN_PRESETS: readonly string[];
-/** Engine ids that are not DrawingML names, with the preset they draw and export as. */
-declare const PATTERN_PRESET_ALIASES: Readonly<Record<string, string>>;
-/** The pattern size PowerPoint tiles: 8 x 8 units, one unit per 1/96 inch. */
-declare const PATTERN_TILE_SIZE = 8;
-/** The DrawingML preset a pattern id draws as: a preset name, an alias (diagStripe), or undefined. */
-declare function resolvePatternPreset(preset: unknown): string | undefined;
-/** Eight row bytes, top to bottom, most significant bit = leftmost pixel; undefined for an unknown id. */
-declare function patternBitmap(preset: unknown): readonly number[] | undefined;
-/** Horizontal runs of set pixels (`x`, `y`, `width` in tile units), in reading order. */
-declare function patternRuns(preset: unknown): {
-    x: number;
-    y: number;
-    width: number;
-}[] | undefined;
+interface DatasetFact {
+    id: string;
+    title: string | null;
+    columns: number;
+    rows: number;
+    /** `source.src` when the dataset declares a source, else null. */
+    source: string | null;
+    /** Charts and tables that reference it. */
+    referencedBy: number;
+}
+interface SlideStats {
+    index: number;
+    id: string | null;
+    title: string | null;
+    layout: string | null;
+    section: string | null;
+    hidden: boolean;
+    /** Content payload kinds present on the slide (root, blocks and regions), in a fixed order. */
+    payloads: string[];
+    words: {
+        content: number;
+        notes: number;
+    };
+    hasNotes: boolean;
+    /** Estimated speaking time for the notes at `wordsPerMinute`, in seconds. */
+    speakingSeconds: number;
+    images: number;
+    charts: number;
+    tables: number;
+    citations: number;
+}
+interface PresentationStats {
+    deck: {
+        name: string | null;
+        description: boolean;
+        filename: string | null;
+        author: string[];
+        language: ReferenceFact | null;
+        slideSize: SlideSizeFact;
+        template: boolean;
+        tags: string[];
+        takeaways: number;
+        declaredMinutes: number | null;
+        design: {
+            theme: ReferenceFact | null;
+            colorScheme: ReferenceFact | null;
+            fontScheme: ReferenceFact | null;
+        };
+        audience: ReferenceFact[];
+        purpose: ReferenceFact | null;
+        tone: ReferenceFact | null;
+        narrative: (ReferenceFact & {
+            beats: number;
+        }) | null;
+    };
+    people: {
+        organizations: {
+            id: string;
+            name: string;
+            role: string | null;
+            hasLogo: boolean;
+        }[];
+        speakers: {
+            id: string;
+            name: string;
+            title: string | null;
+            organizationId: string | null;
+            hasPhoto: boolean;
+        }[];
+    };
+    slides: {
+        total: number;
+        hidden: StatsSlideRef[];
+        withTitle: number;
+        withoutTitle: number;
+        withBeat: number;
+        /** Consecutive slides sharing a `section` label. */
+        sections: {
+            name: string;
+            slides: number;
+            firstSlide: number;
+        }[];
+        unsectioned: number;
+        /** Slides per layout id. */
+        layouts: Record<string, number>;
+        withoutLayout: number;
+        /** Slides whose own `design` object overrides the deck design. */
+        withOwnDesign: number;
+    };
+    /** Content payloads by kind, counted across slide roots, blocks and promoted regions. */
+    payloads: {
+        text: number;
+        items: number;
+        bullets: number;
+        quote: number;
+        metric: number;
+        code: number;
+        timeline: number;
+        chart: number;
+        table: number;
+        image: number;
+        video: number;
+        /** Block entries at any depth. */
+        blocks: number;
+        /** Promoted region payloads (`left`, `top:center`, ...). */
+        regions: number;
+        /** Blocks and regions that hold nested `blocks`. */
+        groups: number;
+        /** Deepest block nesting; 0 when no slide has blocks. */
+        maxDepth: number;
+    };
+    words: {
+        content: number;
+        notes: number;
+        total: number;
+        /** Content words per slide. */
+        perSlide: {
+            min: number;
+            max: number;
+            mean: number;
+        };
+    };
+    notes: {
+        withNotes: number;
+        withoutNotes: StatsSlideRef[];
+    };
+    speakingTime: {
+        basis: 'estimate';
+        wordsPerMinute: number;
+        notesWords: number;
+        minutes: number;
+        declaredMinutes: number | null;
+    };
+    images: {
+        /** Image payloads (image blocks and `Slide.image`). */
+        content: {
+            total: number;
+            withAlt: number;
+            decorative: number;
+            missingAlt: number;
+        };
+        /** Logo images: `design.logo` (every LogoSet variant), deck and slides, plus organization logos. */
+        logos: number;
+        watermarks: {
+            deck: boolean;
+            slides: number;
+        };
+        backgrounds: {
+            deck: boolean;
+            slides: number;
+        };
+        headerFooter: number;
+        speakerPhotos: number;
+        videos: number;
+    };
+    charts: {
+        total: number;
+        byType: Record<string, number>;
+        data: {
+            inline: number;
+            dataset: number;
+            source: number;
+        };
+    };
+    tables: {
+        total: number;
+        datasetBacked: number;
+        rows: number;
+        columns: number;
+        items: TableFact[];
+    };
+    datasets: {
+        count: number;
+        withSource: number;
+        items: DatasetFact[];
+    };
+    citations: {
+        references: number;
+        /** Reference ids cited by at least one run, in declaration order. */
+        cited: string[];
+        /** Runs that cite. */
+        citations: number;
+        footnotes: number;
+        captions: number;
+        links: number;
+    };
+    variables: {
+        declared: number;
+        byKind: Record<string, number>;
+        required: number;
+        optional: number;
+        filled: number;
+        unfilled: string[];
+        unfilledRequired: string[];
+        /** Declared variables nothing references. */
+        unused: string[];
+    };
+    assets: {
+        registry: {
+            entries: number;
+            embedded: number;
+            files: number;
+            remote: number;
+        };
+        /** Every asset-bearing field: images, videos, logos, photos, backgrounds, header/footer images, external chart data. */
+        uses: {
+            total: number;
+            references: number;
+            embedded: number;
+            files: number;
+            remote: number;
+        };
+        /** Decoded size of the embedded `data:` URIs in `uses` and the registry. */
+        embeddedBytes: number;
+    };
+    headerFooter: {
+        header: HeaderFooterFact;
+        footer: HeaderFooterFact;
+        slides: {
+            headerOverrides: number;
+            headerSuppressed: number;
+            footerOverrides: number;
+            footerSuppressed: number;
+        };
+    };
+    fonts: {
+        /** Every family named: by a font scheme in effect, an inline scheme, or a run's `fontFamily`. */
+        families: string[];
+        /** Font-scheme references in effect (deck and slide overrides). */
+        schemeIds: string[];
+        /** References that resolve nowhere (opf/unresolved-reference); the engine default font scheme is used for them. */
+        unresolvedSchemeIds: string[];
+        runOverrides: string[];
+    };
+    colors: {
+        variables: {
+            id: string;
+            value: string | null;
+            uses: number;
+        }[];
+    };
+    /** Keys under `extensions` on the deck, slides and payloads. */
+    extensions: string[];
+    /** The catalog groups the document embeds records in: each group's source and its record count per kind. */
+    catalogs: Record<string, {
+        source: string | null;
+        records: Record<string, number>;
+    }>;
+    /** Present only with `perSlide: true`. */
+    perSlide?: SlideStats[];
+}
+interface StatsOptions extends CatalogOptions {
+    /** Add the per-slide breakdown as `perSlide`. */
+    perSlide?: boolean;
+    /** Variable values to count as filled, as for `resolveVariables`. */
+    values?: Record<string, unknown>;
+    /** Speaking pace for the notes estimate. Default 130. */
+    wordsPerMinute?: number;
+}
+declare function stats(presentation: unknown, options?: StatsOptions): PresentationStats;
 
-export { type BundleReport, type BundleResult, CODE_HIGHLIGHT_LANGUAGES, CODE_HIGHLIGHT_MAX_LENGTH, CODE_PANEL_BACKGROUND, CODE_PANEL_FOREGROUND, CODE_SYNTAX_MIN_CONTRAST, CatalogKind, type CodeRun, type CodeSyntaxPalette, type CodeSyntaxPaletteOptions, type CodeSyntaxPaletteTheme, type CodeToken, type CodeTokenKind, METRIC_TREND_MIN_CONTRAST, METRIC_TREND_SHAPES, MetricLayout, type MetricTrend, type MetricTrendColorOptions, type MetricTrendMark, PATTERN_PRESETS, PATTERN_PRESET_ALIASES, PATTERN_TILE_SIZE, type ResolveScriptFontsOptions, type ResolvedScriptFonts, type ScriptFontApp, type ScriptFontSlots, type ScriptFontSource, type ScriptFontSupplement, type ScriptRole, bundlePresentation, codeLineRuns, codeSyntaxPalette, codeSyntaxPaletteForScheme, metricTrendColor, metricTrendMark, metricTrendPoints, patternBitmap, patternRuns, resolveCodeLanguage, resolvePatternPreset, resolveScriptFonts, resolveSlideDirection, scriptFontRole, tokenizeCode };
+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, type SlideSizeFact, type SlideStats, type StatsOptions, type StatsSlideRef, type TableFact, UnresolvedReferenceDiagnostic, copySlides, embed, moveToCustom, resolveDesignRecords, resolveFontScheme, sameRecord, stats, updateFromCatalog };