@iasiv5/dsh-skins 1.2.3 → 1.3.0

package/lib/client.js

@@ -808,294 +808,6 @@ ${darkSelector}{${dark.join(";")}}`;
     };
   }
 
-  // src/client/host-errors.js
-  var HOST_ERROR_KEYS = {
-    RESTART_UNAVAILABLE: "host.restart.unavailable",
-    NO_PENDING_UPDATE: "host.restart.noPending",
-    RESTART_SAFETY_UNKNOWN: "update.restart.unknown",
-    AGENTS_RUNNING: "update.restart.blocked",
-    UPDATE_LINK_PROTECTED: "host.update.linkProtected",
-    UPDATE_SOURCE_UNSUPPORTED: "host.update.sourceUnsupported",
-    UPDATE_ALREADY_LATEST: "host.update.alreadyLatest",
-    UPDATE_SOURCE_CHANGED: "host.update.sourceChanged",
-    UPDATE_COMMAND_FAILED: "host.update.commandFailed",
-    UPDATE_COMMAND_TIMEOUT: "host.update.commandTimeout",
-    REGISTRY_CHECK_FAILED: "host.registry.checkFailed",
-    REGISTRY_NAME_MISMATCH: "host.registry.nameMismatch",
-    REGISTRY_VERSION_INVALID: "host.registry.versionInvalid",
-    REGISTRY_INTEGRITY_MISSING: "host.registry.integrityMissing",
-    RELEASE_MANIFEST_MISSING: "host.release.manifestMissing",
-    RELEASE_NAME_MISMATCH: "host.release.nameMismatch",
-    RELEASE_VERSION_MISMATCH: "host.release.versionMismatch",
-    RELEASE_REPOSITORY_MISMATCH: "host.release.repoMismatch",
-    RELEASE_NOT_WEB_PLUGIN: "host.release.notWebPlugin",
-    RELEASE_NO_BUNDLE_PATCH: "host.release.noBundlePatch",
-    PROFILE_NOT_PINNED: "host.profile.notPinned",
-    PROFILE_BUNDLE_MISSING: "host.profile.bundleMissing",
-    ROLLBACK_LOCKFILE_MISMATCH: "host.rollback.lockfileMismatch",
-    ROLLBACK_BUNDLE_MISSING: "host.rollback.bundleMissing",
-    UPLOAD_TOO_LARGE: "host.personalization.tooLarge",
-    // UPLOAD_TIMEOUT: client-side fetch abort (config-client uploadImage).
-    // UPLOAD_FAILED (any other rejected upload fetch) is intentionally unmapped —
-    // resolveHostErrorText falls back to the panel's generic uploadFailed copy.
-    UPLOAD_TIMEOUT: "host.personalization.uploadTimeout",
-    UNSUPPORTED_IMAGE: "host.personalization.unsupportedImage",
-    ANIMATION_UNSUPPORTED: "host.personalization.animatedWebp",
-    DISK_FULL: "host.personalization.diskFull",
-    FILENAME_INVALID: "host.personalization.invalidFilename",
-    ASSET_NOT_FOUND: "host.personalization.assetMissing",
-    INVALID_CONFIG: "host.personalization.invalidConfig",
-    STORE_READONLY: "host.personalization.readonly",
-    STORE_RECOVERY_REQUIRED: "host.personalization.recoveryRequired",
-    UNKNOWN_SKIN: "host.personalization.unknownSkin"
-  };
-  function safeTr(tr, key, params) {
-    if (typeof tr !== "function") return key;
-    const text = tr(key, params);
-    return typeof text === "string" ? text : key;
-  }
-  function resolveHostErrorText(value, tr) {
-    if (value === null || value === void 0 || value === "") return "";
-    if (typeof value === "string") return value;
-    const key = value.code === void 0 ? void 0 : HOST_ERROR_KEYS[value.code];
-    if (key !== void 0) {
-      const text = safeTr(tr, key, value.params ?? {});
-      if (text !== key) return text;
-    }
-    return value.text ?? value.message ?? String(value);
-  }
-  function resolveFailedOperationText(operation, tr) {
-    if (operation === null || operation === void 0) return "";
-    const base = resolveHostErrorText({ code: operation.code, params: operation.params, text: operation.message }, tr);
-    const rollback = operation.rollbackError;
-    if (rollback === null || rollback === void 0) return base;
-    const reason = resolveHostErrorText(rollback, tr);
-    const suffix = safeTr(tr, "host.update.rollbackSuffix", { reason });
-    return suffix === "host.update.rollbackSuffix" ? `${base}；自动回滚失败：${reason}` : base + suffix;
-  }
-
-  // src/client/update-panel.js
-  var UPDATE_ENDPOINT = "/dsh-skins/update";
-  var RESTART_ENDPOINT = "/dsh-skins/restart";
-  var TERMINAL_PHASES = /* @__PURE__ */ new Set(["done", "failed"]);
-  var UPDATE_CSS = [
-    ".dsh-skins-update-row{box-sizing:border-box;display:flex;align-items:center;justify-content:space-between;gap:10px;margin-top:4px;padding:12px 4px 0;border-top:1px solid var(--dsw-alias-border-l2);font-size:12px;line-height:17px}",
-    ".dsh-skins-update-row-muted{display:block;min-width:0;color:var(--dsw-alias-label-secondary,#5f6368);font-size:11px;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}",
-    ".dsh-skins-update-copy{display:flex;min-width:0;flex:1;flex-direction:column;align-items:flex-start;gap:2px;color:var(--dsw-alias-label-secondary)}",
-    ".dsh-skins-update-copy strong{color:var(--dsw-alias-label-primary);font-size:13px;font-weight:600}",
-    ".dsh-skins-update-copy a{color:var(--dsw-alias-brand-text);text-decoration:none}",
-    ".dsh-skins-update-copy a:hover{text-decoration:underline}",
-    ".dsh-skins-update-actions{display:flex;flex:none;align-items:center;gap:6px}",
-    ".dsh-skins-update-actions button,.dsh-skins-update-error>button{height:30px;padding:0 10px;border:1px solid var(--dsw-alias-border-l2);border-radius:8px;background:var(--dsw-alias-bg-layer-1);color:var(--dsw-alias-label-primary);font:inherit;cursor:pointer}",
-    ".dsh-skins-update-actions button:hover,.dsh-skins-update-error>button:hover{background:var(--dsw-alias-interactive-bg-hover)}",
-    ".dsh-skins-update-actions button:disabled{opacity:.55;cursor:default}",
-    ".dsh-skins-update-error,.dsh-skins-update-error-text{color:var(--dsw-alias-error-text,var(--dsw-static-red-500,#d33))}"
-  ].join("\n");
-  function toPanelError(error) {
-    return {
-      text: error instanceof Error ? error.message : String(error),
-      ...error?.code === void 0 ? {} : { code: error.code },
-      ...error?.params === void 0 ? {} : { params: error.params }
-    };
-  }
-  async function json(url, options) {
-    const response = await fetch(url, options);
-    const value = await response.json().catch(() => ({}));
-    if (!response.ok) {
-      const error = new Error(value.error || `HTTP ${response.status}`);
-      if (value.code !== void 0) error.code = value.code;
-      if (value.params !== void 0 && value.params !== null) error.params = value.params;
-      throw error;
-    }
-    return value;
-  }
-  function createOperationPoller(options) {
-    const schedule = options.schedule ?? setTimeout;
-    const cancel = options.cancel ?? clearTimeout;
-    const delay = options.delay ?? 450;
-    let active = false;
-    let timer;
-    const tick = async () => {
-      if (!active) return;
-      const status = await options.loadStatus();
-      const phase = status?.operation?.phase;
-      if (active && phase && !TERMINAL_PHASES.has(phase)) timer = schedule(tick, delay);
-    };
-    return {
-      start() {
-        if (active) return;
-        active = true;
-        timer = schedule(tick, delay);
-      },
-      stop() {
-        active = false;
-        if (timer !== void 0) cancel(timer);
-        timer = void 0;
-      }
-    };
-  }
-  function createUpdatePanel({ jsx, react }) {
-    const phaseKey = (phase) => `update.phase.${phase ?? "checking"}`;
-    function UpdatePanel({ open, tr }) {
-      const [view, setView] = react.useState({ kind: "idle", status: null, error: null });
-      const [restartConfirm, setRestartConfirm] = react.useState(false);
-      const [confirmUnknown, setConfirmUnknown] = react.useState(false);
-      const [restarting, setRestarting] = react.useState(false);
-      const [restartDeferred, setRestartDeferred] = react.useState(false);
-      const loadStatus = react.useCallback(async (force = false, quiet = false) => {
-        if (!quiet) setView((current) => ({ ...current, kind: "checking", error: null }));
-        try {
-          const status2 = await json(`${UPDATE_ENDPOINT}${force ? "?force=1" : ""}`, force ? {
-            headers: { "x-dsh-skins-force": "1" }
-          } : void 0);
-          setView({ kind: "ready", status: status2, error: null });
-          return status2;
-        } catch (error) {
-          setView({ kind: "error", status: null, error: toPanelError(error) });
-          return null;
-        }
-      }, []);
-      react.useEffect(() => {
-        if (!open) return void 0;
-        void loadStatus(false);
-        return void 0;
-      }, [open, loadStatus]);
-      const operationPhase = view.status?.operation?.phase;
-      react.useEffect(() => {
-        if (!open || !operationPhase || TERMINAL_PHASES.has(operationPhase)) return void 0;
-        const poller = createOperationPoller({ loadStatus: () => loadStatus(false, true) });
-        poller.start();
-        return poller.stop;
-      }, [open, operationPhase, loadStatus]);
-      const startUpdate = async () => {
-        setView((current) => ({ ...current, kind: "updating", error: null }));
-        try {
-          const started = await json(UPDATE_ENDPOINT, {
-            method: "POST",
-            headers: { "content-type": "application/json" },
-            body: "{}"
-          });
-          setView((current) => ({
-            ...current,
-            kind: "updating",
-            status: current.status === null ? { operation: started.operation } : { ...current.status, operation: started.operation }
-          }));
-        } catch (error) {
-          setView((current) => ({ ...current, kind: "error", error: toPanelError(error) }));
-        }
-      };
-      const waitForReplacement = () => {
-        const startedAt = Date.now();
-        const probe = async () => {
-          try {
-            const response = await fetch(`/?dsh-skins-restart=${Date.now()}`, { cache: "no-store" });
-            if (response.ok && Date.now() - startedAt > 1e3) {
-              window.location.reload();
-              return;
-            }
-          } catch {
-          }
-          if (Date.now() - startedAt < 3e4) setTimeout(probe, 700);
-        };
-        setTimeout(probe, 900);
-      };
-      const restartNow = async () => {
-        const safety = view.status?.restartSafety;
-        if (safety?.state === "blocked") {
-          setView((current) => ({ ...current, error: tr("update.restart.blocked", { count: safety.running ?? 1 }) }));
-          return;
-        }
-        if (safety?.state === "unknown" && !confirmUnknown) {
-          setConfirmUnknown(true);
-          setView((current) => ({ ...current, error: tr("update.restart.unknown") }));
-          return;
-        }
-        setRestarting(true);
-        try {
-          await json(RESTART_ENDPOINT, {
-            method: "POST",
-            headers: { "content-type": "application/json" },
-            body: JSON.stringify({ confirmUnknown })
-          });
-          waitForReplacement();
-        } catch (error) {
-          setRestarting(false);
-          setView((current) => ({ ...current, error: toPanelError(error) }));
-        }
-      };
-      const status = view.status;
-      const operation = status?.operation;
-      const sourceKind = status?.source?.kind;
-      const showDevelopment = sourceKind === "link";
-      const showUnsupported = sourceKind === "file" || sourceKind === "github" || sourceKind === "unknown";
-      const showOperation = operation !== null && operation !== void 0;
-      const showAvailable = status?.updateAvailable === true;
-      const showRestart = status?.restartRequired === true || operation?.phase === "done";
-      if (view.kind === "idle") return null;
-      if (view.kind === "checking" && status === null) {
-        return jsx("div", { className: "dsh-skins-update-row", children: tr("update.checking") });
-      }
-      if (view.kind === "error" && status === null) {
-        return jsx("div", { className: "dsh-skins-update-row dsh-skins-update-error", children: [
-          jsx("span", { children: resolveHostErrorText(view.error, tr) || tr("update.checkFailed") }),
-          jsx("button", { type: "button", onClick: () => void loadStatus(true), children: tr("update.retry") })
-        ] });
-      }
-      if (showDevelopment) {
-        const line = tr(showAvailable ? "update.developmentNewer" : "update.developmentCurrent", {
-          current: status.currentVersion,
-          latest: status.latest?.version ?? "—"
-        });
-        return jsx("div", {
-          className: "dsh-skins-update-row dsh-skins-update-row-muted",
-          title: line,
-          children: line
-        });
-      }
-      if (showUnsupported) {
-        return jsx("div", { className: "dsh-skins-update-row", children: [
-          jsx("div", { className: "dsh-skins-update-copy", children: [
-            jsx("strong", { children: tr("update.unsupported") }),
-            jsx("span", { children: tr("update.unsupportedHint") })
-          ] })
-        ] });
-      }
-      if (!showAvailable && !showOperation && !showRestart && view.error === null) return null;
-      const running = showOperation && !TERMINAL_PHASES.has(operation.phase);
-      const failed = operation?.phase === "failed";
-      const release = operation?.release ?? status?.latest;
-      const phaseLabel = running ? tr(phaseKey(operation.phase)) : null;
-      return jsx("div", { className: `dsh-skins-update-row${failed || view.error ? " dsh-skins-update-error" : ""}`, children: [
-        jsx("div", { className: "dsh-skins-update-copy", children: [
-          jsx("strong", { children: showRestart ? tr("update.installed") : failed ? tr("update.failed") : tr("update.available") }),
-          jsx("span", { children: running ? phaseLabel : showRestart ? tr("update.restartRequired", { version: release?.version ?? status?.latest?.version ?? "" }) : failed ? resolveFailedOperationText(operation, tr) : tr("update.versions", { current: status?.currentVersion ?? "", latest: status?.latest?.version ?? "" }) }),
-          view.error ? jsx("span", { className: "dsh-skins-update-error-text", children: resolveHostErrorText(view.error, tr) }) : null,
-          release?.htmlUrl ? jsx("a", {
-            href: release.htmlUrl,
-            target: "_blank",
-            rel: "noreferrer",
-            children: tr("update.releaseNotes")
-          }) : null
-        ] }),
-        jsx("div", {
-          className: "dsh-skins-update-actions",
-          children: running ? jsx("span", { className: "dsh-skins-update-spinner", "aria-hidden": "true" }) : showRestart ? restartDeferred ? jsx("span", { children: tr("update.deferred") }) : restartConfirm ? [
-            jsx("button", { type: "button", disabled: restarting, onClick: () => void restartNow(), children: restarting ? tr("update.restarting") : confirmUnknown ? tr("update.confirmUnknown") : tr("update.confirmRestart") }),
-            jsx("button", { type: "button", disabled: restarting, onClick: () => {
-              setRestartConfirm(false);
-              setConfirmUnknown(false);
-              setRestartDeferred(true);
-            }, children: tr("update.later") })
-          ] : status?.restartAvailable === true ? [
-            jsx("button", { type: "button", onClick: () => setRestartConfirm(true), children: tr("update.restartNow") }),
-            jsx("button", { type: "button", onClick: () => setRestartDeferred(true), children: tr("update.later") })
-          ] : jsx("span", { children: tr("update.restartManual") }) : jsx("button", { type: "button", onClick: () => void startUpdate(), disabled: status?.canUpdate !== true && !failed, children: failed ? tr("update.retry") : tr("update.action") })
-        })
-      ] });
-    }
-    return UpdatePanel;
-  }
-
   // src/client/dicts.js
   var NS = "dsh-skins.ui";
   var DICTS = {
@@ -1108,35 +820,6 @@ ${darkSelector}{${dark.join(";")}}`;
       "appearance.light": "浅色",
       "appearance.dark": "深色",
       "appearance.system": "跟随系统",
