[Bug]: '@typespec/emitter-framework/csharp' does not provide an export named 'getDocComments'

[CStijneAlii]

Describe the bug

Following the steps at https://typespec.io/docs/

I created a new TypeSpec project in VSCode, which created:

package.json

{
  "name": "UserService",
  "version": "0.1.0",
  "type": "module",
  "private": true,
  "dependencies": {
    "@typespec/compiler": "^1.13.0",
    "@typespec/http": "^1.13.0",
    "@typespec/rest": "^0.83.0",
    "@typespec/openapi": "^1.13.0",
    "@typespec/openapi3": "^1.13.0",
    "@typespec/http-client-csharp": "^1.0.0-alpha.20260617.4",
    "@typespec/http-server-csharp": "^0.58.0-alpha.29"
  }
}

---

main.tsp

import "@typespec/http";

using Http;
@service(#{ title: "Widget Service" })
namespace DemoService;

model Widget {
  id: string;
  weight: int32;
  color: "red" | "blue";
}

model WidgetList {
  items: Widget[];
}

@error
model Error {
  code: int32;
  message: string;
}

model AnalyzeResult {
  id: string;
  analysis: string;
}

@route("/widgets")
@tag("Widgets")
interface Widgets {
  /** List widgets */
  @get list(): WidgetList | Error;
  /** Read widgets */
  @get read(@path id: string): Widget | Error;
  /** Create a widget */
  @post create(@body body: Widget): Widget | Error;
  /** Update a widget */
  @patch update(@path id: string, @body body: MergePatchUpdate<Widget>): Widget | Error;
  /** Delete a widget */
  @delete delete(@path id: string): void | Error;

  /** Analyze a widget */
  @route("{id}/analyze") @post analyze(@path id: string): AnalyzeResult | Error;
}

---

tspconfig.yml

kind: project
emit:
  - "@typespec/openapi3"
  - "@typespec/http-client-csharp"
  - "@typespec/http-server-csharp"
options:
  "@typespec/openapi3":
    emitter-output-dir: "{output-dir}/schema"
    openapi-versions:
      - 3.1.0
  "@typespec/http-client-csharp":
    emitter-output-dir: "{output-dir}/clients/csharp"
  "@typespec/http-server-csharp":
    emitter-output-dir: "{output-dir}/server/aspnet"

# entrypoint: main.tsp                           # Main TypeSpec file (default: main.tsp)
# extends: ../tspconfig.yaml                     # Extend another config file
# emit:                                          # Emitter name
#   - "<emitter-name"
# options:                                       # Emitter options
#   <emitter-name>:
#    "<option-name>": "<option-value>"
# environment-variables:                         # Environment variables which can be used to interpolate emitter options
#   <variable-name>:
#     default: "<variable-default>"
# parameters:                                    # Parameters which can be used to interpolate emitter options
#   <param-name>:
#     default: "<param-default>"
# trace:                                         # Trace areas to enable tracing
#  - "<trace-name>"
# warn-as-error: true                            # Treat warnings as errors
# output-dir: "{project-root}/_generated"        # Configure the base output directory for all emitters

I then selected '.NET server code emitter', and got

js-error: Failed to load c:/Users/me/Repositories/typespec/node_modules/@typespec/http-server-csharp/dist/src/index.js due to the following JS error: The requested module '@typespec/emitter-framework/csharp' does not provide an export named 'getDocComments'

Reproduction

Create a new typespec project and try to emit .net server.

Checklist

• Follow our Code of Conduct
• Check that there isn't already an issue that request the same bug to avoid creating a duplicate.
• Check that this is a concrete bug. For Q&A open a GitHub Discussion.
• The provided reproduction is a minimal reproducible example of the bug.

[github-actions]

🎯 Issue Triage

The http-server-csharp emitter fails to load with a JS error stating that the emitter-framework/csharp package does not export getDocComments, indicating a version mismatch between the two packages.

Category: Bug
Area: emitter:service:csharp

⚠️ No playground reproduction applicable — this is a package load-time error, not a TypeSpec compilation issue. The error occurs before any TypeSpec code is processed.

🔍 Analysis

• Error: Failed to load http-server-csharp/dist/src/index.js — The requested module 'emitter-framework/csharp' does not provide an export named 'getDocComments'
• Root cause: The http-server-csharp emitter attempts to import getDocComments from emitter-framework/csharp, but this export does not exist in the installed version. This is likely a version mismatch — either getDocComments was renamed/removed in a newer version of emitter-framework, or the installed packages have incompatible versions.
• Affected package: http-server-csharp (.NET server code emitter)
• Compiler version: compiler@1.13.0
• Triggered via: VSCode scaffolded project using the official getting started docs

📝 Suggested next steps

• Verify whether getDocComments still exists in emitter-framework/csharp at the version required by http-server-csharp@1.13.0
• Check peer dependency version constraints between http-server-csharp and emitter-framework
• If getDocComments was removed or renamed in emitter-framework, update http-server-csharp to use the new API
• Ensure the VSCode scaffolded project installs compatible versions of all emitters

Generated by Agentic Triage