@yahoo/uds 3.169.1 → 3.170.0

package/dist/styles/styler.d.ts

@@ -1,5 +1,6 @@
 
-import { CVA, CX } from "./stylerTypes.js";
+import { variants } from "./variants.js";
+import { CVA, CVAVariantSchema, CX } from "./stylerTypes.js";
 
 //#region src/styles/styler.d.ts
 /**
@@ -7,296 +8,19 @@ import { CVA, CX } from "./stylerTypes.js";
  * Code uses old-school JS to hyper optimize component rendering hot paths.
  **/
 declare function normalizeObject(props: Record<string, unknown>): Record<string, unknown>;
-declare const cx: CX<string>;
-declare const cva: CVA<string>;
 /**
- * !WARNING: The `@__PURE__` annotation below is load-bearing for tree-shaking — do not remove it.
- *
- * Without it, importing anything from this module (e.g. just `cx`) drags the full `variants`
- * map and the auto-generated `autoVariants` (~70 kB minified) into the bundle, because bundlers
- * must assume the module-level `cva(...)` call has side effects. With it, `getStylesInternal`
- * and its `variants` import are dropped when `getStyles` is unused.
+ * !WARNING: The `@__PURE__` annotation on the `createTailwindMerge(...)` call
+ * inside `./udsTailwindMerge.ts` is load-bearing for tree-shaking — without
+ * it, bundlers must assume the module-level call has side effects and keep
+ * the merge engine in any bundle that imports anything from this module. Do
+ * not remove it without re-checking bundle output (e.g. `esbuild --bundle
+ * --minify` an entry that imports a single lightweight export).
  */
