@yahoo/uds-mobile 2.24.0-beta.4 → 2.24.0-beta.6

package/dist/components/Text.js

@@ -1,4 +1,5 @@
 /*! © 2026 Yahoo, Inc. UDS Mobile v0.0.0-development */
+import { DEFAULT_DYNAMIC_TYPE_RAMPS } from "../fontScaling/constants.js";
 import { useMaxFontSizeMultiplier } from "../fontScaling/useMaxFontSizeMultiplier.js";
 import { memo, useMemo } from "react";
 import { Text as Text$1 } from "react-native";
@@ -53,6 +54,8 @@ const Text = memo(function Text({ color = "primary", variant = "body1", fontFami
 	const resolvedFontSize = fontSize ?? resolvedVariant;
 	const resolvedLineHeight = lineHeight === "none" ? void 0 : lineHeight ?? (hasCJKContent(children) ? void 0 : resolvedVariant);
 	const resolvedLetterSpacing = letterSpacing ?? resolvedVariant;
+	const baseVariant = resolvedVariant?.split("/")[0];
+	const defaultDynamicTypeRamp = baseVariant ? DEFAULT_DYNAMIC_TYPE_RAMPS[baseVariant] : void 0;
 	const resolvedMaxFontSizeMultiplier = useMaxFontSizeMultiplier(resolvedVariant, maxFontSizeMultiplier);
 	styles.useVariants({
 		color: resolvedColor,
@@ -125,6 +128,7 @@ const Text = memo(function Text({ color = "primary", variant = "body1", fontFami
 			styles.foundation
 		]),
 		maxFontSizeMultiplier: resolvedMaxFontSizeMultiplier,
+		dynamicTypeRamp: defaultDynamicTypeRamp,
 		...props,
 		children
 	});

package/dist/components/Text.js.map

@@ -1 +1 @@
-{"version":3,"file":"Text.js","names":["RNText"],"sources":["../../src/components/Text.tsx"],"sourcesContent":["import type { ReactNode, Ref } from 'react';\nimport { memo, useMemo } from 'react';\nimport type { StyleProp, TextProps as RNTextProps, TextStyle } from 'react-native';\nimport { Text as RNText } from 'react-native';\n\nimport type { StyleProps } from '../../generated/styles';\nimport { styles } from '../../generated/styles';\nimport { useMaxFontSizeMultiplier } from '../fontScaling/useMaxFontSizeMultiplier';\n\n// TextVariant is a subset of fontFamily that represents typography variants\ntype TextVariant = Exclude<\n  NonNullable<StyleProps['fontFamily']>,\n  'sans' | 'sans-alt' | 'serif' | 'serif-alt' | 'mono' | 'icons'\n>;\ntype TextVariantProp = TextVariant | 'inherit';\n\n// React Native text decoration line values\n// See: https://reactnative.dev/docs/text-style-props#textdecorationline\ntype TextDecorationLine = 'none' | 'underline' | 'line-through' | 'underline line-through';\n\n// Chinese/Japanese/Korean scripts: Hangul Jamo, CJK radicals + punctuation,\n// Kana, Han ideographs, Hangul syllables, compatibility ideographs, and\n// full/half-width forms.\nconst CJK_RE =\n  /[\\u1100-\\u11FF\\u2E80-\\u303F\\u3040-\\u30FF\\u31C0-\\u9FFF\\uAC00-\\uD7AF\\uF900-\\uFAFF\\uFF00-\\uFFEF]/;\n\n/**\n * Detects CJK characters in string children (including strings inside a\n * children array, e.g. from `{city}` interpolation). Nested elements are not\n * inspected - a nested <Text> runs its own detection.\n */\nfunction hasCJKContent(children: ReactNode): boolean {\n  if (typeof children === 'string') {\n    return CJK_RE.test(children);\n  }\n  if (Array.isArray(children)) {\n    return children.some((child) => typeof child === 'string' && CJK_RE.test(child));\n  }\n  return false;\n}\n\ninterface TextProps extends RNTextProps {\n  /** Ref to the underlying Text element */\n  ref?: Ref<RNText>;\n  /** Text color from the theme palette */\n  color?: StyleProps['color'] | 'inherit';\n  /** Typography variant - sets fontSize, lineHeight, letterSpacing, and fontFamily together */\n  variant?: TextVariantProp;\n  /**\n   * Caps how far this text grows with the OS text-size setting. Every text\n   * variant is capped at 2x or below by default, with the largest display and\n   * title variants tapering further (see DEFAULT_MAX_FONT_SIZE_MULTIPLIERS).\n   * Set null to remove the cap (maps to React Native's 0, which also overrides\n   * an inherited cap); inherit-variant text inherits its parent's cap.\n   * Override app-wide via UDSFontScalingProvider.\n   */\n  maxFontSizeMultiplier?: number | null;\n  /** Override the fontFamily independently */\n  fontFamily?: StyleProps['fontFamily'];\n  /** Override the fontSize independently */\n  fontSize?: StyleProps['fontSize'];\n  /** Set font weight (not derived from variant) */\n  fontWeight?: StyleProps['fontWeight'];\n  /** Override the lineHeight independently. Use 'none' to remove the variant lineHeight and let the font's natural line height apply */\n  lineHeight?: StyleProps['lineHeight'] | 'none';\n  /** Override the letterSpacing independently */\n  letterSpacing?: StyleProps['letterSpacing'];\n  /** Text alignment (left, center, right) */\n  textAlign?: StyleProps['textAlign'];\n  /** Set text transform (not derived from variant) */\n  textTransform?: StyleProps['textTransform'];\n  /** Text decoration (underline, line-through, etc.) */\n  textDecorationLine?: TextDecorationLine;\n  // Background\n  backgroundColor?: StyleProps['backgroundColor'];\n  // Border\n  borderRadius?: StyleProps['borderRadius'];\n  borderTopStartRadius?: StyleProps['borderTopStartRadius'];\n  borderTopEndRadius?: StyleProps['borderTopEndRadius'];\n  borderBottomStartRadius?: StyleProps['borderBottomStartRadius'];\n  borderBottomEndRadius?: StyleProps['borderBottomEndRadius'];\n  borderColor?: StyleProps['borderColor'];\n  borderStartColor?: StyleProps['borderStartColor'];\n  borderEndColor?: StyleProps['borderEndColor'];\n  borderTopColor?: StyleProps['borderTopColor'];\n  borderBottomColor?: StyleProps['borderBottomColor'];\n  borderWidth?: StyleProps['borderWidth'];\n  borderVerticalWidth?: StyleProps['borderVerticalWidth'];\n  borderHorizontalWidth?: StyleProps['borderHorizontalWidth'];\n  borderStartWidth?: StyleProps['borderStartWidth'];\n  borderEndWidth?: StyleProps['borderEndWidth'];\n  borderTopWidth?: StyleProps['borderTopWidth'];\n  borderBottomWidth?: StyleProps['borderBottomWidth'];\n  // Spacing\n  spacing?: StyleProps['spacing'];\n  spacingHorizontal?: StyleProps['spacingHorizontal'];\n  spacingVertical?: StyleProps['spacingVertical'];\n  spacingBottom?: StyleProps['spacingBottom'];\n  spacingEnd?: StyleProps['spacingEnd'];\n  spacingStart?: StyleProps['spacingStart'];\n  spacingTop?: StyleProps['spacingTop'];\n  // Offset\n  offset?: StyleProps['offset'];\n  offsetVertical?: StyleProps['offsetVertical'];\n  offsetHorizontal?: StyleProps['offsetHorizontal'];\n  offsetBottom?: StyleProps['offsetBottom'];\n  offsetEnd?: StyleProps['offsetEnd'];\n  offsetStart?: StyleProps['offsetStart'];\n  offsetTop?: StyleProps['offsetTop'];\n  // Flex\n  flexShrink?: StyleProps['flexShrink'];\n  // Vertical Alignment\n  verticalAlign?: TextStyle['textAlignVertical'];\n  // Size\n  height?: number | `${number}%`;\n  width?: number | `${number}%`;\n  minHeight?: number | `${number}%`;\n  maxHeight?: number | `${number}%`;\n  minWidth?: number | `${number}%`;\n  maxWidth?: number | `${number}%`;\n  // Dangerously set props\n  dangerouslySetColor?: string;\n}\n\n/**\n * **📝 A text component with UDS styling**\n *\n * @description\n * A styled text component that supports UDS typography variants and colors.\n *\n * @category Display\n * @platform mobile\n *\n * @example\n * ```tsx\n * import { Text } from '@yahoo/uds-mobile/Text';\n *\n * <Text variant=\"body1\" color=\"primary\">Hello, World!</Text>\n * <Text variant=\"display1\" fontWeight=\"bold\">Heading</Text>\n * <Text variant=\"label1\" color=\"secondary\">Caption text</Text>\n * ```\n *\n * @usage\n * - Use variant prop to set typography (display1, body1, label1, etc.)\n * - Use color prop to set text color from the palette\n * - Use fontWeight to override the variant's default weight\n *\n * @accessibility\n * - Text is readable by screen readers by default\n * - Use appropriate variant sizes for readability\n * - Ensure sufficient color contrast with background\n *\n * @see {@link Link} for interactive text links\n */\nconst Text = memo(function Text({\n  // Text-specific\n  color = 'primary',\n  variant = 'body1',\n  fontFamily,\n  fontSize,\n  fontWeight,\n  lineHeight,\n  letterSpacing,\n  maxFontSizeMultiplier,\n  textAlign,\n  textTransform,\n  textDecorationLine,\n  style,\n  // Background\n  backgroundColor,\n  // Border\n  borderRadius,\n  borderTopStartRadius,\n  borderTopEndRadius,\n  borderBottomStartRadius,\n  borderBottomEndRadius,\n  borderColor,\n  borderStartColor,\n  borderEndColor,\n  borderTopColor,\n  borderBottomColor,\n  borderWidth,\n  borderVerticalWidth,\n  borderHorizontalWidth,\n  borderStartWidth,\n  borderEndWidth,\n  borderTopWidth,\n  borderBottomWidth,\n  // Spacing\n  spacing,\n  spacingHorizontal,\n  spacingVertical,\n  spacingBottom,\n  spacingEnd,\n  spacingStart,\n  spacingTop,\n  // Offset\n  offset,\n  offsetVertical,\n  offsetHorizontal,\n  offsetBottom,\n  offsetEnd,\n  offsetStart,\n  offsetTop,\n  // Flex\n  flexShrink,\n  // Vertical Alignment\n  verticalAlign,\n  // Size\n  height,\n  minHeight,\n  maxHeight,\n  width,\n  minWidth,\n  maxWidth,\n  // Dangerously set props\n  dangerouslySetColor,\n  ref,\n  children,\n  // Rest\n  ...props\n}: TextProps) {\n  const resolvedColor = color === 'inherit' ? undefined : color;\n  const resolvedVariant = variant === 'inherit' ? undefined : variant;\n  const resolvedFontFamily = fontFamily ?? resolvedVariant;\n  const resolvedFontSize = fontSize ?? resolvedVariant;\n  // React Native clips glyphs when lineHeight is smaller than the font's\n  // natural line box. CJK fallback fonts are ~1.4x taller than Latin ones, so\n  // Latin-tuned variant lineHeights clip CJK text - drop the variant lineHeight\n  // for CJK content so the line grows to fit.\n  const resolvedLineHeight =\n    lineHeight === 'none'\n      ? undefined\n      : (lineHeight ?? (hasCJKContent(children) ? undefined : resolvedVariant));\n  const resolvedLetterSpacing = letterSpacing ?? resolvedVariant;\n  // Explicit prop wins, including explicit null (?? would swallow it).\n  const resolvedMaxFontSizeMultiplier = useMaxFontSizeMultiplier(\n    resolvedVariant,\n    maxFontSizeMultiplier,\n  );\n\n  styles.useVariants({\n    // Text styles\n    color: resolvedColor,\n    fontFamily: resolvedFontFamily,\n    fontSize: resolvedFontSize,\n    fontWeight,\n    lineHeight: resolvedLineHeight,\n    letterSpacing: resolvedLetterSpacing,\n    textAlign,\n    textTransform,\n    // Background\n    backgroundColor,\n    // Border\n    borderRadius,\n    borderTopStartRadius,\n    borderTopEndRadius,\n    borderBottomStartRadius,\n    borderBottomEndRadius,\n    borderColor,\n    borderStartColor,\n    borderEndColor,\n    borderTopColor,\n    borderBottomColor,\n    borderWidth,\n    borderVerticalWidth,\n    borderHorizontalWidth,\n    borderStartWidth,\n    borderEndWidth,\n    borderTopWidth,\n    borderBottomWidth,\n    // Spacing\n    spacing,\n    spacingHorizontal,\n    spacingVertical,\n    spacingBottom,\n    spacingEnd,\n    spacingStart,\n    spacingTop,\n    // Offset\n    offset,\n    offsetVertical,\n    offsetHorizontal,\n    offsetBottom,\n    offsetEnd,\n    offsetStart,\n    offsetTop,\n    // Flex\n    flexShrink,\n  });\n\n  // styles.foundation must be in deps - it returns a new reference when variants change.\n  const computedStyle: StyleProp<TextStyle> = useMemo(\n    () => [\n      textDecorationLine ? { textDecorationLine } : undefined,\n      dangerouslySetColor ? { color: dangerouslySetColor } : undefined,\n      verticalAlign ? { textAlignVertical: verticalAlign } : undefined,\n      height ? { height } : undefined,\n      minHeight ? { minHeight } : undefined,\n      maxHeight ? { maxHeight } : undefined,\n      width ? { width } : undefined,\n      minWidth ? { minWidth } : undefined,\n      maxWidth ? { maxWidth } : undefined,\n      styles.foundation,\n      style,\n    ],\n    [\n      textDecorationLine,\n      dangerouslySetColor,\n      verticalAlign,\n      height,\n      minHeight,\n      maxHeight,\n      width,\n      minWidth,\n      maxWidth,\n      style,\n      styles.foundation,\n    ],\n  );\n\n  return (\n    <RNText\n      ref={ref}\n      style={computedStyle}\n      maxFontSizeMultiplier={resolvedMaxFontSizeMultiplier}\n      {...props}\n    >\n      {children}\n    </RNText>\n  );\n});\n\nText.displayName = 'Text';\n\nexport { Text, type TextProps, type TextVariant };\n"],"mappings":";;;;;;;AAuBA,MAAM,SACJ;;;;;;AAOF,SAAS,cAAc,UAA8B;CACnD,IAAI,OAAO,aAAa,UACtB,OAAO,OAAO,KAAK,SAAS;CAE9B,IAAI,MAAM,QAAQ,SAAS,EACzB,OAAO,SAAS,MAAM,UAAU,OAAO,UAAU,YAAY,OAAO,KAAK,MAAM,CAAC;CAElF,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAoHT,MAAM,OAAO,KAAK,SAAS,KAAK,EAE9B,QAAQ,WACR,UAAU,SACV,YACA,UACA,YACA,YACA,eACA,uBACA,WACA,eACA,oBACA,OAEA,iBAEA,cACA,sBACA,oBACA,yBACA,uBACA,aACA,kBACA,gBACA,gBACA,mBACA,aACA,qBACA,uBACA,kBACA,gBACA,gBACA,mBAEA,SACA,mBACA,iBACA,eACA,YACA,cACA,YAEA,QACA,gBACA,kBACA,cACA,WACA,aACA,WAEA,YAEA,eAEA,QACA,WACA,WACA,OACA,UACA,UAEA,qBACA,KACA,UAEA,GAAG,SACS;CACZ,MAAM,gBAAgB,UAAU,YAAY,KAAA,IAAY;CACxD,MAAM,kBAAkB,YAAY,YAAY,KAAA,IAAY;CAC5D,MAAM,qBAAqB,cAAc;CACzC,MAAM,mBAAmB,YAAY;CAKrC,MAAM,qBACJ,eAAe,SACX,KAAA,IACC,eAAe,cAAc,SAAS,GAAG,KAAA,IAAY;CAC5D,MAAM,wBAAwB,iBAAiB;CAE/C,MAAM,gCAAgC,yBACpC,iBACA,sBACD;CAED,OAAO,YAAY;EAEjB,OAAO;EACP,YAAY;EACZ,UAAU;EACV;EACA,YAAY;EACZ,eAAe;EACf;EACA;EAEA;EAEA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EAEA;EACA;EACA;EACA;EACA;EACA;EACA;EAEA;EACA;EACA;EACA;EACA;EACA;EACA;EAEA;EACD,CAAC;CAgCF,OACE,oBAACA,QAAD;EACO;EACL,OAhCwC,cACpC;GACJ,qBAAqB,EAAE,oBAAoB,GAAG,KAAA;GAC9C,sBAAsB,EAAE,OAAO,qBAAqB,GAAG,KAAA;GACvD,gBAAgB,EAAE,mBAAmB,eAAe,GAAG,KAAA;GACvD,SAAS,EAAE,QAAQ,GAAG,KAAA;GACtB,YAAY,EAAE,WAAW,GAAG,KAAA;GAC5B,YAAY,EAAE,WAAW,GAAG,KAAA;GAC5B,QAAQ,EAAE,OAAO,GAAG,KAAA;GACpB,WAAW,EAAE,UAAU,GAAG,KAAA;GAC1B,WAAW,EAAE,UAAU,GAAG,KAAA;GAC1B,OAAO;GACP;GACD,EACD;GACE;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA,OAAO;GACR,CAMqB;EACpB,uBAAuB;EACvB,GAAI;EAEH;EACM,CAAA;EAEX;AAEF,KAAK,cAAc"}
+{"version":3,"file":"Text.js","names":["RNText"],"sources":["../../src/components/Text.tsx"],"sourcesContent":["import type { ReactNode, Ref } from 'react';\nimport { memo, useMemo } from 'react';\nimport type { StyleProp, TextProps as RNTextProps, TextStyle } from 'react-native';\nimport { Text as RNText } from 'react-native';\n\nimport type { StyleProps } from '../../generated/styles';\nimport { styles } from '../../generated/styles';\nimport { DEFAULT_DYNAMIC_TYPE_RAMPS } from '../fontScaling/constants';\nimport { useMaxFontSizeMultiplier } from '../fontScaling/useMaxFontSizeMultiplier';\n\n// TextVariant is a subset of fontFamily that represents typography variants\ntype TextVariant = Exclude<\n  NonNullable<StyleProps['fontFamily']>,\n  'sans' | 'sans-alt' | 'serif' | 'serif-alt' | 'mono' | 'icons'\n>;\ntype TextVariantProp = TextVariant | 'inherit';\n\n// React Native text decoration line values\n// See: https://reactnative.dev/docs/text-style-props#textdecorationline\ntype TextDecorationLine = 'none' | 'underline' | 'line-through' | 'underline line-through';\n\n// Chinese/Japanese/Korean scripts: Hangul Jamo, CJK radicals + punctuation,\n// Kana, Han ideographs, Hangul syllables, compatibility ideographs, and\n// full/half-width forms.\nconst CJK_RE =\n  /[\\u1100-\\u11FF\\u2E80-\\u303F\\u3040-\\u30FF\\u31C0-\\u9FFF\\uAC00-\\uD7AF\\uF900-\\uFAFF\\uFF00-\\uFFEF]/;\n\n/**\n * Detects CJK characters in string children (including strings inside a\n * children array, e.g. from `{city}` interpolation). Nested elements are not\n * inspected - a nested <Text> runs its own detection.\n */\nfunction hasCJKContent(children: ReactNode): boolean {\n  if (typeof children === 'string') {\n    return CJK_RE.test(children);\n  }\n  if (Array.isArray(children)) {\n    return children.some((child) => typeof child === 'string' && CJK_RE.test(child));\n  }\n  return false;\n}\n\ninterface TextProps extends RNTextProps {\n  /** Ref to the underlying Text element */\n  ref?: Ref<RNText>;\n  /** Text color from the theme palette */\n  color?: StyleProps['color'] | 'inherit';\n  /** Typography variant - sets fontSize, lineHeight, letterSpacing, and fontFamily together */\n  variant?: TextVariantProp;\n  /**\n   * Caps how far this text grows with the OS text-size setting. Every text\n   * variant is capped at 2x or below by default, with the largest display and\n   * title variants tapering further (see DEFAULT_MAX_FONT_SIZE_MULTIPLIERS).\n   * Set null to remove the cap (maps to React Native's 0, which also overrides\n   * an inherited cap); inherit-variant text inherits its parent's cap.\n   * Override app-wide via UDSFontScalingProvider.\n   */\n  maxFontSizeMultiplier?: number | null;\n  /** Override the fontFamily independently */\n  fontFamily?: StyleProps['fontFamily'];\n  /** Override the fontSize independently */\n  fontSize?: StyleProps['fontSize'];\n  /** Set font weight (not derived from variant) */\n  fontWeight?: StyleProps['fontWeight'];\n  /** Override the lineHeight independently. Use 'none' to remove the variant lineHeight and let the font's natural line height apply */\n  lineHeight?: StyleProps['lineHeight'] | 'none';\n  /** Override the letterSpacing independently */\n  letterSpacing?: StyleProps['letterSpacing'];\n  /** Text alignment (left, center, right) */\n  textAlign?: StyleProps['textAlign'];\n  /** Set text transform (not derived from variant) */\n  textTransform?: StyleProps['textTransform'];\n  /** Text decoration (underline, line-through, etc.) */\n  textDecorationLine?: TextDecorationLine;\n  // Background\n  backgroundColor?: StyleProps['backgroundColor'];\n  // Border\n  borderRadius?: StyleProps['borderRadius'];\n  borderTopStartRadius?: StyleProps['borderTopStartRadius'];\n  borderTopEndRadius?: StyleProps['borderTopEndRadius'];\n  borderBottomStartRadius?: StyleProps['borderBottomStartRadius'];\n  borderBottomEndRadius?: StyleProps['borderBottomEndRadius'];\n  borderColor?: StyleProps['borderColor'];\n  borderStartColor?: StyleProps['borderStartColor'];\n  borderEndColor?: StyleProps['borderEndColor'];\n  borderTopColor?: StyleProps['borderTopColor'];\n  borderBottomColor?: StyleProps['borderBottomColor'];\n  borderWidth?: StyleProps['borderWidth'];\n  borderVerticalWidth?: StyleProps['borderVerticalWidth'];\n  borderHorizontalWidth?: StyleProps['borderHorizontalWidth'];\n  borderStartWidth?: StyleProps['borderStartWidth'];\n  borderEndWidth?: StyleProps['borderEndWidth'];\n  borderTopWidth?: StyleProps['borderTopWidth'];\n  borderBottomWidth?: StyleProps['borderBottomWidth'];\n  // Spacing\n  spacing?: StyleProps['spacing'];\n  spacingHorizontal?: StyleProps['spacingHorizontal'];\n  spacingVertical?: StyleProps['spacingVertical'];\n  spacingBottom?: StyleProps['spacingBottom'];\n  spacingEnd?: StyleProps['spacingEnd'];\n  spacingStart?: StyleProps['spacingStart'];\n  spacingTop?: StyleProps['spacingTop'];\n  // Offset\n  offset?: StyleProps['offset'];\n  offsetVertical?: StyleProps['offsetVertical'];\n  offsetHorizontal?: StyleProps['offsetHorizontal'];\n  offsetBottom?: StyleProps['offsetBottom'];\n  offsetEnd?: StyleProps['offsetEnd'];\n  offsetStart?: StyleProps['offsetStart'];\n  offsetTop?: StyleProps['offsetTop'];\n  // Flex\n  flexShrink?: StyleProps['flexShrink'];\n  // Vertical Alignment\n  verticalAlign?: TextStyle['textAlignVertical'];\n  // Size\n  height?: number | `${number}%`;\n  width?: number | `${number}%`;\n  minHeight?: number | `${number}%`;\n  maxHeight?: number | `${number}%`;\n  minWidth?: number | `${number}%`;\n  maxWidth?: number | `${number}%`;\n  // Dangerously set props\n  dangerouslySetColor?: string;\n}\n\n/**\n * **📝 A text component with UDS styling**\n *\n * @description\n * A styled text component that supports UDS typography variants and colors.\n *\n * @category Display\n * @platform mobile\n *\n * @example\n * ```tsx\n * import { Text } from '@yahoo/uds-mobile/Text';\n *\n * <Text variant=\"body1\" color=\"primary\">Hello, World!</Text>\n * <Text variant=\"display1\" fontWeight=\"bold\">Heading</Text>\n * <Text variant=\"label1\" color=\"secondary\">Caption text</Text>\n * ```\n *\n * @usage\n * - Use variant prop to set typography (display1, body1, label1, etc.)\n * - Use color prop to set text color from the palette\n * - Use fontWeight to override the variant's default weight\n *\n * @accessibility\n * - Text is readable by screen readers by default\n * - Use appropriate variant sizes for readability\n * - Ensure sufficient color contrast with background\n *\n * @see {@link Link} for interactive text links\n */\nconst Text = memo(function Text({\n  // Text-specific\n  color = 'primary',\n  variant = 'body1',\n  fontFamily,\n  fontSize,\n  fontWeight,\n  lineHeight,\n  letterSpacing,\n  maxFontSizeMultiplier,\n  textAlign,\n  textTransform,\n  textDecorationLine,\n  style,\n  // Background\n  backgroundColor,\n  // Border\n  borderRadius,\n  borderTopStartRadius,\n  borderTopEndRadius,\n  borderBottomStartRadius,\n  borderBottomEndRadius,\n  borderColor,\n  borderStartColor,\n  borderEndColor,\n  borderTopColor,\n  borderBottomColor,\n  borderWidth,\n  borderVerticalWidth,\n  borderHorizontalWidth,\n  borderStartWidth,\n  borderEndWidth,\n  borderTopWidth,\n  borderBottomWidth,\n  // Spacing\n  spacing,\n  spacingHorizontal,\n  spacingVertical,\n  spacingBottom,\n  spacingEnd,\n  spacingStart,\n  spacingTop,\n  // Offset\n  offset,\n  offsetVertical,\n  offsetHorizontal,\n  offsetBottom,\n  offsetEnd,\n  offsetStart,\n  offsetTop,\n  // Flex\n  flexShrink,\n  // Vertical Alignment\n  verticalAlign,\n  // Size\n  height,\n  minHeight,\n  maxHeight,\n  width,\n  minWidth,\n  maxWidth,\n  // Dangerously set props\n  dangerouslySetColor,\n  ref,\n  children,\n  // Rest\n  ...props\n}: TextProps) {\n  const resolvedColor = color === 'inherit' ? undefined : color;\n  const resolvedVariant = variant === 'inherit' ? undefined : variant;\n  const resolvedFontFamily = fontFamily ?? resolvedVariant;\n  const resolvedFontSize = fontSize ?? resolvedVariant;\n  // React Native clips glyphs when lineHeight is smaller than the font's\n  // natural line box. CJK fallback fonts are ~1.4x taller than Latin ones, so\n  // Latin-tuned variant lineHeights clip CJK text - drop the variant lineHeight\n  // for CJK content so the line grows to fit.\n  const resolvedLineHeight =\n    lineHeight === 'none'\n      ? undefined\n      : (lineHeight ?? (hasCJKContent(children) ? undefined : resolvedVariant));\n  const resolvedLetterSpacing = letterSpacing ?? resolvedVariant;\n  const baseVariant = resolvedVariant?.split('/')[0] as TextVariant | undefined;\n  const defaultDynamicTypeRamp = baseVariant ? DEFAULT_DYNAMIC_TYPE_RAMPS[baseVariant] : undefined;\n  // Explicit prop wins, including explicit null (?? would swallow it).\n  const resolvedMaxFontSizeMultiplier = useMaxFontSizeMultiplier(\n    resolvedVariant,\n    maxFontSizeMultiplier,\n  );\n\n  styles.useVariants({\n    // Text styles\n    color: resolvedColor,\n    fontFamily: resolvedFontFamily,\n    fontSize: resolvedFontSize,\n    fontWeight,\n    lineHeight: resolvedLineHeight,\n    letterSpacing: resolvedLetterSpacing,\n    textAlign,\n    textTransform,\n    // Background\n    backgroundColor,\n    // Border\n    borderRadius,\n    borderTopStartRadius,\n    borderTopEndRadius,\n    borderBottomStartRadius,\n    borderBottomEndRadius,\n    borderColor,\n    borderStartColor,\n    borderEndColor,\n    borderTopColor,\n    borderBottomColor,\n    borderWidth,\n    borderVerticalWidth,\n    borderHorizontalWidth,\n    borderStartWidth,\n    borderEndWidth,\n    borderTopWidth,\n    borderBottomWidth,\n    // Spacing\n    spacing,\n    spacingHorizontal,\n    spacingVertical,\n    spacingBottom,\n    spacingEnd,\n    spacingStart,\n    spacingTop,\n    // Offset\n    offset,\n    offsetVertical,\n    offsetHorizontal,\n    offsetBottom,\n    offsetEnd,\n    offsetStart,\n    offsetTop,\n    // Flex\n    flexShrink,\n  });\n\n  // styles.foundation must be in deps - it returns a new reference when variants change.\n  const computedStyle: StyleProp<TextStyle> = useMemo(\n    () => [\n      textDecorationLine ? { textDecorationLine } : undefined,\n      dangerouslySetColor ? { color: dangerouslySetColor } : undefined,\n      verticalAlign ? { textAlignVertical: verticalAlign } : undefined,\n      height ? { height } : undefined,\n      minHeight ? { minHeight } : undefined,\n      maxHeight ? { maxHeight } : undefined,\n      width ? { width } : undefined,\n      minWidth ? { minWidth } : undefined,\n      maxWidth ? { maxWidth } : undefined,\n      styles.foundation,\n      style,\n    ],\n    [\n      textDecorationLine,\n      dangerouslySetColor,\n      verticalAlign,\n      height,\n      minHeight,\n      maxHeight,\n      width,\n      minWidth,\n      maxWidth,\n      style,\n      styles.foundation,\n    ],\n  );\n\n  return (\n    <RNText\n      ref={ref}\n      style={computedStyle}\n      maxFontSizeMultiplier={resolvedMaxFontSizeMultiplier}\n      dynamicTypeRamp={defaultDynamicTypeRamp}\n      {...props}\n    >\n      {children}\n    </RNText>\n  );\n});\n\nText.displayName = 'Text';\n\nexport { Text, type TextProps, type TextVariant };\n"],"mappings":";;;;;;;;AAwBA,MAAM,SACJ;;;;;;AAOF,SAAS,cAAc,UAA8B;CACnD,IAAI,OAAO,aAAa,UACtB,OAAO,OAAO,KAAK,SAAS;CAE9B,IAAI,MAAM,QAAQ,SAAS,EACzB,OAAO,SAAS,MAAM,UAAU,OAAO,UAAU,YAAY,OAAO,KAAK,MAAM,CAAC;CAElF,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAoHT,MAAM,OAAO,KAAK,SAAS,KAAK,EAE9B,QAAQ,WACR,UAAU,SACV,YACA,UACA,YACA,YACA,eACA,uBACA,WACA,eACA,oBACA,OAEA,iBAEA,cACA,sBACA,oBACA,yBACA,uBACA,aACA,kBACA,gBACA,gBACA,mBACA,aACA,qBACA,uBACA,kBACA,gBACA,gBACA,mBAEA,SACA,mBACA,iBACA,eACA,YACA,cACA,YAEA,QACA,gBACA,kBACA,cACA,WACA,aACA,WAEA,YAEA,eAEA,QACA,WACA,WACA,OACA,UACA,UAEA,qBACA,KACA,UAEA,GAAG,SACS;CACZ,MAAM,gBAAgB,UAAU,YAAY,KAAA,IAAY;CACxD,MAAM,kBAAkB,YAAY,YAAY,KAAA,IAAY;CAC5D,MAAM,qBAAqB,cAAc;CACzC,MAAM,mBAAmB,YAAY;CAKrC,MAAM,qBACJ,eAAe,SACX,KAAA,IACC,eAAe,cAAc,SAAS,GAAG,KAAA,IAAY;CAC5D,MAAM,wBAAwB,iBAAiB;CAC/C,MAAM,cAAc,iBAAiB,MAAM,IAAI,CAAC;CAChD,MAAM,yBAAyB,cAAc,2BAA2B,eAAe,KAAA;CAEvF,MAAM,gCAAgC,yBACpC,iBACA,sBACD;CAED,OAAO,YAAY;EAEjB,OAAO;EACP,YAAY;EACZ,UAAU;EACV;EACA,YAAY;EACZ,eAAe;EACf;EACA;EAEA;EAEA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EAEA;EACA;EACA;EACA;EACA;EACA;EACA;EAEA;EACA;EACA;EACA;EACA;EACA;EACA;EAEA;EACD,CAAC;CAgCF,OACE,oBAACA,QAAD;EACO;EACL,OAhCwC,cACpC;GACJ,qBAAqB,EAAE,oBAAoB,GAAG,KAAA;GAC9C,sBAAsB,EAAE,OAAO,qBAAqB,GAAG,KAAA;GACvD,gBAAgB,EAAE,mBAAmB,eAAe,GAAG,KAAA;GACvD,SAAS,EAAE,QAAQ,GAAG,KAAA;GACtB,YAAY,EAAE,WAAW,GAAG,KAAA;GAC5B,YAAY,EAAE,WAAW,GAAG,KAAA;GAC5B,QAAQ,EAAE,OAAO,GAAG,KAAA;GACpB,WAAW,EAAE,UAAU,GAAG,KAAA;GAC1B,WAAW,EAAE,UAAU,GAAG,KAAA;GAC1B,OAAO;GACP;GACD,EACD;GACE;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA,OAAO;GACR,CAMqB;EACpB,uBAAuB;EACvB,iBAAiB;EACjB,GAAI;EAEH;EACM,CAAA;EAEX;AAEF,KAAK,cAAc"}

package/dist/components/UDSProvider.cjs

@@ -1,8 +1,8 @@
 /*! © 2026 Yahoo, Inc. UDS Mobile v0.0.0-development */
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 require("../_virtual/_rolldown/runtime.cjs");
-const require_portal = require("../portal.cjs");
 const require_fontScaling_FontScalingContext = require("../fontScaling/FontScalingContext.cjs");
+const require_portal = require("../portal.cjs");
 let react = require("react");
 let react_native = require("react-native");
 let react_jsx_runtime = require("react/jsx-runtime");

package/dist/components/UDSProvider.js

@@ -1,6 +1,6 @@
 /*! © 2026 Yahoo, Inc. UDS Mobile v0.0.0-development */
-import { PortalProvider } from "../portal.js";
 import { UDSFontScalingProvider } from "../fontScaling/FontScalingContext.js";
+import { PortalProvider } from "../portal.js";
 import { memo } from "react";
 import { StyleSheet } from "react-native";
 import { jsx } from "react/jsx-runtime";

package/dist/fontScaling/FontScalingContext.cjs

@@ -31,6 +31,20 @@ const UDSFontScalingProvider = (0, react.memo)(function UDSFontScalingProvider({
 	});
 });
 UDSFontScalingProvider.displayName = "UDSFontScalingProvider";
+/** Keeps custom UDS content inside a control on the control's resolved cap. */
+const ResolvedControlFontScalingProvider = (0, react.memo)(function ResolvedControlFontScalingProvider({ maxFontSizeMultiplier, children }) {
+	const cap = maxFontSizeMultiplier === 0 ? null : maxFontSizeMultiplier;
+	const config = (0, react.useMemo)(() => ({
+		default: cap,
+		control: cap
+	}), [cap]);
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(FontScalingContext.Provider, {
+		value: config,
+		children
+	});
+});
+ResolvedControlFontScalingProvider.displayName = "ResolvedControlFontScalingProvider";
 //#endregion
 exports.FontScalingContext = FontScalingContext;
+exports.ResolvedControlFontScalingProvider = ResolvedControlFontScalingProvider;
 exports.UDSFontScalingProvider = UDSFontScalingProvider;

package/dist/fontScaling/FontScalingContext.d.cts

@@ -34,6 +34,12 @@ interface UDSFontScalingProviderProps {
  * ```
  */
 declare const UDSFontScalingProvider: _$react.NamedExoticComponent<UDSFontScalingProviderProps>;
+interface ResolvedControlFontScalingProviderProps {
+  maxFontSizeMultiplier: number;
+  children: ReactNode;
+}
+/** Keeps custom UDS content inside a control on the control's resolved cap. */
+declare const ResolvedControlFontScalingProvider: _$react.NamedExoticComponent<ResolvedControlFontScalingProviderProps>;
 //#endregion
-export { FontScalingContext, UDSFontScalingProvider, type UDSFontScalingProviderProps };
+export { FontScalingContext, ResolvedControlFontScalingProvider, UDSFontScalingProvider, type UDSFontScalingProviderProps };
 //# sourceMappingURL=FontScalingContext.d.cts.map

package/dist/fontScaling/FontScalingContext.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"FontScalingContext.d.cts","names":[],"sources":["../../src/fontScaling/FontScalingContext.tsx"],"mappings":";;;;;;cAMM,kBAAA,EAAkB,OAAA,CAAA,OAAA,CAAA,iBAAA;AAAA,UAEd,2BAAA;;AALuC;;;;EAW/C,MAAA,EAAQ,iBAAA;EACR,QAAA,EAAU,SAAA;AAAA;;;;;;;;;AAAS;;;;;;;;;;;cAsBf,sBAAA,EAAsB,OAAA,CAAA,oBAAA,CAAA,2BAAA"}
+{"version":3,"file":"FontScalingContext.d.cts","names":[],"sources":["../../src/fontScaling/FontScalingContext.tsx"],"mappings":";;;;;;cAMM,kBAAA,EAAkB,OAAA,CAAA,OAAA,CAAA,iBAAA;AAAA,UAEd,2BAAA;;AALuC;;;;EAW/C,MAAA,EAAQ,iBAAA;EACR,QAAA,EAAU,SAAA;AAAA;;;;;;;;;AAAS;;;;;AAsBO;;;;;;cAAtB,sBAAA,EAAsB,OAAA,CAAA,oBAAA,CAAA,2BAAA;AAAA,UASlB,uCAAA;EACR,qBAAA;EACA,QAAA,EAAU,SAAA;AAAA;;cAIN,kCAAA,EAAkC,OAAA,CAAA,oBAAA,CAAA,uCAAA"}

package/dist/fontScaling/FontScalingContext.d.ts

@@ -34,6 +34,12 @@ interface UDSFontScalingProviderProps {
  * ```
  */
 declare const UDSFontScalingProvider: _$react.NamedExoticComponent<UDSFontScalingProviderProps>;
+interface ResolvedControlFontScalingProviderProps {
+  maxFontSizeMultiplier: number;
+  children: ReactNode;
+}
+/** Keeps custom UDS content inside a control on the control's resolved cap. */
+declare const ResolvedControlFontScalingProvider: _$react.NamedExoticComponent<ResolvedControlFontScalingProviderProps>;
 //#endregion
-export { FontScalingContext, UDSFontScalingProvider, type UDSFontScalingProviderProps };
+export { FontScalingContext, ResolvedControlFontScalingProvider, UDSFontScalingProvider, type UDSFontScalingProviderProps };
 //# sourceMappingURL=FontScalingContext.d.ts.map

package/dist/fontScaling/FontScalingContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FontScalingContext.d.ts","names":[],"sources":["../../src/fontScaling/FontScalingContext.tsx"],"mappings":";;;;;;cAMM,kBAAA,EAAkB,OAAA,CAAA,OAAA,CAAA,iBAAA;AAAA,UAEd,2BAAA;;AALuC;;;;EAW/C,MAAA,EAAQ,iBAAA;EACR,QAAA,EAAU,SAAA;AAAA;;;;;;;;;AAAS;;;;;;;;;;;cAsBf,sBAAA,EAAsB,OAAA,CAAA,oBAAA,CAAA,2BAAA"}
+{"version":3,"file":"FontScalingContext.d.ts","names":[],"sources":["../../src/fontScaling/FontScalingContext.tsx"],"mappings":";;;;;;cAMM,kBAAA,EAAkB,OAAA,CAAA,OAAA,CAAA,iBAAA;AAAA,UAEd,2BAAA;;AALuC;;;;EAW/C,MAAA,EAAQ,iBAAA;EACR,QAAA,EAAU,SAAA;AAAA;;;;;;;;;AAAS;;;;;AAsBO;;;;;;cAAtB,sBAAA,EAAsB,OAAA,CAAA,oBAAA,CAAA,2BAAA;AAAA,UASlB,uCAAA;EACR,qBAAA;EACA,QAAA,EAAU,SAAA;AAAA;;cAIN,kCAAA,EAAkC,OAAA,CAAA,oBAAA,CAAA,uCAAA"}

package/dist/fontScaling/FontScalingContext.js

@@ -1,5 +1,5 @@
 /*! © 2026 Yahoo, Inc. UDS Mobile v0.0.0-development */
-import { createContext, memo } from "react";
+import { createContext, memo, useMemo } from "react";
 import { jsx } from "react/jsx-runtime";
 //#region src/fontScaling/FontScalingContext.tsx
 const FontScalingContext = createContext(void 0);
@@ -29,7 +29,20 @@ const UDSFontScalingProvider = memo(function UDSFontScalingProvider({ config, ch
 	});
 });
 UDSFontScalingProvider.displayName = "UDSFontScalingProvider";
+/** Keeps custom UDS content inside a control on the control's resolved cap. */
+const ResolvedControlFontScalingProvider = memo(function ResolvedControlFontScalingProvider({ maxFontSizeMultiplier, children }) {
+	const cap = maxFontSizeMultiplier === 0 ? null : maxFontSizeMultiplier;
+	const config = useMemo(() => ({
+		default: cap,
+		control: cap
+	}), [cap]);
+	return /* @__PURE__ */ jsx(FontScalingContext.Provider, {
+		value: config,
+		children
+	});
+});
+ResolvedControlFontScalingProvider.displayName = "ResolvedControlFontScalingProvider";
 //#endregion
-export { FontScalingContext, UDSFontScalingProvider };
+export { FontScalingContext, ResolvedControlFontScalingProvider, UDSFontScalingProvider };
 
 //# sourceMappingURL=FontScalingContext.js.map

package/dist/fontScaling/FontScalingContext.js.map

@@ -1 +1 @@
-{"version":3,"file":"FontScalingContext.js","names":[],"sources":["../../src/fontScaling/FontScalingContext.tsx"],"sourcesContent":["import type { ReactNode } from 'react';\nimport { createContext, memo } from 'react';\n\nimport type { FontScalingConfig } from './types';\n\n// undefined = no provider mounted; built-in defaults apply.\nconst FontScalingContext = createContext<FontScalingConfig | undefined>(undefined);\n\ninterface UDSFontScalingProviderProps {\n  /**\n   * Font-scaling caps for the subtree. Should be identity-stable (a module\n   * constant or memoized) — every UDS text element reads it from context.\n   * The nearest provider wins wholesale; configs are not merged.\n   */\n  config: FontScalingConfig;\n  children: ReactNode;\n}\n\n/**\n * **🔠 Overrides UDS font-scaling caps for a subtree**\n *\n * @description\n * Configures how UDS text and controls respond to the OS text-size setting.\n * Without a provider, built-in defaults apply (every text style is capped at\n * 2x or below, with the largest display/title tiers tapered further, and\n * control internals capped at 2x). Most apps set this once at the root via the\n * `fontScaling` prop on `UDSGestureProvider`.\n *\n * @example\n * ```tsx\n * const FONT_SCALING = { default: 2, variants: { display1: 1.75 } };\n *\n * <UDSFontScalingProvider config={FONT_SCALING}>\n *   <App />\n * </UDSFontScalingProvider>\n * ```\n */\nconst UDSFontScalingProvider = memo(function UDSFontScalingProvider({\n  config,\n  children,\n}: UDSFontScalingProviderProps) {\n  return <FontScalingContext.Provider value={config}>{children}</FontScalingContext.Provider>;\n});\n\nUDSFontScalingProvider.displayName = 'UDSFontScalingProvider';\n\nexport { FontScalingContext, UDSFontScalingProvider, type UDSFontScalingProviderProps };\n"],"mappings":";;;;AAMA,MAAM,qBAAqB,cAA6C,KAAA,EAAU;;;;;;;;;;;;;;;;;;;;AA+BlF,MAAM,yBAAyB,KAAK,SAAS,uBAAuB,EAClE,QACA,YAC8B;CAC9B,OAAO,oBAAC,mBAAmB,UAApB;EAA6B,OAAO;EAAS;EAAuC,CAAA;EAC3F;AAEF,uBAAuB,cAAc"}
+{"version":3,"file":"FontScalingContext.js","names":[],"sources":["../../src/fontScaling/FontScalingContext.tsx"],"sourcesContent":["import type { ReactNode } from 'react';\nimport { createContext, memo, useMemo } from 'react';\n\nimport type { FontScalingConfig } from './types';\n\n// undefined = no provider mounted; built-in defaults apply.\nconst FontScalingContext = createContext<FontScalingConfig | undefined>(undefined);\n\ninterface UDSFontScalingProviderProps {\n  /**\n   * Font-scaling caps for the subtree. Should be identity-stable (a module\n   * constant or memoized) — every UDS text element reads it from context.\n   * The nearest provider wins wholesale; configs are not merged.\n   */\n  config: FontScalingConfig;\n  children: ReactNode;\n}\n\n/**\n * **🔠 Overrides UDS font-scaling caps for a subtree**\n *\n * @description\n * Configures how UDS text and controls respond to the OS text-size setting.\n * Without a provider, built-in defaults apply (every text style is capped at\n * 2x or below, with the largest display/title tiers tapered further, and\n * control internals capped at 2x). Most apps set this once at the root via the\n * `fontScaling` prop on `UDSGestureProvider`.\n *\n * @example\n * ```tsx\n * const FONT_SCALING = { default: 2, variants: { display1: 1.75 } };\n *\n * <UDSFontScalingProvider config={FONT_SCALING}>\n *   <App />\n * </UDSFontScalingProvider>\n * ```\n */\nconst UDSFontScalingProvider = memo(function UDSFontScalingProvider({\n  config,\n  children,\n}: UDSFontScalingProviderProps) {\n  return <FontScalingContext.Provider value={config}>{children}</FontScalingContext.Provider>;\n});\n\nUDSFontScalingProvider.displayName = 'UDSFontScalingProvider';\n\ninterface ResolvedControlFontScalingProviderProps {\n  maxFontSizeMultiplier: number;\n  children: ReactNode;\n}\n\n/** Keeps custom UDS content inside a control on the control's resolved cap. */\nconst ResolvedControlFontScalingProvider = memo(function ResolvedControlFontScalingProvider({\n  maxFontSizeMultiplier,\n  children,\n}: ResolvedControlFontScalingProviderProps) {\n  const cap = maxFontSizeMultiplier === 0 ? null : maxFontSizeMultiplier;\n  const config = useMemo<FontScalingConfig>(() => ({ default: cap, control: cap }), [cap]);\n\n  return <FontScalingContext.Provider value={config}>{children}</FontScalingContext.Provider>;\n});\n\nResolvedControlFontScalingProvider.displayName = 'ResolvedControlFontScalingProvider';\n\nexport {\n  FontScalingContext,\n  ResolvedControlFontScalingProvider,\n  UDSFontScalingProvider,\n  type UDSFontScalingProviderProps,\n};\n"],"mappings":";;;;AAMA,MAAM,qBAAqB,cAA6C,KAAA,EAAU;;;;;;;;;;;;;;;;;;;;AA+BlF,MAAM,yBAAyB,KAAK,SAAS,uBAAuB,EAClE,QACA,YAC8B;CAC9B,OAAO,oBAAC,mBAAmB,UAApB;EAA6B,OAAO;EAAS;EAAuC,CAAA;EAC3F;AAEF,uBAAuB,cAAc;;AAQrC,MAAM,qCAAqC,KAAK,SAAS,mCAAmC,EAC1F,uBACA,YAC0C;CAC1C,MAAM,MAAM,0BAA0B,IAAI,OAAO;CACjD,MAAM,SAAS,eAAkC;EAAE,SAAS;EAAK,SAAS;EAAK,GAAG,CAAC,IAAI,CAAC;CAExF,OAAO,oBAAC,mBAAmB,UAApB;EAA6B,OAAO;EAAS;EAAuC,CAAA;EAC3F;AAEF,mCAAmC,cAAc"}

package/dist/fontScaling/androidNonlinearFontScaling.cjs

@@ -0,0 +1,174 @@
+/*! © 2026 Yahoo, Inc. UDS Mobile v0.0.0-development */
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/fontScaling/androidNonlinearFontScaling.ts
+/**
+* Android 14+ converts SP through a size-dependent curve. `Configuration.fontScale`
+* is only the user's preference; multiplying by it directly does not reproduce the
+* size that native Text renders.
+*
+* These lookup tables mirror Android's `FontScaleConverterFactory`. Values between
+* table entries are linearly interpolated, as they are in the platform implementation.
+*
+* @see https://android.googlesource.com/platform/frameworks/base/+/refs/heads/main/core/java/android/content/res/FontScaleConverterFactory.java
+*/
+const COMMON_SP_SIZES = [
+	8,
+	10,
+	12,
+	14,
+	18,
+	20,
+	24,
+	30,
+	100
+];
+const ANDROID_FONT_SCALE_CURVES = [
+	{
+		scale: 1.05,
+		dp: [
+			8.4,
+			10.5,
+			12.6,
+			14.8,
+			18.6,
+			20.6,
+			24.4,
+			30,
+			100
+		]
+	},
+	{
+		scale: 1.1,
+		dp: [
+			8.8,
+			11,
+			13.2,
+			15.6,
+			19.2,
+			21.2,
+			24.8,
+			30,
+			100
+		]
+	},
+	{
+		scale: 1.15,
+		dp: [
+			9.2,
+			11.5,
+			13.8,
+			16.4,
+			19.8,
+			21.8,
+			25.2,
+			30,
+			100
+		]
+	},
+	{
+		scale: 1.2,
+		dp: [
+			9.6,
+			12,
+			14.4,
+			17.2,
+			20.4,
+			22.4,
+			25.6,
+			30,
+			100
+		]
+	},
+	{
+		scale: 1.3,
+		dp: [
+			10.4,
+			13,
+			15.6,
+			18.8,
+			21.6,
+			23.6,
+			26.4,
+			30,
+			100
+		]
+	},
+	{
+		scale: 1.5,
+		dp: [
+			12,
+			15,
+			18,
+			22,
+			24,
+			26,
+			28,
+			30,
+			100
+		]
+	},
+	{
+		scale: 1.8,
+		dp: [
+			14.4,
+			18,
+			21.6,
+			24.4,
+			27.6,
+			30.8,
+			32.8,
+			34.8,
+			100
+		]
+	},
+	{
+		scale: 2,
+		dp: [
+			16,
+			20,
+			24,
+			26,
+			30,
+			34,
+			36,
+			38,
+			100
+		]
+	}
+];
+function lerp(start, end, amount) {
+	return start + (end - start) * amount;
+}
+function interpolateSize(fontSize, dpValues) {
+	if (fontSize <= 0) return fontSize;
+	for (let index = 0; index < COMMON_SP_SIZES.length; index += 1) {
+		const currentSp = COMMON_SP_SIZES[index];
+		if (fontSize === currentSp) return dpValues[index];
+		if (fontSize < currentSp) {
+			const previousSp = index === 0 ? 0 : COMMON_SP_SIZES[index - 1];
+			const previousDp = index === 0 ? 0 : dpValues[index - 1];
+			const amount = (fontSize - previousSp) / (currentSp - previousSp);
+			return lerp(previousDp, dpValues[index], amount);
+		}
+	}
+	const lastIndex = COMMON_SP_SIZES.length - 1;
+	return fontSize * (dpValues[lastIndex] / COMMON_SP_SIZES[lastIndex]);
+}
+/** Converts an SP value to its Android 14+ nonlinear DP size. */
+function convertAndroidSpToDp(fontSize, fontScale) {
+	const firstCurve = ANDROID_FONT_SCALE_CURVES[0];
+	const lastCurve = ANDROID_FONT_SCALE_CURVES[ANDROID_FONT_SCALE_CURVES.length - 1];
+	if (fontScale < firstCurve.scale || fontScale > lastCurve.scale) return fontSize * fontScale;
+	for (let index = 0; index < ANDROID_FONT_SCALE_CURVES.length; index += 1) {
+		const curve = ANDROID_FONT_SCALE_CURVES[index];
+		if (fontScale === curve.scale) return interpolateSize(fontSize, curve.dp);
+		if (fontScale < curve.scale) {
+			const previousCurve = ANDROID_FONT_SCALE_CURVES[index - 1];
+			const amount = (fontScale - previousCurve.scale) / (curve.scale - previousCurve.scale);
+			return lerp(interpolateSize(fontSize, previousCurve.dp), interpolateSize(fontSize, curve.dp), amount);
+		}
+	}
+	return fontSize * fontScale;
+}
+//#endregion
+exports.convertAndroidSpToDp = convertAndroidSpToDp;

package/dist/fontScaling/androidNonlinearFontScaling.d.cts

@@ -0,0 +1,7 @@
+
+//#region src/fontScaling/androidNonlinearFontScaling.d.ts
+/** Converts an SP value to its Android 14+ nonlinear DP size. */
+declare function convertAndroidSpToDp(fontSize: number, fontScale: number): number;
+//#endregion
+export { convertAndroidSpToDp };
+//# sourceMappingURL=androidNonlinearFontScaling.d.cts.map

package/dist/fontScaling/androidNonlinearFontScaling.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"androidNonlinearFontScaling.d.cts","names":[],"sources":["../../src/fontScaling/androidNonlinearFontScaling.ts"],"mappings":";;;iBAmDS,oBAAA,CAAqB,QAAA,UAAkB,SAAA"}

package/dist/fontScaling/androidNonlinearFontScaling.d.ts

@@ -0,0 +1,7 @@
+
+//#region src/fontScaling/androidNonlinearFontScaling.d.ts
+/** Converts an SP value to its Android 14+ nonlinear DP size. */
+declare function convertAndroidSpToDp(fontSize: number, fontScale: number): number;
+//#endregion
+export { convertAndroidSpToDp };
+//# sourceMappingURL=androidNonlinearFontScaling.d.ts.map

package/dist/fontScaling/androidNonlinearFontScaling.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"androidNonlinearFontScaling.d.ts","names":[],"sources":["../../src/fontScaling/androidNonlinearFontScaling.ts"],"mappings":";;;iBAmDS,oBAAA,CAAqB,QAAA,UAAkB,SAAA"}

package/dist/fontScaling/androidNonlinearFontScaling.js

@@ -0,0 +1,175 @@
+/*! © 2026 Yahoo, Inc. UDS Mobile v0.0.0-development */
+//#region src/fontScaling/androidNonlinearFontScaling.ts
+/**
+* Android 14+ converts SP through a size-dependent curve. `Configuration.fontScale`
+* is only the user's preference; multiplying by it directly does not reproduce the
+* size that native Text renders.
+*
+* These lookup tables mirror Android's `FontScaleConverterFactory`. Values between
+* table entries are linearly interpolated, as they are in the platform implementation.
+*
+* @see https://android.googlesource.com/platform/frameworks/base/+/refs/heads/main/core/java/android/content/res/FontScaleConverterFactory.java
+*/
+const COMMON_SP_SIZES = [
+	8,
+	10,
+	12,
+	14,
+	18,
+	20,
+	24,
+	30,
+	100
+];
+const ANDROID_FONT_SCALE_CURVES = [
+	{
+		scale: 1.05,
+		dp: [
+			8.4,
+			10.5,
+			12.6,
+			14.8,
+			18.6,
+			20.6,
+			24.4,
+			30,
+			100
+		]
+	},
+	{
+		scale: 1.1,
+		dp: [
+			8.8,
+			11,
+			13.2,
+			15.6,
+			19.2,
+			21.2,
+			24.8,
+			30,
+			100
+		]
+	},
+	{
+		scale: 1.15,
+		dp: [
+			9.2,
+			11.5,
+			13.8,
+			16.4,
+			19.8,
+			21.8,
+			25.2,
+			30,
+			100
+		]
+	},
+	{
+		scale: 1.2,
+		dp: [
+			9.6,
+			12,
+			14.4,
+			17.2,
+			20.4,
+			22.4,
+			25.6,
+			30,
+			100
+		]
+	},
+	{
+		scale: 1.3,
+		dp: [
+			10.4,
+			13,
+			15.6,
+			18.8,
+			21.6,
+			23.6,
+			26.4,
+			30,
+			100
+		]
+	},
+	{
+		scale: 1.5,
+		dp: [
+			12,
+			15,
+			18,
+			22,
+			24,
+			26,
+			28,
+			30,
+			100
+		]
+	},
+	{
+		scale: 1.8,
+		dp: [
+			14.4,
+			18,
+			21.6,
+			24.4,
+			27.6,
+			30.8,
+			32.8,
+			34.8,
+			100
+		]
+	},
+	{
+		scale: 2,
+		dp: [
+			16,
+			20,
+			24,
+			26,
+			30,
+			34,
+			36,
+			38,
+			100
+		]
+	}
+];
+function lerp(start, end, amount) {
+	return start + (end - start) * amount;
+}
+function interpolateSize(fontSize, dpValues) {
+	if (fontSize <= 0) return fontSize;
+	for (let index = 0; index < COMMON_SP_SIZES.length; index += 1) {
+		const currentSp = COMMON_SP_SIZES[index];
+		if (fontSize === currentSp) return dpValues[index];
+		if (fontSize < currentSp) {
+			const previousSp = index === 0 ? 0 : COMMON_SP_SIZES[index - 1];
+			const previousDp = index === 0 ? 0 : dpValues[index - 1];
+			const amount = (fontSize - previousSp) / (currentSp - previousSp);
+			return lerp(previousDp, dpValues[index], amount);
+		}
+	}
+	const lastIndex = COMMON_SP_SIZES.length - 1;
+	return fontSize * (dpValues[lastIndex] / COMMON_SP_SIZES[lastIndex]);
+}
+/** Converts an SP value to its Android 14+ nonlinear DP size. */
+function convertAndroidSpToDp(fontSize, fontScale) {
+	const firstCurve = ANDROID_FONT_SCALE_CURVES[0];
+	const lastCurve = ANDROID_FONT_SCALE_CURVES[ANDROID_FONT_SCALE_CURVES.length - 1];
+	if (fontScale < firstCurve.scale || fontScale > lastCurve.scale) return fontSize * fontScale;
+	for (let index = 0; index < ANDROID_FONT_SCALE_CURVES.length; index += 1) {
+		const curve = ANDROID_FONT_SCALE_CURVES[index];
+		if (fontScale === curve.scale) return interpolateSize(fontSize, curve.dp);
+		if (fontScale < curve.scale) {
+			const previousCurve = ANDROID_FONT_SCALE_CURVES[index - 1];
+			const amount = (fontScale - previousCurve.scale) / (curve.scale - previousCurve.scale);
+			return lerp(interpolateSize(fontSize, previousCurve.dp), interpolateSize(fontSize, curve.dp), amount);
+		}
+	}
+	return fontSize * fontScale;
+}
+//#endregion
+export { convertAndroidSpToDp };
+
+//# sourceMappingURL=androidNonlinearFontScaling.js.map

package/dist/fontScaling/androidNonlinearFontScaling.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"androidNonlinearFontScaling.js","names":[],"sources":["../../src/fontScaling/androidNonlinearFontScaling.ts"],"sourcesContent":["/**\n * Android 14+ converts SP through a size-dependent curve. `Configuration.fontScale`\n * is only the user's preference; multiplying by it directly does not reproduce the\n * size that native Text renders.\n *\n * These lookup tables mirror Android's `FontScaleConverterFactory`. Values between\n * table entries are linearly interpolated, as they are in the platform implementation.\n *\n * @see https://android.googlesource.com/platform/frameworks/base/+/refs/heads/main/core/java/android/content/res/FontScaleConverterFactory.java\n */\nconst COMMON_SP_SIZES = [8, 10, 12, 14, 18, 20, 24, 30, 100] as const;\n\nconst ANDROID_FONT_SCALE_CURVES = [\n  { scale: 1.05, dp: [8.4, 10.5, 12.6, 14.8, 18.6, 20.6, 24.4, 30, 100] },\n  { scale: 1.1, dp: [8.8, 11, 13.2, 15.6, 19.2, 21.2, 24.8, 30, 100] },\n  { scale: 1.15, dp: [9.2, 11.5, 13.8, 16.4, 19.8, 21.8, 25.2, 30, 100] },\n  { scale: 1.2, dp: [9.6, 12, 14.4, 17.2, 20.4, 22.4, 25.6, 30, 100] },\n  { scale: 1.3, dp: [10.4, 13, 15.6, 18.8, 21.6, 23.6, 26.4, 30, 100] },\n  { scale: 1.5, dp: [12, 15, 18, 22, 24, 26, 28, 30, 100] },\n  { scale: 1.8, dp: [14.4, 18, 21.6, 24.4, 27.6, 30.8, 32.8, 34.8, 100] },\n  { scale: 2, dp: [16, 20, 24, 26, 30, 34, 36, 38, 100] },\n] as const;\n\nfunction lerp(start: number, end: number, amount: number): number {\n  return start + (end - start) * amount;\n}\n\nfunction interpolateSize(fontSize: number, dpValues: readonly number[]): number {\n  if (fontSize <= 0) {\n    return fontSize;\n  }\n\n  for (let index = 0; index < COMMON_SP_SIZES.length; index += 1) {\n    const currentSp = COMMON_SP_SIZES[index];\n    if (fontSize === currentSp) {\n      return dpValues[index] as number;\n    }\n    if (fontSize < currentSp) {\n      const previousSp = index === 0 ? 0 : COMMON_SP_SIZES[index - 1];\n      const previousDp = index === 0 ? 0 : (dpValues[index - 1] as number);\n      const amount = (fontSize - previousSp) / (currentSp - previousSp);\n      return lerp(previousDp, dpValues[index] as number, amount);\n    }\n  }\n\n  // Android extrapolates beyond the table with the last entry's ratio.\n  const lastIndex = COMMON_SP_SIZES.length - 1;\n  return fontSize * ((dpValues[lastIndex] as number) / COMMON_SP_SIZES[lastIndex]);\n}\n\n/** Converts an SP value to its Android 14+ nonlinear DP size. */\nfunction convertAndroidSpToDp(fontSize: number, fontScale: number): number {\n  const firstCurve = ANDROID_FONT_SCALE_CURVES[0];\n  const lastCurve = ANDROID_FONT_SCALE_CURVES[ANDROID_FONT_SCALE_CURVES.length - 1];\n\n  // Outside Android's curve range, the platform falls back to a linear table.\n  if (fontScale < firstCurve.scale || fontScale > lastCurve.scale) {\n    return fontSize * fontScale;\n  }\n\n  for (let index = 0; index < ANDROID_FONT_SCALE_CURVES.length; index += 1) {\n    const curve = ANDROID_FONT_SCALE_CURVES[index];\n    if (fontScale === curve.scale) {\n      return interpolateSize(fontSize, curve.dp);\n    }\n    if (fontScale < curve.scale) {\n      const previousCurve = ANDROID_FONT_SCALE_CURVES[index - 1];\n      const amount = (fontScale - previousCurve.scale) / (curve.scale - previousCurve.scale);\n      return lerp(\n        interpolateSize(fontSize, previousCurve.dp),\n        interpolateSize(fontSize, curve.dp),\n        amount,\n      );\n    }\n  }\n\n  return fontSize * fontScale;\n}\n\nexport { convertAndroidSpToDp };\n"],"mappings":";;;;;;;;;;;;AAUA,MAAM,kBAAkB;CAAC;CAAG;CAAI;CAAI;CAAI;CAAI;CAAI;CAAI;CAAI;CAAI;AAE5D,MAAM,4BAA4B;CAChC;EAAE,OAAO;EAAM,IAAI;GAAC;GAAK;GAAM;GAAM;GAAM;GAAM;GAAM;GAAM;GAAI;GAAI;EAAE;CACvE;EAAE,OAAO;EAAK,IAAI;GAAC;GAAK;GAAI;GAAM;GAAM;GAAM;GAAM;GAAM;GAAI;GAAI;EAAE;CACpE;EAAE,OAAO;EAAM,IAAI;GAAC;GAAK;GAAM;GAAM;GAAM;GAAM;GAAM;GAAM;GAAI;GAAI;EAAE;CACvE;EAAE,OAAO;EAAK,IAAI;GAAC;GAAK;GAAI;GAAM;GAAM;GAAM;GAAM;GAAM;GAAI;GAAI;EAAE;CACpE;EAAE,OAAO;EAAK,IAAI;GAAC;GAAM;GAAI;GAAM;GAAM;GAAM;GAAM;GAAM;GAAI;GAAI;EAAE;CACrE;EAAE,OAAO;EAAK,IAAI;GAAC;GAAI;GAAI;GAAI;GAAI;GAAI;GAAI;GAAI;GAAI;GAAI;EAAE;CACzD;EAAE,OAAO;EAAK,IAAI;GAAC;GAAM;GAAI;GAAM;GAAM;GAAM;GAAM;GAAM;GAAM;GAAI;EAAE;CACvE;EAAE,OAAO;EAAG,IAAI;GAAC;GAAI;GAAI;GAAI;GAAI;GAAI;GAAI;GAAI;GAAI;GAAI;EAAE;CACxD;AAED,SAAS,KAAK,OAAe,KAAa,QAAwB;CAChE,OAAO,SAAS,MAAM,SAAS;;AAGjC,SAAS,gBAAgB,UAAkB,UAAqC;CAC9E,IAAI,YAAY,GACd,OAAO;CAGT,KAAK,IAAI,QAAQ,GAAG,QAAQ,gBAAgB,QAAQ,SAAS,GAAG;EAC9D,MAAM,YAAY,gBAAgB;EAClC,IAAI,aAAa,WACf,OAAO,SAAS;EAElB,IAAI,WAAW,WAAW;GACxB,MAAM,aAAa,UAAU,IAAI,IAAI,gBAAgB,QAAQ;GAC7D,MAAM,aAAa,UAAU,IAAI,IAAK,SAAS,QAAQ;GACvD,MAAM,UAAU,WAAW,eAAe,YAAY;GACtD,OAAO,KAAK,YAAY,SAAS,QAAkB,OAAO;;;CAK9D,MAAM,YAAY,gBAAgB,SAAS;CAC3C,OAAO,YAAa,SAAS,aAAwB,gBAAgB;;;AAIvE,SAAS,qBAAqB,UAAkB,WAA2B;CACzE,MAAM,aAAa,0BAA0B;CAC7C,MAAM,YAAY,0BAA0B,0BAA0B,SAAS;CAG/E,IAAI,YAAY,WAAW,SAAS,YAAY,UAAU,OACxD,OAAO,WAAW;CAGpB,KAAK,IAAI,QAAQ,GAAG,QAAQ,0BAA0B,QAAQ,SAAS,GAAG;EACxE,MAAM,QAAQ,0BAA0B;EACxC,IAAI,cAAc,MAAM,OACtB,OAAO,gBAAgB,UAAU,MAAM,GAAG;EAE5C,IAAI,YAAY,MAAM,OAAO;GAC3B,MAAM,gBAAgB,0BAA0B,QAAQ;GACxD,MAAM,UAAU,YAAY,cAAc,UAAU,MAAM,QAAQ,cAAc;GAChF,OAAO,KACL,gBAAgB,UAAU,cAAc,GAAG,EAC3C,gBAAgB,UAAU,MAAM,GAAG,EACnC,OACD;;;CAIL,OAAO,WAAW"}

