@opentray/ext-badge-darwin-arm64 0.1.0

package/README.md

@@ -0,0 +1,24 @@
+# @opentray/ext-badge-darwin-arm64
+
+macOS arm64 Dock helper app package for `@opentray/ext-badge`.
+
+This package owns the Dock-facing helper bundle used to present badge state with a real
+application identity. The helper is intentionally separate from the broker process.
+It currently projects badge text, overlay, attention, and click/quit lifecycle only; progress is not a Dock projection on this helper.
+
+## Build
+
+```bash
+bash scripts/release/build-badge-dock-helper.sh /tmp/OpenTrayBadgeHelper.app.zip
+```
+
+## Runtime knobs
+
+- `OPENTRAY_BADGE_DOCK_TITLE`
+- `OPENTRAY_BADGE_DOCK_BADGE`
+- `OPENTRAY_BADGE_DOCK_ICON_NAME`
+- `OPENTRAY_BADGE_DOCK_ICON_PATH`
+- `OPENTRAY_BADGE_DOCK_CLICK_SIGNAL`
+- `OPENTRAY_BADGE_DOCK_LOG`
+
+The helper stays source-only in git. The app bundle is staged locally or in release jobs.

package/app/Info.plist

@@ -0,0 +1,32 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>CFBundleDevelopmentRegion</key>
+	<string>$(DEVELOPMENT_LANGUAGE)</string>
+	<key>CFBundleExecutable</key>
+	<string>OpenTrayBadgeHelper</string>
+	<key>CFBundleIconFile</key>
+	<string>AppIcon</string>
+	<key>CFBundleIdentifier</key>
+	<string>com.opentray.ext-badge.helper</string>
+	<key>CFBundleInfoDictionaryVersion</key>
+	<string>6.0</string>
+	<key>CFBundleName</key>
+	<string>OpenTray Badge Dock Helper</string>
+	<key>CFBundleDisplayName</key>
+	<string>OpenTray Badge</string>
+	<key>CFBundlePackageType</key>
+	<string>APPL</string>
+	<key>CFBundleShortVersionString</key>
+	<string>1.0</string>
+	<key>CFBundleVersion</key>
+	<string>1</string>
+	<key>LSMinimumSystemVersion</key>
+	<string>13.0</string>
+	<key>NSHighResolutionCapable</key>
+	<true/>
+	<key>NSPrincipalClass</key>
+	<string>NSApplication</string>
+</dict>
+</plist>

package/app/main.swift

