[WIP] Microsoft Learn Extension

PowerToys.sln

@@ -716,6 +716,8 @@ Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "ZoomItModuleInterface", "sr
 EndProject
 Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "ZoomItSettingsInterop", "src\modules\ZoomIt\ZoomItSettingsInterop\ZoomItSettingsInterop.vcxproj", "{CA7D8106-30B9-4AEC-9D05-B69B31B8C461}"
 EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "MicrosoftLearnExtension", "src\modules\cmdpal\Exts\MicrosoftLearnExtension\MicrosoftLearnExtension.csproj", "{1C58495C-6C10-4EB5-AE6B-CBE8DE8B9775}"
+EndProject
 Global
 	GlobalSection(SolutionConfigurationPlatforms) = preSolution
 		Debug|ARM64 = Debug|ARM64
@@ -3412,6 +3414,24 @@ Global
 		{CA7D8106-30B9-4AEC-9D05-B69B31B8C461}.Release|x64.Build.0 = Release|x64
 		{CA7D8106-30B9-4AEC-9D05-B69B31B8C461}.Release|x86.ActiveCfg = Release|x64
 		{CA7D8106-30B9-4AEC-9D05-B69B31B8C461}.Release|x86.Build.0 = Release|x64
+		{1C58495C-6C10-4EB5-AE6B-CBE8DE8B9775}.Debug|ARM64.ActiveCfg = Debug|ARM64
+		{1C58495C-6C10-4EB5-AE6B-CBE8DE8B9775}.Debug|ARM64.Build.0 = Debug|ARM64
+		{1C58495C-6C10-4EB5-AE6B-CBE8DE8B9775}.Debug|ARM64.Deploy.0 = Debug|ARM64
+		{1C58495C-6C10-4EB5-AE6B-CBE8DE8B9775}.Debug|x64.ActiveCfg = Debug|x64
+		{1C58495C-6C10-4EB5-AE6B-CBE8DE8B9775}.Debug|x64.Build.0 = Debug|x64
+		{1C58495C-6C10-4EB5-AE6B-CBE8DE8B9775}.Debug|x64.Deploy.0 = Debug|x64
+		{1C58495C-6C10-4EB5-AE6B-CBE8DE8B9775}.Debug|x86.ActiveCfg = Debug|x64
+		{1C58495C-6C10-4EB5-AE6B-CBE8DE8B9775}.Debug|x86.Build.0 = Debug|x64
+		{1C58495C-6C10-4EB5-AE6B-CBE8DE8B9775}.Debug|x86.Deploy.0 = Debug|x64
+		{1C58495C-6C10-4EB5-AE6B-CBE8DE8B9775}.Release|ARM64.ActiveCfg = Release|ARM64
+		{1C58495C-6C10-4EB5-AE6B-CBE8DE8B9775}.Release|ARM64.Build.0 = Release|ARM64
+		{1C58495C-6C10-4EB5-AE6B-CBE8DE8B9775}.Release|ARM64.Deploy.0 = Release|ARM64
+		{1C58495C-6C10-4EB5-AE6B-CBE8DE8B9775}.Release|x64.ActiveCfg = Release|x64
+		{1C58495C-6C10-4EB5-AE6B-CBE8DE8B9775}.Release|x64.Build.0 = Release|x64
+		{1C58495C-6C10-4EB5-AE6B-CBE8DE8B9775}.Release|x64.Deploy.0 = Release|x64
+		{1C58495C-6C10-4EB5-AE6B-CBE8DE8B9775}.Release|x86.ActiveCfg = Release|x64
+		{1C58495C-6C10-4EB5-AE6B-CBE8DE8B9775}.Release|x86.Build.0 = Release|x64
+		{1C58495C-6C10-4EB5-AE6B-CBE8DE8B9775}.Release|x86.Deploy.0 = Release|x64
 	EndGlobalSection
 	GlobalSection(SolutionProperties) = preSolution
 		HideSolutionNode = FALSE
@@ -3679,14 +3699,15 @@ Global
 		{453CBB73-A3CB-4D0B-8D24-6940B86FE21D} = {ECB8E0D1-7603-4E5C-AB10-D1E545E6F8E2}
 		{C0CE3B5E-16D3-495D-B335-CA791B660162} = {ECB8E0D1-7603-4E5C-AB10-D1E545E6F8E2}
 		{3A9A7297-92C4-4F16-B6F9-8D4AB652C86C} = {ECB8E0D1-7603-4E5C-AB10-D1E545E6F8E2}
-		{605E914B-7232-4789-AF46-BF5D3DDFC14E} = {ECB8E0D1-7603-4E5C-AB10-D1E545E6F8E2}
 		{D5E5F5EA-1B6C-4A73-88BE-304F36C9E4EE} = {9873BA05-4C41-4819-9283-CF45D795431B}
