@fluentui/react-utilities 9.0.0-nightly.f81b28ceb3.1 → 9.0.0-rc.1

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 (206) hide show
  1. package/CHANGELOG.json +167 -8
  2. package/CHANGELOG.md +44 -6
  3. package/dist/react-utilities.d.ts +218 -198
  4. package/lib/compose/getSlots.d.ts +11 -10
  5. package/lib/compose/getSlots.js +21 -30
  6. package/lib/compose/getSlots.js.map +1 -1
  7. package/lib/compose/index.d.ts +0 -5
  8. package/lib/compose/index.js +0 -5
  9. package/lib/compose/index.js.map +1 -1
  10. package/lib/compose/resolveShorthand.d.ts +10 -6
  11. package/lib/compose/resolveShorthand.js +13 -12
  12. package/lib/compose/resolveShorthand.js.map +1 -1
  13. package/lib/compose/types.d.ts +86 -76
  14. package/lib/compose/types.js +5 -1
  15. package/lib/compose/types.js.map +1 -1
  16. package/lib/hooks/index.d.ts +1 -1
  17. package/lib/hooks/index.js +1 -1
  18. package/lib/hooks/index.js.map +1 -1
  19. package/lib/hooks/useBoolean.js +10 -21
  20. package/lib/hooks/useBoolean.js.map +1 -1
  21. package/lib/hooks/useConst.js +1 -1
  22. package/lib/hooks/useConst.js.map +1 -1
  23. package/lib/hooks/useControllableState.d.ts +16 -6
  24. package/lib/hooks/useControllableState.js +26 -25
  25. package/lib/hooks/useControllableState.js.map +1 -1
  26. package/lib/hooks/useEventCallback.js +6 -12
  27. package/lib/hooks/useEventCallback.js.map +1 -1
  28. package/lib/hooks/useFirstMount.js +1 -1
  29. package/lib/hooks/useFirstMount.js.map +1 -1
  30. package/lib/hooks/useForceUpdate.js +1 -3
  31. package/lib/hooks/useForceUpdate.js.map +1 -1
  32. package/lib/hooks/useId.js +2 -4
  33. package/lib/hooks/useId.js.map +1 -1
  34. package/lib/hooks/useIsomorphicLayoutEffect.js +1 -1
  35. package/lib/hooks/useIsomorphicLayoutEffect.js.map +1 -1
  36. package/lib/hooks/useMergedEventCallbacks.d.ts +18 -0
  37. package/lib/hooks/useMergedEventCallbacks.js +26 -0
  38. package/lib/hooks/useMergedEventCallbacks.js.map +1 -0
  39. package/lib/hooks/useMergedRefs.js +5 -13
  40. package/lib/hooks/useMergedRefs.js.map +1 -1
  41. package/lib/hooks/useMount.js +3 -3
  42. package/lib/hooks/useMount.js.map +1 -1
  43. package/lib/hooks/useOnClickOutside.js +30 -36
  44. package/lib/hooks/useOnClickOutside.js.map +1 -1
  45. package/lib/hooks/useOnScrollOutside.js +13 -15
  46. package/lib/hooks/useOnScrollOutside.js.map +1 -1
  47. package/lib/hooks/usePrevious.js +3 -3
  48. package/lib/hooks/usePrevious.js.map +1 -1
  49. package/lib/hooks/useTimeout.js +13 -17
  50. package/lib/hooks/useTimeout.js.map +1 -1
  51. package/lib/hooks/useUnmount.js +5 -7
  52. package/lib/hooks/useUnmount.js.map +1 -1
  53. package/lib/ssr/SSRContext.js +9 -15
  54. package/lib/ssr/SSRContext.js.map +1 -1
  55. package/lib/utils/applyTriggerPropsToChildren.d.ts +1 -1
  56. package/lib/utils/applyTriggerPropsToChildren.js +24 -4
  57. package/lib/utils/applyTriggerPropsToChildren.js.map +1 -1
  58. package/lib/utils/clamp.js +1 -3
  59. package/lib/utils/clamp.js.map +1 -1
  60. package/lib/utils/getNativeElementProps.d.ts +22 -0
  61. package/lib/utils/getNativeElementProps.js +24 -2
  62. package/lib/utils/getNativeElementProps.js.map +1 -1
  63. package/lib/utils/getRTLSafeKey.js +1 -1
  64. package/lib/utils/getRTLSafeKey.js.map +1 -1
  65. package/lib/utils/getReactCallbackName.d.ts +25 -0
  66. package/lib/utils/getReactCallbackName.js +26 -0
  67. package/lib/utils/getReactCallbackName.js.map +1 -0
  68. package/lib/utils/getTriggerChild.d.ts +22 -0
  69. package/lib/utils/getTriggerChild.js +26 -0
  70. package/lib/utils/getTriggerChild.js.map +1 -0
  71. package/lib/utils/index.d.ts +2 -1
  72. package/lib/utils/index.js +2 -1
  73. package/lib/utils/index.js.map +1 -1
  74. package/lib/utils/isFluentTrigger.d.ts +22 -0
  75. package/lib/utils/isFluentTrigger.js +8 -0
  76. package/lib/utils/isFluentTrigger.js.map +1 -0
  77. package/lib/utils/omit.js +2 -2
  78. package/lib/utils/omit.js.map +1 -1
  79. package/lib/utils/properties.js +55 -44
  80. package/lib/utils/properties.js.map +1 -1
  81. package/lib/utils/shouldPreventDefaultOnKeyDown.js +4 -4
  82. package/lib/utils/shouldPreventDefaultOnKeyDown.js.map +1 -1
  83. package/lib-commonjs/compose/getSlots.d.ts +11 -10
  84. package/lib-commonjs/compose/getSlots.js +23 -34
  85. package/lib-commonjs/compose/getSlots.js.map +1 -1
  86. package/lib-commonjs/compose/index.d.ts +0 -5
  87. package/lib-commonjs/compose/index.js +1 -11
  88. package/lib-commonjs/compose/index.js.map +1 -1
  89. package/lib-commonjs/compose/resolveShorthand.d.ts +10 -6
  90. package/lib-commonjs/compose/resolveShorthand.js +14 -14
  91. package/lib-commonjs/compose/resolveShorthand.js.map +1 -1
  92. package/lib-commonjs/compose/types.d.ts +86 -76
  93. package/lib-commonjs/compose/types.js +5 -1
  94. package/lib-commonjs/compose/types.js.map +1 -1
  95. package/lib-commonjs/hooks/index.d.ts +1 -1
  96. package/lib-commonjs/hooks/index.js +3 -3
  97. package/lib-commonjs/hooks/index.js.map +1 -1
  98. package/lib-commonjs/hooks/useBoolean.js +12 -23
  99. package/lib-commonjs/hooks/useBoolean.js.map +1 -1
  100. package/lib-commonjs/hooks/useConst.js +2 -2
  101. package/lib-commonjs/hooks/useConst.js.map +1 -1
  102. package/lib-commonjs/hooks/useControllableState.d.ts +16 -6
  103. package/lib-commonjs/hooks/useControllableState.js +28 -27
  104. package/lib-commonjs/hooks/useControllableState.js.map +1 -1
  105. package/lib-commonjs/hooks/useEventCallback.js +8 -14
  106. package/lib-commonjs/hooks/useEventCallback.js.map +1 -1
  107. package/lib-commonjs/hooks/useFirstMount.js +2 -2
  108. package/lib-commonjs/hooks/useFirstMount.js.map +1 -1
  109. package/lib-commonjs/hooks/useForceUpdate.js +2 -4
  110. package/lib-commonjs/hooks/useForceUpdate.js.map +1 -1
  111. package/lib-commonjs/hooks/useId.js +4 -6
  112. package/lib-commonjs/hooks/useId.js.map +1 -1
  113. package/lib-commonjs/hooks/useIsomorphicLayoutEffect.js +2 -2
  114. package/lib-commonjs/hooks/useIsomorphicLayoutEffect.js.map +1 -1
  115. package/lib-commonjs/hooks/useMergedEventCallbacks.d.ts +18 -0
  116. package/lib-commonjs/hooks/useMergedEventCallbacks.js +36 -0
  117. package/lib-commonjs/hooks/useMergedEventCallbacks.js.map +1 -0
  118. package/lib-commonjs/hooks/useMergedRefs.js +6 -15
  119. package/lib-commonjs/hooks/useMergedRefs.js.map +1 -1
  120. package/lib-commonjs/hooks/useMount.js +4 -4
  121. package/lib-commonjs/hooks/useMount.js.map +1 -1
  122. package/lib-commonjs/hooks/useOnClickOutside.js +32 -38
  123. package/lib-commonjs/hooks/useOnClickOutside.js.map +1 -1
  124. package/lib-commonjs/hooks/useOnScrollOutside.js +15 -17
  125. package/lib-commonjs/hooks/useOnScrollOutside.js.map +1 -1
  126. package/lib-commonjs/hooks/usePrevious.js +4 -4
  127. package/lib-commonjs/hooks/usePrevious.js.map +1 -1
  128. package/lib-commonjs/hooks/useTimeout.js +15 -19
  129. package/lib-commonjs/hooks/useTimeout.js.map +1 -1
  130. package/lib-commonjs/hooks/useUnmount.js +6 -8
  131. package/lib-commonjs/hooks/useUnmount.js.map +1 -1
  132. package/lib-commonjs/index.js +1 -1
  133. package/lib-commonjs/ssr/SSRContext.js +9 -15
  134. package/lib-commonjs/ssr/SSRContext.js.map +1 -1
  135. package/lib-commonjs/ssr/index.js +1 -1
  136. package/lib-commonjs/utils/applyTriggerPropsToChildren.d.ts +1 -1
  137. package/lib-commonjs/utils/applyTriggerPropsToChildren.js +26 -6
  138. package/lib-commonjs/utils/applyTriggerPropsToChildren.js.map +1 -1
  139. package/lib-commonjs/utils/clamp.js +1 -3
  140. package/lib-commonjs/utils/clamp.js.map +1 -1
  141. package/lib-commonjs/utils/getNativeElementProps.d.ts +22 -0
  142. package/lib-commonjs/utils/getNativeElementProps.js +28 -4
  143. package/lib-commonjs/utils/getNativeElementProps.js.map +1 -1
  144. package/lib-commonjs/utils/getRTLSafeKey.js +1 -1
  145. package/lib-commonjs/utils/getRTLSafeKey.js.map +1 -1
  146. package/lib-commonjs/utils/getReactCallbackName.d.ts +25 -0
  147. package/lib-commonjs/utils/getReactCallbackName.js +35 -0
  148. package/lib-commonjs/utils/getReactCallbackName.js.map +1 -0
  149. package/lib-commonjs/utils/getTriggerChild.d.ts +22 -0
  150. package/lib-commonjs/utils/getTriggerChild.js +37 -0
  151. package/lib-commonjs/utils/getTriggerChild.js.map +1 -0
  152. package/lib-commonjs/utils/index.d.ts +2 -1
  153. package/lib-commonjs/utils/index.js +5 -3
  154. package/lib-commonjs/utils/index.js.map +1 -1
  155. package/lib-commonjs/utils/isFluentTrigger.d.ts +22 -0
  156. package/lib-commonjs/utils/isFluentTrigger.js +17 -0
  157. package/lib-commonjs/utils/isFluentTrigger.js.map +1 -0
  158. package/lib-commonjs/utils/omit.js +2 -2
  159. package/lib-commonjs/utils/omit.js.map +1 -1
  160. package/lib-commonjs/utils/properties.js +51 -40
  161. package/lib-commonjs/utils/properties.js.map +1 -1
  162. package/lib-commonjs/utils/shouldPreventDefaultOnKeyDown.js +5 -5
  163. package/lib-commonjs/utils/shouldPreventDefaultOnKeyDown.js.map +1 -1
  164. package/package.json +6 -11
  165. package/lib/compose/getSlotsCompat.d.ts +0 -22
  166. package/lib/compose/getSlotsCompat.js +0 -56
  167. package/lib/compose/getSlotsCompat.js.map +0 -1
  168. package/lib/compose/makeMergeProps.d.ts +0 -15
  169. package/lib/compose/makeMergeProps.js +0 -106
  170. package/lib/compose/makeMergeProps.js.map +0 -1
  171. package/lib/compose/makeMergePropsCompat.d.ts +0 -9
  172. package/lib/compose/makeMergePropsCompat.js +0 -9
  173. package/lib/compose/makeMergePropsCompat.js.map +0 -1
  174. package/lib/compose/nullRender.d.ts +0 -4
  175. package/lib/compose/nullRender.js +0 -7
  176. package/lib/compose/nullRender.js.map +0 -1
  177. package/lib/compose/resolveShorthandProps.d.ts +0 -8
  178. package/lib/compose/resolveShorthandProps.js +0 -30
  179. package/lib/compose/resolveShorthandProps.js.map +0 -1
  180. package/lib/hooks/useControllableValue.d.ts +0 -20
  181. package/lib/hooks/useControllableValue.js +0 -62
  182. package/lib/hooks/useControllableValue.js.map +0 -1
  183. package/lib/utils/onlyChild.d.ts +0 -5
  184. package/lib/utils/onlyChild.js +0 -13
  185. package/lib/utils/onlyChild.js.map +0 -1
  186. package/lib-commonjs/compose/getSlotsCompat.d.ts +0 -22
  187. package/lib-commonjs/compose/getSlotsCompat.js +0 -68
  188. package/lib-commonjs/compose/getSlotsCompat.js.map +0 -1
  189. package/lib-commonjs/compose/makeMergeProps.d.ts +0 -15
  190. package/lib-commonjs/compose/makeMergeProps.js +0 -117
  191. package/lib-commonjs/compose/makeMergeProps.js.map +0 -1
  192. package/lib-commonjs/compose/makeMergePropsCompat.d.ts +0 -9
  193. package/lib-commonjs/compose/makeMergePropsCompat.js +0 -17
  194. package/lib-commonjs/compose/makeMergePropsCompat.js.map +0 -1
  195. package/lib-commonjs/compose/nullRender.d.ts +0 -4
  196. package/lib-commonjs/compose/nullRender.js +0 -16
  197. package/lib-commonjs/compose/nullRender.js.map +0 -1
  198. package/lib-commonjs/compose/resolveShorthandProps.d.ts +0 -8
  199. package/lib-commonjs/compose/resolveShorthandProps.js +0 -41
  200. package/lib-commonjs/compose/resolveShorthandProps.js.map +0 -1
  201. package/lib-commonjs/hooks/useControllableValue.d.ts +0 -20
  202. package/lib-commonjs/hooks/useControllableValue.js +0 -73
  203. package/lib-commonjs/hooks/useControllableValue.js.map +0 -1
  204. package/lib-commonjs/utils/onlyChild.d.ts +0 -5
  205. package/lib-commonjs/utils/onlyChild.js +0 -23
  206. package/lib-commonjs/utils/onlyChild.js.map +0 -1
