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

package/dist/doctor.js

@@ -1,131 +0,0 @@
-/**
- * Config doctor — structured diagnostics for a config object against a schema.
- *
- * Reports which fields are valid, missing, using defaults, deprecated, or invalid.
- */
-import { collectConfigMeta } from './collect.js';
-import { getAtPath, isZodObject, unwrapToBase, zodDef } from './zod-utils.js';
-// ---------------------------------------------------------------------------
-// Helpers (defined before consumers)
-// ---------------------------------------------------------------------------
-/** Check if a schema wraps a ZodDefault. */
-const isDefaultWrapper = (schema) => zodDef(schema)['type'] === 'default';
-/** Check if a schema wraps a ZodOptional. */
-const isOptionalWrapper = (schema) => zodDef(schema)['type'] === 'optional';
-/** Get the default value from a ZodDefault wrapper. */
-const getDefaultValue = (schema) => zodDef(schema)['defaultValue'];
-/** Set a value at a dot-separated path, creating intermediate objects. */
-const setAtPath = (obj, path, value) => {
-    const parts = path.split('.');
-    let current = obj;
-    for (let i = 0; i < parts.length - 1; i += 1) {
-        const part = parts[i];
-        const next = current[part];
-        const nested = typeof next === 'object' && next !== null
-            ? next
-            : {};
-        current[part] = nested;
-        current = nested;
-    }
-    const lastPart = parts.at(-1);
-    current[lastPart] = value;
-};
-/** Build values object with env overrides applied. */
-const applyEnvToValues = (values, schema, envVars) => {
-    const meta = collectConfigMeta(schema);
-    const result = structuredClone(values);
-    for (const [path, fieldMeta] of meta) {
-        if (fieldMeta.env && envVars[fieldMeta.env] !== undefined) {
-            setAtPath(result, path, envVars[fieldMeta.env]);
-        }
-    }
-    return result;
-};
-/** Validate a single field value against its schema. */
-const validateFieldValue = (path, fieldSchema, value) => {
-    const result = fieldSchema.safeParse(value);
-    if (result.success) {
-        return { message: 'OK', path, status: 'valid', value };
-    }
-    const issue = result.error?.issues?.[0];
-    const msg = issue ? issue.message : 'Invalid value';
-    return { message: msg, path, status: 'invalid', value };
-};
-/** Classify a single field and produce a diagnostic. */
-const classifyField = (path, fieldSchema, values, deprecatedMeta) => {
-    const value = getAtPath(values, path);
-    const deprecationMsg = deprecatedMeta.get(path);
-    if (deprecationMsg && value !== undefined) {
-        return { message: deprecationMsg, path, status: 'deprecated', value };
-    }
-    if (value === undefined && isDefaultWrapper(fieldSchema)) {
-        return {
-            message: 'Using default value',
-            path,
-            status: 'default',
-            value: getDefaultValue(fieldSchema),
-        };
-    }
-    if (value === undefined && !isOptionalWrapper(fieldSchema)) {
-        return {
-            message: `Required field "${path}" is missing`,
-            path,
-            status: 'missing',
-        };
-    }
-    return validateFieldValue(path, fieldSchema, value);
-};
-/** Collect deprecated metadata paths from config meta. */
-const collectDeprecatedPaths = (schema) => {
-    const meta = collectConfigMeta(schema);
-    const result = new Map();
-    for (const [path, fieldMeta] of meta) {
-        if (fieldMeta.deprecated) {
-            result.set(path, fieldMeta.deprecated);
-        }
-    }
-    return result;
-};
-/** Walk an object shape and enqueue leaf fields or nested objects. */
-const walkShape = (schema, prefix, queue, leaves) => {
-    const shape = zodDef(schema)['shape'];
-    for (const [key, fieldSchema] of Object.entries(shape)) {
-        const path = prefix ? `${prefix}.${key}` : key;
-        if (isZodObject(fieldSchema)) {
-            queue.push({ path, schema: unwrapToBase(fieldSchema) });
-        }
-        else {
-            leaves.push({ path, schema: fieldSchema });
-        }
-    }
-};
-/** Collect all leaf fields from a schema, walking nested objects iteratively. */
-const collectLeaves = (schema) => {
-    const queue = [];
-    const leaves = [];
-    walkShape(schema, '', queue, leaves);
-    for (let entry = queue.pop(); entry; entry = queue.pop()) {
-        walkShape(entry.schema, entry.path, queue, leaves);
-    }
-    return leaves;
-};
-// ---------------------------------------------------------------------------
-// Public API
-// ---------------------------------------------------------------------------
-/**
- * Check a config object against a schema and return structured diagnostics.
- *
- * Reports which fields are valid, missing, using defaults, deprecated, or invalid.
- */
-export const checkConfig = (schema, values, options) => {
-    const objSchema = schema;
-    const effectiveValues = options?.env
-        ? applyEnvToValues(values, objSchema, options.env)
-        : values;
-    const deprecatedMeta = collectDeprecatedPaths(objSchema);
-    const leaves = collectLeaves(objSchema);
-    const diagnostics = leaves.map((leaf) => classifyField(leaf.path, leaf.schema, effectiveValues, deprecatedMeta));
-    const valid = diagnostics.every((d) => d.status !== 'missing' && d.status !== 'invalid');
-    return { diagnostics, valid };
-};
-//# sourceMappingURL=doctor.js.map

