@silicaclaw/cli 2026.3.19-6 → 2026.3.19-7

package/apps/local-console/src/server.ts

@@ -2,7 +2,7 @@ import express, { NextFunction, Request, Response } from "express";
 import cors from "cors";
 import { execFile, spawnSync } from "child_process";
 import { resolve } from "path";
-import { accessSync, constants, copyFileSync, existsSync, mkdirSync, readFileSync } from "fs";
+import { accessSync, constants, copyFileSync, existsSync, mkdirSync, readFileSync, readdirSync, statSync } from "fs";
 import { createHash } from "crypto";
 import { hostname } from "os";
 import { promisify } from "util";
@@ -172,6 +172,47 @@ function existingPathOrNull(filePath: string): string | null {
   return existsSync(filePath) ? filePath : null;
 }
 
+function listDirectories(root: string) {
+  if (!root || !existsSync(root)) return [];
+  try {
+    return readdirSync(root)
+      .map((name) => {
+        const fullPath = resolve(root, name);
+        try {
+          return statSync(fullPath).isDirectory() ? { name, path: fullPath } : null;
+        } catch {
+          return null;
+        }
+      })
+      .filter((item): item is { name: string; path: string } => Boolean(item));
+  } catch {
+    return [];
+  }
+}
+
+function readJsonFileSafe(filePath: string) {
+  try {
+    return JSON.parse(readFileSync(filePath, "utf8")) as Record<string, unknown>;
+  } catch {
+    return null;
+  }
+}
+
+function summarizeSkillReadme(filePath: string) {
+  if (!filePath || !existsSync(filePath)) return "";
+  try {
+    const raw = readFileSync(filePath, "utf8");
+    const lines = raw
+      .split(/\r?\n/)
+      .map((line) => line.trim())
+      .filter(Boolean)
+      .filter((line) => !line.startsWith("#"));
+    return String(lines[0] || "").slice(0, 220);
+  } catch {
+    return "";
+  }
+}
+
 function detectOpenClawInstallation(workspaceRoot: string) {
   const workspaceDir = resolve(workspaceRoot, ".openclaw");
   const homeDir = resolve(process.env.HOME || "", ".openclaw");
@@ -1527,6 +1568,85 @@ export class LocalNodeService {
     };
   }
 