@@ -5,15 +5,13 @@ import * as React from 'react';
5
5
  * @param callback - Function to call during unmount.
6
6
  */
7
7
 
8
- export var useUnmount = function (callback) {
9
- var unmountRef = React.useRef(callback);
8
+ export const useUnmount = callback => {
9
+ const unmountRef = React.useRef(callback);
10
10
  unmountRef.current = callback;
11
- React.useEffect(function () {
12
- return function () {
13
- var _a;
11
+ React.useEffect(() => () => {
12
+ var _a;
14
13
 
15
- (_a = unmountRef.current) === null || _a === void 0 ? void 0 : _a.call(unmountRef);
16
- };
14
+ (_a = unmountRef.current) === null || _a === void 0 ? void 0 : _a.call(unmountRef);
17
15
  }, []);
18
16
  };
19
17
  //# sourceMappingURL=useUnmount.js.map
@@ -1 +1 @@
1
- {"version":3,"sources":["../../src/hooks/useUnmount.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAZ,MAAuB,OAAvB;AAEA;;;;AAIG;;AACH,OAAO,IAAM,UAAU,GAAG,UAAC,QAAD,EAAqB;AAC7C,MAAM,UAAU,GAAG,KAAK,CAAC,MAAN,CAAa,QAAb,CAAnB;AACA,EAAA,UAAU,CAAC,OAAX,GAAqB,QAArB;AACA,EAAA,KAAK,CAAC,SAAN,CACE,YAAA;AAAM,WAAA,YAAA;;;AACJ,OAAA,EAAA,GAAA,UAAU,CAAC,OAAX,MAAkB,IAAlB,IAAkB,EAAA,KAAA,KAAA,CAAlB,GAAkB,KAAA,CAAlB,GAAkB,EAAA,CAAA,IAAA,CAAlB,UAAkB,CAAlB;AADI,KAAA;AAEL,GAHH,EAIE,EAJF;AAMD,CATM","sourceRoot":""}
1
+ {"version":3,"sources":["../../src/hooks/useUnmount.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAZ,MAAuB,OAAvB;AAEA;;;;AAIG;;AACH,OAAO,MAAM,UAAU,GAAI,QAAD,IAAyB;AACjD,QAAM,UAAU,GAAG,KAAK,CAAC,MAAN,CAAa,QAAb,CAAnB;AACA,EAAA,UAAU,CAAC,OAAX,GAAqB,QAArB;AACA,EAAA,KAAK,CAAC,SAAN,CACE,MAAM,MAAK;;;AACT,KAAA,EAAA,GAAA,UAAU,CAAC,OAAX,MAAkB,IAAlB,IAAkB,EAAA,KAAA,KAAA,CAAlB,GAAkB,KAAA,CAAlB,GAAkB,EAAA,CAAA,IAAA,CAAlB,UAAkB,CAAlB;AACD,GAHH,EAIE,EAJF;AAMD,CATM","sourceRoot":""}
@@ -6,10 +6,10 @@ import { canUseDOM } from './canUseDOM';
6
6
  * @internal
7
7
  */
8
8
 
9
- export var defaultSSRContextValue = {
9
+ export const defaultSSRContextValue = {
10
10
  current: 0
11
11
  };
12
- export var SSRContext = /*#__PURE__*/React.createContext(defaultSSRContextValue);
12
+ export const SSRContext = /*#__PURE__*/React.createContext(defaultSSRContextValue);
13
13
  /**
14
14
  * @internal
15
15
  */
@@ -24,12 +24,10 @@ export function useSSRContext() {
24
24
  * @public
25
25
  */
26
26
 
27
- export var SSRProvider = function (props) {
28
- var value = React.useState(function () {
29
- return {
30
- current: 0
31
- };
32
- })[0];
27
+ export const SSRProvider = props => {
28
+ const [value] = React.useState(() => ({
29
+ current: 0
30
+ }));
33
31
  return /*#__PURE__*/React.createElement(SSRContext.Provider, {
34
32
  value: value
35
33
  }, props.children);
@@ -40,14 +38,10 @@ export var SSRProvider = function (props) {
40
38
  */
41
39
 
42
40
  export function useIsSSR() {
43
- var isInSSRContext = useSSRContext() !== defaultSSRContextValue;
44
-
45
- var _a = React.useState(isInSSRContext),
46
- isSSR = _a[0],
47
- setIsSSR = _a[1]; // If we are rendering in a non-DOM environment, and there's no SSRProvider, provide a warning to hint to the
41
+ const isInSSRContext = useSSRContext() !== defaultSSRContextValue;
42
+ const [isSSR, setIsSSR] = React.useState(isInSSRContext); // If we are rendering in a non-DOM environment, and there's no SSRProvider, provide a warning to hint to the
48
43
  // developer to add one.
49
44
 
50
-
51
45
  if (process.env.NODE_ENV !== 'production') {
52
46
  if (!isInSSRContext && !canUseDOM()) {
53
47
  // eslint-disable-next-line no-console
@@ -61,7 +55,7 @@ export function useIsSSR() {
61
55
  // This if statement technically breaks the rules of hooks, but is safe because the condition never changes after
62
56
  // mounting.
63
57
  // eslint-disable-next-line
64
- React.useLayoutEffect(function () {
58
+ React.useLayoutEffect(() => {
65
59
  setIsSSR(false);
66
60
  }, []);
67
61
  }
@@ -1 +1 @@
1
- {"version":3,"sources":["../../src/ssr/SSRContext.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAZ,MAAuB,OAAvB;AACA,SAAS,SAAT,QAA0B,aAA1B;AAYA;;;;AAIG;;AACH,OAAO,IAAM,sBAAsB,GAAoB;AACrD,EAAA,OAAO,EAAE;AAD4C,CAAhD;AAIP,OAAO,IAAM,UAAU,gBAAG,KAAK,CAAC,aAAN,CAAqC,sBAArC,CAAnB;AAEP;;AAEG;;AACH,OAAM,SAAU,aAAV,GAAuB;AAC3B,SAAO,KAAK,CAAC,UAAN,CAAiB,UAAjB,CAAP;AACD;AAED;;;;;AAKG;;AACH,OAAO,IAAM,WAAW,GAAa,UAAA,KAAA,EAAK;AACjC,MAAA,KAAK,GAAI,KAAK,CAAC,QAAN,CAAgC,YAAA;AAAM,WAAC;AAAE,MAAA,OAAO,EAAV;AAAC,KAAD;AAAgB,GAAtD,EAAJ,CAAI,CAAT;AAEP,sBAAO,KAAA,CAAA,aAAA,CAAC,UAAU,CAAC,QAAZ,EAAoB;AAAC,IAAA,KAAK,EAAE;AAAR,GAApB,EAAoC,KAAK,CAAC,QAA1C,CAAP;AACD,CAJM;AAMP;;;AAGG;;AACH,OAAM,SAAU,QAAV,GAAkB;AACtB,MAAM,cAAc,GAAG,aAAa,OAAO,sBAA3C;;AACM,MAAA,EAAA,GAAoB,KAAK,CAAC,QAAN,CAAe,cAAf,CAApB;AAAA,MAAC,KAAK,GAAA,EAAA,CAAA,CAAA,CAAN;AAAA,MAAQ,QAAQ,GAAA,EAAA,CAAA,CAAA,CAAhB,CAFgB,CAItB;AACA;;;AACA,MAAI,OAAO,CAAC,GAAR,CAAY,QAAZ,KAAyB,YAA7B,EAA2C;AACzC,QAAI,CAAC,cAAD,IAAmB,CAAC,SAAS,EAAjC,EAAqC;AACnC;AACA,MAAA,OAAO,CAAC,KAAR,CACE,4GACE,0CAFJ;AAID;AACF,GAdqB,CAgBtB;AACA;;;AACA,MAAI,SAAS,MAAM,cAAnB,EAAmC;AACjC;AACA;AACA;AACA,IAAA,KAAK,CAAC,eAAN,CAAsB,YAAA;AACpB,MAAA,QAAQ,CAAC,KAAD,CAAR;AACD,KAFD,EAEG,EAFH;AAGD;;AAED,SAAO,KAAP;AACD","sourceRoot":""}
1
+ {"version":3,"sources":["../../src/ssr/SSRContext.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAZ,MAAuB,OAAvB;AACA,SAAS,SAAT,QAA0B,aAA1B;AAYA;;;;AAIG;;AACH,OAAO,MAAM,sBAAsB,GAAoB;AACrD,EAAA,OAAO,EAAE;AAD4C,CAAhD;AAIP,OAAO,MAAM,UAAU,gBAAG,KAAK,CAAC,aAAN,CAAqC,sBAArC,CAAnB;AAEP;;AAEG;;AACH,OAAM,SAAU,aAAV,GAAuB;AAC3B,SAAO,KAAK,CAAC,UAAN,CAAiB,UAAjB,CAAP;AACD;AAED;;;;;AAKG;;AACH,OAAO,MAAM,WAAW,GAAa,KAAK,IAAG;AAC3C,QAAM,CAAC,KAAD,IAAU,KAAK,CAAC,QAAN,CAAgC,OAAO;AAAE,IAAA,OAAO,EAAE;AAAX,GAAP,CAAhC,CAAhB;AAEA,sBAAO,KAAA,CAAA,aAAA,CAAC,UAAU,CAAC,QAAZ,EAAoB;AAAC,IAAA,KAAK,EAAE;AAAR,GAApB,EAAoC,KAAK,CAAC,QAA1C,CAAP;AACD,CAJM;AAMP;;;AAGG;;AACH,OAAM,SAAU,QAAV,GAAkB;AACtB,QAAM,cAAc,GAAG,aAAa,OAAO,sBAA3C;AACA,QAAM,CAAC,KAAD,EAAQ,QAAR,IAAoB,KAAK,CAAC,QAAN,CAAe,cAAf,CAA1B,CAFsB,CAItB;AACA;;AACA,MAAI,OAAO,CAAC,GAAR,CAAY,QAAZ,KAAyB,YAA7B,EAA2C;AACzC,QAAI,CAAC,cAAD,IAAmB,CAAC,SAAS,EAAjC,EAAqC;AACnC;AACA,MAAA,OAAO,CAAC,KAAR,CACE,4GACE,0CAFJ;AAID;AACF,GAdqB,CAgBtB;AACA;;;AACA,MAAI,SAAS,MAAM,cAAnB,EAAmC;AACjC;AACA;AACA;AACA,IAAA,KAAK,CAAC,eAAN,CAAsB,MAAK;AACzB,MAAA,QAAQ,CAAC,KAAD,CAAR;AACD,KAFD,EAEG,EAFH;AAGD;;AAED,SAAO,KAAP;AACD","sourceRoot":""}
@@ -2,4 +2,4 @@ import * as React from 'react';
2
2
  /**
3
3
  * Apply the trigger props to the children, either by calling the render function, or cloning with the new props.
4
4
  */
5
- export declare const applyTriggerPropsToChildren: <TTriggerProps>(children: React.ReactElement<any, string | ((props: any) => React.ReactElement<any, string | any | (new (props: any) => React.Component<any, any, any>)> | null) | (new (props: any) => React.Component<any, any, any>)> | ((props: TTriggerProps) => React.ReactNode) | null | undefined, triggerProps: TTriggerProps) => React.ReactNode;
5
+ export declare const applyTriggerPropsToChildren: <TTriggerProps>(children: React.ReactElement<any, string | React.JSXElementConstructor<any>> | ((props: TTriggerProps) => React.ReactElement | null) | null | undefined, triggerProps: TTriggerProps) => React.ReactElement | null;
@@ -1,16 +1,36 @@
1
1
  import * as React from 'react';
2
- import { onlyChild } from './onlyChild';
2
+ import { isFluentTrigger } from './isFluentTrigger';
3
3
  /**
4
4
  * Apply the trigger props to the children, either by calling the render function, or cloning with the new props.
5
5
  */
6
6
 
7
- export var applyTriggerPropsToChildren = function (children, triggerProps) {
7
+ export const applyTriggerPropsToChildren = (children, triggerProps) => {
8
8
  if (typeof children === 'function') {
9
9
  return children(triggerProps);
10
10
  } else if (children) {
11
- return /*#__PURE__*/React.cloneElement(onlyChild(children), triggerProps);
11
+ return cloneTriggerTree(children, triggerProps);
12
+ } // Components in React should return either JSX elements or "null", otherwise React will throw:
13
+ // Nothing was returned from render.
14
+ // This usually means a return statement is missing. Or, to render nothing, return null.
15
+
16
+
17
+ return children || null;
18
+ };
19
+ /**
20
+ * Clones a React element tree, and applies the given props to the first grandchild that is not
21
+ * a FluentTriggerComponent or React Fragment (the same element returned by {@link getTriggerChild}).
22
+ */
23
+
24
+ const cloneTriggerTree = (child, triggerProps) => {
25
+ if (! /*#__PURE__*/React.isValidElement(child) || child.type === React.Fragment) {
26
+ throw new Error('A trigger element must be a single element for this component. ' + "Please ensure that you're not using React Fragments.");
12
27
  }
13
28
 
14
- return children;
29
+ if (isFluentTrigger(child)) {
30
+ const grandchild = cloneTriggerTree(child.props.children, triggerProps);
31
+ return /*#__PURE__*/React.cloneElement(child, undefined, grandchild);
32
+ } else {
33
+ return /*#__PURE__*/React.cloneElement(child, triggerProps);
34
+ }
15
35
  };
16
36
  //# sourceMappingURL=applyTriggerPropsToChildren.js.map
@@ -1 +1 @@
1
- {"version":3,"sources":["../../src/utils/applyTriggerPropsToChildren.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAZ,MAAuB,OAAvB;AACA,SAAS,SAAT,QAA0B,aAA1B;AAEA;;AAEG;;AACH,OAAO,IAAM,2BAA2B,GAAG,UACzC,QADyC,EAEzC,YAFyC,EAEd;AAE3B,MAAI,OAAO,QAAP,KAAoB,UAAxB,EAAoC;AAClC,WAAO,QAAQ,CAAC,YAAD,CAAf;AACD,GAFD,MAEO,IAAI,QAAJ,EAAc;AACnB,wBAAO,KAAK,CAAC,YAAN,CAAmB,SAAS,CAAC,QAAD,CAA5B,EAAwC,YAAxC,CAAP;AACD;;AAED,SAAO,QAAP;AACD,CAXM","sourceRoot":""}
1
+ {"version":3,"sources":["../../src/utils/applyTriggerPropsToChildren.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAZ,MAAuB,OAAvB;AACA,SAAS,eAAT,QAAgC,mBAAhC;AAEA;;AAEG;;AACH,OAAO,MAAM,2BAA2B,GAAG,CACzC,QADyC,EAEzC,YAFyC,KAGZ;AAC7B,MAAI,OAAO,QAAP,KAAoB,UAAxB,EAAoC;AAClC,WAAO,QAAQ,CAAC,YAAD,CAAf;AACD,GAFD,MAEO,IAAI,QAAJ,EAAc;AACnB,WAAO,gBAAgB,CAAC,QAAD,EAAW,YAAX,CAAvB;AACD,GAL4B,CAO7B;AACA;AACA;;;AACA,SAAO,QAAQ,IAAI,IAAnB;AACD,CAdM;AAgBP;;;AAGG;;AACH,MAAM,gBAAgB,GAAG,CAAgB,KAAhB,EAAwC,YAAxC,KAA2F;AAClH,MAAI,eAAC,KAAK,CAAC,cAAN,CAAqB,KAArB,CAAD,IAAgC,KAAK,CAAC,IAAN,KAAe,KAAK,CAAC,QAAzD,EAAmE;AACjE,UAAM,IAAI,KAAJ,CACJ,oEACE,sDAFE,CAAN;AAID;;AAED,MAAI,eAAe,CAAC,KAAD,CAAnB,EAA4B;AAC1B,UAAM,UAAU,GAAG,gBAAgB,CAAC,KAAK,CAAC,KAAN,CAAY,QAAb,EAAuB,YAAvB,CAAnC;AACA,wBAAO,KAAK,CAAC,YAAN,CAAmB,KAAnB,EAA0B,SAA1B,EAAqC,UAArC,CAAP;AACD,GAHD,MAGO;AACL,wBAAO,KAAK,CAAC,YAAN,CAAmB,KAAnB,EAA0B,YAA1B,CAAP;AACD;AACF,CAdD","sourceRoot":""}
@@ -5,7 +5,5 @@
5
5
  * @param min - the lowest valid value
6
6
  * @param max - the highest valid value
7
7
  */
8
- export var clamp = function (value, min, max) {
9
- return Math.max(min, Math.min(max, value || 0));
10
- };
8
+ export const clamp = (value, min, max) => Math.max(min, Math.min(max, value || 0));
11
9
  //# sourceMappingURL=clamp.js.map
@@ -1 +1 @@
1
- {"version":3,"sources":["../../src/utils/clamp.ts"],"names":[],"mappings":"AAAA;;;;;;AAMG;AACH,OAAO,IAAM,KAAK,GAAG,UAAC,KAAD,EAAgB,GAAhB,EAA6B,GAA7B,EAAwC;AAAa,SAAA,IAAI,CAAC,GAAL,CAAS,GAAT,EAAc,IAAI,CAAC,GAAL,CAAS,GAAT,EAAc,KAAK,IAAjC,CAAc,CAAd,CAAA;AAAwC,CAA3G","sourceRoot":""}
1
+ {"version":3,"file":"clamp.js","sourceRoot":"","sources":["../../src/utils/clamp.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,KAAa,EAAE,GAAW,EAAE,GAAW,EAAU,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC"}
@@ -7,3 +7,25 @@ import * as React from 'react';
7
7
  * @param excludedPropNames - List of props to disallow
8
8
  */
9
9
  export declare function getNativeElementProps<TAttributes extends React.HTMLAttributes<any>>(tagName: string, props: {}, excludedPropNames?: string[]): TAttributes;
10
+ /**
11
+ * Splits the native props into ones that go to the `root` slot, and ones that go to the primary slot.
12
+ *
13
+ * This function is only for use with components that have a primary slot other than `root`.
14
+ * Most components should use {@link getNativeElementProps} for their root slot if it is the primary slot.
15
+ *
16
+ * @returns An object containing the native props for the `root` and primary slots.
17
+ */
18
+ export declare const getPartitionedNativeProps: <Props extends Pick<React.HTMLAttributes<HTMLElement>, "style" | "className">, ExcludedPropKeys extends Extract<keyof Props, string> = never>({ primarySlotTagName, props, excludedPropNames, }: {
19
+ /** The primary slot's element type (e.g. 'div') */
20
+ primarySlotTagName: keyof JSX.IntrinsicElements;
21
+ /** The component's props object */
22
+ props: Props;
23
+ /** List of native props to exclude from the returned value */
24
+ excludedPropNames?: ExcludedPropKeys[] | undefined;
25
+ }) => {
26
+ root: {
27
+ style: React.CSSProperties | undefined;
28
+ className: string | undefined;
29
+ };
30
+ primary: Omit<Props, ExcludedPropKeys>;
31
+ };
@@ -1,5 +1,5 @@
1
1
  import { labelProperties, audioProperties, videoProperties, olProperties, liProperties, anchorProperties, buttonProperties, inputProperties, textAreaProperties, selectProperties, optionProperties, tableProperties, trProperties, thProperties, tdProperties, colGroupProperties, colProperties, formProperties, iframeProperties, imgProperties, htmlElementProperties, getNativeProps } from './properties';
2
- var nativeElementMap = {
2
+ const nativeElementMap = {
3
3
  label: labelProperties,
4
4
  audio: audioProperties,
5
5
  video: videoProperties,
@@ -31,8 +31,30 @@ var nativeElementMap = {
31
31
  // eslint-disable-next-line @typescript-eslint/no-explicit-any
32
32
 
33
33
  export function getNativeElementProps(tagName, props, excludedPropNames) {
34
- var allowedPropNames = tagName && nativeElementMap[tagName] || htmlElementProperties;
34
+ const allowedPropNames = tagName && nativeElementMap[tagName] || htmlElementProperties;
35
35
  allowedPropNames.as = 1;
36
36
  return getNativeProps(props, allowedPropNames, excludedPropNames);
37
37
  }
38
+ /**
39
+ * Splits the native props into ones that go to the `root` slot, and ones that go to the primary slot.
40
+ *
41
+ * This function is only for use with components that have a primary slot other than `root`.
42
+ * Most components should use {@link getNativeElementProps} for their root slot if it is the primary slot.
43
+ *
44
+ * @returns An object containing the native props for the `root` and primary slots.
45
+ */
46
+
47
+ export const getPartitionedNativeProps = ({
48
+ primarySlotTagName,
49
+ props,
50
+ excludedPropNames
51
+ }) => {
52
+ return {
53
+ root: {
54
+ style: props.style,
55
+ className: props.className
56
+ },
57
+ primary: getNativeElementProps(primarySlotTagName, props, [...(excludedPropNames || []), 'style', 'className'])
58
+ };
59
+ };
38
60
  //# sourceMappingURL=getNativeElementProps.js.map
@@ -1 +1 @@
1
- {"version":3,"sources":["../../src/utils/getNativeElementProps.ts"],"names":[],"mappings":"AACA,SACE,eADF,EAEE,eAFF,EAGE,eAHF,EAIE,YAJF,EAKE,YALF,EAME,gBANF,EAOE,gBAPF,EAQE,eARF,EASE,kBATF,EAUE,gBAVF,EAWE,gBAXF,EAYE,eAZF,EAaE,YAbF,EAcE,YAdF,EAeE,YAfF,EAgBE,kBAhBF,EAiBE,aAjBF,EAkBE,cAlBF,EAmBE,gBAnBF,EAoBE,aApBF,EAqBE,qBArBF,EAsBE,cAtBF,QAuBO,cAvBP;AAyBA,IAAM,gBAAgB,GAA2C;AAC/D,EAAA,KAAK,EAAE,eADwD;AAE/D,EAAA,KAAK,EAAE,eAFwD;AAG/D,EAAA,KAAK,EAAE,eAHwD;AAI/D,EAAA,EAAE,EAAE,YAJ2D;AAK/D,EAAA,EAAE,EAAE,YAL2D;AAM/D,EAAA,CAAC,EAAE,gBAN4D;AAO/D,EAAA,MAAM,EAAE,gBAPuD;AAQ/D,EAAA,KAAK,EAAE,eARwD;AAS/D,EAAA,QAAQ,EAAE,kBATqD;AAU/D,EAAA,MAAM,EAAE,gBAVuD;AAW/D,EAAA,MAAM,EAAE,gBAXuD;AAY/D,EAAA,KAAK,EAAE,eAZwD;AAa/D,EAAA,EAAE,EAAE,YAb2D;AAc/D,EAAA,EAAE,EAAE,YAd2D;AAe/D,EAAA,EAAE,EAAE,YAf2D;AAgB/D,EAAA,QAAQ,EAAE,kBAhBqD;AAiB/D,EAAA,GAAG,EAAE,aAjB0D;AAkB/D,EAAA,IAAI,EAAE,cAlByD;AAmB/D,EAAA,MAAM,EAAE,gBAnBuD;AAoB/D,EAAA,GAAG,EAAE;AApB0D,CAAjE;AAuBA;;;;;;AAMG;AACH;;AACA,OAAM,SAAU,qBAAV,CACJ,OADI,EAEJ,KAFI,EAGJ,iBAHI,EAGwB;AAE5B,MAAM,gBAAgB,GAAI,OAAO,IAAI,gBAAgB,CAAC,OAAD,CAA5B,IAA0C,qBAAnE;AACA,EAAA,gBAAgB,CAAC,EAAjB,GAAsB,CAAtB;AAEA,SAAO,cAAc,CAAC,KAAD,EAAQ,gBAAR,EAA0B,iBAA1B,CAArB;AACD","sourceRoot":""}
1
+ {"version":3,"sources":["../../src/utils/getNativeElementProps.ts"],"names":[],"mappings":"AACA,SACE,eADF,EAEE,eAFF,EAGE,eAHF,EAIE,YAJF,EAKE,YALF,EAME,gBANF,EAOE,gBAPF,EAQE,eARF,EASE,kBATF,EAUE,gBAVF,EAWE,gBAXF,EAYE,eAZF,EAaE,YAbF,EAcE,YAdF,EAeE,YAfF,EAgBE,kBAhBF,EAiBE,aAjBF,EAkBE,cAlBF,EAmBE,gBAnBF,EAoBE,aApBF,EAqBE,qBArBF,EAsBE,cAtBF,QAuBO,cAvBP;AAyBA,MAAM,gBAAgB,GAA2C;AAC/D,EAAA,KAAK,EAAE,eADwD;AAE/D,EAAA,KAAK,EAAE,eAFwD;AAG/D,EAAA,KAAK,EAAE,eAHwD;AAI/D,EAAA,EAAE,EAAE,YAJ2D;AAK/D,EAAA,EAAE,EAAE,YAL2D;AAM/D,EAAA,CAAC,EAAE,gBAN4D;AAO/D,EAAA,MAAM,EAAE,gBAPuD;AAQ/D,EAAA,KAAK,EAAE,eARwD;AAS/D,EAAA,QAAQ,EAAE,kBATqD;AAU/D,EAAA,MAAM,EAAE,gBAVuD;AAW/D,EAAA,MAAM,EAAE,gBAXuD;AAY/D,EAAA,KAAK,EAAE,eAZwD;AAa/D,EAAA,EAAE,EAAE,YAb2D;AAc/D,EAAA,EAAE,EAAE,YAd2D;AAe/D,EAAA,EAAE,EAAE,YAf2D;AAgB/D,EAAA,QAAQ,EAAE,kBAhBqD;AAiB/D,EAAA,GAAG,EAAE,aAjB0D;AAkB/D,EAAA,IAAI,EAAE,cAlByD;AAmB/D,EAAA,MAAM,EAAE,gBAnBuD;AAoB/D,EAAA,GAAG,EAAE;AApB0D,CAAjE;AAuBA;;;;;;AAMG;AACH;;AACA,OAAM,SAAU,qBAAV,CACJ,OADI,EAEJ,KAFI,EAGJ,iBAHI,EAGwB;AAE5B,QAAM,gBAAgB,GAAI,OAAO,IAAI,gBAAgB,CAAC,OAAD,CAA5B,IAA0C,qBAAnE;AACA,EAAA,gBAAgB,CAAC,EAAjB,GAAsB,CAAtB;AAEA,SAAO,cAAc,CAAC,KAAD,EAAQ,gBAAR,EAA0B,iBAA1B,CAArB;AACD;AAED;;;;;;;AAOG;;AACH,OAAO,MAAM,yBAAyB,GAAG,CAGvC;AACA,EAAA,kBADA;AAEA,EAAA,KAFA;AAGA,EAAA;AAHA,CAHuC,KAgBpC;AACH,SAAO;AACL,IAAA,IAAI,EAAE;AAAE,MAAA,KAAK,EAAE,KAAK,CAAC,KAAf;AAAsB,MAAA,SAAS,EAAE,KAAK,CAAC;AAAvC,KADD;AAEL,IAAA,OAAO,EAAE,qBAAqB,CAAgC,kBAAhC,EAAoD,KAApD,EAA2D,CACvF,IAAI,iBAAiB,IAAI,EAAzB,CADuF,EAEvF,OAFuF,EAGvF,WAHuF,CAA3D;AAFzB,GAAP;AAQD,CAzBM","sourceRoot":""}
@@ -1,7 +1,7 @@
1
1
  /**
2
2
  * Finds and swaps a provided key for it's right to left format.
3
3
  */
4
- export var getRTLSafeKey = function (key, dir) {
4
+ export const getRTLSafeKey = (key, dir) => {
5
5
  if (dir === 'rtl') {
6
6
  switch (key) {
7
7
  case 'ArrowLeft':
@@ -1 +1 @@
1
- {"version":3,"sources":["../../src/utils/getRTLSafeKey.ts"],"names":[],"mappings":"AAAA;;AAEG;AACH,OAAO,IAAM,aAAa,GAAG,UAAC,GAAD,EAAc,GAAd,EAAgC;AAC3D,MAAI,GAAG,KAAK,KAAZ,EAAmB;AACjB,YAAQ,GAAR;AACE,WAAK,WAAL;AAAkB;AAChB,iBAAO,YAAP;AACD;;AAED,WAAK,YAAL;AAAmB;AACjB,iBAAO,WAAP;AACD;AAPH;AASD;;AAED,SAAO,GAAP;AACD,CAdM","sourceRoot":""}
1
+ {"version":3,"sources":["../../src/utils/getRTLSafeKey.ts"],"names":[],"mappings":"AAAA;;AAEG;AACH,OAAO,MAAM,aAAa,GAAG,CAAC,GAAD,EAAc,GAAd,KAAoC;AAC/D,MAAI,GAAG,KAAK,KAAZ,EAAmB;AACjB,YAAQ,GAAR;AACE,WAAK,WAAL;AAAkB;AAChB,iBAAO,YAAP;AACD;;AAED,WAAK,YAAL;AAAmB;AACjB,iBAAO,WAAP;AACD;AAPH;AASD;;AAED,SAAO,GAAP;AACD,CAdM","sourceRoot":""}
@@ -0,0 +1,25 @@
1
+ import * as React from 'react';
2
+ interface ReactSyntheticEvent extends React.SyntheticEvent<unknown> {
3
+ _reactName?: string;
4
+ dispatchConfig?: {
5
+ registrationName: string;
6
+ phasedRegistrationNames: {
7
+ bubbled: string;
8
+ captured: string;
9
+ };
10
+ };
11
+ }
12
+ declare type NonUndefined<A> = A extends undefined ? never : A;
13
+ declare type FunctionKeys<T extends object> = {
14
+ [K in keyof T]-?: NonUndefined<T[K]> extends Function ? K : never;
15
+ }[keyof T];
16
+ export declare type ReactCallbackName = FunctionKeys<React.DOMAttributes<unknown>>;
17
+ /**
18
+ * React.SyntheticEvent contains name of a callback that should be fired, this function returns it.
19
+ *
20
+ * Ideally, it should also distinguish regular and "capture" callbacks, but it's possible only with React 17 as
21
+ * ".eventPhase" there has proper value, see https://github.com/facebook/react/pull/19244. In React 16 all events
22
+ * are handled in bubble phase.
23
+ */
24
+ export declare function getReactCallbackName(event: ReactSyntheticEvent): ReactCallbackName | undefined;
25
+ export {};
@@ -0,0 +1,26 @@
1
+ /**
2
+ * React.SyntheticEvent contains name of a callback that should be fired, this function returns it.
3
+ *
4
+ * Ideally, it should also distinguish regular and "capture" callbacks, but it's possible only with React 17 as
5
+ * ".eventPhase" there has proper value, see https://github.com/facebook/react/pull/19244. In React 16 all events
6
+ * are handled in bubble phase.
7
+ */
8
+ export function getReactCallbackName(event) {
9
+ if (event._reactName) {
10
+ return event._reactName;
11
+ }
12
+
13
+ if (event.dispatchConfig) {
14
+ if (event.dispatchConfig.registrationName) {
15
+ return event.dispatchConfig.registrationName;
16
+ }
17
+
18
+ return event.dispatchConfig.phasedRegistrationNames.bubbled;
19
+ }
20
+
21
+ if (process.env.NODE_ENV !== 'production') {
22
+ // eslint-disable-next-line no-console
23
+ console.error(['Passed React.SyntheticEvent does not contain ".dispatchConfig" or "._reactName".', 'This should not happen, please report it to https://github.com/microsoft/fluentui']);
24
+ }
25
+ }
26
+ //# sourceMappingURL=getReactCallbackName.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../../src/utils/getReactCallbackName.ts"],"names":[],"mappings":"AAwBA;;;;;;AAMG;AACH,OAAM,SAAU,oBAAV,CAA+B,KAA/B,EAAyD;AAC7D,MAAI,KAAK,CAAC,UAAV,EAAsB;AACpB,WAAO,KAAK,CAAC,UAAb;AACD;;AAED,MAAI,KAAK,CAAC,cAAV,EAA0B;AACxB,QAAI,KAAK,CAAC,cAAN,CAAqB,gBAAzB,EAA2C;AACzC,aAAO,KAAK,CAAC,cAAN,CAAqB,gBAA5B;AACD;;AAED,WAAO,KAAK,CAAC,cAAN,CAAqB,uBAArB,CAA6C,OAApD;AACD;;AAED,MAAI,OAAO,CAAC,GAAR,CAAY,QAAZ,KAAyB,YAA7B,EAA2C;AACzC;AACA,IAAA,OAAO,CAAC,KAAR,CAAc,CACZ,kFADY,EAEZ,mFAFY,CAAd;AAID;AACF","sourceRoot":""}
@@ -0,0 +1,22 @@
1
+ import * as React from 'react';
2
+ /**
3
+ * Gets the trigger element of a FluentTriggerComponent (such as Tooltip or MenuTrigger).
4
+ *
5
+ * In the case where the immediate child is itself a FluentTriggerComponent and/or React Fragment,
6
+ * it returns the first descendant that is _not_ a FluentTriggerComponent or Fragment.
7
+ * This allows multiple triggers to be stacked, and still apply their props to the actual trigger element.
8
+ *
9
+ * For example, the following returns `<div id="child" />`:
10
+ * ```jsx
11
+ * getTriggerChild(
12
+ * <Tooltip>
13
+ * <MenuTrigger>
14
+ * <div id="child" />
15
+ * </MenuTrigger>
16
+ * </Tooltip>
17
+ * );
18
+ * ```
19
+ */
20
+ export declare const getTriggerChild: (children: React.ReactNode) => React.ReactElement & {
21
+ ref?: React.Ref<unknown>;
22
+ };
@@ -0,0 +1,26 @@
1
+ import * as React from 'react';
2
+ import { isFluentTrigger } from './isFluentTrigger';
3
+ /**
4
+ * Gets the trigger element of a FluentTriggerComponent (such as Tooltip or MenuTrigger).
5
+ *
6
+ * In the case where the immediate child is itself a FluentTriggerComponent and/or React Fragment,
7
+ * it returns the first descendant that is _not_ a FluentTriggerComponent or Fragment.
8
+ * This allows multiple triggers to be stacked, and still apply their props to the actual trigger element.
9
+ *
10
+ * For example, the following returns `<div id="child" />`:
11
+ * ```jsx
12
+ * getTriggerChild(
13
+ * <Tooltip>
14
+ * <MenuTrigger>
15
+ * <div id="child" />
16
+ * </MenuTrigger>
17
+ * </Tooltip>
18
+ * );
19
+ * ```
20
+ */
21
+
22
+ export const getTriggerChild = children => {
23
+ const child = React.Children.only(children);
24
+ return isFluentTrigger(child) ? getTriggerChild(child.props.children) : child;
25
+ };
26
+ //# sourceMappingURL=getTriggerChild.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../../src/utils/getTriggerChild.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAZ,MAAuB,OAAvB;AACA,SAAS,eAAT,QAAgC,mBAAhC;AAEA;;;;;;;;;;;;;;;;;AAiBG;;AACH,OAAO,MAAM,eAAe,GAAI,QAAD,IAAiF;AAC9G,QAAM,KAAK,GAAG,KAAK,CAAC,QAAN,CAAe,IAAf,CAAoB,QAApB,CAAd;AACA,SAAO,eAAe,CAAC,KAAD,CAAf,GAAyB,eAAe,CAAC,KAAK,CAAC,KAAN,CAAY,QAAb,CAAxC,GAAiE,KAAxE;AACD,CAHM","sourceRoot":""}
@@ -2,7 +2,8 @@ export * from './applyTriggerPropsToChildren';
2
2
  export * from './clamp';
3
3
  export * from './getNativeElementProps';
4
4
  export * from './getRTLSafeKey';
5
+ export * from './getTriggerChild';
6
+ export * from './isFluentTrigger';
5
7
  export * from './omit';
6
- export * from './onlyChild';
7
8
  export * from './properties';
8
9
  export * from './shouldPreventDefaultOnKeyDown';
@@ -2,8 +2,9 @@ export * from './applyTriggerPropsToChildren';
2
2
  export * from './clamp';
3
3
  export * from './getNativeElementProps';
4
4
  export * from './getRTLSafeKey';
5
+ export * from './getTriggerChild';
6
+ export * from './isFluentTrigger';
5
7
  export * from './omit';
6
- export * from './onlyChild';
7
8
  export * from './properties';
8
9
  export * from './shouldPreventDefaultOnKeyDown';
9
10
  //# sourceMappingURL=index.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,+BAA+B,CAAC;AAC9C,cAAc,SAAS,CAAC;AACxB,cAAc,yBAAyB,CAAC;AACxC,cAAc,iBAAiB,CAAC;AAChC,cAAc,QAAQ,CAAC;AACvB,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,iCAAiC,CAAC"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,+BAA+B,CAAC;AAC9C,cAAc,SAAS,CAAC;AACxB,cAAc,yBAAyB,CAAC;AACxC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,QAAQ,CAAC;AACvB,cAAc,cAAc,CAAC;AAC7B,cAAc,iCAAiC,CAAC"}
@@ -0,0 +1,22 @@
1
+ import * as React from 'react';
2
+ /**
3
+ * Allows a component to be tagged as a FluentUI trigger component.
4
+ *
5
+ * Triggers are special-case components: they attach event listeners and other props on their child,
6
+ * and use them to trigger another component to show. Examples include `MenuTrigger` and `Tooltip`.
7
+ *
8
+ * A component can be tagged as a trigger as follows:
9
+ * ```ts
10
+ * const MyComponent: React.FC<MyComponentProps> & FluentTriggerComponent = ...;
11
+ *
12
+ * MyComponent.isFluentTriggerComponent = true; // MUST also set this to true
13
+ * ```
14
+ */
15
+ export declare type FluentTriggerComponent = {
16
+ isFluentTriggerComponent?: boolean;
17
+ };
18
+ /**
19
+ * Checks if a given element is a FluentUI trigger (e.g. `MenuTrigger` or `Tooltip`).
20
+ * See the {@link FluentTriggerComponent} type for more info.
21
+ */
22
+ export declare const isFluentTrigger: (element: React.ReactElement) => boolean | undefined;
@@ -0,0 +1,8 @@
1
+ /**
2
+ * Checks if a given element is a FluentUI trigger (e.g. `MenuTrigger` or `Tooltip`).
3
+ * See the {@link FluentTriggerComponent} type for more info.
4
+ */
5
+ export const isFluentTrigger = element => {
6
+ return element.type.isFluentTriggerComponent;
7
+ };
8
+ //# sourceMappingURL=isFluentTrigger.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../../src/utils/isFluentTrigger.ts"],"names":[],"mappings":"AAmBA;;;AAGG;AACH,OAAO,MAAM,eAAe,GAAI,OAAD,IAAgC;AAC7D,SAAQ,OAAO,CAAC,IAAR,CAAwC,wBAAhD;AACD,CAFM","sourceRoot":""}
package/lib/utils/omit.js CHANGED
@@ -14,9 +14,9 @@
14
14
  // eslint-disable-next-line @typescript-eslint/no-explicit-any
15
15
  export function omit(obj, exclusions) {
16
16
  // eslint-disable-next-line @typescript-eslint/no-explicit-any
17
- var result = {};
17
+ const result = {};
18
18
 
19
- for (var key in obj) {
19
+ for (const key in obj) {
20
20
  if (exclusions.indexOf(key) === -1 && obj.hasOwnProperty(key)) {
21
21
  result[key] = obj[key];
22
22
  }
@@ -1 +1 @@
1
- {"version":3,"sources":["../../src/utils/omit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;AAYG;AACH;AACA,OAAM,SAAU,IAAV,CACJ,GADI,EAEJ,UAFI,EAEkB;AAEtB;AACA,MAAM,MAAM,GAAwB,EAApC;;AAEA,OAAK,IAAM,GAAX,IAAkB,GAAlB,EAAuB;AACrB,QAAI,UAAU,CAAC,OAAX,CAAmB,GAAnB,MAA4B,CAAC,CAA7B,IAAkC,GAAG,CAAC,cAAJ,CAAmB,GAAnB,CAAtC,EAA+D;AAC7D,MAAA,MAAM,CAAC,GAAD,CAAN,GAAc,GAAG,CAAC,GAAD,CAAjB;AACD;AACF;;AAED,SAAO,MAAP;AACD","sourceRoot":""}
1
+ {"version":3,"sources":["../../src/utils/omit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;AAYG;AACH;AACA,OAAM,SAAU,IAAV,CACJ,GADI,EAEJ,UAFI,EAEkB;AAEtB;AACA,QAAM,MAAM,GAAwB,EAApC;;AAEA,OAAK,MAAM,GAAX,IAAkB,GAAlB,EAAuB;AACrB,QAAI,UAAU,CAAC,OAAX,CAAmB,GAAnB,MAA4B,CAAC,CAA7B,IAAkC,GAAG,CAAC,cAAJ,CAAmB,GAAnB,CAAtC,EAA+D;AAC7D,MAAA,MAAM,CAAC,GAAD,CAAN,GAAc,GAAG,CAAC,GAAD,CAAjB;AACD;AACF;;AAED,SAAO,MAAP;AACD","sourceRoot":""}