docs: clarify why we have 2 APIs by sacrosanctic · Pull Request #1220 · sveltejs/cli

sacrosanctic · 2026-08-05T12:32:14Z

Closes #

Description

@GauBen Does this address your question in #1210?

Checklist

Update snapshots (if applicable)
Add a changeset (if applicable)
Allow maintainers to edit this PR
I care about what I'm doing, no matter the tool I use (Notepad, Sublime, VSCode, AI...)

* main * throw if pm isnt installed * throw * nit * changeset * tmv sv ordering * sh is unknwon on windows (execSync know about it) * hint to label & next step * caching agent install, keep none by default --------- Co-authored-by: jycouet <jycouet@gmail.com>

Bump package-manager-detector to ^1.8.0, the first release with nub in its agent and command tables. sv-utils bundles the library at build time, so the published bundle only knows about nub once rebuilt against >=1.8.0.

…eltejs#1192) When prettier is among the scaffolded add-ons, format the whole project rather than only the add-on-touched files, so a fresh project passes its own lint. Prettier's ignore rules still apply. Signed-off-by: Matt Van Horn <455140+mvanhorn@users.noreply.github.com> Co-authored-by: Matt Van Horn <455140+mvanhorn@users.noreply.github.com>

* feat: addOption in setup phase * fmt² * okay cut * humm * fmt * chore: update api surface * test: await async setupAddons in engine tests * Update packages/sv/src/core/config.ts Co-authored-by: Scott Wu <sw@scottwu.ca> * Update packages/sv/src/core/config.ts Co-authored-by: Scott Wu <sw@scottwu.ca> * feat: typesafe addOption keys via defineAddon setup generic - addOption now constrains key + question type from defineAddon<SetupValues>() - regenerate api surface --------- Co-authored-by: Scott Wu <sw@scottwu.ca>

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

* mv * feat: welcome `ai-tools` * abc * don't format skills * opencode -> plugin, claude question, subagents * fmt * cleanup snap * snap * update new path * feat(ai-tools): choose Svelte plugin or individual tools per client - delivery option: Svelte plugin (Claude via committed .claude/settings.json, opencode via opencode.json) or individual tools - granular MCP/skills/sub-agents selection; rename `setup` -> `mcpSetup` - consolidate per-client config into a single `CLIENTS` registry * feat(ai-tools): install skills for cursor, gemini and vscode * feat(ai-tools): CLAUDE.md imports AGENTS.md to keep a single source of truth * chore(ai-tools): rename RX_MD to REGEX_MD * feat(ai-tools): warn in next steps when plugin and loose skill/agent files coexist * fmt * fix(ai-tools): 'other' client now writes AGENTS.md * fix(ai-tools): only ask tool/MCP questions when a client can use them * Update packages/sv/src/create/shared/+skills/svelte-code-writer/SKILL.md Co-authored-by: Rich Harris <hello@rich-harris.dev> * Update documentation/docs/30-add-ons/01-ai-tools.md Co-authored-by: Rich Harris <hello@rich-harris.dev> * Update documentation/docs/30-add-ons/01-ai-tools.md Co-authored-by: Rich Harris <hello@rich-harris.dev> * Update documentation/docs/30-add-ons/01-ai-tools.md Co-authored-by: Rich Harris <hello@rich-harris.dev> * Update documentation/docs/30-add-ons/01-ai-tools.md Co-authored-by: Rich Harris <hello@rich-harris.dev> * Update packages/sv/src/addons/ai-tools.ts Co-authored-by: Rich Harris <hello@rich-harris.dev> * Update packages/sv/src/addons/ai-tools.ts Co-authored-by: Rich Harris <hello@rich-harris.dev> * Update packages/sv/src/create/shared/+skills/svelte-code-writer/SKILL.md Co-authored-by: Rich Harris <hello@rich-harris.dev> * Update packages/sv/src/create/shared/+skills/svelte-code-writer/SKILL.md Co-authored-by: Rich Harris <hello@rich-harris.dev> * Update packages/sv/src/create/shared/+skills/svelte-code-writer/SKILL.md Co-authored-by: Rich Harris <hello@rich-harris.dev> * Update packages/sv/src/create/shared/+skills/svelte-code-writer/SKILL.md Co-authored-by: Rich Harris <hello@rich-harris.dev> * Update packages/sv/src/addons/ai-tools.ts Co-authored-by: Rich Harris <hello@rich-harris.dev> * Update packages/sv/src/addons/ai-tools.ts Co-authored-by: Rich Harris <hello@rich-harris.dev> * Update packages/sv/src/create/shared/+agents/svelte-file-editor.md Co-authored-by: Rich Harris <hello@rich-harris.dev> * Update packages/sv/src/create/shared/+agents/svelte-file-editor.md Co-authored-by: Rich Harris <hello@rich-harris.dev> * Update packages/sv/src/create/shared/+agents/svelte-file-editor.md Co-authored-by: Rich Harris <hello@rich-harris.dev> * Update packages/sv/src/create/shared/+agents/svelte-file-editor.md Co-authored-by: Rich Harris <hello@rich-harris.dev> * Update packages/sv/src/create/shared/+agents/svelte-file-editor.md Co-authored-by: Rich Harris <hello@rich-harris.dev> * Update packages/sv/src/create/shared/+agents/svelte-file-editor.md Co-authored-by: Rich Harris <hello@rich-harris.dev> * Update packages/sv/src/create/shared/+agents/svelte-file-editor.md Co-authored-by: Rich Harris <hello@rich-harris.dev> * Update packages/sv/src/create/shared/+agents/svelte-file-editor.md Co-authored-by: Rich Harris <hello@rich-harris.dev> * update skills * fix: drop stale reference files and update ai-tools snapshots --------- Co-authored-by: Rich Harris <hello@rich-harris.dev>

