@vanduo-oss/framework 1.3.8 → 1.4.0

package/dist/vanduo.cjs.js

@@ -1,4 +1,4 @@
-/*! Vanduo v1.3.8 | Built: 2026-05-06T18:32:43.703Z | git:6042eac | development */
+/*! Vanduo v1.4.0 | Built: 2026-05-20T14:51:00.085Z | git:46420b0 | development */
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
@@ -28,190 +28,398 @@ module.exports = __toCommonJS(index_exports);
 // js/utils/lifecycle.js
 (function() {
   "use strict";
+  function normalizeCallbacks(value) {
+    if (!value) return [];
+    if (Array.isArray(value)) {
+      return value.filter(function(fn) {
+        return typeof fn === "function";
+      });
+    }
+    return typeof value === "function" ? [value] : [];
+  }
+  function normalizeOptions(options) {
+    if (typeof options === "function") {
+      return { onDestroy: [options] };
+    }
+    return options || {};
+  }
+  function callSafely(label, fn) {
+    try {
+      fn();
+    } catch (error) {
+      console.warn("[Vanduo Lifecycle] " + label + " error:", error);
+    }
+  }
   const Lifecycle = {
-    // Map of element -> { componentName, cleanupFunctions }
+    // Map<Element, Map<componentName, { cleanup, onDestroy, registeredAt }>>
     instances: /* @__PURE__ */ new Map(),
-    /**
-     * Register a component instance
-     * @param {HTMLElement} element - The DOM element
-     * @param {string} componentName - Name of the component
-     * @param {Array<Function>} cleanupFns - Functions to call on destroy
-     */
-    register: function(element, componentName, cleanupFns = []) {
-      if (this.instances.has(element)) {
-        const existing = this.instances.get(element);
-        existing.cleanup = existing.cleanup.concat(cleanupFns);
+    isRoot: function(root) {
+      return !!root && (root === document || root.nodeType === 1 || root.nodeType === 9 || root.nodeType === 11);
+    },
+    normalizeRoot: function(root) {
+      return this.isRoot(root) ? root : document;
+    },
+    isInRoot: function(root, element) {
+      const scope = this.normalizeRoot(root);
+      if (!(element instanceof Element)) return false;
+      if (scope === document) {
+        return document.documentElement ? document.documentElement.contains(element) : document.contains(element);
+      }
+      if (scope === element) return true;
+      return typeof scope.contains === "function" && scope.contains(element);
+    },
+    queryAll: function(root, selector) {
+      const scope = this.normalizeRoot(root);
+      const matches = [];
+      if (scope instanceof Element && typeof scope.matches === "function" && scope.matches(selector)) {
+        matches.push(scope);
+      }
+      if (typeof scope.querySelectorAll === "function") {
+        const descendants = scope.querySelectorAll(selector);
+        for (let i = 0; i < descendants.length; i++) {
+          matches.push(descendants[i]);
+        }
+      }
+      return matches;
+    },
+    queryOne: function(root, selector) {
+      const matches = this.queryAll(root, selector);
+      return matches.length ? matches[0] : null;
+    },
+    runInRoot: function(root, fn) {
+      const scope = this.normalizeRoot(root);
+      return fn(scope);
+    },
+    register: function(element, componentName, cleanupFns, options) {
+      if (!(element instanceof Element) || !componentName) return;
+      const optionBag = normalizeOptions(options);
+      const cleanup = normalizeCallbacks(cleanupFns);
+      const onDestroy = normalizeCallbacks(optionBag.onDestroy);
+      const componentEntries = this.instances.get(element) || /* @__PURE__ */ new Map();
+      const existing = componentEntries.get(componentName);
+      if (existing) {
+        existing.cleanup = existing.cleanup.concat(cleanup);
+        existing.onDestroy = existing.onDestroy.concat(onDestroy);
         return;
       }
-      this.instances.set(element, {
+      componentEntries.set(componentName, {
         component: componentName,
-        cleanup: cleanupFns,
+        cleanup,
+        onDestroy,
         registeredAt: Date.now()
       });
+      this.instances.set(element, componentEntries);
     },
-    /**
-     * Unregister a single element and run its cleanup
-     * @param {HTMLElement} element - The element to unregister
-     */
-    unregister: function(element) {
-      const instance = this.instances.get(element);
-      if (!instance) return;
-      instance.cleanup.forEach(function(fn) {
-        try {
-          fn();
-        } catch (e) {
-          console.warn("[Vanduo Lifecycle] Cleanup error:", e);
+    unregister: function(element, componentName) {
+      const componentEntries = this.instances.get(element);
+      if (!componentEntries) return;
+      if (componentName) {
+        const entry = componentEntries.get(componentName);
+        if (!entry) return;
+        componentEntries.delete(componentName);
+        if (!componentEntries.size) {
+          this.instances.delete(element);
         }
-      });
+        entry.cleanup.forEach(function(fn) {
+          callSafely("Cleanup", fn);
+        });
+        entry.onDestroy.forEach(function(fn) {
+          callSafely("Destroy", fn);
+        });
+        return;
+      }
+      const entries = Array.from(componentEntries.values());
       this.instances.delete(element);
+      entries.forEach(function(entry) {
+        entry.cleanup.forEach(function(fn) {
+          callSafely("Cleanup", fn);
+        });
+        entry.onDestroy.forEach(function(fn) {
+          callSafely("Destroy", fn);
+        });
+      });
     },
-    /**
-     * Destroy all instances of a specific component
-     * @param {string} componentName - Optional component name filter
-     */
     destroyAll: function(componentName) {
       const toRemove = [];
-      this.instances.forEach(function(instance, element) {
-        if (!componentName || instance.component === componentName) {
-          toRemove.push(element);
+      this.instances.forEach(function(componentEntries, element) {
+        if (!componentName) {
+          toRemove.push([element, null]);
+          return;
+        }
+        if (componentEntries.has(componentName)) {
+          toRemove.push([element, componentName]);
         }
       });
-      toRemove.forEach(function(element) {
-        Lifecycle.unregister(element);
+      toRemove.forEach(function(entry) {
+        Lifecycle.unregister(entry[0], entry[1] || void 0);
       });
+      return toRemove.length;
     },
-    /**
-     * Destroy all instances within a specific container
-     * Useful for SPAs when navigating between pages
-     * @param {HTMLElement} container - Container element
-     */
-    destroyAllInContainer: function(container) {
+    destroyAllInContainer: function(container, componentName) {
+      const scope = this.normalizeRoot(container);
       const toRemove = [];
-      this.instances.forEach(function(instance, element) {
-        if (container.contains(element)) {
-          toRemove.push(element);
+      this.instances.forEach(function(componentEntries, element) {
+        if (!Lifecycle.isInRoot(scope, element)) return;
+        if (!componentName) {
+          toRemove.push([element, null]);
+          return;
+        }
+        if (componentEntries.has(componentName)) {
+          toRemove.push([element, componentName]);
         }
       });
-      toRemove.forEach(function(element) {
-        Lifecycle.unregister(element);
+      toRemove.forEach(function(entry) {
+        Lifecycle.unregister(entry[0], entry[1] || void 0);
       });
+      return toRemove.length;
     },
-    /**
-     * Get all registered instances (for debugging)
-     * @returns {Array} Array of instance info objects
-     */
     getAll: function() {
       const result = [];
-      this.instances.forEach(function(instance, element) {
-        result.push({
-          element,
-          component: instance.component,
-          registeredAt: instance.registeredAt
+      this.instances.forEach(function(componentEntries, element) {
+        componentEntries.forEach(function(entry) {
+          result.push({
+            element,
+            component: entry.component,
+            registeredAt: entry.registeredAt
+          });
         });
       });
       return result;
     },
-    /**
-     * Check if an element is registered
-     * @param {HTMLElement} element - The element to check
-     * @returns {boolean}
-     */
-    has: function(element) {
-      return this.instances.has(element);
+    has: function(element, componentName) {
+      const componentEntries = this.instances.get(element);
+      if (!componentEntries) return false;
+      return componentName ? componentEntries.has(componentName) : componentEntries.size > 0;
     }
   };
   window.addEventListener("beforeunload", function() {
     Lifecycle.destroyAll();
   });
   window.VanduoLifecycle = Lifecycle;
-  if (typeof window.Vanduo !== "undefined") {
-    window.Vanduo.register("lifecycle", Lifecycle);
-  }
 })();
 
 // js/vanduo.js
 (function() {
   "use strict";
-  const VANDUO_VERSION = true ? "1.3.8" : "0.0.0-dev";
+  const VANDUO_VERSION = true ? "1.4.0" : "0.0.0-dev";
+  const hasOwn = Object.prototype.hasOwnProperty;
   const Vanduo2 = {
     version: VANDUO_VERSION,
     components: {},
+    aliases: {},
+    _decoratedComponents: /* @__PURE__ */ new WeakSet(),
+    resolveComponentName: function(name) {
+      return this.aliases[name] || name;
+    },
+    _isRoot: function(root) {
+      if (typeof window.VanduoLifecycle !== "undefined" && typeof window.VanduoLifecycle.isRoot === "function") {
+        return window.VanduoLifecycle.isRoot(root);
+      }
+      return !!root && (root === document || root.nodeType === 1 || root.nodeType === 9 || root.nodeType === 11);
+    },
+    _normalizeRoot: function(root) {
+      return this._isRoot(root) ? root : document;
+    },
+    _queryAll: function(root, selector) {
+      const scope = this._normalizeRoot(root);
+      const matches = [];
+      if (scope instanceof Element && typeof scope.matches === "function" && scope.matches(selector)) {
+        matches.push(scope);
+      }
+      if (typeof scope.querySelectorAll === "function") {
+        const descendants = scope.querySelectorAll(selector);
+        for (let i = 0; i < descendants.length; i++) {
+          matches.push(descendants[i]);
+        }
+      }
+      return matches;
+    },
+    queryAll: function(root, selector) {
+      if (typeof selector === "undefined") {
+        selector = root;
+        root = document;
+      }
+      return this._queryAll(root, selector);
+    },
+    queryOne: function(root, selector) {
+      const matches = this.queryAll(root, selector);
+      return matches.length ? matches[0] : null;
+    },
+    _isLifecycleManagedComponent: function(component) {
+      if (!component || typeof component !== "object") return false;
+      for (const key in component) {
+        if (hasOwn.call(component, key) && component[key] instanceof Map) {
+          return true;
+        }
+      }
+      return false;
+    },
+    _syncComponentLifecycle: function(name, component, root) {
+      const lifecycle = window.VanduoLifecycle;
+      if (!lifecycle || !this._isLifecycleManagedComponent(component)) return;
+      const componentName = this.resolveComponentName(name);
+      const scope = this._normalizeRoot(root);
+      for (const key in component) {
+        if (!hasOwn.call(component, key) || !(component[key] instanceof Map)) {
+          continue;
+        }
+        component[key].forEach(function(instance, element) {
+          if (!(element instanceof Element) || !lifecycle.isInRoot(scope, element) || lifecycle.has(element, componentName)) {
+            return;
+          }
+          if (typeof component.destroy === "function") {
+            lifecycle.register(element, componentName, [], function() {
+              component.destroy(element);
+            });
+            return;
+          }
+          const cleanup = instance && Array.isArray(instance.cleanup) ? instance.cleanup : [];
+          lifecycle.register(element, componentName, cleanup, function() {
+            component[key].delete(element);
+          });
+        });
+      }
+    },
+    _decorateComponent: function(name, component) {
+      const framework = this;
+      const lifecycle = window.VanduoLifecycle;
+      if (!component || typeof component !== "object" || this._decoratedComponents.has(component)) {
+        return;
+      }
+      const originalInit = typeof component.init === "function" ? component.init : null;
+      if (originalInit) {
+        component.init = function(...args) {
+          const scopedRoot = framework._isRoot(args[0]) ? args[0] : null;
+          const result = originalInit.apply(this, args);
+          if (window.Vanduo) {
+            const syncRoot = scopedRoot || document;
+            window.Vanduo._syncComponentLifecycle(name, this, syncRoot);
+          }
+          return result;
+        };
+      }
+      const originalDestroyAll = typeof component.destroyAll === "function" ? component.destroyAll : null;
+      if (originalDestroyAll) {
+        component.destroyAll = function(...args) {
+          const scopedRoot = framework._isRoot(args[0]) ? args[0] : null;
+          const componentName = window.Vanduo ? window.Vanduo.resolveComponentName(name) : name;
+          if (lifecycle && window.Vanduo && window.Vanduo._isLifecycleManagedComponent(this)) {
+            if (scopedRoot && scopedRoot !== document) {
+              lifecycle.destroyAllInContainer(scopedRoot, componentName);
+              if (this.__vanduoScopedDestroyAll === true) {
+                return originalDestroyAll.apply(this, args);
+              }
+              return;
+            }
+            lifecycle.destroyAll(componentName);
+          }
+          return originalDestroyAll.apply(this, args);
+        };
+      }
+      this._decoratedComponents.add(component);
+    },
     /**
      * Initialize framework
      * Call this after DOM is ready and all components are loaded
      */
-    init: function() {
+    init: function(root) {
+      const scope = this._normalizeRoot(root);
+      if (scope !== document) {
+        this.initComponents(scope);
+        return;
+      }
       if (typeof ready !== "undefined") {
         ready(() => {
-          this.initComponents();
+          this.initComponents(document);
         });
-      } else {
-        if (document.readyState === "loading") {
-          document.addEventListener("DOMContentLoaded", () => {
-            this.initComponents();
-          });
-        } else {
-          this.initComponents();
-        }
+        return;
       }
+      if (document.readyState === "loading") {
+        document.addEventListener("DOMContentLoaded", () => {
+          this.initComponents(document);
+        });
+        return;
+      }
+      this.initComponents(document);
     },
     /**
      * Initialize all components
      */
-    initComponents: function() {
+    initComponents: function(root) {
+      const scope = this._normalizeRoot(root);
       Object.keys(this.components).forEach((name) => {
         const component = this.components[name];
         if (component.init && typeof component.init === "function") {
           try {
-            component.init();
+            component.init(scope);
           } catch (e) {
             console.warn('[Vanduo] Failed to initialize component "' + name + '":', e);
           }
         }
       });
-      console.log("Vanduo Framework v" + this.version + " initialized");
     },
     /**
      * Register a component
      * @param {string} name - Component name
      * @param {Object} component - Component object with init method
      */
-    register: function(name, component) {
+    register: function(name, component, options) {
+      const opts = options || {};
+      this._decorateComponent(name, component);
       this.components[name] = component;
+      if (Array.isArray(opts.aliases)) {
+        opts.aliases.forEach((alias) => {
+          this.aliases[alias] = name;
+        });
+      }
+    },
+    registerAlias: function(alias, name) {
+      const canonicalName = this.resolveComponentName(name);
+      if (this.components[canonicalName]) {
+        this.aliases[alias] = canonicalName;
+      }
     },
     /**
      * Re-initialize a component (useful after dynamic DOM changes)
      * @param {string} name - Component name
      */
-    reinit: function(name) {
-      const component = this.components[name];
+    reinit: function(name, root) {
+      const scope = this._normalizeRoot(root);
+      const componentName = this.resolveComponentName(name);
+      const component = this.components[componentName];
       if (component && component.init && typeof component.init === "function") {
         try {
-          component.init();
+          if (component.destroyAll && typeof component.destroyAll === "function") {
+            component.destroyAll(scope);
+          }
+          component.init(scope);
         } catch (e) {
-          console.warn('[Vanduo] Failed to reinitialize component "' + name + '":', e);
+          console.warn('[Vanduo] Failed to reinitialize component "' + componentName + '":', e);
         }
       }
     },
     /**
-     * Destroy all component instances and clean up event listeners
-     * Uses lifecycle manager for memory leak prevention
+     * Destroy component instances within the provided root.
      */
-    destroyAll: function() {
+    destroy: function(root) {
+      const scope = this._normalizeRoot(root);
       const names = Object.keys(this.components);
       for (let i = 0; i < names.length; i++) {
         const component = this.components[names[i]];
         if (component && component.destroyAll && typeof component.destroyAll === "function") {
           try {
-            component.destroyAll();
+            component.destroyAll(scope);
           } catch (e) {
             console.warn('[Vanduo] Failed to destroy component "' + names[i] + '":', e);
           }
         }
       }
-      if (typeof window.VanduoLifecycle !== "undefined") {
-        window.VanduoLifecycle.destroyAll();
-      }
+    },
+    /**
+     * Destroy all component instances and clean up event listeners.
+     */
+    destroyAll: function() {
+      this.destroy(document);
     },
     /**
      * Get component instance
@@ -219,7 +427,8 @@ module.exports = __toCommonJS(index_exports);
      * @returns {Object|null}
      */
     getComponent: function(name) {
-      return this.components[name] || null;
+      const componentName = this.resolveComponentName(name);
+      return this.components[componentName] || null;
     }
   };
   window.Vanduo = Vanduo2;
@@ -230,6 +439,26 @@ module.exports = __toCommonJS(index_exports);
   "use strict";
   const CodeSnippet = {
     _snippetIdCounter: 0,
+    resolveRoot: function(root) {
+      if (root && (root.nodeType === 1 || root.nodeType === 9 || root.nodeType === 11)) {
+        return root;
+      }
+      return document;
+    },
+    queryWithin: function(root, selector) {
+      const scope = this.resolveRoot(root);
+      const matches = [];
+      if (scope instanceof Element && typeof scope.matches === "function" && scope.matches(selector)) {
+        matches.push(scope);
+      }
+      if (typeof scope.querySelectorAll === "function") {
+        const descendants = scope.querySelectorAll(selector);
+        for (let i = 0; i < descendants.length; i++) {
+          matches.push(descendants[i]);
+        }
+      }
+      return matches;
+    },
     getSnippetInstanceId: function(snippet) {
       if (snippet.dataset.codeSnippetId) {
         return snippet.dataset.codeSnippetId;
@@ -254,8 +483,8 @@ module.exports = __toCommonJS(index_exports);
     /**
      * Initialize all code snippet components
      */
-    init: function() {
-      const snippets = document.querySelectorAll(".vd-code-snippet");
+    init: function(root) {
+      const snippets = this.queryWithin(root, ".vd-code-snippet");
       snippets.forEach((snippet) => {
         if (!snippet.dataset.initialized) {
           this.initSnippet(snippet);
@@ -287,6 +516,10 @@ module.exports = __toCommonJS(index_exports);
       extractPanes.forEach((pane) => {
         this.extractHtml(pane);
       });
+      const panesToHighlight = snippet.querySelectorAll(".vd-code-snippet-pane:not([data-extract])");
+      panesToHighlight.forEach((pane) => {
+        this.applyPaneHighlighting(pane);
+      });
       const lineNumberPanes = snippet.querySelectorAll(".has-line-numbers");
       lineNumberPanes.forEach((pane) => {
         this.addLineNumbers(pane);
@@ -522,6 +755,7 @@ module.exports = __toCommonJS(index_exports);
       codeEl.innerHTML = html;
       pane.replaceChildren(codeEl);
       pane.dataset.extracted = "true";
+      pane.dataset.highlighted = "true";
     },
     /**
      * Format HTML with proper indentation
@@ -563,6 +797,77 @@ module.exports = __toCommonJS(index_exports);
       div.textContent = html;
       return div.innerHTML;
     },
+    needsHighlighting: function(pane, codeEl) {
+      if (!codeEl) return false;
+      if (pane.dataset.highlighted === "true") return false;
+      if (codeEl.querySelector('[class^="code-"], [class*=" code-"]')) return false;
+      return true;
+    },
+    getHighlightMode: function(lang) {
+      const normalized = String(lang || "").trim().toLowerCase();
+      if ([
+        "html",
+        "xml",
+        "svg",
+        "vue",
+        "svelte",
+        "astro"
+      ].includes(normalized)) {
+        return "html";
+      }
+      if ([
+        "css",
+        "scss",
+        "sass",
+        "less"
+      ].includes(normalized)) {
+        return "css";
+      }
+      if ([
+        "js",
+        "mjs",
+        "cjs",
+        "ts",
+        "jsx",
+        "tsx",
+        "json",
+        "bash",
+        "sh"
+      ].includes(normalized)) {
+        return "js";
+      }
+      return "plain";
+    },
+    highlightCodeByLang: function(rawCode, lang) {
+      const escaped = this.escapeHtml(rawCode);
+      const mode = this.getHighlightMode(lang);
+      if (mode === "html") {
+        return this.highlightHtml(escaped);
+      }
+      if (mode === "css") {
+        return this.highlightCss(escaped);
+      }
+      if (mode === "js") {
+        return this.highlightJs(escaped);
+      }
+      return escaped;
+    },
+    applyPaneHighlighting: function(pane) {
+      if (!pane) return;
+      const codeEl = pane.querySelector("code") || pane;
+      if (!this.needsHighlighting(pane, codeEl)) {
+        pane.dataset.highlighted = "true";
+        return;
+      }
+      const rawCode = codeEl.textContent || "";
+      const highlighted = this.highlightCodeByLang(rawCode, pane.dataset.lang);
+      const nextCodeEl = codeEl.tagName === "CODE" ? codeEl : document.createElement("code");
+      nextCodeEl.innerHTML = highlighted;
+      if (nextCodeEl !== codeEl) {
+        pane.replaceChildren(nextCodeEl);
+      }
+      pane.dataset.highlighted = "true";
+    },
     /**
      * Apply syntax highlighting to HTML
      * @param {string} html - Escaped HTML string
@@ -570,7 +875,9 @@ module.exports = __toCommonJS(index_exports);
      */
     highlightHtml: function(html) {
       html = html.replace(/(&lt;\/?)([\w-]+)/g, '$1<span class="code-tag">$2</span>');
+      html = html.replace(/([\w-]+)(=)(["'])/g, '<span class="code-attr">$1</span>$2$3');
       html = html.replace(/([\w-]+)(=)(&quot;|&#39;)/g, '<span class="code-attr">$1</span>$2$3');
+      html = html.replace(/(["'])([^"']*)(["'])/g, '$1<span class="code-string">$2</span>$3');
       html = html.replace(/(&quot;|&#39;)([^&]*)(&quot;|&#39;)/g, '$1<span class="code-string">$2</span>$3');
       html = html.replace(/(&lt;!--)(.*?)(--&gt;)/g, '<span class="code-comment">$1$2$3</span>');
       return html;
@@ -695,9 +1002,12 @@ module.exports = __toCommonJS(index_exports);
     /**
      * Destroy all code snippet instances
      */
-    destroyAll: function() {
-      const snippets = document.querySelectorAll('.vd-code-snippet[data-initialized="true"]');
-      snippets.forEach((snippet) => this.destroy(snippet));
+    destroyAll: function(root) {
+      const scope = this.resolveRoot(root);
+      const snippets = this.queryWithin(scope, '.vd-code-snippet[data-initialized="true"]');
+      snippets.forEach((snippet) => {
+        this.destroy(snippet);
+      });
     }
   };
   if (typeof window.Vanduo !== "undefined") {
@@ -715,8 +1025,8 @@ module.exports = __toCommonJS(index_exports);
     /**
      * Initialize collapsible components
      */
-    init: function() {
-      const collapsibles = document.querySelectorAll(".vd-collapsible, .accordion");
+    init: function(root) {
+      const collapsibles = window.Vanduo.queryAll(root, ".vd-collapsible, .accordion");
       collapsibles.forEach((container) => {
         if (this.instances.has(container)) {
           return;
@@ -893,8 +1203,8 @@ module.exports = __toCommonJS(index_exports);
     /**
      * Initialize dropdown components
      */
-    init: function() {
-      const dropdowns = document.querySelectorAll(".vd-dropdown");
+    init: function(root) {
+      const dropdowns = window.Vanduo.queryAll(root, ".vd-dropdown");
       dropdowns.forEach((dropdown) => {
         if (this.instances.has(dropdown)) {
           return;
@@ -1212,31 +1522,36 @@ module.exports = __toCommonJS(index_exports);
         description: "Friendly, rounded sans-serif"
       }
     },
-    init: function() {
+    getToggles: function(root) {
+      if (window.Vanduo && typeof window.Vanduo.queryAll === "function") {
+        return window.Vanduo.queryAll(root, '[data-toggle="font"]');
+      }
+      return Array.from(document.querySelectorAll('[data-toggle="font"]'));
+    },
+    init: function(root) {
       this.state = {
         preference: this.getPreference()
       };
       if (!this.fonts[this.state.preference]) {
-        this.state.preference = "lato";
+        this.state.preference = "ubuntu";
         this.setStorageValue(this.STORAGE_KEY, this.state.preference);
       }
       if (this.isInitialized) {
         this.applyFont();
-        this.renderUI();
-        this.updateUI();
+        this.renderUI(root);
+        this.updateUI(root);
         return;
       }
       this.isInitialized = true;
       this.applyFont();
-      this.renderUI();
-      console.log("Vanduo Font Switcher initialized");
+      this.renderUI(root);
     },
     /**
      * Get saved font preference from localStorage
-     * @returns {string} Font key or 'lato' (default)
+     * @returns {string} Font key or 'ubuntu' (default)
      */
     getPreference: function() {
-      return this.getStorageValue(this.STORAGE_KEY, "lato");
+      return this.getStorageValue(this.STORAGE_KEY, "ubuntu");
     },
     /**
      * Set font preference and apply it
@@ -1271,8 +1586,8 @@ module.exports = __toCommonJS(index_exports);
     /**
      * Initialize UI elements with data-toggle="font"
      */
-    renderUI: function() {
-      const toggles = document.querySelectorAll('[data-toggle="font"]');
+    renderUI: function(root) {
+      const toggles = this.getToggles(root);
       toggles.forEach((toggle) => {
         if (toggle.getAttribute("data-font-initialized") === "true") {
           if (toggle.tagName === "SELECT") {
@@ -1303,8 +1618,8 @@ module.exports = __toCommonJS(index_exports);
     /**
      * Update all UI elements to reflect current state
      */
-    updateUI: function() {
-      const toggles = document.querySelectorAll('[data-toggle="font"]');
+    updateUI: function(root) {
+      const toggles = this.getToggles(root);
       toggles.forEach((toggle) => {
         if (toggle.tagName === "SELECT") {
           toggle.value = this.state.preference;
@@ -1331,8 +1646,10 @@ module.exports = __toCommonJS(index_exports);
     getFontData: function(fontKey) {
       return this.fonts[fontKey] || null;
     },
-    destroyAll: function() {
-      const toggles = document.querySelectorAll('[data-toggle="font"][data-font-initialized="true"]');
+    destroyAll: function(root) {
+      const toggles = this.getToggles(root || document).filter(function(toggle) {
+        return toggle.getAttribute("data-font-initialized") === "true";
+      });
       toggles.forEach((toggle) => {
         if (toggle._fontToggleHandler) {
           const eventName = toggle.tagName === "SELECT" ? "change" : "click";
@@ -1341,7 +1658,9 @@ module.exports = __toCommonJS(index_exports);
         }
         toggle.removeAttribute("data-font-initialized");
       });
-      this.isInitialized = false;
+      if (!root || root === document) {
+        this.isInitialized = false;
+      }
     },
     getStorageValue: function(key, fallback) {
       if (typeof window.safeStorageGet === "function") {
@@ -1384,18 +1703,19 @@ module.exports = __toCommonJS(index_exports);
   })();
   const GridLayout = {
     instances: /* @__PURE__ */ new Map(),
+    __vanduoScopedDestroyAll: true,
     /**
      * Initialize all grid layout containers
      */
-    init: function() {
-      const containers = document.querySelectorAll("[data-layout-mode]");
+    init: function(root) {
+      const containers = window.Vanduo.queryAll(root, "[data-layout-mode]");
       containers.forEach(function(container) {
         if (this.instances.has(container)) {
           return;
         }
         this.initContainer(container);
       }.bind(this));
-      this.initToggleButtons();
+      this.initToggleButtons(root);
     },
     /**
      * Initialize a single grid container
@@ -1415,8 +1735,8 @@ module.exports = __toCommonJS(index_exports);
     /**
      * Initialize toggle buttons that target grid containers
      */
-    initToggleButtons: function() {
-      const toggleButtons = document.querySelectorAll("[data-grid-toggle]");
+    initToggleButtons: function(root) {
+      const toggleButtons = window.Vanduo && typeof window.Vanduo.queryAll === "function" ? window.Vanduo.queryAll(root, "[data-grid-toggle]") : document.querySelectorAll("[data-grid-toggle]");
       toggleButtons.forEach(function(button) {
         if (button.getAttribute("data-grid-initialized") === "true") {
           return;
@@ -1584,11 +1904,14 @@ module.exports = __toCommonJS(index_exports);
     /**
      * Destroy all grid layout instances and clean up toggle buttons
      */
-    destroyAll: function() {
+    destroyAll: function(root) {
+      const scope = window.Vanduo && typeof window.Vanduo._normalizeRoot === "function" ? window.Vanduo._normalizeRoot(root) : root || document;
       this.instances.forEach(function(instance, container) {
-        this.destroy(container);
+        if (scope === document || scope === container || typeof scope.contains === "function" && scope.contains(container)) {
+          this.destroy(container);
+        }
       }.bind(this));
-      const toggleButtons = document.querySelectorAll('[data-grid-initialized="true"]');
+      const toggleButtons = window.Vanduo && typeof window.Vanduo.queryAll === "function" ? window.Vanduo.queryAll(scope, '[data-grid-toggle][data-grid-initialized="true"]') : document.querySelectorAll('[data-grid-initialized="true"]');
       toggleButtons.forEach(function(button) {
         if (button._gridCleanup) {
           button._gridCleanup();
@@ -1618,12 +1941,18 @@ module.exports = __toCommonJS(index_exports);
     isOpen: false,
     // Store cleanup functions for event listeners
     _cleanupFunctions: [],
+    getTriggers: function(root) {
+      if (window.Vanduo && typeof window.Vanduo.queryAll === "function") {
+        return window.Vanduo.queryAll(root, "[data-image-box]");
+      }
+      return Array.from(document.querySelectorAll("[data-image-box]"));
+    },
     /**
      * Initialize Image Box component
      */
-    init: function() {
+    init: function(root) {
       this.createBackdrop();
-      this.bindTriggers();
+      this.bindTriggers(root);
     },
     /**
      * Create backdrop elements
@@ -1707,9 +2036,9 @@ module.exports = __toCommonJS(index_exports);
     /**
      * Bind triggers to all images with data-image-box attribute
      */
-    bindTriggers: function() {
+    bindTriggers: function(root) {
       const self = this;
-      const triggers = document.querySelectorAll("[data-image-box]");
+      const triggers = this.getTriggers(root);
       triggers.forEach(function(trigger) {
         if (trigger.dataset.imageBoxInitialized) return;
         trigger.dataset.imageBoxInitialized = "true";
@@ -1726,6 +2055,8 @@ module.exports = __toCommonJS(index_exports);
             trigger.classList.remove("is-broken");
           };
           trigger.addEventListener("load", loadHandler);
+          trigger._imageBoxErrorHandler = errorHandler;
+          trigger._imageBoxLoadHandler = loadHandler;
         }
         const clickHandler = function(e) {
           e.preventDefault();
@@ -1744,12 +2075,24 @@ module.exports = __toCommonJS(index_exports);
             }
           };
           trigger.addEventListener("keydown", keyHandler);
-          const originalCleanup = trigger._imageBoxCleanup;
+          const originalCleanup2 = trigger._imageBoxCleanup;
           trigger._imageBoxCleanup = () => {
-            originalCleanup();
+            originalCleanup2();
             trigger.removeEventListener("keydown", keyHandler);
           };
         }
+        const originalCleanup = trigger._imageBoxCleanup;
+        trigger._imageBoxCleanup = () => {
+          originalCleanup();
+          if (trigger._imageBoxErrorHandler) {
+            trigger.removeEventListener("error", trigger._imageBoxErrorHandler);
+            delete trigger._imageBoxErrorHandler;
+          }
+          if (trigger._imageBoxLoadHandler) {
+            trigger.removeEventListener("load", trigger._imageBoxLoadHandler);
+            delete trigger._imageBoxLoadHandler;
+          }
+        };
       });
     },
     /**
@@ -1820,13 +2163,25 @@ module.exports = __toCommonJS(index_exports);
     /**
      * Reinitialize - useful after dynamic DOM changes
      */
-    reinit: function() {
-      this.bindTriggers();
+    reinit: function(root) {
+      this.bindTriggers(root);
     },
     /**
      * Destroy component and clean up
      */
-    destroy: function() {
+    destroy: function(root) {
+      if (root && root !== document) {
+        const triggersInRoot = this.getTriggers(root);
+        triggersInRoot.forEach((trigger) => {
+          trigger.classList.remove("vd-image-box-trigger");
+          if (trigger._imageBoxCleanup) {
+            trigger._imageBoxCleanup();
+            delete trigger._imageBoxCleanup;
+          }
+          delete trigger.dataset.imageBoxInitialized;
+        });
+        return;
+      }
       if (this.isOpen) {
         this.close();
       }
@@ -1835,7 +2190,7 @@ module.exports = __toCommonJS(index_exports);
       }
       this._cleanupFunctions.forEach((fn) => fn());
       this._cleanupFunctions = [];
-      const triggers = document.querySelectorAll("[data-image-box-initialized]");
+      const triggers = window.Vanduo && typeof window.Vanduo.queryAll === "function" ? window.Vanduo.queryAll(root, "[data-image-box-initialized]") : document.querySelectorAll("[data-image-box-initialized]");
       triggers.forEach((trigger) => {
         trigger.classList.remove("vd-image-box-trigger");
         if (trigger._imageBoxCleanup) {
@@ -1852,8 +2207,8 @@ module.exports = __toCommonJS(index_exports);
       this.currentTrigger = null;
       this.isOpen = false;
     },
-    destroyAll: function() {
-      this.destroy();
+    destroyAll: function(root) {
+      this.destroy(root);
     }
   };
   if (typeof window.Vanduo !== "undefined") {
@@ -1869,6 +2224,7 @@ module.exports = __toCommonJS(index_exports);
     modals: /* @__PURE__ */ new Map(),
     openModals: [],
     zIndexCounter: 1050,
+    __vanduoScopedDestroyAll: true,
     // Store trigger cleanup functions
     _triggerCleanups: [],
     // Shared ESC key handler (installed once)
@@ -1924,15 +2280,15 @@ module.exports = __toCommonJS(index_exports);
     /**
      * Initialize modals
      */
-    init: function() {
-      const modals = document.querySelectorAll(".vd-modal");
+    init: function(root) {
+      const modals = window.Vanduo.queryAll(root, ".vd-modal");
       modals.forEach((modal) => {
         if (this.modals.has(modal)) {
           return;
         }
         this.initModal(modal);
       });
-      const triggers = document.querySelectorAll("[data-modal]");
+      const triggers = window.Vanduo && typeof window.Vanduo.queryAll === "function" ? window.Vanduo.queryAll(root, "[data-modal]") : document.querySelectorAll("[data-modal]");
       triggers.forEach((trigger) => {
         if (trigger.dataset.modalTriggerInitialized) return;
         trigger.dataset.modalTriggerInitialized = "true";
@@ -1945,7 +2301,7 @@ module.exports = __toCommonJS(index_exports);
           }
         };
         trigger.addEventListener("click", triggerClickHandler);
-        this._triggerCleanups.push(() => trigger.removeEventListener("click", triggerClickHandler));
+        trigger._modalTriggerCleanup = () => trigger.removeEventListener("click", triggerClickHandler);
       });
     },
     /**
@@ -2183,13 +2539,22 @@ module.exports = __toCommonJS(index_exports);
     /**
      * Destroy all modal instances
      */
-    destroyAll: function() {
+    destroyAll: function(root) {
+      const scope = window.Vanduo && typeof window.Vanduo._normalizeRoot === "function" ? window.Vanduo._normalizeRoot(root) : root || document;
       this.modals.forEach((data, modal) => {
-        this.destroy(modal);
+        if (scope === document || scope === modal || typeof scope.contains === "function" && scope.contains(modal)) {
+          this.destroy(modal);
+        }
       });
-      this._triggerCleanups.forEach((fn) => fn());
-      this._triggerCleanups = [];
-      if (this._sharedEscHandler) {
+      const triggers = window.Vanduo && typeof window.Vanduo.queryAll === "function" ? window.Vanduo.queryAll(scope, "[data-modal][data-modal-trigger-initialized]") : document.querySelectorAll("[data-modal][data-modal-trigger-initialized]");
+      triggers.forEach((trigger) => {
+        if (trigger._modalTriggerCleanup) {
+          trigger._modalTriggerCleanup();
+          delete trigger._modalTriggerCleanup;
+        }
+        delete trigger.dataset.modalTriggerInitialized;
+      });
+      if (scope === document && this._sharedEscHandler) {
         document.removeEventListener("keydown", this._sharedEscHandler);
         this._sharedEscHandler = null;
       }
@@ -2220,8 +2585,8 @@ module.exports = __toCommonJS(index_exports);
     /**
      * Initialize navbar component
      */
-    init: function() {
-      const navbars = document.querySelectorAll(".vd-navbar");
+    init: function(root) {
+      const navbars = window.Vanduo.queryAll(root, ".vd-navbar");
       navbars.forEach((navbar) => {
         if (this.instances.has(navbar)) {
           return;
@@ -2442,8 +2807,8 @@ module.exports = __toCommonJS(index_exports);
     /**
      * Initialize pagination components
      */
-    init: function() {
-      const paginations = document.querySelectorAll(".vd-pagination[data-pagination]");
+    init: function(root) {
+      const paginations = window.Vanduo.queryAll(root, ".vd-pagination[data-pagination]");
       paginations.forEach((pagination) => {
         if (this.instances.has(pagination)) {
           return;
@@ -2666,21 +3031,21 @@ module.exports = __toCommonJS(index_exports);
     /**
      * Initialize parallax components
      */
-    init: function() {
-      if (this.isInitialized) {
-        this.refresh();
-        return;
-      }
-      this.isInitialized = true;
+    init: function(root) {
       if (this.reducedMotion) {
         return;
       }
-      const parallaxElements = document.querySelectorAll(".vd-parallax");
+      const parallaxElements = window.Vanduo.queryAll(root, ".vd-parallax");
       parallaxElements.forEach((element) => {
         if (!element.dataset.parallaxInitialized) {
           this.initParallax(element);
         }
       });
+      if (this.isInitialized) {
+        this.refresh();
+        return;
+      }
+      this.isInitialized = true;
       this.handleScroll();
       this._onScroll = () => {
         this.handleScroll();
@@ -2823,11 +3188,17 @@ module.exports = __toCommonJS(index_exports);
 (function() {
   "use strict";
   const Preloader = {
+    getProgressBars: function(root) {
+      if (window.Vanduo && typeof window.Vanduo.queryAll === "function") {
+        return window.Vanduo.queryAll(root, ".vd-progress-bar[data-progress], .progress-bar[data-progress]");
+      }
+      return Array.from(document.querySelectorAll(".vd-progress-bar[data-progress], .progress-bar[data-progress]"));
+    },
     /**
      * Initialize preloader components
      */
-    init: function() {
-      const progressBars = document.querySelectorAll(".vd-progress-bar[data-progress], .progress-bar[data-progress]");
+    init: function(root) {
+      const progressBars = this.getProgressBars(root);
       progressBars.forEach((bar) => {
         if (!bar.dataset.progressInitialized) {
           this.initProgressBar(bar);
@@ -2947,8 +3318,10 @@ module.exports = __toCommonJS(index_exports);
     /**
      * Destroy all progress bar instances
      */
-    destroyAll: function() {
-      const progressBars = document.querySelectorAll('.vd-progress-bar[data-progress-initialized="true"], .progress-bar[data-progress-initialized="true"]');
+    destroyAll: function(root) {
+      const progressBars = this.getProgressBars(root || document).filter(function(bar) {
+        return bar.dataset.progressInitialized === "true";
+      });
       progressBars.forEach((bar) => {
         delete bar.dataset.progressInitialized;
       });
@@ -2969,8 +3342,8 @@ module.exports = __toCommonJS(index_exports);
     /**
      * Initialize select components
      */
-    init: function() {
-      const selects = document.querySelectorAll("select.vd-custom-select-input, select[data-custom-select]");
+    init: function(root) {
+      const selects = window.Vanduo.queryAll(root, "select.vd-custom-select-input, select[data-custom-select]");
       selects.forEach((select) => {
         if (this.instances.has(select)) {
           return;
@@ -3331,8 +3704,10 @@ module.exports = __toCommonJS(index_exports);
     breakpoint: 992,
     // Desktop breakpoint
     restoreDelayMs: 450,
+    __vanduoScopedDestroyAll: true,
     // Global cleanup functions (toggles, resize)
     _globalCleanups: [],
+    _resizeCleanup: null,
     isFixedVariant: function(sidenav) {
       return sidenav.classList.contains("vd-sidenav-fixed") || sidenav.classList.contains("sidenav-fixed");
     },
@@ -3433,15 +3808,15 @@ module.exports = __toCommonJS(index_exports);
     /**
      * Initialize sidenav components
      */
-    init: function() {
-      const sidenavs = document.querySelectorAll(".vd-sidenav, .vd-offcanvas");
+    init: function(root) {
+      const sidenavs = window.Vanduo.queryAll(root, ".vd-sidenav, .vd-offcanvas");
       sidenavs.forEach((sidenav) => {
         if (this.sidenavs.has(sidenav)) {
           return;
         }
         this.initSidenav(sidenav);
       });
-      const toggles = document.querySelectorAll("[data-sidenav-toggle]");
+      const toggles = window.Vanduo && typeof window.Vanduo.queryAll === "function" ? window.Vanduo.queryAll(root, "[data-sidenav-toggle]") : document.querySelectorAll("[data-sidenav-toggle]");
       toggles.forEach((toggle) => {
         if (toggle.dataset.sidenavToggleInitialized) return;
         toggle.dataset.sidenavToggleInitialized = "true";
@@ -3454,14 +3829,16 @@ module.exports = __toCommonJS(index_exports);
           }
         };
         toggle.addEventListener("click", toggleClickHandler);
-        this._globalCleanups.push(() => toggle.removeEventListener("click", toggleClickHandler));
+        toggle._sidenavToggleCleanup = () => toggle.removeEventListener("click", toggleClickHandler);
       });
       this.handleResize();
-      const resizeHandler = () => {
-        this.handleResize();
-      };
-      window.addEventListener("resize", resizeHandler);
-      this._globalCleanups.push(() => window.removeEventListener("resize", resizeHandler));
+      if (!this._resizeCleanup) {
+        const resizeHandler = () => {
+          this.handleResize();
+        };
+        window.addEventListener("resize", resizeHandler);
+        this._resizeCleanup = () => window.removeEventListener("resize", resizeHandler);
+      }
     },
     /**
      * Initialize a single sidenav
@@ -3634,12 +4011,29 @@ module.exports = __toCommonJS(index_exports);
     /**
      * Destroy all sidenav instances
      */
-    destroyAll: function() {
+    destroyAll: function(root) {
+      const scope = window.Vanduo && typeof window.Vanduo._normalizeRoot === "function" ? window.Vanduo._normalizeRoot(root) : root || document;
       this.sidenavs.forEach((data, sidenav) => {
-        this.destroy(sidenav);
+        if (scope === document || scope === sidenav || typeof scope.contains === "function" && scope.contains(sidenav)) {
+          this.destroy(sidenav);
+        }
       });
-      this._globalCleanups.forEach((fn) => fn());
-      this._globalCleanups = [];
+      const toggles = window.Vanduo && typeof window.Vanduo.queryAll === "function" ? window.Vanduo.queryAll(scope, "[data-sidenav-toggle][data-sidenav-toggle-initialized]") : document.querySelectorAll("[data-sidenav-toggle][data-sidenav-toggle-initialized]");
+      toggles.forEach((toggle) => {
+        if (toggle._sidenavToggleCleanup) {
+          toggle._sidenavToggleCleanup();
+          delete toggle._sidenavToggleCleanup;
+        }
+        delete toggle.dataset.sidenavToggleInitialized;
+      });
+      if (scope === document) {
+        if (this._resizeCleanup) {
+          this._resizeCleanup();
+          this._resizeCleanup = null;
+        }
+        this._globalCleanups.forEach((fn) => fn());
+        this._globalCleanups = [];
+      }
     }
   };
   if (typeof window.Vanduo !== "undefined") {
@@ -3657,8 +4051,8 @@ module.exports = __toCommonJS(index_exports);
     /**
      * Initialize all tab components
      */
-    init: function() {
-      const tabContainers = document.querySelectorAll(".vd-tabs, [data-tabs]");
+    init: function(root) {
+      const tabContainers = window.Vanduo.queryAll(root, ".vd-tabs, [data-tabs]");
       tabContainers.forEach((container) => {
         if (this.instances.has(container)) {
           return;
@@ -3904,9 +4298,9 @@ module.exports = __toCommonJS(index_exports);
     DEFAULTS: {
       PRIMARY_LIGHT: "black",
       PRIMARY_DARK: "amber",
-      NEUTRAL: "neutral",
+      NEUTRAL: "charcoal",
       RADIUS: "0.5",
-      FONT: "lato",
+      FONT: "ubuntu",
       THEME: "system"
     },
     // Primary color definitions (Open Color based)
@@ -3932,6 +4326,7 @@ module.exports = __toCommonJS(index_exports);
     },
     // Neutral color definitions
     NEUTRAL_COLORS: {
+      "charcoal": { name: "Charcoal", color: "#0d1117" },
       "slate": { name: "Slate", color: "#64748b" },
       "gray": { name: "Gray", color: "#6b7280" },
       "zinc": { name: "Zinc", color: "#71717a" },
@@ -3961,21 +4356,65 @@ module.exports = __toCommonJS(index_exports);
     },
     isInitialized: false,
     _cleanup: [],
+    _ownsDynamicPanel: false,
     // DOM references
     elements: {
       customizer: null,
       trigger: null,
+      activeTrigger: null,
       triggers: [],
       panel: null,
       overlay: null
     },
+    isRoot: function(root) {
+      return !!root && (root === document || root.nodeType === 1 || root.nodeType === 9 || root.nodeType === 11);
+    },
+    normalizeRoot: function(root) {
+      return this.isRoot(root) ? root : document;
+    },
+    queryAll: function(root, selector) {
+      const scope = this.normalizeRoot(root);
+      if (typeof window.VanduoLifecycle !== "undefined" && typeof window.VanduoLifecycle.queryAll === "function") {
+        return window.VanduoLifecycle.queryAll(scope, selector);
+      }
+      const matches = [];
+      if (scope instanceof Element && typeof scope.matches === "function" && scope.matches(selector)) {
+        matches.push(scope);
+      }
+      if (typeof scope.querySelectorAll === "function") {
+        const descendants = scope.querySelectorAll(selector);
+        for (let i = 0; i < descendants.length; i++) {
+          matches.push(descendants[i]);
+        }
+      }
+      return matches;
+    },
+    queryOne: function(root, selector) {
+      const matches = this.queryAll(root, selector);
+      return matches.length ? matches[0] : null;
+    },
+    getTriggers: function(root) {
+      return this.queryAll(root, "[data-theme-customizer-trigger]");
+    },
+    pruneTriggers: function() {
+      this.elements.triggers = this.elements.triggers.filter(function(trigger) {
+        return trigger && trigger.isConnected;
+      });
+      if (this.elements.trigger && !this.elements.trigger.isConnected) {
+        this.elements.trigger = null;
+      }
+      if (this.elements.activeTrigger && !this.elements.activeTrigger.isConnected) {
+        this.elements.activeTrigger = null;
+      }
+    },
     /**
      * Initialize the Theme Customizer
      */
-    init: function() {
+    init: function(root) {
+      const scope = this.normalizeRoot(root);
       if (this.isInitialized) {
-        this.bindExistingElements();
-        this.bindTriggerEvents();
+        this.bindExistingElements(scope);
+        this.bindTriggerEvents(scope);
         this.bindPanelEvents();
         this.updateUI();
         return;
@@ -3984,9 +4423,8 @@ module.exports = __toCommonJS(index_exports);
       this._cleanup = [];
       this.loadPreferences();
       this.applyAllPreferences();
-      this.bindExistingElements();
-      this.bindEvents();
-      console.log("Vanduo Theme Customizer initialized");
+      this.bindExistingElements(scope);
+      this.bindEvents(scope);
     },
     addListener: function(target, event, handler, options) {
       if (!target) return;
@@ -4147,18 +4585,26 @@ module.exports = __toCommonJS(index_exports);
     /**
      * Bind to existing DOM elements or create them dynamically
      */
-    bindExistingElements: function() {
-      this.elements.customizer = document.querySelector(".vd-theme-customizer");
-      this.elements.triggers = Array.from(document.querySelectorAll("[data-theme-customizer-trigger]"));
+    bindExistingElements: function(root) {
+      const scope = this.normalizeRoot(root);
+      this.pruneTriggers();
+      const scopedTriggers = this.getTriggers(scope);
+      scopedTriggers.forEach((trigger) => {
+        if (!this.elements.triggers.includes(trigger)) {
+          this.elements.triggers.push(trigger);
+        }
+      });
       if (!this.elements.trigger && this.elements.triggers.length) {
         this.elements.trigger = this.elements.triggers[0];
       }
-      if (this.elements.customizer) {
+      const existingCustomizer = this.queryOne(scope, ".vd-theme-customizer") || (this.elements.customizer && typeof this.elements.customizer.contains === "function" ? this.elements.customizer : null) || document.querySelector(".vd-theme-customizer");
+      if (existingCustomizer instanceof Element) {
+        this.elements.customizer = existingCustomizer;
         this.elements.trigger = this.elements.customizer.querySelector(".vd-theme-customizer-trigger") || this.elements.trigger;
         this.elements.panel = this.elements.customizer.querySelector(".vd-theme-customizer-panel");
         this.elements.overlay = this.elements.customizer.querySelector(".vd-theme-customizer-overlay");
       } else {
-        if (this.elements.triggers.length) {
+        if (scopedTriggers.length && !this.elements.panel) {
           this.createDynamicPanel();
         }
       }
@@ -4168,7 +4614,7 @@ module.exports = __toCommonJS(index_exports);
      * Create the panel dynamically when only a trigger button exists
      */
     createDynamicPanel: function() {
-      if (!this.elements.triggers.length) {
+      if (!this.elements.triggers.length || this.elements.panel && this.elements.panel.isConnected) {
         return;
       }
       this.elements.trigger = this.elements.triggers[0];
@@ -4181,6 +4627,7 @@ module.exports = __toCommonJS(index_exports);
       document.body.appendChild(panel);
       this.elements.panel = panel;
       this.elements.overlay = overlay;
+      this._ownsDynamicPanel = true;
       this.elements.customizer = {
         contains: (el) => panel.contains(el) || this.elements.triggers.some((trigger) => trigger.contains(el))
       };
@@ -4363,8 +4810,8 @@ module.exports = __toCommonJS(index_exports);
         this.state.primary = expected;
       }
     },
-    bindEvents: function() {
-      this.bindTriggerEvents();
+    bindEvents: function(root) {
+      this.bindTriggerEvents(root);
       this.bindPanelEvents();
       if (window.matchMedia) {
         const mq = window.matchMedia("(prefers-color-scheme: dark)");
@@ -4391,21 +4838,44 @@ module.exports = __toCommonJS(index_exports);
         }
       });
     },
-    bindTriggerEvents: function() {
-      this.elements.triggers.forEach((trigger) => {
+    bindTriggerEvents: function(root) {
+      const triggers = root ? this.getTriggers(root) : this.elements.triggers;
+      triggers.forEach((trigger) => {
         if (trigger.getAttribute("data-customizer-trigger-initialized") === "true") {
           return;
         }
-        this.addListener(trigger, "click", (e) => {
+        const onClick = (e) => {
           e.preventDefault();
           e.stopPropagation();
           this.elements.activeTrigger = trigger;
           this.elements.trigger = trigger;
           this.toggle();
-        });
+        };
+        trigger.addEventListener("click", onClick);
+        trigger._themeCustomizerTriggerHandler = onClick;
         trigger.setAttribute("data-customizer-trigger-initialized", "true");
       });
     },
+    cleanupTrigger: function(trigger) {
+      if (!trigger || trigger.getAttribute("data-customizer-trigger-initialized") !== "true") {
+        return;
+      }
+      if (trigger._themeCustomizerTriggerHandler) {
+        trigger.removeEventListener("click", trigger._themeCustomizerTriggerHandler);
+        delete trigger._themeCustomizerTriggerHandler;
+      }
+      trigger.setAttribute("aria-expanded", "false");
+      trigger.removeAttribute("data-customizer-trigger-initialized");
+      if (this.elements.activeTrigger === trigger) {
+        this.elements.activeTrigger = null;
+      }
+      this.elements.triggers = this.elements.triggers.filter(function(candidate) {
+        return candidate !== trigger;
+      });
+      if (this.elements.trigger === trigger) {
+        this.elements.trigger = this.elements.triggers[0] || null;
+      }
+    },
     /**
      * Toggle panel open/close
      */
@@ -4516,13 +4986,42 @@ module.exports = __toCommonJS(index_exports);
         return false;
       }
     },
-    destroyAll: function() {
+    destroyAll: function(root) {
+      const scope = this.normalizeRoot(root);
+      if (scope !== document) {
+        this.getTriggers(scope).forEach((trigger) => {
+          this.cleanupTrigger(trigger);
+        });
+        this.pruneTriggers();
+        if (!this.elements.triggers.length) {
+          this.destroyAll(document);
+        }
+        return;
+      }
       this._cleanup.forEach((fn) => fn());
       this._cleanup = [];
       if (this.elements.panel) {
         this.elements.panel.removeAttribute("data-customizer-initialized");
       }
+      this.elements.triggers.slice().forEach((trigger) => {
+        this.cleanupTrigger(trigger);
+      });
+      if (this._ownsDynamicPanel) {
+        if (this.elements.panel && this.elements.panel.parentNode) {
+          this.elements.panel.parentNode.removeChild(this.elements.panel);
+        }
+        if (this.elements.overlay && this.elements.overlay.parentNode) {
+          this.elements.overlay.parentNode.removeChild(this.elements.overlay);
+        }
+        this._ownsDynamicPanel = false;
+      }
       this.close();
+      this.elements.customizer = null;
+      this.elements.trigger = null;
+      this.elements.activeTrigger = null;
+      this.elements.triggers = [];
+      this.elements.panel = null;
+      this.elements.overlay = null;
       this.isInitialized = false;
     }
   };
@@ -4539,7 +5038,13 @@ module.exports = __toCommonJS(index_exports);
     isInitialized: false,
     _mediaQuery: null,
     _onMediaChange: null,
-    init: function() {
+    getToggles: function(root) {
+      if (window.Vanduo && typeof window.Vanduo.queryAll === "function") {
+        return window.Vanduo.queryAll(root, '[data-toggle="theme"]');
+      }
+      return Array.from(document.querySelectorAll('[data-toggle="theme"]'));
+    },
+    init: function(root) {
       this.STORAGE_KEY = "vanduo-theme-preference";
       this.state = {
         preference: this.getPreference()
@@ -4547,15 +5052,14 @@ module.exports = __toCommonJS(index_exports);
       };
       if (this.isInitialized) {
         this.applyTheme();
-        this.renderUI();
-        this.updateUI();
+        this.renderUI(root);
+        this.updateUI(root);
         return;
       }
       this.isInitialized = true;
       this.applyTheme();
       this.listenForSystemChanges();
-      this.renderUI();
-      console.log("Vanduo Theme Switcher initialized");
+      this.renderUI(root);
     },
     getPreference: function() {
       return this.getStorageValue(this.STORAGE_KEY, "system");
@@ -4615,8 +5119,8 @@ module.exports = __toCommonJS(index_exports);
       this._mediaQuery.addEventListener("change", this._onMediaChange);
     },
     // Helper to facilitate UI creation if needed, though often UI is in HTML
-    renderUI: function() {
-      const toggles = document.querySelectorAll('[data-toggle="theme"]');
+    renderUI: function(root) {
+      const toggles = this.getToggles(root);
       toggles.forEach((toggle) => {
         if (toggle.getAttribute("data-theme-initialized") === "true") {
           if (toggle.tagName === "SELECT") {
@@ -4643,8 +5147,8 @@ module.exports = __toCommonJS(index_exports);
         toggle.setAttribute("data-theme-initialized", "true");
       });
     },
-    updateUI: function() {
-      const toggles = document.querySelectorAll('[data-toggle="theme"]');
+    updateUI: function(root) {
+      const toggles = this.getToggles(root);
       toggles.forEach((toggle) => {
         if (toggle.tagName === "SELECT") {
           toggle.value = this.state.preference;
@@ -4656,8 +5160,11 @@ module.exports = __toCommonJS(index_exports);
         }
       });
     },
-    destroyAll: function() {
-      const toggles = document.querySelectorAll('[data-toggle="theme"][data-theme-initialized="true"]');
+    destroyAll: function(root) {
+      const scope = root || document;
+      const toggles = this.getToggles(scope).filter(function(toggle) {
+        return toggle.getAttribute("data-theme-initialized") === "true";
+      });
       toggles.forEach((toggle) => {
         if (toggle._themeToggleHandler) {
           const eventName = toggle.tagName === "SELECT" ? "change" : "click";
@@ -4666,12 +5173,14 @@ module.exports = __toCommonJS(index_exports);
         }
         toggle.removeAttribute("data-theme-initialized");
       });
-      if (this._mediaQuery && this._onMediaChange) {
+      if (scope === document && this._mediaQuery && this._onMediaChange) {
         this._mediaQuery.removeEventListener("change", this._onMediaChange);
       }
-      this._mediaQuery = null;
-      this._onMediaChange = null;
-      this.isInitialized = false;
+      if (scope === document) {
+        this._mediaQuery = null;
+        this._onMediaChange = null;
+        this.isInitialized = false;
+      }
     }
   };
   if (window.Vanduo) {
@@ -4748,7 +5257,7 @@ module.exports = __toCommonJS(index_exports);
       let html = "";
       if (config.icon) {
         const allowSvg = config.iconAllowSvg === true;
-        const safeIcon = typeof sanitizeHtml === "function" ? sanitizeHtml(config.icon, { allowSvg }) : escapeHtml(config.icon);
+        const safeIcon = typeof sanitizeHtml === "function" ? sanitizeHtml(config.icon, { allowSvg, allowStyle: false }) : escapeHtml(config.icon);
         html += `<span class="vd-toast-icon">${safeIcon}</span>`;
       } else if (config.type) {
         html += `<span class="vd-toast-icon">${this.getDefaultIcon(config.type)}</span>`;
@@ -4968,8 +5477,8 @@ module.exports = __toCommonJS(index_exports);
     /**
      * Initialize tooltips
      */
-    init: function() {
-      const elements = document.querySelectorAll("[data-tooltip], [data-tooltip-html]");
+    init: function(root) {
+      const elements = window.Vanduo.queryAll(root, "[data-tooltip], [data-tooltip-html]");
       elements.forEach((element) => {
         if (this.tooltips.has(element)) {
           return;
@@ -5025,7 +5534,7 @@ module.exports = __toCommonJS(index_exports);
       const textContent = element.dataset.tooltip;
       if (htmlContent) {
         const allowSvg = element.hasAttribute("data-tooltip-allow-svg");
-        tooltip.innerHTML = this.sanitizeHtml(htmlContent, { allowSvg });
+        tooltip.innerHTML = this.sanitizeHtml(htmlContent, { allowSvg, allowStyle: false });
         tooltip.classList.add("vd-tooltip-html");
       } else if (textContent) {
         tooltip.textContent = textContent;
@@ -5158,7 +5667,7 @@ module.exports = __toCommonJS(index_exports);
         const { tooltip } = this.tooltips.get(el);
         if (isHtml) {
           const allowSvg = el.hasAttribute("data-tooltip-allow-svg");
-          tooltip.innerHTML = this.sanitizeHtml(content, { allowSvg });
+          tooltip.innerHTML = this.sanitizeHtml(content, { allowSvg, allowStyle: false });
           tooltip.classList.add("vd-tooltip-html");
         } else {
           tooltip.textContent = content;
@@ -5248,8 +5757,26 @@ module.exports = __toCommonJS(index_exports);
     emptyText: "Try different keywords or check spelling",
     placeholder: "Search..."
   };
+  const ALLOWED_HIGHLIGHT_TAGS = {
+    mark: true,
+    span: true,
+    strong: true,
+    em: true
+  };
+  function isRoot(value) {
+    return typeof window.VanduoLifecycle !== "undefined" && window.VanduoLifecycle.isRoot(value);
+  }
+  function normalizeRoot(root) {
+    return isRoot(root) ? root : document;
+  }
+  function normalizeHighlightTag(tagName) {
+    const normalized = typeof tagName === "string" ? tagName.toLowerCase() : "mark";
+    return ALLOWED_HIGHLIGHT_TAGS[normalized] ? normalized : "mark";
+  }
   function createSearch(options) {
     const config = Object.assign({}, DEFAULTS, options || {});
+    config.root = normalizeRoot(config.root);
+    config.highlightTag = normalizeHighlightTag(config.highlightTag);
     const state = {
       initialized: false,
       index: [],
@@ -5263,6 +5790,24 @@ module.exports = __toCommonJS(index_exports);
       debounceTimer: null,
       boundHandlers: {}
     };
+    function queryAll(selector) {
+      if (window.Vanduo && typeof window.Vanduo.queryAll === "function") {
+        return window.Vanduo.queryAll(config.root, selector);
+      }
+      const scope = normalizeRoot(config.root);
+      if (scope === document) {
+        return Array.from(document.querySelectorAll(selector));
+      }
+      const matches = [];
+      if (scope instanceof Element && scope.matches(selector)) {
+        matches.push(scope);
+      }
+      return matches.concat(Array.from(scope.querySelectorAll(selector)));
+    }
+    function queryOne(selector) {
+      const matches = queryAll(selector);
+      return matches.length ? matches[0] : null;
+    }
     function safeInvokeCallback(name, fn, ...args) {
       try {
         fn(...args);
@@ -5282,7 +5827,7 @@ module.exports = __toCommonJS(index_exports);
       if (state.initialized) {
         return instance;
       }
-      state.container = document.querySelector(config.containerSelector);
+      state.container = queryOne(config.containerSelector);
       if (!state.container) {
         state.initialized = false;
         return null;
@@ -5319,7 +5864,7 @@ module.exports = __toCommonJS(index_exports);
         });
         return;
       }
-      const sections = document.querySelectorAll(config.contentSelector);
+      const sections = queryAll(config.contentSelector);
       const categoryMap = buildCategoryMap();
       sections.forEach(function(section) {
         const id = section.id;
@@ -5354,7 +5899,7 @@ module.exports = __toCommonJS(index_exports);
     function buildCategoryMap() {
       const map = {};
       let currentCategory = "Documentation";
-      const navItems = document.querySelectorAll(config.navSelector + ", " + config.sectionSelector);
+      const navItems = queryAll(config.navSelector + ", " + config.sectionSelector);
       navItems.forEach(function(item) {
         if (item.classList.contains("doc-nav-section")) {
           currentCategory = item.textContent.trim();
@@ -5683,7 +6228,7 @@ module.exports = __toCommonJS(index_exports);
         safeInvokeCallback("onSelect", config.onSelect, result);
         return;
       }
-      const section = document.querySelector(result.url);
+      const section = queryOne(result.url) || document.querySelector(result.url);
       if (section) {
         section.scrollIntoView({ behavior: "smooth", block: "start" });
         window.history.pushState(null, "", result.url);
@@ -5691,7 +6236,7 @@ module.exports = __toCommonJS(index_exports);
       }
     }
     function updateSidebarActive(sectionId) {
-      const navLinks = document.querySelectorAll(config.navSelector);
+      const navLinks = queryAll(config.navSelector);
       navLinks.forEach(function(link) {
         link.classList.remove("active");
         if (link.getAttribute("href") === "#" + sectionId) {
@@ -5738,6 +6283,8 @@ module.exports = __toCommonJS(index_exports);
     }
     function setConfig(newConfig) {
       Object.assign(config, newConfig);
+      config.root = normalizeRoot(config.root);
+      config.highlightTag = normalizeHighlightTag(config.highlightTag);
     }
     function getConfig() {
       return Object.assign({}, config);
@@ -5754,7 +6301,10 @@ module.exports = __toCommonJS(index_exports);
       close,
       setConfig,
       getConfig,
-      getIndex
+      getIndex,
+      getContainer: function() {
+        return state.container;
+      }
     };
     return instance;
   }
@@ -5776,27 +6326,34 @@ module.exports = __toCommonJS(index_exports);
     /**
      * Initialize the default search instance
      */
-    init: function(options) {
+    init: function(rootOrOptions, maybeOptions) {
+      const root = isRoot(rootOrOptions) ? rootOrOptions : null;
+      const options = root ? maybeOptions : rootOrOptions;
       if (this._instance) {
         this._instance.destroy();
       }
       if (options) {
         Object.assign(this.config, options);
       }
-      this._instance = createSearch(this.config);
+      this._instance = createSearch(Object.assign({}, this.config, root ? { root } : {}));
       return this._instance ? this._instance.init() : null;
     },
     /**
      * Destroy the default instance
      */
-    destroy: function() {
+    destroy: function(root) {
+      if (root && this._instance && this._instance.getContainer() && typeof window.VanduoLifecycle !== "undefined") {
+        if (!window.VanduoLifecycle.isInRoot(root, this._instance.getContainer())) {
+          return;
+        }
+      }
       if (this._instance) {
         this._instance.destroy();
         this._instance = null;
       }
     },
-    destroyAll: function() {
-      this.destroy();
+    destroyAll: function(root) {
+      this.destroy(root);
     },
     /**
      * Rebuild the default instance index
@@ -5854,21 +6411,21 @@ module.exports = __toCommonJS(index_exports);
     /**
      * Initialize draggable components
      */
-    init: function() {
-      const draggables = document.querySelectorAll(".vd-draggable, [data-draggable]");
+    init: function(root) {
+      const draggables = window.Vanduo.queryAll(root, ".vd-draggable, [data-draggable]");
       draggables.forEach((element) => {
         if (this.instances.has(element)) {
           return;
         }
         this.initDraggable(element);
       });
-      const containers = document.querySelectorAll(this.containerSelector);
+      const containers = window.Vanduo.queryAll(root, this.containerSelector);
       containers.forEach((container) => {
         if (!this.instances.has(container)) {
           this.initContainer(container);
         }
       });
-      const dropZones = document.querySelectorAll(".vd-drop-zone");
+      const dropZones = window.Vanduo.queryAll(root, ".vd-drop-zone");
       dropZones.forEach((zone) => {
         if (!this.instances.has(zone)) {
           this.initDropZone(zone);
@@ -6478,6 +7035,35 @@ module.exports = __toCommonJS(index_exports);
 (function() {
   "use strict";
   const _observerMap = /* @__PURE__ */ new Map();
+  function _isRoot(root) {
+    return !!root && (root === document || root.nodeType === 1 || root.nodeType === 9 || root.nodeType === 11);
+  }
+  function _normalizeRoot(root) {
+    return _isRoot(root) ? root : document;
+  }
+  function _isInRoot(root, element) {
+    const scope = _normalizeRoot(root);
+    if (!(element instanceof Element)) return false;
+    if (scope === document) {
+      return document.documentElement ? document.documentElement.contains(element) : document.contains(element);
+    }
+    if (scope === element) return true;
+    return typeof scope.contains === "function" && scope.contains(element);
+  }
+  function _queryAll(root, selector) {
+    const scope = _normalizeRoot(root);
+    const matches = [];
+    if (scope instanceof Element && typeof scope.matches === "function" && scope.matches(selector)) {
+      matches.push(scope);
+    }
+    if (typeof scope.querySelectorAll === "function") {
+      const descendants = scope.querySelectorAll(selector);
+      for (let i = 0; i < descendants.length; i++) {
+        matches.push(descendants[i]);
+      }
+    }
+    return matches;
+  }
   function _isSafeUrl(url) {
     try {
       const resolved = new URL(url, window.location.href);
@@ -6565,6 +7151,9 @@ module.exports = __toCommonJS(index_exports);
           if (entry.isIntersecting) {
             obs.unobserve(entry.target);
             _observerMap.delete(entry.target);
+            if (typeof window.VanduoLifecycle !== "undefined" && window.VanduoLifecycle.has(entry.target, "lazyLoad")) {
+              window.VanduoLifecycle.unregister(entry.target, "lazyLoad");
+            }
             try {
               callback(entry.target);
             } catch (e) {
@@ -6574,27 +7163,39 @@ module.exports = __toCommonJS(index_exports);
         });
       }, { threshold, rootMargin });
       _observerMap.set(element, observer);
+      if (typeof window.VanduoLifecycle !== "undefined" && !window.VanduoLifecycle.has(element, "lazyLoad")) {
+        window.VanduoLifecycle.register(element, "lazyLoad", [() => {
+          VanduoLazyLoad.unobserve(element, { skipLifecycle: true });
+        }]);
+      }
       observer.observe(element);
     },
     /**
      * Stop observing an element that was previously passed to observe().
      * @param {Element} element
      */
-    unobserve: function(element) {
+    unobserve: function(element, options) {
+      const opts = options || {};
       const observer = _observerMap.get(element);
       if (observer) {
         observer.unobserve(element);
+        if (typeof observer.disconnect === "function") {
+          observer.disconnect();
+        }
         _observerMap.delete(element);
       }
+      if (!opts.skipLifecycle && typeof window.VanduoLifecycle !== "undefined" && window.VanduoLifecycle.has(element, "lazyLoad")) {
+        window.VanduoLifecycle.unregister(element, "lazyLoad");
+      }
     },
     /**
      * Stop observing ALL currently observed elements.
      */
     unobserveAll: function() {
-      _observerMap.forEach(function(observer, element) {
-        observer.unobserve(element);
+      const observed = Array.from(_observerMap.keys());
+      observed.forEach(function(element) {
+        VanduoLazyLoad.unobserve(element);
       });
-      _observerMap.clear();
     },
     /* ─────────────────────────────────────────────────
      * HIGH-LEVEL API
@@ -6643,7 +7244,7 @@ module.exports = __toCommonJS(index_exports);
           _safeInjectHtml(containerEl, html);
           _dispatch(containerEl, "lazysection:loaded", { url });
           if (typeof window.Vanduo !== "undefined") {
-            window.Vanduo.init();
+            window.Vanduo.init(containerEl);
           }
           if (typeof opts.onLoaded === "function") {
             opts.onLoaded(containerEl);
@@ -6678,9 +7279,9 @@ module.exports = __toCommonJS(index_exports);
      * Scan the DOM for [data-vd-lazy] elements and wire them up.
      * Safe to call multiple times — already-observed elements are skipped.
      */
-    init: function() {
+    init: function(root) {
       const self = this;
-      const elements = document.querySelectorAll("[data-vd-lazy]");
+      const elements = _queryAll(root, "[data-vd-lazy]");
       elements.forEach(function(el) {
         if (_observerMap.has(el) || el.dataset.vdLazyState === "loading" || el.dataset.vdLazyState === "loaded") return;
         const url = el.getAttribute("data-vd-lazy");
@@ -6697,10 +7298,26 @@ module.exports = __toCommonJS(index_exports);
           }
         });
       });
+    },
+    destroy: function(element) {
+      this.unobserve(element);
+    },
+    destroyAll: function(root) {
+      const scope = _normalizeRoot(root);
+      if (scope === document) {
+        this.unobserveAll();
+        return;
+      }
+      const observed = Array.from(_observerMap.keys());
+      observed.forEach((element) => {
+        if (_isInRoot(scope, element)) {
+          this.unobserve(element);
+        }
+      });
     }
   };
   if (typeof window.Vanduo !== "undefined") {
-    window.Vanduo.register("LazyLoad", VanduoLazyLoad);
+    window.Vanduo.register("lazyLoad", VanduoLazyLoad, { aliases: ["LazyLoad"] });
   }
   window.VanduoLazyLoad = VanduoLazyLoad;
 })();
@@ -6711,8 +7328,8 @@ module.exports = __toCommonJS(index_exports);
   const GlassScroll = {
     /** @type {Map<Element, IntersectionObserver>} */
     observers: /* @__PURE__ */ new Map(),
-    init: function() {
-      document.querySelectorAll("[data-glass-scroll]").forEach((el) => {
+    init: function(root) {
+      window.Vanduo.queryAll(root, "[data-glass-scroll]").forEach((el) => {
         if (this.observers.has(el)) return;
         this.initElement(el);
       });
@@ -6772,8 +7389,8 @@ module.exports = __toCommonJS(index_exports);
   const MORPH_DURATION_MS = 750;
   const Morph = {
     instances: /* @__PURE__ */ new Map(),
-    init: function() {
-      const elements = document.querySelectorAll(".vd-morph, [data-vd-morph]");
+    init: function(root) {
+      const elements = window.Vanduo.queryAll(root, ".vd-morph, [data-vd-morph]");
       elements.forEach(function(el) {
         if (Morph.instances.has(el)) return;
         if (el.getAttribute("data-vd-morph") === "manual") return;
@@ -6878,8 +7495,8 @@ module.exports = __toCommonJS(index_exports);
   "use strict";
   const ExpandingCards = {
     instances: /* @__PURE__ */ new Map(),
-    init: function() {
-      document.querySelectorAll(".vd-expanding-cards").forEach(function(el) {
+    init: function(root) {
+      window.Vanduo.queryAll(root, ".vd-expanding-cards").forEach(function(el) {
         if (el.getAttribute("data-vd-expanding-cards") === "manual") return;
         if (ExpandingCards.instances.has(el)) return;
         ExpandingCards.initContainer(el);
@@ -7011,6 +7628,8 @@ module.exports = __toCommonJS(index_exports);
     const playBtn = scope.querySelector("[data-vd-timeline-play]");
     const pauseBtn = scope.querySelector("[data-vd-timeline-pause]");
     let playTimer = null;
+    let isPlaying = false;
+    let playToken = 0;
     function updateNavButtons() {
       const k = countRevealedPrefix(items);
       const n = items.length;
@@ -7025,10 +7644,10 @@ module.exports = __toCommonJS(index_exports);
         nextBtn.setAttribute("aria-disabled", atEnd ? "true" : "false");
       }
       if (playBtn) {
-        playBtn.setAttribute("aria-pressed", playTimer ? "true" : "false");
+        playBtn.setAttribute("aria-pressed", isPlaying ? "true" : "false");
       }
       if (pauseBtn) {
-        pauseBtn.disabled = !playTimer;
+        pauseBtn.disabled = !isPlaying;
       }
     }
     function stepNext() {
@@ -7045,20 +7664,36 @@ module.exports = __toCommonJS(index_exports);
       }
       updateNavButtons();
     }
-    function play() {
-      if (playTimer) return;
-      playTimer = setInterval(function() {
+    function scheduleNext() {
+      const token = ++playToken;
+      playTimer = setTimeout(function() {
+        playTimer = null;
+        if (!isPlaying || token !== playToken) {
+          return;
+        }
         if (countRevealedPrefix(items) >= items.length) {
           pause();
           return;
         }
         stepNext();
+        if (countRevealedPrefix(items) >= items.length) {
+          pause();
+          return;
+        }
+        scheduleNext();
       }, PLAY_INTERVAL_MS);
+    }
+    function play() {
+      if (isPlaying) return;
+      isPlaying = true;
+      scheduleNext();
       updateNavButtons();
     }
     function pause() {
+      isPlaying = false;
+      playToken++;
       if (playTimer) {
-        clearInterval(playTimer);
+        clearTimeout(playTimer);
         playTimer = null;
       }
       updateNavButtons();
@@ -7091,15 +7726,15 @@ module.exports = __toCommonJS(index_exports);
   }
   const Timeline = {
     instances: /* @__PURE__ */ new Map(),
-    init: function() {
-      document.querySelectorAll(".vd-timeline.vd-timeline-animated").forEach(function(el) {
+    init: function(root) {
+      window.Vanduo.queryAll(root, ".vd-timeline.vd-timeline-animated").forEach(function(el) {
         if (Timeline.instances.has(el)) return;
         Timeline.initInstance(el);
       });
     },
-    reinit: function() {
-      Timeline.destroyAll();
-      Timeline.init();
+    reinit: function(root) {
+      Timeline.destroyAll(root);
+      Timeline.init(root);
     },
     initInstance: function(container) {
       const cleanup = [];
@@ -7158,8 +7793,10 @@ module.exports = __toCommonJS(index_exports);
       });
       this.instances.delete(container);
     },
-    destroyAll: function() {
+    destroyAll: function(root) {
+      const scope = window.Vanduo && typeof window.Vanduo._normalizeRoot === "function" ? window.Vanduo._normalizeRoot(root) : document;
       this.instances.forEach(function(_, el) {
+        if (scope !== document && scope !== el && (!scope.contains || !scope.contains(el))) return;
         Timeline.destroy(el);
       });
     }
@@ -7175,8 +7812,8 @@ module.exports = __toCommonJS(index_exports);
   "use strict";
   const Flow = {
     instances: /* @__PURE__ */ new Map(),
-    init: function() {
-      const carousels = document.querySelectorAll(".vd-flow, .vd-carousel");
+    init: function(root) {
+      const carousels = window.Vanduo.queryAll(root, ".vd-flow, .vd-carousel");
       carousels.forEach((el) => {
         if (this.instances.has(el)) return;
         this.initInstance(el);
@@ -7393,8 +8030,8 @@ module.exports = __toCommonJS(index_exports);
   const Bubble = {
     instances: /* @__PURE__ */ new Map(),
     _globalCleanups: [],
-    init: function() {
-      const triggers = document.querySelectorAll("[data-vd-bubble], [data-vd-popover]");
+    init: function(root) {
+      const triggers = window.Vanduo.queryAll(root, "[data-vd-bubble], [data-vd-popover]");
       triggers.forEach((el) => {
         if (this.instances.has(el)) return;
         this.initInstance(el);
@@ -7455,7 +8092,7 @@ module.exports = __toCommonJS(index_exports);
       body.className = "vd-bubble-body";
       if (htmlContent) {
         if (typeof sanitizeHtml === "function") {
-          body.innerHTML = sanitizeHtml(htmlContent, { allowSvg });
+          body.innerHTML = sanitizeHtml(htmlContent, { allowSvg, allowStyle: false });
         } else {
           body.textContent = htmlContent;
         }
@@ -7566,8 +8203,8 @@ module.exports = __toCommonJS(index_exports);
   "use strict";
   const Waypoint = {
     instances: /* @__PURE__ */ new Map(),
-    init: function() {
-      const navs = document.querySelectorAll("[data-vd-waypoint-nav], [data-vd-scrollspy-nav]");
+    init: function(root) {
+      const navs = window.Vanduo.queryAll(root, "[data-vd-waypoint-nav], [data-vd-scrollspy-nav]");
       navs.forEach((nav) => {
         if (this.instances.has(nav)) return;
         this.initInstance(nav);
@@ -7660,8 +8297,8 @@ module.exports = __toCommonJS(index_exports);
   "use strict";
   const Ripple = {
     instances: /* @__PURE__ */ new Map(),
-    init: function() {
-      const elements = document.querySelectorAll(".vd-ripple, [data-vd-ripple]");
+    init: function(root) {
+      const elements = window.Vanduo.queryAll(root, ".vd-ripple, [data-vd-ripple]");
       elements.forEach((el) => {
         if (this.instances.has(el)) return;
         this.initInstance(el);
@@ -7732,8 +8369,8 @@ module.exports = __toCommonJS(index_exports);
   }
   const Affix = {
     instances: /* @__PURE__ */ new Map(),
-    init: function() {
-      const elements = document.querySelectorAll(".vd-affix, .vd-sticky, [data-vd-affix]");
+    init: function(root) {
+      const elements = window.Vanduo.queryAll(root, ".vd-affix, .vd-sticky, [data-vd-affix]");
       elements.forEach((el) => {
         if (this.instances.has(el)) return;
         this.initInstance(el);
@@ -7835,8 +8472,8 @@ module.exports = __toCommonJS(index_exports);
   }
   const Suggest = {
     instances: /* @__PURE__ */ new Map(),
-    init: function() {
-      const inputs = document.querySelectorAll("[data-vd-suggest], [data-vd-autocomplete]");
+    init: function(root) {
+      const inputs = window.Vanduo.queryAll(root, "[data-vd-suggest], [data-vd-autocomplete]");
       inputs.forEach((el) => {
         if (this.instances.has(el)) return;
         this.initInstance(el);
@@ -7998,16 +8635,20 @@ module.exports = __toCommonJS(index_exports);
       const blurHandler = () => {
         setTimeout(close, 200);
       };
+      const focusHandler = () => {
+        if (input.value.length >= minChars) {
+          doSearch(input.value);
+        }
+      };
       input.addEventListener("input", inputHandler);
       input.addEventListener("keydown", keyHandler);
       input.addEventListener("blur", blurHandler);
-      input.addEventListener("focus", () => {
-        if (input.value.length >= minChars) doSearch(input.value);
-      });
+      input.addEventListener("focus", focusHandler);
       cleanup.push(
         () => input.removeEventListener("input", inputHandler),
         () => input.removeEventListener("keydown", keyHandler),
         () => input.removeEventListener("blur", blurHandler),
+        () => input.removeEventListener("focus", focusHandler),
         () => clearTimeout(debounceTimer),
         () => {
           if (list.parentNode) list.parentNode.removeChild(list);
@@ -8082,8 +8723,8 @@ module.exports = __toCommonJS(index_exports);
       pattern: "Invalid format",
       match: "Fields do not match"
     },
-    init: function() {
-      const forms = document.querySelectorAll("[data-vd-validate], .vd-validate");
+    init: function(root) {
+      const forms = window.Vanduo.queryAll(root, "[data-vd-validate], .vd-validate");
       forms.forEach((form) => {
         if (this.instances.has(form)) return;
         this.initInstance(form);
@@ -8320,8 +8961,8 @@ module.exports = __toCommonJS(index_exports);
   }
   const Datepicker = {
     instances: /* @__PURE__ */ new Map(),
-    init: function() {
-      const inputs = document.querySelectorAll("[data-vd-datepicker]");
+    init: function(root) {
+      const inputs = window.Vanduo.queryAll(root, "[data-vd-datepicker]");
       inputs.forEach((el) => {
         if (this.instances.has(el)) return;
         this.initInstance(el);
@@ -8773,8 +9414,8 @@ module.exports = __toCommonJS(index_exports);
   "use strict";
   const Timepicker = {
     instances: /* @__PURE__ */ new Map(),
-    init: function() {
-      const inputs = document.querySelectorAll("[data-vd-timepicker]");
+    init: function(root) {
+      const inputs = window.Vanduo.queryAll(root, "[data-vd-timepicker]");
       inputs.forEach((el) => {
         if (this.instances.has(el)) return;
         this.initInstance(el);
@@ -8888,8 +9529,8 @@ module.exports = __toCommonJS(index_exports);
   "use strict";
   const Stepper = {
     instances: /* @__PURE__ */ new Map(),
-    init: function() {
-      const steppers = document.querySelectorAll(".vd-stepper");
+    init: function(root) {
+      const steppers = window.Vanduo.queryAll(root, ".vd-stepper");
       steppers.forEach((el) => {
         if (this.instances.has(el)) return;
         this.initInstance(el);
@@ -8964,8 +9605,8 @@ module.exports = __toCommonJS(index_exports);
   "use strict";
   const Rating = {
     instances: /* @__PURE__ */ new Map(),
-    init: function() {
-      const ratings = document.querySelectorAll("[data-vd-rating]");
+    init: function(root) {
+      const ratings = window.Vanduo.queryAll(root, "[data-vd-rating]");
       ratings.forEach((el) => {
         if (this.instances.has(el)) return;
         this.initInstance(el);
@@ -9099,8 +9740,8 @@ module.exports = __toCommonJS(index_exports);
   "use strict";
   const Transfer = {
     instances: /* @__PURE__ */ new Map(),
-    init: function() {
-      const transfers = document.querySelectorAll("[data-vd-transfer]");
+    init: function(root) {
+      const transfers = window.Vanduo.queryAll(root, "[data-vd-transfer]");
       transfers.forEach((el) => {
         if (this.instances.has(el)) return;
         this.initInstance(el);
@@ -9263,8 +9904,8 @@ module.exports = __toCommonJS(index_exports);
   "use strict";
   const Tree = {
     instances: /* @__PURE__ */ new Map(),
-    init: function() {
-      const trees = document.querySelectorAll("[data-vd-tree]");
+    init: function(root) {
+      const trees = window.Vanduo.queryAll(root, "[data-vd-tree]");
       trees.forEach((el) => {
         if (this.instances.has(el)) return;
         this.initInstance(el);
@@ -9428,8 +10069,8 @@ module.exports = __toCommonJS(index_exports);
     _cleanup: [],
     _boundTriggers: /* @__PURE__ */ new WeakMap(),
     _triggerElement: null,
-    init: function() {
-      const triggers = document.querySelectorAll("[data-vd-spotlight]");
+    init: function(root) {
+      const triggers = window.Vanduo.queryAll(root, "[data-vd-spotlight]");
       triggers.forEach((trigger) => {
         if (this._boundTriggers.has(trigger)) return;
         const clickHandler = (event) => {
@@ -9702,8 +10343,8 @@ module.exports = __toCommonJS(index_exports);
      * Auto-initialize all .vd-music-player / [data-music-player] elements.
      * Options can be provided via data-music-player-options (JSON string).
      */
-    init: function() {
-      document.querySelectorAll(".vd-music-player, [data-music-player]").forEach((el) => {
+    init: function(root) {
+      window.Vanduo.queryAll(root, ".vd-music-player, [data-music-player]").forEach((el) => {
         if (this.instances.has(el)) return;
         let opts = {};
         const attr = el.getAttribute("data-music-player-options");