@yahoo/uds-mobile 2.23.3 → 2.24.0-beta.2

package/dist/fontScaling/constants.d.ts

@@ -0,0 +1,49 @@
+
+import { TextVariant } from "../components/Text.js";
+import { FontScalingCapValue } from "./types.js";
+
+//#region src/fontScaling/constants.d.ts
+/**
+ * The largest OS font scale UDS components are designed to support.
+ *
+ * Yahoo's inclusive-design guidance is to solve for text scaling up to 2x, so
+ * no default cap exceeds it. Apple's Accessibility Nutrition Label for Larger
+ * Text is claimable at "at least 200% or the maximum font size for the
+ * system", so a 2x ceiling still qualifies. Note that iOS offers scales beyond
+ * this (up to 3.571x): with this ceiling in place the top accessibility sizes
+ * render alike, and an app that wants to follow the OS further can raise or
+ * remove the caps via `UDSFontScalingProvider`.
+ */
+declare const MAX_SUPPORTED_FONT_SCALE = 2;
+/**
+ * How far each text style would grow if only legibility mattered, following
+ * the shape of Apple's Dynamic Type ramps: the larger a style starts, the less
+ * it multiplies. At iOS's largest accessibility size the system grows body
+ * (17pt) by 3.12x but largeTitle (34pt) by only ~1.71x, and UDS display tiers
+ * are larger than largeTitle, so they taper hardest.
+ *
+ * Caps are chosen by the size a style starts at rather than by which family it
+ * belongs to, which is why `ui1` (24pt) matches `title3` (24pt) and `ui2`
+ * (20pt) matches `title4` (20pt). `null` means "no cap from the curve" — those
+ * are reading sizes, where legibility argues for following the OS.
+ *
+ * The exported defaults are this curve clamped to {@link MAX_SUPPORTED_FONT_SCALE}.
+ */
+declare const TYPE_SCALE_CURVE: Readonly<Partial<Record<TextVariant, FontScalingCapValue>>>;
+/**
+ * Default per-variant caps on OS font scaling, applied by `Text` when no
+ * explicit prop or provider config overrides them: the legibility curve in
+ * {@link TYPE_SCALE_CURVE}, clamped to the 2x we support.
+ *
+ * Keys are base variants; `/emphasized` twins resolve to their base.
+ */
+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.
+ */
+declare const DEFAULT_CONTROL_MAX_FONT_SIZE_MULTIPLIER = 2;
+//#endregion
+export { DEFAULT_CONTROL_MAX_FONT_SIZE_MULTIPLIER, DEFAULT_MAX_FONT_SIZE_MULTIPLIERS, MAX_SUPPORTED_FONT_SCALE, TYPE_SCALE_CURVE };
+//# sourceMappingURL=constants.d.ts.map

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

@@ -0,0 +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"}

package/dist/fontScaling/constants.js

@@ -0,0 +1,70 @@
+/*! © 2026 Yahoo, Inc. UDS Mobile v0.0.0-development */
+//#region src/fontScaling/constants.ts
+/**
+* The largest OS font scale UDS components are designed to support.
+*
+* Yahoo's inclusive-design guidance is to solve for text scaling up to 2x, so
+* no default cap exceeds it. Apple's Accessibility Nutrition Label for Larger
+* Text is claimable at "at least 200% or the maximum font size for the
+* system", so a 2x ceiling still qualifies. Note that iOS offers scales beyond
+* this (up to 3.571x): with this ceiling in place the top accessibility sizes
+* render alike, and an app that wants to follow the OS further can raise or
+* remove the caps via `UDSFontScalingProvider`.
+*/
+const MAX_SUPPORTED_FONT_SCALE = 2;
+/**
+* How far each text style would grow if only legibility mattered, following
+* the shape of Apple's Dynamic Type ramps: the larger a style starts, the less
+* it multiplies. At iOS's largest accessibility size the system grows body
+* (17pt) by 3.12x but largeTitle (34pt) by only ~1.71x, and UDS display tiers
+* are larger than largeTitle, so they taper hardest.
+*
+* Caps are chosen by the size a style starts at rather than by which family it
+* belongs to, which is why `ui1` (24pt) matches `title3` (24pt) and `ui2`
+* (20pt) matches `title4` (20pt). `null` means "no cap from the curve" — those
+* are reading sizes, where legibility argues for following the OS.
+*
+* The exported defaults are this curve clamped to {@link MAX_SUPPORTED_FONT_SCALE}.
+*/
+const TYPE_SCALE_CURVE = {
+	display1: 1.5,
+	display2: 1.6,
+	display3: 1.75,
+	title1: 1.8,
+	title2: 2,
+	title3: 2.2,
+	title4: 2.4,
+	headline1: 2.5,
+	ui1: 2.2,
+	ui2: 2.4,
+	body1: null,
+	label1: null,
+	label2: null,
+	label3: null,
+	label4: null,
+	caption1: null,
+	caption2: null,
+	legal1: null,
+	ui3: null,
+	ui4: null,
+	ui5: null,
+	ui6: null
+};
+/**
+* Default per-variant caps on OS font scaling, applied by `Text` when no
+* explicit prop or provider config overrides them: the legibility curve in
+* {@link TYPE_SCALE_CURVE}, clamped to the 2x we support.
+*
+* Keys are base variants; `/emphasized` twins resolve to their base.
+*/
+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.
+*/
+const DEFAULT_CONTROL_MAX_FONT_SIZE_MULTIPLIER = 2;
+//#endregion
+export { DEFAULT_CONTROL_MAX_FONT_SIZE_MULTIPLIER, DEFAULT_MAX_FONT_SIZE_MULTIPLIERS, MAX_SUPPORTED_FONT_SCALE, TYPE_SCALE_CURVE };
+
+//# sourceMappingURL=constants.js.map