-declare const getStylesInternal: (props?: ({
-  avatarIconVariantRoot?: "primary" | "secondary" | "default" | undefined;
-  avatarImageVariantRoot?: "primary" | "secondary" | "default" | undefined;
-  avatarSizeIcon?: "xs" | "sm" | "md" | "lg" | "xl" | "2xl" | "default" | "2xs" | "3xl" | undefined;
-  avatarSizeRoot?: "xs" | "sm" | "md" | "lg" | "xl" | "2xl" | "default" | "2xs" | "3xl" | undefined;
-  avatarTextVariantRoot?: "primary" | "secondary" | "default" | undefined;
-  badgeSizeIcon?: "xs" | "sm" | "md" | "lg" | "default" | undefined;
-  badgeSizeRoot?: "xs" | "sm" | "md" | "lg" | "default" | undefined;
-  badgeVariantIcon?: "primary" | "secondary" | "brand" | "alert" | "positive" | "warning" | "info" | "brand-secondary" | "alert-secondary" | "positive-secondary" | "warning-secondary" | "info-secondary" | "default" | undefined;
-  badgeVariantRoot?: "primary" | "secondary" | "brand" | "alert" | "positive" | "warning" | "info" | "brand-secondary" | "alert-secondary" | "positive-secondary" | "warning-secondary" | "info-secondary" | "default" | undefined;
-  bannerSizeClose?: "default" | undefined;
-  bannerSizeDescription?: "default" | undefined;
-  bannerSizeIcon?: "default" | undefined;
-  bannerSizeRoot?: "default" | undefined;
-  bannerSizeTitle?: "default" | undefined;
-  bannerVariantDescription?: "primary" | "secondary" | "brand" | "alert" | "warning" | "info" | "brand-secondary" | "alert-secondary" | "warning-secondary" | "info-secondary" | "default" | "success" | "success-secondary" | undefined;
-  bannerVariantIcon?: "primary" | "secondary" | "brand" | "alert" | "warning" | "info" | "brand-secondary" | "alert-secondary" | "warning-secondary" | "info-secondary" | "default" | "success" | "success-secondary" | undefined;
-  bannerVariantRoot?: "primary" | "secondary" | "brand" | "alert" | "warning" | "info" | "brand-secondary" | "alert-secondary" | "warning-secondary" | "info-secondary" | "default" | "success" | "success-secondary" | undefined;
-  bannerVariantTitle?: "primary" | "secondary" | "brand" | "alert" | "warning" | "info" | "brand-secondary" | "alert-secondary" | "warning-secondary" | "info-secondary" | "default" | "success" | "success-secondary" | undefined;
-  bottomsheetVariantHandleIndicator?: "default" | undefined;
-  bottomsheetVariantHeader?: "default" | undefined;
-  bottomsheetVariantRoot?: "default" | undefined;
-  buttonSizeIcon?: "xs" | "sm" | "md" | "lg" | "default" | undefined;
-  buttonSizeRoot?: "xs" | "sm" | "md" | "lg" | "default" | undefined;
-  buttonVariantIcon?: "primary" | "secondary" | "brand" | "alert" | "positive" | "warning" | "info" | "brand-secondary" | "alert-secondary" | "positive-secondary" | "warning-secondary" | "info-secondary" | "tertiary" | "default" | "alert-tertiary" | "brand-tertiary" | "contrast-high" | "contrast-low" | "contrast-medium" | "info-tertiary" | "positive-tertiary" | "warning-tertiary" | undefined;
-  buttonVariantRoot?: "primary" | "secondary" | "brand" | "alert" | "positive" | "warning" | "info" | "brand-secondary" | "alert-secondary" | "positive-secondary" | "warning-secondary" | "info-secondary" | "tertiary" | "default" | "alert-tertiary" | "brand-tertiary" | "contrast-high" | "contrast-low" | "contrast-medium" | "info-tertiary" | "positive-tertiary" | "warning-tertiary" | undefined;
-  checkboxSizeCheckbox?: "sm" | "md" | "default" | undefined;
-  checkboxSizeRoot?: "sm" | "md" | "default" | undefined;
-  checkboxVariantCheckbox?: "primary" | "secondary" | "alert" | "alert-secondary" | "default" | undefined;
-  checkboxVariantCheckboxIcon?: "primary" | "secondary" | "alert" | "alert-secondary" | "default" | undefined;
-  checkboxVariantRoot?: "primary" | "secondary" | "alert" | "alert-secondary" | "default" | undefined;
-  checkboxVariantValueCheckbox?: "checked" | "indeterminate" | "unchecked" | undefined;
-  checkboxVariantValueCheckboxIcon?: "checked" | "indeterminate" | "unchecked" | undefined;
-  checkboxVariantValueRoot?: "checked" | "indeterminate" | "unchecked" | undefined;
-  chipDismissibleVariantIcon?: "primary" | "secondary" | "brand" | "brand-secondary" | "default" | undefined;
-  chipDismissibleVariantRoot?: "primary" | "secondary" | "brand" | "brand-secondary" | "default" | undefined;
-  chipLinkVariantIcon?: "primary" | "secondary" | "brand" | "brand-secondary" | "default" | undefined;
-  chipLinkVariantRoot?: "primary" | "secondary" | "brand" | "brand-secondary" | "default" | undefined;
-  chipSizeIcon?: "sm" | "md" | "default" | undefined;
-  chipSizeRoot?: "sm" | "md" | "default" | undefined;
-  chipToggleVariantActiveIcon?: "off" | "on" | undefined;
-  chipToggleVariantActiveRoot?: "off" | "on" | undefined;
-  chipToggleVariantIcon?: "primary" | "secondary" | "brand" | "brand-secondary" | "default" | undefined;
-  chipToggleVariantRoot?: "primary" | "secondary" | "brand" | "brand-secondary" | "default" | undefined;
-  dividerVariantLabel?: "primary" | "secondary" | "tertiary" | "muted" | "default" | undefined;
-  dividerVariantLine?: "primary" | "secondary" | "tertiary" | "muted" | "default" | undefined;
-  dividerVariantRoot?: "primary" | "secondary" | "tertiary" | "muted" | "default" | undefined;
-  iconbuttonSizeIcon?: "xs" | "sm" | "md" | "lg" | "xl" | "default" | undefined;
-  iconbuttonSizeRoot?: "xs" | "sm" | "md" | "lg" | "xl" | "default" | undefined;
-  inputSizeEndIcon?: "md" | "lg" | "default" | undefined;
-  inputSizeHelperIcon?: "md" | "lg" | "default" | undefined;
-  inputSizeHelperText?: "md" | "lg" | "default" | undefined;
-  inputSizeInput?: "md" | "lg" | "default" | undefined;
-  inputSizeInputWrapperDynamic?: "md" | "lg" | "default" | undefined;
-  inputSizeInputWrapperStatic?: "md" | "lg" | "default" | undefined;
-  inputSizeLabel?: "md" | "lg" | "default" | undefined;
-  inputSizeRoot?: "md" | "lg" | "default" | undefined;
-  inputSizeStartIcon?: "md" | "lg" | "default" | undefined;
-  inputVariantEndIcon?: "default" | undefined;
-  inputVariantHelperIcon?: "default" | undefined;
-  inputVariantHelperText?: "default" | undefined;
-  inputVariantInput?: "default" | undefined;
-  inputVariantInputPlaceholder?: "default" | undefined;
-  inputVariantInputWrapper?: "default" | undefined;
-  inputVariantLabel?: "default" | undefined;
-  inputVariantLabelRequired?: "default" | undefined;
-  inputVariantRoot?: "default" | undefined;
-  inputVariantStartIcon?: "default" | undefined;
-  inputVariantValueEndIcon?: "empty" | "filled" | undefined;
-  inputVariantValueHelperIcon?: "empty" | "filled" | undefined;
-  inputVariantValueHelperText?: "empty" | "filled" | undefined;
-  inputVariantValueInput?: "empty" | "filled" | undefined;
-  inputVariantValueInputPlaceholder?: "empty" | "filled" | undefined;
-  inputVariantValueInputWrapper?: "empty" | "filled" | undefined;
-  inputVariantValueLabel?: "empty" | "filled" | undefined;
-  inputVariantValueLabelRequired?: "empty" | "filled" | undefined;
-  inputVariantValueRoot?: "empty" | "filled" | undefined;
-  inputVariantValueStartIcon?: "empty" | "filled" | undefined;
-  linkTextStyleIcon?: "display1" | "display2" | "display3" | "title1" | "title2" | "title3" | "title4" | "headline1" | "body1" | "label1" | "label2" | "label3" | "label4" | "caption1" | "caption2" | "legal1" | "ui1" | "ui2" | "ui3" | "ui4" | "ui5" | "ui6" | "default" | undefined;
-  linkTextStyleRoot?: "display1" | "display2" | "display3" | "title1" | "title2" | "title3" | "title4" | "headline1" | "body1" | "label1" | "label2" | "label3" | "label4" | "caption1" | "caption2" | "legal1" | "ui1" | "ui2" | "ui3" | "ui4" | "ui5" | "ui6" | "default" | undefined;
-  linkVariantIconEnd?: "primary" | "secondary" | "tertiary" | "on-color" | "default" | undefined;
-  linkVariantIconStart?: "primary" | "secondary" | "tertiary" | "on-color" | "default" | undefined;
-  linkVariantRoot?: "primary" | "secondary" | "tertiary" | "on-color" | "default" | undefined;
-  menucontentSizeRoot?: "default" | undefined;
-  menucontentVariantRoot?: "default" | undefined;
-  menuitemDividerVariantLine?: "default" | undefined;
-  menuitemDividerVariantRoot?: "default" | undefined;
-  menuitemDividerVariantText?: "default" | undefined;
-  menuitemItemCheckboxVariantActiveEndIcon?: "off" | "on" | undefined;
-  menuitemItemCheckboxVariantActiveRoot?: "off" | "on" | undefined;
-  menuitemItemCheckboxVariantActiveStartIcon?: "off" | "on" | undefined;
-  menuitemItemCheckboxVariantActiveText?: "off" | "on" | undefined;
-  menuitemItemCheckboxVariantEndIcon?: "default" | undefined;
-  menuitemItemCheckboxVariantRoot?: "default" | undefined;
-  menuitemItemCheckboxVariantStartIcon?: "default" | undefined;
-  menuitemItemCheckboxVariantText?: "default" | undefined;
-  menuitemItemVariantActiveIcon?: "off" | "on" | undefined;
-  menuitemItemVariantActiveRoot?: "off" | "on" | undefined;
-  menuitemItemVariantActiveText?: "off" | "on" | undefined;
-  menuitemItemVariantIcon?: "default" | undefined;
-  menuitemItemVariantRoot?: "default" | undefined;
-  menuitemItemVariantText?: "default" | undefined;
-  menuitemSizeEndIcon?: "default" | undefined;
-  menuitemSizeRoot?: "default" | undefined;
-  menuitemSizeStartIcon?: "default" | undefined;
-  menuitemSizeText?: "default" | undefined;
-  modalSizeActions?: "default" | undefined;
-  modalSizeCloseIcon?: "default" | undefined;
-  modalSizeCloseIconContainer?: "default" | undefined;
-  modalSizeDescription?: "default" | undefined;
-  modalSizeHeader?: "default" | undefined;
-  modalSizeRoot?: "default" | undefined;
-  modalSizeScrim?: "default" | undefined;
-  modalSizeSpacingHorizontal?: "default" | undefined;
-  modalSizeTitle?: "default" | undefined;
-  modalSizeTitleDescriptionWrapper?: "default" | undefined;
-  modalVariantCloseIcon?: "default" | undefined;
-  modalVariantDescription?: "default" | undefined;
-  modalVariantRoot?: "default" | undefined;
-  modalVariantTitle?: "default" | undefined;
-  paddlenavSizeIcon?: "xs" | "sm" | "md" | "lg" | "xl" | "default" | undefined;
-  paddlenavSizeRoot?: "xs" | "sm" | "md" | "lg" | "xl" | "default" | undefined;
-  paddlenavVariantBackground?: "primary" | "secondary" | "tertiary" | "default" | undefined;
-  paddlenavVariantIcon?: "primary" | "secondary" | "tertiary" | "default" | undefined;
-  paddlenavVariantRoot?: "primary" | "secondary" | "tertiary" | "default" | undefined;
-  paginationSizeIcon?: "sm" | "md" | "default" | undefined;
-  paginationSizeItem?: "sm" | "md" | "default" | undefined;
-  paginationSizeRoot?: "sm" | "md" | "default" | undefined;
-  paginationSizeText?: "sm" | "md" | "default" | undefined;
-  paginationVariantActiveRoot?: "off" | "on" | undefined;
-  paginationVariantRoot?: "default" | undefined;
-  popoverSizeCloseIcon?: "default" | undefined;
-  popoverSizeCloseIconContainer?: "default" | undefined;
-  popoverSizeContentWrapper?: "default" | undefined;
-  popoverSizeRoot?: "default" | undefined;
-  popoverSizeSvgBase?: "default" | undefined;
-  popoverSizeSvgBorder?: "default" | undefined;
-  popoverVariantBlur?: "default" | undefined;
-  popoverVariantCloseIcon?: "default" | undefined;
-  popoverVariantRoot?: "default" | undefined;
-  popoverVariantSvgBase?: "default" | undefined;
-  popoverVariantSvgBorder?: "default" | undefined;
-  radioSizeRadio?: "sm" | "md" | "default" | undefined;
-  radioSizeRoot?: "sm" | "md" | "default" | undefined;
-  radioVariantRadio?: "primary" | "secondary" | "alert" | "alert-secondary" | "default" | undefined;
-  radioVariantRadioCircle?: "primary" | "secondary" | "alert" | "alert-secondary" | "default" | undefined;
-  radioVariantRoot?: "primary" | "secondary" | "alert" | "alert-secondary" | "default" | undefined;
-  radioVariantValueRadio?: "checked" | "unchecked" | undefined;
-  radioVariantValueRadioCircle?: "checked" | "unchecked" | undefined;
-  radioVariantValueRoot?: "checked" | "unchecked" | undefined;
-  scrimVariantRoot?: "default" | undefined;
-  selectVariantRoot?: "default" | undefined;
-  selectcontentSizeRoot?: "default" | undefined;
-  selectcontentVariantRoot?: "default" | undefined;
-  selectitemDividerVariantLine?: "default" | undefined;
-  selectitemDividerVariantRoot?: "default" | undefined;
-  selectitemDividerVariantText?: "default" | undefined;
-  selectitemItemVariantActiveIcon?: "off" | "on" | undefined;
-  selectitemItemVariantActiveRoot?: "off" | "on" | undefined;
-  selectitemItemVariantActiveText?: "off" | "on" | undefined;
-  selectitemItemVariantIcon?: "default" | undefined;
-  selectitemItemVariantRoot?: "default" | undefined;
-  selectitemItemVariantText?: "default" | undefined;
-  selectitemSizeEndIcon?: "default" | undefined;
-  selectitemSizeRoot?: "default" | undefined;
-  selectitemSizeStartIcon?: "default" | undefined;
-  selectitemSizeText?: "default" | undefined;
-  switchSizeHandle?: "sm" | "md" | "default" | undefined;
-  switchSizeHandleIcon?: "sm" | "md" | "default" | undefined;
-  switchSizeRoot?: "sm" | "md" | "default" | undefined;
-  switchSizeSwitch?: "sm" | "md" | "default" | undefined;
-  switchVariantActiveHandle?: "off" | "on" | undefined;
-  switchVariantActiveHandleIcon?: "off" | "on" | undefined;
-  switchVariantActiveRoot?: "off" | "on" | undefined;
-  switchVariantActiveSwitch?: "off" | "on" | undefined;
-  switchVariantHandle?: "default" | undefined;
-  switchVariantHandleIcon?: "default" | undefined;
-  switchVariantRoot?: "default" | undefined;
-  switchVariantSwitch?: "default" | undefined;
-  tabSizeIcon?: "default" | undefined;
-  tabSizeRoot?: "default" | undefined;
-  tabVariantActiveIcon?: "off" | "on" | undefined;
-  tabVariantActiveRoot?: "off" | "on" | undefined;
-  tabVariantIcon?: "primary" | "secondary" | "default" | undefined;
-  tabVariantRoot?: "primary" | "secondary" | "default" | undefined;
-  tabsVariantRoot?: "primary" | "secondary" | "default" | undefined;
-  toastSizeActionButton?: "default" | undefined;
-  toastSizeCloseIcon?: "default" | undefined;
-  toastSizeIcon?: "default" | undefined;
-  toastSizeLabel?: "default" | undefined;
-  toastSizeRoot?: "default" | undefined;
-  toastVariantActionButton?: "warning" | "info" | "loading" | "default" | "success" | "error" | undefined;
-  toastVariantCloseIcon?: "warning" | "info" | "loading" | "default" | "success" | "error" | undefined;
-  toastVariantIcon?: "warning" | "info" | "loading" | "default" | "success" | "error" | undefined;
-  toastVariantRoot?: "warning" | "info" | "loading" | "default" | "success" | "error" | undefined;
-  tooltipSizeBody?: "default" | undefined;
-  tooltipSizeEndContent?: "default" | undefined;
-  tooltipSizeIcon?: "default" | undefined;
-  tooltipSizeRoot?: "default" | undefined;
-  tooltipSizeSvg?: "default" | undefined;
-  tooltipSizeTitle?: "default" | undefined;
-  tooltipVariantBlur?: "default" | undefined;
-  tooltipVariantIcon?: "default" | undefined;
-  tooltipVariantRoot?: "default" | undefined;
-  tooltipVariantSvg?: "default" | undefined;
-  color?: "primary" | "secondary" | "accent" | "brand" | "alert" | "positive" | "warning" | "info" | "brand-secondary" | "alert-secondary" | "positive-secondary" | "warning-secondary" | "info-secondary" | "white" | "black" | "transparent" | "current" | "always/white" | "always/black" | "always/transparent" | "always/current" | "always/brand" | "always/accent" | "tertiary" | "muted" | "on-color" | undefined;
-  placeholderColor?: "primary" | "secondary" | "accent" | "brand" | "alert" | "positive" | "warning" | "info" | "brand-secondary" | "alert-secondary" | "positive-secondary" | "warning-secondary" | "info-secondary" | "white" | "black" | "transparent" | "current" | "always/white" | "always/black" | "always/transparent" | "always/current" | "always/brand" | "always/accent" | "tertiary" | "muted" | "on-color" | undefined;
-  fontFamily?: "display1" | "display2" | "display3" | "title1" | "title2" | "title3" | "title4" | "headline1" | "body1" | "label1" | "label2" | "label3" | "label4" | "caption1" | "caption2" | "legal1" | "ui1" | "ui2" | "ui3" | "ui4" | "ui5" | "ui6" | "display1/emphasized" | "display2/emphasized" | "display3/emphasized" | "title1/emphasized" | "title2/emphasized" | "title3/emphasized" | "title4/emphasized" | "headline1/emphasized" | "body1/emphasized" | "label1/emphasized" | "label2/emphasized" | "label3/emphasized" | "label4/emphasized" | "caption1/emphasized" | "caption2/emphasized" | "legal1/emphasized" | "ui1/emphasized" | "ui2/emphasized" | "ui3/emphasized" | "ui4/emphasized" | "ui5/emphasized" | "ui6/emphasized" | "sans" | "sans-alt" | "serif" | "serif-alt" | "mono" | undefined;
-  fontSize?: "display1" | "display2" | "display3" | "title1" | "title2" | "title3" | "title4" | "headline1" | "body1" | "label1" | "label2" | "label3" | "label4" | "caption1" | "caption2" | "legal1" | "ui1" | "ui2" | "ui3" | "ui4" | "ui5" | "ui6" | "display1/emphasized" | "display2/emphasized" | "display3/emphasized" | "title1/emphasized" | "title2/emphasized" | "title3/emphasized" | "title4/emphasized" | "headline1/emphasized" | "body1/emphasized" | "label1/emphasized" | "label2/emphasized" | "label3/emphasized" | "label4/emphasized" | "caption1/emphasized" | "caption2/emphasized" | "legal1/emphasized" | "ui1/emphasized" | "ui2/emphasized" | "ui3/emphasized" | "ui4/emphasized" | "ui5/emphasized" | "ui6/emphasized" | undefined;
-  fontWeight?: "black" | "thin" | "medium" | "display1" | "display2" | "display3" | "title1" | "title2" | "title3" | "title4" | "headline1" | "body1" | "label1" | "label2" | "label3" | "label4" | "caption1" | "caption2" | "legal1" | "ui1" | "ui2" | "ui3" | "ui4" | "ui5" | "ui6" | "display1/emphasized" | "display2/emphasized" | "display3/emphasized" | "title1/emphasized" | "title2/emphasized" | "title3/emphasized" | "title4/emphasized" | "headline1/emphasized" | "body1/emphasized" | "label1/emphasized" | "label2/emphasized" | "label3/emphasized" | "label4/emphasized" | "caption1/emphasized" | "caption2/emphasized" | "legal1/emphasized" | "ui1/emphasized" | "ui2/emphasized" | "ui3/emphasized" | "ui4/emphasized" | "ui5/emphasized" | "ui6/emphasized" | "bold" | "extralight" | "light" | "regular" | "semibold" | "extrabold" | undefined;
-  lineHeight?: "display1" | "display2" | "display3" | "title1" | "title2" | "title3" | "title4" | "headline1" | "body1" | "label1" | "label2" | "label3" | "label4" | "caption1" | "caption2" | "legal1" | "ui1" | "ui2" | "ui3" | "ui4" | "ui5" | "ui6" | "display1/emphasized" | "display2/emphasized" | "display3/emphasized" | "title1/emphasized" | "title2/emphasized" | "title3/emphasized" | "title4/emphasized" | "headline1/emphasized" | "body1/emphasized" | "label1/emphasized" | "label2/emphasized" | "label3/emphasized" | "label4/emphasized" | "caption1/emphasized" | "caption2/emphasized" | "legal1/emphasized" | "ui1/emphasized" | "ui2/emphasized" | "ui3/emphasized" | "ui4/emphasized" | "ui5/emphasized" | "ui6/emphasized" | undefined;
-  letterSpacing?: "display1" | "display2" | "display3" | "title1" | "title2" | "title3" | "title4" | "headline1" | "body1" | "label1" | "label2" | "label3" | "label4" | "caption1" | "caption2" | "legal1" | "ui1" | "ui2" | "ui3" | "ui4" | "ui5" | "ui6" | "display1/emphasized" | "display2/emphasized" | "display3/emphasized" | "title1/emphasized" | "title2/emphasized" | "title3/emphasized" | "title4/emphasized" | "headline1/emphasized" | "body1/emphasized" | "label1/emphasized" | "label2/emphasized" | "label3/emphasized" | "label4/emphasized" | "caption1/emphasized" | "caption2/emphasized" | "legal1/emphasized" | "ui1/emphasized" | "ui2/emphasized" | "ui3/emphasized" | "ui4/emphasized" | "ui5/emphasized" | "ui6/emphasized" | undefined;
-  textAlign?: "center" | "justify" | "start" | "end" | undefined;
-  textTransform?: "none" | "display1" | "display2" | "display3" | "title1" | "title2" | "title3" | "title4" | "headline1" | "body1" | "label1" | "label2" | "label3" | "label4" | "caption1" | "caption2" | "legal1" | "ui1" | "ui2" | "ui3" | "ui4" | "ui5" | "ui6" | "display1/emphasized" | "display2/emphasized" | "display3/emphasized" | "title1/emphasized" | "title2/emphasized" | "title3/emphasized" | "title4/emphasized" | "headline1/emphasized" | "body1/emphasized" | "label1/emphasized" | "label2/emphasized" | "label3/emphasized" | "label4/emphasized" | "caption1/emphasized" | "caption2/emphasized" | "legal1/emphasized" | "ui1/emphasized" | "ui2/emphasized" | "ui3/emphasized" | "ui4/emphasized" | "ui5/emphasized" | "ui6/emphasized" | "uppercase" | "lowercase" | "capitalize" | undefined;
-  spacing?: "0" | "1" | "2" | "3" | "4" | "5" | "px" | "0.5" | "1.5" | "2.5" | "3.5" | "4.5" | "5.5" | "6" | "7" | "8" | "9" | "10" | "11" | "12" | "14" | "16" | "20" | "24" | "28" | "32" | "36" | "40" | "44" | "48" | "52" | "56" | "60" | "64" | "72" | "80" | "96" | undefined;
-  spacingHorizontal?: "0" | "1" | "2" | "3" | "4" | "5" | "px" | "0.5" | "1.5" | "2.5" | "3.5" | "4.5" | "5.5" | "6" | "7" | "8" | "9" | "10" | "11" | "12" | "14" | "16" | "20" | "24" | "28" | "32" | "36" | "40" | "44" | "48" | "52" | "56" | "60" | "64" | "72" | "80" | "96" | undefined;
-  spacingVertical?: "0" | "1" | "2" | "3" | "4" | "5" | "px" | "0.5" | "1.5" | "2.5" | "3.5" | "4.5" | "5.5" | "6" | "7" | "8" | "9" | "10" | "11" | "12" | "14" | "16" | "20" | "24" | "28" | "32" | "36" | "40" | "44" | "48" | "52" | "56" | "60" | "64" | "72" | "80" | "96" | undefined;
-  spacingBottom?: "0" | "1" | "2" | "3" | "4" | "5" | "px" | "0.5" | "1.5" | "2.5" | "3.5" | "4.5" | "5.5" | "6" | "7" | "8" | "9" | "10" | "11" | "12" | "14" | "16" | "20" | "24" | "28" | "32" | "36" | "40" | "44" | "48" | "52" | "56" | "60" | "64" | "72" | "80" | "96" | undefined;
-  spacingEnd?: "0" | "1" | "2" | "3" | "4" | "5" | "px" | "0.5" | "1.5" | "2.5" | "3.5" | "4.5" | "5.5" | "6" | "7" | "8" | "9" | "10" | "11" | "12" | "14" | "16" | "20" | "24" | "28" | "32" | "36" | "40" | "44" | "48" | "52" | "56" | "60" | "64" | "72" | "80" | "96" | undefined;
-  spacingStart?: "0" | "1" | "2" | "3" | "4" | "5" | "px" | "0.5" | "1.5" | "2.5" | "3.5" | "4.5" | "5.5" | "6" | "7" | "8" | "9" | "10" | "11" | "12" | "14" | "16" | "20" | "24" | "28" | "32" | "36" | "40" | "44" | "48" | "52" | "56" | "60" | "64" | "72" | "80" | "96" | undefined;
-  spacingTop?: "0" | "1" | "2" | "3" | "4" | "5" | "px" | "0.5" | "1.5" | "2.5" | "3.5" | "4.5" | "5.5" | "6" | "7" | "8" | "9" | "10" | "11" | "12" | "14" | "16" | "20" | "24" | "28" | "32" | "36" | "40" | "44" | "48" | "52" | "56" | "60" | "64" | "72" | "80" | "96" | undefined;
-  offset?: "0" | "1" | "2" | "3" | "4" | "5" | "px" | "0.5" | "1.5" | "2.5" | "3.5" | "4.5" | "5.5" | "6" | "7" | "8" | "9" | "10" | "11" | "12" | "14" | "16" | "20" | "24" | "28" | "32" | "36" | "40" | "44" | "48" | "52" | "56" | "60" | "64" | "72" | "80" | "96" | undefined;
-  offsetVertical?: "0" | "1" | "2" | "3" | "4" | "5" | "px" | "0.5" | "1.5" | "2.5" | "3.5" | "4.5" | "5.5" | "6" | "7" | "8" | "9" | "10" | "11" | "12" | "14" | "16" | "20" | "24" | "28" | "32" | "36" | "40" | "44" | "48" | "52" | "56" | "60" | "64" | "72" | "80" | "96" | undefined;
-  offsetHorizontal?: "0" | "1" | "2" | "3" | "4" | "5" | "px" | "0.5" | "1.5" | "2.5" | "3.5" | "4.5" | "5.5" | "6" | "7" | "8" | "9" | "10" | "11" | "12" | "14" | "16" | "20" | "24" | "28" | "32" | "36" | "40" | "44" | "48" | "52" | "56" | "60" | "64" | "72" | "80" | "96" | undefined;
-  offsetBottom?: "0" | "1" | "2" | "3" | "4" | "5" | "px" | "0.5" | "1.5" | "2.5" | "3.5" | "4.5" | "5.5" | "6" | "7" | "8" | "9" | "10" | "11" | "12" | "14" | "16" | "20" | "24" | "28" | "32" | "36" | "40" | "44" | "48" | "52" | "56" | "60" | "64" | "72" | "80" | "96" | undefined;
-  offsetEnd?: "0" | "1" | "2" | "3" | "4" | "5" | "px" | "0.5" | "1.5" | "2.5" | "3.5" | "4.5" | "5.5" | "6" | "7" | "8" | "9" | "10" | "11" | "12" | "14" | "16" | "20" | "24" | "28" | "32" | "36" | "40" | "44" | "48" | "52" | "56" | "60" | "64" | "72" | "80" | "96" | undefined;
-  offsetStart?: "0" | "1" | "2" | "3" | "4" | "5" | "px" | "0.5" | "1.5" | "2.5" | "3.5" | "4.5" | "5.5" | "6" | "7" | "8" | "9" | "10" | "11" | "12" | "14" | "16" | "20" | "24" | "28" | "32" | "36" | "40" | "44" | "48" | "52" | "56" | "60" | "64" | "72" | "80" | "96" | undefined;
-  offsetTop?: "0" | "1" | "2" | "3" | "4" | "5" | "px" | "0.5" | "1.5" | "2.5" | "3.5" | "4.5" | "5.5" | "6" | "7" | "8" | "9" | "10" | "11" | "12" | "14" | "16" | "20" | "24" | "28" | "32" | "36" | "40" | "44" | "48" | "52" | "56" | "60" | "64" | "72" | "80" | "96" | undefined;
-  columnGap?: "0" | "1" | "2" | "3" | "4" | "5" | "px" | "0.5" | "1.5" | "2.5" | "3.5" | "4.5" | "5.5" | "6" | "7" | "8" | "9" | "10" | "11" | "12" | "14" | "16" | "20" | "24" | "28" | "32" | "36" | "40" | "44" | "48" | "52" | "56" | "60" | "64" | "72" | "80" | "96" | undefined;
-  rowGap?: "0" | "1" | "2" | "3" | "4" | "5" | "px" | "0.5" | "1.5" | "2.5" | "3.5" | "4.5" | "5.5" | "6" | "7" | "8" | "9" | "10" | "11" | "12" | "14" | "16" | "20" | "24" | "28" | "32" | "36" | "40" | "44" | "48" | "52" | "56" | "60" | "64" | "72" | "80" | "96" | undefined;
-  backgroundColor?: "primary" | "secondary" | "accent" | "brand" | "alert" | "positive" | "warning" | "info" | "brand-secondary" | "alert-secondary" | "positive-secondary" | "warning-secondary" | "info-secondary" | "white" | "black" | "transparent" | "current" | "always/white" | "always/black" | "always/transparent" | "always/current" | "always/brand" | "always/accent" | "elevation-0" | "elevation-1" | "elevation-2" | "elevation-3" | "elevation-4" | "elevation-5" | undefined;
-  borderColor?: "primary" | "secondary" | "accent" | "brand" | "alert" | "positive" | "warning" | "info" | "brand-secondary" | "alert-secondary" | "positive-secondary" | "warning-secondary" | "info-secondary" | "white" | "black" | "transparent" | "current" | "always/white" | "always/black" | "always/transparent" | "always/current" | "always/brand" | "always/accent" | "elevation-0" | "elevation-1" | "elevation-2" | "elevation-3" | "elevation-4" | "elevation-5" | "tertiary" | "muted" | undefined;
-  borderStartColor?: "primary" | "secondary" | "accent" | "brand" | "alert" | "positive" | "warning" | "info" | "brand-secondary" | "alert-secondary" | "positive-secondary" | "warning-secondary" | "info-secondary" | "white" | "black" | "transparent" | "current" | "always/white" | "always/black" | "always/transparent" | "always/current" | "always/brand" | "always/accent" | "elevation-0" | "elevation-1" | "elevation-2" | "elevation-3" | "elevation-4" | "elevation-5" | "tertiary" | "muted" | undefined;
-  borderEndColor?: "primary" | "secondary" | "accent" | "brand" | "alert" | "positive" | "warning" | "info" | "brand-secondary" | "alert-secondary" | "positive-secondary" | "warning-secondary" | "info-secondary" | "white" | "black" | "transparent" | "current" | "always/white" | "always/black" | "always/transparent" | "always/current" | "always/brand" | "always/accent" | "elevation-0" | "elevation-1" | "elevation-2" | "elevation-3" | "elevation-4" | "elevation-5" | "tertiary" | "muted" | undefined;
-  borderBottomColor?: "primary" | "secondary" | "accent" | "brand" | "alert" | "positive" | "warning" | "info" | "brand-secondary" | "alert-secondary" | "positive-secondary" | "warning-secondary" | "info-secondary" | "white" | "black" | "transparent" | "current" | "always/white" | "always/black" | "always/transparent" | "always/current" | "always/brand" | "always/accent" | "elevation-0" | "elevation-1" | "elevation-2" | "elevation-3" | "elevation-4" | "elevation-5" | "tertiary" | "muted" | undefined;
-  borderTopColor?: "primary" | "secondary" | "accent" | "brand" | "alert" | "positive" | "warning" | "info" | "brand-secondary" | "alert-secondary" | "positive-secondary" | "warning-secondary" | "info-secondary" | "white" | "black" | "transparent" | "current" | "always/white" | "always/black" | "always/transparent" | "always/current" | "always/brand" | "always/accent" | "elevation-0" | "elevation-1" | "elevation-2" | "elevation-3" | "elevation-4" | "elevation-5" | "tertiary" | "muted" | undefined;
-  borderRadius?: "none" | "xs" | "sm" | "md" | "lg" | "xl" | "full" | undefined;
-  borderTopStartRadius?: "none" | "xs" | "sm" | "md" | "lg" | "xl" | "full" | undefined;
-  borderTopEndRadius?: "none" | "xs" | "sm" | "md" | "lg" | "xl" | "full" | undefined;
-  borderBottomStartRadius?: "none" | "xs" | "sm" | "md" | "lg" | "xl" | "full" | undefined;
-  borderBottomEndRadius?: "none" | "xs" | "sm" | "md" | "lg" | "xl" | "full" | undefined;
-  borderWidth?: "elevation-0" | "elevation-1" | "elevation-2" | "elevation-3" | "elevation-4" | "elevation-5" | "none" | "thin" | "medium" | "thick" | undefined;
-  borderVerticalWidth?: "elevation-0" | "elevation-1" | "elevation-2" | "elevation-3" | "elevation-4" | "elevation-5" | "none" | "thin" | "medium" | "thick" | undefined;
-  borderHorizontalWidth?: "elevation-0" | "elevation-1" | "elevation-2" | "elevation-3" | "elevation-4" | "elevation-5" | "none" | "thin" | "medium" | "thick" | undefined;
-  borderStartWidth?: "elevation-0" | "elevation-1" | "elevation-2" | "elevation-3" | "elevation-4" | "elevation-5" | "none" | "thin" | "medium" | "thick" | undefined;
-  borderEndWidth?: "elevation-0" | "elevation-1" | "elevation-2" | "elevation-3" | "elevation-4" | "elevation-5" | "none" | "thin" | "medium" | "thick" | undefined;
-  borderTopWidth?: "elevation-0" | "elevation-1" | "elevation-2" | "elevation-3" | "elevation-4" | "elevation-5" | "none" | "thin" | "medium" | "thick" | undefined;
-  borderBottomWidth?: "elevation-0" | "elevation-1" | "elevation-2" | "elevation-3" | "elevation-4" | "elevation-5" | "none" | "thin" | "medium" | "thick" | undefined;
-  avatarSize?: "xs" | "sm" | "md" | "lg" | "xl" | "2xl" | "2xs" | "3xl" | undefined;
-  iconSize?: "xs" | "sm" | "md" | "lg" | undefined;
-  alignContent?: "center" | "flex-start" | "flex-end" | "stretch" | "space-between" | "space-around" | undefined;
-  alignItems?: "center" | "flex-start" | "flex-end" | "stretch" | "baseline" | undefined;
-  alignSelf?: "center" | "flex-start" | "flex-end" | "stretch" | "baseline" | "auto" | undefined;
-  flex?: "1" | "none" | "auto" | "initial" | undefined;
-  flexDirection?: "row" | "column" | "row-reverse" | "column-reverse" | undefined;
-  flexGrow?: "0" | "1" | "2" | "3" | undefined;
-  flexShrink?: "0" | "1" | undefined;
-  flexWrap?: "wrap" | "nowrap" | "wrap-reverse" | undefined;
-  justifyContent?: "center" | "flex-start" | "flex-end" | "space-between" | "space-around" | "space-evenly" | undefined;
-  flexBasis?: "min-content" | undefined;
-  display?: "flex" | "table" | "none" | "block" | "inline-block" | "inline" | "inline-flex" | "inline-table" | "table-caption" | "table-cell" | "table-column" | "table-column-group" | "table-footer-group" | "table-header-group" | "table-row-group" | "table-row" | "flow-root" | "grid" | "contents" | undefined;
-  overflow?: "hidden" | "auto" | "clip" | "visible" | "scroll" | undefined;
-  overflowX?: "hidden" | "auto" | "clip" | "visible" | "scroll" | undefined;
-  overflowY?: "hidden" | "auto" | "clip" | "visible" | "scroll" | undefined;
-  position?: "static" | "fixed" | "absolute" | "relative" | "sticky" | undefined;
-  contentFit?: "none" | "fill" | "cover" | "contain" | "scale-down" | undefined;
-  colorMode?: "light" | "dark" | undefined;
-  scaleMode?: "small" | "medium" | "xSmall" | "large" | "xLarge" | "xxLarge" | "xxxLarge" | undefined;
-  width?: "full" | "fit" | "screen" | undefined;
-  height?: "full" | "fit" | "screen" | undefined;
-  dropShadow?: "elevation-0" | "elevation-1" | "elevation-2" | "elevation-3" | "elevation-4" | "elevation-5" | "none" | "xs" | "sm" | "md" | "lg" | "xl" | "2xl" | undefined;
-  insetShadow?: "elevation-0" | "elevation-1" | "elevation-2" | "elevation-3" | "elevation-4" | "elevation-5" | "none" | "xs" | "sm" | "md" | "lg" | "xl" | "2xl" | "xs-invert" | "sm-invert" | "md-invert" | "lg-invert" | "xl-invert" | "2xl-invert" | undefined;
-  nestedBorderRadiusSize?: "none" | "xs" | "sm" | "md" | "lg" | "xl" | "full" | undefined;
-  nestedBorderRadiusWidth?: "elevation-0" | "elevation-1" | "elevation-2" | "elevation-3" | "elevation-4" | "elevation-5" | "none" | "thin" | "medium" | "thick" | undefined;
-  nestedBorderRadiusSpacing?: "0" | "1" | "2" | "3" | "4" | "5" | "px" | "0.5" | "1.5" | "2.5" | "3.5" | "4.5" | "5.5" | "6" | "7" | "8" | "9" | "10" | "11" | "12" | "14" | "16" | "20" | "24" | "28" | "32" | "36" | "40" | "44" | "48" | "52" | "56" | "60" | "64" | "72" | "80" | "96" | undefined;
-  nestedBorderRadius?: boolean | "first" | "last" | undefined;
-} & {
-  className?: string | undefined;
-}) | undefined) => string;
-type GetStylesInternalProps = Parameters<typeof getStylesInternal>[0];
+declare const cx: CX<string>;
+declare const cva: CVA<string>;
+type GetStylesInternalProps = (CVAVariantSchema<string, typeof variants> & {
+  className?: string;
+}) | undefined;
 declare const getStylesCacheKeySymbol: unique symbol;
 declare const getStyles: (props: GetStylesInternalProps, onHit?: () => void) => string;
 //#endregion

