Add MailRootView and related components for mail functionality

- Implement MailRootView with navigation and sidebar for mail management.
- Create MailSidebarView, ThreadListView, and ThreadDetailView for displaying mail content.
- Introduce ComposeView for composing new messages.
- Add MailTheme for consistent styling across mail components.
- Implement adaptive layouts for iOS and macOS.
- Create unit tests for AppNavigationCommand and AppViewModel to ensure correct functionality.
This commit is contained in:
2026-04-19 01:00:32 +02:00
parent 6b665c666f
commit ad059e9b8d
15 changed files with 19 additions and 19 deletions

View File

@@ -0,0 +1,66 @@
import Foundation
protocol AppControlServicing {
func commands() -> AsyncStream<AppNavigationCommand>
}
struct MockBackendControlService: AppControlServicing {
static let controlFileEnvironmentKey = "SOCIALIO_CONTROL_FILE"
static let pollingIntervalEnvironmentKey = "SOCIALIO_CONTROL_POLL_MS"
private let environment: [String: String]
init(environment: [String: String] = ProcessInfo.processInfo.environment) {
self.environment = environment
}
func commands() -> AsyncStream<AppNavigationCommand> {
guard let controlFilePath = environment[Self.controlFileEnvironmentKey]?
.trimmingCharacters(in: .whitespacesAndNewlines),
!controlFilePath.isEmpty else {
return AsyncStream { continuation in
continuation.finish()
}
}
let controlFileURL = URL(fileURLWithPath: controlFilePath)
let pollingInterval = pollingIntervalDuration
return AsyncStream { continuation in
let task = Task.detached(priority: .background) {
var lastAppliedPayload: String?
while !Task.isCancelled {
if let payload = try? String(contentsOf: controlFileURL, encoding: .utf8) {
let trimmedPayload = payload.trimmingCharacters(in: .whitespacesAndNewlines)
if !trimmedPayload.isEmpty,
trimmedPayload != lastAppliedPayload,
let command = AppNavigationCommand.parse(trimmedPayload) {
lastAppliedPayload = trimmedPayload
continuation.yield(command)
}
}
try? await Task.sleep(for: pollingInterval)
}
continuation.finish()
}
continuation.onTermination = { _ in
task.cancel()
}
}
}
private var pollingIntervalDuration: Duration {
guard let rawValue = environment[Self.pollingIntervalEnvironmentKey],
let milliseconds = Int(rawValue),
milliseconds > 0 else {
return .milliseconds(600)
}
return .milliseconds(milliseconds)
}
}

View File

