chore: use tinyexec

.prettierignore

@@ -1,2 +1,3 @@
 packages/sv/src/cli/tests/snapshots/*
-packages/sv-utils/src/tests/**/output.ts
+packages/sv-utils/src/tests/**/output.ts
+packages/sv/src/create/shared/+skills/*

documentation/docs/20-commands/20-sv-add.md

@@ -49,10 +49,10 @@ Do not prompt to install dependencies.
 
 ## Official add-ons
 
+- [`ai-tools`](ai-tools)
 - [`better-auth`](better-auth)
 - [`drizzle`](drizzle)
 - [`eslint`](eslint)
-- [`mcp`](mcp)
 - [`mdsvex`](mdsvex)
 - [`paraglide`](paraglide)
 - [`playwright`](playwright)

documentation/docs/30-add-ons/01-ai-tools.md

@@ -0,0 +1,56 @@
+---
+title: ai-tools
+---
+
+The [Svelte AI tools](/docs/ai/overview) can help your LLM write better Svelte code.
+
+## Usage
+
+```sh
+npx sv add ai-tools
+```
+
+## What you get
+
+You can add the tooling either through the official Svelte plugin or as individual tools.
+
+- The Svelte plugin bundles everything (MCP server, [skills](https://svelte.dev/docs/ai/skills) and sub-agents) and keeps itself up to date. It's available for Claude Code and OpenCode. For Claude Code it's enabled through a committed `.claude/settings.json` - the first time you open the project you'll be asked to trust the workspace, then it installs automatically (no `/plugin install` needed).
+- Individual tools, for clients without a plugin (or when you want to pick exactly what to add):
+  - An MCP configuration for [local](https://svelte.dev/docs/ai/local-setup) or [remote](https://svelte.dev/docs/ai/remote-setup) setup
+  - A [README for agents](https://agents.md/) to help you use the MCP server effectively
+  - [Skills](https://svelte.dev/docs/ai/skills) for clients that support them
+  - Sub-agents for clients that support them
+
+## Options
+
+### ide
+
+The client(s) you want to use like `'claude-code'`, `'cursor'`, `'gemini'`, `'opencode'`, `'vscode'`, `'other'`.
+
+```sh
+npx sv add ai-tools="ide:cursor,vscode"
+```
+
+### delivery
+
+How to add the tooling: `'plugin'` (the Svelte plugin, recommended) or `'tools'` (individual tools). Only asked when a selected client supports a plugin.
+
+```sh
+npx sv add ai-tools="ide:claude-code+delivery:plugin"
+```
+
+### tools
+
+Which individual tools to add when not using the plugin, like `'mcp'`, `'svelte-code-writer'`, `'svelte-core-bestpractices'`, `'svelte-file-editor'`.
+
+```sh
+npx sv add ai-tools="ide:cursor+delivery:tools+tools:mcp,svelte-file-editor"
+```
+
+### mcpSetup
+
+The MCP setup you want to use (`'local'` or `'remote'`). Only relevant when adding the MCP server as an individual tool.
+
+```sh
+npx sv add ai-tools="mcpSetup:local"
+```

documentation/docs/30-add-ons/99-community.md

@@ -37,9 +37,12 @@ export default defineAddon({
 		})
 		.build(),
 
-	setup: ({ dependsOn, isKit, unsupported }) => {
+	setup: ({ dependsOn, isKit, unsupported, addOption }) => {
 		if (!isKit) unsupported('Requires SvelteKit');
 		dependsOn('vitest');
+
+		// dynamically add options (e.g. based on workspace state or fetched data)
+		// addOption('key', { question: '...', type: 'boolean', default: true });
 	},
 
 	run: ({ isKit, cancel, sv, options, file, language, directory }) => {

documentation/docs/50-api/10-sv.md

@@ -16,10 +16,18 @@ export default defineAddon({
 	id: 'my-addon',
 	options: defineAddonOptions().build(),
 
-	// called before run — declare dependencies and environment requirements
-	setup: ({ dependsOn, unsupported, isKit }) => {
+	// called before run - declare dependencies, environment requirements, and dynamic options
+	setup: ({ dependsOn, unsupported, addOption, isKit }) => {
 		if (!isKit) unsupported('Requires SvelteKit');
 		dependsOn('eslint');
+
+		// dynamically add options based on workspace state or fetched data
+		addOption('theme', {
+			question: 'Which theme?',
+			type: 'select',
+			default: 'dark',
+			options: [{ value: 'dark' }, { value: 'light' }]
+		});
 	},
 
 	// the actual work — add files, edit files, declare dependencies
@@ -50,6 +58,31 @@ export default defineAddon({
 
 The `sv` object in `run` provides `file`, `dependency`, `devDependency`, and `execute`. For file transforms (AST-based editing of scripts, Svelte components, CSS, JSON, etc.) and package manager helpers, see [`@sveltejs/sv-utils`](sv-utils).
 
+### Typed dynamic options
+
+If your add-on adds options dynamically in `setup` (e.g. from a fetch), you can pass a type parameter to `defineAddon` to get strong typing for those options:
+
+```ts
+import { defineAddon, defineAddonOptions } from 'sv';
+// ---cut---
+const addon = defineAddon<{ theme: string }>()({
+	id: 'my-addon',
+	options: defineAddonOptions().build(),
+	setup: ({ addOption }) => {
+		addOption('theme', {
+			question: 'Which theme?',
+			type: 'string',
+			default: 'dark'
+		});
+	},
+	run: ({ options }) => {
+		options.theme; // string
+	}
+});
+```
+
+The type parameter maps value types (`boolean`, `string`, `number`) to question definitions. Without it, `defineAddon` stays strict and only allows statically defined options.
+
 ## `defineAddonOptions`
 
 Builder for add-on options. Chained with `.add()` and finalized with `.build()`.

packages/migrate/CHANGELOG.md

@@ -1,5 +1,11 @@
 # svelte-migrate
 
+## 1.10.3
+### Patch Changes
+
+
+- fix: recognize the `nub` package manager ([#1187](https://github.com/sveltejs/cli/pull/1187))
+
 ## 1.10.2
 ### Patch Changes
 

packages/migrate/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "svelte-migrate",
-	"version": "1.10.2",
+	"version": "1.10.3",
 	"type": "module",
 	"description": "A CLI for migrating Svelte(Kit) codebases",
 	"license": "MIT",
@@ -31,7 +31,7 @@
 		"@clack/prompts": "1.5.0",
 		"import-meta-resolve": "^4.2.0",
 		"magic-string": "^0.30.21",
-		"package-manager-detector": "^1.6.0",
+		"package-manager-detector": "^1.8.0",
 		"picocolors": "^1.1.1",
 		"semver": "^7.8.1",
 		"tiny-glob": "^0.2.9",

packages/sv-utils/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @sveltejs/sv-utils
 
+## 0.3.3
+### Patch Changes
+
+
+- feat: add SvelteKit 3 helpers - `isKit3`, `resolveLibPrefix`, `libSubpathImports` ([#1199](https://github.com/sveltejs/cli/pull/1199))
+
+## 0.3.2
+### Patch Changes
+
+
+- fix: recognize the `nub` package manager ([#1187](https://github.com/sveltejs/cli/pull/1187))
+
 ## 0.3.1
 ### Patch Changes
 

packages/sv-utils/api-surface.md

@@ -854,6 +854,16 @@ type DefineEnv = {
 };
 
 declare function defineEnv({ sv, cwd, dependencyVersion }: DefineEnvContext): DefineEnv;
+
+declare function isKit3(kitRange: string | undefined): boolean;
+
+declare function resolveLibPrefix(kitRange: string | undefined): '#lib' | '$lib';
+
+declare function libSubpathImports(libDir: string): Record<string, string>;
+
+declare const KIT3_TSCONFIG = '$app/tsconfig';
+
+declare const KIT3_TSCONFIG_DEFAULT: Record<string, unknown>;
 type ColorInput = string | string[];
 declare const color: {
 	addon: (str: ColorInput) => string;
@@ -886,6 +896,8 @@ export {
 	COMMANDS,
 	type Comments,
 	type ConfigFileReader,
+	KIT3_TSCONFIG,
+	KIT3_TSCONFIG_DEFAULT,
 	type Package,
 	type SvelteAst,
 	type SvelteConfigKind,
@@ -905,16 +917,19 @@ export {
 	downloadJson,
 	fileExists,
 	index_d_exports$2 as html,
+	isKit3,
 	isVersionUnsupportedBelow,
 	index_d_exports$3 as js,
 	json_d_exports as json,
+	libSubpathImports,
 	loadFile,
 	loadPackageJson,
 	minVersion,
 	parse,
 	pnpm_d_exports as pnpm,
 	resolveCommand,
 	resolveCommandArray,
+	resolveLibPrefix,
 	sanitizeName,
 	saveFile,
 	splitVersion,

packages/sv-utils/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@sveltejs/sv-utils",
-	"version": "0.3.1",
+	"version": "0.3.3",
 	"type": "module",
 	"description": "Utility functions for sv",
 	"license": "MIT",
@@ -30,7 +30,7 @@
 		"decircular": "^1.0.0",
 		"dedent": "^1.7.2",
 		"esrap": "^2.2.11",
-		"package-manager-detector": "^1.6.0",
+		"package-manager-detector": "^1.8.0",
 		"semver": "^7.8.1",
 		"silver-fleece": "^1.2.1",
 		"smol-toml": "^1.6.1",

packages/sv-utils/src/env.ts

@@ -1,4 +1,5 @@
 import { fileExists } from './files.ts';
+import { isKit3 } from './kit3.ts';
 import { coerceVersion } from './semver.ts';
 import { svelteConfig, type ConfigFileReader, type SvFileApi } from './svelte-config.ts';
 import type { AstTypes } from './tooling/index.ts';
@@ -15,10 +16,8 @@ export function resolveEnvMode({
 	explicitEnvFlag: boolean;
 }): EnvMode {
 	if (!kitRange) return 'legacy';
-	if (kitRange === 'next') return 'declared';
-	const { major } = coerceVersion(kitRange);
-	if (major !== undefined && major >= 3) return 'declared';
-	if (major === 2 && explicitEnvFlag) return 'declared';
+	if (isKit3(kitRange)) return 'declared';
+	if (coerceVersion(kitRange).major === 2 && explicitEnvFlag) return 'declared';
 	return 'legacy';
 }
 
@@ -110,23 +109,23 @@ function getOrCreateVariablesObject(
  * just call `define`/`reference` and never deal with the legacy-vs-declared distinction themselves.
  */
 export function defineEnv({ sv, cwd, dependencyVersion }: DefineEnvContext): DefineEnv {
-	const mode = resolveEnvMode({
-		kitRange: dependencyVersion('@sveltejs/kit'),
-		explicitEnvFlag: readExplicitEnvFlag(cwd)
-	});
+	const kitRange = dependencyVersion('@sveltejs/kit');
+	const mode = resolveEnvMode({ kitRange, explicitEnvFlag: readExplicitEnvFlag(cwd) });
 	const language = fileExists(cwd, 'tsconfig.json') ? 'ts' : 'js';
-	return _bindEnv({ sv, mode, language });
+	return _bindEnv({ sv, mode, language, kit3: isKit3(kitRange) });
 }
 
 /** @internal The mode-resolved core, exported for filesystem-free tests. */
 export function _bindEnv({
 	sv,
 	mode,
-	language
+	language,
+	kit3 = false
 }: {
 	sv: SvFileApi;
 	mode: EnvMode;
 	language: 'ts' | 'js';
+	kit3?: boolean;
 }): DefineEnv {
 	const declared = new Map<string, EnvVarSpec>();
 
@@ -138,7 +137,10 @@ export function _bindEnv({
 			const envPath = `src/env.${language}`;
 			sv.file(envPath, (content) =>
 				transforms.script(({ ast, js }) => {
-					js.imports.addNamed(ast, { from: '@sveltejs/kit/hooks', imports: ['defineEnvVars'] });
+					js.imports.addNamed(ast, {
+						from: kit3 ? '@sveltejs/kit/env' : '@sveltejs/kit/hooks',
+						imports: ['defineEnvVars']
+					});
 					const variables = getOrCreateVariablesObject(ast, js);
 					const entry = js.object.property(variables, {
 						name: spec.name,

packages/sv-utils/src/index.ts

@@ -87,6 +87,15 @@ export {
 // Env access (abstracts over legacy `$env/dynamic/*` vs declared `$app/env/*` + `src/env.ts`)
 export { defineEnv } from './env.ts';
 
+// Kit 3 specifics (version detection, `$lib` -> `#lib`, the generated tsconfig)
+export {
+	KIT3_TSCONFIG,
+	KIT3_TSCONFIG_DEFAULT,
+	isKit3,
+	libSubpathImports,
+	resolveLibPrefix
+} from './kit3.ts';
+
 // Terminal styling
 export { color } from './color.ts';