From 18e2266169fd2de3ed8e4f8580a254cb40a69a6b Mon Sep 17 00:00:00 2001
From: Arlo Godfrey <arlo.godfrey@outlook.com>
Date: Tue, 19 Sep 2023 16:55:44 -0500
Subject: [PATCH 1/7] Added AddMultiTargetCompatibleSampleDocs target. Fixes
 #5.

---
 ProjectHeads/App.Head.props               |  49 +++++++-
 ProjectHeads/Tasks/CheckMultiTarget.props | 131 ++++++++++++++++++++++
 2 files changed, 176 insertions(+), 4 deletions(-)
 create mode 100644 ProjectHeads/Tasks/CheckMultiTarget.props

diff --git a/ProjectHeads/App.Head.props b/ProjectHeads/App.Head.props
index 5e36c67c..a3057b9d 100644
--- a/ProjectHeads/App.Head.props
+++ b/ProjectHeads/App.Head.props
@@ -1,5 +1,5 @@
 <!-- Common props for any deployable app project head. -->
-<Project>
+<Project InitialTargets="AddMultiTargetCompatibleSampleDocs">
   <!-- Shared project -->
   <Import Project="$(ToolingDirectory)\CommunityToolkit.App.Shared\CommunityToolkit.App.Shared.projitems" Label="Shared" />
 
@@ -64,7 +64,7 @@
       </ItemGroup>
     </When>
   </Choose>
-   <Choose>
+  <Choose>
     <When Condition="'$(ToolkitTriggersSourceProject)' == ''">
       <ItemGroup>
         <PackageReference Include="CommunityToolkit.$(DependencyVariant).Triggers" Version="8.0.230823-rc"/>
@@ -76,6 +76,49 @@
       </ItemGroup>
     </When>
   </Choose>
+
+  <!-- Gather sample markdown for components that MultiTarget this platform. -->
+  <!-- Each deployable sample app head uses the CommunityToolkit.Toolkit.SampleGen source generator to generate document registries -->
+  <Import Project="$(ToolingDirectory)\ProjectHeads\tasks\CheckMultiTarget.props" />
+
+  <Target Name="AddMultiTargetCompatibleSampleDocs" Condition="'$(IsAllExperimentHead)' == 'true'">
+    <!-- Props scoped to current Target -->
+    <!-- Simplifies comparison of the current head against component-level <MultiTarget> definition -->
+    <PropertyGroup>
+      <MultiTargetIdentifier Condition="'$(IsUwp)' == 'true'">uwp</MultiTargetIdentifier>
+      <MultiTargetIdentifier Condition="'$(IsWasm)' == 'true'">wasm</MultiTargetIdentifier>
+      <MultiTargetIdentifier Condition="'$(IsWasdk)' == 'true'">wasdk</MultiTargetIdentifier>
+      <MultiTargetIdentifier Condition="'$(IsMacos)' == 'true'">macos</MultiTargetIdentifier>
+      <MultiTargetIdentifier Condition="'$(IsIos)' == 'true'">ios</MultiTargetIdentifier>
+      <MultiTargetIdentifier Condition="'$(IsAndroid)' == 'true'">android</MultiTargetIdentifier>
+      <MultiTargetIdentifier Condition="'$(IsNetstandard)' == 'true'">netstandard</MultiTargetIdentifier>
+    </PropertyGroup>
+
+    <Error Condition="$(MultiTargetIdentifier) == ''" Text="Missing MultiTargetIdentifier. Is the `IsSomePlatform` property (`IsUwp`, `IsWasm`, etc) set on the deployable project head?" />
+
+    <ItemGroup>
+      <AllComponentMarkdownFiles Include="$(RepositoryDirectory)components\**\samples\**\*.md" Exclude="$(RepositoryDirectory)**\**\samples\**\obj\**\*.md;$(RepositoryDirectory)**\**\samples\**\bin\**\*.md"/>
+    </ItemGroup>
+
+    <Message Text="Found @(AllComponentMarkdownFiles->Count()) total sample docs" Importance="high" />
+
+    <CheckMultiTarget FilePath="%(AllComponentMarkdownFiles.Identity)" MultiTargetIdentifier="$(MultiTargetIdentifier)" RepositoryDirectory="$(RepositoryDirectory)">
+      <Output TaskParameter="FilePath" ItemName="ProcessedMarkdownFiles" />
+    </CheckMultiTarget>
+
+    <ItemGroup>
+      <SupportedMarkdownFiles Include="%(ProcessedMarkdownFiles.Identity)" Condition="%(ProcessedMarkdownFiles.IsSupported) == 'true'" />
+    </ItemGroup>
+
+    <Message Text="@(SupportedMarkdownFiles->Count()) sample docs are supported on the current MultiTarget '$(MultiTargetIdentifier)':" Importance="high" />
+    <Message Text="Included %(SupportedMarkdownFiles.Identity)" Importance="high" />
+
+    <ItemGroup>
+      <AdditionalFiles Include="%(SupportedMarkdownFiles.Identity)" />
+    </ItemGroup>
+  </Target>
+
+  <!-- Content inclusion -->
   <!-- See https://github.com/CommunityToolkit/Labs-Windows/issues/142 -->
   <ItemGroup Condition="'$(IsAllExperimentHead)' == 'true'">
     <!-- These are also included in the Samples props file, but added here to workaround https://github.com/unoplatform/uno/issues/2502 -->
