@olwiba/cn 0.1.31 → 0.1.32

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/package.json +1 -1
  2. package/src/styles/preset.css +21 -4
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@olwiba/cn",
3
- "version": "0.1.31",
3
+ "version": "0.1.32",
4
4
  "private": false,
5
5
  "type": "module",
6
6
  "sideEffects": false,
package/src/styles/preset.css CHANGED
@@ -47,9 +47,12 @@
47
47
  * background, so the largest surfaces get a fraction of it and the smallest
48
48
  * get all of it.
49
49
  *
50
- * Both default to 0, and `oklch(L 0 H)` is achromatic whatever the hue, so
51
- * a consumer that sets neither renders exactly the colours it did before.
52
- * The declarations change; the computed values do not.
50
+ * Both tint knobs default to 0, and `oklch(L 0 H)` is achromatic whatever
51
+ * the hue, so a consumer that sets neither gets no colour at all.
52
+ *
53
+ * `--neutral-lift` below is the exception: it has a non-zero default,
54
+ * because pure white is worth refusing by default rather than opting out
55
+ * of. That is the only value a consumer inherits without asking.
53
56
  */
54
57
  --neutral-tint-hue: 0;
55
58
  --neutral-tint-chroma: 0;
@@ -71,8 +74,22 @@
71
74
  *
72
75
  * Foregrounds are untouched, and the largest move here is 1 → 0.985, so
73
76
  * contrast is effectively unchanged.
77
+ *
78
+ * The default is not 0. Pure white is the one value worth refusing outright:
79
+ * it emits more light than any other surface on the screen, which is why
80
+ * long reading sessions tire eyes faster on #ffffff than on an off-white,
81
+ * and it flattens a page into something sterile. The convention in
82
+ * editorial and product design is to sit just off it.
83
+ *
84
+ * 0.003 puts the page at #fefefe — one step per channel, deliberately
85
+ * conservative. It removes the extreme without restyling any consumer's
86
+ * product, and it is the floor rather than the recommendation: 0.015
87
+ * (#fafafa) is where the glare actually goes, and is what nestrrr uses.
88
+ *
89
+ * `--neutral-lift: 0` still gets pure white back for anything that wants
90
+ * it — a print stylesheet, a canvas, a screenshot surface.
74
91
  */
75
- --neutral-lift: 0;
92
+ --neutral-lift: 0.003;
76
93
 
77
94
  /* Per-surface share of --neutral-tint-chroma. */
78
95
  --neutral-tint-page: calc(var(--neutral-tint-chroma) * 0.33);