/** A Figma file key + node id, the two coordinates every REST call needs. */
export interface FigmaRef {
    fileKey: string;
    /** Canonical form with a colon, e.g. `"1:42"` (URLs use `1-42`). */
    nodeId: string;
}
/**
 * Parse a design-map `ref` or a figma.com URL into a {@link FigmaRef}.
 *
 * Accepts:
 * - `figma:<fileKey>/<nodeId>` (our manifest form), nodeId as `1:42` or `1-42`
 * - `https://www.figma.com/design/<fileKey>/<name>?node-id=<1-42>`
 * - `https://www.figma.com/file/<fileKey>/...?node-id=<1-42>`
 *
 * @throws {FigmaBadRefError} if neither shape matches.
 */
export declare function parseFigmaRef(ref: string): FigmaRef;
/** Whether a `ref` is a Figma handle this adapter can parse without Code Connect. */
export declare function isFigmaRef(ref: string): boolean;
/** Format a {@link FigmaRef} back into the manifest `figma:<key>/<node>` form. */
export declare function formatFigmaRef({ fileKey, nodeId }: FigmaRef): string;
//# sourceMappingURL=figma-ref.d.ts.map