/**
 * Field metadata normalization utilities
 *
 * These functions convert consumer-facing input formats to canonical internal format.
 * Handles both legacy (hidden, dataOk) and preferred (visibility, data_ok) formats.
 */
import type { FieldMetadata, FieldMetadataInput, NormalizedFieldMetadata } from './types.js';
/**
 * Log a development-mode warning
 * Only logs in development, silent in production
 */
export declare function dev_warning(message: string, details?: Record<string, unknown>): void;
/**
 * Normalize field metadata input to canonical format
 *
 * Converts alternative naming conventions to preferred format:
 *
 * - `hidden: true` → `visibility: 'hidden'`
 * - `hidden: false` → `visibility: 'visible'`
 * - `dataOk: value` → `data_ok: value`
 *
 * @param input - Field metadata in any supported format
 * @returns Normalized metadata with canonical property names
 *
 * @example
 * ```ts
 * normalize_field_metadata_input({ hidden: true, dataOk: 'ok' })
 * // => { visibility: 'hidden', data_ok: 'ok' }
 *
 * normalize_field_metadata_input({ visibility: 'visible', data_ok: false })
 * // => { visibility: 'visible', data_ok: false }
 * ```
 */
export declare function normalize_field_metadata_input(input: FieldMetadataInput): NormalizedFieldMetadata;
/**
 * Normalize field metadata from consumer input to internal format
 *
 * This is the full normalization that preserves all properties.
 * Use this when you need the complete FieldMetadata object.
 *
 * @param input - Field metadata in any supported format
 * @returns Normalized FieldMetadata with canonical property names
 */
export declare function normalize_field_metadata(input: FieldMetadataInput): FieldMetadata;
/**
 * Normalize a record of field metadata
 * Applies normalize_field_metadata to each entry
 *
 * @param input - Record of field metadata keyed by field ID
 * @returns Record with all values normalized
 */
export declare function normalize_field_metadata_record(input: Record<string, FieldMetadataInput>): Record<string, FieldMetadata>;
//# sourceMappingURL=normalize.d.ts.map