@deltabox/toolchain 1.11.4 → 2.1.0

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

@@ -0,0 +1,130 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+import { ToolchainTemplateSource } from "../../shared/src/config-types.js";
+import { RegistryPolicy } from "../../shared/src/registry-policy.js";
+import "../../shared/src/index.js";
+import { Template } from "./types.js";
+//#region packages/template/src/global.d.ts
+/** The VS Code setting that lists the template search paths. */
+export declare const VSCODE_REGISTRY_SEARCH_PATHS = "deltabox.registrySearchPaths";
+/** `~/.dbx/toolchain`. */
+export declare function globalToolchainDir(): string;
+/** `~/.dbx/toolchain/cli/config.json`. */
+export declare function cliConfigPath(): string;
+/** `~/.dbx/toolchain/.registry/templates` (the default global templates dir). */
+export declare function defaultGlobalTemplatesDir(): string;
+/** `~/.dbx/toolchain/.registry/sources.json` (non-local global sources). */
+export declare function globalSourcesPath(): string;
+/** `~/.dbx/toolchain/.registry/providers.json`. */
+export declare function globalProvidersPath(): string;
+/** The default project-scoped template registry (`<cwd>/.dbx/toolchain/.registry/templates`). */
+export declare function defaultProjectTemplatesRegistry(cwd: string): string;
+/** `<cwd>/.dbx/toolchain/registries.json` (the project-scoped search paths). */
+export declare function projectRegistriesPath(cwd: string): string;
+/** The project-scoped registry search paths. */
+export declare function readProjectRegistries(cwd: string): {
+  templates: string[];
+  providers: string[];
+};
+/** Write the project-scoped registry search paths (preserving provider paths). */
+export declare function writeProjectRegistries(cwd: string, templates: string[]): void;
+/** Add a project-scoped template registry directory (or remote URL). */
+export declare function addProjectRegistry(cwd: string, entry: string): void;
+/** Remove a project-scoped template registry directory (never the implicit default). */
+export declare function removeProjectRegistry(cwd: string, entry: string): void;
+/** The persisted CLI config (`~/.dbx/toolchain/cli/config.json`). */
+export interface GlobalCliConfig {
+  /** Template search paths (directories and/or `http(s)` registry URLs). */
+  registrySearchPaths?: string | string[];
+  /** The VS Code user directory (its `settings.json` holds the search paths). */
+  vscodeDir?: string;
+}
+/** Options that only read or write the persisted config. */
+export declare function readGlobalCliConfig(): GlobalCliConfig;
+/** Merge a patch into the persisted CLI config and return the result. */
+export declare function writeGlobalCliConfig(patch: Partial<GlobalCliConfig>): GlobalCliConfig;
+/** Expand a leading `~` to the user's home directory. */
+export declare function expandHome(value: string): string;
+/** Normalize a string-or-array path setting into an array (home-expanded). */
+export declare function normalizeSearchPaths(value: string | string[] | undefined): string[];
+/** Whether a search path is a remote registry URL. */
+export declare function isRemoteRegistry(value: string): boolean;
+/** Set a top-level JSON/JSONC key, preserving the rest of the file (incl. comments). */
+export declare function setJsoncValue(text: string, key: string, value: unknown): string;
+/** The path of the VS Code user `settings.json` for a `vscodeDir`. */
+export declare function vscodeSettingsPath(vscodeDir: string): string;
+/** Read the `deltabox.registrySearchPaths` setting from a VS Code user dir. */
+export declare function readVscodeSearchPaths(vscodeDir: string | undefined): string[];
+/**
+ * Write the `deltabox.registrySearchPaths` setting into a VS Code user dir.
+ * Best-effort JSONC edit: other settings/comments are preserved.
+ */
+export declare function writeVscodeSearchPaths(vscodeDir: string | undefined, paths: string[]): boolean;
+/** Where the resolved template search paths came from. */
+export type SearchPathSource = 'cli' | 'vscode' | 'default';
+export interface ResolvedSearchPaths {
+  /** Project + global paths in load order (project first). */
+  paths: string[];
+  /** Project-scoped registries. */
+  project: string[];
+  /** Global registries (CLI config / VS Code setting / default). */
+  global: string[];
+  source: SearchPathSource;
+  vscodeDir?: string;
+}
+/**
+ * Resolve the registry search paths: project-scoped paths first (the implicit
+ * `<cwd>/.dbx/toolchain/.registry/templates` plus `registries.json`), then the
+ * global ones (CLI config wins, then the VS Code setting, then the default).
+ */
+export declare function resolveTemplateSearchPaths(cwd?: string): ResolvedSearchPaths;
+/** A detected registry (rendered by the CLI and the VS Code Registries view). */
+export interface RegistryEntry {
+  path: string;
+  scope: 'project' | 'global';
+  remote: boolean;
+  kind: 'templates' | 'providers';
+}
+/** List the detected template and provider registries. */
+export declare function listRegistries(cwd: string): {
+  templates: RegistryEntry[];
+  providers: RegistryEntry[];
+};
+/** A unique variant of `id` (`foo-2`, `foo-3`, ...). */
+export declare function uniqueTemplateId(id: string, taken: Iterable<string>): string;
+/**
+ * Every template id that already exists: builtins, global/local templates and
+ * the ids declared by global sources. The project registry is added by the
+ * caller when it has one.
+ */
+export declare function existingTemplateIds(cwd?: string, options?: {
+  global?: boolean;
+}): Promise<Set<string>>;
+/** The non-local global sources (git/npm/http) stored in the registry. */
+export declare function readGlobalSources(): ToolchainTemplateSource[];
+/** Add/replace a non-local source in the global sources registry. */
+export declare function addGlobalSource(source: ToolchainTemplateSource): ToolchainTemplateSource[];
+/**
+ * Remove a template from the global registry: delete its stored directory and/or
+ * drop a matching global source. Returns whether anything was removed.
+ */
+export declare function removeGlobalTemplate(id: string): boolean;
+/**
+ * Store a local template directory in the first writable global directory.
+ * Returns the destination path (or the original when it is already global).
+ */
+export declare function addGlobalTemplate(dir: string, id?: string): string;
+export interface GlobalTemplates {
+  /** Templates discovered in the local search paths. */
+  templates: Template[];
+  /** Sources declared by remote (`http(s)`) registries. */
+  sources: ToolchainTemplateSource[];
+  /** The resolved search paths. */
+  paths: string[];
+}
+/**
+ * Load the global templates: local search paths are scanned for template dirs,
+ * and remote registry URLs are fetched (their `{ sources }` / array is merged).
+ */
+export declare function loadGlobalTemplates(cwd?: string, policy?: RegistryPolicy): Promise<GlobalTemplates>;
+//#endregion

package/dist/packages/template/src/global.js

