astro-component-kit 0.3.1 → 0.4.0

package/src/components/lib/buttons/RippleButton.astro

@@ -0,0 +1,199 @@
+---
+/**
+ * RippleButton — Interactive button featuring an expanding click ripple effect with glass styling.
+ * 
+ * @param {'primary' | 'secondary' | 'ghost'} variant - Visual style variant. Default is 'primary'.
+ * @param {'sm' | 'md' | 'lg'} size - Button size variant. Default is 'md'.
+ * @param {string} href - Optional link destination.
+ * @param {boolean} disabled - Whether the button is disabled.
+ * @param {string} className - Additional CSS class names.
+ */
+interface Props {
+  variant?: 'primary' | 'secondary' | 'ghost';
+  size?: 'sm' | 'md' | 'lg';
+  href?: string;
+  disabled?: boolean;
+  className?: string;
+}
+
+const {
+  variant = 'primary',
+  size = 'md',
+  href,
+  disabled = false,
+  className = '',
+} = Astro.props;
+
+const Tag = href ? 'a' : 'button';
+---
+
+<Tag
+  href={href}
+  disabled={!href && disabled ? true : undefined}
+  aria-disabled={disabled ? 'true' : undefined}
+  class:list={['ripple-btn', `ripple-btn--${variant}`, `ripple-btn--${size}`, className]}
+  data-ripple-btn
+>
+  <span class="ripple-btn__label"><slot /></span>
+  <span class="ripple-btn__container" aria-hidden="true"></span>
+</Tag>
+
+<style>
+  .ripple-btn {
+    --btn-primary-bg: linear-gradient(135deg, rgba(184, 134, 11, 0.9), rgba(212, 160, 23, 0.9));
+    --btn-primary-color: #050505;
+    --btn-secondary-bg: rgba(255, 255, 255, 0.05);
+    --btn-secondary-color: var(--c-text-1, #ffffff);
+    --btn-ghost-bg: transparent;
+    --btn-ghost-color: var(--c-primary-light, #d4a017);
+
+    position: relative;
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+    overflow: hidden;
+    font-family: var(--font-sans, system-ui, sans-serif);
+    font-weight: 700;
+    text-decoration: none;
+    border-radius: var(--r-md, 12px);
+    border: 1px solid rgba(255, 255, 255, 0.1);
+    cursor: pointer;
+    user-select: none;
+    transition: transform 0.2s cubic-bezier(0.16, 1, 0.3, 1), box-shadow 0.2s ease, border-color 0.2s ease;
+  }
+
+  .ripple-btn:focus-visible {
+    outline: 2px solid var(--c-primary-light, #d4a017);
+    outline-offset: 3px;
+  }
+
+  .ripple-btn[disabled],
+  .ripple-btn[aria-disabled="true"] {
+    opacity: 0.5;
+    cursor: not-allowed;
+    pointer-events: none;
+  }
+
+  /* Variants */
+  .ripple-btn--primary {
+    background: var(--btn-primary-bg);
+    color: var(--btn-primary-color);
+    box-shadow: 0 4px 20px rgba(184, 134, 11, 0.25);
+  }
+  .ripple-btn--primary:hover {
+    transform: translateY(-2px);
+    box-shadow: 0 8px 30px rgba(184, 134, 11, 0.4);
+    border-color: rgba(254, 243, 199, 0.4);
+  }
+
+  .ripple-btn--secondary {
+    background: var(--btn-secondary-bg);
+    color: var(--btn-secondary-color);
+    backdrop-filter: blur(12px);
+  }
+  .ripple-btn--secondary:hover {
+    background: rgba(255, 255, 255, 0.09);
+    border-color: rgba(184, 134, 11, 0.3);
+    transform: translateY(-2px);
+  }
+
+  .ripple-btn--ghost {
+    background: var(--btn-ghost-bg);
+    color: var(--btn-ghost-color);
+    border-color: transparent;
+  }
+  .ripple-btn--ghost:hover {
+    background: rgba(184, 134, 11, 0.1);
+    border-color: rgba(184, 134, 11, 0.2);
+  }
+
+  /* Sizes */
+  .ripple-btn--sm {
+    padding: 0.45rem 1rem;
+    font-size: 0.8rem;
+    letter-spacing: 0.02em;
+  }
+  .ripple-btn--md {
+    padding: 0.75rem 1.6rem;
+    font-size: 0.92rem;
+    letter-spacing: 0.02em;
+  }
+  .ripple-btn--lg {
+    padding: 1rem 2.2rem;
+    font-size: 1.05rem;
+    letter-spacing: 0.03em;
+  }
+
+  .ripple-btn__label {
+    position: relative;
+    z-index: 2;
+    display: inline-flex;
+    align-items: center;
+    gap: var(--sp-2, 0.5rem);
+    pointer-events: none;
+  }
+
+  .ripple-btn__container {
+    position: absolute;
+    inset: 0;
+    z-index: 1;
+    overflow: hidden;
+    pointer-events: none;
+  }
+
+  :global(.ripple-effect) {
+    position: absolute;
+    border-radius: 50%;
+    transform: scale(0);
+    animation: ripple-grow 0.6s cubic-bezier(0, 0, 0.2, 1) forwards;
+    background: rgba(255, 255, 255, 0.35);
+    pointer-events: none;
+  }
+
+  @keyframes ripple-grow {
+    to {
+      transform: scale(4);
+      opacity: 0;
+    }
+  }
+
+  @media (prefers-reduced-motion: reduce) {
+    .ripple-btn { transition: none; }
+    :global(.ripple-effect) { display: none; }
+  }
+</style>
+
+<script>
+  function setupRipples() {
+    const buttons = document.querySelectorAll('[data-ripple-btn]');
+    buttons.forEach((btn) => {
+      if (btn.getAttribute('data-ripple-init')) return;
+      btn.setAttribute('data-ripple-init', 'true');
+
+      btn.addEventListener('pointerdown', (e: Event) => {
+        const mouseEvent = e as MouseEvent;
+        const target = mouseEvent.currentTarget as HTMLElement;
+        const container = target.querySelector('.ripple-btn__container');
+        if (!container) return;
+
+        const rect = target.getBoundingClientRect();
+        const size = Math.max(rect.width, rect.height);
+        const x = mouseEvent.clientX - rect.left - size / 2;
+        const y = mouseEvent.clientY - rect.top - size / 2;
+
+        const ripple = document.createElement('span');
+        ripple.className = 'ripple-effect';
+        ripple.style.width = `${size}px`;
+        ripple.style.height = `${size}px`;
+        ripple.style.left = `${x}px`;
+        ripple.style.top = `${y}px`;
+
+        container.appendChild(ripple);
+        setTimeout(() => ripple.remove(), 650);
+      });
+    });
+  }
+
+  setupRipples();
+  document.addEventListener('astro:page-load', setupRipples);
+</script>

package/src/components/lib/buttons/SlideRevealButton.astro

@@ -0,0 +1,159 @@
+---
+/**
+ * SlideRevealButton — Interactive action button with a sliding icon drawer and kinetic typography transition.
+ * 
+ * @param {'primary' | 'secondary' | 'accent'} variant - Visual tone variant. Default is 'primary'.
+ * @param {'sm' | 'md' | 'lg'} size - Button size variant. Default is 'md'.
+ * @param {string} href - Optional link destination.
+ * @param {string} icon - SVG or character icon. Default is '→'.
+ * @param {boolean} disabled - Whether the button is disabled.
+ * @param {string} className - Additional CSS class names.
+ */
+interface Props {
+  variant?: 'primary' | 'secondary' | 'accent';
+  size?: 'sm' | 'md' | 'lg';
+  href?: string;
+  icon?: string;
+  disabled?: boolean;
+  className?: string;
+}
+
+const {
+  variant = 'primary',
+  size = 'md',
+  href,
+  icon = '→',
+  disabled = false,
+  className = '',
+} = Astro.props;
+
+const Tag = href ? 'a' : 'button';
+---
+
+<Tag
+  href={href}
+  disabled={!href && disabled ? true : undefined}
+  aria-disabled={disabled ? 'true' : undefined}
+  class:list={['slide-reveal-btn', `slide-reveal-btn--${variant}`, `slide-reveal-btn--${size}`, className]}
+>
+  <span class="slide-reveal-btn__text">
+    <slot />
+  </span>
+  <span class="slide-reveal-btn__icon" aria-hidden="true">
+    {icon}
+  </span>
+</Tag>
+
+<style>
+  .slide-reveal-btn {
+    position: relative;
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+    overflow: hidden;
+    font-family: var(--font-sans, system-ui, sans-serif);
+    font-weight: 700;
+    text-decoration: none;
+    border-radius: var(--r-md, 12px);
+    border: 1px solid rgba(255, 255, 255, 0.12);
+    cursor: pointer;
+    user-select: none;
+    transition: all 0.3s cubic-bezier(0.25, 0.8, 0.25, 1);
+  }
+
+  .slide-reveal-btn:focus-visible {
+    outline: 2px solid var(--c-primary-light, #d4a017);
+    outline-offset: 3px;
+  }
+
+  .slide-reveal-btn[disabled],
+  .slide-reveal-btn[aria-disabled="true"] {
+    opacity: 0.5;
+    cursor: not-allowed;
+    pointer-events: none;
+  }
+
+  /* Variants */
+  .slide-reveal-btn--primary {
+    background: rgba(184, 134, 11, 0.15);
+    color: var(--c-accent, #fef3c7);
+    border-color: rgba(184, 134, 11, 0.35);
+  }
+  .slide-reveal-btn--primary:hover {
+    background: linear-gradient(135deg, #b8860b, #d4a017);
+    color: #050505;
+    box-shadow: 0 8px 24px rgba(184, 134, 11, 0.3);
+  }
+
+  .slide-reveal-btn--secondary {
+    background: rgba(255, 255, 255, 0.04);
+    color: var(--c-text-1, #ffffff);
+    backdrop-filter: blur(12px);
+  }
+  .slide-reveal-btn--secondary:hover {
+    background: rgba(255, 255, 255, 0.1);
+    border-color: rgba(255, 255, 255, 0.25);
+  }
+
+  .slide-reveal-btn--accent {
+    background: rgba(56, 189, 248, 0.12);
+    color: #7dd3fc;
+    border-color: rgba(56, 189, 248, 0.3);
+  }
+  .slide-reveal-btn--accent:hover {
+    background: #0284c7;
+    color: #ffffff;
+    box-shadow: 0 8px 24px rgba(56, 189, 248, 0.25);
+  }
+
+  /* Sizes */
+  .slide-reveal-btn--sm {
+    padding: 0.45rem 1.1rem;
+    font-size: 0.8rem;
+  }
+  .slide-reveal-btn--sm .slide-reveal-btn__icon {
+    font-size: 0.9rem;
+  }
+
+  .slide-reveal-btn--md {
+    padding: 0.75rem 1.6rem;
+    font-size: 0.92rem;
+  }
+  .slide-reveal-btn--md .slide-reveal-btn__icon {
+    font-size: 1.05rem;
+  }
+
+  .slide-reveal-btn--lg {
+    padding: 1rem 2.2rem;
+    font-size: 1.05rem;
+  }
+  .slide-reveal-btn--lg .slide-reveal-btn__icon {
+    font-size: 1.25rem;
+  }
+
+  /* Text & sliding icon */
+  .slide-reveal-btn__text {
+    display: inline-block;
+    transition: transform 0.3s cubic-bezier(0.2, 0.8, 0.2, 1);
+  }
+
+  .slide-reveal-btn__icon {
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+    position: absolute;
+    right: 1.2rem;
+    opacity: 0;
+    transform: translateX(-12px);
+    transition: transform 0.3s cubic-bezier(0.2, 0.8, 0.2, 1), opacity 0.25s ease;
+  }
+
+  .slide-reveal-btn:hover .slide-reveal-btn__text {
+    transform: translateX(-12px);
+  }
+
+  .slide-reveal-btn:hover .slide-reveal-btn__icon {
+    opacity: 1;
+    transform: translateX(0);
+  }
+</style>

package/src/components/lib/buttons/index.ts

@@ -19,4 +19,8 @@ export { default as RetroShadowButton } from './RetroShadowButton.astro';
 export { default as ShimmerButton } from './ShimmerButton.astro';
 export { default as ShinyButton } from './ShinyButton.astro';
 export { default as TiltGlowButton } from './TiltGlowButton.astro';
+export { default as NeonBorderButton } from './NeonBorderButton.astro';
+export { default as RippleButton } from './RippleButton.astro';
+export { default as SlideRevealButton } from './SlideRevealButton.astro';
 export { default as ThreeDPushButton } from './ThreeDPushButton.astro';
+

package/src/components/lib/cards/GithubRepoCard.astro

@@ -0,0 +1,176 @@
+---
+/**
+ * GithubRepoCard — Dark glass card highlighting repository statistics, language dot, license, and stars.
+ * 
+ * @param {string} repoName - Repository name (e.g. 'astro-components').
+ * @param {string} owner - Repo owner or organization (e.g. 'konstantinWDK').
+ * @param {string} description - Brief summary of the repo.
+ * @param {string} language - Primary programming language. Default is 'TypeScript'.
+ * @param {string} languageColor - Hex color for the language dot. Default is '#3178c6'.
+ * @param {number} stars - Star count figure. Default is 248.
+ * @param {number} forks - Fork count figure. Default is 32.
+ * @param {string} href - Link to the GitHub repository.
+ */
+interface Props {
+  repoName: string;
+  owner?: string;
+  description?: string;
+  language?: string;
+  languageColor?: string;
+  stars?: number;
+  forks?: number;
+  href?: string;
+}
+
+const {
+  repoName = 'astro-components',
+  owner = 'konstantinWDK',
+  description = 'Premium open-source UI component library for Astro with glassmorphism and accessibility.',
+  language = 'TypeScript',
+  languageColor = '#3178c6',
+  stars = 248,
+  forks = 32,
+  href = '#',
+} = Astro.props;
+---
+
+<a href={href} target="_blank" rel="noopener noreferrer" class="gh-repo-card">
+  <div class="gh-repo-card__head">
+    <svg class="gh-repo-card__icon" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+      <path d="M4 19.5v-15A2.5 2.5 0 0 1 6.5 2H20v20H6.5a2.5 2.5 0 0 1-2.5-2.5Z"/>
+      <path d="M6 6h10"/>
+      <path d="M6 10h10"/>
+    </svg>
+    <div class="gh-repo-card__title-wrap">
+      <span class="owner">{owner}/</span>
+      <h4 class="name">{repoName}</h4>
+    </div>
+    <span class="gh-repo-card__badge">Public</span>
+  </div>
+
+  <p class="gh-repo-card__desc">{description}</p>
+
+  <div class="gh-repo-card__meta">
+    <div class="gh-repo-card__lang">
+      <span class="lang-dot" style={`background-color: ${languageColor};`}></span>
+      <span>{language}</span>
+    </div>
+
+    <div class="gh-repo-card__stat">
+      <svg width="14" height="14" viewBox="0 0 24 24" fill="currentColor">
+        <polygon points="12 2 15.09 8.26 22 9.27 17 14.14 18.18 21.02 12 17.77 5.82 21.02 7 14.14 2 9.27 8.91 8.26 12 2"/>
+      </svg>
+      <span>{stars.toLocaleString()}</span>
+    </div>
+
+    <div class="gh-repo-card__stat">
+      <svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+        <line x1="6" y1="3" x2="6" y2="15"/>
+        <circle cx="18" cy="6" r="3"/>
+        <circle cx="6" cy="18" r="3"/>
+        <path d="M18 9a9 9 0 0 1-9 9"/>
+      </svg>
+      <span>{forks.toLocaleString()}</span>
+    </div>
+  </div>
+</a>
+
+<style>
+  .gh-repo-card {
+    display: flex;
+    flex-direction: column;
+    padding: var(--sp-6, 1.5rem);
+    background: rgba(255, 255, 255, 0.02);
+    backdrop-filter: blur(16px);
+    border: 1px solid rgba(255, 255, 255, 0.08);
+    border-radius: var(--r-xl, 20px);
+    text-decoration: none;
+    width: 100%;
+    max-width: 360px;
+    font-family: var(--font-sans, system-ui, sans-serif);
+    transition: transform 0.25s ease, border-color 0.25s ease, box-shadow 0.25s ease;
+  }
+
+  .gh-repo-card:hover {
+    transform: translateY(-3px);
+    border-color: rgba(184, 134, 11, 0.4);
+    box-shadow: 0 12px 32px rgba(0, 0, 0, 0.4);
+  }
+
+  .gh-repo-card__head {
+    display: flex;
+    align-items: center;
+    gap: 8px;
+    margin-bottom: 8px;
+  }
+
+  .gh-repo-card__icon {
+    color: var(--c-primary-light, #d4a017);
+    flex-shrink: 0;
+  }
+
+  .gh-repo-card__title-wrap {
+    display: flex;
+    align-items: baseline;
+    gap: 2px;
+    overflow: hidden;
+  }
+
+  .gh-repo-card__title-wrap .owner {
+    font-size: 0.82rem;
+    color: var(--c-text-3, #737373);
+  }
+
+  .gh-repo-card__title-wrap .name {
+    font-size: 0.95rem;
+    font-weight: 700;
+    color: var(--c-primary-light, #d4a017);
+    margin: 0;
+  }
+
+  .gh-repo-card__badge {
+    margin-left: auto;
+    font-size: 0.65rem;
+    font-weight: 700;
+    color: var(--c-text-2, #a3a3a3);
+    background: rgba(255, 255, 255, 0.06);
+    border: 1px solid rgba(255, 255, 255, 0.1);
+    padding: 2px 8px;
+    border-radius: var(--r-full, 9999px);
+  }
+
+  .gh-repo-card__desc {
+    font-size: 0.82rem;
+    color: var(--c-text-2, #a3a3a3);
+    margin: 0 0 16px 0;
+    line-height: 1.5;
+    flex: 1;
+  }
+
+  .gh-repo-card__meta {
+    display: flex;
+    align-items: center;
+    gap: 16px;
+    font-size: 0.78rem;
+    color: var(--c-text-3, #737373);
+  }
+
+  .gh-repo-card__lang {
+    display: flex;
+    align-items: center;
+    gap: 6px;
+  }
+
+  .lang-dot {
+    width: 10px;
+    height: 10px;
+    border-radius: 50%;
+  }
+
+  .gh-repo-card__stat {
+    display: flex;
+    align-items: center;
+    gap: 5px;
+    color: var(--c-text-2, #a3a3a3);
+  }
+</style>