@@ -92,8 +135,6 @@
       <Link>SourceAssets/%(RecursiveDir)%(FileName)%(Extension).dat</Link>
     </Content>
 
-    <!-- Include markdown files from all samples so the head can access them in the source generator -->
-    <AdditionalFiles Include="$(RepositoryDirectory)components\**\samples\**\*.md" Exclude="$(RepositoryDirectory)**\**\samples\**\obj\**\*.md;$(RepositoryDirectory)**\**\samples\**\bin\**\*.md"/>
     <AdditionalFiles Include="$(RepositoryDirectory)components\**\src\**\*.csproj" />
   </ItemGroup>
 
diff --git a/ProjectHeads/Tasks/CheckMultiTarget.props b/ProjectHeads/Tasks/CheckMultiTarget.props
new file mode 100644
index 00000000..20c3c512
--- /dev/null
+++ b/ProjectHeads/Tasks/CheckMultiTarget.props
@@ -0,0 +1,131 @@
+<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
+
+  <!--
+    MSBuild Inline C# Task Tips:
+
+    1. Avoid defining methods within methods for inline tasks. Use lambda functions instead for any reusable logic.
+    Example:
+    Instead of nested methods:
+    ```csharp
+    void MainLogic() {
+        Helper();
+        
+        void Helper() { /* ... */ }
+    }
+    ```
+
+    Use lambda:
+    ```csharp
+    Func<Type, ReturnType> Helper = (params) => { /* ... */ return result; };
+    ReturnType result = Helper(params);
+    ```
+
+    This ensures compatibility with MSBuild's code generation.
+
+    2. When using lambdas, be cautious of variable naming. If a lambda uses a parameter with the same name as an outer scope variable, it can lead to unexpected behavior.
+    Example:
+    Avoid:
+    ```csharp
+    string variable;
+    Func<string, string> Lambda = (variable) => { /* ... */ };
+    ```
+
+    Instead, use different names:
+    ```csharp
+    string variable;
+    Func<string, string> Lambda = (param) => { /* ... */ };
+    ```
+
+    3. Certain C# features, like string interpolation with the `$""` syntax, may not be supported depending on the MSBuild's CodeTaskFactory and its underlying C# compiler version. Consider using traditional string concatenation or other methods if you encounter issues.
+
+    4. Always use fully qualified namespaces in inline tasks to ensure all types are recognized correctly. This can avoid issues where certain types or methods are not found.
+-->
+  <UsingTask TaskName="CheckMultiTarget" TaskFactory="CodeTaskFactory" AssemblyFile="$(MSBuildToolsPath)\Microsoft.Build.Tasks.Core.dll">
+    <ParameterGroup>
+      <FilePath ParameterType="Microsoft.Build.Framework.ITaskItem" Required="true" Output="true" />
+      <MultiTargetIdentifier ParameterType="System.String" Required="true" />
+      <RepositoryDirectory ParameterType="System.String" Required="true" />
+      <IsSupported ParameterType="System.Boolean" Output="true" />
+    </ParameterGroup>
+    <Task>
+      <Code Type="Fragment" Language="cs">
+        <![CDATA[
+        if (FilePath == null || string.IsNullOrEmpty(FilePath.ItemSpec))
+        {
+            Log.LogError("FilePath is null or empty.");
+            return false; // Exit the task
+        }
+
+        string currentDirectory = System.IO.Path.GetDirectoryName(FilePath.ItemSpec);
+        if (string.IsNullOrEmpty(currentDirectory))
+        {
+            Log.LogError("Failed to get directory name from FilePath.");
+            return false; // Exit the task
+        }
+
+        bool foundSrc = false;
+        while (currentDirectory.Contains("components"))
+        {
+            if (System.IO.Directory.Exists(System.IO.Path.Combine(currentDirectory, "src")))
+            {
+                foundSrc = true;
+                break;
+            }
+
+            var parentDir = System.IO.Directory.GetParent(currentDirectory);
+            if (parentDir != null)
+            {
+                currentDirectory = parentDir.FullName;
+            }
+            else
+            {
+                break;
+            }
+        }
+
+        if (!foundSrc)
+        {
+            Log.LogError(string.Format("Failed to find a parent component directory with 'src' for {0}.", FilePath.ItemSpec));
+            return false; // Exit the task
+        }
+
+        var parentComponent = currentDirectory;
+
+        string multiTargetPropsPath;
+        string multiTargetPropsContent;
+        string multiTargetIdentifier;
+
+        Func<string, string, string> GetMultiTargetPropsPath = (parent, subDir) => System.IO.Path.Combine(parent, subDir, "MultiTarget.props");
+        Func<string, string> ReadMultiTargetPropsOrDefault = path => System.IO.File.Exists(path) ? System.IO.File.ReadAllText(path) : string.Empty;
+        Func<string, string> ExtractMultiTargetIdentifier = content => {
+            System.Text.RegularExpressions.Match match = System.Text.RegularExpressions.Regex.Match(content, @"<MultiTarget>([^<]*)</MultiTarget>", System.Text.RegularExpressions.RegexOptions.Singleline);
+            return match.Success ? match.Groups[1].Value : string.Empty;
+        };
+
+        multiTargetPropsPath = GetMultiTargetPropsPath(parentComponent, "sample");
+        multiTargetPropsContent = ReadMultiTargetPropsOrDefault(multiTargetPropsPath);
+        multiTargetIdentifier = ExtractMultiTargetIdentifier(multiTargetPropsContent);
+
+        if (string.IsNullOrEmpty(multiTargetIdentifier))
+        {
+            multiTargetPropsPath = GetMultiTargetPropsPath(parentComponent, "src");
+            multiTargetPropsContent = ReadMultiTargetPropsOrDefault(multiTargetPropsPath);
+            multiTargetIdentifier = ExtractMultiTargetIdentifier(multiTargetPropsContent);
+        }
+
+        if (string.IsNullOrWhiteSpace(multiTargetIdentifier))
+        {
+            multiTargetPropsPath = System.IO.Path.Combine(RepositoryDirectory, "tooling", "MultiTarget", "Defaults.props");
+            multiTargetPropsContent = ReadMultiTargetPropsOrDefault(multiTargetPropsPath);
+            multiTargetIdentifier = ExtractMultiTargetIdentifier(multiTargetPropsContent);
+        }
+
+        IsSupported = multiTargetIdentifier.Split(';').Contains(MultiTargetIdentifier);
+        FilePath.SetMetadata("IsSupported", IsSupported.ToString());
+        ]]>
+
+      </Code>
+    </Task>
+  </UsingTask>
+
+</Project>

