kedhar-ui 0.1.0

package/dist/kedhar-ui.css

@@ -0,0 +1,451 @@
+/* kedhar-ui v0.1.0 — https://github.com/kedharsairam/kedhar-ui */
+
+/* ══════════════════════════════════════════════════════════════
+   kedhar-ui — Design Tokens
+   ══════════════════════════════════════════════════════════════
+   These tokens are consumed by base.css and components.css.
+   Each site imports its theme file to set the --ks-color-* values.
+   ══════════════════════════════════════════════════════════════ */
+
+:root {
+  /* ─── Spacing Scale ──────────────────────────────────────── */
+  --ks-space-1:  4px;
+  --ks-space-2:  8px;
+  --ks-space-3:  12px;
+  --ks-space-4:  16px;
+  --ks-space-5:  20px;
+  --ks-space-6:  24px;
+  --ks-space-8:  32px;
+  --ks-space-10: 40px;
+  --ks-space-12: 48px;
+  --ks-space-16: 64px;
+  --ks-space-20: 80px;
+
+  /* ─── Border Radius ──────────────────────────────────────── */
+  --ks-radius-sm:   6px;
+  --ks-radius-md:   10px;
+  --ks-radius-lg:   16px;
+  --ks-radius-xl:   24px;
+  --ks-radius-full: 9999px;
+
+  /* ─── Typography ─────────────────────────────────────────── */
+  --ks-font-sans: 'Inter', system-ui, -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
+  --ks-font-mono: 'JetBrains Mono', 'Fira Code', 'Cascadia Code', Consolas, monospace;
+
+  --ks-text-xs:   0.75rem;
+  --ks-text-sm:   0.875rem;
+  --ks-text-base: 1rem;
+  --ks-text-lg:   1.125rem;
+  --ks-text-xl:   1.25rem;
+  --ks-text-2xl:  1.5rem;
+  --ks-text-3xl:  1.875rem;
+  --ks-text-4xl:  2.25rem;
+
+  --ks-leading-tight:   1.25;
+  --ks-leading-normal:  1.5;
+  --ks-leading-relaxed: 1.625;
+
+  --ks-weight-normal: 400;
+  --ks-weight-medium: 500;
+  --ks-weight-semibold: 600;
+  --ks-weight-bold: 700;
+
+  /* ─── Shadows ────────────────────────────────────────────── */
+  --ks-shadow-sm:  0 1px 2px rgba(0, 0, 0, 0.05);
+  --ks-shadow-md:  0 4px 6px -1px rgba(0, 0, 0, 0.07), 0 2px 4px -2px rgba(0, 0, 0, 0.05);
+  --ks-shadow-lg:  0 10px 25px -3px rgba(0, 0, 0, 0.08), 0 4px 6px -4px rgba(0, 0, 0, 0.04);
+  --ks-shadow-xl:  0 20px 50px -8px rgba(0, 0, 0, 0.1);
+
+  /* ─── Transitions ────────────────────────────────────────── */
+  --ks-ease-out:    cubic-bezier(0.16, 1, 0.3, 1);
+  --ks-ease-in:     cubic-bezier(0.4, 0, 0.68, 0.06);
+  --ks-ease-in-out: cubic-bezier(0.65, 0, 0.35, 1);
+  --ks-ease-spring: cubic-bezier(0.34, 1.56, 0.64, 1);
+
+  --ks-duration-fast:   150ms;
+  --ks-duration-normal: 250ms;
+  --ks-duration-slow:   400ms;
+
+  /* ─── Z-Index Scale ──────────────────────────────────────── */
+  --ks-z-base:    1;
+  --ks-z-dropdown: 10;
+  --ks-z-sticky:  20;
+  --ks-z-modal:   30;
+  --ks-z-toast:   40;
+  --ks-z-tooltip: 50;
+
+  /* ─── Layout ─────────────────────────────────────────────── */
+  --ks-max-width: 1200px;
+}
+
+/* ─── Dark mode token overrides ────────────────────────────── */
+.dark {
+  --ks-shadow-sm: 0 1px 2px rgba(0, 0, 0, 0.2);
+  --ks-shadow-md: 0 4px 6px -1px rgba(0, 0, 0, 0.3), 0 2px 4px -2px rgba(0, 0, 0, 0.2);
+  --ks-shadow-lg: 0 10px 25px -3px rgba(0, 0, 0, 0.3), 0 4px 6px -4px rgba(0, 0, 0, 0.2);
+  --ks-shadow-xl: 0 20px 50px -8px rgba(0, 0, 0, 0.3);
+}
+
+/* ══════════════════════════════════════════════════════════════
+   kedhar-ui — Base Styles
+   ══════════════════════════════════════════════════════════════
+   Reset + base element styling. Import tokens.css first.
+   ══════════════════════════════════════════════════════════════ */
+
+/* ─── Box-Sizing Reset ─────────────────────────────────────── */
+*,
+*::before,
+*::after {
+  box-sizing: border-box;
+}
+
+/* ─── Body Defaults ────────────────────────────────────────── */
+html {
+  scroll-behavior: smooth;
+  -webkit-text-size-adjust: 100%;
+}
+
+body {
+  margin: 0;
+  padding: 0;
+  font-family: var(--ks-font-sans);
+  font-size: var(--ks-text-base);
+  line-height: var(--ks-leading-normal);
+  color: var(--ks-color-text);
+  background-color: var(--ks-color-bg);
+  -webkit-font-smoothing: antialiased;
+  -moz-osx-font-smoothing: grayscale;
+  transition:
+    background-color var(--ks-duration-normal) var(--ks-ease-out),
+    color var(--ks-duration-normal) var(--ks-ease-out);
+}
+
+/* ─── Links ────────────────────────────────────────────────── */
+a {
+  color: var(--ks-color-primary);
+  text-decoration: none;
+  transition: color var(--ks-duration-fast) var(--ks-ease-out);
+}
+
+a:hover {
+  color: var(--ks-color-primary-hover);
+}
+
+/* ─── Images ───────────────────────────────────────────────── */
+img {
+  max-width: 100%;
+  height: auto;
+  display: block;
+}
+
+/* ─── Buttons ──────────────────────────────────────────────── */
+button {
+  font-family: inherit;
+  font-size: inherit;
+  cursor: pointer;
+}
+
+/* ─── Code ─────────────────────────────────────────────────── */
+code,
+pre {
+  font-family: var(--ks-font-mono);
+}
+
+/* ─── Focus Visible ────────────────────────────────────────── */
+:focus-visible {
+  outline: 2px solid var(--ks-color-primary);
+  outline-offset: 2px;
+  border-radius: var(--ks-radius-sm);
+}
+
+/* ─── Selection ────────────────────────────────────────────── */
+::selection {
+  background-color: var(--ks-color-primary);
+  color: #ffffff;
+}
+
+/* ══════════════════════════════════════════════════════════════
+   kedhar-ui — Component Styles
+   ══════════════════════════════════════════════════════════════
+   Ripple, scroll-to-top, theme toggle, and other shared components.
+   Import tokens.css and base.css first.
+   ══════════════════════════════════════════════════════════════ */
+
+/* ══════════════════════════════════════════════════════════════
+   1. CSS Ripple Effect
+   ══════════════════════════════════════════════════════════════
+   Pure CSS — no JavaScript required.
+   Expands a circle from center on :active.
+   ══════════════════════════════════════════════════════════════ */
+.ks-ripple {
+  position: relative;
+  overflow: hidden;
+  cursor: pointer;
+  -webkit-tap-highlight-color: transparent;
+}
+
+.ks-ripple::after {
+  content: '';
+  position: absolute;
+  top: 50%;
+  left: 50%;
+  width: 0;
+  height: 0;
+  border-radius: 50%;
+  background: currentColor;
+  opacity: 0.15;
+  transform: translate(-50%, -50%);
+  pointer-events: none;
+  will-change: width, height, opacity;
+}
+
+.ks-ripple:active::after {
+  width: 300%;
+  height: 300%;
+  opacity: 0;
+  transition:
+    width 0.4s var(--ks-ease-out),
+    height 0.4s var(--ks-ease-out),
+    opacity 0.4s var(--ks-ease-out);
+}
+
+
+/* ══════════════════════════════════════════════════════════════
+   2. Scroll-to-Top Button
+   ══════════════════════════════════════════════════════════════
+   Requires JS to toggle .visible class.
+   ══════════════════════════════════════════════════════════════ */
+.ks-scroll-top {
+  position: fixed;
+  bottom: var(--ks-space-8);
+  right: var(--ks-space-8);
+  width: 44px;
+  height: 44px;
+  border-radius: var(--ks-radius-full);
+  border: none;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  cursor: pointer;
+  opacity: 0;
+  visibility: hidden;
+  transform: translateY(12px);
+  pointer-events: none;
+  z-index: var(--ks-z-sticky);
+  box-shadow: var(--ks-shadow-lg);
+  background: var(--ks-color-surface);
+  color: var(--ks-color-text-muted);
+  transition:
+    opacity var(--ks-duration-normal) var(--ks-ease-out),
+    visibility var(--ks-duration-normal) var(--ks-ease-out),
+    transform var(--ks-duration-normal) var(--ks-ease-out),
+    background var(--ks-duration-normal) var(--ks-ease-out),
+    color var(--ks-duration-normal) var(--ks-ease-out);
+  overflow: hidden;
+}
+
+.ks-scroll-top.visible {
+  opacity: 1;
+  visibility: visible;
+  transform: translateY(0);
+  pointer-events: auto;
+}
+
+.ks-scroll-top:hover {
+  background: var(--ks-color-surface-hover);
+  color: var(--ks-color-primary);
+  box-shadow: var(--ks-shadow-lg), 0 0 0 2px var(--ks-color-primary-alpha);
+}
+
+.ks-scroll-top svg {
+  width: 20px;
+  height: 20px;
+  stroke: currentColor;
+  fill: none;
+  stroke-width: 2;
+  stroke-linecap: round;
+  stroke-linejoin: round;
+}
+
+
+/* ══════════════════════════════════════════════════════════════
+   3. Theme Toggle (Light / Dark)
+   ══════════════════════════════════════════════════════════════
+   Animated pill switch with sun/moon icons on the knob.
+   ══════════════════════════════════════════════════════════════ */
+.ks-theme-toggle {
+  position: relative;
+  width: 56px;
+  height: 30px;
+  border-radius: var(--ks-radius-full);
+  border: 2px solid var(--ks-color-border);
+  background: var(--ks-color-surface);
+  cursor: pointer;
+  display: flex;
+  align-items: center;
+  padding: 0;
+  flex-shrink: 0;
+  transition:
+    background var(--ks-duration-normal) var(--ks-ease-spring),
+    border-color var(--ks-duration-normal) var(--ks-ease-out);
+  overflow: hidden;
+  -webkit-tap-highlight-color: transparent;
+}
+
+.ks-theme-toggle:hover {
+  border-color: var(--ks-color-primary);
+}
+
+/* Knob */
+.ks-toggle-knob {
+  position: absolute;
+  top: 2px;
+  left: 2px;
+  width: 22px;
+  height: 22px;
+  border-radius: var(--ks-radius-full);
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  transition:
+    transform var(--ks-duration-normal) var(--ks-ease-spring),
+    background var(--ks-duration-normal) var(--ks-ease-out);
+  z-index: 2;
+  background: var(--ks-color-primary);
+  color: #ffffff;
+  box-shadow: var(--ks-shadow-sm);
+}
+
+/* Dark position */
+.dark .ks-toggle-knob {
+  transform: translateX(26px);
+}
+
+/* Icons inside knob */
+.ks-toggle-knob svg {
+  width: 13px;
+  height: 13px;
+  fill: none;
+  stroke: currentColor;
+  stroke-width: 2;
+  stroke-linecap: round;
+  stroke-linejoin: round;
+  transition: transform var(--ks-duration-normal) var(--ks-ease-spring);
+}
+
+.dark .ks-toggle-knob svg {
+  transform: rotate(90deg);
+}
+
+/* Track background halves */
+.ks-toggle-track {
+  display: flex;
+  width: 100%;
+  height: 100%;
+}
+
+.ks-toggle-track span {
+  flex: 1;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  font-size: 12px;
+  color: var(--ks-color-text-muted);
+  transition: color var(--ks-duration-fast) var(--ks-ease-out);
+}
+
+.dark .ks-toggle-track span:first-child {
+  color: transparent;
+}
+
+.dark .ks-toggle-track span:last-child {
+  color: var(--ks-color-text-muted);
+}
+
+.ks-toggle-track span:first-child {
+  color: var(--ks-color-text-muted);
+}
+
+.ks-toggle-track span:last-child {
+  color: transparent;
+}
+
+
+/* ══════════════════════════════════════════════════════════════
+   4. Card
+   ══════════════════════════════════════════════════════════════
+   Reusable card component with consistent styling.
+   ══════════════════════════════════════════════════════════════ */
+.ks-card {
+  background: var(--ks-color-surface);
+  border: 1px solid var(--ks-color-border);
+  border-radius: var(--ks-radius-lg);
+  padding: var(--ks-space-6);
+  transition:
+    box-shadow var(--ks-duration-normal) var(--ks-ease-out),
+    border-color var(--ks-duration-normal) var(--ks-ease-out),
+    transform var(--ks-duration-normal) var(--ks-ease-out);
+}
+
+.ks-card:hover {
+  border-color: var(--ks-color-primary-alpha);
+  box-shadow: var(--ks-shadow-md);
+  transform: translateY(-2px);
+}
+
+
+/* ══════════════════════════════════════════════════════════════
+   5. Badge / Tag
+   ══════════════════════════════════════════════════════════════
+   Small label for status, tags, metadata.
+   ══════════════════════════════════════════════════════════════ */
+.ks-badge {
+  display: inline-flex;
+  align-items: center;
+  padding: 2px var(--ks-space-2);
+  border-radius: var(--ks-radius-sm);
+  font-size: var(--ks-text-xs);
+  font-weight: var(--ks-weight-medium);
+  line-height: 1.4;
+  background: var(--ks-color-surface-hover);
+  color: var(--ks-color-text-muted);
+  border: 1px solid var(--ks-color-border);
+}
+
+
+/* ══════════════════════════════════════════════════════════════
+   6. Section Container
+   ══════════════════════════════════════════════════════════════ */
+.ks-section {
+  padding: var(--ks-space-16) var(--ks-space-4);
+  max-width: var(--ks-max-width);
+  margin: 0 auto;
+}
+
+@media (min-width: 640px) {
+  .ks-section {
+    padding: var(--ks-space-20) var(--ks-space-6);
+  }
+}
+
+@media (min-width: 1024px) {
+  .ks-section {
+    padding: var(--ks-space-20) var(--ks-space-8);
+  }
+}
+
+
+/* ══════════════════════════════════════════════════════════════
+   7. Utility Classes
+   ══════════════════════════════════════════════════════════════ */
+.ks-sr-only {
+  position: absolute;
+  width: 1px;
+  height: 1px;
+  padding: 0;
+  margin: -1px;
+  overflow: hidden;
+  clip: rect(0, 0, 0, 0);
+  white-space: nowrap;
+  border: 0;
+}

