jig-ui 0.26.0 → 0.26.1

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.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "jig-ui",
3
- "version": "0.26.0",
3
+ "version": "0.26.1",
4
4
  "description": "A design system for coding agents. 160 numbered UI rules, brand x mode design tokens, and an installer for Claude Code, Codex, Cursor and opencode.",
5
5
  "license": "Apache-2.0",
6
6
  "type": "module",
@@ -78,12 +78,13 @@ came from, and the surfaces it used — the output says whether they came from
78
78
  `jig.config.json` or from the default.
79
79
 
80
80
  If the token layer does not exist yet, this is the command that creates it. **Do
81
- not author token values yourself.** `init` derives the brand colour, checks it
81
+ not write the token files by hand.** `init` derives the brand colour, checks it
82
82
  against the contrast floor in both light and dark, and records a checksum for
83
83
  each file it writes; a file you write by hand is untracked, so `jig update` can
84
- never refresh it again. `jig check` now reads the token layer back and holds it
85
- to those floors either way, so a hand-written value will be caught — but caught
86
- late, and unmaintainable, is worse than derived.
84
+ never refresh it again. The brand file it writes is the project's own, though:
85
+ once `DECISIONS.md` records a colour, a typeface or corners, change those values
86
+ in it to match (see `decide`). `jig check` reads the token layer back and holds it
87
+ to those floors, so a value that fails one is caught however it got there.
87
88
 
88
89
  ## check
89
90
 
@@ -1973,6 +1974,18 @@ the user as left out on purpose, with the reason. Then go the other way: every
1973
1974
  and ask. A `Why (inferred):` traces to what it was inferred from; say what that was.
1974
1975
  Include this mapping in your message, below the file.
1975
1976
 
1977
+ **Then put the answers into the brand file.** The type, the colour and the
1978
+ corners each name the token they become, and the brand file `init` wrote is the
1979
+ project's own: `jig update` refreshes the mode files and never touches it. Change
1980
+ its values to match what the user decided: the brand hue, saturation and lightness
1981
+ for the colour, `--font-text` and `--font-display` for the type (and load the face
1982
+ wherever the pages load their styles, if it is a web font), and the `--radius-*`
1983
+ scale for the corners. A value the user did not decide stays as `init` wrote it.
1984
+ Then run `{{scripts_path}} check`: it holds the brand file to the contrast floors
1985
+ in light and dark, and says if a decided colour or typeface never reached it. Of
1986
+ six runs whose owner named a colour and a typeface, four recorded both in this file
1987
+ and built every page in Jig's unbranded default, because no step said to apply them.
1988
+
1976
1989
  Show it and ask the user to confirm it is right before you stop. Leave no
1977
1990
  `[TODO]` markers — the gate treats them as an unwritten file, correctly, because
1978
1991
  a placeholder decision is not a decision.