From e24d45279968ea6a99e72b1ecb056299deac64f3 Mon Sep 17 00:00:00 2001
From: Arlo Godfrey <arlo.godfrey@outlook.com>
Date: Tue, 19 Sep 2023 17:15:12 -0500
Subject: [PATCH 2/7] Fixed a lowercase T

---
 ProjectHeads/App.Head.props | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/ProjectHeads/App.Head.props b/ProjectHeads/App.Head.props
index a3057b9d..5ade8a83 100644
--- a/ProjectHeads/App.Head.props
+++ b/ProjectHeads/App.Head.props
@@ -79,7 +79,7 @@
 
   <!-- Gather sample markdown for components that MultiTarget this platform. -->
   <!-- Each deployable sample app head uses the CommunityToolkit.Toolkit.SampleGen source generator to generate document registries -->
-  <Import Project="$(ToolingDirectory)\ProjectHeads\tasks\CheckMultiTarget.props" />
+  <Import Project="$(ToolingDirectory)\ProjectHeads\Tasks\CheckMultiTarget.props" />
 
   <Target Name="AddMultiTargetCompatibleSampleDocs" Condition="'$(IsAllExperimentHead)' == 'true'">
     <!-- Props scoped to current Target -->

From 8c767e698048a6f3d8d627bde04789a94040329b Mon Sep 17 00:00:00 2001
From: Arlo Godfrey <arlo.godfrey@outlook.com>
Date: Tue, 19 Sep 2023 17:44:00 -0500
Subject: [PATCH 3/7] Fixed target execution order

