Update TypeScript AppHost GA docs

Document TypeScript AppHost GA support boundaries, CLI restore/add behavior, and the generated .aspire/.modules SDK path across current docs.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Author: sebastienros

src/frontend/config/twoslash.config.mjs

@@ -85,7 +85,13 @@ export function readAspireTypes() {
  */
 export function getTwoslashExtraFiles() {
   const { source } = readAspireTypes();
-  return source ? { '.aspire/modules/aspire.mts': source } : {};
+  return source
+    ? {
+        '.aspire/modules/aspire.mts': source,
+        // Keep historical snippets compiling if they import the old generated path.
+        '.modules/aspire.ts': source,
+      }
+    : {};
 }
 
 /**

src/frontend/src/content/docs/app-host/typescript-apphost.mdx

@@ -75,15 +75,15 @@ The `aspire.config.json` file is the central configuration for your AppHost. It
 | `packages` | Hosting integration packages and their versions. Added automatically by `aspire add`. |
 | `profiles` | Launch profiles with dashboard URLs and environment variables |
 
-### Adding integrations
+### Add and restore integrations
 
-When you run `aspire add`, the CLI adds the package to the `packages` section and regenerates the TypeScript SDK:
+Use `aspire add` from the AppHost root to add hosting integrations. The CLI adds the package to the `packages` section, restores AppHost dependencies, and regenerates the TypeScript SDK in `.aspire/modules/`:
 
 ```bash title="Add an integration"
 aspire add redis
 ```
 
-This updates `aspire.config.json`:
+This updates `aspire.config.json` so the package is restored the next time the AppHost runs:
 
 ```json title="aspire.config.json" ins={4}
 {
@@ -94,6 +94,12 @@ This updates `aspire.config.json`:
 }
 ```
 
+Run `aspire restore` when you want to regenerate `.aspire/modules/` without starting the AppHost, such as after switching branches, updating package versions, or preparing a CI job:
+
+```bash title="Restore a TypeScript AppHost"
+aspire restore
+```
+
 ### Project references for local development
 
 You can reference a local hosting integration project by using a `.csproj` path instead of a version:
@@ -333,6 +339,18 @@ The `aspire doctor` command checks that the required JavaScript toolchain execut
 aspire doctor
 ```
 
+## Known unsupported scenarios
+
+The following boundaries apply to the TypeScript AppHost root:
+
+| Scenario | Support boundary |
+|---|---|
+| Node.js versions outside the scaffolded `engines.node` range | Not part of the supported TypeScript AppHost baseline. Use Node.js 20.19+, 22.13+, or 24.x and later. |
+| Yarn Classic (v1) | Not supported. Upgrade to Yarn 4 or later, or switch to npm, pnpm, or Bun. |
+| Package managers other than npm, pnpm, Yarn 4+, or Bun | Not supported for the AppHost root. Orchestrated apps can still use their own package manager. |
+| Editing generated `.aspire/modules/` files | Not supported. Change `aspire.config.json` or use `aspire add`, then regenerate with `aspire restore`. |
+| Adding hosting packages with package-manager commands | Not supported for TypeScript AppHost integration restore. Use `aspire add` so `aspire.config.json` and `.aspire/modules/` stay in sync. |
+
 ## TypeScript validation before startup
 
 Before starting a TypeScript AppHost, the Aspire CLI runs `tsc --noEmit` to check for type errors to prevent the dashboard and resources from starting in a partially broken state. If your AppHost has TypeScript compile errors, `aspire run` and `aspire publish` stop before the AppHost launches and display the diagnostic output:

src/frontend/src/content/docs/get-started/add-aspire-existing-app.mdx

@@ -35,8 +35,8 @@ Before you begin, make sure you have:
 </TabItem>
 <TabItem id='typescript' label='TypeScript'>
 
-- [Node.js 22.x or 24.x LTS](https://nodejs.org/)
-- npm, yarn, or pnpm
+- [Node.js 20.19+, 22.13+, or 24.x and later](https://nodejs.org/)
+- A [supported AppHost-root package manager](/app-host/typescript-apphost/#package-managers): npm, pnpm, Yarn 4+, or Bun
 
 </TabItem>
 </Tabs>
@@ -107,7 +107,7 @@ Both styles use the same `Aspire.AppHost.Sdk` and the same hosting APIs.
 Use a TypeScript AppHost when your repo already centers on a Node.js workspace or when you prefer path-based orchestration in TypeScript.
 
 - Lives in `apphost.mts`; for existing JavaScript and TypeScript apps, `aspire init` creates it under `aspire-apphost/`
-- Runs under popular package managers including npm, pnpm, yarn, and Bun
+- Runs under supported package managers including npm, pnpm, Yarn 4+, and Bun
 - Fits naturally into existing package-manager and monorepo workflows
 
 </TabItem>
@@ -329,7 +329,7 @@ After setup, a typical workspace layout looks like this:
 </FileTree>
 
 :::note[The .aspire folder is generated]
-Let the Aspire CLI manage `aspire-apphost/.aspire/` rather than editing generated SDK files manually.
+Let the Aspire CLI manage `aspire-apphost/.aspire/` rather than editing generated SDK files manually. Run `aspire restore` to regenerate the TypeScript SDK after switching branches or changing AppHost packages.
 :::
 
 </TabItem>

src/frontend/src/content/docs/get-started/faq.mdx

@@ -64,13 +64,13 @@ Learn more: [What is the AppHost?](/get-started/app-host/), [Deployment overview
 
 **No.** .NET is an especially strong experience in Aspire, but the app model is broader than one framework or runtime. Aspire is designed to coordinate services across multiple stacks, and the TypeScript AppHost makes it a natural fit for existing JavaScript and TypeScript applications as well.
 
-Learn more: [TypeScript AppHost support](/whats-new/aspire-13-2/#-typescript-apphost-support-preview)
+Learn more: [TypeScript AppHost project structure](/app-host/typescript-apphost/)
 
 ## Can I write the AppHost in TypeScript?
 
 **Yes.** A TypeScript AppHost (`apphost.mts`) is a first-class option for existing JavaScript and TypeScript applications. That experience uses commands such as `aspire init --language typescript` and AppHost APIs such as `addNodeApp`, `addViteApp`, and `addJavaScriptApp`.
 
-Learn more: [`aspire init`](/reference/cli/commands/aspire-init/), [TypeScript AppHost support](/whats-new/aspire-13-2/#-typescript-apphost-support-preview)
+Learn more: [`aspire init`](/reference/cli/commands/aspire-init/), [TypeScript AppHost project structure](/app-host/typescript-apphost/)
 
 ## Is Aspire only for brand-new projects?
 

src/frontend/src/content/docs/ja/get-started/faq.mdx

@@ -63,13 +63,13 @@ Aspire は、実システムで頻出する多くの構成要素に対する統
 
 **いいえ。** .NET は Aspire で特に強力な体験を提供しますが、アプリ モデルは 1 つのフレームワークやランタイムに限定されません。Aspire は複数スタックにまたがるサービス調整を目的に設計されており、TypeScript の AppHost によって既存の JavaScript / TypeScript アプリにも自然に適合します。
 
-詳しくはこちら: [TypeScript AppHost サポート](/ja/whats-new/aspire-13-2/#-typescript-apphost-のサポート-プレビュー)
+詳しくはこちら: [TypeScript AppHost サポート](/ja/app-host/typescript-apphost/)
 
 ## AppHost を TypeScript で書けますか?
 
 **はい。** TypeScript の AppHost (`apphost.mts`) は、既存の JavaScript / TypeScript アプリケーション向けの第一級オプションです。この体験では、`aspire init --language typescript` のようなコマンドや、`addNodeApp`、`addViteApp`、`addJavaScriptApp` のような AppHost API を利用します。
 
-詳しくはこちら: [`aspire init`](/ja/reference/cli/commands/aspire-init/)、[TypeScript AppHost サポート](/ja/whats-new/aspire-13-2/#-typescript-apphost-のサポート-プレビュー)
+詳しくはこちら: [`aspire init`](/ja/reference/cli/commands/aspire-init/)、[TypeScript AppHost サポート](/ja/app-host/typescript-apphost/)
 
 ## Aspire は新規プロジェクト専用ですか?
 

src/frontend/src/content/docs/reference/cli/commands/aspire-add.mdx

@@ -22,7 +22,11 @@ aspire add [<integration>] [options]
 
 ## Description
 
-The `aspire add` command searches for an integration package and adds it to the Aspire AppHost.
+The `aspire add` command searches for an integration package and adds it to the Aspire AppHost. The persisted change depends on the AppHost style:
+
+- Project-based C# AppHosts receive a package reference.
+- File-based C# AppHosts receive a `#:package` directive.
+- TypeScript AppHosts receive an entry in the `packages` section of `aspire.config.json`, then the generated `.aspire/modules/` TypeScript SDK is regenerated.
 
 <Include relativePath="reference/cli/includes/project-search-logic-description.md" />
 
@@ -75,3 +79,9 @@ The following options are available:
   ```bash title="Aspire CLI"
   aspire add kafka --version 13.3.0
   ```
+
+- Add the **redis** integration to a TypeScript AppHost and regenerate `.aspire/modules/`:
+
+  ```bash title="Aspire CLI"
+  aspire add redis --apphost './apphost.mts'
+  ```

src/frontend/src/content/docs/reference/cli/commands/aspire-restore.mdx

@@ -17,7 +17,9 @@ aspire restore [options]
 
 ## Description
 
-The `aspire restore` command restores the AppHost project and generates the SDK code that Aspire uses for resources, integrations, and tooling. Use it when you want to make restore an explicit step in automation or validate that the AppHost can restore cleanly without starting it.
+The `aspire restore` command restores the AppHost and generates the SDK code that Aspire uses for resources, integrations, and tooling. Use it when you want to make restore an explicit step in automation or validate that the AppHost can restore cleanly without starting it.
+
+For TypeScript AppHosts, restore reads the `packages` section in `aspire.config.json`, restores those hosting integration packages, and regenerates the `.aspire/modules/` TypeScript SDK imported by `apphost.mts`. This is useful after running `aspire add`, switching branches, updating pinned package versions, or restoring dependencies in CI before `aspire run`, `aspire publish`, or deployment workflows.
 
 <Include relativePath="reference/cli/includes/project-search-logic-description.md" />
 
@@ -55,6 +57,12 @@ The following options are available:
   aspire restore --apphost './src/MyApp.AppHost/MyApp.AppHost.csproj'
   ```
 
+- Restore a specific TypeScript AppHost and regenerate `.aspire/modules/`:
+
+  ```bash title="Aspire CLI"
+  aspire restore --apphost './apphost.mts'
+  ```
+
 ## See also
 
 - [aspire run](../aspire-run/)

src/frontend/src/content/docs/reference/cli/includes/option-project.md

@@ -4,4 +4,4 @@ title: Option AppHost
 
 **`--apphost <apphost>`**
 
-The path to the Aspire AppHost project file.
+The path to the Aspire AppHost file or project file, such as `apphost.ts`, `apphost.cs`, or an AppHost `.csproj`.