package/dist/fontScaling/constants.js.map

@@ -0,0 +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"}

package/dist/fontScaling/index.cjs

@@ -0,0 +1,13 @@
+/*! © 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_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_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;
+exports.UDSFontScalingProvider = require_fontScaling_FontScalingContext.UDSFontScalingProvider;
+exports.useFontScale = require_fontScaling_useFontScale.useFontScale;
+exports.useMaxFontSizeMultiplier = require_fontScaling_useMaxFontSizeMultiplier.useMaxFontSizeMultiplier;

package/dist/fontScaling/index.d.cts

@@ -0,0 +1,8 @@
+
+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 { 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 };

package/dist/fontScaling/index.d.ts

@@ -0,0 +1,8 @@
+
+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 { 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 };

package/dist/fontScaling/index.js

@@ -0,0 +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 };

package/dist/fontScaling/resolveMaxFontSizeMultiplier.cjs

@@ -0,0 +1,38 @@
+/*! © 2026 Yahoo, Inc. UDS Mobile v0.0.0-development */
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_fontScaling_constants = require("./constants.cjs");
+//#region src/fontScaling/resolveMaxFontSizeMultiplier.ts
+const UNCAPPED = 0;
+function toResolved(cap) {
+	return cap === null ? UNCAPPED : cap;
+}
+/**
+* Resolves the `maxFontSizeMultiplier` to hand to React Native.
+*
+* Precedence: explicit prop > provider config (variant entry, then base-variant
+* 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
+* explicit `null` (prop or provider) maps to `0`, RN's force-uncap value.
+*/
+function resolveMaxFontSizeMultiplier({ explicit, config, variant }) {
+	if (explicit !== void 0) return toResolved(explicit);
+	if (config?.enabled === false) return;
+	if (variant === void 0) return config?.default !== void 0 ? toResolved(config.default) : void 0;
+	if (variant === "control") {
+		if (config?.control !== void 0) return toResolved(config.control);
+		return 2;
+	}
+	const baseVariant = variant.split("/")[0];
+	const variantCap = config?.variants?.[variant];
+	if (variantCap !== void 0) return toResolved(variantCap);
+	const baseVariantCap = config?.variants?.[baseVariant];
+	if (baseVariantCap !== void 0) return toResolved(baseVariantCap);
+	if (config?.default !== void 0) return toResolved(config.default);
+	const builtIn = require_fontScaling_constants.DEFAULT_MAX_FONT_SIZE_MULTIPLIERS[variant] ?? require_fontScaling_constants.DEFAULT_MAX_FONT_SIZE_MULTIPLIERS[baseVariant];
+	return typeof builtIn === "number" ? builtIn : void 0;
+}
+//#endregion
+exports.resolveMaxFontSizeMultiplier = resolveMaxFontSizeMultiplier;

package/dist/fontScaling/resolveMaxFontSizeMultiplier.d.cts

