@deltabox/toolchain 0.0.0-stage → 1.1.21

package/dist/packages/core/src/sync.d.ts

@@ -0,0 +1,42 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+import { Replacements } from "../../shared/src/template.js";
+import { ProjectType } from "../../shared/src/config-schema.js";
+import { SyncTask, ToolingConfig } from "../../shared/src/toolchain.js";
+import "../../shared/src/index.js";
+//#region packages/core/src/sync.d.ts
+export interface RunSyncOptions {
+  /** The task list to run. */
+  tasks: SyncTask[];
+  /** The project root. */
+  cwd: string;
+  /** The loaded config. */
+  config: ToolingConfig;
+  /** The resolved replacement tokens. */
+  tokens: Replacements;
+  /** The project kind (resolved from the config/cwd when omitted). */
+  projectType?: ProjectType;
+  /** Dry-run: report drift and exit non-zero without writing. */
+  check?: boolean;
+  /** Suppress logging. */
+  quiet?: boolean;
+  /** Custom logger (default `console.log`). */
+  log?: (message: string) => void;
+}
+export interface SyncResult {
+  /** Paths written (empty in check mode). */
+  written: string[];
+  /** Paths whose generated content differs from disk. */
+  changed: string[];
+  /** Previously-managed paths removed because they are no longer generated. */
+  removed: string[];
+  /** Whether disk already matched the generated output. */
+  upToDate: boolean;
+}
+/**
+ * Run every enabled sync task, writing the managed files and pruning files that
+ * are no longer generated. With `check: true` nothing is written: drift is
+ * reported instead (for CI).
+ */
+export declare function runSync(options: RunSyncOptions): Promise<SyncResult>;
+//#endregion

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

@@ -0,0 +1 @@
+import{default as e}from"node:path";import"node:url";import.meta.url;import{resolveProjectType as t}from"./project-type.js";import{readManifest as n,writeManifest as r}from"./manifest.js";import i from"node:fs";function a(e){return e.replace(/\\/g,`/`)}async function o(o){let{tasks:s,cwd:c,config:l,tokens:u}=o,d=o.quiet?()=>{}:o.log??(e=>console.log(e)),f=o.projectType??t(c,l),p={cwd:c,projectType:f,config:l,tokens:u,log:d},m=l.hooks??{};await m.beforeSync?.(p);let h=s.filter(e=>(!e.projectTypes||e.projectTypes.includes(f))&&(!e.enabled||e.enabled(l)));d(`dbx: running ${h.length} task(s)${o.check?` (check)`:``} [${f}]`);let g=[];for(let e of h){d(`  - ${e.name}`),await m.beforeTask?.({task:e,ctx:p});let t=await e.run(p),n=Array.isArray(t)?t:void 0;n&&g.push(...n),await m.afterTask?.({task:e,ctx:p,...n?{files:n}:{}})}let _=new Map(g.map(e=>[a(e.path),e.content])),v=n(c),y=/* @__PURE__ */ new Set;for(let e of h)for(let t of e.keep??[])y.add(t);let b=e=>{for(let t of y)if(e===t||e.endsWith(`/${t}`)||e.endsWith(t))return!0;return!1},x=[];for(let[t,n]of _){let r=e.resolve(c,t);(i.existsSync(r)?i.readFileSync(r,`utf-8`):void 0)!==n&&x.push(t)}let S=v.files.filter(t=>!_.has(t)&&!b(t)&&i.existsSync(e.resolve(c,t))),C=x.length===0&&S.length===0;if(o.check){if(C)d(`dbx: generated files are in sync.`);else{d(`dbx: generated files are out of date:`);for(let e of x)d(`  M ${e}`);for(let e of S)d(`  D ${e}`);d("Run `dbx sync` to regenerate them.")}let e={written:[],changed:x,removed:S,upToDate:C};return await m.afterSync?.({cwd:c,config:l,result:e}),e}let w=[];for(let[t,n]of _){let r=e.resolve(c,t);i.mkdirSync(e.dirname(r),{recursive:!0}),i.writeFileSync(r,n,`utf-8`),w.push(t)}for(let t of S)i.rmSync(e.resolve(c,t),{force:!0});r(c,[..._.keys()]),d(`dbx: wrote ${w.length}, removed ${S.length} file(s)${x.length?`, updated ${x.length}`:``}.`);let T={written:w,changed:x,removed:S,upToDate:C};return await m.afterSync?.({cwd:c,config:l,result:T}),T}export{o as runSync};

package/dist/packages/core/src/vscode.d.ts

@@ -0,0 +1,27 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+import { ProjectType } from "../../shared/src/config-schema.js";
+import { SyncTask, ToolingConfig } from "../../shared/src/toolchain.js";
+import "../../shared/src/index.js";
+//#region packages/core/src/vscode.d.ts
+export interface VscodeSyncOptions {
+  /**
+   * Settings patches, deep-merged in order (then merged into the consumer's).
+   * A function lets the patches depend on the config (eg. only inject Biome
+   * settings when the `biome` section is enabled).
+   */
+  settings?: Record<string, unknown>[] | ((config: ToolingConfig) => Record<string, unknown>[]);
+  /** Recommended extensions (unioned with the consumer's existing list). */
+  extensions?: string[];
+  /** Whether the task runs (default: always). */
+  enabled?: (config: ToolingConfig) => boolean;
+  /** The project kinds the task applies to (default root + single project). */
+  projectTypes?: ProjectType[];
+}
+/**
+ * The VS Code sync task: merges the given settings/extensions into the
+ * consumer's `.vscode/settings.json` / `.vscode/extensions.json`, preserving
+ * whatever they already have.
+ */
+export declare function vscodeSyncTask(options?: VscodeSyncOptions): SyncTask;
+//#endregion

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

@@ -0,0 +1 @@
+import"node:path";import"node:url";import.meta.url;import{deepMerge as e}from"../../shared/src/object-utils.js";import{mergeJsonAt as t}from"../../shared/src/fs-utils.js";import"../../shared/src/index.js";function n(n={}){return{name:`vscode`,projectTypes:n.projectTypes??[`monorepo-root`,`project`],...n.enabled?{enabled:n.enabled}:{},run:r=>{let i=[],a=(typeof n.settings==`function`?n.settings(r.config):n.settings??[]).reduce((t,n)=>e(t,n),{});return Object.keys(a).length>0&&i.push({path:`.vscode/settings.json`,content:t(r.cwd,`.vscode/settings.json`,a)}),n.extensions?.length&&i.push({path:`.vscode/extensions.json`,content:t(r.cwd,`.vscode/extensions.json`,{recommendations:n.extensions})}),i}}}export{n as vscodeSyncTask};

package/dist/packages/core/src/watch.d.ts

@@ -0,0 +1,17 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+import { RunSyncOptions } from "./sync.js";
+//#region packages/core/src/watch.d.ts
+export interface RunWatchOptions extends Omit<RunSyncOptions, 'check'> {
+  /** The config file to watch (re-runs every task on change). */
+  configPath?: string;
+  /** Debounce window in ms (default 150). */
+  debounce?: number;
+}
+/**
+ * Run one sync, then watch the config file + every task's `watch` globs and
+ * re-run on change. Writing generated files must not re-trigger a run, so a
+ * short quiet window follows each sync.
+ */
+export declare function runWatch(options: RunWatchOptions): Promise<void>;
+//#endregion

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

@@ -0,0 +1 @@
+import{default as e}from"node:path";import"node:url";import.meta.url;import{runSync as t}from"./sync.js";import n from"node:fs";import{Glob as r}from"glob";async function i(i){let{cwd:a,tasks:o}=i,s=i.debounce??150,c=i.quiet?()=>{}:i.log??(e=>console.log(e)),l=0,u,d=!1,f=!1,p=async()=>{if(d)f=!0;else{d=!0;try{await t(i)}finally{d=!1,l=Date.now()+Math.max(s*3,300),f&&(f=!1,m())}}},m=()=>{clearTimeout(u),u=setTimeout(p,s)};await p();let h=/* @__PURE__ */ new Set([a]),g=/* @__PURE__ */ new Set;for(let e of o)for(let t of e.watch??[])g.add(t);for(let t of g)try{let n=new r(t,{cwd:a,dot:!0,ignore:[`**/node_modules/**`]}).walkSync();for(let t of n)h.add(e.dirname(e.resolve(a,t)))}catch{}let _=[],v=e=>{Date.now()<l||(i.config?.hooks?.onChange?.(e?{path:e}:{}),m())};if(i.configPath)try{_.push(n.watch(i.configPath,()=>{c(`config changed; re-syncing`),v(i.configPath)}))}catch{}for(let e of h)try{_.push(n.watch(e,{recursive:!0},(e,t)=>v(t??void 0)))}catch{try{_.push(n.watch(e,(e,t)=>v(t??void 0)))}catch{}}c(`dbx: watching for changes (Ctrl+C to stop)`),await new Promise(e=>{let t=()=>{for(let e of _)e.close();process.off(`SIGINT`,t),process.off(`SIGTERM`,t),e()};process.on(`SIGINT`,t),process.on(`SIGTERM`,t)})}export{i as runWatch};

