@deltabox/toolchain 1.3.1 → 1.6.0

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

@@ -1,19 +1,20 @@
 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 { 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 { ToolingProvider, ToolingProviderAction, ToolingProviderCommand, providerActions } from "./provider.js";
-import { RunOptions, run, spawnCross } from "./run.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, snakeCase, str, titleCase } from "./string-utils.js";
 import { ReplacementOptions, ReplacementValue, Replacements, Replacer, applyReplacements, applyReplacementsDeep, createReplacer, defineReplacements, extractTokens, hasUnresolvedTokens, tokenPattern } from "./template.js";
-import { ChangelogWorkflowsConfig, DbxConfigSections, ProjectType, ToolingBiomeConfig, ToolingChangelogConfig, ToolingConfigSections, ToolingLoggerConfig, ToolingProjectConfig, ToolingProvidersConfig, ToolingTemplateKind, ToolingTemplateSource, ToolingTemplateSourceType, ToolingTemplatesConfig, ToolingTsconfigConfig, ToolingViteConfig, ToolingWatchConfig, WorkflowConfig, WorkflowSetting, WorkflowStep, WorkflowStepsConfig } from "./config-types.js";
-import { Awaitable, GeneratedFile, JsonValue, PackageJson, ToolingArgument, ToolingCommand, ToolingCommandContext, ToolingOption } from "./types.js";
-import { CONFIG_SECTION_DESCRIPTIONS, CONFIG_SECTION_SCHEMAS, CONFIG_TYPE_SCHEMAS, biomeConfigSchema, changelogConfigSchema, changelogWorkflowsConfigSchema, dbxConfigSchema, loggerConfigSchema, projectConfigSchema, projectTypeSchema, providersConfigSchema, templateKindSchema, templateSourceSchema, templateSourceTypeSchema, templatesConfigSchema, toolingConfigSchema, tsconfigConfigSchema, viteConfigSchema, watchConfigSchema, workflowConfigSchema, workflowSettingSchema, workflowStepSchema, workflowStepsConfigSchema } from "./config-schema.js";
-import { CONFIG_FILE_NAMES, DbxConfig, ManagedFile, SyncContext, SyncSummary, SyncTask, ToolingConfig, ToolingHooks, ToolingSection, defineConfig, repoSlugFromUrl, resolveTokens, sectionConfig, sectionEnabled } from "./toolchain.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, ChangelogWorkflowsConfig, Colors, DbxConfig, DbxConfigSections, GeneratedFile, JsonValue, LOG_LEVELS, LogChannel, LogLevel, Logger, LoggerConfig, LoggerOptions, ManagedFile, PackageJson, ProjectType, ReplacementOptions, ReplacementValue, Replacements, Replacer, RunOptions, Sortable, SyncContext, SyncSummary, SyncTask, ToolingArgument, ToolingBiomeConfig, ToolingChangelogConfig, ToolingCommand, ToolingCommandContext, ToolingConfig, ToolingConfigSections, ToolingHooks, ToolingLoggerConfig, ToolingOption, ToolingProjectConfig, ToolingProvider, ToolingProviderAction, ToolingProviderCommand, ToolingProvidersConfig, ToolingSection, ToolingTemplateKind, ToolingTemplateSource, ToolingTemplateSourceType, ToolingTemplatesConfig, ToolingTsconfigConfig, ToolingViteConfig, ToolingWatchConfig, WorkflowConfig, WorkflowSetting, WorkflowStep, WorkflowStepsConfig, YamlValue, applyReplacements, applyReplacementsDeep, asString, biomeConfigSchema, camelCase, camelCaseId, capitalize, changelogConfigSchema, changelogWorkflowsConfigSchema, configureLogger, constantCase, createLogger, createReplacer, dbxConfigSchema, deepMerge, defineConfig, defineReplacements, ensureLeadingSlash, ensureSlashes, ensureTrailingSlash, extractTokens, formatCliFlag, getLogOverrides, getLogger, hasText, hasUnresolvedTokens, indent, isLocalhost, isLogLevel, isPlainObject, kebabCase, logger, loggerConfigSchema, mapValues, mergeJsonAt, normalizeLogLevel, pascalCase, projectConfigSchema, projectTypeSchema, providerActions, providersConfigSchema, readJsonAt, readJsonFile, removeDoubleSlashes, removeLeadingSlash, removeTrailingSlash, repoSlugFromUrl, resolveSort, resolveTokens, run, sanitizeSlashes, sectionConfig, sectionEnabled, setLogConfig, setLogOverrides, snakeCase, sort, spawnCross, str, stripAnsi, templateKindSchema, templateSourceSchema, templateSourceTypeSchema, templatesConfigSchema, titleCase, toJson, toYaml, tokenPattern, toolingConfigSchema, 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, 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, sectionConfig, sectionEnabled, setLogConfig, setLogOverrides, snakeCase, sort, spawnCross, str, stripAnsi, 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, ChangelogWorkflowsConfig, Colors, DbxConfig, DbxConfigSections, GeneratedFile, JsonValue, LOG_LEVELS, LogChannel, LogLevel, Logger, LoggerConfig, LoggerOptions, ManagedFile, PackageJson, ProjectType, ReplacementOptions, ReplacementValue, Replacements, Replacer, RunOptions, Sortable, SyncContext, SyncSummary, SyncTask, ToolingArgument, ToolingBiomeConfig, ToolingChangelogConfig, ToolingCommand, ToolingCommandContext, ToolingConfig, ToolingConfigSections, ToolingHooks, ToolingLoggerConfig, ToolingOption, ToolingProjectConfig, ToolingProvider, ToolingProviderAction, ToolingProviderCommand, ToolingProvidersConfig, ToolingSection, ToolingTemplateKind, ToolingTemplateSource, ToolingTemplateSourceType, ToolingTemplatesConfig, ToolingTsconfigConfig, ToolingViteConfig, ToolingWatchConfig, WorkflowConfig, WorkflowSetting, WorkflowStep, WorkflowStepsConfig, type YamlValue, applyReplacements, applyReplacementsDeep, asString, biomeConfigSchema, camelCase, camelCaseId, capitalize, changelogConfigSchema, changelogWorkflowsConfigSchema, configureLogger, constantCase, createLogger, createReplacer, dbxConfigSchema, deepMerge, defineConfig, defineReplacements, ensureLeadingSlash, ensureSlashes, ensureTrailingSlash, extractTokens, formatCliFlag, getLogOverrides, getLogger, hasText, hasUnresolvedTokens, indent, index_d_exports, isLocalhost, isLogLevel, isPlainObject, kebabCase, logger, loggerConfigSchema, mapValues, mergeJsonAt, normalizeLogLevel, pascalCase, projectConfigSchema, projectTypeSchema, providerActions, providersConfigSchema, readJsonAt, readJsonFile, removeDoubleSlashes, removeLeadingSlash, removeTrailingSlash, repoSlugFromUrl, resolveSort, resolveTokens, run, sanitizeSlashes, sectionConfig, sectionEnabled, setLogConfig, setLogOverrides, snakeCase, sort, spawnCross, str, stripAnsi, templateKindSchema, templateSourceSchema, templateSourceTypeSchema, templatesConfigSchema, titleCase, toJson, toYaml, tokenPattern, toolingConfigSchema, 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, 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, sectionConfig, sectionEnabled, setLogConfig, setLogOverrides, snakeCase, sort, spawnCross, str, stripAnsi, 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{deepMerge as e,isPlainObject as t,mapValues as n,resolveSort as r,sort as i}from"./object-utils.js";import{mergeJsonAt as a,readJsonAt as o,readJsonFile as s,toJson as c,writeJsonFile as l}from"./fs-utils.js";import{LOG_LEVELS as u,configureLogger as d,createLogger as f,getLogOverrides as p,getLogger as m,isLogLevel as h,logger as g,normalizeLogLevel as _,setLogConfig as v,setLogOverrides as y,stripAnsi as b}from"./logger.js";import{providerActions as x}from"./provider.js";import{run as S,spawnCross as C}from"./run.js";import{asString as w,camelCase as T,camelCaseId as E,capitalize as D,constantCase as O,ensureLeadingSlash as k,ensureSlashes as A,ensureTrailingSlash as j,formatCliFlag as M,hasText as N,indent as P,isLocalhost as F,kebabCase as I,pascalCase as L,removeDoubleSlashes as R,removeLeadingSlash as z,removeTrailingSlash as B,sanitizeSlashes as V,snakeCase as H,str as U,titleCase as te}from"./string-utils.js";import{applyReplacements as W,applyReplacementsDeep as G,createReplacer as K,defineReplacements as q,extractTokens as J,hasUnresolvedTokens as Y,tokenPattern as X}from"./template.js";import{CONFIG_SECTION_DESCRIPTIONS as Z,CONFIG_SECTION_SCHEMAS as Q,CONFIG_TYPE_SCHEMAS as $,biomeConfigSchema as ne,changelogConfigSchema as re,changelogWorkflowsConfigSchema as ie,dbxConfigSchema as ae,loggerConfigSchema as oe,projectConfigSchema as se,projectTypeSchema as ce,providersConfigSchema as le,templateKindSchema as ue,templateSourceSchema as de,templateSourceTypeSchema as fe,templatesConfigSchema as pe,toolingConfigSchema as me,tsconfigConfigSchema as he,viteConfigSchema as ge,watchConfigSchema as _e,workflowConfigSchema as ve,workflowSettingSchema as ye,workflowStepSchema as be,workflowStepsConfigSchema as xe}from"./config-schema.js";import{CONFIG_FILE_NAMES as Se,defineConfig as Ce,repoSlugFromUrl as we,resolveTokens as Te,sectionConfig as Ee,sectionEnabled as De}from"./toolchain.js";import{toYaml as Oe}from"./yaml.js";var ke=/* @__PURE__ */ ee({CONFIG_FILE_NAMES:()=>Se,CONFIG_SECTION_DESCRIPTIONS:()=>Z,CONFIG_SECTION_SCHEMAS:()=>Q,CONFIG_TYPE_SCHEMAS:()=>$,LOG_LEVELS:()=>u,applyReplacements:()=>W,applyReplacementsDeep:()=>G,asString:()=>w,biomeConfigSchema:()=>ne,camelCase:()=>T,camelCaseId:()=>E,capitalize:()=>D,changelogConfigSchema:()=>re,changelogWorkflowsConfigSchema:()=>ie,configureLogger:()=>d,constantCase:()=>O,createLogger:()=>f,createReplacer:()=>K,dbxConfigSchema:()=>ae,deepMerge:()=>e,defineConfig:()=>Ce,defineReplacements:()=>q,ensureLeadingSlash:()=>k,ensureSlashes:()=>A,ensureTrailingSlash:()=>j,extractTokens:()=>J,formatCliFlag:()=>M,getLogOverrides:()=>p,getLogger:()=>m,hasText:()=>N,hasUnresolvedTokens:()=>Y,indent:()=>P,isLocalhost:()=>F,isLogLevel:()=>h,isPlainObject:()=>t,kebabCase:()=>I,logger:()=>g,loggerConfigSchema:()=>oe,mapValues:()=>n,mergeJsonAt:()=>a,normalizeLogLevel:()=>_,pascalCase:()=>L,projectConfigSchema:()=>se,projectTypeSchema:()=>ce,providerActions:()=>x,providersConfigSchema:()=>le,readJsonAt:()=>o,readJsonFile:()=>s,removeDoubleSlashes:()=>R,removeLeadingSlash:()=>z,removeTrailingSlash:()=>B,repoSlugFromUrl:()=>we,resolveSort:()=>r,resolveTokens:()=>Te,run:()=>S,sanitizeSlashes:()=>V,sectionConfig:()=>Ee,sectionEnabled:()=>De,setLogConfig:()=>v,setLogOverrides:()=>y,snakeCase:()=>H,sort:()=>i,spawnCross:()=>C,str:()=>U,stripAnsi:()=>b,templateKindSchema:()=>ue,templateSourceSchema:()=>de,templateSourceTypeSchema:()=>fe,templatesConfigSchema:()=>pe,titleCase:()=>te,toJson:()=>c,toYaml:()=>Oe,tokenPattern:()=>X,toolingConfigSchema:()=>me,tsconfigConfigSchema:()=>he,viteConfigSchema:()=>ge,watchConfigSchema:()=>_e,workflowConfigSchema:()=>ve,workflowSettingSchema:()=>ye,workflowStepSchema:()=>be,workflowStepsConfigSchema:()=>xe,writeJsonFile:()=>l});export{Se as CONFIG_FILE_NAMES,Z as CONFIG_SECTION_DESCRIPTIONS,Q as CONFIG_SECTION_SCHEMAS,$ as CONFIG_TYPE_SCHEMAS,u as LOG_LEVELS,W as applyReplacements,G as applyReplacementsDeep,w as asString,ne as biomeConfigSchema,T as camelCase,E as camelCaseId,D as capitalize,re as changelogConfigSchema,ie as changelogWorkflowsConfigSchema,d as configureLogger,O as constantCase,f as createLogger,K as createReplacer,ae as dbxConfigSchema,e as deepMerge,Ce as defineConfig,q as defineReplacements,k as ensureLeadingSlash,A as ensureSlashes,j as ensureTrailingSlash,J as extractTokens,M as formatCliFlag,p as getLogOverrides,m as getLogger,N as hasText,Y as hasUnresolvedTokens,P as indent,F as isLocalhost,h as isLogLevel,t as isPlainObject,I as kebabCase,g as logger,oe as loggerConfigSchema,n as mapValues,a as mergeJsonAt,_ as normalizeLogLevel,L as pascalCase,se as projectConfigSchema,ce as projectTypeSchema,x as providerActions,le as providersConfigSchema,o as readJsonAt,s as readJsonFile,R as removeDoubleSlashes,z as removeLeadingSlash,B as removeTrailingSlash,we as repoSlugFromUrl,r as resolveSort,Te as resolveTokens,S as run,V as sanitizeSlashes,Ee as sectionConfig,De as sectionEnabled,v as setLogConfig,y as setLogOverrides,H as snakeCase,i as sort,C as spawnCross,ke as src_exports,U as str,b as stripAnsi,ue as templateKindSchema,de as templateSourceSchema,fe as templateSourceTypeSchema,pe as templatesConfigSchema,te as titleCase,c as toJson,Oe as toYaml,X as tokenPattern,me as toolingConfigSchema,he as tsconfigConfigSchema,ge as viteConfigSchema,_e as watchConfigSchema,ve as workflowConfigSchema,ye as workflowSettingSchema,be as workflowStepSchema,xe as workflowStepsConfigSchema,l 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{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,snakeCase as K,str as q,titleCase as te}from"./string-utils.js";import{applyReplacements as J,applyReplacementsDeep as Y,createReplacer as X,defineReplacements as Z,extractTokens as Q,hasUnresolvedTokens as $,tokenPattern as ne}from"./template.js";import{CONFIG_SECTION_DESCRIPTIONS as re,CONFIG_SECTION_SCHEMAS as ie,CONFIG_TYPE_SCHEMAS as ae,biomeConfigSchema as oe,changelogConfigSchema as se,changelogVersioningConfigSchema as ce,changelogVersioningSchema as le,changelogVersioningTargetSchema as ue,changelogWorkflowsConfigSchema as de,dbxConfigSchema as fe,loggerConfigSchema as pe,projectConfigSchema as me,projectTypeSchema as he,providersConfigSchema as ge,templateKindSchema as _e,templateSourceSchema as ve,templateSourceTypeSchema as ye,templatesConfigSchema as be,toolchainConfigSchema as xe,tsconfigConfigSchema as Se,viteConfigSchema as Ce,watchConfigSchema as we,workflowConfigSchema as Te,workflowSettingSchema as Ee,workflowStepSchema as De,workflowStepsConfigSchema as Oe}from"./config-schema.js";import{CONFIG_FILE_NAMES as ke,defineConfig as Ae,repoSlugFromUrl as je,resolveTokens as Me,sectionConfig as Ne,sectionEnabled as Pe}from"./toolchain.js";import{toYaml as Fe}from"./yaml.js";var Ie=/* @__PURE__ */ ee({CONFIG_FILE_NAMES:()=>ke,CONFIG_SECTION_DESCRIPTIONS:()=>re,CONFIG_SECTION_SCHEMAS:()=>ie,CONFIG_TYPE_SCHEMAS:()=>ae,LOG_LEVELS:()=>p,TOOLCHAIN_PACKAGE:()=>e,applyReplacements:()=>J,applyReplacementsDeep:()=>Y,asString:()=>O,biomeConfigSchema:()=>oe,camelCase:()=>k,camelCaseId:()=>A,capitalize:()=>j,changelogConfigSchema:()=>se,changelogVersioningConfigSchema:()=>ce,changelogVersioningSchema:()=>le,changelogVersioningTargetSchema:()=>ue,changelogWorkflowsConfigSchema:()=>de,configureLogger:()=>m,constantCase:()=>M,createLogger:()=>h,createReplacer:()=>X,dbxConfigSchema:()=>fe,deepMerge:()=>r,defineConfig:()=>Ae,defineReplacements:()=>Z,ensureLeadingSlash:()=>N,ensureSlashes:()=>P,ensureTrailingSlash:()=>F,extractTokens:()=>Q,findOwnCliEntry:()=>t,formatCliFlag:()=>I,getLogOverrides:()=>g,getLogger:()=>_,hasText:()=>L,hasUnresolvedTokens:()=>$,indent:()=>R,isLocalhost:()=>z,isLogLevel:()=>v,isPlainObject:()=>i,kebabCase:()=>B,killProcessTree:()=>T,localToolchainVersion:()=>n,logger:()=>y,loggerConfigSchema:()=>pe,mapValues:()=>a,mergeJsonAt:()=>c,normalizeLogLevel:()=>b,pascalCase:()=>V,projectConfigSchema:()=>me,projectTypeSchema:()=>he,providerActions:()=>w,providersConfigSchema:()=>ge,readJsonAt:()=>l,readJsonFile:()=>u,removeDoubleSlashes:()=>H,removeLeadingSlash:()=>U,removeTrailingSlash:()=>W,repoSlugFromUrl:()=>je,resolveSort:()=>o,resolveTokens:()=>Me,run:()=>E,sanitizeSlashes:()=>G,sectionConfig:()=>Ne,sectionEnabled:()=>Pe,setLogConfig:()=>x,setLogOverrides:()=>S,snakeCase:()=>K,sort:()=>s,spawnCross:()=>D,str:()=>q,stripAnsi:()=>C,templateKindSchema:()=>_e,templateSourceSchema:()=>ve,templateSourceTypeSchema:()=>ye,templatesConfigSchema:()=>be,titleCase:()=>te,toJson:()=>d,toYaml:()=>Fe,tokenPattern:()=>ne,toolchainConfigSchema:()=>xe,tsconfigConfigSchema:()=>Se,viteConfigSchema:()=>Ce,watchConfigSchema:()=>we,workflowConfigSchema:()=>Te,workflowSettingSchema:()=>Ee,workflowStepSchema:()=>De,workflowStepsConfigSchema:()=>Oe,writeJsonFile:()=>f});export{ke as CONFIG_FILE_NAMES,re as CONFIG_SECTION_DESCRIPTIONS,ie as CONFIG_SECTION_SCHEMAS,ae as CONFIG_TYPE_SCHEMAS,p as LOG_LEVELS,e as TOOLCHAIN_PACKAGE,J as applyReplacements,Y as applyReplacementsDeep,O as asString,oe as biomeConfigSchema,k as camelCase,A as camelCaseId,j as capitalize,se as changelogConfigSchema,ce as changelogVersioningConfigSchema,le as changelogVersioningSchema,ue as changelogVersioningTargetSchema,de as changelogWorkflowsConfigSchema,m as configureLogger,M as constantCase,h as createLogger,X as createReplacer,fe as dbxConfigSchema,r as deepMerge,Ae as defineConfig,Z as defineReplacements,N as ensureLeadingSlash,P as ensureSlashes,F as ensureTrailingSlash,Q as extractTokens,t as findOwnCliEntry,I as formatCliFlag,g as getLogOverrides,_ as getLogger,L as hasText,$ 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,pe as loggerConfigSchema,a as mapValues,c as mergeJsonAt,b as normalizeLogLevel,V as pascalCase,me as projectConfigSchema,he as projectTypeSchema,w as providerActions,ge as providersConfigSchema,l as readJsonAt,u as readJsonFile,H as removeDoubleSlashes,U as removeLeadingSlash,W as removeTrailingSlash,je as repoSlugFromUrl,o as resolveSort,Me as resolveTokens,E as run,G as sanitizeSlashes,Ne as sectionConfig,Pe as sectionEnabled,x as setLogConfig,S as setLogOverrides,K as snakeCase,s as sort,D as spawnCross,Ie as src_exports,q as str,C as stripAnsi,_e as templateKindSchema,ve as templateSourceSchema,ye as templateSourceTypeSchema,be as templatesConfigSchema,te as titleCase,d as toJson,Fe as toYaml,ne as tokenPattern,xe as toolchainConfigSchema,Se as tsconfigConfigSchema,Ce as viteConfigSchema,we as watchConfigSchema,Te as workflowConfigSchema,Ee as workflowSettingSchema,De as workflowStepSchema,Oe as workflowStepsConfigSchema,f as writeJsonFile};

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

@@ -13,7 +13,10 @@ export declare const LOG_LEVELS: readonly ['debug', 'info', 'warn', 'error', 'si
 export interface LoggerOptions {
   /** Minimum level to print (default `info`). */
   level?: LogLevel;
-  /** Force colors on/off (default: `picocolors` autodetection). */
+  /**
+   * Force colors on/off (default: on). The toolchain colors its output by
+   * default; `--no-color` or `logger.color: false` turn it off.
+   */
   color?: boolean;
   /** Prefix non-indented lines with `<name>:` (default `dbx`). */
   name?: string;
@@ -23,11 +26,11 @@ export interface Logger {
   readonly level: LogLevel;
   /** A `picocolors` color set honoring the color setting. */
   readonly colors: Colors;
-  /** Machine-readable output: raw to stdout, no prefix, no color. */
+  /** Machine-readable output: raw to stdout, no prefix, no decoration. */
   raw(message?: string): void;
-  /** Raw output to stderr, no prefix, no color. */
+  /** Raw output to stderr, no prefix, no decoration. */
   rawError(message?: string): void;
-  /** Write `text` verbatim to a channel (no prefix, no color, no added newline). */
+  /** Write `text` verbatim to a channel (no prefix, no decoration, no newline). */
   write(channel: LogChannel, text: string): void;
   debug(message?: string): void;
   info(message?: string): void;

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

@@ -1 +1 @@
-import"node:path";import"node:url";import.meta.url;import e from"picocolors";const t=[`debug`,`info`,`warn`,`error`,`silent`],n={debug:0,info:1,warn:2,error:3,silent:4};function r(e){return typeof e==`string`&&t.includes(e)}function i(e,t=`info`){return r(e)?e:t}function a(e){return e.replace(/\x1b\[[0-9;]*m/g,``)}function o(t={}){let r=i(t.level),a=n[r],o=t.color===void 0?e:e.createColors(t.color),s=t.name?`${t.name}: `:``,c=(e,t)=>{let n=e===``?``:t(e);return!s||e===``||/^\s/.test(e)?n:`${o.dim(s)}${n}`},l=e=>{process.stdout.write(`${e}\n`)},u=e=>{process.stderr.write(`${e}\n`)};return{level:r,colors:o,raw:(e=``)=>l(e),rawError:(e=``)=>u(e),write:(e,t)=>{e===`err`?process.stderr.write(t):process.stdout.write(t)},debug:(e=``)=>{a<=n.debug&&l(c(e,o.dim))},info:(e=``)=>{a<=n.info&&l(c(e,e=>e))},success:(e=``)=>{a<=n.info&&l(c(e,o.green))},warn:(e=``)=>{a<=n.warn&&u(c(e,o.yellow))},error:(e=``)=>{a<=n.error&&u(c(e,o.red))}}}let s={},c={};function l(e){return!e||typeof e!=`object`?{}:{...r(e.level)?{level:e.level}:{},...typeof e.color==`boolean`?{color:e.color}:{},...typeof e.name==`string`?{name:e.name}:{}}}function u(){return o({name:`dbx`,...s,...c})}let d=u();function f(e){s=l(e),d=u()}function p(e){c=e,d=u()}function m(e){p(e)}function h(){return c}function g(){return d}const _={get level(){return d.level},get colors(){return d.colors},raw:(e=``)=>d.raw(e),rawError:(e=``)=>d.rawError(e),write:(e,t)=>d.write(e,t),debug:(e=``)=>d.debug(e),info:(e=``)=>d.info(e),success:(e=``)=>d.success(e),warn:(e=``)=>d.warn(e),error:(e=``)=>d.error(e)};export{t as LOG_LEVELS,m as configureLogger,o as createLogger,h as getLogOverrides,g as getLogger,r as isLogLevel,_ as logger,i as normalizeLogLevel,f as setLogConfig,p as setLogOverrides,a as stripAnsi};
+import"node:path";import"node:url";import.meta.url;import{log as e}from"@clack/prompts";import t from"picocolors";const n=[`debug`,`info`,`warn`,`error`,`silent`],r={debug:0,info:1,warn:2,error:3,silent:4};function i(e){return typeof e==`string`&&n.includes(e)}function a(e,t=`info`){return i(e)?e:t}function o(e){return e.replace(/\x1b\[[0-9;]*m/g,``)}function s(n={}){let i=a(n.level),o=r[i],s=t.createColors(n.color??!0),c=n.name?`${n.name}: `:``;typeof n.color==`boolean`&&d(n.color);let l=e=>!c||e===``||/^\s/.test(e)?e:`${c}${e}`,u=(e,t,n)=>{e(l(t),{spacing:0,...n?{output:n}:{}})};return{level:i,colors:s,raw:(e=``)=>{process.stdout.write(`${e}\n`)},rawError:(e=``)=>{process.stderr.write(`${e}\n`)},write:(e,t)=>{e===`err`?process.stderr.write(t):process.stdout.write(t)},debug:(t=``)=>{o<=r.debug&&u(e.message,t)},info:(t=``)=>{o<=r.info&&u(e.info,t)},success:(t=``)=>{o<=r.info&&u(e.success,t)},warn:(t=``)=>{o<=r.warn&&u(e.warn,t,process.stderr)},error:(t=``)=>{o<=r.error&&u(e.error,t,process.stderr)}}}let c={},l={};function u(e){return!e||typeof e!=`object`?{}:{...i(e.level)?{level:e.level}:{},...typeof e.color==`boolean`?{color:e.color}:{},...typeof e.name==`string`?{name:e.name}:{}}}function d(e){e?(delete process.env.NO_COLOR,process.env.FORCE_COLOR=`1`):(delete process.env.FORCE_COLOR,process.env.NO_COLOR=`1`)}function f(e=!0){let t={name:`dbx`,...c,...l};return e&&t.color===void 0&&(t.color=!0),s(t)}let p=f(!1);function m(e){c=u(e),p=f()}function h(e){l=e,p=f()}function g(e){h(e)}function _(){return l}function v(){return p}const y={get level(){return p.level},get colors(){return p.colors},raw:(e=``)=>p.raw(e),rawError:(e=``)=>p.rawError(e),write:(e,t)=>p.write(e,t),debug:(e=``)=>p.debug(e),info:(e=``)=>p.info(e),success:(e=``)=>p.success(e),warn:(e=``)=>p.warn(e),error:(e=``)=>p.error(e)};export{n as LOG_LEVELS,g as configureLogger,s as createLogger,_ as getLogOverrides,v as getLogger,i as isLogLevel,y as logger,a as normalizeLogLevel,m as setLogConfig,h as setLogOverrides,o as stripAnsi};

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

@@ -15,7 +15,7 @@ import __tsdown_shims_url from 'node:url';
  * this description (the extension over `dbx providers --json`).
  */
 /** A CLI command a provider contributes (namespaced, eg. `vite:dev`). */
-export interface ToolingProviderCommand {
+export interface ToolchainProviderCommand {
   /** The namespaced `dbx` command name, eg. `vite:dev`. */
   name: string;
   /** The wrapped subcommand on the provider binary, eg. `dev`. */
@@ -28,7 +28,7 @@ export interface ToolingProviderCommand {
   aliases?: string[];
 }
 /** A curated action the VS Code extension can surface for a provider. */
-export interface ToolingProviderAction {
+export interface ToolchainProviderAction {
   /** Stable id, unique within the provider. */
   id: string;
   /** Menu label. */
@@ -41,7 +41,7 @@ export interface ToolingProviderAction {
   group?: string;
 }
 /** A provider descriptor consumed by the CLI + the VS Code extension. */
-export interface ToolingProvider {
+export interface ToolchainProvider {
   /** Stable id, eg. `vite-plus`. */
   id: string;
   /** Display name, eg. `Vite+`. */
@@ -53,14 +53,14 @@ export interface ToolingProvider {
   /** The external binary the provider wraps, eg. `vp`. */
   binary?: string;
   /** The commands the provider contributes to the CLI. */
-  commands: ToolingProviderCommand[];
+  commands: ToolchainProviderCommand[];
   /** Curated actions for the extension (defaults to one per command). */
-  actions?: ToolingProviderAction[];
+  actions?: ToolchainProviderAction[];
 }
 /**
  * Derive the default actions (one per command) for a provider that does not
  * declare its own. This keeps a provider descriptor minimal while still giving
  * the extension something to render.
  */
-export declare function providerActions(provider: ToolingProvider): ToolingProviderAction[];
+export declare function providerActions(provider: ToolchainProvider): ToolchainProviderAction[];
 //#endregion

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

@@ -2,7 +2,24 @@ import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
 import { ChildProcess, SpawnOptions } from "node:child_process";
 //#region packages/shared/src/run.d.ts
-export interface RunOptions extends SpawnOptions {
+/**
+ * Kill a child process **and its descendants**. On Windows the child is a
+ * `cmd.exe` wrapper, so a plain `child.kill()` would orphan the real command;
+ * `taskkill /t` tears down the whole tree. On POSIX the child is killed directly.
+ */
+export declare function killProcessTree(child: ChildProcess, signal?: NodeJS.Signals): void;
+/** {@link spawnCross} options: {@link SpawnOptions} plus an optional deadline. */
+export interface SpawnCrossOptions extends SpawnOptions {
+  /**
+   * Kill the child (and its tree) after this many ms. Use it for one-shot
+   * commands so a hung child can never be left running; omit it for
+   * long-running processes (dev servers, watchers).
+   */
+  timeoutMs?: number;
+  /** Called instead of the default warning when the deadline is hit. */
+  onTimeout?: (cmd: string, timeoutMs: number) => void;
+}
+export interface RunOptions extends SpawnCrossOptions {
   /** Exit the main process with the child's exit code (default true). */
   exitWithMainProc?: boolean;
   /** Append a trailing `--` to the args (default true). */
@@ -15,8 +32,11 @@ export interface RunOptions extends SpawnOptions {
  * child process. On Windows the command and every argument are escaped for
  * `cmd.exe` (and a `.cmd`/`.bat` shim is re-escaped) so a caller-supplied argv
  * value can never inject a command. `options.stdio` defaults to `inherit`.
+ *
+ * When `timeoutMs` is set the child's whole process tree is killed once the
+ * deadline passes (with a warning), so a stalled command can't hang forever.
  */
-export declare function spawnCross(cmd: string, args: string[], options?: SpawnOptions): ChildProcess;
+export declare function spawnCross(cmd: string, args: string[], options?: SpawnCrossOptions): ChildProcess;
 /**
  * Spawn a command without a shell in a cross-platform safe way. On Windows the
  * command and every argument are escaped for `cmd.exe` so a caller-supplied

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

@@ -1 +1 @@
-import{default as e}from"node:path";import"node:url";import.meta.url;import{logger as t}from"./logger.js";import n from"node:fs";import{spawn as r}from"node:child_process";const i=process.platform===`win32`,a=/([()\][%!^"`<>&|;, *?])/g;function o(e){return e.replace(a,`^$1`)}function s(e,t){let n=String(e);return n=n.replace(/(?=(\\+?)?)\1"/g,`$1$1\\"`),n=n.replace(/(?=(\\+?)?)\1$/,`$1$1`),n=`"${n}"`,n=n.replace(a,`^$1`),t&&(n=n.replace(a,`^$1`)),n}function c(t){if(e.extname(t))return n.existsSync(t)?t:void 0;let r=(process.env.PATHEXT??`.COM;.EXE;.BAT;.CMD`).split(`;`),i=(process.env.PATH??``).split(e.delimiter);for(let a of r)for(let r of i){let i=e.join(r,`${t}${a.toLowerCase()}`);if(n.existsSync(i))return i}}function l(e){let t=c(e)??e;return/\.(cmd|bat)$/i.test(t)}function u(e,t,n={}){if(i){let i=l(e),a=[o(e),...t.map(e=>s(e,i))].join(` `);return r(process.env.ComSpec??`cmd.exe`,[`/d`,`/s`,`/c`,`"${a}"`],{stdio:`inherit`,...n,shell:!1,windowsVerbatimArguments:!0})}return r(e,t,{stdio:`inherit`,...n,shell:!1})}function d(e,n,r){let{exitWithMainProc:i=!0,argsEndingDashes:a=!0,verbose:o=!0,...s}=r??{},c=[...n,...a?[`--`]:[]];o&&t.info(`$ ${e} ${c.join(` `)}`);let l=u(e,c,s);return i&&l.on(`exit`,process.exit),l}export{d as run,u as spawnCross};
+import{default as e}from"node:path";import"node:url";import.meta.url;import{logger as t}from"./logger.js";import n from"node:fs";import{spawn as r,spawnSync as i}from"node:child_process";const a=process.platform===`win32`;let o=!1;const s=/([()\][%!^"`<>&|;, *?])/g;function c(e){return e.replace(s,`^$1`)}function l(e,t){let n=String(e);return n=n.replace(/(?=(\\+?)?)\1"/g,`$1$1\\"`),n=n.replace(/(?=(\\+?)?)\1$/,`$1$1`),n=`"${n}"`,n=n.replace(s,`^$1`),t&&(n=n.replace(s,`^$1`)),n}function u(t){if(e.extname(t))return n.existsSync(t)?t:void 0;let r=(process.env.PATHEXT??`.COM;.EXE;.BAT;.CMD`).split(`;`),i=(process.env.PATH??``).split(e.delimiter);for(let a of r)for(let r of i){let i=e.join(r,`${t}${a.toLowerCase()}`);if(n.existsSync(i))return i}}function d(e){let t=u(e)??e;return/\.(cmd|bat)$/i.test(t)}function f(e,t=`SIGKILL`){let n=e.pid;if(n!==void 0){if(a)try{i(`taskkill`,[`/pid`,String(n),`/t`,`/f`],{stdio:`ignore`});return}catch{}try{e.kill(t)}catch{}}}function p(e,n,i={}){let{timeoutMs:s,onTimeout:u,...p}=i,m;if(a){let i=d(e),a=[c(e),...n.map(e=>l(e,i))].join(` `),s=process.env.ComSpec;!s&&!o&&(o=!0,t.warn(`ComSpec is not set — falling back to cmd.exe.`)),m=r(s??`cmd.exe`,[`/d`,`/s`,`/c`,`"${a}"`],{stdio:`inherit`,...p,shell:!1,windowsVerbatimArguments:!0})}else m=r(e,n,{stdio:`inherit`,...p,shell:!1});if(s!==void 0&&s>0){let n=setTimeout(()=>{u?u(e,s):t.warn(`\`${e}\` exceeded ${s}ms — terminating it.`),f(m)},s);n.unref?.(),m.once(`exit`,()=>clearTimeout(n))}return m}function m(e,n,r){let{exitWithMainProc:i=!0,argsEndingDashes:a=!0,verbose:o=!0,timeoutMs:s,...c}=r??{},l=[...n,...a?[`--`]:[]];o&&t.info(`$ ${e} ${l.join(` `)}`);let u=p(e,l,{...c,...s===void 0?{}:{timeoutMs:s}});return i&&u.on(`exit`,process.exit),u}export{f as killProcessTree,m as run,p as spawnCross};

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

@@ -1,11 +1,11 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
 import { Replacements } from "./template.js";
-import { ChangelogWorkflowsConfig, DbxConfigSections, ProjectType, ToolingBiomeConfig, ToolingChangelogConfig, ToolingConfigSections, ToolingLoggerConfig, ToolingProjectConfig, ToolingProvidersConfig, ToolingTemplateKind, ToolingTemplateSource, ToolingTemplateSourceType, ToolingTemplatesConfig, ToolingTsconfigConfig, ToolingViteConfig, ToolingWatchConfig, WorkflowConfig, WorkflowSetting, WorkflowStep, WorkflowStepsConfig } from "./config-types.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 { CONFIG_SECTION_DESCRIPTIONS, CONFIG_SECTION_SCHEMAS, CONFIG_TYPE_SCHEMAS, biomeConfigSchema, changelogConfigSchema, changelogWorkflowsConfigSchema, dbxConfigSchema, loggerConfigSchema, projectConfigSchema, projectTypeSchema, providersConfigSchema, templateKindSchema, templateSourceSchema, templateSourceTypeSchema, templatesConfigSchema, toolingConfigSchema, tsconfigConfigSchema, viteConfigSchema, watchConfigSchema, workflowConfigSchema, workflowSettingSchema, workflowStepSchema, workflowStepsConfigSchema } from "./config-schema.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";
 //#region packages/shared/src/toolchain.d.ts
-/** A summary of a sync run, handed to {@link ToolingHooks.afterSync}. */
+/** A summary of a sync run, handed to {@link ToolchainHooks.afterSync}. */
 export interface SyncSummary {
   written: string[];
   changed: string[];
@@ -16,11 +16,11 @@ export interface SyncSummary {
  * Lifecycle hooks, declared as functions in `dbx.config.ts` (so they only work
  * from a `.ts`/`.js` config, not JSON). Return values are awaited.
  */
-export interface ToolingHooks {
+export interface ToolchainHooks {
   /** Runs after the config is loaded + tokens resolved. */
   afterLoad?: (info: {
     cwd: string;
-    config: ToolingConfig;
+    config: ToolchainConfig;
     tokens: Replacements;
     path?: string;
   }) => Awaitable<void>;
@@ -40,7 +40,7 @@ export interface ToolingHooks {
   /** Runs once after the sync tasks with the result summary. */
   afterSync?: (info: {
     cwd: string;
-    config: ToolingConfig;
+    config: ToolchainConfig;
     result: SyncSummary;
   }) => Awaitable<void>;
   /** Runs on every watch-triggered change. */
@@ -56,8 +56,8 @@ export interface ToolingHooks {
  * section to enable it; omit it to leave that area untouched. Within a defined
  * section, `enabled: false` disables it explicitly.
  */
-export type ToolingConfig = ToolingConfigSections & {
-  hooks?: ToolingHooks;
+export type ToolchainConfig = ToolchainConfigSections & {
+  hooks?: ToolchainHooks;
 };
 /**
  * The root shape of a `dbx.config.*` file. The `@deltabox/toolchain` settings
@@ -65,7 +65,7 @@ export type ToolingConfig = ToolingConfigSections & {
  * alongside it.
  */
 export interface DbxConfig {
-  toolchain?: ToolingConfig;
+  toolchain?: ToolchainConfig;
 }
 /**
  * Identity helper that gives a config file full type-checking + autocomplete.
@@ -76,7 +76,7 @@ export declare function defineConfig(config: DbxConfig): DbxConfig;
  * A config section that is enabled with `true`, disabled with `false`, or
  * configured with an options object.
  */
-export type ToolingSection<T> = boolean | T;
+export type ToolchainSection<T> = boolean | T;
 /**
  * Whether an optional top-level config section is enabled.
  *
@@ -86,24 +86,22 @@ export type ToolingSection<T> = boolean | T;
  * no options, or configure it with an object (`biome: { overrides: { ... } }`).
  * Either way the tooling never touches an area the consumer did not ask for.
  */
-export declare function sectionEnabled(section: ToolingSection<{
-  enabled?: boolean;
-}> | undefined): boolean;
+export declare function sectionEnabled(section: boolean | object | undefined): boolean;
 /**
  * The options object for a section (`undefined` when it is a boolean/absent).
  * Not every section declares `enabled` (eg. `providers`), so the constraint is
  * any object rather than `{ enabled?: boolean }`.
  */
-export declare function sectionConfig<T extends object>(section: ToolingSection<T> | undefined): T | undefined;
+export declare function sectionConfig<T extends object>(section: ToolchainSection<T> | undefined): T | undefined;
 /** The file names a config loader looks for, in priority order. */
 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;
 /**
- * Flatten a {@link ToolingConfig} into the `{{ token }}` replacements every
+ * Flatten a {@link ToolchainConfig} into the `{{ token }}` replacements every
  * template understands. Defaults are chosen so a bare config still renders.
  */
-export declare function resolveTokens(config?: ToolingConfig): Replacements;
+export declare function resolveTokens(config?: ToolchainConfig): Replacements;
 /** A file written by a sync task (its parent directory is created as needed). */
 export interface ManagedFile {
   /** Path relative to the project root. */
@@ -123,7 +121,7 @@ export interface SyncContext {
   /** The detected/configured project kind. */
   projectType: ProjectType;
   /** The loaded config. */
-  config: ToolingConfig;
+  config: ToolchainConfig;
   /** The resolved replacement tokens. */
   tokens: Replacements;
   /** Log a line (respects `--quiet`). */
@@ -146,7 +144,7 @@ export interface SyncTask {
    */
   keep?: string[];
   /** Whether the task runs for the given config (default: always). */
-  enabled?: (config: ToolingConfig) => boolean;
+  enabled?: (config: ToolchainConfig) => boolean;
   /**
    * The project kinds the task applies to (default: all). A task is skipped
    * when the resolved project type is not in this list.
@@ -159,4 +157,4 @@ export interface SyncTask {
   run: (ctx: SyncContext) => Awaitable<ManagedFile[] | void>;
 }
 //#endregion
-export { CONFIG_SECTION_DESCRIPTIONS, CONFIG_SECTION_SCHEMAS, CONFIG_TYPE_SCHEMAS, ChangelogWorkflowsConfig, DbxConfigSections, ProjectType, ToolingBiomeConfig, ToolingChangelogConfig, ToolingConfigSections, ToolingLoggerConfig, ToolingProjectConfig, ToolingProvidersConfig, ToolingTemplateKind, ToolingTemplateSource, ToolingTemplateSourceType, ToolingTemplatesConfig, ToolingTsconfigConfig, ToolingViteConfig, ToolingWatchConfig, WorkflowConfig, WorkflowSetting, WorkflowStep, WorkflowStepsConfig, biomeConfigSchema, changelogConfigSchema, changelogWorkflowsConfigSchema, dbxConfigSchema, loggerConfigSchema, projectConfigSchema, projectTypeSchema, providersConfigSchema, templateKindSchema, templateSourceSchema, templateSourceTypeSchema, templatesConfigSchema, toolingConfigSchema, tsconfigConfigSchema, viteConfigSchema, watchConfigSchema, workflowConfigSchema, workflowSettingSchema, workflowStepSchema, workflowStepsConfigSchema };
+export { CONFIG_SECTION_DESCRIPTIONS, CONFIG_SECTION_SCHEMAS, CONFIG_TYPE_SCHEMAS, ChangelogVersioning, ChangelogVersioningConfig, ChangelogVersioningTarget, ChangelogWorkflowsConfig, DbxConfigSections, ProjectType, ToolchainBiomeConfig, ToolchainChangelogConfig, ToolchainConfigSections, ToolchainLoggerConfig, ToolchainProjectConfig, ToolchainProvidersConfig, ToolchainTemplateKind, ToolchainTemplateSource, ToolchainTemplateSourceType, ToolchainTemplatesConfig, ToolchainTsconfigConfig, ToolchainViteConfig, ToolchainWatchConfig, WorkflowConfig, WorkflowSetting, WorkflowStep, WorkflowStepsConfig, biomeConfigSchema, changelogConfigSchema, changelogVersioningConfigSchema, changelogVersioningSchema, changelogVersioningTargetSchema, changelogWorkflowsConfigSchema, dbxConfigSchema, loggerConfigSchema, projectConfigSchema, projectTypeSchema, providersConfigSchema, templateKindSchema, templateSourceSchema, templateSourceTypeSchema, templatesConfigSchema, toolchainConfigSchema, tsconfigConfigSchema, viteConfigSchema, watchConfigSchema, workflowConfigSchema, workflowSettingSchema, workflowStepSchema, workflowStepsConfigSchema };

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,changelogWorkflowsConfigSchema as a,dbxConfigSchema as o,loggerConfigSchema as s,projectConfigSchema as c,projectTypeSchema as l,providersConfigSchema as u,templateKindSchema as d,templateSourceSchema as f,templateSourceTypeSchema as p,templatesConfigSchema as m,toolingConfigSchema as h,tsconfigConfigSchema as g,viteConfigSchema as _,watchConfigSchema as v,workflowConfigSchema as y,workflowSettingSchema as b,workflowStepSchema as x,workflowStepsConfigSchema as S}from"./config-schema.js";function C(e){return e}function w(e){return e===void 0?!1:typeof e==`boolean`?e:e.enabled!==!1}function T(e){return e!==void 0&&typeof e==`object`?e:void 0}const E=[`dbx.config.ts`,`dbx.config.mts`,`dbx.config.js`,`dbx.config.mjs`,`dbx.config.cjs`,`dbx.config.json`];function D(e){if(!e)return;let t=e.match(/github\.com[/:]([^/]+)\/([^/.]+?)(?:\.git)?$/);return t?.[1]&&t[2]?`${t[1]}/${t[2]}`:void 0}function O(e={}){let t=e.project??{},n=T(e.changelog)??{};return{name:t.name??`app`,scope:t.scope??``,author:t.author??``,license:t.license??`MIT`,homepage:t.homepage??``,repo:t.repo??``,repoSlug:D(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{E 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 changelogWorkflowsConfigSchema,o as dbxConfigSchema,C as defineConfig,s as loggerConfigSchema,c as projectConfigSchema,l as projectTypeSchema,u as providersConfigSchema,D as repoSlugFromUrl,O as resolveTokens,T as sectionConfig,w as sectionEnabled,d as templateKindSchema,f as templateSourceSchema,p as templateSourceTypeSchema,m as templatesConfigSchema,h as toolingConfigSchema,g as tsconfigConfigSchema,_ as viteConfigSchema,v as watchConfigSchema,y as workflowConfigSchema,b as workflowSettingSchema,x as workflowStepSchema,S 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={}){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};

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

@@ -2,7 +2,7 @@ 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 { ToolingConfig } from "./toolchain.js";
+import { 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>;
@@ -16,7 +16,7 @@ export type JsonValue = string | number | boolean | null | JsonValue[] | {
   [key: string]: JsonValue;
 };
 /** A CLI option a tooling command exposes (framework-agnostic). */
-export interface ToolingOption {
+export interface ToolchainOption {
   /** Commander-style flags, eg. `-o, --out <path>`. */
   flags: string;
   /** Human-readable description. */
@@ -29,20 +29,20 @@ export interface ToolingOption {
  * `dbx.config.*` has been loaded, so a command can derive its defaults
  * from the config; explicit CLI flags override those defaults.
  */
-export interface ToolingCommandContext {
+export interface ToolchainCommandContext {
   /** The project root the config was loaded from. */
   cwd: string;
   /** The detected/configured project kind. */
   projectType: ProjectType;
   /** The loaded tooling config (empty object when none was found). */
-  config: ToolingConfig;
+  config: ToolchainConfig;
   /** The resolved replacement tokens. */
   tokens: Replacements;
   /** The config file that was loaded, if any. */
   configPath?: string;
 }
 /** A positional argument a command accepts. */
-export interface ToolingArgument {
+export interface ToolchainArgument {
   /** The argument name (also its key in the run `args` object). */
   name: string;
   /** Human-readable description. */
@@ -59,15 +59,15 @@ export interface ToolingArgument {
  * the flags explicitly passed on the command line (so config defaults apply
  * otherwise); `context` carries the loaded config.
  */
-export interface ToolingCommand<Args extends Record<string, unknown> = Record<string, unknown>> {
+export interface ToolchainCommand<Args extends Record<string, unknown> = Record<string, unknown>> {
   /** The command name, eg. `config` or `generate`. */
   name: string;
   /** Human-readable description. */
   description: string;
   /** Positional arguments the command accepts. */
-  args?: ToolingArgument[];
+  args?: ToolchainArgument[];
   /** Options the command accepts. */
-  options?: ToolingOption[];
+  options?: ToolchainOption[];
   /**
    * Forward every operand (including unknown flags) to the command instead of
    * parsing them. Used by provider passthrough commands (eg. `vite:dev`), which
@@ -76,7 +76,7 @@ export interface ToolingCommand<Args extends Record<string, unknown> = Record<st
    */
   passthrough?: boolean;
   /** Run the command with the CLI-provided options + the loaded config. */
-  run: (args: Args, context: ToolingCommandContext) => Awaitable<void>;
+  run: (args: Args, context: ToolchainCommandContext) => Awaitable<void>;
 }
 /** A package.json-shaped object (loose; only the fields the tooling touches). */
 export interface PackageJson {

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

@@ -1,8 +1,8 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
-import { ToolingCommand } from "../../../shared/src/types.js";
+import { ToolchainCommand } from "../../../shared/src/types.js";
 import "../../../shared/src/index.js";
 //#region packages/template/src/cli/index.d.ts
 /** The `template:*` commands plus the template-driven `create`. */
-export declare function templateCommands(): ToolingCommand[];
+export declare function templateCommands(): ToolchainCommand[];
 //#endregion

package/dist/packages/template/src/cli/index.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{TEMPLATE_MANIFEST as n,writeTemplateManifest as r}from"../local.js";import{parseSourceSpec as i}from"../online.js";import{addTemplateSource as a,loadTemplates as o,readTemplateRegistry as s,removeTemplateSource as c}from"../registry.js";import{scaffoldTemplate as l}from"../scaffold.js";import u from"node:fs";const d={flags:`--cwd <dir>`,description:`Project root (default: cwd).`},f={flags:`--kind <kind>`,description:`project | workspace | application | folder | tooling | pipeline.`};function p(e){return{id:e.id,name:e.name,...e.description?{description:e.description}:{},kind:e.kind,type:e.source.type,online:!!e.online,...e.tags?{tags:e.tags}:{},...e.variables?{variables:e.variables}:{}}}function m(e){let t={};for(let n of e??[]){let e=n.indexOf(`=`);e!==-1&&(t[n.slice(0,e)]=n.slice(e+1))}return t}function h(e){return(e??[]).map(e=>{let t=e.indexOf(`:`);return t===-1?{name:e}:{name:e.slice(0,t),default:e.slice(t+1)}})}function g(){return[{name:`template:list`,description:`List templates (builtin + local + opted-in online sources).`,options:[d,{flags:`--online`,description:`Resolve online sources (npm/git).`},{flags:`--offline`,description:`Force offline (skip npm/git).`},f,{flags:`--registry`,description:`List only the .dbx/toolchain/templates.json sources.`},{flags:`--json`,description:`Print the templates as JSON.`}],run:async(e,n)=>{let r=e.cwd??n.cwd;if(e.registry){let n=s(r).sources;if(e.json){t.raw(JSON.stringify(n.map(e=>({key:`${e.type}:${e.locate}`,...e})),null,4));return}if(n.length===0){t.info(`the template registry is empty.`);return}for(let e of n)t.info(`  ${`${e.type}:${e.locate}`.padEnd(40)} ${e.name??e.id??``}`);return}let i=!!e.online&&!e.offline,a=await o({cwd:r,config:n.config,online:i}),c=e.kind,l=c?a.filter(e=>e.kind===c):a;if(e.json)t.raw(JSON.stringify(l.map(p),null,4));else if(l.length===0)t.info(`no templates found.`);else for(let e of l){let n=[e.kind,e.source.type,e.online?`online`:`offline`].join(`, `);t.info(`  ${e.id.padEnd(24)} ${e.name}  [${n}]${e.description?`\n    ${e.description}`:``}`)}}},{name:`template:init`,description:`Write a template.json to a directory, making it a local template.`,args:[{name:`dir`,description:`Directory (default: cwd).`,required:!1}],options:[d,f,{flags:`--name <name>`,description:`Display name (default: folder name).`},{flags:`--description <text>`,description:`Description.`},{flags:`--var <pair...>`,description:`Variable name[:default] (repeatable).`},{flags:`--tag <tag...>`,description:`Tag (repeatable).`},{flags:`--force`,description:`Overwrite an existing template.json.`},{flags:`--add`,description:`Also record the folder in .dbx/toolchain/templates.json.`},{flags:`--json`,description:`Print the manifest as JSON.`}],run:(i,o)=>{let s=e.resolve(o.cwd,String(i.dir??`.`)),c=e.join(s,n);if(u.existsSync(c)&&!i.force)throw Error(`template.json already exists at ${c} (use --force).`);let l=h(i.var),d={name:String(i.name??e.basename(s)),kind:i.kind??`folder`,...i.description?{description:String(i.description)}:{},...l.length?{variables:l}:{},...i.tag?{tags:i.tag}:{}};r(s,d),i.add&&a(o.cwd,{type:`local`,locate:s,kind:d.kind}),i.json?t.raw(JSON.stringify(d,null,4)):(t.info(`wrote ${c}`),i.add&&t.info(`registered the folder as a template.`))}},{name:`template:add`,description:`Record a template source in .dbx/toolchain/templates.json.`,args:[{name:`source`,description:`local path | git URL | @scope/create | type:locate`}],options:[d,{flags:`--type <type>`,description:`Force: builtin | local | npm | git | vite-plus.`},{flags:`--name <name>`,description:`Display name.`},f,{flags:`--ref <ref>`,description:`Git branch/tag/commit.`},{flags:`--subdir <dir>`,description:`Subdirectory within the source.`},{flags:`--json`,description:`Print the updated registry as JSON.`}],run:(n,o)=>{let s=i(String(n.source),o.cwd);n.type&&(s.type=n.type),n.name&&(s.name=String(n.name)),n.kind&&(s.kind=n.kind),n.ref&&(s.ref=String(n.ref)),n.subdir&&(s.subdir=String(n.subdir)),s.type===`local`&&!u.existsSync(e.join(s.locate,`template.json`))&&r(s.locate,{name:s.name??e.basename(s.locate),kind:n.kind??`folder`});let c=a(o.cwd,s);n.json?t.raw(JSON.stringify(c,null,4)):t.info(`added ${s.type}:${s.locate} (${c.sources.length} source(s)).`)}},{name:`template:remove`,description:`Remove a source from .dbx/toolchain/templates.json.`,args:[{name:`id`,description:`Source id or type:locate.`}],options:[d,{flags:`--json`,description:`Print the registry as JSON.`}],run:(e,n)=>{let{registry:r,removed:i}=c(n.cwd,String(e.id));e.json?t.raw(JSON.stringify(r,null,4)):i===0?(t.error(`no source matching "${e.id}".`),process.exitCode=1):t.info(`removed ${i} source(s) (${r.sources.length} left).`)}},{name:`template:info`,description:`Show one template by id.`,args:[{name:`id`,description:`The template id.`}],options:[d,{flags:`--online`,description:`Resolve online sources.`}],run:async(e,n)=>{let r=e.cwd??n.cwd,i=(await o({cwd:r,config:n.config,online:!!e.online})).find(t=>t.id===e.id);i?t.raw(JSON.stringify(p(i),null,4)):(t.error(`unknown template "${e.id}".`),process.exitCode=1)}},{name:`create`,description:`Scaffold a project from a template (builtin, local or Vite+).`,options:[{flags:`-t, --template <id>`,description:`Template id (see template:list).`},f,{flags:`-n, --name <name>`,description:`Project / package name.`},{flags:`-s, --scope <scope>`,description:`npm scope, eg. @acme.`},{flags:`-o, --out <dir>`,description:`Output directory (default: cwd).`},d,{flags:`--var <pair...>`,description:`Template variables as key=value (repeatable).`},{flags:`--online`,description:`Resolve online templates too.`},{flags:`--json`,description:`Print the result as JSON.`}],run:async(e,n)=>{let r=e.out??n.cwd,i=String(e.template??``),a=e.kind,s=await o({cwd:n.cwd,config:n.config,online:!0}),c=s.find(e=>e.id===i);if(!c&&!i&&a&&(c=s.find(e=>e.kind===a)),!c&&i&&(c={id:i,name:i,kind:a??`project`,source:{type:`vite-plus`,locate:i},online:!0}),!c)throw Error("No template selected. Pass --template <id> or --kind <kind> (see `dbx template:list`).");let u={...n.config.project,name:e.name??n.config.project?.name??`app`,...e.scope?{scope:e.scope}:{}},d=m(e.var),f=await l(c,{cwd:r,tokens:u,variables:d});if(e.json)t.raw(JSON.stringify({template:c.id,out:r,...f},null,4));else if(c.source.type===`vite-plus`||c.source.type===`npm`||c.source.type===`git`)f.code&&(process.exitCode=f.code);else for(let e of f.written)t.info(`Created ${e}`)}}]}export{g as templateCommands};
+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{TEMPLATE_MANIFEST as n,writeTemplateManifest as r}from"../local.js";import{parseSourceSpec as i}from"../online.js";import{addTemplateSource as a,loadTemplates as o,readTemplateRegistry as s,removeTemplateSource as c}from"../registry.js";import{scaffoldTemplate as l}from"../scaffold.js";import u from"node:fs";import{cancel as d,isCancel as f,select as p,text as m}from"@clack/prompts";const h={flags:`--cwd <dir>`,description:`Project root (default: cwd).`},g={flags:`--kind <kind>`,description:`project | workspace | application | folder | tooling | pipeline.`};function _(e){return{id:e.id,name:e.name,...e.description?{description:e.description}:{},kind:e.kind,type:e.source.type,online:!!e.online,...e.tags?{tags:e.tags}:{},...e.variables?{variables:e.variables}:{}}}function v(e){let t={};for(let n of e??[]){let e=n.indexOf(`=`);e!==-1&&(t[n.slice(0,e)]=n.slice(e+1))}return t}function y(e){return(e??[]).map(e=>{let t=e.indexOf(`:`);return t===-1?{name:e}:{name:e.slice(0,t),default:e.slice(t+1)}})}function b(e){return!!(process.stdin.isTTY&&process.stdout.isTTY)&&e.json!==!0}function x(){d(`Cancelled.`),process.exitCode=1}function S(){return[{name:`template:list`,description:`List templates (builtin + local + opted-in online sources).`,options:[h,{flags:`--online`,description:`Resolve online sources (npm/git).`},{flags:`--offline`,description:`Force offline (skip npm/git).`},g,{flags:`--registry`,description:`List only the .dbx/toolchain/templates.json sources.`},{flags:`--json`,description:`Print the templates as JSON.`}],run:async(e,n)=>{let r=e.cwd??n.cwd;if(e.registry){let n=s(r).sources;if(e.json){t.raw(JSON.stringify(n.map(e=>({key:`${e.type}:${e.locate}`,...e})),null,4));return}if(n.length===0){t.info(`the template registry is empty.`);return}for(let e of n)t.info(`  ${`${e.type}:${e.locate}`.padEnd(40)} ${e.name??e.id??``}`);return}let i=!!e.online&&!e.offline,a=await o({cwd:r,config:n.config,online:i}),c=e.kind,l=c?a.filter(e=>e.kind===c):a;if(e.json)t.raw(JSON.stringify(l.map(_),null,4));else if(l.length===0)t.info(`no templates found.`);else for(let e of l){let n=[e.kind,e.source.type,e.online?`online`:`offline`].join(`, `);t.info(`  ${e.id.padEnd(24)} ${e.name}  [${n}]${e.description?`\n    ${e.description}`:``}`)}}},{name:`template:init`,description:`Write a template.json to a directory, making it a local template.`,args:[{name:`dir`,description:`Directory (default: cwd).`,required:!1}],options:[h,g,{flags:`--name <name>`,description:`Display name (default: folder name).`},{flags:`--description <text>`,description:`Description.`},{flags:`--var <pair...>`,description:`Variable name[:default] (repeatable).`},{flags:`--tag <tag...>`,description:`Tag (repeatable).`},{flags:`--force`,description:`Overwrite an existing template.json.`},{flags:`--add`,description:`Also record the folder in .dbx/toolchain/templates.json.`},{flags:`--json`,description:`Print the manifest as JSON.`}],run:(i,o)=>{let s=e.resolve(o.cwd,String(i.dir??`.`)),c=e.join(s,n);if(u.existsSync(c)&&!i.force)throw Error(`template.json already exists at ${c} (use --force).`);let l=y(i.var),d={name:String(i.name??e.basename(s)),kind:i.kind??`folder`,...i.description?{description:String(i.description)}:{},...l.length?{variables:l}:{},...i.tag?{tags:i.tag}:{}};r(s,d),i.add&&a(o.cwd,{type:`local`,locate:s,kind:d.kind}),i.json?t.raw(JSON.stringify(d,null,4)):(t.info(`wrote ${c}`),i.add&&t.info(`registered the folder as a template.`))}},{name:`template:add`,description:`Record a template source in .dbx/toolchain/templates.json.`,args:[{name:`source`,description:`local path | git URL | @scope/create | type:locate`}],options:[h,{flags:`--type <type>`,description:`Force: builtin | local | npm | git | vite-plus.`},{flags:`--name <name>`,description:`Display name.`},g,{flags:`--ref <ref>`,description:`Git branch/tag/commit.`},{flags:`--subdir <dir>`,description:`Subdirectory within the source.`},{flags:`--json`,description:`Print the updated registry as JSON.`}],run:(n,o)=>{let s=i(String(n.source),o.cwd);n.type&&(s.type=n.type),n.name&&(s.name=String(n.name)),n.kind&&(s.kind=n.kind),n.ref&&(s.ref=String(n.ref)),n.subdir&&(s.subdir=String(n.subdir)),s.type===`local`&&!u.existsSync(e.join(s.locate,`template.json`))&&r(s.locate,{name:s.name??e.basename(s.locate),kind:n.kind??`folder`});let c=a(o.cwd,s);n.json?t.raw(JSON.stringify(c,null,4)):t.info(`added ${s.type}:${s.locate} (${c.sources.length} source(s)).`)}},{name:`template:remove`,description:`Remove a source from .dbx/toolchain/templates.json.`,args:[{name:`id`,description:`Source id or type:locate.`}],options:[h,{flags:`--json`,description:`Print the registry as JSON.`}],run:(e,n)=>{let{registry:r,removed:i}=c(n.cwd,String(e.id));e.json?t.raw(JSON.stringify(r,null,4)):i===0?(t.error(`no source matching "${e.id}".`),process.exitCode=1):t.info(`removed ${i} source(s) (${r.sources.length} left).`)}},{name:`template:info`,description:`Show one template by id.`,args:[{name:`id`,description:`The template id.`}],options:[h,{flags:`--online`,description:`Resolve online sources.`}],run:async(e,n)=>{let r=e.cwd??n.cwd,i=(await o({cwd:r,config:n.config,online:!!e.online})).find(t=>t.id===e.id);i?t.raw(JSON.stringify(_(i),null,4)):(t.error(`unknown template "${e.id}".`),process.exitCode=1)}},{name:`create`,description:`Scaffold a project from a template (builtin, local or Vite+).`,options:[{flags:`-t, --template <id>`,description:`Template id (see template:list).`},g,{flags:`-n, --name <name>`,description:`Project / package name.`},{flags:`-s, --scope <scope>`,description:`npm scope, eg. @acme.`},{flags:`-o, --out <dir>`,description:`Output directory (default: cwd).`},h,{flags:`--var <pair...>`,description:`Template variables as key=value (repeatable).`},{flags:`--online`,description:`Resolve online templates too.`},{flags:`--json`,description:`Print the result as JSON.`}],run:async(e,n)=>{let r=e.out??n.cwd,i=e.kind,a=await o({cwd:n.cwd,config:n.config,online:!0}),s=b(e),c=String(e.template??``),u=e.name,d=e.scope;if(s&&!c&&!i){if(a.length===0)throw Error("No templates available. Pass --template <id> (see `dbx template:list`).");let e=await p({message:`Pick a template`,options:a.map(e=>({value:e.id,label:e.name,...e.description?{hint:e.description}:{}}))});if(f(e))return x();c=String(e)}if(s&&!u){let e=await m({message:`Project name`,placeholder:n.config.project?.name??`app`,defaultValue:n.config.project?.name??`app`});if(f(e))return x();u=String(e)}if(s&&!d){let e=await m({message:`npm scope (optional)`,placeholder:n.config.project?.scope??`@${u??`app`}`});if(f(e))return x();d=String(e)||void 0}let h=a.find(e=>e.id===c);if(!h&&!c&&i&&(h=a.find(e=>e.kind===i)),!h&&c&&(h={id:c,name:c,kind:i??`project`,source:{type:`vite-plus`,locate:c},online:!0}),!h)throw Error("No template selected. Pass --template <id> or --kind <kind> (see `dbx template:list`).");let g={...n.config.project,name:u??n.config.project?.name??`app`,...d?{scope:d}:{}},_=v(e.var),y=await l(h,{cwd:r,tokens:g,variables:_});if(e.json)t.raw(JSON.stringify({template:h.id,out:r,...y},null,4));else if(h.source.type===`vite-plus`||h.source.type===`npm`||h.source.type===`git`)y.code&&(process.exitCode=y.code);else for(let e of y.written)t.info(`Created ${e}`)}}]}export{S as templateCommands};

package/dist/packages/template/src/online.d.ts

@@ -1,17 +1,17 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
-import { ToolingTemplateSource } from "../../shared/src/config-types.js";
+import { ToolchainTemplateSource } from "../../shared/src/config-types.js";
 import "../../shared/src/index.js";
 import { Template } from "./types.js";
 //#region packages/template/src/online.d.ts
 /** List the templates an npm `@scope/create` package publishes. */
 export declare function loadNpmTemplates(pkg: string): Promise<Template[]>;
 /** A single template backed by a git repository. */
-export declare function gitTemplate(source: ToolingTemplateSource): Template;
+export declare function gitTemplate(source: ToolchainTemplateSource): Template;
 /**
  * Parse a `template:add` spec: `type:locate` (eg. `local:./tpl`, `git:https://…`,
  * `npm:@acme/create`) or an inferred source (a path that exists -> local, an
  * `@scope/name` -> npm, a URL/scp -> git).
  */
-export declare function parseSourceSpec(spec: string, cwd?: string): ToolingTemplateSource;
+export declare function parseSourceSpec(spec: string, cwd?: string): ToolchainTemplateSource;
 //#endregion

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

@@ -1,7 +1,7 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
-import { ToolingTemplateSource } from "../../shared/src/config-types.js";
-import { ToolingConfig } from "../../shared/src/toolchain.js";
+import { ToolchainTemplateSource } from "../../shared/src/config-types.js";
+import { ToolchainConfig } from "../../shared/src/toolchain.js";
 import "../../shared/src/index.js";
 import { Template } from "./types.js";
 //#region packages/template/src/registry.d.ts
@@ -10,14 +10,14 @@ export declare const REGISTRY_DIR = ".dbx/toolchain";
 export declare const REGISTRY_FILE = "templates.json";
 /** The on-disk registry of template sources. */
 export interface TemplateRegistry {
-  sources: ToolingTemplateSource[];
+  sources: ToolchainTemplateSource[];
 }
 /** Read `<cwd>/.dbx/toolchain/templates.json` (empty when missing/invalid). */
 export declare function readTemplateRegistry(cwd: string): TemplateRegistry;
 /** Write `<cwd>/.dbx/toolchain/templates.json`. */
-export declare function writeTemplateRegistry(cwd: string, sources: ToolingTemplateSource[]): void;
+export declare function writeTemplateRegistry(cwd: string, sources: ToolchainTemplateSource[]): void;
 /** Append a source to the registry, deduplicating on `type:locate`. */
-export declare function addTemplateSource(cwd: string, source: ToolingTemplateSource): TemplateRegistry;
+export declare function addTemplateSource(cwd: string, source: ToolchainTemplateSource): TemplateRegistry;
 /**
  * Remove a source from the registry by `type:locate` (or by id). Returns the
  * updated registry and how many sources were removed.
@@ -30,16 +30,16 @@ export interface LoadTemplatesOptions {
   /** Project root. */
   cwd: string;
   /** The loaded tooling config (its `templates.sources` are included). */
-  config?: ToolingConfig;
+  config?: ToolchainConfig;
   /** Resolve online sources (`npm`/`git`). Default: false. */
   online?: boolean;
   /** Include the builtin templates (default: true). */
   builtin?: boolean;
   /** Extra sources on top of the config + registry. */
-  sources?: ToolingTemplateSource[];
+  sources?: ToolchainTemplateSource[];
 }
 /** Every source considered: builtin + config `templates.sources` + registry + extras. */
-export declare function collectSources(options: LoadTemplatesOptions): ToolingTemplateSource[];
+export declare function collectSources(options: LoadTemplatesOptions): ToolchainTemplateSource[];
 /**
  * Resolve every template: builtin, local directories (offline, always), and —
  * when `online` — npm `@scope/create` manifests + git repositories.

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

@@ -1,10 +1,10 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
-import { ToolingTemplateKind, ToolingTemplateSource } from "../../shared/src/config-types.js";
+import { ToolchainTemplateKind, ToolchainTemplateSource } from "../../shared/src/config-types.js";
 import "../../shared/src/index.js";
 //#region packages/template/src/types.d.ts
 /** What a template produces (shared with the registry source model). */
-export type TemplateKind = ToolingTemplateKind;
+export type TemplateKind = ToolchainTemplateKind;
 /** A value a local template prompts for / substitutes. */
 export interface TemplateVariable {
   /** The token name (also the `{{ token }}` used in files). */
@@ -23,7 +23,7 @@ export interface Template {
   description?: string;
   kind: TemplateKind;
   /** How/where the template is loaded from. */
-  source: ToolingTemplateSource;
+  source: ToolchainTemplateSource;
   tags?: string[];
   /** Whether creating from it needs network access. */
   online?: boolean;

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

@@ -1,11 +1,11 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
-import { ToolingCommand } from "../../../shared/src/types.js";
+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.*;
  * (via the command context); any CLI flag overrides them.
  */
-export declare function tsconfigCommands(): ToolingCommand[];
+export declare function tsconfigCommands(): ToolchainCommand[];
 //#endregion