-      "update.checking": "正在检查更新…",
-      "update.checkFailed": "暂时无法检查更新",
-      "update.retry": "重试",
-      "update.developmentCurrent": "本地开发模式 - v{current}（最新正式版 v{latest}）",
-      "update.developmentNewer": "本地开发模式 - v{current}（可更新至 v{latest}）",
-      "update.unsupported": "当前安装来源不支持在线更新",
-      "update.unsupportedHint": "仅 npm 安装的 @iasiv5/dsh-skins 支持一键更新",
-      "update.available": "发现插件更新",
-      "update.versions": "v{current} → v{latest}",
-      "update.releaseNotes": "查看版本说明",
-      "update.action": "更新",
-      "update.failed": "更新失败",
-      "update.installed": "更新已安装",
-      "update.restartRequired": "v{version} 将在重启 DSH Web 后生效",
-      "update.restartNow": "立即重启",
-      "update.confirmRestart": "确认重启",
-      "update.confirmUnknown": "仍要重启",
-      "update.later": "稍后",
-      "update.deferred": "已选择稍后重启",
-      "update.restartManual": "请手动重启 DSH Web",
-      "update.restarting": "正在重启…",
-      "update.restart.blocked": "检测到 {count} 个 Agent 正在运行，请稍后重试",
-      "update.restart.unknown": "无法确认 Agent 状态；再次点击“仍要重启”表示你确认继续",
-      "update.phase.queued": "更新已排队",
-      "update.phase.checking": "正在检查最新正式版本…",
-      "update.phase.preparing": "正在验证 npm 版本元数据…",
-      "update.phase.installing": "正在下载安装…",
-      "update.phase.validating": "正在校验安装结果…",
-      "update.phase.rollback": "更新失败，正在恢复原版本…",
       // Personalization surface (1.0.0)
       "personalization.title": "个性化",
       "personalization.collapse": "收起个性化面板",