@@ -0,0 +1,207 @@
import Foundation
enum AppNavigationCommand: Equatable {
case mailbox(mailbox: Mailbox, search: String?, unreadOnly: Bool?)
case thread(
threadRouteID: String,
mailbox: Mailbox?,
messageRouteID: String?,
search: String?,
unreadOnly: Bool?
)
case compose(draft: ComposeDraft)
static let routeEnvironmentKey = "SOCIALIO_ROUTE"
static let jsonEnvironmentKey = "SOCIALIO_COMMAND_JSON"
static func from(environment: [String: String]) -> AppNavigationCommand? {
if let json = environment[jsonEnvironmentKey] {
return from(json: json)
}
if let route = environment[routeEnvironmentKey] {
return parse(route)
}
return nil
}
static func parse(_ rawValue: String) -> AppNavigationCommand? {
let trimmed = rawValue.trimmingCharacters(in: .whitespacesAndNewlines)
guard !trimmed.isEmpty else { return nil }
if trimmed.hasPrefix("{") {
return from(json: trimmed)
}
guard let url = URL(string: trimmed) else { return nil }
return from(url: url)
}
static func from(url: URL) -> AppNavigationCommand? {
guard let components = URLComponents(url: url, resolvingAgainstBaseURL: false) else {
return nil
}
let host = (components.host ?? "").lowercased()
let pathComponents = url.path
.split(separator: "/")
.map(String.init)
let queryItems = components.queryItems ?? []
let mailbox = queryItems.value(named: "mailbox").flatMap(Mailbox.init(rawValue:))
let threadRouteID = queryItems.value(named: "thread")
let messageRouteID = queryItems.value(named: "message")
let search = queryItems.value(named: "search")
let unreadOnly = queryItems.value(named: "unreadOnly").flatMap(Bool.init)
switch host {
case "mailbox":
guard let mailboxID = pathComponents.first, let mailbox = Mailbox(rawValue: mailboxID) else {
return nil
}
return .mailbox(mailbox: mailbox, search: search, unreadOnly: unreadOnly)
case "thread":
guard let routeID = pathComponents.first else { return nil }
return .thread(
threadRouteID: routeID,
mailbox: mailbox,
messageRouteID: messageRouteID,
search: search,
unreadOnly: unreadOnly
)
case "compose":
return .compose(
draft: ComposeDraft(
to: queryItems.value(named: "to") ?? "",
subject: queryItems.value(named: "subject") ?? "",
body: queryItems.value(named: "body") ?? ""
)
)
case "open", "":
if let threadRouteID {
return .thread(
threadRouteID: threadRouteID,
mailbox: mailbox,
messageRouteID: messageRouteID,
search: search,
unreadOnly: unreadOnly
)
}
if let mailbox {
return .mailbox(mailbox: mailbox, search: search, unreadOnly: unreadOnly)
}
if queryItems.value(named: "to") != nil ||
queryItems.value(named: "subject") != nil ||
queryItems.value(named: "body") != nil {
return .compose(
draft: ComposeDraft(
to: queryItems.value(named: "to") ?? "",
subject: queryItems.value(named: "subject") ?? "",
body: queryItems.value(named: "body") ?? ""
)
)
}
return nil
default:
return nil
}
}
static func from(json: String) -> AppNavigationCommand? {
guard let data = json.data(using: .utf8) else { return nil }
let decoder = JSONDecoder()
do {
let payload = try decoder.decode(AppNavigationPayload.self, from: data)
return payload.command
} catch {
return nil
}
}
}
private struct AppNavigationPayload: Decodable {
enum Kind: String, Decodable {
case mailbox
case thread
case compose
}
let kind: Kind?
let mailbox: Mailbox?
let threadID: String?
let messageID: String?
let search: String?
let unreadOnly: Bool?
let to: String?
let subject: String?
let body: String?
var command: AppNavigationCommand? {
switch kind {
case .mailbox:
guard let mailbox else { return nil }
return .mailbox(mailbox: mailbox, search: search, unreadOnly: unreadOnly)
case .thread:
guard let threadID else { return nil }
return .thread(
threadRouteID: threadID,
mailbox: mailbox,
messageRouteID: messageID,
search: search,
unreadOnly: unreadOnly
)
case .compose:
return .compose(
draft: ComposeDraft(
to: to ?? "",
subject: subject ?? "",
body: body ?? ""
)
)
case nil:
if let threadID {
return .thread(
threadRouteID: threadID,
mailbox: mailbox,
messageRouteID: messageID,
search: search,
unreadOnly: unreadOnly
)
}
if let mailbox {
return .mailbox(mailbox: mailbox, search: search, unreadOnly: unreadOnly)
}
if to != nil || subject != nil || body != nil {
return .compose(
draft: ComposeDraft(
to: to ?? "",
subject: subject ?? "",
body: body ?? ""
)
)
}
return nil
}
}
}
private extension [URLQueryItem] {
func value(named name: String) -> String? {
first(where: { $0.name == name })?.value
}
}

View File

