@lgtm-hq/turbo-themes 0.12.16

package/packages/theme-selector/dist/dropdown/ui.js

@@ -0,0 +1,179 @@
+// SPDX-License-Identifier: MIT
+/**
+ * Dropdown UI element creation
+ */
+import { setItemActiveState } from './helpers.js';
+import { DOM_IDS, DOM_SELECTORS } from '../constants.js';
+/**
+ * Creates a checkmark SVG icon for the active theme indicator.
+ */
+export function createCheckmarkIcon(doc) {
+    const svg = doc.createElementNS('http://www.w3.org/2000/svg', 'svg');
+    svg.setAttribute('width', '16');
+    svg.setAttribute('height', '16');
+    svg.setAttribute('viewBox', '0 0 24 24');
+    svg.setAttribute('fill', 'none');
+    svg.setAttribute('stroke', 'currentColor');
+    svg.setAttribute('stroke-width', '3');
+    svg.setAttribute('stroke-linecap', 'round');
+    svg.setAttribute('stroke-linejoin', 'round');
+    const polyline = doc.createElementNS('http://www.w3.org/2000/svg', 'polyline');
+    polyline.setAttribute('points', '20 6 9 17 4 12');
+    svg.appendChild(polyline);
+    return svg;
+}
+/**
+ * Creates a single theme item button element.
+ */
+export function createThemeItemElement(ctx, theme, familyMeta) {
+    const { documentObj, baseUrl, currentThemeId, selectEl, windowObj, closeDropdown, onThemeSelect } = ctx;
+    const item = documentObj.createElement('button');
+    item.type = 'button';
+    item.className = 'dropdown-item theme-item';
+    item.setAttribute('data-theme-id', theme.id);
+    item.setAttribute('data-appearance', theme.appearance);
+    item.setAttribute('role', 'menuitemradio');
+    item.setAttribute('aria-label', `${familyMeta.name} ${theme.name} (${theme.appearance}). ${theme.description}`);
+    item.setAttribute('tabindex', '-1');
+    const isActive = theme.id === currentThemeId;
+    setItemActiveState(item, isActive);
+    // Icon (only render if theme has an icon)
+    if (theme.icon) {
+        const icon = documentObj.createElement('img');
+        icon.className = 'theme-icon';
+        icon.src = baseUrl ? `${baseUrl}/${theme.icon}` : theme.icon;
+        icon.alt = `${familyMeta.name} ${theme.name}`;
+        icon.width = 24;
+        icon.height = 24;
+        item.appendChild(icon);
+    }
+    else {
+        // Add placeholder for consistent spacing
+        const placeholder = documentObj.createElement('span');
+        placeholder.className = 'theme-icon theme-icon-placeholder';
+        placeholder.setAttribute('aria-hidden', 'true');
+        item.appendChild(placeholder);
+    }
+    // Text content
+    const copy = documentObj.createElement('div');
+    copy.className = 'theme-copy';
+    const titleEl = documentObj.createElement('span');
+    titleEl.className = 'theme-title';
+    titleEl.textContent = `${familyMeta.name} · ${theme.name}`;
+    copy.appendChild(titleEl);
+    const descriptionEl = documentObj.createElement('span');
+    descriptionEl.className = 'theme-description';
+    descriptionEl.textContent = theme.description;
+    copy.appendChild(descriptionEl);
+    item.appendChild(copy);
+    // Checkmark for active state
+    const check = documentObj.createElement('span');
+    check.className = 'theme-check';
+    check.appendChild(createCheckmarkIcon(documentObj));
+    item.appendChild(check);
+    // Click handler
+    item.addEventListener('click', (e) => {
+        e.preventDefault();
+        onThemeSelect(theme.id);
+        if (selectEl) {
+            selectEl.value = theme.id;
+            selectEl.dispatchEvent(new Event('change', { bubbles: true }));
+        }
+        closeDropdown({ restoreFocus: true });
+    });
+    return item;
+}
+/**
+ * Creates a family group container with header and theme items.
+ */
+export function createFamilyGroup(ctx, familyKey, themes, familyMeta, animationDelay) {
+    const { documentObj } = ctx;
+    if (themes.length === 0)
+        return null;
+    const items = [];
+    // Create family group container
+    const group = documentObj.createElement('div');
+    group.className = 'theme-family-group';
+    group.setAttribute('role', 'group');
+    group.setAttribute('aria-labelledby', `theme-family-${familyKey}`);
+    if (group.style && typeof group.style.setProperty === 'function') {
+        group.style.setProperty('--animation-delay', `${animationDelay}ms`);
+    }
+    // Create family header
+    const header = documentObj.createElement('div');
+    header.className = 'theme-family-header';
+    header.id = `theme-family-${familyKey}`;
+    const headerTitle = documentObj.createElement('span');
+    headerTitle.className = 'theme-family-name';
+    headerTitle.textContent = familyMeta.name;
+    header.appendChild(headerTitle);
+    group.appendChild(header);
+    // Create themes container
+    const themesContainer = documentObj.createElement('div');
+    themesContainer.className = 'theme-family-items';
+    themes.forEach((theme) => {
+        const item = createThemeItemElement(ctx, theme, familyMeta);
+        items.push(item);
+        themesContainer.appendChild(item);
+    });
+    group.appendChild(themesContainer);
+    return { group, items };
+}
+/**
+ * Populates the dropdown menu with all theme family groups.
+ */
+export function populateDropdownMenu(ctx, dropdownMenu, themes, themeFamilies) {
+    const families = Object.keys(themeFamilies);
+    let animationDelay = 0;
+    families.forEach((familyKey) => {
+        const familyThemes = themes.filter((t) => t.family === familyKey);
+        const familyMeta = themeFamilies[familyKey];
+        if (!familyMeta)
+            return;
+        const result = createFamilyGroup(ctx, familyKey, familyThemes, familyMeta, animationDelay);
+        if (result) {
+            ctx.menuItems.push(...result.items);
+            dropdownMenu.appendChild(result.group);
+            animationDelay += 30;
+        }
+    });
+}
+/**
+ * Wires up the native select element for theme selection.
+ */
+export function wireNativeSelect(ctx, selectEl, themes, defaultTheme) {
+    const { documentObj, windowObj, onThemeSelect } = ctx;
+    // Clear existing options
+    while (selectEl.firstChild) {
+        selectEl.removeChild(selectEl.firstChild);
+    }
+    // Populate options
+    themes.forEach((theme) => {
+        const option = documentObj.createElement('option');
+        option.value = theme.id;
+        option.textContent = theme.name;
+        option.selected = theme.id === ctx.currentThemeId;
+        selectEl.appendChild(option);
+    });
+    selectEl.disabled = false;
+    // Change handler
+    selectEl.addEventListener('change', (event) => {
+        const target = event.target;
+        const selectedThemeId = target?.value || defaultTheme;
+        onThemeSelect(selectedThemeId);
+    });
+}
+/**
+ * Gets DOM elements required for the dropdown, returning null if any are missing.
+ */
+export function getDropdownElements(documentObj) {
+    const dropdownMenu = documentObj.getElementById(DOM_IDS.THEME_FLAVOR_MENU);
+    const trigger = documentObj.getElementById(DOM_IDS.THEME_FLAVOR_TRIGGER);
+    const dropdown = trigger?.closest(DOM_SELECTORS.NAVBAR_DROPDOWN);
+    const selectEl = documentObj.getElementById(DOM_IDS.THEME_FLAVOR_SELECT);
+    if (!dropdownMenu || !trigger || !dropdown) {
+        return null;
+    }
+    return { dropdownMenu, trigger, dropdown, selectEl };
+}
+//# sourceMappingURL=ui.js.map