---
 ProjectHeads/App.Head.props | 29 ++++++++++++++---------------
 1 file changed, 14 insertions(+), 15 deletions(-)

diff --git a/ProjectHeads/App.Head.props b/ProjectHeads/App.Head.props
index 5ade8a83..ad3af91c 100644
--- a/ProjectHeads/App.Head.props
+++ b/ProjectHeads/App.Head.props
@@ -1,5 +1,5 @@
 <!-- Common props for any deployable app project head. -->
-<Project InitialTargets="AddMultiTargetCompatibleSampleDocs">
+<Project>
   <!-- Shared project -->
   <Import Project="$(ToolingDirectory)\CommunityToolkit.App.Shared\CommunityToolkit.App.Shared.projitems" Label="Shared" />
 
@@ -81,24 +81,23 @@
   <!-- Each deployable sample app head uses the CommunityToolkit.Toolkit.SampleGen source generator to generate document registries -->
   <Import Project="$(ToolingDirectory)\ProjectHeads\Tasks\CheckMultiTarget.props" />
 
-  <Target Name="AddMultiTargetCompatibleSampleDocs" Condition="'$(IsAllExperimentHead)' == 'true'">
-    <!-- Props scoped to current Target -->
-    <!-- Simplifies comparison of the current head against component-level <MultiTarget> definition -->
-    <PropertyGroup>
-      <MultiTargetIdentifier Condition="'$(IsUwp)' == 'true'">uwp</MultiTargetIdentifier>
-      <MultiTargetIdentifier Condition="'$(IsWasm)' == 'true'">wasm</MultiTargetIdentifier>
-      <MultiTargetIdentifier Condition="'$(IsWasdk)' == 'true'">wasdk</MultiTargetIdentifier>
-      <MultiTargetIdentifier Condition="'$(IsMacos)' == 'true'">macos</MultiTargetIdentifier>
-      <MultiTargetIdentifier Condition="'$(IsIos)' == 'true'">ios</MultiTargetIdentifier>
-      <MultiTargetIdentifier Condition="'$(IsAndroid)' == 'true'">android</MultiTargetIdentifier>
-      <MultiTargetIdentifier Condition="'$(IsNetstandard)' == 'true'">netstandard</MultiTargetIdentifier>
-    </PropertyGroup>
+  <!-- Simplifies comparison of the current head against component-level <MultiTarget> definition -->
+  <PropertyGroup>
+    <MultiTargetIdentifier Condition="'$(IsUwp)' == 'true'">uwp</MultiTargetIdentifier>
+    <MultiTargetIdentifier Condition="'$(IsWasm)' == 'true'">wasm</MultiTargetIdentifier>
+    <MultiTargetIdentifier Condition="'$(IsWasdk)' == 'true'">wasdk</MultiTargetIdentifier>
+    <MultiTargetIdentifier Condition="'$(IsMacos)' == 'true'">macos</MultiTargetIdentifier>
+    <MultiTargetIdentifier Condition="'$(IsIos)' == 'true'">ios</MultiTargetIdentifier>
+    <MultiTargetIdentifier Condition="'$(IsAndroid)' == 'true'">android</MultiTargetIdentifier>
+    <MultiTargetIdentifier Condition="'$(IsNetstandard)' == 'true'">netstandard</MultiTargetIdentifier>
+  </PropertyGroup>
 
