@yahoo/uds 3.99.0 → 3.100.0-beta.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (150) hide show
  1. package/dist/automated-config/dist/generated/autoVariants.cjs +10 -1
  2. package/dist/automated-config/dist/generated/autoVariants.d.cts +9 -0
  3. package/dist/automated-config/dist/generated/autoVariants.d.ts +9 -0
  4. package/dist/automated-config/dist/generated/autoVariants.js +10 -1
  5. package/dist/automated-config/dist/generated/generatedConfigs.cjs +1640 -1
  6. package/dist/automated-config/dist/generated/generatedConfigs.d.cts +405 -189
  7. package/dist/automated-config/dist/generated/generatedConfigs.d.ts +405 -189
  8. package/dist/automated-config/dist/generated/generatedConfigs.js +1639 -1
  9. package/dist/automated-config/dist/generated/universalTokensConfigAuto.cjs +94 -0
  10. package/dist/automated-config/dist/generated/universalTokensConfigAuto.d.cts +2 -1
  11. package/dist/automated-config/dist/generated/universalTokensConfigAuto.d.ts +2 -1
  12. package/dist/automated-config/dist/generated/universalTokensConfigAuto.js +94 -0
  13. package/dist/automated-config/dist/properties.cjs +147 -89
  14. package/dist/automated-config/dist/properties.d.cts +24 -3
  15. package/dist/automated-config/dist/properties.d.ts +24 -3
  16. package/dist/automated-config/dist/properties.js +148 -90
  17. package/dist/automated-config/dist/utils/buildConfigSchema.cjs +5 -1
  18. package/dist/automated-config/dist/utils/buildConfigSchema.d.cts +2 -1
  19. package/dist/automated-config/dist/utils/buildConfigSchema.d.ts +2 -1
  20. package/dist/automated-config/dist/utils/buildConfigSchema.js +5 -1
  21. package/dist/automated-config/dist/utils/getConfigVariantProperties.d.cts +2 -2
  22. package/dist/automated-config/dist/utils/getConfigVariantProperties.d.ts +2 -2
  23. package/dist/automated-config/dist/utils/index.d.cts +6 -1
  24. package/dist/automated-config/dist/utils/index.d.ts +6 -1
  25. package/dist/cli/commands/sync.cjs +5 -1
  26. package/dist/cli/commands/sync.js +5 -1
  27. package/dist/components/client/Button.js +2 -2
  28. package/dist/components/client/Tooltip/Tooltip.cjs +37 -0
  29. package/dist/components/client/Tooltip/Tooltip.d.cts +16 -0
  30. package/dist/components/client/Tooltip/Tooltip.d.ts +16 -0
  31. package/dist/components/client/Tooltip/Tooltip.js +35 -0
  32. package/dist/components/client/Tooltip/TooltipContent.cjs +174 -0
  33. package/dist/components/client/Tooltip/TooltipContent.d.cts +8 -0
  34. package/dist/components/client/Tooltip/TooltipContent.d.ts +8 -0
  35. package/dist/components/client/Tooltip/TooltipContent.js +172 -0
  36. package/dist/components/client/Tooltip/TooltipTrigger.cjs +20 -0
  37. package/dist/components/client/Tooltip/TooltipTrigger.d.cts +13 -0
  38. package/dist/components/client/Tooltip/TooltipTrigger.d.ts +13 -0
  39. package/dist/components/client/Tooltip/TooltipTrigger.js +18 -0
  40. package/dist/components/client/Tooltip/UDSTooltipConfigProvider.cjs +41 -0
  41. package/dist/components/client/Tooltip/UDSTooltipConfigProvider.d.cts +29 -0
  42. package/dist/components/client/Tooltip/UDSTooltipConfigProvider.d.ts +29 -0
  43. package/dist/components/client/Tooltip/UDSTooltipConfigProvider.js +38 -0
  44. package/dist/components/client/Tooltip/index.cjs +12 -0
  45. package/dist/components/client/Tooltip/index.d.cts +7 -0
  46. package/dist/components/client/Tooltip/index.d.ts +7 -0
  47. package/dist/components/client/Tooltip/index.js +8 -0
  48. package/dist/components/client/Tooltip/tooltipContext.cjs +12 -0
  49. package/dist/components/client/Tooltip/tooltipContext.d.cts +12 -0
  50. package/dist/components/client/Tooltip/tooltipContext.d.ts +12 -0
  51. package/dist/components/client/Tooltip/tooltipContext.js +10 -0
  52. package/dist/components/client/Tooltip/useTooltipContent.cjs +199 -0
  53. package/dist/components/client/Tooltip/useTooltipContent.d.cts +65 -0
  54. package/dist/components/client/Tooltip/useTooltipContent.d.ts +65 -0
  55. package/dist/components/client/Tooltip/useTooltipContent.js +197 -0
  56. package/dist/components/client/Tooltip/util.cjs +248 -0
  57. package/dist/components/client/Tooltip/util.d.cts +118 -0
  58. package/dist/components/client/Tooltip/util.d.ts +118 -0
  59. package/dist/components/client/Tooltip/util.js +240 -0
  60. package/dist/components/client/index.cjs +8 -0
  61. package/dist/components/client/index.d.cts +7 -1
  62. package/dist/components/client/index.d.ts +7 -1
  63. package/dist/components/client/index.js +5 -1
  64. package/dist/components/client/providers/UDSConfigProvider.cjs +6 -2
  65. package/dist/components/client/providers/UDSConfigProvider.d.cts +2 -1
  66. package/dist/components/client/providers/UDSConfigProvider.d.ts +2 -1
  67. package/dist/components/client/providers/UDSConfigProvider.js +6 -2
  68. package/dist/components/index.cjs +8 -0
  69. package/dist/components/index.d.cts +6 -1
  70. package/dist/components/index.d.ts +6 -1
  71. package/dist/components/index.js +5 -1
  72. package/dist/config/dist/index.cjs +95 -1
  73. package/dist/config/dist/index.d.cts +139 -1
  74. package/dist/config/dist/index.d.ts +139 -1
  75. package/dist/config/dist/index.js +95 -1
  76. package/dist/css-tokens/dist/index.cjs +2 -0
  77. package/dist/css-tokens/dist/index.d.cts +2 -1
  78. package/dist/css-tokens/dist/index.d.ts +2 -1
  79. package/dist/css-tokens/dist/index.js +2 -1
  80. package/dist/fixtures/dist/arbitrary.d.cts +11 -0
  81. package/dist/fixtures/dist/arbitrary.d.ts +11 -0
  82. package/dist/fixtures/dist/index.cjs +27 -1
  83. package/dist/fixtures/dist/index.d.cts +17 -3
  84. package/dist/fixtures/dist/index.d.ts +17 -3
  85. package/dist/fixtures/dist/index.js +26 -2
  86. package/dist/fixtures/index.cjs +6 -1
  87. package/dist/fixtures/index.d.cts +4 -2
  88. package/dist/fixtures/index.d.ts +4 -2
  89. package/dist/fixtures/index.js +3 -2
  90. package/dist/fixtures/src/arbitrary.cjs +23 -0
  91. package/dist/fixtures/src/arbitrary.d.cts +15 -0
  92. package/dist/fixtures/src/arbitrary.d.ts +15 -0
  93. package/dist/fixtures/src/arbitrary.js +18 -0
  94. package/dist/fixtures/src/util.cjs +26 -0
  95. package/dist/fixtures/src/util.d.cts +9 -0
  96. package/dist/fixtures/src/util.d.ts +9 -0
  97. package/dist/fixtures/src/util.js +25 -0
  98. package/dist/index.cjs +12 -0
  99. package/dist/index.d.cts +9 -4
  100. package/dist/index.d.ts +9 -4
  101. package/dist/index.js +8 -3
  102. package/dist/runtime/index.cjs +2 -0
  103. package/dist/runtime/index.d.cts +2 -1
  104. package/dist/runtime/index.d.ts +2 -1
  105. package/dist/runtime/index.js +2 -1
  106. package/dist/runtime/tooltipConfig.cjs +50 -0
  107. package/dist/runtime/tooltipConfig.d.cts +21 -0
  108. package/dist/runtime/tooltipConfig.d.ts +21 -0
  109. package/dist/runtime/tooltipConfig.js +49 -0
  110. package/dist/runtime/udsConfig.cjs +3 -1
  111. package/dist/runtime/udsConfig.d.cts +2 -0
  112. package/dist/runtime/udsConfig.d.ts +2 -0
  113. package/dist/runtime/udsConfig.js +3 -1
  114. package/dist/styles/styler.d.cts +30 -21
  115. package/dist/styles/styler.d.ts +30 -21
  116. package/dist/styles/variants.d.cts +27 -0
  117. package/dist/styles/variants.d.ts +27 -0
  118. package/dist/tailwind/plugins/blurBgFallback.cjs +30 -0
  119. package/dist/tailwind/plugins/blurBgFallback.d.cts +14 -0
  120. package/dist/tailwind/plugins/blurBgFallback.d.ts +14 -0
  121. package/dist/tailwind/plugins/blurBgFallback.js +27 -0
  122. package/dist/tailwind/plugins/components.cjs +1 -0
  123. package/dist/tailwind/plugins/components.js +2 -1
  124. package/dist/tailwind/tailwindPlugin.cjs +2 -1
  125. package/dist/tailwind/tailwindPlugin.js +2 -1
  126. package/dist/tokens/automation/configs/index.cjs +2 -1
  127. package/dist/tokens/automation/configs/index.d.cts +2 -2
  128. package/dist/tokens/automation/configs/index.d.ts +2 -2
  129. package/dist/tokens/automation/configs/index.js +2 -2
  130. package/dist/tokens/automation/index.cjs +1 -0
  131. package/dist/tokens/automation/index.d.cts +2 -2
  132. package/dist/tokens/automation/index.d.ts +2 -2
  133. package/dist/tokens/automation/index.js +2 -2
  134. package/dist/tokens/automation/properties.d.cts +2 -2
  135. package/dist/tokens/automation/properties.d.ts +2 -2
  136. package/dist/tokens/consts/cssTokens.cjs +1 -0
  137. package/dist/tokens/consts/cssTokens.d.cts +2 -2
  138. package/dist/tokens/consts/cssTokens.d.ts +2 -2
  139. package/dist/tokens/consts/cssTokens.js +2 -2
  140. package/dist/tokens/index.cjs +2 -0
  141. package/dist/tokens/index.d.cts +4 -4
  142. package/dist/tokens/index.d.ts +4 -4
  143. package/dist/tokens/index.js +3 -3
  144. package/dist/tokens/types.d.cts +2 -2
  145. package/dist/tokens/types.d.ts +2 -2
  146. package/dist/types/dist/index.d.cts +25 -2
  147. package/dist/types/dist/index.d.ts +25 -2
  148. package/dist/uds/generated/tailwindPurge.cjs +31 -2
  149. package/dist/uds/generated/tailwindPurge.js +31 -2
  150. package/package.json +1 -2
