@deltabox/toolchain 1.7.8 → 1.9.0

package/dist/packages/shared/src/config-schema.js

@@ -1 +1 @@
-import"node:path";import"node:url";import.meta.url;import{z as e}from"zod";const t=e.enum([`monorepo-root`,`monorepo-workspace`,`project`]).describe(`The project kind (detected when omitted).`).meta({id:`ProjectType`}),n=e.object({type:t.optional(),name:e.string().describe(`The unscoped project name.`).optional(),scope:e.string().describe("The npm scope, eg. `@acme`.").optional(),author:e.string().describe(`Package author.`).optional(),license:e.string().describe(`SPDX license id.`).optional(),homepage:e.string().describe(`Project homepage.`).optional(),repo:e.string().describe("Repository URL, eg. `https://github.com/acme/app`.").optional(),nodeVersion:e.string().describe("Node engine range, eg. `>=22`.").optional(),packageManager:e.string().describe("Package manager name (default `yarn`).").optional(),packageManagerVersion:e.string().describe("Package manager version, eg. `4.17.1`.").optional(),description:e.string().describe(`One-line description.`).optional()}).meta({id:`ToolchainProjectConfig`}),r=e.object({name:e.string().optional(),id:e.string().optional(),if:e.string().optional(),uses:e.string().optional(),run:e.string().optional(),shell:e.string().optional(),"working-directory":e.string().optional(),with:e.record(e.string(),e.union([e.string(),e.number(),e.boolean()])).optional(),env:e.record(e.string(),e.string()).optional()}).meta({id:`WorkflowStep`}),i=e.object({job:e.string().describe(`Target job id (defaults to the primary/first job).`).optional(),before:e.array(r).describe(`Steps inserted at the start.`).optional(),after:e.array(r).describe(`Steps appended at the end.`).optional()}).meta({id:`WorkflowStepsConfig`}),a=e.object({enabled:e.boolean().describe(`Enable/disable this workflow (default true).`).optional(),pushBranches:e.array(e.string()).describe("Replace `on.push.branches`.").optional(),pullRequestBranches:e.array(e.string()).describe("Replace `on.pull_request.branches`.").optional(),triggers:e.record(e.string(),e.unknown()).describe("Extra `on.*` triggers.").optional(),extra:e.record(e.string(),e.unknown()).describe("Extra top-level keys (`permissions`, `concurrency`, `env`, ...).").optional(),steps:e.union([i,e.array(i)]).describe(`Extra steps for a job (one group, or per-job groups).`).optional(),jobs:e.record(e.string(),e.unknown()).describe(`Extra complete jobs merged in.`).optional(),tokens:e.record(e.string(),e.union([e.string(),e.number(),e.boolean()])).describe("Per-workflow token overrides (`nodeVersion`, `packageManager`, ...).").optional()}).meta({id:`WorkflowConfig`}),o=e.union([e.boolean(),a]).meta({id:`WorkflowSetting`}),s=e.object({ci:o.optional(),changelog:o.optional(),release:o.optional(),issues:o.optional(),sync:o.optional()}).meta({id:`ChangelogWorkflowsConfig`}),c=e.enum([`uniform`,`root-only`,`individual`]).describe(`Where the changelog version bump is applied.`).meta({id:`ChangelogVersioningTarget`}),l=e.object({target:c.describe("`uniform` bumps the root and every workspace to one shared version; `root-only` bumps the root only; `individual` bumps each changed workspace independently (default `uniform`).").optional(),workspaces:e.array(e.string()).describe("Glob patterns selecting the workspaces to version (relative to the root). Defaults to the root `package.json` `workspaces` field; when there is none the root `package.json` is used on its own.").optional()}).meta({id:`ChangelogVersioningConfig`}),u=e.union([e.boolean(),l]).describe(`Automatic version bumping when a changelog entry is generated.`).meta({id:`ChangelogVersioning`}),d=e.object({enabled:e.boolean().describe(`Master switch (enabled when the section is defined).`).optional(),workflows:s.describe("Which workflows to write into `.github/workflows`.").optional(),branches:e.object({main:e.string().optional(),dev:e.string().optional()}).describe(`Branch names the workflows target.`).optional(),types:e.array(e.string()).describe(`Allowed commit types (commitlint).`).optional(),scopes:e.array(e.string()).describe(`Allowed commit scopes (commitlint).`).optional(),versioning:u.describe("Automatic version bumping on changelog generation (default `true`).").optional(),vscode:e.boolean().describe(`Write the Conventional-Commits VS Code settings.`).optional()}).meta({id:`ToolchainChangelogConfig`}),f=e.object({enabled:e.boolean().describe(`Master switch (enabled when the section is defined).`).optional(),vscode:e.boolean().describe(`Write the Biome VS Code settings (default true).`).optional(),overrides:e.record(e.string(),e.unknown()).describe("Deep-merged over the generated `biome.json` (arrays union).").optional()}).meta({id:`ToolchainBiomeConfig`}),p=e.object({enabled:e.boolean().describe(`Master switch (enabled when the section is defined).`).optional(),glob:e.string().describe("Glob for workspace `tsconfig.default.json` files.").optional(),appGlob:e.string().describe(`Glob for "override" (app) workspaces.`).optional(),refs:e.boolean().describe(`Wire project references (default false).`).optional(),composite:e.boolean().describe("Emit `composite: true` (default false).").optional(),aliases:e.boolean().describe(`Inject path aliases (default true).`).optional(),indent:e.number().describe(`JSON indentation (default 4).`).optional(),rootFile:e.string().describe("The monorepo tsconfig file name (default `tsconfig.monorepo.json`).").optional()}).meta({id:`ToolchainTsconfigConfig`}),m=e.object({enabled:e.boolean().describe(`Watch by default (enabled when the section is defined).`).optional(),debounce:e.number().describe(`Debounce window in ms (default 150).`).optional()}).meta({id:`ToolchainWatchConfig`}),h=e.object({level:e.enum([`debug`,`info`,`warn`,`error`,`silent`]).describe("Minimum level to print (default `info`).").optional(),color:e.boolean().describe("Force colours on/off (default: on; `--no-color` disables).").optional(),name:e.string().describe("Prefix non-indented lines with `<name>:` (default `dbx`).").optional()}).meta({id:`ToolchainLoggerConfig`}),g=e.object({color:e.boolean().describe(`Force provider command colours on/off (default: inherit the logger).`).optional()}).meta({id:`ToolchainProvidersConfig`}),_=e.enum([`builtin`,`local`,`npm`,`git`,`vite-plus`]).describe(`How to load the source.`).meta({id:`ToolchainTemplateSourceType`}),v=e.enum([`project`,`workspace`,`application`,`folder`,`tooling`,`pipeline`]).describe(`What the template produces.`).meta({id:`ToolchainTemplateKind`}),y=e.object({type:_,locate:e.string().describe(`A builtin id, local dir, npm scope, git URL or Vite+ id.`),id:e.string().describe(`Stable id (defaults to the basename/scope).`).optional(),name:e.string().describe(`Display name override.`).optional(),description:e.string().describe(`Description override.`).optional(),kind:v.optional(),ref:e.string().describe(`Git branch/tag/commit.`).optional(),subdir:e.string().describe(`Subdirectory within the source that holds the template.`).optional(),tags:e.array(e.string()).describe(`Free-form tags.`).optional(),online:e.boolean().describe(`Whether the source needs network access.`).optional()}).meta({id:`ToolchainTemplateSource`}),b=e.object({enabled:e.boolean().describe(`Master switch (enabled when the section is defined).`).optional(),sources:e.array(y).describe(`Extra sources on top of the builtin + registry sources.`).optional()}).meta({id:`ToolchainTemplatesConfig`}),x=e.object({config:e.boolean().describe("Write the managed `vite.config.ts` (default true).").optional()}).catchall(e.unknown()).meta({id:`ToolchainViteConfig`});function S(t){return e.union([e.boolean(),t])}const C=e.object({project:n.optional(),changelog:S(d).optional(),biome:S(f).optional(),tsconfig:S(p).optional(),templates:S(b).optional(),vite:S(x).optional(),watch:S(m).optional(),logger:S(h).optional(),providers:S(g).optional()}).meta({id:`ToolchainConfigSections`}),w=e.object({toolchain:C.optional()}).meta({id:`DbxConfigSections`}),T={ProjectType:t,ToolchainProjectConfig:n,WorkflowStep:r,WorkflowStepsConfig:i,WorkflowConfig:a,WorkflowSetting:o,ChangelogWorkflowsConfig:s,ChangelogVersioningTarget:c,ChangelogVersioningConfig:l,ChangelogVersioning:u,ToolchainChangelogConfig:d,ToolchainBiomeConfig:f,ToolchainTsconfigConfig:p,ToolchainWatchConfig:m,ToolchainTemplateSourceType:_,ToolchainTemplateKind:v,ToolchainTemplateSource:y,ToolchainTemplatesConfig:b,ToolchainViteConfig:x,ToolchainLoggerConfig:h,ToolchainProvidersConfig:g,ToolchainConfigSections:C,DbxConfigSections:w},E={project:n,changelog:d,biome:f,tsconfig:p,templates:b,vite:x,watch:m,logger:h,providers:g},D={project:`Project metadata used as replacement tokens across every template.`,changelog:`Conventional-Commits CI, commitlint and the changelog pipeline.`,biome:"Biome config generation (for consumers that still want a `biome.json`).",tsconfig:`Workspace tsconfig generation (path aliases + project references).`,templates:`Template sources / scaffolding.`,vite:"The full Vite+ config; `dbx sync` writes the root `vite.config.ts` from it.",watch:"Watch behaviour for `dbx watch`.",logger:`Logging level, colours and prefix for toolchain output.`,providers:`Provider command behaviour (eg. colour for the provider passthrough commands).`};export{D as CONFIG_SECTION_DESCRIPTIONS,E as CONFIG_SECTION_SCHEMAS,T as CONFIG_TYPE_SCHEMAS,f as biomeConfigSchema,d as changelogConfigSchema,l as changelogVersioningConfigSchema,u as changelogVersioningSchema,c as changelogVersioningTargetSchema,s as changelogWorkflowsConfigSchema,w as dbxConfigSchema,h as loggerConfigSchema,n as projectConfigSchema,t as projectTypeSchema,g as providersConfigSchema,v as templateKindSchema,y as templateSourceSchema,_ as templateSourceTypeSchema,b as templatesConfigSchema,C as toolchainConfigSchema,p as tsconfigConfigSchema,x as viteConfigSchema,m as watchConfigSchema,a as workflowConfigSchema,o as workflowSettingSchema,r as workflowStepSchema,i as workflowStepsConfigSchema};
+import"node:path";import"node:url";import.meta.url;import{z as e}from"zod";const t=e.enum([`monorepo-root`,`monorepo-workspace`,`project`]).describe(`The project kind (detected when omitted).`).meta({id:`ProjectType`}),n=e.object({type:t.optional(),name:e.string().describe("The unscoped project name (written as `<scope>/<name>`).").optional(),scope:e.string().describe("The npm scope, eg. `@acme`.").optional(),author:e.string().describe("Package author (`package.json` `author`).").optional(),license:e.string().describe("SPDX license id (`package.json` `license`).").optional(),homepage:e.string().describe("Project homepage (`package.json` `homepage`).").optional(),repo:e.string().describe("Repository URL (`package.json` `repository`). For a workspace it also resolves to the workspace path (`repository.directory`).").optional(),nodeVersion:e.string().describe("Node version for CI/templates, eg. `22` (not `package.json` `engines`).").optional(),packageManager:e.string().describe("Package manager name, written as `<name>@<version>` (default `yarn`).").optional(),packageManagerVersion:e.string().describe("Package manager version, eg. `4.17.1`.").optional(),description:e.string().describe("One-line description (`package.json` `description`).").optional(),inherit:e.boolean().describe(`Inherit the parent project metadata (default true). Set false to keep this project entirely independent of the root config.`).optional()}).meta({id:`ToolchainProjectConfig`}),r=e.object({name:e.string().describe(`Step display name.`).optional(),id:e.string().describe("Step id (for `steps.<id>` outputs).").optional(),if:e.string().describe("Conditional expression (`if:`).").optional(),uses:e.string().describe("Action to run (`uses:`), eg. `actions/checkout@v4`.").optional(),run:e.string().describe("Shell command(s) to run (`run:`).").optional(),shell:e.string().describe("Shell to run `run` in, eg. `bash`.").optional(),"working-directory":e.string().describe(`Directory the step runs in.`).optional(),with:e.record(e.string(),e.union([e.string(),e.number(),e.boolean()])).describe("Inputs for a `uses` action.").optional(),env:e.record(e.string(),e.string()).describe(`Environment variables for the step.`).optional()}).meta({id:`WorkflowStep`}),i=e.object({job:e.string().describe(`Target job id (defaults to the primary/first job).`).optional(),before:e.array(r).describe(`Steps inserted at the start.`).optional(),after:e.array(r).describe(`Steps appended at the end.`).optional()}).meta({id:`WorkflowStepsConfig`}),a=e.object({enabled:e.boolean().describe(`Enable/disable this workflow (default true).`).optional(),pushBranches:e.array(e.string()).describe("Replace `on.push.branches`.").optional(),pullRequestBranches:e.array(e.string()).describe("Replace `on.pull_request.branches`.").optional(),triggers:e.record(e.string(),e.unknown()).describe("Extra `on.*` triggers.").optional(),extra:e.record(e.string(),e.unknown()).describe("Extra top-level keys (`permissions`, `concurrency`, `env`, ...).").optional(),steps:e.union([i,e.array(i)]).describe(`Extra steps for a job (one group, or per-job groups).`).optional(),jobs:e.record(e.string(),e.unknown()).describe(`Extra complete jobs merged in.`).optional(),tokens:e.record(e.string(),e.union([e.string(),e.number(),e.boolean()])).describe("Per-workflow token overrides (`nodeVersion`, `packageManager`, ...).").optional()}).meta({id:`WorkflowConfig`}),o=e.union([e.boolean(),e.string(),a]).describe("`true`/`false` to enable/disable, an object to override parts of the default, or a raw YAML string written verbatim as the workflow file.").meta({id:`WorkflowSetting`}),s=e.object({ci:o.describe("The CI workflow (`ci.yml`).").optional(),changelog:o.describe("The changelog/version workflow (`changelog.yml`).").optional(),release:o.describe("The release workflow (`release.yml`).").optional(),issues:o.describe("The issue-title workflow (`issues.yml`).").optional(),sync:o.describe("The toolchain sync workflow (`sync.yml`).").optional()}).meta({id:`ChangelogWorkflowsConfig`}),c=e.enum([`uniform`,`root-only`,`individual`]).describe(`Where the changelog version bump is applied.`).meta({id:`ChangelogVersioningTarget`}),l=e.object({target:c.describe("`uniform` bumps the root and every workspace to one shared version; `root-only` bumps the root only; `individual` bumps each changed workspace independently (default `uniform`).").optional(),workspaces:e.array(e.string()).describe("Glob patterns selecting the workspaces to version (relative to the root). Defaults to the root `package.json` `workspaces` field; when there is none the root `package.json` is used on its own.").optional()}).meta({id:`ChangelogVersioningConfig`}),u=e.union([e.boolean(),l]).describe(`Automatic version bumping when a changelog entry is generated.`).meta({id:`ChangelogVersioning`}),d=e.object({enabled:e.boolean().describe(`Master switch (enabled when the section is defined).`).optional(),workflows:s.describe("Which workflows to write into `.github/workflows`. Each id is `true`/`false`, an object of overrides, or a raw YAML string written verbatim.").optional(),branches:e.object({main:e.union([e.string(),e.array(e.string())]).describe('Branch glob(s) the CI + release workflows run on, and the release PR base (default `["main"]`).').optional(),dev:e.union([e.string(),e.array(e.string())]).describe("Branch glob(s) the changelog/version workflow runs on. No default: when omitted it reuses `main` (so a single-branch repo needs no `dev`).").optional()}).describe(`Branches the generated workflows target.`).optional(),types:e.array(e.string()).describe(`Allowed commit types (commitlint).`).optional(),scopes:e.array(e.string()).describe(`Allowed commit scopes (commitlint).`).optional(),commitlint:e.object({dir:e.string().describe("Directory the generated `commitlint.config.mjs` is written to (default: the project root). The husky hook and CI use `--config` to point at it.").optional()}).describe(`commitlint config output location.`).optional(),versioning:u.describe("Automatic version bumping on changelog generation (default `true`).").optional(),vscode:e.boolean().describe(`Write the Conventional-Commits VS Code settings.`).optional()}).meta({id:`ToolchainChangelogConfig`}),f=e.object({enabled:e.boolean().describe(`Master switch (enabled when the section is defined).`).optional(),vscode:e.boolean().describe(`Write the Biome VS Code settings (default true).`).optional(),overrides:e.record(e.string(),e.unknown()).describe("Deep-merged over the generated `biome.json` (arrays union).").optional()}).meta({id:`ToolchainBiomeConfig`}),p=e.object({enabled:e.boolean().describe(`Master switch (enabled when the section is defined).`).optional(),glob:e.union([e.string(),e.array(e.string())]).describe("Glob(s) for the workspace default tsconfig files. Defaults to matching every `defaultFile` recursively.").optional(),exclude:e.union([e.string(),e.array(e.string())]).describe("Glob(s) to exclude from `glob`. Defaults to the common ignored paths (`node_modules`, `.dbx`, `dist`, `build`, ...).").optional(),gitignore:e.boolean().describe("Also respect `.gitignore` files (root + nested) when matching `glob` (default true).").optional(),refs:e.boolean().describe(`Wire project references (default false).`).optional(),composite:e.boolean().describe("Emit `composite: true` (default false).").optional(),aliases:e.boolean().describe(`Inject path aliases (default true).`).optional(),indent:e.number().describe(`JSON indentation (default 4).`).optional(),rootFile:e.string().describe("The workspaces tsconfig file name that holds `paths` + `references` (default `tsconfig.workspaces.json`).").optional(),defaultFile:e.string().describe("The workspace default tsconfig file name that the generator expands (default `tsconfig.default.json`).").optional(),buildFile:e.string().describe("The workspace build tsconfig file name (default `tsconfig.build.json`).").optional()}).meta({id:`ToolchainTsconfigConfig`}),m=e.object({enabled:e.boolean().describe(`Watch by default (enabled when the section is defined).`).optional(),debounce:e.number().describe(`Debounce window in ms (default 150).`).optional(),exclude:e.union([e.string(),e.array(e.string())]).describe("Glob(s) excluded from watching. Defaults to the common ignored paths (`node_modules`, `.dbx`, `dist`, `build`, ...).").optional(),gitignore:e.boolean().describe("Also respect `.gitignore` files (root + nested) when watching (default true).").optional()}).meta({id:`ToolchainWatchConfig`}),h=e.object({level:e.enum([`debug`,`info`,`warn`,`error`,`silent`]).describe("Minimum level to print (default `info`).").optional(),color:e.boolean().describe("Force colours on/off (default: on; `--no-color` disables).").optional(),name:e.string().describe("Prefix non-indented lines with `<name>:` (default `dbx`).").optional()}).meta({id:`ToolchainLoggerConfig`}),g=e.object({color:e.boolean().describe(`Force provider command colours on/off (default: inherit the logger).`).optional()}).meta({id:`ToolchainProvidersConfig`}),_=e.enum([`builtin`,`local`,`npm`,`git`,`vite-plus`]).describe(`How to load the source.`).meta({id:`ToolchainTemplateSourceType`}),v=e.enum([`project`,`workspace`,`application`,`folder`,`tooling`,`pipeline`]).describe(`What the template produces.`).meta({id:`ToolchainTemplateKind`}),y=e.object({type:_.describe(`How to load the source.`),locate:e.string().describe(`A builtin id, local dir, npm scope, git URL or Vite+ id.`),id:e.string().describe(`Stable id (defaults to the basename/scope).`).optional(),name:e.string().describe(`Display name override.`).optional(),description:e.string().describe(`Description override.`).optional(),kind:v.describe(`What the template produces.`).optional(),ref:e.string().describe(`Git branch/tag/commit.`).optional(),subdir:e.string().describe(`Subdirectory within the source that holds the template.`).optional(),tags:e.array(e.string()).describe(`Free-form tags.`).optional(),online:e.boolean().describe(`Whether the source needs network access.`).optional()}).meta({id:`ToolchainTemplateSource`}),b=e.object({enabled:e.boolean().describe(`Master switch (enabled when the section is defined).`).optional(),sources:e.array(y).describe(`Extra sources on top of the builtin + registry sources.`).optional()}).meta({id:`ToolchainTemplatesConfig`}),x=e.object({config:e.boolean().describe("Write the managed `vite.config.ts` (default true).").optional()}).catchall(e.unknown()).meta({id:`ToolchainViteConfig`});function S(t){return e.union([e.boolean(),t])}const C=e.object({project:n.describe("Project metadata: canonical `package.json` fields and template tokens (inherited by workspaces).").optional(),changelog:S(d).describe(`Conventional-Commits CI, commitlint and the changelog pipeline.`).optional(),biome:S(f).describe("Biome config generation (for consumers that still want a `biome.json`).").optional(),tsconfig:S(p).describe(`Workspace tsconfig generation (path aliases + project references).`).optional(),templates:S(b).describe(`Template sources / scaffolding.`).optional(),vite:S(x).describe("The full Vite+ config; `dbx sync` writes the root `vite.config.ts` from it.").optional(),watch:S(m).describe("Watch behaviour for `dbx watch`.").optional(),logger:S(h).describe(`Logging level, colours and prefix for toolchain output.`).optional(),providers:S(g).describe(`Provider command behaviour (eg. colour for the passthrough commands).`).optional()}).meta({id:`ToolchainConfigSections`}),w=e.object({toolchain:C.describe("The `@deltabox/toolchain` settings (every section is opt-in by presence).").optional()}).meta({id:`DbxConfigSections`}),T={ProjectType:t,ToolchainProjectConfig:n,WorkflowStep:r,WorkflowStepsConfig:i,WorkflowConfig:a,WorkflowSetting:o,ChangelogWorkflowsConfig:s,ChangelogVersioningTarget:c,ChangelogVersioningConfig:l,ChangelogVersioning:u,ToolchainChangelogConfig:d,ToolchainBiomeConfig:f,ToolchainTsconfigConfig:p,ToolchainWatchConfig:m,ToolchainTemplateSourceType:_,ToolchainTemplateKind:v,ToolchainTemplateSource:y,ToolchainTemplatesConfig:b,ToolchainViteConfig:x,ToolchainLoggerConfig:h,ToolchainProvidersConfig:g,ToolchainConfigSections:C,DbxConfigSections:w},E={project:n,changelog:d,biome:f,tsconfig:p,templates:b,vite:x,watch:m,logger:h,providers:g},D={project:"Project metadata: canonical `package.json` fields (applied on sync, inherited by workspaces) plus the replacement tokens every template understands.",changelog:`Conventional-Commits CI, commitlint and the changelog pipeline.`,biome:"Biome config generation (for consumers that still want a `biome.json`).",tsconfig:`Workspace tsconfig generation (path aliases + project references).`,templates:`Template sources / scaffolding.`,vite:"The full Vite+ config; `dbx sync` writes the root `vite.config.ts` from it.",watch:"Watch behaviour for `dbx watch`.",logger:`Logging level, colours and prefix for toolchain output.`,providers:`Provider command behaviour (eg. colour for the provider passthrough commands).`};export{D as CONFIG_SECTION_DESCRIPTIONS,E as CONFIG_SECTION_SCHEMAS,T as CONFIG_TYPE_SCHEMAS,f as biomeConfigSchema,d as changelogConfigSchema,l as changelogVersioningConfigSchema,u as changelogVersioningSchema,c as changelogVersioningTargetSchema,s as changelogWorkflowsConfigSchema,w as dbxConfigSchema,h as loggerConfigSchema,n as projectConfigSchema,t as projectTypeSchema,g as providersConfigSchema,v as templateKindSchema,y as templateSourceSchema,_ as templateSourceTypeSchema,b as templatesConfigSchema,C as toolchainConfigSchema,p as tsconfigConfigSchema,x as viteConfigSchema,m as watchConfigSchema,a as workflowConfigSchema,o as workflowSettingSchema,r as workflowStepSchema,i as workflowStepsConfigSchema};

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

