canny-ui 1.0.0

package/src/components/_navbar.scss

@@ -0,0 +1,151 @@
+@use '../tokens/primitives' as *;
+
+// ── Navbar ────────────────────────────────────────────────────
+// Sticky top-of-app bar. Three slots: brand (left), nav (center), actions (right).
+// Glass-morphism backdrop with a hairline that sharpens as the page scrolls.
+
+.cny-navbar {
+  display: flex;
+  align-items: center;
+  gap: $space-4;
+  height: 56px;
+  padding: 0 $space-6;
+  background: color-mix(in srgb, var(--bg-base) 78%, transparent);
+  backdrop-filter: saturate(180%) blur(14px);
+  -webkit-backdrop-filter: saturate(180%) blur(14px);
+  border-bottom: 1px solid var(--hairline-color);
+  position: sticky;
+  top: 0;
+  z-index: 20;
+  transition: background-color var(--transition-fast), border-color var(--transition-fast);
+
+  &.solid {
+    background: var(--bg-base);
+    backdrop-filter: none;
+    -webkit-backdrop-filter: none;
+  }
+
+  &.bordered {
+    border-bottom-color: var(--border-color);
+  }
+}
+
+.cny-navbar-brand {
+  display: inline-flex;
+  align-items: center;
+  gap: $space-2;
+  text-decoration: none;
+  color: var(--text-primary);
+  font-weight: 650;
+  letter-spacing: -0.012em;
+  font-size: 0.9375rem;
+  line-height: 1;
+  padding: 6px 8px;
+  margin-left: -8px;
+  border-radius: var(--radius-sm);
+  flex-shrink: 0;
+  transition: background-color var(--transition-fast);
+
+  &:hover { background: var(--bg-surface-low); }
+
+  &:focus-visible {
+    outline: none;
+    box-shadow: 0 0 0 var(--ring-width) var(--ring-color);
+  }
+
+  .brand-mark {
+    position: relative;
+    width: 22px;
+    height: 22px;
+    border-radius: 6px;
+    background:
+      radial-gradient(120% 120% at 20% 0%, color-mix(in srgb, white 22%, transparent), transparent 55%),
+      linear-gradient(135deg, var(--color-primary), color-mix(in srgb, var(--color-primary) 60%, black));
+    box-shadow:
+      inset 0 1px 0 color-mix(in srgb, white 25%, transparent),
+      inset 0 0 0 1px color-mix(in srgb, var(--color-primary) 40%, black),
+      0 1px 2px rgba(0, 0, 0, 0.18);
+    flex-shrink: 0;
+  }
+}
+
+.cny-navbar-nav {
+  display: flex;
+  align-items: center;
+  gap: 2px;
+  flex: 1;
+  min-width: 0;
+  overflow-x: auto;
+  scrollbar-width: none;
+
+  &::-webkit-scrollbar { display: none; }
+}
+
+.cny-navbar-item {
+  position: relative;
+  display: inline-flex;
+  align-items: center;
+  height: 32px;
+  padding: 0 $space-3;
+  border-radius: var(--radius-sm);
+  font-size: 0.875rem;
+  font-weight: 500;
+  color: var(--text-secondary);
+  text-decoration: none;
+  white-space: nowrap;
+  transition:
+    background-color var(--transition-fast),
+    color var(--transition-fast);
+
+  &:hover {
+    background: var(--bg-surface-low);
+    color: var(--text-primary);
+  }
+
+  &:focus-visible {
+    outline: none;
+    box-shadow: 0 0 0 var(--ring-width) var(--ring-color);
+  }
+
+  &.active {
+    color: var(--text-primary);
+    font-weight: 550;
+
+    &::after {
+      content: '';
+      position: absolute;
+      left: $space-3;
+      right: $space-3;
+      bottom: -10px;
+      height: 2px;
+      border-radius: 2px 2px 0 0;
+      background: var(--color-primary);
+    }
+  }
+}
+
+.cny-navbar-actions {
+  display: flex;
+  align-items: center;
+  gap: $space-2;
+  margin-left: auto;
+  flex-shrink: 0;
+}
+
+.cny-navbar-divider {
+  width: 1px;
+  height: 20px;
+  background: var(--hairline-color);
+  margin: 0 $space-1;
+  flex-shrink: 0;
+}
+
+// Responsive: tuck nav on narrow screens
+@media (max-width: 640px) {
+  .cny-navbar {
+    height: 52px;
+    padding: 0 $space-4;
+    gap: $space-2;
+  }
+  .cny-navbar-nav { display: none; }
+}

