@ontrails/config 1.0.0-beta.12

package/dist/extensions.d.ts

@@ -0,0 +1,38 @@
+import type { z } from 'zod';
+/** Metadata shape stored on Zod schemas via `.meta()`. */
+export interface ConfigFieldMeta {
+    readonly env?: string;
+    readonly secret?: boolean;
+    readonly deprecated?: string;
+}
+/**
+ * Bind a schema field to an environment variable.
+ *
+ * Must be called BEFORE `.default()`, `.optional()`, or other transforms
+ * so that the metadata lives on the inner type where `collectConfigMeta`
+ * can find it by unwrapping wrappers.
+ */
+export declare const env: <T extends z.ZodType>(schema: T, varName: string) => T;
+/**
+ * Mark a schema field as sensitive. Redacted in survey, explain, and logs.
+ *
+ * Must be called BEFORE `.default()`, `.optional()`, or other transforms.
+ */
+export declare const secret: <T extends z.ZodType>(schema: T) => T;
+/**
+ * Mark a schema field as deprecated with migration guidance.
+ *
+ * Stores **two** meta keys: `deprecated: true` and `deprecationMessage: string`.
+ * This indirection exists because Zod 4's `GlobalMeta` types `deprecated` as
+ * `boolean | undefined` — there is no way to attach a migration message to the
+ * standard key. We set `deprecated: true` so Zod-native tooling (schema
+ * serializers, OpenAPI generators) recognises the field as deprecated, and store
+ * the human-readable message under `deprecationMessage` for our own
+ * `collectConfigMeta` / survey / explain surfaces.
+ *
+ * Must be called BEFORE `.default()`, `.optional()`, or other transforms
+ * so that the metadata lives on the inner type where `collectConfigMeta`
+ * can find it by unwrapping wrappers.
+ */
+export declare const deprecated: <T extends z.ZodType>(schema: T, message: string) => T;
+//# sourceMappingURL=extensions.d.ts.map

package/dist/extensions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extensions.d.ts","sourceRoot":"","sources":["../src/extensions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B,0DAA0D;AAC1D,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;;;;;GAMG;AACH,eAAO,MAAM,GAAG,GAAI,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,QAAQ,CAAC,EAAE,SAAS,MAAM,KAAG,CAChB,CAAC;AAEvD;;;;GAIG;AACH,eAAO,MAAM,MAAM,GAAI,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,QAAQ,CAAC,KAAG,CACF,CAAC;AAEvD;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,UAAU,GAAI,CAAC,SAAS,CAAC,CAAC,OAAO,EAC5C,QAAQ,CAAC,EACT,SAAS,MAAM,KACd,CAKM,CAAC"}

package/dist/extensions.js

@@ -0,0 +1,35 @@
+/**
+ * Bind a schema field to an environment variable.
+ *
+ * Must be called BEFORE `.default()`, `.optional()`, or other transforms
+ * so that the metadata lives on the inner type where `collectConfigMeta`
+ * can find it by unwrapping wrappers.
+ */
+export const env = (schema, varName) => schema.meta({ ...schema.meta(), env: varName });
+/**
+ * Mark a schema field as sensitive. Redacted in survey, explain, and logs.
+ *
+ * Must be called BEFORE `.default()`, `.optional()`, or other transforms.
+ */
+export const secret = (schema) => schema.meta({ ...schema.meta(), secret: true });
+/**
+ * Mark a schema field as deprecated with migration guidance.
+ *
+ * Stores **two** meta keys: `deprecated: true` and `deprecationMessage: string`.
+ * This indirection exists because Zod 4's `GlobalMeta` types `deprecated` as
+ * `boolean | undefined` — there is no way to attach a migration message to the
+ * standard key. We set `deprecated: true` so Zod-native tooling (schema
+ * serializers, OpenAPI generators) recognises the field as deprecated, and store
+ * the human-readable message under `deprecationMessage` for our own
+ * `collectConfigMeta` / survey / explain surfaces.
+ *
+ * Must be called BEFORE `.default()`, `.optional()`, or other transforms
+ * so that the metadata lives on the inner type where `collectConfigMeta`
+ * can find it by unwrapping wrappers.
+ */
+export const deprecated = (schema, message) => schema.meta({
+    ...schema.meta(),
+    deprecated: true,
+    deprecationMessage: message,
+});
+//# sourceMappingURL=extensions.js.map