-    <Error Condition="$(MultiTargetIdentifier) == ''" Text="Missing MultiTargetIdentifier. Is the `IsSomePlatform` property (`IsUwp`, `IsWasm`, etc) set on the deployable project head?" />
+  <Target Name="AddMultiTargetCompatibleSampleDocs" Condition="'$(IsAllExperimentHead)' == 'true'" BeforeTargets="BeforeBuild">
+    <Error Condition="'$(MultiTargetIdentifier)' == ''" Text="Missing MultiTargetIdentifier $(MultiTargetIdentifier). Is the `IsSomePlatform` property (`IsUwp`, `IsWasm`, etc) set on the deployable project head?" />
 
     <ItemGroup>
       <AllComponentMarkdownFiles Include="$(RepositoryDirectory)components\**\samples\**\*.md" Exclude="$(RepositoryDirectory)**\**\samples\**\obj\**\*.md;$(RepositoryDirectory)**\**\samples\**\bin\**\*.md"/>
-    </ItemGroup>
+    </ItemGroup>`
 
     <Message Text="Found @(AllComponentMarkdownFiles->Count()) total sample docs" Importance="high" />
 

From 5406578f4bb92b2897c5ccada6f9870a0dbb84a2 Mon Sep 17 00:00:00 2001
From: Arlo Godfrey <arlo.godfrey@outlook.com>
Date: Tue, 19 Sep 2023 17:44:05 -0500
Subject: [PATCH 4/7] Use RoslynCodeTaskFactory

---
 ProjectHeads/Tasks/CheckMultiTarget.props | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/ProjectHeads/Tasks/CheckMultiTarget.props b/ProjectHeads/Tasks/CheckMultiTarget.props
index 20c3c512..812b68fe 100644
--- a/ProjectHeads/Tasks/CheckMultiTarget.props
+++ b/ProjectHeads/Tasks/CheckMultiTarget.props
@@ -40,7 +40,7 @@
 
     4. Always use fully qualified namespaces in inline tasks to ensure all types are recognized correctly. This can avoid issues where certain types or methods are not found.
 -->
-  <UsingTask TaskName="CheckMultiTarget" TaskFactory="CodeTaskFactory" AssemblyFile="$(MSBuildToolsPath)\Microsoft.Build.Tasks.Core.dll">
+  <UsingTask TaskName="CheckMultiTarget" TaskFactory="RoslynCodeTaskFactory" AssemblyFile="$(MSBuildToolsPath)\Microsoft.Build.Tasks.Core.dll">
     <ParameterGroup>
       <FilePath ParameterType="Microsoft.Build.Framework.ITaskItem" Required="true" Output="true" />
       <MultiTargetIdentifier ParameterType="System.String" Required="true" />

From f8c689447c99a0d35fc812fd8fd9a1e95c5bec1f Mon Sep 17 00:00:00 2001
From: Arlo Godfrey <arlo.godfrey@outlook.com>
Date: Tue, 19 Sep 2023 17:44:47 -0500
Subject: [PATCH 5/7] Fix typo

---
 ProjectHeads/App.Head.props | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/ProjectHeads/App.Head.props b/ProjectHeads/App.Head.props
index ad3af91c..d45a6f17 100644
--- a/ProjectHeads/App.Head.props
+++ b/ProjectHeads/App.Head.props
@@ -97,7 +97,7 @@
 
     <ItemGroup>
       <AllComponentMarkdownFiles Include="$(RepositoryDirectory)components\**\samples\**\*.md" Exclude="$(RepositoryDirectory)**\**\samples\**\obj\**\*.md;$(RepositoryDirectory)**\**\samples\**\bin\**\*.md"/>
-    </ItemGroup>`
+    </ItemGroup>
 
     <Message Text="Found @(AllComponentMarkdownFiles->Count()) total sample docs" Importance="high" />
 

