@vanduo-oss/framework 1.2.6 → 1.2.7

package/README.md

@@ -1,4 +1,4 @@
-# Vanduo Framework v1.2.6
+# Vanduo Framework v1.2.7
 
 <p align="center">
   <img src="vanduo-banner.svg" alt="Vanduo Framework Banner" width="100%">
@@ -19,7 +19,7 @@
 
 ## Overview
 
-A lightweight, pure HTML/CSS/JS framework for designing beautiful interfaces. Zero runtime dependencies, no mandatory build tools, just clean and simple code.
+A lightweight, pure HTML/CSS/JS framework with **45+ components** for designing beautiful interfaces. Zero runtime dependencies, no mandatory build tools, just clean and simple code.
 
 [**Browse Full Documentation →**](https://vanduo.dev/#docs)
 
@@ -37,6 +37,32 @@ A lightweight, pure HTML/CSS/JS framework for designing beautiful interfaces. Ze
 
 ---
 
+## What's New in v1.2.7
+
+v1.2.7 adds **17 new components**, bringing the total to **45+**. Each component ships with dedicated CSS, JavaScript (where applicable), full Playwright test coverage, and comprehensive documentation.
+
+| Component | Vanduo Name | Type |
+|---|---|---|
+| Carousel | Flow | CSS + JS |
+| Popover | Bubble | CSS + JS |
+| Scrollspy | Waypoint | CSS + JS |
+| Offcanvas | — (enhanced Sidenav) | CSS + JS |
+| Ripple / Waves | Ripple | CSS + JS |
+| Floating Action Button | FAB | CSS-only |
+| Sticky | Affix | CSS + JS |
+| Autocomplete | Suggest | CSS + JS |
+| Form Validation | Validate | JS |
+| Date Picker | Datepicker | CSS + JS |
+| Time Picker | Timepicker | CSS + JS |
+| Stepper | Stepper | CSS + JS |
+| Timeline | Timeline | CSS-only |
+| Rating | Rating | CSS + JS |
+| Transfer / Multi-select | Transfer | CSS + JS |
+| Tree View | Tree | CSS + JS |
+| Spotlight / Feature Discovery | Spotlight | CSS + JS |
+
+---
+
 ## Quick Start
 
 ### Option 1: CDN (Recommended)
@@ -54,8 +80,8 @@ The quickest way to get started — no install, no build step. Add two lines to
 
 **Pin to a specific version** for production:
 ```html
-<link rel="stylesheet" href="https://cdn.jsdelivr.net/gh/vanduo-oss/framework@v1.2.5/dist/vanduo.min.css">
-<script src="https://cdn.jsdelivr.net/gh/vanduo-oss/framework@v1.2.5/dist/vanduo.min.js"></script>
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/gh/vanduo-oss/framework@v1.2.7/dist/vanduo.min.css">
+<script src="https://cdn.jsdelivr.net/gh/vanduo-oss/framework@v1.2.7/dist/vanduo.min.js"></script>
 <script>Vanduo.init();</script>
 ```
 
@@ -118,7 +144,7 @@ This project includes an [`llms.txt`](llms.txt) file — a structured markdown s
 Use the hardened upload script to attach only approved bundle artifacts from `dist/`:
 
 ```bash
-pnpm run release:assets -- v1.2.5
+pnpm run release:assets -- v1.2.7
 ```
 
 Notes:

package/css/components/affix.css

@@ -0,0 +1,53 @@
+/**
+ * Vanduo Framework - Affix (Sticky)
+ * Scroll-aware sticky positioning with is-stuck state
+ * Primary: .vd-affix | Alias: .vd-sticky
+ */
+
+:root {
+  --affix-top-offset: 0;
+  --affix-shadow: 0 2px 8px rgba(0, 0, 0, 0.1);
+  --affix-transition: box-shadow 0.2s ease, background-color 0.2s ease;
+  --affix-z-index: 1020;
+}
+
+[data-theme="dark"] {
+  --affix-shadow: 0 2px 8px rgba(0, 0, 0, 0.3);
+}
+
+@media (prefers-color-scheme: dark) {
+  :root:not([data-theme]) {
+    --affix-shadow: 0 2px 8px rgba(0, 0, 0, 0.3);
+  }
+}
+
+/* ========== Base ========== */
+
+.vd-affix,
+.vd-sticky,
+[data-vd-affix] {
+  position: sticky;
+  top: var(--affix-top-offset);
+  transition: var(--affix-transition);
+  z-index: calc(var(--affix-z-index) - 1);
+}
+
+/* ========== Stuck State ========== */
+
+.vd-affix.is-stuck,
+.vd-sticky.is-stuck,
+[data-vd-affix].is-stuck {
+  z-index: var(--affix-z-index);
+  box-shadow: var(--affix-shadow);
+}
+
+/* ========== Variants ========== */
+
+.vd-affix-no-shadow.is-stuck {
+  box-shadow: none;
+}
+
+.vd-affix-bordered.is-stuck {
+  box-shadow: none;
+  border-bottom: 1px solid var(--border-color, #dee2e6);
+}

package/css/components/bubble.css

@@ -0,0 +1,165 @@
+/**
+ * Vanduo Framework - Bubble (Popover)
+ * Click-triggered rich content popover
+ * Primary: .vd-bubble | Alias: .vd-popover
+ */
+
+:root {
+  /* Bubble Colors */
+  --bubble-bg: var(--card-bg, #fff);
+  --bubble-text: var(--text-primary, #212529);
+  --bubble-border-color: var(--border-color, #dee2e6);
+  --bubble-shadow: 0 0.5rem 1.3125rem rgba(0, 0, 0, 0.12); /* 8px 21px - fib */
+
+  /* Bubble Spacing (Fibonacci) */
+  --bubble-padding: 0.8125rem; /* 13px - fib */
+  --bubble-header-padding: 0.5rem 0.8125rem; /* 8px 13px */
+  --bubble-arrow-size: 8px; /* fib */
+
+  /* Bubble Sizing */
+  --bubble-max-width: 21rem; /* 336px - fib×16 */
+  --bubble-min-width: 8rem;
+  --bubble-border-radius: var(--border-radius, 0.5rem);
+
+  /* Bubble Z-index */
+  --bubble-z-index: 1060;
+
+  /* Bubble Font */
+  --bubble-font-size: var(--font-size-sm, 0.875rem);
+}
+
+/* Dark Theme */
+[data-theme="dark"] {
+  --bubble-bg: var(--card-bg, #2d2d44);
+  --bubble-border-color: var(--border-color, #3d3d5c);
+  --bubble-shadow: 0 0.5rem 1.3125rem rgba(0, 0, 0, 0.3);
+}
+
+@media (prefers-color-scheme: dark) {
+  :root:not([data-theme]) {
+    --bubble-bg: var(--card-bg, #2d2d44);
+    --bubble-border-color: var(--border-color, #3d3d5c);
+    --bubble-shadow: 0 0.5rem 1.3125rem rgba(0, 0, 0, 0.3);
+  }
+}
+
+/* ========== Base ========== */
+
+.vd-bubble-content,
+.vd-popover-content {
+  position: absolute;
+  z-index: var(--bubble-z-index);
+  max-width: var(--bubble-max-width);
+  min-width: var(--bubble-min-width);
+  background: var(--bubble-bg);
+  color: var(--bubble-text);
+  border: 1px solid var(--bubble-border-color);
+  border-radius: var(--bubble-border-radius);
+  box-shadow: var(--bubble-shadow);
+  font-size: var(--bubble-font-size);
+  opacity: 0;
+  visibility: hidden;
+  transition: opacity 0.2s ease, visibility 0.2s ease, transform 0.2s ease;
+  transform: scale(0.95);
+  pointer-events: none;
+}
+
+.vd-bubble-content.is-visible,
+.vd-popover-content.is-visible {
+  opacity: 1;
+  visibility: visible;
+  transform: scale(1);
+  pointer-events: auto;
+}
+
+/* ========== Header ========== */
+
+.vd-bubble-header {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  padding: var(--bubble-header-padding);
+  border-bottom: 1px solid var(--bubble-border-color);
+  font-weight: 600;
+}
+
+/* ========== Body ========== */
+
+.vd-bubble-body {
+  padding: var(--bubble-padding);
+}
+
+/* ========== Close Button ========== */
+
+.vd-bubble-close {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  width: 1.5rem;
+  height: 1.5rem;
+  padding: 0;
+  margin-left: 0.5rem;
+  border: none;
+  border-radius: 50%;
+  background: transparent;
+  color: var(--bubble-text);
+  font-size: 1.125rem;
+  line-height: 1;
+  cursor: pointer;
+  opacity: 0.5;
+  transition: opacity 0.15s ease;
+}
+
+.vd-bubble-close:hover { opacity: 1; }
+
+/* ========== Arrow ========== */
+
+.vd-bubble-content::before,
+.vd-popover-content::before {
+  content: '';
+  position: absolute;
+  width: 0;
+  height: 0;
+  border: var(--bubble-arrow-size) solid transparent;
+}
+
+/* Arrow: top placement (popover below trigger) */
+.vd-bubble-content[data-placement="bottom"]::before {
+  bottom: 100%;
+  left: 50%;
+  transform: translateX(-50%);
+  border-bottom-color: var(--bubble-border-color);
+}
+
+.vd-bubble-content[data-placement="top"]::before {
+  top: 100%;
+  left: 50%;
+  transform: translateX(-50%);
+  border-top-color: var(--bubble-border-color);
+}
+
+.vd-bubble-content[data-placement="left"]::before {
+  left: 100%;
+  top: 50%;
+  transform: translateY(-50%);
+  border-left-color: var(--bubble-border-color);
+}
+
+.vd-bubble-content[data-placement="right"]::before {
+  right: 100%;
+  top: 50%;
+  transform: translateY(-50%);
+  border-right-color: var(--bubble-border-color);
+}
+
+/* ========== Size Variants ========== */
+
+.vd-bubble-sm .vd-bubble-body {
+  --bubble-padding: 0.5rem; /* 8px - fib */
+  --bubble-font-size: var(--font-size-xs, 0.75rem);
+}
+
+.vd-bubble-lg .vd-bubble-body {
+  --bubble-padding: 1.3125rem; /* 21px - fib */
+  --bubble-max-width: 34rem;
+}

package/css/components/datepicker.css

@@ -0,0 +1,216 @@
+/**
+ * Vanduo Framework - Datepicker
+ * Calendar popup for date selection
+ */
+
+:root {
+  /* Datepicker Colors */
+  --dp-bg: var(--card-bg, #fff);
+  --dp-border-color: var(--border-color, #dee2e6);
+  --dp-shadow: 0 0.25rem 0.8125rem rgba(0, 0, 0, 0.12); /* 4px 13px fib */
+  --dp-header-bg: var(--color-primary, #0d6efd);
+  --dp-header-color: #fff;
+  --dp-day-hover-bg: var(--bg-secondary, #f8f9fa);
+  --dp-day-selected-bg: var(--color-primary, #0d6efd);
+  --dp-day-selected-color: #fff;
+  --dp-day-today-color: var(--color-primary, #0d6efd);
+  --dp-day-outside-color: var(--text-muted, #6c757d);
+  --dp-day-disabled-color: var(--text-disabled, #adb5bd);
+
+  /* Datepicker Spacing (Fibonacci) */
+  --dp-padding: 0.5rem;        /* 8px - fib */
+  --dp-cell-size: 2.25rem;     /* 36px */
+  --dp-gap: 2px;
+  --dp-border-radius: var(--border-radius, 0.5rem);
+
+  /* Datepicker Z-index */
+  --dp-z-index: 1055;
+}
+
+[data-theme="dark"] {
+  --dp-bg: var(--card-bg, #2d2d44);
+  --dp-border-color: var(--border-color, #3d3d5c);
+  --dp-day-hover-bg: var(--bg-primary, #1a1a2e);
+  --dp-shadow: 0 0.25rem 0.8125rem rgba(0, 0, 0, 0.3);
+}
+
+@media (prefers-color-scheme: dark) {
+  :root:not([data-theme]) {
+    --dp-bg: var(--card-bg, #2d2d44);
+    --dp-border-color: var(--border-color, #3d3d5c);
+    --dp-day-hover-bg: var(--bg-primary, #1a1a2e);
+    --dp-shadow: 0 0.25rem 0.8125rem rgba(0, 0, 0, 0.3);
+  }
+}
+
+/* ========== Calendar Popup ========== */
+
+.vd-datepicker-popup {
+  position: absolute;
+  z-index: var(--dp-z-index);
+  background: var(--dp-bg);
+  border: 1px solid var(--dp-border-color);
+  border-radius: var(--dp-border-radius);
+  box-shadow: var(--dp-shadow);
+  padding: var(--dp-padding);
+  display: none;
+  min-width: 17rem;
+}
+
+.vd-datepicker-popup.is-open {
+  display: block;
+}
+
+/* ========== Header ========== */
+
+.vd-datepicker-header {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  padding: 0.3125rem; /* 5px - fib */
+  margin-bottom: 0.3125rem;
+}
+
+.vd-datepicker-title {
+  font-weight: 600;
+  font-size: var(--font-size-base, 1rem);
+  cursor: pointer;
+}
+
+.vd-datepicker-title:hover {
+  color: var(--dp-day-today-color);
+}
+
+.vd-datepicker-prev,
+.vd-datepicker-next {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  width: 1.75rem;
+  height: 1.75rem;
+  padding: 0;
+  border: none;
+  border-radius: 50%;
+  background: transparent;
+  cursor: pointer;
+  font-size: 1rem;
+  color: var(--text-primary, #212529);
+  transition: background 0.15s ease;
+}
+
+.vd-datepicker-prev:hover,
+.vd-datepicker-next:hover {
+  background: var(--dp-day-hover-bg);
+}
+
+/* ========== Weekday Headers ========== */
+
+.vd-datepicker-weekdays {
+  display: grid;
+  grid-template-columns: repeat(7, 1fr);
+  gap: var(--dp-gap);
+  text-align: center;
+  font-size: 0.75rem;
+  font-weight: 600;
+  color: var(--text-muted, #6c757d);
+  padding-bottom: 0.25rem;
+}
+
+/* ========== Days Grid ========== */
+
+.vd-datepicker-days {
+  display: grid;
+  grid-template-columns: repeat(7, 1fr);
+  gap: var(--dp-gap);
+}
+
+.vd-datepicker-day {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  width: var(--dp-cell-size);
+  height: var(--dp-cell-size);
+  border: none;
+  border-radius: 50%;
+  background: transparent;
+  cursor: pointer;
+  font-size: 0.875rem;
+  transition: background 0.15s ease, color 0.15s ease;
+  padding: 0;
+}
+
+.vd-datepicker-day:hover {
+  background: var(--dp-day-hover-bg);
+}
+
+.vd-datepicker-day.is-today {
+  color: var(--dp-day-today-color);
+  font-weight: 700;
+}
+
+.vd-datepicker-day.is-selected {
+  background: var(--dp-day-selected-bg);
+  color: var(--dp-day-selected-color);
+  font-weight: 600;
+}
+
+.vd-datepicker-day.is-outside {
+  color: var(--dp-day-outside-color);
+}
+
+.vd-datepicker-day.is-disabled {
+  color: var(--dp-day-disabled-color);
+  cursor: not-allowed;
+  pointer-events: none;
+}
+
+/* ========== Range ========== */
+
+.vd-datepicker-day.is-range-start {
+  border-radius: 50% 0 0 50%;
+  background: var(--dp-day-selected-bg);
+  color: var(--dp-day-selected-color);
+}
+
+.vd-datepicker-day.is-range-end {
+  border-radius: 0 50% 50% 0;
+  background: var(--dp-day-selected-bg);
+  color: var(--dp-day-selected-color);
+}
+
+.vd-datepicker-day.is-in-range {
+  background: rgba(13, 110, 253, 0.1);
+  border-radius: 0;
+}
+
+/* ========== Month/Year Picker ========== */
+
+.vd-datepicker-months,
+.vd-datepicker-years {
+  display: grid;
+  grid-template-columns: repeat(3, 1fr);
+  gap: 0.25rem;
+  padding: 0.25rem;
+}
+
+.vd-datepicker-month-btn,
+.vd-datepicker-year-btn {
+  padding: 0.5rem;
+  border: none;
+  border-radius: var(--dp-border-radius);
+  background: transparent;
+  cursor: pointer;
+  text-align: center;
+  transition: background 0.15s ease;
+}
+
+.vd-datepicker-month-btn:hover,
+.vd-datepicker-year-btn:hover {
+  background: var(--dp-day-hover-bg);
+}
+
+.vd-datepicker-month-btn.is-selected,
+.vd-datepicker-year-btn.is-selected {
+  background: var(--dp-day-selected-bg);
+  color: var(--dp-day-selected-color);
+}

package/css/components/fab.css

@@ -0,0 +1,225 @@
+/**
+ * Vanduo Framework - FAB (Floating Action Button)
+ * Elevated circular action button with optional fixed positioning and speed-dial menu
+ */
+
+:root {
+  /* FAB Dimensions (Fibonacci) */
+  --fab-size: 3.5rem;           /* 56px */
+  --fab-size-sm: 2.5rem;        /* 40px */
+  --fab-size-lg: 4.5rem;        /* 72px */
+  --fab-icon-size: 1.5rem;
+
+  /* FAB Colors */
+  --fab-bg: var(--color-primary, #0d6efd);
+  --fab-color: #fff;
+  --fab-hover-bg: var(--color-primary-dark, #0b5ed7);
+  --fab-shadow: 0 3px 8px rgba(0, 0, 0, 0.25), 0 1px 3px rgba(0, 0, 0, 0.15);
+  --fab-hover-shadow: 0 5px 13px rgba(0, 0, 0, 0.3), 0 2px 5px rgba(0, 0, 0, 0.2);
+
+  /* FAB Position */
+  --fab-offset: 1.3125rem;      /* 21px - fib */
+  --fab-z-index: 1030;
+
+  /* FAB Menu */
+  --fab-menu-gap: 0.8125rem;    /* 13px - fib */
+}
+
+[data-theme="dark"] {
+  --fab-shadow: 0 3px 8px rgba(0, 0, 0, 0.5), 0 1px 3px rgba(0, 0, 0, 0.3);
+  --fab-hover-shadow: 0 5px 13px rgba(0, 0, 0, 0.6), 0 2px 5px rgba(0, 0, 0, 0.35);
+}
+
+@media (prefers-color-scheme: dark) {
+  :root:not([data-theme]) {
+    --fab-shadow: 0 3px 8px rgba(0, 0, 0, 0.5), 0 1px 3px rgba(0, 0, 0, 0.3);
+    --fab-hover-shadow: 0 5px 13px rgba(0, 0, 0, 0.6), 0 2px 5px rgba(0, 0, 0, 0.35);
+  }
+}
+
+/* ========== Base ========== */
+
+.vd-fab {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  width: var(--fab-size);
+  height: var(--fab-size);
+  padding: 0;
+  border: none;
+  border-radius: 50%;
+  background: var(--fab-bg);
+  color: var(--fab-color);
+  font-size: var(--fab-icon-size);
+  box-shadow: var(--fab-shadow);
+  cursor: pointer;
+  transition: background 0.2s ease, box-shadow 0.2s ease, transform 0.2s ease;
+}
+
+.vd-fab:hover {
+  background: var(--fab-hover-bg);
+  box-shadow: var(--fab-hover-shadow);
+  transform: scale(1.05);
+}
+
+.vd-fab:active {
+  transform: scale(0.95);
+}
+
+.vd-fab:focus-visible {
+  outline: 2px solid var(--fab-bg);
+  outline-offset: 3px;
+}
+
+/* ========== Sizes ========== */
+
+.vd-fab-sm {
+  width: var(--fab-size-sm);
+  height: var(--fab-size-sm);
+  font-size: 1.125rem;
+}
+
+.vd-fab-lg {
+  width: var(--fab-size-lg);
+  height: var(--fab-size-lg);
+  font-size: 2rem;
+}
+
+/* ========== Extended (with label) ========== */
+
+.vd-fab-extended {
+  border-radius: 1.75rem;
+  width: auto;
+  padding: 0 1.3125rem; /* 21px - fib */
+  gap: 0.5rem;
+}
+
+/* ========== Fixed Positioning ========== */
+
+.vd-fab-fixed {
+  position: fixed;
+  bottom: var(--fab-offset);
+  right: var(--fab-offset);
+  z-index: var(--fab-z-index);
+}
+
+/* ========== Position Variants (all include position: fixed) ========== */
+
+.vd-fab-bottom-left {
+  position: fixed;
+  z-index: var(--fab-z-index);
+  bottom: var(--fab-offset);
+  right: auto;
+  left: var(--fab-offset);
+}
+
+.vd-fab-top-right {
+  position: fixed;
+  z-index: var(--fab-z-index);
+  bottom: auto;
+  right: var(--fab-offset);
+  top: var(--fab-offset);
+}
+
+.vd-fab-top-left {
+  position: fixed;
+  z-index: var(--fab-z-index);
+  bottom: auto;
+  right: auto;
+  top: var(--fab-offset);
+  left: var(--fab-offset);
+}
+
+.vd-fab-center {
+  position: fixed;
+  z-index: var(--fab-z-index);
+  bottom: var(--fab-offset);
+  right: 50%;
+  transform: translateX(50%);
+}
+
+.vd-fab-center:hover {
+  transform: translateX(50%) scale(1.05);
+}
+
+/* ========== Color Variants ========== */
+
+.vd-fab-secondary {
+  --fab-bg: var(--color-gray-600, #6c757d);
+  --fab-hover-bg: var(--color-gray-700, #5c636a);
+}
+
+.vd-fab-success {
+  --fab-bg: var(--color-success, #198754);
+  --fab-hover-bg: #157347;
+}
+
+.vd-fab-danger {
+  --fab-bg: var(--color-danger, #dc3545);
+  --fab-hover-bg: #bb2d3b;
+}
+
+/* ========== Speed Dial Menu ========== */
+
+.vd-fab-menu {
+  position: relative;
+  display: inline-flex;
+  flex-direction: column-reverse;
+  align-items: center;
+  gap: var(--fab-menu-gap);
+}
+
+.vd-fab-menu .vd-fab-actions {
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  gap: var(--fab-menu-gap);
+  opacity: 0;
+  visibility: hidden;
+  transform: translateY(0.5rem);
+  transition: opacity 0.2s ease, visibility 0.2s ease, transform 0.2s ease;
+}
+
+.vd-fab-menu.is-open .vd-fab-actions {
+  opacity: 1;
+  visibility: visible;
+  transform: translateY(0);
+}
+
+.vd-fab-menu.vd-fab-fixed {
+  position: fixed;
+  bottom: var(--fab-offset);
+  right: var(--fab-offset);
+  z-index: var(--fab-z-index);
+}
+
+.vd-fab-menu .vd-fab-action {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  width: var(--fab-size-sm);
+  height: var(--fab-size-sm);
+  border: none;
+  border-radius: 50%;
+  background: var(--fab-bg);
+  color: var(--fab-color);
+  font-size: 1rem;
+  box-shadow: var(--fab-shadow);
+  cursor: pointer;
+  transition: background 0.15s ease, transform 0.15s ease;
+}
+
+.vd-fab-menu .vd-fab-action:hover {
+  transform: scale(1.1);
+  background: var(--fab-hover-bg);
+}
+
+/* Staggered entrance for action buttons */
+.vd-fab-menu.is-open .vd-fab-actions .vd-fab:nth-child(1),
+.vd-fab-menu.is-open .vd-fab-action:nth-child(1) { transition-delay: 0s; }
+.vd-fab-menu.is-open .vd-fab-actions .vd-fab:nth-child(2),
+.vd-fab-menu.is-open .vd-fab-action:nth-child(2) { transition-delay: 0.05s; }
+.vd-fab-menu.is-open .vd-fab-actions .vd-fab:nth-child(3),
+.vd-fab-menu.is-open .vd-fab-action:nth-child(3) { transition-delay: 0.1s; }
+.vd-fab-menu.is-open .vd-fab-actions .vd-fab:nth-child(4),
+.vd-fab-menu.is-open .vd-fab-action:nth-child(4) { transition-delay: 0.15s; }