@ontrails/config 1.0.0-beta.15 → 1.0.0-beta.16

package/dist/define-config.d.ts

@@ -1,61 +0,0 @@
-/**
- * Trails-specific config wrapper — `appConfig('trails', ...)` with
- * framework conventions for profile selection and local overrides.
- */
-import type { z } from 'zod';
-/** Options for defining a Trails app config. */
-export interface DefineConfigOptions<T extends z.ZodType> {
-    readonly schema: T;
-    readonly base?: Partial<z.infer<T>>;
-    readonly profiles?: Record<string, Partial<z.infer<T>>>;
-    /** When true, fall back to `NODE_ENV` when `TRAILS_ENV` is unset. */
-    readonly envFromNodeEnv?: boolean;
-}
-/** Options passed to `resolve()` on a defined config. */
-interface DefineConfigResolveOptions {
-    readonly profile?: string;
-    readonly env?: Record<string, string | undefined>;
-    /** Working directory for local overrides discovery. Defaults to `process.cwd()`. */
-    readonly cwd?: string;
-}
-/**
- * Define Trails app config.
- *
- * This is `appConfig('trails', ...)` with the framework's own conventions:
- * `TRAILS_ENV` selects the profile. When `envFromNodeEnv` is true,
- * `NODE_ENV` is used as a fallback when `TRAILS_ENV` is unset.
- *
- * @example
- * ```ts
- * const config = defineConfig({
- *   schema: z.object({
- *     port: z.number().default(3000),
- *     debug: z.boolean().default(false),
- *   }),
- *   base: { port: 8080 },
- *   profiles: {
- *     production: { debug: false },
- *     test: { debug: true, port: 0 },
- *   },
- * });
- *
- * const result = config.resolve();
- * ```
- */
-export declare const defineConfig: <T extends z.ZodType>(options: DefineConfigOptions<T>) => {
-    base: Partial<z.core.output<T>> | undefined;
-    profiles: Record<string, Partial<z.core.output<T>>> | undefined;
-    resolve: (resolveOpts?: DefineConfigResolveOptions) => Promise<import("packages/core/src/result.js").Result<z.core.output<T>, Error>>;
-    schema: T;
-    name: string;
-    formats: readonly import("./app-config.js").ConfigFormat[];
-    dotfile: boolean;
-    describe(): readonly import("./derive-fields.js").FieldDescription[];
-    check(values: Record<string, unknown>, options?: {
-        readonly env?: Record<string, string | undefined>;
-    }): import("./doctor.js").CheckResult;
-    explain(options: import("./app-config.js").AppConfigDeriveProvenanceOptions): readonly import("./derive-provenance.js").ProvenanceEntry[];
-    ref(fieldPath: string): import("./ref.js").ConfigRef;
-};
-export {};
-//# sourceMappingURL=define-config.d.ts.map

package/dist/define-config.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"define-config.d.ts","sourceRoot":"","sources":["../src/define-config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAS7B,gDAAgD;AAChD,MAAM,WAAW,mBAAmB,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO;IACtD,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IACnB,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACpC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACxD,qEAAqE;IACrE,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;CACnC;AAED,yDAAyD;AACzD,UAAU,0BAA0B;IAClC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IAClD,oFAAoF;IACpF,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;CACvB;AAoCD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,YAAY,GAAI,CAAC,SAAS,CAAC,CAAC,OAAO,EAC9C,SAAS,mBAAmB,CAAC,CAAC,CAAC;;;4BAQC,0BAA0B;;;;;;;oBAnCvC,CAAC;;;;CAgErB,CAAC"}

package/dist/define-config.js

