@kolkrabbi/kol-theme 0.191.0 → 0.193.0

package/README.md

@@ -36,6 +36,8 @@ Tailwind v4 **does not scan `node_modules`**, so layout utilities emitted inside
 
 (Adjust the relative path to your CSS file's location. Component-load-bearing *chrome* lives in this package's CSS and needs no `@source` — the contract covers the remaining per-render utilities.)
 
+**Not `kol-sources.css`.** The manifest resolves its paths from the theme's own folder and reaches nothing in a pnpm workspace — no warning, no utilities. It works only in a standalone repo; the explicit lines above work everywhere.
+
 ## Fonts
 
 The typography CSS references the brand fonts at absolute paths (`/fonts/right-grotesk/…`, `/fonts/jetbrains-mono/…`). **The package does not ship the font files** — your app must serve them from `/fonts/` (e.g. drop them in your `public/` dir). The showcase in this repo does exactly that. Without them, type falls back to system fonts.

package/kol-sources.css

@@ -1,6 +1,17 @@
 /**
  * kol-sources.css — the @source manifest for every raw-JSX @kolkrabbi package.
  *
+ * ⚠ STANDALONE REPOS ONLY — IT REACHES NOTHING IN A PNPM WORKSPACE (KolSourcesManifestDeadInWorkspace,
+ * kol-website 2026-10-28). Its paths resolve from this file's own folder. In a workspace the theme sits
+ * alone in node_modules/.pnpm/@kolkrabbi+kol-theme@x/node_modules/@kolkrabbi/kol-theme and the workspace
+ * root has no node_modules/@kolkrabbi, so both lines of every pair miss and Tailwind scans no package —
+ * silently (record.kolkrabbi.io: 56 of kol-framework's 90 rail utilities). The way to wire an app is the
+ * explicit lines in the app's own CSS, one per installed package, which resolve in every layout:
+ *
+ *   @source "../node_modules/@kolkrabbi/kol-component/src";
+ *
+ * Keep this file only in a standalone (non-workspace) repo, beside those lines or not at all.
+ *
  * KOL packages publish raw .jsx, and Tailwind v4 skips node_modules during
  * auto-detection — so utilities used INSIDE package components are never
  * generated unless the consumer declares each package as a source. Forgetting

package/kol-typography.css

@@ -1129,10 +1129,15 @@
 .kol-sheet {
   --bg: var(--kol-surface-primary); --surface: var(--kol-surface-primary); --ink: var(--kol-surface-on-primary);
   --muted: var(--kol-fg-64); --line: var(--kol-fg-12); --soft: var(--kol-fg-04);
-  --accent: var(--kol-accent-primary); --note: var(--ui-error);
+  /* the accent is kol-atlas's own (apps/workspace/src/index.css, 2026-10-28): orange-300, yellow-300 in the dark — the ramps
+     in kol-framework's kol-brand-color.css, which every sheet consumer loads (ARCHITECTURE §5's cascade); not the DS accent,
+     which is the ink and left every number and quote mark unmarked */
+  --accent: var(--kol-color-orange-300); --note: var(--ui-error);
   --edge: 724px;
   --display: var(--kol-font-family-sans); --body: var(--kol-font-family-sans); --mono: var(--kol-font-family-mono);
 }
+@media (prefers-color-scheme: dark) { :root:not([data-theme="light"]) .kol-sheet { --accent: var(--kol-color-yellow-300); } }
+:root[data-theme="dark"] .kol-sheet { --accent: var(--kol-color-yellow-300); }
 .kol-sheet{padding:16px 0 28px;min-width:0;color:var(--ink);font-family:var(--body);font-size:15px;line-height:1.6}
 .kol-sheet h1,.kol-sheet h2,.kol-sheet h3,.kol-sheet h4{font-family:var(--display);line-height:1.2;text-wrap:balance;letter-spacing:-.005em;font-weight:700}
 .kol-sheet h1{font-size:36px;margin:0 0 12px}
@@ -1171,8 +1176,11 @@
 .kol-sheet .term.missing{border:0;color:var(--note);background:var(--soft);padding:0 4px;border-radius:3px}
 .kol-sheet .media{display:grid;grid-template-columns:repeat(auto-fill,minmax(220px,1fr));gap:16px;margin:16px 0}
 .kol-sheet .media figure{margin:0}
-.kol-sheet .media img,.kol-sheet .media video{display:block;width:100%;aspect-ratio:4/3;object-fit:contain;background:var(--soft);border:1px solid var(--line);border-radius:4px}
-.kol-sheet .media .doc{display:flex;align-items:center;justify-content:center;aspect-ratio:4/3;background:var(--soft);border:1px solid var(--line);border-radius:4px;font-family:var(--mono);font-size:12px;text-decoration:none}
+/* a figure fills its frame (user 2026-10-28: "should SHIP scale to fill, no margins, empty space"); `data-fit="contain"` on the grid
+   shows the whole image on the plate instead, `--media-ratio` sets the frame (4/3 by default) — both are the page's props */
+.kol-sheet .media img,.kol-sheet .media video{display:block;width:100%;aspect-ratio:var(--media-ratio,4/3);object-fit:cover;background:var(--soft);border:1px solid var(--line);border-radius:4px}
+.kol-sheet .media[data-fit="contain"] img,.kol-sheet .media[data-fit="contain"] video{object-fit:contain}
+.kol-sheet .media .doc{display:flex;align-items:center;justify-content:center;aspect-ratio:var(--media-ratio,4/3);background:var(--soft);border:1px solid var(--line);border-radius:4px;font-family:var(--mono);font-size:12px;text-decoration:none}
 .kol-sheet .media figcaption{margin-top:6px;font-size:12.5px;color:var(--muted);overflow-wrap:anywhere}
 .kol-sheet .why{font-family:var(--body);font-size:12px;font-weight:400;color:var(--muted);margin-left:6px}
 .kol-sheet p.when,.kol-sheet p.dw{font-size:13px;color:var(--muted);margin:0}
@@ -1187,6 +1195,10 @@
 .kol-sheet ol.fns li{margin:2px 0}
 .kol-sheet ol.fns .fnn{margin-right:.4em}
 .kol-sheet ol.fns .url{color:color-mix(in srgb,var(--ink) 36%,transparent);overflow-wrap:anywhere}
+/* a link in the note list is a plain source: the list's ink, no underline; the Sources list stands a step larger (kol-atlas
+   workspace.css, carried 2026-10-28 for apps/document — the port had missed these two) */
+.kol-sheet ol.fns a{color:inherit;text-decoration:none}
+.kol-sheet ol.fns.src{font-size:12px;margin-top:8px}
 .kol-sheet .ol .ms{margin-top:20px}
 .kol-sheet .ol .ms>summary.mh{display:flex;align-items:baseline;gap:10px;flex-wrap:wrap;font-family:var(--display);font-weight:700;font-size:20px;padding:2px 8px;line-height:1.3}
 .kol-sheet .ol .mh a{color:var(--ink);text-decoration:none}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kolkrabbi/kol-theme",
-  "version": "0.191.0",
+  "version": "0.193.0",
   "description": "Tokens and base CSS",
   "license": "MIT",
   "type": "module",