Skip to content

CHANGELOG.md

Latest commit

 

History

History
1620 lines (889 loc) · 106 KB

CHANGELOG.md

File metadata and controls

1620 lines (889 loc) · 106 KB

@primer/primitives

11.5.1

Patch Changes

11.5.0

Minor Changes

  • #1319 dccf2af Thanks @lukasoppermann! - Add z-index design tokens for managing stacking context. Introduces base z-index scale (0-600) and 8 semantic functional tokens: behind, default, sticky, dropdown, overlay, modal, popover, and skipLink. Includes LLM metadata with usage guidance and shadow-to-z-index alignment rules.

  • #1315 8bb3e76 Thanks @lukasoppermann! - Add some missing tokens that confused the AI

  • #1320 6c1af22 Thanks @lukasoppermann! - Add negative base size tokens (negative-2 through negative-48) for sizes 2–48

Patch Changes

  • #1301 423b6e1 Thanks @lukasoppermann! - Convert duration tokens to w3c

  • #1318 4d0f257 Thanks @lukasoppermann! - Fix dark mode contrast for controlTrack and controlKnob tokens. The track now recedes (darker) and the knob stands out (lighter) in all dark mode variants, fixing the inverted visual hierarchy in SegmentedControl and ToggleSwitch.

  • #1308 135dd9b Thanks @lukasoppermann! - Update shadow tokens to use W3C DTCG object format for dimension values

    • Shadow token dimension properties (offsetX, offsetY, blur, spread) now use object format { value: number, unit: "px" } instead of legacy strings like "1px"
    • Updated shadowToCss transformer to handle W3C dimension objects
    • Updated ShadowTokenValue type to require DimensionTokenValue for dimension properties
    • Legacy string format for shadow dimensions is no longer supported

  • #1306 e4e355f Thanks @lukasoppermann! - Adding metadata for:

    • shadow tokens
    • display tokens
    • ansi colors
    • syntax colors

  • #1305 305c559 Thanks @lukasoppermann! - Change dimension tokens to W3C DTCG format (breaking change)

    • The transformers dimensionToRem, dimensionToRemPxArray, and dimensionToPixelUnitless now only accept W3C DTCG object-format dimension tokens. Legacy string-based dimension values are no longer supported and will throw errors.
    • In the W3C DTCG format, only px and rem units are supported. Support for em units has been removed.

  • #1302 d5a7908 Thanks @lukasoppermann! - Improve context for agents

11.4.0

Minor Changes

Patch Changes

11.3.2

Patch Changes

11.3.1

Patch Changes

11.3.0

Minor Changes

Patch Changes

11.2.1

Patch Changes

11.2.0

Minor Changes

11.1.0

Minor Changes

Patch Changes

11.0.0

Major Changes

  • #1190 0b1e88e Thanks @langermank! - - Adds new high contrast themes for light/dark tritanopia, colorblind, and dark dimmed (soft dark) themes

Minor Changes

Patch Changes

  • #1234 efaa46c Thanks @langermank! - - Fix disabled fg color in dark
    • Increase opacity of transparent color selected state in dark

10.7.0

Minor Changes

Patch Changes

10.6.0

Minor Changes

Patch Changes

  • #1200 72cf27d Thanks @langermank! - Bug fixes:
    • High contrast danger color on hover
    • High contrast translucent border
    • High contrast danger button hover border-color

10.5.0

Minor Changes

Patch Changes

10.4.0

Minor Changes

Patch Changes

10.3.4

Patch Changes

  • #1154 f86174b Thanks @lukasoppermann! - Fix borderColor-closed-muted in dark-protanopia-deuteranopia and revert protanopia-deuteranopia open color to be orange again
    • borderColor-closed-muted in dark-protanopia-deuteranopia is now gray instead of orange
    • borderColor-open-[muted|emphasis] in protanopia-deuteranopia is now orange again (instead of blue)
    • fgColor-open in protanopia-deuteranopia is now orange again (instead of blue)
    • bgColor-open-[muted|emphasis] in protanopia-deuteranopia is now orange again (instead of blue)

10.3.3

Patch Changes

10.3.2

Patch Changes

10.3.1

Patch Changes

10.3.0

Minor Changes

  • #1100 b995538 Thanks @lukasoppermann! - Changing the way we use references in css output, to keep all references to tokens that are present in the final output

Patch Changes