package/dist/extensions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extensions.js","sourceRoot":"","sources":["../src/extensions.ts"],"names":[],"mappings":"AASA;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,GAAG,GAAG,CAAsB,MAAS,EAAE,OAAe,EAAK,EAAE,CACxE,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,MAAM,CAAC,IAAI,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,CAAM,CAAC;AAEvD;;;;GAIG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,CAAsB,MAAS,EAAK,EAAE,CAC1D,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,MAAM,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAM,CAAC;AAEvD;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CACxB,MAAS,EACT,OAAe,EACZ,EAAE,CACL,MAAM,CAAC,IAAI,CAAC;IACV,GAAG,MAAM,CAAC,IAAI,EAAE;IAChB,UAAU,EAAE,IAAI;IAChB,kBAAkB,EAAE,OAAO;CAC5B,CAAM,CAAC"}

package/dist/generate/env.d.ts

@@ -0,0 +1,15 @@
+/**
+ * `.env.example` file generation from Zod schema `env()` bindings.
+ *
+ * Lists each env var with its type, default, and whether it is a secret.
+ * Returns an empty string when no env bindings are present.
+ */
+import type { z } from 'zod';
+/**
+ * Generate a `.env.example` file from `env()` bindings in the schema.
+ *
+ * Lists each env var with its type, default, and whether it is a secret.
+ * Returns an empty string when no env bindings are present.
+ */
+export declare const generateEnvExample: (schema: z.ZodObject<Record<string, z.ZodType>>) => string;
+//# sourceMappingURL=env.d.ts.map

package/dist/generate/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../src/generate/env.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAsF7B;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,GAC7B,QAAQ,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,KAC7C,MAGF,CAAC"}

package/dist/generate/env.js

@@ -0,0 +1,65 @@
+import { collectConfigMeta } from '../collect.js';
+import { isLikelySecret } from '../secret-heuristics.js';
+import { formatValue, getDefault, getDescription, resolveFieldByPath, unwrap, zodTypeName, zodTypeToJsonSchema, } from './helpers.js';
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/** Map Zod type names to human-readable type labels. */
+const typeLabel = (schema) => {
+    const typeName = zodTypeName(unwrap(schema));
+    return zodTypeToJsonSchema[typeName] ?? typeName;
+};
+/** Build the type annotation comment for an env entry. */
+const envTypeAnnotation = (fieldSchema, meta) => {
+    const parts = [`type: ${typeLabel(fieldSchema)}`];
+    const info = getDefault(fieldSchema);
+    if (info.has) {
+        parts.push(`default: ${formatValue(info.value)}`);
+    }
+    if (meta.secret) {
+        parts.push('secret');
+    }
+    return `# ${parts.join(', ')}`;
+};
+/** Format a single env var entry. */
+const envEntry = (envVar, fieldSchema, meta) => {
+    const effectiveMeta = !meta.secret && isLikelySecret(envVar) ? { ...meta, secret: true } : meta;
+    const lines = [];
+    const desc = getDescription(fieldSchema);
+    if (desc) {
+        lines.push(`# ${desc}`);
+    }
+    lines.push(envTypeAnnotation(fieldSchema, effectiveMeta));
+    lines.push(`${envVar}=`);
+    return lines;
+};
+/** Collect env entries from config metadata. */
+const collectEnvEntries = (schema, meta) => {
+    const entries = [];
+    for (const [path, fieldMeta] of meta) {
+        if (!fieldMeta.env) {
+            continue;
+        }
+        const fieldSchema = resolveFieldByPath(schema, path);
+        if (!fieldSchema) {
+            continue;
+        }
+        entries.push(...envEntry(fieldMeta.env, fieldSchema, fieldMeta));
+        entries.push('');
+    }
+    return entries;
+};
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Generate a `.env.example` file from `env()` bindings in the schema.
+ *
+ * Lists each env var with its type, default, and whether it is a secret.
+ * Returns an empty string when no env bindings are present.
+ */
+export const generateEnvExample = (schema) => {
+    const entries = collectEnvEntries(schema, collectConfigMeta(schema));
+    return entries.length === 0 ? '' : entries.join('\n');
+};
+//# sourceMappingURL=env.js.map