@@ -1197,33 +880,7 @@ ${darkSelector}{${dark.join(";")}}`;
       "host.personalization.readonly": "配置为更高版本创建，当前只读",
       "host.personalization.recoveryRequired": "配置状态待恢复，请先在个性化面板确认恢复",
       "host.personalization.unknownSkin": "皮肤不存在",
-      "host.personalization.uploadTimeout": "上传超时，请检查网络后重试",
-      // Host-reported errors, keyed by the stable `code` the Host attaches to
-      // every user-facing error (see host-errors.js HOST_ERROR_KEYS). The Host keeps a zh
-      // fallback message; the client renders the localized template instead.
-      "host.restart.unavailable": "当前 DSH Host 不支持自重启",
-      "host.restart.noPending": "当前没有等待重启应用的更新",
-      "host.update.linkProtected": "本地 link 开发模式不会被在线更新覆盖",
-      "host.update.sourceUnsupported": "当前安装来源不支持一键更新",
-      "host.update.alreadyLatest": "已经是最新正式版本",
-      "host.update.sourceChanged": "更新开始前安装来源已变化，请重新打开主题切换器",
-      "host.update.commandFailed": "DSH 插件更新失败（exit {exitCode}）：{output}",
-      "host.update.commandTimeout": "DSH 插件更新超时",
-      "host.update.rollbackSuffix": "；自动回滚失败：{reason}",
-      "host.registry.checkFailed": "npm registry 更新检查失败（HTTP {status}）",
-      "host.registry.nameMismatch": "npm registry 返回的包名异常，应是 {expected}",
-      "host.registry.versionInvalid": "npm registry latest 不是严格 X.Y.Z 版本：{version}",
-      "host.registry.integrityMissing": "npm registry 版本元数据缺少完整性校验（dist.integrity）",
-      "host.release.manifestMissing": "发布的包缺少 package.json",
-      "host.release.nameMismatch": "发布的包名必须是 {expected}",
-      "host.release.versionMismatch": "发布版本 v{tag} 与包版本 {version} 不一致",
-      "host.release.repoMismatch": "发布的包仓库必须是 {repository}",
-      "host.release.notWebPlugin": "发布的包不是 DSH Web 客户端插件",
-      "host.release.noBundlePatch": "发布的包未声明 DSH bundle patch",
-      "host.profile.notPinned": "profile 未固定到已验证的精确版本",
-      "host.profile.bundleMissing": "profile 未注册 dsh-skins bundle",
-      "host.rollback.lockfileMismatch": "恢复后的版本锁定校验失败",
-      "host.rollback.bundleMissing": "恢复后的 bundle 注册校验失败"
+      "host.personalization.uploadTimeout": "上传超时，请检查网络后重试"
     },
     en: {
       "skins.switch": "Theme Switcher",
@@ -1234,35 +891,6 @@ ${darkSelector}{${dark.join(";")}}`;
       "appearance.light": "Light",
       "appearance.dark": "Dark",
       "appearance.system": "System",