package/src/components/_progress.scss

@@ -0,0 +1,70 @@
+@use '../tokens/primitives' as *;
+
+// Progress — determinate bar or indeterminate shimmer. Set width via inline style or --value.
+
+.progress {
+  position: relative;
+  display: block;
+  width: 100%;
+  height: 6px;
+  background: var(--bg-surface-edge);
+  border-radius: var(--radius-full);
+  overflow: hidden;
+
+  &-bar {
+    display: block;
+    height: 100%;
+    width: var(--value, 0%);
+    background: var(--color-primary);
+    border-radius: inherit;
+    transition: width var(--transition-base);
+  }
+
+  &.danger  .progress-bar { background: var(--color-danger); }
+  &.warning .progress-bar { background: var(--color-warning); }
+  &.success .progress-bar { background: var(--color-success); }
+  &.info    .progress-bar { background: var(--color-info); }
+
+  &.sm { height: 4px; }
+  &.lg { height: 10px; }
+
+  // Indeterminate — sliding chunk
+  &.indeterminate .progress-bar {
+    width: 40%;
+    animation: cny-progress-slide 1.4s var(--ease-standard) infinite;
+  }
+}
+
+@keyframes cny-progress-slide {
+  0%   { transform: translateX(-100%); }
+  100% { transform: translateX(250%); }
+}
+
+// Circular progress — via conic-gradient, driven by --value (0-100)
+.progress-ring {
+  --value: 0;
+  display: inline-grid;
+  place-items: center;
+  width: 40px;
+  height: 40px;
+  border-radius: 50%;
+  background:
+    conic-gradient(var(--color-primary) calc(var(--value) * 1%), var(--bg-surface-edge) 0);
+  font-family: var(--font-body);
+  font-size: 0.6875rem;
+  font-weight: 600;
+  color: var(--text-primary);
+
+  &::before {
+    content: '';
+    grid-area: 1 / 1;
+    width: calc(100% - 6px);
+    height: calc(100% - 6px);
+    background: var(--bg-surface-lowest);
+    border-radius: 50%;
+  }
+  & > * { grid-area: 1 / 1; }
+
+  &.sm { width: 28px; height: 28px; font-size: 0.5625rem; }
+  &.lg { width: 56px; height: 56px; font-size: 0.8125rem; }
+}

package/src/components/_scrollbar.scss