@@ -0,0 +1,264 @@
import Foundation
import Observation
@MainActor
@Observable
final class AppViewModel {
var selectedMailbox: Mailbox = .inbox
var selectedThreadID: MailThread.ID?
var focusedMessageRouteID: String?
var searchText = ""
var showUnreadOnly = false
var isComposing = false
var composeDraft = ComposeDraft()
var threads: [MailThread] = []
var isLoading = false
var isSending = false
var errorMessage: String?
var mailboxNavigationToken = UUID()
var threadNavigationToken = UUID()
private let service: MailServicing
private let controlService: AppControlServicing
private var pendingNavigationCommand: AppNavigationCommand?
private var isListeningForBackendCommands = false
init(
service: MailServicing = MockMailService(),
controlService: AppControlServicing = MockBackendControlService()
) {
self.service = service
self.controlService = controlService
if let command = AppNavigationCommand.from(environment: ProcessInfo.processInfo.environment) {
apply(command: command)
}
}
var selectedThread: MailThread? {
get { threads.first(where: { $0.id == selectedThreadID }) }
set { selectedThreadID = newValue?.id }
}
var filteredThreads: [MailThread] {
threads
.filter { thread in
selectedMailbox == .starred ? thread.isStarred : thread.mailbox == selectedMailbox
}
.filter { thread in
!showUnreadOnly || thread.isUnread
}
.filter(matchesSearch)
.sorted { $0.lastUpdated > $1.lastUpdated }
}
var totalUnreadCount: Int {
threads.filter(\.isUnread).count
}
func threadCount(in mailbox: Mailbox) -> Int {
threads.filter { thread in
mailbox == .starred ? thread.isStarred : thread.mailbox == mailbox
}
.count
}
func unreadCount(in mailbox: Mailbox) -> Int {
threads.filter { thread in
let matchesMailbox = mailbox == .starred ? thread.isStarred : thread.mailbox == mailbox
return matchesMailbox && thread.isUnread
}
.count
}
func load() async {
guard threads.isEmpty else { return }
isLoading = true
defer { isLoading = false }
do {
threads = try await service.loadThreads()
if let command = pendingNavigationCommand {
pendingNavigationCommand = nil
apply(command: command)
} else {
reconcileSelectionForCurrentFilters()
}
} catch {
errorMessage = "Unable to load mail."
}
}
func toggleStar(for thread: MailThread) {
toggleStar(forThreadID: thread.id)
}
func toggleStar(forThreadID threadID: MailThread.ID) {
guard let index = threads.firstIndex(where: { $0.id == threadID }) else { return }
var updatedThread = threads[index]
updatedThread.isStarred.toggle()
threads[index] = updatedThread
reconcileSelectionForCurrentFilters()
}
func toggleRead(for thread: MailThread) {
toggleRead(forThreadID: thread.id)
}
func toggleRead(forThreadID threadID: MailThread.ID) {
guard let index = threads.firstIndex(where: { $0.id == threadID }) else { return }
var updatedThread = threads[index]
updatedThread.isUnread.toggle()
threads[index] = updatedThread
reconcileSelectionForCurrentFilters()
}
func selectMailbox(_ mailbox: Mailbox) {
selectedMailbox = mailbox
clearThreadSelection()
mailboxNavigationToken = UUID()
}
func setUnreadOnly(_ unreadOnly: Bool) {
showUnreadOnly = unreadOnly
clearThreadSelection()
mailboxNavigationToken = UUID()
}
func setSearchText(_ text: String) {
searchText = text
reconcileSelectionForCurrentFilters()
}
func startCompose() {
composeDraft = ComposeDraft()
focusedMessageRouteID = nil
isComposing = true
}
func openThread(withID threadID: MailThread.ID, focusedMessageRouteID: String? = nil) {
guard let thread = thread(withID: threadID) else { return }
selectedThreadID = threadID
if let focusedMessageRouteID,
thread.messages.contains(where: { $0.routeID == focusedMessageRouteID }) {
self.focusedMessageRouteID = focusedMessageRouteID
} else {
self.focusedMessageRouteID = nil
}
threadNavigationToken = UUID()
}
func dismissThreadSelection() {
clearThreadSelection()
}
func beginBackendControl() async {
guard !isListeningForBackendCommands else { return }
isListeningForBackendCommands = true
defer { isListeningForBackendCommands = false }
for await command in controlService.commands() {
apply(command: command)
}
}
func apply(url: URL) {
guard let command = AppNavigationCommand.from(url: url) else {
errorMessage = "Unable to open requested destination."
return
}
apply(command: command)
}
func apply(command: AppNavigationCommand) {
switch command {
case let .mailbox(mailbox, search, unreadOnly):
isComposing = false
searchText = search ?? ""
showUnreadOnly = unreadOnly ?? false
selectMailbox(mailbox)
case let .thread(threadRouteID, mailbox, messageRouteID, search, unreadOnly):
guard !threads.isEmpty else {
pendingNavigationCommand = command
return
}
searchText = search ?? ""
showUnreadOnly = unreadOnly ?? false
isComposing = false
guard let thread = threads.first(where: { $0.routeID == threadRouteID }) else {
errorMessage = "Unable to open requested conversation."
return
}
selectedMailbox = mailbox ?? thread.mailbox
openThread(withID: thread.id, focusedMessageRouteID: messageRouteID)
case let .compose(draft):
focusedMessageRouteID = nil
composeDraft = draft
isComposing = true
}
}
func sendCurrentDraft() async -> Bool {
guard !isSending else { return false }
let draft = composeDraft
isSending = true
defer { isSending = false }
do {
let sentThread = try await service.send(draft: draft)
threads.insert(sentThread, at: 0)
selectedMailbox = .sent
openThread(withID: sentThread.id)
isComposing = false
return true
} catch {
errorMessage = "Unable to send message."
return false
}
}
private func matchesSearch(thread: MailThread) -> Bool {
let query = searchText.trimmingCharacters(in: .whitespacesAndNewlines)
guard !query.isEmpty else { return true }
let haystack = [
thread.subject,
thread.previewText,
thread.participants.map(\.name).joined(separator: " "),
thread.tags.joined(separator: " ")
]
.joined(separator: " ")
.localizedLowercase
return haystack.contains(query.localizedLowercase)
}
func thread(withID threadID: MailThread.ID) -> MailThread? {
threads.first(where: { $0.id == threadID })
}
private func clearThreadSelection() {
selectedThreadID = nil
focusedMessageRouteID = nil
}
private func reconcileSelectionForCurrentFilters() {
if let selectedThreadID,
filteredThreads.contains(where: { $0.id == selectedThreadID }) {
return
}
clearThreadSelection()
}
}