package/packages/theme-selector/dist/dropdown/ui.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui.js","sourceRoot":"","sources":["../../src/dropdown/ui.ts"],"names":[],"mappings":"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"}

package/packages/theme-selector/dist/errors.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Centralized error handling for Turbo Themes.
+ *
+ * Provides a consistent error logging strategy with standardized message
+ * formatting, error levels, and optional context for debugging.
+ */
+/** Log prefix for all theme-related messages */
+export declare const LOG_PREFIX = "[turbo-themes]";
+/** Error severity levels */
+export declare enum ErrorLevel {
+    WARN = "warn",
+    ERROR = "error"
+}
+/** Structured theme error with code, message, level, and optional context */
+export interface ThemeError {
+    code: string;
+    message: string;
+    level: ErrorLevel;
+    context?: Record<string, unknown>;
+}
+/**
+ * Factory functions for creating structured theme errors.
+ * Each function returns a ThemeError with appropriate code, message, and level.
+ */
+export declare const ThemeErrors: {
+    /** Invalid theme ID provided */
+    INVALID_THEME_ID: (themeId: string) => ThemeError;
+    /** No themes available in registry */
+    NO_THEMES_AVAILABLE: () => ThemeError;
+    /** Invalid theme icon path */
+    INVALID_ICON_PATH: (themeId: string) => ThemeError;
+    /** Theme initialization failed */
+    INIT_FAILED: (error: unknown) => ThemeError;
+    /** Protocol-relative URL rejected for security */
+    PROTOCOL_REJECTED: () => ThemeError;
+    /** Insecure HTTP URL rejected */
+    INSECURE_HTTP_REJECTED: () => ThemeError;
+    /** Cross-origin URL rejected */
+    CROSS_ORIGIN_REJECTED: (origin: string) => ThemeError;
+    /** Invalid CSS path for theme */
+    INVALID_CSS_PATH: (themeId: string) => ThemeError;
+    /** CSS failed to load */
+    CSS_LOAD_FAILED: (themeId: string, error: unknown) => ThemeError;
+    /** Storage unavailable (private browsing or disabled) */
+    STORAGE_UNAVAILABLE: (operation: string, error: unknown) => ThemeError;
+};
+/**
+ * Log a theme error to the console with consistent formatting.
+ *
+ * @param themeError - The structured error to log
+ */
+export declare function logThemeError(themeError: ThemeError): void;
+/**
+ * Convenience function to log a ThemeError.
+ *
+ * @param error - The ThemeError instance to log
+ */
+export declare function logError<T extends ThemeError>(error: T): void;
+//# sourceMappingURL=errors.d.ts.map