package/dist/fontScaling/constants.cjs

@@ -65,8 +65,41 @@ const DEFAULT_MAX_FONT_SIZE_MULTIPLIERS = Object.freeze(Object.fromEntries(Objec
 * supported ceiling rather than a looser per-variant cap.
 */
 const DEFAULT_CONTROL_MAX_FONT_SIZE_MULTIPLIER = 2;
+/**
+* iOS Dynamic Type curve used by each UDS typography tier. React Native uses
+* the selected system text style's curve while preserving the configured UDS
+* font size. Android ignores `dynamicTypeRamp` and continues to use its native
+* nonlinear font scaling.
+*
+* Keys are base variants; `/emphasized` twins resolve to their base.
+*/
+const DEFAULT_DYNAMIC_TYPE_RAMPS = {
+	display1: "largeTitle",
+	display2: "largeTitle",
+	display3: "largeTitle",
+	title1: "title1",
+	title2: "title2",
+	title3: "title3",
+	title4: "title3",
+	headline1: "headline",
+	body1: "body",
+	label1: "callout",
+	label2: "subheadline",
+	label3: "footnote",
+	label4: "caption1",
+	caption1: "caption1",
+	caption2: "caption2",
+	legal1: "caption2",
+	ui1: "title3",
+	ui2: "title3",
+	ui3: "callout",
+	ui4: "subheadline",
+	ui5: "footnote",
+	ui6: "caption2"
+};
 //#endregion
 exports.DEFAULT_CONTROL_MAX_FONT_SIZE_MULTIPLIER = DEFAULT_CONTROL_MAX_FONT_SIZE_MULTIPLIER;
+exports.DEFAULT_DYNAMIC_TYPE_RAMPS = DEFAULT_DYNAMIC_TYPE_RAMPS;
 exports.DEFAULT_MAX_FONT_SIZE_MULTIPLIERS = DEFAULT_MAX_FONT_SIZE_MULTIPLIERS;
 exports.MAX_SUPPORTED_FONT_SCALE = MAX_SUPPORTED_FONT_SCALE;
 exports.TYPE_SCALE_CURVE = TYPE_SCALE_CURVE;