TypeScript interfaces for component mapping

export type FigmaNodeType =
  | "COMPONENT"
  | "ELLIPSE"
  | "FRAME"
  | "GROUP"
  | "INSTANCE"
  | "LINE"
  | "POLYGON"
  | "RECTANGLE"
  | "STAR"
  | "TEXT"
  | "VECTOR";

export interface FigmaNode extends BaseFigmaProps {
  /** Figma node "name" */
  $name: string;

  /** Figma node type (FRAME, GROUP, TEXT, etc.) */
  $type:
    | "COMPONENT"
    | "ELLIPSE"
    | "FRAME"
    | "GROUP"
    | "INSTANCE"
    | "LINE"
    | "POLYGON"
    | "RECTANGLE"
    | "STAR"
    | "TEXT"
    | "VECTOR";

  /** Represents the text content of the node and its descendants */
  $textContent: string;

  /** URL to the rasterized image of this node */
  $imageUrl: string;
}

export interface BaseFigmaProps {
  /** Direct children of the root component node or instance */
  $children: (FigmaNode | undefined)[];

  /** Recursively finds the first figma child with the given name, among all descendants */
  $findOneByName(name: string | RegExp): FigmaNode | undefined;

  /** Recursively finds all nodes with the given name, among all descendants */
  $findAllByName(name: string | RegExp): FigmaNode[];

  /** Recursively finds the first node that matches the predicate, among all descendants */
  $findOne(predicate: (node: FigmaNode) => boolean): FigmaNode | undefined;

  /** Recursively finds all nodes that match the predicate, among all descendants */
  $findAll(predicate: (node: FigmaNode) => boolean): FigmaNode[];
}