@primer/react 0.0.0-20260324195210 → 0.0.0-20260324221644

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 (36) hide show
  1. package/CHANGELOG.md +4 -2
  2. package/dist/ActionList/List.d.ts.map +1 -1
  3. package/dist/ActionList/List.js +41 -41
  4. package/dist/AnchoredOverlay/AnchoredOverlay-647c7065.css +2 -0
  5. package/dist/AnchoredOverlay/AnchoredOverlay-647c7065.css.map +1 -0
  6. package/dist/AnchoredOverlay/AnchoredOverlay.d.ts.map +1 -1
  7. package/dist/AnchoredOverlay/AnchoredOverlay.js +62 -13
  8. package/dist/AnchoredOverlay/AnchoredOverlay.module.css.js +2 -2
  9. package/dist/ButtonGroup/ButtonGroup.d.ts.map +1 -1
  10. package/dist/ButtonGroup/ButtonGroup.js +23 -23
  11. package/dist/Checkbox/Checkbox.d.ts.map +1 -1
  12. package/dist/Checkbox/Checkbox.js +5 -5
  13. package/dist/Dialog/Dialog.js +6 -5
  14. package/dist/FilteredActionList/FilteredActionList.d.ts.map +1 -1
  15. package/dist/FilteredActionList/FilteredActionList.js +8 -8
  16. package/dist/Overlay/Overlay.d.ts +2 -0
  17. package/dist/Overlay/Overlay.d.ts.map +1 -1
  18. package/dist/Overlay/Overlay.js +83 -79
  19. package/dist/PageHeader/PageHeader.d.ts.map +1 -1
  20. package/dist/PageHeader/PageHeader.js +31 -30
  21. package/dist/TextInput/TextInput.d.ts.map +1 -1
  22. package/dist/TextInput/TextInput.js +6 -5
  23. package/dist/TooltipV2/Tooltip.d.ts.map +1 -1
  24. package/dist/TooltipV2/Tooltip.js +4 -4
  25. package/dist/experimental/Tabs/Tabs.d.ts +1 -1
  26. package/dist/experimental/Tabs/Tabs.d.ts.map +1 -1
  27. package/dist/experimental/Tabs/Tabs.js +16 -16
  28. package/dist/hooks/useMergedRefs.d.ts +5 -5
  29. package/dist/hooks/useMergedRefs.d.ts.map +1 -1
  30. package/dist/hooks/useMergedRefs.js +5 -11
  31. package/dist/hooks/useProvidedRefOrCreate.d.ts +10 -7
  32. package/dist/hooks/useProvidedRefOrCreate.d.ts.map +1 -1
  33. package/dist/hooks/useProvidedRefOrCreate.js +10 -10
  34. package/package.json +1 -1
  35. package/dist/AnchoredOverlay/AnchoredOverlay-0f6f45b5.css +0 -2
  36. package/dist/AnchoredOverlay/AnchoredOverlay-0f6f45b5.css.map +0 -1
@@ -1,8 +1,5 @@
1
1
  import { c } from 'react-compiler-runtime';
2
- import { version } from 'react';
3
-
4
- var _version$split$;
5
- const majorReactVersion = parseInt((_version$split$ = version.split('.')[0]) !== null && _version$split$ !== void 0 ? _version$split$ : '18', 10);
2
+ import 'react';
6
3
 
7
4
  /**
8
5
  * Combine two refs of matching type (typically an external or forwarded ref and an internal `useRef` object or
@@ -20,18 +17,18 @@ const majorReactVersion = parseInt((_version$split$ = version.split('.')[0]) !==
20
17
  * // React 18
21
18
  * const Example = forwardRef<HTMLButtonElement, {}>((props, forwardedRef) => {
22
19
  * const ref = useRef<HTMLButtonElement>(null)
23
- * const mergedRef = useMergedRefs(forwardedRef, ref)
20
+ * const combinedRef = useMergedRefs(forwardedRef, ref)
24
21
  *
25
- * return <button ref={mergedRef} />
22
+ * return <button ref={combinedRef} />
26
23
  * })
27
24
  *
28
25
  * @example
29
26
  * // React 19
30
27
  * const Example = ({ref: externalRef}: {ref?: Ref<HTMLButtonElement>}) => {
31
28
  * const ref = useRef<HTMLButtonElement>(null)
32
- * const mergedRef = useMergedRefs(externalRef, ref)
29
+ * const combinedRef = useMergedRefs(externalRef, ref)
33
30
  *
34
- * return <button ref={mergedRef} />
31
+ * return <button ref={combinedRef} />
35
32
  * }
36
33
  */
