[ { "path": ".github/FUNDING.yml", "content": "github: [muukii]\npatreon: muukii\nko_fi: muukii\n" }, { "path": ".github/workflows/CommitChecks.yml", "content": "name: CommitChecks\n\non:\n push:\n branches:\n - \"**\"\n\njobs:\n test:\n runs-on: macos-15\n\n steps:\n - uses: maxim-lobanov/setup-xcode@v1.1\n with:\n xcode-version: \"26\"\n - uses: actions/checkout@v2\n - name: Run Test\n run: set -o pipefail && xcodebuild -scheme Verge-Package test -destination 'platform=iOS Simulator,name=iPhone 17 Pro,OS=26.0' -skipMacroValidation -skipPackagePluginValidation | xcbeautify\n\n ui-test:\n runs-on: macos-15\n defaults:\n run:\n working-directory: ./Development\n\n steps:\n - uses: maxim-lobanov/setup-xcode@v1.1\n with:\n xcode-version: \"26\"\n - uses: actions/checkout@v2\n - uses: jdx/mise-action@v2\n with:\n install: true\n cache: true\n experimental: true\n - run: tuist install\n - run: tuist generate --no-open\n - run: tuist test\n" }, { "path": ".gitignore", "content": "\n# Created by https://www.gitignore.io/api/swift\n\n### Swift ###\n# Xcode\n#\n# gitignore contributors: remember to update Global/Xcode.gitignore, Objective-C.gitignore & Swift.gitignore\n/worktree\n\n## Build generated\nbuild/\nDerivedData/\n\n.swiftpm\n\n## Various settings\n*.pbxuser\n!default.pbxuser\n*.mode1v3\n!default.mode1v3\n*.mode2v3\n!default.mode2v3\n*.perspectivev3\n!default.perspectivev3\nxcuserdata/\n\n## Other\n*.moved-aside\n*.xccheckout\n*.xcscmblueprint\n\n## Obj-C/Swift specific\n*.hmap\n*.ipa\n*.dSYM.zip\n*.dSYM\n\n## Playgrounds\ntimeline.xctimeline\nplayground.xcworkspace\n\n# Swift Package Manager\n#\n# Add this line if you want to avoid checking in source code from Swift Package Manager dependencies.\n# Packages/\n# Package.pins\n.build/\n\n# CocoaPods - Refactored to standalone file\n\nPods\n\n# Carthage - Refactored to standalone file\n\nCarthage\n\n# fastlane\n#\n# It is recommended to not store the screenshots in the git repo. Instead, use fastlane to re-generate the\n# screenshots whenever they are needed.\n# For more information about the recommended setup visit:\n# https://docs.fastlane.tools/best-practices/source-control/#source-control\n\nfastlane/report.xml\nfastlane/Preview.html\nfastlane/screenshots\nfastlane/test_output\n\n.DS_Store\n\n# Tuist\nDerived\n*.xcodeproj\n\nWorkspace.xcworkspace/\n\nsettings.local.json\n\n# End of https://www.gitignore.io/api/swift\n" }, { "path": ".spi.yml", "content": "version: 1\nbuilder:\n configs:\n - documentation_targets: [Verge, VergeNormalizationDerived]\n" }, { "path": "Development/.gitignore", "content": "### macOS ###\n# General\n.DS_Store\n.AppleDouble\n.LSOverride\n\n# Icon must end with two\nIcon\n\n# Thumbnails\n._*\n\n# Files that might appear in the root of a volume\n.DocumentRevisions-V100\n.fseventsd\n.Spotlight-V100\n.TemporaryItems\n.Trashes\n.VolumeIcon.icns\n.com.apple.timemachine.donotpresent\n\n# Directories potentially created on remote AFP share\n.AppleDB\n.AppleDesktop\nNetwork Trash Folder\nTemporary Items\n.apdisk\n\n### Xcode ###\n# Xcode\n#\n# gitignore contributors: remember to update Global/Xcode.gitignore, Objective-C.gitignore & Swift.gitignore\n\n## User settings\nxcuserdata/\n\n## compatibility with Xcode 8 and earlier (ignoring not required starting Xcode 9)\n*.xcscmblueprint\n*.xccheckout\n\n## compatibility with Xcode 3 and earlier (ignoring not required starting Xcode 4)\nbuild/\nDerivedData/\n*.moved-aside\n*.pbxuser\n!default.pbxuser\n*.mode1v3\n!default.mode1v3\n*.mode2v3\n!default.mode2v3\n*.perspectivev3\n!default.perspectivev3\n\n### Xcode Patch ###\n*.xcodeproj/*\n!*.xcodeproj/project.pbxproj\n!*.xcodeproj/xcshareddata/\n!*.xcworkspace/contents.xcworkspacedata\n/*.gcno\n\n### Projects ###\n*.xcodeproj\n*.xcworkspace\n\n### Tuist derived files ###\ngraph.dot\nDerived/\n\n### Tuist managed dependencies ###\nTuist/.build" }, { "path": "Development/Development/Resources/Assets.xcassets/AccentColor.colorset/Contents.json", "content": "{\n \"colors\" : [\n {\n \"idiom\" : \"universal\"\n }\n ],\n \"info\" : {\n \"author\" : \"xcode\",\n \"version\" : 1\n }\n}\n" }, { "path": "Development/Development/Resources/Assets.xcassets/AppIcon.appiconset/Contents.json", "content": "{\n \"images\" : [\n {\n \"idiom\" : \"iphone\",\n \"scale\" : \"2x\",\n \"size\" : \"20x20\"\n },\n {\n \"idiom\" : \"iphone\",\n \"scale\" : \"3x\",\n \"size\" : \"20x20\"\n },\n {\n \"idiom\" : \"iphone\",\n \"scale\" : \"2x\",\n \"size\" : \"29x29\"\n },\n {\n \"idiom\" : \"iphone\",\n \"scale\" : \"3x\",\n \"size\" : \"29x29\"\n },\n {\n \"idiom\" : \"iphone\",\n \"scale\" : \"2x\",\n \"size\" : \"40x40\"\n },\n {\n \"idiom\" : \"iphone\",\n \"scale\" : \"3x\",\n \"size\" : \"40x40\"\n },\n {\n \"idiom\" : \"iphone\",\n \"scale\" : \"2x\",\n \"size\" : \"60x60\"\n },\n {\n \"idiom\" : \"iphone\",\n \"scale\" : \"3x\",\n \"size\" : \"60x60\"\n },\n {\n \"idiom\" : \"ipad\",\n \"scale\" : \"1x\",\n \"size\" : \"20x20\"\n },\n {\n \"idiom\" : \"ipad\",\n \"scale\" : \"2x\",\n \"size\" : \"20x20\"\n },\n {\n \"idiom\" : \"ipad\",\n \"scale\" : \"1x\",\n \"size\" : \"29x29\"\n },\n {\n \"idiom\" : \"ipad\",\n \"scale\" : \"2x\",\n \"size\" : \"29x29\"\n },\n {\n \"idiom\" : \"ipad\",\n \"scale\" : \"1x\",\n \"size\" : \"40x40\"\n },\n {\n \"idiom\" : \"ipad\",\n \"scale\" : \"2x\",\n \"size\" : \"40x40\"\n },\n {\n \"idiom\" : \"ipad\",\n \"scale\" : \"1x\",\n \"size\" : \"76x76\"\n },\n {\n \"idiom\" : \"ipad\",\n \"scale\" : \"2x\",\n \"size\" : \"76x76\"\n },\n {\n \"idiom\" : \"ipad\",\n \"scale\" : \"2x\",\n \"size\" : \"83.5x83.5\"\n },\n {\n \"idiom\" : \"ios-marketing\",\n \"scale\" : \"1x\",\n \"size\" : \"1024x1024\"\n }\n ],\n \"info\" : {\n \"author\" : \"xcode\",\n \"version\" : 1\n }\n}\n" }, { "path": "Development/Development/Resources/Assets.xcassets/Contents.json", "content": "{\n \"info\" : {\n \"author\" : \"xcode\",\n \"version\" : 1\n }\n}\n" }, { "path": "Development/Development/Resources/Preview Content/Preview Assets.xcassets/Contents.json", "content": "{\n \"info\" : {\n \"author\" : \"xcode\",\n \"version\" : 1\n }\n}\n" }, { "path": "Development/Development/Sources/BookBinding.swift", "content": "\nimport SwiftUI\nimport Verge\n\nstruct BookBindingUsingReading: View {\n \n @ReadingObject> var state: BookBindingState\n \n init() {\n self._state = .init({\n .init(initialState: .init())\n })\n }\n \n var body: some View {\n Counter(value: $state.value)\n }\n \n struct Counter: View {\n \n @Binding var value: Int\n \n var body: some View {\n VStack {\n Text(\"\\(value)\")\n Button {\n value += 1\n } label: {\n Text(\"Increment\")\n }\n }\n }\n }\n \n}\n\nstruct BookBindingUsingStoreReader: View {\n \n let store: Store = .init(initialState: .init())\n \n init() {\n }\n \n var body: some View {\n StoreReader(store) { $state in \n Counter(value: $state.value)\n }\n }\n \n struct Counter: View {\n \n @Binding var value: Int\n \n var body: some View {\n VStack {\n Text(\"\\(value)\")\n Button {\n value += 1\n } label: {\n Text(\"Increment\")\n }\n }\n }\n }\n \n}\n\n@Tracking\nstruct BookBindingState {\n \n var value: Int = 0\n \n}\n\n#Preview(\"Binding Reading\") {\n BookBindingUsingReading()\n}\n\n#Preview(\"Binding StoreReader\") {\n BookBindingUsingStoreReader()\n}\n" }, { "path": "Development/Development/Sources/BookLongList.swift", "content": "//\n// BookLongList.swift\n// Development\n//\n// Created by Muukii on 2025/03/26.\n//\n\nimport SwiftUI\nimport Verge\n\n@Tracking\nstruct BookState {\n var items: [BookItem] = []\n \n init(items: [BookItem]) {\n self.items = items\n }\n}\n\nstruct BookItem: Identifiable {\n var id: some Hashable {\n cellStore\n }\n let cellStore: Store\n}\n\n@Tracking\nstruct BookCellState {\n let id: Int\n var title: String\n var isSelected: Bool = false\n}\n\nstruct BookCellContent: View {\n \n let store: Store\n\n var body: some View {\n StoreReader(store) { $state in\n RoundedRectangle(cornerRadius: 8)\n .fill(state.isSelected ? Color.red : Color.blue.opacity(0.2))\n .aspectRatio(1, contentMode: .fit)\n .overlay(\n Text(\"\\(state.id + 1)\")\n .font(.system(size: 16))\n ) \n }\n }\n}\n\nstruct BookCell: View {\n \n let store: Store\n\n var body: some View {\n Button {\n store.commit { state in\n state.isSelected.toggle()\n }\n } label: { \n BookCellContent(store: store)\n }\n }\n}\n\nstruct BookLongList: View {\n private let columns = [\n GridItem(.flexible()),\n GridItem(.flexible()),\n GridItem(.flexible()),\n GridItem(.flexible()),\n ]\n\n @ReadingObject>({\n .init(initialState: .init(items: (0..<500).map { index in\n BookItem(\n cellStore: Store(\n initialState: BookCellState(\n id: index,\n title: UUID().uuidString\n )\n )\n )\n }))\n }) var state: BookState\n\n init() {\n \n }\n\n var body: some View {\n ScrollView {\n LazyVGrid(columns: columns, spacing: 16) {\n ForEach(state.items) { item in\n BookCell(store: item.cellStore)\n }\n }\n .padding()\n }\n }\n}\n\n#Preview {\n BookLongList()\n}\n" }, { "path": "Development/Development/Sources/BookReadingPropertyWrapper.swift", "content": "import Verge\nimport SwiftUI\n\nstruct BookReading: View {\n \n var body: some View {\n ReadingSolution()\n }\n \n}\n\n@Tracking\nstruct MyState {\n \n var value: Int = 0\n \n var a: Int = 0\n var b: Int = 0\n var c: Int = 0\n}\n\nextension Store where State == MyState {\n \n func backgroundUpdate() {\n Task {\n await self.backgroundCommit { \n $0.value += 1\n $0.a += 1\n $0.b += 1\n $0.c += 1 \n }\n }\n }\n \n}\n\nenum ItemKind: Identifiable {\n case first\n case second\n case third\n var id: String {\n switch self {\n case .first: return \"1\"\n case .second: return \"2\"\n case .third: return \"3\"\n }\n }\n}\n\nstruct ItemDetail: View {\n \n let items: [Item]\n let content: (Item) -> Content\n \n @State var selectedItem: Item?\n private let name: String\n \n init(\n name: String,\n items: [Item],\n @ViewBuilder content: @escaping (Item) -> Content\n ) {\n self.name = name\n self.items = items\n self.content = content \n }\n \n var body: some View {\n VStack {\n ForEach(items) { item in\n Button(\"\\(name).\\(item.id)\") {\n selectedItem = item\n } \n }\n \n if let item = selectedItem {\n content(item)\n .padding()\n .background(Color.orange)\n }\n }\n }\n \n}\n\nprivate struct ReadingSolution: View {\n \n @State var id: Int = 0\n @State var outerValue: Int = 0\n \n init() {\n print(\"init\")\n }\n \n var body: some View {\n VStack { \n \n Button(\"New\") {\n id += 1\n }\n Button(\"Up Outer\") {\n outerValue += 1\n }\n Solution(outerValue: outerValue)\n .id(id)\n .padding()\n .background(Color.green)\n\n }\n }\n \n struct Solution: View {\n \n let items: [ItemKind] = [\n .first,\n .second,\n .third,\n ]\n \n @ReadingObject> var state: MyState\n \n private let outerValue: Int\n \n init(outerValue: Int) {\n self._state = .init(\n label: \"A\", { \n Store<_, Never>.init(initialState: MyState())\n }\n )\n self.outerValue = outerValue\n }\n \n var body: some View {\n HStack {\n VStack {\n Text(\"Using Store holding\")\n Button(\"async up\") {\n $state.driver.backgroundUpdate()\n }\n Button(\"A Up\") {\n $state.driver.commit {\n $0.value += 1\n }\n }\n Text(\"A Value: \\(state.value)\")\n Text(\"Outer: \\(outerValue)\")\n ItemDetail(name: \"A\", items: items) { item in\n switch item {\n case .first:\n Button.init(\"A.1.a: \\(state.a)\") { \n $state.driver.commit {\n $0.a += 1\n }\n }\n case .second:\n Button.init(\"A.1.b: \\(state.b)\") { \n $state.driver.commit {\n $0.b += 1\n }\n } \n case .third:\n Button.init(\"A.1.c: \\(state.c)\") { \n $state.driver.commit {\n $0.c += 1\n }\n } \n }\n \n }\n .padding()\n .background(Color.yellow)\n }\n Passed(store: $state.driver)\n }\n }\n }\n \n struct Passed: View {\n \n let items: [ItemKind] = [\n .first,\n .second,\n .third,\n ]\n \n @Reading> var state: MyState\n \n init(\n store: Store\n ) {\n self._state = .init(label: \"B\", store)\n }\n \n var body: some View {\n VStack {\n Text(\"Using Store passed\")\n Button(\"B Up\") {\n $state.driver.commit {\n $0.value += 1\n }\n }\n Text(\"B Value: \\(state.value)\")\n ItemDetail(name: \"B\",items: items) { item in\n switch item {\n case .first:\n Button.init(\"B.1.a: \\(state.a)\") { \n $state.driver.commit {\n $0.a += 1\n }\n }\n case .second:\n Button.init(\"B.1.b: \\(state.b)\") { \n $state.driver.commit {\n $0.b += 1\n }\n } \n case .third:\n Button.init(\"B.1.c: \\(state.c)\") { \n $state.driver.commit {\n $0.c += 1\n }\n } \n }\n \n }\n .padding()\n .background(Color.yellow)\n }\n }\n \n }\n}\n\nstruct PassedContainer: View {\n \n private let store: Store = .init(initialState: MyState())\n @State var count: Int = 0\n \n var body: some View {\n VStack {\n Button(\"Outer Up \\(count)\") {\n count += 1\n }\n ReadingSolution.Passed(store: store)\n }\n }\n \n}\n\n#Preview(\"Reading solution\") {\n ReadingSolution()\n}\n\n#Preview(\"Passed solution\") {\n PassedContainer()\n}\n" }, { "path": "Development/Development/Sources/BookStoreReader.swift", "content": "import SwiftUI\nimport Verge\n\nstruct StoreReaderSolution: View {\n @State var id: Int = 0\n @State var outerValue: Int = 0\n \n init() {\n print(\"init\")\n }\n \n var body: some View {\n VStack { \n Button(\"New\") {\n id += 1\n }\n Button(\"Up Outer\") {\n outerValue += 1\n }\n Solution(outerValue: outerValue)\n .id(id)\n .padding()\n .background(Color.green)\n }\n }\n \n struct Solution: View {\n let items: [ItemKind] = [\n .first,\n .second,\n .third,\n ]\n \n @StoreObject var store = Store(initialState: .init())\n private let outerValue: Int\n \n init(outerValue: Int) {\n self.outerValue = outerValue\n }\n \n var body: some View {\n HStack {\n VStack {\n Text(\"Using Store holding\")\n StoreReader(store) { $state in\n VStack {\n Button(\"A Up\") {\n store.commit {\n $0.value += 1\n }\n }\n Text(\"A Value: \\(state.value)\")\n Text(\"Outer: \\(outerValue)\")\n ItemDetail(name: \"A\", items: items) { item in\n switch item {\n case .first:\n Button(\"A.1.a: \\(state.a)\") {\n store.commit {\n $0.a += 1\n }\n }\n case .second:\n Button(\"A.1.b: \\(state.b)\") {\n store.commit {\n $0.b += 1\n }\n }\n case .third:\n Button(\"A.1.c: \\(state.c)\") {\n store.commit {\n $0.c += 1\n }\n }\n }\n }\n .padding()\n .background(Color.yellow)\n }\n }\n }\n Passed(store: store)\n }\n }\n }\n \n struct Passed: View {\n let items: [ItemKind] = [\n .first,\n .second,\n .third,\n ]\n \n private let store: Store\n \n init(store: Store) {\n self.store = store\n }\n \n var body: some View {\n VStack {\n Text(\"Using Store passed\")\n StoreReader(store) { $state in\n VStack {\n Button(\"B Up\") {\n store.commit {\n $0.value += 1\n }\n }\n Text(\"B Value: \\(state.value)\")\n ItemDetail(name: \"B\", items: items) { item in\n switch item {\n case .first:\n Button(\"B.1.a: \\(state.a)\") {\n store.commit {\n $0.a += 1\n }\n }\n case .second:\n Button(\"B.1.b: \\(state.b)\") {\n store.commit {\n $0.b += 1\n }\n }\n case .third:\n Button(\"B.1.c: \\(state.c)\") {\n store.commit {\n $0.c += 1\n }\n }\n }\n }\n .padding()\n .background(Color.yellow)\n }\n }\n }\n }\n }\n}\n\n\n#Preview(\"Reading solution\") {\n StoreReaderSolution()\n}\n" }, { "path": "Development/Development/Sources/ContentView.swift", "content": "import SwiftUI\n\npublic struct ContentView: View {\n public init() {}\n\n public var body: some View {\n NavigationStack {\n\n List {\n\n NavigationLink {\n BookReading()\n } label: {\n Text(\"@Reading\")\n }\n\n NavigationLink {\n PassedContainer()\n } label: {\n Text(\"@Reading - passed\")\n }\n \n NavigationLink {\n StoreReaderSolution()\n } label: {\n Text(\"StoreReader\")\n }\n \n NavigationLink {\n BookLongList()\n } label: {\n Text(\"Long List\")\n }\n \n NavigationLink {\n BookBindingUsingReading()\n } label: {\n Text(\"Binding @Reading\")\n }\n \n NavigationLink {\n BookBindingUsingStoreReader()\n } label: {\n Text(\"Binding StoreReader\")\n }\n }\n\n }\n }\n}\n\nstruct ContentView_Previews: PreviewProvider {\n static var previews: some View {\n ContentView()\n }\n}\n" }, { "path": "Development/Development/Sources/DevelopmentApp.swift", "content": "import SwiftUI\n\n@main\nstruct DevelopmentApp: App {\n var body: some Scene {\n WindowGroup {\n ContentView()\n }\n }\n}\n" }, { "path": "Development/Development/Tests/DevelopmentTests.swift", "content": "import Foundation\nimport XCTest\n\nfinal class DevelopmentTests: XCTestCase {\n func test_twoPlusTwo_isFour() {\n XCTAssertEqual(2+2, 4)\n }\n}" }, { "path": "Development/Development/UITests/ReadingTests.swift", "content": "import XCTest\n\nfinal class ReadingTests: XCTestCase {\n\n var app: XCUIApplication!\n\n override func setUpWithError() throws {\n continueAfterFailure = false\n app = XCUIApplication()\n app.launch()\n }\n\n override func tearDownWithError() throws {\n app = nil\n }\n\n func testA_up() {\n\n let app = XCUIApplication()\n app.collectionViews.buttons[\n \"@Reading\"\n ]\n .tap()\n\n app.buttons[\"A Up\"].tap()\n\n XCTAssertTrue(app.staticTexts[\"A Value: 1\"].exists)\n XCTAssertTrue(app.staticTexts[\"B Value: 1\"].exists)\n\n }\n\n func test_sync() {\n\n let app = XCUIApplication()\n app.collectionViews.buttons[\n \"@Reading\"\n ]\n .tap()\n app.buttons[\"A.1\"].tap()\n\n app.buttons[\"A.1.a: 0\"].tap()\n\n XCTAssertTrue(app.buttons[\"A.1.a: 1\"].exists)\n\n app.buttons[\"B.1\"].tap()\n\n XCTAssertTrue(app.buttons[\"B.1.a: 1\"].exists)\n \n app.buttons[\"B.1.a: 1\"].tap()\n \n XCTAssertTrue(app.buttons[\"A.1.a: 2\"].exists)\n XCTAssertTrue(app.buttons[\"B.1.a: 2\"].exists)\n\n }\n \n func test_binding_reading() {\n \n let app = XCUIApplication()\n app.collectionViews/*@START_MENU_TOKEN@*/.buttons[\"Binding @Reading\"]/*[[\".cells.buttons[\\\"Binding @Reading\\\"]\",\".buttons[\\\"Binding @Reading\\\"]\"],[[[-1,1],[-1,0]]],[0]]@END_MENU_TOKEN@*/.tap()\n app.buttons[\"Increment\"].tap()\n \n XCTAssertTrue(app.staticTexts[\"1\"].exists)\n \n }\n \n func test_binding_storeReader() {\n \n let app = XCUIApplication()\n app.collectionViews.buttons[\"Binding StoreReader\"].tap()\n app.buttons[\"Increment\"].tap()\n \n XCTAssertTrue(app.staticTexts[\"1\"].exists)\n \n }\n}\n" }, { "path": "Development/Development/UITests/StoreReaderTests.swift", "content": "import XCTest\n\nfinal class StoreReaderTests: XCTestCase {\n \n var app: XCUIApplication!\n \n override func setUpWithError() throws {\n continueAfterFailure = false\n app = XCUIApplication()\n app.launch()\n }\n \n override func tearDownWithError() throws {\n app = nil\n }\n \n func testA_up() {\n \n let app = XCUIApplication()\n app.collectionViews.buttons[\n \"StoreReader\"\n ]\n .tap()\n \n app.buttons[\"A Up\"].tap()\n \n XCTAssertTrue(app.staticTexts[\"A Value: 1\"].exists)\n XCTAssertTrue(app.staticTexts[\"B Value: 1\"].exists)\n \n }\n \n func test_sync() {\n \n let app = XCUIApplication()\n app.collectionViews.buttons[\n \"StoreReader\"\n ]\n .tap()\n app.buttons[\"A.1\"].tap()\n \n app.buttons[\"A.1.a: 0\"].tap()\n \n XCTAssertTrue(app.buttons[\"A.1.a: 1\"].exists)\n \n app.buttons[\"B.1\"].tap()\n \n XCTAssertTrue(app.buttons[\"B.1.a: 1\"].exists)\n \n app.buttons[\"B.1.a: 1\"].tap()\n \n XCTAssertTrue(app.buttons[\"A.1.a: 2\"].exists)\n XCTAssertTrue(app.buttons[\"B.1.a: 2\"].exists)\n \n \n }\n}\n" }, { "path": "Development/DevelopmentUITests/DevelopmentUITests.swift", "content": "//\n// DevelopmentUITests.swift\n// DevelopmentUITests\n//\n// Created by Muukii on 2025/03/22.\n//\n\nimport XCTest\n\nfinal class DevelopmentUITests: XCTestCase {\n\n override func setUpWithError() throws {\n // Put setup code here. This method is called before the invocation of each test method in the class.\n\n // In UI tests it is usually best to stop immediately when a failure occurs.\n continueAfterFailure = false\n\n // In UI tests it’s important to set the initial state - such as interface orientation - required for your tests before they run. The setUp method is a good place to do this.\n }\n\n override func tearDownWithError() throws {\n // Put teardown code here. This method is called after the invocation of each test method in the class.\n }\n\n @MainActor\n func testExample() throws {\n // UI tests must launch the application that they test.\n let app = XCUIApplication()\n app.launch()\n\n // Use XCTAssert and related functions to verify your tests produce the correct results.\n }\n\n @MainActor\n func testLaunchPerformance() throws {\n if #available(macOS 10.15, iOS 13.0, tvOS 13.0, watchOS 7.0, *) {\n // This measures how long it takes to launch your application.\n measure(metrics: [XCTApplicationLaunchMetric()]) {\n XCUIApplication().launch()\n }\n }\n }\n}\n" }, { "path": "Development/DevelopmentUITests/DevelopmentUITestsLaunchTests.swift", "content": "//\n// DevelopmentUITestsLaunchTests.swift\n// DevelopmentUITests\n//\n// Created by Muukii on 2025/03/22.\n//\n\nimport XCTest\n\nfinal class DevelopmentUITestsLaunchTests: XCTestCase {\n\n override class var runsForEachTargetApplicationUIConfiguration: Bool {\n true\n }\n\n override func setUpWithError() throws {\n continueAfterFailure = false\n }\n\n @MainActor\n func testLaunch() throws {\n let app = XCUIApplication()\n app.launch()\n\n // Insert steps here to perform after app launch but before taking a screenshot,\n // such as logging into a test account or navigating somewhere in the app\n\n let attachment = XCTAttachment(screenshot: app.screenshot())\n attachment.name = \"Launch Screen\"\n attachment.lifetime = .keepAlways\n add(attachment)\n }\n}\n" }, { "path": "Development/Project.swift", "content": "import ProjectDescription\n\nlet project = Project(\n name: \"Development\",\n targets: [\n .target(\n name: \"Development\",\n destinations: .iOS,\n product: .app,\n bundleId: \"io.tuist.Development\",\n infoPlist: .extendingDefault(\n with: [\n \"UILaunchScreen\": [\n \"UIColorName\": \"\",\n \"UIImageName\": \"\",\n ]\n ]\n ),\n sources: [\"Development/Sources/**\"],\n resources: [\"Development/Resources/**\"],\n dependencies: [\n .external(name: \"Verge\")\n ]\n ),\n .target(\n name: \"DevelopmentUITests\",\n destinations: .iOS,\n product: .uiTests,\n bundleId: \"io.tuist.DevelopmentUITests\",\n infoPlist: .default,\n sources: [\"Development/UITests/**\"],\n resources: [],\n dependencies: [.target(name: \"Development\")]\n ),\n .target(\n name: \"DevelopmentTests\",\n destinations: .iOS,\n product: .unitTests,\n bundleId: \"io.tuist.DevelopmentTests\",\n infoPlist: .default,\n sources: [\"Development/Tests/**\"],\n resources: [],\n dependencies: [.target(name: \"Development\")]\n ),\n ]\n)\n" }, { "path": "Development/Tuist/Package.resolved", "content": "{\n \"originHash\" : \"fb710b9bf77d01a2d48fc3e3b210bfb0e949769f26d1ca1c351ac86995dca6fb\",\n \"pins\" : [\n {\n \"identity\" : \"normalization\",\n \"kind\" : \"remoteSourceControl\",\n \"location\" : \"https://github.com/VergeGroup/Normalization\",\n \"state\" : {\n \"revision\" : \"6e7cb1ddeda4d0f1d2fbf8ca6d25ecd8ed6ba917\",\n \"version\" : \"1.1.0\"\n }\n },\n {\n \"identity\" : \"rxswift\",\n \"kind\" : \"remoteSourceControl\",\n \"location\" : \"https://github.com/ReactiveX/RxSwift.git\",\n \"state\" : {\n \"revision\" : \"5dd1907d64f0d36f158f61a466bab75067224893\",\n \"version\" : \"6.9.0\"\n }\n },\n {\n \"identity\" : \"swift-atomics\",\n \"kind\" : \"remoteSourceControl\",\n \"location\" : \"https://github.com/apple/swift-atomics.git\",\n \"state\" : {\n \"revision\" : \"cd142fd2f64be2100422d658e7411e39489da985\",\n \"version\" : \"1.2.0\"\n }\n },\n {\n \"identity\" : \"swift-collections\",\n \"kind\" : \"remoteSourceControl\",\n \"location\" : \"https://github.com/apple/swift-collections\",\n \"state\" : {\n \"revision\" : \"671108c96644956dddcd89dd59c203dcdb36cec7\",\n \"version\" : \"1.1.4\"\n }\n },\n {\n \"identity\" : \"swift-concurrency-task-manager\",\n \"kind\" : \"remoteSourceControl\",\n \"location\" : \"https://github.com/VergeGroup/swift-concurrency-task-manager\",\n \"state\" : {\n \"revision\" : \"340cf14e0282977deeeb436605d1810ce4f4fbc9\",\n \"version\" : \"1.4.0\"\n }\n },\n {\n \"identity\" : \"swift-macro-state-struct\",\n \"kind\" : \"remoteSourceControl\",\n \"location\" : \"https://github.com/VergeGroup/swift-macro-state-struct\",\n \"state\" : {\n \"revision\" : \"b6ade33024ae04699fa6a4885be70c0299eb3cec\",\n \"version\" : \"2.0.0\"\n }\n },\n {\n \"identity\" : \"swift-syntax\",\n \"kind\" : \"remoteSourceControl\",\n \"location\" : \"https://github.com/apple/swift-syntax.git\",\n \"state\" : {\n \"revision\" : \"0687f71944021d616d34d922343dcef086855920\",\n \"version\" : \"600.0.1\"\n }\n },\n {\n \"identity\" : \"typedcomparator\",\n \"kind\" : \"remoteSourceControl\",\n \"location\" : \"https://github.com/VergeGroup/TypedComparator\",\n \"state\" : {\n \"revision\" : \"337ce0e573e7637ddd29392cb88c3b852f042c8e\",\n \"version\" : \"1.0.0\"\n }\n },\n {\n \"identity\" : \"typedidentifier\",\n \"kind\" : \"remoteSourceControl\",\n \"location\" : \"https://github.com/VergeGroup/TypedIdentifier\",\n \"state\" : {\n \"revision\" : \"284340409ba47858a1b3c353dcef9c21303953db\",\n \"version\" : \"2.0.3\"\n }\n }\n ],\n \"version\" : 3\n}\n" }, { "path": "Development/Tuist/Package.swift", "content": "// swift-tools-version: 6.0\nimport PackageDescription\n\n#if TUIST\n import struct ProjectDescription.PackageSettings\n\n let packageSettings = PackageSettings(\n // Customize the product types for specific package product\n // Default is .staticFramework\n // productTypes: [\"Alamofire\": .framework,]\n productTypes: [:]\n )\n#endif\n\nlet package = Package(\n name: \"Development\",\n dependencies: [\n // Add your own dependencies here:\n // .package(url: \"https://github.com/Alamofire/Alamofire\", from: \"5.0.0\"),\n // You can read more about dependencies here: https://docs.tuist.io/documentation/tuist/dependencies\n .package(path: \"../../\")\n ] \n)\n" }, { "path": "Development/Tuist.swift", "content": "import ProjectDescription\n\nlet tuist = Tuist(project: .tuist())" }, { "path": "Development/mise.toml", "content": "[tools]\ntuist = \"4.44.3\"\n" }, { "path": "LICENSE", "content": "MIT License\n\nCopyright (c) 2017 muukii\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n" }, { "path": "Package.resolved", "content": "{\n \"originHash\" : \"e0239f7d7b3b817d553cd88ff38b3bf2eaf6a4d2aa61a19fb57aed0c303e01eb\",\n \"pins\" : [\n {\n \"identity\" : \"normalization\",\n \"kind\" : \"remoteSourceControl\",\n \"location\" : \"https://github.com/VergeGroup/Normalization\",\n \"state\" : {\n \"revision\" : \"0d6adaadd3dcf2aa4c65db8edcf1ea94c73d4a10\",\n \"version\" : \"2.0.0\"\n }\n },\n {\n \"identity\" : \"rxswift\",\n \"kind\" : \"remoteSourceControl\",\n \"location\" : \"https://github.com/ReactiveX/RxSwift.git\",\n \"state\" : {\n \"revision\" : \"5949cbd3d4f3f97968bb40b6cd232f8315c6341c\",\n \"version\" : \"6.7.0\"\n }\n },\n {\n \"identity\" : \"swift-atomics\",\n \"kind\" : \"remoteSourceControl\",\n \"location\" : \"https://github.com/apple/swift-atomics.git\",\n \"state\" : {\n \"revision\" : \"cd142fd2f64be2100422d658e7411e39489da985\",\n \"version\" : \"1.2.0\"\n }\n },\n {\n \"identity\" : \"swift-collections\",\n \"kind\" : \"remoteSourceControl\",\n \"location\" : \"https://github.com/apple/swift-collections\",\n \"state\" : {\n \"revision\" : \"94cf62b3ba8d4bed62680a282d4c25f9c63c2efb\",\n \"version\" : \"1.1.0\"\n }\n },\n {\n \"identity\" : \"swift-concurrency-task-manager\",\n \"kind\" : \"remoteSourceControl\",\n \"location\" : \"https://github.com/VergeGroup/swift-concurrency-task-manager\",\n \"state\" : {\n \"revision\" : \"87605b623fa1a02c657534251ae238a56bc0d15c\",\n \"version\" : \"3.0.0\"\n }\n },\n {\n \"identity\" : \"swift-custom-dump\",\n \"kind\" : \"remoteSourceControl\",\n \"location\" : \"https://github.com/pointfreeco/swift-custom-dump\",\n \"state\" : {\n \"revision\" : \"82645ec760917961cfa08c9c0c7104a57a0fa4b1\",\n \"version\" : \"1.3.3\"\n }\n },\n {\n \"identity\" : \"swift-macro-state-struct\",\n \"kind\" : \"remoteSourceControl\",\n \"location\" : \"https://github.com/VergeGroup/swift-macro-state-struct\",\n \"state\" : {\n \"revision\" : \"aabd53cd8be48f71bb33e5fe66e38accc0438660\",\n \"version\" : \"3.0.0\"\n }\n },\n {\n \"identity\" : \"swift-macro-testing\",\n \"kind\" : \"remoteSourceControl\",\n \"location\" : \"https://github.com/pointfreeco/swift-macro-testing.git\",\n \"state\" : {\n \"revision\" : \"9ab11325daa51c7c5c10fcf16c92bac906717c7e\",\n \"version\" : \"0.6.4\"\n }\n },\n {\n \"identity\" : \"swift-snapshot-testing\",\n \"kind\" : \"remoteSourceControl\",\n \"location\" : \"https://github.com/pointfreeco/swift-snapshot-testing\",\n \"state\" : {\n \"revision\" : \"a8b7c5e0ed33d8ab8887d1654d9b59f2cbad529b\",\n \"version\" : \"1.18.7\"\n }\n },\n {\n \"identity\" : \"swift-syntax\",\n \"kind\" : \"remoteSourceControl\",\n \"location\" : \"https://github.com/swiftlang/swift-syntax.git\",\n \"state\" : {\n \"revision\" : \"4799286537280063c85a32f09884cfbca301b1a1\",\n \"version\" : \"602.0.0\"\n }\n },\n {\n \"identity\" : \"swift-typed-identifier\",\n \"kind\" : \"remoteSourceControl\",\n \"location\" : \"https://github.com/VergeGroup/swift-typed-identifier\",\n \"state\" : {\n \"revision\" : \"ea7afa2ce943c6bf3ef87d385c8a6e9f67fea4f3\",\n \"version\" : \"2.0.4\"\n }\n },\n {\n \"identity\" : \"typedcomparator\",\n \"kind\" : \"remoteSourceControl\",\n \"location\" : \"https://github.com/VergeGroup/TypedComparator\",\n \"state\" : {\n \"revision\" : \"337ce0e573e7637ddd29392cb88c3b852f042c8e\",\n \"version\" : \"1.0.0\"\n }\n },\n {\n \"identity\" : \"viewinspector\",\n \"kind\" : \"remoteSourceControl\",\n \"location\" : \"https://github.com/nalexn/ViewInspector.git\",\n \"state\" : {\n \"revision\" : \"5acfa0a3c095ac9ad050abe51c60d1831e8321da\",\n \"version\" : \"0.10.0\"\n }\n },\n {\n \"identity\" : \"xctest-dynamic-overlay\",\n \"kind\" : \"remoteSourceControl\",\n \"location\" : \"https://github.com/pointfreeco/xctest-dynamic-overlay\",\n \"state\" : {\n \"revision\" : \"b2ed9eabefe56202ee4939dd9fc46b6241c88317\",\n \"version\" : \"1.6.1\"\n }\n }\n ],\n \"version\" : 3\n}\n" }, { "path": "Package.swift", "content": "// swift-tools-version: 6.0\nimport CompilerPluginSupport\nimport PackageDescription\n\nlet package = Package(\n name: \"Verge\",\n platforms: [\n .macOS(.v13),\n .iOS(.v16),\n .tvOS(.v13),\n .watchOS(.v6),\n ],\n products: [\n .library(name: \"Verge\", targets: [\"Verge\"]),\n .library(name: \"VergeTiny\", targets: [\"VergeTiny\"]),\n .library(name: \"VergeNormalizationDerived\", targets: [\"VergeNormalizationDerived\"]),\n .library(name: \"VergeRx\", targets: [\"VergeRx\"]),\n .library(name: \"VergeClassic\", targets: [\"VergeClassic\"]),\n .library(name: \"VergeMacros\", targets: [\"VergeMacros\"]),\n ],\n dependencies: [\n .package(url: \"https://github.com/ReactiveX/RxSwift.git\", from: \"6.0.0\"),\n .package(url: \"https://github.com/apple/swift-atomics.git\", from: \"1.0.2\"),\n .package(url: \"https://github.com/apple/swift-collections\", from: \"1.1.0\"),\n .package(url: \"https://github.com/VergeGroup/swift-concurrency-task-manager\", from: \"3.0.0\"),\n .package(url: \"https://github.com/VergeGroup/TypedComparator\", from: \"1.0.0\"),\n .package(url: \"https://github.com/VergeGroup/Normalization\", from: \"2.0.0\"),\n .package(url: \"https://github.com/VergeGroup/swift-macro-state-struct\", from: \"3.0.0\"),\n\n /// for testing\n .package(url: \"https://github.com/nalexn/ViewInspector.git\", from: \"0.10.0\"),\n .package(url: \"https://github.com/swiftlang/swift-syntax.git\", \"600.0.0\"..<\"603.0.0\"),\n .package(url: \"https://github.com/pointfreeco/swift-macro-testing.git\", from: \"0.2.1\")\n ],\n targets: [\n\n // compiler plugin\n .macro(\n name: \"VergeMacrosPlugin\",\n dependencies: [\n .product(name: \"SwiftSyntaxMacros\", package: \"swift-syntax\"),\n .product(name: \"SwiftCompilerPlugin\", package: \"swift-syntax\"),\n ]\n ),\n\n // macro exports\n .target(name: \"VergeMacros\", dependencies: [\"VergeMacrosPlugin\"]),\n\n .target(name: \"VergeTiny\", dependencies: []),\n .target(\n name: \"Verge\",\n dependencies: [\n \"VergeMacros\",\n .product(name: \"StateStruct\", package: \"swift-macro-state-struct\"),\n .product(name: \"TypedComparator\", package: \"TypedComparator\"),\n .product(name: \"Atomics\", package: \"swift-atomics\"),\n .product(name: \"DequeModule\", package: \"swift-collections\"),\n .product(name: \"ConcurrencyTaskManager\", package: \"swift-concurrency-task-manager\"),\n ]\n ),\n .target(\n name: \"VergeClassic\",\n dependencies: [\n \"VergeRx\"\n ]\n ),\n .target(\n name: \"VergeNormalizationDerived\",\n dependencies: [\n \"Verge\",\n .product(name: \"Normalization\", package: \"Normalization\"),\n .product(name: \"HashTreeCollections\", package: \"swift-collections\"),\n ]\n ),\n .target(\n name: \"VergeRx\",\n dependencies: [\n \"Verge\",\n .product(name: \"RxSwift\", package: \"RxSwift\"),\n .product(name: \"RxCocoa\", package: \"RxSwift\"),\n ]\n ),\n .testTarget(\n name: \"VergeNormalizationDerivedTests\",\n dependencies: [\"VergeNormalizationDerived\"]\n ),\n .testTarget(\n name: \"VergeRxTests\",\n dependencies: [\"VergeRx\", \"VergeClassic\"]\n ),\n .testTarget(\n name: \"VergeTests\",\n dependencies: [\"Verge\", \"ViewInspector\"],\n swiftSettings: [\n .enableExperimentalFeature(\"StrictConcurrency\")\n ]\n ),\n .testTarget(\n name: \"VergeTinyTests\",\n dependencies: [\"VergeTiny\"]\n ),\n .testTarget(\n name: \"VergeMacrosTests\",\n dependencies: [\n \"VergeMacrosPlugin\",\n .product(name: \"SwiftSyntaxMacrosTestSupport\", package: \"swift-syntax\"),\n .product(name: \"MacroTesting\", package: \"swift-macro-testing\"),\n ]),\n ],\n swiftLanguageModes: [.v6]\n)\n" }, { "path": "README.md", "content": "> [!WARNING]\n> Verge is stabilizing and transitioning to [swift-state-graph](https://github.com/VergeGroup/swift-state-graph) as its next-generation foundation.\n> Please check this out\n> https://medium.com/p/8c7423692992\n\n\n\n\n\n

\n \n\"VergeIcon\"\n \n

\n\n

Verge.swift

\n

\n 📍An effective state management architecture for iOS - UIKit, SwiftUI📍
\n_ An easier way to get unidirectional data flow _
\n_ Supports concurrent processing _
\n

\n\n[My development note](https://www.notion.so/muukii/Verge-93813aec77d44bef802a2d92f565c7bb?pvs=4)\n\n## Using StoreReader or @Reading in SwiftUI\n\nIn SwiftUI, there are two ways to observe a Store: using the `StoreReader` view or the `@Reading` property wrapper. Both efficiently track state changes and only re-render the view when tracked values change.\n\nFirst, define your state with `@Tracking` macro:\n\n```swift\n@Tracking\nstruct State {\n var count: Int = 0\n\n @Tracking\n struct NestedState {\n var isActive: Bool = false\n var message: String = \"Hello, Verge!\"\n }\n\n var nestedState: NestedState = NestedState()\n}\n```\n\n### StoreReader Example\n\n```swift\nstruct MyView: View {\n let store = Store(initialState: .init())\n \n var body: some View {\n StoreReader(store) { $state in\n VStack {\n Text(\"Count: \\(state.count)\")\n Button(\"Increment\") {\n store.commit {\n $0.count += 1\n }\n }\n Text(\"Is Active: \\(state.nestedState.isActive)\")\n Text(\"Message: \\(state.nestedState.message)\")\n Button(\"Toggle Active\") {\n store.commit {\n $0.nestedState.isActive.toggle()\n }\n }\n }\n }\n }\n}\n```\n\n### @Reading Example\n\n```swift\nstruct MyView: View {\n @Reading> var state: State\n \n init() {\n self._state = .init(\n label: \"MyView\",\n { Store(initialState: .init()) }\n )\n }\n \n var body: some View {\n VStack {\n Text(\"Count: \\(state.count)\")\n Button(\"Increment\") {\n $state.driver.commit {\n $0.count += 1\n }\n }\n Text(\"Is Active: \\(state.nestedState.isActive)\")\n Text(\"Message: \\(state.nestedState.message)\")\n Button(\"Toggle Active\") {\n $state.driver.commit {\n $0.nestedState.isActive.toggle()\n }\n }\n }\n }\n}\n```\n\n---\n\n- Dependencies\n - [TypedIdentifier](https://github.com/VergeGroup/TypedIdentifier)\n - [TypedComparator](https://github.com/VergeGroup/TypedComparator)\n - [Normalization](https://github.com/VergeGroup/Normalization)\n\n- Docs\n - [Verge](https://swiftpackageindex.com/VergeGroup/swift-Verge/main/documentation/verge)\n - [VergeNormalizationDerived](https://swiftpackageindex.com/VergeGroup/swift-Verge/main/documentation/vergenormalizationderived)\n\n## Support this projects\n\n\"yellow-button\"\n\n\n# Verge: A High-Performance, Scalable State Management Library for SwiftUI and UIKit\n\nVerge is a high-performance, scalable state management library for Swift, designed with real-world use cases in mind. It offers a lightweight and easy-to-use approach to managing your application state without the need for complex actions and reducers. This guide will walk you through the basics of using Verge in your Swift projects.\n\n## Key Concepts and Motivations\n\nVerge was designed with the following concepts in mind:\n\n- Inspired by the Flux library, but with a focus on providing a store-pattern as the core concept.\n- The store-pattern is a primitive concept found in Flux and Redux, focusing on sharing state between components using a single source of truth.\n- Verge does not dictate how to manage actions to modify the state. Instead, it provides a simple `commit` function that accepts a closure describing how to change the state.\n- Users can build additional layers on top of Verge, such as implementing enum-based actions for more structured state management.\n- Verge supports multi-threading, ensuring fast, safe, and efficient operation.\n- Compatible with both UIKit and SwiftUI.\n- Includes APIs for handling real-world application development use cases, such as managing asynchronous operations.\n- Addresses the complexity of updating state in large and complex applications.\n- Provides an ORM for efficient management of a large number of entities.\n- Designed for use in business-focused applications.\n\n## Getting Started\n\nTo use Verge, follow these steps:\n\n1. Define a state struct with `@Tracking` macro\n2. Instantiate a `Store` with your initial state\n3. Update the state using the `commit` method on the store instance\n4. Subscribe to state updates using the `sinkState` method\n\n\n## Defining Your State\n\nCreate a state struct that represents the state of your application. Use the `@Tracking` macro to make your state trackable by Verge. This allows Verge to detect changes in your state and trigger updates as necessary.\n\n```swift\n@Tracking\nstruct MyState {\n var count: Int = 0 \n}\n```\n\n## Instantiating a Store\n\nCreate a `Store` instance with the initial state of your application. The `Store` class takes two type parameters:\n\n- The first type parameter represents the state of your application.\n- The second type parameter represents any activity you want to use with your store. If you don't need any activity, use `Never`.\n\n```swift\nlet store = Store<_, Never>(initialState: MyState())\n```\n\n## Updating the State\n\nTo update your application state, use the `commit` method on your `Store` instance. The `commit` method takes a closure with a single parameter, which is a mutable reference to your state. Inside the closure, modify the state as needed.\n\n```swift\nstore.commit { \n $0.count += 1 \n}\n```\n\n## Subscribing to State Updates\n\nTo receive updates when the state changes, use the `sinkState` method on your `Store` instance. This method takes a closure that receives the updated state as its parameter. The closure will be called whenever the state changes.\n\n```swift\nstore.sinkState { state in\n // Receives updates of the state\n}\n.storeWhileSourceActive()\n```\n\nThe `storeWhileSourceActive()` call at the end is a method provided by Verge to automatically manage the lifetime of the subscription. It retains the subscription as long as the source (in this case, the `store` instance) is alive.\n\n## Using Activity of Store for Event-Driven Programming\n\nIn certain scenarios, event-driven programming is essential for creating responsive and efficient applications. The Verge library's Activity of Store feature is designed to cater to this need, allowing developers to handle events seamlessly within their projects.\n\nThe Activity of Store comes into play when your application requires event-driven programming. It enables you to manage events and associated logic independently from the main store management, promoting a clean and organized code structure. This separation of concerns simplifies the overall development process and makes it easier to maintain and extend your application over time.\n\nBy leveraging the Activity of Store functionality, you can efficiently handle events within your application while keeping the store management intact. This ensures that your application remains performant and scalable, enabling you to build robust and reliable Swift applications using the Verge library.\n\nHere's an example of using Activity of Store:\n\n```swift\nlet store: Store\n\nstore.send(MyActivity.somethingHappened)\n```\n\n```swift\nstore.sinkActivity { (activity: MyActivity) in\n // handle activities.\n}\n.storeWhileSourceActive()\n```\n\n## Using Verge with SwiftUI\n\nTo use Verge in SwiftUI, you can utilize the `StoreReader` to subscribe to state updates within your SwiftUI views. Here's an example of how to do this:\n\n```swift\nimport SwiftUI\nimport Verge\n\nstruct ContentView: View {\n @StoreObject private var viewModel = CounterViewModel()\n\n var body: some View {\n VStack {\n StoreReader(viewModel) { state in\n Text(\"Count: \\(state.count)\")\n .font(.largeTitle)\n }\n\n Button(action: {\n viewModel.increment()\n }) {\n Text(\"Increment\")\n }\n }\n }\n}\n\nfinal class CounterViewModel: StoreComponentType {\n @Tracking\n struct State {\n var count: Int = 0\n }\n\n let store: Store = .init(initialState: .init())\n\n func increment() {\n commit {\n $0.count += 1\n }\n }\n}\n```\n\nIn this example, `StoreReader` is used to read the state from the `MyViewModel` store. This allows you to access and display the state within your SwiftUI view. Additionally, you can perform actions by calling methods on the store directly, as demonstrated with the button in the example.\n\nThis new section will help users understand how to use Verge with SwiftUI, allowing them to manage state effectively within their SwiftUI views. Let me know if you have any further suggestions or changes!\n\n**StoreObject** property wrapper:\n\nSwiftUI provides the `@StateObject` property wrapper to create and manage a persistent instance of a given object that adheres to the ObservableObject protocol. However, StateObject will cause the view to be refreshed whenever the ObservableObject is updated.\n\nIn Verge, we introduce the StoreObject property wrapper, which instantiates a Store object for the duration of the view's lifecycle but does not cause the view to refresh when the Store updates.\n\nThis is beneficial when you want to manage the Store in a more granular way, without causing the entire view to refresh when the Store changes. Instead, Store updates can be handled through the StoreReader.\n\n## Using Verge with UIKit\n\nHere's a simple usage example of Verge with a UIViewController:\n\n```swift\nclass MyViewController: UIViewController {\n \n @Tracking\n private struct State {\n var count: Int = 0\n }\n \n private let store: Store = .init(initialState: .init())\n \n private let label: UILabel = .init()\n \n override func viewDidLoad() {\n super.viewDidLoad()\n \n setupUI()\n \n // Subscribe to the store's state updates\n store.sinkState { [weak self] state in\n guard let self = self else { return }\n \n // Check if the value has been updated using ifChanged\n state.ifChanged(\\.count) { count in\n self.label.text = \"Count: \\(count)\"\n }\n }\n .storeWhileSourceActive()\n }\n \n private func setupUI() {\n // Omitted for brevity\n }\n \n private func incrementCount() {\n store.commit {\n $0.count += 1\n }\n }\n}\n```\n\n## Efficient State Updates in UIKit using `sinkState`, `Changed`, and `ifChanged`\n\nIn UIKit, which is event-driven, it's crucial to update components efficiently by only updating them as needed. The Verge library provides a way to achieve this using the `sinkState` method, the `Changed` type, and the `ifChanged` method.\n\nWhen you use the `sinkState` method, the closure you provide receives the latest state wrapped in a `Changed` type. This wrapper also includes the previous state, allowing you to determine which properties have been updated using the `ifChanged` method.\n\nHere's an example of using `sinkState` and `ifChanged` in UIKit to efficiently update components:\n\n```swift\nstore.sinkState {\n $0.ifChanged(\\.myProperty) { newValue in\n // Update the component only when myProperty has changed\n }\n}\n```\n\nIn this example, the component is updated only when `myProperty` has changed, ensuring efficient updates in the UIKit-based application.\n\nCompared to UIKit, SwiftUI works with a declarative view structure, which means that there is less need to check for state changes to update the view. However, when working with UIKit, using `sinkState`, `Changed`, and `ifChanged` helps maintain a performant and responsive application.\n\n## Using TaskManager for Asynchronous Operations\n\nVerge's Store includes a TaskManager that allows you to dispatch and manage asynchronous operations. This feature simplifies handling async tasks while keeping them associated with your Store.\n\n### Basic usage\n\nTo use TaskManager, simply call the `task` method on your Store instance, and provide a closure that contains the asynchronous operation:\n\n```swift\nstore.task {\n await runMyOperation()\n}\n```\n\n### Task management with keys and modes\n\nTaskManager also enables you to manage tasks based on keys and modes. You can assign a unique key to each task and specify a mode for its execution. This allows you to control the execution behavior of tasks based on their keys.\n\nFor example, you can use the `.dropCurrent` mode to drop any currently running tasks with the same key and run the new task immediately:\n\n```swift\nstore.task(key: .init(\"MyOperation\"), mode: .dropCurrent) {\n //\n}\n```\n\nThis functionality provides you with fine-grained control over how tasks are executed, ensuring that your application remains responsive and efficient, even when handling multiple asynchronous operations.\n\n## Advanced Usage: Managing Multiple Stores for Complex Applications\n\nIn theory, managing your entire application state in a single store is ideal. However, in large and complex applications, the computational complexity can become significant, leading to performance issues and slow application responsiveness. In such cases, it's recommended to separate your state into multiple stores and integrate them as needed.\n\nBy dividing your state into multiple stores, you can reduce the complexity and overhead associated with state updates. Each store can manage a specific part of your application state, ensuring that updates are performed efficiently and quickly. This approach also promotes better organization and separation of concerns in your code, making it easier to maintain and extend your application over time.\n\nTo use multiple stores, create separate Store instances for different parts of your application state, and then connect them as needed. This may involve passing store instances to child components or sharing stores between sibling components. By structuring your application this way, you can ensure that each part of your application state is managed efficiently and effectively.\n\n### Copying State Between Stores\n\nTo copy state between stores, you can use the `sinkState` method along with the `ifChanged` function to only trigger updates when the state has changed. Here's an example:\n\n```swift\nstore.sinkState {\n $0.ifChanged(\\.myState) { value in\n otherStore.commit {\n $0.myState = value\n }\n }\n}\n```\n\nIn this example, when the state of `myState` changes in `store`, the new value is committed to `otherStore`. This approach allows you to synchronize state between multiple stores efficiently.\n\n## Using Derived for Efficient Computed Properties\n\nVerge's `Derived` feature allows you to create computed properties based on your store's state and efficiently subscribe to updates. This feature can help you optimize your application by reducing unnecessary computations and updates. Derived is inspired by the [reselect](https://github.com/reduxjs/reselect) library and provides similar functionality.\n\n### Creating a Derived Property\n\nTo create a derived property, you'll use the `store.derived` method. This method takes a `Pipeline` object that describes how the derived data is generated:\n\n```swift\nlet derived: Derived = store.derived(.select(\\\\.count))\n```\n\nYou can use `select` or `map` to generate derived data. `select` is used to take a value directly from the state, while `map` can be used to generate new values based on the state, similar to a map function:\n\n```swift\nlet derived: Derived = store.derived(.map { $0.count * 2 })\n```\n\nThe `Pipeline` checks if the derived data has been updated from the previous value. If it hasn't changed, `Derived` won't publish any changes.\n\n### Chaining Derived Instances\n\nYou can create another Derived instance from an existing Derived instance, effectively chaining them together:\n\n```swift\nlet anotherDerived: Derived = derived.derived(.map { $0.description })\n```\n\n### Subscribing to Derived Property Updates\n\nTo subscribe to updates of a derived property, you can use the `sinkState` method, just like with a store:\n\n```swift\nderived.sinkState { value in \n // Handle updates of the derived property \n} \n.storeWhileSourceActive()\n```\n\nBy using `Derived` for computed properties and subscribing to updates, you can ensure that your application remains efficient and performant, avoiding unnecessary computations and state updates.\n\n# Normalization\n\nVergeGroup and Verge package provide a library for normalization techniques to handle entities in an efficient way. \n[Normalization](https://github.com/VergeGroup/Normalization) is a library that makes tables in a struct and manages value-type entities in copy-efficient tables. \nIt can be used in the same way as handling value types. Which means we can use it with Verge bringing them into store-pattern. \n`VergeNormalizationDerived` target provides functionalities for subscribing entity updates when it's using with Verge.\n\n# Installation\n\n## SwiftPM\n\nVerge supports SwiftPM.\n\n## Thanks\n\n- [Redux](https://redux.js.org/)\n- [Vuex](https://vuex.vuejs.org/)\n- [ReSwift](https://github.com/ReSwift/ReSwift)\n- [swift-composable-architecture](https://github.com/pointfreeco/swift-composable-architecture)\n\n## Author\n\n[🇯🇵 Muukii (Hiroshi Kimura)](https://github.com/muukii)\n\n## License\n\nVerge is released under the MIT license.\n" }, { "path": "Sources/Verge/Documentation.docc/Activity.md", "content": "# Activity\n\n## What Activity brings to us\n\nActivity enables Event-driven partially.\n\nVerge supports to send any events that won’t be stored persistently. Even if an application runs with State-Driven, it might have some issues that not easy to something with State-Driven.\n\nFor example, something that would happen with the timer’s trigger. It’s probably not easy to expressing that as a state.\nIn this case, Activity helps that can do easily.\n\nThis means Verge can use Event-Driven from Data-Driven partially.\nWe think it’s not so special concept. SwiftUI supports these use cases as well that using Combine’s Publisher.\n\n```swift\nfunc onReceive

(_ publisher: P, perform action: @escaping (P.Output) -> Void) -> some View where P : Publisher, P.Failure == Never\n```\n\n[Apple’s SwiftUI Ref](https://developer.apple.com/documentation/swiftui/view/3365935-onreceive)\n\n## Add Activity to the Store\n\nIn sample code following this:\n\n```swift\nfinal class MyStore: StoreComponentType {\n\n struct State {\n ...\n }\n\n}\n```\n\nTo enable using Activity, we add new decralation just like this:\n\n```swift\nfinal class MyStore: StoreComponentType {\n\n struct State {\n ...\n }\n\n /// 👇\n enum Activity {\n case didSendMessage\n }\n\n}\n```\n\n## Send an Activity\n\nAnd finally, that Store now can emit an activity that we created.\n\n```swift\nextension MyStore {\n func sendMessage() {\n send(.didSendMessage)\n }\n}\n```\n\n---\n\n## Subscribe the Activity\n\n**Normal**\n\n```swift\nstore.sinkActivity { activity in\n ...\n}\n.store(in: &subscriptions)\n```\n\n**Using Combine**\n\n```swift\nstore\n .activityPublisher\n .sink { event in\n // do something\n }\n .store(in: &subscriptions)\n```\n" }, { "path": "Sources/Verge/Documentation.docc/Changes.md", "content": "# ``Verge/Changes``\n\n`Changes` wraps primitive value inside and previous one.\nThis data structure enables to get differences between now one and previous one.\nIt helps us to prevent duplicated operation with the same value from the state.\n\n![Changes structure](changes)\n\n## How we update UI with the state uniquely in UIKit\n\nIn subscribing the state and binding UI, it’s most important to reduce the meaningless time to update UI.\nWhat things are the meaningless? that is the update UI operations which contains no updates.\nBasically, we can prevent this with like followings:\n\n```swift\nfunc updateUI(newState: State) {\n if self.label.text != newState.name {\n self.label.text = newState.name\n }\n}\n```\n\nAlthough, this approach make the code a little bit complicated by increasing the code that updates UI.\nEspecially, same words come up a lot.\n\n## Changes simplify the code\n\nActually, state property of Store returns `Changes` implicitly.\nFrom the power of `dynamicMemberLookup`, we can use the property of the State with we don’t know that is actually Changes object.\n\nHow to know there is differences is using `ifChanged`.\n\n```swift\nlet store: MyStore\nlet state: Changes = store.state\n\nstate.ifChanged(\\.name) { name in\n // called when `name` changed only\n}\n```\n\n## Patterns of `ifChanged`\n\n`ifChanged` has a bunch of overloads.\nLet’s take a look of patterns.\n\n```swift\nstate.ifChanged(\\.aaa, \\.bbb) { aaa, bbb in\n // Executes every two properties change.\n}\n```\n\n```swift\nstate.ifChanged({ \"Mr.\" + $0.name }) { composedName in\n\n}\n```\n\n```swift\nstate.ifChanged({ \"Mr.\" + $0.name }, { $0 == $1 }) { aaa, bbb in\n\n}\n```\n\n```swift\nstate.ifChanged({ ($0.aaa, $0.bbb, \"Mr\" + $0.name)}, ==) { composedName in\n // Returning tuple that contains composed value enables to do anything with the value you want.\n // It releases us from complicated streaming mixing.\n // Current Swift version does not support tuple conforming with Equatable,\n // You need passing `==` function in the second argument.\n}\n```\n\n## Subscribing the state\n\n```swift\nclass ViewController: UIViewController {\n\n var subscriptions = Set()\n\n let store: MyStore\n\n override func viewDidLoad() {\n\n super.viewDidLoad()\n\n store.sinkChanges { [weak self] (changes) in\n // it will be called on the thread which committed\n self?.update(changes: changes)\n }\n .store(in: &subscriptions)\n }\n\n private func update(changes: Changes {\n changes.ifChanged(\\.name) { name in\n // called only name changed\n }\n ...\n }\n\n}\n```\n\n## Make Changes object the first-time value\n\nIf you have a `Changes` from anywhere, it might have previous value,\nUsing `ifChanged` might return false because compared with the previous one.\nYou can create the Changed object that always returns true from `ifChanged` with followings:\n\n```swift\nlet changes: Changes\n\nlet firstTimeChanges: Changes = changes.droppedPrevious()\n```# <#Title#>\n\n" }, { "path": "Sources/Verge/Documentation.docc/ComputedProperty.md", "content": "# Computed Property\n\n## Overview\n\nA declaration to add a computed-property into the state. It helps to add a property that does not need to be stored-property. It’s like Swift’s computed property like following:\n\n```swift\nstruct State {\n var items: [Item] = [] {\n\n var itemsCount: Int {\n items.count\n }\n}\n```\n\nHowever, this Swift’s computed-property will compute the value every state changed. It might become a serious issue on performance.\n\nCompared with Swift’s computed property and this, this does not compute the value every state changes, It does compute depend on specified rules. That rules mainly come from the concept of Memoization.\n\nExample code:\n\n```swift\nstruct State: ExtendedStateType {\n\n var name: String = ...\n var items: [Int] = []\n\n struct Extended: ExtendedType {\n\n static let instance = Extended()\n\n let filteredArray = Field.Computed<[Int]> {\n $0.items.filter { $0 > 300 }\n }\n .dropsInput {\n $0.noChanges(\\.items)\n }\n }\n}\n```\n\n```swift\nlet store: MyStore = ...\n\nlet state = store.state\n\nlet result: [Int] = state.computed.filteredArray\n```\n\n## Instructions\n\n### Computed Property on State\n\nStates may have a property that actually does not need to be stored property. In that case, we can use computed property.\n\nAlthough, we should take care of the cost of the computing to return value in that. What is that case? Followings explains that.\n\n

\n\nFor example, there is itemsCount.\n\n```swift\nstruct State {\n var items: [Item] = []\n\n var itemsCount: Int = 0\n}\n```\n\nIn order to become itemsCount dynamic value, it needs to be updated with updating items like this.\n\n```swift\nstruct State {\n var items: [Item] = [] {\n didSet {\n itemsCount = items.count\n }\n }\n\n var itemsCount: Int = 0\n}\n```\n\nWe got it, but we don’t think it’s pretty simple. Actually we can do this like this.\n\n```swift\nstruct State {\n var items: [Item] = [] {\n\n var itemsCount: Int {\n items.count\n }\n}\n```\n\nWith this, it did get to be more simple.\n\n```swift\nstruct State {\n var items: [Item] = []\n\n var processedItems: [ProcessedItem] {\n items.map { $0.doSomeExpensiveProcessing() }\n }\n}\n```\n\nAs an example, Item can be processed with the something operation that takes expensive cost. We can replace this example with filter function.\n\nThis code looks is very simple and it has got data from source of truth. Every time we can get correct data. However we can look this takes a lot of the computing resources. In this case, it would be better to use didSet and update data.\n\n```swift\nstruct State {\n var items: [Item] = [] {\n didSet {\n processedItems = items.map { $0.doSomeExpensiveProcessing() }\n }\n }\n\n var processedItems: [ProcessedItem] = []\n}\n```\n\nHowever, as we said, this approach is not simple. And this can not handle easily a case that combining from multiple stored property. Next introduces one of the solutions.\n\n## Extended Computed Properties\n\nVergeStore has a way of providing computed property with caching to reduce taking computing resource.\n\nKeywords are:\n\n- `ExtendedStateType`\n- `ExtendedType`\n- `Field.Computed`\n\nAbove State code can be improved like following.\n\n```swift\nstruct State: ExtendedStateType {\n\n var name: String = ...\n var items: [Int] = []\n\n struct Extended: ExtendedType {\n\n static let instance = Extended()\n\n let filteredArray = Field.Computed<[Int]> {\n $0.items.filter { $0 > 300 }\n }\n .dropsInput {\n $0.noChanges(\\.items)\n }\n }\n}\n```\n\nTo access that computed property, we can do the followings:\n\n```swift\nlet store: MyStore = ...\n\nlet state = store.state\n\nlet result: [Int] = state.computed.filteredArray\n```\n\n`store.computed.filteredArray` will be updated only when items updated. Since the results are stored as a cache, we can take value without computing.\n\nFollowings are the steps describes when it computes while paying the cost.\n\n```swift\nlet store: MyStore = ...\n\n// It computes\nstore.state.computed.filteredArray\n\n// no computes because results cached with first-time access\nstore.state.computed.filteredArray\n\n// State will change but no affects items\nstore.commit {\n $0.name = \"Muukii\"\n}\n\n// no computes because results cached with first-time access\nstore.state.computed.filteredArray\n\n// State will change with it affects items\nstore.commit {\n $0.items.append(...)\n}\n\n// It computes new value\nstore.state.computed.filteredArray\n```# <#Title#>\n\n" }, { "path": "Sources/Verge/Documentation.docc/Derived.md", "content": "# ``Verge/Derived``\n\nDerived’s functions are:\n\n- Computes the derived data from the state tree\n- Emit the updated data with updating Store\n- Supports subscribe the data\n- Supports Memoization\n- Compatible with SwiftUI’s observableObject and `StateReader`\n\n## Overview\n\n### Create a Derived object from the Store\n\n**Select a tree from the state**\n\n```swift\nlet derived: Derived = store.derived(.map(\\.count))\n```\n\n```swift\n// we can write also this.\n// However, we recommend do above way as possible\n// because it enables cache.\nlet derived: Derived = store.derived(.map { $0.count })\n```\n\n**Technically, above method callings are produced from below declaration.**\n\n```swift\nextension StoreType {\n\n public func derived(\n _ memoizeMap: MemoizeMap, NewState>, \n dropsOutput: ((Changes) -> Bool)? = nil,\n queue: TargetQueue? = nil\n ) -> Derived\n\n}\n```\n\n`MemoizeMap` manages to transform value from the state and keep performance that way of drops transform operations if the input value no changes.\n\n**Compute a value from the state**\n\nDerived can create any type of value what we need. MemoizeMap\n\n```swift\nlet derived = store.derived(\n .map(derive: { ($0.name, $0.age) },\n dropsDerived: ==\n) { args in\n\n let (name, age) = args\n ...\n return ...\n\n})\n```\n\n\n\n**Most manually way of creating a Derived object**\n\nWe can create fully tuned up Derived object with using custom initialized `MemoizedMap`. Most of the cases, we don’t need to do this. Because several overloaded methods enable optimizations automatically that depending on doing things. Verge shows current optimization status from the Complexity column of Xcode documentation.\n\n![https://user-images.githubusercontent.com/1888355/83332811-41df2480-a2d8-11ea-8da0-d86c127fc926.png](https://user-images.githubusercontent.com/1888355/83332811-41df2480-a2d8-11ea-8da0-d86c127fc926.png)\n\n## Take a value\n\nDerived is an object (reference type). It provides a latest value from a store. This supports getting the value ad-hoc or subscribing the value updating.\n\nDerived allows us to take the latest value at the time.\n\n```\nlet value: Changes = derived.value\n```\n\n## Subscribe the latest value Derived provides\n\nDerived allows us to subscribe to the updated value.\n\n```swift\nlet cancellable = derived.sinkValue { (changes: Changes) in\n}\n```\n\nPlease, carefully handle a cancellable object.\nA concealable object that returns that subscribe method is similar to AnyCancellable of Combine.framework.\nWe need to retain that until we don’t need to get the update event.\n\n## Supports other Reactive Frameworks\n\nWe might need to use some Reactive framework to integrate other sequence. Derived allows us to make to a sequence from itself. Currently, it supports Combine.framework and RxSwift.framework.\n\n### + Combine\n\n```swift\nderived\n .valuePublisher()\n .sink { (changes: Changes) in\n\n }\n```\n\n### + RxSwift\n\n💡You need to install VergeRx module to use this.\n\n```swift\nderived.rx\n .changesObservable()\n .subscribe(onNext: { (changes: Changes) in\n\n })\n```\n\n## Memoization to keep good performance\n\nMostly Derived is used for projecting the specified shape from the source object. And some cases may contain an expensive operation. In that case, we can consider to tune Memoization up. We can see the detail of Memoization from below link.\n\n[Wiki - Memoization](https://en.wikipedia.org/wiki/Memoization)\n\n## Skips the map operation if the source state has no changes\n\nIn create Derived method, we can get the detail that how we suppress the no need updating and updated event.\n\n```swift\nextension StoreType {\n\n public func derived(\n _ memoizeMap: MemoizeMap, NewState>,\n dropsOutput: @escaping (Changes) -> Bool = { _ in false }\n ) -> Derived\n\n}\n```\n" }, { "path": "Sources/Verge/Documentation.docc/Dispatcher.md", "content": "# ``Verge/DispatcherType``\n\nDispatcher allows us to update the state of the Store from away the store and to manage dependencies to create Mutation.\n\n- Dispatcher is\n - it is an object.\n - it does not have its own state.\n - it can run commit with specified store’s state.\n - it can have a temporary dependency to commit the mutation.\n - it can focus on specified tree of the state.\n\nHere is an example store, in this section we create a dispatcher to commit the mutation into this Store:\n\n```swift\nstruct State: StateType {\n var count: Int = 0\n}\n\nenum Activity {\n case happen\n}\n\nfinal class MyStore: Store {\n ...\n}\n```\n\nMyStore has a typealias to define a dispatcher:\n\n```swift\nMyStore.Dispatcher\n```\n\n\n\n## Define a dispatcher\n\nLet’s take a look how we create a dispatcher with using the typealias:\n\n```swift\nfinal class MyDispatcher: MyStore.Dispatcher {\n\n}\n```\n\nNow we can create an instance of `MyDispatcher`:\n\n```swift\nlet store = MyStore()\nlet dispatcher = MyDispatcher(targetStore: store)\n```\n\n## Add an action to the dispatcher\n\nNext, we add an action that commits a mutation:\n\n```swift\nfinal class MyDispatcher: MyStore.Dispatcher {\n func doSomething() {\n commit {\n $0.count = 100\n }\n }\n}\n```\n\n```swift\nlet store: MyStore\nlet dispatcher: MyDispatcher\n\ndispatcher.doSomething()\n\nstore.state.count == 100 // true\n```\n\n## Add a dependency to dispatch an action\n\nIn the case of large applications, we need to handle many dependencies to run the application.\nFor example, if we use multiple HTTP clients.\n\n```swift\nfinal class MyDispatcher: MyStore.Dispatcher {\n\n let apiClient: APIClient\n\n init(apiClient: APIClient, targetStore: Store) {\n self.apiClient = apiClient\n super.init(targetStore: targetStore)\n }\n\n // an example of fetching data and commit\n func fetchData() {\n apiClient.fetchData { [weak self] result in\n switch result {\n case .success(let data):\n let items = data.encode(...)\n self?.commit {\n $0.fetchedItems = items\n }\n case .failure(let error):\n // handles error\n }\n }\n }\n}\n```\n\nTo use this:\n\n```swift\nlet store = MyStore()\nlet apiClient = APIClient()\nlet dispatcher = MyDispatcher(apiClient: apiClient, target: store)\n\ndispatcher.fetchData()\n```\n\nNow we can handle multiple kinds of dependencies each it fits itself life-time.\nFor example, if you have a restriction that some dependencies can be created only the user’s logging-in, you can create a dispatcher what is for.\n\nNext section explains the detail.\n\n## Create multiple Dispatcher\n\n![https://user-images.githubusercontent.com/1888355/82821486-28586a00-9edf-11ea-8c98-062eafcc4f16.png](https://user-images.githubusercontent.com/1888355/82821486-28586a00-9edf-11ea-8c98-062eafcc4f16.png)\n\nCreating a dispatcher does not have the restriction of the number of instances or types.\nThis means that it allows us to define a dispatcher and instantiate an instance of the dispatcher to fill the use-case.\n\nFor example, In case the timing of getting dependencies that to be needed by run Action or Mutation is different, it’s not easy to have them in the one dispatcher with type-safety. they must be optional types.\n\nUsing creating multiple dispatchers techniques solves this case by defines the dispatcher each the timing of getting dependencies.\n\n```swift\nclass LoggedInDispatcher: MyStore.Dispatcher {\n\n let apiClientNeedsAuthToken: APIClient = ...\n ...\n}\n\nclass LoggedOutDispatcher: MyStore.Dispatcher {\n\n let apiClientWithoutAuthToken: APIClient = ...\n ...\n}\n```\n\n```swift\nlet store = MyStore()\nlet loggedInDispatcher = LoggedInDispatcher(...)\nlet loggedOutDispatcher = LoggedOutDispatcher(...)\n```\n\nThe application will create `LoggedInDispatcher` when the user is logged-in and deinitialize `LoggedOutDispatcher`.\n\n## Create scoped dispatcher\n\nAs another feature what Dispatcher provides, It supports to commit specified scope of the state which helps to mutate with focus on a part of the large state tree.\n\nHere is a sample state that assuming a large app.\n\n- AppState (MyStore)\n - db: Database\n - loggedIn: LoggedInState\n - myInfo: MyInfoState\n - loggedOut: LoggedOutState\n\nWe have `database`, `logged-in` and `logged-out state`. `database` means normalized state shape to manage many entities.\n\nIn previous section, that explained we can multiple dispatchers each the user’s state.\nHowever, it needs to the full path to mutate where we need to mutate.\n\n```swift\nclass LoggedInDispatcher: MyStore.Dispatcher {\n\n func performA() {\n commit {\n $0.loggedIn.xxx\n }\n }\n\n func performB() {\n commit {\n $0.loggedIn.xxx\n }\n }\n\n func performC() {\n commit {\n $0.loggedIn.xxx\n }\n }\n}\n```\n\nLoggedInDispatcher will often dispatch some action for logged-in-state.\nBut it calls everytime `$0.loggedIn`, it seems a little bit verbosity.\n\nThat will be solved by `ScopedDispatcher`. It will move on target tree of the state when it dispatch the action.\n\nThe following code shows how we could create a `ScopedDispatcher`:\n\n```swift\nfinal class LoggedInService: MyStore.ScopedDispatcher {\n\n init(store: Store) {\n super.init(targetStore: store, scope: \\.loggedIn)\n }\n\n func someOperation() {\n commit { (state: LoggedInState) in\n ...\n }\n }\n}\n```\n\nIn LoggedInService, commit mutates `LoggedInState` directly. Like this, we can create a dispatcher each use-cases.\n\n### Detaching to other tree\n\nJust in case, `ScopedDispatcher` supports also mutating on other state tree.\n\n**Moving on more deeper**\n\n```swift\nfinal class LoggedInService: MyStore.ScopedDispatcher {\n\n func detachingOperation() {\n let myInfo = detached(by: \\.myInfo)\n myInfo.commit { (state: MyInfo) in\n\n }\n }\n}\n```\n\n**Detaches from root**\n\n```swift\nfinal class LoggedInService: MyStore.ScopedDispatcher {\n\n func detachingOperation() {\n let db = detached(from: \\.db)\n db.commit { (state: Database) in\n\n }\n }\n}\n```\n" }, { "path": "Sources/Verge/Documentation.docc/Essentials/Motivation.md", "content": "# Motivation\n\n## Verge focuses use-cases in the real-world\n\nRecently, we could say the unidirectional data flow is a popular architecture such as flux.\n\n## Does flux architecture have a good performance?\n\nIt depends. The performance will be the worst depends on how it is used.\n\nHowever, most of the cases, we don't know the app we're creating how it will grow and scales.While the application is scaling up, the performance might decrease by getting complexity.To keep performance, we need to tune it up with several approaches.Considering the performance takes time from the beginning.it will make us be annoying to use flux architecture.\n\n## Verge is designed for use from small and supports to scale.\n\nSetting Verge up quickly, and tune-up when we need it.\n\nVerge automatically tune-up and shows us what makes performance badly while development from Xcode's documentation.\n\nFor example, Verge provides these stuff to tune performance up.\n\n- Derived (Similar to [facebookexperimental/Recoil](https://github.com/facebookexperimental/Recoil)'s Selector)\n- ORM\n\n## Supports volatile events - Activity\n\nWe use an event as `Activity` that won't be stored in the state.This concept would help us to describe something that is not easy to describe as a state in the client application.\n" }, { "path": "Sources/Verge/Documentation.docc/Guides/Advanced Usage.md", "content": "# Advanced Usage\n\n## To keep performance and scalability\n\n## Adding a cachable computed property in a State\n\nWe can add a computed property in a state to get a derived value with stored property,\nand that computed property works fine as well other stored property.\n\n```swift\nstruct MyState {\n var items: [Item] = [] {\n\n var itemsCount: Int {\n items.count\n }\n}\n```\n\nHowever, this patterns might cause an expensive cost of operation depends on how they computes.\nTo solve it, Verge arrows us to define the computed property with another approach.\n\n```swift\nstruct MyState: ExtendedStateType {\n\n var name: String = ...\n var items: [Int] = []\n\n struct Extended: ExtendedType {\n let filteredArray = Field.Computed<[Int]> {\n $0.items.filter { $0 > 300 }\n }\n .ifChanged(selector: \\.largeArray)\n }\n}\n```\n\n```swift\nlet store: MyStore\n\nstore.changes.computed.filteredArray\n```\n\nThis defined computed array calculates only if changed specified value.\nThat condition to re-calculate is defined with `.ifChanged` method in the example code.\n\nAnd finally, it caches the result by first-time access and it returns cached value until if the source value changed.\n\n## Making a slice of the state (Selector)\n\nWe can create a slice object that derives a data from the state.\n\n```swift\nlet derived: Derived = store.derived(.map(\\.count))\n\n// take a value\nderived.value\n\n// subscribe a value changes\nderived.sinkChanges { (changes: Changes) in\n}\n```\n\n## Creating a Dispatcher\n\nStore arrows us to define an action in itself, that might cause gain complexity in supporting a large application.\nTo solve this, Verge offers us to create an object that dispatches an action to the store.\nWe can separate the code of actions to keep maintainability.\nthat also help us to manage a different type of dependencies.\n\nFor example, the case of those dependencies different between logged-in and logged-out.\n\n```swift\nclass MyDispatcher: MyStore.Dispatcher {\n func moreOperation() {\n commit {\n ...\n }\n }\n}\n```\n\n```swift\nlet store: MyStore\nlet dispatcher = MyDispatcher(target: store)\n\ndispatcher.moreOperation()\n```\n" }, { "path": "Sources/Verge/Documentation.docc/Guides/Basic Usage.md", "content": "# Basic Usage\n\nThis section shows you how we start to use Verge.\nIt’s very basic usage. You need to read Advanced Usage section if you’re considering to use in production.\n\nTo understand smoothly about Verge, we need to figure the following domains out.\n\n## Domains\n\n### Store\n\n- A storage object to manage a state and emit activities by the action.\n- Store can dispatch actions to itself.\n\n### State\n\n- A type of state-tree that describes the data our feature needs.\n\n### Activity (Optional)\n\n- A type that describes an activity that happens during performs the action.\n- This instance won’t be stored in anywhere. It would help us to perform something by event-driven.\n- Consider to use this depends on that if can be represented as a state.\n- For example, to present alert or notifcitaions by the action.\n\n### Action\n\n- Action runs any operations (sync / async) and commits any mutations to the state of the store.\n- Action is described by Swift’s method in Store or Dispatcher.\n\n### Dispatcher (Optional)\n\n- A type to dispatch an action to specific store.\n- For a large application, to separate the logics each domain.\n\n## Setup a Store\n\n### Define a state\n\n```swift\nstruct MyState {\n var count = 0\n}\n```\n\n### Define an activity\n\n```swift\nenum MyActivity {\n case countWasIncremented\n}\n```\n\n`Activity` is not required type.\nIf you don’t need to use `Activity`, you can set`Never` in Store’s type parameter.\n\n### Define a store\n\n```swift\nclass MyStore: Store {\n\n init(dependency: Dependency) {\n super.init(initialState: .init(), logger: nil)\n }\n\n}\n```\n\nIn example, it created a subclass of `Store`. Of course, we can also create an instance from `Store` without subclassing.\nBut we can put some dependencies (e.g. API client) with creating a sub-class of `Store`.\n\n\n\n## Add an action\n\nNext, add an action to mutate the state. Essentially, Verge uses Swift’s method to describe an action against enum or struct based action descriptor other Flux library has. This approach has advantages that adding an action faster and call it naturally and dispatches with a faster way by Swift’s native method dispatching system.\n\n- **Better Performance**\n - Swift can perform this action with Swift’s method dispatching instead switch-case computing.\n- **Returns anything we need**\n - the action can return anything from that action (e.g. state or result)\n - If that action dispatch async operation, it can return `Future` object. (such as Vuex action)\n\nAs a future direction, Verge might get a dispatching action system with describing with enum or struct based to run action.\nHowever, the current approach would be the base system for it.\n\nWe’re currently researching that needs.\n\n```swift\nclass MyStore: Store {\n\tfunc incrementCount() { \n commit { \n $0.count += 1 \n } \n}\n```\n\nYes, this point is most different with Redux. we could say it close to Vuex. Store knows what the application’s needs.\n\nTo mutate the state, we use `commit` method.\nthe argument inside commit’s closure is `inout State`, you can modify it anything but you can’t put the asynchronous operations.\nIf you need to do this, call `commit` from the asynchronous operation. like this:\n\n```swift\nfunc incrementCount() {\n DispatchQueue.main.async {\n commit {\n $0.count += 1\n }\n }\n}\n```\n\n\n\n### Run the action\n\nFor example, call that action.\n\n```swift\nlet store = MyStore(...)\nstore.incrementCount()\n```\n\n## Send an activity from the action\n\n```swift\nfunc incrementCount() {\n ...\n send(.countWasIncremented)\n}\n```\n\n## Binding the state with UI\n\n### Use the store in SwiftUI\n\nTo bind the state with `View`, it uses `StateReader`.\nSince `Store` is also compatible with `ObservableObject`, we can declare `@ObservedObject` or `@EnviromentObject`.\n\n`StateReader` provides several options to reduce no changes updates.\nPlease check it out from Xcode.\n\n```swift\nstruct MyView: View {\n\n let store: MyStore\n\n var body: some View {\n StateReader(store).content { state in\n Text(state.name)\n }\n .onReceive(session.store.activityPublisher) { (activity) in\n ...\n }\n }\n}\n```\n\n### Use the store in UIKit\n\nIn UIKit, UIKit doesn’t work with differentiating.\nTo keep better performance, we need to set a value if it’s changed.\n\nVerge publishes an object that contains previous state and latest state, `Changes` object would be so helpful to check if a value changed.\n\n```swift\nclass ViewController: UIViewController {\n\n let store: MyStore\n\n var cancellable: VergeAnyCancellable?\n\n init(store: MyStore) {\n ...\n\n self.cancellable = store.sinkState { [weak self] state in\n self?.update(state: state)\n }\n\n }\n\n private func update(state: Changes) {\n\n state.ifChanged(\\.name) { (name) in\n nameLabel.text = name\n }\n\n state.ifChanged(\\.age) { (age) in\n ageLabel.text = age.description\n }\n\n }\n}\n```\n" }, { "path": "Sources/Verge/Documentation.docc/Guides/Migration Guide v9.md", "content": "# Changes in v9\n\n## Store requires Equatable State\n\nFrom v8 complex implementations, v9 becomes it requires Equatable to State associated with Store, Changes, Derived and what else related.\n\nThen Verge v9 now dropped lots of implementations and overloads covering cases if the state don’t have Equatable.\n\n## Store can have multiple databases\n\nNow, Store has `databases` accessor that allows us to read database.\n`databases` is `DatabaseDynamicMembers` which provides property following to State shape.\nThis looks up member only type of `DatabaseType`\n\n```swift\n@dynamicMemberLookup\npublic struct DatabaseDynamicMembers {\n \n unowned let store: Store\n \n init(store: Store) {\n self.store = store\n }\n\n public subscript(dynamicMember keyPath: KeyPath) -> DatabaseContext {\n .init(keyPath: keyPath, store: store)\n }\n \n}\n```\n\n## Use new syntax for creating Field.Computed\n\nAs you know, Changes supports memoized-computed-property.\nThat can be done writing `Field.Computed`\n\nNow its writing syntax will change.\n\n```swift\nlet filteredArray = Field.Computed(\n .map(\n using: { $0.largeArray },\n transform: { $0.filter { $0 > 300 } }\n )\n)\n```\n\n`using` specifies the dependencies which used from `transform` function.\n`transform` function will create a new value from given dependencies provided from `using` function.\n\n## Detail changes\n\n- Dropped complex implementations related to performance tunings\n- Stopped using cache to return Derived internally.\n- Deleted `batchCommit`\n\nFrom v8 complex implementations, v9 becomes it requires Equatable to State associated with Store, Changes, Derived and what else related.\n\nThen Verge v9 now dropped lots of implementations and overloads covering cases if the state don’t have Equatable.\n" }, { "path": "Sources/Verge/Documentation.docc/Mutation.md", "content": "# Mutation\n\n## What Mutation is\n\nThe only way to actually change state in a Store is by committing a mutation. Define a function that returns Mutation object. That expresses that function is Mutation\n\n\n\nMutation does **NOT** allow to run asynchronous operation.\n\n### Define mutations in the Store\n\n```swift\nstruct MyState {\n var todos: [TODO] = []\n}\n\nclass MyStore: Store {\n\n func addNewTodo(title: String) {\n commit { (state: inout InoutRef) in\n state.todos.append(Todo(title: title, hasCompleted: false))\n }\n }\n\n}\n```\n\n\n\n### Run Mutation\n\n```swift\nlet store = MyStore()\nstore.addNewTodo(title: \"Create SwiftUI App\")\n\nprint(store.state.todos)\n// store.state.todos => [Todo(title: \"Create SwiftUI App\", hasCompleted: false)]\n```\n\n## Batches multiple commtis\n\nCommitting multiple mutations in a short time might decrease performance.\nBecause the subscribers around the store derive a state many times.\n\nLike this,\n\n```swift\nclass MyStore: Store {\n\n func myMutation() {\n if ... {\n commit {\n ...\n }\n // emits updated event\n }\n\n if ... {\n commit {\n ...\n }\n // emits updated event\n }\n\n if ... {\n commit {\n ...\n }\n // emits updated event\n }\n }\n\n}\n```\n\nTo keep better performance, we need to keep using fewer commits in a short time.\n\nWe have 2 ways.\n\n### Using `commit`\n\n``DispatcherType/commit(_:_:_:_:mutation:)`` provides ``InoutRef``, that can detect how the wrapped state will change.\nIf there is no change, `commit` does nothing and no emitting the events from the Store.\n\nHowever, you should attention `commit` is atomically operation which means, the Store getting lock while committing.\n\n```swift\nfunc myMutation() {\n commit { (state: inout InoutRef) in\n if ... {\n state.aaa = ...\n }\n\n if ... {\n state.bbb = ...\n }\n\n if ... {\n state.ccc = ...\n }\n }\n}\n```\n" }, { "path": "Sources/Verge/Documentation.docc/Resources/Tiny.md", "content": "# Yet another super tiny store pattern with Verge/Tiny\n\nIn fact, `store-pattern` doesn't need something library to run.\nThe actually necessary thing is **the changing detection in UIKit.**\n\nWithout the changing detection, the code is here.\nThere is no dependencies.\n\n```swift\nclass MyView: UIView {\n private struct State {\n var count: Int = 0\n }\n \n private var state: State {\n didSet {\n update(with: state)\n }\n }\n\n private func update(with state: State) {\n ...\n }\n}\n```\n\nNext, we focus on `update(with:)` method.\nTry to simulate updating the label's value.\n\n```swift\nprivate func update(with state: State) {\n myLabel.text = \"\\(state.count)\"\n}\n```\n\nAs you can see, you will think you want to prevent updating the value until the value changed.\n\n## Use Verge.Tiny module to prevent the duplicated updating.\n\nWith installing `Verge/Tiny` module, we can write up like followings.\n\n```swift\nprivate func update(with state: State) {\n associatedProperties.doIfChanged(state.count) { count in \n myLabel.text = \"\\(count)\"\n }\n}\n```\n\n`associatedProperties` is a storage of the values that associated with its owner object(NSObject).\n\n`doIfChanged` gets the location of the code that would be a unique key by composition in the storage.\n\nWith this functions, we can get a filter anywhere in the object.\nHowever, this function might affect code readabilities in Swift. \nPlease carefully using this.\n\nWe recommend you gather those operations into one place.\n" }, { "path": "Sources/Verge/Documentation.docc/State.md", "content": "# Thinking in single state tree (Not enforced)\n\nVergeStore uses a **single state-tree. (Recommended)** That means an object contains all of the application’s state. With this, we can get to achieve **“single source of truth”**\n\nThat state is managed by ``Store``. It process updating the state and notify updated events to the subscribers.\n\n> Tip: Store DOES support multiple state-tree as well. Depending on the case, we can create another Store instance.\n\n## Add a computed property\n\n```\nstruct State: Equatable {\n\n var count: Int = 0\n\n var countText: String {\n return count.description\n }\n\n}\n```\n\nExtending properties that computes a value from stored property.\n\nAlthough in some of cases, the cost of computing might be higher which depends on how it create the value from stored properties.\n\nThere is ``ExtendedStateType``.\nThis provies us to get more stuff that **increases performance** and productivity.\n\n## Attention to Normalization\n\n**If you put the data that has relation-ship or complicated structure into state tree, it would be needed normalization to keep performance. Please check VergeORM module**\n\n[About more Normalization and why we need to do this](https://redux.js.org/recipes/structuring-reducers/normalizing-state-shape/)\n" }, { "path": "Sources/Verge/Documentation.docc/Verge.Store.md", "content": "# ``Verge/Store``\n\n- Store:\n - Should be a reference type object,\n - To share the state they manage to multiple subscribers.\n - Receives **Mutation** to update the state with thread-safety\n - Compatible with SwiftUI’s observableObject and we can use `StateReader` to read the state partially.\n\n## Ways to creating a store\n\nVerge provides 2 ways to create a store.\n\n1. Declare a class that conforms with `StoreComponentType` - It’s a protocol that indicates the class wraps a store inside and behaves like a store.\n2. Subclassing from `Store` - a most basic way, but we need to define State and Activity outside\n\nNow, we recommend using No.1 in order to manage the source code with better portability.\n\n## Declare a class that conforms with `StoreComponentType`\n\n```swift\nfinal class MyStore: StoreComponentType {\n\n struct State: StateType {\n var count: Int = 0\n }\n\n /// This means wrapping store inside. (Probably it should be renamed as like `innerStore` or `wrappedStore`)\n /// `DefaultStore` is a typealias that declared by `StoreComponentType`.\n /// You can use any class that inherited from `Store` for your use-cases.\n let store: DefaultStore\n\n init() {\n\n self.store = .init(initialState: .init())\n\n }\n\n}\n```\n\n### Add a Mutation\n\n```swift\nextension MyStore {\n\n func increment() {\n commit {\n $0.count += 0\n }\n }\n\n}\n```\n\n### Commit the mutation\n\n```swift\nlet store = MyStore()\nstore.increment()\n```\n\n## Subclassing from `Store`\n\n```swift\nstruct State: StateType {\n var count: Int = 0\n}\n\nenum Activity {\n case happen\n}\n\nfinal class MyStore: Store {\n\n init() {\n super.init(\n initialState: .init(),\n logger: DefaultStoreLogger.shared\n )\n }\n\n}\n```\n\n### Add a Mutation\n\n```swift\nextension MyStore {\n\n func increment() {\n commit {\n $0.count += 0\n }\n }\n\n}\n```\n\n### Commit the mutation\n\n```swift\nlet store = MyStore()\nstore.increment()\n```\n" }, { "path": "Sources/Verge/Documentation.docc/Verge.md", "content": "# ``Verge``\n\n\n## 🛹 Small start unidirectional data flow\n\nVerge is designed for use from small and supports to scale. Setting Verge up quickly, and tune-up when we need it.\n\n## 🏎 Focus on performance\n\nDoes flux have a good performance?The performance will be the worst depends on how it is used.Verge automatically tune-up and shows us how we could gain a performant.\n\n## ⛱ Available in **UIKit** and **SwiftUI**\n\nVerge supports both of UI framework. Especially, it highly supports to update partially UI on UIKit.\n\n## Verge supports small start and scaling up\n\nVerge is a state management library for iOS (UIKit / SwiftUI).Mostly it's based on Flux architecture.Flux architecture is so beautiful and simplified thinking.Although, we need to do several tuning to bring it into a real product.In fact, Flux needs to consider about computing resources.\n\nVerge contains several ideas to do this from Web technologies such as Redux, Vuex, and Recoil.They have very useful techniques to be successful in real-world productions based on the core-concept of Flux.\n\nVerge can be setting it up quickly, and tune performance up when we need it.Verge automatically tune-up as possible and shows us what makes performance badly while development from Xcode's documentation.\n\n## At a glance\n\nA way to create a ViewModel\n\n```swift\nfinal class MyViewModel: StoreComponentType {\n\n struct State: Equatable {\n var name: String = \"\"\n var count: Int = 0\n }\n\n let store: DefaultStore = .init(initialState: .init())\n\n func myAction() {\n commit {\n $0.name = \"Hello, Verge\"\n }\n }\n\n func increment() {\n commit {\n $0.count += 1\n }\n }\n}\n```\n\nA way to create a customized store\n\n```swift\nstruct MyState: Equatable {\n var name: String = \"\"\n var count: Int = 0\n}\n\nfinal class MyStore: Store {\n\n func myAction() {\n commit {\n $0.name = \"Hello, Verge\"\n }\n }\n\n func increment() {\n commit {\n $0.count += 1\n }\n }\n}\n```\n\n### SwiftUI\n\n```swift\nstruct MyView: View {\n\n let store: MyViewModel\n\n var body: some View {\n StateReader(store) { state in\n Text(state.name)\n Button(action: {\n self.store.myAction()\n }) {\n Text(\"Action\")\n }\n }\n }\n}\n```\n\n### UIKit\n\n```swift\nfinal class MyViewController: UIViewController {\n\n let viewModel: MyViewModel\n\n ...\n\n var cancellable: VergeAnyCancellable?\n\n init(viewModel: MyViewModel) {\n\n self.viewModel = viewModel\n\n self.cancellable = viewModel.sinkState { [weak self] state in\n self?.update(state: state)\n }\n\n }\n\n private func update(state: Changes) {\n\n state.ifChanged(\\.name) { (name) in\n nameLabel.text = name\n }\n\n state.ifChanged(\\.count) { (age) in\n countLabel.text = age.description\n }\n\n ...\n }\n\n}\n```\n\n## Prepare moving to SwiftUI from now with Verge\n\nSwiftUI's concept is similar to the concept of React, Vue, and Elm.Therefore, the concept of state management will become to be similar as well.\n\nThat is Redux or Vuex and more.\n\nNow, almost of iOS Applications are developed on top of UIKit.And We can't say SwiftUI is ready for top production.However, it would change.\n\nIt's better to use the state management that fits SwiftUI from now. It's not only for that, current UIKit based applications can get more productivity as well.\n\n## Questions?\n\nWe accept your questions about usage of Verge and something else in GitHub Issues.\n\n日本語での質問も大丈夫です\n\n\n\n## Topics\n\n### Guides\n\n- \n- \n- \n\n### Extras\n\n- \n\n### Migrations\n\n- \n\n### Essentials\n\n- ``Verge/Store``\n- ``Verge/Changes``\n- ``Verge/Derived``\n- ``Verge/DispatcherType``\n" }, { "path": "Sources/Verge/Library/BackgroundDeallocationQueue.swift", "content": "//\n// Copyright (c) 2020 Hiroshi Kimura(Muukii) \n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\nimport Foundation\nimport DequeModule\n\nactor BackgroundDeallocationQueue {\n\n private var buffer: Deque> = .init()\n\n func releaseObjectInBackground(object: AnyObject) {\n\n let innerCurrentRef = Unmanaged.passRetained(object)\n\n let isFirstEntry = buffer.isEmpty\n buffer.append(innerCurrentRef)\n\n if isFirstEntry {\n Task {\n // accumulate objects to dealloc for batching\n try? await Task.sleep(nanoseconds: 1_000_000)\n await self.drain()\n }\n }\n }\n\n func drain() async {\n\n guard buffer.isEmpty == false else {\n return\n }\n\n while let pointer = buffer.popFirst() {\n pointer.release()\n await Task.yield()\n }\n\n await drain()\n\n }\n}\n" }, { "path": "Sources/Verge/Library/CachedMap.swift", "content": "//\n// Copyright (c) 2020 muukii\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\nimport Foundation\n\n@available(*, deprecated, renamed: \"InstancePool\")\npublic typealias CachedMapStorage = InstancePool\n\n/// A storage object that retains projected instance from source by identified key.\npublic final class InstancePool: @unchecked Sendable {\n\n struct Artifact {\n let source: Source\n var value: Target\n }\n\n private let generateKey: @Sendable (Source) -> AnyHashable\n private let updateCondition: @Sendable (Source, Source) -> Bool\n\n private var innerStorage: [AnyHashable: Artifact] = [:]\n\n private let outerLock = NSLock()\n\n /// Creates an instance\n ///\n /// - Parameters:\n /// - keySelector: A closure that gives key to identify the mapped instance.\n /// - shouldUpdate: A closure that indicates whether cached one replace with new mapped instance.\n public init(\n keySelector: @escaping @Sendable (Source) -> Key,\n shouldUpdate: @escaping @Sendable (_ cached: Source, _ new: Source) -> Bool = { _, _ in false }\n ) {\n self.updateCondition = shouldUpdate\n self.generateKey = {\n AnyHashable(keySelector($0))\n }\n }\n\n public func purgeCache() {\n outerLock.lock()\n defer {\n outerLock.unlock()\n }\n innerStorage = [:]\n }\n\n public func map(\n from collection: C,\n sweepsUnused: Bool,\n makeNew: (C.Element) throws -> Target,\n update: (C.Element, inout Target) -> Void\n ) rethrows -> [Target] where C.Element == Source {\n\n outerLock.lock()\n defer {\n outerLock.unlock()\n }\n\n let keys = collection.map(generateKey)\n\n let result = try zip(collection, keys).map { (element, key) -> Target in\n if let cached = innerStorage[key], !updateCondition(cached.source, element) {\n update(element, &innerStorage[key]!.value)\n return innerStorage[key]!.value\n }\n let newObject = try makeNew(element)\n innerStorage[key] = Artifact(source: element, value: newObject)\n return newObject\n }\n\n if sweepsUnused {\n let unusedKeys = Set(innerStorage.keys).subtracting(keys)\n \n for key in unusedKeys {\n innerStorage.removeValue(forKey: key)\n }\n }\n\n return result\n }\n\n public func compactMap(\n from collection: C,\n sweepsUnused: Bool,\n makeNew: (C.Element) throws -> Target?,\n update: (C.Element, inout Target) -> Void\n )\n rethrows -> [Target] where C.Element == Source\n {\n\n outerLock.lock()\n defer {\n outerLock.unlock()\n }\n\n let keys = collection.map(generateKey)\n\n let result = try zip(collection, keys).compactMap { (element, key) -> Target? in\n if let cached = innerStorage[key], !updateCondition(cached.source, element) {\n update(element, &innerStorage[key]!.value)\n return innerStorage[key]!.value\n }\n guard let newObject = try makeNew(element) else { return nil }\n innerStorage[key] = Artifact(source: element, value: newObject)\n return newObject\n }\n\n if sweepsUnused {\n let unusedKeys = Set(innerStorage.keys).subtracting(keys)\n \n for key in unusedKeys {\n innerStorage.removeValue(forKey: key)\n }\n }\n\n return result\n }\n}\n\nextension Collection {\n\n /**\n Returns an array containing the results of mapping the given closure over the sequence’s elements.\n Especially, it uses a cached instance to return.\n You can set your expectation on how it caches from creating `CachedMapStorage`.\n\n It helps to create a store object or view model from immutable data.\n\n - Author: Verge\n */\n public func cachedMap(\n using pool: InstancePool,\n sweepsUnused: Bool = false,\n makeNew: (Self.Element) throws -> U,\n update: (Self.Element, inout U) -> Void = { _, _ in }\n ) rethrows -> [U] {\n return try pool.map(from: self, sweepsUnused: sweepsUnused, makeNew: makeNew, update: update)\n }\n\n /**\n Returns an array containing the results of mapping the given closure over the sequence’s elements.\n Especially, it uses a cached instance to return.\n You can set your expectation on how it caches from creating `CachedMapStorage`.\n\n It helps to create a store object or view model from immutable data.\n\n - Author: Verge\n */\n public func cachedCompactMap(\n using pool: InstancePool,\n sweepsUnused: Bool = false,\n makeNew: (Self.Element) throws -> U?,\n update: (Self.Element, inout U) -> Void = { _, _ in }\n ) rethrows -> [U] {\n return try pool.compactMap(from: self, sweepsUnused: sweepsUnused, makeNew: makeNew, update: update)\n }\n\n}\n" }, { "path": "Sources/Verge/Library/EventEmitter.swift", "content": "//\n// Copyright (c) 2019 muukii\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\nimport Atomics\nimport Combine\nimport DequeModule\nimport Foundation\nimport os\n\npublic final class EventEmitterCancellable: Hashable, Cancellable, @unchecked Sendable {\n\n public static func == (lhs: EventEmitterCancellable, rhs: EventEmitterCancellable) -> Bool {\n lhs === rhs\n }\n\n private struct State {\n weak var owner: EventEmitterType?\n var wasCancelled: Bool = false\n }\n\n private let state: VergeConcurrency.ManagedCriticalState\n\n fileprivate init(owner: EventEmitterType) {\n self.state = VergeConcurrency.ManagedCriticalState(State(owner: owner))\n }\n\n public func hash(into hasher: inout Hasher) {\n ObjectIdentifier(self).hash(into: &hasher)\n }\n\n public func cancel() {\n \n let continues: EventEmitterType? = state.withCriticalRegion { \n guard $0.wasCancelled == false else {\n return nil\n }\n $0.wasCancelled = true\n return $0.owner\n } \n \n continues?.removeEventHandler(self)\n }\n}\n\nprotocol EventEmitterType: AnyObject, Sendable {\n func removeEventHandler(_ token: EventEmitterCancellable)\n}\n\npublic protocol EventEmitterEventType {\n func onComsume()\n}\n\n/// Instead of Combine\nopen class EventEmitter: EventEmitterType, @unchecked Sendable {\n\n public var publisher: Publisher {\n return .init(eventEmitter: self)\n }\n\n private var subscribers:\n VergeConcurrency.UnfairLockAtomic<[EventEmitterCancellable: (Event) -> Void]> = .init([:])\n\n private let queue: VergeConcurrency.UnfairLockAtomic> = .init(.init())\n\n private let flag = ManagedAtomic.init(false)\n\n private var deinitHandlers: VergeConcurrency.UnfairLockAtomic<[() -> Void]> = .init([])\n\n public init() {\n }\n\n deinit {\n deinitHandlers.value.forEach {\n $0()\n }\n }\n\n @_spi(EventEmitter)\n public func accept(_ event: consuming Event) {\n\n /**\n https://github.com/VergeGroup/Verge/pull/220\n https://github.com/VergeGroup/Verge/issues/221\n https://github.com/VergeGroup/Verge/pull/222\n */\n\n // delivers a given event for subscribers at this point.\n let capturedSubscribers = subscribers.value\n\n queue.modify {\n $0.append(event)\n }\n\n if flag.compareExchange(expected: false, desired: true, ordering: .sequentiallyConsistent)\n .exchanged\n {\n\n while let event: Event = queue.modify({\n if $0.isEmpty == false {\n return $0.removeFirst()\n } else {\n return nil\n }\n }) {\n\n // Emits\n receiveEvent(event)\n\n for subscriber in capturedSubscribers {\n vergeSignpostEvent(\"EventEmitter.emitForSubscriber\")\n subscriber.1(event)\n }\n event.onComsume()\n }\n\n /**\n might contain a bug in here?\n a conjunction of enqueue and dequeue\n */\n\n _ = flag.compareExchange(expected: true, desired: false, ordering: .sequentiallyConsistent)\n } else {\n // enqueue only\n }\n\n }\n\n open func receiveEvent(_ event: consuming Event) {\n\n }\n\n @_spi(EventEmitter)\n @discardableResult\n public func addEventHandler(_ eventReceiver: @escaping (Event) -> Void) -> EventEmitterCancellable\n {\n let token = EventEmitterCancellable(owner: self)\n subscribers.modify {\n $0[token] = eventReceiver\n }\n return token\n }\n\n func removeEventHandler(_ token: EventEmitterCancellable) {\n var itemToRemove: ((Event) -> Void)? = nil\n subscribers.modify {\n itemToRemove = $0[token]\n $0.removeValue(forKey: token)\n }\n\n // To avoid triggering deinit inside removing operation\n // At this point, deallocation will happen, then ``EventEmitterCancellable` runs operations.\n // subscribers is using unfair-lock means it's not recursive lock.\n // if removes the item then deallocated inside locking, onDeinit handler runs then entering this method recursively potentially by some others.\n // then unfair-lock raises runtime error.\n withExtendedLifetime(itemToRemove, {})\n }\n\n public func onDeinit(_ onDeinit: @escaping () -> Void) {\n deinitHandlers.modify {\n $0.append(onDeinit)\n }\n }\n\n}\n\nextension EventEmitter {\n\n @available(iOS 13, macOS 10.15, tvOS 13, watchOS 6, *)\n public struct Publisher: Combine.Publisher {\n\n public typealias Output = Event\n\n public typealias Failure = Never\n\n private weak var eventEmitter: EventEmitter?\n\n public init(eventEmitter: EventEmitter) {\n self.eventEmitter = eventEmitter\n }\n\n public func receive(subscriber: S)\n where S: Subscriber, Failure == S.Failure, Output == S.Input {\n\n let subscription = Subscription(subscriber: subscriber, eventEmitter: eventEmitter)\n subscriber.receive(subscription: subscription)\n }\n\n }\n\n @available(iOS 13, macOS 10.15, tvOS 13, watchOS 6, *)\n public struct Subscription: Combine.Subscription where S.Input == Event {\n\n public let combineIdentifier: CombineIdentifier = .init()\n\n private let subscriber: S\n private let eventEmitterSubscription: EventEmitterCancellable?\n private weak var eventEmitter: EventEmitter?\n\n init(subscriber: S, eventEmitter: EventEmitter?) {\n\n self.subscriber = subscriber\n self.eventEmitter = eventEmitter\n\n self.eventEmitterSubscription = eventEmitter?\n .addEventHandler { (event) in\n _ = subscriber.receive(event)\n }\n }\n\n public func request(_ demand: Subscribers.Demand) {\n // TODO: implement\n }\n\n public func cancel() {\n guard let eventEmitterSubscription else { return }\n eventEmitter?.removeEventHandler(eventEmitterSubscription)\n }\n\n }\n\n}\n" }, { "path": "Sources/Verge/Library/InoutRef.swift", "content": "//\n// Copyright (c) 2020 muukii\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\nimport Foundation\nimport StateStruct\n\npublic enum Modification {\n case graph(PropertyNode)\n case indeterminate\n}\n\npublic struct InoutRef: ~Copyable {\n \n // MARK: - Properties\n\n nonisolated(unsafe) private let pointer: UnsafeMutablePointer\n\n /// A wrapped value\n /// You may use this property to call the mutating method which `Wrapped` has.\n public var wrapped: Wrapped {\n _read {\n yield pointer.pointee\n }\n _modify {\n yield &pointer.pointee\n }\n }\n \n private(set) var modification: Modification?\n\n public var hasModified: Bool {\n guard let modification else {\n return false\n } \n switch modification {\n case .graph(let graph):\n return !graph.isEmpty\n case .indeterminate:\n return true\n } \n }\n\n // MARK: - Initializers\n\n /**\n Creates an instance\n\n You should take care of using the pointer of value.\n Using always `withUnsafeMutablePointer` to pass it, otherwise Swift might crash with Memory error.\n */\n init(_ pointer: UnsafeMutablePointer) {\n self.pointer = pointer\n }\n \n deinit {\n (pointer.pointee as? TrackingObject)?.endTracking()\n }\n\n // MARK: - Functions\n \n public mutating func modify(_ perform: (inout Wrapped) throws -> T) rethrows -> T {\n \n if pointer.pointee is TrackingObject {\n \n let identifier = Token()\n \n (pointer.pointee as! TrackingObject)._tracking_context.identifier = identifier\n \n let result = try perform(&pointer.pointee)\n \n let resultIdentifier = (pointer.pointee as! TrackingObject)._tracking_context.identifier\n \n (pointer.pointee as! TrackingObject)._tracking_context.identifier = nil\n \n guard Optional(identifier) == resultIdentifier else {\n // replacing instance itself happened.\n modification = .indeterminate\n return result\n }\n \n if var modifyingResult = (pointer.pointee as! TrackingObject).trackingResult {\n \n modifyingResult.graph.shakeAsWrite()\n \n let graph = modifyingResult.graph\n \n self.modification = .graph(graph)\n//#if DEBUG\n// Log.writeGraph.debug(\"Modified: \\(graph.prettyPrint())\")\n//#endif\n } else {\n modification = .indeterminate\n }\n \n \n return result\n \n } else {\n let r = try perform(&pointer.pointee)\n \n modification = .indeterminate\n \n return r \n }\n \n }\n\n}\n\n\nprivate final class Token: Hashable {\n \n static func == (lhs: Token, rhs: Token) -> Bool {\n lhs === rhs\n }\n \n func hash(into hasher: inout Hasher) {\n ObjectIdentifier(self).hash(into: &hasher)\n }\n \n}\n\n/// Do not retain on anywhere.\n@dynamicMemberLookup\npublic final class ReadRef {\n\n private let pointer: UnsafePointer\n\n /// A wrapped value\n /// You may use this property to call the mutating method which `Wrapped` has.\n public var wrapped: Wrapped {\n _read {\n yield pointer.pointee\n }\n }\n\n // MARK: - Initializers\n\n /**\n Creates an instance\n\n You should take care of using the pointer of value.\n Using always `withUnsafeMutablePointer` to pass it, otherwise Swift might crash with Memory error.\n */\n public init(_ pointer: UnsafePointer) {\n self.pointer = pointer\n }\n\n // MARK: - Functions\n\n public subscript(dynamicMember keyPath: KeyPath) -> T {\n _read {\n yield pointer.pointee[keyPath: keyPath]\n }\n }\n\n public subscript(dynamicMember keyPath: KeyPath) -> T? {\n _read {\n yield pointer.pointee[keyPath: keyPath]\n }\n }\n\n public subscript(keyPath keyPath: KeyPath) -> T {\n _read {\n yield pointer.pointee[keyPath: keyPath]\n }\n }\n\n public subscript(keyPath keyPath: KeyPath) -> T? {\n _read {\n yield pointer.pointee[keyPath: keyPath]\n }\n }\n\n func map(keyPath: KeyPath, perform: (inout ReadRef) throws -> Result)\n rethrows -> Result\n {\n\n try withUnsafePointer(to: pointer.pointee[keyPath: keyPath]) { (pointer) in\n var ref = ReadRef.init(pointer)\n return try perform(&ref)\n }\n }\n\n func map(keyPath: KeyPath, perform: (inout ReadRef?) throws -> Result)\n rethrows -> Result\n {\n\n guard pointer.pointee[keyPath: keyPath] != nil else {\n var _nil: ReadRef! = .none\n return try perform(&_nil)\n }\n\n return try withUnsafePointer(to: pointer.pointee[keyPath: keyPath]!) { (pointer) in\n var ref: ReadRef! = ReadRef.init(pointer)\n return try perform(&ref)\n }\n\n }\n\n}\n" }, { "path": "Sources/Verge/Library/Log.swift", "content": "//\n// Log.swift\n// VergeCore\n//\n// Created by muukii on 2020/02/24.\n// Copyright © 2020 muukii. All rights reserved.\n//\n\nimport Foundation\n\nimport os.log\n\nenum Log {\n \n static let store = Logger(OSLog.makeOSLogInDebug { OSLog.init(subsystem: \"Verge\", category: \"store\") })\n \n static let storeCommit = Logger(OSLog.makeOSLogInDebug { OSLog.init(subsystem: \"Verge\", category: \"store.commit\") })\n \n static let storeReader = Logger(OSLog.makeOSLogInDebug { OSLog.init(subsystem: \"Verge\", category: \"storeReader\") })\n \n static let reading = Logger(OSLog.makeOSLogInDebug { OSLog.init(subsystem: \"Verge\", category: \"reading\") })\n \n static let writeGraph = Logger(OSLog.makeOSLogInDebug { OSLog.init(subsystem: \"Verge\", category: \"writeGraph\") })\n \n}\n\nextension OSLog {\n \n @inline(__always)\n fileprivate static func makeOSLogInDebug(isEnabled: Bool = true, _ factory: () -> OSLog) -> OSLog {\n#if DEBUG\n return factory()\n#else\n return .disabled\n#endif\n }\n \n}\n" }, { "path": "Sources/Verge/Library/Signpost.swift", "content": "import os\nimport Foundation\n\nnonisolated(unsafe)\npublic var _verge_signpost_enabled = ProcessInfo.processInfo.environment[\"VERGE_SIGNPOST_ENABLED\"] != nil\n\n@usableFromInline\nenum SignpostConstants {\n @usableFromInline\n static let performanceLog = { () -> OSLog in\n if #available(iOSApplicationExtension 13.0, *) {\n return OSLog(subsystem: \"lib.verge\", category: \"performance\")\n } else {\n return OSLog(subsystem: \"lib.verge\", category: \"performance\")\n }\n }()\n @usableFromInline\n static let pointOfInterestLog = OSLog(subsystem: \"lib.verge\", category: .pointsOfInterest)\n}\n\n@inlinable\npublic func vergeSignpostEvent(_ event: StaticString) {\n #if DEBUG\n if _verge_signpost_enabled {\n let id = OSSignpostID(log: SignpostConstants.pointOfInterestLog)\n os_signpost(.event, log: SignpostConstants.pointOfInterestLog, name: event, signpostID: id)\n }\n #endif\n}\n\n@inlinable\npublic func vergeSignpostEvent(_ event: StaticString, label: @autoclosure () -> String) {\n #if DEBUG\n if _verge_signpost_enabled {\n let id = OSSignpostID(log: SignpostConstants.pointOfInterestLog)\n os_signpost(.event, log: SignpostConstants.pointOfInterestLog, name: event, signpostID: id, \"%@\", label())\n }\n #endif\n}\n\n\npublic struct VergeSignpostTransaction {\n \n #if DEBUG\n @usableFromInline\n let _end: () -> Void\n public let rawID: os_signpost_id_t\n #endif\n \n public init(_ name: StaticString) {\n #if DEBUG\n if _verge_signpost_enabled {\n let id = OSSignpostID(log: SignpostConstants.performanceLog)\n self.rawID = id.rawValue\n os_signpost(.begin, log: SignpostConstants.performanceLog, name: name, signpostID: id)\n _end = {\n os_signpost(.end, log: SignpostConstants.performanceLog, name: name, signpostID: id)\n }\n } else {\n rawID = 0\n _end = {}\n }\n #else\n #endif\n }\n \n public init(_ name: StaticString, label: @autoclosure () -> String) {\n #if DEBUG\n if _verge_signpost_enabled {\n let id = OSSignpostID(log: SignpostConstants.performanceLog)\n self.rawID = id.rawValue\n let _label = label()\n os_signpost(.begin, log: SignpostConstants.performanceLog, name: name, signpostID: id, \"Begin: %@\", _label)\n _end = {\n os_signpost(.end, log: SignpostConstants.performanceLog, name: name, signpostID: id, \"End: %@\", _label)\n }\n } else {\n rawID = 0\n _end = {}\n }\n #else\n #endif\n }\n \n public func event(name: StaticString, label: @autoclosure () -> String) {\n #if DEBUG\n if _verge_signpost_enabled {\n let id = OSSignpostID(rawID)\n os_signpost(.event, log: SignpostConstants.pointOfInterestLog, name: name, signpostID: id, \"%@\", label())\n }\n #endif\n }\n \n @inlinable\n @inline(__always)\n public func event(name: StaticString) {\n #if DEBUG\n if _verge_signpost_enabled {\n let id = OSSignpostID(rawID)\n os_signpost(.event, log: SignpostConstants.pointOfInterestLog, name: name, signpostID: id)\n }\n #endif\n }\n \n @inlinable\n @inline(__always)\n public func end() {\n #if DEBUG\n _end()\n #endif\n }\n}\n" }, { "path": "Sources/Verge/Library/StoreActivitySubscription.swift", "content": "import Combine\nimport Atomics\n\n/**\n A subscription that is compatible with Combine’s Cancellable.\n You can manage asynchronous tasks either call the ``cancel()`` to halt the subscription, or allow it to terminate upon instance deallocation, and by implementing the ``storeWhileSourceActive()`` technique, the subscription’s active status is maintained until the source store is released.\n */\npublic final class StoreActivitySubscription: StoreSubscriptionBase, @unchecked Sendable {\n \n}\n\n" }, { "path": "Sources/Verge/Library/StoreStateSubscription.swift", "content": "import Combine\nimport Atomics\n\n/**\n A subscription that is compatible with Combine's Cancellable.\n You can manage asynchronous tasks either call the ``cancel()`` to halt the subscription, or allow it to terminate upon instance deallocation, and by implementing the ``storeWhileSourceActive()`` technique, the subscription's active status is maintained until the source store is released.\n */\npublic final class StoreStateSubscription: StoreSubscriptionBase, @unchecked Sendable {\n \n}\n" }, { "path": "Sources/Verge/Library/StoreSubscriptionBase.swift", "content": "\npublic class StoreSubscriptionBase: Hashable, Cancellable {\n\n public static func == (lhs: StoreSubscriptionBase, rhs: StoreSubscriptionBase) -> Bool {\n lhs === rhs\n }\n \n private struct State {\n var wasCancelled: Bool = false\n weak var storeCancellable: VergeAnyCancellable?\n var associatedStore: (any StoreType)?\n }\n \n private let state: VergeConcurrency.ManagedCriticalState\n \n public func hash(into hasher: inout Hasher) {\n ObjectIdentifier(self).hash(into: &hasher)\n } \n \n private let source: EventEmitterCancellable\n \n init(\n _ eventEmitterCancellable: EventEmitterCancellable,\n storeCancellable: VergeAnyCancellable\n ) {\n self.source = eventEmitterCancellable\n self.state = .init(State(storeCancellable: storeCancellable))\n }\n \n public func cancel() {\n \n let continues = state.withCriticalRegion { state -> Bool in\n guard state.wasCancelled == false else {\n return false\n }\n state.wasCancelled = true \n // if it's associated as storeWhileSourceActive.\n state.storeCancellable?.dissociate(self)\n state.associatedStore = nil\n return true\n }\n \n guard continues else {\n return\n }\n \n source.cancel()\n }\n \n /**\n Make this subscription alive while the source is active.\n the source means a root data store which is Store.\n \n In case of Derived, the source will be Derived's upstream.\n If the upstream invalidated, this subscription will stop.\n */\n @discardableResult\n public func storeWhileSourceActive() -> Self {\n state.withCriticalRegion { state in \n assert(state.wasCancelled == false)\n assert(state.storeCancellable != nil)\n state.storeCancellable?.associate(self)\n }\n return self\n }\n \n func associate(store: any StoreType) -> Self {\n state.withCriticalRegion { state in\n assert(state.wasCancelled == false)\n assert(state.storeCancellable != nil)\n state.associatedStore = store\n }\n return self\n }\n \n /**\n Converts to Combine.AnyCancellable to make it auto cancellable.\n */\n public func asAny() -> AnyCancellable {\n return .init { [self] in\n self.cancel()\n }\n }\n \n deinit {\n cancel()\n }\n}\n" }, { "path": "Sources/Verge/Library/VergeAnyCancellable.swift", "content": "import Combine\nimport Atomics\n\n/// A typealias to `Set`.\npublic typealias VergeAnyCancellables = Set\n\n/// A type-erasing cancellable object that executes a provided closure when canceled.\n/// An AnyCancellable instance automatically calls cancel() when deinitialized.\n/// To cancel depending owner, can be written following\n///\n/// ```\n/// class ViewController {\n///\n/// var subscriptions = VergeAnyCancellables()\n///\n/// func something() {\n///\n/// let derived = store.derived(...)\n///\n/// derived\n/// .subscribeStateChanges { ... }\n/// .store(in: &subscriptions)\n/// }\n///\n/// }\n/// ```\npublic final class VergeAnyCancellable: Hashable, Cancellable, Sendable {\n\n private struct State {\n var wasCancelled: Bool = false\n var actions: ContiguousArray<() -> Void>? = .init()\n var retainObjects: [AnyObject] = []\n }\n \n private let state: VergeConcurrency.ManagedCriticalState = .init(State())\n\n public static func == (lhs: VergeAnyCancellable, rhs: VergeAnyCancellable) -> Bool {\n lhs === rhs\n }\n\n public func hash(into hasher: inout Hasher) {\n ObjectIdentifier(self).hash(into: &hasher)\n }\n\n public init() {\n }\n\n public convenience init(onDeinit: @escaping () -> Void) {\n self.init()\n state.withCriticalRegion { $0.actions = [onDeinit] }\n }\n\n public convenience init(_ cancellable: C) where C : Cancellable {\n self.init {\n cancellable.cancel()\n }\n }\n\n @discardableResult\n public func associate(_ object: AnyObject) -> VergeAnyCancellable {\n state.withCriticalRegion { state in\n assert(!state.wasCancelled)\n state.retainObjects.append(object)\n }\n return self\n }\n\n public func dissociate(_ object: AnyObject) {\n let targets = state.withCriticalRegion { state -> [AnyObject] in\n var targets: [AnyObject] = .init()\n targets.reserveCapacity(state.retainObjects.count)\n state.retainObjects.removeAll {\n let remove = $0 === object\n if remove {\n targets.append($0)\n }\n return remove \n }\n return targets\n }\n \n guard targets.isEmpty == false else {\n return\n }\n\n withExtendedLifetime(targets, {})\n }\n\n public func insert(_ cancellable: Cancellable) {\n state.withCriticalRegion { state in\n assert(!state.wasCancelled)\n state.actions?.append {\n cancellable.cancel()\n }\n }\n }\n\n public func insert(onDeinit: @escaping () -> Void) {\n state.withCriticalRegion { state in\n assert(!state.wasCancelled)\n state.actions?.append(onDeinit)\n }\n }\n\n deinit {\n cancel()\n }\n\n public func cancel() {\n let result = state.withCriticalRegion { state -> (\n retainObjects: [AnyObject],\n actions: ContiguousArray<() -> Void>?\n )? in\n guard !state.wasCancelled else {\n return nil\n }\n \n state.wasCancelled = true\n \n let retainObjects = state.retainObjects\n state.retainObjects.removeAll()\n \n let actions = state.actions\n state.actions = nil\n \n return (retainObjects, actions)\n }\n \n guard let result else {\n return\n }\n \n withExtendedLifetime(result.retainObjects, {})\n \n result.actions?.forEach {\n $0()\n }\n }\n}\n\n" }, { "path": "Sources/Verge/Library/VergeConcurrency+SynchronizationTracker.swift", "content": "//\n// Copyright (c) 2020 muukii\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\nimport Foundation\n\nextension VergeConcurrency {\n ///\n ///\n /// Modified based on RxSwift's original implementations.\n public final class SynchronizationTracker: @unchecked Sendable {\n \n public enum Warning: Hashable {\n case reentrancyAnomaly\n case synchronizationAnomaly\n }\n \n private let _lock = VergeConcurrency.RecursiveLock()\n \n private var _threads = [UnsafeMutableRawPointer: Int]()\n \n private let _isEnabled: Bool\n \n public init(debugOnly: Bool = false) {\n if debugOnly {\n #if DEBUG\n self._isEnabled = true\n #else\n self._isEnabled = false\n #endif\n } else {\n self._isEnabled = true\n }\n }\n \n /**\n Marks as entering a synchronized operation.\n */\n @discardableResult\n public func register(\n _ file: StaticString = #file,\n _ function: StaticString = #function,\n _ line: UInt = #line,\n printsConsole: Bool = false\n ) -> Set {\n \n guard _isEnabled else { return .init() }\n \n self._lock.lock(); defer { self._lock.unlock() }\n \n var flags = Set()\n \n let pointer = Unmanaged.passUnretained(Thread.current).toOpaque()\n let count = (self._threads[pointer] ?? 0) + 1\n \n if count > 1 {\n flags.insert(.reentrancyAnomaly)\n }\n \n self._threads[pointer] = count\n \n if self._threads.count > 1 {\n flags.insert(.synchronizationAnomaly)\n }\n \n if printsConsole, flags.isEmpty == false {\n print(\"⚠️[SynchronizationTracker] Found issues \\(flags) in \\(file):\\(function):\\(line)\")\n }\n \n return flags\n }\n \n /**\n Marks as exited a synchronized operation.\n */\n public func unregister() {\n \n guard _isEnabled else { return }\n \n self._lock.lock(); defer { self._lock.unlock() }\n let pointer = Unmanaged.passUnretained(Thread.current).toOpaque()\n self._threads[pointer] = (self._threads[pointer] ?? 1) - 1\n if self._threads[pointer] == 0 {\n self._threads[pointer] = nil\n }\n }\n }\n}\n" }, { "path": "Sources/Verge/Library/VergeConcurrency.swift", "content": "//\n// Copyright (c) 2020 muukii\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\nimport Foundation\n\npublic enum VergeConcurrency {\n \n public final class RecursiveLock: NSRecursiveLock, @unchecked Sendable {\n \n }\n \n public struct UnfairLock: ~Copyable, @unchecked Sendable {\n private let _lock: os_unfair_lock_t\n \n public init() {\n _lock = .allocate(capacity: 1)\n _lock.initialize(to: os_unfair_lock())\n }\n\n public func lock() {\n os_unfair_lock_lock(_lock)\n }\n\n public func unlock() {\n os_unfair_lock_unlock(_lock)\n }\n\n public func `try`() -> Bool {\n return os_unfair_lock_trylock(_lock)\n }\n\n deinit {\n _lock.deinitialize(count: 1)\n _lock.deallocate()\n }\n }\n \n /// An atomic variable.\n public final class RecursiveLockAtomic: @unchecked Sendable {\n \n public var unsafelyWrappedValue: Value {\n _read { yield _value }\n }\n \n private let lock: RecursiveLock\n private var _value: Value\n \n /// Atomically get or set the value of the variable.\n public var value: Value {\n get {\n return withValue { $0 }\n }\n \n set(newValue) {\n swap(newValue)\n }\n }\n \n /// Initialize the variable with the given initial value.\n ///\n /// - parameters:\n /// - value: Initial value for `self`.\n public init(_ value: Value) {\n _value = value\n lock = .init()\n }\n \n /// Atomically modifies the variable.\n ///\n /// - parameters:\n /// - action: A closure that takes the current value.\n ///\n /// - returns: The result of the action.\n @discardableResult\n public func modify(_ action: (inout Value) throws -> Result) rethrows -> Result {\n lock.lock()\n defer { lock.unlock() }\n \n return try action(&_value)\n }\n \n /// Atomically perform an arbitrary action using the current value of the\n /// variable.\n ///\n /// - parameters:\n /// - action: A closure that takes the current value.\n ///\n /// - returns: The result of the action.\n @discardableResult\n public func withValue(_ action: (Value) throws -> Result) rethrows -> Result {\n lock.lock()\n defer { lock.unlock() }\n \n return try action(_value)\n }\n \n /// Atomically replace the contents of the variable.\n ///\n /// - parameters:\n /// - newValue: A new value for the variable.\n ///\n /// - returns: The old value.\n @discardableResult\n public func swap(_ newValue: Value) -> Value {\n return modify { (value: inout Value) in\n let oldValue = value\n value = newValue\n return oldValue\n }\n }\n }\n \n /// An atomic variable.\n @propertyWrapper\n public final class UnfairLockAtomic: @unchecked Sendable {\n \n public var unsafelyWrappedValue: Value {\n _read { yield _value }\n }\n \n private let lock: UnfairLock\n private var _value: Value\n \n /// Atomically get or set the value of the variable.\n public var value: Value {\n get {\n return withValue { $0 }\n }\n set(newValue) {\n swap(newValue)\n }\n }\n\n public var wrappedValue: Value {\n get {\n return withValue { $0 }\n }\n set(newValue) {\n swap(newValue)\n }\n }\n\n /// Initialize the variable with the given initial value.\n ///\n /// - parameters:\n /// - value: Initial value for `self`.\n public init(_ wrappedValue: Value) {\n _value = wrappedValue\n lock = .init()\n }\n\n public init(wrappedValue: Value) {\n _value = wrappedValue\n lock = .init()\n }\n\n public var projectedValue: UnfairLockAtomic { self }\n\n /// Atomically modifies the variable.\n ///\n /// - parameters:\n /// - action: A closure that takes the current value.\n ///\n /// - returns: The result of the action.\n @discardableResult\n public func modify(_ action: (inout Value) throws -> Result) rethrows -> Result {\n lock.lock()\n defer { lock.unlock() }\n \n return try action(&_value)\n }\n \n /// Atomically perform an arbitrary action using the current value of the\n /// variable.\n ///\n /// - parameters:\n /// - action: A closure that takes the current value.\n ///\n /// - returns: The result of the action.\n @discardableResult\n public func withValue(_ action: (Value) throws -> Result) rethrows -> Result {\n lock.lock()\n defer { lock.unlock() }\n \n return try action(_value)\n }\n \n /// Atomically replace the contents of the variable.\n ///\n /// - parameters:\n /// - newValue: A new value for the variable.\n ///\n /// - returns: The old value.\n @discardableResult\n public func swap(_ newValue: Value) -> Value {\n return modify { (value: inout Value) in\n let oldValue = value\n value = newValue\n return oldValue\n }\n }\n }\n\n /// A container that initializes value when it needs.\n ///\n /// Supports multi-threading.\n @propertyWrapper\n public final class AtomicLazy: @unchecked Sendable {\n\n private enum State {\n case initialized(T)\n case notInitialized\n }\n\n public typealias Initializer = () -> T\n\n private var _onInitialized: (T) -> Void = { _ in }\n\n private let lock: UnfairLock = .init()\n\n public var wrappedValue: T {\n\n lock.lock()\n defer {\n lock.unlock()\n }\n\n return unsafeValue\n }\n\n public var projectedValue: AtomicLazy {\n self\n }\n\n @discardableResult\n public func modify(_ action: (inout T) throws -> Result) rethrows -> Result {\n lock.lock()\n defer { lock.unlock() }\n\n var new = unsafeValue\n let result = try action(&new)\n self._synchronized_state = .initialized(new)\n return consume result\n }\n\n private var _synchronized_state: State = .notInitialized\n\n private var unsafeValue: T {\n get {\n switch _synchronized_state {\n case .notInitialized:\n let value = initializer()\n _onInitialized(value)\n self._synchronized_state = .initialized(value)\n self.initializer = nil\n return value\n case .initialized(let value):\n return value\n }\n }\n }\n\n private var initializer: Initializer!\n\n public init(_ initializer: @escaping Initializer) {\n self.initializer = initializer\n }\n\n public init(wrappedValue initializer: @autoclosure @escaping Initializer) {\n self.initializer = initializer\n }\n\n /// Set closure on value initialized.\n /// the closure would be called on thread which value initialized.\n @discardableResult\n public func onInitialized(_ perform: @escaping (T) -> Void) -> Self {\n _onInitialized = perform\n return self\n }\n }\n \n // From: https://github.com/apple/swift-async-algorithms/blob/4c3ea81f81f0a25d0470188459c6d4bf20cf2f97/Sources/AsyncAlgorithms/Locking.swift#L131 \n struct ManagedCriticalState: @unchecked Sendable {\n \n private final class LockedBuffer: ManagedBuffer {\n deinit {\n withUnsafeMutablePointerToElements { Lock.deinitialize($0) }\n }\n }\n \n private let buffer: ManagedBuffer\n \n init(_ initial: State) {\n buffer = LockedBuffer.create(minimumCapacity: 1) { buffer in\n buffer.withUnsafeMutablePointerToElements { Lock.initialize($0) }\n return initial\n }\n }\n \n func withCriticalRegion(_ critical: (inout State) throws -> R) rethrows -> R {\n try buffer.withUnsafeMutablePointers { header, lock in\n Lock.lock(lock)\n defer { Lock.unlock(lock) }\n return try critical(&header.pointee)\n }\n }\n }\n \n internal struct Lock {\n#if canImport(Darwin)\n typealias Primitive = os_unfair_lock\n#elseif canImport(Glibc) || canImport(Musl) || canImport(Bionic)\n typealias Primitive = pthread_mutex_t\n#elseif canImport(WinSDK)\n typealias Primitive = SRWLOCK\n#else\n#error(\"Unsupported platform\")\n#endif\n \n typealias PlatformLock = UnsafeMutablePointer\n let platformLock: PlatformLock\n \n private init(_ platformLock: PlatformLock) {\n self.platformLock = platformLock\n }\n \n fileprivate static func initialize(_ platformLock: PlatformLock) {\n#if canImport(Darwin)\n platformLock.initialize(to: os_unfair_lock())\n#elseif canImport(Glibc) || canImport(Musl) || canImport(Bionic)\n let result = pthread_mutex_init(platformLock, nil)\n precondition(result == 0, \"pthread_mutex_init failed\")\n#elseif canImport(WinSDK)\n InitializeSRWLock(platformLock)\n#else\n#error(\"Unsupported platform\")\n#endif\n }\n \n fileprivate static func deinitialize(_ platformLock: PlatformLock) {\n#if canImport(Glibc) || canImport(Musl) || canImport(Bionic)\n let result = pthread_mutex_destroy(platformLock)\n precondition(result == 0, \"pthread_mutex_destroy failed\")\n#endif\n platformLock.deinitialize(count: 1)\n }\n \n fileprivate static func lock(_ platformLock: PlatformLock) {\n#if canImport(Darwin)\n os_unfair_lock_lock(platformLock)\n#elseif canImport(Glibc) || canImport(Musl) || canImport(Bionic)\n pthread_mutex_lock(platformLock)\n#elseif canImport(WinSDK)\n AcquireSRWLockExclusive(platformLock)\n#else\n#error(\"Unsupported platform\")\n#endif\n }\n \n fileprivate static func unlock(_ platformLock: PlatformLock) {\n#if canImport(Darwin)\n os_unfair_lock_unlock(platformLock)\n#elseif canImport(Glibc) || canImport(Musl) || canImport(Bionic)\n let result = pthread_mutex_unlock(platformLock)\n precondition(result == 0, \"pthread_mutex_unlock failed\")\n#elseif canImport(WinSDK)\n ReleaseSRWLockExclusive(platformLock)\n#else\n#error(\"Unsupported platform\")\n#endif\n }\n \n static func allocate() -> Lock {\n let platformLock = PlatformLock.allocate(capacity: 1)\n initialize(platformLock)\n return Lock(platformLock)\n }\n \n func deinitialize() {\n Lock.deinitialize(platformLock)\n platformLock.deallocate()\n }\n \n func lock() {\n Lock.lock(platformLock)\n }\n \n func unlock() {\n Lock.unlock(platformLock)\n }\n \n /// Acquire the lock for the duration of the given block.\n ///\n /// This convenience method should be preferred to `lock` and `unlock` in\n /// most situations, as it ensures that the lock will be released regardless\n /// of how `body` exits.\n ///\n /// - Parameter body: The block to execute while holding the lock.\n /// - Returns: The value returned by the block.\n func withLock(_ body: () throws -> T) rethrows -> T {\n self.lock()\n defer {\n self.unlock()\n }\n return try body()\n }\n \n // specialise Void return (for performance)\n func withLockVoid(_ body: () throws -> Void) rethrows -> Void {\n try self.withLock(body)\n }\n }\n\n}\n\n@inline(__always)\nfunc withUncheckedSendable(_ body: () throws -> T) rethrows -> T {\n try body()\n}\n" }, { "path": "Sources/Verge/Library/_BackingStorage+.swift", "content": "\nextension _BackingStorage {\n \n func map(_ transform: (borrowing Value) throws -> U) rethrows -> _BackingStorage {\n return .init(\n try transform(value)\n )\n }\n \n}\n\n" }, { "path": "Sources/Verge/Logging/ActivityTrace.swift", "content": "//\n// Copyright (c) 2020 muukii\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\nimport Foundation\n\n/// A trace that indicates the activity where comes from.\npublic struct ActivityTrace: Encodable, Sendable {\n \n public let createdAt: Date = .init()\n public let name: String\n public let file: String\n public let function: String\n public let line: UInt\n \n}\n" }, { "path": "Sources/Verge/Logging/DefaultStoreLogger.swift", "content": "//\n// Copyright (c) 2019 muukii\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\nimport Foundation\n\nimport os\n\npublic struct CommitLog: Encodable, Sendable {\n\n public let type: String = \"commit\"\n public let tookMilliseconds: Double\n public let traces: [MutationTrace]\n public let store: String\n\n public init(storeName: String, traces: [MutationTrace], time: CFTimeInterval) {\n self.store = storeName\n self.tookMilliseconds = time * 1000\n self.traces = traces\n }\n}\n\npublic struct ActivityLog: Encodable, Sendable {\n \n public let type: String = \"activity\"\n public let trace: ActivityTrace\n public let store: String\n\n public init(storeName: String, trace: ActivityTrace) {\n self.store = storeName\n self.trace = trace\n }\n}\n\npublic struct DidCreateDispatcherLog: Encodable, Sendable {\n \n public let type: String = \"did_create_dispatcher\"\n public let store: String\n public let dispatcher: String\n\n public init(storeName: String, dispatcherName: String) {\n self.store = storeName\n self.dispatcher = dispatcherName\n }\n \n}\n\npublic struct DidDestroyDispatcherLog: Encodable, Sendable {\n \n public let type: String = \"did_destroy_dispatcher\"\n public let store: String\n public let dispatcher: String\n\n public init(storeName: String, dispatcherName: String) {\n self.store = storeName\n self.dispatcher = dispatcherName\n }\n \n}\n\n/// An object default implementation of VergeStoreLogger.\n/// It uses `os_log` to print inside.\n/// There are OSLog object each type of action.\n/// You can turn off logging each OSLog object.\npublic struct DefaultStoreLogger: StoreLogger {\n \n public static var `default`: Self { \n .init()\n }\n \n public let commitLog = OSLog(subsystem: \"VergeStore\", category: \"Commit\")\n public let activityLog = OSLog(subsystem: \"VergeStore\", category: \"Activity\")\n\n public let dispatcherCreationLog = OSLog(subsystem: \"VergeStore\", category: \"Dispatcher_Creation\")\n public let dispatcherDestructionLog = OSLog(subsystem: \"VergeStore\", category: \"Dispatcher_Destruction\")\n \n public init() {\n \n }\n \n private static let encoder: JSONEncoder = {\n let encoder = JSONEncoder()\n encoder.dateEncodingStrategy = .iso8601\n if #available(iOS 11.0, macOS 10.13, tvOS 11, watchOS 4, *) {\n encoder.outputFormatting = [.prettyPrinted, .sortedKeys]\n } else {\n encoder.outputFormatting = [.prettyPrinted]\n }\n return encoder\n }()\n \n public func didCommit(log: CommitLog, sender: AnyObject) {\n Task { [commitLog]in\n let string = String(data: try! DefaultStoreLogger.encoder.encode(log), encoding: .utf8)!\n os_log(\"%@\", log: commitLog, type: .default, string)\n }\n }\n \n public func didSendActivity(log: ActivityLog, sender: AnyObject) {\n Task { [activityLog] in\n let string = String(data: try! DefaultStoreLogger.encoder.encode(log), encoding: .utf8)!\n os_log(\"%@\", log: activityLog, type: .default, string)\n }\n }\n \n public func didCreateDispatcher(log: DidCreateDispatcherLog, sender: AnyObject) { \n Task { [dispatcherCreationLog] in\n let string = String(data: try! DefaultStoreLogger.encoder.encode(log), encoding: .utf8)!\n os_log(\"%@\", log: dispatcherCreationLog, type: .default, string)\n }\n }\n \n public func didDestroyDispatcher(log: DidDestroyDispatcherLog, sender: AnyObject) {\n Task { [dispatcherDestructionLog] in\n let string = String(data: try! DefaultStoreLogger.encoder.encode(log), encoding: .utf8)!\n os_log(\"%@\", log: dispatcherDestructionLog, type: .default, string)\n }\n }\n \n}\n\n" }, { "path": "Sources/Verge/Logging/MutationTrace.swift", "content": "//\n// Copyright (c) 2020 muukii\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\nimport Foundation\n\npublic protocol HasTraces {\n var traces: [MutationTrace] { get }\n}\n\n/// A trace that indicates the mutation where comes from.\npublic struct MutationTrace: Encodable, Equatable, Sendable {\n \n public static func == (lhs: MutationTrace, rhs: MutationTrace) -> Bool {\n lhs.createdAt == rhs.createdAt &&\n lhs.name == rhs.name &&\n lhs.file.description == rhs.file.description &&\n lhs.function.description == rhs.function.description &&\n lhs.line == rhs.line\n }\n\n public let createdAt: Date = .init()\n public let name: String\n public let file: StaticString\n public let function: StaticString\n public let line: UInt\n\n public init(\n name: String = \"\",\n file: StaticString = #file,\n function: StaticString = #function,\n line: UInt = #line\n ) {\n self.name = name\n self.file = file\n self.function = function\n self.line = line\n }\n\n}\n\nextension StaticString: @retroactive Encodable {\n\n public func encode(to encoder: Encoder) throws {\n var container = encoder.singleValueContainer()\n try container.encode(description)\n }\n}\n" }, { "path": "Sources/Verge/Logging/RuntimeError.swift", "content": "//\n// Copyright (c) 2020 Hiroshi Kimura(muukii)\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\npublic enum RuntimeError: Swift.Error {\n \n case recoveredStateFromReceivingOlderVersion(latestState: AnyChangesType, receivedState: AnyChangesType)\n case recursiveleyCommit(storeName: String, traces: [MutationTrace])\n}\n" }, { "path": "Sources/Verge/Logging/RuntimeSanitizer.swift", "content": "//\n// Copyright (c) 2020 Hiroshi Kimura(muukii)\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\npublic struct RuntimeSanitizer: Sendable {\n \n nonisolated(unsafe)\n public static var global = RuntimeSanitizer()\n \n public var isSanitizerStateReceivingByCorrectOrder: Bool = false\n public var isRecursivelyCommitDetectionEnabled: Bool = false\n \n public var onDidFindRuntimeError: @Sendable (RuntimeError) -> Void = { _ in }\n \n public init() {\n \n }\n}\n" }, { "path": "Sources/Verge/Logging/StoreLogger.swift", "content": "//\n// Copyright (c) 2020 Hiroshi Kimura(muukii)\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\nimport Foundation\n\n/// A protocol to register logger and get the event VergeStore emits.\npublic protocol StoreLogger {\n \n func didCommit(log: CommitLog, sender: AnyObject)\n func didSendActivity(log: ActivityLog, sender: AnyObject)\n\n func didCreateDispatcher(log: DidCreateDispatcherLog, sender: AnyObject)\n func didDestroyDispatcher(log: DidDestroyDispatcherLog, sender: AnyObject)\n \n}\n\n" }, { "path": "Sources/Verge/Sendable.swift", "content": "\nfinal class UnsafeSendableClass: @unchecked Sendable {\n var value: T\n \n init(_ value: T) {\n self.value = value\n }\n}\n\nstruct UnsafeSendableWeak: @unchecked Sendable {\n weak var value: T?\n \n init(_ value: T) {\n self.value = value\n }\n}\n\nstruct UnsafeSendableStruct: ~Copyable, @unchecked Sendable {\n var value: T\n \n init(_ value: consuming T) {\n self.value = value\n }\n \n consuming func send() -> sending T {\n return value \n }\n \n consuming func with(_ mutation: (inout sending T) throws -> sending Return) rethrows -> sending Return {\n try mutation(&value)\n }\n}\n\nfunc withUnsafeSending(_ value: consuming T) -> sending T {\n UnsafeSendableStruct(value).send()\n}\n" }, { "path": "Sources/Verge/Store/AnyTargetQueue.swift", "content": "//\n// Copyright (c) 2020 Hiroshi Kimura(Muukii) \n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\nimport Foundation\nimport Atomics\n\npublic protocol TargetQueueType {\n func execute(_ workItem: sending @escaping @Sendable () -> Void)\n}\n\n/// Describes queue to dispatch event\n/// Currently light-weight impl\n/// A reason why class is to take an object identifier.\npublic final class AnyTargetQueue: TargetQueueType {\n\n private let _execute: (@escaping @Sendable () -> Void) -> Void\n\n fileprivate init(\n _execute: @escaping (@escaping @Sendable () -> Void) -> Void\n ) {\n self._execute = _execute\n }\n\n public func execute(_ workItem: @escaping @Sendable () -> Void) {\n _execute(workItem)\n }\n\n}\n\npublic protocol MainActorTargetQueueType {\n func execute(_ workItem: @escaping @MainActor () -> Void)\n}\n\nextension MainActorTargetQueueType where Self == ImmediateMainActorTargetQueue {\n public static func mainIsolated() -> Self {\n .init()\n }\n \n public static var main: Self {\n .shared\n }\n \n}\n\nextension MainActorTargetQueueType where Self == HoppingMainActorTargetQueue {\n \n /// It dispatches to main-queue asynchronously always.\n public static var asyncMain: Self {\n return .init()\n }\n}\n\n/// always dispatches to main-queue asynchronously\npublic struct HoppingMainActorTargetQueue: MainActorTargetQueueType {\n\n init() {\n }\n\n public func execute(_ workItem: @escaping @MainActor () -> Void) {\n \n DispatchQueue.main.async {\n workItem()\n }\n }\n\n}\n\n/// It dispatches to main-queue as possible as synchronously. Otherwise, it dispatches asynchronously.\npublic struct ImmediateMainActorTargetQueue: Sendable, MainActorTargetQueueType {\n \n public static let shared = Self()\n\n private let numberEnqueued = ManagedAtomic.init(0)\n \n init() {\n\n }\n \n public func execute(_ workItem: @escaping @MainActor () -> Void) {\n \n let previousNumberEnqueued = numberEnqueued.loadThenWrappingIncrement(ordering: .sequentiallyConsistent)\n \n if Thread.isMainThread && previousNumberEnqueued == 0 {\n MainActor.assumeIsolated {\n workItem()\n }\n numberEnqueued.wrappingDecrement(ordering: .sequentiallyConsistent)\n } else {\n DispatchQueue.main.async {\n workItem()\n self.numberEnqueued.wrappingDecrement(ordering: .sequentiallyConsistent)\n }\n }\n \n }\n \n}\n\nprivate enum StaticMember {\n\n static let serialBackgroundDispatchQueue: DispatchQueue = .init(\n label: \"org.verge.background\",\n qos: .default,\n attributes: [],\n autoreleaseFrequency: .workItem,\n target: nil\n )\n\n}\n\nextension TargetQueueType where Self == Queues.Passthrough {\n\n /// Returns a instance that never dispatches.\n /// The Sink use this targetQueue performs in the queue which the upstream commit dispatched.\n public static var passthrough: Queues.Passthrough {\n .init()\n }\n\n}\n\nextension TargetQueueType where Self == Queues.AsyncBackground {\n /// It dispatches to the serial background queue asynchronously.\n public static var asyncSerialBackground: Self {\n self.init()\n }\n}\n\nextension TargetQueueType where Self == AnyTargetQueue {\n\n\n /// Use specified queue, always dispatches\n public static func specific(_ targetQueue: DispatchQueue) -> AnyTargetQueue {\n return .init { workItem in\n targetQueue.async(execute: workItem)\n }\n }\n\n\n /// Enqueue first item on current-thread(synchronously).\n /// From then, using specified queue.\n public static func startsFromCurrentThread(andUse queue: some TargetQueueType) -> AnyTargetQueue {\n let numberEnqueued = ManagedAtomic.init(true)\n\n let execute = queue.execute\n\n return .init { workItem in\n\n let isFirst = numberEnqueued.loadThenLogicalAnd(with: false, ordering: .relaxed)\n\n if isFirst {\n workItem()\n } else {\n execute(workItem)\n }\n\n }\n }\n\n /// Enqueue first item on current-thread(synchronously).\n /// From then, using specified queue.\n public static func startsFromCurrentThread(andUse queue: some MainActorTargetQueueType) -> AnyTargetQueue {\n return startsFromCurrentThread(andUse: Queues.MainActor(queue))\n }\n\n}\n\nextension HoppingMainActorTargetQueue {\n\n /// It dispatches to main-queue asynchronously always.\n public static var asyncMain: HoppingMainActorTargetQueue {\n return .init()\n }\n\n /// It dispatches to main-queue as possible as synchronously. Otherwise, it dispatches asynchronously from other background-thread.\n public static var main: ImmediateMainActorTargetQueue {\n return .shared\n }\n\n /// It dispatches to main-queue as possible as synchronously. Otherwise, it dispatches asynchronously from other background-thread.\n /// This create isolated queue against using `.main`.\n public static func mainIsolated() -> ImmediateMainActorTargetQueue {\n return .init()\n }\n}\n\npublic enum Queues {\n\n struct MainActor: TargetQueueType {\n\n let underlying: Underlying\n\n init(_ underlying: Underlying) {\n self.underlying = underlying\n }\n\n public func execute(_ workItem: sending @escaping @Sendable () -> Void) {\n underlying.execute(workItem)\n }\n\n }\n\n public struct Passthrough: TargetQueueType {\n\n public func execute(_ workItem: sending @escaping @Sendable () -> Void) {\n workItem()\n }\n\n }\n\n public struct AsyncBackground: TargetQueueType {\n\n private let executor: BackgroundActor = .init()\n\n public func execute(_ workItem: sending @escaping @Sendable () -> Void) {\n Task { [executor, workItem] in\n await executor.perform(workItem)\n }\n }\n \n private actor BackgroundActor: Actor {\n\n init() {\n\n }\n \n func perform(_ operation: sending @Sendable () throws -> R) rethrows -> R {\n try operation()\n }\n \n }\n\n }\n\n}\n" }, { "path": "Sources/Verge/Store/Changes.swift", "content": "//\n// Copyright (c) 2020 Hiroshi Kimura(Muukii) \n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\nimport Foundation\n@_spi(Internal) import TypedComparator\nimport StateStruct\n\nprivate let _shared_changesDeallocationQueue = BackgroundDeallocationQueue()\n\npublic protocol AnyChangesType: AnyObject, Sendable {\n\n var traces: [MutationTrace] { get }\n var version: UInt64 { get }\n}\n\npublic protocol ChangesType: AnyChangesType {\n \n associatedtype Value\n \n var previousPrimitive: Value? { get }\n var primitive: Value { get }\n\n var previous: Self? { get }\n \n var modification: Modification? { get }\n\n func asChanges() -> Changes\n}\n\n/// An immutable data object to achieve followings:\n/// - To know a property has been modified. (It contains 2 instances (old, new))\n/// - To avoid copying cost with wrapping reference type - So, you can embed this object on the other state.\n///\n/// ```swift\n/// struct MyState: Equatable {\n/// var name: String\n/// var age: String\n/// var height: String\n/// }\n/// ```\n///\n/// ```swift\n/// let changes: Changes\n/// ```\n///\n/// It can be accessed with properties of MyState by dynamicMemberLookup\n/// ```swift\n/// changes.name\n/// ```\n///\n/// It would be helpful to update UI partially\n/// ```swift\n/// func updateUI(changes: Changes) {\n///\n/// changes.ifChanged(\\.name) { name in\n/// // update UI\n/// }\n///\n/// changes.ifChanged(\\.age) { age in\n/// // update UI\n/// }\n///\n/// changes.ifChanged(\\.height) { height in\n/// // update UI\n/// }\n/// }\n/// ```\n///\n/// - Attention: Equalities calculates with pointer-personality basically, if the Value type compatibles `Equatable`, it does using also Value's equalities.\n/// This means Changes will return equals if different pointer but the value is the same.\n@dynamicMemberLookup\npublic final class Changes: @unchecked Sendable, ChangesType, Equatable, HasTraces {\n \n public typealias ChangesKeyPath = KeyPath\n\n public static func == (lhs: Changes, rhs: Changes) -> Bool {\n lhs === rhs\n }\n\n // MARK: - Stored Properties\n\n public let previous: Changes?\n \n private let innerBox: InnerBox\n \n public private(set) var version: UInt64\n\n // MARK: - Computed Properties\n\n @available(*, deprecated, renamed: \"previousPrimitive\")\n public var old: Value? { previousPrimitive }\n\n @available(*, deprecated, renamed: \"primitive\")\n public var current: Value { primitive }\n\n /// Returns a previous value as primitive\n /// - Important: a returns value won't change against pointer-personality\n public var previousPrimitive: Value? { _read { yield previous?.primitive } }\n\n /// Returns a value as primitive\n /// - Important: a returns value won't change against pointer-personality\n public var primitive: Value { _read { yield innerBox.value } }\n\n public var primitiveBox: InnerBox { innerBox }\n\n /// Returns a value as primitive\n /// - Important: a returns value won't change against pointer-personality\n public var root: Value { _read { yield innerBox.value } }\n\n public let traces: [MutationTrace]\n \n public let modification: Modification?\n \n public let _transaction: Transaction\n\n // MARK: - Initializers\n\n public convenience init(\n old: consuming Value?,\n new: consuming Value\n ) {\n self.init(\n previous: old.map { .init(old: nil, new: $0) },\n innerBox: .init(consume new),\n version: 0,\n traces: [],\n modification: nil,\n transaction: .init()\n )\n }\n\n private init(\n previous: Changes?,\n innerBox: InnerBox,\n version: UInt64,\n traces: [MutationTrace],\n modification: consuming Modification?,\n transaction: Transaction\n ) {\n self.previous = previous\n self.innerBox = innerBox\n self.version = version\n self.traces = traces\n self.modification = modification\n self._transaction = transaction\n\n vergeSignpostEvent(\"Changes.init\", label: \"\\(type(of: self))\")\n }\n\n deinit {\n vergeSignpostEvent(\"Changes.deinit\", label: \"\\(type(of: self))\")\n \n let unsafeBox = UnsafeSendableStruct(innerBox)\n \n Task {\n await _shared_changesDeallocationQueue.releaseObjectInBackground(object: unsafeBox.value)\n }\n }\n\n @inline(__always)\n private func cloneWithDropsPrevious() -> Changes {\n return .init(\n previous: nil,\n innerBox: innerBox,\n version: version,\n traces: traces,\n modification: nil,\n transaction: _transaction\n )\n }\n\n func replacePrevious(_ previous: Changes) -> Changes {\n return .init(\n previous: previous,\n innerBox: innerBox,\n version: version,\n traces: traces,\n modification: nil,\n transaction: _transaction\n )\n }\n\n @inlinable\n public func asChanges() -> Changes {\n self\n }\n\n /// Returns a Changes object that dropped previous value.\n /// It returns always true in `ifChanged`\n public func droppedPrevious() -> Changes {\n cloneWithDropsPrevious()\n }\n\n @inlinable\n public subscript(dynamicMember keyPath: KeyPath) -> T {\n _read {\n yield primitive[keyPath: keyPath]\n }\n }\n\n /// Returns a new instance that projects value by transform closure.\n ///\n /// - Warning: modification would be dropped.\n public func map(_ transform: (borrowing Value) throws -> U) rethrows -> Changes {\n let signpost = VergeSignpostTransaction(\"Changes.map\")\n defer {\n signpost.end()\n }\n\n return Changes(\n previous: try previous.map { try $0.map(transform) },\n innerBox: try innerBox.map(transform),\n version: version,\n traces: traces,\n modification: modification,\n transaction: _transaction\n )\n }\n\n /**\n Returns an ``Changes`` containing the value of mapping the given key path over the root value if value present.\n */\n public func mapIfPresent(_ keyPath: KeyPath) -> Changes? {\n\n guard self[dynamicMember: keyPath] != nil else {\n return nil\n }\n\n return Changes(\n previous: previous.flatMap { $0.mapIfPresent(keyPath) },\n innerBox: innerBox.map { $0[keyPath: keyPath]! },\n version: version,\n traces: traces,\n modification: nil,\n transaction: _transaction\n )\n\n }\n\n /**\n Returns an ``Changes`` containing the value of mapping the given key path over the root value if value present.\n */\n @available(*, deprecated, renamed: \"mapIfPresent\")\n public func _beta_map(_ keyPath: KeyPath) -> Changes? {\n mapIfPresent(keyPath)\n }\n\n public func makeNextChanges(\n with nextNewValue: Value,\n modification: Modification?,\n transaction: Transaction\n ) -> Changes {\n let previous = cloneWithDropsPrevious()\n let nextVersion = previous.version &+ 1\n return Changes.init(\n previous: previous,\n innerBox: .init(nextNewValue),\n version: nextVersion,\n traces: traces,\n modification: modification,\n transaction: transaction\n )\n }\n\n @discardableResult\n public func _read(perform: (borrowing Value) -> Return) -> Return {\n perform(innerBox.value)\n }\n\n}\n\n// MARK: - Primitive methods\n\nextension Changes {\n \n /// Takes a composed value if it's changed from old value.\n @inline(__always)\n public func takeIfChanged(\n _ compose: (Value) throws -> Composed,\n _ comparer: some TypedComparator\n ) rethrows -> Composed? {\n try _takeIfChanged(compose, comparer)\n }\n\n @inline(__always)\n fileprivate func _takeIfChanged(\n _ compose: (Value) throws -> (repeat each Element),\n _ comparer: consuming some TypedComparator<(repeat each Element)>\n ) rethrows -> (repeat each Element)? {\n\n let current = self.primitive\n\n guard let previousValue = previous else {\n return try compose(consume current)\n }\n\n let old = previousValue.primitive\n\n let composedFromCurrent = try compose(consume current)\n guard !comparer(try compose(consume old), composedFromCurrent) else {\n return nil\n }\n\n return composedFromCurrent\n\n }\n\n @inline(__always)\n fileprivate func _takeIfChanged_packed(\n _ compose: (Value) throws -> (repeat each Element)\n ) rethrows -> (repeat each Element)? {\n\n let current = self.primitive\n\n guard let previousValue = previous else {\n return try compose(consume current)\n }\n\n let old = previousValue.primitive\n\n let composedFromCurrent = try compose(consume current)\n let composedFromOld = try compose(old)\n\n guard !areEqual(\n (repeat each composedFromOld),\n (repeat each composedFromCurrent)\n ) else {\n return nil\n }\n\n return composedFromCurrent\n\n }\n\n @inline(__always)\n fileprivate func _takeIfChanged_packed_nonEquatable(\n _ compose: (Value) throws -> (repeat each Element),\n comparator: some TypedComparator<(repeat each Element)>\n ) rethrows -> (repeat each Element)? {\n\n let current = self.primitive\n\n guard let previousValue = previous else {\n return try compose(consume current)\n }\n\n let old = previousValue.primitive\n\n let composedFromCurrent = try compose(consume current)\n let composedFromOld = try compose(old)\n\n let isEqual = comparator(composedFromOld, composedFromCurrent)\n\n guard isEqual == false else {\n return nil\n }\n\n return composedFromCurrent\n\n }\n\n /// Performs a closure if the selected value changed from the previous one.\n ///\n /// - Parameters:\n /// - compose: A closure that projects a composed value from self. that executes with both of value(new and old).\n /// - comparer: A Comparer that checks if the composed values are different between current and old.\n /// - perform: A closure that executes any operation if composed value changed.\n ///\n /// - Returns: An instance that returned from the perform closure if performed.\n @inline(__always)\n public func ifChanged(\n _ compose: (Value) -> Composed,\n _ comparer: some TypedComparator,\n _ perform: (Composed) throws -> Result\n ) rethrows -> Result? {\n guard let result = takeIfChanged(compose, comparer) else {\n return nil\n }\n\n return try perform(result)\n }\n}\n\n// MARK: - Convenience methods\n\nextension Changes {\n /// Takes a composed value if it's changed from old value.\n @inline(__always)\n public func takeIfChanged(\n _ compose: (Value) throws -> Composed\n ) rethrows -> Composed? {\n try takeIfChanged(compose, .equality())\n }\n\n public func ifChanged(\n _ compose: (Value) -> Composed\n ) -> IfChangedBox {\n guard let result = takeIfChanged(compose) else {\n return .init()\n }\n\n return .init(value: consume result, source: innerBox)\n }\n\n /**\n Packed\n\n ```\n state.ifChanged({ $0.name }).do { value in\n ...\n }\n ```\n */\n public borrowing func ifChanged(\n _ compose: (borrowing Value) -> (repeat each Element)\n ) -> IfChangedBox {\n guard let result = _takeIfChanged_packed(compose) else {\n return .init()\n }\n\n return .init(value: (repeat each result), source: innerBox)\n }\n\n public borrowing func ifChanged(\n _ compose: (borrowing Value) -> (repeat each Element),\n comparator: some TypedComparator<(repeat each Element)>\n ) -> IfChangedBox {\n guard let result = _takeIfChanged_packed_nonEquatable(compose, comparator: comparator) else {\n return .init()\n }\n\n return .init(value: (repeat each result), source: innerBox)\n }\n\n /**\n singular variant\n */\n public func ifChanged(\n _ keyPath: KeyPath\n ) -> IfChangedBox {\n ifChanged({ $0[keyPath: keyPath] })\n }\n\n /**\n multiple variant\n */\n public func ifChanged(\n _ keyPaths: repeat KeyPath\n ) -> IfChangedBox {\n ifChanged({ (repeat $0[keyPath: each keyPaths]) })\n }\n \n}\n\n// MARK: - Has changes\n\nextension Changes {\n /// Returns boolean that indicates value specified by keyPath contains changes with compared old and new.\n @inline(__always)\n public func hasChanges(_ keyPath: ChangesKeyPath) -> Bool {\n hasChanges(keyPath, EqualityComparator())\n }\n\n /// Returns boolean that indicates value specified by keyPath contains changes with compared old and new.\n @inline(__always)\n public func hasChanges(\n _ keyPath: ChangesKeyPath,\n _ comparer: some TypedComparator\n ) -> Bool {\n hasChanges({ $0[keyPath: keyPath] }, comparer)\n }\n\n @inline(__always)\n public func hasChanges(\n _ compose: (Value) -> Composed\n ) -> Bool {\n hasChanges(compose, EqualityComparator())\n }\n\n @inline(__always)\n public func hasChanges(\n _ compose: (Value) -> Composed,\n _ comparer: some TypedComparator\n ) -> Bool {\n takeIfChanged(compose, comparer) != nil\n }\n\n}\n\n// MARK: - NoChanges\n\nextension Changes {\n /// Returns boolean that indicates value specified by keyPath contains **NO** changes with compared old and new.\n @inline(__always)\n public func noChanges(_ keyPath: ChangesKeyPath) -> Bool {\n !hasChanges(keyPath, EqualityComparator())\n }\n\n /// Returns boolean that indicates value specified by keyPath contains **NO** changes with compared old and new.\n @inline(__always)\n public func noChanges(_ keyPath: ChangesKeyPath, _ comparer: some TypedComparator) -> Bool {\n !hasChanges(keyPath, comparer)\n }\n}\n\nextension Changes: CustomReflectable {\n public var customMirror: Mirror {\n Mirror(\n self,\n children: [\n \"version\": version,\n \"previous\": previous as Any,\n \"primitive\": primitive,\n \"transaction\": _transaction,\n \"traces\": traces,\n \"modification\": modification as Any,\n ],\n displayStyle: .struct,\n ancestorRepresentation: .generated\n )\n }\n}\n\n// MARK: - Nested Types\n\nextension Changes {\n\n public typealias InnerBox = _BackingStorage\n\n}\n\nextension Changes where Value: Equatable {\n public var hasChanges: Bool {\n previousPrimitive != primitive\n }\n\n public func ifChanged() -> IfChangedBox {\n ifChanged({ $0 })\n }\n\n}\n\npublic struct IfChangedBox: ~Copyable {\n\n public let value: T?\n \n @usableFromInline\n let source: Changes.InnerBox?\n\n init(value: consuming T, source: Changes.InnerBox) {\n self.value = consume value\n self.source = source\n }\n\n init() {\n self.value = nil \n self.source = nil\n }\n\n @discardableResult\n @inlinable\n public consuming func `do`(_ perform: (consuming T) throws -> Return) rethrows -> Return? {\n if let value {\n return try perform(consume value)\n }\n return nil\n }\n \n @discardableResult\n @inlinable\n public consuming func doWithSource(_ perform: (consuming Changes.InnerBox) throws -> Return) rethrows -> Return? {\n if let source {\n return try perform(source)\n }\n return nil\n }\n}\n\n" }, { "path": "Sources/Verge/Store/DetachedDispatcher.swift", "content": "//\n// Copyright (c) 2019 muukii\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\npublic final class DetachedDispatcher: StoreDriverType\n{\n\n public let store: Store\n public let scope: WritableKeyPath & Sendable\n\n init(\n store: Store,\n scope: WritableKeyPath & Sendable\n ) {\n self.store = store\n self.scope = scope\n }\n\n}\n" }, { "path": "Sources/Verge/Store/KeyObject.swift", "content": "\nimport Foundation\n\n@_spi(Internal)\npublic final class KeyObject: NSObject, NSCopying {\n\n public func copy(with zone: NSZone? = nil) -> Any {\n return KeyObject(content: content)\n }\n\n public let content: Content\n\n public init(content: consuming Content) {\n self.content = content\n }\n\n public override var hash: Int {\n content.hashValue\n }\n\n public override func isEqual(_ object: Any?) -> Bool {\n\n guard let other = object as? KeyObject else {\n return false\n }\n\n guard content == other.content else { return false }\n\n return true\n }\n\n}\n" }, { "path": "Sources/Verge/Store/NonAtomicCounter.swift", "content": "//\n// Copyright (c) 2020 Hiroshi Kimura(Muukii) \n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\nimport Foundation\n\n/// A container that manages raw value to describe mark as updated.\npublic struct NonAtomicCounter: Hashable, Sendable {\n \n private(set) public var value: UInt64 = 0\n \n public init() {}\n \n public mutating func increment() {\n value &+= 1\n }\n \n}\n" }, { "path": "Sources/Verge/Store/Pipeline.swift", "content": "//\n// Copyright (c) 2020 Hiroshi Kimura(Muukii) \n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\nimport Foundation\nimport TypedComparator\n\npublic enum ContinuousResult {\n case new(Output)\n case noUpdates\n}\n\nextension ContinuousResult: Equatable where Output: Equatable {\n\n}\n\n/// A filter object that yields the output produced from the input.\npublic protocol PipelineType: Sendable {\n\n associatedtype Input\n associatedtype Output\n associatedtype Storage = Void\n\n func makeStorage() -> Storage\n\n /// Yields the output from the input.\n func yield(_ input: Input, storage: inout Storage) -> Output\n\n /// Yields the output from the input if it's needed\n func yieldContinuously(_ input: Input, storage: inout Storage) -> ContinuousResult\n\n}\n\nextension PipelineType where Storage == Void {\n public func makeStorage() {\n ()\n }\n}\n\n/// It produces outputs from inputs with their own conditions.\n///\n/// Against just using map closure, it can drop output if there are no changes.\n/// This will be helpful in performance. Therefore most type parameters require Equatable.\npublic enum Pipelines {\n\n /// KeyPath based pipeline, light weight operation just take value from source.\n public struct ChangesSelectPassthroughPipeline: PipelineType {\n\n public typealias Storage = Void\n\n public typealias Input = Changes\n\n public let selector: @Sendable (borrowing Input.Value) -> Output\n\n public init(\n selector: @escaping @Sendable (borrowing Input.Value) -> Output\n ) {\n self.selector = selector\n }\n\n public func yieldContinuously(_ input: Input, storage: inout Storage) -> ContinuousResult {\n\n let target = input._read(perform: selector)\n\n return .new(consume target)\n\n }\n\n public func yield(_ input: Input, storage: inout Storage) -> Output {\n input._read(perform: selector)\n }\n\n }\n\n /// KeyPath based pipeline, light weight operation just take value from source.\n public struct ChangesSelectPipeline: PipelineType {\n\n public typealias Input = Changes\n\n public let selector: @Sendable (borrowing Input.Value) -> Output\n public let additionalDropCondition: (@Sendable (Input) -> Bool)?\n\n public init(\n selector: @escaping @Sendable (borrowing Input.Value) -> Output,\n additionalDropCondition: (@Sendable (Input) -> Bool)?\n ) {\n self.selector = selector\n self.additionalDropCondition = additionalDropCondition\n }\n\n public func yieldContinuously(_ input: Input, storage: inout Storage) -> ContinuousResult {\n\n guard let previous = input.previous else {\n return .new(input._read(perform: selector))\n }\n\n let target = input._read(perform: selector)\n\n guard\n previous._read(perform: selector) == target\n else {\n\n guard let additionalDropCondition = additionalDropCondition, additionalDropCondition(input)\n else {\n return .new(consume target)\n }\n\n return .noUpdates\n }\n\n return .noUpdates\n\n }\n\n public func yield(_ input: Input, storage: inout Storage) -> Output {\n input._read(perform: selector)\n }\n\n public func drop(while predicate: @escaping @Sendable (Input) -> Bool) -> Self {\n return .init(\n selector: selector,\n additionalDropCondition: additionalDropCondition.map { currentCondition in\n { input in\n currentCondition(input) || predicate(input)\n }\n } ?? predicate\n )\n }\n\n }\n \n /// Closure based pipeline,\n public struct ChangesMapPipeline: PipelineType {\n\n public typealias Storage = Void\n\n public typealias Input = Changes\n\n // MARK: - Properties\n\n public let intermediate: @Sendable (Input.Value) -> PipelineIntermediate\n public let transform: @Sendable (Intermediate) -> Output\n public let additionalDropCondition: (@Sendable (Input) -> Bool)?\n\n public init(\n @PipelineIntermediateBuilder intermediate: @escaping @Sendable (\n Input.Value\n ) -> PipelineIntermediate,\n transform: @escaping @Sendable (Intermediate) -> Output,\n additionalDropCondition: (@Sendable (Input) -> Bool)?\n ) {\n self.intermediate = intermediate\n self.transform = transform\n self.additionalDropCondition = additionalDropCondition\n }\n\n // MARK: - Functions\n\n public func yieldContinuously(_ input: Input, storage: inout Storage) -> ContinuousResult {\n\n guard let previous = input.previous else {\n return .new(yield(input, storage: &storage))\n }\n\n let previousIntermediate = intermediate(previous.primitive)\n let newIntermediate = intermediate(input.primitive)\n\n guard previousIntermediate == newIntermediate else {\n\n let previousMapped = transform(previousIntermediate.value)\n let newMapped = transform(newIntermediate.value)\n\n guard previousMapped == newMapped else {\n\n guard let additionalDropCondition = additionalDropCondition,\n additionalDropCondition(input)\n else {\n return .new(newMapped)\n }\n\n return .noUpdates\n }\n\n return .noUpdates\n }\n\n return .noUpdates\n\n }\n\n public func yield(_ input: Input, storage: inout Storage) -> Output {\n transform(intermediate(input.primitive).value)\n }\n\n public func drop(while predicate: @escaping @Sendable (Input) -> Bool) -> Self {\n return .init(\n intermediate: intermediate,\n transform: transform,\n additionalDropCondition: additionalDropCondition.map { currentCondition in\n { input in\n currentCondition(input) || predicate(input)\n }\n } ?? predicate\n )\n }\n }\n\n public struct UniqueFilterEquatable: PipelineType where Map.Output: Equatable {\n\n public typealias Input = Map.Input\n public typealias Output = Map.Output\n\n private let map: Map\n\n public init(map: Map) {\n self.map = map\n }\n\n public func makeStorage() -> VergeConcurrency.UnfairLockAtomic {\n .init(nil)\n }\n\n public func yield(_ input: Input, storage: inout Storage) -> Output {\n let result = map.perform(input)\n storage.swap(result)\n return result\n }\n\n public func yieldContinuously(_ input: Input, storage: inout Storage) -> ContinuousResult {\n\n // not to check if input has changed because storing the input may cause performance issue by copying.\n\n let result = map.perform(input)\n\n return storage.modify { value in\n if value != result {\n value = result\n return .new(result)\n } else {\n return .noUpdates\n }\n }\n }\n\n }\n\n public struct UniqueFilter: PipelineType\n where OutputComparator.Input == Map.Output? {\n\n public typealias Input = Map.Input\n public typealias Output = Map.Output\n\n private let map: Map\n private let outputComparator: OutputComparator\n\n public init(map: Map, outputComparator: OutputComparator) {\n self.map = map\n self.outputComparator = outputComparator\n }\n\n public func makeStorage() -> VergeConcurrency.UnfairLockAtomic {\n .init(nil)\n }\n\n public func yield(_ input: Input, storage: inout Storage) -> Output {\n let result = map.perform(input)\n storage.swap(result)\n return result\n }\n\n public func yieldContinuously(_ input: Input, storage: inout Storage) -> ContinuousResult {\n\n // not to check if input has changed because storing the input may cause performance issue by copying.\n\n let result = map.perform(input)\n\n return storage.modify { value in\n if !outputComparator(value, result) {\n value = result\n return .new(result)\n } else {\n return .noUpdates\n }\n }\n }\n\n }\n\n}\n\npublic protocol MapFunction: Sendable {\n associatedtype Input\n associatedtype Output\n func perform(_ input: Input) -> Output\n}\n\npublic struct AnyMapFunction: MapFunction {\n\n private let _perform: @Sendable (Input) -> Output\n\n public init(_ perform: @escaping @Sendable (Input) -> Output) {\n self._perform = perform\n }\n\n public func perform(_ input: Input) -> Output {\n _perform(input)\n }\n}\n\nextension PipelineType {\n\n public static func uniqueMap(_ mapFunction: Map) -> Self\n where Map.Output: Equatable, Self == Pipelines.UniqueFilterEquatable {\n return .init(map: mapFunction)\n }\n\n public static func uniqueMap(\n _ map: @escaping @Sendable (Input) -> Output\n ) -> Self\n where Output: Equatable, Self == Pipelines.UniqueFilterEquatable> {\n return uniqueMap(.init(map))\n }\n\n public static func uniqueMap(\n _ mapFunction: Map, _ outputComparator: OutputComparator\n ) -> Self\n where Self == Pipelines.UniqueFilter {\n return .init(map: mapFunction, outputComparator: outputComparator)\n }\n\n public static func uniqueMap(\n _ map: @escaping @Sendable (Input) -> Output, _ outputComparator: OutputComparator\n ) -> Self\n where Self == Pipelines.UniqueFilter, OutputComparator> {\n return .init(map: .init(map), outputComparator: outputComparator)\n }\n\n}\n\nextension PipelineType {\n\n /**\n For Changes input\n Produces output values using KeyPath-based projection.\n\n exactly same with ``PipelineType/select(_:)``\n */\n public static func map(\n _ selector: @escaping @Sendable (\n borrowing Input\n ) -> Output\n ) -> Self\n where Output: Equatable, Self == Pipelines.ChangesSelectPipeline {\n self.init(selector: selector, additionalDropCondition: nil)\n }\n\n /**\n For Changes input\n Produces output values using KeyPath-based projection.\n\n exactly same with ``PipelineType/select(_:)``\n */\n public static func map(\n _ selector: @escaping @Sendable (\n borrowing Input\n ) -> Output\n ) -> Self\n where Self == Pipelines.ChangesSelectPassthroughPipeline {\n self.init(selector: selector)\n }\n\n /**\n For Changes input\n Produces output values using closure based projection.\n\n exactly same with ``PipelineType/map(_:)-7xvom``\n */\n // needs this overload as making closure from keyPath will not make sendable closure.\n public static func map(\n _ selector: KeyPath & Sendable\n ) -> Self\n where Output: Equatable, Self == Pipelines.ChangesSelectPipeline {\n self.init(selector: { $0[keyPath: selector] }, additionalDropCondition: nil)\n }\n\n /**\n For Changes input\n Produces output values using closure based projection.\n\n exactly same with ``PipelineType/map(_:)-7xvom``\n */\n public static func select(\n _ selector: KeyPath & Sendable\n ) -> Self\n where Output: Equatable, Self == Pipelines.ChangesSelectPipeline {\n self.init(selector: { $0[keyPath: selector] }, additionalDropCondition: nil)\n }\n \n /**\n For Changes input\n Produces output values using closure based projection.\n \n exactly same with ``PipelineType/map(_:)-7xvom``\n */\n public static func select(\n _ selector: KeyPath & Sendable\n ) -> Self\n where Self == Pipelines.ChangesSelectPassthroughPipeline {\n self.init(selector: { $0[keyPath: selector] })\n }\n \n}\n\nextension PipelineType {\n\n /**\n For Changes input\n Produces output values using closure-based projection.\n `map` closure takes the value projected from `using` closure which is intermediate value.\n If the intermediate value is not changed, map closure won't perform.\n\n - Parameters:\n - using: Specifies values for transforming. This function is annotated ``PipelineIntermediateBuilder``\n - transform: Transforms the given value from `using` function\n\n ```swift\n `.map(using: { $0.a; $0.b;}, transform: { a, b in ... }`\n ```\n\n */\n public static func map(\n @PipelineIntermediateBuilder using intermediate: @escaping @Sendable (\n Input\n ) -> PipelineIntermediate,\n transform: @escaping @Sendable (Intermediate) -> Output\n ) -> Self\n where\n Input: Equatable, Output: Equatable,\n Self == Pipelines.ChangesMapPipeline\n {\n\n self.init(\n intermediate: intermediate,\n transform: transform,\n additionalDropCondition: nil\n )\n }\n\n /**\n For Changes input\n Produces output values using closure-based projection.\n Using Edge as intermediate, output value will be unwrapped value from the Edge.\n */\n public static func map(\n @PipelineIntermediateBuilder using intermediate: @escaping @Sendable (Input) ->\n PipelineIntermediate>\n ) -> Self\n where\n Input: Equatable, Output: Equatable,\n Self == Pipelines.ChangesMapPipeline, EdgeIntermediate>\n {\n\n self.init(\n intermediate: intermediate,\n transform: { $0.wrappedValue },\n additionalDropCondition: nil\n )\n }\n\n}\n\npublic struct PipelineIntermediate: Equatable {\n\n public static func == (lhs: Self, rhs: Self) -> Bool {\n lhs.comparer(lhs.value, rhs.value)\n }\n\n public var value: T\n public let comparer: ((T, T) -> Bool)\n\n @inlinable\n public init(value: T, comparer: @escaping (T, T) -> Bool) {\n self.value = value\n self.comparer = comparer\n }\n\n @inlinable\n public init(value: T) where T: Equatable {\n self.value = value\n self.comparer = (==) // this won't be called\n }\n\n}\n\nextension PipelineIntermediate where T: Equatable {\n\n public static func == (lhs: Self, rhs: Self) -> Bool {\n lhs.value == rhs.value\n }\n\n}\n\n/// A result-builder that builds ``PipelineIntermediate``.\n/// It converts tuple into ``PipelineIntermediate`` implementing Equatable.\n///\n/// projects:\n/// ```\n/// {\n/// $0.a\n/// $0.b\n/// }\n///\n/// // alternative syntax.\n/// { $0.a; $0.b; }\n/// ```\n///\n/// into:\n/// ```\n/// PipelineIntermediate<(A, B)>\n/// ```\n@resultBuilder\npublic enum PipelineIntermediateBuilder {\n\n public static func buildBlock(_ i: PipelineIntermediate)\n -> PipelineIntermediate\n {\n return i\n }\n\n public static func buildBlock(_ s1: S1) -> PipelineIntermediate {\n .init(value: s1)\n }\n\n public static func buildBlock(_ s1: S1, _ s2: S2)\n -> PipelineIntermediate<(S1, S2)>\n {\n .init(value: (s1, s2), comparer: ==)\n }\n\n public static func buildBlock(\n _ s1: S1, _ s2: S2, _ s3: S3\n ) -> PipelineIntermediate<(S1, S2, S3)> {\n .init(value: (s1, s2, s3), comparer: ==)\n }\n\n public static func buildBlock(\n _ s1: S1, _ s2: S2, _ s3: S3, _ s4: S4\n ) -> PipelineIntermediate<(S1, S2, S3, S4)> {\n .init(value: (s1, s2, s3, s4), comparer: ==)\n }\n\n public static func buildBlock<\n S1: Equatable, S2: Equatable, S3: Equatable, S4: Equatable, S5: Equatable\n >(_ s1: S1, _ s2: S2, _ s3: S3, _ s4: S4, _ s5: S5) -> PipelineIntermediate<(S1, S2, S3, S4, S5)>\n {\n .init(value: (s1, s2, s3, s4, s5), comparer: ==)\n }\n\n public static func buildBlock<\n S1: Equatable, S2: Equatable, S3: Equatable, S4: Equatable, S5: Equatable, S6: Equatable\n >(_ s1: S1, _ s2: S2, _ s3: S3, _ s4: S4, _ s5: S5, _ s6: S6) -> PipelineIntermediate<\n (S1, S2, S3, S4, S5, S6)\n > {\n .init(value: (s1, s2, s3, s4, s5, s6), comparer: ==)\n }\n}\n" }, { "path": "Sources/Verge/Store/Scan.swift", "content": "//\n// Copyright (c) 2020 Hiroshi Kimura(Muukii) \n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\nimport Foundation\n\npublic final class Scan: Sendable {\n\n public typealias Accumulator = @Sendable (inout Accumulate, Element) -> Void\n\n public var value: Accumulate {\n _value.value\n }\n\n private let _value: VergeConcurrency.UnfairLockAtomic\n private let _accumulator: Accumulator\n\n public init(seed: Accumulate, accumulator: @escaping Accumulator) {\n self._value = .init(seed)\n self._accumulator = accumulator\n }\n\n public func accumulate(_ element: Element) -> Accumulate {\n _value.modify { _v -> Accumulate in\n _accumulator(&_v, element)\n return _v\n }\n }\n\n}\n\nextension Scan {\n\n /// A Scan instance that increments itself integer value each event received\n public static func counter() -> Scan {\n .init(seed: 0, accumulator: { n, _ in n += 1 })\n }\n\n}\n" }, { "path": "Sources/Verge/Store/StateType.swift", "content": "//\n// Copyright (c) 2019 muukii\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\nimport Foundation\nimport StateStruct\n\n/**\n An opt-in protocol that indicates it's used as a state of the State.\n */\npublic protocol StateType {\n\n /**\n A chance of modifying state alongside the commit.\n You may use this to make another value that consists of the state's self.\n It's better to use it for better performance to get the value rather than using computed property.\n */\n @Sendable\n static func reduce(\n modifying: inout Self,\n transaction: inout Transaction,\n current: Changes\n )\n}\n" }, { "path": "Sources/Verge/Store/Store+Combine.swift", "content": "//\n// Copyright (c) 2019 muukii\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\nimport Combine\n\n@available(iOS 13, macOS 10.15, tvOS 13, watchOS 6, *)\nextension Store {\n\n /// A publisher that repeatedly emits the changes when state updated\n ///\n /// Guarantees to emit the first event on started subscribing.\n ///\n /// - Parameter startsFromInitial: Make the first changes object's hasChanges always return true.\n /// - Returns:\n @_spi(Package)\n public func _statePublisher() -> some Combine.Publisher, Never> {\n\n return\n publisher\n .associate(resource: self, retains: keepsAliveForSubscribers)\n .flatMap { event in\n guard case .state(.didUpdate(let state)) = event else {\n return Empty, Never>().eraseToAnyPublisher()\n }\n return Just>(state)\n .eraseToAnyPublisher()\n }\n .merge(with: Just(state.droppedPrevious()))\n\n }\n\n // @_spi(Package)\n public func _activityPublisher() -> some Combine.Publisher {\n\n return\n publisher\n .associate(resource: self, retains: keepsAliveForSubscribers)\n .flatMap { event in\n guard case .activity(let a) = event else {\n return Empty().eraseToAnyPublisher()\n }\n return Just(a).eraseToAnyPublisher()\n }\n }\n\n}\n\nextension Publisher {\n\n func associate(resource: AnyObject, retains: Bool) -> some Publisher {\n\n let box = ResourceBox(object: resource, retains: retains)\n\n return handleEvents(receiveCancel: {\n // retain self until subscription finsihed\n withExtendedLifetime(box) {}\n })\n }\n\n}\n\nprivate final class ResourceBox {\n\n private let object: AnyObject?\n\n init(object: AnyObject, retains: Bool) {\n if retains {\n self.object = object\n } else {\n self.object = nil\n }\n }\n}\n" }, { "path": "Sources/Verge/Store/Store+RunLoop.swift", "content": "import Foundation\n\nextension Store {\n\n /// Push an event to run event loop.\n public func updateMainLoop() {\n RunLoop.main.perform(inModes: [.common]) {}\n }\n\n /**\n Subscribes state updates in given run-loop.\n */\n @MainActor\n public func pollMainLoop(receive: @escaping @MainActor (Changes) -> Void) -> VergeAnyCancellable {\n\n var latestState: Changes? = nil\n\n let subscription = RunLoopActivityObserver.addObserver(acitivity: .beforeWaiting, in: .main) {\n\n MainActor.assumeIsolated {\n let newState = self.state\n\n guard (latestState?.version ?? 0) < newState.version else {\n return\n }\n\n let state: Changes\n\n if let latestState {\n state = newState.replacePrevious(latestState)\n } else {\n state = newState.droppedPrevious()\n }\n\n latestState = newState\n\n receive(state)\n }\n\n }\n\n let firstState = state.droppedPrevious()\n\n latestState = firstState\n\n receive(firstState)\n\n return .init {\n RunLoopActivityObserver.remove(subscription)\n }\n }\n\n}\n\nenum RunLoopActivityObserver {\n\n struct Subscription {\n let mode: CFRunLoopMode\n let observer: CFRunLoopObserver?\n weak var targetRunLoop: RunLoop?\n }\n\n static func addObserver(acitivity: CFRunLoopActivity, in runLoop: RunLoop, callback: @escaping () -> Void) -> Subscription {\n\n let o = CFRunLoopObserverCreateWithHandler(kCFAllocatorDefault, acitivity.rawValue, true, Int.max, { observer, activity in\n callback()\n });\n\n assert(o != nil)\n\n let mode = CFRunLoopMode.commonModes!\n let cfRunLoop = runLoop.getCFRunLoop()\n\n CFRunLoopAddObserver(cfRunLoop, o, mode);\n\n return .init(mode: mode, observer: o, targetRunLoop: runLoop)\n }\n\n static func remove(_ subscription: consuming Subscription) {\n\n guard let observer = subscription.observer, let targetRunLoop = subscription.targetRunLoop else {\n return\n }\n\n CFRunLoopRemoveObserver(targetRunLoop.getCFRunLoop(), observer, subscription.mode);\n }\n\n}\n\n#if DEBUG && canImport(SwiftUI)\nimport SwiftUI\n\n#Preview {\n Content()\n}\n\n@Tracking\nprivate struct StoreState {\n var count: Int = 0\n}\n\nprivate struct Content: View {\n\n let store = Store<_, Never>(initialState: StoreState())\n\n @State var subscription: VergeAnyCancellable?\n @State var timer: Timer?\n\n var body: some View {\n VStack {\n Button(\"Up\") {\n store.commit {\n $0.count += 1\n }\n }\n Button(\"Background Up\") {\n\n for _ in 0..<10 {\n store.commit {\n $0.count += 1\n }\n }\n\n }\n Button(\"Run\") {\n RunLoop.main.run(until: Date(timeIntervalSinceNow: 19))\n }\n }\n .onAppear {\n subscription = store.pollMainLoop { state in\n print(state.count)\n }\n }\n }\n\n}\n#endif\n\n" }, { "path": "Sources/Verge/Store/Store.swift", "content": "//\n// Copyright (c) 2019 muukii\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\nimport Atomics\nimport ConcurrencyTaskManager\nimport Foundation\nimport os.log\nimport StateStruct\n\n#if canImport(Combine)\n import Combine\n#endif\n\n/// A protocol that indicates itself is a reference-type and can convert to concrete Store type.\npublic protocol StoreType: AnyObject, Sendable {\n associatedtype State\n associatedtype Activity: Sendable = Never\n\n func asStore() -> Store\n\n var state: Changes { get }\n \n func lock()\n func unlock()\n}\n\npublic typealias NoActivityStoreBase = Store\n\nprivate let sanitizerQueue = DispatchQueue.init(label: \"org.vergegroup.verge.sanitizer\")\n\npublic enum _StoreEvent: EventEmitterEventType {\n\n public enum StateEvent {\n case willUpdate\n case didUpdate(Changes)\n }\n\n case state(StateEvent)\n case activity(Activity)\n case waiter(() -> Void)\n\n public func onComsume() {\n switch self {\n case .state:\n break\n case .activity:\n break\n case .waiter(let closure):\n closure()\n }\n }\n}\n\nactor Writer {\n\n init() {\n\n }\n\n func perform(_ operation: () throws -> sending R) rethrows -> sending R {\n try operation()\n }\n\n}\n\n/// An object that retains a latest state value and receives mutations that modify itself state.\n/// Those updates would be shared all of the subscribers these are sink(s), Derived(s)\n///\n/// You may create subclass of VergeDefaultStore\n/// ```\n/// final class MyStore: Store {\n/// init() {\n/// super.init(initialState: .init(), logger: nil)\n/// }\n/// }\n/// ```\n/// You may use also `StoreWrapperType` to define State and Activity as inner types.\n///\nopen class Store: EventEmitter<_StoreEvent>,\n CustomReflectable,\n StoreType,\n StoreDriverType,\n DerivedMaking,\n @unchecked Sendable,\n Hashable\n{\n \n // MARK: Equatable\n public static func == (lhs: Store, rhs: Store) -> Bool {\n lhs === rhs\n }\n\n // MARK: Hashable \n public func hash(into hasher: inout Hasher) {\n hasher.combine(ObjectIdentifier(self))\n }\n \n public let scope: any WritableKeyPath & Sendable = \\State.self\n\n private let tracker = VergeConcurrency.SynchronizationTracker()\n\n /// A name of the store.\n /// Specified or generated automatically from file and line.\n public let name: String\n\n public let logger: StoreLogger?\n\n public let sanitizer: RuntimeSanitizer\n\n private var middlewares: [AnyStoreMiddleware] = []\n\n private let externalOperation: @Sendable (inout InoutRef, Changes, inout Transaction) -> Void\n\n private(set) var nonatomicValue: Changes\n\n private let _lock: StoreOperation\n\n /**\n Holds subscriptions for sink State and Activity to finish them with its store life-cycle.\n */\n private let storeLifeCycleCancellable: VergeAnyCancellable = .init()\n\n open var keepsAliveForSubscribers: Bool { false }\n\n private let wasInvalidated = Atomics.ManagedAtomic(false)\n \n // MARK: - Deinit\n\n deinit {\n invalidate()\n }\n\n // MARK: - Task\n\n public let taskManager: TaskManager = .init()\n\n let writer: Writer = .init()\n\n // MARK: - Initializers\n\n /// An initializer\n /// - Parameters:\n /// - initialState: A state instance that will be modified by the first commit.\n /// - backingStorageRecursiveLock: A lock instance for mutual exclusion.\n /// - logger: You can also use `DefaultLogger.shared`.\n public nonisolated init(\n name: String? = nil,\n initialState: State,\n storeOperation: StoreOperation = .atomic,\n logger: StoreLogger? = nil,\n sanitizer: RuntimeSanitizer? = nil,\n _ file: StaticString = #file,\n _ line: UInt = #line\n ) {\n\n self.nonatomicValue = .init(old: nil, new: initialState)\n self._lock = storeOperation\n\n self.logger = logger\n self.sanitizer = sanitizer ?? RuntimeSanitizer.global\n self.name = name ?? \"\\(file):\\(line)\"\n self.externalOperation = { @Sendable _, _, _ in }\n\n super.init()\n }\n\n public nonisolated init(\n name: String? = nil,\n initialState: State,\n storeOperation: StoreOperation = .atomic,\n logger: StoreLogger? = nil,\n sanitizer: RuntimeSanitizer? = nil,\n _ file: StaticString = #file,\n _ line: UInt = #line\n ) where State: StateType {\n\n // making reduced state\n var _initialState = initialState\n\n let reduced = withUnsafeMutablePointer(to: &_initialState) { pointer in\n var inoutRef = InoutRef<_>.init(pointer)\n inoutRef.modify { state in\n var transaction = Transaction()\n State.reduce(modifying: &state, transaction: &transaction, current: .init(old: nil, new: initialState))\n }\n return inoutRef.wrapped\n }\n\n self.nonatomicValue = .init(old: nil, new: reduced)\n self._lock = storeOperation\n\n self.logger = logger\n self.sanitizer = sanitizer ?? RuntimeSanitizer.global\n self.name = name ?? \"\\(file):\\(line)\"\n \n self.externalOperation = { @Sendable inoutRef, state, transaction in\n let intermediate = state.makeNextChanges(\n with: inoutRef.wrapped,\n modification: inoutRef.modification,\n transaction: transaction\n )\n inoutRef.modify { state in\n State.reduce(\n modifying: &state,\n transaction: &transaction,\n current: intermediate\n )\n }\n }\n\n super.init()\n }\n\n @_spi(Internal)\n public final override func receiveEvent(_ event: consuming _StoreEvent) {\n\n switch event {\n case .state(let stateEvent):\n switch stateEvent {\n case .willUpdate:\n break\n case .didUpdate(let state):\n stateDidUpdate(newState: state)\n }\n case .activity:\n break\n case .waiter:\n break\n }\n }\n\n open func stateDidUpdate(newState: Changes) {\n \n }\n\n final func invalidate() {\n guard\n wasInvalidated.compareExchange(expected: false, desired: true, ordering: .relaxed).exchanged\n else {\n // already invalidated\n return\n }\n performInvalidation()\n }\n\n func performInvalidation() {\n\n storeLifeCycleCancellable.cancel()\n\n taskManager.cancelAll()\n }\n\n}\n\n// MARK: - Typealias\nextension Store {\n\n public typealias Scope = State\n public typealias Value = State\n}\n\n// MARK: - Computed Properties\nextension Store {\n\n public var store: Store { self }\n\n /// Returns a current state with thread-safety.\n ///\n /// It causes locking and unlocking with a bit cost.\n /// It may cause blocking if any other is doing mutation or reading.\n public var state: Changes {\n _lock.lock()\n defer {\n _lock.unlock()\n }\n return nonatomicValue\n }\n\n}\n\n// MARK: - Convenience Initializers\nextension Store {\n\n /// An initializer for preventing using the refence type as a state.\n @available(\n *, deprecated,\n message:\n \"Using the reference type for the state is restricted. it must be a value type to run correctly.\"\n )\n public convenience init(\n name: String? = nil,\n initialState: State,\n storeOperation: StoreOperation = .atomic,\n logger: StoreLogger? = nil,\n _ file: StaticString = #file,\n _ line: UInt = #line\n ) where State: AnyObject {\n\n preconditionFailure(\n \"Using the reference type for the state is restricted. it must be a value type to run correctly.\"\n )\n\n }\n\n}\n\n// MARK: - Wait\nextension Store {\n\n /**\n Commit operation does not mean that emitting latest state for all of subscribers synchronously.\n Updating state of the store will be updated immediately.\n\n To wait until all of the subscribers get the latest state, you can use this method.\n */\n public func waitUntilAllEventConsumed() async {\n await withCheckedContinuation { c in\n accept(\n .waiter({\n c.resume()\n }))\n }\n }\n\n}\n\n// MARK: - Middleware\nextension Store {\n\n /// Registers a middleware.\n /// MIddleware can execute additional operations unified with mutations.\n ///\n public func add(middleware: some StoreMiddlewareType) {\n // use lock\n lock()\n defer {\n unlock()\n }\n middlewares.append(.init(modify: middleware.modify))\n }\n}\n\nextension Store {\n\n // MARK: - CustomReflectable\n public var customMirror: Mirror {\n return Mirror(\n self,\n children: KeyValuePairs.init(\n dictionaryLiteral: (\"stateVersion\", state.version),\n (\"middlewares\", middlewares)\n ),\n displayStyle: .class\n )\n }\n\n @inline(__always)\n public func asStore() -> Store {\n self\n }\n\n /**\n Adds an asynchronous task to perform.\n\n Use this function to perform an asynchronous task with a lifetime that matches that of this store.\n If this store is deallocated ealier than the given task finished, that asynchronous task will be cancelled.\n\n Carefully use this function - If the task retains this store, it will continue to live until the task is finished.\n\n - Parameters:\n - key:\n - mode:\n - priority:\n - action\n - Returns: A Task for tracking given async operation's completion.\n */\n @discardableResult\n public func task(\n key: ConcurrencyTaskManager.TaskKey = .distinct(),\n mode: ConcurrencyTaskManager.TaskManager.Mode = .dropCurrent,\n priority: TaskPriority = .userInitiated,\n @_inheritActorContext _ action: @Sendable @escaping () async throws -> Return\n ) -> Task {\n return taskManager.task(key: key, mode: mode, priority: priority, action)\n }\n\n /**\n Adds an asynchronous task to perform.\n\n Use this function to perform an asynchronous task with a lifetime that matches that of this store.\n If this store is deallocated ealier than the given task finished, that asynchronous task will be cancelled.\n\n Carefully use this function - If the task retains this store, it will continue to live until the task is finished.\n\n - Parameters:\n - key:\n - mode:\n - priority:\n - action\n - Returns: A Task for tracking given async operation's completion.\n */\n @discardableResult\n public func taskDetached(\n key: ConcurrencyTaskManager.TaskKey = .distinct(),\n mode: ConcurrencyTaskManager.TaskManager.Mode = .dropCurrent,\n priority: TaskPriority = .userInitiated,\n _ action: @Sendable @escaping () async throws -> Return\n ) -> Task {\n return taskManager.taskDetached(key: key, mode: mode, priority: priority, action) \n }\n\n // MARK: - Internal\n\n /// Receives mutation\n ///\n /// - Parameters:\n /// - mutation: (`inout` attributes to prevent escaping `Inout` inside the closure.)\n @inline(__always)\n func _receive_sending(\n mutation: (inout State, inout Transaction) throws -> Result\n ) rethrows -> Result {\n\n let signpost = VergeSignpostTransaction(\"Store.commit\")\n defer {\n signpost.end()\n }\n\n let warnings: Set\n if RuntimeSanitizer.global.isRecursivelyCommitDetectionEnabled {\n warnings = tracker.register()\n } else {\n warnings = .init()\n }\n\n defer {\n if RuntimeSanitizer.global.isRecursivelyCommitDetectionEnabled {\n tracker.unregister()\n }\n }\n\n var valueFromMutation: Result!\n var elapsed: CFTimeInterval = 0\n var commitLog: CommitLog?\n\n let __sanitizer__ = sanitizer\n\n /** a ciritical session */\n try _update { (state) -> UpdateResult in\n \n let startedTime = CFAbsoluteTimeGetCurrent()\n defer {\n elapsed = CFAbsoluteTimeGetCurrent() - startedTime\n }\n\n var modifying = state.primitive\n \n // TODO: better performant way\n if var trackingObject = modifying as? TrackingObject {\n trackingObject.startNewTracking()\n modifying = trackingObject as! State\n }\n\n let updateResult = try withUnsafeMutablePointer(to: &modifying) {\n (stateMutablePointer) -> UpdateResult in\n\n var transaction = Transaction()\n \n var inoutRef = InoutRef<_>.init(stateMutablePointer)\n \n let result = try inoutRef.modify { modifying in \n try mutation(&modifying, &transaction)\n }\n\n valueFromMutation = consume result\n\n /**\n Step-1:\n Checks if the state has been modified\n */\n guard inoutRef.hasModified else { \n // No emits update event\n// Log.storeCommit.debug(\"\\(type(of: self)) No updates\")\n return .nothingUpdates\n }\n\n /**\n Step-2:\n Reduce modifying state with externalOperation\n */\n\n externalOperation(&inoutRef, state, &transaction)\n\n /**\n Step-3\n Applying by middlewares\n */\n self.middlewares.forEach { middleware in\n\n let intermediate = state.makeNextChanges(\n with: stateMutablePointer.pointee,\n modification: inoutRef.modification,\n transaction: transaction\n )\n inoutRef.modify { modifying in \n middleware.modify(\n modifyingState: &modifying,\n transaction: &transaction,\n current: intermediate\n )\n }\n }\n\n /**\n Make a new state\n */\n state = state.makeNextChanges(\n with: stateMutablePointer.pointee,\n modification: inoutRef.modification,\n transaction: transaction\n )\n\n commitLog = CommitLog(storeName: self.name, traces: transaction.traces, time: elapsed)\n\n return .updated\n }\n\n return updateResult\n\n }\n\n if let logger = logger, let _commitLog = commitLog {\n logger.didCommit(log: _commitLog, sender: self)\n }\n\n return UnsafeSendableStruct(valueFromMutation).send()\n }\n\n @inline(__always)\n func _send(\n activity: Activity,\n trace: ActivityTrace\n ) {\n\n accept(.activity(activity))\n\n let log = ActivityLog(storeName: self.name, trace: trace)\n logger?.didSendActivity(log: log, sender: self)\n }\n\n func _mainActor_sinkState(\n keepsAliveSource: Bool? = nil,\n dropsFirst: Bool = false,\n queue: some MainActorTargetQueueType,\n receive: @escaping @MainActor (Changes) -> Void\n ) -> StoreStateSubscription {\n return _primitive_sinkState(\n dropsFirst: dropsFirst,\n queue: Queues.MainActor(queue),\n receive: { e in\n MainActor.assumeIsolated {\n receive(e)\n }\n }\n )\n }\n\n func _primitive_sinkState(\n dropsFirst: Bool = false,\n queue: some TargetQueueType,\n receive: @escaping @Sendable (Changes) -> Void\n ) -> StoreStateSubscription {\n\n let cancellable = _base_primitive_sinkState(\n dropsFirst: dropsFirst,\n queue: queue,\n receive: receive\n )\n\n if keepsAliveForSubscribers {\n return .init(cancellable, storeCancellable: storeLifeCycleCancellable)\n .associate(store: self) // while subscribing its Store will be alive\n } else {\n return .init(cancellable, storeCancellable: storeLifeCycleCancellable)\n }\n\n }\n\n private func _base_primitive_sinkState(\n dropsFirst: Bool = false,\n queue: some TargetQueueType,\n receive: @escaping @Sendable (Changes) -> Void\n ) -> EventEmitterCancellable {\n\n let executor = queue.execute\n\n nonisolated(unsafe)\n var latestStateWrapper: Changes? = nil\n\n let __sanitizer__ = sanitizer\n\n let lock = VergeConcurrency.UnfairLock()\n\n /// Firstly, it registers a closure to make sure that it receives all of the updates, even updates inside the first call.\n /// To get recursive updates that comes from first call receive closure.\n let cancellable = _sinkStateEvent { (event) in\n switch event {\n case .willUpdate:\n break\n case .didUpdate(let receivedState):\n\n executor {\n\n lock.lock()\n\n var resolvedReceivedState = receivedState\n\n // To escaping from critical issue\n if let latestState = latestStateWrapper {\n if latestState.version <= receivedState.version {\n /*\n No issues case:\n It has received newer version than previous version\n */\n latestStateWrapper = receivedState\n } else {\n\n /*\n Serious problem case:\n Received an older version than the state received before.\n To recover this case, send latest version state with dropping previous value in order to make `ifChanged` returns always true.\n */\n resolvedReceivedState = latestState.droppedPrevious()\n\n if __sanitizer__.isSanitizerStateReceivingByCorrectOrder {\n\n sanitizerQueue.async {\n __sanitizer__.onDidFindRuntimeError(\n .recoveredStateFromReceivingOlderVersion(\n latestState: latestState,\n receivedState: receivedState\n )\n )\n\n Log.store.warning(\n \"\"\"\n ⚠️ [Verge Error] Received older version(\\(receivedState.version)) value rather than latest received version(\\(latestState.version)).\n \n The root cause might be from the following things:\n - Committed concurrently from multiple threads.\n \n To solve, make sure to commit in series, for example using DispatchQueue.\n \n Verge can't use a lock to process serially because the dead-lock will happen in some of the cases.\n RxSwift's BehaviorSubject takes the same deal.\n \n Regarding: Extra commit was dispatched inside sink synchronously\n This issue has been fixed by https://github.com/VergeGroup/Verge/pull/222\n ---\n \n Received older version (\\(receivedState.version)): (\\(String(describing: receivedState.traces)))\n \n Latest Version (\\(latestState.version)): (\\(String(describing: latestState.traces)))\n \n ===\n \"\"\"\n )\n \n }\n }\n }\n\n } else {\n // first item\n latestStateWrapper = receivedState\n }\n\n lock.unlock()\n\n receive(resolvedReceivedState)\n }\n }\n }\n\n if !dropsFirst {\n\n let value = state.droppedPrevious()\n\n executor {\n lock.lock()\n latestStateWrapper = value\n lock.unlock()\n // this closure might contains some mutations.\n // It depends outside usages.\n receive(value)\n }\n }\n\n return cancellable\n }\n\n func _mainActor_scan_sinkState(\n scan: Scan, Accumulate>,\n dropsFirst: Bool = false,\n queue: some MainActorTargetQueueType,\n receive: @escaping @MainActor (Changes, Accumulate) -> Void\n ) -> StoreStateSubscription {\n\n _mainActor_sinkState(dropsFirst: dropsFirst, queue: queue) { (changes) in\n\n let accumulate = scan.accumulate(changes)\n receive(changes, accumulate)\n }\n\n }\n\n func _primitive_scan_sinkState(\n scan: Scan, Accumulate>,\n dropsFirst: Bool = false,\n queue: some TargetQueueType,\n receive: @escaping @Sendable (Changes, Accumulate) -> Void\n ) -> StoreStateSubscription {\n\n _primitive_sinkState(dropsFirst: dropsFirst, queue: queue) { (changes) in\n\n let accumulate = scan.accumulate(changes)\n receive(changes, accumulate)\n }\n\n }\n\n func _mainActor_sinkActivity(\n queue: some MainActorTargetQueueType,\n receive: @escaping @MainActor (sending Activity) -> Void\n ) -> StoreActivitySubscription {\n return _primitive_sinkActivity(\n queue: Queues.MainActor(queue),\n receive: { e in\n MainActor.assumeIsolated {\n receive(e)\n }\n }\n )\n }\n\n func _primitive_sinkActivity(\n queue: some TargetQueueType,\n receive: @escaping @Sendable (sending Activity) -> Void\n ) -> StoreActivitySubscription {\n\n let execute = queue.execute\n let cancellable = self._sinkActivityEvent { activity in\n execute {\n receive(activity)\n }\n }\n\n return .init(cancellable, storeCancellable: storeLifeCycleCancellable)\n\n }\n\n}\n\n// MARK: - Storage Implementation\nextension Store {\n\n public func lock() {\n _lock.lock()\n }\n\n public func unlock() {\n _lock.unlock()\n }\n\n final func _sinkStateEvent(\n subscriber: @escaping (_StoreEvent.StateEvent) -> Void\n ) -> EventEmitterCancellable {\n addEventHandler { event in\n guard case .state(let stateEvent) = event else { return }\n subscriber(stateEvent)\n }\n }\n\n final func _sinkActivityEvent(subscriber: @escaping (sending Activity) -> Void)\n -> EventEmitterCancellable\n {\n addEventHandler { event in\n guard case .activity(let activity) = event else { return }\n subscriber(activity)\n }\n }\n\n enum UpdateResult {\n case updated\n case nothingUpdates\n }\n\n @inline(__always)\n final func _update(_ update: (inout Changes) throws -> UpdateResult) rethrows {\n\n let signpost = VergeSignpostTransaction(\"Storage.update\")\n defer {\n signpost.end()\n }\n\n lock()\n do {\n\n let result = try update(&nonatomicValue)\n\n switch result {\n case .nothingUpdates:\n unlock()\n case .updated:\n let afterValue = nonatomicValue\n\n /**\n Unlocks lock before emitting event to avoid dead-locking.\n But it causes cracking the order of event.\n SeeAlso: testOrderOfEvents\n */\n unlock()\n\n // it's not actual `will` 👨🏻❓\n accept(.state(.willUpdate))\n accept(.state(.didUpdate(afterValue)))\n\n }\n\n } catch {\n unlock()\n throw error\n }\n }\n\n}\n\nextension Store {\n\n /// [Experimental]\n public func stateStream() -> AsyncStream> {\n return .init(Changes.self, bufferingPolicy: .unbounded) { continuation in\n\n let subscription = self.sinkState(queue: .passthrough) { state in\n continuation.yield(state)\n }\n\n continuation.onTermination = { termination in\n subscription.cancel()\n }\n\n }\n }\n\n}\n" }, { "path": "Sources/Verge/Store/StoreDriverType+Accumulator.swift", "content": "import StateStruct\n\nextension StoreDriverType where TargetStore.State : TrackingObject {\n \n /**\n Subscribes states and accumulates into components.\n Against sink method, it does not use Changes object.\n It allows to check if values has changed in the unit of accumulation, not Changes view.\n */\n public func accumulate(\n queue: some MainActorTargetQueueType = .mainIsolated(),\n @AccumulationSinkComponentBuilder _ buildSubscription: @escaping @MainActor (consuming AccumulationBuilder) -> _AccumulationSinkGroup\n ) -> StoreStateSubscription {\n\n var previousBox: ReferenceEdge<_AccumulationSinkGroup?> = .init(wrappedValue: nil)\n \n let scope = self.scope\n \n return store.asStore().sinkState(dropsFirst: false, queue: queue) { state in\n \n let builder = AccumulationBuilder(previousLoader: {\n previousBox.wrappedValue\n })\n\n var group = buildSubscription(consume builder)\n \n // sets the previous value\n if let previous = previousBox.wrappedValue {\n group = group.receive(previous: previous)\n }\n \n // sets the latest value\n group = group.receive(\n source: { state.primitive.tracked()[keyPath: scope] },\n modification: state.modification ?? .indeterminate\n )\n \n // runs sink\n group = group.consume()\n\n previousBox.wrappedValue = group\n\n }\n\n }\n\n /**\n Subscribes states and accumulates into components.\n Against sink method, it does not use Changes object.\n It allows to check if values has changed in the unit of accumulation, not Changes view.\n */\n @_disfavoredOverload\n public func accumulate(\n queue: some TargetQueueType,\n @AccumulationSinkComponentBuilder _ buildSubscription: @escaping @Sendable (consuming AccumulationBuilder) -> _AccumulationSinkGroup\n ) -> StoreStateSubscription {\n\n let previousBox: UnsafeSendableClass?>> = .init(\n .init(wrappedValue: nil)\n )\n let lock = VergeConcurrency.UnfairLock()\n \n let scope = self.scope\n\n return store.asStore().sinkState(dropsFirst: false, queue: queue) { @Sendable state in\n\n lock.lock()\n defer {\n lock.unlock()\n }\n\n withUncheckedSendable {\n\n let builder = AccumulationBuilder(previousLoader: {\n previousBox.value.wrappedValue\n })\n\n var group = buildSubscription(consume builder)\n\n // sets the previous value\n if let previous = previousBox.value.wrappedValue {\n group = group.receive(previous: previous)\n }\n \n // sets the latest value\n group = group.receive(\n source: { state.primitive.tracked()[keyPath: scope] },\n modification: state.modification ?? .indeterminate\n )\n \n // runs sink\n group = group.consume()\n\n previousBox.value.wrappedValue = group\n\n }\n }\n\n }\n\n}\n\npublic protocol AccumulationSink {\n associatedtype Source\n consuming func receive(source: () -> Source, modification: Modification) -> Self\n consuming func receive(previous: consuming Self) -> Self\n consuming func consume() -> Self\n}\n\npublic struct AccumulationBuilder: ~Copyable {\n\n public var previous: (any AccumulationSink)? {\n previousLoader()\n }\n\n private let previousLoader: () -> (any AccumulationSink)?\n\n init(previousLoader: @escaping () -> (any AccumulationSink)?) {\n self.previousLoader = previousLoader\n }\n\n public func ifChanged(_ selector: @escaping (borrowing Source) -> Value) -> AccumulationSinkIfChanged {\n .init(\n selector: selector\n )\n }\n \n}\n\npublic struct AccumulationSinkIfChanged: AccumulationSink {\n\n private let selector: (borrowing Source) -> Target\n\n private var latestValue: Target?\n private var previousValue: Target?\n private var readingGraph: PropertyNode?\n private var source: Source?\n\n private var counter: UInt64 = 0\n private var countToEmit: UInt64 = 0\n\n private var handlerWithSelectedValue: ((consuming Target) -> Void)?\n private var handlerWithSource: ((Source) -> Void)?\n\n init(\n selector: @escaping (borrowing Source) -> Target\n ) {\n self.selector = selector\n }\n\n public consuming func dropFirst(_ k: UInt64 = 1) -> Self {\n countToEmit = k\n return self\n }\n\n /**\n the closure will be released after consumed.\n */\n public consuming func `do`(@_inheritActorContext @_implicitSelfCapture _ perform: @escaping (consuming Target) -> Void) -> Self {\n self.handlerWithSelectedValue = perform\n return self\n }\n \n public consuming func `doWithSource`(@_inheritActorContext @_implicitSelfCapture _ perform: @escaping (Source) -> Void) -> Self {\n self.handlerWithSource = perform\n return self\n }\n\n public consuming func receive(\n source: () -> Source,\n modification: Modification\n ) -> Self {\n \n switch modification {\n case .graph(let propertyNode):\n \n guard let readingGraph, \n PropertyNode.hasChanges(\n writeGraph: propertyNode,\n readGraph: readingGraph\n ) else {\n // no changes\n \n self.latestValue = self.previousValue \n \n return self\n }\n \n break\n case .indeterminate:\n \n break\n \n }\n \n let tracked = source()\n \n self.latestValue = selector(tracked)\n \n self.readingGraph = tracked.trackingResult?.graph\n \n tracked.endTracking()\n \n if handlerWithSource != nil {\n self.source = tracked\n }\n \n return self\n \n }\n\n public consuming func receive(previous: consuming Self) -> Self {\n\n self.previousValue = previous.latestValue\n self.readingGraph = previous.readingGraph\n self.counter = previous.counter\n\n return self\n }\n\n public consuming func consume() -> Self {\n\n if latestValue != previousValue {\n if counter >= countToEmit { \n handlerWithSelectedValue?(latestValue!)\n handlerWithSource?(source!)\n }\n counter &+= 1\n }\n\n self.handlerWithSource = nil\n self.handlerWithSelectedValue = nil\n\n return self\n\n }\n}\n\npublic struct _AccumulationSinkGroup: AccumulationSink {\n\n private var component: Component\n private var _receiveSource: (\n () -> Source,\n Modification,\n Component\n ) -> Component\n private var _receiveOther: (Component, Component) -> Component\n private var _consume: (Component) -> Component\n\n init(\n component: Component,\n receiveSource: @escaping (() -> Source, Modification, Component) -> Component,\n receiveOther: @escaping (Component, Component) -> Component,\n consume: @escaping (Component) -> Component\n ) {\n self.component = component\n self._receiveSource = receiveSource\n self._receiveOther = receiveOther\n self._consume = consume\n }\n\n init() where Component == Void {\n self.component = ()\n self._receiveSource = { _, _, component in component }\n self._receiveOther = { _, component in component }\n self._consume = { component in component }\n }\n\n public consuming func receive(source: () -> Source, modification: Modification) -> Self {\n component = _receiveSource(source, modification, component)\n return self\n }\n\n public consuming func receive(previous: Self) -> Self {\n component = _receiveOther(previous.component, component)\n return self\n }\n\n public consuming func consume() -> Self {\n component = _consume(component)\n return self\n }\n\n}\n\npublic struct _AccumulationSinkCondition: AccumulationSink where TrueComponent.Source == Source, FalseComponent.Source == Source {\n\n private var trueComponent: TrueComponent?\n private var falseComponent: FalseComponent?\n\n init(\n trueComponent: TrueComponent?,\n falseComponent: FalseComponent?\n ) {\n self.trueComponent = trueComponent\n self.falseComponent = falseComponent\n }\n\n public consuming func receive(source: () -> Source, modification: Modification) -> Self {\n if let trueComponent = trueComponent {\n self.trueComponent = trueComponent.receive(source: source, modification: modification)\n } else if let falseComponent = falseComponent {\n self.falseComponent = falseComponent.receive(source: source, modification: modification)\n }\n return self\n }\n\n public consuming func receive(previous: Self) -> Self {\n if let trueComponent = trueComponent, let previousTrueComponent = previous.trueComponent {\n self.trueComponent = trueComponent.receive(previous: previousTrueComponent)\n } else if let falseComponent = falseComponent, let previousFalseComponent = previous.falseComponent {\n self.falseComponent = falseComponent.receive(previous: previousFalseComponent)\n }\n return self\n }\n\n public consuming func consume() -> Self {\n if let trueComponent = trueComponent {\n self.trueComponent = trueComponent.consume()\n } else if let falseComponent = falseComponent {\n self.falseComponent = falseComponent.consume()\n }\n return self\n }\n\n}\n\nstruct _AccumulationSinkOptional: AccumulationSink where Component.Source == Source {\n\n private var component: Component?\n\n init(\n component: Component?\n ) {\n self.component = component\n }\n\n consuming func receive(source: () -> Source, modification: Modification) -> Self {\n if let component = component {\n self.component = component.receive(source: source, modification: modification)\n }\n return self\n }\n\n consuming func receive(previous: Self) -> Self {\n if let component = component, let previousComponent = previous.component {\n self.component = component.receive(previous: previousComponent)\n }\n return self\n }\n\n consuming func consume() -> Self {\n if let component = component {\n self.component = component.consume()\n }\n return self\n }\n\n}\n\n@resultBuilder\npublic struct AccumulationSinkComponentBuilder {\n\n public static func buildExpression(_ expression: S) -> S where S.Source == Source {\n expression\n }\n\n public static func buildBlock() -> some AccumulationSink {\n return _AccumulationSinkGroup()\n }\n\n public static func buildEither(first component: TrueComponent) -> _AccumulationSinkCondition where TrueComponent.Source == Source, FalseComponent.Source == Source {\n\n return _AccumulationSinkCondition(\n trueComponent: component,\n falseComponent: nil\n )\n\n }\n\n public static func buildEither(second component: FalseComponent) -> _AccumulationSinkCondition where TrueComponent.Source == Source, FalseComponent.Source == Source {\n\n return _AccumulationSinkCondition(\n trueComponent: nil,\n falseComponent: component\n )\n }\n\n public static func buildOptional(_ component: Component?) -> some AccumulationSink where Component : AccumulationSink {\n return _AccumulationSinkOptional.init(component: component)\n }\n\n // FIXME: add `where repeat (each S).Source == Source`\n public static func buildBlock(_ sinks: repeat each S) -> _AccumulationSinkGroup {\n\n return _AccumulationSinkGroup(\n component: (repeat each sinks),\n receiveSource: { source, modification, component in\n // Waiting https://www.swift.org/blog/pack-iteration/\n func iterate(_ left: T) -> T {\n return left.receive(\n source: { unsafeBitCast(source(), to: T.Source.self) },\n modification: modification\n )\n }\n\n let modified = (repeat iterate(each component))\n\n return modified\n },\n receiveOther: { other, current in\n // Waiting https://www.swift.org/blog/pack-iteration/\n func iterate(previous: consuming T, current: consuming T) -> T {\n return current.receive(previous: previous)\n }\n\n let modified = (repeat iterate(previous: each other, current: each current))\n\n return modified\n },\n consume: { component in\n // Waiting https://www.swift.org/blog/pack-iteration/\n func iterate(_ component: consuming T) -> T {\n return component.consume()\n }\n\n let modified = (repeat iterate(each component))\n\n return modified\n }\n )\n\n }\n\n}\n\n" }, { "path": "Sources/Verge/Store/StoreDriverType.swift", "content": "//\n// Copyright (c) 2019 muukii\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\nimport Foundation\n\n@available(*, deprecated, renamed: \"StoreDriverType\")\npublic typealias DispatcherType = StoreDriverType\n\n/// A protocol that uses external Store inside and provides the functions.\n/// ```\n/// final class MyViewModel: StoreDriverType {\n///\n/// struct State {\n/// ...\n/// }\n///\n/// // If you don't need Activity, you can remove it.\n/// enum Activity {\n/// ...\n/// }\n///\n/// let store: Store\n///\n/// init() {\n/// self.store = .init(initialState: .init(), logger: nil)\n/// }\n///\n/// }\n/// ```\npublic protocol StoreDriverType: AnyObject where Activity == TargetStore.Activity {\n\n associatedtype TargetStore: StoreType\n\n associatedtype Scope = TargetStore.State\n\n var store: TargetStore { get }\n var scope: WritableKeyPath & Sendable { get }\n\n var state: Changes { get }\n\n // WORKAROUND: for activityPublisher()\n associatedtype Activity: Sendable = TargetStore.Activity\n\n}\n\nextension StoreDriverType {\n\n public func statePublisher() -> some Combine.Publisher, Never> {\n store.asStore()._statePublisher()\n }\n\n public func activityPublisher() -> some Combine.Publisher {\n store.asStore()._activityPublisher()\n }\n\n /// A state that cut out from root-state with the scope key path.\n public nonisolated var state: Changes {\n store.state.map { $0[keyPath: scope] }\n }\n\n public nonisolated var rootState: Changes {\n return store.state\n }\n}\n\nextension StoreDriverType where Scope == TargetStore.State {\n\n public var scope: WritableKeyPath & Sendable {\n \\TargetStore.State.self\n }\n\n // MARK: - Subscribings\n\n /// Subscribe the state changes\n ///\n /// First object always returns true from ifChanged / hasChanges / noChanges unless dropsFirst is true.\n ///\n /// - Parameters:\n /// - dropsFirst: Drops the latest value on started. if true, receive closure will call from next state updated.\n /// - queue: Specify a queue to receive changes object.\n /// - Returns: A subscriber that performs the provided closure upon receiving values.\n public func sinkState(\n dropsFirst: Bool = false,\n queue: some TargetQueueType,\n receive: @escaping @Sendable (Changes) -> Void\n ) -> StoreStateSubscription {\n store.asStore()._primitive_sinkState(dropsFirst: dropsFirst, queue: queue, receive: receive)\n }\n\n /// Subscribe the state changes\n ///\n /// First object always returns true from ifChanged / hasChanges / noChanges unless dropsFirst is true.\n ///\n /// - Parameters:\n /// - dropsFirst: Drops the latest value on started. if true, receive closure will call from next state updated.\n /// - queue: Specify a queue to receive changes object.\n /// - Returns: A subscriber that performs the provided closure upon receiving values.\n public func sinkState(\n dropsFirst: Bool = false,\n queue: some MainActorTargetQueueType = .mainIsolated(),\n receive: @escaping @MainActor (Changes) -> Void\n ) -> StoreStateSubscription {\n store.asStore()._mainActor_sinkState(dropsFirst: dropsFirst, queue: queue, receive: receive)\n }\n\n /// Subscribe the state changes\n ///\n /// First object always returns true from ifChanged / hasChanges / noChanges unless dropsFirst is true.\n ///\n /// - Parameters:\n /// - scan: Accumulates a specified type of value over receiving updates.\n /// - dropsFirst: Drops the latest value on started. if true, receive closure will call from next state updated.\n /// - queue: Specify a queue to receive changes object.\n /// - Returns: A subscriber that performs the provided closure upon receiving values.\n @_disfavoredOverload\n public func sinkState(\n scan: Scan, Accumulate>,\n dropsFirst: Bool = false,\n queue: some TargetQueueType,\n receive: @escaping @Sendable (Changes, Accumulate) -> Void\n ) -> StoreStateSubscription {\n store.asStore()._primitive_scan_sinkState(\n scan: scan,\n dropsFirst: dropsFirst,\n queue: queue,\n receive: receive\n )\n }\n\n /// Subscribe the state changes\n ///\n /// First object always returns true from ifChanged / hasChanges / noChanges unless dropsFirst is true.\n ///\n /// - Parameters:\n /// - scan: Accumulates a specified type of value over receiving updates.\n /// - dropsFirst: Drops the latest value on started. if true, receive closure will call from next state updated.\n /// - queue: Specify a queue to receive changes object.\n /// - Returns: A subscriber that performs the provided closure upon receiving values.\n @discardableResult\n public func sinkState(\n scan: Scan, Accumulate>,\n dropsFirst: Bool = false,\n queue: some MainActorTargetQueueType = .mainIsolated(),\n receive: @escaping @MainActor (Changes, Accumulate) -> Void\n ) -> StoreStateSubscription {\n store.asStore()._mainActor_scan_sinkState(\n scan: scan, dropsFirst: dropsFirst, queue: queue, receive: receive)\n }\n\n /// Subscribe the activity\n ///\n /// - Returns: A subscriber that performs the provided closure upon receiving values.\n @_disfavoredOverload\n public func sinkActivity(\n queue: some TargetQueueType,\n receive: @escaping @Sendable (sending TargetStore.Activity) -> Void\n ) -> StoreActivitySubscription {\n\n store.asStore()._primitive_sinkActivity(queue: queue, receive: receive)\n\n }\n\n /// Subscribe the activity\n ///\n /// - Returns: A subscriber that performs the provided closure upon receiving values.\n public func sinkActivity(\n queue: some MainActorTargetQueueType = .mainIsolated(),\n receive: @escaping @MainActor (sending TargetStore.Activity) -> Void\n ) -> StoreActivitySubscription {\n\n store.asStore()._mainActor_sinkActivity(queue: queue) { activity in\n MainActor.assumeIsolated {\n receive(activity)\n }\n }\n\n }\n\n}\n\nextension StoreDriverType {\n\n /**\n Commit operation does not mean that emitting latest state for all of subscribers synchronously.\n Updating state of the store will be updated immediately.\n\n To wait until all of the subscribers get the latest state, you can use this method.\n */\n public func waitUntilAllEventConsumed() async {\n await store.asStore().waitUntilAllEventConsumed()\n }\n}\n\nextension StoreDriverType {\n\n /**\n Subscribe the state that scoped\n\n First object always returns true from ifChanged / hasChanges / noChanges unless dropsFirst is true.\n\n - Parameters:\n - dropsFirst: Drops the latest value on started. if true, receive closure will call from next state updated.\n - queue: Specify a queue to receive changes object.\n - Returns: A subscriber that performs the provided closure upon receiving values.\n */\n @_disfavoredOverload\n public func sinkState(\n dropsFirst: Bool = false,\n queue: some TargetQueueType,\n receive: @escaping @Sendable (Changes) -> Void\n ) -> StoreStateSubscription {\n let _scope = scope\n\n return store.asStore().sinkState(dropsFirst: dropsFirst, queue: queue) { state in\n receive(state.map { $0[keyPath: _scope] })\n }\n }\n\n /**\n Subscribe the state that scoped\n\n First object always returns true from ifChanged / hasChanges / noChanges unless dropsFirst is true.\n\n - Parameters:\n - dropsFirst: Drops the latest value on started. if true, receive closure will call from next state updated.\n - queue: Specify a queue to receive changes object.\n - Returns: A subscriber that performs the provided closure upon receiving values.\n */\n @_disfavoredOverload\n public func sinkState(\n dropsFirst: Bool = false,\n queue: some MainActorTargetQueueType = .mainIsolated(),\n receive: @escaping @MainActor (Changes) -> Void\n ) -> StoreStateSubscription {\n let _scope = scope\n\n return store.asStore().sinkState(dropsFirst: dropsFirst, queue: queue) { @MainActor state in\n receive(state.map { $0[keyPath: _scope] })\n }\n }\n\n /// Subscribe the state changes\n ///\n /// First object always returns true from ifChanged / hasChanges / noChanges unless dropsFirst is true.\n ///\n /// - Parameters:\n /// - scan: Accumulates a specified type of value over receiving updates.\n /// - dropsFirst: Drops the latest value on started. if true, receive closure will call from next state updated.\n /// - queue: Specify a queue to receive changes object.\n /// - Returns: A subscriber that performs the provided closure upon receiving values.\n @_disfavoredOverload\n public func sinkState(\n scan: Scan, Accumulate>,\n dropsFirst: Bool = false,\n queue: some TargetQueueType,\n receive: @escaping @Sendable (Changes, Accumulate) -> Void\n ) -> StoreStateSubscription {\n sinkState(dropsFirst: dropsFirst, queue: queue) { (changes) in\n let accumulate = scan.accumulate(changes)\n receive(changes, accumulate)\n }\n }\n\n /// Subscribe the state changes\n ///\n /// First object always returns true from ifChanged / hasChanges / noChanges unless dropsFirst is true.\n ///\n /// - Parameters:\n /// - scan: Accumulates a specified type of value over receiving updates.\n /// - dropsFirst: Drops the latest value on started. if true, receive closure will call from next state updated.\n /// - queue: Specify a queue to receive changes object.\n /// - Returns: A subscriber that performs the provided closure upon receiving values.\n @_disfavoredOverload\n public func sinkState(\n scan: Scan, Accumulate>,\n dropsFirst: Bool = false,\n queue: some MainActorTargetQueueType = .mainIsolated(),\n receive: @escaping @MainActor (Changes, Accumulate) -> Void\n ) -> StoreStateSubscription {\n sinkState(dropsFirst: dropsFirst, queue: queue) { @MainActor changes in\n let accumulate = scan.accumulate(changes)\n receive(changes, accumulate)\n }\n }\n\n /// Send activity\n /// - Parameter activity:\n public func send(\n _ name: String = \"\",\n _ activity: TargetStore.Activity,\n _ file: StaticString = #file,\n _ function: StaticString = #function,\n _ line: UInt = #line\n ) {\n let trace = ActivityTrace(\n name: name,\n file: file.description,\n function: function.description,\n line: line\n )\n\n store.asStore()._send(activity: activity, trace: trace)\n }\n\n /// Send activity\n /// - Parameter activity:\n public func send(\n _ activity: TargetStore.Activity,\n _ file: StaticString = #file,\n _ function: StaticString = #function,\n _ line: UInt = #line\n ) {\n send(\"\", activity, file, function, line)\n }\n\n /// Run Mutation that created inline\n ///\n /// Throwable\n public func commit(\n _ name: String = \"\",\n _ file: StaticString = #file,\n _ function: StaticString = #function,\n _ line: UInt = #line,\n mutation: (inout Scope) throws -> Result\n ) rethrows -> Result {\n\n let trace = MutationTrace(\n name: name,\n file: file,\n function: function,\n line: line\n )\n\n return try store.asStore()._receive_sending(\n mutation: { [scope] state, _ -> Result in\n try mutation(&state[keyPath: scope])\n }\n )\n\n }\n\n /// Run Mutation that created inline\n ///\n /// Throwable\n public func commit(\n _ name: String = \"\",\n _ file: StaticString = #file,\n _ function: StaticString = #function,\n _ line: UInt = #line,\n mutation: (inout Scope, inout Transaction) throws -> Result\n ) rethrows -> Result {\n \n let trace = MutationTrace(\n name: name,\n file: file,\n function: function,\n line: line\n )\n\n return try store.asStore()._receive_sending(\n mutation: { [scope] state, transaction -> Result in\n transaction.append(trace: trace)\n return try mutation(&state[keyPath: scope], &transaction)\n }\n )\n }\n\n /// Run Mutation that created inline\n ///\n /// Throwable\n public func commit(\n _ name: String = \"\",\n _ file: StaticString = #file,\n _ function: StaticString = #function,\n _ line: UInt = #line,\n mutation: (inout Scope) throws -> Result\n ) rethrows -> Result where Scope == TargetStore.State {\n \n let trace = MutationTrace(\n name: name,\n file: file,\n function: function,\n line: line\n )\n \n return try store.asStore()._receive_sending(\n mutation: { state, transaction -> Result in \n transaction.append(trace: trace)\n return try mutation(&state) \n }\n )\n }\n\n /// Run Mutation that created inline\n ///\n /// Throwable\n public func commit(\n _ name: String = \"\",\n _ file: StaticString = #file,\n _ function: StaticString = #function,\n _ line: UInt = #line,\n mutation: (inout Scope, inout Transaction) throws -> Result\n ) rethrows -> Result where Scope == TargetStore.State {\n let trace = MutationTrace(\n name: name,\n file: file,\n function: function,\n line: line\n )\n return try store.asStore()._receive_sending(\n mutation: { state, transaction -> Result in\n transaction.append(trace: trace)\n return try mutation(&state, &transaction)\n }\n )\n }\n\n /// Run Mutation that created inline\n ///\n /// Throwable\n public func backgroundCommit(\n _ name: String = \"\",\n _ file: StaticString = #file,\n _ function: StaticString = #function,\n _ line: UInt = #line,\n mutation: sending (inout Scope) throws -> sending Result\n ) async rethrows -> Result {\n\n let trace = MutationTrace(\n name: name,\n file: file,\n function: function,\n line: line\n )\n\n let result = try await store.asStore().writer.perform { [store = self.store, scope] in\n\n let r = try store.asStore()._receive_sending { state, transaction in\n \n transaction.append(trace: trace)\n let r = try mutation(&state[keyPath: scope])\n\n return r\n }\n\n let workaround = { r }\n return workaround()\n }\n\n await self.waitUntilAllEventConsumed()\n\n return result\n }\n\n /// Run Mutation that created inline\n ///\n /// Throwable\n public func backgroundCommit(\n _ name: String = \"\",\n _ file: StaticString = #file,\n _ function: StaticString = #function,\n _ line: UInt = #line,\n mutation: sending (inout Scope, inout Transaction) throws -> sending Result\n ) async rethrows -> Result {\n\n let trace = MutationTrace(\n name: name,\n file: file,\n function: function,\n line: line\n )\n\n let result = try await store.asStore().writer.perform { [store = self.store, scope] in\n \n let r = try store.asStore()._receive_sending { state, transaction in\n \n transaction.append(trace: trace)\n let r = try mutation(&state[keyPath: scope], &transaction)\n \n return r\n }\n \n let workaround = { r }\n return workaround()\n }\n\n await self.waitUntilAllEventConsumed()\n\n return result\n }\n\n /// Run Mutation that created inline\n ///\n /// Throwable\n public func backgroundCommit(\n _ name: String = \"\",\n _ file: StaticString = #file,\n _ function: StaticString = #function,\n _ line: UInt = #line,\n mutation: sending (inout Scope) throws -> sending Result\n ) async rethrows -> Result where Scope == TargetStore.State {\n\n let trace = MutationTrace(\n name: name,\n file: file,\n function: function,\n line: line\n )\n\n let result = try await store.asStore().writer.perform { [store = self.store] in\n\n let r = try store.asStore()._receive_sending { state, transaction in\n transaction.append(trace: trace) \n let r = try mutation(&state)\n return r\n }\n\n let workaround = { r }\n return workaround()\n }\n\n await self.waitUntilAllEventConsumed()\n\n return result\n\n }\n\n /// Run Mutation that created inline\n ///\n /// Throwable\n public func backgroundCommit(\n _ name: String = \"\",\n _ file: StaticString = #file,\n _ function: StaticString = #function,\n _ line: UInt = #line,\n mutation: sending (inout Scope, inout Transaction) throws -> Result\n ) async rethrows -> Result where Scope == TargetStore.State, Self: Sendable {\n\n let trace = MutationTrace(\n name: name,\n file: file,\n function: function,\n line: line\n )\n\n let result = try await store.asStore().writer.perform { [store = self.store] in\n\n let r = try store.asStore()._receive_sending { state, transaction in\n transaction.append(trace: trace)\n let r = try mutation(&state, &transaction)\n return r\n }\n\n let workaround = { r }\n return workaround()\n }\n\n await self.waitUntilAllEventConsumed()\n\n return result\n }\n\n @available(*, deprecated, message: \"A detached scope does not support TrackingObject.\")\n public func detached(\n from newScope: WritableKeyPath & Sendable\n ) -> DetachedDispatcher {\n .init(store: store.asStore(), scope: newScope)\n }\n \n public func detached(\n from newScope: WritableKeyPath & Sendable\n ) -> DetachedDispatcher {\n .init(store: store.asStore(), scope: newScope)\n }\n\n // https://muukii.notion.site/Appending-Sendable-WritableKeyPath-makes-non-sendable-KeyPath-10618017d4c1800a8835fce9d6bffeba?pvs=4\n /*\n public func detached(\n by appendingScope: WritableKeyPath & Sendable\n ) -> DetachedDispatcher {\n\n return .init(\n store: store.asStore(),\n scope: scope.appending(path: appendingScope)\n )\n }\n */\n}\n" }, { "path": "Sources/Verge/Store/StoreMiddleware.swift", "content": "//\n// Copyright (c) 2019 muukii\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\nimport Foundation\n\npublic protocol StoreMiddlewareType: Sendable {\n\n associatedtype State\n\n @Sendable\n func modify(modifyingState: inout State, transaction: inout Transaction, current: Changes)\n\n}\n\npublic struct AnyStoreMiddleware: StoreMiddlewareType, Sendable {\n\n private let closure: @Sendable (_ modifyingState: inout State, _ transaction: inout Transaction, _ current: Changes) -> Void\n\n init(\n modify: @escaping @Sendable (\n _ modifyingState: inout State, _ transaction: inout Transaction, _ current: Changes\n )\n -> Void\n ) {\n self.closure = modify\n }\n\n public func modify(\n modifyingState: inout State, transaction: inout Transaction, current: Changes\n ) {\n self.closure(&modifyingState, &transaction, current)\n }\n\n}\n\nextension StoreMiddlewareType {\n\n /**\n Creates an instance that commits mutations according to the original committing.\n */\n public static func modify(\n modify: @escaping @Sendable (\n _ modifyingState: inout State, _ transaction: inout Transaction, _ current: Changes\n )\n -> Void\n ) -> Self where Self == AnyStoreMiddleware {\n return .init(modify: modify)\n }\n\n}\n" }, { "path": "Sources/Verge/Store/StoreOperation.swift", "content": "import class Foundation.NSRecursiveLock\n\npublic enum StoreOperation: Sendable {\n case nonAtomic\n case atomic(NSRecursiveLock)\n\n func lock() {\n switch self {\n case .nonAtomic:\n break\n case .atomic(let lock):\n lock.lock()\n }\n }\n\n func unlock() {\n switch self {\n case .nonAtomic:\n break\n case .atomic(let lock):\n lock.unlock()\n }\n }\n\n public static var atomic: Self {\n return .atomic(.init())\n }\n}\n\n" }, { "path": "Sources/Verge/Store/StoreType+Assignee.swift", "content": "//\n// Copyright (c) 2020 Hiroshi Kimura(Muukii) \n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\nimport Foundation\n\nextension StoreDriverType {\n\n public typealias Assignee = @Sendable (Value) -> Void\n\n /**\n Returns an asignee function to asign\n\n ```\n let store1 = Store()\n let store2 = Store()\n\n store1\n .derived(.map(\\.count))\n .assign(to: store2.assignee(\\.count))\n ```\n */\n public func assignee(\n _ keyPath: WritableKeyPath & Sendable\n ) -> Assignee> {\n return { [weak store] value in\n store?.asStore().commit {\n $0[keyPath: keyPath] = value.primitive\n }\n }\n }\n\n /**\n Returns an asignee function to asign\n\n ```\n let store1 = Store()\n let store2 = Store()\n\n store1\n .derived(.map(\\.count))\n .assign(to: store2.assignee(\\.count))\n ```\n */\n public func assignee(\n _ keyPath: WritableKeyPath & Sendable\n ) -> Assignee> {\n return { [weak store] value in\n store?.asStore().commit {\n $0[keyPath: keyPath] = value.primitive\n }\n }\n }\n\n /**\n Returns an asignee function to asign\n\n ```\n let store1 = Store()\n let store2 = Store()\n\n store1\n .derived(.map(\\.count))\n .assign(to: store2.assignee(\\.count))\n ```\n */\n public func assignee(\n _ keyPath: WritableKeyPath & Sendable\n ) -> Assignee> {\n return { [weak store] value in\n let changes = value.map { Optional.some($0) }\n store?.asStore().commit {\n $0[keyPath: keyPath] = .some(value.primitive)\n }\n }\n }\n\n /**\n Assignee to asign Changes object directly.\n */\n public func assignee(\n _ keyPath: WritableKeyPath & Sendable\n ) -> Assignee {\n return { [weak store] value in\n store?.asStore().commit {\n $0[keyPath: keyPath] = value\n }\n }\n }\n\n /**\n Assignee to asign Changes object directly.\n */\n public func assignee(\n _ keyPath: WritableKeyPath & Sendable\n ) -> Assignee {\n return { [weak store] value in\n store?.asStore().commit { [value] a in \n a[keyPath: keyPath] = value\n }\n }\n }\n\n /**\n Assignee to asign Changes object directly.\n */\n public func assignee(\n _ keyPath: WritableKeyPath & Sendable\n ) -> Assignee {\n return { [weak store] value in\n store?.asStore().commit {\n $0[keyPath: keyPath] = .some(value)\n }\n }\n }\n\n}\n" }, { "path": "Sources/Verge/Store/StoreType+BindingDerived.swift", "content": "//\n// Copyright (c) 2020 Hiroshi Kimura(Muukii) \n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\nimport class Foundation.NSString\n\nprivate enum CommitFromBindingDerived: TransactionKey {\n static var defaultValue: Bool { false }\n}\n\nextension Transaction {\n\n var isFromBindingDerived: Bool {\n get {\n self[CommitFromBindingDerived.self]\n }\n set {\n self[CommitFromBindingDerived.self] = newValue\n }\n }\n\n}\n\nprivate struct BindingDerivedPipeline: PipelineType where BackingPipeline.Input == Changes, BackingPipeline.Output == Output {\n\n typealias Input = Changes\n\n private let backingPipeline: BackingPipeline\n\n init(backingPipeline: BackingPipeline) {\n self.backingPipeline = backingPipeline\n }\n\n func makeStorage() -> BackingPipeline.Storage {\n backingPipeline.makeStorage()\n }\n\n func yield(_ input: Changes, storage: inout Storage) -> Output {\n backingPipeline.yield(input, storage: &storage)\n }\n\n func yieldContinuously(_ input: Changes, storage: inout Storage) -> ContinuousResult {\n if input._transaction.isFromBindingDerived {\n return .noUpdates\n }\n return backingPipeline.yieldContinuously(input, storage: &storage)\n }\n\n}\n\nextension StoreDriverType {\n\n /// Returns Binding Derived object\n ///\n /// - Complexity: 💡 It's better to set `dropsOutput` predicate.\n /// - Parameters:\n /// - name:\n /// - get:\n /// - dropsOutput: Predicate to drops object if found a duplicated output\n /// - set:\n /// - Returns:\n public func bindingDerived(\n _ name: String = \"\",\n _ file: StaticString = #file,\n _ function: StaticString = #function,\n _ line: UInt = #line,\n get pipeline: Pipeline,\n set: sending @escaping @Sendable (inout TargetStore.State, Pipeline.Output) -> Void,\n queue: some TargetQueueType = .passthrough\n ) -> BindingDerived where Pipeline.Input == Changes {\n\n let derived = BindingDerived.init(\n get: BindingDerivedPipeline(backingPipeline: pipeline),\n set: { [weak self] state in \n self?.store.asStore()\n ._receive_sending { inoutRef, transaction in\n transaction.isFromBindingDerived = true\n set(&inoutRef, state)\n }\n },\n initialUpstreamState: store.asStore().state,\n subscribeUpstreamState: { callback in\n store.asStore()._primitive_sinkState(\n dropsFirst: true,\n queue: queue,\n receive: callback\n )\n },\n retainsUpstream: nil\n )\n\n store.asStore().onDeinit { [weak derived] in\n derived?.invalidate()\n }\n\n return derived\n }\n\n public func bindingDerived {\n\n bindingDerived(\n name, file, function, line,\n get: .select(select),\n set: { state, newValue in\n state[keyPath: select] = newValue\n }\n )\n }\n \n public func bindingDerived( \n _ name: String = \"\",\n _ file: StaticString = #file,\n _ function: StaticString = #function,\n _ line: UInt = #line,\n select: WritableKeyPath & Sendable,\n queue: some TargetQueueType = .passthrough\n ) -> BindingDerived {\n\n public static var alwaysFalse: Self {\n .init { _, _ in false }\n }\n\n private let _equals: (Input, Input) -> Bool\n\n /// Creates an instance\n ///\n /// - Parameter equals: Return true if two inputs are equal.\n public init(\n _ equals: @escaping (Input, Input) -> Bool\n ) {\n self._equals = equals\n }\n\n /// It compares the value selected from passed selector closure\n /// - Parameter selector:\n public init(selector: @escaping (Input) -> T) {\n self.init { a, b in\n selector(a) == selector(b)\n }\n }\n\n public init(selector: @escaping (Input) -> T, equals: @escaping (T, T) -> Bool) {\n self.init { a, b in\n equals(selector(a), selector(b))\n }\n }\n\n public init(selector: @escaping (Input) -> T, comparer: Comparer) {\n self.init { a, b in\n comparer._equals(selector(a), selector(b))\n }\n }\n\n /// Make Combined comparer\n /// - Parameter comparers:\n public init(and comparers: [Comparer]) {\n self.init { pre, new in\n for filter in comparers {\n guard filter._equals(pre, new) else {\n return false\n }\n }\n return true\n }\n }\n\n /// Make Combined comparer\n /// - Parameter comparers:\n public init(or comparers: [Comparer]) {\n self.init { pre, new in\n for filter in comparers {\n if filter._equals(pre, new) {\n return true\n }\n }\n return false\n }\n }\n\n public func equals(_ lhs: Input, _ rhs: Input) -> Bool {\n _equals(lhs, rhs)\n }\n\n /// Returns an curried closure\n public func curried() -> (_ lhs: Input, _ rhs: Input) -> Bool {\n _equals\n }\n\n}\n\nextension Comparer where Input : Equatable {\n public init() {\n self.init(==)\n }\n\n public static var usingEquatable: Self {\n return .init(==)\n }\n}\n\nextension Comparer {\n\n public func and(_ otherComparer: () -> Comparer) -> Comparer {\n .init(and: [\n self,\n otherComparer()\n ])\n }\n\n public func or(_ otherComparer: () -> Comparer) -> Comparer {\n .init(or: [\n self,\n otherComparer()\n ])\n }\n\n}\n" }, { "path": "Tests/VergeTests/PerformanceTests.swift", "content": "\nimport Foundation\n\nimport XCTest\nimport Verge\n\n/**\n Store's state contains a huge dictionary.\n This test-case tests to commit mutations:\n 1. Mutates property beside of huge dictionary.\n 2. Mutates a huge dictionary.\n It compares that performance.\n It would be good if the first 1 test-case is fast without unaffected from a huge dictionary.\n */\nclass PerformanceTests: XCTestCase {\n\n func testMutationOnAnotherProperty() {\n\n let store = DemoStore()\n\n measure(metrics: [XCTMemoryMetric(), XCTCPUMetric(), XCTClockMetric()]) {\n store.increment()\n }\n\n }\n\n}\n" }, { "path": "Tests/VergeTests/PipelineTests.swift", "content": "import XCTest\nimport Verge\n\nfinal class PipelineTests: XCTestCase {\n \n func test_MapPipeline() {\n \n let mapCounter = VergeConcurrency.UnfairLockAtomic.init(0)\n \n let pipeline = Pipelines.ChangesMapPipeline(\n intermediate: {\n $0.count\n },\n transform: {\n mapCounter.modify { \n $0 += 1\n }\n return $0\n },\n additionalDropCondition: nil\n )\n \n var storage: Void = ()\n \n do {\n let s = DemoState()\n \n XCTAssertEqual(\n pipeline.yieldContinuously(\n Changes.init(\n old: s,\n new: s\n ),\n storage: &storage\n ),\n .noUpdates\n )\n \n XCTAssertEqual(mapCounter.value, 0)\n }\n \n do {\n \n XCTAssertEqual(\n pipeline.yieldContinuously(\n Changes.init(\n old: .init(name: \"A\", count: 1),\n new: .init(name: \"A\", count: 2)\n ),\n storage: &storage\n ),\n .new(2)\n )\n \n XCTAssertEqual(mapCounter.value , 2)\n \n }\n \n }\n \n func test_MapPipeline_Intermediate() {\n \n let mapCounter = VergeConcurrency.UnfairLockAtomic.init(0)\n \n let pipeline = Pipelines.ChangesMapPipeline(\n intermediate: {\n $0.name\n },\n transform: {\n mapCounter.modify { $0 += 1 }\n return $0.count\n },\n additionalDropCondition: nil\n )\n \n var storage: Void = ()\n \n do {\n let s = DemoState()\n \n XCTAssertEqual(\n pipeline.yieldContinuously(\n Changes.init(\n old: s,\n new: s\n ),\n storage: &storage\n ),\n .noUpdates\n )\n \n XCTAssertEqual(mapCounter.value, 0)\n }\n \n do {\n \n XCTAssertEqual(\n pipeline.yieldContinuously(\n Changes.init(\n old: .init(name: \"A\", count: 1),\n new: .init(name: \"A\", count: 2)\n ),\n storage: &storage\n ),\n .noUpdates\n )\n \n XCTAssertEqual(mapCounter.value, 0)\n \n }\n \n }\n \n func testSelect() {\n \n do {\n let store = Verge.Store(initialState: .init())\n// do {\n// let d = store.derived(.map(\\.nonEquatable))\n// XCTAssert((d as Any) is Derived>)\n// }\n// \n// do {\n// let d = store.derived(.map(\\.nonEquatable))\n// XCTAssert((d as Any) is Derived>)\n// }\n \n do {\n let d = store.derived(.map(\\.onEquatable))\n XCTAssert((d as Any) is Derived)\n }\n \n do {\n let d = store.derived(.map(\\.count))\n XCTAssert((d as Any) is Derived)\n }\n \n do {\n let d = store.derived(.map { @Sendable in $0.count })\n XCTAssert((d as Any) is Derived)\n }\n }\n \n }\n \n}\n" }, { "path": "Tests/VergeTests/ReferenceEdgeTests.swift", "content": "\nimport XCTest\nimport Verge\n\nfinal class FragmentTests: XCTestCase {\n\n struct State {\n var name: String = \"\"\n @ReferenceEdge var number = 0\n }\n\n func testFragment() {\n\n var state = State()\n XCTAssertEqual(state.number, 0)\n\n state.number += 1\n\n XCTAssertEqual(state.number, 1)\n }\n\n func testFragmentWithCopy() {\n\n let state = State()\n XCTAssertEqual(state.number, 0)\n\n var anotherState = state\n anotherState.number += 1\n\n XCTAssertEqual(anotherState.number, 1)\n\n XCTAssertNotEqual(state.$number._storagePointer, anotherState.$number._storagePointer)\n }\n\n func testReference() {\n\n var state = State()\n\n state.number += 1\n\n state.name = \"A\"\n\n var state2 = state\n state2.name = \"B\"\n\n XCTAssert(state.$number._storagePointer == state2.$number._storagePointer)\n\n }\n\n func testCast() {\n\n let source = ReferenceEdge(wrappedValue: State())\n\n var binded = unsafeBitCast(source, to: ReferenceEdge.self)\n\n print(binded.name)\n\n binded.name = \"hiroshi\"\n\n XCTAssertEqual(binded.name, \"hiroshi\")\n\n }\n\n}\n\n" }, { "path": "Tests/VergeTests/Retain/PublisherCompletionTests.swift", "content": "\nimport Foundation\nimport Combine\nimport Verge\nimport XCTest\n\nfinal class SubjectCompletionTests: XCTestCase {\n\n func testStatePublisherCompletion1() {\n\n var bag = Set()\n\n var store: DemoStore? = DemoStore()\n weak var weakStore: DemoStore? = store\n\n store?.statePublisher()\n .sink(\n receiveCompletion: { _ in\n XCTFail()\n },\n receiveValue: { _ in }\n )\n .store(in: &bag)\n\n XCTAssertNotNil(weakStore)\n\n store = nil\n\n XCTAssertNil(weakStore)\n\n }\n\n func testActivityPublisherCompletion1() {\n\n var bag = Set()\n\n var store: DemoStore? = DemoStore()\n weak var weakStore: DemoStore? = store\n\n store?\n .activityPublisher()\n .sink(\n receiveCompletion: { _ in\n XCTFail()\n },\n receiveValue: { _ in\n \n }\n )\n .store(in: &bag)\n\n XCTAssertNotNil(weakStore)\n\n store = nil\n\n XCTAssertNil(weakStore)\n bag.forEach { $0.cancel() }\n XCTAssertNil(weakStore)\n\n }\n\n func testActivityPublisherCompletion2() {\n\n var bag = Set()\n\n var store: DemoStore? = DemoStore()\n weak var weakStore: DemoStore? = store\n\n store!.activityPublisher()\n .sink(\n receiveCompletion: { _ in\n XCTFail(\"It should not be called, as the subscription was canceled before publishing completion.\")\n },\n receiveValue: { [store] _ in\n withExtendedLifetime(store) {}\n }\n )\n .store(in: &bag)\n\n XCTAssertNotNil(weakStore)\n\n store = nil\n\n XCTAssertNotNil(weakStore)\n bag.forEach { $0.cancel() }\n XCTAssertNil(weakStore)\n\n }\n\n func testActivityPublisherCompletion_deallocated() {\n\n var bag = Set()\n\n var store: DemoStore? = DemoStore()\n weak var weakStore: DemoStore? = store\n\n var strongRef: Ref? = Ref()\n weak var weakRef = strongRef\n\n store!.activityPublisher()\n .sink(\n receiveCompletion: { _ in\n XCTFail()\n },\n receiveValue: { _ in\n print(\"\")\n withExtendedLifetime(strongRef) {}\n }\n )\n .store(in: &bag)\n\n strongRef = nil\n store = nil\n\n XCTAssertNil(weakStore)\n\n XCTAssertNil(weakRef)\n\n }\n\n func testDerived_publisher_retains_derived() {\n\n var c: AnyCancellable?\n\n let ref = withReference(DemoStore())\n\n let derivedRef = withReference(ref.value!.derived(.map(\\.count)))\n\n c = derivedRef.value!\n .statePublisher()\n .sink(\n receiveCompletion: { _ in\n XCTFail()\n },\n receiveValue: { _ in\n\n }\n )\n\n\n derivedRef.release()\n\n XCTAssertNotNil(derivedRef.value)\n\n c?.cancel()\n\n XCTAssertNil(derivedRef.value)\n\n }\n\n func testDerived_stream_stops_on_store_deallocated() async {\n\n var c: AnyCancellable?\n\n let storeRef = withReference(DemoStore())\n\n let derivedRef = withReference(storeRef.value!.derived(.map(\\.count)))\n\n storeRef.release()\n\n await Task.yield()\n\n XCTAssertNil(storeRef.value)\n\n c = derivedRef.value!\n .statePublisher()\n .sink(\n receiveCompletion: { _ in\n XCTFail()\n },\n receiveValue: { _ in\n }\n )\n\n derivedRef.release()\n\n await Task.yield()\n \n // still not nil as the subscription is still on going.\n XCTAssertNotNil(derivedRef.value)\n\n XCTAssertNil(storeRef.value)\n \n withExtendedLifetime(c, {})\n \n c?.cancel()\n \n XCTAssertNil(derivedRef.value)\n\n }\n\n class Ref {}\n}\n\nfinal class Reference: @unchecked Sendable, CustomDebugStringConvertible {\n\n weak var value: T?\n private var strong: T?\n\n init(_ object: T){\n self.value = object\n self.strong = object\n }\n\n func release() {\n strong = nil\n }\n \n var debugDescription: String {\n \"\\(value)\"\n }\n\n}\n\nfunc withReference(_ object: T) -> Reference {\n return .init(object)\n}\n" }, { "path": "Tests/VergeTests/Retain/StoreSinkSusbscriptionTests.swift", "content": "import Verge\nimport XCTest\nimport Atomics\n\nfinal class StoreSinkSubscriptionTests: XCTestCase {\n\n func test_Store_sinkState_stops_on_store_deallocated() {\n\n let storeRef = withReference(DemoStore())\n let resourceRef = withReference(Resource())\n\n storeRef.value!\n .sinkState { [ref = resourceRef.value!] _ in\n\n withExtendedLifetime(ref) {}\n }\n .storeWhileSourceActive()\n\n resourceRef.release()\n\n XCTAssertNotNil(storeRef.value)\n XCTAssertNotNil(resourceRef.value)\n\n storeRef.release()\n\n XCTAssertNil(storeRef.value)\n XCTAssertNil(resourceRef.value)\n\n }\n\n func test_Store_sinkState_canceled_by_others() {\n\n var cancellable: StoreStateSubscription?\n\n let storeRef = withReference(DemoStore())\n let resourceRef = withReference(Resource())\n\n cancellable = storeRef.value!\n .sinkState { [ref = resourceRef.value!] _ in\n\n withExtendedLifetime(ref) {}\n }\n .storeWhileSourceActive()\n\n resourceRef.release()\n\n XCTAssertNotNil(storeRef.value)\n XCTAssertNotNil(resourceRef.value)\n\n cancellable?.cancel()\n\n XCTAssertNotNil(storeRef.value)\n XCTAssertNil(resourceRef.value)\n\n }\n\n func test_Store_sinkActivity_stops_on_store_deallocated() {\n\n let storeRef = withReference(DemoStore())\n let resourceRef = withReference(Resource())\n\n storeRef.value!\n .sinkActivity { [ref = resourceRef.value!] _ in\n\n withExtendedLifetime(ref) {}\n }\n .storeWhileSourceActive()\n\n resourceRef.release()\n\n XCTAssertNotNil(storeRef.value)\n XCTAssertNotNil(resourceRef.value)\n\n storeRef.release()\n\n XCTAssertNil(storeRef.value)\n XCTAssertNil(resourceRef.value)\n\n }\n\n func test_Derived_lifeCycle_with_source() {\n\n let storeRef = withReference(DemoStore())\n let resourceRef = withReference(Resource())\n let derivedRef = withReference(storeRef.value!.derived(.select(\\.count)))\n\n derivedRef.value!\n .sinkState { [ref = resourceRef.value!] _ in\n\n withExtendedLifetime(ref) {}\n }\n .storeWhileSourceActive()\n\n resourceRef.release()\n\n XCTAssertNotNil(storeRef.value)\n XCTAssertNotNil(resourceRef.value)\n\n storeRef.release()\n\n XCTAssertNil(storeRef.value)\n XCTAssertNil(resourceRef.value)\n\n }\n\n func test_Derived_lifeCycle_with_source_release_store_earlier() {\n\n let storeRef = withReference(DemoStore())\n let resourceRef = withReference(Resource())\n\n // make derived\n let derivedRef = withReference(storeRef.value!.derived(.select(\\.count)))\n\n // start subscribe\n derivedRef.value!\n .sinkState { [ref = resourceRef.value!] _ in\n\n withExtendedLifetime(ref) {}\n }\n .storeWhileSourceActive()\n\n // make the resource is captured only from the closure\n resourceRef.release()\n XCTAssertNotNil(resourceRef.value)\n\n // release store earlier than stop derived\n storeRef.release()\n // should be nil because derived won't retain store as upstream\n XCTAssertNil(storeRef.value)\n\n // released all resouces\n XCTAssertNil(resourceRef.value)\n\n }\n\n func testCompare() {\n let wasInvalidated = Atomics.ManagedAtomic(false)\n\n XCTAssertTrue(wasInvalidated.compareExchange(expected: false, desired: true, ordering: .relaxed).exchanged)\n XCTAssertFalse(wasInvalidated.compareExchange(expected: false, desired: true, ordering: .relaxed).exchanged)\n }\n\n /**\n Store won't retain the Derived\n */\n func testRelease() {\n\n let wrapper = DemoStore()\n let ref = withReference(wrapper.derived(.map { @Sendable in $0.count }, queue: .passthrough))\n ref.release()\n XCTAssertNil(ref.value)\n\n }\n\n func testRetain() {\n\n let store = DemoStore()\n\n let derivedRef = withReference(store.derived(.map { @Sendable in $0.count }, queue: .passthrough))\n\n let expectation = XCTestExpectation(description: \"receive changes\")\n expectation.expectedFulfillmentCount = 1\n expectation.assertForOverFulfill = true\n\n let subscription = derivedRef\n .value!\n .sinkState(\n dropsFirst: true,\n queue: .passthrough\n ) { (changes) in\n expectation.fulfill()\n }\n\n XCTAssertNotNil(derivedRef.value)\n\n derivedRef.release()\n\n XCTAssertNotNil(derivedRef.value, \"as still subscribing\")\n\n store.commit { _ in }\n\n store.commit { $0.count += 1 }\n\n subscription.cancel()\n\n XCTAssertNil(derivedRef.value)\n\n wait(for: [expectation], timeout: 1)\n\n }\n\n func test_derived_chain() {\n\n let wrapper = DemoStore()\n\n var baseSlice: Derived! = wrapper.derived(.map { @Sendable in $0.count }, queue: .passthrough)\n\n weak var weakBaseSlice = baseSlice\n\n var slice: Derived! = baseSlice.derived(.map { @Sendable in $0.self }, queue: .passthrough)\n\n baseSlice = nil\n\n weak var weakSlice = slice\n\n XCTAssertEqual(slice.state.primitive, 0)\n XCTAssertEqual(slice.state.version, 0)\n XCTAssertEqual(slice.state.hasChanges(\\.self), true)\n XCTAssertNotNil(weakBaseSlice)\n\n wrapper.increment()\n\n XCTAssertEqual(slice.state.primitive, 1)\n XCTAssertEqual(slice.state.version, 1)\n XCTAssertEqual(slice.state.hasChanges(\\.self), true)\n XCTAssertNotNil(weakBaseSlice)\n\n wrapper.empty()\n\n XCTAssertEqual(slice.state.primitive, 1)\n XCTAssertEqual(slice.state.version, 1) // with memoized, version not changed\n XCTAssertEqual(slice.state.hasChanges(\\.self), true)\n XCTAssertNotNil(weakBaseSlice)\n\n wrapper.increment()\n\n XCTAssertEqual(slice.state.primitive, 2)\n XCTAssertEqual(slice.state.version, 2)\n XCTAssertEqual(slice.state.hasChanges(\\.self), true)\n XCTAssertNotNil(weakBaseSlice)\n\n slice = nil\n\n XCTAssertNil(weakSlice)\n XCTAssertNil(weakBaseSlice)\n\n }\n\n final class Resource {\n deinit {\n print(\"d\")\n }\n }\n}\n" }, { "path": "Tests/VergeTests/RunLoopTests.swift", "content": "import XCTest\n@testable import Verge\n\nfinal class RunLoopTests: XCTestCase {\n\n func test_performance_adding() {\n\n measure {\n for _ in 0..<1000 {\n RunLoopActivityObserver.addObserver(acitivity: .beforeWaiting, in: .main) {\n }\n }\n }\n\n }\n\n}\n" }, { "path": "Tests/VergeTests/Sample.swift", "content": "//\n// Sample.swift\n// VergeStoreTests\n//\n// Created by muukii on 2020/04/18.\n// Copyright © 2020 muukii. All rights reserved.\n//\n\nimport Foundation\n\n#if canImport(UIKIt)\nimport UIKit\n\nimport Verge\n\nenum Sample {\n \n struct State: StateType {\n var name: String = \"\"\n var age: Int = 0\n }\n \n enum Activity {\n case somethingHappen\n }\n \n class ViewController: UIViewController {\n \n private let nameLabel: UILabel = .init()\n private let ageLabel: UILabel = .init()\n \n let store = Store(initialState: .init(), logger: nil)\n \n var subscriptions = Set()\n \n override func viewDidLoad() {\n super.viewDidLoad()\n \n store.sinkState { [weak self] (changes) in\n self?.update(changes: changes)\n }\n .store(in: &subscriptions)\n \n }\n \n private func update(changes: Changes) {\n \n changes.ifChanged(\\.name) { (name) in\n nameLabel.text = name\n }\n \n changes.ifChanged(\\.age) { (age) in\n ageLabel.text = age.description\n }\n \n }\n \n }\n}\n\n#endif\n" }, { "path": "Tests/VergeTests/StateTypeTests.swift", "content": "import Foundation\nimport Verge\nimport XCTest\n\nfinal class StateTypeTests: XCTestCase {\n \n func test_init() {\n \n let store = Store(initialState: .init())\n \n XCTAssertEqual(store.state.count2, 1)\n \n }\n\n func test_store() {\n\n let store = Store(initialState: .init())\n\n store.commit {\n $0.count = 1\n }\n \n XCTAssertEqual(store.state.count2, 2)\n \n store.commit {\n $0.name = \"a\"\n }\n \n XCTAssertEqual(store.state.count2, 2)\n }\n\n struct State: StateType {\n\n var name = \"\"\n var count = 0\n var count2 = 0\n \n static func reduce(\n modifying: inout StateTypeTests.State,\n transaction: inout Transaction,\n current: Changes\n ) {\n \n current.ifChanged(\\.count).do { _ in\n modifying.count2 += 1\n }\n }\n \n }\n\n}\n" }, { "path": "Tests/VergeTests/StoreAndDerivedTests.swift", "content": "import Verge\nimport XCTest\n\nfinal class StoreAndDerivedTests: XCTestCase {\n\n @MainActor\n func test() async {\n\n let store = Store<_, Never>(initialState: DemoState())\n\n let _ = store.derived(.select(\\.name))\n let countDerived = store.derived(.select(\\.count))\n\n await withTaskGroup(of: Void.self) { group in\n\n for i in 0..<1000 {\n group.addTask {\n await withBackground {\n store.commit {\n $0.name = \"\\(i)\"\n }\n }\n\n }\n }\n\n group.addTask {\n await withBackground {\n store.commit {\n $0.count = 100\n }\n }\n\n\n XCTAssertEqual(store.state.count, 100)\n\n await store.waitUntilAllEventConsumed()\n // potentially it fails as EventEmitter's behavior\n // If EventEmitter's buffer is not empty, commit function escape from the stack by only adding.\n XCTAssertEqual(countDerived.state.primitive, 100)\n }\n\n }\n\n print(\"end\")\n\n }\n\n}\n\n/**\n Performs the given task in background\n */\npublic nonisolated func withBackground(\n _ thunk: @escaping @Sendable () async throws -> Return\n) async rethrows -> Return {\n\n // for now we will keep this until Swift6.\n assert(Thread.isMainThread == false)\n\n // here is the background as it's nonisolated\n // to inherit current actor context, use @_unsafeInheritExecutor\n\n // thunk closure runs on the background as it's sendable\n // if it's not sendable, inherit current actor context but it's already background.\n // @_inheritActorContext makes closure runs on current actor context even if it's sendable.\n return try await thunk()\n}\n" }, { "path": "Tests/VergeTests/StoreInitTests.swift", "content": "\nimport XCTest\nimport Verge\n\nfinal class StoreInitTests: XCTestCase {\n \n class RefState {\n \n }\n /*\n class RefViewModel: StoreComponentType {\n \n class State: Equatable {\n static func == (lhs: StoreInitTests.RefViewModel.State, rhs: StoreInitTests.RefViewModel.State) -> Bool {\n true\n }\n \n init() {}\n }\n \n let store: DefaultStore\n \n init() {\n \n // it raises a warning\n self.store = DefaultStore(initialState: .init())\n }\n }\n */\n \n class StructViewModel: StoreDriverType {\n \n struct State: Equatable {\n \n init() {}\n }\n \n let store: Store\n \n init() {\n \n self.store = .init(initialState: .init())\n }\n }\n \n}\n" }, { "path": "Tests/VergeTests/StoreMiddlewareTests.swift", "content": "import Testing\n\n@Suite(\"StoreMiddlewareTests\")\nstruct StoreMiddlewareTests {\n\n @Test(\"Commit Hook\")\n func testCommitHook() {\n let store = DemoStore()\n\n store.add(\n middleware: .modify { @Sendable modifyingState, transaction, current in\n current.ifChanged(\\.count).do { _ in\n modifyingState.count += 1\n }\n })\n\n store.add(\n middleware: .modify { @Sendable modifyingState, transaction, current in\n current.ifChanged(\\.name).do { _ in\n modifyingState.count = 100\n }\n })\n\n #expect(store.state.count == 0)\n\n store.commit {\n $0.count += 1\n }\n\n #expect(store.state.count == 2)\n\n store.commit {\n $0.name = \"A\"\n }\n\n if case .graph(let graph) = store.state.modification {\n graph.prettyPrint()\n #expect(\n graph.prettyPrint() == \"\"\"\n VergeTests.DemoState {\n name-(1)+(1)\n count-(1)+(1)\n }\n \"\"\")\n }\n\n #expect(store.state.count == 100)\n }\n}\n" }, { "path": "Tests/VergeTests/StoreSinkTests.swift", "content": "import Verge\nimport XCTest\n\n@MainActor\nfileprivate func UI() {\n\n}\n\nfinal class StoreSinkTests: XCTestCase {\n\n func testMainActorSubscription() {\n\n let store = DemoStore()\n\n _ = store.sinkState { _ in\n UI()\n }\n\n _ = store.sinkState(queue: .main) { @MainActor _ in\n UI()\n }\n\n }\n\n func testNonActorSubscription() {\n\n let store = DemoStore()\n\n _ = store.sinkState(queue: .passthrough) { _ in\n Task {\n await UI()\n }\n }\n }\n}\n" }, { "path": "Tests/VergeTests/StoreTaskTests.swift", "content": "import Verge\nimport XCTest\nimport Atomics\n\nfinal class StoreTaskTests: XCTestCase {\n\n func test() {\n \n let atomic = ManagedAtomic.init(false)\n\n do {\n let r = atomic.compareExchange(expected: true, desired: true, ordering: .sequentiallyConsistent).exchanged\n print(r)\n }\n\n do {\n let r = atomic.compareExchange(expected: true, desired: false, ordering: .sequentiallyConsistent).exchanged\n print(r)\n }\n\n do {\n let r = atomic.compareExchange(expected: false, desired: true, ordering: .sequentiallyConsistent).exchanged\n print(r)\n }\n\n }\n\n @MainActor\n func testActorContext_onMainActor() async throws {\n\n let store = DemoStore()\n\n try await store.task {\n XCTAssertTrue(Thread.isMainThread)\n }\n .value\n\n try await store.taskDetached {\n XCTAssertFalse(Thread.isMainThread)\n }\n .value\n }\n\n func testActorContext() async throws {\n\n let store = DemoStore()\n\n try await store.task {\n XCTAssertFalse(Thread.isMainThread)\n }\n .value\n\n try await store.taskDetached {\n XCTAssertFalse(Thread.isMainThread)\n }\n .value\n }\n}\n" }, { "path": "Tests/VergeTests/SynchronizeDisplayValueTests.swift", "content": "//\n// SynchronizeDisplayValueTests.swift\n// VergeStoreTests\n//\n// Created by muukii on 2019/11/09.\n// Copyright © 2019 muukii. All rights reserved.\n//\n\nimport Foundation\n\nimport XCTest\n\nimport Verge\n" }, { "path": "Tests/VergeTests/SyntaxTests.swift", "content": "//\n// SyntaxTests.swift\n// VergeStoreTests\n//\n// Created by muukii on 2020/05/24.\n// Copyright © 2020 muukii. All rights reserved.\n//\n\nimport Foundation\n\nimport Verge\nimport VergeMacros\n\nenum SyntaxTests {\n\n static func code() {\n\n let changes: Changes = .init(old: nil, new: .init())\n\n changes.ifChanged(\\.name).do { name in\n\n }\n\n// changes.ifChanged({ ($0.name, $0.name) }) { args in\n// }\n\n changes.ifChanged({ $0.nonEquatable }, comparator: .alwaysFalse()).do { name in\n\n }\n\n changes.ifChanged({ $0.name }).do { name in\n\n }\n\n changes.ifChanged(\\.name, \\.count).do { name, count in\n\n }\n\n }\n}\n" }, { "path": "Tests/VergeTests/TransactionTests.swift", "content": "import Verge\nimport XCTest\n\nfinal class TransactionTests: XCTestCase {\n\n func testTransaction() async {\n\n struct MyKey: TransactionKey {\n static var defaultValue: String? {\n nil\n }\n }\n\n let store = Store(initialState: .init())\n\n await store.commit {\n $0.count += 1\n $1[MyKey.self] = \"first commit\"\n }\n\n XCTAssertEqual(store.state._transaction[MyKey.self], \"first commit\")\n }\n\n}\n" }, { "path": "Tests/VergeTests/Usage.swift", "content": "\nimport Verge\n\nstruct RootState: Equatable {\n\n struct Nested: Equatable {}\n\n var nested: Nested = .init()\n\n}\n\nfinal class RootStore: Store, @unchecked Sendable {\n\n}\n\nfinal class Service: StoreDriverType {\n\n var store: RootStore { fatalError() }\n\n init() {\n\n }\n\n}\n\nfinal class SpecificService: StoreDriverType {\n\n var scope: WritableKeyPath & Sendable { \\.nested }\n\n var store: RootStore { fatalError() }\n\n init() {\n\n _ = sinkState { state in\n\n let _: Changes = state\n }\n\n }\n\n}\n\nfinal class ViewModel: StoreDriverType {\n\n struct State: Equatable {}\n\n let store: Store = .init(initialState: .init())\n\n init() {\n\n commit { _ in\n\n }\n\n _ = sinkState { state in\n let _: Changes = state\n }\n\n }\n\n}\n\n// MARK: - Abstraction\n\nprotocol MyViewModelType: StoreDriverType where TargetStore.State == String, TargetStore.Activity == Int {\n\n}\n\nfinal class Concrete: MyViewModelType {\n\n let store: Verge.Store\n\n init() {\n store = .init(initialState: .init())\n\n _ = sinkState { _ in\n\n }\n\n commit { _ in\n\n }\n\n }\n\n}\n\nfinal class Controller where ViewModel.Scope == ViewModel.TargetStore.State {\n\n init(viewModel: ViewModel) {\n\n let _: Changes = viewModel.state\n\n viewModel.send(1)\n }\n\n}\n" }, { "path": "Tests/VergeTests/VergeStoreTests.swift", "content": "//\n// VergeStoreTests.swift\n// VergeStoreTests\n//\n// Created by muukii on 2019/11/04.\n// Copyright © 2019 muukii. All rights reserved.\n//\n\nimport XCTest\n\nimport Verge\nimport os.lock\n\nimport Combine\n\n@available(iOS 13.0, *)\nfinal class VergeStoreTests: XCTestCase {\n \n @Tracking\n struct _State {\n\n @Tracking\n struct TreeA {\n \n }\n \n @Tracking\n struct TreeB {\n \n }\n \n @Tracking\n struct TreeC {\n \n }\n \n struct NestedState: Equatable {\n \n var myName: String = \"\"\n }\n \n struct OptionalNestedState: Equatable {\n \n var myName: String = \"\"\n }\n \n var count: Int = 0\n var optionalNested: OptionalNestedState?\n var nested: NestedState = .init()\n \n var treeA: TreeA = TreeA()\n var treeB: TreeB = TreeB()\n var treeC: TreeC = TreeC()\n \n }\n \n final class _Store: Verge.Store<_State, Never>, @unchecked Sendable {\n\n init() {\n super.init(initialState: .init(), logger: DefaultStoreLogger.default)\n }\n }\n \n class RootDispatcher: StoreDriverType {\n\n enum Error: Swift.Error {\n case something\n }\n\n var scope: WritableKeyPath {\n \\.self\n }\n\n let store: _Store\n\n init(store: _Store) {\n self.store = store\n }\n\n func resetCount() {\n return commit { s in\n s.count = 0\n }\n }\n \n func increment() {\n commit {\n $0.count += 1\n }\n }\n \n func setNestedState() {\n commit {\n $0.optionalNested = .init()\n }\n }\n \n func setMyName() {\n commit {\n if $0.optionalNested != nil {\n $0.optionalNested?.myName = \"Muuk\"\n }\n }\n }\n \n func returnSomeValue() -> String {\n return commit { _ in\n return \"Hello, Verge\"\n }\n }\n \n func continuousIncrement() {\n increment()\n increment()\n }\n \n func failableIncrement() throws {\n try commit { state in\n throw Error.something\n }\n }\n \n func hoge() {\n \n let _detached = detached(from: \\.nested)\n \n let _: Changes = _detached.state\n\n _detached.commit { (state: inout TargetStore.State.NestedState) in\n\n }\n \n let optionalNestedTarget = detached(from: \\.optionalNested)\n \n let _: Changes = optionalNestedTarget.state\n\n optionalNestedTarget.commit { (state: inout TargetStore.State.OptionalNestedState?) in\n\n }\n \n }\n \n }\n \n /**\n Use Edge due to TreeA does not have Equatable.\n */\n final class TreeADispatcher: StoreDriverType {\n\n let store: _Store\n let scope: WritableKeyPath & Sendable = \\.treeA\n\n init(store: _Store) {\n self.store = store\n }\n \n func operation() {\n \n let _: Changes<_State.TreeA> = state\n \n commit { (state: inout _State.TreeA) in\n\n }\n \n let treeB = detached(from: \\.treeB)\n \n let _: Changes<_State.TreeB> = treeB.state\n \n treeB.commit { (state: inout _State.TreeB) in\n\n }\n \n }\n }\n \n let store = _Store()\n lazy var dispatcher = RootDispatcher(store: self.store)\n\n var subs = Set()\n \n override func setUp() {\n // Put setup code here. This method is called before the invocation of each test method in the class.\n }\n \n override func tearDown() {\n // Put teardown code here. This method is called after the invocation of each test method in the class.\n }\n \n func testCommit() {\n\n let store = DemoStore()\n\n store.commit {\n $0.count = 100\n }\n\n XCTAssertEqual(store.state.count, 100)\n\n store.commit {\n $0.inner.name = \"mmm\"\n }\n\n XCTAssertEqual(store.state.inner.name, \"mmm\")\n\n let exp = expectation(description: \"async\")\n\n DispatchQueue.global().async {\n store.commit {\n $0.inner.name = \"xxx\"\n }\n XCTAssertEqual(store.state.inner.name, \"xxx\")\n exp.fulfill()\n }\n\n wait(for: [exp], timeout: 1)\n\n }\n\n func testEmptyCommit() {\n\n let store = DemoStore()\n\n let count = VergeConcurrency.UnfairLockAtomic.init(0)\n\n let subs = store.sinkState(queue: .passthrough) { (_) in\n count.modify { $0 += 1 }\n }\n\n XCTAssertEqual(store.state.version, 0)\n\n store.commit {\n $0.count = 100\n }\n\n XCTAssertEqual(store.state.version, 1)\n\n store.commit { _ in\n\n }\n\n // no changes\n XCTAssertEqual(store.state.version, 1)\n\n store.commit {\n $0.count = 100\n }\n\n // many times calling empty commits\n for _ in 0..<3 {\n store.commit { _ in }\n }\n\n // no affects from read a value\n store.commit {\n if $0.count > 100 {\n $0.count = 0\n XCTFail()\n }\n }\n\n XCTAssertEqual(store.state.version, 2)\n XCTAssertEqual(count.value, 3)\n\n withExtendedLifetime(subs, {})\n \n }\n\n func testDispatch() {\n \n dispatcher.resetCount()\n dispatcher.resetCount()\n \n dispatcher.resetCount()\n dispatcher.continuousIncrement()\n XCTAssert(store.state.primitive.count == 2)\n }\n \n func testTryMutation() {\n \n do {\n try dispatcher.failableIncrement()\n XCTFail()\n } catch {\n \n }\n \n }\n \n func testIncrement() {\n \n dispatcher.increment()\n XCTAssertEqual(store.state.primitive.count, 1)\n \n }\n \n func testTargetingCommit() {\n \n dispatcher.setNestedState()\n dispatcher.setMyName()\n XCTAssertEqual(store.state.primitive.optionalNested?.myName, \"Muuk\")\n }\n \n func testReturnAnyValueFromMutation() {\n \n let r = dispatcher.returnSomeValue()\n \n XCTAssertEqual(r, \"Hello, Verge\")\n \n }\n \n func testSubscription() {\n \n var subscriptions = Set()\n let count = VergeConcurrency.UnfairLockAtomic.init(0)\n \n store.sinkState(queue: .passthrough) { (changes) in\n count.modify {\n $0 += 1\n }\n }\n .store(in: &subscriptions)\n \n store.commit {\n $0.count += 1\n }\n \n // stop subscribing\n subscriptions = .init()\n\n store.commit {\n $0.count += 1\n }\n \n XCTAssertEqual(count.value, 2)\n \n }\n \n @MainActor\n func testChangesPublisher() {\n \n let store = DemoStore()\n \n XCTContext.runActivity(named: \"Premise\") { (activity) in\n \n XCTAssertEqual(store.state.hasChanges(\\.count), true)\n \n store.commit {\n $0.count = $0.count\n }\n \n XCTAssertEqual(store.state.hasChanges(\\.count), false)\n \n }\n \n XCTContext.runActivity(named: \"startsFromInitial: true\") { (activity) in\n \n let exp1 = expectation(description: \"\")\n \n _ = store.statePublisher()\n .sink { changes in\n exp1.fulfill()\n XCTAssertEqual(changes.hasChanges(\\.count), true)\n }\n \n XCTAssertEqual(exp1.expectedFulfillmentCount, 1)\n \n wait(for: [exp1], timeout: 1)\n \n }\n \n }\n\n func testAsigneeFromStore() {\n\n let store1 = DemoStore()\n let store2 = DemoStore()\n\n let sub = store1\n .assign(to: store2.assignee(\\.recursive))\n\n store1.commit {\n $0.count += 1\n }\n\n XCTAssertEqual(store1.state.primitive.count, store2.state.primitive.recursive?.count)\n\n store1.commit {\n $0.count += 1\n }\n\n XCTAssertEqual(store1.state.primitive.count, store2.state.primitive.recursive?.count)\n\n withExtendedLifetime(sub, {})\n\n }\n \n enum MyError: Error {\n case something\n }\n\n func testThrowing() {\n \n let store = DemoStore()\n \n do {\n try store.commit { _ in\n throw MyError.something\n }\n } catch {\n print(error)\n }\n \n }\n\n func testAsigneeFromDerived() {\n \n let store1 = DemoStore()\n let store2 = DemoStore()\n \n let sub = store1\n .derived(.map(\\.count), queue: .passthrough)\n .assign(to: store2.assignee(\\.count))\n \n store1.commit {\n $0.count += 1\n }\n \n XCTAssertEqual(store1.state.primitive.count, store2.state.primitive.count)\n \n store1.commit {\n $0.count += 1\n }\n \n XCTAssertEqual(store1.state.primitive.count, store2.state.primitive.count)\n \n withExtendedLifetime(sub, {})\n \n }\n\n final class DemoStoreWrapper2: StoreDriverType {\n\n struct State: Equatable {\n var source: Changes\n }\n\n let store: Verge.Store\n var sub: StoreStateSubscription? = nil\n\n init(sourceStore: DemoStore) {\n\n let d = sourceStore\n .derived(.map(\\.count), queue: .passthrough)\n\n self.store = .init(initialState: .init(source: d.state), logger: nil)\n\n sub = d.assign(to: store.assignee(\\.source))\n\n }\n\n }\n \n func testAsignee2() {\n\n let store1 = DemoStore()\n let store2 = DemoStoreWrapper2(sourceStore: store1)\n\n store1.commit {\n $0.count += 1\n }\n \n XCTAssertEqual(store1.state.primitive.count, store2.state.primitive.source.root)\n\n store1.commit {\n $0.count += 1\n }\n \n XCTAssertEqual(store1.state.primitive.count, store2.state.primitive.source.root)\n\n }\n\n func testScan() {\n\n let store1 = DemoStore()\n\n let expect = expectation(description: \"\")\n\n let subscription = store1.sinkState(scan: Scan(seed: 0, accumulator: { v, c in v += 1 })) { changes, accumulated in\n XCTAssertEqual(accumulated, 1)\n expect.fulfill()\n }\n\n withExtendedLifetime(subscription) {}\n wait(for: [expect], timeout: 1)\n }\n \n func testMapIfPresent() {\n \n let store = _Store()\n \n XCTAssert(store.state.optionalNested == nil)\n \n do {\n \n let state = store.state\n \n if let _ = state.mapIfPresent(\\.optionalNested) {\n XCTFail()\n }\n \n }\n \n store.commit {\n $0.optionalNested = .init()\n }\n \n do {\n \n let state = store.state\n \n if let nested = state.mapIfPresent(\\.optionalNested) {\n XCTAssert(nested.previous == nil)\n } else {\n XCTFail()\n }\n \n }\n \n store.commit {\n $0.optionalNested!.myName = \"hello\"\n }\n \n do {\n \n let state = store.state\n \n if let nested = state.mapIfPresent(\\.optionalNested) {\n XCTAssert(nested.previous != nil)\n } else {\n XCTFail()\n }\n \n }\n }\n \n}\n" }, { "path": "Tests/VergeTinyTests/VergeTinyTests.swift", "content": "//\n// Copyright (c) 2021 Hiroshi Kimura(Muukii) \n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\nimport VergeTiny\nimport XCTest\n\nfinal class VergeTinyTests: XCTestCase {\n\n func testDefineProperty() {\n\n let filter = DynamicPropertyStorage()\n\n let property = filter.defineProperty(Int.self)\n\n XCTAssertEqual(property.value, nil)\n\n property.value = 1\n\n XCTAssertEqual(property.value, 1)\n }\n\n func testDistinct() {\n\n let filter = DynamicPropertyStorage()\n\n let property = filter.defineProperty(Int.self)\n\n let exp = expectation(description: \"\")\n exp.assertForOverFulfill = true\n exp.expectedFulfillmentCount = 2\n\n property.doIfChanged(1) { value in\n XCTAssertEqual(value, 1)\n exp.fulfill()\n }\n\n property.doIfChanged(1) { value in\n XCTFail()\n }\n\n property.doIfChanged(2) { value in\n XCTAssertEqual(value, 2)\n exp.fulfill()\n }\n\n wait(for: [exp], timeout: 0)\n }\n\n func testDistinctOptional() {\n\n let filter = DynamicPropertyStorage()\n\n let property = filter.defineProperty(Int?.self)\n\n let exp = expectation(description: \"\")\n exp.assertForOverFulfill = true\n exp.expectedFulfillmentCount = 4\n\n property.doIfChanged(nil) { value in\n XCTAssertEqual(value, nil)\n exp.fulfill()\n }\n\n property.doIfChanged(nil) { value in\n XCTFail()\n }\n\n property.doIfChanged(1) { value in\n XCTAssertEqual(value, 1)\n exp.fulfill()\n }\n\n property.doIfChanged(1) { value in\n XCTFail()\n }\n\n property.doIfChanged(2) { value in\n XCTAssertEqual(value, 2)\n exp.fulfill()\n }\n\n property.doIfChanged(nil) { value in\n XCTAssertEqual(value, nil)\n exp.fulfill()\n }\n\n property.doIfChanged(nil) { value in\n XCTFail()\n }\n\n wait(for: [exp], timeout: 0)\n }\n\n func testPerformanceCreatingProperty() {\n\n let filter = DynamicPropertyStorage()\n measure {\n let _ = filter.defineProperty(Int?.self)\n }\n }\n\n func testPerformanceAccessingProperty() {\n\n let filter = DynamicPropertyStorage()\n let property = filter.defineProperty(Int.self)\n property.value = 1\n measure {\n property.value? += 1\n }\n }\n}\n" }, { "path": "Verge.playground/Pages/Memo.xcplaygroundpage/Contents.swift", "content": "\nenum Action {\n case increment\n case decrement\n}\n\nclass Store {\n\n var state: State\n}\n" }, { "path": "Verge.playground/Pages/PlainStorePattern1.xcplaygroundpage/Contents.swift", "content": "import UIKit\n\nclass ViewA: DemoUIView {\n \n // MARK: Components\n \n let nameLabel = UILabel()\n \n // MARK: State\n \n var name: String = \"\" {\n didSet {\n self.nameLabel.text = name\n }\n }\n \n}\n\n//: [Next](@next)\n\n" }, { "path": "Verge.playground/Pages/PlainStorePattern2.xcplaygroundpage/Contents.swift", "content": "//: [Previous](@previous)\n\nimport UIKit\n\nclass ViewA: DemoUIView {\n \n // MARK: Components\n \n let nameLabel = UILabel()\n let ageLabel = UILabel()\n \n // MARK: State\n \n var name: String = \"\" {\n didSet {\n self.nameLabel.text = name\n }\n }\n \n var age: Int = 0 {\n didSet {\n self.ageLabel.text = name\n }\n }\n \n}\n\n//: [Next](@next)\n" }, { "path": "Verge.playground/Pages/PlainStorePattern3.xcplaygroundpage/Contents.swift", "content": "//: [Previous](@previous)\nimport UIKit\n\nclass ViewA: DemoUIView {\n \n // MARK: Components\n \n let nameLabel = UILabel()\n let ageLabel = UILabel()\n \n // MARK: State\n \n struct State {\n var name: String = \"\"\n var age: Int = 0\n }\n \n var state: State {\n didSet {\n self.nameLabel.text = state.name\n self.ageLabel.text = state.age.description\n }\n }\n \n}\n//: [Next](@next)\n" }, { "path": "Verge.playground/Pages/PlainStorePattern4.xcplaygroundpage/Contents.swift", "content": "//: [Previous](@previous)\n\nimport Foundation\n\nimport UIKit\n\nstruct State {\n var name: String = \"\"\n var age: Int = 0\n}\n\nclass Store {\n \n // State type should be struct type to call didSet\n var state: State {\n didSet {\n // notify a update to subscribers\n }\n }\n \n init(_ state: State) {\n self.state = state\n }\n \n func onDidUpdate(_ closure: @escaping (State) -> Void) {\n // implement to notfy updates\n }\n}\n\nclass ViewA: DemoUIView {\n \n // MARK: Components\n \n let nameLabel = UILabel()\n let ageLabel = UILabel()\n \n // MARK: State\n \n let store: Store\n \n // MARK: - Initializers\n \n init(store: Store) {\n self.store = store\n \n super.init()\n \n store.onDidUpdate { [weak self] state in\n \n guard let self = self else { return }\n \n self.ageLabel.text = state.age.description\n self.nameLabel.text = state.name\n }\n }\n \n private func updateName() {\n store.state.name = \"Muukii\"\n // then, nameLabel updates to \"Muukii\" by store.onDidUpdate.\n }\n \n}\n\nclass ViewB: DemoUIView {\n \n // MARK: Components\n \n let nameLabel = UILabel()\n let ageLabel = UILabel()\n \n // MARK: State\n \n let store: Store\n \n // MARK: - Initializers\n \n init(store: Store) {\n self.store = store\n \n super.init()\n \n store.onDidUpdate { [weak self] state in\n \n guard let self = self else { return }\n \n self.ageLabel.text = state.age.description\n self.nameLabel.text = state.name\n }\n }\n \n}\n//: [Next](@next)\n" }, { "path": "Verge.playground/Pages/PlainStorePattern5.xcplaygroundpage/Contents.swift", "content": "//: [Previous](@previous)\n\nimport Foundation\nimport UIKit\n\nstruct State {\n var name: String = \"\"\n var age: Int = 0\n}\n\nclass Store {\n \n // State type should be struct type to call didSet\n var state: State {\n didSet {\n // notify a update to subscribers\n let old = oldValue\n let new = state\n }\n }\n \n init(_ state: State) {\n self.state = state\n }\n \n func onDidUpdate(_ closure: @escaping (_ old: State, _ new: State) -> Void) {\n // implement to notfy updates\n }\n}\n\nclass ViewA: DemoUIView {\n \n // MARK: Components\n \n let nameLabel = UILabel()\n let ageLabel = UILabel()\n \n // MARK: State\n \n let store: Store\n \n // MARK: - Initializers\n \n init(store: Store) {\n self.store = store\n \n super.init()\n \n store.onDidUpdate { [weak self] old, new in\n \n guard let self = self else { return }\n \n if old.name != new.name {\n self.nameLabel.text = new.name\n }\n if old.age != new.age {\n self.ageLabel.text = new.age.description\n }\n }\n }\n \n private func updateName() {\n store.state.name = \"Muukii\"\n // then, nameLabel updates to \"Muukii\" by store.onDidUpdate.\n }\n \n}\n\nclass ViewB: DemoUIView {\n \n // MARK: Components\n \n let nameLabel = UILabel()\n let ageLabel = UILabel()\n \n // MARK: State\n \n let store: Store\n \n // MARK: - Initializers\n \n init(store: Store) {\n self.store = store\n \n super.init()\n \n store.onDidUpdate { [weak self] old, new in\n \n guard let self = self else { return }\n \n if old.name != new.name {\n self.nameLabel.text = new.name\n }\n if old.age != new.age {\n self.ageLabel.text = new.age.description\n }\n }\n }\n \n}\n\n//: [Next](@next)\n" }, { "path": "Verge.playground/Pages/VergeStorePartern2.xcplaygroundpage/Contents.swift", "content": "//: [Previous](@previous)\nimport UIKit\n\nimport Verge\n\nstruct State {\n var name: String = \"\"\n var age: Int = 0\n}\n\nclass Store: VergeStore.Store {\n \n init() {\n super.init(initialState: State(), logger: nil)\n }\n \n func incrementAge() {\n commit {\n $0.age += 1\n }\n }\n \n func updateName(_ name: String) {\n commit {\n $0.name = name\n }\n }\n}\n\nclass ViewA: DemoUIView {\n \n let nameLabel = UILabel()\n let ageLabel = UILabel()\n \n let store: Store\n private var cancellable: VergeAnyCancellable?\n \n init(store: Store) {\n self.store = store\n \n super.init()\n \n cancellable = store.sinkChanges { [weak self] (changes) in\n self?.updateUI(changes: changes)\n }\n \n }\n \n private func updateUI(changes: Changes) {\n \n changes.ifChanged(\\.name) { name in\n nameLabel.text = name\n }\n \n changes.ifChanged(\\.age) { age in\n ageLabel.text = age.description\n }\n }\n \n}\n\n//: [Next](@next)\n" }, { "path": "Verge.playground/Pages/VergeStorePattern.xcplaygroundpage/Contents.swift", "content": "//: [Previous](@previous)\n\nimport Foundation\n\nimport UIKit\nimport Verge\n\nstruct State {\n var name: String = \"\"\n var age: Int = 0\n}\n\nclass Store: VergeStore.Store {\n \n init() {\n super.init(initialState: State(), logger: nil)\n }\n}\n\nclass ViewA: DemoUIView {\n \n // MARK: Components\n \n let nameLabel = UILabel()\n let ageLabel = UILabel()\n \n // MARK: State\n \n let store: Store\n private var cancellable: VergeAnyCancellable?\n \n // MARK: - Initializers\n \n init(store: Store) {\n self.store = store\n \n super.init()\n \n cancellable = store.sinkChanges { [weak self] (changes) in\n \n guard let self = self else { return }\n \n changes.ifChanged(\\.name) { name in\n self.nameLabel.text = name\n }\n \n changes.ifChanged(\\.age) { age in\n self.ageLabel.text = age.description\n }\n \n }\n \n }\n \n private func updateName() {\n store.commit {\n $0.name = \"Muukii\"\n }\n }\n \n}\n//: [Next](@next)\n" }, { "path": "Verge.playground/Sources/Wire.swift", "content": "import UIKit\n\nopen class DemoUIView: UIView {\n \n public init() {\n super.init(frame: .zero)\n }\n \n @available(*, unavailable)\n public required init?(coder: NSCoder) {\n fatalError(\"init(coder:) has not been implemented\")\n }\n}\n" }, { "path": "Verge.playground/contents.xcplayground", "content": "\n\n \n \n \n \n \n \n \n \n \n \n" }, { "path": "mise.toml", "content": "[tools]\ntuist = \"4.44.3\"\n" }, { "path": "playgrounds/.gitignore", "content": "!*.xcodeproj" }, { "path": "playgrounds/PlaySwiftUI/PlaySwiftUI/Assets.xcassets/AccentColor.colorset/Contents.json", "content": "{\n \"colors\" : [\n {\n \"idiom\" : \"universal\"\n }\n ],\n \"info\" : {\n \"author\" : \"xcode\",\n \"version\" : 1\n }\n}\n" }, { "path": "playgrounds/PlaySwiftUI/PlaySwiftUI/Assets.xcassets/AppIcon.appiconset/Contents.json", "content": "{\n \"images\" : [\n {\n \"idiom\" : \"universal\",\n \"platform\" : \"ios\",\n \"size\" : \"1024x1024\"\n },\n {\n \"appearances\" : [\n {\n \"appearance\" : \"luminosity\",\n \"value\" : \"dark\"\n }\n ],\n \"idiom\" : \"universal\",\n \"platform\" : \"ios\",\n \"size\" : \"1024x1024\"\n },\n {\n \"appearances\" : [\n {\n \"appearance\" : \"luminosity\",\n \"value\" : \"tinted\"\n }\n ],\n \"idiom\" : \"universal\",\n \"platform\" : \"ios\",\n \"size\" : \"1024x1024\"\n }\n ],\n \"info\" : {\n \"author\" : \"xcode\",\n \"version\" : 1\n }\n}\n" }, { "path": "playgrounds/PlaySwiftUI/PlaySwiftUI/Assets.xcassets/Contents.json", "content": "{\n \"info\" : {\n \"author\" : \"xcode\",\n \"version\" : 1\n }\n}\n" }, { "path": "playgrounds/PlaySwiftUI/PlaySwiftUI/ContentView.swift", "content": "//\n// ContentView.swift\n// PlaySwiftUI\n//\n// Created by Muukii on 2025/02/13.\n//\n\nimport SwiftUI\nimport Verge\n\n@Tracking\nstruct ContentState {\n \n @Tracking\n struct Info {\n \n let constant: String\n var name: String\n \n init(name: String = \"Init\") {\n self.constant = name\n self.name = name\n }\n }\n\n var info = Info()\n \n var count: Int = 0\n}\n\nenum AppContainer {\n static let store = Store<_, Never>(initialState: ContentState())\n}\n\nstruct ContentView: View {\n \n let store = AppContainer.store\n \n var body: some View {\n VStack {\n \n Button(\"Update Name\") {\n store.commit {\n $0.info.name = UUID().uuidString\n }\n }\n \n Button(\"Increment\") {\n store.commit {\n $0.count += 1\n }\n } \n \n Button(\"Replace info\") {\n store.commit {\n $0.info = .init(name: \"Replaced\")\n }\n } \n \n StoreReader(store) { (state: ContentState) in\n Text(state.info.name)\n Text(state.count.description)\n }\n \n StoreReader(store) { (state: ContentState) in\n Text(state.info.constant)\n }\n \n @StoreBindable var storeBindable = store\n TextField(\"Name\", text: $storeBindable.info.name)\n \n }\n .padding()\n }\n}\n\n#Preview {\n ContentView()\n}\n" }, { "path": "playgrounds/PlaySwiftUI/PlaySwiftUI/PlaySwiftUIApp.swift", "content": "//\n// PlaySwiftUIApp.swift\n// PlaySwiftUI\n//\n// Created by Muukii on 2025/02/13.\n//\n\nimport SwiftUI\n\n@main\nstruct PlaySwiftUIApp: App {\n var body: some Scene {\n WindowGroup {\n ContentView()\n }\n }\n}\n" }, { "path": "playgrounds/PlaySwiftUI/PlaySwiftUI/Preview Content/Preview Assets.xcassets/Contents.json", "content": "{\n \"info\" : {\n \"author\" : \"xcode\",\n \"version\" : 1\n }\n}\n" }, { "path": "playgrounds/PlaySwiftUI/PlaySwiftUI/Simple.swift", "content": "import SwiftUI\nimport Verge\n\nprivate struct _Book: View {\n \n @Tracking\n struct State {\n var count: Int = 0\n \n @Tracking\n struct NestedState {\n var isActive: Bool = false\n var message: String = \"Hello, Verge!\"\n }\n \n var nestedState: NestedState = NestedState()\n }\n \n let store = Store<_, Never>(initialState: State())\n \n var body: some View {\n StoreReader(store) { state in\n VStack {\n Text(\"Count: \\(state.count)\")\n Button(\"Increment\") {\n store.commit {\n $0.count += 1\n }\n }\n Text(\"Is Active: \\(state.nestedState.isActive)\")\n Text(\"Message: \\(state.nestedState.message)\")\n Button(\"Toggle Active\") {\n store.commit {\n $0.nestedState.isActive.toggle()\n }\n }\n }\n }\n }\n}\n\n#Preview(\"Simple\") {\n _Book()\n}\n" }, { "path": "playgrounds/PlaySwiftUI/PlaySwiftUI.xcodeproj/project.pbxproj", "content": "// !$*UTF8*$!\n{\n\tarchiveVersion = 1;\n\tclasses = {\n\t};\n\tobjectVersion = 77;\n\tobjects = {\n\n/* Begin PBXBuildFile section */\n\t\t4B8F11472D60E10B00FBCA80 /* Verge in Frameworks */ = {isa = PBXBuildFile; productRef = 4B8F11462D60E10B00FBCA80 /* Verge */; };\n\t\t4B8F114A2D60E13900FBCA80 /* Verge in Frameworks */ = {isa = PBXBuildFile; productRef = 4B8F11492D60E13900FBCA80 /* Verge */; };\n\t\t4B8F11632D60E1C900FBCA80 /* Verge in Frameworks */ = {isa = PBXBuildFile; productRef = 4B8F11622D60E1C900FBCA80 /* Verge */; };\n\t\t4BB8698B2D5E213200B2B2FB /* Verge in Frameworks */ = {isa = PBXBuildFile; productRef = 4BB8698A2D5E213200B2B2FB /* Verge */; };\n/* End PBXBuildFile section */\n\n/* Begin PBXFileReference section */\n\t\t4BB869782D5E205E00B2B2FB /* PlaySwiftUI.app */ = {isa = PBXFileReference; explicitFileType = wrapper.application; includeInIndex = 0; path = PlaySwiftUI.app; sourceTree = BUILT_PRODUCTS_DIR; };\n/* End PBXFileReference section */\n\n/* Begin PBXFileSystemSynchronizedRootGroup section */\n\t\t4BB8697A2D5E205E00B2B2FB /* PlaySwiftUI */ = {\n\t\t\tisa = PBXFileSystemSynchronizedRootGroup;\n\t\t\tpath = PlaySwiftUI;\n\t\t\tsourceTree = \"\";\n\t\t};\n/* End PBXFileSystemSynchronizedRootGroup section */\n\n/* Begin PBXFrameworksBuildPhase section */\n\t\t4BB869752D5E205E00B2B2FB /* Frameworks */ = {\n\t\t\tisa = PBXFrameworksBuildPhase;\n\t\t\tbuildActionMask = 2147483647;\n\t\t\tfiles = (\n\t\t\t\t4B8F114A2D60E13900FBCA80 /* Verge in Frameworks */,\n\t\t\t\t4B8F11472D60E10B00FBCA80 /* Verge in Frameworks */,\n\t\t\t\t4B8F11632D60E1C900FBCA80 /* Verge in Frameworks */,\n\t\t\t\t4BB8698B2D5E213200B2B2FB /* Verge in Frameworks */,\n\t\t\t);\n\t\t\trunOnlyForDeploymentPostprocessing = 0;\n\t\t};\n/* End PBXFrameworksBuildPhase section */\n\n/* Begin PBXGroup section */\n\t\t4BB8696F2D5E205E00B2B2FB = {\n\t\t\tisa = PBXGroup;\n\t\t\tchildren = (\n\t\t\t\t4BB8697A2D5E205E00B2B2FB /* PlaySwiftUI */,\n\t\t\t\t4BB869792D5E205E00B2B2FB /* Products */,\n\t\t\t);\n\t\t\tsourceTree = \"\";\n\t\t};\n\t\t4BB869792D5E205E00B2B2FB /* Products */ = {\n\t\t\tisa = PBXGroup;\n\t\t\tchildren = (\n\t\t\t\t4BB869782D5E205E00B2B2FB /* PlaySwiftUI.app */,\n\t\t\t);\n\t\t\tname = Products;\n\t\t\tsourceTree = \"\";\n\t\t};\n/* End PBXGroup section */\n\n/* Begin PBXNativeTarget section */\n\t\t4BB869772D5E205E00B2B2FB /* PlaySwiftUI */ = {\n\t\t\tisa = PBXNativeTarget;\n\t\t\tbuildConfigurationList = 4BB869862D5E205F00B2B2FB /* Build configuration list for PBXNativeTarget \"PlaySwiftUI\" */;\n\t\t\tbuildPhases = (\n\t\t\t\t4BB869742D5E205E00B2B2FB /* Sources */,\n\t\t\t\t4BB869752D5E205E00B2B2FB /* Frameworks */,\n\t\t\t\t4BB869762D5E205E00B2B2FB /* Resources */,\n\t\t\t);\n\t\t\tbuildRules = (\n\t\t\t);\n\t\t\tdependencies = (\n\t\t\t);\n\t\t\tfileSystemSynchronizedGroups = (\n\t\t\t\t4BB8697A2D5E205E00B2B2FB /* PlaySwiftUI */,\n\t\t\t);\n\t\t\tname = PlaySwiftUI;\n\t\t\tpackageProductDependencies = (\n\t\t\t\t4BB8698A2D5E213200B2B2FB /* Verge */,\n\t\t\t\t4B8F11462D60E10B00FBCA80 /* Verge */,\n\t\t\t\t4B8F11492D60E13900FBCA80 /* Verge */,\n\t\t\t\t4B8F11622D60E1C900FBCA80 /* Verge */,\n\t\t\t);\n\t\t\tproductName = PlaySwiftUI;\n\t\t\tproductReference = 4BB869782D5E205E00B2B2FB /* PlaySwiftUI.app */;\n\t\t\tproductType = \"com.apple.product-type.application\";\n\t\t};\n/* End PBXNativeTarget section */\n\n/* Begin PBXProject section */\n\t\t4BB869702D5E205E00B2B2FB /* Project object */ = {\n\t\t\tisa = PBXProject;\n\t\t\tattributes = {\n\t\t\t\tBuildIndependentTargetsInParallel = 1;\n\t\t\t\tLastSwiftUpdateCheck = 1620;\n\t\t\t\tLastUpgradeCheck = 1620;\n\t\t\t\tTargetAttributes = {\n\t\t\t\t\t4BB869772D5E205E00B2B2FB = {\n\t\t\t\t\t\tCreatedOnToolsVersion = 16.2;\n\t\t\t\t\t};\n\t\t\t\t};\n\t\t\t};\n\t\t\tbuildConfigurationList = 4BB869732D5E205E00B2B2FB /* Build configuration list for PBXProject \"PlaySwiftUI\" */;\n\t\t\tdevelopmentRegion = en;\n\t\t\thasScannedForEncodings = 0;\n\t\t\tknownRegions = (\n\t\t\t\ten,\n\t\t\t\tBase,\n\t\t\t);\n\t\t\tmainGroup = 4BB8696F2D5E205E00B2B2FB;\n\t\t\tminimizedProjectReferenceProxies = 1;\n\t\t\tpackageReferences = (\n\t\t\t\t4B8F11612D60E1C900FBCA80 /* XCLocalSwiftPackageReference \"../../../Verge\" */,\n\t\t\t);\n\t\t\tpreferredProjectObjectVersion = 77;\n\t\t\tproductRefGroup = 4BB869792D5E205E00B2B2FB /* Products */;\n\t\t\tprojectDirPath = \"\";\n\t\t\tprojectRoot = \"\";\n\t\t\ttargets = (\n\t\t\t\t4BB869772D5E205E00B2B2FB /* PlaySwiftUI */,\n\t\t\t);\n\t\t};\n/* End PBXProject section */\n\n/* Begin PBXResourcesBuildPhase section */\n\t\t4BB869762D5E205E00B2B2FB /* Resources */ = {\n\t\t\tisa = PBXResourcesBuildPhase;\n\t\t\tbuildActionMask = 2147483647;\n\t\t\tfiles = (\n\t\t\t);\n\t\t\trunOnlyForDeploymentPostprocessing = 0;\n\t\t};\n/* End PBXResourcesBuildPhase section */\n\n/* Begin PBXSourcesBuildPhase section */\n\t\t4BB869742D5E205E00B2B2FB /* Sources */ = {\n\t\t\tisa = PBXSourcesBuildPhase;\n\t\t\tbuildActionMask = 2147483647;\n\t\t\tfiles = (\n\t\t\t);\n\t\t\trunOnlyForDeploymentPostprocessing = 0;\n\t\t};\n/* End PBXSourcesBuildPhase section */\n\n/* Begin XCBuildConfiguration section */\n\t\t4BB869842D5E205F00B2B2FB /* Debug */ = {\n\t\t\tisa = XCBuildConfiguration;\n\t\t\tbuildSettings = {\n\t\t\t\tALWAYS_SEARCH_USER_PATHS = NO;\n\t\t\t\tASSETCATALOG_COMPILER_GENERATE_SWIFT_ASSET_SYMBOL_EXTENSIONS = YES;\n\t\t\t\tCLANG_ANALYZER_NONNULL = YES;\n\t\t\t\tCLANG_ANALYZER_NUMBER_OBJECT_CONVERSION = YES_AGGRESSIVE;\n\t\t\t\tCLANG_CXX_LANGUAGE_STANDARD = \"gnu++20\";\n\t\t\t\tCLANG_ENABLE_MODULES = YES;\n\t\t\t\tCLANG_ENABLE_OBJC_ARC = YES;\n\t\t\t\tCLANG_ENABLE_OBJC_WEAK = YES;\n\t\t\t\tCLANG_WARN_BLOCK_CAPTURE_AUTORELEASING = YES;\n\t\t\t\tCLANG_WARN_BOOL_CONVERSION = YES;\n\t\t\t\tCLANG_WARN_COMMA = YES;\n\t\t\t\tCLANG_WARN_CONSTANT_CONVERSION = YES;\n\t\t\t\tCLANG_WARN_DEPRECATED_OBJC_IMPLEMENTATIONS = YES;\n\t\t\t\tCLANG_WARN_DIRECT_OBJC_ISA_USAGE = YES_ERROR;\n\t\t\t\tCLANG_WARN_DOCUMENTATION_COMMENTS = YES;\n\t\t\t\tCLANG_WARN_EMPTY_BODY = YES;\n\t\t\t\tCLANG_WARN_ENUM_CONVERSION = YES;\n\t\t\t\tCLANG_WARN_INFINITE_RECURSION = YES;\n\t\t\t\tCLANG_WARN_INT_CONVERSION = YES;\n\t\t\t\tCLANG_WARN_NON_LITERAL_NULL_CONVERSION = YES;\n\t\t\t\tCLANG_WARN_OBJC_IMPLICIT_RETAIN_SELF = YES;\n\t\t\t\tCLANG_WARN_OBJC_LITERAL_CONVERSION = YES;\n\t\t\t\tCLANG_WARN_OBJC_ROOT_CLASS = YES_ERROR;\n\t\t\t\tCLANG_WARN_QUOTED_INCLUDE_IN_FRAMEWORK_HEADER = YES;\n\t\t\t\tCLANG_WARN_RANGE_LOOP_ANALYSIS = YES;\n\t\t\t\tCLANG_WARN_STRICT_PROTOTYPES = YES;\n\t\t\t\tCLANG_WARN_SUSPICIOUS_MOVE = YES;\n\t\t\t\tCLANG_WARN_UNGUARDED_AVAILABILITY = YES_AGGRESSIVE;\n\t\t\t\tCLANG_WARN_UNREACHABLE_CODE = YES;\n\t\t\t\tCLANG_WARN__DUPLICATE_METHOD_MATCH = YES;\n\t\t\t\tCOPY_PHASE_STRIP = NO;\n\t\t\t\tDEBUG_INFORMATION_FORMAT = dwarf;\n\t\t\t\tENABLE_STRICT_OBJC_MSGSEND = YES;\n\t\t\t\tENABLE_TESTABILITY = YES;\n\t\t\t\tENABLE_USER_SCRIPT_SANDBOXING = YES;\n\t\t\t\tGCC_C_LANGUAGE_STANDARD = gnu17;\n\t\t\t\tGCC_DYNAMIC_NO_PIC = NO;\n\t\t\t\tGCC_NO_COMMON_BLOCKS = YES;\n\t\t\t\tGCC_OPTIMIZATION_LEVEL = 0;\n\t\t\t\tGCC_PREPROCESSOR_DEFINITIONS = (\n\t\t\t\t\t\"DEBUG=1\",\n\t\t\t\t\t\"$(inherited)\",\n\t\t\t\t);\n\t\t\t\tGCC_WARN_64_TO_32_BIT_CONVERSION = YES;\n\t\t\t\tGCC_WARN_ABOUT_RETURN_TYPE = YES_ERROR;\n\t\t\t\tGCC_WARN_UNDECLARED_SELECTOR = YES;\n\t\t\t\tGCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE;\n\t\t\t\tGCC_WARN_UNUSED_FUNCTION = YES;\n\t\t\t\tGCC_WARN_UNUSED_VARIABLE = YES;\n\t\t\t\tIPHONEOS_DEPLOYMENT_TARGET = 18.2;\n\t\t\t\tLOCALIZATION_PREFERS_STRING_CATALOGS = YES;\n\t\t\t\tMTL_ENABLE_DEBUG_INFO = INCLUDE_SOURCE;\n\t\t\t\tMTL_FAST_MATH = YES;\n\t\t\t\tONLY_ACTIVE_ARCH = YES;\n\t\t\t\tSDKROOT = iphoneos;\n\t\t\t\tSWIFT_ACTIVE_COMPILATION_CONDITIONS = \"DEBUG $(inherited)\";\n\t\t\t\tSWIFT_OPTIMIZATION_LEVEL = \"-Onone\";\n\t\t\t};\n\t\t\tname = Debug;\n\t\t};\n\t\t4BB869852D5E205F00B2B2FB /* Release */ = {\n\t\t\tisa = XCBuildConfiguration;\n\t\t\tbuildSettings = {\n\t\t\t\tALWAYS_SEARCH_USER_PATHS = NO;\n\t\t\t\tASSETCATALOG_COMPILER_GENERATE_SWIFT_ASSET_SYMBOL_EXTENSIONS = YES;\n\t\t\t\tCLANG_ANALYZER_NONNULL = YES;\n\t\t\t\tCLANG_ANALYZER_NUMBER_OBJECT_CONVERSION = YES_AGGRESSIVE;\n\t\t\t\tCLANG_CXX_LANGUAGE_STANDARD = \"gnu++20\";\n\t\t\t\tCLANG_ENABLE_MODULES = YES;\n\t\t\t\tCLANG_ENABLE_OBJC_ARC = YES;\n\t\t\t\tCLANG_ENABLE_OBJC_WEAK = YES;\n\t\t\t\tCLANG_WARN_BLOCK_CAPTURE_AUTORELEASING = YES;\n\t\t\t\tCLANG_WARN_BOOL_CONVERSION = YES;\n\t\t\t\tCLANG_WARN_COMMA = YES;\n\t\t\t\tCLANG_WARN_CONSTANT_CONVERSION = YES;\n\t\t\t\tCLANG_WARN_DEPRECATED_OBJC_IMPLEMENTATIONS = YES;\n\t\t\t\tCLANG_WARN_DIRECT_OBJC_ISA_USAGE = YES_ERROR;\n\t\t\t\tCLANG_WARN_DOCUMENTATION_COMMENTS = YES;\n\t\t\t\tCLANG_WARN_EMPTY_BODY = YES;\n\t\t\t\tCLANG_WARN_ENUM_CONVERSION = YES;\n\t\t\t\tCLANG_WARN_INFINITE_RECURSION = YES;\n\t\t\t\tCLANG_WARN_INT_CONVERSION = YES;\n\t\t\t\tCLANG_WARN_NON_LITERAL_NULL_CONVERSION = YES;\n\t\t\t\tCLANG_WARN_OBJC_IMPLICIT_RETAIN_SELF = YES;\n\t\t\t\tCLANG_WARN_OBJC_LITERAL_CONVERSION = YES;\n\t\t\t\tCLANG_WARN_OBJC_ROOT_CLASS = YES_ERROR;\n\t\t\t\tCLANG_WARN_QUOTED_INCLUDE_IN_FRAMEWORK_HEADER = YES;\n\t\t\t\tCLANG_WARN_RANGE_LOOP_ANALYSIS = YES;\n\t\t\t\tCLANG_WARN_STRICT_PROTOTYPES = YES;\n\t\t\t\tCLANG_WARN_SUSPICIOUS_MOVE = YES;\n\t\t\t\tCLANG_WARN_UNGUARDED_AVAILABILITY = YES_AGGRESSIVE;\n\t\t\t\tCLANG_WARN_UNREACHABLE_CODE = YES;\n\t\t\t\tCLANG_WARN__DUPLICATE_METHOD_MATCH = YES;\n\t\t\t\tCOPY_PHASE_STRIP = NO;\n\t\t\t\tDEBUG_INFORMATION_FORMAT = \"dwarf-with-dsym\";\n\t\t\t\tENABLE_NS_ASSERTIONS = NO;\n\t\t\t\tENABLE_STRICT_OBJC_MSGSEND = YES;\n\t\t\t\tENABLE_USER_SCRIPT_SANDBOXING = YES;\n\t\t\t\tGCC_C_LANGUAGE_STANDARD = gnu17;\n\t\t\t\tGCC_NO_COMMON_BLOCKS = YES;\n\t\t\t\tGCC_WARN_64_TO_32_BIT_CONVERSION = YES;\n\t\t\t\tGCC_WARN_ABOUT_RETURN_TYPE = YES_ERROR;\n\t\t\t\tGCC_WARN_UNDECLARED_SELECTOR = YES;\n\t\t\t\tGCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE;\n\t\t\t\tGCC_WARN_UNUSED_FUNCTION = YES;\n\t\t\t\tGCC_WARN_UNUSED_VARIABLE = YES;\n\t\t\t\tIPHONEOS_DEPLOYMENT_TARGET = 18.2;\n\t\t\t\tLOCALIZATION_PREFERS_STRING_CATALOGS = YES;\n\t\t\t\tMTL_ENABLE_DEBUG_INFO = NO;\n\t\t\t\tMTL_FAST_MATH = YES;\n\t\t\t\tSDKROOT = iphoneos;\n\t\t\t\tSWIFT_COMPILATION_MODE = wholemodule;\n\t\t\t\tVALIDATE_PRODUCT = YES;\n\t\t\t};\n\t\t\tname = Release;\n\t\t};\n\t\t4BB869872D5E205F00B2B2FB /* Debug */ = {\n\t\t\tisa = XCBuildConfiguration;\n\t\t\tbuildSettings = {\n\t\t\t\tASSETCATALOG_COMPILER_APPICON_NAME = AppIcon;\n\t\t\t\tASSETCATALOG_COMPILER_GLOBAL_ACCENT_COLOR_NAME = AccentColor;\n\t\t\t\tCODE_SIGN_STYLE = Automatic;\n\t\t\t\tCURRENT_PROJECT_VERSION = 1;\n\t\t\t\tDEVELOPMENT_ASSET_PATHS = \"\\\"PlaySwiftUI/Preview Content\\\"\";\n\t\t\t\tENABLE_PREVIEWS = YES;\n\t\t\t\tGENERATE_INFOPLIST_FILE = YES;\n\t\t\t\tINFOPLIST_KEY_UIApplicationSceneManifest_Generation = YES;\n\t\t\t\tINFOPLIST_KEY_UIApplicationSupportsIndirectInputEvents = YES;\n\t\t\t\tINFOPLIST_KEY_UILaunchScreen_Generation = YES;\n\t\t\t\tINFOPLIST_KEY_UISupportedInterfaceOrientations_iPad = \"UIInterfaceOrientationPortrait UIInterfaceOrientationPortraitUpsideDown UIInterfaceOrientationLandscapeLeft UIInterfaceOrientationLandscapeRight\";\n\t\t\t\tINFOPLIST_KEY_UISupportedInterfaceOrientations_iPhone = \"UIInterfaceOrientationPortrait UIInterfaceOrientationLandscapeLeft UIInterfaceOrientationLandscapeRight\";\n\t\t\t\tLD_RUNPATH_SEARCH_PATHS = (\n\t\t\t\t\t\"$(inherited)\",\n\t\t\t\t\t\"@executable_path/Frameworks\",\n\t\t\t\t);\n\t\t\t\tMARKETING_VERSION = 1.0;\n\t\t\t\tPRODUCT_BUNDLE_IDENTIFIER = app.muukii.PlaySwiftUI;\n\t\t\t\tPRODUCT_NAME = \"$(TARGET_NAME)\";\n\t\t\t\tSWIFT_EMIT_LOC_STRINGS = YES;\n\t\t\t\tSWIFT_VERSION = 5.0;\n\t\t\t\tTARGETED_DEVICE_FAMILY = \"1,2\";\n\t\t\t};\n\t\t\tname = Debug;\n\t\t};\n\t\t4BB869882D5E205F00B2B2FB /* Release */ = {\n\t\t\tisa = XCBuildConfiguration;\n\t\t\tbuildSettings = {\n\t\t\t\tASSETCATALOG_COMPILER_APPICON_NAME = AppIcon;\n\t\t\t\tASSETCATALOG_COMPILER_GLOBAL_ACCENT_COLOR_NAME = AccentColor;\n\t\t\t\tCODE_SIGN_STYLE = Automatic;\n\t\t\t\tCURRENT_PROJECT_VERSION = 1;\n\t\t\t\tDEVELOPMENT_ASSET_PATHS = \"\\\"PlaySwiftUI/Preview Content\\\"\";\n\t\t\t\tENABLE_PREVIEWS = YES;\n\t\t\t\tGENERATE_INFOPLIST_FILE = YES;\n\t\t\t\tINFOPLIST_KEY_UIApplicationSceneManifest_Generation = YES;\n\t\t\t\tINFOPLIST_KEY_UIApplicationSupportsIndirectInputEvents = YES;\n\t\t\t\tINFOPLIST_KEY_UILaunchScreen_Generation = YES;\n\t\t\t\tINFOPLIST_KEY_UISupportedInterfaceOrientations_iPad = \"UIInterfaceOrientationPortrait UIInterfaceOrientationPortraitUpsideDown UIInterfaceOrientationLandscapeLeft UIInterfaceOrientationLandscapeRight\";\n\t\t\t\tINFOPLIST_KEY_UISupportedInterfaceOrientations_iPhone = \"UIInterfaceOrientationPortrait UIInterfaceOrientationLandscapeLeft UIInterfaceOrientationLandscapeRight\";\n\t\t\t\tLD_RUNPATH_SEARCH_PATHS = (\n\t\t\t\t\t\"$(inherited)\",\n\t\t\t\t\t\"@executable_path/Frameworks\",\n\t\t\t\t);\n\t\t\t\tMARKETING_VERSION = 1.0;\n\t\t\t\tPRODUCT_BUNDLE_IDENTIFIER = app.muukii.PlaySwiftUI;\n\t\t\t\tPRODUCT_NAME = \"$(TARGET_NAME)\";\n\t\t\t\tSWIFT_EMIT_LOC_STRINGS = YES;\n\t\t\t\tSWIFT_VERSION = 5.0;\n\t\t\t\tTARGETED_DEVICE_FAMILY = \"1,2\";\n\t\t\t};\n\t\t\tname = Release;\n\t\t};\n/* End XCBuildConfiguration section */\n\n/* Begin XCConfigurationList section */\n\t\t4BB869732D5E205E00B2B2FB /* Build configuration list for PBXProject \"PlaySwiftUI\" */ = {\n\t\t\tisa = XCConfigurationList;\n\t\t\tbuildConfigurations = (\n\t\t\t\t4BB869842D5E205F00B2B2FB /* Debug */,\n\t\t\t\t4BB869852D5E205F00B2B2FB /* Release */,\n\t\t\t);\n\t\t\tdefaultConfigurationIsVisible = 0;\n\t\t\tdefaultConfigurationName = Release;\n\t\t};\n\t\t4BB869862D5E205F00B2B2FB /* Build configuration list for PBXNativeTarget \"PlaySwiftUI\" */ = {\n\t\t\tisa = XCConfigurationList;\n\t\t\tbuildConfigurations = (\n\t\t\t\t4BB869872D5E205F00B2B2FB /* Debug */,\n\t\t\t\t4BB869882D5E205F00B2B2FB /* Release */,\n\t\t\t);\n\t\t\tdefaultConfigurationIsVisible = 0;\n\t\t\tdefaultConfigurationName = Release;\n\t\t};\n/* End XCConfigurationList section */\n\n/* Begin XCLocalSwiftPackageReference section */\n\t\t4B8F11612D60E1C900FBCA80 /* XCLocalSwiftPackageReference \"../../../Verge\" */ = {\n\t\t\tisa = XCLocalSwiftPackageReference;\n\t\t\trelativePath = ../../../Verge;\n\t\t};\n/* End XCLocalSwiftPackageReference section */\n\n/* Begin XCSwiftPackageProductDependency section */\n\t\t4B8F11462D60E10B00FBCA80 /* Verge */ = {\n\t\t\tisa = XCSwiftPackageProductDependency;\n\t\t\tproductName = Verge;\n\t\t};\n\t\t4B8F11492D60E13900FBCA80 /* Verge */ = {\n\t\t\tisa = XCSwiftPackageProductDependency;\n\t\t\tproductName = Verge;\n\t\t};\n\t\t4B8F11622D60E1C900FBCA80 /* Verge */ = {\n\t\t\tisa = XCSwiftPackageProductDependency;\n\t\t\tproductName = Verge;\n\t\t};\n\t\t4BB8698A2D5E213200B2B2FB /* Verge */ = {\n\t\t\tisa = XCSwiftPackageProductDependency;\n\t\t\tproductName = Verge;\n\t\t};\n/* End XCSwiftPackageProductDependency section */\n\t};\n\trootObject = 4BB869702D5E205E00B2B2FB /* Project object */;\n}\n" }, { "path": "playgrounds/PlaySwiftUI/PlaySwiftUI.xcodeproj/project.xcworkspace/contents.xcworkspacedata", "content": "\n\n \n \n\n" }, { "path": "playgrounds/PlaySwiftUI/PlaySwiftUI.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved", "content": "{\n \"originHash\" : \"91b2bd4d42ac7a19338699d5fcae987277fc6461718b80e90459a6235bafabb2\",\n \"pins\" : [\n {\n \"identity\" : \"normalization\",\n \"kind\" : \"remoteSourceControl\",\n \"location\" : \"https://github.com/VergeGroup/Normalization\",\n \"state\" : {\n \"revision\" : \"6e7cb1ddeda4d0f1d2fbf8ca6d25ecd8ed6ba917\",\n \"version\" : \"1.1.0\"\n }\n },\n {\n \"identity\" : \"rxswift\",\n \"kind\" : \"remoteSourceControl\",\n \"location\" : \"https://github.com/ReactiveX/RxSwift.git\",\n \"state\" : {\n \"revision\" : \"c7c7d2cf50a3211fe2843f76869c698e4e417930\",\n \"version\" : \"6.8.0\"\n }\n },\n {\n \"identity\" : \"swift-atomics\",\n \"kind\" : \"remoteSourceControl\",\n \"location\" : \"https://github.com/apple/swift-atomics.git\",\n \"state\" : {\n \"revision\" : \"cd142fd2f64be2100422d658e7411e39489da985\",\n \"version\" : \"1.2.0\"\n }\n },\n {\n \"identity\" : \"swift-collections\",\n \"kind\" : \"remoteSourceControl\",\n \"location\" : \"https://github.com/apple/swift-collections\",\n \"state\" : {\n \"revision\" : \"671108c96644956dddcd89dd59c203dcdb36cec7\",\n \"version\" : \"1.1.4\"\n }\n },\n {\n \"identity\" : \"swift-concurrency-task-manager\",\n \"kind\" : \"remoteSourceControl\",\n \"location\" : \"https://github.com/VergeGroup/swift-concurrency-task-manager\",\n \"state\" : {\n \"revision\" : \"340cf14e0282977deeeb436605d1810ce4f4fbc9\",\n \"version\" : \"1.4.0\"\n }\n },\n {\n \"identity\" : \"swift-macro-state-struct\",\n \"kind\" : \"remoteSourceControl\",\n \"location\" : \"https://github.com/VergeGroup/swift-macro-state-struct\",\n \"state\" : {\n \"branch\" : \"main\",\n \"revision\" : \"88e3937abd26b76bafe9027938538966457f156f\"\n }\n },\n {\n \"identity\" : \"swift-syntax\",\n \"kind\" : \"remoteSourceControl\",\n \"location\" : \"https://github.com/apple/swift-syntax.git\",\n \"state\" : {\n \"revision\" : \"0687f71944021d616d34d922343dcef086855920\",\n \"version\" : \"600.0.1\"\n }\n },\n {\n \"identity\" : \"typedcomparator\",\n \"kind\" : \"remoteSourceControl\",\n \"location\" : \"https://github.com/VergeGroup/TypedComparator\",\n \"state\" : {\n \"revision\" : \"337ce0e573e7637ddd29392cb88c3b852f042c8e\",\n \"version\" : \"1.0.0\"\n }\n },\n {\n \"identity\" : \"typedidentifier\",\n \"kind\" : \"remoteSourceControl\",\n \"location\" : \"https://github.com/VergeGroup/TypedIdentifier\",\n \"state\" : {\n \"revision\" : \"284340409ba47858a1b3c353dcef9c21303953db\",\n \"version\" : \"2.0.3\"\n }\n }\n ],\n \"version\" : 3\n}\n" } ]