Yu Leng

This commit introduces a **new AI skill** specifically designed to facilitate **WPF to WinUI 3 application migration**. This **new capability** provides comprehensive documentation and reference materials, enabling AI to assist with complex migration tasks across various technical domains. It covers critical aspects such as XAML, threading, imaging APIs, namespace and API mapping, and PowerToys-specific migration patterns. The addition aims to significantly streamline the process of transitioning applications, enhancing developer efficiency by automating or guiding through the migration steps.

This commit provides a **bug fix** for a critical `FileNotFoundException` crash in **PowerToys Run**. The crash stemmed from **`Settings.UI.Library`** having an unintended transitive dependency on **`PowerDisplay.Lib`**, causing `PowerToys Run` to attempt loading a DLL it didn't ship. To resolve this, the commit **refactors** `Settings.UI.Library` by **decoupling** it from `PowerDisplay.Lib`, introducing local data models like `ColorPresetItem` and `CustomVcpValueMapping` within `Settings.UI.Library` to represent display settings. This change ensures that `PowerDisplay.Lib` is only loaded when explicitly required by the PowerDisplay module, significantly improving application stability and modularity.

This commit implements a crucial **security fix** within the **Hosts Editor module** by changing how the hosts file is opened. Previously, the module would query the registry for the user's default editor, which, when run with administrative privileges, presented a vulnerability where a malicious registry entry could lead to arbitrary code execution. To mitigate this, the `OpenHostsFile` method in `HostsService.cs` now **hardcodes the use of `notepad.exe`** to open the hosts file, bypassing the insecure registry lookup. This change **prevents potential privilege escalation** and ensures that users can safely edit their hosts file without risk of executing untrusted applications.

This commit **temporarily disables** the entire **PowerDisplay module** across PowerToys to prevent it from shipping in the current release, as final decisions on its name and icon are still pending. This **maintenance** change impacts various core components, including the solution build, Group Policy definitions, the main runner, quick access menus, the OOBE experience, and the settings UI dashboard. By commenting out its references and preventing its loading, the module is completely hidden and non-functional. The downstream impact is that users will not see or be able to interact with the `PowerDisplay` module until it is fully prepared for a future release.

This commit introduces a **new capability** to the **PowerDisplay module**, enabling users to define **custom VCP value name mappings** for their monitors, which enhances the clarity and personalization of display controls. It also includes **bug fixes** that resolve issues where **Quick Access** failed to launch PowerDisplay correctly and addresses a **VCP slider visibility bug**. These **enhancements and fixes** involve significant updates to the PowerDisplay core logic, its module interface, and the **Settings UI**, which now features a dedicated editor for managing custom VCP mappings. The changes improve the overall usability and reliability of the display management tool, making it more robust and user-friendly.

This commit **fixes** and **enhances** the **PowerRename** module's regex capabilities by improving the `SanitizeAndNormalize` function. It ensures more robust **Unicode normalization** and correct buffer sizing, addressing potential edge cases in string processing. Additionally, **new unit tests** have been added to verify the accurate handling of regex metacharacters `$` and `^` at string boundaries within `src/modules/powerrename/unittests/CommonRegExTests.h`. This work collectively improves **Unicode support** and significantly enhances **test coverage** for critical regex scenarios, making PowerRename's string manipulation more reliable.

This commit introduces a **refactoring** within the **Image Resizer** module to **disable its AI feature and associated caching functionality**. The `CheckAiAvailability` function in `src/modules/imageresizer/ui/App.xaml.cs` is modified to always return `AiAvailabilityState.NotSupported`, effectively deactivating the AI capabilities. Concurrently, the `AiAvailabilityCacheService.cs` is refactored by removing all read and write operations from its `LoadCache` and `SaveCache` functions, thereby disabling the caching of AI availability status. This **maintenance** change ensures the AI components are no longer active or checked for, streamlining the **Image Resizer**'s operation.

This commit provides a **maintenance fix** for the **Image Resizer** module by correcting an inconsistency in its log folder path. Specifically, it updates the constant defining the log subfolder path within `src/modules/imageresizer/ui/App.xaml.cs` to use `'Image Resizer'` instead of `'ImageResizer'`. This ensures that log files generated by the Image Resizer UI are consistently stored in the correctly formatted directory, improving log organization and reliability for the module.

This commit delivers a **bug fix** to the **`ManagedCommon`** module, specifically within the `OSVersionHelper.cs` file. It **corrects the logic for detecting Windows 10** by modifying the `IsWindows10` function to check the operating system's build number instead of its minor version. This ensures more accurate OS version identification, which is critical for features or components that rely on precise Windows 10 versioning.

This commit **fixes** and **refactors** the **tray icon theming** and installer icon handling to improve reliability and maintainability. It updates the **installer** (`Core.wxs`) to correctly include the `svgs` directory and icon files, ensuring proper installation and uninstallation. Enhanced logging in `general_settings.cpp` now tracks changes to the `show_theme_adaptive_tray_icon` setting. Furthermore, `tray_icon.cpp` has been refactored to improve icon loading robustness, adding detailed diagnostics and implementing a crucial fallback to a default icon if theme-adaptive icon loading fails. These changes ensure the application's tray icon displays correctly and gracefully handles theming issues.