package/dist/generate/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../../src/generate/env.ts"],"names":[],"mappings":"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"}

package/dist/generate/example.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Config example file generation in multiple formats.
+ *
+ * Produces TOML, JSON, JSONC, and YAML example files from a Zod schema,
+ * with defaults shown and deprecated fields annotated.
+ */
+import type { z } from 'zod';
+type ExampleFormat = 'json' | 'jsonc' | 'toml' | 'yaml';
+/**
+ * Generate an example config file in the specified format.
+ *
+ * Includes descriptions as comments, defaults shown, deprecated fields annotated.
+ */
+export declare const generateExample: (schema: z.ZodObject<Record<string, z.ZodType>>, format: ExampleFormat) => string;
+export {};
+//# sourceMappingURL=example.d.ts.map

package/dist/generate/example.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"example.d.ts","sourceRoot":"","sources":["../../src/generate/example.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAoM7B,KAAK,aAAa,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;AAYxD;;;;GAIG;AACH,eAAO,MAAM,eAAe,GAC1B,QAAQ,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,EAC9C,QAAQ,aAAa,KACpB,MAAoC,CAAC"}

package/dist/generate/example.js

@@ -0,0 +1,136 @@
+import { fieldComments, fieldValue, formatValue, getObjectShape, isObjectType, pushComments, unwrap, } from './helpers.js';
+// ---------------------------------------------------------------------------
+// TOML generation
+// ---------------------------------------------------------------------------
+/** Render a flat set of fields as TOML key = value lines. */
+const renderTomlFields = (shape, lines) => {
+    for (const [key, fieldSchema] of Object.entries(shape)) {
+        if (isObjectType(fieldSchema)) {
+            continue;
+        }
+        pushComments(lines, fieldComments(fieldSchema, '#'), '');
+        lines.push(`${key} = ${formatValue(fieldValue(fieldSchema))}`);
+    }
+};
+/** Render nested objects as TOML sections, recursing with dotted prefixes. */
+const renderTomlSections = (shape, lines, prefix = '') => {
+    for (const [key, fieldSchema] of Object.entries(shape)) {
+        const nested = isObjectType(fieldSchema)
+            ? getObjectShape(fieldSchema)
+            : undefined;
+        if (!nested) {
+            continue;
+        }
+        const sectionKey = prefix ? `${prefix}.${key}` : key;
+        if (lines.length > 0) {
+            lines.push('');
+        }
+        lines.push(`[${sectionKey}]`);
+        renderTomlFields(nested, lines);
+        // oxlint-disable-next-line max-statements -- recursive TOML section rendering
+        renderTomlSections(nested, lines, sectionKey);
+    }
+};
+const formatToml = (schema) => {
+    const shape = schema.shape;
+    const lines = [];
+    renderTomlFields(shape, lines);
+    renderTomlSections(shape, lines);
+    return `${lines.join('\n')}\n`;
+};
+// ---------------------------------------------------------------------------
+// JSON / JSONC generation
+// ---------------------------------------------------------------------------
+/** Resolve a field to its nested object or its scalar value. */
+const resolveJsonField = (fieldSchema, recurse) => {
+    if (!isObjectType(fieldSchema)) {
+        return fieldValue(fieldSchema);
+    }
+    const nested = getObjectShape(fieldSchema);
+    if (!nested) {
+        return fieldValue(fieldSchema);
+    }
+    const inner = unwrap(fieldSchema);
+    return recurse(inner);
+};
+/** Build a plain object with default/placeholder values for JSON output. */
+const buildJsonObject = (schema) => {
+    const shape = schema.shape;
+    const obj = {};
+    for (const [key, fieldSchema] of Object.entries(shape)) {
+        obj[key] = resolveJsonField(fieldSchema, buildJsonObject);
+    }
+    return obj;
+};
+const formatJson = (schema) => `${JSON.stringify(buildJsonObject(schema), null, 2)}\n`;
+/** Render a single JSONC entry (comments + key: value). */
+const renderJsoncEntry = (key, fieldSchema, isLast, lines, indent) => {
+    pushComments(lines, fieldComments(fieldSchema, '//'), indent);
+    const comma = isLast ? '' : ',';
+    const nested = getObjectShape(fieldSchema);
+    if (nested) {
+        lines.push(`${indent}"${key}": {`);
+        renderJsoncFields(nested, lines, `${indent}  `);
+        lines.push(`${indent}}${comma}`);
+        return;
+    }
+    const val = formatValue(fieldValue(fieldSchema));
+    lines.push(`${indent}"${key}": ${val}${comma}`);
+};
+const renderJsoncFields = (shape, lines, indent) => {
+    const keys = Object.keys(shape);
+    for (let i = 0; i < keys.length; i += 1) {
+        const key = keys[i];
+        renderJsoncEntry(key, shape[key], i === keys.length - 1, lines, indent);
+    }
+};
+const formatJsonc = (schema) => {
+    const shape = schema.shape;
+    const lines = ['{'];
+    renderJsoncFields(shape, lines, '  ');
+    lines.push('}');
+    return `${lines.join('\n')}\n`;
+};
+// ---------------------------------------------------------------------------
+// YAML generation
+// ---------------------------------------------------------------------------
+/** Render a single YAML scalar field. */
+const renderYamlScalar = (key, fieldSchema, indent, lines) => {
+    pushComments(lines, fieldComments(fieldSchema, '#'), indent);
+    lines.push(`${indent}${key}: ${formatValue(fieldValue(fieldSchema))}`);
+};
+/** Render YAML fields at a given indent level. */
+const renderYamlFields = (shape, indent, lines) => {
+    for (const [key, fieldSchema] of Object.entries(shape)) {
+        if (isObjectType(fieldSchema)) {
+            const nested = getObjectShape(fieldSchema);
+            if (!nested) {
+                continue;
+            }
+            lines.push(`${indent}${key}:`);
+            renderYamlFields(nested, `${indent}  `, lines);
+        }
+        else {
+            renderYamlScalar(key, fieldSchema, indent, lines);
+        }
+    }
+};
+const formatYaml = (schema) => {
+    const shape = schema.shape;
+    const lines = [];
+    renderYamlFields(shape, '', lines);
+    return `${lines.join('\n')}\n`;
+};
+const formatters = {
+    json: formatJson,
+    jsonc: formatJsonc,
+    toml: formatToml,
+    yaml: formatYaml,
+};
+/**
+ * Generate an example config file in the specified format.
+ *
+ * Includes descriptions as comments, defaults shown, deprecated fields annotated.
+ */
+export const generateExample = (schema, format) => formatters[format](schema);
+//# sourceMappingURL=example.js.map

