import type { OpenAPIV3_1 } from 'openapi-types';
type SchemaObject = OpenAPIV3_1.SchemaObject;
type ReferenceObject = OpenAPIV3_1.ReferenceObject;
/**
 * A ref is "top-level" (a component schema) only when it has the exact shape
 * `#/components/schemas/{name}` with a single trailing segment. Those names are
 * emitted as named type declarations, so they can be referenced directly.
 *
 * Anything deeper is a "deep ref": path-based refs
 * (`#/paths/.../schema/properties/x`), nested properties of a component
 * (`#/components/schemas/Database/properties/allow_list`), array items, or
 * `$defs`/`definitions` reached by pointer. Their target types are never
 * emitted as named declarations, so a deep ref must be resolved and inlined
 * rather than referenced by its (non-existent) last-segment name.
 */
export declare function isDeepRef(ref: string): boolean;
/**
 * Resolve an internal JSON pointer ($ref starting with '#/') against the spec.
 * Returns the target schema or reference object, or undefined when the pointer
 * does not resolve. Segments are URI-fragment decoded and JSON-pointer
 * unescaped (`~1` -> '/', `~0` -> '~') per RFC 6901.
 */
export declare function resolveJsonPointer(spec: OpenAPIV3_1.Document, ref: string): SchemaObject | ReferenceObject | undefined;
export {};
//# sourceMappingURL=ref-resolver.d.ts.map