package/packages/theme-selector/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AACA;;;;;GAKG;AAEH,gDAAgD;AAChD,eAAO,MAAM,UAAU,mBAAmB,CAAC;AAE3C,4BAA4B;AAC5B,oBAAY,UAAU;IACpB,IAAI,SAAS;IACb,KAAK,UAAU;CAChB;AAED,6EAA6E;AAC7E,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,UAAU,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED;;;GAGG;AACH,eAAO,MAAM,WAAW;IACtB,gCAAgC;gCACJ,MAAM,KAAG,UAAU;IAO/C,sCAAsC;+BACb,UAAU;IAMnC,8BAA8B;iCACD,MAAM,KAAG,UAAU;IAOhD,kCAAkC;yBACb,OAAO,KAAG,UAAU;IAOzC,kDAAkD;6BAC3B,UAAU;IAMjC,iCAAiC;kCACL,UAAU;IAMtC,gCAAgC;oCACA,MAAM,KAAG,UAAU;IAOnD,iCAAiC;gCACL,MAAM,KAAG,UAAU;IAO/C,yBAAyB;+BACE,MAAM,SAAS,OAAO,KAAG,UAAU;IAU9D,yDAAyD;qCACxB,MAAM,SAAS,OAAO,KAAG,UAAU;CASrE,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI,CAgB1D;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,UAAU,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,CAE7D"}

package/packages/theme-selector/dist/errors.js