@@ -0,0 +1,3 @@
+import{default as e}from"node:path";import"node:url";import.meta.url;import{registrySourceAllowed as t}from"../../shared/src/registry-policy.js";import"../../shared/src/index.js";import{providerRegistryPaths as n}from"../../core/src/provider-registry.js";import"../../core/src/index.js";import{BUILTIN_TEMPLATES as r}from"./builtin.js";import{loadLocalTemplates as i}from"./local.js";import a from"node:fs";import o from"node:os";const s=`deltabox.registrySearchPaths`;function c(){return e.join(o.homedir(),`.dbx`,`toolchain`)}function l(){return e.join(c(),`cli`,`config.json`)}function u(){return e.join(c(),`.registry`,`templates`)}function d(){return e.join(c(),`.registry`,`sources.json`)}function f(){return e.join(c(),`.registry`,`providers.json`)}function p(t){return e.join(t,`.dbx`,`toolchain`,`.registry`,`templates`)}function m(t){return e.join(t,`.dbx`,`toolchain`,`registries.json`)}function h(e){try{let t=a.readFileSync(m(e),`utf-8`).replace(/^\uFEFF/,``),n=JSON.parse(t);return{templates:Array.isArray(n.templates)?n.templates.map(String).filter(Boolean):[],providers:Array.isArray(n.providers)?n.providers.map(String).filter(Boolean):[]}}catch{return{templates:[],providers:[]}}}function g(t,n){let r=m(t),i=h(t).providers,o={...n.length>0?{templates:n}:{},...i.length>0?{providers:i}:{}};Object.keys(o).length===0?a.rmSync(r,{force:!0}):(a.mkdirSync(e.dirname(r),{recursive:!0}),a.writeFileSync(r,`${JSON.stringify(o,null,4)}\n`,`utf-8`))}function _(t,n){let r=C(n),i=r?n:e.resolve(t,x(n));r||a.mkdirSync(i,{recursive:!0});let o=h(t);o.templates.some(n=>(C(n)?n:e.resolve(t,x(n)))===i)||g(t,[...o.templates,n])}function v(t,n){let r=C(n)?n:e.resolve(t,x(n));g(t,h(t).templates.filter(n=>(C(n)?n:e.resolve(t,x(n)))!==r))}function y(){try{let e=a.readFileSync(l(),`utf-8`).replace(/^\uFEFF/,``),t=JSON.parse(e);return t&&typeof t==`object`?t:{}}catch{return{}}}function b(t){let n={...y(),...t};for(let e of Object.keys(n))n[e]===void 0&&delete n[e];let r=l();return a.mkdirSync(e.dirname(r),{recursive:!0}),a.writeFileSync(r,`${JSON.stringify(n,null,4)}\n`,`utf-8`),n}function x(t){return t===`~`?o.homedir():t.startsWith(`~/`)||t.startsWith(`~\\`)?e.join(o.homedir(),t.slice(2)):t}function S(e){return e?(Array.isArray(e)?e:[e]).map(e=>x(String(e))).filter(Boolean):[]}function C(e){return/^https?:\/\//i.test(e)}function w(e,t){let n=e.search(RegExp(`"${t.replace(/[.*+?^${}()|[\]\\]/g,`\\$&`)}"\\s*:`));if(n===-1)return;let r=e.indexOf(`:`,n);if(r===-1)return;let i=r+1;for(;i<e.length&&/\s/.test(e[i]);)i++;let a=e[i];if(a===`[`||a===`{`){let t=a===`[`?`]`:`}`,n=0;for(let r=i;r<e.length;r++)if(e[r]===a)n++;else if(e[r]===t&&(n--,n===0))return[i,r+1];return}if(a===`"`){let t=i+1;for(;t<e.length&&e[t]!==`"`;)e[t]===`\\`&&t++,t++;return[i,t+1]}let o=i;for(;o<e.length&&e[o]!==`,`&&e[o]!==`}`;)o++;for(;o>i&&/\s/.test(e[o-1]);)o--;return[i,o]}function T(e,t){let n=w(e,t);if(n)try{return JSON.parse(e.slice(n[0],n[1]))}catch{return}}function E(e,t,n){let r=JSON.stringify(n),i=w(e,t);if(i)return`${e.slice(0,i[0])}${r}${e.slice(i[1])}`;let a=e.indexOf(`{`);return a===-1?`{\n    "${t}": ${r}\n}\n`:`${e.slice(0,a+1)}\n    "${t}": ${r},${e.slice(a+1)}`}function D(t){return e.join(x(t),`settings.json`)}function O(e){if(!e)return[];try{return S(T(a.readFileSync(D(e),`utf-8`),s))}catch{return[]}}function k(t,n){if(!t||n.length===0)return!1;let r=D(t),i=``;try{i=a.readFileSync(r,`utf-8`)}catch{i=`{
+}
+`}if(JSON.stringify(T(i,`deltabox.registrySearchPaths`))===JSON.stringify(n))return!1;let o=E(i,s,n);return a.mkdirSync(e.dirname(r),{recursive:!0}),a.writeFileSync(r,o,`utf-8`),!0}function A(t){let n=[];if(t){let r=p(t);a.existsSync(r)&&n.push(r);for(let r of h(t).templates){let i=C(r)?r:e.resolve(t,x(r));n.includes(i)||n.push(i)}}let r=y(),i=r.vscodeDir?x(r.vscodeDir):void 0,o=S(r.registrySearchPaths),s,c;if(o.length>0)s=o,c=`cli`;else{let e=O(i);e.length>0?(s=e,c=`vscode`):(s=[u()],c=`default`)}return{paths:[...n,...s.filter(e=>!n.includes(e))],project:n,global:s,source:c,...i?{vscodeDir:i}:{}}}function j(e){let t=A(e);return{templates:[...t.project.map(e=>({path:e,scope:`project`,remote:C(e),kind:`templates`})),...t.global.map(e=>({path:e,scope:`global`,remote:C(e),kind:`templates`}))],providers:n(e).map(e=>({...e,kind:`providers`}))}}function M(e,t){let n=new Set(t);if(!n.has(e))return e;let r=2;for(;n.has(`${e}-${r}`);)r+=1;return`${e}-${r}`}async function N(e,t={}){let n=new Set(r.map(e=>e.id));if(t.global===!1)return n;let i=await z(e);for(let e of i.templates)n.add(e.id);for(let e of[...i.sources,...P()])e.id&&n.add(e.id);return n}function P(){try{let e=a.readFileSync(d(),`utf-8`).replace(/^\uFEFF/,``),t=JSON.parse(e),n=Array.isArray(t)?t:t.sources;return Array.isArray(n)?n:[]}catch{return[]}}function F(t){let n=e=>`${e.type}:${e.locate}`,r=P().filter(e=>n(e)!==n(t));r.push(t);let i=d();return a.mkdirSync(e.dirname(i),{recursive:!0}),a.writeFileSync(i,`${JSON.stringify({sources:r},null,4)}\n`,`utf-8`),r}function I(t){let{global:n}=A(),r=!1;for(let i of n){if(C(i))continue;let n=e.join(i,t);a.existsSync(e.join(n,`template.json`))&&(a.rmSync(n,{recursive:!0,force:!0}),r=!0)}let i=P(),o=i.filter(e=>(e.id??e.locate)!==t);if(o.length!==i.length){let e=d();o.length===0?a.rmSync(e,{force:!0}):a.writeFileSync(e,`${JSON.stringify({sources:o},null,4)}\n`,`utf-8`),r=!0}return r}const L=/* @__PURE__ */ new Set([`node_modules`,`.git`,`dist`,`.dbx`,`.turbo`,`.DS_Store`]);function R(t,n){let{paths:r}=A(),i=r.filter(e=>!C(e))[0]??u(),o=(n??e.basename(t)).replace(/[\\/]+/g,`-`),s=e.join(i,o);return e.resolve(s)===e.resolve(t)||a.existsSync(e.join(s,`template.json`))||(a.mkdirSync(i,{recursive:!0}),a.cpSync(t,s,{recursive:!0,filter:t=>!L.has(e.basename(t))})),s}async function z(n,r){let{paths:a}=A(n),o=a.filter(n=>t(C(n)?n:e.resolve(n),r)),s=[],c=P().filter(i=>t(i.type===`local`&&n?e.resolve(n,i.locate):i.locate,r));for(let a of o)if(C(a))try{let i=await fetch(a);if(!i.ok)continue;let o=await i.json(),s=Array.isArray(o)?o:o.sources??o.templates;if(Array.isArray(s))for(let i of s){if(!i||typeof i!=`object`||!(`type`in i)||!(`locate`in i))continue;let a=i;t(a.type===`local`&&n?e.resolve(n,a.locate):a.locate,r)&&c.push(a)}}catch{}else s.push(...i(a));return{templates:s,sources:c,paths:o}}export{s as VSCODE_REGISTRY_SEARCH_PATHS,F as addGlobalSource,R as addGlobalTemplate,_ as addProjectRegistry,l as cliConfigPath,u as defaultGlobalTemplatesDir,p as defaultProjectTemplatesRegistry,N as existingTemplateIds,x as expandHome,f as globalProvidersPath,d as globalSourcesPath,c as globalToolchainDir,C as isRemoteRegistry,j as listRegistries,z as loadGlobalTemplates,S as normalizeSearchPaths,m as projectRegistriesPath,y as readGlobalCliConfig,P as readGlobalSources,h as readProjectRegistries,O as readVscodeSearchPaths,I as removeGlobalTemplate,v as removeProjectRegistry,A as resolveTemplateSearchPaths,E as setJsoncValue,M as uniqueTemplateId,D as vscodeSettingsPath,b as writeGlobalCliConfig,g as writeProjectRegistries,k as writeVscodeSearchPaths};

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

@@ -3,8 +3,9 @@ import __tsdown_shims_url from 'node:url';
 import { Template, TemplateAction, TemplateActionContext, TemplateKind, TemplateManifest, TemplateVariable } from "./types.js";
 import { BUILTIN_TEMPLATES } from "./builtin.js";
 import { templateCommands } from "./cli/index.js";
+import { GlobalCliConfig, GlobalTemplates, RegistryEntry, ResolvedSearchPaths, SearchPathSource, VSCODE_REGISTRY_SEARCH_PATHS, addGlobalSource, addGlobalTemplate, addProjectRegistry, cliConfigPath, defaultGlobalTemplatesDir, defaultProjectTemplatesRegistry, existingTemplateIds, expandHome, globalProvidersPath, globalSourcesPath, globalToolchainDir, isRemoteRegistry, listRegistries, loadGlobalTemplates, normalizeSearchPaths, projectRegistriesPath, readGlobalCliConfig, readGlobalSources, readProjectRegistries, readVscodeSearchPaths, removeGlobalTemplate, removeProjectRegistry, resolveTemplateSearchPaths, setJsoncValue, uniqueTemplateId, vscodeSettingsPath, writeGlobalCliConfig, writeProjectRegistries, writeVscodeSearchPaths } from "./global.js";
 import { TEMPLATE_MANIFEST, isTemplateDir, loadLocalTemplates, readTemplateDir, readTemplateManifest, writeTemplateManifest } from "./local.js";
-import { gitTemplate, loadNpmTemplates, parseSourceSpec } from "./online.js";
+import { detectNpmRegistry, gitTemplate, loadNpmTemplates, parseSourceSpec } from "./online.js";
 import { LoadTemplatesOptions, REGISTRY_DIR, REGISTRY_FILE, TemplateRegistry, addTemplateSource, collectSources, loadTemplates, readTemplateRegistry, removeTemplateSource, writeTemplateRegistry } from "./registry.js";
 import { ScaffoldOptions, ScaffoldResult, scaffoldTemplate } from "./scaffold.js";
-export { BUILTIN_TEMPLATES, LoadTemplatesOptions, REGISTRY_DIR, REGISTRY_FILE, ScaffoldOptions, ScaffoldResult, TEMPLATE_MANIFEST, Template, TemplateAction, TemplateActionContext, TemplateKind, TemplateManifest, TemplateRegistry, TemplateVariable, addTemplateSource, collectSources, gitTemplate, isTemplateDir, loadLocalTemplates, loadNpmTemplates, loadTemplates, parseSourceSpec, readTemplateDir, readTemplateManifest, readTemplateRegistry, removeTemplateSource, scaffoldTemplate, templateCommands, writeTemplateManifest, writeTemplateRegistry };
+export { BUILTIN_TEMPLATES, GlobalCliConfig, GlobalTemplates, LoadTemplatesOptions, REGISTRY_DIR, REGISTRY_FILE, RegistryEntry, ResolvedSearchPaths, ScaffoldOptions, ScaffoldResult, SearchPathSource, TEMPLATE_MANIFEST, Template, TemplateAction, TemplateActionContext, TemplateKind, TemplateManifest, TemplateRegistry, TemplateVariable, VSCODE_REGISTRY_SEARCH_PATHS, addGlobalSource, addGlobalTemplate, addProjectRegistry, addTemplateSource, cliConfigPath, collectSources, defaultGlobalTemplatesDir, defaultProjectTemplatesRegistry, detectNpmRegistry, existingTemplateIds, expandHome, gitTemplate, globalProvidersPath, globalSourcesPath, globalToolchainDir, isRemoteRegistry, isTemplateDir, listRegistries, loadGlobalTemplates, loadLocalTemplates, loadNpmTemplates, loadTemplates, normalizeSearchPaths, parseSourceSpec, projectRegistriesPath, readGlobalCliConfig, readGlobalSources, readProjectRegistries, readTemplateDir, readTemplateManifest, readTemplateRegistry, readVscodeSearchPaths, removeGlobalTemplate, removeProjectRegistry, removeTemplateSource, resolveTemplateSearchPaths, scaffoldTemplate, setJsoncValue, templateCommands, uniqueTemplateId, vscodeSettingsPath, writeGlobalCliConfig, writeProjectRegistries, writeTemplateManifest, writeTemplateRegistry, writeVscodeSearchPaths };

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

@@ -1 +1 @@
-import"node:path";import"node:url";import.meta.url;import{TEMPLATE_MANIFEST as e,isTemplateDir as t,loadLocalTemplates as n,readTemplateDir as r,readTemplateManifest as i,writeTemplateManifest as a}from"./local.js";import{gitTemplate as o,loadNpmTemplates as s,parseSourceSpec as c}from"./online.js";import{BUILTIN_TEMPLATES as l}from"./builtin.js";import{REGISTRY_DIR as u,REGISTRY_FILE as d,addTemplateSource as f,collectSources as p,loadTemplates as m,readTemplateRegistry as h,removeTemplateSource as g,writeTemplateRegistry as _}from"./registry.js";import{scaffoldTemplate as v}from"./scaffold.js";import{templateCommands as y}from"./cli/index.js";export{l as BUILTIN_TEMPLATES,u as REGISTRY_DIR,d as REGISTRY_FILE,e as TEMPLATE_MANIFEST,f as addTemplateSource,p as collectSources,o as gitTemplate,t as isTemplateDir,n as loadLocalTemplates,s as loadNpmTemplates,m as loadTemplates,c as parseSourceSpec,r as readTemplateDir,i as readTemplateManifest,h as readTemplateRegistry,g as removeTemplateSource,v as scaffoldTemplate,y as templateCommands,a as writeTemplateManifest,_ as writeTemplateRegistry};
+import"node:path";import"node:url";import.meta.url;import{BUILTIN_TEMPLATES as e}from"./builtin.js";import{TEMPLATE_MANIFEST as t,isTemplateDir as n,loadLocalTemplates as r,readTemplateDir as i,readTemplateManifest as a,writeTemplateManifest as o}from"./local.js";import{VSCODE_REGISTRY_SEARCH_PATHS as s,addGlobalSource as c,addGlobalTemplate as l,addProjectRegistry as u,cliConfigPath as d,defaultGlobalTemplatesDir as f,defaultProjectTemplatesRegistry as p,existingTemplateIds as m,expandHome as h,globalProvidersPath as g,globalSourcesPath as _,globalToolchainDir as v,isRemoteRegistry as y,listRegistries as b,loadGlobalTemplates as x,normalizeSearchPaths as S,projectRegistriesPath as C,readGlobalCliConfig as w,readGlobalSources as T,readProjectRegistries as E,readVscodeSearchPaths as D,removeGlobalTemplate as O,removeProjectRegistry as k,resolveTemplateSearchPaths as A,setJsoncValue as j,uniqueTemplateId as M,vscodeSettingsPath as N,writeGlobalCliConfig as P,writeProjectRegistries as F,writeVscodeSearchPaths as I}from"./global.js";import{detectNpmRegistry as L,gitTemplate as R,loadNpmTemplates as z,parseSourceSpec as B}from"./online.js";import{REGISTRY_DIR as V,REGISTRY_FILE as H,addTemplateSource as U,collectSources as W,loadTemplates as G,readTemplateRegistry as K,removeTemplateSource as q,writeTemplateRegistry as J}from"./registry.js";import{scaffoldTemplate as Y}from"./scaffold.js";import{templateCommands as X}from"./cli/index.js";export{e as BUILTIN_TEMPLATES,V as REGISTRY_DIR,H as REGISTRY_FILE,t as TEMPLATE_MANIFEST,s as VSCODE_REGISTRY_SEARCH_PATHS,c as addGlobalSource,l as addGlobalTemplate,u as addProjectRegistry,U as addTemplateSource,d as cliConfigPath,W as collectSources,f as defaultGlobalTemplatesDir,p as defaultProjectTemplatesRegistry,L as detectNpmRegistry,m as existingTemplateIds,h as expandHome,R as gitTemplate,g as globalProvidersPath,_ as globalSourcesPath,v as globalToolchainDir,y as isRemoteRegistry,n as isTemplateDir,b as listRegistries,x as loadGlobalTemplates,r as loadLocalTemplates,z as loadNpmTemplates,G as loadTemplates,S as normalizeSearchPaths,B as parseSourceSpec,C as projectRegistriesPath,w as readGlobalCliConfig,T as readGlobalSources,E as readProjectRegistries,i as readTemplateDir,a as readTemplateManifest,K as readTemplateRegistry,D as readVscodeSearchPaths,O as removeGlobalTemplate,k as removeProjectRegistry,q as removeTemplateSource,A as resolveTemplateSearchPaths,Y as scaffoldTemplate,j as setJsoncValue,X as templateCommands,M as uniqueTemplateId,N as vscodeSettingsPath,P as writeGlobalCliConfig,F as writeProjectRegistries,o as writeTemplateManifest,J as writeTemplateRegistry,I as writeVscodeSearchPaths};

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

@@ -4,14 +4,23 @@ 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[]>;
+/**
+ * Detect the project's npm registry: Yarn's `npmRegistryServer`, then `.npmrc`
+ * `registry` (npm/pnpm), then the public npm registry.
+ */
+export declare function detectNpmRegistry(cwd?: string): string;
+/**
+ * List the templates an npm create package publishes. Scoped (`@scope/create`)
+ * and unscoped (`create-acme`, `acme-create`) packages are supported; the
+ * registry defaults to the project package manager's registry.
+ */
+export declare function loadNpmTemplates(pkg: string, registry?: string): Promise<Template[]>;
 /** A single template backed by a git repository. */
 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).
+ * `npm:@acme/create`, `npm:create-acme`) or an inferred source (a path that
+ * exists -> local, a scoped/create-* package -> npm, a URL/scp -> git).
  */
 export declare function parseSourceSpec(spec: string, cwd?: string): ToolchainTemplateSource;
 //#endregion

package/dist/packages/template/src/online.js

@@ -1 +1 @@
-import{default as e}from"node:path";import"node:url";import.meta.url;function t(e){if(!Array.isArray(e))return;let t=e.map(String).filter(Boolean);return t.length?t:void 0}function n(e,n){if(!Array.isArray(n))return[];let r=[];for(let i of n){let n=typeof i==`string`?{name:i}:i&&typeof i==`object`?i:void 0;if(!n)continue;let a=String(n.name??n.template??`template`),o=String(n.label??a),s=typeof n.description==`string`?n.description:void 0,c=t(n.tags);r.push({id:`${e}/${a}`,name:o,...s?{description:s}:{},kind:`project`,source:{type:`npm`,locate:e,subdir:a,online:!0},online:!0,...c?{tags:c}:{}})}return r}async function r(e){let t=e.replace(/^npm:/,``);try{let e=await fetch(`https://registry.npmjs.org/${encodeURIComponent(t)}/latest`,{headers:{accept:`application/json`}});if(!e.ok)return[];let r=await e.json();return n(t,r.createConfig?.templates??r.dbx?.templates??r.dbxTemplates)}catch{return[]}}function i(e){let t=e.locate.replace(/\.git$/,``).split(/[/:]/).filter(Boolean).pop()??`template`;return{id:e.id??`git:${t}`,name:e.name??t,...e.description?{description:e.description}:{},kind:e.kind??`project`,source:e,...e.tags?{tags:e.tags}:{},online:!0}}function a(t,n=process.cwd()){let r=t.match(/^(builtin|local|npm|git|vite-plus):(.+)$/i);return r?.[1]&&r[2]?{type:r[1].toLowerCase(),locate:r[2]}:/^(https?:|git@|git:\/\/|ssh:\/\/)/.test(t)||t.endsWith(`.git`)?{type:`git`,locate:t,online:!0}:/^@[^/]+\/[^/]+$/.test(t)?{type:`npm`,locate:t,online:!0}:{type:`local`,locate:e.resolve(n,t)}}export{i as gitTemplate,r as loadNpmTemplates,a as parseSourceSpec};
+import{default as e}from"node:path";import"node:url";import.meta.url;import t from"node:fs";const n=`https://registry.npmjs.org`;function r(e,n){try{let r=t.readFileSync(e,`utf-8`);return RegExp(`^\\s*${n}\\s*[:=]\\s*["']?([^"'\\s#]+)["']?`,`m`).exec(r)?.[1]?.replace(/\/+$/,``)}catch{return}}function i(t=process.cwd()){return r(e.join(t,`.yarnrc.yml`),`npmRegistryServer`)||r(e.join(t,`.npmrc`),`registry`)||n}function a(e){if(!Array.isArray(e))return;let t=e.map(String).filter(Boolean);return t.length?t:void 0}function o(e,t,r){if(!Array.isArray(t))return[];let i=[];for(let o of t){let t=typeof o==`string`?{name:o}:o&&typeof o==`object`?o:void 0;if(!t)continue;let s=String(t.name??t.template??`template`),c=String(t.label??s),l=typeof t.description==`string`?t.description:void 0,u=a(t.tags);i.push({id:`${e}/${s}`,name:c,...l?{description:l}:{},kind:`project`,source:{type:`npm`,locate:e,subdir:s,...r===n?{}:{registry:r},online:!0},online:!0,...u?{tags:u}:{}})}return i}async function s(e,t=n){let r=e.replace(/^npm:/,``),i=t.replace(/\/+$/,``);try{let e=await fetch(`${i}/${encodeURIComponent(r).replace(/^%40/,`@`)}/latest`,{headers:{accept:`application/json`}});if(!e.ok)return[];let t=await e.json();return o(r,t.createConfig?.templates??t.dbx?.templates??t.dbxTemplates,i)}catch{return[]}}function c(e){let t=e.locate.replace(/\.git$/,``).split(/[/:]/).filter(Boolean).pop()??`template`;return{id:e.id??`git:${t}`,name:e.name??t,...e.description?{description:e.description}:{},kind:e.kind??`project`,source:e,...e.tags?{tags:e.tags}:{},online:!0}}function l(t,n=process.cwd()){let r=t.match(/^(builtin|local|npm|git|vite-plus|remote):(.+)$/i);if(r?.[1]&&r[2]){let e=r[1].toLowerCase();return{type:e,locate:r[2],...e===`local`?{}:{online:!0}}}return/^(https?:|git@|git:\/\/|ssh:\/\/)/.test(t)||t.endsWith(`.git`)?{type:`git`,locate:t,online:!0}:/^@[^/]+\/[^/]+$/.test(t)||/^(?:create-[a-z0-9-]+|[a-z0-9-]+-create)$/i.test(t)?{type:`npm`,locate:t,online:!0}:{type:`local`,locate:e.resolve(n,t)}}export{i as detectNpmRegistry,c as gitTemplate,s as loadNpmTemplates,l as parseSourceSpec};

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