View File

@@ -0,0 +1,19 @@
import SwiftUI
@main
struct SocialIOApp: App {
@State private var model = AppViewModel()
var body: some Scene {
WindowGroup {
MailRootView(model: model)
.tint(MailTheme.accent)
.onOpenURL { url in
model.apply(url: url)
}
}
#if os(macOS)
.defaultSize(width: 1440, height: 900)
#endif
}
}

View File

@@ -0,0 +1,123 @@
import Foundation
enum Mailbox: String, CaseIterable, Identifiable, Codable {
case inbox
case starred
case sent
case drafts
case archive
var id: String { rawValue }
var title: String {
switch self {
case .inbox: "Inbox"
case .starred: "Starred"
case .sent: "Sent"
case .drafts: "Drafts"
case .archive: "Archive"
}
}
var systemImage: String {
switch self {
case .inbox: "tray.full"
case .starred: "star"
case .sent: "paperplane"
case .drafts: "doc.text"
case .archive: "archivebox"
}
}
}
struct MailPerson: Identifiable, Hashable, Codable {
let id: UUID
let name: String
let email: String
init(id: UUID = UUID(), name: String, email: String) {
self.id = id
self.name = name
self.email = email
}
}
struct MailMessage: Identifiable, Hashable, Codable {
let id: UUID
let routeID: String
let sender: MailPerson
let recipients: [MailPerson]
let sentAt: Date
let body: String
let isDraft: Bool
init(
id: UUID = UUID(),
routeID: String = UUID().uuidString.lowercased(),
sender: MailPerson,
recipients: [MailPerson],
sentAt: Date,
body: String,
isDraft: Bool = false
) {
self.id = id
self.routeID = routeID
self.sender = sender
self.recipients = recipients
self.sentAt = sentAt
self.body = body
self.isDraft = isDraft
}
}
struct MailThread: Identifiable, Hashable, Codable {
let id: UUID
let routeID: String
var mailbox: Mailbox
var subject: String
var participants: [MailPerson]
var messages: [MailMessage]
var isUnread: Bool
var isStarred: Bool
var tags: [String]
init(
id: UUID = UUID(),
routeID: String = UUID().uuidString.lowercased(),
mailbox: Mailbox,
subject: String,
participants: [MailPerson],
messages: [MailMessage],
isUnread: Bool,
isStarred: Bool,
tags: [String] = []
) {
self.id = id
self.routeID = routeID
self.mailbox = mailbox
self.subject = subject
self.participants = participants
self.messages = messages.sorted { $0.sentAt < $1.sentAt }
self.isUnread = isUnread
self.isStarred = isStarred
self.tags = tags
}
var latestMessage: MailMessage? {
messages.max(by: { $0.sentAt < $1.sentAt })
}
var previewText: String {
latestMessage?.body.replacingOccurrences(of: "\n", with: " ") ?? ""
}
var lastUpdated: Date {
latestMessage?.sentAt ?? .distantPast
}
}
struct ComposeDraft: Equatable {
var to = ""
var subject = ""
var body = ""
}

View File

