@kolkrabbi/kol-theme 0.11.25 → 0.12.1

package/kol-base-tokens.css

@@ -48,10 +48,9 @@
 }
 
 /* Dark Mode — surface overrides */
+/* (no --kol-link override here: link color is a per-repo hook, user law
+   2026-07-29 — a consumer binding it owns both modes) */
 :is([data-theme="dark"], .dark) {
-  --kol-link:       #60A5FA;
-  --kol-link-hover: #93C5FD;
-
   --kol-surface-primary: #121215;
   --kol-surface-on-primary: #fafafa;
 
@@ -81,9 +80,6 @@
  * data-theme (any value) vetoes the OS. MIRROR of the block above — edit both. */
 @media (prefers-color-scheme: dark) {
   :root:not([data-theme]) {
-    --kol-link:       #60A5FA;
-    --kol-link-hover: #93C5FD;
-
     --kol-surface-primary: #121215;
     --kol-surface-on-primary: #fafafa;
 

package/kol-color.css

@@ -41,8 +41,14 @@
    * brand layer overrides the tokens, consumers override per element.
    * --------------------------------------------------------------------------- */
 
-  --kol-link:       #2563EB;
-  --kol-link-hover: #1D4ED8;
+  /* Link color is a PER-REPO decision (user law 2026-07-29): the DS ships the
+   * hook, not a color. currentColor = links render as surrounding ink until a
+   * consumer binds the token at its root, e.g.
+   *   :root { --kol-link: var(--kol-color-yellow-300); --kol-link-hover: … }
+   * (The old defaults were raw Tailwind blue-600/700 — placeholder, never
+   * brand-bound; killed the same day a consumer's DS-Table flush exposed it.) */
+  --kol-link:       currentColor;
+  --kol-link-hover: currentColor;
 
   /* ---------------------------------------------------------------------------
    * UI STATE — error / warning / info / success.
@@ -110,7 +116,9 @@
  * (0,1,1) beats any single utility class, and an unlayered theme import beats
  * whole `layer(...)` chrome sheets regardless of specificity. Chrome owns its
  * anchor colors; content links are `.kol-prose a` (inherit + underline).
- * Blue is a choice: add `.kol-link` at the call site.
+ * COLOR is a per-repo choice (user law 2026-07-29): `.kol-link` and
+ * `.kol-table a` are hooks on `--kol-link`, which defaults to currentColor —
+ * the DS ships NO link color. A repo binds the token at its root to opt in.
  * ============================================================================= */
 
 .kol-link { color: var(--kol-link); }

package/kol-components-molecules.css

@@ -427,6 +427,14 @@
   }
 }
 
+/* The elder hardcoded SpectrumGrid block (grid-template-columns: 100px
+   repeat(10,...), per-cell padding/hex chrome) lived in kol-framework.css and
+   was deleted 2026-07-30 (task 8) rather than moved: it predates the inline
+   var() contract above and would fight it by re-declaring the template the
+   component sets itself. The two custom-property overrides above are the
+   whole stylesheet contract. */
+
+
 /* SwatchControls chrome — the only bespoke CSS the component needs.
  *
  * The paint chips + sample chip reuse ColorSwatch's `halo` variant for the

package/kol-type-roles.css

@@ -138,6 +138,9 @@
   text-transform: uppercase;
   color: var(--kol-fg-meta);
   padding: 10px 16px;
+  /* Task 1: td sets this but th didn't, so a label centred itself against a
+     4-line value and the label↔value pairing broke. Both cell types agree. */
+  vertical-align: top;
 }
 .kol-prose td,
 .kol-doc-table td {
@@ -148,13 +151,43 @@
 }
 .kol-prose tbody tr:last-child td,
 .kol-doc-table tbody tr:last-child td { border-bottom: 0; }
+/* Cell roles — named by ROLE + TIER, split on the ONE mono fault line
+ * (kol-type-conform law): line-height-1 helper tier for single-line chrome,
+ * line-height-bearing mono tier for anything that can wrap. The old
+ * `kol-doc-table-value` was a slot name doing both jobs — a nowrap 12/16 role
+ * that every wrapping cell inherited, so a 4-line cell read as one block
+ * (tasks 2-4, 2026-07-30). */
+
+/* Single-line: one token — a hex, a class name, a count. Never wraps. */
+.kol-doc-table td.kol-doc-table-token {
+  font-family: var(--kol-font-family-mono);
+  font-size: 12px;
+  line-height: 1;
+  white-space: nowrap;
+}
+
+/* Multi-line: prose-ish cell content. Wraps, and carries real leading. */
+.kol-doc-table td.kol-doc-table-copy {
+  font-family: var(--kol-font-family-mono);
+  font-size: 12px;
+  line-height: 18px;
+  white-space: normal;
+}
+
+/* DEPRECATED (2026-07-30) — `-value` is a slot name, and `--wrap` flipped
+ * wrapping while leaving single-line leading in place, which was the actual
+ * defect. Aliased so existing consumers keep rendering; use the two roles
+ * above. Remove once no consumer references them. */
 .kol-doc-table td.kol-doc-table-value {
   font-family: var(--kol-font-family-mono);
   font-size: 12px;
-  line-height: 16px;
+  line-height: 1;
   white-space: nowrap;
 }
-.kol-doc-table td.kol-doc-table-value--wrap { white-space: normal; }
+.kol-doc-table td.kol-doc-table-value--wrap {
+  white-space: normal;
+  line-height: 18px;
+}
 
 /* figure — the framed content container (preview cards, embedded media). */
 .kol-prose figure,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kolkrabbi/kol-theme",
-  "version": "0.11.25",
+  "version": "0.12.1",
   "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",