feat(desktop): embed BoosAPI Desktop client as a subproject

Vendor the rebranded BoosAPI Desktop client (Tauri + Vue) into metapi as a monorepo subdirectory under desktop/. Source only — node_modules, dist, Cargo target and the upstream .git history are excluded. desktop/ keeps its own independent Cargo workspace (desktop/src-tauri with crates/*); it is not part of the backend boosapi crate, so a `cargo check` at the metapi root still compiles only the backend. Build the desktop app from desktop/src-tauri per desktop/README.md. Note: app icons are still placeholder assets pending the final BoosAPI logo. The updater signing keys live outside the repo and are not included.
2026-06-22 11:32:57 +08:00
parent d9c78ecc73
commit e0a5f57793
2305 changed files with 449355 additions and 0 deletions
@@ -0,0 +1,124 @@
+export const CHAT_SCROLL_IS_REVERSED = false;
+export const CHAT_AUTO_SCROLL_BOTTOM_THRESHOLD = 8;
+export const CHAT_SCROLL_TO_BOTTOM_VISIBILITY_THRESHOLD = 160;
+export const CHAT_SCROLL_BOX_SELECTOR = '.ant-bubble-list-scroll-box';
+export const CHAT_SCROLL_CONTENT_SELECTOR = '.ant-bubble-list-scroll-content';
+
+export type ChatScrollElements = {
+  scrollBox: HTMLElement | null;
+  scrollContent: HTMLElement | null;
+};
+
+export function resolveChatScrollElements(
+  root: ParentNode | null | undefined,
+  scrollBoxCandidate?: HTMLElement | null,
+): ChatScrollElements {
+  const rootNode = root as Node | null | undefined;
+  const candidateBelongsToRoot = Boolean(
+    scrollBoxCandidate
+      && (!rootNode || rootNode === scrollBoxCandidate || rootNode.contains(scrollBoxCandidate)),
+  );
+  const scrollBox: HTMLElement | null = candidateBelongsToRoot && scrollBoxCandidate
+    ? scrollBoxCandidate
+    : root?.querySelector<HTMLElement>(CHAT_SCROLL_BOX_SELECTOR) ?? null;
+  const scrollContent = scrollBox?.querySelector<HTMLElement>(CHAT_SCROLL_CONTENT_SELECTOR)
+    ?? (scrollBox?.firstElementChild as HTMLElement | null)
+    ?? null;
+
+  return { scrollBox, scrollContent };
+}
+
+export function getDistanceToHistoryTop(
+  scrollHeight: number,
+  scrollTop: number,
+  clientHeight: number,
+  isReversed: boolean,
+) {
+  return isReversed ? scrollHeight + scrollTop - clientHeight : scrollTop;
+}
+
+export function getScrollTopAfterPrepend(
+  previousScrollTop: number,
+  previousScrollHeight: number,
+  nextScrollHeight: number,
+  isReversed: boolean,
+) {
+  const heightDelta = Math.max(0, nextScrollHeight - previousScrollHeight);
+  return isReversed
+    ? previousScrollTop - heightDelta
+    : previousScrollTop + heightDelta;
+}
+
+export type ScrollLayoutMetrics = {
+  scrollHeight: number;
+  clientHeight: number;
+};
+
+export function hasScrollLayoutMetricsChanged(
+  previous: ScrollLayoutMetrics,
+  next: ScrollLayoutMetrics,
+  threshold = 1,
+) {
+  return Math.abs(next.scrollHeight - previous.scrollHeight) > threshold
+    || Math.abs(next.clientHeight - previous.clientHeight) > threshold;
+}
+
+export function hasMeasuredScrollLayout(metrics: ScrollLayoutMetrics) {
+  return metrics.scrollHeight > 0 && metrics.clientHeight > 0;
+}
+
+export function hasMeasuredScrollLayoutChanged(
+  previous: ScrollLayoutMetrics,
+  next: ScrollLayoutMetrics,
+  threshold = 1,
+) {
+  return hasMeasuredScrollLayout(previous)
+    && hasScrollLayoutMetricsChanged(previous, next, threshold);
+}
+
+export function shouldStickToBottomOnLayoutChange(
+  previous: ScrollLayoutMetrics,
+  next: ScrollLayoutMetrics,
+  wasStickingToBottom: boolean,
+  hadRecentUserScrollIntent = false,
+  threshold = 1,
+) {
+  return wasStickingToBottom
+    && !hadRecentUserScrollIntent
+    && hasMeasuredScrollLayoutChanged(previous, next, threshold);
+}
+
+export function shouldIgnoreScrollDepartureFromBottom(
+  keepAutoScroll: boolean,
+  wasStickingToBottom: boolean,
+  hadRecentUserScrollIntent: boolean,
+  hasLayoutChanged: boolean,
+) {
+  return !keepAutoScroll && wasStickingToBottom && !hadRecentUserScrollIntent && hasLayoutChanged;
+}
+
+export function shouldShowScrollToBottom(
+  scrollHeight: number,
+  scrollTop: number,
+  clientHeight: number,
+  isReversed: boolean,
+  threshold = CHAT_SCROLL_TO_BOTTOM_VISIBILITY_THRESHOLD,
+) {
+  if (isReversed) {
+    return scrollTop < -threshold;
+  }
+  return scrollHeight - clientHeight - scrollTop > threshold;
+}
+
+export function shouldKeepAutoScroll(
+  scrollHeight: number,
+  scrollTop: number,
+  clientHeight: number,
+  isReversed: boolean,
+  threshold = CHAT_AUTO_SCROLL_BOTTOM_THRESHOLD,
+) {
+  if (isReversed) {
+    return scrollTop >= -threshold;
+  }
+  return scrollHeight - clientHeight - scrollTop <= threshold;
+}