package/dist/generate/example.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"example.js","sourceRoot":"","sources":["../../src/generate/example.ts"],"names":[],"mappings":"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"}

package/dist/generate/helpers.d.ts

@@ -0,0 +1,35 @@
+import type { z } from 'zod';
+/** Unwrap `.default()`, `.optional()`, `.nullable()` to reach the inner type. */
+export declare const unwrap: (schema: z.ZodType) => z.ZodType;
+/** Read the Zod type discriminant from a schema's def. */
+export declare const zodTypeName: (schema: z.ZodType) => string;
+/** Walk the registry up through wrappers to find a metadata key. */
+export declare const walkRegistryKey: (schema: z.ZodType, key: string) => unknown | undefined;
+/** Get the description from the global registry for a schema or its inner type. */
+export declare const getDescription: (schema: z.ZodType) => string | undefined;
+/** Get the deprecation message from the config meta for a field. */
+export declare const getDeprecation: (schema: z.ZodType) => string | undefined;
+/** Get the default value from a schema if it has one. */
+export declare const getDefault: (schema: z.ZodType) => {
+    has: false;
+} | {
+    has: true;
+    value: unknown;
+};
+/** Check whether a schema (or its inner type) is a ZodObject. */
+export declare const isObjectType: (schema: z.ZodType) => boolean;
+/** Get the shape of a ZodObject, unwrapping wrappers first. */
+export declare const getObjectShape: (schema: z.ZodType) => Record<string, z.ZodType> | undefined;
+/** Resolve a dot-separated path to the field schema within an object. */
+export declare const resolveFieldByPath: (schema: z.ZodObject<Record<string, z.ZodType>>, path: string) => z.ZodType | undefined;
+/** Format a value as a quoted string or literal. */
+export declare const formatValue: (value: unknown) => string;
+/** Get the display value for a field (default or empty placeholder). */
+export declare const fieldValue: (schema: z.ZodType) => unknown;
+/** Collect comment lines for a field (description + deprecation). */
+export declare const fieldComments: (schema: z.ZodType, prefix: string) => readonly string[];
+/** Append comment lines to an output array. */
+export declare const pushComments: (lines: string[], comments: readonly string[], indent: string) => void;
+/** Map a Zod type name to a JSON Schema type. */
+export declare const zodTypeToJsonSchema: Record<string, string>;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/generate/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/generate/helpers.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAM7B,iFAAiF;AACjF,eAAO,MAAM,MAAM,GAAI,QAAQ,CAAC,CAAC,OAAO,KAAG,CAAC,CAAC,OAW5C,CAAC;AAEF,0DAA0D;AAC1D,eAAO,MAAM,WAAW,GAAI,QAAQ,CAAC,CAAC,OAAO,KAAG,MAG/C,CAAC;AAEF,oEAAoE;AACpE,eAAO,MAAM,eAAe,GAC1B,QAAQ,CAAC,CAAC,OAAO,EACjB,KAAK,MAAM,KACV,OAAO,GAAG,SAaZ,CAAC;AAEF,mFAAmF;AACnF,eAAO,MAAM,cAAc,GAAI,QAAQ,CAAC,CAAC,OAAO,KAAG,MAAM,GAAG,SACE,CAAC;AAE/D,oEAAoE;AACpE,eAAO,MAAM,cAAc,GAAI,QAAQ,CAAC,CAAC,OAAO,KAAG,MAAM,GAAG,SACS,CAAC;AAEtE,yDAAyD;AACzD,eAAO,MAAM,UAAU,GACrB,QAAQ,CAAC,CAAC,OAAO,KAChB;IAAE,GAAG,EAAE,KAAK,CAAA;CAAE,GAAG;IAAE,GAAG,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAM9C,CAAC;AAEF,iEAAiE;AACjE,eAAO,MAAM,YAAY,GAAI,QAAQ,CAAC,CAAC,OAAO,KAAG,OAIhD,CAAC;AAEF,+DAA+D;AAC/D,eAAO,MAAM,cAAc,GACzB,QAAQ,CAAC,CAAC,OAAO,KAChB,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,SAU9B,CAAC;AAEF,yEAAyE;AACzE,eAAO,MAAM,kBAAkB,GAC7B,QAAQ,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,EAC9C,MAAM,MAAM,KACX,CAAC,CAAC,OAAO,GAAG,SAad,CAAC;AAMF,oDAAoD;AACpD,eAAO,MAAM,WAAW,GAAI,OAAO,OAAO,KAAG,MAK5C,CAAC;AAEF,wEAAwE;AACxE,eAAO,MAAM,UAAU,GAAI,QAAQ,CAAC,CAAC,OAAO,KAAG,OAG9C,CAAC;AAEF,qEAAqE;AACrE,eAAO,MAAM,aAAa,GACxB,QAAQ,CAAC,CAAC,OAAO,EACjB,QAAQ,MAAM,KACb,SAAS,MAAM,EAWjB,CAAC;AAEF,+CAA+C;AAC/C,eAAO,MAAM,YAAY,GACvB,OAAO,MAAM,EAAE,EACf,UAAU,SAAS,MAAM,EAAE,EAC3B,QAAQ,MAAM,KACb,IAIF,CAAC;AAEF,iDAAiD;AACjD,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAItD,CAAC"}