@@ -0,0 +1,36 @@
+
+import { TextVariant } from "../components/Text.cjs";
+import { FontScalingConfig } from "./types.cjs";
+
+//#region src/fontScaling/resolveMaxFontSizeMultiplier.d.ts
+interface ResolveMaxFontSizeMultiplierOptions {
+  /** Explicit component prop. `null` = force-uncap. Wins over everything. */
+  explicit?: number | null;
+  /** Provider config, if any provider is mounted. */
+  config?: FontScalingConfig;
+  /**
+   * The text's resolved variant, `'control'` for control-internal text/icons,
+   * or `undefined` for `variant="inherit"` text (no variant opinion — nested
+   * text inherits its parent's cap natively).
+   */
+  variant?: TextVariant | 'control';
+}
+/**
+ * Resolves the `maxFontSizeMultiplier` to hand to React Native.
+ *
+ * Precedence: explicit prop > provider config (variant entry, then base-variant
+ * 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
+ * explicit `null` (prop or provider) maps to `0`, RN's force-uncap value.
+ */
+declare function resolveMaxFontSizeMultiplier({
+  explicit,
+  config,
+  variant
+}: ResolveMaxFontSizeMultiplierOptions): number | undefined;
+//#endregion
+export { type ResolveMaxFontSizeMultiplierOptions, resolveMaxFontSizeMultiplier };
+//# sourceMappingURL=resolveMaxFontSizeMultiplier.d.cts.map

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

@@ -0,0 +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"}

package/dist/fontScaling/resolveMaxFontSizeMultiplier.d.ts

@@ -0,0 +1,36 @@
+
+import { TextVariant } from "../components/Text.js";
+import { FontScalingConfig } from "./types.js";
+
+//#region src/fontScaling/resolveMaxFontSizeMultiplier.d.ts
+interface ResolveMaxFontSizeMultiplierOptions {
+  /** Explicit component prop. `null` = force-uncap. Wins over everything. */
+  explicit?: number | null;
+  /** Provider config, if any provider is mounted. */
+  config?: FontScalingConfig;
+  /**
+   * The text's resolved variant, `'control'` for control-internal text/icons,
+   * or `undefined` for `variant="inherit"` text (no variant opinion — nested
+   * text inherits its parent's cap natively).
+   */
+  variant?: TextVariant | 'control';
+}
+/**
+ * Resolves the `maxFontSizeMultiplier` to hand to React Native.
+ *
+ * Precedence: explicit prop > provider config (variant entry, then base-variant
+ * 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
+ * explicit `null` (prop or provider) maps to `0`, RN's force-uncap value.
+ */
+declare function resolveMaxFontSizeMultiplier({
+  explicit,
+  config,
+  variant
+}: ResolveMaxFontSizeMultiplierOptions): number | undefined;
+//#endregion
+export { type ResolveMaxFontSizeMultiplierOptions, resolveMaxFontSizeMultiplier };
+//# sourceMappingURL=resolveMaxFontSizeMultiplier.d.ts.map

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

@@ -0,0 +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"}

package/dist/fontScaling/resolveMaxFontSizeMultiplier.js

@@ -0,0 +1,39 @@
+/*! © 2026 Yahoo, Inc. UDS Mobile v0.0.0-development */
+import { DEFAULT_MAX_FONT_SIZE_MULTIPLIERS } from "./constants.js";
+//#region src/fontScaling/resolveMaxFontSizeMultiplier.ts
+const UNCAPPED = 0;
+function toResolved(cap) {
+	return cap === null ? UNCAPPED : cap;
+}
+/**
+* Resolves the `maxFontSizeMultiplier` to hand to React Native.
+*
+* Precedence: explicit prop > provider config (variant entry, then base-variant
+* 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
+* explicit `null` (prop or provider) maps to `0`, RN's force-uncap value.
+*/
+function resolveMaxFontSizeMultiplier({ explicit, config, variant }) {
+	if (explicit !== void 0) return toResolved(explicit);
+	if (config?.enabled === false) return;
+	if (variant === void 0) return config?.default !== void 0 ? toResolved(config.default) : void 0;
+	if (variant === "control") {
+		if (config?.control !== void 0) return toResolved(config.control);
+		return 2;
+	}
+	const baseVariant = variant.split("/")[0];
+	const variantCap = config?.variants?.[variant];
+	if (variantCap !== void 0) return toResolved(variantCap);
+	const baseVariantCap = config?.variants?.[baseVariant];
+	if (baseVariantCap !== void 0) return toResolved(baseVariantCap);
+	if (config?.default !== void 0) return toResolved(config.default);
+	const builtIn = DEFAULT_MAX_FONT_SIZE_MULTIPLIERS[variant] ?? DEFAULT_MAX_FONT_SIZE_MULTIPLIERS[baseVariant];
+	return typeof builtIn === "number" ? builtIn : void 0;
+}
+//#endregion
+export { resolveMaxFontSizeMultiplier };
+
+//# sourceMappingURL=resolveMaxFontSizeMultiplier.js.map

