Macro is a unified workspace for teams: email, chat, docs, tasks, agents, calls, and CRM — @-linked together with shared AI memory.
TypeScript agentaiai-agentsall-in-onecrmcrm-systememaillinearmcpmessagingnotesnotionofficerustslackslack-alternativestartupstartup-toolstypescriptworkspace
/**
* Comments on a design, as Figma pins them: a thread sits at a point on a
* page, or on a layer (it moves with the layer), and holds replies and a
* resolved state. Pure helpers for anchoring, unread state, and filtering;
* the comments themselves are written and shown by the comment store.
*/
import type { Rect } from '@core/fig-engine/types';
import type { Point } from './camera';
/**
* Where a thread is pinned: a page, and a point relative to a layer's top
* left (in page units), or to the page's origin when `nodeId` is null.
*/
export interface FigCommentAnchor {
pageId: string;
nodeId: string | null;
x: number;
y: number;
}
export interface FigPerson {
id: string;
name: string;
}
export interface FigComment {
id: string;
author: FigPerson;
/** Plain text, for previews and search. */
text: string;
/** Milliseconds since the epoch. */
createdAt: number;
}
/** A thread pinned on the design. */
export interface FigCommentThread {
/** The first comment's id. */
id: string;
anchor: FigCommentAnchor;
resolved: boolean;
/** The first comment, then the latest replies, oldest first. */
comments: FigComment[];
/** Every reply, including those `comments` leaves out. */
replyCount: number;
}
/** The anchor for a comment placed at page point `at` on `node` (or none). */
export function anchorAt(
pageId: string,
at: Point,
node?: { id: string; bounds: Rect }
): FigCommentAnchor {
const round = (v: number) => Math.round(v * 100) / 100;
if (!node) return { pageId, nodeId: null, x: round(at.x), y: round(at.y) };
return {
pageId,
nodeId: node.id,
x: round(at.x - node.bounds.x),
y: round(at.y - node.bounds.y),
};
}
/**
* The page point an anchor pins to, given the bounds of its layer as they
* are now; `undefined` when the layer is gone.
*/
export function anchorPoint(
anchor: FigCommentAnchor,
nodeBounds: ReadonlyMap<string, Rect>
): Point | undefined {
if (!anchor.nodeId) return { x: anchor.x, y: anchor.y };
const b = nodeBounds.get(anchor.nodeId);
if (!b) return undefined;
return { x: b.x + anchor.x, y: b.y + anchor.y };
}
export type CommentFilter = 'open' | 'resolved' | 'all';
export function filterThreads(
threads: readonly FigCommentThread[],
filter: CommentFilter
): FigCommentThread[] {
return threads.filter((t) =>
filter === 'all' ? true : filter === 'resolved' ? t.resolved : !t.resolved
);
}
/** Newest activity first. */
export function byActivity(
threads: readonly FigCommentThread[]
): FigCommentThread[] {
const last = (t: FigCommentThread) => t.comments.at(-1)?.createdAt ?? 0;
return [...threads].sort((a, b) => last(b) - last(a));
}
/**
* Whether a thread has comments by others newer than when this person
* last read it (`seenAt`, ms; absent: never). A person's own comments are
* never unread.
*/
export function isUnread(
thread: FigCommentThread,
me: string | undefined,
seenAt: number | undefined
): boolean {
return thread.comments.some(
(c) => c.author.id !== me && c.createdAt > (seenAt ?? 0)
);
}
/** "Just now", "5m", "3h", "2d", or a date. */
export function relativeTime(at: number, now: number): string {
const s = Math.max(0, Math.round((now - at) / 1000));
if (s < 60) return 'Just now';
if (s < 3600) return `${Math.floor(s / 60)}m`;
if (s < 86400) return `${Math.floor(s / 3600)}h`;
if (s < 7 * 86400) return `${Math.floor(s / 86400)}d`;
return new Date(at).toLocaleDateString();
}
export function initialsOf(name: string): string {
const words = name.trim().split(/\s+/).filter(Boolean);
return (
words
.slice(0, 2)
.map((w) => w[0]?.toUpperCase() ?? '')
.join('') || '?'
);
}