|
1 | 1 | # @primer/components
|
2 | 2 |
|
| 3 | +## 26.0.0 |
| 4 | + |
| 5 | +### Major Changes |
| 6 | + |
| 7 | +- [`016a273f`](https://github.com/primer/components/commit/016a273fde30f0185e23309e1a39c1bc034174f8) [#1115](https://github.com/primer/components/pull/1115) Thanks [@VanAnderson](https://github.com/VanAnderson)! - Removes deprecated presentational theme variables in favor of _functional variables_ for styling components that are consistent across multiple themes. |
| 8 | + |
| 9 | + ## Migration guide |
| 10 | + |
| 11 | + If you don't use any color-related system props (e.g. `color`, `bg`, `borderColor`), all components should work without changes. If you're using color-related system props, you'll need to update them to use the new functional variables. Reference the tables below to see how old variables map to new functional variables. |
| 12 | + |
| 13 | + If you have any questions, feel free to reach out in the #design-systems channel. |
| 14 | + |
| 15 | + #### Text |
| 16 | + |
| 17 | + | `v25` | `v26` | |
| 18 | + | ------------------------ | ------------------------ | |
| 19 | + | `color="text.gray"` | `color="text.secondary"` | |
| 20 | + | `color="text.grayLight"` | `color="text.tertiary"` | |
| 21 | + | `color="text.grayDark"` | `color="text.primary"` | |
| 22 | + | `color="text.red"` | `color="text.danger"` | |
| 23 | + | `color="text.white"` | `color="text.inverse"` | |
| 24 | + | `color="gray.6"` | `color="text.secondary"` | |
| 25 | + | `color="gray.5"` | `color="text.tertiary"` | |
| 26 | + | `color="gray.9"` | `color="text.primary"` | |
| 27 | + | `color="red.6"` | `color="text.danger"` | |
| 28 | + | `color="white"` | `color="text.inverse"` | |
| 29 | + | `color="blue.5"` | `color="text.link"` | |
| 30 | + | `color="gray.4"` | `color="text.disabled"` | |
| 31 | + | `color="green.5"` | `color="text.success"` | |
| 32 | + | `color="yellow.8"` | `color="text.warning"` | |
| 33 | + |
| 34 | + #### Icon |
| 35 | + |
| 36 | + | `v25` | `v25` | |
| 37 | + | ------------------ | ------------------------ | |
| 38 | + | `color="gray.9"` | `color="icon.primary"` | |
| 39 | + | `color="gray.6"` | `color="icon.secondary"` | |
| 40 | + | `color="gray.4"` | `color="icon.tertiary"` | |
| 41 | + | `color="blue.5"` | `color="icon.info"` | |
| 42 | + | `color="red.5"` | `color="icon.danger"` | |
| 43 | + | `color="green.6"` | `color="icon.success"` | |
| 44 | + | `color="yellow.8"` | `color="icon.warning"` | |
| 45 | + |
| 46 | + #### Border |
| 47 | + |
| 48 | + | `v25` | `v26` | |
| 49 | + | --------------------------------- | ------------------------------- | |
| 50 | + | `borderColor="border.blue"` | `borderColor="border.info"` | |
| 51 | + | `borderColor="border.blueLight"` | n/a | |
| 52 | + | `borderColor="border.grayLight"` | `borderColor="border.primary"` | |
| 53 | + | `borderColor="border.grayDark"` | `borderColor="border.tertiary"` | |
| 54 | + | `borderColor="border.grayDarker"` | n/a | |
| 55 | + | `borderColor="border.green"` | `borderColor="border.success"` | |
| 56 | + | `borderColor="border.greenLight"` | n/a | |
| 57 | + | `borderColor="border.purple"` | n/a | |
| 58 | + | `borderColor="border.red"` | `borderColor="border.danger"` | |
| 59 | + | `borderColor="border.redLight"` | n/a | |
| 60 | + | `borderColor="border.white"` | `borderColor="border.inverse"` | |
| 61 | + | `borderColor="border.whiteFace"` | n/a | |
| 62 | + | `borderColor="border.yellow"` | `borderColor="border.warning"` | |
| 63 | + | `borderColor="border.blackFade"` | `borderColor="fade.fg15"` | |
| 64 | + | `borderColor="border.whiteFade"` | `borderCOlor="fade.white15"` | |
| 65 | + | `borderColor="blue.5"` | `borderColor="border.info"` | |
| 66 | + | `borderColor="gray.2"` | `borderColor="border.primary"` | |
| 67 | + | `borderColor="gray.3"` | `borderColor="border.tertiary"` | |
| 68 | + | `borderColor="green.4"` | `borderColor="border.success"` | |
| 69 | + | `borderColor="red.5"` | `borderColor="border.danger"` | |
| 70 | + | `borderColor="white"` | `borderColor="border.inverse"` | |
| 71 | + |
| 72 | + #### Background |
| 73 | + |
| 74 | + | `v25` | `v26` | |
| 75 | + | ------------------- | ------------------------ | |
| 76 | + | `bg="white"` | `bg="bg.primary"` | |
| 77 | + | `bg="bg.grayLight"` | `bg="bg.secondary"` | |
| 78 | + | `bg="bg.gray"` | `bg="bg.tertiary"` | |
| 79 | + | `bg="bg.grayDark"` | `bg="bg.canvasInverse"` | |
| 80 | + | `bg="blue.0"` | `bg="bg.info"` | |
| 81 | + | `bg="blue.5"` | `bg="bg.infoInverse"` | |
| 82 | + | `bg="red.0"` | `bg="bg.danger"` | |
| 83 | + | `bg="red.5"` | `bg="bg.dangerInverse"` | |
| 84 | + | `bg="green.1"` | `bg="bg.success"` | |
| 85 | + | `bg="green.5"` | `bg="bg.successInverse"` | |
| 86 | + |
| 87 | + #### Labels |
| 88 | + |
| 89 | + _Note the change in pluralization from 'labels' to 'label'._ |
| 90 | + |
| 91 | + | `v25` | `v26` | |
| 92 | + | ----------------------------- | ------------------------------------- | |
| 93 | + | `color="labels.grayDarkText"` | `color="label.primary.text` | |
| 94 | + | `borderColor="labels.gray"` | `borderColor="label.primary.border` | |
| 95 | + | `color="labels.grayText"` | `color="label.secondary.text` | |
| 96 | + | `borderColor="labels.gray"` | `borderColor="label.secondary.border` | |
| 97 | + | `color="labels.blueText"` | `color="label.info.text` | |
| 98 | + | `borderColor="labels.blue"` | `borderColor="label.info.border` | |
| 99 | + | `color="labels.greenText"` | `color="label.success.text` | |
| 100 | + | `borderColor="labels.green"` | `borderColor="label.success.border` | |
| 101 | + | `color="labels.yellowText"` | `color="label.warning.text` | |
| 102 | + | `borderColor="labels.yellow"` | `borderColor="label.warning.border` | |
| 103 | + | `color="labels.redText"` | `color="label.danger.text` | |
| 104 | + | `borderColor="labels.red"` | `borderColor="label.danger.border` | |
| 105 | + | `color="labels.orangeText"` | `color="label.primary.text` | |
| 106 | + | `borderColor="labels.orange"` | `borderColor="label.primary.text` | |
| 107 | + | `color="labels.pinkText"` | n/a | |
| 108 | + | `borderColor="labels.pink"` | n/a | |
| 109 | + | `color="labels.purpleText"` | n/a | |
| 110 | + | `borderColor="labels.purple"` | n/a | |
| 111 | + |
| 112 | + #### Counters |
| 113 | + |
| 114 | + | `v25` | `v26` | |
| 115 | + | --------------------- | -------------------- | |
| 116 | + | `scheme="gray"` | `scheme="primary"` | |
| 117 | + | `scheme="gray-light"` | `scheme="secondary"` | |
| 118 | + |
| 119 | + #### Timeline |
| 120 | + |
| 121 | + | `v25` | `v26` | |
| 122 | + | ----------------------------------------- | ----------------------------- | |
| 123 | + | `bg="red.5"` | `bg="prState.closed.bg"` | |
| 124 | + | `bg="green.5"` | `bg="prState.open.bg"` | |
| 125 | + | `bg="purple.5"` | `bg="prState.merged.bg"` | |
| 126 | + | `bg="gray.5"` | `bg="prState.draft.bg"` | |
| 127 | + | `color="white"` (context: closed PR icon) | `color="prState.closed.text"` | |
| 128 | + | `color="white"` (context: open PR icon) | `color="prState.open.text"` | |
| 129 | + | `color="white"` (context: merged PR icon) | `color="prState.merged.text"` | |
| 130 | + | `color="white"` (context: merged PR icon) | `color="prState.draft.text"` | |
| 131 | + |
3 | 132 | ## 25.0.0
|
4 | 133 |
|
5 | 134 | ### Major Changes
|
|
0 commit comments