import type { Element } from 'xml-js';
import type { XMLDocument } from '@xml-tools/ast';
import type { MacrosXMLPath, ExtensionLogger, FileData, SchemaDefinition } from '@sap/ux-specification-types';
export interface TraverseData<T = {}> {
    fullSchema: SchemaDefinition;
    schema: SchemaDefinition;
    element: Element;
    contextPath: MacrosXMLPath;
    config: object;
    /** Indicates if all properties of an element were removed during traversal. */
    removed?: boolean;
    /** Reference to the parent traversal data. */
    parent?: TraverseData<T>;
    /** Reference to the parent XML element. */
    parentElement?: Element;
    /** Custom data for traversal. */
    data?: T;
}
export type TraverseCallback<T = {}> = (traverseData: TraverseData<T>, property: SchemaDefinition, config: object, name: string) => boolean;
/**
 * Method traverses schema together with XML element.
 *
 * @param {TraverseData} traverseData Traverse data object.
 * @param {TraverseCallback} callback Callbck to handle export or import.
 * @param {TraverseCallback} [onElementDeleteCallback]  - Callback invoked when an element is deleted during traversal.
 * @returns {boolean} Is changes applied during export or import.
 */
export declare function traverseSchema<T = {}>(traverseData: TraverseData<T>, callback: TraverseCallback<T>, onElementDeleteCallback?: TraverseCallback<T>): boolean;
/**
 * Method parses XML file and returns parsed object.
 *
 * @param {FileData} xmlFile XML file.
 * @param {boolean} providePositions - If true then parsing result will contain information about elements and attributes positions.
 * @param {ExtensionLogger} [logger] - Logger class for logging messages.
 * @returns {Element | undefined} Parsed XML.
 */
export declare function parseXML(xmlFile: FileData, providePositions: true, logger?: ExtensionLogger): XMLDocument | undefined;
export declare function parseXML(xmlFile: FileData, providePositions: false, logger?: ExtensionLogger): Element | undefined;
/**
 * Resolves definition key for custom extension fragment.
 *
 * @param {string} fragmentName Name of the fragment.
 * @returns {string} Definition key for custom extension fragment.
 */
export declare function getCustomExtensionFragmentDefinitionKey(fragmentName: string): string;
/**
 * Method find first renderable element for passed definition element.
 *
 * @param element Definition element.
 * @returns First renderable element.
 */
export declare function getRootElement(element?: Element): Element | undefined;
/**
 * Builds a namespace URI → prefix map from xmlns attribute entries.
 * Works with any source that provides [attributeName, value] pairs — both
 * xml-js Element (via Object.entries) and @xml-tools/ast XMLElement (via .map).
 *
 * @param {[string, string][]} entries Attribute key/value pairs to scan.
 * @returns {Record<string, string>} Map of namespace URI → prefix (empty string for default xmlns).
 */
export declare function getXmlnsDependencies(entries: [string, string][]): Record<string, string>;
/**
 * Finds a child element whose local name (after the namespace prefix) matches {@link localName}
 * and whose `key` attribute matches {@link keyValue}.
 *
 * @param parent Parent XML element whose children are searched.
 * @param localName Local element name without namespace prefix (e.g. `"ColumnOverride"`).
 * @param keyValue Expected value of the child element's `key` attribute.
 * @returns The matching child element, or `undefined` if not found.
 */
export declare function findChildElementByLocalNameAndKey(parent: Element, localName: string, keyValue: string): Element | undefined;
//# sourceMappingURL=macros.d.ts.map