dolphin-client 1.0.6 → 1.1.1

package/dist/index.cjs

@@ -41,7 +41,7 @@ var APIHandler = class {
     target.patch = (pathOrBody, bodyOrOptions, options) => typeof pathOrBody === "string" ? this.request("PATCH", pathOrBody, bodyOrOptions, options) : this.request("PATCH", joined, pathOrBody, bodyOrOptions);
     target.del = (pathOrOptions, options) => typeof pathOrOptions === "string" ? this.request("DELETE", pathOrOptions, null, options) : this.request("DELETE", joined, null, pathOrOptions);
     target.request = (method, subPath, body, options) => {
-      const finalPath = subPath ? `${joined}/${subPath.startsWith("/") ? subPath.slice(1) : subPath}` : joined;
+      const finalPath = subPath ? joined ? `${joined}/${subPath.startsWith("/") ? subPath.slice(1) : subPath}` : subPath : joined;
       return this.request(method, finalPath, body, options);
     };
     target.requestDirect = (method, path, body, options) => {
@@ -225,8 +225,9 @@ var APIHandler = class {
     const _isRetry = options._isRetry === true;
     let finalMethod = method.toUpperCase();
     let finalBody = body;
+    const hasBody = !["GET", "HEAD"].includes(finalMethod);
     const headers = {
-      "Content-Type": "application/json",
+      ...hasBody ? { "Content-Type": "application/json" } : {},
       ...options.headers || {}
     };
     if (["PUT", "PATCH", "DELETE"].includes(finalMethod)) {
@@ -1376,6 +1377,86 @@ function attachDOMBinding(clientProto) {
       console.error("%cFailed Expression:", "color: #3b82f6; font-style: italic;", expression);
     }
   };
+  clientProto._showAlert = function(id, duration) {
+    if (typeof document === "undefined") return;
+    const el = document.getElementById(id) || document.querySelector(`[id="${id}"]`);
+    if (!el) return;
+    el.removeAttribute("hidden");
+    el.style.display = "";
+    if (duration && duration > 0) {
+      setTimeout(() => {
+        el.setAttribute("hidden", "");
+      }, duration);
+    }
+  };
+  clientProto._showToast = function(message, type = "success") {
+    if (typeof document === "undefined") return;
+    const colors = {
+      success: { bg: "rgba(16,185,129,0.15)", border: "#10b981", icon: "\u2705" },
+      error: { bg: "rgba(239,68,68,0.15)", border: "#ef4444", icon: "\u274C" },
+      info: { bg: "rgba(59,130,246,0.15)", border: "#3b82f6", icon: "\u2139\uFE0F" }
+    };
+    const c = colors[type] || colors.success;
+    const toast = document.createElement("div");
+    toast.setAttribute("data-dolphin-toast", "");
+    const existing = document.querySelectorAll("[data-dolphin-toast]");
+    const offset = existing.length * 72;
+    toast.style.cssText = [
+      "position:fixed",
+      `bottom:${24 + offset}px`,
+      "right:24px",
+      "z-index:2147483647",
+      `background:${c.bg}`,
+      `border:1px solid ${c.border}`,
+      "color:#fff",
+      "padding:14px 20px",
+      "border-radius:14px",
+      "font-size:14px",
+      "font-weight:600",
+      "font-family:system-ui,sans-serif",
+      "box-shadow:0 8px 32px rgba(0,0,0,0.4)",
+      "display:flex",
+      "align-items:center",
+      "gap:10px",
+      "max-width:380px",
+      "word-break:break-word",
+      "transform:translateY(80px)",
+      "opacity:0",
+      "transition:transform 0.35s cubic-bezier(0.34,1.56,0.64,1),opacity 0.3s ease",
+      "pointer-events:auto",
+      "backdrop-filter:blur(12px)"
+    ].join(";");
+    toast.innerHTML = `<span style="font-size:18px">${c.icon}</span><span>${message}</span>`;
+    document.body.appendChild(toast);
+    const restack = () => {
+      const remaining = document.querySelectorAll("[data-dolphin-toast]");
+      remaining.forEach((el, i) => {
+        el.style.bottom = `${24 + i * 72}px`;
+      });
+    };
+    const raf = typeof requestAnimationFrame !== "undefined" ? requestAnimationFrame : (cb) => setTimeout(cb, 0);
+    raf(() => raf(() => {
+      toast.style.transform = "translateY(0)";
+      toast.style.opacity = "1";
+    }));
+    const removeToast = () => {
+      clearTimeout(toast._removeTimer);
+      if (toast.parentNode) {
+        toast.parentNode.removeChild(toast);
+        restack();
+      }
+    };
+    const hideTimer = setTimeout(() => {
+      toast.style.transform = "translateY(80px)";
+      toast.style.opacity = "0";
+      toast._removeTimer = setTimeout(removeToast, 400);
+    }, 3500);
+    toast._hideTimer = hideTimer;
+    toast.addEventListener("click", () => {
+      clearTimeout(toast._hideTimer);
+      removeToast();
+    }, { once: true });
+  };
   clientProto._initDOMBinding = function() {
     if (this._domInitialized) return;
     this._domInitialized = true;
@@ -1474,6 +1555,11 @@ function attachDOMBinding(clientProto) {
             resolvedTopic = resolvedTopic.replace(new RegExp(`\\{\\{${escapedK}\\}\\}`, "g"), parentCtx[k] !== void 0 && parentCtx[k] !== null ? parentCtx[k] : "");
           }
           this.publish(resolvedTopic, data);
+          const rtSuccessId = e.target.getAttribute("data-rt-api-success");
+          if (rtSuccessId) {
+            const rtSuccessEl = document.getElementById(rtSuccessId);
+            if (rtSuccessEl) this._showToast(rtSuccessEl.textContent || rtSuccessEl.innerText || "", "success");
+          }
         } else if (apiTarget) {
           let resolvedTarget = apiTarget;
           for (const k in parentCtx) {
@@ -1490,16 +1576,40 @@ function attachDOMBinding(clientProto) {
             const result = await this.api.request(method, path, data);
             const resultBind = e.target.getAttribute("data-api-result");
             if (resultBind) this._updateDOM(resultBind, result);
+            const successToast = e.target.getAttribute("data-api-toast");
+            if (successToast) this._showToast(successToast, "success");
+            const successElId = e.target.getAttribute("data-rt-api-success");
+            if (successElId) {
+              const duration = parseInt(e.target.getAttribute("data-rt-alert-duration") || "0", 10);
+              this._showAlert(successElId, duration);
+              const errElId = e.target.getAttribute("data-rt-api-error");
+              if (errElId) {
+                const errEl = document.getElementById(errElId);
+                if (errEl) errEl.setAttribute("hidden", "");
+              }
+            }
             const redirect = e.target.getAttribute("data-api-redirect");
             if (redirect) window.location.href = redirect;
             if (e.target.hasAttribute("data-api-reload")) window.location.reload();
           } catch (err) {
             console.error("[Dolphin] API Submit Error:", err);
+            const errorToast = e.target.getAttribute("data-api-error-toast");
+            if (errorToast) this._showToast(errorToast, "error");
+            const errorElId = e.target.getAttribute("data-rt-api-error");
+            if (errorElId) {
+              const duration = parseInt(e.target.getAttribute("data-rt-alert-duration") || "0", 10);
+              this._showAlert(errorElId, duration);
+              const sucElId = e.target.getAttribute("data-rt-api-success");
+              if (sucElId) {
+                const sucEl = document.getElementById(sucElId);
+                if (sucEl) sucEl.setAttribute("hidden", "");
+              }
+            }
           }
         }
       }
     });
-    const INTERACTION_EVENTS = ["click", "change", "submit", "input", "keydown", "keyup", "dblclick", "focus", "blur", "mouseenter", "mouseleave"];
+    const INTERACTION_EVENTS = ["click", "change", "input", "keydown", "keyup", "dblclick", "focus", "blur", "mouseenter", "mouseleave"];
     INTERACTION_EVENTS.forEach((evtName) => {
       this.addDomListener(document, evtName, async (e) => {
         if (!e.target || !e.target.closest) return;
@@ -1530,7 +1640,12 @@ function attachDOMBinding(clientProto) {
           const apiTarget = apiBtn.getAttribute(`data-api-${evtName}`);
           const actionData = apiBtn.getAttribute("data-api-payload");
           const parentCtx = this.getClosestContext(apiBtn) || {};
-          const parts = apiTarget.trim().split(" ");
+          let resolvedApiTarget = apiTarget;
+          for (const k in parentCtx) {
+            const escapedK = escapeRegExp(k);
+            resolvedApiTarget = resolvedApiTarget.replace(new RegExp(`\\{\\{${escapedK}\\}\\}`, "g"), parentCtx[k] !== void 0 && parentCtx[k] !== null ? parentCtx[k] : "");
+          }
+          const parts = resolvedApiTarget.trim().split(" ");
           const method = parts.length > 1 ? parts[0].toUpperCase() : "POST";
           const path = parts.length > 1 ? parts[1] : parts[0];
           let payload = null;
@@ -1550,11 +1665,35 @@ function attachDOMBinding(clientProto) {
             const result = await this.api.request(method, path, payload);
             const resultBind = apiBtn.getAttribute("data-api-result");
             if (resultBind) this._updateDOM(resultBind, result);
+            const successToast = apiBtn.getAttribute("data-api-toast");
+            if (successToast) this._showToast(successToast, "success");
+            const successElId = apiBtn.getAttribute("data-rt-api-success");
+            if (successElId) {
+              const duration = parseInt(apiBtn.getAttribute("data-rt-alert-duration") || "0", 10);
+              this._showAlert(successElId, duration);
+              const errElId = apiBtn.getAttribute("data-rt-api-error");
+              if (errElId) {
+                const errEl = document.getElementById(errElId);
+                if (errEl) errEl.setAttribute("hidden", "");
+              }
+            }
             const redirect = apiBtn.getAttribute("data-api-redirect");
             if (redirect) window.location.href = redirect;
             if (apiBtn.hasAttribute("data-api-reload")) window.location.reload();
           } catch (err) {
             console.error(`[Dolphin] API ${evtName} Error:`, err);
+            const errorToast = apiBtn.getAttribute("data-api-error-toast");
+            if (errorToast) this._showToast(errorToast, "error");
+            const errorElId = apiBtn.getAttribute("data-rt-api-error");
+            if (errorElId) {
+              const duration = parseInt(apiBtn.getAttribute("data-rt-alert-duration") || "0", 10);
+              this._showAlert(errorElId, duration);
+              const sucElId = apiBtn.getAttribute("data-rt-api-success");
+              if (sucElId) {
+                const sucEl = document.getElementById(sucElId);
+                if (sucEl) sucEl.setAttribute("hidden", "");
+              }
+            }
           }
         }
         const storeActionBtn = e.target.closest(`[data-store-${evtName}]`);

package/dist/index.js

@@ -16,7 +16,7 @@ var APIHandler = class {
     target.patch = (pathOrBody, bodyOrOptions, options) => typeof pathOrBody === "string" ? this.request("PATCH", pathOrBody, bodyOrOptions, options) : this.request("PATCH", joined, pathOrBody, bodyOrOptions);
     target.del = (pathOrOptions, options) => typeof pathOrOptions === "string" ? this.request("DELETE", pathOrOptions, null, options) : this.request("DELETE", joined, null, pathOrOptions);
     target.request = (method, subPath, body, options) => {
-      const finalPath = subPath ? `${joined}/${subPath.startsWith("/") ? subPath.slice(1) : subPath}` : joined;
+      const finalPath = subPath ? joined ? `${joined}/${subPath.startsWith("/") ? subPath.slice(1) : subPath}` : subPath : joined;
       return this.request(method, finalPath, body, options);
     };
     target.requestDirect = (method, path, body, options) => {
@@ -200,8 +200,9 @@ var APIHandler = class {
     const _isRetry = options._isRetry === true;
     let finalMethod = method.toUpperCase();
     let finalBody = body;
+    const hasBody = !["GET", "HEAD"].includes(finalMethod);
     const headers = {
-      "Content-Type": "application/json",
+      ...hasBody ? { "Content-Type": "application/json" } : {},
       ...options.headers || {}
     };
     if (["PUT", "PATCH", "DELETE"].includes(finalMethod)) {
@@ -1351,6 +1352,86 @@ function attachDOMBinding(clientProto) {
       console.error("%cFailed Expression:", "color: #3b82f6; font-style: italic;", expression);
     }
   };
+  clientProto._showAlert = function(id, duration) {
+    if (typeof document === "undefined") return;
+    const el = document.getElementById(id) || document.querySelector(`[id="${id}"]`);
+    if (!el) return;
+    el.removeAttribute("hidden");
+    el.style.display = "";
+    if (duration && duration > 0) {
+      setTimeout(() => {
+        el.setAttribute("hidden", "");
+      }, duration);
+    }
+  };
+  clientProto._showToast = function(message, type = "success") {
+    if (typeof document === "undefined") return;
+    const colors = {
+      success: { bg: "rgba(16,185,129,0.15)", border: "#10b981", icon: "\u2705" },
+      error: { bg: "rgba(239,68,68,0.15)", border: "#ef4444", icon: "\u274C" },
+      info: { bg: "rgba(59,130,246,0.15)", border: "#3b82f6", icon: "\u2139\uFE0F" }
+    };
+    const c = colors[type] || colors.success;
+    const toast = document.createElement("div");
+    toast.setAttribute("data-dolphin-toast", "");
+    const existing = document.querySelectorAll("[data-dolphin-toast]");
+    const offset = existing.length * 72;
+    toast.style.cssText = [
+      "position:fixed",
+      `bottom:${24 + offset}px`,
+      "right:24px",
+      "z-index:2147483647",
+      `background:${c.bg}`,
+      `border:1px solid ${c.border}`,
+      "color:#fff",
+      "padding:14px 20px",
+      "border-radius:14px",
+      "font-size:14px",
+      "font-weight:600",
+      "font-family:system-ui,sans-serif",
+      "box-shadow:0 8px 32px rgba(0,0,0,0.4)",
+      "display:flex",
+      "align-items:center",
+      "gap:10px",
+      "max-width:380px",
+      "word-break:break-word",
+      "transform:translateY(80px)",
+      "opacity:0",
+      "transition:transform 0.35s cubic-bezier(0.34,1.56,0.64,1),opacity 0.3s ease",
+      "pointer-events:auto",
+      "backdrop-filter:blur(12px)"
+    ].join(";");
+    toast.innerHTML = `<span style="font-size:18px">${c.icon}</span><span>${message}</span>`;
+    document.body.appendChild(toast);
+    const restack = () => {
+      const remaining = document.querySelectorAll("[data-dolphin-toast]");
+      remaining.forEach((el, i) => {
+        el.style.bottom = `${24 + i * 72}px`;
+      });
+    };
+    const raf = typeof requestAnimationFrame !== "undefined" ? requestAnimationFrame : (cb) => setTimeout(cb, 0);
+    raf(() => raf(() => {
+      toast.style.transform = "translateY(0)";
+      toast.style.opacity = "1";
+    }));
+    const removeToast = () => {
+      clearTimeout(toast._removeTimer);
+      if (toast.parentNode) {
+        toast.parentNode.removeChild(toast);
+        restack();
+      }
+    };
+    const hideTimer = setTimeout(() => {
+      toast.style.transform = "translateY(80px)";
+      toast.style.opacity = "0";
+      toast._removeTimer = setTimeout(removeToast, 400);
+    }, 3500);
+    toast._hideTimer = hideTimer;
+    toast.addEventListener("click", () => {
+      clearTimeout(toast._hideTimer);
+      removeToast();
+    }, { once: true });
+  };
   clientProto._initDOMBinding = function() {
     if (this._domInitialized) return;
     this._domInitialized = true;
@@ -1449,6 +1530,11 @@ function attachDOMBinding(clientProto) {
             resolvedTopic = resolvedTopic.replace(new RegExp(`\\{\\{${escapedK}\\}\\}`, "g"), parentCtx[k] !== void 0 && parentCtx[k] !== null ? parentCtx[k] : "");
           }
           this.publish(resolvedTopic, data);
+          const rtSuccessId = e.target.getAttribute("data-rt-api-success");
+          if (rtSuccessId) {
+            const rtSuccessEl = document.getElementById(rtSuccessId);
+            if (rtSuccessEl) this._showToast(rtSuccessEl.textContent || rtSuccessEl.innerText || "", "success");
+          }
         } else if (apiTarget) {
           let resolvedTarget = apiTarget;
           for (const k in parentCtx) {
@@ -1465,16 +1551,40 @@ function attachDOMBinding(clientProto) {
             const result = await this.api.request(method, path, data);
             const resultBind = e.target.getAttribute("data-api-result");
             if (resultBind) this._updateDOM(resultBind, result);
+            const successToast = e.target.getAttribute("data-api-toast");
+            if (successToast) this._showToast(successToast, "success");
+            const successElId = e.target.getAttribute("data-rt-api-success");
+            if (successElId) {
+              const duration = parseInt(e.target.getAttribute("data-rt-alert-duration") || "0", 10);
+              this._showAlert(successElId, duration);
+              const errElId = e.target.getAttribute("data-rt-api-error");
+              if (errElId) {
+                const errEl = document.getElementById(errElId);
+                if (errEl) errEl.setAttribute("hidden", "");
+              }
+            }
             const redirect = e.target.getAttribute("data-api-redirect");
             if (redirect) window.location.href = redirect;
             if (e.target.hasAttribute("data-api-reload")) window.location.reload();
           } catch (err) {
             console.error("[Dolphin] API Submit Error:", err);
+            const errorToast = e.target.getAttribute("data-api-error-toast");
+            if (errorToast) this._showToast(errorToast, "error");
+            const errorElId = e.target.getAttribute("data-rt-api-error");
+            if (errorElId) {
+              const duration = parseInt(e.target.getAttribute("data-rt-alert-duration") || "0", 10);
+              this._showAlert(errorElId, duration);
+              const sucElId = e.target.getAttribute("data-rt-api-success");
+              if (sucElId) {
+                const sucEl = document.getElementById(sucElId);
+                if (sucEl) sucEl.setAttribute("hidden", "");
+              }
+            }
           }
         }
       }
     });
-    const INTERACTION_EVENTS = ["click", "change", "submit", "input", "keydown", "keyup", "dblclick", "focus", "blur", "mouseenter", "mouseleave"];
+    const INTERACTION_EVENTS = ["click", "change", "input", "keydown", "keyup", "dblclick", "focus", "blur", "mouseenter", "mouseleave"];
     INTERACTION_EVENTS.forEach((evtName) => {
       this.addDomListener(document, evtName, async (e) => {
         if (!e.target || !e.target.closest) return;
@@ -1505,7 +1615,12 @@ function attachDOMBinding(clientProto) {
           const apiTarget = apiBtn.getAttribute(`data-api-${evtName}`);
           const actionData = apiBtn.getAttribute("data-api-payload");
           const parentCtx = this.getClosestContext(apiBtn) || {};
-          const parts = apiTarget.trim().split(" ");
+          let resolvedApiTarget = apiTarget;
+          for (const k in parentCtx) {
+            const escapedK = escapeRegExp(k);
+            resolvedApiTarget = resolvedApiTarget.replace(new RegExp(`\\{\\{${escapedK}\\}\\}`, "g"), parentCtx[k] !== void 0 && parentCtx[k] !== null ? parentCtx[k] : "");
+          }
+          const parts = resolvedApiTarget.trim().split(" ");
           const method = parts.length > 1 ? parts[0].toUpperCase() : "POST";
           const path = parts.length > 1 ? parts[1] : parts[0];
           let payload = null;
@@ -1525,11 +1640,35 @@ function attachDOMBinding(clientProto) {
             const result = await this.api.request(method, path, payload);
             const resultBind = apiBtn.getAttribute("data-api-result");
             if (resultBind) this._updateDOM(resultBind, result);
+            const successToast = apiBtn.getAttribute("data-api-toast");
+            if (successToast) this._showToast(successToast, "success");
+            const successElId = apiBtn.getAttribute("data-rt-api-success");
+            if (successElId) {
+              const duration = parseInt(apiBtn.getAttribute("data-rt-alert-duration") || "0", 10);
+              this._showAlert(successElId, duration);
+              const errElId = apiBtn.getAttribute("data-rt-api-error");
+              if (errElId) {
+                const errEl = document.getElementById(errElId);
+                if (errEl) errEl.setAttribute("hidden", "");
+              }
+            }
             const redirect = apiBtn.getAttribute("data-api-redirect");
             if (redirect) window.location.href = redirect;
             if (apiBtn.hasAttribute("data-api-reload")) window.location.reload();
           } catch (err) {
             console.error(`[Dolphin] API ${evtName} Error:`, err);
+            const errorToast = apiBtn.getAttribute("data-api-error-toast");
+            if (errorToast) this._showToast(errorToast, "error");
+            const errorElId = apiBtn.getAttribute("data-rt-api-error");
+            if (errorElId) {
+              const duration = parseInt(apiBtn.getAttribute("data-rt-alert-duration") || "0", 10);
+              this._showAlert(errorElId, duration);
+              const sucElId = apiBtn.getAttribute("data-rt-api-success");
+              if (sucElId) {
+                const sucEl = document.getElementById(sucElId);
+                if (sucEl) sucEl.setAttribute("hidden", "");
+              }
+            }
           }
         }
         const storeActionBtn = e.target.closest(`[data-store-${evtName}]`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dolphin-client",
-  "version": "1.0.6",
+  "version": "1.1.1",
   "description": "HTML is back! Hookless, framework-agnostic real-time reactive DOM-binding client for Dolphin Server with WebSockets, WebRTC signaling, and offline REST API fallbacks.",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -13,11 +13,17 @@
       "require": "./dist/index.cjs"
     }
   },
+  "bin": {
+    "dolphin-client": "./bin/cli.cjs"
+  },
   "files": [
     "dist",
     "README.md",
     "LICENSE",
-    "fulltutorial.md"
+    "fulltutorial.md",
+    "scripts",
+    ".vscode",
+    "bin"
   ],
   "scripts": {
     "build": "npm run build:iife && npm run build:min && npm run build:esm && npm run build:cjs && tsc",
@@ -25,7 +31,8 @@
     "build:min": "esbuild ./src/index.ts --bundle --minify --outfile=dist/dolphin-client.min.js --format=iife --global-name=DolphinModule",
     "build:esm": "esbuild ./src/index.ts --bundle --outfile=dist/index.js --format=esm",
     "build:cjs": "esbuild ./src/index.ts --bundle --outfile=dist/index.cjs --format=cjs",
-    "test": "jest"
+    "test": "jest",
+    "postinstall": "node scripts/postinstall.js"
   },
   "jest": {
     "preset": "ts-jest",

package/scripts/postinstall.js

@@ -0,0 +1,57 @@
+const path = require('path');
+const fs = require('fs');
+
+// This script runs automatically after npm install dolphin-client.
+// It sets up the VS Code Custom HTML Data configuration in the host project's .vscode folder
+// so autocomplete for Dolphin Client attributes works instantly out-of-the-box!
+
+try {
+    const currentPath = __dirname;
+    // Check if we are inside a node_modules folder (production installation)
+    if (currentPath.includes('node_modules')) {
+        // Resolve host project root (e.g. node_modules/dolphin-client/scripts -> hostRoot)
+        const hostRoot = path.resolve(__dirname, '../../..');
+        const vscodeDir = path.join(hostRoot, '.vscode');
+
+        // 1. Ensure the host's .vscode directory exists
+        if (!fs.existsSync(vscodeDir)) {
+            fs.mkdirSync(vscodeDir, { recursive: true });
+            console.log('[Dolphin Client] Created .vscode directory in project root.');
+        }
+
+        // 2. Copy the dolphin-tags.json file to the host's .vscode folder
+        const sourceTags = path.resolve(__dirname, '../.vscode/dolphin-tags.json');
+        const destTags = path.join(vscodeDir, 'dolphin-tags.json');
+        if (fs.existsSync(sourceTags)) {
+            fs.copyFileSync(sourceTags, destTags);
+            console.log('[Dolphin Client] Copied HTML custom data configuration to .vscode/dolphin-tags.json');
+        }
+
+        // 3. Update the host's settings.json to include the custom data file path
+        const settingsPath = path.join(vscodeDir, 'settings.json');
+        let settings = {};
+        if (fs.existsSync(settingsPath)) {
+            try {
+                settings = JSON.parse(fs.readFileSync(settingsPath, 'utf8'));
+            } catch (e) {
+                settings = {};
+            }
+        }
+
+        if (!settings['html.customData']) {
+            settings['html.customData'] = [];
+        }
+
+        const relativePath = '.vscode/dolphin-tags.json';
+        if (!settings['html.customData'].includes(relativePath)) {
+            settings['html.customData'].push(relativePath);
+            fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2), 'utf8');
+            console.log('[Dolphin Client] Registered dolphin-tags.json in .vscode/settings.json');
+        }
+        
+        console.log('\x1b[36m%s\x1b[0m', '🐬 [Dolphin Client] VS Code Autocomplete successfully configured!');
+        console.log('\x1b[33m%s\x1b[0m', '👉 Note: Please run "Developer: Reload Window" in VS Code to activate suggestions.');
+    }
+} catch (err) {
+    console.warn('[Dolphin Client] Failed to auto-configure VS Code autocomplete:', err.message);
+}