[NETSDKE2E] TextDocument error occurred after creating component from tag by light bulb.

[yinjiehe01]

REGRESSION INFO

Works well on prerelease C# 2.87.30

INSTALL STEPS

1.Repro OS: Linux
2.Install latest VSCode (latest released version 1.103.0).
3.Install SDK 10.0 Preview 6/SDK 9.0
4.Install C# main [2.88.28] and C#DK main [1.41.22]

REPRO STEPS

1. Create a blazor project and open it with VS Code.
2. Open Home.razor page and type <SomeUnknownTag>, and it will provide a light bulb to "Create component from tag". Executing the light bulb creates a new SomeUnknokwnTag.razor file.
3. Open the SomeUnknokwnTag.razor file and observe.

ACTUAL

TextDocument error occurred.

2025-08-01 16:43:17.102 [info] Locating .NET runtime version 9.0.1
2025-08-01 16:43:17.295 [info] Dotnet path: /home/nicole/dotnet/dotnet
2025-08-01 16:43:17.295 [info] Activating C# + C# Dev Kit...
2025-08-01 16:43:17.455 [info] [stdout] info: Program[0]
      Server started with process ID 10342

2025-08-01 16:43:17.957 [info] [stdout] {"pipeName":"/tmp/9b425842.sock"}

2025-08-01 16:43:17.958 [info] received named pipe information from server
2025-08-01 16:43:17.960 [info] client has connected to server
2025-08-01 16:43:18.150 [info] [Info  - 4:43:18 PM] [Program] Language server initialized
2025-08-01 16:43:34.791 [info] Locating .NET runtime version 9.0.1
2025-08-01 16:43:35.025 [info] Dotnet path: /home/nicole/dotnet/dotnet
2025-08-01 16:43:35.025 [info] Activating C# + C# Dev Kit...
2025-08-01 16:43:35.147 [info] [stdout] info: Program[0]
      Server started with process ID 10587

2025-08-01 16:43:35.694 [info] [stdout] {"pipeName":"/tmp/14a60355.sock"}

2025-08-01 16:43:35.694 [info] received named pipe information from server
2025-08-01 16:43:35.697 [info] client has connected to server
2025-08-01 16:43:35.810 [info] [Info  - 4:43:35 PM] [Program] Language server initialized
2025-08-01 16:43:40.884 [info] [Info  - 4:43:40 PM] [serviceBroker/connect] [WorkspaceProjectFactoryService] Project /home/nicole/web3/web3/web3.csproj loaded by C# Dev Kit
2025-08-01 16:44:36.948 [info] [Error - 4:44:36 PM] Request textDocument/documentSymbol failed.
2025-08-01 16:44:36.948 [info]   Message: Couldn't get the source generated document for a hint name that we got from the generator?
  Code: -32000 
[object Object]
2025-08-01 16:44:36.949 [info] [Error - 4:44:36 PM] Request textDocument/inlayHint failed.
2025-08-01 16:44:36.950 [info]   Message: Could not get the code document
  Code: -32000 
[object Object]
2025-08-01 16:44:36.950 [info] [Error - 4:44:36 PM] Request textDocument/diagnostic failed.
2025-08-01 16:44:36.950 [info]   Message: Could not get the code document
  Code: -32000 
[object Object]
2025-08-01 16:44:36.951 [info] [Error - 4:44:36 PM] Document pull failed for text document file:///home/nicole/web3/web3/Components/Pages/SomeUnknownTag.razor
2025-08-01 16:44:36.951 [info]   Message: Could not get the code document
  Code: -32000 
[object Object]
2025-08-01 16:44:37.155 [info] [Error - 4:44:37 PM] Request textDocument/documentSymbol failed.
2025-08-01 16:44:37.155 [info]   Message: Couldn't get the source generated document for a hint name that we got from the generator?
  Code: -32000 
[object Object]
2025-08-01 16:44:37.284 [info] [Error - 4:44:37 PM] Request textDocument/semanticTokens/range failed.
2025-08-01 16:44:37.284 [info]   Message: Could not get the code document
  Code: -32000 
[object Object]
2025-08-01 16:44:40.800 [info] [Error - 4:44:40 PM] Request textDocument/inlayHint failed.
2025-08-01 16:44:40.800 [info]   Message: Could not get the code document
  Code: -32000 
[object Object]
2025-08-01 16:44:40.808 [info] [Error - 4:44:40 PM] Request textDocument/semanticTokens/range failed.
2025-08-01 16:44:40.808 [info]   Message: Could not get the code document
  Code: -32000 
[object Object]

logs.zip

EXPECTED

No problem occurred.

[davidwengier]

Looks like we're still getting some annoying interplay with file-based-programs. At the point at which this throws, the Razor file is an AdditionalDocument in the real project, and a regular Document in a file-based-project in the same solution. The apply changes logic doesn't like that it seems.

Looking at the code it seems to be aware that Razor documents are additional documents, but maybe there is another way that documents can get added to these projects?

@RikkiGibson or @jasonmalinowski if you have any suggested places to start debugging, I'm all ears. Or if you want to take this one 😁

[davidwengier]

Feels like this should just never be possible to hit:

If the file extension isn't .cs, shouldn't the whole file-based system just nope out?

EDIT: Yep, the dotnet-api is returning XML for a project with <Compile Include="....Component.razor" />. That ain't gonna work.

[jasonmalinowski]

Is this line wrong?

https://github.com/dotnet/roslyn/blob/73ea6887cb8abecabf3dcd3b8109d4336690afe9/src/LanguageServer/Microsoft.CodeAnalysis.LanguageServer/FileBasedPrograms/FileBasedProgramsProjectSystem.cs#L77

Because in the case of a Razor doc, we still stick it inside a C# project?

[davidwengier]

Well, we do need to stick misc Razor documents in C# projects, so it's not wrong, but a file-based project shouldn't be created for a non C# file IMO.

I think part of the issue is that there is no real filtering done to try to determine whether something should be a file based project, except for this method:
https://github.com/dotnet/roslyn/blob/73ea6887cb8abecabf3dcd3b8109d4336690afe9/src/LanguageServer/Microsoft.CodeAnalysis.LanguageServer/FileBasedPrograms/VirtualProjectXmlProvider.cs#L152-L160

Since in this repro the .razor document is empty, I suspect that method is happily loading the file, parsing it as C#, and reporting that yep, that's a file based project.

I'm trying to see if I can just no-op in TryLoadProjectInMSBuildHostAsync for any file without a .cs extension, but dogfooding of local bits in VS Code is proving difficult.

[jasonmalinowski]

@davidwengier I'm suspecting the intent of that check was to check for "C#" documents, and we forgot that also includes razor documents too. Adjusting that filter to make doDesignTimeBuild false will prevent it from taking all the other paths.

[davidwengier]

It's Friday afternoon here, so I'm just gonna put up dotnet/roslyn#79844 to workaround the issue before it's all paged out of my mind. We can continue the debate over there :)

I think it's really just a question of allow list .cs or deny list .razor. Depends if extension-less files are on the todo list for linux perhaps?