Document picker code and architecture

upload/frontend/table/set_status.js

@@ -1,5 +1,16 @@
 import { flattenFiles } from './render.js';
 
+/**
+ * Legacy helper: заменяет HTML статуса у найденного leaf-файла.
+ *
+ * @param {string} path Полный логический путь файла в текущем дереве.
+ * @param {string} html Готовая HTML-строка статуса; вызывающая сторона отвечает
+ * за её безопасность.
+ * @param {{nodes: Array}} state Состояние дерева, из которого ищется файл.
+ * @param {{tableBodyEl: HTMLElement}} elements DOM-элементы старого renderer.
+ * @returns {void} Ничего не возвращает; при отсутствии файла или ячейки ничего
+ * не изменяет.
+ */
 export function setStatus(path, html, state, elements) {
   const file = flattenFiles(state.nodes).find((item) => item.path === path);
   if (!file) return;