@vanduo-oss/framework 1.2.8 → 1.3.0

package/README.md

@@ -1,4 +1,4 @@
-# Vanduo Framework v1.2.8
+# Vanduo Framework v1.3.0
 
 <p align="center">
   <img src="vanduo-banner.svg" alt="Vanduo Framework Banner" width="100%">
@@ -38,13 +38,14 @@ A lightweight, pure HTML/CSS/JS framework with **45+ components** for designing
 
 ---
 
-## What's New in v1.2.8
+## What's New in v1.3.0
 
-v1.2.8 focuses on theme-system clarity and release-surface alignment:
+v1.3.0 is a maintenance release focused on documentation improvements and framework consistency:
 
-- **Theme Switcher and Theme Customizer are now treated as distinct tooling components.** Use Theme Switcher for lightweight system/light/dark toggles and Theme Customizer for full palette, neutral, radius, font, and mode control.
-- **Shared theme coordination is more predictable.** When both components are present, they keep the shared theme preference synchronized and only swap between default per-theme primary colors when the user is still on the default primary.
-- **Release-facing docs were refreshed for v1.2.8.** The docs site now has dedicated Theme Switcher documentation, expanded Theme Customizer coordination guidance, and aligned versioned release copy.
+- **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.
 
 The framework still ships **45+ components**, including the v1.2.7 additions below.
 
@@ -87,8 +88,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.2.8/dist/vanduo.min.css">
-<script src="https://cdn.jsdelivr.net/gh/vanduo-oss/framework@v1.2.8/dist/vanduo.min.js"></script>
+<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>
 <script>Vanduo.init();</script>
 ```
 
@@ -151,7 +152,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.2.8
+pnpm run release:assets -- v1.3.0
 ```
 
 Notes:

package/css/components/doc-tabs.css

@@ -32,7 +32,7 @@
 
 .doc-tab.active {
     border-color: var(--color-primary);
-    color: var(--color-primary);
-    background: var(--color-primary-alpha-12);
+    color: var(--text-on-primary);
+    background: var(--color-primary);
     box-shadow: 0 0 0 1px var(--color-primary-alpha-20);
 }

package/css/core/helpers.css

@@ -1498,6 +1498,8 @@
 .vd-mt-3 { margin-top: var(--spacing-3); }
 .vd-mt-4 { margin-top: var(--spacing-4); }
 .vd-mt-5 { margin-top: var(--spacing-5); }
+.vd-mt-6 { margin-top: var(--spacing-6); }
+.vd-mt-8 { margin-top: var(--spacing-8); }
 .vd-mb-0 { margin-bottom: var(--spacing-0); }
 .vd-mb-2 { margin-bottom: var(--spacing-2); }
 .vd-mb-3 { margin-bottom: var(--spacing-3); }

package/css/core/typography.css

@@ -318,6 +318,10 @@ pre code {
   font-weight: var(--font-weight-bold);
 }
 
+.vd-text-italic {
+  font-style: italic;
+}
+
 .vd-font-extrabold {
   font-weight: var(--font-weight-extrabold);
 }

package/dist/build-info.json

@@ -1,6 +1,6 @@
 {
-  "version": "1.2.8",
-  "builtAt": "2026-03-14T13:35:54.636Z",
-  "commit": "f306379",
+  "version": "1.3.0",
+  "builtAt": "2026-03-17T16:46:03.216Z",
+  "commit": "ea44b23",
   "mode": "development+production"
 }

package/dist/vanduo.cjs.js

@@ -1,4 +1,4 @@
-/*! Vanduo v1.2.8 | Built: 2026-03-14T13:35:54.636Z | git:f306379 | development */
+/*! Vanduo v1.3.0 | Built: 2026-03-17T16:46:03.216Z | git:ea44b23 | development */
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
@@ -132,7 +132,7 @@ module.exports = __toCommonJS(index_exports);
 // js/vanduo.js
 (function() {
   "use strict";
-  const VANDUO_VERSION = true ? "1.2.8" : "0.0.0-dev";
+  const VANDUO_VERSION = true ? "1.3.0" : "0.0.0-dev";
   const Vanduo2 = {
     version: VANDUO_VERSION,
     components: {},
@@ -3922,7 +3922,12 @@ module.exports = __toCommonJS(index_exports);
         const themeSwitcher = window.Vanduo.components.themeSwitcher;
         if (themeSwitcher.state && themeSwitcher.state.preference !== mode) {
           themeSwitcher.state.preference = mode;
-          themeSwitcher.savePreference(themeSwitcher.STORAGE_KEY, mode);
+          if (typeof themeSwitcher.setStorageValue === "function") {
+            themeSwitcher.setStorageValue(themeSwitcher.STORAGE_KEY, mode);
+          }
+          if (typeof themeSwitcher.updateUI === "function") {
+            themeSwitcher.updateUI();
+          }
         }
       }
       this._isApplying = false;