package/dist/theme-amber.css

@@ -0,0 +1,37 @@
+/* kedhar-ui v0.1.0 — https://github.com/kedharsairam/kedhar-ui */
+
+/* ══════════════════════════════════════════════════════════════
+   Theme: Amber — Projects site
+   ══════════════════════════════════════════════════════════════ */
+
+:root {
+  --ks-color-primary:       #d97706;
+  --ks-color-primary-hover: #b45309;
+  --ks-color-primary-light: #fef3c7;
+  --ks-color-primary-dark:  #92400e;
+  --ks-color-primary-alpha: rgba(217, 119, 6, 0.15);
+
+  --ks-color-bg:             #faf8f5;
+  --ks-color-surface:        #ffffff;
+  --ks-color-surface-hover:  #f5f2ed;
+  --ks-color-border:         #e8e2d8;
+  --ks-color-text:           #1c1917;
+  --ks-color-text-muted:     #78716c;
+  --ks-color-text-inverse:   #ffffff;
+}
+
+.dark {
+  --ks-color-primary:       #f59e0b;
+  --ks-color-primary-hover: #d97706;
+  --ks-color-primary-light: #292524;
+  --ks-color-primary-dark:  #fbbf24;
+  --ks-color-primary-alpha: rgba(245, 158, 11, 0.15);
+
+  --ks-color-bg:             #0f0d0a;
+  --ks-color-surface:        #1c1917;
+  --ks-color-surface-hover:  #292524;
+  --ks-color-border:         #3f3a36;
+  --ks-color-text:           #f5f0eb;
+  --ks-color-text-muted:     #a8a29e;
+  --ks-color-text-inverse:   #0f0d0a;
+}

