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

package/src/registry.ts

@@ -2,7 +2,7 @@
  * Module-level config state registry.
  *
  * Config is resolved once at bootstrap (two-phase init per ADR-010) and
- * registered here so `configProvision` can expose it to trailheads. This is
+ * registered here so `configResource` can expose it to surfaces. This is
  * a process-level singleton — config resolution is inherently global.
  */
 import type { z } from 'zod';
@@ -12,7 +12,7 @@ export interface ConfigState {
   readonly schema: z.ZodObject<Record<string, z.ZodType>>;
   readonly resolved: Record<string, unknown>;
   readonly base?: Record<string, unknown>;
-  readonly loadout?: Record<string, unknown>;
+  readonly profile?: Record<string, unknown>;
   readonly local?: Record<string, unknown>;
   readonly env?: Record<string, string | undefined>;
 }

package/src/resolve.ts

@@ -1,11 +1,11 @@
 /**
  * Config resolution engine — merges config from multiple sources through
- * a deterministic stack: defaults → base → loadout → local → env.
+ * a deterministic stack: defaults → base → profile → local → env.
  */
 
 import type { z } from 'zod';
 
-import { Result } from '@ontrails/core';
+import { Result, ValidationError } from '@ontrails/core';
 
 import { collectConfigMeta } from './collect.js';
 import { deepMerge } from './merge.js';
@@ -16,11 +16,11 @@ import { zodDef } from './zod-utils.js';
 // ---------------------------------------------------------------------------
 
 /** Options for resolving config through the full stack. */
