@ design- parity/ adapter- figma

图片 ReferenceAdapter法格玛是关键点来源——唯一一个拥有 机器可溶解设计-编码链接(代码连接) (中文(简体) ). 此适配器使用 REST API + 代码连接,从不使用 Dev Mode MCP 服务器(即 面向本地/桌面会议,对主机错误).

它会做什么

resolve(componentId, ref, ctx)数字 :

1. 解取结. 若为 ref 是一个手柄( e)figma:<fileKey>/<nodeId> 或一个 figma.com URL)直接解析. 否则适配器会读Repo的 代码连接输出( C)figma.code-connect.json,或 FIGMA_CODE_CONNECT_FILE(中文(简体) ) 将组件映射到节点.
2. 获取结构 —— 说 GET /v1/files/:key/nodes (铺设,角半径, 填充,文本样式).
3. 获取变量 —— 说 GET /v1/files/:key/variables/local绘图 收藏模式(Light/Dark)为主题颜色。 优雅地贬低 当变量不合格时,只使用结构符号.
4. 渲染参考图像 —— 说 GET /v1/images,下载和写入 下级 outDir。 。 。 .
5. 规范化 改为 DesignReference 与 linkMethod: "code-connect", (中文(简体) ), 包括 layout - 节点树的 absoluteBoundingBox平分为a SemanticTree (root-relative dp,框于根上)所以结构布局 diff可以比较元素放置. 文本节点被其可见的标签 characters,这是符合候选人语义标签的;其他 节点回落到它们的相克图层名称 所以一般没有匹配到 层命名被调和。 节点没有边框时缺席.

认证

从 AdapterContext.env数字 :

• FIGMA_OAUTH_TOKEN → Authorization: Bearer (首选),或
• FIGMA_TOKEN 编号 : FIGMA_PAT 编号 : FIGMA_ACCESS_TOKEN → X-Figma-Token。 。 。 .

证书缺失, 401/403, (中文(简体) ), 429 (费率限额,与 Retry-After页:1 缺少节点, 每个节点会升起一个键入 FigmaError 子类.

使用量

import { createFigmaAdapter } from "@design-parity/adapter-figma";

const adapter = createFigmaAdapter({
  // optionally render one image per theme from separate frames
  resolveTargets: (ref) => [
    { nodeId: ref.nodeId, theme: "light", size: "compact" },
    { nodeId: "1:43", theme: "dark", size: "compact" },
  ],
});

const reference = await adapter.resolve(
  "ui/Button.kt#PrimaryButton",
  "figma:AbCdEf123456/1:42",
  { repoRoot: process.cwd(), env: process.env },
);

网络可注射( E)fetch),客户端可被取笑,所以单位测试运行 全线下行( 见 test/) (中文(简体) ).

标注

Figma 的图像渲染使用节点默认可变模式; REST API 无法 切换模式 。 所以他们 符号 来自变量(所有模式), 时 图像 来自通过 resolveTargets。 。 。 .