30th of June 2026
13.0.14 to 13.0.18 - Patch

• Fixed: Iconify icons not displaying - CDN dependency removed: Both the Iconify web component (iconify-icon.min.js) and the icon data (vitreous-icons.js) are now served entirely from assets/. No external CDN calls are made at any point. iconify-icon.min.js (v2.3.0) added to assets/. vitreous-icons.js added to assets/ - calls Iconify.addCollection() with SVG body data for all eight line-md icons used across the Track List, Artist Card, Artist List, and Single Track Player widgets, pre-loading them so the web component never needs to fetch from api.iconify.design. Both scripts registered via wp_register_script on init in a new register_scripts() method, enqueued via wp_enqueue_script in enqueue_fontawesome(). vitreous-icons declares iconify-icon as a dependency so load order is guaranteed. All elements and JS icon state handling remain exactly as v13.0.13.
• Added: assets/iconify-icon.min.js - Iconify web component v2.3.0, served locally.
• Added: assets/vitreous-icons.js - local icon data bundle for all eight line-md icons.
• Added: assets/line-md--*.svg - source SVG files for all eight icons.

10th of June 2026
13.0.12 to 13.0.13 - Patch

• Changelog: per-major version files: CHANGELOG.md split into individual files per major version in a changelog/ directory (CHANGELOG-13.md, CHANGELOG-12.md, etc). The admin page now reads only the selected major version file: dramatically faster load on shared hosting. Major version tabs added to the top of the changelog page for navigation. Search and pagination work within the selected major version. Active tab highlighted in gold. Future builds prepend new entries to changelog/CHANGELOG-{major}.md.

10th of June 2026
v13.0.11 - Patch

• Fixed: Changelog bullet points not showing: WordPress admin globally resets ul and li styles. The .vt-cl-md ul/li CSS rules lacked sufficient specificity to override them. Scoped under .vitreous-changelog-wrap and added display: list-item to force correct list rendering.

10th of June 2026
v13.0.10 - Minor

• Changelog system rebuilt: The changelog-page.php admin page previously contained 5,000+ lines of raw HTML markup in violation of the admin markup rules. All 287 version entries have been migrated to CHANGELOG.md in the plugin root using standard Markdown format. The admin page now reads and renders this file via Parsedown (MIT licensed, single-file PHP Markdown parser). The page is paginated at 10 entries per page and includes a search field. Future changelog entries are added to CHANGELOG.md as Markdown during the build process.

• Added: admin/Parsedown.php: Parsedown v1.x, MIT licence.

• Added: CHANGELOG.md: full version history from v3.0.0 to v13.0.9.

9th of June 2026
v13.0.9 - Patch

• Fixed: Artist Card and Artist List minified players: artist-tracklist-helper.php still had and elements. Replaced with matching the Track List Accordion standard.
• Fixed: Single Track Player button size override: vitreous-track-player.css had a 36px width/height override on .vt-list-play-btn which diverged from the shared 34px standard. Removed: button size now inherits from vitreous-list.css. Only accent colour overrides remain per widget.

9th of June 2026
v13.0.8 - Patch

• Fixed: Mute icon incorrect name: line-md:volume-off does not exist in the line-md icon set. Replaced with line-md:volume-remove: speaker with an X, clearly communicating zero output.

9th of June 2026
v13.0.7 - Patch

• Fixed: Volume mute icon not responding: vtListInit fires on DOMContentLoaded but the Iconify script loads in the footer: after DOMContentLoaded. Storing volIcon at bind time always captured null because querySelector('iconify-icon') finds nothing before Iconify registers the custom element. The stored reference was always null so vtListUpdateVolIcon returned early on every mute press. Removed the stored reference: the function now queries fresh on every call, by which time Iconify is fully loaded.

9th of June 2026
v13.0.6 - Patch

• Fixed: Volume mute icon not responding: Vol icon reference was queried at event time via querySelector which may miss the custom element if Iconify has not fully registered it. Now stored once as volIcon at player bind time and passed directly to vtListUpdateVolIcon().
• Fixed: Play icon vertical position: Added display: block to prevent inline baseline spacing affecting height. Changed bottom: 8px to bottom: 6px to move the icon down by 2px: the line-md:play triangle has optical weight in the upper portion of its viewBox so needed shifting down.

9th of June 2026
v13.0.5 - Patch

• Fixed: Mute icon not responding: Added fallback selector in vtListUpdateVolIcon to find either iconify-icon or i elements. Added setAttribute check before calling it to handle both element types gracefully.
• Fixed: Play icon alignment: Removed transform: translate approach which made misalignment worse. Switched to position: absolute; bottom: 8px; right: 8px on the icon with position: relative on the button: anchoring the SVG to the bottom-right of the circle to compensate for the play triangle's viewBox offset.

