Memos is an open-source, self-hosted note-taking app that brings your everyday thoughts together in a personal timeline. Your data stays yours, and you choose what to keep private or share.
Go dockerfossgomarkdownmemomicroblognote-takingnotesopen-sourceown-your-datareactself-hostedsqlitetimeline
import copy from "copy-to-clipboard";
import {
ChevronDownIcon,
CornerUpLeftIcon,
Edit3Icon,
ImageIcon,
LinkIcon,
MessageCircleIcon,
MessageSquarePlusIcon,
Share2Icon,
} from "lucide-react";
import { useMemo, useState } from "react";
import toast from "react-hot-toast";
import { Link, useLocation } from "react-router-dom";
import SidebarRow, { SIDEBAR_ROW_CLASSES, SIDEBAR_ROW_COUNT_RAIL_CLASSES, SidebarRowIconSlot } from "@/components/AppSidebar/SidebarRow";
import SidebarSection, { SIDEBAR_SECTION_STACK_CLASSES } from "@/components/AppSidebar/SidebarSection";
import { extractHeadings } from "@/components/MemoEditor/view/headings";
import { getRelationBuckets, getRelationMemo } from "@/components/MemoMetadata/Relation/relationHelpers";
import { useResolvedRelationMemos } from "@/components/MemoMetadata/Relation/useResolvedRelationMemos";
import MemoParentPlaceholder, { type MemoParentStatus } from "@/components/MemoParentPlaceholder";
import { createMemoNavigationState } from "@/components/MemoView/navigation";
import { DropdownMenu, DropdownMenuContent, DropdownMenuItem, DropdownMenuTrigger } from "@/components/ui/dropdown-menu";
import { useAuth } from "@/contexts/AuthContext";
import { useInstance } from "@/contexts/InstanceContext";
import { useOverflowTitle } from "@/hooks";
import useCurrentUser from "@/hooks/useCurrentUser";
import { MEMO_COMMENTS_ANCHOR_ID } from "@/lib/memo-comments";
import { isMemoBlurred } from "@/lib/tag";
import { cn } from "@/lib/utils";
import { State } from "@/types/proto/api/common_pb";
import { Memo, type MemoRelation, Visibility } from "@/types/proto/api/memo_service_pb";
import { useTranslate } from "@/utils/i18n";
import { canManageMemo } from "@/utils/user";
import MemoOutline from "./MemoOutline";
import MemoSharePanel from "./MemoSharePanel";
interface Props {
memo: Memo;
parentMemo?: Memo;
parentStatus?: MemoParentStatus;
onParentRetry?: () => void;
parentPage?: string;
commentCount?: number;
className?: string;
onEdit?: () => void;
onCommentsOpen?: () => void;
onCommentCreate?: () => void;
onShareImageOpen?: () => void;
forceReadonly?: boolean;
/** The memo body is tag-blurred and not yet revealed; its outline would leak the headings. */
contentHidden?: boolean;
}
const normalizeSnippet = (value: string): string => value.replace(/\s+/g, " ").trim();
const BacklinkRow = ({
relation,
snippet,
parentPage,
referencedByLabel,
}: {
relation: MemoRelation;
snippet: string;
parentPage?: string;
referencedByLabel: string;
}) => {
const { ref, title } = useOverflowTitle<HTMLSpanElement>(snippet);
const relatedMemo = getRelationMemo(relation, "referenced");
if (!relatedMemo) {
return null;
}
return (
<Link
aria-label={`${referencedByLabel}: ${snippet}`}
className={cn(SIDEBAR_ROW_CLASSES, "text-muted-foreground hover:bg-sidebar-accent/65 hover:text-foreground")}
to={`/${relatedMemo.name}`}
state={parentPage ? createMemoNavigationState(parentPage) : undefined}
title={title}
viewTransition
>
<SidebarRowIconSlot icon={LinkIcon} />
<span ref={ref} className="min-w-0 flex-1 truncate text-start">
{snippet}
</span>
</Link>
);
};
const MemoDetailSidebar = ({
memo,
parentMemo,
parentStatus,
onParentRetry,
parentPage,
commentCount,
className,
onEdit,
onCommentsOpen,
onCommentCreate,
onShareImageOpen,
forceReadonly = false,
contentHidden = false,
}: Props) => {
const t = useTranslate();
const location = useLocation();
const currentUser = useCurrentUser();
const { profile } = useInstance();
const { userTagsSetting } = useAuth();
const [sharePanelOpen, setSharePanelOpen] = useState(false);
const readonly = forceReadonly || !canManageMemo(memo, currentUser);
const canEdit = !!onEdit && !readonly && memo.state === State.NORMAL;
const canComment = !!onCommentCreate && !forceReadonly && !!currentUser && memo.state === State.NORMAL;
const canManageShares =
!forceReadonly &&
!memo.parent &&
canManageMemo(memo, currentUser) &&
memo.state === State.NORMAL &&
memo.visibility !== Visibility.SPACE;
const headings = useMemo(() => (contentHidden ? [] : extractHeadings(memo.content)), [contentHidden, memo.content]);
const { referenced } = useMemo(() => getRelationBuckets(memo.relations, memo.name), [memo.relations, memo.name]);
const backlinkMemoNames = useMemo(
() =>
forceReadonly
? []
: referenced.flatMap((relation) => {
const relatedMemo = getRelationMemo(relation, "referenced");
return relatedMemo?.name ? [relatedMemo.name] : [];
}),
[forceReadonly, referenced],
);
const resolvedMemos = useResolvedRelationMemos(backlinkMemoNames);
const backlinkSnippet = (relation: MemoRelation) => {
const relatedMemo = getRelationMemo(relation, "referenced");
if (!relatedMemo) {
return "";
}
return normalizeSnippet(relatedMemo.snippet || resolvedMemos[relatedMemo.name]?.snippet || relatedMemo.name);
};
const parentBlurred = !!parentMemo && isMemoBlurred(parentMemo, userTagsSetting);
const parentSnippet = parentMemo && !parentBlurred ? normalizeSnippet(parentMemo.snippet || parentMemo.content || parentMemo.name) : "";
const showComments = !forceReadonly && commentCount !== undefined && commentCount > 0;
const showOnThisMemo = headings.length > 1 || showComments;
const showConnections = !forceReadonly && (!!parentMemo || !!parentStatus || referenced.length > 0);
const handleCopyLink = () => {
const host = (profile.instanceUrl || window.location.origin).replace(/\/+$/, "");
const path = forceReadonly ? `${location.pathname}${location.search}` : `/${memo.name}`;
copy(`${host}${path.startsWith("/") ? path : `/${path}`}`);
toast.success(t("message.succeed-copy-link"));
};
return (
<div className={cn("relative w-full select-none", SIDEBAR_SECTION_STACK_CLASSES, className)}>
{showOnThisMemo && (
<SidebarSection label={t("memo.on-this-memo")}>
{headings.length > 1 && <MemoOutline headings={headings} memoName={memo.name} />}
{showComments && (
<a
className={cn(SIDEBAR_ROW_CLASSES, "text-muted-foreground hover:bg-sidebar-accent/65 hover:text-foreground")}
href={`#${MEMO_COMMENTS_ANCHOR_ID}`}
onClick={(event) => {
if (!onCommentsOpen) return;
event.preventDefault();
onCommentsOpen();
}}
>
<SidebarRowIconSlot icon={MessageCircleIcon} />
<span className="min-w-0 flex-1 truncate text-start">{t("memo.comment.self")}</span>
<span className={SIDEBAR_ROW_COUNT_RAIL_CLASSES}>{commentCount}</span>
</a>
)}
</SidebarSection>
)}
{showConnections && (
<SidebarSection label={t("memo.connections")}>
{parentStatus && <MemoParentPlaceholder status={parentStatus} onRetry={onParentRetry} />}
{!parentStatus && parentMemo && (
<Link
aria-label={parentSnippet ? `${t("memo.parent-memo")}: ${parentSnippet}` : t("memo.parent-memo")}
className={cn(SIDEBAR_ROW_CLASSES, "text-muted-foreground hover:bg-sidebar-accent/65 hover:text-foreground")}
to={`/${parentMemo.name}`}
state={parentPage ? createMemoNavigationState(parentPage) : undefined}
title={parentSnippet || undefined}
viewTransition
>
<SidebarRowIconSlot icon={CornerUpLeftIcon} />
<span className="min-w-0 flex-1 truncate text-start">{parentSnippet || t("memo.parent-memo")}</span>
</Link>
)}
{referenced.map((relation) => {
const relatedMemo = getRelationMemo(relation, "referenced");
if (relatedMemo && resolvedMemos[relatedMemo.name] === null) return null;
return (
<BacklinkRow
key={`referenced-${relatedMemo?.name}`}
relation={relation}
snippet={backlinkSnippet(relation)}
parentPage={parentPage}
referencedByLabel={t("common.referenced-by")}
/>
);
})}
</SidebarSection>
)}
<SidebarSection label={t("common.actions")}>
{canEdit && <SidebarRow icon={Edit3Icon} label={t("common.edit")} onClick={onEdit} />}
{canComment && <SidebarRow icon={MessageSquarePlusIcon} label={t("memo.comment.write-a-comment")} onClick={onCommentCreate} />}
<DropdownMenu>
<DropdownMenuTrigger
aria-label={t("common.share")}
className={cn(
SIDEBAR_ROW_CLASSES,
"text-muted-foreground hover:bg-sidebar-accent/65 hover:text-foreground data-popup-open:bg-sidebar-accent/65 data-popup-open:text-foreground",
)}
>
<SidebarRowIconSlot icon={Share2Icon} />
<span className="min-w-0 flex-1 truncate text-start">{t("common.share")}</span>
<ChevronDownIcon className="size-3.5 shrink-0 opacity-55" strokeWidth={1.8} />
</DropdownMenuTrigger>
<DropdownMenuContent align="start" sideOffset={4} className="w-48">
<DropdownMenuItem onClick={handleCopyLink}>
<LinkIcon />
{t("memo.copy-link")}
</DropdownMenuItem>
{onShareImageOpen && (
<DropdownMenuItem onClick={onShareImageOpen}>
<ImageIcon />
{t("memo.share.open-image")}
</DropdownMenuItem>
)}
{canManageShares && (
<DropdownMenuItem onClick={() => setSharePanelOpen(true)}>
<Share2Icon />
{t("memo.share.open-panel")}
</DropdownMenuItem>
)}
</DropdownMenuContent>
</DropdownMenu>
</SidebarSection>
{sharePanelOpen && <MemoSharePanel memoName={memo.name} open={sharePanelOpen} onClose={() => setSharePanelOpen(false)} />}
</div>
);
};
export default MemoDetailSidebar;