Activity Stream

1"use client";
2 
3import * as React from "react";
4import { motion, AnimatePresence, type Transition } from "motion/react";
5 
6import { cn } from "@/lib/utils";
7import {
8  useReducedMotion,
9  useVisibilityPause,
10  formatTimestamp as defaultFormatTimestamp,
11  statusVars,
12  formatNumber,
13  scrollIntoViewWithin,
14  streamItemVariants,
15  type StatusTone,
16} from "@/lib/motiq";
17 
18/* --------------------------------------------------------------------------
19 * ActivityStream — a collaboration activity feed that is more than a dotted
20 * timeline. It groups repeated actions (collapse/expand), draws date
21 * separators, marks an unread boundary, animates live-arriving items, and
22 * filters by event type (and optional actor).
23 *
24 * Presentation only: the application owns the events array (from any realtime
25 * or history source) and, optionally, the filter state. The component holds no
26 * data of its own — it renders what it is given. Clean-room original.
27 * ----------------------------------------------------------------------- */
28 
29export type ActivityEventType =
30  | "created"
31  | "edited"
32  | "commented"
33  | "mentioned"
34  | "assigned"
35  | "approved"
36  | "rejected"
37  | "uploaded"
38  | "published"
39  | "archived"
40  | "restored"
41  | "joined"
42  | "left";
43 
44export interface ActivityActor {
45  /** Stable identity — drives filtering and avatar hue. */
46  id: string;
47  /** Human name; also the avatar's accessible text. */
48  name: string;
49  /** Optional avatar image; when absent an initials + hue avatar is generated. */
50  avatarUrl?: string;
51  /** Optional explicit avatar color (any CSS color). */
52  color?: string;
53}
54 
55export interface ActivityEvent {
56  /** Stable id — drives React keys and live-arrival animation. */
57  id: string;
58  type: ActivityEventType;
59  actor: ActivityActor;
60  /** What was acted on, e.g. "the onboarding guide". Optional for joined/left. */
61  target?: string;
62  /** Full verb-phrase override, e.g. "renamed". Falls back to the type's verb. */
63  action?: string;
64  timestamp: Date | number | string;
65  /** Free-form metadata rendered as small chips (or via `renderMetadata`). */
66  metadata?: Record<string, string | number>;
67  /** Optional short preview/excerpt (e.g. a comment body). */
68  preview?: string;
69  /** Optional deep link to the target. */
70  link?: string;
71  /** Optional inline action button label (calls `onEventAction`). */
72  actionLabel?: string;
73  /** Override the grouping bucket; defaults to actor + type + target. */
74  groupKey?: string;
75}
76 
77// … truncated