@@ -0,0 +1,127 @@
+// SPDX-License-Identifier: MIT
+/**
+ * Centralized error handling for Turbo Themes.
+ *
+ * Provides a consistent error logging strategy with standardized message
+ * formatting, error levels, and optional context for debugging.
+ */
+/** Log prefix for all theme-related messages */
+export const LOG_PREFIX = '[turbo-themes]';
+/** Error severity levels */
+export var ErrorLevel;
+(function (ErrorLevel) {
+    ErrorLevel["WARN"] = "warn";
+    ErrorLevel["ERROR"] = "error";
+})(ErrorLevel || (ErrorLevel = {}));
+/**
+ * Factory functions for creating structured theme errors.
+ * Each function returns a ThemeError with appropriate code, message, and level.
+ */
+export const ThemeErrors = {
+    /** Invalid theme ID provided */
+    INVALID_THEME_ID: (themeId) => ({
+        code: 'INVALID_THEME_ID',
+        message: `Invalid theme ID "${themeId}" not saved to storage`,
+        level: ErrorLevel.WARN,
+        context: { themeId },
+    }),
+    /** No themes available in registry */
+    NO_THEMES_AVAILABLE: () => ({
+        code: 'NO_THEMES_AVAILABLE',
+        message: 'No themes available',
+        level: ErrorLevel.ERROR,
+    }),
+    /** Invalid theme icon path */
+    INVALID_ICON_PATH: (themeId) => ({
+        code: 'INVALID_ICON_PATH',
+        message: `Invalid theme icon path for ${themeId}`,
+        level: ErrorLevel.WARN,
+        context: { themeId },
+    }),
+    /** Theme initialization failed */
+    INIT_FAILED: (error) => ({
+        code: 'INIT_FAILED',
+        message: 'Theme switcher initialization failed',
+        level: ErrorLevel.ERROR,
+        context: { error: error instanceof Error ? error.message : String(error) },
+    }),
+    /** Protocol-relative URL rejected for security */
+    PROTOCOL_REJECTED: () => ({
+        code: 'PROTOCOL_REJECTED',
+        message: 'Protocol-relative base URL rejected for security',
+        level: ErrorLevel.WARN,
+    }),
+    /** Insecure HTTP URL rejected */
+    INSECURE_HTTP_REJECTED: () => ({
+        code: 'INSECURE_HTTP_REJECTED',
+        message: 'Insecure HTTP base URL rejected',
+        level: ErrorLevel.WARN,
+    }),
+    /** Cross-origin URL rejected */
+    CROSS_ORIGIN_REJECTED: (origin) => ({
+        code: 'CROSS_ORIGIN_REJECTED',
+        message: `Cross-origin base URL rejected: ${origin}`,
+        level: ErrorLevel.WARN,
+        context: { origin },
+    }),
+    /** Invalid CSS path for theme */
+    INVALID_CSS_PATH: (themeId) => ({
+        code: 'INVALID_CSS_PATH',
+        message: `Invalid theme CSS path for ${themeId}`,
+        level: ErrorLevel.WARN,
+        context: { themeId },
+    }),
+    /** CSS failed to load */
+    CSS_LOAD_FAILED: (themeId, error) => ({
+        code: 'CSS_LOAD_FAILED',
+        message: `Theme CSS failed to load for ${themeId}`,
+        level: ErrorLevel.WARN,
+        context: {
+            themeId,
+            error: error instanceof Error ? error.message : String(error),
+        },
+    }),
+    /** Storage unavailable (private browsing or disabled) */
+    STORAGE_UNAVAILABLE: (operation, error) => ({
+        code: 'STORAGE_UNAVAILABLE',
+        message: `localStorage ${operation} failed - storage may be unavailable`,
+        level: ErrorLevel.WARN,
+        context: {
+            operation,
+            error: error instanceof Error ? error.message : String(error),
+        },
+    }),
+};
+/**
+ * Log a theme error to the console with consistent formatting.
+ *
+ * @param themeError - The structured error to log
+ */
+export function logThemeError(themeError) {
+    const prefixedMessage = `${LOG_PREFIX} ${themeError.message}`;
+    if (themeError.level === ErrorLevel.ERROR) {
+        if (themeError.context) {
+            console.error(prefixedMessage, themeError.context);
+        }
+        else {
+            console.error(prefixedMessage);
+        }
+    }
+    else {
+        if (themeError.context) {
+            console.warn(prefixedMessage, themeError.context);
+        }
+        else {
+            console.warn(prefixedMessage);
+        }
+    }
+}
+/**
+ * Convenience function to log a ThemeError.
+ *
+ * @param error - The ThemeError instance to log
+ */
+export function logError(error) {
+    logThemeError(error);
+}
+//# sourceMappingURL=errors.js.map

package/packages/theme-selector/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"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"}

