Skip to content

Open-source Grok Bot alternative for named AI teammates. Local-first desktop, web, and mobile clients with per-bot tools, instructions, and memory. Independent fork of T3 Code.

1.9 KB
Raw Blame
export interface ConversationScrollMetrics {
  readonly scrollTop: number;
  readonly scrollHeight: number;
  readonly clientHeight: number;
}

export const CONVERSATION_END_THRESHOLD_PX = 24;

export interface ConversationFollowState {
  readonly followingEnd: boolean;
}

/**
 * `scroll` carries `movedAway` when the reader scrolled toward older messages. Other
 * scroll events come from layout (content growth, clamping, scroll anchoring) or
 * our own pinning, and must never unpin the conversation on their own.
 */
export type ConversationFollowEvent =
  | { readonly type: "user-navigation" }
  | { readonly type: "scroll-to-end" }
  | { readonly type: "scroll"; readonly isAtEnd: boolean; readonly movedAway: boolean };

export function reduceConversationFollowState(
  state: ConversationFollowState,
  event: ConversationFollowEvent,
): ConversationFollowState {
  if (event.type === "user-navigation") return { followingEnd: false };

  if (event.type === "scroll-to-end") return { followingEnd: true };

  if (event.isAtEnd) return { followingEnd: true };

  return event.movedAway ? { followingEnd: false } : state;
}

export function isConversationAtEnd(
  metrics: ConversationScrollMetrics,
  threshold = CONVERSATION_END_THRESHOLD_PX,
): boolean {
  return metrics.scrollHeight - metrics.clientHeight - metrics.scrollTop <= threshold;
}

/**
 * True when a scroll moved toward the start while the content and viewport kept
 * their size. Wheel, drag, keyboard, and jumps to an earlier message all look like
 * this. Layout-driven scrolls (clamping after a shrink, scroll anchoring) always
 * come with a size change.
 */
export function didScrollAwayFromEnd(
  previous: ConversationScrollMetrics,
  next: ConversationScrollMetrics,
): boolean {
  return (
    next.scrollTop < previous.scrollTop - 1 &&
    next.scrollHeight === previous.scrollHeight &&
    next.clientHeight === previous.clientHeight
  );
}