@deltabox/toolchain 0.0.0-stage → 1.0.7

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};

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

@@ -0,0 +1,66 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+import { ProjectType } from "../../shared/src/config-schema.js";
+import { GeneratedFile } from "../../shared/src/types.js";
+import "../../shared/src/index.js";
+import { MonorepoWorkspace } from "../../tsconfig/src/templates.js";
+import "../../tsconfig/src/index.js";
+//#region packages/project/src/typescript.d.ts
+/** The replacement values a project scaffold understands. */
+export interface ProjectContext {
+  /** The project/package name (unscoped). */
+  name: string;
+  /** The npm scope, eg. `@acme`. */
+  scope?: string;
+  /** Package author. */
+  author?: string;
+  /** SPDX license id. */
+  license?: string;
+  /** Repository URL. */
+  repoUrl?: string;
+  /** Node engine range. */
+  nodeVersion?: string;
+  /** Yarn version. */
+  yarnVersion?: string;
+  /** Package manager name. */
+  packageManager?: string;
+  /** The project kind written into the scaffolded `dbx.config.ts`. */
+  type?: ProjectType;
+  /** Write a `dbx.config.ts` (default true). */
+  includeConfig?: boolean;
+}
+/**
+ * Render a `dbx.config.ts` scaffold (toolchain settings under `toolchain`). The
+ * `project.type` lets the sync know whether the folder is a monorepo root, a
+ * workspace, or a single project.
+ */
+export declare function renderToolingConfig(ctx: ProjectContext & {
+  type: ProjectType;
+}): string;
+/** A minimal tsconfig.json that extends the default template. */
+export declare function renderWorkspaceTsconfig(composite?: boolean): string;
+/** Files for a single-package TypeScript project (tsconfig + tooling). */
+export declare function createRootProjectFiles(ctx: ProjectContext): GeneratedFile[];
+export interface MonorepoRootContext extends ProjectContext {
+  /** The workspaces to wire into the monorepo tsconfig. */
+  workspaces: MonorepoWorkspace[];
+  /** The workspace globs (default `['packages/*']`). */
+  workspaceGlobs?: string[];
+}
+/** Files for a monorepo root (workspaces + turbo + monorepo tsconfig). */
+export declare function createMonorepoRootFiles(ctx: MonorepoRootContext): GeneratedFile[];
+export interface WorkspaceContext extends ProjectContext {
+  /** The workspace name (unscoped), eg. `core`. */
+  wsName: string;
+  /** The workspace directory relative to the root, eg. `packages/core`. */
+  wsDir: string;
+}
+/** Files for a monorepo workspace package. */
+export declare function createWorkspaceFiles(ctx: WorkspaceContext): GeneratedFile[];
+/** The default monorepo turbo pipeline. */
+export declare function renderTurboJson(): string;
+/** A generic `.gitignore`. */
+export declare function renderGitignore(): string;
+/** Write generated files under `cwd`, creating directories as needed. */
+export declare function writeGeneratedFiles(files: GeneratedFile[], cwd?: string): string[];
+//#endregion

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

