@yahoo/uds-mobile 2.24.0-beta.1 → 2.24.0-beta.10

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

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

package/dist/fontScaling/androidNonlinearFontScaling.js

@@ -0,0 +1,251 @@
+/*! © 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`. Android 14
+* shipped fewer preference curves than Android 15+, so callers must provide the
+* platform version to select the same table native Text uses. 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
+* @see https://android.googlesource.com/platform/prebuilts/fullsdk/sources/+/refs/heads/androidx-compose-integration-release/android-34/android/content/res/FontScaleConverterFactory.java
+*/
+const COMMON_SP_SIZES = [
+	8,
+	10,
+	12,
+	14,
+	18,
+	20,
+	24,
+	30,
+	100
+];
+const ANDROID_14_FONT_SCALE_CURVES = [
+	{
+		scale: 1.15,
+		dp: [
+			9.2,
+			11.5,
+			13.8,
+			16.4,
+			19.8,
+			21.8,
+			25.2,
+			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
+		]
+	}
+];
+const ANDROID_15_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 the nonlinear DP size used by this Android API level. */
+function convertAndroidSpToDp(fontSize, fontScale, platformVersion = 35) {
+	const curves = platformVersion === 34 ? ANDROID_14_FONT_SCALE_CURVES : ANDROID_15_FONT_SCALE_CURVES;
+	const firstCurve = curves[0];
+	const lastCurve = curves[curves.length - 1];
+	if (fontScale < firstCurve.scale || fontScale > lastCurve.scale) return fontSize * fontScale;
+	for (let index = 0; index < curves.length; index += 1) {
+		const curve = curves[index];
+		if (fontScale === curve.scale) return interpolateSize(fontSize, curve.dp);
+		if (fontScale < curve.scale) {
+			const previousCurve = 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`. Android 14\n * shipped fewer preference curves than Android 15+, so callers must provide the\n * platform version to select the same table native Text uses. 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 * @see https://android.googlesource.com/platform/prebuilts/fullsdk/sources/+/refs/heads/androidx-compose-integration-release/android-34/android/content/res/FontScaleConverterFactory.java\n */\nconst COMMON_SP_SIZES = [8, 10, 12, 14, 18, 20, 24, 30, 100] as const;\n\nconst ANDROID_14_FONT_SCALE_CURVES = [\n  { scale: 1.15, dp: [9.2, 11.5, 13.8, 16.4, 19.8, 21.8, 25.2, 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\nconst ANDROID_15_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 the nonlinear DP size used by this Android API level. */\nfunction convertAndroidSpToDp(\n  fontSize: number,\n  fontScale: number,\n  platformVersion: number = 35,\n): number {\n  const curves =\n    platformVersion === 34 ? ANDROID_14_FONT_SCALE_CURVES : ANDROID_15_FONT_SCALE_CURVES;\n  const firstCurve = curves[0];\n  const lastCurve = curves[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 < curves.length; index += 1) {\n    const curve = curves[index];\n    if (fontScale === curve.scale) {\n      return interpolateSize(fontSize, curve.dp);\n    }\n    if (fontScale < curve.scale) {\n      const previousCurve = 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":"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"}

package/dist/fontScaling/constants.cjs

@@ -60,13 +60,47 @@ 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;
+/**
+* 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;

package/dist/fontScaling/constants.d.cts

@@ -1,6 +1,7 @@
 
 import { TextVariant } from "../components/Text.cjs";
 import { FontScalingCapValue } from "./types.cjs";
+import { TextProps } from "react-native";
 
 //#region src/fontScaling/constants.d.ts
 /**
@@ -39,11 +40,21 @@ 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;
+/**
+ * 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.
+ */
+declare const DEFAULT_DYNAMIC_TYPE_RAMPS: Readonly<Partial<Record<TextVariant, NonNullable<TextProps['dynamicTypeRamp']>>>>;
 //#endregion
-export { DEFAULT_CONTROL_MAX_FONT_SIZE_MULTIPLIER, DEFAULT_MAX_FONT_SIZE_MULTIPLIERS, MAX_SUPPORTED_FONT_SCALE, TYPE_SCALE_CURVE };
+export { DEFAULT_CONTROL_MAX_FONT_SIZE_MULTIPLIER, DEFAULT_DYNAMIC_TYPE_RAMPS, DEFAULT_MAX_FONT_SIZE_MULTIPLIERS, MAX_SUPPORTED_FONT_SCALE, TYPE_SCALE_CURVE };
 //# sourceMappingURL=constants.d.cts.map

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

@@ -1 +1 @@
-{"version":3,"file":"constants.d.cts","names":[],"sources":["../../src/fontScaling/constants.ts"],"mappings":";;;;;;;AACmD;;;;;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"}
+{"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

@@ -1,6 +1,7 @@
 
 import { TextVariant } from "../components/Text.js";
 import { FontScalingCapValue } from "./types.js";
+import { TextProps } from "react-native";
 
 //#region src/fontScaling/constants.d.ts
 /**
@@ -39,11 +40,21 @@ 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;
+/**
+ * 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.
+ */
+declare const DEFAULT_DYNAMIC_TYPE_RAMPS: Readonly<Partial<Record<TextVariant, NonNullable<TextProps['dynamicTypeRamp']>>>>;
 //#endregion
-export { DEFAULT_CONTROL_MAX_FONT_SIZE_MULTIPLIER, DEFAULT_MAX_FONT_SIZE_MULTIPLIERS, MAX_SUPPORTED_FONT_SCALE, TYPE_SCALE_CURVE };
+export { DEFAULT_CONTROL_MAX_FONT_SIZE_MULTIPLIER, DEFAULT_DYNAMIC_TYPE_RAMPS, DEFAULT_MAX_FONT_SIZE_MULTIPLIERS, MAX_SUPPORTED_FONT_SCALE, TYPE_SCALE_CURVE };
 //# sourceMappingURL=constants.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","names":[],"sources":["../../src/fontScaling/constants.ts"],"mappings":";;;;;;;AACmD;;;;;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"}
+{"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,12 +59,45 @@ 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;
+/**
+* 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
-export { DEFAULT_CONTROL_MAX_FONT_SIZE_MULTIPLIER, DEFAULT_MAX_FONT_SIZE_MULTIPLIERS, MAX_SUPPORTED_FONT_SCALE, TYPE_SCALE_CURVE };
+export { DEFAULT_CONTROL_MAX_FONT_SIZE_MULTIPLIER, DEFAULT_DYNAMIC_TYPE_RAMPS, DEFAULT_MAX_FONT_SIZE_MULTIPLIERS, MAX_SUPPORTED_FONT_SCALE, TYPE_SCALE_CURVE };
 
 //# sourceMappingURL=constants.js.map

package/dist/fontScaling/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","names":[],"sources":["../../src/fontScaling/constants.ts"],"sourcesContent":["import 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\nexport {\n  DEFAULT_CONTROL_MAX_FONT_SIZE_MULTIPLIER,\n  DEFAULT_MAX_FONT_SIZE_MULTIPLIERS,\n  MAX_SUPPORTED_FONT_SCALE,\n  TYPE_SCALE_CURVE,\n};\n"],"mappings":";;;;;;;;;;;;;AAcA,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"}
+{"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/index.cjs

@@ -1,10 +1,11 @@
 /*! © 2026 Yahoo, Inc. UDS Mobile v0.0.0-development */
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_fontScaling_FontScalingContext = require("./FontScalingContext.cjs");
+const require_fontScaling_useFontScale = require("./useFontScale.cjs");
 const require_fontScaling_constants = require("./constants.cjs");
 const require_fontScaling_useMaxFontSizeMultiplier = require("./useMaxFontSizeMultiplier.cjs");
-const require_fontScaling_useFontScale = require("./useFontScale.cjs");
 exports.DEFAULT_CONTROL_MAX_FONT_SIZE_MULTIPLIER = require_fontScaling_constants.DEFAULT_CONTROL_MAX_FONT_SIZE_MULTIPLIER;
+exports.DEFAULT_DYNAMIC_TYPE_RAMPS = require_fontScaling_constants.DEFAULT_DYNAMIC_TYPE_RAMPS;
 exports.DEFAULT_MAX_FONT_SIZE_MULTIPLIERS = require_fontScaling_constants.DEFAULT_MAX_FONT_SIZE_MULTIPLIERS;
 exports.MAX_SUPPORTED_FONT_SCALE = require_fontScaling_constants.MAX_SUPPORTED_FONT_SCALE;
 exports.TYPE_SCALE_CURVE = require_fontScaling_constants.TYPE_SCALE_CURVE;

package/dist/fontScaling/index.d.cts

@@ -2,7 +2,7 @@
 import { TextVariant } from "../components/Text.cjs";
 import { FontScalingCapValue, FontScalingConfig } from "./types.cjs";
 import { UDSFontScalingProvider, UDSFontScalingProviderProps } from "./FontScalingContext.cjs";
-import { DEFAULT_CONTROL_MAX_FONT_SIZE_MULTIPLIER, DEFAULT_MAX_FONT_SIZE_MULTIPLIERS, MAX_SUPPORTED_FONT_SCALE, TYPE_SCALE_CURVE } from "./constants.cjs";
+import { DEFAULT_CONTROL_MAX_FONT_SIZE_MULTIPLIER, DEFAULT_DYNAMIC_TYPE_RAMPS, DEFAULT_MAX_FONT_SIZE_MULTIPLIERS, MAX_SUPPORTED_FONT_SCALE, TYPE_SCALE_CURVE } from "./constants.cjs";
 import { useFontScale } from "./useFontScale.cjs";
 import { useMaxFontSizeMultiplier } from "./useMaxFontSizeMultiplier.cjs";
-export { DEFAULT_CONTROL_MAX_FONT_SIZE_MULTIPLIER, DEFAULT_MAX_FONT_SIZE_MULTIPLIERS, type FontScalingCapValue, type FontScalingConfig, MAX_SUPPORTED_FONT_SCALE, TYPE_SCALE_CURVE, type TextVariant, UDSFontScalingProvider, type UDSFontScalingProviderProps, useFontScale, useMaxFontSizeMultiplier };
+export { DEFAULT_CONTROL_MAX_FONT_SIZE_MULTIPLIER, DEFAULT_DYNAMIC_TYPE_RAMPS, DEFAULT_MAX_FONT_SIZE_MULTIPLIERS, type FontScalingCapValue, type FontScalingConfig, MAX_SUPPORTED_FONT_SCALE, TYPE_SCALE_CURVE, type TextVariant, UDSFontScalingProvider, type UDSFontScalingProviderProps, useFontScale, useMaxFontSizeMultiplier };

package/dist/fontScaling/index.d.ts

@@ -2,7 +2,7 @@
 import { TextVariant } from "../components/Text.js";
 import { FontScalingCapValue, FontScalingConfig } from "./types.js";
 import { UDSFontScalingProvider, UDSFontScalingProviderProps } from "./FontScalingContext.js";
-import { DEFAULT_CONTROL_MAX_FONT_SIZE_MULTIPLIER, DEFAULT_MAX_FONT_SIZE_MULTIPLIERS, MAX_SUPPORTED_FONT_SCALE, TYPE_SCALE_CURVE } from "./constants.js";
+import { DEFAULT_CONTROL_MAX_FONT_SIZE_MULTIPLIER, DEFAULT_DYNAMIC_TYPE_RAMPS, DEFAULT_MAX_FONT_SIZE_MULTIPLIERS, MAX_SUPPORTED_FONT_SCALE, TYPE_SCALE_CURVE } from "./constants.js";
 import { useFontScale } from "./useFontScale.js";
 import { useMaxFontSizeMultiplier } from "./useMaxFontSizeMultiplier.js";
-export { DEFAULT_CONTROL_MAX_FONT_SIZE_MULTIPLIER, DEFAULT_MAX_FONT_SIZE_MULTIPLIERS, type FontScalingCapValue, type FontScalingConfig, MAX_SUPPORTED_FONT_SCALE, TYPE_SCALE_CURVE, type TextVariant, UDSFontScalingProvider, type UDSFontScalingProviderProps, useFontScale, useMaxFontSizeMultiplier };
+export { DEFAULT_CONTROL_MAX_FONT_SIZE_MULTIPLIER, DEFAULT_DYNAMIC_TYPE_RAMPS, DEFAULT_MAX_FONT_SIZE_MULTIPLIERS, type FontScalingCapValue, type FontScalingConfig, MAX_SUPPORTED_FONT_SCALE, TYPE_SCALE_CURVE, type TextVariant, UDSFontScalingProvider, type UDSFontScalingProviderProps, useFontScale, useMaxFontSizeMultiplier };

package/dist/fontScaling/index.js

@@ -1,6 +1,6 @@
 /*! © 2026 Yahoo, Inc. UDS Mobile v0.0.0-development */
 import { UDSFontScalingProvider } from "./FontScalingContext.js";
-import { DEFAULT_CONTROL_MAX_FONT_SIZE_MULTIPLIER, DEFAULT_MAX_FONT_SIZE_MULTIPLIERS, MAX_SUPPORTED_FONT_SCALE, TYPE_SCALE_CURVE } from "./constants.js";
-import { useMaxFontSizeMultiplier } from "./useMaxFontSizeMultiplier.js";
 import { useFontScale } from "./useFontScale.js";
-export { DEFAULT_CONTROL_MAX_FONT_SIZE_MULTIPLIER, DEFAULT_MAX_FONT_SIZE_MULTIPLIERS, MAX_SUPPORTED_FONT_SCALE, TYPE_SCALE_CURVE, UDSFontScalingProvider, useFontScale, useMaxFontSizeMultiplier };
+import { DEFAULT_CONTROL_MAX_FONT_SIZE_MULTIPLIER, DEFAULT_DYNAMIC_TYPE_RAMPS, DEFAULT_MAX_FONT_SIZE_MULTIPLIERS, MAX_SUPPORTED_FONT_SCALE, TYPE_SCALE_CURVE } from "./constants.js";
+import { useMaxFontSizeMultiplier } from "./useMaxFontSizeMultiplier.js";
+export { DEFAULT_CONTROL_MAX_FONT_SIZE_MULTIPLIER, DEFAULT_DYNAMIC_TYPE_RAMPS, DEFAULT_MAX_FONT_SIZE_MULTIPLIERS, MAX_SUPPORTED_FONT_SCALE, TYPE_SCALE_CURVE, UDSFontScalingProvider, useFontScale, useMaxFontSizeMultiplier };

package/dist/fontScaling/resolveMaxFontSizeMultiplier.cjs

@@ -13,8 +13,7 @@ function toResolved(cap) {
 * entry, then `default`) > built-in default table.
 *
 * Returns `undefined` (native behavior: inherit from parent text or app
-* global) when nothing applies — including for built-in uncapped variants, so
-* body text nested inside capped text still inherits the parent's cap. Only an
+* global) when nothing applies, including for `variant="inherit"`. Only an
 * explicit `null` (prop or provider) maps to `0`, RN's force-uncap value.
 */
 function resolveMaxFontSizeMultiplier({ explicit, config, variant }) {

package/dist/fontScaling/resolveMaxFontSizeMultiplier.d.cts

@@ -22,8 +22,7 @@ interface ResolveMaxFontSizeMultiplierOptions {
  * entry, then `default`) > built-in default table.
  *
  * Returns `undefined` (native behavior: inherit from parent text or app
- * global) when nothing applies — including for built-in uncapped variants, so
- * body text nested inside capped text still inherits the parent's cap. Only an
+ * global) when nothing applies, including for `variant="inherit"`. Only an
  * explicit `null` (prop or provider) maps to `0`, RN's force-uncap value.
  */
 declare function resolveMaxFontSizeMultiplier({

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

@@ -1 +1 @@
-{"version":3,"file":"resolveMaxFontSizeMultiplier.d.cts","names":[],"sources":["../../src/fontScaling/resolveMaxFontSizeMultiplier.ts"],"mappings":";;;;;UAWU,mCAAA;;EAER,QAAA;EAF2C;EAI3C,MAAA,GAAS,iBAAA;EAMY;;;;;EAArB,OAAA,GAAU,WAAA;AAAA;;AAAW;;;;;;;;;;iBAkBd,4BAAA,CAAA;EACP,QAAA;EACA,MAAA;EACA;AAAA,GACC,mCAAA"}
+{"version":3,"file":"resolveMaxFontSizeMultiplier.d.cts","names":[],"sources":["../../src/fontScaling/resolveMaxFontSizeMultiplier.ts"],"mappings":";;;;;UAWU,mCAAA;;EAER,QAAA;EAF2C;EAI3C,MAAA,GAAS,iBAAA;EAMY;;;;;EAArB,OAAA,GAAU,WAAA;AAAA;;AAAW;;;;;;;;;iBAiBd,4BAAA,CAAA;EACP,QAAA;EACA,MAAA;EACA;AAAA,GACC,mCAAA"}

package/dist/fontScaling/resolveMaxFontSizeMultiplier.d.ts

@@ -22,8 +22,7 @@ interface ResolveMaxFontSizeMultiplierOptions {
  * entry, then `default`) > built-in default table.
  *
  * Returns `undefined` (native behavior: inherit from parent text or app
- * global) when nothing applies — including for built-in uncapped variants, so
- * body text nested inside capped text still inherits the parent's cap. Only an
+ * global) when nothing applies, including for `variant="inherit"`. Only an
  * explicit `null` (prop or provider) maps to `0`, RN's force-uncap value.
  */
 declare function resolveMaxFontSizeMultiplier({

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

@@ -1 +1 @@
-{"version":3,"file":"resolveMaxFontSizeMultiplier.d.ts","names":[],"sources":["../../src/fontScaling/resolveMaxFontSizeMultiplier.ts"],"mappings":";;;;;UAWU,mCAAA;;EAER,QAAA;EAF2C;EAI3C,MAAA,GAAS,iBAAA;EAMY;;;;;EAArB,OAAA,GAAU,WAAA;AAAA;;AAAW;;;;;;;;;;iBAkBd,4BAAA,CAAA;EACP,QAAA;EACA,MAAA;EACA;AAAA,GACC,mCAAA"}
+{"version":3,"file":"resolveMaxFontSizeMultiplier.d.ts","names":[],"sources":["../../src/fontScaling/resolveMaxFontSizeMultiplier.ts"],"mappings":";;;;;UAWU,mCAAA;;EAER,QAAA;EAF2C;EAI3C,MAAA,GAAS,iBAAA;EAMY;;;;;EAArB,OAAA,GAAU,WAAA;AAAA;;AAAW;;;;;;;;;iBAiBd,4BAAA,CAAA;EACP,QAAA;EACA,MAAA;EACA;AAAA,GACC,mCAAA"}

package/dist/fontScaling/resolveMaxFontSizeMultiplier.js

@@ -12,8 +12,7 @@ function toResolved(cap) {
 * entry, then `default`) > built-in default table.
 *
 * Returns `undefined` (native behavior: inherit from parent text or app
-* global) when nothing applies — including for built-in uncapped variants, so
-* body text nested inside capped text still inherits the parent's cap. Only an
+* global) when nothing applies, including for `variant="inherit"`. Only an
 * explicit `null` (prop or provider) maps to `0`, RN's force-uncap value.
 */
 function resolveMaxFontSizeMultiplier({ explicit, config, variant }) {

package/dist/fontScaling/resolveMaxFontSizeMultiplier.js.map

@@ -1 +1 @@
-{"version":3,"file":"resolveMaxFontSizeMultiplier.js","names":[],"sources":["../../src/fontScaling/resolveMaxFontSizeMultiplier.ts"],"sourcesContent":["import type { TextVariant } from '../components/Text';\nimport {\n  DEFAULT_CONTROL_MAX_FONT_SIZE_MULTIPLIER,\n  DEFAULT_MAX_FONT_SIZE_MULTIPLIERS,\n} from './constants';\nimport type { FontScalingCapValue, FontScalingConfig } from './types';\n\n// React Native: maxFontSizeMultiplier of 0 means \"no max, ignore parent/global\n// default\" — the only way to force-uncap text nested inside capped text.\nconst UNCAPPED = 0;\n\ninterface ResolveMaxFontSizeMultiplierOptions {\n  /** Explicit component prop. `null` = force-uncap. Wins over everything. */\n  explicit?: number | null;\n  /** Provider config, if any provider is mounted. */\n  config?: FontScalingConfig;\n  /**\n   * The text's resolved variant, `'control'` for control-internal text/icons,\n   * or `undefined` for `variant=\"inherit\"` text (no variant opinion — nested\n   * text inherits its parent's cap natively).\n   */\n  variant?: TextVariant | 'control';\n}\n\nfunction toResolved(cap: FontScalingCapValue): number {\n  return cap === null ? UNCAPPED : cap;\n}\n\n/**\n * Resolves the `maxFontSizeMultiplier` to hand to React Native.\n *\n * Precedence: explicit prop > provider config (variant entry, then base-variant\n * entry, then `default`) > built-in default table.\n *\n * Returns `undefined` (native behavior: inherit from parent text or app\n * global) when nothing applies — including for built-in uncapped variants, so\n * body text nested inside capped text still inherits the parent's cap. Only an\n * explicit `null` (prop or provider) maps to `0`, RN's force-uncap value.\n */\nfunction resolveMaxFontSizeMultiplier({\n  explicit,\n  config,\n  variant,\n}: ResolveMaxFontSizeMultiplierOptions): number | undefined {\n  if (explicit !== undefined) {\n    return toResolved(explicit);\n  }\n\n  if (config?.enabled === false) {\n    return undefined;\n  }\n\n  if (variant === undefined) {\n    return config?.default !== undefined ? toResolved(config.default) : undefined;\n  }\n\n  if (variant === 'control') {\n    if (config?.control !== undefined) {\n      return toResolved(config.control);\n    }\n    return DEFAULT_CONTROL_MAX_FONT_SIZE_MULTIPLIER;\n  }\n\n  const baseVariant = variant.split('/')[0] as TextVariant;\n\n  const variantCap = config?.variants?.[variant];\n  if (variantCap !== undefined) {\n    return toResolved(variantCap);\n  }\n  const baseVariantCap = config?.variants?.[baseVariant];\n  if (baseVariantCap !== undefined) {\n    return toResolved(baseVariantCap);\n  }\n  if (config?.default !== undefined) {\n    return toResolved(config.default);\n  }\n\n  // Future: a theme-level typography[variant].maxFontSizeMultiplier slots here.\n\n  const builtIn =\n    DEFAULT_MAX_FONT_SIZE_MULTIPLIERS[variant] ?? DEFAULT_MAX_FONT_SIZE_MULTIPLIERS[baseVariant];\n  return typeof builtIn === 'number' ? builtIn : undefined;\n}\n\nexport { resolveMaxFontSizeMultiplier, type ResolveMaxFontSizeMultiplierOptions };\n"],"mappings":";;;AASA,MAAM,WAAW;AAejB,SAAS,WAAW,KAAkC;CACpD,OAAO,QAAQ,OAAO,WAAW;;;;;;;;;;;;;AAcnC,SAAS,6BAA6B,EACpC,UACA,QACA,WAC0D;CAC1D,IAAI,aAAa,KAAA,GACf,OAAO,WAAW,SAAS;CAG7B,IAAI,QAAQ,YAAY,OACtB;CAGF,IAAI,YAAY,KAAA,GACd,OAAO,QAAQ,YAAY,KAAA,IAAY,WAAW,OAAO,QAAQ,GAAG,KAAA;CAGtE,IAAI,YAAY,WAAW;EACzB,IAAI,QAAQ,YAAY,KAAA,GACtB,OAAO,WAAW,OAAO,QAAQ;EAEnC,OAAA;;CAGF,MAAM,cAAc,QAAQ,MAAM,IAAI,CAAC;CAEvC,MAAM,aAAa,QAAQ,WAAW;CACtC,IAAI,eAAe,KAAA,GACjB,OAAO,WAAW,WAAW;CAE/B,MAAM,iBAAiB,QAAQ,WAAW;CAC1C,IAAI,mBAAmB,KAAA,GACrB,OAAO,WAAW,eAAe;CAEnC,IAAI,QAAQ,YAAY,KAAA,GACtB,OAAO,WAAW,OAAO,QAAQ;CAKnC,MAAM,UACJ,kCAAkC,YAAY,kCAAkC;CAClF,OAAO,OAAO,YAAY,WAAW,UAAU,KAAA"}
+{"version":3,"file":"resolveMaxFontSizeMultiplier.js","names":[],"sources":["../../src/fontScaling/resolveMaxFontSizeMultiplier.ts"],"sourcesContent":["import type { TextVariant } from '../components/Text';\nimport {\n  DEFAULT_CONTROL_MAX_FONT_SIZE_MULTIPLIER,\n  DEFAULT_MAX_FONT_SIZE_MULTIPLIERS,\n} from './constants';\nimport type { FontScalingCapValue, FontScalingConfig } from './types';\n\n// React Native: maxFontSizeMultiplier of 0 means \"no max, ignore parent/global\n// default\" — the only way to force-uncap text nested inside capped text.\nconst UNCAPPED = 0;\n\ninterface ResolveMaxFontSizeMultiplierOptions {\n  /** Explicit component prop. `null` = force-uncap. Wins over everything. */\n  explicit?: number | null;\n  /** Provider config, if any provider is mounted. */\n  config?: FontScalingConfig;\n  /**\n   * The text's resolved variant, `'control'` for control-internal text/icons,\n   * or `undefined` for `variant=\"inherit\"` text (no variant opinion — nested\n   * text inherits its parent's cap natively).\n   */\n  variant?: TextVariant | 'control';\n}\n\nfunction toResolved(cap: FontScalingCapValue): number {\n  return cap === null ? UNCAPPED : cap;\n}\n\n/**\n * Resolves the `maxFontSizeMultiplier` to hand to React Native.\n *\n * Precedence: explicit prop > provider config (variant entry, then base-variant\n * entry, then `default`) > built-in default table.\n *\n * Returns `undefined` (native behavior: inherit from parent text or app\n * global) when nothing applies, including for `variant=\"inherit\"`. Only an\n * explicit `null` (prop or provider) maps to `0`, RN's force-uncap value.\n */\nfunction resolveMaxFontSizeMultiplier({\n  explicit,\n  config,\n  variant,\n}: ResolveMaxFontSizeMultiplierOptions): number | undefined {\n  if (explicit !== undefined) {\n    return toResolved(explicit);\n  }\n\n  if (config?.enabled === false) {\n    return undefined;\n  }\n\n  if (variant === undefined) {\n    return config?.default !== undefined ? toResolved(config.default) : undefined;\n  }\n\n  if (variant === 'control') {\n    if (config?.control !== undefined) {\n      return toResolved(config.control);\n    }\n    return DEFAULT_CONTROL_MAX_FONT_SIZE_MULTIPLIER;\n  }\n\n  const baseVariant = variant.split('/')[0] as TextVariant;\n\n  const variantCap = config?.variants?.[variant];\n  if (variantCap !== undefined) {\n    return toResolved(variantCap);\n  }\n  const baseVariantCap = config?.variants?.[baseVariant];\n  if (baseVariantCap !== undefined) {\n    return toResolved(baseVariantCap);\n  }\n  if (config?.default !== undefined) {\n    return toResolved(config.default);\n  }\n\n  // Future: a theme-level typography[variant].maxFontSizeMultiplier slots here.\n\n  const builtIn =\n    DEFAULT_MAX_FONT_SIZE_MULTIPLIERS[variant] ?? DEFAULT_MAX_FONT_SIZE_MULTIPLIERS[baseVariant];\n  return typeof builtIn === 'number' ? builtIn : undefined;\n}\n\nexport { resolveMaxFontSizeMultiplier, type ResolveMaxFontSizeMultiplierOptions };\n"],"mappings":";;;AASA,MAAM,WAAW;AAejB,SAAS,WAAW,KAAkC;CACpD,OAAO,QAAQ,OAAO,WAAW;;;;;;;;;;;;AAanC,SAAS,6BAA6B,EACpC,UACA,QACA,WAC0D;CAC1D,IAAI,aAAa,KAAA,GACf,OAAO,WAAW,SAAS;CAG7B,IAAI,QAAQ,YAAY,OACtB;CAGF,IAAI,YAAY,KAAA,GACd,OAAO,QAAQ,YAAY,KAAA,IAAY,WAAW,OAAO,QAAQ,GAAG,KAAA;CAGtE,IAAI,YAAY,WAAW;EACzB,IAAI,QAAQ,YAAY,KAAA,GACtB,OAAO,WAAW,OAAO,QAAQ;EAEnC,OAAA;;CAGF,MAAM,cAAc,QAAQ,MAAM,IAAI,CAAC;CAEvC,MAAM,aAAa,QAAQ,WAAW;CACtC,IAAI,eAAe,KAAA,GACjB,OAAO,WAAW,WAAW;CAE/B,MAAM,iBAAiB,QAAQ,WAAW;CAC1C,IAAI,mBAAmB,KAAA,GACrB,OAAO,WAAW,eAAe;CAEnC,IAAI,QAAQ,YAAY,KAAA,GACtB,OAAO,WAAW,OAAO,QAAQ;CAKnC,MAAM,UACJ,kCAAkC,YAAY,kCAAkC;CAClF,OAAO,OAAO,YAAY,WAAW,UAAU,KAAA"}

package/dist/fontScaling/types.d.cts

@@ -21,22 +21,25 @@ 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;
   /**
    * Fallback cap for any variant not listed in `variants`. Takes precedence
-   * over the built-in default table, including its uncapped entries — setting
-   * `default: 2` caps body/label/caption text that UDS leaves uncapped by
-   * default.
+   * over the built-in default table. For example, `default: 1.75` replaces the
+   * built-in 2x cap for body, label, and caption text unless a variant-specific
+   * override applies.
    */
   default?: FontScalingCapValue;
   /**
-   * Cap for control-internal text and icons: Button labels and icons,
-   * Checkbox boxes/checkmarks/labels, and standalone `Icon` glyphs.
+   * 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;EAkBmB;;;;;;EAXnB,OAAA,GAAU,mBAAA;;;;;;EAMV,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"}