diff --git a/APPROBATION.md b/APPROBATION.md
index 06a35c4..8da0ee2 100644
--- a/APPROBATION.md
+++ b/APPROBATION.md
@@ -1,10 +1,18 @@
-# Approbation Matrix / PerseusDarkMode 2.0.0 && 2.0.1 && 2.0.2 && 2.0.3 && 2.0.4 && 2.1.0 && 2.1.1
+# Approbation Matrix for PerseusDarkMode
+
+## Approbated Versions
+
+> This report is actual for the following product versions:
+
+v2.0.0 v2.0.1 v2.0.2 v2.0.3 v2.0.4 v2.1.0 v2.1.1 && **v2.2.0**
+
+## Approbation Note
> NOTE: To catch all log messages Mac Console should be started first then after a little while the logged app.
> Compilation: macOS Monterey 12.7.6 / Xcode 14.2
-## macOS approbation result
+# macOS approbation result
> The approbation macOS app for PerseusDarkMode is [Arkenstone](https://github.com/perseusrealdeal/Arkenstone).
@@ -19,7 +27,7 @@
| Sonoma | 14.7 | ok | - |
| Sequoia | 15.3 | ok | - |
-## iOS approbation result
+# iOS approbation result
> The approbation iOS app for PerseusDarkMode is [The One Ring](https://github.com/perseusrealdeal/TheOneRing).
@@ -28,9 +36,9 @@
| iPad Air | no | 12.5.7 | ok | - |
| iPhone SE (3rd) | yes | 16.2 | ok | - |
-## A3 environment
+# A3 environment
-### List of available Apple machines
+## List of available Apple machines
> Excluded: virtualization (e.g. VirtualBox) and hackintosh
@@ -39,7 +47,7 @@
| Mac mini | 16GB | SATA 480GB, NVMe 256GB |
| MacBook Pro | 8GB | 256GB |
-### System configuration for A3 environment
+## System configuration for A3 environment
| macOS | Version | Machine | Xcode | OpenCore | Git Client |
| ----------- | ------- | ----------- | ------ | -------- | -------------- |
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 404e20c..aa6b671 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -5,6 +5,24 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
Dates in this file meets Gregorian calendar. Date in format YYYY-MM-DD.
+## [2.2.0] - [2026-03-03], PerseusDarkMode
+
+### Included
+
+- The support code to the main code.
+
+### Renamed
+
+- `PDMStar.swift` to `TheDarknessStar.swift`.
+
+### Added:
+
+- Minor changes to documentation.
+
+### Updated:
+
+- CPL dependency to v1.7.1.
+
## [2.1.1] - [2025-11-30], PerseusDarkMode
### Updated
diff --git a/LICENSE b/LICENSE
index 27130df..1e78bb2 100644
--- a/LICENSE
+++ b/LICENSE
@@ -4,9 +4,9 @@ Copyright © 7530 - 7534 Mikhail A. Zhigulin of Novosibirsk
Copyright © 7533 - 7534 PerseusRealDeal
The year starts from the creation of the world according to a Slavic calendar.
-September, the 1st of Slavic year.
+September, the 1st of Slavic year. For instance, "Sep 01, 2025" is the beginning of 7534.
-Use Stars to adopt for the specifics you need.
+Stars to adopt for the specifics you need.
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
diff --git a/PDMStar.swift b/PDMStar.swift
deleted file mode 100644
index c46a956..0000000
--- a/PDMStar.swift
+++ /dev/null
@@ -1,456 +0,0 @@
-//
-// PDMStar.swift
-// Version: 2.1.1
-//
-// Standalone PerseusDarkMode.
-//
-//
-// For iOS and macOS only. Use Stars to adopt for the specifics you need.
-//
-// DESC: THE DARKNESS YOU CAN FORCE
-//
-// Created by Mikhail Zhigulin in 7530.
-//
-// Copyright © 7530 - 7534 Mikhail Zhigulin of Novosibirsk
-// Copyright © 7533 - 7534 PerseusRealDeal
-//
-// All rights reserved.
-//
-//
-// MIT License
-//
-// Copyright © 7530 - 7534 Mikhail A. Zhigulin of Novosibirsk
-// Copyright © 7533 - 7534 PerseusRealDeal
-//
-// The year starts from the creation of the world according to a Slavic calendar.
-// September, the 1st of Slavic year. It means that "Sep 01, 2025" is the beginning of 7534.
-//
-// Permission is hereby granted, free of charge, to any person obtaining a copy
-// of this software and associated documentation files (the "Software"), to deal
-// in the Software without restriction, including without limitation the rights
-// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-// copies of the Software, and to permit persons to whom the Software is
-// furnished to do so, subject to the following conditions:
-//
-// The above copyright notice and this permission notice shall be included in all
-// copies or substantial portions of the Software.
-//
-// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-// SOFTWARE.
-//
-// swiftlint:disable file_length
-//
-
-#if canImport(UIKit)
-import UIKit
-#elseif canImport(Cocoa)
-import Cocoa
-#endif
-
-// import ConsolePerseusLogger
-
-public let APPEARANCE_DEFAULT = AppearanceStyle.light
-
-public let DARK_MODE_USER_CHOICE_KEY = "DarkModeUserChoiceOptionKey"
-public let DARK_MODE_USER_CHOICE_DEFAULT = DarkModeOption.auto
-
-public let DARK_MODE_SETTINGS_KEY = "DarkModeSettingsKey"
-
-#if os(macOS)
-public var DARK_APPEARANCE_DEFAULT_IN_USE: NSAppearance {
- guard let darkAppearanceOS = DARK_APPEARANCE_DEFAULT else {
- if #available(macOS 10.14, *) {
- return NSAppearance(named: .darkAqua)!
- } // For HighSierra.
- return NSAppearance(named: .vibrantDark)!
- }
- return darkAppearanceOS
-}
-public var DARK_APPEARANCE_DEFAULT: NSAppearance?
-public var LIGHT_APPEARANCE_DEFAULT_IN_USE = NSAppearance(named: .aqua)!
-#endif
-
-public extension Notification.Name {
- static let MakeAppearanceUpNotification =
- Notification.Name("MakeAppearanceUpNotification")
-#if os(macOS)
- static let AppleInterfaceThemeChangedNotification =
- Notification.Name("AppleInterfaceThemeChangedNotification")
-#endif
-}
-
-// swiftlint:disable identifier_name
-public extension NSObject {
- var DarkMode: DarkMode { return DarkModeAgent.shared }
- var DarkModeUserChoice: DarkModeOption { return DarkModeAgent.DarkModeUserChoice }
-}
-// swiftlint:enable identifier_name
-
-public enum AppearanceStyle: Int, CustomStringConvertible {
-
- case light = 0
- case dark = 1
-
- public var description: String {
- switch self {
- case .light:
- return ".light"
- case .dark:
- return ".dark"
- }
- }
-}
-
-public enum DarkModeOption: Int, CustomStringConvertible {
-
- case auto = 0
- case on = 1
- case off = 2
-
- public var description: String {
- switch self {
- case .auto:
- return ".auto"
- case .on:
- return ".on"
- case .off:
- return ".off"
- }
- }
-}
-
-public class DarkMode: NSObject {
-
- public var style: AppearanceStyle { return appearance }
-
- @objc public dynamic var styleObservable: Int = APPEARANCE_DEFAULT.rawValue
-
- internal var appearance: AppearanceStyle = APPEARANCE_DEFAULT {
- didSet { styleObservable = style.rawValue }
- }
-}
-
-public class DarkModeAgent {
-
- // MARK: - Properties
-
- public static var shared: DarkMode = { _ = instance; return DarkMode() }()
- public static var DarkModeUserChoice: DarkModeOption {
- return userChoice
- }
-
- // MARK: - Internals
-
- private static var userChoice: DarkModeOption {
- get {
- let rawValue = ud.valueExists(forKey: DARK_MODE_USER_CHOICE_KEY) ?
- ud.integer(forKey: DARK_MODE_USER_CHOICE_KEY) :
- DARK_MODE_USER_CHOICE_DEFAULT.rawValue
-
- if let result = DarkModeOption.init(rawValue: rawValue) { return result }
- return DARK_MODE_USER_CHOICE_DEFAULT
- }
- set {
- ud.setValue(newValue.rawValue, forKey: DARK_MODE_USER_CHOICE_KEY)
-#if os(iOS)
- // Set DarkMode option for Settings bundle
- ud.setValue(newValue.rawValue, forKey: DARK_MODE_SETTINGS_KEY)
-#endif
- }
- }
-
-#if os(macOS)
- private static var distributedNCenter = DistributedNotificationCenter.default
-#endif
- private static var nCenter = NotificationCenter.default
- private static var ud = UserDefaults.standard
-
- private var observation: NSKeyValueObservation?
-
- // MARK: - Singletone
-
- private static var instance = { DarkModeAgent() }()
- private init() {
- // log.message("[\(type(of: self))].\(#function)", .info)
-#if os(macOS)
- if #available(macOS 10.14, *) {
- DarkModeAgent.distributedNCenter.addObserver(
- self,
- selector: #selector(processAppleInterfaceThemeChanged),
- name: .AppleInterfaceThemeChangedNotification,
- object: nil
- )
- observation = NSApp.observe(\.effectiveAppearance) { _, _ in
- if DarkModeAgent.userChoice == .auto {
-
- let effectiveAppearance = NSApplication.shared.effectiveAppearance
- let wanted = self.getRequired(from: effectiveAppearance)
-
- DarkModeAgent.shared.appearance = wanted
- self.notifyAllRegistered()
- }
- }
- } // For HighSierra there is no need in observation cos' system style never change.
-#endif
- }
-
- // MARK: - Contract
-
- public static func register(stakeholder: Any, selector: Selector) {
- self.nCenter.addObserver(stakeholder,
- selector: selector,
- name: .MakeAppearanceUpNotification,
- object: nil)
- }
-
- public static func force(_ userChoice: DarkModeOption) {
-
- DarkModeAgent.userChoice = userChoice
- DarkModeAgent.instance.refresh()
-
-#if os(iOS)
- DarkModeAgent.instance.notifyAllRegistered()
-#elseif os(macOS)
- if #unavailable(macOS 10.14) { // For HighSierra.
- DarkModeAgent.instance.notifyAllRegistered()
- } else if DarkModeAgent.userChoice != .auto { // If .auto observation notifies change.
- DarkModeAgent.instance.notifyAllRegistered()
- }
-#endif
- }
-
- public static func makeUp() {
- DarkModeAgent.instance.notifyAllRegistered()
- }
-
- // MARK: - iOS Contract specifics
-
-#if os(iOS)
- @available(iOS 13.0, *)
- public static func processTraitCollectionDidChange(_ previous: UITraitCollection?) {
- if let previous = previous?.userInterfaceStyle {
- if UIWindow.systemStyle.rawValue != previous.rawValue {
- DarkModeAgent.instance.processAppleInterfaceThemeChanged()
- }
- }
- }
-
- // Returns nil if DarkMode equal to User choice or no value saved otherwise new value.
- public static func isDarkModeSettingsKeyChanged() -> DarkModeOption? {
- let option = ud.valueExists(forKey: DARK_MODE_SETTINGS_KEY) ?
- ud.integer(forKey: DARK_MODE_SETTINGS_KEY) : -1
-
- guard option != -1, let settingsDarkMode = DarkModeOption.init(rawValue: option)
- else { return nil }
-
- return settingsDarkMode != userChoice ? settingsDarkMode : nil
- }
-#endif
-
- // MARK: - Implementation
-
- @objc private func processAppleInterfaceThemeChanged() {
- refresh()
- notifyAllRegistered()
- }
-
- private func refresh() {
- let choice = DarkModeAgent.userChoice
-#if os(iOS)
- let current = UIWindow.systemStyle
- let required = makeDecision(current, choice)
-
- if #available(iOS 13.0, *) {
- UIWindow.refreshKeyWindow()
- }
-
- DarkModeAgent.shared.appearance = required
-#elseif os(macOS)
- if #available(macOS 10.14, *) {
- switch choice {
- case .auto:
- NSApp.appearance = nil
- // DarkModeAgent is informed about new appearance by observation.
- case .on:
- NSApp.appearance = DARK_APPEARANCE_DEFAULT_IN_USE
- DarkModeAgent.shared.appearance = .dark
- case .off:
- NSApp.appearance = LIGHT_APPEARANCE_DEFAULT_IN_USE
- DarkModeAgent.shared.appearance = .light
- }
- } else { // For HighSierra.
- DarkModeAgent.shared.appearance = choice == .on ? .dark : .light
- }
-#endif
- }
-
- private func notifyAllRegistered() {
- DarkModeAgent.nCenter.post(name: .MakeAppearanceUpNotification, object: nil)
- }
-
-#if os(macOS)
- private func getRequired(from appearance: NSAppearance?) -> AppearanceStyle {
- let choice = DarkModeAgent.userChoice
-
- if #available(macOS 10.14, *) {
- guard choice == .auto else {
- return choice == .off ? .light : .dark
- }
-
- if let match = appearance?.bestMatch(from: [.darkAqua, .vibrantDark]) {
- return [.darkAqua, .vibrantDark].contains(match) ? .dark : .light
- }
-
- return .light
- } else { // For HighSierra.
- return choice == .off ? .dark : .light
- }
- }
-#endif
-}
-
-// MARK: - Helpers
-
-extension UserDefaults {
- public func valueExists(forKey key: String) -> Bool {
- return object(forKey: key) != nil
- }
-}
-
-public class DarkModeObserver: NSObject {
-
- public var action: ((_ newStyle: AppearanceStyle) -> Void)?
-
- private var objectToObserve = DarkModeAgent.shared
- private var observation: NSKeyValueObservation?
-
- public override init() {
- super.init()
- setupObservation()
- }
-
- public init(_ action: @escaping ((_ newStyle: AppearanceStyle) -> Void)) {
- super.init()
-
- self.action = action
- setupObservation()
- }
-
- private func setupObservation() {
- observation = objectToObserve.observe(\.styleObservable) { _, _ in
- self.action?(self.objectToObserve.style)
- }
- }
-}
-
-#if os(iOS)
-public enum SystemStyle: Int, CustomStringConvertible {
-
- case unspecified = 0
- case light = 1
- case dark = 2
-
- public var description: String {
- switch self {
- case .unspecified:
- return ".unspecified"
- case .light:
- return ".light"
- case .dark:
- return ".dark"
- }
- }
-}
-
-extension UIWindow {
-
- static var key: UIWindow? {
- if #available(iOS 13, *) {
- return UIApplication.shared.windows.first { $0.isKeyWindow }
- } else {
- return UIApplication.shared.keyWindow
- }
- }
-
- static var systemStyle: SystemStyle {
- if #available(iOS 13.0, *) {
- guard let keyWindow = UIWindow.key else { return .unspecified }
-
- switch keyWindow.traitCollection.userInterfaceStyle {
- case .unspecified:
- return .unspecified
- case .light:
- return .light
- case .dark:
- return .dark
-
- @unknown default:
- return .unspecified
- }
- } else {
- return .unspecified // For iOS 12.0 and earlier.
- }
- }
-}
-
-// MARK: - Calculating Dark Mode Required
-
-/// Calculates the current required appearance style of the app.
-///
-/// Dark Mode decision-making:
-///
-/// | User
-/// -------------+-----------------------
-/// System | auto | on | off
-/// -------------+---------+------+------
-/// .unspecified | default | dark | light
-/// .light | light | dark | light
-/// .dark | dark | dark | light
-///
-public func makeDecision(_ system: SystemStyle, _ user: DarkModeOption) -> AppearanceStyle {
-
- if (system == .unspecified) && (user == .auto) { return APPEARANCE_DEFAULT }
- if (system == .unspecified) && (user == .on) { return .dark }
- if (system == .unspecified) && (user == .off) { return .light }
-
- if (system == .light) && (user == .auto) { return .light }
- if (system == .light) && (user == .on) { return .dark }
- if (system == .light) && (user == .off) { return .light }
-
- if (system == .dark) && (user == .auto) { return .dark }
- if (system == .dark) && (user == .on) { return .dark }
- if (system == .dark) && (user == .off) { return .light }
-
- return APPEARANCE_DEFAULT
-
-}
-#endif
-
-#if os(iOS) && compiler(>=5)
-extension UIWindow {
-
- @available(iOS 13.0, *)
- public static func refreshKeyWindow() {
-
- guard let keyWindow = UIWindow.key else { return }
-
- var overrideStyle: UIUserInterfaceStyle = .unspecified
-
- switch DarkModeAgent.DarkModeUserChoice {
- case .auto:
- overrideStyle = .unspecified
- case .on:
- overrideStyle = .dark
- case .off:
- overrideStyle = .light
- }
-
- keyWindow.overrideUserInterfaceStyle = overrideStyle
- }
-}
-#endif
diff --git a/Package.swift b/Package.swift
index b651ae7..ed85bcc 100644
--- a/Package.swift
+++ b/Package.swift
@@ -1,7 +1,7 @@
// swift-tools-version:5.7
/* Package.swift
- Version: 2.1.1
+ Version: 2.2.0
For iOS and macOS only. Use Stars to adopt for the specifics you need.
diff --git a/README.md b/README.md
index ec0eb5f..5caf88e 100644
--- a/README.md
+++ b/README.md
@@ -1,57 +1,66 @@
-# PerseusDarkMode — Xcode 14.2+
+
+
+Perseus Dark Mode
+==
+
+THE DARKNESS YOU CAN FORCE
[](https://github.com/perseusrealdeal/PerseusDarkMode/actions/workflows/main.yml)
[](https://github.com/perseusrealdeal/PerseusDarkMode/actions/workflows/swiftlint.yml)
-[](/CHANGELOG.md)
+[](/CHANGELOG.md)
[](https://en.wikipedia.org/wiki/List_of_Apple_products)
[](https://en.wikipedia.org/wiki/Xcode)
[](https://www.swift.org)
-[](/LICENSE)
-> This is the great home-made product in Swift to accomplish `Dark Mode switching` task.
+[`A3 Environment`](/APPROBATION.md) • [`CHANGELOG`](/CHANGELOG.md) • [`MIT License`](/LICENSE)
-> `1:` Build option kinda `Light/Dark/System Appearance` or `On/Off/System Dark Mode`.
-> `2:` Be awared of Dark Mode changes.
+
-> `PDM` is a single author and personale solution developed in `P2P` relationship paradigm.
+---
-## Integration Capabilities
+Usages
+==
+
+> `1:` Build `Light/Dark/Auto` option.
+> `2:` Be awared of Dark Mode changes.
-[](/PDMStar.swift)
+Integration
+==
+
+[](/TheDarknessStar.swift)
[](/Package.swift)
-## Dependencies
+Dependencies
+==
-[](https://github.com/perseusrealdeal/ConsolePerseusLogger.git)
+[](https://github.com/perseusrealdeal/ConsolePerseusLogger.git)
-## Support Code
+Support Code
+==
-[](/PDMSupportingStar.swift)
+[](/Sources/PerseusDarkMode/TheDarknessSupport.swift)
[](http://unlicense.org/)
-> [`PDMSupportingStar.swift`](/PDMSupportingStar.swift) is a peace of code a widly helpful in accord with PDM.
-> `PDMSupportingStar.swift` goes as an external part of PDM.
+> [`TheDarknessSupport.swift`](/Sources/PerseusDarkMode/TheDarknessSupport.swift) is a peace of code a widly helpful in accord with `PDM`.
-## Our Terms
+PDM in Use
+==
-> [`CPL`](https://github.com/perseusrealdeal/ConsolePerseusLogger.git) stands for `C`onsole `P`erseus `L`ogger.
-> [`PGK`](https://github.com/perseusrealdeal/PerseusGeoKit.git) stands for `P`erseus `G`eo `K`it.
-> [`PDM`](https://github.com/perseusrealdeal/PerseusDarkMode.git) stands for `P`erseus `D`ark `M`ode.
-> `P2P` stands for `P`erson-`to`-`P`erson.
-> [`A3`](https://docs.google.com/document/d/1K2jOeIknKRRpTEEIPKhxO2H_1eBTof5uTXxyOm5g6nQ) stands for `A`pple `A`pps `A`pprobation.
-> [`T3`](https://github.com/perseusrealdeal/TheTechnologicalTree) stands for `T`he `T`echnological `T`ree.
+> `Approbation:`
-## PDM in Use
+- [`Swift macOS app`](https://github.com/perseusrealdeal/Arkenstone)
+- [`Swift iOS app`](https://github.com/perseusrealdeal/TheOneRing)
-> `In approbation:` [`iOS app`](https://github.com/perseusrealdeal/TheOneRing) [`macOS app`](https://github.com/perseusrealdeal/Arkenstone)
-> `In business:` [`The Dark Moon`](https://github.com/perseusrealdeal/TheDarkMoon) [`Convertor mov2gif`](https://github.com/perseusrealdeal/mov2gif)
+> `Business:`
-> `For details:` [`Approbation and A3 Environment`](/APPROBATION.md) / [`CHANGELOG`](/CHANGELOG.md)
+- Swift macOS app [`The Dark Moon`](https://github.com/perseusrealdeal/TheDarkMoon)
+- Swift macOS app [`Convertor mov2gif`](https://github.com/PerseusRealDeal/mov2gif)
-# Contents
+Contents
+==
* [In brief](#In-brief)
-* [Build requirements](#Build-requirements)
+* [Requirements](#Requirements)
* [First-party software](#First-party-software)
* [Third-party software](#Third-party-software)
* [Installation](#Installation)
@@ -61,65 +70,101 @@
* [Force Dark Mode](#Force-Dark-Mode)
* [Get awared of DarkMode changes](#Get-awared-of-DarkMode-changes)
* [DarkMode change sample](#DarkMode-change-sample)
-* [Points taken into account](#Points-taken-into-account)
+* [Account points](#Account-points)
* [License](#License)
- * [Other required license notices](#Other-required-license-notices)
+ * [Other required licenses details](#Other-required-licenses-details)
* [Credits](#Credits)
+* [Contributing](#Contributing)
* [Author](#Author)
+ * [Contact](#Contact)
+
+Our Terms
+--
-# In brief
+| Acronym | Stands for |
+| :-----: | --------------------------------------------------------------------------------------------------------- |
+| CPL | [Console_Perseus_Logger](https://github.com/perseusrealdeal/ConsolePerseusLogger.git) |
+| PDM | [Perseus_Dark_Mode](https://github.com/perseusrealdeal/PerseusDarkMode.git) |
+| PGK | [Perseus_Geo_Kit](https://github.com/perseusrealdeal/PerseusGeoKit.git) |
+| A3 | [Apple_Apps_Approbation](https://docs.google.com/document/d/1K2jOeIknKRRpTEEIPKhxO2H_1eBTof5uTXxyOm5g6nQ) |
+| T3 | [The_Technological_Tree](https://github.com/perseusrealdeal/TheTechnologicalTree) |
+| P2P | Person_to_Person |
-> THE DARKNESS YOU CAN FORCE
+In brief
+==
+
+The great home-made product to accomplish `Dark Mode switching` task. `PDM` is a single author and personale solution developed in `P2P` relationship paradigm.
- | iOS window |
+ macOS app |
+ iOS app |
iOS Settings bundle |
- macOS window |
+  |
 |
|
- |
> [!IMPORTANT]
-> Screenshots taken from Approbation Apps [`iOS`](https://github.com/perseusrealdeal/TheOneRing) and [`macOS`](https://github.com/perseusrealdeal/Arkenstone).
+> [`The macOS App`](https://github.com/perseusrealdeal/Arkenstone) scenes taken from the motion picture `The Hobbit` based on the novel by J.R.R. Tolkien.
+> [`The iOS App`](https://github.com/perseusrealdeal/TheOneRing) scenes taken from the motion picture `The Lord of The Rings` based on the novel by J.R.R. Tolkien.
+
+Requirements
+==
+
+`To build:`
+
+- [macOS Monterey 12.7.6+](https://apps.apple.com/by/app/macos-monterey/id1576738294)
+- [Xcode 14.2+](https://developer.apple.com/services-account/download?path=/Developer_Tools/Xcode_14.2/Xcode_14.2.xip)
+
+> But as the single source code file [TheDarknessStar.swift](/TheDarknessStar.swift) `PDM` can be used even in Xcode 10.1.
-# Build requirements
+First-party software
+==
-- [macOS Monterey 12.7.6+](https://apps.apple.com/by/app/macos-monterey/id1576738294) / [Xcode 14.2+](https://developer.apple.com/services-account/download?path=/Developer_Tools/Xcode_14.2/Xcode_14.2.xip)
+MIT
+--
-> But as the single source code file [PDMStar.swift](/PDMStar.swift) PDM can be used even in Xcode 10.1.
+| Type | Name |
+| ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| Star | [ConsolePerseusLogger](https://github.com/perseusrealdeal/ConsolePerseusLogger) / [1.7.1](https://github.com/perseusrealdeal/ConsolePerseusLogger/releases/tag/1.7.1) |
-# First-party software
+Third-party software
+==
-| Type | Name | License |
-| ---- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------- |
-| Star | [ConsolePerseusLogger](https://github.com/perseusrealdeal/ConsolePerseusLogger) / [1.7.0](https://github.com/perseusrealdeal/ConsolePerseusLogger/releases/tag/1.7.0) | MIT |
+MIT
+--
-# Third-party software
+| Type | Name |
+| ------ | --------------------------------------------------------------------------------------------------------------------------------- |
+| Style | [SwiftLint](https://github.com/realm/SwiftLint) / [v0.57.0 for Monterey+](https://github.com/realm/SwiftLint/releases/tag/0.57.0) |
+| Script | [SwiftLint Shell Script](/SucceedsPostAction.sh) to run SwiftLint |
+| Action | [cirruslabs/swiftlint-action@v1](https://github.com/cirruslabs/swiftlint-action/) |
-| Type | Name | License |
-| ------ | --------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------- |
-| Style | [SwiftLint](https://github.com/realm/SwiftLint) / [v0.57.0 for Monterey+](https://github.com/realm/SwiftLint/releases/tag/0.57.0) | MIT |
-| Script | [SwiftLint Shell Script](/SucceedsPostAction.sh) to run SwiftLint | MIT |
-| Action | [mxcl/xcodebuild@v3](https://github.com/mxcl/xcodebuild) | [Unlicense](https://unlicense.org) |
-| Action | [cirruslabs/swiftlint-action@v1](https://github.com/cirruslabs/swiftlint-action/) | MIT |
+[Unlicense](https://unlicense.org)
+--
-# Installation
+| Type | Name |
+| ------ | --------------------------------------------------------------------------------------------------------------------------------- |
+| Action | [mxcl/xcodebuild@v3](https://github.com/mxcl/xcodebuild) |
+
+Installation
+==
`Step 1:` Import the Darkness either with SPM or standalone
-> Standalone: the single source code file [PDMStar.swift](/PDMStar.swift)
+> Standalone: the single source code file [TheDarknessStar.swift](/TheDarknessStar.swift)
> Swift Package Manager: `https://github.com/perseusrealdeal/PerseusDarkMode`
-## Cocoa macOS project
+Cocoa macOS project
+--
`Step 2:` In the AppDelegate when `applicationDidFinishLaunching` call `force`
@@ -165,7 +210,8 @@ class MainWindowController: NSWindowController, NSWindowDelegate {
```
-## UIKit iOS project
+UIKit iOS project
+--
`Step 2:` In the AppDelegate when `didFinishLaunchingWithOptions` call `force`
@@ -243,9 +289,11 @@ class MainViewController: UIViewController {
```
-# Usage
+Usage
+==
-## Force Dark Mode
+Force Dark Mode
+--
> The Dark Mode of your app can be easely forced in `.on`, `.off` or `.auto` just call method `force` of DarkModeAgent like this.
@@ -257,7 +305,8 @@ DarkModeAgent.force(.off) // It's a sunny day for the app.
The `force` will change the appearance of your app immediately including system components and will make run all custom DarkMode code `makeUp()`.
-## Get awared of DarkMode changes
+Get awared of DarkMode changes
+--
> To declare custom DarkMode sensitive code that runs every time if DarkMode Changes register the object or create a DarkMode trigger:
@@ -299,7 +348,8 @@ class DarkModeSensitiveObject {
```
-## DarkMode change sample
+DarkMode change sample
+--
`Use Case:` Custom DarkMode sensitive color
@@ -347,60 +397,87 @@ extension Color {
```
-# Points taken into account
+`Account points
+==
- Preconfigured Swift Package manifest [Package.swift](/Package.swift)
- Preconfigured SwiftLint config [.swiftlint.yml](/.swiftlint.yml)
- Preconfigured SwiftLint CI [swiftlint.yml](/.github/workflows/swiftlint.yml)
- Preconfigured GitHub config [.gitignore](/.gitignore)
- Preconfigured GitHub CI [main.yml](/.github/workflows/main.yml)
+- [Changelog](/CHANGELOG.md)
+- [A3 environment specification](/APPROBATION.md)
+- [SwiftLint shell script](/SucceedsPostAction.sh)
-# License
+License
+==
-`License:` MIT
+`MIT License`, see [LICENSE](/LICENSE) for details.
Copyright © 7530 - 7534 Mikhail A. Zhigulin of Novosibirsk
Copyright © 7533 - 7534 PerseusRealDeal
- The year starts from the creation of the world according to a Slavic calendar.
-- September, the 1st of Slavic year. It means that "Sep 01, 2025" is the beginning of 7534.
-
-## Other required license notices
+- September, the 1st of Slavic year. For instance, "Sep 01, 2025" is the beginning of 7534.
-© 2025 The SwiftLint Contributors **for** SwiftLint
-© GitHub **for** GitHub Action cirruslabs/swiftlint-action@v1
-© 2021 Alexandre Colucci, geteimy.com **for** Shell Script SucceedsPostAction.sh
+Other required licenses details
+--
-[LICENSE](/LICENSE) for details.
+`© 2025 The SwiftLint Contributors` **for** SwiftLint
+`© GitHub` **for** GitHub Action cirruslabs/swiftlint-action@v1
+`© 2021 Alexandre Colucci, geteimy.com` **for** Shell Script SucceedsPostAction.sh
-## Credits
+Credits
+==
-
- | Balance and Control |
- kept by |
- Mikhail Zhigulin |
-
-
- | Source Code |
- written by |
- Mikhail Zhigulin |
-
-
- | Documentation |
- prepared by |
- Mikhail Zhigulin |
-
-
- | Product Approbation |
- tested by |
- Mikhail Zhigulin |
-
+
+ | Balance and Control |
+ Mikhail Zhigulin |
+
+
+ | Source Code |
+ Mikhail Zhigulin |
+
+
+ | Documentation |
+ Mikhail Zhigulin |
+
+
+ | Approbation |
+ Mikhail Zhigulin |
+
+
+ | English |
+ Mikhail Zhigulin |
+
- Language support: [Reverso](https://www.reverso.net/)
- Git clients: [SmartGit](https://syntevo.com/) and [GitHub Desktop](https://github.com/apps/desktop)
-# Author
+Contributing
+==
+
+> [!NOTE]
+> The product is constructed in `P2P` relationship paradigm that means the only one single and the same face in the product team during all development process stages.
+
+`Bug reports are welcome`, create an issue and give details.
+
+Author
+==
+
+
+
+`© Mikhail A. Zhigulin of Novosibirsk`
+
+
+
+Contact
+--
+
+
+
+[E-mail](mailto:mzhigulin@gmail.com) • [Telegram](https://t.me/velociraptor1985) • [GitHub](https://github.com/perseusrealdeal)
-> © Mikhail A. Zhigulin of Novosibirsk.
+
`
diff --git a/Sources/PerseusDarkMode/TheDarkness.swift b/Sources/PerseusDarkMode/TheDarkness.swift
index 55ab2a7..c918d95 100644
--- a/Sources/PerseusDarkMode/TheDarkness.swift
+++ b/Sources/PerseusDarkMode/TheDarkness.swift
@@ -3,7 +3,7 @@
// PerseusDarkMode
//
//
-// For iOS and macOS only. Use Stars to adopt for the specifics you need.
+// Stars to adopt for the specifics you need.
//
// DESC: THE DARKNESS YOU CAN FORCE
//
@@ -21,7 +21,7 @@
// Copyright © 7533 - 7534 PerseusRealDeal
//
// The year starts from the creation of the world according to a Slavic calendar.
-// September, the 1st of Slavic year. It means that "Sep 01, 2025" is the beginning of 7534.
+// September, the 1st of Slavic year. For instance, "Sep 01, 2025" is the beginning of 7534.
//
// Permission is hereby granted, free of charge, to any person obtaining a copy
// of this software and associated documentation files (the "Software"), to deal
diff --git a/PDMSupportingStar.swift b/Sources/PerseusDarkMode/TheDarknessSupport.swift
similarity index 98%
rename from PDMSupportingStar.swift
rename to Sources/PerseusDarkMode/TheDarknessSupport.swift
index 9ddc8e1..8e6aa2b 100644
--- a/PDMSupportingStar.swift
+++ b/Sources/PerseusDarkMode/TheDarknessSupport.swift
@@ -1,16 +1,15 @@
//
-// PDMSupportingStar.swift
-// Version: 2.1.1
+// TheDarknessSupport.swift
//
-// The Darkness Support (PerseusUISystemKit previously)
+// The Darkness Support
//
//
-// For iOS and macOS only. Use Stars to adopt for the specifics you need.
+// Stars to adopt for the specifics you need.
//
// Created by Mikhail Zhigulin of Novosibirsk in 7530.
//
// The year starts from the creation of the world according to a Slavic calendar.
-// September, the 1st of Slavic year. It means that "Sep 01, 2025" is the beginning of 7534.
+// September, the 1st of Slavic year. For instance, "Sep 01, 2025" is the beginning of 7534.
//
//
// Unlicensed Free Software
@@ -43,8 +42,6 @@
// swiftlint:disable file_length
//
-// import PerseusDarkMode
-
#if canImport(UIKit)
import UIKit
#elseif canImport(Cocoa)
diff --git a/Sources/PerseusDarkMode/CPLStar.swift b/Sources/PerseusDarkMode/TheLoggerStar.swift
similarity index 99%
rename from Sources/PerseusDarkMode/CPLStar.swift
rename to Sources/PerseusDarkMode/TheLoggerStar.swift
index 26ddbb1..d3eb6dc 100644
--- a/Sources/PerseusDarkMode/CPLStar.swift
+++ b/Sources/PerseusDarkMode/TheLoggerStar.swift
@@ -1,10 +1,10 @@
//
-// CPLStar.swift
-// Version: 1.7.0
+// TheLoggerStar.swift
+// Version: 1.7.1
//
// Standalone ConsolePerseusLogger.
//
-// For iOS and macOS. Use Stars to adopt for the specifics you need.
+// Stars to adopt for the specifics you need.
//
// DESC: USE LOGGER LIKE A VARIABLE ANYWHERE YOU WANT.
//
@@ -27,7 +27,7 @@
// Copyright © 7531 - 7534 PerseusRealDeal
//
// The year starts from the creation of the world according to a Slavic calendar.
-// September, the 1st of Slavic year. It means that "Sep 01, 2025" is the beginning of 7534.
+// September, the 1st of Slavic year. For instance, "Sep 01, 2025" is the beginning of 7534.
//
// Permission is hereby granted, free of charge, to any person obtaining a copy
// of this software and associated documentation files (the "Software"), to deal
diff --git a/Tests/UnitTests/PDMStartTests.swift b/Tests/UnitTests/PDMStartTests.swift
index 09aef9b..157a1a1 100644
--- a/Tests/UnitTests/PDMStartTests.swift
+++ b/Tests/UnitTests/PDMStartTests.swift
@@ -16,10 +16,27 @@ import XCTest
final class FunctionalTests: XCTestCase {
- // func test_zero() { XCTFail("Tests not yet implemented in \(type(of: self)).") }
+ override static func setUp() {
+ super.setUp()
- func test_the_first_success() {
+ log.marks = true
+ log.directives = true
log.time = true
- log.message(#function)
+ log.owner = true
+ }
+/*
+ override static func tearDown() {
+ super.tearDown()
+ }
+
+ func test_zero() { XCTFail("Tests not yet implemented in \(type(of: self)).") }
+*/
+ func test_the_first_success() {
+ log.message("[\(type(of: self))].\(#function)")
+
+ let isReseted = log.loadConfig(.defaultDebug)
+ let result = isReseted ? "CPL options loaded." : "Failed to load options!"
+
+ log.message(result)
}
}
diff --git a/TheDarknessStar.swift b/TheDarknessStar.swift
new file mode 100644
index 0000000..2b28554
--- /dev/null
+++ b/TheDarknessStar.swift
@@ -0,0 +1,1184 @@
+//
+// TheDarknessStar.swift
+// Version: 2.2.0
+//
+// Standalone PerseusDarkMode.
+//
+// Project: https://github.com/perseusrealdeal/PerseusDarkMode
+//
+// Stars to adopt for the specifics you need.
+//
+// DESC: THE DARKNESS YOU CAN FORCE
+//
+// Created by Mikhail Zhigulin in 7530.
+//
+// Copyright © 7530 - 7534 Mikhail Zhigulin of Novosibirsk
+// Copyright © 7533 - 7534 PerseusRealDeal
+//
+// All rights reserved.
+//
+//
+// MIT License
+//
+// Copyright © 7530 - 7534 Mikhail A. Zhigulin of Novosibirsk
+// Copyright © 7533 - 7534 PerseusRealDeal
+//
+// The year starts from the creation of the world according to a Slavic calendar.
+// September, the 1st of Slavic year. For instance, "Sep 01, 2025" is the beginning of 7534.
+//
+// Permission is hereby granted, free of charge, to any person obtaining a copy
+// of this software and associated documentation files (the "Software"), to deal
+// in the Software without restriction, including without limitation the rights
+// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+// copies of the Software, and to permit persons to whom the Software is
+// furnished to do so, subject to the following conditions:
+//
+// The above copyright notice and this permission notice shall be included in all
+// copies or substantial portions of the Software.
+//
+// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+// SOFTWARE.
+//
+// swiftlint:disable file_length
+//
+
+#if canImport(UIKit)
+import UIKit
+#elseif canImport(Cocoa)
+import Cocoa
+#endif
+
+public let APPEARANCE_DEFAULT = AppearanceStyle.light
+
+public let DARK_MODE_USER_CHOICE_KEY = "DarkModeUserChoiceOptionKey"
+public let DARK_MODE_USER_CHOICE_DEFAULT = DarkModeOption.auto
+
+public let DARK_MODE_SETTINGS_KEY = "DarkModeSettingsKey"
+
+#if os(macOS)
+public var DARK_APPEARANCE_DEFAULT_IN_USE: NSAppearance {
+ guard let darkAppearanceOS = DARK_APPEARANCE_DEFAULT else {
+ if #available(macOS 10.14, *) {
+ return NSAppearance(named: .darkAqua)!
+ } // For HighSierra.
+ return NSAppearance(named: .vibrantDark)!
+ }
+ return darkAppearanceOS
+}
+public var DARK_APPEARANCE_DEFAULT: NSAppearance?
+public var LIGHT_APPEARANCE_DEFAULT_IN_USE = NSAppearance(named: .aqua)!
+#endif
+
+public extension Notification.Name {
+ static let MakeAppearanceUpNotification =
+ Notification.Name("MakeAppearanceUpNotification")
+#if os(macOS)
+ static let AppleInterfaceThemeChangedNotification =
+ Notification.Name("AppleInterfaceThemeChangedNotification")
+#endif
+}
+
+// swiftlint:disable identifier_name
+public extension NSObject {
+ var DarkMode: DarkMode { return DarkModeAgent.shared }
+ var DarkModeUserChoice: DarkModeOption { return DarkModeAgent.DarkModeUserChoice }
+}
+// swiftlint:enable identifier_name
+
+public enum AppearanceStyle: Int, CustomStringConvertible {
+
+ case light = 0
+ case dark = 1
+
+ public var description: String {
+ switch self {
+ case .light:
+ return ".light"
+ case .dark:
+ return ".dark"
+ }
+ }
+}
+
+public enum DarkModeOption: Int, CustomStringConvertible {
+
+ case auto = 0
+ case on = 1
+ case off = 2
+
+ public var description: String {
+ switch self {
+ case .auto:
+ return ".auto"
+ case .on:
+ return ".on"
+ case .off:
+ return ".off"
+ }
+ }
+}
+
+public class DarkMode: NSObject {
+
+ public var style: AppearanceStyle { return appearance }
+
+ @objc public dynamic var styleObservable: Int = APPEARANCE_DEFAULT.rawValue
+
+ internal var appearance: AppearanceStyle = APPEARANCE_DEFAULT {
+ didSet { styleObservable = style.rawValue }
+ }
+}
+
+public class DarkModeAgent {
+
+ // MARK: - Properties
+
+ public static var shared: DarkMode = { _ = instance; return DarkMode() }()
+ public static var DarkModeUserChoice: DarkModeOption {
+ return userChoice
+ }
+
+ // MARK: - Internals
+
+ private static var userChoice: DarkModeOption {
+ get {
+ let rawValue = ud.valueExists(forKey: DARK_MODE_USER_CHOICE_KEY) ?
+ ud.integer(forKey: DARK_MODE_USER_CHOICE_KEY) :
+ DARK_MODE_USER_CHOICE_DEFAULT.rawValue
+
+ if let result = DarkModeOption.init(rawValue: rawValue) { return result }
+ return DARK_MODE_USER_CHOICE_DEFAULT
+ }
+ set {
+ ud.setValue(newValue.rawValue, forKey: DARK_MODE_USER_CHOICE_KEY)
+#if os(iOS)
+ // Set DarkMode option for Settings bundle
+ ud.setValue(newValue.rawValue, forKey: DARK_MODE_SETTINGS_KEY)
+#endif
+ }
+ }
+
+#if os(macOS)
+ private static var distributedNCenter = DistributedNotificationCenter.default
+#endif
+ private static var nCenter = NotificationCenter.default
+ private static var ud = UserDefaults.standard
+
+ private var observation: NSKeyValueObservation?
+
+ // MARK: - Singletone
+
+ private static var instance = { DarkModeAgent() }()
+ private init() {
+ // log.message("[\(type(of: self))].\(#function)", .info)
+#if os(macOS)
+ if #available(macOS 10.14, *) {
+ DarkModeAgent.distributedNCenter.addObserver(
+ self,
+ selector: #selector(processAppleInterfaceThemeChanged),
+ name: .AppleInterfaceThemeChangedNotification,
+ object: nil
+ )
+ observation = NSApp.observe(\.effectiveAppearance) { _, _ in
+ if DarkModeAgent.userChoice == .auto {
+
+ let effectiveAppearance = NSApplication.shared.effectiveAppearance
+ let wanted = self.getRequired(from: effectiveAppearance)
+
+ DarkModeAgent.shared.appearance = wanted
+ self.notifyAllRegistered()
+ }
+ }
+ } // For HighSierra there is no need in observation cos' system style never change.
+#endif
+ }
+
+ // MARK: - Contract
+
+ public static func register(stakeholder: Any, selector: Selector) {
+ self.nCenter.addObserver(stakeholder,
+ selector: selector,
+ name: .MakeAppearanceUpNotification,
+ object: nil)
+ }
+
+ public static func force(_ userChoice: DarkModeOption) {
+
+ DarkModeAgent.userChoice = userChoice
+ DarkModeAgent.instance.refresh()
+
+#if os(iOS)
+ DarkModeAgent.instance.notifyAllRegistered()
+#elseif os(macOS)
+ if #unavailable(macOS 10.14) { // For HighSierra.
+ DarkModeAgent.instance.notifyAllRegistered()
+ } else if DarkModeAgent.userChoice != .auto { // If .auto observation notifies change.
+ DarkModeAgent.instance.notifyAllRegistered()
+ }
+#endif
+ }
+
+ public static func makeUp() {
+ DarkModeAgent.instance.notifyAllRegistered()
+ }
+
+ // MARK: - iOS Contract specifics
+
+#if os(iOS)
+ @available(iOS 13.0, *)
+ public static func processTraitCollectionDidChange(_ previous: UITraitCollection?) {
+ if let previous = previous?.userInterfaceStyle {
+ if UIWindow.systemStyle.rawValue != previous.rawValue {
+ DarkModeAgent.instance.processAppleInterfaceThemeChanged()
+ }
+ }
+ }
+
+ // Returns nil if DarkMode equal to User choice or no value saved otherwise new value.
+ public static func isDarkModeSettingsKeyChanged() -> DarkModeOption? {
+ let option = ud.valueExists(forKey: DARK_MODE_SETTINGS_KEY) ?
+ ud.integer(forKey: DARK_MODE_SETTINGS_KEY) : -1
+
+ guard option != -1, let settingsDarkMode = DarkModeOption.init(rawValue: option)
+ else { return nil }
+
+ return settingsDarkMode != userChoice ? settingsDarkMode : nil
+ }
+#endif
+
+ // MARK: - Implementation
+
+ @objc private func processAppleInterfaceThemeChanged() {
+ refresh()
+ notifyAllRegistered()
+ }
+
+ private func refresh() {
+ let choice = DarkModeAgent.userChoice
+#if os(iOS)
+ let current = UIWindow.systemStyle
+ let required = makeDecision(current, choice)
+
+ if #available(iOS 13.0, *) {
+ UIWindow.refreshKeyWindow()
+ }
+
+ DarkModeAgent.shared.appearance = required
+#elseif os(macOS)
+ if #available(macOS 10.14, *) {
+ switch choice {
+ case .auto:
+ NSApp.appearance = nil
+ // DarkModeAgent is informed about new appearance by observation.
+ case .on:
+ NSApp.appearance = DARK_APPEARANCE_DEFAULT_IN_USE
+ DarkModeAgent.shared.appearance = .dark
+ case .off:
+ NSApp.appearance = LIGHT_APPEARANCE_DEFAULT_IN_USE
+ DarkModeAgent.shared.appearance = .light
+ }
+ } else { // For HighSierra.
+ DarkModeAgent.shared.appearance = choice == .on ? .dark : .light
+ }
+#endif
+ }
+
+ private func notifyAllRegistered() {
+ DarkModeAgent.nCenter.post(name: .MakeAppearanceUpNotification, object: nil)
+ }
+
+#if os(macOS)
+ private func getRequired(from appearance: NSAppearance?) -> AppearanceStyle {
+ let choice = DarkModeAgent.userChoice
+
+ if #available(macOS 10.14, *) {
+ guard choice == .auto else {
+ return choice == .off ? .light : .dark
+ }
+
+ if let match = appearance?.bestMatch(from: [.darkAqua, .vibrantDark]) {
+ return [.darkAqua, .vibrantDark].contains(match) ? .dark : .light
+ }
+
+ return .light
+ } else { // For HighSierra.
+ return choice == .off ? .dark : .light
+ }
+ }
+#endif
+}
+
+// MARK: - Helpers
+
+extension UserDefaults {
+ public func valueExists(forKey key: String) -> Bool {
+ return object(forKey: key) != nil
+ }
+}
+
+public class DarkModeObserver: NSObject {
+
+ public var action: ((_ newStyle: AppearanceStyle) -> Void)?
+
+ private var objectToObserve = DarkModeAgent.shared
+ private var observation: NSKeyValueObservation?
+
+ public override init() {
+ super.init()
+ setupObservation()
+ }
+
+ public init(_ action: @escaping ((_ newStyle: AppearanceStyle) -> Void)) {
+ super.init()
+
+ self.action = action
+ setupObservation()
+ }
+
+ private func setupObservation() {
+ observation = objectToObserve.observe(\.styleObservable) { _, _ in
+ self.action?(self.objectToObserve.style)
+ }
+ }
+}
+
+#if os(iOS)
+public enum SystemStyle: Int, CustomStringConvertible {
+
+ case unspecified = 0
+ case light = 1
+ case dark = 2
+
+ public var description: String {
+ switch self {
+ case .unspecified:
+ return ".unspecified"
+ case .light:
+ return ".light"
+ case .dark:
+ return ".dark"
+ }
+ }
+}
+
+extension UIWindow {
+
+ static var key: UIWindow? {
+ if #available(iOS 13, *) {
+ return UIApplication.shared.windows.first { $0.isKeyWindow }
+ } else {
+ return UIApplication.shared.keyWindow
+ }
+ }
+
+ static var systemStyle: SystemStyle {
+ if #available(iOS 13.0, *) {
+ guard let keyWindow = UIWindow.key else { return .unspecified }
+
+ switch keyWindow.traitCollection.userInterfaceStyle {
+ case .unspecified:
+ return .unspecified
+ case .light:
+ return .light
+ case .dark:
+ return .dark
+
+ @unknown default:
+ return .unspecified
+ }
+ } else {
+ return .unspecified // For iOS 12.0 and earlier.
+ }
+ }
+}
+
+// MARK: - Calculating Dark Mode Required
+
+/// Calculates the current required appearance style of the app.
+///
+/// Dark Mode decision-making:
+///
+/// | User
+/// -------------+-----------------------
+/// System | auto | on | off
+/// -------------+---------+------+------
+/// .unspecified | default | dark | light
+/// .light | light | dark | light
+/// .dark | dark | dark | light
+///
+public func makeDecision(_ system: SystemStyle, _ user: DarkModeOption) -> AppearanceStyle {
+
+ if (system == .unspecified) && (user == .auto) { return APPEARANCE_DEFAULT }
+ if (system == .unspecified) && (user == .on) { return .dark }
+ if (system == .unspecified) && (user == .off) { return .light }
+
+ if (system == .light) && (user == .auto) { return .light }
+ if (system == .light) && (user == .on) { return .dark }
+ if (system == .light) && (user == .off) { return .light }
+
+ if (system == .dark) && (user == .auto) { return .dark }
+ if (system == .dark) && (user == .on) { return .dark }
+ if (system == .dark) && (user == .off) { return .light }
+
+ return APPEARANCE_DEFAULT
+
+}
+#endif
+
+#if os(iOS) && compiler(>=5)
+extension UIWindow {
+
+ @available(iOS 13.0, *)
+ public static func refreshKeyWindow() {
+
+ guard let keyWindow = UIWindow.key else { return }
+
+ var overrideStyle: UIUserInterfaceStyle = .unspecified
+
+ switch DarkModeAgent.DarkModeUserChoice {
+ case .auto:
+ overrideStyle = .unspecified
+ case .on:
+ overrideStyle = .dark
+ case .off:
+ overrideStyle = .light
+ }
+
+ keyWindow.overrideUserInterfaceStyle = overrideStyle
+ }
+}
+#endif
+
+// MARK: - The Darkness Support
+//
+// The Darkness Support
+//
+//
+// Stars to adopt for the specifics you need.
+//
+// Created by Mikhail Zhigulin of Novosibirsk in 7530.
+//
+// The year starts from the creation of the world according to a Slavic calendar.
+// September, the 1st of Slavic year. For instance, "Sep 01, 2025" is the beginning of 7534.
+//
+//
+// Unlicensed Free Software
+// Sstarting from here and further in the file
+//
+// This is free and unencumbered software released into the public domain.
+//
+// Anyone is free to copy, modify, publish, use, compile, sell, or
+// distribute this software, either in source code form or as a compiled
+// binary, for any purpose, commercial or non-commercial, and by any
+// means.
+//
+// In jurisdictions that recognize copyright laws, the author or authors
+// of this software dedicate any and all copyright interest in the
+// software to the public domain. We make this dedication for the benefit
+// of the public at large and to the detriment of our heirs and
+// successors. We intend this dedication to be an overt act of
+// relinquishment in perpetuity of all present and future rights to this
+// software under copyright law.
+//
+// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+// MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+// IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR
+// OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
+// ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+// OTHER DEALINGS IN THE SOFTWARE.
+//
+// For more information, please refer to
+//
+
+#if os(iOS)
+public typealias Color = UIColor
+#elseif os(macOS)
+public typealias Color = NSColor
+#endif
+
+public func rgba255(_ red: CGFloat,
+ _ green: CGFloat,
+ _ blue: CGFloat,
+ _ alpha: CGFloat = 1.0) -> Color {
+ return Color(red: red/255, green: green/255, blue: blue/255, alpha: alpha)
+}
+
+public extension Color {
+
+ var RGBA255: (red: CGFloat, green: CGFloat, blue: CGFloat, alpha: CGFloat) {
+ var red: CGFloat = 0
+ var green: CGFloat = 0
+ var blue: CGFloat = 0
+ var alpha: CGFloat = 0
+
+ getRed(&red, green: &green, blue: &blue, alpha: &alpha)
+
+ return (red*255, green*255, blue*255, alpha)
+ }
+}
+
+public protocol SemanticColorProtocol {
+
+// MARK: - FOREGROUND CONTENT
+
+ // MARK: - Label Colors
+
+ /// Label.
+ ///
+ /// - Light: 0, 0, 0
+ /// - Dark: 255, 255, 255
+ static var labelPerseus: Color { get }
+
+ /// Secondary label.
+ ///
+ /// - Light: 60, 60, 67, 0.6
+ /// - Dark: 235, 235, 245, 0.6
+ static var secondaryLabelPerseus: Color { get }
+
+ /// Tertiary label.
+ ///
+ /// - Light: 60, 60, 67, 0.3
+ /// - Dark: 235, 235, 245, 0.3
+ static var tertiaryLabelPerseus: Color { get }
+
+ /// Quaternary label.
+ ///
+ /// - Light: 60, 60, 67, 0.18
+ /// - Dark: 235, 235, 245, 0.16
+ static var quaternaryLabelPerseus: Color { get }
+
+ // MARK: - Text Colors
+
+ /// Placeholder text.
+ ///
+ /// - Light: 60, 60, 67, 0.3
+ /// - Dark: 235, 235, 245, 0.3
+ static var placeholderTextPerseus: Color { get }
+
+ // MARK: - Separator Colors
+
+ /// Separator.
+ ///
+ /// - Light: 60, 60, 67, 0.29
+ /// - Dark: 84, 84, 88, 0.6
+ static var separatorPerseus: Color { get }
+
+ /// Opaque separator.
+ ///
+ /// - Light: 198, 198, 200
+ /// - Dark: 56, 56, 58
+ static var opaqueSeparatorPerseus: Color { get }
+
+ // MARK: - Link Color
+
+ /// Link.
+ ///
+ /// - Light: 0, 122, 255
+ /// - Dark: 9, 132, 255
+ static var linkPerseus: Color { get }
+
+ // MARK: - Fill Colors
+
+ /// System fill.
+ ///
+ /// - Light: 120, 120, 128, 0.2
+ /// - Dark: 120, 120, 128, 0.36
+ static var systemFillPerseus: Color { get }
+
+ /// Secondary system fill.
+ ///
+ /// - Light: 120, 120, 128, 0.16
+ /// - Dark: 120, 120, 128, 0.32
+ static var secondarySystemFillPerseus: Color { get }
+
+ /// Tertiary system fill.
+ ///
+ /// - Light: 118, 118, 128, 0.12
+ /// - Dark: 118, 118, 128, 0.24
+ static var tertiarySystemFillPerseus: Color { get }
+
+ /// Quaternary system fill.
+ ///
+ /// - Light: 116, 116, 128, 0.08
+ /// - Dark: 118, 118, 128, 0.18
+ static var quaternarySystemFillPerseus: Color { get }
+
+// MARK: - BACKGROUND CONTENT
+
+ // MARK: - Standard
+
+ /// System background.
+ ///
+ /// - Light: 255, 255, 255
+ /// - Dark: 28, 28, 30
+ static var systemBackgroundPerseus: Color { get }
+
+ /// Secondary system background.
+ ///
+ /// - Light: 242, 242, 247
+ /// - Dark: 44, 44, 46
+ static var secondarySystemBackgroundPerseus: Color { get }
+
+ /// Tertiary system background.
+ ///
+ /// - Light: 255, 255, 255
+ /// - Dark: 58, 58, 60
+ static var tertiarySystemBackgroundPerseus: Color { get }
+
+ // MARK: - Grouped
+
+ /// System grouped background.
+ ///
+ /// - Light: 242, 242, 247
+ /// - Dark: 28, 28, 30
+ static var systemGroupedBackgroundPerseus: Color { get }
+
+ /// Secondary system grouped background.
+ ///
+ /// - Light: 255, 255, 255
+ /// - Dark: 44, 44, 46
+ static var secondarySystemGroupedBackgroundPerseus: Color { get }
+
+ /// Tertiary system grouped background.
+ ///
+ /// - Light: 242, 242, 247
+ /// - Dark: 58, 58, 60
+ static var tertiarySystemGroupedBackgroundPerseus: Color { get }
+}
+
+public protocol SystemColorProtocol {
+
+ /// Red is .systemRed
+ ///
+ /// - Light: 255, 59, 48
+ /// - Dark: 255, 69, 58
+ static var perseusRed: Color { get }
+
+ /// Orange is .systemOrange
+ ///
+ /// - Light: 255, 149, 0
+ /// - Dark: 255, 159, 10
+ static var perseusOrange: Color { get }
+
+ /// Yellow is .systemYellow
+ ///
+ /// - Light: 255, 204, 0
+ /// - Dark: 255, 214, 10
+ static var perseusYellow: Color { get }
+
+ /// Green is .systemGreenGreen
+ ///
+ /// - Light: 52, 199, 89
+ /// - Dark: 48, 209, 88
+ static var perseusGreen: Color { get }
+
+ /// Mint is .systemMint
+ ///
+ /// - Light: 0, 199, 190
+ /// - Dark: 102, 212, 207
+ static var perseusMint: Color { get }
+
+ /// Teal is .systemTeal
+ ///
+ /// - Light: 48, 176, 199
+ /// - Dark: 64, 200, 224
+ static var perseusTeal: Color { get }
+
+ /// Cyan is .systemCyan
+ ///
+ /// - Light: 50, 173, 230
+ /// - Dark: 100, 210, 255
+ static var perseusCyan: Color { get }
+
+ /// Blue is .systemBlue
+ ///
+ /// - Light: 0, 122, 255
+ /// - Dark: 10, 132, 255
+ static var perseusBlue: Color { get }
+
+ /// Indigo is .systemIndigo
+ ///
+ /// - Light: 88, 86, 214
+ /// - Dark: 94, 92, 230
+ static var perseusIndigo: Color { get }
+
+ /// Purple is .systemPurple
+ ///
+ /// - Light: 175, 82, 222
+ /// - Dark: 191, 90, 242
+ static var perseusPurple: Color { get }
+
+ /// Pink is .systemPink
+ ///
+ /// - Light: 255, 45, 85
+ /// - Dark: 255, 55, 95
+ static var perseusPink: Color { get }
+
+ /// Brown is .systemBrown
+ ///
+ /// - Light: 162, 132, 94
+ /// - Dark: 172, 142, 104
+ static var perseusBrown: Color { get }
+
+// MARK: - System Gray Colors
+
+ /// Gray is .systemGray
+ ///
+ /// - Light: 142, 142, 147
+ /// - Dark: 142, 142, 147
+ static var perseusGray: Color { get }
+
+ /// Gray (2) is .systemGray62
+ ///
+ /// - Light: 174, 174, 178
+ /// - Dark: 99, 99, 102
+ static var perseusGray2: Color { get }
+
+ /// Gray (3) is .systemGray3
+ ///
+ /// - Light: 199, 199, 204
+ /// - Dark: 72, 72, 74
+ static var perseusGray3: Color { get }
+
+ /// Gray (4) is .systemGray4
+ ///
+ /// - Light: 209, 209, 214
+ /// - Dark: 58, 58, 60
+ static var perseusGray4: Color { get }
+
+ /// Gray (5) is .systemGray5
+ ///
+ /// - Light: 229, 229, 234
+ /// - Dark: 44, 44, 46
+ static var perseusGray5: Color { get }
+
+ /// Gray (6) is .systemGray6
+ ///
+ /// - Light: 242, 242, 247
+ /// - Dark: 28, 28, 30
+ static var perseusGray6: Color { get }
+}
+
+extension Color: SemanticColorProtocol {
+
+ /// .label
+ public static var labelPerseus: Color {
+ return DarkModeAgent.shared.style == .light ?
+ rgba255(0, 0, 0) : rgba255(255, 255, 255)
+ }
+
+ /// .secondaryLabel
+ public static var secondaryLabelPerseus: Color {
+ return DarkModeAgent.shared.style == .light ?
+ rgba255(60, 60, 67, 0.6) : rgba255(235, 235, 245, 0.6)
+ }
+
+ /// .tertiaryLabel
+ public static var tertiaryLabelPerseus: Color {
+ return DarkModeAgent.shared.style == .light ?
+ rgba255(60, 60, 67, 0.3) : rgba255(235, 235, 245, 0.3)
+ }
+
+ /// .quaternaryLabel
+ public static var quaternaryLabelPerseus: Color {
+ return DarkModeAgent.shared.style == .light ?
+ rgba255(60, 60, 67, 0.18) : rgba255(235, 235, 245, 0.16)
+ }
+
+ /// .placeholderText
+ public static var placeholderTextPerseus: Color {
+ return DarkModeAgent.shared.style == .light ?
+ rgba255(60, 60, 67, 0.3) : rgba255(235, 235, 245, 0.3)
+ }
+
+ /// .separator
+ public static var separatorPerseus: Color {
+ return DarkModeAgent.shared.style == .light ?
+ rgba255(60, 60, 67, 0.29) : rgba255(84, 84, 88, 0.6)
+ }
+
+ /// .opaqueSeparator
+ public static var opaqueSeparatorPerseus: Color {
+ return DarkModeAgent.shared.style == .light ?
+ rgba255(198, 198, 200) : rgba255(56, 56, 58)
+ }
+
+ /// .link
+ public static var linkPerseus: Color {
+ return DarkModeAgent.shared.style == .light ?
+ rgba255(0, 122, 255) : rgba255(9, 132, 255)
+ }
+
+ /// .systemFill
+ public static var systemFillPerseus: Color {
+ return DarkModeAgent.shared.style == .light ?
+ rgba255(120, 120, 128, 0.2) : rgba255(120, 120, 128, 0.36)
+ }
+
+ /// .secondarySystemFill
+ public static var secondarySystemFillPerseus: Color {
+ return DarkModeAgent.shared.style == .light ?
+ rgba255(120, 120, 128, 0.16) : rgba255(120, 120, 128, 0.32)
+ }
+
+ /// .tertiarySystemFill
+ public static var tertiarySystemFillPerseus: Color {
+ return DarkModeAgent.shared.style == .light ?
+ rgba255(118, 118, 128, 0.12) : rgba255(118, 118, 128, 0.24)
+ }
+
+ /// .quaternarySystemFill
+ public static var quaternarySystemFillPerseus: Color {
+ return DarkModeAgent.shared.style == .light ?
+ rgba255(116, 116, 128, 0.08) : rgba255(118, 118, 128, 0.18)
+ }
+
+ /// .systemBackground
+ public static var systemBackgroundPerseus: Color {
+ return DarkModeAgent.shared.style == .light ?
+ rgba255(255, 255, 255) : rgba255(28, 28, 30)
+ }
+
+ /// .secondarySystemBackground
+ public static var secondarySystemBackgroundPerseus: Color {
+ return DarkModeAgent.shared.style == .light ?
+ rgba255(242, 242, 247) : rgba255(44, 44, 46)
+ }
+
+ /// .tertiarySystemBackground
+ public static var tertiarySystemBackgroundPerseus: Color {
+ return DarkModeAgent.shared.style == .light ?
+ rgba255(255, 255, 255) : rgba255(58, 58, 60)
+ }
+
+ /// .systemGroupedBackground
+ public static var systemGroupedBackgroundPerseus: Color {
+ return DarkModeAgent.shared.style == .light ?
+ rgba255(242, 242, 247) : rgba255(28, 28, 30)
+ }
+
+ /// .secondarySystemGroupedBackground
+ public static var secondarySystemGroupedBackgroundPerseus: Color {
+ return DarkModeAgent.shared.style == .light ?
+ rgba255(255, 255, 255) : rgba255(44, 44, 46)
+ }
+
+ /// .tertiarySystemGroupedBackground
+ public static var tertiarySystemGroupedBackgroundPerseus: Color {
+ return DarkModeAgent.shared.style == .light ?
+ rgba255(242, 242, 247) : rgba255(58, 58, 60)
+ }
+}
+
+extension Color: SystemColorProtocol {
+
+ /// .systemRed
+ public static var perseusRed: Color {
+ return DarkModeAgent.shared.style == .light ?
+ rgba255(255, 59, 48) : rgba255(255, 69, 58)
+ }
+
+ /// .systemOrange
+ public static var perseusOrange: Color {
+ return DarkModeAgent.shared.style == .light ?
+ rgba255(255, 149, 0) : rgba255(255, 159, 10)
+ }
+
+ /// .systemYellow
+ public static var perseusYellow: Color {
+ return DarkModeAgent.shared.style == .light ?
+ rgba255(255, 204, 0) : rgba255(255, 214, 10)
+ }
+
+ /// .systemGreen
+ public static var perseusGreen: Color {
+ return DarkModeAgent.shared.style == .light ?
+ rgba255(52, 199, 89) : rgba255(48, 209, 88)
+ }
+
+ /// .systemMint
+ public static var perseusMint: Color {
+ return DarkModeAgent.shared.style == .light ?
+ rgba255(0, 199, 190) : rgba255(102, 212, 207)
+ }
+
+ /// .systemTeal
+ public static var perseusTeal: Color {
+ return DarkModeAgent.shared.style == .light ?
+ rgba255(48, 176, 199) : rgba255(64, 200, 224)
+ }
+
+ /// .systemCyan
+ public static var perseusCyan: Color {
+ return DarkModeAgent.shared.style == .light ?
+ rgba255(50, 173, 230) : rgba255(100, 210, 255)
+ }
+
+ /// .systemBlue
+ public static var perseusBlue: Color {
+ return DarkModeAgent.shared.style == .light ?
+ rgba255(0, 122, 255) : rgba255(10, 132, 255)
+ }
+
+ /// .systemIndigo
+ public static var perseusIndigo: Color {
+ return DarkModeAgent.shared.style == .light ?
+ rgba255(88, 86, 214) : rgba255(94, 92, 230)
+ }
+
+ /// .systemPurple
+ public static var perseusPurple: Color {
+ return DarkModeAgent.shared.style == .light ?
+ rgba255(175, 82, 222) : rgba255(191, 90, 242)
+ }
+
+ /// .systemPink
+ public static var perseusPink: Color {
+ return DarkModeAgent.shared.style == .light ?
+ rgba255(255, 45, 85) : rgba255(255, 55, 95)
+ }
+
+ /// .systemBrown
+ public static var perseusBrown: Color {
+ return DarkModeAgent.shared.style == .light ?
+ rgba255(162, 132, 94) : rgba255(172, 142, 104)
+ }
+
+ /// .systemGray
+ public static var perseusGray: Color {
+ return DarkModeAgent.shared.style == .light ?
+ rgba255(142, 142, 147) : rgba255(142, 142, 147)
+ }
+
+ /// .systemGray2
+ public static var perseusGray2: Color {
+ return DarkModeAgent.shared.style == .light ?
+ rgba255(174, 174, 178) : rgba255(99, 99, 102)
+ }
+
+ /// .systemGray3
+ public static var perseusGray3: Color {
+ return DarkModeAgent.shared.style == .light ?
+ rgba255(199, 199, 204) : rgba255(72, 72, 74)
+ }
+
+ /// .systemGray4
+ public static var perseusGray4: Color {
+ return DarkModeAgent.shared.style == .light ?
+ rgba255(209, 209, 214) : rgba255(58, 58, 60)
+ }
+
+ /// .systemGray5
+ public static var perseusGray5: Color {
+ return DarkModeAgent.shared.style == .light ?
+ rgba255(229, 229, 234) : rgba255(44, 44, 46)
+ }
+
+ /// .systemGray6
+ public static var perseusGray6: Color {
+ return DarkModeAgent.shared.style == .light ?
+ rgba255(242, 242, 247) : rgba255(28, 28, 30)
+ }
+}
+
+#if os(iOS)
+
+@IBDesignable
+public class DarkModeImageView: UIImageView {
+
+ @IBInspectable
+ public var imageLight: UIImage? {
+ didSet {
+ light = imageLight
+ image = DarkMode.style == .light ? light : dark
+ }
+ }
+
+ @IBInspectable
+ public var imageDark: UIImage? {
+ didSet {
+ dark = imageDark
+ image = DarkMode.style == .light ? light : dark
+ }
+ }
+
+ private(set) var theDarknessTrigger: DarkModeObserver?
+
+ private(set) var light: UIImage?
+ private(set) var dark: UIImage?
+
+ override init(frame: CGRect) {
+ super.init(frame: frame)
+ configure()
+ }
+
+ required init?(coder aDecoder: NSCoder) {
+ super.init(coder: aDecoder)
+ configure()
+ }
+
+ private func configure() {
+ theDarknessTrigger = DarkModeObserver { style in
+ self.image = style == .light ? self.light : self.dark
+ }
+
+ image = DarkMode.style == .light ? self.light : self.dark
+ }
+
+ public func configure(_ light: UIImage?, _ dark: UIImage?) {
+ self.light = light
+ self.dark = dark
+
+ theDarknessTrigger?.action = { style in
+ self.image = style == .light ? self.light : self.dark
+ }
+
+ image = DarkMode.style == .light ? self.light : self.dark
+ }
+}
+
+#elseif os(macOS)
+
+public enum ScaleImageViewMacOS: Int, CustomStringConvertible {
+
+ case scaleNone = 0 // No scale at all
+ case axesIndependently = 1 // Aspect Fill
+ case proportionallyUpOrDown = 2 // Aspect Fit
+ case proportionallyDown = 3 // Center Top
+ case proportionallyClipToBounds = 4 // Aspect Fill with cliping to ImageView bounds
+
+ public var description: String {
+ switch self {
+ case .scaleNone:
+ return "As is, no scaling."
+ case .axesIndependently:
+ return "Aspect Fill."
+ case .proportionallyUpOrDown:
+ return "Aspect Fit."
+ case .proportionallyDown:
+ return "Center Top."
+ case .proportionallyClipToBounds:
+ return "Aspect Fill cliped to bounds."
+ }
+ }
+
+ public var value: NSImageScaling {
+ switch self {
+ case .scaleNone:
+ return .scaleNone
+ case .axesIndependently:
+ return .scaleAxesIndependently
+ case .proportionallyUpOrDown:
+ return .scaleProportionallyUpOrDown
+ case .proportionallyDown:
+ return .scaleProportionallyDown
+ case .proportionallyClipToBounds:
+ return .scaleNone
+ }
+ }
+}
+
+@IBDesignable
+public class DarkModeImageView: NSImageView {
+
+ @IBInspectable
+ public var imageLight: NSImage? {
+ didSet {
+ image = DarkMode.style == .light ? imageLight : imageDark
+ }
+ }
+
+ @IBInspectable
+ public var imageDark: NSImage? {
+ didSet {
+ image = DarkMode.style == .light ? imageLight : imageDark
+ }
+ }
+
+ @IBInspectable
+ public var aspectFillClipToBounds: Bool = false
+
+ public var customScale: ScaleImageViewMacOS = .scaleNone {
+ didSet {
+ guard customScale != .proportionallyClipToBounds else {
+
+ self.setContentCompressionResistancePriority(.defaultLow, for: .horizontal)
+ self.setContentCompressionResistancePriority(.defaultLow, for: .vertical)
+
+ self.aspectFillClipToBounds = true
+ self.imageScaling = .scaleNone
+
+ return
+ }
+
+ self.setContentCompressionResistancePriority(.defaultHigh, for: .horizontal)
+ self.setContentCompressionResistancePriority(.defaultHigh, for: .vertical)
+
+ self.aspectFillClipToBounds = false
+ self.imageScaling = customScale.value
+ }
+ }
+
+ private(set) var theDarknessTrigger: DarkModeObserver?
+
+ override public func awakeFromNib() {
+ guard aspectFillClipToBounds else { return }
+
+ self.setContentCompressionResistancePriority(.defaultLow, for: .horizontal)
+ self.setContentCompressionResistancePriority(.defaultLow, for: .vertical)
+
+ self.imageScaling = .scaleNone
+ }
+
+ override init(frame: CGRect) {
+ super.init(frame: frame)
+ configure()
+ }
+
+ required init?(coder aDecoder: NSCoder) {
+ super.init(coder: aDecoder)
+ configure()
+ }
+
+ public func configure(_ light: NSImage?, _ dark: NSImage?) {
+ configure()
+
+ self.imageLight = light
+ self.imageDark = dark
+ }
+
+ private func configure() {
+ theDarknessTrigger = DarkModeObserver { style in
+ self.image = style == .light ? self.imageLight : self.imageDark
+ }
+ }
+
+ override public func draw(_ dirtyRect: NSRect) {
+ guard aspectFillClipToBounds, let image = self.image else {
+ super.draw(dirtyRect)
+ return
+ }
+
+ let viewWidth = self.bounds.size.width
+ let viewHeight = self.bounds.size.height
+
+ let width = image.size.width
+ let height = image.size.height
+
+ let imageViewRatio = viewWidth / viewHeight
+ let imageRatio = width / height
+
+ image.size.width = imageRatio < imageViewRatio ? viewWidth : viewHeight * imageRatio
+ image.size.height = imageRatio < imageViewRatio ? viewWidth / imageRatio : viewHeight
+
+ super.draw(dirtyRect)
+ }
+}
+
+#endif