@deltabox/toolchain 1.0.7 → 1.1.21

package/README.md

@@ -1,32 +1,34 @@
 # deltabox toolchain
 
-> 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.
+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.
 
 [![license: MPL-2.0](https://img.shields.io/badge/license-MPL--2.0-blue.svg)](./package.json)
-[![node](https://img.shields.io/badge/node-%3E%3D22.5.0-brightgreen.svg)](./package.json)
-[![yarn](https://img.shields.io/badge/yarn-4.17.1-2188b6.svg)](./package.json)
-[![package](https://img.shields.io/badge/npm-@deltabox%2Ftoolchain-cb3837.svg)](https://www.npmjs.com/package/@deltabox/toolchain)
+[![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)
+[![npm version](https://img.shields.io/npm/v/@deltabox/toolchain.svg?color=cb3837&label=npm)](https://www.npmjs.com/package/@deltabox/toolchain)
 
 `@deltabox/toolchain` is driven by a single `dbx.config.ts` at a repo
 root. Define the sections you want and the toolchain generates and keeps the
 matching files in sync — from a CLI, a programmatic API, and a VS Code extension.
 
-> **Documentation, guides and examples: [toolchain.deltabox.studio](https://toolchain.deltabox.studio).**
+See [CHANGELOG.md](/CHANGELOG.md) for latest updates.
+
+**Documentation, guides and examples:** [toolchain.deltabox.studio](https://toolchain.deltabox.studio).
 
 ## Table of contents
 
-- [Features](#features)
-- [Install](#install)
-- [Quickstart](#quickstart)
-- [Config generator](#config-generator)
-- [CLI](#cli)
-- [Programmatic API](#programmatic-api)
-- [Packages](#packages)
-- [VS Code extension](#vs-code-extension)
-- [Development](#development)
-- [Docs](#docs)
-- [License](#license)
+- [deltabox toolchain](#deltabox-toolchain)
+    - [Table of contents](#table-of-contents)
+    - [Features](#features)
+    - [Install](#install)
+    - [Quickstart](#quickstart)
+    - [Config generator](#config-generator)
+    - [Vite / Vite+ plugin](#vite--vite-plugin)
+    - [CLI](#cli)
+    - [Programmatic API](#programmatic-api)
+    - [VS Code extension](#vs-code-extension)
+    - [Development](#development)
+    - [Docs](#docs)
+    - [License](#license)
 
 ## Features
 
@@ -37,6 +39,9 @@ matching files in sync — from a CLI, a programmatic API, and a VS Code extensi
   your schemas into a `.env.example`, a JSON Schema, a markdown reference, TS
   types and CLI flags, and wires `config:*` commands into your own CLI. See the
   [config generator guide](https://toolchain.deltabox.studio/guide/config-generator).
+- **Vite / Vite+ plugin.** Drive dbx from `vite.config.ts`: the `dbx()` plugin
+  runs `dbx sync` before dev/build (or `dbx sync --check` in CI). Works with both
+  Vite and Vite+.
 - **Changelogs & releases.** Conventional-Commits commitlint, a changelog
   pipeline that bumps versions and writes `CHANGELOG.md`, plus GitHub workflows
   for CI, changelog, release and issues.
@@ -136,24 +141,43 @@ engine.writeMarkdown({ outDir: 'docs/reference/configuration' });
 commands on your own CLI. See the [config generator
 guide](https://toolchain.deltabox.studio/guide/config-generator).
 
+## Vite / Vite+ plugin
+
+`@deltabox/toolchain` ships a Vite plugin, so a Vite (or Vite+) project can run
+dbx as part of its own pipeline — no separate `dbx sync` step:
+
+```ts
+// vite.config.ts
+import { defineConfig } from 'vite'; // or 'vite-plus'
+
+import { defineDbxConfig } from '@deltabox/toolchain/vite';
+
+export default defineConfig(
+    defineDbxConfig({
+        // your usual Vite / Vite+ config
+    })
+);
+```
+
+- The `dbx()` plugin runs `dbx sync` before the dev server / build, or
+  `dbx sync --check` in CI (which fails the build when generated files are out of
+  date), and re-syncs when a `dbx.config.*` / `tsconfig.*.json` input changes.
+- `defineDbxConfig` also registers `vp run dbx:sync` / `vp run dbx:check`. Prefer
+  the bare plugin when you don't want the tasks:
+
+```ts
+import { dbx } from '@deltabox/toolchain/vite';
+
+export default defineConfig({ plugins: [dbx({ check: true })] });
+```
+
+See the [providers guide](https://toolchain.deltabox.studio/guide/providers).
+
 ## CLI
 
-| Command                                           | Description                                                            |
-| ------------------------------------------------- | ---------------------------------------------------------------------- |
-| `projects`                                        | Discover projects and write `.dbx/toolchain/projects.json`.            |
-| `sync`                                            | Regenerate managed files (`--check`, `--recursive`, `--watch`).        |
-| `watch`                                           | Sync once, then re-sync on change.                                     |
-| `reset`                                           | Remove generated files, the manifest and/or the config.                |
-| `project:init` / `:monorepo` / `:workspace`       | Scaffold a project, a monorepo root, or a workspace.                   |
-| `project:config`                                  | Generate `dbx.config.ts` for projects missing one.                     |
-| `create`                                          | Scaffold from a template (`--template`, `--name`, `--scope`, `--out`). |
-| `template:list` / `:add` / `:info`                | Inspect and record template sources.                                   |
-| `providers`                                       | List registered providers and their commands (`--json`).               |
-| `vite <args…>` / `vite:<sub>`                     | Passthrough to the Vite+ `vp` binary.                                  |
-| `migrate` / `migrate:list`                        | Convert Biome/Prettier/ESLint/Dprint onto Ox.                          |
-| `tsconfig` / `changelog` / `workflow` / `cleanup` | tsconfigs, changelog + versions, GitHub workflows, artifacts.          |
-
-Commands that run against a project load its `dbx.config.ts` first, so
+Visit the [CLI docs](https://toolchain.deltabox.studio/guide/cli) to learn more.
+
+Note: Commands that run against a project load its `dbx.config.ts` first, so
 config-derived defaults apply unless overridden on the command line.
 
 ## Programmatic API
@@ -165,32 +189,20 @@ const { config, tokens, projectType } = await loadToolingConfig(process.cwd());
 await runSync({ tasks: defaultSyncTasks(), cwd: process.cwd(), config, tokens, projectType });
 ```
 
-## Packages
-
-The root package re-exports every workspace below, and each is also importable
-via a subpath (`@deltabox/toolchain/tsconfig`, `…/vite`, `…/migrate`, …).
-
-| Package                         | Responsibility                                            |
-| ------------------------------- | --------------------------------------------------------- |
-| `@deltabox/toolchain-shared`    | Config model, template engine, provider model, run/spawn. |
-| `@deltabox/toolchain-core`      | Config loader, project graph, sync engine, manifest.      |
-| `@deltabox/toolchain-project`   | Scaffold generators (single / monorepo / workspace).      |
-| `@deltabox/toolchain-tsconfig`  | TypeScript config templates + tsconfig generator.         |
-| `@deltabox/toolchain-changelog` | Workflows, commitlint, changelog pipeline.                |
-| `@deltabox/toolchain-biome`     | `biome.json` generation + VS Code settings.               |
-| `@deltabox/toolchain-tsdown`    | tsdown base config + cleanup.                             |
-| `@deltabox/toolchain-config`    | Generic Zod/env config engine.                            |
-| `@deltabox/toolchain-vite`      | Vite+ provider (`vp` wrapper).                            |
-| `@deltabox/toolchain-template`  | Template registry/scaffolder.                             |
-| `@deltabox/toolchain-migrate`   | Biome/Prettier/ESLint/Dprint → Ox migrations.             |
-| `toolchain-vscode`              | VS Code extension (`deltabox-toolchain.vsix`).            |
-
 ## VS Code extension
 
-Install `packages/vscode/deltabox-toolchain.vsix`, then use the **deltabox
-toolchain** activity bar: Sync / Check sync / Scaffold project, **From
-template…**, **Run Vite+ command…** and **Create Vite+ project…**. See
-[`packages/vscode/README.md`](./packages/vscode/README.md).
+A VS Code extension is available for `deltabox toolchain`.
+
+Follow the steps below to use it. Will be published to the marketplace in the future.
+
+1. Download `deltabox-toolchain.vsix` from [releases](https://github.com/deltabox-studio/toolchain/releases).
+2. In VS Code install the `deltabox-toolchain.vsix` by going to the Extensions sidebar panel, click the three dotted menu on the panel header and select `Install from VSIX...` from the context menu.
+3. Now a screwdriver icon should pop up on the VS Code sidemenu, and you can use the command palette (Ctrl + P) as well:
+    1. Sync / Check sync / Scaffold project, From template…
+    2. Run Vite+ command...
+    3. Create Vite+ project...
+
+See [packages/vscode/README.md](./packages/vscode/README.md) to learn more about how it works.
 
 ## Development
 
@@ -215,22 +227,10 @@ Docs live in `apps/docs` (VitePress): `yarn workspace @deltabox/toolchain-docs b
 
 ## Docs
 
-Full documentation, guides and examples live at
-**[toolchain.deltabox.studio](https://toolchain.deltabox.studio)**:
-
-- [Getting Started](https://toolchain.deltabox.studio/guide/)
-- [Monorepo guide](https://toolchain.deltabox.studio/guide/monorepo)
-- [CLI](https://toolchain.deltabox.studio/guide/cli)
-- [Configuration](https://toolchain.deltabox.studio/guide/config)
-- [Config generator](https://toolchain.deltabox.studio/guide/config-generator)
-- [Providers (Vite+)](https://toolchain.deltabox.studio/guide/providers)
-- [Templates](https://toolchain.deltabox.studio/guide/templates)
-- [Migrations](https://toolchain.deltabox.studio/guide/migrations)
-- [Programmatic API](https://toolchain.deltabox.studio/guide/api)
-- [Config reference](https://toolchain.deltabox.studio/config/reference)
+Full documentation, guides and examples live at [toolchain.deltabox.studio](https://toolchain.deltabox.studio).
 
-The source pages live in `apps/docs` (VitePress).
+The source pages live in `apps/docs`.
 
 ## License
 
-[MPL-2.0](./LICENSE) © Victor Sango
+[MPL-2.0](./LICENSE) © deltabox

package/dist/package.js

@@ -1 +1 @@
-import"node:path";import"node:url";import.meta.url;var e=`1.0.5`;export{e as version};
+import"node:path";import"node:url";import.meta.url;var e=`1.1.21`;export{e as version};

package/dist/packages/changelog/src/utils/format.js

@@ -1,4 +1,4 @@
-import"node:path";import"node:url";import.meta.url;import{readFileSync as e,writeFileSync as t}from"node:fs";const n={feat:`New features`,fix:`Bug fixes`,refactor:`Refactors`,docs:`Documentation`,style:`Styles`,chore:`Chores`,test:`Tests`,perf:`Performance`,build:`Build system`,ci:`Continuous integration`,revert:`Reverts`,breaking:`Breaking changes`},r=[`breaking`,`feat`,`fix`,`perf`,`refactor`,`docs`,`style`,`test`,`build`,`ci`,`chore`,`revert`];function i(e){return n[e]??n[e.toLowerCase()]??`Other changes`}function a(e){let t=/^([a-zA-Z][a-zA-Z0-9]*)(\(([^)]*)\))?(!)?:\s*(.*)$/.exec(e);return t?{type:t[1].toLowerCase(),scope:t[3]?.trim()||void 0,breaking:!!t[4],rest:t[5]??``}:{type:`chore`,breaking:!1,rest:e}}function o(e){let t=/* @__PURE__ */ new Map;for(let n of e){let{parsed:e}=n,r=t.get(e.type)??{title:i(e.type),ungrouped:[],scopes:/* @__PURE__ */ new Map};if(e.scope){let t=r.scopes.get(e.scope)??[];t.push(n),r.scopes.set(e.scope,t)}else r.ungrouped.push(n);t.set(e.type,r)}return[...t.entries()].sort((e,t)=>{let n=r.indexOf(e[0]),i=r.indexOf(t[0]);return(n===-1?r.length:n)-(i===-1?r.length:i)}).map(([,e])=>e)}function s(e){if(e.length===0)return`- No description provided.`;let t=[];for(let n of e){t.push(`### ${n.title}`);for(let e of n.ungrouped)t.push(e.text),t.push(...c(e.bodyParagraphs));for(let[e,r]of n.scopes){t.push(`#### ${l(e)}`);for(let e of r)t.push(e.text),t.push(...c(e.bodyParagraphs))}}return t.join(`
+import"node:path";import"node:url";import.meta.url;import{readFileSync as e,writeFileSync as t}from"node:fs";const n={feat:`New features`,fix:`Bug fixes`,refactor:`Refactors`,docs:`Documentation`,style:`Styles`,chore:`Chores`,test:`Tests`,perf:`Performance`,build:`Build system`,ci:`CI`,revert:`Reverts`,breaking:`Breaking changes`},r=[`breaking`,`feat`,`fix`,`perf`,`refactor`,`docs`,`style`,`test`,`build`,`ci`,`chore`,`revert`];function i(e){return n[e]??n[e.toLowerCase()]??`Other changes`}function a(e){let t=/^([a-zA-Z][a-zA-Z0-9]*)(\(([^)]*)\))?(!)?:\s*(.*)$/.exec(e);return t?{type:t[1].toLowerCase(),scope:t[3]?.trim()||void 0,breaking:!!t[4],rest:t[5]??``}:{type:`chore`,breaking:!1,rest:e}}function o(e){let t=/* @__PURE__ */ new Map;for(let n of e){let{parsed:e}=n,r=t.get(e.type)??{title:i(e.type),ungrouped:[],scopes:/* @__PURE__ */ new Map};if(e.scope){let t=r.scopes.get(e.scope)??[];t.push(n),r.scopes.set(e.scope,t)}else r.ungrouped.push(n);t.set(e.type,r)}return[...t.entries()].sort((e,t)=>{let n=r.indexOf(e[0]),i=r.indexOf(t[0]);return(n===-1?r.length:n)-(i===-1?r.length:i)}).map(([,e])=>e)}function s(e){if(e.length===0)return`- No description provided.`;let t=[];for(let n of e){t.push(`### ${n.title}`);for(let e of n.ungrouped)t.push(e.text),t.push(...c(e.bodyParagraphs));for(let[e,r]of n.scopes){t.push(`#### ${l(e)}`);for(let e of r)t.push(e.text),t.push(...c(e.bodyParagraphs))}}return t.join(`
 `)}function c(e){let t=[];for(let n of e){let[e,...r]=n;e&&(t.push(`  - ${e}`),t.push(...r.map(e=>`    ${e}`)))}return t}function l(e){return e.charAt(0).toUpperCase()+e.slice(1)}function u(e){return e.length>0?e.charAt(0).toUpperCase()+e.slice(1):e}function d(e){let t=e.lastIndexOf(`([#`);if(t===-1)return{main:e,inline:``};let n=e.slice(t),r=/^(\(\[#[^\]]+\]\([^)]*\) by [^)]*\)\)?)(?:\(fixes [^)]*\)\)?)?/.exec(n);if(!r)return{main:e,inline:``};let i=r[0]??``;return{main:e.slice(0,t)+i,inline:e.slice(t+i.length).trim()}}function f(e){let t=[],n=[];for(let r of e.split(`
 `)){let e=r.trim();if(!e){n.length>0&&(t.push(n),n=[]);continue}if(e.startsWith(`-`)||e.startsWith(`*`)||/^[0-9]+[.)]/.test(e)||!e.replace(/(?:close[sd]?|fixe?s|fixed|resolves?|resolved)\b\s*:?\s*#\d+\s*[,;]?\s*/gi,``).trim())continue;let i=/^(BREAKING CHANGE|Reviewed-by|Signed-off-by|Co-authored-by|Acked-by|Co-developed-by|Helped-by|Reported-by|Suggested-by|Tested-by|Cc):\s+(.+)$/i.exec(e);i&&!/^(http|https)\b/.test(e)?(n.length>0&&(t.push(n),n=[]),t.push([`**${(i[1]??``).trim()}:** ${(i[2]??``).trim()}`])):n.push(e)}return n.length>0&&t.push(n),t}function p(e,t){return`https://github.com/${e}/commit/${t}`}function m(e,t){return`https://github.com/${e}/issues/${t}`}function h(e,t){return e.replace(/\[(#[0-9a-fA-F]{6,40})\]\(([^)]*)\)/g,(e,n)=>{let r=n.replace(`#`,``).slice(0,7);return`[#${r}](${p(t,r)})`}).replace(/(^|[^\w[])#([0-9a-fA-F]{7,40})(?![0-9a-fA-F])(?=[)\].,;:\s]|$)/g,(e,n,r)=>{let i=r.slice(0,7);return`${n}[#${i}](${p(t,i)})`})}function g(e,t){return e.replace(/\[#(\d+)(?=[ \]])(?:[^\]]*)\]\([^)]*\)/g,(e,n)=>`[#${n}](${m(t,n)})`).replace(/(^|[^\w[])#(\d+)(?=[)\].,;:\s]|$)/g,(e,n,r)=>`${n}[#${r}](${m(t,r)})`)}function _(e,t){if(!t)return e;let n=h(e,t);return n=g(n,t),n}function v(n,r){if(!r)return;let i=e(n,`utf8`),a=i.split(`
 `).map(e=>_(e,r)).join(`

package/dist/packages/changelog/src/utils/repo.js

@@ -1 +1 @@
-import{resolve as e}from"node:path";import"node:url";import.meta.url;import{existsSync as t,globSync as n,readFileSync as r,writeFileSync as i}from"node:fs";function a(){let n=process.cwd();for(let r=0;r<8;r++){if(t(e(n,`package.json`)))return n;let r=e(n,`..`);if(r===n)break;n=r}return process.cwd()}function o(){let i=a(),o=JSON.parse(r(e(i,`package.json`),`utf8`)),s=/* @__PURE__ */ new Set([i]);for(let r of o.workspaces??[])if(r!==`.`)for(let a of n(r,{cwd:i})){let n=e(i,a);t(e(n,`package.json`))&&s.add(n)}return[...s]}function s(){let t=e(a(),`package.json`);return JSON.parse(r(t,`utf8`)).version??`0.0.0`}function c(n){for(let a of o()){let o=e(a,`package.json`);if(!t(o))continue;let s=JSON.parse(r(o,`utf8`));s.version=n,i(o,`${JSON.stringify(s,null,4)}\n`,`utf8`),console.log(`  bumped ${o}`)}}function l(){let n=a();return[e(n,`CHANGELOG.md`),...o().filter(t=>e(t)!==e(n)).map(t=>e(t,`CHANGELOG.md`))].filter(e=>t(e))}export{l as changelogFiles,o as discoverWorkspaceDirs,s as readRootVersion,a as repoRoot,c as writeVersion};
+import{resolve as e}from"node:path";import"node:url";import.meta.url;import{existsSync as t,globSync as n,readFileSync as r,writeFileSync as i}from"node:fs";function a(){let n=process.cwd();for(let r=0;r<8;r++){if(t(e(n,`package.json`)))return n;let r=e(n,`..`);if(r===n)break;n=r}return process.cwd()}function o(){let i=a(),o=JSON.parse(r(e(i,`package.json`),`utf8`)),s=/* @__PURE__ */ new Set([i]);for(let r of o.workspaces??[])if(r!==`.`)for(let a of n(r,{cwd:i})){let n=e(i,a);t(e(n,`package.json`))&&s.add(n)}return[...s]}function s(){let t=e(a(),`package.json`);return JSON.parse(r(t,`utf8`)).version??`0.0.0`}function c(n){for(let a of o()){let o=e(a,`package.json`);if(!t(o))continue;let s=r(o,`utf8`),c=s.replace(/("version"\s*:\s*)"[^"]*"/,`$1"${n}"`);c!==s&&(i(o,c,`utf8`),console.log(`  bumped ${o}`))}}function l(){let n=a();return[e(n,`CHANGELOG.md`),...o().filter(t=>e(t)!==e(n)).map(t=>e(t,`CHANGELOG.md`))].filter(e=>t(e))}export{l as changelogFiles,o as discoverWorkspaceDirs,s as readRootVersion,a as repoRoot,c as writeVersion};

package/dist/packages/changelog/src/workflows.d.ts

@@ -9,6 +9,8 @@ export interface WorkflowJob {
   'runs-on': string;
   if?: string;
   needs?: string | string[];
+  /** A GitHub environment name (matched by the OIDC trusted publisher). */
+  environment?: string;
   permissions?: Record<string, string>;
   env?: Record<string, string>;
   outputs?: Record<string, string>;

package/dist/packages/changelog/src/workflows.js

@@ -1,5 +1,5 @@
 import"node:path";import"node:url";import.meta.url;import{applyReplacementsDeep as e}from"../../shared/src/template.js";import{toYaml as t}from"../../shared/src/yaml.js";import"../../shared/src/index.js";const n={nodeVersion:`22`,yarnVersion:`4.17.1`,packageManager:`yarn`,mainBranch:`main`,devBranch:`dev`,tooling:`dbx`},r={ci:`ci.yml`,changelog:`changelog.yml`,release:`release.yml`,sync:`sync.yml`,issues:`issues.yml`};function i(e){return e===void 0?!0:typeof e==`boolean`?e:e.enabled!==!1}function a(e){return`${e.packageManager} ${e.tooling}`}function o(e){return[{name:`Checkout`,uses:`actions/checkout@v4`,with:{"fetch-depth":0,token:"${{ secrets.GITHUB_TOKEN }}"}},{name:`Setup Node`,uses:`actions/setup-node@v4`,with:{"node-version":String(e.nodeVersion)}},{name:`Enable Corepack`,run:`corepack enable\ncorepack prepare ${e.packageManager}@${e.yarnVersion} --activate`},{name:`Install dependencies`,run:`${e.packageManager} install --immutable`}]}function s(e){let t=a(e),n=String(e.mainBranch),r=String(e.devBranch);return{ci:{name:`CI`,on:{push:{branches:[n]},pull_request:{branches:[`release/**`,`feat/**`,`feature/**`,`fix/**`,`chore/**`]}},jobs:{ci:{"runs-on":`ubuntu-latest`,steps:[...o(e),{name:`Commitlint (Conventional Commits)`,if:"${{ github.event_name == 'pull_request' || github.event.before != '0000000000000000000000000000000000000000' }}",run:`set -euo pipefail\nbase="\${{ github.event.pull_request.base.sha || github.event.before }}"\nhead="\${{ github.event.pull_request.head.sha || github.event.after }}"\n${e.packageManager} commitlint --from "$base" --to "$head"`},{name:`Verify generated files are in sync`,run:`${t} sync --check`},{name:`Build`,run:`${e.packageManager} build`}]}}},changelog:{name:`Changelog (dev)`,on:{push:{branches:[r]}},permissions:{contents:`write`},concurrency:{group:`changelog-dev`,"cancel-in-progress":!1},jobs:{"generate-changelog":{"runs-on":`ubuntu-latest`,if:`!startsWith(github.event.head_commit.message, 'chore: version packages ') && !startsWith(github.event.head_commit.message, 'release: ')`,env:{GITHUB_TOKEN:"${{ secrets.GITHUB_TOKEN }}"},steps:[...o(e),{name:`Generate changelog + bump versions`,env:{GITHUB_TOKEN:"${{ secrets.GITHUB_TOKEN }}"},run:[`set -euo pipefail`,'after="${{ github.event.after }}"; [ -n "$after" ] || after="HEAD"',`boundary="$(git log --format=%H --grep='^chore: version packages ' -1 || true)"`,`if [ -n "$boundary" ]; then range="$boundary..$after"; else range="$after"; fi`,`${t} changelog --range "$range"`].join(`
-`)},{name:`Commit + push changelog updates`,env:{GITHUB_TOKEN:"${{ secrets.GITHUB_TOKEN }}"},run:[`set -euo pipefail`,`git diff --quiet && { echo "No changelog changes."; exit 0; }`,`git config user.name "github-actions[bot]"`,`git config user.email "41898282+github-actions[bot]@users.noreply.github.com"`,`git add -A`,`git commit -m "chore: version packages ($(node -p "require('./package.json').version"))"`,`git push origin ${r}`].join(`
+`)},{name:`Commit + push changelog updates`,env:{GITHUB_TOKEN:"${{ secrets.GITHUB_TOKEN }}"},run:[`set -euo pipefail`,`git diff --quiet && { echo "No changelog changes."; exit 0; }`,`git config user.name "github-actions[bot]"`,`git config user.email "41898282+github-actions[bot]@users.noreply.github.com"`,`git add -u -- "*package.json" "*CHANGELOG.md"`,`git commit -m "chore: version packages ($(node -p "require('./package.json').version"))"`,`git push origin ${r}`].join(`
 `)}]}}},release:{name:`Release`,on:{push:{branches:[n]},workflow_dispatch:null},permissions:{contents:`write`,"pull-requests":`write`},concurrency:{group:`release`,"cancel-in-progress":!1},jobs:{"create-release-pr":{"runs-on":`ubuntu-latest`,if:`(github.event_name == 'push' || github.event_name == 'workflow_dispatch') && !startsWith(github.event.head_commit.message, 'chore: version packages ') && !startsWith(github.event.head_commit.message, 'release: ')`,env:{GITHUB_TOKEN:"${{ secrets.GITHUB_TOKEN }}"},steps:[...o(e),{name:`Open release PR`,env:{GITHUB_TOKEN:"${{ secrets.GITHUB_TOKEN }}"},run:[`set -euo pipefail`,`version="$(node -p "require('./package.json').version")"`,`branch="release/$version"`,`if git ls-remote --exit-code --heads origin "$branch" >/dev/null 2>&1; then`,`  echo "Release PR already open for $version."; exit 0`,`fi`,`git config user.name "github-actions[bot]"`,`git config user.email "41898282+github-actions[bot]@users.noreply.github.com"`,`git checkout -b "$branch"`,`git add -A`,`git commit -m "chore: version packages ($version)" || true`,`git push origin "$branch"`,`notes="$(awk '/<!-- release:start -->/{f=1;next} /<!-- release:end -->/{exit} f{print}' CHANGELOG.md 2>/dev/null || true)"`,`[ -n "$notes" ] || notes="Release $version"`,`gh pr create --base ${n} --head "$branch" --title "release: $version" --body "$notes"`].join(`
 `)}]}}},sync:{name:`Tooling sync`,on:{push:{branches:[n,r]},pull_request:null},jobs:{sync:{"runs-on":`ubuntu-latest`,steps:[...o(e),{name:`Verify generated files are in sync`,run:`${t} sync --check`}]}}},issues:{name:`Issues`,on:{issues:{types:[`opened`]}},permissions:{issues:`write`},jobs:{"enforce-title":{"runs-on":`ubuntu-latest`,steps:[{name:`Check and rename issue title`,env:{GH_TOKEN:"${{ github.token }}",ISSUE_NUMBER:"${{ github.event.issue.number }}"},run:[`set -euo pipefail`,`labels=$(gh issue view "$ISSUE_NUMBER" --json labels -q '.labels[].name' || true)`,`title=$(gh issue view "$ISSUE_NUMBER" --json title -q '.title')`,`type=""`,`for label in $labels; do case "$label" in *bug*) type="bug" ;; esac; done`,`if [ -z "$type" ]; then for label in $labels; do case "$label" in *enhancement*|*feature*|*feat*) type="feat" ;; esac; done; fi`,`if [ -z "$type" ]; then echo "No bug/enhancement label on issue #$ISSUE_NUMBER; skipping."; exit 0; fi`,`prefix="[bug]"; [ "$type" = "feat" ] && prefix="[feat]"`,`stripped=$(printf '%s' "$title" | sed -E 's/^\\[(bug|feat)\\] *//i')`,`new_title="$prefix $stripped"`,`if [ "$new_title" = "$title" ]; then echo "Issue #$ISSUE_NUMBER title already conforms."; exit 0; fi`,`gh issue edit "$ISSUE_NUMBER" --title "$new_title"`].join(`
 `)}]}}}}}function c(e){return e.steps?Array.isArray(e.steps)?e.steps:[e.steps]:[]}function l(e,t={}){let n=structuredClone(e);if(t.pushBranches){let e=n.on.push??{};n.on.push={...e,branches:t.pushBranches}}if(t.pullRequestBranches){let e=n.on.pull_request??{};n.on.pull_request={...e,branches:t.pullRequestBranches}}t.triggers&&(n.on={...n.on,...t.triggers}),t.extra&&Object.assign(n,t.extra),t.jobs&&(n.jobs={...n.jobs,...t.jobs});let r=Object.keys(n.jobs)[0];for(let e of c(t)){let t=e.job??r;if(!t)continue;let i=n.jobs[t];i&&(i.steps=[...e.before??[],...i.steps,...e.after??[]])}return n}function u(r,i){let a=i.config??{};if(a.enabled===!1)return;let o={...n,...i.tokens,...a.tokens},c=s(o)[r],u=e(l(c,a),o);return t(u)}function d(e,t={}){let n={};for(let a of Object.keys(r)){let o=t[a];if(!i(o))continue;let s=u(a,{tokens:e,config:typeof o==`object`?o:{}});s&&(n[r[a]]=s)}return n}export{n as DEFAULT_WORKFLOW_TOKENS,r as WORKFLOW_FILENAMES,l as applyWorkflowConfig,s as defaultWorkflows,i as isEnabled,u as renderWorkflow,d as renderWorkflows};

package/dist/packages/core/src/loader.js

@@ -1 +1 @@
-import{default as e}from"node:path";import{pathToFileURL as t}from"node:url";import.meta.url;import{CONFIG_FILE_NAMES as n,resolveTokens as r}from"../../shared/src/toolchain.js";import"../../shared/src/index.js";import{resolveProjectType as i}from"./project-type.js";import a from"node:fs";function o(t=process.cwd()){for(let r of n){let n=e.resolve(t,r);if(a.existsSync(n))return n}}async function s(e){if(e.endsWith(`.json`))return JSON.parse(a.readFileSync(e,`utf-8`));let n=t(e).href;try{let e=await import(n);return e.default??e}catch(e){try{let{tsImport:e}=await import(`C:\\Users\\user\\coding\\projects\\deltabox\\@deltabox\\toolchain\\node_modules\\tsx\\dist\\esm\\api\\index.mjs`),t=await e(n,import.meta.url);return t.default??t}catch{throw e}}}async function c(e=process.cwd()){let t=o(e),n={};if(t){let e=await s(t),r=e&&typeof e==`object`?e.toolchain:void 0;r&&typeof r==`object`&&(n=r)}let a=r(n);return await n.hooks?.afterLoad?.({cwd:e,config:n,tokens:a,...t?{path:t}:{}}),{config:n,...t?{path:t}:{},tokens:a,projectType:i(e,n)}}export{o as findConfigFile,c as loadToolingConfig};
+import{default as e}from"node:path";import{pathToFileURL as t}from"node:url";import.meta.url;import{CONFIG_FILE_NAMES as n,resolveTokens as r}from"../../shared/src/toolchain.js";import"../../shared/src/index.js";import{resolveProjectType as i}from"./project-type.js";import a from"node:fs";function o(t=process.cwd()){for(let r of n){let n=e.resolve(t,r);if(a.existsSync(n))return n}}async function s(e){if(e.endsWith(`.json`))return JSON.parse(a.readFileSync(e,`utf-8`));let n=t(e).href;try{let e=await import(n);return e.default??e}catch(e){try{let{tsImport:e}=await import(`/home/runner/work/toolchain/toolchain/node_modules/tsx/dist/esm/api/index.mjs`),t=await e(n,import.meta.url);return t.default??t}catch{throw e}}}async function c(e=process.cwd()){let t=o(e),n={};if(t){let e=await s(t),r=e&&typeof e==`object`?e.toolchain:void 0;r&&typeof r==`object`&&(n=r)}let a=r(n);return await n.hooks?.afterLoad?.({cwd:e,config:n,tokens:a,...t?{path:t}:{}}),{config:n,...t?{path:t}:{},tokens:a,projectType:i(e,n)}}export{o as findConfigFile,c as loadToolingConfig};

package/dist/packages/tsconfig/src/cli/generate/utils.d.ts

@@ -1,6 +1,6 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
-import { TsConfigJson } from "C:\\Users\\user\\coding\\projects\\deltabox\\@deltabox\\toolchain\\node_modules\\type-fest\\index.js";
+import { TsConfigJson } from "/home/runner/work/toolchain/toolchain/node_modules/type-fest/index.js";
 //#region packages/tsconfig/src/cli/generate/utils.d.ts
 export type GeneratedTsconfigResult = ReturnType<typeof generateTsconfig>;
 export declare function generateTsconfig(options: {

package/dist/packages/vite/src/index.d.ts

@@ -2,7 +2,8 @@ import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
 import { viteCommands } from "./cli/index.js";
 import { VP_COMMANDS, VpCommandInfo, VpGroup, viteCommandName } from "./commands.js";
+import { DBX_TASKS, DbxPluginOptions, DbxSource, DbxViteConfig, ResolvedDbx, dbx, defineDbxConfig, resolveDbx, runDbx } from "./plugin.js";
 import { viteProvider } from "./provider.js";
 import { DEFAULT_LINT_IGNORE, DEFAULT_TEST_INCLUDE, renderViteConfig, viteConfigObject, viteSyncTask } from "./sync.js";
 import { ResolvedVp, RunVpOptions, VpResult, VpSource, describeVp, hasVp, resolveVp, runVp, vpVersion, which } from "./vp.js";
-export { DEFAULT_LINT_IGNORE, DEFAULT_TEST_INCLUDE, ResolvedVp, RunVpOptions, VP_COMMANDS, VpCommandInfo, VpGroup, VpResult, VpSource, describeVp, hasVp, renderViteConfig, resolveVp, runVp, viteCommandName, viteCommands, viteConfigObject, viteProvider, viteSyncTask, vpVersion, which };
+export { DBX_TASKS, DEFAULT_LINT_IGNORE, DEFAULT_TEST_INCLUDE, DbxPluginOptions, DbxSource, DbxViteConfig, ResolvedDbx, ResolvedVp, RunVpOptions, VP_COMMANDS, VpCommandInfo, VpGroup, VpResult, VpSource, dbx, defineDbxConfig, describeVp, hasVp, renderViteConfig, resolveDbx, resolveVp, runDbx, runVp, viteCommandName, viteCommands, viteConfigObject, viteProvider, viteSyncTask, vpVersion, which };

package/dist/packages/vite/src/index.js

@@ -1 +1 @@
-import"node:path";import"node:url";import.meta.url;import{VP_COMMANDS as e,viteCommandName as t}from"./commands.js";import{describeVp as n,hasVp as r,resolveVp as i,runVp as a,vpVersion as o,which as s}from"./vp.js";import{viteCommands as c}from"./cli/index.js";import{viteProvider as l}from"./provider.js";import{DEFAULT_LINT_IGNORE as u,DEFAULT_TEST_INCLUDE as d,renderViteConfig as f,viteConfigObject as p,viteSyncTask as m}from"./sync.js";export{u as DEFAULT_LINT_IGNORE,d as DEFAULT_TEST_INCLUDE,e as VP_COMMANDS,n as describeVp,r as hasVp,f as renderViteConfig,i as resolveVp,a as runVp,t as viteCommandName,c as viteCommands,p as viteConfigObject,l as viteProvider,m as viteSyncTask,o as vpVersion,s as which};
+import"node:path";import"node:url";import.meta.url;import{VP_COMMANDS as e,viteCommandName as t}from"./commands.js";import{describeVp as n,hasVp as r,resolveVp as i,runVp as a,vpVersion as o,which as s}from"./vp.js";import{viteCommands as c}from"./cli/index.js";import{DBX_TASKS as l,dbx as u,defineDbxConfig as d,resolveDbx as f,runDbx as p}from"./plugin.js";import{viteProvider as m}from"./provider.js";import{DEFAULT_LINT_IGNORE as h,DEFAULT_TEST_INCLUDE as g,renderViteConfig as _,viteConfigObject as v,viteSyncTask as y}from"./sync.js";export{l as DBX_TASKS,h as DEFAULT_LINT_IGNORE,g as DEFAULT_TEST_INCLUDE,e as VP_COMMANDS,u as dbx,d as defineDbxConfig,n as describeVp,r as hasVp,_ as renderViteConfig,f as resolveDbx,i as resolveVp,p as runDbx,a as runVp,t as viteCommandName,c as viteCommands,v as viteConfigObject,m as viteProvider,y as viteSyncTask,o as vpVersion,s as which};

package/dist/packages/vite/src/plugin.d.ts

@@ -0,0 +1,65 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+import { Plugin, UserConfig } from "/home/runner/work/toolchain/toolchain/node_modules/vite/dist/node/index.js";
+//#region packages/vite/src/plugin.d.ts
+/** How a `dbx` binary was resolved. */
+export type DbxSource = 'local' | 'global' | 'npx';
+/** A resolved `dbx` invocation. */
+export interface ResolvedDbx {
+  /** The executable to spawn. */
+  exe: string;
+  /** Leading args (eg. `--yes @deltabox/toolchain` for the npx fallback). */
+  args: string[];
+  /** Where the binary came from. */
+  source: DbxSource;
+}
+/**
+ * Resolve the `dbx` binary: project-local shim -> global `PATH` ->
+ * `npx --yes @deltabox/toolchain`.
+ */
+export declare function resolveDbx(cwd?: string): ResolvedDbx;
+/** Run `dbx <args>` in `cwd`, streaming output. Resolves with the exit code. */
+export declare function runDbx(args: string[], cwd?: string): Promise<number>;
+/** The Vite+ tasks the wrapper registers, keyed by task name. */
+export declare const DBX_TASKS: {
+  readonly 'dbx:sync': {
+    readonly command: 'dbx sync';
+  };
+  readonly 'dbx:check': {
+    readonly command: 'dbx sync --check';
+  };
+};
+export interface DbxPluginOptions {
+  /** Project root (default: the resolved Vite root). */
+  cwd?: string;
+  /** Run `dbx sync` before the dev server / build (default true). */
+  sync?: boolean;
+  /**
+   * Run `dbx sync --check` and fail the build when generated files are out of
+   * date (default: true when `CI` is set in the environment).
+   */
+  check?: boolean;
+  /** Re-sync when a dbx input file changes in watch mode (default true). */
+  watch?: boolean;
+  /** Debounce (ms) for watch-triggered syncs (default 150). */
+  debounce?: number;
+}
+/**
+ * A Vite / Vite+ plugin that runs `@deltabox/toolchain` in the Vite pipeline:
+ * `dbx sync` before dev/build (or `dbx sync --check` in CI) and a debounced
+ * re-sync when a dbx input changes. Add it to `plugins`, or use
+ * {@link defineDbxConfig}, which also registers the `vp run dbx:*` tasks.
+ */
+export declare function dbx(options?: DbxPluginOptions): Plugin;
+/** A Vite+ config: Vite's `UserConfig` plus the Vite+ `run` block. */
+export type DbxViteConfig = UserConfig & {
+  run?: {
+    tasks?: Record<string, unknown>;
+  } & Record<string, unknown>;
+};
+/**
+ * Wrap a Vite+ config with dbx: prepend the {@link dbx} plugin and register the
+ * `dbx:sync` / `dbx:check` tasks.
+ */
+export declare function defineDbxConfig(config: DbxViteConfig, options?: DbxPluginOptions): DbxViteConfig;
+//#endregion

package/dist/packages/vite/src/plugin.js

@@ -0,0 +1 @@
+import{default as e}from"node:path";import"node:url";import.meta.url;import{spawnCross as t}from"../../shared/src/run.js";import"../../shared/src/index.js";import{which as n}from"./vp.js";import r from"node:fs";const i=process.platform===`win32`;function a(t){let n=e.join(t,`node_modules`,`.bin`,`dbx`);return i?[`${n}.cmd`,`${n}.exe`,`${n}.ps1`,n]:[n]}function o(e=process.cwd()){for(let t of a(e))if(r.existsSync(t))return{exe:t,args:[],source:`local`};let t=n(`dbx`);return t?{exe:t,args:[],source:`global`}:{exe:i?`npx.cmd`:`npx`,args:[`--yes`,`@deltabox/toolchain`],source:`npx`}}function s(e,n=process.cwd()){let r=o(n);return new Promise(i=>{let a=t(r.exe,[...r.args,...e],{cwd:n,env:process.env,stdio:`inherit`});a.on(`error`,()=>i(1)),a.on(`exit`,e=>i(e??0))})}const c={"dbx:sync":{command:`dbx sync`},"dbx:check":{command:`dbx sync --check`}},l=[/dbx\.config\.[cm]?[jt]s$/,/tsconfig\.(?:default|monorepo)\.json$/];function u(e={}){let t=e.check??!!process.env.CI,n=e.sync??!0,r=e.watch??!0,i=e.debounce??150,a=e.cwd??process.cwd(),o,c=!1,u=async()=>{if(!c){c=!0;try{await s([`sync`],a)}finally{c=!1}}},d=()=>{o&&clearTimeout(o),o=setTimeout(()=>{u()},i)};return{name:`deltabox-toolchain`,enforce:`pre`,configResolved(t){a=e.cwd??t.root},async buildStart(){t?await s([`sync`,`--check`],a)!==0&&this.error("deltabox-toolchain: generated files are out of date — run `dbx sync`."):n&&await u()},watchChange(e){r&&n&&l.some(t=>t.test(e))&&d()}}}function d(e,t={}){let n=e.plugins??[],r=e.run??{};return{...e,plugins:[u(t),...n],run:{...r,tasks:{...c,...r.tasks}}}}export{c as DBX_TASKS,u as dbx,d as defineDbxConfig,o as resolveDbx,s as runDbx};

package/dist/vite.d.ts

@@ -2,8 +2,9 @@ import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
 import { viteCommands } from "./packages/vite/src/cli/index.js";
 import { VP_COMMANDS, VpCommandInfo, VpGroup, viteCommandName } from "./packages/vite/src/commands.js";
+import { DBX_TASKS, DbxPluginOptions, DbxSource, DbxViteConfig, ResolvedDbx, dbx, defineDbxConfig, resolveDbx, runDbx } from "./packages/vite/src/plugin.js";
 import { viteProvider } from "./packages/vite/src/provider.js";
 import { DEFAULT_LINT_IGNORE, DEFAULT_TEST_INCLUDE, renderViteConfig, viteConfigObject, viteSyncTask } from "./packages/vite/src/sync.js";
 import { ResolvedVp, RunVpOptions, VpResult, VpSource, describeVp, hasVp, resolveVp, runVp, vpVersion, which } from "./packages/vite/src/vp.js";
 import "./packages/vite/src/index.js";
-export { DEFAULT_LINT_IGNORE, DEFAULT_TEST_INCLUDE, ResolvedVp, RunVpOptions, VP_COMMANDS, VpCommandInfo, VpGroup, VpResult, VpSource, describeVp, hasVp, renderViteConfig, resolveVp, runVp, viteCommandName, viteCommands, viteConfigObject, viteProvider, viteSyncTask, vpVersion, which };
+export { DBX_TASKS, DEFAULT_LINT_IGNORE, DEFAULT_TEST_INCLUDE, DbxPluginOptions, DbxSource, DbxViteConfig, ResolvedDbx, ResolvedVp, RunVpOptions, VP_COMMANDS, VpCommandInfo, VpGroup, VpResult, VpSource, dbx, defineDbxConfig, describeVp, hasVp, renderViteConfig, resolveDbx, resolveVp, runDbx, runVp, viteCommandName, viteCommands, viteConfigObject, viteProvider, viteSyncTask, vpVersion, which };

package/dist/vite.js

@@ -1 +1 @@
-import"node:path";import"node:url";import.meta.url;import{VP_COMMANDS as e,viteCommandName as t}from"./packages/vite/src/commands.js";import{describeVp as n,hasVp as r,resolveVp as i,runVp as a,vpVersion as o,which as s}from"./packages/vite/src/vp.js";import{viteCommands as c}from"./packages/vite/src/cli/index.js";import{viteProvider as l}from"./packages/vite/src/provider.js";import{DEFAULT_LINT_IGNORE as u,DEFAULT_TEST_INCLUDE as d,renderViteConfig as f,viteConfigObject as p,viteSyncTask as m}from"./packages/vite/src/sync.js";import"./packages/vite/src/index.js";export{u as DEFAULT_LINT_IGNORE,d as DEFAULT_TEST_INCLUDE,e as VP_COMMANDS,n as describeVp,r as hasVp,f as renderViteConfig,i as resolveVp,a as runVp,t as viteCommandName,c as viteCommands,p as viteConfigObject,l as viteProvider,m as viteSyncTask,o as vpVersion,s as which};
+import"node:path";import"node:url";import.meta.url;import{VP_COMMANDS as e,viteCommandName as t}from"./packages/vite/src/commands.js";import{describeVp as n,hasVp as r,resolveVp as i,runVp as a,vpVersion as o,which as s}from"./packages/vite/src/vp.js";import{viteCommands as c}from"./packages/vite/src/cli/index.js";import{DBX_TASKS as l,dbx as u,defineDbxConfig as d,resolveDbx as f,runDbx as p}from"./packages/vite/src/plugin.js";import{viteProvider as m}from"./packages/vite/src/provider.js";import{DEFAULT_LINT_IGNORE as h,DEFAULT_TEST_INCLUDE as g,renderViteConfig as _,viteConfigObject as v,viteSyncTask as y}from"./packages/vite/src/sync.js";import"./packages/vite/src/index.js";export{l as DBX_TASKS,h as DEFAULT_LINT_IGNORE,g as DEFAULT_TEST_INCLUDE,e as VP_COMMANDS,u as dbx,d as defineDbxConfig,n as describeVp,r as hasVp,_ as renderViteConfig,f as resolveDbx,i as resolveVp,p as runDbx,a as runVp,t as viteCommandName,c as viteCommands,v as viteConfigObject,m as viteProvider,y as viteSyncTask,o as vpVersion,s as which};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deltabox/toolchain",
-  "version": "1.0.7",
+  "version": "1.1.21",
   "description": "All-in-one toolchain: scaffold projects, manage templates, configs, tsconfigs, changelogs and builds.",
   "homepage": "https://toolchain.deltabox.studio",
   "author": "Victor Sango <victor@deltabox.studio>",
@@ -48,7 +48,7 @@
   },
   "publishConfig": {
     "access": "public",
-    "provenance": false
+    "provenance": true
   },
   "workspaces": [
     "packages/*",
@@ -65,17 +65,17 @@
   "devDependencies": {
     "@commitlint/cli": "^21.2.2",
     "@commitlint/config-conventional": "^21.2.2",
-    "@deltabox/toolchain-biome": "1.0.7",
-    "@deltabox/toolchain-changelog": "1.0.7",
-    "@deltabox/toolchain-config": "1.0.7",
-    "@deltabox/toolchain-core": "1.0.7",
-    "@deltabox/toolchain-migrate": "1.0.7",
-    "@deltabox/toolchain-project": "1.0.7",
-    "@deltabox/toolchain-shared": "1.0.7",
-    "@deltabox/toolchain-template": "1.0.7",
-    "@deltabox/toolchain-tsconfig": "1.0.7",
-    "@deltabox/toolchain-tsdown": "1.0.7",
-    "@deltabox/toolchain-vite": "1.0.7",
+    "@deltabox/toolchain-biome": "1.1.21",
+    "@deltabox/toolchain-changelog": "1.1.21",
+    "@deltabox/toolchain-config": "1.1.21",
+    "@deltabox/toolchain-core": "1.1.21",
+    "@deltabox/toolchain-migrate": "1.1.21",
+    "@deltabox/toolchain-project": "1.1.21",
+    "@deltabox/toolchain-shared": "1.1.21",
+    "@deltabox/toolchain-template": "1.1.21",
+    "@deltabox/toolchain-tsconfig": "1.1.21",
+    "@deltabox/toolchain-tsdown": "1.1.21",
+    "@deltabox/toolchain-vite": "1.1.21",
     "@types/node": "^22.10.2",
     "@typescript/native-preview": "7.0.0-dev.20260707.2",
     "cross-env": "^10.1.0",