@vanduo-oss/framework 1.3.9 → 1.4.1

package/css/components/spinner.css

@@ -4,21 +4,21 @@
  */
 
 :root {
-  --spinner-size: 2rem;
-  --spinner-border-width: 3px;
-  --spinner-color: var(--color-primary);
-  --spinner-speed: 0.65s;
+  --vd-spinner-size: 2rem;
+  --vd-spinner-border-width: 3px;
+  --vd-spinner-color: var(--vd-color-primary);
+  --vd-spinner-speed: 0.65s;
 }
 
 /* Border Spinner */
 .vd-spinner {
   display: inline-block;
-  width: var(--spinner-size);
-  height: var(--spinner-size);
-  border: var(--spinner-border-width) solid var(--border-color, #e9ecef);
-  border-top-color: var(--spinner-color);
+  width: var(--vd-spinner-size);
+  height: var(--vd-spinner-size);
+  border: var(--vd-spinner-border-width) solid var(--vd-border-color, #e9ecef);
+  border-top-color: var(--vd-spinner-color);
   border-radius: 50%;
-  animation: spinner-rotate var(--spinner-speed) linear infinite;
+  animation: spinner-rotate var(--vd-spinner-speed) linear infinite;
 }
 
 @keyframes spinner-rotate {
@@ -40,7 +40,7 @@
   width: 8px;
   height: 8px;
   border-radius: 50%;
-  background-color: var(--spinner-color);
+  background-color: var(--vd-spinner-color);
   animation: spinner-dots-bounce 1.4s ease-in-out infinite both;
 }
 
@@ -60,9 +60,9 @@
 /* Growing Spinner */
 .vd-spinner-grow {
   display: inline-block;
-  width: var(--spinner-size);
-  height: var(--spinner-size);
-  background-color: var(--spinner-color);
+  width: var(--vd-spinner-size);
+  height: var(--vd-spinner-size);
+  background-color: var(--vd-spinner-color);
   border-radius: 50%;
   opacity: 0;
   animation: spinner-grow 0.75s linear infinite;
@@ -74,25 +74,25 @@
 }
 
 /* Size Variants */
-.vd-spinner-xs { --spinner-size: 1rem; --spinner-border-width: 2px; }
-.vd-spinner-sm { --spinner-size: 1.5rem; --spinner-border-width: 2px; }
-.vd-spinner-lg { --spinner-size: 3rem; --spinner-border-width: 4px; }
-.vd-spinner-xl { --spinner-size: 4rem; --spinner-border-width: 5px; }
+.vd-spinner-xs { --vd-spinner-size: 1rem; --vd-spinner-border-width: 2px; }
+.vd-spinner-sm { --vd-spinner-size: 1.5rem; --vd-spinner-border-width: 2px; }
+.vd-spinner-lg { --vd-spinner-size: 3rem; --vd-spinner-border-width: 4px; }
+.vd-spinner-xl { --vd-spinner-size: 4rem; --vd-spinner-border-width: 5px; }
 
 /* Color Variants */
-.vd-spinner-success { --spinner-color: var(--color-success); }
-.vd-spinner-warning { --spinner-color: var(--color-warning); }
-.vd-spinner-error { --spinner-color: var(--color-error); }
-.vd-spinner-info { --spinner-color: var(--color-info); }
-.vd-spinner-light { --spinner-color: #fff; }
-.vd-spinner-dark { --spinner-color: var(--text-primary); }
+.vd-spinner-success { --vd-spinner-color: var(--vd-color-success); }
+.vd-spinner-warning { --vd-spinner-color: var(--vd-color-warning); }
+.vd-spinner-error { --vd-spinner-color: var(--vd-color-error); }
+.vd-spinner-info { --vd-spinner-color: var(--vd-color-info); }
+.vd-spinner-light { --vd-spinner-color: #fff; }
+.vd-spinner-dark { --vd-spinner-color: var(--vd-text-primary); }
 
 /* Centering Helper */
 .vd-spinner-center {
   display: flex;
   justify-content: center;
   align-items: center;
-  padding: var(--spacing-5, 1rem);
+  padding: var(--vd-spacing-5, 1rem);
 }
 
 /* Quad-Spinner Loader — signature Vanduo 2x2 grid loader */
@@ -114,12 +114,12 @@
 }
 
 .vd-dynamic-loader-grid .vd-spinner {
-  --spinner-size: 1.125rem;
-  --spinner-border-width: 2px;
-  --spinner-speed: 0.9s;
+  --vd-spinner-size: 1.125rem;
+  --vd-spinner-border-width: 2px;
+  --vd-spinner-speed: 0.9s;
 
-  border-color: var(--border-color, #d9d9d9);
-  border-top-color: var(--spinner-color);
+  border-color: var(--vd-border-color, #d9d9d9);
+  border-top-color: var(--vd-spinner-color);
 }
 
 .vd-dynamic-loader-grid .vd-spinner:nth-child(1) {
@@ -139,8 +139,8 @@
 }
 
 .vd-dynamic-loader-text {
-  color: var(--text-muted);
-  font-size: var(--font-size-sm, 0.8125rem);
+  color: var(--vd-text-muted);
+  font-size: var(--vd-font-size-sm, 0.8125rem);
 }
 
 /* Quad-Spinner overlaying a skeleton card */
@@ -149,8 +149,8 @@
   min-height: 300px;
   padding: 2rem;
   overflow: hidden;
-  border-radius: var(--btn-border-radius, 0.5rem);
-  border: 1px solid var(--border-color);
+  border-radius: var(--vd-btn-border-radius, 0.5rem);
+  border: 1px solid var(--vd-border-color);
 }
 
 .vd-dynamic-loader-card > .vd-dynamic-loader {

package/css/components/spotlight.css

@@ -4,28 +4,28 @@
  */
 
 :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(--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 */
+  --vd-spotlight-overlay-bg: rgba(0, 0, 0, 0.5);
+  --vd-spotlight-tooltip-bg: var(--vd-card-bg, #fff);
+  --vd-spotlight-tooltip-color: var(--vd-text-primary, #212529);
+  --vd-spotlight-tooltip-shadow: 0 0.5rem 1.3125rem rgba(0, 0, 0, 0.15);
+  --vd-spotlight-tooltip-padding: 1.3125rem; /* 21px - fib */
+  --vd-spotlight-tooltip-radius: var(--vd-card-border-radius, var(--vd-btn-border-radius-lg, 0.5rem));
+  --vd-spotlight-tooltip-max-width: 21rem; /* 336px - fib×16 */
+  --vd-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;
+  --vd-spotlight-target-radius: var(--vd-card-border-radius, var(--vd-btn-border-radius-lg, var(--vd-btn-border-radius, 0.25rem)));
+  --vd-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);
+  --vd-spotlight-tooltip-bg: var(--vd-card-bg, #2d2d44);
+  --vd-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);
+    --vd-spotlight-tooltip-bg: var(--vd-card-bg, #2d2d44);
+    --vd-spotlight-tooltip-shadow: 0 0.5rem 1.3125rem rgba(0, 0, 0, 0.35);
   }
 }
 
@@ -37,7 +37,7 @@
   left: 0;
   width: 100vw;
   height: 100vh;
-  z-index: var(--spotlight-z-index);
+  z-index: var(--vd-spotlight-z-index);
   pointer-events: auto;
   transition: opacity 0.3s ease;
 }
@@ -46,13 +46,13 @@
 
 .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);
+  z-index: calc(var(--vd-spotlight-z-index) + 2);
+  background: var(--vd-spotlight-tooltip-bg);
+  color: var(--vd-spotlight-tooltip-color);
+  padding: var(--vd-spotlight-tooltip-padding);
+  border-radius: var(--vd-spotlight-tooltip-radius);
+  box-shadow: var(--vd-spotlight-tooltip-shadow);
+  max-width: var(--vd-spotlight-tooltip-max-width);
 }
 
 .vd-spotlight-title {
@@ -78,7 +78,7 @@
 
 .vd-spotlight-counter {
   font-size: 0.75rem;
-  color: var(--text-muted, #6c757d);
+  color: var(--vd-text-muted, #6c757d);
 }
 
 .vd-spotlight-actions {
@@ -88,8 +88,8 @@
 
 .vd-spotlight-btn {
   padding: 0.3125rem 0.8125rem; /* 5px 13px - fib */
-  border: 1px solid var(--border-color, #dee2e6);
-  border-radius: var(--btn-border-radius-sm, 0.25rem);
+  border: 1px solid var(--vd-border-color, #dee2e6);
+  border-radius: var(--vd-btn-border-radius-sm, 0.25rem);
   background: transparent;
   cursor: pointer;
   font-size: 0.8125rem;
@@ -97,28 +97,28 @@
 }
 
 .vd-spotlight-btn:hover {
-  background: var(--bg-secondary, #f8f9fa);
+  background: var(--vd-bg-secondary, #f8f9fa);
 }
 
 .vd-spotlight-btn-primary {
-  background: var(--color-primary, #0d6efd);
+  background: var(--vd-color-primary, #0d6efd);
   color: #fff;
-  border-color: var(--color-primary, #0d6efd);
+  border-color: var(--vd-color-primary, #0d6efd);
 }
 
 .vd-spotlight-btn-primary:hover {
-  background: var(--color-primary-dark, #0b5ed7);
+  background: var(--vd-color-primary-dark, #0b5ed7);
 }
 
 /* ========== Highlighted Target ========== */
 
 .vd-spotlight-target {
   position: relative;
-  z-index: calc(var(--spotlight-z-index) + 1);
+  z-index: calc(var(--vd-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: var(--vd-spotlight-target-radius) !important;
+  box-shadow: 0 0 0 var(--vd-spotlight-highlight-padding) rgba(13, 110, 253, 0.25),
+              0 0 0 9999px var(--vd-spotlight-overlay-bg);
 }

package/css/components/stepper.css

@@ -5,29 +5,29 @@
 
 :root {
   /* Stepper Colors */
-  --stepper-active-color: var(--color-primary, #0d6efd);
-  --stepper-completed-color: var(--color-success, #198754);
-  --stepper-error-color: var(--color-danger, #dc3545);
-  --stepper-pending-color: var(--color-gray-400, #ced4da);
-  --stepper-text-color: var(--text-primary, #212529);
-  --stepper-line-color: var(--border-color, #dee2e6);
+  --vd-stepper-active-color: var(--vd-color-primary, #0d6efd);
+  --vd-stepper-completed-color: var(--vd-color-success, #198754);
+  --vd-stepper-error-color: var(--vd-color-danger, #dc3545);
+  --vd-stepper-pending-color: var(--vd-color-gray-400, #ced4da);
+  --vd-stepper-text-color: var(--vd-text-primary, #212529);
+  --vd-stepper-line-color: var(--vd-border-color, #dee2e6);
 
   /* Stepper Dimensions (Fibonacci) */
-  --stepper-circle-size: 2.125rem; /* 34px ~ fib */
-  --stepper-line-width: 2px;
-  --stepper-gap: 0.5rem;          /* 8px - fib */
-  --stepper-connector-gap: 0.8125rem; /* 13px - fib */
+  --vd-stepper-circle-size: 2.125rem; /* 34px ~ fib */
+  --vd-stepper-line-width: 2px;
+  --vd-stepper-gap: 0.5rem;          /* 8px - fib */
+  --vd-stepper-connector-gap: 0.8125rem; /* 13px - fib */
 }
 
 [data-theme="dark"] {
-  --stepper-pending-color: var(--color-gray-600, #6c757d);
-  --stepper-line-color: var(--color-gray-600, #6c757d);
+  --vd-stepper-pending-color: var(--vd-color-gray-600, #6c757d);
+  --vd-stepper-line-color: var(--vd-color-gray-600, #6c757d);
 }
 
 @media (prefers-color-scheme: dark) {
   :root:not([data-theme]) {
-    --stepper-pending-color: var(--color-gray-600, #6c757d);
-    --stepper-line-color: var(--color-gray-600, #6c757d);
+    --vd-stepper-pending-color: var(--vd-color-gray-600, #6c757d);
+    --vd-stepper-line-color: var(--vd-color-gray-600, #6c757d);
   }
 }
 
@@ -53,11 +53,11 @@
 .vd-stepper-item:not(:last-child)::after {
   content: '';
   position: absolute;
-  top: calc(var(--stepper-circle-size) / 2);
-  left: calc(50% + var(--stepper-circle-size) / 2 + var(--stepper-connector-gap));
-  right: calc(-50% + var(--stepper-circle-size) / 2 + var(--stepper-connector-gap));
-  height: var(--stepper-line-width);
-  background: var(--stepper-line-color);
+  top: calc(var(--vd-stepper-circle-size) / 2);
+  left: calc(50% + var(--vd-stepper-circle-size) / 2 + var(--vd-stepper-connector-gap));
+  right: calc(-50% + var(--vd-stepper-circle-size) / 2 + var(--vd-stepper-connector-gap));
+  height: var(--vd-stepper-line-width);
+  background: var(--vd-stepper-line-color);
   z-index: 0;
 }
 
@@ -66,11 +66,11 @@
   display: flex;
   align-items: center;
   justify-content: center;
-  width: var(--stepper-circle-size);
-  height: var(--stepper-circle-size);
+  width: var(--vd-stepper-circle-size);
+  height: var(--vd-stepper-circle-size);
   border-radius: 50%;
-  border: var(--stepper-line-width) solid var(--stepper-pending-color);
-  background: var(--bg-primary, #fff);
+  border: var(--vd-stepper-line-width) solid var(--vd-stepper-pending-color);
+  background: var(--vd-bg-primary, #fff);
   font-weight: 600;
   font-size: 0.875rem;
   z-index: 1;
@@ -79,53 +79,53 @@
 }
 
 .vd-stepper-label {
-  margin-top: var(--stepper-gap);
+  margin-top: var(--vd-stepper-gap);
   font-size: 0.8125rem;
   font-weight: 500;
-  color: var(--text-muted, #6c757d);
+  color: var(--vd-text-muted, #6c757d);
 }
 
 .vd-stepper-description {
   font-size: 0.75rem;
-  color: var(--text-muted, #6c757d);
+  color: var(--vd-text-muted, #6c757d);
   margin-top: 0.125rem;
 }
 
 /* ========== States ========== */
 
 .vd-stepper-item.is-active .vd-stepper-circle {
-  border-color: var(--stepper-active-color);
-  background: var(--stepper-active-color);
+  border-color: var(--vd-stepper-active-color);
+  background: var(--vd-stepper-active-color);
   color: #fff;
 }
 
 .vd-stepper-item.is-active .vd-stepper-label {
-  color: var(--stepper-active-color);
+  color: var(--vd-stepper-active-color);
   font-weight: 600;
 }
 
 .vd-stepper-item.is-completed .vd-stepper-circle {
-  border-color: var(--stepper-completed-color);
-  background: var(--stepper-completed-color);
+  border-color: var(--vd-stepper-completed-color);
+  background: var(--vd-stepper-completed-color);
   color: #fff;
 }
 
 .vd-stepper-item.is-completed::after {
-  background: var(--stepper-completed-color);
+  background: var(--vd-stepper-completed-color);
 }
 
 .vd-stepper-item.is-completed .vd-stepper-label {
-  color: var(--stepper-text-color);
+  color: var(--vd-stepper-text-color);
 }
 
 .vd-stepper-item.is-error .vd-stepper-circle {
-  border-color: var(--stepper-error-color);
-  background: var(--stepper-error-color);
+  border-color: var(--vd-stepper-error-color);
+  background: var(--vd-stepper-error-color);
   color: #fff;
 }
 
 .vd-stepper-item.is-error .vd-stepper-label {
-  color: var(--stepper-error-color);
+  color: var(--vd-stepper-error-color);
 }
 
 /* ========== Vertical ========== */
@@ -144,11 +144,11 @@
 }
 
 .vd-stepper-vertical .vd-stepper-item:not(:last-child)::after {
-  top: calc(var(--stepper-circle-size) + var(--stepper-connector-gap));
-  left: calc(var(--stepper-circle-size) / 2);
+  top: calc(var(--vd-stepper-circle-size) + var(--vd-stepper-connector-gap));
+  left: calc(var(--vd-stepper-circle-size) / 2);
   right: auto;
   bottom: 0;
-  width: var(--stepper-line-width);
+  width: var(--vd-stepper-line-width);
   height: auto;
 }
 

package/css/components/suggest.css

@@ -6,37 +6,37 @@
 
 :root {
   /* Suggest Colors */
-  --suggest-bg: var(--card-bg, #fff);
-  --suggest-border-color: var(--border-color, #dee2e6);
-  --suggest-shadow: 0 0.25rem 0.8125rem rgba(0, 0, 0, 0.1); /* 4px 13px - fib */
-  --suggest-item-hover-bg: var(--bg-secondary, #f8f9fa);
-  --suggest-item-active-bg: var(--color-primary, #0d6efd);
-  --suggest-item-active-color: #fff;
-  --suggest-highlight-color: var(--color-primary, #0d6efd);
+  --vd-suggest-bg: var(--vd-card-bg, #fff);
+  --vd-suggest-border-color: var(--vd-border-color, #dee2e6);
+  --vd-suggest-shadow: 0 0.25rem 0.8125rem rgba(0, 0, 0, 0.1); /* 4px 13px - fib */
+  --vd-suggest-item-hover-bg: var(--vd-bg-secondary, #f8f9fa);
+  --vd-suggest-item-active-bg: var(--vd-color-primary, #0d6efd);
+  --vd-suggest-item-active-color: #fff;
+  --vd-suggest-highlight-color: var(--vd-color-primary, #0d6efd);
 
   /* Suggest Spacing (Fibonacci) */
-  --suggest-padding: 0.3125rem 0; /* 5px - fib */
-  --suggest-item-padding: 0.5rem 0.8125rem; /* 8px 13px - fib */
-  --suggest-max-height: 15rem;
-  --suggest-border-radius: var(--border-radius, 0.5rem);
+  --vd-suggest-padding: 0.3125rem 0; /* 5px - fib */
+  --vd-suggest-item-padding: 0.5rem 0.8125rem; /* 8px 13px - fib */
+  --vd-suggest-max-height: 15rem;
+  --vd-suggest-border-radius: var(--vd-border-radius, 0.5rem);
 
   /* Suggest Z-index */
-  --suggest-z-index: 1050;
+  --vd-suggest-z-index: 1050;
 }
 
 [data-theme="dark"] {
-  --suggest-bg: var(--card-bg, #2d2d44);
-  --suggest-border-color: var(--border-color, #3d3d5c);
-  --suggest-item-hover-bg: var(--bg-primary, #1a1a2e);
-  --suggest-shadow: 0 0.25rem 0.8125rem rgba(0, 0, 0, 0.3);
+  --vd-suggest-bg: var(--vd-card-bg, #2d2d44);
+  --vd-suggest-border-color: var(--vd-border-color, #3d3d5c);
+  --vd-suggest-item-hover-bg: var(--vd-bg-primary, #1a1a2e);
+  --vd-suggest-shadow: 0 0.25rem 0.8125rem rgba(0, 0, 0, 0.3);
 }
 
 @media (prefers-color-scheme: dark) {
   :root:not([data-theme]) {
-    --suggest-bg: var(--card-bg, #2d2d44);
-    --suggest-border-color: var(--border-color, #3d3d5c);
-    --suggest-item-hover-bg: var(--bg-primary, #1a1a2e);
-    --suggest-shadow: 0 0.25rem 0.8125rem rgba(0, 0, 0, 0.3);
+    --vd-suggest-bg: var(--vd-card-bg, #2d2d44);
+    --vd-suggest-border-color: var(--vd-border-color, #3d3d5c);
+    --vd-suggest-item-hover-bg: var(--vd-bg-primary, #1a1a2e);
+    --vd-suggest-shadow: 0 0.25rem 0.8125rem rgba(0, 0, 0, 0.3);
   }
 }
 
@@ -56,15 +56,15 @@
   top: 100%;
   left: 0;
   right: 0;
-  z-index: var(--suggest-z-index);
+  z-index: var(--vd-suggest-z-index);
   margin-top: 2px;
-  padding: var(--suggest-padding);
-  max-height: var(--suggest-max-height);
+  padding: var(--vd-suggest-padding);
+  max-height: var(--vd-suggest-max-height);
   overflow-y: auto;
-  background: var(--suggest-bg);
-  border: 1px solid var(--suggest-border-color);
-  border-radius: var(--suggest-border-radius);
-  box-shadow: var(--suggest-shadow);
+  background: var(--vd-suggest-bg);
+  border: 1px solid var(--vd-suggest-border-color);
+  border-radius: var(--vd-suggest-border-radius);
+  box-shadow: var(--vd-suggest-shadow);
   list-style: none;
   display: none;
 }
@@ -76,26 +76,26 @@
 /* ========== Items ========== */
 
 .vd-suggest-item {
-  padding: var(--suggest-item-padding);
+  padding: var(--vd-suggest-item-padding);
   cursor: pointer;
   transition: background 0.15s ease;
-  font-size: var(--font-size-base, 1rem);
+  font-size: var(--vd-font-size-base, 1rem);
 }
 
 .vd-suggest-item:hover,
 .vd-suggest-item.is-highlighted {
-  background: var(--suggest-item-hover-bg);
+  background: var(--vd-suggest-item-hover-bg);
 }
 
 .vd-suggest-item.is-active {
-  background: var(--suggest-item-active-bg);
-  color: var(--suggest-item-active-color);
+  background: var(--vd-suggest-item-active-bg);
+  color: var(--vd-suggest-item-active-color);
 }
 
 /* Match highlight */
 .vd-suggest-match {
   font-weight: 600;
-  color: var(--suggest-highlight-color);
+  color: var(--vd-suggest-highlight-color);
 }
 
 .vd-suggest-item.is-active .vd-suggest-match {
@@ -105,15 +105,15 @@
 /* ========== No Results ========== */
 
 .vd-suggest-empty {
-  padding: var(--suggest-item-padding);
-  color: var(--text-muted, #6c757d);
+  padding: var(--vd-suggest-item-padding);
+  color: var(--vd-text-muted, #6c757d);
   font-style: italic;
 }
 
 /* ========== Loading ========== */
 
 .vd-suggest-loading {
-  padding: var(--suggest-item-padding);
+  padding: var(--vd-suggest-item-padding);
   text-align: center;
-  color: var(--text-muted, #6c757d);
+  color: var(--vd-text-muted, #6c757d);
 }