-      "update.checking": "Checking for updates…",
-      "update.checkFailed": "Unable to check for updates",
-      "update.retry": "Retry",
-      "update.developmentCurrent": "Local development mode - v{current} (latest release v{latest})",
-      "update.developmentNewer": "Local development mode - v{current} (update available: v{latest})",
-      "update.unsupported": "This install source cannot update online",
-      "update.unsupportedHint": "One-click update is available only for npm installs of @iasiv5/dsh-skins",
-      "update.available": "Plugin update available",
-      "update.versions": "v{current} → v{latest}",
-      "update.releaseNotes": "Release notes",
-      "update.action": "Update",
-      "update.failed": "Update failed",
-      "update.installed": "Update installed",
-      "update.restartRequired": "v{version} will take effect after DSH Web restarts",
-      "update.restartNow": "Restart now",
-      "update.confirmRestart": "Confirm restart",
-      "update.confirmUnknown": "Restart anyway",
-      "update.later": "Later",
-      "update.deferred": "Restart deferred",
-      "update.restartManual": "Restart DSH Web manually",
-      "update.restarting": "Restarting…",
-      "update.restart.blocked": "{count} Agent(s) are running; try again later",
-      "update.restart.unknown": "Agent status is unavailable; click Restart anyway again to confirm",
-      "update.phase.queued": "Update queued",
-      "update.phase.checking": "Checking the latest stable release…",
-      "update.phase.preparing": "Verifying npm version metadata…",
-      "update.phase.installing": "Downloading and installing…",
-      "update.phase.validating": "Validating the installation…",
-      "update.phase.rollback": "Update failed; restoring the previous version…",
       // Personalization surface (1.0.0)
       "personalization.title": "Personalize",
       "personalization.collapse": "Collapse personalization panel",
