@deltabox/toolchain 1.11.3 → 2.0.0

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

@@ -1,6 +1,6 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
-import { ToolchainChangelogConfig } from "../../shared/src/config-types.js";
+import { ChangelogConfig } from "../../shared/src/config-types.js";
 import "../../shared/src/index.js";
 import { parseArgsCli } from "./utils/args.js";
 import { formatBody, groupItems, parseCcSubject, renderGroups, ruleTitle, splitInlineDescription } from "./utils/format.js";
@@ -11,10 +11,10 @@ import { renderChangelogEntry } from "./utils/version.js";
 //#region packages/changelog/src/run.d.ts
 /**
  * Run the changelog pipeline (bump versions + write changelogs). `changelog` is
- * the consumer's `toolchain.changelog` section (threaded from `dbx changelog`);
+ * the consumer's `toolchain.ci.changelog` config (threaded from `dbx changelog`);
  * the standalone bin runs with the defaults (`versioning: true`, uniform).
  */
-export declare function runChangelog(argv?: string[], changelog?: ToolchainChangelogConfig): void;
+export declare function runChangelog(argv?: string[], changelog?: ChangelogConfig): void;
 /** Alias kept for backwards compatibility. */
 export declare const main: typeof runChangelog;
 //#endregion

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

@@ -1 +1 @@
-import{resolve as e}from"node:path";import{fileURLToPath as t}from"node:url";import.meta.url;import{logger as n}from"../../shared/src/logger.js";import"../../shared/src/index.js";import{parseArgsCli as r}from"./utils/args.js";import{deriveBump as i,readCommits as a}from"./utils/git.js";import{changelogFiles as o,readRootVersion as s,repoRoot as c,writeVersion as l}from"./utils/repo.js";import{packageChangesForCurrent as u}from"./utils/packages.js";import"./utils/format.js";import{insertNewEntry as d,renderChangelogEntry as f,retagChangelogs as p}from"./utils/version.js";import{formatExistingChangelogs as m,parseExistingChangelog as h,reformatRootChangelog as g}from"./utils/reformat.js";import{buildSummary as _}from"./utils/summary.js";import{planVersions as v,resolveVersioning as y,writePackageVersion as b}from"./utils/versioning.js";import{writeChangelogs as x}from"./utils/write.js";import{existsSync as S,readFileSync as C,realpathSync as w,writeFileSync as T}from"node:fs";function E(t=process.argv.slice(2),w){let E=r(t);if(E.formatOnly){n.info(`[format-only] Reformatting ${o().length} changelog file(s)${E.dryRun?` (dry run)`:``}.`),m(E.dryRun,E.packageChanges);return}let D=s();if(E.version){let e=E.version.trim();if(!/^\d+\.\d+\.\d+$/.test(e))throw Error(`Invalid version: ${e}`);if(e===D){n.info(`Version is already ${e}; nothing to do.`);return}l(e),p(D,e),n.info(`Retagged versions ${D} -> ${e}.`);return}let O=D;if(E.baseVersion){if(!/^\d+\.\d+\.\d+$/.test(E.baseVersion.trim()))throw Error(`Invalid base version: ${E.baseVersion}`);O=E.baseVersion.trim()}let k=E.processingMethod,A=k===`all`,j=k!==`latest`&&k!==`all`?k:E.range,M=a(j),N=i(M),P=_(M),F=y(w),I=v({versioning:F,rootVersion:O,bump:N,range:j}),L=I.rootVersion;if(E.dryRun){let t=c(),r=e(t,`CHANGELOG.md`),i=S(r)?C(r,`utf8`):``,a=h(i)[0]?.version,o=E.packageChanges&&a?u(a):``,s=f(L,P,/* @__PURE__ */ new Date,!0,o);n.info(`[DRY-RUN] Range: ${j}`),n.info(`[DRY-RUN] Processing method: ${k}${A?` (backward reformat)`:``}`),n.info(`[DRY-RUN] Bump: ${N} (\`${O}\` -> \`${L}\`)`),n.info(`[DRY-RUN] Versioning: ${F.enabled?F.target:`disabled`}`),n.info(`[DRY-RUN] ${M.length} commit(s) scanned. Project files untouched.`),n.info(``),n.info(`Proposed new CHANGELOG.md entry (new version only):`),n.info(``),n.raw(s),n.info(`--- end of proposed entry ---`);let l=A?g(E.packageChanges):i,p=d(l,s),m=e(t,`CHANGELOG.proposed.md`);T(m,p,`utf8`),n.info(`Wrote ${m}`)}else{for(let[e,t]of I.writes)b(e,t);x(L,j,M,P,A,E.packageChanges,I.entries),F.enabled?n.info(`Bumped ${O} -> ${L} (${N}) from ${M.length} commit(s).`):n.info(`Wrote changelogs for ${L} (${N}) from ${M.length} commit(s); versioning disabled.`)}}const D=E,O=t(import.meta.url);process.argv[1]&&/[\\/]run\.[cm]?[jt]s$/.test(O)&&k(process.argv[1])===O&&E();function k(e){try{return w(e)}catch{return e}}export{D as main,E as runChangelog};
+import{resolve as e}from"node:path";import{fileURLToPath as t}from"node:url";import.meta.url;import{logger as n}from"../../shared/src/logger.js";import{resolveCommitlintEnabled as r}from"../../shared/src/toolchain.js";import"../../shared/src/index.js";import{parseArgsCli as i}from"./utils/args.js";import{readCommits as a}from"./utils/git.js";import{changelogFiles as o,readRootVersion as s,repoRoot as c,writeVersion as l}from"./utils/repo.js";import{packageChangesForCurrent as u}from"./utils/packages.js";import"./utils/format.js";import{insertNewEntry as d,renderChangelogEntry as f,retagChangelogs as p}from"./utils/version.js";import{formatExistingChangelogs as m,parseExistingChangelog as h,reformatRootChangelog as g}from"./utils/reformat.js";import{buildSummary as _}from"./utils/summary.js";import{deriveCustomBump as v,planVersions as y,resolveVersioning as b,writePackageVersion as x}from"./utils/versioning.js";import{writeChangelogs as S}from"./utils/write.js";import{existsSync as C,readFileSync as w,realpathSync as T,writeFileSync as E}from"node:fs";import{spawnSync as D}from"node:child_process";function O(t=process.argv.slice(2),T){let O=i(t),k=T?.groups;if(O.formatOnly){n.info(`[format-only] Reformatting ${o().length} changelog file(s)${O.dryRun?` (dry run)`:``}.`),m(O.dryRun,O.packageChanges,k);return}let A=s();if(O.version){let e=O.version.trim();if(!/^\d+\.\d+\.\d+$/.test(e))throw Error(`Invalid version: ${e}`);if(e===A){n.info(`Version is already ${e}; nothing to do.`);return}l(e),p(A,e),n.info(`Retagged versions ${A} -> ${e}.`);return}let j=A;if(O.baseVersion){if(!/^\d+\.\d+\.\d+$/.test(O.baseVersion.trim()))throw Error(`Invalid base version: ${O.baseVersion}`);j=O.baseVersion.trim()}let M=O.processingMethod,N=M===`all`,P=M!==`latest`&&M!==`all`?M:O.range,F=a(P),I=b(T),L=I.provider;if(!O.dryRun&&L===`changesets`){if(D(`npx`,[`--yes`,`changeset`,`version`],{cwd:c(),stdio:`inherit`,shell:process.platform===`win32`}).status!==0)throw Error(`changesets provider failed.`);n.info(`Ran the changesets provider; changesets owns the changelog/version output.`);return}let R=v(F,I.bump,I.allowOverBump),z=r(T),B=_(F,{commitlint:z,range:P,...k?{groups:k}:{},...I.commit?{commit:I.commit}:{}});if(L&&typeof L==`object`&&typeof L.run==`function`){let e=L.run({cwd:c(),changelog:T,records:F});typeof e==`string`&&(B=e)}else if(typeof L==`function`){let e=L({cwd:c(),changelog:T,records:F});typeof e==`string`&&(B=e)}let V=y({versioning:I,rootVersion:j,bump:R,range:P,...I.bump?{bumpRules:I.bump}:{},...I.allowOverBump?{allowOverBump:!0}:{}}),H=V.rootVersion;if(O.dryRun){let t=c(),r=e(t,`CHANGELOG.md`),i=C(r)?w(r,`utf8`):``,a=h(i)[0]?.version,o=O.packageChanges&&a?u(a):``,s=f(H,B,/* @__PURE__ */ new Date,!0,o);n.info(`[DRY-RUN] Range: ${P}`),n.info(`[DRY-RUN] Processing method: ${M}${N?` (backward reformat)`:``}`),n.info(`[DRY-RUN] Bump: ${R} (\`${j}\` -> \`${H}\`)`),n.info(`[DRY-RUN] Versioning: ${I.enabled?I.target:`disabled`}`),n.info(`[DRY-RUN] ${F.length} commit(s) scanned. Project files untouched.`),n.info(``),n.info(`Proposed new CHANGELOG.md entry (new version only):`),n.info(``),n.raw(s),n.info(`--- end of proposed entry ---`);let l=N?g(O.packageChanges,k):i,p=d(l,s),m=e(t,`CHANGELOG.proposed.md`);E(m,p,`utf8`),n.info(`Wrote ${m}`)}else{for(let[e,t]of V.writes)x(e,t);S(H,P,F,B,N,O.packageChanges,V.entries,z,k),I.enabled?n.info(`Bumped ${j} -> ${H} (${R}) from ${F.length} commit(s).`):n.info(`Wrote changelogs for ${H} (${R}) from ${F.length} commit(s); versioning disabled.`)}}const k=O,A=t(import.meta.url);process.argv[1]&&/[\\/]run\.[cm]?[jt]s$/.test(A)&&j(process.argv[1])===A&&O();function j(e){try{return T(e)}catch{return e}}export{k as main,O as runChangelog};

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

@@ -19,12 +19,15 @@ export declare const HOOK_HEADER = "# Generated by @deltabox/toolchain — edit
 export declare function commitMsgHook(commitlintPath?: string): string;
 /** The default husky `commit-msg` hook body (config at the project root). */
 export declare const COMMIT_MSG_HOOK: string;
-/** The workflow file names produced for a config. */
+/** The workflow file paths produced for a config. */
+export declare function workflowFilePaths(config: ToolchainConfig): string[];
+/** The workflow file names (basenames) produced for a config. */
 export declare function workflowFilenames(config: ToolchainConfig): string[];
 /**
- * The changelog sync task: writes the GitHub workflows, the commitlint config
- * and the husky `commit-msg` hook from the loaded `dbx.config.*`. Branches,
- * triggers, steps, jobs and per-workflow tokens are all taken from the config.
+ * The CI/changelog sync task: writes the opted-in GitHub workflows, the
+ * commitlint config and the husky `commit-msg` hook from the loaded
+ * `dbx.config.*`. Branches, triggers, steps, jobs and per-workflow tokens are
+ * all taken from the config.
  */
 export declare function changelogSyncTask(): SyncTask;
 //#endregion

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