@@ -42,7 +42,8 @@ export interface LoadTemplatesOptions {
 export declare function collectSources(options: LoadTemplatesOptions): ToolchainTemplateSource[];
 /**
  * Resolve every template: builtin, local directories (offline, always), and —
- * when `online` — npm `@scope/create` manifests + git repositories.
+ * when `online` — npm create packages, git repositories and remote source
+ * registries.
  */
 export declare function loadTemplates(options: LoadTemplatesOptions): Promise<Template[]>;
 //#endregion

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

@@ -1 +1 @@
-import{default as e}from"node:path";import"node:url";import.meta.url;import{sectionConfig as t,sectionEnabled as n}from"../../shared/src/toolchain.js";import"../../shared/src/index.js";import{loadLocalTemplates as r}from"./local.js";import{gitTemplate as i,loadNpmTemplates as a}from"./online.js";import{BUILTIN_TEMPLATES as o}from"./builtin.js";import s from"node:fs";const c=`.dbx/toolchain`,l=`templates.json`;function u(t){let n=e.join(t,c,l);try{let e=s.readFileSync(n,`utf-8`).replace(/^\uFEFF/,``),t=JSON.parse(e);return{sources:Array.isArray(t.sources)?t.sources:[]}}catch{return{sources:[]}}}function d(t,n){let r=e.join(t,c,l);s.mkdirSync(e.dirname(r),{recursive:!0}),s.writeFileSync(r,`${JSON.stringify({sources:n},null,4)}\n`,`utf-8`)}function f(e,t){let n=u(e),r=e=>`${e.type}:${e.locate}`,i=n.sources.filter(e=>r(e)!==r(t));return i.push(t),d(e,i),{sources:i}}function p(e,t){let n=u(e),r=n.sources.filter(e=>e.id!==t&&`${e.type}:${e.locate}`!==t),i=n.sources.length-r.length;return i>0&&d(e,r),{registry:{sources:r},removed:i}}function m(e){return[...e.config&&n(e.config.templates)?t(e.config.templates)?.sources??[]:[],...u(e.cwd).sources,...e.sources??[]]}async function h(e){let t=/* @__PURE__ */ new Set,n=[],s=e=>{t.has(e.id)||(t.add(e.id),n.push(e))};if(e.builtin!==!1)for(let e of o)s(e);for(let t of m(e))switch(t.type){case`builtin`:{let e=o.find(e=>e.id===t.locate);e&&s(t.id?{...e,id:t.id}:e);break}case`local`:for(let e of r(t.locate,t.id))s(e);break;case`git`:s(i(t));break;case`npm`:if(e.online)for(let e of await a(t.locate))s(e);break;case`vite-plus`:s({id:t.id??`vite-plus`,name:t.name??`Vite+ app`,...t.description?{description:t.description}:{},kind:t.kind??`project`,source:t,...t.tags?{tags:t.tags}:{},online:!0})}return n}export{c as REGISTRY_DIR,l as REGISTRY_FILE,f as addTemplateSource,m as collectSources,h as loadTemplates,u as readTemplateRegistry,p as removeTemplateSource,d as writeTemplateRegistry};
+import{default as e}from"node:path";import"node:url";import.meta.url;import{registrySourceAllowed as t}from"../../shared/src/registry-policy.js";import{sectionConfig as n,sectionEnabled as r}from"../../shared/src/toolchain.js";import"../../shared/src/index.js";import{BUILTIN_TEMPLATES as i}from"./builtin.js";import{loadLocalTemplates as a}from"./local.js";import{loadGlobalTemplates as o}from"./global.js";import{detectNpmRegistry as s,gitTemplate as c,loadNpmTemplates as l}from"./online.js";import u from"node:fs";const d=`.dbx/toolchain`,f=`templates.json`;function p(t){let n=e.join(t,d,f);try{let e=u.readFileSync(n,`utf-8`).replace(/^\uFEFF/,``),t=JSON.parse(e);return{sources:Array.isArray(t.sources)?t.sources:[]}}catch{return{sources:[]}}}function m(t,n){let r=e.join(t,d,f);u.mkdirSync(e.dirname(r),{recursive:!0}),u.writeFileSync(r,`${JSON.stringify({sources:n},null,4)}\n`,`utf-8`)}function h(e,t){let n=p(e),r=e=>`${e.type}:${e.locate}`,i=n.sources.filter(e=>r(e)!==r(t));return i.push(t),m(e,i),{sources:i}}function g(e,t){let n=p(e),r=n.sources.filter(e=>e.id!==t&&`${e.type}:${e.locate}`!==t),i=n.sources.length-r.length;return i>0&&m(e,r),{registry:{sources:r},removed:i}}function _(e){return[...e.config&&r(e.config.templates)?n(e.config.templates)?.sources??[]:[],...p(e.cwd).sources,...e.sources??[]]}function v(e){if(e&&r(e.registry))return n(e.registry)?.templates}function y(n,r,i){return i?n.type===`local`?t(e.resolve(r,n.locate),i):n.type===`npm`?t(n.registry??s(r),i):t(n.locate,i):!0}async function b(e){try{let t=await fetch(e,{headers:{accept:`application/json`}});if(!t.ok)return[];let n=await t.json(),r=Array.isArray(n)?n:n.sources??n.templates;return Array.isArray(r)?r.filter(e=>!!e&&typeof e==`object`&&typeof e.type==`string`&&typeof e.locate==`string`):[]}catch{return[]}}async function x(e){let t=/* @__PURE__ */ new Set,n=[],r=e=>{t.has(e.id)||(t.add(e.id),n.push(e))};if(e.builtin!==!1)for(let e of i)r(e);let u=v(e.config),d=await o(e.cwd,u),f=[...[..._(e),...d.sources].filter(t=>y(t,e.cwd,u))],p=/* @__PURE__ */ new Set;for(;f.length>0;){let t=f.shift();switch(t.type){case`remote`:if(e.online&&!p.has(t.locate)){p.add(t.locate);let n=await b(t.locate);f.push(...n.filter(t=>y(t,e.cwd,u)))}break;case`builtin`:{let e=i.find(e=>e.id===t.locate);e&&r(t.id?{...e,id:t.id}:e);break}case`local`:for(let e of a(t.locate,t.id))r(e);break;case`git`:r(c(t));break;case`npm`:if(e.online)for(let n of await l(t.locate,t.registry??s(e.cwd)))r(n);break;case`vite-plus`:r({id:t.id??`vite-plus`,name:t.name??`Vite+ app`,...t.description?{description:t.description}:{},kind:t.kind??`project`,source:t,...t.tags?{tags:t.tags}:{},online:!0})}}for(let e of d.templates)r(e);return n}export{d as REGISTRY_DIR,f as REGISTRY_FILE,h as addTemplateSource,_ as collectSources,x as loadTemplates,p as readTemplateRegistry,g as removeTemplateSource,m as writeTemplateRegistry};

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

@@ -11,10 +11,14 @@ export interface ScaffoldOptions {
   tokens?: Replacements;
   /** Per-template variable values (merged over `tokens`). */
   variables?: Record<string, string>;
-  /** Overwrite existing files (local templates; default true). */
+  /** Overwrite existing files (local templates; default false). */
   overwrite?: boolean;
+  /** Overwrite existing files (builtin + local templates). */
+  force?: boolean;
   /** Action ids to run after writing the files (default: none). */
   actions?: string[];
+  /** The monorepo workspaces tsconfig name (workspace scaffolds). */
+  tsconfigRootFile?: string;
 }
 export interface ScaffoldResult {
   /** Absolute paths written (empty when delegated to `vp`). */

package/dist/packages/template/src/scaffold.js

@@ -1 +1 @@
-import{default as e}from"node:path";import{pathToFileURL as t}from"node:url";import.meta.url;import{spawnCross as n}from"../../shared/src/run.js";import{applyReplacements as r}from"../../shared/src/template.js";import"../../shared/src/index.js";import{createMonorepoRootFiles as i,createRootProjectFiles as a,createWorkspaceFiles as o,writeGeneratedFiles as s}from"../../project/src/typescript.js";import"../../project/src/index.js";import{runVp as c}from"../../vite/src/vp.js";import"../../vite/src/index.js";import{readTemplateManifest as l}from"./local.js";import u from"node:fs";import{spawn as d}from"node:child_process";const f=/* @__PURE__ */ new Set([`node_modules`,`.git`,`dist`,`.turbo`,`.dbx`,`.DS_Store`,`template.json`]);function p(e){return{...e.tokens,...e.variables}}function m(e,t=!0){return e==null||e===``?t:typeof e==`boolean`?e:![`no`,`false`,`0`,`off`].includes(String(e).toLowerCase())}function h(e,t){let n=p(t),r=String(n.name??`app`),c=n.scope?String(n.scope):void 0,l=m(n.includeConfig),u=n.packageManager?String(n.packageManager):void 0,d=[];switch(e.builtin){case`monorepo-root`:{let e=c??`@${r}`;d.push(...i({name:r,scope:e,type:`monorepo-root`,includeConfig:l,...u?{packageManager:u}:{},workspaces:[]}));break}case`monorepo-example`:{let e=c??`@${r}`;d.push(...i({name:r,scope:e,type:`monorepo-root`,includeConfig:l,...u?{packageManager:u}:{},workspaces:[{alias:`core`,dir:`packages/core`}]})),d.push(...o({name:r,scope:e,wsName:`core`,wsDir:`packages/core`,type:`monorepo-workspace`,includeConfig:l,useCatalog:!0,...u?{packageManager:u}:{}}).map(e=>({...e,path:`packages/core/${e.path}`})));break}case`monorepo-workspace`:{let e=`packages/${r}`;d.push(...o({name:r,...c?{scope:c}:{},wsName:r,wsDir:e,type:`monorepo-workspace`,includeConfig:l,...u?{packageManager:u}:{}}).map(t=>({...t,path:`${e}/${t.path}`})));break}case`folder`:d.push({path:`README.md`,content:`# ${r}\n`});break;default:d.push(...a({name:r,...c?{scope:c}:{},type:`project`,includeConfig:l,...u?{packageManager:u}:{}}))}return{written:s(d,t.cwd)}}function g(t,n){let i=t.dir;if(!i)throw Error(`Local template "${t.id}" has no directory.`);let a=l(i),o=/* @__PURE__ */ new Set([...f,...a?.ignore??[]]);for(let e of t.actions??[])e.module&&o.add(e.module.replace(/\\/g,`/`));let s=t.tokens?.open??`{{`,c=t.tokens?.close??`}}`,d=p(n),m=n.overwrite!==!1,h=[],g=t=>{let a=e.join(i,t);for(let l of u.readdirSync(a,{withFileTypes:!0})){if(o.has(l.name))continue;let a=t?`${t}/${l.name}`:l.name;if(l.isDirectory()){g(a);continue}let f=e.join(n.cwd,r(a,d,{open:s,close:c}));if(!m&&u.existsSync(f))continue;let p=u.readFileSync(e.join(i,a),`utf-8`);h.push({target:f,content:r(p,d,{open:s,close:c})})}};g(``);let _=[];for(let t of h)u.mkdirSync(e.dirname(t.target),{recursive:!0}),u.writeFileSync(t.target,t.content,`utf-8`),_.push(t.target);return{written:_}}async function _(e,t){let n=e.source.subdir?`${e.source.locate}/${e.source.subdir}`:e.source.locate,r=[`create`];n&&r.push(n);let i=t.tokens?.name;return i&&r.push(String(i)),{written:[],code:(await c(r,{cwd:t.cwd})).code}}function v(e,t,r){return new Promise(i=>{let a;try{a=n(e,t,{cwd:r,stdio:`inherit`})}catch{i(1);return}a.on(`error`,()=>i(1)),a.on(`exit`,e=>i(e??0))})}function y(e,t){return new Promise(n=>{let r=d(e,{cwd:t,stdio:`inherit`,shell:!0});r.on(`error`,()=>n(1)),r.on(`exit`,e=>n(e??0))})}function b(e,t){let n=p(t),r={};for(let[e,n]of Object.entries(t.variables??{}))r[e]=n==null?``:String(n);return{cwd:t.cwd,...e.dir?{templateDir:e.dir}:{},tokens:n,variables:r,packageManager:String(n.packageManager??`yarn`),log:e=>console.log(e)}}async function x(n,r,i,a){if(r.builtin===`install`){a.log(`Installing dependencies with ${a.packageManager}…`);let e=await v(a.packageManager,[`install`],i.cwd);if(e!==0)throw Error(`\`${a.packageManager} install\` failed with exit code ${e}.`)}else if(r.module){let o=n.dir??i.cwd,s=e.resolve(o,r.module);if(!u.existsSync(s))throw Error(`template action module not found: ${r.module}`);let c=await import(t(s).href),l=c.default??c.run;if(typeof l!=`function`)throw Error(`template action module "${r.module}" does not export a function.`);await l(a)}else if(r.command){let e=await y(r.command,i.cwd);if(e!==0)throw Error(`template command failed with exit code ${e}: ${r.command}`)}else throw Error(`template action "${r.id}" declares no builtin, module or command.`)}async function S(e,t){let n=new Set(t.actions??[]),r=[];for(let i of e.actions??[])n.has(i.id)&&(await x(e,i,t,b(e,t)),r.push(i.id));return r}async function C(e,t){if(e.builtin){let n=h(e,t),r=await S(e,t);return r.length>0?{...n,ranActions:r}:n}switch(e.source.type){case`local`:{let n=g(e,t),r=await S(e,t);return r.length>0?{...n,ranActions:r}:n}case`vite-plus`:case`npm`:case`git`:return _(e,t);default:throw Error(`Template "${e.id}" has no scaffold handler.`)}}export{C as scaffoldTemplate};
+import{default as e}from"node:path";import{pathToFileURL as t}from"node:url";import.meta.url;import{spawnCross as n}from"../../shared/src/run.js";import{applyReplacements as r}from"../../shared/src/template.js";import"../../shared/src/index.js";import{hasCatalog as i}from"../../project/src/catalogs.js";import{SCAFFOLD_CATALOG as a,createMonorepoRootFiles as o,createRootProjectFiles as s,createWorkspaceFiles as c,findRootOxcFiles as l,upsertWorkspaceTsconfig as u,writeGeneratedFiles as d}from"../../project/src/typescript.js";import"../../project/src/index.js";import{runVp as f}from"../../vite/src/vp.js";import"../../vite/src/index.js";import{readTemplateManifest as p}from"./local.js";import m from"node:fs";import{spawn as h}from"node:child_process";const g=/* @__PURE__ */ new Set([`node_modules`,`.git`,`dist`,`.turbo`,`.dbx`,`.DS_Store`,`template.json`]);function _(e){return{...e.tokens,...e.variables}}function v(e,t=!0){return e==null||e===``?t:typeof e==`boolean`?e:![`no`,`false`,`0`,`off`].includes(String(e).toLowerCase())}function y(e){let t=e=>e==null||e===``?void 0:String(e),n=t(e.repo)??t(e.repoUrl);return{...t(e.description)?{description:t(e.description)}:{},...t(e.author)?{author:t(e.author)}:{},...t(e.license)?{license:t(e.license)}:{},...t(e.homepage)?{homepage:t(e.homepage)}:{},...n?{repo:n}:{},...t(e.nodeVersion)?{nodeVersion:t(e.nodeVersion)}:{}}}function b(e,t){let n=_(t),r=e=>e==null||e===``?void 0:String(e),f=String(n.name??`app`),p=n.scope?String(n.scope):void 0,m=v(n.includeConfig),h=r(n.packageManager),g=r(t.tokens?.packageManager),b=r(t.tokens?.packageManagerVersion)??r(t.tokens?.yarnVersion),x=r(t.variables?.packageManagerVersion)??(h&&h===g?b:void 0),S={...y(n),...x?{packageManagerVersion:x}:{}},{description:C,...w}=S,T=[];switch(e.builtin){case`monorepo-root`:{let e=p??`@${f}`;T.push(...o({...S,name:f,scope:e,type:`monorepo-root`,includeConfig:m,...h?{packageManager:h}:{},workspaces:[]}));break}case`monorepo-example`:{let e=p??`@${f}`;T.push(...o({...S,name:f,scope:e,type:`monorepo-root`,includeConfig:m,...h?{packageManager:h}:{},workspaces:[{alias:`core`,dir:`packages/core`}]})),T.push(...c({...w,name:f,scope:e,wsName:`core`,wsDir:`packages/core`,type:`monorepo-workspace`,includeConfig:m,useCatalog:!0,...h?{packageManager:h}:{}}).map(e=>({...e,path:`packages/core/${e.path}`})));break}case`monorepo-workspace`:{let e=`packages/${f}`;T.push(...c({...w,name:f,...p?{scope:p}:{},wsName:f,wsDir:e,type:`monorepo-workspace`,includeConfig:m,useCatalog:i(t.cwd,h,Object.keys(a)),...h?{packageManager:h}:{}}).map(t=>({...t,path:`${e}/${t.path}`})));break}case`folder`:T.push({path:`README.md`,content:`# ${f}\n`});break;default:T.push(...s({...S,name:f,...p?{scope:p}:{},type:`project`,kind:e.builtin===`application`?`application`:`project`,includeConfig:m,rootOxc:l(t.cwd),...h?{packageManager:h}:{}}))}let E=d(T,t.cwd,{force:t.force===!0});return e.builtin===`monorepo-workspace`&&u(t.cwd,{alias:f,dir:`packages/${f}`},p,t.tsconfigRootFile),{written:E}}function x(t,n){let i=t.dir;if(!i)throw Error(`Local template "${t.id}" has no directory.`);let a=p(i),o=/* @__PURE__ */ new Set([...g,...a?.ignore??[]]);for(let e of t.actions??[])e.module&&o.add(e.module.replace(/\\/g,`/`));let s=t.tokens?.open??`{{`,c=t.tokens?.close??`}}`,l=_(n),u=n.force===!0||n.overwrite===!0,d=[],f=e.resolve(n.cwd),h=t=>{let n=e.join(i,t);for(let a of m.readdirSync(n,{withFileTypes:!0})){if(o.has(a.name))continue;let n=t?`${t}/${a.name}`:a.name;if(a.isDirectory()){h(n);continue}let p=e.resolve(f,r(n,l,{open:s,close:c})),g=process.platform===`win32`?f.toLowerCase():f,_=process.platform===`win32`?p.toLowerCase():p;if(_!==g&&!_.startsWith(`${g}${e.sep}`))throw Error(`refusing to write outside ${f}: ${p}`);if(!u&&m.existsSync(p))continue;let v=m.readFileSync(e.join(i,n),`utf-8`);d.push({target:p,content:r(v,l,{open:s,close:c})})}};h(``);let v=[];for(let t of d)m.mkdirSync(e.dirname(t.target),{recursive:!0}),m.writeFileSync(t.target,t.content,`utf-8`),v.push(t.target);return{written:v}}async function S(e,t){let n=e.source.subdir?`${e.source.locate}/${e.source.subdir}`:e.source.locate,r=[`create`];n&&r.push(n);let i=t.tokens?.name;return i&&r.push(String(i)),{written:[],code:(await f(r,{cwd:t.cwd})).code}}function C(e,t,r){return new Promise(i=>{let a;try{a=n(e,t,{cwd:r,stdio:`inherit`})}catch{i(1);return}a.on(`error`,()=>i(1)),a.on(`exit`,e=>i(e??0))})}function w(e,t){return new Promise(n=>{let r=h(e,{cwd:t,stdio:`inherit`,shell:!0});r.on(`error`,()=>n(1)),r.on(`exit`,e=>n(e??0))})}function T(e,t){let n=_(t),r={};for(let[e,n]of Object.entries(t.variables??{}))r[e]=n==null?``:String(n);return{cwd:t.cwd,...e.dir?{templateDir:e.dir}:{},tokens:n,variables:r,packageManager:String(n.packageManager??`yarn`),log:e=>console.log(e)}}async function E(n,r,i,a){if(r.builtin===`install`){a.log(`Installing dependencies with ${a.packageManager}…`);let e=await C(a.packageManager,[`install`],i.cwd);if(e!==0)throw Error(`\`${a.packageManager} install\` failed with exit code ${e}.`)}else if(r.module){let o=n.dir??i.cwd,s=e.resolve(o,r.module);if(!m.existsSync(s))throw Error(`template action module not found: ${r.module}`);let c=await import(t(s).href),l=c.default??c.run;if(typeof l!=`function`)throw Error(`template action module "${r.module}" does not export a function.`);await l(a)}else if(r.command){let e=await w(r.command,i.cwd);if(e!==0)throw Error(`template command failed with exit code ${e}: ${r.command}`)}else throw Error(`template action "${r.id}" declares no builtin, module or command.`)}async function D(e,t){let n=new Set(t.actions??[]),r=[];for(let i of e.actions??[])n.has(i.id)&&(await E(e,i,t,T(e,t)),r.push(i.id));return r}async function O(e,t){if(e.builtin){let n=b(e,t),r=await D(e,t);return r.length>0?{...n,ranActions:r}:n}switch(e.source.type){case`local`:{let n=x(e,t),r=await D(e,t);return r.length>0?{...n,ranActions:r}:n}case`vite-plus`:case`npm`:case`git`:return S(e,t);default:throw Error(`Template "${e.id}" has no scaffold handler.`)}}export{O as scaffoldTemplate};

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

@@ -1,5 +1,6 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
+import { TsconfigOverrides } from "../../overrides.js";
 import { GeneratedTsconfigResult } from "./utils.js";
 //#region packages/tsconfig/src/cli/generate/index.d.ts
 export interface GenerateTsconfigsOptions {
@@ -29,6 +30,8 @@ export interface GenerateTsconfigsOptions {
   log?: boolean;
   /** Write the generated files to disk (default true; false for a dry run). */
   write?: boolean;
+  /** Managed file overrides applied before generating each workspace. */
+  overrides?: TsconfigOverrides;
 }
 /**
  * Extend every workspace default tsconfig (`tsconfig.default.json`) into a

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{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};
+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 r of E){let i=r.fullpath(),o=e.dirname(i);D.push(a({cwd:v,dirname:o,tsconfigPath:i,monorepoTsconfigPath:b,tsconfigBuildPath:e.resolve(o,p),targetTsconfigPath:e.resolve(o,`tsconfig.json`),targetTsconfigBuildPath:e.resolve(o,p),indent:u,disableComposite:!s,ignoreAliases:!n,ignoreReferences:!l,write:g,log:y,...t.overrides?{overrides:t.overrides}:{}}))}if(!l)return D;y(`Checking for additional tsconfig changes...`);let O=new Map(D.map(t=>[e.resolve(t.targetTsconfigPath),t]));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),i=O.get(r),a;if(i)a=i.config.compilerOptions?.composite;else if(o.existsSync(r))a=JSON.parse(o.readFileSync(r,`utf-8`)).compilerOptions?.composite;else return y(`    tsconfig not found for ${t.path}, skipping.`),!1;return a!=null&&a!==!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.d.ts

@@ -1,6 +1,7 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
-import { TsConfigJson } from "/home/runner/work/toolchain/toolchain/node_modules/type-fest/index.js";
+import { TsconfigOverrides } from "../../overrides.js";
+import { TsConfigJson } from "type-fest";
 //#region packages/tsconfig/src/cli/generate/utils.d.ts
 export type GeneratedTsconfigResult = ReturnType<typeof generateTsconfig>;
 export declare function generateTsconfig(options: {
@@ -17,6 +18,10 @@ export declare function generateTsconfig(options: {
   disableComposite?: boolean;
   /** Write the generated files to disk (default true). */
   write?: boolean;
+  /** Log sink (default: the shared info logger). Pass a no-op to stay quiet. */
+  log?: (message: string) => void;
+  /** Managed file overrides applied before generating. */
+  overrides?: TsconfigOverrides;
 }): {
   cwd: string;
   dirname: string;
@@ -31,6 +36,10 @@ export declare function generateTsconfig(options: {
   disableComposite?: boolean;
   /** Write the generated files to disk (default true). */
   write?: boolean;
+  /** Log sink (default: the shared info logger). Pass a no-op to stay quiet. */
+  log?: (message: string) => void;
+  /** Managed file overrides applied before generating. */
+  overrides?: TsconfigOverrides;
   dirnameRelative: string;
   tsconfigFilename: string;
   config: TsConfigJson;

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}`);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};
+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{mergeOverride as n}from"../../overrides.js";import{readTsconfig as r,resolveTsconfig as i}from"../../resolve.js";import a from"node:fs";function o(o){let{cwd:c,dirname:l,tsconfigPath:u,monorepoTsconfigPath:d,tsconfigBuildPath:f,targetTsconfigPath:p,targetTsconfigBuildPath:m,indent:h=4,disableComposite:g,ignoreAliases:_,ignoreReferences:v,write:y=!0,log:b=e=>t.info(e),overrides:x}=o,S=e.relative(c,l).replace(/\\/g,`/`)||`.`;try{if(!a.existsSync(u))throw Error(`Source tsconfig not found: ${u}`);if(!d)throw Error(`options.monorepoTsconfigPath not set for ${u}`);b(`  - ${S}`);let t=e.basename(u),m=a.existsSync(f),C=a.existsSync(d),w=C?r(d):{},T=n(w,x?.root),E=C?i({tsconfig:d,root:c,cwd:c,...x?.root?{overrides:x.root}:{}}):{alias:[],paths:{},references:[]},D=r(u),O=n(D,x?.default),k=m?r(f):void 0,A=k?n(k,x?.build):void 0,j=g?[]:[.../* @__PURE__ */ new Set([...O.compilerOptions?.types??[],...g?[]:T.compilerOptions?.types??[]])],M={};if(!_)for(let[e,t]of Object.entries(E.paths)){let n=t.map(e=>s(e,l,S)).filter(e=>e!==void 0);n.length>0&&(M[e]=n)}let N=[];if(!v){let t=/* @__PURE__ */ new Set,n=(e,n)=>{let r=s(e,l,S);r===void 0||t.has(r)||(t.add(r),N.push({...n,path:r}))};for(let t of O.references??[])n(e.resolve(c,t.path),t);for(let e of E.references)n(e.path,e)}let P={...g?{}:T,extends:`./${t}`,compilerOptions:{...g?{composite:!1}:T.compilerOptions,...j.length?{types:j}:{},..._?{}:{paths:{...O.compilerOptions?.paths,...M}}},...v?{}:{references:N}},F=m?{...A,extends:`./${t}`}:void 0;return y&&a.writeFileSync(p,`${JSON.stringify(P,null,h)}\n`),{...o,dirnameRelative:S,tsconfigFilename:t,config:P,newTsconfig:P,newTsconfigBuild:F,originalConfig:D,tsconfigMonorepo:T,tsconfigBuild:A}}catch(e){throw Error(`Failed to extend tsconfig for ${S}: ${e instanceof Error?e.message:String(e)}`)}}function s(t,n,r){let i=e.resolve(t),a=e.resolve(n),o=e.dirname(i);if((o===a||o.startsWith(`${a}${e.sep}`))&&r!==`.`)return;let s=e.relative(a,i).replace(/\\/g,`/`);return s.startsWith(`.`)||(s=`./${s}`),s}export{o as generateTsconfig};

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 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};
+import"node:path";import"node:url";import.meta.url;import{warningMessage as e}from"../../../shared/src/messages.js";import{logger as t}from"../../../shared/src/logger.js";import{sectionConfig as n}from"../../../shared/src/toolchain.js";import"../../../shared/src/index.js";import{TSCONFIG_OVERRIDE_KINDS as r,hasOverrideKeys as i}from"../overrides.js";import{resolveTsconfig as a}from"../resolve.js";import{generateTsconfigs as o}from"./generate/index.js";import{restoreTsconfigOverrides as s}from"../snapshots.js";function c(){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.`},{flags:`--tsconfig <file>`,description:`Resolve this tsconfig instead of <root>/tsconfig.json.`},{flags:`--root <dir>`,description:`Root used to detect/resolve the tsconfig (default: cwd).`},{flags:`--json`,description:`Print the resolved { alias, paths, references } object.`},{flags:`--alias`,description:`Print only the resolved Vite/Vitest aliases.`},{flags:`--paths`,description:`Print only the resolved compilerOptions.paths.`},{flags:`--references`,description:`Print only the resolved project references.`},{flags:`--no-extends`,description:`Do not follow the tsconfig extends chain.`},{flags:`--restore [kind]`,description:`Remove the applied tsconfig overrides (all, or base|root|default|build) using the manifest snapshots.`}],run:(c,l)=>{let u=c.cwd??l.cwd,d=c.root??u,f=n(l.config.tsconfig)??{},p=c.defaultFile??f.defaultFile??`tsconfig.default.json`,m=c.buildFile??f.buildFile??`tsconfig.build.json`,h=c.rootFile??f.rootFile??`tsconfig.workspaces.json`,g=[`alias`,`paths`,`references`].filter(e=>c[e]===!0),_=c.restore;if(_!==void 0&&_!==!1){let n=typeof _==`string`?_:void 0;if(n!==void 0&&!r.includes(n))throw Error(`invalid --restore kind "${n}" (expected ${r.join(`|`)}).`);let a=s({cwd:u,...n?{kind:n}:{},warn:(e,n)=>t.warn(e,n)});t.info(a.restored.length>0?`Restored ${a.restored.length} tsconfig file(s): ${a.restored.join(`, `)}.`:`No tsconfig overrides to restore.`);let o=f.overrides??{},c=a.kinds.filter(e=>i(o[e]));c.length>0&&t.warn(e(`tsconfig.restore-reapply`,{kinds:c.join(`, `)}),`tsconfig.restore-reapply`);return}if(c.json===!0||g.length>0){let e=a({cwd:u,root:d,...c.tsconfig?{tsconfig:c.tsconfig}:{},...c.extends===!1?{extends:!1}:{}}),n=g.length===0?e:g.length===1?e[g[0]]:Object.fromEntries(g.map(t=>[t,e[t]]));t.raw(JSON.stringify(n,(e,t)=>t instanceof RegExp?String(t):t,4));return}let v=c.glob;o({cwd:l.cwd,aliases:c.aliases??f.aliases??!0,composite:c.composite??f.composite??!1,refs:c.refs??f.refs??!1,indent:c.indent===void 0?f.indent:Number.parseInt(String(c.indent),10),glob:v??f.glob??`**/${p}`,exclude:c.exclude??f.exclude,gitignore:c.gitignore??f.gitignore,defaultFile:p,buildFile:m,monorepoTsconfigFilename:h,...f.overrides?{overrides:f.overrides}:{}})}}]}export{c as tsconfigCommands};

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

