@lattices/cli 0.3.0

package/app/Sources/AppTypeClassifier.swift

@@ -0,0 +1,70 @@
+import Foundation
+
+enum AppType: String, CaseIterable {
+    case terminal
+    case editor
+    case browser
+    case chat
+    case media
+    case design
+    case system
+    case other
+
+    var label: String { rawValue }
+}
+
+enum AppTypeClassifier {
+    private static let nameMap: [String: AppType] = [
+        // Terminals
+        "iTerm2": .terminal, "Terminal": .terminal, "Alacritty": .terminal,
+        "kitty": .terminal, "Warp": .terminal, "Hyper": .terminal,
+        "WezTerm": .terminal, "Rio": .terminal, "Ghostty": .terminal,
+
+        // Editors / IDEs
+        "Xcode": .editor, "Code": .editor, "Visual Studio Code": .editor,
+        "Cursor": .editor, "Sublime Text": .editor, "TextEdit": .editor,
+        "Nova": .editor, "BBEdit": .editor, "Zed": .editor,
+        "IntelliJ IDEA": .editor, "WebStorm": .editor, "PyCharm": .editor,
+        "CLion": .editor, "GoLand": .editor, "RustRover": .editor,
+        "Android Studio": .editor, "Fleet": .editor, "Neovide": .editor,
+
+        // Browsers
+        "Safari": .browser, "Google Chrome": .browser, "Firefox": .browser,
+        "Arc": .browser, "Brave Browser": .browser, "Microsoft Edge": .browser,
+        "Orion": .browser, "Vivaldi": .browser, "Opera": .browser,
+        "Chrome": .browser, "Zen Browser": .browser,
+
+        // Chat / Communication
+        "Slack": .chat, "Discord": .chat, "Messages": .chat,
+        "Telegram": .chat, "WhatsApp": .chat, "Signal": .chat,
+        "Teams": .chat, "Microsoft Teams": .chat, "Zoom": .chat,
+        "FaceTime": .chat, "Skype": .chat,
+
+        // Media
+        "Spotify": .media, "Music": .media, "QuickTime Player": .media,
+        "VLC": .media, "IINA": .media, "Podcasts": .media,
+        "Photos": .media, "Preview": .media, "mpv": .media,
+
+        // Design
+        "Figma": .design, "Sketch": .design, "Pixelmator Pro": .design,
+        "Affinity Designer 2": .design, "Affinity Photo 2": .design,
+        "Adobe Photoshop": .design, "Adobe Illustrator": .design,
+        "Blender": .design, "OmniGraffle": .design,
+
+        // System
+        "Finder": .system, "System Preferences": .system, "System Settings": .system,
+        "Activity Monitor": .system, "Console": .system, "Disk Utility": .system,
+        "Keychain Access": .system,
+    ]
+
+    static func classify(_ appName: String) -> AppType {
+        if let exact = nameMap[appName] { return exact }
+        // Substring fallback
+        let lower = appName.lowercased()
+        if lower.contains("terminal") || lower.contains("term") { return .terminal }
+        if lower.contains("code") || lower.contains("studio") || lower.contains("edit") { return .editor }
+        if lower.contains("chrome") || lower.contains("firefox") || lower.contains("safari") || lower.contains("browser") { return .browser }
+        if lower.contains("slack") || lower.contains("discord") || lower.contains("chat") || lower.contains("teams") { return .chat }
+        return .other
+    }
+}

package/app/Sources/AppWindowShell.swift