@@ -0,0 +1,38 @@
1
+ "use client";
2
+ /*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
3
+ import { createContext, useContext } from "react";
4
+ import { jsx } from "react/jsx-runtime";
5
+
6
+ //#region src/components/client/Tooltip/UDSTooltipConfigProvider.tsx
7
+ const TooltipContext = createContext(void 0);
8
+ const UDSTooltipConfigProvider = ({ children, value }) => {
9
+ const existingContext = useContext(TooltipContext);
10
+ if ("type" in value) {
11
+ if (!existingContext) throw new Error("Cannot merge context values without an existing TooltipContext");
12
+ return /* @__PURE__ */ jsx(TooltipContext.Provider, {
13
+ value: {
14
+ ...existingContext,
15
+ ...value.value
16
+ },
17
+ children
18
+ });
19
+ }
20
+ return /* @__PURE__ */ jsx(TooltipContext.Provider, {
21
+ value,
22
+ children
23
+ });
24
+ };
25
+ UDSTooltipConfigProvider.displayName = "UDSTooltipConfigProvider";
26
+ function useTooltipConfig(options) {
27
+ const context = useContext(TooltipContext);
28
+ if (!context) throw new Error("useTooltipConfig must be used within a UDSConfigProvider or UDSTooltipConfigProvider");
29
+ const { placementMap, ...contextRest } = context;
30
+ if (options) return {
31
+ ...contextRest,
32
+ ariaKitPlacement: placementMap[options.placement]
33
+ };
34
+ return contextRest;
35
+ }
36
+
37
+ //#endregion
38
+ export { UDSTooltipConfigProvider, useTooltipConfig };
@@ -0,0 +1,12 @@
1
+ "use client";
2
+ /*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
3
+ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
4
+ const require_components_client_Tooltip_UDSTooltipConfigProvider = require('./UDSTooltipConfigProvider.cjs');
5
+ const require_components_client_Tooltip_Tooltip = require('./Tooltip.cjs');
6
+ const require_components_client_Tooltip_TooltipContent = require('./TooltipContent.cjs');
7
+ const require_components_client_Tooltip_TooltipTrigger = require('./TooltipTrigger.cjs');
8
+
9
+ exports.Tooltip = require_components_client_Tooltip_Tooltip.Tooltip;
10
+ exports.TooltipContent = require_components_client_Tooltip_TooltipContent.TooltipContent;
11
+ exports.TooltipTrigger = require_components_client_Tooltip_TooltipTrigger.TooltipTrigger;
12
+ exports.UDSTooltipConfigProvider = require_components_client_Tooltip_UDSTooltipConfigProvider.UDSTooltipConfigProvider;
@@ -0,0 +1,7 @@
1
+
2
+ import { UniversalTooltipContentProps, UniversalTooltipProps, UniversalTooltipTriggerProps } from "../../../types/dist/index.cjs";
3
+ import { Tooltip } from "./Tooltip.cjs";
4
+ import { TooltipContent } from "./TooltipContent.cjs";
5
+ import { TooltipTrigger } from "./TooltipTrigger.cjs";
6
+ import { UDSTooltipConfigProvider, UDSTooltipConfigProviderProps } from "./UDSTooltipConfigProvider.cjs";
7
+ export { Tooltip, TooltipContent, type UniversalTooltipContentProps as TooltipContentProps, type UniversalTooltipProps as TooltipProps, TooltipTrigger, type UniversalTooltipTriggerProps as TooltipTriggerProps, UDSTooltipConfigProvider, type UDSTooltipConfigProviderProps };
@@ -0,0 +1,7 @@
1
+
2
+ import { UniversalTooltipContentProps, UniversalTooltipProps, UniversalTooltipTriggerProps } from "../../../types/dist/index.js";
3
+ import { Tooltip } from "./Tooltip.js";
4
+ import { TooltipContent } from "./TooltipContent.js";
5
+ import { TooltipTrigger } from "./TooltipTrigger.js";
6
+ import { UDSTooltipConfigProvider, UDSTooltipConfigProviderProps } from "./UDSTooltipConfigProvider.js";
7
+ export { Tooltip, TooltipContent, type UniversalTooltipContentProps as TooltipContentProps, type UniversalTooltipProps as TooltipProps, TooltipTrigger, type UniversalTooltipTriggerProps as TooltipTriggerProps, UDSTooltipConfigProvider, type UDSTooltipConfigProviderProps };
@@ -0,0 +1,8 @@
1
+ "use client";
2
+ /*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
3
+ import { UDSTooltipConfigProvider } from "./UDSTooltipConfigProvider.js";
4
+ import { Tooltip } from "./Tooltip.js";
5
+ import { TooltipContent } from "./TooltipContent.js";
6
+ import { TooltipTrigger } from "./TooltipTrigger.js";
7
+
8
+ export { Tooltip, TooltipContent, TooltipTrigger, UDSTooltipConfigProvider };
@@ -0,0 +1,12 @@
1
+ "use client";
2
+ /*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
3
+ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
4
+ const require_runtime = require('../../../_virtual/_rolldown/runtime.cjs');
5
+ let react = require("react");
6
+
7
+ //#region src/components/client/Tooltip/tooltipContext.tsx
8
+ /** When true, tooltip content should hide when pointer leaves anchor/tooltip. */
9
+ const TooltipInternalContext = (0, react.createContext)(null);
10
+
11
+ //#endregion
12
+ exports.TooltipInternalContext = TooltipInternalContext;
@@ -0,0 +1,12 @@
1
+
2
+ import * as react from "react";
3
+
4
+ //#region src/components/client/Tooltip/tooltipContext.d.ts
5
+ interface TooltipInternalContextType {
6
+ hideOnHoverOutside: boolean;
7
+ portal: boolean;
8
+ }
9
+ /** When true, tooltip content should hide when pointer leaves anchor/tooltip. */
10
+ declare const TooltipInternalContext: react.Context<TooltipInternalContextType | null>;
11
+ //#endregion
12
+ export { TooltipInternalContext };
@@ -0,0 +1,12 @@
1
+
2
+ import * as react from "react";
3
+
4
+ //#region src/components/client/Tooltip/tooltipContext.d.ts
5
+ interface TooltipInternalContextType {
6
+ hideOnHoverOutside: boolean;
7
+ portal: boolean;
8
+ }
9
+ /** When true, tooltip content should hide when pointer leaves anchor/tooltip. */
10
+ declare const TooltipInternalContext: react.Context<TooltipInternalContextType | null>;
11
+ //#endregion
12
+ export { TooltipInternalContext };
@@ -0,0 +1,10 @@
1
+ "use client";
2
+ /*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
3
+ import { createContext } from "react";
4
+
5
+ //#region src/components/client/Tooltip/tooltipContext.tsx
6
+ /** When true, tooltip content should hide when pointer leaves anchor/tooltip. */
7
+ const TooltipInternalContext = createContext(null);
8
+
9
+ //#endregion
10
+ export { TooltipInternalContext };
@@ -0,0 +1,199 @@
1
+ "use client";
2
+ /*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
3
+ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
4
+ const require_runtime = require('../../../_virtual/_rolldown/runtime.cjs');
5
+ const require_index = require('../../../css-tokens/dist/index.cjs');
6
+ const require_components_client_Tooltip_util = require('./util.cjs');
7
+ let react = require("react");
8
+
9
+ //#region src/components/client/Tooltip/useTooltipContent.ts
10
+ function useTooltipContent({ open, effectivePlacement, maxWidth, borderRadius, arrowRef }) {
11
+ const internalRef = (0, react.useRef)(null);
12
+ const shadowFilterId = (0, react.useId)();
13
+ const [dimensions, setDimensions] = (0, react.useState)({
14
+ width: 0,
15
+ height: 0
16
+ });
17
+ const maxWidthClass = (0, react.useMemo)(() => {
18
+ if (maxWidth !== void 0) return typeof maxWidth === "number" ? `max-w-[${maxWidth}px]` : `max-w-[${maxWidth}]`;
19
+ return "max-w-lg";
20
+ }, [maxWidth]);
21
+ (0, react.useEffect)(() => {
22
+ const el = internalRef.current;
23
+ if (!el) return;
24
+ const observer = new ResizeObserver(() => {
25
+ setDimensions({
26
+ width: el.offsetWidth,
27
+ height: el.offsetHeight
28
+ });
29
+ });
30
+ observer.observe(el);
31
+ return () => observer.disconnect();
32
+ }, [open]);
33
+ const [shadows, setShadows] = (0, react.useState)([]);
34
+ const shadowValueRef = (0, react.useRef)("");
35
+ const readShadows = (0, react.useCallback)(() => {
36
+ if (!internalRef.current) return;
37
+ const shadowValue = getComputedStyle(internalRef.current).getPropertyValue(`--${require_index.DROP_SHADOW_PREFIX}`);
38
+ if (shadowValue !== shadowValueRef.current) {
39
+ shadowValueRef.current = shadowValue;
40
+ setShadows(require_components_client_Tooltip_util.parseShadow(shadowValue));
41
+ }
42
+ }, []);
43
+ const shadowPadding = (0, react.useMemo)(() => {
44
+ if (shadows.length === 0) return 0;
45
+ return shadows.reduce((max, s) => {
46
+ const extentX = Math.abs(s.x) + s.blur + Math.abs(s.spread);
47
+ const extentY = Math.abs(s.y) + s.blur + Math.abs(s.spread);
48
+ return Math.max(max, extentX, extentY);
49
+ }, 0);
50
+ }, [shadows]);
51
+ const [colorScheme, setColorScheme] = (0, react.useState)("light");
52
+ const readColorScheme = (0, react.useCallback)(() => {
53
+ const el = internalRef.current;
54
+ if (!el) return;
55
+ const scheme = getComputedStyle(el).colorScheme;
56
+ setColorScheme(scheme === "dark" ? "dark" : "light");
57
+ }, []);
58
+ const [arrowCenter, setArrowCenter] = (0, react.useState)(void 0);
59
+ const computeArrowCenter = (0, react.useCallback)(() => {
60
+ const arrowEl = arrowRef.current;
61
+ const tooltipEl = internalRef.current;
62
+ if (!arrowEl || !tooltipEl) return;
63
+ const arrowRect = arrowEl.getBoundingClientRect();
64
+ const tooltipRect = tooltipEl.getBoundingClientRect();
65
+ const side = require_components_client_Tooltip_util.getArrowSide(effectivePlacement);
66
+ const raw = side === "top" || side === "bottom" ? arrowRect.left + arrowRect.width / 2 - tooltipRect.left : arrowRect.top + arrowRect.height / 2 - tooltipRect.top;
67
+ return Math.round(raw);
68
+ }, [arrowRef, effectivePlacement]);
69
+ const onPositionUpdate = (0, react.useCallback)(async ({ updatePosition }) => {
70
+ await updatePosition();
71
+ const el = internalRef.current;
72
+ if (el) {
73
+ const { offsetWidth, offsetHeight } = el;
74
+ if (offsetWidth > 0 && offsetHeight > 0) setDimensions((prev) => {
75
+ if (prev.width === offsetWidth && prev.height === offsetHeight) return prev;
76
+ return {
77
+ width: offsetWidth,
78
+ height: offsetHeight
79
+ };
80
+ });
81
+ readShadows();
82
+ readColorScheme();
83
+ }
84
+ const next = computeArrowCenter();
85
+ if (next !== void 0) setArrowCenter((prev) => prev === next ? prev : next);
86
+ }, [
87
+ computeArrowCenter,
88
+ readShadows,
89
+ readColorScheme
90
+ ]);
91
+ const svgPath = (0, react.useMemo)(() => {
92
+ return dimensions.width > 0 && dimensions.height > 0 ? require_components_client_Tooltip_util.generateTooltipPath({
93
+ width: dimensions.width,
94
+ height: dimensions.height,
95
+ placement: effectivePlacement,
96
+ borderRadius,
97
+ arrowCenter
98
+ }) : null;
99
+ }, [
100
+ effectivePlacement,
101
+ dimensions.width,
102
+ dimensions.height,
103
+ borderRadius,
104
+ arrowCenter
105
+ ]);
106
+ const blurClipPath = (0, react.useMemo)(() => {
107
+ if (dimensions.width <= 0 || dimensions.height <= 0) return null;
108
+ const arrowSide = require_components_client_Tooltip_util.getArrowSide(effectivePlacement);
109
+ const offsetX = arrowSide === "left" ? require_components_client_Tooltip_util.ARROW_HEIGHT : 0;
110
+ const offsetY = arrowSide === "top" ? require_components_client_Tooltip_util.ARROW_HEIGHT : 0;
111
+ return require_components_client_Tooltip_util.generateTooltipPath({
112
+ width: dimensions.width,
113
+ height: dimensions.height,
114
+ placement: effectivePlacement,
115
+ borderRadius,
116
+ arrowCenter,
117
+ offsetX,
118
+ offsetY
119
+ });
120
+ }, [
121
+ effectivePlacement,
122
+ dimensions.width,
123
+ dimensions.height,
124
+ borderRadius,
125
+ arrowCenter
126
+ ]);
127
+ const blurStyle = (0, react.useMemo)(() => {
128
+ const style = { clipPath: blurClipPath ? `path('${blurClipPath}')` : void 0 };
129
+ switch (require_components_client_Tooltip_util.getArrowSide(effectivePlacement)) {
130
+ case "top":
131
+ style.height = `calc(100% + ${require_components_client_Tooltip_util.ARROW_HEIGHT}px)`;
132
+ style.top = "auto";
133
+ style.bottom = "0";
134
+ break;
135
+ case "bottom":
136
+ style.height = `calc(100% + ${require_components_client_Tooltip_util.ARROW_HEIGHT}px)`;
137
+ break;
138
+ case "left":
139
+ style.width = `calc(100% + ${require_components_client_Tooltip_util.ARROW_HEIGHT}px)`;
140
+ style.left = "auto";
141
+ style.right = "0";
142
+ break;
143
+ case "right":
144
+ style.width = `calc(100% + ${require_components_client_Tooltip_util.ARROW_HEIGHT}px)`;
145
+ break;
146
+ }
147
+ return style;
148
+ }, [blurClipPath, effectivePlacement]);
149
+ const [visible, setVisible] = (0, react.useState)(false);
150
+ if ((!open || !svgPath) && visible) setVisible(false);
151
+ (0, react.useEffect)(() => {
152
+ if (open && svgPath) {
153
+ const raf = requestAnimationFrame(() => {
154
+ setVisible(true);
155
+ });
156
+ return () => cancelAnimationFrame(raf);
157
+ }
158
+ }, [open, svgPath]);
159
+ return {
160
+ internalRef,
161
+ shadowFilterId,
162
+ maxWidthClass,
163
+ dimensions,
164
+ shadows,
165
+ shadowPadding,
166
+ svgPath,
167
+ blurClipPath,
168
+ blurStyle,
169
+ visible,
170
+ childTransitionStyle: {
171
+ opacity: visible ? 1 : 0,
172
+ transition: "opacity 200ms ease-in-out"
173
+ },
174
+ colorScheme,
175
+ tooltipShift: (0, react.useMemo)(() => {
176
+ if (arrowCenter === void 0 || dimensions.width <= 0 || dimensions.height <= 0) return {
177
+ x: 0,
178
+ y: 0
179
+ };
180
+ return require_components_client_Tooltip_util.getArrowClampDelta({
181
+ width: dimensions.width,
182
+ height: dimensions.height,
183
+ placement: effectivePlacement,
184
+ borderRadius,
185
+ arrowCenter
186
+ });
187
+ }, [
188
+ arrowCenter,
189
+ dimensions.width,
190
+ dimensions.height,
191
+ effectivePlacement,
192
+ borderRadius
193
+ ]),
194
+ onPositionUpdate
195
+ };
196
+ }
197
+
198
+ //#endregion
199
+ exports.useTooltipContent = useTooltipContent;
@@ -0,0 +1,65 @@
1
+
2
+ import { ParsedShadow } from "./util.cjs";
3
+ import { CSSProperties, RefObject } from "react";
4
+
5
+ //#region src/components/client/Tooltip/useTooltipContent.d.ts
6
+ interface UseTooltipContentOptions {
7
+ /** Whether the tooltip is currently open. */
8
+ open: boolean;
9
+ /** Resolved placement after Ariakit positioning (e.g. `'top'`, `'bottom-start'`). */
10
+ effectivePlacement: string;
11
+ /** Optional max-width override (number = px, string = CSS value). */
12
+ maxWidth?: number | string;
13
+ /** Border-radius from the tooltip config (px). */
14
+ borderRadius: number;
15
+ /**
16
+ * Ref to the Ariakit `TooltipArrow` element. Its position (set by
17
+ * floating-ui) is read inside the `updatePosition` callback so the
18
+ * SVG arrow always mirrors where floating-ui places the native arrow.
19
+ */
20
+ arrowRef: RefObject<HTMLDivElement | null>;
21
+ }
22
+ interface UseTooltipContentReturn {
23
+ internalRef: RefObject<HTMLElement | null>;
24
+ shadowFilterId: string;
25
+ maxWidthClass: string;
26
+ dimensions: {
27
+ width: number;
28
+ height: number;
29
+ };
30
+ shadows: ParsedShadow[];
31
+ shadowPadding: number;
32
+ svgPath: string | null;
33
+ blurClipPath: string | null;
34
+ blurStyle: CSSProperties;
35
+ visible: boolean;
36
+ childTransitionStyle: CSSProperties;
37
+ /** Resolved CSS `color-scheme` of the tooltip element: `'light'` or `'dark'`. */
38
+ colorScheme: 'light' | 'dark';
39
+ /**
40
+ * Pixel offset to apply as a CSS transform on the tooltip element so that
41
+ * the (clamped) SVG arrow aligns with the trigger center even when the
42
+ * trigger is too small / close to a rounded corner for the arrow to reach.
43
+ */
44
+ tooltipShift: {
45
+ x: number;
46
+ y: number;
47
+ };
48
+ /**
49
+ * Pass as the `updatePosition` prop to the Ariakit `<Tooltip>` component.
50
+ * This hooks into floating-ui's positioning lifecycle so the SVG arrow
51
+ * center is read after every `computePosition`
52
+ */
53
+ onPositionUpdate: (props: {
54
+ updatePosition: () => Promise<void>;
55
+ }) => Promise<void>;
56
+ }
57
+ declare function useTooltipContent({
58
+ open,
59
+ effectivePlacement,
60
+ maxWidth,
61
+ borderRadius,
62
+ arrowRef
63
+ }: UseTooltipContentOptions): UseTooltipContentReturn;
64
+ //#endregion
65
+ export { type UseTooltipContentOptions, type UseTooltipContentReturn, useTooltipContent };
@@ -0,0 +1,65 @@
1
+
2
+ import { ParsedShadow } from "./util.js";
3
+ import { CSSProperties, RefObject } from "react";
4
+
5
+ //#region src/components/client/Tooltip/useTooltipContent.d.ts
6
+ interface UseTooltipContentOptions {
7
+ /** Whether the tooltip is currently open. */
8
+ open: boolean;
9
+ /** Resolved placement after Ariakit positioning (e.g. `'top'`, `'bottom-start'`). */
10
+ effectivePlacement: string;
11
+ /** Optional max-width override (number = px, string = CSS value). */
12
+ maxWidth?: number | string;
13
+ /** Border-radius from the tooltip config (px). */
14
+ borderRadius: number;
15
+ /**
16
+ * Ref to the Ariakit `TooltipArrow` element. Its position (set by
17
+ * floating-ui) is read inside the `updatePosition` callback so the
18
+ * SVG arrow always mirrors where floating-ui places the native arrow.
19
+ */
20
+ arrowRef: RefObject<HTMLDivElement | null>;
21
+ }
22
+ interface UseTooltipContentReturn {
23
+ internalRef: RefObject<HTMLElement | null>;
24
+ shadowFilterId: string;
25
+ maxWidthClass: string;
26
+ dimensions: {
27
+ width: number;
28
+ height: number;
29
+ };
30
+ shadows: ParsedShadow[];
31
+ shadowPadding: number;
32
+ svgPath: string | null;
33
+ blurClipPath: string | null;
34
+ blurStyle: CSSProperties;
35
+ visible: boolean;
36
+ childTransitionStyle: CSSProperties;
37
+ /** Resolved CSS `color-scheme` of the tooltip element: `'light'` or `'dark'`. */
38
+ colorScheme: 'light' | 'dark';
39
+ /**
40
+ * Pixel offset to apply as a CSS transform on the tooltip element so that
41
+ * the (clamped) SVG arrow aligns with the trigger center even when the
42
+ * trigger is too small / close to a rounded corner for the arrow to reach.
43
+ */
44
+ tooltipShift: {
45
+ x: number;
46
+ y: number;
47
+ };
48
+ /**
49
+ * Pass as the `updatePosition` prop to the Ariakit `<Tooltip>` component.
50
+ * This hooks into floating-ui's positioning lifecycle so the SVG arrow
51
+ * center is read after every `computePosition`
52
+ */
53
+ onPositionUpdate: (props: {
54
+ updatePosition: () => Promise<void>;
55
+ }) => Promise<void>;
56
+ }
57
+ declare function useTooltipContent({
58
+ open,
59
+ effectivePlacement,
60
+ maxWidth,
61
+ borderRadius,
62
+ arrowRef
63
+ }: UseTooltipContentOptions): UseTooltipContentReturn;
64
+ //#endregion
65
+ export { type UseTooltipContentOptions, type UseTooltipContentReturn, useTooltipContent };
@@ -0,0 +1,197 @@
1
+ "use client";
2
+ /*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
3
+ import { DROP_SHADOW_PREFIX } from "../../../css-tokens/dist/index.js";
4
+ import { ARROW_HEIGHT, generateTooltipPath, getArrowClampDelta, getArrowSide, parseShadow } from "./util.js";
5
+ import { useCallback, useEffect, useId, useMemo, useRef, useState } from "react";
6
+
7
+ //#region src/components/client/Tooltip/useTooltipContent.ts
8
+ function useTooltipContent({ open, effectivePlacement, maxWidth, borderRadius, arrowRef }) {
9
+ const internalRef = useRef(null);
10
+ const shadowFilterId = useId();
11
+ const [dimensions, setDimensions] = useState({
12
+ width: 0,
13
+ height: 0
14
+ });
15
+ const maxWidthClass = useMemo(() => {
16
+ if (maxWidth !== void 0) return typeof maxWidth === "number" ? `max-w-[${maxWidth}px]` : `max-w-[${maxWidth}]`;
17
+ return "max-w-lg";
18
+ }, [maxWidth]);
19
+ useEffect(() => {
20
+ const el = internalRef.current;
21
+ if (!el) return;
22
+ const observer = new ResizeObserver(() => {
23
+ setDimensions({
24
+ width: el.offsetWidth,
25
+ height: el.offsetHeight
26
+ });
27
+ });
28
+ observer.observe(el);
29
+ return () => observer.disconnect();
30
+ }, [open]);
31
+ const [shadows, setShadows] = useState([]);
32
+ const shadowValueRef = useRef("");
33
+ const readShadows = useCallback(() => {
34
+ if (!internalRef.current) return;
35
+ const shadowValue = getComputedStyle(internalRef.current).getPropertyValue(`--${DROP_SHADOW_PREFIX}`);
36
+ if (shadowValue !== shadowValueRef.current) {
37
+ shadowValueRef.current = shadowValue;
38
+ setShadows(parseShadow(shadowValue));
39
+ }
40
+ }, []);
41
+ const shadowPadding = useMemo(() => {
42
+ if (shadows.length === 0) return 0;
43
+ return shadows.reduce((max, s) => {
44
+ const extentX = Math.abs(s.x) + s.blur + Math.abs(s.spread);
45
+ const extentY = Math.abs(s.y) + s.blur + Math.abs(s.spread);
46
+ return Math.max(max, extentX, extentY);
47
+ }, 0);
48
+ }, [shadows]);
49
+ const [colorScheme, setColorScheme] = useState("light");
50
+ const readColorScheme = useCallback(() => {
51
+ const el = internalRef.current;
52
+ if (!el) return;
53
+ const scheme = getComputedStyle(el).colorScheme;
54
+ setColorScheme(scheme === "dark" ? "dark" : "light");
55
+ }, []);
56
+ const [arrowCenter, setArrowCenter] = useState(void 0);
57
+ const computeArrowCenter = useCallback(() => {
58
+ const arrowEl = arrowRef.current;
59
+ const tooltipEl = internalRef.current;
60
+ if (!arrowEl || !tooltipEl) return;
61
+ const arrowRect = arrowEl.getBoundingClientRect();
62
+ const tooltipRect = tooltipEl.getBoundingClientRect();
63
+ const side = getArrowSide(effectivePlacement);
64
+ const raw = side === "top" || side === "bottom" ? arrowRect.left + arrowRect.width / 2 - tooltipRect.left : arrowRect.top + arrowRect.height / 2 - tooltipRect.top;
65
+ return Math.round(raw);
66
+ }, [arrowRef, effectivePlacement]);
67
+ const onPositionUpdate = useCallback(async ({ updatePosition }) => {
68
+ await updatePosition();
69
+ const el = internalRef.current;
70
+ if (el) {
71
+ const { offsetWidth, offsetHeight } = el;
72
+ if (offsetWidth > 0 && offsetHeight > 0) setDimensions((prev) => {
73
+ if (prev.width === offsetWidth && prev.height === offsetHeight) return prev;
74
+ return {
75
+ width: offsetWidth,
76
+ height: offsetHeight
77
+ };
78
+ });
79
+ readShadows();
80
+ readColorScheme();
81
+ }
82
+ const next = computeArrowCenter();
83
+ if (next !== void 0) setArrowCenter((prev) => prev === next ? prev : next);
84
+ }, [
85
+ computeArrowCenter,
86
+ readShadows,
87
+ readColorScheme
88
+ ]);
89
+ const svgPath = useMemo(() => {
90
+ return dimensions.width > 0 && dimensions.height > 0 ? generateTooltipPath({
91
+ width: dimensions.width,
92
+ height: dimensions.height,
93
+ placement: effectivePlacement,
94
+ borderRadius,
95
+ arrowCenter
96
+ }) : null;
97
+ }, [
98
+ effectivePlacement,
99
+ dimensions.width,
100
+ dimensions.height,
101
+ borderRadius,
102
+ arrowCenter
103
+ ]);
104
+ const blurClipPath = useMemo(() => {
105
+ if (dimensions.width <= 0 || dimensions.height <= 0) return null;
106
+ const arrowSide = getArrowSide(effectivePlacement);
107
+ const offsetX = arrowSide === "left" ? ARROW_HEIGHT : 0;
108
+ const offsetY = arrowSide === "top" ? ARROW_HEIGHT : 0;
109
+ return generateTooltipPath({
110
+ width: dimensions.width,
111
+ height: dimensions.height,
112
+ placement: effectivePlacement,
113
+ borderRadius,
114
+ arrowCenter,
115
+ offsetX,
116
+ offsetY
117
+ });
118
+ }, [
119
+ effectivePlacement,
120
+ dimensions.width,
121
+ dimensions.height,
122
+ borderRadius,
123
+ arrowCenter
124
+ ]);
125
+ const blurStyle = useMemo(() => {
126
+ const style = { clipPath: blurClipPath ? `path('${blurClipPath}')` : void 0 };
127
+ switch (getArrowSide(effectivePlacement)) {
128
+ case "top":
129
+ style.height = `calc(100% + ${ARROW_HEIGHT}px)`;
130
+ style.top = "auto";
131
+ style.bottom = "0";
132
+ break;
133
+ case "bottom":
134
+ style.height = `calc(100% + ${ARROW_HEIGHT}px)`;
135
+ break;
136
+ case "left":
137
+ style.width = `calc(100% + ${ARROW_HEIGHT}px)`;
138
+ style.left = "auto";
139
+ style.right = "0";
140
+ break;
141
+ case "right":
142
+ style.width = `calc(100% + ${ARROW_HEIGHT}px)`;
143
+ break;
144
+ }
145
+ return style;
146
+ }, [blurClipPath, effectivePlacement]);
147
+ const [visible, setVisible] = useState(false);
148
+ if ((!open || !svgPath) && visible) setVisible(false);
149
+ useEffect(() => {
150
+ if (open && svgPath) {
151
+ const raf = requestAnimationFrame(() => {
152
+ setVisible(true);
153
+ });
154
+ return () => cancelAnimationFrame(raf);
155
+ }
156
+ }, [open, svgPath]);
157
+ return {
158
+ internalRef,
159
+ shadowFilterId,
160
+ maxWidthClass,
161
+ dimensions,
162
+ shadows,
163
+ shadowPadding,
164
+ svgPath,
165
+ blurClipPath,
166
+ blurStyle,
167
+ visible,
168
+ childTransitionStyle: {
169
+ opacity: visible ? 1 : 0,
170
+ transition: "opacity 200ms ease-in-out"
171
+ },
172
+ colorScheme,
173
+ tooltipShift: useMemo(() => {
174
+ if (arrowCenter === void 0 || dimensions.width <= 0 || dimensions.height <= 0) return {
175
+ x: 0,
176
+ y: 0
177
+ };
178
+ return getArrowClampDelta({
179
+ width: dimensions.width,
180
+ height: dimensions.height,
181
+ placement: effectivePlacement,
182
+ borderRadius,
183
+ arrowCenter
184
+ });
185
+ }, [
186
+ arrowCenter,
187
+ dimensions.width,
188
+ dimensions.height,
189
+ effectivePlacement,
190
+ borderRadius
191
+ ]),
192
+ onPositionUpdate
193
+ };
194
+ }
195
+
196
+ //#endregion
197
+ export { useTooltipContent };