@@ -1,10 +1,13 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
+import { AppliedOverride, OverrideLeaf, OverridesState, RevertOverrideResult, TSCONFIG_OVERRIDE_KINDS, TsconfigOverrideKind, TsconfigOverrides, addedOverrideLeaves, applyOverride, getPath, hasOverrideKeys, hasPath, isAppliedOverride, mergeOverride, overrideLeaves, recordOverrideSnapshot, removedOverrideLeaves, revertOverride } from "./overrides.js";
 import { GenerateTsconfigsOptions, generateTsconfigs, runTsconfigCli } from "./cli/generate/index.js";
-import { tsconfigSyncTask } from "./sync.js";
-import { DEFAULT_TSCONFIG_REPLACEMENTS, MonorepoTsconfigOptions, MonorepoWorkspace, buildMonorepoTsconfig, renderMonorepoTsconfig, renderTsconfigBase, renderTsconfigBuild, renderTsconfigDefault, renderTsconfigTemplates, tsconfigBaseTemplate, tsconfigBuildTemplate, tsconfigDefaultTemplate } from "./templates.js";
+import { ResolveTsconfigOptions, ResolvedTsconfig, TsconfigAlias, TsconfigJson, TsconfigReference, parseTsconfig, readTsconfig, resolveTsconfig } from "./resolve.js";
+import { RestoreTsconfigOverridesOptions, RestoreTsconfigOverridesResult, SnapshotTree, TSCONFIG_MANIFEST_PATH, deleteSnapshot, detectIndent, getSnapshot, restoreTsconfigOverrides, setSnapshot, stringifyTsconfig, toRepoRelative } from "./snapshots.js";
+import { TsconfigFileNames, tsconfigFileNames, tsconfigSyncTask } from "./sync.js";
+import { DEFAULT_TSCONFIG_REPLACEMENTS, MonorepoTsconfigOptions, MonorepoWorkspace, TsconfigExtends, TsconfigExtendsOptions, buildMonorepoTsconfig, renderMonorepoTsconfig, renderTsconfigBase, renderTsconfigBuild, renderTsconfigDefault, renderTsconfigTemplates, tsconfigBaseTemplate, tsconfigBuildTemplate, tsconfigDefaultTemplate } from "./templates.js";
 declare namespace index_d_exports {
-  export { DEFAULT_TSCONFIG_REPLACEMENTS, GenerateTsconfigsOptions, MonorepoTsconfigOptions, MonorepoWorkspace, buildMonorepoTsconfig, generateTsconfigs, renderMonorepoTsconfig, renderTsconfigBase, renderTsconfigBuild, renderTsconfigDefault, renderTsconfigTemplates, runTsconfigCli, tsconfigBaseTemplate, tsconfigBuildTemplate, tsconfigDefaultTemplate, tsconfigSyncTask };
+  export { AppliedOverride, DEFAULT_TSCONFIG_REPLACEMENTS, GenerateTsconfigsOptions, MonorepoTsconfigOptions, MonorepoWorkspace, OverrideLeaf, OverridesState, ResolveTsconfigOptions, ResolvedTsconfig, RestoreTsconfigOverridesOptions, RestoreTsconfigOverridesResult, RevertOverrideResult, SnapshotTree, TSCONFIG_MANIFEST_PATH, TSCONFIG_OVERRIDE_KINDS, TsconfigAlias, TsconfigExtends, TsconfigExtendsOptions, TsconfigFileNames, TsconfigJson, TsconfigOverrideKind, TsconfigOverrides, TsconfigReference, addedOverrideLeaves, applyOverride, buildMonorepoTsconfig, deleteSnapshot, detectIndent, generateTsconfigs, getPath, getSnapshot, hasOverrideKeys, hasPath, isAppliedOverride, mergeOverride, overrideLeaves, parseTsconfig, readTsconfig, recordOverrideSnapshot, removedOverrideLeaves, renderMonorepoTsconfig, renderTsconfigBase, renderTsconfigBuild, renderTsconfigDefault, renderTsconfigTemplates, resolveTsconfig, restoreTsconfigOverrides, revertOverride, runTsconfigCli, setSnapshot, stringifyTsconfig, toRepoRelative, tsconfigBaseTemplate, tsconfigBuildTemplate, tsconfigDefaultTemplate, tsconfigFileNames, tsconfigSyncTask };
 }
 //#endregion
