@kolkrabbi/kol-theme 0.122.0 → 0.124.0

package/kol-components-controls.css

@@ -0,0 +1,36 @@
+/* ---------------------------------------------------------------------------
+ * KOL CONTROLS — the token layer for @kolkrabbi/kol-controls (KolControlsPackage,
+ * kol-monitor 2026-09-01). Hardware panel controls for instruments: the values
+ * are kol-monitor's `monitor-overrides.css`, renamed `--monitor-*` → `--kol-ctl-*`
+ * on the way in — the values are the ruling, the prefix is the package's.
+ *
+ * HARDWARE IS THEME-INVARIANT: a knob cap is black on a white panel too, so the
+ * caps derive from `--kol-color-ab-black` / `-white` — the `oq-ab` / `fg-ab`
+ * tiers flip with `[data-theme]` and could not carry them.
+ *
+ * LEDs are the set's own emitters, deliberately NOT `--kol-palette-*` (user
+ * ruling: "leds and the colors should stay, they are unique to this set").
+ *
+ * `JackSocket` appends a hex alpha to its role colour for the glow, so the two
+ * jack roles must resolve to HEX on :root — a consumer overriding them binds a
+ * hex, never a var().
+ * --------------------------------------------------------------------------- */
+:root {
+  /* hardware */
+  --kol-ctl-hw-cap:      color-mix(in srgb, var(--kol-color-ab-black) 90%, transparent);
+  --kol-ctl-hw-well:     color-mix(in srgb, var(--kol-color-ab-black) 95%, transparent);
+  --kol-ctl-hw-shade:    color-mix(in srgb, var(--kol-color-ab-black) 40%, transparent);
+  --kol-ctl-hw-cap-edge: color-mix(in srgb, var(--kol-color-ab-white) 16%, transparent);
+  --kol-ctl-hw-on-cap:   color-mix(in srgb, var(--kol-color-ab-white) 72%, transparent);
+  --kol-ctl-hw-rail:     linear-gradient(180deg, #8a8680 0%, #7a7670 50%, #6a6660 100%);
+  --kol-ctl-hw-case:     #141414;
+  --kol-ctl-cable:       #f59e0b;
+  /* LEDs */
+  --kol-ctl-led-red:    #e74c3c;
+  --kol-ctl-led-green:  #2ecc71;
+  --kol-ctl-led-yellow: #f1c40f;
+  --kol-ctl-led-blue:   #3b82f6;
+  /* jack roles — HEX, see above */
+  --kol-ctl-signal-input: #4ade80;
+  --kol-ctl-cv-attenuate: #497DA2;
+}

package/kol-components-shell.css

@@ -134,3 +134,46 @@
   z-index: calc(var(--kol-z-sticky) - 1);
   background: color-mix(in srgb, var(--kol-color-ab-black) 48%, transparent);
 }
+
+/* ── THE TAP OPENER (ShellRailCollapsedWithTapOpen, kol-mirror 2026-09-01) ──
+ * `touch="shell"` keeps the collapsed 48px rail visible — the user's ruling
+ * for a home that is navigation — but its only opener was the grab strip: 8px
+ * on the line, a pill that wakes on pointer PROXIMITY. A thumb never hovers,
+ * so on a phone the rail could not be opened. The strip is a <button> now
+ * (kol-shell 0.38.0) carrying `.kol-rail-grab-tap`, a 24px disc on the line
+ * that exists ONLY under a coarse pointer: fine pointers keep the ruled grab
+ * (RailFlatGrabOpen, OneGrabGestureBothRails) and never see this. The strip
+ * already toggles on a press with no travel; this gives that press a target.
+ * Geometry lives here, the pill's motion stays in kol-animation.css. */
+.kol-rail-grab {
+  appearance: none;
+  background: transparent;
+  border: 0;
+  padding: 0;
+  color: inherit;
+}
+.kol-rail-grab-tap { display: none; }
+@media (pointer: coarse) {
+  .kol-rail-grab {
+    width: 24px;
+    right: -12px;
+    cursor: pointer;
+  }
+  /* no proximity on touch — the pill would never wake; the disc is the affordance */
+  .kol-rail-grab::before { display: none; }
+  .kol-rail-grab-tap {
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    position: absolute;
+    left: 50%;
+    top: 50%;
+    translate: -50% -50%;
+    width: 24px;
+    height: 24px;
+    border-radius: var(--kol-radius-full);
+    background: var(--kol-surface-secondary);
+    border: 1px solid var(--kol-fg-16);
+    color: var(--kol-oq-96);
+  }
+}

package/kol-theme.css

@@ -48,6 +48,7 @@
 @import "./kol-components-foundry.css" layer(components);
 @import "./kol-components-styleguide.css" layer(components);
 @import "./kol-components-shell.css" layer(components);
+@import "./kol-components-controls.css" layer(components);
 
 /* Theme-level design tokens — LAST, as they always were (lifted into their own
  * file 2026-08-27 so kol-core.css shares them; emitted CSS unchanged). */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kolkrabbi/kol-theme",
-  "version": "0.122.0",
+  "version": "0.124.0",
   "description": "KOL (Kolkrabbi) design-system tokens + base CSS — brand-neutral. The canonical token/cascade layer every other KOL package and consumer builds on.",
   "license": "MIT",
   "type": "module",