@adobe/spectrum-tokens 13.16.0 → 14.1.0

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 (32) hide show
  1. package/CHANGELOG.md +12865 -0
  2. package/README.md +21 -8
  3. package/dist/json/variables.json +234 -234
  4. package/package.json +4 -4
  5. package/schemas/token-types/alias.json +3 -3
  6. package/schemas/token-types/color-set.json +12 -12
  7. package/schemas/token-types/color.json +3 -3
  8. package/schemas/token-types/dimension.json +3 -3
  9. package/schemas/token-types/drop-shadow.json +3 -3
  10. package/schemas/token-types/font-family.json +3 -3
  11. package/schemas/token-types/font-size.json +3 -3
  12. package/schemas/token-types/font-style.json +3 -3
  13. package/schemas/token-types/font-weight.json +3 -3
  14. package/schemas/token-types/gradient-stop.json +3 -3
  15. package/schemas/token-types/multiplier.json +3 -3
  16. package/schemas/token-types/opacity.json +3 -3
  17. package/schemas/token-types/scale-set.json +11 -11
  18. package/schemas/token-types/set.json +1 -1
  19. package/schemas/token-types/system-set.json +13 -13
  20. package/schemas/token-types/text-align.json +3 -3
  21. package/schemas/token-types/text-transform.json +3 -3
  22. package/schemas/token-types/token.json +5 -1
  23. package/schemas/token-types/typography.json +23 -8
  24. package/src/color-aliases.json +465 -464
  25. package/src/color-component.json +109 -106
  26. package/src/color-palette.json +1275 -1275
  27. package/src/icons.json +247 -247
  28. package/src/layout-component.json +2253 -2195
  29. package/src/layout.json +543 -538
  30. package/src/semantic-color-palette.json +109 -109
  31. package/src/typography.json +385 -385
  32. package/test/schemaValidators/alias.test.js +1 -1
package/README.md CHANGED
@@ -22,9 +22,9 @@ This project uses [Semantic Versioning (semver)](https://semver.org/). It also u
22
22
 
23
23
  x.x.n+1 releases are for bug fixes and patches.
24
24
 
25
- - bug fixes
26
- - typos
27
- - mistakes
25
+ * bug fixes
26
+ * typos
27
+ * mistakes
28
28
 
29
29
  Example: a token name changing from `detail-margin-top-mulitplier` to `detail-margin-top-multiplier` to fix a spelling mistake.
30
30
 
@@ -32,16 +32,16 @@ Example: a token name changing from `detail-margin-top-mulitplier` to `detail-ma
32
32
 
33
33
  x.n+1.0 releases are for new tokens and features.
34
34
 
35
- - adding new token
36
- - changing a value intentionally
37
- - adding deprecation metadata and aliased new tokens where applicable
35
+ * adding new token
36
+ * changing a value intentionally
37
+ * adding deprecation metadata and aliased new tokens where applicable
38
38
 
39
39
  #### Major
40
40
 
41
41
  n+1.0.0 releases are for breaking changes.
42
42
 
43
- - deleting tokens
44
- - changing token value type (e.g., from a color to a dimension; anything that would break a parser expecting specific data types)
43
+ * deleting tokens
44
+ * changing token value type (e.g., from a color to a dimension; anything that would break a parser expecting specific data types)
45
45
 
46
46
  ## Deprecations
47
47
 
@@ -49,6 +49,19 @@ n+1.0.0 releases are for breaking changes.
49
49
 
50
50
  Tokens with a name changed will first be marked as deprecated, while a new token will be created with the new name; the deprecated token will then become an alias for the new token. Finally, the deprecated token will eventually be removed, most likely in the next major release if there has been sufficient time to notify teams. The required amount of time is still to be determined.
51
51
 
52
+ ### Token properties for deprecation tracking
53
+
54
+ * `deprecated` (boolean): Marks a token as deprecated
55
+ * `deprecated_comment` (string): Provides context about why the token is deprecated and migration guidance
56
+ * `renamed` (string): For 1:1 token replacements, specifies the new token name that should be used instead
57
+
58
+ When a token is renamed:
59
+
60
+ 1. Set `deprecated: true` on the old token
61
+ 2. Add `renamed: "new-token-name"` to specify the replacement
62
+ 3. Update `deprecated_comment` to provide additional context if needed
63
+ 4. The old token's `value` should typically alias to the new token
64
+
52
65
  ## Releases
53
66
 
54
67
  All commits merged or pushed to the `main` branch will be released as a stable version with the `latest` tag on [NPM](https://www.npmjs.com/package/@adobe/spectrum-tokens?activeTab=versions). All commits merged or pushed to `next`, or `next-major` will update the version number according to the types of commits made in the branch (breaking change, feature, bug fix) and release it to NPM with the `next` tag.