-export { DEFAULT_TSCONFIG_REPLACEMENTS, GenerateTsconfigsOptions, MonorepoTsconfigOptions, MonorepoWorkspace, buildMonorepoTsconfig, generateTsconfigs, index_d_exports, renderMonorepoTsconfig, renderTsconfigBase, renderTsconfigBuild, renderTsconfigDefault, renderTsconfigTemplates, runTsconfigCli, tsconfigBaseTemplate, tsconfigBuildTemplate, tsconfigDefaultTemplate, tsconfigSyncTask };
+export { AppliedOverride, DEFAULT_TSCONFIG_REPLACEMENTS, GenerateTsconfigsOptions, MonorepoTsconfigOptions, MonorepoWorkspace, OverrideLeaf, OverridesState, ResolveTsconfigOptions, ResolvedTsconfig, RestoreTsconfigOverridesOptions, RestoreTsconfigOverridesResult, RevertOverrideResult, SnapshotTree, TSCONFIG_MANIFEST_PATH, TSCONFIG_OVERRIDE_KINDS, TsconfigAlias, TsconfigExtends, TsconfigExtendsOptions, TsconfigFileNames, TsconfigJson, TsconfigOverrideKind, TsconfigOverrides, TsconfigReference, addedOverrideLeaves, applyOverride, buildMonorepoTsconfig, deleteSnapshot, detectIndent, generateTsconfigs, getPath, getSnapshot, hasOverrideKeys, hasPath, index_d_exports, isAppliedOverride, mergeOverride, overrideLeaves, parseTsconfig, readTsconfig, recordOverrideSnapshot, removedOverrideLeaves, renderMonorepoTsconfig, renderTsconfigBase, renderTsconfigBuild, renderTsconfigDefault, renderTsconfigTemplates, resolveTsconfig, restoreTsconfigOverrides, revertOverride, runTsconfigCli, setSnapshot, stringifyTsconfig, toRepoRelative, tsconfigBaseTemplate, tsconfigBuildTemplate, tsconfigDefaultTemplate, tsconfigFileNames, tsconfigSyncTask };

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