@@ -1323,30 +951,7 @@ ${darkSelector}{${dark.join(";")}}`;
       "host.personalization.readonly": "Created by a newer config version; read-only",
       "host.personalization.recoveryRequired": "Configuration needs recovery; confirm it in the personalization panel first",
       "host.personalization.unknownSkin": "Skin not found",
-      "host.personalization.uploadTimeout": "Upload timed out; check your connection and retry",
-      "host.restart.unavailable": "This DSH Host cannot restart itself",
-      "host.restart.noPending": "No update is waiting to be applied by a restart",
-      "host.update.linkProtected": "Local link development installs are never overwritten by online updates",
-      "host.update.sourceUnsupported": "The current install source does not support one-click updates",
-      "host.update.alreadyLatest": "Already on the latest stable release",
-      "host.update.sourceChanged": "The install source changed before the update started; reopen the theme switcher",
-      "host.update.commandFailed": "DSH plugin update failed (exit {exitCode}): {output}",
-      "host.update.commandTimeout": "DSH plugin update timed out",
-      "host.update.rollbackSuffix": "; automatic rollback failed: {reason}",
-      "host.registry.checkFailed": "npm registry update check failed (HTTP {status})",
-      "host.registry.nameMismatch": "npm registry returned an unexpected package name; expected {expected}",
-      "host.registry.versionInvalid": "npm registry latest is not a strict X.Y.Z version: {version}",
-      "host.registry.integrityMissing": "npm registry version metadata lacks a dist.integrity digest",
-      "host.release.manifestMissing": "The published package is missing package.json",
-      "host.release.nameMismatch": "The published package name must be {expected}",
-      "host.release.versionMismatch": "Published version v{tag} does not match package version {version}",
-      "host.release.repoMismatch": "The published package repository must be {repository}",
-      "host.release.notWebPlugin": "The published package is not a DSH Web client plugin",
-      "host.release.noBundlePatch": "The published package does not declare a DSH bundle patch",
-      "host.profile.notPinned": "Profile is not pinned to the verified exact version",
-      "host.profile.bundleMissing": "Profile does not register the dsh-skins bundle",
-      "host.rollback.lockfileMismatch": "Restored profile failed exact-version verification",
-      "host.rollback.bundleMissing": "Restored profile failed bundle registration verification"
+      "host.personalization.uploadTimeout": "Upload timed out; check your connection and retry"
     }
   };
   function formatTemplate(template, params = {}) {
@@ -1356,6 +961,39 @@ ${darkSelector}{${dark.join(";")}}`;
     );
   }
 