37
34
  function useMergedRefs(refA, refB) {
@@ -41,9 +38,6 @@ function useMergedRefs(refA, refB) {
41
38
  t0 = value => {
42
39
  const cleanupA = setRef(refA, value);
43
40
  const cleanupB = setRef(refB, value);
44
- if (majorReactVersion <= 18) {
45
- return;
46
- }
47
41
  return () => {
48
42
  if (cleanupA) {
49
43
  cleanupA();
@@ -7,14 +7,17 @@ import React from 'react';
7
7
  * @param providedRef The ref to use - if undefined, will use the ref from a call to React.useRef
8
8
  * @type TRef The type of the RefObject which should be created.
9
9
  *
10
- * @note This hook is overly restrictive in that it forces the provided ref to be a ref object rather than a callback.
11
- * In particular, it should **not** be used to merge internal refs with forwarded refs. For this, use
12
- * {@linkcode useMergedRefs} instead.
10
+ * @deprecated This hook is incompatible with forwarded callback refs. Prefer `useMergedRefs` with an internally
11
+ * created ref instead.
13
12
  *
14
- * The primary valid use case for this hook is for when the consumer is using the provided ref to point to an external
15
- * element, like an externally rendered anchor. This is 'backwards' from forwarded refs with respect to data flow; the
16
- * consumer is passing a reference to an external element, rather than passing a handle to obtain a reference to an
17
- * internal element.
13
+ * ```diff
14
+ * - const ref = useProvidedRefOrCreate(forwardedRef as RefObject<...>)
15
+ * + const ref = useRef(null)
16
+ * + const mergedRef = useMergedRefs(forwardedRef, ref)
17
+ *
18
+ * - return <div ref={ref} />
19
+ * + return <div ref={mergedRef} />
20
+ * ```
18
21
  */
19
22
  export declare function useProvidedRefOrCreate<TRef>(providedRef?: React.RefObject<TRef | null>): React.RefObject<TRef | null>;
20
23
  //# sourceMappingURL=useProvidedRefOrCreate.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"useProvidedRefOrCreate.d.ts","sourceRoot":"","sources":["../../src/hooks/useProvidedRefOrCreate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAMzB;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,WAAW,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,KAAK,CAAC,SAAS,CAAC,IAAI,GAAG,IAAI,CAAC,CAGrH"}
1
+ {"version":3,"file":"useProvidedRefOrCreate.d.ts","sourceRoot":"","sources":["../../src/hooks/useProvidedRefOrCreate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAEzB;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,WAAW,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,KAAK,CAAC,SAAS,CAAC,IAAI,GAAG,IAAI,CAAC,CAGrH"}
@@ -1,8 +1,5 @@
1
1
  import React from 'react';
2
2
 
3
- // used in doc comment
4
- // eslint-disable-next-line @typescript-eslint/no-unused-vars
5
-
6
3
  /**
7
4
  * There are some situations where we only want to create a new ref if one is not provided to a component
8
5
  * or hook as a prop. However, due to the `rules-of-hooks`, we cannot conditionally make a call to `React.useRef`
@@ -11,14 +8,17 @@ import React from 'react';
11
8
  * @param providedRef The ref to use - if undefined, will use the ref from a call to React.useRef
12
9
  * @type TRef The type of the RefObject which should be created.
13
10
  *
14
- * @note This hook is overly restrictive in that it forces the provided ref to be a ref object rather than a callback.
15
- * In particular, it should **not** be used to merge internal refs with forwarded refs. For this, use
16
- * {@linkcode useMergedRefs} instead.
11
+ * @deprecated This hook is incompatible with forwarded callback refs. Prefer `useMergedRefs` with an internally
12
+ * created ref instead.
13
+ *
14
+ * ```diff
15
+ * - const ref = useProvidedRefOrCreate(forwardedRef as RefObject<...>)
16
+ * + const ref = useRef(null)
17
+ * + const mergedRef = useMergedRefs(forwardedRef, ref)
17
18
  *
18
- * The primary valid use case for this hook is for when the consumer is using the provided ref to point to an external
19
- * element, like an externally rendered anchor. This is 'backwards' from forwarded refs with respect to data flow; the
20
- * consumer is passing a reference to an external element, rather than passing a handle to obtain a reference to an
21
- * internal element.
19
+ * - return <div ref={ref} />
20
+ * + return <div ref={mergedRef} />
21
+ * ```
22
22
  */
23
23
  function useProvidedRefOrCreate(providedRef) {
24
24
  const createdRef = React.useRef(null);
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@primer/react",
3
3
  "type": "module",
4
- "version": "0.0.0-20260324195210",
4
+ "version": "0.0.0-20260324221644",
5
5
  "description": "An implementation of GitHub's Primer Design System using React",
6
6
  "main": "./dist/index.js",
7
7
  "module": "./dist/index.js",
@@ -1,2 +0,0 @@
1
- .prc-AnchoredOverlay-ResponsiveCloseButtonContainer-nuium{position:relative}.prc-AnchoredOverlay-ResponsiveCloseButton-z-2rx{display:none;position:absolute;right:var(--base-size-8,.5rem);top:var(--base-size-8,.5rem)}@media screen and (max-width:calc(48rem - 0.02px)){.prc-AnchoredOverlay-ResponsiveCloseButton-z-2rx{display:inline-grid}}.prc-AnchoredOverlay-Wrapper-w6jU3{anchor-scope:--anchored-overlay-anchor}.prc-AnchoredOverlay-Anchor-DWRfK{anchor-name:--anchored-overlay-anchor}.prc-AnchoredOverlay-AnchoredOverlay-fYg9Z{position-anchor:--anchored-overlay-anchor;position-try-fallbacks:flip-block,flip-inline,flip-block flip-inline;position-visibility:anchors-visible;position:fixed;z-index:100}.prc-AnchoredOverlay-AnchoredOverlay-fYg9Z[data-side=outside-bottom]{left:anchor(left);top:calc(anchor(bottom) + var(--base-size-4,.25rem))}.prc-AnchoredOverlay-AnchoredOverlay-fYg9Z[data-side=outside-top]{bottom:anchor(top);left:anchor(left);margin-bottom:var(--base-size-4,.25rem)}.prc-AnchoredOverlay-AnchoredOverlay-fYg9Z[data-side=outside-left]{margin-right:var(--base-size-4,.25rem);right:anchor(left);top:anchor(top)}.prc-AnchoredOverlay-AnchoredOverlay-fYg9Z[data-side=outside-right]{left:anchor(right);margin-left:var(--base-size-4,.25rem);top:anchor(top)}
2
- /*# sourceMappingURL=AnchoredOverlay-0f6f45b5.css.map */
@@ -1 +0,0 @@
1
- {"version":3,"sources":["../src/AnchoredOverlay/AnchoredOverlay.module.css.js"],"names":[],"mappings":"AAAA,0DACE,iBACF,CAEA,iDAIE,YAAa,CAHb,iBAAkB,CAElB,8BAAyB,CADzB,4BAOF,CAHE,mDANF,iDAOI,mBAEJ,CADE,CAGF,mCACE,sCACF,CAEA,kCAEE,qCACF,CAEA,2CAEE,yCAA0C,CAC1C,oEAGwB,CACxB,mCAAoC,CAEpC,cAAe,CADf,WA0BF,CAvBE,qEAGE,iBAAkB,CADlB,oDAEF,CAEA,kEAEE,kBAAmB,CACnB,iBAAkB,CAFlB,uCAGF,CAEA,mEAGE,sCAAgC,CAFhC,kBAAmB,CACnB,eAEF,CAEA,oEACE,kBAAmB,CAEnB,qCAA+B,CAD/B,eAEF","file":"AnchoredOverlay-0f6f45b5.css","sourcesContent":[".ResponsiveCloseButtonContainer {\n position: relative;\n}\n\n.ResponsiveCloseButton {\n position: absolute;\n top: var(--base-size-8);\n right: var(--base-size-8);\n display: none;\n\n @media screen and (--viewportRange-narrow) {\n display: inline-grid;\n }\n}\n\n.Wrapper {\n anchor-scope: --anchored-overlay-anchor;\n}\n\n.Anchor {\n /* Anchor name, this is currently tied to `renderAnchor` */\n anchor-name: --anchored-overlay-anchor;\n}\n\n.AnchoredOverlay {\n /* Anchor position, this is currently tied to `<Overlay>` */\n position-anchor: --anchored-overlay-anchor;\n position-try-fallbacks:\n flip-block,\n flip-inline,\n flip-block flip-inline;\n position-visibility: anchors-visible;\n z-index: 100;\n position: fixed;\n\n &[data-side='outside-bottom'] {\n /* stylelint-disable primer/spacing */\n top: calc(anchor(bottom) + var(--base-size-4));\n left: anchor(left);\n }\n\n &[data-side='outside-top'] {\n margin-bottom: var(--base-size-4);\n bottom: anchor(top);\n left: anchor(left);\n }\n\n &[data-side='outside-left'] {\n right: anchor(left);\n top: anchor(top);\n margin-right: var(--base-size-4);\n }\n\n &[data-side='outside-right'] {\n left: anchor(right);\n top: anchor(top);\n margin-left: var(--base-size-4);\n }\n}\n"]}