Skip to content

Commit b5dce1f

Browse files
PerseusRealDealPerseusRealDeal
committed
ADDED: regular update
1 parent 5bef09f commit b5dce1f

10 files changed

Lines changed: 358 additions & 140 deletions

File tree

‎.github/workflows/main.yml‎

Lines changed: 12 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -12,12 +12,12 @@ on:
1212
jobs:
1313

1414
macOS-build:
15-
runs-on: macos-15
15+
runs-on: macos-latest
1616
steps:
1717
- name: Checkout the code
1818
uses: actions/checkout@v4
19-
- name: Select Xcode 16.2
20-
run: sudo xcode-select -s "/Applications/Xcode_16.2.app"
19+
# - name: Select Xcode 16.2
20+
# run: sudo xcode-select -s "/Applications/Xcode_16.2.app"
2121
- uses: mxcl/xcodebuild@v3
2222
with:
2323
platform: macOS
@@ -28,12 +28,12 @@ jobs:
2828
upload-logs: always
2929

3030
macOS-test:
31-
runs-on: macos-15
31+
runs-on: macos-latest
3232
steps:
3333
- name: Checkout the code
3434
uses: actions/checkout@v4
35-
- name: Select Xcode 16.2
36-
run: sudo xcode-select -s "/Applications/Xcode_16.2.app"
35+
# - name: Select Xcode 16.2
36+
# run: sudo xcode-select -s "/Applications/Xcode_16.2.app"
3737
- uses: mxcl/xcodebuild@v3
3838
with:
3939
platform: macOS
@@ -44,12 +44,12 @@ jobs:
4444
upload-logs: always
4545

4646
iOS-build:
47-
runs-on: macos-15
47+
runs-on: macos-latest
4848
steps:
4949
- name: Checkout the code
5050
uses: actions/checkout@v4
51-
- name: Select Xcode 16.2
52-
run: sudo xcode-select -s "/Applications/Xcode_16.2.app"
51+
# - name: Select Xcode 16.2
52+
# run: sudo xcode-select -s "/Applications/Xcode_16.2.app"
5353
- uses: mxcl/xcodebuild@v3
5454
with:
5555
platform: iOS
@@ -60,12 +60,12 @@ jobs:
6060
upload-logs: always
6161

6262
iOS-test:
63-
runs-on: macos-15
63+
runs-on: macos-latest
6464
steps:
6565
- name: Checkout the code
6666
uses: actions/checkout@v4
67-
- name: Select Xcode 16.2
68-
run: sudo xcode-select -s "/Applications/Xcode_16.2.app"
67+
# - name: Select Xcode 16.2
68+
# run: sudo xcode-select -s "/Applications/Xcode_16.2.app"
6969
- uses: mxcl/xcodebuild@v3
7070
with:
7171
platform: iOS

‎APPROBATION.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# Approbation Matrix / PerseusDarkMode 2.0.0 && 2.0.1 && 2.0.2 && 2.0.3 && 2.0.4
1+
# Approbation Matrix / PerseusDarkMode 2.0.0 && 2.0.1 && 2.0.2 && 2.0.3 && 2.0.4 && 2.1.0
22

33
> NOTE: To catch all log messages Mac Console should be started first then after a little while the logged app.
44

‎CHANGELOG.md‎

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,16 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
55

66
Dates in this file meets Gregorian calendar. Date in format YYYY-MM-DD.
77

8+
## [2.1.0] - [2025-10-30], PerseusDarkMode
9+
10+
### Added
11+
12+
- Contents section to README.
13+
14+
### Updated
15+
16+
- CPL dependency to v1.6.0.
17+
818
## [2.0.4] - [2025-07-22], PerseusDarkMode
919

1020
### Changed

‎LICENSE‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
MIT License
22

3-
Copyright © 7530 - 7533 Mikhail A. Zhigulin of Novosibirsk
4-
Copyright © 7533 PerseusRealDeal
3+
Copyright © 7530 - 7534 Mikhail A. Zhigulin of Novosibirsk
4+
Copyright © 7533 - 7534 PerseusRealDeal
55

66
The year starts from the creation of the world according to a Slavic calendar.
77
September, the 1st of Slavic year.

