feat(impl)!: refactor namespaces to reduce complexity

docs/SortDecissionEvent.md

@@ -0,0 +1,35 @@
+# SortDecisionEvent
+
+## Description
+A `SortDecisionEvent` is a predefined `ITriggerEvent` that can be used specifically 
+to handle route decisions. Whenever a window passes a virtual trigger (trigger point) 
+that has a `SortDecisionEvent`, it is checked whether the item should trigger an 
+action of the `ExitHandler` at this trigger point.
+Further more before and after the EventHandler, User defined (`IUserDefinedEvent`) events can be executed.
+
+## Public interface:
+|||
+|-|-|
+| SortStrategy : ISortStrategy; | Checks whether an action should be triggered for the item at this trigger point |
+|ExitHandler : IExitPointHandler;|  Action() of the IExitPointHandler is executed when SortStrategy.Check() returns TRUE|
+|EventBefore : IUserDefinedEvent;|  Userdefined event which is called before the Action() of the IExitPointHandler is called |
+|EventAfter : IUserDefinedEvent; | Userdefined event which is called after the Action() of the IExitPointHandler is called |
+
+## Class diagramm
+```mermaid
+classDiagram
+SortDecisionEvent--|>ITriggerEvent
+SortDecisionEvent : SortStrategy ISortStrategy
+SortDecisionEvent : ExitHandler IExitPointHandler
+SortDecisionEvent : EventBefore IUserDefinedEvent
+SortDecisionEvent : EventAfter IUserDefinedEvent
+ITriggerEvent : Action()
+ITriggerEvent : ActionAfter() 
+ISortStrategy..SortDecisionEvent
+ISortStrategy : Check(ITransportWindow, IVirtualTrigger, IExitPointHandler)
+IExitPointHandler..SortDecisionEvent
+IUserDefinedEvent..SortDecisionEvent
+IUserDefinedEvent : EventStatus Action(IVirtualTrigger, ITransportWindow)
+IExitPointHandler : BOOL Ready()
+IExitPointHandler : BOOL Activate()
+```

src/EventHandler/EventStatus.st

@@ -1,4 +1,4 @@
-NAMESPACE Simatic.Ax.WindowTracking.EventHandler
+NAMESPACE Simatic.Ax.WindowTracking
 
     TYPE
         EventStatus : (Undefined, Finished, Error, NullReference, NotEnabled) := Undefined;

src/EventHandler/ITriggerEvent.st

@@ -1,6 +1,4 @@
-USING Simatic.Ax.WindowTracking.Trigger;
-
-NAMESPACE Simatic.Ax.WindowTracking.EventHandler
+NAMESPACE Simatic.Ax.WindowTracking
     INTERFACE ITriggerEvent
         METHOD Action : EventStatus
             VAR_INPUT

src/EventHandler/IUserDefinedEvent.st

@@ -1,6 +1,4 @@
-USING Simatic.Ax.WindowTracking.Trigger;
-
-NAMESPACE Simatic.Ax.WindowTracking.EventHandler
+NAMESPACE Simatic.Ax.WindowTracking
     INTERFACE IUserDefinedEvent
         METHOD Action : EventStatus
             VAR_INPUT

src/EventHandler/SortDecisionEvent.st

@@ -1,10 +1,20 @@
-USING Simatic.Ax.WindowTracking.EventHandler;
-USING Simatic.Ax.WindowTracking.Trigger;
-USING Simatic.Ax.WindowTracking.SortDecision;
-USING Simatic.Ax.WindowTracking.ExitPointHandler;
-
-NAMESPACE Simatic.Ax.WindowTracking.EventHandler
-    CLASS SortDecisionEvent IMPLEMENTS ITriggerEvent
+NAMESPACE Simatic.Ax.WindowTracking
+/// A sort decision event is a predefined trigger event that can be used specifically 
+/// to handle route decisions. Whenever a window passes a virtual trigger (trigger point) 
+/// that has a `sort decision event`, it is checked whether the item should trigger an 
+/// action at this trigger point. 
+///
+/// Public interface:
+/// SortStrategy : ISortStrategy;   
+///   Checks whether an action should be triggered for the item at this trigger point 
+///
+/// ExitHandler : IExitPointHandler;
+///   Action() of the IExitPointHandler is executed when SortStrategy.Check() returns TRUE
+/// 
+/// EventBefore : IUserDefinedEvent;  Userdefined event which is called before the Action() of the IExitPointHandler is called
+/// EventAfter : IUserDefinedEvent;   Userdefined event which is called after the Action() of the IExitPointHandler is called
+{axcode:docs-v0:@simatic-ax/windowtracking:SortDecissionEvent.md}
+CLASS FINAL SortDecisionEvent IMPLEMENTS ITriggerEvent
 
         VAR PUBLIC
             SortStrategy : ISortStrategy;