@@ -1 +1 @@
-import"node:path";import"node:url";import.meta.url;import{resolveChangelogBranches as e,sectionConfig as t,sectionEnabled as n}from"../../shared/src/toolchain.js";import"../../shared/src/index.js";import{WORKFLOW_FILENAMES as r,isEnabled as i,renderWorkflow as a,renderWorkflows as o}from"./workflows.js";import{renderCommitlintConfig as s}from"./templates.js";function c(e,t){return e===!1?{enabled:!1}:typeof e==`string`?e:e===!0||e===void 0?{pushBranches:t}:{pushBranches:t,...e}}function l(e,t){return{...e,ci:c(e.ci,t.main),release:c(e.release,t.main),changelog:c(e.changelog,t.dev),sync:c(e.sync,[.../* @__PURE__ */ new Set([...t.main,...t.dev])])}}const u="# Generated by @deltabox/toolchain — edit dbx.config.* and run `dbx sync`.",d="// Generated by @deltabox/toolchain — edit dbx.config.* and run `dbx sync`.",f="# Generated by @deltabox/toolchain — edit dbx.config.* and run `dbx sync`.";function p(e){let t=`npx --no -- commitlint --edit "$1"`;return e?`${t} --config ${e}`:t}const m=p();function h(e){return e?e.replace(/\\/g,`/`).replace(/^\.?\//,``).replace(/\/+$/,``):``}function g(e){return Object.keys(o({},t(e.changelog)?.workflows??{}))}function _(){return{name:`changelog`,projectTypes:[`monorepo-root`,`project`],enabled:e=>n(e.changelog),run:n=>{let o=t(n.config.changelog)??{},c=[],m=h(o.commitlint?.dir),g=m?`${m}/commitlint.config.mjs`:`commitlint.config.mjs`,_=l(o.workflows??{},e(o)),v={...n.tokens,commitlintConfig:g};for(let[e,t]of Object.entries(r)){let n=_[e];if(!i(n))continue;let r=typeof n==`string`,o=r?n:a(e,{tokens:v,config:typeof n==`object`?n:{}});o&&c.push({path:`.github/workflows/${t}`,content:r?o:`${u}\n${o}`})}return c.push({path:g,content:`${d}\n${s({...o.types?{types:o.types}:{},...o.scopes?{scopes:o.scopes}:{}})}`}),c.push({path:`.husky/commit-msg`,content:`${f}\n${p(m?g:void 0)}\n`}),c}}}export{d as COMMITLINT_HEADER,m as COMMIT_MSG_HOOK,f as HOOK_HEADER,u as WORKFLOW_HEADER,_ as changelogSyncTask,p as commitMsgHook,g as workflowFilenames};
+import{default as e}from"node:path";import"node:url";import.meta.url;import{changelogSectionEnabled as t,resolveChangelogBranches as n,resolveChangelogConfig as r,resolveCommitlintEnabled as i,sectionConfig as a,sectionEnabled as o}from"../../shared/src/toolchain.js";import"../../shared/src/index.js";import{WORKFLOW_FILENAMES as s,isEnabled as c,renderCustomWorkflow as l,renderWorkflow as u,workflowFilePath as d}from"./workflows.js";import{renderCommitlintConfig as f}from"./templates.js";import p from"node:fs";function m(e,t){return e===!1?{enabled:!1}:typeof e==`string`?e:e===!0||e===void 0?{pushBranches:t}:{pushBranches:t,...e}}function h(e){let t=o(e.ci)?a(e.ci)??{}:{};return{ci:t.ci,changelog:t.changelog,release:t.release,issues:t.issues,sync:t.sync}}function g(e,t){let n={...e},r=(e,t)=>{n[e]!==void 0&&(n[e]=m(n[e],t))};return r(`ci`,t.main),r(`release`,t.main),r(`changelog`,t.dev),r(`sync`,[.../* @__PURE__ */ new Set([...t.main,...t.dev])]),n}const _="# Generated by @deltabox/toolchain — edit dbx.config.* and run `dbx sync`.",v="// Generated by @deltabox/toolchain — edit dbx.config.* and run `dbx sync`.",y="# Generated by @deltabox/toolchain — edit dbx.config.* and run `dbx sync`.";function b(e){let t=`npx --no -- commitlint --edit "$1"`;return e?`${t} --config ${e}`:t}const x=b();function S(e){return e?e.replace(/\\/g,`/`).replace(/^\.?\//,``).replace(/\/+$/,``):``}function C(e){let t=h(e),n=[];for(let[e,r]of Object.entries(s)){let i=t[e];c(i)&&n.push(d(e,i,r))}let r=o(e.ci)?a(e.ci)?.custom??{}:{};for(let[e,t]of Object.entries(r)){let r=t;c(r)&&n.push(d(e,r))}return[...new Set(n)]}function w(e){return[...new Set(C(e).map(e=>e.split(`/`).pop()??e))]}function T(){return{name:`changelog`,projectTypes:[`monorepo-root`,`project`],enabled:e=>o(e.ci),run:m=>{let x=r(m.config)??{},C=a(x.commitlint),w=t(m.config)&&i(x),T=[],E=/* @__PURE__ */ new Set,D={},O=new Set(m.managedFiles??[]),k=t=>{if(O.has(t))return!0;let n=e.resolve(m.cwd,t);if(!p.existsSync(n))return!0;try{return p.readFileSync(n,`utf-8`).replace(/^\uFEFF/,``).startsWith(_)}catch{return!1}},A=(e,t,n,r=!1)=>{if(E.has(t))m.warn(`changelog: workflow path "${t}" is declared more than once; skipping the duplicate.`);else if(k(t))E.add(t),T.push({path:t,content:n});else{let n=r?`ci.custom.${e}`:`ci.${e}`;D[t]=n,m.warn(`changelog: ${t} already exists and is not managed by dbx; leaving it untouched. Set \`${n}: { enabled: false }\` in dbx.config to keep it explicit.`,`changelog.existing-workflow`)}},j=S(C?.dir),M=j?`${j}/commitlint.config.mjs`:`commitlint.config.mjs`,N=g(h(m.config),n(x)),P={...m.tokens,commitlintConfig:M};for(let[e,t]of Object.entries(s)){let n=N[e];if(!c(n))continue;let r=typeof n==`string`,i=r?n:u(e,{tokens:P,config:typeof n==`object`?n:{},commitlint:w});i&&A(e,d(e,n,t),r?i:`${_}\n${i}`)}let F=o(m.config.ci)?a(m.config.ci)?.custom??{}:{};for(let[e,t]of Object.entries(F)){let n=t;if(!c(n))continue;let r=typeof n==`string`,i=r?n:l(e,{tokens:P,config:typeof n==`object`?n:{},commitlint:w});i&&A(e,d(e,n),r?i:`${_}\n${i}`,!0)}return w&&(T.push({path:M,content:`${v}\n${f({...C?.types?{types:C.types}:{},...C?.scopes?{scopes:C.scopes}:{}})}`}),T.push({path:`.husky/commit-msg`,content:`${y}\n${b(j?M:void 0)}\n`})),m.manifest&&(Object.keys(D).length>0?m.manifest.workflowConflicts=D:delete m.manifest.workflowConflicts),T}}}export{v as COMMITLINT_HEADER,x as COMMIT_MSG_HOOK,y as HOOK_HEADER,_ as WORKFLOW_HEADER,T as changelogSyncTask,b as commitMsgHook,C as workflowFilePaths,w as workflowFilenames};

package/dist/packages/changelog/src/utils/format.d.ts

@@ -1,12 +1,13 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
+import { ChangelogGroupsSetting } from "../../../shared/src/changelog-groups.js";
 import { GroupedItem, GroupedRule, ParsedCommit } from "./types.js";
 //#region packages/changelog/src/utils/format.d.ts
 export declare function ruleTitle(type: string): string;
 /** Parse a Conventional-Commits subject into its parts. */
 export declare function parseCcSubject(subject: string): ParsedCommit;
 /** Group a list of parsed commits by CC rule, then by scope. */
-export declare function groupItems(items: GroupedItem[]): GroupedRule[];
+export declare function groupItems(items: GroupedItem[], setting?: ChangelogGroupsSetting): GroupedRule[];
 export declare function renderGroups(groups: GroupedRule[]): string;
 /**
  * Split a changelog bullet's trailing inline content (after the commit credit

package/dist/packages/changelog/src/utils/format.js

@@ -1,5 +1,5 @@
-import"node:path";import"node:url";import.meta.url;import{logger as e}from"../../../shared/src/logger.js";import{sanitizeText as t}from"../../../shared/src/string-utils.js";import"../../../shared/src/index.js";import{readFileSync as n,writeFileSync as r}from"node:fs";const i={feat:`New features`,fix:`Bug fixes`,refactor:`Refactors`,docs:`Documentation`,style:`Styles`,chore:`Chores`,test:`Tests`,perf:`Performance`,build:`Build system`,ci:`CI`,revert:`Reverts`,breaking:`Breaking changes`},a=[`breaking`,`feat`,`fix`,`perf`,`refactor`,`docs`,`style`,`test`,`build`,`ci`,`chore`,`revert`];function o(e){return i[e]??i[e.toLowerCase()]??`Other changes`}function s(e){let t=/^([a-zA-Z][a-zA-Z0-9]*)(\(([^)]*)\))?(!)?:\s*(.*)$/.exec(e);return t?{type:t[1].toLowerCase(),scope:t[3]?.trim()||void 0,breaking:!!t[4],rest:t[5]??``}:{type:`chore`,breaking:!1,rest:e}}function c(e){let t=/* @__PURE__ */ new Map;for(let n of e){let{parsed:e}=n,r=t.get(e.type)??{title:o(e.type),ungrouped:[],scopes:/* @__PURE__ */ new Map};if(e.scope){let t=r.scopes.get(e.scope)??[];t.push(n),r.scopes.set(e.scope,t)}else r.ungrouped.push(n);t.set(e.type,r)}return[...t.entries()].sort((e,t)=>{let n=a.indexOf(e[0]),r=a.indexOf(t[0]);return(n===-1?a.length:n)-(r===-1?a.length:r)}).map(([,e])=>e)}function l(e){if(e.length===0)return`- No description provided.`;let t=[];for(let n of e){t.push(`### ${n.title}`);for(let e of n.ungrouped)t.push(e.text),t.push(...u(e.bodyParagraphs));for(let[e,r]of n.scopes){t.push(`#### ${d(e)}`);for(let e of r)t.push(e.text),t.push(...u(e.bodyParagraphs))}}return t.join(`
-`)}function u(e){let t=[];for(let n of e){let[e,...r]=n;e&&(t.push(`  - ${e}`),t.push(...r.map(e=>`    ${e}`)))}return t}function d(e){return e.charAt(0).toUpperCase()+e.slice(1)}function f(e){return e.length>0?e.charAt(0).toUpperCase()+e.slice(1):e}function p(e){let t=e.lastIndexOf(`([#`);if(t===-1)return{main:e,inline:``};let n=e.slice(t),r=/^(\(\[#[^\]]+\]\([^)]*\) by [^)]*\)\)?)(?:\(fixes [^)]*\)\)?)?/.exec(n);if(!r)return{main:e,inline:``};let i=r[0]??``;return{main:e.slice(0,t)+i,inline:e.slice(t+i.length).trim()}}function m(e){let n=[],r=[];for(let i of e.split(`
-`)){let e=t(i.trim());if(!e){r.length>0&&(n.push(r),r=[]);continue}if(e.startsWith(`-`)||e.startsWith(`*`)||/^[0-9]+[.)]/.test(e)||!e.replace(/(?:close[sd]?|fixe?s|fixed|resolves?|resolved)\b\s*:?\s*#\d+\s*[,;]?\s*/gi,``).trim())continue;let a=/^(BREAKING CHANGE|Reviewed-by|Signed-off-by|Co-authored-by|Acked-by|Co-developed-by|Helped-by|Reported-by|Suggested-by|Tested-by|Cc):\s+(.+)$/i.exec(e);a&&!/^(http|https)\b/.test(e)?(r.length>0&&(n.push(r),r=[]),n.push([`**${(a[1]??``).trim()}:** ${(a[2]??``).trim()}`])):r.push(e)}return r.length>0&&n.push(r),n}function h(e,t){return`https://github.com/${e}/commit/${t}`}function g(e,t){return`https://github.com/${e}/issues/${t}`}function _(e,t){return e.replace(/\[(#[0-9a-fA-F]{6,40})\]\(([^)]*)\)/g,(e,n)=>{let r=n.replace(`#`,``).slice(0,7);return`[#${r}](${h(t,r)})`}).replace(/(^|[^\w[])#([0-9a-fA-F]{7,40})(?![0-9a-fA-F])(?=[)\].,;:\s]|$)/g,(e,n,r)=>{let i=r.slice(0,7);return`${n}[#${i}](${h(t,i)})`})}function v(e,t){return e.replace(/\[#(\d+)(?=[ \]])(?:[^\]]*)\]\([^)]*\)/g,(e,n)=>`[#${n}](${g(t,n)})`).replace(/(^|[^\w[])#(\d+)(?=[)\].,;:\s]|$)/g,(e,n,r)=>`${n}[#${r}](${g(t,r)})`)}function y(e,t){if(!t)return e;let n=_(e,t);return n=v(n,t),n}function b(t,i){if(!i)return;let a=n(t,`utf8`),o=a.split(`
-`).map(e=>y(e,i)).join(`
-`);o!==a&&(r(t,o,`utf8`),e.info(`  formatted ${t}`))}export{f as capitalize,m as formatBody,b as formatChangelogFile,y as formatLine,c as groupItems,s as parseCcSubject,l as renderGroups,o as ruleTitle,p as splitInlineDescription};
+import"node:path";import"node:url";import.meta.url;import{logger as e}from"../../../shared/src/logger.js";import{sanitizeText as t}from"../../../shared/src/string-utils.js";import"../../../shared/src/index.js";import{readFileSync as n,writeFileSync as r}from"node:fs";const i={feat:`New features`,fix:`Bug fixes`,refactor:`Refactors`,docs:`Documentation`,style:`Styles`,chore:`Chores`,test:`Tests`,perf:`Performance`,build:`Build system`,ci:`CI`,revert:`Reverts`,breaking:`Breaking changes`},a=[`breaking`,`feat`,`fix`,`perf`,`refactor`,`docs`,`style`,`test`,`build`,`ci`,`chore`,`revert`];function o(e){return i[e]??i[e.toLowerCase()]??`Other changes`}function s(e){let t=/^([a-zA-Z][a-zA-Z0-9]*)(\(([^)]*)\))?(!)?:\s*(.*)$/.exec(e);return t?{type:t[1].toLowerCase(),scope:t[3]?.trim()||void 0,breaking:!!t[4],rest:t[5]??``}:{type:`chore`,breaking:!1,rest:e}}function c(e,t){if(typeof e==`function`){let n=e(t);return typeof n==`function`?void 0:n}return e}function l(e){if(!e)return[];if(Array.isArray(e)){let t=[];for(let[n,r]of e.entries())typeof r==`string`?t.push({type:r.toLowerCase(),index:n}):r&&typeof r==`object`&&r.type&&t.push({type:r.type.toLowerCase(),...r.title===void 0?{}:{title:r.title},...r.order===void 0?{}:{order:r.order},...r.hidden===void 0?{}:{hidden:r.hidden},index:n});return t}if(typeof e!=`object`)return[];let t=[];for(let[n,[r,i]]of Object.entries(e).entries()){let e=i===!1?{hidden:!0}:i===!0||i==null?{}:typeof i==`string`?{title:i}:i;t.push({type:r.toLowerCase(),...e.title===void 0?{}:{title:e.title},...e.order===void 0?{}:{order:e.order},...e.hidden===void 0?{}:{hidden:e.hidden},index:n})}return t}function u(e,t){if(typeof e==`function`){let n=e(t);return typeof n==`string`&&n.length>0?n:t.defaultTitle}return e??t.defaultTitle}function d(e,t,n){let r=typeof e==`function`?e(n):e;return typeof r==`number`&&Number.isFinite(r)?r:t}function f(e,t){return typeof e==`function`?!!e(t):e===!0}function p(e){let t=a.indexOf(e);return t===-1?a.length:t}function m(e,t){let n=/* @__PURE__ */ new Map;for(let t of e){let{parsed:e}=t,r=n.get(e.type)??{title:o(e.type),ungrouped:[],scopes:/* @__PURE__ */ new Map};if(e.scope){let n=r.scopes.get(e.scope)??[];n.push(t),r.scopes.set(e.scope,n)}else r.ungrouped.push(t);n.set(e.type,r)}let r=[...n.keys()],i={types:r,items:e},a=l(c(t,i)),s=[],m=/* @__PURE__ */ new Set,h=-1;for(let e of a){if(m.has(e.type))continue;let t=n.get(e.type);if(!t)continue;m.add(e.type);let r=[...t.ungrouped,...[...t.scopes.values()].flat()],a={...i,type:e.type,defaultTitle:o(e.type),index:e.index,groupItems:r},c=d(e.order,e.index,a);h=Math.max(h,c),!f(e.hidden,a)&&s.push({rule:{...t,title:u(e.title,a)},order:c,seq:e.index})}let g=r.filter(e=>!m.has(e)).sort((e,t)=>p(e)-p(t));for(let[e,t]of g.entries()){let r=n.get(t);s.push({rule:r,order:h+1+p(t),seq:a.length+e})}return s.sort((e,t)=>e.order-t.order||e.seq-t.seq).map(e=>e.rule)}function h(e){if(e.length===0)return`- No description provided.`;let t=[];for(let n of e){t.push(`### ${n.title}`);for(let e of n.ungrouped)t.push(e.text),t.push(...g(e.bodyParagraphs));for(let[e,r]of n.scopes){t.push(`#### ${_(e)}`);for(let e of r)t.push(e.text),t.push(...g(e.bodyParagraphs))}}return t.join(`
+`)}function g(e){let t=[];for(let n of e){let[e,...r]=n;e&&(t.push(`  - ${e}`),t.push(...r.map(e=>`    ${e}`)))}return t}function _(e){return e.charAt(0).toUpperCase()+e.slice(1)}function v(e){return e.length>0?e.charAt(0).toUpperCase()+e.slice(1):e}function y(e){let t=e.lastIndexOf(`([#`);if(t===-1)return{main:e,inline:``};let n=e.slice(t),r=/^(\(\[#[^\]]+\]\([^)]*\) by [^)]*\)\)?)(?:\(fixes [^)]*\)\)?)?/.exec(n);if(!r)return{main:e,inline:``};let i=r[0]??``;return{main:e.slice(0,t)+i,inline:e.slice(t+i.length).trim()}}function b(e){let n=[],r=[];for(let i of e.split(`
+`)){let e=t(i.trim());if(!e){r.length>0&&(n.push(r),r=[]);continue}if(e.startsWith(`-`)||e.startsWith(`*`)||/^[0-9]+[.)]/.test(e)||!e.replace(/(?:close[sd]?|fixe?s|fixed|resolves?|resolved)\b\s*:?\s*#\d+\s*[,;]?\s*/gi,``).trim())continue;let a=/^(BREAKING CHANGE|Reviewed-by|Signed-off-by|Co-authored-by|Acked-by|Co-developed-by|Helped-by|Reported-by|Suggested-by|Tested-by|Cc):\s+(.+)$/i.exec(e);a&&!/^(http|https)\b/.test(e)?(r.length>0&&(n.push(r),r=[]),n.push([`**${(a[1]??``).trim()}:** ${(a[2]??``).trim()}`])):r.push(e)}return r.length>0&&n.push(r),n}function x(e,t){return`https://github.com/${e}/commit/${t}`}function S(e,t){return`https://github.com/${e}/issues/${t}`}function C(e,t){return e.replace(/\[(#[0-9a-fA-F]{6,40})\]\(([^)]*)\)/g,(e,n)=>{let r=n.replace(`#`,``).slice(0,7);return`[#${r}](${x(t,r)})`}).replace(/(^|[^\w[])#([0-9a-fA-F]{7,40})(?![0-9a-fA-F])(?=[)\].,;:\s]|$)/g,(e,n,r)=>{let i=r.slice(0,7);return`${n}[#${i}](${x(t,i)})`})}function w(e,t){return e.replace(/\[#(\d+)(?=[ \]])(?:[^\]]*)\]\([^)]*\)/g,(e,n)=>`[#${n}](${S(t,n)})`).replace(/(^|[^\w[])#(\d+)(?=[)\].,;:\s]|$)/g,(e,n,r)=>`${n}[#${r}](${S(t,r)})`)}function T(e,t){if(!t)return e;let n=C(e,t);return n=w(n,t),n}function E(t,i){if(!i)return;let a=n(t,`utf8`),o=a.split(`
+`).map(e=>T(e,i)).join(`
+`);o!==a&&(r(t,o,`utf8`),e.info(`  formatted ${t}`))}export{v as capitalize,b as formatBody,E as formatChangelogFile,T as formatLine,m as groupItems,s as parseCcSubject,h as renderGroups,o as ruleTitle,y as splitInlineDescription};

package/dist/packages/changelog/src/utils/git.js

@@ -1 +1 @@
-import{default as e}from"node:path";import"node:url";import.meta.url;import{sanitizeText as t}from"../../../shared/src/string-utils.js";import"../../../shared/src/index.js";import n from"node:fs";import{execFileSync as r}from"node:child_process";function i(e,n){let i=n===void 0?[]:Array.isArray(n)?n:[n],a=[`log`,`--no-merges`,`--pretty=format:%H%x1f%s%x1f%b%x1f%an%x1f%ae%x1e`,e];return i.length>0&&a.push(`--`,...i),r(`git`,a,{encoding:`utf8`,stdio:[`ignore`,`pipe`,`pipe`]}).split(``).filter(e=>e.length>0).map(e=>{let[n,r,i,a,o]=e.split(``);return{hash:n.trim(),subject:t((r??``).trim()),body:t((i??``).trim()),author:(a??``).trim(),authorEmail:(o??``).trim()}}).filter(e=>e.subject.length>0)}function a(e){let t=e.match(/(?:github\.com[/:])([^/]+)\/([^/.]+?)(?:\.git)?$/);if(t?.[1]&&t[2])return`${t[1]}/${t[2]}`}function o(){try{let e=a(r(`git`,[`remote`,`get-url`,`origin`],{encoding:`utf8`,stdio:[`ignore`,`pipe`,`ignore`]}).trim());if(e)return e}catch{}try{let t=n.readFileSync(e.join(process.cwd(),`package.json`),`utf8`),r=JSON.parse(t),i=typeof r.repository==`string`?r.repository:r.repository?.url;if(i)return a(i)}catch{}}let s;function c(){if(s!==void 0)return s;try{r(`gh`,[`auth`,`status`],{encoding:`utf8`,stdio:[`ignore`,`pipe`,`pipe`]}),s=!0}catch{s=!1}return s}const l=/* @__PURE__ */ new Map;function u(e,t,n){if(!c())return;let i=`repos/${e}${t}::${n}`;if(l.has(i))return l.get(i);let a;try{let i=r(`gh`,[`api`,`repos/${e}${t}`,`--jq`,n],{encoding:`utf8`,stdio:[`ignore`,`pipe`,`pipe`]}).trim();a=i&&i!==`null`?i:void 0}catch{a=void 0}return l.set(i,a),a}function d(e){return/^(\d+)\+([^@]+)@users\.noreply\.github\.com$/.exec(e.trim())?.[2]}function f(e){return/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(e)}function p(e,t){let n;t&&(n=u(t,`/commits/${e.hash}/pulls`,`.[0].user.login`),n||=u(t,`/commits/${e.hash}`,`.author.login`)),n||=d(e.authorEmail);let r=n??e.author;return f(r)&&(r=d(r)??r.split(`@`)[0]??r),{name:r,url:n?`https://github.com/${n}`:void 0}}function m(e){return e.url?`[${e.name}](${e.url})`:e.name}function h(e){let t=/* @__PURE__ */ new Set;for(let n of e.matchAll(/\b(?:close[sd]?|fixe?s|fixed|resolves?|resolved)\b\s*:?\s*#(\d+)/gi)){let e=Number(n[1]);Number.isInteger(e)&&t.add(e)}return[...t]}function g(e,t){let n={number:t},r=u(e,`/issues/${t}`,`[.title,.html_url]`);if(r)try{let e=JSON.parse(r);n.title=e[0]||void 0,n.url=e[1]||void 0}catch{}return n}function _(e,t){let n=h(`${e.subject}\n${e.body}`);return n.length===0?[]:t?n.map(e=>g(t,e)):n.map(e=>({number:e}))}function v(e){return e.length===0?``:` (fixes ${e.map(e=>e.url&&e.title?`[#${e.number} ${e.title}](${e.url})`:e.url?`[#${e.number}](${e.url})`:`#${e.number}`).join(`, `)})`}function y(e){return/\[(#[0-9a-fA-F]{6,40})\]\([^)]*\)/.exec(e)?.[1]?.replace(`#`,``)}function b(e){try{return r(`git`,[`log`,`-1`,`--format=%aI`,e],{encoding:`utf8`,stdio:[`ignore`,`pipe`,`ignore`]}).trim()}catch{return}}function x(e){for(let t of[`v${e}`,e])try{let e=r(`git`,[`log`,`-1`,`--format=%aI`,t],{encoding:`utf8`,stdio:[`ignore`,`pipe`,`ignore`]}).trim();if(e)return e}catch{}}function S(e,t){let n=x(e);if(n)return new Date(n);for(let e of t){let t=y(e);if(t){let e=b(t);if(e)return new Date(e)}}}let C;function w(){if(C)return C;let e=/* @__PURE__ */ new Map;try{let t=r(`git`,[`log`,`--no-merges`,`--all`,`--format=%H%x1f%s%x1f%b%x1e`],{encoding:`utf8`,stdio:[`ignore`,`pipe`,`ignore`],maxBuffer:134217728});for(let n of t.split(``)){if(!n.trim())continue;let[t=``,r=``,i=``]=n.split(``);if(!t)continue;let a={subject:r.trim(),body:i.trim()};e.set(t.trim(),a),e.set(t.trim().slice(0,7),a)}}catch{}return C=e,e}function T(e){return w().get(e)}function E(e){let t=`patch`;for(let n of e){let e=`${n.subject}\n${n.body}`;/\bBREAKING CHANGE\b/.test(e)||/^[a-zA-Z]+(\([^)]*\))?!:/.test(n.subject)?t=`major`:t!==`major`&&/^feat(\([^)]*\))?:/i.test(n.subject)&&(t=`minor`)}return t}export{y as bulletHash,E as deriveBump,S as deriveVersionDate,T as readCommit,i as readCommits,_ as recordIssues,m as renderAuthor,v as renderIssues,o as repoSlug,p as resolveAuthorInfo};
+import{default as e}from"node:path";import"node:url";import.meta.url;import{sanitizeText as t}from"../../../shared/src/string-utils.js";import"../../../shared/src/index.js";import n from"node:fs";import{execFileSync as r}from"node:child_process";function i(e,n){let i=n===void 0?[]:Array.isArray(n)?n:[n],a=[`log`,`--no-merges`,`--pretty=format:%H%x1f%s%x1f%b%x1f%an%x1f%ae%x1e`,e];return i.length>0&&a.push(`--`,...i),r(`git`,a,{encoding:`utf8`,stdio:[`ignore`,`pipe`,`pipe`]}).split(``).filter(e=>e.length>0).map(e=>{let[n,r,i,a,o]=e.split(``);return{hash:n.trim(),subject:t((r??``).trim()),body:t((i??``).trim()),author:(a??``).trim(),authorEmail:(o??``).trim()}}).filter(e=>e.subject.length>0)}function a(e){let t=e.match(/(?:github\.com[/:])([^/]+)\/([^/.]+?)(?:\.git)?$/);if(t?.[1]&&t[2])return`${t[1]}/${t[2]}`}function o(){try{let e=a(r(`git`,[`remote`,`get-url`,`origin`],{encoding:`utf8`,stdio:[`ignore`,`pipe`,`ignore`]}).trim());if(e)return e}catch{}try{let t=n.readFileSync(e.join(process.cwd(),`package.json`),`utf8`),r=JSON.parse(t),i=typeof r.repository==`string`?r.repository:r.repository?.url;if(i)return a(i)}catch{}}let s;function c(){if(process.env.DBX_NO_GH)return s=!1,!1;if(s!==void 0)return s;try{r(`gh`,[`auth`,`status`],{encoding:`utf8`,stdio:[`ignore`,`pipe`,`pipe`],timeout:2e3}),s=!0}catch{s=!1}return s}const l=/* @__PURE__ */ new Map;function u(e,t,n){if(!c())return;let i=`repos/${e}${t}::${n}`;if(l.has(i))return l.get(i);let a;try{let i=r(`gh`,[`api`,`repos/${e}${t}`,`--jq`,n],{encoding:`utf8`,stdio:[`ignore`,`pipe`,`pipe`],timeout:5e3}).trim();a=i&&i!==`null`?i:void 0}catch{a=void 0}return l.set(i,a),a}function d(e){return/^(\d+)\+([^@]+)@users\.noreply\.github\.com$/.exec(e.trim())?.[2]}function f(e){return/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(e)}function p(e,t){let n;t&&(n=u(t,`/commits/${e.hash}/pulls`,`.[0].user.login`),n||=u(t,`/commits/${e.hash}`,`.author.login`)),n||=d(e.authorEmail);let r=n??e.author;return f(r)&&(r=d(r)??r.split(`@`)[0]??r),{name:r,url:n?`https://github.com/${n}`:void 0}}function m(e){return e.url?`[${e.name}](${e.url})`:e.name}function h(e){let t=/* @__PURE__ */ new Set;for(let n of e.matchAll(/\b(?:close[sd]?|fixe?s|fixed|resolves?|resolved)\b\s*:?\s*#(\d+)/gi)){let e=Number(n[1]);Number.isInteger(e)&&t.add(e)}return[...t]}function g(e,t){let n={number:t},r=u(e,`/issues/${t}`,`[.title,.html_url]`);if(r)try{let e=JSON.parse(r);n.title=e[0]||void 0,n.url=e[1]||void 0}catch{}return n}function _(e,t){let n=h(`${e.subject}\n${e.body}`);return n.length===0?[]:t?n.map(e=>g(t,e)):n.map(e=>({number:e}))}function v(e){return e.length===0?``:` (fixes ${e.map(e=>e.url&&e.title?`[#${e.number} ${e.title}](${e.url})`:e.url?`[#${e.number}](${e.url})`:`#${e.number}`).join(`, `)})`}const y=/* @__PURE__ */ new Map;function b(e,t){let n=`${e}::${t??``}`;if(y.has(n))return y.get(n);let i=e.trim(),a=(i.includes(`..`)?(i.split(`..`)[0]??``).trim():``)||(t?`${t}^`:void 0);if(!a){y.set(n,void 0);return}let o;try{o=r(`git`,[`log`,`--no-merges`,`--format=%ae%x1f%an%x1e`,a],{encoding:`utf8`,stdio:[`ignore`,`pipe`,`ignore`],maxBuffer:134217728})}catch{y.set(n,void 0);return}let s=/* @__PURE__ */ new Set;for(let e of o.split(``)){if(!e.trim())continue;let[t=``,n=``]=e.split(``);for(let e of[t,n]){let t=e.trim().toLowerCase();t&&s.add(t)}}return y.set(n,s),s}function x(e){return/\[(#[0-9a-fA-F]{6,40})\]\([^)]*\)/.exec(e)?.[1]?.replace(`#`,``)}function S(e){try{return r(`git`,[`log`,`-1`,`--format=%aI`,e],{encoding:`utf8`,stdio:[`ignore`,`pipe`,`ignore`]}).trim()}catch{return}}function C(e){for(let t of[`v${e}`,e])try{let e=r(`git`,[`log`,`-1`,`--format=%aI`,t],{encoding:`utf8`,stdio:[`ignore`,`pipe`,`ignore`]}).trim();if(e)return e}catch{}}function w(e,t){let n=C(e);if(n)return new Date(n);for(let e of t){let t=x(e);if(t){let e=S(t);if(e)return new Date(e)}}}let T;function E(){if(T)return T;let e=/* @__PURE__ */ new Map;try{let t=r(`git`,[`log`,`--no-merges`,`--all`,`--format=%H%x1f%s%x1f%b%x1e`],{encoding:`utf8`,stdio:[`ignore`,`pipe`,`ignore`],maxBuffer:134217728});for(let n of t.split(``)){if(!n.trim())continue;let[t=``,r=``,i=``]=n.split(``);if(!t)continue;let a={subject:r.trim(),body:i.trim()};e.set(t.trim(),a),e.set(t.trim().slice(0,7),a)}}catch{}return T=e,e}function D(e){return E().get(e)}function O(e){let t=`patch`;for(let n of e){let e=`${n.subject}\n${n.body}`;/\bBREAKING CHANGE\b/.test(e)||/^[a-zA-Z]+(\([^)]*\))?!:/.test(n.subject)?t=`major`:t!==`major`&&/^feat(\([^)]*\))?:/i.test(n.subject)&&(t=`minor`)}return t}export{x as bulletHash,O as deriveBump,w as deriveVersionDate,D as readCommit,i as readCommits,b as readPriorAuthors,_ as recordIssues,m as renderAuthor,v as renderIssues,o as repoSlug,p as resolveAuthorInfo};

package/dist/packages/changelog/src/utils/reformat.d.ts

@@ -1,9 +1,10 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
+import { ChangelogGroupsSetting } from "../../../shared/src/changelog-groups.js";
 import { ExistingEntry } from "./types.js";
 //#region packages/changelog/src/utils/reformat.d.ts
 /** Split a changelog into `## <version>` sections with their bullet lines. */
 export declare function parseExistingChangelog(content: string): ExistingEntry[];
 /** Backward-reformat an entire changelog file's content (all versions). */
-export declare function reformatChangelogContent(content: string, repo: string | undefined, markersOnNewest?: boolean, includePackageChanges?: boolean): string;
+export declare function reformatChangelogContent(content: string, repo: string | undefined, markersOnNewest?: boolean, includePackageChanges?: boolean, groups?: ChangelogGroupsSetting): string;
 //#endregion

package/dist/packages/changelog/src/utils/reformat.js

@@ -1,6 +1,6 @@
 import{resolve 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{bulletHash as n,deriveVersionDate as r,readCommit as i,repoSlug as a}from"./git.js";import{changelogFiles as o,repoRoot as s}from"./repo.js";import{packageChangesForVersion as c}from"./packages.js";import{capitalize as l,formatBody as u,formatLine as d,groupItems as f,parseCcSubject as p,renderGroups as m}from"./format.js";import{renderChangelogEntry as h}from"./version.js";import{existsSync as g,readFileSync as _,writeFileSync as v}from"node:fs";function y(e){let t=[],n;for(let r of e.split(`
-`)){let e=/^##\s+([0-9]+\.[0-9]+\.[0-9]+)(?:\s*\(.*\))?\s*$/.exec(r);e?(n={version:e[1],bullets:[]},t.push(n)):n&&(r.includes(`<!-- release:`)||r.startsWith(`- `)&&n.bullets.push(r))}return t}function b(e){let t=e.lastIndexOf(`([#`);if(t===-1)return``;let n=e.slice(t);return/^(\(\[#[^\]]+\]\([^)]*\) by [^)]*\)\)?)(?:\(fixes [^)]*\)\)?)?/.exec(n)?.[0]??``}function x(e,t,a=!1,o=``){let s=[];for(let r of e.bullets){let e=r.replace(/^-\s+/,``),a=n(r),o=a?i(a):void 0,c=o?.subject??e.replace(/\*\*/g,``),f=p(c),m=b(e),h=`- ${[d(l(f.rest),t),m].filter(Boolean).join(` `)}`,g=o?u(o.body):[];s.push({parsed:f,text:h,bodyParagraphs:g})}let c=r(e.version,e.bullets);return h(e.version,m(f(s)),c,a,o)}function S(e,t,n=!1,r=!1){let i=y(e);if(i.length===0)return e;let a=e.split(`
-`)[0]??`# Changelog`;return`${a.startsWith(`# `)?a:`# Changelog`}\n\n${i.map((e,a)=>{let o=i[a+1],s=r&&o?c(e.version,o.version):``;return x(e,t,n&&a===0,s)}).filter(Boolean).join(`
+`)){let e=/^##\s+([0-9]+\.[0-9]+\.[0-9]+)(?:\s*\(.*\))?\s*$/.exec(r);e?(n={version:e[1],bullets:[]},t.push(n)):n&&(r.includes(`<!-- release:`)||r.startsWith(`- `)&&n.bullets.push(r))}return t}function b(e){let t=e.lastIndexOf(`([#`);if(t===-1)return``;let n=e.slice(t);return/^(\(\[#[^\]]+\]\([^)]*\) by [^)]*\)\)?)(?:\(fixes [^)]*\)\)?)?/.exec(n)?.[0]??``}function x(e,t,a=!1,o=``,s){let c=[];for(let r of e.bullets){let e=r.replace(/^-\s+/,``),a=n(r),o=a?i(a):void 0,s=o?.subject??e.replace(/\*\*/g,``),f=p(s),m=b(e),h=`- ${[d(l(f.rest),t),m].filter(Boolean).join(` `)}`,g=o?u(o.body):[];c.push({parsed:f,text:h,bodyParagraphs:g})}let g=r(e.version,e.bullets);return h(e.version,m(f(c,s)),g,a,o)}function S(e,t,n=!1,r=!1,i){let a=y(e);if(a.length===0)return e;let o=e.split(`
+`)[0]??`# Changelog`;return`${o.startsWith(`# `)?o:`# Changelog`}\n\n${a.map((e,o)=>{let s=a[o+1],l=r&&s?c(e.version,s.version):``;return x(e,t,n&&o===0,l,i)}).filter(Boolean).join(`
 
 
-`)}\n`}function C(t=!1){let n=s(),r=e(n,`CHANGELOG.md`);return g(r)?S(_(r,`utf8`),a(),!1,t):``}function w(n,r=!1){let i=e(s(),`CHANGELOG.md`);for(let e of o()){let o=S(_(e,`utf8`),a(),!0,r&&e===i);if(n){let n=e.replace(/CHANGELOG\.md$/,`CHANGELOG.proposed.md`);v(n,o,`utf8`),t.info(`[DRY-RUN] Wrote ${n}`)}else v(e,o,`utf8`),t.info(`  formatted ${e}`)}}export{w as formatExistingChangelogs,y as parseExistingChangelog,S as reformatChangelogContent,C as reformatRootChangelog};
+`)}\n`}function C(t=!1,n){let r=s(),i=e(r,`CHANGELOG.md`);return g(i)?S(_(i,`utf8`),a(),!1,t,n):``}function w(n,r=!1,i){let c=e(s(),`CHANGELOG.md`);for(let e of o()){let o=S(_(e,`utf8`),a(),!0,r&&e===c,i);if(n){let n=e.replace(/CHANGELOG\.md$/,`CHANGELOG.proposed.md`);v(n,o,`utf8`),t.info(`[DRY-RUN] Wrote ${n}`)}else v(e,o,`utf8`),t.info(`  formatted ${e}`)}}export{w as formatExistingChangelogs,y as parseExistingChangelog,S as reformatChangelogContent,C as reformatRootChangelog};

package/dist/packages/changelog/src/utils/summary.d.ts

@@ -1,6 +1,7 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
-import { CommitRecord } from "./types.js";
+import { ChangelogGroupsSetting } from "../../../shared/src/changelog-groups.js";
+import { CommitFormatOptions, CommitRecord } from "./types.js";
 //#region packages/changelog/src/utils/summary.d.ts
 /**
  * Render a commit reference for a changelog bullet. With a resolvable repo slug
@@ -9,6 +10,28 @@ import { CommitRecord } from "./types.js";
  * short hash rather than a broken `github.com/undefined/...` link.
  */
 export declare function renderCommitRef(repo: string | undefined, hash: string): string;
+export interface BuildSummaryOptions {
+  /**
+   * Use the Conventional-Commits grouping (default true). When commitlint is
+   * disabled, commits are hoisted into coarse Major/Minor/Patch buckets
+   * instead, so a non-CC history still produces a readable changelog.
+   */
+  commitlint?: boolean;
+  /**
+   * The scanned git range. Used to detect first-time contributors by looking
+   * for their authors before the range starts.
+   */
+  range?: string;
+  /**
+   * Explicit prior-contributor keys (author name/email), for tests or callers
+   * that already know the history. When omitted, the range is inspected.
+   */
+  priorAuthors?: Iterable<string>;
+  /** Commit line formatting/credit options. */
+  commit?: CommitFormatOptions;
+  /** Conventional-Commits group order/titles/hiding. */
+  groups?: ChangelogGroupsSetting;
+}
 /** Render the grouped changelog summary for a set of commits. */
-export declare function buildSummary(records: CommitRecord[]): string;
+export declare function buildSummary(records: CommitRecord[], options?: BuildSummaryOptions): string;
 //#endregion

package/dist/packages/changelog/src/utils/summary.js

@@ -1 +1,3 @@
-import"node:path";import"node:url";import.meta.url;import{recordIssues as e,renderAuthor as t,renderIssues as n,repoSlug as r,resolveAuthorInfo as i}from"./git.js";import{capitalize as a,formatBody as o,groupItems as s,parseCcSubject as c,renderGroups as l}from"./format.js";function u(e,t){let n=t.slice(0,7);return e?`[#${n}](https://github.com/${e}/commit/${t})`:`#${n}`}function d(d){let f=r(),p=s(d.map(r=>{let s=c(r.subject),l=t(i(r,f));return{parsed:s,text:`- ${a(s.rest)} (${u(f,r.hash)} by ${l})${n(e(r,f))}`,bodyParagraphs:o(r.body)}}));return l(p)}export{d as buildSummary,u as renderCommitRef};
+import"node:path";import"node:url";import.meta.url;import{readPriorAuthors as e,recordIssues as t,renderAuthor as n,renderIssues as r,repoSlug as i,resolveAuthorInfo as a}from"./git.js";import{capitalize as o,formatBody as s,groupItems as c,parseCcSubject as l,renderGroups as u}from"./format.js";function d(e,t){let n=t.slice(0,7);return e?`[#${n}](https://github.com/${e}/commit/${t})`:`#${n}`}const f=[`major`,`minor`,`patch`],p={major:`Major changes`,minor:`Minor changes`,patch:`Patch changes`};function m(e){let t=l(e.subject);return t.breaking||/BREAKING[ -]CHANGE/i.test(e.body)||/^[a-zA-Z][a-zA-Z0-9]*(\([^)]*\))?!:\s/.test(e.subject)?`major`:t.type===`feat`?`minor`:`patch`}function h(e,i,c={}){let u=l(e.subject),f=a(e,i),p=t(e,i),m;if(c.format)m=`- ${c.format({commit:e,repo:i,author:f,issues:p,options:c})}`;else{let t=[];if(c.commitSha!==!1&&t.push(d(i,e.hash)),c.author!==!1){let e=c.authorAvatar&&f.url?`![${f.name}](${f.url}) `:``;t.push(`by ${e}${n(f)}`)}let a=t.length>0?` (${t.join(` `)})`:``,s=c.issues===!1?``:r(p);m=`- ${o(u.rest)}${a}${s}`}return{parsed:u,text:m,bodyParagraphs:c.body===!1?[]:s(e.body)}}function g(e){let t=[e.text];for(let n of e.bodyParagraphs){let[e,...r]=n;e&&(t.push(`  - ${e}`),t.push(...r.map(e=>`    ${e}`)))}return t}function _(e,t){let n=i(),r=/* @__PURE__ */ new Map;for(let i of e){let e=m(i),a=r.get(e)??[];a.push(h(i,n,t??{})),r.set(e,a)}if(r.size===0)return`- No description provided.`;let a=[];for(let e of f){let t=r.get(e);if(t&&t.length!==0){a.push(`### ${p[e]}`);for(let e of t)a.push(...g(e))}}return a.join(`
+`)}function v(e){return e.trim().toLowerCase()}function y(e){return[e.authorEmail,e.author].map(v).filter(e=>e.length>0)}function b(t,n,r){let i;if(r.priorAuthors!==void 0)i=new Set([...r.priorAuthors].map(v));else if(r.range){let n=t[t.length-1]?.hash;i=e(r.range,n)}if(!i)return[];let o=/* @__PURE__ */ new Map;for(let e of t){let t=y(e);if(t.length===0||t.some(e=>i.has(e)))continue;let r=t[0],s=o.get(r);s?s.commits.push(e):o.set(r,{key:r,author:a(e,n),commits:[e]})}return[...o.values()].sort((e,t)=>e.author.name.localeCompare(t.author.name))}function x(e,t,r){let i=b(e,t,r);if(i.length===0)return``;let a=[`### New contributors`];for(let e of i){a.push(`- ${n(e.author)}`);for(let n of e.commits)a.push(...g(h(n,t,{author:!1,body:!1})).map(e=>`  ${e}`))}return a.join(`
+`)}function S(e,t={}){let n=i(),r=t.commitlint===!1?_(e,t.commit):u(c(e.map(e=>h(e,n,t.commit??{})),t.groups)),a=x(e,n,t);return a?`${r}\n\n${a}`:r}export{S as buildSummary,d as renderCommitRef};

package/dist/packages/changelog/src/utils/types.d.ts

@@ -1,7 +1,8 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
+import { ChangelogGroupConfig, ChangelogGroupContext, ChangelogGroupEntry, ChangelogGroupHidden, ChangelogGroupItem, ChangelogGroupOrder, ChangelogGroupTitle, ChangelogGroupsContext, ChangelogGroupsSetting } from "../../../shared/src/changelog-groups.js";
+import "../../../shared/src/index.js";
 //#region packages/changelog/src/utils/types.d.ts
-/** Shared types for the changelog pipeline. */
 export type BumpType = 'major' | 'minor' | 'patch';
 export type ProcessingMethod = 'latest' | 'all' | string;
 export interface CommitRecord {
@@ -50,9 +51,40 @@ export interface GroupedItem {
   /** Description paragraphs; each becomes one nested bullet with wrapped continuations. */
   bodyParagraphs: string[][];
 }
+/** Options for rendering a commit bullet/credit line. */
+export interface CommitFormatOptions {
+  /** Include the `by <author>` credit (default true). */
+  author?: boolean;
+  /** Include the commit hash link (default true). */
+  commitSha?: boolean;
+  /** Include issue/fixes links (default true). */
+  issues?: boolean;
+  /** Prefix the author with their GitHub avatar (default false). */
+  authorAvatar?: boolean;
+  /** Fully custom commit line formatter. */
+  format?: (ctx: CommitFormatContext) => string;
+}
+export interface CommitFormatContext {
+  commit: CommitRecord;
+  repo?: string;
+  author: AuthorInfo;
+  issues: IssueInfo[];
+  options: CommitFormatOptions;
+}
+/** A custom changelog provider. */
+export interface ChangelogProviderContext {
+  cwd: string;
+  changelog?: unknown;
+  records: CommitRecord[];
+}
+export interface ChangelogProvider {
+  id: string;
+  run: (ctx: ChangelogProviderContext) => string | void;
+}
 /** A `## <version>` section parsed out of an existing changelog. */
 export interface ExistingEntry {
   version: string;
   bullets: string[];
 }
-//#endregion
+//#endregion
+export type { ChangelogGroupConfig, ChangelogGroupContext, ChangelogGroupEntry, ChangelogGroupHidden, ChangelogGroupItem, ChangelogGroupOrder, ChangelogGroupTitle, ChangelogGroupsContext, ChangelogGroupsSetting };

package/dist/packages/changelog/src/utils/version.d.ts

@@ -1,5 +1,6 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
+import "./types.js";
 //#region packages/changelog/src/utils/version.d.ts
 /** Render a `## <version> (Month Year)` heading + summary, optionally marked. */
 export declare function renderChangelogEntry(version: string, summary: string, date?: Date, withMarkers?: boolean, packageChanges?: string): string;

package/dist/packages/changelog/src/utils/versioning.d.ts

@@ -1,12 +1,13 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
-import { ToolchainChangelogConfig } from "../../../shared/src/config-types.js";
+import { logger } from "../../../shared/src/logger.js";
+import { ChangelogConfig } from "../../../shared/src/config-types.js";
 import "../../../shared/src/index.js";
 import { BumpType, CommitRecord } from "./types.js";
 //#region packages/changelog/src/utils/versioning.d.ts
 /** How/where a changelog run applies its version bump. */
 export type VersioningTarget = 'uniform' | 'root-only' | 'individual';
-/** The normalized `changelog.versioning` config. */
+/** The normalized `ci.changelog.versioning` config. */
 export interface ResolvedVersioning {
   /** Whether versions are written to `package.json` at all. */
   enabled: boolean;
@@ -14,13 +15,21 @@ export interface ResolvedVersioning {
   target: VersioningTarget;
   /** Explicit workspace globs (when configured). */
   workspaces?: string[];
+  /** Custom bump rules keyed by version index. */
+  bump?: Record<string, unknown>;
+  /** Apply a bump per matching change instead of once. */
+  allowOverBump?: boolean;
+  /** Changelog provider id, callback, or custom provider object. */
+  provider?: unknown;
+  /** Commit formatting options. */
+  commit?: unknown;
 }
 /**
- * Normalize the `changelog.versioning` union (`boolean | { target, workspaces }`)
+ * Normalize the `ci.changelog.versioning` union (`boolean | { target, workspaces }`)
  * into a concrete plan input. `true`/absent means uniform with defaults; `false`
  * disables writing versions while still generating changelog entries.
  */
-export declare function resolveVersioning(changelog?: ToolchainChangelogConfig): ResolvedVersioning;
+export declare function resolveVersioning(changelog?: ChangelogConfig): ResolvedVersioning;
 /** The packages a changelog run versions. */
 export interface VersionPackages {
   /** The repository root. */
@@ -41,6 +50,14 @@ export declare function writePackageVersion(dir: string, version: string): void;
  * workspace is found, so a broken checkout can't wedge a release.
  */
 export declare function discoverVersionPackages(workspaces?: string[], root?: string): VersionPackages;
+/** Context handed to custom bump callbacks. */
+export interface BumpRuleContext {
+  env: NodeJS.ProcessEnv;
+  logger: typeof logger;
+  packageJson?: Record<string, unknown>;
+}
+/** Resolve a bump from custom rules, falling back to Conventional Commits. */
+export declare function deriveCustomBump(records: CommitRecord[], rules?: Record<string, unknown>, allowOverBump?: boolean, context?: BumpRuleContext): BumpType;
 /** The version bump plan for a changelog run. */
 export interface VersionPlan {
   /** The version heading for the root changelog. */
@@ -56,6 +73,10 @@ export interface PlanVersionsOptions {
   rootVersion: string;
   /** The bump derived from all scanned commits. */
   bump: BumpType;
+  /** Custom bump rules (used for per-workspace derivation). */
+  bumpRules?: Record<string, unknown>;
+  /** Allow over-bumping (default false). */
+  allowOverBump?: boolean;
   /** The git revision range the commits were read from. */
   range: string;
   /** The repository root (default: resolved from cwd). */

package/dist/packages/changelog/src/utils/versioning.js

@@ -1 +1 @@
-import{resolve 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{deriveBump as n,readCommits as r}from"./git.js";import{repoRoot as i}from"./repo.js";import{bumpVersion as a}from"./version.js";import{relatedWorkspacePaths as o}from"./graph.js";import{existsSync as s,globSync as c,readFileSync as l,writeFileSync as u}from"node:fs";function d(e){let t=e?.versioning;return t===!1?{enabled:!1,target:`uniform`}:t===void 0||t===!0?{enabled:!0,target:`uniform`}:{enabled:!0,target:t.target??`uniform`,...t.workspaces?{workspaces:t.workspaces}:{}}}function f(t){try{let n=JSON.parse(l(e(t,`package.json`),`utf8`));return typeof n.version==`string`?n.version:void 0}catch{return}}function p(n,r){let i=e(n,`package.json`),a=l(i,`utf8`),o=a.replace(/("version"\s*:\s*)"[^"]*"/,`$1"${r}"`);o!==a&&(u(i,o,`utf8`),t.info(`  bumped ${i}`))}function m(n,r=i()){let a=s(e(r,`package.json`)),o=n;if(o===void 0&&a)try{o=JSON.parse(l(e(r,`package.json`),`utf8`)).workspaces}catch{o=void 0}let u=/* @__PURE__ */ new Set;for(let t of o??[])if(t===`.`)u.add(r);else for(let n of c(t,{cwd:r})){let t=e(r,n);s(e(t,`package.json`))&&u.add(t)}return u.delete(r),!a&&u.size===0&&t.warn(`[changelog] versioning: no root package.json and no matching workspaces — nothing to version.`),{root:r,rootHasPackage:a,workspaces:[...u]}}function h(e){let{versioning:t,bump:s,range:c}=e,l=e.root??i(),{rootHasPackage:u,workspaces:d}=m(t.workspaces,l),p=e.commitsFor??(e=>r(c,o(e,l))),h=a(e.rootVersion,s),g=/* @__PURE__ */ new Map,_=/* @__PURE__ */ new Map,v=t.enabled?t.target:`uniform`;if(u&&t.enabled&&g.set(l,h),v===`individual`)for(let e of d){let r=p(e);if(r.length===0)continue;let i=a(f(e)??`0.0.0`,n(r));_.set(e,i),t.enabled&&g.set(e,i)}else if(v===`uniform`)for(let e of d)_.set(e,h),t.enabled&&g.set(e,h);return{rootVersion:h,writes:g,entries:_}}export{m as discoverVersionPackages,h as planVersions,f as readPackageVersion,d as resolveVersioning,p as writePackageVersion};
+import{resolve 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{deriveBump as n,readCommits as r}from"./git.js";import{repoRoot as i}from"./repo.js";import{parseCcSubject as a}from"./format.js";import{bumpVersion as o}from"./version.js";import{relatedWorkspacePaths as s}from"./graph.js";import{existsSync as c,globSync as l,readFileSync as u,writeFileSync as d}from"node:fs";function f(e){let t=e?.versioning;return t===!1?{enabled:!1,target:`uniform`}:t===void 0||t===!0?{enabled:!0,target:`uniform`}:{enabled:!0,target:t.target??`uniform`,...t.workspaces?{workspaces:t.workspaces}:{},...t.bump?{bump:t.bump}:{},...t.allowOverBump?{allowOverBump:!0}:{},...t.provider?{provider:t.provider}:{},...t.commit?{commit:t.commit}:{}}}function p(t){try{let n=JSON.parse(u(e(t,`package.json`),`utf8`));return typeof n.version==`string`?n.version:void 0}catch{return}}function m(n,r){let i=e(n,`package.json`),a=u(i,`utf8`),o=a.replace(/("version"\s*:\s*)"[^"]*"/,`$1"${r}"`);o!==a&&(d(i,o,`utf8`),t.info(`  bumped ${i}`))}function h(n,r=i()){let a=c(e(r,`package.json`)),o=n;if(o===void 0&&a)try{let t=JSON.parse(u(e(r,`package.json`),`utf8`)).workspaces;o=Array.isArray(t)?t.filter(e=>typeof e==`string`):t&&typeof t==`object`&&Array.isArray(t.packages)?t.packages.filter(e=>typeof e==`string`):void 0}catch{o=void 0}let s=/* @__PURE__ */ new Set;for(let t of o??[])if(t===`.`)s.add(r);else for(let n of l(t,{cwd:r})){let t=e(r,n);c(e(t,`package.json`))&&s.add(t)}return s.delete(r),!a&&s.size===0&&t.warn(`[changelog] versioning: no root package.json and no matching workspaces — nothing to version.`),{root:r,rootHasPackage:a,workspaces:[...s]}}function g(e,t,n){if(e===!0)return!0;if(e===!1||e==null)return!1;if(typeof e==`string`){if(e.startsWith(`/`)&&e.lastIndexOf(`/`)>0){let n=e.lastIndexOf(`/`);try{return new RegExp(e.slice(1,n),e.slice(n+1)).test(`${t.subject}\n${t.body}`)}catch{return!1}}return`${t.subject}\n${t.body}`.includes(e)}if(Array.isArray(e))return e.some(e=>g(e,t,n));if(typeof e==`function`)return!!e({...n,commit:t});if(typeof e==`object`){let n=e,r=a(t.subject);return!(n.breaking===!0&&!r.breaking&&!/BREAKING[ -]CHANGE/i.test(t.body)||typeof n.type==`string`&&r.type!==n.type||Array.isArray(n.types)&&!n.types.includes(r.type)||typeof n.scope==`string`&&r.scope!==n.scope||Array.isArray(n.scopes)&&!n.scopes.includes(r.scope)||typeof n.pattern==`string`&&!new RegExp(n.pattern).test(`${t.subject}\n${t.body}`)||typeof n.match==`string`&&!`${t.subject}\n${t.body}`.includes(n.match))}return!1}const _=[`patch`,`minor`,`major`];function v(e,r,i=!1,a={env:process.env,logger:t}){if(!r||Object.keys(r).length===0)return n(e);let o=`patch`,s=0;for(let t of _){let n=r[t];for(let r of e)(typeof n==`function`?(()=>{let e=n({...a,commit:r,level:t});return typeof e==`string`?e===t:!!e})():g(n,r,a))&&(s+=1,_.indexOf(t)>_.indexOf(o)&&(o=t))}if(i&&s>1)for(let e=1;e<s&&o!==`major`;e+=1)o=o===`patch`?`minor`:`major`;return o}function y(e){let{versioning:t,bump:n,range:a}=e,c=e.root??i(),{rootHasPackage:l,workspaces:u}=h(t.workspaces,c),d=e.commitsFor??(e=>r(a,s(e,c))),f=o(e.rootVersion,n),m=/* @__PURE__ */ new Map,g=/* @__PURE__ */ new Map,_=t.enabled?t.target:`uniform`;if(l&&t.enabled&&m.set(c,f),_===`individual`)for(let n of u){let r=d(n);if(r.length===0)continue;let i=o(p(n)??`0.0.0`,v(r,e.bumpRules,e.allowOverBump));g.set(n,i),t.enabled&&m.set(n,i)}else if(_===`uniform`)for(let e of u)g.set(e,f),t.enabled&&m.set(e,f);return{rootVersion:f,writes:m,entries:g}}export{v as deriveCustomBump,h as discoverVersionPackages,y as planVersions,p as readPackageVersion,f as resolveVersioning,m as writePackageVersion};

package/dist/packages/changelog/src/utils/write.js

@@ -1 +1 @@
-import{resolve 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{readCommits as n,repoSlug as r}from"./git.js";import{discoverWorkspaceDirs as i,repoRoot as a}from"./repo.js";import{packageChangesForCurrent as o}from"./packages.js";import{formatChangelogFile as s}from"./format.js";import{prependChangelogEntry as c,renderChangelogEntry as l}from"./version.js";import{parseExistingChangelog as u,reformatRootChangelog as d}from"./reformat.js";import{buildSummary as f}from"./summary.js";import{relatedWorkspacePaths as p}from"./graph.js";import{existsSync as m,readFileSync as h,writeFileSync as g}from"node:fs";function _(_,v,y,b,x,S=!1,C){let w=a(),T=r(),E=e(w,`CHANGELOG.md`),D=``;if(S&&m(E)){let e=u(h(E,`utf8`))[0];e&&(D=o(e.version))}if(x){let e=d(S);e&&(g(E,e,`utf8`),t.info(`  reformatted ${E}`))}let O=l(_,b,/* @__PURE__ */ new Date,!0,D);c(E,O),t.info(`  updated ${E}`);let k=C??new Map(i().filter(t=>e(t)!==e(w)).map(e=>[e,_]));for(let[r,i]of k){let a=e(r,`CHANGELOG.md`),o=n(v,p(r,w));if(o.length===0){t.info(`  skipped ${a} (no related commits)`);continue}let s=!m(a),u=f(o);c(a,l(i,u,/* @__PURE__ */ new Date)),t.info(`  ${s?`created`:`updated`} ${a}`)}let A=/* @__PURE__ */ new Set([...i(),...k.keys()]);for(let t of A){let n=e(t,`CHANGELOG.md`);m(n)&&s(n,T)}}export{_ as writeChangelogs};
+import{resolve 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{readCommits as n,repoSlug as r}from"./git.js";import{discoverWorkspaceDirs as i,repoRoot as a}from"./repo.js";import{packageChangesForCurrent as o}from"./packages.js";import{formatChangelogFile as s}from"./format.js";import{prependChangelogEntry as c,renderChangelogEntry as l}from"./version.js";import{parseExistingChangelog as u,reformatRootChangelog as d}from"./reformat.js";import{buildSummary as f}from"./summary.js";import{relatedWorkspacePaths as p}from"./graph.js";import{existsSync as m,readFileSync as h,writeFileSync as g}from"node:fs";function _(_,v,y,b,x,S=!1,C,w=!0,T){let E=a(),D=r(),O=e(E,`CHANGELOG.md`),k=``;if(S&&m(O)){let e=u(h(O,`utf8`))[0];e&&(k=o(e.version))}if(x){let e=d(S,T);e&&(g(O,e,`utf8`),t.info(`  reformatted ${O}`))}let A=l(_,b,/* @__PURE__ */ new Date,!0,k);c(O,A),t.info(`  updated ${O}`);let j=C??new Map(i().filter(t=>e(t)!==e(E)).map(e=>[e,_]));for(let[r,i]of j){let a=e(r,`CHANGELOG.md`),o=n(v,p(r,E));if(o.length===0){t.info(`  skipped ${a} (no related commits)`);continue}let s=!m(a),u=f(o,{commitlint:w,range:v,groups:T});c(a,l(i,u,/* @__PURE__ */ new Date)),t.info(`  ${s?`created`:`updated`} ${a}`)}let M=/* @__PURE__ */ new Set([...i(),...j.keys()]);for(let t of M){let n=e(t,`CHANGELOG.md`);m(n)&&s(n,D)}}export{_ as writeChangelogs};

package/dist/packages/changelog/src/workflows.d.ts

@@ -1,6 +1,6 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
-import { WorkflowConfig, WorkflowSetting, WorkflowStep } from "../../shared/src/config-types.js";
+import { WorkflowOptions, WorkflowSetting, WorkflowStep } from "../../shared/src/config-types.js";
 import { Replacements } from "../../shared/src/template.js";
 import "../../shared/src/index.js";
 //#region packages/changelog/src/workflows.d.ts
@@ -31,27 +31,47 @@ export declare const DEFAULT_WORKFLOW_TOKENS: Replacements;
 export type WorkflowId = 'ci' | 'changelog' | 'release' | 'sync' | 'issues';
 /** Default file name per workflow id. */
 export declare const WORKFLOW_FILENAMES: Record<WorkflowId, string>;
-/** Whether a workflow setting enables the workflow (default true). */
+/** The default directory for generated workflows. */
+export declare const DEFAULT_WORKFLOW_DIR = ".github/workflows";
+/**
+ * The path a workflow is written to. A setting may override the directory
+ * (`dir`) and file name (`filename`); custom ids default to `<id>.yml`.
+ */
+export declare function workflowFilePath(id: string, setting: WorkflowSetting | undefined, defaultFilename?: string): string;
+/** Whether a workflow setting enables the workflow (opt-in: absent is disabled). */
 export declare function isEnabled(setting: WorkflowSetting | undefined): boolean;
+export interface DefaultWorkflowOptions {
+  /** Include commitlint in the CI workflow (default true). */
+  commitlint?: boolean;
+  /** Config-defined workflows (enabled by presence; no boolean form). */
+  custom?: Record<string, string | WorkflowOptions>;
+}
 /** Build all default workflows for a set of tokens. */
-export declare function defaultWorkflows(tokens: Replacements): Record<WorkflowId, Workflow>;
-/** Merge a consumer's {@link WorkflowConfig} over a default workflow. */
-export declare function applyWorkflowConfig(workflow: Workflow, config?: WorkflowConfig): Workflow;
+export declare function defaultWorkflows(tokens: Replacements, options?: DefaultWorkflowOptions): Record<WorkflowId, Workflow>;
+/** Merge a consumer's {@link WorkflowOptions} over a default workflow. */
+export declare function applyWorkflowConfig(workflow: Workflow, config?: WorkflowOptions): Workflow;
 export interface RenderWorkflowOptions {
   /** Base replacement tokens (merged with the workflow's own `tokens`). */
   tokens: Replacements;
   /** The consumer's per-workflow config. */
-  config?: WorkflowConfig;
+  config?: WorkflowOptions;
+  /** Include commitlint in the CI workflow (default true). */
+  commitlint?: boolean;
 }
 /**
  * Build one workflow as a YAML string, applying the consumer's config. Returns
  * `undefined` when the workflow is disabled.
  */
 export declare function renderWorkflow(id: WorkflowId, options: RenderWorkflowOptions): string | undefined;
+/**
+ * Build a custom workflow from an empty skeleton, merging the consumer's
+ * settings over it (`triggers` -> `on`, `jobs` -> jobs, `extra` -> top-level).
+ */
+export declare function renderCustomWorkflow(id: string, options: RenderWorkflowOptions): string | undefined;
 /**
  * Render every workflow, keyed by file name (disabled ones are omitted). A raw
  * string setting is used verbatim as the workflow content (no default merge and
  * no token replacement).
  */
-export declare function renderWorkflows(tokens: Replacements, workflows?: Partial<Record<WorkflowId, WorkflowSetting>>): Record<string, string>;
+export declare function renderWorkflows(tokens: Replacements, workflows?: Partial<Record<WorkflowId, WorkflowSetting>>, options?: DefaultWorkflowOptions): Record<string, string>;
 //#endregion

package/dist/packages/changelog/src/workflows.js

@@ -1,5 +1,5 @@
-import"node:path";import"node:url";import.meta.url;import{applyReplacementsDeep as e}from"../../shared/src/template.js";import{toYaml as t}from"../../shared/src/yaml.js";import"../../shared/src/index.js";const n={nodeVersion:`22`,yarnVersion:`4.17.1`,packageManager:`yarn`,mainBranch:`main`,devBranch:`main`,tooling:`dbx`,commitlintConfig:`commitlint.config.mjs`},r={ci:`ci.yml`,changelog:`changelog.yml`,release:`release.yml`,sync:`sync.yml`,issues:`issues.yml`};function i(e){return e===void 0?!0:typeof e==`boolean`?e:typeof e==`string`?e.trim().length>0:e.enabled!==!1}function a(e){return`${e.packageManager} ${e.tooling}`}function o(e){return[{name:`Checkout`,uses:`actions/checkout@v4`,with:{"fetch-depth":0,token:"${{ secrets.GITHUB_TOKEN }}"}},{name:`Setup Node`,uses:`actions/setup-node@v4`,with:{"node-version":String(e.nodeVersion)}},{name:`Enable Corepack`,run:`corepack enable\ncorepack prepare ${e.packageManager}@${e.yarnVersion} --activate`},{name:`Install dependencies`,run:`${e.packageManager} install --immutable`}]}function s(e){let t=a(e),n=String(e.mainBranch),r=String(e.devBranch);return{ci:{name:`CI`,on:{push:{branches:[n]},pull_request:{branches:[`release/**`,`feat/**`,`feature/**`,`fix/**`,`chore/**`]}},jobs:{ci:{"runs-on":`ubuntu-latest`,steps:[...o(e),{name:`Commitlint (Conventional Commits)`,if:"${{ github.event_name == 'pull_request' || github.event.before != '0000000000000000000000000000000000000000' }}",run:`set -euo pipefail\nbase="\${{ github.event.pull_request.base.sha || github.event.before }}"\nhead="\${{ github.event.pull_request.head.sha || github.event.after }}"\n${e.packageManager} commitlint --from "$base" --to "$head" --config ${e.commitlintConfig}`},{name:`Verify generated files are in sync`,run:`${t} sync --check`},{name:`Build`,run:`${e.packageManager} build`}]}}},changelog:{name:`Changelog (dev)`,on:{push:{branches:[r]}},permissions:{contents:`write`},concurrency:{group:`changelog-dev`,"cancel-in-progress":!1},jobs:{"generate-changelog":{"runs-on":`ubuntu-latest`,if:`!startsWith(github.event.head_commit.message, 'chore: version packages ') && !startsWith(github.event.head_commit.message, 'release: ')`,env:{GITHUB_TOKEN:"${{ secrets.GITHUB_TOKEN }}"},steps:[...o(e),{name:`Generate changelog + bump versions`,env:{GITHUB_TOKEN:"${{ secrets.GITHUB_TOKEN }}"},run:[`set -euo pipefail`,'after="${{ github.event.after }}"; [ -n "$after" ] || after="HEAD"',`boundary="$(git log --format=%H --grep='^chore: version packages ' -1 || true)"`,`if [ -n "$boundary" ]; then range="$boundary..$after"; else range="$after"; fi`,`${t} changelog --range "$range"`].join(`
-`)},{name:`Commit + push changelog updates`,env:{GITHUB_TOKEN:"${{ secrets.GITHUB_TOKEN }}"},run:[`set -euo pipefail`,`git diff --quiet && { echo "No changelog changes."; exit 0; }`,`git config user.name "github-actions[bot]"`,`git config user.email "41898282+github-actions[bot]@users.noreply.github.com"`,`git add -u -- "*package.json" "*CHANGELOG.md"`,`git commit -m "chore: version packages ($(node -p "require('./package.json').version"))"`,`git push origin ${r}`].join(`
-`)}]}}},release:{name:`Release`,on:{push:{branches:[n]},workflow_dispatch:null},permissions:{contents:`write`,"pull-requests":`write`},concurrency:{group:`release`,"cancel-in-progress":!1},jobs:{"create-release-pr":{"runs-on":`ubuntu-latest`,if:`(github.event_name == 'push' || github.event_name == 'workflow_dispatch') && !startsWith(github.event.head_commit.message, 'chore: version packages ') && !startsWith(github.event.head_commit.message, 'release: ')`,env:{GITHUB_TOKEN:"${{ secrets.GITHUB_TOKEN }}"},steps:[...o(e),{name:`Open release PR`,env:{GITHUB_TOKEN:"${{ secrets.GITHUB_TOKEN }}"},run:[`set -euo pipefail`,`version="$(node -p "require('./package.json').version")"`,`branch="release/$version"`,`if git ls-remote --exit-code --heads origin "$branch" >/dev/null 2>&1; then`,`  echo "Release PR already open for $version."; exit 0`,`fi`,`git config user.name "github-actions[bot]"`,`git config user.email "41898282+github-actions[bot]@users.noreply.github.com"`,`git checkout -b "$branch"`,`git add -A`,`git commit -m "chore: version packages ($version)" || true`,`git push origin "$branch"`,`last_tag="$(git describe --tags --abbrev=0 2>/dev/null || true)"`,`if [ -n "$last_tag" ]; then`,'  last_version="${last_tag#v}"',`  notes="$(awk -v v="$last_version" '/^## / { if ($2 == v) exit; started = 1 } started { print }' CHANGELOG.md 2>/dev/null || true)"`,`else`,`  notes="$(cat CHANGELOG.md 2>/dev/null || true)"`,`fi`,`[ -n "$notes" ] || notes="Release $version"`,`gh pr create --base ${n} --head "$branch" --title "release: $version" --body "$notes"`].join(`
-`)}]}}},sync:{name:`Toolchain sync`,on:{push:{branches:[.../* @__PURE__ */ new Set([n,r])]},pull_request:null},jobs:{sync:{"runs-on":`ubuntu-latest`,steps:[...o(e),{name:`Verify generated files are in sync`,run:`${t} sync --check`}]}}},issues:{name:`Issues`,on:{issues:{types:[`opened`]}},permissions:{issues:`write`},jobs:{"enforce-title":{"runs-on":`ubuntu-latest`,steps:[{name:`Check and rename issue title`,env:{GH_TOKEN:"${{ github.token }}",ISSUE_NUMBER:"${{ github.event.issue.number }}"},run:[`set -euo pipefail`,`labels=$(gh issue view "$ISSUE_NUMBER" --json labels -q '.labels[].name' || true)`,`title=$(gh issue view "$ISSUE_NUMBER" --json title -q '.title')`,`type=""`,`for label in $labels; do case "$label" in *bug*) type="bug" ;; esac; done`,`if [ -z "$type" ]; then for label in $labels; do case "$label" in *enhancement*|*feature*|*feat*) type="feat" ;; esac; done; fi`,`if [ -z "$type" ]; then echo "No bug/enhancement label on issue #$ISSUE_NUMBER; skipping."; exit 0; fi`,`prefix="[bug]"; [ "$type" = "feat" ] && prefix="[feat]"`,`stripped=$(printf '%s' "$title" | sed -E 's/^\\[(bug|feat)\\] *//i')`,`new_title="$prefix $stripped"`,`if [ "$new_title" = "$title" ]; then echo "Issue #$ISSUE_NUMBER title already conforms."; exit 0; fi`,`gh issue edit "$ISSUE_NUMBER" --title "$new_title"`].join(`
-`)}]}}}}}function c(e){return e.steps?Array.isArray(e.steps)?e.steps:[e.steps]:[]}function l(e,t={}){let n=structuredClone(e);if(t.pushBranches){let e=n.on.push??{};n.on.push={...e,branches:t.pushBranches}}if(t.pullRequestBranches){let e=n.on.pull_request??{};n.on.pull_request={...e,branches:t.pullRequestBranches}}t.triggers&&(n.on={...n.on,...t.triggers}),t.extra&&Object.assign(n,t.extra),t.jobs&&(n.jobs={...n.jobs,...t.jobs});let r=Object.keys(n.jobs)[0];for(let e of c(t)){let t=e.job??r;if(!t)continue;let i=n.jobs[t];i&&(i.steps=[...e.before??[],...i.steps,...e.after??[]])}return n}function u(r,i){let a=i.config??{};if(a.enabled===!1)return;let o={...n,...i.tokens,...a.tokens},c=s(o)[r],u=e(l(c,a),o);return t(u)}function d(e,t={}){let n={};for(let a of Object.keys(r)){let o=t[a];if(!i(o))continue;if(typeof o==`string`){n[r[a]]=o;continue}let s=u(a,{tokens:e,config:typeof o==`object`?o:{}});s&&(n[r[a]]=s)}return n}export{n as DEFAULT_WORKFLOW_TOKENS,r as WORKFLOW_FILENAMES,l as applyWorkflowConfig,s as defaultWorkflows,i as isEnabled,u as renderWorkflow,d as renderWorkflows};
+import"node:path";import"node:url";import.meta.url;import{applyReplacementsDeep as e}from"../../shared/src/template.js";import{DEFAULT_PACKAGE_MANAGER_VERSIONS as t}from"../../shared/src/toolchain.js";import{toYaml as n}from"../../shared/src/yaml.js";import"../../shared/src/index.js";const r={nodeVersion:`22`,yarnVersion:`4.17.1`,packageManager:`yarn`,mainBranch:`main`,devBranch:`main`,tooling:`dbx`,commitlintConfig:`commitlint.config.mjs`},i={ci:`ci.yml`,changelog:`changelog.yml`,release:`release.yml`,sync:`sync.yml`,issues:`issues.yml`},a=`.github/workflows`;function o(e){let t=(e??`.github/workflows`).replace(/\\/g,`/`).replace(/^\.?\//,``).replace(/\/+$/,``);if(/^[a-zA-Z]:/.test(t)||t.split(`/`).includes(`..`))throw Error(`invalid workflow directory "${e}" (must stay inside the project).`);return t}function s(e,t){let n=(e??t).trim();if(!n||/[\\/]/.test(n)||n===`.`||n===`..`)throw Error(`invalid workflow filename "${e}" (expected a file name).`);return n}function c(e,t,n=`${e}.yml`){let r=t&&typeof t==`object`?t:void 0,i=o(r?.dir),a=s(r?.filename,n);return i?`${i}/${a}`:a}function l(e){return e===void 0?!1:typeof e==`boolean`?e:typeof e==`string`?e.trim().length>0:e.enabled!==!1}function u(e){let n=String(e.packageManager??`yarn`);return String(e.packageManagerVersion??e.yarnVersion??t[n]??`4.17.1`)}function d(e){let t=e.config?.tokens??{},n={...r,...e.tokens,...t},i=t.packageManager;return i!==void 0&&i!==e.tokens.packageManager&&t.packageManagerVersion===void 0&&t.yarnVersion===void 0&&(delete n.packageManagerVersion,delete n.yarnVersion),t.packageManagerVersion===void 0&&t.yarnVersion!==void 0&&(n.packageManagerVersion=t.yarnVersion),n}function f(e){let t=String(e.tooling??`dbx`);switch(String(e.packageManager??`yarn`)){case`pnpm`:return`pnpm exec ${t}`;case`npm`:return`npx ${t}`;case`bun`:return`bunx ${t}`;default:return`${e.packageManager??`yarn`} ${t}`}}function p(e){let t=String(e.packageManager??`yarn`),n=u(e),r=[{name:`Checkout`,uses:`actions/checkout@v4`,with:{"fetch-depth":0,token:"${{ secrets.GITHUB_TOKEN }}"}},{name:`Setup Node`,uses:`actions/setup-node@v4`,with:{"node-version":String(e.nodeVersion)}}];return t===`bun`?[...r,{name:`Setup Bun`,uses:`oven-sh/setup-bun@v2`,with:{"bun-version":n}},{name:`Install dependencies`,run:`bun install --frozen-lockfile`}]:t===`npm`?[...r,{name:`Install dependencies`,run:`npm install -g npm@${n}\nnpm ci`}]:[...r,{name:`Enable Corepack`,run:`corepack enable\ncorepack prepare ${t}@${n} --activate`},{name:`Install dependencies`,run:t===`pnpm`?`pnpm install --frozen-lockfile`:`yarn install --immutable`}]}function m(e,t={}){let n=f(e),r=String(e.mainBranch),i=String(e.devBranch),a=t.commitlint!==!1;return{ci:{name:`CI`,on:{push:{branches:[r]},pull_request:{branches:[`release/**`,`feat/**`,`feature/**`,`fix/**`,`chore/**`]}},jobs:{ci:{"runs-on":`ubuntu-latest`,steps:[...p(e),...a?[{name:`Commitlint (Conventional Commits)`,if:"${{ github.event_name == 'pull_request' || github.event.before != '0000000000000000000000000000000000000000' }}",run:`set -euo pipefail\nbase="\${{ github.event.pull_request.base.sha || github.event.before }}"\nhead="\${{ github.event.pull_request.head.sha || github.event.after }}"\n${e.packageManager} commitlint --from "$base" --to "$head" --config ${e.commitlintConfig}`}]:[],{name:`Verify generated files are in sync`,run:`${n} sync --check`},{name:`Build`,run:`${e.packageManager} build`}]}}},changelog:{name:`Changelog (dev)`,on:{push:{branches:[i]}},permissions:{contents:`write`},concurrency:{group:`changelog-dev`,"cancel-in-progress":!1},jobs:{"generate-changelog":{"runs-on":`ubuntu-latest`,if:`!startsWith(github.event.head_commit.message, 'chore: version packages ') && !startsWith(github.event.head_commit.message, 'release: ')`,env:{GITHUB_TOKEN:"${{ secrets.GITHUB_TOKEN }}"},steps:[...p(e),{name:`Generate changelog + bump versions`,env:{GITHUB_TOKEN:"${{ secrets.GITHUB_TOKEN }}"},run:[`set -euo pipefail`,'after="${{ github.event.after }}"; [ -n "$after" ] || after="HEAD"',`boundary="$(git log --format=%H --grep='^chore: version packages ' -1 || true)"`,`if [ -n "$boundary" ]; then range="$boundary..$after"; else range="$after"; fi`,`${n} changelog --range "$range"`].join(`
+`)},{name:`Commit + push changelog updates`,env:{GITHUB_TOKEN:"${{ secrets.GITHUB_TOKEN }}"},run:[`set -euo pipefail`,`git diff --quiet && { echo "No changelog changes."; exit 0; }`,`git config user.name "github-actions[bot]"`,`git config user.email "41898282+github-actions[bot]@users.noreply.github.com"`,`git add -u -- "*package.json" "*CHANGELOG.md"`,`git commit -m "chore: version packages ($(node -p "require('./package.json').version"))"`,`git push origin ${i}`].join(`
+`)}]}}},release:{name:`Release`,on:{push:{branches:[r]},workflow_dispatch:null},permissions:{contents:`write`,"pull-requests":`write`},concurrency:{group:`release`,"cancel-in-progress":!1},jobs:{"create-release-pr":{"runs-on":`ubuntu-latest`,if:`(github.event_name == 'push' || github.event_name == 'workflow_dispatch') && !startsWith(github.event.head_commit.message, 'chore: version packages ') && !startsWith(github.event.head_commit.message, 'release: ')`,env:{GITHUB_TOKEN:"${{ secrets.GITHUB_TOKEN }}"},steps:[...p(e),{name:`Open release PR`,env:{GITHUB_TOKEN:"${{ secrets.GITHUB_TOKEN }}"},run:[`set -euo pipefail`,`version="$(node -p "require('./package.json').version")"`,`branch="release/$version"`,`if git ls-remote --exit-code --heads origin "$branch" >/dev/null 2>&1; then`,`  echo "Release PR already open for $version."; exit 0`,`fi`,`git config user.name "github-actions[bot]"`,`git config user.email "41898282+github-actions[bot]@users.noreply.github.com"`,`git checkout -b "$branch"`,`git add -A`,`git commit -m "chore: version packages ($version)" || true`,`git push origin "$branch"`,`last_tag="$(git describe --tags --abbrev=0 2>/dev/null || true)"`,`if [ -n "$last_tag" ]; then`,'  last_version="${last_tag#v}"',`  notes="$(awk -v v="$last_version" '/^## / { if ($2 == v) exit; started = 1 } started { print }' CHANGELOG.md 2>/dev/null || true)"`,`else`,`  notes="$(cat CHANGELOG.md 2>/dev/null || true)"`,`fi`,`[ -n "$notes" ] || notes="Release $version"`,`gh pr create --base ${r} --head "$branch" --title "release: $version" --body "$notes"`].join(`
+`)}]}}},sync:{name:`Toolchain sync`,on:{push:{branches:[.../* @__PURE__ */ new Set([r,i])]},pull_request:null},jobs:{sync:{"runs-on":`ubuntu-latest`,steps:[...p(e),{name:`Verify generated files are in sync`,run:`${n} sync --check`}]}}},issues:{name:`Issues`,on:{issues:{types:[`opened`]}},permissions:{issues:`write`},jobs:{"enforce-title":{"runs-on":`ubuntu-latest`,steps:[{name:`Check and rename issue title`,env:{GH_TOKEN:"${{ github.token }}",ISSUE_NUMBER:"${{ github.event.issue.number }}"},run:[`set -euo pipefail`,`labels=$(gh issue view "$ISSUE_NUMBER" --json labels -q '.labels[].name' || true)`,`title=$(gh issue view "$ISSUE_NUMBER" --json title -q '.title')`,`type=""`,`for label in $labels; do case "$label" in *bug*) type="bug" ;; esac; done`,`if [ -z "$type" ]; then for label in $labels; do case "$label" in *enhancement*|*feature*|*feat*) type="feat" ;; esac; done; fi`,`if [ -z "$type" ]; then echo "No bug/enhancement label on issue #$ISSUE_NUMBER; skipping."; exit 0; fi`,`prefix="[bug]"; [ "$type" = "feat" ] && prefix="[feat]"`,`stripped=$(printf '%s' "$title" | sed -E 's/^\\[(bug|feat)\\] *//i')`,`new_title="$prefix $stripped"`,`if [ "$new_title" = "$title" ]; then echo "Issue #$ISSUE_NUMBER title already conforms."; exit 0; fi`,`gh issue edit "$ISSUE_NUMBER" --title "$new_title"`].join(`
+`)}]}}}}}function h(e){return e.steps?Array.isArray(e.steps)?e.steps:[e.steps]:[]}function g(e,t={}){let n=structuredClone(e);if(t.pushBranches){let e=n.on.push??{};n.on.push={...e,branches:t.pushBranches}}if(t.pullRequestBranches){let e=n.on.pull_request??{};n.on.pull_request={...e,branches:t.pullRequestBranches}}t.triggers&&(n.on={...n.on,...t.triggers}),t.extra&&Object.assign(n,t.extra),t.jobs&&(n.jobs={...n.jobs,...t.jobs});let r=Object.keys(n.jobs)[0];for(let e of h(t)){let t=e.job??r;if(!t)continue;let i=n.jobs[t];i&&(i.steps=[...e.before??[],...i.steps,...e.after??[]])}return n}function _(t,r){let i=r.config??{};if(i.enabled===!1)return;let a=d(r),o=m(a,{commitlint:r.commitlint!==!1})[t],s=e(g(o,i),a);return n(s)}function v(t,r){let i=r.config??{};if(i.enabled===!1)return;let a=d(r),o=e(g({name:t,on:{},jobs:{}},i),a),s=o.on&&typeof o.on==`object`&&Object.keys(o.on).length>0,c=o.jobs&&typeof o.jobs==`object`&&Object.keys(o.jobs).length>0;if(!s||!c)throw Error(`custom workflow "${t}" must define at least one trigger and one job (use \`triggers\` and \`jobs\`, or \`extra\`).`);return n(o)}function y(e,t={},n={}){let r={};for(let a of Object.keys(i)){let o=t[a];if(!l(o))continue;let s=c(a,o,i[a]),u=s.split(`/`).pop()??s;if(typeof o==`string`){r[u]=o;continue}let d=_(a,{tokens:e,config:typeof o==`object`?o:{},...n});d&&(r[u]=d)}for(let[t,i]of Object.entries(n.custom??{})){if(!l(i))continue;let a=c(t,i),o=a.split(`/`).pop()??a;if(typeof i==`string`){r[o]=i;continue}let s=v(t,{tokens:e,config:i,...n});s&&(r[o]=s)}return r}export{a as DEFAULT_WORKFLOW_DIR,r as DEFAULT_WORKFLOW_TOKENS,i as WORKFLOW_FILENAMES,g as applyWorkflowConfig,m as defaultWorkflows,l as isEnabled,v as renderCustomWorkflow,_ as renderWorkflow,y as renderWorkflows,c as workflowFilePath};

package/dist/packages/config/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 n from"node:fs";function r(t,n){return e.resolve(t??n)}function i(i){let{engine:a}=i,o=i.defaults??{};return[{name:`config:env`,description:`Generate .env.example from the config schemas.`,options:[{flags:`-o, --out <dir>`,description:`Output directory.`}],run:({out:n})=>{let i=e.join(r(n,o.envDir??a.root),`.env.example`);a.writeEnvFile({output:i}),t.info(`Generated ${e.relative(process.cwd(),i)}`)}},{name:`config:types`,description:`Generate the config and env types.`,options:[{flags:`-o, --out <dir>`,description:`Output directory.`},{flags:`--env`,description:`Also write the env type files.`}],run:({out:n,env:i})=>{let s=r(n,o.typesDir??a.root),c=a.writeConfigTypes({outputDir:s});i&&c.push(...a.writeEnvTypes({outputDir:s}));for(let n of c)t.info(`Generated ${e.relative(process.cwd(),n)}`)}},{name:`config:json`,description:`Generate the config metadata JSON.`,options:[{flags:`-o, --out <file>`,description:`Output file.`}],run:({out:i})=>{let s=r(i,o.configJsonPath??e.join(a.root,`config.json`)),c=a.buildConfigJson();n.mkdirSync(e.dirname(s),{recursive:!0}),n.writeFileSync(s,`${JSON.stringify(c,null,4)}\n`,`utf-8`),t.info(`Generated ${e.relative(process.cwd(),s)}`)}},{name:`config:schema`,description:`Generate the untyped JSON Schema.`,options:[{flags:`-o, --out <file>`,description:`Output file.`}],run:async({out:n})=>{let i=r(n,o.schemaPath??e.join(a.root,`config.schema.json`));await a.writeJsonSchema({output:i}),t.info(`Generated ${e.relative(process.cwd(),i)}`)}},{name:`config:markdown`,description:`Generate the markdown configuration reference.`,options:[{flags:`-o, --out <dir>`,description:`Output directory.`}],run:({out:n})=>{let i=r(n,o.docsDir??e.join(a.root,`docs/reference/configuration`)),s=a.writeMarkdown({outDir:i});for(let n of s)t.info(`Generated ${e.relative(process.cwd(),n)}`)}},{name:`config:cli`,description:`Generate the CLI options JSON.`,options:[{flags:`-o, --out <file>`,description:`Output file.`}],run:({out:n})=>{let i=r(n,o.cliOptionsPath??e.join(a.root,`cli-options.json`));a.generateCliOptions({output:i}),t.info(`Generated ${e.relative(process.cwd(),i)}`)}},{name:`config:all`,description:`Run every config generator.`,options:[{flags:`-o, --out <dir>`,description:`Base output directory.`}],run:async({out:n})=>{let i=r(n,a.root),o=[];o.push(a.writeEnvFile({output:e.join(i,`.env.example`)})),o.push(...a.writeConfigTypes({outputDir:e.join(i,`types`)}),...a.writeEnvTypes({outputDir:e.join(i,`types`)}),...a.writeMarkdown({outDir:e.join(i,`docs/reference/configuration`)})),o.push(await a.writeJsonSchema({output:e.join(i,`config.schema.json`)})),o.push(a.generateCliOptions({output:e.join(i,`cli-options.json`)}));for(let n of o.filter(e=>typeof e==`string`))t.info(`Generated ${e.relative(process.cwd(),n)}`)}}]}export{i as configCommands};
+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(t,n){return e.resolve(t??n)}function i(i){let{engine:a}=i,o=i.defaults??{};return[{name:`config:env`,description:`Generate .env.example from the config schemas.`,options:[{flags:`-o, --out <dir>`,description:`Output directory.`}],run:({out:n})=>{let i=e.join(r(n,o.envDir??a.root),`.env.example`);a.writeEnvFile({output:i}),t.info(`Generated ${e.relative(process.cwd(),i)}`)}},{name:`config:types`,description:`Generate the config and env types.`,options:[{flags:`-o, --out <dir>`,description:`Output directory.`},{flags:`--env`,description:`Also write the env type files.`}],run:({out:n,env:i})=>{let s=r(n,o.typesDir??a.root),c=a.writeConfigTypes({outputDir:s});i&&c.push(...a.writeEnvTypes({outputDir:s}));for(let n of c)t.info(`Generated ${e.relative(process.cwd(),n)}`)}},{name:`config:json`,description:`Generate the config metadata JSON.`,options:[{flags:`-o, --out <file>`,description:`Output file.`}],run:({out:i})=>{let s=r(i,o.configJsonPath??e.join(a.root,`config.json`)),c=a.buildConfigJson();n.mkdirSync(e.dirname(s),{recursive:!0}),n.writeFileSync(s,`${JSON.stringify(c,null,4)}\n`,`utf-8`),t.info(`Generated ${e.relative(process.cwd(),s)}`)}},{name:`config:schema`,description:`Generate the untyped JSON Schema.`,options:[{flags:`-o, --out <file>`,description:`Output file.`}],run:async({out:n})=>{let i=r(n,o.schemaPath??e.join(a.root,`config.schema.json`));await a.writeJsonSchema({output:i}),t.info(`Generated ${e.relative(process.cwd(),i)}`)}},{name:`config:markdown`,description:`Generate the markdown configuration reference.`,options:[{flags:`-o, --out <dir>`,description:`Output directory.`}],run:({out:n})=>{let i=r(n,o.docsDir??e.join(a.root,`docs/reference/configuration`)),s=a.writeMarkdown({outputDir:i});for(let n of s)t.info(`Generated ${e.relative(process.cwd(),n)}`)}},{name:`config:cli`,description:`Generate the CLI options JSON.`,options:[{flags:`-o, --out <file>`,description:`Output file.`}],run:({out:n})=>{let i=r(n,o.cliOptionsPath??e.join(a.root,`cli-options.json`));a.generateCliOptions({output:i}),t.info(`Generated ${e.relative(process.cwd(),i)}`)}},{name:`config:all`,description:`Run every config generator.`,options:[{flags:`-o, --out <dir>`,description:`Base output directory.`}],run:async({out:n})=>{let i=r(n,a.root),o=[];o.push(a.writeEnvFile({output:e.join(i,`.env.example`)})),o.push(...a.writeConfigTypes({outputDir:e.join(i,`types`)}),...a.writeEnvTypes({outputDir:e.join(i,`types`)}),...a.writeMarkdown({outputDir:e.join(i,`docs/reference/configuration`)})),o.push(await a.writeJsonSchema({output:e.join(i,`config.schema.json`)})),o.push(a.generateCliOptions({output:e.join(i,`cli-options.json`)}));for(let n of o.filter(e=>typeof e==`string`))t.info(`Generated ${e.relative(process.cwd(),n)}`)}}]}export{i as configCommands};

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

@@ -1,19 +1,21 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
-import { ConfigScopes, EnvVarDef } from "./types.js";
+import { ConfigDef, ConfigSchema } from "./types.js";
 //#region packages/config/src/collect.d.ts
 /** The default env-var prefix used when none is configured. */
 export declare const DEFAULT_ENV_PREFIX = "APP_";
-/** Options for {@link collectEnvVars}. */
-export interface CollectEnvVarsOptions {
+/** Options for {@link collectVars}. */
+export interface CollectVarsOptions {
   /**
    * Custom env-name -> dotted-path derivation, used when a leaf does not set
-   * an explicit `path` (eg. to handle dual `PROXIFIED_`/`VITE_` prefixes).
+   * an explicit `envPath` (eg. to handle dual `PROXIFIED_`/`VITE_` prefixes).
    */
   envPathOf?: (env: string) => string;
 }
-/** Collect every env-var-backed leaf from the scope schemas. */
-export declare function collectEnvVars(scopes: ConfigScopes, envPrefix?: string, options?: CollectEnvVarsOptions): EnvVarDef[];
-/** Collect the env var names marked `required` for a scope. */
-export declare function collectRequiredEnvVars(scopes: ConfigScopes, scope: string, envPrefix?: string, options?: CollectEnvVarsOptions): string[];
+/** Collect every config leaf from scoped schemas. */
+export declare function collectVars(schema: ConfigSchema, envPrefix?: string, options?: CollectVarsOptions): ConfigDef[];
+/** Collect the config paths marked `required` for a scope. */
+export declare function collectRequired(schema: ConfigSchema, scope?: string, envPrefix?: string, options?: CollectVarsOptions): ConfigDef[];
+/** Normalize a config path for the collected definitions. */
+export declare function pathOf(def: ConfigDef): string;
 //#endregion

package/dist/packages/config/src/collect.js

@@ -1 +1 @@
-import"node:path";import"node:url";import.meta.url;import{envMetaOf as e}from"./schema.js";import{envPathOf as t}from"./types.js";const n=`APP_`;function r(e){let t=Array.isArray(e)?e:[e];if(t.includes(`array`))return`array`;if(t.includes(`object`))return`object`;if(t.includes(`boolean`))return`boolean`;if(t.includes(`number`))return`number`;if(t.includes(`string`))return`string`}function i(n,a,o,s){let c=e(n);if(c?.env){let e;try{e=n.toJSONSchema?.()}catch{}a.push({name:c.env,path:c.path??s.envPathOf?.(c.env)??t(c.env,o),...c.description?{description:c.description}:{},...e?.default===void 0?{}:{default:e.default},...c.required?{required:!0}:{},...c.secret?{secret:!0}:{},scope:c.scope??`default`,...c.public?{public:!0}:{},...r(e?.type)?{envType:r(e?.type)}:{}});return}let l=n.shape;if(l)for(let e of Object.values(l))i(e,a,o,s)}function a(e,t=n,r={}){let a=[];for(let[n,o]of Object.entries(e)){let e=a.length;i(o.zodSchema,a,t,r);for(let t=e;t<a.length;t++)(!a[t].scope||a[t].scope==="default")&&(a[t].scope=n)}return a}function o(e,t,r=n,i={}){return a(e,r,i).filter(e=>e.scope===t&&e.required).map(e=>e.name)}export{n as DEFAULT_ENV_PREFIX,a as collectEnvVars,o as collectRequiredEnvVars};
+import"node:path";import"node:url";import.meta.url;import{isZodSchema as e,metaOf as t,normalizeConfigSchema as n}from"./schema.js";const r=`APP_`;function i(e){let t=Array.isArray(e)?e:[e];if(t.includes(`array`))return`array`;if(t.includes(`object`))return`object`;if(t.includes(`boolean`))return`boolean`;if(t.includes(`number`)||t.includes(`integer`))return`number`;if(t.includes(`string`))return`string`}function a(t){return e(t)?t.shape:t.properties}function o(t){if(e(t))try{return i(t.toJSONSchema().type)}catch{return}return i(t.type)}function s(t){if(e(t))try{return t.toJSONSchema().default}catch{return}return t.default}function c(e){let t=Object.entries(e).map(([e,t])=>[e,s(t)]).filter(([,e])=>e!==void 0);return t.length>0?Object.fromEntries(t):void 0}function l(e,n,r,i,u,d=[]){let f=t(e),p=a(e),m=f?.envPath??f?.path??d.join(`.`),h=f?.envName??f?.env,g=f?.cliFlag??(h?`--${h.slice(h.startsWith(i)?i.length:0).toLowerCase().replace(/_/g,`-`)}`:void 0),_=p?c(p):void 0,v=p?`object`:o(e);if((!p||h||f?.cliFlag)&&n.push({path:m||(f?.id??`config`),...h?{name:h}:{},...g?{cliFlag:g}:{},...f?.description?{description:f.description}:{},...s(e)===void 0?_===void 0?{}:{default:_}:{default:s(e)},...f?.required?{required:!0}:{},...f?.secret?{secret:!0}:{},...f?.public?{public:!0}:{},...f?.scope?{scope:f.scope}:{scope:r},...v?{type:v}:{},...f?{meta:f}:{}}),p)for(let[e,t]of Object.entries(p))l(t,n,r,i,u,[...d,e])}function u(e,t=r,i={}){let a=n(e),o=[];for(let[e,n]of Object.entries(a)){let r=o.length;l(n,o,e,t,i);for(let t=r;t<o.length;t++)(!o[t].scope||o[t].scope==="default")&&(o[t].scope=e)}return o}function d(e,t,n=r,i={}){return u(e,n,i).filter(e=>e.required&&(t===void 0||e.scope===t))}function f(e){return e.meta?.envPath??e.meta?.path??e.path}export{r as DEFAULT_ENV_PREFIX,d as collectRequired,u as collectVars,f as pathOf};