@kolkrabbi/kol-theme 0.7.0 → 0.7.2

package/kol-components-dashboards.css

@@ -28,6 +28,17 @@
   }
 }
 
+/* Hide the scrollbar on the dashboard's horizontal strips (timeline, host
+   pills) while keeping them scrollable. Firefox uses scrollbar-width; WebKit
+   the pseudo-element. */
+.scrollbar-none {
+  scrollbar-width: none;
+  -ms-overflow-style: none;
+}
+.scrollbar-none::-webkit-scrollbar {
+  display: none;
+}
+
 /* ---------------------------------------------------------------------------
  * Dashboard Card Base
  * --------------------------------------------------------------------------- */

package/kol-components-workshop.css

@@ -0,0 +1,496 @@
+/* =============================================================================
+ * KOL components — workshop / docs chrome
+ * =============================================================================
+ * Shell + docs layout chrome shared across the Workshop and Docs surfaces.
+ * Relocated from the monorepo's private @kol/ui package:
+ *   packages/ui/css/components.css  → the .shell-* navigation classes
+ *   packages/ui/css/docs.css        → the .docs-* content classes
+ *                                     (+ docs-only .inline-tag-pill, .tag-graph-*)
+ *
+ * Class hooks are preserved so the JSX bindings keep resolving.
+ *
+ * Layer: this file ships unlayered; kol-theme.css assigns the layer at import —
+ *   @import "./kol-components-workshop.css" layer(components);
+ * placing it in the `components` cascade layer alongside the rest of KOL chrome,
+ * so consumer utilities (a later Tailwind layer) still override it.
+ *
+ * KOL conformance (type/color de-drift):
+ *   - Resting type + text color moved OUT to `kol-*` type classes + kol color
+ *     utilities carried DIRECTLY on the JSX className (visible in dev tools).
+ *     font-family / font-size / font-weight / line-height / letter-spacing /
+ *     color were stripped from these rules; rules that were type/color only
+ *     were deleted. Active color is a conditional kol color class in the JSX;
+ *     the rendered markdown body is wrapped in `.kol-prose`.
+ *   - Only structural props Tailwind/kol utilities can't express are kept here
+ *     (sticky, scrollbar hiding, grid/flex layout, container-query, absolute
+ *     positioning). `:hover` COLOR rules are kept — hover is a pure pointer
+ *     state with no JSX hook and the kol color utilities have no hover variant.
+ *   - `.shell-tab`, `.shell-nav-header`, `.shell-toc-expand-button`,
+ *     `.toggle-switch-label` are rendered by out-of-package / currently-unused
+ *     JSX, so their type is left in place (nothing in this repo's scope carries
+ *     a replacement class for them yet).
+ * ============================================================================= */
+
+/* =============================================================================
+ * SHELL NAVIGATION CLASSES
+ * ============================================================================= */
+
+/* Shell Page Header */
+.shell-page-header {
+  background: var(--kol-surface-primary);
+}
+
+/* Shell Tab Row */
+.shell-tabrow-items {
+  display: flex;
+  flex-wrap: nowrap;
+  gap: 24px;
+  overflow-x: auto;
+  padding-top: 8px;
+  padding-bottom: 0;
+  scrollbar-width: none;
+  -ms-overflow-style: none;
+}
+
+.shell-tabrow-items::-webkit-scrollbar {
+  display: none;
+}
+
+/* .shell-tab — structure only. Type + color live inline on the tab element
+ * (kol-helper-14 + text-meta / active text-emphasis). The active underline
+ * stays here as structure, fired by the `active` marker class. */
+.shell-tab {
+  display: inline-flex;
+  align-items: center;
+  gap: 6px;
+  white-space: nowrap;
+  flex-shrink: 0;
+  padding-top: 8px;
+  padding-bottom: 12px;
+  border-bottom: 2px solid transparent;
+  transition: color 0.2s ease, border-color 0.2s ease;
+  text-decoration: none;
+}
+
+.shell-tab.active,
+.shell-tab:active {
+  border-bottom-color: var(--kol-surface-on-primary);
+}
+
+/* Sidebar sticky wrappers — hidden scrollbar, still scrollable */
+.shell-sidebar-sticky {
+  scrollbar-width: none;
+}
+
+.shell-sidebar-sticky::-webkit-scrollbar {
+  display: none;
+}
+
+/* Sidebar toggle buttons (collapsible section headers) — layout only.
+ * Type/color carried in JSX (kol-helper-10 text-meta). */
+.shell-sidebar-toggle {
+  display: flex;
+  align-items: center;
+  gap: 6px;
+  cursor: pointer;
+  width: 100%;
+  border: none;
+  background: transparent;
+  padding: 0;
+  transition: color 0.15s ease;
+}
+
+.shell-sidebar-toggle:hover {
+  color: color-mix(in srgb, var(--kol-surface-on-primary) 72%, transparent);
+}
+
+/* Sidebar section labels — margin only; type/color in JSX. */
+.shell-sidebar-label {
+  margin-bottom: 8px;
+}
+
+/* Sidebar links — layout only; type/color (+ active) in JSX. */
+.shell-sidebar-link {
+  padding: 4px 0;
+  border-radius: 4px;
+  text-decoration: none;
+  transition: all 0.15s ease;
+  display: block;
+}
+
+.shell-sidebar-link:hover {
+  color: color-mix(in srgb, var(--kol-surface-on-primary) 100%, transparent);
+}
+
+/* Sidebar action buttons — layout only; type/color in JSX. */
+.shell-sidebar-action {
+  padding: 4px 0;
+  border-radius: 4px;
+  transition: all 0.15s ease;
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  width: 100%;
+  text-align: left;
+  border: none;
+  background: transparent;
+  cursor: pointer;
+  text-decoration: none;
+}
+
+.shell-sidebar-action:hover {
+  color: color-mix(in srgb, var(--kol-surface-on-primary) 100%, transparent);
+}
+
+/* TOC expand button — no in-package JSX consumer; kept as-is (icon button). */
+.shell-toc-expand-button {
+  padding: 2px;
+  border: none;
+  background: transparent;
+  color: color-mix(in srgb, var(--kol-surface-on-primary) 48%, transparent);
+  cursor: pointer;
+  transition: color 0.15s ease;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  flex-shrink: 0;
+}
+
+.shell-toc-expand-button:hover {
+  color: color-mix(in srgb, var(--kol-surface-on-primary) 100%, transparent);
+}
+
+/* Navigation header label — structure only; type/color inline (kol-helper-10 text-meta). */
+.shell-nav-header {
+  margin-bottom: 12px;
+}
+
+/* Navigation group header — layout only; type/color in JSX. */
+.shell-nav-group-header {
+  padding: 6px 0 6px 0;
+  cursor: pointer;
+  display: flex;
+  justify-content: space-between;
+  align-items: center;
+  transition: color 0.15s ease;
+}
+
+.shell-nav-group-header:hover {
+  color: color-mix(in srgb, var(--kol-surface-on-primary) 90%, transparent);
+}
+
+.shell-nav-items {
+  display: flex;
+  flex-direction: column;
+  gap: 4px;
+  margin-top: 4px;
+}
+
+/* Navigation items — layout only; type/color (+ active) in JSX. */
+.shell-nav-item {
+  padding: 4px 12px 4px 20px;
+  border-radius: 0px;
+  text-decoration: none;
+  transition: all 0.15s ease;
+  display: block;
+}
+
+.shell-nav-item:hover {
+  color: color-mix(in srgb, var(--kol-surface-on-primary) 100%, transparent);
+}
+
+.shell-nav-item-doc {
+  display: flex;
+  align-items: baseline;
+  justify-content: space-between;
+  gap: 8px;
+}
+
+.shell-nav-item-id {
+  flex-shrink: 0;
+}
+
+.shell-nav-item-title {
+  min-width: 0;
+}
+
+/* Wide viewport nav layout bumps */
+@media (min-width: 1600px) {
+  .shell-tabrow-items {
+    gap: 32px;
+  }
+
+  .shell-tab {
+    gap: 8px;
+    padding-top: 10px;
+    padding-bottom: 14px;
+  }
+
+  .shell-tab svg {
+    width: 18px;
+    height: 18px;
+  }
+
+  .shell-sidebar-action svg {
+    width: 18px;
+    height: 18px;
+  }
+
+  .shell-nav-item {
+    padding: 5px 14px 5px 24px;
+  }
+
+  .toggle-switch-label {
+    font-size: 13px;
+  }
+
+  /* Wide grid gap */
+  .shell-content-grid {
+    gap: 48px;
+  }
+}
+
+/* =============================================================================
+ * DOCS CONTENT CLASSES
+ * =============================================================================
+ * Content-rendering styles for documentation pages. The rendered markdown body
+ * is wrapped in `.kol-prose` (headings / p / code / lists / blockquote / links),
+ * so the per-element `.docs-article *` type rules that used to live here are
+ * gone. Only structural doc chrome (cards, frontmatter layout, callout rule,
+ * media, tag graph) remains.
+ */
+
+/* Documentation Card (used in inventory listing) */
+.docs-card {
+  display: block;
+  padding: 16px;
+  border-radius: 8px;
+  border: 1px solid;
+  border-color: color-mix(in srgb, var(--kol-surface-on-primary) 4%, transparent);
+  background: transparent;
+  transition: all 0.2s ease;
+  text-decoration: none;
+  color: inherit;
+}
+
+.docs-card:hover {
+  border-color: color-mix(in srgb, var(--kol-surface-on-primary) 12%, transparent);
+  background: color-mix(in srgb, var(--kol-surface-on-primary) 2%, transparent);
+}
+
+.docs-card:hover * {
+  color: inherit;
+}
+
+/* Compact doc card for sidebar */
+.docs-card--compact {
+  padding: 8px 12px;
+  border-radius: 6px;
+}
+
+.docs-title-link {
+  color: inherit;
+  text-decoration: none;
+  display: inline-flex;
+  align-items: center;
+  gap: 8px;
+}
+
+/* Doc meta row — layout only; type/color in JSX (kol-helper-10 text-body). */
+.docs-meta {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 12px;
+}
+
+/* Article shell — structural only; body type owned by `.kol-prose`. */
+.docs-article {
+  width: 100%;
+  margin-inline: 0;
+  container-type: inline-size;
+}
+
+@media (min-width: 768px) {
+  .docs-article .kol-codeblock { padding: 24px; }
+}
+
+@media (min-width: 1024px) {
+  .docs-article .kol-codeblock { padding: 32px; }
+}
+
+/* Frontmatter properties block */
+.docs-frontmatter {
+  border-bottom: 1px solid color-mix(in srgb, var(--kol-surface-on-primary) 8%, transparent);
+  padding-bottom: 20px;
+  margin-bottom: 24px;
+}
+
+.docs-frontmatter .shell-sidebar-label {
+  margin-block-end: 8px;
+}
+
+.docs-frontmatter-row {
+  display: flex;
+  align-items: baseline;
+  gap: 16px;
+  padding: 4px 0;
+}
+
+/* Frontmatter key — layout only; type/color in JSX (kol-helper-12 text-meta). */
+.docs-frontmatter-key {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  min-width: 120px;
+}
+
+.docs-frontmatter-row:has(.tag) {
+  align-items: center;
+}
+
+.docs-color-swatch {
+  display: inline-flex;
+  align-items: center;
+  gap: 5px;
+}
+
+.docs-color-swatch-dot {
+  display: inline-block;
+  width: 10px;
+  height: 10px;
+  border-radius: 50%;
+  flex-shrink: 0;
+}
+
+.docs-image {
+  max-width: 100%;
+  height: auto;
+  border-radius: 8px;
+  margin-block: 1.5rem;
+}
+
+.docs-meta-inline {
+  margin-block-end: 1rem;
+}
+
+.docs-article hr {
+  margin-block: 2rem;
+  border: none;
+  border-top: 1px solid color-mix(in srgb, var(--kol-surface-on-primary) 12%, transparent);
+}
+
+.docs-divider {
+  width: 100%;
+  margin-block: 2rem;
+}
+
+.docs-divider > div {
+  background: color-mix(in srgb, var(--kol-surface-on-primary) 8%, transparent) !important;
+}
+
+/* Callout / blockquote rule — structural; only the broken palette token fixed. */
+.docs-callout {
+  padding: 0;
+  padding-left: 16px;
+  margin-block-end: 1.5rem;
+  background: none;
+  border: none;
+  border-left: 1px solid var(--kol-color-red-200);
+}
+
+/* Inline hashtag pills — layout only; type + resting bg/color in JSX
+ * (kol-helper-12 bg-fg-08 text-strong). Hover state kept. */
+.inline-tag-pill {
+  padding: 2px 8px;
+  border-radius: 9999px;
+  text-decoration: none;
+  transition: all 0.15s ease;
+  white-space: nowrap;
+}
+
+.inline-tag-pill:hover {
+  background: var(--kol-accent-primary);
+  color: var(--kol-surface-primary);
+}
+
+/* View toggle buttons — no in-package JSX consumer; layout kept, type stripped. */
+.docs-view-toggle {
+  display: inline-flex;
+  align-items: center;
+  gap: 6px;
+  padding: 6px 12px;
+  border: 1px solid color-mix(in srgb, var(--kol-surface-on-primary) 16%, transparent);
+  border-radius: 6px;
+  background: transparent;
+  cursor: pointer;
+  transition: all 0.15s ease;
+}
+
+.docs-view-toggle:hover {
+  background: color-mix(in srgb, var(--kol-surface-on-primary) 8%, transparent);
+  color: color-mix(in srgb, var(--kol-surface-on-primary) 72%, transparent);
+}
+
+.docs-view-toggle.active {
+  background: color-mix(in srgb, var(--kol-accent-primary) 16%, transparent);
+  border-color: color-mix(in srgb, var(--kol-accent-primary) 40%, transparent);
+  color: var(--kol-accent-primary);
+}
+
+.docs-view-toggle--small {
+  padding: 4px 8px;
+  border-radius: 4px;
+}
+
+/* Tag Graph - Main content area */
+.tag-graph-container {
+  width: 100%;
+  position: relative;
+  overflow: hidden;
+}
+
+.tag-graph-svg {
+  display: block;
+  margin: 0 auto;
+}
+
+/* Tag graph tooltip — layout only; type/color in JSX (kol-helper-10 text-emphasis). */
+.tag-graph-tooltip {
+  background: color-mix(in srgb, var(--kol-surface-primary) 92%, transparent);
+  padding: 4px 8px;
+  border-radius: 4px;
+  pointer-events: none;
+  white-space: nowrap;
+  position: absolute;
+  bottom: 8px;
+  left: 50%;
+  transform: translateX(-50%);
+}
+
+/* Tag Graph - Sidebar */
+.tag-graph-sidebar {
+  width: 100%;
+  aspect-ratio: 1;
+  position: relative;
+  overflow: hidden;
+  border-radius: 8px;
+  background: color-mix(in srgb, var(--kol-surface-on-primary) 4%, transparent);
+}
+
+.tag-graph-sidebar .tag-graph-svg {
+  width: 100%;
+  height: 100%;
+}
+
+.tag-graph-sidebar .tag-graph-tooltip {
+  position: absolute;
+  top: 8px;
+  left: 50%;
+  transform: translateX(-50%);
+  bottom: auto;
+  z-index: 10;
+}
+
+.tag-graph-sidebar-wrapper {
+  margin-top: 4px;
+}

package/kol-theme.css

@@ -43,6 +43,7 @@
 @import "./kol-components-organisms.css" layer(components);
 @import "./kol-components-dashboards.css" layer(components);
 @import "./kol-components-chess.css" layer(components);
+@import "./kol-components-workshop.css" layer(components);
 
 /* Theme-level design tokens */
 @layer components {

package/package.json

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