‎PDMStar.swift‎

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,26 +1,26 @@
11
//
22
// PDMStar.swift
3-
// Version: 2.0.4
3+
// Version: 2.1.0
44
//
55
// Standalone PerseusDarkMode.
66
//
77
//
88
// For iOS and macOS only. Use Stars to adopt for the specifics you need.
99
//
10-
// DESC: THE DARKNESS YOU CAN FORCE.
10+
// DESC: THE DARKNESS YOU CAN FORCE
1111
//
1212
// Created by Mikhail Zhigulin in 7530.
1313
//
14-
// Copyright © 7530 - 7533 Mikhail Zhigulin of Novosibirsk
15-
// Copyright © 7533 PerseusRealDeal
14+
// Copyright © 7530 - 7534 Mikhail Zhigulin of Novosibirsk
15+
// Copyright © 7533 - 7534 PerseusRealDeal
1616
//
1717
// All rights reserved.
1818
//
1919
//
2020
// MIT License
2121
//
22-
// Copyright © 7530 - 7533 Mikhail A. Zhigulin of Novosibirsk
23-
// Copyright © 7533 PerseusRealDeal
22+
// Copyright © 7530 - 7534 Mikhail A. Zhigulin of Novosibirsk
23+
// Copyright © 7533 - 7534 PerseusRealDeal
2424
//
2525
// The year starts from the creation of the world according to a Slavic calendar.
2626
// September, the 1st of Slavic year.

‎PDMSupportingStar.swift‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
//
22
// PDMSupportingStar.swift
3-
// Version: 2.0.4
3+
// Version: 2.1.0
44
//
55
// The Darkness Support (PerseusUISystemKit previously)
66
//

‎Package.swift‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,14 @@
11
// swift-tools-version:5.7
22

