/**
 * Type-only structural shapes for the v0.3 Code Paths panel.
 *
 * The graph engine's catalog.json is consumed here purely by JSON shape;
 * this file MUST NOT import from `@opensip-cli/graph`. The shape is
 * intentionally duplicated as readonly structural types — this decouples
 * the dashboard panel from the graph engine's runtime types so
 * @opensip-cli/contracts stays a pure type-only kernel boundary.
 *
 * Runtime exports are forbidden. Only `export type` and `export interface`.
 */
export type GraphFunctionKind = 'function-declaration' | 'function-expression' | 'arrow' | 'method' | 'constructor' | 'getter' | 'setter' | 'module-init';
export type GraphCallResolution = 'static' | 'method-dispatch' | 'jsx' | 'constructor' | 'unknown' | 'dynamic-string'
/** Fast-mode (syntactic) edge: resolved from name + import graph, no
 *  type checker. Always approximate — carries capped confidence. */
 | 'syntactic'
/** Cross-shard boundary edge recovered by the semantic linker: the import
 *  specifier + callee name resolved to a UNIQUE exported occurrence in the
 *  imported package (the type checker's conclusion). High-confidence; the
 *  linker declines on ambiguity rather than guessing. */
 | 'semantic';
export type GraphCallConfidence = 'high' | 'medium' | 'low';
/** Mirror of the engine's `ResolutionMode`. `exact` = semantic;
 *  `fast` = syntactic (approximate). Kept structurally in sync. */
export type GraphResolutionMode = 'exact' | 'fast';
export type GraphVisibility = 'exported' | 'module-local' | 'private';
export interface GraphParam {
    readonly name: string;
    readonly optional: boolean;
    readonly rest: boolean;
}
export interface GraphCallEdge {
    readonly to: readonly string[];
    readonly line: number;
    readonly column: number;
    readonly resolution: GraphCallResolution;
    readonly confidence: GraphCallConfidence;
    readonly text: string;
    /** True for an edge recovered by the cross-shard boundary pass (always
     *  syntactic). Mirrors the engine `CallEdge.crossShard`. */
    readonly crossShard?: boolean;
}
export interface GraphFunctionOccurrence {
    readonly bodyHash: string;
    readonly simpleName: string;
    readonly qualifiedName: string;
    readonly filePath: string;
    /**
     * The package this occurrence belongs to — the `name` of its nearest
     * enclosing `package.json` (e.g. `@opensip-cli/fitness`), or the
     * top-level path segment when there is no manifest. Computed at build
     * time (the dashboard has no filesystem access). Absent on legacy
     * catalogs; consumers fall back to deriving it from `filePath`.
     */
    readonly package?: string;
    readonly line: number;
    readonly column: number;
    readonly endLine: number;
    readonly kind: GraphFunctionKind;
    readonly params: readonly GraphParam[];
    readonly returnType: string | null;
    readonly enclosingClass: string | null;
    readonly decorators: readonly string[];
    readonly visibility: GraphVisibility;
    readonly inTestFile: boolean;
    readonly definedInGenerated: boolean;
    readonly calls: readonly GraphCallEdge[];
}
/** Mirror of the engine `BlastScore`. */
export interface GraphBlastScore {
    readonly direct: number;
    readonly transitive: number;
    readonly score: number;
}
/** Mirror of the engine `FunctionFeatures` (per-function columns). */
export interface GraphFunctionFeatures {
    readonly bodyLines: number;
    readonly blast?: GraphBlastScore;
    readonly reachableFromEntry?: boolean;
    readonly testReachable?: boolean;
    readonly reachableOnlyFromTests?: boolean;
}
/** Mirror of the engine `PackageFeatures` (per-package coupling degrees). */
export interface GraphPackageFeatures {
    readonly couplingOut: number;
    readonly couplingIn: number;
}
/** Mirror of the engine `SccFeatures` (one strongly-connected component). */
export interface GraphSccFeatures {
    readonly id: string;
    readonly members: readonly string[];
    readonly sccSize: number;
    readonly crossesPackages: boolean;
}
/** Mirror of the engine `PackageEdgeFeature` (one directed coupling edge). */
export interface GraphPackageEdgeFeature {
    readonly callerPackage: string;
    readonly calleePackage: string;
    readonly count: number;
}
/**
 * Structural mirror of the engine `PersistedFeatures`. Every entity is
 * optional — only the columns a dashboard-bound run materialized are present.
 * The dashboard reads these instead of recomputing blast / SCC / coupling
 * client-side.
 */
export interface GraphFeatures {
    readonly function?: Readonly<Record<string, GraphFunctionFeatures>>;
    readonly package?: Readonly<Record<string, GraphPackageFeatures>>;
    readonly scc?: readonly GraphSccFeatures[];
    readonly edge?: readonly GraphPackageEdgeFeature[];
}
/**
 * Public catalog shape consumed by the dashboard.
 *
 * The `language` field carries the adapter id (e.g. 'typescript', 'python',
 * 'rust') and `cacheKey` is an opaque per-adapter invalidation string. Legacy
 * catalog payloads classify as `invalid` at load time.
 *
 * `cacheKey` is optional here because external callers parsing
 * an older catalog they have on disk would otherwise fail to load the file with
 * this type. Engine-internal code requires it.
 */
export interface GraphCatalog {
    readonly version: string;
    readonly tool: string;
    readonly language: string;
    readonly builtAt: string;
    readonly cacheKey?: string;
    readonly filesFingerprint?: string;
    /** The resolution tier that produced this catalog. Absent ⇒ `'exact'`
     *  (historical behavior). Mirrors the engine `Catalog.resolutionMode`. */
    readonly resolutionMode?: GraphResolutionMode;
    readonly functions: Readonly<Record<string, readonly GraphFunctionOccurrence[]>>;
    /**
     * Derived feature columns (blast / SCC / package coupling). Present only on
     * catalogs produced by a dashboard-bound run (ADR-0006); the dashboard falls
     * back to a no-data state when absent. Mirrors the engine
     * `Catalog.features` so `loadCatalogContract` stays a cast-free widening.
     */
    readonly features?: GraphFeatures;
}
//# sourceMappingURL=graph-catalog.d.ts.map