@@ -1,87 +0,0 @@
-/**
- * Trails-specific config wrapper — `appConfig('trails', ...)` with
- * framework conventions for profile selection and local overrides.
- */
-import { existsSync } from 'node:fs';
-import { join } from 'node:path';
-import { appConfig } from './app-config.js';
-import { deriveConfig } from './resolve.js';
-// ---------------------------------------------------------------------------
-// Local overrides discovery
-// ---------------------------------------------------------------------------
-const LOCAL_OVERRIDE_CANDIDATES = ['local.ts', 'local.js'];
-/**
- * Discover and synchronously import a `.trails/config/local.{ts,js}` file.
- *
- * Skipped when `TRAILS_ENV=test` for hermetic test environments.
- */
-const discoverLocalOverrides = async (cwd, envRecord) => {
-    if (envRecord['TRAILS_ENV'] === 'test') {
-        return undefined;
-    }
-    for (const filename of LOCAL_OVERRIDE_CANDIDATES) {
-        const candidate = join(cwd, '.trails', 'config', filename);
-        if (existsSync(candidate)) {
-            const mod = await import(candidate);
-            return (mod['default'] ?? mod);
-        }
-    }
-    return undefined;
-};
-// ---------------------------------------------------------------------------
-// Public API
-// ---------------------------------------------------------------------------
-/**
- * Define Trails app config.
- *
- * This is `appConfig('trails', ...)` with the framework's own conventions:
- * `TRAILS_ENV` selects the profile. When `envFromNodeEnv` is true,
- * `NODE_ENV` is used as a fallback when `TRAILS_ENV` is unset.
- *
- * @example
- * ```ts
- * const config = defineConfig({
- *   schema: z.object({
- *     port: z.number().default(3000),
- *     debug: z.boolean().default(false),
- *   }),
- *   base: { port: 8080 },
- *   profiles: {
- *     production: { debug: false },
- *     test: { debug: true, port: 0 },
- *   },
- * });
- *
- * const result = config.resolve();
- * ```
- */
-export const defineConfig = (options) => {
-    const config = appConfig('trails', { schema: options.schema });
-    return {
-        ...config,
-        base: options.base,
-        profiles: options.profiles,
-        resolve: async (resolveOpts) => {
-            const envRecord = {
-                ...(resolveOpts?.env ?? process.env),
-            };
-            if (options.envFromNodeEnv &&
-                envRecord['TRAILS_ENV'] === undefined &&
-                envRecord['NODE_ENV'] !== undefined) {
-                envRecord['TRAILS_ENV'] = envRecord['NODE_ENV'];
-            }
-            const cwd = resolveOpts?.cwd ?? process.cwd();
-            const localOverrides = await discoverLocalOverrides(cwd, envRecord);
-            return deriveConfig({
-                base: options.base,
-                env: envRecord,
-                localOverrides,
-                profile: resolveOpts?.profile ?? envRecord['TRAILS_ENV'],
-                profiles: options.profiles,
-                schema: options.schema,
-            });
-        },
-        schema: options.schema,
-    };
-};
-//# sourceMappingURL=define-config.js.map

package/dist/define-config.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"define-config.js","sourceRoot":"","sources":["../src/define-config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAIjC,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAuB5C,8EAA8E;AAC9E,4BAA4B;AAC5B,8EAA8E;AAE9E,MAAM,yBAAyB,GAAG,CAAC,UAAU,EAAE,UAAU,CAAU,CAAC;AAEpE;;;;GAIG;AACH,MAAM,sBAAsB,GAAG,KAAK,EAClC,GAAW,EACX,SAA6C,EACC,EAAE;IAChD,IAAI,SAAS,CAAC,YAAY,CAAC,KAAK,MAAM,EAAE,CAAC;QACvC,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,KAAK,MAAM,QAAQ,IAAI,yBAAyB,EAAE,CAAC;QACjD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAC3D,IAAI,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC1B,MAAM,GAAG,GAA4B,MAAM,MAAM,CAAC,SAAS,CAAC,CAAC;YAC7D,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,GAAG,CAA4B,CAAC;QAC5D,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC,CAAC;AAEF,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAC1B,OAA+B,EAC/B,EAAE;IACF,MAAM,MAAM,GAAG,SAAS,CAAC,QAAQ,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAE/D,OAAO;QACL,GAAG,MAAM;QACT,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,OAAO,EAAE,KAAK,EAAE,WAAwC,EAAE,EAAE;YAC1D,MAAM,SAAS,GAAG;gBAChB,GAAG,CAAC,WAAW,EAAE,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;aACC,CAAC;YAExC,IACE,OAAO,CAAC,cAAc;gBACtB,SAAS,CAAC,YAAY,CAAC,KAAK,SAAS;gBACrC,SAAS,CAAC,UAAU,CAAC,KAAK,SAAS,EACnC,CAAC;gBACD,SAAS,CAAC,YAAY,CAAC,GAAG,SAAS,CAAC,UAAU,CAAC,CAAC;YAClD,CAAC;YAED,MAAM,GAAG,GAAG,WAAW,EAAE,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;YAC9C,MAAM,cAAc,GAAG,MAAM,sBAAsB,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;YAEpE,OAAO,YAAY,CAAC;gBAClB,IAAI,EAAE,OAAO,CAAC,IAA2C;gBACzD,GAAG,EAAE,SAAS;gBACd,cAAc;gBACd,OAAO,EAAE,WAAW,EAAE,OAAO,IAAI,SAAS,CAAC,YAAY,CAAC;gBACxD,QAAQ,EAAE,OAAO,CAAC,QAEL;gBACb,MAAM,EAAE,OAAO,CAAC,MAAM;aACvB,CAAC,CAAC;QACL,CAAC;QACD,MAAM,EAAE,OAAO,CAAC,MAAM;KACvB,CAAC;AACJ,CAAC,CAAC"}

