Enable packing and independent preview versioning for Essentials.AI

src/AI/samples/Essentials.AI.Sample/Essentials.AI.Sample.csproj

@@ -12,6 +12,7 @@
     <ImplicitUsings>enable</ImplicitUsings>
     <Nullable>enable</Nullable>
     <LangVersion>preview</LangVersion>
+    <NoWarn>$(NoWarn);MAUIAI0001</NoWarn>
     <MauiXamlInflator>SourceGen</MauiXamlInflator>
     <!-- Disable multi-RID builds to workaround a parallel build issue -->
     <RuntimeIdentifier Condition="$(TargetFramework.Contains('-maccatalyst'))">maccatalyst-x64</RuntimeIdentifier>

src/AI/src/Essentials.AI/DiagnosticIds.cs

@@ -0,0 +1,24 @@
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the MIT license.
+
+namespace Microsoft.Maui.Essentials.AI;
+
+/// <summary>
+/// Diagnostic IDs for the Microsoft.Maui.Essentials.AI package.
+/// </summary>
+internal static class DiagnosticIds
+{
+	/// <summary>
+	/// Experimental API diagnostic IDs.
+	/// </summary>
+	/// <remarks>
+	/// All Essentials.AI experiments share a single diagnostic ID so consumers
+	/// only need one suppression to opt in: <c>&lt;NoWarn&gt;MAUIAI0001&lt;/NoWarn&gt;</c>.
+	/// Individual constants exist per feature area so that APIs can be graduated
+	/// to stable independently in the future by assigning distinct IDs.
+	/// </remarks>
+	internal static class Experiments
+	{
+		internal const string EssentialsAI = "MAUIAI0001";
+	}
+}

src/AI/src/Essentials.AI/Essentials.AI.csproj

@@ -12,8 +12,15 @@
   </PropertyGroup>
   <PropertyGroup>
     <!-- NuGet package information -->
-    <IsPackable>false</IsPackable>
+    <IsPackable>true</IsPackable>
     <PackageId>Microsoft.Maui.Essentials.AI</PackageId>
+    <!-- Keep this package always preview — it is experimental and should not ship stable
+         even when the rest of the repo stabilizes. Bump PreReleaseVersionIteration for new previews.
+         The label/iteration only activate during stable builds (DotNetFinalVersionKind=release).
+         During preview builds, the AI package uses the same label as the rest of the repo. -->
+    <SuppressFinalPackageVersion>true</SuppressFinalPackageVersion>
+    <PreReleaseVersionLabel Condition="'$(DotNetFinalVersionKind)' == 'release'">preview</PreReleaseVersionLabel>
+    <PreReleaseVersionIteration Condition="'$(DotNetFinalVersionKind)' == 'release'">1</PreReleaseVersionIteration>
     <PackageTags>$(DefaultPackageTags);essentials;ai</PackageTags>
     <Description>.NET Multi-platform App UI (.NET MAUI) is a cross-platform framework for creating native mobile and desktop apps with C# and XAML. This package contains a collection of cross-platform APIs for working with device AI and local models.</Description>
   </PropertyGroup>

src/AI/src/Essentials.AI/Polyfills/ExperimentalAttribute.cs

@@ -0,0 +1,46 @@
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the MIT license.
+
+#if !NET8_0_OR_GREATER
+
+namespace System.Diagnostics.CodeAnalysis;
+
+/// <summary>
+/// Indicates that an API element is experimental and subject to change without notice.
+/// </summary>
+[AttributeUsage(
+	AttributeTargets.Class |
+	AttributeTargets.Struct |
+	AttributeTargets.Enum |
+	AttributeTargets.Interface |
+	AttributeTargets.Delegate |
+	AttributeTargets.Method |
+	AttributeTargets.Constructor |
+	AttributeTargets.Property |
+	AttributeTargets.Field |
+	AttributeTargets.Event |
+	AttributeTargets.Assembly)]
+internal sealed class ExperimentalAttribute : Attribute
+{
+	/// <summary>
+	/// Initializes a new instance of the <see cref="ExperimentalAttribute"/> class.
+	/// </summary>
+	/// <param name="diagnosticId">The diagnostic ID associated with this experimental API.</param>
+	public ExperimentalAttribute(string diagnosticId)
+	{
+		DiagnosticId = diagnosticId;
+	}
+
+	/// <summary>
+	/// Gets the ID that the compiler will use when reporting a use of the API the attribute applies to.
+	/// </summary>
+	public string DiagnosticId { get; }
+
+	/// <summary>
+	/// Gets or sets the URL for corresponding documentation.
+	/// The API accepts a format string instead of an actual URL, creating a generic URL that includes the diagnostic ID.
+	/// </summary>
+	public string? UrlFormat { get; set; }
+}
+
+#endif

src/AI/src/Essentials.AI/Properties/AssemblyInfo.cs

@@ -0,0 +1,7 @@
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the MIT license.
+
+using System.Diagnostics.CodeAnalysis;
+using Microsoft.Maui.Essentials.AI;
+
+[assembly: Experimental(DiagnosticIds.Experiments.EssentialsAI)]

src/AI/tests/Essentials.AI.Benchmarks/Essentials.AI.Benchmarks.csproj

@@ -7,6 +7,7 @@
     <AssemblyName>Essentials.AI.Benchmarks</AssemblyName>
     <RootNamespace>Microsoft.Maui.Essentials.AI.Benchmarks</RootNamespace>
     <IsPackable>false</IsPackable>
+    <NoWarn>$(NoWarn);MAUIAI0001</NoWarn>
     <ImplicitUsings>enable</ImplicitUsings>
     <Nullable>enable</Nullable>
   </PropertyGroup>

src/AI/tests/Essentials.AI.DeviceTests/Essentials.AI.DeviceTests.csproj

@@ -13,6 +13,7 @@
     <ExcludeMicrosoftNetTestSdk>true</ExcludeMicrosoftNetTestSdk>
     <Nullable>enable</Nullable>
     <ImplicitUsings>enable</ImplicitUsings>
+    <NoWarn>$(NoWarn);MAUIAI0001</NoWarn>
     <UserSecretsId>808cc184-141a-409e-addd-565c973dbce6</UserSecretsId>
   </PropertyGroup>
 

src/AI/tests/Essentials.AI.UnitTests/Essentials.AI.UnitTests.csproj

@@ -6,6 +6,7 @@
     <RootNamespace>Microsoft.Maui.Essentials.AI.UnitTests</RootNamespace>
     <IsPackable>false</IsPackable>
     <MauiTestProject>true</MauiTestProject>
+    <NoWarn>$(NoWarn);MAUIAI0001</NoWarn>
     <ImplicitUsings>enable</ImplicitUsings>
     <Nullable>enable</Nullable>
   </PropertyGroup>