10.2.0

Minor Changes

10.1.0

Minor Changes

Patch Changes

10.0.0

Major Changes

Minor Changes

Patch Changes

9.1.2

Patch Changes

9.1.1

Patch Changes

9.1.0

Minor Changes

Patch Changes

9.0.3

Patch Changes

9.0.2

Patch Changes

9.0.1

Patch Changes

9.0.0

Major Changes

  • #1021 8b015a0 Thanks @langermank! - Update invisible button variant text color to be default instead of link blue

  • #1025 9ab8102 Thanks @langermank! - Fix inconsistent HC transparent colors

  • #1023 0f5625e Thanks @langermank! - Change fgColor-onEmphasis to white in dark high contrast theme

  • #1016 39862e9 Thanks @langermank! - # Updated neutral base color scales

    Changes

    • Theme specific neutral scales have been replaced with two new scales: light and dark.
    • The new light and dark scales are inverted, where 0 is the lightest shade in light and the darkest shade in dark.
    • Functional color tokens have been updated to use the new light and dark scales, and several overrides have been removed due to the new inverted design.

    Migration

    • Functional color tokens all work as expected and have been tested to meet minimum contrast requirements.
    • If you are using primer/primitives base color scales directly, you may need to update how those colors are applied. See the migration table which outlines approximately how the new colors map to the old colors.

    Light scale migration

    Old color New color
    0 0
    1 2
    2 5
    3 7
    4 7
    5 8
    6 8
    7 9
    8 10
    9 11

    Dark scale migration

    Old color New color
    9 0
    8 1
    7 2
    6 4
    5 6
    4 7
    3 8
    2 9
    1 10
    0 11

    Dark high contrast scale migration

    Old color New color
    9 0
    8 3
    7 5
    6 6
    5 7
    4 8
    3 9
    2 10
    1 11

    Dark dimmed scale migration

    Old color New color
    9 1
    8 2
    7 4
    6 5
    5 6
    4 7
    3 7
    2 8
    1 9
    0 10

    Light high contrast scale migration

    Old color New color
    0 white
    1 2
    2 5
    3 7
    4 7
    5 8
    6 9
    7 10
    8 11
    9 black

  • #1024 2348455 Thanks @langermank! - Extend neutral scale to include white/black (0-13)

  • #956 13f62d5 Thanks @lukasoppermann! - Removed space tokens

  • #1026 401fef1 Thanks @langermank! - - Update counter bg styles

    • Contrast fixes

  • #968 d845fdf Thanks @lukasoppermann! - Rename data-[colorName]-color to data-[colorName]-color-emphasis

8.2.4

Patch Changes

8.2.3

Patch Changes

8.2.2

Patch Changes

8.2.1

Patch Changes

8.2.0

Minor Changes

Patch Changes

8.1.0

Minor Changes

Patch Changes

8.0.0

Major Changes

7.17.0

Minor Changes

Patch Changes

7.16.0

Minor Changes

Patch Changes

7.15.15

Patch Changes

7.15.14

Patch Changes

7.15.13

Patch Changes

7.15.12

Patch Changes

7.15.11

Patch Changes

7.15.10

Patch Changes

7.15.9

Patch Changes

7.15.8

Patch Changes

7.15.7

Patch Changes

7.15.6

Patch Changes

7.15.5

Patch Changes

7.15.4

Patch Changes

7.15.3

Patch Changes

  • #778 f546c45 Thanks @mperrotti! - Updates inactive button text colors to meet contrast against the inactive button background color.

7.15.2

Patch Changes

7.15.1

Patch Changes

  • #774 3a6d736 Thanks @mperrotti! - Adds color tokens for the "inactive" button state. Tokens are added to the old and new builds so we can still support styling with styled-components

7.15.0

Minor Changes

  • #744 5f9eb77 Thanks @mperrotti! - Introduces design tokens for motion properties, and adds tokens to support loading indicators.

Patch Changes

7.14.1

Patch Changes

  • #743 5125c62 Thanks @langermank! - - Disabled state for transparent type controls is now transparent

    • Reverted the selected color for transparent type controls back to the original (pulled from old source file)
    • Fixed the disabled fgColor for ToggleSwitch

  • #742 efa8b1c Thanks @lukasoppermann! - buttonCounter color hotfix

  • #739 04a316c Thanks @lukasoppermann! - Fix contrast for bgColor-neutral-muted

