import type { Profile } from './types.js';
/**
 * Parse a Salesforce Profile XML string into a typed {@link Profile} object.
 *
 * Boolean values (`true`/`false` strings) are automatically converted to
 * native booleans. Array properties are always returned as arrays, even if
 * the XML contains a single element.
 *
 * @param xml - Raw XML string content of a `.profile-meta.xml` file
 * @returns Parsed Profile object
 */
export declare function parseProfileXml(xml: string): Profile;
/**
 * Read a profile XML file from disk and parse it into a {@link Profile} object.
 *
 * @param filePath - Absolute path to the `.profile-meta.xml` file
 * @returns Parsed Profile object
 */
export declare function readProfileXml(filePath: string): Promise<Profile>;
/**
 * Serialize a {@link Profile} object back to Salesforce-compatible XML.
 *
 * Produces well-formed XML with the Metadata API namespace and `<?xml ...?>`
 * declaration. Empty arrays are omitted from output.
 *
 * @param profile - The Profile object to serialize
 * @returns XML string suitable for writing to a `.profile-meta.xml` file
 */
export declare function buildProfileXml(profile: Profile): string;
/**
 * Write a {@link Profile} object to a file as Salesforce-compatible XML.
 *
 * @param filePath - Absolute path to write the `.profile-meta.xml` file
 * @param profile - The Profile object to serialize
 */
export declare function writeProfileXml(filePath: string, profile: Profile): Promise<void>;