Daily update on 20250408-232053 by Nitload Youmu. Additional Message : REPEAT expression mainly complete, should add support to ELEMENT related operation to common expression like instance creating and type converting

Signed-off-by: Nitload <YoumuLiu_NSI@whv0t.onmicrosoft.com>

StgSharp.Script/Express/ExpAstNode/ExpInstanceReferenceNode.cs

@@ -40,29 +40,29 @@ namespace StgSharp.Script.Express
     public class ExpInstanceReferenceNode : ExpNode
     {
 
-        private ExpElementInstance _instance;
-
         internal ExpInstanceReferenceNode( Token source, ExpElementInstance instance )
             : base( source )
         {
-            _instance = instance;
-            _nodeFlag = ( _instance._nodeFlag | ( ExpNodeFlag.Name_Any | ExpNodeFlag.Collection_Any ) );
+            OriginObject = instance;
+            _nodeFlag = ( OriginObject._nodeFlag | ( ExpNodeFlag.Name_Any | ExpNodeFlag.Collection_Any ) );
             CodeConvertTemplate = source.Value;
         }
 
         internal ExpInstanceReferenceNode( Token source, ExpInstanceReferenceNode reference )
             : base( source )
         {
-            _instance = reference._instance;
-            _nodeFlag = ( _instance._nodeFlag | ( ExpNodeFlag.Name_Any | ExpNodeFlag.Collection_Any ) );
+            OriginObject = reference.OriginObject;
+            _nodeFlag = ( OriginObject._nodeFlag | ( ExpNodeFlag.Name_Any | ExpNodeFlag.Collection_Any ) );
             CodeConvertTemplate = source.Value;
         }
 
+        public ExpElementInstance OriginObject { get ; private set; }
+
         public override ExpNode Left => Empty;
 
         public override ExpNode Right => Empty;
 
-        public override IExpElementSource EqualityTypeConvert => _instance.EqualityTypeConvert;
+        public override IExpElementSource EqualityTypeConvert => OriginObject.EqualityTypeConvert;
 
         [MethodImpl( MethodImplOptions.AggressiveInlining )]
         public static ExpInstanceReferenceNode MakeReferenceFrom(

StgSharp.Script/Express/ExpAstNode/ExpRepeatNode.cs

@@ -59,7 +59,7 @@ namespace StgSharp.Script.Express
                                                                                            increment.NodeFlag ) ) {
                 throw new InvalidCastException();
             }
-            if( ExpNode.IsNullOrEmpty( increment ) )
+            if( IsNullOrEmpty( increment ) )
             {
                 switch( ( ExpNodeFlag )variable.NodeFlag | ExpNodeFlag.BuiltinType_Any )
                 {
@@ -84,7 +84,7 @@ namespace StgSharp.Script.Express
             _variable = variable;
             _begin = begin;
             _end = end;
-            _increment = increment;
+            _increment = increment!;
             _operationBegin = operationBegin;
             _untilRule = untilRule;
             _whileRule = whileRule;
@@ -106,52 +106,54 @@ namespace StgSharp.Script.Express
         ///   WHILE and UNTIL regulation.
         /// </summary>
         /// <param name="t">
-        ///   Position of the loop
+        ///   Position of the loop.
         /// </param>
         /// <param name="repeatVariable">
-        ///
+        ///   The variable recording increment by step.
         /// </param>
         /// <param name="begin">
-        ///
+        ///   Beginning value of the loop.
         /// </param>
         /// <param name="end">
-        ///
+        ///   When <see href="repeatVariable" /> reach the value, the loop ends.
         /// </param>
         /// <param name="repeatBody">
-        ///
+        ///   Expressions to operate multiple times.
         /// </param>
         /// <returns>
-        ///
+        ///   A <see cref="ExpRepeatNode" /> representing the repeat expression.
         /// </returns>
         public static ExpRepeatNode Create(
                                     Token t,
-                                    ExpElementInstance repeatVariable,
+                                    ExpInstanceReferenceNode repeatVariable,
                                     ExpNode begin,
                                     ExpNode end,
                                     ExpNode increment,
+                                    ExpNode whileRule,
+                                    ExpNode untilRule,
                                     ExpNode body )
         {
-            ExpNode untilRule = ExpBoolNode.False( null );
-            ExpNode whileRule = ExpBoolNode.True( null );
+            untilRule = ExpBoolNode.False( null );
+            whileRule = ExpBoolNode.True( null );
             ExpRepeatNode ret = new ExpRepeatNode(
-                t, repeatVariable, begin, end, increment, body, whileRule, untilRule )
+                t, repeatVariable.OriginObject, begin, end, increment, body, whileRule, untilRule )
             {
                 /*
-                 * 0 increment variable type
-                 * 1: variable name
-                 * 2: beginning value
-                 * 3: ending value
-                 * 4: increment
-                 * 5: body
-                 * 6: while
-                 * 7: until
+                 * 0: variable name
+                 * 1: beginning value
+                 * 2: ending value
+                 * 3: increment
+                 * 4: body
+                 * 5: while
+                 * 6: until
                  */
+
                 CodeConvertTemplate = $$"""
-                for({{0}} {{1}} = {{2}}; {{1}} <= {{3}}; {{1}} += {{4}})
+                for( {0} = {1}; {0} <= {2}; {0} += {3})
                 {
-                    if(!( {{6}} )) break;
-                    {{5}}
-                    if( {{7}} ) break;
+                    if(!( {5} )) break;
+                    {4}
+                    if( {6} ) break;
                 }
                 """
             };
@@ -174,21 +176,21 @@ namespace StgSharp.Script.Express
                 t, repeatVariable, begin, end, increment, body, whileRule, untilRule )
             {
                 /*
-                 * 0 increment variable type
-                 * 1: variable name
-                 * 2: beginning value
-                 * 3: ending value
-                 * 4: increment
-                 * 5: body
-                 * 6: while
-                 * 7: until
+                 * 0: variable name
+                 * 1: beginning value
+                 * 2: ending value
+                 * 3: increment
+                 * 4: body
+                 * 5: while
+                 * 6: until
                  */
+
                 CodeConvertTemplate = $$"""
-                for({{0}} {{1}} = {{2}}; {{1}} <= {{3}}; {{1}} += {{4}})
+                for({{repeatVariable.TypeName}} {0} = {1}; {0} <= {2}; {0} += {3})
                 {
-                    if(!( {{6}} )) break;
-                    {{5}}
-                    if( {{7}} ) break;
+                    if(!( {5} )) break;
+                    {4}
+                    if( {6} ) break;
                 }
                 """
             };

StgSharp.Script/Express/ExpAstNode/_ExpNode.cs

@@ -32,6 +32,7 @@ using CommunityToolkit.HighPerformance.Buffers;
 
 using System;
 using System.Collections.Generic;
+using System.Diagnostics.CodeAnalysis;
 using System.Linq;
 using System.Runtime.CompilerServices;
 using System.Text;
@@ -97,7 +98,7 @@ namespace StgSharp.Script.Express
             return new ExpNodeNextEnumerator( this );
         }
 
-        public static bool IsNullOrEmpty( ExpNode node )
+        public static bool IsNullOrEmpty( [AllowNull]ExpNode node )
         {
             return  node == ExpEmptyNode._only || node == null;
         }