@deltabox/toolchain 1.11.4 → 2.1.0

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"`,`notes="$(${n} changelog --release-notes "$version")"`,`[ -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};

package/dist/packages/config/src/config-json.d.ts

@@ -1,7 +1,7 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
-import { ConfigScopes } from "./types.js";
-import { CollectEnvVarsOptions } from "./collect.js";
+import { ConfigSchema } from "./types.js";
+import { CollectVarsOptions } from "./collect.js";
 //#region packages/config/src/config-json.d.ts
 /** A serialized env var entry in `config.json`. */
 export interface ConfigJsonEntry {
@@ -26,8 +26,8 @@ export interface BuildConfigJsonOptions {
   /** Override the `$comment` banner. */
   comment?: string;
   /** Custom env-name -> dotted-path derivation. */
-  envPathOf?: CollectEnvVarsOptions['envPathOf'];
+  envPathOf?: CollectVarsOptions['envPathOf'];
 }
 /** Build the config metadata JSON document. */
-export declare function buildConfigJson(scopes: ConfigScopes, options?: BuildConfigJsonOptions): ConfigJsonDoc;
+export declare function buildConfigJson(schema: ConfigSchema, options?: BuildConfigJsonOptions): ConfigJsonDoc;
 //#endregion

package/dist/packages/config/src/config-json.js

@@ -1 +1 @@
-import"node:path";import"node:url";import.meta.url;import{collectEnvVars as e}from"./collect.js";function t(t,n={}){let r=e(t,n.envPrefix,{envPathOf:n.envPathOf});return{$comment:n.comment??`Generated from the config engine — edit the config schemas instead.`,version:1,env:r.map(e=>({name:e.name,path:e.path,scope:e.scope,...e.description?{description:e.description}:{},...e.default===void 0?{}:{default:e.default},...e.required?{required:!0}:{},...e.secret?{secret:!0}:{},...e.public?{public:!0}:{}}))}}export{t as buildConfigJson};
+import"node:path";import"node:url";import.meta.url;import{collectVars as e}from"./collect.js";function t(t,n={}){let r=e(t,n.envPrefix,{envPathOf:n.envPathOf}).filter(e=>e.name);return{$comment:n.comment??`Generated from the config engine — edit the config schemas instead.`,version:1,env:r.map(e=>({name:e.name??``,path:e.path,scope:e.scope,...e.description?{description:e.description}:{},...e.default===void 0?{}:{default:e.default},...e.required?{required:!0}:{},...e.secret?{secret:!0}:{},...e.public?{public:!0}:{}}))}}export{t as buildConfigJson};

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

@@ -1,6 +1,6 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
-import { ConfigEngineOptions, ConfigScopes, EnvVarDef } from "./types.js";
+import { ConfigDef, ConfigEngineOptions, ConfigSchema } from "./types.js";
 import { BuildConfigJsonOptions, ConfigJsonDoc } from "./config-json.js";
 import { EnvFileOptions } from "./env-file.js";
 import { CliOptionDef, GenerateCliOptionsOptions } from "./generators/cli.js";
@@ -9,48 +9,37 @@ import { GenerateJsonSchemaOptions } from "./generators/json.js";
 import { GenerateMarkdownOptions } from "./generators/markdown.js";
 import { GenerateTypesOptions } from "./generators/types.js";
 //#region packages/config/src/engine.d.ts
-/** The bound, reusable config engine. */
 export interface ConfigEngine {
-  readonly scopes: ConfigScopes;
+  readonly schema: ConfigSchema;
   readonly envPrefix: string;
   readonly baseGroup: string;
   readonly root: string;
-  /** Every env-var-backed leaf across the registered scopes. */
-  collectEnvVars(): EnvVarDef[];
-  /** The names of the required env vars for a scope. */
-  requiredEnvVars(scope: string): string[];
-  /** Render `.env` content. */
-  renderEnvFile(options?: EnvFileOptions): string;
-  /** Write a `.env` file. Returns the path written. */
-  writeEnvFile(options: EnvFileOptions & {
-    output: string;
-  }): string;
-  /** Build the config metadata JSON document. */
+  collectVars(): ConfigDef[];
+  requiredVars(scope?: string): ConfigDef[];
+  generateEnvFile(options?: EnvFileOptions): string;
   buildConfigJson(options?: BuildConfigJsonOptions): ConfigJsonDoc;
-  /** Build (and optionally write) the untyped JSON Schema document. */
   generateJsonSchema(options?: GenerateJsonSchemaOptions): Promise<Record<string, unknown>>;
-  /** Write the JSON Schema document. Returns the path written. */
   writeJsonSchema(options: GenerateJsonSchemaOptions & {
     output: string;
   }): Promise<string>;
-  /** Render every config type file, keyed by scope name. */
-  renderConfigTypes(options?: GenerateTypesOptions): Record<string, string>;
-  /** Write the config type files into `outputDir`. */
+  generateConfigTypes(options?: GenerateTypesOptions): Record<string, string>;
+  generateConfigEnv(options?: GenerateEnvTypesOptions): Record<string, string>;
+  generateConfigMarkdown(options?: GenerateMarkdownOptions): Record<string, string>;
+  generateConfigCli(options?: GenerateCliOptionsOptions): CliOptionDef[];
+  writeEnvFile(options: EnvFileOptions & {
+    output: string;
+  }): string;
   writeConfigTypes(options: GenerateTypesOptions & {
     outputDir: string;
   }): string[];
-  /** Write the env type files into `outputDir`. */
   writeEnvTypes(options: GenerateEnvTypesOptions & {
     outputDir: string;
   }): string[];
-  /** Write the markdown reference into `outDir`. */
   writeMarkdown(options: GenerateMarkdownOptions & {
-    outDir: string;
+    outputDir: string;
   }): string[];
-  /** Generate (and optionally write) the CLI option definitions. */
   generateCliOptions(options?: GenerateCliOptionsOptions): CliOptionDef[];
 }
-/** Create a reusable config engine. */
 export declare function createConfigEngine(options: ConfigEngineOptions): ConfigEngine;
 //#endregion
-export type { ConfigEngineOptions, ConfigScopes };
+export type { ConfigEngineOptions };

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

@@ -1 +1 @@
-import{default as e}from"node:path";import"node:url";import.meta.url;import{collectEnvVars as t,collectRequiredEnvVars as n}from"./collect.js";import{buildConfigJson as r}from"./config-json.js";import{generateEnvFile as i}from"./env-file.js";import{generateCliOptions as a}from"./generators/cli.js";import{generateEnvTypes as o}from"./generators/env.js";import{generateConfigJsonSchema as s,generateJsonSchemaFile as c}from"./generators/json.js";import{generateConfigMarkdown as l}from"./generators/markdown.js";import{generateConfigTypes as u,renderAllConfigTypes as d}from"./generators/types.js";import{findProjectRoot as f}from"./root.js";import p from"node:fs";function m(m){let h=m.scopes,g=m.envPrefix??`APP_`,_=m.baseGroup??`base`,v=m.root??f(),y=m.envPathOf;return{scopes:h,envPrefix:g,baseGroup:_,root:v,collectEnvVars:()=>t(h,g,{envPathOf:y}),requiredEnvVars:e=>n(h,e,g,{envPathOf:y}),renderEnvFile:(e={})=>i(h,{envPrefix:g,envPathOf:y,...e}),writeEnvFile:t=>{let n=i(h,{envPrefix:g,envPathOf:y,...t});return p.mkdirSync(e.dirname(t.output),{recursive:!0}),p.writeFileSync(t.output,n,`utf-8`),t.output},buildConfigJson:(e={})=>r(h,{envPrefix:g,envPathOf:y,...e}),generateJsonSchema:(e={})=>s(h,{baseGroup:_,...e}),writeJsonSchema:e=>c(h,{baseGroup:_,...e}),renderConfigTypes:(e={})=>d(h,{baseGroup:_,...e}),writeConfigTypes:e=>u(h,{baseGroup:_,...e}),writeEnvTypes:e=>o(h,{envPrefix:g,envPathOf:y,...e}),writeMarkdown:e=>l(h,{baseGroup:_,envPrefix:g,envPathOf:y,...e}),generateCliOptions:(e={})=>a(h,{envPrefix:g,envPathOf:y,...e})}}export{m as createConfigEngine};
+import{default as e}from"node:path";import"node:url";import.meta.url;import{collectVars as t}from"./collect.js";import{buildConfigJson as n}from"./config-json.js";import{generateEnvFile as r}from"./env-file.js";import{generateCliOptions as i}from"./generators/cli.js";import{generateConfigEnv as a}from"./generators/env.js";import{generateConfigJsonSchema as o,generateJsonSchemaFile as s}from"./generators/json.js";import{generateConfigMarkdown as c}from"./generators/markdown.js";import{generateConfigTypes as l}from"./generators/types.js";import{findProjectRoot as u}from"./root.js";import d from"node:fs";function f(f){let p=f.schema,m=f.envPrefix??`APP_`,h=f.baseGroup??`base`,g=f.root??u(),_=f.envPathOf,v=String(Array.isArray(h)?h[0]??`base`:h);return{schema:p,envPrefix:m,baseGroup:v,root:g,collectVars:()=>t(p,m,{envPathOf:_}),requiredVars:e=>t(p,m,{envPathOf:_}).filter(t=>t.required&&(e===void 0||t.scope===e)),generateEnvFile:(e={})=>r(p,{envPrefix:m,envPathOf:_,...e}),buildConfigJson:(e={})=>n(p,{envPrefix:m,envPathOf:_,...e}),generateJsonSchema:(e={})=>o(p,{baseGroup:v,...e}),writeJsonSchema:e=>s(p,{baseGroup:v,...e}),generateConfigTypes:(e={})=>l(p,{baseGroup:v,...e}),generateConfigEnv:(e={})=>a(p,{envPrefix:m,envPathOf:_,...e}),generateConfigMarkdown:(e={})=>c(p,{baseGroup:v,envPrefix:m,envPathOf:_,...e}),generateConfigCli:(e={})=>i(p,{envPrefix:m,envPathOf:_,...e}),writeEnvFile:t=>{let n=r(p,{envPrefix:m,envPathOf:_,...t});return d.mkdirSync(e.dirname(t.output),{recursive:!0}),d.writeFileSync(t.output,n,`utf-8`),t.output},writeConfigTypes:t=>{let n=l(p,{baseGroup:v,...t});return Object.keys(n).map(n=>e.join(t.outputDir,`${n}.ts`))},writeEnvTypes:t=>{let n=a(p,{envPrefix:m,envPathOf:_,...t});return Object.keys(n).map(n=>e.join(t.outputDir,n))},writeMarkdown:t=>{let n=c(p,{baseGroup:v,envPrefix:m,envPathOf:_,...t});return Object.keys(n).map(n=>e.join(t.outputDir,n))},generateCliOptions:(e={})=>i(p,{envPrefix:m,envPathOf:_,...e})}}export{f as createConfigEngine};

package/dist/packages/config/src/env-file.d.ts

@@ -1,7 +1,7 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
-import { ConfigScopes } from "./types.js";
-import { CollectEnvVarsOptions } from "./collect.js";
+import { ConfigSchema } from "./types.js";
+import { CollectVarsOptions } from "./collect.js";
 //#region packages/config/src/env-file.d.ts
 export interface EnvFileOptions {
   /** Env vars to include (defaults to all). */
@@ -23,11 +23,11 @@ export interface EnvFileOptions {
   /** The characters wrapping a scope's section header (default `----`). */
   scopeSeparator?: string;
   /** Custom env-name -> dotted-path derivation. */
-  envPathOf?: CollectEnvVarsOptions['envPathOf'];
+  envPathOf?: CollectVarsOptions['envPathOf'];
 }
 /**
  * Generate `.env` content from the config schemas. Secrets and required-without-
  * default vars are emitted blank so operators fill them in.
  */
-export declare function generateEnvFile(scopes: ConfigScopes, options?: EnvFileOptions): string;
+export declare function generateEnvFile(schema: ConfigSchema, options?: EnvFileOptions): string;
 //#endregion

package/dist/packages/config/src/env-file.js

@@ -1,3 +1,3 @@
-import"node:path";import"node:url";import.meta.url;import{collectEnvVars as e}from"./collect.js";function t(e){let t=e.default;return Array.isArray(t)?t.join(`,`):typeof t==`boolean`?t?`true`:`false`:typeof t==`number`?String(t):typeof t==`object`&&t?JSON.stringify(t):t===void 0?``:String(t)}function n(n,r={}){let i=r.envPrefix??`APP_`,a=r.scopeSeparator??`----`,o=e(n,i,{envPathOf:r.envPathOf}),s=r.scopes??Object.keys(n),c=o.filter(e=>s.includes(e.scope)&&(!r.include||r.include.includes(e.name))&&!r.exclude?.includes(e.name)),l=[];r.header&&l.push(r.header,``);let u;for(let e of c){if(e.scope!==u&&(u!==void 0&&l.push(``),l.push(`# ${a} ${e.scope.toUpperCase()} ${a}`),u=e.scope),!r.bare&&e.description)for(let t of e.description.split(`
-`))l.push(`# ${t}`);let n=r.values?.[e.name];e.secret&&n===void 0?l.push(`# ${e.name}=`):l.push(`${e.name}=${n??t(e)}`)}if(r.extra){let e=Object.entries(r.extra).filter(([e])=>!c.some(t=>t.name===e)).map(([e,t])=>`${e}=${t}`);e.length&&l.push(``,`# ${a} EXTRA ${a}`,...e)}return`${l.join(`
+import"node:path";import"node:url";import.meta.url;import{collectVars as e}from"./collect.js";function t(e){let t=e.default;return Array.isArray(t)?t.join(`,`):typeof t==`boolean`?t?`true`:`false`:typeof t==`number`?String(t):typeof t==`object`&&t?JSON.stringify(t):t===void 0?``:String(t)}function n(n,r={}){let i=r.envPrefix??`APP_`,a=r.scopeSeparator??`----`,o=e(n,i,{envPathOf:r.envPathOf}).filter(e=>e.name!==void 0),s=r.scopes??[...new Set(o.map(e=>e.scope))],c=o.filter(e=>s.includes(e.scope)&&(!r.include||r.include.includes(e.name))&&!r.exclude?.includes(e.name)),l=[];r.header&&l.push(r.header,``);let u;for(let e of c){let n=e.name;if(e.scope!==u&&(u!==void 0&&l.push(``),l.push(`# ${a} ${e.scope.toUpperCase()} ${a}`),u=e.scope),!r.bare&&e.description)for(let t of e.description.split(`
+`))l.push(`# ${t}`);let i=r.values?.[n];e.secret&&i===void 0?l.push(`# ${n}=`):l.push(`${n}=${i??t(e)}`)}if(r.extra){let e=Object.entries(r.extra).filter(([e])=>!c.some(t=>t.name===e)).map(([e,t])=>`${e}=${t}`);e.length&&l.push(``,`# ${a} EXTRA ${a}`,...e)}return`${l.join(`
 `)}\n`}export{n as generateEnvFile};

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

@@ -3,8 +3,8 @@ import __tsdown_shims_url from 'node:url';
 //#region packages/config/src/env.d.ts
 /**
  * Low-level configuration helpers: env-tree parsing, typed accessors and
- * override merging. Free of Node builtins so browser consumers can import the
- * frontend resolver without pulling `node:path` / `node:url` into a bundle.
+ * dotted-path derivation. Free of Node builtins so browser consumers can import
+ * the frontend resolver without pulling `node:path` / `node:url` into a bundle.
  */
 /** A flat env source (process.env, import.meta.env or a plain object). */
 export type EnvSource = Record<string, string | undefined>;
@@ -24,8 +24,6 @@ export declare function envBool(tree: EnvTree, path: string, fallback: boolean):
 export declare function envList(tree: EnvTree, path: string, fallback?: string[]): string[];
 /** Read `Header=value,...` into a lowercase-keyed record. */
 export declare function envMap(tree: EnvTree, path: string): Record<string, string>;
-/** Recursively merge typed overrides over a base object (shallow per level). */
-export declare function applyOverrides<T extends object>(base: T, overrides?: Partial<T>): T;
-/** Trim trailing slashes from a URL-ish string. */
-export declare function trimTrailingSlashes(value: string): string;
+/** Derive the dotted config path from an env var name + prefix. */
+export declare function envPathOf(env: string, prefix?: string): string;
 //#endregion

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

@@ -1 +1 @@
-import"node:path";import"node:url";import.meta.url;function e(e={},t=`APP_`){let n={};for(let[r,i]of Object.entries(e)){if(!r.startsWith(t)||i===void 0)continue;let e=r.slice(t.length).toLowerCase().split(`_`),a=n;for(let t=0;t<e.length-1;t+=1){let n=e[t]??``;(typeof a[n]!=`object`||a[n]===null)&&(a[n]={}),a=a[n]}a[e[e.length-1]??``]=i}return n}function t(e,t){let n=e;for(let e of t.split(`.`)){if(typeof n!=`object`||!n)return;n=n[e]}return n}function n(e,n,r=``){let i=t(e,n);return typeof i==`string`&&i.trim()!==``?i:r}function r(e,n,r){let i=t(e,n);if(typeof i!=`string`||i.trim()===``)return r;let a=Number.parseInt(i,10);return Number.isFinite(a)?a:r}function i(e,n,r){let i=t(e,n);if(typeof i!=`string`||i.trim()===``)return r;let a=i.trim().toLowerCase();return[`true`,`1`,`yes`,`on`].includes(a)?!0:![`false`,`0`,`no`,`off`].includes(a)&&r}function a(e,n,r=[]){let i=t(e,n);return typeof i!=`string`||i.trim()===``?r:i.split(`,`).map(e=>e.trim()).filter(Boolean)}function o(e,t){let n={};for(let r of a(e,t,[])){let e=r.indexOf(`=`);e!==-1&&(n[r.slice(0,e).trim().toLowerCase()]=r.slice(e+1).trim())}return n}function s(e,t){if(!t)return e;let n={...e};for(let[r,i]of Object.entries(t)){if(i===void 0)continue;let t=e[r];n[r]=t&&typeof t==`object`&&!Array.isArray(t)&&i&&typeof i==`object`&&!Array.isArray(i)?s(t,i):i}return n}function c(e){return e.replace(/\/+$/,``)}export{s as applyOverrides,i as envBool,r as envInt,a as envList,o as envMap,n as envString,e as parseEnvTree,t as readEnvPath,c as trimTrailingSlashes};
+import"node:path";import"node:url";import.meta.url;function e(e={},t=`APP_`){let n={};for(let[r,i]of Object.entries(e)){if(!r.startsWith(t)||i===void 0)continue;let e=r.slice(t.length).toLowerCase().split(`_`),a=n;for(let t=0;t<e.length-1;t+=1){let n=e[t]??``;(typeof a[n]!=`object`||a[n]===null)&&(a[n]={}),a=a[n]}a[e[e.length-1]??``]=i}return n}function t(e,t){let n=e;for(let e of t.split(`.`)){if(typeof n!=`object`||!n)return;n=n[e]}return n}function n(e,n,r=``){let i=t(e,n);return typeof i==`string`&&i.trim()!==``?i:r}function r(e,n,r){let i=t(e,n);if(typeof i!=`string`||i.trim()===``)return r;let a=Number.parseInt(i,10);return Number.isFinite(a)?a:r}function i(e,n,r){let i=t(e,n);if(typeof i!=`string`||i.trim()===``)return r;let a=i.trim().toLowerCase();return[`true`,`1`,`yes`,`on`].includes(a)?!0:![`false`,`0`,`no`,`off`].includes(a)&&r}function a(e,n,r=[]){let i=t(e,n);return typeof i!=`string`||i.trim()===``?r:i.split(`,`).map(e=>e.trim()).filter(Boolean)}function o(e,t){let n={};for(let r of a(e,t,[])){let e=r.indexOf(`=`);e!==-1&&(n[r.slice(0,e).trim().toLowerCase()]=r.slice(e+1).trim())}return n}function s(e,t=`APP_`){return e.slice(e.startsWith(t)?t.length:0).toLowerCase().replace(/_/g,`.`)}export{i as envBool,r as envInt,a as envList,o as envMap,s as envPathOf,n as envString,e as parseEnvTree,t as readEnvPath};

package/dist/packages/config/src/generators/cli.d.ts

@@ -1,7 +1,7 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
-import { ConfigScopes } from "../types.js";
-import { CollectEnvVarsOptions } from "../collect.js";
+import { ConfigSchema } from "../types.js";
+import { CollectVarsOptions } from "../collect.js";
 import { ParseArgsOptionsConfig } from "node:util";
 //#region packages/config/src/generators/cli.d.ts
 /** Flag-shaping options shared by every CLI helper. */
@@ -11,9 +11,9 @@ export interface CliFlagOptions {
   /** Shorthand flags keyed by env var name (eg. `{ APP_TOKEN: 't' }`). */
   shortFlags?: Record<string, string>;
   /** Custom env-name -> dotted-path derivation. */
-  envPathOf?: CollectEnvVarsOptions['envPathOf'];
+  envPathOf?: CollectVarsOptions['envPathOf'];
 }
-/** A generated CLI option definition for one env var. */
+/** A generated CLI option definition. */
 export interface CliOptionDef {
   /** CLI flag, e.g. `--base-url`. */
   flag: string;
@@ -42,10 +42,10 @@ export interface GenerateCliOptionsOptions extends CliFlagOptions {
   /** The scope whose env vars become flags (default `cli`). */
   scope?: string;
   /** Output file path to write the options as JSON. */
-  output?: string;
+  output?: string | false;
 }
 /** Generate the CLI option definitions for a scope's env vars. */
-export declare function generateCliOptions(scopes: ConfigScopes, options?: GenerateCliOptionsOptions): CliOptionDef[];
+export declare function generateCliOptions(schema: ConfigSchema, options?: GenerateCliOptionsOptions): CliOptionDef[];
 /** The typed `values` of a parsed CLI args result. */
 export type CliArgsValues = Record<string, string | undefined>;
 /** A parsed CLI args result (node `parseArgs` output). */

package/dist/packages/config/src/generators/cli.js

@@ -1 +1 @@
-import"node:path";import"node:url";import.meta.url;import{formatCliFlag as e}from"../../../shared/src/string-utils.js";import"../../../shared/src/index.js";import{collectEnvVars as t}from"../collect.js";import n from"node:fs";import{parseArgs as r}from"node:util";function i(t,n={}){return e(t,n.envPrefix??`APP_`)}function a(e,t={}){return`--${i(e,t)}`}function o(e,t={}){let n=t.shortFlags?.[e];return n?`-${n}`:void 0}function s(e,t={}){let n=a(e,t),r=o(e,t);return r?`${r}, ${n}`:n}function c(e,r={}){let i=r.scope??`cli`,s=[];for(let n of t(e,r.envPrefix,{envPathOf:r.envPathOf}).filter(e=>e.scope===i)){let e=o(n.name,r);s.push({flag:a(n.name,r),env:n.name,type:n.envType??`string`,...e?{short:e}:{},...n.description?{description:n.description}:{},...n.secret?{secret:!0}:{},...n.default!==void 0&&!n.secret?{default:String(n.default)}:{}})}return r.output&&n.writeFileSync(r.output,`${JSON.stringify(s,null,4)}\n`,`utf-8`),s}function l(e){return Object.fromEntries(e.map(e=>[e.flag.replace(/^--/,``),{type:`string`,...e.short?{short:e.short.replace(/^-/,``)}:{},...e.default?{default:e.default}:{}}]))}function u(e,t){let n=l(e);return{options:n,parse:(e=process.argv.slice(2))=>r({args:e,options:n,strict:t?.strict??!0}),toConfig:e=>{let t=e?.values??{},n={};for(let[e,r]of Object.entries(t))r!==void 0&&(n[e]=r);return n}}}export{s as cliFlagLabel,a as cliFlagOf,o as cliShortOf,u as createCliArgsParser,i as flagOf,l as generateCliArgsOptions,c as generateCliOptions};
+import"node:path";import"node:url";import.meta.url;import{formatCliFlag as e}from"../../../shared/src/string-utils.js";import"../../../shared/src/index.js";import{collectVars as t}from"../collect.js";import n from"node:fs";import{parseArgs as r}from"node:util";function i(t,n={}){return e(t,n.envPrefix??`APP_`)}function a(e,t={}){return`--${i(e,t)}`}function o(e,t={}){let n=t.shortFlags?.[e];return n?`-${n}`:void 0}function s(e,t={}){let n=a(e,t),r=o(e,t);return r?`${r}, ${n}`:n}function c(e,r={}){let i=r.scope??`cli`,s=[];for(let n of t(e,r.envPrefix,{envPathOf:r.envPathOf}).filter(e=>e.scope===i&&(e.name||e.cliFlag))){let e=n.meta?.cliFlagShort?`-${n.meta.cliFlagShort.replace(/^-/,``)}`:o(n.name??``,r);s.push({flag:n.cliFlag??a(n.name??``,r),env:n.name??``,type:n.type??`string`,...e?{short:e}:{},...n.description?{description:n.description}:{},...n.secret?{secret:!0}:{},...n.default!==void 0&&!n.secret?{default:String(n.default)}:{}})}return typeof r.output==`string`&&n.writeFileSync(r.output,`${JSON.stringify(s,null,4)}\n`,`utf-8`),s}function l(e){return Object.fromEntries(e.map(e=>[e.flag.replace(/^--/,``),{type:`string`,...e.short?{short:e.short.replace(/^-/,``)}:{},...e.default?{default:e.default}:{}}]))}function u(e,t){let n=l(e);return{options:n,parse:(e=process.argv.slice(2))=>r({args:e,options:n,strict:t?.strict??!0}),toConfig:e=>{let t=e?.values??{},n={};for(let[e,r]of Object.entries(t))r!==void 0&&(n[e]=r);return n}}}export{s as cliFlagLabel,a as cliFlagOf,o as cliShortOf,u as createCliArgsParser,i as flagOf,l as generateCliArgsOptions,c as generateCliOptions};

package/dist/packages/config/src/generators/env.d.ts

@@ -1,11 +1,11 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
-import { ConfigScopes } from "../types.js";
-import { CollectEnvVarsOptions } from "../collect.js";
+import { ConfigSchema } from "../types.js";
+import { CollectVarsOptions } from "../collect.js";
 //#region packages/config/src/generators/env.d.ts
 export interface GenerateEnvTypesOptions {
   /** Output directory. When omitted, nothing is written. */
-  outputDir?: string;
+  outputDir?: string | false;
   /** The env-var prefix (default `APP_`). */
   envPrefix?: string;
   /** The `process.env` interface name (default `AppEnv`). */
@@ -29,14 +29,14 @@ export interface GenerateEnvTypesOptions {
   /** Add a `declare module 'vite'` augmentation to the `.d.ts`. */
   augmentVite?: boolean;
   /** Custom env-name -> dotted-path derivation. */
-  envPathOf?: CollectEnvVarsOptions['envPathOf'];
+  envPathOf?: CollectVarsOptions['envPathOf'];
 }
 /** Render the `env.ts` content (the env + vite-env interfaces). */
-export declare function generateEnv(scopes: ConfigScopes, options?: GenerateEnvTypesOptions): string;
+export declare function generateEnv(schema: ConfigSchema, options?: GenerateEnvTypesOptions): string;
 /** Render the ambient `.d.ts` content. */
 export declare function generateEnvDts(options?: GenerateEnvTypesOptions): string;
-/** Generate `env.ts` + the ambient `.d.ts` into `outputDir`. Returns the paths. */
-export declare function generateEnvTypes(scopes: ConfigScopes, options: GenerateEnvTypesOptions & {
-  outputDir: string;
-}): string[];
+/** Generate env type file contents (and optionally write them). */
+export declare function generateConfigEnv(schema: ConfigSchema, options?: GenerateEnvTypesOptions): Record<string, string>;
+/** @deprecated Use {@link generateConfigEnv}. */
+export declare const generateEnvTypes: typeof generateConfigEnv;
 //#endregion

package/dist/packages/config/src/generators/env.js

@@ -1,4 +1,4 @@
-import{default as e}from"node:path";import"node:url";import.meta.url;import{collectEnvVars as t}from"../collect.js";import n from"node:fs";function r(e){return e??`Generated env typing — DO NOT EDIT.`}function i(e,n={}){let i=n.envPrefix??`APP_`,a=n.envInterfaceName??`AppEnv`,o=n.viteEnvInterfaceName??`AppViteEnv`,s=t(e,i,{envPathOf:n.envPathOf}),c=s.filter(e=>e.scope!==`frontend`),l=s.filter(e=>e.public),u=n.envHeader?[n.envHeader,``]:[`/**`,` * ${r(n.header)}`,` */`,``];u.push(`/** ${n.envComment??"Environment variables typed on `process.env`."} */`,`export interface ${a} {`);for(let e of c)u.push(`    /** ${(e.description??``).replace(/\n/g,` `)} */`),u.push(`    ${e.name}?: string;`);u.push(`}`),u.push(``),u.push("/** Public frontend environment variables typed on `import.meta.env`. */"),u.push(`export interface ${o} {`);for(let e of l)u.push(`    /** ${(e.description??``).replace(/\n/g,` `)} */`),u.push(`    ${e.name}?: string;`);return u.push(`}`),`${u.join(`
+import{default as e}from"node:path";import"node:url";import.meta.url;import{collectVars as t}from"../collect.js";import n from"node:fs";function r(e){return e??`Generated env typing — DO NOT EDIT.`}function i(e,n={}){let i=n.envPrefix??`APP_`,a=n.envInterfaceName??`AppEnv`,o=n.viteEnvInterfaceName??`AppViteEnv`,s=t(e,i,{envPathOf:n.envPathOf}).filter(e=>e.name),c=s.filter(e=>e.scope!==`frontend`),l=s.filter(e=>e.public),u=n.envHeader?[n.envHeader,``]:[`/**`,` * ${r(n.header)}`,` */`,``];u.push(`/** ${n.envComment??"Environment variables typed on `process.env`."} */`,`export interface ${a} {`);for(let e of c)u.push(`    /** ${(e.description??``).replace(/\n/g,` `)} */`),u.push(`    ${e.name}?: string;`);u.push(`}`),u.push(``),u.push("/** Public frontend environment variables typed on `import.meta.env`. */"),u.push(`export interface ${o} {`);for(let e of l)u.push(`    /** ${(e.description??``).replace(/\n/g,` `)} */`),u.push(`    ${e.name}?: string;`);return u.push(`}`),`${u.join(`
 `).trimEnd()}\n`}function a(e={}){let t=e.envInterfaceName??`AppEnv`,n=e.viteEnvInterfaceName??`AppViteEnv`,i=e.importPath??`./env.js`;return`${e.dtsHeader?`${e.dtsHeader}\n`:`/**
  * ${r(e.header)}
  *
@@ -20,4 +20,4 @@ declare module 'vite' {
 }`:``}
 
 export {};
-`}function o(t,r){let o=e.join(r.outputDir,r.envFile??`env.ts`),s=e.join(r.outputDir,r.dtsFile??`env.d.ts`);return n.mkdirSync(r.outputDir,{recursive:!0}),n.writeFileSync(o,i(t,r),`utf-8`),n.writeFileSync(s,a(r),`utf-8`),[o,s]}export{i as generateEnv,a as generateEnvDts,o as generateEnvTypes};
+`}function o(t,r={}){let o=r.envFile??`env.ts`,s=r.dtsFile??`env.d.ts`,c={[o]:i(t,r),[s]:a(r)};if(typeof r.outputDir==`string`){n.mkdirSync(r.outputDir,{recursive:!0});for(let[t,i]of Object.entries(c))n.writeFileSync(e.join(r.outputDir,t),i,`utf-8`)}return c}const s=o;export{o as generateConfigEnv,i as generateEnv,a as generateEnvDts,s as generateEnvTypes};

package/dist/packages/config/src/generators/index.d.ts

@@ -1,8 +1,8 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
 import { CliArgsOptionConfig, CliArgsParser, CliArgsResult, CliArgsValues, CliFlagOptions, CliOptionDef, GenerateCliOptionsOptions, cliFlagLabel, cliFlagOf, cliShortOf, createCliArgsParser, flagOf, generateCliArgsOptions, generateCliOptions } from "./cli.js";
-import { GenerateEnvTypesOptions, generateEnv, generateEnvDts, generateEnvTypes } from "./env.js";
+import { GenerateEnvTypesOptions, generateConfigEnv, generateEnv, generateEnvDts, generateEnvTypes } from "./env.js";
 import { GenerateJsonSchemaOptions, generateConfigJsonSchema, generateJsonSchemaFile } from "./json.js";
-import { ConfigFileSection, GenerateMarkdownOptions, RenderConfigFileOptions, RenderMarkdownOptions, generateConfigMarkdown, renderConfigFileMarkdown, renderConfigIndex, renderScopeMarkdown } from "./markdown.js";
-import { GenerateTypesOptions, generateConfigTypes, renderAllConfigTypes, renderConfigImports, renderConfigTypes, resolveScopeSchema } from "./types.js";
-export { CliArgsOptionConfig, CliArgsParser, CliArgsResult, CliArgsValues, CliFlagOptions, CliOptionDef, ConfigFileSection, GenerateCliOptionsOptions, GenerateEnvTypesOptions, GenerateJsonSchemaOptions, GenerateMarkdownOptions, GenerateTypesOptions, RenderConfigFileOptions, RenderMarkdownOptions, cliFlagLabel, cliFlagOf, cliShortOf, createCliArgsParser, flagOf, generateCliArgsOptions, generateCliOptions, generateConfigJsonSchema, generateConfigMarkdown, generateConfigTypes, generateEnv, generateEnvDts, generateEnvTypes, generateJsonSchemaFile, renderAllConfigTypes, renderConfigFileMarkdown, renderConfigImports, renderConfigIndex, renderConfigTypes, renderScopeMarkdown, resolveScopeSchema };
+import { GenerateMarkdownOptions, RenderConfigFileOptions, RenderMarkdownFrontmatter, RenderMarkdownOptions, generateConfigMarkdown } from "./markdown.js";
+import { GenerateTypesOptions, generateConfigTypes } from "./types.js";
+export { CliArgsOptionConfig, CliArgsParser, CliArgsResult, CliArgsValues, CliFlagOptions, CliOptionDef, GenerateCliOptionsOptions, GenerateEnvTypesOptions, GenerateJsonSchemaOptions, GenerateMarkdownOptions, GenerateTypesOptions, RenderConfigFileOptions, RenderMarkdownFrontmatter, RenderMarkdownOptions, cliFlagLabel, cliFlagOf, cliShortOf, createCliArgsParser, flagOf, generateCliArgsOptions, generateCliOptions, generateConfigEnv, generateConfigJsonSchema, generateConfigMarkdown, generateConfigTypes, generateEnv, generateEnvDts, generateEnvTypes, generateJsonSchemaFile };

package/dist/packages/config/src/generators/index.js

@@ -1 +1 @@
-import"node:path";import"node:url";import.meta.url;import{cliFlagLabel as e,cliFlagOf as t,cliShortOf as n,createCliArgsParser as r,flagOf as i,generateCliArgsOptions as a,generateCliOptions as o}from"./cli.js";import{generateEnv as s,generateEnvDts as c,generateEnvTypes as l}from"./env.js";import{generateConfigJsonSchema as u,generateJsonSchemaFile as d}from"./json.js";import{generateConfigMarkdown as f,renderConfigFileMarkdown as p,renderConfigIndex as m,renderScopeMarkdown as h}from"./markdown.js";import{generateConfigTypes as g,renderAllConfigTypes as _,renderConfigImports as v,renderConfigTypes as y,resolveScopeSchema as b}from"./types.js";export{e as cliFlagLabel,t as cliFlagOf,n as cliShortOf,r as createCliArgsParser,i as flagOf,a as generateCliArgsOptions,o as generateCliOptions,u as generateConfigJsonSchema,f as generateConfigMarkdown,g as generateConfigTypes,s as generateEnv,c as generateEnvDts,l as generateEnvTypes,d as generateJsonSchemaFile,_ as renderAllConfigTypes,p as renderConfigFileMarkdown,v as renderConfigImports,m as renderConfigIndex,y as renderConfigTypes,h as renderScopeMarkdown,b as resolveScopeSchema};
+import"node:path";import"node:url";import.meta.url;import{cliFlagLabel as e,cliFlagOf as t,cliShortOf as n,createCliArgsParser as r,flagOf as i,generateCliArgsOptions as a,generateCliOptions as o}from"./cli.js";import{generateConfigEnv as s,generateEnv as c,generateEnvDts as l,generateEnvTypes as u}from"./env.js";import{generateConfigJsonSchema as d,generateJsonSchemaFile as f}from"./json.js";import{generateConfigMarkdown as p}from"./markdown.js";import{generateConfigTypes as m}from"./types.js";export{e as cliFlagLabel,t as cliFlagOf,n as cliShortOf,r as createCliArgsParser,i as flagOf,a as generateCliArgsOptions,o as generateCliOptions,s as generateConfigEnv,d as generateConfigJsonSchema,p as generateConfigMarkdown,m as generateConfigTypes,c as generateEnv,l as generateEnvDts,u as generateEnvTypes,f as generateJsonSchemaFile};

package/dist/packages/config/src/generators/json.d.ts

@@ -1,12 +1,10 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
-import { ConfigScopes } from "../types.js";
+import { ConfigEngineOptions, ConfigSchema } from "../types.js";
 //#region packages/config/src/generators/json.d.ts
-export interface GenerateJsonSchemaOptions {
+export interface GenerateJsonSchemaOptions extends Pick<ConfigEngineOptions, 'baseGroup'> {
   /** Output file path. When omitted, nothing is written. */
-  output?: string;
-  /** The base group hoisted to the top level (default `base`). */
-  baseGroup?: string;
+  output?: string | false;
   /** Document metadata overrides. */
   id?: string;
   title?: string;
@@ -16,9 +14,9 @@ export interface GenerateJsonSchemaOptions {
  * Build the combined untyped JSON Schema document covering every scope, using
  * untyped's `resolveSchema` on the definitions lowered from the Zod schemas.
  */
-export declare function generateConfigJsonSchema(scopes: ConfigScopes, options?: GenerateJsonSchemaOptions): Promise<Record<string, unknown>>;
+export declare function generateConfigJsonSchema(schema: ConfigSchema, options?: GenerateJsonSchemaOptions): Promise<Record<string, unknown>>;
 /** Generate the JSON Schema document into `output`. Returns the path written. */
-export declare function generateJsonSchemaFile(scopes: ConfigScopes, options: GenerateJsonSchemaOptions & {
+export declare function generateJsonSchemaFile(schema: ConfigSchema, options: GenerateJsonSchemaOptions & {
   output: string;
 }): Promise<string>;
 //#endregion

package/dist/packages/config/src/generators/json.js

@@ -1 +1 @@
-import{default as e}from"node:path";import"node:url";import.meta.url;import{flattenBaseSchema as t,zodToUntypedDefinition as n}from"../schema.js";import r from"node:fs";import{resolveSchema as i}from"untyped";async function a(a,o={}){let s={};for(let[e,r]of Object.entries(a))s[e]=t(await i(n(r.zodSchema)),o.baseGroup);let c={$schema:`https://json-schema.org/draft/2020-12/schema`,$id:o.id??`https://example.com/schemas/config.json`,title:o.title??`Configuration`,description:o.description??`Every env-var-backed configuration value across all scopes.`,type:`object`,properties:s,required:Object.keys(a)};return o.output&&(r.mkdirSync(e.dirname(o.output),{recursive:!0}),r.writeFileSync(o.output,`${JSON.stringify(c,null,4)}\n`,`utf-8`)),c}async function o(e,t){return await a(e,t),t.output}export{a as generateConfigJsonSchema,o as generateJsonSchemaFile};
+import{default as e}from"node:path";import"node:url";import.meta.url;import{flattenBaseSchema as t,normalizeConfigSchema as n}from"../schema.js";import r from"node:fs";async function i(i,a={}){let o=n(i),s={};for(let[e]of Object.entries(o))s[e]=t(o[e],Array.isArray(a.baseGroup)?String(a.baseGroup[0]??`base`):String(a.baseGroup??`base`));let c={$schema:`https://json-schema.org/draft/2020-12/schema`,$id:a.id??`https://example.com/schemas/config.json`,title:a.title??`Configuration`,description:a.description??`Every env-var-backed configuration value across all scopes.`,type:`object`,properties:s,required:Object.keys(o)};return typeof a.output==`string`&&(r.mkdirSync(e.dirname(a.output),{recursive:!0}),r.writeFileSync(a.output,`${JSON.stringify(c,null,4)}\n`,`utf-8`)),c}async function a(e,t){return await i(e,t),t.output}export{i as generateConfigJsonSchema,a as generateJsonSchemaFile};