@deltabox/toolchain 1.11.4 → 2.1.0

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

@@ -1,17 +1,24 @@
 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 { ZodType } from "zod";
-import { Schema } from "untyped";
+import { ConfigEngineOptions, ConfigSchema } from "../types.js";
+import { CollectVarsOptions } from "../collect.js";
 //#region packages/config/src/generators/markdown.d.ts
-export interface RenderMarkdownOptions {
-  /** Output directory. When omitted, nothing is written. */
-  outDir?: string;
+export interface RenderMarkdownFrontmatter {
+  options: GenerateMarkdownOptions;
+}
+export interface RenderMarkdownOptions extends Pick<ConfigEngineOptions, 'baseGroup'> {
+  /** Output directory. Set false (or omit it) to disable writing. */
+  outputDir?: string | false;
+  /** Frontmatter toggle, raw body, or callback. */
+  frontmatter?: boolean | string | ((ctx: RenderMarkdownFrontmatter) => string);
+  /** Render every scope into one file instead of one file per scope. */
+  combined?: boolean;
+  /** Show env var equivalents (default true). */
+  includeEnv?: boolean;
+  /** Show CLI flag equivalents (default true). */
+  includeCli?: boolean;
   /** Page outline (defaults to `[2, 3, 4]`). */
   outline?: number[];
-  /** The base group hoisted out of the nested groups (default `base`). */
-  baseGroup?: string;
   /** The scope whose env vars render as CLI flags (default `cli`). */
   cliScope?: string;
   /** Env-var prefix (default `APP_`). */
@@ -36,29 +43,34 @@ export interface RenderMarkdownOptions {
   /** Shorthand flags keyed by env var name (for the CLI scope). */
   shortFlags?: Record<string, string>;
   /** Custom env-name -> dotted-path derivation. */
-  envPathOf?: CollectEnvVarsOptions['envPathOf'];
+  envPathOf?: CollectVarsOptions['envPathOf'];
+  /** Emit `- **Required**` lines (default true). */
+  includeRequired?: boolean;
+  /** Emit `- **Deprecated**` lines (default true). */
+  includeDeprecated?: boolean;
+  /** Emit `**Example(s):**` blocks (default true). */
+  includeExamples?: boolean;
+  /** Emit `- **Since**` lines (default true). */
+  includeSince?: boolean;
+  /** Emit `- **See**` lines (default true). */
+  includeSee?: boolean;
+  /** Emit `**Remarks:**` blocks (default true). */
+  includeRemarks?: boolean;
+  /** Emit `- **Experimental**` lines (default true). */
+  includeExperimental?: boolean;
+  /** Emit `- **Alpha**` lines (default true). */
+  includeAlpha?: boolean;
+  /** Emit `- **Beta**` lines (default true). */
+  includeBeta?: boolean;
 }
 export interface GenerateMarkdownOptions extends RenderMarkdownOptions {
+  /** Document title (default `Configuration`). */
+  title?: string;
   /** Index file name (defaults to `index.md`). */
   indexFilename?: string;
 }
-/** Render the markdown reference for a single scope (base + grouped configs). */
-export declare function renderScopeMarkdown(scope: string, schema: Schema, options?: RenderMarkdownOptions): string;
-/** Render the index file: explains the env convention + lists required/core. */
-export declare function renderConfigIndex(scopes: ConfigScopes, options?: RenderMarkdownOptions): string;
-/** Generate the markdown reference (per-scope files + index) into `outDir`. */
-export declare function generateConfigMarkdown(scopes: ConfigScopes, options: GenerateMarkdownOptions & {
-  outDir: string;
-}): string[];
-/** A section of a config-file reference (its key + options schema). */
-export interface ConfigFileSection {
-  /** The config key, eg. `project`. */
-  key: string;
-  /** A short description shown under the heading. */
-  description?: string;
-  /** The section's options-object schema. */
-  schema: ZodType;
-}
+/** Generate markdown file contents (and optionally write them). */
+export declare function generateConfigMarkdown(schema: ConfigSchema, options?: GenerateMarkdownOptions): Record<string, string>;
 export interface RenderConfigFileOptions {
   /** Document title (default `Configuration`). */
   title?: string;
@@ -66,13 +78,23 @@ export interface RenderConfigFileOptions {
   intro?: string;
   /** Page outline (default `[2, 3, 4]`). */
   outline?: number[];
+  /** Emit `- **Required**` lines (default true). */
+  includeRequired?: boolean;
+  /** Emit `- **Deprecated**` lines (default true). */
+  includeDeprecated?: boolean;
+  /** Emit `**Example(s):**` blocks (default true). */
+  includeExamples?: boolean;
+  /** Emit `- **Since**` lines (default true). */
+  includeSince?: boolean;
+  /** Emit `- **See**` lines (default true). */
+  includeSee?: boolean;
+  /** Emit `**Remarks:**` blocks (default true). */
+  includeRemarks?: boolean;
+  /** Emit `- **Experimental**` lines (default true). */
+  includeExperimental?: boolean;
+  /** Emit `- **Alpha**` lines (default true). */
+  includeAlpha?: boolean;
+  /** Emit `- **Beta**` lines (default true). */
+  includeBeta?: boolean;
 }
-/**
- * Render a single markdown reference for a config **file** (no environment-var
- * language): one `## \`key\`` section per schema, with its fields, types,
- * defaults and descriptions. Named sub-schemas (`$defs`) are resolved and
- * expanded inline, so nested options (`changelog.versioning.target`, ...) are
- * documented too. This is what a `dbx.config.ts`-style reference is generated from.
- */
-export declare function renderConfigFileMarkdown(sections: ConfigFileSection[], options?: RenderConfigFileOptions): string;
 //#endregion

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

@@ -1,27 +1,26 @@
-import{default as e}from"node:path";import"node:url";import.meta.url;import{sanitizeText as t,titleCase as n}from"../../../shared/src/string-utils.js";import"../../../shared/src/index.js";import{splitBaseSchema as r,zodToJsonSchema as i}from"../schema.js";import{collectEnvVars as a}from"../collect.js";import{cliFlagLabel as o}from"./cli.js";import s from"node:fs";import{z as c}from"zod";function l(e,n,r,i){let a=[`${r} ${n}`];return e.type===`object`&&e.properties?(a.push(...u(e,`${r}#`,i)),a):(e.env&&a.push(`- **Env**: \`${e.env}\``),a.push(`- **Type**: \`${e.tsType??(Array.isArray(e.type)?e.type.join(` | `):e.type)??`any`}\``),e.default!==void 0&&a.push(`- **Default**: \`${JSON.stringify(e.default)}\``),e.description&&a.push(``,t(e.description)),a)}function u(e,t,n){let r=[];for(let[i,a]of Object.entries(e.properties??{})){let e=n.useFlags&&a.env?o(a.env,n):`\`${i}\``;r.push(``,...l(a,e,t,n))}return r}function d(e,t,i={}){let a=i.outline??[2,3,4],o={useFlags:e===(i.cliScope??`cli`),baseGroup:i.baseGroup??`base`,...i.envPrefix?{envPrefix:i.envPrefix}:{},...i.shortFlags?{shortFlags:i.shortFlags}:{}},{base:s,groups:c}=r(t,o.baseGroup),l=[`---`,`title: ${n(e)} Configuration`,`outline: ${JSON.stringify(a)}`,`---`,``,`# ${n(e)} Configuration`,``,`Every setting below is configured through an environment variable.`,``,`## Base`,``,...u(s,`###`,o)];for(let[e,t]of Object.entries(c.properties??{}))l.push(``,`## ${n(e)}`,``,...u(t,`###`,o));return`${l.join(`
-`).trim()}\n`}function f(e){return e===void 0?`—`:Array.isArray(e)?`\`${e.join(`,`)}\``:typeof e==`object`?`\`${JSON.stringify(e)}\``:`\`${String(e)}\``}function p(e,t,n){for(let r of Object.values(e.properties??{})){let e=r;if(e.type===`object`&&e.properties)p(r,t,n);else if(e.env){let r=e.envDefault??e.default;n.push({name:e.env,scope:t,...e.description?{description:e.description}:{},...r===void 0?{}:{default:r},...e.required===!0?{required:!0}:{},...e.secret?{secret:!0}:{},...e.public?{public:!0}:{}})}}}function m(e,t={}){let n=t.outline??[2,3,4],o=t.baseGroup??`base`,s=t.labels??{},c=[],l=[];for(let[t,n]of Object.entries(e)){let e=n.jsonSchema??i(n.zodSchema);p(r(e,o).base,t,l)}for(let n of a(e,t.envPrefix??`APP_`,{envPathOf:t.envPathOf}))n.required&&c.push({name:n.name,scope:n.scope,...n.description?{description:n.description}:{},...n.default===void 0?{}:{default:n.default}});let u=e=>[`| Variable | Default | Description |`,`| -------- | ------- | ----------- |`,...e.map(e=>`| \`${e.name}\` | ${f(e.default)} | ${(e.description??``).replace(/\n/g,` `).replace(/\|/g,`\\|`)} |`)].join(`
-`),d=s.title??`Environment variables`,m=t.intro??`Environment variables are prefixed with \`${t.envPrefix??`APP_`}\`.
+import{default as e}from"node:path";import"node:url";import.meta.url;import{sanitizeText as t,titleCase as n}from"../../../shared/src/string-utils.js";import"../../../shared/src/index.js";import{isSchemaType as r,isZodSchema as i,metaOf as a,normalizeConfigSchema as o,splitBaseSchema as s}from"../schema.js";import{collectVars as c}from"../collect.js";import{cliFlagLabel as l}from"./cli.js";import u from"node:fs";function d(e){return e==null?[]:(Array.isArray(e)?e:[e]).map(e=>t(String(e))).filter(Boolean)}function f(e,n){if(e===void 0||e===!1)return;let r=typeof n==`string`?t(n.trim()):``;return r?`- **Deprecated**: ${r}`:`- **Deprecated**`}function p(e){let t=d(e);return t.length===0?[]:[``,`**Example(s):**`,``,...t.flatMap((e,t)=>t?[``,e]:[e])]}function m(e,t){return t.includeRequired!==!1&&e?`- **Required**`:void 0}function h(e,n){let r=[];if(n.includeDeprecated!==!1){let t=f(e.deprecated,e.deprecationMessage);t&&r.push(t)}if(n.includeSince!==!1&&typeof e.since==`string`&&e.since.trim()&&r.push(`- **Since**: ${t(e.since.trim())}`),n.includeSee!==!1)for(let t of d(e.see))r.push(`- **See**: ${t}`);return n.includeExperimental!==!1&&e.experimental&&r.push(`- **Experimental**`),n.includeAlpha!==!1&&e.alpha&&r.push(`- **Alpha**`),n.includeBeta!==!1&&e.beta&&r.push(`- **Beta**`),r}function g(e,n){if(n.includeRemarks===!1)return[];let r=typeof e==`string`?t(e.trim()):``;return r?[``,`**Remarks:**`,``,...r.split(`
+`)]:[]}function _(e,n,r,i){let a=[`${r} ${n}`];if(e.type===`object`&&e.properties)return a.push(...v(e,`${r}#`,i)),a;let o=typeof e.envName==`string`?e.envName:typeof e.env==`string`?e.env:void 0;i.includeEnv!==!1&&o&&a.push(`- **Env**: \`${o}\``),i.includeCli!==!1&&typeof e.cliFlag==`string`&&a.push(`- **CLI**: \`${e.cliFlag}\``);let s=m(e.required===!0,i);return s&&a.push(s),a.push(`- **Type**: \`${e.tsType??(Array.isArray(e.type)?e.type.join(` | `):e.type)??`any`}\``),a.push(...h(e,i)),e.default!==void 0&&a.push(`- **Default**: \`${JSON.stringify(e.default)}\``),e.description&&a.push(``,t(e.description)),a.push(...g(e.remarks,i)),i.includeExamples!==!1&&a.push(...p(e.example)),a}function v(e,t,n){let r=[];for(let[i,a]of Object.entries(e.properties??{})){let e=a.cliFlag??a.envName??a.env,o=n.useFlags&&e?l(e,n):`\`${i}\``;r.push(``,..._(a,o,t,n))}return r}function y(e,t,n){let r=e.frontmatter;return r===!1?[]:[`---`,...(typeof r==`function`?r({options:e}):typeof r==`string`?r:`title: ${t}\noutline: ${JSON.stringify(n)}`).split(`
+`),`---`,``]}function b(e,t,r={}){let i=r.outline??[2,3,4],a={useFlags:e===(r.cliScope??`cli`),baseGroup:Array.isArray(r.baseGroup)?String(r.baseGroup[0]??`base`):String(r.baseGroup??`base`),...r.envPrefix?{envPrefix:r.envPrefix}:{},...r.shortFlags?{shortFlags:r.shortFlags}:{},...r.includeRequired===void 0?{}:{includeRequired:r.includeRequired},...r.includeDeprecated===void 0?{}:{includeDeprecated:r.includeDeprecated},...r.includeExamples===void 0?{}:{includeExamples:r.includeExamples},...r.includeSince===void 0?{}:{includeSince:r.includeSince},...r.includeSee===void 0?{}:{includeSee:r.includeSee},...r.includeRemarks===void 0?{}:{includeRemarks:r.includeRemarks},...r.includeExperimental===void 0?{}:{includeExperimental:r.includeExperimental},...r.includeAlpha===void 0?{}:{includeAlpha:r.includeAlpha},...r.includeBeta===void 0?{}:{includeBeta:r.includeBeta}},{base:o,groups:c}=s(t,a.baseGroup),l=`${n(e)} Configuration`,u=[...y(r,l,i),`# ${l}`,``,`Every setting below is configured through a config value.`,``,`## Base`,``,...v(o,`###`,a)];for(let[e,t]of Object.entries(c.properties??{}))u.push(``,`## ${n(e)}`,``,...v(t,`###`,a));return`${u.join(`
+`).trim()}\n`}function x(e){return e===void 0?`—`:Array.isArray(e)?`\`${e.join(`,`)}\``:typeof e==`object`?`\`${JSON.stringify(e)}\``:`\`${String(e)}\``}function S(e,t,n){for(let r of Object.values(e.properties??{})){let e=r;if(e.type===`object`&&e.properties)S(r,t,n);else if(e.env){let r=e.envDefault??e.default;n.push({name:e.env,scope:t,...e.description?{description:e.description}:{},...r===void 0?{}:{default:r},...e.required===!0?{required:!0}:{},...e.secret?{secret:!0}:{},...e.public?{public:!0}:{}})}}}function C(e,t={}){let n=t.outline??[2,3,4],r=Array.isArray(t.baseGroup)?String(t.baseGroup[0]??`base`):String(t.baseGroup??`base`),i=t.labels??{},a=[],l=[],u=o(e);for(let[e,t]of Object.entries(u))S(s(t,r).base,e,l);for(let n of c(e,t.envPrefix??`APP_`,{envPathOf:t.envPathOf}))n.required&&n.name&&a.push({name:n.name,scope:n.scope,...n.description?{description:n.description}:{},...n.default===void 0?{}:{default:n.default}});let d=e=>[`| Variable | Default | Description |`,`| -------- | ------- | ----------- |`,...e.map(e=>`| \`${e.name}\` | ${x(e.default)} | ${(e.description??``).replace(/\n/g,` `).replace(/\|/g,`\\|`)} |`)].join(`
+`),f=i.title??`Environment variables`,p=t.intro??`Environment variables are prefixed with \`${t.envPrefix??`APP_`}\`.
 The underscore is a path separator, so every config value has an environment
-variable equivalent.`,h=t.requiredNote??`These variables have no safe default and **must** be set:`,g=t.coreNote??`The core (base) config values:`,_=t.references&&t.references.length?`\n## References\n\n${t.references.map(e=>`- [${e.label}](${e.href})`).join(`
-`)}\n`:``;return`---
-title: ${d}
-outline: ${JSON.stringify(n)}
----
+variable equivalent.`,m=t.requiredNote??`These variables have no safe default and **must** be set:`,h=t.coreNote??`The core (base) config values:`,g=t.references&&t.references.length?`\n## References\n\n${t.references.map(e=>`- [${e.label}](${e.href})`).join(`
+`)}\n`:``;return`${y(t,f,n).join(`
+`)}
+# ${f}
 
-# ${d}
+${p}
 
-${m}
-
-## ${s.required??`Required`}
+## ${i.required??`Required`}
 
-${h}
+${m}
 
-${u(c)}
+${d(a)}
 
-## ${s.core??`Core`}
+## ${i.core??`Core`}
 
-${g}
+${h}
 
-${u(l)}
-${_}`}function h(t,n){let r=n.outline??[2,3,4],a=Object.entries(t).map(([t,a])=>[e.resolve(n.outDir,`${t}.md`),d(t,a.jsonSchema??i(a.zodSchema),{...n,outline:r})]);a.push([e.resolve(n.outDir,n.indexFilename??`index.md`),m(t,{...n,outline:r})]);for(let[t,n]of a)s.mkdirSync(e.dirname(t),{recursive:!0}),s.writeFileSync(t,n,`utf-8`);return a.map(([e])=>e)}function g(e){return e.$ref?e.$ref.split(`/`).pop()??void 0:void 0}function _(e,t){let n=g(e);return n&&t[n]?t[n]:e}function v(e){return typeof e==`string`?`'${e}'`:String(e)}function y(e,t){if(e.$ref){let n=_(e,t);return n.properties||n.anyOf||n.oneOf?g(e):y(n,t)}if(e.const!==void 0)return v(e.const);if(Array.isArray(e.enum)&&e.enum.length>0)return e.enum.map(v).join(` | `);let n=e.anyOf??e.oneOf;if(n&&n.length>0)return n.map(e=>y(e,t)).join(` | `);if(e.properties)return`object`;let r=Array.isArray(e.type)?e.type:e.type?[e.type]:[];return r.includes(`array`)?`Array<${y(e.items??{},t)}>`:r.includes(`object`)?`Record<string, unknown>`:r.length===0?`unknown`:r.map(e=>e===`integer`?`number`:e).join(` | `)}function b(e,t,n){let r=g(e);if(r){if(n.has(r))return{properties:{},required:[]};n.add(r)}let i=_(e,t);if(i.properties)return{properties:i.properties,required:i.required??[]};let a=i.anyOf??i.oneOf;if(a){let e={},r=/* @__PURE__ */ new Set;for(let i of a){let a=b(i,t,n);Object.assign(e,a.properties);for(let e of a.required)r.add(e)}return{properties:e,required:[...r]}}return(Array.isArray(i.type)?i.type:i.type?[i.type]:[]).includes(`array`)&&i.items?b(i.items,t,n):{properties:{},required:[]}}function x(e,n,r,i,a,o){let s=_(n,i),c=[`${r} \`${e}\``];c.push(`- **Type**: \`${y(n,i)}\``),o&&c.push(`- **Required**`);let l=n.default??s.default;l!==void 0&&c.push(`- **Default**: \`${JSON.stringify(l)}\``);let u=t(n.description??s.description??``);u&&c.push(``,u);let d=b(n,i,a),f=r.length<6?`${r}#`:r;for(let[e,t]of Object.entries(d.properties))c.push(``,...x(e,t,f,i,a,d.required.includes(e)));return c}function S(e,t,n,r){let i=[],a=e.required??[];for(let[o,s]of Object.entries(e.properties??{}))i.push(``,...x(o,s,t,n,r,a.includes(o)));return i}function C(e,t={}){let n=t.title??`Configuration`,r=[`---`,`title: ${n}`,`outline: ${JSON.stringify(t.outline??[2,3,4])}`,`---`,``,`# ${n}`,``];t.intro&&r.push(t.intro,``);for(let t of e){r.push(`## \`${t.key}\``,``),t.description&&r.push(t.description,``);let e=c.toJSONSchema(t.schema,{target:`draft-2020-12`}),n=e.$defs??{},i=e.$ref?_(e,n):e;r.push(...S(i,`###`,n,/* @__PURE__ */ new Set),``)}return`${r.join(`
-`).trim()}\n`}export{h as generateConfigMarkdown,C as renderConfigFileMarkdown,m as renderConfigIndex,d as renderScopeMarkdown};
+${d(l)}
+${g}`}function w(e,t){let n=e=>i(e)?e.toJSONSchema({target:`draft-2020-12`}):void 0;if(Array.isArray(e))return t;let a=n(e);if(a){let[e]=Object.keys(t);return e?{[e]:a}:t}if(r(e))return t;let o={};for(let[r,i]of Object.entries(t)){let t=e[r];o[r]=!Array.isArray(t)&&n(t)||i}return o}function T(t,n={}){let r=n.outline??[2,3,4],i=o(t),a={};if(n.combined){let e=n.indexFilename??`index.md`;a[e]=P(w(t,i),{...n,outline:r})}else{for(let[e,t]of Object.entries(i))a[`${e}.md`]=b(e,t,{...n,outline:r});a[n.indexFilename??`index.md`]=C(t,{...n,outline:r})}if(typeof n.outputDir==`string`){u.mkdirSync(n.outputDir,{recursive:!0});for(let[t,r]of Object.entries(a))u.writeFileSync(e.resolve(n.outputDir,t),r,`utf-8`)}return a}function E(e){return e.$ref?e.$ref.split(`/`).pop()??void 0:void 0}function D(e,t){let n=E(e);return n&&t[n]?t[n]:e}function O(e){return typeof e==`string`?`'${e}'`:String(e)}function k(e,t){let n=D(e,t),r=e.required===!0||n.required===!0||void 0,i=e.deprecated??n.deprecated,a=e.deprecationMessage??n.deprecationMessage,o=e.example??n.example,s=e.since??n.since,c=e.see??n.see,l=e.remarks??n.remarks,u=e.experimental??n.experimental,d=e.alpha??n.alpha,f=e.beta??n.beta,p=[...n.anyOf??e.anyOf??[],...n.oneOf??e.oneOf??[]];for(let e of p){let n=D(e,t);r??=e.required===!0||n.required===!0||void 0,i??=e.deprecated??n.deprecated,a??=e.deprecationMessage??n.deprecationMessage,o??=e.example??n.example,s??=e.since??n.since,c??=e.see??n.see,l??=e.remarks??n.remarks,u??=e.experimental??n.experimental,d??=e.alpha??n.alpha,f??=e.beta??n.beta}return{...r===void 0?{}:{required:r},...i===void 0?{}:{deprecated:i},...a===void 0?{}:{deprecationMessage:a},...o===void 0?{}:{example:o},...s===void 0?{}:{since:s},...c===void 0?{}:{see:c},...l===void 0?{}:{remarks:l},...u===void 0?{}:{experimental:u},...d===void 0?{}:{alpha:d},...f===void 0?{}:{beta:f}}}function A(e,t){if(e.$ref){let n=D(e,t);return n.properties||n.anyOf||n.oneOf?E(e):A(n,t)}if(e.const!==void 0)return O(e.const);if(Array.isArray(e.enum)&&e.enum.length>0)return e.enum.map(O).join(` | `);let n=e.anyOf??e.oneOf;if(n&&n.length>0)return n.map(e=>A(e,t)).join(` | `);if(e.properties)return`object`;let r=Array.isArray(e.type)?e.type:e.type?[e.type]:[];if(r.includes(`array`))return`Array<${A(e.items??{},t)}>`;if(r.includes(`object`)){let n=e.additionalProperties;return n&&n!==!0?`Record<string, ${A(n,t)}>`:`Record<string, unknown>`}return r.length===0?`unknown`:r.map(e=>e===`integer`?`number`:e).join(` | `)}function j(e,t,n){let r=E(e);if(r){if(n.has(r))return{properties:{},required:[]};n.add(r)}let i=D(e,t);if(i.properties)return{properties:i.properties,required:Array.isArray(i.required)?i.required:[]};let a=i.anyOf??i.oneOf;if(a){let e={},r=/* @__PURE__ */ new Set;for(let i of a){let a=j(i,t,n);Object.assign(e,a.properties);for(let e of a.required)r.add(e)}return{properties:e,required:[...r]}}return(Array.isArray(i.type)?i.type:i.type?[i.type]:[]).includes(`array`)&&i.items?j(i.items,t,n):{properties:{},required:[]}}function M(e,n,r,i,a,o,s){let c=D(n,i),l=k(n,i),u=[`${r} \`${e}\``],d=m(o||l.required===!0,s);d&&u.push(d),u.push(`- **Type**: \`${A(n,i)}\``),u.push(...h(l,s));let f=n.default??c.default;f!==void 0&&u.push(`- **Default**: \`${JSON.stringify(f)}\``);let _=t(n.description??c.description??``);_&&u.push(``,_),u.push(...g(l.remarks,s)),s.includeExamples!==!1&&u.push(...p(l.example));let v=j(n,i,a),y=r.length<6?`${r}#`:r;for(let[e,t]of Object.entries(v.properties))u.push(``,...M(e,t,y,i,a,v.required.includes(e),s));return u}function N(e,t,n,r,i){let a=[],o=Array.isArray(e.required)?e.required:[];for(let[s,c]of Object.entries(e.properties??{}))a.push(``,...M(s,c,t,n,r,o.includes(s),i));return a}function P(e,t={}){let n=t.title??`Configuration`,r=[...y(t,n,t.outline??[2,3,4]),`# ${n}`,``];t.intro&&r.push(t.intro,``);for(let[n,i]of Object.entries(e)){let e=i,o=e.$defs??{},s=D(e,o),c=a(s);r.push(`## \`${n}\``,``),c?.description&&r.push(c.description,``);let l=m(c?.required===!0,t);l&&r.push(l,``);let u=h(c??{},t);u.length>0&&r.push(...u,``);let d=g(c?.remarks,t);if(d.length>0&&r.push(...d,``),t.includeExamples!==!1){let e=p(c?.example);e.length>0&&r.push(...e,``)}r.push(...N(s,`###`,o,/* @__PURE__ */ new Set,t),``)}return`${r.join(`
+`).trim()}\n`}export{T as generateConfigMarkdown};

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

@@ -1,13 +1,10 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
-import { ConfigScopes } from "../types.js";
-import { Schema } from "untyped";
+import { ConfigEngineOptions, ConfigSchema } from "../types.js";
 //#region packages/config/src/generators/types.d.ts
-export interface GenerateTypesOptions {
-  /** Output directory. When omitted, nothing is written. */
-  outputDir?: string;
-  /** The base group hoisted into `<Name>Base` (default `base`). */
-  baseGroup?: string;
+export interface GenerateTypesOptions extends Pick<ConfigEngineOptions, 'baseGroup'> {
+  /** Output directory. `false` (or omitted) disables writing. */
+  outputDir?: string | false;
   /**
    * Per-scope main interface name. Defaults to `<PascalScope>Config`.
    */
@@ -28,21 +25,29 @@ export interface GenerateTypesOptions {
   extension?: string;
   /** A raw (verbatim) header prepended to every generated file. */
   header?: string;
+  /** Emit `@required` JSDoc tags (default true). */
+  includeRequired?: boolean;
+  /** Emit `@deprecated` JSDoc tags (default true). */
+  includeDeprecated?: boolean;
+  /** Emit `@example` JSDoc tags (default true). */
+  includeExamples?: boolean;
+  /** Emit `@since` JSDoc tags (default true). */
+  includeSince?: boolean;
+  /** Emit `@see` JSDoc tags (default true). */
+  includeSee?: boolean;
+  /** Emit `@remarks` JSDoc tags (default true). */
+  includeRemarks?: boolean;
+  /** Emit `@experimental` JSDoc tags (default true). */
+  includeExperimental?: boolean;
+  /** Emit `@alpha` JSDoc tags (default true). */
+  includeAlpha?: boolean;
+  /** Emit `@beta` JSDoc tags (default true). */
+  includeBeta?: boolean;
+  /** Show the env var equivalent in JSDoc (default true). */
+  includeEnv?: boolean;
+  /** Show the CLI flag equivalent in JSDoc (default true). */
+  includeCli?: boolean;
 }
-/** The resolved schema for a scope (from a precomputed schema or the Zod one). */
-export declare function resolveScopeSchema(schema: Schema | undefined, zodSchema: unknown): Schema;
-/** Render the generated type file content for one scope. */
-export declare function renderConfigTypes(scopeName: string, schema: Schema, options?: GenerateTypesOptions): string;
-/**
- * Render the import block for the generated file (empty when none are
- * configured). Emitted once at the top of the file, after the header, so a
- * hand-written override can reference imported types.
- */
-export declare function renderConfigImports(options?: GenerateTypesOptions): string;
-/** Render every config type file, keyed by scope name. */
-export declare function renderAllConfigTypes(scopes: ConfigScopes, options?: GenerateTypesOptions): Record<string, string>;
-/** Generate the config type files into `outputDir`. Returns the paths written. */
-export declare function generateConfigTypes(scopes: ConfigScopes, options: GenerateTypesOptions & {
-  outputDir: string;
-}): string[];
+/** Generate config type file contents (and optionally write them). */
+export declare function generateConfigTypes(schema: ConfigSchema, options?: GenerateTypesOptions): Record<string, string>;
 //#endregion

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

@@ -1,4 +1,4 @@
-import{default as e}from"node:path";import"node:url";import.meta.url;import{pascalCase as t}from"../../../shared/src/string-utils.js";import"../../../shared/src/index.js";import{splitBaseSchema as n,zodToJsonSchema as r}from"../schema.js";import i from"node:fs";import{generateTypes as a}from"untyped";const o={addExport:!0,partial:!0};function s(e,t){return e??r(t)}function c(e){let t=[],n=0,r=!1;for(let i of e.split(`
+import{default as e}from"node:path";import"node:url";import.meta.url;import{pascalCase as t}from"../../../shared/src/string-utils.js";import"../../../shared/src/index.js";import{isZodSchema as n,metaOf as r,normalizeConfigSchema as i,splitBaseSchema as a,zodToSchemaMap as o}from"../schema.js";import s from"node:fs";import{generateTypes as c}from"untyped";const l={addExport:!0,partial:!0};function u(e){let t=[],n=0,r=!1;for(let i of e.split(`
 `)){let e=i.trim();if(r)t.push(i),e.endsWith(`*/`)&&(r=!1);else if(e.startsWith(`/*`))t.push(i),e.endsWith(`*/`)||(r=!0);else if(!(e===``&&n>0)){t.push(i);for(let e of i)e===`{`||e===`(`||e===`[`?n++:(e===`}`||e===`)`||e===`]`)&&n>0&&n--}}return t.join(`
-`)}function l(e,t){return c(a(e,{...o,interfaceName:t}))}function u(e){let t=e.lastIndexOf(`}`);return t===-1?e:`${e.slice(0,t)}    [key: string]: unknown;\n${e.slice(t)}`}function d(e,r,i={}){let a=i.baseGroup??`base`,o=i.interfaceNames?.[e]??`${t(e)}Config`,s=i.aliases?.[e]??``,c=e=>i.header?`${i.header}\n\n${e}`:e,d=i.overrides?.[e];if(d!==void 0)return c(`${d.trimEnd()}\n${s}`.trimEnd());let f=r.allowExtraKeys===!0;if(!r.properties)return c(`export type ${o} = ${r.tsType??`unknown`};\n${s}`);let{base:p,groups:m,hasBase:h}=n(r,a),g=Object.keys(m.properties??{});if(!h){let e=l(r,o);return c(`${f?u(e):e}\n${s}`)}let _=l(p,`${o}Base`),v;return v=g.length>0?l(m,o).replace(`export interface ${o} {`,`export interface ${o} extends ${o}Base {`):`export interface ${o} extends ${o}Base {}\n`,f&&(v=u(v)),c(`${_}\n${v}\n${s}`)}function f(e={}){return(e.imports??[]).join(`
-`)}function p(e,t={}){return Object.fromEntries(Object.entries(e).map(([e,n])=>[e,d(e,s(n.jsonSchema,n.zodSchema),t)]))}function m(t,n){let r=n.extension??`ts`,a=[];for(let[o,s]of Object.entries(p(t,n))){let t=e.join(n.outputDir,`${o}.${r}`);i.mkdirSync(e.dirname(t),{recursive:!0}),i.writeFileSync(t,s,`utf-8`),a.push(t)}return a}export{m as generateConfigTypes,p as renderAllConfigTypes,f as renderConfigImports,d as renderConfigTypes,s as resolveScopeSchema};
+`)}function d(e,t){return u(c(e,{...l,interfaceName:t}))}function f(e){let t=e.lastIndexOf(`}`);return t===-1?e:`${e.slice(0,t)}    [key: string]: unknown;\n${e.slice(t)}`}function p(e){return e==null?[]:(Array.isArray(e)?e:[e]).map(e=>String(e)).filter(Boolean)}function m(e,t){let n=[];if(t.includeRequired!==!1&&e.required===!0&&n.push(`@required`),t.includeDeprecated!==!1&&e.deprecated!==void 0&&e.deprecated!==!1){let t=typeof e.deprecationMessage==`string`?e.deprecationMessage.trim():``;n.push(t?`@deprecated ${t}`:`@deprecated`)}if(t.includeExamples!==!1)for(let t of p(e.example))n.push(`@example ${t}`);if(t.includeSince!==!1&&typeof e.since==`string`&&e.since.trim()&&n.push(`@since ${e.since.trim()}`),t.includeSee!==!1)for(let t of p(e.see))n.push(`@see ${t}`);return t.includeRemarks!==!1&&typeof e.remarks==`string`&&e.remarks.trim()&&n.push(`@remarks ${e.remarks.trim()}`),t.includeExperimental!==!1&&e.experimental===!0&&n.push(`@experimental`),t.includeAlpha!==!1&&e.alpha===!0&&n.push(`@alpha`),t.includeBeta!==!1&&e.beta===!0&&n.push(`@beta`),n}function h(e,t){let n=e,{deprecated:r,deprecationMessage:i,example:a,since:o,see:s,remarks:c,experimental:l,alpha:u,beta:d,tags:f,...p}=n,g=n.required===!0,_=(Array.isArray(f)?f:[]).filter(e=>!(t.includeRequired===!1&&e===`@required`||t.includeDeprecated===!1&&e.startsWith(`@deprecated`)||t.includeExamples===!1&&e.startsWith(`@example`)||t.includeSince===!1&&e.startsWith(`@since`)||t.includeSee===!1&&e.startsWith(`@see`)||t.includeRemarks===!1&&e.startsWith(`@remarks`)||t.includeExperimental===!1&&e.startsWith(`@experimental`)||t.includeAlpha===!1&&e.startsWith(`@alpha`)||t.includeBeta===!1&&e.startsWith(`@beta`))),v=[.../* @__PURE__ */ new Set([..._,...m({required:g,deprecated:r,deprecationMessage:i,example:a,since:o,see:s,remarks:c,experimental:l,alpha:u,beta:d},t)])],y=typeof n.envName==`string`?n.envName:typeof n.env==`string`?n.env:``;t.includeEnv!==!1&&y&&v.push(`@env ${y}`),t.includeCli!==!1&&typeof n.cliFlag==`string`&&v.push(`@cli ${n.cliFlag}`);let b={...p};return g&&delete b.required,v.length>0&&(b.tags=v),b.properties&&typeof b.properties==`object`&&(b.properties=Object.fromEntries(Object.entries(b.properties).map(([e,n])=>[e,h(n,t)]))),b.items&&typeof b.items==`object`&&(b.items=h(b.items,t)),b}function g(e,t,n){let r=t,i=m({required:r.required,deprecated:r.deprecated,deprecationMessage:r.deprecationMessage,example:r.example,since:r.since,see:r.see,remarks:r.remarks,experimental:r.experimental,alpha:r.alpha,beta:r.beta},n);return i.length===0?e:`${[`/**`,...i.map(e=>` * ${e}`),` */`].join(`
+`)}\n${e}`}function _(e,n,i={}){let o=Array.isArray(i.baseGroup)?String(i.baseGroup[0]??`base`):String(i.baseGroup??`base`),s=r(n),c=i.interfaceNames?.[e]??s?.typeName??s?.id??`${t(e)}Config`,l=i.aliases?.[e]??``,u=e=>i.header?`${i.header}\n\n${e}`:e,p=i.overrides?.[e];if(p!==void 0)return u(`${p.trimEnd()}\n${l}`.trimEnd());let m=n.allowExtraKeys===!0;if(!n.properties)return u(`${g(`export type ${c} = ${n.tsType??`unknown`};`,n,i)}\n${l}`);let _=h(n,i),{base:v,groups:y,hasBase:b}=a(_,o),x=Object.keys(y.properties??{});if(!b){let e=g(d(_,c),n,i);return m&&(e=f(e)),u(`${e}\n${l}`)}let S=d(v,`${c}Base`),C;return C=x.length>0?d(y,c).replace(`export interface ${c} {`,`export interface ${c} extends ${c}Base {`):`export interface ${c} extends ${c}Base {}\n`,C=g(C,n,i),m&&(C=f(C)),u(`${S}\n${C}\n${l}`)}function v(e,t={}){return n(e)?Object.fromEntries(Object.entries(o(e)).map(([e,n])=>[e,_(e,n,{...t,interfaceNames:{[e]:e,...t.interfaceNames}})])):Object.fromEntries(Object.entries(i(e)).map(([e,n])=>[e,_(e,n,t)]))}function y(t,n={}){let r=n.extension??`ts`,i=v(t,n);if(typeof n.outputDir==`string`)for(let[t,a]of Object.entries(i)){let i=e.join(n.outputDir,`${t}.${r}`);s.mkdirSync(e.dirname(i),{recursive:!0}),s.writeFileSync(i,a,`utf-8`)}return i}export{y as generateConfigTypes};

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

@@ -1,22 +1,22 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
-import { ConfigEngineOptions, ConfigScopeDef, ConfigScopes, EnvValueType, EnvVarDef, EnvVarMeta, envPathOf } from "./types.js";
-import { CollectEnvVarsOptions, DEFAULT_ENV_PREFIX, collectEnvVars, collectRequiredEnvVars } from "./collect.js";
+import { ConfigBaseMeta, ConfigCliMeta, ConfigDef, ConfigEngineFlatten, ConfigEngineOptions, ConfigEnvMeta, ConfigGroup, ConfigMeta, ConfigSchema, ConfigSchemaInput, ConfigSchemaMap, ConfigSchemaType, ConfigScope, ConfigScopes, ConfigTypeMeta, ConfigValueType } from "./types.js";
+import { CollectVarsOptions, DEFAULT_ENV_PREFIX, collectRequired, collectVars, pathOf } from "./collect.js";
 import { BuildConfigJsonOptions, ConfigJsonDoc, ConfigJsonEntry, buildConfigJson } from "./config-json.js";
 import { EnvFileOptions, generateEnvFile } from "./env-file.js";
 import { CliArgsOptionConfig, CliArgsParser, CliArgsResult, CliArgsValues, CliFlagOptions, CliOptionDef, GenerateCliOptionsOptions, cliFlagLabel, cliFlagOf, cliShortOf, createCliArgsParser, flagOf, generateCliArgsOptions, generateCliOptions } from "./generators/cli.js";
-import { GenerateEnvTypesOptions, generateEnv, generateEnvDts, generateEnvTypes } from "./generators/env.js";
+import { GenerateEnvTypesOptions, generateConfigEnv, generateEnv, generateEnvDts, generateEnvTypes } from "./generators/env.js";
 import { GenerateJsonSchemaOptions, generateConfigJsonSchema, generateJsonSchemaFile } from "./generators/json.js";
-import { ConfigFileSection, GenerateMarkdownOptions, RenderConfigFileOptions, RenderMarkdownOptions, generateConfigMarkdown, renderConfigFileMarkdown, renderConfigIndex, renderScopeMarkdown } from "./generators/markdown.js";
-import { GenerateTypesOptions, generateConfigTypes, renderAllConfigTypes, renderConfigImports, renderConfigTypes, resolveScopeSchema } from "./generators/types.js";
+import { GenerateMarkdownOptions, RenderConfigFileOptions, RenderMarkdownFrontmatter, RenderMarkdownOptions, generateConfigMarkdown } from "./generators/markdown.js";
+import { GenerateTypesOptions, generateConfigTypes } from "./generators/types.js";
 import { ConfigEngine, createConfigEngine } from "./engine.js";
-import { EnvSource, EnvTree, applyOverrides, envBool, envInt, envList, envMap, envString, parseEnvTree, readEnvPath, trimTrailingSlashes } from "./env.js";
+import { EnvSource, EnvTree, envBool, envInt, envList, envMap, envPathOf, envString, parseEnvTree, readEnvPath } from "./env.js";
 import { FormatGeneratedOptions, GENERATED_FORMAT_OPTIONS, formatGenerated } from "./generated-format.js";
 import "./generators/index.js";
 import { findProjectRoot, monorepoRoot } from "./root.js";
-import { SplitSchema, compileZodSchema, envMetaOf, flattenBaseSchema, renderTsType, resolveUntypedSchema, splitBaseSchema, zodToJsonSchema, zodToUntypedDefinition } from "./schema.js";
+import { SplitSchema, compileZodSchema, flattenBaseSchema, isSchemaType, isZodSchema, metaOf, normalizeConfigSchema, normalizeJsonSchemaMetadata, renderTsType, resolveUntypedSchema, splitBaseSchema, toSchemaType, zodToJsonSchema, zodToSchemaMap, zodToUntypedDefinition } from "./schema.js";
 declare namespace index_d_exports {
-  export { BuildConfigJsonOptions, CliArgsOptionConfig, CliArgsParser, CliArgsResult, CliArgsValues, CliFlagOptions, CliOptionDef, CollectEnvVarsOptions, ConfigEngine, ConfigEngineOptions, ConfigFileSection, ConfigJsonDoc, ConfigJsonEntry, ConfigScopeDef, ConfigScopes, DEFAULT_ENV_PREFIX, EnvFileOptions, EnvSource, EnvTree, EnvValueType, EnvVarDef, EnvVarMeta, FormatGeneratedOptions, GENERATED_FORMAT_OPTIONS, GenerateCliOptionsOptions, GenerateEnvTypesOptions, GenerateJsonSchemaOptions, GenerateMarkdownOptions, GenerateTypesOptions, RenderConfigFileOptions, RenderMarkdownOptions, SplitSchema, applyOverrides, buildConfigJson, cliFlagLabel, cliFlagOf, cliShortOf, collectEnvVars, collectRequiredEnvVars, compileZodSchema, createCliArgsParser, createConfigEngine, envBool, envInt, envList, envMap, envMetaOf, envPathOf, envString, findProjectRoot, flagOf, flattenBaseSchema, formatGenerated, generateCliArgsOptions, generateCliOptions, generateConfigJsonSchema, generateConfigMarkdown, generateConfigTypes, generateEnv, generateEnvDts, generateEnvFile, generateEnvTypes, generateJsonSchemaFile, monorepoRoot, parseEnvTree, readEnvPath, renderAllConfigTypes, renderConfigFileMarkdown, renderConfigImports, renderConfigIndex, renderConfigTypes, renderScopeMarkdown, renderTsType, resolveScopeSchema, resolveUntypedSchema, splitBaseSchema, trimTrailingSlashes, zodToJsonSchema, zodToUntypedDefinition };
+  export { BuildConfigJsonOptions, CliArgsOptionConfig, CliArgsParser, CliArgsResult, CliArgsValues, CliFlagOptions, CliOptionDef, CollectVarsOptions, ConfigBaseMeta, ConfigCliMeta, ConfigDef, ConfigEngine, ConfigEngineFlatten, ConfigEngineOptions, ConfigEnvMeta, ConfigGroup, ConfigJsonDoc, ConfigJsonEntry, ConfigMeta, ConfigSchema, ConfigSchemaInput, ConfigSchemaMap, ConfigSchemaType, ConfigScope, ConfigScopes, ConfigTypeMeta, ConfigValueType, DEFAULT_ENV_PREFIX, EnvFileOptions, EnvSource, EnvTree, FormatGeneratedOptions, GENERATED_FORMAT_OPTIONS, GenerateCliOptionsOptions, GenerateEnvTypesOptions, GenerateJsonSchemaOptions, GenerateMarkdownOptions, GenerateTypesOptions, RenderConfigFileOptions, RenderMarkdownFrontmatter, RenderMarkdownOptions, SplitSchema, buildConfigJson, cliFlagLabel, cliFlagOf, cliShortOf, collectRequired, collectVars, compileZodSchema, createCliArgsParser, createConfigEngine, envBool, envInt, envList, envMap, envPathOf, envString, findProjectRoot, flagOf, flattenBaseSchema, formatGenerated, generateCliArgsOptions, generateCliOptions, generateConfigEnv, generateConfigJsonSchema, generateConfigMarkdown, generateConfigTypes, generateEnv, generateEnvDts, generateEnvFile, generateEnvTypes, generateJsonSchemaFile, isSchemaType, isZodSchema, metaOf, monorepoRoot, normalizeConfigSchema, normalizeJsonSchemaMetadata, parseEnvTree, pathOf, readEnvPath, renderTsType, resolveUntypedSchema, splitBaseSchema, toSchemaType, zodToJsonSchema, zodToSchemaMap, zodToUntypedDefinition };
 }
 //#endregion
-export { BuildConfigJsonOptions, CliArgsOptionConfig, CliArgsParser, CliArgsResult, CliArgsValues, CliFlagOptions, CliOptionDef, CollectEnvVarsOptions, ConfigEngine, ConfigEngineOptions, ConfigFileSection, ConfigJsonDoc, ConfigJsonEntry, ConfigScopeDef, ConfigScopes, DEFAULT_ENV_PREFIX, EnvFileOptions, EnvSource, EnvTree, EnvValueType, EnvVarDef, EnvVarMeta, FormatGeneratedOptions, GENERATED_FORMAT_OPTIONS, GenerateCliOptionsOptions, GenerateEnvTypesOptions, GenerateJsonSchemaOptions, GenerateMarkdownOptions, GenerateTypesOptions, RenderConfigFileOptions, RenderMarkdownOptions, SplitSchema, applyOverrides, buildConfigJson, cliFlagLabel, cliFlagOf, cliShortOf, collectEnvVars, collectRequiredEnvVars, compileZodSchema, createCliArgsParser, createConfigEngine, envBool, envInt, envList, envMap, envMetaOf, envPathOf, envString, findProjectRoot, flagOf, flattenBaseSchema, formatGenerated, generateCliArgsOptions, generateCliOptions, generateConfigJsonSchema, generateConfigMarkdown, generateConfigTypes, generateEnv, generateEnvDts, generateEnvFile, generateEnvTypes, generateJsonSchemaFile, index_d_exports, monorepoRoot, parseEnvTree, readEnvPath, renderAllConfigTypes, renderConfigFileMarkdown, renderConfigImports, renderConfigIndex, renderConfigTypes, renderScopeMarkdown, renderTsType, resolveScopeSchema, resolveUntypedSchema, splitBaseSchema, trimTrailingSlashes, zodToJsonSchema, zodToUntypedDefinition };
+export { BuildConfigJsonOptions, CliArgsOptionConfig, CliArgsParser, CliArgsResult, CliArgsValues, CliFlagOptions, CliOptionDef, CollectVarsOptions, ConfigBaseMeta, ConfigCliMeta, ConfigDef, ConfigEngine, ConfigEngineFlatten, ConfigEngineOptions, ConfigEnvMeta, ConfigGroup, ConfigJsonDoc, ConfigJsonEntry, ConfigMeta, ConfigSchema, ConfigSchemaInput, ConfigSchemaMap, ConfigSchemaType, ConfigScope, ConfigScopes, ConfigTypeMeta, ConfigValueType, DEFAULT_ENV_PREFIX, EnvFileOptions, EnvSource, EnvTree, FormatGeneratedOptions, GENERATED_FORMAT_OPTIONS, GenerateCliOptionsOptions, GenerateEnvTypesOptions, GenerateJsonSchemaOptions, GenerateMarkdownOptions, GenerateTypesOptions, RenderConfigFileOptions, RenderMarkdownFrontmatter, RenderMarkdownOptions, SplitSchema, buildConfigJson, cliFlagLabel, cliFlagOf, cliShortOf, collectRequired, collectVars, compileZodSchema, createCliArgsParser, createConfigEngine, envBool, envInt, envList, envMap, envPathOf, envString, findProjectRoot, flagOf, flattenBaseSchema, formatGenerated, generateCliArgsOptions, generateCliOptions, generateConfigEnv, generateConfigJsonSchema, generateConfigMarkdown, generateConfigTypes, generateEnv, generateEnvDts, generateEnvFile, generateEnvTypes, generateJsonSchemaFile, index_d_exports, isSchemaType, isZodSchema, metaOf, monorepoRoot, normalizeConfigSchema, normalizeJsonSchemaMetadata, parseEnvTree, pathOf, readEnvPath, renderTsType, resolveUntypedSchema, splitBaseSchema, toSchemaType, zodToJsonSchema, zodToSchemaMap, zodToUntypedDefinition };

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

@@ -1 +1 @@
-import"node:path";import"node:url";import.meta.url;import{__exportAll as e}from"../../../_virtual/_rolldown/runtime.js";import{compileZodSchema as t,envMetaOf as n,flattenBaseSchema as r,renderTsType as i,resolveUntypedSchema as a,splitBaseSchema as o,zodToJsonSchema as s,zodToUntypedDefinition as c}from"./schema.js";import{envPathOf as l}from"./types.js";import{DEFAULT_ENV_PREFIX as u,collectEnvVars as d,collectRequiredEnvVars as f}from"./collect.js";import{buildConfigJson as p}from"./config-json.js";import{generateEnvFile as m}from"./env-file.js";import{cliFlagLabel as h,cliFlagOf as g,cliShortOf as _,createCliArgsParser as v,flagOf as y,generateCliArgsOptions as b,generateCliOptions as x}from"./generators/cli.js";import{generateEnv as S,generateEnvDts as C,generateEnvTypes as w}from"./generators/env.js";import{generateConfigJsonSchema as T,generateJsonSchemaFile as E}from"./generators/json.js";import{generateConfigMarkdown as D,renderConfigFileMarkdown as O,renderConfigIndex as k,renderScopeMarkdown as A}from"./generators/markdown.js";import{generateConfigTypes as j,renderAllConfigTypes as M,renderConfigImports as N,renderConfigTypes as P,resolveScopeSchema as F}from"./generators/types.js";import{findProjectRoot as I,monorepoRoot as L}from"./root.js";import{createConfigEngine as R}from"./engine.js";import{applyOverrides as z,envBool as B,envInt as V,envList as H,envMap as U,envString as W,parseEnvTree as G,readEnvPath as K,trimTrailingSlashes as q}from"./env.js";import{GENERATED_FORMAT_OPTIONS as J,formatGenerated as Y}from"./generated-format.js";import"./generators/index.js";var X=/* @__PURE__ */ e({DEFAULT_ENV_PREFIX:()=>u,GENERATED_FORMAT_OPTIONS:()=>J,applyOverrides:()=>z,buildConfigJson:()=>p,cliFlagLabel:()=>h,cliFlagOf:()=>g,cliShortOf:()=>_,collectEnvVars:()=>d,collectRequiredEnvVars:()=>f,compileZodSchema:()=>t,createCliArgsParser:()=>v,createConfigEngine:()=>R,envBool:()=>B,envInt:()=>V,envList:()=>H,envMap:()=>U,envMetaOf:()=>n,envPathOf:()=>l,envString:()=>W,findProjectRoot:()=>I,flagOf:()=>y,flattenBaseSchema:()=>r,formatGenerated:()=>Y,generateCliArgsOptions:()=>b,generateCliOptions:()=>x,generateConfigJsonSchema:()=>T,generateConfigMarkdown:()=>D,generateConfigTypes:()=>j,generateEnv:()=>S,generateEnvDts:()=>C,generateEnvFile:()=>m,generateEnvTypes:()=>w,generateJsonSchemaFile:()=>E,monorepoRoot:()=>L,parseEnvTree:()=>G,readEnvPath:()=>K,renderAllConfigTypes:()=>M,renderConfigFileMarkdown:()=>O,renderConfigImports:()=>N,renderConfigIndex:()=>k,renderConfigTypes:()=>P,renderScopeMarkdown:()=>A,renderTsType:()=>i,resolveScopeSchema:()=>F,resolveUntypedSchema:()=>a,splitBaseSchema:()=>o,trimTrailingSlashes:()=>q,zodToJsonSchema:()=>s,zodToUntypedDefinition:()=>c});export{u as DEFAULT_ENV_PREFIX,J as GENERATED_FORMAT_OPTIONS,z as applyOverrides,p as buildConfigJson,h as cliFlagLabel,g as cliFlagOf,_ as cliShortOf,d as collectEnvVars,f as collectRequiredEnvVars,t as compileZodSchema,v as createCliArgsParser,R as createConfigEngine,B as envBool,V as envInt,H as envList,U as envMap,n as envMetaOf,l as envPathOf,W as envString,I as findProjectRoot,y as flagOf,r as flattenBaseSchema,Y as formatGenerated,b as generateCliArgsOptions,x as generateCliOptions,T as generateConfigJsonSchema,D as generateConfigMarkdown,j as generateConfigTypes,S as generateEnv,C as generateEnvDts,m as generateEnvFile,w as generateEnvTypes,E as generateJsonSchemaFile,L as monorepoRoot,G as parseEnvTree,K as readEnvPath,M as renderAllConfigTypes,O as renderConfigFileMarkdown,N as renderConfigImports,k as renderConfigIndex,P as renderConfigTypes,A as renderScopeMarkdown,i as renderTsType,F as resolveScopeSchema,a as resolveUntypedSchema,o as splitBaseSchema,X as src_exports,q as trimTrailingSlashes,s as zodToJsonSchema,c as zodToUntypedDefinition};
+import"node:path";import"node:url";import.meta.url;import{__exportAll as e}from"../../../_virtual/_rolldown/runtime.js";import{compileZodSchema as t,flattenBaseSchema as n,isSchemaType as r,isZodSchema as i,metaOf as a,normalizeConfigSchema as o,normalizeJsonSchemaMetadata as s,renderTsType as c,resolveUntypedSchema as l,splitBaseSchema as u,toSchemaType as d,zodToJsonSchema as f,zodToSchemaMap as p,zodToUntypedDefinition as m}from"./schema.js";import{DEFAULT_ENV_PREFIX as h,collectRequired as g,collectVars as _,pathOf as v}from"./collect.js";import{buildConfigJson as y}from"./config-json.js";import{generateEnvFile as b}from"./env-file.js";import{cliFlagLabel as x,cliFlagOf as S,cliShortOf as C,createCliArgsParser as w,flagOf as T,generateCliArgsOptions as E,generateCliOptions as D}from"./generators/cli.js";import{generateConfigEnv as O,generateEnv as k,generateEnvDts as A,generateEnvTypes as j}from"./generators/env.js";import{generateConfigJsonSchema as M,generateJsonSchemaFile as N}from"./generators/json.js";import{generateConfigMarkdown as P}from"./generators/markdown.js";import{generateConfigTypes as F}from"./generators/types.js";import{findProjectRoot as I,monorepoRoot as L}from"./root.js";import{createConfigEngine as R}from"./engine.js";import{envBool as z,envInt as B,envList as V,envMap as H,envPathOf as U,envString as W,parseEnvTree as G,readEnvPath as K}from"./env.js";import{GENERATED_FORMAT_OPTIONS as q,formatGenerated as J}from"./generated-format.js";import"./generators/index.js";var Y=/* @__PURE__ */ e({DEFAULT_ENV_PREFIX:()=>h,GENERATED_FORMAT_OPTIONS:()=>q,buildConfigJson:()=>y,cliFlagLabel:()=>x,cliFlagOf:()=>S,cliShortOf:()=>C,collectRequired:()=>g,collectVars:()=>_,compileZodSchema:()=>t,createCliArgsParser:()=>w,createConfigEngine:()=>R,envBool:()=>z,envInt:()=>B,envList:()=>V,envMap:()=>H,envPathOf:()=>U,envString:()=>W,findProjectRoot:()=>I,flagOf:()=>T,flattenBaseSchema:()=>n,formatGenerated:()=>J,generateCliArgsOptions:()=>E,generateCliOptions:()=>D,generateConfigEnv:()=>O,generateConfigJsonSchema:()=>M,generateConfigMarkdown:()=>P,generateConfigTypes:()=>F,generateEnv:()=>k,generateEnvDts:()=>A,generateEnvFile:()=>b,generateEnvTypes:()=>j,generateJsonSchemaFile:()=>N,isSchemaType:()=>r,isZodSchema:()=>i,metaOf:()=>a,monorepoRoot:()=>L,normalizeConfigSchema:()=>o,normalizeJsonSchemaMetadata:()=>s,parseEnvTree:()=>G,pathOf:()=>v,readEnvPath:()=>K,renderTsType:()=>c,resolveUntypedSchema:()=>l,splitBaseSchema:()=>u,toSchemaType:()=>d,zodToJsonSchema:()=>f,zodToSchemaMap:()=>p,zodToUntypedDefinition:()=>m});export{h as DEFAULT_ENV_PREFIX,q as GENERATED_FORMAT_OPTIONS,y as buildConfigJson,x as cliFlagLabel,S as cliFlagOf,C as cliShortOf,g as collectRequired,_ as collectVars,t as compileZodSchema,w as createCliArgsParser,R as createConfigEngine,z as envBool,B as envInt,V as envList,H as envMap,U as envPathOf,W as envString,I as findProjectRoot,T as flagOf,n as flattenBaseSchema,J as formatGenerated,E as generateCliArgsOptions,D as generateCliOptions,O as generateConfigEnv,M as generateConfigJsonSchema,P as generateConfigMarkdown,F as generateConfigTypes,k as generateEnv,A as generateEnvDts,b as generateEnvFile,j as generateEnvTypes,N as generateJsonSchemaFile,r as isSchemaType,i as isZodSchema,a as metaOf,L as monorepoRoot,o as normalizeConfigSchema,s as normalizeJsonSchemaMetadata,G as parseEnvTree,v as pathOf,K as readEnvPath,c as renderTsType,l as resolveUntypedSchema,u as splitBaseSchema,Y as src_exports,d as toSchemaType,f as zodToJsonSchema,p as zodToSchemaMap,m as zodToUntypedDefinition};

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

@@ -1,6 +1,6 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
-import { EnvVarMeta } from "./types.js";
+import { ConfigMeta, ConfigSchema, ConfigSchemaInput, ConfigSchemaMap, ConfigSchemaType } from "./types.js";
 import { ZodType } from "zod";
 import { Schema } from "untyped";
 //#region packages/config/src/schema.d.ts
@@ -22,12 +22,36 @@ interface JsonSchemaNode {
   additionalProperties?: JsonSchemaNode | boolean;
   propertyNames?: JsonSchemaNode;
   env?: string;
+  envName?: string;
+  envPath?: string;
+  path?: string;
+  cliFlag?: string;
+  cliFlagShort?: string;
+  typeName?: string;
+  id?: string;
   scope?: string;
   secret?: boolean;
   public?: boolean;
+  deprecated?: boolean;
+  deprecationMessage?: string;
+  example?: string | string[];
+  since?: string;
+  see?: string | string[];
+  remarks?: string;
+  experimental?: boolean;
+  alpha?: boolean;
+  beta?: boolean;
 }
-/** Read the env metadata attached to a Zod leaf via `.meta()`. */
-export declare function envMetaOf(schema: ZodType): EnvVarMeta | undefined;
+/** Whether a value is a Zod schema. */
+export declare function isZodSchema(value: unknown): value is ZodType;
+/** Whether a value is a resolved untyped schema. */
+export declare function isSchemaType(value: unknown): value is ConfigSchemaType;
+/** Read the config metadata attached to a Zod leaf or an untyped schema node. */
+export declare function metaOf(schema: ZodType | Schema): ConfigMeta | undefined;
+/** Convert a Zod schema or untyped schema to the untyped representation. */
+export declare function toSchemaType(schema: ConfigSchemaInput): ConfigSchemaType;
+/** Normalize any supported schema shape into scoped untyped schemas. */
+export declare function normalizeConfigSchema(schema: ConfigSchema): ConfigSchemaMap;
 /**
  * Render a JSON Schema node as a TypeScript type string. Nested `$defs` are
  * referenced by name, unions become `A | B`, records become `Record<...>` and
@@ -43,6 +67,10 @@ export declare function compileZodSchema<T extends ZodType>(schema: T): T;
  * `resolveSchema` synchronously.
  */
 export declare function resolveUntypedSchema(input: Record<string, unknown>): Schema;
+/** Normalize Zod's JSON Schema metadata into standard JSON Schema fields. */
+export declare function normalizeJsonSchemaMetadata(node: unknown): void;
+/** Lower a Zod schema and every named `$defs` entry into resolved schemas. */
+export declare function zodToSchemaMap(zodSchema: ZodType): Record<string, ConfigSchemaType>;
 /** Build the resolved untyped JSON Schema directly from a Zod config schema. */
 export declare function zodToJsonSchema(zodSchema: ZodType): Schema;
 /** A resolved untyped schema split into its base group and the remaining groups. */

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

@@ -1 +1 @@
-import"node:path";import"node:url";import.meta.url;import{z as e}from"zod";const t={string:`string`,number:`number`,integer:`number`,boolean:`boolean`,null:`null`};function n(e){let t=e.meta?.();return t&&typeof t==`object`&&`env`in t?t:void 0}function r(e){return!e||Object.keys(e).length===0}function i(e){return`'${String(e).replace(/\\/g,`\\\\`).replace(/'/g,`\\'`)}'`}function a(e,n={}){if(!e||r(e))return`unknown`;if(e.$ref){let t=e.$ref.split(`/`).pop()??`unknown`;return n[t]?t:`unknown`}if(e.const!==void 0)return typeof e.const==`string`?i(e.const):String(e.const);if(Array.isArray(e.enum)&&e.enum.length>0)return e.enum.map(i).join(` | `);let o=e.anyOf??e.oneOf;if(Array.isArray(o)&&o.length>0)return o.map(e=>a(e,n)).join(` | `);if(e.properties){let t=Array.isArray(e.required)?e.required:[];return`{ ${Object.entries(e.properties).map(([e,r])=>`${e}${t.includes(e)?``:`?`}: ${a(r,n)}`).join(`; `)} }`}let s=Array.isArray(e.type)?e.type:e.type?[e.type]:[];if(s.includes(`array`))return`Array<${a(e.items,n)}>`;if(s.includes(`object`)){let t=e.additionalProperties;return t===void 0||t===!1?`Record<string, unknown>`:`Record<string, ${t===!0||r(t)?`unknown`:a(t,n)}>`}return s.length===0?`unknown`:s.map(e=>t[e]??`unknown`).join(` | `)}function o(e){return e.$ref?`any`:e.const===void 0?e.anyOf||e.oneOf?`any`:e.enum?`string`:Array.isArray(e.type)?e.type.find(e=>e!==`null`)??`string`:e.type??`string`:typeof e.const==`string`?`string`:typeof e.const}function s(e,t=!1,n={}){if(e.$ref)return{$schema:{type:`any`,tsType:e.$ref.split(`/`).pop()??`unknown`,...t?{tags:[`@required`]}:{}}};if(e.properties){let r=t?{$schema:{tags:[`@required`]}}:{};for(let[t,i]of Object.entries(e.properties))r[t]=s(i,e.required?.includes(t)??!1,n);return e.additionalProperties!==void 0&&e.additionalProperties!==!1&&(r.$schema={...r.$schema??{},allowExtraKeys:!0}),r}let r=o(e),i={};return e.defaultValue===void 0?e.default!==void 0&&(i.$default=e.default):i.$default=e.defaultValue,i.$schema={type:r,tsType:a(e,n),...r===`array`?{items:{type:o(e.items??{})}}:{},...t?{tags:[`@required`]}:{},...e.description?{description:e.description}:{},...e.env?{env:e.env}:{},...e.scope?{scope:e.scope}:{},...e.secret?{secret:!0}:{},...e.public?{public:!0}:{},...e.required===!0?{required:!0}:{},...e.defaultValue!==void 0&&e.default!==void 0?{envDefault:e.default}:{}},i}function c(e){let t=e.toJSONSchema();if(!t)return{};let n=t.$defs??{},r=t.$ref?.split(`/`).pop();return s(r&&n[r]?n[r]:t,!1,n)}function l(t){try{return e.compile(t)}catch{return t}}function u(e){return e!==null&&!Array.isArray(e)&&typeof e==`object`}function d(e){let t=typeof e;if(t!==`undefined`&&e!==null)return Array.isArray(e)?`array`:t}function f(e,t,n=`.`){return e?`${e}${n}${t}`:t}function p(e){return[...new Set(e.filter(e=>!!e))]}function m(e){if(e.type===`array`&&!(`items`in e)){let t=p((e.default??[]).map(e=>d(e)));e.items={type:t.length===0?`any`:t.length===1?t[0]:t}}if(e.default===void 0&&(`properties`in e||e.type===`object`||e.type===`any`)){let t=e.properties??{};e.default=Object.fromEntries(Object.entries(t).filter(([,e])=>`default`in e).map(([e,t])=>[e,t.default]))}}function h(e,t,n){if(n.cache.has(t))return n.cache.get(t);let r=`#${t.replace(/\./g,`/`)}`;if(!u(e)){let i=Array.isArray(e)?[...e]:e,a={type:d(e),id:r,default:i};return m(a),n.cache.set(t,a),a}let i={...e.$schema??{},id:r};n.cache.set(t,i);let a=Object.keys(e).filter(e=>e!==`$resolve`&&e!==`$schema`&&e!==`$default`);if(a.length>0){let r={};i.properties=r;for(let o of a)if(!r[o]){let a=r[o]=h(e[o],f(t,o),n);Array.isArray(a.tags)&&a.tags.includes(`@required`)&&(i.required=i.required||[],i.required.includes(o)||i.required.push(o))}}return i.default===void 0&&`$default`in e&&(i.default=e.$default),i.type||=d(i.default)||(i.properties?`object`:`any`),m(i),i}function g(e){return h(e,``,{root:e,cache:/* @__PURE__ */ new Map})}function _(e){return g(c(e))}function v(e,t=`base`){let n=e.properties??{},r=n[t];if(r&&r.type===`object`&&r.properties){let{[t]:i,...a}=n,o=(e.required??[]).filter(e=>e!==t);return{base:r,groups:{...e,properties:a,...o.length>0?{required:o}:{}},hasBase:!0}}return{base:e,groups:{...e,properties:{}},hasBase:!1}}function y(e,t=`base`){let n=e.properties??{},r=n[t];if(r?.type!==`object`)return e;let i=r.properties;if(!i)return e;let{[t]:a,...o}=n;return{...e,properties:{...i,...o},required:[...(e.required??[]).filter(e=>e!==t),...r.required??[]]}}export{l as compileZodSchema,n as envMetaOf,y as flattenBaseSchema,a as renderTsType,g as resolveUntypedSchema,v as splitBaseSchema,_ as zodToJsonSchema,c as zodToUntypedDefinition};
+import"node:path";import"node:url";import.meta.url;import{z as e}from"zod";const t={string:`string`,number:`number`,integer:`number`,boolean:`boolean`,null:`null`};function n(e){return typeof e==`object`&&!!e&&`safeParse`in e}function r(e){return typeof e!=`object`||!e||Array.isArray(e)||n(e)?!1:`type`in e||`properties`in e||`tsType`in e||`id`in e}const i=[`id`,`description`,`required`,`deprecated`,`deprecationMessage`,`example`,`since`,`see`,`remarks`,`experimental`,`alpha`,`beta`,`secret`,`scope`,`public`,`defaultValue`,`envName`,`env`,`envPath`,`path`,`typeName`,`cliFlag`,`cliFlagShort`];function a(e){if(n(e)){let t=e.meta?.();return t&&typeof t==`object`?t:void 0}let t=e,r={};for(let e of i)e===`id`&&typeof t.id==`string`&&t.id.startsWith(`#`)||t[e]!==void 0&&(r[e]=t[e]);return Object.keys(r).length>0?r:void 0}function o(e){return n(e)?E(e):e}function s(e){let t={},n=/* @__PURE__ */ new Set,r={type:`object`,properties:t};for(let i of e){let a=i;if(a.properties&&Object.assign(t,a.properties),Array.isArray(a.required))for(let e of a.required)n.add(e);e.length===1&&(r=i)}return{...r,type:`object`,properties:t,...n.size>0?{required:[...n]}:{}}}function c(e){if(Array.isArray(e)){let t=s(e.map(o));return{[a(t)?.id??`config`]:t}}if(n(e)||r(e)){let t=o(e);return{[a(t)?.id??`config`]:t}}let t={};for(let[n,r]of Object.entries(e))t[n]=Array.isArray(r)?s(r.map(o)):o(r);return t}function l(e){return!e||Object.keys(e).length===0}function u(e){return`'${String(e).replace(/\\/g,`\\\\`).replace(/'/g,`\\'`)}'`}function d(e,n={}){if(!e||l(e))return`unknown`;if(e.$ref){let t=e.$ref.split(`/`).pop()??`unknown`;return n[t]?t:`unknown`}if(e.const!==void 0)return typeof e.const==`string`?u(e.const):String(e.const);if(Array.isArray(e.enum)&&e.enum.length>0)return e.enum.map(u).join(` | `);let r=e.anyOf??e.oneOf;if(Array.isArray(r)&&r.length>0)return r.map(e=>d(e,n)).join(` | `);if(e.properties){let t=Array.isArray(e.required)?e.required:[];return`{ ${Object.entries(e.properties).map(([e,r])=>`${e}${t.includes(e)?``:`?`}: ${d(r,n)}`).join(`; `)} }`}let i=Array.isArray(e.type)?e.type:e.type?[e.type]:[];if(i.includes(`array`))return`Array<${d(e.items,n)}>`;if(i.includes(`object`)){let t=e.additionalProperties;return t===void 0||t===!1?`Record<string, unknown>`:`Record<string, ${t===!0||l(t)?`unknown`:d(t,n)}>`}return i.length===0?`unknown`:i.map(e=>t[e]??`unknown`).join(` | `)}function f(e){return e.$ref?`any`:e.const===void 0?e.anyOf||e.oneOf?`any`:e.enum?`string`:Array.isArray(e.type)?e.type.find(e=>e!==`null`)??`string`:e.type??`string`:typeof e.const==`string`?`string`:typeof e.const}function p(e,t={}){if(!e)return{};let n=e.$ref?.split(`/`).pop(),r=n?t[n]:void 0,i=e.required===!0||r?.required===!0||void 0,a=e.env??r?.env,o=e.envName??r?.envName,s=e.envPath??r?.envPath,c=e.path??r?.path,l=e.cliFlag??r?.cliFlag,u=e.cliFlagShort??r?.cliFlagShort,d=e.typeName??r?.typeName,f=e.id??r?.id,p=e.deprecated??r?.deprecated,m=e.deprecationMessage??r?.deprecationMessage,h=e.example??r?.example,g=e.since??r?.since,_=e.see??r?.see,v=e.remarks??r?.remarks,y=e.experimental??r?.experimental,b=e.alpha??r?.alpha,x=e.beta??r?.beta;for(let n of[...e.anyOf??[],...e.oneOf??[]]){let e=n.$ref?.split(`/`).pop(),r=e?t[e]:void 0;i??=n.required===!0||r?.required===!0||void 0,a??=n.env??r?.env,o??=n.envName??r?.envName,s??=n.envPath??r?.envPath,c??=n.path??r?.path,l??=n.cliFlag??r?.cliFlag,u??=n.cliFlagShort??r?.cliFlagShort,d??=n.typeName??r?.typeName,f??=n.id??r?.id,p??=n.deprecated??r?.deprecated,m??=n.deprecationMessage??r?.deprecationMessage,h??=n.example??r?.example,g??=n.since??r?.since,_??=n.see??r?.see,v??=n.remarks??r?.remarks,y??=n.experimental??r?.experimental,b??=n.alpha??r?.alpha,x??=n.beta??r?.beta}return{...a===void 0?{}:{env:a},...o===void 0?{}:{envName:o},...s===void 0?{}:{envPath:s},...c===void 0?{}:{path:c},...l===void 0?{}:{cliFlag:l},...u===void 0?{}:{cliFlagShort:u},...d===void 0?{}:{typeName:d},...f===void 0?{}:{id:f},...i===void 0?{}:{required:i},...p===void 0?{}:{deprecated:p},...m===void 0?{}:{deprecationMessage:m},...h===void 0?{}:{example:h},...g===void 0?{}:{since:g},..._===void 0?{}:{see:_},...v===void 0?{}:{remarks:v},...y===void 0?{}:{experimental:y},...b===void 0?{}:{alpha:b},...x===void 0?{}:{beta:x}}}function m(e,t=!1,n={}){if(e.$ref){let r=e.$ref.split(`/`).pop()??`unknown`,i=n[r],a=e.description??i?.description;return{$schema:{type:`any`,tsType:r,...t?{tags:[`@required`]}:{},...a?{description:a}:{},...p(e,n)}}}if(e.properties){let r=t?{$schema:{tags:[`@required`]}}:{};e.description&&(r.$schema={...r.$schema,description:e.description});let i=p(e,n);(i.deprecated!==void 0||i.example!==void 0)&&(r.$schema={...r.$schema,...i});for(let[t,i]of Object.entries(e.properties))r[t]=m(i,e.required?.includes(t)??!1,n);return e.additionalProperties!==void 0&&e.additionalProperties!==!1&&(r.$schema={...r.$schema,allowExtraKeys:!0}),r}let r=f(e),i={};return e.defaultValue===void 0?e.default!==void 0&&(i.$default=e.default):i.$default=e.defaultValue,i.$schema={type:r,tsType:d(e,n),...r===`array`?{items:{type:f(e.items??{})}}:{},...t?{tags:[`@required`]}:{},...e.description?{description:e.description}:{},...e.env?{env:e.env}:{},...e.scope?{scope:e.scope}:{},...e.secret?{secret:!0}:{},...e.public?{public:!0}:{},...p(e,n),...e.defaultValue!==void 0&&e.default!==void 0?{envDefault:e.default}:{}},i}function h(e){let t=e.toJSONSchema();if(!t)return{};let n=t.$defs??{},r=t.$ref?.split(`/`).pop();return m(r&&n[r]?n[r]:t,!1,n)}function g(t){try{return e.compile(t)}catch{return t}}function _(e){return e!==null&&!Array.isArray(e)&&typeof e==`object`}function v(e){let t=typeof e;if(t!==`undefined`&&e!==null)return Array.isArray(e)?`array`:t}function y(e,t,n=`.`){return e?`${e}${n}${t}`:t}function b(e){return[...new Set(e.filter(e=>!!e))]}function x(e){if(e.type===`array`&&!(`items`in e)){let t=b((e.default??[]).map(e=>v(e)));e.items={type:t.length===0?`any`:t.length===1?t[0]:t}}if(e.default===void 0&&(`properties`in e||e.type===`object`||e.type===`any`)){let t=e.properties??{};e.default=Object.fromEntries(Object.entries(t).filter(([,e])=>`default`in e).map(([e,t])=>[e,t.default]))}}function S(e,t,n){if(n.cache.has(t))return n.cache.get(t);let r=`#${t.replace(/\./g,`/`)}`;if(!_(e)){let i=Array.isArray(e)?[...e]:e,a={type:v(e),id:r,default:i};return x(a),n.cache.set(t,a),a}let i={...e.$schema,id:r};n.cache.set(t,i);let a=Object.keys(e).filter(e=>e!==`$resolve`&&e!==`$schema`&&e!==`$default`);if(a.length>0){let r={};i.properties=r;for(let o of a)if(!r[o]){let a=r[o]=S(e[o],y(t,o),n);Array.isArray(a.tags)&&a.tags.includes(`@required`)&&(i.required=i.required||[],i.required.includes(o)||i.required.push(o))}}return i.default===void 0&&`$default`in e&&(i.default=e.$default),i.type||=v(i.default)||(i.properties?`object`:`any`),x(i),i}function C(e){return S(e,``,{root:e,cache:/* @__PURE__ */ new Map})}function w(e){if(!e||typeof e!=`object`||Array.isArray(e))return;let t=e;if(typeof t.deprecated==`string`&&(t.deprecationMessage=t.deprecated,t.deprecated=!0),`example`in t){let e=t.example;delete t.example,t.examples=Array.isArray(e)?e:[e]}for(let e of[`properties`,`$defs`]){let n=t[e];if(n&&typeof n==`object`&&!Array.isArray(n))for(let e of Object.values(n))w(e)}for(let e of[`items`,`additionalProperties`])w(t[e]);for(let e of[`anyOf`,`oneOf`,`allOf`]){let n=t[e];if(Array.isArray(n))for(let e of n)w(e)}}function T(e){let t=e.toJSONSchema();if(!t)return{};let n=t.$defs??{},r={};for(let[e,t]of Object.entries(n))r[e]=C(m(t,!1,n));let i=t.$ref?.split(`/`).pop()??t.id??a(e)?.id??`config`;return r[i]||(r[i]=C(m(t,!1,n))),r}function E(e){return C(h(e))}function D(e,t=`base`){let n=e.properties??{},r=n[t];if(r&&r.type===`object`&&r.properties){let{[t]:i,...a}=n,o=(e.required??[]).filter(e=>e!==t);return{base:r,groups:{...e,properties:a,...o.length>0?{required:o}:{}},hasBase:!0}}return{base:e,groups:{...e,properties:{}},hasBase:!1}}function O(e,t=`base`){let n=e.properties??{},r=n[t];if(r?.type!==`object`)return e;let i=r.properties;if(!i)return e;let{[t]:a,...o}=n;return{...e,properties:{...i,...o},required:[...(e.required??[]).filter(e=>e!==t),...r.required??[]]}}export{g as compileZodSchema,O as flattenBaseSchema,r as isSchemaType,n as isZodSchema,a as metaOf,c as normalizeConfigSchema,w as normalizeJsonSchemaMetadata,d as renderTsType,C as resolveUntypedSchema,D as splitBaseSchema,o as toSchemaType,E as zodToJsonSchema,T as zodToSchemaMap,h as zodToUntypedDefinition};