+		{605E914B-7232-4789-AF46-BF5D3DDFC14E} = {ECB8E0D1-7603-4E5C-AB10-D1E545E6F8E2}
 		{7F5B9557-5878-4438-A721-3E28296BA193} = {9873BA05-4C41-4819-9283-CF45D795431B}
 		{E81A7D20-9862-ABDB-0AAE-9BC5B517A9F9} = {ECB8E0D1-7603-4E5C-AB10-D1E545E6F8E2}
 		{DD6E12FE-5509-4ABC-ACC2-3D6DC98A238C} = {4574FDD0-F61D-4376-98BF-E5A1262C11EC}
 		{0A84F764-3A88-44CD-AA96-41BDBD48627B} = {DD6E12FE-5509-4ABC-ACC2-3D6DC98A238C}
 		{E4585179-2AC1-4D5F-A3FF-CFC5392F694C} = {DD6E12FE-5509-4ABC-ACC2-3D6DC98A238C}
 		{CA7D8106-30B9-4AEC-9D05-B69B31B8C461} = {DD6E12FE-5509-4ABC-ACC2-3D6DC98A238C}
+		{1C58495C-6C10-4EB5-AE6B-CBE8DE8B9775} = {071E18A4-A530-46B8-AB7D-B862EE55E24E}
 	EndGlobalSection
 	GlobalSection(ExtensibilityGlobals) = postSolution
 		SolutionGuid = {C3A2F9D1-7930-4EF4-A6FC-7EE0A99821D0}

src/modules/cmdpal/Exts/MicrosoftLearnExtension/LinkAction.cs

@@ -0,0 +1,26 @@
+// Copyright (c) Microsoft Corporation
+// The Microsoft Corporation licenses this file to you under the MIT license.
+// See the LICENSE file in the project root for more information.
+
+using System.Diagnostics;
+using Microsoft.CmdPal.Extensions.Helpers;
+
+namespace MicrosoftLearnExtension;
+
+internal sealed partial class LinkAction : InvokableCommand
+{
+    private readonly SearchResult _post;
+
+    internal LinkAction(SearchResult post)
+    {
+        this._post = post;
+        this.Name = "Open link";
+        this.Icon = new("\uE8A7");
+    }
+
+    public override CommandResult Invoke()
+    {
+        Process.Start(new ProcessStartInfo(_post.Url) { UseShellExecute = true });
+        return CommandResult.KeepOpen();
+    }
+}

src/modules/cmdpal/Exts/MicrosoftLearnExtension/MicrosoftLearnExtension.csproj

@@ -0,0 +1,52 @@
+<Project Sdk="Microsoft.NET.Sdk">
+  <Import Project="..\..\..\..\Common.Dotnet.CsWinRT.props" />
+  <PropertyGroup>
+    <OutputType>WinExe</OutputType>
+    <RootNamespace>MicrosoftLearnExtension</RootNamespace>
+    <ApplicationManifest>app.manifest</ApplicationManifest>
+    <PublishProfile>win-$(Platform).pubxml</PublishProfile>
+    <UseWinUI>false</UseWinUI>
+    <EnableMsixTooling>true</EnableMsixTooling>
+    <OutputPath>$(SolutionDir)$(Platform)\$(Configuration)\WinUI3Apps\CmdPalExtensions\$(RootNamespace)</OutputPath>
+    <AppendTargetFrameworkToOutputPath>false</AppendTargetFrameworkToOutputPath>
+    <AppendRuntimeIdentifierToOutputPath>false</AppendRuntimeIdentifierToOutputPath>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <Content Include="Assets\SplashScreen.scale-200.png" />
+    <Content Include="Assets\LockScreenLogo.scale-200.png" />
+    <Content Include="Assets\Square150x150Logo.scale-200.png" />
+    <Content Include="Assets\Square44x44Logo.scale-200.png" />
+    <Content Include="Assets\Square44x44Logo.targetsize-24_altform-unplated.png" />
+    <Content Include="Assets\StoreLogo.png" />
+    <Content Include="Assets\Wide310x150Logo.scale-200.png" />
+  </ItemGroup>
+
+  <ItemGroup>
+    <Manifest Include="$(ApplicationManifest)" />
+  </ItemGroup>
+
+
+  <ItemGroup>
+    <ProjectReference Include="..\..\extensionsdk\Microsoft.CmdPal.Extensions.Helpers\Microsoft.CmdPal.Extensions.Helpers.csproj" />
+    <ProjectReference Include="..\..\..\..\common\Common.UI\Common.UI.csproj" />
+  </ItemGroup>
+
+  <!--
+    Defining the "Msix" ProjectCapability here allows the Single-project MSIX Packaging
+    Tools extension to be activated for this project even if the Windows App SDK Nuget
+    package has not yet been restored.
+  -->
+  <ItemGroup Condition="'$(DisableMsixProjectCapabilityAddedByProject)'!='true' and '$(EnableMsixTooling)'=='true'">
+    <ProjectCapability Include="Msix" />
+  </ItemGroup>
+
+  <!--
+    Defining the "HasPackageAndPublishMenuAddedByProject" property here allows the Solution
+    Explorer "Package and Publish" context menu entry to be enabled for this project even if
+    the Windows App SDK Nuget package has not yet been restored.
+  -->
+  <PropertyGroup Condition="'$(DisableHasPackageAndPublishMenuAddedByProject)'!='true' and '$(EnableMsixTooling)'=='true'">
+    <HasPackageAndPublishMenu>true</HasPackageAndPublishMenu>
+  </PropertyGroup>
+</Project>