package/dist/generate/helpers.js

@@ -0,0 +1,116 @@
+import { globalRegistry } from 'zod';
+// ---------------------------------------------------------------------------
+// Schema introspection helpers
+// ---------------------------------------------------------------------------
+/** Unwrap `.default()`, `.optional()`, `.nullable()` to reach the inner type. */
+export const unwrap = (schema) => {
+    let current = schema;
+    // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
+    while (true) {
+        const def = current.def;
+        const inner = def['innerType'];
+        if (!inner) {
+            return current;
+        }
+        current = inner;
+    }
+};
+/** Read the Zod type discriminant from a schema's def. */
+export const zodTypeName = (schema) => {
+    const def = schema.def;
+    return def['type'] ?? 'unknown';
+};
+/** Walk the registry up through wrappers to find a metadata key. */
+export const walkRegistryKey = (schema, key) => {
+    let current = schema;
+    while (current) {
+        const meta = globalRegistry.get(current);
+        if (meta?.[key] !== undefined) {
+            return meta[key];
+        }
+        const def = current.def;
+        current = def['innerType'];
+    }
+    return undefined;
+};
+/** Get the description from the global registry for a schema or its inner type. */
+export const getDescription = (schema) => walkRegistryKey(schema, 'description');
+/** Get the deprecation message from the config meta for a field. */
+export const getDeprecation = (schema) => walkRegistryKey(schema, 'deprecationMessage');
+/** Get the default value from a schema if it has one. */
+export const getDefault = (schema) => {
+    const def = schema.def;
+    if (def['type'] === 'default') {
+        return { has: true, value: def['defaultValue'] };
+    }
+    return { has: false };
+};
+/** Check whether a schema (or its inner type) is a ZodObject. */
+export const isObjectType = (schema) => {
+    const inner = unwrap(schema);
+    const def = inner.def;
+    return def['type'] === 'object' && 'shape' in def;
+};
+/** Get the shape of a ZodObject, unwrapping wrappers first. */
+export const getObjectShape = (schema) => {
+    const inner = unwrap(schema);
+    const def = inner.def;
+    if (def['type'] !== 'object' || !('shape' in def)) {
+        return undefined;
+    }
+    return inner.shape;
+};
+/** Resolve a dot-separated path to the field schema within an object. */
+export const resolveFieldByPath = (schema, path) => {
+    const parts = path.split('.');
+    let current = schema;
+    for (const part of parts) {
+        const shape = getObjectShape(current);
+        if (!shape?.[part]) {
+            return undefined;
+        }
+        current = shape[part];
+    }
+    return current;
+};
+// ---------------------------------------------------------------------------
+// Value formatting helpers
+// ---------------------------------------------------------------------------
+/** Format a value as a quoted string or literal. */
+export const formatValue = (value) => {
+    if (typeof value === 'string') {
+        return JSON.stringify(value);
+    }
+    return String(value);
+};
+/** Get the display value for a field (default or empty placeholder). */
+export const fieldValue = (schema) => {
+    const info = getDefault(schema);
+    return info.has ? info.value : '';
+};
+/** Collect comment lines for a field (description + deprecation). */
+export const fieldComments = (schema, prefix) => {
+    const lines = [];
+    const desc = getDescription(schema);
+    if (desc) {
+        lines.push(`${prefix} ${desc}`);
+    }
+    const dep = getDeprecation(schema);
+    if (dep) {
+        lines.push(`${prefix} DEPRECATED: ${dep}`);
+    }
+    return lines;
+};
+/** Append comment lines to an output array. */
+export const pushComments = (lines, comments, indent) => {
+    for (const c of comments) {
+        lines.push(`${indent}${c}`);
+    }
+};
+/** Map a Zod type name to a JSON Schema type. */
+export const zodTypeToJsonSchema = {
+    boolean: 'boolean',
+    number: 'number',
+    string: 'string',
+};
+//# sourceMappingURL=helpers.js.map