package/dist/packages/migrate/src/biome.d.ts

@@ -0,0 +1,18 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+import { ToolingMigration } from "./types.js";
+//#region packages/migrate/src/biome.d.ts
+/** The Biome config file names, in priority order. */
+export declare const BIOME_CONFIG_FILES: readonly ['biome.json', 'biome.jsonc'];
+/** The Biome config path in `cwd`, if present. */
+export declare function findBiomeConfig(cwd: string): string | undefined;
+/**
+ * Strip JSONC comments + trailing commas. String-aware, so glob patterns such as
+ * `**\/*\/dist` (which contain `/*`) are never mistaken for comments.
+ */
+export declare function stripJsonc(input: string): string;
+/** Read and parse a JSON/JSONC file (BOM-tolerant). */
+export declare function readJsonc(file: string): Record<string, any>;
+/** Build the Biome -> ox migration. */
+export declare const biomeToOx: ToolingMigration;
+//#endregion

package/dist/packages/migrate/src/biome.js

@@ -0,0 +1,2 @@
+import{default as e}from"node:path";import"node:url";import.meta.url;import{mapBiomeToOxfmt as t}from"./oxfmt-map.js";import{mapBiomeToOxlint as n}from"./oxlint-map.js";import{renderViteTarget as r}from"./vite-target.js";import i from"node:fs";const a=[`biome.json`,`biome.jsonc`];function o(t){for(let n of a){let r=e.join(t,n);if(i.existsSync(r))return r}}function s(e){let t=``,n=!1,r=``;for(let i=0;i<e.length;i++){let a=e[i];if(n)t+=a,a===`\\`?(t+=e[i+1]??``,i++):a===r&&(n=!1);else if(a===`"`||a===`'`)n=!0,r=a,t+=a;else if(a===`/`&&e[i+1]===`/`)for(;i<e.length&&e[i]!==`
+`;)i++;else if(a===`/`&&e[i+1]===`*`){for(i+=2;i<e.length&&(e[i]!==`*`||e[i+1]!==`/`);)i++;i++}else t+=a}return t.replace(/,(\s*[}\]])/g,`$1`)}function c(e){let t=i.readFileSync(e,`utf-8`).replace(/^\uFEFF/,``);return JSON.parse(s(t))}const l={id:`biome-to-ox`,from:`biome`,to:`ox`,description:`Migrate Biome (formatter + organizeImports + linter) to Oxfmt/Oxlint.`,detect:e=>!!o(e),run:async a=>{let s=o(a.cwd);if(!s)throw Error(`biome-to-ox: no biome.json/biome.jsonc found.`);let u=c(s),d=t(u),f=n(u,d.oxfmt.ignorePatterns??[]),p=[...d.unmapped,...f.unmapped],m=[`Source: ${e.basename(s)}.`,`Formatter + organizeImports + linter rules mapped.`];if((a.target??`files`)===`vite`){let e=r(a.cwd,{fmt:d.oxfmt,lint:f.oxlint});return a.write&&i.writeFileSync(e.path,e.content,`utf-8`),{id:l.id,from:`biome`,to:`ox`,written:[e.path],files:[e],oxfmt:d.oxfmt,oxlint:f.oxlint,unmapped:p,notes:[...m,"Folded into vite.config.ts (`fmt` + `lint`)."]}}let h=[[`.oxfmtrc.json`,d.oxfmt],[`.oxlintrc.json`,f.oxlint]].map(([t,n])=>({path:e.join(a.cwd,t),content:`${JSON.stringify(n,null,4)}\n`}));if(a.write)for(let e of h)i.writeFileSync(e.path,e.content,`utf-8`);return{id:l.id,from:`biome`,to:`ox`,written:h.map(e=>e.path),files:h,oxfmt:d.oxfmt,oxlint:f.oxlint,unmapped:p,notes:[...m,"Next: run `oxfmt` to reformat, then drop Biome.","Tip: `--target vite` folds this into vite.config.ts instead."]}}};export{a as BIOME_CONFIG_FILES,l as biomeToOx,o as findBiomeConfig,c as readJsonc,s as stripJsonc};

package/dist/packages/migrate/src/check.d.ts

@@ -0,0 +1,14 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+import { MigrationFile } from "./types.js";
+//#region packages/migrate/src/check.d.ts
+export type FileStatus = 'missing' | 'changed' | 'same';
+export interface FileDiff {
+  path: string;
+  status: FileStatus;
+}
+/** Compare produced files against disk (`missing` / `changed` / `same`). */
+export declare function diffFiles(files: MigrationFile[]): FileDiff[];
+/** Whether any produced file is missing or out of date. */
+export declare function hasPending(diffs: FileDiff[]): boolean;
+//#endregion

package/dist/packages/migrate/src/check.js

@@ -0,0 +1 @@
+import"node:path";import"node:url";import.meta.url;import e from"node:fs";function t(t){return t.map(t=>{if(!e.existsSync(t.path))return{path:t.path,status:`missing`};let n=e.readFileSync(t.path,`utf-8`).replace(/^\uFEFF/,``),r=t.content.replace(/^\uFEFF/,``);return{path:t.path,status:n===r?`same`:`changed`}})}function n(e){return e.some(e=>e.status!==`same`)}export{t as diffFiles,n as hasPending};

package/dist/packages/migrate/src/cli/index.d.ts

@@ -0,0 +1,12 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+import { ToolingCommand } from "../../../shared/src/types.js";
+import "../../../shared/src/index.js";
+//#region packages/migrate/src/cli/index.d.ts
+/**
+ * `dbx migrate` — convert a project's tooling config from another
+ * tool (Biome / ESLint / Prettier / Dprint) to Ox (Oxfmt / Oxlint). Dry-run by
+ * default; pass `--write` to apply, or `--check` for a CI gate.
+ */
+export declare function migrateCommands(): ToolingCommand[];
+//#endregion

package/dist/packages/migrate/src/cli/index.js

@@ -0,0 +1 @@
+import{default as e}from"node:path";import"node:url";import.meta.url;import{diffFiles as t,hasPending as n}from"../check.js";import{detectMigrations as r,listMigrations as i,migrations as a}from"../registry.js";function o(){return[{name:`migrate`,description:`Migrate Biome / ESLint / Prettier / Dprint config to Ox (oxlint + oxfmt).`,options:[{flags:`--from <tool>`,description:`Source tool: biome | eslint | prettier | dprint | all.`},{flags:`--to <tool>`,description:`Target tool (default: ox).`,default:`ox`},{flags:`--cwd <dir>`,description:`Project root (default: cwd).`},{flags:`--write`,description:`Write the files (default: dry-run).`},{flags:`--dry-run`,description:`Do not write anything (default).`},{flags:`--check`,description:`CI: exit non-zero when the ox config is stale.`},{flags:`--target <target>`,description:`files (default) | vite.`},{flags:`--online`,description:`Allow network (e.g. @oxlint/migrate).`},{flags:`--json`,description:`Print the result as JSON.`}],run:async(i,o)=>{let s=i.cwd??o.cwd,c=!!i.check,l=!!i.write&&!i.dryRun&&!c,u=!!i.online,d=i.from,f=i.target??`files`,p=!d||d===`all`?r(s):a().filter(e=>e.from===d);if(p.length===0){console.log(d&&d!==`all`?`dbx: no "${d}" migration is registered.`:`dbx: nothing to migrate (no Biome/ESLint/Prettier/Dprint config detected).`);return}let m=[];for(let e of p)m.push(await e.run({cwd:s,write:l,online:u,target:f}));if(c){let r=m.flatMap(e=>t(e.files??[])),a=r.filter(e=>e.status!==`same`);if(i.json)console.log(JSON.stringify(m,null,4));else if(a.length){for(let t of a)console.log(`dbx: ${t.status}  ${e.relative(s,t.path)||t.path}`);console.log(`dbx: ${a.length} file(s) out of date — run \`migrate --write\` to apply.`)}else console.log(`dbx: up to date.`);n(r)&&(process.exitCode=1)}else if(i.json)console.log(JSON.stringify(m,null,4));else{for(let e of m){console.log(`dbx: ${e.from} -> ${e.to} ${l?`wrote`:`would write`}`);for(let t of e.written)console.log(`  ${l?`+`:`?`} ${t}`);for(let t of e.notes??[])console.log(`  ${t}`);if(e.unmapped?.length){console.log(`  unmapped (${e.unmapped.length}):`);for(let t of e.unmapped.slice(0,25))console.log(`    - ${t.source}: ${t.reason}`)}}l||console.log(`dbx: dry-run — re-run with --write to apply.`)}}},{name:`migrate:list`,description:`List the registered migrations and whether each is detected.`,options:[{flags:`--cwd <dir>`,description:`Project root (default: cwd).`},{flags:`--json`,description:`Print as JSON.`}],run:(e,t)=>{let n=e.cwd??t.cwd,r=i(n);if(e.json)console.log(JSON.stringify(r,null,4));else for(let e of r)console.log(`  ${e.id.padEnd(16)} ${e.from} -> ${e.to}  [${e.detected?`detected`:`not found`}]`),console.log(`    ${e.description}`)}}]}export{o as migrateCommands};