+  // src/client/host-errors.js
+  var HOST_ERROR_KEYS = {
+    UPLOAD_TOO_LARGE: "host.personalization.tooLarge",
+    // UPLOAD_TIMEOUT: client-side fetch abort (config-client uploadImage).
+    // UPLOAD_FAILED (any other rejected upload fetch) is intentionally unmapped —
+    // resolveHostErrorText falls back to the panel's generic uploadFailed copy.
+    UPLOAD_TIMEOUT: "host.personalization.uploadTimeout",
+    UNSUPPORTED_IMAGE: "host.personalization.unsupportedImage",
+    ANIMATION_UNSUPPORTED: "host.personalization.animatedWebp",
+    DISK_FULL: "host.personalization.diskFull",
+    FILENAME_INVALID: "host.personalization.invalidFilename",
+    ASSET_NOT_FOUND: "host.personalization.assetMissing",
+    INVALID_CONFIG: "host.personalization.invalidConfig",
+    STORE_READONLY: "host.personalization.readonly",
+    STORE_RECOVERY_REQUIRED: "host.personalization.recoveryRequired",
+    UNKNOWN_SKIN: "host.personalization.unknownSkin"
+  };
+  function safeTr(tr, key, params) {
+    if (typeof tr !== "function") return key;
+    const text = tr(key, params);
+    return typeof text === "string" ? text : key;
+  }
+  function resolveHostErrorText(value, tr) {
+    if (value === null || value === void 0 || value === "") return "";
+    if (typeof value === "string") return value;
+    const key = value.code === void 0 ? void 0 : HOST_ERROR_KEYS[value.code];
+    if (key !== void 0) {
+      const text = safeTr(tr, key, value.params ?? {});
+      if (text !== key) return text;
+    }
+    return value.text ?? value.message ?? String(value);
+  }
+
   // src/client/personalization/panel.js
   var PANEL_CSS = [
     // Panel header collapse control (v1.0.0 ruling): ghost icon button in the
@@ -1414,7 +1052,7 @@ ${darkSelector}{${dark.join(";")}}`;
     ".dsh-skins-pz-del{position:absolute;top:4px;right:4px;width:22px;height:22px;display:flex;align-items:center;justify-content:center;padding:0;border:0;border-radius:50%;background:rgba(0,0,0,.55);color:#fff;font:inherit;font-size:14px;line-height:1;cursor:pointer}",
     ".dsh-skins-pz-del:hover{background:rgba(0,0,0,.78)}",
     ".dsh-skins-pz-del:disabled{opacity:.55;cursor:default}",
-    ".dsh-skins-pz-del .dsh-skins-update-spinner{width:12px;height:12px;border-width:2px}",
+    ".dsh-skins-pz-del .dsh-skins-spinner{width:12px;height:12px;border-width:2px}",
     ".dsh-skins-pz-rowbtns{display:flex;gap:6px;flex-wrap:wrap}",
     ".dsh-skins-pz-actions{position:sticky;bottom:0;z-index:1;display:flex;align-items:flex-end;justify-content:space-between;gap:8px;flex-wrap:wrap;margin-top:2px;padding:10px 2px 2px;background:var(--dsw-alias-bg-overlay);border-top:1px solid var(--dsw-alias-border-l2)}",
     ".dsh-skins-pz-cluster{display:flex;align-items:center;gap:6px;flex-wrap:wrap;min-width:0}",
@@ -1587,7 +1225,7 @@ ${names}`);
                     disabled: disabled || deletingId !== null,
                     "aria-label": `${tr("personalization.library.delete")}: ${asset.displayName}`,
                     onClick: () => removeAsset(asset),