@@ -0,0 +1,63 @@
+import AppKit
+import SwiftUI
+
+/// Shared factory for standalone NSWindow chrome.
+/// Every managed window (Screen Map, Settings, Diagnostics, etc.) uses this
+/// to get consistent title bar styling, dark appearance, and positioning.
+struct AppWindowShell {
+
+    struct Config {
+        var title: String
+        var titleVisible: Bool = true
+        var initialSize: NSSize
+        var minSize: NSSize
+        var maxSize: NSSize
+        var miniaturizable: Bool = true
+    }
+
+    /// Create a styled NSWindow hosting a SwiftUI root view.
+    static func makeWindow<V: View>(config: Config, rootView: V) -> NSWindow {
+        let hosting = NSHostingView(rootView: rootView.preferredColorScheme(.dark))
+        hosting.frame = NSRect(origin: .zero, size: config.initialSize)
+
+        var styleMask: NSWindow.StyleMask = [.titled, .closable, .resizable]
+        if config.miniaturizable { styleMask.insert(.miniaturizable) }
+
+        let w = NSWindow(
+            contentRect: NSRect(origin: .zero, size: config.initialSize),
+            styleMask: styleMask,
+            backing: .buffered,
+            defer: false
+        )
+        w.contentView = hosting
+        w.title = config.title
+        w.titlebarAppearsTransparent = true
+        w.titleVisibility = config.titleVisible ? .visible : .hidden
+        w.isReleasedWhenClosed = false
+        w.backgroundColor = NSColor(red: 0.11, green: 0.11, blue: 0.12, alpha: 1.0)
+        w.appearance = NSAppearance(named: .darkAqua)
+        w.minSize = config.minSize
+        w.maxSize = config.maxSize
+        return w
+    }
+
+    /// Center the window on screen, nudged 8% above vertical center.
+    /// Clamps to 92% screen width / 85% screen height.
+    static func positionCentered(_ window: NSWindow) {
+        guard let screen = NSScreen.main else { return }
+        let frame = screen.visibleFrame
+        let size = window.frame.size
+        let w = min(size.width, frame.width * 0.92)
+        let h = min(size.height, frame.height * 0.85)
+        let x = frame.midX - w / 2
+        let y = frame.midY - h / 2 + (frame.height * 0.08)
+        window.setFrame(NSRect(x: x, y: y, width: w, height: h), display: true)
+    }
+
+    /// Bring the window to front and update activation policy.
+    static func present(_ window: NSWindow) {
+        window.makeKeyAndOrderFront(nil)
+        NSApp.activate(ignoringOtherApps: true)
+        AppDelegate.updateActivationPolicy()
+    }
+}

package/app/Sources/CheatSheetHUD.swift