package/dist/theme-emerald.css

@@ -0,0 +1,37 @@
+/* kedhar-ui v0.1.0 — https://github.com/kedharsairam/kedhar-ui */
+
+/* ══════════════════════════════════════════════════════════════
+   Theme: Emerald — Blog site
+   ══════════════════════════════════════════════════════════════ */
+
+:root {
+  --ks-color-primary:       #059669;
+  --ks-color-primary-hover: #047857;
+  --ks-color-primary-light: #d1fae5;
+  --ks-color-primary-dark:  #065f46;
+  --ks-color-primary-alpha: rgba(5, 150, 105, 0.15);
+
+  --ks-color-bg:             #f4f9f7;
+  --ks-color-surface:        #ffffff;
+  --ks-color-surface-hover:  #edf5f1;
+  --ks-color-border:         #dce8e2;
+  --ks-color-text:           #0f1a16;
+  --ks-color-text-muted:     #6b7d76;
+  --ks-color-text-inverse:   #ffffff;
+}
+
+.dark {
+  --ks-color-primary:       #10b981;
+  --ks-color-primary-hover: #059669;
+  --ks-color-primary-light: #0a1f18;
+  --ks-color-primary-dark:  #34d399;
+  --ks-color-primary-alpha: rgba(16, 185, 129, 0.15);
+
+  --ks-color-bg:             #080f0c;
+  --ks-color-surface:        #111f19;
+  --ks-color-surface-hover:  #1a2f26;
+  --ks-color-border:         #2d4036;
+  --ks-color-text:           #e2f0e9;
+  --ks-color-text-muted:     #94a89e;
+  --ks-color-text-inverse:   #080f0c;
+}

