mini-figma-code-connect 0.1.0 → 0.1.3

package/LICENSE

@@ -1,16 +1,18 @@
-MIT License
+Proprietary License
 
 Copyright (c) 2026 elaine.ma
 
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
+All rights reserved.
 
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
+This software and associated documentation files (the "Software") are the
+proprietary property of the copyright holder.
+
+Permission is granted to install and use the Software via the published npm
+package for your own projects, subject to the npm package terms.
+
+You may not copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software source code, except as allowed by applicable law or
+with prior written permission from the copyright holder.
 
 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
@@ -19,3 +21,5 @@ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
+
+Issues and feedback: https://github.com/elainema0215/mini-figma-code-connect/issues

package/README.md

@@ -2,17 +2,46 @@
 
 **Local Code Connect for Figma Professional** — 无 Org / Enterprise 也能做确定性的 `f(instance) → snippet`。
 
-面向 Pro 档团队的轻量替代引擎：Figma 插件 + 将设计组件映射到消费方真实代码库的工作流。
+> 源码未开源。npm 仅分发编译产物（`dist/`）。问题与反馈请到 [GitHub Issues](https://github.com/elainema0215/mini-figma-code-connect/issues)。
 
+面向 Pro 档团队的轻量替代引擎：Figma 插件 + 将设计组件映射到消费方真实代码库的工作流。
 官方 Code Connect 与 Builder.io Design System Intelligence 均要求 Organization / Enterprise 订阅；团队当前为 Professional，相关 MCP 绑定工具不可用。本引擎在本地实现等价的「组件绑定 + 属性映射」：映射进消费方仓库、执行在 Figma 插件，不依赖云端 publish。插件沙箱无法读写本地代码，因此映射生成在沙箱外（agent / CLI）完成，再经构建打包进插件。
 
-完整背景评估、引擎仓库本地开发、系统架构与核心实现见本地 [核心实现.md](核心实现.md)（不纳入版本控制）；方案对比见 [参考.md](参考.md)。
+---
+
+## 与官方 Code Connect 的差异
+
+以下差异均为刻意设计，而非未实现的功能缺口：
+
+| | 官方 Code Connect | 本实现 |
+|---|---|---|
+| 订阅计划要求 | Organization / Enterprise，需 Full 或 Dev 席位 | 无要求，任意计划均可运行 |
+| 模板存储位置 | 发布至 Figma 服务端（CLI `publish` 或 MCP `add_code_connect_map`） | 构建时打包进插件 |
+| 模板执行方 | Figma 侧沙箱，在 Dev Mode / MCP 读取时执行 | 插件主线程，选中实例时执行 |
+| 模板入口 | 模块顶层 `const instance = figma.selectedInstance` | `render(instance)` 函数参数 |
+| 三行绑定注释 | 构建时解析 `// url= // source= // component=` | 保留注释供人工阅读，同时在 `meta` 字段中显式声明 |
+| 组件发布状态要求 | 必须已发布 | 不要求，未发布时退回按组件名匹配 |
+| SLOT 属性 | 支持 `getSlot()` | 未实现，仅支持 TEXT / BOOLEAN / VARIANT / INSTANCE_SWAP |
+| 多框架支持 | 通过 `label` 枚举，单一设计组件可挂载多条并行映射 | 仅支持 React 一条 |
+| 穷举校验 | 不提供，缺值静默 | 提供，`validate()` 自动对账 |
+| 绑定关系判定方 | Figma 服务端存储的映射，或人工在 Code Connect UI 中手动指定 | agent 现场读取代码判断（mini-code-connect skill），或本地正则打分兜底 |
+
+---
+
+## 已知限制
+
+- **尚未接入基于 REST API 与 Personal Access Token 的 schema 拉取能力**。该方案理论可行（通用 Figma REST API 不受 Code Connect 订阅限制），但目前唯一的数据来源仍是插件手动导出的 schema.json。
+- **不提供跨消费方的数据新鲜度检查**。某个消费方代码库更新后，此前标记为 `guessed` / `unmatched` 的映射条目是否已可补全，需人工发起新一轮映射流程，引擎本身不做追踪。
+
+> 构建时生成的 `registry.generated.ts` / `mapping-table.generated.json` 写在消费方 `outDir/.generated/`（默认 `figma-plugin-dist/.generated/`），经 esbuild 插件注入，不会改写 `node_modules` 内的包文件，多消费方可并行构建。
+
+消费方项目自身映射数据的具体缺口（未映射的组件、置信度较低的属性推断），记录于消费方 `figma-mapping-table.json` 的 `unmappedNotes` / `note` 字段中，不属于本文档的追踪范围。
 
 ---
 
 ## 消费方接入
 
-面向将 `mini-figma-code-connect` 接入自身项目、并开始建立 Figma 组件映射的使用者。下文以 `trex-website/apps/rexy` 为例，所有命令默认在消费方子项目目录（例如 `apps/rexy`，而非 monorepo 根目录）下执行。
+面向将 `mini-figma-code-connect` 接入自身项目、并开始建立 Figma 组件映射的使用者。所有命令默认在消费方项目目录（含 `package.json` 的目录）下执行；若为 monorepo，请进入已安装该依赖的子包目录，勿在仓库根目录执行。
 
 ### 前置条件
 
@@ -36,27 +65,15 @@ pnpm add -D mini-figma-code-connect
 pnpm exec mini-code-connect-scaffold-plugin --id <manifest-id>
 ```
 
-`--id` 为必填参数，同一 Figma 账号内不可与已导入的其他插件重复（引擎仓库自身的 demo 插件 id 为 `simple-code-connect-demo`）。`--name` 为可选参数，默认值为 `"Mini Code Connect"`；仅当账号内同时安装了多个消费方插件、需要在 Figma 插件列表中加以区分时才需传入。
-
-该命令具备幂等性：已存在的文件不会被覆盖，重复执行不会影响后续的手动修改；如需强制重新生成，附加 `--force` 参数。执行内容如下：
+`--id` 必填，同一 Figma 账号内不可与已导入插件重复。`--name` 可选（默认 `"Mini Code Connect"`），多插件并存时用于区分。
 
-| 步骤 | 目标位置 | 说明 |
-|---|---|---|
-| 安装 skill | `<仓库根>/.claude/skills/mini-code-connect/`（若 `<仓库根>/.agents/skills/` 存在，同时写入一份） | 自动从当前目录向上查找 `.git` 所在的仓库根——pnpm monorepo 中子包目录并非仓库根，写入错误位置会导致 Claude Code 无法发现该 skill |
-| 候选组件目录配置 | `<cwd>/figma-mapping.config.json` | 默认假设组件位于 `<cwd>/components`，可通过 `--components <dir>` 调整 |
-| Manifest | `<cwd>/manifest.json` 与 `manifest.codegen.json` | `main`/`ui` 字段指向 `--out` 参数指定的目录（默认 `figma-plugin-dist`） |
-| 构建脚本 | `<cwd>/scripts/build-figma-plugin.mjs` | 调用引擎包导出的 `buildPlugin()` |
-| package.json | 新增 `scripts.figma:build` 与 `figma:watch` | 已存在的同名 script 不会被覆盖 |
-| `.gitignore` | 新增构建产物目录的忽略规则 | 已存在同一条规则则跳过 |
-| 首次构建 | `<cwd>/<outDir>/`（默认 `figma-plugin-dist/`） | 命令结束时自动执行一次构建，产出可直接导入 Figma 的插件——无需额外手动执行 `pnpm run figma:build` |
+命令幂等：已有文件不覆盖；需重建时加 `--force`。会写入 skill、候选组件配置、manifest、构建脚本与 `package.json` scripts，并自动完成首次构建，之后可直接导入 Figma（步骤 4）。
 
-命令执行完毕即可直接导入 Figma（见步骤 4），无需再手动构建一次。
-
-如需单独执行其中某一步（例如仅重新生成 manifest），可使用以下更细粒度的命令——`scaffold-plugin` 内部即调用这两者：
+仅需其中一步时：
 
 ```bash
-pnpm exec mini-code-connect-install-skill                          # 仅执行 skill 安装
-pnpm exec mini-code-connect-scaffold-manifest --id <manifest-id>   # 仅执行 manifest 生成
+pnpm exec mini-code-connect-install-skill
+pnpm exec mini-code-connect-scaffold-manifest --id <manifest-id>
 ```
 
 #### 3. 按需调整候选组件目录
@@ -91,118 +108,23 @@ pnpm exec mini-code-connect-scaffold-manifest --id <manifest-id>   # 仅执行 m
 
 无 agent 可用时，`pnpm exec figma-mapping <schema.json>` 提供本地正则打分作为兜底方案（同样支持批量 schema 数组与 `--ai` 模式），判断准确度低于 agent 现场读取代码，但落盘规则保持一致。
 
-### 命令参考
-
-| 命令 | 必填参数 | 作用 |
-|---|---|---|
-| `mini-code-connect-scaffold-plugin` | `--id` | 执行完整一次性脚手架（详见步骤 2） |
-| `mini-code-connect-install-skill` | 无 | 仅将 skill 复制至项目。`--root <path>` 显式指定仓库根，`--no-claude-mirror` 仅写入 `.agents/skills/`，`--force` 覆盖已存在内容 |
-| `mini-code-connect-scaffold-manifest` | `--id` | 仅生成 manifest.json 与 manifest.codegen.json。`--out <dir>` 指定产物目录 |
-| `figma-mapping` | `<schema.json>` | 本地正则打分 CLI，agent 缺席时的兜底方案。`--ai` 调用本机 `claude` CLI 以无头模式执行判断 |
-
-### 常见问题
-
-#### `EACCES: spawn <command>`
-
-通常由以下两种原因之一导致：
+## 常见问题
 
-1. **脚本文件缺少可执行权限**。正常情况下不应出现（引擎仓库内相关脚本均为 `-rwxr-xr-x`）；若出现，问题大概率在引擎侧，应向引擎仓库反馈。
-2. **bin 软链未生成**。引擎包的 `package.json` 新增了 `bin` 条目，但消费方项目在此后未重新执行安装，`node_modules/.bin/` 中缺少对应命令。执行以下命令刷新：
-   ```bash
-   pnpm install
-   ```
+1. **Q:** 命令找不到 / `EACCES: spawn …`  
+   **A:** 先在已安装依赖的目录执行 `pnpm install`，刷新 `node_modules/.bin`。若仍报错，多半是引擎包脚本权限问题，反馈给引擎仓库。
 
-#### `ERR_PNPM_RECURSIVE_EXEC_FIRST_FAIL`
+2. **Q:** `ERR_PNPM_RECURSIVE_EXEC_FIRST_FAIL`  
+   **A:** 不要在 monorepo 根目录跑 `pnpm exec`；进入已安装 `mini-figma-code-connect` 的子包再执行。
 
-该错误通常表示 `pnpm exec` 是在 monorepo 根目录执行的，触发了对所有工作区包的递归遍历，其中部分包并未安装该依赖。切换至具体子项目目录（例如 `apps/rexy`）后重新执行。
+3. **Q:** 和官方 Code Connect 会冲突吗？  
+   **A:** 不会覆盖。本方案用 `mini-code-connect` skill 与 `figma-mapping.config.json`，官方用 `figma-code-connect` / `figma.config.json`；格式不兼容，勿混用。
 
-#### 与项目中已有的其他 Figma Code Connect 相关 skill/config 是否存在冲突
+4. **Q:** 改了 manifest，Figma 没变化？  
+   **A:** `editorType` / `capabilities` 在导入时缓存。需在 Figma 里删掉该开发插件后重新导入。`figma-plugin-dist/` 下的 `code.js` / `ui.html` 每次运行都会重读，改构建产物不必重导。
 
-`mini-code-connect` 这一 skill 名称与 `figma-mapping.config.json` 这一配置文件名，均刻意与官方 Figma Code Connect（`figma-code-connect` skill、`figma.config.json`、`.figma.ts` + `figma.connect()`/`figma.code` 官方格式）区分。两者格式不兼容，不应混用，也不应将本手册的步骤应用于官方格式的文件。若项目中两者并存，`.claude/skills/`（及 `.agents/skills/`，如适用）下应可见 `mini-code-connect` 与 `figma-code-connect` 两个独立目录，互不覆盖。
-
-#### 修改 manifest 后 Figma 无变化
-
-`editorType`/`capabilities` 由 Figma 在插件注册时读取一次并缓存，修改 manifest 文件本身不会自动生效，必须在 Figma 中删除该开发插件并重新导入。构建产物（`figma-plugin-dist/` 下的 `code.js`/`ui.html`）则会在插件每次运行时重新读取，无需删除重导。
-
----
-
-## 项目结构
-
-```
-manifest.json                     Figma 插件清单（面板形态）——本仓库自身 demo 用，产物零映射
-manifest.codegen.json             Figma 插件清单（Dev Mode Code 区形态）——同上
-figma-mapping.config.example.json 消费方接入时复制到自身项目根目录的配置模板
-esbuild.config.mjs                本仓库以 buildPlugin() 自举打包自身（零映射，用于验证引擎可用性）
-
-.claude/skills/mini-code-connect/
-└── SKILL.md                      工作流的完整步骤定义，agent 依此执行——写入目标是消费方项目，而非本仓库
-
-scripts/figma-mapping/            插件沙箱之外的工作流实现（CLI 以调用时的 cwd 作为 ROOT，即消费方项目根目录）
-├── index.mjs                        CLI 入口：本地正则打分选取候选 + 交互确认，agent 缺席场景下的兜底方案
-├── lib.mjs                           读取消费方项目的 figma-mapping.config.json，扫描候选目录，提取组件信息并打分
-├── scaffold.mjs                      根据打分选中的候选生成 .figma.ts 内容
-├── registry.mjs                      重新生成 registry.generated.ts（薄封装，核心逻辑位于 scripts/generate-registry.mjs）
-└── ai-generate.mjs                   --ai 模式：调用本机 claude CLI 进行判断（存在 OAuth 阻塞风险，不推荐；agent 在场时应直接使用 skill）
-
-scripts/
-├── build-plugin.mjs                导出 buildPlugin({cwd, mappingsGlob, mappingTablePath, outDir, watch})
-├── generate-registry.mjs           导出 generateRegistry({cwd, mappingsGlob, outFile})，扫描 .figma.ts 生成 registry.generated.ts
-├── copy-mapping-table.mjs          将消费方的 figma-mapping-table.json 复制至包自身 src/main/ 下，供 code.ts 静态引入
-├── install-skill.mjs               bin: mini-code-connect-install-skill
-├── scaffold-manifest.mjs           bin: mini-code-connect-scaffold-manifest
-├── scaffold-plugin.mjs             bin: mini-code-connect-scaffold-plugin —— 单条命令完成上述两项 + 候选目录配置 + 构建脚本 + package.json scripts
-└── is-cli-entrypoint.mjs           内部工具：判定"是否被直接作为 CLI 执行"（process.argv[1] 与 import.meta.url 的朴素比较通常不成立，详见文件内注释）
-
-src/
-├── runtime/                      轻量级 Code Connect 运行时（与 Figma API 无关，可独立测试）——包的公开入口
-│   ├── index.ts                      导出 defineTemplate/code/类型定义，消费方通过 `import { defineTemplate, code } from 'mini-figma-code-connect'` 引入
-│   ├── types.ts                      ResultSection / ComponentSchema / Template / InstanceLike
-│   ├── tagged.ts                     figma.code`...` 的简化实现：切分 section，展平嵌套结构
-│   ├── render.ts                     ResultSection[] 转字符串
-│   ├── define.ts                     defineTemplate()，用于类型收窄
-│   ├── registry.generated.ts         自动生成（已加入 .gitignore），由 scripts/generate-registry.mjs 扫描消费方 .figma.ts 产出；本地 build/typecheck 前生成
-│   └── registry.ts                   componentKey / componentName 到模板的查找；templates 数组从 registry.generated 转出
-├── main/                         插件主线程（可访问 figma.* API）
-│   ├── code.ts                       六步流水线与面板消息处理，详见核心实现.md
-│   ├── schema.ts                     组件到属性 schema 的提取
-│   ├── handle.ts                     InstanceHandle：访问器层与递归执行
-│   ├── validate.ts                   Step 6 自检的自动化实现
-│   ├── mapping-table.generated.json  自动生成（已加入 .gitignore），构建时从消费方的 figma-mapping-table.json 复制
-│   └── messages.ts                   主线程与 UI 间的消息类型定义
-├── ui/                            插件面板
-│   ├── ui.html
-│   └── ui.ts
-└── dev/
-    ├── demo.ts                       独立示例模板，使用模拟实例渲染，不依赖 Figma 或任何消费方数据
-    └── export.ts                     生成 codeconnect.json
-```
-
----
-
-## 与官方 Code Connect 的差异
-
-以下差异均为刻意设计，而非未实现的功能缺口：
-
-| | 官方 Code Connect | 本实现 |
-|---|---|---|
-| 订阅计划要求 | Organization / Enterprise，需 Full 或 Dev 席位 | 无要求，任意计划均可运行 |
-| 模板存储位置 | 发布至 Figma 服务端（CLI `publish` 或 MCP `add_code_connect_map`） | 构建时打包进插件 |
-| 模板执行方 | Figma 侧沙箱，在 Dev Mode / MCP 读取时执行 | 插件主线程，选中实例时执行 |
-| 模板入口 | 模块顶层 `const instance = figma.selectedInstance` | `render(instance)` 函数参数 |
-| 三行绑定注释 | 构建时解析 `// url= // source= // component=` | 保留注释供人工阅读，同时在 `meta` 字段中显式声明 |
-| 组件发布状态要求 | 必须已发布 | 不要求，未发布时退回按组件名匹配 |
-| SLOT 属性 | 支持 `getSlot()` | 未实现，仅支持 TEXT / BOOLEAN / VARIANT / INSTANCE_SWAP |
-| 多框架支持 | 通过 `label` 枚举，单一设计组件可挂载多条并行映射 | 仅支持 React 一条 |
-| 穷举校验 | 不提供，缺值静默 | 提供，`validate()` 自动对账 |
-| 绑定关系判定方 | Figma 服务端存储的映射，或人工在 Code Connect UI 中手动指定 | agent 现场读取代码判断（mini-code-connect skill），或本地正则打分兜底 |
-
----
-
-## 已知限制
-
-- **尚未接入基于 REST API 与 Personal Access Token 的 schema 拉取能力**。该方案理论可行（通用 Figma REST API 不受 Code Connect 订阅限制），但目前唯一的数据来源仍是插件手动导出的 schema.json。
-- **不提供跨消费方的数据新鲜度检查**。某个消费方代码库更新后，此前标记为 `guessed` / `unmatched` 的映射条目是否已可补全，需人工发起新一轮映射流程，引擎本身不做追踪。
-
-> 构建时生成的 `registry.generated.ts` / `mapping-table.generated.json` 写在消费方 `outDir/.generated/`（默认 `figma-plugin-dist/.generated/`），经 esbuild 插件注入，不会改写 `node_modules` 内的包文件，多消费方可并行构建。
-
-消费方项目自身映射数据的具体缺口（未映射的组件、置信度较低的属性推断），记录于消费方 `figma-mapping-table.json` 的 `unmappedNotes` / `note` 字段中，不属于本文档的追踪范围。
+5. **Q:** 导入/运行插件时报 `EPERM: operation not permitted, open '…/figma-plugin-dist/code.js'`，或提示 *Unable to load code* / *loading the plugin environment*？  
+   **A:** 这通常不是包本身坏了，而是 **macOS 隐私权限拦住了 Figma 读取本地文件**（项目在 `Desktop` / `Documents` 下时很常见）。处理：
+   1. **系统设置 → 隐私与安全性 → 文件与文件夹**（必要时再开「完全磁盘访问权限」），给 **Figma** 勾选桌面 / 文稿等对应目录。
+   2. 完全退出并重启 Figma。
+   3. 在 Development 里删掉旧插件后，重新 **Import plugin from manifest…**。  
+   也可把消费方仓库挪出受保护目录（例如 `~/Projects/`）再导入。

package/dist/build.mjs

@@ -0,0 +1,222 @@
+#!/usr/bin/env node
+
+// scripts/build-plugin.mjs
+import * as esbuild from "esbuild";
+import { existsSync as existsSync2 } from "node:fs";
+import { readFile, writeFile, mkdir } from "node:fs/promises";
+import path4 from "node:path";
+
+// scripts/is-cli-entrypoint.mjs
+import { existsSync, readFileSync, realpathSync } from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+function isCliEntrypoint(importMetaUrl) {
+  if (!process.argv[1]) return false;
+  try {
+    return realpathSync(process.argv[1]) === realpathSync(fileURLToPath(importMetaUrl));
+  } catch {
+    return false;
+  }
+}
+function findPackageRoot(importMetaUrl) {
+  let dir = path.dirname(fileURLToPath(importMetaUrl));
+  while (true) {
+    const pkgPath = path.join(dir, "package.json");
+    if (existsSync(pkgPath)) {
+      try {
+        const pkg = JSON.parse(readFileSync(pkgPath, "utf8"));
+        if (pkg.name === "mini-figma-code-connect") return dir;
+      } catch {
+      }
+    }
+    const parent = path.dirname(dir);
+    if (parent === dir) {
+      throw new Error("[mini-figma-code-connect] \u627E\u4E0D\u5230\u5305\u6839\u76EE\u5F55\uFF08package.json\uFF09");
+    }
+    dir = parent;
+  }
+}
+
+// scripts/generate-registry.mjs
+import fs from "node:fs";
+import path2 from "node:path";
+function parseGlob(glob) {
+  const starIdx = glob.indexOf("*");
+  if (starIdx === -1) throw new Error(`generate-registry: glob \u91CC\u6CA1\u6709 *\uFF1A"${glob}"`);
+  const dir = glob.slice(0, starIdx).replace(/\/$/, "");
+  const recursive = glob.includes("**");
+  return { dir, recursive };
+}
+function findFigmaFiles(dir, recursive) {
+  const results = [];
+  function walk(d) {
+    if (!fs.existsSync(d)) return;
+    for (const entry of fs.readdirSync(d, { withFileTypes: true })) {
+      if (entry.name === "node_modules" || entry.name.startsWith(".")) continue;
+      const full = path2.join(d, entry.name);
+      if (entry.isDirectory()) {
+        if (recursive) walk(full);
+      } else if (entry.name.endsWith(".figma.ts")) {
+        results.push(full);
+      }
+    }
+  }
+  walk(dir);
+  return results.sort();
+}
+function identifierFor(filePath, index) {
+  const base = path2.basename(filePath).replace(/\.figma\.ts$/, "").replace(/[^a-zA-Z0-9]/g, "");
+  const safe = base && /^[a-zA-Z_]/.test(base) ? base : `M${base}`;
+  return `${safe || "Mapping"}_${index}`;
+}
+function generateRegistry({ cwd, mappingsGlob, outFile, typesImport = "./types" }) {
+  const { dir, recursive } = parseGlob(mappingsGlob);
+  const files = findFigmaFiles(path2.resolve(cwd, dir), recursive);
+  const outDir = path2.dirname(outFile);
+  const imports = files.map((f, i) => {
+    const id = identifierFor(f, i);
+    let rel = path2.relative(outDir, f).replace(/\.ts$/, "");
+    if (!rel.startsWith(".")) rel = `./${rel}`;
+    rel = rel.split(path2.sep).join("/");
+    return { id, importPath: rel };
+  });
+  const typeLine = typesImport == null ? "" : `import type { Template } from '${typesImport}'
+`;
+  const templatesAnn = typesImport == null ? "" : ": Template[]";
+  const body = `// \u81EA\u52A8\u751F\u6210\uFF0C\u4E0D\u8981\u624B\u6539 \u2014\u2014 \u7531 scripts/generate-registry.mjs \u626B .figma.ts \u751F\u6210\uFF0C\u6BCF\u6B21 build \u524D\u91CD\u8DD1
+` + typeLine + imports.map((i) => `import ${i.id} from '${i.importPath}'`).join("\n") + (imports.length ? "\n\n" : "\n") + `export const templates${templatesAnn} = [${imports.map((i) => i.id).join(", ")}]
+`;
+  fs.mkdirSync(outDir, { recursive: true });
+  fs.writeFileSync(outFile, body);
+  return { count: files.length, files };
+}
+if (isCliEntrypoint(import.meta.url)) {
+  const [, , mappingsGlob, outFile] = process.argv;
+  if (!mappingsGlob || !outFile) {
+    console.error("\u7528\u6CD5: node scripts/generate-registry.mjs <mappingsGlob> <outFile>");
+    process.exit(1);
+  }
+  const result = generateRegistry({ cwd: process.cwd(), mappingsGlob, outFile: path2.resolve(outFile) });
+  console.log(`[generate-registry] \u5199\u5165 ${result.count} \u6761\u6620\u5C04\u5230 ${outFile}`);
+}
+
+// scripts/copy-mapping-table.mjs
+import fs2 from "node:fs";
+import path3 from "node:path";
+function copyMappingTable({ cwd, mappingTablePath, outFile }) {
+  const src = path3.resolve(cwd, mappingTablePath);
+  const content = fs2.existsSync(src) ? fs2.readFileSync(src, "utf8") : "[]\n";
+  fs2.mkdirSync(path3.dirname(outFile), { recursive: true });
+  fs2.writeFileSync(outFile, content);
+  return { found: fs2.existsSync(src) };
+}
+
+// scripts/build-plugin.mjs
+var PACKAGE_ROOT = findPackageRoot(import.meta.url);
+function resolvePluginEntries(packageRoot) {
+  const main = path4.join(packageRoot, "dist/main/code.js");
+  const ui = path4.join(packageRoot, "dist/ui/ui.js");
+  const html = path4.join(packageRoot, "dist/ui/ui.html");
+  for (const file of [main, ui, html]) {
+    if (!existsSync2(file)) {
+      throw new Error(
+        `[build-plugin] \u7F3A\u5C11 ${file}\u3002\u8BF7\u5148\u5728\u5F15\u64CE\u5305\u76EE\u5F55\u6267\u884C npm run build\uFF08\u53EA\u4F7F\u7528 dist/\uFF0C\u4E0D\u56DE\u9000 src/\uFF09\u3002`
+      );
+    }
+  }
+  return { main, ui, html };
+}
+function consumerGeneratedPlugin(genDir) {
+  const registryFile = path4.join(genDir, "registry.generated.ts");
+  const mappingTableFile = path4.join(genDir, "mapping-table.generated.json");
+  return {
+    name: "consumer-generated",
+    setup(build2) {
+      build2.onResolve({ filter: /(?:^|[\\/])registry\.generated(?:\.(?:ts|js))?$/ }, () => ({
+        path: registryFile
+      }));
+      build2.onResolve({ filter: /(?:^|[\\/])mapping-table\.generated\.json$/ }, () => ({
+        path: mappingTableFile
+      }));
+    }
+  };
+}
+async function buildPlugin({
+  cwd,
+  mappingsGlob,
+  mappingTablePath = "figma-mapping-table.json",
+  outDir = "dist",
+  watch = false
+}) {
+  const { main: mainEntry, ui: uiEntry, html: uiHtml } = resolvePluginEntries(PACKAGE_ROOT);
+  const absOutDir = path4.resolve(cwd, outDir);
+  const genDir = path4.join(absOutDir, ".generated");
+  const registryOut = path4.join(genDir, "registry.generated.ts");
+  const mappingTableOut = path4.join(genDir, "mapping-table.generated.json");
+  const { count } = generateRegistry({
+    cwd,
+    mappingsGlob,
+    outFile: registryOut,
+    typesImport: null
+  });
+  console.log(`[build-plugin] \u626B\u5230 ${count} \u6761\u6620\u5C04\uFF08${mappingsGlob}\uFF09`);
+  const { found } = copyMappingTable({ cwd, mappingTablePath, outFile: mappingTableOut });
+  if (!found) console.log(`[build-plugin] \u6CA1\u627E\u5230 ${mappingTablePath}\uFF0C\u4E0B\u8F7D\u6309\u94AE\u4F1A\u7ED9\u7A7A\u6570\u7EC4`);
+  const generatedPlugin = consumerGeneratedPlugin(genDir);
+  const inlineUi = {
+    name: "inline-ui",
+    setup(build2) {
+      build2.onEnd(async (res) => {
+        if (res.errors.length) return;
+        const js = res.outputFiles ? res.outputFiles[0].text : await readFile(path4.join(absOutDir, ".ui.tmp.js"), "utf8");
+        const html = await readFile(uiHtml, "utf8");
+        await mkdir(absOutDir, { recursive: true });
+        await writeFile(path4.join(absOutDir, "ui.html"), html.replace("/*__UI_JS__*/", () => js));
+        console.log(`[inline-ui] ${path4.join(outDir, "ui.html")} \u5DF2\u66F4\u65B0`);
+      });
+    }
+  };
+  const codeOpts = {
+    entryPoints: [mainEntry],
+    bundle: true,
+    format: "iife",
+    target: "es2020",
+    outfile: path4.join(absOutDir, "code.js"),
+    logLevel: "info",
+    plugins: [generatedPlugin]
+  };
+  const uiOpts = {
+    entryPoints: [uiEntry],
+    bundle: true,
+    format: "iife",
+    target: "es2020",
+    outfile: path4.join(absOutDir, ".ui.tmp.js"),
+    logLevel: "warning",
+    plugins: [inlineUi, generatedPlugin]
+  };
+  if (watch) {
+    const a = await esbuild.context(codeOpts);
+    const b = await esbuild.context(uiOpts);
+    await Promise.all([a.watch(), b.watch()]);
+    console.log("[build-plugin] watching...");
+    return { watching: true };
+  }
+  await esbuild.build(codeOpts);
+  await esbuild.build(uiOpts);
+  return { watching: false };
+}
+if (isCliEntrypoint(import.meta.url)) {
+  const args = process.argv.slice(2);
+  const watch = args.includes("--watch");
+  const outIdx = args.indexOf("--out");
+  const outDir = outIdx !== -1 ? args[outIdx + 1] : "dist";
+  const mappingsGlob = args.find((a, i) => !a.startsWith("--") && args[i - 1] !== "--out");
+  if (!mappingsGlob) {
+    console.error("\u7528\u6CD5: node scripts/build-plugin.mjs <mappingsGlob> [--out dist] [--watch]");
+    process.exit(1);
+  }
+  await buildPlugin({ cwd: process.cwd(), mappingsGlob, outDir, watch });
+}
+export {
+  buildPlugin
+};