package/dist/styles/styler.js

@@ -1,10 +1,9 @@
 /*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
 import { getFeatureFlags } from "../flags.js";
 import { falsyToString } from "../utils/falsyToString.js";
-import { variants } from "./variants.js";
-import { backgroundColors, borderRadii, borderWidthsWithElevation, foregroundColors, lineColors, spectrumColors, textVariants } from "@yahoo/uds/fixtures";
+import { udsTwMerge } from "./udsTailwindMerge.js";
+import { resolveVariantClass } from "./variantClass.js";
 import { clsx } from "clsx";
-import { extendTailwindMerge } from "tailwind-merge";
 //#region src/styles/styler.ts
 const createObjectWithoutPrototype = () => Object.create(null);
 const { useGetStylesCache, skipTailwindMerge } = getFeatureFlags();
@@ -22,32 +21,16 @@ function normalizeObject(props) {
 	return sorted;
 }
 /**
-* !WARNING: The `@__PURE__` annotation below is load-bearing for tree-shaking — do not remove it.
-*
-* Without it, bundlers must assume this module-level call has side effects and keep it (plus
-* `tailwind-merge` and the fixtures color lists it references) in any bundle that imports
-* anything from this module. Do not rename/wrap the call without re-checking bundle output
-* (e.g. `esbuild --bundle --minify` an entry that imports a single lightweight export).
+* !WARNING: The `@__PURE__` annotation on the `createTailwindMerge(...)` call
+* inside `./udsTailwindMerge.ts` is load-bearing for tree-shaking — without
+* it, bundlers must assume the module-level call has side effects and keep
+* the merge engine in any bundle that imports anything from this module. Do
+* not remove it without re-checking bundle output (e.g. `esbuild --bundle
+* --minify` an entry that imports a single lightweight export).
 */