@@ -0,0 +1,159 @@
+@use '../tokens/primitives' as *;
+
+// ── Scrollbar ────────────────────────────────────────────────────
+// Opt-in styled scrollbar. Apply `.cny-scroll` to any overflow container.
+// Modifiers:
+//   .thin     — narrower track for dense UIs
+//   .overlay  — hides the thumb until hover/scroll
+//   .subtle   — track visible only on hover
+//   .expand   — thin by default, thumb widens on container hover
+//   .primary  — thumb uses primary color
+
+.cny-scroll {
+  scrollbar-width: thin;
+  scrollbar-color: var(--border-color) transparent;
+
+  &::-webkit-scrollbar {
+    width: 12px;
+    height: 12px;
+  }
+
+  &::-webkit-scrollbar-track {
+    background: transparent;
+  }
+
+  &::-webkit-scrollbar-thumb {
+    background-color: var(--border-color);
+    border-radius: var(--radius-full);
+    border: 3px solid transparent;
+    background-clip: content-box;
+    transition: background-color var(--transition-fast);
+
+    &:hover {
+      background-color: var(--text-muted);
+      background-clip: content-box;
+    }
+
+    &:active {
+      background-color: var(--text-secondary);
+      background-clip: content-box;
+    }
+  }
+
+  &::-webkit-scrollbar-corner {
+    background: transparent;
+  }
+
+  // ── Thin ───────────────────────────────────────────────────────
+  &.thin {
+    &::-webkit-scrollbar {
+      width: 8px;
+      height: 8px;
+    }
+
+    &::-webkit-scrollbar-thumb {
+      border-width: 2px;
+    }
+  }
+
+  // ── Subtle: track appears on hover ─────────────────────────────
+  &.subtle {
+    &::-webkit-scrollbar-thumb {
+      background-color: transparent;
+    }
+
+    &:hover::-webkit-scrollbar-thumb,
+    &:focus-within::-webkit-scrollbar-thumb {
+      background-color: var(--border-color);
+      background-clip: content-box;
+    }
+  }
+
+  // ── Overlay: thumb floats over content ─────────────────────────
+  &.overlay {
+    &::-webkit-scrollbar {
+      width: 10px;
+      height: 10px;
+    }
+
+    &::-webkit-scrollbar-track {
+      background: transparent;
+    }
+
+    &::-webkit-scrollbar-thumb {
+      background-color: color-mix(in srgb, var(--text-muted) 40%, transparent);
+      border-width: 2px;
+
+      &:hover {
+        background-color: color-mix(in srgb, var(--text-muted) 70%, transparent);
+        background-clip: content-box;
+      }
+    }
+  }
+
+  // ── Expand: slim thumb that fattens when the pointer is on the scrollbar ─
+  &.expand {
+    // Leave scrollbar-width unset (auto) so Chromium honors the webkit width.
+    // Firefox has no pseudo-element hover, so `thin` stays its native look.
+    scrollbar-width: auto;
+
+    &::-webkit-scrollbar {
+      width: 16px;
+      height: 16px;
+      background: transparent;
+    }
+
+    // Rest: 16px track with a 4px transparent border → 8px visible thumb.
+    &::-webkit-scrollbar-thumb {
+      border-width: 4px;
+      background-color: var(--border-color-strong);
+      transition:
+        border-width 0.15s ease,
+        background-color var(--transition-fast);
+    }
+
+    // Pointer over the thumb (anywhere in its 16px column) → fatten to 14px visible.
+    // The transparent border is still part of the thumb's hit region.
+    &::-webkit-scrollbar-thumb:hover,
+    &::-webkit-scrollbar-thumb:active {
+      border-width: 1px;
+      background-color: var(--text-muted);
+    }
+  }
+
+  // ── Primary color ──────────────────────────────────────────────
+  &.primary {
+    scrollbar-color: var(--color-primary) transparent;
+
+    &::-webkit-scrollbar-thumb {
+      background-color: var(--color-primary);
+      background-clip: content-box;
+
+      &:hover {
+        background-color: var(--color-primary);
+        background-clip: content-box;
+      }
+    }
+  }
+}
+
+// ── Scroll region: a bordered, rounded panel that scrolls ──────
+.cny-scroll-region {
+  @extend .cny-scroll;
+  border: 1px solid var(--border-color);
+  border-radius: var(--radius-md);
+  background: var(--bg-surface-lowest);
+  overflow: auto;
+
+  // Fade gradient cues at the top/bottom when content overflows.
+  // Uses scroll-driven shadow via background-attachment.
+  background:
+    linear-gradient(var(--bg-surface-lowest) 30%, rgba(0, 0, 0, 0)) center top,
+    linear-gradient(rgba(0, 0, 0, 0), var(--bg-surface-lowest) 70%) center bottom,
+    radial-gradient(farthest-side at center top, var(--hairline-color), transparent) center top,
+    radial-gradient(farthest-side at center bottom, var(--hairline-color), transparent) center bottom;
+  background-repeat: no-repeat;
+  background-size: 100% 24px, 100% 24px, 100% 8px, 100% 8px;
+  background-attachment: local, local, scroll, scroll;
+  background-color: var(--bg-surface-lowest);
+}

package/src/components/_sidebar.scss

