@deltabox/toolchain 1.2.0 → 1.2.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -1,9 +1,31 @@
1
1
  # Changelog
2
2
 
3
- ## 1.2.0 (October 2026)
3
+ ## 1.2.3 (October 2026)
4
4
 
5
5
  <!-- release:start -->
6
6
 
7
+ ### Documentation
8
+ - Update vscode extension screenshot ([#e3e189d](https://github.com/deltabox-studio/toolchain/commit/e3e189d) by [T0chi](https://github.com/T0chi))
9
+
10
+ <!-- release:end -->
11
+
12
+
13
+ ## 1.2.2 (October 2026)
14
+
15
+ ### Documentation
16
+ - Update config generator documentation ([#8305ef8](https://github.com/deltabox-studio/toolchain/commit/8305ef8) by [T0chi](https://github.com/T0chi))
17
+
18
+ ## 1.2.1 (October 2026)
19
+
20
+ ### Documentation
21
+ - Show how to load the generated config ([#0f4d0d1](https://github.com/deltabox-studio/toolchain/commit/0f4d0d1) by [T0chi](https://github.com/T0chi))
22
+ - Add a "Load the config at runtime" section to the config generator guide
23
+ (`parseEnvTree`, the typed accessors, `applyOverrides`, and schema validation via
24
+ `compileZodSchema`) plus a short loading example in the README.
25
+ - Update description and tags ([#64b64aa](https://github.com/deltabox-studio/toolchain/commit/64b64aa) by [T0chi](https://github.com/T0chi))
26
+
27
+ ## 1.2.0 (October 2026)
28
+
7
29
  ### New features
8
30
  #### Config
9
31
  - Generate the shared config types via the config generator ([#a063a2d](https://github.com/deltabox-studio/toolchain/commit/a063a2d) by [T0chi](https://github.com/T0chi))
@@ -28,9 +50,6 @@
28
50
  JSON schema) in the config generator guide and the README.
29
51
  - Update vscode extension preview ([#fd90dda](https://github.com/deltabox-studio/toolchain/commit/fd90dda) by [T0chi](https://github.com/T0chi))
30
52
 
31
- <!-- release:end -->
32
-
33
-
34
53
  ## 1.1.24 (October 2026)
35
54
 
36
55
  ### Documentation
package/README.md CHANGED
@@ -1,62 +1,50 @@
1
1
  # deltabox toolchain
2
2
 
3
- All-in-one, config-driven dev toolchain: scaffold projects, generate and manage configs, tsconfigs, changelogs and CI, run Vite+, and migrate other tools onto Ox.
4
-
5
3
  [![license: MPL-2.0](https://img.shields.io/badge/license-MPL--2.0-blue.svg)](./package.json)
6
4
  [![tests](https://img.shields.io/github/actions/workflow/status/deltabox-studio/toolchain/ci.yml?label=tests&logo=github)](https://github.com/deltabox-studio/toolchain/actions/workflows/ci.yml)
7
5
  [![npm version](https://img.shields.io/npm/v/@deltabox/toolchain.svg?color=cb3837&label=npm)](https://www.npmjs.com/package/@deltabox/toolchain)
8
6
 
7
+ All-in-one, config-driven dev toolchain: scaffold projects, generate and manage configs, tsconfigs, syncing, changelogs and CI, run Vite+, and migrate other tools onto Ox.
8
+
9
9
  `@deltabox/toolchain` is driven by a single `dbx.config.ts` at a repo
10
10
  root. Define the sections you want and the toolchain generates and keeps the
11
- matching files in sync — from a CLI, a programmatic API, and a VS Code extension.
11
+ matching files in sync.
12
12
 
13
13
  See [CHANGELOG.md](/CHANGELOG.md) for latest updates.
14
14
 
15
- **Documentation, guides and examples:** [toolchain.deltabox.studio](https://toolchain.deltabox.studio).
15
+ Documentation, guides and examples: [toolchain.deltabox.studio](https://toolchain.deltabox.studio/guide).
16
16
 
17
17
  ## Table of contents
18
18
 
19
19
  - [deltabox toolchain](#deltabox-toolchain)
20
- - [Table of contents](#table-of-contents)
21
- - [Features](#features)
22
- - [Install](#install)
23
- - [Quickstart](#quickstart)
24
- - [Config generator](#config-generator)
25
- - [Vite / Vite+ plugin](#vite--vite-plugin)
26
- - [CLI](#cli)
27
- - [Programmatic API](#programmatic-api)
28
- - [VS Code extension](#vs-code-extension)
29
- - [Development](#development)
30
- - [Docs](#docs)
31
- - [License](#license)
20
+ - [Table of contents](#table-of-contents)
21
+ - [Features](#features)
22
+ - [Install](#install)
23
+ - [Quickstart](#quickstart)
24
+ - [Config generator](#config-generator)
25
+ - [Vite / Vite+ plugin](#vite--vite-plugin)
26
+ - [CLI](#cli)
27
+ - [Programmatic API](#programmatic-api)
28
+ - [VS Code extension](#vs-code-extension)
29
+ - [Development](#development)
30
+ - [Docs](#docs)
31
+ - [License](#license)
32
32
 
33
33
  ## Features
34
34
 
35
- - **Config-driven.** Every area is an opt-in section in `dbx.config.ts`
36
- (`project`, `changelog`, `biome`, `tsconfig`, `templates`, `vite`, `watch`,
37
- `hooks`). Define a section to enable it; omit it and nothing is touched.
38
- - **Config generator.** A generic Zod/env engine (`createConfigEngine`) turns
39
- your schemas into a `.env.example`, a JSON Schema, a markdown reference, TS
40
- types and CLI flags, and wires `config:*` commands into your own CLI. See the
41
- [config generator guide](https://toolchain.deltabox.studio/guide/config-generator).
42
- - **Vite / Vite+ plugin.** Drive dbx from `vite.config.ts`: the `dbx()` plugin
43
- runs `dbx sync` before dev/build (or `dbx sync --check` in CI). Works with both
44
- Vite and Vite+.
45
- - **Changelogs & releases.** Conventional-Commits commitlint, a changelog
46
- pipeline that bumps versions and writes `CHANGELOG.md`, plus GitHub workflows
47
- for CI, changelog, release and issues.
48
- - **tsconfig generation.** Workspace `tsconfig.json` files with path aliases and
49
- project references, driven from one config.
50
- - **Providers.** Wire external toolchains behind one CLI. Vite+ ships as a
51
- provider, so every `vp` command is reachable as `dbx vite:*`.
52
- - **Templates.** Offline (builtin + local `template.json` dirs) and online
53
- (npm/git/Vite+) templates, creatable from the CLI or the extension.
54
- - **Migrations.** Move Biome, Prettier, ESLint or Dprint onto Ox
55
- (Oxfmt/Oxlint) with a pluggable migration engine (`--target files` or `vite`).
56
- - **Editor first.** A VS Code extension to sync, scaffold, run workflows, run
57
- Vite+ commands and pick templates.
58
- - **Monorepo aware.** Project graph, workspace tsconfigs, dependency-ordered
59
- tasks via `vp run`, and per-workspace files.
35
+ - **Config-driven**
36
+ - **Config generator**
37
+ - **Vite / Vite+ plugin**
38
+ - **Changelogs & releases**
39
+ - **tsconfig generation**
40
+ - **Providers**
41
+ - **Templates**
42
+ - **Migrations**
43
+ - **Editor first**
44
+ - **Monorepo aware**
45
+ - **Auto sync**
46
+
47
+ See more at [toolchain.deltabox.studio](https://toolchain.deltabox.studio).
60
48
 
61
49
  ## Install
62
50
 
@@ -153,6 +141,22 @@ export interface ServerConfig {
153
141
  }
154
142
  ```
155
143
 
144
+ At runtime the same package loads it back — `parseEnvTree` folds the `PREFIX_*`
145
+ variables into a tree and the typed accessors read it (schema validation is just
146
+ a `.parse()` away):
147
+
148
+ ```ts
149
+ import { envInt, envString, parseEnvTree } from '@deltabox/toolchain/config';
150
+
151
+ const tree = parseEnvTree(process.env, 'MYAPP_');
152
+ const port = envInt(tree, 'port', 3000);
153
+ const host = envString(tree, 'host', '0.0.0.0');
154
+ ```
155
+
156
+ See the [config generator
157
+ guide](https://toolchain.deltabox.studio/guide/config-generator) for loading,
158
+ overriding and validating the config.
159
+
156
160
  The toolchain generates its own config types this way — see
157
161
  `packages/shared/src/config-types.ts` and the [config generator
158
162
  guide](https://toolchain.deltabox.studio/guide/config-generator#generated-outputs).
@@ -214,8 +218,7 @@ await runSync({ tasks: defaultSyncTasks(), cwd: process.cwd(), config, tokens, p
214
218
  A VS Code extension is available for `deltabox toolchain`.
215
219
 
216
220
  <div align="center">
217
- <img src="./apps/docs/public/vscode-img-1.png" width="250" />
218
- <img src="./apps/docs/public/vscode-img-2.png" width="250" />
221
+ <img src="./apps/docs/public/vscode-screenshot.png" width="300" />
219
222
  </div>
220
223
 
221
224
  Follow the steps below to use it. Will be published to the marketplace in the future.
@@ -252,7 +255,7 @@ Docs live in `apps/docs` (VitePress): `yarn workspace @deltabox/toolchain-docs b
252
255
 
253
256
  ## Docs
254
257
 
255
- Full documentation, guides and examples live at [toolchain.deltabox.studio](https://toolchain.deltabox.studio).
258
+ Full documentation, guides and examples live at [toolchain.deltabox.studio](https://toolchain.deltabox.studio/guide).
256
259
 
257
260
  The source pages live in `apps/docs`.
258
261
 
package/dist/package.js CHANGED
@@ -1 +1 @@
1
- import"node:path";import"node:url";import.meta.url;var e=`1.2.0`;export{e as version};
1
+ import"node:path";import"node:url";import.meta.url;var e=`1.2.3`;export{e as version};
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@deltabox/toolchain",
3
- "version": "1.2.0",
3
+ "version": "1.2.3",
4
4
  "description": "All-in-one toolchain: scaffold projects, manage templates, configs, tsconfigs, changelogs and builds.",
5
5
  "homepage": "https://toolchain.deltabox.studio",
6
6
  "author": "Victor Sango <victor@deltabox.studio>",
@@ -27,7 +27,14 @@
27
27
  "vite-plus",
28
28
  "changelog",
29
29
  "scaffold",
30
- "extension"
30
+ "extension",
31
+ "zod",
32
+ "types",
33
+ "markdown",
34
+ "environment",
35
+ "variables",
36
+ "configuration",
37
+ "settings"
31
38
  ],
32
39
  "scripts": {
33
40
  "build": "vp run --filter \"./packages/*\" build && vp run build:root",
@@ -67,17 +74,17 @@
67
74
  "devDependencies": {
68
75
  "@commitlint/cli": "^21.2.2",
69
76
  "@commitlint/config-conventional": "^21.2.2",
70
- "@deltabox/toolchain-biome": "1.2.0",
71
- "@deltabox/toolchain-changelog": "1.2.0",
72
- "@deltabox/toolchain-config": "1.2.0",
73
- "@deltabox/toolchain-core": "1.2.0",
74
- "@deltabox/toolchain-migrate": "1.2.0",
75
- "@deltabox/toolchain-project": "1.2.0",
76
- "@deltabox/toolchain-shared": "1.2.0",
77
- "@deltabox/toolchain-template": "1.2.0",
78
- "@deltabox/toolchain-tsconfig": "1.2.0",
79
- "@deltabox/toolchain-tsdown": "1.2.0",
80
- "@deltabox/toolchain-vite": "1.2.0",
77
+ "@deltabox/toolchain-biome": "1.2.3",
78
+ "@deltabox/toolchain-changelog": "1.2.3",
79
+ "@deltabox/toolchain-config": "1.2.3",
80
+ "@deltabox/toolchain-core": "1.2.3",
81
+ "@deltabox/toolchain-migrate": "1.2.3",
82
+ "@deltabox/toolchain-project": "1.2.3",
83
+ "@deltabox/toolchain-shared": "1.2.3",
84
+ "@deltabox/toolchain-template": "1.2.3",
85
+ "@deltabox/toolchain-tsconfig": "1.2.3",
86
+ "@deltabox/toolchain-tsdown": "1.2.3",
87
+ "@deltabox/toolchain-vite": "1.2.3",
81
88
  "@types/node": "^22.10.2",
82
89
  "@typescript/native-preview": "7.0.0-dev.20260707.2",
83
90
  "cross-env": "^10.1.0",