From 631d85630ab6244fa951cd686c76889f51e37987 Mon Sep 17 00:00:00 2001
From: Arlo Godfrey <arlo.godfrey@outlook.com>
Date: Tue, 19 Sep 2023 18:36:39 -0500
Subject: [PATCH 6/7] Fixed MultiTarget Identifiers

---
 ProjectHeads/App.Head.props | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/ProjectHeads/App.Head.props b/ProjectHeads/App.Head.props
index d45a6f17..cca61a2e 100644
--- a/ProjectHeads/App.Head.props
+++ b/ProjectHeads/App.Head.props
@@ -85,10 +85,10 @@
   <PropertyGroup>
     <MultiTargetIdentifier Condition="'$(IsUwp)' == 'true'">uwp</MultiTargetIdentifier>
     <MultiTargetIdentifier Condition="'$(IsWasm)' == 'true'">wasm</MultiTargetIdentifier>
-    <MultiTargetIdentifier Condition="'$(IsWasdk)' == 'true'">wasdk</MultiTargetIdentifier>
-    <MultiTargetIdentifier Condition="'$(IsMacos)' == 'true'">macos</MultiTargetIdentifier>
-    <MultiTargetIdentifier Condition="'$(IsIos)' == 'true'">ios</MultiTargetIdentifier>
-    <MultiTargetIdentifier Condition="'$(IsAndroid)' == 'true'">android</MultiTargetIdentifier>
+    <MultiTargetIdentifier Condition="'$(IsWinAppSdk)' == 'true'">wasdk</MultiTargetIdentifier>
+    <MultiTargetIdentifier Condition="'$(IsMacOS)' == 'true'">macos</MultiTargetIdentifier>
+    <MultiTargetIdentifier Condition="'$(IsiOS)' == 'true'">ios</MultiTargetIdentifier>
+    <MultiTargetIdentifier Condition="'$(IsDroid)' == 'true'">android</MultiTargetIdentifier>
     <MultiTargetIdentifier Condition="'$(IsNetstandard)' == 'true'">netstandard</MultiTargetIdentifier>
   </PropertyGroup>
 

From 94b0829f49db3f8d9f35e8a53c372de3dd1ff373 Mon Sep 17 00:00:00 2001
From: Arlo Godfrey <arlo.godfrey@outlook.com>
Date: Mon, 25 Sep 2023 18:20:41 -0500
Subject: [PATCH 7/7] Moved AddMultiTargetCompatibleSampleDocs to dedicated
 Target file

---
 ProjectHeads/App.Head.props                   | 43 ++-----------------
 ...AddMultiTargetCompatibleSampleDocs.targets | 41 ++++++++++++++++++
 2 files changed, 44 insertions(+), 40 deletions(-)
 create mode 100644 ProjectHeads/Targets/AddMultiTargetCompatibleSampleDocs.targets

diff --git a/ProjectHeads/App.Head.props b/ProjectHeads/App.Head.props
index cca61a2e..5c77f6b3 100644
--- a/ProjectHeads/App.Head.props
+++ b/ProjectHeads/App.Head.props
@@ -3,6 +3,9 @@
   <!-- Shared project -->
   <Import Project="$(ToolingDirectory)\CommunityToolkit.App.Shared\CommunityToolkit.App.Shared.projitems" Label="Shared" />
 