@@ -1 +1 @@
-import"node:path";import"node:url";import.meta.url;import{__exportAll as e}from"../../../_virtual/_rolldown/runtime.js";import{generateTsconfigs as t,runTsconfigCli as n}from"./cli/generate/index.js";import{tsconfigSyncTask as r}from"./sync.js";import{DEFAULT_TSCONFIG_REPLACEMENTS as i,buildMonorepoTsconfig as a,renderMonorepoTsconfig as o,renderTsconfigBase as s,renderTsconfigBuild as c,renderTsconfigDefault as l,renderTsconfigTemplates as u,tsconfigBaseTemplate as d,tsconfigBuildTemplate as f,tsconfigDefaultTemplate as p}from"./templates.js";var m=/* @__PURE__ */ e({DEFAULT_TSCONFIG_REPLACEMENTS:()=>i,buildMonorepoTsconfig:()=>a,generateTsconfigs:()=>t,renderMonorepoTsconfig:()=>o,renderTsconfigBase:()=>s,renderTsconfigBuild:()=>c,renderTsconfigDefault:()=>l,renderTsconfigTemplates:()=>u,runTsconfigCli:()=>n,tsconfigBaseTemplate:()=>d,tsconfigBuildTemplate:()=>f,tsconfigDefaultTemplate:()=>p,tsconfigSyncTask:()=>r});export{i as DEFAULT_TSCONFIG_REPLACEMENTS,a as buildMonorepoTsconfig,t as generateTsconfigs,o as renderMonorepoTsconfig,s as renderTsconfigBase,c as renderTsconfigBuild,l as renderTsconfigDefault,u as renderTsconfigTemplates,n as runTsconfigCli,m as src_exports,d as tsconfigBaseTemplate,f as tsconfigBuildTemplate,p as tsconfigDefaultTemplate,r as tsconfigSyncTask};
+import"node:path";import"node:url";import.meta.url;import{__exportAll as e}from"../../../_virtual/_rolldown/runtime.js";import{TSCONFIG_OVERRIDE_KINDS as t,addedOverrideLeaves as n,applyOverride as r,getPath as i,hasOverrideKeys as a,hasPath as o,isAppliedOverride as s,mergeOverride as c,overrideLeaves as l,recordOverrideSnapshot as u,removedOverrideLeaves as d,revertOverride as f}from"./overrides.js";import{parseTsconfig as p,readTsconfig as m,resolveTsconfig as h}from"./resolve.js";import{generateTsconfigs as g,runTsconfigCli as _}from"./cli/generate/index.js";import{TSCONFIG_MANIFEST_PATH as v,deleteSnapshot as y,detectIndent as b,getSnapshot as x,restoreTsconfigOverrides as S,setSnapshot as C,stringifyTsconfig as w,toRepoRelative as T}from"./snapshots.js";import{tsconfigFileNames as E,tsconfigSyncTask as D}from"./sync.js";import{DEFAULT_TSCONFIG_REPLACEMENTS as O,buildMonorepoTsconfig as k,renderMonorepoTsconfig as A,renderTsconfigBase as j,renderTsconfigBuild as M,renderTsconfigDefault as N,renderTsconfigTemplates as P,tsconfigBaseTemplate as F,tsconfigBuildTemplate as I,tsconfigDefaultTemplate as L}from"./templates.js";var R=/* @__PURE__ */ e({DEFAULT_TSCONFIG_REPLACEMENTS:()=>O,TSCONFIG_MANIFEST_PATH:()=>v,TSCONFIG_OVERRIDE_KINDS:()=>t,addedOverrideLeaves:()=>n,applyOverride:()=>r,buildMonorepoTsconfig:()=>k,deleteSnapshot:()=>y,detectIndent:()=>b,generateTsconfigs:()=>g,getPath:()=>i,getSnapshot:()=>x,hasOverrideKeys:()=>a,hasPath:()=>o,isAppliedOverride:()=>s,mergeOverride:()=>c,overrideLeaves:()=>l,parseTsconfig:()=>p,readTsconfig:()=>m,recordOverrideSnapshot:()=>u,removedOverrideLeaves:()=>d,renderMonorepoTsconfig:()=>A,renderTsconfigBase:()=>j,renderTsconfigBuild:()=>M,renderTsconfigDefault:()=>N,renderTsconfigTemplates:()=>P,resolveTsconfig:()=>h,restoreTsconfigOverrides:()=>S,revertOverride:()=>f,runTsconfigCli:()=>_,setSnapshot:()=>C,stringifyTsconfig:()=>w,toRepoRelative:()=>T,tsconfigBaseTemplate:()=>F,tsconfigBuildTemplate:()=>I,tsconfigDefaultTemplate:()=>L,tsconfigFileNames:()=>E,tsconfigSyncTask:()=>D});export{O as DEFAULT_TSCONFIG_REPLACEMENTS,v as TSCONFIG_MANIFEST_PATH,t as TSCONFIG_OVERRIDE_KINDS,n as addedOverrideLeaves,r as applyOverride,k as buildMonorepoTsconfig,y as deleteSnapshot,b as detectIndent,g as generateTsconfigs,i as getPath,x as getSnapshot,a as hasOverrideKeys,o as hasPath,s as isAppliedOverride,c as mergeOverride,l as overrideLeaves,p as parseTsconfig,m as readTsconfig,u as recordOverrideSnapshot,d as removedOverrideLeaves,A as renderMonorepoTsconfig,j as renderTsconfigBase,M as renderTsconfigBuild,N as renderTsconfigDefault,P as renderTsconfigTemplates,h as resolveTsconfig,S as restoreTsconfigOverrides,f as revertOverride,_ as runTsconfigCli,C as setSnapshot,R as src_exports,w as stringifyTsconfig,T as toRepoRelative,F as tsconfigBaseTemplate,I as tsconfigBuildTemplate,L as tsconfigDefaultTemplate,E as tsconfigFileNames,D as tsconfigSyncTask};

