Update samples for VS 17.14

New_Extensibility_Model/Samples/ClassificationSample/ClassificationSample.csproj

@@ -0,0 +1,13 @@
+<Project Sdk="Microsoft.NET.Sdk">
+  <PropertyGroup>
+    <TargetFramework>net8.0-windows8.0</TargetFramework>
+    <Nullable>enable</Nullable>
+    <LangVersion>12</LangVersion>
+    <NeutralLanguage>en-US</NeutralLanguage>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Microsoft.VisualStudio.Extensibility.Sdk" Version="17.14.40254" PrivateAssets="all" />
+    <PackageReference Include="Microsoft.VisualStudio.Extensibility.Build" Version="17.14.40254" PrivateAssets="all" />
+  </ItemGroup>
+</Project>

New_Extensibility_Model/Samples/ClassificationSample/CsvTagger.cs

@@ -0,0 +1,147 @@
+// Copyright (c) Microsoft. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+namespace ClassificationSample;
+
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text.RegularExpressions;
+using System.Threading;
+using System.Threading.Tasks;
+using Microsoft.VisualStudio.Extensibility.Editor;
+
+#pragma warning disable VSEXTPREVIEW_TAGGERS // Type is for evaluation purposes only and is subject to change or removal in future updates. Suppress this diagnostic to proceed.
+
+internal class CsvTagger : TextViewTagger<ClassificationTag>
+{
+    private const string QuoteMatchName = "quote";
+    private const string EscapedQuoteMatchName = "escapedQuote";
+    private const string SeparatorMatchName = "separator";
+    private const string FieldTextMatchName = "fieldText";
+
+    // Matches any sequence of characters, not containing '"' and ','. It also matches any
+    // sequence of characters enclosed in '"' as long as they don't contain other '"'
+    // characters, unless they are escaped (doubled).
+    // Examples of valid matches: xxx, "xxx", "xx""x"
+    private const string FieldRegex = $@"(((?<{QuoteMatchName}>"")((?<{FieldTextMatchName}>[^""]+)|(?<{EscapedQuoteMatchName}>""""))*(?<{QuoteMatchName}>""))|(?<{FieldTextMatchName}>([^,""])*))";
+
+    // Matches multiple fields separated by ','
+    // This regex supports quoted fields, escaped quotes (inside fields). We are not supporting
+    // line-breaks inside a field.
+    // This regex is not terminated with '$' so that as much as possible of the beginning of
+    // the line is always matched, even in case of syntax error.
+    private static readonly Regex LineRegex = new($@"^{FieldRegex}((?<{SeparatorMatchName}>,){FieldRegex})*", RegexOptions.Compiled | RegexOptions.ExplicitCapture);
+
+    private readonly CsvTaggerProvider provider;
+    private readonly Uri documentUri;
+
+    public CsvTagger(CsvTaggerProvider provider, Uri documentUri)
+    {
+        this.provider = provider;
+        this.documentUri = documentUri;
+    }
+
+    public override void Dispose()
+    {
+        this.provider.RemoveTagger(this.documentUri, this);
+        base.Dispose();
+    }
+
+    public async Task TextViewChangedAsync(ITextViewSnapshot textView, IReadOnlyList<TextEdit> edits, CancellationToken cancellationToken)
+    {
+        if (edits.Count == 0)
+        {
+            return;
+        }
+
+        var allRequestedRanges = await this.GetAllRequestedRangesAsync(textView.Document, cancellationToken);
+        await this.CreateTagsAsync(
+            textView.Document,
+            allRequestedRanges.Intersect(// Use Intersect to only create tags for ranges that VS has previously expressed interested in.
+                edits.Select(e =>
+                    EnsureNotEmpty(// Fix empty ranges to be at least 1 character long so that they are not ignored when intersected (empty ranges are the result of text deletion).
+                        e.Range.TranslateTo(textView.Document, TextRangeTrackingMode.ExtendForwardAndBackward))))); // Translate the range to the new document version.
+    }
+
+    protected override async Task RequestTagsAsync(NormalizedTextRangeCollection requestedRanges, bool recalculateAll, CancellationToken cancellationToken)
+    {
+        if (requestedRanges.Count == 0)
+        {
+            return;
+        }
+
+        await this.CreateTagsAsync(requestedRanges.TextDocumentSnapshot!, requestedRanges);
+    }
+
+    private static TextRange EnsureNotEmpty(TextRange range)
+    {
+        if (range.Length > 0)
+        {
+            return range;
+        }
+
+        int start = Math.Max(0, range.Start - 1);
+        int end = Math.Min(range.Document.Length, range.Start + 1);
+
+        return new(range.Document, start, end - start);
+    }
+
+    private async Task CreateTagsAsync(ITextDocumentSnapshot document, IEnumerable<TextRange> requestedRanges)
+    {
+        List<TaggedTrackingTextRange<ClassificationTag>> tags = new();
+        List<TextRange> ranges = new();
+        foreach (var lineNumber in requestedRanges.SelectMany(r =>
+            {
+                // Convert the requested range to line numbers.
+                var startLine = r.Document.GetLineNumberFromPosition(r.Start);
+                var endLine = r.Document.GetLineNumberFromPosition(r.End);
+                return Enumerable.Range(startLine, endLine - startLine + 1);
+
+            // Use Distinct to avoid processing the same line multiple times.
+            }).Distinct())
+        {
+            var line = document.Lines[lineNumber];
+            var match = LineRegex.Match(line.Text.CopyToString());
+
+            if (match.Success)
+            {
+                // VisualStudio.Extensibility doesn't support defining text colors for
+                // new classification types yet, so we must use existing classification
+                // types.
+                foreach (Capture capture in match.Groups[FieldTextMatchName].Captures)
+                {
+                    AddTag(capture, lineNumber == 0 ? ClassificationType.KnownValues.SymbolDefinition : ClassificationType.KnownValues.String);
+                }
+
+                foreach (Capture capture in match.Groups[QuoteMatchName].Captures)
+                {
+                    AddTag(capture, ClassificationType.KnownValues.BracePairLevelOne);
+                }
+
+                foreach (Capture capture in match.Groups[EscapedQuoteMatchName].Captures)
+                {
+                    AddTag(capture, ClassificationType.KnownValues.BracePairLevelTwo);
+                }
+
+                foreach (Capture capture in match.Groups[SeparatorMatchName].Captures)
+                {
+                    AddTag(capture, ClassificationType.KnownValues.Operator);
+                }
+            }
+
+            void AddTag(Capture capture, ClassificationType classificationType)
+            {
+                tags.Add(new(new(document, line.Text.Start + capture.Index, capture.Length, TextRangeTrackingMode.ExtendNone), new(classificationType)));
+            }
+
+            // Add the range to the list of ranges we have calculated tags for. We add the range even if no tags
+            // were created for it, this takes care of clearing any tags that were previously created for this
+            // range and are not valid anymore.
+            ranges.Add(new(document, line.TextIncludingLineBreak.Start, line.TextIncludingLineBreak.Length));
+        }
+
+        // Return the ranges we have calculated tags for and the tags themselves.
+        await this.UpdateTagsAsync(ranges, tags, CancellationToken.None);
+    }
+}

New_Extensibility_Model/Samples/ClassificationSample/CsvTaggerProvider.cs

@@ -0,0 +1,81 @@
+// Copyright (c) Microsoft. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+namespace ClassificationSample;
+
+using System;
+using System.Collections.Generic;
+using System.Threading;
+using System.Threading.Tasks;
+using Microsoft.VisualStudio.Extensibility;
+using Microsoft.VisualStudio.Extensibility.Editor;
+
+#pragma warning disable VSEXTPREVIEW_TAGGERS // Type is for evaluation purposes only and is subject to change or removal in future updates. Suppress this diagnostic to proceed.
+
+[VisualStudioContribution]
+internal class CsvTaggerProvider : ExtensionPart, ITextViewTaggerProvider<ClassificationTag>, ITextViewChangedListener
+{
+    private readonly object lockObject = new();
+    private readonly Dictionary<Uri, List<CsvTagger>> taggers = new();
+
+    [VisualStudioContribution]
+    public static DocumentTypeConfiguration CsvDocumentType => new("csv")
+    {
+        FileExtensions = new[] { ".csv" },
+        BaseDocumentType = DocumentType.KnownValues.PlainText,
+    };
+
+    public TextViewExtensionConfiguration TextViewExtensionConfiguration => new()
+    {
+        AppliesTo = [DocumentFilter.FromDocumentType(CsvDocumentType)],
+    };
+
+    public async Task TextViewChangedAsync(TextViewChangedArgs args, CancellationToken cancellationToken)
+    {
+        List<Task> tasks = new();
+        lock (this.lockObject)
+        {
+            if (this.taggers.TryGetValue(args.AfterTextView.Uri, out var taggers))
+            {
+                foreach (var tagger in taggers)
+                {
+                    tasks.Add(tagger.TextViewChangedAsync(args.AfterTextView, args.Edits, cancellationToken));
+                }
+            }
+        }
+
+        await Task.WhenAll(tasks);
+    }
+
+    Task<TextViewTagger<ClassificationTag>> ITextViewTaggerProvider<ClassificationTag>.CreateTaggerAsync(ITextViewSnapshot textView, CancellationToken cancellationToken)
+    {
+        var tagger = new CsvTagger(this, textView.Document.Uri);
+        lock (this.lockObject)
+        {
+            if (!this.taggers.TryGetValue(textView.Document.Uri, out var taggers))
+            {
+                taggers = new();
+                this.taggers[textView.Document.Uri] = taggers;
+            }
+
+            taggers.Add(tagger);
+        }
+
+        return Task.FromResult<TextViewTagger<ClassificationTag>>(tagger);
+    }
+
+    internal void RemoveTagger(Uri documentUri, CsvTagger toBeRemoved)
+    {
+        lock (this.lockObject)
+        {
+            if (this.taggers.TryGetValue(documentUri, out var taggers))
+            {
+                taggers.Remove(toBeRemoved);
+                if (taggers.Count == 0)
+                {
+                    this.taggers.Remove(documentUri);
+                }
+            }
+        }
+    }
+}

New_Extensibility_Model/Samples/ClassificationSample/ExtensionEntrypoint.cs

@@ -0,0 +1,31 @@
+// Copyright (c) Microsoft. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+namespace ClassificationSample;
+
+using Microsoft.Extensions.DependencyInjection;
+using Microsoft.VisualStudio.Extensibility;
+
+/// <summary>
+/// Extension entry point for the ClassificationSample extension.
+/// </summary>
+[VisualStudioContribution]
+public class ExtensionEntrypoint : Extension
+{
+    /// <inheritdoc/>
+    public override ExtensionConfiguration ExtensionConfiguration => new()
+    {
+        Metadata = new(
+                id: "ClassificationSample.2e2edd6e-ccf8-4303-a159-068724c63ab0",
+                version: this.ExtensionAssemblyVersion,
+                publisherName: "Microsoft",
+                displayName: "Classification Sample Extension",
+                description: "Sample extension demonstrating contributing a classification tagger"),
+    };
+
+    /// <inheritdoc/>
+    protected override void InitializeServices(IServiceCollection serviceCollection)
+    {
+        base.InitializeServices(serviceCollection);
+    }
+}

New_Extensibility_Model/Samples/ClassificationSample/README.md

@@ -0,0 +1,55 @@
+---
+title: Classification Extension Sample reference
+description: A reference for Classification sample
+date: 2025-04-22
+---
+
+# Classification Extension Sample
+
+This extension creates a tagger that classifies the text of CSV files.
+
+A detailed walkthrough of how to create a tagger is available in the
+[Taggers sample readme file](../TaggersSample/README.md). Please read
+that first.
+
+This sample's `CsvTaggerProvider` and `CsvTagger` are equivalent to `MarkdownTextMarkerTaggerProvider` and `MarkdownTextMarkerTagger`.
+
+## Classification
+
+Classification can be performed by an extension by implementing an
+`ITextViewTaggerProvider<ClassificationTag>` and have the `TextViewTagger<>`
+generate `ClassificationTag` values.
+
+```cs
+tags.Add(
+    new TaggedTrackingTextRange<ClassificationTag>(
+        new TrackingTextRange(
+            document,
+            tagStartPosition,
+            tagLength,
+            TextRangeTrackingMode.ExtendNone),
+        new ClassificationTag(ClassificationType.KnownValues.Operator)));
+
+```
+
+At this time, VisualStudio.Extensibility doesn't support defining text colors for
+new classification types yet, so we must use existing classification types.
+
+VSSDK-compatible extensions, can use [ClassificationTypeDefinition](https://learn.microsoft.com/dotnet/api/microsoft.visualstudio.text.classification.classificationtypedefinition)
+to define new classification types. Their name can be referenced using
+`ClassificationType.Custom`.
+
+## Performance considerations
+
+Since `CsvTagger` doesn't support CSV fields containing line breaks, the
+tagger can perform parsing of any single line of the CSV file independently
+from each other. This allows the tagger to only act on the modified lines.
+
+We further optimize the tag generation by intersecting the edited text ranges
+with the ranges that have been previously requested (`GetAllRequestedRangesAsync`).
+This is particularly useful if the user pastes a large amount of text into
+the file resulting in lines being edited that don't fall into the currently
+visible portion of the view.
+
+ If these optimization were not possible, we would have to avoid generating tags
+ on each edit of the document (see the [Implementing "slow" taggers](../TaggersSample/README.md#implementing-slow-taggers) chapter of the Taggers sample readme file).

New_Extensibility_Model/Samples/CodeLensSample/CodeLensSample.csproj

@@ -7,8 +7,8 @@
   </PropertyGroup>
 
   <ItemGroup>
-    <PackageReference Include="Microsoft.VisualStudio.Extensibility.Sdk" Version="17.13.40008" PrivateAssets="all" />
-    <PackageReference Include="Microsoft.VisualStudio.Extensibility.Build" Version="17.13.40008" PrivateAssets="all" />
+    <PackageReference Include="Microsoft.VisualStudio.Extensibility.Sdk" Version="17.14.40254" PrivateAssets="all" />
+    <PackageReference Include="Microsoft.VisualStudio.Extensibility.Build" Version="17.14.40254" PrivateAssets="all" />
   </ItemGroup>
 
   <ItemGroup>

New_Extensibility_Model/Samples/CommandParentingSample/CommandParentingSample.csproj

@@ -5,13 +5,10 @@
     <ImplicitUsings>enable</ImplicitUsings>
     <Nullable>enable</Nullable>
     <LangVersion>12</LangVersion>
-
-    <!-- The VisualStudio.Extensibility preview packages are available from the azure-public/vside/msft_consumption feed -->
-    <RestoreAdditionalProjectSources>https://pkgs.dev.azure.com/azure-public/vside/_packaging/msft_consumption/nuget/v3/index.json;$(RestoreAdditionalProjectSources)</RestoreAdditionalProjectSources>
-  </PropertyGroup>
+ </PropertyGroup>
 
   <ItemGroup>
-    <PackageReference Include="Microsoft.VisualStudio.Extensibility.Sdk" Version="17.13.40008" PrivateAssets="all" />
-    <PackageReference Include="Microsoft.VisualStudio.Extensibility.Build" Version="17.13.40008" PrivateAssets="all" />
+    <PackageReference Include="Microsoft.VisualStudio.Extensibility.Sdk" Version="17.14.40254" PrivateAssets="all" />
+    <PackageReference Include="Microsoft.VisualStudio.Extensibility.Build" Version="17.14.40254" PrivateAssets="all" />
   </ItemGroup>
 </Project>

New_Extensibility_Model/Samples/CommentRemover/CommentRemover.csproj

@@ -11,8 +11,8 @@
   </PropertyGroup>
 
   <ItemGroup>
-    <PackageReference Include="Microsoft.VisualStudio.Extensibility.Sdk" Version="17.13.40008" PrivateAssets="all" />
-    <PackageReference Include="Microsoft.VisualStudio.Extensibility.Build" Version="17.13.40008" PrivateAssets="all" />
+    <PackageReference Include="Microsoft.VisualStudio.Extensibility.Sdk" Version="17.14.40254" PrivateAssets="all" />
+    <PackageReference Include="Microsoft.VisualStudio.Extensibility.Build" Version="17.14.40254" PrivateAssets="all" />
     <PackageReference Include="Microsoft.VisualStudio.SDK" Version="17.6.36389" ExcludeAssets="runtime" />
   </ItemGroup>
 

New_Extensibility_Model/Samples/CompositeExtension/CompositeExtension/CompositeExtension.csproj

@@ -9,8 +9,8 @@
   </PropertyGroup>
 
   <ItemGroup>
-    <PackageReference Include="Microsoft.VisualStudio.Extensibility.Sdk" Version="17.13.40008" PrivateAssets="all" />
-    <PackageReference Include="Microsoft.VisualStudio.Extensibility.Build" Version="17.13.40008" PrivateAssets="all" />
+    <PackageReference Include="Microsoft.VisualStudio.Extensibility.Sdk" Version="17.14.40254" PrivateAssets="all" />
+    <PackageReference Include="Microsoft.VisualStudio.Extensibility.Build" Version="17.14.40254" PrivateAssets="all" />
     <PackageReference Include="Microsoft.VisualStudio.SDK" Version="17.6.36389" ExcludeAssets="runtime" />
   </ItemGroup>
 

New_Extensibility_Model/Samples/CompositeExtension/OutOfProcComponent/OutOfProcComponent.csproj

@@ -17,8 +17,8 @@
   </PropertyGroup>
 
   <ItemGroup>
-    <PackageReference Include="Microsoft.VisualStudio.Extensibility.Sdk" Version="17.13.40008" PrivateAssets="all" />
-    <PackageReference Include="Microsoft.VisualStudio.Extensibility.Build" Version="17.13.40008" PrivateAssets="all" />
+    <PackageReference Include="Microsoft.VisualStudio.Extensibility.Sdk" Version="17.14.40254" PrivateAssets="all" />
+    <PackageReference Include="Microsoft.VisualStudio.Extensibility.Build" Version="17.14.40254" PrivateAssets="all" />
   </ItemGroup>
 
   <ItemGroup>