package/dist/theme-indigo.css

@@ -0,0 +1,37 @@
+/* kedhar-ui v0.1.0 — https://github.com/kedharsairam/kedhar-ui */
+
+/* ══════════════════════════════════════════════════════════════
+   Theme: Indigo — Portfolio site
+   ══════════════════════════════════════════════════════════════ */
+
+:root {
+  --ks-color-primary:       #6366f1;
+  --ks-color-primary-hover: #4f46e5;
+  --ks-color-primary-light: #e0e7ff;
+  --ks-color-primary-dark:  #4338ca;
+  --ks-color-primary-alpha: rgba(99, 102, 241, 0.15);
+
+  --ks-color-bg:             #f8f9fc;
+  --ks-color-surface:        #ffffff;
+  --ks-color-surface-hover:  #f1f3f9;
+  --ks-color-border:         #e2e5f0;
+  --ks-color-text:           #1e1e2e;
+  --ks-color-text-muted:     #6b7280;
+  --ks-color-text-inverse:   #ffffff;
+}
+
+.dark {
+  --ks-color-primary:       #818cf8;
+  --ks-color-primary-hover: #6366f1;
+  --ks-color-primary-light: #1e1b4b;
+  --ks-color-primary-dark:  #a5b4fc;
+  --ks-color-primary-alpha: rgba(129, 140, 248, 0.15);
+
+  --ks-color-bg:             #0f0f1a;
+  --ks-color-surface:        #1a1a2e;
+  --ks-color-surface-hover:  #242440;
+  --ks-color-border:         #2d2d4a;
+  --ks-color-text:           #e2e4f0;
+  --ks-color-text-muted:     #9ca3af;
+  --ks-color-text-inverse:   #0f0f1a;
+}

