Package reference

@deltabox/toolchain/shared

The base layer: the config model, logging, process/string/object utilities and the template engine.

Export	Description
defineConfig(config)	Identity helper for a typed dbx.config.* (object, promise, or sync/async callback).
sectionEnabled(section) / sectionConfig(section)	Opt-in-by-presence helpers for a config section.
resolveTokens(config)	Flatten a config into replacements.
CONFIG_FILE_NAMES	The config file names the loader probes, in priority order.
repoSlugFromUrl(url)	Derive an owner/name slug from a repository URL.
findOwnCliEntry(cwd?) / localToolchainVersion(cwd?) / TOOLCHAIN_PACKAGE	Locate a project's own toolchain bin + pinned version (prefer them over a global dbx).
createLogger(options) / logger	The shared logger (see Logging).
WARNING_MAP / ERROR_MAP / warningMessage(id, values?)	Central messages keyed by stable logger/suppression ids.
spawnCross(cmd, args, options) / run(cmd, args, options)	Cross-platform, shell-free spawning; timeoutMs kills the child tree.
killProcessTree(child)	Kill a child process and its descendants (Windows taskkill /t).
readJsonFile / readJsonAt / toJson / writeJsonFile	Small JSON file helpers.
mergeJsonAt(cwd, relative, patch)	Deep-merge a patch over an existing JSON file.
deepMerge / applyOverrides / isPlainObject / sort / mapValues	Object utilities (including layered typed overrides).
applyReplacements / applyReplacementsDeep / createReplacer	The template engine (also tokenPattern, extractTokens).
DEFAULT_IGNORE_PATTERNS / DEFAULT_FMT_IGNORE_PATTERNS / DEFAULT_LINT_IGNORE_PATTERNS	The shared build/cache ignores and the Oxfmt/Oxlint extensions.
resolveIgnorePatterns(cwd?, options?) / collectGitignorePatterns(cwd?)	Defaults + exclude + .gitignore resolution, and the matching helpers (isIgnoredPath).
toYaml(value)	A tiny YAML emitter for the GitHub Actions subset.

