Mark the new tensor APIs as experimental for .NET 9 (#105268)

tannergooding · ericstj · jeffhandley · web-flow · commit 5998f88eef93 · 2024-07-23T18:59:34.000-07:00
* Mark the new tensor APIs as experimental for .NET 9

* Apply SNTEXP0001 to other internal API

* Suppress SNTEXP0001 in System.Numerics.Tensors.Tests

* Use SYSLIB5001. Central registration of experimental API diagnostic ids.

* Add Experimentals.cs (missed in prior commit)

* Revert SLN changes. Add UrlFormat property to attributes where missing.

* Ensure the net8 tensors tests also don't warn for the experimental API usage

---------

Co-authored-by: Eric StJohn &lt;ericstj@microsoft.com&gt;
Co-authored-by: Jeff Handley &lt;jeffhandley@users.noreply.github.com&gt;
diff --git a/docs/project/list-of-diagnostics.md b/docs/project/list-of-diagnostics.md
@@ -276,3 +276,20 @@ The diagnostic id values reserved for .NET Libraries analyzer warnings are `SYSL
 | __`SYSLIBSUPPRESS0001`__ | CA1822                   | Do not offer to make methods static when the methods need to be instance methods for a custom marshaller shape. |
 | __`SYSLIBSUPPRESS0002`__ | IL2026                   | ConfigurationBindingGenerator: suppress RequiresUnreferencedCode diagnostic for binding call that has been intercepted by a generated static variant. |
 | __`SYSLIBSUPPRESS0003`__ | IL3050                   | ConfigurationBindingGenerator: suppress RequiresDynamicCode diagnostic for binding call that has been intercepted by a generated static variant. |
+
+## Experimental APIs
+
+APIs can be marked as `[Experimental]` if their shape or functionality is included in a release but not yet officially supported. Experimental APIs offer the opportunity to collect customer feedback on these APIs in a major release, usually refining the APIs and removing the `[Experimental]` attribute in the next release. The `[Experimental]` attribute differs from `[RequiresPreviewFeatures]`, wherein:
+
+* `[RequiresPreviewFeatures]` APIs require a corresponding preview feature in another product area such as the compiler or SDK
+* `[Experimental]` APIs are entirely self-contained within the libraries and do not require preview features in other parts of the product
+
+The diagnostic id values reserved for experimental APIs are `SYSLIB5001` through `SYSLIB5999`. When marking an API as `[Experimental]`, claim the next three-digit identifier in the `SYSLIB5###` sequence and add it to the list below. The URL template for all experimental APIs is `https://aka.ms/dotnet-warnings/{0}`. The `{0}` placeholder is replaced by the compiler with the `SYSLIB5###` identifier.
+
+### Experimental Diagnostics (`SYSLIB5001` - `SYSLIB5999`)
+
+Diagnostic id values for experimental APIs must not be recycled, as that could silently opt customers into new experimental APIs where they had previously suppressed the ID for a previous usage of the value.
+
+| Diagnostic ID     | Introduced | Removed | Description |
+| :---------------- | ---------: | ------: | :---------- |
+|  __`SYSLIB5001`__ |     .NET 9 |     TBD | `Tensor<T>` and related APIs in System.Numerics.Tensors are experimental in .NET 9 |
diff --git a/src/libraries/Common/src/System/Experimentals.cs b/src/libraries/Common/src/System/Experimentals.cs
@@ -0,0 +1,25 @@
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the MIT license.
+
+namespace System
+{
+    internal static class Experimentals
+    {
+        internal const string SharedUrlFormat = "https://aka.ms/dotnet-warnings/{0}";
+
+        // Please see docs\project\list-of-diagnostics.md for instructions on the steps required
+        // to introduce an experimental API, claim a diagnostic id, and ensure the
+        // "aka.ms/dotnet-warnings/{0}" URL points to documentation for the API.
+        // The diagnostic IDs reserved for experimental APIs are SYSLIB5### (SYSLIB5001 - SYSLIB5999).
+
+        // When an API is no longer marked as experimental, the diagnostic ID should be removed from this file
+        // but retained in the table in docs\project\list-of-diagnostics.md to prevent reuse. Be sure to remove
+        // suppressions from the codebase as well.
+
+        // Tensor<T> and related APIs are marked as [Experimental] in .NET 9
+        internal const string TensorTDiagId = "SYSLIB5001";
+
+        // When adding a new diagnostic ID, add it to the table in docs\project\list-of-diagnostics.md as well.
+        // Keep new const identifiers above this comment.
+    }
+}
diff --git a/src/libraries/System.Numerics.Tensors/ref/System.Numerics.Tensors.netcore.cs b/src/libraries/System.Numerics.Tensors/ref/System.Numerics.Tensors.netcore.cs
@@ -6,6 +6,7 @@
 
 namespace System.Buffers
 {
+    [System.Diagnostics.CodeAnalysis.Experimental("SYSLIB5001", UrlFormat = "https://aka.ms/dotnet-warnings/{0}")]
     public readonly partial struct NIndex : System.IEquatable<System.Buffers.NIndex>
     {
         private readonly int _dummyPrimitive;
@@ -29,6 +30,7 @@ namespace System.Buffers
         public System.Index ToIndexUnchecked() { throw null; }
         public override string ToString() { throw null; }
     }
+    [System.Diagnostics.CodeAnalysis.Experimental("SYSLIB5001", UrlFormat = "https://aka.ms/dotnet-warnings/{0}")]
     public readonly partial struct NRange : System.IEquatable<System.Buffers.NRange>
     {
         private readonly int _dummyPrimitive;
@@ -53,6 +55,7 @@ namespace System.Buffers
 }
 namespace System.Numerics.Tensors
 {
+    [System.Diagnostics.CodeAnalysis.Experimental("SYSLIB5001", UrlFormat = "https://aka.ms/dotnet-warnings/{0}")]
     public partial interface IReadOnlyTensor<TSelf, T> : System.Collections.Generic.IEnumerable<T>, System.Collections.IEnumerable where TSelf : System.Numerics.Tensors.IReadOnlyTensor<TSelf, T>
     {
         static abstract TSelf? Empty { get; }
@@ -80,6 +83,7 @@ public partial interface IReadOnlyTensor<TSelf, T> : System.Collections.Generic.
         bool TryCopyTo(scoped System.Numerics.Tensors.TensorSpan<T> destination);
         bool TryFlattenTo(scoped System.Span<T> destination);
     }
+    [System.Diagnostics.CodeAnalysis.Experimental("SYSLIB5001", UrlFormat = "https://aka.ms/dotnet-warnings/{0}")]
     public partial interface ITensor<TSelf, T> : System.Collections.Generic.IEnumerable<T>, System.Collections.IEnumerable, System.Numerics.Tensors.IReadOnlyTensor<TSelf, T> where TSelf : System.Numerics.Tensors.ITensor<TSelf, T>
     {
         bool IsReadOnly { get; }
@@ -98,6 +102,7 @@ public partial interface ITensor<TSelf, T> : System.Collections.Generic.IEnumera
         void Fill(T value);
         new ref T GetPinnableReference();
     }
+    [System.Diagnostics.CodeAnalysis.Experimental("SYSLIB5001", UrlFormat = "https://aka.ms/dotnet-warnings/{0}")]
     public readonly ref partial struct ReadOnlyTensorSpan<T>
     {
         private readonly object _dummy;
@@ -157,6 +162,7 @@ public ref partial struct Enumerator
             public bool MoveNext() { throw null; }
         }
     }
+    [System.Diagnostics.CodeAnalysis.Experimental("SYSLIB5001", UrlFormat = "https://aka.ms/dotnet-warnings/{0}")]
     public static partial class Tensor
     {
         public static System.Numerics.Tensors.Tensor<T> Abs<T>(in System.Numerics.Tensors.ReadOnlyTensorSpan<T> x) where T : System.Numerics.INumberBase<T> { throw null; }
@@ -674,6 +680,7 @@ public static void Truncate<T>(System.ReadOnlySpan<T> x, System.Span<T> destinat
         public static void Xor<T>(System.ReadOnlySpan<T> x, System.ReadOnlySpan<T> y, System.Span<T> destination) where T : System.Numerics.IBitwiseOperators<T, T, T> { }
         public static void Xor<T>(System.ReadOnlySpan<T> x, T y, System.Span<T> destination) where T : System.Numerics.IBitwiseOperators<T, T, T> { }
     }
+    [System.Diagnostics.CodeAnalysis.Experimental("SYSLIB5001", UrlFormat = "https://aka.ms/dotnet-warnings/{0}")]
     public readonly ref partial struct TensorSpan<T>
     {
         private readonly object _dummy;
@@ -735,6 +742,7 @@ public ref partial struct Enumerator
             public bool MoveNext() { throw null; }
         }
     }
+    [System.Diagnostics.CodeAnalysis.Experimental("SYSLIB5001", UrlFormat = "https://aka.ms/dotnet-warnings/{0}")]
     public sealed partial class Tensor<T> : System.Collections.Generic.IEnumerable<T>, System.Collections.IEnumerable, System.Numerics.Tensors.IReadOnlyTensor<System.Numerics.Tensors.Tensor<T>, T>, System.Numerics.Tensors.ITensor<System.Numerics.Tensors.Tensor<T>, T>
     {
         internal Tensor() { }
diff --git a/src/libraries/System.Numerics.Tensors/src/System.Numerics.Tensors.csproj b/src/libraries/System.Numerics.Tensors/src/System.Numerics.Tensors.csproj
@@ -7,12 +7,15 @@
     <PackageDescription>Provides support for operating over tensors.</PackageDescription>
     <GenAPIExcludeApiList>ReferenceAssemblyExclusions.txt</GenAPIExcludeApiList>
     <ApiCompatValidateAssemblies>true</ApiCompatValidateAssemblies>
+    <!-- SYSLIB5001: Tensor<T> and related APIs are Experimental in .NET 9 -->
+    <NoWarn>$(NoWarn);SYSLIB5001</NoWarn>
   </PropertyGroup>
 
   <ItemGroup>
     <Compile Include="System\Numerics\Tensors\TensorPrimitives.Single.cs" />
     <Compile Include="System\Numerics\Tensors\TensorPrimitives.Helpers.cs" />
     <Compile Include="System\ThrowHelper.cs" />
+    <Compile Include="$(CommonPath)System\Experimentals.cs" Link="Common\System\Experimentals.cs" />
   </ItemGroup>
 
   <ItemGroup Condition="'$(TargetFrameworkIdentifier)' == '.NETCoreApp'">
diff --git a/src/libraries/System.Numerics.Tensors/src/System/NIndex.cs b/src/libraries/System.Numerics.Tensors/src/System/NIndex.cs
@@ -14,6 +14,7 @@ namespace System.Buffers
     /// int lastElement = someArray[^1]; // lastElement = 5
     /// </code>
     /// </remarks>
+    [Experimental(Experimentals.TensorTDiagId, UrlFormat = Experimentals.SharedUrlFormat)]
     public readonly struct NIndex : IEquatable<NIndex>
     {
         private readonly nint _value;
diff --git a/src/libraries/System.Numerics.Tensors/src/System/NRange.cs b/src/libraries/System.Numerics.Tensors/src/System/NRange.cs
@@ -15,6 +15,7 @@ namespace System.Buffers
     /// int[] subArray2 = someArray[1..^0]; // { 2, 3, 4, 5 }
     /// </code>
     /// </remarks>
+    [Experimental(Experimentals.TensorTDiagId, UrlFormat = Experimentals.SharedUrlFormat)]
     public readonly struct NRange : IEquatable<NRange>
     {
         /// <summary>Represent the inclusive start NIndex of the NRange.</summary>
diff --git a/src/libraries/System.Numerics.Tensors/src/System/Numerics/Tensors/netcore/IReadOnlyTensor.cs b/src/libraries/System.Numerics.Tensors/src/System/Numerics/Tensors/netcore/IReadOnlyTensor.cs
@@ -7,6 +7,7 @@
 
 namespace System.Numerics.Tensors
 {
+    [Experimental(Experimentals.TensorTDiagId, UrlFormat = Experimentals.SharedUrlFormat)]
     public interface IReadOnlyTensor<TSelf, T> : IEnumerable<T>
         where TSelf : IReadOnlyTensor<TSelf, T>
     {
diff --git a/src/libraries/System.Numerics.Tensors/src/System/Numerics/Tensors/netcore/ITensor.cs b/src/libraries/System.Numerics.Tensors/src/System/Numerics/Tensors/netcore/ITensor.cs
@@ -2,9 +2,11 @@
 // The .NET Foundation licenses this file to you under the MIT license.
 
 using System.Buffers;
+using System.Diagnostics.CodeAnalysis;
 
 namespace System.Numerics.Tensors
 {
+    [Experimental(Experimentals.TensorTDiagId, UrlFormat = Experimentals.SharedUrlFormat)]
     public interface ITensor<TSelf, T>
         : IReadOnlyTensor<TSelf, T>
         where TSelf : ITensor<TSelf, T>
diff --git a/src/libraries/System.Numerics.Tensors/src/System/Numerics/Tensors/netcore/ReadOnlyTensorSpan.cs b/src/libraries/System.Numerics.Tensors/src/System/Numerics/Tensors/netcore/ReadOnlyTensorSpan.cs
@@ -21,6 +21,7 @@ namespace System.Numerics.Tensors
     /// </summary>
     [DebuggerTypeProxy(typeof(TensorSpanDebugView<>))]
     [DebuggerDisplay("{ToString(),raw}")]
+    [Experimental(Experimentals.TensorTDiagId, UrlFormat = Experimentals.SharedUrlFormat)]
     public readonly ref struct ReadOnlyTensorSpan<T>
     {
         /// <summary>A byref or a native ptr.</summary>
diff --git a/src/libraries/System.Numerics.Tensors/src/System/Numerics/Tensors/netcore/Tensor.Factory.cs b/src/libraries/System.Numerics.Tensors/src/System/Numerics/Tensors/netcore/Tensor.Factory.cs
@@ -2,6 +2,7 @@
 // The .NET Foundation licenses this file to you under the MIT license.
 
 using System.Collections.Generic;
+using System.Diagnostics.CodeAnalysis;
 using System.Linq;
 using System.Runtime.InteropServices;
 using Microsoft.VisualBasic;
diff --git a/src/libraries/System.Numerics.Tensors/src/System/Numerics/Tensors/netcore/Tensor.cs b/src/libraries/System.Numerics.Tensors/src/System/Numerics/Tensors/netcore/Tensor.cs
@@ -5,6 +5,7 @@
 using System.Collections;
 using System.Collections.Generic;
 using System.ComponentModel;
+using System.Diagnostics.CodeAnalysis;
 using System.Linq;
 using System.Reflection.Metadata.Ecma335;
 using System.Runtime.CompilerServices;
@@ -17,6 +18,7 @@
 
 namespace System.Numerics.Tensors
 {
+    [Experimental(Experimentals.TensorTDiagId, UrlFormat = Experimentals.SharedUrlFormat)]
     public sealed class Tensor<T>
         : ITensor<Tensor<T>, T>
     {
diff --git a/src/libraries/System.Numerics.Tensors/src/System/Numerics/Tensors/netcore/TensorExtensions.cs b/src/libraries/System.Numerics.Tensors/src/System/Numerics/Tensors/netcore/TensorExtensions.cs
@@ -11,12 +11,14 @@
 using static System.Runtime.InteropServices.JavaScript.JSType;
 using System.Security.Cryptography;
 using System.Runtime.Serialization;
+using System.Diagnostics.CodeAnalysis;
 
 #pragma warning disable CS8601 // Possible null reference assignment.
 #pragma warning disable CS8618 // Non-nullable field must contain a non-null value when exiting constructor. Consider declaring as nullable.
 
 namespace System.Numerics.Tensors
 {
+    [Experimental(Experimentals.TensorTDiagId, UrlFormat = Experimentals.SharedUrlFormat)]
     public static partial class Tensor
     {
         #region AsReadOnlySpan
diff --git a/src/libraries/System.Numerics.Tensors/src/System/Numerics/Tensors/netcore/TensorHelpers.cs b/src/libraries/System.Numerics.Tensors/src/System/Numerics/Tensors/netcore/TensorHelpers.cs
@@ -2,11 +2,13 @@
 // The .NET Foundation licenses this file to you under the MIT license.
 
 using System;
+using System.Diagnostics.CodeAnalysis;
 using System.Linq;
 using System.Runtime.InteropServices;
 
 namespace System.Numerics.Tensors
 {
+    [Experimental(Experimentals.TensorTDiagId, UrlFormat = Experimentals.SharedUrlFormat)]
     internal static class TensorHelpers
     {
 
diff --git a/src/libraries/System.Numerics.Tensors/src/System/Numerics/Tensors/netcore/TensorShape.cs b/src/libraries/System.Numerics.Tensors/src/System/Numerics/Tensors/netcore/TensorShape.cs
@@ -8,6 +8,8 @@
 
 namespace System.Numerics.Tensors
 {
+
+    [Experimental(Experimentals.TensorTDiagId, UrlFormat = Experimentals.SharedUrlFormat)]
     internal readonly struct TensorShape
     {
         // Used to determine when we need to allocate a metadata array
diff --git a/src/libraries/System.Numerics.Tensors/src/System/Numerics/Tensors/netcore/TensorSpan.cs b/src/libraries/System.Numerics.Tensors/src/System/Numerics/Tensors/netcore/TensorSpan.cs
@@ -21,6 +21,7 @@ namespace System.Numerics.Tensors
     /// </summary>
     [DebuggerTypeProxy(typeof(TensorSpanDebugView<>))]
     [DebuggerDisplay("{ToString(),raw}")]
+    [Experimental(Experimentals.TensorTDiagId, UrlFormat = Experimentals.SharedUrlFormat)]
     public readonly ref struct TensorSpan<T>
     {
         /// <summary>A byref or a native ptr.</summary>
diff --git a/src/libraries/System.Numerics.Tensors/src/System/Numerics/Tensors/netcore/TensorSpanDebugView.cs b/src/libraries/System.Numerics.Tensors/src/System/Numerics/Tensors/netcore/TensorSpanDebugView.cs
@@ -2,9 +2,12 @@
 // The .NET Foundation licenses this file to you under the MIT license.
 
 using System.Diagnostics;
+using System.Diagnostics.CodeAnalysis;
 
 namespace System.Numerics.Tensors
 {
+
+    [Experimental(Experimentals.TensorTDiagId, UrlFormat = Experimentals.SharedUrlFormat)]
     internal sealed class TensorSpanDebugView<T>
     {
         private readonly T[] _array;
diff --git a/src/libraries/System.Numerics.Tensors/src/System/Numerics/Tensors/netcore/TensorSpanHelpers.cs b/src/libraries/System.Numerics.Tensors/src/System/Numerics/Tensors/netcore/TensorSpanHelpers.cs
@@ -4,12 +4,15 @@
 using System.Buffers;
 using System.Collections.Specialized;
 using System.Diagnostics;
+using System.Diagnostics.CodeAnalysis;
 using System.Linq;
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
 namespace System.Numerics.Tensors
 {
+
+    [Experimental(Experimentals.TensorTDiagId, UrlFormat = Experimentals.SharedUrlFormat)]
     internal static partial class TensorSpanHelpers
     {
         internal static bool AreShapesTheSame<T>(ReadOnlyTensorSpan<T> tensor1, ReadOnlyTensorSpan<T> tensor2)
diff --git a/src/libraries/System.Numerics.Tensors/tests/Net8Tests/System.Numerics.Tensors.Net8.Tests.csproj b/src/libraries/System.Numerics.Tensors/tests/Net8Tests/System.Numerics.Tensors.Net8.Tests.csproj
@@ -6,11 +6,12 @@
 -->
 
 <Project Sdk="Microsoft.NET.Sdk">
-  
+
   <PropertyGroup>
     <TargetFramework>$(NetCoreAppCurrent)</TargetFramework>
     <AllowUnsafeBlocks>true</AllowUnsafeBlocks>
     <DefineConstants>$(DefineConstants);SNT_NET8_TESTS</DefineConstants>
+    <NoWarn>$(NoWarn);SYSLIB5001</NoWarn>
   </PropertyGroup>
 
   <ItemGroup>
@@ -21,7 +22,7 @@
     <Compile Include="..\TensorPrimitives.ConvertTo.cs" />
     <Compile Include="..\TensorPrimitives.Generic.cs" />
   </ItemGroup>
-  
+
   <ItemGroup>
     <ProjectReference Include="..\..\src\System.Numerics.Tensors.csproj" SkipUseReferenceAssembly="true">
       <SetTargetFramework>TargetFramework=net8.0</SetTargetFramework>
diff --git a/src/libraries/System.Numerics.Tensors/tests/System.Numerics.Tensors.Tests.csproj b/src/libraries/System.Numerics.Tensors/tests/System.Numerics.Tensors.Tests.csproj
@@ -3,6 +3,8 @@
   <PropertyGroup>
     <TargetFrameworks>$(NetCoreAppCurrent);$(NetFrameworkMinimum)</TargetFrameworks>
     <AllowUnsafeBlocks>true</AllowUnsafeBlocks>
+    <!-- SYSLIB5001: Tensor<T> and related APIs are Experimental in .NET 9 -->
+    <NoWarn>$(NoWarn);SYSLIB5001</NoWarn>
   </PropertyGroup>
 
   <PropertyGroup>

Original file line number	Diff line number	Diff line change
`@@ -6,6 +6,7 @@`
`6`	`6`
`7`	`7`	`namespace System.Buffers`
`8`	`8`	`{`
	`9`	`+ [System.Diagnostics.CodeAnalysis.Experimental("SYSLIB5001", UrlFormat = "https://aka.ms/dotnet-warnings/{0}")]`
`9`	`10`	`public readonly partial struct NIndex : System.IEquatable<System.Buffers.NIndex>`
`10`	`11`	`{`
`11`	`12`	`private readonly int _dummyPrimitive;`
`@@ -29,6 +30,7 @@ namespace System.Buffers`
`29`	`30`	`public System.Index ToIndexUnchecked() { throw null; }`
`30`	`31`	`public override string ToString() { throw null; }`
`31`	`32`	`}`
	`33`	`+ [System.Diagnostics.CodeAnalysis.Experimental("SYSLIB5001", UrlFormat = "https://aka.ms/dotnet-warnings/{0}")]`
`32`	`34`	`public readonly partial struct NRange : System.IEquatable<System.Buffers.NRange>`
`33`	`35`	`{`
`34`	`36`	`private readonly int _dummyPrimitive;`
`@@ -53,6 +55,7 @@ namespace System.Buffers`
`53`	`55`	`}`
`54`	`56`	`namespace System.Numerics.Tensors`
`55`	`57`	`{`
	`58`	`+ [System.Diagnostics.CodeAnalysis.Experimental("SYSLIB5001", UrlFormat = "https://aka.ms/dotnet-warnings/{0}")]`
`56`	`59`	`public partial interface IReadOnlyTensor<TSelf, T> : System.Collections.Generic.IEnumerable<T>, System.Collections.IEnumerable where TSelf : System.Numerics.Tensors.IReadOnlyTensor<TSelf, T>`
`57`	`60`	`{`
`58`	`61`	`static abstract TSelf? Empty { get; }`
`@@ -80,6 +83,7 @@ public partial interface IReadOnlyTensor<TSelf, T> : System.Collections.Generic.`
`80`	`83`	`bool TryCopyTo(scoped System.Numerics.Tensors.TensorSpan<T> destination);`
`81`	`84`	`bool TryFlattenTo(scoped System.Span<T> destination);`
`82`	`85`	`}`
	`86`	`+ [System.Diagnostics.CodeAnalysis.Experimental("SYSLIB5001", UrlFormat = "https://aka.ms/dotnet-warnings/{0}")]`
`83`	`87`	`public partial interface ITensor<TSelf, T> : System.Collections.Generic.IEnumerable<T>, System.Collections.IEnumerable, System.Numerics.Tensors.IReadOnlyTensor<TSelf, T> where TSelf : System.Numerics.Tensors.ITensor<TSelf, T>`
`84`	`88`	`{`
`85`	`89`	`bool IsReadOnly { get; }`
`@@ -98,6 +102,7 @@ public partial interface ITensor<TSelf, T> : System.Collections.Generic.IEnumera`
`98`	`102`	`void Fill(T value);`
`99`	`103`	`new ref T GetPinnableReference();`
`100`	`104`	`}`
	`105`	`+ [System.Diagnostics.CodeAnalysis.Experimental("SYSLIB5001", UrlFormat = "https://aka.ms/dotnet-warnings/{0}")]`
`101`	`106`	`public readonly ref partial struct ReadOnlyTensorSpan<T>`
`102`	`107`	`{`
`103`	`108`	`private readonly object _dummy;`
`@@ -157,6 +162,7 @@ public ref partial struct Enumerator`
`157`	`162`	`public bool MoveNext() { throw null; }`
`158`	`163`	`}`
`159`	`164`	`}`
	`165`	`+ [System.Diagnostics.CodeAnalysis.Experimental("SYSLIB5001", UrlFormat = "https://aka.ms/dotnet-warnings/{0}")]`
`160`	`166`	`public static partial class Tensor`
`161`	`167`	`{`
`162`	`168`	`public static System.Numerics.Tensors.Tensor<T> Abs<T>(in System.Numerics.Tensors.ReadOnlyTensorSpan<T> x) where T : System.Numerics.INumberBase<T> { throw null; }`
`@@ -674,6 +680,7 @@ public static void Truncate<T>(System.ReadOnlySpan<T> x, System.Span<T> destinat`
`674`	`680`	`public static void Xor<T>(System.ReadOnlySpan<T> x, System.ReadOnlySpan<T> y, System.Span<T> destination) where T : System.Numerics.IBitwiseOperators<T, T, T> { }`
`675`	`681`	`public static void Xor<T>(System.ReadOnlySpan<T> x, T y, System.Span<T> destination) where T : System.Numerics.IBitwiseOperators<T, T, T> { }`
`676`	`682`	`}`
	`683`	`+ [System.Diagnostics.CodeAnalysis.Experimental("SYSLIB5001", UrlFormat = "https://aka.ms/dotnet-warnings/{0}")]`
`677`	`684`	`public readonly ref partial struct TensorSpan<T>`
`678`	`685`	`{`
`679`	`686`	`private readonly object _dummy;`
`@@ -735,6 +742,7 @@ public ref partial struct Enumerator`
`735`	`742`	`public bool MoveNext() { throw null; }`
`736`	`743`	`}`
`737`	`744`	`}`
	`745`	`+ [System.Diagnostics.CodeAnalysis.Experimental("SYSLIB5001", UrlFormat = "https://aka.ms/dotnet-warnings/{0}")]`
`738`	`746`	`public sealed partial class Tensor<T> : System.Collections.Generic.IEnumerable<T>, System.Collections.IEnumerable, System.Numerics.Tensors.IReadOnlyTensor<System.Numerics.Tensors.Tensor<T>, T>, System.Numerics.Tensors.ITensor<System.Numerics.Tensors.Tensor<T>, T>`
`739`	`747`	`{`
`740`	`748`	`internal Tensor() { }`
Original file line number	Diff line number	Diff line change
`@@ -14,6 +14,7 @@ namespace System.Buffers`
`14`	`14`	`/// int lastElement = someArray[^1]; // lastElement = 5`
`15`	`15`	`/// </code>`
`16`	`16`	`/// </remarks>`
	`17`	`+ [Experimental(Experimentals.TensorTDiagId, UrlFormat = Experimentals.SharedUrlFormat)]`
`17`	`18`	`public readonly struct NIndex : IEquatable<NIndex>`
`18`	`19`	`{`
`19`	`20`	`private readonly nint _value;`
Original file line number	Diff line number	Diff line change
`@@ -15,6 +15,7 @@ namespace System.Buffers`
`15`	`15`	`/// int[] subArray2 = someArray[1..^0]; // { 2, 3, 4, 5 }`
`16`	`16`	`/// </code>`
`17`	`17`	`/// </remarks>`
	`18`	`+ [Experimental(Experimentals.TensorTDiagId, UrlFormat = Experimentals.SharedUrlFormat)]`
`18`	`19`	`public readonly struct NRange : IEquatable<NRange>`
`19`	`20`	`{`
`20`	`21`	`/// <summary>Represent the inclusive start NIndex of the NRange.</summary>`
Original file line number	Diff line number	Diff line change
`@@ -7,6 +7,7 @@`
`7`	`7`
`8`	`8`	`namespace System.Numerics.Tensors`
`9`	`9`	`{`
	`10`	`+ [Experimental(Experimentals.TensorTDiagId, UrlFormat = Experimentals.SharedUrlFormat)]`
`10`	`11`	`public interface IReadOnlyTensor<TSelf, T> : IEnumerable<T>`
`11`	`12`	`where TSelf : IReadOnlyTensor<TSelf, T>`
`12`	`13`	`{`
Original file line number	Diff line number	Diff line change
`@@ -21,6 +21,7 @@ namespace System.Numerics.Tensors`
`21`	`21`	`/// </summary>`
`22`	`22`	`[DebuggerTypeProxy(typeof(TensorSpanDebugView<>))]`
`23`	`23`	`[DebuggerDisplay("{ToString(),raw}")]`
	`24`	`+ [Experimental(Experimentals.TensorTDiagId, UrlFormat = Experimentals.SharedUrlFormat)]`
`24`	`25`	`public readonly ref struct ReadOnlyTensorSpan<T>`
`25`	`26`	`{`
`26`	`27`	`/// <summary>A byref or a native ptr.</summary>`
Original file line number	Diff line number	Diff line change
`@@ -5,6 +5,7 @@`
`5`	`5`	`using System.Collections;`
`6`	`6`	`using System.Collections.Generic;`
`7`	`7`	`using System.ComponentModel;`
	`8`	`+using System.Diagnostics.CodeAnalysis;`
`8`	`9`	`using System.Linq;`
`9`	`10`	`using System.Reflection.Metadata.Ecma335;`
`10`	`11`	`using System.Runtime.CompilerServices;`
`@@ -17,6 +18,7 @@`
`17`	`18`
`18`	`19`	`namespace System.Numerics.Tensors`
`19`	`20`	`{`
	`21`	`+ [Experimental(Experimentals.TensorTDiagId, UrlFormat = Experimentals.SharedUrlFormat)]`
`20`	`22`	`public sealed class Tensor<T>`
`21`	`23`	`: ITensor<Tensor<T>, T>`
`22`	`24`	`{`
Original file line number	Diff line number	Diff line change
`@@ -11,12 +11,14 @@`
`11`	`11`	`using static System.Runtime.InteropServices.JavaScript.JSType;`
`12`	`12`	`using System.Security.Cryptography;`
`13`	`13`	`using System.Runtime.Serialization;`
	`14`	`+using System.Diagnostics.CodeAnalysis;`
`14`	`15`
`15`	`16`	`#pragma warning disable CS8601 // Possible null reference assignment.`
`16`	`17`	`#pragma warning disable CS8618 // Non-nullable field must contain a non-null value when exiting constructor. Consider declaring as nullable.`
`17`	`18`
`18`	`19`	`namespace System.Numerics.Tensors`
`19`	`20`	`{`
	`21`	`+ [Experimental(Experimentals.TensorTDiagId, UrlFormat = Experimentals.SharedUrlFormat)]`
`20`	`22`	`public static partial class Tensor`
`21`	`23`	`{`
`22`	`24`	`#region AsReadOnlySpan`
Original file line number	Diff line number	Diff line change
`@@ -2,11 +2,13 @@`
`2`	`2`	`// The .NET Foundation licenses this file to you under the MIT license.`
`3`	`3`
`4`	`4`	`using System;`
	`5`	`+using System.Diagnostics.CodeAnalysis;`
`5`	`6`	`using System.Linq;`
`6`	`7`	`using System.Runtime.InteropServices;`
`7`	`8`
`8`	`9`	`namespace System.Numerics.Tensors`
`9`	`10`	`{`
	`11`	`+ [Experimental(Experimentals.TensorTDiagId, UrlFormat = Experimentals.SharedUrlFormat)]`
`10`	`12`	`internal static class TensorHelpers`
`11`	`13`	`{`
`12`	`14`
Original file line number	Diff line number	Diff line change
`@@ -8,6 +8,8 @@`
`8`	`8`
`9`	`9`	`namespace System.Numerics.Tensors`
`10`	`10`	`{`
	`11`	`+`
	`12`	`+ [Experimental(Experimentals.TensorTDiagId, UrlFormat = Experimentals.SharedUrlFormat)]`
`11`	`13`	`internal readonly struct TensorShape`
`12`	`14`	`{`
`13`	`15`	`// Used to determine when we need to allocate a metadata array`
Original file line number	Diff line number	Diff line change
`@@ -2,9 +2,12 @@`
`2`	`2`	`// The .NET Foundation licenses this file to you under the MIT license.`
`3`	`3`
`4`	`4`	`using System.Diagnostics;`
	`5`	`+using System.Diagnostics.CodeAnalysis;`
`5`	`6`
`6`	`7`	`namespace System.Numerics.Tensors`
`7`	`8`	`{`
	`9`	`+`
	`10`	`+ [Experimental(Experimentals.TensorTDiagId, UrlFormat = Experimentals.SharedUrlFormat)]`
`8`	`11`	`internal sealed class TensorSpanDebugView<T>`
`9`	`12`	`{`
`10`	`13`	`private readonly T[] _array;`