semantic-heading-hierarchy/src/logging.ts

A JavaScript library that automatically invisibly corrects improper heading hierarchies for better accessibility. Used for user or admin edited content where the developer doesn't have 100% direct control over the content.

import { LoggingInterface } from './types.js';

/**
 * Enables detailed logging for all healHeadings calls via localStorage
 */
export function enableHeadingLogging(): void {
  if (typeof localStorage !== 'undefined') {
    localStorage.setItem('healHeadings.logResults', 'true');
    console.log('✅ Detailed heading healing logging ENABLED globally');
  } else {
    console.warn('localStorage not available - cannot enable global logging');
  }
}

/**
 * Disables detailed logging for all healHeadings calls via localStorage
 */
export function disableHeadingLogging(): void {
  if (typeof localStorage !== 'undefined') {
    localStorage.setItem('healHeadings.logResults', 'false');
    console.log('❌ Detailed heading healing logging DISABLED globally');
  } else {
    console.warn('localStorage not available - cannot disable global logging');
  }
}

/**
 * Clears localStorage override, returns to using function parameters for logging
 */
export function clearHeadingLogging(): void {
  if (typeof localStorage !== 'undefined') {
    localStorage.removeItem('healHeadings.logResults');
    console.log('🔄 Heading healing logging reset - will use function parameter');
  } else {
    console.warn('localStorage not available - cannot clear global logging');
  }
}

/**
 * Gets the current logging status from localStorage
 * @returns The current logging override value or null if not set
 */
export function getHeadingLoggingStatus(): string | null {
  if (typeof localStorage !== 'undefined') {
    const setting = localStorage.getItem('healHeadings.logResults');
    if (setting === null) {
      console.log('📋 Heading healing logging: Using function parameter (no override set)');
    } else {
      console.log(`📋 Heading healing logging: ${setting === 'true' ? 'ENABLED' : 'DISABLED'} (localStorage override)`);
    }
    return setting;
  } else {
    console.log('📋 Heading healing logging: localStorage not available');
    return null;
  }
}

/**
 * Creates a logging interface object that implements LoggingInterface
 */
export function createLoggingInterface(): LoggingInterface {
  return {
    enable: enableHeadingLogging,
    disable: disableHeadingLogging,
    clear: clearHeadingLogging,
    status: getHeadingLoggingStatus
  };
}