@customviews-js/customviews 1.1.5 → 1.1.7

package/dist/custom-views.js

@@ -1,5 +1,5 @@
 /*!
- * @customviews-js/customviews v1.1.4
+ * @customviews-js/customviews v1.1.7
  * (c) 2025 Chan Ger Teck
  * Released under the MIT License.
  */
@@ -273,102 +273,6 @@
         }
     }
 
-    /** --- Icon utilities --- */
-    function ensureFontAwesomeInjected() {
-        const isFontAwesomeLoaded = Array.from(document.styleSheets).some(sheet => sheet.href && (sheet.href.includes('font-awesome') || sheet.href.includes('fontawesome')));
-        if (isFontAwesomeLoaded)
-            return;
-        const link = document.createElement('link');
-        link.rel = 'stylesheet';
-        link.href = 'https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.4.0/css/all.min.css';
-        link.setAttribute('data-customviews-fontawesome', 'true');
-        document.head.appendChild(link);
-    }
-    function replaceIconShortcodes(text) {
-        // Matches :fa-*, :fas-*, :fab-* etc.
-        return text.replace(/:(fa[b|s|r]?)-([\w-]+):/g, (_, style, icon) => {
-            // style = fa, fas, fab, far, etc.
-            // Default to "fa" if only "fa-" is given
-            return `<i class="${style} fa-${icon}"></i>`;
-        });
-    }
-    /** --- Basic renderers --- */
-    function renderImage(el, asset) {
-        if (!asset.src)
-            return;
-        el.innerHTML = '';
-        const img = document.createElement('img');
-        img.src = asset.src;
-        img.alt = asset.alt || '';
-        // Apply custom styling if provided
-        if (asset.className) {
-            img.className = asset.className;
-        }
-        if (asset.style) {
-            img.setAttribute('style', asset.style);
-        }
-        // Default styles (can be overridden by asset.style)
-        img.style.maxWidth = img.style.maxWidth || '100%';
-        img.style.height = img.style.height || 'auto';
-        img.style.display = img.style.display || 'block';
-        el.appendChild(img);
-    }
-    function renderText(el, asset) {
-        if (asset.content != null) {
-            el.textContent = asset.content;
-        }
-        // Apply custom styling if provided
-        if (asset.className) {
-            el.className = asset.className;
-        }
-        if (asset.style) {
-            el.setAttribute('style', asset.style);
-        }
-    }
-    function renderHtml(el, asset) {
-        if (asset.content != null) {
-            el.innerHTML = asset.content;
-        }
-        // Apply custom styling if provided
-        if (asset.className) {
-            el.className = asset.className;
-        }
-        if (asset.style) {
-            el.setAttribute('style', asset.style);
-        }
-    }
-    /** --- Unified asset renderer --- */
-    function detectAssetType(asset) {
-        // If src exists, it's an image
-        if (asset.src)
-            return 'image';
-        // If content contains HTML tags, it's HTML
-        if (asset.content && /<[^>]+>/.test(asset.content)) {
-            return 'html';
-        }
-        return 'text';
-    }
-    function renderAssetInto(el, assetId, assetsManager) {
-        const asset = assetsManager.get(assetId);
-        if (!asset)
-            return;
-        const type = asset.type || detectAssetType(asset);
-        switch (type) {
-            case 'image':
-                renderImage(el, asset);
-                break;
-            case 'text':
-                renderText(el, asset);
-                break;
-            case 'html':
-                renderHtml(el, asset);
-                break;
-            default:
-                el.innerHTML = asset.content || String(asset);
-                console.warn('[CustomViews] Unknown asset type:', type);
-        }
-    }
-
     // Constants for selectors
     const TABGROUP_SELECTOR = 'cv-tabgroup';
     const TAB_SELECTOR = 'cv-tab';
@@ -455,37 +359,35 @@
                 tabEl.classList.remove('cv-visible');
             }
         }
