/**
 * Converts mapped entity values to and from normalized Sheet cells.
 *
 * Custom codecs are accepted at this boundary, but every result is still
 * checked against the declared normalized-cell contract before persistence.
 */
import type { NormalizedCell } from "../../encoding/types.js";
import type { TypedSheetsEntityFieldMapping, TypedSheetsEntityMapping } from "./contracts.js";
/** Encodes every mapped entity property into its canonical normalized-cell value. */
export declare function encodeTypedSheetsEntity(mapping: TypedSheetsEntityMapping, entity: object): Readonly<Record<string, NormalizedCell>>;
/** Encodes a complete provider-neutral entity row without requiring a managed object. */
export declare function encodeTypedSheetsEntityValues(mapping: TypedSheetsEntityMapping, values: Readonly<Record<string, unknown>>): Readonly<Record<string, NormalizedCell>>;
/** Encodes one mapped property while enforcing its declared normalized-cell contract. */
export declare function encodeTypedSheetsEntityField(mapping: TypedSheetsEntityMapping, field: TypedSheetsEntityFieldMapping, value: unknown): NormalizedCell;
/** Decodes one accepted canonical cell into the mapped application property value. */
export declare function decodeTypedSheetsEntityField(mapping: TypedSheetsEntityMapping, field: TypedSheetsEntityFieldMapping, value: NormalizedCell): unknown;
/** Finds the field declaration for one canonical field name or fails closed. */
export declare function requireTypedSheetsEntityField(mapping: TypedSheetsEntityMapping, fieldName: string): TypedSheetsEntityFieldMapping;
//# sourceMappingURL=values.d.ts.map