7.14.0

Minor Changes

Patch Changes

7.13.1

Patch Changes

  • #733 f431e7e Thanks @langermank! - - Remove the default button inset shadow (its basically invisible)

    • Switch danger button to use the same border strategy as primary for hover/active

  • #735 0d982b1 Thanks @langermank! - Add missing fallbacks for disabled buttons

  • #731 5ebfafe Thanks @lukasoppermann! - change scss output from css variables to scss variables

  • #734 df91f47 Thanks @langermank! - - Add iconColor tokens for the invisible button variant

    • Remove highlight shadow token as its no longer used for Button

7.13.0

Minor Changes

  • #682 a082224 Thanks @langermank! - - Add inverse color options for semantic color tokens to support Toast
    • Update the default emphasis background color to white in dark mode
    • Add overlay size tokens

Patch Changes

7.12.0

Minor Changes

Patch Changes

7.11.14

Patch Changes

7.11.13

Patch Changes

7.11.12

Patch Changes

7.11.11

Patch Changes

7.11.10

Patch Changes

7.11.9

Patch Changes

7.11.8

Patch Changes

7.11.7

Patch Changes

  • ad20369 Thanks @lukasoppermann! - ## Updated workflow for v8 tokens
    • size-fine and size-coarse tokens are now wrapped in media queries

7.11.6

Patch Changes

7.11.5

Patch Changes

7.11.4

Patch Changes

7.11.3

Patch Changes

  • #542 9df92a7 Thanks @lukasoppermann! - - accent.subtle in dark is less opaque to have a 4.5 contrast with new accent color
    • danger and close fg slightly changed in light mode to contrast with fg.default (as we have some red links)
    • attention.emphasis darker to have 4.5:1 contrast with fg.onEmphasis

7.11.2

Patch Changes

7.11.1

Patch Changes

7.11.0

Minor Changes

  • #485 4e408ca Thanks @lukasoppermann! - Adds control.borderColor.emphasis color token

  • #449 7130392 Thanks @rezrah! - Deprecated marketing design tokens for Button components

    Marketing tokens will be served from @primer/brand-primitives in future.

    npm install --save @primer/brand-primitives
    - ---color-mktg-btn-bg
+ --brand-Button-background-base
    - --color-mktg-btn-shadow-outline
+ --brand-Button-shadow-default
    - --color-mktg-btn-shadow-focus
+ --brand-Button-shadow-focus
    - --color-mktg-btn-shadow-hover
+ --brand-Button-shadow-primary-hover
    - --color-mktg-btn-shadow-muted
+ --color-mktg-btn-shadow-hover-muted

    🔗 See the 0.9.0 for all other tokens.

  • #385 e03c7fd Thanks @simurai! - Add Noto Sans to the font stack

  • #384 8b76794 Thanks @langermank! - - Remove deprecated focus color tokens in favor of "global" styles from Primer CSS

7.10.0

Minor Changes

Patch Changes

7.9.0

Minor Changes

Patch Changes

7.8.4

Patch Changes

7.8.3

Patch Changes

7.8.2

Patch Changes

7.8.1

Patch Changes

7.8.0

Minor Changes

  • #317 45359ea Thanks @langermank! - - Initial design tokens release for interal Primer team use only
    • Private docs that can be accessed at /typography and /size
    • Separate dist for testing purposes only

7.7.0

Minor Changes

7.6.0

Minor Changes

Patch Changes

7.5.1

Patch Changes

7.5.0

Minor Changes

Patch Changes

7.4.1

Patch Changes

7.4.0

Minor Changes

7.3.0

Minor Changes

7.2.0

Minor Changes

Patch Changes

7.1.1

Patch Changes

7.1.0

Minor Changes

7.0.1

Patch Changes

7.0.0

Major Changes

6.1.0

Minor Changes

6.0.0

Major Changes

5.1.0

Minor Changes

5.0.0

Major Changes

  • #245 65ad2df Thanks @colebemis! - The deprecations directory in the dist directory has been renamed to deprecated:

    dist/
- deprecations/
+ deprecated/

    You'll need to update your imports accordingly:

    - import deprecatedColors from '@primer/primitives/dist/deprecations/colors.json'
+ import deprecatedColors from '@primer/primitives/dist/deprecated/colors.json'