package/dist/doctor.js.map

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

package/dist/explain.d.ts

@@ -1,30 +0,0 @@
-/**
- * Config provenance — show which source won for each config field.
- *
- * Used for debugging: answers "where did this value come from?"
- */
-import type { z } from 'zod';
-/** Provenance entry describing the source of a resolved config value. */
-export interface ProvenanceEntry {
-    readonly path: string;
-    readonly value: unknown;
-    readonly source: 'default' | 'base' | 'loadout' | 'local' | 'env';
-    readonly redacted: boolean;
-}
-/** Options for explaining config provenance. */
-export interface ExplainConfigOptions<T extends z.ZodType> {
-    readonly schema: T;
-    readonly base?: Record<string, unknown>;
-    readonly loadout?: Record<string, unknown>;
-    readonly local?: Record<string, unknown>;
-    readonly env?: Record<string, string | undefined>;
-    readonly resolved: Record<string, unknown>;
-}
-/**
- * Show which source won for each config field.
- *
- * Used for debugging — answers "where did this value come from?"
- *
- */
-export declare const explainConfig: <T extends z.ZodType>(options: ExplainConfigOptions<T>) => readonly ProvenanceEntry[];
-//# sourceMappingURL=explain.d.ts.map

package/dist/explain.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"explain.d.ts","sourceRoot":"","sources":["../src/explain.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAU7B,yEAAyE;AACzE,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,KAAK,CAAC;IAClE,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAED,gDAAgD;AAChD,MAAM,WAAW,oBAAoB,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO;IACvD,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IACnB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3C,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IAClD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC5C;AAmGD;;;;;GAKG;AACH,eAAO,MAAM,aAAa,GAAI,CAAC,SAAS,CAAC,CAAC,OAAO,EAC/C,SAAS,oBAAoB,CAAC,CAAC,CAAC,KAC/B,SAAS,eAAe,EAoC1B,CAAC"}

package/dist/explain.js