src/EventHandler/TerminateWindowEvent.st

@@ -1,7 +1,5 @@
-USING Simatic.Ax.WindowTracking.Trigger;
-
-NAMESPACE Simatic.Ax.WindowTracking.EventHandler
-    CLASS TerminateWindowEvent IMPLEMENTS ITriggerEvent
+NAMESPACE Simatic.Ax.WindowTracking
+    CLASS FINAL TerminateWindowEvent IMPLEMENTS ITriggerEvent
         VAR PUBLIC
             WindowList : ITransportWindowsTerminate;
             EventBefore : IUserDefinedEvent;

src/Items/IItem.st

@@ -1,6 +1,6 @@
-USING Simatic.Ax.WindowTracking.EventHandler;
-USING Simatic.Ax.WindowTracking.Trigger;
-NAMESPACE Simatic.Ax.WindowTracking.Items
+USING Simatic.Ax.WindowTracking;
+
+NAMESPACE Simatic.Ax.WindowTracking
     INTERFACE IItem
         METHOD GetDestination : IVirtualTrigger
             VAR_INPUT 

src/Items/Item1Destination.st

@@ -1,6 +1,4 @@
-USING Simatic.Ax.WindowTracking.Trigger;
-
-NAMESPACE Simatic.Ax.WindowTracking.Items
+NAMESPACE Simatic.Ax.WindowTracking
     CLASS ItemOneDestination IMPLEMENTS IItem
 
         VAR PUBLIC

src/Others/IExitPointHandler.st

@@ -1,4 +1,4 @@
-NAMESPACE Simatic.Ax.WindowTracking.ExitPointHandler
+NAMESPACE Simatic.Ax.WindowTracking
     INTERFACE IExitPointHandler
         METHOD IsReady : BOOL
         END_METHOD

src/Others/ISortStrategy.st

@@ -1,7 +1,6 @@
-USING Simatic.Ax.WindowTracking.Trigger;
-USING Simatic.Ax.WindowTracking.ExitPointHandler;
+USING Simatic.Ax.WindowTracking;
 
-NAMESPACE Simatic.Ax.WindowTracking.SortDecision
+NAMESPACE Simatic.Ax.WindowTracking
     INTERFACE ISortStrategy
         METHOD Check : BOOL
             VAR_INPUT

src/Others/SortDecisionOneDestination.st

@@ -1,8 +1,4 @@
-USING Simatic.Ax.WindowTracking.Items;
-USING Simatic.Ax.WindowTracking.Trigger;
-USING Simatic.Ax.WindowTracking.ExitPointHandler;
-
-NAMESPACE Simatic.Ax.WindowTracking.SortDecision
+NAMESPACE Simatic.Ax.WindowTracking
     CLASS SortDecisionOneDestination IMPLEMENTS ISortStrategy
         VAR PUBLIC
 

src/Trigger/ITriggerList.st

@@ -1,4 +1,4 @@
-NAMESPACE Simatic.Ax.WindowTracking.Trigger
+NAMESPACE Simatic.Ax.WindowTracking
     INTERFACE ITriggerList
 
         METHOD Add : BOOL

src/Trigger/IVirtualTrigger.st

@@ -1,6 +1,6 @@
-USING Simatic.Ax.WindowTracking.EventHandler;
+USING Simatic.Ax.WindowTracking;
 
-NAMESPACE Simatic.Ax.WindowTracking.Trigger
+NAMESPACE Simatic.Ax.WindowTracking
     INTERFACE IVirtualTrigger
 
         METHOD ActivateEvent : EventStatus

src/Trigger/VirtualTrigger.st

@@ -1,7 +1,7 @@
-USING Simatic.Ax.WindowTracking.EventHandler;
+USING Simatic.Ax.WindowTracking;
 
-NAMESPACE Simatic.Ax.WindowTracking.Trigger
-    CLASS VirtualTrigger IMPLEMENTS IVirtualTrigger
+NAMESPACE Simatic.Ax.WindowTracking
+    CLASS FINAL VirtualTrigger IMPLEMENTS IVirtualTrigger
 
         VAR PUBLIC
             Position : DINT;

src/Trigger/VirtualTriggerList.st

@@ -1,5 +1,5 @@
-NAMESPACE Simatic.Ax.WindowTracking.Trigger
-    CLASS VirtualTriggerList IMPLEMENTS ITriggerList
+NAMESPACE Simatic.Ax.WindowTracking
+    CLASS FINAL VirtualTriggerList IMPLEMENTS ITriggerList
         VAR PUBLIC
             PositiveTolerance : DINT := 5;
             NegativeTolerance : DINT := 5;

src/Window/ITransportWindow.st

@@ -1,4 +1,3 @@
-USING Simatic.Ax.WindowTracking.Items;
 USING Simatic.Ax.SimpleControlModules;
 
 NAMESPACE Simatic.Ax.WindowTracking