package/dist/theme-slate.css

@@ -0,0 +1,37 @@
+/* kedhar-ui v0.1.0 — https://github.com/kedharsairam/kedhar-ui */
+
+/* ══════════════════════════════════════════════════════════════
+   Theme: Slate — mssql-scripts site (neutral / technical)
+   ══════════════════════════════════════════════════════════════ */
+
+:root {
+  --ks-color-primary:       #64748b;
+  --ks-color-primary-hover: #475569;
+  --ks-color-primary-light: #f1f5f9;
+  --ks-color-primary-dark:  #334155;
+  --ks-color-primary-alpha: rgba(100, 116, 139, 0.15);
+
+  --ks-color-bg:             #f8fafc;
+  --ks-color-surface:        #ffffff;
+  --ks-color-surface-hover:  #f1f5f9;
+  --ks-color-border:         #e2e8f0;
+  --ks-color-text:           #0f172a;
+  --ks-color-text-muted:     #64748b;
+  --ks-color-text-inverse:   #ffffff;
+}
+
+.dark {
+  --ks-color-primary:       #94a3b8;
+  --ks-color-primary-hover: #64748b;
+  --ks-color-primary-light: #1e293b;
+  --ks-color-primary-dark:  #cbd5e1;
+  --ks-color-primary-alpha: rgba(148, 163, 184, 0.15);
+
+  --ks-color-bg:             #0b1120;
+  --ks-color-surface:        #151d2b;
+  --ks-color-surface-hover:  #1e293b;
+  --ks-color-border:         #2d3748;
+  --ks-color-text:           #e2e8f0;
+  --ks-color-text-muted:     #94a3b8;
+  --ks-color-text-inverse:   #0b1120;
+}

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "kedhar-ui",
+  "version": "0.1.0",
+  "description": "Shared design system for Kedhar's projects — CSS tokens, components, and themes.",
+  "type": "module",
+  "main": "src/index.js",
+  "style": "dist/kedhar-ui.css",
+  "files": [
+    "src/",
+    "dist/"
+  ],
+  "scripts": {
+    "build": "node scripts/build.js",
+    "prepublishOnly": "npm run build",
+    "lint": "echo 'No linter configured yet'"
+  },
+  "keywords": [
+    "design-system",
+    "css",
+    "astro",
+    "kedhar-ui"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kedharsairam/kedhar-ui.git"
+  },
+  "bugs": {
+    "url": "https://github.com/kedharsairam/kedhar-ui/issues"
+  },
+  "homepage": "https://github.com/kedharsairam/kedhar-ui#readme"
+}

