@kolkrabbi/kol-theme 0.7.5 → 0.8.0

package/kol-color.css

@@ -80,6 +80,14 @@
 
 /* =============================================================================
  * SYSTEM PREFERENCE (Automatic Dark Mode)
+ *
+ * KEPT deliberately (ruling applied 2026-07-15, ledger-2.0 #2.4): KOL policy
+ * is light-first + FOLLOW-SYSTEM — an undecided page respects the visitor's
+ * OS preference; an explicit choice (app-set data-theme or a saved toggle)
+ * always wins because [data-theme="light"] opts out of this block and
+ * [data-theme="dark"] doesn't need it. A repo wanting hard light-always
+ * stamps data-theme="light" at boot — that's the per-repo seam, not a theme
+ * edit. ThemeToggle + useTheme implement the same policy JS-side.
  * ============================================================================= */
 
 @media (prefers-color-scheme: dark) {

package/kol-components-atoms.css

@@ -225,6 +225,14 @@
   outline-offset: 2px;
 }
 
+/* Icon-only buttons — was an inline style in Button.jsx, which beat every
+ * consumer display utility (`lg:hidden` could never hide an iconOnly button).
+ * Chrome belongs here, layered, so utilities stay sovereign. The flex
+ * centering comes from .kol-btn; the icon-only extra is only line-height. */
+.kol-btn-icon {
+  line-height: 0;
+}
+
 .kol-btn-primary {
   background: var(--kol-surface-secondary);
   color: var(--kol-surface-on-primary);

package/kol-components-molecules.css

@@ -14,6 +14,14 @@
  * ─────────────────────────────────────────────────────────────────────
  */
 
+/* Every floating node (PopoverPanel root, with or without panel chrome).
+ * Floats must top overlay chrome (.kol-overlay is z-100) — without this a
+ * dropdown/menu/tooltip opened INSIDE a FullscreenOverlay stacks under the
+ * sheet and its options intercept nothing. */
+.kol-popover-float {
+  z-index: 110;
+}
+
 /* Popover — default chrome for floating-ui-positioned panels.
  * Used by molecules/Popover.jsx PopoverPanel. */
 .kol-popover {
@@ -198,6 +206,27 @@
   margin: 0 12px;
 }
 
+/* The option list — chrome, not consumer utilities (brief-2.0 defect 2: a
+ * consumer without @source got an uncapped, unscrollable panel). */
+.kol-dd-list {
+  display: flex;
+  flex-direction: column;
+  align-items: stretch;
+  max-height: 300px;
+  overflow-y: auto;
+}
+
+/* The trigger chevron — pushed to the trailing edge, flips on open state.
+ * Replaces the ml-auto utility + inline rotate style in Dropdown.jsx. */
+.kol-dd-caret {
+  margin-left: auto;
+  transition: transform 300ms;
+}
+
+.kol-dd-trigger[data-state="open"] .kol-dd-caret {
+  transform: rotate(180deg);
+}
+
 .tag-control:hover {
   background-color: var(--kol-oq-12);
   color: var(--kol-surface-on-primary);

package/kol-components-workshop.css

@@ -88,6 +88,10 @@
 
 /* Sidebar toggle buttons (collapsible section headers) — layout only.
  * Type/color carried in JSX (kol-helper-10 text-meta). */
+/* Vertical rhythm matches .shell-nav-group-header (6px rows) — ledger-2.0
+ * #2.6 ruling (final, user-reviewed 2026-07-15): the rail keeps its quieter
+ * 10px label scale (deliberate hierarchy vs the nav's 14px), row rhythm is
+ * shared. */
 .shell-sidebar-toggle {
   display: flex;
   align-items: center;
@@ -96,7 +100,7 @@
   width: 100%;
   border: none;
   background: transparent;
-  padding: 0;
+  padding: 6px 0;
   transition: color 0.15s ease;
 }
 

package/kol-sources.css

@@ -0,0 +1,31 @@
+/**
+ * kol-sources.css — the @source manifest for every raw-JSX @kolkrabbi package.
+ *
+ * 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
+ * one is silent breakage (unstyled chrome). This manifest carries the line for
+ * every raw-JSX package; the consumer imports it ONCE:
+ *
+ *   @import "tailwindcss";
+ *   @import "@kolkrabbi/kol-theme";
+ *   @import "@kolkrabbi/kol-theme/kol-sources.css";
+ *
+ * `@source` resolves relative to THIS file (node_modules/@kolkrabbi/kol-theme/),
+ * so sibling package paths work from inside node_modules. A path that doesn't
+ * exist (package not installed) matches nothing — installing a subset is fine.
+ * New raw-JSX packages get their line added here, DS-side, so consumers never
+ * chase the footgun again.
+ */
+
+@source "../kol-brand/src";
+@source "../kol-chess/src";
+@source "../kol-component/src";
+@source "../kol-content/src";
+@source "../kol-dashboards/src";
+@source "../kol-foundry/src";
+@source "../kol-framework/src";
+@source "../kol-icons/src";
+@source "../kol-store/src";
+@source "../kol-styleguide/src";
+@source "../kol-workshop/src";

package/package.json

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