kedhar-ui 0.1.0

package/README.md

@@ -0,0 +1,51 @@
+# kedhar-ui
+
+Shared design system for Kedhar's projects. CSS design tokens, base styles, component styles, per-site theme files, and reusable Astro components.
+
+```
+npm install @kedharsairam/kedhar-ui
+```
+
+## What's included
+
+- **Design tokens** — spacing scale, border radius, typography, shadows, transitions, z-index
+- **Base reset** — box-sizing, body defaults, link/button/image styling, focus-visible, selection
+- **Component styles** — CSS-only ripple effect, scroll-to-top button, theme toggle, card, badge, section container
+- **Per-site themes** — Indigo (portfolio), Amber (projects), Emerald (blog), Slate (mssql-scripts)
+- **Astro components** — ThemeToggle, ScrollToTop (import from `src/components/`)
+
+## Usage in Astro sites
+
+```astro
+---
+// Layout frontmatter
+import '@kedharsairam/kedhar-ui/src/styles/tokens.css';
+import '@kedharsairam/kedhar-ui/src/styles/base.css';
+import '@kedharsairam/kedhar-ui/src/styles/components.css';
+import '@kedharsairam/kedhar-ui/src/styles/themes/indigo.css';
+
+import ThemeToggle from '@kedharsairam/kedhar-ui/src/components/ThemeToggle.astro';
+import ScrollToTop from '@kedharsairam/kedhar-ui/src/components/ScrollToTop.astro';
+---
+
+<ThemeToggle />
+<ScrollToTop />
+```
+
+## Usage in plain HTML
+
+```html
+<link rel="stylesheet" href="https://unpkg.com/@kedharsairam/kedhar-ui/dist/kedhar-ui-slate.css">
+```
+
+## Development
+
+```bash
+npm install
+npm run build    # produces dist/ bundles
+npm publish      # publishes to npm (auto-runs build)
+```
+
+## License
+
+MIT

package/dist/kedhar-ui-amber.css

@@ -0,0 +1,487 @@
+/* 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;
+}
+
+/* ══════════════════════════════════════════════════════════════
+   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;
+}