+  <!-- Gather sample docs from all components -->
+  <Import Project="$(ToolingDirectory)\ProjectHeads\Targets\AddMultiTargetCompatibleSampleDocs.targets" />
+
   <!-- Shared project dependencies -->
   <ItemGroup>
     <PackageReference Include="Newtonsoft.Json" Version="13.0.2" />
@@ -77,46 +80,6 @@
     </When>
   </Choose>
 
-  <!-- Gather sample markdown for components that MultiTarget this platform. -->
-  <!-- Each deployable sample app head uses the CommunityToolkit.Toolkit.SampleGen source generator to generate document registries -->
-  <Import Project="$(ToolingDirectory)\ProjectHeads\Tasks\CheckMultiTarget.props" />
-
-  <!-- Simplifies comparison of the current head against component-level <MultiTarget> definition -->
-  <PropertyGroup>
-    <MultiTargetIdentifier Condition="'$(IsUwp)' == 'true'">uwp</MultiTargetIdentifier>
-    <MultiTargetIdentifier Condition="'$(IsWasm)' == 'true'">wasm</MultiTargetIdentifier>
-    <MultiTargetIdentifier Condition="'$(IsWinAppSdk)' == 'true'">wasdk</MultiTargetIdentifier>
-    <MultiTargetIdentifier Condition="'$(IsMacOS)' == 'true'">macos</MultiTargetIdentifier>
-    <MultiTargetIdentifier Condition="'$(IsiOS)' == 'true'">ios</MultiTargetIdentifier>
-    <MultiTargetIdentifier Condition="'$(IsDroid)' == 'true'">android</MultiTargetIdentifier>
-    <MultiTargetIdentifier Condition="'$(IsNetstandard)' == 'true'">netstandard</MultiTargetIdentifier>
-  </PropertyGroup>
-
-  <Target Name="AddMultiTargetCompatibleSampleDocs" Condition="'$(IsAllExperimentHead)' == 'true'" BeforeTargets="BeforeBuild">
-    <Error Condition="'$(MultiTargetIdentifier)' == ''" Text="Missing MultiTargetIdentifier $(MultiTargetIdentifier). Is the `IsSomePlatform` property (`IsUwp`, `IsWasm`, etc) set on the deployable project head?" />
-
-    <ItemGroup>
-      <AllComponentMarkdownFiles Include="$(RepositoryDirectory)components\**\samples\**\*.md" Exclude="$(RepositoryDirectory)**\**\samples\**\obj\**\*.md;$(RepositoryDirectory)**\**\samples\**\bin\**\*.md"/>
-    </ItemGroup>
-
-    <Message Text="Found @(AllComponentMarkdownFiles->Count()) total sample docs" Importance="high" />
-
-    <CheckMultiTarget FilePath="%(AllComponentMarkdownFiles.Identity)" MultiTargetIdentifier="$(MultiTargetIdentifier)" RepositoryDirectory="$(RepositoryDirectory)">
-      <Output TaskParameter="FilePath" ItemName="ProcessedMarkdownFiles" />
-    </CheckMultiTarget>
-
-    <ItemGroup>
-      <SupportedMarkdownFiles Include="%(ProcessedMarkdownFiles.Identity)" Condition="%(ProcessedMarkdownFiles.IsSupported) == 'true'" />
-    </ItemGroup>
-
-    <Message Text="@(SupportedMarkdownFiles->Count()) sample docs are supported on the current MultiTarget '$(MultiTargetIdentifier)':" Importance="high" />
-    <Message Text="Included %(SupportedMarkdownFiles.Identity)" Importance="high" />
-
-    <ItemGroup>
-      <AdditionalFiles Include="%(SupportedMarkdownFiles.Identity)" />
-    </ItemGroup>
-  </Target>
-
   <!-- Content inclusion -->
   <!-- See https://github.com/CommunityToolkit/Labs-Windows/issues/142 -->
   <ItemGroup Condition="'$(IsAllExperimentHead)' == 'true'">