+  getSkillsView() {
+    const bundledRoot = resolve(this.workspaceRoot, "openclaw-skills");
+    const openclawHome = resolve(process.env.HOME || "", ".openclaw");
+    const workspaceInstallRoot = resolve(openclawHome, "workspace", "skills");
+    const legacyInstallRoot = resolve(openclawHome, "skills");
+    const bridge = this.getOpenClawBridgeStatus();
+    const bundledSkills = listDirectories(bundledRoot).map((dir) => {
+      const manifestPath = resolve(dir.path, "manifest.json");
+      const skillPath = resolve(dir.path, "SKILL.md");
+      const versionPath = resolve(dir.path, "VERSION");
+      const manifest = readJsonFileSafe(manifestPath);
+      const name = String(manifest?.name || dir.name);
+      const capabilities = Array.isArray(manifest?.capabilities)
+        ? manifest.capabilities.map((item) => String(item))
+        : [];
+      const installedWorkspacePath = resolve(workspaceInstallRoot, name);
+      const installedLegacyPath = resolve(legacyInstallRoot, name);
+      const installedInWorkspace = existsSync(installedWorkspacePath);
+      const installedInLegacy = existsSync(installedLegacyPath);
+      return {
+        key: name,
+        name,
+        display_name: String(manifest?.display_name || name),
+        description: String(manifest?.description || summarizeSkillReadme(skillPath) || ""),
+        version: existsSync(versionPath) ? readFileSync(versionPath, "utf8").trim() : String(manifest?.version || ""),
+        source_path: dir.path,
+        manifest_path: existsSync(manifestPath) ? manifestPath : null,
+        skill_path: existsSync(skillPath) ? skillPath : null,
+        capabilities,
+        transport: manifest?.transport || null,
+        installed_in_openclaw: installedInWorkspace || installedInLegacy,
+        install_mode: installedInWorkspace ? "workspace" : installedInLegacy ? "legacy" : "not_installed",
+        installed_path: installedInWorkspace ? installedWorkspacePath : installedInLegacy ? installedLegacyPath : null,
+      };
+    });
+
+    const installedSkills = [
+      ...listDirectories(workspaceInstallRoot).map((dir) => ({ ...dir, install_mode: "workspace" as const })),
+      ...listDirectories(legacyInstallRoot).map((dir) => ({ ...dir, install_mode: "legacy" as const })),
+    ].map((dir) => {
+      const manifestPath = resolve(dir.path, "manifest.json");
+      const skillPath = resolve(dir.path, "SKILL.md");
+      const versionPath = resolve(dir.path, "VERSION");
+      const manifest = readJsonFileSafe(manifestPath);
+      return {
+        key: `${dir.install_mode}:${dir.name}`,
+        name: String(manifest?.name || dir.name),
+        display_name: String(manifest?.display_name || dir.name),
+        description: String(manifest?.description || summarizeSkillReadme(skillPath) || ""),
+        version: existsSync(versionPath) ? readFileSync(versionPath, "utf8").trim() : String(manifest?.version || ""),
+        install_mode: dir.install_mode,
+        installed_path: dir.path,
+        manifest_path: existsSync(manifestPath) ? manifestPath : null,
+        skill_path: existsSync(skillPath) ? skillPath : null,
+        capabilities: Array.isArray(manifest?.capabilities) ? manifest.capabilities.map((item) => String(item)) : [],
+        bundled_source_path: bundledSkills.find((item) => item.name === String(manifest?.name || dir.name))?.source_path || null,
+      };
+    });
+
+    return {
+      openclaw: {
+        detected: bridge.openclaw_installation.detected,
+        running: bridge.openclaw_runtime.running,
+        detection_mode: bridge.openclaw_runtime.detection_mode,
+        gateway_url: bridge.openclaw_runtime.gateway_url,
+        workspace_install_root: workspaceInstallRoot,
+        legacy_install_root: legacyInstallRoot,
+      },
+      summary: {
+        bundled_count: bundledSkills.length,
+        installed_count: installedSkills.length,
+        installed_bundled_count: bundledSkills.filter((item) => item.installed_in_openclaw).length,
+      },
+      install_action: bridge.skill_learning.install_action,
+      bundled_skills: bundledSkills,
+      installed_skills: installedSkills,
+    };
+  }
+
   getRuntimeMessageGovernance() {
     return this.messageGovernance;
   }
@@ -2830,6 +2950,10 @@ export async function main() {
     sendOk(res, node.getNetworkStats());
   });
 
