# Change Log - typespec-vscode

## 1.13.0

### Bug Fixes

- [#10847](https://github.com/microsoft/typespec/pull/10847) Improved telemetry instrumentation for `install-global-compiler-cli`, `preview-openapi3`, `start-server`, and `server-path-changed` events by adding missing `lastStep` tracking and error detail logging. Added actionable error message when compiler is found but neither `node` nor `tsp` is available on PATH, guiding users to fix common nvm/fnm/volta configuration issues.


## 1.12.0

### Bug Fixes

- [#10567](https://github.com/microsoft/typespec/pull/10567) Handle unhandled exceptions in VS Code extension: add custom error handler for server crashes with restart notification, wrap commands with graceful exception handling, and add null guards to prevent extension host errors when LSP client is unavailable
- [#10523](https://github.com/microsoft/typespec/pull/10523) Show "Launching TypeSpec language service..." progress in the status bar instead of as a notification to avoid blocking the UI
- [#10527](https://github.com/microsoft/typespec/pull/10527) Ensure operation telemetry events always carry a valid `result` value. Previously the `start-extension` event (and any other operation whose callback returned `void`) was sent with `result="undefined"` and classified as an error event. The `doOperationWithTelemetry` callback is now constrained to return `ResultCode | Result<...>`, so the result is always derived from the operation's return value.


## 1.11.0

No changes, version bump only.

## 1.10.0

### Bump dependencies

- [#9838](https://github.com/microsoft/typespec/pull/9838) Upgrade dependencies


## 1.9.0

### Bump dependencies

- [#9446](https://github.com/microsoft/typespec/pull/9446) Upgrade dependencies


## 1.8.0

### Bump dependencies

- [#9223](https://github.com/microsoft/typespec/pull/9223) Upgrade dependencies


## 1.7.0

### Bump dependencies

- [#9046](https://github.com/microsoft/typespec/pull/9046) Upgrade dependencies


## 1.6.0

### Bump dependencies

- [#8823](https://github.com/microsoft/typespec/pull/8823) Upgrade dependencies

### Bug Fixes

- [#8735](https://github.com/microsoft/typespec/pull/8735) Fix `pnpm clean && pnpm build` create diff in vscode package folder


## 1.5.0

### Features

- [#7929](https://github.com/microsoft/typespec/pull/7929) Allow configuring which file names to use as entrypoints
- [#8346](https://github.com/microsoft/typespec/pull/8346) 1. Limit the vscode tasks to be created when the extension is starting
  2. Do not include the emitters by default when compiling in LSP. Setting 'typespec.lsp.emit' can be used to configure the emitters to include explicitly (set to ['<config:defaults>'] to include all the emitters defined in tspconfig.yaml)

### Bump dependencies

- [#8437](https://github.com/microsoft/typespec/pull/8437) Upgrade dependencies


## 1.4.0

### Features

- [#7691](https://github.com/microsoft/typespec/pull/7691) Prefill all available emitter options as comments when adding a new emitter

### Bump dependencies

- [#8317](https://github.com/microsoft/typespec/pull/8317) Upgrade dependencies


## 1.3.0

### Features

- [#7830](https://github.com/microsoft/typespec/pull/7830) Get emitter options from the `resolveCompilerOptions` function of the compiler
- [#6802](https://github.com/microsoft/typespec/pull/6802) Add test case for TypeSpec Extension

### Bump dependencies

- [#7978](https://github.com/microsoft/typespec/pull/7978) Upgrade dependencies


## 1.2.0

### Features

- [#7576](https://github.com/microsoft/typespec/pull/7576) Allow LSP to configure which emitters to include for live checks

### Bump dependencies

- [#7674](https://github.com/microsoft/typespec/pull/7674) Upgrade dependencies


## 1.1.0

### Features

- [#7317](https://github.com/microsoft/typespec/pull/7317) Enable emit code command on tspconfig.yaml.
- [#6783](https://github.com/microsoft/typespec/pull/6783) Install packages for unrecognized import via npm command
- [#7239](https://github.com/microsoft/typespec/pull/7239) Use language server to compile project instead of CLI
- [#7331](https://github.com/microsoft/typespec/pull/7331) Support prompting to install compiler proactively if no compiler is found when starting LSP
- [#7541](https://github.com/microsoft/typespec/pull/7541) Add extension API for other vscode extension to be able to register more TypeSpec InitTemplate to choose when scaffolding TypeSpec project.

### Bump dependencies

- [#7323](https://github.com/microsoft/typespec/pull/7323) Upgrade dependencies

### Bug Fixes

- [#7300](https://github.com/microsoft/typespec/pull/7300) Unify the writing of OpenAPI 3
- [#7353](https://github.com/microsoft/typespec/pull/7353) Fix openapi3 preview error when path contains space
- [#7374](https://github.com/microsoft/typespec/pull/7374) Check whether the compiler language server supports project compilation.
- [#7302](https://github.com/microsoft/typespec/pull/7302) Telemetry data item result displays `cancelled` when the `Select file` step of `Preview API Documentation` is `cancelled`


## 1.0.0

### Features

- [#7042](https://github.com/microsoft/typespec/pull/7042) send compile startTime and endTime telemetry


## 0.69.0

### Bug Fixes

- [#6894](https://github.com/microsoft/typespec/pull/6894) Fix the issue where the emitter version is undefined in telemetry.
- [#7021](https://github.com/microsoft/typespec/pull/7021) Fix crash when initialize telemetry client


## 0.68.0

### Bump dependencies

- [#6595](https://github.com/microsoft/typespec/pull/6595) Upgrade dependencies

### Bug Fixes

- [#6668](https://github.com/microsoft/typespec/pull/6668) Fix error when upgrading to use latest telemetry library
- [#6690](https://github.com/microsoft/typespec/pull/6690) Fix the issue to log compiler information as an error. And remove PREVIEW prefix for server code emitter
- [#6694](https://github.com/microsoft/typespec/pull/6694) compiler can be resolved automatically when it's not installed in the root folder of the first opened workspace.
- [#6620](https://github.com/microsoft/typespec/pull/6620) Update menu item and command text for "Show OpenAPI3 Documentation" and "Import TypeSpec from OpenApi3"


## 0.67.0

### Features

- [#6178](https://github.com/microsoft/typespec/pull/6178) Update references to JS emitter
- [#5972](https://github.com/microsoft/typespec/pull/5972) Select multiple emitters to generate multiple codes at one time
- [#6295](https://github.com/microsoft/typespec/pull/6295) Improve the "Create TypeSpec Project" user experience
- [#6015](https://github.com/microsoft/typespec/pull/6015) add openapi3 preview
- [#6123](https://github.com/microsoft/typespec/pull/6123) Support telemetry

### Bump dependencies

- [#6266](https://github.com/microsoft/typespec/pull/6266) Update dependencies

### Bug Fixes

- [#6144](https://github.com/microsoft/typespec/pull/6144) Add missing node to list of suggestion when tsp server cannot start


## 0.66.0

### Features

- [#6014](https://github.com/microsoft/typespec/pull/6014) Add "Import TypeSpec from OpenApi3" menu item into explorer context menu
- [#6210](https://github.com/microsoft/typespec/pull/6210) Support starting LSP using standalone tsp cli
- [#6164](https://github.com/microsoft/typespec/pull/6164) Renamed package `@typespec/http-server-javascript` to `@typespec/http-server-js`.

### Bug Fixes

- [#6137](https://github.com/microsoft/typespec/pull/6137) Fix code snippet for union in typespec-vscode


## 0.65.0

### Bug Fixes

- [#5752](https://github.com/microsoft/typespec/pull/5752) Disable coloring text when generating code
- [#5754](https://github.com/microsoft/typespec/pull/5754) Add example to the vscode setting "initTemplatesUrls"
- [#5886](https://github.com/microsoft/typespec/pull/5886) refine the quickpick placeholder and the log
- [#5834](https://github.com/microsoft/typespec/pull/5834) Update extension configuration URLs in error message

### Bump dependencies

- [#5690](https://github.com/microsoft/typespec/pull/5690) Upgrade dependencies

### Features

- [#5451](https://github.com/microsoft/typespec/pull/5451) Support importing TypeSpec from OpenAPI 3.0 doc


## 0.64.0

### Bug Fixes

- [#5413](https://github.com/microsoft/typespec/pull/5413) Do not start TypeSpec Language Server when there is no workspace opened
- [#5131](https://github.com/microsoft/typespec/pull/5131) Support 'See Document' quick action to view the details of linter rules
- [#5428](https://github.com/microsoft/typespec/pull/5428) improve console output when tsp-server not found

### Features

- [#5312](https://github.com/microsoft/typespec/pull/5312) integrate client SDK generation
- [#5314](https://github.com/microsoft/typespec/pull/5314) Rename vscode extension from "TypeSpec for VS Code" to "TypeSpec"
- [#5594](https://github.com/microsoft/typespec/pull/5594) Support Emitters section in Init Template when creating TypeSpec project in vscode
- [#5294](https://github.com/microsoft/typespec/pull/5294) Support "Create TypeSpec Project" in vscode command and EXPLORER when no folder opened
Add Setting "typespec.initTemplatesUrls" where user can configure additional template to use to create TypeSpec project
example:
```
{
  "typespec.initTemplatesUrls": [
    {
      "name": "displayName",
      "url": "https://urlToTheFileContainsTemplates"
    }],
}
```
Support "Install TypeSpec Compiler/CLI globally" in vscode command to install TypeSpec compiler globally easily


## 0.63.0

No changes, version bump only.

## 0.62.0

### Bug Fixes

- [#4912](https://github.com/microsoft/typespec/pull/4912) Fix the issue when Typespec Language Server can't be restarted when the server wasn't running before

### Bump dependencies

- [#4679](https://github.com/microsoft/typespec/pull/4679) Upgrade dependencies - October 2024

### Features

- [#4790](https://github.com/microsoft/typespec/pull/4790) Support completion for tspconfig.yaml file in vscode
- [#4737](https://github.com/microsoft/typespec/pull/4737) Add basic snippets for typespec
- [#4912](https://github.com/microsoft/typespec/pull/4912) TypeSpec Language Server would be restarted with new settings when setting "typespec.tsp-server.path" is changed


## 0.61.0

### Bug Fixes

- [#4430](https://github.com/microsoft/typespec/pull/4430) Use "shell" when spawning execution of .cmd file(i.e. tsp-server.cmd) in windows

### Bump dependencies

- [#4424](https://github.com/microsoft/typespec/pull/4424) Bump dependencies

### Features

- [#4330](https://github.com/microsoft/typespec/pull/4330) Support Compile Task and Watch Task in vscode.
- [#4498](https://github.com/microsoft/typespec/pull/4498) Make extension web compatible with minimal functionality


## 0.60.0

No changes, version bump only.

## 0.59.0

### Bump dependencies

- [#3948](https://github.com/microsoft/typespec/pull/3948) Update dependencies


## 0.58.0

### Bump dependencies

- [#3718](https://github.com/microsoft/typespec/pull/3718) Dependency updates July 2024


## 0.57.0

### Bump dependencies

- [#3401](https://github.com/microsoft/typespec/pull/3401) Update dependencies - May 2024

### Features

- [#3533](https://github.com/microsoft/typespec/pull/3533) Enhance logging and trace
 1. Support "Developer: Set Log Level..." command to filter logs in TypeSpec output channel
 2. Add "typespecLanguageServer.trace.server" config for whether and how to send the traces from TypeSpec language server to client. (It still depends on client to decide whether to show these traces based on the configured Log Level.)
 3. More logs and traces are added for diagnostic and troubleshooting
- [#3385](https://github.com/microsoft/typespec/pull/3385) Add 'TypeSpec: Show Output Channel' command in VSCode extension


## 0.56.0

### Bump dependencies

- [#3169](https://github.com/microsoft/typespec/pull/3169) Update dependencies


## 0.55.0

### Bump dependencies

- [#3027](https://github.com/microsoft/typespec/pull/3027) Update dependencies


## 0.54.0

### Bump dependencies

- [#2900](https://github.com/microsoft/typespec/pull/2900) Update dependencies


## 0.53.0

### Patch Changes

- ba02533: Added icons to the extensions


## 0.52.1

Wed, 24 Jan 2024 05:46:53 GMT

_Version update only_

## 0.52.0

Wed, 24 Jan 2024 05:46:53 GMT

### Updates

- Update dependencies

## 0.51.0

Wed, 06 Dec 2023 19:40:58 GMT

_Version update only_

## 0.50.0

Wed, 08 Nov 2023 00:07:17 GMT

### Updates

- `TypeScript` use `types` entry under `exports` of `package.json` instead of legacy `typesVersions` to provide the definition files

## 0.49.0

Wed, 11 Oct 2023 23:31:35 GMT

### Updates

- Update dependencies

## 0.48.0

Tue, 12 Sep 2023 21:47:11 GMT

### Updates

- Add colors definition for `param`

## 0.47.0

Tue, 08 Aug 2023 22:32:10 GMT

_Version update only_

## 0.46.0

Tue, 11 Jul 2023 22:06:00 GMT

### Updates

- Remove `mkdirp` dependencies and replace with built-in `mkdir({recursive: true})`.
- Update dependencies

## 0.45.0

Tue, 06 Jun 2023 22:44:16 GMT

_Version update only_

## 0.44.0

Wed, 10 May 2023 21:24:00 GMT

### Updates

- Update dependencies

## 0.43.0

Tue, 11 Apr 2023 18:49:17 GMT

### Updates

- Fix highlighting of TypeSpec code blocks in markdown.

## 0.42.0

Mon, 13 Mar 2023 21:30:44 GMT

_Version update only_

## 0.41.0

Fri, 03 Mar 2023 19:59:17 GMT

### Updates

- Adding .cadl file support
- Revert back changelog
- Rename to TypeSpec
- Update homepage link

## 0.40.0

Tue, 07 Feb 2023 21:56:17 GMT

_Version update only_

## 0.39.0

Fri, 13 Jan 2023 00:05:26 GMT

### Updates

- Internal: Update TS module resolution to node16
- Internal: package with newest vsce

## 0.38.0

Wed, 07 Dec 2022 17:21:52 GMT

### Patches

- Update dependencies

## 0.17.0

Sat, 12 Nov 2022 00:14:04 GMT

### Minor changes

- Extension lookup for a local cadl compiler first instead of a global

### Patches

- Internal: Fix loading VS Code extension unbundled in F5 dev scenario

## 0.16.1

Wed, 12 Oct 2022 21:12:35 GMT

### Patches

- Fix preference documentation for cadl-server path configuration

## 0.16.0

Thu, 08 Sep 2022 01:04:53 GMT

### Minor changes

- Add support for `${workspaceFolder}` interpolation in configuration. As `workspaceRoot` is deprecated by VSCode

### Patches

- Allow cadl.restartServer command to work when no .cadl file has been opened

## 0.15.2

Thu, 11 Aug 2022 19:05:23 GMT

### Patches

- Providing `cadl.cadl-server.path` option will force the specified compiler to be used

## 0.15.1

Fri, 08 Jul 2022 23:22:58 GMT

_Version update only_

## 0.15.0

Mon, 13 Jun 2022 23:42:28 GMT

### Minor changes

- Update tmLanguage grammar for operation signature support
- Add semantic colorization

### Patches

- Improve error reporting when cadl-server is not found
- Resolve issue with `language-configuration.json` being excluded from extension

### Updates

- Upgrade to TS4.7

## 0.14.0

Fri, 06 May 2022 17:19:57 GMT

### Minor changes

- Color decorators differently than operations
- Uptake `mixes` -> `extends` rename
- Update `language-configuration.json` to newer format and generate it from cadl language server data
- Remove node 14 support
- Add command to restart language server

## 0.13.1

Thu, 31 Mar 2022 17:10:49 GMT

_Version update only_

## 0.13.0

Wed, 09 Mar 2022 17:42:09 GMT

### Minor changes

- Allow `op` interfaces
- Add punctuation and additional fine grain scopes to grammar

## 0.12.1

Mon, 14 Feb 2022 03:01:08 GMT

### Patches

- Bump dependency versions

## 0.12.0

Fri, 04 Feb 2022 18:00:18 GMT

### Minor changes

- Add cadl project file to list of files watched

## 0.11.0

Wed, 01 Dec 2021 22:56:11 GMT

### Minor changes

- Add syntax highlighting code-fenced cadl blocks in markdown

### Patches

- Fix colorization of multiple mixes
- Fix syntax highlighting of namespace-qualified decorator application
- Update README

## 0.10.0

Thu, 11 Nov 2021 21:46:21 GMT

### Minor changes

- **Change** `cadl.cadl-server.path` should point to the `@cadl-lang/compiler` package instead of `cadl-server` binary.

## 0.9.0

Fri, 15 Oct 2021 21:33:37 GMT

### Minor changes

- **Added** Language server support for directives
- Add colorization for interfaces
- Add colorization of union declarations

## 0.8.0

Tue, 10 Aug 2021 20:23:04 GMT

### Minor changes

- React to package renames

## 0.7.0

Mon, 02 Aug 2021 18:17:00 GMT

### Minor changes

- Rename ADL to Cadl

## 0.6.0

Fri, 09 Jul 2021 20:21:06 GMT

### Minor changes

- Add semantic analysis to language server

## 0.5.2

Thu, 24 Jun 2021 03:57:43 GMT

### Patches

- Handle untitled source files in VS Code

## 0.5.1

Tue, 18 May 2021 23:43:31 GMT

### Patches

- Fix issue launching adl-server on Mac OS

## 0.5.0

Thu, 06 May 2021 14:56:02 GMT

### Minor changes

- Implement alias and enum, remove model =

### Patches

- Update syntax highlighting for string literal change

## 0.4.5

Tue, 20 Apr 2021 15:23:29 GMT

### Patches

- Fix syntax highlighting for tuple expressions

## 0.4.4

Wed, 31 Mar 2021 22:00:43 GMT

### Patches

- Add syntax highlighting for import and using statements
- Add VS Code configuration option for adl-server path
- Use PList for textmate grammar

## 0.4.3

Fri, 26 Mar 2021 17:06:33 GMT

### Patches

- Fix commenting and indenting behaviors

## 0.4.2

Wed, 24 Mar 2021 18:40:21 GMT

### Patches

- Extract textmate generator to helper library

## 0.4.1

Tue, 23 Mar 2021 01:06:29 GMT

### Patches

- Remove unnecessary npm dependency

## 0.4.0

Tue, 16 Mar 2021 23:13:42 GMT

### Minor changes

- Introduce language server and add live parse errors to VS Code

### Patches

- Initial version of VS Code extension