diff --git a/ProjectHeads/Targets/AddMultiTargetCompatibleSampleDocs.targets b/ProjectHeads/Targets/AddMultiTargetCompatibleSampleDocs.targets
new file mode 100644
index 00000000..02d0ea88
--- /dev/null
+++ b/ProjectHeads/Targets/AddMultiTargetCompatibleSampleDocs.targets
@@ -0,0 +1,41 @@
+<Project>
+  <!-- Gather sample markdown for components that MultiTargets this platform. -->
+  <!-- Each deployable sample app head uses the CommunityToolkit.Toolkit.SampleGen source generator to generate document registries -->
+  <Import Project="$(ToolingDirectory)\ProjectHeads\Tasks\CheckMultiTarget.props" />
+
+  <!-- Simplifies comparison of the current head against component-level <MultiTarget> definition -->
+  <PropertyGroup>
+    <MultiTargetIdentifier Condition="'$(IsUwp)' == 'true'">uwp</MultiTargetIdentifier>
+    <MultiTargetIdentifier Condition="'$(IsWasm)' == 'true'">wasm</MultiTargetIdentifier>
+    <MultiTargetIdentifier Condition="'$(IsWinAppSdk)' == 'true'">wasdk</MultiTargetIdentifier>
+    <MultiTargetIdentifier Condition="'$(IsMacOS)' == 'true'">macos</MultiTargetIdentifier>
+    <MultiTargetIdentifier Condition="'$(IsiOS)' == 'true'">ios</MultiTargetIdentifier>
+    <MultiTargetIdentifier Condition="'$(IsDroid)' == 'true'">android</MultiTargetIdentifier>
+    <MultiTargetIdentifier Condition="'$(IsNetstandard)' == 'true'">netstandard</MultiTargetIdentifier>
+  </PropertyGroup>
+
+  <Target Name="AddMultiTargetCompatibleSampleDocs" Condition="'$(IsAllExperimentHead)' == 'true'" BeforeTargets="BeforeBuild">
+    <Error Condition="'$(MultiTargetIdentifier)' == ''" Text="Missing MultiTargetIdentifier $(MultiTargetIdentifier). Is the `IsSomePlatform` property (`IsUwp`, `IsWasm`, etc) set on the deployable project head?" />
+
+    <ItemGroup>
+      <AllComponentMarkdownFiles Include="$(RepositoryDirectory)components\**\samples\**\*.md" Exclude="$(RepositoryDirectory)**\**\samples\**\obj\**\*.md;$(RepositoryDirectory)**\**\samples\**\bin\**\*.md"/>
+    </ItemGroup>
+
+    <Message Text="Found @(AllComponentMarkdownFiles->Count()) total sample docs" Importance="high" />
+
+    <CheckMultiTarget FilePath="%(AllComponentMarkdownFiles.Identity)" MultiTargetIdentifier="$(MultiTargetIdentifier)" RepositoryDirectory="$(RepositoryDirectory)">
+      <Output TaskParameter="FilePath" ItemName="ProcessedMarkdownFiles" />
+    </CheckMultiTarget>
+
+    <ItemGroup>
+      <SupportedMarkdownFiles Include="%(ProcessedMarkdownFiles.Identity)" Condition="%(ProcessedMarkdownFiles.IsSupported) == 'true'" />
+    </ItemGroup>
+
+    <Message Text="@(SupportedMarkdownFiles->Count()) sample docs are supported on the current MultiTarget '$(MultiTargetIdentifier)':" Importance="high" />
+    <Message Text="Included %(SupportedMarkdownFiles.Identity)" Importance="high" />
+
+    <ItemGroup>
+      <AdditionalFiles Include="%(SupportedMarkdownFiles.Identity)" />
+    </ItemGroup>
+  </Target>
+</Project>
\ No newline at end of file