import type { Result } from "./result";
import type { PerseusItem, PerseusArticle, PerseusRenderer } from "../data-schema";
import type { UserInputMap } from "../validation.types";
export type ParseFailureDetail = {
    /**
     * A human-readable error message describing where in the object tree
     * parsing failed.
     */
    message: string;
    /**
     * The raw result of parsing the input JSON, with no migrations applied.
     * Use at your own risk.
     */
    invalidObject: unknown;
};
/**
 * Parses a PerseusItem from a plain object or JSON string, migrates old
 * formats to the latest schema, and runtime-typechecks the result. Use this to
 * parse assessmentItem data.
 *
 * @returns a {@link Result} of the parsed PerseusItem. If the result is a
 * failure, it will contain an error message describing where in the tree
 * parsing failed.
 * @throws SyntaxError if the argument is not well-formed JSON.
 */
export declare function parseAndMigratePerseusItem(data: unknown): Result<PerseusItem, ParseFailureDetail>;
/**
 * Parses a PerseusArticle from a plain object (or array) or JSON string,
 * migrates old formats to the latest schema, and runtime-typechecks the
 * result.
 *
 * @returns a {@link Result} of the parsed PerseusArticle. If the result is a
 * failure, it will contain an error message describing where in the tree
 * parsing failed.
 * @throws SyntaxError if the argument is not well-formed JSON.
 */
export declare function parseAndMigratePerseusArticle(data: unknown): Result<PerseusArticle, ParseFailureDetail>;
/**
 * Parses a UserInputMap from a plain object or JSON string, migrates old
 * formats to the latest schema, and runtime-typechecks the result.
 *
 * @returns a {@link Result} of the parsed UserInputMap. If the result is a
 * failure, it will contain an error message describing where in the tree
 * parsing failed.
 * @throws SyntaxError if the argument is a string that is not well-formed
 * JSON.
 */
export declare function parseAndMigrateUserInputMap(data: unknown): Result<UserInputMap, ParseFailureDetail>;
/**
 * Parses a PerseusRenderer from a plain object or JSON string, migrates old
 * formats to the latest schema, and runtime-typechecks the result.
 *
 * @returns a {@link Result} of the parsed PerseusRenderer. If the result is a
 * failure, it will contain an error message describing where in the tree
 * parsing failed.
 * @throws SyntaxError if the argument is a string that is not well-formed
 * JSON.
 */
export declare function parseAndMigratePerseusRenderer(data: unknown): Result<PerseusRenderer, ParseFailureDetail>;