Improve module docs, ship them in the nuget, and add missing properties to Visual Studio proejct properties page (#1586)

Author: DefaultRyan

nuget/CppWinrtRules.Project.xml

@@ -3,6 +3,7 @@
 
   <Rule.Categories>
     <Category Name="General" DisplayName="General"/>
+    <Category Name="Modules" DisplayName="C++20 Modules"/>
   </Rule.Categories>
 
   <Rule.DataSource>
@@ -86,4 +87,24 @@
                 Description="Enables the /await:strict compiler option"
                 Category="General" />
 
+  <BoolProperty Name="CppWinRTMergeNoValidate"
+                DisplayName="Disable mdmerge Validation"
+                Description="Disables mdmerge.exe validation of merged Windows Metadata"
+                Category="General" />
+
+  <BoolProperty Name="CppWinRTBuildModule"
+                DisplayName="Build C++20 Modules"
+                Description="Generates per-namespace C++20 module interface units (.ixx) alongside projection headers. See modules.md in the NuGet package for guidance."
+                Category="Modules" />
+
+  <StringProperty Name="CppWinRTModuleInclude"
+                  DisplayName="Module Include Filter"
+                  Description="Semicolon-delimited list of namespace prefixes to include in module (.ixx) generation. When empty, all namespaces are candidates."
+                  Category="Modules" />
+
+  <StringProperty Name="CppWinRTModuleExclude"
+                  DisplayName="Module Exclude Filter"
+                  Description="Semicolon-delimited list of namespace prefixes to exclude from module (.ixx) generation. Use to avoid generating modules with unsatisfied dependencies, or to avoid duplicating modules already provided by a referenced project."
+                  Category="Modules" />
+
 </Rule>

nuget/Microsoft.Windows.CppWinRT.nuspec

@@ -12,6 +12,7 @@
     <tags>native C++ WinRT nativepackage</tags>
     <copyright>© Microsoft Corporation. All rights reserved.</copyright>
     <license type="file">LICENSE</license>
+    <readme>readme.md</readme>
     <projectUrl>https://github.com/Microsoft/cppwinrt</projectUrl>
     <iconUrl>https://aka.ms/cppwinrt.ico</iconUrl>
   </metadata>
@@ -25,5 +26,7 @@
     <file src="Microsoft.Windows.CppWinRT.targets" target="build\native"/>
     <file src="CppWinrtRules.Project.xml" target="build\native"/>
     <file src="readme.txt"/>
+    <file src="readme.md"/>
+    <file src="modules.md"/>
   </files>
 </package>