Updating deprecations.js file to be more straightforward

[jonrohan]

This updates the deprecations.js file and process a bit simpler. I modeled this after the work @colebemis did in primer/primitives#202

The placement of the deprecated file hasn't changed but the structure has. The output dist/deprecations.json file is as follows: And documented here https://primer-css-82rx1coiw-primer.vercel.app/css/tools/deprecations

{
  "selectors": {...},
  "variables": {...},
  "mixins": {...}
}

Deprecated Selectors

These are deprecated selectors and should not be used. They include a replacement value, which can be an array or null.

• 'deprecated-selector': 'replacement-selector' <-- Replace with this selector.
• 'deprecated-selector': ['replacement-1', 'replacement-2'] <-- Replace with one of these selectors.
• 'deprecated-selector': null <-- No option available, remove selector.

[changeset-bot]

🦋 Changeset detected

Latest commit: de3f8b2

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package

Name	Type
@primer/css	Minor

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[simurai]

I think I like this. ❤️

I'm still wondering if there is benefit for keeping the version, but can't really think of any. I guess once something is deprecated it will stay that way "forever" unless we wanna re-use it at some point again.

[jonrohan]

I'm still wondering if there is benefit for keeping the version, but can't really think of any. I guess once something is deprecated it will stay that way "forever" unless we wanna re-use it at some point again.

After looking at the code, I think the original intent was you could mark something to be deprecated such that you want it deprecated at a specific later version but not right now. I don't believe we ever really utilized this though.

[colebemis]

Love this direction!

Is there a reason we couldn't make this a JSON file? With JSON, we could use JSON schema to validate the structure.