Details output option for list (#5939)

## Change
The new experimental feature `listDetails` enables a new option for the
`list` command, `--details`. When supplied, the output is no longer a
table view of the results but is instead a series of `show` like outputs
drawing data from the installed item.

An example output for a single installed package is:
```PowerShell
> wingetdev list Microsoft.VisualStudio.2022.Enterprise --details
Visual Studio Enterprise 2022 [Microsoft.VisualStudio.2022.Enterprise]
Version: 17.14.21 (November 2025)
Publisher: Microsoft Corporation
Local Identifier: ARP\Machine\X86\875fed29
Product Code: 875fed29
Installer Category: exe
Installed Scope: Machine
Installed Location: C:\Program Files\Microsoft Visual Studio\2022\Enterprise
Available Upgrades:
  winget [17.14.23]
```

When there are multiple results, the identity line is prefixed with the
standard `(N/M)` format string used in multi-package operations
elsewhere.

If sixels are enabled and supported by the terminal, an icon for the
installed package will be shown. This currently models the mechanism
used by winget-pkgs to extract the icons and by the `show` command to
select the appropriate one to display. It is using the same code in the
same manner and should be representative of what would be shown to the
user if it were doing the full round trip through the
repository/cache/`show` command.

Author: JohnMcPMS

doc/Settings.md

@@ -403,3 +403,30 @@ This feature enables support for additional source command improvements via `win
         "sourceEdit": true
   },
 ```
+
+### listDetails
+
+This feature enables support for displaying detailed output from the `list` command. Rather than a table view of the results, when the `--details` option is provided
+to the `list` command, it will output information similar to how `show` would. Most of the data presented is directly from the local installation.
+
+Example output:
+```PowerShell
+> winget list Microsoft.VisualStudio.2022.Enterprise --details
+Visual Studio Enterprise 2022 [Microsoft.VisualStudio.2022.Enterprise]
+Version: 17.14.21 (November 2025)
+Publisher: Microsoft Corporation
+Local Identifier: ARP\Machine\X86\875fed29
+Product Code: 875fed29
+Installer Category: exe
+Installed Scope: Machine
+Installed Location: C:\Program Files\Microsoft Visual Studio\2022\Enterprise
+Available Upgrades:
+  winget [17.14.23]
+```
+
+To enable:
+```json
+  "experimentalFeatures": {
+        "listDetails": true
+  },
+```

schemas/JSON/settings/settings.schema.0.2.json

@@ -328,6 +328,16 @@
           "description": "Enable support for managing fonts",
           "type": "boolean",
           "default": false
+        },
+        "listDetails": {
+          "description": "Enable detailed output option for list command",
+          "type": "boolean",
+          "default": false
+        },
+        "sourceEdit": {
+          "description": "Enable source edit command",
+          "type": "boolean",
+          "default": false
         }
       }
     }

src/AppInstallerCLICore/Argument.cpp

@@ -108,7 +108,7 @@ namespace AppInstaller::CLI
         case Execution::Args::Type::TargetVersion:
             return { type, "version"_liv, 'v', ArgTypeCategory::SinglePackageQuery, ArgTypeExclusiveSet::AllAndTargetVersion };
 
-        //Source Command
+        // Source Command
         case Execution::Args::Type::SourceName:
             return { type, "name"_liv, 'n' };
         case Execution::Args::Type::SourceType:
@@ -124,13 +124,13 @@ namespace AppInstaller::CLI
         case Execution::Args::Type::SourceEditExplicit:
             return { type, "explicit"_liv, 'e' };
 
-        //Hash Command
+        // Hash Command
         case Execution::Args::Type::HashFile:
             return { type, "file"_liv, 'f' };
         case Execution::Args::Type::Msix:
             return { type, "msix"_liv, 'm' };
 
-        //Validate Command
+        // Validate Command
         case Execution::Args::Type::ValidateManifest:
             return { type, "manifest"_liv };
         case Execution::Args::Type::IgnoreWarnings:
@@ -183,6 +183,8 @@ namespace AppInstaller::CLI
         // List command
         case Execution::Args::Type::Upgrade:
             return { type, "upgrade-available"_liv};
+        case Execution::Args::Type::ListDetails:
+            return { type, "details"_liv };
 
         // Pin command
         case Execution::Args::Type::GatedVersion:
@@ -482,6 +484,8 @@ namespace AppInstaller::CLI
             return Argument{ type, Resource::String::FontDetailsArgumentDescription, ArgumentType::Flag, false };
         case Args::Type::Correlation:
             return Argument{ type, Resource::String::CorrelationArgumentDescription, ArgumentType::Standard, Argument::Visibility::Hidden };
