semantic update

This commit is contained in:
2026-02-08 22:53:54 +03:00
parent e6087bd3c1
commit 235b0e3c9f
71 changed files with 68034 additions and 62417 deletions

View File

@@ -1,5 +1,6 @@
<!-- [DEF:DebugPage:Component] -->
<!--
@TIER: TRIVIAL
@SEMANTICS: debug, page, tool
@PURPOSE: Page for system diagnostics and debugging.
@LAYER: UI

View File

@@ -1,5 +1,6 @@
<!-- [DEF:MapperPage:Component] -->
<!--
@TIER: TRIVIAL
@SEMANTICS: mapper, page, tool
@PURPOSE: Page for the dataset column mapper tool.
@LAYER: UI

View File

@@ -25,6 +25,7 @@
// [DEF:loadFiles:Function]
/**
* @purpose Fetches the list of files from the server.
* @pre The activeTab is set to a valid category.
* @post Updates the `files` array with the latest data.
*/
let files = [];
@@ -33,6 +34,7 @@
let currentPath = 'backups'; // Relative to storage root
async function loadFiles() {
console.log('[STORAGE-PAGE][LOAD_START] category=%s path=%s', activeTab, currentPath);
isLoading = true;
try {
const category = activeTab;
@@ -51,7 +53,9 @@
: effectivePath;
files = await listFiles(category, subpath);
console.log('[STORAGE-PAGE][LOAD_OK] count=%d', files.length);
} catch (error) {
console.log('[STORAGE-PAGE][LOAD_ERR] error=%s', error.message);
addToast($t.storage.messages.load_failed.replace('{error}', error.message), 'error');
} finally {
isLoading = false;
@@ -62,17 +66,22 @@
// [DEF:handleDelete:Function]
/**
* @purpose Handles the file deletion process.
* @pre The event contains valid category and path.
* @post File is deleted and file list is refreshed.
* @param {CustomEvent} event - The delete event containing category and path.
*/
async function handleDelete(event) {
const { category, path, name } = event.detail;
console.log('[STORAGE-PAGE][DELETE_START] category=%s path=%s', category, path);
if (!confirm($t.storage.messages.delete_confirm.replace('{name}', name))) return;
try {
await deleteFile(category, path);
console.log('[STORAGE-PAGE][DELETE_OK] name=%s', name);
addToast($t.storage.messages.delete_success.replace('{name}', name), 'success');
await loadFiles();
} catch (error) {
console.log('[STORAGE-PAGE][DELETE_ERR] error=%s', error.message);
addToast($t.storage.messages.delete_failed.replace('{error}', error.message), 'error');
}
}
@@ -81,9 +90,12 @@
// [DEF:handleNavigate:Function]
/**
* @purpose Updates the current path and reloads files when navigating into a directory.
* @pre The event contains a valid path string.
* @post currentPath is updated and files are reloaded.
* @param {CustomEvent} event - The navigation event containing the new path.
*/
function handleNavigate(event) {
console.log('[STORAGE-PAGE][NAVIGATE] path=%s', event.detail);
currentPath = event.detail;
loadFiles();
}