vanduo-framework 1.1.8-docs-update

package/css/components/theme-customizer.css

@@ -0,0 +1,835 @@
+/**
+ * Vanduo Framework - Theme Customizer
+ * A comprehensive theme customization panel for the navbar
+ */
+
+:root {
+  /* Theme Customizer Variables */
+  --customizer-width: 320px;
+  --customizer-padding: 1rem;
+  --customizer-gap: 0.75rem;
+  --customizer-swatch-size: 28px;
+  --customizer-radius-btn-width: 48px;
+  --customizer-bg: var(--bg-primary);
+  --customizer-border: var(--border-color);
+  --customizer-shadow: var(--shadow-lg);
+  --customizer-z-index: 1050;
+}
+
+/* ==========================================================================
+   Dynamic Panel (appended to body)
+   ========================================================================== */
+
+body > .vd-theme-customizer-panel {
+  position: fixed;
+  /* top is set dynamically by JS based on actual navbar height */
+  top: 55px;
+  right: 0;
+  width: var(--customizer-width);
+  max-height: calc(100vh - 55px);
+  overflow-y: auto;
+  padding: 0; /* Override .vd-navbar-fixed ~ * padding-top rule */
+  background-color: var(--customizer-bg);
+  border: 1px solid var(--customizer-border);
+  border-radius: calc(var(--radius-scale, 0.25) * 1rem);
+  box-shadow: var(--customizer-shadow);
+  z-index: var(--customizer-z-index);
+  opacity: 0;
+  visibility: hidden;
+  transform: translateY(-10px);
+  transition: opacity 0.2s ease, transform 0.2s ease, visibility 0.2s ease;
+}
+
+body > .vd-theme-customizer-panel.is-open {
+  opacity: 1;
+  visibility: visible;
+  transform: translateY(0);
+}
+
+/* ==========================================================================
+   Dynamic Panel Inner Structure (tc-* classes)
+   ========================================================================== */
+
+.tc-header {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  padding: 0.5rem var(--customizer-padding) 0.75rem;
+  border-bottom: 1px solid var(--border-color);
+}
+
+.tc-title {
+  font-size: var(--font-size-base);
+  font-weight: var(--font-weight-semibold);
+  color: var(--text-primary);
+  margin: 0;
+}
+
+.tc-body {
+  padding: var(--customizer-padding);
+}
+
+.tc-footer {
+  padding: 0.75rem var(--customizer-padding) 0.5rem;
+  border-top: 1px solid var(--border-color);
+}
+
+.tc-section {
+  margin-bottom: 1.25rem;
+}
+
+.tc-section:last-child {
+  margin-bottom: 0;
+}
+
+.tc-label {
+  display: block;
+  margin-bottom: 0.5rem;
+  font-size: var(--font-size-sm);
+  font-weight: var(--font-weight-medium);
+  color: var(--text-primary);
+}
+
+/* Primary Color Grid */
+.tc-color-grid {
+  display: grid;
+  grid-template-columns: repeat(6, 1fr);
+  gap: 0.375rem;
+}
+
+.tc-color-swatch {
+  width: 100%;
+  aspect-ratio: 1;
+  padding: 0;
+  background-color: var(--swatch-color);
+  border: 2px solid transparent;
+  border-radius: calc(var(--radius-scale, 0.25) * 0.5rem);
+  cursor: pointer;
+  transition: all 0.15s ease;
+}
+
+.tc-color-swatch:hover {
+  transform: scale(1.1);
+  box-shadow: 0 2px 8px rgba(0, 0, 0, 0.2);
+}
+
+.tc-color-swatch:focus-visible {
+  outline: 2px solid var(--color-primary);
+  outline-offset: 2px;
+}
+
+.tc-color-swatch.is-active {
+  border-color: var(--text-primary);
+  box-shadow: 0 0 0 2px var(--bg-primary);
+}
+
+/* Neutral Color Grid */
+.tc-neutral-grid {
+  display: grid;
+  grid-template-columns: repeat(5, 1fr);
+  gap: 0.375rem;
+}
+
+.tc-neutral-swatch {
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  gap: 0.25rem;
+  padding: 0.5rem 0.25rem;
+  background: transparent;
+  border: 1px solid var(--border-color);
+  border-radius: calc(var(--radius-scale, 0.25) * 0.5rem);
+  cursor: pointer;
+  transition: all 0.15s ease;
+}
+
+.tc-neutral-swatch::before {
+  content: '';
+  width: 16px;
+  height: 16px;
+  border-radius: 50%;
+  background-color: var(--swatch-color);
+  box-shadow: inset 0 0 0 1px rgba(0, 0, 0, 0.1);
+}
+
+.tc-neutral-swatch span {
+  font-size: var(--font-size-xs);
+  color: var(--text-primary);
+}
+
+.tc-neutral-swatch:hover {
+  background-color: var(--bg-secondary);
+  border-color: var(--border-color-dark);
+}
+
+.tc-neutral-swatch:focus-visible {
+  outline: 2px solid var(--color-primary);
+  outline-offset: 1px;
+}
+
+.tc-neutral-swatch.is-active {
+  background-color: var(--bg-secondary);
+  border-color: var(--text-primary);
+}
+
+/* Radius Group */
+.tc-radius-group {
+  display: flex;
+  gap: 0;
+}
+
+.tc-radius-btn {
+  flex: 1;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  padding: 0.5rem 0.25rem;
+  background: transparent;
+  border: 1px solid var(--border-color);
+  color: var(--text-primary);
+  font-size: var(--font-size-xs);
+  font-weight: var(--font-weight-medium);
+  cursor: pointer;
+  transition: all 0.15s ease;
+}
+
+.tc-radius-btn:first-child {
+  border-radius: calc(var(--radius-scale, 0.25) * 0.5rem) 0 0 calc(var(--radius-scale, 0.25) * 0.5rem);
+}
+
+.tc-radius-btn:last-child {
+  border-radius: 0 calc(var(--radius-scale, 0.25) * 0.5rem) calc(var(--radius-scale, 0.25) * 0.5rem) 0;
+}
+
+.tc-radius-btn:not(:first-child) {
+  margin-left: -1px;
+}
+
+.tc-radius-btn:hover {
+  background-color: var(--bg-secondary);
+  z-index: 1;
+}
+
+.tc-radius-btn:focus-visible {
+  outline: 2px solid var(--color-primary);
+  outline-offset: 1px;
+  z-index: 2;
+}
+
+.tc-radius-btn.is-active {
+  background-color: var(--bg-dark);
+  border-color: var(--bg-dark);
+  color: var(--text-inverse);
+  z-index: 1;
+}
+
+/* Font Select */
+.tc-font-select {
+  width: 100%;
+  padding: 0.5rem 0.75rem;
+  background-color: var(--bg-primary);
+  border: 1px solid var(--border-color);
+  border-radius: calc(var(--radius-scale, 0.25) * 0.5rem);
+  color: var(--text-primary);
+  font-size: var(--font-size-sm);
+  cursor: pointer;
+  transition: border-color 0.15s ease;
+}
+
+.tc-font-select:hover {
+  border-color: var(--border-color-dark);
+}
+
+.tc-font-select:focus {
+  outline: none;
+  border-color: var(--color-primary);
+  box-shadow: 0 0 0 3px var(--color-primary-alpha-10);
+}
+
+/* Mode Group */
+.tc-mode-group {
+  display: flex;
+  gap: 0;
+}
+
+.tc-mode-btn {
+  flex: 1;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  gap: 0.375rem;
+  padding: 0.5rem 0.5rem;
+  background: transparent;
+  border: 1px solid var(--border-color);
+  color: var(--text-primary);
+  font-size: var(--font-size-xs);
+  cursor: pointer;
+  transition: all 0.15s ease;
+}
+
+.tc-mode-btn:first-child {
+  border-radius: calc(var(--radius-scale, 0.25) * 0.5rem) 0 0 calc(var(--radius-scale, 0.25) * 0.5rem);
+}
+
+.tc-mode-btn:last-child {
+  border-radius: 0 calc(var(--radius-scale, 0.25) * 0.5rem) calc(var(--radius-scale, 0.25) * 0.5rem) 0;
+}
+
+.tc-mode-btn:not(:first-child) {
+  margin-left: -1px;
+}
+
+.tc-mode-btn:hover {
+  background-color: var(--bg-secondary);
+  z-index: 1;
+}
+
+.tc-mode-btn:focus-visible {
+  outline: 2px solid var(--color-primary);
+  outline-offset: 1px;
+  z-index: 2;
+}
+
+.tc-mode-btn.is-active {
+  background-color: var(--bg-dark);
+  border-color: var(--bg-dark);
+  color: var(--text-inverse);
+  z-index: 1;
+}
+
+.tc-mode-btn i {
+  font-size: 1rem;
+}
+
+/* ==========================================================================
+   Trigger Button
+   ========================================================================== */
+
+.vd-theme-customizer {
+  position: relative;
+  display: inline-flex;
+  align-items: center;
+}
+
+.vd-theme-customizer-trigger {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  width: 2.5rem;
+  height: 2.5rem;
+  padding: 0;
+  background: transparent;
+  border: 1px solid var(--border-color);
+  border-radius: var(--btn-border-radius);
+  color: var(--text-primary);
+  cursor: pointer;
+  transition: all 0.2s ease;
+}
+
+.vd-theme-customizer-trigger:hover {
+  background-color: var(--bg-secondary);
+  border-color: var(--color-primary);
+  color: var(--color-primary);
+}
+
+.vd-theme-customizer-trigger:focus-visible {
+  outline: 2px solid var(--color-primary);
+  outline-offset: 2px;
+}
+
+.vd-theme-customizer-trigger i {
+  font-size: 1.25rem;
+}
+
+.vd-theme-customizer-trigger[aria-expanded="true"] {
+  background-color: var(--color-primary-alpha-10);
+  border-color: var(--color-primary);
+  color: var(--color-primary);
+}
+
+/* ==========================================================================
+    Panel
+    ========================================================================== */
+
+.vd-theme-customizer-panel {
+  position: fixed;
+  /* top is set dynamically by JS based on actual navbar height */
+  top: 55px;
+  right: 0;
+  width: var(--customizer-width);
+  max-height: calc(100vh - 55px);
+  overflow-y: auto;
+  padding: 0; /* Override .vd-navbar-fixed ~ * padding-top rule */
+  background-color: var(--customizer-bg);
+  border: 1px solid var(--customizer-border);
+  border-radius: calc(var(--radius-scale, 0.25) * 1rem);
+  box-shadow: var(--customizer-shadow);
+  z-index: var(--customizer-z-index);
+  opacity: 0;
+  visibility: hidden;
+  transform: translateY(-10px);
+  transition: opacity 0.2s ease, transform 0.2s ease, visibility 0.2s ease;
+}
+
+.vd-theme-customizer-panel.is-open {
+  opacity: 1;
+  visibility: visible;
+  transform: translateY(0);
+}
+
+.vd-theme-customizer-panel-inner {
+  padding: var(--customizer-padding);
+}
+
+/* ==========================================================================
+   Sections
+   ========================================================================== */
+
+.customizer-section {
+  margin-bottom: 1.25rem;
+}
+
+.customizer-section:last-child {
+  margin-bottom: 0;
+}
+
+.customizer-section-title {
+  display: flex;
+  align-items: center;
+  gap: 0.375rem;
+  margin-bottom: 0.625rem;
+  font-size: var(--font-size-sm);
+  font-weight: var(--font-weight-medium);
+  color: var(--text-primary);
+}
+
+.customizer-help {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  width: 1rem;
+  height: 1rem;
+  padding: 0;
+  background: transparent;
+  border: none;
+  color: var(--text-muted);
+  cursor: help;
+  font-size: 0.75rem;
+}
+
+.customizer-help:hover {
+  color: var(--text-primary);
+}
+
+/* ==========================================================================
+   Color Swatches (Primary & Neutral)
+   ========================================================================== */
+
+.customizer-colors {
+  display: grid;
+  grid-template-columns: repeat(3, 1fr);
+  gap: 0.375rem;
+}
+
+.customizer-swatch {
+  display: flex;
+  align-items: center;
+  gap: 0.5rem;
+  padding: 0.375rem 0.5rem;
+  background: transparent;
+  border: 1px solid var(--border-color);
+  border-radius: var(--btn-border-radius);
+  cursor: pointer;
+  transition: all 0.15s ease;
+  text-align: left;
+}
+
+.customizer-swatch:hover {
+  background-color: var(--bg-secondary);
+  border-color: var(--border-color-dark);
+}
+
+.customizer-swatch:focus-visible {
+  outline: 2px solid var(--color-primary);
+  outline-offset: 1px;
+}
+
+.customizer-swatch.is-active {
+  background-color: var(--bg-secondary);
+  border-color: var(--text-primary);
+}
+
+.customizer-swatch-dot {
+  flex-shrink: 0;
+  width: 12px;
+  height: 12px;
+  border-radius: 50%;
+  background-color: var(--swatch-color);
+  box-shadow: inset 0 0 0 1px rgba(0, 0, 0, 0.1);
+}
+
+.customizer-swatch-label {
+  font-size: var(--font-size-xs);
+  color: var(--text-primary);
+  white-space: nowrap;
+  overflow: hidden;
+  text-overflow: ellipsis;
+}
+
+/* Neutral swatches - 5 columns */
+.customizer-neutral-colors {
+  grid-template-columns: repeat(5, 1fr);
+}
+
+.customizer-neutral-colors .customizer-swatch {
+  flex-direction: column;
+  padding: 0.5rem 0.25rem;
+  text-align: center;
+}
+
+.customizer-neutral-colors .customizer-swatch-dot {
+  width: 16px;
+  height: 16px;
+}
+
+.customizer-neutral-colors .customizer-swatch-label {
+  margin-top: 0.25rem;
+}
+
+/* ==========================================================================
+   Radius Options
+   ========================================================================== */
+
+.customizer-radius {
+  display: flex;
+  gap: 0.25rem;
+}
+
+.customizer-radius-btn {
+  flex: 1;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  padding: 0.5rem 0.25rem;
+  background: transparent;
+  border: 1px solid var(--border-color);
+  color: var(--text-primary);
+  font-size: var(--font-size-xs);
+  font-weight: var(--font-weight-medium);
+  cursor: pointer;
+  transition: all 0.15s ease;
+}
+
+.customizer-radius-btn:first-child {
+  border-radius: var(--btn-border-radius) 0 0 var(--btn-border-radius);
+}
+
+.customizer-radius-btn:last-child {
+  border-radius: 0 var(--btn-border-radius) var(--btn-border-radius) 0;
+}
+
+.customizer-radius-btn:not(:first-child) {
+  margin-left: -1px;
+}
+
+.customizer-radius-btn:hover {
+  background-color: var(--bg-secondary);
+  z-index: 1;
+}
+
+.customizer-radius-btn:focus-visible {
+  outline: 2px solid var(--color-primary);
+  outline-offset: 1px;
+  z-index: 2;
+}
+
+.customizer-radius-btn.is-active {
+  background-color: var(--bg-dark);
+  border-color: var(--bg-dark);
+  color: var(--text-inverse);
+  z-index: 1;
+}
+
+/* ==========================================================================
+   Font Selector
+   ========================================================================== */
+
+.customizer-font {
+  position: relative;
+}
+
+.customizer-font .vd-input {
+  width: 100%;
+  padding-left: 2rem;
+}
+
+.customizer-font-icon {
+  position: absolute;
+  left: 0.625rem;
+  top: 50%;
+  transform: translateY(-50%);
+  color: var(--text-muted);
+  pointer-events: none;
+}
+
+/* ==========================================================================
+   Color Mode Switcher
+   ========================================================================== */
+
+.customizer-mode {
+  display: flex;
+  gap: 0.25rem;
+}
+
+.customizer-mode-btn {
+  flex: 1;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  gap: 0.375rem;
+  padding: 0.5rem 0.5rem;
+  background: transparent;
+  border: 1px solid var(--border-color);
+  color: var(--text-primary);
+  font-size: var(--font-size-xs);
+  cursor: pointer;
+  transition: all 0.15s ease;
+}
+
+.customizer-mode-btn:first-child {
+  border-radius: var(--btn-border-radius) 0 0 var(--btn-border-radius);
+}
+
+.customizer-mode-btn:last-child {
+  border-radius: 0 var(--btn-border-radius) var(--btn-border-radius) 0;
+}
+
+.customizer-mode-btn:not(:first-child) {
+  margin-left: -1px;
+}
+
+.customizer-mode-btn:hover {
+  background-color: var(--bg-secondary);
+  z-index: 1;
+}
+
+.customizer-mode-btn:focus-visible {
+  outline: 2px solid var(--color-primary);
+  outline-offset: 1px;
+  z-index: 2;
+}
+
+.customizer-mode-btn.is-active {
+  background-color: var(--bg-dark);
+  border-color: var(--bg-dark);
+  color: var(--text-inverse);
+  z-index: 1;
+}
+
+.customizer-mode-btn i {
+  font-size: 1rem;
+}
+
+/* ==========================================================================
+   Dark Theme Overrides
+   ========================================================================== */
+
+[data-theme="dark"] {
+  --customizer-bg: var(--bg-primary);
+  --customizer-border: var(--border-color);
+}
+
+[data-theme="dark"] .customizer-swatch-dot,
+[data-theme="dark"] .tc-neutral-swatch::before {
+  box-shadow: inset 0 0 0 1px rgba(255, 255, 255, 0.1);
+}
+
+[data-theme="dark"] .customizer-radius-btn.is-active,
+[data-theme="dark"] .customizer-mode-btn.is-active,
+[data-theme="dark"] .tc-radius-btn.is-active,
+[data-theme="dark"] .tc-mode-btn.is-active {
+  background-color: var(--gray-2);
+  border-color: var(--gray-2);
+  color: var(--gray-9);
+}
+
+@media (prefers-color-scheme: dark) {
+  :root:not([data-theme]) {
+    --customizer-bg: var(--bg-primary);
+    --customizer-border: var(--border-color);
+  }
+
+  :root:not([data-theme]) .customizer-swatch-dot,
+  :root:not([data-theme]) .tc-neutral-swatch::before {
+    box-shadow: inset 0 0 0 1px rgba(255, 255, 255, 0.1);
+  }
+
+  :root:not([data-theme]) .customizer-radius-btn.is-active,
+  :root:not([data-theme]) .customizer-mode-btn.is-active,
+  :root:not([data-theme]) .tc-radius-btn.is-active,
+  :root:not([data-theme]) .tc-mode-btn.is-active {
+    background-color: var(--gray-2);
+    border-color: var(--gray-2);
+    color: var(--gray-9);
+  }
+}
+
+/* ==========================================================================
+    Mobile Responsive
+    ========================================================================== */
+
+@media (max-width: 767.98px) {
+  .vd-theme-customizer-panel,
+  body > .vd-theme-customizer-panel {
+    position: fixed;
+    top: 0;
+    right: -100%;
+    bottom: 0;
+    width: 100%;
+    max-width: 320px;
+    max-height: none;
+    border: none;
+    border-left: 1px solid var(--customizer-border);
+    border-radius: 0;
+    transform: none;
+    opacity: 1;
+    transition: right 0.3s ease, visibility 0.3s ease;
+  }
+
+  .vd-theme-customizer-panel.is-open,
+  body > .vd-theme-customizer-panel.is-open {
+    right: 0;
+    transform: none;
+    visibility: visible;
+  }
+
+  .vd-theme-customizer-panel-inner,
+  .tc-body {
+    padding: 1.5rem;
+  }
+
+  .tc-header {
+    padding: 1rem 1.5rem;
+  }
+
+  .tc-footer {
+    padding: 1rem 1.5rem;
+  }
+
+  /* Mobile close button */
+  .customizer-mobile-close {
+    position: absolute;
+    top: 1rem;
+    right: 1rem;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    width: 2rem;
+    height: 2rem;
+    padding: 0;
+    background: transparent;
+    border: 1px solid var(--border-color);
+    border-radius: calc(var(--radius-scale, 0.25) * 0.5rem);
+    color: var(--text-primary);
+    cursor: pointer;
+  }
+
+  .customizer-mobile-close:hover {
+    background-color: var(--bg-secondary);
+  }
+
+  /* Mobile overlay */
+  .vd-theme-customizer-overlay {
+    position: fixed;
+    top: 0;
+    left: 0;
+    right: 0;
+    bottom: 0;
+    background-color: rgba(0, 0, 0, 0.5);
+    z-index: calc(var(--customizer-z-index) - 1);
+    opacity: 0;
+    visibility: hidden;
+    transition: opacity 0.3s ease, visibility 0.3s ease;
+  }
+
+  .vd-theme-customizer-overlay.is-active {
+    opacity: 1;
+    visibility: visible;
+  }
+}
+
+@media (min-width: 768px) {
+  .customizer-mobile-close {
+    display: none;
+  }
+
+  .vd-theme-customizer-overlay {
+    display: none;
+  }
+}
+
+/* ==========================================================================
+   Scrollbar Styling
+   ========================================================================== */
+
+.vd-theme-customizer-panel::-webkit-scrollbar {
+  width: 6px;
+}
+
+.vd-theme-customizer-panel::-webkit-scrollbar-track {
+  background: transparent;
+}
+
+.vd-theme-customizer-panel::-webkit-scrollbar-thumb {
+  background-color: var(--border-color);
+  border-radius: 3px;
+}
+
+.vd-theme-customizer-panel::-webkit-scrollbar-thumb:hover {
+  background-color: var(--text-muted);
+}
+
+/* ==========================================================================
+   Animation for panel header
+   ========================================================================== */
+
+.customizer-header {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  padding-bottom: 0.75rem;
+  margin-bottom: 0.75rem;
+  border-bottom: 1px solid var(--border-color);
+}
+
+.customizer-title {
+  font-size: var(--font-size-base);
+  font-weight: var(--font-weight-semibold);
+  color: var(--text-primary);
+  margin: 0;
+}
+
+.customizer-reset {
+  display: inline-flex;
+  align-items: center;
+  gap: 0.25rem;
+  padding: 0.25rem 0.5rem;
+  background: transparent;
+  border: 1px solid var(--border-color);
+  border-radius: var(--btn-border-radius);
+  color: var(--text-muted);
+  font-size: var(--font-size-xs);
+  cursor: pointer;
+  transition: all 0.15s ease;
+}
+
+.customizer-reset:hover {
+  background-color: var(--bg-secondary);
+  color: var(--text-primary);
+  border-color: var(--border-color-dark);
+}
+
+.customizer-reset:focus-visible {
+  outline: 2px solid var(--color-primary);
+  outline-offset: 1px;
+}