Add architecture comments to content-editor.tsx, markdown-paste.ts, extensions/index.ts, mention-view.tsx, content-editor.css, and preprocess.ts explaining: why single markdown pipeline, why data-pm-slice for paste detection, typography benchmarks, mention card sizing rationale, and what was removed from the old system. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
79 lines
2.6 KiB
TypeScript
79 lines
2.6 KiB
TypeScript
"use client";
|
|
|
|
/**
|
|
* MentionView — NodeView for rendering @mentions inline in the editor.
|
|
*
|
|
* Member/agent mentions: plain "@Name" text with .mention class styling.
|
|
* Issue mentions: inline card with StatusIcon + identifier + title.
|
|
*
|
|
* Issue card sizing: must fit within the paragraph line box (14px * 1.625
|
|
* = 22.75px). Card uses text-xs (12px) + py-0.5 + border ≈ 22px total.
|
|
* vertical-align: middle is set on the [data-node-view-wrapper] in CSS
|
|
* (not on the <a> tag) because the wrapper is the outermost inline element
|
|
* that participates in line box calculation. Setting it on the inner <a>
|
|
* had no effect since the wrapper was already positioned.
|
|
*
|
|
* Fallback: when issue is not in the Zustand store (deleted or other
|
|
* workspace), the same card style is used with just the identifier from
|
|
* fallbackLabel — no visual degradation to a plain text link.
|
|
*/
|
|
|
|
import { NodeViewWrapper } from "@tiptap/react";
|
|
import type { NodeViewProps } from "@tiptap/react";
|
|
import { useIssueStore } from "@/features/issues/store";
|
|
import { StatusIcon } from "@/features/issues/components/status-icon";
|
|
|
|
export function MentionView({ node }: NodeViewProps) {
|
|
const { type, id, label } = node.attrs;
|
|
|
|
if (type === "issue") {
|
|
return (
|
|
<NodeViewWrapper as="span" className="inline">
|
|
<IssueMention issueId={id} fallbackLabel={label} />
|
|
</NodeViewWrapper>
|
|
);
|
|
}
|
|
|
|
return (
|
|
<NodeViewWrapper as="span" className="inline">
|
|
<span className="mention">@{label ?? id}</span>
|
|
</NodeViewWrapper>
|
|
);
|
|
}
|
|
|
|
function IssueMention({
|
|
issueId,
|
|
fallbackLabel,
|
|
}: {
|
|
issueId: string;
|
|
fallbackLabel?: string;
|
|
}) {
|
|
const issue = useIssueStore((s) => s.issues.find((i) => i.id === issueId));
|
|
|
|
const handleClick = (e: React.MouseEvent) => {
|
|
e.preventDefault();
|
|
e.stopPropagation();
|
|
window.open(`/issues/${issueId}`, "_blank", "noopener,noreferrer");
|
|
};
|
|
|
|
const cardClass =
|
|
"issue-mention inline-flex items-center gap-1.5 rounded-md border mx-0.5 px-2 py-0.5 text-xs hover:bg-accent transition-colors cursor-pointer max-w-72";
|
|
|
|
if (!issue) {
|
|
return (
|
|
<a href={`/issues/${issueId}`} onClick={handleClick} className={cardClass}>
|
|
<span className="font-medium text-muted-foreground">
|
|
{fallbackLabel ?? issueId.slice(0, 8)}
|
|
</span>
|
|
</a>
|
|
);
|
|
}
|
|
|
|
return (
|
|
<a href={`/issues/${issueId}`} onClick={handleClick} className={cardClass}>
|
|
<StatusIcon status={issue.status} className="h-3.5 w-3.5 shrink-0" />
|
|
<span className="font-medium text-muted-foreground shrink-0">{issue.identifier}</span>
|
|
<span className="text-foreground truncate">{issue.title}</span>
|
|
</a>
|
|
);
|
|
}
|