@deltabox/toolchain 1.11.4 → 2.1.0

package/CHANGELOG.md

@@ -1,18 +1,350 @@
 # Changelog
 
-## 1.11.4 (October 2026)
+## 2.1.0 (October 2026)
 
 <!-- release:start -->
 
+### New features
+#### Changelog
+- Configure breaking-change detection ([#f80634f](https://github.com/deltabox-studio/toolchain/commit/f80634f) by [T0chi](https://github.com/T0chi))
+  - Detect breaking changes by Conventional Commits rules by default (! in the subject or a BREAKING CHANGE: footer) and add a changelog.breaking / ci.changelog.breaking override (conventional, ny, alse, pattern/match, or a callback).
+
+<!-- release:end -->
+
+
+## 2.0.1 (October 2026)
+
+### Bug fixes
+#### Vscode
+- Always show builtin providers and templates ([#d67c2ad](https://github.com/deltabox-studio/toolchain/commit/d67c2ad) by [T0chi](https://github.com/T0chi))
+#### Changelog
+- Make release notes first-release safe ([#25e39ef](https://github.com/deltabox-studio/toolchain/commit/25e39ef) by [T0chi](https://github.com/T0chi))
+  - Extract release bodies through a tested CLI helper that only uses tag versions present in CHANGELOG.md, skips the current version, and falls back to the newest entry when there is no prior release.
+- Group breaking changes first ([#c30d212](https://github.com/deltabox-studio/toolchain/commit/c30d212) by [T0chi](https://github.com/T0chi))
+  - Detect subject and footer breaks, group them under the breaking section ahead of feat/fix, and keep the grouping with custom commit formatters and --format-only.
+### Documentation
+- Auto-generate sidebar and reorganize guides ([#3485f53](https://github.com/deltabox-studio/toolchain/commit/3485f53) by [T0chi](https://github.com/T0chi))
+- Document release-notes extraction ([#fcac0b8](https://github.com/deltabox-studio/toolchain/commit/fcac0b8) by [T0chi](https://github.com/T0chi))
+  - Document dbx changelog --release-notes, the last-released-version matching and the first-release fallback.
+- Document breaking changes group order ([#5aa2397](https://github.com/deltabox-studio/toolchain/commit/5aa2397) by [T0chi](https://github.com/T0chi))
+  - Note the default order (breaking, feat, fix) and that breaking grouping works with custom commit formatters.
+
+### Package changes
+#### Added
+- `vite-plugin-vitepress-auto-sidebar` `^1.7.1`
+
+## 2.0.0 (October 2026)
+
+### New features
+#### Changelog
+- Customize CC group order and titles ([#856842b](https://github.com/deltabox-studio/toolchain/commit/856842b) by [T0chi](https://github.com/T0chi))
+  - Support ordered arrays, title records, hidden groups and callbacks for the whole group config and per-group title/order/hidden values, including --format-only.
+- Add custom workflow paths, listing and non-Yarn support ([#2e96e6e](https://github.com/deltabox-studio/toolchain/commit/2e96e6e) by [T0chi](https://github.com/T0chi))
+- Add a New contributors footer ([#1e49596](https://github.com/deltabox-studio/toolchain/commit/1e49596) by [T0chi](https://github.com/T0chi))
+  - scanned range (explicit range start, or the oldest commit's parent).
+    login is known) and a nested list of their commit messages, reusing
+    the normal commit bullet formatting without the author/body.
+    only the CC rule/scope grouping is replaced by major/minor/patch.
+#### Config
+- Type changelog group callbacks ([#a5c6186](https://github.com/deltabox-studio/toolchain/commit/a5c6186) by [T0chi](https://github.com/T0chi))
+  - Add the shared ChangelogGroupsSetting types, expose groups on both changelog sections, and regenerate the config schema/types/reference.
+- Revamp config generators and extend tooling customization ([#b924255](https://github.com/deltabox-studio/toolchain/commit/b924255) by [T0chi](https://github.com/T0chi))
+  - and generateConfig* functions (optional disk writes, schema metadata)
+  - **BREAKING CHANGE:** ConfigScopes, ConfigScopeDef, CONFIG_SECTION_SCHEMAS,
+  - CONFIG_TYPE_SCHEMAS and CONFIG_SECTION_DESCRIPTIONS are removed. Consumers
+    should use ConfigSchema with generateConfigTypes/Env/Markdown/Cli/All and read
+    section descriptions from schema metadata.
+- Support metadata annotations in generated output ([#1417bb2](https://github.com/deltabox-studio/toolchain/commit/1417bb2) by [T0chi](https://github.com/T0chi))
+- Add fmt/lint sections and manual changelog config ([#16000e5](https://github.com/deltabox-studio/toolchain/commit/16000e5) by [T0chi](https://github.com/T0chi))
+- Inherit shared sections and add fmt/lint defaults ([#94add6f](https://github.com/deltabox-studio/toolchain/commit/94add6f) by [T0chi](https://github.com/T0chi))
+- Registry source policies and duplicate template-id prompts ([#e030af7](https://github.com/deltabox-studio/toolchain/commit/e030af7) by [T0chi](https://github.com/T0chi))
+  - host and path globs, enforced for local paths, npm registries and
+    remote URLs (also when loading global/remote registries and the
+    provider/registry listings).
+    builtin or project source; non-interactive runs fail with a clear
+    `--id` hint instead of prompting.
+    plus Templates/Providers docs.
+- Ambient Zod meta types and project-tsconfig typechecks ([#e73661b](https://github.com/deltabox-studio/toolchain/commit/e73661b) by [T0chi](https://github.com/T0chi))
+  - `/// <reference types="@deltabox/toolchain/globals" />` and get typed
+    `.meta({ env, path, required, example, ... })` fields.
+    `ConfigBaseMeta.deprecated` the JSON-Schema boolean.
+    instead of `tsconfig.build.json`.
+- Move CI workflows and changelog config under toolchain.ci ([#af1b536](https://github.com/deltabox-studio/toolchain/commit/af1b536) by [T0chi](https://github.com/T0chi))
+  - workflows and move the changelog pipeline to `ci.changelog`.
+    `ci.changelog.commitlint: false` and fall back to coarse
+    major/minor/patch changelog groups.
+    `ChangelogBranchesConfig` as a named schema.
+    consumers, but reject it in the loader with a migration error.
+    into the `config-schema/` folder.
+    per-workflow overrides are `WorkflowOptions`, and the new section type
+    is `ToolchainCiConfig`.
+    generated types.
+- Let defineConfig accept a promise or a callback ([#111776c](https://github.com/deltabox-studio/toolchain/commit/111776c) by [T0chi](https://github.com/T0chi))
+  - `defineConfig` now mirrors Vite's helper: the argument may be a plain object,
+    a `Promise<DbxConfig>`, or a `() => DbxConfig | Promise<DbxConfig>` callback.
+    The loader resolves the module export (awaits a promise, calls a callback and
+    awaits its result), so a config can do async work before returning
+    `{ toolchain }`.
+#### Vscode
+- Surface workflow conflicts in managed files ([#e692511](https://github.com/deltabox-studio/toolchain/commit/e692511) by [T0chi](https://github.com/T0chi))
+  - Read workflowConflicts from the manifest and render them as a warning group with the owning config key.
+- Watch the inputs resolved from the dbx config ([#953f071](https://github.com/deltabox-studio/toolchain/commit/953f071) by [T0chi](https://github.com/T0chi))
+  - watch globs: auto-sync now asks the CLI (`dbx watch --list --json`) per
+    workspace root and watches the returned globs relative to that root, so
+    custom `tsconfig.rootFile`/`defaultFile` names are respected
+    ignore stale results from an older resolve
+    older pinned `dbx`)
+    set value, in any scope, still replaces the resolved inputs
+    `tsconfig.default.json`
+    the behaviour
+- Add extension settings link to Home ([#f39cb35](https://github.com/deltabox-studio/toolchain/commit/f39cb35) by [T0chi](https://github.com/T0chi))
+- Add Select dbx version to the Home More actions ([#13ef688](https://github.com/deltabox-studio/toolchain/commit/13ef688) by [T0chi](https://github.com/T0chi))
+- Add the Registries view ([#e3e808e](https://github.com/deltabox-studio/toolchain/commit/e3e808e) by [T0chi](https://github.com/T0chi))
+  - A new collapsible **Registries** view (below Templates) shows **Providers** and
+    (explorer folder or browser for remote URLs), **Add new registry** (the category's
+    add flow) and **Remove registry** (removes the path, keeps the files). The title
+    bar has **New registry…** / **Remove registry…** (global or project scope), also
+    available in the Home "More actions". Removing a template now offers the stored
+    global templates too (`template:remove --global`).
+- Rename registry paths, add a version picker and UI polish ([#9c8b51c](https://github.com/deltabox-studio/toolchain/commit/9c8b51c) by [T0chi](https://github.com/T0chi))
+  - config and code).
+    "which dbx?" notification, only ask when they differ, and add a **Select dbx
+    version…** command that pins one in the workspace settings (npx fallback).
+    More actions), prefix More-actions buttons with a play glyph, start Managed
+    Files collapsed, expand the Vite+ provider by default, and drop unused icon
+    resources.
+- Sync the global registry with the VS Code settings ([#86a0671](https://github.com/deltabox-studio/toolchain/commit/86a0671) by [T0chi](https://github.com/T0chi))
+  - Add the `deltabox.templatesSearchPaths` setting, record the VS Code user dir in
+    the CLI config on activation, and mirror setting changes into it (so the CLI and
+    editor agree). Adding a template now asks whether to register it globally (yes
+    by default), and adding a provider asks for a project or global scope; the
+    Providers view reads the merged registry.
+#### Project
+- Inherit root Oxc config and harden scaffolds ([#56a1895](https://github.com/deltabox-studio/toolchain/commit/56a1895) by [T0chi](https://github.com/T0chi))
+  - Nested projects omit local Oxc files/opt-ins when the root owns them, template create gains --force, and scaffold writes now reject duplicates, BOM catalogs and root scope fallbacks are handled.
+- Make scaffolds runnable and safer ([#eab297b](https://github.com/deltabox-studio/toolchain/commit/eab297b) by [T0chi](https://github.com/T0chi))
+- Fold an existing vite config when generating a config ([#5891154](https://github.com/deltabox-studio/toolchain/issues/5891154) by [T0chi](https://github.com/T0chi))
+  - `project:config` now checks for a hand-written `vite.config.*` and folds its
+    literal props into the generated `dbx.config.ts`'s `toolchain.vite` (using the
+    vite migration's extract/scan/fold helpers), adding the `/vite.config.ts` fmt
+    ignore. A non-foldable config is reported and left alone. The VS Code "Generate
+    config" actions run `dbx sync` afterwards so the managed shim is written.
+#### Core
+- Resolve watched inputs from the config and add `dbx watch --list` ([#0ab08a9](https://github.com/deltabox-studio/toolchain/commit/0ab08a9) by [T0chi](https://github.com/T0chi))
+  - `watch` globs with function forms resolved (eg. custom
+    `tsconfig.rootFile`/`defaultFile` names); `runWatch` now uses it, so only the
+    inputs of tasks that actually run are watched
+    resolved tsconfig file names (`{ globs, tsconfig }`) without watching
+    a `tsconfig` section
+- Untracked managed files, config-derived task globs and a reset restore hook ([#5da6691](https://github.com/deltabox-studio/toolchain/commit/5da6691) by [T0chi](https://github.com/T0chi))
+  - it in the manifest, so a user-owned file a task patches is never pruned by a
+    later sync or removed by `dbx reset`
+    follow configured file names
+    (written before `files`/`origins`, which it can never clobber), and
+    `SyncContext.check` flags `dbx sync --check`
+    the manifest is removed and report the `restored` files
+- Provider registry search paths and safer managed-file sync ([#4033009](https://github.com/deltabox-studio/toolchain/issues/4033009) by [T0chi](https://github.com/T0chi))
+  - http(s) URLs), keeping the legacy provider files for compatibility.
+    providers`, `--set`, `--clear`), the CLI config and the VS Code
+    `deltabox.providerRegistrySearchPaths` setting; the Registries view
+    now manages both kinds and the Providers view can fetch remote
+    registries through `loadToolchainProviders()`.
+    pre-existing file. Adopted files are unmanaged, never deleted.
+    their previous content); the extension shows a notification listing
+    removed files with Restore/Close.
+- Merge global providers with the project registry ([#81c510b](https://github.com/deltabox-studio/toolchain/commit/81c510b) by [T0chi](https://github.com/T0chi))
+  - Providers can live in `~/.dbx/toolchain/.registry/providers.json` too.
+    `readAllProviders` merges them with the project's `.dbx/toolchain/providers.json`
+    (project wins on an id clash), and the CLI's provider list and passthrough
+    commands use it so a global provider works in every project.
+#### Tsconfig
+- Resolver, `extends`/`baseFile` options and snapshot-backed overrides ([#2b38963](https://github.com/deltabox-studio/toolchain/commit/2b38963) by [T0chi](https://github.com/T0chi))
+  - JSONC) and `dbx tsconfig --json/--alias/--paths/--references/--tsconfig/--root/--no-extends`;
+    the generator now resolves the workspaces tsconfig through it
+    templates, and `tsconfig.baseFile` for the root base tsconfig
+    into the user-owned tsconfigs on sync, honouring custom
+    `baseFile`/`rootFile`/`defaultFile`/`buildFile` names (also in the task's
+    watched/kept globs and in `dbx tsconfig`)
+    (repo-relative paths only) and record the applied override per file in
+    `tsconfigOverrides`; removing a key restores the snapshot value when the
+    original defined it, otherwise removes it (pruning emptied parents), and keeps
+    a value edited after the override applied it
+    `tsconfig.override-edited`) and skip instead of creating missing targets;
+    patched files are untracked, so sync/reset never delete them
+    (`restoreTsconfigOverrides`), warning with `tsconfig.restore-reapply` while
+    the overrides are still configured; `dbx reset` restores before removing the
+    manifest
+#### Vite
+- Add static shims and a configurable shim import ([#bddcb62](https://github.com/deltabox-studio/toolchain/commit/bddcb62) by [T0chi](https://github.com/T0chi))
+  - the generated `vite.config.ts`, so Vite+ can load it without a built
+    `@deltabox/toolchain` (rejects functions, regexps and class instances)
+    shims; relative values resolve from the repo root and are rewritten per
+    generated config
+- Preserve existing imports/comments when regenerating the shim ([#194461c](https://github.com/deltabox-studio/toolchain/commit/194461c) by [T0chi](https://github.com/T0chi))
+  - `renderViteConfig` now accepts the existing `vite.config.ts` source: it keeps
+    the file's leading comments and import statements and merges `defineConfig` (and
+    the config type) into the existing `vite`/`vite-plus` import, preserving default,
+    namespace, other named and type-only specifiers. Regeneration is idempotent, and
+    the sync task feeds the current file in so a custom import block/comment is not
+    dropped.
+- Detect the project's vite package and allow resolveVite overrides ([#dfaedee](https://github.com/deltabox-studio/toolchain/commit/dfaedee) by [T0chi](https://github.com/T0chi))
+  - The generated `vite.config.ts` shim now imports `defineConfig` (and its config
+    type) from whichever package the project installs — `vite` or `vite-plus` —
+    detected from `package.json` and walking up so a hoisted workspace dependency
+    resolves. `resolveVite` is generic so the shim type-checks against both, and
+    `ResolveViteOptions` now carries inline `vite` overrides that are deep-merged
+    over the loaded section.
+#### Migrate
+- Add Oxc migration and repeatable --from ([#0f6930d](https://github.com/deltabox-studio/toolchain/commit/0f6930d) by [T0chi](https://github.com/T0chi))
+#### Cli
+- Add config selection and logger suppression ([#9b69e3f](https://github.com/deltabox-studio/toolchain/commit/9b69e3f) by [T0chi](https://github.com/T0chi))
+#### Template
+- Re-prompt on duplicate ids in init and the editor ([#a4d7cde](https://github.com/deltabox-studio/toolchain/commit/a4d7cde) by [T0chi](https://github.com/T0chi))
+  - one (or fails with an `--id` hint when non-interactive), and accepts
+    `--id`.
+    the provider already exists, updating its command names too.
+- Unscoped npm packages, custom registries and remote sources ([#08cb68c](https://github.com/deltabox-studio/toolchain/commit/08cb68c) by [T0chi](https://github.com/T0chi))
+  - npm create packages. The registry defaults to the project package
+    manager's (`npmRegistryServer` / `.npmrc`) and can be overridden per
+    source with `--registry` or the new `ToolchainTemplateSource.registry`.
+    whose `{ sources }` / `{ templates }` / array is merged recursively.
+    docs.
+- Add project registries, registry listing and global removal ([#ff3cd16](https://github.com/deltabox-studio/toolchain/commit/ff3cd16) by [T0chi](https://github.com/T0chi))
+  - to `<project>/.dbx/toolchain/.registry/templates`; the project paths are
+    resolved before the global ones (remote `http(s)` entries are kept as URLs).
+    `dbx registry` command lists them (`--json`) and adds/removes template paths
+    (`--add`/`--remove`, `--scope global|project`).
+    remove stored global templates; remote registries accept `{ sources }`,
+    `{ templates }` or an array of sources.
+- Add a global template registry ([#638dd3b](https://github.com/deltabox-studio/toolchain/commit/638dd3b) by [T0chi](https://github.com/T0chi))
+  - Templates registered with `template:init --add`/`template:add` are also stored
+    under `~/.dbx/toolchain/.registry/templates` (unless `--no-global`), so they are
+    available in every project and the VS Code extension. Global templates merge
+    with the project's own (project wins on an id clash).
+  - Search paths default to that directory and can be configured as a string/array
+    of directories or `http(s)` remote registries. They live in
+    `~/.dbx/toolchain/cli/config.json` (`templatesSearchPaths`, plus a `vscodeDir`
+    pointing at the VS Code user dir) and are managed with the new
+    `dbx template:registry` command (`--add`/`--set`/`--remove`/`--clear`), which
+    also writes the VS Code `deltabox.templatesSearchPaths` setting.
+### Bug fixes
+#### Cli
+- Filter denied providers at registration ([#74c49bb](https://github.com/deltabox-studio/toolchain/commit/74c49bb) by [T0chi](https://github.com/T0chi))
+  - Load the registry policy before registering provider commands, and make config-flag extraction work for argv without a node/script prefix.
+- Preserve provider flags and emit clean machine output ([#8f6c404](https://github.com/deltabox-studio/toolchain/commit/8f6c404) by [T0chi](https://github.com/T0chi))
+#### Config
+- Support boolean formatter and linter opt-ins ([#d99384b](https://github.com/deltabox-studio/toolchain/commit/d99384b) by [T0chi](https://github.com/T0chi))
+  - Allow true/false for every fmt/lint tool, honour explicit biome opt-outs, and ignore disabled biome overrides.
+- Honour disabled sections and regenerate config types ([#dddd9a7](https://github.com/deltabox-studio/toolchain/commit/dddd9a7) by [T0chi](https://github.com/T0chi))
+- Keep union, enum and nested types in the combined markdown reference ([#2eaa373](https://github.com/deltabox-studio/toolchain/commit/2eaa373) by [T0chi](https://github.com/T0chi))
+  - The combined (`combined: true`) markdown renderer received the untyped
+    lowering of Zod scopes, which collapses unions/enums to `any` with a `{}`
+    default. Render Zod scopes from `toJSONSchema` instead (resolving the root
+    `$ref` into `$defs`), so the reference shows real types and nested options
+    again.
+- Finish generator ergonomics and changelog customization ([#38f6d5b](https://github.com/deltabox-studio/toolchain/commit/38f6d5b) by [T0chi](https://github.com/T0chi))
+#### Changelog
+- Honour workflow token overrides and disabled ci ([#de266dd](https://github.com/deltabox-studio/toolchain/commit/de266dd) by [T0chi](https://github.com/T0chi))
+  - Use the overridden package manager's version, honour legacy yarnVersion, and ignore workflow paths when ci is disabled.
+#### Core
+- Reload edited code configs in watch ([#10ba473](https://github.com/deltabox-studio/toolchain/commit/10ba473) by [T0chi](https://github.com/T0chi))
+  - Cache-bust the ESM/CJS config import when watch reloads, and add loader + live watch coverage.
+- Protect adopted files, keep check read-only and reload watch config ([#c6fe500](https://github.com/deltabox-studio/toolchain/commit/c6fe500) by [T0chi](https://github.com/T0chi))
+#### Vscode
+- List custom workflows and read BOM-prefixed manifests ([#2f62b47](https://github.com/deltabox-studio/toolchain/commit/2f62b47) by [T0chi](https://github.com/T0chi))
+- Use the default provider registry path and clarify template docs ([#017cfe6](https://github.com/deltabox-studio/toolchain/commit/017cfe6) by [T0chi](https://github.com/T0chi))
+#### Tsconfig
+- Make sync generation quiet, one-pass and non-fatal ([#f0d7663](https://github.com/deltabox-studio/toolchain/commit/f0d7663) by [T0chi](https://github.com/T0chi))
+#### Ci
+- Keep the build tsconfigs for CI typechecks ([#b1502ad](https://github.com/deltabox-studio/toolchain/commit/b1502ad) by [T0chi](https://github.com/T0chi))
+  - the generated CI workflow.
+    root + package `tsconfig.json` (including tests).
+#### Migrate
+- Deep-merge the folded vite config ([#f74d2ed](https://github.com/deltabox-studio/toolchain/commit/f74d2ed) by [T0chi](https://github.com/T0chi))
+  - Folding a hand-written `vite.config.*` into an existing `toolchain.vite` now
+    deep-merges object literals (nested objects combine; arrays/scalars from the
+    vite config win) instead of replacing the section, and flips a previous
+    `config: false` to `true` since the hand-written file is removed.
+  - Also fixes `findTopLevelValue` so a scalar last key no longer swallows the
+    object's closing `}`, updates the managed-shim detection for the generic
+    `resolveVite<T>(...)` form, and corrects the "nothing to migrate" message when
+    the migration is registered but no source is detected.
+### Refactors
+- Run quality checks through vp tasks ([#2fee264](https://github.com/deltabox-studio/toolchain/commit/2fee264) by [T0chi](https://github.com/T0chi))
+- Run build and test through vp tasks too ([#e890665](https://github.com/deltabox-studio/toolchain/commit/e890665) by [T0chi](https://github.com/T0chi))
+- Run typechecks through vp tasks (dev vs CI tsconfigs) ([#7b3420b](https://github.com/deltabox-studio/toolchain/commit/7b3420b) by [T0chi](https://github.com/T0chi))
+### Documentation
+- Document changelog group customization ([#5443ea0](https://github.com/deltabox-studio/toolchain/commit/5443ea0) by [T0chi](https://github.com/T0chi))
+  - Cover ordered groups, custom titles, hidden groups and callback examples for manual and CI changelog config.
+- Document nested Oxc inheritance and workflow token versions ([#4f43cd9](https://github.com/deltabox-studio/toolchain/commit/4f43cd9) by [T0chi](https://github.com/T0chi))
+  - Cover scaffold --force, root Oxc inheritance, boolean tool opt-ins, workflow package-manager version defaults and the managed-file conflict group.
+- Regenerate config artifacts and document the fixes ([#9be4d73](https://github.com/deltabox-studio/toolchain/commit/9be4d73) by [T0chi](https://github.com/T0chi))
+- Document tsconfig overrides, snapshots and `--restore` ([#dad4084](https://github.com/deltabox-studio/toolchain/commit/dad4084) by [T0chi](https://github.com/T0chi))
+  - snapshots, removal rules, restoring, warnings) and the new CLI flags/exports
+    the sync task API additions and an upgrade step
+    the package reference
+    `llms-full.txt`
+- Document v2 generators, custom logger and changelog customization ([#f0f7f5d](https://github.com/deltabox-studio/toolchain/commit/f0f7f5d) by [T0chi](https://github.com/T0chi))
+- Update README highlights and regenerate LLM docs ([#6380770](https://github.com/deltabox-studio/toolchain/issues/6380770) by [T0chi](https://github.com/T0chi))
+- Add the CI guide, TypeScript page and interactive CLI sections ([#fc6099a](https://github.com/deltabox-studio/toolchain/commit/fc6099a) by [T0chi](https://github.com/T0chi))
+  - `guide/ci/` section (overview + settings + ci/issues/changelog/sync/
+    releases) and retitle the overview to "CI".
+    metadata, programmatic API, Vite+ generics).
+    VS Code sync notification and CLI `sync --json` docs.
+- Split the config, API, config-generator and changelog guides ([#4153d86](https://github.com/deltabox-studio/toolchain/commit/4153d86) by [T0chi](https://github.com/T0chi))
+  - `guide/changelog.md` into folders with an index + one sibling page per
+    second-level section.
+    commitlint, Versioning, CLI, writing messages, Troubleshooting and
+    Releases into sibling pages.
+    workflows, the commitlint opt-out fallback and the migration from the
+    deprecated top-level `changelog` section.
+    LLM bundles.
+- Document the Registries view, project registries and dbx version picker ([#752d1cd](https://github.com/deltabox-studio/toolchain/commit/752d1cd) by [T0chi](https://github.com/T0chi))
+  - Cover `registrySearchPaths`, project registries, the `registry` command, remote
+    registries, the Registries view/actions, and the extension's version selection.
+- Document the global template/provider registry ([#55651e1](https://github.com/deltabox-studio/toolchain/commit/55651e1) by [T0chi](https://github.com/T0chi))
+  - Cover the global templates dir, `--no-global`, the `template:registry` command,
+    the CLI config and `deltabox.templatesSearchPaths` sync, remote registries, and
+    global providers.
+- Document defineConfig callbacks, shim detection and deep-merge migration ([#701de7c](https://github.com/deltabox-studio/toolchain/commit/701de7c) by [T0chi](https://github.com/T0chi))
+  - Cover `defineConfig` promises/callbacks, the shim importing from the project's
+    vite package, inline `resolveVite` overrides, and the vite migration deep-merging
+    into `toolchain.vite`.
+#### Vscode
+- Document extension requirements ([#07fd6fa](https://github.com/deltabox-studio/toolchain/commit/07fd6fa) by [T0chi](https://github.com/T0chi))
+#### Config
+- Generate CLI, env and config-type references ([#ba640a3](https://github.com/deltabox-studio/toolchain/commit/ba640a3) by [T0chi](https://github.com/T0chi))
+  - `config:docs`) to generate `apps/docs/config/index.md`, `cli.md` from
+    the ToolchainCommand descriptors, and `env.md` from ConfigMeta.
+### Tests
+- Run the emulate suite in a temp sandbox outside the repo ([#a94fa4c](https://github.com/deltabox-studio/toolchain/commit/a94fa4c) by [T0chi](https://github.com/T0chi))
+  - `node_modules` link back to the repo install) instead of `tests/emulate`,
+    so a stray sync can never touch the toolchain repo
+    every test, and clean up on `SIGHUP`/`SIGBREAK` too
+    sandboxes
+- Cover provider search paths, registry policy and remote sources ([#91a5859](https://github.com/deltabox-studio/toolchain/commit/91a5859) by [T0chi](https://github.com/T0chi))
+### Build system
+- Run typechecks, tests and Vite+ from source without a built `dist` ([#4353a36](https://github.com/deltabox-studio/toolchain/commit/4353a36) by [T0chi](https://github.com/T0chi))
+  - `tsconfig.workspaces.json` and regenerate every workspace `tsconfig.json`,
+    so typechecks resolve workspace source instead of `dist`
+    building the package first
+    the source tsconfigs
+### Chores
+- Fix lint warnings and remove unused helper ([#ac890d8](https://github.com/deltabox-studio/toolchain/commit/ac890d8) by [T0chi](https://github.com/T0chi))
+- Add lint and check vp tasks to every workspace ([#83bb7e5](https://github.com/deltabox-studio/toolchain/commit/83bb7e5) by [T0chi](https://github.com/T0chi))
+
+### Package changes
+#### Added
+- `jsonc-parser` `^3.3.1`
+
+## 1.11.4 (October 2026)
+
 ### Documentation
 - Updated misleading docs ([#5a5e44c](https://github.com/deltabox-studio/toolchain/commit/5a5e44c) by [T0chi](https://github.com/T0chi))
 ### Chores
 #### Vscode
 - Rearranged views order ([#0620097](https://github.com/deltabox-studio/toolchain/issues/0620097) by [T0chi](https://github.com/T0chi))
 
-<!-- release:end -->
-
-
 ## 1.11.3 (October 2026)
 
 ### Bug fixes

package/README.md

@@ -10,11 +10,11 @@
 
 All-in-one development toolchain that let's you scaffold projects, generate and manage configs, tsconfigs, custom templates, syncing, changelogs, CI, Vite+, migrations, and more.
 
-- Save and use templates (local/remote) so you never have to scaffold the same projects over and over again.
-- Generate config types, env variables, cli flags, markdown and JSON schemas, so your codebase stays consistent, validated and well-documented.
-- Simply extend or setup CI for your changelogs, releases, issues etc.
-- Sync your entire project so workspaces, docs and CI are always up-to-date.
-- Plug it into Vite / Vite+ and streamline your DX for your existing Vite setup.
+- **Save and use templates (local/remote)** so you never have to scaffold the same projects over and over again.
+- **Generate** config types, env variables, cli flags, markdown and JSON schemas, so your codebase stays consistent, validated and well-documented.
+- **Extend or setup** CI for your changelogs, releases, issues etc.
+- **Sync** your entire project so workspaces, docs and CI are always up-to-date.
+- **Plug it into Vite / Vite+** and streamline your DX for your existing Vite setup.
 
 See the [list of features](#features).
 
@@ -238,24 +238,31 @@ See [packages/vscode/README.md](./packages/vscode/README.md) to learn more about
 
 ## Development
 
-This repo is a Yarn 4 workspace; Vite+ (`vp`) drives format, lint, test and the
-task runner from the root `vite.config.ts`.
+This repo is a Yarn 4 workspace. Vite+ (`vp`) drives format, lint, test and the
+task runner from the root `vite.config.ts`. The generated shims are dogfooded
+with `vite.shim: 'static'`, so `vp` loads them without a built package; Vite and
+Vitest resolve workspace imports through `resolve.tsconfigPaths`.
 
 ```sh
 yarn install        # fresh checkout
-yarn build          # packages via `vp run` + root tsdown
-yarn test           # package + root tests
+yarn dev            # run the CLI from src/ via tsx
 yarn typecheck      # packages + root
-yarn check          # Oxfmt + Oxlint (format + lint)
+yarn check          # Oxfmt + Oxlint check (no writes)
+yarn check:fix      # same, auto-fixing every workspace + the root
 yarn format         # `vp fmt`
 yarn lint           # `vp lint --fix`
+yarn build          # packages via `vp run` + root tsdown
+yarn test           # builds, then package + root tests
+yarn test:clean     # remove leftover emulation temp workspaces
 ```
 
-> `vp` resolves only at the repo root, so run these from the root. Package
-> typechecks/tests resolve workspace deps from their built `dist`, so run a full
-> `yarn build` after changing a package's public exports.
+> `vp` resolves only at the repo root, so run these from the root. A full
+> `yarn build` is only needed for the published `dist`/VSIX: typechecks,
+> `vp run`/`fmt`/`lint`/`test`, `yarn dev` and Vitest run from source. The
+> emulate suite spawns the built `dist/cli/index.js` and therefore needs a
+> build.
 
-Docs live in `apps/docs` (VitePress): `yarn workspace @deltabox/toolchain-docs build`.
+Docs live in `apps/docs` (VitePress): `yarn docs build`.
 
 ## Docs
 

package/dist/_virtual/_rolldown/runtime.js

@@ -1 +1 @@
-import"node:path";import"node:url";import.meta.url;var e=Object.defineProperty,t=(t,n)=>{let r={};for(var i in t)e(r,i,{get:t[i],enumerable:!0});return n||e(r,Symbol.toStringTag,{value:`Module`}),r};export{t as __exportAll};
+import"node:path";import"node:url";import.meta.url;import"node:module";var e=Object.defineProperty,t=(t,n)=>{let r={};for(var i in t)e(r,i,{get:t[i],enumerable:!0});return n||e(r,Symbol.toStringTag,{value:`Module`}),r};export{t as __exportAll};

package/dist/changelog.d.ts

@@ -1,19 +1,23 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
-import { AuthorInfo, BumpType, CliOptions, CommitRecord, ExistingEntry, GroupedItem, GroupedRule, IssueInfo, ParsedCommit, ProcessingMethod } from "./packages/changelog/src/utils/types.js";
+import { ChangelogBreakingCommit, ChangelogBreakingSetting } from "./packages/shared/src/changelog-breaking.js";
+import { ChangelogGroupConfig, ChangelogGroupContext, ChangelogGroupEntry, ChangelogGroupHidden, ChangelogGroupItem, ChangelogGroupOrder, ChangelogGroupTitle, ChangelogGroupsContext, ChangelogGroupsSetting } from "./packages/shared/src/changelog-groups.js";
+import { AuthorInfo, BumpType, ChangelogProvider, ChangelogProviderContext, CliOptions, CommitFormatContext, CommitFormatOptions, CommitRecord, ExistingEntry, GroupedItem, GroupedRule, IssueInfo, ParsedCommit, ProcessingMethod } from "./packages/changelog/src/utils/types.js";
 import { parseArgsCli } from "./packages/changelog/src/utils/args.js";
+import { isBreakingCommit } from "./packages/changelog/src/utils/breaking.js";
 import { formatBody, groupItems, parseCcSubject, renderGroups, ruleTitle, splitInlineDescription } from "./packages/changelog/src/utils/format.js";
 import { deriveBump, readCommits } from "./packages/changelog/src/utils/git.js";
 import { parseExistingChangelog, reformatChangelogContent } from "./packages/changelog/src/utils/reformat.js";
 import { buildSummary, renderCommitRef } from "./packages/changelog/src/utils/summary.js";
 import { renderChangelogEntry } from "./packages/changelog/src/utils/version.js";
 import { main, runChangelog } from "./packages/changelog/src/run.js";
-import { DEFAULT_WORKFLOW_TOKENS, RenderWorkflowOptions, WORKFLOW_FILENAMES, Workflow, WorkflowId, WorkflowJob, applyWorkflowConfig, defaultWorkflows, isEnabled, renderWorkflow, renderWorkflows } from "./packages/changelog/src/workflows.js";
-import { RanWorkflow, RunWorkflowsOptions, RunWorkflowsResult, resolveWorkflowId, runWorkflows } from "./packages/changelog/src/run-workflows.js";
-import { COMMITLINT_HEADER, COMMIT_MSG_HOOK, HOOK_HEADER, WORKFLOW_HEADER, changelogSyncTask, commitMsgHook, workflowFilenames } from "./packages/changelog/src/sync.js";
+import { DEFAULT_WORKFLOW_DIR, DEFAULT_WORKFLOW_TOKENS, DefaultWorkflowOptions, RenderWorkflowOptions, WORKFLOW_FILENAMES, Workflow, WorkflowId, WorkflowJob, applyWorkflowConfig, defaultWorkflows, isEnabled, renderCustomWorkflow, renderWorkflow, renderWorkflows, workflowFilePath } from "./packages/changelog/src/workflows.js";
+import { RanWorkflow, RunWorkflowsOptions, RunWorkflowsResult, WorkflowTarget, resolveWorkflowId, resolveWorkflowTarget, runWorkflows, workflowTargets } from "./packages/changelog/src/run-workflows.js";
+import { COMMITLINT_HEADER, COMMIT_MSG_HOOK, HOOK_HEADER, WORKFLOW_HEADER, changelogSyncTask, commitMsgHook, workflowFilePaths, workflowFilenames } from "./packages/changelog/src/sync.js";
 import { CommitlintOptions, conventionalCommitsVscodeExtensions, conventionalCommitsVscodeSettings, renderCommitlintConfig } from "./packages/changelog/src/templates.js";
 import { ProjectGraphNode, readProjectGraph, relatedWorkspacePaths } from "./packages/changelog/src/utils/graph.js";
-import { PlanVersionsOptions, ResolvedVersioning, VersionPackages, VersionPlan, VersioningTarget, discoverVersionPackages, planVersions, readPackageVersion, resolveVersioning, writePackageVersion } from "./packages/changelog/src/utils/versioning.js";
+import { buildReleaseNotes, normalizeReleaseVersion, releaseNotesFromGit } from "./packages/changelog/src/utils/release-notes.js";
+import { BumpRuleContext, PlanVersionsOptions, ResolvedVersioning, VersionPackages, VersionPlan, VersioningTarget, deriveCustomBump, discoverVersionPackages, planVersions, readPackageVersion, resolveVersioning, writePackageVersion } from "./packages/changelog/src/utils/versioning.js";
 import "./packages/changelog/src/index.js";
 import { changelogCommands } from "./packages/changelog/src/cli/index.js";
-export { AuthorInfo, BumpType, COMMITLINT_HEADER, COMMIT_MSG_HOOK, CliOptions, CommitRecord, CommitlintOptions, DEFAULT_WORKFLOW_TOKENS, ExistingEntry, GroupedItem, GroupedRule, HOOK_HEADER, IssueInfo, ParsedCommit, PlanVersionsOptions, ProcessingMethod, type ProjectGraphNode, RanWorkflow, RenderWorkflowOptions, ResolvedVersioning, RunWorkflowsOptions, RunWorkflowsResult, VersionPackages, VersionPlan, VersioningTarget, WORKFLOW_FILENAMES, WORKFLOW_HEADER, Workflow, WorkflowId, WorkflowJob, applyWorkflowConfig, buildSummary, changelogCommands, changelogSyncTask, commitMsgHook, conventionalCommitsVscodeExtensions, conventionalCommitsVscodeSettings, defaultWorkflows, deriveBump, discoverVersionPackages, formatBody, groupItems, isEnabled, main, parseArgsCli, parseCcSubject, parseExistingChangelog, planVersions, readCommits, readPackageVersion, readProjectGraph, reformatChangelogContent, relatedWorkspacePaths, renderChangelogEntry, renderCommitRef, renderCommitlintConfig, renderGroups, renderWorkflow, renderWorkflows, resolveVersioning, resolveWorkflowId, ruleTitle, runChangelog, runWorkflows, splitInlineDescription, workflowFilenames, writePackageVersion };
+export { AuthorInfo, BumpRuleContext, BumpType, COMMITLINT_HEADER, COMMIT_MSG_HOOK, type ChangelogBreakingCommit, type ChangelogBreakingSetting, type ChangelogGroupConfig, type ChangelogGroupContext, type ChangelogGroupEntry, type ChangelogGroupHidden, type ChangelogGroupItem, type ChangelogGroupOrder, type ChangelogGroupTitle, type ChangelogGroupsContext, type ChangelogGroupsSetting, ChangelogProvider, ChangelogProviderContext, CliOptions, CommitFormatContext, CommitFormatOptions, CommitRecord, CommitlintOptions, DEFAULT_WORKFLOW_DIR, DEFAULT_WORKFLOW_TOKENS, DefaultWorkflowOptions, ExistingEntry, GroupedItem, GroupedRule, HOOK_HEADER, IssueInfo, ParsedCommit, PlanVersionsOptions, ProcessingMethod, type ProjectGraphNode, RanWorkflow, RenderWorkflowOptions, ResolvedVersioning, RunWorkflowsOptions, RunWorkflowsResult, VersionPackages, VersionPlan, VersioningTarget, WORKFLOW_FILENAMES, WORKFLOW_HEADER, Workflow, WorkflowId, WorkflowJob, WorkflowTarget, applyWorkflowConfig, buildReleaseNotes, buildSummary, changelogCommands, changelogSyncTask, commitMsgHook, conventionalCommitsVscodeExtensions, conventionalCommitsVscodeSettings, defaultWorkflows, deriveBump, deriveCustomBump, discoverVersionPackages, formatBody, groupItems, isBreakingCommit, isEnabled, main, normalizeReleaseVersion, parseArgsCli, parseCcSubject, parseExistingChangelog, planVersions, readCommits, readPackageVersion, readProjectGraph, reformatChangelogContent, relatedWorkspacePaths, releaseNotesFromGit, renderChangelogEntry, renderCommitRef, renderCommitlintConfig, renderCustomWorkflow, renderGroups, renderWorkflow, renderWorkflows, resolveVersioning, resolveWorkflowId, resolveWorkflowTarget, ruleTitle, runChangelog, runWorkflows, splitInlineDescription, workflowFilePath, workflowFilePaths, workflowFilenames, workflowTargets, writePackageVersion };

package/dist/changelog.js

@@ -1 +1 @@
-import"node:path";import"node:url";import.meta.url;import{parseArgsCli as e}from"./packages/changelog/src/utils/args.js";import{deriveBump as t,readCommits as n}from"./packages/changelog/src/utils/git.js";import{formatBody as r,groupItems as i,parseCcSubject as a,renderGroups as o,ruleTitle as s,splitInlineDescription as c}from"./packages/changelog/src/utils/format.js";import{renderChangelogEntry as l}from"./packages/changelog/src/utils/version.js";import{parseExistingChangelog as u,reformatChangelogContent as d}from"./packages/changelog/src/utils/reformat.js";import{buildSummary as f,renderCommitRef as p}from"./packages/changelog/src/utils/summary.js";import{readProjectGraph as m,relatedWorkspacePaths as h}from"./packages/changelog/src/utils/graph.js";import{discoverVersionPackages as g,planVersions as _,readPackageVersion as v,resolveVersioning as y,writePackageVersion as b}from"./packages/changelog/src/utils/versioning.js";import{main as x,runChangelog as S}from"./packages/changelog/src/run.js";import{DEFAULT_WORKFLOW_TOKENS as C,WORKFLOW_FILENAMES as w,applyWorkflowConfig as T,defaultWorkflows as E,isEnabled as D,renderWorkflow as O,renderWorkflows as k}from"./packages/changelog/src/workflows.js";import{resolveWorkflowId as A,runWorkflows as j}from"./packages/changelog/src/run-workflows.js";import{conventionalCommitsVscodeExtensions as M,conventionalCommitsVscodeSettings as N,renderCommitlintConfig as P}from"./packages/changelog/src/templates.js";import{COMMITLINT_HEADER as F,COMMIT_MSG_HOOK as I,HOOK_HEADER as L,WORKFLOW_HEADER as R,changelogSyncTask as z,commitMsgHook as B,workflowFilenames as V}from"./packages/changelog/src/sync.js";import"./packages/changelog/src/index.js";import{changelogCommands as H}from"./packages/changelog/src/cli/index.js";export{F as COMMITLINT_HEADER,I as COMMIT_MSG_HOOK,C as DEFAULT_WORKFLOW_TOKENS,L as HOOK_HEADER,w as WORKFLOW_FILENAMES,R as WORKFLOW_HEADER,T as applyWorkflowConfig,f as buildSummary,H as changelogCommands,z as changelogSyncTask,B as commitMsgHook,M as conventionalCommitsVscodeExtensions,N as conventionalCommitsVscodeSettings,E as defaultWorkflows,t as deriveBump,g as discoverVersionPackages,r as formatBody,i as groupItems,D as isEnabled,x as main,e as parseArgsCli,a as parseCcSubject,u as parseExistingChangelog,_ as planVersions,n as readCommits,v as readPackageVersion,m as readProjectGraph,d as reformatChangelogContent,h as relatedWorkspacePaths,l as renderChangelogEntry,p as renderCommitRef,P as renderCommitlintConfig,o as renderGroups,O as renderWorkflow,k as renderWorkflows,y as resolveVersioning,A as resolveWorkflowId,s as ruleTitle,S as runChangelog,j as runWorkflows,c as splitInlineDescription,V as workflowFilenames,b as writePackageVersion};
+import"node:path";import"node:url";import.meta.url;import{parseArgsCli as e}from"./packages/changelog/src/utils/args.js";import{isBreakingCommit as t}from"./packages/changelog/src/utils/breaking.js";import{deriveBump as n,readCommits as r}from"./packages/changelog/src/utils/git.js";import{formatBody as i,groupItems as a,parseCcSubject as o,renderGroups as s,ruleTitle as c,splitInlineDescription as l}from"./packages/changelog/src/utils/format.js";import{renderChangelogEntry as u}from"./packages/changelog/src/utils/version.js";import{parseExistingChangelog as d,reformatChangelogContent as f}from"./packages/changelog/src/utils/reformat.js";import{buildReleaseNotes as p,normalizeReleaseVersion as m,releaseNotesFromGit as h}from"./packages/changelog/src/utils/release-notes.js";import{buildSummary as g,renderCommitRef as _}from"./packages/changelog/src/utils/summary.js";import{readProjectGraph as v,relatedWorkspacePaths as y}from"./packages/changelog/src/utils/graph.js";import{deriveCustomBump as b,discoverVersionPackages as x,planVersions as S,readPackageVersion as C,resolveVersioning as w,writePackageVersion as T}from"./packages/changelog/src/utils/versioning.js";import{main as E,runChangelog as D}from"./packages/changelog/src/run.js";import{DEFAULT_WORKFLOW_DIR as O,DEFAULT_WORKFLOW_TOKENS as k,WORKFLOW_FILENAMES as A,applyWorkflowConfig as j,defaultWorkflows as M,isEnabled as N,renderCustomWorkflow as P,renderWorkflow as F,renderWorkflows as I,workflowFilePath as L}from"./packages/changelog/src/workflows.js";import{resolveWorkflowId as R,resolveWorkflowTarget as z,runWorkflows as B,workflowTargets as V}from"./packages/changelog/src/run-workflows.js";import{conventionalCommitsVscodeExtensions as H,conventionalCommitsVscodeSettings as U,renderCommitlintConfig as W}from"./packages/changelog/src/templates.js";import{COMMITLINT_HEADER as G,COMMIT_MSG_HOOK as K,HOOK_HEADER as q,WORKFLOW_HEADER as J,changelogSyncTask as Y,commitMsgHook as X,workflowFilePaths as Z,workflowFilenames as Q}from"./packages/changelog/src/sync.js";import"./packages/changelog/src/index.js";import{changelogCommands as $}from"./packages/changelog/src/cli/index.js";export{G as COMMITLINT_HEADER,K as COMMIT_MSG_HOOK,O as DEFAULT_WORKFLOW_DIR,k as DEFAULT_WORKFLOW_TOKENS,q as HOOK_HEADER,A as WORKFLOW_FILENAMES,J as WORKFLOW_HEADER,j as applyWorkflowConfig,p as buildReleaseNotes,g as buildSummary,$ as changelogCommands,Y as changelogSyncTask,X as commitMsgHook,H as conventionalCommitsVscodeExtensions,U as conventionalCommitsVscodeSettings,M as defaultWorkflows,n as deriveBump,b as deriveCustomBump,x as discoverVersionPackages,i as formatBody,a as groupItems,t as isBreakingCommit,N as isEnabled,E as main,m as normalizeReleaseVersion,e as parseArgsCli,o as parseCcSubject,d as parseExistingChangelog,S as planVersions,r as readCommits,C as readPackageVersion,v as readProjectGraph,f as reformatChangelogContent,y as relatedWorkspacePaths,h as releaseNotesFromGit,u as renderChangelogEntry,_ as renderCommitRef,W as renderCommitlintConfig,P as renderCustomWorkflow,s as renderGroups,F as renderWorkflow,I as renderWorkflows,w as resolveVersioning,R as resolveWorkflowId,z as resolveWorkflowTarget,c as ruleTitle,D as runChangelog,B as runWorkflows,l as splitInlineDescription,L as workflowFilePath,Z as workflowFilePaths,Q as workflowFilenames,V as workflowTargets,T as writePackageVersion};

package/dist/cli/commands/index.js

@@ -1 +1 @@
-import"node:path";import"node:url";import.meta.url;import{projectsCommand as e}from"./projects.js";import{providerCommands as t}from"./providers.js";import{resetCommand as n}from"./reset.js";import{baseOptions as r,watchOptions as i}from"./shared.js";import{syncCommand as a}from"./sync.js";import{watchCommand as o}from"./watch.js";function s(){return[e(),a(),o(),n(),...t()]}export{r as baseOptions,s as syncCommands,i as watchOptions};
+import"node:path";import"node:url";import.meta.url;import{projectsCommand as e}from"./projects.js";import{providerCommands as t}from"./providers.js";import{resetCommand as n}from"./reset.js";import{baseOptions as r,watchOptions as i}from"./shared.js";import{syncCommand as a}from"./sync.js";import{watchCommand as o}from"./watch.js";function s(r){return[e(),a(),o(),n(),...t(r)]}export{r as baseOptions,s as syncCommands,i as watchOptions};

package/dist/cli/commands/providers.js

@@ -1 +1 @@
-import"node:path";import"node:url";import.meta.url;import{logger as e}from"../../packages/shared/src/logger.js";import{spawnCross as t}from"../../packages/shared/src/run.js";import"../../packages/shared/src/index.js";import{readProviderRegistry as n}from"../../packages/core/src/provider-registry.js";import"../../packages/core/src/index.js";import{toolchainProviders as r}from"../../providers.js";const i={flags:`--cwd <dir>`,description:`Project root (default: cwd).`};function a(n,r){return{name:r.name,description:`${n.name}: ${r.description}`,passthrough:!0,options:[i],run:async(i,a)=>{let o=i.args??[],s=i.cwd??a.cwd;if(!n.binary){e.error(`provider "${n.id}" has no binary to run.`),process.exitCode=1;return}let c=await new Promise(e=>{let i=t(n.binary,[r.subcommand,...o],{cwd:s,env:process.env,stdio:`inherit`});i.on(`error`,()=>e(1)),i.on(`exit`,t=>e(t??0))});c!==0&&(process.exitCode=c)}}}function o(e=process.cwd()){return n(e).flatMap(e=>e.commands.map(t=>a(e,t)))}function s(){return[{name:`providers`,description:`List the tooling providers (Vite+, ...) and their commands.`,options:[{flags:`--json`,description:`Print the providers (with actions) as JSON.`}],run:t=>{let n=r();if(t.json)e.raw(JSON.stringify(n,null,4));else for(let t of n){let n=t.binary?` (${t.binary})`:``;e.info(`${t.name}${n} [${t.id}]`),t.description&&e.info(`  ${t.description}`);for(let n of t.commands)e.info(`  ${n.name.padEnd(20)} ${n.description}`)}}},...o()]}export{s as providerCommands,o as providerPassthroughCommands};
+import"node:path";import"node:url";import.meta.url;import{logger as e}from"../../packages/shared/src/logger.js";import{spawnCross as t}from"../../packages/shared/src/run.js";import"../../packages/shared/src/index.js";import{readAllProvidersSync as n}from"../../packages/core/src/provider-registry.js";import"../../packages/core/src/index.js";import{loadToolchainProviders as r,providerPolicy as i}from"../../providers.js";const a={flags:`--cwd <dir>`,description:`Project root (default: cwd).`};function o(r,o){return{name:o.name,description:`${r.name}: ${o.description}`,passthrough:!0,options:[a],run:async(a,s)=>{let c=a.args??[],l=a.cwd??s.cwd,u=i(s.config);if(u&&!n(l,u).some(e=>e.id===r.id)){e.error(`provider "${r.id}" is not allowed by toolchain.registry.providers.`),process.exitCode=1;return}if(!r.binary){e.error(`provider "${r.id}" has no binary to run.`),process.exitCode=1;return}let d=await new Promise(e=>{let n=t(r.binary,[o.subcommand,...c],{cwd:l,env:process.env,stdio:`inherit`});n.on(`error`,()=>e(1)),n.on(`exit`,t=>e(t??0))});d!==0&&(process.exitCode=d)}}}function s(e=process.cwd(),t){return n(e,i(t)).flatMap(e=>e.commands.map(t=>o(e,t)))}function c(t){return[{name:`providers`,description:`List the tooling providers (Vite+, ...) and their commands.`,options:[{flags:`--json`,description:`Print the providers (with actions) as JSON.`}],run:async(t,n)=>{let i=await r(process.cwd(),n.config);if(t.json)e.raw(JSON.stringify(i,null,4));else for(let t of i){let n=t.binary?` (${t.binary})`:``;e.info(`${t.name}${n} [${t.id}]`),t.description&&e.info(`  ${t.description}`);for(let n of t.commands)e.info(`  ${n.name.padEnd(20)} ${n.description}`)}}},...s(process.cwd(),t)]}export{c as providerCommands,s as providerPassthroughCommands};

package/dist/cli/commands/reset.js

@@ -1 +1 @@
-import"node:path";import"node:url";import.meta.url;import{logger as e}from"../../packages/shared/src/logger.js";import"../../packages/shared/src/index.js";import{resetProjects as t}from"../../packages/core/src/reset.js";import"../../packages/core/src/index.js";function n(){return{name:`reset`,description:`Remove generated files, the .dbx/toolchain manifest and/or the dbx config from a project.`,options:[{flags:`--cwd <dir>`,description:`Project root (default: cwd).`},{flags:`--recursive`,description:`Reset every discovered project under the root.`},{flags:`--include <pattern...>`,description:`Only projects matching these patterns (glob or substring).`},{flags:`--exclude <pattern...>`,description:`Skip projects matching these patterns (glob or substring).`},{flags:`--generated`,description:`Remove only the generated/managed files.`},{flags:`--manifest`,description:`Remove only the .dbx/toolchain directory.`},{flags:`--config`,description:`Also remove dbx.config.*.`},{flags:`--all`,description:`Remove generated files, the manifest and the config.`},{flags:`--dry-run`,description:`Report what would be removed without deleting.`},{flags:`--json`,description:`Print the result as JSON.`}],run:(n,r)=>{let i=n.cwd??r.cwd,a=n.all?{generated:!0,manifest:!0,config:!0}:{...n.generated?{generated:!0}:{},...n.manifest?{manifest:!0}:{},...n.config?{config:!0}:{}},o=t({root:i,recursive:!!n.recursive,dryRun:!!n.dryRun,...a,...n.include?{include:n.include}:{},...n.exclude?{exclude:n.exclude}:{}});if(n.json){e.raw(JSON.stringify(o,null,4));return}let s=o.dryRun?`would remove`:`removed`,c=0;for(let t of o.results)if(t.removed.length!==0){c+=t.removed.length,e.info(`${t.rel===`.`?i:t.rel}`);for(let n of t.removed)e.info(`  - ${n}`)}e.info(`${s} ${c} item(s) across ${o.results.length} project(s).`)}}}export{n as resetCommand};
+import"node:path";import"node:url";import.meta.url;import{logger as e}from"../../packages/shared/src/logger.js";import"../../packages/shared/src/index.js";import{resetProjects as t}from"../../packages/core/src/reset.js";import"../../packages/core/src/index.js";import{restoreTsconfigOverrides as n}from"../../packages/tsconfig/src/snapshots.js";import"../../packages/tsconfig/src/index.js";function r(){return{name:`reset`,description:`Remove generated files, the .dbx/toolchain manifest and/or the dbx config from a project.`,options:[{flags:`--cwd <dir>`,description:`Project root (default: cwd).`},{flags:`--recursive`,description:`Reset every discovered project under the root.`},{flags:`--include <pattern...>`,description:`Only projects matching these patterns (glob or substring).`},{flags:`--exclude <pattern...>`,description:`Skip projects matching these patterns (glob or substring).`},{flags:`--generated`,description:`Remove only the generated/managed files.`},{flags:`--manifest`,description:`Remove only the .dbx/toolchain directory.`},{flags:`--config`,description:`Also remove dbx.config.*.`},{flags:`--all`,description:`Remove generated files, the manifest and the config.`},{flags:`--dry-run`,description:`Report what would be removed without deleting.`},{flags:`--json`,description:`Print the result as JSON.`}],run:(r,i)=>{let a=r.cwd??i.cwd,o=r.all?{generated:!0,manifest:!0,config:!0}:{...r.generated?{generated:!0}:{},...r.manifest?{manifest:!0}:{},...r.config?{config:!0}:{}},s=t({root:a,recursive:!!r.recursive,dryRun:!!r.dryRun,restore:(t,{dryRun:r})=>n({cwd:t,dryRun:r,warn:(t,n)=>e.warn(t,n)}).restored,...o,...r.include?{include:r.include}:{},...r.exclude?{exclude:r.exclude}:{}});if(r.json){e.raw(JSON.stringify(s,null,4));return}let c=s.dryRun?`would remove`:`removed`,l=0;for(let t of s.results)if(t.removed.length!==0||t.restored.length!==0){l+=t.removed.length,e.info(`${t.rel===`.`?a:t.rel}`);for(let n of t.restored)e.info(`  ~ ${n} (overrides reverted)`);for(let n of t.removed)e.info(`  - ${n}`)}e.info(`${c} ${l} item(s) across ${s.results.length} project(s).`)}}}export{r as resetCommand};

package/dist/cli/commands/shared.js

@@ -1 +1 @@
-import"node:path";import"node:url";import.meta.url;import{sectionConfig as e}from"../../packages/shared/src/toolchain.js";import"../../packages/shared/src/index.js";import{defaultSyncTasks as t}from"../../sync.js";const n=[{flags:`--cwd <dir>`,description:`Project root (default: cwd).`},{flags:`-q, --quiet`,description:`Only log errors.`}];function r(n){let r=e(n.config.watch);return{tasks:t(),cwd:n.cwd,projectType:n.projectType,config:n.config,tokens:n.tokens,...n.configPath?{configPath:n.configPath}:{},...r?.debounce===void 0?{}:{debounce:r.debounce},...r?.exclude===void 0?{}:{exclude:r.exclude},...r?.gitignore===void 0?{}:{gitignore:r.gitignore}}}export{n as baseOptions,r as watchOptions};
+import"node:path";import"node:url";import.meta.url;import{sectionConfig as e}from"../../packages/shared/src/toolchain.js";import"../../packages/shared/src/index.js";import{defaultSyncTasks as t}from"../../sync.js";const n=[{flags:`--cwd <dir>`,description:`Project root (default: cwd).`},{flags:`-q, --quiet`,description:`Only log errors.`}];function r(n){let r=e(n.config.watch);return{tasks:t(),cwd:n.cwd,projectType:n.projectType,config:n.config,...n.ownConfig?{ownConfig:n.ownConfig}:{},tokens:n.tokens,...n.configPath?{configPath:n.configPath}:{},...r?.debounce===void 0?{}:{debounce:r.debounce},...r?.exclude===void 0?{}:{exclude:r.exclude},...r?.gitignore===void 0?{}:{gitignore:r.gitignore}}}export{n as baseOptions,r as watchOptions};

package/dist/cli/commands/sync.js

@@ -1 +1 @@
-import{default as e}from"node:path";import"node:url";import.meta.url;import{logger as t}from"../../packages/shared/src/logger.js";import"../../packages/shared/src/index.js";import{loadToolchainConfig as n}from"../../packages/core/src/loader.js";import{buildProjectGraph as r,writeProjectGraph as i}from"../../packages/core/src/graph.js";import{runSync as a}from"../../packages/core/src/sync.js";import{runWatch as o}from"../../packages/core/src/watch.js";import"../../packages/core/src/index.js";import{defaultSyncTasks as s}from"../../sync.js";import{baseOptions as c,watchOptions as l}from"./shared.js";function u(){return{name:`sync`,description:`Regenerate every managed file from dbx.config.*.`,options:[...c,{flags:`--check`,description:`Do not write; fail if files are out of date.`},{flags:`--watch`,description:`Keep running and re-sync on change.`},{flags:`--recursive`,description:`Sync every discovered dbx project in dependency order.`},{flags:`--force`,description:`Run even when no dbx.config.* is present.`}],run:async(c,u)=>{let d=!!c.quiet,f=!!c.check;if(u.configError){t.error(u.configError),process.exitCode=1;return}if(c.recursive){let o=r(u.cwd);f||i(u.cwd,o);for(let r of o.order){let i=e.resolve(u.cwd,r),o=await n(i,{tolerant:!0});if(o.error){t.error(o.error),process.exitCode=1;continue}let c=await a({tasks:s(),cwd:i,projectType:o.projectType,config:o.config,tokens:o.tokens,check:f,quiet:d});f&&!c.upToDate&&(process.exitCode=1)}return}if(!u.configPath&&!c.force){t.warn(`no dbx.config.* found here; nothing to sync (use --force to run anyway).`);return}if(c.watch){await o({...l(u),quiet:d});return}let p=await a({...l(u),check:f,quiet:d});if(f&&!p.upToDate&&(process.exitCode=1),!f)try{i(u.cwd,r(u.cwd))}catch{}}}}export{u as syncCommand};
+import{default as e}from"node:path";import"node:url";import.meta.url;import{logger as t}from"../../packages/shared/src/logger.js";import"../../packages/shared/src/index.js";import{loadToolchainConfig as n}from"../../packages/core/src/loader.js";import{buildProjectGraph as r,writeProjectGraph as i}from"../../packages/core/src/graph.js";import{runSync as a}from"../../packages/core/src/sync.js";import{runWatch as o}from"../../packages/core/src/watch.js";import"../../packages/core/src/index.js";import{defaultSyncTasks as s}from"../../sync.js";import{getConfigSelection as c}from"../config-selection.js";import{baseOptions as l,watchOptions as u}from"./shared.js";function d(){return{name:`sync`,description:`Regenerate every managed file from dbx.config.*.`,options:[...l,{flags:`--check`,description:`Do not write; fail if files are out of date.`},{flags:`--watch`,description:`Keep running and re-sync on change.`},{flags:`--recursive`,description:`Sync every discovered dbx project in dependency order.`},{flags:`--force`,description:`Run even when no dbx.config.* is present.`},{flags:`--json`,description:`Print the sync result (including removed files) as JSON.`}],run:async(l,d)=>{let f=!!l.json,p=!!l.quiet||f,m=!!l.check;if(d.configError){t.error(d.configError),process.exitCode=1;return}if(l.recursive){let o=r(d.cwd);m||i(d.cwd,o);let l=[],u=c();for(let r of o.order){let i=e.resolve(d.cwd,r),o=await n(i,{tolerant:!0,...u});if(o.error){t.error(o.error),process.exitCode=1;continue}let c=await a({tasks:s(),cwd:i,projectType:o.projectType,config:o.config,ownConfig:o.ownConfig,tokens:o.tokens,check:m,quiet:p});l.push({dir:r,result:c}),m&&!c.upToDate&&(process.exitCode=1)}f&&t.raw(JSON.stringify({results:l},null,4));return}if(!d.configPath&&!l.force&&!d.noConfig){t.warn(`no dbx.config.* found here; nothing to sync (use --force to run anyway).`);return}if(l.watch){await o({...u(d),quiet:p});return}let h=await a({...u(d),check:m,quiet:p});if(m&&!h.upToDate&&(process.exitCode=1),!m)try{i(d.cwd,r(d.cwd))}catch{}f&&t.raw(JSON.stringify(h,null,4))}}}export{d as syncCommand};

package/dist/cli/commands/watch.js

@@ -1 +1 @@
-import"node:path";import"node:url";import.meta.url;import{logger as e}from"../../packages/shared/src/logger.js";import{sectionConfig as t}from"../../packages/shared/src/toolchain.js";import"../../packages/shared/src/index.js";import{runWatch as n}from"../../packages/core/src/watch.js";import"../../packages/core/src/index.js";import{baseOptions as r,watchOptions as i}from"./shared.js";function a(){return{name:`watch`,description:`Sync once, then watch key files and re-sync on change.`,options:[...r,{flags:`--force`,description:`Run even when no dbx.config.* is present.`}],run:async(r,a)=>{!a.configPath&&!r.force?e.warn(`no dbx.config.* found here; nothing to watch (use --force to run anyway).`):t(a.config.watch)?.enabled===!1?e.warn(`watch is disabled in the config.`):await n({...i(a),quiet:!!r.quiet})}}}export{a as watchCommand};
+import"node:path";import"node:url";import.meta.url;import{logger as e}from"../../packages/shared/src/logger.js";import{sectionConfig as t}from"../../packages/shared/src/toolchain.js";import"../../packages/shared/src/index.js";import{resolveWatchGlobs as n,runWatch as r}from"../../packages/core/src/watch.js";import"../../packages/core/src/index.js";import{tsconfigFileNames as i}from"../../packages/tsconfig/src/sync.js";import"../../packages/tsconfig/src/index.js";import{defaultSyncTasks as a}from"../../sync.js";import{baseOptions as o,watchOptions as s}from"./shared.js";function c(){return{name:`watch`,description:`Sync once, then watch key files and re-sync on change.`,options:[...o,{flags:`--force`,description:`Run even when no dbx.config.* is present.`},{flags:`--list`,description:`Print the resolved input globs (+ tsconfig file names) instead of watching.`},{flags:`--json`,description:`With --list: print the inputs as JSON.`}],run:async(o,c)=>{if(o.list){let t={globs:[`**/dbx.config.*`,...n(a(),c.config,c.projectType)],tsconfig:i(c.config)};if(o.json)e.raw(JSON.stringify(t,null,4));else for(let n of t.globs)e.info(n)}else!c.configPath&&!o.force&&!c.noConfig?e.warn(`no dbx.config.* found here; nothing to watch (use --force to run anyway).`):c.config.watch===!1||t(c.config.watch)?.enabled===!1?e.warn(`watch is disabled in the config.`):await r({...s(c),quiet:!!o.quiet})}}}export{c as watchCommand};

package/dist/cli/config-selection.d.ts

@@ -0,0 +1,23 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+//#region src/cli/config-selection.d.ts
+/** How the CLI selected the config for this run (`--config` / `--no-config`). */
+export interface ConfigSelection {
+  /** An explicit config file (CLI-only). */
+  config?: string;
+  /** Do not load any discovered config; use CLI flags/env only. */
+  noConfig?: boolean;
+}
+/**
+ * Pull `--no-config` / `--config <file>` out of `argv` so they work before or
+ * after a subcommand. Everything after `--` is left untouched.
+ *
+ * A provider passthrough (`vite`, `vite:*`, or a custom provider command)
+ * receives its operands verbatim, so config flags after that command are left
+ * alone (`dbx vite build --config vite.custom.ts` must reach `vp`).
+ */
+export declare function extractConfigSelection(argv: string[], isPassthrough?: (name: string) => boolean): {
+  argv: string[];
+  selection: ConfigSelection;
+};
+//#endregion

package/dist/cli/config-selection.js

@@ -0,0 +1 @@
+import"node:path";import"node:url";import.meta.url;let e={};function t(t){e={...t}}function n(){return e}function r(e){return/(?:^|[\\/])(?:node|node\.exe|bun|bun\.exe|deno|deno\.exe)$/i.test(e[0]??``)?2:0}function i(e,t){let n={},i=[],a=r(e),o,s=!1;for(let r=0;r<e.length;r++){let c=e[r];if(c===`--`){i.push(...e.slice(r));break}if(r>=a&&o===void 0&&!c.startsWith(`-`)&&(o=c,s=t?.(c)===!0),o!==void 0&&s)i.push(c);else if(c===`--no-config`)n.noConfig=!0;else if(c===`--config`){let t=e[++r];t!==void 0&&(n.config=t)}else c.startsWith(`--config=`)?n.config=c.slice(9):i.push(c)}return{argv:i,selection:n}}export{i as extractConfigSelection,n as getConfigSelection,t as setConfigSelection};

package/dist/cli/context.js

@@ -1 +1 @@
-import"node:path";import"node:url";import.meta.url;import{loadToolchainConfig as e}from"../packages/core/src/loader.js";import"../packages/core/src/index.js";const t=/* @__PURE__ */ new Map;function n(n){let r=t.get(n);return r||(r=e(n,{tolerant:!0}),t.set(n,r)),r}export{n as loadContext};
+import"node:path";import"node:url";import.meta.url;import{loadToolchainConfig as e}from"../packages/core/src/loader.js";import"../packages/core/src/index.js";import{getConfigSelection as t}from"./config-selection.js";const n=/* @__PURE__ */ new Map;function r(r){let i=t(),a=`${r}\0${i.config??``}\0${i.noConfig?`1`:`0`}`,o=n.get(a);return o||(o=e(r,{tolerant:!0,...i}),n.set(a,o)),o}export{r as loadContext};