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

package/dist/components/Text.js

@@ -1,4 +1,5 @@
 /*! © 2026 Yahoo, Inc. UDS Mobile v0.0.0-development */
+import { useFontScalingEnabled } from "../fontScaling/FontScalingContext.js";
 import { DEFAULT_DYNAMIC_TYPE_RAMPS } from "../fontScaling/constants.js";
 import { useMaxFontSizeMultiplier } from "../fontScaling/useMaxFontSizeMultiplier.js";
 import { memo, useMemo } from "react";
@@ -55,7 +56,7 @@ const Text = memo(function Text({ color = "primary", variant = "body1", fontFami
 	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 defaultDynamicTypeRamp = useFontScalingEnabled() && baseVariant ? DEFAULT_DYNAMIC_TYPE_RAMPS[baseVariant] : void 0;
 	const resolvedMaxFontSizeMultiplier = useMaxFontSizeMultiplier(resolvedVariant, maxFontSizeMultiplier);
 	styles.useVariants({
 		color: resolvedColor,

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 { 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"}
+{"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 { useFontScalingEnabled } from '../fontScaling/FontScalingContext';\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 fontScalingEnabled = useFontScalingEnabled();\n  const defaultDynamicTypeRamp =\n    fontScalingEnabled && 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":";;;;;;;;;AAyBA,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;CAEhD,MAAM,yBADqB,uBAEP,IAAI,cAAc,2BAA2B,eAAe,KAAA;CAEhF,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/fontScaling/FontScalingContext.cjs

@@ -5,6 +5,10 @@ let react = require("react");
 let react_jsx_runtime = require("react/jsx-runtime");
 //#region src/fontScaling/FontScalingContext.tsx
 const FontScalingContext = (0, react.createContext)(void 0);
+/** Whether UDS-added caps, ramps, and scale-aware geometry are enabled. */
+function useFontScalingEnabled() {
+	return (0, react.useContext)(FontScalingContext)?.enabled !== false;
+}
 /**
 * **🔠 Overrides UDS font-scaling caps for a subtree**
 *
@@ -33,11 +37,12 @@ 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 parentConfig = (0, react.useContext)(FontScalingContext);
 	const cap = maxFontSizeMultiplier === 0 ? null : maxFontSizeMultiplier;
-	const config = (0, react.useMemo)(() => ({
+	const config = (0, react.useMemo)(() => parentConfig?.enabled === false ? { enabled: false } : {
 		default: cap,
 		control: cap
-	}), [cap]);
+	}, [cap, parentConfig?.enabled]);
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(FontScalingContext.Provider, {
 		value: config,
 		children
@@ -48,3 +53,4 @@ ResolvedControlFontScalingProvider.displayName = "ResolvedControlFontScalingProv
 exports.FontScalingContext = FontScalingContext;
 exports.ResolvedControlFontScalingProvider = ResolvedControlFontScalingProvider;
 exports.UDSFontScalingProvider = UDSFontScalingProvider;
+exports.useFontScalingEnabled = useFontScalingEnabled;

package/dist/fontScaling/FontScalingContext.d.cts

@@ -5,6 +5,8 @@ import { ReactNode } from "react";
 
 //#region src/fontScaling/FontScalingContext.d.ts
 declare const FontScalingContext: _$react.Context<FontScalingConfig | undefined>;
+/** Whether UDS-added caps, ramps, and scale-aware geometry are enabled. */
+declare function useFontScalingEnabled(): boolean;
 interface UDSFontScalingProviderProps {
   /**
    * Font-scaling caps for the subtree. Should be identity-stable (a module
@@ -35,11 +37,11 @@ interface UDSFontScalingProviderProps {
  */
 declare const UDSFontScalingProvider: _$react.NamedExoticComponent<UDSFontScalingProviderProps>;
 interface ResolvedControlFontScalingProviderProps {
-  maxFontSizeMultiplier: number;
+  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, ResolvedControlFontScalingProvider, UDSFontScalingProvider, type UDSFontScalingProviderProps };
+export { FontScalingContext, ResolvedControlFontScalingProvider, UDSFontScalingProvider, type UDSFontScalingProviderProps, useFontScalingEnabled };
 //# 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;;;;;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"}
+{"version":3,"file":"FontScalingContext.d.cts","names":[],"sources":["../../src/fontScaling/FontScalingContext.tsx"],"mappings":";;;;;;cAMM,kBAAA,EAAkB,OAAA,CAAA,OAAA,CAAA,iBAAA;;iBAGf,qBAAA,CAAA;AAAA,UAIC,2BAAA;EAPwE;;;;AAA1D;EAatB,MAAA,EAAQ,iBAAA;EACR,QAAA,EAAU,SAAA;AAAA;;AAXkB;;;;;;;;;;AAWT;;;;;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

@@ -5,6 +5,8 @@ import { ReactNode } from "react";
 
 //#region src/fontScaling/FontScalingContext.d.ts
 declare const FontScalingContext: _$react.Context<FontScalingConfig | undefined>;
+/** Whether UDS-added caps, ramps, and scale-aware geometry are enabled. */
+declare function useFontScalingEnabled(): boolean;
 interface UDSFontScalingProviderProps {
   /**
    * Font-scaling caps for the subtree. Should be identity-stable (a module
@@ -35,11 +37,11 @@ interface UDSFontScalingProviderProps {
  */
 declare const UDSFontScalingProvider: _$react.NamedExoticComponent<UDSFontScalingProviderProps>;
 interface ResolvedControlFontScalingProviderProps {
-  maxFontSizeMultiplier: number;
+  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, ResolvedControlFontScalingProvider, UDSFontScalingProvider, type UDSFontScalingProviderProps };
+export { FontScalingContext, ResolvedControlFontScalingProvider, UDSFontScalingProvider, type UDSFontScalingProviderProps, useFontScalingEnabled };
 //# 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;;;;;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"}
+{"version":3,"file":"FontScalingContext.d.ts","names":[],"sources":["../../src/fontScaling/FontScalingContext.tsx"],"mappings":";;;;;;cAMM,kBAAA,EAAkB,OAAA,CAAA,OAAA,CAAA,iBAAA;;iBAGf,qBAAA,CAAA;AAAA,UAIC,2BAAA;EAPwE;;;;AAA1D;EAatB,MAAA,EAAQ,iBAAA;EACR,QAAA,EAAU,SAAA;AAAA;;AAXkB;;;;;;;;;;AAWT;;;;;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,8 +1,12 @@
 /*! © 2026 Yahoo, Inc. UDS Mobile v0.0.0-development */
-import { createContext, memo, useMemo } from "react";
+import { createContext, memo, useContext, useMemo } from "react";
 import { jsx } from "react/jsx-runtime";
 //#region src/fontScaling/FontScalingContext.tsx
 const FontScalingContext = createContext(void 0);
+/** Whether UDS-added caps, ramps, and scale-aware geometry are enabled. */
+function useFontScalingEnabled() {
+	return useContext(FontScalingContext)?.enabled !== false;
+}
 /**
 * **🔠 Overrides UDS font-scaling caps for a subtree**
 *
@@ -31,11 +35,12 @@ 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 parentConfig = useContext(FontScalingContext);
 	const cap = maxFontSizeMultiplier === 0 ? null : maxFontSizeMultiplier;
-	const config = useMemo(() => ({
+	const config = useMemo(() => parentConfig?.enabled === false ? { enabled: false } : {
 		default: cap,
 		control: cap
-	}), [cap]);
+	}, [cap, parentConfig?.enabled]);
 	return /* @__PURE__ */ jsx(FontScalingContext.Provider, {
 		value: config,
 		children
@@ -43,6 +48,6 @@ const ResolvedControlFontScalingProvider = memo(function ResolvedControlFontScal
 });
 ResolvedControlFontScalingProvider.displayName = "ResolvedControlFontScalingProvider";
 //#endregion
-export { FontScalingContext, ResolvedControlFontScalingProvider, UDSFontScalingProvider };
+export { FontScalingContext, ResolvedControlFontScalingProvider, UDSFontScalingProvider, useFontScalingEnabled };
 
 //# 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, 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"}
+{"version":3,"file":"FontScalingContext.js","names":[],"sources":["../../src/fontScaling/FontScalingContext.tsx"],"sourcesContent":["import type { ReactNode } from 'react';\nimport { createContext, memo, useContext, 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\n/** Whether UDS-added caps, ramps, and scale-aware geometry are enabled. */\nfunction useFontScalingEnabled(): boolean {\n  return useContext(FontScalingContext)?.enabled !== false;\n}\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 parentConfig = useContext(FontScalingContext);\n  const cap = maxFontSizeMultiplier === 0 ? null : maxFontSizeMultiplier;\n  const config = useMemo<FontScalingConfig>(\n    () => (parentConfig?.enabled === false ? { enabled: false } : { default: cap, control: cap }),\n    [cap, parentConfig?.enabled],\n  );\n\n  return <FontScalingContext.Provider value={config}>{children}</FontScalingContext.Provider>;\n});\n\nResolvedControlFontScalingProvider.displayName = 'ResolvedControlFontScalingProvider';\n\nexport {\n  FontScalingContext,\n  ResolvedControlFontScalingProvider,\n  UDSFontScalingProvider,\n  useFontScalingEnabled,\n};\nexport type { UDSFontScalingProviderProps };\n"],"mappings":";;;;AAMA,MAAM,qBAAqB,cAA6C,KAAA,EAAU;;AAGlF,SAAS,wBAAiC;CACxC,OAAO,WAAW,mBAAmB,EAAE,YAAY;;;;;;;;;;;;;;;;;;;;;AAgCrD,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,eAAe,WAAW,mBAAmB;CACnD,MAAM,MAAM,0BAA0B,IAAI,OAAO;CACjD,MAAM,SAAS,cACN,cAAc,YAAY,QAAQ,EAAE,SAAS,OAAO,GAAG;EAAE,SAAS;EAAK,SAAS;EAAK,EAC5F,CAAC,KAAK,cAAc,QAAQ,CAC7B;CAED,OAAO,oBAAC,mBAAmB,UAApB;EAA6B,OAAO;EAAS;EAAuC,CAAA;EAC3F;AAEF,mCAAmC,cAAc"}

package/dist/fontScaling/constants.cjs

@@ -60,9 +60,10 @@ const TYPE_SCALE_CURVE = {
 */
 const DEFAULT_MAX_FONT_SIZE_MULTIPLIERS = Object.freeze(Object.fromEntries(Object.entries(TYPE_SCALE_CURVE).map(([variant, cap]) => [variant, cap === null ? 2 : Math.min(cap, 2)])));
 /**
-* Default cap for control-internal text and icons (Button, Checkbox, Radio,
-* Switch, Chip, Tabs, Icon). Controls have bounded layouts, so they get the
-* supported ceiling rather than a looser per-variant cap.
+* Default cap for control-internal text, icons, and geometry (Button,
+* Checkbox, Radio, Switch, Chip, Tabs, Input, Select, Avatar, Pagination, and
+* Icon). Controls have bounded layouts, so they get the supported ceiling
+* rather than a looser per-variant cap.
 */
 const DEFAULT_CONTROL_MAX_FONT_SIZE_MULTIPLIER = 2;
 /**

package/dist/fontScaling/constants.d.cts

@@ -40,9 +40,10 @@ declare const TYPE_SCALE_CURVE: Readonly<Partial<Record<TextVariant, FontScaling
  */
 declare const DEFAULT_MAX_FONT_SIZE_MULTIPLIERS: Readonly<Partial<Record<TextVariant, FontScalingCapValue>>>;
 /**
- * Default cap for control-internal text and icons (Button, Checkbox, Radio,
- * Switch, Chip, Tabs, Icon). Controls have bounded layouts, so they get the
- * supported ceiling rather than a looser per-variant cap.
+ * Default cap for control-internal text, icons, and geometry (Button,
+ * Checkbox, Radio, Switch, Chip, Tabs, Input, Select, Avatar, Pagination, and
+ * Icon). Controls have bounded layouts, so they get the supported ceiling
+ * rather than a looser per-variant cap.
  */
 declare const DEFAULT_CONTROL_MAX_FONT_SIZE_MULTIPLIER = 2;
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"constants.d.cts","names":[],"sources":["../../src/fontScaling/constants.ts"],"mappings":";;;;;;;;AAGmD;;;;;AAarB;;;;cAAxB,wBAAA;;;;;;;;;;;;;AAgB0E;;cAA1E,gBAAA,EAAkB,QAAA,CAAS,OAAA,CAAQ,MAAA,CAAO,WAAA,EAAa,mBAAA;;;;;;;;cAgCvD,iCAAA,EAAmC,QAAA,CACvC,OAAA,CAAQ,MAAA,CAAO,WAAA,EAAa,mBAAA;;;;;;cAexB,wCAAA;AAf2C;;;;;AAeH;;;AAfG,cAyB3C,0BAAA,EAA4B,QAAA,CAChC,OAAA,CAAQ,MAAA,CAAO,WAAA,EAAa,WAAA,CAAY,SAAA"}
+{"version":3,"file":"constants.d.cts","names":[],"sources":["../../src/fontScaling/constants.ts"],"mappings":";;;;;;;;AAGmD;;;;;AAarB;;;;cAAxB,wBAAA;;;;;;;;;;;;;AAgB0E;;cAA1E,gBAAA,EAAkB,QAAA,CAAS,OAAA,CAAQ,MAAA,CAAO,WAAA,EAAa,mBAAA;;;;;;;;cAgCvD,iCAAA,EAAmC,QAAA,CACvC,OAAA,CAAQ,MAAA,CAAO,WAAA,EAAa,mBAAA;;;;;;;cAgBxB,wCAAA;;;;;AAAwC;;;;cAUxC,0BAAA,EAA4B,QAAA,CAChC,OAAA,CAAQ,MAAA,CAAO,WAAA,EAAa,WAAA,CAAY,SAAA"}

package/dist/fontScaling/constants.d.ts

@@ -40,9 +40,10 @@ declare const TYPE_SCALE_CURVE: Readonly<Partial<Record<TextVariant, FontScaling
  */
 declare const DEFAULT_MAX_FONT_SIZE_MULTIPLIERS: Readonly<Partial<Record<TextVariant, FontScalingCapValue>>>;
 /**
- * Default cap for control-internal text and icons (Button, Checkbox, Radio,
- * Switch, Chip, Tabs, Icon). Controls have bounded layouts, so they get the
- * supported ceiling rather than a looser per-variant cap.
+ * Default cap for control-internal text, icons, and geometry (Button,
+ * Checkbox, Radio, Switch, Chip, Tabs, Input, Select, Avatar, Pagination, and
+ * Icon). Controls have bounded layouts, so they get the supported ceiling
+ * rather than a looser per-variant cap.
  */
 declare const DEFAULT_CONTROL_MAX_FONT_SIZE_MULTIPLIER = 2;
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","names":[],"sources":["../../src/fontScaling/constants.ts"],"mappings":";;;;;;;;AAGmD;;;;;AAarB;;;;cAAxB,wBAAA;;;;;;;;;;;;;AAgB0E;;cAA1E,gBAAA,EAAkB,QAAA,CAAS,OAAA,CAAQ,MAAA,CAAO,WAAA,EAAa,mBAAA;;;;;;;;cAgCvD,iCAAA,EAAmC,QAAA,CACvC,OAAA,CAAQ,MAAA,CAAO,WAAA,EAAa,mBAAA;;;;;;cAexB,wCAAA;AAf2C;;;;;AAeH;;;AAfG,cAyB3C,0BAAA,EAA4B,QAAA,CAChC,OAAA,CAAQ,MAAA,CAAO,WAAA,EAAa,WAAA,CAAY,SAAA"}
+{"version":3,"file":"constants.d.ts","names":[],"sources":["../../src/fontScaling/constants.ts"],"mappings":";;;;;;;;AAGmD;;;;;AAarB;;;;cAAxB,wBAAA;;;;;;;;;;;;;AAgB0E;;cAA1E,gBAAA,EAAkB,QAAA,CAAS,OAAA,CAAQ,MAAA,CAAO,WAAA,EAAa,mBAAA;;;;;;;;cAgCvD,iCAAA,EAAmC,QAAA,CACvC,OAAA,CAAQ,MAAA,CAAO,WAAA,EAAa,mBAAA;;;;;;;cAgBxB,wCAAA;;;;;AAAwC;;;;cAUxC,0BAAA,EAA4B,QAAA,CAChC,OAAA,CAAQ,MAAA,CAAO,WAAA,EAAa,WAAA,CAAY,SAAA"}

package/dist/fontScaling/constants.js

@@ -59,9 +59,10 @@ const TYPE_SCALE_CURVE = {
 */
 const DEFAULT_MAX_FONT_SIZE_MULTIPLIERS = Object.freeze(Object.fromEntries(Object.entries(TYPE_SCALE_CURVE).map(([variant, cap]) => [variant, cap === null ? 2 : Math.min(cap, 2)])));
 /**
-* Default cap for control-internal text and icons (Button, Checkbox, Radio,
-* Switch, Chip, Tabs, Icon). Controls have bounded layouts, so they get the
-* supported ceiling rather than a looser per-variant cap.
+* Default cap for control-internal text, icons, and geometry (Button,
+* Checkbox, Radio, Switch, Chip, Tabs, Input, Select, Avatar, Pagination, and
+* Icon). Controls have bounded layouts, so they get the supported ceiling
+* rather than a looser per-variant cap.
 */
 const DEFAULT_CONTROL_MAX_FONT_SIZE_MULTIPLIER = 2;
 /**

package/dist/fontScaling/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","names":[],"sources":["../../src/fontScaling/constants.ts"],"sourcesContent":["import type { TextProps as RNTextProps } from 'react-native';\n\nimport type { TextVariant } from '../components/Text';\nimport type { FontScalingCapValue } from './types';\n\n/**\n * The largest OS font scale UDS components are designed to support.\n *\n * Yahoo's inclusive-design guidance is to solve for text scaling up to 2x, so\n * no default cap exceeds it. Apple's Accessibility Nutrition Label for Larger\n * Text is claimable at \"at least 200% or the maximum font size for the\n * system\", so a 2x ceiling still qualifies. Note that iOS offers scales beyond\n * this (up to 3.571x): with this ceiling in place the top accessibility sizes\n * render alike, and an app that wants to follow the OS further can raise or\n * remove the caps via `UDSFontScalingProvider`.\n */\nconst MAX_SUPPORTED_FONT_SCALE = 2;\n\n/**\n * How far each text style would grow if only legibility mattered, following\n * the shape of Apple's Dynamic Type ramps: the larger a style starts, the less\n * it multiplies. At iOS's largest accessibility size the system grows body\n * (17pt) by 3.12x but largeTitle (34pt) by only ~1.71x, and UDS display tiers\n * are larger than largeTitle, so they taper hardest.\n *\n * Caps are chosen by the size a style starts at rather than by which family it\n * belongs to, which is why `ui1` (24pt) matches `title3` (24pt) and `ui2`\n * (20pt) matches `title4` (20pt). `null` means \"no cap from the curve\" — those\n * are reading sizes, where legibility argues for following the OS.\n *\n * The exported defaults are this curve clamped to {@link MAX_SUPPORTED_FONT_SCALE}.\n */\nconst TYPE_SCALE_CURVE: Readonly<Partial<Record<TextVariant, FontScalingCapValue>>> = {\n  display1: 1.5,\n  display2: 1.6,\n  display3: 1.75,\n  title1: 1.8,\n  title2: 2,\n  title3: 2.2,\n  title4: 2.4,\n  headline1: 2.5,\n  ui1: 2.2,\n  ui2: 2.4,\n  body1: null,\n  label1: null,\n  label2: null,\n  label3: null,\n  label4: null,\n  caption1: null,\n  caption2: null,\n  legal1: null,\n  ui3: null,\n  ui4: null,\n  ui5: null,\n  ui6: null,\n};\n\n/**\n * Default per-variant caps on OS font scaling, applied by `Text` when no\n * explicit prop or provider config overrides them: the legibility curve in\n * {@link TYPE_SCALE_CURVE}, clamped to the 2x we support.\n *\n * Keys are base variants; `/emphasized` twins resolve to their base.\n */\nconst DEFAULT_MAX_FONT_SIZE_MULTIPLIERS: Readonly<\n  Partial<Record<TextVariant, FontScalingCapValue>>\n> = Object.freeze(\n  Object.fromEntries(\n    Object.entries(TYPE_SCALE_CURVE).map(([variant, cap]) => [\n      variant,\n      cap === null ? MAX_SUPPORTED_FONT_SCALE : Math.min(cap, MAX_SUPPORTED_FONT_SCALE),\n    ]),\n  ) as Partial<Record<TextVariant, FontScalingCapValue>>,\n);\n\n/**\n * Default cap for control-internal text and icons (Button, Checkbox, Radio,\n * Switch, Chip, Tabs, Icon). Controls have bounded layouts, so they get the\n * supported ceiling rather than a looser per-variant cap.\n */\nconst DEFAULT_CONTROL_MAX_FONT_SIZE_MULTIPLIER = MAX_SUPPORTED_FONT_SCALE;\n\n/**\n * iOS Dynamic Type curve used by each UDS typography tier. React Native uses\n * the selected system text style's curve while preserving the configured UDS\n * font size. Android ignores `dynamicTypeRamp` and continues to use its native\n * nonlinear font scaling.\n *\n * Keys are base variants; `/emphasized` twins resolve to their base.\n */\nconst DEFAULT_DYNAMIC_TYPE_RAMPS: Readonly<\n  Partial<Record<TextVariant, NonNullable<RNTextProps['dynamicTypeRamp']>>>\n> = {\n  display1: 'largeTitle',\n  display2: 'largeTitle',\n  display3: 'largeTitle',\n  title1: 'title1',\n  title2: 'title2',\n  title3: 'title3',\n  title4: 'title3',\n  headline1: 'headline',\n  body1: 'body',\n  label1: 'callout',\n  label2: 'subheadline',\n  label3: 'footnote',\n  label4: 'caption1',\n  caption1: 'caption1',\n  caption2: 'caption2',\n  legal1: 'caption2',\n  ui1: 'title3',\n  ui2: 'title3',\n  ui3: 'callout',\n  ui4: 'subheadline',\n  ui5: 'footnote',\n  ui6: 'caption2',\n};\n\nexport {\n  DEFAULT_CONTROL_MAX_FONT_SIZE_MULTIPLIER,\n  DEFAULT_DYNAMIC_TYPE_RAMPS,\n  DEFAULT_MAX_FONT_SIZE_MULTIPLIERS,\n  MAX_SUPPORTED_FONT_SCALE,\n  TYPE_SCALE_CURVE,\n};\n"],"mappings":";;;;;;;;;;;;;AAgBA,MAAM,2BAA2B;;;;;;;;;;;;;;;AAgBjC,MAAM,mBAAgF;CACpF,UAAU;CACV,UAAU;CACV,UAAU;CACV,QAAQ;CACR,QAAQ;CACR,QAAQ;CACR,QAAQ;CACR,WAAW;CACX,KAAK;CACL,KAAK;CACL,OAAO;CACP,QAAQ;CACR,QAAQ;CACR,QAAQ;CACR,QAAQ;CACR,UAAU;CACV,UAAU;CACV,QAAQ;CACR,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACN;;;;;;;;AASD,MAAM,oCAEF,OAAO,OACT,OAAO,YACL,OAAO,QAAQ,iBAAiB,CAAC,KAAK,CAAC,SAAS,SAAS,CACvD,SACA,QAAQ,OAAA,IAAkC,KAAK,IAAI,KAAA,EAA8B,CAClF,CAAC,CACH,CACF;;;;;;AAOD,MAAM,2CAAA;;;;;;;;;AAUN,MAAM,6BAEF;CACF,UAAU;CACV,UAAU;CACV,UAAU;CACV,QAAQ;CACR,QAAQ;CACR,QAAQ;CACR,QAAQ;CACR,WAAW;CACX,OAAO;CACP,QAAQ;CACR,QAAQ;CACR,QAAQ;CACR,QAAQ;CACR,UAAU;CACV,UAAU;CACV,QAAQ;CACR,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACN"}
+{"version":3,"file":"constants.js","names":[],"sources":["../../src/fontScaling/constants.ts"],"sourcesContent":["import type { TextProps as RNTextProps } from 'react-native';\n\nimport type { TextVariant } from '../components/Text';\nimport type { FontScalingCapValue } from './types';\n\n/**\n * The largest OS font scale UDS components are designed to support.\n *\n * Yahoo's inclusive-design guidance is to solve for text scaling up to 2x, so\n * no default cap exceeds it. Apple's Accessibility Nutrition Label for Larger\n * Text is claimable at \"at least 200% or the maximum font size for the\n * system\", so a 2x ceiling still qualifies. Note that iOS offers scales beyond\n * this (up to 3.571x): with this ceiling in place the top accessibility sizes\n * render alike, and an app that wants to follow the OS further can raise or\n * remove the caps via `UDSFontScalingProvider`.\n */\nconst MAX_SUPPORTED_FONT_SCALE = 2;\n\n/**\n * How far each text style would grow if only legibility mattered, following\n * the shape of Apple's Dynamic Type ramps: the larger a style starts, the less\n * it multiplies. At iOS's largest accessibility size the system grows body\n * (17pt) by 3.12x but largeTitle (34pt) by only ~1.71x, and UDS display tiers\n * are larger than largeTitle, so they taper hardest.\n *\n * Caps are chosen by the size a style starts at rather than by which family it\n * belongs to, which is why `ui1` (24pt) matches `title3` (24pt) and `ui2`\n * (20pt) matches `title4` (20pt). `null` means \"no cap from the curve\" — those\n * are reading sizes, where legibility argues for following the OS.\n *\n * The exported defaults are this curve clamped to {@link MAX_SUPPORTED_FONT_SCALE}.\n */\nconst TYPE_SCALE_CURVE: Readonly<Partial<Record<TextVariant, FontScalingCapValue>>> = {\n  display1: 1.5,\n  display2: 1.6,\n  display3: 1.75,\n  title1: 1.8,\n  title2: 2,\n  title3: 2.2,\n  title4: 2.4,\n  headline1: 2.5,\n  ui1: 2.2,\n  ui2: 2.4,\n  body1: null,\n  label1: null,\n  label2: null,\n  label3: null,\n  label4: null,\n  caption1: null,\n  caption2: null,\n  legal1: null,\n  ui3: null,\n  ui4: null,\n  ui5: null,\n  ui6: null,\n};\n\n/**\n * Default per-variant caps on OS font scaling, applied by `Text` when no\n * explicit prop or provider config overrides them: the legibility curve in\n * {@link TYPE_SCALE_CURVE}, clamped to the 2x we support.\n *\n * Keys are base variants; `/emphasized` twins resolve to their base.\n */\nconst DEFAULT_MAX_FONT_SIZE_MULTIPLIERS: Readonly<\n  Partial<Record<TextVariant, FontScalingCapValue>>\n> = Object.freeze(\n  Object.fromEntries(\n    Object.entries(TYPE_SCALE_CURVE).map(([variant, cap]) => [\n      variant,\n      cap === null ? MAX_SUPPORTED_FONT_SCALE : Math.min(cap, MAX_SUPPORTED_FONT_SCALE),\n    ]),\n  ) as Partial<Record<TextVariant, FontScalingCapValue>>,\n);\n\n/**\n * Default cap for control-internal text, icons, and geometry (Button,\n * Checkbox, Radio, Switch, Chip, Tabs, Input, Select, Avatar, Pagination, and\n * Icon). Controls have bounded layouts, so they get the supported ceiling\n * rather than a looser per-variant cap.\n */\nconst DEFAULT_CONTROL_MAX_FONT_SIZE_MULTIPLIER = MAX_SUPPORTED_FONT_SCALE;\n\n/**\n * iOS Dynamic Type curve used by each UDS typography tier. React Native uses\n * the selected system text style's curve while preserving the configured UDS\n * font size. Android ignores `dynamicTypeRamp` and continues to use its native\n * nonlinear font scaling.\n *\n * Keys are base variants; `/emphasized` twins resolve to their base.\n */\nconst DEFAULT_DYNAMIC_TYPE_RAMPS: Readonly<\n  Partial<Record<TextVariant, NonNullable<RNTextProps['dynamicTypeRamp']>>>\n> = {\n  display1: 'largeTitle',\n  display2: 'largeTitle',\n  display3: 'largeTitle',\n  title1: 'title1',\n  title2: 'title2',\n  title3: 'title3',\n  title4: 'title3',\n  headline1: 'headline',\n  body1: 'body',\n  label1: 'callout',\n  label2: 'subheadline',\n  label3: 'footnote',\n  label4: 'caption1',\n  caption1: 'caption1',\n  caption2: 'caption2',\n  legal1: 'caption2',\n  ui1: 'title3',\n  ui2: 'title3',\n  ui3: 'callout',\n  ui4: 'subheadline',\n  ui5: 'footnote',\n  ui6: 'caption2',\n};\n\nexport {\n  DEFAULT_CONTROL_MAX_FONT_SIZE_MULTIPLIER,\n  DEFAULT_DYNAMIC_TYPE_RAMPS,\n  DEFAULT_MAX_FONT_SIZE_MULTIPLIERS,\n  MAX_SUPPORTED_FONT_SCALE,\n  TYPE_SCALE_CURVE,\n};\n"],"mappings":";;;;;;;;;;;;;AAgBA,MAAM,2BAA2B;;;;;;;;;;;;;;;AAgBjC,MAAM,mBAAgF;CACpF,UAAU;CACV,UAAU;CACV,UAAU;CACV,QAAQ;CACR,QAAQ;CACR,QAAQ;CACR,QAAQ;CACR,WAAW;CACX,KAAK;CACL,KAAK;CACL,OAAO;CACP,QAAQ;CACR,QAAQ;CACR,QAAQ;CACR,QAAQ;CACR,UAAU;CACV,UAAU;CACV,QAAQ;CACR,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACN;;;;;;;;AASD,MAAM,oCAEF,OAAO,OACT,OAAO,YACL,OAAO,QAAQ,iBAAiB,CAAC,KAAK,CAAC,SAAS,SAAS,CACvD,SACA,QAAQ,OAAA,IAAkC,KAAK,IAAI,KAAA,EAA8B,CAClF,CAAC,CACH,CACF;;;;;;;AAQD,MAAM,2CAAA;;;;;;;;;AAUN,MAAM,6BAEF;CACF,UAAU;CACV,UAAU;CACV,UAAU;CACV,QAAQ;CACR,QAAQ;CACR,QAAQ;CACR,QAAQ;CACR,WAAW;CACX,OAAO;CACP,QAAQ;CACR,QAAQ;CACR,QAAQ;CACR,QAAQ;CACR,UAAU;CACV,UAAU;CACV,QAAQ;CACR,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACN"}

package/dist/fontScaling/types.d.cts

@@ -21,9 +21,10 @@ type FontScalingCapValue = number | null;
  */
 interface FontScalingConfig {
   /**
-   * Master switch for UDS-applied caps. When `false`, no caps are applied
-   * anywhere and text follows native OS scaling. Container-metric fixes
-   * (Button/Checkbox growing to fit scaled text) remain active.
+   * Master switch for UDS-added font-scaling behavior. When `false`, native
+   * text keeps its pre-feature scaling behavior while UDS caps, Dynamic Type
+   * ramps, multicolor-icon scaling, and scale-aware geometry are disabled.
+   * Explicit component and native text props still apply.
    * @default true
    */
   enabled?: boolean;
@@ -35,9 +36,10 @@ interface FontScalingConfig {
    */
   default?: FontScalingCapValue;
   /**
-   * Cap for control-internal text, icons, and geometry in Button, Checkbox,
-   * Radio, Switch, Chip, and Tabs, plus standalone `Icon` glyphs and
-   * multicolor SVGs.
+   * Cap for control-internal text, icons, and geometry in Button, IconButton,
+   * Checkbox, Radio, Switch, Chip, Tabs, Input, Select, Avatar, and Pagination,
+   * plus standalone `Icon` glyphs and multicolor SVGs. Link resolves through
+   * its typography variant instead of the control cap.
    * @default 2
    */
   control?: FontScalingCapValue;

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.cts","names":[],"sources":["../../src/fontScaling/types.ts"],"mappings":";;;;;;AAAsD;;;;KAQjD,mBAAA;AAAmB;;;;;;;;;;AAAA,UAYd,iBAAA;EAOR;;;;;;EAAA,OAAA;EAmBmB;;;;;;EAZnB,OAAA,GAAU,mBAAA;;;;;;;EAOV,OAAA,GAAU,mBAAA;;;;;EAKV,QAAA,GAAW,OAAA,CAAQ,MAAA,CAAO,WAAA,EAAa,mBAAA;AAAA"}
+{"version":3,"file":"types.d.cts","names":[],"sources":["../../src/fontScaling/types.ts"],"mappings":";;;;;;AAAsD;;;;KAQjD,mBAAA;AAAmB;;;;;;;;;;AAAA,UAYd,iBAAA;EAQR;;;;;;;EAAA,OAAA;EAoB0B;;;;;;EAb1B,OAAA,GAAU,mBAAA;;;;;;;;EAQV,OAAA,GAAU,mBAAA;;;;;EAKV,QAAA,GAAW,OAAA,CAAQ,MAAA,CAAO,WAAA,EAAa,mBAAA;AAAA"}

package/dist/fontScaling/types.d.ts

@@ -21,9 +21,10 @@ type FontScalingCapValue = number | null;
  */
 interface FontScalingConfig {
   /**
-   * Master switch for UDS-applied caps. When `false`, no caps are applied
-   * anywhere and text follows native OS scaling. Container-metric fixes
-   * (Button/Checkbox growing to fit scaled text) remain active.
+   * Master switch for UDS-added font-scaling behavior. When `false`, native
+   * text keeps its pre-feature scaling behavior while UDS caps, Dynamic Type
+   * ramps, multicolor-icon scaling, and scale-aware geometry are disabled.
+   * Explicit component and native text props still apply.
    * @default true
    */
   enabled?: boolean;
@@ -35,9 +36,10 @@ interface FontScalingConfig {
    */
   default?: FontScalingCapValue;
   /**
-   * Cap for control-internal text, icons, and geometry in Button, Checkbox,
-   * Radio, Switch, Chip, and Tabs, plus standalone `Icon` glyphs and
-   * multicolor SVGs.
+   * Cap for control-internal text, icons, and geometry in Button, IconButton,
+   * Checkbox, Radio, Switch, Chip, Tabs, Input, Select, Avatar, and Pagination,
+   * plus standalone `Icon` glyphs and multicolor SVGs. Link resolves through
+   * its typography variant instead of the control cap.
    * @default 2
    */
   control?: FontScalingCapValue;

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","names":[],"sources":["../../src/fontScaling/types.ts"],"mappings":";;;;;;AAAsD;;;;KAQjD,mBAAA;AAAmB;;;;;;;;;;AAAA,UAYd,iBAAA;EAOR;;;;;;EAAA,OAAA;EAmBmB;;;;;;EAZnB,OAAA,GAAU,mBAAA;;;;;;;EAOV,OAAA,GAAU,mBAAA;;;;;EAKV,QAAA,GAAW,OAAA,CAAQ,MAAA,CAAO,WAAA,EAAa,mBAAA;AAAA"}
+{"version":3,"file":"types.d.ts","names":[],"sources":["../../src/fontScaling/types.ts"],"mappings":";;;;;;AAAsD;;;;KAQjD,mBAAA;AAAmB;;;;;;;;;;AAAA,UAYd,iBAAA;EAQR;;;;;;;EAAA,OAAA;EAoB0B;;;;;;EAb1B,OAAA,GAAU,mBAAA;;;;;;;;EAQV,OAAA,GAAU,mBAAA;;;;;EAKV,QAAA,GAAW,OAAA,CAAQ,MAAA,CAAO,WAAA,EAAa,mBAAA;AAAA"}

package/dist/fontScaling/useFontScale.cjs

@@ -1,6 +1,7 @@
 /*! © 2026 Yahoo, Inc. UDS Mobile v0.0.0-development */
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 require("../_virtual/_rolldown/runtime.cjs");
+const require_fontScaling_FontScalingContext = require("./FontScalingContext.cjs");
 const require_fontScaling_androidNonlinearFontScaling = require("./androidNonlinearFontScaling.cjs");
 let react = require("react");
 let react_native = require("react-native");
@@ -28,9 +29,12 @@ function getFontScale() {
 *
 * Subscribes to font-scale changes only — rotation does not re-render, and
 * components re-render solely when the user changes the OS text size.
+* Returns 1 when the nearest font-scaling provider has `enabled: false`.
 */
 function useFontScale(cap, fontSize) {
+	const enabled = require_fontScaling_FontScalingContext.useFontScalingEnabled();
 	const fontScale = (0, react.useSyncExternalStore)(subscribe, getFontScale, getFontScale);
+	if (!enabled) return 1;
 	const effectiveCap = typeof cap === "number" && cap >= 1 ? cap : Number.POSITIVE_INFINITY;
 	const cappedFontScale = Math.min(fontScale, effectiveCap);
 	const platformVersion = Number(react_native.Platform.Version);

package/dist/fontScaling/useFontScale.d.cts

@@ -16,6 +16,7 @@
  *
  * Subscribes to font-scale changes only — rotation does not re-render, and
  * components re-render solely when the user changes the OS text size.
+ * Returns 1 when the nearest font-scaling provider has `enabled: false`.
  */
 declare function useFontScale(cap?: number | null, fontSize?: number): number;
 //#endregion

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

@@ -1 +1 @@
-{"version":3,"file":"useFontScale.d.cts","names":[],"sources":["../../src/fontScaling/useFontScale.ts"],"mappings":";;;;;;;;;;;;;;;;;;;iBAiCS,YAAA,CAAa,GAAA,kBAAqB,QAAA"}
+{"version":3,"file":"useFontScale.d.cts","names":[],"sources":["../../src/fontScaling/useFontScale.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;iBAmCS,YAAA,CAAa,GAAA,kBAAqB,QAAA"}

package/dist/fontScaling/useFontScale.d.ts

@@ -16,6 +16,7 @@
  *
  * Subscribes to font-scale changes only — rotation does not re-render, and
  * components re-render solely when the user changes the OS text size.
+ * Returns 1 when the nearest font-scaling provider has `enabled: false`.
  */
 declare function useFontScale(cap?: number | null, fontSize?: number): number;
 //#endregion

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

@@ -1 +1 @@
-{"version":3,"file":"useFontScale.d.ts","names":[],"sources":["../../src/fontScaling/useFontScale.ts"],"mappings":";;;;;;;;;;;;;;;;;;;iBAiCS,YAAA,CAAa,GAAA,kBAAqB,QAAA"}
+{"version":3,"file":"useFontScale.d.ts","names":[],"sources":["../../src/fontScaling/useFontScale.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;iBAmCS,YAAA,CAAa,GAAA,kBAAqB,QAAA"}

package/dist/fontScaling/useFontScale.js

@@ -1,4 +1,5 @@
 /*! © 2026 Yahoo, Inc. UDS Mobile v0.0.0-development */
+import { useFontScalingEnabled } from "./FontScalingContext.js";
 import { convertAndroidSpToDp } from "./androidNonlinearFontScaling.js";
 import { useSyncExternalStore } from "react";
 import { Dimensions, Platform } from "react-native";
@@ -26,9 +27,12 @@ function getFontScale() {
 *
 * Subscribes to font-scale changes only — rotation does not re-render, and
 * components re-render solely when the user changes the OS text size.
+* Returns 1 when the nearest font-scaling provider has `enabled: false`.
 */
 function useFontScale(cap, fontSize) {
+	const enabled = useFontScalingEnabled();
 	const fontScale = useSyncExternalStore(subscribe, getFontScale, getFontScale);
+	if (!enabled) return 1;
 	const effectiveCap = typeof cap === "number" && cap >= 1 ? cap : Number.POSITIVE_INFINITY;
 	const cappedFontScale = Math.min(fontScale, effectiveCap);
 	const platformVersion = Number(Platform.Version);

package/dist/fontScaling/useFontScale.js.map

@@ -1 +1 @@
-{"version":3,"file":"useFontScale.js","names":[],"sources":["../../src/fontScaling/useFontScale.ts"],"sourcesContent":["import { useSyncExternalStore } from 'react';\nimport { Dimensions, Platform } from 'react-native';\n\nimport { convertAndroidSpToDp } from './androidNonlinearFontScaling';\n\nfunction subscribe(onStoreChange: () => void): () => void {\n  const subscription = Dimensions.addEventListener('change', onStoreChange);\n  return () => subscription.remove();\n}\n\n// Unistyles' rt.fontScale is stale when the OS text size changes while the\n// app is running; Dimensions reflects the live value on both platforms.\nfunction getFontScale(): number {\n  return Dimensions.get('window').fontScale;\n}\n\n/**\n * The effective scale for `fontSize`, clamped to `[1, cap]`, for sizing\n * containers around scaled text (e.g. a checkbox box growing with its\n * checkmark).\n *\n * `cap` uses the same semantics as `maxFontSizeMultiplier`: a number >= 1\n * caps the scale; `null`, `0`, or `undefined` leave it uncapped. The result\n * is never below 1 so containers never shrink under their token metrics\n * (font scales < 1 shrink text only, as today).\n *\n * Pass the SP size that the geometry accompanies on Android so this mirrors\n * Android 14+'s nonlinear scaling. Omitting `fontSize` preserves the legacy\n * scalar behavior for custom callers that do not know their base size.\n *\n * Subscribes to font-scale changes only — rotation does not re-render, and\n * components re-render solely when the user changes the OS text size.\n */\nfunction useFontScale(cap?: number | null, fontSize?: number): number {\n  const fontScale = useSyncExternalStore(subscribe, getFontScale, getFontScale);\n  const effectiveCap = typeof cap === 'number' && cap >= 1 ? cap : Number.POSITIVE_INFINITY;\n  const cappedFontScale = Math.min(fontScale, effectiveCap);\n  const platformVersion = Number(Platform.Version);\n  const nativeScale =\n    Platform.OS === 'android' &&\n    platformVersion >= 34 &&\n    typeof fontSize === 'number' &&\n    fontSize > 0\n      ? convertAndroidSpToDp(fontSize, cappedFontScale) / fontSize\n      : cappedFontScale;\n\n  return Math.max(1, nativeScale);\n}\n\nexport { useFontScale };\n"],"mappings":";;;;;AAKA,SAAS,UAAU,eAAuC;CACxD,MAAM,eAAe,WAAW,iBAAiB,UAAU,cAAc;CACzE,aAAa,aAAa,QAAQ;;AAKpC,SAAS,eAAuB;CAC9B,OAAO,WAAW,IAAI,SAAS,CAAC;;;;;;;;;;;;;;;;;;;AAoBlC,SAAS,aAAa,KAAqB,UAA2B;CACpE,MAAM,YAAY,qBAAqB,WAAW,cAAc,aAAa;CAC7E,MAAM,eAAe,OAAO,QAAQ,YAAY,OAAO,IAAI,MAAM,OAAO;CACxE,MAAM,kBAAkB,KAAK,IAAI,WAAW,aAAa;CACzD,MAAM,kBAAkB,OAAO,SAAS,QAAQ;CAChD,MAAM,cACJ,SAAS,OAAO,aAChB,mBAAmB,MACnB,OAAO,aAAa,YACpB,WAAW,IACP,qBAAqB,UAAU,gBAAgB,GAAG,WAClD;CAEN,OAAO,KAAK,IAAI,GAAG,YAAY"}
+{"version":3,"file":"useFontScale.js","names":[],"sources":["../../src/fontScaling/useFontScale.ts"],"sourcesContent":["import { useSyncExternalStore } from 'react';\nimport { Dimensions, Platform } from 'react-native';\n\nimport { convertAndroidSpToDp } from './androidNonlinearFontScaling';\nimport { useFontScalingEnabled } from './FontScalingContext';\n\nfunction subscribe(onStoreChange: () => void): () => void {\n  const subscription = Dimensions.addEventListener('change', onStoreChange);\n  return () => subscription.remove();\n}\n\n// Unistyles' rt.fontScale is stale when the OS text size changes while the\n// app is running; Dimensions reflects the live value on both platforms.\nfunction getFontScale(): number {\n  return Dimensions.get('window').fontScale;\n}\n\n/**\n * The effective scale for `fontSize`, clamped to `[1, cap]`, for sizing\n * containers around scaled text (e.g. a checkbox box growing with its\n * checkmark).\n *\n * `cap` uses the same semantics as `maxFontSizeMultiplier`: a number >= 1\n * caps the scale; `null`, `0`, or `undefined` leave it uncapped. The result\n * is never below 1 so containers never shrink under their token metrics\n * (font scales < 1 shrink text only, as today).\n *\n * Pass the SP size that the geometry accompanies on Android so this mirrors\n * Android 14+'s nonlinear scaling. Omitting `fontSize` preserves the legacy\n * scalar behavior for custom callers that do not know their base size.\n *\n * Subscribes to font-scale changes only — rotation does not re-render, and\n * components re-render solely when the user changes the OS text size.\n * Returns 1 when the nearest font-scaling provider has `enabled: false`.\n */\nfunction useFontScale(cap?: number | null, fontSize?: number): number {\n  const enabled = useFontScalingEnabled();\n  const fontScale = useSyncExternalStore(subscribe, getFontScale, getFontScale);\n  if (!enabled) {\n    return 1;\n  }\n\n  const effectiveCap = typeof cap === 'number' && cap >= 1 ? cap : Number.POSITIVE_INFINITY;\n  const cappedFontScale = Math.min(fontScale, effectiveCap);\n  const platformVersion = Number(Platform.Version);\n  const nativeScale =\n    Platform.OS === 'android' &&\n    platformVersion >= 34 &&\n    typeof fontSize === 'number' &&\n    fontSize > 0\n      ? convertAndroidSpToDp(fontSize, cappedFontScale) / fontSize\n      : cappedFontScale;\n\n  return Math.max(1, nativeScale);\n}\n\nexport { useFontScale };\n"],"mappings":";;;;;;AAMA,SAAS,UAAU,eAAuC;CACxD,MAAM,eAAe,WAAW,iBAAiB,UAAU,cAAc;CACzE,aAAa,aAAa,QAAQ;;AAKpC,SAAS,eAAuB;CAC9B,OAAO,WAAW,IAAI,SAAS,CAAC;;;;;;;;;;;;;;;;;;;;AAqBlC,SAAS,aAAa,KAAqB,UAA2B;CACpE,MAAM,UAAU,uBAAuB;CACvC,MAAM,YAAY,qBAAqB,WAAW,cAAc,aAAa;CAC7E,IAAI,CAAC,SACH,OAAO;CAGT,MAAM,eAAe,OAAO,QAAQ,YAAY,OAAO,IAAI,MAAM,OAAO;CACxE,MAAM,kBAAkB,KAAK,IAAI,WAAW,aAAa;CACzD,MAAM,kBAAkB,OAAO,SAAS,QAAQ;CAChD,MAAM,cACJ,SAAS,OAAO,aAChB,mBAAmB,MACnB,OAAO,aAAa,YACpB,WAAW,IACP,qBAAqB,UAAU,gBAAgB,GAAG,WAClD;CAEN,OAAO,KAAK,IAAI,GAAG,YAAY"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yahoo/uds-mobile",
-  "version": "2.24.0-beta.6",
+  "version": "2.24.0-beta.8",
   "type": "module",
   "bin": {
     "uds-mobile": "./cli/uds-mobile.js"