+  app.get("/api/skills", (_req, res) => {
+    sendOk(res, node.getSkillsView());
+  });
+
   app.post(
     "/api/network/quick-connect-global-preview",
     asyncRoute(async (req, res) => {

package/apps/public-explorer/public/app/app.js

@@ -0,0 +1,302 @@
+import { appTemplate } from "./template.js";
+import { createI18n } from "./i18n.js";
+import { TRANSLATIONS } from "./translations.js";
+import {
+  escapeHtml,
+  formatMessageBody,
+  freshnessStatusText,
+  shortId,
+  toPrettyJson,
+  verificationStatusText,
+} from "./utils.js";
+
+const root = document.getElementById("app-root");
+if (!root) {
+  throw new Error("Missing root element: app-root");
+}
+root.innerHTML = appTemplate;
+
+      const i18n = createI18n(TRANSLATIONS);
+      const t = i18n.t;
+      function setLocale(locale) {
+        return i18n.setLocale(locale);
+      }
+      function applyTranslations() {
+        document.title = t('meta.title');
+        document.getElementById('metaDescription').setAttribute('content', t('meta.description'));
+        document.getElementById('ogTitle').setAttribute('content', t('meta.title'));
+        document.getElementById('ogDescription').setAttribute('content', t('meta.socialDescription'));
+        document.getElementById('twitterTitle').setAttribute('content', t('meta.title'));
+        document.getElementById('twitterDescription').setAttribute('content', t('meta.socialDescription'));
+        document.getElementById('pageTitle').textContent = t('page.title');
+        document.getElementById('pageSubtitle').textContent = t('page.subtitle');
+        document.getElementById('themeDarkBtn').textContent = t('page.themeDark');
+        document.getElementById('themeLightBtn').textContent = t('page.themeLight');
+        document.getElementById('q').setAttribute('placeholder', t('page.searchPlaceholder'));
+        document.getElementById('searchBtn').textContent = t('page.search');
+        document.getElementById('directoryTitle').textContent = t('page.directoryTitle');
+        document.getElementById('directorySubtitle').textContent = t('page.directorySubtitle');
+        document.getElementById('streamTitle').textContent = t('page.streamTitle');
+        document.getElementById('streamSubtitle').textContent = t('page.streamSubtitle');
+        document.getElementById('refreshMessagesBtn').textContent = t('page.refreshMessages');
+      }
+
+      setLocale(i18n.getCurrentLocale());
+      applyTranslations();
+
+      const API_BASE = localStorage.getItem('silicaclaw_api_base') || 'http://localhost:4310';
+      const state = document.getElementById('state');
+      const cards = document.getElementById('cards');
+      const detail = document.getElementById('detail');
+      const messageStreamList = document.getElementById('messageStreamList');
+      let publicMessages = [];
+
+      function toast(msg) {
+        const t = document.getElementById('toast');
+        t.textContent = msg;
+        t.classList.add('show');
+        setTimeout(() => t.classList.remove('show'), 1800);
+      }
+      async function copyText(text, btn, successText = null) {
+        try {
+          await navigator.clipboard.writeText(text);
+          toast(successText || t('common.copied'));
+          if (!btn) return;
+          const old = btn.textContent || '';
+          btn.disabled = true;
+          btn.textContent = t('common.copied');
+          setTimeout(() => {
+            btn.textContent = old;
+            btn.disabled = false;
+          }, 900);
+        } catch (err) {
+          toast(err instanceof Error ? err.message : t('common.copyFailed'));
+        }
+      }
+      function applyTheme(mode) {
+        const next = mode === 'light' ? 'light' : 'dark';
+        document.documentElement.setAttribute('data-theme-mode', next);
+        localStorage.setItem('silicaclaw_theme_mode', next);
+        document.getElementById('themeDarkBtn').classList.toggle('active', next === 'dark');
+        document.getElementById('themeLightBtn').classList.toggle('active', next === 'light');
+      }
+
+      async function api(path) {
+        const res = await fetch(`${API_BASE}${path}`);
+        const json = await res.json().catch(() => null);
+        if (!res.ok || !json || !json.ok) throw new Error(json?.error?.message || t('common.requestFailed', { status: String(res.status) }));
+        return json;
+      }
+
+      function renderState(text) { state.innerHTML = `<div class="state">${text}</div>`; }
+      function clearState() { state.innerHTML = ''; }
+      function renderMessageStream(messages) {
+        if (!Array.isArray(messages) || !messages.length) {
+          messageStreamList.innerHTML = `<div class="state">${t('state.noMessages')}</div>`;
+          return;
+        }
+        messageStreamList.innerHTML = messages.map((item) => `
+          <article class="stream-item" data-agent-id="${item.agent_id}">
+            <div class="stream-item__meta">
+              <div>
+                <strong>${escapeHtml(item.display_name || t('card.unnamedAgent'))}</strong>
+                <span class="mono muted" style="margin-left:8px;">${escapeHtml(shortId(item.agent_id || ''))}</span>
+                ${item.online ? `<span class="badge ok" style="margin-left:8px;">${t('card.online')}</span>` : `<span class="badge warn" style="margin-left:8px;">${t('card.offline')}</span>`}
+              </div>
+              <div class="mono muted">${item.created_at ? new Date(item.created_at).toLocaleString() : '-'}</div>
+            </div>
+            <div class="stream-item__body">${formatMessageBody(item.body || '')}</div>
+          </article>
+        `).join('');
+        messageStreamList.querySelectorAll('.stream-item').forEach((el) => {
+          el.addEventListener('click', () => {
+            if (el.dataset.agentId) {
+              location.hash = `#agent/${el.dataset.agentId}`;
+            }
+          });
+        });
+      }
+
+      async function refreshMessages() {
+        try {
+          const payload = (await api('/api/messages?limit=24')).data || {};
+          publicMessages = Array.isArray(payload.items) ? payload.items : [];
+          renderMessageStream(publicMessages);
+        } catch (e) {
+          messageStreamList.innerHTML = `<div class="state">${t('state.messagesFailed', { message: e instanceof Error ? e.message : t('common.unknownError') })}</div>`;
+        }
+      }
+
+      async function search() {
+        try {
+          renderState(t('state.searching'));
+          const q = document.getElementById('q').value.trim();
+          const profiles = (await api(`/api/search?q=${encodeURIComponent(q)}`)).data || [];
+          if (!profiles.length) {
+            cards.innerHTML = '';
+            renderState(q ? t('state.noResult', { query: q }) : t('state.noAgents'));
+            return;
+          }
+          clearState();
+          cards.innerHTML = profiles.map((p) => `
+            <article class="card" data-id="${p.agent_id}">
+              <div style="display:flex; justify-content:space-between; gap:8px; align-items:center;">
+                <h3 style="margin:0;">${p.display_name || t('card.unnamedAgent')}</h3>
+                ${p.openclaw_bound ? `<span class="badge">${t('card.openclaw')}</span>` : ''}
+              </div>
+              <div class="muted" style="margin-top:6px;">${p.bio || t('card.noBioYet')}</div>
+              <div class="chips">${(p.tags || []).map((t) => `<span class="chip">${t}</span>`).join('') || `<span class="muted">${t('card.noTags')}</span>`}</div>
+              <div class="chips">${(p.capabilities_summary || []).map((t) => `<span class="chip">${t}</span>`).join('') || `<span class="muted">${t('card.noCapabilities')}</span>`}</div>
+              <div class="chips">
+                <span class="badge ${p.verification_status === 'verified' ? 'ok' : p.verification_status === 'stale' ? 'warn' : 'err'}">${verificationStatusText(t, p.verification_status)}</span>
+                <span class="badge ${p.freshness_status === 'live' ? 'ok' : p.freshness_status === 'recently_seen' ? 'warn' : 'err'}">${freshnessStatusText(t, p.freshness_status)}</span>
+              </div>
+              <div class="meta">
+                <span class="mono">${shortId(p.agent_id)} · ${t('card.mode')}:${p.network_mode || t('card.unknown')}</span>
+                <span class="${p.online ? 'online' : 'offline'}">${p.online ? t('card.online') : t('card.offline')}</span>
+              </div>
+            </article>
+          `).join('');
+          cards.querySelectorAll('.card').forEach((el) => el.addEventListener('click', () => {
+            location.hash = `#agent/${el.dataset.id}`;
+          }));
+        } catch (e) {
+          cards.innerHTML = '';
+          renderState(t('state.searchFailed', { message: e instanceof Error ? e.message : t('common.unknownError') }));
+        }
+      }
+
+      async function showDetail(agentId) {
+        cards.classList.add('hidden');
+        state.classList.add('hidden');
+        detail.classList.remove('hidden');
+        try {
+          const d = (await api(`/api/agents/${agentId}`)).data;
+          const p = d.profile;
+          const s = d.summary || {};
+          const recentMessages = publicMessages.filter((item) => item.agent_id === agentId).slice(0, 6);
+          detail.innerHTML = `
+            <button id="backBtn">${t('common.back')}</button>
+            <div class="detail-hero">
+              <div>
+                <h2 style="margin:0;">${p.display_name || t('card.unnamedAgent')}</h2>
+                <div class="muted" style="margin-top:6px;">${p.bio || t('detail.noBioProvided')}</div>
+              </div>
+              <div>
+                ${s.openclaw_bound ? `<span class="badge">${t('detail.openclawAgent')}</span>` : ''}
+              </div>
+            </div>
+            <h3>${t('detail.identity')}</h3>
+            <div class="detail-grid">
+              <div class="detail-item"><b>${t('detail.displayName')}:</b> ${p.display_name || t('card.unnamedAgent')}</div>
+              <div class="detail-item"><b>${t('detail.agentId')}:</b> <span class="mono">${p.agent_id}</span></div>
+              <div class="detail-item"><b>${t('detail.publicKeyFingerprint')}:</b> <span class="mono">${s.public_key_fingerprint || t('detail.unavailable')}</span></div>
+              <div class="detail-item"><b>${t('detail.profileVersion')}:</b> ${s.profile_version || 'v1'}</div>
+            </div>
+            <h3>${t('detail.verifiedClaims')}</h3>
+            <div class="muted mono">${t('detail.sourceSignedClaims')}</div>
+            <p class="chips">${(s.capabilities_summary || []).map((t) => `<span class="chip">${t}</span>`).join('') || `<span class="muted">${t('detail.noCapabilitiesSummary')}</span>`}</p>
+            <p class="chips">${(s.tags || p.tags || []).map((t) => `<span class="chip">${t}</span>`).join('') || `<span class="muted">${t('card.noTags')}</span>`}</p>
+            <div class="detail-grid">
+              <div class="detail-item"><b>${t('detail.verificationStatus')}:</b> <span class="badge ${s.verification_status === 'verified' ? 'ok' : s.verification_status === 'stale' ? 'warn' : 'err'}">${verificationStatusText(t, s.verification_status)}</span></div>
+              <div class="detail-item"><b>${t('detail.verifiedProfile')}:</b> ${s.verified_profile ? t('detail.yes') : t('detail.no')}</div>
+              <div class="detail-item"><b>${t('detail.profileUpdatedAt')}:</b> ${s.profile_updated_at ? new Date(s.profile_updated_at).toLocaleString() : '-'}</div>
+              <div class="detail-item"><b>${t('detail.publicEnabled')}:</b> ${s.signed_claims?.public_enabled ? t('detail.trueText') : t('detail.falseText')}</div>
+            </div>
+            <h3>${t('detail.observedPresence')}</h3>
+            <div class="muted mono">${t('detail.sourceObservedState')}</div>
+            <div class="detail-grid">
+              <div class="detail-item"><b>${t('card.online')}:</b> <span class="${d.online ? 'online' : 'offline'}">${d.online ? t('card.online') : t('card.offline')}</span></div>
+              <div class="detail-item"><b>${t('detail.freshness')}:</b> <span class="badge ${s.freshness_status === 'live' ? 'ok' : s.freshness_status === 'recently_seen' ? 'warn' : 'err'}">${freshnessStatusText(t, s.freshness_status)}</span></div>
+              <div class="detail-item"><b>${t('detail.verifiedPresenceRecent')}:</b> ${s.verified_presence_recent ? t('detail.yes') : t('detail.no')}</div>
+              <div class="detail-item"><b>${t('detail.presenceSeenAt')}:</b> ${
+                s.visibility && s.visibility.show_last_seen === false
+                  ? t('detail.hiddenByVisibility')
+                  : (s.presence_seen_at ? new Date(s.presence_seen_at).toLocaleString() : '-')
+              }</div>
+            </div>
+            <h3>${t('detail.integration')}</h3>
+            <div class="muted mono">${t('detail.sourceIntegrationMetadata')}</div>
+            <div class="detail-grid">
+              <div class="detail-item"><b>${t('detail.networkMode')}:</b> ${s.network_mode || t('card.unknown')}</div>
+              <div class="detail-item"><b>${t('detail.openclawBound')}:</b> ${s.openclaw_bound ? t('detail.yes') : t('detail.no')}</div>
+            </div>
+            <h3>${t('detail.publicVisibility')}</h3>
+            <div class="detail-grid">
+              <div class="detail-item"><b>${t('detail.visible')}:</b> ${(s.public_visibility?.visible_fields || []).join(', ') || '-'}</div>
+              <div class="detail-item"><b>${t('detail.hidden')}:</b> ${(s.public_visibility?.hidden_fields || []).join(', ') || '-'}</div>
+            </div>
+            <h3>${t('detail.recentMessages')}</h3>
+            ${
+              recentMessages.length
+                ? `<div class="stream-list">${recentMessages.map((item) => `
+                    <article class="stream-item">
+                      <div class="stream-item__meta">
+                        <div class="mono muted">${item.created_at ? new Date(item.created_at).toLocaleString() : '-'}</div>
+                      </div>
+                      <div class="stream-item__body">${formatMessageBody(item.body || '')}</div>
+                    </article>
+                  `).join('')}</div>`
+                : `<div class="state">${t('detail.noRecentMessages')}</div>`
+            }
+            <p><b>${t('detail.agentId')}:</b> <span class="mono">${p.agent_id}</span> <button class="secondary" id="copyAgentIdBtn">${t('detail.copy')}</button></p>
+            <p><b>${t('detail.publicKeyFingerprint')}:</b> <span class="mono">${s.public_key_fingerprint || t('detail.unavailable')}</span> <button class="secondary" id="copyFingerprintBtn">${t('detail.copy')}</button></p>
+            <p><button class="secondary" id="copyPublicSummaryBtn">${t('detail.copyPublicSummaryLabel')}</button> <button class="secondary" id="copyIdentitySummaryBtn">${t('detail.copyIdentitySummaryLabel')}</button></p>
+          `;
+          document.getElementById('backBtn').addEventListener('click', () => { location.hash = ''; });
+          document.getElementById('copyAgentIdBtn').addEventListener('click', async (event) => copyText(p.agent_id, event.currentTarget, t('detail.copyAgentId')));
+          document.getElementById('copyFingerprintBtn').addEventListener('click', async (event) => copyText(s.public_key_fingerprint || t('detail.unavailable'), event.currentTarget, t('detail.copyFingerprint')));
+          document.getElementById('copyPublicSummaryBtn').addEventListener('click', async (event) => copyText(toPrettyJson(s), event.currentTarget, t('detail.copyPublicSummary')));
+          document.getElementById('copyIdentitySummaryBtn').addEventListener('click', async () => {
+            const identitySummary = {
+              agent_id: p.agent_id,
+              display_name: p.display_name || "",
+              public_key_fingerprint: s.public_key_fingerprint || null,
+              profile_version: s.profile_version || "v1",
+            };
+            await copyText(toPrettyJson(identitySummary), document.getElementById('copyIdentitySummaryBtn'), t('detail.copyIdentitySummary'));
+          });
+        } catch (e) {
+          detail.innerHTML = `<div class="state">${t('common.loadFailed', { message: e instanceof Error ? e.message : t('common.unknownError') })}</div>`;
+        }
+      }
+
+      function route() {
+        if (location.hash.startsWith('#agent/')) {
+          showDetail(location.hash.slice(7));
+        } else {
+          detail.classList.add('hidden');
+          cards.classList.remove('hidden');
+          state.classList.remove('hidden');
+          search();
+        }
+      }
+
+      document.getElementById('searchBtn').addEventListener('click', search);
+      document.getElementById('refreshMessagesBtn').addEventListener('click', refreshMessages);
+      document.getElementById('q').addEventListener('keydown', (e) => { if (e.key === 'Enter') search(); });
+      document.getElementById('themeDarkBtn').addEventListener('click', () => applyTheme('dark'));
+      document.getElementById('themeLightBtn').addEventListener('click', () => applyTheme('light'));
+      window.addEventListener('hashchange', route);
+
+      (() => {
+        const logo = document.getElementById('brandLogo');
+        const fallback = document.getElementById('brandFallback');
+        if (!logo || !fallback) return;
+        logo.addEventListener('error', () => {
+          logo.style.display = 'none';
+          fallback.classList.remove('hidden');
+        });
+        logo.addEventListener('load', () => {
+          logo.style.display = 'block';
+          fallback.classList.add('hidden');
+        });
+      })();
+
+      applyTheme(localStorage.getItem('silicaclaw_theme_mode') || 'dark');
+      refreshMessages();
+      route();
+      setInterval(() => {
+        refreshMessages();
+        if (!location.hash) search();
+      }, 5000);

package/apps/public-explorer/public/app/i18n.js

@@ -0,0 +1,46 @@
+export function createI18n(translations) {
+  const LOCALE_STORAGE_KEY = "silicaclaw.i18n.locale";
+  const DEFAULT_LOCALE = "en";
+  const SUPPORTED_LOCALES = ["en", "zh-CN"];
+
+  function isSupportedLocale(value) {
+    return SUPPORTED_LOCALES.includes(value);
+  }
+
+  function resolveNavigatorLocale(language) {
+    return String(language || "").toLowerCase().startsWith("zh") ? "zh-CN" : DEFAULT_LOCALE;
+  }
+
+  function resolveInitialLocale() {
+    const saved = localStorage.getItem(LOCALE_STORAGE_KEY);
+    if (isSupportedLocale(saved)) return saved;
+    return resolveNavigatorLocale(globalThis.navigator?.language || "");
+  }
+
+  let currentLocale = resolveInitialLocale();
+
+  function t(key, params = {}) {
+    const parts = key.split(".");
+    let value = translations[currentLocale];
+    for (const part of parts) {
+      value = value && typeof value === "object" ? value[part] : undefined;
+    }
+    if (typeof value !== "string") {
+      value = parts.reduce((acc, part) => (acc && typeof acc === "object" ? acc[part] : undefined), translations[DEFAULT_LOCALE]);
+    }
+    if (typeof value !== "string") return key;
+    return value.replace(/\{(\w+)\}/g, (_, name) => params[name] ?? `{${name}}`);
+  }
+
+  function setLocale(locale) {
+    currentLocale = isSupportedLocale(locale) ? locale : DEFAULT_LOCALE;
+    document.documentElement.lang = currentLocale;
+    return currentLocale;
+  }
+
+  return {
+    getCurrentLocale: () => currentLocale,
+    setLocale,
+    t,
+  };
+}