33
/* Package.swift
4-
Version: 2.0.4
4+
Version: 2.1.0
55

66
For iOS and macOS only. Use Stars to adopt for the specifics you need.
77

88
Created by Mikhail Zhigulin in 7530.
99

10-
Copyright © 7530 - 7533 Mikhail A. Zhigulin of Novosibirsk
11-
Copyright © 7533 PerseusRealDeal
10+
Copyright © 7530 - 7534 Mikhail A. Zhigulin of Novosibirsk
11+
Copyright © 7533 - 7534 PerseusRealDeal
1212

1313
Licensed under the MIT license. See LICENSE file.
1414
All rights reserved.

‎README.md‎

Lines changed: 62 additions & 35 deletions
Original file line numberDiff line numberDiff line change
@@ -1,49 +1,75 @@
11
# PerseusDarkMode — Xcode 14.2+
22

3-
> [`iOS approbation app`](https://github.com/perseusrealdeal/TheOneRing) [`macOS approbation app`](https://github.com/perseusrealdeal/Arkenstone)
4-
5-
> The light-weight darkness in Swift you can force. Hereinafter PDM stands for `P`erseus `D`ark `M`ode.<br/>
6-
7-
> - To build option kinda `Night/Day/System Mode` or `On/Off/System Dark Mode`.<br/>
8-
> - To be awared of Dark Mode changes if you need.<br/>
9-
10-
> `PDM` is a single author and personale solution developed in `person-to-person` relationship paradigm.
11-
123
[![Actions Status](https://github.com/perseusrealdeal/PerseusDarkMode/actions/workflows/main.yml/badge.svg)](https://github.com/perseusrealdeal/PerseusDarkMode/actions/workflows/main.yml)
134
[![Style](https://github.com/perseusrealdeal/PerseusDarkMode/actions/workflows/swiftlint.yml/badge.svg)](https://github.com/perseusrealdeal/PerseusDarkMode/actions/workflows/swiftlint.yml)
14-
[![Version](https://img.shields.io/badge/Version-2.0.4-green.svg)](/CHANGELOG.md)
15-
[![Platforms](https://img.shields.io/badge/Platforms-macOS%2010.13+Cocoa_|_iOS%2011.0+UIKit-orange.svg)](https://en.wikipedia.org/wiki/List_of_Apple_products)
5+
[![Version](https://img.shields.io/badge/Version-2.1.0-green.svg)](/CHANGELOG.md)
6+
[![Platforms](https://img.shields.io/badge/Platforms-macOS%2010.13+_|_iOS%2011.0+-orange.svg)](https://en.wikipedia.org/wiki/List_of_Apple_products)
167
[![Xcode 14.2](https://img.shields.io/badge/Xcode-14.2+-red.svg)](https://en.wikipedia.org/wiki/Xcode)
178
[![Swift 5.7](https://img.shields.io/badge/Swift-5.7-red.svg)](https://www.swift.org)
189
[![License](http://img.shields.io/:License-MIT-blue.svg)](/LICENSE)
1910

11+
> Home-made product. The light-weight darkness in Swift you can force.
12+
13+
> `1:` Build option kinda `Night/Day/System Mode` or `On/Off/System Dark Mode`.</br>
14+
> `2:` Be awared of Dark Mode changes if you need.
15+
16+
> `PDM` is a single author and personale solution developed in `P2P` relationship paradigm.
17+
2018
## Integration Capabilities
2119

2220
[![Standalone](https://img.shields.io/badge/Standalone-available-informational.svg)](/PDMStar.swift)
2321
[![Swift Package Manager compatible](https://img.shields.io/badge/Swift%20Package%20Manager-compatible-4BC51D.svg)](/Package.swift)
2422

25-
> Use Stars to adopt [`PDM`](/PDMStar.swift) for the specifics you need.
26-
2723
## Dependencies
2824

29-
[![ConsolePerseusLogger](http://img.shields.io/:ConsolePerseusLogger-1.5.1-green.svg)](https://github.com/perseusrealdeal/ConsolePerseusLogger.git)
25+
[![ConsolePerseusLogger](http://img.shields.io/:ConsolePerseusLogger-1.6.0-green.svg)](https://github.com/perseusrealdeal/ConsolePerseusLogger.git)
3026

31-
# Support Code
27+
## Support Code
3228

3329
[![Standalone](https://img.shields.io/badge/Standalone-available-informational.svg)](/PDMSupportingStar.swift)
3430
[![License](http://img.shields.io/:License-Unlicense-green.svg)](http://unlicense.org/)
3531

36-
> [`PDMSupportingStar.swift`](/PDMSupportingStar.swift) is a peace of code a widly helpful in accord with PDM.
32+
> [`PDMSupportingStar.swift`](/PDMSupportingStar.swift) is a peace of code a widly helpful in accord with PDM.</br>
33+
> `PDMSupportingStar.swift` goes as an external part of PDM.
34+
35+
## Our Terms
36+
37+
> [`CPL`](https://github.com/perseusrealdeal/ConsolePerseusLogger.git) stands for `C`onsole `P`erseus `L`ogger.</br>
38+
> [`PGK`](https://github.com/perseusrealdeal/PerseusGeoKit.git) stands for `P`erseus `G`eo `K`it.</br>
39+
> [`PDM`](https://github.com/perseusrealdeal/PerseusDarkMode.git) stands for `P`erseus `D`ark `M`ode.</br>
40+
> `P2P` stands for `P`erson-`to`-`P`erson.</br>
41+
> [`A3`](https://docs.google.com/document/d/1K2jOeIknKRRpTEEIPKhxO2H_1eBTof5uTXxyOm5g6nQ) stands for `A`pple `A`pps `A`pprobation.</br>
42+
> [`T3`](https://github.com/perseusrealdeal/TheTechnologicalTree) stands for `T`he `T`echnological `T`ree.
43+
44+
## PDM in Use
45+
46+
> `In approbation:` [`iOS app`](https://github.com/perseusrealdeal/TheOneRing) [`macOS app`](https://github.com/perseusrealdeal/Arkenstone)</br>
47+
> `In business:` [`The Dark Moon`](https://github.com/perseusrealdeal/TheDarkMoon)
3748
38-
> PDMSupportingStar.swift goes as an external part of PDM.
49+
> `For details:` [`Approbation and A3 Environment`](/APPROBATION.md) / [`CHANGELOG`](/CHANGELOG.md)</br>
3950
40-
## Approbation Matrix
51+
# Contents
4152

42-
> [`A3 Environment and Approbation`](/APPROBATION.md) / [`CHANGELOG`](/CHANGELOG.md) for details.
53+
* [In brief](#In-brief)
54+
* [Build requirements](#Build-requirements)
55+
* [First-party software](#First-party-software)
56+
* [Third-party software](#Third-party-software)
57+
* [Installation](#Installation)
58+
* [Cocoa macOS project](#Cocoa-macOS-project)
59+
* [UIKit iOS project](#UIKit-iOS-project)
60+
* [Usage](#Usage)
61+
* [Force Dark Mode](#Force-Dark-Mode)
62+
* [Get awared of DarkMode changes](#Get-awared-of-DarkMode-changes)
63+
* [DarkMode change sample](#DarkMode-change-sample)
64+
* [Points taken into account](#Points-taken-into-account)
65+
* [License MIT](#License-MIT)
66+
* [Other Required License Notices](#Other-Required-License-Notices)
67+
* [Credits](#Credits)
68+
* [Author](#Author)
4369

44-
## In brief > Idea to use, the Why
70+
# In brief
4571

46-
> THE DARKNESS YOU CAN FORCE.</br>
72+
> THE DARKNESS YOU CAN FORCE</br>
4773
4874
<table>
4975
<tr>
@@ -64,7 +90,7 @@
6490
> [!IMPORTANT]
6591
> Screenshots taken from Approbation Apps [`iOS`](https://github.com/perseusrealdeal/TheOneRing) and [`macOS`](https://github.com/perseusrealdeal/Arkenstone).
6692
67-
## Build requirements
93+
# Build requirements
6894

6995
- [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)
7096

@@ -74,7 +100,7 @@
74100

75101
| Type | Name | License |
76102
| ---- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------- |
77-
| Star | [ConsolePerseusLogger](https://github.com/perseusrealdeal/ConsolePerseusLogger) / [1.5.1](https://github.com/perseusrealdeal/ConsolePerseusLogger/releases/tag/1.5.1) | MIT |
103+
| Star | [ConsolePerseusLogger](https://github.com/perseusrealdeal/ConsolePerseusLogger) / [1.6.0](https://github.com/perseusrealdeal/ConsolePerseusLogger/releases/tag/1.6.0) | MIT |
78104

79105
# Third-party software
80106

@@ -93,7 +119,7 @@
93119
94120
> Swift Package Manager: `https://github.com/perseusrealdeal/PerseusDarkMode`
95121
96-
## Steps for Cocoa macOS project
122+
## Cocoa macOS project
97123

98124
`Step 2:` In the AppDelegate when `applicationDidFinishLaunching` call `force`
99125

@@ -139,7 +165,7 @@ class MainWindowController: NSWindowController, NSWindowDelegate {
139165

140166
```
141167

142-
## Steps for UIKit iOS project
168+
## UIKit iOS project
143169

144170
`Step 2:` In the AppDelegate when `didFinishLaunchingWithOptions` call `force`
145171

@@ -231,11 +257,11 @@ DarkModeAgent.force(.off) // It's a sunny day for the app.
231257

232258
The `force` will change the appearance of your app immediately including system components and will make run all custom DarkMode code `makeUp()`.
233259

234-
## Get awared of DarkMode Changes
260+
## Get awared of DarkMode changes
235261

236-
> To declare custom DarkMode sensitive code that runs every time if DarkMode Changes register the object or creat a DarkMode trigger:
262+
> To declare custom DarkMode sensitive code that runs every time if DarkMode Changes register the object or create a DarkMode trigger:
237263

238-
`Use Case -` Register an object to be notified on changes
264+
`Use Case 1:` Register an object to be notified on changes
239265

240266
```swift
241267

@@ -252,7 +278,7 @@ class DarkModeSensitiveObject {
252278

253279
```
254280

255-
`Use Case -` Creat a DarkMode trigger and give it an action
281+
`Use Case 2:` Create a DarkMode trigger and give it an action
256282

257283
```swift
258284

@@ -273,9 +299,9 @@ class DarkModeSensitiveObject {
273299

274300
```
275301

276-
## React to DarkMode Changes
302+
## DarkMode change sample
277303

278-
`Use Case -` Custom DarkMode Sensitive Color
304+
`Use Case:` Custom DarkMode sensitive color
279305

280306
```swift
281307

@@ -309,11 +335,12 @@ extension Color {
309335

310336
```
311337

312-
> Use Custom DarkMode sensitive color.
338+
> And use custom DarkMode sensitive color:
313339

314340
```swift
315341

316-
// Runs every time if the DarkMode changes. Use KVO (DarkModeObserver) or be registered by DarkModeAgent.
342+
// Runs every time if the DarkMode changes.
343+
// Use KVO (DarkModeObserver) or be registered with DarkModeAgent.
317344
@objc private func makeUp() {
318345
self.backgroundColor = .customRed
319346
}
@@ -330,8 +357,8 @@ extension Color {
330357

331358
# License MIT
332359

333-
Copyright © 7530 - 7533 Mikhail A. Zhigulin of Novosibirsk<br/>
334-
Copyright © 7533 PerseusRealDeal
360+
Copyright © 7530 - 7534 Mikhail A. Zhigulin of Novosibirsk<br/>
361+
Copyright © 7533 - 7534 PerseusRealDeal
335362

336363
- The year starts from the creation of the world according to a Slavic calendar.
337364
- September, the 1st of Slavic year. It means that "Sep 01, 2024" is the beginning of 7533.

0 commit comments

Comments
 (0)