Подробные комментарии ко всем JS-файлам фронтенда

site/static/js/icons.js

@@ -1,6 +1,14 @@
-// icons.js — 10 inline-SVG иконок (Lucide, MIT)
-// stroke="currentColor" — цвет берётся из CSS
-// Размер: 20x20, stroke-width: 2
+// icons.js — 10 inline-SVG иконок (Lucide, MIT-лицензия)
+//
+// Все иконки используют stroke="currentColor" — цвет берётся из CSS (color).
+// Размер: 20x20px, stroke-width: 2 (тонкие линии).
+//
+// Почему inline-SVG а не <img> или иконочный шрифт:
+//   - Не требует внешних зависимостей (никаких CDN)
+//   - Цвет controlled через CSS (currentColor)
+//   - Не грузит лишних файлов (иконки вшиты в JS)
+//
+// Использование: ICONS.play, ICONS.edit, ICONS.trash, ...
 
 const ICONS = {
     play: '<svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><polygon points="5 3 19 12 5 21 5 3"/></svg>',