Vorssaint-Utils Dependencies: System Requirements and Build Guide

Vorssaint-Utils requires zero external Swift packages and depends only on two macOS system libraries—HIDEventSystem and VMStatisticsCompat—to build the executable target.

Vorssaint-Utils is a pure-Swift macOS utility designed to operate without third-party dependencies. As implemented in vorssaint/vorssaint-utils, the project deliberately avoids external Swift Package Manager (SPM) libraries, relying exclusively on low-level system wrappers that interface directly with native macOS APIs.

No External Swift Package Dependencies

The repository contains no Package.resolved file, confirming that no external dependencies are pinned or locked. According to the source analysis of Package.swift, the manifest declares no URL-based package dependencies, eliminating risks associated with supply chain attacks or version conflicts common in projects using Alamofire, SwiftUI-Extensions, or other popular packages.

Required macOS System Libraries

The build process requires only two system libraries that ship with the repository itself:

HIDEventSystem for Input Handling

HIDEventSystem provides thin wrappers around the macOS HID (Human Interface Device) event subsystem. Defined in Sources/HIDEventSystem/module.modulemap, this library enables the app to register global keyboard and mouse gesture listeners outside the standard responder chain.

VMStatisticsCompat for System Monitoring

VMStatisticsCompat supplies a compatibility layer for macOS VM statistics APIs. Located in Sources/VMStatisticsCompat/module.modulemap, this library bridges kernel-level memory statistics to Swift, powering the built-in system-monitor panels with data about free and active memory pages.

Build Configuration in Package.swift

Lines 11-18 of Package.swift declare the executable target and its local system library dependencies:

.executableTarget(
    name: "Vorssaint",
    dependencies: ["VMStatisticsCompat", "HIDEventSystem"],
    path: "Sources/Vorssaint"
)

This configuration links the Vorssaint executable against both system libraries without pulling in any remote packages.

Usage in Source Files

The dependencies are utilized throughout the codebase to handle global shortcuts and system monitoring.

Global Gesture Handling

In Sources/Vorssaint/UI/WindowGestureControls.swift, the HIDEventSystem registers application-wide hotkeys:

import HIDEventSystem

let hotKey = HIDEventSystem.registerShortcut(
    keyCode: kVK_ANSI_S,
    modifiers: [.command, .option],
    action: { print("Super-Key triggered!") }
)

Memory Statistics Queries

The Sources/Vorssaint/UI/Settings/WindowLayoutSettings.swift file queries VM statistics to adjust UI elements dynamically:

import VMStatisticsCompat

if let stats = VMStatisticsCompat.current() {
    print("Free memory: \(stats.freeBytes) bytes")
    print("Active memory: \(stats.activeBytes) bytes")
}

The entry point at Sources/Vorssaint/main.swift orchestrates these components, initializing the HID event listeners and system monitor panels on launch.

Summary

• Zero external dependencies: No third-party Swift packages or Package.resolved file exists in the repository.
• Two system libraries required: HIDEventSystem and VMStatisticsCompat provide native API access.
• Pure Swift build: The project compiles on macOS 14+ using only the Swift toolchain and system frameworks.
• Deterministic builds: Local system libraries in Sources/ ensure consistent compilation across environments.

Frequently Asked Questions

Does vorssaint-utils require CocoaPods or Carthage?

No. The project uses Swift Package Manager exclusively and contains no Podfile or Cartfile. You can clone the repository and run swift build immediately without installing additional dependency managers, as all required code resides in the local Sources/ directory.

What macOS version is needed to build vorssaint-utils?

The utility targets macOS 14 and later. This requirement stems from the VM statistics APIs wrapped by VMStatisticsCompat and the Swift toolchain features used in Sources/Vorssaint/main.swift. Ensure your build machine runs macOS 14+ with Xcode 15 or a compatible Swift toolchain.

Why does vorssaint-utils avoid third-party packages?

The maintainers chose a zero-dependency architecture to minimize binary size, eliminate supply chain vulnerabilities, and ensure the utility remains lightweight. By wrapping only the specific macOS HID and VM statistics APIs needed, the project maintains full control over implementation details without importing unused functionality from larger libraries.

How can I verify the dependency list myself?

Examine Package.swift at lines 11-18 to confirm only "VMStatisticsCompat" and "HIDEventSystem" appear in the dependencies array. Additionally, check for the absence of a Package.resolved file in the repository root, which would indicate locked external versions if third-party packages were present.

{
  "mcpServers": {
    "instagit": {
      "command": "npx",
      "args": ["-y", "instagit@latest"]
    }
  }
}