@openpresentation/opf 0.11.4 → 0.12.1

package/dist/font-policy.d.ts

@@ -52,6 +52,21 @@ interface FontReplacement {
      * draws this replacement. `measured` is taken with them off, and a metric claim holds only with them
      * off (Georgia -> Gelasio: Gelasio ligates fi/fl where Georgia does not). */
     disabledFeatures?: string[];
+    /** Preview-only font-size multiplier (RR-38). A renderer scales the replacement's font size by this factor when it
+     * measures and draws it, so its advances approximate the real font's (Arabic Typesetting is 0.64 of Noto Naskh Arabic's
+     * width at the same size). It applies only when the face drawn is `family`, and never reaches a PPTX or the geometry core
+     * composes. Absent means 1. */
+    sizeAdjust?: number;
+    /** Preview-only baseline offset (RR-38): em of the font size from the top of a line box to the baseline in PowerPoint (100 percent
+     * line spacing, zero insets) when every run of the line is drawn in the real font. A renderer that places baselines one em below
+     * the line top moves the replacement's runs up by `1 - lineAscent` em. Requires `sizeAdjust`. */
+    lineAscent?: number;
+    /** `lineAscent` for a line that also holds runs in other fonts; `lineAscent` when absent. */
+    lineAscentMixed?: number;
+    /** How `lineAscent` was measured. Present with `lineAscent`. */
+    lineAscentBasis?: string;
+    /** How `sizeAdjust` was measured (corpus, reference font version, advance and ink ratios). Present with `sizeAdjust`. */
+    sizeAdjustBasis?: string;
     /** Null when the reference font was not available to the measuring host. */
     measured: FontReplacementMeasurement | null;
     /** Upstream statement of compatibility, when one exists. */

package/dist/font-policy.js

@@ -1 +1 @@
-export { FONT_POLICY, applyFontPolicyDecisions, fontAvailabilityDiagnostics, fontPolicyFor } from './chunk-RXNFDGPC.js';
+export { FONT_POLICY, applyFontPolicyDecisions, fontAvailabilityDiagnostics, fontPolicyFor } from './chunk-WXSPETQ6.js';

package/dist/format.d.ts

@@ -0,0 +1,20 @@
+declare class FormatError extends Error {
+    constructor(message: string);
+}
+interface FormatOptions {
+    /** Spaces per indentation level. Default 2. */
+    indent?: number;
+    /** Line endings: "lf" (default, canonical) or "crlf" (for Windows checkouts with autocrlf). */
+    eol?: "lf" | "crlf";
+}
+/** A copy of `document` with canonical key order at every depth. Values and array order are unchanged. */
+declare function sortPresentationKeys<T>(document: T): T;
+/**
+ * Canonical text for an OPF document. `input` is either JSON source text or
+ * a parsed document. Throws `FormatError` for text that is not JSON.
+ */
+declare function formatPresentation(input: unknown, options?: FormatOptions): string;
+/** True when `source` is already exactly the canonical text. */
+declare function isFormatted(source: string, options?: FormatOptions): boolean;
+
+export { FormatError, type FormatOptions, formatPresentation, isFormatted, sortPresentationKeys };

package/dist/format.js

@@ -0,0 +1,83 @@
+import { presentation } from './chunk-4LAM3N6S.js';
+
+// src/format.ts
+var FormatError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "FormatError";
+  }
+};
+var root = presentation;
+var flattenCache = /* @__PURE__ */ new WeakMap();
+function collect(schema, seen) {
+  if (!schema || typeof schema !== "object" || seen.has(schema)) return [];
+  seen.add(schema);
+  const node = schema;
+  const out = [node];
+  if (typeof node.$ref === "string" && node.$ref.startsWith("#/$defs/")) out.push(...collect(root.$defs?.[node.$ref.slice("#/$defs/".length)], seen));
+  for (const list of [node.oneOf, node.anyOf, node.allOf]) for (const branch of list ?? []) out.push(...collect(branch, seen));
+  out.push(...collect(node.then, seen), ...collect(node.else, seen));
+  return out;
+}
+function flatten(schema) {
+  if (!schema || typeof schema !== "object") return [];
+  const cached = flattenCache.get(schema);
+  if (cached) return cached;
+  const nodes = collect(schema, /* @__PURE__ */ new Set());
+  flattenCache.set(schema, nodes);
+  return nodes;
+}
+var own = (value, key) => Object.prototype.hasOwnProperty.call(value, key);
+function arrange(value, schemas) {
+  if (Array.isArray(value)) {
+    const itemSchemas = schemas.flatMap((node) => node.items && typeof node.items === "object" ? flatten(node.items) : []);
+    return value.map((item) => arrange(item, itemSchemas));
+  }
+  if (!value || typeof value !== "object") return value;
+  const record = value;
+  const declared = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const node of schemas) for (const key of Object.keys(node.properties ?? {})) if (!seen.has(key)) {
+    seen.add(key);
+    declared.push(key);
+  }
+  const present = Object.keys(record);
+  const ordered = [...declared.filter((key) => own(record, key)), ...present.filter((key) => !seen.has(key))];
+  const out = {};
+  for (const key of ordered) {
+    let children = schemas.flatMap((node) => node.properties && own(node.properties, key) ? flatten(node.properties[key]) : []);
+    if (!children.length && !seen.has(key)) children = schemas.flatMap((node) => node.additionalProperties && typeof node.additionalProperties === "object" ? flatten(node.additionalProperties) : []);
+    Object.defineProperty(out, key, { value: arrange(record[key], children), enumerable: true, configurable: true, writable: true });
+  }
+  return out;
+}
+function sortPresentationKeys(document) {
+  return arrange(document, flatten(root));
+}
+function formatPresentation(input, options = {}) {
+  let document = input;
+  if (typeof input === "string") {
+    try {
+      document = JSON.parse(input.replace(/^/u, ""));
+    } catch (error) {
+      throw new FormatError(`Invalid JSON: ${error.message}`);
+    }
+  }
+  const indent = options.indent ?? 2;
+  if (!Number.isInteger(indent) || indent < 0 || indent > 8) throw new FormatError("indent must be an integer from 0 to 8.");
+  if (options.eol !== void 0 && options.eol !== "lf" && options.eol !== "crlf") throw new FormatError("eol must be lf or crlf.");
+  const text = JSON.stringify(sortPresentationKeys(document), null, indent);
+  if (text === void 0) throw new FormatError("Nothing to format.");
+  return options.eol === "crlf" ? `${text.replaceAll("\n", "\r\n")}\r
+` : `${text}
+`;
+}
+function isFormatted(source, options = {}) {
+  try {
+    return formatPresentation(source, options) === source;
+  } catch {
+    return false;
+  }
+}
+
+export { FormatError, formatPresentation, isFormatted, sortPresentationKeys };

