Adjust interface template comments (#904)

Author: tinder-cfuller

Sources/NodesGenerator/Resources/Stencils/Interface.stencil

@@ -6,19 +6,17 @@ import {{ import }}
 {% endfor %}
 {% endif %}
 
-// This file defines the protocols and types in the interface requiring public ACL for use in another module.
+/*
+ This file defines the protocols and types in the interface requiring public ACL for use in another module.
+ */
 {% if node_name != "App" %}
 
-// MARK: - Listener
-
 /// Defines the delegate protocol through which the `Context` interfaces with its listener.
 /// @mockable
 @MainActor
 internal protocol {{ node_name }}Listener: AnyObject {}
 {% endif %}
 
-// MARK: - Flow
-
 /// @mockable
 @MainActor
 {% if owns_view %}
@@ -35,8 +33,6 @@ internal protocol {{ node_name }}Flow: Flow {
 internal protocol {{ node_name }}Flow: Flow {}
 {% endif %}
 
-// MARK: - Builder
-
 {% if is_periphery_comment_enabled %}
 // periphery:ignore
 {% endif %}

Sources/NodesGenerator/Resources/Stencils/PluginInterface.stencil

@@ -6,7 +6,9 @@ import {{ import }}
 {% endfor %}
 {% endif %}
 
-// This file defines the protocols and types in the plugin interface requiring public ACL for use in another module.
+/*
+ This file defines the protocols and types in the plugin interface requiring public ACL for use in another module.
+ */
 
 /// Dynamic state from the caller provided to the plugin to use in determining whether it is enabled.
 /// - NOTE: An alias to a tuple is supported.

Sources/NodesGenerator/Resources/Stencils/PluginListInterface.stencil

@@ -6,7 +6,9 @@ import {{ import }}
 {% endfor %}
 {% endif %}
 
-// This file defines the protocols and types in the Plugin List interface requiring public ACL for use in another module.
+/*
+ This file defines the protocols and types in the plugin list interface requiring public ACL for use in another module.
+ */
 
 /// Declares the type of key used to identify plugins within the collection.
 /// - NOTE: May be any ``Hashable`` type such as ``String`` or an enumeration.

Tests/NodesGeneratorTests/__Snapshots__/PresetGeneratorTests/testGenerateAppPreset.Contents-AppInterface-swift.txt

@@ -4,16 +4,14 @@
 
 import Nodes
 
-// This file defines the protocols and types in the interface requiring public ACL for use in another module.
-
-// MARK: - Flow
+/*
+ This file defines the protocols and types in the interface requiring public ACL for use in another module.
+ */
 
 /// @mockable
 @MainActor
 internal protocol AppFlow: Flow {}
 
-// MARK: - Builder
-
 /// @mockable
 @MainActor
 internal protocol AppBuilder: AnyObject {

Tests/NodesGeneratorTests/__Snapshots__/PresetGeneratorTests/testGenerateRootPreset.Contents-RootInterface-swift.txt

@@ -4,23 +4,19 @@
 
 import Nodes
 
-// This file defines the protocols and types in the interface requiring public ACL for use in another module.
-
-// MARK: - Listener
+/*
+ This file defines the protocols and types in the interface requiring public ACL for use in another module.
+ */
 
 /// Defines the delegate protocol through which the `Context` interfaces with its listener.
 /// @mockable
 @MainActor
 internal protocol RootListener: AnyObject {}
 
-// MARK: - Flow
-
 /// @mockable
 @MainActor
 internal protocol RootFlow: ViewControllableFlow {}
 
-// MARK: - Builder
-
 /// @mockable
 @MainActor
 internal protocol RootBuilder: AnyObject {

Tests/NodesGeneratorTests/__Snapshots__/PresetGeneratorTests/testGenerateScenePreset.Contents-WindowSceneInterface-swift.txt

@@ -4,25 +4,21 @@
 
 import Nodes
 
-// This file defines the protocols and types in the interface requiring public ACL for use in another module.
-
-// MARK: - Listener
+/*
+ This file defines the protocols and types in the interface requiring public ACL for use in another module.
+ */
 
 /// Defines the delegate protocol through which the `Context` interfaces with its listener.
 /// @mockable
 @MainActor
 internal protocol WindowSceneListener: AnyObject {}
 
-// MARK: - Flow
-
 /// @mockable
 @MainActor
 internal protocol WindowSceneFlow: Flow {
     func getViewController() -> WindowSceneViewControllable
 }
 
-// MARK: - Builder
-
 /// @mockable
 @MainActor
 internal protocol WindowSceneBuilder: AnyObject {

Tests/NodesGeneratorTests/__Snapshots__/PresetGeneratorTests/testGenerateWindowPreset.Contents-WindowInterface-swift.txt

@@ -4,23 +4,19 @@
 
 import Nodes
 
-// This file defines the protocols and types in the interface requiring public ACL for use in another module.
-
-// MARK: - Listener
+/*
+ This file defines the protocols and types in the interface requiring public ACL for use in another module.
+ */
 
 /// Defines the delegate protocol through which the `Context` interfaces with its listener.
 /// @mockable
 @MainActor
 internal protocol WindowListener: AnyObject {}
 
-// MARK: - Flow
-
 /// @mockable
 @MainActor
 internal protocol WindowFlow: Flow {}
 
-// MARK: - Builder
-
 /// @mockable
 @MainActor
 internal protocol WindowBuilder: AnyObject {

Tests/NodesGeneratorTests/__Snapshots__/StencilRendererTests/testRenderNode.Interface-AppKit-mockCount-0.txt

@@ -1,22 +1,18 @@
 //<fileHeader>
 
-// This file defines the protocols and types in the interface requiring public ACL for use in another module.
-
-// MARK: - Listener
+/*
+ This file defines the protocols and types in the interface requiring public ACL for use in another module.
+ */
 
 /// Defines the delegate protocol through which the `Context` interfaces with its listener.
 /// @mockable
 @MainActor
 internal protocol <nodeName>Listener: AnyObject {}
 
-// MARK: - Flow
-
 /// @mockable
 @MainActor
 internal protocol <nodeName>Flow: <viewControllableFlowType> {}
 
-// MARK: - Builder
-
 /// @mockable
 @MainActor
 internal protocol <nodeName>Builder: AnyObject {

Tests/NodesGeneratorTests/__Snapshots__/StencilRendererTests/testRenderNode.Interface-AppKit-mockCount-1.txt

@@ -2,23 +2,19 @@
 
 import <interfaceImport>
 
-// This file defines the protocols and types in the interface requiring public ACL for use in another module.
-
-// MARK: - Listener
+/*
+ This file defines the protocols and types in the interface requiring public ACL for use in another module.
+ */
 
 /// Defines the delegate protocol through which the `Context` interfaces with its listener.
 /// @mockable
 @MainActor
 internal protocol <nodeName>Listener: AnyObject {}
 
-// MARK: - Flow
-
 /// @mockable
 @MainActor
 internal protocol <nodeName>Flow: <pluginListName>Flow {}
 
-// MARK: - Builder
-
 // periphery:ignore
 /// @mockable
 @MainActor

Tests/NodesGeneratorTests/__Snapshots__/StencilRendererTests/testRenderNode.Interface-AppKit-mockCount-2.txt

@@ -3,23 +3,19 @@
 import <interfaceImport1>
 import <interfaceImport2>
 
-// This file defines the protocols and types in the interface requiring public ACL for use in another module.
-
-// MARK: - Listener
+/*
+ This file defines the protocols and types in the interface requiring public ACL for use in another module.
+ */
 
 /// Defines the delegate protocol through which the `Context` interfaces with its listener.
 /// @mockable
 @MainActor
 internal protocol <nodeName>Listener: AnyObject {}
 
-// MARK: - Flow
-
 /// @mockable
 @MainActor
 internal protocol <nodeName>Flow: <pluginListName>Flow {}
 
-// MARK: - Builder
-
 // periphery:ignore
 /// @mockable
 @MainActor

Tests/NodesGeneratorTests/__Snapshots__/StencilRendererTests/testRenderNode.Interface-Custom-mockCount-0.txt

@@ -1,22 +1,18 @@
 //<fileHeader>
 
-// This file defines the protocols and types in the interface requiring public ACL for use in another module.
-
-// MARK: - Listener
+/*
+ This file defines the protocols and types in the interface requiring public ACL for use in another module.
+ */
 
 /// Defines the delegate protocol through which the `Context` interfaces with its listener.
 /// @mockable
 @MainActor
 internal protocol <nodeName>Listener: AnyObject {}
 
-// MARK: - Flow
-
 /// @mockable
 @MainActor
 internal protocol <nodeName>Flow: <viewControllableFlowType> {}
 
-// MARK: - Builder
-
 /// @mockable
 @MainActor
 internal protocol <nodeName>Builder: AnyObject {

Tests/NodesGeneratorTests/__Snapshots__/StencilRendererTests/testRenderNode.Interface-Custom-mockCount-1.txt

@@ -2,23 +2,19 @@
 
 import <interfaceImport>
 
-// This file defines the protocols and types in the interface requiring public ACL for use in another module.
-
-// MARK: - Listener
+/*
+ This file defines the protocols and types in the interface requiring public ACL for use in another module.
+ */
 
 /// Defines the delegate protocol through which the `Context` interfaces with its listener.
 /// @mockable
 @MainActor
 internal protocol <nodeName>Listener: AnyObject {}
 
-// MARK: - Flow
-
 /// @mockable
 @MainActor
 internal protocol <nodeName>Flow: <pluginListName>Flow {}
 
-// MARK: - Builder
-
 // periphery:ignore
 /// @mockable
 @MainActor

Tests/NodesGeneratorTests/__Snapshots__/StencilRendererTests/testRenderNode.Interface-Custom-mockCount-2.txt

@@ -3,23 +3,19 @@
 import <interfaceImport1>
 import <interfaceImport2>
 
-// This file defines the protocols and types in the interface requiring public ACL for use in another module.
-
-// MARK: - Listener
+/*
+ This file defines the protocols and types in the interface requiring public ACL for use in another module.
+ */
 
 /// Defines the delegate protocol through which the `Context` interfaces with its listener.
 /// @mockable
 @MainActor
 internal protocol <nodeName>Listener: AnyObject {}
 
-// MARK: - Flow
-
 /// @mockable
 @MainActor
 internal protocol <nodeName>Flow: <pluginListName>Flow {}
 
-// MARK: - Builder
-
 // periphery:ignore
 /// @mockable
 @MainActor

Tests/NodesGeneratorTests/__Snapshots__/StencilRendererTests/testRenderNode.Interface-UIKit-mockCount-0.txt

@@ -1,22 +1,18 @@
 //<fileHeader>
 
-// This file defines the protocols and types in the interface requiring public ACL for use in another module.
-
-// MARK: - Listener
+/*
+ This file defines the protocols and types in the interface requiring public ACL for use in another module.
+ */
 
 /// Defines the delegate protocol through which the `Context` interfaces with its listener.
 /// @mockable
 @MainActor
 internal protocol <nodeName>Listener: AnyObject {}
 
-// MARK: - Flow
-
 /// @mockable
 @MainActor
 internal protocol <nodeName>Flow: <viewControllableFlowType> {}
 
-// MARK: - Builder
-
 /// @mockable
 @MainActor
 internal protocol <nodeName>Builder: AnyObject {

Tests/NodesGeneratorTests/__Snapshots__/StencilRendererTests/testRenderNode.Interface-UIKit-mockCount-1.txt

@@ -2,23 +2,19 @@
 
 import <interfaceImport>
 
-// This file defines the protocols and types in the interface requiring public ACL for use in another module.
-
-// MARK: - Listener
+/*
+ This file defines the protocols and types in the interface requiring public ACL for use in another module.
+ */
 
 /// Defines the delegate protocol through which the `Context` interfaces with its listener.
 /// @mockable
 @MainActor
 internal protocol <nodeName>Listener: AnyObject {}
 
-// MARK: - Flow
-
 /// @mockable
 @MainActor
 internal protocol <nodeName>Flow: <pluginListName>Flow {}
 
-// MARK: - Builder
-
 // periphery:ignore
 /// @mockable
 @MainActor

Tests/NodesGeneratorTests/__Snapshots__/StencilRendererTests/testRenderNode.Interface-UIKit-mockCount-2.txt

@@ -3,23 +3,19 @@
 import <interfaceImport1>
 import <interfaceImport2>
 
-// This file defines the protocols and types in the interface requiring public ACL for use in another module.
-
-// MARK: - Listener
+/*
+ This file defines the protocols and types in the interface requiring public ACL for use in another module.
+ */
 
 /// Defines the delegate protocol through which the `Context` interfaces with its listener.
 /// @mockable
 @MainActor
 internal protocol <nodeName>Listener: AnyObject {}
 
-// MARK: - Flow
-
 /// @mockable
 @MainActor
 internal protocol <nodeName>Flow: <pluginListName>Flow {}
 
-// MARK: - Builder
-
 // periphery:ignore
 /// @mockable
 @MainActor