src/Window/ITransportWindowsTerminate.st

@@ -1,6 +1,3 @@
-USING Simatic.Ax.WindowTracking.Trigger;
-USING Simatic.Ax.SimpleControlModules;
-
 NAMESPACE Simatic.Ax.WindowTracking
     INTERFACE ITransportWindowsTerminate
 

src/Window/TransportWindow.st

@@ -1,8 +1,8 @@
 USING Simatic.Ax.SimpleControlModules;
-USING Simatic.Ax.WindowTracking.Items;
+
 NAMESPACE Simatic.Ax.WindowTracking
 
-    CLASS TransportWindow IMPLEMENTS ITransportWindow
+    CLASS FINAL TransportWindow IMPLEMENTS ITransportWindow
         VAR PUBLIC
             Item : IItem;
         END_VAR

src/Window/TransportWindowList.st

@@ -1,9 +1,7 @@
-USING Simatic.Ax.WindowTracking.Trigger;
 USING Simatic.Ax.SimpleControlModules;
-USING Simatic.Ax.WindowTracking.Items;
 
 NAMESPACE Simatic.Ax.WindowTracking
-    CLASS TransportWindowList IMPLEMENTS ITransportWindowsTerminate
+    CLASS FINAL TransportWindowList IMPLEMENTS ITransportWindowsTerminate
         VAR PUBLIC
             Encoder : IEncoder;
             TriggerPointList : ITriggerList;

test/ItemTest.st

@@ -1,8 +1,6 @@
 USING AxUnit.Assert;
-USING AxUnit.Assert;
-USING Simatic.Ax.WindowTracking.Trigger;
 
-NAMESPACE Simatic.Ax.WindowTracking.Items
+NAMESPACE Simatic.Ax.WindowTracking
     {TestFixture}
     CLASS ItemTest
         VAR PROTECTED

test/SortDecisionOneDestinationTest.st

@@ -1,10 +1,6 @@
 USING AxUnit.Assert;
-USING Simatic.Ax.WindowTracking.EventHandler;
-USING Simatic.Ax.WindowTracking.Trigger;
-USING Simatic.Ax.WindowTracking.Items;
-USING Simatic.Ax.WindowTracking.ExitPointHandler;
 
-NAMESPACE Simatic.Ax.WindowTracking.SortDecision
+NAMESPACE Simatic.Ax.WindowTracking
     {TestFixture}
     CLASS SortDecisionOneDestinationTest
         VAR PROTECTED

test/TerminateWindowTest.st

@@ -1,8 +1,6 @@
 USING AxUnit.Assert;
-USING Simatic.Ax.WindowTracking.EventHandler;
-USING Simatic.Ax.WindowTracking.Trigger;
 
-NAMESPACE Simatic.Ax.WindowTracking.EventHandler
+NAMESPACE Simatic.Ax.WindowTracking
     {TestFixture}
     CLASS TerminateWindowTest
         VAR PROTECTED

test/TransportWindowTest.st

@@ -1,5 +1,4 @@
 USING AxUnit.Assert;
-USING Simatic.Ax.WindowTracking.Trigger;
 USING Simatic.Ax.SimpleControlModules;
 
 

test/TransportWindowsListTest.st

@@ -1,5 +1,4 @@
 USING AxUnit.Assert;
-USING Simatic.Ax.WindowTracking.Trigger;
 USING Simatic.Ax.SimpleControlModules;
 
 

test/VirtualTriggerListTest.st

@@ -1,6 +1,6 @@
-USING Simatic.Ax.WindowTracking.Trigger;
 USING AxUnit.Assert;
-NAMESPACE Simatic.Ax.WindowTracking.Trigger
+
+NAMESPACE Simatic.Ax.WindowTracking
     {TestFixture}
     CLASS TestVirtualTriggerList
         VAR PROTECTED

test/VirtualTriggerTest.st

@@ -1,7 +1,5 @@
 USING AxUnit.Assert;
-USING Simatic.Ax.WindowTracking.Trigger;
-USING Simatic.Ax.WindowTracking.EventHandler;
-NAMESPACE Simatic.Ax.WindowTracking.Trigger
+NAMESPACE Simatic.Ax.WindowTracking
     {TestFixture}
     CLASS TestVirtualTrigger
         VAR PROTECTED

test/WindowingIntegrativeTest.st

@@ -1,7 +1,5 @@
 USING AxUnit.Assert;
-USING Simatic.Ax.WindowTracking.Trigger;
-USING Simatic.Ax.WindowTracking.EventHandler;
-NAMESPACE Simatic.Ax.WindowTracking.Trigger
+NAMESPACE Simatic.Ax.WindowTracking
     {TestFixture}
     CLASS WindowingIntegraiveTest
         VAR PROTECTED