DYN-10430: Add public ToString built-in method to DesignScript engine

Agent-Logs-Url: https://github.com/DynamoDS/Dynamo/sessions/287aacd6-0918-482c-bbc1-f554d6ee2efa

Co-authored-by: zeusongit <32665108+zeusongit@users.noreply.github.com>

Author: Copilot

src/Engine/ProtoCore/Lang/BuiltInFunctionEndPoint.cs

@@ -372,6 +372,7 @@ public override StackValue Execute(ProtoCore.Runtime.Context c, List<StackValue>
                     return StackValue.BuildInt(typeUID);
                 case BuiltInMethods.MethodID.ToStringFromObject:
                 case BuiltInMethods.MethodID.ToStringFromArray:
+                case BuiltInMethods.MethodID.ToString:
                     {
                         ret = StringUtils.ConvertToString(formalParameters[0], runtimeCore, rmem);
                         break;

src/Engine/ProtoCore/Lang/BuiltInMethods.cs

@@ -70,6 +70,7 @@ public enum MethodID
             ConditionalIf,
             ToStringFromObjectAndFormat,
             ToStringFromArrayAndFormat,
+            ToString,
         }
 
         //this array gets accessed using the MethodID enum
@@ -135,6 +136,7 @@ public enum MethodID
             Constants.kIfConditionalMethodName,
             "__ToStringFromObjectAndFormat",     // kToStringFromObjectAndFormat
             "__ToStringFromArrayAndFormat",      // kToStringFromArrayAndFormat
+            "ToString",                          // kToString
         };
 
         public static string GetMethodName(MethodID id)
@@ -833,6 +835,16 @@ public BuiltInMethods(Core core)
                     ID = BuiltInMethods.MethodID.ToStringFromArrayAndFormat
                 },
 
+                new BuiltInMethod
+                {
+                    ReturnType = TypeSystem.BuildPrimitiveTypeObject(PrimitiveType.String, 0),
+                    Parameters = new List<KeyValuePair<string, ProtoCore.Type>>
+                    {
+                        new KeyValuePair<string, ProtoCore.Type>("object", TypeSystem.BuildPrimitiveTypeObject(PrimitiveType.Var, 0)),
+                    },
+                    ID = BuiltInMethods.MethodID.ToString,
+                },
+
                 new BuiltInMethod
                 {
                     ReturnType = TypeSystem.BuildPrimitiveTypeObject(PrimitiveType.Void, 0),

test/Engine/ProtoTest/TD/MultiLangTests/StringTest.cs

@@ -632,5 +632,57 @@ public void TestStringFromObjectFormat_Prefs2()
             ProtoCore.Mirror.MirrorData.PrecisionFormat = oldpref;
 
         }
+
+        [Test]
+        [Category("SmokeTest")]
+        public void WhenToStringCalledOnIntThenReturnsString()
+        {
+            String code =
+    @"
+                a = ToString(42);
+                ";
+            thisTest.RunScriptSource(code);
+            thisTest.Verify("a", "42");
+        }
+
+        [Test]
+        [Category("SmokeTest")]
+        public void WhenToStringCalledOnDoubleThenReturnsString()
+        {
+            String code =
+    @"
+                a = ToString(1.5);
+                ";
+            thisTest.RunScriptSource(code);
+            thisTest.Verify("a", "1.500000");
+        }
+
+        [Test]
+        [Category("SmokeTest")]
+        public void WhenToStringCalledOnBoolThenReturnsString()
+        {
+            String code =
+    @"
+                a = ToString(true);
+                ";
+            thisTest.RunScriptSource(code);
+            thisTest.Verify("a", "true");
+        }
+
+        [Test]
+        [Category("SmokeTest")]
+        public void WhenToStringUsedInFunctionBodyThenNoWarning()
+        {
+            String code =
+    @"
+                def formatValues(x : double, y : double)
+                {
+                    return = ToString(x) + "","" + ToString(y);
+                }
+                result = formatValues(1.0, 2.0);
+                ";
+            thisTest.RunScriptSource(code);
+            thisTest.Verify("result", "1.000000,2.000000");
+        }
     }
 }