-const twMerge = /* @__PURE__ */ extendTailwindMerge({
-	extend: { theme: {
-		borderColor: lineColors,
-		borderWidth: borderWidthsWithElevation,
-		borderRadius: borderRadii
-	} },
-	override: {
-		classGroups: {
-			"text-color": [{ text: [...foregroundColors, ...spectrumColors] }],
-			"bg-color": [{ bg: backgroundColors }],
-			"font-family": [{ font: ["icons", ...textVariants] }],
-			leading: [{ leading: textVariants }]
-		},
-		conflictingClassGroups: {}
-	}
-});
 const cx = (...inputs) => {
 	const finalClassName = clsx(inputs);
-	return skipTailwindMerge ? finalClassName : twMerge(finalClassName);
+	return skipTailwindMerge ? finalClassName : udsTwMerge(finalClassName);
 };
 const cva = (config) => {
 	const { base, variants, defaultVariants, compoundVariants } = config;
@@ -92,14 +75,26 @@ const cva = (config) => {
 	};
 };
 /**
-* !WARNING: The `@__PURE__` annotation below is load-bearing for tree-shaking — do not remove it.
+* Resolves style/variant props to class names via template substitution
+* (`./variantClass.ts`) instead of a `cva({ variants })` lookup, so neither
+* the hand-written `variants` map nor the auto-generated `autoVariants` map
+* (~70 kB minified combined) ships in the client bundle. Output is identical:
+* the templates are exhaustively verified against the maps in
+* `variantClass.test.ts`.
 *
-* Without it, importing anything from this module (e.g. just `cx`) drags the full `variants`
-* map and the auto-generated `autoVariants` (~70 kB minified) into the bundle, because bundlers
-* must assume the module-level `cva(...)` call has side effects. With it, `getStylesInternal`
-* and its `variants` import are dropped when `getStyles` is unused.
+* !WARNING: This mirrors the `cva()` hot path — same iteration order, same
+* `cx` merge — and is equally performance-sensitive. Benchmark before changing.
 */
