Initial commit

Author: robb

.github/FUNDING.yml

@@ -0,0 +1 @@
+github: [robb]

.gitignore

@@ -0,0 +1,8 @@
+.DS_Store
+/.build
+/Packages
+xcuserdata/
+DerivedData/
+.swiftpm/configuration/registries.json
+.swiftpm/xcode/package.xcworkspace/contents.xcworkspacedata
+.netrc

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Robert Böhnke
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

Package.swift

@@ -0,0 +1,28 @@
+// swift-tools-version: 6.0
+// The swift-tools-version declares the minimum version of Swift required to build this package.
+
+import PackageDescription
+
+let package = Package(
+    name: "AtRandom",
+    platforms: [
+        .iOS(.v16),
+        .macOS(.v13),
+        .macCatalyst(.v16),
+        .watchOS(.v9),
+        .tvOS(.v16),
+        .visionOS(.v1),
+    ],
+    products: [
+        // Products define the executables and libraries a package produces, making them visible to other packages.
+        .library(
+            name: "AtRandom",
+            targets: ["AtRandom"]),
+    ],
+    targets: [
+        // Targets are the basic building blocks of a package, defining a module or a test suite.
+        // Targets can depend on other targets in this package and products from dependencies.
+        .target(
+            name: "AtRandom"),
+    ]
+)

README.md

@@ -0,0 +1,48 @@
+# @Random
+
+A property wrapper that assigns a stable random value to a member variable, persisting across multiple `body` invocations.
+
+Use this to introduce variation in animations without relying on `@State`.
+
+For example
+
+```swift
+struct RandomOffsetTransition: Transition {
+    @Random(distance: 20) var offset: CGSize
+
+    func body(content: Content, phase: TransitionPhase) -> some View {
+        content.offset(offset)
+    }
+}
+```
+
+will create a transition that animates the view from a random offset.
+
+## Fixed Seeds
+
+By default, different instances of the same `View` or `ViewModifier` generate unique `@Random` values. To ensure consistency, you can provide a custom seed via the property wrapper’s `projectedValue`.
+
+For example, assigning a model’s `hashValue` to `$greeting` ensures stability when the view gets recreated, say in a `LazyVStack`.
+
+```swift
+struct Cell: View {
+    @Random(in: "Hello", "Bonjour", "Willkommen") var greeting
+
+    var model: Model
+
+    init(model: Model) {
+        self.model = model
+        $greeting = model.hashValue
+    }
+
+    var body: some View {
+      // The same `model` will get the same `greeting`, every time.
+      Text("\(greeting), \(model.name)!")
+    }
+}
+```
+
+This way, each `Cell` instance with the same model will always produce the same greeting.
+
+> [!IMPORTANT]  
+> Some Swift types, like `String`, generate different `hashValues` across app launches. For values that persist _across_ launches, use a stable identifier, such as a user ID.