"use client"; import { extractInstruction } from "@atlaskit/pragmatic-drag-and-drop-hitbox/tree-item"; import clone from "lodash/clone"; import concat from "lodash/concat"; import isEqual from "lodash/isEqual"; import pull from "lodash/pull"; import uniq from "lodash/uniq"; import scrollIntoView from "smooth-scroll-into-view-if-needed"; import { ContrastIcon } from "lucide-react"; // types import { GroupByColumnTypes, IGroupByColumn, TCycleGroups, IIssueDisplayProperties, IPragmaticDropPayload, TIssue, TIssueGroupByOptions, IIssueFilterOptions, IIssueFilters, IProjectView, } from "@plane/types"; // ui import { Avatar, CycleGroupIcon, DiceIcon, PriorityIcon, StateGroupIcon } from "@plane/ui"; // components import { Logo } from "@/components/common"; // constants import { ISSUE_PRIORITIES, EIssuesStoreType } from "@/constants/issue"; import { STATE_GROUPS } from "@/constants/state"; // stores import { ICycleStore } from "@/store/cycle.store"; import { ISSUE_FILTER_DEFAULT_DATA } from "@/store/issue/helpers/base-issues.store"; import { ILabelStore } from "@/store/label.store"; import { IMemberRootStore } from "@/store/member"; import { IModuleStore } from "@/store/module.store"; import { IProjectStore } from "@/store/project/project.store"; import { IStateStore } from "@/store/state.store"; export const HIGHLIGHT_CLASS = "highlight"; export const HIGHLIGHT_WITH_LINE = "highlight-with-line"; export type GroupDropLocation = { columnId: string; groupId: string; subGroupId?: string; id: string | undefined; canAddIssueBelow?: boolean; }; export type IssueUpdates = { [groupKey: string]: { ADD: string[]; REMOVE: string[]; }; }; export const isWorkspaceLevel = (type: EIssuesStoreType) => [EIssuesStoreType.PROFILE, EIssuesStoreType.GLOBAL].includes(type) ? true : false; export const getGroupByColumns = ( groupBy: GroupByColumnTypes | null, project: IProjectStore, cycle: ICycleStore, module: IModuleStore, label: ILabelStore, projectState: IStateStore, member: IMemberRootStore, includeNone?: boolean, isWorkspaceLevel?: boolean ): IGroupByColumn[] | undefined => { switch (groupBy) { case "project": return getProjectColumns(project); case "cycle": return getCycleColumns(project, cycle); case "module": return getModuleColumns(project, module); case "state": return getStateColumns(projectState); case "state_detail.group": return getStateGroupColumns(); case "priority": return getPriorityColumns(); case "labels": return getLabelsColumns(label, isWorkspaceLevel) as any; case "assignees": return getAssigneeColumns(member) as any; case "created_by": return getCreatedByColumns(member) as any; default: if (includeNone) return [{ id: `All Issues`, name: `All Issues`, payload: {}, icon: undefined }]; } }; const getProjectColumns = (project: IProjectStore): IGroupByColumn[] | undefined => { const { workspaceProjectIds: projectIds, projectMap } = project; if (!projectIds) return; return projectIds .filter((projectId) => !!projectMap[projectId]) .map((projectId) => { const project = projectMap[projectId]; return { id: project.id, name: project.name, icon: (
), payload: { project_id: project.id }, }; }) as any; }; const getCycleColumns = (projectStore: IProjectStore, cycleStore: ICycleStore): IGroupByColumn[] | undefined => { const { currentProjectDetails } = projectStore; const { getProjectCycleIds, getCycleById } = cycleStore; if (!currentProjectDetails || !currentProjectDetails?.id) return; const cycleIds = currentProjectDetails?.id ? getProjectCycleIds(currentProjectDetails?.id) : undefined; if (!cycleIds) return; const cycles = []; cycleIds.map((cycleId) => { const cycle = getCycleById(cycleId); if (cycle) { const cycleStatus = cycle.status ? (cycle.status.toLocaleLowerCase() as TCycleGroups) : "draft"; const isDropDisabled = cycleStatus === "completed"; cycles.push({ id: cycle.id, name: cycle.name, icon: , payload: { cycle_id: cycle.id }, isDropDisabled, dropErrorMessage: isDropDisabled ? "Issue cannot be moved to completed cycles" : undefined, }); } }); cycles.push({ id: "None", name: "None", icon: , }); return cycles as any; }; const getModuleColumns = (projectStore: IProjectStore, moduleStore: IModuleStore): IGroupByColumn[] | undefined => { const { currentProjectDetails } = projectStore; const { getProjectModuleIds, getModuleById } = moduleStore; if (!currentProjectDetails || !currentProjectDetails?.id) return; const moduleIds = currentProjectDetails?.id ? getProjectModuleIds(currentProjectDetails?.id) : undefined; if (!moduleIds) return; const modules = []; moduleIds.map((moduleId) => { const moduleInfo = getModuleById(moduleId); if (moduleInfo) modules.push({ id: moduleInfo.id, name: moduleInfo.name, icon: , payload: { module_ids: [moduleInfo.id] }, }); }) as any; modules.push({ id: "None", name: "None", icon: , }); return modules as any; }; const getStateColumns = (projectState: IStateStore): IGroupByColumn[] | undefined => { const { projectStates } = projectState; if (!projectStates) return; return projectStates.map((state) => ({ id: state.id, name: state.name, icon: (
), payload: { state_id: state.id }, })) as any; }; const getStateGroupColumns = () => { const stateGroups = STATE_GROUPS; return Object.values(stateGroups).map((stateGroup) => ({ id: stateGroup.key, name: stateGroup.label, icon: (
), payload: {}, })); }; const getPriorityColumns = () => { const priorities = ISSUE_PRIORITIES; return priorities.map((priority) => ({ id: priority.key, name: priority.title, icon: , payload: { priority: priority.key }, })); }; const getLabelsColumns = (label: ILabelStore, isWorkspaceLevel: boolean = false) => { const { workspaceLabels, projectLabels } = label; const labels = [ ...(isWorkspaceLevel ? workspaceLabels || [] : projectLabels || []), { id: "None", name: "None", color: "#666" }, ]; return labels.map((label) => ({ id: label.id, name: label.name, icon: (
), payload: label?.id === "None" ? {} : { label_ids: [label.id] }, })); }; const getAssigneeColumns = (member: IMemberRootStore) => { const { project: { projectMemberIds }, getUserDetails, } = member; if (!projectMemberIds) return; const assigneeColumns: any = projectMemberIds.map((memberId) => { const member = getUserDetails(memberId); return { id: memberId, name: member?.display_name || "", icon: , payload: { assignee_ids: [memberId] }, }; }); assigneeColumns.push({ id: "None", name: "None", icon: , payload: {} }); return assigneeColumns; }; const getCreatedByColumns = (member: IMemberRootStore) => { const { project: { projectMemberIds }, getUserDetails, } = member; if (!projectMemberIds) return; return projectMemberIds.map((memberId) => { const member = getUserDetails(memberId); return { id: memberId, name: member?.display_name || "", icon: , payload: {}, }; }); }; export const getDisplayPropertiesCount = ( displayProperties: IIssueDisplayProperties, ignoreFields?: (keyof IIssueDisplayProperties)[] ) => { const propertyKeys = Object.keys(displayProperties) as (keyof IIssueDisplayProperties)[]; let count = 0; for (const propertyKey of propertyKeys) { if (ignoreFields && ignoreFields.includes(propertyKey)) continue; if (displayProperties[propertyKey]) count++; } return count; } /** * This Method finds the DOM element with elementId, scrolls to it and highlights the issue block * @param elementId * @param shouldScrollIntoView */ export const highlightIssueOnDrop = ( elementId: string | undefined, shouldScrollIntoView = true, shouldHighLightWithLine = false ) => { setTimeout(async () => { const sourceElementId = elementId ?? ""; const sourceElement = document.getElementById(sourceElementId); sourceElement?.classList?.add(shouldHighLightWithLine ? HIGHLIGHT_WITH_LINE : HIGHLIGHT_CLASS); if (shouldScrollIntoView && sourceElement) await scrollIntoView(sourceElement, { behavior: "smooth", block: "center", duration: 1500 }); }, 200); }; /** * get Kanban Source data from Pragmatic Payload * @param payload * @returns */ export const getSourceFromDropPayload = (payload: IPragmaticDropPayload): GroupDropLocation | undefined => { const { location, source: sourceIssue } = payload; const sourceIssueData = sourceIssue.data; let sourceColumData; const sourceDropTargets = location?.initial?.dropTargets ?? []; for (const dropTarget of sourceDropTargets) { const dropTargetData = dropTarget?.data; if (!dropTargetData) continue; if (dropTargetData.type === "COLUMN") { sourceColumData = dropTargetData; } } if (sourceIssueData?.id === undefined || !sourceColumData?.groupId) return; return { groupId: sourceColumData.groupId as string, subGroupId: sourceColumData.subGroupId as string, columnId: sourceColumData.columnId as string, id: sourceIssueData.id as string, }; }; /** * get Destination Source data from Pragmatic Payload * @param payload * @returns */ export const getDestinationFromDropPayload = (payload: IPragmaticDropPayload): GroupDropLocation | undefined => { const { location } = payload; let destinationIssueData, destinationColumnData; const destDropTargets = location?.current?.dropTargets ?? []; for (const dropTarget of destDropTargets) { const dropTargetData = dropTarget?.data; if (!dropTargetData) continue; if (dropTargetData.type === "COLUMN" || dropTargetData.type === "DELETE") { destinationColumnData = dropTargetData; } if (dropTargetData.type === "ISSUE") { destinationIssueData = dropTargetData; } } if (!destinationColumnData?.groupId) return; // extract instruction from destination issue const extractedInstruction = destinationIssueData ? extractInstruction(destinationIssueData)?.type : ""; return { groupId: destinationColumnData.groupId as string, subGroupId: destinationColumnData.subGroupId as string, columnId: destinationColumnData.columnId as string, id: destinationIssueData?.id as string | undefined, canAddIssueBelow: extractedInstruction === "reorder-below", }; }; /** * Returns Sort order of the issue block at the position of drop * @param destinationIssues * @param destinationIssueId * @param getIssueById * @returns */ const handleSortOrder = ( destinationIssues: string[], destinationIssueId: string | undefined, getIssueById: (issueId: string) => TIssue | undefined, shouldAddIssueAtTop = false, canAddIssueBelow = false ) => { const sortOrderDefaultValue = 65535; let currentIssueState = {}; let destinationIndex = destinationIssueId ? destinationIssues.indexOf(destinationIssueId) : shouldAddIssueAtTop ? 0 : destinationIssues.length; const isDestinationLastChild = destinationIndex === destinationIssues.length - 1; // if issue can be added below and if the destination issue is the last child, then add to the end of the list if (canAddIssueBelow && isDestinationLastChild) { destinationIndex = destinationIssues.length; } if (destinationIssues && destinationIssues.length > 0) { if (destinationIndex === 0) { const destinationIssueId = destinationIssues[0]; const destinationIssue = getIssueById(destinationIssueId); if (!destinationIssue) return currentIssueState; currentIssueState = { ...currentIssueState, sort_order: destinationIssue.sort_order - sortOrderDefaultValue, }; } else if (destinationIndex === destinationIssues.length) { const destinationIssueId = destinationIssues[destinationIssues.length - 1]; const destinationIssue = getIssueById(destinationIssueId); if (!destinationIssue) return currentIssueState; currentIssueState = { ...currentIssueState, sort_order: destinationIssue.sort_order + sortOrderDefaultValue, }; } else { const destinationTopIssueId = destinationIssues[destinationIndex - 1]; const destinationBottomIssueId = destinationIssues[destinationIndex]; const destinationTopIssue = getIssueById(destinationTopIssueId); const destinationBottomIssue = getIssueById(destinationBottomIssueId); if (!destinationTopIssue || !destinationBottomIssue) return currentIssueState; currentIssueState = { ...currentIssueState, sort_order: (destinationTopIssue.sort_order + destinationBottomIssue.sort_order) / 2, }; } } else { currentIssueState = { ...currentIssueState, sort_order: sortOrderDefaultValue, }; } return currentIssueState; }; export const getIssueBlockId = ( issueId: string | undefined, groupId: string | undefined, subGroupId?: string | undefined ) => `issue_${issueId}_${groupId}_${subGroupId}`; /** * returns empty Array if groupId is None * @param groupId * @returns */ const getGroupId = (groupId: string) => { if (groupId === "None") return []; return [groupId]; }; export const handleGroupDragDrop = async ( source: GroupDropLocation, destination: GroupDropLocation, getIssueById: (issueId: string) => TIssue | undefined, getIssueIds: (groupId?: string, subGroupId?: string) => string[] | undefined, updateIssueOnDrop: (projectId: string, issueId: string, data: Partial, issueUpdates: IssueUpdates) => void, groupBy: TIssueGroupByOptions | undefined, subGroupBy: TIssueGroupByOptions | undefined, shouldAddIssueAtTop = false ) => { if (!source.id || !groupBy || (subGroupBy && (!source.subGroupId || !destination.subGroupId))) return; let updatedIssue: Partial = {}; const issueUpdates: IssueUpdates = {}; const destinationIssues = getIssueIds(destination.groupId, destination.subGroupId) ?? []; const sourceIssue = getIssueById(source.id); if (!sourceIssue) return; updatedIssue = { id: sourceIssue.id, project_id: sourceIssue.project_id, }; // for both horizontal and vertical dnd updatedIssue = { ...updatedIssue, ...handleSortOrder( destinationIssues, destination.id, getIssueById, shouldAddIssueAtTop, !!destination.canAddIssueBelow ), }; // update updatedIssue values based on the source and destination groupIds if (source.groupId && destination.groupId && source.groupId !== destination.groupId) { const groupKey = ISSUE_FILTER_DEFAULT_DATA[groupBy]; let groupValue: any = clone(sourceIssue[groupKey]); // If groupValues is an array, remove source groupId and add destination groupId if (Array.isArray(groupValue)) { pull(groupValue, source.groupId); if (destination.groupId !== "None") groupValue = uniq(concat(groupValue, [destination.groupId])); } // else just update the groupValue based on destination groupId else { groupValue = destination.groupId === "None" ? null : destination.groupId; } // keep track of updates on what was added and what was removed issueUpdates[groupKey] = { ADD: getGroupId(destination.groupId), REMOVE: getGroupId(source.groupId) }; updatedIssue = { ...updatedIssue, [groupKey]: groupValue }; } // do the same for subgroup // update updatedIssue values based on the source and destination subGroupIds if (subGroupBy && source.subGroupId && destination.subGroupId && source.subGroupId !== destination.subGroupId) { const subGroupKey = ISSUE_FILTER_DEFAULT_DATA[subGroupBy]; let subGroupValue: any = clone(sourceIssue[subGroupKey]); // If subGroupValue is an array, remove source subGroupId and add destination subGroupId if (Array.isArray(subGroupValue)) { pull(subGroupValue, source.subGroupId); if (destination.subGroupId !== "None") subGroupValue = uniq(concat(subGroupValue, [destination.subGroupId])); } // else just update the subGroupValue based on destination subGroupId else { subGroupValue = destination.subGroupId === "None" ? null : destination.subGroupId; } // keep track of updates on what was added and what was removed issueUpdates[subGroupKey] = { ADD: getGroupId(destination.subGroupId), REMOVE: getGroupId(source.subGroupId) }; updatedIssue = { ...updatedIssue, [subGroupKey]: subGroupValue }; } if (updatedIssue && sourceIssue?.project_id) { return await updateIssueOnDrop(sourceIssue?.project_id, sourceIssue.id, updatedIssue, issueUpdates); } }; /** * This Method compares filters and returns a boolean based on which and updateView button is shown * @param appliedFilters * @param issueFilters * @param viewDetails * @returns */ export const getAreFiltersEqual = ( appliedFilters: IIssueFilterOptions | undefined, issueFilters: IIssueFilters | undefined, viewDetails: IProjectView | null ) => isEqual(appliedFilters ?? {}, viewDetails?.filters ?? {}) && isEqual(issueFilters?.displayFilters ?? {}, viewDetails?.display_filters ?? {}) && isEqual(issueFilters?.displayProperties ?? {}, viewDetails?.display_properties ?? {});