Skip to content

feat: add FlexibleDMs plugin #4588

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
b-lacksoul wants to merge 2 commits into
base: main
Choose a base branch
from
Open

feat: add FlexibleDMs plugin #4588

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
a684702
feat: add FlexibleDMs
ffriskdev Sep 5, 2026
f666241
fix(FlexibleDMs): preserve native pins and folder state
b-lacksoul Sep 8, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
20 changes: 20 additions & 0 deletions src/plugins/flexibleDMs/animation.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
/*
* Vencord, a Discord client mod
* Copyright (c) 2026 Vendicated and contributors
* SPDX-License-Identifier: GPL-3.0-or-later
*/

const opening = new Set<string>();
const timers = new Map<string, ReturnType<typeof setTimeout>>();

/** Mark an explicitly opened folder so only its newly mounted children animate. */
export function markFolderOpening(id: string) {
opening.add(id);
clearTimeout(timers.get(id));
timers.set(id, setTimeout(() => {
opening.delete(id);
timers.delete(id);
}, 200));
}

export const isFolderOpening = (id: string | undefined) => !!id && opening.has(id);
250 changes: 250 additions & 0 deletions src/plugins/flexibleDMs/components.tsx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,250 @@
/*
* Vencord, a Discord client mod
* Copyright (c) 2026 Vendicated and contributors
* SPDX-License-Identifier: GPL-3.0-or-later
*/

import ErrorBoundary from "@components/ErrorBoundary";
import { FolderIcon } from "@components/Icons";
import { classes } from "@utils/misc";
import { RenderModalProps } from "@vencord/discord-types";
import { ChannelStore, ContextMenuApi, FluxDispatcher, IconUtils, Menu, Modal, openModal, React, ReadStateStore, SelectedChannelStore, TextInput, UserStore, useState, useStateFromStores } from "@webpack/common";

import { isFolderOpening, markFolderOpening } from "./animation";
import { DEFAULT_FOLDER_COLOR, Folder, Placement, Row } from "./model";
import { accountId, closeAll, dissolveFolder, drop, editFolder, getNativePinnedIds, PrivateChannelSortStore } from "./state";

const DRAG_TYPE = "application/x-vencord-dm-folder";
let dragging: { id: string; userId: string | undefined; folder: boolean; } | undefined;

export function clearDrag() {
dragging = undefined;
}

const DEFAULT_COLOR = parseInt(DEFAULT_FOLDER_COLOR.slice(1), 16);
const SWATCHES = [
1752220, 3066993, 3447003, 10181046, 15277667, 15844367, 15105570, 15158332, 9807270, 6323595,
1146986, 2067276, 2123412, 7419530, 11342935, 12745742, 11027200, 10038562, 9936031, 5533306
];

function FolderColorPicker({ color, onChange }: { color: number; onChange(color: number): void; }) {
const hex = `#${color.toString(16).padStart(6, "0")}`;
const check = (
<svg width="16" height="16" viewBox="0 0 24 24" aria-hidden="true">
<path d="m5 12 4 4L19 6" fill="none" stroke="currentColor" strokeWidth="3" />
</svg>
);
return (
<div className="vc-dmf-colors" role="group" aria-label="Folder Color">
<div className="vc-dmf-color-buttons">
<button
type="button"
className="vc-dmf-color-large"
style={{ backgroundColor: DEFAULT_FOLDER_COLOR }}
aria-label="Default color"
aria-pressed={color === DEFAULT_COLOR}
onClick={() => onChange(DEFAULT_COLOR)}
>
{color === DEFAULT_COLOR && check}
</button>
<label className="vc-dmf-color-large vc-dmf-custom-color" style={{ backgroundColor: hex }} title="Custom color">
<svg width="18" height="18" viewBox="0 0 24 24" aria-hidden="true">
<path d="m4 16 12-12 4 4L8 20H4Zm10-10 4 4" fill="none" stroke="currentColor" strokeWidth="2" />
</svg>
<input type="color" value={hex} onChange={e => onChange(parseInt(e.target.value.slice(1), 16))} aria-label="Custom folder color" />
</label>
</div>
<div className="vc-dmf-swatches">
{SWATCHES.map(value => (
<button
key={value}
type="button"
className="vc-dmf-swatch"
style={{ backgroundColor: `#${value.toString(16).padStart(6, "0")}` }}
aria-label={`Color #${value.toString(16).padStart(6, "0")}`}
aria-pressed={color === value}
onClick={() => onChange(value)}
>
{color === value && check}
</button>
))}
</div>
</div>
);
}