Minor Changes

  • #245 65ad2df Thanks @colebemis! - The dist directory now contains a removed directory with data about removed variables organized by category:

      dist/
    js/
    ts/
    json/
    scss/
    deprecated/
+   removed/
+     colors.json

    Each JSON file in the removed directory contains a mapping of removed variables to replacement variables. Example:

    // dist/removed/colors.json
{
  "text.primary": "fg.default", // this means: `text.primary` is deprecated. Use `fg.default` instead
  "auto.blue.4": ["accent.fg, accent.emphasis"], // this means: `auto.blue.4` is deprecated. Use `accent.fg` or `accent.emphasis` instead
  "text.white": null // this means: `text.white` is deprecated. We don't have a replacement for it
}

    This data will allow you to write linters to prevent usage of removed variables.

Patch Changes

4.8.1

Patch Changes

4.8.0

Minor Changes

Patch Changes

4.7.1

Patch Changes

4.7.0

Minor Changes

4.6.9

Patch Changes

4.6.8

Patch Changes

4.6.7

Patch Changes

4.6.6

Patch Changes

4.6.5

Patch Changes

4.6.4

Patch Changes

4.6.3

Patch Changes

4.6.2

Patch Changes

4.6.1

Patch Changes

4.6.0

Minor Changes

  • #202 25a91d9 Thanks @colebemis! - The dist directory now contains a deprecations directory with variable deprecation data organized by category:

      dist/
    js/
    ts/
    json/
    scss/
+   deprecations/
+     colors.json

    Each JSON file in the deprecations directory contains a mapping of deprecated variables to replacement variables. Example:

    // dist/deprecations/colors.json
{
  "text.primary": "fg.default", // this means: `text.primary` is deprecated. Use `fg.default` instead
  "auto.blue.4": ["accent.fg, accent.emphasis"], // this means: `auto.blue.4` is deprecated. Use `accent.fg` or `accent.emphasis` instead
  "text.white": null // this means: `text.white` is deprecated. We don't have a replacement for it
}

    This data will allow consumers of @primer/primitives (e.g. Primer React and Primer ViewComponents) to write linters to prevent usage of deprecated variables.

4.5.4

Patch Changes

4.5.3

Patch Changes

4.5.2

Patch Changes

4.5.1

Patch Changes

  • #177 4d14328 Thanks @simurai! - Update diffBlob.selectedLineHighlightMixBlendMode in dark mode

4.5.0

Minor Changes

Patch Changes

4.4.4

Patch Changes

4.4.3

Patch Changes

4.4.2

Patch Changes

4.4.1

Patch Changes

4.4.0

Minor Changes

Patch Changes

  • #134 8b8cba7 Thanks @auareyou! - Remapping updates
    • Updated alerts to use roles instead of fg-default
    • Rename fg.inactive to fg.subtle
    • Deprecate avatar-border

4.3.11

Patch Changes

4.3.10

Patch Changes

4.3.9

Patch Changes

4.3.8

Patch Changes

4.3.7

Patch Changes

4.3.6

Patch Changes

4.3.5

Patch Changes

4.3.4

Patch Changes

4.3.3

Patch Changes

4.3.2

Patch Changes

4.3.1

Patch Changes

  • #85 d5b4305 Thanks @simurai! - Add experimental color variables to colors_v2 directory. Warning: Do not use these color variables

4.3.0

Minor Changes

Patch Changes

4.2.2

Patch Changes

4.2.1

Patch Changes

4.2.0

Minor Changes

Patch Changes

4.1.0

Minor Changes

4.0.2

Patch Changes

4.0.1

Major Changes

Patch Changes

3.0.1 (2020-04-28)

🚨 Breaking Changes

  • #14 Convert the package from JSON to TypeScript (@smockle)

2.0.0 (2019-10-21)

🚨 Breaking Changes

  • #14 Rename npm package to @primer/primitives and deprecate old primer-* packages (@BinaryMuse)

1.0.2 (2018-07-20)

🐛 Bug Fix

  • #6 Fix spacing to be an array instead of an object. (@broccolini)

📝 Documentation

1.0.1 (2018-05-10)

🐛 Bug Fix

🏠 Internal

1.0.0 (2018-04-29)

🚀 Enhancement

  • #1 Add color, typography, and spacing packages. (@broccolini)
  • #1 Add primer-primitives package that imports all primitives. (@broccolini)