rapier-markdown-kit 1.1.102 → 1.1.104

package/dist/agent/vendor/pretext/measurement.js

@@ -1,189 +1,1118 @@
-/*! Pretext 0.0.9 | MIT | Copyright (c) 2026 Pretext contributors */
-import { getSharedGraphemeSegmenter } from './analysis.js';
-let measureContext = null;
-const segmentMetricCaches = new Map();
-let cachedEngineProfile = null;
-const MAX_PREFIX_FIT_GRAPHEMES = 96;
-const emojiPresentationRe = /\p{Emoji_Presentation}/u;
-const maybeEmojiRe = /[\p{Emoji_Presentation}\p{Extended_Pictographic}\p{Regional_Indicator}\uFE0F\u20E3]/u;
-const emojiCorrectionCache = new Map();
-export function getMeasureContext() {
-    if (measureContext !== null) return measureContext;
-    if (typeof OffscreenCanvas !== 'undefined') {
-        measureContext = new OffscreenCanvas(1, 1).getContext('2d');
-        return measureContext;
+/*! Pretext Unreleased (bac1774c0) | MIT; BSD/Unicode/ICU notices in LICENSE | Copyright (c) 2026 Pretext contributors */
+import { findGraphemeEnds,                    } from './graphemes.js'
+import { canWebKitLineStartWith, DEFAULT_IGNORABLE, getBlinkDefaultLocale, hasProperty, MARK } from './line-breaks.js'
+import { webkitGenericFamilies, webkitGenericFamilyNames, webkitScriptLanguages, webkitScriptSubtags } from './generated/webkit-generic-families.js'
+                                                               
+                                                          
+
+// What preparation knows of a segment in a font. Each is created with all its fields,
+// so their reads see one shape.
+                              
+               
+                                                                                           
+                                                                                       
+                                                                                               
+ 
+
+// A text segment's kerning with a U+0020 beside it, in the Chromium profile (getSpaceKerning).
+                            
+                                        
+                                          
+ 
+
+// Where a segment breaks under overflow-wrap: break-word in one fit mode (getSegmentFit),
+// replaced whole when another mode is asked for.
+                          
+                        
+                                                                     
+                                                                                            
+                                                                                         
+                                  
+                                                                                      
+                                                                                 
+                                                         
+                                          
+                  
+                         
+                           
+                                         
+          
+ 
+
+                             
+                                                                                   
+                                                                                        
+                                                                                       
+                                                             
+                                                  
+                                                                                          
+                                                                                        
+                                                                                          
+                                                                                          
+                                                                                              
+                                                                                             
+                                                                                            
+                                                                                            
+                                                                                           
+                                                                                    
+                                                                          
+                                                                                               
+                                                                                            
+                                                                                                 
+                                             
+                                                                                      
+                                                                                         
+                                                                                     
+                              
+                                                                                                      
+                                                                                                     
+                                                                       
+                        
+                                                                                            
+                                                                                           
+                                                                                
+                                                                                     
+                                                                                               
+                                                                                               
+             
+                                                                                             
+                                                                                        
+                                                                                          
+                                                                                    
+                      
+                                                   
+                                                                                              
+                                                                                           
+                                                                                        
+                                                                                           
+                                                                                          
+                                                                                            
+                                                                                        
+                                
+                           
+                                                                                              
+                                                                                           
+                                                                                              
+                                                                                              
+                                                                                               
+                                                                                             
+                                                                    
+                                                                                         
+                                                           
+                                
+                                                                              
+                                                                                
+                                                                     
+                                        
+                                                                                       
+                                                                                               
+                                                                                               
+                                                                                                 
+                                                                                      
+                                 
+                                                                           
+                                                 
+                                         
+                                                                                     
+                                                                                        
+                                                                                
+                                                    
+                                  
+                                                                                          
+                                                                                         
+                                                                                
+                                                                                           
+                                                                                        
+                                                                                           
+                                                                                    
+                                                                                      
+                                                                                            
+                                                                                        
+                                            
+                                                                         
+                                                                                        
+                                                                                       
+                                                                              
+                                                                    
+                                             
+                                                                                 
+                                                                                     
+                                                                                
+                                                                                  
+                                      
+                                                                              
+                                                                                   
+                                                                                  
+                                                                               
+                                                                              
+                                                                                
+                                                                               
+                                                                                
+                                            
+                                                                                
+                                                                                 
+                                                                                 
+                                                                                  
+                                                                                  
+                                                                                  
+                                                                            
+                                                                                      
+                                                                                     
+                                                                                   
+                                                                               
+                                                                                   
+                                                                                   
+                                                                                
+                                                                             
+                                                             
+                                                                                  
+                                                                         
+                                                                            
+                                                                                  
+                                                               
+                                                                       
+                                                                 
+                                                                              
+                                                                                  
+                                                                              
+                                                                                
+                                                                                
+                                                                                 
+                                
+                                                                                          
+                                                                                            
+                                                                               
+                                                                                          
+                                                                                
+                                                                                        
+                                                                      
+                              
+                                                                                         
+                                                                                             
+                                                                                     
+                          
+                                                                                           
+                                                                                  
+                                                                                           
+                                                                                      
+                                                                                         
+                                                                                           
+                                                                          
+                                
+                                                                                           
+                                                                                       
+                                                                          
+                         
+                                                                                    
+                                                                                     
+                                                                                       
+                                                                                  
+                   
+                                                                                   
+                                                                                        
+                                                                                           
+                                                                                           
+                                 
+                                                                                        
+                                                                                        
+                                                                                      
+                                                                                          
+                    
+                                    
+                                                                                           
+                                                                                      
+                                
+                     
+                                                                                            
+                                                                                    
+                                    
+                                
+                                                                                    
+                                                                                           
+                                                                                           
+                                                                                          
+                                                                                       
+                                                     
+                                    
+                                                                                    
+                                                                                 
+                                                                                       
+                                                                                     
+                                                                                      
+                                                                                    
+                                                                                      
+                                                                                          
+                                         
+                                                                                          
+                                                                                              
+                                                                                              
+                                                                            
+                                 
+                                                                                                
+                                                                                                
+                                                                                                       
+                                                                                       
+                                                                                           
+                                                                                                
+                                                                                           
+                                                                                                                             
+                                                                                                
+                                                                                             
+                                                                                               
+                                                                                                 
+                                                                                                
+                                                                                                  
+                                                                                                
+                       
+                                                        
+                                                                                         
+                                                                                           
+                                                                                             
+                                                                                            
+                                                                                                
+                                                                                                  
+                                                                                               
+                                                                                                  
+                                                                                               
+                                                                                              
+                                                                                                
+                                                                                          
+                                                                                               
+                                                                                                  
+                                                                                                   
+                                                                                               
+                                                                                                 
+                                                                                                 
+                                                                                       
+                                                                                                
+                                                                                                 
+                                                                                                  
+                                                                                             
+                                                                                                
+                                                                                              
+                                                                                                  
+                                                                                             
+                                                                                              
+                                                                                                  
+                                                                                                
+                                                                              
+                                               
+                                                                                             
+                                                                                  
+                                                                                             
+                                                                                               
+                                                                                              
+                                                                                  
+                                                                                             
+                                         
+                                
+                                                                                                
+                                                                                              
+                                                                                             
+                                                                                        
+                                                                                           
+                                                                                                 
+                                                                                                
+                                                                                        
+                                                                                             
+                                                                                              
+                                    
+                                  
+                                                                                                  
+                                                                                              
+                                                                                   
+                                                                                        
+                                                                                               
+                                                                                             
+                                                                                             
+                                                                                             
+                                                                                            
+                                                                                             
+                                 
+                                  
+                                                                                       
+                                                                                                 
+                                                                                      
+                                                                                   
+                                             
+ 
+
+                                                                                                       
+
+// The measurement context and what preparation measured through it. Canvas resolves
+// fonts under the context's language, the page's unless the context has a `lang` to
+// give it preparation's. Chrome keeps a resolved font while its font string is
+// unchanged, so the context, and every width measured through it, belong to the
+// language it was created under: all of it is replaced when that language changes.
+                     
+                         
+                                                                                                                     
+                                                                                                 
+                                                                                 
+                                                                                                   
+                                                                                             
+                                                                                        
+                                                                                       
+                                                                                      
+                             
+                                     
+                                                                                          
+                                           
+                                                 
+ 
+let measureState                      = null
+// What preparation keeps per font. It all goes together, when the caches clear or the
+// language changes.
+                               
+                                                                                         
+                                                                                         
+                                               
+                    
+                                                                                                           
+                                      
+                                                                                 
+                                                   
+                                                    
+                                                                                                
+                                                                                                 
+                                                                                                 
+                                                                
+                                                      
+                                                                                 
+                                                                                                   
+                                                                                          
+                                                                                                                
+                                                                                            
+                                                                                                                   
+ 
+let cachedEngineProfile                       = null
+
+// Prefix fits, which preparation picks by engine, width and letter spacing
+// (measureAnalysis in src/prepare.ts), measure every growing prefix of a
+// segment. That suits word-sized runs, but a giant segment would prepare in time
+// that grows with the square of its length. Past this size, the cheaper
+// pair-context model keeps preparation linear.
+const MAX_PREFIX_FIT_GRAPHEMES = 96
+
+// The Canvas letterSpacing a context measures letter-spaced text under: not 0, so the
+// engine shapes the text as its page does under letter spacing, and too small to add any
+// width, so one measurement serves every spacing and preparation adds the spacing itself.
+// Blink adds spacing in units of 1/65536 px (ShapeResultSpacing::SetSpacing,
+// shape_result_spacing.cc:14-33) and Gecko's Canvas in whole app units, 1/60 px
+// (CanvasRenderingContext2D.cpp:4771-4774), and both read 0 here: 16px Roboto `difficult`
+// measures 54.2031px in Chrome 154 and 54.2px in Firefox 156, their pages' widths with
+// `font-variant-ligatures: none` (2026-09-30).
+const LETTER_SPACED_SHAPING = '0.000001px'
+
+// Graphemes the emoji font may draw a glyph in, which Canvas widths then tell
+// (countEmojiGlyphs): those holding an emoji-presentation character or a pictograph,
+// or an emoji character followed by U+FE0F, such as a keycap base like `1`. U+FE0F
+// after a letter or a space changes nothing.
+const emojiGraphemeRe = /\p{Emoji_Presentation}|\p{Extended_Pictographic}|\p{Emoji}\uFE0F/u
+const maybeEmojiRe = /[\p{Emoji_Presentation}\p{Extended_Pictographic}\p{Regional_Indicator}\uFE0F\u20E3]/u
+
+const genericKeywords = ['serif', 'sans-serif', 'cursive', 'fantasy', 'monospace']
+// A quoted family name, or an unquoted generic keyword with what precedes it.
+const familyListItemRe = /("[^"]*"|'[^']*')|(^|,)(\s*)(serif|sans-serif|cursive|fantasy|monospace)(?=\s*(?:,|$))/gi
+// A font string's size, with its line height, after which its family list starts.
+const fontSizeRe = /\dpx(?:\s*\/\s*\S+)?\s+/
+// One family of a family list, with the white space around it.
+const familyRe = /(?:"[^"]*"|'[^']*'|[^,])+/g
+
+// The families WebKit's page gives the generic keywords under a language, or null
+// where they resolve as in Canvas. The page asks Core Text wherever WebKit's script
+// for the language isn't Common: localeToScriptCode tries the language, then its last
+// subtag as a script, then the language less that subtag (LocaleToScriptMapping.cpp:
+// 360-377). A plain Han language becomes the first preferred language starting with
+// zh-, else zh-hans (FontDescription.cpp:74-113); a page can't read those languages,
+// so Pretext takes zh-hans. Core Text's answers are OS data, generated with macOS's
+// and iOS's families (scripts/generate-webkit-generic-families.ts): where they differ,
+// the context takes macOS's if it has it. Listing both instead would send characters
+// macOS's family lacks to iOS's, where the page falls back by language.
+function getWebKitGenericFamilies(language        , ctx                                                              )                  {
+  let tag = language.toLowerCase().replaceAll('_', '-')
+  let han                 = null
+  for (let at = tag; han === null;) {
+    if (webkitScriptLanguages.includes(` ${at} `)) han = at === 'zh'
+    else {
+      const cut = at.lastIndexOf('-')
+      if (cut < 0 || at.endsWith('-zyyy')) return null
+      if (webkitScriptSubtags.includes(` ${at.slice(cut + 1)} `)) han = at.endsWith('-hani')
+      at = at.slice(0, cut)
     }
-    if (typeof document !== 'undefined') {
-        measureContext = document.createElement('canvas').getContext('2d');
-        return measureContext;
+  }
+  if (han) tag = 'zh-hans'
+  let row = webkitGenericFamilies[tag]
+  while (row === undefined) {
+    tag = tag.slice(0, Math.max(0, tag.lastIndexOf('-')))
+    row = webkitGenericFamilies[tag]
+  }
+  const families           = []
+  for (let i = 0; i < row.length; i++) {
+    // Keywords with the same entry share its family, and the context is asked once.
+    const first = row.indexOf(row[i] )
+    if (first < i) {
+      families.push(families[first] )
+      continue
     }
-    throw new Error('Text measurement requires OffscreenCanvas or a DOM canvas context.');
+    const name = webkitGenericFamilyNames[row[i] ] 
+    const pair = name.indexOf('|')
+    const family = pair < 0 ? name : hasFamily(ctx, name.slice(0, pair)) ? name.slice(0, pair) : name.slice(pair + 1)
+    families.push(family === '' ? '' : `"${family}"`)
+  }
+  return families
 }
-export function getSegmentMetricCache(font) {
-    let cache = segmentMetricCaches.get(font);
-    if (!cache) {
-        cache = new Map();
-        segmentMetricCaches.set(font, cache);
-    }
-    return cache;
-}
-export function getSegmentMetrics(seg, cache) {
-    let metrics = cache.get(seg);
-    if (metrics === undefined) {
-        const ctx = getMeasureContext();
-        metrics = {
-            width: ctx.measureText(seg).width
-        };
-        cache.set(seg, metrics);
-    }
-    return metrics;
-}
-export function getEngineProfile() {
-    if (cachedEngineProfile !== null) return cachedEngineProfile;
-    if (typeof navigator === 'undefined') {
-        cachedEngineProfile = {
-            geckoAsciiLineBreaks: false,
-            lineFitEpsilon: 0.005,
-            carryCJKAfterClosingQuote: false,
-            breakKeepAllAfterPunctuation: true,
-            preferPrefixWidthsForBreakableRuns: false
-        };
-        return cachedEngineProfile;
-    }
-    const ua = navigator.userAgent;
-    const vendor = navigator.vendor;
-    const isSafari = vendor === 'Apple Computer, Inc.' && ua.includes('Safari/') && !ua.includes('Chrome/') && !ua.includes('Chromium/') && !ua.includes('CriOS/') && !ua.includes('FxiOS/') && !ua.includes('EdgiOS/');
-    const isChromium = ua.includes('Chrome/') || ua.includes('Chromium/') || ua.includes('CriOS/') || ua.includes('Edg/');
-    const isGecko = ua.includes('Firefox/') && !ua.includes('FxiOS/');
-    cachedEngineProfile = {
-        geckoAsciiLineBreaks: isGecko,
-        lineFitEpsilon: isSafari ? 1 / 64 : 0.005,
-        carryCJKAfterClosingQuote: isChromium,
-        breakKeepAllAfterPunctuation: !isSafari,
-        preferPrefixWidthsForBreakableRuns: isSafari
-    };
-    return cachedEngineProfile;
-}
-export function parseFontSize(font) {
-    const m = font.match(/(?:^|\D)(\d+(?:\.\d+)?)\s*px/);
-    return m ? parseFloat(m[1]) : 16;
-}
-function isEmojiGrapheme(g) {
-    return emojiPresentationRe.test(g) || g.includes('\uFE0F');
-}
-export function textMayContainEmoji(text) {
-    return maybeEmojiRe.test(text);
-}
-function getEmojiCorrection(font) {
-    let correction = emojiCorrectionCache.get(font);
-    if (correction !== undefined) return correction;
-    const fontSize = parseFontSize(font);
-    const ctx = getMeasureContext();
-    ctx.font = font;
-    const canvasW = ctx.measureText('\u{1F600}').width;
-    correction = 0;
-    if (canvasW > fontSize + 0.5 && typeof document !== 'undefined' && document.body !== null) {
-        const span = document.createElement('span');
-        span.style.font = font;
-        span.style.display = 'inline-block';
-        span.style.visibility = 'hidden';
-        span.style.position = 'absolute';
-        span.textContent = '\u{1F600}';
-        document.body.appendChild(span);
-        const domW = span.getBoundingClientRect().width;
-        document.body.removeChild(span);
-        if (canvasW - domW > 0.5) {
-            correction = canvasW - domW;
-        }
-    }
-    emojiCorrectionCache.set(font, correction);
-    return correction;
-}
-function countEmojiGraphemes(text) {
-    let count = 0;
-    const graphemeSegmenter = getSharedGraphemeSegmenter();
-    for (const g of graphemeSegmenter.segment(text)){
-        if (isEmojiGrapheme(g.segment)) count++;
-    }
-    return count;
+
+// Text each of macOS's families in the table draws some of: Latin, Hangul, Han,
+// Devanagari, Khmer, Kannada, Lao, Malayalam, Myanmar, Oriya, Sinhala and Tibetan.
+const familyProbeText = 'Hamburg 한中 नम សួ ನಮ ສະ നമ မင ନମ ආය བཀ'
+
+// Whether the context has a family: the probe text measures differently with it first.
+function hasFamily(ctx                                                              , family        )          {
+  for (const fallback of ['monospace', 'serif']) {
+    ctx.font = `16px ${fallback}`
+    const width = ctx.measureText(familyProbeText).width
+    ctx.font = `16px "${family}", ${fallback}`
+    if (ctx.measureText(familyProbeText).width !== width) return true
+  }
+  return false
 }
-function getEmojiCount(seg, metrics) {
-    if (metrics.emojiCount === undefined) {
-        metrics.emojiCount = countEmojiGraphemes(seg);
+
+// The Canvas font that measures what the page draws: each unquoted generic keyword
+// in the family list, after the size, becomes the page's families for it.
+function getCanvasFont(font        , families                   )         {
+  const size = fontSizeRe.exec(font)
+  if (size === null) return font
+  const start = size.index + size[0].length
+  return font.slice(0, start) + font.slice(start).replace(familyListItemRe, (item        , quoted                    , separator        , space        , keyword        ) => {
+    const named = quoted === undefined ? families[genericKeywords.indexOf(keyword.toLowerCase())]  : ''
+    return named === '' ? item : separator + space + named
+  })
+}
+
+// The string a chosen soft hyphen paints in the font where the engine takes it from the
+// primary font (hyphenFromPrimaryFont): U+2010 where that font has a glyph for it, else `-`.
+// Where both measure the same in the font, either does. Else Canvas tells which family draws
+// a character from two lists: the engines draw each character with the first listed font
+// that has its glyph (WebKit's glyphDataForVariant, FontCascadeFonts.cpp:426-439), so a family
+// draws it where `family, monospace` and `family, serif` measure it alike and the two generic
+// families alone don't. The primary font is the first listed family's that gives a font,
+// whether or not it has a glyph for a space (WebKit's primaryFont, FontCascadeFonts.h:225-254;
+// Blink's DeterminePrimarySimpleFontDataCore, font_fallback_list.cc:88-143). Canvas can't tell
+// a family that gives no font from one that lacks the character, so the premise is that the
+// primary font draws a space, and it is taken as the first family's that does. `-` where the
+// generic families measure alike, which tells nothing, or the font string has no size in px.
+// What the premise gets wrong (ENGINE_FOLLOWUPS.md, Line edges): a first family whose font
+// has no space, an icon font, is skipped where the engines take it; a family split into faces
+// by unicode-range is asked whole, where the engines ask only the face that holds the space;
+// and where no listed family gives a font the answer is `-`, where the engines ask their
+// last-resort font.
+export function getHyphenText(measurement                 )         {
+  if (measurement.hyphenText !== null) return measurement.hyphenText
+  const font = measurement.canvasFont
+  const size = fontSizeRe.exec(font)
+  let hyphenText = '-'
+  if (size !== null && getSegmentMetrics('\u2010', measurement).width !== getSegmentMetrics('-', measurement).width) {
+    const context = getContext(measurement)
+    const start = size.index + size[0].length
+    const prefix = font.slice(0, start)
+    const families = font.slice(start).match(familyRe) ?? []
+    const monospace = prefix + 'monospace'
+    const serif = prefix + 'serif'
+    if (measureIn(context, monospace, ' ') !== measureIn(context, serif, ' ') && measureIn(context, monospace, '\u2010') !== measureIn(context, serif, '\u2010')) {
+      for (let i = 0; i < families.length; i++) {
+        const beforeMonospace = `${prefix}${families[i]}, monospace`
+        const beforeSerif = `${prefix}${families[i]}, serif`
+        if (measureIn(context, beforeMonospace, ' ') !== measureIn(context, beforeSerif, ' ')) continue
+        if (measureIn(context, beforeMonospace, '\u2010') === measureIn(context, beforeSerif, '\u2010')) hyphenText = '\u2010'
+        break
+      }
     }
-    return metrics.emojiCount;
+    context.font = font
+  }
+  measurement.hyphenText = hyphenText
+  return hyphenText
 }
-export function getCorrectedSegmentWidth(seg, metrics, emojiCorrection) {
-    if (emojiCorrection === 0) return metrics.width;
-    return metrics.width - getEmojiCount(seg, metrics) * emojiCorrection;
+
+function measureIn(context                                                              , font        , text        )         {
+  context.font = font
+  return context.measureText(text).width
 }
-export function getSegmentBreakableFitAdvances(seg, metrics, cache, emojiCorrection, mode) {
-    if (metrics.breakableFitAdvances !== undefined && metrics.breakableFitMode === mode) {
-        return metrics.breakableFitAdvances;
-    }
-    metrics.breakableFitMode = mode;
-    const graphemeSegmenter = getSharedGraphemeSegmenter();
-    const graphemes = [];
-    for (const gs of graphemeSegmenter.segment(seg)){
-        graphemes.push(gs.segment);
+
+// The language setLocale() gave, which preparation reads in place of the page's,
+// or undefined.
+let localeLanguage                    
+
+export function setLocaleLanguage(locale                    )       {
+  localeLanguage = locale
+}
+
+// The language one preparation breaks and measures under, read once: setLocale()'s, or
+// else the page's, or null without a document. The Chromium profile lays out a page
+// without one under Blink's default locale (laysOutUnderDefaultLocale).
+export function getPreparationLanguage(profile               )                {
+  let language = localeLanguage ?? null
+  if (localeLanguage === undefined && typeof document !== 'undefined') {
+    const lang = (document.documentElement                                  )?.lang
+    if (typeof lang === 'string') language = lang
+  }
+  return language === '' && profile.laysOutUnderDefaultLocale ? getBlinkDefaultLocale() : language
+}
+
+// The most app units a Gecko length holds (nscoord_MAX, nsCoord.h:28).
+const MAX_APP_UNITS = (1 << 30) - 1
+
+// A text's letter spacing in CSS px as the engine lays it out, 0 by default. CSS and
+// Canvas ignore a non-finite one, which Pretext refuses rather than guess at. Gecko's
+// whole app units are the float32 times 60, rounded half away from zero and clamped
+// (DefaultLengthToAppUnits, ServoStyleConstsInlines.h:584-595), and a spacing that
+// rounds to none keeps the text's ligatures (nsLayoutUtils.cpp:6896-6904).
+export function readLetterSpacing(letterSpacing                    , profile               )         {
+  const value = letterSpacing ?? 0
+  if (!Number.isFinite(value)) throw new RangeError(`letterSpacing must be a finite number of CSS px, not ${value}`)
+  if (!profile.letterSpacingInAppUnits) return value
+  const units = Math.fround(Math.fround(value) * 60)
+  return Math.min(Math.round(Math.abs(units)), MAX_APP_UNITS) * Math.sign(units) / 60
+}
+
+// A zero per segment, where per-segment widths start, pushed in a loop: Array.from over
+// `{ length }` reads every index off the object and calls its map function for each.
+export function zeros(count        )           {
+  const out           = []
+  for (let i = 0; i < count; i++) out.push(0)
+  return out
+}
+
+// A text's width as Canvas spaces it under a letter spacing, or null where the context
+// can't take the spacing. Under none, that is the text's width in the font, which the
+// font's segment cache asks once. Under a spacing it is asked each time, borrowing the
+// font's context for the synchronous call, never enters a segment cache, and
+// letterSpacing is restored even when assignment or measurement fails.
+export function measureWithLetterSpacing(text        , letterSpacing        , emojiCorrection        , measurement                 )                {
+  if (!measurement.state.takesLetterSpacing) return null
+  if (letterSpacing === 0) return getTextWidth(text, measurement, emojiCorrection)
+  // Counted before the spacing is set: the count measures stretches into the font's segment cache.
+  const corrected = emojiCorrection === 0 ? 0 : countEmojiGlyphs(text, measurement) * emojiCorrection
+  const context = getContext(measurement)
+  const previous = context.letterSpacing
+  try {
+    context.letterSpacing = `${letterSpacing}px`
+    if (Number.parseFloat(context.letterSpacing) !== letterSpacing) return null
+    const width = context.measureText(text).width - corrected
+    return Number.isFinite(width) ? width : null
+  } finally {
+    context.letterSpacing = previous
+  }
+}
+
+// The lookup internalizes seg, and a string V8 hashes for the first time there gets a one-byte
+// copy where its units fit, so Canvas is handed a Latin-1 segment one-byte, which Chrome measures
+// as Latin (RESEARCH.md, Keeping Work Bounded, String Storage). A segment cut from a longer text
+// is a new string, so the lookup is its first hash. A text that is one segment is the caller's
+// own string, since a slice of a whole string is that string, and so is a rich item that is one
+// segment (prepareRichInline() in src/rich-inline.ts): a two-byte one that something hashed
+// before without internalizing it, as a RegExp made from it does, stays two-byte.
+export function getSegmentMetrics(seg        , measurement                 )                 {
+  return measurement.metrics.get(seg) ?? addMetrics(measurement.metrics, seg, seg, measurement)
+}
+
+// Metrics of seg measured together with one following U+0020.
+export function getFollowingSpaceMetrics(seg        , measurement                 )                 {
+  return measurement.followingSpaceMetrics.get(seg) ?? addMetrics(measurement.followingSpaceMetrics, seg, seg + ' ', measurement)
+}
+
+function addMetrics(cache                             , seg        , text        , measurement                 )                 {
+  const metrics                 = { width: getContext(measurement).measureText(text).width, emojiCount: -1, fit: null, spaceKerning: null }
+  cache.set(seg, metrics)
+  return metrics
+}
+
+// The kerning of every segment that takes none.
+export const noSpaceKerning               = { after: 0, before: 0 }
+
+// Whether a character takes no kerning with a space, and Canvas isn't asked.
+function takesNoSpaceKerning(code        )          {
+  // A combining mark or half of a surrogate pair is part of a longer cluster.
+  return hasProperty(code, MARK) || (code & 0xf800) === 0xd800 ||
+    // Canvas shapes each ideograph and kana as a word of its own, so it shows no kerning beside
+    // one (NextWordEndIndex, plain_text_node.cc:92-153, over kIsCjkIdeographOrSymbolRanges,
+    // character_property_data.h:40-80, of which these are the letters).
+    (code >= 0x3041 && code <= 0x3096) || (code >= 0x30a1 && code <= 0x30fa) ||
+    (code >= 0x3400 && code <= 0x9fff) || (code >= 0xf900 && code <= 0xfaff) ||
+    // Premise: no font kerns a Hangul syllable with the space (RESEARCH.md, Kerning At Line Edges).
+    (code >= 0xac00 && code <= 0xd7a3)
+}
+
+// What is kept of the font's kerning with the space glyph, or null for a font that has none:
+// one in which U+2028 before, between and after the printable ASCII characters is as wide with
+// kerning off. `fontKerning = 'none'` turns the `kern` feature off
+// (FontFeatureRange::FromFontDescription, font_features.cc:39-47), and with it HarfBuzz's
+// kerning from GPOS, `kern` and `kerx` (hb-ot-shape.cc:127-131, hb-ot-kern-table.hh:67). Asked
+// once per font. Premise: a font that kerns no printable ASCII character with the space kerns
+// nothing with it (RESEARCH.md, Kerning At Line Edges, has the fonts that do).
+export function getFontSpaceKerning(measurement                 )                             {
+  if (measurement.spaceKerning === undefined) {
+    const context = getContext(measurement)
+    let probe = '\u2028'
+    for (let code = 0x21; code <= 0x7e; code++) probe += String.fromCharCode(code) + '\u2028'
+    const kerned = context.measureText(probe).width
+    context.fontKerning = 'none'
+    const unkerned = context.measureText(probe).width
+    context.fontKerning = 'auto'
+    // Where U+2028 alone doesn't measure as the space, it doesn't stand for it.
+    measurement.spaceKerning = kerned !== unkerned && context.measureText('\u2028').width === getSegmentMetrics(' ', measurement).width ? new Map() : null
+  }
+  return measurement.spaceKerning
+}
+
+// A character's kerning with a space glyph after it, or before it: the two in one string, with
+// U+2028 for the space, less each alone. Asked of Canvas once per font and side.
+function getCharacterSpaceKerning(code        , spaceFirst         , measurement                 , kernings                     )         {
+  const key = code << 1 | (spaceFirst ? 1 : 0)
+  let kerning = kernings.get(key)
+  if (kerning === undefined) {
+    kerning = 0
+    if (!takesNoSpaceKerning(code)) {
+      const character = String.fromCharCode(code)
+      const pairWidth = getContext(measurement).measureText(spaceFirst ? '\u2028' + character : character + '\u2028').width
+      kerning = pairWidth - getSegmentMetrics(character, measurement).width - getSegmentMetrics(' ', measurement).width
+      // Blink keeps a run's width as a float32 (shape_result.cc:1539-1576), so up to the pair's
+      // width / 2^22 is rounding, not kerning (RESEARCH.md, Kerning At Line Edges).
+      if (Math.abs(kerning) <= pairWidth / 0x400000) kerning = 0
     }
-    if (graphemes.length <= 1) {
-        metrics.breakableFitAdvances = null;
-        return metrics.breakableFitAdvances;
+    kernings.set(key, kerning)
+  }
+  return kerning
+}
+
+// The kerning Blink's layout gives a text segment's edges with a U+0020 beside them
+// (EngineProfile.kernsSpacesInScriptRun), read from Canvas with U+2028 for the space: Blink
+// draws U+2028 with the space glyph (HarfBuzzGetGlyph, harfbuzz_face.cc:103-113) and its Canvas
+// doesn't cut there. Premise: the segment's last and first character stand for the word, past
+// default ignorables, which HarfBuzz's lookups pass over, and a first character with a combining
+// mark after it takes none (RESEARCH.md, Kerning At Line Edges, has the gaps).
+export function getSpaceKerning(seg        , metrics                , measurement                 , kernings                     )               {
+  let first = 0
+  let last = seg.length - 1
+  while (first < last && hasProperty(seg.charCodeAt(first), DEFAULT_IGNORABLE)) first++
+  while (last > first && hasProperty(seg.charCodeAt(last), DEFAULT_IGNORABLE)) last--
+  const before = first < last && hasProperty(seg.charCodeAt(first + 1), MARK) ? 0 : getCharacterSpaceKerning(seg.charCodeAt(first), true, measurement, kernings)
+  const after = getCharacterSpaceKerning(seg.charCodeAt(last), false, measurement, kernings)
+  return metrics.spaceKerning = after === 0 && before === 0 ? noSpaceKerning : { after, before }
+}
+
+// The font's space, which holds no emoji. Every text asks for it, so it is kept beside the font's
+// Map, which still answers the first one.
+export function getSpaceWidth(measurement                 )         {
+  return measurement.spaceWidth ??= getSegmentMetrics(' ', measurement).width
+}
+
+// A text's width in the font, less the emoji correction.
+export function getTextWidth(text        , measurement                 , emojiCorrection        )         {
+  return getCorrectedSegmentWidth(text, getSegmentMetrics(text, measurement), measurement, emojiCorrection)
+}
+
+                                                       
+
+// Engine profiles describe the layout engine, not the browser brand. Chrome,
+// Firefox and Edge on iOS lay out with WebKit whatever their brand token (CriOS/,
+// FxiOS/, EdgiOS/) or desktop-mode user agent, and an app's web view may name no
+// browser at all. The user agent decides alone, so a page and its workers agree.
+// navigator.vendor is not read: workers don't have it, and jsdom reports WebKit's
+// beside Chromium's frozen AppleWebKit/537.36 token. WebKit froze 605.1.15, so
+// 537.36 names Blink only beside Chrome/ or Chromium/, which Samsung's TV web
+// views omit, and any other AppleWebKit/ version names WebKit.
+export function getLayoutEngine(userAgent        )                      {
+  if (userAgent.includes('Firefox/')) return 'gecko'
+  if (userAgent.includes('AppleWebKit/537.36')) {
+    return userAgent.includes('Chrome/') || userAgent.includes('Chromium/') ? 'blink' : null
+  }
+  return userAgent.includes('AppleWebKit/') ? 'webkit' : null
+}
+
+// Apart from buildEngineProfile(), so that what the line walkers call for every line stays a read
+// of the cached profile, however much the profile holds. V8 inlines a function only while its
+// bytecode takes at most 460 bytes (max_inlined_bytecode_size), minified or not. With the builder
+// inside, this took 454 bytes with 23 fields and 463 with a 24th, which Chrome 154's V8 no longer
+// inlined into the line counter and the simple stepper, and its plain line APIs ran
+// 11-18% slower. Apart, it takes 21 (Node 23, V8 12.9). Check with node --print-bytecode and
+// --trace-turbo-inlining (RESEARCH.md, JavaScript Engines).
+export function getEngineProfile()                {
+  return cachedEngineProfile ??= buildEngineProfile()
+}
+
+function buildEngineProfile()                {
+  const ua = typeof navigator === 'undefined' ? '' : navigator.userAgent
+  // Engines Pretext doesn't recognize take Blink's profile (RESEARCH.md, Decisions Log,
+  // 2026-09-26).
+  const engine = getLayoutEngine(ua) ?? 'blink'
+  // Fresh-entry observations are verified only for desktop Blink and Gecko.
+  const isDesktop = /Windows NT|Macintosh|X11/.test(ua) && !/Android|Mobile|iPhone|iPad|iPod/.test(ua)
+
+  return {
+    entryFitBasis: isDesktop && engine === 'blink' ? 'fresh' : isDesktop && engine === 'gecko' ? 'original' : 'disabled',
+    lineBreakScan: engine,
+    graphemeTable: engine === 'webkit' ? 'apple/char' : engine === 'gecko' ? 'gecko/char' : 'chromium/char',
+    lineFitEpsilon: engine === 'webkit' ? 1 / 64 : 0.005,
+    cutWordFit: engine === 'blink' ? 'reshaped-lines' : 'segment-prefixes',
+    prefixFitMinWidth: engine === 'webkit' ? 0 : 80,
+    cutWordKeepsLigatures: engine === 'gecko',
+    measureTextWithFollowingSpace: engine === 'webkit',
+    kernsSpacesInScriptRun: engine === 'blink',
+    letterSpaceDiscretionaryHyphen: engine !== 'blink',
+    letterSpacingInAppUnits: engine === 'gecko',
+    canvasLetterSpacingDropsLigatures: engine !== 'webkit',
+    unspacedCursive: engine === 'blink' ? 'run' : engine === 'gecko' ? 'cluster' : 'none',
+    shapesMarksAcrossSoftHyphen: engine === 'blink',
+    unfitHyphenRetreat: engine === 'blink' ? 'reduced-width' : engine === 'gecko' ? 'full-width' : 'full-width-or-first',
+    hyphenFromPrimaryFont: engine !== 'gecko',
+    letterSpaceTabStops: engine !== 'webkit',
+    letterSpaceTabs: engine === 'webkit',
+    tabMinimumCharacter: engine === 'gecko' ? '0' : ' ',
+    tabsInAppUnits: engine === 'gecko',
+    hangTabs: engine !== 'gecko',
+    zeroWidthGlueTakesLine: engine !== 'gecko',
+    keepsLineStartPunctuation: engine === 'webkit',
+    hidesControlCharacters: engine === 'gecko',
+    hanKerning: engine === 'blink',
+    hangsIdeographicSpace: engine !== 'webkit',
+    laysOutUnderDefaultLocale: engine === 'blink',
+    namesGenericFamiliesByLanguage: engine === 'webkit',
+    hardBreakItemRetreat: engine === 'blink' ? 'item' : engine === 'webkit' ? 'fit' : 'last-grapheme',
+    paddedOpeningFit: engine === 'blink' ? 'start' : engine === 'webkit' ? 'placed' : 'both',
+    emptyAtomicAlwaysFits: engine === 'gecko',
+    hangsSpacesPerTextFrame: engine === 'gecko',
+    testsHyphenBeforeAtomic: engine !== 'webkit',
+    transformsSegmentBreaksAcrossItems: engine === 'blink',
+  }
+}
+
+export function parseFontSize(font        )         {
+  // A failed size can restart at the next digit run, not at every digit in it.
+  const m = font.match(/(?:^|\D)(\d+(?:\.\d+)?)\s*px/)
+  return m ? parseFloat(m[1] ) : 16
+}
+
+export function textMayContainEmoji(text        )          {
+  return maybeEmojiRe.test(text)
+}
+
+export function getEmojiCorrection(font        , measurement                 )         {
+  let correction = measurement.emojiCorrection
+  if (correction !== null) return correction
+
+  const fontSize = parseFontSize(font)
+  const canvasW = measurement.emojiWidth = getContext(measurement).measureText('\u{1F600}').width
+  correction = 0
+  // document.body is null until the parser reaches <body>, which lib.dom's type leaves out.
+  if (
+    canvasW > fontSize + 0.5 &&
+    typeof document !== 'undefined' &&
+    (document.body                      ) !== null
+  ) {
+    const span = document.createElement('span')
+    span.style.font = font
+    span.style.display = 'inline-block'
+    span.style.visibility = 'hidden'
+    span.style.position = 'absolute'
+    span.textContent = '\u{1F600}'
+    document.body.appendChild(span)
+    const domW = span.getBoundingClientRect().width
+    document.body.removeChild(span)
+    if (canvasW - domW > 0.5) {
+      correction = canvasW - domW
     }
-    if (mode === 'sum-graphemes') {
-        const advances = [];
-        for (const grapheme of graphemes){
-            const graphemeMetrics = getSegmentMetrics(grapheme, cache);
-            advances.push(getCorrectedSegmentWidth(grapheme, graphemeMetrics, emojiCorrection));
-        }
-        metrics.breakableFitAdvances = advances;
-        return metrics.breakableFitAdvances;
+  }
+  measurement.emojiCorrection = correction
+  return correction
+}
+
+// Canvas reports a width as a 32-bit float (CanvasRenderingContext2D.cpp:5277 in Firefox,
+// text_metrics.cc:179 in Chrome), so a few equal advances measure that many times one
+// only within that float's rounding, 2^-24 of the width each time one is rounded: 2e-6 px
+// over three emoji of a bold font in Firefox 156. Sixteen roundings are allowed for, a
+// window far finer than the steps a font's advances come in (RESEARCH.md, Content
+// Language And Fonts).
+const CANVAS_WIDTH_ROUNDING = 2 ** -20
+
+// What a word's width may differ by from its graphemes' widths added up and still be their sum:
+// 2^-17 of the width, which covers the float32 roundings of a word of 96 graphemes, each 2^-24
+// of the width at most, and is a tenth of the least kerning of a 2,048-unit font in a 100px word
+// at 16px (RESEARCH.md, Break Opportunities From Engine Data).
+const WORD_SUM_ROUNDING = 2 ** -17
+
+// How many glyphs of the emoji font draw a text: the emoji font gives every glyph one
+// advance, the probe's, so text it draws measures a whole number of them, and none
+// where it measures anything else.
+function getEmojiGlyphs(text        , measurement                 )         {
+  const width = getSegmentMetrics(text, measurement).width
+  const glyphs = Math.round(width / measurement.emojiWidth)
+  return Math.abs(width - glyphs * measurement.emojiWidth) <= width * CANVAS_WIDTH_ROUNDING ? glyphs : 0
+}
+
+// The characters the emoji font shapes together inside a grapheme: emoji and pictographs,
+// the characters that join or modify them (ZWJ, skin tones, tags, U+20E3) and the
+// variation selectors. Every emoji character has one of the two properties. A grapheme
+// of emojiGraphemeRe holds one.
+const emojiStretchRe = /[\p{Extended_Pictographic}\p{Emoji_Component}\uFE0E]+/gu
+
+// The glyphs of the emoji font in a text: what the correction is subtracted for, once
+// each. Font fallback decides which font draws an emoji character, and Canvas shows what
+// it decided, at one cached Canvas call per distinct stretch of a font. For a character
+// with no selector, the named font's own glyph comes before the emoji font's
+// (CheckCandidate, gfxTextRun.cpp:3350-3359; FontFallbackIterator::Next,
+// font_fallback_iterator.cc:166-178), and U+FE0E asks for a text font
+// (gfxTextRun.cpp:3270-3273; SymbolsIterator::Consume, symbols_iterator.cc:67-71). So a
+// stretch with a glyph of another font measures as the page draws it: Menlo's own
+// U+26A1, Inter's U+2B1C, Hiragino Sans's U+26AA, or U+231A before U+FE0E. A pictograph
+// whose presentation is text by default takes the correction with no U+FE0F where only
+// the emoji font has it, as U+1F336 in Arial. Two or more glyphs are a sequence the
+// emoji font has no glyph for, drawn as its parts.
+//
+// Each stretch of emoji characters is asked whole, and apart from the rest of its
+// grapheme, since each font shapes its own characters together: Firefox matches a font
+// character by character (gfxFontGroup::FindFontForChar, gfxTextRun.cpp:3178-3194), and
+// Chrome ends a run where emoji give way to text before it shapes
+// (RunSegmenter::Consume, run_segmenter.cc:44-73, over SymbolsIterator::Consume,
+// symbols_iterator.cc:34-79). So an emoji, a sequence or a flag before a combining mark
+// of another script is still one glyph. A stretch that two fonts draw takes no
+// correction, as a text font's pictograph joined by a ZWJ to an emoji in Firefox, and a
+// stretch asked apart can be another font's than inside its grapheme, as a skin tone
+// after a letter in Chrome.
+//
+// Those and the other gaps are in ENGINE_FOLLOWUPS.md, Emoji correction: another font's
+// glyph exactly as wide as an emoji takes the correction, as does Firefox's box for a
+// missing glyph at 13px, and an emoji font whose advances vary would take none.
+function countEmojiGlyphs(text        , measurement                 )         {
+  const ends = new Int32Array(text.length)
+  const graphemeCount = findGraphemeEnds(getEngineProfile().graphemeTable, text, 0, text.length, ends)
+  let count = 0
+  for (let i = 0, start = 0; i < graphemeCount; start = ends[i++] ) {
+    const grapheme = text.slice(start, ends[i])
+    if (!emojiGraphemeRe.test(grapheme)) continue
+    const stretches = grapheme.match(emojiStretchRe) 
+    for (let s = 0; s < stretches.length; s++) count += getEmojiGlyphs(stretches[s] , measurement)
+  }
+  return count
+}
+
+export function getCorrectedSegmentWidth(seg        , metrics                , measurement                 , emojiCorrection        )         {
+  if (emojiCorrection === 0) return metrics.width
+  if (metrics.emojiCount < 0) metrics.emojiCount = countEmojiGlyphs(seg, measurement)
+  return metrics.width - metrics.emojiCount * emojiCorrection
+}
+
+export function getSegmentFit(
+  seg        ,
+  metrics                ,
+  measurement                 ,
+  emojiCorrection        ,
+  mode                  ,
+  // When metrics measured seg together with one following U+0020, the width of
+  // that space alone. The last grapheme then keeps its kerning with the space.
+  followingSpaceWidth                = null,
+  // Whether to find the segment's WebKit line-start prohibitions.
+  withLineStartProhibitions = false,
+)             {
+  if (metrics.fit !== null && metrics.fit.mode === mode) return metrics.fit
+  const profile = getEngineProfile()
+  const ends = new Int32Array(seg.length)
+  const count = findGraphemeEnds(profile.graphemeTable, seg, 0, seg.length, ends)
+  if (count <= 1) return metrics.fit = { mode, advances: null, lineStartExtras: null, lineStartProhibitions: null, entryGeometry: null }
+  let prohibitions                    = null
+  if (withLineStartProhibitions) {
+    for (let i = 1; i < count; i++) if (!canWebKitLineStartWith(seg.charCodeAt(ends[i - 1] ))) (prohibitions ??= new Uint8Array(count))[i] = 1
+  }
+  let advances          
+  let lineStartExtras                  = null
+  if (mode === 'reshaped-lines') {
+    // Blink shapes a line of a cut word again where the cut falls between letters shaped
+    // together (EngineProfile's cutWordFit). Premise: a line holds the letters whose width,
+    // shaped alone, fits, so the letters after the line's first take the advances they have
+    // in the word, and the first its width alone. Premise, taken for speed: a word as wide as
+    // its graphemes measured alone has nothing shaped across them, and they are its advances,
+    // with nothing more measured. Else each grapheme is measured after the one before it,
+    // which every word of the font shares, and where those don't add up to the word either,
+    // as in a ligature of three letters or the joined forms of Arabic, the word's prefixes
+    // are, up to MAX_PREFIX_FIT_GRAPHEMES (RESEARCH.md, Break Opportunities From Engine Data).
+    const width = getCorrectedSegmentWidth(seg, metrics, measurement, emojiCorrection) - (followingSpaceWidth ?? 0)
+    const alone = measureFitAdvances(seg, ends, count, 'sum-graphemes', metrics, measurement, emojiCorrection, followingSpaceWidth)
+    advances = alone
+    if (!addUpTo(alone, width)) {
+      advances = measureFitAdvances(seg, ends, count, 'pair-context', metrics, measurement, emojiCorrection, followingSpaceWidth)
+      if (count <= MAX_PREFIX_FIT_GRAPHEMES && !addUpTo(advances, width)) {
+        advances = measureFitAdvances(seg, ends, count, 'segment-prefixes', metrics, measurement, emojiCorrection, followingSpaceWidth)
+      }
+      lineStartExtras = [0]
+      for (let i = 1; i < count; i++) lineStartExtras.push(alone[i]  - advances[i] )
     }
-    if (mode === 'pair-context' || graphemes.length > MAX_PREFIX_FIT_GRAPHEMES) {
-        const advances = [];
-        let previousGrapheme = null;
-        let previousWidth = 0;
-        for (const grapheme of graphemes){
-            const graphemeMetrics = getSegmentMetrics(grapheme, cache);
-            const currentWidth = getCorrectedSegmentWidth(grapheme, graphemeMetrics, emojiCorrection);
-            if (previousGrapheme === null) {
-                advances.push(currentWidth);
-            } else {
-                const pair = previousGrapheme + grapheme;
-                const pairMetrics = getSegmentMetrics(pair, cache);
-                advances.push(getCorrectedSegmentWidth(pair, pairMetrics, emojiCorrection) - previousWidth);
-            }
-            previousGrapheme = grapheme;
-            previousWidth = currentWidth;
-        }
-        metrics.breakableFitAdvances = advances;
-        return metrics.breakableFitAdvances;
+  } else {
+    // Past MAX_PREFIX_FIT_GRAPHEMES, prefixes give way to pairs.
+    const prefixes = mode === 'segment-prefixes' && count <= MAX_PREFIX_FIT_GRAPHEMES
+    advances = measureFitAdvances(seg, ends, count, mode === 'segment-prefixes' && !prefixes ? 'pair-context' : mode, metrics, measurement, emojiCorrection, followingSpaceWidth)
+    if (prefixes && profile.cutWordKeepsLigatures) countLigaturesOnFirstLetter(seg, ends, advances, measurement, emojiCorrection)
+  }
+  return metrics.fit = { mode, advances, lineStartExtras, lineStartProhibitions: prohibitions, entryGeometry: null }
+}
+
+// Moves the advance of each later letter of a ligature onto the ligature's first letter, in a
+// segment's prefix advances, as Gecko counts it where it cuts a word (EngineProfile's
+// cutWordKeepsLigatures). A prefix that ends inside a ligature has the first letter's glyph
+// alone, so the next letter's advance after that prefix isn't its advance alone, in app units,
+// 1/60 px, which Gecko's Canvas reports whole, and there Canvas is asked whether the two are a
+// ligature (isLigature). Where a line is narrower than the ligature it starts with, Gecko cuts
+// inside it and gives each of its letters an equal share (ComputeLigatureData,
+// gfxTextRun.cpp:238-322); here the first letter keeps the whole advance (ENGINE_FOLLOWUPS.md,
+// Emergency breaks inside a word).
+function countLigaturesOnFirstLetter(seg        , ends            , advances          , measurement                 , emojiCorrection        )       {
+  // Text measured under letter spacing has no optional ligature, and a context that can't
+  // turn them off can't be asked.
+  if (!measurement.state.shapesLetterSpaced || measurement.letterSpacing !== '0px') return
+  // The grapheme the ligature that holds the grapheme before this one starts with, or that grapheme.
+  let first = 0
+  for (let i = 1; i < advances.length; i++) {
+    const start = ends[i - 1] 
+    const alone = getTextWidth(seg.slice(start, ends[i]), measurement, emojiCorrection)
+    if (Math.round((advances[i]  - alone) * 60) !== 0 && isLigature(seg.slice(i === 1 ? 0 : ends[i - 2] , ends[i]), measurement)) {
+      advances[first] = advances[first]  + advances[i] 
+      advances[i] = 0
+    } else {
+      first = i
     }
-    const advances = [];
-    let prefix = '';
-    let prefixWidth = 0;
-    for (const grapheme of graphemes){
-        prefix += grapheme;
-        const prefixMetrics = getSegmentMetrics(prefix, cache);
-        const nextPrefixWidth = getCorrectedSegmentWidth(prefix, prefixMetrics, emojiCorrection);
-        advances.push(nextPrefixWidth - prefixWidth);
-        prefixWidth = nextPrefixWidth;
+  }
+}
+
+// Whether two neighbouring graphemes are one of the font's optional ligatures: the pair measures
+// otherwise without them, as the context shapes text under a letter spacing
+// (LETTER_SPACED_SHAPING). Asked of Canvas once per pair and font. A kerned pair, letters that
+// join, a mark on its base and a ligature the font requires measure the same, and aren't one.
+function isLigature(pair        , measurement                 )          {
+  let ligature = measurement.ligaturePairs.get(pair)
+  if (ligature === undefined) {
+    const context = getContext(measurement)
+    const width = getSegmentMetrics(pair, measurement).width
+    context.letterSpacing = LETTER_SPACED_SHAPING
+    ligature = context.measureText(pair).width !== width
+    context.letterSpacing = '0px'
+    measurement.ligaturePairs.set(pair, ligature)
+  }
+  return ligature
+}
+
+// Whether a segment's advances add up to its width, within the rounding of Canvas's widths.
+function addUpTo(advances                   , width        )          {
+  let sum = 0
+  for (let i = 0; i < advances.length; i++) sum += advances[i] 
+  return Math.abs(sum - width) <= width * WORD_SUM_ROUNDING
+}
+
+// A segment's advances per grapheme: the differences of its prefixes' widths, or each
+// grapheme's width alone or, as a pair, after the one before it.
+function measureFitAdvances(
+  seg        ,
+  ends            ,
+  count        ,
+  from                                                       ,
+  metrics                ,
+  measurement                 ,
+  emojiCorrection        ,
+  followingSpaceWidth               ,
+)           {
+  const prefixes = from === 'segment-prefixes'
+  const pairs = from === 'pair-context'
+  const advances           = []
+  let previousStart = 0
+  let previousWidth = 0
+  for (let i = 0, start = 0; i < count; start = ends[i++] ) {
+    const end = ends[i] 
+    if (prefixes) {
+      // The whole segment is the last prefix; with a following space it was
+      // measured together with that space.
+      const width = followingSpaceWidth !== null && i === count - 1
+        ? getCorrectedSegmentWidth(seg, metrics, measurement, emojiCorrection) - followingSpaceWidth
+        : getTextWidth(seg.slice(0, end), measurement, emojiCorrection)
+      advances.push(width - previousWidth)
+      previousWidth = width
+      continue
     }
-    metrics.breakableFitAdvances = advances;
-    return metrics.breakableFitAdvances;
-}
-export function getFontMeasurementState(font, needsEmojiCorrection) {
-    const ctx = getMeasureContext();
-    ctx.font = font;
-    const cache = getSegmentMetricCache(font);
-    const emojiCorrection = needsEmojiCorrection ? getEmojiCorrection(font) : 0;
-    return {
-        cache,
-        emojiCorrection
-    };
-}
-export function clearMeasurementCaches() {
-    segmentMetricCaches.clear();
-    emojiCorrectionCache.clear();
+    const width = getTextWidth(seg.slice(start, end), measurement, emojiCorrection)
+    advances.push(pairs && i > 0 ? getTextWidth(seg.slice(previousStart, end), measurement, emojiCorrection) - previousWidth : width)
+    previousStart = start
+    previousWidth = width
+  }
+  // Advances that do not end in the whole segment's width take the kerning as a
+  // difference, which needs the segment measured alone too.
+  if (followingSpaceWidth !== null && !prefixes) {
+    advances[count - 1] = advances[count - 1]  + metrics.width - getSegmentMetrics(seg, measurement).width - followingSpaceWidth
+  }
+  return advances
+}
+
+// What preparation measures a font's text through. Text under letter spacing has a
+// measurement of its own where the context shapes it as the page does: its widths,
+// prefixes and line-edge facts all come from that shaping. The context isn't touched
+// here: text that is all in the font's caches measures nothing (getContext).
+export function getFontMeasurement(font        , language               , letterSpaced         )                  {
+  // Preparation starts here, with the language it resolved. After that language
+  // changes, start again with a new context and empty caches; clearing the caches
+  // alone would re-measure with fonts resolved under the old language.
+  if (measureState === null || measureState.language !== language) measureState = createMeasureState(language)
+  const state = measureState
+  const shaped = letterSpaced && state.shapesLetterSpaced
+  const fonts = shaped ? state.letterSpacedFonts : state.fonts
+  let measurement = fonts.get(font)
+  if (measurement === undefined) {
+    const canvasFont = state.genericFamilies === null ? font : getCanvasFont(font, state.genericFamilies)
+    measurement = { state, canvasFont, letterSpacing: shaped ? LETTER_SPACED_SHAPING : '0px', metrics: new Map(), followingSpaceMetrics: new Map(), spaceKerning: undefined, emojiCorrection: null, emojiWidth: 0, hyphenText: null, spaceWidth: null, hanKerning: undefined, ligaturePairs: new Map() }
+    fonts.set(font, measurement)
+  }
+  // The first measurement after a lookup sets the font again, the same string too: Firefox's
+  // context takes a face added to document.fonts only when its font is assigned.
+  state.font = ''
+  return measurement
+}
+
+// The font's context, set to the font and its shaping. Every measurement in a font takes
+// its context from here as it measures, so none reads a width under another font's
+// setting, whatever was looked up or prepared in between, and text that is all cached,
+// which measures nothing, sets nothing. What changes the context after that puts it back
+// before it returns (getHyphenText, measureWithLetterSpacing, getFontSpaceKerning,
+// isLigature).
+export function getContext(measurement                 )                                                               {
+  const state = measurement.state
+  if (state.font !== measurement.canvasFont) state.context.font = state.font = measurement.canvasFont
+  if (state.letterSpacing !== measurement.letterSpacing) state.context.letterSpacing = state.letterSpacing = measurement.letterSpacing
+  return state.context
+}
+
+function createMeasureState(language               )               {
+  let context                                                              
+  if (typeof OffscreenCanvas !== 'undefined') {
+    context = new OffscreenCanvas(1, 1).getContext('2d') 
+  } else if (typeof document !== 'undefined') {
+    context = document.createElement('canvas').getContext('2d') 
+  } else {
+    throw new Error('Text measurement requires OffscreenCanvas or a DOM canvas context.')
+  }
+  // A context's `lang` follows the page's, and preparation's can be setLocale()'s or
+  // Blink's default locale instead.
+  if (language !== null && 'lang' in context) context.lang = language
+  const profile = getEngineProfile()
+  const takesLetterSpacing = typeof context.letterSpacing === 'string'
+  return {
+    language,
+    context,
+    font: '',
+    letterSpacing: '0px',
+    genericFamilies: language !== null && profile.namesGenericFamiliesByLanguage ? getWebKitGenericFamilies(language, context) : null,
+    takesLetterSpacing,
+    shapesLetterSpaced: takesLetterSpacing && profile.canvasLetterSpacingDropsLigatures,
+    fonts: new Map(),
+    letterSpacedFonts: new Map(),
+  }
+}
+
+export function clearMeasurementCaches()       {
+  measureState?.fonts.clear()
+  measureState?.letterSpacedFonts.clear()
 }