Merge branch 'main' into feat/cli

Author: artus9033

apps/TesterIntegrated/swift/App.swift

@@ -55,8 +55,6 @@ struct MyApp: App {
   }
 
   struct FullScreenView: View {
-    @UseStore<BrownfieldStore> var store
-
     var body: some View {
       NavigationView {
         VStack {
@@ -66,19 +64,8 @@ struct MyApp: App {
             .padding()
             .multilineTextAlignment(.center)
 
-          Text("Count: \(Int(store.state.counter))")
-
-          TextField("Name", text: Binding(get: { store.state.user.name }, set: { data in
-            store.set { $0.user.name = data }
-          }))
-          .textFieldStyle(.roundedBorder)
-          .padding(.horizontal)
-
-          Button("Increment") {
-            store.set { $0.counter += 1 }
-          }
-          .buttonStyle(.borderedProminent)
-          .padding(.bottom)
+          CounterView()
+          UserView()
 
           NavigationLink("Push React Native Screen") {
             ReactNativeView(moduleName: "ReactNative")
@@ -94,26 +81,49 @@ struct MyApp: App {
     }
   }
 
+  struct CounterView: View {
+    @UseStore(\BrownfieldStore.counter) var counter
+
+    var body: some View {
+      VStack {
+        Text("Count: \(Int(counter))")
+        Stepper(value: $counter, label: { Text("Increment") })
+        
+        .buttonStyle(.borderedProminent)
+        .padding(.bottom)
+      }
+    }
+  }
+
+  struct UserView: View {
+    @UseStore(\BrownfieldStore.user.name) var name
+
+    var body: some View {
+      TextField("Name", text: $name)
+        .textFieldStyle(.roundedBorder)
+        .padding(.horizontal)
+    }
+  }
+
   struct NativeView: View {
-    @UseStore<BrownfieldStore> var store
+    @UseStore(\BrownfieldStore.counter) var counter
+    @UseStore(\BrownfieldStore.user) var user
 
     var body: some View {
       VStack {
         Text("Native Side")
           .font(.headline)
           .padding(.top)
 
-        Text("User: \(store.state.user.name)")
-        Text("Count: \(Int(store.state.counter))")
+        Text("User: \(user.name)")
+        Text("Count: \(Int(counter))")
 
-        TextField("Name", text: Binding(get: { store.state.user.name }, set: { data in
-          store.set { $0.user.name = data }
-        }))
+        TextField("Name", text: $user.name)
         .textFieldStyle(.roundedBorder)
         .padding(.horizontal)
 
         Button("Increment") {
-          store.set { $0.counter += 1 }
+          $counter.set { $0 + 1 }
         }
         .buttonStyle(.borderedProminent)
 

apps/TesterIntegrated/swift/Generated/BrownfieldStore.swift

@@ -5,16 +5,28 @@ import Brownie
 //
 //   let brownfieldStore = try? JSONDecoder().decode(BrownfieldStore.self, from: jsonData)
 
+//
+// Hashable or Equatable:
+// The compiler will not be able to synthesize the implementation of Hashable or Equatable
+// for types that require the use of JSONAny, nor will the implementation of Hashable be
+// synthesized for types that have collections (such as arrays or dictionaries).
+
 import Foundation
 
 // MARK: - BrownfieldStore
-struct BrownfieldStore: Codable {
+struct BrownfieldStore: Codable, Equatable {
     var counter: Double
     var user: User
 }
 
+//
+// Hashable or Equatable:
+// The compiler will not be able to synthesize the implementation of Hashable or Equatable
+// for types that require the use of JSONAny, nor will the implementation of Hashable be
+// synthesized for types that have collections (such as arrays or dictionaries).
+
 // MARK: - User
-struct User: Codable {
+struct User: Codable, Equatable {
     var name: String
 }
 

apps/TesterIntegrated/swift/Generated/SettingsStore.swift

@@ -5,15 +5,21 @@ import Brownie
 //
 //   let settingsStore = try? JSONDecoder().decode(SettingsStore.self, from: jsonData)
 
+//
+// Hashable or Equatable:
+// The compiler will not be able to synthesize the implementation of Hashable or Equatable
+// for types that require the use of JSONAny, nor will the implementation of Hashable be
+// synthesized for types that have collections (such as arrays or dictionaries).
+
 import Foundation
 
 // MARK: - SettingsStore
-struct SettingsStore: Codable {
+struct SettingsStore: Codable, Equatable {
     var notificationsEnabled, privacyMode: Bool
     var theme: Theme
 }
 
-enum Theme: String, Codable {
+enum Theme: String, Codable, Equatable {
     case dark = "dark"
     case light = "light"
 }

docs/docs/_nav.json

@@ -3,5 +3,10 @@
     "text": "Docs",
     "link": "/docs/getting-started/quick-start",
     "activeMatch": "^/docs/"
+  },
+  {
+    "text": "Brownie (Alpha)",
+    "link": "/brownie/overview",
+    "activeMatch": "^/brownie/"
   }
 ]

docs/docs/brownie/_meta.json

@@ -0,0 +1,27 @@
+[
+  {
+    "type": "file",
+    "name": "overview",
+    "label": "Overview"
+  },
+  {
+    "type": "file",
+    "name": "store-definition",
+    "label": "Defining Stores"
+  },
+  {
+    "type": "file",
+    "name": "codegen",
+    "label": "Code Generation"
+  },
+  {
+    "type": "file",
+    "name": "typescript-usage",
+    "label": "TypeScript Usage"
+  },
+  {
+    "type": "file",
+    "name": "swift-usage",
+    "label": "Swift Usage"
+  }
+]

docs/docs/brownie/codegen.mdx

@@ -0,0 +1,116 @@
+# Code Generation
+
+The Brownie CLI generates native types from your TypeScript store definitions.
+
+## Usage
+
+```bash
+brownie codegen                   # Generate for all configured platforms
+brownie codegen -p swift          # Generate Swift only
+brownie codegen --platform kotlin # Generate Kotlin only (coming soon)
+brownie --help                    # Show help
+brownie --version                 # Show version
+```
+
+## Configuration
+
+Add to your app's `package.json`:
+
+```json
+{
+  "brownie": {
+    "swift": "./ios/Generated/",
+    "kotlin": "./android/app/src/main/java/com/example/",
+    "kotlinPackageName": "com.example"
+  }
+}
+```
+
+| Field               | Required | Description                                                |
+| ------------------- | -------- | ---------------------------------------------------------- |
+| `swift`             | No\*     | Output directory for Swift files                           |
+| `kotlin`            | No\*     | Output directory for Kotlin files                          |
+| `kotlinPackageName` | No       | Kotlin package name (extracted from path if not specified) |
+
+\*At least one of `swift` or `kotlin` is required.
+
+## Generated Output
+
+For this TypeScript definition:
+
+```ts
+interface BrownfieldStore extends BrownieStore {
+  counter: number;
+  user: { name: string };
+}
+```
+
+### Swift Output
+
+```swift
+import Brownie
+
+struct BrownfieldStore: Codable {
+    var counter: Double
+    var user: User
+}
+
+struct User: Codable {
+    var name: String
+}
+
+extension BrownfieldStore: BrownieStoreProtocol {
+    public static let storeName = "BrownfieldStore"
+}
+```
+
+The generated struct:
+
+- Conforms to `Codable` for JSON serialization
+- Conforms to `BrownieStoreProtocol` with auto-generated `storeName`
+- Uses mutable `var` properties
+
+### Kotlin Output (Coming Soon)
+
+```kotlin
+package com.example
+
+data class BrownfieldStore(
+    val counter: Double,
+    val user: User
+)
+
+data class User(
+    val name: String
+)
+```
+
+## Auto-Generation Hooks
+
+### iOS (Podfile)
+
+Run codegen before pod install:
+
+```ruby
+pre_install do |installer|
+  system("npx", "brownie", "codegen", "-p", "swift")
+end
+```
+
+### Android (build.gradle.kts)
+
+Run codegen before build:
+
+```kotlin
+tasks.register("generateBrownfieldStore") {
+  exec { commandLine("npx", "brownie", "codegen", "-p", "kotlin") }
+}
+preBuild.dependsOn("generateBrownfieldStore")
+```
+
+## How It Works
+
+1. CLI recursively finds all `*.brownie.ts` files
+2. Parses `declare module '@callstack/brownie'` blocks using ts-morph
+3. Extracts store names from `BrownieStores` interface
+4. Generates native types using quicktype