@openpresentation/opf 0.12.2 → 0.14.0

package/dist/index.d.ts

@@ -1,18 +1,320 @@
-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-BSjlG8-R.js';
-import { C as CatalogKind } from './catalogs-BnI7JKcn.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-BnI7JKcn.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-DfG9yxba.js';
+export { a as SchemaEntry, S 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-DDpqAgyS.js';
+import { C as CatalogKind } from './catalogs-D-yyQWCQ.js';
+export { A as Audience, e as CatalogEntry, f as CatalogIndex, g as CatalogIndexRecord, h as CatalogRecord, a as ChartType, b as ColorScheme, F as FontScheme, L as Language, c as Layout, N as Narrative, P as Purpose, S as SocialPlatform, T as Theme, d 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-D-yyQWCQ.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-zh03LeZy.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-DcF-MZcz.js';
-export { LintContract, LintDiagnostic, LintLocation, LintOptions, LintReport, LintSeverity, LintSuggestion, lintPresentation, lintSource } from './lint.js';
-export { AuditCategory, AuditDiagnostic, AuditFix, AuditOptions, AuditPatchOperation, AuditReport, AuditRuleInfo, AuditSeverity, AuditThresholds, DEFAULT_AUDIT_THRESHOLDS, DEFAULT_CHART_PALETTE, auditPresentation, auditRules, auditSource, findAuditRule } from './audit.js';
-import { M as MetricLayout } from './composition-DWbCiMwF.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-DWbCiMwF.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 { P as Presentation } from './presentation-C5eHkevA.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-C_por275.js';
+export { C as ComposeSlideOptions, F as FontFamilies, a as FontSchemeDiagnostic, b as Fonts, L as LanguageFamilyName, c as LayoutDiagnostic, M as MeasureTextWidth, T as TextMeasurement, d as TextStyle, n as normalizeLanguageFamily } from './composition-_WEwBe2a.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, h as SlideContextReferenceDiagnostic, p as paginate, i as paginateSlide, r as resolveSlideContext } from './pagination-BZpXLvFL.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-B_3z9VTb.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';
+
+/** A reference as authored: the string (a catalog id, URL, `pkg:` reference, tag or free text) or the inline record's id. */
+interface ReferenceFact {
+    id: string | null;
+    inline: boolean;
+}
+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';
+}
+interface StatsSlideRef {
+    /** Zero-based position, the same index as `/slides/<index>`. */
+    index: number;
+    id: string | null;
+}
+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;
+}
+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 and slide images (`design.slideImage`). */
+        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 ids in effect (deck and slide overrides). */
+        schemeIds: string[];
+        /** Ids that match no inline or bundled record. */
+        unresolvedSchemeIds: string[];
+        runOverrides: string[];
+    };
+    colors: {
+        variables: {
+            id: string;
+            value: string | null;
+            uses: number;
+        }[];
+    };
+    /** Keys under `extensions` on the deck, slides and payloads. */
+    extensions: string[];
+    /** Per-kind inline catalog overrides. */
+    catalogOverrides: Record<string, {
+        records: number;
+        source: string | null;
+    }>;
+    /** Present only with `perSlide: true`. */
+    perSlide?: SlideStats[];
+}
+interface StatsOptions {
+    /** 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;
 
 /**
  * Local catalog vendoring: resolve every catalog reference a presentation
@@ -36,13 +338,12 @@ interface BundleReport {
     /**
      * 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
+     * "the validator would warn about this": the `narrative` string, 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
+     * social platforms, 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.
@@ -70,270 +371,6 @@ interface BundleResult {
  * 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.
- */
-/** 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;
-}
-/**
- * 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.
- */
-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;
-}
-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;
-}
-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.
-     */
-    supplement?: ScriptFontSupplement;
-    sources: {
-        eastAsian: ScriptFontSource;
-        complexScript: ScriptFontSource;
-    };
-}
-
-/** 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).
- *
- * 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).
- */
-declare function resolveSlideDirection(presentation: unknown, slideIndex?: number): "ltr" | "rtl";
-
-/**
- * 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).
- */
-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 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.
- */
-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;
-}
-interface CodeSyntaxPaletteTheme {
-    primary?: string;
-    secondary?: string;
-    accent?: string;
-    mutedText?: string;
-}
-/**
- * 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;
-}
-/** 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. */
-    path: string;
-}
-/** 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;
+declare function bundle(value: unknown): BundleResult;
 
-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 { type BundleReport, type BundleResult, CatalogKind, type DatasetFact, type HeaderFooterFact, type PresentationStats, type ReferenceFact, type SlideSizeFact, type SlideStats, type StatsOptions, type StatsSlideRef, type TableFact, bundle, stats };