package/dist/fontScaling/resolveMaxFontSizeMultiplier.js.map

@@ -0,0 +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"}

package/dist/fontScaling/types.cjs

@@ -0,0 +1 @@
+/*! © 2026 Yahoo, Inc. UDS Mobile v0.0.0-development */

package/dist/fontScaling/types.d.cts

@@ -0,0 +1,51 @@
+
+import { TextVariant } from "../components/Text.cjs";
+
+//#region src/fontScaling/types.d.ts
+/**
+ * A cap on OS font scaling for a piece of text.
+ *
+ * - `number` (>= 1) — text scales with the OS setting up to this multiplier
+ * - `null` — explicitly uncapped: text follows the OS setting with no limit
+ */
+type FontScalingCapValue = number | null;
+/**
+ * App-level font-scaling configuration, applied via `UDSFontScalingProvider`
+ * (or the `fontScaling` prop on `UDSGestureProvider`).
+ *
+ * Resolution order for any piece of text: explicit component prop, then this
+ * config, then the built-in defaults in `DEFAULT_MAX_FONT_SIZE_MULTIPLIERS`.
+ *
+ * The config object should be identity-stable (a module constant or memoized)
+ * — every UDS text element reads it from context.
+ */
+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.
+   * @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.
+   */
+  default?: FontScalingCapValue;
+  /**
+   * Cap for control-internal text, icons, and geometry in Button, Checkbox,
+   * Radio, Switch, Chip, and Tabs, plus standalone `Icon` glyphs.
+   * @default 2
+   */
+  control?: FontScalingCapValue;
+  /**
+   * Per-variant caps. A base-variant key (e.g. `display1`) also covers its
+   * `/emphasized` twin unless the emphasized key is listed explicitly.
+   */
+  variants?: Partial<Record<TextVariant, FontScalingCapValue>>;
+}
+//#endregion
+export { type FontScalingCapValue, type FontScalingConfig };
+//# sourceMappingURL=types.d.cts.map

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

@@ -0,0 +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"}

package/dist/fontScaling/types.d.ts

@@ -0,0 +1,51 @@
+
+import { TextVariant } from "../components/Text.js";
+
+//#region src/fontScaling/types.d.ts
+/**
+ * A cap on OS font scaling for a piece of text.
+ *
+ * - `number` (>= 1) — text scales with the OS setting up to this multiplier
+ * - `null` — explicitly uncapped: text follows the OS setting with no limit
+ */
+type FontScalingCapValue = number | null;
+/**
+ * App-level font-scaling configuration, applied via `UDSFontScalingProvider`
+ * (or the `fontScaling` prop on `UDSGestureProvider`).
+ *
+ * Resolution order for any piece of text: explicit component prop, then this
+ * config, then the built-in defaults in `DEFAULT_MAX_FONT_SIZE_MULTIPLIERS`.
+ *
+ * The config object should be identity-stable (a module constant or memoized)
+ * — every UDS text element reads it from context.
+ */
+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.
+   * @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.
+   */
+  default?: FontScalingCapValue;
+  /**
+   * Cap for control-internal text, icons, and geometry in Button, Checkbox,
+   * Radio, Switch, Chip, and Tabs, plus standalone `Icon` glyphs.
+   * @default 2
+   */
+  control?: FontScalingCapValue;
+  /**
+   * Per-variant caps. A base-variant key (e.g. `display1`) also covers its
+   * `/emphasized` twin unless the emphasized key is listed explicitly.
+   */
+  variants?: Partial<Record<TextVariant, FontScalingCapValue>>;
+}
+//#endregion
+export { type FontScalingCapValue, type FontScalingConfig };
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","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"}

package/dist/fontScaling/types.js

@@ -0,0 +1 @@
+/*! © 2026 Yahoo, Inc. UDS Mobile v0.0.0-development */

package/dist/fontScaling/useFontScale.cjs