+        case Args::Type::ListDetails:
+            return Argument{ type, Resource::String::ListDetailsArgumentDescription, ArgumentType::Flag, Argument::Visibility::Help, ExperimentalFeature::Feature::ListDetails };
         default:
             THROW_HR(E_UNEXPECTED);
         }

src/AppInstallerCLICore/Commands/ListCommand.cpp

@@ -31,6 +31,7 @@ namespace AppInstaller::CLI
             Argument{ Execution::Args::Type::Upgrade, Resource::String::UpgradeArgumentDescription, ArgumentType::Flag, Argument::Visibility::Help },
             Argument{ Execution::Args::Type::IncludeUnknown, Resource::String::IncludeUnknownInListArgumentDescription, ArgumentType::Flag },
             Argument{ Execution::Args::Type::IncludePinned, Resource::String::IncludePinnedInListArgumentDescription, ArgumentType::Flag},
+            Argument::ForType(Execution::Args::Type::ListDetails),
         };
     }
 

src/AppInstallerCLICore/ExecutionArgs.h

@@ -111,6 +111,7 @@ namespace AppInstaller::CLI::Execution
 
             // List Command
             Upgrade, // Used in List command to only show versions with upgrades
+            ListDetails,
 
             // Pin command
             GatedVersion, // Differs from Version in that this supports wildcards

src/AppInstallerCLICore/Resources.h

@@ -432,6 +432,7 @@ namespace AppInstaller::CLI::Resource
         WINGET_DEFINE_RESOURCE_STRINGID(Links);
         WINGET_DEFINE_RESOURCE_STRINGID(ListCommandLongDescription);
         WINGET_DEFINE_RESOURCE_STRINGID(ListCommandShortDescription);
+        WINGET_DEFINE_RESOURCE_STRINGID(ListDetailsArgumentDescription);
         WINGET_DEFINE_RESOURCE_STRINGID(LocaleArgumentDescription);
         WINGET_DEFINE_RESOURCE_STRINGID(LocationArgumentDescription);
         WINGET_DEFINE_RESOURCE_STRINGID(LogArgumentDescription);
@@ -635,6 +636,7 @@ namespace AppInstaller::CLI::Resource
         WINGET_DEFINE_RESOURCE_STRINGID(ShowCommandShortDescription);
         WINGET_DEFINE_RESOURCE_STRINGID(ShowLabelAgreements);
         WINGET_DEFINE_RESOURCE_STRINGID(ShowLabelAuthor);
+        WINGET_DEFINE_RESOURCE_STRINGID(ShowLabelChannel);
         WINGET_DEFINE_RESOURCE_STRINGID(ShowLabelCopyright);
         WINGET_DEFINE_RESOURCE_STRINGID(ShowLabelCopyrightUrl);
         WINGET_DEFINE_RESOURCE_STRINGID(ShowLabelDependencies);
@@ -666,6 +668,17 @@ namespace AppInstaller::CLI::Resource
         WINGET_DEFINE_RESOURCE_STRINGID(ShowLabelVersion);
         WINGET_DEFINE_RESOURCE_STRINGID(ShowLabelWindowsFeaturesDependencies);
         WINGET_DEFINE_RESOURCE_STRINGID(ShowLabelWindowsLibrariesDependencies);
+        WINGET_DEFINE_RESOURCE_STRINGID(ShowListAvailableUpgrades);
+        WINGET_DEFINE_RESOURCE_STRINGID(ShowListInstalledArchitecture);
+        WINGET_DEFINE_RESOURCE_STRINGID(ShowListInstalledLocale);
+        WINGET_DEFINE_RESOURCE_STRINGID(ShowListInstalledLocation);
+        WINGET_DEFINE_RESOURCE_STRINGID(ShowListInstalledScope);
+        WINGET_DEFINE_RESOURCE_STRINGID(ShowListInstalledSource);
+        WINGET_DEFINE_RESOURCE_STRINGID(ShowListInstallerCategory);
+        WINGET_DEFINE_RESOURCE_STRINGID(ShowListLocalIdentifier);
+        WINGET_DEFINE_RESOURCE_STRINGID(ShowListPackageFamilyName);
+        WINGET_DEFINE_RESOURCE_STRINGID(ShowListProductCode);
+        WINGET_DEFINE_RESOURCE_STRINGID(ShowListUpgradeCode);
         WINGET_DEFINE_RESOURCE_STRINGID(ShowVersion);
         WINGET_DEFINE_RESOURCE_STRINGID(SilentArgumentDescription);
         WINGET_DEFINE_RESOURCE_STRINGID(SingleCharAfterDashError);