@@ -0,0 +1,190 @@
+import AppKit
+import Foundation
+
+final class BadgeDockHelper: NSObject, NSApplicationDelegate {
+    private let dockTitle = ProcessInfo.processInfo.environment["OPENTRAY_BADGE_DOCK_TITLE"]
+        ?? "OpenTray Badge"
+    private let dockIconName = ProcessInfo.processInfo.environment["OPENTRAY_BADGE_DOCK_ICON_NAME"]
+        ?? "bell.badge"
+    private let dockIconPath = ProcessInfo.processInfo.environment["OPENTRAY_BADGE_DOCK_ICON_PATH"]
+    private let helperLog = argumentValue("--log-path") ?? ProcessInfo.processInfo.environment["OPENTRAY_BADGE_DOCK_LOG"]
+    private let clickSignalPath = argumentValue("--click-signal") ?? ProcessInfo.processInfo.environment["OPENTRAY_BADGE_DOCK_CLICK_SIGNAL"]
+    private let quitSignalPath = argumentValue("--quit-signal") ?? ProcessInfo.processInfo.environment["OPENTRAY_BADGE_DOCK_QUIT_SIGNAL"]
+    private let quitNotifyPath = argumentValue("--quit-notify") ?? ProcessInfo.processInfo.environment["OPENTRAY_BADGE_DOCK_QUIT_NOTIFY"]
+    private let stateDir = argumentValue("--state-dir") ?? ProcessInfo.processInfo.environment["OPENTRAY_BADGE_DOCK_STATE_DIR"]
+    private let stateBadgePath = argumentValue("--badge-path") ?? ProcessInfo.processInfo.environment["OPENTRAY_BADGE_DOCK_BADGE_PATH"]
+    private let stateTitlePath = argumentValue("--title-path") ?? ProcessInfo.processInfo.environment["OPENTRAY_BADGE_DOCK_TITLE_PATH"]
+    private let stateIconNamePath = argumentValue("--icon-path") ?? ProcessInfo.processInfo.environment["OPENTRAY_BADGE_DOCK_ICON_NAME_PATH"]
+    private let forceMultiOpen = CommandLine.arguments.contains("--force-multi-open")
+    private var lifecycleTimer: Timer?
+    private var stateTimer: Timer?
+    private var cachedDockTitle: String
+    private var cachedDockBadge: String?
+    private var cachedDockIconName: String
+    private var cachedDockIconPath: String?
+    private var renderedSignature: String = ""
+
+    override init() {
+        self.cachedDockTitle = argumentValue("--title") ?? ProcessInfo.processInfo.environment["OPENTRAY_BADGE_DOCK_TITLE"] ?? "OpenTray Badge"
+        self.cachedDockBadge = argumentValue("--badge") ?? ProcessInfo.processInfo.environment["OPENTRAY_BADGE_DOCK_BADGE"]
+        self.cachedDockIconName = argumentValue("--icon-name") ?? ProcessInfo.processInfo.environment["OPENTRAY_BADGE_DOCK_ICON_NAME"] ?? "bell.badge"
+        self.cachedDockIconPath = ProcessInfo.processInfo.environment["OPENTRAY_BADGE_DOCK_ICON_PATH"]
+        super.init()
+    }
+
+    func applicationDidFinishLaunching(_ notification: Notification) {
+        NSApplication.shared.setActivationPolicy(.regular)
+        NSApplication.shared.applicationIconImage = placeholderDockIcon()
+        applyDockBadge(cachedDockBadge)
+        log("launched title=\(cachedDockTitle)")
+        startLifecycleWatch()
+        startStateWatch()
+        NSApp.activate(ignoringOtherApps: true)
+    }
+
+    func applicationShouldHandleReopen(_ sender: NSApplication, hasVisibleWindows flag: Bool) -> Bool {
+        log("dock-reopen")
+        signalDockClick()
+        sender.activate(ignoringOtherApps: true)
+        return true
+    }
+
+    func applicationWillTerminate(_ notification: Notification) {
+        signalDockQuitNotify()
+    }
+
+    private func resolveDockIcon() -> NSImage? {
+        if let cachedDockIconPath, !cachedDockIconPath.isEmpty {
+            return NSImage(contentsOfFile: cachedDockIconPath)
+        }
+        return NSImage(systemSymbolName: cachedDockIconName, accessibilityDescription: cachedDockTitle)
+    }
+
+    private func applyDockBadge(_ badge: String?) {
+        guard let badge, !badge.isEmpty else {
+            NSApp.dockTile.badgeLabel = nil
+            return
+        }
+        NSApp.dockTile.badgeLabel = badge
+    }
+
+    private func signalDockClick() {
+        guard let clickSignalPath, !clickSignalPath.isEmpty else {
+            return
+        }
+        let payload = "\(Date().timeIntervalSince1970)\n"
+        try? payload.write(toFile: clickSignalPath, atomically: true, encoding: .utf8)
+    }
+
+    private func startLifecycleWatch() {
+        guard let quitSignalPath, !quitSignalPath.isEmpty else {
+            return
+        }
+        if forceMultiOpen {
+            return
+        }
+        lifecycleTimer = Timer.scheduledTimer(withTimeInterval: 0.25, repeats: true) { [weak self] timer in
+            guard let self else {
+                timer.invalidate()
+                return
+            }
+            if FileManager.default.fileExists(atPath: quitSignalPath) {
+                timer.invalidate()
+                NSApp.terminate(self)
+            }
+        }
+    }
+
+    private func startStateWatch() {
+        guard let stateDir, !stateDir.isEmpty else {
+            return
+        }
+        stateTimer = Timer.scheduledTimer(withTimeInterval: 0.25, repeats: true) { [weak self] _ in
+            self?.refreshDockState()
+        }
+    }
+
+    private func refreshDockState() {
+        var changed = false
+        if let stateBadgePath, let badge = readTrimmedFile(stateBadgePath) {
+            cachedDockBadge = badge.isEmpty ? nil : badge
+            changed = true
+        }
+        if let stateTitlePath, let title = readTrimmedFile(stateTitlePath), !title.isEmpty {
+            cachedDockTitle = title
+            changed = true
+        }
+        if let stateIconNamePath, let iconName = readTrimmedFile(stateIconNamePath), !iconName.isEmpty {
+            cachedDockIconName = iconName
+            changed = true
+        }
+        if changed {
+            updateDockTile()
+        }
+    }
+
+    private func readTrimmedFile(_ path: String) -> String? {
+        guard FileManager.default.fileExists(atPath: path) else {
+            return nil
+        }
+        return (try? String(contentsOfFile: path, encoding: .utf8))?.trimmingCharacters(in: .whitespacesAndNewlines)
+    }
+
+    private func updateDockTile() {
+        let signature = [cachedDockTitle, cachedDockBadge ?? "", cachedDockIconName, cachedDockIconPath ?? ""].joined(separator: "|")
+        guard signature != renderedSignature else {
+            return
+        }
+        renderedSignature = signature
+        applyDockBadge(cachedDockBadge)
+        NSApplication.shared.applicationIconImage = resolveDockIcon() ?? placeholderDockIcon()
+        NSApplication.shared.dockTile.display()
+    }
+
+    private func placeholderDockIcon() -> NSImage {
+        let image = NSImage(size: NSSize(width: 64, height: 64))
+        image.lockFocus()
+        NSColor.clear.set()
+        NSBezierPath(rect: NSRect(x: 0, y: 0, width: 64, height: 64)).fill()
+        image.unlockFocus()
+        return image
+    }
+
+    private func signalDockQuitNotify() {
+        guard let quitNotifyPath, !quitNotifyPath.isEmpty else {
+            return
+        }
+        let payload = "\(Date().timeIntervalSince1970)\n"
+        try? payload.write(toFile: quitNotifyPath, atomically: true, encoding: .utf8)
+    }
+
+    private func log(_ message: String) {
+        NSLog("OpenTray badge helper: %@", message)
+        if let helperLog {
+            try? "\(message)\n".appendToFile(atPath: helperLog)
+        }
+    }
+}
+
+private extension String {
+    func appendToFile(atPath path: String) throws {
+        let url = URL(fileURLWithPath: path)
+        let existing = (try? String(contentsOf: url, encoding: .utf8)) ?? ""
+        try (existing + self).write(to: url, atomically: true, encoding: .utf8)
+    }
+}
+
+private func argumentValue(_ name: String) -> String? {
+    let arguments = CommandLine.arguments
+    for index in 0..<arguments.count {
+        if arguments[index] == name, index + 1 < arguments.count {
+            return arguments[index + 1]
+        }
+    }
+    return nil
+}
+
+let delegate = BadgeDockHelper()
+NSApplication.shared.delegate = delegate
+NSApplication.shared.setActivationPolicy(.regular)
+NSApplication.shared.run()

package/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "@opentray/ext-badge-darwin-arm64",
+  "version": "0.1.0",
+  "description": "OpenTray badge Dock helper app for macOS arm64.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/jixoai/opentray"
+  },
+  "files": [
+    "README.md",
+    "app"
+  ],
+  "os": [
+    "darwin"
+  ],
+  "cpu": [
+    "arm64"
+  ],
+  "peerDependencies": {
+    "opentray": ">=0.0.0"
+  }
+}