@carbon/layout 11.60.0 → 11.61.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 (2) hide show
  1. package/README.md +23 -0
  2. package/package.json +4 -4
package/README.md CHANGED
@@ -41,6 +41,29 @@ check out the [`@carbon/grid`](../grid) package.
41
41
  you're looking for support in a different language, feel free to file an issue
42
42
  proposing the new addition!
43
43
 
44
+ ### Modifying token values
45
+
46
+ Token values are defined in [`src/dtcg/layout.json`](./src/dtcg/layout.json)
47
+ using the [DTCG token format](https://tr.designtokens.org/format/). This is the
48
+ single source of truth for the package — **do not edit generated files
49
+ directly**.
50
+
51
+ The following files are generated at build time and should not be hand-edited:
52
+
53
+ - `js/generated/layout-tokens.js` / `js/generated/layout-tokens.d.ts` — JS
54
+ exports
55
+ - `scss/generated/` — Sass variables and maps, one file per token group
56
+
57
+ To add or update a token:
58
+
59
+ 1. Edit `src/dtcg/layout.json`
60
+ 2. Run `yarn build` in this package to regenerate all outputs
61
+ 3. Run `yarn test --testPathPatterns=packages/layout` from the repo root to
62
+ confirm nothing regressed
63
+
64
+ For a detailed guide to the token format, converters, and how to add a new token
65
+ category, see [`src/dtcg/README.md`](./src/dtcg/README.md).
66
+
44
67
  ## 🙌 Contributing
45
68
 
46
69
  We're always looking for contributors to help us fix bugs, build new features,
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@carbon/layout",
3
3
  "description": "Layout helpers for digital and software products using the Carbon Design System",
4
- "version": "11.60.0",
4
+ "version": "11.61.0",
5
5
  "license": "Apache-2.0",
6
6
  "sideEffects": [
7
7
  "index.scss",
@@ -38,10 +38,10 @@
38
38
  "postinstall": "ibmtelemetry --config=telemetry.yml"
39
39
  },
40
40
  "devDependencies": {
41
- "@carbon/cli": "^11.51.0",
41
+ "@carbon/cli": "^11.52.0",
42
42
  "@carbon/cli-reporter": "^10.9.0",
43
43
  "@carbon/scss-generator": "^10.20.0",
44
- "@carbon/test-utils": "^10.41.0",
44
+ "@carbon/test-utils": "^10.42.0",
45
45
  "core-js": "^3.16.0",
46
46
  "rimraf": "^6.0.1",
47
47
  "style-dictionary": "^5.5.0",
@@ -51,5 +51,5 @@
51
51
  "dependencies": {
52
52
  "@ibm/telemetry-js": "^1.5.0"
53
53
  },
54
- "gitHead": "7e1d5e5492fd70ab8ec901114898c12a374cea98"
54
+ "gitHead": "44f90d8d6b24889af06cee1422ceb37f58e40bed"
55
55
  }