mirror of
https://github.com/phranck/TUIkit.git
synced 2026-05-21 09:50:35 +00:00
phranck
5ad97132b8
- Replace custom Observable protocol and @Published with Apple's @Observable macro - Add withObservationTracking in renderToBuffer for automatic per-property dependency tracking - Add type-based @Environment(Type.self) and .environment(object) for observable objects - Add ObjectEnvironmentModifier for injecting observable objects into the environment - Add needsCacheClear flag to AppState for thread-safe cache invalidation - Add cross-platform test script (scripts/test-linux.sh) for Docker-based Linux verification - Add DemoAppHeader with system info display (OS, version, architecture) - Consolidate Example App: extract ImageDemoHelpers, KeyboardHelpSection, ValueDisplayRow - Add pre-push verification rule to CLAUDE.md - Verified on both macOS and Linux (swift:6.0 container), 1155 tests passing
92 lines
2.8 KiB
Swift
92 lines
2.8 KiB
Swift
// 🖥️ TUIKit — Terminal UI Kit for Swift
|
||
// EnvironmentKey.swift
|
||
//
|
||
// Created by LAYERED.work
|
||
// License: MIT
|
||
|
||
import Observation
|
||
|
||
// MARK: - Environment Key Protocol
|
||
|
||
/// A key for accessing values in the environment.
|
||
///
|
||
/// Conform to this protocol to define custom environment values.
|
||
///
|
||
/// # Example
|
||
///
|
||
/// ```swift
|
||
/// struct MyCustomKey: EnvironmentKey {
|
||
/// static var defaultValue: String = "default"
|
||
/// }
|
||
///
|
||
/// extension EnvironmentValues {
|
||
/// var myCustomValue: String {
|
||
/// get { self[MyCustomKey.self] }
|
||
/// set { self[MyCustomKey.self] = newValue }
|
||
/// }
|
||
/// }
|
||
/// ```
|
||
public protocol EnvironmentKey {
|
||
/// The type of value stored by this key.
|
||
associatedtype Value
|
||
|
||
/// The default value for this key.
|
||
static var defaultValue: Value { get }
|
||
}
|
||
|
||
// MARK: - Environment Values
|
||
|
||
/// A collection of environment values propagated through the view hierarchy.
|
||
///
|
||
/// Environment values flow down from parent views to child views.
|
||
/// Each view can read environment values and optionally override them
|
||
/// for its children.
|
||
public struct EnvironmentValues: @unchecked Sendable {
|
||
/// Storage for environment values.
|
||
private var storage: [ObjectIdentifier: Any] = [:]
|
||
|
||
/// Creates an empty environment values container.
|
||
public init() {}
|
||
|
||
/// Accesses the environment value for the given key.
|
||
///
|
||
/// - Parameter key: The type of the environment key.
|
||
/// - Returns: The value for the key, or its default value if not set.
|
||
public subscript<K: EnvironmentKey>(key: K.Type) -> K.Value {
|
||
get {
|
||
if let value = storage[ObjectIdentifier(key)] as? K.Value {
|
||
return value
|
||
}
|
||
return K.defaultValue
|
||
}
|
||
set {
|
||
storage[ObjectIdentifier(key)] = newValue
|
||
}
|
||
}
|
||
|
||
/// Accesses an observable object stored by its type.
|
||
///
|
||
/// Objects stored via `.environment(model)` are keyed by
|
||
/// `ObjectIdentifier(type(of: object))`, enabling type-based lookup
|
||
/// via `@Environment(MyModel.self)`.
|
||
///
|
||
/// - Parameter type: The observable object's type.
|
||
/// - Returns: The stored object, or `nil` if not set.
|
||
public subscript<T: Observable>(observable type: T.Type) -> T? {
|
||
get { storage[ObjectIdentifier(type)] as? T }
|
||
set { storage[ObjectIdentifier(type)] = newValue }
|
||
}
|
||
|
||
/// Creates a copy of this environment with a modified value.
|
||
///
|
||
/// - Parameters:
|
||
/// - keyPath: The key path to the value to modify.
|
||
/// - value: The new value.
|
||
/// - Returns: A new EnvironmentValues with the modified value.
|
||
public func setting<V>(_ keyPath: WritableKeyPath<Self, V>, to value: V) -> Self {
|
||
var copy = self
|
||
copy[keyPath: keyPath] = value
|
||
return copy
|
||
}
|
||
}
|