+        /**
+         * Extract header and body content from header component syntax: <cv-tab-header> and <cv-tab-body>
+         * Returns null if using old attribute-based syntax.
+         *
+         * @param tabEl The <cv-tab> element to inspect
+         * @returns Object with extracted content, or null if new syntax not used
+         */
+        static extractTabContent(tabEl) {
+            // Look for direct children 
+            let headerEl = tabEl.querySelector(':scope > cv-tab-header');
+            if (!headerEl) {
+                return null;
+            }
+            const headerHTML = headerEl.innerHTML.trim();
+            // Find body element
+            let bodyEl = tabEl.querySelector(':scope > cv-tab-body');
+            // Fallback: try finding both header and body
+            // without :scope (in case of DOM manipulation) by iterating through tabEl.children if needed
+            return {
+                headerHTML,
+                bodyEl
+            };
+        }
         /**
          * Build navigation for tab groups with nav="auto" (one-time setup)
          */
         static buildNavs(rootEl, cfgGroups, onTabClick, onTabDoubleClick) {
             // Find all cv-tabgroup elements with nav="auto" or no nav attribute
             const tabGroups = rootEl.querySelectorAll(NAV_AUTO_SELECTOR);
-            // Check if any tab headers contain Font Awesome shortcodes
-            // Inject Font Awesome CSS only if needed
-            let hasFontAwesomeShortcodes = false;
-            tabGroups.forEach((groupEl) => {
-                const groupId = groupEl.getAttribute('id');
-                if (!groupId)
-                    return;
-                const tabElements = Array.from(groupEl.children).filter((child) => child.tagName.toLowerCase() === 'cv-tab');
-                // Check for Font Awesome shortcodes in tab headers
-                tabElements.forEach((tabEl) => {
-                    const tabId = tabEl.getAttribute('id');
-                    if (!tabId)
-                        return;
-                    const splitIds = this.splitTabIds(tabId);
-                    const firstId = splitIds[0] || tabId;
-                    const header = tabEl.getAttribute('header') || this.getTabLabel(firstId, groupId, cfgGroups) || firstId || '';
-                    if (/:fa-[\w-]+:/.test(header)) {
-                        hasFontAwesomeShortcodes = true;
-                    }
-                });
-            });
-            // Inject Font Awesome only if shortcodes are found
-            if (hasFontAwesomeShortcodes) {
-                ensureFontAwesomeInjected();
-            }
             tabGroups.forEach((groupEl) => {
                 const groupId = groupEl.getAttribute('id');
                 if (!groupId)
@@ -514,78 +416,71 @@
                 groupEl.insertBefore(navContainer, groupEl.firstChild);
                 // Build nav items
                 tabElements.forEach((tabEl) => {
-                    const tabId = tabEl.getAttribute('id');
-                    if (!tabId)
+                    const rawTabId = tabEl.getAttribute('id');
+                    if (!rawTabId)
                         return;
-                    const splitIds = this.splitTabIds(tabId);
-                    // Header demarcation: if header contains |, split and use per tab.
-                    // If header attribute is present and not demarcated, use it as the fallback header.
-                    const headerAttr = tabEl.getAttribute('header') || '';
-                    let headerParts = [];
-                    if (headerAttr && headerAttr.includes('|')) {
-                        headerParts = headerAttr.split('|').map(h => h.trim());
-                    }
-                    const firstId = splitIds[0] || tabId;
-                    let fallbackHeader = '';
-                    if (headerAttr && !headerAttr.includes('|')) {
-                        // Single header provided on the element: use for all split IDs
-                        fallbackHeader = headerAttr;
+                    const splitIds = this.splitTabIds(rawTabId);
+                    // If multiple IDs, use the first as primary
+                    const tabId = splitIds[0] || rawTabId;
+                    // Get header for this tab - prefer new syntax over old attribute syntax
+                    const extractedHeaderAndBody = this.extractTabContent(tabEl);
+                    let header = '';
+                    // use <cv-tab-header> content if available
+                    if (extractedHeaderAndBody && extractedHeaderAndBody.headerHTML) {
+                        header = extractedHeaderAndBody.headerHTML;
                     }
                     else {
-                        // No header attribute or multi-part header: use config label or id as fallback
-                        fallbackHeader = this.getTabLabel(firstId, groupId, cfgGroups) || firstId || '';
-                    }
-                    // Create nav links for each split ID
-                    splitIds.forEach((splitId, idx) => {
-                        const listItem = document.createElement('li');
-                        listItem.className = 'nav-item';
-                        const navLink = document.createElement('a');
-                        navLink.className = 'nav-link';
-                        // Use demarcated header if available, else prefer config label for this specific splitId
-                        let header = fallbackHeader;
-                        if (headerParts.length === splitIds.length) {
-                            header = headerParts[idx] ?? fallbackHeader;
-                        }
-                        else if (!headerAttr || headerAttr.includes('|')) {
-                            // Prefer the config label for the individual splitId over using firstId
-                            header = this.getTabLabel(splitId, groupId, cfgGroups) || splitId || '';
-                        }
-                        navLink.innerHTML = replaceIconShortcodes(header);
-                        navLink.href = '#';
-                        navLink.setAttribute('data-tab-id', splitId);
-                        navLink.setAttribute('data-group-id', groupId);
-                        navLink.setAttribute('role', 'tab');
-                        // Check if this split ID is active (same logic as applySelections)
-                        const activeTabId = this.resolveActiveTabForGroup(groupId, {}, cfgGroups, groupEl); // Pass empty tabs for initial state
-                        const isActive = splitIds.includes(activeTabId || '');
-                        if (isActive) {
-                            navLink.classList.add('active');
-                            navLink.setAttribute('aria-selected', 'true');
+                        // use header attribute if available
+                        const headerAttr = tabEl.getAttribute('header') || '';
+                        if (headerAttr) {
+                            header = headerAttr;
                         }
                         else {
-                            navLink.setAttribute('aria-selected', 'false');
+                            // Use config label or id as fallback
+                            header = this.getTabLabel(tabId, groupId, cfgGroups) || tabId || '';
                         }
-                        // Add click handler for local tab switch
-                        if (onTabClick) {
-                            navLink.addEventListener('click', (e) => {
-                                e.preventDefault();
-                                // console.log("Single-click detected");
-                                onTabClick(groupId, splitId, groupEl);
-                            });
-                        }
-                        // Add double-click handler for sync
-                        if (onTabDoubleClick) {
-                            navLink.addEventListener('dblclick', (e) => {
-                                e.preventDefault();
-                                // console.log("Double-click detected");
-                                onTabDoubleClick(groupId, splitId, groupEl);
-                            });
-                        }
-                        // Add tooltip for UX feedback (use native title attribute)
-                        navLink.setAttribute('title', 'Double click to change switch tabs across all groups');
-                        listItem.appendChild(navLink);
-                        navContainer.appendChild(listItem);
-                    });
+                    }
+                    // Create a single nav link for this tab element
+                    const listItem = document.createElement('li');
+                    listItem.className = 'nav-item';
+                    const navLink = document.createElement('a');
+                    navLink.className = 'nav-link';
+                    navLink.innerHTML = header;
+                    navLink.href = '#';
+                    navLink.setAttribute('data-tab-id', tabId);
+                    navLink.setAttribute('data-raw-tab-id', rawTabId);
+                    navLink.setAttribute('data-group-id', groupId);
+                    navLink.setAttribute('role', 'tab');
+                    // Check if any of the split IDs is active
+                    const activeTabId = this.resolveActiveTabForGroup(groupId, {}, cfgGroups, groupEl); // Pass empty tabs for initial state
+                    const isActive = splitIds.includes(activeTabId || '');
+                    if (isActive) {
+                        navLink.classList.add('active');
+                        navLink.setAttribute('aria-selected', 'true');
+                    }
+                    else {
+                        navLink.setAttribute('aria-selected', 'false');
+                    }
+                    // Add click handler for local tab switch (if split id, switches to default first ID)
+                    if (onTabClick) {
+                        navLink.addEventListener('click', (e) => {
+                            e.preventDefault();
+                            // console.log("Single-click detected");
+                            onTabClick(groupId, tabId, groupEl);
+                        });
+                    }
+                    // Add double-click handler for sync
+                    if (onTabDoubleClick) {
+                        navLink.addEventListener('dblclick', (e) => {
+                            e.preventDefault();
+                            // console.log("Double-click detected");
+                            onTabDoubleClick(groupId, tabId, groupEl);
+                        });
+                    }
+                    // Add tooltip for UX feedback (use native title attribute)
+                    navLink.setAttribute('title', 'Double click to change switch tabs across all groups');
+                    listItem.appendChild(navLink);
+                    navContainer.appendChild(listItem);
                 });
                 // Add bottom border line at the end of the tab group
                 const bottomBorder = document.createElement('div');
@@ -649,12 +544,12 @@
         static updateNavActiveState(groupEl, activeTabId) {
             const navLinks = groupEl.querySelectorAll('.nav-link');
             navLinks.forEach((link) => {
-                const linkTabId = link.getAttribute('data-tab-id');
-                if (!linkTabId)
+                const rawTabId = link.getAttribute('data-raw-tab-id');
+                if (!rawTabId)
                     return;
-                // Check if activeTabId matches or is in the split IDs of this link
-                const splitIds = this.splitTabIds(linkTabId);
-                const isActive = linkTabId === activeTabId || splitIds.includes(activeTabId);
+                // Check if activeTabId is in the split IDs of this link
+                const splitIds = this.splitTabIds(rawTabId);
+                const isActive = splitIds.includes(activeTabId);
                 if (isActive) {
                     link.classList.add('active');
                     link.setAttribute('aria-selected', 'true');
@@ -681,12 +576,12 @@
                 // Update nav links for this group
                 const navLinks = groupEl.querySelectorAll('.nav-link');
                 navLinks.forEach((link) => {
-                    const linkTabId = link.getAttribute('data-tab-id');
-                    if (!linkTabId)
+                    const rawTabId = link.getAttribute('data-raw-tab-id');
+                    if (!rawTabId)
                         return;
-                    // Check if activeTabId matches or is in the split IDs of this link
-                    const splitIds = this.splitTabIds(linkTabId);
-                    const isActive = linkTabId === activeTabId || splitIds.includes(activeTabId);
+                    // Check if activeTabId is in the split IDs of this link
+                    const splitIds = this.splitTabIds(rawTabId);
+                    const isActive = splitIds.includes(activeTabId);
                     if (isActive) {
                         link.classList.add('active');
                         link.setAttribute('aria-selected', 'true');
@@ -787,6 +682,83 @@
         }
     }
 
+    /** --- Basic renderers --- */
+    function renderImage(el, asset) {
+        if (!asset.src)
+            return;
+        el.innerHTML = '';
+        const img = document.createElement('img');
+        img.src = asset.src;
+        img.alt = asset.alt || '';
+        // Apply custom styling if provided
+        if (asset.className) {
+            img.className = asset.className;
+        }
+        if (asset.style) {
+            img.setAttribute('style', asset.style);
+        }
+        // Default styles (can be overridden by asset.style)
+        img.style.maxWidth = img.style.maxWidth || '100%';
+        img.style.height = img.style.height || 'auto';
+        img.style.display = img.style.display || 'block';
+        el.appendChild(img);
+    }
+    function renderText(el, asset) {
+        if (asset.content != null) {
+            el.textContent = asset.content;
+        }
+        // Apply custom styling if provided
+        if (asset.className) {
+            el.className = asset.className;
+        }
+        if (asset.style) {
+            el.setAttribute('style', asset.style);
+        }
+    }
+    function renderHtml(el, asset) {
+        if (asset.content != null) {
+            el.innerHTML = asset.content;
+        }
+        // Apply custom styling if provided
+        if (asset.className) {
+            el.className = asset.className;
+        }
+        if (asset.style) {
+            el.setAttribute('style', asset.style);
+        }
+    }
+    /** --- Unified asset renderer --- */
+    function detectAssetType(asset) {
+        // If src exists, it's an image
+        if (asset.src)
+            return 'image';
+        // If content contains HTML tags, it's HTML
+        if (asset.content && /<[^>]+>/.test(asset.content)) {
+            return 'html';
+        }
+        return 'text';
+    }
+    function renderAssetInto(el, assetId, assetsManager) {
+        const asset = assetsManager.get(assetId);
+        if (!asset)
+            return;
+        const type = asset.type || detectAssetType(asset);
+        switch (type) {
+            case 'image':
+                renderImage(el, asset);
+                break;
+            case 'text':
+                renderText(el, asset);
+                break;
+            case 'html':
+                renderHtml(el, asset);
+                break;
+            default:
+                el.innerHTML = asset.content || String(asset);
+                console.warn('[CustomViews] Unknown asset type:', type);
+        }
+    }
+
     // Constants for selectors
     const TOGGLE_DATA_SELECTOR = "[data-cv-toggle], [data-customviews-toggle]";
     const TOGGLE_ELEMENT_SELECTOR = "cv-toggle";
@@ -854,166 +826,188 @@
     /**
      * Styles for toggle visibility and animations
      */
-    const TOGGLE_STYLES = `
-/* Core toggle visibility transitions */
-[data-cv-toggle], [data-customviews-toggle], cv-toggle {
-  transition: opacity 150ms ease,
-              transform 150ms ease,
-              max-height 200ms ease,
-              margin 150ms ease;
-  will-change: opacity, transform, max-height, margin;
-}
-
-.cv-visible {
-  opacity: 1 !important;
-  transform: translateY(0) !important;
-  max-height: var(--cv-max-height, 9999px) !important;
-}
-
-.cv-hidden {
-  opacity: 0 !important;
-  transform: translateY(-4px) !important;
-  pointer-events: none !important;
-  padding-top: 0 !important;
-  padding-bottom: 0 !important;
-  border-top-width: 0 !important;
-  border-bottom-width: 0 !important;
-  max-height: 0 !important;
-  margin-top: 0 !important;
-  margin-bottom: 0 !important;
-  overflow: hidden !important;
-}
+    const TOGGLE_STYLES = `
+/* Core toggle visibility transitions */
+[data-cv-toggle], [data-customviews-toggle], cv-toggle {
+  transition: opacity 150ms ease,
+              transform 150ms ease,
+              max-height 200ms ease,
+              margin 150ms ease;
+  will-change: opacity, transform, max-height, margin;
+}
+
+.cv-visible {
+  opacity: 1 !important;
+  transform: translateY(0) !important;
+  max-height: var(--cv-max-height, 9999px) !important;
+}
+
+.cv-hidden {
+  opacity: 0 !important;
+  transform: translateY(-4px) !important;
+  pointer-events: none !important;
+  padding-top: 0 !important;
+  padding-bottom: 0 !important;
+  border-top-width: 0 !important;
+  border-bottom-width: 0 !important;
+  max-height: 0 !important;
+  margin-top: 0 !important;
+  margin-bottom: 0 !important;
+  overflow: hidden !important;
+}
 `;
 
     /**
      * Styles for tab groups and tab navigation
      */
-    const TAB_STYLES = `
-/* Tab navigation styles - Bootstrap-style tabs matching MarkBind */
-.cv-tabs-nav {
-  display: flex;
-  flex-wrap: wrap;
-  padding-left: 0;
-  margin-top: 0.5rem;
-  margin-bottom: 1rem;
-  list-style: none;
-  border-bottom: 1px solid #dee2e6;
-}
-
-.cv-tabs-nav .nav-item {
-  margin-bottom: -1px;
-  list-style: none;
-  display: inline-block;
-}
-
-.cv-tabs-nav .nav-link {
-  display: block;
-  padding: 0.5rem 1rem;
-  color: #495057;
-  text-decoration: none;
-  background-color: transparent;
-  border: 1px solid transparent;
-  border-top-left-radius: 0.25rem;
-  border-top-right-radius: 0.25rem;
-  transition: color 0.15s ease-in-out, background-color 0.15s ease-in-out, border-color 0.15s ease-in-out;
-  cursor: pointer;
-}
-
-.cv-tabs-nav .nav-link:hover,
-.cv-tabs-nav .nav-link:focus {
-  border-color: #e9ecef #e9ecef #dee2e6;
-  isolation: isolate;
-}
-
-.cv-tabs-nav .nav-link.active {
-  color: #495057;
-  background-color: #fff;
-  border-color: #dee2e6 #dee2e6 #fff;
-}
-
-.cv-tabs-nav .nav-link:focus {
-  outline: 0;
-  box-shadow: 0 0 0 0.25rem rgba(13, 110, 253, 0.25);
-}
-
-/* Legacy button-based nav (deprecated, kept for compatibility) */
-.cv-tabs-nav-item {
-  background: none;
-  border: none;
-  border-bottom: 2px solid transparent;
-  padding: 0.5rem 1rem;
-  cursor: pointer;
-  font-size: 1rem;
-  color: #6c757d;
-  transition: color 150ms ease, border-color 150ms ease;
-}
-
-.cv-tabs-nav-item:hover {
-  color: #495057;
-  border-bottom-color: #dee2e6;
-}
-
-.cv-tabs-nav-item.active {
-  color: #007bff;
-  border-bottom-color: #007bff;
-  font-weight: 500;
-}
-
-.cv-tabs-nav-item:focus {
-  outline: 2px solid #007bff;
-  outline-offset: 2px;
-}
-
-/* Tab panel base styles */
-cv-tab {
-  display: block;
-}
-
-/* Override visibility for tab panels - use display instead of collapse animation */
-cv-tab.cv-hidden {
-  display: none !important;
-}
-
-cv-tab.cv-visible {
-  display: block !important;
-}
-
-cv-tabgroup {
-  display: block;
-  margin-bottom: 1.5rem;
-}
-
-/* Bottom border line for tab groups */
-.cv-tabgroup-bottom-border {
-  border-bottom: 1px solid #dee2e6;
-  margin-top: 1rem;
-}
-
-/* Tab content wrapper */
-.cv-tab-content {
-  padding: 1rem 0;
-}
-
-/* Viewer-controlled nav visibility: hide nav containers when requested */
-.cv-tabs-nav-hidden {
-  display: none !important;
-}
-
-/* Print-friendly: hide tab navigation when printing to reduce clutter */
-@media print {
-  .cv-tabs-nav {
-    display: none !important;
-  }
-}
+    const TAB_STYLES = `
+/* Tab navigation styles - Bootstrap-style tabs matching MarkBind */
+.cv-tabs-nav {
+  display: flex;
+  flex-wrap: wrap;
+  padding-left: 0;
+  margin-top: 0.5rem;
+  margin-bottom: 1rem;
+  list-style: none;
+  border-bottom: 1px solid #dee2e6;
+
+  align-items: stretch;
+}
+
+.cv-tabs-nav .nav-item {
+  margin-bottom: -1px;
+  list-style: none;
+  display: flex;              /* was inline-block → make flex to stretch height */
+  align-items: stretch;       /* stretch link to full height */
+}
+
+.cv-tabs-nav .nav-link {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  padding: 0.5rem 1rem;
+  color: #495057;
+  text-decoration: none;
+  background-color: transparent;
+  border: 1px solid transparent;
+  border-top-left-radius: 0.25rem;
+  border-top-right-radius: 0.25rem;
+  transition: color 0.15s ease-in-out, background-color 0.15s ease-in-out, border-color 0.15s ease-in-out;
+  cursor: pointer;
+  min-height: 2.5rem;
+  box-sizing: border-box;
+}
+
+.cv-tabs-nav .nav-link p {
+  margin: 0; /* remove default margins */
+  display: inline; /* or inline-block */
+}
+
+.cv-tabs-nav .nav-link:hover,
+.cv-tabs-nav .nav-link:focus {
+  border-color: #e9ecef #e9ecef #dee2e6;
+  isolation: isolate;
+}
+
+.cv-tabs-nav .nav-link.active {
+  color: #495057;
+  background-color: #fff;
+  border-color: #dee2e6 #dee2e6 #fff;
+}
+
+.cv-tabs-nav .nav-link:focus {
+  outline: 0;
+  box-shadow: 0 0 0 0.25rem rgba(13, 110, 253, 0.25);
+}
+
+/* Legacy button-based nav (deprecated, kept for compatibility) */
+.cv-tabs-nav-item {
+  background: none;
+  border: none;
+  border-bottom: 2px solid transparent;
+  padding: 0.5rem 1rem;
+  cursor: pointer;
+  font-size: 1rem;
+  color: #6c757d;
+  transition: color 150ms ease, border-color 150ms ease;
+}
+
+.cv-tabs-nav-item:hover {
+  color: #495057;
+  border-bottom-color: #dee2e6;
+}
+
+.cv-tabs-nav-item.active {
+  color: #007bff;
+  border-bottom-color: #007bff;
+  font-weight: 500;
+}
+
+.cv-tabs-nav-item:focus {
+  outline: 2px solid #007bff;
+  outline-offset: 2px;
+}
+
+/* Tab panel base styles */
+cv-tab {
+  display: block;
+}
+
+/* Hide cv-tab-header source element; content is extracted to nav link */
+cv-tab-header {
+  display: none !important;
+}
+
+/* Allow cv-tab-body to flow naturally */
+cv-tab-body {
+  display: block;
+}
+
+/* Override visibility for tab panels - use display instead of collapse animation */
+cv-tab.cv-hidden {
+  display: none !important;
+}
+
+cv-tab.cv-visible {
+  display: block !important;
+}
+
+cv-tabgroup {
+  display: block;
+  margin-bottom: 1.5rem;
+}
+
+/* Bottom border line for tab groups */
+.cv-tabgroup-bottom-border {
+  border-bottom: 1px solid #dee2e6;
+  margin-top: 1rem;
+}
+
+/* Tab content wrapper */
+.cv-tab-content {
+  padding: 1rem 0;
+}
+
+/* Viewer-controlled nav visibility: hide nav containers when requested */
+.cv-tabs-nav-hidden {
+  display: none !important;
+}
+
+/* Print-friendly: hide tab navigation when printing to reduce clutter */
+@media print {
+  .cv-tabs-nav {
+    display: none !important;
+  }
+}
 `;
 
     /**
      * Combined core styles for toggles and tabs
      */
-    const CORE_STYLES = `
-${TOGGLE_STYLES}
-
-${TAB_STYLES}
+    const CORE_STYLES = `
+${TOGGLE_STYLES}
+
+${TAB_STYLES}
 `;
     /**
      * Add styles for hiding and showing toggles animations and transitions to the document head
@@ -1331,6 +1325,24 @@ ${TAB_STYLES}
             // Element is managed by Core
         }
     }
+    /**
+     * <cv-tab-header> element - represents tab header with rich HTML formatting
+     * Content is extracted and used in the navigation link
+     */
+    class CVTabHeader extends HTMLElement {
+        connectedCallback() {
+            // Element is a semantic container; TabManager extracts its content
+        }
+    }
+    /**
+     * <cv-tab-body> element - represents tab body content
+     * Semantic container for tab panel content
+     */
+    class CVTabBody extends HTMLElement {
+        connectedCallback() {
+            // Element is a semantic container; visibility managed by TabManager
+        }
+    }
     /**
      * Register custom elements
      */
@@ -1345,6 +1357,12 @@ ${TAB_STYLES}
         if (!customElements.get('cv-toggle')) {
             customElements.define('cv-toggle', CVToggle);
         }
+        if (!customElements.get('cv-tab-header')) {
+            customElements.define('cv-tab-header', CVTabHeader);
+        }
+        if (!customElements.get('cv-tab-body')) {
+            customElements.define('cv-tab-body', CVTabBody);
+        }
     }
 
     /**
@@ -1407,993 +1425,993 @@ ${TAB_STYLES}
      * Note: Styles are kept as a TypeScript string for compatibility with the build system.
      * This approach ensures the styles are properly bundled and don't require separate CSS file handling.
      */
-    const WIDGET_STYLES = `
-/* Rounded rectangle widget icon styles */
-.cv-widget-icon {
-  position: fixed;
-  /* Slightly transparent by default so the widget is subtle at the page edge */
-  background: rgba(255, 255, 255, 0.92);
-  color: rgba(0, 0, 0, 0.9);
-  opacity: 0.6;
-  display: flex;
-  align-items: center;
-  justify-content: center;
-  font-size: 18px;
-  font-weight: bold;
-  cursor: pointer;
-  box-shadow: 0 4px 12px rgba(0, 0, 0, 0.15);
-  z-index: 9998;
-  transition: all 0.3s ease;
-  font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
-}
-
-.cv-widget-icon:hover {
-  /* Become fully opaque on hover to improve readability */
-  background: rgba(255, 255, 255, 1);
-  color: rgba(0, 0, 0, 1);
-  opacity: 1;
-}
-
-/* Top-right: rounded end on left, sticks out leftward on hover */
-.cv-widget-top-right {
-  top: 20px;
-  right: 0;
-  border-radius: 18px 0 0 18px;
-  padding-left: 8px;
-  justify-content: flex-start;
-}
-
-/* Top-left: rounded end on right, sticks out rightward on hover */
-.cv-widget-top-left {
-  top: 20px;
-  left: 0;
-  border-radius: 0 18px 18px 0;
-  padding-right: 8px;
-  justify-content: flex-end;
-}
-
-/* Bottom-right: rounded end on left, sticks out leftward on hover */
-.cv-widget-bottom-right {
-  bottom: 20px;
-  right: 0;
-  border-radius: 18px 0 0 18px;
-  padding-left: 8px;
-  justify-content: flex-start;
-}
-
-/* Bottom-left: rounded end on right, sticks out rightward on hover */
-.cv-widget-bottom-left {
-  bottom: 20px;
-  left: 0;
-  border-radius: 0 18px 18px 0;
-  padding-right: 8px;
-  justify-content: flex-end;
-}
-
-/* Middle-left: rounded end on right, sticks out rightward on hover */
-.cv-widget-middle-left {
-  top: 50%;
-  left: 0;
-  transform: translateY(-50%);
-  border-radius: 0 18px 18px 0;
-  padding-right: 8px;
-  justify-content: flex-end;
-}
-
-/* Middle-right: rounded end on left, sticks out leftward on hover */
-.cv-widget-middle-right {
-  top: 50%;
-  right: 0;
-  transform: translateY(-50%);
-  border-radius: 18px 0 0 18px;
-  padding-left: 8px;
-  justify-content: flex-start;
-}
-
-.cv-widget-top-right,
-.cv-widget-middle-right,
-.cv-widget-bottom-right,
-.cv-widget-top-left,
-.cv-widget-middle-left,
-.cv-widget-bottom-left {
-  height: 36px;
-  width: 36px;
-}
-
-.cv-widget-middle-right:hover,
-.cv-widget-top-right:hover,
-.cv-widget-bottom-right:hover,
-.cv-widget-top-left:hover,
-.cv-widget-middle-left:hover,
-.cv-widget-bottom-left:hover {
-  width: 55px;
-}
-
-/* Modal content styles */
-.cv-widget-section {
-  margin-bottom: 16px;
-}
-
-.cv-widget-section:last-child {
-  margin-bottom: 0;
-}
-
-.cv-widget-section label {
-  display: block;
-  margin-bottom: 4px;
-  font-weight: 500;
-  color: #555;
-}
-
-.cv-widget-profile-select,
-.cv-widget-state-select {
-  width: 100%;
-  padding: 8px 12px;
-  border: 1px solid #ddd;
-  border-radius: 4px;
-  background: white;
-  font-size: 14px;
-}
-
-.cv-widget-profile-select:focus,
-.cv-widget-state-select:focus {
-  outline: none;
-  border-color: #007bff;
-  box-shadow: 0 0 0 2px rgba(0, 123, 255, 0.25);
-}
-
-.cv-widget-profile-select:disabled,
-.cv-widget-state-select:disabled {
-  background: #f8f9fa;
-  color: #6c757d;
-  cursor: not-allowed;
-}
-
-.cv-widget-current {
-  margin: 16px 0;
-  padding: 12px;
-  background: #f8f9fa;
-  border-radius: 4px;
-  border-left: 4px solid #007bff;
-}
-
-.cv-widget-current label {
-  font-size: 12px;
-  text-transform: uppercase;
-  letter-spacing: 0.5px;
-  color: #666;
-  margin-bottom: 4px;
-}
-
-.cv-widget-current-view {
-  font-weight: 500;
-  color: #333;
-}
-
-.cv-widget-reset {
-  width: 100%;
-  padding: 8px 16px;
-  background: #dc3545;
-  color: white;
-  border: none;
-  border-radius: 4px;
-  cursor: pointer;
-  font-size: 14px;
-  font-weight: 500;
-}
-
-.cv-widget-reset:hover {
-  background: #c82333;
-}
-
-.cv-widget-reset:active {
-  background: #bd2130;
-}
-
-/* Responsive design for mobile */
-@media (max-width: 768px) {
-  .cv-widget-top-right,
-  .cv-widget-top-left {
-    top: 10px;
-  }
-
-  .cv-widget-bottom-right,
-  .cv-widget-bottom-left {
-    bottom: 10px;
-  }
-
-  /* All widgets stay flush with screen edges */
-  .cv-widget-top-right,
-  .cv-widget-bottom-right,
-  .cv-widget-middle-right {
-    right: 0;
-  }
-
-  .cv-widget-top-left,
-  .cv-widget-bottom-left,
-  .cv-widget-middle-left {
-    left: 0;
-  }
-
-  /* Slightly smaller on mobile */
-  .cv-widget-icon {
-    width: 60px;
-    height: 32px;
-  }
-
-  .cv-widget-icon:hover {
-    width: 75px;
-  }
-}
-
-/* Modal styles */
-.cv-widget-modal-overlay {
-  position: fixed;
-  top: 0;
-  left: 0;
-  right: 0;
-  bottom: 0;
-  background: rgba(0, 0, 0, 0.5);
-  display: flex;
-  align-items: center;
-  justify-content: center;
-  z-index: 10002;
-  animation: fadeIn 0.2s ease;
-}
-
-@keyframes fadeIn {
-  from { opacity: 0; }
-  to { opacity: 1; }
-}
-
-.cv-widget-modal {
-  background: white;
-  border-radius: 0.75rem;
-  box-shadow: 0 25px 50px -12px rgba(0, 0, 0, 0.25);
-  max-width: 32rem;
-  width: 90vw;
-  max-height: 80vh;
-  animation: slideIn 0.2s ease;
-  display: flex;
-  flex-direction: column;
-}
-
-@keyframes slideIn {
-  from { 
-    opacity: 0;
-    transform: scale(0.9) translateY(-20px);
-  }
-  to { 
-    opacity: 1;
-    transform: scale(1) translateY(0);
-  }
-}
-
-.cv-modal-header {
-  display: flex;
-  align-items: center;
-  justify-content: space-between;
-  padding: 0.5rem 1rem;
-  border-bottom: 1px solid rgba(0, 0, 0, 0.1);
-}
-
-.cv-modal-header-content {
-  display: flex;
-  align-items: center;
-  gap: 0.75rem;
-}
-
-.cv-modal-icon {
-  position: relative;
-  width: 1rem;
-  height: 1rem;
-  display: flex;
-  align-items: center;
-  justify-content: center;
-  border-radius: 9999px;
-}
-
-.cv-modal-icon-svg {
-  width: 100%;
-  height: 100%;
-  opacity: 1;
-}
-
-.cv-modal-title {
-  font-size: 1.125rem;
-  font-weight: bold;
-  color: rgba(0, 0, 0, 0.9);
-  margin: 0;
-}
-
-.cv-modal-close {
-  width: 2rem;
-  height: 2rem;
-  display: flex;
-  align-items: center;
-  justify-content: center;
-  border-radius: 9999px;
-  background: transparent;
-  border: none;
-  color: rgba(0, 0, 0, 0.6);
-  cursor: pointer;
-  transition: all 0.2s ease;
-}
-
-.cv-modal-close:hover {
-  background: rgba(62, 132, 244, 0.1);
-  color: #3e84f4;
-}
-
-.cv-modal-close-icon {
-  width: 1.25rem;
-  height: 1.25rem;
-}
-
-.cv-modal-main {
-  padding: 1rem;
-  flex: 1;
-  display: flex;
-  flex-direction: column;
-  gap: 1rem;
-  overflow-y: auto;
-  max-height: calc(80vh - 8rem);
-}
-
-.cv-modal-description {
-  font-size: 0.875rem;
-  color: rgba(0, 0, 0, 0.8);
-  margin: 0;
-  line-height: 1.4;
-}
-
-.cv-content-section,
-.cv-tab-groups-section {
-  display: flex;
-  flex-direction: column;
-  gap: 0.75rem;
-}
-
-.cv-section-heading {
-  font-size: 1rem;
-  font-weight: bold;
-  color: rgba(0, 0, 0, 0.9);
-  margin: 0;
-}
-
-.cv-widget-modal-actions {
-  margin-top: 20px;
-  padding-top: 16px;
-  border-top: 1px solid #e9ecef;
-}
-
-.cv-widget-restore {
-  width: 100%;
-  padding: 10px 16px;
-  background: #28a745;
-  color: white;
-  border: none;
-  border-radius: 4px;
-  cursor: pointer;
-  font-size: 14px;
-  font-weight: 500;
-}
-
-.cv-widget-restore:hover {
-  background: #218838;
-}
-
-.cv-widget-create-state {
-  width: 100%;
-  padding: 10px 16px;
-  background: #007bff;
-  color: white;
-  border: none;
-  border-radius: 4px;
-  cursor: pointer;
-  font-size: 14px;
-  font-weight: 500;
-  margin-bottom: 10px;
-}
-
-.cv-widget-create-state:hover {
-  background: #0056b3;
-}
-
-.cv-widget-theme-dark .cv-widget-modal {
-  background: #101722;
-  color: #e2e8f0;
-}
-
-.cv-widget-theme-dark .cv-modal-header {
-  border-color: rgba(255, 255, 255, 0.1);
-}
-
-.cv-widget-theme-dark .cv-modal-title {
-  color: #e2e8f0;
-}
-
-.cv-widget-theme-dark .cv-modal-close {
-  color: rgba(255, 255, 255, 0.6);
-}
-
-.cv-widget-theme-dark .cv-modal-close:hover {
-  background: rgba(62, 132, 244, 0.2);
-  color: #3e84f4;
-}
-
-.cv-widget-theme-dark .cv-modal-description {
-  color: rgba(255, 255, 255, 0.8);
-}
-
-.cv-widget-theme-dark .cv-section-heading {
-  color: #e2e8f0;
-}
-
-.cv-widget-theme-dark .cv-toggles-container
-.cv-widget-theme-dark .cv-tabgroups-container {
-  border-color: rgba(255, 255, 255, 0.1);
-}
-
-.cv-widget-theme-dark .cv-toggle-card,
-.cv-widget-theme-dark .cv-tabgroup-card {
-  background: #101722;
-  border-color: rgba(255, 255, 255, 0.1);
-}
-
-.cv-widget-theme-dark .cv-toggle-title,
-.cv-widget-theme-dark .cv-tabgroup-title {
-  color: #e2e8f0;
-}
-
-.cv-widget-theme-dark .cv-toggle-description,
-.cv-widget-theme-dark .cv-tabgroup-description {
-  color: rgba(255, 255, 255, 0.6);
-}
-
-.cv-widget-theme-dark .cv-toggle-slider {
-  background: rgba(255, 255, 255, 0.2);
-}
-
-.cv-widget-theme-dark .cv-tab-group-description {
-  color: rgba(255, 255, 255, 0.8);
-}
-
-.cv-widget-theme-dark .cv-tabgroup-select {
-  background: #101722;
-  border-color: rgba(255, 255, 255, 0.2);
-  color: #e2e8f0;
-}
-
-.cv-widget-theme-dark .cv-modal-footer {
-  border-color: rgba(255, 255, 255, 0.1);
-  background: #101722;
-}
-
-.cv-widget-theme-dark .cv-reset-btn {
-  color: #e2e8f0;
-  background: rgba(255, 255, 255, 0.1);
-}
-
-.cv-widget-theme-dark .cv-reset-btn:hover {
-  background: rgba(255, 255, 255, 0.2);
-}
-
-/* Custom state creator styles */
-.cv-custom-state-modal {
-  max-width: 500px;
-}
-
-.cv-custom-state-form .cv-section-header {
-  font-size: 16px;
-  font-weight: 600;
-  color: #333;
-  border-bottom: 1px solid #e9ecef;
-  padding-bottom: 5px;
-}
-
-.cv-custom-state-form p {
-  font-size: 15px;
-  line-height: 1.6;
-  color: #555;
-  margin-bottom: 24px;
-  text-align: justify;
-}
-
-.cv-custom-state-section {
-  margin-bottom: 16px;
-}
-
-.cv-custom-state-section label {
-  display: block;
-  margin-bottom: 4px;
-  font-weight: 500;
-  color: #555;
-}
-
-.cv-custom-state-input {
-  width: 100%;
-  padding: 8px 12px;
-  border: 1px solid #ddd;
-  border-radius: 4px;
-  background: white;
-  font-size: 14px;
-}
-
-.cv-custom-state-input:focus {
-  outline: none;
-  border-color: #007bff;
-  box-shadow: 0 0 0 2px rgba(0, 123, 255, 0.25);
-}
-
-/* Toggles Container */
-.cv-toggles-container {
-  display: flex;
-  flex-direction: column;
-  gap: 0.5rem;
-  border-radius: 0.5rem;
-  border: 1px solid rgba(0, 0, 0, 0.1);
-  overflow: hidden;
-}
-
-.cv-toggle-card,
-.cv-tabgroup-card {
-  background: white;
-  border-bottom: 1px solid rgba(0, 0, 0, 0.1);
-}
-
-.cv-toggle-card:last-child {
-  border-bottom: none;
-}
-
-.cv-toggle-content {
-  display: flex;
-  align-items: center;
-  justify-content: space-between;
-  padding: 0.75rem;
-}
-
-.cv-toggle-title {
-  font-weight: 500;
-  font-size: 0.875rem;
-  color: rgba(0, 0, 0, 0.9);
-  margin: 0 0 0.125rem 0;
-}
-
-.cv-toggle-description {
-  font-size: 0.75rem;
-  color: rgba(0, 0, 0, 0.6);
-  margin: 0;
-}
-
-.cv-toggle-label{
-  position: relative;
-  display: inline-block;
-  width: 2.75rem;
-  height: 1.5rem;
-  cursor: pointer;
-}
-
-.cv-toggle-input {
-  opacity: 0;
-  width: 0;
-  height: 0;
-}
-
-.cv-toggle-slider {
-  position: absolute;
-  top: 0;
-  left: 0;
-  right: 0;
-  bottom: 0;
-  background: rgba(0, 0, 0, 0.2);
-  border-radius: 9999px;
-  transition: background-color 0.2s ease;
-}
-
-.cv-toggle-slider:before {
-  position: absolute;
-  content: "";
-  height: 1rem;
-  width: 1rem;
-  left: 0.25rem;
-  bottom: 0.25rem;
-  background: white;
-  border-radius: 50%;
-  transition: transform 0.2s ease;
-}
-
-.cv-toggle-input:checked + .cv-toggle-slider {
-  background: #3e84f4;
-}
-
-.cv-toggle-input:checked + .cv-toggle-slider:before {
-  transform: translateX(1.25rem);
-}
-
-/* Dark theme toggle switch styles */
-.cv-widget-theme-dark .cv-toggle-switch {
-  background: #4a5568;
-}
-
-.cv-widget-theme-dark .cv-toggle-switch:hover {
-  background: #5a6578;
-}
-
-.cv-widget-theme-dark .cv-toggle-switch.cv-toggle-active {
-  background: #63b3ed;
-}
-
-.cv-widget-theme-dark .cv-toggle-switch.cv-toggle-active:hover {
-  background: #4299e1;
-}
-
-/* Tab Groups Container */
-.cv-tab-groups-list {
-  display: flex;
-  flex-direction: column;
-  gap: 1px;
-  border: 1px solid rgba(0, 0, 0, 0.1);
-  border-radius: 0.5rem;
-  overflow: hidden;
-}
-
-/* Tab Group Card - Header (Navigation Headers toggle) */
-.cv-tabgroup-card.cv-tabgroup-header {
-  display: flex;
-  align-items: center;
-  justify-content: space-between;
-  padding: 0.75rem;
-  border-bottom: 0px;
-}
-
-.cv-tabgroup-card.cv-tabgroup-header .cv-tabgroup-row {
-  display: flex;
-  align-items: center;
-  justify-content: space-between;
-  width: 100%;
-  gap: 1rem;
-}
-
-/* Tab Group Card - Items */
-.cv-tabgroup-card.cv-tabgroup-item {
-  display: flex;
-  flex-direction: column;
-  gap: 0.5rem;
-  padding: 0.75rem;
-  background: white;
-  border-bottom: 1px solid rgba(0, 0, 0, 0.05);
-}
-
-.cv-tabgroup-card.cv-tabgroup-item:last-child {
-  border-bottom: none;
-}
-
-/* Tab Group Info */
-.cv-tabgroup-info {
-  flex: 1;
-}
-
-.cv-tabgroup-title {
-  font-weight: 500;
-  font-size: 0.875rem;
-  color: rgba(0, 0, 0, 0.9);
-  margin: 0 0 0.25rem 0;
-}
-
-.cv-tabgroup-description {
-  font-size: 0.75rem;
-  color: rgba(0, 0, 0, 0.6);
-  margin: 0;
-  line-height: 1.3;
-}
-
-/* Tab Group Label (for select dropdowns) */
-.cv-tabgroup-label {
-  font-size: 0.875rem;
-  color: rgba(0, 0, 0, 0.8);
-  margin: 0;
-  line-height: 1.4;
-  font-weight: 500;
-  display: block;
-  cursor: pointer;
-}
-
-/* Tab Group Select */
-.cv-tabgroup-select {
-  width: 100%;
-  border-radius: 0.5rem;
-  background: white;
-  border: 1px solid rgba(0, 0, 0, 0.15);
-  color: rgba(0, 0, 0, 0.9);
-  padding: 0.5rem 0.75rem;
-  font-size: 0.875rem;
-  cursor: pointer;
-  transition: all 0.15s ease;
-  font-family: inherit;
-}
-
-.cv-tabgroup-select:hover {
-  border-color: rgba(0, 0, 0, 0.25);
-}
-
-.cv-tabgroup-select:focus {
-  outline: none;
-  border-color: #3e84f4;
-  box-shadow: 0 0 0 2px rgba(62, 132, 244, 0.2);
-}
-
-/* Modern Toggle Switch */
-.cv-toggle-switch {
-  position: relative;
-  display: inline-flex;
-  align-items: center;
-  width: 44px;
-  height: 24px;
-  background: rgba(0, 0, 0, 0.1);
-  border-radius: 9999px;
-  padding: 2px;
-  box-sizing: border-box;
-  cursor: pointer;
-  transition: background-color 0.2s ease;
-  border: none;
-}
-
-.cv-toggle-switch input {
-  display: none;
-}
-
-.cv-toggle-switch .cv-switch-bg {
-  position: absolute;
-  inset: 0;
-  border-radius: 9999px;
-  background: rgba(0, 0, 0, 0.1);
-  transition: background-color 0.2s ease;
-  pointer-events: none;
-}
-
-.cv-toggle-switch .cv-switch-knob {
-  position: relative;
-  width: 20px;
-  height: 20px;
-  background: white;
-  border-radius: 50%;
-  box-shadow: 0 1px 3px rgba(0, 0, 0, 0.12);
-  transition: transform 0.2s ease;
-  z-index: 1;
-}
-
-.cv-toggle-switch input:checked + .cv-switch-bg {
-  background: #3e84f4;
-}
-
-.cv-toggle-switch input:checked ~ .cv-switch-knob {
-  transform: translateX(20px);
-}
-
-/* Dark Theme - Tab Groups */
-.cv-widget-theme-dark .cv-tabgroup-card.cv-tabgroup-header {
-  background: #101722;
-  border-bottom-color: rgba(255, 255, 255, 0.1);
-}
-
-.cv-widget-theme-dark .cv-tabgroup-card.cv-tabgroup-item {
-  background: #101722;
-  border-bottom-color: rgba(255, 255, 255, 0.05);
-}
-
-.cv-widget-theme-dark .cv-tabgroup-title {
-  color: #e2e8f0;
-}
-
-.cv-widget-theme-dark .cv-tabgroup-description {
-  color: rgba(255, 255, 255, 0.6);
-}
-
-.cv-widget-theme-dark .cv-tabgroup-label {
-  color: rgba(255, 255, 255, 0.8);
-}
-
-.cv-widget-theme-dark .cv-tab-groups-list {
-  border-color: rgba(255, 255, 255, 0.1);
-}
-
-.cv-widget-theme-dark .cv-tabgroup-select {
-  background: #101722;
-  border-color: rgba(255, 255, 255, 0.15);
-  color: #e2e8f0;
-}
-
-.cv-widget-theme-dark .cv-tabgroup-select:hover {
-  border-color: rgba(255, 255, 255, 0.25);
-}
-
-.cv-widget-theme-dark .cv-tabgroup-select:focus {
-  border-color: #60a5fa;
-  box-shadow: 0 0 0 2px rgba(96, 165, 250, 0.2);
-}
-
-/* Dark Theme - Toggle Switch */
-.cv-widget-theme-dark .cv-toggle-switch .cv-switch-bg {
-  background: rgba(255, 255, 255, 0.1);
-}
-
-.cv-widget-theme-dark .cv-toggle-switch .cv-switch-knob {
-  background: #e2e8f0;
-}
-
-.cv-widget-theme-dark .cv-toggle-switch input:checked + .cv-switch-bg {
-  background: #63b3ed;
-}
-
-.cv-modal-footer {
-  display: flex;
-  justify-content: space-between;
-  align-items: center;
-  padding: 0.75rem;
-  border-top: 1px solid rgba(0, 0, 0, 0.1);
-}
-
-.cv-reset-btn,
-.cv-share-btn {
-  display: flex;
-  align-items: center;
-  gap: 0.5rem;
-  padding: 0.375rem 0.75rem;
-  border-radius: 0.5rem;
-  font-weight: 600;
-  font-size: 0.875rem;
-  cursor: pointer;
-  transition: all 0.2s ease;
-  border: none;
-}
-
-.cv-reset-btn {
-  color: rgba(0, 0, 0, 0.9);
-  background: rgba(0, 0, 0, 0.1);
-}
-
-.cv-reset-btn:hover {
-  background: rgba(0, 0, 0, 0.2);
-}
-
-.cv-share-btn {
-  color: white;
-  background: #3e84f4;
-}
-
-.cv-share-btn:hover {
-  background: rgba(62, 132, 244, 0.9);
-}
-
-.cv-btn-icon {
-  width: 1rem;
-  height: 1rem;
-}
-
-/* Dark theme custom state styles */
-/* Welcome modal styles */
-.cv-welcome-modal {
-  max-width: 32rem;
-  width: 90vw;
-  background: white;
-  border-radius: 0.75rem;
-  box-shadow: 0 25px 50px -12px rgba(0, 0, 0, 0.25);
-  animation: slideIn 0.2s ease;
-  display: flex;
-  flex-direction: column;
-}
-
-.cv-modal-main {
-  padding: 1rem;
-  flex: 1;
-  display: flex;
-  flex-direction: column;
-  gap: 1rem;
-  overflow-y: auto;
-  max-height: calc(80vh - 8rem);
-}
-
-.cv-welcome-message {
-  font-size: 0.875rem;
-  color: rgba(0, 0, 0, 0.8);
-  margin: 0;
-  line-height: 1.4;
-  text-align: center;
-}
-
-.cv-welcome-message a {
-  color: #3e84f4;
-  text-align: justify;
-  text-decoration: none;
-}
-
-.cv-welcome-message a:hover {
-  text-decoration: underline;
-}
-
-.cv-welcome-widget-preview {
-  display: flex;
-  align-items: center;
-  justify-content: center;
-  gap: 1rem;
-  padding: 1rem;
-  background: #f8f9fa;
-  border-radius: 0.5rem;
-  margin: 1rem 0;
-}
-
-.cv-welcome-widget-icon {
-  width: 2rem;
-  height: 2rem;
-  background: rgba(62, 132, 244, 0.1);
-  border-radius: 9999px;
-  display: flex;
-  align-items: center;
-  justify-content: center;
-  animation: cv-pulse 2s cubic-bezier(0.4, 0, 0.6, 1) infinite;
-  color: #3e84f4;
-}
-
-.cv-welcome-widget-label {
-  font-size: 0.875rem;
-  font-weight: 500;
-  color: rgba(0, 0, 0, 0.8);
-  margin: 0;
-}
-
-.cv-welcome-got-it {
-  width: 100%;
-  background: #3e84f4;
-  color: white;
-  font-weight: 600;
-  padding: 0.75rem 1rem;
-  border-radius: 0.5rem;
-  border: none;
-  cursor: pointer;
-  font-size: 0.875rem;
-  transition: background-color 0.2s ease;
-  outline: none;
-}
-
-.cv-welcome-got-it:hover {
-  background: rgba(62, 132, 244, 0.9);
-}
-
-.cv-welcome-got-it:focus {
-  box-shadow: 0 0 0 2px rgba(62, 132, 244, 0.5);
-}
-
-/* Animations */
-@keyframes cv-pulse {
-  0%, 100% {
-    opacity: 1;
-  }
-  50% {
-    opacity: 0.5;
-  }
-}
-
-/* Dark theme welcome modal styles */
-.cv-widget-theme-dark .cv-welcome-modal {
-  background: #101722;
-}
-
-.cv-widget-theme-dark .cv-welcome-message {
-  color: rgba(255, 255, 255, 0.8);
-}
-
-.cv-widget-theme-dark .cv-welcome-message a {
-  color: #60a5fa;
-}
-
-.cv-widget-theme-dark .cv-welcome-widget-preview {
-  background: rgba(255, 255, 255, 0.1);
-}
-
-.cv-widget-theme-dark .cv-welcome-widget-label {
-  color: #e2e8f0;
-}
+    const WIDGET_STYLES = `
+/* Rounded rectangle widget icon styles */
+.cv-widget-icon {
+  position: fixed;
+  /* Slightly transparent by default so the widget is subtle at the page edge */
+  background: rgba(255, 255, 255, 0.92);
+  color: rgba(0, 0, 0, 0.9);
+  opacity: 0.6;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  font-size: 18px;
+  font-weight: bold;
+  cursor: pointer;
+  box-shadow: 0 4px 12px rgba(0, 0, 0, 0.15);
+  z-index: 9998;
+  transition: all 0.3s ease;
+  font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
+}
+
+.cv-widget-icon:hover {
+  /* Become fully opaque on hover to improve readability */
+  background: rgba(255, 255, 255, 1);
+  color: rgba(0, 0, 0, 1);
+  opacity: 1;
+}
+
+/* Top-right: rounded end on left, sticks out leftward on hover */
+.cv-widget-top-right {
+  top: 20px;
+  right: 0;
+  border-radius: 18px 0 0 18px;
+  padding-left: 8px;
+  justify-content: flex-start;
+}
+
+/* Top-left: rounded end on right, sticks out rightward on hover */
+.cv-widget-top-left {
+  top: 20px;
+  left: 0;
+  border-radius: 0 18px 18px 0;
+  padding-right: 8px;
+  justify-content: flex-end;
+}
+
+/* Bottom-right: rounded end on left, sticks out leftward on hover */
+.cv-widget-bottom-right {
+  bottom: 20px;
+  right: 0;
+  border-radius: 18px 0 0 18px;
+  padding-left: 8px;
+  justify-content: flex-start;
+}
+
+/* Bottom-left: rounded end on right, sticks out rightward on hover */
+.cv-widget-bottom-left {
+  bottom: 20px;
+  left: 0;
+  border-radius: 0 18px 18px 0;
+  padding-right: 8px;
+  justify-content: flex-end;
+}
+
+/* Middle-left: rounded end on right, sticks out rightward on hover */
+.cv-widget-middle-left {
+  top: 50%;
+  left: 0;
+  transform: translateY(-50%);
+  border-radius: 0 18px 18px 0;
+  padding-right: 8px;
+  justify-content: flex-end;
+}
+
+/* Middle-right: rounded end on left, sticks out leftward on hover */
+.cv-widget-middle-right {
+  top: 50%;
+  right: 0;
+  transform: translateY(-50%);
+  border-radius: 18px 0 0 18px;
+  padding-left: 8px;
+  justify-content: flex-start;
+}
+
+.cv-widget-top-right,
+.cv-widget-middle-right,
+.cv-widget-bottom-right,
+.cv-widget-top-left,
+.cv-widget-middle-left,
+.cv-widget-bottom-left {
+  height: 36px;
+  width: 36px;
+}
+
+.cv-widget-middle-right:hover,
+.cv-widget-top-right:hover,
+.cv-widget-bottom-right:hover,
+.cv-widget-top-left:hover,
+.cv-widget-middle-left:hover,
+.cv-widget-bottom-left:hover {
+  width: 55px;
+}
+
+/* Modal content styles */
+.cv-widget-section {
+  margin-bottom: 16px;
+}
+
+.cv-widget-section:last-child {
+  margin-bottom: 0;
+}
+
+.cv-widget-section label {
+  display: block;
+  margin-bottom: 4px;
+  font-weight: 500;
+  color: #555;
+}
+
+.cv-widget-profile-select,
+.cv-widget-state-select {
+  width: 100%;
+  padding: 8px 12px;
+  border: 1px solid #ddd;
+  border-radius: 4px;
+  background: white;
+  font-size: 14px;
+}
+
+.cv-widget-profile-select:focus,
+.cv-widget-state-select:focus {
+  outline: none;
+  border-color: #007bff;
+  box-shadow: 0 0 0 2px rgba(0, 123, 255, 0.25);
+}
+
+.cv-widget-profile-select:disabled,
+.cv-widget-state-select:disabled {
+  background: #f8f9fa;
+  color: #6c757d;
+  cursor: not-allowed;
+}
+
+.cv-widget-current {
+  margin: 16px 0;
+  padding: 12px;
+  background: #f8f9fa;
+  border-radius: 4px;
+  border-left: 4px solid #007bff;
+}
+
+.cv-widget-current label {
+  font-size: 12px;
+  text-transform: uppercase;
+  letter-spacing: 0.5px;
+  color: #666;
+  margin-bottom: 4px;
+}
+
+.cv-widget-current-view {
+  font-weight: 500;
+  color: #333;
+}
+
+.cv-widget-reset {
+  width: 100%;
+  padding: 8px 16px;
+  background: #dc3545;
+  color: white;
+  border: none;
+  border-radius: 4px;
+  cursor: pointer;
+  font-size: 14px;
+  font-weight: 500;
+}
+
+.cv-widget-reset:hover {
+  background: #c82333;
+}
+
+.cv-widget-reset:active {
+  background: #bd2130;
+}
+
+/* Responsive design for mobile */
+@media (max-width: 768px) {
+  .cv-widget-top-right,
+  .cv-widget-top-left {
+    top: 10px;
+  }
+
+  .cv-widget-bottom-right,
+  .cv-widget-bottom-left {
+    bottom: 10px;
+  }
+
+  /* All widgets stay flush with screen edges */
+  .cv-widget-top-right,
+  .cv-widget-bottom-right,
+  .cv-widget-middle-right {
+    right: 0;
+  }
+
+  .cv-widget-top-left,
+  .cv-widget-bottom-left,
+  .cv-widget-middle-left {
+    left: 0;
+  }
+
+  /* Slightly smaller on mobile */
+  .cv-widget-icon {
+    width: 60px;
+    height: 32px;
+  }
+
+  .cv-widget-icon:hover {
+    width: 75px;
+  }
+}
+
+/* Modal styles */
+.cv-widget-modal-overlay {
+  position: fixed;
+  top: 0;
+  left: 0;
+  right: 0;
+  bottom: 0;
+  background: rgba(0, 0, 0, 0.5);
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  z-index: 10002;
+  animation: fadeIn 0.2s ease;
+}
+
+@keyframes fadeIn {
+  from { opacity: 0; }
+  to { opacity: 1; }
+}
+
+.cv-widget-modal {
+  background: white;
+  border-radius: 0.75rem;
+  box-shadow: 0 25px 50px -12px rgba(0, 0, 0, 0.25);
+  max-width: 32rem;
+  width: 90vw;
+  max-height: 80vh;
+  animation: slideIn 0.2s ease;
+  display: flex;
+  flex-direction: column;
+}
+
+@keyframes slideIn {
+  from { 
+    opacity: 0;
+    transform: scale(0.9) translateY(-20px);
+  }
+  to { 
+    opacity: 1;
+    transform: scale(1) translateY(0);
+  }
+}
+
+.cv-modal-header {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  padding: 0.5rem 1rem;
+  border-bottom: 1px solid rgba(0, 0, 0, 0.1);
+}
+
+.cv-modal-header-content {
+  display: flex;
+  align-items: center;
+  gap: 0.75rem;
+}
+
+.cv-modal-icon {
+  position: relative;
+  width: 1rem;
+  height: 1rem;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  border-radius: 9999px;
+}
+
+.cv-modal-icon-svg {
+  width: 100%;
+  height: 100%;
+  opacity: 1;
+}
+
+.cv-modal-title {
+  font-size: 1.125rem;
+  font-weight: bold;
+  color: rgba(0, 0, 0, 0.9);
+  margin: 0;
+}
+
+.cv-modal-close {
+  width: 2rem;
+  height: 2rem;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  border-radius: 9999px;
+  background: transparent;
+  border: none;
+  color: rgba(0, 0, 0, 0.6);
+  cursor: pointer;
+  transition: all 0.2s ease;
+}
+
+.cv-modal-close:hover {
+  background: rgba(62, 132, 244, 0.1);
+  color: #3e84f4;
+}
+
+.cv-modal-close-icon {
+  width: 1.25rem;
+  height: 1.25rem;
+}
+
+.cv-modal-main {
+  padding: 1rem;
+  flex: 1;
+  display: flex;
+  flex-direction: column;
+  gap: 1rem;
+  overflow-y: auto;
+  max-height: calc(80vh - 8rem);
+}
+
+.cv-modal-description {
+  font-size: 0.875rem;
+  color: rgba(0, 0, 0, 0.8);
+  margin: 0;
+  line-height: 1.4;
+}
+
+.cv-content-section,
+.cv-tab-groups-section {
+  display: flex;
+  flex-direction: column;
+  gap: 0.75rem;
+}
+
+.cv-section-heading {
+  font-size: 1rem;
+  font-weight: bold;
+  color: rgba(0, 0, 0, 0.9);
+  margin: 0;
+}
+
+.cv-widget-modal-actions {
+  margin-top: 20px;
+  padding-top: 16px;
+  border-top: 1px solid #e9ecef;
+}
+
+.cv-widget-restore {
+  width: 100%;
+  padding: 10px 16px;
+  background: #28a745;
+  color: white;
+  border: none;
+  border-radius: 4px;
+  cursor: pointer;
+  font-size: 14px;
+  font-weight: 500;
+}
+
+.cv-widget-restore:hover {
+  background: #218838;
+}
+
+.cv-widget-create-state {
+  width: 100%;
+  padding: 10px 16px;
+  background: #007bff;
+  color: white;
+  border: none;
+  border-radius: 4px;
+  cursor: pointer;
+  font-size: 14px;
+  font-weight: 500;
+  margin-bottom: 10px;
+}
+
+.cv-widget-create-state:hover {
+  background: #0056b3;
+}
+
+.cv-widget-theme-dark .cv-widget-modal {
+  background: #101722;
+  color: #e2e8f0;
+}
+
+.cv-widget-theme-dark .cv-modal-header {
+  border-color: rgba(255, 255, 255, 0.1);
+}
+
+.cv-widget-theme-dark .cv-modal-title {
+  color: #e2e8f0;
+}
+
+.cv-widget-theme-dark .cv-modal-close {
+  color: rgba(255, 255, 255, 0.6);
+}
+
+.cv-widget-theme-dark .cv-modal-close:hover {
+  background: rgba(62, 132, 244, 0.2);
+  color: #3e84f4;
+}
+
+.cv-widget-theme-dark .cv-modal-description {
+  color: rgba(255, 255, 255, 0.8);
+}
+
+.cv-widget-theme-dark .cv-section-heading {
+  color: #e2e8f0;
+}
+
+.cv-widget-theme-dark .cv-toggles-container
+.cv-widget-theme-dark .cv-tabgroups-container {
+  border-color: rgba(255, 255, 255, 0.1);
+}
+
+.cv-widget-theme-dark .cv-toggle-card,
+.cv-widget-theme-dark .cv-tabgroup-card {
+  background: #101722;
+  border-color: rgba(255, 255, 255, 0.1);
+}
+
+.cv-widget-theme-dark .cv-toggle-title,
+.cv-widget-theme-dark .cv-tabgroup-title {
+  color: #e2e8f0;
+}
+
+.cv-widget-theme-dark .cv-toggle-description,
+.cv-widget-theme-dark .cv-tabgroup-description {
+  color: rgba(255, 255, 255, 0.6);
+}
+
+.cv-widget-theme-dark .cv-toggle-slider {
+  background: rgba(255, 255, 255, 0.2);
+}
+
+.cv-widget-theme-dark .cv-tab-group-description {
+  color: rgba(255, 255, 255, 0.8);
+}
+
+.cv-widget-theme-dark .cv-tabgroup-select {
+  background: #101722;
+  border-color: rgba(255, 255, 255, 0.2);
+  color: #e2e8f0;
+}
+
+.cv-widget-theme-dark .cv-modal-footer {
+  border-color: rgba(255, 255, 255, 0.1);
+  background: #101722;
+}
+
+.cv-widget-theme-dark .cv-reset-btn {
+  color: #e2e8f0;
+  background: rgba(255, 255, 255, 0.1);
+}
+
+.cv-widget-theme-dark .cv-reset-btn:hover {
+  background: rgba(255, 255, 255, 0.2);
+}
+
+/* Custom state creator styles */
+.cv-custom-state-modal {
+  max-width: 500px;
+}
+
+.cv-custom-state-form .cv-section-header {
+  font-size: 16px;
+  font-weight: 600;
+  color: #333;
+  border-bottom: 1px solid #e9ecef;
+  padding-bottom: 5px;
+}
+
+.cv-custom-state-form p {
+  font-size: 15px;
+  line-height: 1.6;
+  color: #555;
+  margin-bottom: 24px;
+  text-align: justify;
+}
+
+.cv-custom-state-section {
+  margin-bottom: 16px;
+}
+
+.cv-custom-state-section label {
+  display: block;
+  margin-bottom: 4px;
+  font-weight: 500;
+  color: #555;
+}
+
+.cv-custom-state-input {
+  width: 100%;
+  padding: 8px 12px;
+  border: 1px solid #ddd;
+  border-radius: 4px;
+  background: white;
+  font-size: 14px;
+}
+
+.cv-custom-state-input:focus {
+  outline: none;
+  border-color: #007bff;
+  box-shadow: 0 0 0 2px rgba(0, 123, 255, 0.25);
+}
+
+/* Toggles Container */
+.cv-toggles-container {
+  display: flex;
+  flex-direction: column;
+  gap: 0.5rem;
+  border-radius: 0.5rem;
+  border: 1px solid rgba(0, 0, 0, 0.1);
+  overflow: hidden;
+}
+
+.cv-toggle-card,
+.cv-tabgroup-card {
+  background: white;
+  border-bottom: 1px solid rgba(0, 0, 0, 0.1);
+}
+
+.cv-toggle-card:last-child {
+  border-bottom: none;
+}
+
+.cv-toggle-content {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  padding: 0.75rem;
+}
+
+.cv-toggle-title {
+  font-weight: 500;
+  font-size: 0.875rem;
+  color: rgba(0, 0, 0, 0.9);
+  margin: 0 0 0.125rem 0;
+}
+
+.cv-toggle-description {
+  font-size: 0.75rem;
+  color: rgba(0, 0, 0, 0.6);
+  margin: 0;
+}
+
+.cv-toggle-label{
+  position: relative;
+  display: inline-block;
+  width: 2.75rem;
+  height: 1.5rem;
+  cursor: pointer;
+}
+
+.cv-toggle-input {
+  opacity: 0;
+  width: 0;
+  height: 0;
+}
+
+.cv-toggle-slider {
+  position: absolute;
+  top: 0;
+  left: 0;
+  right: 0;
+  bottom: 0;
+  background: rgba(0, 0, 0, 0.2);
+  border-radius: 9999px;
+  transition: background-color 0.2s ease;
+}
+
+.cv-toggle-slider:before {
+  position: absolute;
+  content: "";
+  height: 1rem;
+  width: 1rem;
+  left: 0.25rem;
+  bottom: 0.25rem;
+  background: white;
+  border-radius: 50%;
+  transition: transform 0.2s ease;
+}
+
+.cv-toggle-input:checked + .cv-toggle-slider {
+  background: #3e84f4;
+}
+
+.cv-toggle-input:checked + .cv-toggle-slider:before {
+  transform: translateX(1.25rem);
+}
+
+/* Dark theme toggle switch styles */
+.cv-widget-theme-dark .cv-toggle-switch {
+  background: #4a5568;
+}
+
+.cv-widget-theme-dark .cv-toggle-switch:hover {
+  background: #5a6578;
+}
+
+.cv-widget-theme-dark .cv-toggle-switch.cv-toggle-active {
+  background: #63b3ed;
+}
+
+.cv-widget-theme-dark .cv-toggle-switch.cv-toggle-active:hover {
+  background: #4299e1;
+}
+
+/* Tab Groups Container */
+.cv-tab-groups-list {
+  display: flex;
+  flex-direction: column;
+  gap: 1px;
+  border: 1px solid rgba(0, 0, 0, 0.1);
+  border-radius: 0.5rem;
+  overflow: hidden;
+}
+
+/* Tab Group Card - Header (Navigation Headers toggle) */
+.cv-tabgroup-card.cv-tabgroup-header {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  padding: 0.75rem;
+  border-bottom: 0px;
+}
+
+.cv-tabgroup-card.cv-tabgroup-header .cv-tabgroup-row {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  width: 100%;
+  gap: 1rem;
+}
+
+/* Tab Group Card - Items */
+.cv-tabgroup-card.cv-tabgroup-item {
+  display: flex;
+  flex-direction: column;
+  gap: 0.5rem;
+  padding: 0.75rem;
+  background: white;
+  border-bottom: 1px solid rgba(0, 0, 0, 0.05);
+}
+
+.cv-tabgroup-card.cv-tabgroup-item:last-child {
+  border-bottom: none;
+}
+
+/* Tab Group Info */
+.cv-tabgroup-info {
+  flex: 1;
+}
+
+.cv-tabgroup-title {
+  font-weight: 500;
+  font-size: 0.875rem;
+  color: rgba(0, 0, 0, 0.9);
+  margin: 0 0 0.25rem 0;
+}
+
+.cv-tabgroup-description {
+  font-size: 0.75rem;
+  color: rgba(0, 0, 0, 0.6);
+  margin: 0;
+  line-height: 1.3;
+}
+
+/* Tab Group Label (for select dropdowns) */
+.cv-tabgroup-label {
+  font-size: 0.875rem;
+  color: rgba(0, 0, 0, 0.8);
+  margin: 0;
+  line-height: 1.4;
+  font-weight: 500;
+  display: block;
+  cursor: pointer;
+}
+
+/* Tab Group Select */
+.cv-tabgroup-select {
+  width: 100%;
+  border-radius: 0.5rem;
+  background: white;
+  border: 1px solid rgba(0, 0, 0, 0.15);
+  color: rgba(0, 0, 0, 0.9);
+  padding: 0.5rem 0.75rem;
+  font-size: 0.875rem;
+  cursor: pointer;
+  transition: all 0.15s ease;
+  font-family: inherit;
+}
+
+.cv-tabgroup-select:hover {
+  border-color: rgba(0, 0, 0, 0.25);
+}
+
+.cv-tabgroup-select:focus {
+  outline: none;
+  border-color: #3e84f4;
+  box-shadow: 0 0 0 2px rgba(62, 132, 244, 0.2);
+}
+
+/* Modern Toggle Switch */
+.cv-toggle-switch {
+  position: relative;
+  display: inline-flex;
+  align-items: center;
+  width: 44px;
+  height: 24px;
+  background: rgba(0, 0, 0, 0.1);
+  border-radius: 9999px;
+  padding: 2px;
+  box-sizing: border-box;
+  cursor: pointer;
+  transition: background-color 0.2s ease;
+  border: none;
+}
+
+.cv-toggle-switch input {
+  display: none;
+}
+
+.cv-toggle-switch .cv-switch-bg {
+  position: absolute;
+  inset: 0;
+  border-radius: 9999px;
+  background: rgba(0, 0, 0, 0.1);
+  transition: background-color 0.2s ease;
+  pointer-events: none;
+}
+
+.cv-toggle-switch .cv-switch-knob {
+  position: relative;
+  width: 20px;
+  height: 20px;
+  background: white;
+  border-radius: 50%;
+  box-shadow: 0 1px 3px rgba(0, 0, 0, 0.12);
+  transition: transform 0.2s ease;
+  z-index: 1;
+}
+
+.cv-toggle-switch input:checked + .cv-switch-bg {
+  background: #3e84f4;
+}
+
+.cv-toggle-switch input:checked ~ .cv-switch-knob {
+  transform: translateX(20px);
+}
+
+/* Dark Theme - Tab Groups */
+.cv-widget-theme-dark .cv-tabgroup-card.cv-tabgroup-header {
+  background: #101722;
+  border-bottom-color: rgba(255, 255, 255, 0.1);
+}
+
+.cv-widget-theme-dark .cv-tabgroup-card.cv-tabgroup-item {
+  background: #101722;
+  border-bottom-color: rgba(255, 255, 255, 0.05);
+}
+
+.cv-widget-theme-dark .cv-tabgroup-title {
+  color: #e2e8f0;
+}
+
+.cv-widget-theme-dark .cv-tabgroup-description {
+  color: rgba(255, 255, 255, 0.6);
+}
+
+.cv-widget-theme-dark .cv-tabgroup-label {
+  color: rgba(255, 255, 255, 0.8);
+}
+
+.cv-widget-theme-dark .cv-tab-groups-list {
+  border-color: rgba(255, 255, 255, 0.1);
+}
+
+.cv-widget-theme-dark .cv-tabgroup-select {
+  background: #101722;
+  border-color: rgba(255, 255, 255, 0.15);
+  color: #e2e8f0;
+}
+
+.cv-widget-theme-dark .cv-tabgroup-select:hover {
+  border-color: rgba(255, 255, 255, 0.25);
+}
+
+.cv-widget-theme-dark .cv-tabgroup-select:focus {
+  border-color: #60a5fa;
+  box-shadow: 0 0 0 2px rgba(96, 165, 250, 0.2);
+}
+
+/* Dark Theme - Toggle Switch */
+.cv-widget-theme-dark .cv-toggle-switch .cv-switch-bg {
+  background: rgba(255, 255, 255, 0.1);
+}
+
+.cv-widget-theme-dark .cv-toggle-switch .cv-switch-knob {
+  background: #e2e8f0;
+}
+
+.cv-widget-theme-dark .cv-toggle-switch input:checked + .cv-switch-bg {
+  background: #63b3ed;
+}
+
+.cv-modal-footer {
+  display: flex;
+  justify-content: space-between;
+  align-items: center;
+  padding: 0.75rem;
+  border-top: 1px solid rgba(0, 0, 0, 0.1);
+}
+
+.cv-reset-btn,
+.cv-share-btn {
+  display: flex;
+  align-items: center;
+  gap: 0.5rem;
+  padding: 0.375rem 0.75rem;
+  border-radius: 0.5rem;
+  font-weight: 600;
+  font-size: 0.875rem;
+  cursor: pointer;
+  transition: all 0.2s ease;
+  border: none;
+}
+
+.cv-reset-btn {
+  color: rgba(0, 0, 0, 0.9);
+  background: rgba(0, 0, 0, 0.1);
+}
+
+.cv-reset-btn:hover {
+  background: rgba(0, 0, 0, 0.2);
+}
+
+.cv-share-btn {
+  color: white;
+  background: #3e84f4;
+}
+
+.cv-share-btn:hover {
+  background: rgba(62, 132, 244, 0.9);
+}
+
+.cv-btn-icon {
+  width: 1rem;
+  height: 1rem;
+}
+
+/* Dark theme custom state styles */
+/* Welcome modal styles */
+.cv-welcome-modal {
+  max-width: 32rem;
+  width: 90vw;
+  background: white;
+  border-radius: 0.75rem;
+  box-shadow: 0 25px 50px -12px rgba(0, 0, 0, 0.25);
+  animation: slideIn 0.2s ease;
+  display: flex;
+  flex-direction: column;
+}
+
+.cv-modal-main {
+  padding: 1rem;
+  flex: 1;
+  display: flex;
+  flex-direction: column;
+  gap: 1rem;
+  overflow-y: auto;
+  max-height: calc(80vh - 8rem);
+}
+
+.cv-welcome-message {
+  font-size: 0.875rem;
+  color: rgba(0, 0, 0, 0.8);
+  margin: 0;
+  line-height: 1.4;
+  text-align: center;
+}
+
+.cv-welcome-message a {
+  color: #3e84f4;
+  text-align: justify;
+  text-decoration: none;
+}
+
+.cv-welcome-message a:hover {
+  text-decoration: underline;
+}
+
+.cv-welcome-widget-preview {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  gap: 1rem;
+  padding: 1rem;
+  background: #f8f9fa;
+  border-radius: 0.5rem;
+  margin: 1rem 0;
+}
+
+.cv-welcome-widget-icon {
+  width: 2rem;
+  height: 2rem;
+  background: rgba(62, 132, 244, 0.1);
+  border-radius: 9999px;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  animation: cv-pulse 2s cubic-bezier(0.4, 0, 0.6, 1) infinite;
+  color: #3e84f4;
+}
+
+.cv-welcome-widget-label {
+  font-size: 0.875rem;
+  font-weight: 500;
+  color: rgba(0, 0, 0, 0.8);
+  margin: 0;
+}
+
+.cv-welcome-got-it {
+  width: 100%;
+  background: #3e84f4;
+  color: white;
+  font-weight: 600;
+  padding: 0.75rem 1rem;
+  border-radius: 0.5rem;
+  border: none;
+  cursor: pointer;
+  font-size: 0.875rem;
+  transition: background-color 0.2s ease;
+  outline: none;
+}
+
+.cv-welcome-got-it:hover {
+  background: rgba(62, 132, 244, 0.9);
+}
+
+.cv-welcome-got-it:focus {
+  box-shadow: 0 0 0 2px rgba(62, 132, 244, 0.5);
+}
+
+/* Animations */
+@keyframes cv-pulse {
+  0%, 100% {
+    opacity: 1;
+  }
+  50% {
+    opacity: 0.5;
+  }
+}
+
+/* Dark theme welcome modal styles */
+.cv-widget-theme-dark .cv-welcome-modal {
+  background: #101722;
+}
+
+.cv-widget-theme-dark .cv-welcome-message {
+  color: rgba(255, 255, 255, 0.8);
+}
+
+.cv-widget-theme-dark .cv-welcome-message a {
+  color: #60a5fa;
+}
+
+.cv-widget-theme-dark .cv-welcome-widget-preview {
+  background: rgba(255, 255, 255, 0.1);
+}
+
+.cv-widget-theme-dark .cv-welcome-widget-label {
+  color: #e2e8f0;
+}
 `;
     /**
      * Inject widget styles into the document head
@@ -2416,34 +2434,34 @@ ${TAB_STYLES}
      * Settings gear icon for modal header
      */
     function getGearIcon() {
-        return `<svg class="cv-modal-icon-svg" fill="currentColor" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg">
-  <path xmlns="http://www.w3.org/2000/svg" fill-rule="evenodd" clip-rule="evenodd" d="M12 8.00002C9.79085 8.00002 7.99999 9.79088 7.99999 12C7.99999 14.2092 9.79085 16 12 16C14.2091 16 16 14.2092 16 12C16 9.79088 14.2091 8.00002 12 8.00002ZM9.99999 12C9.99999 10.8955 10.8954 10 12 10C13.1046 10 14 10.8955 14 12C14 13.1046 13.1046 14 12 14C10.8954 14 9.99999 13.1046 9.99999 12Z" fill="#0F1729"/>
-  <path xmlns="http://www.w3.org/2000/svg" fill-rule="evenodd" clip-rule="evenodd" d="M10.7673 1.01709C10.9925 0.999829 11.2454 0.99993 11.4516 1.00001L12.5484 1.00001C12.7546 0.99993 13.0075 0.999829 13.2327 1.01709C13.4989 1.03749 13.8678 1.08936 14.2634 1.26937C14.7635 1.49689 15.1915 1.85736 15.5007 2.31147C15.7454 2.67075 15.8592 3.0255 15.9246 3.2843C15.9799 3.50334 16.0228 3.75249 16.0577 3.9557L16.1993 4.77635L16.2021 4.77788C16.2369 4.79712 16.2715 4.81659 16.306 4.8363L16.3086 4.83774L17.2455 4.49865C17.4356 4.42978 17.6693 4.34509 17.8835 4.28543C18.1371 4.2148 18.4954 4.13889 18.9216 4.17026C19.4614 4.20998 19.9803 4.39497 20.4235 4.70563C20.7734 4.95095 21.0029 5.23636 21.1546 5.4515C21.2829 5.63326 21.4103 5.84671 21.514 6.02029L22.0158 6.86003C22.1256 7.04345 22.2594 7.26713 22.3627 7.47527C22.4843 7.7203 22.6328 8.07474 22.6777 8.52067C22.7341 9.08222 22.6311 9.64831 22.3803 10.1539C22.1811 10.5554 21.9171 10.8347 21.7169 11.0212C21.5469 11.1795 21.3428 11.3417 21.1755 11.4746L20.5 12L21.1755 12.5254C21.3428 12.6584 21.5469 12.8205 21.7169 12.9789C21.9171 13.1653 22.1811 13.4446 22.3802 13.8461C22.631 14.3517 22.7341 14.9178 22.6776 15.4794C22.6328 15.9253 22.4842 16.2797 22.3626 16.5248C22.2593 16.7329 22.1255 16.9566 22.0158 17.14L21.5138 17.9799C21.4102 18.1535 21.2828 18.3668 21.1546 18.5485C21.0028 18.7637 20.7734 19.0491 20.4234 19.2944C19.9803 19.6051 19.4613 19.7901 18.9216 19.8298C18.4954 19.8612 18.1371 19.7852 17.8835 19.7146C17.6692 19.6549 17.4355 19.5703 17.2454 19.5014L16.3085 19.1623L16.306 19.1638C16.2715 19.1835 16.2369 19.2029 16.2021 19.2222L16.1993 19.2237L16.0577 20.0443C16.0228 20.2475 15.9799 20.4967 15.9246 20.7157C15.8592 20.9745 15.7454 21.3293 15.5007 21.6886C15.1915 22.1427 14.7635 22.5032 14.2634 22.7307C13.8678 22.9107 13.4989 22.9626 13.2327 22.983C13.0074 23.0002 12.7546 23.0001 12.5484 23H11.4516C11.2454 23.0001 10.9925 23.0002 10.7673 22.983C10.5011 22.9626 10.1322 22.9107 9.73655 22.7307C9.23648 22.5032 8.80849 22.1427 8.49926 21.6886C8.25461 21.3293 8.14077 20.9745 8.07542 20.7157C8.02011 20.4967 7.97723 20.2475 7.94225 20.0443L7.80068 19.2237L7.79791 19.2222C7.7631 19.2029 7.72845 19.1835 7.69396 19.1637L7.69142 19.1623L6.75458 19.5014C6.5645 19.5702 6.33078 19.6549 6.11651 19.7146C5.86288 19.7852 5.50463 19.8611 5.07841 19.8298C4.53866 19.7901 4.01971 19.6051 3.57654 19.2944C3.2266 19.0491 2.99714 18.7637 2.84539 18.5485C2.71718 18.3668 2.58974 18.1534 2.4861 17.9798L1.98418 17.14C1.87447 16.9566 1.74067 16.7329 1.63737 16.5248C1.51575 16.2797 1.36719 15.9253 1.32235 15.4794C1.26588 14.9178 1.36897 14.3517 1.61976 13.8461C1.81892 13.4446 2.08289 13.1653 2.28308 12.9789C2.45312 12.8205 2.65717 12.6584 2.82449 12.5254L3.47844 12.0054V11.9947L2.82445 11.4746C2.65712 11.3417 2.45308 11.1795 2.28304 11.0212C2.08285 10.8347 1.81888 10.5554 1.61972 10.1539C1.36893 9.64832 1.26584 9.08224 1.3223 8.52069C1.36714 8.07476 1.51571 7.72032 1.63732 7.47528C1.74062 7.26715 1.87443 7.04347 1.98414 6.86005L2.48605 6.02026C2.58969 5.84669 2.71714 5.63326 2.84534 5.45151C2.9971 5.23637 3.22655 4.95096 3.5765 4.70565C4.01966 4.39498 4.53862 4.20999 5.07837 4.17027C5.50458 4.1389 5.86284 4.21481 6.11646 4.28544C6.33072 4.34511 6.56444 4.4298 6.75451 4.49867L7.69141 4.83775L7.69394 4.8363C7.72844 4.8166 7.7631 4.79712 7.79791 4.77788L7.80068 4.77635L7.94225 3.95571C7.97723 3.7525 8.02011 3.50334 8.07542 3.2843C8.14077 3.0255 8.25461 2.67075 8.49926 2.31147C8.80849 1.85736 9.23648 1.49689 9.73655 1.26937C10.1322 1.08936 10.5011 1.03749 10.7673 1.01709ZM14.0938 4.3363C14.011 3.85634 13.9696 3.61637 13.8476 3.43717C13.7445 3.2858 13.6019 3.16564 13.4352 3.0898C13.2378 3.00002 12.9943 3.00002 12.5073 3.00002H11.4927C11.0057 3.00002 10.7621 3.00002 10.5648 3.0898C10.3981 3.16564 10.2555 3.2858 10.1524 3.43717C10.0304 3.61637 9.98895 3.85634 9.90615 4.3363L9.75012 5.24064C9.69445 5.56333 9.66662 5.72467 9.60765 5.84869C9.54975 5.97047 9.50241 6.03703 9.40636 6.13166C9.30853 6.22804 9.12753 6.3281 8.76554 6.52822C8.73884 6.54298 8.71227 6.55791 8.68582 6.57302C8.33956 6.77078 8.16643 6.86966 8.03785 6.90314C7.91158 6.93602 7.83293 6.94279 7.70289 6.93196C7.57049 6.92094 7.42216 6.86726 7.12551 6.7599L6.11194 6.39308C5.66271 6.2305 5.43809 6.14921 5.22515 6.16488C5.04524 6.17811 4.87225 6.23978 4.72453 6.34333C4.5497 6.46589 4.42715 6.67094 4.18206 7.08103L3.72269 7.84965C3.46394 8.2826 3.33456 8.49907 3.31227 8.72078C3.29345 8.90796 3.32781 9.09665 3.41141 9.26519C3.51042 9.4648 3.7078 9.62177 4.10256 9.9357L4.82745 10.5122C5.07927 10.7124 5.20518 10.8126 5.28411 10.9199C5.36944 11.036 5.40583 11.1114 5.44354 11.2504C5.47844 11.379 5.47844 11.586 5.47844 12C5.47844 12.414 5.47844 12.621 5.44354 12.7497C5.40582 12.8887 5.36944 12.9641 5.28413 13.0801C5.20518 13.1875 5.07927 13.2876 4.82743 13.4879L4.10261 14.0643C3.70785 14.3783 3.51047 14.5352 3.41145 14.7349C3.32785 14.9034 3.29349 15.0921 3.31231 15.2793C3.33461 15.501 3.46398 15.7174 3.72273 16.1504L4.1821 16.919C4.4272 17.3291 4.54974 17.5342 4.72457 17.6567C4.8723 17.7603 5.04528 17.8219 5.2252 17.8352C5.43813 17.8508 5.66275 17.7695 6.11199 17.607L7.12553 17.2402C7.42216 17.1328 7.5705 17.0791 7.7029 17.0681C7.83294 17.0573 7.91159 17.064 8.03786 17.0969C8.16644 17.1304 8.33956 17.2293 8.68582 17.427C8.71228 17.4421 8.73885 17.4571 8.76554 17.4718C9.12753 17.6719 9.30853 17.772 9.40635 17.8684C9.50241 17.963 9.54975 18.0296 9.60765 18.1514C9.66662 18.2754 9.69445 18.4367 9.75012 18.7594L9.90615 19.6637C9.98895 20.1437 10.0304 20.3837 10.1524 20.5629C10.2555 20.7142 10.3981 20.8344 10.5648 20.9102C10.7621 21 11.0057 21 11.4927 21H12.5073C12.9943 21 13.2378 21 13.4352 20.9102C13.6019 20.8344 13.7445 20.7142 13.8476 20.5629C13.9696 20.3837 14.011 20.1437 14.0938 19.6637L14.2499 18.7594C14.3055 18.4367 14.3334 18.2754 14.3923 18.1514C14.4502 18.0296 14.4976 17.963 14.5936 17.8684C14.6915 17.772 14.8725 17.6719 15.2344 17.4718C15.2611 17.4571 15.2877 17.4421 15.3141 17.427C15.6604 17.2293 15.8335 17.1304 15.9621 17.0969C16.0884 17.064 16.167 17.0573 16.2971 17.0681C16.4295 17.0791 16.5778 17.1328 16.8744 17.2402L17.888 17.607C18.3372 17.7696 18.5619 17.8509 18.7748 17.8352C18.9547 17.8219 19.1277 17.7603 19.2754 17.6567C19.4502 17.5342 19.5728 17.3291 19.8179 16.919L20.2773 16.1504C20.536 15.7175 20.6654 15.501 20.6877 15.2793C20.7065 15.0921 20.6721 14.9034 20.5885 14.7349C20.4895 14.5353 20.2921 14.3783 19.8974 14.0643L19.1726 13.4879C18.9207 13.2876 18.7948 13.1875 18.7159 13.0801C18.6306 12.9641 18.5942 12.8887 18.5564 12.7497C18.5215 12.6211 18.5215 12.414 18.5215 12C18.5215 11.586 18.5215 11.379 18.5564 11.2504C18.5942 11.1114 18.6306 11.036 18.7159 10.9199C18.7948 10.8126 18.9207 10.7124 19.1725 10.5122L19.8974 9.9357C20.2922 9.62176 20.4896 9.46479 20.5886 9.26517C20.6722 9.09664 20.7065 8.90795 20.6877 8.72076C20.6654 8.49906 20.5361 8.28259 20.2773 7.84964L19.8179 7.08102C19.5728 6.67093 19.4503 6.46588 19.2755 6.34332C19.1277 6.23977 18.9548 6.1781 18.7748 6.16486C18.5619 6.14919 18.3373 6.23048 17.888 6.39307L16.8745 6.75989C16.5778 6.86725 16.4295 6.92093 16.2971 6.93195C16.167 6.94278 16.0884 6.93601 15.9621 6.90313C15.8335 6.86965 15.6604 6.77077 15.3142 6.57302C15.2877 6.55791 15.2611 6.54298 15.2345 6.52822C14.8725 6.3281 14.6915 6.22804 14.5936 6.13166C14.4976 6.03703 14.4502 5.97047 14.3923 5.84869C14.3334 5.72467 14.3055 5.56332 14.2499 5.24064L14.0938 4.3363Z" fill="#0F1729"/>
+        return `<svg class="cv-modal-icon-svg" fill="currentColor" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg">
+  <path xmlns="http://www.w3.org/2000/svg" fill-rule="evenodd" clip-rule="evenodd" d="M12 8.00002C9.79085 8.00002 7.99999 9.79088 7.99999 12C7.99999 14.2092 9.79085 16 12 16C14.2091 16 16 14.2092 16 12C16 9.79088 14.2091 8.00002 12 8.00002ZM9.99999 12C9.99999 10.8955 10.8954 10 12 10C13.1046 10 14 10.8955 14 12C14 13.1046 13.1046 14 12 14C10.8954 14 9.99999 13.1046 9.99999 12Z" fill="#0F1729"/>
+  <path xmlns="http://www.w3.org/2000/svg" fill-rule="evenodd" clip-rule="evenodd" d="M10.7673 1.01709C10.9925 0.999829 11.2454 0.99993 11.4516 1.00001L12.5484 1.00001C12.7546 0.99993 13.0075 0.999829 13.2327 1.01709C13.4989 1.03749 13.8678 1.08936 14.2634 1.26937C14.7635 1.49689 15.1915 1.85736 15.5007 2.31147C15.7454 2.67075 15.8592 3.0255 15.9246 3.2843C15.9799 3.50334 16.0228 3.75249 16.0577 3.9557L16.1993 4.77635L16.2021 4.77788C16.2369 4.79712 16.2715 4.81659 16.306 4.8363L16.3086 4.83774L17.2455 4.49865C17.4356 4.42978 17.6693 4.34509 17.8835 4.28543C18.1371 4.2148 18.4954 4.13889 18.9216 4.17026C19.4614 4.20998 19.9803 4.39497 20.4235 4.70563C20.7734 4.95095 21.0029 5.23636 21.1546 5.4515C21.2829 5.63326 21.4103 5.84671 21.514 6.02029L22.0158 6.86003C22.1256 7.04345 22.2594 7.26713 22.3627 7.47527C22.4843 7.7203 22.6328 8.07474 22.6777 8.52067C22.7341 9.08222 22.6311 9.64831 22.3803 10.1539C22.1811 10.5554 21.9171 10.8347 21.7169 11.0212C21.5469 11.1795 21.3428 11.3417 21.1755 11.4746L20.5 12L21.1755 12.5254C21.3428 12.6584 21.5469 12.8205 21.7169 12.9789C21.9171 13.1653 22.1811 13.4446 22.3802 13.8461C22.631 14.3517 22.7341 14.9178 22.6776 15.4794C22.6328 15.9253 22.4842 16.2797 22.3626 16.5248C22.2593 16.7329 22.1255 16.9566 22.0158 17.14L21.5138 17.9799C21.4102 18.1535 21.2828 18.3668 21.1546 18.5485C21.0028 18.7637 20.7734 19.0491 20.4234 19.2944C19.9803 19.6051 19.4613 19.7901 18.9216 19.8298C18.4954 19.8612 18.1371 19.7852 17.8835 19.7146C17.6692 19.6549 17.4355 19.5703 17.2454 19.5014L16.3085 19.1623L16.306 19.1638C16.2715 19.1835 16.2369 19.2029 16.2021 19.2222L16.1993 19.2237L16.0577 20.0443C16.0228 20.2475 15.9799 20.4967 15.9246 20.7157C15.8592 20.9745 15.7454 21.3293 15.5007 21.6886C15.1915 22.1427 14.7635 22.5032 14.2634 22.7307C13.8678 22.9107 13.4989 22.9626 13.2327 22.983C13.0074 23.0002 12.7546 23.0001 12.5484 23H11.4516C11.2454 23.0001 10.9925 23.0002 10.7673 22.983C10.5011 22.9626 10.1322 22.9107 9.73655 22.7307C9.23648 22.5032 8.80849 22.1427 8.49926 21.6886C8.25461 21.3293 8.14077 20.9745 8.07542 20.7157C8.02011 20.4967 7.97723 20.2475 7.94225 20.0443L7.80068 19.2237L7.79791 19.2222C7.7631 19.2029 7.72845 19.1835 7.69396 19.1637L7.69142 19.1623L6.75458 19.5014C6.5645 19.5702 6.33078 19.6549 6.11651 19.7146C5.86288 19.7852 5.50463 19.8611 5.07841 19.8298C4.53866 19.7901 4.01971 19.6051 3.57654 19.2944C3.2266 19.0491 2.99714 18.7637 2.84539 18.5485C2.71718 18.3668 2.58974 18.1534 2.4861 17.9798L1.98418 17.14C1.87447 16.9566 1.74067 16.7329 1.63737 16.5248C1.51575 16.2797 1.36719 15.9253 1.32235 15.4794C1.26588 14.9178 1.36897 14.3517 1.61976 13.8461C1.81892 13.4446 2.08289 13.1653 2.28308 12.9789C2.45312 12.8205 2.65717 12.6584 2.82449 12.5254L3.47844 12.0054V11.9947L2.82445 11.4746C2.65712 11.3417 2.45308 11.1795 2.28304 11.0212C2.08285 10.8347 1.81888 10.5554 1.61972 10.1539C1.36893 9.64832 1.26584 9.08224 1.3223 8.52069C1.36714 8.07476 1.51571 7.72032 1.63732 7.47528C1.74062 7.26715 1.87443 7.04347 1.98414 6.86005L2.48605 6.02026C2.58969 5.84669 2.71714 5.63326 2.84534 5.45151C2.9971 5.23637 3.22655 4.95096 3.5765 4.70565C4.01966 4.39498 4.53862 4.20999 5.07837 4.17027C5.50458 4.1389 5.86284 4.21481 6.11646 4.28544C6.33072 4.34511 6.56444 4.4298 6.75451 4.49867L7.69141 4.83775L7.69394 4.8363C7.72844 4.8166 7.7631 4.79712 7.79791 4.77788L7.80068 4.77635L7.94225 3.95571C7.97723 3.7525 8.02011 3.50334 8.07542 3.2843C8.14077 3.0255 8.25461 2.67075 8.49926 2.31147C8.80849 1.85736 9.23648 1.49689 9.73655 1.26937C10.1322 1.08936 10.5011 1.03749 10.7673 1.01709ZM14.0938 4.3363C14.011 3.85634 13.9696 3.61637 13.8476 3.43717C13.7445 3.2858 13.6019 3.16564 13.4352 3.0898C13.2378 3.00002 12.9943 3.00002 12.5073 3.00002H11.4927C11.0057 3.00002 10.7621 3.00002 10.5648 3.0898C10.3981 3.16564 10.2555 3.2858 10.1524 3.43717C10.0304 3.61637 9.98895 3.85634 9.90615 4.3363L9.75012 5.24064C9.69445 5.56333 9.66662 5.72467 9.60765 5.84869C9.54975 5.97047 9.50241 6.03703 9.40636 6.13166C9.30853 6.22804 9.12753 6.3281 8.76554 6.52822C8.73884 6.54298 8.71227 6.55791 8.68582 6.57302C8.33956 6.77078 8.16643 6.86966 8.03785 6.90314C7.91158 6.93602 7.83293 6.94279 7.70289 6.93196C7.57049 6.92094 7.42216 6.86726 7.12551 6.7599L6.11194 6.39308C5.66271 6.2305 5.43809 6.14921 5.22515 6.16488C5.04524 6.17811 4.87225 6.23978 4.72453 6.34333C4.5497 6.46589 4.42715 6.67094 4.18206 7.08103L3.72269 7.84965C3.46394 8.2826 3.33456 8.49907 3.31227 8.72078C3.29345 8.90796 3.32781 9.09665 3.41141 9.26519C3.51042 9.4648 3.7078 9.62177 4.10256 9.9357L4.82745 10.5122C5.07927 10.7124 5.20518 10.8126 5.28411 10.9199C5.36944 11.036 5.40583 11.1114 5.44354 11.2504C5.47844 11.379 5.47844 11.586 5.47844 12C5.47844 12.414 5.47844 12.621 5.44354 12.7497C5.40582 12.8887 5.36944 12.9641 5.28413 13.0801C5.20518 13.1875 5.07927 13.2876 4.82743 13.4879L4.10261 14.0643C3.70785 14.3783 3.51047 14.5352 3.41145 14.7349C3.32785 14.9034 3.29349 15.0921 3.31231 15.2793C3.33461 15.501 3.46398 15.7174 3.72273 16.1504L4.1821 16.919C4.4272 17.3291 4.54974 17.5342 4.72457 17.6567C4.8723 17.7603 5.04528 17.8219 5.2252 17.8352C5.43813 17.8508 5.66275 17.7695 6.11199 17.607L7.12553 17.2402C7.42216 17.1328 7.5705 17.0791 7.7029 17.0681C7.83294 17.0573 7.91159 17.064 8.03786 17.0969C8.16644 17.1304 8.33956 17.2293 8.68582 17.427C8.71228 17.4421 8.73885 17.4571 8.76554 17.4718C9.12753 17.6719 9.30853 17.772 9.40635 17.8684C9.50241 17.963 9.54975 18.0296 9.60765 18.1514C9.66662 18.2754 9.69445 18.4367 9.75012 18.7594L9.90615 19.6637C9.98895 20.1437 10.0304 20.3837 10.1524 20.5629C10.2555 20.7142 10.3981 20.8344 10.5648 20.9102C10.7621 21 11.0057 21 11.4927 21H12.5073C12.9943 21 13.2378 21 13.4352 20.9102C13.6019 20.8344 13.7445 20.7142 13.8476 20.5629C13.9696 20.3837 14.011 20.1437 14.0938 19.6637L14.2499 18.7594C14.3055 18.4367 14.3334 18.2754 14.3923 18.1514C14.4502 18.0296 14.4976 17.963 14.5936 17.8684C14.6915 17.772 14.8725 17.6719 15.2344 17.4718C15.2611 17.4571 15.2877 17.4421 15.3141 17.427C15.6604 17.2293 15.8335 17.1304 15.9621 17.0969C16.0884 17.064 16.167 17.0573 16.2971 17.0681C16.4295 17.0791 16.5778 17.1328 16.8744 17.2402L17.888 17.607C18.3372 17.7696 18.5619 17.8509 18.7748 17.8352C18.9547 17.8219 19.1277 17.7603 19.2754 17.6567C19.4502 17.5342 19.5728 17.3291 19.8179 16.919L20.2773 16.1504C20.536 15.7175 20.6654 15.501 20.6877 15.2793C20.7065 15.0921 20.6721 14.9034 20.5885 14.7349C20.4895 14.5353 20.2921 14.3783 19.8974 14.0643L19.1726 13.4879C18.9207 13.2876 18.7948 13.1875 18.7159 13.0801C18.6306 12.9641 18.5942 12.8887 18.5564 12.7497C18.5215 12.6211 18.5215 12.414 18.5215 12C18.5215 11.586 18.5215 11.379 18.5564 11.2504C18.5942 11.1114 18.6306 11.036 18.7159 10.9199C18.7948 10.8126 18.9207 10.7124 19.1725 10.5122L19.8974 9.9357C20.2922 9.62176 20.4896 9.46479 20.5886 9.26517C20.6722 9.09664 20.7065 8.90795 20.6877 8.72076C20.6654 8.49906 20.5361 8.28259 20.2773 7.84964L19.8179 7.08102C19.5728 6.67093 19.4503 6.46588 19.2755 6.34332C19.1277 6.23977 18.9548 6.1781 18.7748 6.16486C18.5619 6.14919 18.3373 6.23048 17.888 6.39307L16.8745 6.75989C16.5778 6.86725 16.4295 6.92093 16.2971 6.93195C16.167 6.94278 16.0884 6.93601 15.9621 6.90313C15.8335 6.86965 15.6604 6.77077 15.3142 6.57302C15.2877 6.55791 15.2611 6.54298 15.2345 6.52822C14.8725 6.3281 14.6915 6.22804 14.5936 6.13166C14.4976 6.03703 14.4502 5.97047 14.3923 5.84869C14.3334 5.72467 14.3055 5.56332 14.2499 5.24064L14.0938 4.3363Z" fill="#0F1729"/>
 </svg>`;
     }
     /**
      * Close/X icon for modal close button
      */
     function getCloseIcon() {
-        return `<svg class="cv-modal-close-icon" fill="currentColor" height="20px" viewBox="0 0 256 256" width="20px" xmlns="http://www.w3.org/2000/svg">
-    <path d="M205.66,194.34a8,8,0,0,1-11.32,11.32L128,139.31,61.66,205.66a8,8,0,0,1-11.32-11.32L116.69,128,50.34,61.66A8,8,0,0,1,61.66,50.34L128,116.69l66.34-66.35a8,8,0,0,1,11.32,11.32L139.31,128Z"></path>
+        return `<svg class="cv-modal-close-icon" fill="currentColor" height="20px" viewBox="0 0 256 256" width="20px" xmlns="http://www.w3.org/2000/svg">
+    <path d="M205.66,194.34a8,8,0,0,1-11.32,11.32L128,139.31,61.66,205.66a8,8,0,0,1-11.32-11.32L116.69,128,50.34,61.66A8,8,0,0,1,61.66,50.34L128,116.69l66.34-66.35a8,8,0,0,1,11.32,11.32L139.31,128Z"></path>
   </svg>`;
     }
     /**
      * Reset/refresh icon for reset button
      */
     function getResetIcon() {
-        return `<svg class="cv-btn-icon" fill="currentColor" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg">
-    <path d="M22.719 12A10.719 10.719 0 0 1 1.28 12h.838a9.916 9.916 0 1 0 1.373-5H8v1H2V2h1v4.2A10.71 10.71 0 0 1 22.719 12z"/><path fill="none" d="M0 0h24v24H0z"/>
+        return `<svg class="cv-btn-icon" fill="currentColor" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg">
+    <path d="M22.719 12A10.719 10.719 0 0 1 1.28 12h.838a9.916 9.916 0 1 0 1.373-5H8v1H2V2h1v4.2A10.71 10.71 0 0 1 22.719 12z"/><path fill="none" d="M0 0h24v24H0z"/>
   </svg>`;
     }
     /**
      * Share icon for share button
      */
     function getShareIcon() {
-        return `<svg class="cv-btn-icon" fill="currentColor" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg">
-  <path xmlns="http://www.w3.org/2000/svg" d="M6 11C6 8.17157 6 6.75736 6.87868 5.87868C7.75736 5 9.17157 5 12 5H15C17.8284 5 19.2426 5 20.1213 5.87868C21 6.75736 21 8.17157 21 11V16C21 18.8284 21 20.2426 20.1213 21.1213C19.2426 22 17.8284 22 15 22H12C9.17157 22 7.75736 22 6.87868 21.1213C6 20.2426 6 18.8284 6 16V11Z" stroke="#1C274C" stroke-width="1.5"/>
-  <path xmlns="http://www.w3.org/2000/svg" opacity="0.5" d="M6 19C4.34315 19 3 17.6569 3 16V10C3 6.22876 3 4.34315 4.17157 3.17157C5.34315 2 7.22876 2 11 2H15C16.6569 2 18 3.34315 18 5" stroke="#1C274C" stroke-width="1.5"/>
+        return `<svg class="cv-btn-icon" fill="currentColor" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg">
+  <path xmlns="http://www.w3.org/2000/svg" d="M6 11C6 8.17157 6 6.75736 6.87868 5.87868C7.75736 5 9.17157 5 12 5H15C17.8284 5 19.2426 5 20.1213 5.87868C21 6.75736 21 8.17157 21 11V16C21 18.8284 21 20.2426 20.1213 21.1213C19.2426 22 17.8284 22 15 22H12C9.17157 22 7.75736 22 6.87868 21.1213C6 20.2426 6 18.8284 6 16V11Z" stroke="#1C274C" stroke-width="1.5"/>
+  <path xmlns="http://www.w3.org/2000/svg" opacity="0.5" d="M6 19C4.34315 19 3 17.6569 3 16V10C3 6.22876 3 4.34315 4.17157 3.17157C5.34315 2 7.22876 2 11 2H15C16.6569 2 18 3.34315 18 5" stroke="#1C274C" stroke-width="1.5"/>
 </svg>`;
     }
 
@@ -2547,123 +2565,101 @@ ${TAB_STYLES}
             this.modal = document.createElement('div');
             this.modal.className = 'cv-widget-modal-overlay';
             this.applyThemeToModal();
-            const toggleControlsHtml = toggles.map(toggle => `
-      <div class="cv-toggle-card">
-        <div class="cv-toggle-content">
-          <div>
-            <p class="cv-toggle-title">${this.formatToggleName(toggle)}</p>
-          </div>
-          <label class="cv-toggle-label">
-            <input class="cv-toggle-input" type="checkbox" data-toggle="${toggle}"/>
-            <span class="cv-toggle-slider"></span>
-          </label>
-        </div>
-      </div>
+            const toggleControlsHtml = toggles.map(toggle => `
+      <div class="cv-toggle-card">
+        <div class="cv-toggle-content">
+          <div>
+            <p class="cv-toggle-title">${this.formatToggleName(toggle)}</p>
+          </div>
+          <label class="cv-toggle-label">
+            <input class="cv-toggle-input" type="checkbox" data-toggle="${toggle}"/>
+            <span class="cv-toggle-slider"></span>
+          </label>
+        </div>
+      </div>
     `).join('');
             // Todo: Re-add description if needed (Line 168, add label field to toggles if needed change structure)
             // <p class="cv-toggle-description">Show or hide the ${this.formatToggleName(toggle).toLowerCase()} area </p>
             // Get tab groups
             const tabGroups = this.core.getTabGroups();
             let tabGroupControlsHTML = '';
-            // Check if any tab group or tab labels contain Font Awesome shortcodes
-            let hasFontAwesomeShortcodes = false;
             if (this.options.showTabGroups && tabGroups && tabGroups.length > 0) {
-                for (const group of tabGroups) {
-                    if (group.label && /:fa-[\w-]+:/.test(group.label)) {
-                        hasFontAwesomeShortcodes = true;
-                        break;
-                    }
-                    for (const tab of group.tabs) {
-                        if (tab.label && /:fa-[\w-]+:/.test(tab.label)) {
-                            hasFontAwesomeShortcodes = true;
-                            break;
-                        }
-                    }
-                    if (hasFontAwesomeShortcodes)
-                        break;
-                }
-            }
-            // Inject Font Awesome only if shortcodes are found
-            if (hasFontAwesomeShortcodes) {
-                ensureFontAwesomeInjected();
-            }
-            if (this.options.showTabGroups && tabGroups && tabGroups.length > 0) {
-                tabGroupControlsHTML = `
-        <div class="cv-tabgroup-card cv-tabgroup-header">
-          <div class="cv-tabgroup-row">
-            <div class="cv-tabgroup-info">
-              <p class="cv-tabgroup-title">Navigation Headers</p>
-              <p class="cv-tabgroup-description">Show or hide navigation headers</p>
-            </div>
-            <label class="cv-toggle-switch cv-nav-toggle">
-              <input class="cv-nav-pref-input" type="checkbox" aria-label="Show or hide navigation headers" />
-              <span class="cv-switch-bg"></span>
-              <span class="cv-switch-knob"></span>
-            </label>
-          </div>
-        </div>
-        <div class="cv-tab-groups-list">
-          ${tabGroups.map(group => `
-            <div class="cv-tabgroup-card cv-tabgroup-item">
-              <label class="cv-tabgroup-label" for="tab-group-${group.id}">
-                ${replaceIconShortcodes(group.label || group.id)}
-              </label>
-              <select id="tab-group-${group.id}" class="cv-tabgroup-select" data-group-id="${group.id}">
-                ${group.tabs.map(tab => `<option value="${tab.id}">${replaceIconShortcodes(tab.label || tab.id)}</option>`).join('')}
-              </select>
-            </div>
-          `).join('')}
-        </div>
+                tabGroupControlsHTML = `
+        <div class="cv-tabgroup-card cv-tabgroup-header">
+          <div class="cv-tabgroup-row">
+            <div class="cv-tabgroup-info">
+              <p class="cv-tabgroup-title">Navigation Headers</p>
+              <p class="cv-tabgroup-description">Show or hide navigation headers</p>
+            </div>
+            <label class="cv-toggle-switch cv-nav-toggle">
+              <input class="cv-nav-pref-input" type="checkbox" aria-label="Show or hide navigation headers" />
+              <span class="cv-switch-bg"></span>
+              <span class="cv-switch-knob"></span>
+            </label>
+          </div>
+        </div>
+        <div class="cv-tab-groups-list">
+          ${tabGroups.map(group => `
+            <div class="cv-tabgroup-card cv-tabgroup-item">
+              <label class="cv-tabgroup-label" for="tab-group-${group.id}">
+                ${group.label || group.id}
+              </label>
+              <select id="tab-group-${group.id}" class="cv-tabgroup-select" data-group-id="${group.id}">
+                ${group.tabs.map(tab => `<option value="${tab.id}">${tab.label || tab.id}</option>`).join('')}
+              </select>
+            </div>
+          `).join('')}
+        </div>
       `;
             }
-            this.modal.innerHTML = `
-      <div class="cv-widget-modal cv-custom-state-modal">
-        <header class="cv-modal-header">
-          <div class="cv-modal-header-content">
-            <div class="cv-modal-icon">
-              ${getGearIcon()}
-            </div>
-            <div class="cv-modal-title">${this.options.title}</div>
-          </div>
-          <button class="cv-modal-close" aria-label="Close modal">
-            ${getCloseIcon()}
-          </button>
-        </header>
-        <main class="cv-modal-main">
-          ${this.options.description ? `<p class="cv-modal-description">${this.options.description}</p>` : ''}
-          
-          ${toggles.length ? `
-          <div class="cv-content-section">
-            <div class="cv-section-heading">Toggles</div>
-            <div class="cv-toggles-container">
-              ${toggleControlsHtml}
-            </div>
-          </div>
-          ` : ''}
-          
-          ${this.options.showTabGroups && tabGroups && tabGroups.length > 0 ? `
-          <div class="cv-content-section">
-            <div class="cv-section-heading">Tab Groups</div>
-            <div class="cv-tabgroups-container">
-              ${tabGroupControlsHTML}
-            </div>
-          </div>
-          ` : ''}
-        </main>
-
-        <footer class="cv-modal-footer">
-          ${this.options.showReset ? `
-          <button class="cv-reset-btn">
-            ${getResetIcon()}
-            <span>Reset to Default</span>
-          </button>
-          ` : ''}
-          <button class="cv-share-btn">
-            ${getShareIcon()}
-            <span>Copy Shareable URL</span>
-          </button>
-        </footer>
-      </div>
+            this.modal.innerHTML = `
+      <div class="cv-widget-modal cv-custom-state-modal">
+        <header class="cv-modal-header">
+          <div class="cv-modal-header-content">
+            <div class="cv-modal-icon">
+              ${getGearIcon()}
+            </div>
+            <div class="cv-modal-title">${this.options.title}</div>
+          </div>
+          <button class="cv-modal-close" aria-label="Close modal">
+            ${getCloseIcon()}
+          </button>
+        </header>
+        <main class="cv-modal-main">
+          ${this.options.description ? `<p class="cv-modal-description">${this.options.description}</p>` : ''}
+          
+          ${toggles.length ? `
+          <div class="cv-content-section">
+            <div class="cv-section-heading">Toggles</div>
+            <div class="cv-toggles-container">
+              ${toggleControlsHtml}
+            </div>
+          </div>
+          ` : ''}
+          
+          ${this.options.showTabGroups && tabGroups && tabGroups.length > 0 ? `
+          <div class="cv-content-section">
+            <div class="cv-section-heading">Tab Groups</div>
+            <div class="cv-tabgroups-container">
+              ${tabGroupControlsHTML}
+            </div>
+          </div>
+          ` : ''}
+        </main>
+
+        <footer class="cv-modal-footer">
+          ${this.options.showReset ? `
+          <button class="cv-reset-btn">
+            ${getResetIcon()}
+            <span>Reset to Default</span>
+          </button>
+          ` : ''}
+          <button class="cv-share-btn">
+            ${getShareIcon()}
+            <span>Copy Shareable URL</span>
+          </button>
+        </footer>
+      </div>
     `;
             document.body.appendChild(this.modal);
             this.attachStateModalEventListeners();
@@ -2839,7 +2835,7 @@ ${TAB_STYLES}
             });
             // Load tab group selections
             const activeTabs = this.core.getCurrentActiveTabs();
-            const tabGroupSelects = this.modal.querySelectorAll('.cv-tab-groupselect');
+            const tabGroupSelects = this.modal.querySelectorAll('.cv-tabgroup-select');
             tabGroupSelects.forEach(select => {
                 const groupId = select.dataset.groupId;
                 if (groupId && activeTabs[groupId]) {
@@ -2897,29 +2893,29 @@ ${TAB_STYLES}
             this.modal = document.createElement('div');
             this.modal.className = 'cv-widget-modal-overlay cv-welcome-modal-overlay';
             this.applyThemeToModal();
-            this.modal.innerHTML = `
-      <div class="cv-widget-modal cv-welcome-modal">
-        <header class="cv-modal-header">
-          <div class="cv-modal-header-content">
-            <div class="cv-modal-icon">
-              ${getGearIcon()}
-            </div>
-            <h1 class="cv-modal-title">${this.options.welcomeTitle}</h1>
-          </div>
-        </header>
-        <div class="cv-modal-main">
-          <p class="cv-welcome-message">${this.options.welcomeMessage}</p>
-          
-          <div class="cv-welcome-widget-preview">
-            <div class="cv-welcome-widget-icon">
-              ${getGearIcon()}
-            </div>
-            <p class="cv-welcome-widget-label">Look for this widget</p>
-          </div>
-          
-          <button class="cv-welcome-got-it">Got it!</button>
-        </div>
-      </div>
+            this.modal.innerHTML = `
+      <div class="cv-widget-modal cv-welcome-modal">
+        <header class="cv-modal-header">
+          <div class="cv-modal-header-content">
+            <div class="cv-modal-icon">
+              ${getGearIcon()}
+            </div>
+            <h1 class="cv-modal-title">${this.options.welcomeTitle}</h1>
+          </div>
+        </header>
+        <div class="cv-modal-main">
+          <p class="cv-welcome-message">${this.options.welcomeMessage}</p>
+          
+          <div class="cv-welcome-widget-preview">
+            <div class="cv-welcome-widget-icon">
+              ${getGearIcon()}
+            </div>
+            <p class="cv-welcome-widget-label">Look for this widget</p>
+          </div>
+          
+          <button class="cv-welcome-got-it">Got it!</button>
+        </div>
+      </div>
     `;
             document.body.appendChild(this.modal);
             this.attachWelcomeModalEventListeners();
@@ -2987,22 +2983,13 @@ ${TAB_STYLES}
                 let scriptTag = document.currentScript;
                 // Fallback if currentScript is not available (executed after page load)
                 if (!scriptTag) {
-                    // Try to find the script tag by looking for our script
-                    const scripts = document.querySelectorAll('script[src*="@customviews-js"]');
-                    if (scripts.length > 0) {
-                        // Find the most specific match (to avoid matching other custom-views scripts)
-                        for (let i = 0; i < scripts.length; i++) {
-                            const script = scripts[i];
-                            const src = script.getAttribute('src') || '';
-                            // Look for .min.js or .js at the end, or the package root
-                            if (src.match(/@customviews-js\/customviews(\.min)?\.js($|\?)/) || src.includes('@customviews-js/customviews')) {
-                                scriptTag = script;
-                                break;
-                            }
-                        }
-                        // If no specific match found, use the first one
-                        if (!scriptTag) {
-                            scriptTag = scripts[0];
+                    // Match the actual CustomViews bundle files (e.g., custom-views.min.js, custom-views.js)
+                    for (const script of document.scripts) {
+                        const src = script.src || '';
+                        // Match filenames like: custom-views.min.js, custom-views.js, custom-views.esm.js
+                        if (/custom-views(?:\.min)?\.(?:esm\.)?js($|\?)/i.test(src)) {
+                            scriptTag = script;
+                            break;
                         }
                     }
                 }