package/dist/generate/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../src/generate/helpers.ts"],"names":[],"mappings":"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"}

package/dist/generate/index.d.ts

@@ -0,0 +1,4 @@
+export { generateEnvExample } from './env.js';
+export { generateExample } from './example.js';
+export { generateJsonSchema } from './json-schema.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/generate/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/generate/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/generate/index.js

@@ -0,0 +1,4 @@
+export { generateEnvExample } from './env.js';
+export { generateExample } from './example.js';
+export { generateJsonSchema } from './json-schema.js';
+//# sourceMappingURL=index.js.map

package/dist/generate/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/generate/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/generate/json-schema.d.ts

@@ -0,0 +1,18 @@
+/**
+ * JSON Schema generation from Zod object schemas.
+ *
+ * Produces JSON Schema Draft 2020-12 with descriptions, defaults,
+ * deprecated annotations, and constraints.
+ */
+import type { z } from 'zod';
+/**
+ * Generate a JSON Schema from a Zod object schema.
+ *
+ * Includes descriptions, defaults, deprecated annotations, and constraints.
+ * Produces JSON Schema Draft 2020-12.
+ */
+export declare const generateJsonSchema: (schema: z.ZodObject<Record<string, z.ZodType>>, options?: {
+    readonly description?: string;
+    readonly title?: string;
+}) => Record<string, unknown>;
+//# sourceMappingURL=json-schema.d.ts.map