@@ -0,0 +1,332 @@
+import AppKit
+import SwiftUI
+
+// MARK: - CheatSheetHUD (singleton window controller)
+
+final class CheatSheetHUD {
+    static let shared = CheatSheetHUD()
+
+    private var panel: NSPanel?
+    private var localMonitor: Any?
+    private var globalMonitor: Any?
+
+    var isVisible: Bool { panel?.isVisible ?? false }
+
+    func toggle() {
+        if isVisible {
+            dismiss()
+        } else {
+            show()
+        }
+    }
+
+    func show() {
+        guard panel == nil else { return }
+
+        let view = CheatSheetView()
+            .preferredColorScheme(.dark)
+
+        let hosting = NSHostingView(rootView: view)
+
+        let p = NSPanel(
+            contentRect: NSRect(x: 0, y: 0, width: 520, height: 420),
+            styleMask: [.borderless, .nonactivatingPanel],
+            backing: .buffered,
+            defer: false
+        )
+        p.isOpaque = false
+        p.backgroundColor = .clear
+        p.level = .floating
+        p.hasShadow = true
+        p.hidesOnDeactivate = false
+        p.isReleasedWhenClosed = false
+        p.isMovableByWindowBackground = false
+        p.contentView = hosting
+
+        // Center on the screen containing the mouse cursor
+        let mouseLocation = NSEvent.mouseLocation
+        let screen = NSScreen.screens.first(where: { $0.frame.contains(mouseLocation) }) ?? NSScreen.main ?? NSScreen.screens.first!
+        let screenFrame = screen.visibleFrame
+        let x = screenFrame.midX - 260
+        let y = screenFrame.midY - 210
+        p.setFrameOrigin(NSPoint(x: x, y: y))
+
+        p.alphaValue = 0
+        p.orderFrontRegardless()
+
+        NSAnimationContext.runAnimationGroup { ctx in
+            ctx.duration = 0.15
+            p.animator().alphaValue = 1.0
+        }
+
+        self.panel = p
+        installMonitors()
+    }
+
+    func dismiss() {
+        guard let p = panel else { return }
+        removeMonitors()
+
+        NSAnimationContext.runAnimationGroup({ ctx in
+            ctx.duration = 0.2
+            p.animator().alphaValue = 0
+        }) { [weak self] in
+            p.orderOut(nil)
+            self?.panel = nil
+        }
+    }
+
+    // MARK: - Event monitors
+
+    private func installMonitors() {
+        // Escape key dismisses (global — panel is non-activating so keys go to frontmost app)
+        localMonitor = NSEvent.addGlobalMonitorForEvents(matching: .keyDown) { [weak self] event in
+            if event.keyCode == 53 { // Escape
+                self?.dismiss()
+            }
+        }
+
+        // Click outside dismisses
+        globalMonitor = NSEvent.addGlobalMonitorForEvents(matching: [.leftMouseDown, .rightMouseDown]) { [weak self] _ in
+            self?.dismiss()
+        }
+    }
+
+    private func removeMonitors() {
+        if let m = localMonitor { NSEvent.removeMonitor(m); localMonitor = nil }
+        if let m = globalMonitor { NSEvent.removeMonitor(m); globalMonitor = nil }
+    }
+
+}
+
+// MARK: - CheatSheetView
+
+struct CheatSheetView: View {
+    @ObservedObject private var hotkeyStore = HotkeyStore.shared
+
+    var body: some View {
+        VStack(spacing: 0) {
+            // Title
+            HStack {
+                Text("KEYBOARD SHORTCUTS")
+                    .font(Typo.pixel(14))
+                    .foregroundColor(Palette.textDim)
+                    .tracking(1)
+                Spacer()
+            }
+            .padding(.horizontal, 20)
+            .padding(.top, 16)
+            .padding(.bottom, 10)
+
+            Rectangle().fill(Palette.border).frame(height: 0.5)
+
+            // Two-column body
+            HStack(alignment: .top, spacing: 20) {
+                // Left column: Tiling
+                tilingColumn
+
+                Rectangle().fill(Palette.border).frame(width: 0.5)
+
+                // Right column: App + tmux
+                VStack(alignment: .leading, spacing: 16) {
+                    appColumn
+                    Rectangle().fill(Palette.border).frame(height: 0.5)
+                    tmuxColumn
+                }
+                .frame(maxWidth: .infinity, alignment: .leading)
+            }
+            .padding(.horizontal, 20)
+            .padding(.vertical, 14)
+
+            Spacer(minLength: 0)
+
+            Rectangle().fill(Palette.border).frame(height: 0.5)
+
+            // Footer
+            HStack {
+                Spacer()
+                Text("Press ESC to dismiss")
+                    .font(Typo.caption(10))
+                    .foregroundColor(Palette.textMuted)
+                Spacer()
+            }
+            .padding(.vertical, 8)
+        }
+        .frame(width: 520, height: 420)
+        .background(
+            RoundedRectangle(cornerRadius: 12)
+                .fill(Palette.bg)
+                .overlay(
+                    RoundedRectangle(cornerRadius: 12)
+                        .strokeBorder(Palette.borderLit, lineWidth: 0.5)
+                )
+        )
+        .clipShape(RoundedRectangle(cornerRadius: 12))
+    }
+
+    // MARK: - Tiling Column
+
+    private var tilingColumn: some View {
+        VStack(alignment: .leading, spacing: 10) {
+            columnHeader("Tiling")
+
+            // 3x3 grid
+            VStack(spacing: 2) {
+                HStack(spacing: 2) {
+                    tileCell(action: .tileTopLeft, label: "TL")
+                    tileCell(action: .tileTop, label: "Top")
+                    tileCell(action: .tileTopRight, label: "TR")
+                }
+                HStack(spacing: 2) {
+                    tileCell(action: .tileLeft, label: "Left")
+                    tileCell(action: .tileMaximize, label: "Max")
+                    tileCell(action: .tileRight, label: "Right")
+                }
+                HStack(spacing: 2) {
+                    tileCell(action: .tileBottomLeft, label: "BL")
+                    tileCell(action: .tileBottom, label: "Bot")
+                    tileCell(action: .tileBottomRight, label: "BR")
+                }
+            }
+            .padding(6)
+            .background(
+                RoundedRectangle(cornerRadius: 6)
+                    .fill(Color.black.opacity(0.25))
+                    .overlay(
+                        RoundedRectangle(cornerRadius: 6)
+                            .strokeBorder(Palette.border, lineWidth: 0.5)
+                    )
+            )
+
+            // Thirds row
+            HStack(spacing: 2) {
+                tileCell(action: .tileLeftThird, label: "\u{2153}L")
+                tileCell(action: .tileCenterThird, label: "\u{2153}C")
+                tileCell(action: .tileRightThird, label: "\u{2153}R")
+            }
+            .padding(6)
+            .background(
+                RoundedRectangle(cornerRadius: 6)
+                    .fill(Color.black.opacity(0.25))
+                    .overlay(
+                        RoundedRectangle(cornerRadius: 6)
+                            .strokeBorder(Palette.border, lineWidth: 0.5)
+                    )
+            )
+
+            // Center + Distribute
+            shortcutRow(action: .tileCenter)
+            shortcutRow(action: .tileDistribute)
+        }
+        .frame(maxWidth: .infinity, alignment: .leading)
+    }
+
+    // MARK: - App Column
+
+    private var appColumn: some View {
+        VStack(alignment: .leading, spacing: 8) {
+            columnHeader("App")
+
+            shortcutRow(action: .palette)
+            shortcutRow(action: .screenMap)
+            shortcutRow(action: .bezel)
+            shortcutRow(action: .cheatSheet)
+            shortcutRow(action: .desktopInventory)
+        }
+    }
+
+    // MARK: - tmux Column
+
+    private var tmuxColumn: some View {
+        VStack(alignment: .leading, spacing: 6) {
+            columnHeader("Inside tmux")
+
+            tmuxRow("Detach", keys: ["Ctrl+B", "D"])
+            tmuxRow("Kill pane", keys: ["Ctrl+B", "X"])
+            tmuxRow("Pane left", keys: ["Ctrl+B", "\u{2190}"])
+            tmuxRow("Pane right", keys: ["Ctrl+B", "\u{2192}"])
+            tmuxRow("Zoom toggle", keys: ["Ctrl+B", "Z"])
+            tmuxRow("Scroll mode", keys: ["Ctrl+B", "["])
+        }
+    }
+
+    // MARK: - Shared components
+
+    private func columnHeader(_ title: String) -> some View {
+        Text(title.uppercased())
+            .font(Typo.pixel(12))
+            .foregroundColor(Palette.textDim)
+            .tracking(1)
+    }
+
+    private func tileCell(action: HotkeyAction, label: String) -> some View {
+        let binding = hotkeyStore.bindings[action]
+        let badgeText = binding?.displayParts.last ?? ""
+
+        return VStack(spacing: 3) {
+            Text(label)
+                .font(Typo.caption(9))
+                .foregroundColor(Palette.textDim)
+            Text(badgeText)
+                .font(Typo.geistMonoBold(9))
+                .foregroundColor(Palette.text)
+        }
+        .frame(maxWidth: .infinity)
+        .frame(height: 38)
+        .background(
+            RoundedRectangle(cornerRadius: 4)
+                .fill(Palette.surface)
+                .overlay(
+                    RoundedRectangle(cornerRadius: 4)
+                        .strokeBorder(Palette.border, lineWidth: 0.5)
+                )
+        )
+    }
+
+    private func shortcutRow(action: HotkeyAction) -> some View {
+        let binding = hotkeyStore.bindings[action]
+        return HStack(spacing: 8) {
+            if let parts = binding?.displayParts {
+                HStack(spacing: 3) {
+                    ForEach(parts, id: \.self) { part in
+                        keyBadge(part)
+                    }
+                }
+            }
+            Text(action.label)
+                .font(Typo.caption(11))
+                .foregroundColor(Palette.textDim)
+            Spacer()
+        }
+    }
+
+    private func tmuxRow(_ label: String, keys: [String]) -> some View {
+        HStack(spacing: 8) {
+            HStack(spacing: 3) {
+                ForEach(keys, id: \.self) { key in
+                    keyBadge(key)
+                }
+            }
+            Text(label)
+                .font(Typo.caption(11))
+                .foregroundColor(Palette.textDim)
+            Spacer()
+        }
+    }
+
+    private func keyBadge(_ key: String) -> some View {
+        Text(key)
+            .font(Typo.geistMonoBold(10))
+            .foregroundColor(Palette.text)
+            .padding(.horizontal, 6)
+            .padding(.vertical, 3)
+            .background(
+                RoundedRectangle(cornerRadius: 3)
+                    .fill(Palette.surface)
+                    .overlay(
+                        RoundedRectangle(cornerRadius: 3)
+                            .strokeBorder(Palette.border, lineWidth: 0.5)
+                    )
+            )
+    }
+}