@vanduo-oss/framework 1.2.6 → 1.2.8

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; }

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);
+}