function FolderSettings({ folder, modalProps, userId }: { folder: Folder; modalProps: RenderModalProps; userId: string | undefined; }) {
const [name, setName] = useState(folder.name);
const [color, setColor] = useState(parseInt(folder.color.slice(1), 16));
const save = () => {
if (!name.trim()) return;
editFolder(folder.id, { name: name.trim(), color: `#${color.toString(16).padStart(6, "0")}` }, userId);
modalProps.onClose();
};
return (
<Modal
{...modalProps}
title="Folder Settings"
actions={[
{ text: "Done", variant: "primary", disabled: !name.trim(), onClick: save }
]}
>
<form className="vc-dmf-settings" onSubmit={e => { e.preventDefault(); save(); }}>
<label htmlFor="vc-dmf-name">Folder Name</label>
<TextInput id="vc-dmf-name" value={name} onChange={setName} maxLength={100} autoFocus />
<span>Folder Color</span>
<FolderColorPicker color={color} onChange={setColor} />
</form>
</Modal>
);
}

export function openFolderSettings(folder: Folder) {
const userId = accountId();
openModal(modalProps => (
<ErrorBoundary message="FlexibleDMs could not open Folder Settings">
<FolderSettings folder={folder} modalProps={modalProps} userId={userId} />
</ErrorBoundary>
));
}

function markFolderRead(folder: Folder) {
const active = new Set(PrivateChannelSortStore.getPrivateChannelIds());
const channels = folder.channels.filter(id => active.has(id) && ReadStateStore.hasUnread(id)).map(channelId => ({
channelId,
messageId: ReadStateStore.lastMessageId(channelId),
readStateType: 0
})).filter(c => c.messageId);
if (channels.length) FluxDispatcher.dispatch({ type: "BULK_ACK", context: "APP", channels });
}

function folderMenu(event: React.MouseEvent, folder: Folder) {
ContextMenuApi.openContextMenu(event, () => (
<Menu.Menu navId="vc-dmf-folder" aria-label="DM Folder" onClose={ContextMenuApi.closeContextMenu}>
<Menu.MenuItem id="vc-dmf-read" label="Mark Folder As Read" action={() => markFolderRead(folder)} />
<Menu.MenuSeparator />
<Menu.MenuItem id="vc-dmf-settings" label="Folder Settings" action={() => openFolderSettings(folder)} />
<Menu.MenuItem id="vc-dmf-close-all" label="Close All Folders" action={closeAll} />
<Menu.MenuSeparator />
<Menu.MenuItem id="vc-dmf-dissolve" label="Ungroup Folder" action={() => dissolveFolder(folder.id)} />
</Menu.Menu>
));
}

function avatar(id: string) {
const channel = ChannelStore.getChannel(id);
if (!channel) return;
const recipient = channel.getRecipientId();
if (channel.isDM()) return recipient ? UserStore.getUser(recipient)?.getAvatarURL(undefined, 32, false) : undefined;
return IconUtils.getChannelIconURL({ id, icon: channel.icon, size: 32 });
}