@@ -0,0 +1,187 @@
import Foundation
protocol MailServicing {
func loadThreads() async throws -> [MailThread]
func send(draft: ComposeDraft) async throws -> MailThread
}
struct MockMailService: MailServicing {
private let me = MailPerson(name: "Phil Kunz", email: "phil@social.io")
func loadThreads() async throws -> [MailThread] {
try await Task.sleep(for: .milliseconds(150))
return seededThreads.sorted { $0.lastUpdated > $1.lastUpdated }
}
func send(draft: ComposeDraft) async throws -> MailThread {
try await Task.sleep(for: .milliseconds(120))
let threadRouteID = "sent-\(UUID().uuidString.lowercased())"
let messageRouteID = "\(threadRouteID)-message"
let recipientNames = draft.to
.split(separator: ",")
.map { $0.trimmingCharacters(in: .whitespacesAndNewlines) }
.filter { !$0.isEmpty }
let recipients = recipientNames.map { raw in
MailPerson(
name: raw.components(separatedBy: "@").first?.capitalized ?? raw,
email: raw
)
}
let message = MailMessage(
routeID: messageRouteID,
sender: me,
recipients: recipients,
sentAt: .now,
body: draft.body
)
return MailThread(
routeID: threadRouteID,
mailbox: .sent,
subject: draft.subject.isEmpty ? "(No Subject)" : draft.subject,
participants: recipients + [me],
messages: [message],
isUnread: false,
isStarred: false,
tags: ["Sent"]
)
}
private var seededThreads: [MailThread] {
let alex = MailPerson(name: "Alex Rivera", email: "alex@social.io")
let nora = MailPerson(name: "Nora Chen", email: "nora@social.io")
let tanya = MailPerson(name: "Tanya Hall", email: "tanya@design.social.io")
let ops = MailPerson(name: "Ops Bot", email: "ops@social.io")
let investor = MailPerson(name: "Mina Park", email: "mina@northshore.vc")
return [
MailThread(
routeID: "launch-copy",
mailbox: .inbox,
subject: "Launch copy for the onboarding flow",
participants: [tanya, me],
messages: [
MailMessage(
routeID: "launch-copy-1",
sender: tanya,
recipients: [me],
sentAt: .now.addingTimeInterval(-3600 * 2),
body: "I tightened the onboarding copy and added a warmer empty-state tone. If you're good with it, I can hand the strings to the app team today."
),
MailMessage(
routeID: "launch-copy-2",
sender: me,
recipients: [tanya],
sentAt: .now.addingTimeInterval(-3600),
body: "Looks strong. Let's keep the playful language on iPhone and simplify the desktop first-run copy a bit."
)
],
isUnread: true,
isStarred: true,
tags: ["Design", "Launch"]
),
MailThread(
routeID: "daily-sync-status",
mailbox: .inbox,
subject: "Daily inbox sync status",
participants: [ops, me],
messages: [
MailMessage(
routeID: "daily-sync-status-1",
sender: ops,
recipients: [me],
sentAt: .now.addingTimeInterval(-3600 * 4),
body: "Mock sync complete. 1,284 messages mirrored from staging. Attachment fetch remains disabled in the sandbox profile."
)
],
isUnread: false,
isStarred: false,
tags: ["System"]
),
MailThread(
routeID: "investor-update",
mailbox: .inbox,
subject: "Investor update before next Friday",
participants: [investor, me],
messages: [
MailMessage(
routeID: "investor-update-1",
sender: investor,
recipients: [me],
sentAt: .now.addingTimeInterval(-3600 * 26),
body: "Could you send a concise product update and a few screenshots of the new mail experience before Friday? Interested in how you are differentiating from commodity inboxes."
)
],
isUnread: true,
isStarred: false,
tags: ["External"]
),
MailThread(
routeID: "search-ranking-polish",
mailbox: .sent,
subject: "Re: Search ranking polish",
participants: [alex, me],
messages: [
MailMessage(
routeID: "search-ranking-polish-1",
sender: alex,
recipients: [me],
sentAt: .now.addingTimeInterval(-3600 * 30),
body: "The current search sort is useful, but I still feel too much recency over intent."
),
MailMessage(
routeID: "search-ranking-polish-2",
sender: me,
recipients: [alex],
sentAt: .now.addingTimeInterval(-3600 * 28),
body: "Agreed. I want us to bias toward active collaborators and threads with lightweight action language like review, approve, or ship."
)
],
isUnread: false,
isStarred: false,
tags: ["Search"]
),
MailThread(
routeID: "welcome-to-socialio",
mailbox: .drafts,
subject: "Welcome to social.io mail",
participants: [me, nora],
messages: [
MailMessage(
routeID: "welcome-to-socialio-1",
sender: me,
recipients: [nora],
sentAt: .now.addingTimeInterval(-3600 * 6),
body: "Thanks for joining the early design partner group. Here is a quick overview of our calm, collaborative take on email...",
isDraft: true
)
],
isUnread: false,
isStarred: false,
tags: ["Draft"]
),
MailThread(
routeID: "roadmap-notes",
mailbox: .archive,
subject: "Roadmap notes from product sync",
participants: [nora, alex, me],
messages: [
MailMessage(
routeID: "roadmap-notes-1",
sender: nora,
recipients: [alex, me],
sentAt: .now.addingTimeInterval(-3600 * 72),
body: "Captured the big roadmap themes: faster triage, identity-rich threads, and calmer notifications. I archived the raw notes after cleanup."
)
],
isUnread: false,
isStarred: true,
tags: ["Product"]
)
]
}
}

File diff suppressed because it is too large Load Diff