@@ -0,0 +1,132 @@
+@use '../tokens/primitives' as *;
+
+// ── Sidebar ───────────────────────────────────────────────────
+// A vertical navigation rail. Composes into sections with titles and items.
+
+.cny-sidebar {
+  display: flex;
+  flex-direction: column;
+  width: 240px;
+  flex-shrink: 0;
+  padding: $space-6 $space-5;
+  border-right: 1px solid var(--hairline-color);
+  background: var(--bg-base);
+  overflow-y: auto;
+
+  &.sticky {
+    position: sticky;
+    top: 52px;
+    align-self: flex-start;
+    max-height: calc(100vh - 52px);
+  }
+
+  &.thin {
+    width: 200px;
+    padding: $space-5 $space-4;
+  }
+
+  &.wide {
+    width: 280px;
+  }
+}
+
+.cny-sidebar-section {
+  margin-bottom: $space-6;
+
+  &:last-child {
+    margin-bottom: 0;
+  }
+}
+
+.cny-sidebar-title {
+  font-size: 0.6875rem;
+  font-weight: 650;
+  letter-spacing: 0.08em;
+  text-transform: uppercase;
+  color: var(--text-muted);
+  padding: 0 $space-2;
+  margin: 0 0 $space-3;
+}
+
+.cny-sidebar-nav {
+  display: flex;
+  flex-direction: column;
+  gap: 1px;
+}
+
+.cny-sidebar-item {
+  display: flex;
+  align-items: center;
+  gap: $space-2;
+  padding: 6px $space-2;
+  border-radius: var(--radius-sm);
+  font-size: 0.84375rem;
+  color: var(--text-secondary);
+  text-decoration: none;
+  position: relative;
+  transition: background-color var(--transition-fast), color var(--transition-fast);
+
+  &:hover {
+    background: var(--bg-surface-low);
+    color: var(--text-primary);
+  }
+
+  &.active {
+    color: var(--color-primary);
+    font-weight: 550;
+    background: color-mix(in srgb, var(--color-primary) 8%, transparent);
+
+    &::before {
+      content: '';
+      position: absolute;
+      left: calc(-1 * #{$space-5});
+      top: 50%;
+      transform: translateY(-50%);
+      width: 2px;
+      height: 16px;
+      background: var(--color-primary);
+      border-radius: 0 2px 2px 0;
+    }
+  }
+
+  &.disabled {
+    color: var(--text-muted);
+    pointer-events: none;
+    opacity: 0.55;
+  }
+
+  .cny-sidebar-item-icon {
+    width: 14px;
+    height: 14px;
+    flex-shrink: 0;
+    opacity: 0.75;
+  }
+
+  .cny-sidebar-item-badge {
+    margin-left: auto;
+  }
+}
+
+// Collapsed variant: icons only
+.cny-sidebar.collapsed {
+  width: 60px;
+  padding: $space-5 $space-2;
+  align-items: center;
+
+  .cny-sidebar-title { display: none; }
+
+  .cny-sidebar-item {
+    justify-content: center;
+    padding: 8px;
+
+    span:not(.cny-sidebar-item-icon):not(.cny-sidebar-item-badge) { display: none; }
+    .cny-sidebar-item-badge { display: none; }
+
+    &.active::before { left: -#{$space-2}; }
+  }
+}
+
+// Responsive: hide below 900px (callers should provide a mobile menu)
+@media (max-width: 900px) {
+  .cny-sidebar.responsive { display: none; }
+}

package/src/components/_skeleton.scss

@@ -0,0 +1,72 @@
+@use '../tokens/primitives' as *;
+
+// Skeleton — shimmering placeholder for async content.
+
+.skeleton {
+  display: block;
+  background: var(--bg-surface-edge);
+  border-radius: var(--radius-sm);
+  position: relative;
+  overflow: hidden;
+  color: transparent;
+  user-select: none;
+
+  &::after {
+    content: '';
+    position: absolute;
+    inset: 0;
+    transform: translateX(-100%);
+    background: linear-gradient(
+      90deg,
+      transparent 0%,
+      rgba(255, 255, 255, 0.45) 50%,
+      transparent 100%
+    );
+    animation: cny-skeleton-shimmer 1.6s infinite;
+  }
+
+  // Shape variants
+  &.text {
+    height: 0.875rem;
+    border-radius: var(--radius-xs);
+    margin: 4px 0;
+  }
+  &.title {
+    height: 1.25rem;
+    width: 60%;
+    border-radius: var(--radius-xs);
+  }
+  &.circle { border-radius: 50%; }
+  &.button { height: 36px; width: 96px; border-radius: var(--radius-sm); }
+  &.avatar { width: 32px; height: 32px; border-radius: 50%; }
+}
+
+@keyframes cny-skeleton-shimmer {
+  100% { transform: translateX(100%); }
+}
+
+// Respect reduced motion
+@media (prefers-reduced-motion: reduce) {
+  .skeleton::after { animation: none; }
+}
+
+// Dark theme — use a lighter overlay since background is darker
+.cny-dark .skeleton::after {
+  background: linear-gradient(
+    90deg,
+    transparent 0%,
+    rgba(255, 255, 255, 0.08) 50%,
+    transparent 100%
+  );
+}
+
+@media (prefers-color-scheme: dark) {
+  .skeleton::after {
+    background: linear-gradient(
+      90deg,
+      transparent 0%,
+      rgba(255, 255, 255, 0.08) 50%,
+      transparent 100%
+    );
+  }
+}

package/src/components/_table.scss

@@ -0,0 +1,132 @@
+@use '../tokens/primitives' as *;
+
+// Table — enterprise data tables. Opt-in .striped, .bordered, .compact.
+
+.table {
+  width: 100%;
+  border-collapse: collapse;
+  font-family: var(--font-body);
+  font-size: 0.875rem;
+  color: var(--text-primary);
+  background: var(--bg-surface-lowest);
+
+  th, td {
+    padding: $space-3 $space-4;
+    text-align: left;
+    vertical-align: middle;
+    border-bottom: 1px solid var(--hairline-color);
+  }
+
+  thead th {
+    font-size: 0.75rem;
+    font-weight: 600;
+    color: var(--text-muted);
+    text-transform: uppercase;
+    letter-spacing: 0.04em;
+    background: var(--bg-surface-low);
+    border-bottom: 1px solid var(--border-color);
+    white-space: nowrap;
+  }
+
+  tbody tr {
+    transition: background-color var(--transition-fast);
+
+    &:last-child td { border-bottom: 0; }
+  }
+
+  &.hoverable tbody tr:hover { background: var(--bg-surface-low); }
+
+  &.striped tbody tr:nth-child(odd) { background: var(--bg-surface-low); }
+
+  &.compact {
+    th, td { padding: $space-2 $space-3; }
+  }
+
+  &.bordered {
+    border: 1px solid var(--border-color);
+    border-radius: var(--radius-md);
+    overflow: hidden;
+
+    th, td { border-right: 1px solid var(--hairline-color); }
+    th:last-child, td:last-child { border-right: 0; }
+  }
+
+  // Numeric/tabular alignment utility on cells
+  .num {
+    text-align: right;
+    font-variant-numeric: tabular-nums;
+  }
+
+  // Resizable columns — activate with .resizable.
+  // Needs the canny-ui table-resize.js helper to wire up drag handles.
+  &.resizable {
+    table-layout: fixed;
+
+    // Clip shrunk columns at the cell boundary so content never spills into
+    // the next column. For nested flex content, wrap text in <span class="truncate">.
+    thead th,
+    tbody td {
+      overflow: hidden;
+      text-overflow: ellipsis;
+      white-space: nowrap;
+    }
+
+    thead th { position: relative; }
+
+    // Allow flex row cells to shrink their text children to the available width.
+    tbody td > .cny-row { min-width: 0; }
+
+    .th-resizer {
+      position: absolute;
+      top: 0;
+      right: 0;
+      width: 6px;
+      height: 100%;
+      cursor: col-resize;
+      user-select: none;
+      touch-action: none;
+      z-index: 1;
+      background: transparent;
+      transition: background-color var(--transition-fast);
+
+      &::after {
+        content: '';
+        position: absolute;
+        top: 20%;
+        right: 2px;
+        width: 1px;
+        height: 60%;
+        background: var(--border-color);
+        transition: background-color var(--transition-fast);
+      }
+
+      &:hover::after,
+      &.resizing::after {
+        background: var(--color-primary);
+        width: 2px;
+      }
+
+      &:hover,
+      &.resizing {
+        background: color-mix(in srgb, var(--color-primary) 8%, transparent);
+      }
+    }
+
+    // Visual feedback while dragging — applied to <body> by the helper.
+    &.is-resizing {
+      cursor: col-resize;
+      user-select: none;
+    }
+  }
+}
+
+// Wrapper for horizontal scroll on narrow viewports
+.table-wrap {
+  overflow-x: auto;
+  border: 1px solid var(--border-color);
+  border-radius: var(--radius-md);
+  background: var(--bg-surface-lowest);
+
+  .table { background: transparent; }
+  .table th, .table td { white-space: nowrap; }
+}