@@ -0,0 +1,22 @@
+import{default as e}from"node:path";import"node:url";import.meta.url;import{renderBiomeJson as t}from"../../biome/src/index.js";import{renderMonorepoTsconfig as n,renderTsconfigBase as r,renderTsconfigBuild as i,renderTsconfigDefault as a}from"../../tsconfig/src/templates.js";import"../../tsconfig/src/index.js";import o from"node:fs";function s(e){return{...e}}const c=(e,t=4)=>`${JSON.stringify(e,null,t)}\n`;function l(e){let t=[[`type`,e.type],[`name`,e.name]];e.scope&&t.push([`scope`,e.scope]),e.author&&t.push([`author`,e.author]),e.license&&t.push([`license`,e.license]),e.repoUrl&&t.push([`repo`,e.repoUrl]),t.push([`nodeVersion`,e.nodeVersion??`22`]),t.push([`packageManager`,e.packageManager??`yarn`]),e.yarnVersion&&t.push([`packageManagerVersion`,e.yarnVersion]);let n=t.map(([e,t])=>`            ${e}: ${JSON.stringify(t)},`).join(`
+`),r=[];return(e.type===`monorepo-root`||e.type===`project`)&&r.push(`        changelog: true,`),r.push(`        biome: true,`),e.type===`monorepo-root`&&r.push(`        tsconfig: true,`),r.push(`        watch: true,`),`import { defineConfig } from '@deltabox/toolchain';
+
+export default defineConfig({
+    toolchain: {
+        project: {
+${n}
+        },
+${r.join(`
+`)}
+    },
+});
+`}function u(e=!1){return c({extends:`./tsconfig.default.json`,compilerOptions:{composite:e}})}function d(e){let n={name:e.scope?`${e.scope}/${e.name}`:e.name,version:`0.1.0`,private:!0,type:`module`,description:``,...e.author?{author:e.author}:{},...e.license?{license:e.license}:{},scripts:{build:`tsdown --config-loader unrun`,format:`biome format --write .`,lint:`biome check --fix .`,test:`vitest run`,typecheck:`tsc -p tsconfig.json --noEmit`},devDependencies:{"@biomejs/biome":`catalog:`,tsdown:`catalog:`,typescript:`catalog:`,vitest:`catalog:`},...e.packageManager?{packageManager:e.packageManager}:{},engines:{node:e.nodeVersion?`>=${e.nodeVersion}`:`>=22`}};return[...e.includeConfig===!1?[]:[{path:`dbx.config.ts`,content:l({...e,type:e.type??`project`})}],{path:`package.json`,content:c(n)},{path:`tsconfig.base.json`,content:r(s(e))},{path:`tsconfig.default.json`,content:a(s(e))},{path:`tsconfig.build.json`,content:i(s(e))},{path:`tsconfig.json`,content:u()},{path:`biome.json`,content:t(s(e))},{path:`.gitignore`,content:h()},{path:`README.md`,content:`# ${e.name}\n`}]}function f(e){let i={name:e.name,version:`0.1.0`,private:!0,type:`module`,...e.author?{author:e.author}:{},...e.license?{license:e.license}:{},scripts:{build:`turbo build`,format:`turbo format`,lint:`turbo lint`,test:`turbo test`,typecheck:`turbo typecheck`},workspaces:e.workspaceGlobs??[`packages/*`],devDependencies:{"@biomejs/biome":`catalog:`,tsdown:`catalog:`,turbo:`^2.11.2`,typescript:`catalog:`,vitest:`catalog:`},...e.packageManager?{packageManager:e.packageManager}:{},engines:{node:e.nodeVersion?`>=${e.nodeVersion}`:`>=22`}};return[...e.includeConfig===!1?[]:[{path:`dbx.config.ts`,content:l({...e,type:e.type??`monorepo-root`})}],{path:`package.json`,content:c(i)},{path:`turbo.json`,content:m()},{path:`tsconfig.base.json`,content:r(s(e))},{path:`tsconfig.monorepo.json`,content:n({scope:e.scope??e.name,workspaces:e.workspaces})},{path:`biome.json`,content:t(s(e))},{path:`.gitignore`,content:h()},{path:`README.md`,content:`# ${e.name}\n`}]}function p(e){let t={name:e.scope?`${e.scope}/${e.wsName}`:e.wsName,version:`0.1.0`,type:`module`,files:[`dist`],scripts:{build:`tsdown --config-loader unrun`,format:`biome format --write .`,lint:`biome check --fix .`,test:`vitest run`,typecheck:`tsc -p tsconfig.build.json --noEmit`},publishConfig:{access:`public`,provenance:!0}},n=e.wsDir.split(`/`).length;return[...e.includeConfig===!1?[]:[{path:`dbx.config.ts`,content:l({...e,type:e.type??`monorepo-workspace`})}],{path:`package.json`,content:c(t)},{path:`tsconfig.default.json`,content:c({extends:`${`../`.repeat(n)}tsconfig.base.json`,compilerOptions:{module:`NodeNext`,moduleResolution:`NodeNext`,types:[`node`]},include:[`src`,`tests`,`tsdown.config.ts`,`vitest.config.ts`]})},{path:`tsconfig.build.json`,content:u()},{path:`tsconfig.json`,content:u()},{path:`tsdown.config.ts`,content:`import { defineConfig } from 'tsdown';
+
+import { baseTsdownConfig } from '@deltabox/toolchain-tsdown';
+
+export default defineConfig({
+    ...baseTsdownConfig,
+    entry: { index: 'src/index.ts' },
+});
+`}]}function m(){return c({$schema:`https://turborepo.dev/schema.json`,ui:`stream-with-experimental-timestamps`,globalDependencies:[`tsconfig.json`,`tsconfig.base.json`,`tsdown.config.ts`,`yarn.lock`],globalPassThroughEnv:[`NODE_ENV`,`VITE_*`],tasks:{build:{inputs:[`$TURBO_DEFAULT$`,`.env*`],outputs:[`dist/**`],dependsOn:[`^lint`,`^typecheck`,`^test`,`^build`]},format:{dependsOn:[`^format`]},lint:{dependsOn:[`^lint`]},typecheck:{dependsOn:[`^typecheck`]},test:{dependsOn:[`^test`]}}})}function h(){return[`node_modules/`,`dist/`,`coverage/`,`.turbo/`,`*.tsbuildinfo`,``,`.env`,`.env.*`,`!.env.example`,`!.env.example.*`,``,`.DS_Store`,``,`# Yarn 4`,`.pnp.*`,`.yarn/*`,`!.yarn/patches`,`!.yarn/plugins`,`!.yarn/releases`,`!.yarn/sdks`,`!.yarn/versions`,``].join(`
+`)}function g(t,n=process.cwd()){let r=[];for(let i of t){let t=e.resolve(n,i.path);o.mkdirSync(e.dirname(t),{recursive:!0}),o.writeFileSync(t,i.content,`utf-8`),r.push(t)}return r}export{f as createMonorepoRootFiles,d as createRootProjectFiles,p as createWorkspaceFiles,h as renderGitignore,l as renderToolingConfig,m as renderTurboJson,u as renderWorkspaceTsconfig,g as writeGeneratedFiles};