openclaw/ui/src/components/sidebar-build-chip-format.ts

import { truncateUtf16Safe } from "@openclaw/normalization-core/utf16-slice";
import { html, type TemplateResult } from "lit";
import type { ControlUiBuildInfo } from "../build-info.ts";
import { t } from "../i18n/index.ts";
import { formatRelativeTimestamp } from "../lib/format.ts";

const BRANCH_DISPLAY_LENGTH = 14;

function formatBranchPrefix(branch: string | null): string {
  if (!branch || branch === "main") {
    return "";
  }
  const displayBranch =
    branch.length > BRANCH_DISPLAY_LENGTH
      ? `${truncateUtf16Safe(branch, BRANCH_DISPLAY_LENGTH)}…`
      : branch;
  return `${displayBranch}@`;
}

export function formatBuildChipText(info: ControlUiBuildInfo): string | null {
  if (!info.commit) {
    return null;
  }
  const branch = formatBranchPrefix(info.branch);
  const commit = `${info.commit.slice(0, 7)}${info.dirty === true ? "*" : ""}`;
  return `${branch}${commit}`;
}

function formatNonReleaseGitIdentity(info: ControlUiBuildInfo): string | null {
  if (info.release) {
    return null;
  }
  const compactBuild = formatBuildChipText(info);
  if (!compactBuild) {
    return null;
  }
  return info.branch && info.branch !== "main" ? compactBuild : `git@${compactBuild}`;
}

export function formatSidebarBuildSubtitle(info: ControlUiBuildInfo): string | null {
  const gitIdentity = formatNonReleaseGitIdentity(info);
  if (!gitIdentity) {
    return null;
  }
  const commitAt = info.commitAt ? Date.parse(info.commitAt) : Number.NaN;
  return Number.isFinite(commitAt)
    ? `${gitIdentity} · ${formatRelativeTimestamp(commitAt)}`
    : gitIdentity;
}

export function formatSettingsBuildLabel(
  info: ControlUiBuildInfo,
  gatewayVersion: string | null,
): string | null {
  const version = info.version ?? gatewayVersion;
  const gitIdentity = formatNonReleaseGitIdentity(info);
  if (!gitIdentity) {
    return version;
  }
  return [version, gitIdentity].filter((value): value is string => Boolean(value)).join(" · ");
}

function formatBuildCardDetails(info: ControlUiBuildInfo, gatewayVersion: string | null) {
  return {
    summary: [
      info.version ? `v${info.version}` : null,
      info.branch,
      info.dirty === true ? "dirty" : null,
    ]
      .filter((value): value is string => Boolean(value))
      .join(" · "),
    commit: info.commit?.slice(0, 12) ?? null,
    builtAt: info.builtAt,
    gatewayVersion,
  };
}

export function renderSidebarServerDetails(
  info: ControlUiBuildInfo,
  gatewayVersion: string | null,
): TemplateResult {
  const details = formatBuildCardDetails(info, gatewayVersion);
  const unavailable = t("aboutPage.unavailable");
  const rows = [
    { label: t("aboutPage.commit"), value: details.commit ?? unavailable, mono: true },
    { label: t("aboutPage.built"), value: details.builtAt ?? unavailable, mono: false },
    {
      label: t("aboutPage.gatewayVersion"),
      value: details.gatewayVersion ?? unavailable,
      mono: false,
    },
  ];
  return html`
    <div class="sidebar-hover-card__server-details">
      <div class="sidebar-hover-card__summary">${details.summary || unavailable}</div>
      <dl class="sidebar-hover-card__metadata">
        ${rows.map(
          (row) => html`
            <div class="sidebar-hover-card__metadata-row">
              <dt>${row.label}</dt>
              <dd class=${row.mono ? "sidebar-hover-card__metadata-value--mono" : ""}>
                ${row.value}
              </dd>
            </div>
          `,
        )}
      </dl>
    </div>
  `;
}