@vanduo-oss/framework 1.3.5 → 1.3.7

package/README.md

@@ -1,4 +1,4 @@
-# Vanduo Framework v1.3.5
+# Vanduo Framework v1.3.7
 
 <p align="center">
   <img src="vanduo-banner.svg" alt="Vanduo Framework Banner" width="100%">
@@ -12,7 +12,7 @@
 
 **Essential just like water is.**
 
-Vanduo is a lightweight, zero-dependency UI framework built with pure HTML, CSS, and JavaScript. It ships 46+ components, responsive utilities, dark mode support, and a flexible theming system.
+Vanduo is a lightweight, zero-dependency UI framework built with pure HTML, CSS, and JavaScript. It ships 47+ components, responsive utilities, dark mode support, and a flexible theming system.
 
 [Browse Docs](https://vanduo.dev/#docs)
 
@@ -20,6 +20,7 @@ Vanduo is a lightweight, zero-dependency UI framework built with pure HTML, CSS,
 
 - Pure CSS/JS with no runtime dependencies
 - Modular architecture with optional per-component imports
+- 47+ components, including Expanding Cards and animated Timeline controls in v1.3.7
 - Built-in dark/light/system theme switching
 - Runtime Theme Customizer for color, font, and radius tokens
 - Accessibility-focused components and utilities
@@ -29,8 +30,8 @@ Vanduo is a lightweight, zero-dependency UI framework built with pure HTML, CSS,
 ### CDN (recommended)
 
 ```html
-<link rel="stylesheet" href="https://cdn.jsdelivr.net/gh/vanduo-oss/framework@v1.3.5/dist/vanduo.min.css">
-<script src="https://cdn.jsdelivr.net/gh/vanduo-oss/framework@v1.3.5/dist/vanduo.min.js"></script>
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/gh/vanduo-oss/framework@v1.3.7/dist/vanduo.min.css">
+<script src="https://cdn.jsdelivr.net/gh/vanduo-oss/framework@v1.3.7/dist/vanduo.min.js"></script>
 <script>Vanduo.init();</script>
 ```
 

package/css/components/cards.css

@@ -23,7 +23,7 @@
 
   /* Card Shadow */
   --card-shadow: var(--shadow-sm);
-  --card-shadow-elevated: var(--shadow-sm);
+  --card-shadow-elevated: var(--shadow-md);
 
   /* Card Glow Effect - uses primary color scale */
   --card-glow-color: var(--primary-2);
@@ -34,6 +34,8 @@
 [data-theme="dark"] {
   --card-bg: var(--bg-secondary);
   --card-bg-filled: var(--bg-primary);
+  /* Stronger elevation on dark surfaces */
+  --card-shadow-elevated: var(--shadow-lg);
   /* Glow uses lighter primary shades for dark mode visibility */
   --card-glow-color: var(--primary-3);
   --card-glow-border-color: var(--primary-4);
@@ -43,6 +45,7 @@
   :root:not([data-theme]) {
     --card-bg: var(--bg-secondary);
     --card-bg-filled: var(--bg-primary);
+    --card-shadow-elevated: var(--shadow-lg);
     /* Glow uses lighter primary shades for dark mode visibility */
     --card-glow-color: var(--primary-3);
     --card-glow-border-color: var(--primary-4);
@@ -75,6 +78,13 @@
 .vd-card-elevated,
 .vd-card {
   box-shadow: var(--card-shadow-elevated);
+  transition: box-shadow 0.2s ease, transform 0.2s ease;
+}
+
+/* Subtle lift on hover — skip links (they have their own hover) and non-elevated variants */
+.vd-card:not(a):not(.vd-card-outlined):not(.vd-card-filled):not(.vd-card-glass):not(.vd-card-glow):hover {
+  box-shadow: var(--shadow-lg);
+  transform: translateY(-1px);
 }
 
 /* Card Variants - Outlined */

package/css/components/datepicker.css

@@ -103,6 +103,14 @@
   background: var(--dp-day-hover-bg);
 }
 
+/* ========== Calendar grid (weekday row + week rows) ========== */
+
+.vd-datepicker-grid {
+  display: flex;
+  flex-direction: column;
+  gap: var(--dp-gap);
+}
+
 /* ========== Weekday Headers ========== */
 
 .vd-datepicker-weekdays {
@@ -118,7 +126,8 @@
 
 /* ========== Days Grid ========== */
 
-.vd-datepicker-days {
+.vd-datepicker-days,
+.vd-datepicker-row {
   display: grid;
   grid-template-columns: repeat(7, 1fr);
   gap: var(--dp-gap);

package/css/components/expanding-cards.css

@@ -0,0 +1,215 @@
+/**
+ * Vanduo Framework — Expanding flex cards
+ *
+ * Adapted from MIT-licensed CodePen "Expanding flex cards" by Zed Dash:
+ * https://codepen.io/z-/pen/OBPJKK
+ *
+ * Usage:
+ *   <div class="vd-expanding-cards" data-vd-expanding-cards>
+ *     <div class="vd-expanding-card is-active" style="--vd-expanding-card-bg: url(...)">
+ *       <div class="vd-expanding-card-shadow"></div>
+ *       <div class="vd-expanding-card-label">...</div>
+ *     </div>
+ *   </div>
+ */
+
+.vd-expanding-cards {
+  display: flex;
+  flex-direction: row;
+  align-items: stretch;
+  overflow: hidden;
+  min-width: 600px;
+  max-width: 900px;
+  width: calc(100% - 100px);
+  height: 400px;
+}
+
+.vd-expanding-card {
+  position: relative;
+  overflow: hidden;
+  min-width: 60px;
+  margin: 10px;
+  flex-grow: 1;
+  border-radius: 30px;
+  cursor: pointer;
+  background: var(--vd-expanding-card-bg, var(--vd-expanding-card-bg-default, #e6e9ed));
+  background-size: auto 120%;
+  background-position: center;
+  transition: 0.5s cubic-bezier(0.05, 0.61, 0.41, 0.95);
+}
+
+.vd-expanding-card:nth-child(1) {
+  --vd-expanding-card-bg-default: #ed5565;
+}
+
+.vd-expanding-card:nth-child(2) {
+  --vd-expanding-card-bg-default: #fc6e51;
+}
+
+.vd-expanding-card:nth-child(3) {
+  --vd-expanding-card-bg-default: #ffce54;
+}
+
+.vd-expanding-card:nth-child(4) {
+  --vd-expanding-card-bg-default: #2ecc71;
+}
+
+.vd-expanding-card:nth-child(5) {
+  --vd-expanding-card-bg-default: #5d9cec;
+}
+
+.vd-expanding-card:nth-child(6) {
+  --vd-expanding-card-bg-default: #ac92ec;
+}
+
+.vd-expanding-card.is-active {
+  flex-grow: 10000;
+  transform: scale(1);
+  max-width: 600px;
+  margin: 0;
+  border-radius: 40px;
+  background-size: auto 100%;
+}
+
+.vd-expanding-card.is-active .vd-expanding-card-shadow {
+  box-shadow:
+    inset 0 -120px 120px -120px black,
+    inset 0 -120px 120px -100px black;
+}
+
+.vd-expanding-card.is-active .vd-expanding-card-label {
+  bottom: 20px;
+  left: 20px;
+}
+
+.vd-expanding-card.is-active .vd-expanding-card-info > div {
+  left: 0;
+  opacity: 1;
+}
+
+.vd-expanding-card:not(.is-active) {
+  flex-grow: 1;
+  border-radius: 30px;
+}
+
+.vd-expanding-card:not(.is-active) .vd-expanding-card-shadow {
+  bottom: -40px;
+  box-shadow:
+    inset 0 -120px 0 -120px black,
+    inset 0 -120px 0 -100px black;
+}
+
+.vd-expanding-card:not(.is-active) .vd-expanding-card-label {
+  bottom: 10px;
+  left: 10px;
+}
+
+.vd-expanding-card:not(.is-active) .vd-expanding-card-info > div {
+  left: 20px;
+  opacity: 0;
+}
+
+.vd-expanding-card-shadow {
+  position: absolute;
+  bottom: 0;
+  left: 0;
+  right: 0;
+  height: 120px;
+  transition: 0.5s cubic-bezier(0.05, 0.61, 0.41, 0.95);
+}
+
+.vd-expanding-card-label {
+  display: flex;
+  position: absolute;
+  right: 0;
+  height: 40px;
+  transition: 0.5s cubic-bezier(0.05, 0.61, 0.41, 0.95);
+}
+
+.vd-expanding-card-icon {
+  display: flex;
+  flex-direction: row;
+  justify-content: center;
+  align-items: center;
+  min-width: 40px;
+  max-width: 40px;
+  height: 40px;
+  border-radius: 100%;
+  background-color: #fff;
+  color: var(--vd-expanding-card-bg-default, var(--color-primary, #3b82f6));
+}
+
+.vd-expanding-card-info {
+  display: flex;
+  flex-direction: column;
+  justify-content: center;
+  margin-left: 10px;
+  color: #fff;
+  white-space: pre;
+}
+
+.vd-expanding-card-info > div {
+  position: relative;
+  transition:
+    0.5s cubic-bezier(0.05, 0.61, 0.41, 0.95),
+    opacity 0.5s ease-out;
+}
+
+.vd-expanding-card-title {
+  font-weight: bold;
+  font-size: 1.2rem;
+}
+
+.vd-expanding-card-subtitle {
+  transition-delay: 0.1s;
+}
+
+/* Progressive hide: narrow viewports hide rightmost cards (matches original) */
+@media screen and (max-width: 718px) {
+  .vd-expanding-cards {
+    min-width: 520px;
+  }
+
+  .vd-expanding-card:nth-child(5) {
+    display: none;
+  }
+}
+
+@media screen and (max-width: 638px) {
+  .vd-expanding-cards {
+    min-width: 440px;
+  }
+
+  .vd-expanding-card:nth-child(4) {
+    display: none;
+  }
+}
+
+@media screen and (max-width: 558px) {
+  .vd-expanding-cards {
+    min-width: 360px;
+  }
+
+  .vd-expanding-card:nth-child(3) {
+    display: none;
+  }
+}
+
+@media screen and (max-width: 478px) {
+  .vd-expanding-cards {
+    min-width: 280px;
+  }
+
+  .vd-expanding-card:nth-child(2) {
+    display: none;
+  }
+}
+
+@media (prefers-reduced-motion: reduce) {
+  .vd-expanding-card,
+  .vd-expanding-card-shadow,
+  .vd-expanding-card-label,
+  .vd-expanding-card-info > div {
+    transition: none !important;
+  }
+}

package/css/components/spotlight.css

@@ -9,9 +9,11 @@
   --spotlight-tooltip-color: var(--text-primary, #212529);
   --spotlight-tooltip-shadow: 0 0.5rem 1.3125rem rgba(0, 0, 0, 0.15);
   --spotlight-tooltip-padding: 1.3125rem; /* 21px - fib */
-  --spotlight-tooltip-radius: var(--border-radius, 0.5rem);
+  --spotlight-tooltip-radius: var(--card-border-radius, var(--btn-border-radius-lg, 0.5rem));
   --spotlight-tooltip-max-width: 21rem; /* 336px - fib×16 */
   --spotlight-highlight-padding: 0.5rem; /* 8px - fib */
+  /* Match card/modal surfaces so the cutout reads like other rounded UI (not the smaller base button token). */
+  --spotlight-target-radius: var(--card-border-radius, var(--btn-border-radius-lg, var(--btn-border-radius, 0.25rem)));
   --spotlight-z-index: 1080;
 }
 
@@ -87,7 +89,7 @@
 .vd-spotlight-btn {
   padding: 0.3125rem 0.8125rem; /* 5px 13px - fib */
   border: 1px solid var(--border-color, #dee2e6);
-  border-radius: 0.25rem;
+  border-radius: var(--btn-border-radius-sm, 0.25rem);
   background: transparent;
   cursor: pointer;
   font-size: 0.8125rem;
@@ -113,7 +115,10 @@
 .vd-spotlight-target {
   position: relative;
   z-index: calc(var(--spotlight-z-index) + 1);
+  isolation: isolate;
+  overflow: visible;
+  /* box-shadow cutout follows border-radius; !important wins over consumer utilities (e.g. docs demos) */
+  border-radius: var(--spotlight-target-radius) !important;
   box-shadow: 0 0 0 var(--spotlight-highlight-padding) rgba(13, 110, 253, 0.25),
               0 0 0 9999px var(--spotlight-overlay-bg);
-  border-radius: 0.25rem;
 }

package/css/components/timeline.css

@@ -199,3 +199,50 @@
     right: auto;
   }
 }
+
+/* ========== Animated reveal (opt-in) ========== */
+
+.vd-timeline-animated .vd-timeline-item {
+  opacity: 0;
+  transform: translateY(12px);
+  transition:
+    opacity 0.55s ease,
+    transform 0.55s cubic-bezier(0.2, 0.8, 0.35, 1);
+  transition-delay: var(--vd-timeline-reveal-delay, 0s);
+}
+
+.vd-timeline-animated .vd-timeline-item .vd-timeline-marker {
+  transform: scale(0.4);
+  transform-origin: center center;
+  transition: transform 0.45s cubic-bezier(0.34, 1.56, 0.64, 1);
+  transition-delay: calc(var(--vd-timeline-reveal-delay, 0s) + 0.12s);
+}
+
+.vd-timeline-animated .vd-timeline-item.is-revealed {
+  opacity: 1;
+  transform: none;
+}
+
+.vd-timeline-animated .vd-timeline-item.is-revealed .vd-timeline-marker {
+  transform: scale(1);
+}
+
+/* Alternating + animated: entrance from each side (desktop only; narrow uses base vertical slide) */
+@media (min-width: 769px) {
+  .vd-timeline-alternating.vd-timeline-animated .vd-timeline-item:nth-child(odd):not(.is-revealed) {
+    transform: translate(-12px, 12px);
+  }
+
+  .vd-timeline-alternating.vd-timeline-animated .vd-timeline-item:nth-child(even):not(.is-revealed) {
+    transform: translate(12px, 12px);
+  }
+}
+
+@media (prefers-reduced-motion: reduce) {
+  .vd-timeline-animated .vd-timeline-item,
+  .vd-timeline-animated .vd-timeline-item .vd-timeline-marker {
+    opacity: 1;
+    transform: none;
+    transition: none;
+  }
+}

package/css/effects/morph.css

@@ -171,18 +171,6 @@
   }
 }
 
-/* ========== Completion Bounce ========== */
-
-.vd-morph.morph-done {
-  animation: vd-morph-bounce 0.32s cubic-bezier(0.34, 1.56, 0.64, 1);
-}
-
-@keyframes vd-morph-bounce {
-  0%   { transform: scale(0.97); }
-  60%  { transform: scale(1.025); }
-  100% { transform: scale(1); }
-}
-
 /* ========== Content Layers ========== */
 
 .vd-morph-content {

package/css/vanduo.css

@@ -29,6 +29,7 @@
 @import url('components/buttons.css');
 @import url('components/forms.css');
 @import url('components/cards.css');
+@import url('components/expanding-cards.css');
 
 /* Components - Phase 3 */
 @import url('components/navbar.css');

package/dist/build-info.json

@@ -1,6 +1,6 @@
 {
-  "version": "1.3.5",
-  "builtAt": "2026-04-15T18:39:53.955Z",
-  "commit": "3ca4f62",
+  "version": "1.3.7",
+  "builtAt": "2026-04-18T12:05:32.603Z",
+  "commit": "20b2d08",
   "mode": "development+production"
 }