package/packages/theme-selector/dist/index.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Theme selector package - main entry point
+ */
+import { initNavbar } from './navbar.js';
+import { enhanceAccessibility } from './accessibility.js';
+declare global {
+    interface Window {
+        __INITIAL_THEME__?: string;
+        initNavbar: typeof initNavbar;
+    }
+}
+/**
+ * Initializes theme system
+ */
+export declare function initTheme(documentObj: Document, windowObj: Window): Promise<void>;
+/**
+ * Initializes and wires up the theme flavor selector dropdown.
+ * Returns a Promise for API consistency with initTheme.
+ */
+export declare function wireFlavorSelector(documentObj: Document, windowObj: Window): Promise<{
+    cleanup: () => void;
+}>;
+export { initNavbar, enhanceAccessibility };
+export type { ThemeMode, ThemeAppearance, ThemeFamily } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/packages/theme-selector/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA;;GAEG;AAUH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAI1D,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,UAAU,EAAE,OAAO,UAAU,CAAC;KAC/B;CACF;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,WAAW,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAyBvF;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,WAAW,EAAE,QAAQ,EACrB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,IAAI,CAAA;CAAE,CAAC,CA0DlC;AAGD,OAAO,EAAE,UAAU,EAAE,oBAAoB,EAAE,CAAC;AAG5C,YAAY,EAAE,SAAS,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC"}

package/packages/theme-selector/dist/index.js

@@ -0,0 +1,114 @@
+// SPDX-License-Identifier: MIT
+/**
+ * Theme selector package - main entry point
+ */
+import { migrateLegacyStorage, getSavedTheme, saveTheme, DEFAULT_THEME } from './storage.js';
+import { getBaseUrl, getCurrentThemeFromClasses } from './theme-loader.js';
+import { applyTheme, getCurrentTheme } from './apply-theme.js';
+import { THEME_FAMILIES } from './constants.js';
+import { getThemes, getValidThemeIds } from './theme-resolver.js';
+import { createDropdownStateManager } from './dropdown/state.js';
+import { wireDropdownEventHandlers } from './dropdown/events.js';
+import { populateDropdownMenu, wireNativeSelect, getDropdownElements } from './dropdown/ui.js';
+import { initNavbar } from './navbar.js';
+import { enhanceAccessibility } from './accessibility.js';
+import { ThemeErrors, logThemeError } from './errors.js';
+/**
+ * Initializes theme system
+ */
+export async function initTheme(documentObj, windowObj) {
+    // Migrate legacy storage keys
+    migrateLegacyStorage(windowObj);
+    // Check if theme was already applied by blocking script
+    const initialTheme = windowObj.__INITIAL_THEME__;
+    const savedTheme = getSavedTheme(windowObj, getValidThemeIds());
+    // If blocking script already applied theme and it matches saved, just load CSS if needed
+    if (initialTheme && initialTheme === savedTheme) {
+        const currentTheme = getCurrentThemeFromClasses(documentObj.documentElement);
+        if (currentTheme === savedTheme) {
+            // Theme class already applied by blocking script, just ensure CSS is loaded
+            const themeLinkId = `theme-${savedTheme}-css`;
+            const themeLink = documentObj.getElementById(themeLinkId);
+            if (!themeLink) {
+                // CSS not loaded yet, load it now
+                await applyTheme(documentObj, savedTheme);
+            }
+            return;
+        }
+    }
+    // Otherwise, apply theme normally
+    await applyTheme(documentObj, savedTheme);
+}
+/**
+ * Initializes and wires up the theme flavor selector dropdown.
+ * Returns a Promise for API consistency with initTheme.
+ */
+export async function wireFlavorSelector(documentObj, windowObj) {
+    const abortController = new AbortController();
+    // Get required DOM elements
+    const elements = getDropdownElements(documentObj);
+    if (!elements) {
+        return { cleanup: () => abortController.abort() };
+    }
+    const { dropdownMenu, selectEl } = elements;
+    const baseUrl = getBaseUrl(documentObj);
+    const themes = getThemes();
+    // Initialize state
+    const state = {
+        currentIndex: -1,
+        menuItems: [],
+    };
+    // Get current theme (validated against available themes)
+    const currentThemeId = getSavedTheme(windowObj, getValidThemeIds()) ||
+        getCurrentTheme(documentObj, DEFAULT_THEME);
+    // Create state manager (needs elements and state)
+    const stateManager = createDropdownStateManager(elements, state);
+    // Create context for UI creation
+    const ctx = {
+        documentObj,
+        windowObj,
+        baseUrl,
+        currentThemeId,
+        selectEl,
+        menuItems: state.menuItems,
+        closeDropdown: stateManager.closeDropdown,
+        onThemeSelect: async (themeId) => {
+            saveTheme(windowObj, themeId, getValidThemeIds());
+            await applyTheme(documentObj, themeId);
+        },
+    };
+    // Wire native select if present
+    if (selectEl) {
+        wireNativeSelect(ctx, selectEl, themes, DEFAULT_THEME);
+    }
+    // Populate dropdown menu
+    populateDropdownMenu(ctx, dropdownMenu, themes, THEME_FAMILIES);
+    // Wire event handlers
+    wireDropdownEventHandlers(documentObj, elements, state, stateManager, abortController);
+    // Initialize state
+    stateManager.updateAriaExpanded(false);
+    elements.dropdown.classList.remove('is-active');
+    return { cleanup: () => abortController.abort() };
+}
+// Re-export navbar and accessibility functions
+export { initNavbar, enhanceAccessibility };
+// Auto-initialize on DOMContentLoaded
+if (typeof document !== 'undefined' && typeof window !== 'undefined') {
+    document.addEventListener('DOMContentLoaded', async () => {
+        try {
+            await initTheme(document, window);
+            const { cleanup } = await wireFlavorSelector(document, window);
+            enhanceAccessibility(document);
+            // Register cleanup to run on teardown
+            const pagehideHandler = () => {
+                cleanup();
+                window.removeEventListener('pagehide', pagehideHandler);
+            };
+            window.addEventListener('pagehide', pagehideHandler);
+        }
+        catch (error) {
+            logThemeError(ThemeErrors.INIT_FAILED(error));
+        }
+    });
+}
+//# sourceMappingURL=index.js.map