export function FolderRow({ folder }: { folder: Folder; }) {
const userId = useStateFromStores([UserStore], accountId);
const activeIds = useStateFromStores([PrivateChannelSortStore], () => PrivateChannelSortStore.getPrivateChannelIds());
const active = new Set(activeIds);
const ids = folder.channels.filter(id => active.has(id));
const unread = useStateFromStores([ReadStateStore], () => ids.some(id => ReadStateStore.hasUnread(id)));
const mentions = useStateFromStores([ReadStateStore], () => ids.reduce((sum, id) => sum + ReadStateStore.getMentionCount(id), 0));
const selected = useStateFromStores([SelectedChannelStore], () => ids.includes(SelectedChannelStore.getChannelId()));
useStateFromStores([UserStore, ChannelStore], () => ids.map(id => avatar(id)).join("|"));
return (
<button
type="button"
className={classes("vc-dmf-folder", unread && "vc-dmf-unread", selected && "vc-dmf-selected")}
aria-expanded={folder.expanded}
aria-label={`${folder.name}, ${ids.length} chats${unread ? ", unread" : ""}${mentions ? `, ${mentions} mentions` : ""}`}
title={folder.name}
onClick={() => {
if (!folder.expanded) markFolderOpening(folder.id);
editFolder(folder.id, { expanded: !folder.expanded }, userId);
}}
onKeyDown={e => {
if (e.key === "ArrowRight" || e.key === "ArrowLeft") {
e.preventDefault();
const expanded = e.key === "ArrowRight";
if (expanded && !folder.expanded) markFolderOpening(folder.id);
editFolder(folder.id, { expanded }, userId);
}
}}
onContextMenu={e => folderMenu(e, folder)}
>
<span className="vc-dmf-icon" style={{ "--vc-dmf-color": folder.color } as React.CSSProperties} aria-hidden="true">
{folder.expanded ? <FolderIcon width={20} height={20} /> : (
<span className="vc-dmf-mosaic">
{ids.slice(0, 4).map(id => {
const src = avatar(id);
return src ? <img key={id} src={src} alt="" draggable={false} /> : <span key={id} className="vc-dmf-avatar-fallback">#</span>;
})}
</span>
)}
</span>
<span className="vc-dmf-nameplate">
<span className="vc-dmf-name">{folder.name}</span>
<span className="vc-dmf-description">{ids.length} {ids.length === 1 ? "chat" : "chats"}</span>
</span>
{mentions > 0 && <span className="vc-dmf-badge" aria-hidden="true">{mentions > 99 ? "99+" : mentions}</span>}
<svg className={classes("vc-dmf-chevron", folder.expanded && "vc-dmf-chevron-open")} width="16" height="16" viewBox="0 0 24 24" aria-hidden="true">
<path d="m9 5 7 7-7 7" fill="none" stroke="currentColor" strokeWidth="2" />
</svg>
</button>
);
}

export function DragRow({ row, height, children }: React.PropsWithChildren<{ row: Row; height: number; }>) {
const [over, setOver] = useState<Placement | null>(null);
const getPlacement = (event: React.DragEvent<HTMLDivElement>): Placement | null => {
if (!dragging || dragging.id === row.id || dragging.userId !== accountId() || !event.dataTransfer.types.includes(DRAG_TYPE)) return null;
if (dragging.folder && row.parent) return null;
const rect = event.currentTarget.getBoundingClientRect();
const ratio = (event.clientY - rect.top) / rect.height;
const placement = ratio < 0.25 ? "before" : ratio > 0.75 ? "after" : "inside";
if (dragging.folder && placement === "inside") return ratio < 0.5 ? "before" : "after";
return placement;
};
const nativePinned = getNativePinnedIds().includes(row.id);
return (
<div
className={classes("vc-dmf-row", row.parent && "vc-dmf-child", isFolderOpening(row.parent?.id) && "vc-dmf-opening", row.folder?.expanded && "vc-dmf-expanded")}
style={{ height, "--vc-dmf-color": (row.parent ?? row.folder)?.color } as React.CSSProperties}
data-dmf-drop={over ?? undefined}
draggable={!nativePinned}
onDragStartCapture={e => {
if ((e.target as HTMLElement).closest("[class*=closeButton],input")) {
e.preventDefault();
return;
}
dragging = { id: row.id, userId: accountId(), folder: !!row.folder };
e.dataTransfer.effectAllowed = "move";
e.dataTransfer.setData(DRAG_TYPE, row.id);
e.dataTransfer.setDragImage(e.currentTarget, 24, height / 2);
// Override native link/image dragging inside Discord's channel row.
e.stopPropagation();
}}
onDragEnd={() => { clearDrag(); setOver(null); }}
onDragOver={e => {
const placement = getPlacement(e);
setOver(placement);
if (!placement) return;
e.preventDefault();
e.stopPropagation();
e.dataTransfer.dropEffect = "move";
}}
onDragLeave={e => {
if (!e.currentTarget.contains(e.relatedTarget as Node | null)) setOver(null);
}}
onDrop={e => {
const placement = getPlacement(e);
const source = dragging;
clearDrag();
setOver(null);
if (!placement || !source) return;
e.preventDefault();
e.stopPropagation();
drop(source.id, row.id, placement);
}}
>
{children}
</div>
);
}
Loading