Merge branch 'v0.3.0'

Author: sdpopov-keyvariable

Sources/Sample/ABCD.swift

@@ -58,6 +58,20 @@ extension KvEnvironmentScope {
         /// A property having no default value.
         var c: C
     }
+}
+/// Specify access modifiers (e.g. public, private, etc.) for the extensions
+/// to manage visibility of produced environment properties.
+private extension KvEnvironmentScope {
     /// Constant declarations are transformed to computed properties having getters only.
     #kvEnvironment { let a_ee: A = .init(a: 0xEE), a_ff: A? = .init(a: 0xFF) }
 }
+/// Below is an example of explicit declaration of an environment property.
+private extension KvEnvironmentScope {
+    private struct aZeroKey : KvEnvironmentKey {
+        static var defaultValue: A { .init(a: 0) }
+    }
+    var zeroA: A {
+        get { self[aZeroKey.self] }
+        set { self[aZeroKey.self] = newValue }
+    }
+}

Sources/kvEnvironmentMacros/KvEnvironmentScopeEntryMacro.swift

@@ -33,6 +33,11 @@ public struct KvEnvironmentScopeEntryMacro: DeclarationMacro {
     ) throws -> [DeclSyntax] {
         let closure: ClosureExprSyntax
 
+        try (node as? WithModifiersSyntax)?.modifiers.forEach {
+            guard Constants.accessModifiers.contains($0.name)
+            else { throw ExpansionError("unexpected access modifier `\($0.trimmedDescription)`. Apply access modifiers to the entire extension") }
+        }
+
         switch node.argumentList.last {
         case .none:
             guard let trailingClosure = node.trailingClosure
@@ -113,6 +118,19 @@ public struct KvEnvironmentScopeEntryMacro: DeclarationMacro {
         }
     }
 
+    // MARK: .Constants
+
+    private enum Constants {
+        static var accessModifiers: Set<TokenSyntax> { [
+            .keyword(.fileprivate),
+            .keyword(.internal),
+            .keyword(.open),
+            .keyword(.package),
+            .keyword(.private),
+            .keyword(.public),
+        ] }
+    }
+
     // MARK: .EntryDescription
 
     private struct EntryDescription {