package/packages/theme-selector/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/packages/theme-selector/dist/navbar.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Navbar active state management
+ */
+/**
+ * Initializes navbar active state based on current path
+ */
+export declare function initNavbar(documentObj: Document): void;
+declare global {
+    interface Window {
+        initNavbar: typeof initNavbar;
+    }
+}
+//# sourceMappingURL=navbar.d.ts.map

package/packages/theme-selector/dist/navbar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"navbar.d.ts","sourceRoot":"","sources":["../src/navbar.ts"],"names":[],"mappings":"AACA;;GAEG;AAWH;;GAEG;AACH,wBAAgB,UAAU,CAAC,WAAW,EAAE,QAAQ,GAAG,IAAI,CA2DtD;AAGD,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,UAAU,EAAE,OAAO,UAAU,CAAC;KAC/B;CACF"}

package/packages/theme-selector/dist/navbar.js

@@ -0,0 +1,75 @@
+// SPDX-License-Identifier: MIT
+/**
+ * Navbar active state management
+ */
+import { DOM_SELECTORS } from './constants.js';
+/**
+ * Normalizes a path by removing trailing slashes, defaulting to '/' if empty.
+ */
+function normalizePath(path) {
+    return path.replace(/\/$/, '') || '/';
+}
+/**
+ * Initializes navbar active state based on current path
+ */
+export function initNavbar(documentObj) {
+    const currentPath = documentObj.location.pathname;
+    const normalizedCurrentPath = normalizePath(currentPath);
+    const navbarItems = documentObj.querySelectorAll(DOM_SELECTORS.NAVBAR_ITEM);
+    // Single pass: find matching item and collect items to deactivate
+    let matchingItem = null;
+    const itemsToDeactivate = [];
+    navbarItems.forEach((item) => {
+        const link = item;
+        if (!link.href)
+            return;
+        try {
+            const normalizedLinkPath = normalizePath(new URL(link.href).pathname);
+            if (normalizedCurrentPath === normalizedLinkPath) {
+                matchingItem = item;
+            }
+            else {
+                // Collect non-matching items with valid URLs for deactivation
+                itemsToDeactivate.push(item);
+            }
+        }
+        catch {
+            // Ignore invalid URLs
+        }
+    });
+    // Apply deactivation after finding match (single DOM batch)
+    for (const item of itemsToDeactivate) {
+        item.classList.remove('is-active');
+        item.removeAttribute('aria-current');
+    }
+    // Set active state for the matching link
+    if (matchingItem) {
+        matchingItem.classList.add('is-active');
+        matchingItem.setAttribute('aria-current', 'page');
+    }
+    // Handle Reports dropdown highlighting
+    const reportsLink = documentObj.querySelector(DOM_SELECTORS.NAV_REPORTS);
+    if (reportsLink) {
+        const reportPaths = [
+            '/coverage',
+            '/coverage-python',
+            '/coverage-swift',
+            '/coverage-ruby',
+            '/playwright',
+            '/playwright-examples',
+            '/lighthouse',
+        ];
+        const isOnReportsPage = reportPaths.some((path) => normalizedCurrentPath === path || normalizedCurrentPath.startsWith(path + '/'));
+        if (isOnReportsPage) {
+            reportsLink.classList.add('is-active');
+        }
+        else {
+            reportsLink.classList.remove('is-active');
+        }
+    }
+}
+// Only assign to window in browser context
+if (typeof window !== 'undefined') {
+    window.initNavbar = initNavbar;
+}
+//# sourceMappingURL=navbar.js.map