9th of June 2026
v13.0.4 - Patch

• Fixed: Volume icon states not updating: vtListUpdateVolIcon was reading audio._vtListGain but gain is stored on item._vtListGain: not on the audio element. gainVal always fell back to audio.volume (fixed at 1.0), so the icon was permanently stuck on volume-high. Function signature updated to accept item as a third parameter. Both call sites updated.
• Play icon centring: line-md:play triangle sits in the upper-left of its SVG viewBox. Added transform: translate(2px, 1px) to .vt-list-play-btn iconify-icon to nudge toward optical centre. May require further adjustment after testing.

9th of June 2026
v13.0.3 - Patch

• Fixed: Chevron icon size: .vt-list-chevron had font-size: 0.75rem which has no effect on iconify-icon SVG elements. Replaced with width: 16px; height: 16px.

9th of June 2026
v13.0.2 - Patch

• Fixed: Icons too small: iconify-icon is an SVG web component: it does not scale from font-size. Replaced font-size: 0.75rem with explicit width: 18px; height: 18px on play and volume icons: correct ratio for a 34px circular button.
• Fixed: Single Track Player not updated: track-player-shortcode.php has its own copy of the player HTML: play and volume elements replaced with matching the list shortcode.

9th of June 2026
v13.0.1 - Patch

• Iconify: Minified player icons migrated from FontAwesome to Iconify line-md in the Track List widget. Play/pause now uses animated transition icons: line-md:play-to-pause-transition on play and line-md:pause-to-play-transition on pause/stop/end/error. Volume button now shows four states: line-md:volume-off, line-md:volume-low, line-md:volume-medium, line-md:volume-high: with thresholds calibrated for the logarithmic gain scale. Accordion chevron uses line-md:chevron-down with CSS rotation on open.
• Iconify web component (iconify-icon.min.js v2.3.0) registered and enqueued on all frontend pages alongside FontAwesome. FontAwesome retained: main player still uses it.
• Frontend icon migration. Minified player widgets only: Tracklist Accordion, Artist Card, Artist List, Single Track Player all share vitreous-list.js and benefit from this change.

9th of June 2026
v13.0.0 - Major

• Audio Normalisation Architecture: complete. Per-track gain normalisation is now fully implemented across the main player. Tracks are analysed on first play via full-file RMS analysis using the Web Audio API, a compensating gain value is calculated and stored in normalisation_gain on vitreous_tracks, cached in localStorage, and applied on all subsequent plays instantly from the stored value. No runtime analysis overhead after the first play.
• DynamicsCompressor removed from all players: was functioning as a loudness maximiser, not a normaliser. Signal chain is now sourceNode → EQ → gainNode → destination.
• Volume wired through gainNode: audio.volume is fixed at 1.0. All volume control, normalisation gain, fade in/out, and default volume route through a single applyNormalization() function.
• Crossfade permanently removed. Fade In and Fade Out are available in Settings → Audio → Advanced Audio.
• DB: normalisation_gain FLOAT DEFAULT NULL column on vitreous_tracks. New ajax_save_normalisation_gain() and ajax_clear_normalisation_gain() AJAX handlers.
• Admin: Normalisation gain value shown in the Tracks page header alongside Track ID. Clear button resets to NULL for recalculation. Database Debug panel shows column status and calculated vs pending track counts.

• Database Debug | Full v12 rewrite: Page rebuilt to reflect the canonical track architecture throughout. Removed the legacy "All Tracks" panel that read library_id and track_order from vitreous_tracks directly. Removed legacy library-scoped duplicate detection and orphan query.
• Playlists Table: Track counts now sourced from vitreous_library_tracks junction table.
• All Tracks: Lists all canonical tracks with playlist membership shown via junction join. Duplicate detection is now title-only across the global track table.
• Orphaned Track Maintenance: Orphan definition updated. A track is orphaned if it has no row in vitreous_library_tracks (not if its library_id column references a missing library). Purge query updated to match.
• Featured Artists Integrity: New panel checks vitreous_featured_artists for stale rows where the referenced track or artist no longer exists.
• Terminology: "Back to Libraries" updated to "Back to Playlists". "Libraries Table" renamed to "Playlists Table". Junction table panel renamed to "Playlist-Track Junction Table".

• Removed: Drag-to-reorder from the Playlist composer. Both panels now sort A-Z by title consistently. Frontend players use their own sort methods; manual sort order in the admin was unnecessary.
• Changed: Playlist left panel and right panel picker both order by t.title ASC. ajax_get_playlist_tracks() updated to match. ajax_reorder_playlist() handler and AJAX registration removed. Drag handles, save order button, reorder notice, and enableDrag() all removed from admin.js and library-edit.php .vt-playlist-drag-handle CSS rule removed.