package/dist/index.d.ts

@@ -1,15 +1,18 @@
-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-X_NniU4A.js';
-import { C as CatalogKind } from './catalogs-CUClB3nl.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-CUClB3nl.js';
-export { OPFValidationError, ValidationIssue, ValidationResult, assertValid, assertValidCatalogRecord, assertValidPresentation, validate, validateCatalogRecord, validatePresentation } from './validator.js';
+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 { 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-j5PVrqfV.js';
+export { P as Presentation } from './presentation-DcF-MZcz.js';
 export { LintContract, LintDiagnostic, LintLocation, LintOptions, LintReport, LintSeverity, LintSuggestion, lintPresentation, lintSource } from './lint.js';
-export { a as CodeContent, b as CodeLayout, c as CodeLayoutDiagnostic, d as CodeLayoutOptions, e as CodeLineSegment, f as CodeLineSource, g as CodeTextFit, h as CodeTextPart, C as ComposeSlideOptions, i as ComposedFlow, j as ComposedGroup, k as ComposedItem, l as ComposedLogo, m as ComposedSlideImage, n as Composition, o as CompositionCandidate, p as CompositionDecision, q as CompositionExplanation, r as CompositionPenalties, s as CompositionTrack, D as DEFAULT_FONT_SCHEME, t as DEFAULT_FURNITURE_DATE_FORMAT, u as DEFAULT_SLIDE_NUMBER_FORMAT, v as FontFamilies, F as FontSchemeDiagnostic, w as FurnitureField, x as FurnitureImagePart, y as FurnitureLayout, z as FurniturePart, A as FurniturePartBase, B as FurnitureSocialLink, E as FurnitureTextExtras, G as FurnitureTextPart, H as LayoutBox, L as LayoutDiagnostic, I as ListBulletImage, J as ListEntryLayout, K as ListFit, M as ListFitOptions, N as ListText, O as ListValue, P as LogoSlot, Q as MAX_COMPOSITION_DEPTH, R as MeasureTextWidth, S as MetricContent, U as MetricLayout, V as MetricLayoutDiagnostic, W as MetricLayoutOptions, X as MetricTextPart, Y as MetricTextSource, Z as OPFCompositionError, _ as PICTURE_BULLET_SCALE, $ as QuoteContent, a0 as QuoteLayout, a1 as QuoteLayoutDiagnostic, a2 as QuoteLayoutOptions, a3 as QuoteTextPart, a4 as QuoteTextSource, a5 as ResolveColorRefOptions, a6 as ResolveColorRefRoles, a7 as ResolveLogoOptions, a8 as ResolvedFontScheme, a9 as ResolvedLogo, aa as RichTextFit, ab as RichTextFragment, ac as RichTextLine, ad as RichTextOptions, ae as RichTextRun, af as SlideComposition, ag as SlideImageShape, ah as SocialPlatformRecord, ai as SocialProfile, aj as TextFit, ak as TextLineInk, T as TextMeasurement, al as TextPlacement, am as TextPlacementLine, an as TextStyle, ao as TimelineContent, ap as TimelineEvent, aq as TimelineLayout, ar as TimelineLayoutDiagnostic, as as TimelineLayoutOptions, at as TimelineTextPart, au as chartColorForFill, av as colorContrast, aw as composeSlide, ax as fitList, ay as fitRichText, az as fitText, aA as formatFurnitureDate, aB as formatSlideNumber, aC as layoutCode, aD as layoutFurniture, aE as layoutMetric, aF as layoutQuote, aG as layoutTimeline, aH as measureText, aI as measureTextOutline, aJ as normalizeHexColor, aK as placeTextLines, aL as resolveCanvasDimensions, aM as resolveColorRef, aN as resolveFontFamilies, aO as resolveFontSchemeReference, aP as resolveLogo, aQ as resolveSocialProfile, aR as resolveTextStyle, aS as textColorForFill, aT as textWidthMeasurer, aU as wrapText } from './composition-Dl-d9FRj.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 { 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';
 
 /**
  * Local catalog vendoring: resolve every catalog reference a presentation
@@ -154,23 +157,7 @@ interface ResolvedScriptFonts extends ScriptFontSlots {
         complexScript: ScriptFontSource;
     };
 }
-/** Paragraph base direction. */
-type TextDirection = "ltr" | "rtl";
-/**
- * The base direction of one paragraph in a deck, shared by the renderer and
- * the PPTX exporter so preview and export agree. In a right-to-left deck a
- * paragraph is right-to-left when its first strong character is
- * right-to-left, or when it has no strong character (digits, punctuation or
- * empty text); a paragraph whose first strong character is left-to-right
- * (for example an English quote or code) stays left-to-right. In a
- * left-to-right deck every paragraph is left-to-right.
- *
- * Strong characters follow UAX #9 rule P2: text inside directional isolates
- * (LRI, RLI or FSI up to the matching PDI) is skipped. Letters count as
- * strong; RTL letters are those of right-to-left scripts. The result does not
- * depend on locale data, only on the JavaScript engine's Unicode tables.
- */
-declare function paragraphDirection(text: string, deckDirection: TextDirection | string | undefined): TextDirection;
+
 /** The OOXML script slot for an ISO 15924 script code. Unknown scripts use the latin slot. */
 declare function scriptFontRole(script: string): ScriptRole;
 /**
@@ -186,5 +173,167 @@ declare function scriptFontRole(script: string): ScriptRole;
  * 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;
 
-export { type BundleReport, type BundleResult, CatalogKind, type ResolveScriptFontsOptions, type ResolvedScriptFonts, type ScriptFontApp, type ScriptFontSlots, type ScriptFontSource, type ScriptFontSupplement, type ScriptRole, type TextDirection, bundlePresentation, paragraphDirection, resolveScriptFonts, scriptFontRole };
+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 };