@@ -1,101 +0,0 @@
-/**
- * Config provenance — show which source won for each config field.
- *
- * Used for debugging: answers "where did this value come from?"
- */
-import { collectConfigMeta } from './collect.js';
-import { isLikelySecret } from './secret-heuristics.js';
-import { getAtPath, isZodObject, unwrapToBase, zodDef } from './zod-utils.js';
-// ---------------------------------------------------------------------------
-// Helpers (defined before consumers)
-// ---------------------------------------------------------------------------
-/** Build a map of path → env var name from config metadata. */
-const buildEnvMap = (schema) => {
-    const meta = collectConfigMeta(schema);
-    const result = new Map();
-    for (const [path, fieldMeta] of meta) {
-        if (fieldMeta.env) {
-            result.set(path, fieldMeta.env);
-        }
-    }
-    return result;
-};
-/** Build a set of paths marked as secret from config metadata. */
-const buildSecretSet = (schema) => {
-    const meta = collectConfigMeta(schema);
-    const result = new Set();
-    for (const [path, fieldMeta] of meta) {
-        if (fieldMeta.secret) {
-            result.add(path);
-        }
-    }
-    return result;
-};
-/** Determine which source provided the winning value for a given path. */
-const determineSource = (path, resolved, sources, envMap, envVars) => {
-    if (envVars && envMap.has(path)) {
-        const envVar = envMap.get(path);
-        if (envVar && envVars[envVar] !== undefined) {
-            return 'env';
-        }
-    }
-    const resolvedValue = getAtPath(resolved, path);
-    for (const [name, values] of sources) {
-        if (values && getAtPath(values, path) === resolvedValue) {
-            return name;
-        }
-    }
-    return 'default';
-};
-/** Collect all leaf field paths from an object schema. */
-const collectLeafPaths = (schema, prefix) => {
-    const paths = [];
-    const queue = [{ prefix, schema }];
-    for (let entry = queue.pop(); entry; entry = queue.pop()) {
-        const shape = zodDef(entry.schema)['shape'];
-        for (const [key, fieldSchema] of Object.entries(shape)) {
-            const path = entry.prefix ? `${entry.prefix}.${key}` : key;
-            if (isZodObject(fieldSchema)) {
-                queue.push({ prefix: path, schema: unwrapToBase(fieldSchema) });
-            }
-            else {
-                paths.push(path);
-            }
-        }
-    }
-    return paths;
-};
-// ---------------------------------------------------------------------------
-// Public API
-// ---------------------------------------------------------------------------
-/**
- * Show which source won for each config field.
- *
- * Used for debugging — answers "where did this value come from?"
- *
- */
-export const explainConfig = (options) => {
-    const objSchema = options.schema;
-    const envMap = buildEnvMap(objSchema);
-    const secretSet = buildSecretSet(objSchema);
-    const sources = [
-        ['local', options.local],
-        ['loadout', options.loadout],
-        ['base', options.base],
-    ];
-    const paths = collectLeafPaths(objSchema, '');
-    return paths.map((path) => {
-        const source = determineSource(path, options.resolved, sources, envMap, options.env);
-        const envVarName = envMap.get(path);
-        const isSecret = secretSet.has(path) ||
-            (envVarName !== undefined && isLikelySecret(envVarName));
-        const rawValue = getAtPath(options.resolved, path);
-        return {
-            path,
-            redacted: isSecret,
-            source,
-            value: isSecret ? '[REDACTED]' : rawValue,
-        };
-    });
-};
-//# sourceMappingURL=explain.js.map

package/dist/explain.js.map

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

package/dist/extensions.d.ts

@@ -1,38 +0,0 @@
-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 trailheads.
- *
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,35 +0,0 @@
-/**
- * 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 trailheads.
- *
- * 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

@@ -1 +0,0 @@
-{"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

@@ -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 generateEnvExample: (schema: z.ZodObject<Record<string, z.ZodType>>) => string;
-//# sourceMappingURL=env.d.ts.map

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

@@ -1 +0,0 @@
-{"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

@@ -1,65 +0,0 @@
-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

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

package/dist/generate/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 generateExample: (schema: z.ZodObject<Record<string, z.ZodType>>, format: ExampleFormat) => string;
-export {};
-//# sourceMappingURL=example.d.ts.map

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

@@ -1 +0,0 @@
-{"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;AAmM7B,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

@@ -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 generateExample = (schema, format) => formatters[format](schema);
-//# sourceMappingURL=example.js.map

package/dist/generate/example.js.map

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