import ParserOptions from './parser-options.js';
import IODefinitions from '../core/definitions.js';
import '../schema/schema.js';
import '../schema/types/memberdef.js';
import '../schema/schema-types.js';

/**
 * Parses a string containing schema, variable, or metadata definitions.
 * Returns a Definitions object containing the parsed definitions.
 *
 * Useful for pre-loading schemas that will be used across multiple documents.
 *
 * @param source - The definition string (e.g., `~ $Person: { name: string }`).
 * @param externalDefs - Optional base definitions to extend/inherit from.
 * @param options - Parser options.
 * @returns The parsed Definitions object, or null if input is empty.
 *
 * @example
 * ```typescript
 * const defs = parseDefinitions(`
 *   ~ $Person: { name: string, age: int }
 *   ~ @baseUrl: https://api.example.com
 * `);
 * const schema = defs.get('$Person');
 * ```
 */
declare function parseDefinitions(source: string): IODefinitions | null;
declare function parseDefinitions(source: string, externalDefs: IODefinitions | null, options?: ParserOptions): IODefinitions | null;
declare function parseDefinitions(source: string, options?: ParserOptions): IODefinitions | null;

export { parseDefinitions as default };