package/packages/theme-selector/dist/navbar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"navbar.js","sourceRoot":"","sources":["../src/navbar.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE/C;;GAEG;AACH,SAAS,aAAa,CAAC,IAAY;IACjC,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC;AACxC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,WAAqB;IAC9C,MAAM,WAAW,GAAG,WAAW,CAAC,QAAQ,CAAC,QAAQ,CAAC;IAClD,MAAM,qBAAqB,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC;IACzD,MAAM,WAAW,GAAG,WAAW,CAAC,gBAAgB,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC;IAE5E,kEAAkE;IAClE,IAAI,YAAY,GAAmB,IAAI,CAAC;IACxC,MAAM,iBAAiB,GAAc,EAAE,CAAC;IAExC,WAAW,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;QAC3B,MAAM,IAAI,GAAG,IAAyB,CAAC;QACvC,IAAI,CAAC,IAAI,CAAC,IAAI;YAAE,OAAO;QAEvB,IAAI,CAAC;YACH,MAAM,kBAAkB,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,CAAC;YACtE,IAAI,qBAAqB,KAAK,kBAAkB,EAAE,CAAC;gBACjD,YAAY,GAAG,IAAI,CAAC;YACtB,CAAC;iBAAM,CAAC;gBACN,8DAA8D;gBAC9D,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC/B,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,sBAAsB;QACxB,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,4DAA4D;IAC5D,KAAK,MAAM,IAAI,IAAI,iBAAiB,EAAE,CAAC;QACrC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QAClC,IAA0B,CAAC,eAAe,CAAC,cAAc,CAAC,CAAC;IAC9D,CAAC;IAED,yCAAyC;IACzC,IAAI,YAAY,EAAE,CAAC;QAChB,YAA4B,CAAC,SAAS,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QACxD,YAAkC,CAAC,YAAY,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;IAC3E,CAAC;IAED,uCAAuC;IACvC,MAAM,WAAW,GAAG,WAAW,CAAC,aAAa,CAAc,aAAa,CAAC,WAAW,CAAC,CAAC;IACtF,IAAI,WAAW,EAAE,CAAC;QAChB,MAAM,WAAW,GAAG;YAClB,WAAW;YACX,kBAAkB;YAClB,iBAAiB;YACjB,gBAAgB;YAChB,aAAa;YACb,sBAAsB;YACtB,aAAa;SACd,CAAC;QACF,MAAM,eAAe,GAAG,WAAW,CAAC,IAAI,CACtC,CAAC,IAAI,EAAE,EAAE,CAAC,qBAAqB,KAAK,IAAI,IAAI,qBAAqB,CAAC,UAAU,CAAC,IAAI,GAAG,GAAG,CAAC,CACzF,CAAC;QACF,IAAI,eAAe,EAAE,CAAC;YACpB,WAAW,CAAC,SAAS,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QACzC,CAAC;aAAM,CAAC;YACN,WAAW,CAAC,SAAS,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC;AACH,CAAC;AASD,2CAA2C;AAC3C,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;IAClC,MAAM,CAAC,UAAU,GAAG,UAAU,CAAC;AACjC,CAAC"}