@@ -0,0 +1,32 @@
+/*! © 2026 Yahoo, Inc. UDS Mobile v0.0.0-development */
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+require("../_virtual/_rolldown/runtime.cjs");
+let react = require("react");
+let react_native = require("react-native");
+//#region src/fontScaling/useFontScale.ts
+function subscribe(onStoreChange) {
+	const subscription = react_native.Dimensions.addEventListener("change", onStoreChange);
+	return () => subscription.remove();
+}
+function getFontScale() {
+	return react_native.Dimensions.get("window").fontScale;
+}
+/**
+* The current OS font scale, clamped to `[1, cap]`, for sizing containers
+* around scaled text (e.g. a checkbox box growing with its checkmark).
+*
+* `cap` uses the same semantics as `maxFontSizeMultiplier`: a number >= 1
+* caps the scale; `null`, `0`, or `undefined` leave it uncapped. The result
+* is never below 1 so containers never shrink under their token metrics
+* (font scales < 1 shrink text only, as today).
+*
+* Subscribes to font-scale changes only — rotation does not re-render, and
+* components re-render solely when the user changes the OS text size.
+*/
+function useFontScale(cap) {
+	const fontScale = (0, react.useSyncExternalStore)(subscribe, getFontScale, getFontScale);
+	const effectiveCap = typeof cap === "number" && cap >= 1 ? cap : Number.POSITIVE_INFINITY;
+	return Math.max(1, Math.min(fontScale, effectiveCap));
+}
+//#endregion
+exports.useFontScale = useFontScale;

package/dist/fontScaling/useFontScale.d.cts

@@ -0,0 +1,18 @@
+
+//#region src/fontScaling/useFontScale.d.ts
+/**
+ * The current OS font scale, clamped to `[1, cap]`, for sizing containers
+ * around scaled text (e.g. a checkbox box growing with its checkmark).
+ *
+ * `cap` uses the same semantics as `maxFontSizeMultiplier`: a number >= 1
+ * caps the scale; `null`, `0`, or `undefined` leave it uncapped. The result
+ * is never below 1 so containers never shrink under their token metrics
+ * (font scales < 1 shrink text only, as today).
+ *
+ * Subscribes to font-scale changes only — rotation does not re-render, and
+ * components re-render solely when the user changes the OS text size.
+ */
+declare function useFontScale(cap?: number | null): number;
+//#endregion
+export { useFontScale };
+//# sourceMappingURL=useFontScale.d.cts.map

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

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

package/dist/fontScaling/useFontScale.d.ts

@@ -0,0 +1,18 @@
+
+//#region src/fontScaling/useFontScale.d.ts
+/**
+ * The current OS font scale, clamped to `[1, cap]`, for sizing containers
+ * around scaled text (e.g. a checkbox box growing with its checkmark).
+ *
+ * `cap` uses the same semantics as `maxFontSizeMultiplier`: a number >= 1
+ * caps the scale; `null`, `0`, or `undefined` leave it uncapped. The result
+ * is never below 1 so containers never shrink under their token metrics
+ * (font scales < 1 shrink text only, as today).
+ *
+ * Subscribes to font-scale changes only — rotation does not re-render, and
+ * components re-render solely when the user changes the OS text size.
+ */
+declare function useFontScale(cap?: number | null): number;
+//#endregion
+export { useFontScale };
+//# sourceMappingURL=useFontScale.d.ts.map

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

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

package/dist/fontScaling/useFontScale.js

@@ -0,0 +1,32 @@
+/*! © 2026 Yahoo, Inc. UDS Mobile v0.0.0-development */
+import { useSyncExternalStore } from "react";
+import { Dimensions } from "react-native";
+//#region src/fontScaling/useFontScale.ts
+function subscribe(onStoreChange) {
+	const subscription = Dimensions.addEventListener("change", onStoreChange);
+	return () => subscription.remove();
+}
+function getFontScale() {
+	return Dimensions.get("window").fontScale;
+}
+/**
+* The current OS font scale, clamped to `[1, cap]`, for sizing containers
+* around scaled text (e.g. a checkbox box growing with its checkmark).
+*
+* `cap` uses the same semantics as `maxFontSizeMultiplier`: a number >= 1
+* caps the scale; `null`, `0`, or `undefined` leave it uncapped. The result
+* is never below 1 so containers never shrink under their token metrics
+* (font scales < 1 shrink text only, as today).
+*
+* Subscribes to font-scale changes only — rotation does not re-render, and
+* components re-render solely when the user changes the OS text size.
+*/
+function useFontScale(cap) {
+	const fontScale = useSyncExternalStore(subscribe, getFontScale, getFontScale);
+	const effectiveCap = typeof cap === "number" && cap >= 1 ? cap : Number.POSITIVE_INFINITY;
+	return Math.max(1, Math.min(fontScale, effectiveCap));
+}
+//#endregion
+export { useFontScale };
+
+//# sourceMappingURL=useFontScale.js.map