src/AppInstallerCLICore/Sixel.cpp

@@ -432,15 +432,18 @@ namespace AppInstaller::CLI::VirtualTerminal::Sixel
         m_sourceImage = anon::CacheToBitmap(m_factory.get(), decodedFrame.get());
     }
 
-    ImageSource::ImageSource(std::istream& imageStream, Manifest::IconFileTypeEnum imageEncoding)
+    ImageSource::ImageSource(std::istream& imageStream, Manifest::IconFileTypeEnum imageEncoding) :
+        ImageSource(Utility::ReadEntireStreamAsByteArray(imageStream), imageEncoding)
+    {
+    }
+
+    ImageSource::ImageSource(const std::vector<uint8_t>& imageBytes, Manifest::IconFileTypeEnum imageEncoding)
     {
         m_factory = anon::CreateFactory();
 
         wil::com_ptr<IStream> stream;
         THROW_IF_FAILED(CreateStreamOnHGlobal(nullptr, TRUE, &stream));
 
-        auto imageBytes = Utility::ReadEntireStreamAsByteArray(imageStream);
-
         ULONG written = 0;
         THROW_IF_FAILED(stream->Write(imageBytes.data(), static_cast<ULONG>(imageBytes.size()), &written));
         THROW_IF_FAILED(stream->Seek({}, STREAM_SEEK_SET, nullptr));
@@ -637,6 +640,10 @@ namespace AppInstaller::CLI::VirtualTerminal::Sixel
         m_imageSource(imageStream, imageEncoding)
     {}
 
+    Image::Image(const std::vector<uint8_t>& imageBytes, Manifest::IconFileTypeEnum imageEncoding) :
+        m_imageSource(imageBytes, imageEncoding)
+    {}
+
     Image& Image::AspectRatio(Sixel::AspectRatio aspectRatio)
     {
         m_renderControls.AspectRatio = aspectRatio;

src/AppInstallerCLICore/Sixel.h

@@ -145,6 +145,9 @@ namespace AppInstaller::CLI::VirtualTerminal::Sixel
         // Create an image source from a stream.
         ImageSource(std::istream& imageStream, Manifest::IconFileTypeEnum imageEncoding);
 
+        // Create an image source from bytes.
+        ImageSource(const std::vector<uint8_t>& imageBytes, Manifest::IconFileTypeEnum imageEncoding);
+
         // Resize the image to the given width and height, factoring in the target aspect ratio for rendering.
         // If stretchToFill is true, the resulting image will be both the given width and height.
         // If false, the resulting image will be at most the given width or height while preserving the aspect ratio.
@@ -221,6 +224,9 @@ namespace AppInstaller::CLI::VirtualTerminal::Sixel
         // Create an image from a stream.
         Image(std::istream& imageStream, Manifest::IconFileTypeEnum imageEncoding);
 
+        // Create an image from bytes.
+        Image(const std::vector<uint8_t>& imageBytes, Manifest::IconFileTypeEnum imageEncoding);
+
         // Set the aspect ratio of the result.
         Image& AspectRatio(AspectRatio aspectRatio);
 

src/AppInstallerCLICore/Workflows/ConfigurationFlow.cpp

@@ -1417,7 +1417,7 @@ namespace AppInstaller::CLI::Workflow
             unit.Identifier(sourceNameWide + L'_' + packageIdWide);
             unit.Intent(ConfigurationUnitIntent::Apply);
 
-            auto description = Resource::String::ConfigureExportUnitInstallDescription(Utility::LocIndView{ package.Id });
+            auto description = Resource::String::ConfigureExportUnitInstallDescription(package.Id);
 
             ValueSet directives;
             directives.Insert(s_Directive_Description, PropertyValue::CreateString(winrt::to_hstring(description.get())));

src/AppInstallerCLICore/Workflows/ImportExportFlow.cpp

@@ -108,7 +108,7 @@ namespace AppInstaller::CLI::Workflow
             auto channel = installedPackageVersion->GetProperty(PackageVersionProperty::Channel);
 
             // Find an available version of this package to determine its source.
-            auto availablePackageVersion = GetAvailableVersionForInstalledPackage(context, packageMatch.Package, Utility::LocIndView{ version }, Utility::LocIndView{ channel }, includeVersions);
+            auto availablePackageVersion = GetAvailableVersionForInstalledPackage(context, packageMatch.Package, version, channel, includeVersions);
             if (!availablePackageVersion)
             {
                 // Report package not found and move to next package.