-export interface ResolveConfigOptions<T extends z.ZodType> {
+export interface DeriveConfigOptions<T extends z.ZodType> {
   readonly schema: T;
   readonly base?: Record<string, unknown> | undefined;
-  readonly loadouts?: Record<string, Record<string, unknown>> | undefined;
-  readonly loadout?: string | undefined;
+  readonly profiles?: Record<string, Record<string, unknown>> | undefined;
+  readonly profile?: string | undefined;
   readonly localOverrides?: Record<string, unknown> | undefined;
   readonly env?: Record<string, string | undefined> | undefined;
 }
@@ -219,11 +219,11 @@ const applyEnvOverrides = (
 // Merge pipeline
 // ---------------------------------------------------------------------------
 
-/** Apply the layered merge: base → loadout → local overrides. */
+/** Apply the layered merge: base → profile → local overrides. */
 const mergeLayers = (
   base: Record<string, unknown> | undefined,
-  loadouts: Record<string, Record<string, unknown>> | undefined,
-  loadout: string | undefined,
+  profiles: Record<string, Record<string, unknown>> | undefined,
+  profile: string | undefined,
   localOverrides: Record<string, unknown> | undefined
 ): Record<string, unknown> => {
   let merged: Record<string, unknown> = {};
@@ -231,7 +231,7 @@ const mergeLayers = (
     merged = deepMerge(merged, base);
   }
 
-  const selected = loadout && loadouts ? loadouts[loadout] : undefined;
+  const selected = profile && profiles ? profiles[profile] : undefined;
   if (selected) {
     merged = deepMerge(merged, selected);
   }
@@ -253,16 +253,16 @@ const formatValidationError = (
 // ---------------------------------------------------------------------------
 
 /**
- * Resolve config through the full stack: defaults → base → loadout → local → env.
+ * Derive config through the full stack: defaults → base → profile → local → env.
  * Returns `Result.ok` with the validated config, or `Result.err` on validation failure.
  */
-export const resolveConfig = <T extends z.ZodType>(
-  options: ResolveConfigOptions<T>
+export const deriveConfig = <T extends z.ZodType>(
+  options: DeriveConfigOptions<T>
 ): Result<z.infer<T>, Error> => {
   let merged = mergeLayers(
     options.base,
-    options.loadouts,
-    options.loadout,
+    options.profiles,
+    options.profile,
     options.localOverrides
   );
 
@@ -275,5 +275,7 @@ export const resolveConfig = <T extends z.ZodType>(
     return Result.ok(parsed.data as z.infer<T>);
   }
 
-  return Result.err(new Error(formatValidationError(parsed.error.issues)));
+  return Result.err(
+    new ValidationError(formatValidationError(parsed.error.issues))
+  );
 };

package/src/trails/config-check.ts

@@ -7,7 +7,7 @@
 import { Result, trail } from '@ontrails/core';
 import { z } from 'zod';
 
-import { configProvision } from '../config-provision.js';
+import { configResource } from '../config-resource.js';
 import { checkConfig } from '../doctor.js';
 import { deepMerge } from '../merge.js';
 
@@ -33,7 +33,7 @@ const mergeValues = (
 
 export const configCheck = trail('config.check', {
   blaze: (input, ctx) => {
-    const state = configProvision.from(ctx);
+    const state = configResource.from(ctx);
     const effective = mergeValues(state.resolved, input.values);
     const checked = checkConfig(state.schema, effective);
     return Result.ok({
@@ -56,5 +56,5 @@ export const configCheck = trail('config.check', {
   intent: 'read',
   meta: { category: 'infrastructure' },
   output: outputSchema,
-  provisions: [configProvision],
+  resources: [configResource],
 });

package/src/trails/config-describe.ts

@@ -7,8 +7,8 @@
 import { Result, trail } from '@ontrails/core';
 import { z } from 'zod';
 
-import { configProvision } from '../config-provision.js';
-import { describeConfig } from '../describe.js';
+import { configResource } from '../config-resource.js';
+import { deriveConfigFields } from '../derive-fields.js';
 
 const fieldSchema = z.object({
   deprecated: z.string().optional(),
@@ -26,8 +26,8 @@ const outputSchema = z.object({
 
 export const configDescribe = trail('config.describe', {
   blaze: (_input, ctx) => {
-    const state = configProvision.from(ctx);
-    const fields = describeConfig(state.schema);
+    const state = configResource.from(ctx);
+    const fields = deriveConfigFields(state.schema);
     return Result.ok({ fields: [...fields] });
   },
   examples: [
@@ -40,5 +40,5 @@ export const configDescribe = trail('config.describe', {
   intent: 'read',
   meta: { category: 'infrastructure' },
   output: outputSchema,
-  provisions: [configProvision],
+  resources: [configResource],
 });

package/src/trails/config-explain.ts

@@ -7,9 +7,9 @@
 import { Result, trail } from '@ontrails/core';
 import { z } from 'zod';
 
-import { configProvision } from '../config-provision.js';
-import type { ExplainConfigOptions } from '../explain.js';
-import { explainConfig } from '../explain.js';
+import { configResource } from '../config-resource.js';
+import type { DeriveConfigProvenanceOptions } from '../derive-provenance.js';
+import { deriveConfigProvenance } from '../derive-provenance.js';
 import type { ConfigState } from '../registry.js';
 
 const provenanceEntrySchema = z.object({
@@ -34,11 +34,11 @@ const filterByPath = (
       )
     : entries;
 
-/** Build ExplainConfigOptions from ConfigState, omitting undefined source overrides. */
+/** Build DeriveConfigProvenanceOptions from ConfigState, omitting undefined source overrides. */
 const toExplainOptions = (
   state: ConfigState
-): ExplainConfigOptions<typeof state.schema> => {
-  const base: ExplainConfigOptions<typeof state.schema> = {
+): DeriveConfigProvenanceOptions<typeof state.schema> => {
+  const base: DeriveConfigProvenanceOptions<typeof state.schema> = {
     resolved: state.resolved,
     schema: state.schema,
   };
@@ -51,14 +51,14 @@ const toExplainOptions = (
 /** Enrich explain options with env and source overrides from state. */
 const enrichOptions = (
   state: ConfigState,
-  options: ExplainConfigOptions<typeof state.schema>
-): ExplainConfigOptions<typeof state.schema> => {
+  options: DeriveConfigProvenanceOptions<typeof state.schema>
+): DeriveConfigProvenanceOptions<typeof state.schema> => {
   let enriched = options;
   if (state.env) {
     enriched = { ...enriched, env: state.env };
   }
-  if (state.loadout) {
-    enriched = { ...enriched, loadout: state.loadout };
+  if (state.profile) {
+    enriched = { ...enriched, profile: state.profile };
   }
   if (state.local) {
     enriched = { ...enriched, local: state.local };
@@ -68,9 +68,9 @@ const enrichOptions = (
 
 export const configExplain = trail('config.explain', {
   blaze: (input, ctx) => {
-    const state = configProvision.from(ctx);
+    const state = configResource.from(ctx);
     const options = enrichOptions(state, toExplainOptions(state));
-    const entries = explainConfig(options);
+    const entries = deriveConfigProvenance(options);
     const filtered = filterByPath(entries, input.path);
     return Result.ok({ entries: [...filtered] });
   },
@@ -89,5 +89,5 @@ export const configExplain = trail('config.explain', {
   intent: 'read',
   meta: { category: 'infrastructure' },
   output: outputSchema,
-  provisions: [configProvision],
+  resources: [configResource],
 });

package/src/trails/config-init.ts

@@ -14,12 +14,12 @@ import { Result, trail } from '@ontrails/core';
 import type { z } from 'zod';
 import { z as zod } from 'zod';
 
-import { configProvision } from '../config-provision.js';
+import { configResource } from '../config-resource.js';
 import {
-  generateEnvExample,
-  generateExample,
-  generateJsonSchema,
-} from '../generate/index.js';
+  deriveConfigEnvExample,
+  deriveConfigExample,
+  deriveConfigJsonSchema,
+} from '../derive/index.js';
 
 const formatEnum = zod.enum(['toml', 'json', 'jsonc', 'yaml']);
 
@@ -34,13 +34,13 @@ const collectArtifacts = (
   schema: z.ZodObject<Record<string, z.ZodType>>
 ): [string, string][] => {
   const artifacts: [string, string][] = [];
-  const envContent = generateEnvExample(schema);
+  const envContent = deriveConfigEnvExample(schema);
   if (envContent.length > 0) {
     artifacts.push(['.env.example', envContent]);
   }
   artifacts.push([
     '.schema.json',
-    JSON.stringify(generateJsonSchema(schema), null, 2),
+    JSON.stringify(deriveConfigJsonSchema(schema), null, 2),
   ]);
   return artifacts;
 };
@@ -63,9 +63,9 @@ const writeArtifacts = async (
 
 export const configInit = trail('config.init', {
   blaze: async (input, ctx) => {
-    const state = configProvision.from(ctx);
+    const state = configResource.from(ctx);
     const schema = state.schema as z.ZodObject<Record<string, z.ZodType>>;
-    const content = generateExample(schema, input.format);
+    const content = deriveConfigExample(schema, input.format);
 
     if (input.dir) {
       const writtenFiles = await writeArtifacts(input.dir, schema);
@@ -92,5 +92,5 @@ export const configInit = trail('config.init', {
   intent: 'write',
   meta: { category: 'infrastructure' },
   output: outputSchema,
-  provisions: [configProvision],
+  resources: [configResource],
 });

package/.turbo/turbo-build.log

@@ -1 +0,0 @@
-$ tsc -b

package/.turbo/turbo-lint.log

@@ -1,3 +0,0 @@
-$ oxlint ./src
-Found 0 warnings and 0 errors.
-Finished in 51ms on 44 files with 93 rules using 24 threads.

package/.turbo/turbo-typecheck.log

@@ -1 +0,0 @@
-$ tsc --noEmit

package/dist/app-config.d.ts

@@ -1,65 +0,0 @@
-/**
- * App config factory — declare a config contract once, discover and validate at runtime.
- */
-import { Result } from '@ontrails/core';
-import type { z } from 'zod';
-import type { CheckResult } from './doctor.js';
-import type { FieldDescription } from './describe.js';
-import type { ExplainConfigOptions, ProvenanceEntry } from './explain.js';
-import type { ConfigRef } from './ref.js';
-/** Supported config file formats. */
-export type ConfigFormat = 'toml' | 'json' | 'jsonc' | 'yaml';
-/** Options for creating an app config. */
-export interface AppConfigOptions<T extends z.ZodType> {
-    readonly schema: T;
-    readonly formats?: readonly ConfigFormat[];
-    readonly dotfile?: boolean;
-}
-/** Options for resolving (discovering + parsing) a config file. */
-export interface ResolveOptions {
-    /** Working directory for discovery. Defaults to `process.cwd()`. */
-    readonly cwd?: string;
-    /** Explicit file path — skips discovery when provided. */
-    readonly path?: string;
-}
-/** Options for the `explain()` method on AppConfig, excluding schema. */
-export type AppConfigExplainOptions = Omit<ExplainConfigOptions<z.ZodType>, 'schema'>;
-/** The resolved config contract returned by `appConfig()`. */
-export interface AppConfig<T extends z.ZodType> {
-    readonly name: string;
-    readonly schema: T;
-    readonly formats: readonly ConfigFormat[];
-    readonly dotfile: boolean;
-    resolve(options?: ResolveOptions): Promise<Result<z.infer<T>, Error>>;
-    /** Describe all fields in the schema without needing values. */
-    describe(): readonly FieldDescription[];
-    /** Check a config object against the schema and return diagnostics. */
-    check(values: Record<string, unknown>, options?: {
-        readonly env?: Record<string, string | undefined>;
-    }): CheckResult;
-    /** Show which source won for each config field. */
-    explain(options: AppConfigExplainOptions): readonly ProvenanceEntry[];
-    /** Create a lazy reference to a config field for use as a trail input default. */
-    ref(fieldPath: string): ConfigRef;
-}
-/**
- * Declare a config contract for an app.
- *
- * The returned `AppConfig` exposes `resolve()` to discover, parse, and validate
- * a config file matching the app name and format conventions.
- *
- * @example
- * ```ts
- * const config = appConfig('myapp', {
- *   schema: z.object({
- *     output: z.string().default('./output'),
- *     verbose: z.boolean().default(false),
- *   }),
- * });
- *
- * const result = await config.resolve();
- * if (result.isOk()) console.log(result.value.output);
- * ```
- */
-export declare const appConfig: <T extends z.ZodType>(name: string, options: AppConfigOptions<T>) => AppConfig<T>;
-//# sourceMappingURL=app-config.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"app-config.d.ts","sourceRoot":"","sources":["../src/app-config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAiB,MAAM,EAAmB,MAAM,gBAAgB,CAAC;AACxE,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEtD,OAAO,KAAK,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE1E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAO1C,qCAAqC;AACrC,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;AAE9D,0CAA0C;AAC1C,MAAM,WAAW,gBAAgB,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO;IACnD,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IACnB,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,YAAY,EAAE,CAAC;IAC3C,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,mEAAmE;AACnE,MAAM,WAAW,cAAc;IAC7B,oEAAoE;IACpE,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,0DAA0D;IAC1D,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,yEAAyE;AACzE,MAAM,MAAM,uBAAuB,GAAG,IAAI,CACxC,oBAAoB,CAAC,CAAC,CAAC,OAAO,CAAC,EAC/B,QAAQ,CACT,CAAC;AAEF,8DAA8D;AAC9D,MAAM,WAAW,SAAS,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO;IAC5C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IACnB,QAAQ,CAAC,OAAO,EAAE,SAAS,YAAY,EAAE,CAAC;IAC1C,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,OAAO,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;IAEtE,gEAAgE;IAChE,QAAQ,IAAI,SAAS,gBAAgB,EAAE,CAAC;IAExC,uEAAuE;IACvE,KAAK,CACH,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAA;KAAE,GAC9D,WAAW,CAAC;IAEf,mDAAmD;IACnD,OAAO,CAAC,OAAO,EAAE,uBAAuB,GAAG,SAAS,eAAe,EAAE,CAAC;IAEtE,kFAAkF;IAClF,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;CACnC;AAmMD;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,SAAS,GAAI,CAAC,SAAS,CAAC,CAAC,OAAO,EAC3C,MAAM,MAAM,EACZ,SAAS,gBAAgB,CAAC,CAAC,CAAC,KAC3B,SAAS,CAAC,CAAC,CAqBb,CAAC"}

package/dist/app-config.js

@@ -1,172 +0,0 @@
-/**
- * App config factory — declare a config contract once, discover and validate at runtime.
- */
-import { dirname, join } from 'node:path';
-import { NotFoundError, Result, ValidationError } from '@ontrails/core';
-import { checkConfig } from './doctor.js';
-import { describeConfig } from './describe.js';
-import { explainConfig } from './explain.js';
-import { configRef } from './ref.js';
-// ---------------------------------------------------------------------------
-// Default values
-// ---------------------------------------------------------------------------
-const DEFAULT_FORMATS = ['toml', 'json', 'yaml'];
-// ---------------------------------------------------------------------------
-// Internal helpers (defined before consumers — no-use-before-define)
-// ---------------------------------------------------------------------------
-/** Build the config filename for a given format. */
-const configFileName = (name, format, dotfile) => (dotfile ? `.${name}rc.${format}` : `${name}.config.${format}`);
-/** Check whether a file exists at the given path. */
-const fileExists = (filePath) => Bun.file(filePath).exists();
-/** Known config suffixes, ordered to avoid `.json` matching `.jsonc`. */
-const FORMAT_SUFFIXES = [
-    ['jsonc', '.jsonc'],
-    ['json', '.json'],
-    ['toml', '.toml'],
-    ['yaml', '.yaml'],
-];
-/** Detect the declared config format from a file path. */
-const detectFormat = (filePath) => {
-    for (const [format, suffix] of FORMAT_SUFFIXES) {
-        if (filePath.endsWith(suffix)) {
-            return format;
-        }
-    }
-    return undefined;
-};
-/** Parse config file text with Bun's native format parsers. */
-const parseConfigText = (filePath, text) => {
-    const format = detectFormat(filePath);
-    try {
-        switch (format) {
-            case 'json': {
-                return Result.ok(JSON.parse(text));
-            }
-            case 'jsonc': {
-                return Result.ok(Bun.JSONC.parse(text));
-            }
-            case 'toml': {
-                return Result.ok(Bun.TOML.parse(text));
-            }
-            case 'yaml': {
-                return Result.ok(Bun.YAML.parse(text));
-            }
-            default: {
-                return Result.err(new ValidationError(`Unsupported config file format: ${filePath}`, {
-                    context: { path: filePath },
-                }));
-            }
-        }
-    }
-    catch (error) {
-        return Result.err(new ValidationError(`Failed to parse config file: ${filePath}`, {
-            cause: error instanceof Error ? error : new Error(String(error)),
-            context: { path: filePath },
-        }));
-    }
-};
-/** Read and parse a config file, always reflecting the latest on-disk content. */
-const readConfigFile = async (filePath) => {
-    const exists = await fileExists(filePath);
-    if (!exists) {
-        return Result.err(new NotFoundError(`Config file not found: ${filePath}`, {
-            context: { path: filePath },
-        }));
-    }
-    const text = await Bun.file(filePath).text();
-    return parseConfigText(filePath, text);
-};
-/** Validate parsed data against a Zod schema. */
-const validateConfig = (schema, data, filePath) => {
-    const parsed = schema.safeParse(data);
-    if (parsed.success) {
-        return Result.ok(parsed.data);
-    }
-    return Result.err(new ValidationError(`Config validation failed: ${filePath}`, {
-        context: {
-            issues: parsed.error.issues,
-            path: filePath,
-        },
-    }));
-};
-/** Check all format candidates in a single directory. */
-const findInDir = async (dir, name, formats, dotfile) => {
-    for (const format of formats) {
-        const candidate = join(dir, configFileName(name, format, dotfile));
-        if (await fileExists(candidate)) {
-            return candidate;
-        }
-    }
-    return undefined;
-};
-/** Walk up from `startDir` looking for any matching config filename. */
-const discoverConfigFile = async (name, formats, dotfile, startDir) => {
-    let dir = startDir;
-    for (let depth = 0; depth < 64; depth += 1) {
-        const found = await findInDir(dir, name, formats, dotfile);
-        if (found !== undefined) {
-            return found;
-        }
-        const parent = dirname(dir);
-        // Reached filesystem root
-        if (parent === dir) {
-            break;
-        }
-        dir = parent;
-    }
-    return undefined;
-};
-/** Resolve a config file — either from an explicit path or via discovery. */
-const resolveConfig = async (name, schema, formats, dotfile, options) => {
-    const filePath = options?.path ??
-        (await discoverConfigFile(name, formats, dotfile, options?.cwd ?? process.cwd()));
-    if (filePath === undefined) {
-        return Result.err(new NotFoundError(`No config file found for "${name}"`, {
-            context: { dotfile, formats: [...formats], name },
-        }));
-    }
-    const readResult = await readConfigFile(filePath);
-    if (readResult.isErr()) {
-        return readResult;
-    }
-    return validateConfig(schema, readResult.value, filePath);
-};
-// ---------------------------------------------------------------------------
-// Factory
-// ---------------------------------------------------------------------------
-/**
- * Declare a config contract for an app.
- *
- * The returned `AppConfig` exposes `resolve()` to discover, parse, and validate
- * a config file matching the app name and format conventions.
- *
- * @example
- * ```ts
- * const config = appConfig('myapp', {
- *   schema: z.object({
- *     output: z.string().default('./output'),
- *     verbose: z.boolean().default(false),
- *   }),
- * });
- *
- * const result = await config.resolve();
- * if (result.isOk()) console.log(result.value.output);
- * ```
- */
-export const appConfig = (name, options) => {
-    const formats = options.formats ?? DEFAULT_FORMATS;
-    const dotfile = options.dotfile ?? false;
-    const { schema } = options;
-    return {
-        check: (values, checkOpts) => checkConfig(schema, values, checkOpts),
-        describe: () => describeConfig(schema),
-        dotfile,
-        explain: (explainOpts) => explainConfig({ ...explainOpts, schema }),
-        formats,
-        name,
-        ref: (fieldPath) => configRef(fieldPath),
-        resolve: (resolveOptions) => resolveConfig(name, schema, formats, dotfile, resolveOptions),
-        schema,
-    };
-};
-//# sourceMappingURL=app-config.js.map

package/dist/app-config.js.map

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

package/dist/collect.d.ts

@@ -1,11 +0,0 @@
-import type { z } from 'zod';
-import type { ConfigFieldMeta } from './extensions.js';
-/**
- * Walk a Zod object schema and collect `ConfigFieldMeta` for each field.
- *
- * Handles unwrapping `.default()`, `.optional()`, `.nullable()` wrappers
- * that don't carry inner metadata forward. Recurses into nested `ZodObject`
- * fields using dot-separated paths.
- */
-export declare const collectConfigMeta: (schema: z.ZodObject<Record<string, z.ZodType>>, prefix?: string) => Map<string, ConfigFieldMeta>;
-//# sourceMappingURL=collect.d.ts.map

package/dist/collect.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"collect.d.ts","sourceRoot":"","sources":["../src/collect.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AA+FvD;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,GAC5B,QAAQ,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,EAC9C,eAAW,KACV,GAAG,CAAC,MAAM,EAAE,eAAe,CAS7B,CAAC"}

package/dist/collect.js

@@ -1,81 +0,0 @@
-import { globalRegistry } from 'zod';
-import { isZodObject, unwrapToBase } from './zod-utils.js';
-/** Config meta keys we look for in Zod registry entries. */
-const META_EXTRACTORS = [
-    {
-        extract: (r) => ({ env: r['env'] }),
-        test: (r) => typeof r['env'] === 'string',
-    },
-    {
-        extract: () => ({ secret: true }),
-        test: (r) => r['secret'] === true,
-    },
-    {
-        extract: (r) => ({ deprecated: r['deprecationMessage'] }),
-        test: (r) => typeof r['deprecationMessage'] === 'string',
-    },
-];
-/**
- * Pick only `ConfigFieldMeta` keys from a raw registry entry.
- * Uses a lookup table to stay under the max-statements limit.
- */
-const pickConfigMeta = (raw) => {
-    if (!raw) {
-        return undefined;
-    }
-    const parts = META_EXTRACTORS.filter((e) => e.test(raw)).map((e) => e.extract(raw));
-    return parts.length > 0
-        ? Object.assign({}, ...parts)
-        : undefined;
-};
-/**
- * Extract `ConfigFieldMeta` from a schema, unwrapping through
- * `.default()`, `.optional()`, `.nullable()` wrappers as needed.
- */
-const extractConfigMeta = (schema) => {
-    let current = schema;
-    while (current) {
-        const meta = pickConfigMeta(globalRegistry.get(current));
-        if (meta) {
-            return meta;
-        }
-        const def = current.def;
-        current = def['innerType'];
-    }
-    return undefined;
-};
-/** Process one level of an object schema, queuing nested objects. */
-const walkObjectShape = (schema, prefix, result, queue) => {
-    const shape = schema.shape;
-    for (const [key, fieldSchema] of Object.entries(shape)) {
-        const path = prefix ? `${prefix}.${key}` : key;
-        if (isZodObject(fieldSchema)) {
-            queue.push({
-                prefix: path,
-                schema: unwrapToBase(fieldSchema),
-            });
-        }
-        else {
-            const meta = extractConfigMeta(fieldSchema);
-            if (meta) {
-                result.set(path, meta);
-            }
-        }
-    }
-};
-/**
- * Walk a Zod object schema and collect `ConfigFieldMeta` for each field.
- *
- * Handles unwrapping `.default()`, `.optional()`, `.nullable()` wrappers
- * that don't carry inner metadata forward. Recurses into nested `ZodObject`
- * fields using dot-separated paths.
- */
-export const collectConfigMeta = (schema, prefix = '') => {
-    const result = new Map();
-    const queue = [{ prefix, schema }];
-    for (let entry = queue.pop(); entry; entry = queue.pop()) {
-        walkObjectShape(entry.schema, entry.prefix, result, queue);
-    }
-    return result;
-};
-//# sourceMappingURL=collect.js.map

package/dist/collect.js.map

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