@justai/cuts 0.130.1 → 0.131.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@justai/cuts",
-  "version": "0.130.1",
-  "description": "A persona's named parts \u2014 the page shell that holds them, and the cuts themselves.",
+  "version": "0.131.0",
+  "description": "A persona's named parts — the page shell that holds them, and the cuts themselves.",
   "license": "UNLICENSED",
   "repository": {
     "type": "git",
@@ -42,7 +42,7 @@
   },
   "dependencies": {
     "@justai/core": "^0.34.0",
-    "@justai/ui": "^0.21.1",
+    "@justai/ui": "^0.22.0",
     "@justai/atrium": "^0.1.9"
   }
-}
+}

package/src/ground.css

@@ -79,8 +79,31 @@
      second storefront is the first one. */
   --card-bg: rgba(28, 28, 34, 0.55);
   --card-blur: blur(30px) saturate(1.6);
-  --card-shadow: 0 1px 2px rgba(0, 0, 0, 0.32);
   --card-shadow-hover: 0 2px 6px rgba(0, 0, 0, 0.4), 0 12px 28px -14px rgba(0, 0, 0, 0.55);
+
+  /* ── ELEVATION — mirrors @justai/ui tokens.css, and the tokens spec holds the two identical ──
+   *
+   * queries: box shadow token · which shadow · the panel looks detached · drop shadow standard ·
+   *          golge standardi · card shadow vs sheet shadow
+   *
+   * THE VALUES WERE ALREADY HERE, under one name and one meaning: `--card-shadow`, described as
+   * "a storefront tile's own surface". Measured across the live fleet on 2026-08-20 they turned out
+   * to be the shadow of EVERY resting surface — app.zone's catalogue cards, qr's type buttons,
+   * calculator's panel, all byte-identical — so the name was narrower than the fact, and a persona
+   * building its own kernel panel had nothing to reach for and invented one. The one that produced
+   * the ruling had invented a MODAL's: twice the opacity, 3.7× the blur, and in dark deeper than
+   * the fleet's actual modal.
+   *
+   * So the scale is named by ELEVATION — how far off the page a thing is — and the catalogue's own
+   * token now reads from it rather than restating it. `--card-shadow` stays because live personas
+   * consume it; it is an alias now, not a second definition.
+   *
+   * The law: **nothing that is not a sheet may exceed `--shadow-card`, and no shadow is coloured.**
+   * A tinted shadow is a glow, a glow is a light source, and this ground has one sun and no lamps. */
+  --shadow-card: 0 1px 2px 0 rgba(0, 0, 0, 0.32);
+  --shadow-bar: 0 2px 12px -2px rgba(0, 0, 0, 0.55);
+  --shadow-sheet: 0 18px 40px -20px rgba(0, 0, 0, 0.45);
+  --card-shadow: var(--shadow-card);
 }
 
 /* queries: force dark while playing · theme switch · data-theme dark · stage theme
@@ -103,8 +126,14 @@
        panel over a pale page reads as a smudge, so app.zone drops it and pays the shadow instead. */
     --card-bg: #fff;
     --card-blur: none;
-    --card-shadow: 0 1px 2px rgba(16, 24, 40, 0.05), 0 4px 12px -4px rgba(16, 24, 40, 0.1);
     --card-shadow-hover: 0 2px 4px rgba(16, 24, 40, 0.06), 0 12px 26px -8px rgba(16, 24, 40, 0.15);
+
+    /* Light needs TWO layers where dark needs one: on a near-white ground a single ambient blur
+       reads as dirt, so the pair is a 1px contact line that seats the object plus a wide, faint
+       ambient. `--card-shadow` inherits its alias from the block above and needs no line here. */
+    --shadow-card: 0 1px 2px 0 rgba(16, 24, 40, 0.05), 0 4px 12px -4px rgba(16, 24, 40, 0.1);
+    --shadow-bar: 0 1px 2px rgba(16, 24, 40, 0.06), 0 8px 20px -8px rgba(16, 24, 40, 0.16);
+    --shadow-sheet: 0 18px 40px -20px rgba(0, 0, 0, 0.45);
   }
 }