docs: add comprehensive JSDoc comments to all JavaScript functions

app/static/js/login.js

@@ -1,4 +1,13 @@
-// Theme toggle
+/**
+ * LogBoard+ - Скрипт страницы входа
+ * Автор: Сергей Антропов
+ * Сайт: https://devops.org.ru
+ */
+
+/**
+ * Инициализация переключателя темы
+ * Загружает сохраненную тему из localStorage и настраивает переключатель
+ */
 (function initTheme(){
     const saved = localStorage.lb_theme || 'dark';
     document.documentElement.setAttribute('data-theme', saved);
@@ -10,7 +19,10 @@
     });
 })();
 
-// Password toggle
+/**
+ * Обработчик переключения видимости пароля
+ * Показывает/скрывает пароль и меняет иконку
+ */
 document.getElementById('passwordToggle').addEventListener('click', function() {
     const passwordInput = document.getElementById('password');
     const icon = this.querySelector('i');
@@ -24,7 +36,10 @@ document.getElementById('passwordToggle').addEventListener('click', function() {
     }
 });
 
-// Login form
+/**
+ * Обработчик отправки формы входа
+ * Выполняет аутентификацию пользователя через API
+ */
 document.getElementById('loginForm').addEventListener('submit', async function(e) {
     e.preventDefault();
     
@@ -82,18 +97,27 @@ document.getElementById('loginForm').addEventListener('submit', async function(e
     }
 });
 
+/**
+ * Показывает сообщение об ошибке
+ * @param {string} message - Текст ошибки
+ */
 function showError(message) {
     const errorMessage = document.getElementById('errorMessage');
     errorMessage.textContent = message;
     errorMessage.classList.add('show');
 }
 
+/**
+ * Скрывает сообщение об ошибке
+ */
 function hideError() {
     const errorMessage = document.getElementById('errorMessage');
     errorMessage.classList.remove('show');
 }
 
-// Auto-focus on username field
+/**
+ * Автофокус на поле имени пользователя при загрузке страницы
+ */
 document.addEventListener('DOMContentLoaded', function() {
     document.getElementById('username').focus();
 });