package/dist/generate/json-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-schema.d.ts","sourceRoot":"","sources":["../../src/generate/json-schema.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAsG7B;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,GAC7B,QAAQ,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,EAC9C,UAAU;IAAE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,KACnE,MAAM,CAAC,MAAM,EAAE,OAAO,CAmBxB,CAAC"}

package/dist/generate/json-schema.js

@@ -0,0 +1,97 @@
+import { getDefault, getDeprecation, getDescription, getObjectShape, isObjectType, unwrap, zodTypeName, zodTypeToJsonSchema, } from './helpers.js';
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/** Extract the JSON Schema type or enum from a Zod schema. */
+const jsonSchemaType = (inner) => {
+    const typeName = zodTypeName(inner);
+    if (typeName === 'enum') {
+        const def = inner.def;
+        const entries = def['entries'];
+        return entries ? { enum: Object.keys(entries) } : {};
+    }
+    const mapped = zodTypeToJsonSchema[typeName];
+    return mapped ? { type: mapped } : {};
+};
+/** Annotation extractors for JSON Schema properties. */
+const annotationExtractors = [
+    (s) => {
+        const desc = getDescription(s);
+        return desc ? { description: desc } : {};
+    },
+    (s) => {
+        const info = getDefault(s);
+        return info.has ? { default: info.value } : {};
+    },
+    (s) => {
+        const dep = getDeprecation(s);
+        return dep ? { deprecated: true } : {};
+    },
+];
+/** Extract annotations (description, default, deprecated) for JSON Schema. */
+const jsonSchemaAnnotations = (fieldSchema) => Object.assign({}, ...annotationExtractors.map((fn) => fn(fieldSchema)));
+/** Check if a field is required (no default and not optional). */
+const isRequired = (fieldSchema) => {
+    const def = fieldSchema.def;
+    return def['type'] !== 'default' && def['type'] !== 'optional';
+};
+/** Convert a single Zod field schema to a JSON Schema property. */
+const fieldToJsonSchema = (fieldSchema) => {
+    if (isObjectType(fieldSchema)) {
+        const nestedShape = getObjectShape(fieldSchema);
+        if (nestedShape) {
+            // oxlint-disable-next-line no-use-before-define -- mutual recursion with buildSchemaProperties
+            const { properties, required } = buildSchemaProperties(nestedShape);
+            return {
+                properties,
+                type: 'object',
+                ...(required.length > 0 ? { required } : {}),
+                ...jsonSchemaAnnotations(fieldSchema),
+            };
+        }
+    }
+    return {
+        ...jsonSchemaType(unwrap(fieldSchema)),
+        ...jsonSchemaAnnotations(fieldSchema),
+    };
+};
+/** Build properties and required arrays from a schema shape. */
+const buildSchemaProperties = (shape) => {
+    const properties = {};
+    const required = [];
+    for (const [key, fieldSchema] of Object.entries(shape)) {
+        properties[key] = fieldToJsonSchema(fieldSchema);
+        if (isRequired(fieldSchema)) {
+            required.push(key);
+        }
+    }
+    return { properties, required };
+};
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Generate a JSON Schema from a Zod object schema.
+ *
+ * Includes descriptions, defaults, deprecated annotations, and constraints.
+ * Produces JSON Schema Draft 2020-12.
+ */
+export const generateJsonSchema = (schema, options) => {
+    const { properties, required } = buildSchemaProperties(schema.shape);
+    const result = {
+        $schema: 'https://json-schema.org/draft/2020-12/schema',
+        properties,
+        type: 'object',
+    };
+    if (options?.title) {
+        result['title'] = options.title;
+    }
+    if (options?.description) {
+        result['description'] = options.description;
+    }
+    if (required.length > 0) {
+        result['required'] = required;
+    }
+    return result;
+};
+//# sourceMappingURL=json-schema.js.map