@vanduo-oss/framework 1.2.6 → 1.2.7

package/css/components/flow.css

@@ -0,0 +1,265 @@
+/**
+ * Vanduo Framework - Flow (Carousel/Slider)
+ * Content carousel with slide/fade transitions, touch support
+ * Primary: .vd-flow | Alias: .vd-carousel
+ */
+
+:root {
+  /* Flow Dimensions */
+  --flow-height: auto;
+  --flow-min-height: 13rem;          /* 208px - fib */
+
+  /* Flow Spacing (Fibonacci) */
+  --flow-padding: 0;
+  --flow-gap: 0;
+  --flow-indicator-size: 0.5rem;     /* 8px - fib */
+  --flow-indicator-gap: 0.5rem;      /* 8px - fib */
+  --flow-control-size: 2.5rem;       /* 40px */
+  --flow-control-offset: 0.8125rem;  /* 13px - fib */
+
+  /* Flow Colors */
+  --flow-bg: var(--bg-primary, #fff);
+  --flow-indicator-bg: rgba(255, 255, 255, 0.5);
+  --flow-indicator-active-bg: #fff;
+  --flow-control-bg: rgba(0, 0, 0, 0.3);
+  --flow-control-hover-bg: rgba(0, 0, 0, 0.5);
+  --flow-control-color: #fff;
+
+  /* Flow Transitions */
+  --flow-transition-duration: 0.5s;
+  --flow-transition-timing: cubic-bezier(0.4, 0, 0.2, 1);
+
+  /* Flow Border */
+  --flow-border-radius: var(--border-radius, 0.5rem);
+
+  /* Flow Z-index */
+  --flow-z-controls: 10;
+  --flow-z-indicators: 10;
+}
+
+/* Dark Theme */
+[data-theme="dark"] {
+  --flow-bg: var(--bg-primary, #1a1a2e);
+  --flow-control-bg: rgba(255, 255, 255, 0.2);
+  --flow-control-hover-bg: rgba(255, 255, 255, 0.35);
+}
+
+@media (prefers-color-scheme: dark) {
+  :root:not([data-theme]) {
+    --flow-bg: var(--bg-primary, #1a1a2e);
+    --flow-control-bg: rgba(255, 255, 255, 0.2);
+    --flow-control-hover-bg: rgba(255, 255, 255, 0.35);
+  }
+}
+
+/* ========== Base ========== */
+
+.vd-flow,
+.vd-carousel {
+  position: relative;
+  overflow: hidden;
+  width: 100%;
+  min-height: var(--flow-min-height);
+  height: var(--flow-height);
+  background-color: var(--flow-bg);
+  border-radius: var(--flow-border-radius);
+}
+
+/* ========== Track ========== */
+
+.vd-flow-track {
+  display: flex;
+  width: 100%;
+  height: 100%;
+  transition: transform var(--flow-transition-duration) var(--flow-transition-timing);
+  will-change: transform;
+}
+
+.vd-flow.is-dragging .vd-flow-track {
+  transition: none;
+  cursor: grabbing;
+}
+
+/* ========== Slides ========== */
+
+.vd-flow-slide {
+  position: relative;
+  flex: 0 0 100%;
+  width: 100%;
+  min-height: var(--flow-min-height);
+  overflow: hidden;
+}
+
+.vd-flow-slide img {
+  width: 100%;
+  height: 100%;
+  object-fit: cover;
+}
+
+/* Fade transition variant */
+.vd-flow-fade .vd-flow-track {
+  transition: none;
+}
+
+.vd-flow-fade .vd-flow-slide {
+  position: absolute;
+  top: 0;
+  left: 0;
+  opacity: 0;
+  transition: opacity var(--flow-transition-duration) var(--flow-transition-timing);
+  pointer-events: none;
+}
+
+.vd-flow-fade .vd-flow-slide.is-active {
+  opacity: 1;
+  pointer-events: auto;
+  position: relative;
+}
+
+/* ========== Controls ========== */
+
+.vd-flow-prev,
+.vd-flow-next {
+  position: absolute;
+  top: 50%;
+  transform: translateY(-50%);
+  z-index: var(--flow-z-controls);
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  width: var(--flow-control-size);
+  height: var(--flow-control-size);
+  padding: 0;
+  border: none;
+  border-radius: 50%;
+  background: var(--flow-control-bg);
+  color: var(--flow-control-color);
+  font-size: 1.125rem;
+  cursor: pointer;
+  transition: background 0.2s ease, opacity 0.2s ease;
+  opacity: 0;
+}
+
+.vd-flow:hover .vd-flow-prev,
+.vd-flow:hover .vd-flow-next,
+.vd-flow:focus-within .vd-flow-prev,
+.vd-flow:focus-within .vd-flow-next {
+  opacity: 1;
+}
+
+.vd-flow-prev:hover,
+.vd-flow-next:hover {
+  background: var(--flow-control-hover-bg);
+}
+
+.vd-flow-prev:focus-visible,
+.vd-flow-next:focus-visible {
+  outline: 2px solid var(--flow-control-color);
+  outline-offset: 2px;
+}
+
+.vd-flow-prev {
+  left: var(--flow-control-offset);
+}
+
+.vd-flow-next {
+  right: var(--flow-control-offset);
+}
+
+/* ========== Indicators ========== */
+
+.vd-flow-indicators {
+  position: absolute;
+  bottom: 0.8125rem; /* 13px - fib */
+  left: 50%;
+  transform: translateX(-50%);
+  z-index: var(--flow-z-indicators);
+  display: flex;
+  gap: var(--flow-indicator-gap);
+  padding: 0.3125rem 0.5rem; /* 5px 8px - fib */
+  margin: 0;
+  list-style: none;
+  border-radius: 1rem;
+}
+
+.vd-flow-indicator {
+  width: var(--flow-indicator-size);
+  height: var(--flow-indicator-size);
+  padding: 0;
+  border: none;
+  border-radius: 50%;
+  background: var(--flow-indicator-bg);
+  cursor: pointer;
+  transition: background 0.2s ease, transform 0.2s ease;
+}
+
+.vd-flow-indicator:hover {
+  background: rgba(255, 255, 255, 0.75);
+}
+
+.vd-flow-indicator.is-active {
+  background: var(--flow-indicator-active-bg);
+  transform: scale(1.3);
+}
+
+.vd-flow-indicator:focus-visible {
+  outline: 2px solid var(--flow-indicator-active-bg);
+  outline-offset: 2px;
+}
+
+/* ========== Slide Content Overlay ========== */
+
+.vd-flow-caption {
+  position: absolute;
+  bottom: 0;
+  left: 0;
+  right: 0;
+  padding: 1.3125rem 1.3125rem 2.625rem; /* 21px 21px 42px - fib */
+  background: linear-gradient(transparent, rgba(0, 0, 0, 0.6));
+  color: #fff;
+}
+
+.vd-flow-caption h3,
+.vd-flow-caption .vd-flow-title {
+  margin: 0 0 0.3125rem; /* 5px - fib */
+  font-size: 1.25rem;
+  font-weight: 600;
+}
+
+.vd-flow-caption p,
+.vd-flow-caption .vd-flow-description {
+  margin: 0;
+  font-size: 0.875rem;
+  opacity: 0.9;
+}
+
+/* ========== Size Variants ========== */
+
+.vd-flow-compact {
+  --flow-min-height: 8rem;
+  --flow-control-size: 2rem;
+}
+
+.vd-flow-lg {
+  --flow-min-height: 21rem; /* 336px - fib×16 */
+  --flow-control-size: 3rem;
+}
+
+.vd-flow-fullscreen {
+  --flow-min-height: 100vh;
+  --flow-border-radius: 0;
+}
+
+/* ========== Responsive ========== */
+
+@media (max-width: 768px) {
+  .vd-flow-prev,
+  .vd-flow-next {
+    opacity: 1;
+    --flow-control-size: 2rem;
+  }
+
+  .vd-flow-caption {
+    padding: 0.8125rem 0.8125rem 2rem;
+  }
+}

package/css/components/rating.css

@@ -0,0 +1,112 @@
+/**
+ * Vanduo Framework - Rating
+ * Star/icon-based rating input with read-only mode
+ */
+
+:root {
+  /* Rating Colors */
+  --rating-active-color: #f59e0b;
+  --rating-inactive-color: var(--color-gray-300, #dee2e6);
+  --rating-hover-color: #fbbf24;
+
+  /* Rating Dimensions (Fibonacci) */
+  --rating-size: 1.3125rem;  /* 21px - fib */
+  --rating-size-sm: 1rem;
+  --rating-size-lg: 2.125rem; /* 34px ~ fib */
+  --rating-gap: 0.125rem;     /* 2px */
+}
+
+[data-theme="dark"] {
+  --rating-inactive-color: var(--color-gray-600, #6c757d);
+}
+
+@media (prefers-color-scheme: dark) {
+  :root:not([data-theme]) {
+    --rating-inactive-color: var(--color-gray-600, #6c757d);
+  }
+}
+
+/* ========== Base ========== */
+
+.vd-rating {
+  display: inline-flex;
+  align-items: center;
+  gap: var(--rating-gap);
+}
+
+.vd-rating-star {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  font-size: var(--rating-size);
+  color: var(--rating-inactive-color);
+  cursor: pointer;
+  transition: color 0.15s ease, transform 0.15s ease;
+  user-select: none;
+  border: none;
+  background: none;
+  padding: 0;
+  line-height: 1;
+}
+
+.vd-rating-star::before {
+  content: '\2605'; /* filled star */
+}
+
+.vd-rating-star:hover {
+  transform: scale(1.2);
+}
+
+.vd-rating-star.is-active {
+  color: var(--rating-active-color);
+}
+
+.vd-rating-star.is-hovered {
+  color: var(--rating-hover-color);
+}
+
+/* Half-star support */
+.vd-rating-star.is-half {
+  position: relative;
+  color: var(--rating-inactive-color);
+}
+
+.vd-rating-star.is-half::after {
+  content: '\2605';
+  position: absolute;
+  left: 0;
+  top: 0;
+  width: 50%;
+  overflow: hidden;
+  color: var(--rating-active-color);
+}
+
+/* ========== Read-only ========== */
+
+.vd-rating-readonly .vd-rating-star {
+  cursor: default;
+  pointer-events: none;
+}
+
+.vd-rating-readonly .vd-rating-star:hover {
+  transform: none;
+}
+
+/* ========== Sizes ========== */
+
+.vd-rating-sm .vd-rating-star {
+  font-size: var(--rating-size-sm);
+}
+
+.vd-rating-lg .vd-rating-star {
+  font-size: var(--rating-size-lg);
+}
+
+/* ========== Value Display ========== */
+
+.vd-rating-value {
+  margin-left: 0.5rem;
+  font-size: 0.875rem;
+  font-weight: 600;
+  color: var(--text-primary, #212529);
+}

package/css/components/ripple.css

@@ -0,0 +1,63 @@
+/**
+ * Vanduo Framework - Ripple (Waves Effect)
+ * Click-position-based expanding circle animation
+ */
+
+:root {
+  --ripple-color: rgba(255, 255, 255, 0.35);
+  --ripple-duration: 0.6s;
+  --ripple-timing: cubic-bezier(0, 0, 0.2, 1);
+}
+
+[data-theme="dark"] {
+  --ripple-color: rgba(255, 255, 255, 0.2);
+}
+
+@media (prefers-color-scheme: dark) {
+  :root:not([data-theme]) {
+    --ripple-color: rgba(255, 255, 255, 0.2);
+  }
+}
+
+/* ========== Base ========== */
+
+.vd-ripple,
+[data-vd-ripple] {
+  position: relative;
+  overflow: hidden;
+  -webkit-tap-highlight-color: transparent;
+}
+
+/* The animated circle */
+.vd-ripple-wave {
+  position: absolute;
+  border-radius: 50%;
+  background: var(--ripple-color);
+  transform: scale(0);
+  animation: vd-ripple-expand var(--ripple-duration) var(--ripple-timing) forwards;
+  pointer-events: none;
+}
+
+@keyframes vd-ripple-expand {
+  to {
+    transform: scale(4);
+    opacity: 0;
+  }
+}
+
+/* ========== Color Variants ========== */
+
+.vd-ripple-dark,
+[data-vd-ripple="dark"] {
+  --ripple-color: rgba(0, 0, 0, 0.15);
+}
+
+.vd-ripple-primary,
+[data-vd-ripple="primary"] {
+  --ripple-color: rgba(13, 110, 253, 0.3);
+}
+
+.vd-ripple-light,
+[data-vd-ripple="light"] {
+  --ripple-color: rgba(255, 255, 255, 0.5);
+}

package/css/components/sidenav.css

@@ -267,6 +267,76 @@
   margin-right: var(--sidenav-width-lg);
 }
 
+/* ========== Offcanvas Alias ========== */
+
+.vd-offcanvas {
+  position: fixed;
+  top: 0;
+  left: 0;
+  z-index: var(--sidenav-z-index);
+  width: var(--sidenav-width);
+  height: 100vh;
+  display: flex;
+  flex-direction: column;
+  background-color: var(--sidenav-bg);
+  box-shadow: var(--shadow-lg);
+  transform: translateX(-100%);
+  transition: var(--sidenav-transition);
+  overflow-y: auto;
+  overflow-x: hidden;
+}
+
+.vd-offcanvas.is-open {
+  transform: translateX(0) translateY(0);
+}
+
+/* Top direction */
+.vd-sidenav-top,
+.vd-offcanvas-top {
+  top: 0;
+  left: 0;
+  right: 0;
+  bottom: auto;
+  width: 100%;
+  height: auto;
+  max-height: 80vh;
+  transform: translateY(-100%);
+}
+
+.vd-sidenav-top.is-open,
+.vd-offcanvas-top.is-open {
+  transform: translateY(0);
+}
+
+/* Bottom direction */
+.vd-sidenav-bottom,
+.vd-offcanvas-bottom {
+  top: auto;
+  left: 0;
+  right: 0;
+  bottom: 0;
+  width: 100%;
+  height: auto;
+  max-height: 80vh;
+  transform: translateY(100%);
+}
+
+.vd-sidenav-bottom.is-open,
+.vd-offcanvas-bottom.is-open {
+  transform: translateY(0);
+}
+
+/* Right alias for offcanvas */
+.vd-offcanvas-right {
+  left: auto;
+  right: 0;
+  transform: translateX(100%);
+}
+
+.vd-offcanvas-right.is-open {
+  transform: translateX(0);
+}
+
 /* Body Scroll Lock */
 .body-sidenav-open {
   overflow: hidden;

package/css/components/spotlight.css

@@ -0,0 +1,119 @@
+/**
+ * Vanduo Framework - Spotlight (Feature Discovery)
+ * Overlay highlight + tooltip tour system
+ */
+
+:root {
+  --spotlight-overlay-bg: rgba(0, 0, 0, 0.5);
+  --spotlight-tooltip-bg: var(--card-bg, #fff);
+  --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-max-width: 21rem; /* 336px - fib×16 */
+  --spotlight-highlight-padding: 0.5rem; /* 8px - fib */
+  --spotlight-z-index: 1080;
+}
+
+[data-theme="dark"] {
+  --spotlight-tooltip-bg: var(--card-bg, #2d2d44);
+  --spotlight-tooltip-shadow: 0 0.5rem 1.3125rem rgba(0, 0, 0, 0.35);
+}
+
+@media (prefers-color-scheme: dark) {
+  :root:not([data-theme]) {
+    --spotlight-tooltip-bg: var(--card-bg, #2d2d44);
+    --spotlight-tooltip-shadow: 0 0.5rem 1.3125rem rgba(0, 0, 0, 0.35);
+  }
+}
+
+/* ========== Overlay ========== */
+
+.vd-spotlight-overlay {
+  position: fixed;
+  top: 0;
+  left: 0;
+  width: 100vw;
+  height: 100vh;
+  z-index: var(--spotlight-z-index);
+  pointer-events: auto;
+  transition: opacity 0.3s ease;
+}
+
+/* ========== Tooltip ========== */
+
+.vd-spotlight-tooltip {
+  position: absolute;
+  z-index: calc(var(--spotlight-z-index) + 2);
+  background: var(--spotlight-tooltip-bg);
+  color: var(--spotlight-tooltip-color);
+  padding: var(--spotlight-tooltip-padding);
+  border-radius: var(--spotlight-tooltip-radius);
+  box-shadow: var(--spotlight-tooltip-shadow);
+  max-width: var(--spotlight-tooltip-max-width);
+}
+
+.vd-spotlight-title {
+  margin: 0 0 0.5rem;
+  font-weight: 600;
+  font-size: 1.125rem;
+}
+
+.vd-spotlight-description {
+  margin: 0 0 0.8125rem; /* 13px - fib */
+  font-size: 0.875rem;
+  line-height: 1.5;
+}
+
+/* ========== Footer (nav buttons) ========== */
+
+.vd-spotlight-footer {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 0.5rem;
+}
+
+.vd-spotlight-counter {
+  font-size: 0.75rem;
+  color: var(--text-muted, #6c757d);
+}
+
+.vd-spotlight-actions {
+  display: flex;
+  gap: 0.3125rem; /* 5px - fib */
+}
+
+.vd-spotlight-btn {
+  padding: 0.3125rem 0.8125rem; /* 5px 13px - fib */
+  border: 1px solid var(--border-color, #dee2e6);
+  border-radius: 0.25rem;
+  background: transparent;
+  cursor: pointer;
+  font-size: 0.8125rem;
+  transition: background 0.15s ease;
+}
+
+.vd-spotlight-btn:hover {
+  background: var(--bg-secondary, #f8f9fa);
+}
+
+.vd-spotlight-btn-primary {
+  background: var(--color-primary, #0d6efd);
+  color: #fff;
+  border-color: var(--color-primary, #0d6efd);
+}
+
+.vd-spotlight-btn-primary:hover {
+  background: var(--color-primary-dark, #0b5ed7);
+}
+
+/* ========== Highlighted Target ========== */
+
+.vd-spotlight-target {
+  position: relative;
+  z-index: calc(var(--spotlight-z-index) + 1);
+  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;
+}