…rrors (sveltejs#1198) * fix: drop obsolete pnpm allowBuilds entries and surface real format errors * test: install generated project outside the repo workspace

…t 3 shape (sveltejs#1199) * feat(sv-utils): add SvelteKit 3 helpers Version detection, the `$lib` -> `#lib` move and the generated `$app/tsconfig`, so add-ons stop hardcoding kit-version-specific shapes. * fix(core): make `runsAfter` actually order add-ons It sorted by number of constraints, so an add-on could still run before one it declared it runs after. Topologically sort instead, seeded with the previous order so unconstrained add-ons keep their relative position. * fix(experimental): create manages `#lib` and the rest of the SvelteKit 3 shape - skip `handleRenderingErrors`/`explicitEnvironmentVariables`, removed in kit 3 - extend `$app/tsconfig` and own `include`, keeping deliberate compiler option overrides - rewrite `$lib` to `#lib` and declare the subpath imports Vite resolves from - drizzle drops the removed `typescript.config` hook; `defineEnvVars` moves to `@sveltejs/kit/env` - better-auth and paraglide emit the right lib prefix and route type * test(cli): cover `kit@next` with a real install, build and check No snapshot: the point is that the project works, not what it looks like. * Update packages/sv/src/addons/drizzle.ts Co-authored-by: Scott Wu <sw@scottwu.ca> * Update packages/sv-utils/src/kit3.ts Co-authored-by: Scott Wu <sw@scottwu.ca> * test(cli): cover better-auth on `kit@next`, finish the `KIT3_TSCONFIG_DEFAULT` rename better-auth has the most `#lib` imports, so it gets its own `kit@next` install/build/check case. It can't join the existing one: kit treats any `remote.js` as a remote module, including the one `jose` ships, so `remoteFunctions` breaks the build. Also rewords the changeset and updates the two remaining `KIT3_TSCONFIG_INHERITED` references. * test(cli): pin the `kit@next` prereleases the experimental cases run against * test(cli): drop the better-auth `kit@next` case * chore: fix indentation * test(cli): let the generated project install a fresh prerelease * test(cli): track the `next` tag instead of a pinned prerelease * chore: trim the changesets to one line each * chore: changeset wording --------- Co-authored-by: Scott Wu <sw@scottwu.ca>

* remove `better-sqlite3` from `allowBuilds` * changeset * Update packages/sv/src/addons/drizzle.ts Co-authored-by: CokaKoala <31664583+AdrianGonz97@users.noreply.github.com> * changeset --------- Co-authored-by: CokaKoala <31664583+AdrianGonz97@users.noreply.github.com>

…sveltejs#1201)

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

* chore: document default values for `prepareServer` * Create tiny-zoos-add.md

pkg-svelte-dev · 2026-08-05T12:32:17Z

Install the latest version of sv from a1e9f11:

pnpm add https://pkg.svelte.dev/sv/c/a1e9f11efdaff301efeb8fbdc6f0d311ee69fd17

Open in pkg.svelte.dev: https://pkg.svelte.dev/repos/cli/pr/1220

Note

This PR is from a fork. A maintainer must approve approve each commit before it can be built and installed.

changeset-bot · 2026-08-05T12:32:21Z

⚠️ No Changeset found

Latest commit: a1e9f11

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

GauBen · 2026-08-05T13:00:43Z

+import { transforms } from '@sveltejs/sv-utils';
+```
+
+[**`@sveltejs/sv-utils`**](sv-utils) is a collection of side-effect free functions. It provides parsers, language tooling, and typed transforms.


This is no longer true, svelteConfig.edit will load files from the disk:

cli/packages/sv-utils/src/svelte-config.ts

Line 44 in 47721e2

typeof source === 'string' ? (path) => loadFile(source, path) : source;

@jycouet I think we should fix that.

svelteConfig.edit will load files from the disk

And this is not good?

You mean that we have to say that we have for IO helpers as well ? or that we should not read files in sv-utils?

I thought sv-utils are pure functions.

sacrosanctic and others added 14 commits July 23, 2026 15:46

fix: recognize the nub package manager (sveltejs#1187)

580c2f7

Bump package-manager-detector to ^1.8.0, the first release with nub in its agent and command tables. sv-utils bundles the library at build time, so the published bundle only knows about nub once rebuilt against >=1.8.0.

Version Packages (sveltejs#1191)

063258f

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

fix: drop obsolete pnpm allowBuilds entries and surface real format e…

9b3fa17

…rrors (sveltejs#1198) * fix: drop obsolete pnpm allowBuilds entries and surface real format errors * test: install generated project outside the repo workspace

fix(better-auth): use the auth CLI binary in the auth:schema script (…

1a67d26

…sveltejs#1201)

Version Packages (sveltejs#1200)

78f6b7a

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

chore: document default values for prepareServer (sveltejs#1211)

1254a68

* chore: document default values for `prepareServer` * Create tiny-zoos-add.md

chore: replace tar-fs with modern-tar (sveltejs#1209)

47721e2

docs

a1e9f11

GauBen reviewed Aug 5, 2026

View reviewed changes

manuel3108 changed the base branch from main to version-1 August 7, 2026 08:04

manuel3108 changed the base branch from version-1 to main August 7, 2026 08:04

manuel3108 changed the base branch from main to version-1 August 7, 2026 08:53

Navigation Menu

Uh oh!

Uh oh!

docs: clarify why we have 2 APIs - #1220

docs: clarify why we have 2 APIs#1220
sacrosanctic wants to merge 14 commits into
sveltejs:version-1from
sacrosanctic:api-sv-docs

sacrosanctic commented Aug 5, 2026 •

edited

Loading

Uh oh!

pkg-svelte-dev Bot commented Aug 5, 2026

Uh oh!

changeset-bot Bot commented Aug 5, 2026

Uh oh!

GauBen Aug 5, 2026

Uh oh!

sacrosanctic Aug 5, 2026

Uh oh!

jycouet Aug 6, 2026

Uh oh!

sacrosanctic Aug 9, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

Uh oh!

Uh oh!

Conversation

sacrosanctic commented Aug 5, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Description

Checklist

Uh oh!

pkg-svelte-dev Bot commented Aug 5, 2026

Uh oh!

changeset-bot Bot commented Aug 5, 2026

⚠️ No Changeset found

Uh oh!

GauBen Aug 5, 2026

Choose a reason for hiding this comment

Uh oh!

sacrosanctic Aug 5, 2026

Choose a reason for hiding this comment

Uh oh!

jycouet Aug 6, 2026

Choose a reason for hiding this comment

Uh oh!

sacrosanctic Aug 9, 2026

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

sacrosanctic commented Aug 5, 2026 •

edited

Loading