import type { EnvironmentId, ScopedProjectRef } from "@t3tools/contracts"; import { buildProjectGroups, type ProjectGroupingSettings } from "./logicalProject"; import type { Project } from "./types"; export type EnvironmentPresence = "local-only" | "remote-only" | "mixed"; export interface SidebarProjectGroupMember extends Project { physicalProjectKey: string; environmentLabel: string | null; } export interface SidebarProjectSnapshot extends Project { projectKey: string; displayName: string; groupedProjectCount: number; environmentPresence: EnvironmentPresence; // True iff every non-primary member of this group lives in a // desktop-local environment. The sidebar uses this // to differentiate "lives on this machine but in a sandbox" from // "lives on a real remote" so the project header can pick a // local-device treatment instead of the generic remote treatment. allRemoteMembersAreDesktopLocal: boolean; allRemoteMembersAreWsl: boolean; memberProjects: readonly SidebarProjectGroupMember[]; memberProjectRefs: readonly ScopedProjectRef[]; remoteEnvironmentLabels: readonly string[]; } export interface SidebarProjectPickerEntry { group: SidebarProjectSnapshot; targetProject: SidebarProjectGroupMember; isPreferred: boolean; } export function buildPhysicalToLogicalProjectKeyMap(input: { projects: ReadonlyArray; settings: ProjectGroupingSettings; primaryEnvironmentId: EnvironmentId | null; }): Map { const mapping = new Map(); const groups = buildProjectGroups({ projects: input.projects, settings: input.settings, preferredEnvironmentId: input.primaryEnvironmentId, }); for (const group of groups) { for (const member of group.members) { mapping.set(member.physicalProjectKey, group.key); } } return mapping; } export function buildSidebarProjectSnapshots(input: { projects: ReadonlyArray; settings: ProjectGroupingSettings; primaryEnvironmentId: EnvironmentId | null; resolveEnvironmentLabel: (environmentId: EnvironmentId) => string | null; // Returns true when an env id maps to a desktop-local saved-env // record. Defaults to "false for every // env" so callers that don't care about the distinction get the // legacy behavior. isDesktopLocalEnvironment?: (environmentId: EnvironmentId) => boolean; isWslEnvironment?: (environmentId: EnvironmentId) => boolean; }): SidebarProjectSnapshot[] { return buildProjectGroups({ projects: input.projects, settings: input.settings, preferredEnvironmentId: input.primaryEnvironmentId, }).map((group): SidebarProjectSnapshot => { const members = group.members.map( ({ physicalProjectKey, project }): SidebarProjectGroupMember => ({ ...project, physicalProjectKey, environmentLabel: input.resolveEnvironmentLabel(project.environmentId), }), ); const representative = members.find( (member) => member.environmentId === group.representative.environmentId && member.id === group.representative.id, ) ?? members[0]!; const hasLocal = input.primaryEnvironmentId !== null && members.some((member) => member.environmentId === input.primaryEnvironmentId); const hasRemote = input.primaryEnvironmentId !== null ? members.some((member) => member.environmentId !== input.primaryEnvironmentId) : false; const remoteMembers = members.filter( (member) => input.primaryEnvironmentId !== null && member.environmentId !== input.primaryEnvironmentId, ); const remoteEnvironmentLabels = remoteMembers .flatMap((member) => (member.environmentLabel ? [member.environmentLabel] : [])) .filter((label, index, labels) => labels.indexOf(label) === index); const isDesktopLocal = input.isDesktopLocalEnvironment ?? (() => false); const isWsl = input.isWslEnvironment ?? (() => false); const allRemoteMembersAreDesktopLocal = remoteMembers.length > 0 && remoteMembers.every((member) => isDesktopLocal(member.environmentId)); const allRemoteMembersAreWsl = remoteMembers.length > 0 && remoteMembers.every((member) => isWsl(member.environmentId)); return { ...representative, projectKey: group.key, displayName: group.label, groupedProjectCount: members.length, environmentPresence: hasLocal && hasRemote ? "mixed" : hasRemote ? "remote-only" : "local-only", allRemoteMembersAreDesktopLocal, allRemoteMembersAreWsl, memberProjects: members, memberProjectRefs: group.memberProjectRefs, remoteEnvironmentLabels, }; }); } export function buildSidebarProjectPickerEntries(input: { groups: ReadonlyArray; preferredProjectRef: ScopedProjectRef | null; }) { const preferredProjectRef = input.preferredProjectRef; const entries = input.groups.flatMap((group): SidebarProjectPickerEntry[] => { const isPreferred = preferredProjectRef ? group.memberProjectRefs.some( (projectRef) => projectRef.environmentId === preferredProjectRef.environmentId && projectRef.projectId === preferredProjectRef.projectId, ) : false; const preferredProject = preferredProjectRef ? (group.memberProjects.find( (project) => project.environmentId === preferredProjectRef.environmentId && project.id === preferredProjectRef.projectId, ) ?? group.memberProjects.find( (project) => project.environmentId === preferredProjectRef.environmentId, )) : null; const targetProject = preferredProject ?? group.memberProjects.find( (project) => project.environmentId === group.environmentId && project.id === group.id, ) ?? group.memberProjects[0]; if (!targetProject) return []; return [{ group, targetProject, isPreferred }]; }); const preferredIndex = entries.findIndex((entry) => entry.isPreferred); if (preferredIndex <= 0) return entries; return [ entries[preferredIndex]!, ...entries.slice(0, preferredIndex), ...entries.slice(preferredIndex + 1), ]; }