@kolkrabbi/kol-framework 0.3.4 → 0.4.0

package/kol-framework.css

@@ -233,28 +233,7 @@ code, pre {
   .kol-asset-grid-4col { grid-template-columns: 1fr; }
 }
 
-/* ───── Mood tile (image + overlay logomark) ─────
-   Wrappers inlined in MoodTile.jsx. CSS retains descendant img positioning
-   (cover-crop the photo) + overlay logo sizing. */
-
-.kol-mood-tile-frame img {
-  position: absolute;
-  inset: 0;
-  width: 100%;
-  height: 100%;
-  object-fit: cover;
-}
-
-.kol-mood-tile-overlay .kol-brand-logo {
-  width: 32%;
-  max-width: 180px;
-  display: inline-flex;
-}
-
-.kol-mood-tile-overlay svg {
-  width: 100%;
-  height: auto;
-}
+/* .kol-mood-tile-* relocated to kol-theme/kol-components-styleguide.css 2026-07-10 */
 
 /* ───── Swatch / Ramp (color specimens) ───── */
 
@@ -684,324 +663,7 @@ code, pre {
 /* ───── Foundations · typography specimens ─────
    Wrappers fully inlined in TypographySections.jsx. */
 
-/* ───── Combo Lab layout primitives — shared structure classes ───── */
-
-.kol-combo-frame {
-  border-radius: 4px;
-  overflow: hidden;
-  transition: background-color 400ms ease, border-color 400ms ease;
-}
-
-.kol-combo-slab {
-  padding: 16px;
-  display: flex;
-  flex-direction: column;
-  justify-content: space-between;
-  min-height: 0;
-  transition: background-color 400ms ease, color 400ms ease;
-}
-
-.kol-combo-slab--end     { justify-content: flex-end; }
-.kol-combo-slab--between { justify-content: space-between; }
-
-.kol-combo-label {
-  font-family: 'Right Grotesk Compact', sans-serif;
-  font-size: 12px;
-  font-weight: 500;
-  line-height: 100%;
-  letter-spacing: 0.08em;
-  text-transform: uppercase;
-}
-
-.kol-combo-number {
-  font-family: 'Right Grotesk', sans-serif;
-  font-size: 16px;
-  font-weight: 700;
-  line-height: 100%;
-  letter-spacing: 0.02em;
-}
-
-.kol-combo-stage--fill {
-  height: 100%;
-  min-height: 360px;
-  width: 100%;
-}
-
-.kol-combo-logo {
-  display: inline-flex;
-  color: currentColor;
-}
-
-/* 60 / 30 / 10 */
-.kol-combo-stage--ratio { display: flex; }
-.kol-combo-stage--ratio > :nth-child(1) { flex: 1; }
-.kol-combo-stage--ratio > :nth-child(2) { flex: 3; }
-.kol-combo-stage--ratio > :nth-child(3) { flex: 6; }
-
-/* Tower */
-.kol-combo-stage--tower {
-  display: flex;
-  flex-direction: column;
-  height: 100%;
-  width: 100%;
-}
-.kol-combo-stage--tower > * { flex: 1; }
-
-/* Quad split */
-.kol-combo-stage--quad { display: flex; }
-.kol-combo-stage--quad > * { flex: 1; }
-
-.kol-combo-quad-col {
-  display: flex;
-  flex-direction: column;
-}
-.kol-combo-quad-col > * { flex: 1; }
-
-/* Card row */
-.kol-combo-stage--card-row {
-  display: grid;
-  grid-template-columns: repeat(4, 1fr);
-  gap: 16px;
-  height: 100%;
-  min-height: 360px;
-  width: 100%;
-}
-
-.kol-combo-card {
-  flex: 1;
-  min-height: 240px;
-  padding: 20px;
-  display: flex;
-  flex-direction: column;
-  transition: background-color 400ms ease, color 400ms ease;
-}
-
-.kol-combo-card--end     { justify-content: flex-end; }
-.kol-combo-card--between { justify-content: space-between; }
-
-/* Stripe row */
-.kol-combo-stage--stripe-row {
-  display: flex;
-  flex-direction: column;
-  gap: 16px;
-  height: 100%;
-  min-height: 360px;
-  width: 100%;
-}
-
-.kol-combo-stripe-row {
-  display: flex;
-  flex: 1;
-  align-items: stretch;
-  width: 100%;
-}
-
-.kol-combo-stripe-bar {
-  display: flex;
-  flex: 1;
-  position: relative;
-  width: 100%;
-  height: 100%;
-  border-radius: 4px;
-  overflow: hidden;
-}
-
-.kol-combo-stripe-seg { transition: background-color 400ms ease; }
-.kol-combo-stripe-seg--6 { flex: 6; }
-.kol-combo-stripe-seg--3 { flex: 3; }
-.kol-combo-stripe-seg--1 { flex: 1; }
-
-.kol-combo-stripe-group { display: flex; }
-.kol-combo-stripe-group--3 { flex: 3; }
-.kol-combo-stripe-group--1 { flex: 1; }
-
-.kol-combo-stripe-neutral {
-  border-top: 1px solid var(--stripe-rule, transparent);
-  border-bottom: 1px solid var(--stripe-rule, transparent);
-}
-
-.kol-combo-stripe-accent-border {
-  border: 1.73px solid var(--stripe-accent, transparent);
-}
-
-.kol-combo-stripe-method {
-  position: absolute;
-  top: 12px;
-  left: 12px;
-  font-family: 'Right Grotesk Compact', sans-serif;
-  font-size: 12px;
-  font-weight: 500;
-  letter-spacing: 0.08em;
-  line-height: 100%;
-  text-transform: uppercase;
-  color: white;
-  pointer-events: none;
-}
-
-/* Applied card */
-.kol-combo-stage--applied {
-  display: flex;
-  height: 100%;
-  min-height: 360px;
-  width: 100%;
-}
-
-.kol-combo-applied-plate {
-  flex: 2;
-  padding: 32px;
-  display: flex;
-  flex-direction: column;
-  justify-content: space-between;
-  transition: background-color 400ms ease, color 400ms ease;
-}
-
-.kol-combo-applied-col {
-  flex: 1;
-  display: flex;
-  flex-direction: column;
-}
-
-.kol-combo-applied-surface { flex: 3; }
-.kol-combo-applied-band--lg { flex: 2; }
-.kol-combo-applied-band--sm { flex: 1; }
-.kol-combo-applied-band { transition: background-color 400ms ease; }
-
-.kol-combo-applied-accent-strip {
-  display: flex;
-  gap: 8px;
-}
-
-.kol-combo-applied-accent-chip {
-  width: 20px;
-  height: 20px;
-  border-radius: 2px;
-  transition: background-color 400ms ease;
-}
-
-/* ───── Foundations · combo lab ───── */
-
-.kol-combo-lab {
-  display: flex;
-  flex-direction: column;
-  flex: 1;
-  padding: 24px;
-  border: 1px solid var(--kol-fg-08);
-  border-radius: 4px;
-  background: var(--kol-fg-02);
-}
-
-.kol-combo-controls { margin-bottom: 24px; }
-
-.kol-combo-stage-wrap {
-  flex: 1;
-  margin-bottom: 24px;
-  padding: 32px;
-  background: var(--kol-fg-02);
-  border-radius: 4px;
-  min-height: 440px;
-  display: flex;
-  align-items: stretch;
-  justify-content: center;
-}
-
-.kol-combo-stage-anim {
-  width: 100%;
-  height: 100%;
-  animation: kol-combo-fade 260ms ease;
-  display: flex;
-  align-items: stretch;
-}
-
-.kol-combo-stage-anim > * { width: 100%; height: 100%; }
-
-/* In fullbleed mode, let the lab fill the section */
-.kol-page--fullbleed .kol-combo-lab { flex: 1; }
-.kol-page--fullbleed .kol-combo-stage-wrap { min-height: 520px; }
-
-@keyframes kol-combo-fade {
-  from { opacity: 0.2; transform: translateY(6px); }
-  to   { opacity: 1;   transform: none; }
-}
-
-.kol-combo-readout {
-  display: grid;
-  grid-template-columns: repeat(auto-fit, minmax(220px, 1fr));
-  gap: 8px 32px;
-  padding-top: 16px;
-  border-top: 1px solid var(--kol-fg-08);
-}
-
-/* Combo Lab — control rows (Layout / Palette / Logo selectors) */
-.kol-combo-row {
-  display: flex;
-  align-items: center;
-  gap: 16px;
-  flex-wrap: wrap;
-  margin-bottom: 12px;
-}
-
-.kol-combo-row-label { min-width: 72px; }
-
-.kol-combo-row-controls {
-  display: flex;
-  flex-wrap: wrap;
-  gap: 6px;
-}
-
-.kol-combo-footer {
-  display: flex;
-  align-items: center;
-  gap: 16px;
-  margin-top: 8px;
-}
-
-.kol-combo-footer-desc { flex: 1; }
-
-.kol-combo-randomize {
-  padding: 8px 16px;
-  background: transparent;
-  color: var(--kol-fg-80);
-  border: 1px solid var(--kol-fg-16);
-  border-radius: 4px;
-  font-family: var(--kol-font-family-mono, monospace);
-  font-weight: 600;
-  cursor: pointer;
-  transition: color 150ms ease, border-color 150ms ease, background 150ms ease;
-}
-
-.kol-combo-randomize:hover {
-  color: var(--kol-surface-on-primary);
-  border-color: var(--kol-fg-48);
-  background: var(--kol-fg-04);
-}
-
-/* Combo Lab — live palette readout rows */
-.kol-combo-swatch-row {
-  display: flex;
-  align-items: center;
-  gap: 12px;
-  padding: 6px 0;
-}
-
-.kol-combo-swatch-chip {
-  width: 24px;
-  height: 24px;
-  flex-shrink: 0;
-  border-radius: 3px;
-  transition: background 400ms ease;
-}
-
-.kol-combo-swatch-label {
-  min-width: 88px;
-  font-weight: 600;
-}
-
-.kol-combo-swatch-hex {
-  font-family: var(--kol-font-family-mono, monospace);
-  text-transform: uppercase;
-}
-
-.kol-combo-summary { margin-top: 16px; }
+/* .kol-combo-* (+ @keyframes kol-combo-fade) relocated to kol-theme/kol-components-styleguide.css 2026-07-10 */
 
 /* ═════════════════════════════════════════════════════════════════════
    SpectrumGrid — matrix color-token grid (9 ramps × 10 stops)
@@ -1113,28 +775,7 @@ code, pre {
 }
 
 
-/* ═════════════════════════════════════════════════════════════════════
-   Color Anatomy — token composition samples
-
-   Wrappers inlined in ColorAnatomy.jsx; figure margin via Preflight.
-   CSS retains the descendant typography for figcaption + inline <code>.
-   ═════════════════════════════════════════════════════════════════════ */
-
-.kol-anatomy-sample figcaption {
-  margin-top: 12px;
-  font-size: 12px;
-  color: var(--kol-fg-48);
-  font-style: italic;
-}
-
-.kol-anatomy-sample code {
-  font-family: var(--kol-font-family-mono, monospace);
-  font-size: 11px;
-  background: color-mix(in srgb, currentColor 18%, transparent);
-  padding: 1px 4px;
-  border-radius: 3px;
-  opacity: 1;
-}
+/* .kol-anatomy-sample-* relocated to kol-theme/kol-components-styleguide.css 2026-07-10 */
 
 
 /* ═════════════════════════════════════════════════════════════════════

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kolkrabbi/kol-framework",
-  "version": "0.3.4",
+  "version": "0.4.0",
   "description": "KOL app shell — sidenav, layout, theme toggle, footer, heroes + brand color layer. SideNav takes nav data as props so the tree stays app-local.",
   "license": "MIT",
   "type": "module",
@@ -27,7 +27,7 @@
     "app-shell"
   ],
   "dependencies": {
-    "@kolkrabbi/kol-component": "0.8.0",
+    "@kolkrabbi/kol-component": "0.9.0",
     "@kolkrabbi/kol-icons": "0.5.0"
   },
   "peerDependencies": {

package/src/ThemeToggle.jsx

@@ -3,9 +3,24 @@ import { Icon } from '@kolkrabbi/kol-icons'
 
 const STORAGE_KEY = 'kol-theme'
 
+/* An explicit choice is an app-set data-theme attribute or a saved user
+ * toggle. Absent both, the DS is light-first and follows the system
+ * (prefers-color-scheme) — matching the theme CSS, which only darkens via
+ * explicit [data-theme="dark"] or the media query. */
+function getExplicitTheme() {
+  const attr = document.documentElement.dataset.theme
+  if (attr === 'light' || attr === 'dark') return attr
+  try {
+    const saved = localStorage.getItem(STORAGE_KEY)
+    if (saved === 'light' || saved === 'dark') return saved
+  } catch { /* storage blocked */ }
+  return null
+}
+
 function getInitialTheme() {
-  if (typeof document === 'undefined') return 'dark'
-  return document.documentElement.dataset.theme === 'light' ? 'light' : 'dark'
+  if (typeof document === 'undefined') return 'light'
+  return getExplicitTheme()
+    ?? (window.matchMedia?.('(prefers-color-scheme: dark)')?.matches ? 'dark' : 'light')
 }
 
 /**
@@ -22,22 +37,50 @@ function getInitialTheme() {
  *              bg, no hover bg). For sidenav rows where the row should read
  *              as plain text + icon, not a button.
  *
- * Self-contained: owns theme state, writes `data-theme` to <html>, persists
- * to localStorage under `kol-theme`. The icon-swap animation slides a pair
- * of half-split theme-toggle icons horizontally — the `theme-toggle` SVG is
- * designed as a split circle, so the slide produces a visible light/dark flip.
+ * Self-contained but never imposing: initial state is the app-set
+ * `data-theme` attribute, else the user's saved toggle (`kol-theme`), else
+ * the system preference. `data-theme` + localStorage are written ONLY on a
+ * user toggle — mounting the component leaves the DOM untouched, so an
+ * undecided page keeps following prefers-color-scheme via the theme CSS.
+ * The icon-swap animation slides the `mode-toggle-01` / `mode-toggle-02`
+ * pair (v1 set) horizontally — two different halves of the split circle,
+ * so the slide is a visible flip.
  */
 export default function ThemeToggle({ variant = 'icon', className = '' }) {
   const [theme, setTheme] = useState(getInitialTheme)
 
   useEffect(() => {
-    document.documentElement.dataset.theme = theme
-    try { localStorage.setItem(STORAGE_KEY, theme) } catch { /* storage blocked */ }
-  }, [theme])
+    /* Re-stamp a previously saved user choice so persistence works in apps
+     * with no theme boot script — but only when the app itself hasn't set
+     * data-theme (an app-set attribute always wins over storage). */
+    const attr = document.documentElement.dataset.theme
+    let saved = null
+    try { saved = localStorage.getItem(STORAGE_KEY) } catch { /* storage blocked */ }
+    if (attr !== 'light' && attr !== 'dark') {
+      if (saved === 'light' || saved === 'dark') {
+        document.documentElement.dataset.theme = saved
+        return
+      }
+      /* No explicit choice anywhere — CSS follows the system on its own;
+       * this listener only keeps the toggle's icon in sync with it. */
+      const mq = window.matchMedia?.('(prefers-color-scheme: dark)')
+      if (!mq?.addEventListener) return
+      const onChange = (e) => {
+        try { if (localStorage.getItem(STORAGE_KEY)) return } catch { /* storage blocked */ }
+        setTheme(e.matches ? 'dark' : 'light')
+      }
+      mq.addEventListener('change', onChange)
+      return () => mq.removeEventListener('change', onChange)
+    }
+  }, [])
 
   const isDark = theme === 'dark'
   const next = isDark ? 'light' : 'dark'
-  const handleToggle = () => setTheme(next)
+  const handleToggle = () => {
+    setTheme(next)
+    document.documentElement.dataset.theme = next
+    try { localStorage.setItem(STORAGE_KEY, next) } catch { /* storage blocked */ }
+  }
 
   const iconSwap = (size) => (
     <span
@@ -49,8 +92,8 @@ export default function ThemeToggle({ variant = 'icon', className = '' }) {
         className="flex transition-transform duration-500 ease-in-out"
         style={{ width: size * 2, transform: isDark ? 'translateX(0)' : `translateX(-${size}px)` }}
       >
-        <Icon name="theme-toggle" size={size} />
-        <Icon name="theme-toggle" size={size} />
+        <Icon name="mode-toggle-01" size={size} />
+        <Icon name="mode-toggle-02" size={size} />
       </span>
     </span>
   )