@vanduo-oss/framework 1.3.0 → 1.3.2

package/README.md

@@ -1,4 +1,4 @@
-# Vanduo Framework v1.3.0
+# Vanduo Framework v1.3.2
 
 <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 with **45+ components** for designing beautiful interfaces. Zero runtime dependencies, no mandatory build tools, just clean and simple code.
+A lightweight, pure HTML/CSS/JS framework with **46+ components** for designing beautiful interfaces. Zero runtime dependencies, no mandatory build tools, just clean and simple code.
 
 [**Browse Full Documentation →**](https://vanduo.dev/#docs)
 
@@ -38,20 +38,21 @@ A lightweight, pure HTML/CSS/JS framework with **45+ components** for designing
 
 ---
 
-## What's New in v1.3.0
+## What's New in v1.3.2
 
-v1.3.0 is a maintenance release focused on documentation improvements and framework consistency:
+v1.3.2 is a component release centered on audio playback, with no breaking changes:
 
-- **Added missing spacing utilities and text-italic class.** The framework now includes `.vd-mt-6` and `.vd-mt-8` spacing utilities, plus `.vd-text-italic` for text styling.
-- **Fixed phantom class references in documentation.** Updated docs to use correct class names that match the actual framework implementation.
-- **Improved documentation structure.** Added inline sidebar filter for Components & Guides pages, unified component documentation structure, and refreshed visual styling.
-- **Release artifacts and docs are aligned for v1.3.0.** Package metadata, generated bundles, `llms.txt`, and release-facing README examples now point at the current version.
+- **New Music Player component.** Ships a zero-dependency HTML5 audio player with play/pause, previous/next, volume, track title, and optional progress, shuffle, and playlist controls.
+- **Framework-friendly API.** Accepts a plain JavaScript tracks array (`[{ name, url }]`), exposes custom events, and supports programmatic control through `window.VanduoMusicPlayer`.
+- **Responsive player layout.** Control wrapping and volume sizing were tuned so the component stays usable across compact, inline, and mobile layouts.
+- **Release coverage and artifacts updated.** Package metadata, generated bundles, `llms.txt`, and release-facing README examples now point at v1.3.2.
 
-The framework still ships **45+ components**, including the v1.2.7 additions below.
+The framework now ships **46+ components**, including the new Music Player and the additions below.
 
 | Component | Vanduo Name | Type |
 |---|---|---|
 | Carousel | Flow | CSS + JS |
+| Music Player | Music Player | CSS + JS |
 | Popover | Bubble | CSS + JS |
 | Scrollspy | Waypoint | CSS + JS |
 | Offcanvas | — (enhanced Sidenav) | CSS + JS |
@@ -88,8 +89,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.3.0/dist/vanduo.min.css">
-<script src="https://cdn.jsdelivr.net/gh/vanduo-oss/framework@v1.3.0/dist/vanduo.min.js"></script>
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/gh/vanduo-oss/framework@v1.3.2/dist/vanduo.min.css">
+<script src="https://cdn.jsdelivr.net/gh/vanduo-oss/framework@v1.3.2/dist/vanduo.min.js"></script>
 <script>Vanduo.init();</script>
 ```
 
@@ -152,7 +153,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.3.0
+pnpm run release:assets -- v1.3.2
 ```
 
 Notes:

package/css/components/music-player.css

@@ -0,0 +1,578 @@
+/**
+ * Vanduo Framework - Music Player
+ * Audio playback component with transport controls, volume, and optional
+ * shuffle, progress bar, and playlist features.
+ */
+
+:root {
+  /* Sizing (Fibonacci pairs) */
+  --music-player-padding-x: 1.3125rem;     /* 21px */
+  --music-player-padding-y: 0.8125rem;     /* 13px */
+  --music-player-padding-x-sm: 0.8125rem;  /* 13px */
+  --music-player-padding-y-sm: 0.5rem;     /*  8px */
+  --music-player-padding-x-lg: 2.125rem;   /* 34px */
+  --music-player-padding-y-lg: 1.3125rem;  /* 21px */
+  --music-player-gap: 0.8125rem;           /* 13px */
+  --music-player-btn-size: 2.125rem;       /* 34px */
+  --music-player-btn-size-sm: 1.625rem;    /* 26px */
+  --music-player-btn-size-lg: 2.625rem;    /* 42px */
+  --music-player-icon-size: 1.125rem;
+  --music-player-volume-width: clamp(3.25rem, 16vw, 4.5rem);
+  --music-player-volume-width-sm: 3rem;
+  --music-player-volume-width-lg: 5.5rem;
+  --music-player-border-radius: var(--border-radius, 0.5rem);
+  --music-player-border-width: 1px;
+
+  /* Colors */
+  --music-player-bg: var(--bg-primary);
+  --music-player-bg-secondary: var(--bg-secondary);
+  --music-player-border: var(--border-color);
+  --music-player-text: var(--text-primary);
+  --music-player-text-muted: var(--text-muted);
+  --music-player-accent: var(--color-primary);
+  --music-player-btn-hover-bg: var(--bg-secondary);
+  --music-player-btn-active-bg: var(--color-primary-alpha-10, rgba(var(--color-primary-rgb, 59,130,246), 0.1));
+  --music-player-track-bg: var(--border-color);
+  --music-player-track-fill: var(--color-primary);
+  --music-player-playlist-hover: var(--bg-secondary);
+  --music-player-playlist-active-bg: var(--color-primary-alpha-10, rgba(var(--color-primary-rgb, 59,130,246), 0.1));
+  --music-player-playlist-active-text: var(--color-primary);
+
+  /* Transitions */
+  --music-player-transition: 0.15s ease;
+}
+
+/* Dark Theme */
+[data-theme="dark"] {
+  --music-player-bg: var(--bg-primary);
+  --music-player-bg-secondary: var(--color-gray-800);
+  --music-player-btn-hover-bg: var(--color-gray-700);
+  --music-player-playlist-hover: var(--color-gray-700);
+}
+
+@media (prefers-color-scheme: dark) {
+  :root:not([data-theme]) {
+    --music-player-bg: var(--bg-primary);
+    --music-player-bg-secondary: var(--color-gray-800);
+    --music-player-btn-hover-bg: var(--color-gray-700);
+    --music-player-playlist-hover: var(--color-gray-700);
+  }
+}
+
+/* ============================================================
+   Base Container
+   ============================================================ */
+
+.vd-music-player {
+  display: flex;
+  flex-direction: column;
+  gap: 0;
+  background-color: var(--music-player-bg);
+  border: var(--music-player-border-width) solid var(--music-player-border);
+  border-radius: var(--music-player-border-radius);
+  padding: var(--music-player-padding-y) var(--music-player-padding-x);
+  min-width: 16rem;
+  max-width: 28rem;
+  width: 100%;
+  box-sizing: border-box;
+}
+
+/* ============================================================
+   Now Playing — track info bar
+   ============================================================ */
+
+.vd-music-player-info {
+  display: flex;
+  align-items: center;
+  gap: 0.625rem;
+  min-height: 1.5rem;
+  margin-bottom: 0.625rem;
+}
+
+.vd-music-player-icon {
+  flex-shrink: 0;
+  color: var(--music-player-accent);
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  width: 1rem;
+  height: 1rem;
+}
+
+.vd-music-player-track-name {
+  font-size: var(--font-size-sm, 0.875rem);
+  color: var(--music-player-text);
+  flex: 1;
+  overflow: hidden;
+  white-space: nowrap;
+  text-overflow: ellipsis;
+  min-width: 0;
+}
+
+.vd-music-player-track-name.is-idle {
+  color: var(--music-player-text-muted);
+  font-style: italic;
+}
+
+/* ============================================================
+   Controls Row
+   ============================================================ */
+
+.vd-music-player-controls {
+  display: flex;
+  align-items: center;
+  flex-wrap: wrap;
+  gap: 0.375rem;
+}
+
+.vd-music-player-btn {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  width: var(--music-player-btn-size);
+  height: var(--music-player-btn-size);
+  padding: 0;
+  background: transparent;
+  border: none;
+  border-radius: var(--music-player-border-radius);
+  color: var(--music-player-text);
+  cursor: pointer;
+  transition:
+    background-color var(--music-player-transition),
+    color var(--music-player-transition);
+  flex-shrink: 0;
+}
+
+.vd-music-player-btn:hover:not(:disabled) {
+  background-color: var(--music-player-btn-hover-bg);
+  color: var(--music-player-accent);
+}
+
+.vd-music-player-btn:focus-visible {
+  outline: 2px solid var(--music-player-accent);
+  outline-offset: 1px;
+}
+
+.vd-music-player-btn:disabled {
+  opacity: 0.38;
+  cursor: not-allowed;
+}
+
+.vd-music-player-btn.is-active {
+  color: var(--music-player-accent);
+  background-color: var(--music-player-btn-active-bg);
+}
+
+/* Play/Pause is slightly larger */
+.vd-music-player-btn-play {
+  width: calc(var(--music-player-btn-size) + 0.25rem);
+  height: calc(var(--music-player-btn-size) + 0.25rem);
+}
+
+.vd-music-player-btn svg,
+.vd-music-player-btn i {
+  width: var(--music-player-icon-size);
+  height: var(--music-player-icon-size);
+  font-size: var(--music-player-icon-size);
+  pointer-events: none;
+}
+
+/* Spacer to push volume to the right */
+.vd-music-player-spacer {
+  flex: 1 1 1.5rem;
+  min-width: 0;
+}
+
+/* ============================================================
+   Volume
+   ============================================================ */
+
+.vd-music-player-volume {
+  display: flex;
+  align-items: center;
+  gap: 0.3125rem;
+  flex: 0 1 auto;
+  min-width: 0;
+  max-width: 100%;
+}
+
+.vd-music-player-volume-icon {
+  flex-shrink: 0;
+  color: var(--music-player-text-muted);
+  display: flex;
+  align-items: center;
+  width: 1rem;
+  height: 1rem;
+  font-size: 1rem;
+}
+
+.vd-music-player-volume-slider {
+  -webkit-appearance: none;
+  appearance: none;
+  width: var(--music-player-volume-width);
+  height: 4px;
+  border-radius: 9999px;
+  background: var(--music-player-track-bg);
+  cursor: pointer;
+  outline: none;
+  min-width: 3.25rem;
+  max-width: 100%;
+  flex: 0 1 var(--music-player-volume-width);
+}
+
+.vd-music-player-volume-slider:focus-visible {
+  outline: 2px solid var(--music-player-accent);
+  outline-offset: 2px;
+}
+
+/* WebKit thumb */
+.vd-music-player-volume-slider::-webkit-slider-thumb {
+  -webkit-appearance: none;
+  appearance: none;
+  width: 0.75rem;
+  height: 0.75rem;
+  border-radius: 50%;
+  background: var(--music-player-accent);
+  cursor: pointer;
+  transition: transform var(--music-player-transition);
+}
+
+.vd-music-player-volume-slider::-webkit-slider-thumb:hover {
+  transform: scale(1.2);
+}
+
+/* Firefox thumb */
+.vd-music-player-volume-slider::-moz-range-thumb {
+  width: 0.75rem;
+  height: 0.75rem;
+  border-radius: 50%;
+  background: var(--music-player-accent);
+  cursor: pointer;
+  border: none;
+  transition: transform var(--music-player-transition);
+}
+
+.vd-music-player-volume-slider::-moz-range-thumb:hover {
+  transform: scale(1.2);
+}
+
+/* Firefox track fill */
+.vd-music-player-volume-slider::-moz-range-progress {
+  background: var(--music-player-track-fill);
+  border-radius: 9999px;
+}
+
+/* ============================================================
+   Progress Bar
+   ============================================================ */
+
+.vd-music-player-progress {
+  display: none;
+  align-items: center;
+  gap: 0.5rem;
+  margin-top: 0.625rem;
+}
+
+.vd-music-player.has-progress .vd-music-player-progress {
+  display: flex;
+}
+
+.vd-music-player-progress-bar {
+  -webkit-appearance: none;
+  appearance: none;
+  flex: 1;
+  height: 4px;
+  border-radius: 9999px;
+  background: var(--music-player-track-bg);
+  cursor: pointer;
+  outline: none;
+}
+
+.vd-music-player-progress-bar:focus-visible {
+  outline: 2px solid var(--music-player-accent);
+  outline-offset: 2px;
+}
+
+.vd-music-player-progress-bar::-webkit-slider-thumb {
+  -webkit-appearance: none;
+  appearance: none;
+  width: 0.75rem;
+  height: 0.75rem;
+  border-radius: 50%;
+  background: var(--music-player-accent);
+  cursor: pointer;
+  transition: transform var(--music-player-transition);
+}
+
+.vd-music-player-progress-bar::-webkit-slider-thumb:hover {
+  transform: scale(1.2);
+}
+
+.vd-music-player-progress-bar::-moz-range-thumb {
+  width: 0.75rem;
+  height: 0.75rem;
+  border-radius: 50%;
+  background: var(--music-player-accent);
+  border: none;
+  cursor: pointer;
+  transition: transform var(--music-player-transition);
+}
+
+.vd-music-player-progress-bar::-moz-range-progress {
+  background: var(--music-player-track-fill);
+  border-radius: 9999px;
+}
+
+.vd-music-player-time {
+  font-size: 0.6875rem;
+  color: var(--music-player-text-muted);
+  white-space: nowrap;
+  flex-shrink: 0;
+  font-variant-numeric: tabular-nums;
+  min-width: 2.5rem;
+  text-align: right;
+}
+
+.vd-music-player-time:first-child {
+  text-align: left;
+}
+
+/* ============================================================
+   Playlist
+   ============================================================ */
+
+.vd-music-player-playlist {
+  display: none;
+  flex-direction: column;
+  margin-top: 0.625rem;
+  border-top: var(--music-player-border-width) solid var(--music-player-border);
+  padding-top: 0.5rem;
+  max-height: 12rem;
+  overflow-y: auto;
+  scrollbar-width: thin;
+}
+
+.vd-music-player.has-playlist .vd-music-player-playlist.is-open {
+  display: flex;
+}
+
+.vd-music-player-playlist-item {
+  display: flex;
+  align-items: center;
+  gap: 0.5rem;
+  padding: 0.375rem 0.5rem;
+  border-radius: calc(var(--music-player-border-radius) * 0.5);
+  cursor: pointer;
+  font-size: var(--font-size-sm, 0.875rem);
+  color: var(--music-player-text);
+  background: transparent;
+  border: none;
+  text-align: left;
+  width: 100%;
+  transition:
+    background-color var(--music-player-transition),
+    color var(--music-player-transition);
+}
+
+.vd-music-player-playlist-item:hover {
+  background-color: var(--music-player-playlist-hover);
+}
+
+.vd-music-player-playlist-item:focus-visible {
+  outline: 2px solid var(--music-player-accent);
+  outline-offset: 1px;
+}
+
+.vd-music-player-playlist-item.is-active {
+  background-color: var(--music-player-playlist-active-bg);
+  color: var(--music-player-playlist-active-text);
+  font-weight: var(--font-weight-medium, 500);
+}
+
+.vd-music-player-playlist-num {
+  flex-shrink: 0;
+  width: 1.25rem;
+  font-size: 0.6875rem;
+  color: var(--music-player-text-muted);
+  text-align: right;
+  font-variant-numeric: tabular-nums;
+}
+
+.vd-music-player-playlist-item.is-active .vd-music-player-playlist-num {
+  color: var(--music-player-accent);
+}
+
+.vd-music-player-playlist-name {
+  flex: 1;
+  overflow: hidden;
+  white-space: nowrap;
+  text-overflow: ellipsis;
+  min-width: 0;
+}
+
+/* ============================================================
+   Variants — Compact (floating minimal bar)
+   ============================================================ */
+
+.vd-music-player-compact {
+  flex-direction: row;
+  align-items: center;
+  padding: 0.5rem 0.8125rem;
+  min-width: auto;
+  max-width: none;
+  width: auto;
+  gap: 0.5rem;
+}
+
+.vd-music-player-compact .vd-music-player-info {
+  display: none;
+}
+
+.vd-music-player-compact .vd-music-player-controls {
+  gap: 0.125rem;
+}
+
+/* ============================================================
+   Variants — Inline (full-width bar)
+   ============================================================ */
+
+.vd-music-player-inline {
+  flex-direction: row;
+  align-items: center;
+  flex-wrap: wrap;
+  padding: 0.625rem var(--music-player-padding-x);
+  min-width: 0;
+  max-width: none;
+  gap: 0.625rem;
+}
+
+.vd-music-player-inline .vd-music-player-info {
+  flex: 1;
+  min-width: 8rem;
+  margin-bottom: 0;
+}
+
+.vd-music-player-inline .vd-music-player-controls {
+  flex: 1 1 auto;
+  justify-content: flex-end;
+  min-width: 0;
+}
+
+.vd-music-player-inline .vd-music-player-volume {
+  flex: 0 1 auto;
+}
+
+.vd-music-player-inline .vd-music-player-volume-slider {
+  width: clamp(4rem, 18vw, 5.5rem);
+  flex-basis: clamp(4rem, 18vw, 5.5rem);
+}
+
+.vd-music-player-inline .vd-music-player-progress {
+  flex-basis: 100%;
+  margin-top: 0.375rem;
+}
+
+/* ============================================================
+   Sizes
+   ============================================================ */
+
+.vd-music-player-sm {
+  padding: var(--music-player-padding-y-sm) var(--music-player-padding-x-sm);
+  font-size: var(--font-size-sm, 0.875rem);
+}
+
+.vd-music-player-sm .vd-music-player-btn {
+  width: var(--music-player-btn-size-sm);
+  height: var(--music-player-btn-size-sm);
+}
+
+.vd-music-player-sm .vd-music-player-btn-play {
+  width: calc(var(--music-player-btn-size-sm) + 0.125rem);
+  height: calc(var(--music-player-btn-size-sm) + 0.125rem);
+}
+
+.vd-music-player-sm .vd-music-player-btn svg,
+.vd-music-player-sm .vd-music-player-btn i {
+  font-size: 0.9375rem;
+  width: 0.9375rem;
+  height: 0.9375rem;
+}
+
+.vd-music-player-sm .vd-music-player-volume-slider {
+  width: var(--music-player-volume-width-sm);
+  min-width: var(--music-player-volume-width-sm);
+  flex-basis: var(--music-player-volume-width-sm);
+}
+
+.vd-music-player-lg {
+  padding: var(--music-player-padding-y-lg) var(--music-player-padding-x-lg);
+}
+
+.vd-music-player-lg .vd-music-player-btn {
+  width: var(--music-player-btn-size-lg);
+  height: var(--music-player-btn-size-lg);
+}
+
+.vd-music-player-lg .vd-music-player-btn-play {
+  width: calc(var(--music-player-btn-size-lg) + 0.25rem);
+  height: calc(var(--music-player-btn-size-lg) + 0.25rem);
+}
+
+.vd-music-player-lg .vd-music-player-btn svg,
+.vd-music-player-lg .vd-music-player-btn i {
+  font-size: 1.25rem;
+  width: 1.25rem;
+  height: 1.25rem;
+}
+
+.vd-music-player-lg .vd-music-player-volume-slider {
+  width: var(--music-player-volume-width-lg);
+  min-width: 4rem;
+  flex-basis: var(--music-player-volume-width-lg);
+}
+
+/* ============================================================
+   Neutral color variant — use gray instead of primary
+   ============================================================ */
+
+.vd-music-player-neutral {
+  --music-player-accent: var(--text-primary);
+  --music-player-track-fill: var(--text-primary);
+  --music-player-playlist-active-text: var(--text-primary);
+  --music-player-playlist-active-bg: var(--bg-secondary);
+  --music-player-btn-active-bg: var(--bg-secondary);
+}
+
+/* ============================================================
+   Reduced Motion
+   ============================================================ */
+
+@media (prefers-reduced-motion: reduce) {
+  .vd-music-player-btn,
+  .vd-music-player-volume-slider::-webkit-slider-thumb,
+  .vd-music-player-volume-slider::-moz-range-thumb,
+  .vd-music-player-progress-bar::-webkit-slider-thumb,
+  .vd-music-player-progress-bar::-moz-range-thumb,
+  .vd-music-player-playlist-item {
+    transition: none;
+  }
+}
+
+@media (max-width: 640px) {
+  .vd-music-player {
+    min-width: 0;
+    max-width: none;
+  }
+
+  .vd-music-player-controls {
+    row-gap: 0.5rem;
+  }
+
+  .vd-music-player-spacer {
+    display: none;
+  }
+
+  .vd-music-player-volume {
+    margin-left: auto;
+  }
+}

package/css/components/navbar.css

@@ -528,3 +528,8 @@
   display: none;
 }
 
+/* Body Scroll Lock - class-based to avoid conflicts with modals */
+.body-navbar-open {
+  overflow: hidden;
+}
+

package/css/vanduo.css

@@ -95,6 +95,7 @@
 @import url('components/transfer.css');
 @import url('components/tree.css');
 @import url('components/spotlight.css');
+@import url('components/music-player.css');
 
 /* Print Styles */
 @import url('utilities/print.css');

package/dist/build-info.json

@@ -1,6 +1,6 @@
 {
-  "version": "1.3.0",
-  "builtAt": "2026-03-17T16:46:03.216Z",
-  "commit": "ea44b23",
+  "version": "1.3.2",
+  "builtAt": "2026-04-06T19:04:41.601Z",
+  "commit": "8e08b38",
   "mode": "development+production"
 }