@@ -5,36 +5,53 @@ import { ViteUserConfig } from "vite-plus";
 export type ProjectType = 'monorepo-root' | 'monorepo-workspace' | 'project';
 export interface ToolchainProjectConfig {
   type?: ProjectType;
-  /** The unscoped project name. */
+  /** The unscoped project name (written as `<scope>/<name>`). */
   name?: string;
   /** The npm scope, eg. `@acme`. */
   scope?: string;
-  /** Package author. */
+  /** Package author (`package.json` `author`). */
   author?: string;
-  /** SPDX license id. */
+  /** SPDX license id (`package.json` `license`). */
   license?: string;
-  /** Project homepage. */
+  /** Project homepage (`package.json` `homepage`). */
   homepage?: string;
-  /** Repository URL, eg. `https://github.com/acme/app`. */
+  /**
+   * Repository URL (`package.json` `repository`). For a workspace it also resolves to the workspace
+   * path (`repository.directory`).
+   */
   repo?: string;
-  /** Node engine range, eg. `>=22`. */
+  /** Node version for CI/templates, eg. `22` (not `package.json` `engines`). */
   nodeVersion?: string;
-  /** Package manager name (default `yarn`). */
+  /** Package manager name, written as `<name>@<version>` (default `yarn`). */
   packageManager?: string;
   /** Package manager version, eg. `4.17.1`. */
   packageManagerVersion?: string;
-  /** One-line description. */
+  /** One-line description (`package.json` `description`). */
   description?: string;
+  /**
+   * Inherit the parent project metadata (default true). Set false to keep this project entirely
+   * independent of the root config.
+   */
+  inherit?: boolean;
 }
 export interface WorkflowStep {
+  /** Step display name. */
   name?: string;
+  /** Step id (for `steps.<id>` outputs). */
   id?: string;
+  /** Conditional expression (`if:`). */
   if?: string;
+  /** Action to run (`uses:`), eg. `actions/checkout@v4`. */
   uses?: string;
+  /** Shell command(s) to run (`run:`). */
   run?: string;
+  /** Shell to run `run` in, eg. `bash`. */
   shell?: string;
+  /** Directory the step runs in. */
   'working-directory'?: string;
+  /** Inputs for a `uses` action. */
   with?: Record<string, string | number | boolean>;
+  /** Environment variables for the step. */
   env?: Record<string, string>;
 }
 export interface WorkflowStepsConfig {
@@ -63,7 +80,7 @@ export interface WorkflowConfig {
   /** Per-workflow token overrides (`nodeVersion`, `packageManager`, ...). */
   tokens?: Record<string, string | number | boolean>;
 }
-export type WorkflowSetting = boolean | WorkflowConfig;
+export type WorkflowSetting = boolean | string | WorkflowConfig;
 export interface ChangelogWorkflowsConfig {
   ci?: WorkflowSetting;
   changelog?: WorkflowSetting;
@@ -87,13 +104,25 @@ export interface ToolchainChangelogConfig {
   enabled?: boolean;
   workflows?: ChangelogWorkflowsConfig;
   branches?: {
-    main?: string;
-    dev?: string;
+    /** Branch glob(s) the CI + release workflows run on, and the release PR base (default `["main"]`). */
+    main?: string | Array<string>;
+    /**
+     * Branch glob(s) the changelog/version workflow runs on. No default: when omitted it reuses
+     * `main` (so a single-branch repo needs no `dev`).
+     */
+    dev?: string | Array<string>;
   };
   /** Allowed commit types (commitlint). */
   types?: Array<string>;
   /** Allowed commit scopes (commitlint). */
   scopes?: Array<string>;
+  commitlint?: {
+    /**
+     * Directory the generated `commitlint.config.mjs` is written to (default: the project root). The
+     * husky hook and CI use `--config` to point at it.
+     */
+    dir?: string;
+  };
   versioning?: ChangelogVersioning;
   /** Write the Conventional-Commits VS Code settings. */
   vscode?: boolean;
@@ -109,10 +138,18 @@ export interface ToolchainBiomeConfig {
 export interface ToolchainTsconfigConfig {
   /** Master switch (enabled when the section is defined). */
   enabled?: boolean;
-  /** Glob for workspace `tsconfig.default.json` files. */
-  glob?: string;
-  /** Glob for "override" (app) workspaces. */
-  appGlob?: string;
+  /**
+   * Glob(s) for the workspace default tsconfig files. Defaults to matching every `defaultFile`
+   * recursively.
+   */
+  glob?: string | Array<string>;
+  /**
+   * Glob(s) to exclude from `glob`. Defaults to the common ignored paths (`node_modules`, `.dbx`,
+   * `dist`, `build`, ...).
+   */
+  exclude?: string | Array<string>;
+  /** Also respect `.gitignore` files (root + nested) when matching `glob` (default true). */
+  gitignore?: boolean;
   /** Wire project references (default false). */
   refs?: boolean;
   /** Emit `composite: true` (default false). */
@@ -121,14 +158,31 @@ export interface ToolchainTsconfigConfig {
   aliases?: boolean;
   /** JSON indentation (default 4). */
   indent?: number;
-  /** The monorepo tsconfig file name (default `tsconfig.monorepo.json`). */
+  /**
+   * The workspaces tsconfig file name that holds `paths` + `references` (default
+   * `tsconfig.workspaces.json`).
+   */
   rootFile?: string;
+  /**
+   * The workspace default tsconfig file name that the generator expands (default
+   * `tsconfig.default.json`).
+   */
+  defaultFile?: string;
+  /** The workspace build tsconfig file name (default `tsconfig.build.json`). */
+  buildFile?: string;
 }
 export interface ToolchainWatchConfig {
   /** Watch by default (enabled when the section is defined). */
   enabled?: boolean;
   /** Debounce window in ms (default 150). */
   debounce?: number;
+  /**
+   * Glob(s) excluded from watching. Defaults to the common ignored paths (`node_modules`, `.dbx`,
+   * `dist`, `build`, ...).
+   */
+  exclude?: string | Array<string>;
+  /** Also respect `.gitignore` files (root + nested) when watching (default true). */
+  gitignore?: boolean;
 }
 export type ToolchainTemplateSourceType = 'builtin' | 'local' | 'npm' | 'git' | 'vite-plus';
 export type ToolchainTemplateKind = 'project' | 'workspace' | 'application' | 'folder' | 'tooling' | 'pipeline';
@@ -181,13 +235,21 @@ export interface ToolchainProvidersConfig {
 }
 export interface ToolchainConfigSections {
   project?: ToolchainProjectConfig;
+  /** Conventional-Commits CI, commitlint and the changelog pipeline. */
   changelog?: boolean | ToolchainChangelogConfig;
+  /** Biome config generation (for consumers that still want a `biome.json`). */
   biome?: boolean | ToolchainBiomeConfig;
+  /** Workspace tsconfig generation (path aliases + project references). */
   tsconfig?: boolean | ToolchainTsconfigConfig;
+  /** Template sources / scaffolding. */
   templates?: boolean | ToolchainTemplatesConfig;
+  /** The full Vite+ config; `dbx sync` writes the root `vite.config.ts` from it. */
   vite?: boolean | ToolchainViteConfig;
+  /** Watch behaviour for `dbx watch`. */
   watch?: boolean | ToolchainWatchConfig;
+  /** Logging level, colours and prefix for toolchain output. */
   logger?: boolean | ToolchainLoggerConfig;
+  /** Provider command behaviour (eg. colour for the passthrough commands). */
   providers?: boolean | ToolchainProvidersConfig;
 }
 export interface DbxConfigSections {

package/dist/packages/shared/src/ignore.d.ts

@@ -0,0 +1,38 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+//#region packages/shared/src/ignore.d.ts
+/**
+ * Path ignoring for the glob-based consumers (`tsconfig`, `watch`).
+ *
+ * Every ignore list starts from {@link DEFAULT_IGNORE_PATTERNS} (the common
+ * build/dependency dirs), the consumer's `exclude` globs are appended, and — when
+ * `gitignore` is on (the default) — the repo's `.gitignore` files are folded in
+ * (root **and nested**, each scoped to its own directory, like git).
+ */
+/** The common paths always ignored (dependency/build/cache dirs). */
+export declare const DEFAULT_IGNORE_PATTERNS: readonly string[];
+/** Options shared by the `tsconfig` / `watch` ignore resolution. */
+export interface IgnoreOptions {
+  /** Extra glob(s) to exclude on top of the defaults. */
+  exclude?: string | string[];
+  /** Respect `.gitignore` files (default true). */
+  gitignore?: boolean;
+}
+/**
+ * Collect the ignore globs from every `.gitignore` in the tree (root + nested),
+ * each scoped to its own directory.
+ *
+ * The walk is manual (not `readdirSync({ recursive: true })`, which **follows
+ * symlinks/junctions** and would loop forever on a self-link such as a
+ * `portal:.` / `portal:../..` workspace dependency). Symlinks are never followed
+ * and ignored directories are never descended into.
+ */
+export declare function collectGitignorePatterns(cwd?: string): string[];
+/**
+ * The full ignore list for a consumer: the defaults, plus `exclude`, plus (when
+ * `gitignore` is on) the tree's `.gitignore` globs.
+ */
+export declare function resolveIgnorePatterns(cwd?: string, options?: IgnoreOptions): string[];
+/** Whether a repo-relative path matches any of the ignore globs. */
+export declare function isIgnoredPath(relativePath: string, patterns: readonly string[]): boolean;
+//#endregion

package/dist/packages/shared/src/ignore.js

@@ -0,0 +1 @@
+import{default as e}from"node:path";import"node:url";import.meta.url;import t from"node:fs";const n=[`**/node_modules/**`,`**/.git/**`,`**/.dbx/**`,`**/dist/**`,`**/build/**`,`**/out/**`,`**/coverage/**`,`**/.turbo/**`,`**/.yarn/**`,`**/.next/**`,`**/.cache/**`,`**/.output/**`,`**/.vite/**`,`**/.nyc_output/**`,`**/*.tsbuildinfo`],r=/* @__PURE__ */ new Set([`node_modules`,`.git`,`.dbx`,`dist`,`build`,`out`,`coverage`,`.turbo`,`.yarn`,`.next`,`.cache`,`.output`,`.vite`]);function i(e){return e===void 0?[]:Array.isArray(e)?e:[e]}function a(e,t){let n=e.trim();if(!n||n.startsWith(`#`)||n.startsWith(`!`))return[];n.endsWith(`/`)&&(n=n.replace(/\/+$/,``));let r=n.startsWith(`/`);if(r&&(n=n.slice(1)),!n)return[];let i=t?`${t}/`:``,a=`${r?i:`${i}**/`}${n}`;return a.endsWith(`/**`)?[a]:[a,`${a}/**`]}function o(e,n){let r;try{r=t.readFileSync(e,`utf-8`)}catch{return[]}let i=[];for(let e of r.split(/\r?\n/))i.push(...a(e,n));return i}function s(n=process.cwd()){let i=[],a=e.join(n,`.gitignore`);t.existsSync(a)&&i.push(...o(a,``));let s=a=>{let c;try{c=t.readdirSync(a,{withFileTypes:!0})}catch{return}for(let t of c){if(t.isSymbolicLink())continue;let c=e.join(a,t.name);if(t.isDirectory()){if(r.has(t.name))continue;s(c)}else if(t.isFile()&&t.name===`.gitignore`){let t=e.relative(n,a).replace(/\\/g,`/`);if(t===``)continue;i.push(...o(c,t))}}};return s(n),i}function c(e=process.cwd(),t={}){let r=[...n,...i(t.exclude)];return t.gitignore!==!1&&r.push(...s(e)),r}function l(e){let t=``;for(let n=0;n<e.length;n++){let r=e[n];r===`*`?e[n+1]===`*`?e[n+2]===`/`?(t+=`(?:.*/)?`,n+=2):(t+=`.*`,n+=1):t+=`[^/]*`:r===`?`?t+=`[^/]`:".+^${}()|[]\\".includes(r)?t+=`\\${r}`:t+=r}return RegExp(`^${t}$`)}function u(e,t){let n=e.replace(/\\/g,`/`).replace(/^\.\//,``);for(let e of t){let t=l(e);if(t.test(n)||t.test(`${n}/`))return!0}return!1}export{n as DEFAULT_IGNORE_PATTERNS,s as collectGitignorePatterns,u as isIgnoredPath,c as resolveIgnorePatterns};

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

@@ -2,19 +2,21 @@ import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
 import { TOOLCHAIN_PACKAGE, findOwnCliEntry, localToolchainVersion } from "./bin.js";
 import { mergeJsonAt, readJsonAt, readJsonFile, toJson, writeJsonFile } from "./fs-utils.js";
+import { DEFAULT_IGNORE_PATTERNS, IgnoreOptions, collectGitignorePatterns, isIgnoredPath, resolveIgnorePatterns } from "./ignore.js";
 import { Colors, LOG_LEVELS, LogChannel, LogLevel, Logger, LoggerConfig, LoggerOptions, configureLogger, createLogger, getLogOverrides, getLogger, isLogLevel, logger, normalizeLogLevel, setLogConfig, setLogOverrides, stripAnsi } from "./logger.js";
 import { Sortable, deepMerge, isPlainObject, mapValues, resolveSort, sort } from "./object-utils.js";
+import { ChangelogVersioning, ChangelogVersioningConfig, ChangelogVersioningTarget, ChangelogWorkflowsConfig, DbxConfigSections, ProjectType, ToolchainBiomeConfig, ToolchainChangelogConfig, ToolchainConfigSections, ToolchainLoggerConfig, ToolchainProjectConfig, ToolchainProvidersConfig, ToolchainTemplateKind, ToolchainTemplateSource, ToolchainTemplateSourceType, ToolchainTemplatesConfig, ToolchainTsconfigConfig, ToolchainViteConfig, ToolchainWatchConfig, WorkflowConfig, WorkflowSetting, WorkflowStep, WorkflowStepsConfig } from "./config-types.js";
+import { ReplacementOptions, ReplacementValue, Replacements, Replacer, applyReplacements, applyReplacementsDeep, createReplacer, defineReplacements, extractTokens, hasUnresolvedTokens, tokenPattern } from "./template.js";
+import { CONFIG_SECTION_DESCRIPTIONS, CONFIG_SECTION_SCHEMAS, CONFIG_TYPE_SCHEMAS, biomeConfigSchema, changelogConfigSchema, changelogVersioningConfigSchema, changelogVersioningSchema, changelogVersioningTargetSchema, changelogWorkflowsConfigSchema, dbxConfigSchema, loggerConfigSchema, projectConfigSchema, projectTypeSchema, providersConfigSchema, templateKindSchema, templateSourceSchema, templateSourceTypeSchema, templatesConfigSchema, toolchainConfigSchema, tsconfigConfigSchema, viteConfigSchema, watchConfigSchema, workflowConfigSchema, workflowSettingSchema, workflowStepSchema, workflowStepsConfigSchema } from "./config-schema.js";
+import { CONFIG_FILE_NAMES, DbxConfig, ManagedFile, SyncContext, SyncSummary, SyncTask, ToolchainConfig, ToolchainHooks, ToolchainSection, defineConfig, repoSlugFromUrl, resolveChangelogBranches, resolveTokens, sectionConfig, sectionEnabled } from "./toolchain.js";
+import { Awaitable, GeneratedFile, JsonValue, PackageJson, ToolchainArgument, ToolchainCommand, ToolchainCommandContext, ToolchainOption } from "./types.js";
+import { projectFromPackageJson, projectToPackageJson, splitPackageName } from "./project.js";
 import { ToolchainProvider, ToolchainProviderAction, ToolchainProviderCommand, providerActions } from "./provider.js";
 import { RunOptions, SpawnCrossOptions, killProcessTree, run, spawnCross } from "./run.js";
 import { asString, camelCase, camelCaseId, capitalize, constantCase, ensureLeadingSlash, ensureSlashes, ensureTrailingSlash, formatCliFlag, hasText, indent, isLocalhost, kebabCase, pascalCase, removeDoubleSlashes, removeLeadingSlash, removeTrailingSlash, sanitizeSlashes, sanitizeText, snakeCase, str, stripControlChars, stripEscapeArtifacts, titleCase } from "./string-utils.js";
-import { ReplacementOptions, ReplacementValue, Replacements, Replacer, applyReplacements, applyReplacementsDeep, createReplacer, defineReplacements, extractTokens, hasUnresolvedTokens, tokenPattern } from "./template.js";
-import { ChangelogVersioning, ChangelogVersioningConfig, ChangelogVersioningTarget, ChangelogWorkflowsConfig, DbxConfigSections, ProjectType, ToolchainBiomeConfig, ToolchainChangelogConfig, ToolchainConfigSections, ToolchainLoggerConfig, ToolchainProjectConfig, ToolchainProvidersConfig, ToolchainTemplateKind, ToolchainTemplateSource, ToolchainTemplateSourceType, ToolchainTemplatesConfig, ToolchainTsconfigConfig, ToolchainViteConfig, ToolchainWatchConfig, WorkflowConfig, WorkflowSetting, WorkflowStep, WorkflowStepsConfig } from "./config-types.js";
-import { Awaitable, GeneratedFile, JsonValue, PackageJson, ToolchainArgument, ToolchainCommand, ToolchainCommandContext, ToolchainOption } from "./types.js";
-import { CONFIG_SECTION_DESCRIPTIONS, CONFIG_SECTION_SCHEMAS, CONFIG_TYPE_SCHEMAS, biomeConfigSchema, changelogConfigSchema, changelogVersioningConfigSchema, changelogVersioningSchema, changelogVersioningTargetSchema, changelogWorkflowsConfigSchema, dbxConfigSchema, loggerConfigSchema, projectConfigSchema, projectTypeSchema, providersConfigSchema, templateKindSchema, templateSourceSchema, templateSourceTypeSchema, templatesConfigSchema, toolchainConfigSchema, tsconfigConfigSchema, viteConfigSchema, watchConfigSchema, workflowConfigSchema, workflowSettingSchema, workflowStepSchema, workflowStepsConfigSchema } from "./config-schema.js";
-import { CONFIG_FILE_NAMES, DbxConfig, ManagedFile, SyncContext, SyncSummary, SyncTask, ToolchainConfig, ToolchainHooks, ToolchainSection, defineConfig, repoSlugFromUrl, resolveTokens, sectionConfig, sectionEnabled } from "./toolchain.js";
 import { YamlValue, toYaml } from "./yaml.js";
 declare namespace index_d_exports {
-  export { Awaitable, CONFIG_FILE_NAMES, CONFIG_SECTION_DESCRIPTIONS, CONFIG_SECTION_SCHEMAS, CONFIG_TYPE_SCHEMAS, ChangelogVersioning, ChangelogVersioningConfig, ChangelogVersioningTarget, ChangelogWorkflowsConfig, Colors, DbxConfig, DbxConfigSections, GeneratedFile, JsonValue, LOG_LEVELS, LogChannel, LogLevel, Logger, LoggerConfig, LoggerOptions, ManagedFile, PackageJson, ProjectType, ReplacementOptions, ReplacementValue, Replacements, Replacer, RunOptions, Sortable, SpawnCrossOptions, SyncContext, SyncSummary, SyncTask, TOOLCHAIN_PACKAGE, ToolchainArgument, ToolchainBiomeConfig, ToolchainChangelogConfig, ToolchainCommand, ToolchainCommandContext, ToolchainConfig, ToolchainConfigSections, ToolchainHooks, ToolchainLoggerConfig, ToolchainOption, ToolchainProjectConfig, ToolchainProvider, ToolchainProviderAction, ToolchainProviderCommand, ToolchainProvidersConfig, ToolchainSection, ToolchainTemplateKind, ToolchainTemplateSource, ToolchainTemplateSourceType, ToolchainTemplatesConfig, ToolchainTsconfigConfig, ToolchainViteConfig, ToolchainWatchConfig, WorkflowConfig, WorkflowSetting, WorkflowStep, WorkflowStepsConfig, YamlValue, applyReplacements, applyReplacementsDeep, asString, biomeConfigSchema, camelCase, camelCaseId, capitalize, changelogConfigSchema, changelogVersioningConfigSchema, changelogVersioningSchema, changelogVersioningTargetSchema, changelogWorkflowsConfigSchema, configureLogger, constantCase, createLogger, createReplacer, dbxConfigSchema, deepMerge, defineConfig, defineReplacements, ensureLeadingSlash, ensureSlashes, ensureTrailingSlash, extractTokens, findOwnCliEntry, formatCliFlag, getLogOverrides, getLogger, hasText, hasUnresolvedTokens, indent, isLocalhost, isLogLevel, isPlainObject, kebabCase, killProcessTree, localToolchainVersion, logger, loggerConfigSchema, mapValues, mergeJsonAt, normalizeLogLevel, pascalCase, projectConfigSchema, projectTypeSchema, providerActions, providersConfigSchema, readJsonAt, readJsonFile, removeDoubleSlashes, removeLeadingSlash, removeTrailingSlash, repoSlugFromUrl, resolveSort, resolveTokens, run, sanitizeSlashes, sanitizeText, sectionConfig, sectionEnabled, setLogConfig, setLogOverrides, snakeCase, sort, spawnCross, str, stripAnsi, stripControlChars, stripEscapeArtifacts, templateKindSchema, templateSourceSchema, templateSourceTypeSchema, templatesConfigSchema, titleCase, toJson, toYaml, tokenPattern, toolchainConfigSchema, tsconfigConfigSchema, viteConfigSchema, watchConfigSchema, workflowConfigSchema, workflowSettingSchema, workflowStepSchema, workflowStepsConfigSchema, writeJsonFile };
+  export { Awaitable, CONFIG_FILE_NAMES, CONFIG_SECTION_DESCRIPTIONS, CONFIG_SECTION_SCHEMAS, CONFIG_TYPE_SCHEMAS, ChangelogVersioning, ChangelogVersioningConfig, ChangelogVersioningTarget, ChangelogWorkflowsConfig, Colors, DEFAULT_IGNORE_PATTERNS, DbxConfig, DbxConfigSections, GeneratedFile, IgnoreOptions, JsonValue, LOG_LEVELS, LogChannel, LogLevel, Logger, LoggerConfig, LoggerOptions, ManagedFile, PackageJson, ProjectType, ReplacementOptions, ReplacementValue, Replacements, Replacer, RunOptions, Sortable, SpawnCrossOptions, SyncContext, SyncSummary, SyncTask, TOOLCHAIN_PACKAGE, ToolchainArgument, ToolchainBiomeConfig, ToolchainChangelogConfig, ToolchainCommand, ToolchainCommandContext, ToolchainConfig, ToolchainConfigSections, ToolchainHooks, ToolchainLoggerConfig, ToolchainOption, ToolchainProjectConfig, ToolchainProvider, ToolchainProviderAction, ToolchainProviderCommand, ToolchainProvidersConfig, ToolchainSection, ToolchainTemplateKind, ToolchainTemplateSource, ToolchainTemplateSourceType, ToolchainTemplatesConfig, ToolchainTsconfigConfig, ToolchainViteConfig, ToolchainWatchConfig, WorkflowConfig, WorkflowSetting, WorkflowStep, WorkflowStepsConfig, YamlValue, applyReplacements, applyReplacementsDeep, asString, biomeConfigSchema, camelCase, camelCaseId, capitalize, changelogConfigSchema, changelogVersioningConfigSchema, changelogVersioningSchema, changelogVersioningTargetSchema, changelogWorkflowsConfigSchema, collectGitignorePatterns, configureLogger, constantCase, createLogger, createReplacer, dbxConfigSchema, deepMerge, defineConfig, defineReplacements, ensureLeadingSlash, ensureSlashes, ensureTrailingSlash, extractTokens, findOwnCliEntry, formatCliFlag, getLogOverrides, getLogger, hasText, hasUnresolvedTokens, indent, isIgnoredPath, isLocalhost, isLogLevel, isPlainObject, kebabCase, killProcessTree, localToolchainVersion, logger, loggerConfigSchema, mapValues, mergeJsonAt, normalizeLogLevel, pascalCase, projectConfigSchema, projectFromPackageJson, projectToPackageJson, projectTypeSchema, providerActions, providersConfigSchema, readJsonAt, readJsonFile, removeDoubleSlashes, removeLeadingSlash, removeTrailingSlash, repoSlugFromUrl, resolveChangelogBranches, resolveIgnorePatterns, resolveSort, resolveTokens, run, sanitizeSlashes, sanitizeText, sectionConfig, sectionEnabled, setLogConfig, setLogOverrides, snakeCase, sort, spawnCross, splitPackageName, str, stripAnsi, stripControlChars, stripEscapeArtifacts, templateKindSchema, templateSourceSchema, templateSourceTypeSchema, templatesConfigSchema, titleCase, toJson, toYaml, tokenPattern, toolchainConfigSchema, tsconfigConfigSchema, viteConfigSchema, watchConfigSchema, workflowConfigSchema, workflowSettingSchema, workflowStepSchema, workflowStepsConfigSchema, writeJsonFile };
 }
 //#endregion
-export { Awaitable, CONFIG_FILE_NAMES, CONFIG_SECTION_DESCRIPTIONS, CONFIG_SECTION_SCHEMAS, CONFIG_TYPE_SCHEMAS, ChangelogVersioning, ChangelogVersioningConfig, ChangelogVersioningTarget, ChangelogWorkflowsConfig, Colors, DbxConfig, DbxConfigSections, GeneratedFile, JsonValue, LOG_LEVELS, LogChannel, LogLevel, Logger, LoggerConfig, LoggerOptions, ManagedFile, PackageJson, ProjectType, ReplacementOptions, ReplacementValue, Replacements, Replacer, RunOptions, Sortable, SpawnCrossOptions, SyncContext, SyncSummary, SyncTask, TOOLCHAIN_PACKAGE, ToolchainArgument, ToolchainBiomeConfig, ToolchainChangelogConfig, ToolchainCommand, ToolchainCommandContext, ToolchainConfig, ToolchainConfigSections, ToolchainHooks, ToolchainLoggerConfig, ToolchainOption, ToolchainProjectConfig, ToolchainProvider, ToolchainProviderAction, ToolchainProviderCommand, ToolchainProvidersConfig, ToolchainSection, ToolchainTemplateKind, ToolchainTemplateSource, ToolchainTemplateSourceType, ToolchainTemplatesConfig, ToolchainTsconfigConfig, ToolchainViteConfig, ToolchainWatchConfig, WorkflowConfig, WorkflowSetting, WorkflowStep, WorkflowStepsConfig, type YamlValue, applyReplacements, applyReplacementsDeep, asString, biomeConfigSchema, camelCase, camelCaseId, capitalize, changelogConfigSchema, changelogVersioningConfigSchema, changelogVersioningSchema, changelogVersioningTargetSchema, changelogWorkflowsConfigSchema, configureLogger, constantCase, createLogger, createReplacer, dbxConfigSchema, deepMerge, defineConfig, defineReplacements, ensureLeadingSlash, ensureSlashes, ensureTrailingSlash, extractTokens, findOwnCliEntry, formatCliFlag, getLogOverrides, getLogger, hasText, hasUnresolvedTokens, indent, index_d_exports, isLocalhost, isLogLevel, isPlainObject, kebabCase, killProcessTree, localToolchainVersion, logger, loggerConfigSchema, mapValues, mergeJsonAt, normalizeLogLevel, pascalCase, projectConfigSchema, projectTypeSchema, providerActions, providersConfigSchema, readJsonAt, readJsonFile, removeDoubleSlashes, removeLeadingSlash, removeTrailingSlash, repoSlugFromUrl, resolveSort, resolveTokens, run, sanitizeSlashes, sanitizeText, sectionConfig, sectionEnabled, setLogConfig, setLogOverrides, snakeCase, sort, spawnCross, str, stripAnsi, stripControlChars, stripEscapeArtifacts, templateKindSchema, templateSourceSchema, templateSourceTypeSchema, templatesConfigSchema, titleCase, toJson, toYaml, tokenPattern, toolchainConfigSchema, tsconfigConfigSchema, viteConfigSchema, watchConfigSchema, workflowConfigSchema, workflowSettingSchema, workflowStepSchema, workflowStepsConfigSchema, writeJsonFile };
+export { Awaitable, CONFIG_FILE_NAMES, CONFIG_SECTION_DESCRIPTIONS, CONFIG_SECTION_SCHEMAS, CONFIG_TYPE_SCHEMAS, ChangelogVersioning, ChangelogVersioningConfig, ChangelogVersioningTarget, ChangelogWorkflowsConfig, Colors, DEFAULT_IGNORE_PATTERNS, DbxConfig, DbxConfigSections, GeneratedFile, IgnoreOptions, JsonValue, LOG_LEVELS, LogChannel, LogLevel, Logger, LoggerConfig, LoggerOptions, ManagedFile, PackageJson, ProjectType, ReplacementOptions, ReplacementValue, Replacements, Replacer, RunOptions, Sortable, SpawnCrossOptions, SyncContext, SyncSummary, SyncTask, TOOLCHAIN_PACKAGE, ToolchainArgument, ToolchainBiomeConfig, ToolchainChangelogConfig, ToolchainCommand, ToolchainCommandContext, ToolchainConfig, ToolchainConfigSections, ToolchainHooks, ToolchainLoggerConfig, ToolchainOption, ToolchainProjectConfig, ToolchainProvider, ToolchainProviderAction, ToolchainProviderCommand, ToolchainProvidersConfig, ToolchainSection, ToolchainTemplateKind, ToolchainTemplateSource, ToolchainTemplateSourceType, ToolchainTemplatesConfig, ToolchainTsconfigConfig, ToolchainViteConfig, ToolchainWatchConfig, WorkflowConfig, WorkflowSetting, WorkflowStep, WorkflowStepsConfig, type YamlValue, applyReplacements, applyReplacementsDeep, asString, biomeConfigSchema, camelCase, camelCaseId, capitalize, changelogConfigSchema, changelogVersioningConfigSchema, changelogVersioningSchema, changelogVersioningTargetSchema, changelogWorkflowsConfigSchema, collectGitignorePatterns, configureLogger, constantCase, createLogger, createReplacer, dbxConfigSchema, deepMerge, defineConfig, defineReplacements, ensureLeadingSlash, ensureSlashes, ensureTrailingSlash, extractTokens, findOwnCliEntry, formatCliFlag, getLogOverrides, getLogger, hasText, hasUnresolvedTokens, indent, index_d_exports, isIgnoredPath, isLocalhost, isLogLevel, isPlainObject, kebabCase, killProcessTree, localToolchainVersion, logger, loggerConfigSchema, mapValues, mergeJsonAt, normalizeLogLevel, pascalCase, projectConfigSchema, projectFromPackageJson, projectToPackageJson, projectTypeSchema, providerActions, providersConfigSchema, readJsonAt, readJsonFile, removeDoubleSlashes, removeLeadingSlash, removeTrailingSlash, repoSlugFromUrl, resolveChangelogBranches, resolveIgnorePatterns, resolveSort, resolveTokens, run, sanitizeSlashes, sanitizeText, sectionConfig, sectionEnabled, setLogConfig, setLogOverrides, snakeCase, sort, spawnCross, splitPackageName, str, stripAnsi, stripControlChars, stripEscapeArtifacts, templateKindSchema, templateSourceSchema, templateSourceTypeSchema, templatesConfigSchema, titleCase, toJson, toYaml, tokenPattern, toolchainConfigSchema, tsconfigConfigSchema, viteConfigSchema, watchConfigSchema, workflowConfigSchema, workflowSettingSchema, workflowStepSchema, workflowStepsConfigSchema, writeJsonFile };

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

@@ -1 +1 @@
-import"node:path";import"node:url";import.meta.url;import{__exportAll as ee}from"../../../_virtual/_rolldown/runtime.js";import{TOOLCHAIN_PACKAGE as e,findOwnCliEntry as t,localToolchainVersion as n}from"./bin.js";import{deepMerge as r,isPlainObject as i,mapValues as a,resolveSort as o,sort as s}from"./object-utils.js";import{mergeJsonAt as c,readJsonAt as l,readJsonFile as u,toJson as d,writeJsonFile as f}from"./fs-utils.js";import{LOG_LEVELS as p,configureLogger as m,createLogger as h,getLogOverrides as g,getLogger as _,isLogLevel as v,logger as y,normalizeLogLevel as b,setLogConfig as x,setLogOverrides as S,stripAnsi as C}from"./logger.js";import{providerActions as w}from"./provider.js";import{killProcessTree as T,run as E,spawnCross as D}from"./run.js";import{asString as O,camelCase as k,camelCaseId as A,capitalize as j,constantCase as M,ensureLeadingSlash as N,ensureSlashes as P,ensureTrailingSlash as F,formatCliFlag as I,hasText as L,indent as R,isLocalhost as z,kebabCase as B,pascalCase as V,removeDoubleSlashes as H,removeLeadingSlash as U,removeTrailingSlash as W,sanitizeSlashes as G,sanitizeText as K,snakeCase as q,str as te,stripControlChars as J,stripEscapeArtifacts as Y,titleCase as X}from"./string-utils.js";import{applyReplacements as Z,applyReplacementsDeep as Q,createReplacer as $,defineReplacements as ne,extractTokens as re,hasUnresolvedTokens as ie,tokenPattern as ae}from"./template.js";import{CONFIG_SECTION_DESCRIPTIONS as oe,CONFIG_SECTION_SCHEMAS as se,CONFIG_TYPE_SCHEMAS as ce,biomeConfigSchema as le,changelogConfigSchema as ue,changelogVersioningConfigSchema as de,changelogVersioningSchema as fe,changelogVersioningTargetSchema as pe,changelogWorkflowsConfigSchema as me,dbxConfigSchema as he,loggerConfigSchema as ge,projectConfigSchema as _e,projectTypeSchema as ve,providersConfigSchema as ye,templateKindSchema as be,templateSourceSchema as xe,templateSourceTypeSchema as Se,templatesConfigSchema as Ce,toolchainConfigSchema as we,tsconfigConfigSchema as Te,viteConfigSchema as Ee,watchConfigSchema as De,workflowConfigSchema as Oe,workflowSettingSchema as ke,workflowStepSchema as Ae,workflowStepsConfigSchema as je}from"./config-schema.js";import{CONFIG_FILE_NAMES as Me,defineConfig as Ne,repoSlugFromUrl as Pe,resolveTokens as Fe,sectionConfig as Ie,sectionEnabled as Le}from"./toolchain.js";import{toYaml as Re}from"./yaml.js";var ze=/* @__PURE__ */ ee({CONFIG_FILE_NAMES:()=>Me,CONFIG_SECTION_DESCRIPTIONS:()=>oe,CONFIG_SECTION_SCHEMAS:()=>se,CONFIG_TYPE_SCHEMAS:()=>ce,LOG_LEVELS:()=>p,TOOLCHAIN_PACKAGE:()=>e,applyReplacements:()=>Z,applyReplacementsDeep:()=>Q,asString:()=>O,biomeConfigSchema:()=>le,camelCase:()=>k,camelCaseId:()=>A,capitalize:()=>j,changelogConfigSchema:()=>ue,changelogVersioningConfigSchema:()=>de,changelogVersioningSchema:()=>fe,changelogVersioningTargetSchema:()=>pe,changelogWorkflowsConfigSchema:()=>me,configureLogger:()=>m,constantCase:()=>M,createLogger:()=>h,createReplacer:()=>$,dbxConfigSchema:()=>he,deepMerge:()=>r,defineConfig:()=>Ne,defineReplacements:()=>ne,ensureLeadingSlash:()=>N,ensureSlashes:()=>P,ensureTrailingSlash:()=>F,extractTokens:()=>re,findOwnCliEntry:()=>t,formatCliFlag:()=>I,getLogOverrides:()=>g,getLogger:()=>_,hasText:()=>L,hasUnresolvedTokens:()=>ie,indent:()=>R,isLocalhost:()=>z,isLogLevel:()=>v,isPlainObject:()=>i,kebabCase:()=>B,killProcessTree:()=>T,localToolchainVersion:()=>n,logger:()=>y,loggerConfigSchema:()=>ge,mapValues:()=>a,mergeJsonAt:()=>c,normalizeLogLevel:()=>b,pascalCase:()=>V,projectConfigSchema:()=>_e,projectTypeSchema:()=>ve,providerActions:()=>w,providersConfigSchema:()=>ye,readJsonAt:()=>l,readJsonFile:()=>u,removeDoubleSlashes:()=>H,removeLeadingSlash:()=>U,removeTrailingSlash:()=>W,repoSlugFromUrl:()=>Pe,resolveSort:()=>o,resolveTokens:()=>Fe,run:()=>E,sanitizeSlashes:()=>G,sanitizeText:()=>K,sectionConfig:()=>Ie,sectionEnabled:()=>Le,setLogConfig:()=>x,setLogOverrides:()=>S,snakeCase:()=>q,sort:()=>s,spawnCross:()=>D,str:()=>te,stripAnsi:()=>C,stripControlChars:()=>J,stripEscapeArtifacts:()=>Y,templateKindSchema:()=>be,templateSourceSchema:()=>xe,templateSourceTypeSchema:()=>Se,templatesConfigSchema:()=>Ce,titleCase:()=>X,toJson:()=>d,toYaml:()=>Re,tokenPattern:()=>ae,toolchainConfigSchema:()=>we,tsconfigConfigSchema:()=>Te,viteConfigSchema:()=>Ee,watchConfigSchema:()=>De,workflowConfigSchema:()=>Oe,workflowSettingSchema:()=>ke,workflowStepSchema:()=>Ae,workflowStepsConfigSchema:()=>je,writeJsonFile:()=>f});export{Me as CONFIG_FILE_NAMES,oe as CONFIG_SECTION_DESCRIPTIONS,se as CONFIG_SECTION_SCHEMAS,ce as CONFIG_TYPE_SCHEMAS,p as LOG_LEVELS,e as TOOLCHAIN_PACKAGE,Z as applyReplacements,Q as applyReplacementsDeep,O as asString,le as biomeConfigSchema,k as camelCase,A as camelCaseId,j as capitalize,ue as changelogConfigSchema,de as changelogVersioningConfigSchema,fe as changelogVersioningSchema,pe as changelogVersioningTargetSchema,me as changelogWorkflowsConfigSchema,m as configureLogger,M as constantCase,h as createLogger,$ as createReplacer,he as dbxConfigSchema,r as deepMerge,Ne as defineConfig,ne as defineReplacements,N as ensureLeadingSlash,P as ensureSlashes,F as ensureTrailingSlash,re as extractTokens,t as findOwnCliEntry,I as formatCliFlag,g as getLogOverrides,_ as getLogger,L as hasText,ie as hasUnresolvedTokens,R as indent,z as isLocalhost,v as isLogLevel,i as isPlainObject,B as kebabCase,T as killProcessTree,n as localToolchainVersion,y as logger,ge as loggerConfigSchema,a as mapValues,c as mergeJsonAt,b as normalizeLogLevel,V as pascalCase,_e as projectConfigSchema,ve as projectTypeSchema,w as providerActions,ye as providersConfigSchema,l as readJsonAt,u as readJsonFile,H as removeDoubleSlashes,U as removeLeadingSlash,W as removeTrailingSlash,Pe as repoSlugFromUrl,o as resolveSort,Fe as resolveTokens,E as run,G as sanitizeSlashes,K as sanitizeText,Ie as sectionConfig,Le as sectionEnabled,x as setLogConfig,S as setLogOverrides,q as snakeCase,s as sort,D as spawnCross,ze as src_exports,te as str,C as stripAnsi,J as stripControlChars,Y as stripEscapeArtifacts,be as templateKindSchema,xe as templateSourceSchema,Se as templateSourceTypeSchema,Ce as templatesConfigSchema,X as titleCase,d as toJson,Re as toYaml,ae as tokenPattern,we as toolchainConfigSchema,Te as tsconfigConfigSchema,Ee as viteConfigSchema,De as watchConfigSchema,Oe as workflowConfigSchema,ke as workflowSettingSchema,Ae as workflowStepSchema,je as workflowStepsConfigSchema,f as writeJsonFile};
+import"node:path";import"node:url";import.meta.url;import{__exportAll as ee}from"../../../_virtual/_rolldown/runtime.js";import{TOOLCHAIN_PACKAGE as e,findOwnCliEntry as t,localToolchainVersion as n}from"./bin.js";import{deepMerge as r,isPlainObject as i,mapValues as a,resolveSort as o,sort as s}from"./object-utils.js";import{mergeJsonAt as c,readJsonAt as l,readJsonFile as u,toJson as d,writeJsonFile as f}from"./fs-utils.js";import{DEFAULT_IGNORE_PATTERNS as p,collectGitignorePatterns as m,isIgnoredPath as h,resolveIgnorePatterns as g}from"./ignore.js";import{LOG_LEVELS as _,configureLogger as v,createLogger as y,getLogOverrides as b,getLogger as x,isLogLevel as S,logger as C,normalizeLogLevel as w,setLogConfig as T,setLogOverrides as E,stripAnsi as D}from"./logger.js";import{projectFromPackageJson as O,projectToPackageJson as k,splitPackageName as A}from"./project.js";import{providerActions as j}from"./provider.js";import{killProcessTree as M,run as N,spawnCross as P}from"./run.js";import{asString as F,camelCase as I,camelCaseId as L,capitalize as R,constantCase as z,ensureLeadingSlash as B,ensureSlashes as V,ensureTrailingSlash as H,formatCliFlag as U,hasText as W,indent as G,isLocalhost as K,kebabCase as q,pascalCase as J,removeDoubleSlashes as Y,removeLeadingSlash as X,removeTrailingSlash as Z,sanitizeSlashes as te,sanitizeText as Q,snakeCase as $,str as ne,stripControlChars as re,stripEscapeArtifacts as ie,titleCase as ae}from"./string-utils.js";import{applyReplacements as oe,applyReplacementsDeep as se,createReplacer as ce,defineReplacements as le,extractTokens as ue,hasUnresolvedTokens as de,tokenPattern as fe}from"./template.js";import{CONFIG_SECTION_DESCRIPTIONS as pe,CONFIG_SECTION_SCHEMAS as me,CONFIG_TYPE_SCHEMAS as he,biomeConfigSchema as ge,changelogConfigSchema as _e,changelogVersioningConfigSchema as ve,changelogVersioningSchema as ye,changelogVersioningTargetSchema as be,changelogWorkflowsConfigSchema as xe,dbxConfigSchema as Se,loggerConfigSchema as Ce,projectConfigSchema as we,projectTypeSchema as Te,providersConfigSchema as Ee,templateKindSchema as De,templateSourceSchema as Oe,templateSourceTypeSchema as ke,templatesConfigSchema as Ae,toolchainConfigSchema as je,tsconfigConfigSchema as Me,viteConfigSchema as Ne,watchConfigSchema as Pe,workflowConfigSchema as Fe,workflowSettingSchema as Ie,workflowStepSchema as Le,workflowStepsConfigSchema as Re}from"./config-schema.js";import{CONFIG_FILE_NAMES as ze,defineConfig as Be,repoSlugFromUrl as Ve,resolveChangelogBranches as He,resolveTokens as Ue,sectionConfig as We,sectionEnabled as Ge}from"./toolchain.js";import{toYaml as Ke}from"./yaml.js";var qe=/* @__PURE__ */ ee({CONFIG_FILE_NAMES:()=>ze,CONFIG_SECTION_DESCRIPTIONS:()=>pe,CONFIG_SECTION_SCHEMAS:()=>me,CONFIG_TYPE_SCHEMAS:()=>he,DEFAULT_IGNORE_PATTERNS:()=>p,LOG_LEVELS:()=>_,TOOLCHAIN_PACKAGE:()=>e,applyReplacements:()=>oe,applyReplacementsDeep:()=>se,asString:()=>F,biomeConfigSchema:()=>ge,camelCase:()=>I,camelCaseId:()=>L,capitalize:()=>R,changelogConfigSchema:()=>_e,changelogVersioningConfigSchema:()=>ve,changelogVersioningSchema:()=>ye,changelogVersioningTargetSchema:()=>be,changelogWorkflowsConfigSchema:()=>xe,collectGitignorePatterns:()=>m,configureLogger:()=>v,constantCase:()=>z,createLogger:()=>y,createReplacer:()=>ce,dbxConfigSchema:()=>Se,deepMerge:()=>r,defineConfig:()=>Be,defineReplacements:()=>le,ensureLeadingSlash:()=>B,ensureSlashes:()=>V,ensureTrailingSlash:()=>H,extractTokens:()=>ue,findOwnCliEntry:()=>t,formatCliFlag:()=>U,getLogOverrides:()=>b,getLogger:()=>x,hasText:()=>W,hasUnresolvedTokens:()=>de,indent:()=>G,isIgnoredPath:()=>h,isLocalhost:()=>K,isLogLevel:()=>S,isPlainObject:()=>i,kebabCase:()=>q,killProcessTree:()=>M,localToolchainVersion:()=>n,logger:()=>C,loggerConfigSchema:()=>Ce,mapValues:()=>a,mergeJsonAt:()=>c,normalizeLogLevel:()=>w,pascalCase:()=>J,projectConfigSchema:()=>we,projectFromPackageJson:()=>O,projectToPackageJson:()=>k,projectTypeSchema:()=>Te,providerActions:()=>j,providersConfigSchema:()=>Ee,readJsonAt:()=>l,readJsonFile:()=>u,removeDoubleSlashes:()=>Y,removeLeadingSlash:()=>X,removeTrailingSlash:()=>Z,repoSlugFromUrl:()=>Ve,resolveChangelogBranches:()=>He,resolveIgnorePatterns:()=>g,resolveSort:()=>o,resolveTokens:()=>Ue,run:()=>N,sanitizeSlashes:()=>te,sanitizeText:()=>Q,sectionConfig:()=>We,sectionEnabled:()=>Ge,setLogConfig:()=>T,setLogOverrides:()=>E,snakeCase:()=>$,sort:()=>s,spawnCross:()=>P,splitPackageName:()=>A,str:()=>ne,stripAnsi:()=>D,stripControlChars:()=>re,stripEscapeArtifacts:()=>ie,templateKindSchema:()=>De,templateSourceSchema:()=>Oe,templateSourceTypeSchema:()=>ke,templatesConfigSchema:()=>Ae,titleCase:()=>ae,toJson:()=>d,toYaml:()=>Ke,tokenPattern:()=>fe,toolchainConfigSchema:()=>je,tsconfigConfigSchema:()=>Me,viteConfigSchema:()=>Ne,watchConfigSchema:()=>Pe,workflowConfigSchema:()=>Fe,workflowSettingSchema:()=>Ie,workflowStepSchema:()=>Le,workflowStepsConfigSchema:()=>Re,writeJsonFile:()=>f});export{ze as CONFIG_FILE_NAMES,pe as CONFIG_SECTION_DESCRIPTIONS,me as CONFIG_SECTION_SCHEMAS,he as CONFIG_TYPE_SCHEMAS,p as DEFAULT_IGNORE_PATTERNS,_ as LOG_LEVELS,e as TOOLCHAIN_PACKAGE,oe as applyReplacements,se as applyReplacementsDeep,F as asString,ge as biomeConfigSchema,I as camelCase,L as camelCaseId,R as capitalize,_e as changelogConfigSchema,ve as changelogVersioningConfigSchema,ye as changelogVersioningSchema,be as changelogVersioningTargetSchema,xe as changelogWorkflowsConfigSchema,m as collectGitignorePatterns,v as configureLogger,z as constantCase,y as createLogger,ce as createReplacer,Se as dbxConfigSchema,r as deepMerge,Be as defineConfig,le as defineReplacements,B as ensureLeadingSlash,V as ensureSlashes,H as ensureTrailingSlash,ue as extractTokens,t as findOwnCliEntry,U as formatCliFlag,b as getLogOverrides,x as getLogger,W as hasText,de as hasUnresolvedTokens,G as indent,h as isIgnoredPath,K as isLocalhost,S as isLogLevel,i as isPlainObject,q as kebabCase,M as killProcessTree,n as localToolchainVersion,C as logger,Ce as loggerConfigSchema,a as mapValues,c as mergeJsonAt,w as normalizeLogLevel,J as pascalCase,we as projectConfigSchema,O as projectFromPackageJson,k as projectToPackageJson,Te as projectTypeSchema,j as providerActions,Ee as providersConfigSchema,l as readJsonAt,u as readJsonFile,Y as removeDoubleSlashes,X as removeLeadingSlash,Z as removeTrailingSlash,Ve as repoSlugFromUrl,He as resolveChangelogBranches,g as resolveIgnorePatterns,o as resolveSort,Ue as resolveTokens,N as run,te as sanitizeSlashes,Q as sanitizeText,We as sectionConfig,Ge as sectionEnabled,T as setLogConfig,E as setLogOverrides,$ as snakeCase,s as sort,P as spawnCross,A as splitPackageName,qe as src_exports,ne as str,D as stripAnsi,re as stripControlChars,ie as stripEscapeArtifacts,De as templateKindSchema,Oe as templateSourceSchema,ke as templateSourceTypeSchema,Ae as templatesConfigSchema,ae as titleCase,d as toJson,Ke as toYaml,fe as tokenPattern,je as toolchainConfigSchema,Me as tsconfigConfigSchema,Ne as viteConfigSchema,Pe as watchConfigSchema,Fe as workflowConfigSchema,Ie as workflowSettingSchema,Le as workflowStepSchema,Re as workflowStepsConfigSchema,f as writeJsonFile};

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

@@ -0,0 +1,25 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+import { ToolchainProjectConfig } from "./config-types.js";
+import { PackageJson } from "./types.js";
+//#region packages/shared/src/project.d.ts
+/** Split a package name into its unscoped name + scope (`@acme/app` -> `app`/`@acme`). */
+export declare function splitPackageName(pkgName: string | undefined): {
+  name?: string;
+  scope?: string;
+};
+/**
+ * Derive the project metadata from a `package.json`. Used as the fallback when a
+ * `dbx.config.project` field is not defined (and to seed a generated config).
+ */
+export declare function projectFromPackageJson(pkg: PackageJson): ToolchainProjectConfig;
+/**
+ * Map the fields a `dbx.config.project` **defines** onto `package.json` fields.
+ * Only the defined fields are returned, so a sync never clears a field the
+ * config does not mention. `directory` (a workspace path relative to the repo
+ * root) is written as `repository.directory`.
+ */
+export declare function projectToPackageJson(project: ToolchainProjectConfig, options?: {
+  directory?: string;
+}): Partial<PackageJson>;
+//#endregion

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

@@ -0,0 +1 @@
+import"node:path";import"node:url";import.meta.url;function e(e){if(!e)return{};let t=e.match(/^(@[^/]+)\/(.+)$/);return t?.[1]&&t[2]?{name:t[2],scope:t[1]}:{name:e}}function t(e){if(typeof e==`string`)return e||void 0;if(e&&typeof e==`object`){let t=e;if(!t.name)return;let n=t.email?` <${t.email}>`:``,r=t.url?` (${t.url})`:``;return`${t.name}${n}${r}`}}function n(e){let t=typeof e==`string`?e:e&&typeof e==`object`?e.url:void 0;if(t)return t.replace(/^git\+/,``).replace(/\.git$/,``)}function r(e){return e.startsWith(`git+`)||e.startsWith(`git@`)?e:/^https?:\/\//.test(e)&&!e.endsWith(`.git`)?`git+${e}.git`:e}function i(e){if(typeof e!=`string`||!e)return{};let t=e.match(/^(@?[^@]+)@(.+)$/);return t?.[1]&&t[2]?{name:t[1],version:t[2]}:{name:e}}function a(e){if(typeof e==`string`&&e)return e.replace(/^[^\d]*/,``).trim()||void 0}function o(r){let{name:o,scope:s}=e(r.name),c=i(r.packageManager),l=r.engines??{},u=typeof r.description==`string`?r.description:void 0,d=t(r.author),f=typeof r.license==`string`?r.license:void 0,p=typeof r.homepage==`string`?r.homepage:void 0,m=n(r.repository),h=a(l.node);return{...o?{name:o}:{},...s?{scope:s}:{},...u?{description:u}:{},...d?{author:d}:{},...f?{license:f}:{},...p?{homepage:p}:{},...m?{repo:m}:{},...h?{nodeVersion:h}:{},...c.name?{packageManager:c.name}:{},...c.version?{packageManagerVersion:c.version}:{}}}function s(e,t={}){let n={};return e.name&&(n.name=e.scope?`${e.scope}/${e.name}`:e.name),e.description!==void 0&&(n.description=e.description),e.author!==void 0&&(n.author=e.author),e.license!==void 0&&(n.license=e.license),e.homepage!==void 0&&(n.homepage=e.homepage),e.repo!==void 0&&(n.repository={type:`git`,url:r(e.repo),...t.directory?{directory:t.directory}:{}}),e.packageManager!==void 0&&(n.packageManager=e.packageManagerVersion?`${e.packageManager}@${e.packageManagerVersion}`:e.packageManager),n}export{o as projectFromPackageJson,s as projectToPackageJson,e as splitPackageName};

package/dist/packages/shared/src/toolchain.d.ts

@@ -1,9 +1,9 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
-import { Replacements } from "./template.js";
 import { ChangelogVersioning, ChangelogVersioningConfig, ChangelogVersioningTarget, ChangelogWorkflowsConfig, DbxConfigSections, ProjectType, ToolchainBiomeConfig, ToolchainChangelogConfig, ToolchainConfigSections, ToolchainLoggerConfig, ToolchainProjectConfig, ToolchainProvidersConfig, ToolchainTemplateKind, ToolchainTemplateSource, ToolchainTemplateSourceType, ToolchainTemplatesConfig, ToolchainTsconfigConfig, ToolchainViteConfig, ToolchainWatchConfig, WorkflowConfig, WorkflowSetting, WorkflowStep, WorkflowStepsConfig } from "./config-types.js";
-import { Awaitable } from "./types.js";
+import { Replacements } from "./template.js";
 import { CONFIG_SECTION_DESCRIPTIONS, CONFIG_SECTION_SCHEMAS, CONFIG_TYPE_SCHEMAS, biomeConfigSchema, changelogConfigSchema, changelogVersioningConfigSchema, changelogVersioningSchema, changelogVersioningTargetSchema, changelogWorkflowsConfigSchema, dbxConfigSchema, loggerConfigSchema, projectConfigSchema, projectTypeSchema, providersConfigSchema, templateKindSchema, templateSourceSchema, templateSourceTypeSchema, templatesConfigSchema, toolchainConfigSchema, tsconfigConfigSchema, viteConfigSchema, watchConfigSchema, workflowConfigSchema, workflowSettingSchema, workflowStepSchema, workflowStepsConfigSchema } from "./config-schema.js";
+import { Awaitable } from "./types.js";
 //#region packages/shared/src/toolchain.d.ts
 /** A summary of a sync run, handed to {@link ToolchainHooks.afterSync}. */
 export interface SyncSummary {
@@ -97,6 +97,15 @@ export declare function sectionConfig<T extends object>(section: ToolchainSectio
 export declare const CONFIG_FILE_NAMES: readonly ['dbx.config.ts', 'dbx.config.mts', 'dbx.config.js', 'dbx.config.mjs', 'dbx.config.cjs', 'dbx.config.json'];
 /** Derive the `owner/name` slug from a repository URL. */
 export declare function repoSlugFromUrl(repo: string | undefined): string | undefined;
+/**
+ * The resolved changelog branches. `main` defaults to `['main']`; `dev` has **no
+ * default** and reuses `main` when omitted, so a single-branch repo needs no
+ * `dev`. Each side accepts a glob or an array of globs.
+ */
+export declare function resolveChangelogBranches(changelog?: ToolchainChangelogConfig): {
+  main: string[];
+  dev: string[];
+};
 /**
  * Flatten a {@link ToolchainConfig} into the `{{ token }}` replacements every
  * template understands. Defaults are chosen so a bare config still renders.
@@ -126,6 +135,8 @@ export interface SyncContext {
   tokens: Replacements;
   /** Log a line (respects `--quiet`). */
   log: (message: string) => void;
+  /** Emit a warning (respects `--quiet`, which suppresses warnings too). */
+  warn: (message: string) => void;
 }
 /** A unit of sync work exposed by a package. */
 export interface SyncTask {

package/dist/packages/shared/src/toolchain.js

@@ -1 +1 @@
-import"node:path";import"node:url";import.meta.url;import{CONFIG_SECTION_DESCRIPTIONS as e,CONFIG_SECTION_SCHEMAS as t,CONFIG_TYPE_SCHEMAS as n,biomeConfigSchema as r,changelogConfigSchema as i,changelogVersioningConfigSchema as a,changelogVersioningSchema as o,changelogVersioningTargetSchema as s,changelogWorkflowsConfigSchema as c,dbxConfigSchema as l,loggerConfigSchema as u,projectConfigSchema as d,projectTypeSchema as f,providersConfigSchema as p,templateKindSchema as m,templateSourceSchema as h,templateSourceTypeSchema as g,templatesConfigSchema as _,toolchainConfigSchema as v,tsconfigConfigSchema as y,viteConfigSchema as b,watchConfigSchema as x,workflowConfigSchema as S,workflowSettingSchema as C,workflowStepSchema as w,workflowStepsConfigSchema as T}from"./config-schema.js";function E(e){return e}function D(e){return e===void 0?!1:typeof e==`boolean`?e:e.enabled!==!1}function O(e){return e!==void 0&&typeof e==`object`?e:void 0}const k=[`dbx.config.ts`,`dbx.config.mts`,`dbx.config.js`,`dbx.config.mjs`,`dbx.config.cjs`,`dbx.config.json`];function A(e){if(!e)return;let t=e.match(/github\.com[/:]([^/]+)\/([^/.]+?)(?:\.git)?$/);return t?.[1]&&t[2]?`${t[1]}/${t[2]}`:void 0}function j(e={}){let t=e.project??{},n=O(e.changelog)??{};return{name:t.name??`app`,scope:t.scope??``,author:t.author??``,license:t.license??`MIT`,homepage:t.homepage??``,repo:t.repo??``,repoSlug:A(t.repo)??``,description:t.description??``,nodeVersion:t.nodeVersion??`22`,packageManager:t.packageManager??`yarn`,yarnVersion:t.packageManagerVersion??`4.17.1`,packageManagerVersion:t.packageManagerVersion??`4.17.1`,mainBranch:n.branches?.main??`main`,devBranch:n.branches?.dev??`dev`}}export{k as CONFIG_FILE_NAMES,e as CONFIG_SECTION_DESCRIPTIONS,t as CONFIG_SECTION_SCHEMAS,n as CONFIG_TYPE_SCHEMAS,r as biomeConfigSchema,i as changelogConfigSchema,a as changelogVersioningConfigSchema,o as changelogVersioningSchema,s as changelogVersioningTargetSchema,c as changelogWorkflowsConfigSchema,l as dbxConfigSchema,E as defineConfig,u as loggerConfigSchema,d as projectConfigSchema,f as projectTypeSchema,p as providersConfigSchema,A as repoSlugFromUrl,j as resolveTokens,O as sectionConfig,D as sectionEnabled,m as templateKindSchema,h as templateSourceSchema,g as templateSourceTypeSchema,_ as templatesConfigSchema,v as toolchainConfigSchema,y as tsconfigConfigSchema,b as viteConfigSchema,x as watchConfigSchema,S as workflowConfigSchema,C as workflowSettingSchema,w as workflowStepSchema,T as workflowStepsConfigSchema};
+import"node:path";import"node:url";import.meta.url;import{CONFIG_SECTION_DESCRIPTIONS as e,CONFIG_SECTION_SCHEMAS as t,CONFIG_TYPE_SCHEMAS as n,biomeConfigSchema as r,changelogConfigSchema as i,changelogVersioningConfigSchema as a,changelogVersioningSchema as o,changelogVersioningTargetSchema as s,changelogWorkflowsConfigSchema as c,dbxConfigSchema as l,loggerConfigSchema as u,projectConfigSchema as d,projectTypeSchema as f,providersConfigSchema as p,templateKindSchema as m,templateSourceSchema as h,templateSourceTypeSchema as g,templatesConfigSchema as _,toolchainConfigSchema as v,tsconfigConfigSchema as y,viteConfigSchema as b,watchConfigSchema as x,workflowConfigSchema as S,workflowSettingSchema as C,workflowStepSchema as w,workflowStepsConfigSchema as T}from"./config-schema.js";function E(e){return e}function D(e){return e===void 0?!1:typeof e==`boolean`?e:e.enabled!==!1}function O(e){return e!==void 0&&typeof e==`object`?e:void 0}const k=[`dbx.config.ts`,`dbx.config.mts`,`dbx.config.js`,`dbx.config.mjs`,`dbx.config.cjs`,`dbx.config.json`];function A(e){if(!e)return;let t=e.match(/github\.com[/:]([^/]+)\/([^/.]+?)(?:\.git)?$/);return t?.[1]&&t[2]?`${t[1]}/${t[2]}`:void 0}function j(e){return e===void 0?[]:Array.isArray(e)?e:[e]}function M(e){let t=e?.branches??{},n=j(t.main);n.length===0&&n.push(`main`);let r=j(t.dev);return{main:n,dev:r.length>0?r:n}}function N(e={}){let t=e.project??{},n=M(O(e.changelog)??{});return{name:t.name??`app`,scope:t.scope??``,author:t.author??``,license:t.license??`MIT`,homepage:t.homepage??``,repo:t.repo??``,repoSlug:A(t.repo)??``,description:t.description??``,nodeVersion:t.nodeVersion??`22`,packageManager:t.packageManager??`yarn`,yarnVersion:t.packageManagerVersion??`4.17.1`,packageManagerVersion:t.packageManagerVersion??`4.17.1`,mainBranch:n.main[0]??`main`,devBranch:n.dev[0]??`main`}}export{k as CONFIG_FILE_NAMES,e as CONFIG_SECTION_DESCRIPTIONS,t as CONFIG_SECTION_SCHEMAS,n as CONFIG_TYPE_SCHEMAS,r as biomeConfigSchema,i as changelogConfigSchema,a as changelogVersioningConfigSchema,o as changelogVersioningSchema,s as changelogVersioningTargetSchema,c as changelogWorkflowsConfigSchema,l as dbxConfigSchema,E as defineConfig,u as loggerConfigSchema,d as projectConfigSchema,f as projectTypeSchema,p as providersConfigSchema,A as repoSlugFromUrl,M as resolveChangelogBranches,N as resolveTokens,O as sectionConfig,D as sectionEnabled,m as templateKindSchema,h as templateSourceSchema,g as templateSourceTypeSchema,_ as templatesConfigSchema,v as toolchainConfigSchema,y as tsconfigConfigSchema,b as viteConfigSchema,x as watchConfigSchema,S as workflowConfigSchema,C as workflowSettingSchema,w as workflowStepSchema,T as workflowStepsConfigSchema};

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

@@ -1,8 +1,8 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
-import { Replacements } from "./template.js";
 import { ProjectType } from "./config-types.js";
-import { ToolchainConfig } from "./toolchain.js";
+import { Replacements } from "./template.js";
+import { SyncTask, ToolchainConfig } from "./toolchain.js";
 //#region packages/shared/src/types.d.ts
 /** A value that may or may not be awaited. */
 export type Awaitable<T> = T | Promise<T>;
@@ -40,6 +40,13 @@ export interface ToolchainCommandContext {
   tokens: Replacements;
   /** The config file that was loaded, if any. */
   configPath?: string;
+  /**
+   * The managed-file sync tasks `dbx sync` runs. Supplied by the CLI (which
+   * aggregates the packages) so a package command such as `migrate` can
+   * regenerate managed files without depending on every sync package. Absent
+   * when a command is driven programmatically.
+   */
+  syncTasks?: SyncTask[];
 }
 /** A positional argument a command accepts. */
 export interface ToolchainArgument {

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

@@ -5,7 +5,7 @@ import { GeneratedTsconfigResult } from "./utils.js";
 export interface GenerateTsconfigsOptions {
   /** The repo root to scan (default `process.cwd()`). */
   cwd?: string;
-  /** Inject path aliases from the monorepo config (default true). */
+  /** Inject path aliases from the workspaces config (default true). */
   aliases?: boolean;
   /** Emit `composite: true` + project references (default false). */
   composite?: boolean;
@@ -13,11 +13,17 @@ export interface GenerateTsconfigsOptions {
   refs?: boolean;
   /** JSON indentation (default 4). */
   indent?: number;
-  /** The glob for the workspace `tsconfig.default.json` files. */
-  glob?: string;
-  /** The glob for "override" (app) workspaces. */
-  appGlob?: string;
-  /** The monorepo tsconfig file name (default `tsconfig.monorepo.json`). */
+  /** The glob(s) for the workspace default tsconfig files. */
+  glob?: string | string[];
+  /** Extra glob(s) to exclude from `glob` (on top of the common ignored paths). */
+  exclude?: string | string[];
+  /** Respect `.gitignore` files (default true). */
+  gitignore?: boolean;
+  /** The workspace default tsconfig file name (default `tsconfig.default.json`). */
+  defaultFile?: string;
+  /** The workspace build tsconfig file name (default `tsconfig.build.json`). */
+  buildFile?: string;
+  /** The workspaces tsconfig file name (default `tsconfig.workspaces.json`). */
   monorepoTsconfigFilename?: string;
   /** Log progress (default true). */
   log?: boolean;
@@ -25,9 +31,10 @@ export interface GenerateTsconfigsOptions {
   write?: boolean;
 }
 /**
- * Extend every workspace `tsconfig.default.json` into a generated
- * `tsconfig.json` (and rewrite its `tsconfig.build.json`), optionally wiring
- * path aliases + project references from `tsconfig.monorepo.json`.
+ * Extend every workspace default tsconfig (`tsconfig.default.json`) into a
+ * generated `tsconfig.json`, optionally wiring path aliases + project references
+ * from the workspaces tsconfig (`tsconfig.workspaces.json`). Both the workspaces
+ * tsconfig and each workspace's `tsconfig.build.json` are optional.
  */
 export declare function generateTsconfigs(options?: GenerateTsconfigsOptions): GeneratedTsconfigResult[];
 /** CLI entry (used by the `tsconfig` command). */

package/dist/packages/tsconfig/src/cli/generate/index.js

@@ -1 +1 @@
-import{default as e}from"node:path";import{fileURLToPath as t,pathToFileURL as n}from"node:url";import.meta.url;import{logger as r}from"../../../../shared/src/logger.js";import"../../../../shared/src/index.js";import{generateTsconfig as i}from"./utils.js";import a from"node:fs";import{parseArgs as o}from"node:util";import{Glob as s}from"glob";function c(t={}){let{aliases:n=!0,composite:o=!1,refs:c=!1,indent:l=4,glob:u=`**/tsconfig.default.json`,appGlob:d=`apps/**/tsconfig.default.json`,monorepoTsconfigFilename:f=`tsconfig.monorepo.json`,log:p=!0,write:m=!0}=t,h=t.cwd??process.cwd(),g=e=>{p&&r.info(e)};n||g(`Ignoring path aliases for all tsconfigs...`),o||g(`Disabling compilerOptions.composite for all tsconfigs...`),c||g(`Ignoring project references for all tsconfigs...`);let _=e.resolve(h,f),v=e.relative(h,_),y=new s(u,{cwd:h,withFileTypes:!0}).walkSync(),b=new s(d,{cwd:h,withFileTypes:!0}).walkSync().map(e=>e.fullpath());g(`Extending ${y.length} tsconfigs with ${v}...`);let x=[];for(let t of y){let r=t.fullpath(),a=e.dirname(r),s=c&&b.some(e=>e===r);x.push(i({cwd:h,dirname:a,tsconfigPath:r,monorepoTsconfigPath:_,tsconfigBuildPath:e.resolve(a,`tsconfig.build.json`),targetTsconfigPath:e.resolve(a,`tsconfig.json`),targetTsconfigBuildPath:e.resolve(a,`tsconfig.build.json`),indent:l,disableComposite:!o||s,ignoreAliases:!n,ignoreReferences:!c,write:m}))}if(!c)return x;g(`Checking for additional tsconfig changes...`);for(let t of x){let{dirname:n,dirnameRelative:r,tsconfigPath:i,targetTsconfigPath:o,config:s}=t;g(`  - ${r}`),!b.some(e=>e===i)&&(s.references?.length&&(s.references=s.references.filter(t=>{let r=e.resolve(n,t.path);if(!a.existsSync(r))return g(`    tsconfig not found for ${t.path}, skipping.`),!1;let i=JSON.parse(a.readFileSync(r,`utf-8`));return i.compilerOptions?.composite!=null&&i.compilerOptions?.composite!==!1})),m&&a.writeFileSync(o,`${JSON.stringify(s,null,l)}\n`))}return x}function l(e=process.argv.slice(2)){let{values:t}=o({args:e,options:{aliases:{type:`boolean`,short:`a`,default:!0},composite:{type:`boolean`,short:`c`,default:!1},refs:{type:`boolean`,short:`r`,default:!1},indent:{type:`string`,short:`i`,default:`4`}}});c({aliases:t.aliases,composite:t.composite,refs:t.refs,indent:Number.parseInt(t.indent,10)})}if(/[\\/]generate[\\/]index\.[cm]?[jt]s$/.test(t(import.meta.url))&&import.meta.url===n(process.argv[1]??``).href)try{l()}catch(e){r.error(`Failed to generate tsconfigs due to: ${e}`),process.exit(1)}export{c as generateTsconfigs,l as runTsconfigCli};
+import{default as e}from"node:path";import{fileURLToPath as t,pathToFileURL as n}from"node:url";import.meta.url;import{resolveIgnorePatterns as r}from"../../../../shared/src/ignore.js";import{logger as i}from"../../../../shared/src/logger.js";import"../../../../shared/src/index.js";import{generateTsconfig as a}from"./utils.js";import o from"node:fs";import{parseArgs as s}from"node:util";import{Glob as c}from"glob";function l(t={}){let{aliases:n=!0,composite:s=!1,refs:l=!1,indent:u=4,gitignore:d=!0,defaultFile:f=`tsconfig.default.json`,buildFile:p=`tsconfig.build.json`,monorepoTsconfigFilename:m=`tsconfig.workspaces.json`,log:h=!0,write:g=!0}=t,_=t.glob??`**/${f}`,v=t.cwd??process.cwd(),y=e=>{h&&i.info(e)};n||y(`Ignoring path aliases for all tsconfigs...`),s||y(`Disabling compilerOptions.composite for all tsconfigs...`),l||y(`Ignoring project references for all tsconfigs...`);let b=e.resolve(v,m),x=e.relative(v,b),S=o.existsSync(b),C=Array.isArray(_)?_:[_],w=C.filter(e=>!e.startsWith(`!`)),T=[...C.filter(e=>e.startsWith(`!`)).map(e=>e.slice(1)),...r(v,{...t.exclude===void 0?{}:{exclude:t.exclude},gitignore:d})],E=new c(w.length?w:[`**/${f}`],{cwd:v,withFileTypes:!0,ignore:T}).walkSync();y(S?`Extending ${E.length} tsconfigs with ${x}...`:`Extending ${E.length} tsconfigs (no ${x})...`);let D=[];for(let t of E){let r=t.fullpath(),i=e.dirname(r);D.push(a({cwd:v,dirname:i,tsconfigPath:r,monorepoTsconfigPath:b,tsconfigBuildPath:e.resolve(i,p),targetTsconfigPath:e.resolve(i,`tsconfig.json`),targetTsconfigBuildPath:e.resolve(i,p),indent:u,disableComposite:!s,ignoreAliases:!n,ignoreReferences:!l,write:g}))}if(!l)return D;y(`Checking for additional tsconfig changes...`);for(let t of D){let{dirname:n,dirnameRelative:r,targetTsconfigPath:i,config:a}=t;y(`  - ${r}`),a.references?.length&&(a.references=a.references.filter(t=>{let r=e.resolve(n,t.path);if(!o.existsSync(r))return y(`    tsconfig not found for ${t.path}, skipping.`),!1;let i=JSON.parse(o.readFileSync(r,`utf-8`));return i.compilerOptions?.composite!=null&&i.compilerOptions?.composite!==!1})),g&&o.writeFileSync(i,`${JSON.stringify(a,null,u)}\n`)}return D}function u(e=process.argv.slice(2)){let{values:t}=s({args:e,options:{aliases:{type:`boolean`,short:`a`,default:!0},composite:{type:`boolean`,short:`c`,default:!1},refs:{type:`boolean`,short:`r`,default:!1},indent:{type:`string`,short:`i`,default:`4`},glob:{type:`string`,multiple:!0},exclude:{type:`string`,multiple:!0},gitignore:{type:`boolean`,default:!0},"default-file":{type:`string`},"build-file":{type:`string`},"root-file":{type:`string`}}});l({aliases:t.aliases,composite:t.composite,refs:t.refs,indent:Number.parseInt(t.indent,10),...t.glob?{glob:t.glob}:{},...t.exclude?{exclude:t.exclude}:{},gitignore:t.gitignore,...t[`default-file`]?{defaultFile:t[`default-file`]}:{},...t[`build-file`]?{buildFile:t[`build-file`]}:{},...t[`root-file`]?{monorepoTsconfigFilename:t[`root-file`]}:{}})}if(/[\\/]generate[\\/]index\.[cm]?[jt]s$/.test(t(import.meta.url))&&import.meta.url===n(process.argv[1]??``).href)try{u()}catch(e){i.error(`Failed to generate tsconfigs due to: ${e}`),process.exit(1)}export{l as generateTsconfigs,u as runTsconfigCli};

package/dist/packages/tsconfig/src/cli/generate/utils.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 n from"node:fs";function r(r){let{cwd:a,dirname:o,tsconfigPath:s,monorepoTsconfigPath:c,tsconfigBuildPath:l,targetTsconfigPath:u,targetTsconfigBuildPath:d,indent:f=4,disableComposite:p,ignoreAliases:m,ignoreReferences:h,write:g=!0}=r,_=e.relative(a,o).replace(/\\/g,`/`)||`.`;try{if(!n.existsSync(s))throw Error(`Source tsconfig not found: ${s}`);if(!c)throw Error(`options.monorepoTsconfigPath not set for ${s}`);if(!n.existsSync(c))throw Error(`Root 'tsconfig.monorepo.json' not found: ${c}`);t.info(`  - ${_}`);let d=e.basename(s),v=n.existsSync(l),y=JSON.parse(n.readFileSync(c,`utf-8`)),b=JSON.parse(n.readFileSync(s,`utf-8`)),x=v?JSON.parse(n.readFileSync(l,`utf-8`)):void 0,S=p?[]:[.../* @__PURE__ */ new Set([...b.compilerOptions?.types??[],...p?[]:y.compilerOptions?.types??[]])],C={...p?{}:y,extends:`./${d}`,compilerOptions:{...p?{composite:!1}:y.compilerOptions,...S.length?{types:S}:{},...m?{}:{paths:{...b.compilerOptions?.paths,...y.compilerOptions?.paths?Object.fromEntries(Object.entries(y.compilerOptions.paths).reduce((e,t)=>{let[n,r]=t,s=!0,c=r.map(e=>i(e,o,a)),l=[];for(let{newPath:e,isRoot:t,inRootDir:n}of c)(!t&&!n||/^.$/.test(_))&&(s=!1,l.push(e));return s?e:e.concat([[n,l]])},[])):{}}}},...h?{}:{references:(b.references??[]).concat(y.references??[]).reduce((e,t)=>{if(e.find(e=>e.path===t.path))return e;let{newPath:n,isRoot:r,inRootDir:s}=i(t.path,o,a);return(r||s)&&!/^.$/.test(_)?e:e.concat([{...t,path:n}])},[])}},w=v?{...x,extends:`./${d}`}:void 0;return g&&n.writeFileSync(u,`${JSON.stringify(C,null,f)}\n`),{...r,dirnameRelative:_,tsconfigFilename:d,config:C,newTsconfig:C,newTsconfigBuild:w,originalConfig:b,tsconfigMonorepo:y,tsconfigBuild:x}}catch(e){t.error(`  Failed to extend tsconfig for ${_} due to: ${e}`),process.exit(1)}}function i(t,n,r){let i=e.resolve(r,t),a=e.basename(i),o=e.dirname(i),s=e.join(e.relative(n,o),a).replace(/\\/g,`/`);s=s.startsWith(`.`)?s:`./${s}`;let c=e.dirname(e.resolve(n,s));return{isRoot:n===c,inRootDir:c.startsWith(n),newPath:s,newPathDirname:c}}export{r as generateTsconfig};
+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 n from"node:fs";function r(r){let{cwd:a,dirname:o,tsconfigPath:s,monorepoTsconfigPath:c,tsconfigBuildPath:l,targetTsconfigPath:u,targetTsconfigBuildPath:d,indent:f=4,disableComposite:p,ignoreAliases:m,ignoreReferences:h,write:g=!0}=r,_=e.relative(a,o).replace(/\\/g,`/`)||`.`;try{if(!n.existsSync(s))throw Error(`Source tsconfig not found: ${s}`);if(!c)throw Error(`options.monorepoTsconfigPath not set for ${s}`);t.info(`  - ${_}`);let d=e.basename(s),v=n.existsSync(l),y=n.existsSync(c)?JSON.parse(n.readFileSync(c,`utf-8`)):{},b=JSON.parse(n.readFileSync(s,`utf-8`)),x=v?JSON.parse(n.readFileSync(l,`utf-8`)):void 0,S=p?[]:[.../* @__PURE__ */ new Set([...b.compilerOptions?.types??[],...p?[]:y.compilerOptions?.types??[]])],C={...p?{}:y,extends:`./${d}`,compilerOptions:{...p?{composite:!1}:y.compilerOptions,...S.length?{types:S}:{},...m?{}:{paths:{...b.compilerOptions?.paths,...y.compilerOptions?.paths?Object.fromEntries(Object.entries(y.compilerOptions.paths).reduce((e,t)=>{let[n,r]=t,s=!0,c=r.map(e=>i(e,o,a)),l=[];for(let{newPath:e,isRoot:t,inRootDir:n}of c)(!t&&!n||/^.$/.test(_))&&(s=!1,l.push(e));return s?e:e.concat([[n,l]])},[])):{}}}},...h?{}:{references:(b.references??[]).concat(y.references??[]).reduce((e,t)=>{if(e.find(e=>e.path===t.path))return e;let{newPath:n,isRoot:r,inRootDir:s}=i(t.path,o,a);return(r||s)&&!/^.$/.test(_)?e:e.concat([{...t,path:n}])},[])}},w=v?{...x,extends:`./${d}`}:void 0;return g&&n.writeFileSync(u,`${JSON.stringify(C,null,f)}\n`),{...r,dirnameRelative:_,tsconfigFilename:d,config:C,newTsconfig:C,newTsconfigBuild:w,originalConfig:b,tsconfigMonorepo:y,tsconfigBuild:x}}catch(e){t.error(`  Failed to extend tsconfig for ${_} due to: ${e}`),process.exit(1)}}function i(t,n,r){let i=e.resolve(r,t),a=e.basename(i),o=e.dirname(i),s=e.join(e.relative(n,o),a).replace(/\\/g,`/`);s=s.startsWith(`.`)?s:`./${s}`;let c=e.dirname(e.resolve(n,s));return{isRoot:n===c,inRootDir:c.startsWith(n),newPath:s,newPathDirname:c}}export{r as generateTsconfig};

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

@@ -4,7 +4,7 @@ import { ToolchainCommand } from "../../../shared/src/types.js";
 import "../../../shared/src/index.js";
 //#region packages/tsconfig/src/cli/index.d.ts
 /**
- * The `tsconfig` command. Defaults come from `dbx.config.tsconfig.*;
+ * The `tsconfig` command. Defaults come from `dbx.config.tsconfig.*`
  * (via the command context); any CLI flag overrides them.
  */
 export declare function tsconfigCommands(): ToolchainCommand[];

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

@@ -1 +1 @@
-import"node:path";import"node:url";import.meta.url;import{sectionConfig as e}from"../../../shared/src/toolchain.js";import"../../../shared/src/index.js";import{generateTsconfigs as t}from"./generate/index.js";function n(){return[{name:`tsconfig`,description:`Generate workspace tsconfig.json files from tsconfig.default.json (aliases + references).`,options:[{flags:`--cwd <dir>`,description:`Repo root to scan (default: cwd).`},{flags:`--no-aliases`,description:`Skip path aliases.`},{flags:`--composite`,description:`Emit composite + references.`},{flags:`--refs`,description:`Wire project references.`},{flags:`-i, --indent <n>`,description:`JSON indentation.`},{flags:`--glob <glob>`,description:`Glob for tsconfig.default.json files.`},{flags:`--app-glob <glob>`,description:`Glob for app override workspaces.`},{flags:`--root-file <file>`,description:`Monorepo tsconfig file name.`}],run:(n,r)=>{let i=e(r.config.tsconfig)??{};t({cwd:r.cwd,aliases:n.aliases??i.aliases??!0,composite:n.composite??i.composite??!1,refs:n.refs??i.refs??!1,indent:n.indent===void 0?i.indent:Number.parseInt(String(n.indent),10),glob:n.glob??i.glob??`**/tsconfig.default.json`,appGlob:n.appGlob??i.appGlob??`apps/**/tsconfig.default.json`,monorepoTsconfigFilename:n.rootFile??i.rootFile??`tsconfig.monorepo.json`})}}]}export{n as tsconfigCommands};
+import"node:path";import"node:url";import.meta.url;import{sectionConfig as e}from"../../../shared/src/toolchain.js";import"../../../shared/src/index.js";import{generateTsconfigs as t}from"./generate/index.js";function n(){return[{name:`tsconfig`,description:`Generate workspace tsconfig.json files from the default tsconfig (aliases + references).`,options:[{flags:`--cwd <dir>`,description:`Repo root to scan (default: cwd).`},{flags:`--no-aliases`,description:`Skip path aliases.`},{flags:`--composite`,description:`Emit composite + references.`},{flags:`--refs`,description:`Wire project references.`},{flags:`-i, --indent <n>`,description:`JSON indentation.`},{flags:`--glob <glob...>`,description:`Glob(s) for the default tsconfig files.`},{flags:`--exclude <glob...>`,description:`Glob(s) to exclude (on top of the common ignored paths).`},{flags:`--no-gitignore`,description:`Do not respect .gitignore files.`},{flags:`--default-file <file>`,description:`Default tsconfig file name.`},{flags:`--build-file <file>`,description:`Build tsconfig file name.`},{flags:`--root-file <file>`,description:`Workspaces tsconfig file name.`}],run:(n,r)=>{let i=e(r.config.tsconfig)??{},a=n.glob;t({cwd:r.cwd,aliases:n.aliases??i.aliases??!0,composite:n.composite??i.composite??!1,refs:n.refs??i.refs??!1,indent:n.indent===void 0?i.indent:Number.parseInt(String(n.indent),10),glob:a??i.glob??`**/tsconfig.default.json`,exclude:n.exclude??i.exclude,gitignore:n.gitignore??i.gitignore,defaultFile:n.defaultFile??i.defaultFile??`tsconfig.default.json`,buildFile:n.buildFile??i.buildFile??`tsconfig.build.json`,monorepoTsconfigFilename:n.rootFile??i.rootFile??`tsconfig.workspaces.json`})}}]}export{n as tsconfigCommands};