package/dist/packages/migrate/src/dprint.d.ts

@@ -0,0 +1,18 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+import { ToolingMigration } from "./types.js";
+//#region packages/migrate/src/dprint.d.ts
+type Json = Record<string, any>;
+/** Locate a dprint config. */
+export declare function findDprintConfig(cwd: string): {
+  file: string;
+  config: Json;
+} | undefined;
+/** Map a dprint config to Oxfmt options. */
+export declare function mapDprintToOxfmt(dprint: Json): {
+  oxfmt: Json;
+  unmapped: string[];
+};
+export declare const dprintToOx: ToolingMigration;
+//#endregion
+export {};

package/dist/packages/migrate/src/dprint.js

@@ -0,0 +1 @@
+import{default as e}from"node:path";import"node:url";import.meta.url;import{renderViteTarget as t}from"./vite-target.js";import n from"node:fs";const r=[`dprint.json`,`dprint.jsonc`,`.dprint.json`];function i(t){for(let i of r){let r=e.join(t,i);if(!n.existsSync(r))continue;let a=n.readFileSync(r,`utf-8`).replace(/^\uFEFF/,``).replace(/\/\*[\s\S]*?\*\//g,``).replace(/(^|[^:])\/\/.*$/gm,`$1`).replace(/,(\s*[}\]])/g,`$1`);try{return{file:r,config:JSON.parse(a)}}catch{}}}function a(e){let t={},n=e.typescript??{};typeof e.lineWidth==`number`&&(t.printWidth=e.lineWidth),typeof e.indentWidth==`number`&&(t.tabWidth=e.indentWidth),typeof e.useTabs==`boolean`&&(t.useTabs=e.useTabs),(e.newLineKind===`lf`||e.newLineKind===`crlf`)&&(t.endOfLine=e.newLineKind),n.quoteStyle&&(t.singleQuote=String(n.quoteStyle).includes(`Single`)||n.quoteStyle===`alwaysSingle`),n.semiColons&&(t.semi=n.semiColons!==`asi`),n.trailingCommas&&(t.trailingComma=n.trailingCommas===`always`?`all`:n.trailingCommas===`never`?`none`:`es5`);let r=[],i=[`lineWidth`,`indentWidth`,`useTabs`,`newLineKind`,`typescript`,`plugins`];for(let t of Object.keys(e))i.includes(t)||r.push(`dprint section: ${t}`);return Array.isArray(e.plugins)&&e.plugins.length&&r.push(`plugins (Oxfmt has built-in equivalents for common cases)`),{oxfmt:t,unmapped:r}}const o={id:`dprint-to-ox`,from:`dprint`,to:`oxfmt`,description:`Migrate a dprint.json (formatter) to Oxfmt.`,detect:e=>!!i(e),run:async r=>{let o=i(r.cwd);if(!o)throw Error(`dprint-to-ox: no dprint.json found.`);let s=a(o.config),c=s.unmapped.map(e=>({source:e,reason:`no Oxfmt equivalent`})),l=[`Source: ${e.basename(o.file)}.`];if((r.target??`files`)===`vite`){let e=t(r.cwd,{fmt:s.oxfmt});return r.write&&n.writeFileSync(e.path,e.content,`utf-8`),{id:`dprint-to-ox`,from:`dprint`,to:`oxfmt`,written:[e.path],files:[e],oxfmt:s.oxfmt,unmapped:c,notes:[...l,"Folded into vite.config.ts (`fmt`)."]}}let u={path:e.join(r.cwd,`.oxfmtrc.json`),content:`${JSON.stringify(s.oxfmt,null,4)}\n`};return r.write&&n.writeFileSync(u.path,u.content,`utf-8`),{id:`dprint-to-ox`,from:`dprint`,to:`oxfmt`,written:[u.path],files:[u],oxfmt:s.oxfmt,unmapped:c,notes:l}}};export{o as dprintToOx,i as findDprintConfig,a as mapDprintToOxfmt};

package/dist/packages/migrate/src/eslint.d.ts

@@ -0,0 +1,24 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+import { ToolingMigration } from "./types.js";
+//#region packages/migrate/src/eslint.d.ts
+type Json = Record<string, any>;
+/** The ESLint config in `cwd`, preferring JSON (parseable) then JS. */
+export declare function findEslintConfig(cwd: string): {
+  file: string;
+  json: boolean;
+} | undefined;
+/** Map an ESLint rule name to an Oxlint rule name. */
+export declare function mapRuleName(name: string): {
+  name: string;
+  mapped: boolean;
+};
+/**
+ * Evaluate a JS/flat ESLint config with the official `@oxlint/migrate` and read
+ * the `.oxlintrc.json` it writes. Returns `undefined` on failure. Note: the
+ * migrator writes to disk, so callers only run it when writing.
+ */
+export declare function runOxlintMigrate(cwd: string): Promise<Json | undefined>;
+export declare const eslintToOx: ToolingMigration;
+//#endregion
+export {};

package/dist/packages/migrate/src/eslint.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{renderViteTarget as n}from"./vite-target.js";import r from"node:fs";const i=[`.eslintrc.json`,`.eslintrc`],a=[`eslint.config.js`,`eslint.config.mjs`,`eslint.config.cjs`,`eslint.config.ts`,`.eslintrc.js`,`.eslintrc.cjs`];function o(t){for(let n of i){let i=e.join(t,n);if(r.existsSync(i))return{file:i,json:!0}}for(let n of a){let i=e.join(t,n);if(r.existsSync(i))return{file:i,json:!1}}}function s(e){let t=Array.isArray(e)?e[0]:e;return t===2||t===`error`?`error`:t===1||t===`warn`?`warn`:`off`}function c(e){return e.startsWith(`@typescript-eslint/`)?{name:`typescript/${e.slice(19)}`,mapped:!0}:{name:e,mapped:!0}}function l(e,t,n){for(let[r,i]of Object.entries(e??{})){let e=c(r);t[e.name]=s(i),e.mapped||n.push({source:r,reason:`unknown plugin prefix`})}}function u(e,n,r){return new Promise(i=>{let a=t(e,n,{cwd:r,stdio:`inherit`});a.on(`error`,()=>i(1)),a.on(`exit`,e=>i(e??0))})}async function d(t){let n=e.join(t,`.oxlintrc.json`);if(await u(`npx`,[`--yes`,`@oxlint/migrate`],t)===0&&r.existsSync(n))try{return JSON.parse(r.readFileSync(n,`utf-8`).replace(/^\uFEFF/,``))}catch{return}}const f={id:`eslint-to-ox`,from:`eslint`,to:`oxlint`,description:`Migrate ESLint to Oxlint (JSON configs; flat configs via @oxlint/migrate --online).`,detect:e=>!!o(e),run:async t=>{let i=o(t.cwd);if(!i)throw Error(`eslint-to-ox: no ESLint config found.`);let a={},s=[],c=[`Source: ${e.basename(i.file)}.`];if(i.json)l(JSON.parse(r.readFileSync(i.file,`utf-8`).replace(/^\uFEFF/,``)).rules,a,s);else if(t.online&&t.write){let e=await d(t.cwd);e?(l(e.rules,a,s),c.push("Rules evaluated with `@oxlint/migrate` (online).")):c.push("`@oxlint/migrate` did not produce `.oxlintrc.json`; hand-map the rules.")}else t.online?c.push("Flat config: online evaluation runs `@oxlint/migrate`, which writes `.oxlintrc.json` — re-run with `--write`."):c.push("Flat config detected — re-run with `--online --write` to use `@oxlint/migrate`, or hand-map the rules.");let u={$schema:`./node_modules/oxlint/configuration_schema.json`,rules:a};if((t.target??`files`)===`vite`){let e=n(t.cwd,{lint:u});return t.write&&r.writeFileSync(e.path,e.content,`utf-8`),{id:f.id,from:`eslint`,to:`oxlint`,written:[e.path],files:[e],oxlint:u,unmapped:s,notes:[...c,"Folded into vite.config.ts (`lint`)."]}}let p={path:e.join(t.cwd,`.oxlintrc.json`),content:`${JSON.stringify(u,null,4)}\n`};return t.write&&r.writeFileSync(p.path,p.content,`utf-8`),{id:f.id,from:`eslint`,to:`oxlint`,written:[p.path],files:[p],oxlint:u,unmapped:s,notes:c}}};export{f as eslintToOx,o as findEslintConfig,c as mapRuleName,d as runOxlintMigrate};

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

@@ -0,0 +1,14 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+import { MigrateTarget, MigrateTool, MigrationContext, MigrationFile, MigrationResult, ToolingMigration, UnmappedItem } from "./types.js";
+import { BIOME_CONFIG_FILES, biomeToOx, findBiomeConfig, readJsonc, stripJsonc } from "./biome.js";
+import { FileDiff, FileStatus, diffFiles, hasPending } from "./check.js";
+import { migrateCommands } from "./cli/index.js";
+import { dprintToOx, findDprintConfig, mapDprintToOxfmt } from "./dprint.js";
+import { eslintToOx, findEslintConfig, mapRuleName, runOxlintMigrate } from "./eslint.js";
+import { DEFAULT_IGNORE, OxfmtMapping, mapBiomeFormatter, mapBiomeIncludes, mapBiomeToOxfmt, mapOrganizeImports } from "./oxfmt-map.js";
+import { OxlintMapping, RULE_MAP, mapBiomeToOxlint } from "./oxlint-map.js";
+import { findPrettierConfig, mapPrettierToOxfmt, prettierToOx, readPrettierIgnore } from "./prettier.js";
+import { MigrationInfo, detectMigrations, findMigration, listMigrations, migrations, runDetectedMigrations, runMigration } from "./registry.js";
+import { findTopLevelValue, matchBracket, mergeViteConfig, renderViteTarget, serializeTs, writeViteTarget } from "./vite-target.js";
+export { BIOME_CONFIG_FILES, DEFAULT_IGNORE, FileDiff, FileStatus, MigrateTarget, MigrateTool, MigrationContext, MigrationFile, MigrationInfo, MigrationResult, OxfmtMapping, OxlintMapping, RULE_MAP, ToolingMigration, UnmappedItem, biomeToOx, detectMigrations, diffFiles, dprintToOx, eslintToOx, findBiomeConfig, findDprintConfig, findEslintConfig, findMigration, findPrettierConfig, findTopLevelValue, hasPending, listMigrations, mapBiomeFormatter, mapBiomeIncludes, mapBiomeToOxfmt, mapBiomeToOxlint, mapDprintToOxfmt, mapOrganizeImports, mapPrettierToOxfmt, mapRuleName, matchBracket, mergeViteConfig, migrateCommands, migrations, prettierToOx, readJsonc, readPrettierIgnore, renderViteTarget, runDetectedMigrations, runMigration, runOxlintMigrate, serializeTs, stripJsonc, writeViteTarget };

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

@@ -0,0 +1 @@
+import"node:path";import"node:url";import.meta.url;import{diffFiles as e,hasPending as t}from"./check.js";import{DEFAULT_IGNORE as n,mapBiomeFormatter as r,mapBiomeIncludes as i,mapBiomeToOxfmt as a,mapOrganizeImports as o}from"./oxfmt-map.js";import{RULE_MAP as s,mapBiomeToOxlint as c}from"./oxlint-map.js";import{findTopLevelValue as l,matchBracket as u,mergeViteConfig as d,renderViteTarget as f,serializeTs as p,writeViteTarget as m}from"./vite-target.js";import{BIOME_CONFIG_FILES as h,biomeToOx as g,findBiomeConfig as _,readJsonc as v,stripJsonc as y}from"./biome.js";import{dprintToOx as b,findDprintConfig as x,mapDprintToOxfmt as S}from"./dprint.js";import{eslintToOx as C,findEslintConfig as w,mapRuleName as T,runOxlintMigrate as E}from"./eslint.js";import{findPrettierConfig as D,mapPrettierToOxfmt as O,prettierToOx as k,readPrettierIgnore as A}from"./prettier.js";import{detectMigrations as j,findMigration as M,listMigrations as N,migrations as P,runDetectedMigrations as F,runMigration as I}from"./registry.js";import{migrateCommands as L}from"./cli/index.js";export{h as BIOME_CONFIG_FILES,n as DEFAULT_IGNORE,s as RULE_MAP,g as biomeToOx,j as detectMigrations,e as diffFiles,b as dprintToOx,C as eslintToOx,_ as findBiomeConfig,x as findDprintConfig,w as findEslintConfig,M as findMigration,D as findPrettierConfig,l as findTopLevelValue,t as hasPending,N as listMigrations,r as mapBiomeFormatter,i as mapBiomeIncludes,a as mapBiomeToOxfmt,c as mapBiomeToOxlint,S as mapDprintToOxfmt,o as mapOrganizeImports,O as mapPrettierToOxfmt,T as mapRuleName,u as matchBracket,d as mergeViteConfig,L as migrateCommands,P as migrations,k as prettierToOx,v as readJsonc,A as readPrettierIgnore,f as renderViteTarget,F as runDetectedMigrations,I as runMigration,E as runOxlintMigrate,p as serializeTs,y as stripJsonc,m as writeViteTarget};

package/dist/packages/migrate/src/oxfmt-map.d.ts

@@ -0,0 +1,28 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+import { UnmappedItem } from "./types.js";
+//#region packages/migrate/src/oxfmt-map.d.ts
+type Json = Record<string, any>;
+/** Default ignore globs added on top of the migrated negations. */
+export declare const DEFAULT_IGNORE: string[];
+export interface OxfmtMapping {
+  oxfmt: Json;
+  unmapped: UnmappedItem[];
+}
+/** Map `formatter` + `javascript.formatter` to Oxfmt options. */
+export declare function mapBiomeFormatter(biome: Json): OxfmtMapping;
+/** Turn Biome `files.includes` negations into Oxfmt `ignorePatterns`. */
+export declare function mapBiomeIncludes(biome: Json): string[];
+/**
+ * Map `assist.actions.source.organizeImports.options.groups` to Oxfmt
+ * `sortImports`. Aliases become `internalPattern`, other literals become
+ * `customGroups`, and shorthand selectors map through {@link SELECTOR_MAP}.
+ */
+export declare function mapOrganizeImports(groups: unknown): {
+  sortImports: Json;
+  unmapped: UnmappedItem[];
+};
+/** Build the complete Oxfmt config from a Biome config. */
+export declare function mapBiomeToOxfmt(biome: Json): OxfmtMapping;
+//#endregion
+export {};

package/dist/packages/migrate/src/oxfmt-map.js

@@ -0,0 +1 @@
+import"node:path";import"node:url";import.meta.url;const e=[`**/node_modules/**`,`**/dist/**`,`**/.turbo/**`];function t(e){let t=e.formatter??{},n=e.javascript?.formatter??{},r={},i=[];t.indentStyle&&(r.useTabs=t.indentStyle===`tab`),typeof t.indentWidth==`number`&&(r.tabWidth=t.indentWidth),typeof t.lineWidth==`number`&&(r.printWidth=t.lineWidth),t.lineEnding&&t.lineEnding!==`auto`&&(r.endOfLine=t.lineEnding),typeof t.bracketSameLine==`boolean`&&(r.bracketSameLine=t.bracketSameLine),typeof t.bracketSpacing==`boolean`&&(r.bracketSpacing=t.bracketSpacing),t.attributePosition===`multiline`&&(r.singleAttributePerLine=!0),n.quoteStyle&&(r.singleQuote=n.quoteStyle===`single`),n.jsxQuoteStyle&&(r.jsxSingleQuote=n.jsxQuoteStyle===`single`),n.quoteProperties&&(r.quoteProps=n.quoteProperties===`asNeeded`?`as-needed`:`preserve`),n.trailingCommas&&(r.trailingComma=n.trailingCommas),n.semicolons&&(r.semi=n.semicolons===`always`),n.arrowParentheses&&(r.arrowParens=n.arrowParentheses===`always`?`always`:`avoid`);for(let e of[`expand`,`useEditorconfig`,`formatWithErrors`,`jsxQuoteStyle`])e in t&&i.push({source:`formatter.${e}`,reason:`no Oxfmt equivalent`});return{oxfmt:r,unmapped:i}}function n(t){let n=(t.files?.includes??[]).filter(e=>typeof e==`string`&&e.startsWith(`!`)).map(e=>e.slice(1));return[.../* @__PURE__ */ new Set([...e,...n])]}const r={":NODE:":`builtin`,":BUN:":`builtin`,":PACKAGE:":`external`,":ALIAS:":`internal`,":PATH:":[`parent`,`sibling`,`index`]};function i(e){return/^[@~#][\w-]*\/?/.test(e)||e.endsWith(`/**`)}function a(e){let t=[],n=[],a=[],o=/* @__PURE__ */ new Set([`~/`,`@/`]),s=Array.isArray(e)?e:[];for(let e of s){if(e===`:BLANK_LINE:`)continue;let s=Array.isArray(e)?e:[e],c=[];for(let e of s){if(typeof e!=`string`)continue;if(e in r){let t=r[e];if(!t)continue;for(let e of Array.isArray(t)?t:[t])c.push(e);continue}if(e.startsWith(`:`)){t.push({source:`organizeImports ${e}`,reason:`unknown Biome selector`});continue}if(e.startsWith(`!`)){t.push({source:`organizeImports ${e}`,reason:`negated group members are approximated`});continue}if(i(e)){let t=e.replace(/\*+.*$/,``);t&&o.add(t),c.push(`internal`);continue}let n=`custom${a.length}`;a.push({groupName:n,elementNamePattern:[e]}),c.push(n)}let l=[...new Set(c)];l.length&&n.push(l.length===1?l[0]:l)}let c=[];for(let e of n){let t=c[c.length-1];(t===void 0||JSON.stringify(t)!==JSON.stringify(e))&&c.push(e)}let l={groups:c,internalPattern:[...o],newlinesBetween:!0,sortPackageJson:!1};return a.length&&(l.customGroups=a),{sortImports:l,unmapped:t}}function o(e){let r=t(e),i={...r.oxfmt,ignorePatterns:n(e)},o=[...r.unmapped],s=e.assist?.actions?.source?.organizeImports;if(s){let e=s.options?.groups;if(e){let t=a(e);i.sortImports=t.sortImports,o.push(...t.unmapped)}}return{oxfmt:i,unmapped:o}}export{e as DEFAULT_IGNORE,t as mapBiomeFormatter,n as mapBiomeIncludes,o as mapBiomeToOxfmt,a as mapOrganizeImports};

package/dist/packages/migrate/src/oxlint-map.d.ts

@@ -0,0 +1,22 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+import { UnmappedItem } from "./types.js";
+//#region packages/migrate/src/oxlint-map.d.ts
+type Json = Record<string, any>;
+/**
+ * Biome rule path -> Oxlint rule name. `null` means "no known equivalent".
+ * Bare names are core ESLint rules; prefixed names use an Oxlint plugin.
+ */
+export declare const RULE_MAP: Record<string, string | null>;
+export interface OxlintMapping {
+  oxlint: Json;
+  unmapped: UnmappedItem[];
+}
+/**
+ * Build an `.oxlintrc.json` body from a Biome `linter` config. Only rules Biome
+ * explicitly configures are translated (so Oxlint's own defaults apply
+ * elsewhere), plus the migrated `files.includes` negations as `ignorePatterns`.
+ */
+export declare function mapBiomeToOxlint(biome: Json, ignorePatterns: string[]): OxlintMapping;
+//#endregion
+export {};

package/dist/packages/migrate/src/oxlint-map.js

@@ -0,0 +1 @@
+import"node:path";import"node:url";import.meta.url;const e={"a11y.useAltText":`jsx-a11y/alt-text`,"a11y.useButtonType":`react/button-has-type`,"a11y.useKeyWithClickEvents":`jsx-a11y/click-events-have-key-events`,"a11y.noSvgWithoutTitle":null,"a11y.useAriaPropsForRole":null,"a11y.useFocusableInteractive":null,"a11y.useSemanticElements":`jsx-a11y/prefer-tag-over-role`,"a11y.noStaticElementInteractions":null,"a11y.noLabelWithoutControl":`jsx-a11y/label-has-associated-control`,"complexity.noBannedTypes":`typescript/no-empty-object-type`,"complexity.noUselessEmptyExport":`typescript/no-useless-empty-export`,"complexity.noUselessEscapeInRegex":`no-useless-escape`,"complexity.noImportantStyles":null,"complexity.noStaticOnlyClass":`unicorn/no-static-only-class`,"correctness.noConstantCondition":`no-constant-condition`,"correctness.noInnerDeclarations":`no-inner-declarations`,"correctness.noUnusedVariables":`no-unused-vars`,"correctness.noUnusedFunctionParameters":`no-unused-vars`,"correctness.noUnusedImports":`no-unused-vars`,"correctness.noSwitchDeclarations":`no-case-declarations`,"correctness.useExhaustiveDependencies":`react-hooks/exhaustive-deps`,"style.useExponentiationOperator":`prefer-exponentiation-operator`,"style.noNonNullAssertion":`typescript/no-non-null-assertion`,"style.useNodejsImportProtocol":`unicorn/prefer-node-protocol`,"style.useTemplate":`prefer-template`,"suspicious.noDoubleEquals":`eqeqeq`,"suspicious.noExplicitAny":`typescript/no-explicit-any`,"suspicious.noAssignInExpressions":`no-return-assign`,"suspicious.noUselessEscapeInString":`no-useless-escape`,"suspicious.noImplicitAnyLet":null,"suspicious.noUnknownAtRules":null,"performance.noAccumulatingSpread":`oxc/no-accumulating-spread`};function t(e){if(typeof e==`string`)return e;if(e&&typeof e==`object`)return e.level}function n(e){if(e===`error`)return`error`;if(e===`warn`)return`warn`;if(e===`info`||e===`off`)return`off`}function r(e){let t=[];for(let[n,r]of Object.entries(e??{}))if(r&&typeof r==`object`)for(let[e,i]of Object.entries(r))t.push([`${n}.${e}`,i]);return t}function i(i,a){let o={},s=[];for(let[a,c]of r(i.linter?.rules??{})){let r=n(t(c));if(!r)continue;let i=e[a];i===void 0?s.push({source:`linter.rules.${a}`,reason:`not in the Biome->Oxlint map`}):i===null?s.push({source:`linter.rules.${a}`,reason:`no Oxlint equivalent`}):o[i]=r}return{oxlint:{$schema:`./node_modules/oxlint/configuration_schema.json`,rules:o,ignorePatterns:a},unmapped:s}}export{e as RULE_MAP,i as mapBiomeToOxlint};

package/dist/packages/migrate/src/prettier.d.ts

@@ -0,0 +1,20 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+import { ToolingMigration } from "./types.js";
+//#region packages/migrate/src/prettier.d.ts
+type Json = Record<string, any>;
+/** Locate a Prettier config (JSON files or the `prettier` package.json field). */
+export declare function findPrettierConfig(cwd: string): {
+  file: string;
+  config: Json;
+} | undefined;
+/** `.prettierignore` globs. */
+export declare function readPrettierIgnore(cwd: string): string[];
+/** Map a Prettier config to Oxfmt options. */
+export declare function mapPrettierToOxfmt(prettier: Json): {
+  oxfmt: Json;
+  unmapped: string[];
+};
+export declare const prettierToOx: ToolingMigration;
+//#endregion
+export {};

package/dist/packages/migrate/src/prettier.js

@@ -0,0 +1,2 @@
+import{default as e}from"node:path";import"node:url";import.meta.url;import{renderViteTarget as t}from"./vite-target.js";import n from"node:fs";const r=[`.prettierrc`,`.prettierrc.json`,`.prettierrc.jsonc`,`prettier.config.json`],i=[`printWidth`,`tabWidth`,`useTabs`,`semi`,`singleQuote`,`jsxSingleQuote`,`quoteProps`,`trailingComma`,`bracketSpacing`,`bracketSameLine`,`arrowParens`,`endOfLine`,`singleAttributePerLine`,`htmlWhitespaceSensitivity`,`vueIndentScriptAndStyle`];function a(t){for(let i of r){let r=e.join(t,i);if(n.existsSync(r)){let e=n.readFileSync(r,`utf-8`).replace(/^\uFEFF/,``);try{return{file:r,config:JSON.parse(e)}}catch{}}}let i=e.join(t,`package.json`);if(n.existsSync(i))try{let e=JSON.parse(n.readFileSync(i,`utf-8`));if(e.prettier&&typeof e.prettier==`object`)return{file:i,config:e.prettier}}catch{}}function o(t){let r=e.join(t,`.prettierignore`);return n.existsSync(r)?n.readFileSync(r,`utf-8`).split(`
+`).map(e=>e.trim()).filter(e=>e&&!e.startsWith(`#`)):[]}function s(e){let t={},n=[];for(let n of i)n in e&&(t[n]=e[n]);let r=Array.isArray(e.plugins)?e.plugins:[];for(let e of r)e.includes(`tailwindcss`)?t.sortTailwindcss=!0:e.includes(`packagejson`)?t.sortPackageJson=!0:n.push(`plugin: ${e}`);for(let t of Object.keys(e))!i.includes(t)&&t!==`plugins`&&t!==`overrides`&&n.push(`option: ${t}`),t===`overrides`&&n.push("option: overrides (convert to Oxfmt `overrides` manually)");return{oxfmt:t,unmapped:n}}const c={id:`prettier-to-ox`,from:`prettier`,to:`oxfmt`,description:`Migrate a Prettier config to Oxfmt (.oxfmtrc.json).`,detect:e=>!!a(e),run:async r=>{let i=a(r.cwd);if(!i)throw Error(`prettier-to-ox: no Prettier config found.`);let l=s(i.config),u=o(r.cwd);u.length&&(l.oxfmt.ignorePatterns=u);let d=l.unmapped.map(e=>({source:e,reason:`no Oxfmt equivalent`}));if((r.target??`files`)===`vite`){let a=t(r.cwd,{fmt:l.oxfmt});return r.write&&n.writeFileSync(a.path,a.content,`utf-8`),{id:c.id,from:`prettier`,to:`oxfmt`,written:[a.path],files:[a],oxfmt:l.oxfmt,unmapped:d,notes:[`Source: ${e.basename(i.file)}.`,"Folded into vite.config.ts (`fmt`)."]}}let f={path:e.join(r.cwd,`.oxfmtrc.json`),content:`${JSON.stringify(l.oxfmt,null,4)}\n`};return r.write&&n.writeFileSync(f.path,f.content,`utf-8`),{id:c.id,from:`prettier`,to:`oxfmt`,written:[f.path],files:[f],oxfmt:l.oxfmt,unmapped:d,notes:[`Source: ${e.basename(i.file)}.`]}}};export{a as findPrettierConfig,s as mapPrettierToOxfmt,c as prettierToOx,o as readPrettierIgnore};

package/dist/packages/migrate/src/registry.d.ts

@@ -0,0 +1,26 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+import { MigrateTool, MigrationContext, MigrationResult, ToolingMigration } from "./types.js";
+//#region packages/migrate/src/registry.d.ts
+/** Every registered migration. */
+export declare function migrations(): ToolingMigration[];
+/** A migration summary for listings. */
+export interface MigrationInfo {
+  id: string;
+  from: MigrateTool;
+  to: MigrateTool;
+  description: string;
+  /** Whether the source config is present in the project. */
+  detected: boolean;
+}
+/** Describe every migration, flagging which are detected in `cwd`. */
+export declare function listMigrations(cwd: string): MigrationInfo[];
+/** The migrations whose source config is present in `cwd`. */
+export declare function detectMigrations(cwd: string): ToolingMigration[];
+/** Find a migration by id, or by source tool. */
+export declare function findMigration(idOrFrom: string): ToolingMigration | undefined;
+/** Run one migration by id (or source tool name). */
+export declare function runMigration(idOrFrom: string, ctx: MigrationContext): Promise<MigrationResult>;
+/** Run every migration detected in `ctx.cwd`. */
+export declare function runDetectedMigrations(ctx: MigrationContext): Promise<MigrationResult[]>;
+//#endregion

package/dist/packages/migrate/src/registry.js

@@ -0,0 +1 @@
+import"node:path";import"node:url";import.meta.url;import{biomeToOx as e}from"./biome.js";import{dprintToOx as t}from"./dprint.js";import{eslintToOx as n}from"./eslint.js";import{prettierToOx as r}from"./prettier.js";function i(){return[e,r,t,n]}function a(e){return i().map(t=>({id:t.id,from:t.from,to:t.to,description:t.description,detected:t.detect(e)}))}function o(e){return i().filter(t=>t.detect(e))}function s(e){return i().find(t=>t.id===e||t.from===e)}async function c(e,t){let n=s(e);if(!n)throw Error(`Unknown migration "${e}".`);return n.run(t)}async function l(e){let t=[];for(let n of o(e.cwd))t.push(await n.run(e));return t}export{o as detectMigrations,s as findMigration,a as listMigrations,i as migrations,l as runDetectedMigrations,c as runMigration};

package/dist/packages/migrate/src/types.d.ts

@@ -0,0 +1,75 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+//#region packages/migrate/src/types.d.ts
+/**
+ * The migration model.
+ *
+ * A *migration* converts a project's tooling config from a source tool (Biome,
+ * ESLint, Prettier, ...) to a target tool (Oxfmt / Oxlint, ie. "ox"). Migrations
+ * are pluggable: registering one here exposes it through the `dbx
+ * migrate` CLI, the programmatic API and (over JSON) the VS Code extension.
+ */
+/** A tool a migration can read from or write to. */
+export type MigrateTool = 'biome' | 'eslint' | 'prettier' | 'dprint' | 'oxfmt' | 'oxlint' | 'ox';
+/** Where a migration writes its result. */
+export type MigrateTarget = 'files' | 'vite';
+export interface MigrationContext {
+  /** The project root. */
+  cwd: string;
+  /**
+   * `files` (default) writes `.oxfmtrc.json` / `.oxlintrc.json`; `vite` is
+   * reserved for folding the config into `vite.config.ts`.
+   */
+  target?: MigrateTarget;
+  /** Write the result (default false = dry-run). */
+  write?: boolean;
+  /** Allow network (eg. npx-based migrators). Default false. */
+  online?: boolean;
+}
+/** A field that could not be mapped faithfully. */
+export interface UnmappedItem {
+  /** The source key/rule/option. */
+  source: string;
+  /** Why it could not be mapped. */
+  reason: string;
+}
+/** A file a migration produces (or would produce) with its exact content. */
+export interface MigrationFile {
+  /** Absolute path. */
+  path: string;
+  /** The exact file content. */
+  content: string;
+}
+export interface MigrationResult {
+  id: string;
+  from: MigrateTool;
+  to: MigrateTool;
+  /** Files written, or that would be written (dry-run). */
+  written: string[];
+  /** The produced files with content (drives `--check`). */
+  files?: MigrationFile[];
+  /** The oxfmt config produced (present for formatter migrations). */
+  oxfmt?: Record<string, unknown>;
+  /** The oxlint config produced (present for linter migrations). */
+  oxlint?: Record<string, unknown>;
+  /** Source items with no target equivalent. */
+  unmapped?: UnmappedItem[];
+  /** Human-readable notes. */
+  notes?: string[];
+}
+/** A pluggable config migration. */
+export interface ToolingMigration {
+  /** Stable id, eg. `biome-to-ox`. */
+  id: string;
+  /** The source tool. */
+  from: MigrateTool;
+  /** The target tool. */
+  to: MigrateTool;
+  /** Human-readable description. */
+  description: string;
+  /** Whether the source config is present in `cwd`. */
+  detect: (cwd: string) => boolean;
+  /** Run the migration. */
+  run: (ctx: MigrationContext) => Promise<MigrationResult>;
+}
+//#endregion

package/dist/packages/migrate/src/vite-target.d.ts

@@ -0,0 +1,31 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+import { MigrationFile } from "./types.js";
+//#region packages/migrate/src/vite-target.d.ts
+type Json = Record<string, unknown>;
+/** Serialize a JSON-ish value as TypeScript source (single quotes, 4-space). */
+export declare function serializeTs(value: unknown, indent?: number): string;
+/** The index just past the `}`/`]` matching the opening bracket at `open`. */
+export declare function matchBracket(source: string, open: number): number;
+/** The `[valueStart, valueEnd)` range of a top-level `key:` inside an object. */
+export declare function findTopLevelValue(source: string, open: number, close: number, key: string): [number, number] | undefined;
+/**
+ * Insert or replace `fmt`/`lint` inside an existing `vite.config.ts`, or render
+ * a fresh one when none exists.
+ */
+export declare function mergeViteConfig(existing: string | undefined, sections: {
+  fmt?: Json;
+  lint?: Json;
+}): string;
+/** The merged `vite.config.ts` for `cwd` (path + content), without writing it. */
+export declare function renderViteTarget(cwd: string, sections: {
+  fmt?: Json;
+  lint?: Json;
+}): MigrationFile;
+/** Write the merged config to `<cwd>/vite.config.ts` and return its path. */
+export declare function writeViteTarget(cwd: string, sections: {
+  fmt?: Json;
+  lint?: Json;
+}, write: boolean): string;
+//#endregion
+export {};

package/dist/packages/migrate/src/vite-target.js

@@ -0,0 +1,5 @@
+import{default as e}from"node:path";import"node:url";import.meta.url;import t from"node:fs";const n=/^[A-Za-z_$][\w$]*$/;function r(e,t=0){let i=`    `.repeat(t),a=`    `.repeat(t+1);if(e==null)return`null`;if(typeof e==`string`)return`'${e.replace(/\\/g,`\\\\`).replace(/'/g,`\\'`)}'`;if(typeof e==`number`||typeof e==`boolean`)return String(e);if(Array.isArray(e))return e.length===0?`[]`:`[\n${e.map(e=>`${a}${r(e,t+1)}`).join(`,
+`)},\n${i}]`;if(typeof e==`object`){let o=Object.entries(e);return o.length===0?`{}`:`{\n${o.map(([e,i])=>{let o=n.test(e)?e:JSON.stringify(e);return`${a}${o}: ${r(i,t+1)}`}).join(`,
+`)},\n${i}}`}return JSON.stringify(e)}function i(e,t){let n=e[t],r=e[t+1];if(n===`/`&&r===`/`){for(;t<e.length&&e[t]!==`
+`;)t++;return t}if(n===`/`&&r===`*`){for(t+=2;t<e.length&&(e[t]!==`*`||e[t+1]!==`/`);)t++;return t+2}if(n===`"`||n===`'`||n==="`"){let r=n;for(t++;t<e.length&&e[t]!==r;)e[t]===`\\`&&t++,t++;return t+1}return t}function a(e,t){let n={"{":`}`,"[":`]`}[e[t]];if(!n)return-1;let r=0;for(let a=t;a<e.length;a++){let o=i(e,a);if(o!==a)a=o-1;else if(e[a]===e[t])r++;else if(e[a]===n&&(r--,r===0))return a+1}return-1}function o(e,t,r,o){let s=1;for(let c=t+1;c<r;c++){let t=i(e,c);if(t!==c){c=t-1;continue}let l=e[c];if(l===`{`||l===`[`)s++;else if(l===`}`||l===`]`)s--;else if(s===1&&n.test(l)){let t=c;for(;t<r&&/[\w$]/.test(e[t]);)t++;let n=e.slice(c,t),i=t;for(;i<r&&/\s/.test(e[i]);)i++;if(n===o&&e[i]===`:`){let t=i+1;for(;t<r&&/\s/.test(e[t]);)t++;let n=e[t];if(n===`{`||n===`[`)return[t,a(e,t)];let o=t;for(;o<r&&e[o]!==`,`;)o++;return[t,o]}c=t-1}}}function s(e,t){let n=Object.entries(t).filter(([,e])=>e!==void 0);if(!e)return`import { defineConfig } from 'vite-plus';\n\nexport default defineConfig({\n${n.map(([e,t])=>`    ${e}: ${r(t,1)},`).join(`
+`)}\n});\n`;let i=e,s=i.match(/defineConfig\s*\(\s*\{/);if(!s||s.index===void 0)return i;for(let[e,t]of n){let n=i.match(/defineConfig\s*\(\s*\{/);if(!n||n.index===void 0)break;let s=i.indexOf(`{`,n.index),c=a(i,s);if(c===-1)break;let l=r(t,1),u=o(i,s,c,e);i=u?`${i.slice(0,u[0])}${l}${i.slice(u[1])}`:`${i.slice(0,s+1)}\n    ${e}: ${l},${i.slice(s+1)}`}return i}function c(n,r){let i=e.join(n,`vite.config.ts`);return{path:i,content:s(t.existsSync(i)?t.readFileSync(i,`utf-8`):void 0,r)}}function l(e,n,r){let i=c(e,n);return r&&t.writeFileSync(i.path,i.content,`utf-8`),i.path}export{o as findTopLevelValue,a as matchBracket,s as mergeViteConfig,c as renderViteTarget,r as serializeTs,l as writeViteTarget};

package/dist/packages/project/src/cli/index.d.ts

@@ -0,0 +1,8 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+import { ToolingCommand } from "../../../shared/src/types.js";
+import "../../../shared/src/index.js";
+//#region packages/project/src/cli/index.d.ts
+/** Build the project scaffolding commands. */
+export declare function projectCommands(): ToolingCommand[];
+//#endregion

package/dist/packages/project/src/cli/index.js

@@ -0,0 +1 @@
+import"node:path";import"node:url";import.meta.url;import{createMonorepoRootFiles as e,createRootProjectFiles as t,createWorkspaceFiles as n,writeGeneratedFiles as r}from"../typescript.js";import{generateProjectConfigs as i}from"../config.js";const a=[{flags:`--no-config`,description:`Skip the dbx.config.ts file.`},{flags:`--type <type>`,description:`Project type: project | monorepo-root | monorepo-workspace.`}];function o(){return[{name:`project:init`,description:`Scaffold a single-package TypeScript project.`,options:[{flags:`-n, --name <name>`,description:`Project name.`},{flags:`-s, --scope <scope>`,description:`npm scope, eg. @acme.`},{flags:`-o, --out <dir>`,description:`Output directory (default: cwd).`},...a],run:(e,n)=>{let i=String(e.name??n.config.project?.name??`app`),a=t({name:i,...e.scope?{scope:e.scope}:{},type:e.type??`project`,includeConfig:e.config??!0}),o=r(a,e.out??n.cwd);for(let e of o)console.log(`Created ${e}`)}},{name:`project:init:monorepo`,description:`Scaffold a monorepo root + one example workspace.`,options:[{flags:`-n, --name <name>`,description:`Project name.`},{flags:`-s, --scope <scope>`,description:`npm scope, eg. @acme.`},{flags:`-o, --out <dir>`,description:`Output directory (default: cwd).`},...a],run:(t,i)=>{let a=String(t.name??i.config.project?.name??`monorepo`),o=t.scope??i.config.project?.scope??`@${a}`,s=t.out??i.cwd,c=t.config??!0,l=t.type??`monorepo-root`,u=e({name:a,scope:o,type:l,includeConfig:c,workspaces:[{alias:`core`,dir:`packages/core`}]});u.push(...n({name:a,scope:o,wsName:`core`,wsDir:`packages/core`,type:`monorepo-workspace`,includeConfig:c}).map(e=>({...e,path:`packages/core/${e.path}`})));let d=r(u,s);for(let e of d)console.log(`Created ${e}`)}},{name:`project:init:workspace`,description:`Scaffold a monorepo workspace package into an existing monorepo root.`,options:[{flags:`-n, --name <name>`,description:`Workspace package name (unscoped).`},{flags:`-s, --scope <scope>`,description:`npm scope, eg. @acme.`},{flags:`-r, --root <dir>`,description:`Monorepo root (default: cwd).`},{flags:`-d, --dir <dir>`,description:`Workspace dir relative to the root (default: packages/<name>).`},...a],run:(e,t)=>{let i=e.root??t.cwd,a=String(e.name??`workspace`),o=e.scope??t.config.project?.scope??`@${a}`,s=(e.dir??`packages/${a}`).replace(/\\/g,`/`).replace(/\/+$/,``),c=e.config??!0,l=e.type??`monorepo-workspace`,u=n({name:a,scope:o,wsName:a,wsDir:s,type:l,includeConfig:c}).map(e=>({...e,path:`${s}/${e.path}`})),d=r(u,i);for(let e of d)console.log(`Created ${e}`)}},{name:`project:config`,description:`Generate dbx.config.ts for existing projects that are missing one.`,options:[{flags:`--cwd <dir>`,description:`Root to scan (default: cwd).`},{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:`--type <type>`,description:`Force a project type for every config.`},{flags:`--force`,description:`Overwrite configs that already exist.`},{flags:`--dry-run`,description:`Report what would be written without writing.`},{flags:`--json`,description:`Print the result as JSON.`}],run:(e,t)=>{let n=e.cwd??t.cwd,r=i({root:n,...e.include?{include:e.include}:{},...e.exclude?{exclude:e.exclude}:{},...e.type?{type:e.type}:{},force:!!e.force,dryRun:!!e.dryRun});if(e.json){console.log(JSON.stringify(r,null,4));return}let a=r.dryRun?`would create`:`created`;console.log(`dbx: ${a} ${r.created.length} config(s), skipped ${r.skipped.length}.`);for(let e of r.configs)e.created&&console.log(`  + ${e.rel===`.`?`dbx.config.ts`:`${e.rel}/dbx.config.ts`}  [${e.type}]`)}}]}export{o as projectCommands};

package/dist/packages/project/src/config.d.ts

@@ -0,0 +1,55 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+import { ProjectType } from "../../shared/src/config-schema.js";
+import "../../shared/src/index.js";
+//#region packages/project/src/config.d.ts
+/** The file name a generated dbx config uses. */
+export declare const GENERATED_CONFIG_FILENAME = "dbx.config.ts";
+export interface GenerateProjectConfigsOptions {
+  /** Root to scan for projects. */
+  root: string;
+  /** Keep only projects matching one of these patterns (glob or substring). */
+  include?: string[];
+  /** Drop projects matching any of these patterns (glob or substring). */
+  exclude?: string[];
+  /** Force a project type instead of detecting it. */
+  type?: ProjectType;
+  /** Overwrite existing config files (default: skip projects that have one). */
+  force?: boolean;
+  /** Maximum directory depth to scan (default 5). */
+  maxDepth?: number;
+  /** Report what would be written without writing anything. */
+  dryRun?: boolean;
+}
+/** One project considered for config generation. */
+export interface GeneratedProjectConfig {
+  /** Absolute project directory. */
+  dir: string;
+  /** Directory relative to the root (posix). */
+  rel: string;
+  /** Package name when available. */
+  name?: string;
+  /** The resolved project type. */
+  type: ProjectType;
+  /** The config file path (absolute). */
+  configPath: string;
+  /** Whether the config was (or would be) written. */
+  created: boolean;
+  /** Why the project was skipped, when it was. */
+  skipped?: string;
+}
+export interface GenerateProjectConfigsResult {
+  configs: GeneratedProjectConfig[];
+  /** Project dirs whose config was (or would be) written. */
+  created: string[];
+  /** Project dirs skipped (already have a config). */
+  skipped: string[];
+  dryRun: boolean;
+}
+/**
+ * Generate a `dbx.config.ts` for every discovered project that is missing one
+ * (unless `force`). The project type is detected from the filesystem unless
+ * overridden. Returns the configs written (or that would be).
+ */
+export declare function generateProjectConfigs(options: GenerateProjectConfigsOptions): GenerateProjectConfigsResult;
+//#endregion

package/dist/packages/project/src/config.js

@@ -0,0 +1 @@
+import{default as e}from"node:path";import"node:url";import.meta.url;import{readJsonAt as t}from"../../shared/src/fs-utils.js";import"../../shared/src/index.js";import{detectProjectType as n}from"../../core/src/project-type.js";import{selectProjects as r}from"../../core/src/select.js";import"../../core/src/index.js";import{renderToolingConfig as i}from"./typescript.js";import a from"node:fs";const o=`dbx.config.ts`;function s(t,n){if(!t)return{name:e.basename(n)};let r=t.match(/^(@[^/]+)\/(.+)$/);return r?.[1]&&r[2]?{name:r[2],scope:r[1]}:{name:t}}function c(c){let l=c.dryRun??!1,u=c.force??!1,d=r({root:c.root,...c.include?{include:c.include}:{},...c.exclude?{exclude:c.exclude}:{},...c.maxDepth===void 0?{}:{maxDepth:c.maxDepth}}),f=[],p=[],m=[];for(let r of d){let d=e.join(r.dir,o);if((r.hasConfig||a.existsSync(d))&&!u){m.push(r.rel),f.push({dir:r.dir,rel:r.rel,...r.name?{name:r.name}:{},type:c.type??n(r.dir),configPath:d,created:!1,skipped:`has config`});continue}let h=c.type??n(r.dir),g=t(r.dir,`package.json`),{name:_,scope:v}=s(r.name??g?.name,r.dir),y=i({name:_,...v?{scope:v}:{},type:h});l||a.writeFileSync(d,y,`utf-8`),p.push(r.rel),f.push({dir:r.dir,rel:r.rel,...r.name?{name:r.name}:{},type:h,configPath:d,created:!0})}return{configs:f,created:p,skipped:m,dryRun:l}}export{o as GENERATED_CONFIG_FILENAME,c as generateProjectConfigs};

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

@@ -0,0 +1,10 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+import { projectCommands } from "./cli/index.js";
+import { GENERATED_CONFIG_FILENAME, GenerateProjectConfigsOptions, GenerateProjectConfigsResult, GeneratedProjectConfig, generateProjectConfigs } from "./config.js";
+import { MonorepoRootContext, ProjectContext, WorkspaceContext, createMonorepoRootFiles, createRootProjectFiles, createWorkspaceFiles, renderGitignore, renderToolingConfig, renderTurboJson, renderWorkspaceTsconfig, writeGeneratedFiles } from "./typescript.js";
+declare namespace index_d_exports {
+  export { GENERATED_CONFIG_FILENAME, GenerateProjectConfigsOptions, GenerateProjectConfigsResult, GeneratedProjectConfig, MonorepoRootContext, ProjectContext, WorkspaceContext, createMonorepoRootFiles, createRootProjectFiles, createWorkspaceFiles, generateProjectConfigs, projectCommands, renderGitignore, renderToolingConfig, renderTurboJson, renderWorkspaceTsconfig, writeGeneratedFiles };
+}
+//#endregion
+export { GENERATED_CONFIG_FILENAME, GenerateProjectConfigsOptions, GenerateProjectConfigsResult, GeneratedProjectConfig, MonorepoRootContext, ProjectContext, WorkspaceContext, createMonorepoRootFiles, createRootProjectFiles, createWorkspaceFiles, generateProjectConfigs, index_d_exports, projectCommands, renderGitignore, renderToolingConfig, renderTurboJson, renderWorkspaceTsconfig, writeGeneratedFiles };

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

@@ -0,0 +1 @@
+import"node:path";import"node:url";import.meta.url;import{__exportAll as e}from"../../../_virtual/_rolldown/runtime.js";import{createMonorepoRootFiles as t,createRootProjectFiles as n,createWorkspaceFiles as r,renderGitignore as i,renderToolingConfig as a,renderTurboJson as o,renderWorkspaceTsconfig as s,writeGeneratedFiles as c}from"./typescript.js";import{GENERATED_CONFIG_FILENAME as l,generateProjectConfigs as u}from"./config.js";import{projectCommands as d}from"./cli/index.js";var f=/* @__PURE__ */ e({GENERATED_CONFIG_FILENAME:()=>l,createMonorepoRootFiles:()=>t,createRootProjectFiles:()=>n,createWorkspaceFiles:()=>r,generateProjectConfigs:()=>u,projectCommands:()=>d,renderGitignore:()=>i,renderToolingConfig:()=>a,renderTurboJson:()=>o,renderWorkspaceTsconfig:()=>s,writeGeneratedFiles:()=>c});export{l as GENERATED_CONFIG_FILENAME,t as createMonorepoRootFiles,n as createRootProjectFiles,r as createWorkspaceFiles,u as generateProjectConfigs,d as projectCommands,i as renderGitignore,a as renderToolingConfig,o as renderTurboJson,s as renderWorkspaceTsconfig,f as src_exports,c as writeGeneratedFiles};