package/dist/fontScaling/useFontScale.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFontScale.js","names":[],"sources":["../../src/fontScaling/useFontScale.ts"],"sourcesContent":["import { useSyncExternalStore } from 'react';\nimport { Dimensions } from 'react-native';\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 current OS font scale, clamped to `[1, cap]`, for sizing containers\n * around scaled text (e.g. a checkbox box growing with its 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 * 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): number {\n  const fontScale = useSyncExternalStore(subscribe, getFontScale, getFontScale);\n  const effectiveCap = typeof cap === 'number' && cap >= 1 ? cap : Number.POSITIVE_INFINITY;\n  return Math.max(1, Math.min(fontScale, effectiveCap));\n}\n\nexport { useFontScale };\n"],"mappings":";;;;AAGA,SAAS,UAAU,eAAuC;CACxD,MAAM,eAAe,WAAW,iBAAiB,UAAU,cAAc;CACzE,aAAa,aAAa,QAAQ;;AAKpC,SAAS,eAAuB;CAC9B,OAAO,WAAW,IAAI,SAAS,CAAC;;;;;;;;;;;;;;AAelC,SAAS,aAAa,KAA6B;CACjD,MAAM,YAAY,qBAAqB,WAAW,cAAc,aAAa;CAC7E,MAAM,eAAe,OAAO,QAAQ,YAAY,OAAO,IAAI,MAAM,OAAO;CACxE,OAAO,KAAK,IAAI,GAAG,KAAK,IAAI,WAAW,aAAa,CAAC"}

package/dist/fontScaling/useMaxFontSizeMultiplier.cjs

@@ -0,0 +1,24 @@
+/*! © 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_resolveMaxFontSizeMultiplier = require("./resolveMaxFontSizeMultiplier.cjs");
+let react = require("react");
+//#region src/fontScaling/useMaxFontSizeMultiplier.ts
+/**
+* Resolves the `maxFontSizeMultiplier` for a text variant (or `'control'` for
+* control-internal text/icons), combining an explicit prop value, the nearest
+* `UDSFontScalingProvider` config, and the built-in defaults.
+*
+* Returns a value to pass directly to React Native: a cap (>= 1), `0`
+* (force-uncap), or `undefined` (native default / inherit).
+*/
+function useMaxFontSizeMultiplier(variant, explicit) {
+	return require_fontScaling_resolveMaxFontSizeMultiplier.resolveMaxFontSizeMultiplier({
+		explicit,
+		config: (0, react.useContext)(require_fontScaling_FontScalingContext.FontScalingContext),
+		variant
+	});
+}
+//#endregion
+exports.useMaxFontSizeMultiplier = useMaxFontSizeMultiplier;

package/dist/fontScaling/useMaxFontSizeMultiplier.d.cts

@@ -0,0 +1,16 @@
+
+import { TextVariant } from "../components/Text.cjs";
+
+//#region src/fontScaling/useMaxFontSizeMultiplier.d.ts
+/**
+ * Resolves the `maxFontSizeMultiplier` for a text variant (or `'control'` for
+ * control-internal text/icons), combining an explicit prop value, the nearest
+ * `UDSFontScalingProvider` config, and the built-in defaults.
+ *
+ * Returns a value to pass directly to React Native: a cap (>= 1), `0`
+ * (force-uncap), or `undefined` (native default / inherit).
+ */
+declare function useMaxFontSizeMultiplier(variant?: TextVariant | 'control', explicit?: number | null): number | undefined;
+//#endregion
+export { useMaxFontSizeMultiplier };
+//# sourceMappingURL=useMaxFontSizeMultiplier.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useMaxFontSizeMultiplier.d.cts","names":[],"sources":["../../src/fontScaling/useMaxFontSizeMultiplier.ts"],"mappings":";;;;;;AAEsD;;;;;;iBAY7C,wBAAA,CACP,OAAA,GAAU,WAAA,cACV,QAAA"}