-                    children: deletingId === asset.id ? jsx("span", { className: "dsh-skins-update-spinner", "aria-hidden": "true" }) : "×"
+                    children: deletingId === asset.id ? jsx("span", { className: "dsh-skins-spinner", "aria-hidden": "true" }) : "×"
                   }, `${asset.id}-del`)
                 ]
               })),
@@ -1919,12 +1557,12 @@ ${names}`);
     ".dsh-skins-pop-card-on,.dsh-skins-pop-card-on:hover{border-color:var(--dsw-alias-brand-primary);background:var(--dsw-alias-bg-module-platform)}",
     ".dsh-skins-pop-card-label{font-size:14px;line-height:20px;font-weight:500}",
     ".dsh-skins-pop-card-desc{font-size:12px;line-height:18px;color:var(--dsw-alias-label-secondary)}",
-    // 【共享原子】.dsh-skins-update-spinner (+ its keyframes and the
-    // reduced-motion opt-out) is shared vocabulary: the update panel AND the
-    // personalization panel's delete badge both render it.
-    ".dsh-skins-update-spinner{width:16px;height:16px;border:2px solid var(--dsw-alias-border-l2);border-top-color:var(--dsw-alias-brand-primary);border-radius:50%;animation:dsh-skins-spin .8s linear infinite}",
+    // 【共享原子】.dsh-skins-spinner (+ its keyframes and the
+    // reduced-motion opt-out) is the personalization panel's delete-badge
+    // loading indicator, styled here with the shell's base atoms.
+    ".dsh-skins-spinner{width:16px;height:16px;border:2px solid var(--dsw-alias-border-l2);border-top-color:var(--dsw-alias-brand-primary);border-radius:50%;animation:dsh-skins-spin .8s linear infinite}",
     "@keyframes dsh-skins-spin{to{transform:rotate(360deg)}}",
-    "@media (prefers-reduced-motion:reduce){.dsh-skins-update-spinner{animation:none}}",
+    "@media (prefers-reduced-motion:reduce){.dsh-skins-spinner{animation:none}}",
     // -- personalization gear + panel -------------------------------------------
     ".dsh-skins-pop-card-row{display:flex;width:100%;min-width:0;gap:6px;align-items:stretch}",
     ".dsh-skins-pop-card-row .dsh-skins-pop-card{flex:1;min-width:0}",
@@ -1991,9 +1629,8 @@ ${names}`);
     // be a HEIGHT, and the stacked panel never reflows horizontally anyway.
     "@media (min-width:905px){.dsh-skins-sweeping.dsh-skins-wide .dsh-skins-pz-panel{flex:0 0 var(--dsh-skins-sweep-panel-basis,700px)}}"
   ].join("\n");
-  var CSS = [SHELL_CSS, PANEL_CSS, UPDATE_CSS].join("\n");
+  var CSS = [SHELL_CSS, PANEL_CSS].join("\n");
   function installSidebarSwitcher(ctx, { runtime, jsx, react, reactDom, configClient, skinsById }) {
-    const UpdatePanel = createUpdatePanel({ jsx, react });
     function fallbackTranslate(key, params = {}) {
       return formatTemplate(DICTS.zh[key] ?? key, params);
     }
@@ -2222,8 +1859,7 @@ ${names}`);
             jsx("div", { key: "grid", className: "dsh-skins-theme-grid", children: themeCards }),
             jsx("div", { key: "d1", className: "dsh-skins-pop-divider", "aria-hidden": "true" }),
             jsx("div", { key: "skins", className: "dsh-skins-pop-title", children: tr("skins.title") }),
-            ...skinCards,
-            jsx(UpdatePanel, { key: "update", open, tr })
+            ...skinCards
           ] }),
           showPersonalization ? jsx("div", {
             key: "panel",