semantic markup update

frontend/src/components/tools/ConnectionForm.svelte

@@ -25,6 +25,8 @@
 
     // [DEF:handleSubmit:Function]
     // @PURPOSE: Submits the connection form to the backend.
+    // @PRE: All required fields (name, host, database, username, password) must be filled.
+    // @POST: A new connection is created via the connection service and a success event is dispatched.
     async function handleSubmit() {
         if (!name || !host || !database || !username || !password) {
             addToast('Please fill in all required fields', 'warning');
@@ -47,6 +49,11 @@
     }
     // [/DEF:handleSubmit:Function]
 
+    // [DEF:resetForm:Function]
+    /* @PURPOSE: Resets the connection form fields to their default values.
+       @PRE: None.
+       @POST: All form input variables are reset.
+    */
     function resetForm() {
         name = '';
         host = '';
@@ -55,6 +62,7 @@
         username = '';
         password = '';
     }
+    // [/DEF:resetForm:Function]
 </script>
 
 <!-- [SECTION: TEMPLATE] -->

frontend/src/components/tools/ConnectionList.svelte

@@ -19,6 +19,8 @@
 
     // [DEF:fetchConnections:Function]
     // @PURPOSE: Fetches the list of connections from the backend.
+    // @PRE: None.
+    // @POST: connections array is populated.
     async function fetchConnections() {
         isLoading = true;
         try {
@@ -33,6 +35,8 @@
 
     // [DEF:handleDelete:Function]
     // @PURPOSE: Deletes a connection configuration.
+    // @PRE: id is provided and user confirms deletion.
+    // @POST: Connection is deleted from backend and list is reloaded.
     async function handleDelete(id) {
         if (!confirm('Are you sure you want to delete this connection?')) return;
         

frontend/src/components/tools/MapperTool.svelte

@@ -28,6 +28,8 @@
 
     // [DEF:fetchData:Function]
     // @PURPOSE: Fetches environments and saved connections.
+    // @PRE: None.
+    // @POST: envs and connections arrays are populated.
     async function fetchData() {
         try {
             const envsRes = await fetch('/api/environments');
@@ -41,6 +43,8 @@
 
     // [DEF:handleRunMapper:Function]
     // @PURPOSE: Triggers the MapperPlugin task.
+    // @PRE: selectedEnv and datasetId are set; source-specific fields are valid.
+    // @POST: Mapper task is started and selectedTask is updated.
     async function handleRunMapper() {
         if (!selectedEnv || !datasetId) {
             addToast('Please fill in required fields', 'warning');

frontend/src/components/tools/SearchTool.svelte

@@ -22,6 +22,8 @@
 
     // [DEF:fetchEnvironments:Function]
     // @PURPOSE: Fetches the list of available environments.
+    // @PRE: None.
+    // @POST: envs array is populated.
     async function fetchEnvironments() {
         try {
             const res = await fetch('/api/environments');
@@ -34,6 +36,8 @@
 
     // [DEF:handleSearch:Function]
     // @PURPOSE: Triggers the SearchPlugin task.
+    // @PRE: selectedEnv and searchQuery must be set.
+    // @POST: Task is started and polling begins.
     async function handleSearch() {
         if (!selectedEnv || !searchQuery) {
             addToast('Please select environment and enter query', 'warning');
@@ -61,6 +65,8 @@
 
     // [DEF:startPolling:Function]
     // @PURPOSE: Polls for task completion and results.
+    // @PRE: taskId is provided.
+    // @POST: pollInterval is set and results are updated on success.
     function startPolling(taskId) {
         if (pollInterval) clearInterval(pollInterval);