package/dist/derive/env.d.ts

@@ -1,15 +0,0 @@
-/**
- * `.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 deriveConfigEnvExample: (schema: z.ZodObject<Record<string, z.ZodType>>) => string;
-//# sourceMappingURL=env.d.ts.map

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

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

package/dist/derive/env.js

@@ -1,65 +0,0 @@
-import { collectConfigMeta } from '../collect.js';
-import { isLikelySecret } from '../secret-heuristics.js';
-import { formatValue, getDefault, getDescription, deriveFieldByPath, 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 = deriveFieldByPath(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 deriveConfigEnvExample = (schema) => {
-    const entries = collectEnvEntries(schema, collectConfigMeta(schema));
-    return entries.length === 0 ? '' : entries.join('\n');
-};
-//# sourceMappingURL=env.js.map

package/dist/derive/env.js.map

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

package/dist/derive/example.d.ts

@@ -1,16 +0,0 @@
-/**
- * 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 deriveConfigExample: (schema: z.ZodObject<Record<string, z.ZodType>>, format: ExampleFormat) => string;
-export {};
-//# sourceMappingURL=example.d.ts.map

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

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

package/dist/derive/example.js

@@ -1,138 +0,0 @@
-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`;
-/** Serialize a nested object field for JSONC output. */
-const serializeJsoncObject = (fieldSchema) => {
-    const nested = getObjectShape(fieldSchema);
-    if (!nested) {
-        return undefined;
-    }
-    const inner = unwrap(fieldSchema);
-    return JSON.stringify(buildJsonObject(inner), null, 2).replaceAll('\n', '\n  ');
-};
-/** Render a single JSONC entry (comments + key: value). */
-const renderJsoncEntry = (key, fieldSchema, isLast, lines) => {
-    pushComments(lines, fieldComments(fieldSchema, '//'), '  ');
-    const comma = isLast ? '' : ',';
-    const serialized = isObjectType(fieldSchema)
-        ? serializeJsoncObject(fieldSchema)
-        : undefined;
-    const val = serialized ?? formatValue(fieldValue(fieldSchema));
-    lines.push(`  "${key}": ${val}${comma}`);
-};
-const formatJsonc = (schema) => {
-    const keys = Object.keys(schema.shape);
-    const shape = schema.shape;
-    const lines = ['{'];
-    for (let i = 0; i < keys.length; i += 1) {
-        const key = keys[i];
-        renderJsoncEntry(key, shape[key], i === keys.length - 1, 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 deriveConfigExample = (schema, format) => formatters[format](schema);
-//# sourceMappingURL=example.js.map

package/dist/derive/example.js.map

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

package/dist/derive/helpers.d.ts

@@ -1,35 +0,0 @@
-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 deriveFieldByPath: (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/derive/helpers.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/derive/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,iBAAiB,GAC5B,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/derive/helpers.js

@@ -1,116 +0,0 @@
-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 deriveFieldByPath = (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 `"${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/derive/helpers.js.map

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

package/dist/derive/index.d.ts

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

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/derive/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/derive/index.js

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

package/dist/derive/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/derive/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC"}

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

@@ -1,18 +0,0 @@
-/**
- * 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 deriveConfigJsonSchema: (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/derive/json-schema.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"json-schema.d.ts","sourceRoot":"","sources":["../../src/derive/json-schema.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAsG7B;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,GACjC,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"}