Improving performance of Adding and Removing Packaged Apps (#4521) (#4900) (#4901)

* Merging in Theme changes and moving win32Tests to Microsoft.Plugin.Program.UnitTests

* Fixing message format for exception

* Changing test structure.  Need to add unit tests.

* Updating packagerepository comment based on pr feedback

* Fixing potential race condition in ListRepository.  Now internally implemented as a concurrent dictionary.

* Removing unecessary implementation of IRepository interface as this is implemented by the base class.

* Restoring checks for invalid uwp apps based on PR feedback. This was accidentally removed when moving the initialize outside the constructor.

* Fixing comments

* Adding newline to end of file for IProgramRepository

.github/pull_request_template.md

@@ -6,7 +6,7 @@
 
 <!-- Please review the items on the PR checklist before submitting-->
 ## PR Checklist
-* [ ] Closes #xxx
+* [ ] Applies to #xxx
 * [ ] CLA signed. If not, go over [here](https://cla.opensource.microsoft.com/microsoft/PowerToys) and sign the CLA
 * [ ] Tests added/passed
 * [ ] Requires documentation to be updated

.gitignore

@@ -301,6 +301,8 @@ __pycache__/
 # Cake - Uncomment if you are using it
 # tools/**
 # !tools/packages.config
+ImageResizer/tools/**
+!ImageResizer/tools/packages.config
 
 # Tabs Studio
 *.tss
@@ -328,3 +330,14 @@ ASALocalRun/
 
 # MFractors (Xamarin productivity tool) working folder 
 .mfractor/
+
+# Temp build files
+src/settings/settings-html/200.html
+src/settings/settings-html/404.html
+
+# Temp telemetry files.
+src/common/Telemetry/*.etl
+
+# Don't ignore MergeModules
+!**/MergeModules/Release/
+!**/MergeModules/Debug/

.pipelines/build-installer.cmd

@@ -1,4 +1,5 @@
 cd /D "%~dp0"
 
-call "C:\Program Files (x86)\Microsoft Visual Studio\2019\Enterprise\Common7\Tools\VsDevCmd.bat" -arch=amd64 -host_arch=amd64 -winsdk=10.0.16299.0
-call msbuild ../installer/PowerToysSetup.sln /p:Configuration=Release /p:Platform=x64 || exit /b 1
+call "C:\Program Files (x86)\Microsoft Visual Studio\2019\Enterprise\Common7\Tools\VsDevCmd.bat" -arch=amd64 -host_arch=amd64 -winsdk=10.0.18362.0
+SET IsPipeline=1
+call msbuild ../installer/PowerToysSetup.sln /p:Configuration=Release /p:Platform=x64 /p:CIBuild=true || exit /b 1

.pipelines/build.cmd

@@ -1,4 +1,6 @@
 cd /D "%~dp0"
 
-call "C:\Program Files (x86)\Microsoft Visual Studio\2019\Enterprise\Common7\Tools\VsDevCmd.bat" -arch=amd64 -host_arch=amd64 -winsdk=10.0.16299.0
-call msbuild ../PowerToys.sln /p:Configuration=Release /p:Platform=x64 || exit /b 1
+call "C:\Program Files (x86)\Microsoft Visual Studio\2019\Enterprise\Common7\Tools\VsDevCmd.bat" -arch=amd64 -host_arch=amd64 -winsdk=10.0.18362.0
+call msbuild ../PowerToys.sln /p:Configuration=Release /p:Platform=x64 /p:CIBuild=true || exit /b 1
+SET PTRoot=..
+call "..\installer\PowerToysSetup\publish.cmd"

.pipelines/ci/ci.yml

@@ -3,6 +3,8 @@ trigger:
   branches:
     include:
       - master
+      - dev/build-features
+      - dev/PowerLauncher
   paths:
     exclude:
       - doc/*
@@ -13,6 +15,8 @@ pr:
   branches:
     include:
       - master
+      - dev/build-features
+      - dev/PowerLauncher
 
 #     0.0.yyMM.dd##
 #     0.0.1904.0900

.pipelines/ci/templates/build-powertoys-ci.yml

@@ -1,7 +1,7 @@
 parameters:
   configuration: 'Release'
   platform: ''
-  additionalBuildArguments: ''
+  additionalBuildArguments: '/p:CIBuild=true'
 
 jobs:
 - job: Build${{ parameters.platform }}${{ parameters.configuration }}

.pipelines/ci/templates/build-powertoys-steps.yml

@@ -3,13 +3,14 @@ parameters:
 
 steps:
 - checkout: self
+  fetchDepth: 1
   submodules: true
   clean: true
 
 - task: NuGetToolInstaller@0
-  displayName: Ensure NuGet 4.8.1
+  displayName: Ensure NuGet 5.5.0
   inputs:
-    versionSpec: 4.8.1
+    versionSpec: 5.5.0
 
 - task: VisualStudioTestPlatformInstaller@1
   displayName: Ensure VSTest Platform
@@ -31,5 +32,18 @@ steps:
     platform: '$(BuildPlatform)'
     configuration: '$(BuildConfiguration)'
     msbuildArgs: ${{ parameters.additionalBuildArguments }}
-    clean: true
     maximumCpuCount: true
+
+- task: VSTest@2
+  inputs:
+    platform: '$(BuildPlatform)'
+    configuration: '$(BuildConfiguration)'
+    testSelector: 'testAssemblies'
+    testAssemblyVer2: |
+      **\PreviewPaneUnitTests.dll
+      **\UnitTests-SvgPreviewHandler.dll
+      **\UnitTests-PreviewHandlerCommon.dll
+      **\powerpreviewTest.dll
+      **\UnitTests-CommonLib.dll
+      !**\*TestAdapter.dll
+      !**\obj\**

.pipelines/packages.config

@@ -0,0 +1,4 @@
+<?xml version="1.0" encoding="utf-8"?>
+<packages>
+  <package id="Microsoft.PowerToys.Telemetry" version="2.0"  />
+</packages>

.pipelines/pipeline.user.windows.yml

@@ -2,10 +2,10 @@ environment:
   host:
     os: 'windows'
     flavor: 'server'
-    version: '2016'
+    version: '2019'
   runtime:
     provider: 'appcontainer'
-    image: 'cdpxwin.azurecr.io/user/powertoys/vs2019:3.0'
+    image: 'cdpxwin1809.azurecr.io/global/vse2019:latest'
     source_mode: 'map'
 
 version:
@@ -41,14 +41,85 @@ build:
       name: 'Build Power Toys'
       command: '.pipelines\build.cmd'
       artifacts:
+        - to: 'Symbols'
+          include:
+            - 'x64/**/*.pdb'
+          exclude:
+            - 'x64/Release/obj/**/*.pdb'
         - from: 'x64/Release'
           to: 'Build_Output'
           include:
-          - 'PowerToys.exe'
-          - 'PowerToysSettings.exe'
-          - 'modules\FancyZonesEditor.exe'
-          - 'modules\fancyzones.dll'
-          - 'modules\shortcut_guide.dll'
+            - 'action_runner.exe'
+            - 'modules\ImageResizer\ar\ImageResizer.resources.dll'
+            - 'modules\ImageResizer\bg\ImageResizer.resources.dll'
+            - 'modules\ImageResizer\ca\ImageResizer.resources.dll'
+            - 'modules\ImageResizer\cs\ImageResizer.resources.dll'
+            - 'modules\ImageResizer\de\ImageResizer.resources.dll'
+            - 'modules\ImageResizer\es\ImageResizer.resources.dll'
+            - 'modules\ImageResizer\eu-ES\ImageResizer.resources.dll'
+            - 'modules\ImageResizer\fr\ImageResizer.resources.dll'
+            - 'modules\ImageResizer\he\ImageResizer.resources.dll'
+            - 'modules\ImageResizer\hu\ImageResizer.resources.dll'
+            - 'modules\ImageResizer\it\ImageResizer.resources.dll'
+            - 'modules\ImageResizer\nb-NO\ImageResizer.resources.dll'
+            - 'modules\ImageResizer\nl\ImageResizer.resources.dll'
+            - 'modules\ImageResizer\pl\ImageResizer.resources.dll'
+            - 'modules\ImageResizer\pt-BR\ImageResizer.resources.dll'
+            - 'modules\ImageResizer\ru\ImageResizer.resources.dll'
+            - 'modules\ImageResizer\sk\ImageResizer.resources.dll'
+            - 'modules\ImageResizer\tr\ImageResizer.resources.dll'
+            - 'modules\ImageResizer\zh-Hans\ImageResizer.resources.dll'
+            - 'modules\FancyZones\fancyzones.dll'
+            - 'modules\FancyZones\FancyZonesEditor.exe'
+            - 'modules\FileExplorerPreview\MarkdownPreviewHandler.dll'
+            - 'modules\FileExplorerPreview\powerpreview.dll'
+            - 'modules\FileExplorerPreview\PreviewHandlerCommon.dll'
+            - 'modules\FileExplorerPreview\SvgPreviewHandler.dll'
+            - 'modules\ImageResizer\ImageResizer.exe'
+            - 'modules\ImageResizer\ImageResizerExt.dll'
+            - 'modules\KeyboardManager\KeyboardManager.dll'
+            - 'modules\launcher\Microsoft.PowerToys.Settings.UI.Lib.dll'
+            - 'modules\launcher\Plugins\Microsoft.Plugin.Calculator\Microsoft.Plugin.Calculator.dll'
+            - 'modules\launcher\Plugins\Microsoft.Plugin.Calculator\Wox.Infrastructure.dll'
+            - 'modules\launcher\Plugins\Microsoft.Plugin.Calculator\Wox.Plugin.dll'
+            - 'modules\launcher\Plugins\Microsoft.Plugin.Folder\Microsoft.Plugin.Folder.dll'
+            - 'modules\launcher\Plugins\Microsoft.Plugin.Folder\Wox.Infrastructure.dll'
+            - 'modules\launcher\Plugins\Microsoft.Plugin.Folder\Wox.Plugin.dll'
+            - 'modules\launcher\Plugins\Microsoft.Plugin.Indexer\Microsoft.Plugin.Indexer.dll'
+            - 'modules\launcher\Plugins\Microsoft.Plugin.Indexer\Wox.Infrastructure.dll'
+            - 'modules\launcher\Plugins\Microsoft.Plugin.Program\Microsoft.Plugin.Program.dll'
+            - 'modules\launcher\Plugins\Microsoft.Plugin.Program\Wox.Infrastructure.dll'
+            - 'modules\launcher\Plugins\Microsoft.Plugin.Program\Wox.Plugin.dll'
+            - 'modules\launcher\Plugins\Microsoft.Plugin.Shell\Microsoft.Plugin.Shell.dll'
+            - 'modules\launcher\Plugins\Microsoft.Plugin.Shell\Wox.Infrastructure.dll'
+            - 'modules\launcher\Plugins\Microsoft.Plugin.Shell\Wox.Plugin.dll'
+            - 'modules\launcher\Plugins\Microsoft.Plugin.WindowWalker\Microsoft.Plugin.WindowWalker.dll'
+            - 'modules\launcher\Plugins\Microsoft.Plugin.WindowWalker\Wox.Infrastructure.dll'
+            - 'modules\launcher\Plugins\Microsoft.Plugin.WindowWalker\Wox.Plugin.dll'
+            - 'modules\launcher\PowerLauncher.dll'
+            - 'modules\launcher\PowerLauncher.exe'
+            - 'modules\launcher\PowerLauncher.Telemetry.dll'
+            - 'modules\launcher\PowerLauncher.UI.exe'
+            - 'modules\launcher\PowerToysInterop.dll'
+            - 'modules\launcher\Telemetry.dll'
+            - 'modules\launcher\Wox.Core.dll'
+            - 'modules\launcher\Wox.dll'
+            - 'modules\launcher\Wox.Infrastructure.dll'
+            - 'modules\launcher\Wox.Plugin.dll'
+            - 'modules\Microsoft.Launcher.dll'
+            - 'modules\PowerRename\PowerRenameExt.dll'
+            - 'modules\ShortcutGuide\ShortcutGuide.dll'
+            - 'Notifications.dll'
+            - 'os-detection.dll'
+            - 'PowerToys.exe'
+            - 'PowerToysInterop.dll'
+            - 'PowerToysSettings.exe'
+            - 'SettingsUIRunner\Microsoft.PowerToys.Settings.UI.exe'
+            - 'SettingsUIRunner\Microsoft.PowerToys.Settings.UI.Lib.dll'
+            - 'SettingsUIRunner\Microsoft.PowerToys.Settings.UI.Runner.dll'
+            - 'SettingsUIRunner\Microsoft.PowerToys.Settings.UI.Runner.exe'
+            - 'SettingsUIRunner\PowerToysInterop.dll'
+            - 'SettingsUIRunner\Telemetry.dll'
           signing_options:
             sign_inline: true  # This does signing a soon as this command completes
     - !!buildcommand
@@ -58,24 +129,37 @@ build:
         - from: 'installer\PowerToysSetup\x64\Release'
           to: 'Build_Installer_Output'
           include:
-            - 'PowerToysSetup.msi'
+            - 'PowerToysSetup-*.msi'
           signing_options:
             sign_inline: true  # This does signing a soon as this command completes
 
+#package:
+#  commands:
+#    - !!buildcommand
+#      name: 'Build MSIX package'
+#      command: 'installer\msix\build_msix_cdpx.cmd'
+#      artifacts:
+#        - from: 'installer\msix\bin'
+#          to: 'Build_MSIX_Package_Output'
+#          include:
+#            - '*.msix'
+#            - '*.msixbundle'
+#          signing_options:
+#            profile: '400'
+
 static_analysis_options:                             
   binskim_options:  
     files_to_scan:
       - from: 'installer/packages'
         exclude:
-        exclude:
-        - 'WiX.3.11.1/**/*.dll'
-        - 'Wix.3.11.1/**/*.exe'
+          - 'WiX.*/**/*.dll'
+          - 'Wix.*/**/*.exe'
   moderncop_options:           
     files_to_scan:
       - from: 'src'          
         exclude:                           
-        - '**/just.config.js'
-        - '**/webpack.config.js'
-        - '**/webpack.serve.config.js'
-        - '**/dist/bundle.js' 
-        
+          - '**/just.config.js'
+          - '**/webpack.config.js'
+          - '**/webpack.serve.config.js'
+          - '**/dist/bundle.js' 
+        

.pipelines/restore-telemetry.cmd

@@ -1,6 +1,6 @@
 cd /D "%~dp0"
 
-set PROJECT="..\src\modules\fancyzones\editor\FancyZonesEditor\FancyZonesEditor.csproj"
-set TELEMETRY_PKG="Microsoft.PowerToys.Telemetry"
+call nuget.exe restore -PackagesDirectory . packages.config || exit /b 1
 
-dotnet add %PROJECT% package %TELEMETRY_PKG%
+move /Y "Microsoft.PowerToys.Telemetry.2.0.0\build\include\TraceLoggingDefines.h" "..\src\common\Telemetry\TraceLoggingDefines.h" || exit /b 1
+move /Y "Microsoft.PowerToys.Telemetry.2.0.0\build\include\TelemetryBase.cs" "..\src\common\Telemetry\TelemetryBase.cs" || exit /b 1

CODE_OF_CONDUCT.md

@@ -0,0 +1,9 @@
+# Microsoft Open Source Code of Conduct
+
+This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).
+
+Resources:
+
+- [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/)
+- [Microsoft Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/)
+- Contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with questions or concerns

LICENSE

@@ -1,4 +1,4 @@
-The MIT License (MIT)
+The MIT License
 
 Copyright (c) Microsoft Corporation. All rights reserved.
 

NOTICE.md

@@ -0,0 +1,126 @@
+# NOTICES AND INFORMATION
+This software incorporates material from third parties.
+
+## PowerToy: ImageResizer
+
+### Brice Lams's Image Resizer License
+
+**Source**: https://github.com/bricelam/ImageResizer/
+
+The MIT License (MIT)
+
+Copyright (c) Brice Lambson. All rights reserved.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
+
+## PowerToy: Launcher
+
+### Wox License
+
+**Fork project source**: https://github.com/jjw24/Wox/
+**Base project source**: https://github.com/Wox-launcher/Wox
+
+The MIT License (MIT)
+
+Copyright (c) 2015 Wox
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+the Software, and to permit persons to whom the Software is furnished to do so,
+subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+###  Beta Tadele's Window Walker License
+
+**Source**: https://github.com/betsegaw/windowwalker
+
+The MIT License (MIT)
+
+Copyright 2020 Betsegaw Tadele
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+### Squirrel.Windows License
+
+**Source**: https://github.com/Squirrel/Squirrel.Windows/
+
+The MIT License (MIT)
+
+Copyright (c) 2012 GitHub, Inc.
+
+Permission is hereby granted,  free of charge,  to any person obtaining a
+copy of this software and associated documentation files (the "Software"),
+to deal in the Software without restriction, including without limitation
+the rights to  use, copy, modify, merge, publish, distribute, sublicense,
+and/or sell copies of the Software, and to permit persons to whom the
+Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
+DEALINGS IN THE SOFTWARE.
+
+## PowerToy: PowerRename
+
+### Chris Davis's SmartRename License
+
+**Source**: https://github.com/chrdavis/SmartRename
+
+MIT License
+
+Copyright (c) 2017 Chris Davis
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

PowerToys.sln

@@ -5,17 +5,39 @@ VisualStudioVersion = 16.0.28803.452
 MinimumVisualStudioVersion = 10.0.40219.1
 Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "runner", "src\runner\runner.vcxproj", "{9412D5C6-2CF2-4FC2-A601-B55508EA9B27}"
 	ProjectSection(ProjectDependencies) = postProject
+		{217DF501-135C-4E38-BFC8-99D4821032EA} = {217DF501-135C-4E38-BFC8-99D4821032EA}
+		{0E072714-D127-460B-AFAD-B4C40B412798} = {0E072714-D127-460B-AFAD-B4C40B412798}
 		{48804216-2A0E-4168-A6D8-9CD068D14227} = {48804216-2A0E-4168-A6D8-9CD068D14227}
+		{51920F1F-C28C-4ADF-8660-4238766796C2} = {51920F1F-C28C-4ADF-8660-4238766796C2}
+		{6A71162E-FC4C-4A2C-B90F-3CF94F59A9BB} = {6A71162E-FC4C-4A2C-B90F-3CF94F59A9BB}
+		{031AC72E-FA28-4AB7-B690-6F7B9C28AA73} = {031AC72E-FA28-4AB7-B690-6F7B9C28AA73}
 		{74485049-C722-400F-ABE5-86AC52D929B3} = {74485049-C722-400F-ABE5-86AC52D929B3}
+		{0485F45C-EA7A-4BB5-804B-3E8D14699387} = {0485F45C-EA7A-4BB5-804B-3E8D14699387}
+		{D29DDD63-E2CF-4657-9FD5-2AEDE4257E5D} = {D29DDD63-E2CF-4657-9FD5-2AEDE4257E5D}
+		{5CCC8468-DEC8-4D36-99D4-5C891BEBD481} = {5CCC8468-DEC8-4D36-99D4-5C891BEBD481}
+		{0B593A6C-4143-4337-860E-DB5710FB87DB} = {0B593A6C-4143-4337-860E-DB5710FB87DB}
+		{E364F67B-BB12-4E91-B639-355866EBCD8B} = {E364F67B-BB12-4E91-B639-355866EBCD8B}
+		{DA425894-6E13-404F-8DCB-78584EC0557A} = {DA425894-6E13-404F-8DCB-78584EC0557A}
+		{2BE46397-4DFA-414C-9BD4-41E4BBF8CB34} = {2BE46397-4DFA-414C-9BD4-41E4BBF8CB34}
+		{A7D5099E-F0FD-4BF3-8522-5A682759F915} = {A7D5099E-F0FD-4BF3-8522-5A682759F915}
+		{0B43679E-EDFA-4DA0-AD30-F4628B308B1B} = {0B43679E-EDFA-4DA0-AD30-F4628B308B1B}
+		{B25AC7A5-FB9F-4789-B392-D5C85E948670} = {B25AC7A5-FB9F-4789-B392-D5C85E948670}
+		{E4E0D2AE-B17D-4BD4-8BEE-AFC8CC464C5F} = {E4E0D2AE-B17D-4BD4-8BEE-AFC8CC464C5F}
+		{AF2349B8-E5B6-4004-9502-687C1C7730B1} = {AF2349B8-E5B6-4004-9502-687C1C7730B1}
 		{A46629C4-1A6C-40FA-A8B6-10E5102BB0BA} = {A46629C4-1A6C-40FA-A8B6-10E5102BB0BA}
+		{17DA04DF-E393-4397-9CF0-84DABE11032E} = {17DA04DF-E393-4397-9CF0-84DABE11032E}
+		{F9C68EDF-AC74-4B77-9AF1-005D9C9F6A99} = {F9C68EDF-AC74-4B77-9AF1-005D9C9F6A99}
 		{07C389E3-6BC8-41CF-923E-307B1265FA2D} = {07C389E3-6BC8-41CF-923E-307B1265FA2D}
+		{89F34AF7-1C34-4A72-AA6E-534BCF972BD9} = {89F34AF7-1C34-4A72-AA6E-534BCF972BD9}
+		{E6410BFC-B341-498C-8C67-312C20CDD8D5} = {E6410BFC-B341-498C-8C67-312C20CDD8D5}
 	EndProjectSection
 EndProject
 Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "common", "src\common\common.vcxproj", "{74485049-C722-400F-ABE5-86AC52D929B3}"
 EndProject
-Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "shortcut_guide", "src\modules\shortcut_guide\shortcut_guide.vcxproj", "{A46629C4-1A6C-40FA-A8B6-10E5102BB0BA}"
-EndProject
-Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "example_powertoy", "src\modules\example_powertoy\example_powertoy.vcxproj", "{44CC9375-3E6E-4D99-8913-7FB748807EBD}"
+Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "ShortcutGuide", "src\modules\shortcut_guide\shortcut_guide.vcxproj", "{A46629C4-1A6C-40FA-A8B6-10E5102BB0BA}"
+	ProjectSection(ProjectDependencies) = postProject
+		{74485049-C722-400F-ABE5-86AC52D929B3} = {74485049-C722-400F-ABE5-86AC52D929B3}
+	EndProjectSection
 EndProject
 Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "modules", "modules", "{4574FDD0-F61D-4376-98BF-E5A1262C11EC}"
 EndProject
@@ -23,6 +45,7 @@ Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "interface", "interface", "{
 	ProjectSection(SolutionItems) = preProject
 		src\modules\interface\lowlevel_keyboard_event_data.h = src\modules\interface\lowlevel_keyboard_event_data.h
 		src\modules\interface\powertoy_module_interface.h = src\modules\interface\powertoy_module_interface.h
+		src\modules\interface\powertoy_system_menu.h = src\modules\interface\powertoy_system_menu.h
 		src\modules\interface\win_hook_event_data.h = src\modules\interface\win_hook_event_data.h
 	EndProjectSection
 EndProject
@@ -31,21 +54,28 @@ EndProject
 Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "fancyzones", "fancyzones", "{D1D6BC88-09AE-4FB4-AD24-5DED46A791DD}"
 EndProject
 Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "FancyZonesLib", "src\modules\fancyzones\lib\FancyZonesLib.vcxproj", "{F9C68EDF-AC74-4B77-9AF1-005D9C9F6A99}"
+	ProjectSection(ProjectDependencies) = postProject
+		{74485049-C722-400F-ABE5-86AC52D929B3} = {74485049-C722-400F-ABE5-86AC52D929B3}
+	EndProjectSection
 EndProject
 Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "fancyzones", "src\modules\fancyzones\dll\FancyZonesModule.vcxproj", "{48804216-2A0E-4168-A6D8-9CD068D14227}"
 	ProjectSection(ProjectDependencies) = postProject
+		{74485049-C722-400F-ABE5-86AC52D929B3} = {74485049-C722-400F-ABE5-86AC52D929B3}
 		{5CCC8468-DEC8-4D36-99D4-5C891BEBD481} = {5CCC8468-DEC8-4D36-99D4-5C891BEBD481}
 	EndProjectSection
 EndProject
 Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "UnitTests-FancyZones", "src\modules\fancyzones\tests\UnitTests\UnitTests.vcxproj", "{9C6A7905-72D4-4BF5-B256-ABFDAEF68AE9}"
-EndProject
-Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "cpprestsdk", "deps\cpprestsdk\cpprestsdk.vcxproj", "{4E577735-DFAB-41AF-8A6E-B6E8872A2928}"
-EndProject
-Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "deps", "deps", "{1FAF749F-0D6F-4BF5-A563-31A4B5279D27}"
+	ProjectSection(ProjectDependencies) = postProject
+		{74485049-C722-400F-ABE5-86AC52D929B3} = {74485049-C722-400F-ABE5-86AC52D929B3}
+		{F9C68EDF-AC74-4B77-9AF1-005D9C9F6A99} = {F9C68EDF-AC74-4B77-9AF1-005D9C9F6A99}
+	EndProjectSection
 EndProject
 Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "common", "common", "{1AFB6476-670D-4E80-A464-657E01DFF482}"
 EndProject
 Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "UnitTests-CommonLib", "src\common\UnitTests-CommonLib\UnitTests-CommonLib.vcxproj", "{1A066C63-64B3-45F8-92FE-664E1CCE8077}"
+	ProjectSection(ProjectDependencies) = postProject
+		{74485049-C722-400F-ABE5-86AC52D929B3} = {74485049-C722-400F-ABE5-86AC52D929B3}
+	EndProjectSection
 EndProject
 Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "FancyZonesEditor", "src\modules\fancyzones\editor\FancyZonesEditor\FancyZonesEditor.csproj", "{5CCC8468-DEC8-4D36-99D4-5C891BEBD481}"
 EndProject
@@ -55,6 +85,7 @@ Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "PowerRenameExt", "src\modul
 	ProjectSection(ProjectDependencies) = postProject
 		{0E072714-D127-460B-AFAD-B4C40B412798} = {0E072714-D127-460B-AFAD-B4C40B412798}
 		{51920F1F-C28C-4ADF-8660-4238766796C2} = {51920F1F-C28C-4ADF-8660-4238766796C2}
+		{74485049-C722-400F-ABE5-86AC52D929B3} = {74485049-C722-400F-ABE5-86AC52D929B3}
 	EndProjectSection
 EndProject
 Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "PowerRenameLib", "src\modules\powerrename\lib\PowerRenameLib.vcxproj", "{51920F1F-C28C-4ADF-8660-4238766796C2}"
@@ -68,15 +99,164 @@ Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "PowerRenameTest", "src\modu
 	ProjectSection(ProjectDependencies) = postProject
 		{0E072714-D127-460B-AFAD-B4C40B412798} = {0E072714-D127-460B-AFAD-B4C40B412798}
 		{51920F1F-C28C-4ADF-8660-4238766796C2} = {51920F1F-C28C-4ADF-8660-4238766796C2}
+		{74485049-C722-400F-ABE5-86AC52D929B3} = {74485049-C722-400F-ABE5-86AC52D929B3}
 	EndProjectSection
 EndProject
 Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "PowerRenameUnitTests", "src\modules\powerrename\unittests\PowerRenameLibUnitTests.vcxproj", "{2151F984-E006-4A9F-92EF-C6DDE3DC8413}"
 	ProjectSection(ProjectDependencies) = postProject
 		{0E072714-D127-460B-AFAD-B4C40B412798} = {0E072714-D127-460B-AFAD-B4C40B412798}
 		{51920F1F-C28C-4ADF-8660-4238766796C2} = {51920F1F-C28C-4ADF-8660-4238766796C2}
+		{74485049-C722-400F-ABE5-86AC52D929B3} = {74485049-C722-400F-ABE5-86AC52D929B3}
 		{B25AC7A5-FB9F-4789-B392-D5C85E948670} = {B25AC7A5-FB9F-4789-B392-D5C85E948670}
 	EndProjectSection
 EndProject
+Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "examples", "examples", "{BEEAB7F2-FFF6-45AB-9CDB-B04CC0734B88}"
+EndProject
+Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "ModuleTemplateCompileTest", "tools\project_template\ModuleTemplate\ModuleTemplateCompileTest.vcxproj", "{64A80062-4D8B-4229-8A38-DFA1D7497749}"
+	ProjectSection(ProjectDependencies) = postProject
+		{74485049-C722-400F-ABE5-86AC52D929B3} = {74485049-C722-400F-ABE5-86AC52D929B3}
+	EndProjectSection
+EndProject
+Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "PowerRenameUWPUI", "src\modules\powerrename\UWPui\PowerRenameUWPUI.vcxproj", "{0485F45C-EA7A-4BB5-804B-3E8D14699387}"
+	ProjectSection(ProjectDependencies) = postProject
+		{0E072714-D127-460B-AFAD-B4C40B412798} = {0E072714-D127-460B-AFAD-B4C40B412798}
+		{74485049-C722-400F-ABE5-86AC52D929B3} = {74485049-C722-400F-ABE5-86AC52D929B3}
+	EndProjectSection
+EndProject
+Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "notifications", "src\common\notifications_winrt\notifications.vcxproj", "{0B593A6C-4143-4337-860E-DB5710FB87DB}"
+	ProjectSection(ProjectDependencies) = postProject
+		{74485049-C722-400F-ABE5-86AC52D929B3} = {74485049-C722-400F-ABE5-86AC52D929B3}
+	EndProjectSection
+EndProject
+Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "notifications_dll", "src\common\notifications\notifications_dll.vcxproj", "{031AC72E-FA28-4AB7-B690-6F7B9C28AA73}"
+	ProjectSection(ProjectDependencies) = postProject
+		{74485049-C722-400F-ABE5-86AC52D929B3} = {74485049-C722-400F-ABE5-86AC52D929B3}
+		{0B593A6C-4143-4337-860E-DB5710FB87DB} = {0B593A6C-4143-4337-860E-DB5710FB87DB}
+	EndProjectSection
+EndProject
+Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "KeyboardManager", "src\modules\keyboardmanager\dll\KeyboardManager.vcxproj", "{89F34AF7-1C34-4A72-AA6E-534BCF972BD9}"
+EndProject
+Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "imageresizer", "imageresizer", "{6C7F47CC-2151-44A3-A546-41C70025132C}"
+EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "ImageResizerUI", "src\modules\imageresizer\ui\ImageResizerUI.csproj", "{2BE46397-4DFA-414C-9BD4-41E4BBF8CB34}"
+EndProject
+Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "ImageResizerExt", "src\modules\imageresizer\dll\ImageResizerExt.vcxproj", "{0B43679E-EDFA-4DA0-AD30-F4628B308B1B}"
+EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "ImageResizerUITest", "src\modules\imageresizer\tests\ImageResizerUITest.csproj", "{E0CC7526-D85E-43AC-844F-D5DF0D2F5AB8}"
+EndProject
+Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "KeyboardManagerUI", "src\modules\keyboardmanager\ui\KeyboardManagerUI.vcxproj", "{EAF23649-EF6E-478B-980E-81FAD96CCA2A}"
+EndProject
+Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "action_runner", "src\action_runner\action_runner.vcxproj", "{D29DDD63-E2CF-4657-9FD5-2AEDE4257E5D}"
+	ProjectSection(ProjectDependencies) = postProject
+		{17DA04DF-E393-4397-9CF0-84DABE11032E} = {17DA04DF-E393-4397-9CF0-84DABE11032E}
+	EndProjectSection
+EndProject
+Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "updating", "src\common\updating\updating.vcxproj", "{17DA04DF-E393-4397-9CF0-84DABE11032E}"
+EndProject
+Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "keyboardmanager", "keyboardmanager", "{38BDB927-829B-4C65-9CD9-93FB05D66D65}"
+EndProject
+Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "KeyboardManagerCommon", "src\modules\keyboardmanager\common\KeyboardManagerCommon.vcxproj", "{8AFFA899-0B73-49EC-8C50-0FADDA57B2FC}"
+EndProject
+Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "launcher", "launcher", "{C140A3EF-6DBF-4084-9D4C-4EB5A99FEE68}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Wox", "src\modules\launcher\Wox\Wox.csproj", "{DB90F671-D861-46BB-93A3-F1304F5BA1C5}"
+	ProjectSection(ProjectDependencies) = postProject
+		{FDB3555B-58EF-4AE6-B5F1-904719637AB4} = {FDB3555B-58EF-4AE6-B5F1-904719637AB4}
+		{59BD9891-3837-438A-958D-ADC7F91F6F7E} = {59BD9891-3837-438A-958D-ADC7F91F6F7E}
+		{C21BFF9C-2C99-4B5F-B7C9-A5E6DDDB37B0} = {C21BFF9C-2C99-4B5F-B7C9-A5E6DDDB37B0}
+		{787B8AA6-CA93-4C84-96FE-DF31110AD1C4} = {787B8AA6-CA93-4C84-96FE-DF31110AD1C4}
+		{F8B870EB-D5F5-45BA-9CF7-A5C459818820} = {F8B870EB-D5F5-45BA-9CF7-A5C459818820}
+		{74F1B9ED-F59C-4FE7-B473-7B453E30837E} = {74F1B9ED-F59C-4FE7-B473-7B453E30837E}
+	EndProjectSection
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Wox.Core", "src\modules\launcher\Wox.Core\Wox.Core.csproj", "{B749F0DB-8E75-47DB-9E5E-265D16D0C0D2}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Wox.Infrastructure", "src\modules\launcher\Wox.Infrastructure\Wox.Infrastructure.csproj", "{4FD29318-A8AB-4D8F-AA47-60BC241B8DA3}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Wox.Plugin", "src\modules\launcher\Wox.Plugin\Wox.Plugin.csproj", "{8451ECDD-2EA4-4966-BB0A-7BBC40138E80}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Wox.Test", "src\modules\launcher\Wox.Test\Wox.Test.csproj", "{FF742965-9A80-41A5-B042-D6C7D3A21708}"
+EndProject
+Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Plugins", "Plugins", "{4AFC9975-2456-4C70-94A4-84073C1CED93}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Microsoft.Plugin.Calculator", "src\modules\launcher\Plugins\Microsoft.Plugin.Calculator\Microsoft.Plugin.Calculator.csproj", "{59BD9891-3837-438A-958D-ADC7F91F6F7E}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Microsoft.Plugin.WindowWalker", "src\modules\launcher\Plugins\Microsoft.Plugin.WindowWalker\Microsoft.Plugin.WindowWalker.csproj", "{74F1B9ED-F59C-4FE7-B473-7B453E30837E}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Microsoft.Plugin.Program", "src\modules\launcher\Plugins\Microsoft.Plugin.Program\Microsoft.Plugin.Program.csproj", "{FDB3555B-58EF-4AE6-B5F1-904719637AB4}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Microsoft.Plugin.Shell", "src\modules\launcher\Plugins\Microsoft.Plugin.Shell\Microsoft.Plugin.Shell.csproj", "{C21BFF9C-2C99-4B5F-B7C9-A5E6DDDB37B0}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Microsoft.Plugin.Indexer", "src\modules\launcher\Plugins\Microsoft.Plugin.Indexer\Microsoft.Plugin.Indexer.csproj", "{F8B870EB-D5F5-45BA-9CF7-A5C459818820}"
+	ProjectSection(ProjectDependencies) = postProject
+		{8451ECDD-2EA4-4966-BB0A-7BBC40138E80} = {8451ECDD-2EA4-4966-BB0A-7BBC40138E80}
+	EndProjectSection
+EndProject
+Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "Microsoft.Launcher", "src\modules\launcher\Microsoft.Launcher\Microsoft.Launcher.vcxproj", "{E364F67B-BB12-4E91-B639-355866EBCD8B}"
+	ProjectSection(ProjectDependencies) = postProject
+		{F97E5003-F263-4D4A-A964-0F1F3C82DEF2} = {F97E5003-F263-4D4A-A964-0F1F3C82DEF2}
+	EndProjectSection
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "PowerLauncher", "src\modules\launcher\PowerLauncher\PowerLauncher.csproj", "{F97E5003-F263-4D4A-A964-0F1F3C82DEF2}"
+EndProject
+Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "tests", "tests", "{E775CC2C-24CB-48D6-9C3A-BE4CCE0DB17A}"
+EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "win-app-driver", "src\tests\win-app-driver\win-app-driver.csproj", "{880ED251-9E16-4713-9A70-D35FE0C01669}"
+EndProject
+Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "previewpane", "previewpane", "{2F305555-C296-497E-AC20-5FA1B237996A}"
+EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "PreviewHandlerCommon", "src\modules\previewpane\Common\PreviewHandlerCommon.csproj", "{AF2349B8-E5B6-4004-9502-687C1C7730B1}"
+EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "MarkdownPreviewHandler", "src\modules\previewpane\MarkDownPreviewHandler\MarkdownPreviewHandler.csproj", "{6A71162E-FC4C-4A2C-B90F-3CF94F59A9BB}"
+EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "UnitTests-MarkdownPreviewHandler", "src\modules\previewpane\PreviewPaneUnitTests\UnitTests-MarkdownPreviewHandler.csproj", "{A2B51B8B-8F90-424E-BC97-F9AB7D76CA1A}"
+EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "SvgPreviewHandler", "src\modules\previewpane\SvgPreviewHandler\SvgPreviewHandler.csproj", "{DA425894-6E13-404F-8DCB-78584EC0557A}"
+EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "UnitTests-SvgPreviewHandler", "src\modules\previewpane\UnitTests-SvgPreviewHandler\UnitTests-SvgPreviewHandler.csproj", "{060D75DA-2D1C-48E6-A4A1-6F0718B64661}"
+EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "UnitTests-PreviewHandlerCommon", "src\modules\previewpane\UnitTests-PreviewHandlerCommon\UnitTests-PreviewHandlerCommon.csproj", "{748417CA-F17E-487F-9411-CAFB6D3F4877}"
+EndProject
+Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "powerpreview", "src\modules\previewpane\powerpreview\powerpreview.vcxproj", "{217DF501-135C-4E38-BFC8-99D4821032EA}"
+EndProject
+Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "powerpreviewTest", "src\modules\previewpane\powerpreviewTest\powerpreviewTest.vcxproj", "{47310AB4-9034-4BD1-8D8B-E88AD21A171B}"
+EndProject
+Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "core", "core", "{C3081D9A-1586-441A-B5F4-ED815B3719C1}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Microsoft.PowerToys.Settings.UI.Runner", "src\core\Microsoft.PowerToys.Settings.UI.Runner\Microsoft.PowerToys.Settings.UI.Runner.csproj", "{E4E0D2AE-B17D-4BD4-8BEE-AFC8CC464C5F}"
+EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Microsoft.PowerToys.Settings.UI", "src\core\Microsoft.PowerToys.Settings.UI\Microsoft.PowerToys.Settings.UI.csproj", "{A7D5099E-F0FD-4BF3-8522-5A682759F915}"
+EndProject
+Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Solution Items", "Solution Items", "{4981CCD1-4CD9-4A49-B240-00AA46493FF8}"
+	ProjectSection(SolutionItems) = preProject
+		src\.editorconfig = src\.editorconfig
+		src\tests\win-app-driver\packages.config = src\tests\win-app-driver\packages.config
+	EndProjectSection
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Microsoft.PowerToys.Settings.UI.Lib", "src\core\Microsoft.PowerToys.Settings.UI.Lib\Microsoft.PowerToys.Settings.UI.Lib.csproj", "{B1BCC8C6-46B5-4BFA-8F22-20F32D99EC6A}"
+EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Microsoft.PowerToys.Settings.UnitTest", "src\core\Microsoft.PowerToys.Settings.UnitTest\Microsoft.PowerToys.Settings.UnitTest.csproj", "{A80355C2-780D-4245-BD80-25B8DE698EE3}"
+EndProject
+Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "interop", "src\common\interop\interop.vcxproj", "{F055103B-F80B-4D0C-BF48-057C55620033}"
+EndProject
+Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "common-md-flag", "src\common\common-md-flag\common-md-flag.vcxproj", "{985B3F2F-CEED-4C0A-A249-69257E719145}"
+EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "interop-tests", "src\common\interop-tests\interop-tests.csproj", "{437AD818-3F1F-4CA5-A79B-25233A157026}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Microsoft.Plugin.Folder", "src\modules\launcher\Plugins\Microsoft.Plugin.Folder\Microsoft.Plugin.Folder.csproj", "{787B8AA6-CA93-4C84-96FE-DF31110AD1C4}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "PowerLauncher.Telemetry", "src\modules\launcher\PowerLauncher.Telemetry\PowerLauncher.Telemetry.csproj", "{08C8C05F-0362-41BC-818C-724572DF8B06}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Telemetry", "src\common\ManagedTelemetry\Telemetry\Telemetry.csproj", "{5D00D290-4016-4CFE-9E41-1E7C724509BA}"
+EndProject
+Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "os-detection", "src\common\os-detection\os-detection.vcxproj", "{E6410BFC-B341-498C-8C67-312C20CDD8D5}"
+EndProject
+Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "KeyboardManagerTest", "src\modules\keyboardmanager\test\KeyboardManagerTest.vcxproj", "{62173D9A-6724-4C00-A1C8-FB646480A9EC}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "ManagedCommon", "src\common\ManagedCommon\ManagedCommon.csproj", "{4AED67B6-55FD-486F-B917-E543DEE2CB3C}"
+EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Microsoft.Plugin.Program.UnitTests", "src\modules\launcher\Plugins\Microsoft.Plugin.Program.UnitTests\Microsoft.Plugin.Program.UnitTests.csproj", "{42851751-CBC8-45A6-97F5-7A0753F7B4D1}"
+EndProject
 Global
 	GlobalSection(SolutionConfigurationPlatforms) = preSolution
 		Debug|x64 = Debug|x64
@@ -95,8 +275,6 @@ Global
 		{A46629C4-1A6C-40FA-A8B6-10E5102BB0BA}.Debug|x64.Build.0 = Debug|x64
 		{A46629C4-1A6C-40FA-A8B6-10E5102BB0BA}.Release|x64.ActiveCfg = Release|x64
 		{A46629C4-1A6C-40FA-A8B6-10E5102BB0BA}.Release|x64.Build.0 = Release|x64
-		{44CC9375-3E6E-4D99-8913-7FB748807EBD}.Debug|x64.ActiveCfg = Debug|x64
-		{44CC9375-3E6E-4D99-8913-7FB748807EBD}.Release|x64.ActiveCfg = Release|x64
 		{07C389E3-6BC8-41CF-923E-307B1265FA2D}.Debug|x64.ActiveCfg = Debug|x64
 		{07C389E3-6BC8-41CF-923E-307B1265FA2D}.Debug|x64.Build.0 = Debug|x64
 		{07C389E3-6BC8-41CF-923E-307B1265FA2D}.Release|x64.ActiveCfg = Release|x64
@@ -113,10 +291,6 @@ Global
 		{9C6A7905-72D4-4BF5-B256-ABFDAEF68AE9}.Debug|x64.Build.0 = Debug|x64
 		{9C6A7905-72D4-4BF5-B256-ABFDAEF68AE9}.Release|x64.ActiveCfg = Release|x64
 		{9C6A7905-72D4-4BF5-B256-ABFDAEF68AE9}.Release|x64.Build.0 = Release|x64
-		{4E577735-DFAB-41AF-8A6E-B6E8872A2928}.Debug|x64.ActiveCfg = Debug|x64
-		{4E577735-DFAB-41AF-8A6E-B6E8872A2928}.Debug|x64.Build.0 = Debug|x64
-		{4E577735-DFAB-41AF-8A6E-B6E8872A2928}.Release|x64.ActiveCfg = Release|x64
-		{4E577735-DFAB-41AF-8A6E-B6E8872A2928}.Release|x64.Build.0 = Release|x64
 		{1A066C63-64B3-45F8-92FE-664E1CCE8077}.Debug|x64.ActiveCfg = Debug|x64
 		{1A066C63-64B3-45F8-92FE-664E1CCE8077}.Debug|x64.Build.0 = Debug|x64
 		{1A066C63-64B3-45F8-92FE-664E1CCE8077}.Release|x64.ActiveCfg = Release|x64
@@ -145,6 +319,194 @@ Global
 		{2151F984-E006-4A9F-92EF-C6DDE3DC8413}.Debug|x64.Build.0 = Debug|x64
 		{2151F984-E006-4A9F-92EF-C6DDE3DC8413}.Release|x64.ActiveCfg = Release|x64
 		{2151F984-E006-4A9F-92EF-C6DDE3DC8413}.Release|x64.Build.0 = Release|x64
+		{64A80062-4D8B-4229-8A38-DFA1D7497749}.Debug|x64.ActiveCfg = Debug|x64
+		{64A80062-4D8B-4229-8A38-DFA1D7497749}.Debug|x64.Build.0 = Debug|x64
+		{64A80062-4D8B-4229-8A38-DFA1D7497749}.Release|x64.ActiveCfg = Release|x64
+		{64A80062-4D8B-4229-8A38-DFA1D7497749}.Release|x64.Build.0 = Release|x64
+		{0485F45C-EA7A-4BB5-804B-3E8D14699387}.Debug|x64.ActiveCfg = Debug|x64
+		{0485F45C-EA7A-4BB5-804B-3E8D14699387}.Debug|x64.Build.0 = Debug|x64
+		{0485F45C-EA7A-4BB5-804B-3E8D14699387}.Release|x64.ActiveCfg = Release|x64
+		{0485F45C-EA7A-4BB5-804B-3E8D14699387}.Release|x64.Build.0 = Release|x64
+		{0B593A6C-4143-4337-860E-DB5710FB87DB}.Debug|x64.ActiveCfg = Debug|x64
+		{0B593A6C-4143-4337-860E-DB5710FB87DB}.Debug|x64.Build.0 = Debug|x64
+		{0B593A6C-4143-4337-860E-DB5710FB87DB}.Release|x64.ActiveCfg = Release|x64
+		{0B593A6C-4143-4337-860E-DB5710FB87DB}.Release|x64.Build.0 = Release|x64
+		{031AC72E-FA28-4AB7-B690-6F7B9C28AA73}.Debug|x64.ActiveCfg = Debug|x64
+		{031AC72E-FA28-4AB7-B690-6F7B9C28AA73}.Debug|x64.Build.0 = Debug|x64
+		{031AC72E-FA28-4AB7-B690-6F7B9C28AA73}.Release|x64.ActiveCfg = Release|x64
+		{031AC72E-FA28-4AB7-B690-6F7B9C28AA73}.Release|x64.Build.0 = Release|x64
+		{89F34AF7-1C34-4A72-AA6E-534BCF972BD9}.Debug|x64.ActiveCfg = Debug|x64
+		{89F34AF7-1C34-4A72-AA6E-534BCF972BD9}.Debug|x64.Build.0 = Debug|x64
+		{89F34AF7-1C34-4A72-AA6E-534BCF972BD9}.Release|x64.ActiveCfg = Release|x64
+		{89F34AF7-1C34-4A72-AA6E-534BCF972BD9}.Release|x64.Build.0 = Release|x64
+		{2BE46397-4DFA-414C-9BD4-41E4BBF8CB34}.Debug|x64.ActiveCfg = Debug|x64
+		{2BE46397-4DFA-414C-9BD4-41E4BBF8CB34}.Debug|x64.Build.0 = Debug|x64
+		{2BE46397-4DFA-414C-9BD4-41E4BBF8CB34}.Release|x64.ActiveCfg = Release|x64
+		{2BE46397-4DFA-414C-9BD4-41E4BBF8CB34}.Release|x64.Build.0 = Release|x64
+		{0B43679E-EDFA-4DA0-AD30-F4628B308B1B}.Debug|x64.ActiveCfg = Debug|x64
+		{0B43679E-EDFA-4DA0-AD30-F4628B308B1B}.Debug|x64.Build.0 = Debug|x64
+		{0B43679E-EDFA-4DA0-AD30-F4628B308B1B}.Release|x64.ActiveCfg = Release|x64
+		{0B43679E-EDFA-4DA0-AD30-F4628B308B1B}.Release|x64.Build.0 = Release|x64
+		{E0CC7526-D85E-43AC-844F-D5DF0D2F5AB8}.Debug|x64.ActiveCfg = Debug|x64
+		{E0CC7526-D85E-43AC-844F-D5DF0D2F5AB8}.Debug|x64.Build.0 = Debug|x64
+		{E0CC7526-D85E-43AC-844F-D5DF0D2F5AB8}.Release|x64.ActiveCfg = Release|x64
+		{E0CC7526-D85E-43AC-844F-D5DF0D2F5AB8}.Release|x64.Build.0 = Release|x64
+		{EAF23649-EF6E-478B-980E-81FAD96CCA2A}.Debug|x64.ActiveCfg = Debug|x64
+		{EAF23649-EF6E-478B-980E-81FAD96CCA2A}.Debug|x64.Build.0 = Debug|x64
+		{EAF23649-EF6E-478B-980E-81FAD96CCA2A}.Release|x64.ActiveCfg = Release|x64
+		{EAF23649-EF6E-478B-980E-81FAD96CCA2A}.Release|x64.Build.0 = Release|x64
+		{D29DDD63-E2CF-4657-9FD5-2AEDE4257E5D}.Debug|x64.ActiveCfg = Debug|x64
+		{D29DDD63-E2CF-4657-9FD5-2AEDE4257E5D}.Debug|x64.Build.0 = Debug|x64
+		{D29DDD63-E2CF-4657-9FD5-2AEDE4257E5D}.Release|x64.ActiveCfg = Release|x64
+		{D29DDD63-E2CF-4657-9FD5-2AEDE4257E5D}.Release|x64.Build.0 = Release|x64
+		{17DA04DF-E393-4397-9CF0-84DABE11032E}.Debug|x64.ActiveCfg = Debug|x64
+		{17DA04DF-E393-4397-9CF0-84DABE11032E}.Debug|x64.Build.0 = Debug|x64
+		{17DA04DF-E393-4397-9CF0-84DABE11032E}.Release|x64.ActiveCfg = Release|x64
+		{17DA04DF-E393-4397-9CF0-84DABE11032E}.Release|x64.Build.0 = Release|x64
+		{8AFFA899-0B73-49EC-8C50-0FADDA57B2FC}.Debug|x64.ActiveCfg = Debug|x64
+		{8AFFA899-0B73-49EC-8C50-0FADDA57B2FC}.Debug|x64.Build.0 = Debug|x64
+		{8AFFA899-0B73-49EC-8C50-0FADDA57B2FC}.Release|x64.ActiveCfg = Release|x64
+		{8AFFA899-0B73-49EC-8C50-0FADDA57B2FC}.Release|x64.Build.0 = Release|x64
+		{DB90F671-D861-46BB-93A3-F1304F5BA1C5}.Debug|x64.ActiveCfg = Debug|x64
+		{DB90F671-D861-46BB-93A3-F1304F5BA1C5}.Debug|x64.Build.0 = Debug|x64
+		{DB90F671-D861-46BB-93A3-F1304F5BA1C5}.Release|x64.ActiveCfg = Release|x64
+		{DB90F671-D861-46BB-93A3-F1304F5BA1C5}.Release|x64.Build.0 = Release|x64
+		{B749F0DB-8E75-47DB-9E5E-265D16D0C0D2}.Debug|x64.ActiveCfg = Debug|x64
+		{B749F0DB-8E75-47DB-9E5E-265D16D0C0D2}.Debug|x64.Build.0 = Debug|x64
+		{B749F0DB-8E75-47DB-9E5E-265D16D0C0D2}.Release|x64.ActiveCfg = Release|x64
+		{B749F0DB-8E75-47DB-9E5E-265D16D0C0D2}.Release|x64.Build.0 = Release|x64
+		{4FD29318-A8AB-4D8F-AA47-60BC241B8DA3}.Debug|x64.ActiveCfg = Debug|x64
+		{4FD29318-A8AB-4D8F-AA47-60BC241B8DA3}.Debug|x64.Build.0 = Debug|x64
+		{4FD29318-A8AB-4D8F-AA47-60BC241B8DA3}.Release|x64.ActiveCfg = Release|x64
+		{4FD29318-A8AB-4D8F-AA47-60BC241B8DA3}.Release|x64.Build.0 = Release|x64
+		{8451ECDD-2EA4-4966-BB0A-7BBC40138E80}.Debug|x64.ActiveCfg = Debug|x64
+		{8451ECDD-2EA4-4966-BB0A-7BBC40138E80}.Debug|x64.Build.0 = Debug|x64
+		{8451ECDD-2EA4-4966-BB0A-7BBC40138E80}.Release|x64.ActiveCfg = Release|x64
+		{8451ECDD-2EA4-4966-BB0A-7BBC40138E80}.Release|x64.Build.0 = Release|x64
+		{FF742965-9A80-41A5-B042-D6C7D3A21708}.Debug|x64.ActiveCfg = Debug|x64
+		{FF742965-9A80-41A5-B042-D6C7D3A21708}.Debug|x64.Build.0 = Debug|x64
+		{FF742965-9A80-41A5-B042-D6C7D3A21708}.Release|x64.ActiveCfg = Release|x64
+		{FF742965-9A80-41A5-B042-D6C7D3A21708}.Release|x64.Build.0 = Release|x64
+		{59BD9891-3837-438A-958D-ADC7F91F6F7E}.Debug|x64.ActiveCfg = Debug|x64
+		{59BD9891-3837-438A-958D-ADC7F91F6F7E}.Debug|x64.Build.0 = Debug|x64
+		{59BD9891-3837-438A-958D-ADC7F91F6F7E}.Release|x64.ActiveCfg = Release|x64
+		{59BD9891-3837-438A-958D-ADC7F91F6F7E}.Release|x64.Build.0 = Release|x64
+		{74F1B9ED-F59C-4FE7-B473-7B453E30837E}.Debug|x64.ActiveCfg = Debug|x64
+		{74F1B9ED-F59C-4FE7-B473-7B453E30837E}.Debug|x64.Build.0 = Debug|x64
+		{74F1B9ED-F59C-4FE7-B473-7B453E30837E}.Release|x64.ActiveCfg = Release|x64
+		{74F1B9ED-F59C-4FE7-B473-7B453E30837E}.Release|x64.Build.0 = Release|x64
+		{FDB3555B-58EF-4AE6-B5F1-904719637AB4}.Debug|x64.ActiveCfg = Debug|x64
+		{FDB3555B-58EF-4AE6-B5F1-904719637AB4}.Debug|x64.Build.0 = Debug|x64
+		{FDB3555B-58EF-4AE6-B5F1-904719637AB4}.Release|x64.ActiveCfg = Release|x64
+		{FDB3555B-58EF-4AE6-B5F1-904719637AB4}.Release|x64.Build.0 = Release|x64
+		{C21BFF9C-2C99-4B5F-B7C9-A5E6DDDB37B0}.Debug|x64.ActiveCfg = Debug|x64
+		{C21BFF9C-2C99-4B5F-B7C9-A5E6DDDB37B0}.Debug|x64.Build.0 = Debug|x64
+		{C21BFF9C-2C99-4B5F-B7C9-A5E6DDDB37B0}.Release|x64.ActiveCfg = Release|x64
+		{C21BFF9C-2C99-4B5F-B7C9-A5E6DDDB37B0}.Release|x64.Build.0 = Release|x64
+		{F8B870EB-D5F5-45BA-9CF7-A5C459818820}.Debug|x64.ActiveCfg = Debug|x64
+		{F8B870EB-D5F5-45BA-9CF7-A5C459818820}.Debug|x64.Build.0 = Debug|x64
+		{F8B870EB-D5F5-45BA-9CF7-A5C459818820}.Release|x64.ActiveCfg = Release|x64
+		{F8B870EB-D5F5-45BA-9CF7-A5C459818820}.Release|x64.Build.0 = Release|x64
+		{E364F67B-BB12-4E91-B639-355866EBCD8B}.Debug|x64.ActiveCfg = Debug|x64
+		{E364F67B-BB12-4E91-B639-355866EBCD8B}.Debug|x64.Build.0 = Debug|x64
+		{E364F67B-BB12-4E91-B639-355866EBCD8B}.Release|x64.ActiveCfg = Release|x64
+		{E364F67B-BB12-4E91-B639-355866EBCD8B}.Release|x64.Build.0 = Release|x64
+		{F97E5003-F263-4D4A-A964-0F1F3C82DEF2}.Debug|x64.ActiveCfg = Debug|x64
+		{F97E5003-F263-4D4A-A964-0F1F3C82DEF2}.Debug|x64.Build.0 = Debug|x64
+		{F97E5003-F263-4D4A-A964-0F1F3C82DEF2}.Release|x64.ActiveCfg = Release|x64
+		{F97E5003-F263-4D4A-A964-0F1F3C82DEF2}.Release|x64.Build.0 = Release|x64
+		{880ED251-9E16-4713-9A70-D35FE0C01669}.Debug|x64.ActiveCfg = Debug|x64
+		{880ED251-9E16-4713-9A70-D35FE0C01669}.Debug|x64.Build.0 = Debug|x64
+		{880ED251-9E16-4713-9A70-D35FE0C01669}.Release|x64.ActiveCfg = Release|x64
+		{880ED251-9E16-4713-9A70-D35FE0C01669}.Release|x64.Build.0 = Release|x64
+		{AF2349B8-E5B6-4004-9502-687C1C7730B1}.Debug|x64.ActiveCfg = Debug|x64
+		{AF2349B8-E5B6-4004-9502-687C1C7730B1}.Debug|x64.Build.0 = Debug|x64
+		{AF2349B8-E5B6-4004-9502-687C1C7730B1}.Release|x64.ActiveCfg = Release|x64
+		{AF2349B8-E5B6-4004-9502-687C1C7730B1}.Release|x64.Build.0 = Release|x64
+		{6A71162E-FC4C-4A2C-B90F-3CF94F59A9BB}.Debug|x64.ActiveCfg = Debug|x64
+		{6A71162E-FC4C-4A2C-B90F-3CF94F59A9BB}.Debug|x64.Build.0 = Debug|x64
+		{6A71162E-FC4C-4A2C-B90F-3CF94F59A9BB}.Release|x64.ActiveCfg = Release|x64
+		{6A71162E-FC4C-4A2C-B90F-3CF94F59A9BB}.Release|x64.Build.0 = Release|x64
+		{A2B51B8B-8F90-424E-BC97-F9AB7D76CA1A}.Debug|x64.ActiveCfg = Debug|x64
+		{A2B51B8B-8F90-424E-BC97-F9AB7D76CA1A}.Debug|x64.Build.0 = Debug|x64
+		{A2B51B8B-8F90-424E-BC97-F9AB7D76CA1A}.Release|x64.ActiveCfg = Release|x64
+		{A2B51B8B-8F90-424E-BC97-F9AB7D76CA1A}.Release|x64.Build.0 = Release|x64
+		{DA425894-6E13-404F-8DCB-78584EC0557A}.Debug|x64.ActiveCfg = Debug|x64
+		{DA425894-6E13-404F-8DCB-78584EC0557A}.Debug|x64.Build.0 = Debug|x64
+		{DA425894-6E13-404F-8DCB-78584EC0557A}.Release|x64.ActiveCfg = Release|x64
+		{DA425894-6E13-404F-8DCB-78584EC0557A}.Release|x64.Build.0 = Release|x64
+		{060D75DA-2D1C-48E6-A4A1-6F0718B64661}.Debug|x64.ActiveCfg = Debug|x64
+		{060D75DA-2D1C-48E6-A4A1-6F0718B64661}.Debug|x64.Build.0 = Debug|x64
+		{060D75DA-2D1C-48E6-A4A1-6F0718B64661}.Release|x64.ActiveCfg = Release|x64
+		{060D75DA-2D1C-48E6-A4A1-6F0718B64661}.Release|x64.Build.0 = Release|x64
+		{748417CA-F17E-487F-9411-CAFB6D3F4877}.Debug|x64.ActiveCfg = Debug|x64
+		{748417CA-F17E-487F-9411-CAFB6D3F4877}.Debug|x64.Build.0 = Debug|x64
+		{748417CA-F17E-487F-9411-CAFB6D3F4877}.Release|x64.ActiveCfg = Release|x64
+		{748417CA-F17E-487F-9411-CAFB6D3F4877}.Release|x64.Build.0 = Release|x64
+		{217DF501-135C-4E38-BFC8-99D4821032EA}.Debug|x64.ActiveCfg = Debug|x64
+		{217DF501-135C-4E38-BFC8-99D4821032EA}.Debug|x64.Build.0 = Debug|x64
+		{217DF501-135C-4E38-BFC8-99D4821032EA}.Release|x64.ActiveCfg = Release|x64
+		{217DF501-135C-4E38-BFC8-99D4821032EA}.Release|x64.Build.0 = Release|x64
+		{47310AB4-9034-4BD1-8D8B-E88AD21A171B}.Debug|x64.ActiveCfg = Debug|x64
+		{47310AB4-9034-4BD1-8D8B-E88AD21A171B}.Debug|x64.Build.0 = Debug|x64
+		{47310AB4-9034-4BD1-8D8B-E88AD21A171B}.Release|x64.ActiveCfg = Release|x64
+		{47310AB4-9034-4BD1-8D8B-E88AD21A171B}.Release|x64.Build.0 = Release|x64
+		{E4E0D2AE-B17D-4BD4-8BEE-AFC8CC464C5F}.Debug|x64.ActiveCfg = Debug|x64
+		{E4E0D2AE-B17D-4BD4-8BEE-AFC8CC464C5F}.Debug|x64.Build.0 = Debug|x64
+		{E4E0D2AE-B17D-4BD4-8BEE-AFC8CC464C5F}.Release|x64.ActiveCfg = Release|x64
+		{E4E0D2AE-B17D-4BD4-8BEE-AFC8CC464C5F}.Release|x64.Build.0 = Release|x64
+		{A7D5099E-F0FD-4BF3-8522-5A682759F915}.Debug|x64.ActiveCfg = Debug|x64
+		{A7D5099E-F0FD-4BF3-8522-5A682759F915}.Debug|x64.Build.0 = Debug|x64
+		{A7D5099E-F0FD-4BF3-8522-5A682759F915}.Release|x64.ActiveCfg = Release|x64
+		{A7D5099E-F0FD-4BF3-8522-5A682759F915}.Release|x64.Build.0 = Release|x64
+		{B1BCC8C6-46B5-4BFA-8F22-20F32D99EC6A}.Debug|x64.ActiveCfg = Debug|x64
+		{B1BCC8C6-46B5-4BFA-8F22-20F32D99EC6A}.Debug|x64.Build.0 = Debug|x64
+		{B1BCC8C6-46B5-4BFA-8F22-20F32D99EC6A}.Release|x64.ActiveCfg = Release|x64
+		{B1BCC8C6-46B5-4BFA-8F22-20F32D99EC6A}.Release|x64.Build.0 = Release|x64
+		{A80355C2-780D-4245-BD80-25B8DE698EE3}.Debug|x64.ActiveCfg = Debug|x64
+		{A80355C2-780D-4245-BD80-25B8DE698EE3}.Debug|x64.Build.0 = Debug|x64
+		{A80355C2-780D-4245-BD80-25B8DE698EE3}.Release|x64.ActiveCfg = Release|x64
+		{A80355C2-780D-4245-BD80-25B8DE698EE3}.Release|x64.Build.0 = Release|x64
+		{F055103B-F80B-4D0C-BF48-057C55620033}.Debug|x64.ActiveCfg = Debug|x64
+		{F055103B-F80B-4D0C-BF48-057C55620033}.Debug|x64.Build.0 = Debug|x64
+		{F055103B-F80B-4D0C-BF48-057C55620033}.Release|x64.ActiveCfg = Release|x64
+		{F055103B-F80B-4D0C-BF48-057C55620033}.Release|x64.Build.0 = Release|x64
+		{985B3F2F-CEED-4C0A-A249-69257E719145}.Debug|x64.ActiveCfg = Debug|x64
+		{985B3F2F-CEED-4C0A-A249-69257E719145}.Debug|x64.Build.0 = Debug|x64
+		{985B3F2F-CEED-4C0A-A249-69257E719145}.Release|x64.ActiveCfg = Release|x64
+		{985B3F2F-CEED-4C0A-A249-69257E719145}.Release|x64.Build.0 = Release|x64
+		{437AD818-3F1F-4CA5-A79B-25233A157026}.Debug|x64.ActiveCfg = Debug|x64
+		{437AD818-3F1F-4CA5-A79B-25233A157026}.Debug|x64.Build.0 = Debug|x64
+		{437AD818-3F1F-4CA5-A79B-25233A157026}.Release|x64.ActiveCfg = Release|x64
+		{437AD818-3F1F-4CA5-A79B-25233A157026}.Release|x64.Build.0 = Release|x64
+		{787B8AA6-CA93-4C84-96FE-DF31110AD1C4}.Debug|x64.ActiveCfg = Debug|x64
+		{787B8AA6-CA93-4C84-96FE-DF31110AD1C4}.Debug|x64.Build.0 = Debug|x64
+		{787B8AA6-CA93-4C84-96FE-DF31110AD1C4}.Release|x64.ActiveCfg = Release|x64
+		{787B8AA6-CA93-4C84-96FE-DF31110AD1C4}.Release|x64.Build.0 = Release|x64
+		{08C8C05F-0362-41BC-818C-724572DF8B06}.Debug|x64.ActiveCfg = Debug|x64
+		{08C8C05F-0362-41BC-818C-724572DF8B06}.Debug|x64.Build.0 = Debug|x64
+		{08C8C05F-0362-41BC-818C-724572DF8B06}.Release|x64.ActiveCfg = Release|x64
+		{08C8C05F-0362-41BC-818C-724572DF8B06}.Release|x64.Build.0 = Release|x64
+		{5D00D290-4016-4CFE-9E41-1E7C724509BA}.Debug|x64.ActiveCfg = Debug|x64
+		{5D00D290-4016-4CFE-9E41-1E7C724509BA}.Debug|x64.Build.0 = Debug|x64
+		{5D00D290-4016-4CFE-9E41-1E7C724509BA}.Release|x64.ActiveCfg = Release|x64
+		{5D00D290-4016-4CFE-9E41-1E7C724509BA}.Release|x64.Build.0 = Release|x64
+		{E6410BFC-B341-498C-8C67-312C20CDD8D5}.Debug|x64.ActiveCfg = Debug|x64
+		{E6410BFC-B341-498C-8C67-312C20CDD8D5}.Debug|x64.Build.0 = Debug|x64
+		{E6410BFC-B341-498C-8C67-312C20CDD8D5}.Release|x64.ActiveCfg = Release|x64
+		{E6410BFC-B341-498C-8C67-312C20CDD8D5}.Release|x64.Build.0 = Release|x64
+		{62173D9A-6724-4C00-A1C8-FB646480A9EC}.Debug|x64.ActiveCfg = Debug|x64
+		{62173D9A-6724-4C00-A1C8-FB646480A9EC}.Debug|x64.Build.0 = Debug|x64
+		{62173D9A-6724-4C00-A1C8-FB646480A9EC}.Release|x64.ActiveCfg = Release|x64
+		{62173D9A-6724-4C00-A1C8-FB646480A9EC}.Release|x64.Build.0 = Release|x64
+		{4AED67B6-55FD-486F-B917-E543DEE2CB3C}.Debug|x64.ActiveCfg = Debug|x64
+		{4AED67B6-55FD-486F-B917-E543DEE2CB3C}.Debug|x64.Build.0 = Debug|x64
+		{4AED67B6-55FD-486F-B917-E543DEE2CB3C}.Release|x64.ActiveCfg = Release|x64
+		{4AED67B6-55FD-486F-B917-E543DEE2CB3C}.Release|x64.Build.0 = Release|x64
+		{42851751-CBC8-45A6-97F5-7A0753F7B4D1}.Debug|x64.ActiveCfg = Debug|x64
+		{42851751-CBC8-45A6-97F5-7A0753F7B4D1}.Debug|x64.Build.0 = Debug|x64
+		{42851751-CBC8-45A6-97F5-7A0753F7B4D1}.Release|x64.ActiveCfg = Release|x64
+		{42851751-CBC8-45A6-97F5-7A0753F7B4D1}.Release|x64.Build.0 = Release|x64
 	EndGlobalSection
 	GlobalSection(SolutionProperties) = preSolution
 		HideSolutionNode = FALSE
@@ -152,13 +514,11 @@ Global
 	GlobalSection(NestedProjects) = preSolution
 		{74485049-C722-400F-ABE5-86AC52D929B3} = {1AFB6476-670D-4E80-A464-657E01DFF482}
 		{A46629C4-1A6C-40FA-A8B6-10E5102BB0BA} = {4574FDD0-F61D-4376-98BF-E5A1262C11EC}
-		{44CC9375-3E6E-4D99-8913-7FB748807EBD} = {4574FDD0-F61D-4376-98BF-E5A1262C11EC}
 		{3BB8493E-D18E-4485-A320-CB40F90F55AE} = {4574FDD0-F61D-4376-98BF-E5A1262C11EC}
 		{D1D6BC88-09AE-4FB4-AD24-5DED46A791DD} = {4574FDD0-F61D-4376-98BF-E5A1262C11EC}
 		{F9C68EDF-AC74-4B77-9AF1-005D9C9F6A99} = {D1D6BC88-09AE-4FB4-AD24-5DED46A791DD}
 		{48804216-2A0E-4168-A6D8-9CD068D14227} = {D1D6BC88-09AE-4FB4-AD24-5DED46A791DD}
 		{9C6A7905-72D4-4BF5-B256-ABFDAEF68AE9} = {D1D6BC88-09AE-4FB4-AD24-5DED46A791DD}
-		{4E577735-DFAB-41AF-8A6E-B6E8872A2928} = {1FAF749F-0D6F-4BF5-A563-31A4B5279D27}
 		{1A066C63-64B3-45F8-92FE-664E1CCE8077} = {1AFB6476-670D-4E80-A464-657E01DFF482}
 		{5CCC8468-DEC8-4D36-99D4-5C891BEBD481} = {D1D6BC88-09AE-4FB4-AD24-5DED46A791DD}
 		{89E20BCE-EB9C-46C8-8B50-E01A82E6FDC3} = {4574FDD0-F61D-4376-98BF-E5A1262C11EC}
@@ -167,6 +527,57 @@ Global
 		{0E072714-D127-460B-AFAD-B4C40B412798} = {89E20BCE-EB9C-46C8-8B50-E01A82E6FDC3}
 		{A3935CF4-46C5-4A88-84D3-6B12E16E6BA2} = {89E20BCE-EB9C-46C8-8B50-E01A82E6FDC3}
 		{2151F984-E006-4A9F-92EF-C6DDE3DC8413} = {89E20BCE-EB9C-46C8-8B50-E01A82E6FDC3}
+		{64A80062-4D8B-4229-8A38-DFA1D7497749} = {BEEAB7F2-FFF6-45AB-9CDB-B04CC0734B88}
+		{0485F45C-EA7A-4BB5-804B-3E8D14699387} = {89E20BCE-EB9C-46C8-8B50-E01A82E6FDC3}
+		{0B593A6C-4143-4337-860E-DB5710FB87DB} = {1AFB6476-670D-4E80-A464-657E01DFF482}
+		{031AC72E-FA28-4AB7-B690-6F7B9C28AA73} = {1AFB6476-670D-4E80-A464-657E01DFF482}
+		{89F34AF7-1C34-4A72-AA6E-534BCF972BD9} = {38BDB927-829B-4C65-9CD9-93FB05D66D65}
+		{6C7F47CC-2151-44A3-A546-41C70025132C} = {4574FDD0-F61D-4376-98BF-E5A1262C11EC}
+		{2BE46397-4DFA-414C-9BD4-41E4BBF8CB34} = {6C7F47CC-2151-44A3-A546-41C70025132C}
+		{0B43679E-EDFA-4DA0-AD30-F4628B308B1B} = {6C7F47CC-2151-44A3-A546-41C70025132C}
+		{E0CC7526-D85E-43AC-844F-D5DF0D2F5AB8} = {6C7F47CC-2151-44A3-A546-41C70025132C}
+		{EAF23649-EF6E-478B-980E-81FAD96CCA2A} = {38BDB927-829B-4C65-9CD9-93FB05D66D65}
+		{17DA04DF-E393-4397-9CF0-84DABE11032E} = {1AFB6476-670D-4E80-A464-657E01DFF482}
+		{38BDB927-829B-4C65-9CD9-93FB05D66D65} = {4574FDD0-F61D-4376-98BF-E5A1262C11EC}
+		{8AFFA899-0B73-49EC-8C50-0FADDA57B2FC} = {38BDB927-829B-4C65-9CD9-93FB05D66D65}
+		{C140A3EF-6DBF-4084-9D4C-4EB5A99FEE68} = {4574FDD0-F61D-4376-98BF-E5A1262C11EC}
+		{DB90F671-D861-46BB-93A3-F1304F5BA1C5} = {C140A3EF-6DBF-4084-9D4C-4EB5A99FEE68}
+		{B749F0DB-8E75-47DB-9E5E-265D16D0C0D2} = {C140A3EF-6DBF-4084-9D4C-4EB5A99FEE68}
+		{4FD29318-A8AB-4D8F-AA47-60BC241B8DA3} = {C140A3EF-6DBF-4084-9D4C-4EB5A99FEE68}
+		{8451ECDD-2EA4-4966-BB0A-7BBC40138E80} = {C140A3EF-6DBF-4084-9D4C-4EB5A99FEE68}
+		{FF742965-9A80-41A5-B042-D6C7D3A21708} = {C140A3EF-6DBF-4084-9D4C-4EB5A99FEE68}
+		{4AFC9975-2456-4C70-94A4-84073C1CED93} = {C140A3EF-6DBF-4084-9D4C-4EB5A99FEE68}
+		{59BD9891-3837-438A-958D-ADC7F91F6F7E} = {4AFC9975-2456-4C70-94A4-84073C1CED93}
+		{74F1B9ED-F59C-4FE7-B473-7B453E30837E} = {4AFC9975-2456-4C70-94A4-84073C1CED93}
+		{FDB3555B-58EF-4AE6-B5F1-904719637AB4} = {4AFC9975-2456-4C70-94A4-84073C1CED93}
+		{C21BFF9C-2C99-4B5F-B7C9-A5E6DDDB37B0} = {4AFC9975-2456-4C70-94A4-84073C1CED93}
+		{F8B870EB-D5F5-45BA-9CF7-A5C459818820} = {4AFC9975-2456-4C70-94A4-84073C1CED93}
+		{E364F67B-BB12-4E91-B639-355866EBCD8B} = {C140A3EF-6DBF-4084-9D4C-4EB5A99FEE68}
+		{F97E5003-F263-4D4A-A964-0F1F3C82DEF2} = {C140A3EF-6DBF-4084-9D4C-4EB5A99FEE68}
+		{880ED251-9E16-4713-9A70-D35FE0C01669} = {E775CC2C-24CB-48D6-9C3A-BE4CCE0DB17A}
+		{2F305555-C296-497E-AC20-5FA1B237996A} = {4574FDD0-F61D-4376-98BF-E5A1262C11EC}
+		{AF2349B8-E5B6-4004-9502-687C1C7730B1} = {2F305555-C296-497E-AC20-5FA1B237996A}
+		{6A71162E-FC4C-4A2C-B90F-3CF94F59A9BB} = {2F305555-C296-497E-AC20-5FA1B237996A}
+		{A2B51B8B-8F90-424E-BC97-F9AB7D76CA1A} = {2F305555-C296-497E-AC20-5FA1B237996A}
+		{DA425894-6E13-404F-8DCB-78584EC0557A} = {2F305555-C296-497E-AC20-5FA1B237996A}
+		{060D75DA-2D1C-48E6-A4A1-6F0718B64661} = {2F305555-C296-497E-AC20-5FA1B237996A}
+		{748417CA-F17E-487F-9411-CAFB6D3F4877} = {2F305555-C296-497E-AC20-5FA1B237996A}
+		{217DF501-135C-4E38-BFC8-99D4821032EA} = {2F305555-C296-497E-AC20-5FA1B237996A}
+		{47310AB4-9034-4BD1-8D8B-E88AD21A171B} = {2F305555-C296-497E-AC20-5FA1B237996A}
+		{E4E0D2AE-B17D-4BD4-8BEE-AFC8CC464C5F} = {C3081D9A-1586-441A-B5F4-ED815B3719C1}
+		{A7D5099E-F0FD-4BF3-8522-5A682759F915} = {C3081D9A-1586-441A-B5F4-ED815B3719C1}
+		{B1BCC8C6-46B5-4BFA-8F22-20F32D99EC6A} = {C3081D9A-1586-441A-B5F4-ED815B3719C1}
+		{A80355C2-780D-4245-BD80-25B8DE698EE3} = {C3081D9A-1586-441A-B5F4-ED815B3719C1}
+		{F055103B-F80B-4D0C-BF48-057C55620033} = {1AFB6476-670D-4E80-A464-657E01DFF482}
+		{985B3F2F-CEED-4C0A-A249-69257E719145} = {1AFB6476-670D-4E80-A464-657E01DFF482}
+		{437AD818-3F1F-4CA5-A79B-25233A157026} = {1AFB6476-670D-4E80-A464-657E01DFF482}
+		{787B8AA6-CA93-4C84-96FE-DF31110AD1C4} = {4AFC9975-2456-4C70-94A4-84073C1CED93}
+		{08C8C05F-0362-41BC-818C-724572DF8B06} = {C140A3EF-6DBF-4084-9D4C-4EB5A99FEE68}
+		{5D00D290-4016-4CFE-9E41-1E7C724509BA} = {1AFB6476-670D-4E80-A464-657E01DFF482}
+		{E6410BFC-B341-498C-8C67-312C20CDD8D5} = {1AFB6476-670D-4E80-A464-657E01DFF482}
+		{62173D9A-6724-4C00-A1C8-FB646480A9EC} = {38BDB927-829B-4C65-9CD9-93FB05D66D65}
+		{4AED67B6-55FD-486F-B917-E543DEE2CB3C} = {1AFB6476-670D-4E80-A464-657E01DFF482}
+		{42851751-CBC8-45A6-97F5-7A0753F7B4D1} = {4AFC9975-2456-4C70-94A4-84073C1CED93}
 	EndGlobalSection
 	GlobalSection(ExtensibilityGlobals) = postSolution
 		SolutionGuid = {C3A2F9D1-7930-4EF4-A6FC-7EE0A99821D0}

README.md

@@ -1,136 +1,182 @@
 # Overview
 
-PowerToys is a set of utilities for power users to tune and streamline their Windows experience for greater productivity.  
+<img src="./doc/images/overview/PT%20hero%20image.png"/>
 
-Inspired by the [Windows 95 era PowerToys project](https://en.wikipedia.org/wiki/Microsoft_PowerToys), this reboot provides power users with ways to squeeze more efficiency out of the Windows 10 shell and customize it for individual workflows.  A great overview of the Windows 95 PowerToys can be found [here](https://socket3.wordpress.com/2016/10/22/using-windows-95-powertoys/).
+Microsoft PowerToys is a set of utilities for power users to tune and streamline their Windows experience for greater productivity. Inspired by the [Windows 95 era PowerToys project](https://en.wikipedia.org/wiki/Microsoft_PowerToys), this reboot provides power users with ways to squeeze more efficiency out of the Windows 10 shell and customize it for individual workflows.  A great overview of the Windows 95 PowerToys can be found [here](https://socket3.wordpress.com/2016/10/22/using-windows-95-powertoys/).
 
-![logo](doc/images/Logo.jpg)
+[What's Happening](#whats-happening)   |   [Downloading & Release notes][github-release-link]   |   [Contributing to PowerToys](#contributing) | [Known issues](#known-issues)
 
-## Installation
+## Build status
 
-_(Note: in order to run PowerToys, you'll need to be running at least Windows build 17134 or higher.  Also, PowerToys does not currently support Windows ARM machines)_
+[![Build Status](https://dev.azure.com/ms/PowerToys/_apis/build/status/microsoft.PowerToys?branchName=master)](https://dev.azure.com/ms/PowerToys/_build?definitionId=219)
 
-### GitHub
+## Current PowerToy Utilities
 
-The first preview of these utilities can be installed from the [PowerToys GitHub releases page](https://github.com/Microsoft/powertoys/releases).
+### FancyZones
 
-### Chocolatey (Unofficial)
+[<img align="left" src="./doc/images/overview/FancyZones_small.png" />](https://aka.ms/PowerToysOverview_FancyZones) [FancyZones](https://aka.ms/PowerToysOverview_FancyZones) is a window manager that makes it easy to create complex window layouts and quickly position windows into those layouts.
+<br>
+<br>
+<br>
+<br>
+<br>
 
-Download and upgrade PowerToys from [Chocolatey](https://chocolatey.org).
+### File Explorer Add-ons (Preview Panes)
+
+[<img align="left" src="./doc/images/overview/PowerPreview_small.PNG" />](https://aka.ms/PowerToysOverview_FileExplorerAddOns) [File Explorer](https://aka.ms/PowerToysOverview_FileExplorerAddOns) add-ons right now are just limited to Preview Pane additions for File Explorer. Preview Pane is an existing feature in the File Explorer.  To enable it, you just click the View tab in the ribbon and then click "Preview Pane".
+
+PowerToys will now enable two types of files to be previewed: Markdown (.md) & SVG (.svg)
+<br>
+<br>
+
+### Image Resizer
+
+[<img align="left" src="./doc/images/overview/ImageResizer_small.png" />](https://aka.ms/PowerToysOverview_ImageResizer) [Image Resizer](https://aka.ms/PowerToysOverview_ImageResizer) is a Windows Shell Extension for quickly resizing images.  With a simple right click from File Explorer, resize one or many images instantly. This code is based on [Brice Lambson's Image Resizer](https://github.com/bricelam/ImageResizer).
+<br>
+<br>
+<br>
+<br>
+
+### Keyboard Manager
+
+[<img align="left" src="./doc/images/overview/KBM_small.png" />](https://aka.ms/PowerToysOverview_KeyboardManager) [Keyboard Manager](https://aka.ms/PowerToysOverview_KeyboardManager) allows you to customize the keyboard to be more productive by remapping keys and creating your own keyboard shortcuts. This PowerToy requires Windows 10 1903 (build 18362) or later.
+<br>
+<br>
+<br>
+<br>
+
+### PowerRename
+
+[<img align="left" src="./doc/images/overview/PowerRename_small.PNG" />](https://aka.ms/PowerToysOverview_PowerRename) [PowerRename](https://aka.ms/PowerToysOverview_PowerRename) is a Windows Shell Extension for advanced bulk renaming using search and replace or regular expressions. PowerRename allows simple search and replace or more advanced regular expression matching. While you type in the search and replace input fields, the preview area will show what the items will be renamed to. PowerRename then calls into the Windows Explorer file operations engine to perform the rename. This has the benefit of allowing the rename operation to be undone after PowerRename exits. This code is based on [Chris Davis's SmartRename](https://github.com/chrdavis/SmartRename).
+<br>
+
+### PowerToys Run
+
+[<img align="left" src="./doc/images/overview/PowerLauncher_small.png" />](https://aka.ms/PowerToysOverview_PowerToysRun) [PowerToys Run](https://aka.ms/PowerToysOverview_PowerToysRun) is a new toy in PowerToys that can help you search and launch your app instantly with a simple alt-space and start typing! It is open source and modular for additional plugins.  Window Walker is now inside too! This PowerToy requires Windows 10 1903 (build 18362) or later.
+<br>
+<br>
+<br>
+
+### Shortcut Guide
+
+[<img align="left" src="./doc/images/overview/Shortcut guide_small.png" />](https://aka.ms/PowerToysOverview_ShortcutGuide)  [Windows key shortcut guide](https://aka.ms/PowerToysOverview_ShortcutGuide) appears when a user holds the Windows key down for more than one second and shows the available shortcuts for the current state of the desktop.
+<br>
+<br>
+<br>
+<br>
+<br>
+
+## Installing and running Microsoft PowerToys
+
+**Requirements**
+- Windows 10 1803 (build 17134) or later.
+- Have [.NET Core 3.1 Desktop Runtime](https://dotnet.microsoft.com/download/dotnet-core/thank-you/runtime-desktop-3.1.4-windows-x64-installer). The installer will prompt this but we want to directly make people aware.
+
+### Via GitHub with MSI [Recommended]
+
+Install from the [Microsoft PowerToys GitHub releases page][github-release-link]. Click on `Assets` to show the files available in the release and then click on `PowerToysSetup-0.19.0-x64.msi` to download the PowerToys installer.
+
+**Note:** After installing, you will have to start PowerToys for the first time.  We will improve install experience this moving forward but due to a possible install dependency, we can't start after install currently.
+
+This is our preferred method.
+
+### Via WinGet (Preview)
+Download PowerToys from [WinGet](https://github.com/microsoft/winget-cli/releases). To install PowerToys, run the following command from the command line / PowerShell:
+
+```powershell
+WinGet install powertoys
+```
+
+### Other install methods
+
+#### Via Chocolatey (Unofficial)
+
+Download and upgrade PowerToys from [Chocolatey](https://chocolatey.org). If you have any issues when installing/upgrading the package please go to the [package page](https://chocolatey.org/packages/powertoys) and follow the [Chocolatey triage process](https://chocolatey.org/docs/package-triage-process)
+
+To install PowerToys, run the following command from the command line / PowerShell:
 
-To install PowerToys, run the following command from the command line or from PowerShell:
 ```powershell
 choco install powertoys
 ```
 
-To upgrade PowerToys, run the following command from the command line or from PowerShell:
+To upgrade PowerToys, run the following command from the command line / PowerShell:
+
 ```powershell
 choco upgrade powertoys
 ```
 
-If you have any issues when installing/upgrading the package please go to the [package page](https://chocolatey.org/packages/powertoys) and follow the [Chocolatey triage process](https://chocolatey.org/docs/package-triage-process)
+### Known issues
 
-### Build Status
+- PT Run, Newly installed apps can't be found [#3553](https://github.com/microsoft/PowerToys/issues/3553).  We will address this in 0.20.
+- PT Run, CPU / Memory, still investigating [#3208](https://github.com/microsoft/PowerToys/issues/3208).  We have 2 leads and fixed one item.
+- WinKey remapping for PT Run can be quirky [#4578](https://github.com/microsoft/PowerToys/issues/4578)
 
-[![Build Status](https://dev.azure.com/ms/PowerToys/_apis/build/status/microsoft.PowerToys?branchName=master)](https://dev.azure.com/ms/PowerToys/_build?definitionId=35096)
+### Processor support
 
-# What's Happening
+We currently support the matrix below.
 
-## October Update
-A big thanks to everyone who has downloaded and started using the first PowerToys preview.  There's been over 150K downloads so far.  An even bigger thanks to everyone who has provided feedback and suggestions in the issues.  The community engagement has been really awesome to see.  
+| x64 | x86 | ARM |
+|:---:|:---:|:---:|
+| [Supported][github-release-link] | [Issue #602](https://github.com/microsoft/PowerToys/issues/602) | [Issue #490](https://github.com/microsoft/PowerToys/issues/490) |
 
-The team has been hard at working fixing bugs, addressing issues and implementing feature suggestions.  If you've downloaded the code and built the latest on your machine recently you've seen many of these improvements (dark mode!).  We're hoping to have a new official build out shortly with all these improvements and will also be signed by Microsoft.  A new utility is also coming soon: Chris Davis is working to integrate his [SmartRename tool](https://github.com/chrdavis/SmartRename) into PowerToys!
+## What's Happening
 
-![SmartRename](https://github.com/chrdavis/SmartRename/raw/master/Images/SmartRenameDemo.gif)
+### June 2020 Update
 
-1. [FancyZones](/src/modules/fancyzones/) - FancyZones is a window manager that makes it easy to create complex window layouts and quickly position windows into those layouts.  The FancyZones backlog can be found [here](https://github.com/Microsoft/PowerToys/tree/master/doc/planning/FancyZonesBacklog.md)
+Our goals for 0.19 release cycle had one big goal, add in stability / quality fixes. We've addressed over 100 issues across all our utilities. We've improved our installer experience and parts will start coming online in 0.19 and 0.20.  In this release, it will be the last time during upgrade you'll see Windows Explorer flash on you. For 0.20, the .NET Core install experience much smoother.
 
-![FancyZones](src/modules/fancyzones/FancyZones.png)
+We'd also stress feedback is critical. We know there are areas for improvement on PowerToys Run. We would love feedback so we can improve. We also would love to know if you want us to be more aggressive on auto-upgrading.
 
-FancyZones Video Tutorial
-[![FancyZones Video Tutorial](doc/images/FZTutorial.jpg)](https://www.youtube.com/watch?v=rTtGzZYAXgY)
+Lastly, we'd like to thank everyone who filed a bug, gave feedback or made a pull-request. The PowerToys team is extremely grateful to have the support of an amazing active community.
 
-2. [Windows key shortcut guide](/src/modules/shortcut_guide) - The shortcut guide appears when a user holds the Windows key down for more than one second and shows the available shortcuts for the current state of the desktop.  The shortcut guide backlog can be found [here](https://github.com/Microsoft/PowerToys/tree/master/doc/planning/ShortcutGuideBacklog.md)
+- We shipped [v0.19][github-release-link]!
+- Big push for PowerToys Run search quality fixes
+- PowerToys Run can now remap to any key shortcut (minus restricted ones such as WinKey+L)
+- Improved FancyZones on Virtual Desktops and multi-thread design
+- Installer after 0.19 will no longer restart Windows Explorer
+- Fixed [#2012 - Uninstalling with old control panel fails](https://github.com/microsoft/PowerToys/issues/2012)
+- Fixed [#3384 - PowerToys Settings window is empty](https://github.com/microsoft/PowerToys/issues/3384)
+- Over 100 bug fixes!
 
-![Windows key shortcut guide](doc/images/WindowsKeyShortcutGuide.jpg)
+For [0.20](https://github.com/microsoft/PowerToys/issues?q=is%3Aopen+is%3Aissue+project%3Amicrosoft%2FPowerToys%2F6), we are proactively working on:
 
-Additional utilities in the pipeline are:
+- Stability
+- Start work on FZ Editor V2
+- Start work on OOBE improvements
+- Keyboard manager improvements
 
-* Maximize to new desktop widget - The MTND widget shows a pop-up button when a user hovers over the maximize / restore button on any window.  Clicking it creates a new desktop, sends the app to that desktop and maximizes the app on the new desktop.
-* [Process terminate tool](https://github.com/indierawk2k2/PowerToys-1/blob/master/specs/Terminate%20Spec.md)
-* [Animated gif screen recorder](https://github.com/indierawk2k2/PowerToys-1/blob/master/specs/GIF%20Maker%20Spec.md)
+### Version 1.0 plan
 
-# Backlog
+Our plan for all the [goals and utilities for v1.0 detailed over here in the wiki][v1].
 
-The full backlog of utilities can be found [here](https://github.com/Microsoft/PowerToys/tree/master/doc/planning/PowerToysBacklog.md)
+## Developer Guidance
 
-# Where to download PowerToys
+Please read the [developer docs](/doc/devdocs) for a detailed breakdown.
 
-  The latest release of PowerToys can be downloaded from https://github.com/microsoft/PowerToys/releases <br />
-  Click on `Assets` to show the files available in the release and then click on `PowerToysSetup.msi` to download the PowerToys installer. <br />
-  PDB symbols for the release are available in a separate zip file `PDB symbols.zip`.
+## Contributing
 
-# Developer Guidance
-
-## Build Prerequisites
- * Windows 10 1803 (build 10.0.17134.0) or above to build and run PowerToys.
- * Visual Studio 2019 Community edition or higher, with the 'Desktop Development with C++' component and the Windows 10 SDK version 10.0.18362.0 or higher.
- 
-## Building the Code
- * Open `powertoys.sln` in Visual Studio, in the `Solutions Configuration` drop-down menu select `Release` or `Debug`, from the `Build` menu choose `Build Solution`.
- * The PowerToys binaries will be in your repo under `x64\Release`.
- * If you want to copy the `PowerToys.exe` binary to a different location, you'll also need to copy the `modules` and the `svgs` folders.
-
-## Prerequisites to Build the Installer
- * Install the [WiX Toolset Visual Studio 2019 Extension](https://marketplace.visualstudio.com/items?itemName=RobMensching.WiXToolset).
- * Install the [WiX Toolset build tools](https://wixtoolset.org/releases/).
- 
-## Building the .msi Installer
-  * From the `installer` folder open `PowerToysSetup.sln` in Visual Studio, in the `Solutions Configuration` drop-down menu select `Release` or `Debug`, from the `Build` menu choose `Build Solution`.
-  * The resulting `PowerToysSetup.msi` installer will be available in the `installer\PowerToysSetup\x64\Release\` folder.
-
-## Debugging
-  The following configuration issue only applies if the user is a member of the Administrators group.
-  
-  Some PowerToys modules require being run with the highest permission level if the current user is a member of the Administrators group. The highest permission level is required to be able to perform some actions when an elevated application (e.g. Task Manager) is in the foreground or is the target of an action. Without elevated privileges some PowerToys modules will still work but with some limitations:
- - the `FancyZones` module will be not be able to move an elevated window to a zone.
- - the `Shortcut Guide` module will not appear if the foreground window belongs to an elevated application.
- 
- To run and debug PowerToys from Visual Studio when the user is a member of the Administrators group, Visual Studio has to be started with elevated privileges. If you want to avoid running Visual Studio with elevated privileges and don't mind the limitations described above, you can do the following: open the `runner` project properties and navigate to the `Linker -> Manifest File` settings, edit the `UAC Execution Level` property and change it from `highestAvailable (/level='highestAvailable')` to `asInvoker (/level='asInvoker')`, save the changes.
- 
-## How to create new PowerToys
-
-See the instructions on [how to install the PowerToys Module project template](tools/project_template). <br />
-Specifications for the [PowerToys settings API](doc/specs/PowerToys-settings.md).
-
-## Coding Guidance
-
-Please review these brief docs below relating to our coding standards etc.
-
-> 👉 If you find something missing from these docs, feel free to contribute to any of our documentation files anywhere in the repository (or make some new ones\!)
-
-This is a work in progress as we learn what we'll need to provide people in order to be effective contributors to our project.
-- [Coding Style](doc/coding/style.md)
-- [Code Organization](doc/coding/organization.md)
-
-# Contributing
-This project welcomes contributions and suggestions and we are excited to work with the power user community to build a set of tools for helping you get the most out of Windows.
+This project welcomes contributions of all types. Help spec'ing, design, documentation, finding bugs are ways everyone can help on top of coding features / bug fixes. We are excited to work with the power user community to build a set of tools for helping you get the most out of Windows.
 
 We ask that **before you start work on a feature that you would like to contribute**, please read our [Contributor's Guide](contributing.md). We will be happy to work with you to figure out the best approach, provide guidance and mentorship throughout feature development, and help avoid any wasted or duplicate effort.
 
-> ⚠ **Note**: PowerToys is still a nascent project and the team is actively working out of this repository.  We will be periodically re-structuring the code to make it easier to comprehend, navigate, build, test, and contribute to, so **DO expect significant changes to code layout on a regular basis**.
+### ⚠ State of code ⚠
 
-> ⚠ **License Info**: Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.opensource.microsoft.com.
+PowerToys is still a very fluidic project and the team is actively working out of this repository.  We will be periodically re-structuring/refactoring the code to make it easier to comprehend, navigate, build, test, and contribute to, so **DO expect significant changes to code layout on a regular basis**.
 
-When you submit a pull request, a CLA-bot will automatically determine whether you need to provide
-a CLA and decorate the PR appropriately (e.g. status check, comment). Simply follow the instructions
-provided by the bot. You will only need to do this once across all repos using our CLA.
+### License Info
 
-# Code of Conduct
+ Most contributions require you to agree to a [Contributor License Agreement (CLA)][oss-CLA] declaring that you have the right to, and actually do, grant us the rights to use your contribution.
 
-This project has adopted the [Microsoft Open Source Code of Conduct][conduct-code]. <br />
-For more information see the [Code of Conduct FAQ][conduct-FAQ] or contact [opencode@microsoft.com][conduct-email] with any additional questions or comments.
+## Code of Conduct
 
-[conduct-code]: https://opensource.microsoft.com/codeofconduct/ 
-[conduct-FAQ]: https://opensource.microsoft.com/codeofconduct/faq/
-[conduct-email]: mailto:opencode@microsoft.com
+This project has adopted the [Microsoft Open Source Code of Conduct][oss-conduct-code].
+
+## Privacy Statement
+
+The application logs basic telemetry. Our Telemetry Data page (Coming Soon) has the trends from the telemetry. Please read the [Microsoft privacy statement][privacyLink] for more information.
+
+[oss-CLA]: https://cla.opensource.microsoft.com
+[oss-conduct-code]: CODE_OF_CONDUCT.md
+[github-release-link]: https://github.com/microsoft/PowerToys/releases/
+[v1]: https://github.com/microsoft/PowerToys/wiki/Version-1.0-Strategy
+[privacyLink]: http://go.microsoft.com/fwlink/?LinkId=521839

codeAnalysis/format_sources.ps1

@@ -0,0 +1,53 @@
+param (
+  [switch]$all = $false
+)
+
+if(!(Get-Command "git" -ErrorAction SilentlyContinue)) {
+  throw "You need to have a git in path to be able to format only the dirty files!"
+}
+
+$clangFormat = "clang-format.exe"
+if(!(Get-Command $clangFormat -ErrorAction SilentlyContinue)) {
+    Write-Information "Can't find clang-format.exe in %PATH%, trying to use %VCINSTALLDIR%..."
+    $clangFormat="$env:VCINSTALLDIR\Tools\Llvm\bin\clang-format.exe"
+    if(!(Test-Path -Path $clangFormat -PathType leaf)) {
+      throw "Can't find clang-format.exe executable. Make sure you either have it in %PATH% or run this script from vcvars.bat!"
+    }
+}
+
+$sourceExtensions = New-Object System.Collections.Generic.HashSet[string]
+$sourceExtensions.Add(".cpp") | Out-Null
+$sourceExtensions.Add(".h")   | Out-Null
+
+function Get-Dirty-Files-From-Git() {
+  $repo_root = & git rev-parse --show-toplevel
+
+  $staged    = & git diff --name-only --diff-filter=d --cached | % { $repo_root + "/" + $_ }
+  $unstaged  = & git ls-files -m
+  $untracked = & git ls-files --others --exclude-standard
+  $result = New-Object System.Collections.Generic.List[string]
+  $staged, $unstaged, $untracked | % {
+    $_.Split(" ") | 
+      where {$sourceExtensions.Contains((Get-Item $_).Extension)} | 
+      foreach {$result.Add($_)}
+  } 
+  return $result
+}
+
+if($all) { 
+  $filesToFormat = 
+    Get-ChildItem -Recurse -File ..\src | 
+    Resolve-Path -Relative |
+    where { (Get-Item $_).Directory -notmatch "(Generated Files)|node_modules" -And 
+      $sourceExtensions.Contains((Get-Item $_).Extension)}
+}
+else {
+  $filesToFormat = Get-Dirty-Files-From-Git
+}
+
+$filesToFormat | % {
+  Write-Host "Formatting $_"
+  & $clangFormat -i -style=file -fallback-style=none $_ 2>&1
+}
+
+Write-Host "Done!"

community.md

@@ -0,0 +1,47 @@
+# Community
+
+The PowerToys team is extremely grateful to have the support of an amazing active community.  The work you do is incredibly important.  PowerToys wouldn’t be near what it is without your help filing bugs, updating documentation, guiding the design, or writing features.  We want to say thanks and to recognize your work.  This is a living document dedicated to highlighting the high impact community members and their contributions.
+
+Names are in alphabetical order based on first name.
+
+## High impact community members
+
+### [@Niels9001](https://github.com/niels9001/) - [Niels Laute](https://nielslaute.com/)
+
+Niels has helped drive large sums of our update toward a new [consistent and modern UX](https://github.com/microsoft/PowerToys/issues/891). This includes the [launcher work](https://github.com/microsoft/PowerToys/issues/44) and [icon design](https://github.com/microsoft/PowerToys/issues/1118).
+
+### [@riverar](https://github.com/riverar) - [Rafael Rivera](https://withinrafael.com/)
+
+Rafael has helped do the [upgrade from CppWinRT 1.x to 2.0](https://github.com/microsoft/PowerToys/issues/1907).  He directly provided feedback to the CppWinRT team for bugs from this migration as well.
+
+## Open source projects
+
+As PowerToys creates new utilities, some will be based off existing technology. We'll continue to do our best to contribute back to these projects but their efforts were the base of some of our projects. We want to be sure their work is directly recognized.
+
+### [@jjw24](https://github.com/jjw24/) - Jeremy Wu
+
+Their fork of Wox was the base of PowerToys Run.
+
+### [WoX Launcher](https://github.com/Wox-launcher/Wox/)
+
+Initial base of jjw24's fork, which makes it the base of PowerToys Run.
+
+## Microsoft community members
+
+We would like to also directly call out some extremely helpful Microsoft employees that have directly contributed to PowerToys. This isn't their day job and was work they did out of passion. We want to say thank you and recognize your work.
+
+### [@betsegaw](https://github.com/betsegaw/) - [Betsegaw Tadele](http://www.dreamsofameaningfullife.com/)
+
+Window Walker, inside PowerToys Run, is from Beta.  
+
+### [@TheMrJukes](https://github.com/TheMrJukes/) - Bret Anderson
+
+The base of FancyZones and a lot of performance adjustments are from the hard work of Bret.
+
+### [@bricelam](https://github.com/bricelam/) - [Brice Lambson](https://bricelam.net/)
+
+Image Resizer is from Brice.
+
+### [@chrdavis](https://github.com/chrdavis/) - Chris Davis
+
+PowerRename is from Chris's SmartRename.

deps/cpprestsdk/README.md

@@ -1,12 +0,0 @@
-# C++ Rest SDK - JSON library
-
-This JSON library is taken from the C++ REST SDK in https://github.com/microsoft/cpprestsdk
-
-Based in the [v2.10.13 release](https://github.com/microsoft/cpprestsdk/tree/v2.10.13/Release), it consists of the needed files to build and use the JSON classes described in `include/cpprest/json.h`.
-
-Changes made to the files in order to build in the PowerToys project:
-- Removal of `#include` references to files that are not needed.
-- `#include "pch.h"` instead of `#include "stdafx.h"` to use the PowerToys pre-compiled header.
-- `#define _NO_ASYNCRTIMP` in [`include/cpprest/details/cpprest_compat.h`](./include/cpprest/details/cpprest_compat.h) since this class will be statically linked.
-
-The contents of the C++ Rest SDK license are included in [license.txt](./license.txt).

deps/cpprestsdk/include/cpprest/asyncrt_utils.h

@@ -1,697 +0,0 @@
-/***
- * Copyright (C) Microsoft. All rights reserved.
- * Licensed under the MIT license. See LICENSE.txt file in the project root for full license information.
- *
- * =+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+
- *
- * Various common utilities.
- *
- * For the latest on this and related APIs, please see: https://github.com/Microsoft/cpprestsdk
- *
- * =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
- ****/
-
-#pragma once
-
-#include "cpprest/details/basic_types.h"
-//#include "pplx/pplxtasks.h"
-#include <chrono>
-#include <cstdint>
-#include <limits.h>
-#include <locale.h>
-#include <random>
-#include <string>
-#include <system_error>
-#include <vector>
-
-#ifndef _WIN32
-#include <sys/time.h>
-#if !defined(ANDROID) && !defined(__ANDROID__) && defined(HAVE_XLOCALE_H) // CodePlex 269
-/* Systems using glibc: xlocale.h has been removed from glibc 2.26
-   The above include of locale.h is sufficient
-   Further details: https://sourceware.org/git/?p=glibc.git;a=commit;h=f0be25b6336db7492e47d2e8e72eb8af53b5506d */
-#include <xlocale.h>
-#endif
-#endif
-
-/// Various utilities for string conversions and date and time manipulation.
-namespace utility
-{
-// Left over from VS2010 support, remains to avoid breaking.
-typedef std::chrono::seconds seconds;
-
-/// Functions for converting to/from std::chrono::seconds to xml string.
-namespace timespan
-{
-/// <summary>
-/// Converts a timespan/interval in seconds to xml duration string as specified by
-/// http://www.w3.org/TR/xmlschema-2/#duration
-/// </summary>
-_ASYNCRTIMP utility::string_t __cdecl seconds_to_xml_duration(utility::seconds numSecs);
-
-/// <summary>
-/// Converts an xml duration to timespan/interval in seconds
-/// http://www.w3.org/TR/xmlschema-2/#duration
-/// </summary>
-_ASYNCRTIMP utility::seconds __cdecl xml_duration_to_seconds(const utility::string_t& timespanString);
-} // namespace timespan
-
-/// Functions for Unicode string conversions.
-namespace conversions
-{
-/// <summary>
-/// Converts a UTF-16 string to a UTF-8 string.
-/// </summary>
-/// <param name="w">A two byte character UTF-16 string.</param>
-/// <returns>A single byte character UTF-8 string.</returns>
-_ASYNCRTIMP std::string __cdecl utf16_to_utf8(const utf16string& w);
-
-/// <summary>
-/// Converts a UTF-8 string to a UTF-16
-/// </summary>
-/// <param name="s">A single byte character UTF-8 string.</param>
-/// <returns>A two byte character UTF-16 string.</returns>
-_ASYNCRTIMP utf16string __cdecl utf8_to_utf16(const std::string& s);
-
-/// <summary>
-/// Converts a ASCII (us-ascii) string to a UTF-16 string.
-/// </summary>
-/// <param name="s">A single byte character us-ascii string.</param>
-/// <returns>A two byte character UTF-16 string.</returns>
-_ASYNCRTIMP utf16string __cdecl usascii_to_utf16(const std::string& s);
-
-/// <summary>
-/// Converts a Latin1 (iso-8859-1) string to a UTF-16 string.
-/// </summary>
-/// <param name="s">A single byte character UTF-8 string.</param>
-/// <returns>A two byte character UTF-16 string.</returns>
-_ASYNCRTIMP utf16string __cdecl latin1_to_utf16(const std::string& s);
-
-/// <summary>
-/// Converts a Latin1 (iso-8859-1) string to a UTF-8 string.
-/// </summary>
-/// <param name="s">A single byte character UTF-8 string.</param>
-/// <returns>A single byte character UTF-8 string.</returns>
-_ASYNCRTIMP utf8string __cdecl latin1_to_utf8(const std::string& s);
-
-/// <summary>
-/// Converts to a platform dependent Unicode string type.
-/// </summary>
-/// <param name="s">A single byte character UTF-8 string.</param>
-/// <returns>A platform dependent string type.</returns>
-#ifdef _UTF16_STRINGS
-_ASYNCRTIMP utility::string_t __cdecl to_string_t(std::string&& s);
-#else
-inline utility::string_t&& to_string_t(std::string&& s) { return std::move(s); }
-#endif
-
-/// <summary>
-/// Converts to a platform dependent Unicode string type.
-/// </summary>
-/// <param name="s">A two byte character UTF-16 string.</param>
-/// <returns>A platform dependent string type.</returns>
-#ifdef _UTF16_STRINGS
-inline utility::string_t&& to_string_t(utf16string&& s) { return std::move(s); }
-#else
-_ASYNCRTIMP utility::string_t __cdecl to_string_t(utf16string&& s);
-#endif
-/// <summary>
-/// Converts to a platform dependent Unicode string type.
-/// </summary>
-/// <param name="s">A single byte character UTF-8 string.</param>
-/// <returns>A platform dependent string type.</returns>
-#ifdef _UTF16_STRINGS
-_ASYNCRTIMP utility::string_t __cdecl to_string_t(const std::string& s);
-#else
-inline const utility::string_t& to_string_t(const std::string& s) { return s; }
-#endif
-
-/// <summary>
-/// Converts to a platform dependent Unicode string type.
-/// </summary>
-/// <param name="s">A two byte character UTF-16 string.</param>
-/// <returns>A platform dependent string type.</returns>
-#ifdef _UTF16_STRINGS
-inline const utility::string_t& to_string_t(const utf16string& s) { return s; }
-#else
-_ASYNCRTIMP utility::string_t __cdecl to_string_t(const utf16string& s);
-#endif
-
-/// <summary>
-/// Converts to a UTF-16 from string.
-/// </summary>
-/// <param name="value">A single byte character UTF-8 string.</param>
-/// <returns>A two byte character UTF-16 string.</returns>
-_ASYNCRTIMP utf16string __cdecl to_utf16string(const std::string& value);
-
-/// <summary>
-/// Converts to a UTF-16 from string.
-/// </summary>
-/// <param name="value">A two byte character UTF-16 string.</param>
-/// <returns>A two byte character UTF-16 string.</returns>
-inline const utf16string& to_utf16string(const utf16string& value) { return value; }
-/// <summary>
-/// Converts to a UTF-16 from string.
-/// </summary>
-/// <param name="value">A two byte character UTF-16 string.</param>
-/// <returns>A two byte character UTF-16 string.</returns>
-inline utf16string&& to_utf16string(utf16string&& value) { return std::move(value); }
-
-/// <summary>
-/// Converts to a UTF-8 string.
-/// </summary>
-/// <param name="value">A single byte character UTF-8 string.</param>
-/// <returns>A single byte character UTF-8 string.</returns>
-inline std::string&& to_utf8string(std::string&& value) { return std::move(value); }
-
-/// <summary>
-/// Converts to a UTF-8 string.
-/// </summary>
-/// <param name="value">A single byte character UTF-8 string.</param>
-/// <returns>A single byte character UTF-8 string.</returns>
-inline const std::string& to_utf8string(const std::string& value) { return value; }
-
-/// <summary>
-/// Converts to a UTF-8 string.
-/// </summary>
-/// <param name="value">A two byte character UTF-16 string.</param>
-/// <returns>A single byte character UTF-8 string.</returns>
-_ASYNCRTIMP std::string __cdecl to_utf8string(const utf16string& value);
-
-/// <summary>
-/// Encode the given byte array into a base64 string
-/// </summary>
-_ASYNCRTIMP utility::string_t __cdecl to_base64(const std::vector<unsigned char>& data);
-
-/// <summary>
-/// Encode the given 8-byte integer into a base64 string
-/// </summary>
-_ASYNCRTIMP utility::string_t __cdecl to_base64(uint64_t data);
-
-/// <summary>
-/// Decode the given base64 string to a byte array
-/// </summary>
-_ASYNCRTIMP std::vector<unsigned char> __cdecl from_base64(const utility::string_t& str);
-
-template<typename Source>
-CASABLANCA_DEPRECATED("All locale-sensitive APIs will be removed in a future update. Use stringstreams directly if "
-                      "locale support is required.")
-utility::string_t print_string(const Source& val, const std::locale& loc = std::locale())
-{
-    utility::ostringstream_t oss;
-    oss.imbue(loc);
-    oss << val;
-    if (oss.bad())
-    {
-        throw std::bad_cast();
-    }
-    return oss.str();
-}
-
-CASABLANCA_DEPRECATED("All locale-sensitive APIs will be removed in a future update. Use stringstreams directly if "
-                      "locale support is required.")
-inline utility::string_t print_string(const utility::string_t& val) { return val; }
-
-namespace details
-{
-#if defined(__ANDROID__)
-template<class T>
-inline std::string to_string(const T t)
-{
-    std::ostringstream os;
-    os.imbue(std::locale::classic());
-    os << t;
-    return os.str();
-}
-#endif
-
-template<class T>
-inline utility::string_t to_string_t(const T t)
-{
-#ifdef _UTF16_STRINGS
-    using std::to_wstring;
-    return to_wstring(t);
-#else
-#if !defined(__ANDROID__)
-    using std::to_string;
-#endif
-    return to_string(t);
-#endif
-}
-
-template<typename Source>
-utility::string_t print_string(const Source& val)
-{
-    utility::ostringstream_t oss;
-    oss.imbue(std::locale::classic());
-    oss << val;
-    if (oss.bad())
-    {
-        throw std::bad_cast();
-    }
-    return oss.str();
-}
-
-inline const utility::string_t& print_string(const utility::string_t& val) { return val; }
-
-template<typename Source>
-utf8string print_utf8string(const Source& val)
-{
-    return conversions::to_utf8string(print_string(val));
-}
-inline const utf8string& print_utf8string(const utf8string& val) { return val; }
-
-template<typename Target>
-Target scan_string(const utility::string_t& str)
-{
-    Target t;
-    utility::istringstream_t iss(str);
-    iss.imbue(std::locale::classic());
-    iss >> t;
-    if (iss.bad())
-    {
-        throw std::bad_cast();
-    }
-    return t;
-}
-
-inline const utility::string_t& scan_string(const utility::string_t& str) { return str; }
-} // namespace details
-
-template<typename Target>
-CASABLANCA_DEPRECATED("All locale-sensitive APIs will be removed in a future update. Use stringstreams directly if "
-                      "locale support is required.")
-Target scan_string(const utility::string_t& str, const std::locale& loc = std::locale())
-{
-    Target t;
-    utility::istringstream_t iss(str);
-    iss.imbue(loc);
-    iss >> t;
-    if (iss.bad())
-    {
-        throw std::bad_cast();
-    }
-    return t;
-}
-
-CASABLANCA_DEPRECATED("All locale-sensitive APIs will be removed in a future update. Use stringstreams directly if "
-                      "locale support is required.")
-inline utility::string_t scan_string(const utility::string_t& str) { return str; }
-} // namespace conversions
-
-namespace details
-{
-/// <summary>
-/// Cross platform RAII container for setting thread local locale.
-/// </summary>
-class scoped_c_thread_locale
-{
-public:
-    _ASYNCRTIMP scoped_c_thread_locale();
-    _ASYNCRTIMP ~scoped_c_thread_locale();
-
-#if !defined(ANDROID) && !defined(__ANDROID__) // CodePlex 269
-#ifdef _WIN32
-    typedef _locale_t xplat_locale;
-#else
-    typedef locale_t xplat_locale;
-#endif
-
-    static _ASYNCRTIMP xplat_locale __cdecl c_locale();
-#endif
-private:
-#ifdef _WIN32
-    std::string m_prevLocale;
-    int m_prevThreadSetting;
-#elif !(defined(ANDROID) || defined(__ANDROID__))
-    locale_t m_prevLocale;
-#endif
-    scoped_c_thread_locale(const scoped_c_thread_locale&);
-    scoped_c_thread_locale& operator=(const scoped_c_thread_locale&);
-};
-
-/// <summary>
-/// Our own implementation of alpha numeric instead of std::isalnum to avoid
-/// taking global lock for performance reasons.
-/// </summary>
-inline bool __cdecl is_alnum(const unsigned char uch) CPPREST_NOEXCEPT
-{ // test if uch is an alnum character
-    // special casing char to avoid branches
-    // clang-format off
-    static CPPREST_CONSTEXPR bool is_alnum_table[UCHAR_MAX + 1] = {
-        /*        X0 X1 X2 X3 X4 X5 X6 X7 X8 X9 XA XB XC XD XE XF */
-        /* 0X */   0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,
-        /* 1X */   0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,
-        /* 2X */   0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,
-        /* 3X */   1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 0, 0, 0, 0, 0, 0, /* 0-9 */
-        /* 4X */   0, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, /* A-Z */
-        /* 5X */   1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 0, 0, 0, 0, 0,
-        /* 6X */   0, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, /* a-z */
-        /* 7X */   1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 0, 0, 0, 0, 0
-        /* non-ASCII values initialized to 0 */
-    };
-    // clang-format on
-    return (is_alnum_table[uch]);
-}
-
-/// <summary>
-/// Our own implementation of alpha numeric instead of std::isalnum to avoid
-/// taking global lock for performance reasons.
-/// </summary>
-inline bool __cdecl is_alnum(const char ch) CPPREST_NOEXCEPT { return (is_alnum(static_cast<unsigned char>(ch))); }
-
-/// <summary>
-/// Our own implementation of alpha numeric instead of std::isalnum to avoid
-/// taking global lock for performance reasons.
-/// </summary>
-template<class Elem>
-inline bool __cdecl is_alnum(Elem ch) CPPREST_NOEXCEPT
-{
-    // assumes 'x' == L'x' for the ASCII range
-    typedef typename std::make_unsigned<Elem>::type UElem;
-    const auto uch = static_cast<UElem>(ch);
-    return (uch <= static_cast<UElem>('z') && is_alnum(static_cast<unsigned char>(uch)));
-}
-
-/// <summary>
-/// Simplistic implementation of make_unique. A better implementation would be based on variadic templates
-/// and therefore not be compatible with Dev10.
-/// </summary>
-template<typename _Type>
-std::unique_ptr<_Type> make_unique()
-{
-    return std::unique_ptr<_Type>(new _Type());
-}
-
-template<typename _Type, typename _Arg1>
-std::unique_ptr<_Type> make_unique(_Arg1&& arg1)
-{
-    return std::unique_ptr<_Type>(new _Type(std::forward<_Arg1>(arg1)));
-}
-
-template<typename _Type, typename _Arg1, typename _Arg2>
-std::unique_ptr<_Type> make_unique(_Arg1&& arg1, _Arg2&& arg2)
-{
-    return std::unique_ptr<_Type>(new _Type(std::forward<_Arg1>(arg1), std::forward<_Arg2>(arg2)));
-}
-
-template<typename _Type, typename _Arg1, typename _Arg2, typename _Arg3>
-std::unique_ptr<_Type> make_unique(_Arg1&& arg1, _Arg2&& arg2, _Arg3&& arg3)
-{
-    return std::unique_ptr<_Type>(
-        new _Type(std::forward<_Arg1>(arg1), std::forward<_Arg2>(arg2), std::forward<_Arg3>(arg3)));
-}
-
-template<typename _Type, typename _Arg1, typename _Arg2, typename _Arg3, typename _Arg4>
-std::unique_ptr<_Type> make_unique(_Arg1&& arg1, _Arg2&& arg2, _Arg3&& arg3, _Arg4&& arg4)
-{
-    return std::unique_ptr<_Type>(new _Type(
-        std::forward<_Arg1>(arg1), std::forward<_Arg2>(arg2), std::forward<_Arg3>(arg3), std::forward<_Arg4>(arg4)));
-}
-
-template<typename _Type, typename _Arg1, typename _Arg2, typename _Arg3, typename _Arg4, typename _Arg5>
-std::unique_ptr<_Type> make_unique(_Arg1&& arg1, _Arg2&& arg2, _Arg3&& arg3, _Arg4&& arg4, _Arg5&& arg5)
-{
-    return std::unique_ptr<_Type>(new _Type(std::forward<_Arg1>(arg1),
-                                            std::forward<_Arg2>(arg2),
-                                            std::forward<_Arg3>(arg3),
-                                            std::forward<_Arg4>(arg4),
-                                            std::forward<_Arg5>(arg5)));
-}
-
-template<typename _Type, typename _Arg1, typename _Arg2, typename _Arg3, typename _Arg4, typename _Arg5, typename _Arg6>
-std::unique_ptr<_Type> make_unique(_Arg1&& arg1, _Arg2&& arg2, _Arg3&& arg3, _Arg4&& arg4, _Arg5&& arg5, _Arg6&& arg6)
-{
-    return std::unique_ptr<_Type>(new _Type(std::forward<_Arg1>(arg1),
-                                            std::forward<_Arg2>(arg2),
-                                            std::forward<_Arg3>(arg3),
-                                            std::forward<_Arg4>(arg4),
-                                            std::forward<_Arg5>(arg5),
-                                            std::forward<_Arg6>(arg6)));
-}
-
-/// <summary>
-/// Cross platform utility function for performing case insensitive string equality comparison.
-/// </summary>
-/// <param name="left">First string to compare.</param>
-/// <param name="right">Second strong to compare.</param>
-/// <returns>true if the strings are equivalent, false otherwise</returns>
-_ASYNCRTIMP bool __cdecl str_iequal(const std::string& left, const std::string& right) CPPREST_NOEXCEPT;
-
-/// <summary>
-/// Cross platform utility function for performing case insensitive string equality comparison.
-/// </summary>
-/// <param name="left">First string to compare.</param>
-/// <param name="right">Second strong to compare.</param>
-/// <returns>true if the strings are equivalent, false otherwise</returns>
-_ASYNCRTIMP bool __cdecl str_iequal(const std::wstring& left, const std::wstring& right) CPPREST_NOEXCEPT;
-
-/// <summary>
-/// Cross platform utility function for performing case insensitive string less-than comparison.
-/// </summary>
-/// <param name="left">First string to compare.</param>
-/// <param name="right">Second strong to compare.</param>
-/// <returns>true if a lowercase view of left is lexicographically less than a lowercase view of right; otherwise,
-/// false.</returns>
-_ASYNCRTIMP bool __cdecl str_iless(const std::string& left, const std::string& right) CPPREST_NOEXCEPT;
-
-/// <summary>
-/// Cross platform utility function for performing case insensitive string less-than comparison.
-/// </summary>
-/// <param name="left">First string to compare.</param>
-/// <param name="right">Second strong to compare.</param>
-/// <returns>true if a lowercase view of left is lexicographically less than a lowercase view of right; otherwise,
-/// false.</returns>
-_ASYNCRTIMP bool __cdecl str_iless(const std::wstring& left, const std::wstring& right) CPPREST_NOEXCEPT;
-
-/// <summary>
-/// Convert a string to lowercase in place.
-/// </summary>
-/// <param name="target">The string to convert to lowercase.</param>
-_ASYNCRTIMP void __cdecl inplace_tolower(std::string& target) CPPREST_NOEXCEPT;
-
-/// <summary>
-/// Convert a string to lowercase in place.
-/// </summary>
-/// <param name="target">The string to convert to lowercase.</param>
-_ASYNCRTIMP void __cdecl inplace_tolower(std::wstring& target) CPPREST_NOEXCEPT;
-
-#ifdef _WIN32
-
-/// <summary>
-/// Category error type for Windows OS errors.
-/// </summary>
-class windows_category_impl : public std::error_category
-{
-public:
-    virtual const char* name() const CPPREST_NOEXCEPT { return "windows"; }
-
-    virtual std::string message(int errorCode) const CPPREST_NOEXCEPT;
-
-    virtual std::error_condition default_error_condition(int errorCode) const CPPREST_NOEXCEPT;
-};
-
-/// <summary>
-/// Gets the one global instance of the windows error category.
-/// </summary>
-/// </returns>An error category instance.</returns>
-_ASYNCRTIMP const std::error_category& __cdecl windows_category();
-
-#else
-
-/// <summary>
-/// Gets the one global instance of the linux error category.
-/// </summary>
-/// </returns>An error category instance.</returns>
-_ASYNCRTIMP const std::error_category& __cdecl linux_category();
-
-#endif
-
-/// <summary>
-/// Gets the one global instance of the current platform's error category.
-/// </summary>
-_ASYNCRTIMP const std::error_category& __cdecl platform_category();
-
-/// <summary>
-/// Creates an instance of std::system_error from a OS error code.
-/// </summary>
-inline std::system_error __cdecl create_system_error(unsigned long errorCode)
-{
-    std::error_code code((int)errorCode, platform_category());
-    return std::system_error(code, code.message());
-}
-
-/// <summary>
-/// Creates a std::error_code from a OS error code.
-/// </summary>
-inline std::error_code __cdecl create_error_code(unsigned long errorCode)
-{
-    return std::error_code((int)errorCode, platform_category());
-}
-
-/// <summary>
-/// Creates the corresponding error message from a OS error code.
-/// </summary>
-inline utility::string_t __cdecl create_error_message(unsigned long errorCode)
-{
-    return utility::conversions::to_string_t(create_error_code(errorCode).message());
-}
-
-} // namespace details
-
-class datetime
-{
-public:
-    typedef uint64_t interval_type;
-
-    /// <summary>
-    /// Defines the supported date and time string formats.
-    /// </summary>
-    enum date_format
-    {
-        RFC_1123,
-        ISO_8601
-    };
-
-    /// <summary>
-    /// Returns the current UTC time.
-    /// </summary>
-    static _ASYNCRTIMP datetime __cdecl utc_now();
-
-    /// <summary>
-    /// An invalid UTC timestamp value.
-    /// </summary>
-    enum : interval_type
-    {
-        utc_timestamp_invalid = static_cast<interval_type>(-1)
-    };
-
-    /// <summary>
-    /// Returns seconds since Unix/POSIX time epoch at 01-01-1970 00:00:00.
-    /// If time is before epoch, utc_timestamp_invalid is returned.
-    /// </summary>
-    static interval_type utc_timestamp()
-    {
-        const auto seconds = utc_now().to_interval() / _secondTicks;
-        if (seconds >= 11644473600LL)
-        {
-            return seconds - 11644473600LL;
-        }
-        else
-        {
-            return utc_timestamp_invalid;
-        }
-    }
-
-    datetime() : m_interval(0) {}
-
-    /// <summary>
-    /// Creates <c>datetime</c> from a string representing time in UTC in RFC 1123 format.
-    /// </summary>
-    /// <returns>Returns a <c>datetime</c> of zero if not successful.</returns>
-    static _ASYNCRTIMP datetime __cdecl from_string(const utility::string_t& timestring, date_format format = RFC_1123);
-
-    /// <summary>
-    /// Returns a string representation of the <c>datetime</c>.
-    /// </summary>
-    _ASYNCRTIMP utility::string_t to_string(date_format format = RFC_1123) const;
-
-    /// <summary>
-    /// Returns the integral time value.
-    /// </summary>
-    interval_type to_interval() const { return m_interval; }
-
-    datetime operator-(interval_type value) const { return datetime(m_interval - value); }
-
-    datetime operator+(interval_type value) const { return datetime(m_interval + value); }
-
-    bool operator==(datetime dt) const { return m_interval == dt.m_interval; }
-
-    bool operator!=(const datetime& dt) const { return !(*this == dt); }
-
-    static interval_type from_milliseconds(unsigned int milliseconds) { return milliseconds * _msTicks; }
-
-    static interval_type from_seconds(unsigned int seconds) { return seconds * _secondTicks; }
-
-    static interval_type from_minutes(unsigned int minutes) { return minutes * _minuteTicks; }
-
-    static interval_type from_hours(unsigned int hours) { return hours * _hourTicks; }
-
-    static interval_type from_days(unsigned int days) { return days * _dayTicks; }
-
-    bool is_initialized() const { return m_interval != 0; }
-
-private:
-    friend int operator-(datetime t1, datetime t2);
-
-    static const interval_type _msTicks = static_cast<interval_type>(10000);
-    static const interval_type _secondTicks = 1000 * _msTicks;
-    static const interval_type _minuteTicks = 60 * _secondTicks;
-    static const interval_type _hourTicks = 60 * 60 * _secondTicks;
-    static const interval_type _dayTicks = 24 * 60 * 60 * _secondTicks;
-
-    // Private constructor. Use static methods to create an instance.
-    datetime(interval_type interval) : m_interval(interval) {}
-
-    // Storing as hundreds of nanoseconds 10e-7, i.e. 1 here equals 100ns.
-    interval_type m_interval;
-};
-
-inline int operator-(datetime t1, datetime t2)
-{
-    auto diff = (t1.m_interval - t2.m_interval);
-
-    // Round it down to seconds
-    diff /= 10 * 1000 * 1000;
-
-    return static_cast<int>(diff);
-}
-
-/// <summary>
-/// Nonce string generator class.
-/// </summary>
-class nonce_generator
-{
-public:
-    /// <summary>
-    /// Define default nonce length.
-    /// </summary>
-    enum
-    {
-        default_length = 32
-    };
-
-    /// <summary>
-    /// Nonce generator constructor.
-    /// </summary>
-    /// <param name="length">Length of the generated nonce string.</param>
-    nonce_generator(int length = default_length)
-        : m_random(static_cast<unsigned int>(utility::datetime::utc_timestamp())), m_length(length)
-    {
-    }
-
-    /// <summary>
-    /// Generate a nonce string containing random alphanumeric characters (A-Za-z0-9).
-    /// Length of the generated string is set by length().
-    /// </summary>
-    /// <returns>The generated nonce string.</returns>
-    _ASYNCRTIMP utility::string_t generate();
-
-    /// <summary>
-    /// Get length of generated nonce string.
-    /// </summary>
-    /// <returns>Nonce string length.</returns>
-    int length() const { return m_length; }
-
-    /// <summary>
-    /// Set length of the generated nonce string.
-    /// </summary>
-    /// <param name="length">Lenght of nonce string.</param>
-    void set_length(int length) { m_length = length; }
-
-private:
-    std::mt19937 m_random;
-    int m_length;
-};
-
-} // namespace utility

deps/cpprestsdk/include/cpprest/base_uri.h

@@ -1,391 +0,0 @@
-/***
- * Copyright (C) Microsoft. All rights reserved.
- * Licensed under the MIT license. See LICENSE.txt file in the project root for full license information.
- *
- * =+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+
- *
- * Protocol independent support for URIs.
- *
- * For the latest on this and related APIs, please see: https://github.com/Microsoft/cpprestsdk
- *
- * =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
- ****/
-
-#pragma once
-
-#include "cpprest/asyncrt_utils.h"
-#include "cpprest/details/basic_types.h"
-#include <map>
-#include <string>
-#include <utility>
-#include <vector>
-
-namespace web
-{
-namespace details
-{
-struct uri_components
-{
-    uri_components() : m_path(_XPLATSTR("/")), m_port(-1) {}
-
-    uri_components(const uri_components&) = default;
-    uri_components& operator=(const uri_components&) = default;
-
-    // This is for VS2013 compatibility -- replace with '= default' when VS2013 is completely dropped.
-    uri_components(uri_components&& other) CPPREST_NOEXCEPT : m_scheme(std::move(other.m_scheme)),
-                                                              m_host(std::move(other.m_host)),
-                                                              m_user_info(std::move(other.m_user_info)),
-                                                              m_path(std::move(other.m_path)),
-                                                              m_query(std::move(other.m_query)),
-                                                              m_fragment(std::move(other.m_fragment)),
-                                                              m_port(other.m_port)
-    {
-    }
-
-    // This is for VS2013 compatibility -- replace with '= default' when VS2013 is completely dropped.
-    uri_components& operator=(uri_components&& other) CPPREST_NOEXCEPT
-    {
-        if (this != &other)
-        {
-            m_scheme = std::move(other.m_scheme);
-            m_host = std::move(other.m_host);
-            m_user_info = std::move(other.m_user_info);
-            m_path = std::move(other.m_path);
-            m_query = std::move(other.m_query);
-            m_fragment = std::move(other.m_fragment);
-            m_port = other.m_port;
-        }
-        return *this;
-    }
-
-    _ASYNCRTIMP utility::string_t join();
-
-    utility::string_t m_scheme;
-    utility::string_t m_host;
-    utility::string_t m_user_info;
-    utility::string_t m_path;
-    utility::string_t m_query;
-    utility::string_t m_fragment;
-    int m_port;
-};
-} // namespace details
-
-/// <summary>
-/// A single exception type to represent errors in parsing, encoding, and decoding URIs.
-/// </summary>
-class uri_exception : public std::exception
-{
-public:
-    uri_exception(std::string msg) : m_msg(std::move(msg)) {}
-
-    ~uri_exception() CPPREST_NOEXCEPT {}
-
-    const char* what() const CPPREST_NOEXCEPT { return m_msg.c_str(); }
-
-private:
-    std::string m_msg;
-};
-
-/// <summary>
-/// A flexible, protocol independent URI implementation.
-///
-/// URI instances are immutable. Querying the various fields on an empty URI will return empty strings. Querying
-/// various diagnostic members on an empty URI will return false.
-/// </summary>
-/// <remarks>
-/// This implementation accepts both URIs ('http://msn.com/path') and URI relative-references
-/// ('/path?query#frag').
-///
-/// This implementation does not provide any scheme-specific handling -- an example of this
-/// would be the following: 'http://path1/path'. This is a valid URI, but it's not a valid
-/// http-uri -- that is, it's syntactically correct but does not conform to the requirements
-/// of the http scheme (http requires a host).
-/// We could provide this by allowing a pluggable 'scheme' policy-class, which would provide
-/// extra capability for validating and canonicalizing a URI according to scheme, and would
-/// introduce a layer of type-safety for URIs of differing schemes, and thus differing semantics.
-///
-/// One issue with implementing a scheme-independent URI facility is that of comparing for equality.
-/// For instance, these URIs are considered equal 'http://msn.com', 'http://msn.com:80'. That is --
-/// the 'default' port can be either omitted or explicit. Since we don't have a way to map a scheme
-/// to it's default port, we don't have a way to know these are equal. This is just one of a class of
-/// issues with regard to scheme-specific behavior.
-/// </remarks>
-class uri
-{
-public:
-    /// <summary>
-    /// The various components of a URI. This enum is used to indicate which
-    /// URI component is being encoded to the encode_uri_component. This allows
-    /// specific encoding to be performed.
-    ///
-    /// Scheme and port don't allow '%' so they don't need to be encoded.
-    /// </summary>
-    class components
-    {
-    public:
-        enum component
-        {
-            user_info,
-            host,
-            path,
-            query,
-            fragment,
-            full_uri
-        };
-    };
-
-    /// <summary>
-    /// Encodes a URI component according to RFC 3986.
-    /// Note if a full URI is specified instead of an individual URI component all
-    /// characters not in the unreserved set are escaped.
-    /// </summary>
-    /// <param name="raw">The URI as a string.</param>
-    /// <returns>The encoded string.</returns>
-    _ASYNCRTIMP static utility::string_t __cdecl encode_uri(const utility::string_t& raw,
-                                                            uri::components::component = components::full_uri);
-
-    /// <summary>
-    /// Encodes a string by converting all characters except for RFC 3986 unreserved characters to their
-    /// hexadecimal representation.
-    /// </summary>
-    /// <returns>The encoded string.</returns>
-    _ASYNCRTIMP static utility::string_t __cdecl encode_data_string(const utility::string_t& data);
-
-    /// <summary>
-    /// Decodes an encoded string.
-    /// </summary>
-    /// <param name="encoded">The URI as a string.</param>
-    /// <returns>The decoded string.</returns>
-    _ASYNCRTIMP static utility::string_t __cdecl decode(const utility::string_t& encoded);
-
-    /// <summary>
-    /// Splits a path into its hierarchical components.
-    /// </summary>
-    /// <param name="path">The path as a string</param>
-    /// <returns>A <c>std::vector&lt;utility::string_t&gt;</c> containing the segments in the path.</returns>
-    _ASYNCRTIMP static std::vector<utility::string_t> __cdecl split_path(const utility::string_t& path);
-
-    /// <summary>
-    /// Splits a query into its key-value components.
-    /// </summary>
-    /// <param name="query">The query string</param>
-    /// <returns>A <c>std::map&lt;utility::string_t, utility::string_t&gt;</c> containing the key-value components of
-    /// the query.</returns>
-    _ASYNCRTIMP static std::map<utility::string_t, utility::string_t> __cdecl split_query(
-        const utility::string_t& query);
-
-    /// <summary>
-    /// Validates a string as a URI.
-    /// </summary>
-    /// <remarks>
-    /// This function accepts both uris ('http://msn.com') and uri relative-references ('path1/path2?query').
-    /// </remarks>
-    /// <param name="uri_string">The URI string to be validated.</param>
-    /// <returns><c>true</c> if the given string represents a valid URI, <c>false</c> otherwise.</returns>
-    _ASYNCRTIMP static bool __cdecl validate(const utility::string_t& uri_string);
-
-    /// <summary>
-    /// Creates an empty uri
-    /// </summary>
-    uri() : m_uri(_XPLATSTR("/")) {}
-
-    /// <summary>
-    /// Creates a URI from the given encoded string. This will throw an exception if the string
-    /// does not contain a valid URI. Use uri::validate if processing user-input.
-    /// </summary>
-    /// <param name="uri_string">A pointer to an encoded string to create the URI instance.</param>
-    _ASYNCRTIMP uri(const utility::char_t* uri_string);
-
-    /// <summary>
-    /// Creates a URI from the given encoded string. This will throw an exception if the string
-    /// does not contain a valid URI. Use uri::validate if processing user-input.
-    /// </summary>
-    /// <param name="uri_string">An encoded URI string to create the URI instance.</param>
-    _ASYNCRTIMP uri(const utility::string_t& uri_string);
-
-    /// <summary>
-    /// Copy constructor.
-    /// </summary>
-    uri(const uri&) = default;
-
-    /// <summary>
-    /// Copy assignment operator.
-    /// </summary>
-    uri& operator=(const uri&) = default;
-
-    /// <summary>
-    /// Move constructor.
-    /// </summary>
-    // This is for VS2013 compatibility -- replace with '= default' when VS2013 is completely dropped.
-    uri(uri&& other) CPPREST_NOEXCEPT : m_uri(std::move(other.m_uri)), m_components(std::move(other.m_components)) {}
-
-    /// <summary>
-    /// Move assignment operator
-    /// </summary>
-    // This is for VS2013 compatibility -- replace with '= default' when VS2013 is completely dropped.
-    uri& operator=(uri&& other) CPPREST_NOEXCEPT
-    {
-        if (this != &other)
-        {
-            m_uri = std::move(other.m_uri);
-            m_components = std::move(other.m_components);
-        }
-        return *this;
-    }
-
-    /// <summary>
-    /// Get the scheme component of the URI as an encoded string.
-    /// </summary>
-    /// <returns>The URI scheme as a string.</returns>
-    const utility::string_t& scheme() const { return m_components.m_scheme; }
-
-    /// <summary>
-    /// Get the user information component of the URI as an encoded string.
-    /// </summary>
-    /// <returns>The URI user information as a string.</returns>
-    const utility::string_t& user_info() const { return m_components.m_user_info; }
-
-    /// <summary>
-    /// Get the host component of the URI as an encoded string.
-    /// </summary>
-    /// <returns>The URI host as a string.</returns>
-    const utility::string_t& host() const { return m_components.m_host; }
-
-    /// <summary>
-    /// Get the port component of the URI. Returns -1 if no port is specified.
-    /// </summary>
-    /// <returns>The URI port as an integer.</returns>
-    int port() const { return m_components.m_port; }
-
-    /// <summary>
-    /// Get the path component of the URI as an encoded string.
-    /// </summary>
-    /// <returns>The URI path as a string.</returns>
-    const utility::string_t& path() const { return m_components.m_path; }
-
-    /// <summary>
-    /// Get the query component of the URI as an encoded string.
-    /// </summary>
-    /// <returns>The URI query as a string.</returns>
-    const utility::string_t& query() const { return m_components.m_query; }
-
-    /// <summary>
-    /// Get the fragment component of the URI as an encoded string.
-    /// </summary>
-    /// <returns>The URI fragment as a string.</returns>
-    const utility::string_t& fragment() const { return m_components.m_fragment; }
-
-    /// <summary>
-    /// Creates a new uri object with the same authority portion as this one, omitting the resource and query portions.
-    /// </summary>
-    /// <returns>The new uri object with the same authority.</returns>
-    _ASYNCRTIMP uri authority() const;
-
-    /// <summary>
-    /// Gets the path, query, and fragment portion of this uri, which may be empty.
-    /// </summary>
-    /// <returns>The new URI object with the path, query and fragment portion of this URI.</returns>
-    _ASYNCRTIMP uri resource() const;
-
-    /// <summary>
-    /// An empty URI specifies no components, and serves as a default value
-    /// </summary>
-    bool is_empty() const { return this->m_uri.empty() || this->m_uri == _XPLATSTR("/"); }
-
-    /// <summary>
-    /// A loopback URI is one which refers to a hostname or ip address with meaning only on the local machine.
-    /// </summary>
-    /// <remarks>
-    /// Examples include "localhost", or ip addresses in the loopback range (127.0.0.0/24).
-    /// </remarks>
-    /// <returns><c>true</c> if this URI references the local host, <c>false</c> otherwise.</returns>
-    bool is_host_loopback() const
-    {
-        return !is_empty() &&
-               ((host() == _XPLATSTR("localhost")) || (host().size() > 4 && host().substr(0, 4) == _XPLATSTR("127.")));
-    }
-
-    /// <summary>
-    /// A wildcard URI is one which refers to all hostnames that resolve to the local machine (using the * or +)
-    /// </summary>
-    /// <example>
-    /// http://*:80
-    /// </example>
-    bool is_host_wildcard() const
-    {
-        return !is_empty() && (this->host() == _XPLATSTR("*") || this->host() == _XPLATSTR("+"));
-    }
-
-    /// <summary>
-    /// A portable URI is one with a hostname that can be resolved globally (used from another machine).
-    /// </summary>
-    /// <returns><c>true</c> if this URI can be resolved globally (used from another machine), <c>false</c>
-    /// otherwise.</returns> <remarks> The hostname "localhost" is a reserved name that is guaranteed to resolve to the
-    /// local machine, and cannot be used for inter-machine communication. Likewise the hostnames "*" and "+" on Windows
-    /// represent wildcards, and do not map to a resolvable address.
-    /// </remarks>
-    bool is_host_portable() const { return !(is_empty() || is_host_loopback() || is_host_wildcard()); }
-
-    /// <summary>
-    /// A default port is one where the port is unspecified, and will be determined by the operating system.
-    /// The choice of default port may be dictated by the scheme (http -> 80) or not.
-    /// </summary>
-    /// <returns><c>true</c> if this URI instance has a default port, <c>false</c> otherwise.</returns>
-    bool is_port_default() const { return !is_empty() && this->port() == 0; }
-
-    /// <summary>
-    /// An "authority" URI is one with only a scheme, optional userinfo, hostname, and (optional) port.
-    /// </summary>
-    /// <returns><c>true</c> if this is an "authority" URI, <c>false</c> otherwise.</returns>
-    bool is_authority() const { return !is_empty() && is_path_empty() && query().empty() && fragment().empty(); }
-
-    /// <summary>
-    /// Returns whether the other URI has the same authority as this one
-    /// </summary>
-    /// <param name="other">The URI to compare the authority with.</param>
-    /// <returns><c>true</c> if both the URI's have the same authority, <c>false</c> otherwise.</returns>
-    bool has_same_authority(const uri& other) const { return !is_empty() && this->authority() == other.authority(); }
-
-    /// <summary>
-    /// Returns whether the path portion of this URI is empty
-    /// </summary>
-    /// <returns><c>true</c> if the path portion of this URI is empty, <c>false</c> otherwise.</returns>
-    bool is_path_empty() const { return path().empty() || path() == _XPLATSTR("/"); }
-
-    /// <summary>
-    /// Returns the full (encoded) URI as a string.
-    /// </summary>
-    /// <returns>The full encoded URI string.</returns>
-    utility::string_t to_string() const { return m_uri; }
-
-    /// <summary>
-    /// Returns an URI resolved against <c>this</c> as the base URI
-    /// according to RFC3986, Section 5 (https://tools.ietf.org/html/rfc3986#section-5).
-    /// </summary>
-    /// <param name="relativeUri">The relative URI to be resolved against <c>this</c> as base.</param>
-    /// <returns>The new resolved URI string.</returns>
-    _ASYNCRTIMP utility::string_t resolve_uri(const utility::string_t& relativeUri) const;
-
-    _ASYNCRTIMP bool operator==(const uri& other) const;
-
-    bool operator<(const uri& other) const { return m_uri < other.m_uri; }
-
-    bool operator!=(const uri& other) const { return !(this->operator==(other)); }
-
-private:
-    friend class uri_builder;
-
-    /// <summary>
-    /// Creates a URI from the given URI components.
-    /// </summary>
-    /// <param name="components">A URI components object to create the URI instance.</param>
-    _ASYNCRTIMP uri(const details::uri_components& components);
-
-    // Used by uri_builder
-    static utility::string_t __cdecl encode_query_impl(const utf8string& raw);
-
-    utility::string_t m_uri;
-    details::uri_components m_components;
-};
-
-} // namespace web

deps/cpprestsdk/include/cpprest/details/basic_types.h

@@ -1,131 +0,0 @@
-/***
- * Copyright (C) Microsoft. All rights reserved.
- * Licensed under the MIT license. See LICENSE.txt file in the project root for full license information.
- *
- * =+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+
- *
- * Platform-dependent type definitions
- *
- * For the latest on this and related APIs, please see: https://github.com/Microsoft/cpprestsdk
- *
- * =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
- ****/
-
-#pragma once
-
-#include "cpprest/details/cpprest_compat.h"
-#include <fstream>
-#include <iostream>
-#include <sstream>
-#include <string>
-
-#ifndef _WIN32
-#ifndef __STDC_LIMIT_MACROS
-#define __STDC_LIMIT_MACROS
-#endif
-#include <stdint.h>
-#else
-#include <cstdint>
-#endif
-
-#include "cpprest/details/SafeInt3.hpp"
-
-namespace utility
-{
-#ifdef _WIN32
-#define _UTF16_STRINGS
-#endif
-
-// We should be using a 64-bit size type for most situations that do
-// not involve specifying the size of a memory allocation or buffer.
-typedef uint64_t size64_t;
-
-#ifndef _WIN32
-typedef uint32_t HRESULT; // Needed for PPLX
-#endif
-
-#ifdef _UTF16_STRINGS
-//
-// On Windows, all strings are wide
-//
-typedef wchar_t char_t;
-typedef std::wstring string_t;
-#define _XPLATSTR(x) L##x
-typedef std::wostringstream ostringstream_t;
-typedef std::wofstream ofstream_t;
-typedef std::wostream ostream_t;
-typedef std::wistream istream_t;
-typedef std::wifstream ifstream_t;
-typedef std::wistringstream istringstream_t;
-typedef std::wstringstream stringstream_t;
-#define ucout std::wcout
-#define ucin std::wcin
-#define ucerr std::wcerr
-#else
-//
-// On POSIX platforms, all strings are narrow
-//
-typedef char char_t;
-typedef std::string string_t;
-#define _XPLATSTR(x) x
-typedef std::ostringstream ostringstream_t;
-typedef std::ofstream ofstream_t;
-typedef std::ostream ostream_t;
-typedef std::istream istream_t;
-typedef std::ifstream ifstream_t;
-typedef std::istringstream istringstream_t;
-typedef std::stringstream stringstream_t;
-#define ucout std::cout
-#define ucin std::cin
-#define ucerr std::cerr
-#endif // endif _UTF16_STRINGS
-
-#ifndef _TURN_OFF_PLATFORM_STRING
-// The 'U' macro can be used to create a string or character literal of the platform type, i.e. utility::char_t.
-// If you are using a library causing conflicts with 'U' macro, it can be turned off by defining the macro
-// '_TURN_OFF_PLATFORM_STRING' before including the C++ REST SDK header files, and e.g. use '_XPLATSTR' instead.
-#define U(x) _XPLATSTR(x)
-#endif // !_TURN_OFF_PLATFORM_STRING
-
-} // namespace utility
-
-typedef char utf8char;
-typedef std::string utf8string;
-typedef std::stringstream utf8stringstream;
-typedef std::ostringstream utf8ostringstream;
-typedef std::ostream utf8ostream;
-typedef std::istream utf8istream;
-typedef std::istringstream utf8istringstream;
-
-#ifdef _UTF16_STRINGS
-typedef wchar_t utf16char;
-typedef std::wstring utf16string;
-typedef std::wstringstream utf16stringstream;
-typedef std::wostringstream utf16ostringstream;
-typedef std::wostream utf16ostream;
-typedef std::wistream utf16istream;
-typedef std::wistringstream utf16istringstream;
-#else
-typedef char16_t utf16char;
-typedef std::u16string utf16string;
-typedef std::basic_stringstream<utf16char> utf16stringstream;
-typedef std::basic_ostringstream<utf16char> utf16ostringstream;
-typedef std::basic_ostream<utf16char> utf16ostream;
-typedef std::basic_istream<utf16char> utf16istream;
-typedef std::basic_istringstream<utf16char> utf16istringstream;
-#endif
-
-#if defined(_WIN32)
-// Include on everything except Windows Desktop ARM, unless explicitly excluded.
-#if !defined(CPPREST_EXCLUDE_WEBSOCKETS)
-#if defined(WINAPI_FAMILY)
-#if WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP) && defined(_M_ARM)
-#define CPPREST_EXCLUDE_WEBSOCKETS
-#endif
-#else
-#if defined(_M_ARM)
-#define CPPREST_EXCLUDE_WEBSOCKETS
-#endif
-#endif
-#endif
-#endif

deps/cpprestsdk/include/cpprest/details/cpprest_compat.h

@@ -1,91 +0,0 @@
-/***
- * Copyright (C) Microsoft. All rights reserved.
- * Licensed under the MIT license. See LICENSE.txt file in the project root for full license information.
- *
- * =+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+
- *
- * Standard macros and definitions.
- * This header has minimal dependency on windows headers and is safe for use in the public API
- *
- * For the latest on this and related APIs, please see: https://github.com/Microsoft/cpprestsdk
- *
- * =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
- ****/
-
-#pragma once
-
-#if defined(_WIN32)
-
-#if _MSC_VER >= 1900
-#define CPPREST_NOEXCEPT noexcept
-#define CPPREST_CONSTEXPR constexpr
-#else
-#define CPPREST_NOEXCEPT
-#define CPPREST_CONSTEXPR const
-#endif // _MSC_VER >= 1900
-
-#define CASABLANCA_UNREFERENCED_PARAMETER(x) (x)
-
-#include <sal.h>
-
-#else // ^^^ _WIN32 ^^^ // vvv !_WIN32 vvv
-
-#define __declspec(x) __attribute__((x))
-#define dllimport
-#define novtable /* no novtable equivalent */
-#define __assume(x)                                                                                                    \
-    do                                                                                                                 \
-    {                                                                                                                  \
-        if (!(x)) __builtin_unreachable();                                                                             \
-    } while (false)
-#define CASABLANCA_UNREFERENCED_PARAMETER(x) (void)x
-#define CPPREST_NOEXCEPT noexcept
-#define CPPREST_CONSTEXPR constexpr
-
-#include <assert.h>
-#define _ASSERTE(x) assert(x)
-
-// No SAL on non Windows platforms
-#include "cpprest/details/nosal.h"
-
-#if !defined(__cdecl)
-#if defined(cdecl)
-#define __cdecl __attribute__((cdecl))
-#else // ^^^ defined cdecl ^^^ // vvv !defined cdecl vvv
-#define __cdecl
-#endif // defined cdecl
-#endif // not defined __cdecl
-
-#if defined(__ANDROID__)
-// This is needed to disable the use of __thread inside the boost library.
-// Android does not support thread local storage -- if boost is included
-// without this macro defined, it will create references to __tls_get_addr
-// which (while able to link) will not be available at runtime and prevent
-// the .so from loading.
-#if not defined BOOST_ASIO_DISABLE_THREAD_KEYWORD_EXTENSION
-#define BOOST_ASIO_DISABLE_THREAD_KEYWORD_EXTENSION
-#endif // not defined BOOST_ASIO_DISABLE_THREAD_KEYWORD_EXTENSION
-#endif // defined(__ANDROID__)
-
-#ifdef __clang__
-#include <cstdio>
-#endif // __clang__
-#endif // _WIN32
-
-#define _NO_ASYNCRTIMP
-
-#ifdef _NO_ASYNCRTIMP
-#define _ASYNCRTIMP
-#else // ^^^ _NO_ASYNCRTIMP ^^^ // vvv !_NO_ASYNCRTIMP vvv
-#ifdef _ASYNCRT_EXPORT
-#define _ASYNCRTIMP __declspec(dllexport)
-#else // ^^^ _ASYNCRT_EXPORT ^^^ // vvv !_ASYNCRT_EXPORT vvv
-#define _ASYNCRTIMP __declspec(dllimport)
-#endif // _ASYNCRT_EXPORT
-#endif // _NO_ASYNCRTIMP
-
-#ifdef CASABLANCA_DEPRECATION_NO_WARNINGS
-#define CASABLANCA_DEPRECATED(x)
-#else
-#define CASABLANCA_DEPRECATED(x) __declspec(deprecated(x))
-#endif // CASABLANCA_DEPRECATION_NO_WARNINGS

deps/cpprestsdk/include/cpprest/details/web_utilities.h

@@ -1,223 +0,0 @@
-/***
- * Copyright (C) Microsoft. All rights reserved.
- * Licensed under the MIT license. See LICENSE.txt file in the project root for full license information.
- *
- * =+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+
- *
- * utility classes used by the different web:: clients
- *
- * =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
- ****/
-#pragma once
-
-#include "cpprest/asyncrt_utils.h"
-#include "cpprest/uri.h"
-
-namespace web
-{
-namespace details
-{
-class zero_memory_deleter
-{
-public:
-    _ASYNCRTIMP void operator()(::utility::string_t* data) const;
-};
-typedef std::unique_ptr<::utility::string_t, zero_memory_deleter> plaintext_string;
-
-#if defined(_WIN32) && !defined(CPPREST_TARGET_XP)
-#if defined(__cplusplus_winrt)
-class winrt_encryption
-{
-public:
-    winrt_encryption() {}
-    _ASYNCRTIMP winrt_encryption(const std::wstring& data);
-    _ASYNCRTIMP plaintext_string decrypt() const;
-
-private:
-    ::pplx::task<Windows::Storage::Streams::IBuffer ^> m_buffer;
-};
-#else
-class win32_encryption
-{
-public:
-    win32_encryption() {}
-    _ASYNCRTIMP win32_encryption(const std::wstring& data);
-    _ASYNCRTIMP ~win32_encryption();
-    _ASYNCRTIMP plaintext_string decrypt() const;
-
-private:
-    std::vector<char> m_buffer;
-    size_t m_numCharacters;
-};
-#endif
-#endif
-} // namespace details
-
-/// <summary>
-/// Represents a set of user credentials (user name and password) to be used
-/// for authentication.
-/// </summary>
-class credentials
-{
-public:
-    /// <summary>
-    /// Constructs an empty set of credentials without a user name or password.
-    /// </summary>
-    credentials() {}
-
-    /// <summary>
-    /// Constructs credentials from given user name and password.
-    /// </summary>
-    /// <param name="username">User name as a string.</param>
-    /// <param name="password">Password as a string.</param>
-    credentials(utility::string_t username, const utility::string_t& password)
-        : m_username(std::move(username)), m_password(password)
-    {
-    }
-
-    /// <summary>
-    /// The user name associated with the credentials.
-    /// </summary>
-    /// <returns>A string containing the user name.</returns>
-    const utility::string_t& username() const { return m_username; }
-
-    /// <summary>
-    /// The password for the user name associated with the credentials.
-    /// </summary>
-    /// <returns>A string containing the password.</returns>
-    CASABLANCA_DEPRECATED(
-        "This API is deprecated for security reasons to avoid unnecessary password copies stored in plaintext.")
-    utility::string_t password() const
-    {
-#if defined(_WIN32) && !defined(CPPREST_TARGET_XP)
-        return utility::string_t(*m_password.decrypt());
-#else
-        return m_password;
-#endif
-    }
-
-    /// <summary>
-    /// Checks if credentials have been set
-    /// </summary>
-    /// <returns><c>true</c> if user name and password is set, <c>false</c> otherwise.</returns>
-    bool is_set() const { return !m_username.empty(); }
-
-    details::plaintext_string _internal_decrypt() const
-    {
-        // Encryption APIs not supported on XP
-#if defined(_WIN32) && !defined(CPPREST_TARGET_XP)
-        return m_password.decrypt();
-#else
-        return details::plaintext_string(new ::utility::string_t(m_password));
-#endif
-    }
-
-private:
-    ::utility::string_t m_username;
-
-#if defined(_WIN32) && !defined(CPPREST_TARGET_XP)
-#if defined(__cplusplus_winrt)
-    details::winrt_encryption m_password;
-#else
-    details::win32_encryption m_password;
-#endif
-#else
-    ::utility::string_t m_password;
-#endif
-};
-
-/// <summary>
-/// web_proxy represents the concept of the web proxy, which can be auto-discovered,
-/// disabled, or specified explicitly by the user.
-/// </summary>
-class web_proxy
-{
-    enum web_proxy_mode_internal
-    {
-        use_default_,
-        use_auto_discovery_,
-        disabled_,
-        user_provided_
-    };
-
-public:
-    enum web_proxy_mode
-    {
-        use_default = use_default_,
-        use_auto_discovery = use_auto_discovery_,
-        disabled = disabled_
-    };
-
-    /// <summary>
-    /// Constructs a proxy with the default settings.
-    /// </summary>
-    web_proxy() : m_address(_XPLATSTR("")), m_mode(use_default_) {}
-
-    /// <summary>
-    /// Creates a proxy with specified mode.
-    /// </summary>
-    /// <param name="mode">Mode to use.</param>
-    web_proxy(web_proxy_mode mode) : m_address(_XPLATSTR("")), m_mode(static_cast<web_proxy_mode_internal>(mode)) {}
-
-    /// <summary>
-    /// Creates a proxy explicitly with provided address.
-    /// </summary>
-    /// <param name="address">Proxy URI to use.</param>
-    web_proxy(uri address) : m_address(address), m_mode(user_provided_) {}
-
-    /// <summary>
-    /// Gets this proxy's URI address. Returns an empty URI if not explicitly set by user.
-    /// </summary>
-    /// <returns>A reference to this proxy's URI.</returns>
-    const uri& address() const { return m_address; }
-
-    /// <summary>
-    /// Gets the credentials used for authentication with this proxy.
-    /// </summary>
-    /// <returns>Credentials to for this proxy.</returns>
-    const web::credentials& credentials() const { return m_credentials; }
-
-    /// <summary>
-    /// Sets the credentials to use for authentication with this proxy.
-    /// </summary>
-    /// <param name="cred">Credentials to use for this proxy.</param>
-    void set_credentials(web::credentials cred)
-    {
-        if (m_mode == disabled_)
-        {
-            throw std::invalid_argument("Cannot attach credentials to a disabled proxy");
-        }
-        m_credentials = std::move(cred);
-    }
-
-    /// <summary>
-    /// Checks if this proxy was constructed with default settings.
-    /// </summary>
-    /// <returns>True if default, false otherwise.</param>
-    bool is_default() const { return m_mode == use_default_; }
-
-    /// <summary>
-    /// Checks if using a proxy is disabled.
-    /// </summary>
-    /// <returns>True if disabled, false otherwise.</returns>
-    bool is_disabled() const { return m_mode == disabled_; }
-
-    /// <summary>
-    /// Checks if the auto discovery protocol, WPAD, is to be used.
-    /// </summary>
-    /// <returns>True if auto discovery enabled, false otherwise.</returns>
-    bool is_auto_discovery() const { return m_mode == use_auto_discovery_; }
-
-    /// <summary>
-    /// Checks if a proxy address is explicitly specified by the user.
-    /// </summary>
-    /// <returns>True if a proxy address was explicitly specified, false otherwise.</returns>
-    bool is_specified() const { return m_mode == user_provided_; }
-
-private:
-    web::uri m_address;
-    web_proxy_mode_internal m_mode;
-    web::credentials m_credentials;
-};
-
-} // namespace web

deps/cpprestsdk/include/cpprest/uri.h

@@ -1,21 +0,0 @@
-/***
- * Copyright (C) Microsoft. All rights reserved.
- * Licensed under the MIT license. See LICENSE.txt file in the project root for full license information.
- *
- * =+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+
- *
- * Protocol independent support for URIs.
- *
- * For the latest on this and related APIs, please see: https://github.com/Microsoft/cpprestsdk
- *
- * =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
- ****/
-#pragma once
-
-#ifndef CASA_URI_H
-#define CASA_URI_H
-
-#include "cpprest/base_uri.h"
-#include "cpprest/uri_builder.h"
-
-#endif

deps/cpprestsdk/include/cpprest/uri_builder.h

@@ -1,295 +0,0 @@
-/***
- * Copyright (C) Microsoft. All rights reserved.
- * Licensed under the MIT license. See LICENSE.txt file in the project root for full license information.
- *
- * =+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+
- *
- * Builder style class for creating URIs.
- *
- * For the latest on this and related APIs, please see: https://github.com/Microsoft/cpprestsdk
- *
- * =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
- ****/
-
-#pragma once
-
-#include "cpprest/base_uri.h"
-#include <string>
-
-namespace web
-{
-/// <summary>
-/// Builder for constructing URIs incrementally.
-/// </summary>
-class uri_builder
-{
-public:
-    /// <summary>
-    /// Creates a builder with an initially empty URI.
-    /// </summary>
-    uri_builder() = default;
-
-    /// <summary>
-    /// Creates a builder with a existing URI object.
-    /// </summary>
-    /// <param name="uri_str">Encoded string containing the URI.</param>
-    uri_builder(const uri& uri_str) : m_uri(uri_str.m_components) {}
-
-    /// <summary>
-    /// Get the scheme component of the URI as an encoded string.
-    /// </summary>
-    /// <returns>The URI scheme as a string.</returns>
-    const utility::string_t& scheme() const { return m_uri.m_scheme; }
-
-    /// <summary>
-    /// Get the user information component of the URI as an encoded string.
-    /// </summary>
-    /// <returns>The URI user information as a string.</returns>
-    const utility::string_t& user_info() const { return m_uri.m_user_info; }
-
-    /// <summary>
-    /// Get the host component of the URI as an encoded string.
-    /// </summary>
-    /// <returns>The URI host as a string.</returns>
-    const utility::string_t& host() const { return m_uri.m_host; }
-
-    /// <summary>
-    /// Get the port component of the URI. Returns -1 if no port is specified.
-    /// </summary>
-    /// <returns>The URI port as an integer.</returns>
-    int port() const { return m_uri.m_port; }
-
-    /// <summary>
-    /// Get the path component of the URI as an encoded string.
-    /// </summary>
-    /// <returns>The URI path as a string.</returns>
-    const utility::string_t& path() const { return m_uri.m_path; }
-
-    /// <summary>
-    /// Get the query component of the URI as an encoded string.
-    /// </summary>
-    /// <returns>The URI query as a string.</returns>
-    const utility::string_t& query() const { return m_uri.m_query; }
-
-    /// <summary>
-    /// Get the fragment component of the URI as an encoded string.
-    /// </summary>
-    /// <returns>The URI fragment as a string.</returns>
-    const utility::string_t& fragment() const { return m_uri.m_fragment; }
-
-    /// <summary>
-    /// Set the scheme of the URI.
-    /// </summary>
-    /// <param name="scheme">Uri scheme.</param>
-    /// <returns>A reference to this <c>uri_builder</c> to support chaining.</returns>
-    uri_builder& set_scheme(const utility::string_t& scheme)
-    {
-        m_uri.m_scheme = scheme;
-        return *this;
-    }
-
-    /// <summary>
-    /// Set the user info component of the URI.
-    /// </summary>
-    /// <param name="user_info">User info as a decoded string.</param>
-    /// <param name="do_encoding">Specify whether to apply URI encoding to the given string.</param>
-    /// <returns>A reference to this <c>uri_builder</c> to support chaining.</returns>
-    uri_builder& set_user_info(const utility::string_t& user_info, bool do_encoding = false)
-    {
-        if (do_encoding)
-        {
-            m_uri.m_user_info = uri::encode_uri(user_info, uri::components::user_info);
-        }
-        else
-        {
-            m_uri.m_user_info = user_info;
-        }
-
-        return *this;
-    }
-
-    /// <summary>
-    /// Set the host component of the URI.
-    /// </summary>
-    /// <param name="host">Host as a decoded string.</param>
-    /// <param name="do_encoding">Specify whether to apply URI encoding to the given string.</param>
-    /// <returns>A reference to this <c>uri_builder</c> to support chaining.</returns>
-    uri_builder& set_host(const utility::string_t& host, bool do_encoding = false)
-    {
-        if (do_encoding)
-        {
-            m_uri.m_host = uri::encode_uri(host, uri::components::host);
-        }
-        else
-        {
-            m_uri.m_host = host;
-        }
-
-        return *this;
-    }
-
-    /// <summary>
-    /// Set the port component of the URI.
-    /// </summary>
-    /// <param name="port">Port as an integer.</param>
-    /// <returns>A reference to this <c>uri_builder</c> to support chaining.</returns>
-    uri_builder& set_port(int port)
-    {
-        m_uri.m_port = port;
-        return *this;
-    }
-
-    /// <summary>
-    /// Set the port component of the URI.
-    /// </summary>
-    /// <param name="port">Port as a string.</param>
-    /// <returns>A reference to this <c>uri_builder</c> to support chaining.</returns>
-    /// <remarks>When string can't be converted to an integer the port is left unchanged.</remarks>
-    _ASYNCRTIMP uri_builder& set_port(const utility::string_t& port);
-
-    /// <summary>
-    /// Set the path component of the URI.
-    /// </summary>
-    /// <param name="path">Path as a decoded string.</param>
-    /// <param name="do_encoding">Specify whether to apply URI encoding to the given string.</param>
-    /// <returns>A reference to this <c>uri_builder</c> to support chaining.</returns>
-    uri_builder& set_path(const utility::string_t& path, bool do_encoding = false)
-    {
-        if (do_encoding)
-        {
-            m_uri.m_path = uri::encode_uri(path, uri::components::path);
-        }
-        else
-        {
-            m_uri.m_path = path;
-        }
-
-        return *this;
-    }
-
-    /// <summary>
-    /// Set the query component of the URI.
-    /// </summary>
-    /// <param name="query">Query as a decoded string.</param>
-    /// <param name="do_encoding">Specify whether apply URI encoding to the given string.</param>
-    /// <returns>A reference to this <c>uri_builder</c> to support chaining.</returns>
-    uri_builder& set_query(const utility::string_t& query, bool do_encoding = false)
-    {
-        if (do_encoding)
-        {
-            m_uri.m_query = uri::encode_uri(query, uri::components::query);
-        }
-        else
-        {
-            m_uri.m_query = query;
-        }
-
-        return *this;
-    }
-
-    /// <summary>
-    /// Set the fragment component of the URI.
-    /// </summary>
-    /// <param name="fragment">Fragment as a decoded string.</param>
-    /// <param name="do_encoding">Specify whether to apply URI encoding to the given string.</param>
-    /// <returns>A reference to this <c>uri_builder</c> to support chaining.</returns>
-    uri_builder& set_fragment(const utility::string_t& fragment, bool do_encoding = false)
-    {
-        if (do_encoding)
-        {
-            m_uri.m_fragment = uri::encode_uri(fragment, uri::components::fragment);
-        }
-        else
-        {
-            m_uri.m_fragment = fragment;
-        }
-
-        return *this;
-    }
-
-    /// <summary>
-    /// Clears all components of the underlying URI in this uri_builder.
-    /// </summary>
-    void clear() { m_uri = details::uri_components(); }
-
-    /// <summary>
-    /// Appends another path to the path of this uri_builder.
-    /// </summary>
-    /// <param name="path">Path to append as a already encoded string.</param>
-    /// <param name="do_encoding">Specify whether to apply URI encoding to the given string.</param>
-    /// <returns>A reference to this uri_builder to support chaining.</returns>
-    _ASYNCRTIMP uri_builder& append_path(const utility::string_t& path, bool do_encoding = false);
-
-    /// <summary>
-    /// Appends the raw contents of the path argument to the path of this uri_builder with no separator de-duplication.
-    /// </summary>
-    /// <remarks>
-    /// The path argument is appended after adding a '/' separator without regards to the contents of path. If an empty
-    /// string is provided, this function will immediately return without changes to the stored path value. For example:
-    /// if the current contents are "/abc" and path="/xyz", the result will be "/abc//xyz".
-    /// </remarks>
-    /// <param name="path">Path to append as a already encoded string.</param>
-    /// <param name="do_encoding">Specify whether to apply URI encoding to the given string.</param>
-    /// <returns>A reference to this uri_builder to support chaining.</returns>
-    _ASYNCRTIMP uri_builder& append_path_raw(const utility::string_t& path, bool do_encoding = false);
-
-    /// <summary>
-    /// Appends another query to the query of this uri_builder.
-    /// </summary>
-    /// <param name="query">Query to append as a decoded string.</param>
-    /// <param name="do_encoding">Specify whether to apply URI encoding to the given string.</param>
-    /// <returns>A reference to this uri_builder to support chaining.</returns>
-    _ASYNCRTIMP uri_builder& append_query(const utility::string_t& query, bool do_encoding = false);
-
-    /// <summary>
-    /// Appends an relative uri (Path, Query and fragment) at the end of the current uri.
-    /// </summary>
-    /// <param name="relative_uri">The relative uri to append.</param>
-    /// <returns>A reference to this uri_builder to support chaining.</returns>
-    _ASYNCRTIMP uri_builder& append(const uri& relative_uri);
-
-    /// <summary>
-    /// Appends another query to the query of this uri_builder, encoding it first. This overload is useful when building
-    /// a query segment of the form "element=10", where the right hand side of the query is stored as a type other than
-    /// a string, for instance, an integral type.
-    /// </summary>
-    /// <param name="name">The name portion of the query string</param>
-    /// <param name="value">The value portion of the query string</param>
-    /// <returns>A reference to this uri_builder to support chaining.</returns>
-    template<typename T>
-    uri_builder& append_query(const utility::string_t& name, const T& value, bool do_encoding = true)
-    {
-        if (do_encoding)
-            append_query_encode_impl(name, utility::conversions::details::print_utf8string(value));
-        else
-            append_query_no_encode_impl(name, utility::conversions::details::print_string(value));
-        return *this;
-    }
-
-    /// <summary>
-    /// Combine and validate the URI components into a encoded string. An exception will be thrown if the URI is
-    /// invalid.
-    /// </summary>
-    /// <returns>The created URI as a string.</returns>
-    _ASYNCRTIMP utility::string_t to_string() const;
-
-    /// <summary>
-    /// Combine and validate the URI components into a URI class instance. An exception will be thrown if the URI is
-    /// invalid.
-    /// </summary>
-    /// <returns>The create URI as a URI class instance.</returns>
-    _ASYNCRTIMP uri to_uri() const;
-
-    /// <summary>
-    /// Validate the generated URI from all existing components of this uri_builder.
-    /// </summary>
-    /// <returns>Whether the URI is valid.</returns>
-    _ASYNCRTIMP bool is_valid();
-
-private:
-    _ASYNCRTIMP void append_query_encode_impl(const utility::string_t& name, const utf8string& value);
-    _ASYNCRTIMP void append_query_no_encode_impl(const utility::string_t& name, const utility::string_t& value);
-
-    details::uri_components m_uri;
-};
-} // namespace web

deps/cpprestsdk/include/cpprest/version.h

@@ -1,10 +0,0 @@
-/***
- * Copyright (C) Microsoft. All rights reserved.
- * Licensed under the MIT license. See LICENSE.txt file in the project root for full license information.
- *
- */
-#define CPPREST_VERSION_MINOR 10
-#define CPPREST_VERSION_MAJOR 2
-#define CPPREST_VERSION_REVISION 13
-
-#define CPPREST_VERSION (CPPREST_VERSION_MAJOR * 100000 + CPPREST_VERSION_MINOR * 100 + CPPREST_VERSION_REVISION)

deps/cpprestsdk/pch.h

@@ -1,34 +0,0 @@
-#include <winrt/base.h>
-#include <Windows.h>
-#include <dxgi1_3.h>
-#include <d3d11_2.h>
-#include <d2d1_3.h>
-#include <d2d1_3helper.h>
-#include <d2d1helper.h>
-#include <dwrite.h>
-#include <dcomp.h>
-#include <dwmapi.h>
-#include <Shobjidl.h>
-#include <Shlwapi.h>
-#include <string>
-#include <algorithm>
-#include <chrono>
-#include <mutex>
-#include <thread>
-#include <functional>
-#include <condition_variable>
-#include <stdexcept>
-#include <tuple>
-#include <unordered_set>
-#include <string>
-#include <vector>
-
-// cpprestsdk headers
-#include "cpprest/details/basic_types.h"
-#include "cpprest/details/cpprest_compat.h"
-#include "cpprest/version.h"
-// json
-#include "cpprest/json.h"
-// utilities
-#include "cpprest/asyncrt_utils.h"
-#include "cpprest/details/web_utilities.h"

deps/cpprestsdk/src/json/json.cpp

@@ -1,475 +0,0 @@
-/***
- * Copyright (C) Microsoft. All rights reserved.
- * Licensed under the MIT license. See LICENSE.txt file in the project root for full license information.
- *
- * =+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+
- *
- * HTTP Library: JSON parser and writer
- *
- * For the latest on this and related APIs, please see: https://github.com/Microsoft/cpprestsdk
- *
- * =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
- ****/
-
-#include "pch.h"
-
-using namespace web;
-
-bool json::details::g_keep_json_object_unsorted = false;
-void json::keep_object_element_order(bool keep_order) { json::details::g_keep_json_object_unsorted = keep_order; }
-
-utility::ostream_t& web::json::operator<<(utility::ostream_t& os, const web::json::value& val)
-{
-    val.serialize(os);
-    return os;
-}
-
-utility::istream_t& web::json::operator>>(utility::istream_t& is, json::value& val)
-{
-    val = json::value::parse(is);
-    return is;
-}
-
-web::json::value::value()
-    : m_value(utility::details::make_unique<web::json::details::_Null>())
-#ifdef ENABLE_JSON_VALUE_VISUALIZER
-    , m_kind(value::Null)
-#endif
-{
-}
-
-web::json::value::value(int32_t value)
-    : m_value(utility::details::make_unique<web::json::details::_Number>(value))
-#ifdef ENABLE_JSON_VALUE_VISUALIZER
-    , m_kind(value::Number)
-#endif
-{
-}
-
-web::json::value::value(uint32_t value)
-    : m_value(utility::details::make_unique<web::json::details::_Number>(value))
-#ifdef ENABLE_JSON_VALUE_VISUALIZER
-    , m_kind(value::Number)
-#endif
-{
-}
-
-web::json::value::value(int64_t value)
-    : m_value(utility::details::make_unique<web::json::details::_Number>(value))
-#ifdef ENABLE_JSON_VALUE_VISUALIZER
-    , m_kind(value::Number)
-#endif
-{
-}
-
-web::json::value::value(uint64_t value)
-    : m_value(utility::details::make_unique<web::json::details::_Number>(value))
-#ifdef ENABLE_JSON_VALUE_VISUALIZER
-    , m_kind(value::Number)
-#endif
-{
-}
-
-web::json::value::value(double value)
-    : m_value(utility::details::make_unique<web::json::details::_Number>(value))
-#ifdef ENABLE_JSON_VALUE_VISUALIZER
-    , m_kind(value::Number)
-#endif
-{
-}
-
-web::json::value::value(bool value)
-    : m_value(utility::details::make_unique<web::json::details::_Boolean>(value))
-#ifdef ENABLE_JSON_VALUE_VISUALIZER
-    , m_kind(value::Boolean)
-#endif
-{
-}
-
-web::json::value::value(utility::string_t value)
-    : m_value(utility::details::make_unique<web::json::details::_String>(std::move(value)))
-#ifdef ENABLE_JSON_VALUE_VISUALIZER
-    , m_kind(value::String)
-#endif
-{
-}
-
-web::json::value::value(utility::string_t value, bool has_escape_chars)
-    : m_value(utility::details::make_unique<web::json::details::_String>(std::move(value), has_escape_chars))
-#ifdef ENABLE_JSON_VALUE_VISUALIZER
-    , m_kind(value::String)
-#endif
-{
-}
-
-web::json::value::value(const utility::char_t* value)
-    : m_value(utility::details::make_unique<web::json::details::_String>(value))
-#ifdef ENABLE_JSON_VALUE_VISUALIZER
-    , m_kind(value::String)
-#endif
-{
-}
-
-web::json::value::value(const utility::char_t* value, bool has_escape_chars)
-    : m_value(utility::details::make_unique<web::json::details::_String>(utility::string_t(value), has_escape_chars))
-#ifdef ENABLE_JSON_VALUE_VISUALIZER
-    , m_kind(value::String)
-#endif
-{
-}
-
-web::json::value::value(const value& other)
-    : m_value(other.m_value->_copy_value())
-#ifdef ENABLE_JSON_VALUE_VISUALIZER
-    , m_kind(other.m_kind)
-#endif
-{
-}
-
-web::json::value& web::json::value::operator=(const value& other)
-{
-    if (this != &other)
-    {
-        m_value = std::unique_ptr<details::_Value>(other.m_value->_copy_value());
-#ifdef ENABLE_JSON_VALUE_VISUALIZER
-        m_kind = other.m_kind;
-#endif
-    }
-    return *this;
-}
-
-web::json::value::value(value&& other) CPPREST_NOEXCEPT : m_value(std::move(other.m_value))
-#ifdef ENABLE_JSON_VALUE_VISUALIZER
-    ,
-                                                          m_kind(other.m_kind)
-#endif
-{
-}
-
-web::json::value& web::json::value::operator=(web::json::value&& other) CPPREST_NOEXCEPT
-{
-    if (this != &other)
-    {
-        m_value.swap(other.m_value);
-#ifdef ENABLE_JSON_VALUE_VISUALIZER
-        m_kind = other.m_kind;
-#endif
-    }
-    return *this;
-}
-
-web::json::value web::json::value::null() { return web::json::value(); }
-
-web::json::value web::json::value::number(double value) { return web::json::value(value); }
-
-web::json::value web::json::value::number(int32_t value) { return web::json::value(value); }
-
-web::json::value web::json::value::number(uint32_t value) { return web::json::value(value); }
-
-web::json::value web::json::value::number(int64_t value) { return web::json::value(value); }
-
-web::json::value web::json::value::number(uint64_t value) { return web::json::value(value); }
-
-web::json::value web::json::value::boolean(bool value) { return web::json::value(value); }
-
-web::json::value web::json::value::string(utility::string_t value)
-{
-    std::unique_ptr<details::_Value> ptr = utility::details::make_unique<details::_String>(std::move(value));
-    return web::json::value(std::move(ptr)
-#ifdef ENABLE_JSON_VALUE_VISUALIZER
-                                ,
-                            value::String
-#endif
-    );
-}
-
-web::json::value web::json::value::string(utility::string_t value, bool has_escape_chars)
-{
-    std::unique_ptr<details::_Value> ptr =
-        utility::details::make_unique<details::_String>(std::move(value), has_escape_chars);
-    return web::json::value(std::move(ptr)
-#ifdef ENABLE_JSON_VALUE_VISUALIZER
-                                ,
-                            value::String
-#endif
-    );
-}
-
-#ifdef _WIN32
-web::json::value web::json::value::string(const std::string& value)
-{
-    std::unique_ptr<details::_Value> ptr =
-        utility::details::make_unique<details::_String>(utility::conversions::to_utf16string(value));
-    return web::json::value(std::move(ptr)
-#ifdef ENABLE_JSON_VALUE_VISUALIZER
-                                ,
-                            value::String
-#endif
-    );
-}
-#endif
-
-web::json::value web::json::value::object(bool keep_order)
-{
-    std::unique_ptr<details::_Value> ptr = utility::details::make_unique<details::_Object>(keep_order);
-    return web::json::value(std::move(ptr)
-#ifdef ENABLE_JSON_VALUE_VISUALIZER
-                                ,
-                            value::Object
-#endif
-    );
-}
-
-web::json::value web::json::value::object(std::vector<std::pair<::utility::string_t, value>> fields, bool keep_order)
-{
-    std::unique_ptr<details::_Value> ptr =
-        utility::details::make_unique<details::_Object>(std::move(fields), keep_order);
-    return web::json::value(std::move(ptr)
-#ifdef ENABLE_JSON_VALUE_VISUALIZER
-                                ,
-                            value::Object
-#endif
-    );
-}
-
-web::json::value web::json::value::array()
-{
-    std::unique_ptr<details::_Value> ptr = utility::details::make_unique<details::_Array>();
-    return web::json::value(std::move(ptr)
-#ifdef ENABLE_JSON_VALUE_VISUALIZER
-                                ,
-                            value::Array
-#endif
-    );
-}
-
-web::json::value web::json::value::array(size_t size)
-{
-    std::unique_ptr<details::_Value> ptr = utility::details::make_unique<details::_Array>(size);
-    return web::json::value(std::move(ptr)
-#ifdef ENABLE_JSON_VALUE_VISUALIZER
-                                ,
-                            value::Array
-#endif
-    );
-}
-
-web::json::value web::json::value::array(std::vector<value> elements)
-{
-    std::unique_ptr<details::_Value> ptr = utility::details::make_unique<details::_Array>(std::move(elements));
-    return web::json::value(std::move(ptr)
-#ifdef ENABLE_JSON_VALUE_VISUALIZER
-                                ,
-                            value::Array
-#endif
-    );
-}
-
-const web::json::number& web::json::value::as_number() const { return m_value->as_number(); }
-
-double web::json::value::as_double() const { return m_value->as_double(); }
-
-int web::json::value::as_integer() const { return m_value->as_integer(); }
-
-bool web::json::value::as_bool() const { return m_value->as_bool(); }
-
-json::array& web::json::value::as_array() { return m_value->as_array(); }
-
-const json::array& web::json::value::as_array() const { return m_value->as_array(); }
-
-json::object& web::json::value::as_object() { return m_value->as_object(); }
-
-const json::object& web::json::value::as_object() const { return m_value->as_object(); }
-
-bool web::json::number::is_int32() const
-{
-    switch (m_type)
-    {
-        case signed_type:
-            return m_intval >= (std::numeric_limits<int32_t>::min)() && m_intval <= (std::numeric_limits<int32_t>::max)();
-        case unsigned_type: return m_uintval <= (std::numeric_limits<int32_t>::max)();
-        case double_type:
-        default: return false;
-    }
-}
-
-bool web::json::number::is_uint32() const
-{
-    switch (m_type)
-    {
-    case signed_type: return m_intval >= 0 && m_intval <= (std::numeric_limits<uint32_t>::max)();
-        case unsigned_type: return m_uintval <= (std::numeric_limits<uint32_t>::max)();
-        case double_type:
-        default: return false;
-    }
-}
-
-bool web::json::number::is_int64() const
-{
-    switch (m_type)
-    {
-        case signed_type: return true;
-        case unsigned_type: return m_uintval <= static_cast<uint64_t>((std::numeric_limits<int64_t>::max)());
-        case double_type:
-        default: return false;
-    }
-}
-
-bool web::json::details::_String::has_escape_chars(const _String& str)
-{
-    return std::any_of(std::begin(str.m_string), std::end(str.m_string), [](utility::string_t::value_type const x) {
-        if (x <= 31)
-        {
-            return true;
-        }
-        if (x == '"')
-        {
-            return true;
-        }
-        if (x == '\\')
-        {
-            return true;
-        }
-        return false;
-    });
-}
-
-web::json::value::value_type json::value::type() const { return m_value->type(); }
-
-bool json::value::is_integer() const
-{
-    if (!is_number())
-    {
-        return false;
-    }
-    return m_value->is_integer();
-}
-
-bool json::value::is_double() const
-{
-    if (!is_number())
-    {
-        return false;
-    }
-    return m_value->is_double();
-}
-
-json::value& web::json::details::_Object::index(const utility::string_t& key) { return m_object[key]; }
-
-bool web::json::details::_Object::has_field(const utility::string_t& key) const
-{
-    return m_object.find(key) != m_object.end();
-}
-
-bool web::json::value::has_number_field(const utility::string_t& key) const
-{
-    return has_field(key) && at(key).is_number();
-}
-
-bool web::json::value::has_integer_field(const utility::string_t& key) const
-{
-    return has_field(key) && at(key).is_integer();
-}
-
-bool web::json::value::has_double_field(const utility::string_t& key) const
-{
-    return has_field(key) && at(key).is_double();
-}
-
-bool web::json::value::has_boolean_field(const utility::string_t& key) const
-{
-    return has_field(key) && at(key).is_boolean();
-}
-
-bool web::json::value::has_string_field(const utility::string_t& key) const
-{
-    return has_field(key) && at(key).is_string();
-}
-
-bool web::json::value::has_array_field(const utility::string_t& key) const
-{
-    return has_field(key) && at(key).is_array();
-}
-
-bool web::json::value::has_object_field(const utility::string_t& key) const
-{
-    return has_field(key) && at(key).is_object();
-}
-
-utility::string_t json::value::to_string() const
-{
-#ifndef _WIN32
-    utility::details::scoped_c_thread_locale locale;
-#endif
-    return m_value->to_string();
-}
-
-bool json::value::operator==(const json::value& other) const
-{
-    if (this->m_value.get() == other.m_value.get()) return true;
-    if (this->type() != other.type()) return false;
-
-    switch (this->type())
-    {
-        case Null: return true;
-        case Number: return this->as_number() == other.as_number();
-        case Boolean: return this->as_bool() == other.as_bool();
-        case String: return this->as_string() == other.as_string();
-        case Object:
-            return static_cast<const json::details::_Object*>(this->m_value.get())
-                ->is_equal(static_cast<const json::details::_Object*>(other.m_value.get()));
-        case Array:
-            return static_cast<const json::details::_Array*>(this->m_value.get())
-                ->is_equal(static_cast<const json::details::_Array*>(other.m_value.get()));
-    }
-    __assume(0);
-}
-
-void web::json::value::erase(size_t index) { return this->as_array().erase(index); }
-
-void web::json::value::erase(const utility::string_t& key) { return this->as_object().erase(key); }
-
-// at() overloads
-web::json::value& web::json::value::at(size_t index) { return this->as_array().at(index); }
-
-const web::json::value& web::json::value::at(size_t index) const { return this->as_array().at(index); }
-
-web::json::value& web::json::value::at(const utility::string_t& key) { return this->as_object().at(key); }
-
-const web::json::value& web::json::value::at(const utility::string_t& key) const { return this->as_object().at(key); }
-
-web::json::value& web::json::value::operator[](const utility::string_t& key)
-{
-    if (this->is_null())
-    {
-        m_value.reset(new web::json::details::_Object(details::g_keep_json_object_unsorted));
-#ifdef ENABLE_JSON_VALUE_VISUALIZER
-        m_kind = value::Object;
-#endif
-    }
-    return m_value->index(key);
-}
-
-web::json::value& web::json::value::operator[](size_t index)
-{
-    if (this->is_null())
-    {
-        m_value.reset(new web::json::details::_Array());
-#ifdef ENABLE_JSON_VALUE_VISUALIZER
-        m_kind = value::Array;
-#endif
-    }
-    return m_value->index(index);
-}
-
-// Remove once VS 2013 is no longer supported.
-#if defined(_WIN32) && _MSC_VER < 1900
-static web::json::details::json_error_category_impl instance;
-#endif
-const web::json::details::json_error_category_impl& web::json::details::json_error_category()
-{
-#if !defined(_WIN32) || _MSC_VER >= 1900
-    static web::json::details::json_error_category_impl instance;
-#endif
-    return instance;
-}

deps/cpprestsdk/src/json/json_serialization.cpp

@@ -1,254 +0,0 @@
-/***
- * Copyright (C) Microsoft. All rights reserved.
- * Licensed under the MIT license. See LICENSE.txt file in the project root for full license information.
- *
- * =+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+
- *
- * HTTP Library: JSON parser and writer
- *
- * For the latest on this and related APIs, please see: https://github.com/Microsoft/cpprestsdk
- *
- * =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
- ****/
-
-#include "pch.h"
-
-#include <stdio.h>
-
-#ifndef _WIN32
-#define __STDC_FORMAT_MACROS
-#include <inttypes.h>
-#endif
-
-using namespace web;
-using namespace web::json;
-using namespace utility;
-using namespace utility::conversions;
-
-//
-// JSON Serialization
-//
-
-#ifdef _WIN32
-void web::json::value::serialize(std::ostream& stream) const
-{
-    // This has better performance than writing directly to stream.
-    std::string str;
-    m_value->serialize_impl(str);
-    stream << str;
-}
-void web::json::value::format(std::basic_string<wchar_t>& string) const { m_value->format(string); }
-#endif
-
-void web::json::value::serialize(utility::ostream_t& stream) const
-{
-#ifndef _WIN32
-    utility::details::scoped_c_thread_locale locale;
-#endif
-
-    // This has better performance than writing directly to stream.
-    utility::string_t str;
-    m_value->serialize_impl(str);
-    stream << str;
-}
-
-void web::json::value::format(std::basic_string<char>& string) const { m_value->format(string); }
-
-template<typename CharType>
-void web::json::details::append_escape_string(std::basic_string<CharType>& str,
-                                              const std::basic_string<CharType>& escaped)
-{
-    for (const auto& ch : escaped)
-    {
-        switch (ch)
-        {
-            case '\"':
-                str += '\\';
-                str += '\"';
-                break;
-            case '\\':
-                str += '\\';
-                str += '\\';
-                break;
-            case '\b':
-                str += '\\';
-                str += 'b';
-                break;
-            case '\f':
-                str += '\\';
-                str += 'f';
-                break;
-            case '\r':
-                str += '\\';
-                str += 'r';
-                break;
-            case '\n':
-                str += '\\';
-                str += 'n';
-                break;
-            case '\t':
-                str += '\\';
-                str += 't';
-                break;
-            default:
-
-                // If a control character then must unicode escaped.
-                if (ch >= 0 && ch <= 0x1F)
-                {
-                    static const std::array<CharType, 16> intToHex = {
-                        {'0', '1', '2', '3', '4', '5', '6', '7', '8', '9', 'A', 'B', 'C', 'D', 'E', 'F'}};
-                    str += '\\';
-                    str += 'u';
-                    str += '0';
-                    str += '0';
-                    str += intToHex[(ch & 0xF0) >> 4];
-                    str += intToHex[ch & 0x0F];
-                }
-                else
-                {
-                    str += ch;
-                }
-        }
-    }
-}
-
-void web::json::details::format_string(const utility::string_t& key, utility::string_t& str)
-{
-    str.push_back('"');
-    append_escape_string(str, key);
-    str.push_back('"');
-}
-
-#ifdef _WIN32
-void web::json::details::format_string(const utility::string_t& key, std::string& str)
-{
-    str.push_back('"');
-    append_escape_string(str, utility::conversions::to_utf8string(key));
-    str.push_back('"');
-}
-#endif
-
-void web::json::details::_String::format(std::basic_string<char>& str) const
-{
-    str.push_back('"');
-
-    if (m_has_escape_char)
-    {
-        append_escape_string(str, utility::conversions::to_utf8string(m_string));
-    }
-    else
-    {
-        str.append(utility::conversions::to_utf8string(m_string));
-    }
-
-    str.push_back('"');
-}
-
-void web::json::details::_Number::format(std::basic_string<char>& stream) const
-{
-    if (m_number.m_type != number::type::double_type)
-    {
-        // #digits + 1 to avoid loss + 1 for the sign + 1 for null terminator.
-        const size_t tempSize = std::numeric_limits<uint64_t>::digits10 + 3;
-        char tempBuffer[tempSize];
-
-#ifdef _WIN32
-        // This can be improved performance-wise if we implement our own routine
-        if (m_number.m_type == number::type::signed_type)
-            _i64toa_s(m_number.m_intval, tempBuffer, tempSize, 10);
-        else
-            _ui64toa_s(m_number.m_uintval, tempBuffer, tempSize, 10);
-
-        const auto numChars = strnlen_s(tempBuffer, tempSize);
-#else
-        int numChars;
-        if (m_number.m_type == number::type::signed_type)
-            numChars = snprintf(tempBuffer, tempSize, "%" PRId64, m_number.m_intval);
-        else
-            numChars = snprintf(tempBuffer, tempSize, "%" PRIu64, m_number.m_uintval);
-#endif
-        stream.append(tempBuffer, numChars);
-    }
-    else
-    {
-        // #digits + 2 to avoid loss + 1 for the sign + 1 for decimal point + 5 for exponent (e+xxx) + 1 for null
-        // terminator
-        const size_t tempSize = std::numeric_limits<double>::digits10 + 10;
-        char tempBuffer[tempSize];
-#ifdef _WIN32
-        const auto numChars = _sprintf_s_l(tempBuffer,
-                                           tempSize,
-                                           "%.*g",
-                                           utility::details::scoped_c_thread_locale::c_locale(),
-                                           std::numeric_limits<double>::digits10 + 2,
-                                           m_number.m_value);
-#else
-        const auto numChars =
-            snprintf(tempBuffer, tempSize, "%.*g", std::numeric_limits<double>::digits10 + 2, m_number.m_value);
-#endif
-        stream.append(tempBuffer, numChars);
-    }
-}
-
-#ifdef _WIN32
-
-void web::json::details::_String::format(std::basic_string<wchar_t>& str) const
-{
-    str.push_back(L'"');
-
-    if (m_has_escape_char)
-    {
-        append_escape_string(str, m_string);
-    }
-    else
-    {
-        str.append(m_string);
-    }
-
-    str.push_back(L'"');
-}
-
-void web::json::details::_Number::format(std::basic_string<wchar_t>& stream) const
-{
-    if (m_number.m_type != number::type::double_type)
-    {
-        // #digits + 1 to avoid loss + 1 for the sign + 1 for null terminator.
-        const size_t tempSize = std::numeric_limits<uint64_t>::digits10 + 3;
-        wchar_t tempBuffer[tempSize];
-
-        if (m_number.m_type == number::type::signed_type)
-            _i64tow_s(m_number.m_intval, tempBuffer, tempSize, 10);
-        else
-            _ui64tow_s(m_number.m_uintval, tempBuffer, tempSize, 10);
-
-        stream.append(tempBuffer, wcsnlen_s(tempBuffer, tempSize));
-    }
-    else
-    {
-        // #digits + 2 to avoid loss + 1 for the sign + 1 for decimal point + 5 for exponent (e+xxx) + 1 for null
-        // terminator
-        const size_t tempSize = std::numeric_limits<double>::digits10 + 10;
-        wchar_t tempBuffer[tempSize];
-        const int numChars = _swprintf_s_l(tempBuffer,
-                                           tempSize,
-                                           L"%.*g",
-                                           utility::details::scoped_c_thread_locale::c_locale(),
-                                           std::numeric_limits<double>::digits10 + 2,
-                                           m_number.m_value);
-        stream.append(tempBuffer, numChars);
-    }
-}
-
-#endif
-
-const utility::string_t& web::json::details::_String::as_string() const { return m_string; }
-
-const utility::string_t& web::json::value::as_string() const { return m_value->as_string(); }
-
-utility::string_t json::value::serialize() const
-{
-#ifndef _WIN32
-    utility::details::scoped_c_thread_locale locale;
-#endif
-    return m_value->to_string();
-}

deps/cpprestsdk/src/utilities/base64.cpp

@@ -1,260 +0,0 @@
-/***
- * Copyright (C) Microsoft. All rights reserved.
- * Licensed under the MIT license. See LICENSE.txt file in the project root for full license information.
- *
- * =+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+
- *
- * For the latest on this and related APIs, please see: https://github.com/Microsoft/cpprestsdk
- *
- * =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
- ****/
-#include "pch.h"
-
-using namespace web;
-using namespace utility;
-
-std::vector<unsigned char> _from_base64(const utility::string_t& str);
-utility::string_t _to_base64(const unsigned char* ptr, size_t size);
-
-std::vector<unsigned char> __cdecl conversions::from_base64(const utility::string_t& str) { return _from_base64(str); }
-
-utility::string_t __cdecl conversions::to_base64(const std::vector<unsigned char>& input)
-{
-    if (input.size() == 0)
-    {
-        // return empty string
-        return utility::string_t();
-    }
-
-    return _to_base64(&input[0], input.size());
-}
-
-utility::string_t __cdecl conversions::to_base64(uint64_t input)
-{
-    return _to_base64(reinterpret_cast<const unsigned char*>(&input), sizeof(input));
-}
-
-static const char* _base64_enctbl = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
-const std::array<unsigned char, 128> _base64_dectbl = {
-    {255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255,
-     255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 62,
-     255, 255, 255, 63,  52,  53,  54,  55,  56,  57,  58,  59,  60,  61,  255, 255, 255, 254, 255, 255, 255, 0,
-     1,   2,   3,   4,   5,   6,   7,   8,   9,   10,  11,  12,  13,  14,  15,  16,  17,  18,  19,  20,  21,  22,
-     23,  24,  25,  255, 255, 255, 255, 255, 255, 26,  27,  28,  29,  30,  31,  32,  33,  34,  35,  36,  37,  38,
-     39,  40,  41,  42,  43,  44,  45,  46,  47,  48,  49,  50,  51,  255, 255, 255, 255, 255}};
-
-struct _triple_byte
-{
-    unsigned char _1_1 : 2;
-    unsigned char _0 : 6;
-    unsigned char _2_1 : 4;
-    unsigned char _1_2 : 4;
-    unsigned char _3 : 6;
-    unsigned char _2_2 : 2;
-};
-
-struct _double_byte
-{
-    unsigned char _1_1 : 2;
-    unsigned char _0 : 6;
-    unsigned char _2_1 : 4;
-    unsigned char _1_2 : 4;
-};
-
-struct _single_byte
-{
-    unsigned char _1_1 : 2;
-    unsigned char _0 : 6;
-};
-
-//
-// A note on the implementation of BASE64 encoding and decoding:
-//
-// This is a fairly basic and naive implementation; there is probably a lot of room for
-// performance improvement, as well as for adding options such as support for URI-safe base64,
-// ignoring CRLF, relaxed validation rules, etc. The decoder is currently pretty strict.
-//
-
-#ifdef __GNUC__
-// gcc is concerned about the bitfield uses in the code, something we simply need to ignore.
-#pragma GCC diagnostic ignored "-Wconversion"
-#endif
-std::vector<unsigned char> _from_base64(const utility::string_t& input)
-{
-    std::vector<unsigned char> result;
-
-    if (input.empty()) return result;
-
-    size_t padding = 0;
-
-    // Validation
-    {
-        auto size = input.size();
-
-        if ((size % 4) != 0)
-        {
-            throw std::runtime_error("length of base64 string is not an even multiple of 4");
-        }
-
-        for (auto iter = input.begin(); iter != input.end(); ++iter, --size)
-        {
-            const size_t ch_sz = static_cast<size_t>(*iter);
-            if (ch_sz >= _base64_dectbl.size() || _base64_dectbl[ch_sz] == 255)
-            {
-                throw std::runtime_error("invalid character found in base64 string");
-            }
-            if (_base64_dectbl[ch_sz] == 254)
-            {
-                padding++;
-                // padding only at the end
-                if (size > 2)
-                {
-                    throw std::runtime_error("invalid padding character found in base64 string");
-                }
-                if (size == 2)
-                {
-                    const size_t ch2_sz = static_cast<size_t>(*(iter + 1));
-                    if (ch2_sz >= _base64_dectbl.size() || _base64_dectbl[ch2_sz] != 254)
-                    {
-                        throw std::runtime_error("invalid padding character found in base64 string");
-                    }
-                }
-            }
-        }
-    }
-
-    auto size = input.size();
-    const char_t* ptr = &input[0];
-
-    auto outsz = (size / 4) * 3;
-    outsz -= padding;
-
-    result.resize(outsz);
-
-    size_t idx = 0;
-    for (; size > 4; ++idx)
-    {
-        unsigned char target[3];
-        memset(target, 0, sizeof(target));
-        _triple_byte* record = reinterpret_cast<_triple_byte*>(target);
-
-        unsigned char val0 = _base64_dectbl[ptr[0]];
-        unsigned char val1 = _base64_dectbl[ptr[1]];
-        unsigned char val2 = _base64_dectbl[ptr[2]];
-        unsigned char val3 = _base64_dectbl[ptr[3]];
-
-        record->_0 = val0;
-        record->_1_1 = val1 >> 4;
-        result[idx] = target[0];
-
-        record->_1_2 = val1 & 0xF;
-        record->_2_1 = val2 >> 2;
-        result[++idx] = target[1];
-
-        record->_2_2 = val2 & 0x3;
-        record->_3 = val3 & 0x3F;
-        result[++idx] = target[2];
-
-        ptr += 4;
-        size -= 4;
-    }
-
-    // Handle the last four bytes separately, to avoid having the conditional statements
-    // in all the iterations (a performance issue).
-
-    {
-        unsigned char target[3];
-        memset(target, 0, sizeof(target));
-        _triple_byte* record = reinterpret_cast<_triple_byte*>(target);
-
-        unsigned char val0 = _base64_dectbl[ptr[0]];
-        unsigned char val1 = _base64_dectbl[ptr[1]];
-        unsigned char val2 = _base64_dectbl[ptr[2]];
-        unsigned char val3 = _base64_dectbl[ptr[3]];
-
-        record->_0 = val0;
-        record->_1_1 = val1 >> 4;
-        result[idx] = target[0];
-
-        record->_1_2 = val1 & 0xF;
-        if (val2 != 254)
-        {
-            record->_2_1 = val2 >> 2;
-            result[++idx] = target[1];
-        }
-        else
-        {
-            // There shouldn't be any information (ones) in the unused bits,
-            if (record->_1_2 != 0)
-            {
-                throw std::runtime_error("Invalid end of base64 string");
-            }
-            return result;
-        }
-
-        record->_2_2 = val2 & 0x3;
-        if (val3 != 254)
-        {
-            record->_3 = val3 & 0x3F;
-            result[++idx] = target[2];
-        }
-        else
-        {
-            // There shouldn't be any information (ones) in the unused bits.
-            if (record->_2_2 != 0)
-            {
-                throw std::runtime_error("Invalid end of base64 string");
-            }
-            return result;
-        }
-    }
-
-    return result;
-}
-
-utility::string_t _to_base64(const unsigned char* ptr, size_t size)
-{
-    utility::string_t result;
-
-    for (; size >= 3;)
-    {
-        const _triple_byte* record = reinterpret_cast<const _triple_byte*>(ptr);
-        unsigned char idx0 = record->_0;
-        unsigned char idx1 = (record->_1_1 << 4) | record->_1_2;
-        unsigned char idx2 = (record->_2_1 << 2) | record->_2_2;
-        unsigned char idx3 = record->_3;
-        result.push_back(char_t(_base64_enctbl[idx0]));
-        result.push_back(char_t(_base64_enctbl[idx1]));
-        result.push_back(char_t(_base64_enctbl[idx2]));
-        result.push_back(char_t(_base64_enctbl[idx3]));
-        size -= 3;
-        ptr += 3;
-    }
-    switch (size)
-    {
-        case 1:
-        {
-            const _single_byte* record = reinterpret_cast<const _single_byte*>(ptr);
-            unsigned char idx0 = record->_0;
-            unsigned char idx1 = (record->_1_1 << 4);
-            result.push_back(char_t(_base64_enctbl[idx0]));
-            result.push_back(char_t(_base64_enctbl[idx1]));
-            result.push_back('=');
-            result.push_back('=');
-            break;
-        }
-        case 2:
-        {
-            const _double_byte* record = reinterpret_cast<const _double_byte*>(ptr);
-            unsigned char idx0 = record->_0;
-            unsigned char idx1 = (record->_1_1 << 4) | record->_1_2;
-            unsigned char idx2 = (record->_2_1 << 2);
-            result.push_back(char_t(_base64_enctbl[idx0]));
-            result.push_back(char_t(_base64_enctbl[idx1]));
-            result.push_back(char_t(_base64_enctbl[idx2]));
-            result.push_back('=');
-            break;
-        }
-    }
-    return result;
-}

deps/cpprestsdk/src/utilities/web_utilities.cpp

@@ -1,157 +0,0 @@
-/***
- * Copyright (C) Microsoft. All rights reserved.
- * Licensed under the MIT license. See LICENSE.txt file in the project root for full license information.
- *
- * =+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+
- *
- * Credential and proxy utilities.
- *
- * For the latest on this and related APIs, please see: https://github.com/Microsoft/cpprestsdk
- *
- * =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
- ****/
-
-#include "pch.h"
-
-#include <assert.h>
-
-#if defined(_WIN32) && !defined(__cplusplus_winrt)
-#include <Wincrypt.h>
-#endif
-
-#if defined(__cplusplus_winrt)
-#include <robuffer.h>
-#endif
-
-namespace web
-{
-namespace details
-{
-#if defined(_WIN32) && !defined(CPPREST_TARGET_XP)
-#if defined(__cplusplus_winrt)
-
-// Helper function to zero out memory of an IBuffer.
-void winrt_secure_zero_buffer(Windows::Storage::Streams::IBuffer ^ buffer)
-{
-    Microsoft::WRL::ComPtr<IInspectable> bufferInspectable(reinterpret_cast<IInspectable*>(buffer));
-    Microsoft::WRL::ComPtr<Windows::Storage::Streams::IBufferByteAccess> bufferByteAccess;
-    bufferInspectable.As(&bufferByteAccess);
-
-    // This shouldn't happen but if can't get access to the raw bytes for some reason
-    // then we can't zero out.
-    byte* rawBytes;
-    if (bufferByteAccess->Buffer(&rawBytes) == S_OK)
-    {
-        SecureZeroMemory(rawBytes, buffer->Length);
-    }
-}
-
-winrt_encryption::winrt_encryption(const std::wstring& data)
-{
-    auto provider = ref new Windows::Security::Cryptography::DataProtection::DataProtectionProvider(
-        ref new Platform::String(L"Local=user"));
-
-    // Create buffer containing plain text password.
-    Platform::ArrayReference<unsigned char> arrayref(
-        reinterpret_cast<unsigned char*>(const_cast<std::wstring::value_type*>(data.c_str())),
-        static_cast<unsigned int>(data.size()) * sizeof(std::wstring::value_type));
-    Windows::Storage::Streams::IBuffer ^ plaintext =
-        Windows::Security::Cryptography::CryptographicBuffer::CreateFromByteArray(arrayref);
-    m_buffer = pplx::create_task(provider->ProtectAsync(plaintext));
-    m_buffer.then(
-        [plaintext](pplx::task<Windows::Storage::Streams::IBuffer ^>) { winrt_secure_zero_buffer(plaintext); });
-}
-
-plaintext_string winrt_encryption::decrypt() const
-{
-    // To fully guarantee asynchrony would require significant impact on existing code. This code path
-    // is never run on a user's thread and is only done once when setting up a connection.
-    auto encrypted = m_buffer.get();
-    auto provider = ref new Windows::Security::Cryptography::DataProtection::DataProtectionProvider();
-    auto plaintext = pplx::create_task(provider->UnprotectAsync(encrypted)).get();
-
-    // Get access to raw bytes in plain text buffer.
-    Microsoft::WRL::ComPtr<IInspectable> bufferInspectable(reinterpret_cast<IInspectable*>(plaintext));
-    Microsoft::WRL::ComPtr<Windows::Storage::Streams::IBufferByteAccess> bufferByteAccess;
-    bufferInspectable.As(&bufferByteAccess);
-    byte* rawPlaintext;
-    const auto& result = bufferByteAccess->Buffer(&rawPlaintext);
-    if (result != S_OK)
-    {
-        throw ::utility::details::create_system_error(result);
-    }
-
-    // Construct string and zero out memory from plain text buffer.
-    auto data = plaintext_string(
-        new std::wstring(reinterpret_cast<const std::wstring::value_type*>(rawPlaintext), plaintext->Length / 2));
-    SecureZeroMemory(rawPlaintext, plaintext->Length);
-    return std::move(data);
-}
-
-#else
-
-win32_encryption::win32_encryption(const std::wstring& data) : m_numCharacters(data.size())
-{
-    // Early return because CryptProtectMemory crashes with empty string
-    if (m_numCharacters == 0)
-    {
-        return;
-    }
-
-    if (data.size() > (std::numeric_limits<DWORD>::max)() / sizeof(wchar_t))
-    {
-        throw std::length_error("Encryption string too long");
-    }
-
-    const auto dataSizeDword = static_cast<DWORD>(data.size() * sizeof(wchar_t));
-
-    // Round up dataSizeDword to be a multiple of CRYPTPROTECTMEMORY_BLOCK_SIZE
-    static_assert(CRYPTPROTECTMEMORY_BLOCK_SIZE == 16, "Power of 2 assumptions in this bit masking violated");
-    const auto mask = static_cast<DWORD>(CRYPTPROTECTMEMORY_BLOCK_SIZE - 1u);
-    const auto dataNumBytes = (dataSizeDword & ~mask) + ((dataSizeDword & mask) != 0) * CRYPTPROTECTMEMORY_BLOCK_SIZE;
-    assert((dataNumBytes % CRYPTPROTECTMEMORY_BLOCK_SIZE) == 0);
-    assert(dataNumBytes >= dataSizeDword);
-    m_buffer.resize(dataNumBytes);
-    memcpy_s(m_buffer.data(), m_buffer.size(), data.c_str(), dataNumBytes);
-    if (!CryptProtectMemory(m_buffer.data(), dataNumBytes, CRYPTPROTECTMEMORY_SAME_PROCESS))
-    {
-        throw ::utility::details::create_system_error(GetLastError());
-    }
-}
-
-win32_encryption::~win32_encryption() { SecureZeroMemory(m_buffer.data(), m_buffer.size()); }
-
-plaintext_string win32_encryption::decrypt() const
-{
-    // Copy the buffer and decrypt to avoid having to re-encrypt.
-    auto result = plaintext_string(new std::wstring(reinterpret_cast<const std::wstring::value_type*>(m_buffer.data()),
-                                                    m_buffer.size() / sizeof(wchar_t)));
-    auto& data = *result;
-    if (!m_buffer.empty())
-    {
-        if (!CryptUnprotectMemory(&data[0], static_cast<DWORD>(m_buffer.size()), CRYPTPROTECTMEMORY_SAME_PROCESS))
-        {
-            throw ::utility::details::create_system_error(GetLastError());
-        }
-
-        assert(m_numCharacters <= m_buffer.size());
-        SecureZeroMemory(&data[m_numCharacters], data.size() - m_numCharacters);
-        data.erase(m_numCharacters);
-    }
-
-    return result;
-}
-#endif
-#endif
-
-void zero_memory_deleter::operator()(::utility::string_t* data) const
-{
-    CASABLANCA_UNREFERENCED_PARAMETER(data);
-#if defined(_WIN32)
-    SecureZeroMemory(&(*data)[0], data->size() * sizeof(::utility::string_t::value_type));
-    delete data;
-#endif
-}
-} // namespace details
-
-} // namespace web

doc/coding/organization.md

@@ -1,26 +0,0 @@
-# Code Organization
-
-## Rules
-
-- **Follow the pattern of what you already see in the code**
-- Try to package new ideas/components into libraries that have nicely defined interfaces
-- Package new ideas into classes or refactor existing ideas into a class as you extend
-
-## Code Overview
-
-General project organization:
-
-#### The [`deps`](/deps) folder
-Contains other projects that PowerToys uses as dependencies.
-
-#### The [`doc`](/doc) folder
-Documentation for the project, including a [coding guide](/doc/coding) and [design docs](/doc/specs).
-
-#### The [`installer`](/installer) folder
-Contains the source code of the PowerToys installer.
-
-#### The [`src`](/src) folder
-Contains the source code of the PowerToys runner and of all of the PowerToys modules. **This is where the most of the magic happens.**
-
-#### The [`tools`](/tools) folder
-Various tools used by PowerToys. Includes the Visual Studio 2019 project template for new PowerToys.

doc/coding/style.md

@@ -1,5 +0,0 @@
-# Coding Style
-
-## Philosophy
-1. If it's inserting something into the existing classes/functions, try to follow the existing style as closely as possible.
-1. If it's brand new code or refactoring a complete class or area of the code, please follow as Modern C++ of a style as you can and reference the [C++ Core Guidelines](https://github.com/isocpp/CppCoreGuidelines) as much as you possibly can.

doc/devdocs/common.md

@@ -0,0 +1,109 @@
+# Classes and structures
+
+#### class Animation: [header](/src/common/animation.h) [source](/src/common/animation.cpp)
+Animation helper class with two easing-in animations: linear and exponential.
+
+#### class AsyncMessageQueue: [header](/src/common/async_message_queue.h)
+Header-only asynchronous message queue. Used by `TwoWayPipeMessageIPC`.
+
+#### class TwoWayPipeMessageIPC: [header](/src/common/two_way_pipe_message_ipc.h)
+Header-only asynchronous IPC messaging class. Used by the runner to communicate with the settings window.
+
+#### class D2DSVG: [header](/src/common/d2d_svg.h) [source](/src/common/d2d_svg.cpp)
+Class for loading, rendering and for some basic modifications of SVG graphics.
+
+#### class D2DText: [header](/src/common/d2d_text.h) [source](/src/common/d2d_text.cpp)
+Class for rendering text using DirectX.
+
+#### class D2DWindow: [header](/src/common/d2d_window.h) [source](/src/common/d2d_window.cpp)
+Base class for creating borderless windows, with DirectX enabled rendering pipeline.
+
+#### class DPIAware: [header](/src/common/dpi_aware.h) [source](/src/common/dpi_aware.cpp)
+Helper class for creating DPI-aware applications.
+
+#### struct MonitorInfo: [header](/src/common/monitors.h) [source](/src/common/monitors.cpp)
+Class for obtaining information about physical displays connected to the machine.
+
+#### class Settings, class PowerToyValues, class CustomActionObject: [header](/src/common/settings_objects.h) [source](/src/common/settings_objects.cpp)
+Classes used to define settings screens for the PowerToys modules.
+
+#### class Tasklist: [header](/src/common/tasklist_positions.h) [source](/src/common/tasklist_positions.cpp)
+Class that can detect the position of the windows buttons on the taskbar. It also detects which window will react to pressing `WinKey + number`.
+
+#### struct WindowsColors: [header](/src/common/windows_colors.h) [source](/src/common/windows_colors.cpp)
+Class for detecting the current Windows color scheme.
+
+# Helpers
+
+#### Common helpers: [header](/src/common/common.h) [source](/src/common/common.cpp)
+Various helper functions.
+
+#### Settings helpers: [header](/src/common/settings_helpers.h)
+Helper methods for the settings.
+
+#### Start visible helper: [header](/src/common/start_visible.h) [source](/src/common/start_visible.cpp)
+Contains function to test if the Start menu is visible.
+
+# Toast Notifications
+
+#### Notifications API [header](/src/common/notifications.h) [source](/src/common/notifications.cpp)
+To use UWP-style toast notifications, simply include the header and call one of these functions:
+
+```cpp
+    void show_toast(std::wstring_view message);       // #1
+    
+    void show_toast_background_activated(             // #2
+      std::wstring_view message,
+      std::wstring_view background_handler_id,
+      std::vector<std::wstring_view> button_labels);
+```
+We might add more functions in the future if the need arises, e.g. `show_toast_xml` which will accept raw XML for rich customization.
+
+Description:
+- `#1` is for sending simple notifications without any callbacks or buttons
+- `#2` is capable of showing a toast with multiple buttons and background activation
+- `message` is a plain-text argument
+
+Implement a toast activation handler/callback as a function in [handler_functions.cpp](/src/common/notifications_winrt/handler_functions.cpp) and register its `background_handler_id` via `handlers_map`, e.g.:
+
+```cpp
+// Your .cpp where you'd like to show a toast
+
+#include <common/notifications.h>
+
+void some_func() {
+// ...
+  notifications::show_toast_background_activated(
+    L"Toast message!",                                                  // text displayed in a toast
+    L"awesome_toast",                                                   // activation handler id
+    {L"Press me!", L"Also could press me!", L"I'm here to be pressed!"} // buttons in a toast
+  );
+```
+
+```cpp
+// handler_functions.cpp
+void awesome_toast_handler(IBackgroundTaskInstance, const size_t button_id)
+{
+  switch(button_id)
+  {
+    case 0:
+      // handle "Press me!" button click
+    case 1:
+      // handle "Also could press me!" button click
+    case 2:
+      // handle "I'm here to be pressed!" button click
+  }
+}
+
+namespace
+{
+  const std::unordered_map<std::wstring_view, handler_function_t> handlers_map = {
+    // ...other handlers...
+    {L"awesome_toast", awesome_toast_handler}
+  };}
+
+```
+
+Note: since _background activation_ implies that your toast handler will be invoked in a separate process, you can't share data directly from within a handler and your PT process. Also, since PT is currently a Desktop Bridge app, _foreground activation_ is [handled the same as background](https://docs.microsoft.com/en-US/windows/uwp/design/shell/tiles-and-notifications/send-local-toast-desktop-cpp-wrl#foreground-vs-background-activation), therefore we don't make a dedicated API for it. You can read more on the rationale of the current design [here](https://github.com/microsoft/PowerToys/pull/1178#issue-368768337).
+
+

doc/devdocs/guidance.md

@@ -0,0 +1,71 @@
+# Coding Guidance
+
+## Working With Strings
+
+In order to support localization **YOU SHOULD NOT** have hardcoded UI display strings in your code. Instead, use resource files to consume strings. 
+
+### For CPP
+Use [`StringTable` resource][String Table] to store the strings and resource header file(`resource.h`) to store Id's linked to the UI display string. Add the strings with Id's referenced from the header file to the resource-definition script file. You can use [Visual Studio Resource Editor][VS Resource Editor] to create and manage resource files.
+
+- `resource.h`:
+
+XXX must be a unique int in the list (mostly the int ID of the last string id plus one):
+
+```cpp
+#define IDS_MODULE_DISPLAYNAME                    XXX
+```
+
+- `StringTable` in resource-definition script file `validmodulename.rc`:
+
+```
+STRINGTABLE
+BEGIN
+    IDS_MODULE_DISPLAYNAME               L"Module Name"
+END
+```
+
+- Use the `GET_RESOURCE_STRING(UINT resource_id)` method to consume strings in your code.
+```cpp
+#include <common.h>
+
+extern "C" IMAGE_DOS_HEADER __ImageBase;
+
+std::wstring GET_RESOURCE_STRING(IDS_MODULE_DISPLAYNAME)
+```
+
+### For C#
+Use [XML resource file(.resx)][Resx Files] to store the UI display strings and [`Resource Manager`][Resource Manager] to consume those strings in the code. You can use [Visual Studio][Resx Files VS] to create and manage XML resources files.
+
+- `Resources.resx`
+
+```xml
+  <data name="ValidUIDisplayString" xml:space="preserve">
+    <value>Description to be displayed on UI.</value>
+    <comment>This text is displayed when XYZ button clicked.</comment>
+  </data>
+```
+
+- Use [`Resource Manager`][Resource Manager] to consume strings in code.
+```csharp
+System.Resources.ResourceManager manager = new System.Resources.ResourceManager(baseName, assembly);
+string validUIDisplayString = manager.GetString("ValidUIDisplayString", resourceCulture);
+```
+
+In case of Visual Studio is used to create the resource file. Simply use the `Resources` class in auto-generated `Resources.Designer.cs` file to access the strings which encapsulate the [`Resource Manager`][Resource Manager] logic.
+
+```csharp
+string validUIDisplayString = Resources.ValidUIDisplayString;
+```
+
+## More On Coding Guidance
+Please review these brief docs below relating to our coding standards etc.
+
+* [Coding Style](./style.md)
+* [Code Organization](./readme.md)
+
+
+[VS Resource Editor]: https://docs.microsoft.com/en-us/cpp/windows/resource-editors?view=vs-2019
+[String Table]: https://docs.microsoft.com/en-us/windows/win32/menurc/stringtable-resource
+[Resx Files VS]: https://docs.microsoft.com/en-us/dotnet/framework/resources/creating-resource-files-for-desktop-apps#resource-files-in-visual-studio
+[Resx Files]: https://docs.microsoft.com/en-us/dotnet/framework/resources/creating-resource-files-for-desktop-apps#resources-in-resx-files
+[Resource Manager]: https://docs.microsoft.com/en-us/dotnet/api/system.resources.resourcemanager?view=netframework-4.8

doc/devdocs/modules/fancyzones.md

@@ -0,0 +1,85 @@
+## FancyZones Lib
+
+#### [`FancyZones.cpp`](/src/modules/fancyzones/lib/FancyZones.cpp)
+TODO
+
+#### [`Settings.cpp`](/src/modules/fancyzones/lib/Settings.cpp)
+TODO
+
+#### [`trace.cpp`](/src/modules/fancyzones/lib/trace.cpp)
+TODO
+
+#### [`Zone.cpp`](/src/modules/fancyzones/lib/Zone.cpp)
+TODO
+
+#### [`ZoneSet.cpp`](/src/modules/fancyzones/lib/ZoneSet.cpp)
+TODO
+
+#### [`ZoneWindow.cpp`](/src/modules/fancyzones/lib/ZoneWindow.cpp)
+TODO
+
+## FancyZones Editor
+
+#### [`App.xaml.cs`](/src/modules/fancyzones/editor/App.xaml.cs)
+TODO
+
+#### [`Properties\AssemblyInfo.cs`](/src/modules/fancyzones/editor/Properties\AssemblyInfo.cs)
+TODO
+
+#### [`CanvasEditor.xaml.cs`](/src/modules/fancyzones/editor/CanvasEditor.xaml.cs)
+TODO
+
+#### [`CanvasEditorWindow.xaml.cs`](/src/modules/fancyzones/editor/CanvasEditorWindow.xaml.cs)
+TODO
+
+#### [`Models\CanvasLayoutModel.cs`](/src/modules/fancyzones/editor/Models\CanvasLayoutModel.cs)
+TODO
+
+#### [`CanvasZone.xaml.cs`](/src/modules/fancyzones/editor/CanvasZone.xaml.cs)
+TODO
+
+#### [`EditorOverlay.xaml.cs`](/src/modules/fancyzones/editor/EditorOverlay.xaml.cs)
+TODO
+
+#### [`EditorWindow.cs`](/src/modules/fancyzones/editor/EditorWindow.cs)
+TODO
+
+#### [`GridEditor.xaml.cs`](/src/modules/fancyzones/editor/GridEditor.xaml.cs)
+TODO
+
+#### [`GridEditorWindow.xaml.cs`](/src/modules/fancyzones/editor/GridEditorWindow.xaml.cs)
+TODO
+
+#### [`Models\GridLayoutModel.cs`](/src/modules/fancyzones/editor/Models\GridLayoutModel.cs)
+TODO
+
+#### [`GridResizer.xaml.cs`](/src/modules/fancyzones/editor/GridResizer.xaml.cs)
+TODO
+
+#### [`GridZone.xaml.cs`](/src/modules/fancyzones/editor/GridZone.xaml.cs)
+TODO
+
+#### [`Models\LayoutModel.cs`](/src/modules/fancyzones/editor/Models/LayoutModel.cs)
+TODO
+
+#### [`LayoutPreview.xaml.cs`](/src/modules/fancyzones/editor/LayoutPreview.xaml.cs)
+TODO
+
+#### [`MainWindow.xaml.cs`](/src/modules/fancyzones/editor/MainWindow.xaml.cs)
+TODO
+
+#### [`Properties\Resources.Designer.cs`](/src/modules/fancyzones/editor/Properties/Resources.Designer.cs)
+TODO
+
+#### [`RowColInfo.cs`](/src/modules/fancyzones/editor/RowColInfo.cs)
+TODO
+
+#### [`Models\Settings.cs`](/src/modules/fancyzones/editor/Models/Settings.cs)
+TODO
+
+#### [`Properties\Settings.Designer.cs`](/src/modules/fancyzones/editor/Properties/Settings.Designer.cs)
+TODO
+
+#### [`WindowLayout.xaml.cs`](/src/modules/fancyzones/editor/WindowLayout.xaml.cs)
+TODO
+

doc/devdocs/modules/interface.md

@@ -0,0 +1,240 @@
+# Interface definition
+
+```cpp
+class PowertoyModuleIface {
+public:
+  virtual const wchar_t* get_name() = 0;
+  virtual const wchar_t** get_events() = 0;
+  virtual bool get_config(wchar_t* buffer, int *buffer_size) = 0;
+  virtual void set_config(const wchar_t* config) = 0;
+  virtual void call_custom_action(const wchar_t* action) {};
+  virtual void enable() = 0;
+  virtual void disable() = 0;
+  virtual bool is_enabled() = 0;
+  virtual intptr_t signal_event(const wchar_t* name, intptr_t data) = 0;
+  virtual void register_system_menu_helper(PowertoySystemMenuIface* helper) = 0;
+  virtual void signal_system_menu_action(const wchar_t* name) = 0;
+  virtual void destroy() = 0;
+};
+
+typedef PowertoyModuleIface* (__cdecl *powertoy_create_func)();
+```
+
+# Runtime logic
+
+The PowerToys runner will, for each PowerToy DLL:
+  - load the DLL,
+  - call [`powertoy_create()`](#powertoy_create_func) to create the PowerToy.
+
+On the received object, the runner will call:
+  - [`get_name()`](#get_name) to get the name of the PowerToy,
+  - [`get_events()`](#get_events) to get the list of the events the PowerToy wants to subscribe to,
+  - [`enable()`](#enable) to initialize the PowerToy.
+
+While running, the runner might call the following methods between create_powertoy()
+and destroy():
+  - [`disable()`](#disable)/[`enable()`](#enable)/[`is_enabled()`](#is_enabled) to change or get the PowerToy's enabled state,
+  - [`get_config()`](#get_config) to get the available configuration settings,
+  - [`set_config()`](#set_config) to set settings after they have been edited in the Settings editor,
+  - [`call_custom_action()`](#call_custom_action) when the user selects a custom action in the Settings editor,
+  - [`signal_event()`](#signal_event) to send an event the PowerToy registered to.
+  - [`register_system_menu_helper()`](#register_system_menu_helper) to pass object, responsible for handling customized system menus, to module.
+  - [`signal_system_menu_action()`](#signal_system_menu_action) to send an event when action is taken on system menu item.
+
+When terminating, the runner will:
+  - call [`disable()`](#disable),
+  - call [`destroy()`](#destroy) which should free all the memory and delete the PowerToy object,
+  - unload the DLL.
+
+
+# Method definition
+
+This section contains a more detailed description of each of the interface methods.
+
+## powertoy_create_func
+
+```cpp
+typedef PowertoyModuleIface* (__cdecl *powertoy_create_func)()
+```
+
+Typedef of the factory function that creates the PowerToy object.
+Must be exported by the DLL as `powertoy_create()`.
+
+Called by the PowerToys runner to initialize each PowerToy.
+It will be called only once before a call to [`destroy()`](#destroy) is made.
+
+The returned PowerToy should be in the disabled state. The runner will call the [`enable()`](#enable) method to start the PowerToy.
+
+In case of errors returns `nullptr`.
+
+## get_name
+
+```cpp
+virtual const wchar_t* get_name()
+```
+
+Returns the name of the PowerToy, it will be cached by the runner.
+
+## get_events
+
+```cpp
+virtual const wchar_t** get_events()
+```
+
+Returns a null-terminated table of the names of the events the PowerToy wants to subscribe to. Available events:
+  * ll_keyboard
+  * win_hook_event
+
+A nullptr can be returned to signal that the PowerToy does not want to subscribe to any event.
+
+## get_config
+
+```
+virtual bool get_config(wchar_t* buffer, int *buffer_size)
+```
+
+Fills a buffer with the available configuration settings.
+
+If `buffer` is a null pointer or the buffer size is not large enough sets the required buffer size in 'buffer_size' and return false.
+
+Returns true if successful.
+
+## set_config
+
+```cpp
+virtual void set_config(const wchar_t* config)
+```
+
+After the user has changed the module settings in the Settings editor, the runner calls this method to pass to the module the updated values. It's a good place to save the settings as well.
+
+## call_custom_action
+
+```cpp
+  virtual void call_custom_action(const wchar_t* action)
+```
+
+Calls a custom action in response to the user pressing the custom action button in the Settings editor.
+This can be used to spawn custom editors defined by the PowerToy.
+
+## enable
+
+```cpp
+  virtual void enable()
+```
+
+Enables the PowerToy.
+
+## disable
+
+```cpp
+  virtual void disable()
+```
+
+Disables the PowerToy, should free as much memory as possible.
+
+## is_enabled
+
+```cpp
+  virtual bool is_enabled() = 0;
+```
+
+Returns the PowerToy state.
+
+## signal_event
+
+```cpp
+  virtual intptr_t signal_event(const wchar_t* name, intptr_t data) = 0;
+```
+
+Handle event. Only the events the PowerToy subscribed to will be signaled.
+The data argument and return value meaning are event-specific:
+  * ll_keyboard: see [`lowlevel_keyboard_event_data.h`](./lowlevel_keyboard_event_data.h).
+  * win_hook_event: see [`win_hook_event_data.h`](./win_hook_event_data.h)
+
+Please note that some of the events are currently being signalled from a separate thread.
+
+## register_system_menu_helper
+
+```cpp
+  virtual void register_system_menu_helper(PowertoySystemMenuIface* helper) = 0;
+```
+
+Register helper class to handle all system menu items related actions. Creation, deletion
+and all other actions taken on system menu item will be handled by provided class.
+Module will be informed when action is taken on any item created on request of the module.
+
+## signal_system_menu_action
+
+```cpp
+  virtual void signal_system_menu_action(const wchar_t* name) = 0;
+```
+
+Runner invokes this API when action is taken on item created on request from the module.
+Item name is passed as an argument, so that module can distinguish between different menu items.
+
+## destroy
+
+```cpp
+  virtual void destroy()
+```
+Destroy the PowerToy and free all memory.
+
+## Powertoys system menu helper interface
+
+Interface for helper class responsible for handling all system menu related actions.
+```cpp
+class PowertoySystemMenuIface {
+public:
+  struct ItemInfo {
+    std::wstring name{};
+    bool enable{ false };
+    bool checkBox{ false };
+  };
+  virtual void SetConfiguration(PowertoyModuleIface* module, const std::vector<ItemInfo>& config) = 0;
+  virtual void ProcessSelectedItem(PowertoyModuleIface* module, HWND window, const wchar_t* itemName) = 0;
+};
+```
+
+## ItemInfo
+
+```cpp
+  struct ItemInfo {
+    std::wstring name{};
+    bool enable{ false };
+    bool checkBox{ false };
+  };
+```
+
+Structure containing all relevant information for system menu item: name (and hotkey if available), item
+status at creation (enabled/disabled) and whether check box will appear next to item name when action is taken.
+
+## SetConfiguration
+
+```cpp
+  virtual void SetConfiguration(PowertoyModuleIface* module, const std::vector<ItemInfo>& config) = 0;
+```
+
+Module should use this interface to inform system menu helper class which custom system menu items to create.
+
+## ProcessSelectedItem
+
+```cpp
+  virtual void ProcessSelectedItem(PowertoyModuleIface* module, HWND window, const wchar_t* itemName) = 0;
+```
+
+Process action taken on specific system menu item.
+
+# Code organization
+
+### [`powertoy_module_interface.h`](/src/modules/interface/powertoy_module_interface.h)
+Contains the PowerToys interface definition.
+
+### [`powertoy_system_menu.h`](/src/modules/interface/powertoy_system_module.h)
+Contains the PowerToys system menu helper interface definition.
+
+### [`lowlevel_keyboard_event_data.h`](/src/modules/interface/lowlevel_keyboard_event_data.h)
+Contains the `LowlevelKeyboardEvent` structure that's passed to `signal_event` for `ll_keyboard` events.
+
+### [`win_hook_event_data.h`](/src/modules/interface/win_hook_event_data.h)
+Contains the `WinHookEvent` structure that's passed to `signal_event` for `win_hook_event` events.
+

doc/devdocs/modules/powerrename.md

@@ -0,0 +1,26 @@
+#### [`dllmain.cpp`](/src/modules/powerrename/dll/dllmain.cpp)
+TODO
+
+#### [`PowerRenameExt.cpp`](/src/modules/powerrename/dll/PowerRenameExt.cpp)
+TODO
+
+#### [`Helpers.cpp`](/src/modules/powerrename/lib/Helpers.cpp)
+TODO
+
+#### [`PowerRenameItem.cpp`](/src/modules/powerrename/lib/PowerRenameItem.cpp)
+TODO
+
+#### [`PowerRenameManager.cpp`](/src/modules/powerrename/lib/PowerRenameManager.cpp)
+TODO
+
+#### [`PowerRenameRegEx.cpp`](/src/modules/powerrename/lib/PowerRenameRegEx.cpp)
+TODO
+
+#### [`Settings.cpp`](/src/modules/powerrename/lib/Settings.cpp)
+TODO
+
+#### [`trace.cpp`](/src/modules/powerrename/lib/trace.cpp)
+TODO
+
+#### [`PowerRenameUI.cpp`](/src/modules/powerrename/ui/PowerRenameUI.cpp)
+TODO

doc/devdocs/modules/shortcut_guide.md

@@ -0,0 +1,17 @@
+#### [`dllmain.cpp`](/src/modules/shortcut_guide/dllmain.cpp)
+Contains DLL boilerplate code.
+
+#### [`shortcut_guide.cpp`](/src/modules/shortcut_guide/shortcut_guide.cpp)
+Contains the module interface code. It initializes the settings values and the keyboard event listener.
+
+#### [`overlay_window.cpp`](/src/modules/shortcut_guide/overlay_window.cpp)
+Contains the code for loading the SVGs, creating and rendering of the overlay window.
+
+#### [`keyboard_state.cpp`](/src/modules/shortcut_guide/keyboard_state.cpp)
+Contains helper methods for checking the current state of the keyboard.
+
+#### [`target_state.cpp`](/src/modules/shortcut_guide/target_state.cpp)
+State machine that handles the keyboard events. It’s responsible for deciding when to show the overlay, when to suppress the Start menu (if the overlay is displayed long enough), etc.
+
+#### [`trace.cpp`](/src/modules/shortcut_guide/trace.cpp)
+Contains code for telemetry.

doc/devdocs/readme.md

@@ -0,0 +1,159 @@
+# Dev Documentation
+
+## Rules
+
+- **Follow the pattern of what you already see in the code.**
+- [Coding style](style.md).
+- Try to package new ideas/components into libraries that have nicely defined interfaces.
+- Package new ideas into classes or refactor existing ideas into a class as you extend.
+- When adding new classes/methods/changing existing code: add new unit tests or update the existing tests.
+
+## Github Workflow
+
+- Before starting to work on a fix/feature, make sure there is an open issue to track the work.
+- Add the `In progress` label to the issue, if not already present also add a `Cost-Small/Medium/Large` estimate and make sure all appropriate labels are set.
+- If you are a community contributor, you will not be able to add labels to the issue, in that case just add a comment saying that you started to work on the issue and try to give an estimate for the delivery date.
+- If the work item has a medium/large cost, using the markdown task list, list each sub item and update the list with a check mark after completing each sub item.
+- When opening a PR, follow the PR template.
+- When the PR is approved, let the owner of the PR merge it. For community contributions the reviewer that approved the PR can also merge it.
+- Use the `Squash and merge` option to merge a PR, if you don't want to squash it because there are logically different commits, use `Rebase and merge`.
+- We don't close issues automatically when referenced in a PR, so after the PR is merged:
+  - mark the issue(s), that the PR solved, with the `Resolution-Fix-Committed` label, remove the `In progress` label and if the issue is assigned to a project, move the item to the `Done` status.
+  - don't close the issue if it's a bug in the current released version since users tend to not search for closed issues, we will close the resolved issues when a new version is released.
+  - if it's not a code fix that effects the end user, the issue can be closed (for example a fix in the build or a code refactoring and so on).
+
+## Repository Overview
+
+General project organization:
+
+### The [`doc`](/doc) folder
+
+Documentation for the project.
+
+### The [`Wiki`](/wiki)
+
+The Wiki contains the current specs for the project.
+
+### The [`installer`](/installer) folder
+
+Contains the source code of the PowerToys installer.
+
+### The [`src`](/src) folder
+
+Contains the source code of the PowerToys runner and of all of the PowerToys modules. **This is where the most of the magic happens.**
+
+### The [`tools`](/tools) folder
+
+Various tools used by PowerToys. Includes the Visual Studio 2019 project template for new PowerToys.
+
+## Compiling PowerToys
+
+### Prerequisites for Compiling PowerToys
+
+1. Windows 10 April 2018 Update (version 1803) or newer
+2. Visual Studio Community/Professional/Enterprise 2019
+3. Run the command below in cmd/terminal to install all the workloads and components for VS.<br />
+**Note:** the script assumes VS is installed and Community edition. Please update path accordingly if Professional/Enterprise.
+
+```shell
+"%ProgramFiles(x86)%\Microsoft Visual Studio\Installer\vs_installer.exe" ^
+modify --installpath "%ProgramFiles(x86)%\Microsoft Visual Studio\2019\community" ^
+--add Microsoft.VisualStudio.Workload.NativeDesktop ^
+--add Microsoft.VisualStudio.Workload.ManagedDesktop ^
+--add Microsoft.VisualStudio.Workload.Universal ^
+--add Microsoft.VisualStudio.Component.Windows10SDK.17134 ^
+--add Microsoft.VisualStudio.ComponentGroup.UWP.VC ^
+--add Microsoft.VisualStudio.Component.VC.Runtimes.x86.x64.Spectre ^
+--add Microsoft.VisualStudio.Component.VC.ATL.Spectre
+```
+
+### Compiling Source Code
+
+- Open `powertoys.sln` in Visual Studio, in the `Solutions Configuration` drop-down menu select `Release` or `Debug`, from the `Build` menu choose `Build Solution`.
+- The PowerToys binaries will be in your repo under `x64\Release`.
+- If you want to copy the `PowerToys.exe` binary to a different location, you'll also need to copy the `modules` and the `svgs` folders.
+
+## Building the Installer (.MSI)
+
+### Prerequisites Building the Installer (.MSI)
+
+1. Install the [WiX Toolset Visual Studio 2019 Extension](https://marketplace.visualstudio.com/items?itemName=RobMensching.WiXToolset).
+2. Install the [WiX Toolset build tools](https://wixtoolset.org/releases/).
+
+### Compiling Installer (.MSI)
+
+- From the `installer` folder open `PowerToysSetup.sln` in Visual Studio, in the `Solutions Configuration` drop-down menu select `Release`, from the `Build` menu choose `Build Solution`.
+- The resulting `PowerToysSetup.msi` installer will be available in the `installer\PowerToysSetup\x64\Release\` folder.
+
+## Debugging
+
+The following configuration issue only applies if the user is a member of the Administrators group.
+
+Some PowerToys modules require being run with the highest permission level if the current user is a member of the Administrators group. The highest permission level is required to be able to perform some actions when an elevated application (e.g. Task Manager) is in the foreground or is the target of an action. Without elevated privileges some PowerToys modules will still work but with some limitations:
+
+- The `FancyZones` module will be not be able to move an elevated window to a zone.
+- The `Shortcut Guide` module will not appear if the foreground window belongs to an elevated application.
+
+To run and debug PowerToys from Visual Studio when the user is a member of the Administrators group, Visual Studio has to be started with elevated privileges. If you want to avoid running Visual Studio with elevated privileges and don't mind the limitations described above, you can do the following: open the `runner` project properties and navigate to the `Linker -> Manifest File` settings, edit the `UAC Execution Level` property and change it from `highestAvailable (level='highestAvailable')` to `asInvoker (/level='asInvoker')`, save the changes.
+
+## How to create new PowerToys
+
+See the instructions on [how to install the PowerToys Module project template](tools/project_template). <br />
+Specifications for the [PowerToys settings API](doc/specs/PowerToys-settings.md).
+
+## Implementation details
+
+### [`Runner`](runner.md)
+
+The PowerToys Runner contains the project for the PowerToys.exe executable.
+It's responsible for:
+
+- Loading the individual PowerToys modules.
+- Passing registered events to the PowerToys.
+- Showing a system tray icon to manage the PowerToys.
+- Bridging between the PowerToys modules and the Settings editor.
+
+![Image of the tray icon](/doc/images/runner/tray.png)
+
+### [`Interface`](modules/interface.md)
+
+Definition of the interface used by the [`runner`](/src/runner) to manage the PowerToys. All PowerToys must implement this interface.
+
+### [`Common`](common.md)
+
+The common lib, as the name suggests, contains code shared by multiple PowerToys components and modules, e.g. [json parsing](/src/common/json.h) and [IPC primitives](/src/common/two_way_pipe_message_ipc.h).
+
+### [`Settings`](settings.md)
+
+WebView project for editing the PowerToys settings.
+
+The html portion of the project that is shown in the WebView is contained in [`settings-html`](/src/settings/settings-heml).
+Instructions on how build a new version and update this project are in the [Web project for the Settings UI](./settings-web.md).
+
+While developing, it's possible to connect the WebView to the development server running in localhost by setting the `_DEBUG_WITH_LOCALHOST` flag to `1` and following the instructions near it in `./main.cpp`.
+
+### [`Settings-web`](settings-web.md)
+This project generates the web UI shown in the [PowerToys Settings](/src/editor).
+It's a `ReactJS` project created using [Fluent UI](https://developer.microsoft.com/en-us/fluentui#/).
+
+## Current modules
+### [`FancyZones`](modules/fancyzones.md)
+The FancyZones PowerToy that allows users to create custom zones on the screen, to which the windows will snap when moved.
+
+### [`PowerRename`](modules/powerrename.md)
+PowerRename is a Windows Shell Context Menu Extension for advanced bulk renaming using simple search and replace or more powerful regular expression matching.
+
+### [`Shortcut Guide`](modules/shortcut_guide.md)
+The Windows Shortcut Guide, displayed when the WinKey is held for some time.
+
+#### Options
+
+This module has a setting to serve as an example for each of the currently implemented settings property:
+
+- BoolToggle property
+- IntSpinner property
+- String property
+- ColorPicker property
+- CustomAction property
+
+![Image of the Options](/doc/images/example_powertoy/settings.png)

doc/devdocs/run-as-admin-detection.md

@@ -0,0 +1,50 @@
+# PowerToys and running as Administrator
+
+## Too long, Didn't Read 😁
+
+If you're running any application as an administrator (aka elevated) and PowerToys is not, a few things may not work correctly when the elevated applications are in focus or trying to interact with a PowerToys feature like FancyZones.
+
+## Having PowerToys keep functioning properly
+
+We understand users will run applications elevated. We do as well.  We have two options for you when this scenario happens:
+
+1. **Recommended:** PowerToys will prompt when we detect a process that is elevated.  Go to PowerToys settings inside the General Tab and click "Relaunch as administrator".
+2. Enable "Always run as administrator" in the PowerToys settings.
+
+## What is "Run as Administrator" / Elevated processes
+
+This is when a process runs with "elevated" privileges.  Typically this would be associated with the administrator accounts on a system.
+
+Basically it runs with additional access to the operating system.  Most things do not need run elevated. A common scenario would be needing to run certain PowerShell commands or edit the registry.
+
+How do i know my application is "elevated"?  If you see this prompt (User Access Control prompt), the application is requesting it:
+
+![alt text][uac]
+
+At times also, elevated terminals for instance, they will typically have the phrase "Administrator" appended to the title bar. Be warned, this isn't always the case it will be appended.
+
+![alt text][elevatedWindow]
+
+## When does PowerToys need this
+
+PowerToys in itself does not.  It only needs to be elevated when it has to interact with other applications that are running elevated. If those applications are in focus, PowerToys may not function unless it is elevated as well.
+
+These are the two scenarios we will not work in:
+
+1. Intercepting certain types of keyboard strokes
+2. Resizing / Moving windows
+
+### PowerToys affected
+
+1. FancyZones
+   - Snapping a window into a zone
+   - Moving the window to a different zone
+2. Shortcut guide
+   - Display shortcut
+3. Keyboard remapper
+   - key to key remapping
+   - Global level shortcuts remapping
+   - App-targeted shortcuts remapping
+
+[uac]: ../images/runAsAdmin/uac.png "User access control (UAC)"
+[elevatedWindow]: ../images/runAsAdmin/elevatedWindows.png "Run as admin"

doc/devdocs/runner.md

@@ -0,0 +1,36 @@
+#### [`main.cpp`](/src/runner/main.cpp)
+Contains the executable starting point, initialization code and the list of known PowerToys. All singletones are also initialized here at the start. Loads all the powertoys by scanning the `./modules` folder and `enable()`s those marked as enabled in `%LOCALAPPDATA%\Microsoft\PowerToys\settings.json` config. Then it runs [a message loop](https://docs.microsoft.com/en-us/windows/win32/winmsg/using-messages-and-message-queues) for the tray UI. Note that this message loop also [handles lowlevel_keyboard_hook events](https://github.com/microsoft/PowerToys/blob/1760af50c8803588cb575167baae0439af38a9c1/src/runner/lowlevel_keyboard_event.cpp#L24).
+
+#### [`general_settings.cpp`](./general_settings.cpp)
+#### [`powertoy_module.h`](/src/runner/powertoy_module.h) and [`powertoy_module.cpp`](/src/runner/powertoy_module.cpp)
+Contains code for initializing and managing the PowerToy modules. `PowertoyModule` is a RAII-style holder for the `PowertoyModuleIface` pointer, which we got by [invoking module DLL's `powertoy_create` function](https://github.com/microsoft/PowerToys/blob/1760af50c8803588cb575167baae0439af38a9c1/src/runner/powertoy_module.cpp#L13-L24).
+
+#### [`powertoys_events.cpp`](/src/runner/powertoys_events.cpp)
+Contains code that handles the various events listeners, and forwards those events to the PowerToys modules. You can learn more about the current event architecture [here](/doc/devdocs/shared-hooks.md).
+
+#### [`lowlevel_keyboard_event.cpp`](/src/runner/lowlevel_keyboard_event.cpp)
+Contains code for registering the low level keyboard event hook that listens for keyboard events. Please note that `signal_event` is called from the main thread for this event.
+
+#### [`win_hook_event.cpp`](/src/runner/win_hook_event.cpp)
+Contains code for registering a Windows event hook through `SetWinEventHook`, that listens for various events raised when a window is interacted with. Please note, that `signal_event` is called from a separate `dispatch_thread_proc` worker thread, so you must provide thread-safety for your `signal_event` if you intend to receive it. This is a subject to change.
+
+#### [`tray_icon.cpp`](/src/runner/tray_icon.cpp)
+Contains code for managing the PowerToys tray icon and its menu commands. Note that `dispatch_run_on_main_ui_thread` is used to 
+transfer received json message from the [Settings window](/doc/devdocs/settings.md) to the main thread, since we're communicating with it from [a dedicated thread](https://github.com/microsoft/PowerToys/blob/7357e40d3f54de51176efe54fda6d57028837b8c/src/runner/settings_window.cpp#L267-L271).
+#### [`settings_window.cpp`](/src/runner/settings_window.cpp)
+Contains code for starting the PowerToys settings window and communicating with it. Settings window is a separate process, so we're using [Windows pipes](https://docs.microsoft.com/en-us/windows/win32/ipc/pipes) as a transport for json messages.
+
+#### [`general_settings.cpp`](/src/runner/general_settings.cpp)
+Contains code for loading, saving and applying the general setings.
+
+#### [`auto_start_helper.cpp`](/src/runner/auto_start_helper.cpp)
+Contains helper code for registering and unregistering PowerToys to run when the user logs in.
+
+#### [`unhandled_exception_handler.cpp`](/src/runner/unhandled_exception_handler.cpp)
+Contains helper code to get stack traces in builds. Can be used by adding a call to `init_global_error_handlers` in [`WinMain`](./main.cpp).
+
+#### [`trace.cpp`](/src/runner/trace.cpp)
+Contains code for telemetry.
+
+#### [`svgs`](/src/runner/svgs/)
+Contains the SVG assets used by the PowerToys modules.

doc/devdocs/settings-reference.md

@@ -0,0 +1,597 @@
+# Settings
+
+While the module interface passes the settings and values thorough a JSON string, **use our helper functions**. In future we might move to a different implementation. All current modules use:
+  * `load_module_settings` to load the settings from the disk.
+  * `PowerToySettings::Settings` class to define module properties and the settings screen.
+  * `PowerToySettings::PowerToyValues` class to parse the JSON passed by the runner.
+  * `save_module_settings` to store the settings on the disk.
+
+Most functions provide two overloads - one that accepts UINT with a resource ID and one that accepts strings. **Put all strings in the resource file and use the resource ID overload.**
+
+
+The following documents internal workings of the settings system.
+
+## Overview
+
+PowerToys runner provides a generic way for modules to define their settings.
+
+Each module on startup is responsible for loading its own settings and initializing accordingly. When the user wants to edit settings, the runner will call [`get_config()`](modules/interface.md#get_config) module method. The module must provide a JSON which includes the module name, description but also what settings options are provided. 
+
+When settings from all modules are collected, a separate [settings editor app](/src/settings) is spawned. The editor wraps [an React app](/src/settings-web) and handles the communication with the runner.
+
+When loaded, the React app receives the JSON passed by the runner. When user saves the settings, the editor passes the new settings values as JSON string to the runner. Runner in turn will call [`set_config()`](modules/interface.md#set_config) for all modules with appropriate JSON. When user initiates a custom action (like the Zone Editor in FancyZones), the runner will call [`call_custom_action()`](modules/interface.md#call_custom_action) providing the action name in a JSON.
+
+There are C++ helper functions in [/src/common/settings_objects.h](/src/common/settings_objects.h) and [/src/common/settings_helpers.h](/src/common/settings_helpers.h). Those include classes for creating the settings options JSON and ones for parsing the incoming settings JSON.
+
+### Module settings
+The value returned by the [`get_config()`](modules/interface.md#get_config) call should provide a JSON object with following fields:
+  * `name` - The name of the PowerToy. Used on the nav panel on the left.
+  * `version` - The settings version. Needs to be set to `"1.0"`.
+  * `description` - Description of the PowerToy module.
+  * `overview_link`, `video_link` - Optional links to the documentation and video preview of the PowerToy module.
+  * `icon_key` - Name of the icon of the PowerToy. The SVGs for the icons are located in [/src/settings-web/src/svg](/src/settings-web/src/svg). They also need to be added in [/settings-web/src/setup_icons.tsx](/settings-web/src/setup_icons.tsx).
+  * `properties` - Optional object that contains the definition of the settings screen.
+
+The `properties` JSON object defines what settings controls are available to the user. Each key defines one control. The controls have some common properties:
+  * The key in the `properties` which identifies the control.
+  * `editor_type` - Defines the type of the control. Those are listed further.
+  * `order` - Defines the order of the elements on the settings screen.
+
+Each `editor_type` has its own set of properties.
+
+Example module JSON (taken from Shortcut Guide):
+```json
+{
+    "name": "Shortcut Guide",
+    "version": "1.0",
+    "description": "Shows a help overlay with Windows shortcuts when the Windows key is pressed.",
+    "overview_link": "https://github.com/.../README.md",
+    "icon_key": "pt-shortcut-guide",
+    "properties": {
+        "press_time": {
+            "editor_type": "int_spinner",
+            "order": 1,
+            "display_name": "How long to press the Windows key before showing the Shortcut Guide (ms)",
+            "value": 900,
+            "min": 100,
+            "max": 10000,
+            "step": 100
+        },
+        "overlay_opacity": {
+            "editor_type": "int_spinner",
+            "order": 2,
+            "display_name": "Opacity of the Shortcut Guide's overlay background (%)",
+            "value": 90,
+            "min": 0,
+            "max": 100,
+            "step": 1
+        },
+        "theme":{
+            "editor_type": "choice_group",
+            "order": 3,
+            "display_name": "Choose Shortcut Guide overlay color",
+            "value": "system",
+            "options": [ {"key": "system", "text": "System default app mode"},
+                         {"key": "light", "text": "Light"},
+                         {"key": "dark", "text": "Dark"} ]
+        }
+    }
+}
+```
+produces this settings screen:
+
+![Shortcut Guide settings](../images/settings/shortcut_guide_settings.png)
+
+### Helper methods
+
+PowerToys provides [a helper class](/src/common/json.h) to parse and generate JSON strings.
+
+In [`settings_helpers.h`](/src/common/settings_helpers.h) there are two helper functions: `load_module_settings(powertoy_name)` and `save_general_settings(settings)` for loading and saving the module configuration.
+
+In [`settings_objects.h`](/src/common/settings_objects.h) there are some helper classes:
+  * `Settings` - for generating JSON with module settings definition.
+  * `PowerToyValues` - for parsing JSON with settings - either loaded from file or from the settings editor.
+  * `CustomActionObject` and `HotkeyObject` - for parsing custom actions and hotkey input specific JSON.
+
+### General settings
+General settings control the PowerToys runner and decide which modules are enabled and which are not. The general settings screen is special - while modules provide the definition of the settings controls, the available settings on the general screen are hardcoded.
+
+General settings has following properties:
+  * `enabled` - Enabled/disabled status of each PowerToy.
+  * `startup` - Should PowerToys start at user logon.
+  * `theme` - Settings editor theme - `light`, `dark` or `system`.
+  * `system_theme` - Current Windows theme - `light` or `dark`.
+  * `powertoys_version` - The version of the PowerToys.
+
+This JSON:
+```json
+{
+    "enabled": {
+        "FancyZones": true,
+        "PowerRename": true,
+        "Shortcut Guide": true
+    },
+    "startup": true,
+    "theme": "light",
+    "system_theme": "dark",
+    "powertoys_version": "0.14.2.0"
+}
+```
+Produces this general settings screen:
+
+![General settings](../images/settings/general_settings.png)
+
+## Putting it all together
+The runner combines general settings and each module settings into a single JSON that is passed to the settings editor. Example combined settings look like this:
+
+```json
+{
+    "general": {
+        "enabled": {
+            "FancyZones": true,
+            "PowerRename": true,
+            "Shortcut Guide": true
+        },
+        "startup": true,
+        "theme": "light",
+        "system_theme": "dark",
+        "powertoys_version": "0.14.2.0"
+    },
+    "powertoys": {
+        "FancyZones": { ... }, 
+        "PowerRename": { ... },
+        "Shortcut Guide":{
+            "name": "Shortcut Guide",
+            "version": "1.0",
+            "description": "Shows a help overlay with Windows shortcuts when the Windows key is pressed.",
+            "overview_link": "https://github.com/.../README.md",
+            "icon_key": "pt-shortcut-guide",
+            "properties": { ... }
+        }
+    }
+}
+```
+
+## C++ helpers
+While you can generate and parse JSON yourself there are helper methods provided.
+
+### Loading settings
+When a PowerToy module is created, it should load its configuration. This can be done by calling
+```c++
+json::JsonObject PTSettingsHelper::load_module_settings(std::wstring_view powertoy_name);
+```
+declared in [`settings_helpers.h`](/src/common/settings_helpers.h). The function will return an `json::JsonObject` object containing the module settings. 
+
+Another option is using [`PowerToySettings::PowerToyValues`](/src/common/settings_objects.h#L67) class. A static method
+```c++
+PowerToyValues PowerToyValues::load_from_settings_file(std::wstring_view powertoy_name);
+```
+will load and parse the settings. You can also use
+```c++
+PowerToyValues PowerToyValues::from_json_string(std::wstring_view json);
+```
+to parse JSON string - for example when implementing [`set_config()`](modules/interface.md#set_config). The returned `PowerToyValues` object has helper methods that return `std::optional` with values, for example:
+```c++
+auto settings = PowerToyValues::load_from_settings_file(L"some_powertoy");
+std::optional<std::wstring> str_prop = settings.get_string_value(L"some_string_property");
+auto int_prop = settings.get_int_value(L"some_int_property");
+```
+
+### Generating settings screen
+The [`PowerToySettings::Settings`](/src/common/settings_objects.h) can be used to generate settings:
+```c++
+// Need to get strings from the resource file.
+extern "C" IMAGE_DOS_HEADER __ImageBase;
+
+auto hinstance = reinterpret_cast<HINSTANCE>(&__ImageBase);
+PowerToysSettings::Settings settings(hinstance, L"example_powertoy");
+settings.set_description(L"Example powertoy.");
+settings.set_overview_link(L"https://example.com");
+settings.set_icon_key(L"pt-example");
+settings.add_string(L"string_val", L"Example string label", L"example value");
+settings.add_int_spinner(L"int_val", L"Example int label", 0, 0, 100, 10);
+``` 
+You can then use `std::wstring serialize()` or `bool serialize_to_buffer(wchar_t* buffer, int* buffer_size)` methods to generate output JSON string.
+
+### Saving settings
+Use 
+```c++
+void PTSettingsHelper::save_module_settings(std::wstring_view powertoy_name, json::JsonObject& settings);
+```
+declared in [`settings_helpers.h`](/src/common/settings_helpers.h).
+
+## Module settings elements
+
+### Bool toggle
+```c++
+add_bool_toggle(name, description, value) 
+```
+A simple on-off toggle. Parameters:
+  * `name` - Key for the element in the JSON.
+  * `description` - String or resource ID of the text displayed to the user.
+  * `value` - Initial state of the toggle (`true` - on, `false` - off).
+
+This C++:
+```c++
+settings.add_bool_toggle(L"bool_name", L"description", true);
+```
+produces this settings element:
+
+![Bool Toggle](../images/settings/bool_toggle.png)
+
+and this generated JSON:
+```json
+{
+    "properties": {
+        "bool_name": {
+            "editor_type": "bool_toggle",
+            "order": autoincremented_number,
+            "display_name": "description",
+            "value": true
+        }
+    }
+}
+```
+
+The toggle value is stored as bool:
+```c++
+std::optional<bool> bool_value = settings.get_bool_value(L"bool_name");
+```
+
+### Int Spinner
+```c++
+add_int_spinner(name, description, value, min, max, step)
+```
+Numeric input with dials to increment and decrement the value. Parameters:
+  * `name` - Key for element in the JSON.
+  * `description` - String or resource ID of the text displayed to the user.
+  * `value` - Initial control value.
+  * `min`, `max` - Minimum and maximum values for the input. User cannot use dials to move beyond those values, if a value out of range is inserted using the keyboard, it will get clamped to the allowed range.
+  * `step` - How much the dials change the value.
+
+This C++:
+```c++
+settings.add_int_spinner(L"int_spinner_name", L"description", 50, -100, 100, 10);
+```
+produces this settings element:
+
+![Int Spinner](../images/settings/int_spinner.png)
+
+and this generated JSON:
+```json
+{
+    "properties": {
+        "int_spinner_name": {
+            "editor_type": "int_spinner",
+            "order": autoincremented_number,
+            "display_name": "description",
+            "value": 50,
+            "min": -100,
+            "max": 100,
+            "step": 10
+        }
+    }
+}
+```
+
+The spinner value is stored as int:
+```c++
+std::optional<int> int_value = settings.get_int_value(L"int_spinner_name");
+```
+
+### String
+```c++
+add_string(name, description, value) 
+```
+Single line text input. Parameters:
+  * `name` - Key for element in the JSON.
+  * `description` - String or resource ID of the text displayed to the user.
+  * `value` - Default value for the input.
+
+This C++:
+```c++
+settings.add_string(L"string_name", L"description", L"value");
+```
+produces this settings element:
+
+![String](../images/settings/string.png)
+
+and this generated JSON:
+```json
+{
+    "properties": {
+        "string_name": {
+            "editor_type": "string_text",
+            "order": autoincremented_number,
+            "display_name": "description",
+            "value": "value"
+        }
+    }
+}
+```
+
+The input value is stored as `std::wstring`:
+```c++
+std::optional<std::wstring> string_value = settings.get_string_value(L"string_name");
+```
+
+### Multiline string
+```c++
+add_multiline_string(name, description, value)
+```
+Multiline text input. Parameters:
+  * `name` - Key for element in the JSON.
+  * `description` - String or resource ID of the text displayed to the user.
+  * `value` - Default value for the input. Can have multiple lines.
+
+This C++:
+```c++
+settings.add_multiline_string(L"multiline_name", L"description", L"multiline1\nmultiline2");
+```
+produces this settings element:
+
+![Multiline](../images/settings/multiline.png)
+
+and this generated JSON:
+```json
+{
+    "properties": {
+        "multiline_name": {
+            "editor_type": "string_text",
+            "multiline": true,
+            "order": autoincremented_number,
+            "display_name": "description",
+            "value": "multiline1\nmultiline2"
+        }
+    }
+}
+```
+
+The input value is stored as string:
+```c++
+std::optional<std::wstring> value = settings.get_string_value(L"multiline_name");
+```
+
+### Color picker
+```c++
+add_color_picker(name, description, value)
+```
+
+Allows user to pick a color. Parameters:
+  * `name` - Key for element in the JSON.
+  * `description` - String or resource ID of the text displayed to the user.
+  * `value` - Initial color, as a string in `"#RRGGBB"` format.
+
+This C++:
+```c++
+settings.add_color_picker(L"colorpicker_name", L"description", L"#102040");
+```
+produces this settings element:
+
+![Color Picker](../images/settings/color_picker.png)
+
+and this generated JSON:
+```json
+{
+    "properties": {
+        "colorpicker_name": {
+            "editor_type": "color_picker",
+            "order": autoincremented_number,
+            "display_name": "description",
+            "value": "#102040"
+        }
+    }
+}
+```
+
+The color picker value is stored as `std::wstring`:
+```c++
+std::optional<std::wstring> value = settings.get_string_value(L"colorpicker_name");
+```
+
+### Hotkey
+```c++
+settings.add_hotkey(name, description, hotkey)
+```
+Input for capturing hotkeys. Parameters:
+  * `name` - Key for element in the JSON.
+  * `description` - String or resource ID of the text displayed to the user.
+  * `hotkey` - Instance of `PowerToysSettings::HotkeyObject` class.
+
+You can create `PowerToysSettings::HotkeyObject` object either by using helper `from_settings` static method or by providing JSON object to `from_json` static method:
+
+The `PowerToysSettings::HotkeyObject::from_settings` take following parameters:
+  * `win_pressed` - Is the WinKey pressed.
+  * `ctrl_pressed` - Is the Ctrl key pressed.
+  * `alt_pressed` - Is the Alt key pressed.
+  * `shift_pressed` - Is the Shift key pressed.
+  * `vk_code` - The [virtual key-code](https://docs.microsoft.com/en-us/windows/win32/inputdev/virtual-key-codes) of the key.
+
+The displayed key is deduced from the `vk_code` using the users keyboard layout and language settings.
+
+Similar parameters can be passed using the `from_json` static method:
+```c++
+json::JsonObject json;
+json.SetNamedValue(L"win", json::value(win_pressed)); 
+json.SetNamedValue(L"ctrl", json::value(ctrl_pressed));
+json.SetNamedValue(L"alt", json::value(alt_pressed));
+json.SetNamedValue(L"shift", json::value(shift_pressed));
+json.SetNamedValue(L"code", json::value(vk_code));
+json.SetNamedValue(L"key", json::value(L"string with key name"));
+auto hotkey = PowerToysSettings::HotkeyObject::from_json(json);
+```
+
+  
+This C++:
+```c++
+settings.add_hotkey(L"hotkey_name",
+                    L"description",
+                    PowerToysSettings::HotkeyObject::from_settings(true, true, true, true, VK_F5));
+```
+produces this settings element:
+
+![Hotkey](../images/settings/hotkey.png)
+
+and this generated JSON (`114` is the value of `VK_F5`):
+```json
+{
+    "properties": {
+        "hotkey_name": {
+            "editor_type": "hotkey",
+            "order": autoincremented_number,
+            "display_name": "description",
+            "value": {
+                "win": true,
+                "ctrl": true,
+                "alt": true,
+                "shift": true,
+                "code": 114,
+                "key": "F5"
+            }
+        }
+    }
+}
+```
+
+The hotkey value is returned as JSON, with the same format as `from_json` method uses. You can use `HotkeyObject` class to parse this JSON, since it offers some helper methods. A typical example of registering a hotkey:
+```c++
+std::optional<json::JsonObject> value = settings.get_json(L"hotkey_name");
+if (value) {
+    auto hotkey = PowerToysSettings::HotkeyObject::from_json(*value);
+    RegisterHotKey(hwnd, 1, hotkey.get_modifiers(), hotkey.get_code());
+}
+```
+
+### Choice group
+```c++
+add_choice_group(name, description, value, vector<pair<wstring, wstring>> keys_and_texts)
+add_choice_group(name, description, value, vector<pair<wstring, UINT>> keys_and_texts)
+```
+
+A radio buttons group. Parameters:
+  * `name` - Key for element in the JSON.
+  * `description` - String or resource ID of the text displayed to the user.
+  * `value` - Key selected by default.
+  * `keys_and_text` - Vector of radio buttons definitions: key and the displayed label. The texts can either be strings or resource IDs.
+
+This C++:
+```c++
+settings.add_choice_group(L"choice_group_name", L"description", L"val1", { { L"val1", L"value-1" },
+                                                                           { L"val2", L"value-2" },
+                                                                           { L"val3", L"value-3" } });
+```
+produces this settings element:
+
+![Choice group](../images/settings/choice_group.png)
+
+and this generated JSON:
+```json
+{
+    "properties": {
+        "choice_group_name": {
+            "editor_type": "choice_group",
+            "order": autoincremented_number,
+            "display_name": "description",
+            "value": "val1",
+            "options": [ {"key": "val1", "text": "value-1"},
+                         {"key": "val2", "text": "value-2"},
+                         {"key": "val3", "text": "value-3"} ]
+            }
+        }
+    }
+}
+```
+
+The chosen button value is stored as a string with the key of the button selected by the user:
+```c++
+std::optional<std::wstring> value = settings.get_string_value(L"choice_group_name");
+```
+
+### Dropdown
+```c++
+add_dropdown(name, description, value, vector<pair<wstring, wstring>> keys_and_texts)
+add_dropdown(name, description, value, vector<pair<wstring, UINT>> keys_and_texts)
+```
+
+A dropdown. Parameters:
+  * `name` - Key for element in the JSON.
+  * `description` - String or resource ID of the text displayed to the user.
+  * `value` - Key selected by default.
+  * `keys_and_text` - Vector of the options definitions: key and the displayed label. The texts can either be strings or resource IDs.
+
+This C++:
+```c++
+settings.add_dropdown(L"dropdown_name", L"description", L"val2", { { L"val1", L"value-1" },
+                                                                   { L"val2", L"value-2" },
+                                                                   { L"val3", L"value-3" } });
+```
+produces this settings element:
+
+![Dropdown 1](../images/settings/dropdown_1.png)
+
+![Dropdown 2](../images/settings/dropdown_2.png)
+
+and this generated JSON:
+```json
+{
+    "properties": {
+        "dropdown_name": {
+            "editor_type": "dropdown",
+            "order": autoincremented_number,
+            "display_name": "description",
+            "value": "val1",
+            "options": [ {"key": "val1", "text": "value-1"},
+                         {"key": "val2", "text": "value-2"},
+                         {"key": "val3", "text": "value-3"} ]
+            }
+        }
+    }
+}
+```
+
+The chosen value is stored as a string with the key of the option selected by the user:
+```c++
+std::optional<std::wstring> value = settings.get_string_value(L"dropdown_name");
+```
+### Custom action
+
+```c++
+add_custom_action(name, description, button_text, ext_description)
+```
+
+Adds a button with a description. Parameters:
+  * `name` - Key for element in the JSON.
+  * `description` - String or resource ID of the text displayed to the user.
+  * `button_text` - String or resource ID for the button label.
+  * `ext_description` - String or resource ID for the extended description.
+
+This C++:
+```c++
+settings.add_custom_action(L"custom_action_name", L"description", L"button_text", L"ext_description");
+```
+produces this settings element:
+
+![Custom action](../images/settings/custom_action.png)
+
+and this generated JSON:
+```json
+{
+    "properties": {
+        "custom_action_name": {
+            "editor_type": "custom_action",
+            "order": autoincremented_number,
+            "display_name": "description",
+            "button_text": "button_text",
+            "value": "ext_description"
+        }
+    }
+}
+```
+
+When the button is pressed, the `call_custom_action` method of the module will be called, with JSON containing the name of the action. In our example:
+```json
+{ 
+    "action_name":"custom_action_name",
+    "value":"ext_description"
+}
+```

doc/devdocs/settings-web.md

@@ -1,10 +1,3 @@
-# Web project for the Settings UI
-
-## Introduction
-
-This project generates the web UI shown in the [PowerToys Settings](/src/editor).
-It's a `ReactJS` project created using [UI Fabric](https://developer.microsoft.com/en-us/fabric#/).
-
 ## Build Commands
 
 Here are the commands to build and test this project:
@@ -22,9 +15,11 @@ npm run start
 npm run build
 ```
 
+**Note:** you will need to rebuild the settings project to pick up the changes
+
 ## Updating the icons
 
-Icons inside [`src/icons/`](./src/icons/) were generated from the [Office UI Fabric Icons subset generation tool.](https://uifabricicons.azurewebsites.net/)
+Icons inside [`src/icons/`](/src/settings-web/src/icons/) were generated from the [Office UI Fabric Icons subset generation tool.](https://uifabricicons.azurewebsites.net/)
 
 In case the subset needs to be changed, additional steps are needed to include the icon font in the built `dist/bundle.js`:
 - Copy the inline font data taken from [`src/icons/css/fabric-icons-inline.css`](src/icons/css/fabric-icons-inline.css) and place it in the `fontFace` `src` value in [`src/icons/src/fabric-icons.ts`](src/icons/src/fabric-icons.ts).
@@ -37,44 +32,44 @@ SVG icons, including the icons for each PowerToy listed in the Settings, are con
 
 The project structure is based on the [`UI Fabric` scaffold](https://developer.microsoft.com/en-us/fabric#/get-started/web#option-1-quick-start) obtained by initializing it with `npm init uifabric`.
 
-#### [index.html](./index.html)
+#### [index.html](/src/settings-web/index.html)
 The HTML entry-point of the project.
 Loads the `ReactJS` distribution script.
 Defines JavaScript functions to receive and send messages to the [PowerToys Settings](/src/editor) window.
 
-#### [src/index.tsx](./src/index.tsx)
+#### [src/index.tsx](/src/settings-web/src/index.tsx)
 Main `ReactJS` entrypoint, initializing the `ReactDOM`.
 
-#### [src/setup_icons.tsx](./src/setup_icons.tsx)
+#### [src/setup_icons.tsx](/src/settings-web/src/setup_icons.tsx)
 Defines the `setup_powertoys_icons` function that registers the icons to be used in the components.
 
-#### [src/components/](./src/components/)
+#### [src/components/](/src/settings-web/src/components/)
 Contains the `ReactJS` components, including the Settings controls for each type of setting.
 
-#### [src/components/App.tsx](./src/components/App.tsx)
+#### [src/components/App.tsx](/src/settings-web/src/components/App.tsx)
 Defines the main App component, containing the UI layout, navigation menu, dialogs and main load/save logic.
 
-#### [src/components/GeneralSettings.tsx](./src/components/GeneralSettings.tsx)
+#### [src/components/GeneralSettings.tsx](/src/settings-web/src/components/GeneralSettings.tsx)
 Defines the PowerToys General Settings component, including logic to construct the object sent to PowerToys to change the General settings.
 
-#### [src/components/ModuleSettings.tsx](./src/components/ModuleSettings.tsx)
+#### [src/components/ModuleSettings.tsx](/src/settings-web/src/components/ModuleSettings.tsx)
 Defines the component that generates the settings screen for a PowerToy depending on its settings definition.
 
-#### [src/components/BaseSettingsControl.tsx](./src/components/BaseSettingsControl.tsx)
+#### [src/components/BaseSettingsControl.tsx](/src/settings-web/src/components/BaseSettingsControl.tsx)
 Defines the base class for a Settings control.
 
-#### [src/css/layout.css](./src/css/layout.css)
+#### [src/css/layout.css](/src/settings-web/src/css/layout.css)
 General layout styles.
 
-#### [src/icons/](./src/icons/)
+#### [src/icons/](/src/settings-web/src/icons/)
 Icons generated from the [Office UI Fabric Icons subset generation tool.](https://uifabricicons.azurewebsites.net/)
 
-#### [src/svg/](./src/svg/)
+#### [src/svg/](/src/settings-web/src/svg/)
 SVG icon assets.
 
 ## Creating a new settings control
 
-The [`BaseSettingsControl` class](./src/components/BaseSettingsControl.tsx) can be extended to create a new Settings control type.
+The [`BaseSettingsControl` class](/src/settings-web/src/components/BaseSettingsControl.tsx) can be extended to create a new Settings control type.
 
 ```tsx
 export class BaseSettingsControl extends React.Component <any, any> {
@@ -92,7 +87,7 @@ export class BaseSettingsControl extends React.Component <any, any> {
 A settings control overrides the `get_value` function to return the value to be used for the Setting the control is representing.
 It will use the `parent_on_change` property to signal that the user made some changes to the settings.
 
-Here's the [`StringTextSettingsControl`](./src/components/StringTextSettingsControl.tsx) component to serve as an example:
+Here's the [`StringTextSettingsControl`](/src/settings-web/src/components/StringTextSettingsControl.tsx) component to serve as an example:
 
 ```tsx
 export class StringTextSettingsControl extends BaseSettingsControl {
@@ -153,8 +148,8 @@ Each settings property has a `editor_type` field that's used to differentiate be
 }
 ```
 
-A new Settings control component can be added to [`src/components/`](./src/components/).
-To render the new Settings control, its `editor_type` and component instance need to be added to the [`ModuleSettings` component render()](./src/components/ModuleSettings.tsx):
+A new Settings control component can be added to [`src/components/`](/src/settings-web/src/components/).
+To render the new Settings control, its `editor_type` and component instance need to be added to the [`ModuleSettings` component render()](/src/settings-web/src/components/ModuleSettings.tsx):
 ```tsx
 import React from 'react';
 import {StringTextSettingsControl} from './StringTextSettingsControl';

doc/devdocs/settings.md

@@ -0,0 +1,287 @@
+# Settings
+
+## Overview
+
+PowerToys provides a common framework for settings. It can be used to save and load settings on disk, and provides a user interface for changing the options.
+
+## Initialization
+When a PowerToy module is created, it should load its configuration using [`PowerToyValues`](/src/common/settings_objects.h) class. The class provides static `load_from_settings_file` method which takes one parameter - the PowerToy module name. The `PowerToyValues` class provides methods to extract values. The method return `std::optional` - it is possible, that the method will return `std::nullopt` in which case you must use defaults.
+```c++
+class ExamplePowertoy : public PowertoyModuleIface
+{
+public:
+    ExamplePowertoy()
+    {
+        auto settings = PowerToySettings::PowerToyValues::load_from_settings_file(L"Example Powertoy");
+        // See if value is set, otherwise keep the default value
+        if (auto int_value = settings.get_int_value(L"int_setting"))
+        {
+            m_int_setting = *int_value;
+        }
+        if (auto string_value = setting.get_string_value("string_setting"))
+        {
+            m_string_setting = *string_value;
+        }
+    }
+    // ...
+private:
+    // Settings and their default values
+    int m_int_setting = 10;
+    std::wstring m_string_setting = L"default";
+}
+```
+
+## Settings screen
+When users starts the settings screen, the runner will call the [`get_config()`](modules/interface.md) method. The interface expects the method to fill provided buffer. Use the [`Settings`](/src/common/settings_objects.h) class to construct proper response with proper format. The class has helper method to set description and links fields, it also provides a way to define the content of the settings screen. Keep all the strings in the resource file and provide the resource IDs to the methods.
+```c++
+extern "C" IMAGE_DOS_HEADER __ImageBase; // Needed to get strings from the resource file
+
+bool ExamplePowertoy::get_config(wchar_t* buffer, int* buffer_size)
+{
+    PowerToySettings::Settings settings(reinterpret_cast<HINSTANCE>(&__ImageBase), L"Example Powertoy");
+    // Set PowerToy description
+    settings.set_description(IDS_POWERTOY_DESCRIPTION);
+    settings.set_icon_key("pt_icon_key");
+    settings.set_overview_link(IDS_POWERTOY_OVERVIEW_LINK);
+    settings.set_video_link(IDS_POWERTOY_OVERVIEW_LINK);
+
+    // Add int and string settings, provide current values:
+    settings.add_int_spinner(L"int_setting", IDS_INT_SETTING_DESCRIPTION, m_int_setting, 0, 100, 10);
+    settings.add_string(L"string_setting", IDS_STRING_SETTING_DESCRIPTION, m_string_setting);
+
+    // Use the build-in machinery to return the configuration:
+    return settings.serialize_to_buffer(buffer, buffer_size);
+}
+```
+The list of all the available settings elements and their description is [further in this doc](#available-settings-elements). New PowerToy icons need to be [added to the `settings-web` project](https://github.com/microsoft/PowerToys/blob/master/doc/devdocs/settings-web.md#updating-the-icons).
+
+## User changes settings
+When user closes the settings screen, the runner will call the [`get_config()`](modules/interface.md) method. Use [`PowerToyValues`](/src/common/settings_objects.h) class static `from_json_string` method to parse the settings. After that, the code is similar to loading the settings from disk:
+```c++
+void ExamplePowertoy::set_config(const wchar_t* config)
+{
+    auto settings = PowerToySettings::PowerToyValues::from_json_string(config);
+    // See if value is set update the values
+    if (auto int_value = settings.get_int_value(L"int_setting"))
+    {
+        m_int_setting = *int_value;
+    }
+    if (auto string_value = setting.get_string_value("string_setting"))
+    {
+        m_string_setting = *string_value;
+    }
+    // Save the new settings to disk
+    settings.save_to_settings_file();
+}
+```
+
+## Detailed reference
+For a detailed reference of how the settings are implemented in the runner and in the settings editor, consult [this detailed guide](settings-reference.md).
+
+# Available settings elements
+
+## Bool toggle
+<table><tr><td align="center">
+<img src="../images/settings/bool_toggle.png" width="80%">
+</td></tr></table>
+
+```c++
+settings.add_bool_toggle(name, description, value) 
+```
+A simple on-off toggle. Parameters:
+  * `name` - Key for the element in the JSON.
+  * `description` - Resource ID of the text displayed to the user.
+  * `value` - Initial state of the toggle (`true` - on, `false` - off).
+
+The toggle value is stored as bool:
+```c++
+std::optional<bool> bool_value = settings.get_bool_value(L"bool_name");
+```
+
+## Int Spinner
+<table><tr><td align="center">
+<img src="../images/settings/int_spinner.png" width="80%">
+</td></tr></table>
+
+```c++
+settings.add_int_spinner(name, description, value, min, max, step)
+```
+Numeric input with dials to increment and decrement the value. Parameters:
+  * `name` - Key for element in the JSON.
+  * `description` - Resource ID of the text displayed to the user.
+  * `value` - Initial control value.
+  * `min`, `max` - Minimum and maximum values for the input. User cannot use dials to move beyond those values, if a value out of range is inserted using the keyboard, it will get clamped to the allowed range.
+  * `step` - How much the dials change the value.
+
+The spinner value is stored as int:
+```c++
+std::optional<int> int_value = settings.get_int_value(L"int_spinner_name");
+```
+
+## String
+<table><tr><td align="center">
+<img src="../images/settings/string.png" width="80%">
+</td></tr></table>
+
+```c++
+settings.add_string(name, description, value)
+```
+Single line text input. Parameters:
+  * `name` - Key for element in the JSON.
+  * `description` - Resource ID of the text displayed to the user.
+  * `value` - Default value for the input.
+
+The input value is stored as `std::wstring`:
+```c++
+std::optional<std::wstring> string_value = settings.get_string_value(L"string_name");
+```
+
+## Multiline string
+<table><tr><td align="center">
+<img src="../images/settings/multiline.png" width="80%">
+</td></tr></table>
+
+```c++
+settings.add_multiline_string(name, description, value)
+```
+Multiline text input. Parameters:
+  * `name` - Key for element in the JSON.
+  * `description` - Resource ID of the text displayed to the user.
+  * `value` - Default value for the input. Can have multiple lines.
+
+The input value is stored as string:
+```c++
+std::optional<std::wstring> value = settings.get_string_value(L"multiline_name");
+```
+
+## Color picker
+<table><tr><td align="center">
+<img src="../images/settings/color_picker.png" width="80%">
+</td></tr></table>
+
+```c++
+settings.add_color_picker(name, description, value)
+```
+
+Allows user to pick a color. Parameters:
+  * `name` - Key for element in the JSON.
+  * `description` - Resource ID of the text displayed to the user.
+  * `value` - Initial color, as a string in `"#RRGGBB"` format.
+
+The color picker value is stored as `std::wstring` as `#RRGGBB`:
+```c++
+std::optional<std::wstring> value = settings.get_string_value(L"colorpicker_name");
+```
+
+## Hotkey
+<table><tr><td align="center">
+<img src="../images/settings/hotkey.png" width="80%">
+</td></tr></table>
+
+```c++
+settings.add_hotkey(name, description, hotkey)
+```
+Input for capturing hotkeys. Parameters:
+  * `name` - Key for element in the JSON.
+  * `description` - Resource ID of the text displayed to the user.
+  * `hotkey` - Instance of `PowerToysSettings::HotkeyObject` class.
+
+You can create `PowerToysSettings::HotkeyObject` object either by using helper `from_settings` static method or by providing a JSON object to `from_json` static method.
+
+The `PowerToysSettings::HotkeyObject::from_settings` take following parameters:
+  * `win_pressed` - Is the WinKey pressed.
+  * `ctrl_pressed` - Is the Ctrl key pressed.
+  * `alt_pressed` - Is the Alt key pressed.
+  * `shift_pressed` - Is the Shift key pressed.
+  * `vk_code` - The [virtual key-code](https://docs.microsoft.com/en-us/windows/win32/inputdev/virtual-key-codes) of the key.
+
+The displayed key is deduced from the `vk_code` using the users keyboard layout and language settings.
+
+The hotkey value is returned as JSON, which can be used with the `from_json` method to create a `HotkeyObject` object. A typical example of registering a hotkey:
+```c++
+std::optional<json::JsonObject> value = settings.get_json(L"hotkey_name");
+if (value) {
+    auto hotkey = PowerToysSettings::HotkeyObject::from_json(*value);
+    RegisterHotKey(hwnd, 1, hotkey.get_modifiers(), hotkey.get_code());
+}
+```
+
+## Choice group
+<table><tr><td align="center">
+<img src="../images/settings/choice_group.png" width="80%">
+</td></tr></table>
+
+```c++
+add_choice_group(name, description, value, vector<pair<wstring, UINT>> keys_and_texts)
+```
+A radio buttons group. Parameters:
+  * `name` - Key for element in the JSON.
+  * `description` - Resource ID of the text displayed to the user.
+  * `value` - Key selected by default.
+  * `keys_and_text` - Vector of radio buttons definitions: key and the displayed label. 
+
+
+The chosen button value is stored as a string with the key of the button selected by the user:
+```c++
+std::optional<std::wstring> value = settings.get_string_value(L"choice_group_name");
+```
+
+## Dropdown
+<table>
+<tr><td align="center">
+<img src="../images/settings/dropdown_1.png" width="80%">
+</td></tr>
+<tr><td align="center">
+<img src="../images/settings/dropdown_2.png" width="80%">
+</td></tr>
+</table>
+
+```c++
+add_dropdown(name, description, value, vector<pair<wstring, UINT>> keys_and_texts)
+```
+
+A dropdown. Parameters:
+  * `name` - Key for element in the JSON.
+  * `description` - Resource ID of the text displayed to the user.
+  * `value` - Key selected by default.
+  * `keys_and_text` - Vector of the options definitions: key and the displayed label.
+
+The chosen value is stored as a string with the key of the option selected by the user:
+```c++
+std::optional<std::wstring> value = settings.get_string_value(L"dropdown_name");
+```
+## Custom action
+<table><tr><td align="center">
+<img src="../images/settings/custom_action.png" width="80%">
+</td></tr></table>
+
+```c++
+add_custom_action(name, description, button_text, ext_description)
+```
+
+Adds a button with a description. Parameters:
+  * `name` - Key for element in the JSON.
+  * `description` - Resource ID of the text displayed to the user.
+  * `button_text` - Resource ID for the button label.
+  * `ext_description` - Resource ID for the extended description.
+
+When the button is pressed, the `call_custom_action` method of the module will be called, with JSON containing the name of the action. Parse it using `PowerToysSettings::CustomActionObject`:
+```c++
+void ExamplePowertoy::call_custom_action(const wchar_t* action) override
+{
+    auto action_object = PowerToysSettings::CustomActionObject::from_json_string(action);
+    auto name = action_object.get_name(); // same value as the 'name' parameter
+    // .. do stuff ..
+}
+```
+
+# File organization
+
+### [main.cpp](/src/settings/main.cpp)
+Contains the main executable code, initializing and managing the Window containing the WebView and communication with the main PowerToys executable.
+
+### [StreamURIResolverFromFile.cpp](/src/settings/StreamURIResolverFromFile.cpp)
+Defines a class implementing `IUriToStreamResolver`. Allows the WebView to navigate to filesystem files in this Win32 project.
+
+### [settings-html/](/src/settings/settings-html/)
+Contains the assets file from building the [Web project for the Settings UI](/src/settings./settings-web). It will be loaded by the WebView.

doc/devdocs/shared-hooks.md

@@ -1,85 +1,85 @@
-# Shared hooks
-
-To minimize the performance impact on the machine only `runner` installs global hooks, passing the events to registered callbacks in each PowerToy module.
-
-When a PowerToy module is loaded, the `runner` calls the [`get_events()`](/src/modules/interface/powertoy_module_interface.h#L40) method to get a NULL-terminated array of NULL-terminated strings with the names of the events that the PowerToy wants to subscribe to. A `const wchar_t*` string is provided for each of the event names.
-
-Events are signalled by the `runner` calling the [`signal_event(name, data)`](/src/modules/interface/powertoy_module_interface.h#L53) method of the PowerToy module. The `name` parameter contains the NULL-terminated name of the event. The `data` parameter and the method return value are specific for each event.
-
-Currently supported hooks:
- * `"ll_keyboard"` - [Low Level Keyboard Hook](#low-level-keyboard-hook)
- * `"win_hook_event"` - [Windows Event Hook](#windows-event-hook)
-
-## Low Level Keyboard Hook
-
-This event is signaled whenever the user presses or releases a key on the keyboard. To subscribe to this event, add `"ll_keyboard"` to the table returned by the `get_events()` method.
-
-The PowerToys runner installs low-level keyboard hook using `SetWindowsHookEx(WH_KEYBOARD_LL, ...)`. See [this MSDN page](https://docs.microsoft.com/en-us/previous-versions/windows/desktop/legacy/ms644985(v%3Dvs.85)) for details.
-
-When a keyboard event is signaled and `ncCode` equals `HC_ACTION`, the `wParam` and `lParam` event parameters are passed to all subscribed clients in the [`LowlevelKeyboardEvent`](/src/modules/interface/lowlevel_keyboard_event_data.h#L38-L41) struct.
-
-The `intptr_t data` event argument is a pointer to the `LowlevelKeyboardEvent` struct.
-
-A non-zero return value from any of the subscribed PowerToys will cause the runner hook proc to return 1, thus swallowing the keyboard event.
-
-Example usage, that makes Windows ignore the L key:
-
-```c++
-virtual const wchar_t** get_events() override {
-  static const wchar_t* events[2] = { ll_keyboard,
-                                      nullptr };
-  return events;
-}
-
-virtual intptr_t signal_event(const wchar_t* name, intptr_t data) override {
-  if (wcscmp(name, ll_keyboard) == 0) {
-    auto& event = *(reinterpret_cast<LowlevelKeyboardEvent*>(data));
-    // The L key has vkCode of 0x4C, see:
-    // https://docs.microsoft.com/en-us/windows/win32/inputdev/virtual-key-codes
-    if (event.wParam == WM_KEYDOWN && event.lParam->vkCode == 0x4C) {
-      return 1;
-    } else {
-      return 0;
-    }
-  } else {
-    return 0;
-  }
-}
-```
-
-## Windows Event Hook
-
-This event is signaled for [a range of events](https://docs.microsoft.com/pl-pl/windows/win32/winauto/event-constants). To subscribe to this event, add `"win_hook_event"` to the table returned by the `get_events()` method. See [this MSDN doc](https://docs.microsoft.com/pl-pl/windows/win32/api/winuser/nf-winuser-setwineventhook) for details.
-  
-The `intptr_t data` event argument is a pointer to the [`WinHookEvent`](/src/modules/interface/win_hook_event_data.h#L43-L50) struct.
-
-The return value of the event handler is ignored.
-
-Example usage, that detects a window being resized:
-
-```c++
-virtual const wchar_t** get_events() override {
-  static const wchar_t* events[2] = { win_hook_event,
-                                      nullptr };
-  return events;
-}
-
-virtual intptr_t signal_event(const wchar_t* name, intptr_t data) override {
-  if (wcscmp(name, win_hook_event) == 0) {
-    auto& event = *(reinterpret_cast<WinHookEvent*>(data));
-    switch (event.event) {
-    case EVENT_SYSTEM_MOVESIZESTART:
-      size_start(event.hwnd);
-      break;
-    case EVENT_SYSTEM_MOVESIZEEND:
-      size_end(event.hwnd);
-      break;
-    default:
-      break;
-    }
-  }
-  return 0;
-}
-```
-
-Taking too long to process the events has negative impact on the whole system performance. To address this, the events are signaled from a different thread, not from the event hook callback itself.
+# Shared hooks
+
+To minimize the performance impact on the machine only `runner` installs global hooks, passing the events to registered callbacks in each PowerToy module.
+
+When a PowerToy module is loaded, the `runner` calls the [`get_events()`](/src/modules/interface/powertoy_module_interface.h#L40) method to get a NULL-terminated array of NULL-terminated strings with the names of the events that the PowerToy wants to subscribe to. A `const wchar_t*` string is provided for each of the event names.
+
+Events are signalled by the `runner` calling the [`signal_event(name, data)`](/src/modules/interface/powertoy_module_interface.h#L53) method of the PowerToy module. The `name` parameter contains the NULL-terminated name of the event. The `data` parameter and the method return value are specific for each event.
+
+Currently supported hooks:
+ * `"ll_keyboard"` - [Low Level Keyboard Hook](#low-level-keyboard-hook)
+ * `"win_hook_event"` - [Windows Event Hook](#windows-event-hook)
+
+## Low Level Keyboard Hook
+
+This event is signaled whenever the user presses or releases a key on the keyboard. To subscribe to this event, add `"ll_keyboard"` to the table returned by the `get_events()` method.
+
+The PowerToys runner installs low-level keyboard hook using `SetWindowsHookEx(WH_KEYBOARD_LL, ...)`. See [this MSDN page](https://docs.microsoft.com/en-us/previous-versions/windows/desktop/legacy/ms644985(v%3Dvs.85)) for details.
+
+When a keyboard event is signaled and `ncCode` equals `HC_ACTION`, the `wParam` and `lParam` event parameters are passed to all subscribed clients in the [`LowlevelKeyboardEvent`](/src/modules/interface/lowlevel_keyboard_event_data.h#L38-L41) struct.
+
+The `intptr_t data` event argument is a pointer to the `LowlevelKeyboardEvent` struct.
+
+A non-zero return value from any of the subscribed PowerToys will cause the runner hook proc to return 1, thus swallowing the keyboard event.
+
+Example usage, that makes Windows ignore the L key:
+
+```c++
+virtual const wchar_t** get_events() override {
+  static const wchar_t* events[2] = { ll_keyboard,
+                                      nullptr };
+  return events;
+}
+
+virtual intptr_t signal_event(const wchar_t* name, intptr_t data) override {
+  if (wcscmp(name, ll_keyboard) == 0) {
+    auto& event = *(reinterpret_cast<LowlevelKeyboardEvent*>(data));
+    // The L key has vkCode of 0x4C, see:
+    // https://docs.microsoft.com/en-us/windows/win32/inputdev/virtual-key-codes
+    if (event.wParam == WM_KEYDOWN && event.lParam->vkCode == 0x4C) {
+      return 1;
+    } else {
+      return 0;
+    }
+  } else {
+    return 0;
+  }
+}
+```
+
+## Windows Event Hook
+
+This event is signaled for [a range of events](https://docs.microsoft.com/pl-pl/windows/win32/winauto/event-constants). To subscribe to this event, add `"win_hook_event"` to the table returned by the `get_events()` method. See [this MSDN doc](https://docs.microsoft.com/pl-pl/windows/win32/api/winuser/nf-winuser-setwineventhook) for details.
+  
+The `intptr_t data` event argument is a pointer to the [`WinHookEvent`](/src/modules/interface/win_hook_event_data.h#L43-L50) struct.
+
+The return value of the event handler is ignored.
+
+Example usage, that detects a window being resized:
+
+```c++
+virtual const wchar_t** get_events() override {
+  static const wchar_t* events[2] = { win_hook_event,
+                                      nullptr };
+  return events;
+}
+
+virtual intptr_t signal_event(const wchar_t* name, intptr_t data) override {
+  if (wcscmp(name, win_hook_event) == 0) {
+    auto& event = *(reinterpret_cast<WinHookEvent*>(data));
+    switch (event.event) {
+    case EVENT_SYSTEM_MOVESIZESTART:
+      size_start(event.hwnd);
+      break;
+    case EVENT_SYSTEM_MOVESIZEEND:
+      size_end(event.hwnd);
+      break;
+    default:
+      break;
+    }
+  }
+  return 0;
+}
+```
+
+Taking too long to process the events has negative impact on the whole system performance. To address this, the events are signaled from a different thread, not from the event hook callback itself.

doc/devdocs/style.md

@@ -0,0 +1,12 @@
+# Coding Style
+
+## Philosophy
+1. If it's inserting something into the existing classes/functions, try to follow the existing style as closely as possible.
+1. If it's brand new code or refactoring a complete class or area of the code, please follow as Modern C++ of a style as you can and reference the [C++ Core Guidelines](https://github.com/isocpp/CppCoreGuidelines) as much as you possibly can.
+
+## Formatting
+
+- We use [`.clang-format`](https://github.com/microsoft/PowerToys/blob/master/.clang-format) style file to enable automatic code formatting. You can [easily format source files from Visual Studio](https://devblogs.microsoft.com/cppblog/clangformat-support-in-visual-studio-2017-15-7-preview-1/). For example, `CTRL+K CTRL+D` formats the current document.
+- If you prefer another text editor or have ClangFormat disabled in Visual Studio, you could invoke [`format_sources`](https://github.com/microsoft/PowerToys/blob/master/format_sources.ps1) powershell script from command line. It gets a list of all currently modified files from `git` and invokes clang-format on them.
+Please note that you should also have `clang-format.exe` in `%PATH%` for it to work. The script can infer the path of `clang-format.exe` version which is shipped with Visual Studio at `%VCINSTALLDIR%\Tools\Llvm\bin\`, if you launch it from the *Native Tools Command Prompt for VS*.
+- CI doesn't enforce code formatting yet, since we're gradually applying code formatting to the codebase, but please adhere to our formatting style for any new code.

doc/images/Logo.svg

@@ -0,0 +1,30 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg width="176px" height="60px" viewBox="0 0 176 60" version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">
+    <!-- Generator: Sketch 54.1 (76490) - https://sketchapp.com -->
+    <title>Microsoft PowerToys</title>
+    <desc>Logo for Microsoft PowerToys</desc>
+    <g id="Devices" stroke="none" stroke-width="1" fill="none" fill-rule="evenodd">
+        <g id="Final-Logo" transform="translate(-309.000000, -228.000000)">
+            <g id="Group" transform="translate(309.000000, 228.000000)">
+                <g id="Group-2-Copy-7">
+                    <rect id="Rectangle-Copy-40" fill="#E4292E" x="12.3529412" y="8.82352941" width="7" height="21.1764706"></rect>
+                    <rect id="Rectangle-Copy-41" fill="#E76643" x="19" y="8.82352941" width="7" height="21.1764706"></rect>
+                    <rect id="Rectangle-Copy-42" fill="#F4C81D" x="26" y="8.82352941" width="7" height="21.1764706"></rect>
+                    <rect id="Rectangle-Copy-43" fill="#4EB445" x="33" y="8.82352941" width="7" height="21.1764706"></rect>
+                    <rect id="Rectangle-Copy-50" fill="#02A3E8" x="40" y="8.82352941" width="7" height="21.1764706"></rect>
+                    <rect id="Rectangle-Copy-44" fill="#D6CDB2" x="12.3529412" y="33.5294118" width="7.05882353" height="7.05882353"></rect>
+                    <rect id="Rectangle-Copy-45" fill="#D6CDB2" x="26.4705882" y="33.5294118" width="7.05882353" height="7.05882353"></rect>
+                    <rect id="Rectangle-Copy-46" fill="#D6CDB2" x="40.5882353" y="33.5294118" width="7.05882353" height="7.05882353"></rect>
+                    <rect id="Rectangle-Copy-47" fill="#D6CDB2" x="12.3529412" y="44.1176471" width="7.05882353" height="7.05882353"></rect>
+                    <rect id="Rectangle-Copy-48" fill="#D6CDB2" x="26.4705882" y="44.1176471" width="7.05882353" height="7.05882353"></rect>
+                    <rect id="Rectangle-Copy-49" fill="#D6CDB2" x="40.5882353" y="44.1176471" width="7.05882353" height="7.05882353"></rect>
+                    <polygon id="Line-5-Copy-13" fill="#D6CDB2" fill-rule="nonzero" points="3.52941176 3.52941176 3.52941176 0 56.4705882 0 56.4705882 3.52941176"></polygon>
+                    <polygon id="Line-5-Copy-14" fill="#D6CDB2" fill-rule="nonzero" points="3.52941176 60 3.52941176 56.4705882 56.4705882 56.4705882 56.4705882 60"></polygon>
+                    <polygon id="Line-5-Copy-15" fill="#D6CDB2" fill-rule="nonzero" transform="translate(58.235294, 30.000000) rotate(-270.000000) translate(-58.235294, -30.000000) " points="31.7647059 31.7647059 31.7647059 28.2352941 84.7058824 28.2352941 84.7058824 31.7647059"></polygon>
+                    <polygon id="Line-5-Copy-16" fill="#D6CDB2" fill-rule="nonzero" transform="translate(1.764706, 30.000000) rotate(-270.000000) translate(-1.764706, -30.000000) " points="-24.7058824 31.7647059 -24.7058824 28.2352941 28.2352941 28.2352941 28.2352941 31.7647059"></polygon>
+                </g>
+                <path d="M87.9970703,10.0039062 L87.9970703,6 L79.9990234,6 L79.9990234,10.0039062 L87.9970703,10.0039062 Z M76,26 L76,2.00097656 L91.9960938,2.00097656 L91.9960938,14.0029297 L79.9990234,14.0029297 L79.9990234,26 L76,26 Z M99.9990234,26 L99.9990234,22.0009766 L107.99707,22.0009766 L107.99707,26 L99.9990234,26 Z M96,22.0009766 L96,10.0039062 L99.9990234,10.0039062 L99.9990234,22.0009766 L96,22.0009766 Z M107.99707,22.0009766 L107.99707,10.0039062 L111.996094,10.0039062 L111.996094,22.0009766 L107.99707,22.0009766 Z M99.9990234,10.0039062 L99.9990234,6 L107.99707,6 L107.99707,10.0039062 L99.9990234,10.0039062 Z M119.999023,26 L119.999023,22.0009766 L123.998047,22.0009766 L123.998047,26 L119.999023,26 Z M127.99707,26 L127.99707,22.0009766 L131.996094,22.0009766 L131.996094,26 L127.99707,26 Z M123.998047,22.0009766 L123.998047,14.0029297 L127.99707,14.0029297 L127.99707,22.0009766 L123.998047,22.0009766 Z M116,22.0009766 L116,6 L119.999023,6 L119.999023,22.0009766 L116,22.0009766 Z M131.996094,22.0009766 L131.996094,6 L136,6 L136,22.0009766 L131.996094,22.0009766 Z M151.996094,14.0029297 L151.996094,10.0039062 L143.998047,10.0039062 L143.998047,14.0029297 L151.996094,14.0029297 Z M143.996094,10.0029297 L143.996094,6.00390625 L139.996094,6.00390625 L139.996094,10.0029297 L143.996094,10.0029297 Z M139.999023,26 L139.999023,6 L155.995117,6 L155.995117,18.0019531 L143.998047,18.0019531 L143.998047,22.0009766 L155.995117,22.0009766 L155.995117,26 L139.999023,26 Z M159.999023,26 L159.999023,6 L175.995117,6 L175.995117,10.0039062 L163.998047,10.0039062 L163.998047,26 L159.999023,26 Z M83.9980469,56 L83.9980469,36 L76,36 L76,32.0009766 L96,32.0009766 L96,36 L87.9970703,36 L87.9970703,56 L83.9980469,56 Z M103.998047,56 L103.998047,52.0009766 L111.996094,52.0009766 L111.996094,56 L103.998047,56 Z M99.9990234,52.0009766 L99.9990234,40.0039062 L103.998047,40.0039062 L103.998047,52.0009766 L99.9990234,52.0009766 Z M111.996094,52.0009766 L111.996094,40.0039062 L115.995117,40.0039062 L115.995117,52.0009766 L111.996094,52.0009766 Z M103.998047,40.0039062 L103.998047,36 L111.996094,36 L111.996094,40.0039062 L103.998047,40.0039062 Z M119.999023,56 L119.999023,52.0009766 L131.996094,52.0009766 L131.996094,48.0019531 L119.999023,48.0019531 L119.999023,36 L123.998047,36 L123.998047,44.0029297 L131.996094,44.0029297 L131.996094,36 L135.995117,36 L135.995117,56 L119.999023,56 Z M139.999023,56 L139.999023,52.0009766 L151.996094,52.0009766 L151.996094,48.0019531 L139.999023,48.0019531 L139.999023,36 L155.995117,36 L155.995117,40.0039062 L143.998047,40.0039062 L143.998047,44.0029297 L155.995117,44.0029297 L155.995117,56 L139.999023,56 Z" id="PowerToys-Copy-2" fill="#D6CDB2" fill-rule="nonzero"></path>
+            </g>
+        </g>
+    </g>
+</svg>