This commit performs **maintenance** by updating the copyright year from 2025 to 2026 within the **CmdPal UI** module. The change specifically modifies the `Resources.resw` file in `src/modules/cmdpal/Microsoft.CmdPal.UI/Strings/en-us/` to reflect the new year in the application's resource strings. Concurrently, a **test update** was made in `src/modules/cmdpal/Tests/Microsoft.CmdPal.UITests/BasicTests.cs` to adjust the expected copyright year in UI test assertions. This ensures the **CmdPal** application displays the correct copyright information and that related UI tests remain valid.

This commit introduces **new capabilities** to **PowerRename**, enabling the extraction of EXIF metadata from **HEIF/HEIC** and **AVIF** image files. It extends the `WICMetadataExtractor` component to correctly parse metadata paths for these modern formats and updates the supported file extensions. Furthermore, the **PowerRename settings UI** has been enhanced to display the installation status of required Windows Store extensions and provide direct installation buttons, improving user experience and ensuring functionality. This **feature addition** allows users to leverage EXIF data from modern image formats for advanced renaming operations, supported by robust unit tests and graceful handling of missing extensions.

This commit introduces **AI-powered super resolution** as a **new capability** for the **Image Resizer** module, leveraging Windows AI APIs to intelligently upscale images. It integrates a new `WinAiSuperResolutionService` and dynamically adjusts the user interface, offering configuration options and model download prompts only when **AI capabilities are detected** on the user's system. The **runner** module is updated to perform this crucial AI capability detection, ensuring the feature is presented exclusively on compatible environments (e.g., Arm Windows with the latest Windows version), thereby significantly enhancing the image resizing functionality for supported users.

This commit introduces significant **refactoring** across the **Settings.UI.Library** and **Settings.UI** modules to achieve **Native AOT compatibility** for settings serialization and deserialization. A new `SettingsSerializationContext` was added, registering all settings types with source-generated `JsonSerializable` attributes, and methods like `BasePTModuleSettings.ToJsonString()` and `SettingsUtils.GetFile<T>()` were updated to utilize this AOT-compatible approach. Additionally, numerous `ToString()` methods in various `Properties` classes were modified, and struct fields in `SunTimes` and `MouseWithoutBordersProperties` were converted to properties to ensure proper serialization. This **maintenance** effort prepares the application for future performance benefits and reduced binary sizes with Native AOT compilation, with comprehensive unit tests added to validate the changes.

This commit provides a **build fix** for the **PowerRename FuzzingTest** project by adding `windowscodecs.lib` to its linker's `AdditionalDependencies`. This resolves a configuration issue that prevented the fuzzing tests from building correctly in local development environments. The change ensures that the **PowerRename** module's fuzzing tests can be compiled and run as intended, improving the reliability of the testing infrastructure. This is a **maintenance** update to ensure the test suite remains functional.

This commit introduces a **new capability** to the **PowerRename** utility, enabling users to rename image files based on their embedded **EXIF and XMP metadata**. It integrates the Windows Imaging Component (WIC) through a new `WICMetadataExtractor` class to extract various metadata fields, which are then processed by the updated `PowerRenameRegEx` engine. The user interface in `MainWindow.xaml` is enhanced with new options to select metadata sources and display available shortcuts, significantly expanding PowerRename's utility for organizing photo collections. This **feature addition** provides a powerful and flexible way to rename files using rich photographic information.

This commit **refactors** the **CmdPal search mechanism** within the **WinGet extension** by replacing a complex cancellation token system with a simpler task queue. This **improves user experience** by allowing previous search tasks to complete and display results while new inputs are processed, preventing delays where no results were shown until the final input. The change primarily affects `WinGetExtensionPage.cs`, making the search logic **more responsive and maintainable** for future development.

This commit **enables Ahead-of-Time (AOT) compilation by default** for the **CmdPal** module, streamlining its build process. It **removes unnecessary `PublishReadyToRun` and `PublishTrimmed` configurations**, simplifying the project setup and pipeline definitions, specifically in `.pipelines/v2/release.yml`. Consequently, **CmdPal** will now **build with AOT by default in the release pipeline** while running without AOT in Visual Studio for development. This **configuration change and maintenance** effort optimizes **CmdPal** deployments and simplifies its build environment.

This commit significantly **enhances the test coverage and testability** of the **CmdPal Shell and WebSearch extensions**. It introduces a comprehensive suite of **new unit tests** for key functionalities, including query processing, command execution, history management, and provider details for both extensions. Concurrently, a **refactoring** effort abstracts settings management by introducing an `ISettingsInterface` for each extension, allowing for easier mocking and dependency injection in tests. This work improves the overall **robustness and maintainability** of these core CmdPal components by ensuring critical functionalities are well-tested and the code is more modular.

[CmdPal] Add WinAppSDK dependency in SamplePageExtension And ProcessMonitorExtension (#41274)