package/dist/packages/tsconfig/src/overrides.d.ts

@@ -0,0 +1,74 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+import { ToolchainTsconfigOverrides } from "../../shared/src/config-types.js";
+import "../../shared/src/index.js";
+import { TsConfigJson } from "type-fest";
+//#region packages/tsconfig/src/overrides.d.ts
+/** The file an override targets. */
+export type TsconfigOverrideKind = 'base' | 'root' | 'default' | 'build';
+/** Every override kind, in the order the sync task applies them. */
+export declare const TSCONFIG_OVERRIDE_KINDS: readonly TsconfigOverrideKind[];
+/** The `tsconfig.overrides` config section. */
+export type TsconfigOverrides = ToolchainTsconfigOverrides;
+/** One applied override, as recorded in the manifest. */
+export interface AppliedOverride {
+  kind: TsconfigOverrideKind;
+  override: TsConfigJson;
+}
+/** Applied overrides keyed by repo-relative file path. */
+export type OverridesState = Record<string, AppliedOverride>;
+/** A leaf value set by an override, addressed by its object path. */
+export interface OverrideLeaf {
+  path: string[];
+  value: unknown;
+}
+/** The outcome of {@link revertOverride}. */
+export interface RevertOverrideResult {
+  /** Dotted keys that were removed or restored to their snapshot value. */
+  reverted: string[];
+  /** Dotted keys left alone because they changed after the override applied them. */
+  kept: string[];
+}
+type JsonObject = Record<string, unknown>;
+/** Whether `value` is a plain object with at least one key. */
+export declare function hasOverrideKeys(value: unknown): value is JsonObject;
+/** Whether `path` exists in `target` (walking plain objects only). */
+export declare function hasPath(target: unknown, path: string[]): boolean;
+/** The value at `path`, or `undefined`. */
+export declare function getPath(target: unknown, path: string[]): unknown;
+/**
+ * The leaf values an override sets. Objects are walked (they merge); arrays,
+ * scalars and empty objects are leaves (they replace).
+ */
+export declare function overrideLeaves(override: object | undefined, base?: string[]): OverrideLeaf[];
+/** The leaves of `previous` that `next` no longer sets. */
+export declare function removedOverrideLeaves(previous: object | undefined, next: object | undefined): OverrideLeaf[];
+/** The leaves of `next` that `previous` did not set yet. */
+export declare function addedOverrideLeaves(previous: object | undefined, next: object | undefined): OverrideLeaf[];
+/** Deep-merge `override` into `target` in place (objects merge, the rest replaces). */
+export declare function applyOverride(target: JsonObject, override: object): void;
+/** Deep-merge an override into a copy of `target` (for in-memory use). */
+export declare function mergeOverride<T extends object>(target: T, override?: object): T;
+/**
+ * Revert override `leaves` from `target`, using `snapshot` (the original file)
+ * to decide what each key goes back to:
+ *
+ * - the key still holds the override's value and the snapshot defines it: the
+ *   snapshot value is restored (the original already had the key);
+ * - the key still holds the override's value and the snapshot does not define
+ *   it: the key is removed, along with any parent object the override created
+ *   that is now empty;
+ * - the key holds another value: it was edited after the override applied it,
+ *   so it is kept.
+ */
+export declare function revertOverride(target: JsonObject, leaves: OverrideLeaf[], snapshot: unknown): RevertOverrideResult;
+/**
+ * Record the current values of newly overridden keys in `snapshot`, so a key
+ * the user added after the snapshot was taken is restored (not removed) when the
+ * override is dropped again.
+ */
+export declare function recordOverrideSnapshot(snapshot: JsonObject, current: unknown, leaves: OverrideLeaf[]): void;
+/** Whether a manifest value is a well-formed {@link AppliedOverride}. */
+export declare function isAppliedOverride(value: unknown): value is AppliedOverride;
+//#endregion
+export {};

