@deltabox/toolchain 1.11.4 → 2.1.0

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

@@ -3,21 +3,36 @@ import __tsdown_shims_url from 'node:url';
 import { ZodType } from "zod";
 import { Schema } from "untyped";
 //#region packages/config/src/types.d.ts
-/** The value type an env var resolves to. */
-export type EnvValueType = 'string' | 'number' | 'boolean' | 'array' | 'object';
+export type ConfigMeta = ConfigBaseMeta & ConfigEnvMeta & ConfigTypeMeta & ConfigCliMeta;
 /**
- * The metadata a consumer attaches to a Zod leaf via `.meta()` to describe the
- * environment variable that backs a configuration value.
+ * The metadata attached to a Zod leaf via `.meta()` to describe the
+ * generated config that backs the config value.
  */
-export interface EnvVarMeta {
-  /** The env var name, e.g. `MYAPP_AUTH_PASSWORD`. */
-  env: string;
-  /** The dotted config path, e.g. `auth.password`. */
-  path?: string;
-  /** Human-readable description (used by `.env.example` + the docs). */
+export interface ConfigBaseMeta {
+  /** Identifier for this config eg. `ToolchainLoggerConfig`.  */
+  id?: string;
+  /** Human-readable description (added to the generated types' JSDocs, generated .env and markdown files). */
   description?: string;
   /** Whether the var has no safe default and must be set. */
   required?: boolean;
+  /** Mark this config as deprecated (`@deprecated` in the generated types). */
+  deprecated?: boolean;
+  /** Optional deprecation message shown after `@deprecated` / `**Deprecated**`. */
+  deprecationMessage?: string;
+  /** Add custom example(s) that will be added to the generated documentation. */
+  example?: string[] | string;
+  /** Version or date this option was introduced (`@since`). */
+  since?: string;
+  /** Related link(s) for the option (`@see`). */
+  see?: string[] | string;
+  /** Extra notes shown after the description (`@remarks`). */
+  remarks?: string;
+  /** Mark the option as experimental (`@experimental`). */
+  experimental?: boolean;
+  /** Mark the option as alpha (`@alpha`). */
+  alpha?: boolean;
+  /** Mark the option as beta (`@beta`). */
+  beta?: boolean;
   /** Whether the value is a secret (never emitted/logged). */
   secret?: boolean;
   /** The scope the variable belongs to. */
@@ -26,42 +41,135 @@ export interface EnvVarMeta {
   public?: boolean;
   /**
    * The resolved-config default, when it differs from the raw env default
-   * (e.g. the positive field behind a negative-named env flag).
+   * (e.g. the positive field behind a negative-named CLI flag).
    */
   defaultValue?: unknown;
 }
-/** A collected env-var definition. */
-export interface EnvVarDef {
-  name: string;
+/**
+ * The metadata attached to a Zod leaf via `.meta()` to describe the
+ * generated environment variable that backs the config value.
+ */
+export interface ConfigEnvMeta {
+  /** The env var name, e.g. `MYAPP_AUTH_PASSWORD` (optional for non-env configs). */
+  envName?: string;
+  /**
+   * The env var name, e.g. `MYAPP_AUTH_PASSWORD` (optional for non-env configs).
+   * @deprecated use `envName` instead.
+   */
+  env?: string;
+  /** Use a different dotted config path, e.g. `auth.password` instead of the resolved one. */
+  envPath?: string;
+  /**
+   * Use a different dotted config path, e.g. `auth.password` instead of the resolved one.
+   * @deprecated use `envPath` instead.
+   */
+  path?: string;
+}
+/**
+ * The metadata attached to a Zod leaf via `.meta()` to describe the
+ * generated type that backs the config value.
+ */
+export interface ConfigTypeMeta {
+  /**
+   * The generated type/interface name eg. `ToolchainTsconfigConfig`.
+   *
+   * Defaults to the zod schema's `.meta({ id: <value> })` ({@link ConfigBaseMeta.id})
+   * and falls back to `<PascalScope>Config`.
+   */
+  typeName?: string;
+}
+/**
+ * The metadata attached to a Zod leaf via `.meta()` to describe the
+ * generated cli flag that backs the config value.
+ */
+export interface ConfigCliMeta {
+  /** Use a different CLI flag, e.g. CLI flag, e.g. `--base-url` instead of the resolved one. */
+  cliFlag?: string;
+  /** Shorthand CLI flag, e.g. `-u`. */
+  cliFlagShort?: string;
+}
+/** The value type a config value resolves to. */
+export type ConfigValueType = 'string' | 'number' | 'boolean' | 'array' | 'object';
+/** A collected config definition (env/cli metadata is optional). */
+export interface ConfigDef {
+  /** The env var name, when the value is env-backed. */
+  name?: string;
+  /** The dotted config path. */
   path: string;
+  /** The CLI flag, when the value is CLI-backed or derives from an env var. */
+  cliFlag?: string;
   description?: string;
   default?: unknown;
   required?: boolean;
   secret?: boolean;
   public?: boolean;
   scope: string;
-  envType?: EnvValueType;
-}
-/** One configuration scope: its Zod schema and an optional resolved schema. */
-export interface ConfigScopeDef {
-  /** The Zod schema (the single source of truth). */
-  zodSchema: ZodType;
-  /** A pre-resolved untyped schema (resolved from the Zod schema if omitted). */
-  jsonSchema?: Schema;
+  type?: ConfigValueType;
+  /** The raw config metadata attached to the schema leaf. */
+  meta?: ConfigMeta;
 }
+/**
+ * The schema's object key that holds the config fields.
+ */
+export type ConfigGroup = 'base' | (string & {}) | ConfigGroup[];
+/** A config scope. */
+export type ConfigScope = string;
+/** A resolved untyped schema carrying the toolchain's config metadata. */
+export type ConfigSchemaType = Schema & ConfigMeta;
+/** A Zod schema or a resolved untyped schema. */
+export type ConfigSchemaInput = ZodType | ConfigSchemaType;
+/** A single schema, a list of schemas, or scoped schemas keyed by scope name. */
+export type ConfigSchema<Scope extends ConfigScope = ConfigScope> = ConfigSchemaInput | ConfigSchemaInput[] | Record<Scope, ConfigSchemaInput | ConfigSchemaInput[]>;
+/** Normalized schemas, keyed by scope name. */
+export type ConfigSchemaMap = Record<string, ConfigSchemaType>;
 /** The scopes registered with an engine, keyed by scope name. */
-export type ConfigScopes = Record<string, ConfigScopeDef>;
+export type ConfigScopes = Record<string, ConfigSchema | ConfigSchema[]>;
+/**
+ * Flatten the schema by `n` levels.
+ *
+ * - When `true` the `baseGroup` will be ignored
+ * and the schema will flatten all top-level keys (for objects).
+ *
+ *  - When defined as `{ level: <number> }` the `baseGroup` will be ignored
+ * and the schema will flatten keys `n` levels deep (for objects).
+ *
+ *  - When defined as `{ maxDepth: <number> }` the `baseGroup` will be ignored
+ * and the schema will flatten keys `n` levels deep and stops at `maxDepth` (for objects).
+ */
+export type ConfigEngineFlatten = boolean | {
+  level: number;
+  maxDepth?: never;
+} | {
+  maxDepth: number;
+  level?: never;
+};
 /** Options shared by every generator. */
 export interface ConfigEngineOptions {
   /** The scopes to walk, keyed by scope name (eg. `{ server, frontend, cli }`). */
-  scopes: ConfigScopes;
+  schema: ConfigSchema;
   /** The env-var prefix (eg. `MYAPP_`). Kept as a replacement token in code. */
   envPrefix?: string;
   /**
-   * The object key that holds the "flat" base config fields, hoisted out of
+   * The schema's object key that holds the "flat" base config fields, hoisted out of
    * the nested groups in the generated types/docs (default `base`).
    */
-  baseGroup?: string;
+  baseGroup?: ConfigGroup;
+  /**
+   * Flattens the schema by `n` levels.
+   *
+   * - When `true` the `baseGroup` will be ignored
+   * and the schema will flatten all top-level keys (for objects).
+   *
+   *  - When defined as `{ level: <number> }` the `baseGroup` will be ignored
+   * and the schema will flatten keys `n` levels deep (for objects).
+   */
+  flatten?: boolean | {
+    level: number;
+    maxLevel?: never;
+  } | {
+    maxLevel: number;
+    level?: never;
+  };
   /** The monorepo/project root used for default output paths. */
   root?: string;
   /**
@@ -70,6 +178,4 @@ export interface ConfigEngineOptions {
    */
   envPathOf?: (env: string) => string;
 }
-/** Derive the dotted config path from an env var name + prefix. */
-export declare function envPathOf(env: string, prefix?: string): string;
 //#endregion

package/dist/packages/core/src/editor-config.d.ts

@@ -0,0 +1,14 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+import { SyncTask } from "../../shared/src/toolchain.js";
+import "../../shared/src/index.js";
+//#region packages/core/src/editor-config.d.ts
+/**
+ * Emit centralized config warnings: tool precedence conflicts and deprecated
+ * sections. Runs even when editor defaults are off so CLI/extension users still
+ * see the notices.
+ */
+export declare function toolingConfigTask(): SyncTask;
+/** Add project-scoped VS Code defaults when `fmt.vscode` / `lint.vscode` is on. */
+export declare function editorConfigSyncTask(): SyncTask;
+//#endregion

package/dist/packages/core/src/editor-config.js

@@ -0,0 +1 @@
+import{default as e}from"node:path";import"node:url";import.meta.url;import{deepMerge as t,isPlainObject as n}from"../../shared/src/object-utils.js";import{errorMessage as r,warningMessage as i}from"../../shared/src/messages.js";import{FORMATTER_PRECEDENCE as a,LINTER_PRECEDENCE as o,resolveFmtTool as s,resolveFmtTools as c,resolveLintTool as l,resolveLintTools as u,sectionConfig as d,sectionEnabled as f}from"../../shared/src/toolchain.js";import"../../shared/src/index.js";import p from"node:fs";const m={oxc:`oxc.oxc-vscode`,biome:`biomejs.biome`,prettier:`esbenp.prettier-vscode`,dprint:`dprint.dprint`},h={oxc:{"source.fixAll.oxc":`explicit`},biome:{"quickfix.biome":`explicit`,"source.organizeImports.biome":`explicit`},eslint:{"source.fixAll.eslint":`explicit`}},g=[`javascript`,`javascriptreact`,`typescript`,`typescriptreact`];function _(e){let t=m[e];return t?{"editor.defaultFormatter":t,...Object.fromEntries(g.map(e=>[`[${e}]`,{"editor.defaultFormatter":t}]))}:{}}function v(e,t){for(let[r,i]of Object.entries(t)){let t=e[r];t===void 0?e[r]=i:n(t)&&n(i)&&v(t,i)}}function y(e){return e===!0||n(e)}function b(e,r){if(!n(r))return e;let i=r,a=i.overrides?t(e,i.overrides):e;for(let e of i.exclude??[]){let{[e]:t,...n}=a;a=n}return a}function x(){return{name:`tooling`,enabled:e=>f(e.fmt)||f(e.lint)||f(e.biome),run:e=>{let t=f(e.config.biome),n=c(e.config),s=u(e.config),l=t?a.filter(e=>e===`biome`||n.includes(e)):n,d=t?o.filter(e=>e===`biome`||s.includes(e)):s;return l.length>1&&e.warn(i(`fmt.conflict`,{tools:l.join(`, `),winner:l[0]}),`fmt.conflict`),d.length>1&&e.warn(i(`lint.conflict`,{tools:d.join(`, `),winner:d[0]}),`lint.conflict`),t&&e.warn(r(`deprecated.section.biome`),`deprecated.section.biome`),[]}}}function S(){return{name:`editor-config`,projectTypes:[`monorepo-root`,`project`],enabled:e=>y(f(e.fmt)?d(e.fmt)?.vscode:void 0)||y(f(e.lint)?d(e.lint)?.vscode:void 0),run:t=>{let r=s(t.config),i=l(t.config),a=f(t.config.fmt)?d(t.config.fmt)?.vscode:void 0,o=f(t.config.lint)?d(t.config.lint)?.vscode:void 0,c={};if(y(a)&&r&&Object.assign(c,b(_(r),a)),y(o)&&i&&Object.assign(c,b({"editor.codeActionsOnSave":h[i]??{}},o)),Object.keys(c).length===0)return[];let u=e.join(t.cwd,`.vscode`,`settings.json`),m={};if(p.existsSync(u))try{let e=JSON.parse(p.readFileSync(u,`utf-8`).replace(/^\uFEFF/,``));if(!n(e))return t.warn(`cannot add editor defaults: ${u} is not a JSON object.`,`vscode.settings-invalid`),[];m=e}catch{return t.warn(`cannot add editor defaults: ${u} is not valid JSON.`,`vscode.settings-invalid`),[]}if(t.check)return[];let g=JSON.stringify(m);return v(m,c),JSON.stringify(m)!==g&&(p.mkdirSync(e.dirname(u),{recursive:!0}),p.writeFileSync(u,`${JSON.stringify(m,null,4)}\n`,`utf-8`)),[]}}}export{S as editorConfigSyncTask,x as toolingConfigTask};

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

@@ -1 +1 @@
-import{default as e}from"node:path";import"node:url";import.meta.url;import{readJsonAt as t,toJson as n}from"../../shared/src/fs-utils.js";import"../../shared/src/index.js";import{findConfigFile as r}from"./loader.js";import i from"node:fs";const a=/* @__PURE__ */ new Set([`node_modules`,`dist`,`build`,`out`,`coverage`,`tmp`,`temp`,`vendor`,`jspm_packages`,`web_modules`]);function o(e){return e.startsWith(`.`)||a.has(e)}function s(t){try{return i.readdirSync(t,{withFileTypes:!0}).filter(e=>e.isDirectory()&&!e.isSymbolicLink()&&!o(e.name)).map(n=>e.join(t,n.name))}catch{return[]}}function c(t,n){return e.relative(t,n).replace(/\\/g,`/`)||`.`}function l(t){let n=n=>i.existsSync(e.join(t,n));if(n(`yarn.lock`))return`yarn`;if(n(`pnpm-lock.yaml`))return`pnpm`;if(n(`package-lock.json`))return`npm`;if(n(`bun.lock`)||n(`bun.lockb`))return`bun`}const u=[`dependencies`,`devDependencies`,`peerDependencies`,`optionalDependencies`];function d(e,n={}){let i=n.maxDepth??5,a=/* @__PURE__ */ new Map,o=/* @__PURE__ */ new Map,d=(n,l)=>{let u=t(n,`package.json`),f=r(n);if(u||f){let t={...u?.name?{name:u.name}:{},dir:c(e,n),hasConfig:!!f,...f?{config:c(e,f)}:{},dependencies:[]};a.set(n,t),u?.name&&o.set(u.name,n)}if(!(l>=i))for(let e of s(n))d(e,l+1)};d(e,0);for(let[e,n]of a){let r=t(e,`package.json`);if(!r)continue;let i=/* @__PURE__ */ new Set;for(let t of u){let n=r[t];if(n&&typeof n==`object`)for(let t of Object.keys(n)){let n=o.get(t);n&&n!==e&&i.add(t)}}n.dependencies=[...i].sort()}let p=[...a.values()].sort((e,t)=>e.dir.localeCompare(t.dir)),m=p.filter(e=>e.hasConfig);return{root:e,packageManager:l(e),generatedAt:(/* @__PURE__ */ new Date()).toISOString(),projects:p,dbxProjects:m,order:f(m)}}function f(e){let t=/* @__PURE__ */ new Map;for(let n of e)n.name&&t.set(n.name,n.dir);let n=new Map(e.map(e=>[e.dir,e])),r=/* @__PURE__ */ new Set,i=/* @__PURE__ */ new Set,a=[],o=e=>{if(r.has(e)||i.has(e))return;i.add(e);let s=n.get(e);for(let e of s?.dependencies??[]){let r=t.get(e);r&&n.has(r)&&o(r)}i.delete(e),r.add(e),a.push(e)};for(let t of e)o(t.dir);return a}function p(t){return e.join(t,`.dbx`,`toolchain`,`projects.json`)}function m(t,r){let a=p(t);return i.mkdirSync(e.dirname(a),{recursive:!0}),i.writeFileSync(a,n(r??d(t)),`utf-8`),a}function h(e){try{return JSON.parse(i.readFileSync(p(e),`utf-8`))}catch{return}}export{a as IGNORED_DIRS,d as buildProjectGraph,l as detectPackageManager,f as orderProjects,p as projectGraphPath,h as readProjectGraph,m as writeProjectGraph};
+import{default as e}from"node:path";import"node:url";import.meta.url;import{readJsonAt as t,toJson as n}from"../../shared/src/fs-utils.js";import"../../shared/src/index.js";import{findConfigFile as r}from"./loader.js";import i from"node:fs";const a=/* @__PURE__ */ new Set([`node_modules`,`dist`,`build`,`out`,`coverage`,`tmp`,`temp`,`vendor`,`jspm_packages`,`web_modules`]);function o(e){return e.startsWith(`.`)||a.has(e)}function s(t){try{return i.readdirSync(t,{withFileTypes:!0}).filter(e=>e.isDirectory()&&!e.isSymbolicLink()&&!o(e.name)).map(n=>e.join(t,n.name))}catch{return[]}}function c(t,n){return e.relative(t,n).replace(/\\/g,`/`)||`.`}function l(t){let n=n=>i.existsSync(e.join(t,n));if(n(`yarn.lock`))return`yarn`;if(n(`pnpm-lock.yaml`))return`pnpm`;if(n(`package-lock.json`))return`npm`;if(n(`bun.lock`)||n(`bun.lockb`))return`bun`}const u=[`dependencies`,`devDependencies`,`peerDependencies`,`optionalDependencies`];function d(e,n={}){let i=n.maxDepth??5,a=/* @__PURE__ */ new Map,o=/* @__PURE__ */ new Map,d=(n,l)=>{let u=t(n,`package.json`),f=r(n);if(u||f){let t={...u?.name?{name:u.name}:{},dir:c(e,n),hasConfig:!!f,...f?{config:c(e,f)}:{},dependencies:[]};a.set(n,t),u?.name&&o.set(u.name,n)}if(!(l>=i))for(let e of s(n))d(e,l+1)};d(e,0);for(let[e,n]of a){let r=t(e,`package.json`);if(!r)continue;let i=/* @__PURE__ */ new Set;for(let t of u){let n=r[t];if(n&&typeof n==`object`)for(let t of Object.keys(n)){let n=o.get(t);n&&n!==e&&i.add(t)}}n.dependencies=[...i].sort()}let p=[...a.values()].sort((e,t)=>e.dir.localeCompare(t.dir)),m=p.filter(e=>e.hasConfig);return{root:e,packageManager:l(e),generatedAt:(/* @__PURE__ */ new Date()).toISOString(),projects:p,dbxProjects:m,order:f(m)}}function f(e){let t=/* @__PURE__ */ new Map;for(let n of e)n.name&&t.set(n.name,n.dir);let n=new Map(e.map(e=>[e.dir,e])),r=/* @__PURE__ */ new Set,i=/* @__PURE__ */ new Set,a=[],o=e=>{if(r.has(e)||i.has(e))return;i.add(e);let s=n.get(e);for(let e of s?.dependencies??[]){let r=t.get(e);r&&n.has(r)&&o(r)}i.delete(e),r.add(e),a.push(e)};for(let t of e)o(t.dir);return a}function p(t){return e.join(t,`.dbx`,`toolchain`,`projects.json`)}function m(t,r){let a=p(t);return i.mkdirSync(e.dirname(a),{recursive:!0}),i.writeFileSync(a,n(r??d(t)),`utf-8`),a}function h(e){try{return JSON.parse(i.readFileSync(p(e),`utf-8`).replace(/^\uFEFF/,``))}catch{return}}export{a as IGNORED_DIRS,d as buildProjectGraph,l as detectPackageManager,f as orderProjects,p as projectGraphPath,h as readProjectGraph,m as writeProjectGraph};

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

@@ -1,18 +1,19 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
+import { editorConfigSyncTask, toolingConfigTask } from "./editor-config.js";
 import { DBX_GITIGNORE_BLOCK, ensureDbxGitignore } from "./gitignore.js";
 import { BuildProjectGraphOptions, IGNORED_DIRS, PackageManager, ProjectGraph, ProjectNode, buildProjectGraph, detectPackageManager, orderProjects, projectGraphPath, readProjectGraph, writeProjectGraph } from "./graph.js";
 import { LoadToolchainConfigOptions, LoadedConfig, findConfigFile, findParentConfigFile, loadToolchainConfig, mergeToolchainConfig } from "./loader.js";
-import { MANIFEST_DIR, MANIFEST_FILE, Manifest, TIMESTAMPS_FILE, readManifest, readSyncedAt, writeManifest } from "./manifest.js";
+import { FileOrigin, MANIFEST_DIR, MANIFEST_FILE, Manifest, TIMESTAMPS_FILE, readManifest, readSyncedAt, writeManifest } from "./manifest.js";
 import { TsconfigFileNames, detectProjectType, resolveProjectType } from "./project-type.js";
-import { providerRegistryPath, readProviderRegistry, writeProviderRegistry } from "./provider-registry.js";
+import { ProviderRegistryPath, addGlobalProviderRegistry, addProjectProviderRegistry, defaultGlobalProvidersDir, globalProviderRegistryPath, legacyProviderRegistryPath, providerRegistryPath, providerRegistryPaths, readAllProviders, readAllProvidersSync, readGlobalProviders, readProviderRegistry, removeGlobalProviderRegistry, removeProjectProviderRegistry, setGlobalProviderRegistries, setProjectProviderRegistries, writeGlobalProviders, writeProviderRegistry } from "./provider-registry.js";
 import { SelectProjectsOptions, SelectedProject, selectProjects } from "./select.js";
-import { ResetProjectsOptions, ResetProjectsResult, ResetSelectors, ResetToolchainOptions, ResetToolchainResult, resetProjects, resetToolchain } from "./reset.js";
-import { RunSyncOptions, SyncResult, runSync } from "./sync.js";
+import { ResetProjectsOptions, ResetProjectsResult, ResetRestore, ResetSelectors, ResetToolchainOptions, ResetToolchainResult, resetProjects, resetToolchain } from "./reset.js";
+import { RemovedFile, RunSyncOptions, SyncResult, runSync } from "./sync.js";
 import { VscodeSyncOptions, vscodeSyncTask } from "./vscode.js";
-import { RunWatchOptions, runWatch } from "./watch.js";
+import { RunWatchOptions, resolveWatchGlobs, runWatch } from "./watch.js";
 declare namespace index_d_exports {
-  export { BuildProjectGraphOptions, DBX_GITIGNORE_BLOCK, IGNORED_DIRS, LoadToolchainConfigOptions, LoadedConfig, MANIFEST_DIR, MANIFEST_FILE, Manifest, PackageManager, ProjectGraph, ProjectNode, ResetProjectsOptions, ResetProjectsResult, ResetSelectors, ResetToolchainOptions, ResetToolchainResult, RunSyncOptions, RunWatchOptions, SelectProjectsOptions, SelectedProject, SyncResult, TIMESTAMPS_FILE, TsconfigFileNames, VscodeSyncOptions, buildProjectGraph, detectPackageManager, detectProjectType, ensureDbxGitignore, findConfigFile, findParentConfigFile, loadToolchainConfig, mergeToolchainConfig, orderProjects, projectGraphPath, providerRegistryPath, readManifest, readProjectGraph, readProviderRegistry, readSyncedAt, resetProjects, resetToolchain, resolveProjectType, runSync, runWatch, selectProjects, vscodeSyncTask, writeManifest, writeProjectGraph, writeProviderRegistry };
+  export { BuildProjectGraphOptions, DBX_GITIGNORE_BLOCK, FileOrigin, IGNORED_DIRS, LoadToolchainConfigOptions, LoadedConfig, MANIFEST_DIR, MANIFEST_FILE, Manifest, PackageManager, ProjectGraph, ProjectNode, ProviderRegistryPath, RemovedFile, ResetProjectsOptions, ResetProjectsResult, ResetRestore, ResetSelectors, ResetToolchainOptions, ResetToolchainResult, RunSyncOptions, RunWatchOptions, SelectProjectsOptions, SelectedProject, SyncResult, TIMESTAMPS_FILE, TsconfigFileNames, VscodeSyncOptions, addGlobalProviderRegistry, addProjectProviderRegistry, buildProjectGraph, defaultGlobalProvidersDir, detectPackageManager, detectProjectType, editorConfigSyncTask, ensureDbxGitignore, findConfigFile, findParentConfigFile, globalProviderRegistryPath, legacyProviderRegistryPath, loadToolchainConfig, mergeToolchainConfig, orderProjects, projectGraphPath, providerRegistryPath, providerRegistryPaths, readAllProviders, readAllProvidersSync, readGlobalProviders, readManifest, readProjectGraph, readProviderRegistry, readSyncedAt, removeGlobalProviderRegistry, removeProjectProviderRegistry, resetProjects, resetToolchain, resolveProjectType, resolveWatchGlobs, runSync, runWatch, selectProjects, setGlobalProviderRegistries, setProjectProviderRegistries, toolingConfigTask, vscodeSyncTask, writeGlobalProviders, writeManifest, writeProjectGraph, writeProviderRegistry };
 }
 //#endregion
-export { BuildProjectGraphOptions, DBX_GITIGNORE_BLOCK, IGNORED_DIRS, LoadToolchainConfigOptions, LoadedConfig, MANIFEST_DIR, MANIFEST_FILE, Manifest, PackageManager, ProjectGraph, ProjectNode, ResetProjectsOptions, ResetProjectsResult, ResetSelectors, ResetToolchainOptions, ResetToolchainResult, RunSyncOptions, RunWatchOptions, SelectProjectsOptions, SelectedProject, SyncResult, TIMESTAMPS_FILE, TsconfigFileNames, VscodeSyncOptions, buildProjectGraph, detectPackageManager, detectProjectType, ensureDbxGitignore, findConfigFile, findParentConfigFile, index_d_exports, loadToolchainConfig, mergeToolchainConfig, orderProjects, projectGraphPath, providerRegistryPath, readManifest, readProjectGraph, readProviderRegistry, readSyncedAt, resetProjects, resetToolchain, resolveProjectType, runSync, runWatch, selectProjects, vscodeSyncTask, writeManifest, writeProjectGraph, writeProviderRegistry };
+export { BuildProjectGraphOptions, DBX_GITIGNORE_BLOCK, FileOrigin, IGNORED_DIRS, LoadToolchainConfigOptions, LoadedConfig, MANIFEST_DIR, MANIFEST_FILE, Manifest, PackageManager, ProjectGraph, ProjectNode, ProviderRegistryPath, RemovedFile, ResetProjectsOptions, ResetProjectsResult, ResetRestore, ResetSelectors, ResetToolchainOptions, ResetToolchainResult, RunSyncOptions, RunWatchOptions, SelectProjectsOptions, SelectedProject, SyncResult, TIMESTAMPS_FILE, TsconfigFileNames, VscodeSyncOptions, addGlobalProviderRegistry, addProjectProviderRegistry, buildProjectGraph, defaultGlobalProvidersDir, detectPackageManager, detectProjectType, editorConfigSyncTask, ensureDbxGitignore, findConfigFile, findParentConfigFile, globalProviderRegistryPath, index_d_exports, legacyProviderRegistryPath, loadToolchainConfig, mergeToolchainConfig, orderProjects, projectGraphPath, providerRegistryPath, providerRegistryPaths, readAllProviders, readAllProvidersSync, readGlobalProviders, readManifest, readProjectGraph, readProviderRegistry, readSyncedAt, removeGlobalProviderRegistry, removeProjectProviderRegistry, resetProjects, resetToolchain, resolveProjectType, resolveWatchGlobs, runSync, runWatch, selectProjects, setGlobalProviderRegistries, setProjectProviderRegistries, toolingConfigTask, vscodeSyncTask, writeGlobalProviders, writeManifest, writeProjectGraph, writeProviderRegistry };

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

@@ -1 +1 @@
-import"node:path";import"node:url";import.meta.url;import{__exportAll as e}from"../../../_virtual/_rolldown/runtime.js";import{DBX_GITIGNORE_BLOCK as t,ensureDbxGitignore as n}from"./gitignore.js";import{detectProjectType as r,resolveProjectType as i}from"./project-type.js";import{findConfigFile as a,findParentConfigFile as o,loadToolchainConfig as s,mergeToolchainConfig as c}from"./loader.js";import{IGNORED_DIRS as l,buildProjectGraph as u,detectPackageManager as d,orderProjects as f,projectGraphPath as p,readProjectGraph as m,writeProjectGraph as h}from"./graph.js";import{MANIFEST_DIR as g,MANIFEST_FILE as _,TIMESTAMPS_FILE as v,readManifest as y,readSyncedAt as b,writeManifest as x}from"./manifest.js";import{providerRegistryPath as S,readProviderRegistry as C,writeProviderRegistry as w}from"./provider-registry.js";import{selectProjects as T}from"./select.js";import{resetProjects as E,resetToolchain as D}from"./reset.js";import{runSync as O}from"./sync.js";import{vscodeSyncTask as k}from"./vscode.js";import{runWatch as A}from"./watch.js";var j=/* @__PURE__ */ e({DBX_GITIGNORE_BLOCK:()=>t,IGNORED_DIRS:()=>l,MANIFEST_DIR:()=>g,MANIFEST_FILE:()=>_,TIMESTAMPS_FILE:()=>v,buildProjectGraph:()=>u,detectPackageManager:()=>d,detectProjectType:()=>r,ensureDbxGitignore:()=>n,findConfigFile:()=>a,findParentConfigFile:()=>o,loadToolchainConfig:()=>s,mergeToolchainConfig:()=>c,orderProjects:()=>f,projectGraphPath:()=>p,providerRegistryPath:()=>S,readManifest:()=>y,readProjectGraph:()=>m,readProviderRegistry:()=>C,readSyncedAt:()=>b,resetProjects:()=>E,resetToolchain:()=>D,resolveProjectType:()=>i,runSync:()=>O,runWatch:()=>A,selectProjects:()=>T,vscodeSyncTask:()=>k,writeManifest:()=>x,writeProjectGraph:()=>h,writeProviderRegistry:()=>w});export{t as DBX_GITIGNORE_BLOCK,l as IGNORED_DIRS,g as MANIFEST_DIR,_ as MANIFEST_FILE,v as TIMESTAMPS_FILE,u as buildProjectGraph,d as detectPackageManager,r as detectProjectType,n as ensureDbxGitignore,a as findConfigFile,o as findParentConfigFile,s as loadToolchainConfig,c as mergeToolchainConfig,f as orderProjects,p as projectGraphPath,S as providerRegistryPath,y as readManifest,m as readProjectGraph,C as readProviderRegistry,b as readSyncedAt,E as resetProjects,D as resetToolchain,i as resolveProjectType,O as runSync,A as runWatch,T as selectProjects,j as src_exports,k as vscodeSyncTask,x as writeManifest,h as writeProjectGraph,w as writeProviderRegistry};
+import"node:path";import"node:url";import.meta.url;import{__exportAll as e}from"../../../_virtual/_rolldown/runtime.js";import{editorConfigSyncTask as t,toolingConfigTask as n}from"./editor-config.js";import{DBX_GITIGNORE_BLOCK as r,ensureDbxGitignore as i}from"./gitignore.js";import{detectProjectType as a,resolveProjectType as o}from"./project-type.js";import{findConfigFile as s,findParentConfigFile as c,loadToolchainConfig as l,mergeToolchainConfig as u}from"./loader.js";import{IGNORED_DIRS as d,buildProjectGraph as f,detectPackageManager as p,orderProjects as m,projectGraphPath as h,readProjectGraph as g,writeProjectGraph as _}from"./graph.js";import{MANIFEST_DIR as v,MANIFEST_FILE as y,TIMESTAMPS_FILE as b,readManifest as x,readSyncedAt as S,writeManifest as C}from"./manifest.js";import{addGlobalProviderRegistry as w,addProjectProviderRegistry as T,defaultGlobalProvidersDir as E,globalProviderRegistryPath as D,legacyProviderRegistryPath as O,providerRegistryPath as k,providerRegistryPaths as A,readAllProviders as j,readAllProvidersSync as M,readGlobalProviders as N,readProviderRegistry as P,removeGlobalProviderRegistry as F,removeProjectProviderRegistry as I,setGlobalProviderRegistries as L,setProjectProviderRegistries as R,writeGlobalProviders as z,writeProviderRegistry as B}from"./provider-registry.js";import{selectProjects as V}from"./select.js";import{resetProjects as H,resetToolchain as U}from"./reset.js";import{runSync as W}from"./sync.js";import{vscodeSyncTask as G}from"./vscode.js";import{resolveWatchGlobs as K,runWatch as q}from"./watch.js";var J=/* @__PURE__ */ e({DBX_GITIGNORE_BLOCK:()=>r,IGNORED_DIRS:()=>d,MANIFEST_DIR:()=>v,MANIFEST_FILE:()=>y,TIMESTAMPS_FILE:()=>b,addGlobalProviderRegistry:()=>w,addProjectProviderRegistry:()=>T,buildProjectGraph:()=>f,defaultGlobalProvidersDir:()=>E,detectPackageManager:()=>p,detectProjectType:()=>a,editorConfigSyncTask:()=>t,ensureDbxGitignore:()=>i,findConfigFile:()=>s,findParentConfigFile:()=>c,globalProviderRegistryPath:()=>D,legacyProviderRegistryPath:()=>O,loadToolchainConfig:()=>l,mergeToolchainConfig:()=>u,orderProjects:()=>m,projectGraphPath:()=>h,providerRegistryPath:()=>k,providerRegistryPaths:()=>A,readAllProviders:()=>j,readAllProvidersSync:()=>M,readGlobalProviders:()=>N,readManifest:()=>x,readProjectGraph:()=>g,readProviderRegistry:()=>P,readSyncedAt:()=>S,removeGlobalProviderRegistry:()=>F,removeProjectProviderRegistry:()=>I,resetProjects:()=>H,resetToolchain:()=>U,resolveProjectType:()=>o,resolveWatchGlobs:()=>K,runSync:()=>W,runWatch:()=>q,selectProjects:()=>V,setGlobalProviderRegistries:()=>L,setProjectProviderRegistries:()=>R,toolingConfigTask:()=>n,vscodeSyncTask:()=>G,writeGlobalProviders:()=>z,writeManifest:()=>C,writeProjectGraph:()=>_,writeProviderRegistry:()=>B});export{r as DBX_GITIGNORE_BLOCK,d as IGNORED_DIRS,v as MANIFEST_DIR,y as MANIFEST_FILE,b as TIMESTAMPS_FILE,w as addGlobalProviderRegistry,T as addProjectProviderRegistry,f as buildProjectGraph,E as defaultGlobalProvidersDir,p as detectPackageManager,a as detectProjectType,t as editorConfigSyncTask,i as ensureDbxGitignore,s as findConfigFile,c as findParentConfigFile,D as globalProviderRegistryPath,O as legacyProviderRegistryPath,l as loadToolchainConfig,u as mergeToolchainConfig,m as orderProjects,h as projectGraphPath,k as providerRegistryPath,A as providerRegistryPaths,j as readAllProviders,M as readAllProvidersSync,N as readGlobalProviders,x as readManifest,g as readProjectGraph,P as readProviderRegistry,S as readSyncedAt,F as removeGlobalProviderRegistry,I as removeProjectProviderRegistry,H as resetProjects,U as resetToolchain,o as resolveProjectType,K as resolveWatchGlobs,W as runSync,q as runWatch,V as selectProjects,L as setGlobalProviderRegistries,R as setProjectProviderRegistries,J as src_exports,n as toolingConfigTask,G as vscodeSyncTask,z as writeGlobalProviders,C as writeManifest,_ as writeProjectGraph,B as writeProviderRegistry};

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

@@ -8,6 +8,8 @@ import "../../shared/src/index.js";
 /** A loaded tooling config plus its resolved path + replacement tokens. */
 export interface LoadedConfig {
   config: ToolchainConfig;
+  /** The config from this project's own file (not the inherited parent). */
+  ownConfig: ToolchainConfig;
   /** The config file that was loaded (undefined when none was found). */
   path?: string;
   /** The inherited ancestor config, when the loaded config overrides one. */
@@ -30,6 +32,17 @@ export interface LoadToolchainConfigOptions {
    * VS Code tree views that drive them). Default: `false` (throw).
    */
   tolerant?: boolean;
+  /** Load this config file instead of discovering `dbx.config.*`. */
+  config?: string;
+  /** Ignore every config file and use defaults / CLI flags only. */
+  noConfig?: boolean;
+  /** Skip the config's `hooks.afterLoad` callback (metadata-only loads). */
+  skipHooks?: boolean;
+  /**
+   * Bypass the ESM/CJS module cache. Long-running callers (eg. `dbx watch`)
+   * must set this so an edited config is actually re-evaluated.
+   */
+  fresh?: boolean;
 }
 /** Find the first `dbx.config.*` file at `cwd`, if any. */
 export declare function findConfigFile(cwd?: string): string | undefined;
@@ -46,13 +59,18 @@ export declare function findParentConfigFile(cwd?: string): string | undefined;
  * **replace** the ancestor's value — so a non-root `dbx.config` can override
  * individual options of the root config (and keep the rest).
  *
+ * Some sections are workspace-scoped and are **never inherited**:
+ * - `ci` / the `changelog` section: workflows are repository-level;
+ * - `tsconfig`: the root task expands every workspace tsconfig;
+ * - `vite.test` and `vite.run`: they describe how that workspace runs;
+ * - `hooks`: a parent's hooks are code and must not run for a nested sync.
+ *
  * `project` is inherited **except the identity fields** (`name`, `scope`,
  * `description`, `type`): a workspace keeps its own name/description (or falls
  * back to its `package.json`), and is still detected from its own files — so a
  * root `project` never renames a workspace. The shared fields (author, license,
  * homepage, `repo`, `packageManager`, ...) flow down. `project.inherit: false`
- * disables project inheritance entirely. `hooks` are **not** inherited either —
- * a parent's hooks are code and must not run for a nested project's sync.
+ * disables project inheritance entirely.
  */
 export declare function mergeToolchainConfig(parent: ToolchainConfig, child: ToolchainConfig): ToolchainConfig;
 /**

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

@@ -1 +1 @@
-import{default as e}from"node:path";import{pathToFileURL as t}from"node:url";import.meta.url;import{deepMerge as n}from"../../shared/src/object-utils.js";import{readJsonAt as r}from"../../shared/src/fs-utils.js";import{projectFromPackageJson as i}from"../../shared/src/project.js";import{CONFIG_FILE_NAMES as a,resolveTokens as o}from"../../shared/src/toolchain.js";import"../../shared/src/index.js";import{resolveProjectType as s}from"./project-type.js";import c from"node:fs";function l(e){return e instanceof Error?e.message:String(e)}function u(t=process.cwd()){for(let n of a){let r=e.resolve(t,n);if(c.existsSync(r))return r}}function d(t=process.cwd()){let n=e.resolve(t);if(c.existsSync(e.join(n,`.git`)))return;let r=e.dirname(n);for(;;){let t=u(r);if(t)return t;if(c.existsSync(e.join(r,`.git`)))return;let n=e.dirname(r);if(n===r)return;r=n}}function f(e){let t=e?.code;return t===`ERR_UNKNOWN_FILE_EXTENSION`||t===`ERR_UNSUPPORTED_TYPESCRIPT_SYNTAX`}function p(e){let t=e;for(let e=0;e<2&&t&&typeof t==`object`&&`default`in t&&Object.keys(t).every(e=>e==="default"||e==="__esModule");e++)t=t.default;return t}async function m(e){if(e.endsWith(`.json`))return JSON.parse(c.readFileSync(e,`utf-8`).replace(/^\uFEFF/,``));let n=t(e).href;try{let e=await import(n);return e.default??e}catch(e){if(!f(e))throw e;let{tsImport:t}=await import(`tsx/esm/api`);return p(await t(n,import.meta.url))}}async function h(e){let t=await m(e),n=t&&typeof t==`object`?t.toolchain:void 0;return n&&typeof n==`object`?n:{}}const g=/* @__PURE__ */ new Set([`name`,`scope`,`description`,`type`]);function _(e,t){let{hooks:r,project:i,...a}=e,o=a;if(t.project?.inherit!==!1&&i){let e=Object.fromEntries(Object.entries(i).filter(([e])=>!g.has(e)));Object.keys(e).length>0&&(o={...a,project:e})}return n(o,t)}async function v(e=process.cwd(),t={}){let n=u(e),a=d(e),c=t.tolerant??!1,f={},p;if(a)try{f=await h(a)}catch(e){if(!c)throw e;p=`failed to load ${a}: ${l(e)}`}if(n)try{let e=await h(n);f=a&&!p?_(f,e):e}catch(e){if(!c)throw e;p=`failed to load ${n}: ${l(e)}`}let m=r(e,`package.json`),g={...m?i(m):void 0,...f.project??void 0},v=o({...f,project:g});return await f.hooks?.afterLoad?.({cwd:e,config:f,tokens:v,...n?{path:n}:{}}),{config:f,...n?{path:n}:{},...a?{parentPath:a}:{},...p?{error:p}:{},tokens:v,projectType:s(e,f)}}export{u as findConfigFile,d as findParentConfigFile,v as loadToolchainConfig,_ as mergeToolchainConfig};
+import{default as e}from"node:path";import{pathToFileURL as t}from"node:url";import.meta.url;import{deepMerge as n,isPlainObject as r}from"../../shared/src/object-utils.js";import{readJsonAt as i}from"../../shared/src/fs-utils.js";import{projectFromPackageJson as a}from"../../shared/src/project.js";import{CONFIG_FILE_NAMES as o,resolveTokens as s}from"../../shared/src/toolchain.js";import"../../shared/src/index.js";import{resolveProjectType as c}from"./project-type.js";import{createRequire as l}from"node:module";import u from"node:fs";function d(e){return e instanceof Error?e.message:String(e)}function f(t=process.cwd()){for(let n of o){let r=e.resolve(t,n);if(u.existsSync(r))return r}}function p(t=process.cwd()){let n=e.resolve(t);if(u.existsSync(e.join(n,`.git`)))return;let r=e.dirname(n);for(;;){let t=f(r);if(t)return t;if(u.existsSync(e.join(r,`.git`)))return;let n=e.dirname(r);if(n===r)return;r=n}}function m(e){let t=e?.code;return t===`ERR_UNKNOWN_FILE_EXTENSION`||t===`ERR_UNSUPPORTED_TYPESCRIPT_SYNTAX`}function h(e){let t=e;for(let e=0;e<2&&t&&typeof t==`object`&&`default`in t&&Object.keys(t).every(e=>e==="default"||e==="__esModule");e++)t=t.default;return t}const g=l(import.meta.url);let _=0;async function v(e,n=!1){if(e.endsWith(`.json`))return JSON.parse(u.readFileSync(e,`utf-8`).replace(/^\uFEFF/,``));if(n)try{delete g.cache[e]}catch{}let r=t(e).href,i=n?`${r}?dbx=${Date.now()}-${++_}`:r;try{let e=await import(i);return e.default??e}catch(e){if(!m(e))throw e;let{tsImport:t}=await import(`tsx/esm/api`);return h(await t(i,import.meta.url))}}async function y(e,t=!1){let n=await b(await v(e,t)),r=n&&typeof n==`object`?n.toolchain:void 0;return r&&typeof r==`object`?r:{}}async function b(e){let t=await e;return typeof t==`function`&&(t=await t()),t}const x=/* @__PURE__ */ new Set([`name`,`scope`,`description`,`type`]),S=/* @__PURE__ */ new Set([`test`,`run`]);function C(e){if(!r(e))return e;let t=Object.fromEntries(Object.entries(e).filter(([e])=>!S.has(e)));return Object.keys(t).length>0?t:void 0}function w(e,t){let{hooks:r,project:i,ci:a,changelog:o,catalogs:s,tsconfig:c,vite:l,...u}=e,d=u,f=C(l);if(f!==void 0&&(d={...d,vite:f}),t.project?.inherit!==!1&&i){let e=Object.fromEntries(Object.entries(i).filter(([e])=>!x.has(e)));Object.keys(e).length>0&&(d={...d,project:e})}return n(d,t)}async function T(t=process.cwd(),n={}){let r=n.noConfig?void 0:n.config?e.isAbsolute(n.config)?n.config:e.resolve(t,n.config):f(t),o=n.noConfig?void 0:p(t),l=n.tolerant??!1,u=n.fresh??!1,m={},h={},g,_;if(o)try{g=await y(o,u),m=g}catch(e){if(!l)throw e;_=`failed to load ${o}: ${d(e)}`}if(r)try{let e=await y(r,u);h=e,m=o&&!_?w(m,e):e}catch(e){if(!l)throw e;_=`failed to load ${r}: ${d(e)}`}let v=i(t,`package.json`),b={...v?a(v):void 0,...m.project??void 0},x=s({...m,project:b});n.skipHooks||await m.hooks?.afterLoad?.({cwd:t,config:m,tokens:x,...r?{path:r}:{}});let S=m.tsconfig===void 0&&g?.tsconfig!==void 0?{...m,tsconfig:g.tsconfig}:m;return{config:m,ownConfig:h,...r?{path:r}:{},...o?{parentPath:o}:{},..._?{error:_}:{},tokens:x,projectType:c(t,S)}}export{f as findConfigFile,p as findParentConfigFile,T as loadToolchainConfig,w as mergeToolchainConfig};

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

@@ -9,15 +9,34 @@ export declare const MANIFEST_FILE = "manifest.json";
  * dirties the committed `manifest.json`, which tracks only the file list.
  */
 export declare const TIMESTAMPS_FILE = "timestamps.json";
+/** Whether dbx created a managed file or adopted a pre-existing one. */
+export type FileOrigin = 'created' | 'adopted';
 export interface Manifest {
   /** Repo-relative paths of every generated/managed file. */
   files: string[];
+  /** Per-file origin, so a sync only deletes files that dbx created. */
+  origins?: Record<string, FileOrigin>;
   /**
    * ISO timestamp of the last successful sync (absent when never synced).
    * Read from {@link TIMESTAMPS_FILE}, falling back to a legacy inline
    * `syncedAt` in the manifest until the next sync migrates it.
    */
   syncedAt?: string;
+  /**
+   * The `tsconfig.overrides` currently applied, keyed by the repo-relative
+   * target file (`{ kind, override }`), so a removed override can be reverted.
+   */
+  tsconfigOverrides?: Record<string, unknown>;
+  /**
+   * The original (pre-override) tsconfig contents, nested by repo-relative
+   * path (`{ packages: { core: { "tsconfig.build.json": { ... } } } }`).
+   */
+  snapshots?: Record<string, unknown>;
+  /**
+   * Task-defined metadata persisted across syncs (everything a task writes to
+   * `SyncContext.manifest` that is not one of the reserved keys).
+   */
+  extras?: Record<string, unknown>;
 }
 /**
  * The last-sync timestamp for a project: {@link TIMESTAMPS_FILE} first, then a
@@ -32,5 +51,5 @@ export declare function readManifest(cwd: string): Manifest;
  * creating the directory as needed. Rewriting `manifest.json` without
  * `syncedAt` is what migrates a legacy inline timestamp on the next sync.
  */
-export declare function writeManifest(cwd: string, files: string[], syncedAt?: string): void;
+export declare function writeManifest(cwd: string, files: string[], syncedAt?: string, origins?: Record<string, FileOrigin>, extras?: Record<string, unknown>): void;
 //#endregion

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

@@ -1 +1 @@
-import{default as e}from"node:path";import"node:url";import.meta.url;import{toJson as t}from"../../shared/src/fs-utils.js";import"../../shared/src/index.js";import n from"node:fs";const r=`.dbx/toolchain`,i=`manifest.json`,a=`timestamps.json`;function o(t){return e.resolve(t,r)}function s(t,r){try{return JSON.parse(n.readFileSync(e.join(o(t),r),`utf-8`))}catch{return}}function c(e){let t=s(e,a);if(typeof t?.syncedAt==`string`)return t.syncedAt;let n=s(e,i);return typeof n?.syncedAt==`string`?n.syncedAt:void 0}function l(e){let t=s(e,i),n=c(e);return{files:Array.isArray(t?.files)?t.files:[],...n?{syncedAt:n}:{}}}function u(r,s,c){let l=o(r);n.mkdirSync(l,{recursive:!0}),n.writeFileSync(e.join(l,i),t({files:[...new Set(s)].sort()}),`utf-8`),n.writeFileSync(e.join(l,a),t({syncedAt:c??(/* @__PURE__ */ new Date()).toISOString()}),`utf-8`)}export{r as MANIFEST_DIR,i as MANIFEST_FILE,a as TIMESTAMPS_FILE,l as readManifest,c as readSyncedAt,u as writeManifest};
+import{default as e}from"node:path";import"node:url";import.meta.url;import{toJson as t}from"../../shared/src/fs-utils.js";import"../../shared/src/index.js";import n from"node:fs";const r=`.dbx/toolchain`,i=`manifest.json`,a=`timestamps.json`;function o(t){return e.resolve(t,r)}function s(t,r){try{return JSON.parse(n.readFileSync(e.join(o(t),r),`utf-8`).replace(/^\uFEFF/,``))}catch{return}}function c(e){let t=s(e,a);if(typeof t?.syncedAt==`string`)return t.syncedAt;let n=s(e,i);return typeof n?.syncedAt==`string`?n.syncedAt:void 0}function l(e){let t=s(e,i),n=c(e),r=t?.origins&&typeof t.origins==`object`?t.origins:void 0,a=t?.tsconfigOverrides&&typeof t.tsconfigOverrides==`object`?t.tsconfigOverrides:void 0,o=t?.snapshots&&typeof t.snapshots==`object`?t.snapshots:void 0,l=/* @__PURE__ */ new Set([`files`,`origins`,`syncedAt`,`tsconfigOverrides`,`snapshots`]),u=Object.fromEntries(Object.entries(t??{}).filter(([e])=>!l.has(e)));return{files:Array.isArray(t?.files)?t.files:[],...r?{origins:r}:{},...a?{tsconfigOverrides:a}:{},...o?{snapshots:o}:{},...Object.keys(u).length>0?{extras:u}:{},...n?{syncedAt:n}:{}}}function u(r,s,c,l,u){let d=o(r);n.mkdirSync(d,{recursive:!0});let f=[...new Set(s)].sort();n.writeFileSync(e.join(d,i),t({...u,files:f,...l?{origins:Object.fromEntries(f.filter(e=>l[e]!==void 0).map(e=>[e,l[e]]))}:{}}),`utf-8`),n.writeFileSync(e.join(d,a),t({syncedAt:c??(/* @__PURE__ */ new Date()).toISOString()}),`utf-8`)}export{r as MANIFEST_DIR,i as MANIFEST_FILE,a as TIMESTAMPS_FILE,l as readManifest,c as readSyncedAt,u as writeManifest};

package/dist/packages/core/src/provider-registry.d.ts

@@ -1,12 +1,57 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
 import { ToolchainProvider } from "../../shared/src/provider.js";
+import { RegistryPolicy } from "../../shared/src/registry-policy.js";
 import "../../shared/src/index.js";
 //#region packages/core/src/provider-registry.d.ts
-/** The absolute path of a project's provider registry file. */
+/** The absolute path of the legacy project provider file. */
+export declare function legacyProviderRegistryPath(cwd?: string): string;
+/** The default project provider registry file. */
 export declare function providerRegistryPath(cwd?: string): string;
-/** Read a project's custom providers (empty when the registry is absent/invalid). */
+/** The `~/.dbx/toolchain/.registry/providers` default global directory. */
+export declare function defaultGlobalProvidersDir(): string;
+/** The legacy global provider file. */
+export declare function globalProviderRegistryPath(): string;
+/** Add a project-scoped provider registry path (or remote URL). */
+export declare function addProjectProviderRegistry(cwd: string, entry: string): void;
+/** Remove a project-scoped provider registry path (never the implicit default). */
+export declare function removeProjectProviderRegistry(cwd: string, entry: string): void;
+/** Add a global provider registry path (or remote URL). */
+export declare function addGlobalProviderRegistry(entry: string): void;
+/** Remove a global provider registry path. */
+export declare function removeGlobalProviderRegistry(entry: string): void;
+/** Replace the global provider search paths. */
+export declare function setGlobalProviderRegistries(paths: string[]): void;
+/** Replace the project-scoped provider search paths. */
+export declare function setProjectProviderRegistries(cwd: string, paths: string[]): void;
+export interface ProviderRegistryPath {
+  path: string;
+  scope: 'project' | 'global';
+  remote: boolean;
+}
+/**
+ * Every provider registry path, project first (implicit dir + project entries +
+ * the legacy project file), then global (CLI config paths or the default dir,
+ * plus the legacy global file). Duplicates are removed.
+ */
+export declare function providerRegistryPaths(cwd?: string, policy?: RegistryPolicy): ProviderRegistryPath[];
+/** Read a project's custom providers from its provider search paths. */
 export declare function readProviderRegistry(cwd?: string): ToolchainProvider[];
-/** Write a project's custom providers (removing the file when the list is empty). */
+/** Write a project's custom providers to the default project registry file. */
 export declare function writeProviderRegistry(cwd: string, providers: ToolchainProvider[]): void;
+/** Read the global providers from the global search paths. */
+export declare function readGlobalProviders(): ToolchainProvider[];
+/** Write the global providers to the default global providers file. */
+export declare function writeGlobalProviders(providers: ToolchainProvider[]): void;
+/**
+ * The project + global providers from local registries, deduped by id (a
+ * project provider wins). Remote registries are skipped; use
+ * {@link readAllProviders} for those.
+ */
+export declare function readAllProvidersSync(cwd?: string, policy?: RegistryPolicy): ToolchainProvider[];
+/**
+ * The project + global providers from every search path, including remote
+ * registries, deduped by id (a project provider wins).
+ */
+export declare function readAllProviders(cwd?: string, policy?: RegistryPolicy): Promise<ToolchainProvider[]>;
 //#endregion

package/dist/packages/core/src/provider-registry.js

@@ -1 +1 @@
-import{default as e}from"node:path";import"node:url";import.meta.url;import t from"node:fs";const n=e.join(`.dbx`,`toolchain`);function r(t=process.cwd()){return e.join(t,n,`providers.json`)}function i(e=process.cwd()){try{let n=JSON.parse(t.readFileSync(r(e),`utf-8`));return Array.isArray(n)?n:[]}catch{return[]}}function a(n,i){let a=r(n);i.length===0?t.rmSync(a,{force:!0}):(t.mkdirSync(e.dirname(a),{recursive:!0}),t.writeFileSync(a,`${JSON.stringify(i,null,4)}\n`,`utf-8`))}export{r as providerRegistryPath,i as readProviderRegistry,a as writeProviderRegistry};
+import{default as e}from"node:path";import"node:url";import.meta.url;import{registrySourceAllowed as t}from"../../shared/src/registry-policy.js";import"../../shared/src/index.js";import n from"node:fs";import r from"node:os";const i=e.join(`.dbx`,`toolchain`),a=`providers.json`;function o(t){return t===`~`?r.homedir():t.startsWith(`~/`)||t.startsWith(`~\\`)?e.join(r.homedir(),t.slice(2)):t}function s(e){return/^https?:\/\//i.test(e)}function c(e){return e?(Array.isArray(e)?e:[e]).map(e=>o(String(e))).filter(Boolean):[]}function l(t=process.cwd()){return e.join(t,i,`providers.json`)}function u(t=process.cwd()){return e.join(t,i,`.registry`,`providers`,a)}function d(){return e.join(r.homedir(),`.dbx`,`toolchain`,`.registry`,`providers`)}function f(){return e.join(r.homedir(),`.dbx`,`toolchain`,`.registry`,a)}function p(){return e.join(r.homedir(),`.dbx`,`toolchain`,`cli`,`config.json`)}function m(){try{let e=n.readFileSync(p(),`utf-8`).replace(/^\uFEFF/,``),t=JSON.parse(e);return t&&typeof t==`object`?t:{}}catch{return{}}}function h(e=m()){if(e.providerRegistrySearchPaths!==void 0)return c(e.providerRegistrySearchPaths);let t=e.registrySearchPaths;return t&&typeof t==`object`&&!Array.isArray(t)?c(t.providers):[]}function g(t){return e.join(t,i,`registries.json`)}function _(e){try{let t=n.readFileSync(g(e),`utf-8`).replace(/^\uFEFF/,``),r=JSON.parse(t);return{templates:c(r.templates),providers:c(r.providers)}}catch{return{}}}function v(t,r){let i=g(t),a={...r.templates&&r.templates.length>0?{templates:r.templates}:{},...r.providers&&r.providers.length>0?{providers:r.providers}:{}};Object.keys(a).length===0?n.rmSync(i,{force:!0}):(n.mkdirSync(e.dirname(i),{recursive:!0}),n.writeFileSync(i,`${JSON.stringify(a,null,4)}\n`,`utf-8`))}function y(t){let r={...m(),...t},i=p();return n.mkdirSync(e.dirname(i),{recursive:!0}),n.writeFileSync(i,`${JSON.stringify(r,null,4)}\n`,`utf-8`),r}function b(t,n,r){let i=n=>s(n)?n:e.resolve(t,o(n));return i(n)===i(r)}function x(e,t){let n=_(e),r=n.providers??[];r.some(n=>b(e,n,t))||v(e,{...n.templates?{templates:n.templates}:{},providers:[...r,t]})}function S(e,t){let n=_(e);v(e,{...n.templates?{templates:n.templates}:{},...n.providers?{providers:n.providers.filter(n=>!b(e,n,t))}:{}})}function C(e){let t=h(m()),n=o(e);t.some(e=>b(process.cwd(),e,n))||y({providerRegistrySearchPaths:[...t,n]})}function w(e){let t=m(),n=o(e);y({providerRegistrySearchPaths:h(t).filter(e=>!b(process.cwd(),e,n))})}function T(e){y({providerRegistrySearchPaths:e.map(o)})}function E(e,t){let n=_(e);v(e,{...n.templates?{templates:n.templates}:{},providers:t})}function D(t){return(_(t).providers??[]).map(n=>s(n)?n:e.resolve(t,n))}function O(r=process.cwd(),a){let o=m(),c=[],u=e.join(r,i,`.registry`,`providers`);n.existsSync(u)&&c.push(u),c.push(...D(r)),n.existsSync(l(r))&&c.push(l(r));let p=[...h(o)],g=d();n.existsSync(g)&&p.push(g),n.existsSync(f())&&p.push(f());let _=/* @__PURE__ */ new Set,v=[];for(let[n,r]of[[`project`,c],[`global`,p]])for(let i of r){let r=s(i)?i:e.resolve(i);_.has(r)||t(r,a)&&(_.add(r),v.push({path:i,scope:n,remote:s(i)}))}return v}function k(e){return!!e&&typeof e==`object`&&typeof e.id==`string`&&typeof e.name==`string`&&Array.isArray(e.commands)}function A(e){return(Array.isArray(e)?e:e&&typeof e==`object`&&Array.isArray(e.providers)?e.providers:[]).filter(k)}function j(t){try{if(n.statSync(t).isDirectory()){let r=[];for(let i of n.readdirSync(t))i.toLowerCase().endsWith(`.json`)&&r.push(...j(e.join(t,i)));return r}return A(JSON.parse(n.readFileSync(t,`utf-8`)))}catch{return[]}}function M(t,r){r.length===0?n.rmSync(t,{force:!0}):(n.mkdirSync(e.dirname(t),{recursive:!0}),n.writeFileSync(t,`${JSON.stringify(r,null,4)}\n`,`utf-8`))}function N(e=process.cwd()){let t=/* @__PURE__ */ new Set,n=[];for(let r of O(e))if(!(r.scope!==`project`||r.remote))for(let e of j(r.path))t.has(e.id)||(t.add(e.id),n.push(e));return n}function P(e,t){M(u(e),t)}function F(){let e=/* @__PURE__ */ new Set,t=[];for(let n of O())if(!(n.scope!==`global`||n.remote))for(let r of j(n.path))e.has(r.id)||(e.add(r.id),t.push(r));return t}function I(t){M(e.join(d(),a),t)}function L(e){let t=/* @__PURE__ */ new Set,n=[];for(let r of e)t.has(r.id)||(t.add(r.id),n.push(r));return n}function R(e=process.cwd(),t){let n=O(e,t),r=n.filter(e=>e.scope===`project`&&!e.remote),i=n.filter(e=>e.scope===`global`&&!e.remote);return L([...r.flatMap(e=>j(e.path)),...i.flatMap(e=>j(e.path))])}async function z(e){try{let t=await fetch(e,{headers:{accept:`application/json`}});return t.ok?A(await t.json()):[]}catch{return[]}}async function B(e=process.cwd(),t){let n=O(e,t),r=[];for(let e of n)e.remote?r.push(...await z(e.path)):r.push(...j(e.path));return L(r)}export{C as addGlobalProviderRegistry,x as addProjectProviderRegistry,d as defaultGlobalProvidersDir,f as globalProviderRegistryPath,l as legacyProviderRegistryPath,u as providerRegistryPath,O as providerRegistryPaths,B as readAllProviders,R as readAllProvidersSync,F as readGlobalProviders,N as readProviderRegistry,w as removeGlobalProviderRegistry,S as removeProjectProviderRegistry,T as setGlobalProviderRegistries,E as setProjectProviderRegistries,I as writeGlobalProviders,P as writeProviderRegistry};

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

@@ -11,15 +11,27 @@ export interface ResetSelectors {
   /** Remove the `dbx.config.*` file(s). */
   config?: boolean;
 }
+/**
+ * Undo the state a sync applied to user-owned files before the manifest that
+ * records it is removed (eg. `tsconfig.overrides`). Returns the repo-relative
+ * files it restored (or would restore on a dry run).
+ */
+export type ResetRestore = (cwd: string, options: {
+  dryRun: boolean;
+}) => string[];
 export interface ResetToolchainOptions extends ResetSelectors {
   /** The project directory to reset. */
   cwd: string;
   /** Report what would be removed without deleting anything. */
   dryRun?: boolean;
+  /** Run before the manifest is removed, while its recorded state still exists. */
+  restore?: ResetRestore;
 }
 export interface ResetToolchainResult {
   /** Repo-relative paths removed (or that would be removed). */
   removed: string[];
+  /** User-owned files restored before the manifest was removed. */
+  restored: string[];
   /** Whether this was a dry run. */
   dryRun: boolean;
 }
@@ -34,12 +46,15 @@ export interface ResetProjectsOptions extends ResetSelectors, Omit<SelectProject
   /** Apply to every discovered project under `root` (not just `root`). */
   recursive?: boolean;
   dryRun?: boolean;
+  /** Run per project before its manifest is removed (see {@link ResetRestore}). */
+  restore?: ResetRestore;
 }
 export interface ResetProjectsResult {
   results: {
     dir: string;
     rel: string;
     removed: string[];
+    restored: string[];
   }[];
   dryRun: boolean;
 }

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

@@ -1 +1 @@
-import{default as e}from"node:path";import"node:url";import.meta.url;import{findConfigFile as t}from"./loader.js";import{MANIFEST_DIR as n,readManifest as r}from"./manifest.js";import{selectProjects as i}from"./select.js";import a from"node:fs";function o(e){return e.replace(/\\/g,`/`)}function s(e){let t=e.generated!==void 0||e.manifest!==void 0||e.config!==void 0;return{generated:e.generated??!t,manifest:e.manifest??!t,config:e.config??!1}}function c(i){let{cwd:c}=i,l=i.dryRun??!1,u=s(i),d=[],f=(e,t)=>{a.existsSync(e)&&(l||a.rmSync(e,{force:!0}),d.push(t))};if(u.generated)for(let t of r(c).files)f(e.resolve(c,t),t);if(u.config){let n=t(c);n&&f(n,o(e.relative(c,n)))}if(u.manifest){let t=e.resolve(c,n);a.existsSync(t)&&(l||a.rmSync(t,{recursive:!0,force:!0}),d.push(`${n}/`))}return{removed:d,dryRun:l}}function l(e){let n=e.dryRun??!1;return{results:(e.recursive?i({root:e.root,...e.include?{include:e.include}:{},...e.exclude?{exclude:e.exclude}:{},...e.maxDepth===void 0?{}:{maxDepth:e.maxDepth}}):[{dir:e.root,rel:`.`,hasConfig:!!t(e.root)}]).map(t=>({dir:t.dir,rel:t.rel,removed:c({cwd:t.dir,...e.generated===void 0?{}:{generated:e.generated},...e.manifest===void 0?{}:{manifest:e.manifest},...e.config===void 0?{}:{config:e.config},dryRun:n}).removed})),dryRun:n}}export{l as resetProjects,c as resetToolchain};
+import{default as e}from"node:path";import"node:url";import.meta.url;import{findConfigFile as t}from"./loader.js";import{MANIFEST_DIR as n,readManifest as r}from"./manifest.js";import{selectProjects as i}from"./select.js";import a from"node:fs";function o(e){return e.replace(/\\/g,`/`)}function s(e){let t=e.generated!==void 0||e.manifest!==void 0||e.config!==void 0;return{generated:e.generated??!t,manifest:e.manifest??!t,config:e.config??!1}}function c(i){let{cwd:c}=i,l=i.dryRun??!1,u=s(i),d=[],f=(e,t)=>{a.existsSync(e)&&(l||a.rmSync(e,{force:!0}),d.push(t))};if(u.generated){let t=r(c);for(let n of t.files)t.origins?.[n]!==`adopted`&&f(e.resolve(c,n),n)}if(u.config){let n=t(c);n&&f(n,o(e.relative(c,n)))}let p=[];if(u.manifest&&i.restore&&p.push(...i.restore(c,{dryRun:l})),u.manifest){let t=e.resolve(c,n);a.existsSync(t)&&(l||a.rmSync(t,{recursive:!0,force:!0}),d.push(`${n}/`))}return{removed:d,restored:p,dryRun:l}}function l(e){let n=e.dryRun??!1;return{results:(e.recursive?i({root:e.root,...e.include?{include:e.include}:{},...e.exclude?{exclude:e.exclude}:{},...e.maxDepth===void 0?{}:{maxDepth:e.maxDepth}}):[{dir:e.root,rel:`.`,hasConfig:!!t(e.root)}]).map(t=>{let{removed:r,restored:i}=c({cwd:t.dir,...e.generated===void 0?{}:{generated:e.generated},...e.manifest===void 0?{}:{manifest:e.manifest},...e.config===void 0?{}:{config:e.config},...e.restore?{restore:e.restore}:{},dryRun:n});return{dir:t.dir,rel:t.rel,removed:r,restored:i}}),dryRun:n}}export{l as resetProjects,c as resetToolchain};

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

@@ -12,6 +12,8 @@ export interface RunSyncOptions {
   cwd: string;
   /** The loaded config. */
   config: ToolchainConfig;
+  /** The project's own (unmerged) config, when known. */
+  ownConfig?: ToolchainConfig;
   /** The resolved replacement tokens. */
   tokens: Replacements;
   /** The project kind (resolved from the config/cwd when omitted). */
@@ -23,6 +25,12 @@ export interface RunSyncOptions {
   /** Custom logger (default `logger.info`). */
   log?: (message: string) => void;
 }
+export interface RemovedFile {
+  /** Repo-relative path. */
+  path: string;
+  /** The content before removal, so an editor can offer "Restore". */
+  content: string;
+}
 export interface SyncResult {
   /** Paths written (empty in check mode). */
   written: string[];
@@ -30,6 +38,8 @@ export interface SyncResult {
   changed: string[];
   /** Previously-managed paths removed because they are no longer generated. */
   removed: string[];
+  /** The removed files' previous content (for a Restore action). */
+  removedFiles: RemovedFile[];
   /** Whether disk already matched the generated output. */
   upToDate: boolean;
 }

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

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