/**
 * Backstage catalog-info.yaml → ArchRad IR (organizational topology).
 * Maps Component, Resource, API, System; follows Location targets; skips node_modules / dist / .git.
 */
export declare class BackstageIngestError extends Error {
    constructor(message: string);
}
export type BackstageIngestReport = {
    catalogFilesScanned: number;
    locationsFollowed: number;
    entitiesByKind: Record<string, number>;
    skipped: {
        path: string;
        reason: string;
    }[];
};
/** Walk recursively for `catalog-info.yaml` / `catalog.yaml`, skipping excluded dirs. */
export declare function walkCatalogInfoFiles(rootAbs: string): Promise<string[]>;
/** Resolve Location target relative to the catalog file directory or absolute. */
export declare function resolveLocationTarget(fromCatalogFile: string, target: string): string | null;
export declare function parseEntityRef(ref: string): {
    kind: string;
    namespace: string;
    name: string;
} | null;
/** Expand catalog paths by following Location entities (file targets only). */
export declare function collectCatalogPaths(rootAbs: string, report: BackstageIngestReport): Promise<string[]>;
/**
 * Ingest Backstage YAML catalogs under `catalogRoot` into canonical IR `{ metadata?, graph }`.
 */
export declare function ingestBackstageCatalog(catalogRoot: string): Promise<{
    ir: Record<string, unknown>;
    report: BackstageIngestReport;
}>;
//# sourceMappingURL=backstage.d.ts.map