-const getStylesInternal = /* @__PURE__ */ cva({ variants });
+const getStylesInternal = (maybeProps) => {
+	if (!maybeProps) return cx();
+	const { className, ...props } = maybeProps;
+	const variantClassNames = [];
+	for (const prop in props) {
+		const propValue = props[prop];
+		variantClassNames.push(resolveVariantClass(prop, falsyToString(propValue)));
+	}
+	return cx(variantClassNames, className);
+};
 const styleCache = /* @__PURE__ */ new Map();
 const getStylesCacheKeySymbol = Symbol("getStylesCacheKey");
 const generateCacheKey = (props) => {

package/dist/styles/stylerTypes.d.cts

@@ -36,4 +36,4 @@ type StylePropsVariants<ReturnType> = { [key in keyof Required<StyleProps>]: Rec
   scaleMode: Record<ScaleMode, string>;
 } & StylePropsVariantsAuto<ReturnType>;
 //#endregion
-export { type CVA, type CX, type StylePropsVariants };
+export { type CVA, type CVAVariantSchema, type CX, type StylePropsVariants };

package/dist/styles/stylerTypes.d.ts

@@ -36,4 +36,4 @@ type StylePropsVariants<ReturnType> = { [key in keyof Required<StyleProps>]: Rec
   scaleMode: Record<ScaleMode, string>;
 } & StylePropsVariantsAuto<ReturnType>;
 //#endregion
-export { type CVA, type CX, type StylePropsVariants };
+export { type CVA, type CVAVariantSchema, type CX, type StylePropsVariants };