expo-pretext 0.2.0

package/src/cache.ts

@@ -0,0 +1,59 @@
+// src/cache.ts
+// JS-side width cache to skip native calls when all segments are cached.
+
+const widthCache = new Map<string, Map<string, number>>()
+
+export function getCachedWidth(
+  fontKey: string,
+  segment: string
+): number | undefined {
+  return widthCache.get(fontKey)?.get(segment)
+}
+
+export function setCachedWidth(
+  fontKey: string,
+  segment: string,
+  width: number
+): void {
+  let fontCache = widthCache.get(fontKey)
+  if (!fontCache) {
+    fontCache = new Map()
+    widthCache.set(fontKey, fontCache)
+  }
+  fontCache.set(segment, width)
+}
+
+export function cacheNativeResult(
+  fontKey: string,
+  segments: string[],
+  widths: number[]
+): void {
+  let fontCache = widthCache.get(fontKey)
+  if (!fontCache) {
+    fontCache = new Map()
+    widthCache.set(fontKey, fontCache)
+  }
+  for (let i = 0; i < segments.length; i++) {
+    fontCache.set(segments[i]!, widths[i]!)
+  }
+}
+
+export function tryResolveAllFromCache(
+  fontKey: string,
+  segments: string[]
+): number[] | null {
+  const fontCache = widthCache.get(fontKey)
+  if (!fontCache) return null
+
+  const widths: number[] = new Array(segments.length)
+  for (let i = 0; i < segments.length; i++) {
+    const w = fontCache.get(segments[i]!)
+    if (w === undefined) return null
+    widths[i] = w
+  }
+  return widths
+}
+
+export function clearJSCache(): void {
+  widthCache.clear()
+}

package/src/engine-profile.ts

@@ -0,0 +1,38 @@
+// src/engine-profile.ts
+import { Platform } from 'react-native'
+
+export type EngineProfile = {
+  lineFitEpsilon: number
+  carryCJKAfterClosingQuote: boolean
+  preferPrefixWidthsForBreakableRuns: boolean
+  preferEarlySoftHyphenBreak: boolean
+}
+
+let cachedProfile: EngineProfile | null = null
+
+export function getEngineProfile(): EngineProfile {
+  if (cachedProfile !== null) return cachedProfile
+
+  cachedProfile = Platform.select({
+    ios: {
+      lineFitEpsilon: 0.01, // restored to default for diagnostic
+      carryCJKAfterClosingQuote: true,
+      preferPrefixWidthsForBreakableRuns: false,
+      preferEarlySoftHyphenBreak: false,
+    },
+    android: {
+      lineFitEpsilon: 0.02,
+      carryCJKAfterClosingQuote: false,
+      preferPrefixWidthsForBreakableRuns: false,
+      preferEarlySoftHyphenBreak: false,
+    },
+    default: {
+      lineFitEpsilon: 0.01,
+      carryCJKAfterClosingQuote: false,
+      preferPrefixWidthsForBreakableRuns: false,
+      preferEarlySoftHyphenBreak: false,
+    },
+  })!
+
+  return cachedProfile
+}

package/src/font-utils.ts

@@ -0,0 +1,50 @@
+// src/font-utils.ts
+import type { TextStyle, FontDescriptor } from './types'
+
+export function textStyleToFontDescriptor(style: TextStyle): FontDescriptor {
+  return {
+    fontFamily: style.fontFamily,
+    fontSize: style.fontSize,
+    fontWeight: style.fontWeight,
+    fontStyle: style.fontStyle,
+  }
+}
+
+export function getFontKey(style: TextStyle): string {
+  const weight = style.fontWeight ?? '400'
+  const fStyle = style.fontStyle ?? 'normal'
+  return `${style.fontFamily}_${style.fontSize}_${weight}_${fStyle}`
+}
+
+export function getLineHeight(style: TextStyle): number {
+  return style.lineHeight ?? style.fontSize * 1.2
+}
+
+const SYSTEM_FONTS = [
+  'System', 'system', 'sans-serif', 'serif', 'monospace',
+  // iOS built-in fonts
+  'Helvetica', 'Helvetica Neue', 'Arial', 'Courier', 'Courier New',
+  'Georgia', 'Times New Roman', 'Trebuchet MS', 'Verdana',
+  'American Typewriter', 'Avenir', 'Avenir Next', 'Baskerville',
+  'Didot', 'Futura', 'Gill Sans', 'Menlo', 'Optima', 'Palatino',
+]
+
+export function isFontLoaded(fontFamily: string): boolean {
+  // System fonts are always available
+  if (SYSTEM_FONTS.includes(fontFamily)) return true
+  try {
+    const Font = require('expo-font')
+    return Font.isLoaded(fontFamily)
+  } catch {
+    return true
+  }
+}
+
+export function warnIfFontNotLoaded(style: TextStyle): void {
+  if (__DEV__ && !isFontLoaded(style.fontFamily)) {
+    console.warn(
+      `[expo-pretext] Font "${style.fontFamily}" not loaded. ` +
+      `Heights will be inaccurate. Use Font.loadAsync() first.`
+    )
+  }
+}