package/src/components/ScrollToTop.astro

@@ -0,0 +1,53 @@
+---
+/**
+ * ScrollToTop — Shared scroll-to-top button.
+ *
+ * Usage:
+ *   import ScrollToTop from '@kedharsairam/kedhar-ui/src/components/ScrollToTop.astro';
+ *   <ScrollToTop />
+ *
+ * Shows when user scrolls past threshold (default: 300px).
+ */
+
+import '../styles/components.css';
+---
+
+<button class="ks-scroll-top ks-ripple" id="ks-scroll-top" aria-label="Scroll to top" type="button">
+  <svg viewBox="0 0 24 24">
+    <polyline points="18 15 12 9 6 15" />
+  </svg>
+</button>
+
+<script>
+  (function () {
+    const btn = document.getElementById('ks-scroll-top');
+    if (!btn) return;
+
+    let visible = false;
+    const threshold = 300;
+
+    function onScroll() {
+      const shouldShow = window.scrollY > threshold;
+      if (shouldShow !== visible) {
+        visible = shouldShow;
+        btn.classList.toggle('visible', visible);
+      }
+    }
+
+    // Throttled scroll listener
+    let ticking = false;
+    window.addEventListener('scroll', () => {
+      if (!ticking) {
+        window.requestAnimationFrame(() => {
+          onScroll();
+          ticking = false;
+        });
+        ticking = true;
+      }
+    });
+
+    btn.addEventListener('click', () => {
+      window.scrollTo({ top: 0, behavior: 'smooth' });
+    });
+  })();
+</script>