src/modules/cmdpal/Exts/MicrosoftLearnExtension/MicrosoftLearnExtensionCommandsProvider.cs

@@ -0,0 +1,28 @@
+// Copyright (c) Microsoft Corporation
+// The Microsoft Corporation licenses this file to you under the MIT license.
+// See the LICENSE file in the project root for more information.
+
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+using Microsoft.CmdPal.Extensions;
+using Microsoft.CmdPal.Extensions.Helpers;
+using Windows.Foundation;
+
+namespace MicrosoftLearnExtension;
+
+public partial class MicrosoftLearnExtensionActionsProvider : CommandProvider
+{
+    public MicrosoftLearnExtensionActionsProvider()
+    {
+        DisplayName = $"Microsoft Learn Doc Search Extension for cmdpal Commands";
+    }
+
+    private readonly ICommandItem[] _actions = [
+        new CommandItem(new MicrosoftLearnExtensionPage()),
+    ];
+
+    public override ICommandItem[] TopLevelCommands() => _actions;
+}

src/modules/cmdpal/Exts/MicrosoftLearnExtension/Package.appxmanifest

@@ -0,0 +1,78 @@
+<?xml version="1.0" encoding="utf-8"?>
+
+<Package
+  xmlns="http://schemas.microsoft.com/appx/manifest/foundation/windows10"
+  xmlns:uap="http://schemas.microsoft.com/appx/manifest/uap/windows10"
+  xmlns:uap3="http://schemas.microsoft.com/appx/manifest/uap/windows10/3"
+  xmlns:com="http://schemas.microsoft.com/appx/manifest/com/windows10"
+  xmlns:rescap="http://schemas.microsoft.com/appx/manifest/foundation/windows10/restrictedcapabilities"
+  IgnorableNamespaces="uap uap3 rescap">
+
+  <Identity
+    Name="MicrosoftLearnExtension"
+    Publisher="CN=Microsoft Corporation, O=Microsoft Corporation, L=Redmond, S=Washington, C=US"
+    Version="0.0.1.0" />
+
+  <Properties>
+    <DisplayName>Microsoft Learn Doc Search Extension for cmdpal</DisplayName>
+    <PublisherDisplayName>A Lone Developer</PublisherDisplayName>
+    <Logo>Assets\StoreLogo.png</Logo>
+  </Properties>
+
+  <Dependencies>
+    <TargetDeviceFamily Name="Windows.Universal" MinVersion="10.0.17763.0" MaxVersionTested="10.0.19041.0" />
+    <TargetDeviceFamily Name="Windows.Desktop" MinVersion="10.0.17763.0" MaxVersionTested="10.0.19041.0" />
+  </Dependencies>
+
+  <Resources>
+    <Resource Language="x-generate"/>
+  </Resources>
+
+  <Applications>
+    <Application Id="App"
+      Executable="$targetnametoken$.exe"
+      EntryPoint="$targetentrypoint$">
+      <uap:VisualElements
+        DisplayName="Microsoft Learn Doc Search Extension for cmdpal"
+        Description="Microsoft Learn Doc Search Extension for cmdpal"
+        BackgroundColor="transparent"
+        Square150x150Logo="Assets\Square150x150Logo.png"
+        Square44x44Logo="Assets\Square44x44Logo.png">
+        <uap:DefaultTile Wide310x150Logo="Assets\Wide310x150Logo.png" />
+        <uap:SplashScreen Image="Assets\SplashScreen.png" />
+      </uap:VisualElements>
+      <Extensions>
+        <com:Extension Category="windows.comServer">
+          <com:ComServer>
+            <com:ExeServer Executable="MicrosoftLearnExtension.exe" Arguments="-RegisterProcessAsComServer" DisplayName="ClementineExtensionApp">
+              <com:Class Id="11771f22-a54a-400c-8c3d-5c9c31b4429c" DisplayName="Microsoft Learn Doc Search Extension for cmdpal" />
+            </com:ExeServer>
+          </com:ComServer>
+        </com:Extension>
+        <uap3:Extension Category="windows.appExtension">
+          <uap3:AppExtension Name="com.microsoft.windows.commandpalette"
+            Id="PG-SP-ID"
+            PublicFolder="Public"
+            DisplayName="Microsoft Learn Doc Search Extension for cmdpal"
+            Description="Microsoft Learn Doc Search Extension for cmdpal">
+            <uap3:Properties>
+              <CmdPalProvider>
+                <Activation>
+                  <CreateInstance ClassId="11771f22-a54a-400c-8c3d-5c9c31b4429c" />
+                </Activation>
+                <SupportedInterfaces>
+                  <Commands/>
+                </SupportedInterfaces>
+              </CmdPalProvider>
+            </uap3:Properties>
+          </uap3:AppExtension>
+        </uap3:Extension>
+      </Extensions>
+    </Application>
+  </Applications>
+
+  <Capabilities>
+    <Capability Name="internetClient" />
+    <rescap:Capability Name="runFullTrust" />
+  </Capabilities>
+</Package>