The config types and schemas also live here: ToolchainConfig, DbxConfig, SyncTask, SyncContext, ManagedFile, ToolchainCommand, ToolchainOption, ToolchainProvider, ToolchainViteConfig (Vite+'s config type), Replacements, and the generated config-types / config-schema exports.

import { defineConfig, sectionEnabled, applyReplacements } from '@deltabox/toolchain/shared';

const text = applyReplacements('Hello {{name:world}}', { name: 'acme' });

@deltabox/toolchain/core

Loads dbx.config.*, builds the project graph and runs the sync tasks.

Export	Description
loadToolchainConfig(cwd?)	Find + load the config, resolve tokens and the project type.
findConfigFile(cwd?)	The config file path, if any.
runSync(options)	Run the given SyncTask[] (or only a named subset) and return the summary.
runWatch(options)	Sync once, then watch inputs and re-sync (honours only).
selectSyncTasks(tasks, only)	Select tasks by name; throws on unknown names.
buildProjectGraph(root, options?)	Discover workspace packages and their dependencies.
orderProjects(nodes) / detectPackageManager(root)	Dependency ordering and package-manager detection.
writeProjectGraph / readProjectGraph	Persist/read .dbx/toolchain/projects.json.
selectProjects(options)	Select projects by kind/name/glob.
resetToolchain(options) / resetProjects(options)	Remove generated files, the manifest and/or the config (restore hook runs first).
vscodeSyncTask(options?)	The VS Code settings/extensions sync task.
resolveProjectType(cwd, config?) / detectProjectType(cwd)	The project kind (monorepo-root / monorepo-workspace / project).
readManifest(cwd) / writeManifest(cwd, files)	The .dbx/toolchain/manifest.json helpers.
resolveFmtCustomGroups(input?)	Build the sortImports workspace group from every dbx project (graph-based).

import { defaultSyncTasks, runSync, selectSyncTasks } from '@deltabox/toolchain';

await runSync({
    tasks: defaultSyncTasks(),
    only: ['tsconfig'],
    cwd,
    config,
    tokens,
});

// Or select explicitly:
const tasks = selectSyncTasks(defaultSyncTasks(), ['tsconfig']);

only implies prune: false, so a task subset never deletes files owned by the tasks it skipped. Unknown task names throw.

@deltabox/toolchain/config

The generic Zod/env engine (see the Config Generator guide for the full workflow).

Export	Description
createConfigEngine(options)	Bind scopes + prefix + root into a reusable engine.
configCommands({ engine, defaults? })	The config:* commands for a consumer's own CLI.
formatGenerated(source, options?)	Format generated output with Oxfmt (see below).
GENERATED_FORMAT_OPTIONS	The baseline Oxfmt options used by the generators.
parseEnvTree(env, prefix?) / envString / envInt / envBool / envList / envMap	The dependency-free runtime loader.
compileZodSchema(schema)	Compile a Zod schema for fast repeated parsing.
envPathOf(env, prefix?) / metaOf(schema)	Env-name to dotted-path derivation and .meta() reading.
findProjectRoot(start?) / monorepoRoot(from?)	Walk up to the nearest package.json.
generateConfigTypes / generateConfigEnv	Type/env generators (optional disk writes).
generateConfigMarkdown / generateConfigCli	Markdown/CLI generators (optional disk writes).
generateCliDocs(commands, options?)	A CLI reference from ToolchainCommand descriptors.
generateConfigJsonSchema / generateJsonSchemaFile	JSON Schema generation.
normalizeJsonSchemaMetadata(node)	Normalize Zod JSON Schema metadata for editor schemas.
generateEnv / generateEnvDts / generateConfigEnv	.env / env type generation.
generateCliOptions / flagOf / cliFlagOf / createCliArgsParser	CLI option generation + parsing.

@deltabox/toolchain/vite

The Vite+ provider: resolving/running vp, the dbx() plugin and the vite sync task (see the Providers guide).

Export	Description
resolveVp(cwd?) / hasVp(cwd?) / runVp(args, options?)	Resolve and run the vp binary (local shim, global, then npx).
vpVersion(cwd?) / describeVp(cwd?) / which(bin)	Version, resolution description and PATH lookup.
VP_COMMANDS / viteCommandName(name) / resolveVpCommand(name)	The vp command catalog + name/alias resolution.
viteProvider() / viteCommands()	The provider descriptor and the dbx vite:* commands.
dbx(options?) / DBX_TASKS / dbxTaskCommand(sub)	The Vite/Vite+ plugin and the resolved run.tasks to spread in.
resolveDbx(cwd?) / runDbx(args, cwd?)	Resolve/run the dbx binary (the project's own first; a pinned project never runs a global dbx).
resolveVite(options?)	Resolve toolchain.vite (or a passed toolchain), with inline vite overrides.
detectViteSpecifier(cwd)	Which package (vite / vite-plus) the project has, for the shim import.
renderViteConfig(specifier?) / viteConfigObject(config?)	The managed vite.config.ts shim (per specifier) + the section minus config.
viteSyncTask()	The vite sync task that writes the shim.
resolveFmtCustomGroups(input?)	Re-exported from core: the sortImports workspace group resolver.

@deltabox/toolchain/cli

Export	Description
registerToolchainCommands(program, commands)	Wire framework-agnostic commands onto a commander program.
builtinCommands()	The commands built into the root CLI (config commands need an engine).
createCli()	Build the dbx commander program.
runCli(argv?)	Parse and run the CLI (extracts logger flags, defaults bare Vite+).
withDefaultVite(argv, commandNames?)	Insert vite before a bare Vite+ command.
extractLogOptions(argv)	Pull --log-level / --color / --no-color out of argv.

See the CLI guide for the routing behaviour.

@deltabox/toolchain/migrate

Export	Description
migrations() / listMigrations(cwd) / detectMigrations(cwd)	The registered migrations and detection.
findMigration(idOrFrom) / runMigration(...) / runDetectedMigrations(ctx)	Run one or every detected migration.
biomeToOx / eslintToOx / prettierToOx / dprintToOx / viteToToolchain	The built-in ToolchainMigration objects.
mapBiomeToOxfmt / mapBiomeToOxlint / mapPrettierToOxfmt / mapDprintToOxfmt	Source-to-Oxc mapping helpers.
extractViteObject(source) / scanLiteralObject(text) / foldViteIntoConfig(...)	The vite source's extraction + splice helpers.
diffFiles(files) / hasPending(diffs)	Diff planned files against disk (for --check).
mergeViteConfig(source, ...) / writeViteTarget(...)	The Vite+ (--target vite) output helpers.

@deltabox/toolchain/template

Export	Description
loadTemplates(options) / collectSources(options)	Resolve builtin/local/online sources into templates.
scaffoldTemplate(template, options)	Copy a template into a target directory, resolving tokens.
addTemplateSource(cwd, source) / removeTemplateSource(cwd, key)	Manage .dbx/toolchain/templates.json.
readTemplateRegistry / writeTemplateRegistry	Read/write the template source registry.
BUILTIN_TEMPLATES / loadLocalTemplates(root, idPrefix?)	The offline templates.
readTemplateDir / readTemplateManifest / writeTemplateManifest	A local template.json directory.
parseSourceSpec(spec, cwd?) / gitTemplate(source) / loadNpmTemplates(pkg)	Online source parsing/loading.

@deltabox/toolchain/providers

Export	Description
toolchainProviders()	Every registered provider with its actions resolved.
providerActions(provider)	The default actions for a provider (one per command).
viteProvider()	The Vite+ provider descriptor.

import { toolchainProviders } from '@deltabox/toolchain/providers';
console.log(toolchainProviders().map(p => p.id));

@deltabox/toolchain/tsdown

Export	Description
baseTsdownConfig	The shared tsdown base config.
createTsdownConfig(overrides?) / createPostBanner(options)	Build a tsdown config / a post-build banner.
cleanup(options?) / cleanupCommands()	Remove build artifacts / the turbo cache.

@deltabox/toolchain/tsconfig

Export	Description
tsconfigSyncTask()	The tsconfig sync task.
tsconfigBaseTemplate / tsconfigDefaultTemplate / tsconfigBuildTemplate	The base/default/build templates.
renderTsconfigBase / renderTsconfigDefault / renderTsconfigBuild	Render the templates with replacements.
buildMonorepoTsconfig(options) / renderMonorepoTsconfig(options)	The monorepo root tsconfig with references + aliases.
renderTsconfigTemplates(replacements?)	Render every template at once.
resolveTsconfig(options?) / readTsconfig(file)	Resolve paths/references/aliases (extends-aware).
generateTsconfigs(options) / runTsconfigCli(argv?)	The tsconfig generator and its CLI.
tsconfigFileNames(config) / restoreTsconfigOverrides(options)	Configured file names / remove applied overrides.
applyOverride / mergeOverride / revertOverride	Override deep-merge + snapshot-aware revert helpers.
getSnapshot / setSnapshot / deleteSnapshot	The manifest snapshot tree (repo-relative paths).

@deltabox/toolchain/changelog

Export	Description
runChangelog(argv?) / main	Derive the bump and update the changelog + versions.
runWorkflows(options) / resolveWorkflowId(name)	Trigger generated workflows with the vendor CLI.
workflowTargets(config) / workflowRunCommand(target, options)	List enabled workflows / build a vendor CLI command.
renderWorkflow(id, options) / renderWorkflows(...)	Render workflow YAML.
renderCommitlintConfig(options?) / changelogSyncTask()	Commitlint config + the changelog sync task.
readCommits(range) / deriveBump(records) / buildSummary(records)	Git commit reading, bump derivation and summaries.
renderChangelogEntry(...) / parseExistingChangelog(content)	Changelog entry rendering/parsing.
formatBody(body) / formatLine(line, repo)	Description + changelog-line normalization.

formatLine(line, repo) normalizes a changelog line in place: numeric-only short hashes (eg. #4033009) stay commit links, genuine issue numbers stay issue links, and a bare BREAKING CHANGE: marker is bolded unless it is already bold.

@deltabox/toolchain/biome

Export	Description
biomeConfig / biomeVscodeSettings	The generic Biome config and recommended VS Code settings.
renderBiomeConfig(replacements?, overrides?) / renderBiomeJson(...)	Resolve tokens + merge overrides, then serialize.
mergeBiomeConfig(base, patch) / renderVscodeSettings(indent?)	Recursive merge and settings rendering.
biomeSyncTask()	The biome sync task (writes biome.json).

@deltabox/toolchain/project

Export	Description
createRootProjectFiles(ctx) / createMonorepoRootFiles(ctx) / createWorkspaceFiles(ctx)	Scaffold files for each project kind.
generateProjectConfigs(options)	Generate dbx.config.ts for projects missing one.
renderToolchainConfig(ctx) / renderWorkspaceTsconfig(composite?)	Render the tooling config / a workspace tsconfig.
renderGitignore()	Render a generic .gitignore.
catalogsSyncTask() / renderYarnrc(catalog) / renderPnpmWorkspace(catalog, packages?)	The catalogs sync task + catalog file renderers.
writeGeneratedFiles(files, cwd?)	Write a GeneratedFile[].
projectCommands()	The project:* commands.