This repository has been archived on 2026-11-17. You can view files and clone it, but cannot push or open issues or pull requests.
gitgram-ai/gitgram/web/utils/linkify.tsx
caelum0x bfc29616b7 feat: round-7 external harvest (18 features, all products green)
- gitgram-web (4): external link-preview/unfurl cards, rich inline embed players
  (YouTube/Twitch/Spotify/Vimeo)
- gitgram-backend (1): natural-language feed filtering (preferredLangOnly) + Post.contentLanguage
- gitgram-mobile (4): notification grouping/aggregation, shared timeAgo util
- aitm-api (7): GitNexus graph-RAG query + context retrieval endpoints (flagship surface)
- aitm-mcp (2): beads_claim atomic claim-for-work tool + brief-deps projection

Note: gitgram-backend adds Post.contentLanguage — run prisma migrate at deploy.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-28 19:17:27 +03:00

99 lines
3.2 KiB
TypeScript

import { Fragment, type ReactNode } from 'react';
import Link from 'next/link';
import { UserHoverCard } from '@/components/UserHoverCard';
/**
* Matches @mentions and #hashtags in free text.
*
* - A token must be preceded by start-of-string or whitespace so that emails
* (`a@b.com`) and inline code fragments are not mistakenly linkified.
* - The captured word allows letters, numbers, and underscores — matching the
* product's username/hashtag rules (see settings/profile validateUsername and
* ContentComposer.extractHashtags).
*/
const TOKEN_PATTERN = /(^|[\s(])([@#])([A-Za-z0-9_]{1,40})/g;
export interface LinkifyOptions {
/** Tailwind/utility classes applied to each generated link. */
linkClassName?: string;
}
const DEFAULT_LINK_CLASS = 'text-[var(--primary)] hover:underline';
/**
* Builds the destination route for a token.
* Mentions resolve to the user profile route (`/[username]`).
* Hashtags resolve to the hashtag feed route (`/hashtag/[tag]`).
*/
function hrefForToken(char: string, word: string): string {
return char === '#' ? `/hashtag/${encodeURIComponent(word)}` : `/${encodeURIComponent(word)}`;
}
/**
* Converts a plain text string into an array of React nodes where every
* @mention / #hashtag becomes a clickable Next.js <Link>. All other text is
* preserved verbatim (including whitespace), so it is safe to render inside a
* `whitespace-pre-wrap` container.
*
* This performs no HTML parsing — it only ever emits plain strings and Link
* elements, so there is no XSS surface (unlike dangerouslySetInnerHTML-based
* approaches).
*/
export function linkifyText(text: string, options: LinkifyOptions = {}): ReactNode {
const linkClassName = options.linkClassName ?? DEFAULT_LINK_CLASS;
if (!text) return text;
const nodes: ReactNode[] = [];
let lastIndex = 0;
let keyCounter = 0;
// Reset lastIndex defensively since the regex is global and module-scoped.
TOKEN_PATTERN.lastIndex = 0;
let match: RegExpExecArray | null;
while ((match = TOKEN_PATTERN.exec(text)) !== null) {
const [, lead, char, word] = match;
const tokenStart = match.index + lead.length;
// Emit any text (plus the leading separator) before the token.
const precedingText = text.slice(lastIndex, tokenStart);
if (precedingText) {
nodes.push(<Fragment key={`t-${keyCounter++}`}>{precedingText}</Fragment>);
}
const link = (
<Link
href={hrefForToken(char, word)}
className={linkClassName}
// Stop the click from bubbling to parent post/card click handlers.
onClick={(e) => e.stopPropagation()}
>
{char}
{word}
</Link>
);
// Mentions get a profile-preview hover card; hashtags stay as plain links.
nodes.push(
char === '@' ? (
<UserHoverCard key={`l-${keyCounter++}`} username={word}>
{link}
</UserHoverCard>
) : (
<Fragment key={`l-${keyCounter++}`}>{link}</Fragment>
),
);
lastIndex = tokenStart + char.length + word.length;
}
// Trailing text after the final token.
const trailing = text.slice(lastIndex);
if (trailing) {
nodes.push(<Fragment key={`t-${keyCounter++}`}>{trailing}</Fragment>);
}
return nodes;
}