package/dist/packages/tsconfig/src/overrides.js

@@ -0,0 +1 @@
+import"node:path";import"node:url";import.meta.url;import{isDeepStrictEqual as e}from"node:util";const t=[`base`,`root`,`default`,`build`];function n(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function r(e){return structuredClone(e)}function i(e){return n(e)&&Object.keys(e).length>0}function a(e,t){let r=e;for(let e of t){if(!n(r)||!Object.prototype.hasOwnProperty.call(r,e))return!1;r=r[e]}return!0}function o(e,t){let r=e;for(let e of t){if(!n(r))return;r=r[e]}return r}function s(e,t,r){let i=e;for(let e of t.slice(0,-1))n(i[e])||(i[e]={}),i=i[e];i[t[t.length-1]]=r}function c(e,t){let r=o(e,t.slice(0,-1));n(r)&&delete r[t[t.length-1]]}function l(e,t=[]){let n=[];if(!e)return n;for(let[r,a]of Object.entries(e)){let e=[...t,r];i(a)?n.push(...l(a,e)):n.push({path:e,value:a})}return n}function u(e,t){return l(e).filter(e=>!a(t,e.path))}function d(e,t){return l(t).filter(t=>!a(e,t.path))}function f(e,t){for(let[i,a]of Object.entries(t))n(a)?(n(e[i])||(e[i]={}),f(e[i],a)):e[i]=r(a)}function p(e,t){if(!t)return e;let n=r(e);return f(n,t),n}function m(t,i,l){let u={reverted:[],kept:[]};for(let d of i){let i=d.path.join(`.`);if(a(t,d.path)){if(!e(o(t,d.path),d.value))u.kept.push(i);else if(u.reverted.push(i),a(l,d.path))s(t,d.path,r(o(l,d.path)));else{c(t,d.path);for(let e=d.path.length-1;e>0;e--){let r=d.path.slice(0,e),i=o(t,r);if(!n(i)||Object.keys(i).length>0||a(l,r))break;c(t,r)}}}}return u}function h(e,t,n){for(let i of n)a(t,i.path)?s(e,i.path,r(o(t,i.path))):a(e,i.path)&&c(e,i.path)}function g(e){return n(e)&&t.includes(e.kind)&&n(e.override)}export{t as TSCONFIG_OVERRIDE_KINDS,d as addedOverrideLeaves,f as applyOverride,o as getPath,i as hasOverrideKeys,a as hasPath,g as isAppliedOverride,p as mergeOverride,l as overrideLeaves,h as recordOverrideSnapshot,u as removedOverrideLeaves,m as revertOverride};

package/dist/packages/tsconfig/src/resolve.d.ts

@@ -0,0 +1,62 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+//#region packages/tsconfig/src/resolve.d.ts
+/**
+ * Resolve a `tsconfig.json` into Vite/Vitest aliases plus its project paths and
+ * references.
+ *
+ * `extends` is followed per field: a child can define `paths` while inheriting
+ * `references` (or the other way around), and the nearest definition wins.
+ */
+/** A Vite/Vitest compatible alias entry. */
+export interface TsconfigAlias {
+  find: string | RegExp;
+  replacement: string;
+}
+/** A resolved project reference. */
+export interface TsconfigReference {
+  /** Absolute path to the referenced tsconfig file. */
+  path: string;
+  [key: string]: unknown;
+}
+/** The result of {@link resolveTsconfig}. */
+export interface ResolvedTsconfig {
+  /** Vite/Vitest `resolve.alias` entries (absolute replacements). */
+  alias: TsconfigAlias[];
+  /** Resolved `compilerOptions.paths` (absolute targets). */
+  paths: Record<string, string[]>;
+  /** Resolved project references (absolute paths). */
+  references: TsconfigReference[];
+}
+export interface ResolveTsconfigOptions {
+  /** Explicit tsconfig file (relative to `cwd`/`root`, or absolute). */
+  tsconfig?: string;
+  /** Directory used to resolve a relative `tsconfig` and to detect the config. */
+  cwd?: string;
+  /** Repo/workspace root (default: `cwd`). Used to detect the default config. */
+  root?: string;
+  /** Follow `extends` (default true). */
+  extends?: boolean;
+  /** Deep-merged into the selected config before reading its fields. */
+  overrides?: object;
+}
+export interface TsconfigJson {
+  extends?: string | string[];
+  compilerOptions?: {
+    baseUrl?: string;
+    paths?: Record<string, string[] | string>;
+  };
+  references?: {
+    path: string;
+    [key: string]: unknown;
+  }[];
+}
+/** Read a tsconfig file (JSONC: comments + trailing commas are allowed). */
+export declare function readTsconfig(file: string): TsconfigJson;
+/** Parse JSONC tsconfig text (comments, trailing commas and a BOM are allowed). */
+export declare function parseTsconfig(text: string): TsconfigJson;
+/**
+ * Resolve a tsconfig's `paths` and `references`, following `extends` per field.
+ */
+export declare function resolveTsconfig(options?: ResolveTsconfigOptions): ResolvedTsconfig;
+//#endregion