@openpresentation/opf-render 0.11.9 → 0.12.0

package/dist/font-policy.js

@@ -23,7 +23,7 @@ const SNAPSHOT=freeze({
  },
  "source": {
   "path": "spec/reference/font-policy.json",
-  "sha256": "2616392b58bcaaffef5182c612ad7b562f9187cd099f919ca3abee225a5411a3"
+  "sha256": "7c7699c6184318099cd7acb75d541654bd18d69be4468fcf518343dfa48e2636"
  },
  "families": [
   {
@@ -135,7 +135,14 @@ const SNAPSHOT=freeze({
    "replacement": {
     "family": "Cousine",
     "compatibility": "visual",
-    "measured": null
+    "measured": {
+     "replacement": "Cousine",
+     "meanAbsWidthDelta": 0,
+     "meanWidthDelta": 0,
+     "maxAbsWidthDelta": 0,
+     "styles": 4,
+     "reference": "Aptos Mono 2.01;O365"
+    }
    },
    "alternates": [
     "Roboto Mono"
@@ -203,6 +210,11 @@ const SNAPSHOT=freeze({
    "replacement": {
     "family": "Noto Naskh Arabic",
     "compatibility": "visual",
+    "sizeAdjust": 0.64,
+    "lineAscent": 0.7,
+    "lineAscentMixed": 0.78,
+    "lineAscentBasis": "RR-38 native PowerPoint 365 probe (probe-arabic.pptx, 18, 24 and 32 pt, 100 percent line spacing, zero insets, top anchor, rtl paragraph): the baseline of an Arabic Typesetting-only line (the most common ink-bottom row of the line) sits 0.68, 0.71 and 0.72 em below the box top (regular) and 0.68, 0.72 and 0.73 em (bold), against Arabic Typesetting's hhea ascent of 0.701 em; a line that also holds an Aptos run (Arabic, 'PowerPoint 365', Arabic) sits 0.77, 0.78 and 0.78 em below it. Core places the baseline one em below the line top, so the preview drew Arabic lines 0.22 to 0.30 em lower.",
+    "sizeAdjustBasis": "RR-38: sum of Arabic Typesetting 6.85 advances over sum of Noto Naskh Arabic 400 advances (fontkit, each sample's OpenType language). 0.643 on the 12 Arabic-script corpus samples of opf-render test/fixtures/script-corpora.json (per-sample range 0.57 to 0.86); 0.598 on 29 Arabic strings of the RR-05b native deck (running Arabic text); 0.614 pooled; Noto Naskh Arabic 700 gives 0.62, 0.58 and 0.59, so bold runs draw about 3 percent long. Ink height of alef, lam, meem and heh is 0.71 of Noto Naskh Arabic's. 0.64 balances the two: lines come out about 4 percent longer than PowerPoint's and glyphs about 10 percent smaller. Native check (RR-38 probe): PowerPoint's BoundWidth of the 45-character probe line is 216.9, 289.0 and 386.1 pt at 18, 24 and 32 pt, 1.8 to 2.0 percent above the fontkit advance of the installed font (213.0, 284.0, 378.7).",
     "measured": {
      "replacement": "Noto Naskh Arabic",
      "meanAbsWidthDelta": 0.6632,
@@ -546,7 +558,16 @@ const SNAPSHOT=freeze({
     "office-cloud"
    ],
    "embeddableByOpf": false,
-   "replacement": null
+   "replacement": {
+    "family": "STIX Two Math",
+    "compatibility": "visual",
+    "measured": null,
+    "source": "https://github.com/stipub/stixfonts"
+   },
+   "alternates": [
+    "Noto Sans Math",
+    "Caladea"
+   ]
   },
   {
    "family": "Candara",
@@ -1042,7 +1063,14 @@ const SNAPSHOT=freeze({
    "replacement": {
     "family": "Barlow",
     "compatibility": "visual",
-    "measured": null
+    "measured": {
+     "replacement": "Barlow",
+     "meanAbsWidthDelta": 0.0467,
+     "meanWidthDelta": -0.0467,
+     "maxAbsWidthDelta": 0.0976,
+     "styles": 4,
+     "reference": "Grandview 1.04;O365"
+    }
    },
    "alternates": [
     "Roboto"
@@ -1059,7 +1087,14 @@ const SNAPSHOT=freeze({
    "replacement": {
     "family": "Barlow",
     "compatibility": "visual",
-    "measured": null
+    "measured": {
+     "replacement": "Barlow",
+     "meanAbsWidthDelta": 0.0249,
+     "meanWidthDelta": -0.0242,
+     "maxAbsWidthDelta": 0.0599,
+     "styles": 2,
+     "reference": "Grandview Display 0.90;O365"
+    }
    },
    "alternates": [
     "Roboto"
@@ -1219,7 +1254,19 @@ const SNAPSHOT=freeze({
    "license": "OFL-1.1",
    "availability": [],
    "embeddableByOpf": true,
-   "replacement": null
+   "replacement": {
+    "family": "Cousine",
+    "compatibility": "metric",
+    "measured": {
+     "replacement": "Cousine",
+     "meanAbsWidthDelta": 0,
+     "meanWidthDelta": 0,
+     "maxAbsWidthDelta": 0,
+     "styles": 4,
+     "reference": "Liberation Mono 2.1.5"
+    },
+    "source": "https://github.com/liberationfonts/liberation-fonts/blob/2.1.5/README.md"
+   }
   },
   {
    "family": "Liberation Sans",
@@ -1227,7 +1274,19 @@ const SNAPSHOT=freeze({
    "license": "OFL-1.1",
    "availability": [],
    "embeddableByOpf": true,
-   "replacement": null
+   "replacement": {
+    "family": "Arimo",
+    "compatibility": "metric",
+    "measured": {
+     "replacement": "Arimo",
+     "meanAbsWidthDelta": 0,
+     "meanWidthDelta": 0,
+     "maxAbsWidthDelta": 0,
+     "styles": 4,
+     "reference": "Liberation Sans 2.1.5"
+    },
+    "source": "https://github.com/liberationfonts/liberation-fonts/blob/2.1.5/README.md"
+   }
   },
   {
    "family": "Liberation Serif",
@@ -1235,7 +1294,19 @@ const SNAPSHOT=freeze({
    "license": "OFL-1.1",
    "availability": [],
    "embeddableByOpf": true,
-   "replacement": null
+   "replacement": {
+    "family": "Tinos",
+    "compatibility": "metric",
+    "measured": {
+     "replacement": "Tinos",
+     "meanAbsWidthDelta": 0,
+     "meanWidthDelta": 0,
+     "maxAbsWidthDelta": 0,
+     "styles": 4,
+     "reference": "Liberation Serif 2.1.5"
+    },
+    "source": "https://github.com/liberationfonts/liberation-fonts/blob/2.1.5/README.md"
+   }
   },
   {
    "family": "Libre Caslon Text",
@@ -1547,6 +1618,22 @@ const SNAPSHOT=freeze({
     }
    }
   },
+  {
+   "family": "Noto Color Emoji",
+   "licenseClass": "open",
+   "license": "OFL-1.1",
+   "availability": [],
+   "embeddableByOpf": true,
+   "replacement": null
+  },
+  {
+   "family": "Noto Emoji",
+   "licenseClass": "open",
+   "license": "OFL-1.1",
+   "availability": [],
+   "embeddableByOpf": true,
+   "replacement": null
+  },
   {
    "family": "Noto Naskh Arabic",
    "licenseClass": "open",
@@ -1573,6 +1660,14 @@ const SNAPSHOT=freeze({
    "embeddableByOpf": true,
    "replacement": null
   },
+  {
+   "family": "Noto Sans Arabic",
+   "licenseClass": "open",
+   "license": "OFL-1.1",
+   "availability": [],
+   "embeddableByOpf": true,
+   "replacement": null
+  },
   {
    "family": "Noto Sans Armenian",
    "licenseClass": "open",
@@ -1671,6 +1766,14 @@ const SNAPSHOT=freeze({
    "embeddableByOpf": true,
    "replacement": null
   },
+  {
+   "family": "Noto Sans Lao",
+   "licenseClass": "open",
+   "license": "OFL-1.1",
+   "availability": [],
+   "embeddableByOpf": true,
+   "replacement": null
+  },
   {
    "family": "Noto Sans Malayalam",
    "licenseClass": "open",
@@ -1679,6 +1782,14 @@ const SNAPSHOT=freeze({
    "embeddableByOpf": true,
    "replacement": null
   },
+  {
+   "family": "Noto Sans Math",
+   "licenseClass": "open",
+   "license": "OFL-1.1",
+   "availability": [],
+   "embeddableByOpf": true,
+   "replacement": null
+  },
   {
    "family": "Noto Sans Mongolian",
    "licenseClass": "open",
@@ -1687,6 +1798,14 @@ const SNAPSHOT=freeze({
    "embeddableByOpf": true,
    "replacement": null
   },
+  {
+   "family": "Noto Sans Myanmar",
+   "licenseClass": "open",
+   "license": "OFL-1.1",
+   "availability": [],
+   "embeddableByOpf": true,
+   "replacement": null
+  },
   {
    "family": "Noto Sans Oriya",
    "licenseClass": "open",
@@ -1705,6 +1824,22 @@ const SNAPSHOT=freeze({
    "embeddableByOpf": true,
    "replacement": null
   },
+  {
+   "family": "Noto Sans Sinhala",
+   "licenseClass": "open",
+   "license": "OFL-1.1",
+   "availability": [],
+   "embeddableByOpf": true,
+   "replacement": null
+  },
+  {
+   "family": "Noto Sans Syriac",
+   "licenseClass": "open",
+   "license": "OFL-1.1",
+   "availability": [],
+   "embeddableByOpf": true,
+   "replacement": null
+  },
   {
    "family": "Noto Sans Tamil",
    "licenseClass": "open",
@@ -1729,6 +1864,14 @@ const SNAPSHOT=freeze({
    "embeddableByOpf": true,
    "replacement": null
   },
+  {
+   "family": "Noto Sans Thaana",
+   "licenseClass": "open",
+   "license": "OFL-1.1",
+   "availability": [],
+   "embeddableByOpf": true,
+   "replacement": null
+  },
   {
    "family": "Noto Sans Thai",
    "licenseClass": "open",
@@ -1745,6 +1888,14 @@ const SNAPSHOT=freeze({
    "embeddableByOpf": true,
    "replacement": null
   },
+  {
+   "family": "Noto Serif Tibetan",
+   "licenseClass": "open",
+   "license": "OFL-1.1",
+   "availability": [],
+   "embeddableByOpf": true,
+   "replacement": null
+  },
   {
    "family": "Nyala",
    "licenseClass": "proprietary-standard",
@@ -1947,7 +2098,14 @@ const SNAPSHOT=freeze({
    "replacement": {
     "family": "Source Sans 3",
     "compatibility": "visual",
-    "measured": null
+    "measured": {
+     "replacement": "Source Sans 3",
+     "meanAbsWidthDelta": 0.0483,
+     "meanWidthDelta": -0.0483,
+     "maxAbsWidthDelta": 0.0965,
+     "styles": 4,
+     "reference": "Seaford 1.04;O365"
+    }
    },
    "alternates": [
     "Carlito"
@@ -1964,7 +2122,14 @@ const SNAPSHOT=freeze({
    "replacement": {
     "family": "Source Sans 3",
     "compatibility": "visual",
-    "measured": null
+    "measured": {
+     "replacement": "Source Sans 3",
+     "meanAbsWidthDelta": 0.0389,
+     "meanWidthDelta": 0.0388,
+     "maxAbsWidthDelta": 0.0667,
+     "styles": 2,
+     "reference": "Seaford Display 1.04;O365"
+    }
    },
    "alternates": [
     "Carlito"
@@ -2006,7 +2171,15 @@ const SNAPSHOT=freeze({
     "office-cloud"
    ],
    "embeddableByOpf": false,
-   "replacement": null
+   "replacement": {
+    "family": "Noto Color Emoji",
+    "compatibility": "visual",
+    "measured": null,
+    "source": "https://github.com/googlefonts/noto-emoji"
+   },
+   "alternates": [
+    "Noto Emoji"
+   ]
   },
   {
    "family": "Segoe UI Light",
@@ -2166,7 +2339,14 @@ const SNAPSHOT=freeze({
    "replacement": {
     "family": "Open Sans",
     "compatibility": "visual",
-    "measured": null
+    "measured": {
+     "replacement": "Open Sans",
+     "meanAbsWidthDelta": 0.0926,
+     "meanWidthDelta": 0.0926,
+     "maxAbsWidthDelta": 0.1593,
+     "styles": 4,
+     "reference": "Skeena 1.04;O365"
+    }
    },
    "alternates": [
     "Carlito"
@@ -2183,7 +2363,14 @@ const SNAPSHOT=freeze({
    "replacement": {
     "family": "Open Sans",
     "compatibility": "visual",
-    "measured": null
+    "measured": {
+     "replacement": "Open Sans",
+     "meanAbsWidthDelta": 0.1306,
+     "meanWidthDelta": 0.1306,
+     "maxAbsWidthDelta": 0.2001,
+     "styles": 4,
+     "reference": "Skeena Display 1.04;O365"
+    }
    },
    "alternates": [
     "Carlito"
@@ -2210,9 +2397,24 @@ const SNAPSHOT=freeze({
    "replacement": {
     "family": "Source Sans 3",
     "compatibility": "visual",
-    "measured": null
+    "measured": {
+     "replacement": "Source Sans 3",
+     "meanAbsWidthDelta": 0.0003,
+     "meanWidthDelta": -0.0003,
+     "maxAbsWidthDelta": 0.0041,
+     "styles": 4,
+     "reference": "Source Sans Pro 2.045"
+    }
    }
   },
+  {
+   "family": "STIX Two Math",
+   "licenseClass": "open",
+   "license": "OFL-1.1",
+   "availability": [],
+   "embeddableByOpf": true,
+   "replacement": null
+  },
   {
    "family": "Sylfaen",
    "licenseClass": "proprietary-standard",
@@ -2289,7 +2491,14 @@ const SNAPSHOT=freeze({
    "replacement": {
     "family": "Figtree",
     "compatibility": "visual",
-    "measured": null
+    "measured": {
+     "replacement": "Figtree",
+     "meanAbsWidthDelta": 0.042,
+     "meanWidthDelta": 0.042,
+     "maxAbsWidthDelta": 0.0836,
+     "styles": 1,
+     "reference": "Tenorite 1.04;O365"
+    }
    },
    "alternates": [
     "Roboto"
@@ -2306,7 +2515,14 @@ const SNAPSHOT=freeze({
    "replacement": {
     "family": "Figtree",
     "compatibility": "visual",
-    "measured": null
+    "measured": {
+     "replacement": "Figtree",
+     "meanAbsWidthDelta": 0.1476,
+     "meanWidthDelta": 0.1476,
+     "maxAbsWidthDelta": 0.1975,
+     "styles": 2,
+     "reference": "Tenorite Display 1.04;O365"
+    }
    },
    "alternates": [
     "Roboto"

package/dist/fonts.d.ts

@@ -96,8 +96,38 @@ export interface ScriptFontsOptions {
 export declare function createScriptFonts(profile?: ScriptFontProfile, measurement?: TextMeasurement, options?: ScriptFontsOptions): ScriptFonts;
 /** Designated open families a preview tries, in order, for a character its face lacks (own script, deck script, Noto Sans, other CJK, other Noto scripts). */
 export declare function glyphFallbackFamilies(character: string, profile?: ScriptFontProfile, serif?: boolean): string[];
+
+/** Symbol-encoded families (FF-45): Symbol, Wingdings, Wingdings 2, Wingdings 3 and Webdings preview through code-to-Unicode tables. */
+export type SymbolFontFamily = "Symbol" | "Wingdings" | "Wingdings 2" | "Wingdings 3" | "Webdings";
+/** The script key the open symbol faces load under (`scripts: ['Zsym']`). */
+export declare const SYMBOL_SCRIPT: "Zsym";
+/** Drawn for a code with no Unicode equivalent, or whose equivalent no loaded face has (U+25A1). */
+export declare const SYMBOL_PLACEHOLDER: string;
+/** The open faces that preview each symbol-encoded family, in the order a code tries them. */
+export declare const SYMBOL_PREVIEW_FACES: Readonly<Record<SymbolFontFamily, readonly string[]>>;
+/** Every open face a symbol preview may draw with. */
+export declare const SYMBOL_FACE_FAMILIES: readonly string[];
+/** Per family: the verified font version and, for codes 0x20..0xFF in order, `[unicode, advance, reason?]` (hex code points joined with '+', font units). */
+export declare const SYMBOL_ENCODINGS: readonly Readonly<{ family: SymbolFontFamily; version: string; unitsPerEm: number; mapped: number; codes: readonly (readonly [string | null, number | null, string?])[] }>[];
+/** Which core table (spec/reference/symbol-font-encodings.json) the snapshot came from. */
+export declare const SYMBOL_ENCODINGS_SOURCE: Readonly<{ version: number; path: string; sha256: string }>;
+export declare function isSymbolEncodedFamily(family: string): boolean;
+export declare function symbolEncodingFor(family: string): (typeof SYMBOL_ENCODINGS)[number] | undefined;
+export declare function symbolPreviewFaces(family: string): readonly string[];
+/** The symbol code (0x20..0xFF) of one character: a private-use U+F0xx, an ASCII or Latin-1 character, or a Windows-1252 character at 0x80..0x9F; null for anything else. */
+export declare function symbolCodeOf(character: string): number | null;
+/** Normalise text in a symbol-encoded family: per character its code (null when not a code), the Unicode equivalent to draw (or null with a reason) and the verified font's advance in em. */
+export declare function mapSymbolText(family: string, text: string): { source: string; code: number | null; unicode: string | null; advance: number | null; reason?: string }[];
 /** Wrap a measurement so pagination, the renderer and the editor itemize script runs identically. */
 export declare function createScriptTextMeasurement(measurement: TextMeasurement, profile: ScriptFontProfile, options?: ScriptFontsOptions): TextMeasurement;
 export declare function openTypeLanguage(tag: string | undefined): string | undefined;
 /** Heading or body role of a style from its OPF path; undefined without a slide path. */
 export declare function textRole(style: { path?: string } | undefined): "heading" | "body" | undefined;
+/** FF-45: the emoji faces (Noto Color Emoji, then Noto Emoji); they draw emoji-presentation clusters only. */
+export declare const EMOJI_FONT_FAMILIES: readonly string[];
+/** True when the text holds an emoji-presentation cluster (emoji-default characters, VS16, skin tones, flags, keycaps, tags). */
+export declare function hasEmojiPresentation(text: string): boolean;
+/** True when the text holds mathematical notation that text faces lack (math alphanumerics, letterlike math sets, rarer operator blocks). */
+export declare function hasMathNotation(text: string): boolean;
+/** Colour faces of the manifest: resvg draws their monochrome stand-in (`rasterFamily`); browsers draw them in colour. */
+export declare const COLOR_FONT_FACES: readonly { family: string; file: string; package: string; format: string; rasterFamily: string }[];

package/dist/fonts.js

@@ -1,11 +1,14 @@
 import { create } from "fontkit";
 import { FONT_COMPATIBILITY, disabledFeaturesFor } from "./font-compatibility.js";
-import { openTypeLanguage, scriptFontAliases } from "./script-fonts.js";
+import { adjustedFontSize, openTypeLanguage, scriptFontAliases, sizeAdjustFor } from "./script-fonts.js";
 import { fontPolicyFor } from "./font-policy.js";
 import { BUNDLED_FONT_MANIFEST } from "./font-manifest.js";
+import { SYMBOL_SCRIPT, isSymbolEncodedFamily, symbolEncodingFor, symbolPreviewFaces } from "./symbol-fonts.js";
+export { SYMBOL_SCRIPT, SYMBOL_PLACEHOLDER, SYMBOL_PREVIEW_FACES, SYMBOL_FACE_FAMILIES, SYMBOL_ENCODINGS, SYMBOL_ENCODINGS_SOURCE, isSymbolEncodedFamily, symbolEncodingFor, symbolPreviewFaces, symbolCodeOf, mapSymbolText } from "./symbol-fonts.js";
 export { FONT_COMPATIBILITY, EXPERIMENTAL_FONT_CANDIDATES, disabledFeaturesFor } from "./font-compatibility.js";
 export { FONT_POLICY, FONT_POLICY_DECISIONS, FONT_POLICY_SOURCE, fontPolicyFor } from "./font-policy.js";
-export { SCRIPT_FONT_FAMILIES, SCRIPT_FONT_REPLACEMENTS, createScriptFonts, createScriptTextMeasurement, designatedFamilies, glyphFallbackFamilies, detectScripts, itemizeScripts, openTypeLanguage, scriptFontAliases, scriptFontRole, scriptOfCharacter, textRole } from "./script-fonts.js";
+export { EMOJI_FONT_FAMILIES, SCRIPT_FONT_FAMILIES, SCRIPT_FONT_REPLACEMENTS, createScriptFonts, createScriptTextMeasurement, designatedFamilies, glyphFallbackFamilies, detectScripts, hasEmojiPresentation, hasMathNotation, itemizeScripts, openTypeLanguage, scriptFontAliases, scriptFontRole, sizeAdjustFor, adjustedFontSize, lineAscentFor, baselineShift, scriptOfCharacter, textRole } from "./script-fonts.js";
+export { COLOR_FONT_FACES } from "./color-fonts.js";
 
 export class OPFFontError extends Error {
   constructor(code, message, details = {}) { super(message); this.name = "OPFFontError"; this.code = code; this.details = details; }
@@ -51,7 +54,7 @@ function unavailableFontError(family, style, policy) {
 // A lookup that cannot be decoded is treated as one that applies nothing (no subtables), so the rest of the feature still runs: advances equal
 // a browser's for the face's Latin and Mongolian samples (test/mongolian-shaping.mjs). Applied only after shaping failed, once per font.
 const lookupsGuarded = new WeakSet();
-function skipUndecodableLookups(font) {
+export function skipUndecodableLookups(font) {
   if (lookupsGuarded.has(font)) return false;
   lookupsGuarded.add(font);
   let guarded = false;
@@ -75,9 +78,17 @@ function skipUndecodableLookups(font) {
 export function pickFace(faces, family, style, {policy = "none", aliases = new Map(), fallbackFamily} = {}) {
   const findFamily = name => faces.filter(face=>face.family.toLowerCase()===name.toLowerCase() || face.familyGroup.toLowerCase()===name.toLowerCase());
   const weight = style.fontWeight ?? 400;
-  let matching = findFamily(family), compatibility = "exact", rule, targetWeight = weight, styleFallback = false, via = "family";
-  const encodedSymbol = /^(wingdings(?: [23])?|webdings|symbol)$/i.test(family);
-  if (!matching.length && encodedSymbol) throw new OPFFontError("font-encoding-required", `Font '${family}' requires character mapping before substitution.`, {path:style.path,fontFamily:family});
+  let matching = findFamily(family), compatibility = "exact", rule, targetWeight = weight, styleFallback = false, via = "family", encoding;
+  // FF-45: a symbol-encoded family (Symbol, Wingdings, Wingdings 2, Wingdings 3, Webdings) whose own face is not loaded
+  // draws the Unicode equivalent of each code with the first loaded open symbol face (symbol-fonts.js: Noto Sans Symbols 2,
+  // Noto Sans Symbols, Noto Sans Math, or the office pack's Noto Sans). The resolved style carries the encoding so the
+  // planner maps every character; the PPTX keeps the family and the original codes. Without any such face the caller's
+  // fallback family applies, else the request fails as before (font-encoding-required) and names the pack to load.
+  if (!matching.length && isSymbolEncodedFamily(family)) {
+    for (const candidate of symbolPreviewFaces(family)) { const pool = findFamily(candidate); if (pool.length) { matching = pool; break; } }
+    if (matching.length) { compatibility = "visual"; via = "encoding"; encoding = symbolEncodingFor(family).family; }
+    else if (!fallbackFamily) throw new OPFFontError("font-encoding-required", `Font '${family}' is symbol-encoded and no open symbol face is loaded: load the symbol faces (prepareNodeFonts or loadBrowserFontRegistry with scripts: ['${SYMBOL_SCRIPT}'], or scripts: 'auto' with the presentation) or supply '${family}' itself.`, {path:style.path,fontFamily:family,scripts:[SYMBOL_SCRIPT],faces:[...symbolPreviewFaces(family)]});
+  }
   if (!matching.length && aliases.has(family.toLowerCase())) {
     matching = findFamily(aliases.get(family.toLowerCase())); compatibility = "visual"; via = "alias";
   }
@@ -107,19 +118,22 @@ export function pickFace(faces, family, style, {policy = "none", aliases = new M
       }
     }
   }
-  // Equations require an explicit math-aware choice; never fall through to body text.
-  if (!matching.length && /^(cambria math|stix two math|noto sans math)$/i.test(family)) throw new OPFFontError("math-font-required", `Supply '${family}' or an explicit math-font alias.`, {path:style.path});
+  // FF-45: Cambria Math previews with STIX Two Math (the math pack, loaded as a script face: the alias above resolves it
+  // under every policy). Without the pack the policy error below names the pack; the former `math-font-required` failure is gone.
   if (!matching.length && fallbackFamily) { matching=findFamily(fallbackFamily); compatibility="generic"; via="fallback"; }
   if (!matching.length) throw unavailableFontError(family, style, policy);
   const styled = styleFallback ? matching : matching.filter(face=>face.italic===!!style.italic);
-  // Script replacement faces have no italics; use upright glyphs and advances.
-  if (!styled.length && style.italic && matching.length && matching.every(face=>face.scripts)) { if (compatibility!=="generic") compatibility="visual"; }
+  // Script replacement faces have no italics; use upright glyphs and advances. RR-17 (FF-41): so does a visual preview of a
+  // single-style display face (Anton, Bebas Neue: the families Impact and the open font schemes name), reported visual; PowerPoint
+  // synthesizes the slant of such a face too, so the advances agree and the preview no longer refuses the deck. A strict registry
+  // (policy none) still reports font-style-unavailable.
+  if (!styled.length && style.italic && matching.length && (matching.every(face=>face.scripts) || policy==="visual" && matching.every(face=>!face.italic))) { if (compatibility!=="generic") compatibility="visual"; }
   else matching = styled;
   if (!matching.length) throw new OPFFontError("font-style-unavailable", `No ${style.italic ? "italic" : "upright"} face for '${family}'.`, {path:style.path});
   matching.sort((a,b)=>Math.abs(a.weight-targetWeight)-Math.abs(b.weight-targetWeight) || a.weight-b.weight);
   const face = matching[0];
   if ((face.weight!==targetWeight || styleFallback) && compatibility!=="generic") compatibility="visual";
-  return {face, compatibility, rule, styleFallback, via};
+  return {face, compatibility, rule, styleFallback, via, ...(encoding ? {encoding} : {})};
 }
 
 export function createFontRegistry(entries, options = {}) {
@@ -193,26 +207,32 @@ export function createFontRegistry(entries, options = {}) {
     const family = themeKey ? options.themeFonts?.[themeKey] : requested;
     if (!family || family.startsWith("+")) throw new OPFFontError("unresolved-theme-font", `Supply a concrete theme family for '${requested}'.`, {path:style.path});
     validFamily(family);
-    const {face, compatibility, rule, styleFallback, via} = pickFace(faces, family, style, {policy, aliases, fallbackFamily:options.fallbackFamily});
+    const {face, compatibility, rule, styleFallback, via, encoding} = pickFace(faces, family, style, {policy, aliases, fallbackFamily:options.fallbackFamily});
     // FF-31: `substitute` is true whenever the face is not the chosen family itself (policy
     // replacement, alias, script replacement or fallback). Exporters keep writing sourceFamily.
     const substitute = via!=="family", policyRow = substitute ? fontPolicyFor(family) : undefined;
+    // RR-38: a policy row can scale its replacement's size (Arabic Typesetting -> Noto Naskh Arabic: 0.64) so measured and drawn
+    // advances approximate the real font's. It holds only for the face the multiplier was measured on.
+    const sizeAdjust = sizeAdjustFor(policyRow, face.family);
     const measured = rule?.measured && rule.substituteIndex===0 ? rule.measured : undefined;
-    const resolution={requestedFamily:requested,sourceFamily:family,resolvedFamily:face.family,requestedWeight:weight,resolvedWeight:face.weight,italic:face.italic,compatibility,substitute,...(styleFallback?{styleFallback:true}:{}),...(face.fontFace?{fontFace:{...face.fontFace}}:{}),...(style.path?{path:style.path}:{}),...(rule?{source:rule.source,note:rule.note,...(rule.decision?{decision:rule.decision}:{})}:{}),...(measured?{measured:{...measured}}:{}),...(policyRow?{licenseClass:policyRow.licenseClass,availability:[...policyRow.availability]}:{})};
+    const resolution={requestedFamily:requested,sourceFamily:family,resolvedFamily:face.family,requestedWeight:weight,resolvedWeight:face.weight,italic:face.italic,compatibility,substitute,...(styleFallback?{styleFallback:true}:{}),...(face.fontFace?{fontFace:{...face.fontFace}}:{}),...(style.path?{path:style.path}:{}),...(rule?{source:rule.source,note:rule.note,...(rule.decision?{decision:rule.decision}:{})}:{}),...(measured?{measured:{...measured}}:{}),...(policyRow?{licenseClass:policyRow.licenseClass,availability:[...policyRow.availability]}:{}),...(sizeAdjust?{sizeAdjust}:{}),...(encoding?{symbolEncoding:encoding}:{})};
     if (face.family.toLowerCase()!==family.toLowerCase() || face.weight!==weight || face.italic!==!!style.italic) substitutions.set(JSON.stringify([requested,weight,!!style.italic,style.path]),resolution);
     return {face,resolution};
   };
   const resolveFace = style => resolve(style).face;
   const resolveStyle = style => {
-    const face=resolveFace(style),resolved={...style,fontFamily:face.family,fontWeight:face.weight,italic:face.italic};
+    const {face,resolution}=resolve(style),resolved={...style,fontFamily:face.family,fontWeight:face.weight,italic:face.italic};
     // Never carry a stale selection from a previously resolved style.
     delete resolved.fontFace;
+    delete resolved.symbolEncoding;
     if(face.fontFace) resolved.fontFace={...face.fontFace};
+    // FF-45: the planner maps a symbol-encoded family's codes (symbol-fonts.js); the face only lends its glyphs.
+    if(resolution.symbolEncoding) resolved.symbolEncoding=resolution.symbolEncoding;
     return resolved;
   };
   const metrics = (text,size,style,includeOutline=false) => {
     if (typeof text!=='string'||!Number.isFinite(size)||size<=0) throw new OPFFontError('invalid-text-measurement','Text measurement requires a string and a positive finite font size.');
-    const face=resolveFace(style);
+    const {face,resolution}=resolve(style);
     // A BCP-47 `lang` selects the font's OpenType language system, as a browser
     // does for an element's lang (FF-19). Without it, shaping is unchanged.
     const language=openTypeLanguage(style.lang),key=language?`${language}\u0000${text}`:text;
@@ -248,21 +268,27 @@ export function createFontRegistry(entries, options = {}) {
       }
       value={width:run.positions.reduce((total,position)=>total+position.xAdvance,0)/face.font.unitsPerEm,...value};
       if(includeOutline) {
-        const bounds=run.bbox,unit=face.font.unitsPerEm;
-        value.outline=[bounds.minX,bounds.minY,bounds.maxX,bounds.maxY].every(Number.isFinite)
-          ?{x:bounds.minX/unit,y:-bounds.maxY/unit,width:bounds.width/unit,height:bounds.height/unit}:null;
+        const unit=face.font.unitsPerEm;
+        let bounds=null;
+        // FF-45: fontkit reads COLR v0 layers only; a COLRv1 colour face (Noto Color Emoji) has no outlines it can bound (its
+        // glyf outlines are empty), so its ink box is the face's em box over the run: the colour image fills the em square.
+        try { bounds=run.bbox; } catch { bounds=null; }
+        if(bounds&&[bounds.minX,bounds.minY,bounds.maxX,bounds.maxY].every(Number.isFinite)) value.outline={x:bounds.minX/unit,y:-bounds.maxY/unit,width:bounds.width/unit,height:bounds.height/unit};
+        else if(face.font.directory?.tables?.COLR&&value.width>0) { const ascent=face.font.ascent/unit,descent=face.font.descent/unit; value.outline={x:0,y:-ascent,width:value.width,height:ascent-descent}; }
+        else value.outline=null;
       }
       if (text.length<=2048) {
         if (face.cache.size>=512&&!face.cache.has(key)) face.cache.delete(face.cache.keys().next().value);
         face.cache.set(key,value);
       }
     }
-    return value;
+    // RR-38: the replacement is measured at its adjusted size, the one the SVG draws it at.
+    return {value,scale:resolution.sizeAdjust??1};
   };
-  const measure=(text,size,style)=>metrics(text,size,style).width*size;
+  const measure=(text,size,style)=>{const {value,scale}=metrics(text,size,style);return value.width*adjustedFontSize(size,scale===1?undefined:scale);};
   const outlineBounds=(text,size,style)=>{
-    const bounds=metrics(text,size,style,true).outline;
-    return bounds===null?null:{x:bounds.x*size,y:bounds.y*size,width:bounds.width*size,height:bounds.height*size};
+    const {value,scale}=metrics(text,size,style,true),bounds=value.outline,drawn=adjustedFontSize(size,scale===1?undefined:scale);
+    return bounds===null?null:{x:bounds.x*drawn,y:bounds.y*drawn,width:bounds.width*drawn,height:bounds.height*drawn};
   };
   return {
     // resolveFont lets exporters tell a substitute from the chosen family (FF-31).