/**
 * Figma 주소 문자열에서 MCP 조회에 필요한 file key와 node id를 추출하는 helper 모음이다.
 * `/gen-html` 같은 Figma 기반 명령이 URL 전체 대신 안정적인 node id를 프롬프트에 주입할 수 있게 돕는다.
 */
/**
 * Figma 주소 파싱 결과다.
 * URL 기반 입력과 node id 단독 입력을 같은 구조로 다루기 위해 메타데이터를 한곳에 모은다.
 */
export type ParsedFigmaAddress = {
    /**
     * URL에 branch key가 포함돼 있으면 보관한다.
     */
    branchKey?: string;
    /**
     * URL path에서 읽은 원본 file key다.
     */
    fileKey?: string;
    /**
     * URL query나 직접 입력에서 읽은 원본 node id 문자열이다.
     */
    nodeId?: string;
    /**
     * 사용자가 입력한 원본 주소다.
     */
    originalAddress: string;
    /**
     * 파싱 중 알게 된 참고 메모다.
     */
    parseNotes: string[];
    /**
     * branch가 있으면 branch key, 아니면 file key를 담는다.
     * Figma MCP가 branch URL을 file key처럼 다뤄야 할 때 사용한다.
     */
    resolvedFileKey?: string;
    /**
     * MCP 도구에 직접 넣기 좋은 `:` 형태의 node id다.
     */
    normalizedNodeId?: string;
};
/**
 * @description Figma node id를 MCP 친화적인 `:` 구분 형태로 정규화한다.
 * @param nodeId 원본 node id 문자열
 * @returns 정규화된 node id
 */
export declare function normalizeFigmaNodeId(nodeId: string): string;
/**
 * @description
 * 사용자가 입력한 Figma 주소에서 MCP 조회 힌트를 뽑아낸다.
 * URL 전체 전달이 schema mismatch를 내는 경우를 줄이기 위해 node id를 우선 정리한다.
 *
 * @param sourceAddress 사용자가 입력한 Figma 주소 또는 node id
 * @returns 파싱 결과 메타데이터
 */
export declare function parseFigmaAddress(sourceAddress: string): ParsedFigmaAddress;
//# sourceMappingURL=figma-helpers.d.ts.map