@ufira/vibma 0.3.0 → 0.3.2-rc.2

package/README.md

@@ -0,0 +1,56 @@
+> **[简体中文](./README.zh-CN.md)**
+
+<div align="center">
+
+# ✦ Vibma
+
+**Vibe Design meets Figma.**
+
+https://github.com/user-attachments/assets/bf38e37d-57bb-40b3-a2d1-f89216117c11
+</div>
+
+Let AI agents design directly in Figma — read layouts, create components,
+modify styles, and build entire design systems through conversation.
+
+---
+
+## Model Recommendations
+
+Vibma works with any LLM that supports MCP. Based on our [benchmark](https://github.com/ufira-ai/vibma-benchmark):
+
+- **Cheap one-shot builds:** GPT-5.3 Codex (medium reasoning) — proper components, all variables bound, clean output for under $1. Degrades on follow-up tasks.
+- **Iterative design work:** GPT-5.3 Codex (xhigh), Gemini 3.1 Pro, or Claude Opus 4.6 — these maintain quality as context grows and handle multi-pass workflows.
+- **Avoid:** Models that skip figma components building (e.g. Cursor Auto, Kimi K2.5) produce frames that look right but aren't structurally usable — no instances, no variants, no library.
+
+## Setup
+
+Two paths:
+
+| | Guide | For |
+|---|---|---|
+| 📦 | [**DRAGME.md**](./DRAGME.md) | Clone the repo, build from source, full control |
+| ☁️ | [**CARRYME.md**](./CARRYME.md) | Install from npm, zero cloning |
+| 📖 | [**Docs**](https://ufira-ai.github.io/Vibma/) | Tool reference with parameters, response schemas, and examples |
+
+Or just paste this to your AI agent and let it figure it out:
+
+```
+Set up Vibma so I can vibe-design in Figma.
+Follow the instructions at https://raw.githubusercontent.com/ufira-ai/vibma/refs/heads/main/CARRYME.md
+```
+
+## Community
+
+[![Discord Banner](https://img.shields.io/discord/1476577401298358315?color=5865F2&label=Join%20the%20Discord&logo=discord&logoColor=white&style=for-the-badge)](https://discord.gg/4XTedZdwV6)
+
+[GitHub Issues](https://github.com/ufira-ai/vibma/issues) — bugs and feature requests
+
+Vibma is the first open-source project from **[ufira](https://github.com/ufira-ai)** — a platform bridging creators and technology. We believe everyone who wants to create should have access to AI-powered tools, not just developers.
+
+## Acknowledgments
+
+Built on the foundation of [cursor-talk-to-figma-mcp](https://github.com/grab/cursor-talk-to-figma-mcp) by [sonnylazuardi](https://github.com/sonnylazuardi).
+
+## License
+
+[MIT](./LICENSE)

package/dist/mcp.cjs

@@ -268,7 +268,10 @@ var sectionItem = import_zod6.z.object({
   y: yPos,
   width: import_zod6.z.coerce.number().optional().describe("Width (default: 500)"),
   height: import_zod6.z.coerce.number().optional().describe("Height (default: 500)"),
-  parentId
+  parentId,
+  fillColor: flexJson(colorRgba).optional().describe("Fill color. Default: no fill (transparent)."),
+  fillStyleName: import_zod6.z.string().optional().describe("Apply a fill paint style by name (case-insensitive)."),
+  fillVariableId: import_zod6.z.string().optional().describe("Bind a color variable to the fill.")
 });
 var svgItem = import_zod6.z.object({
   svg: import_zod6.z.string().describe("SVG markup string"),
@@ -280,7 +283,7 @@ var svgItem = import_zod6.z.object({
 var tools5 = [
   {
     name: "create_section",
-    description: "Create section nodes to organize content on the canvas.",
+    description: "Create section nodes to organize content on the canvas. Default: no fill (transparent).",
     schema: { items: flexJson(import_zod6.z.array(sectionItem)).describe("Array of sections to create"), depth },
     tier: "create"
   },
@@ -377,8 +380,8 @@ var textItem = import_zod8.z.object({
 var tools7 = [
   {
     name: "create_text",
-    description: "Create text nodes. Max 10 per batch. Prefer textStyleName for typography and fontColorStyleName or fontColorVariableId for color \u2014 hardcoded values skip design tokens. Supports custom fonts via fontFamily.",
-    schema: { items: flexJson(import_zod8.z.array(textItem).max(10)).describe("Array of text nodes to create (max 10)"), depth },
+    description: "Create text nodes. Prefer textStyleName for typography and fontColorStyleName or fontColorVariableId for color \u2014 hardcoded values skip design tokens. Supports custom fonts via fontFamily.",
+    schema: { items: flexJson(import_zod8.z.array(textItem)).describe("Array of text nodes to create"), depth },
     tier: "create"
   }
 ];
@@ -441,8 +444,9 @@ var patchNodeItem = import_zod10.z.object({
   // Appearance (nested)
   fill: flexJson(import_zod10.z.object({
     color: flexJson(colorRgba).optional(),
-    styleName: import_zod10.z.string().optional().describe("Paint style name (preferred over color)")
-  })).optional().describe("Fill color or style"),
+    styleName: import_zod10.z.string().optional().describe("Paint style name (preferred over color)"),
+    clear: flexBool(import_zod10.z.boolean()).optional().describe("Set true to remove all fills")
+  })).optional().describe("Fill color, style, or clear"),
   stroke: flexJson(import_zod10.z.object({
     color: flexJson(colorRgba).optional(),
     weight: import_zod10.z.coerce.number().positive().optional().describe("Stroke weight"),
@@ -903,7 +907,8 @@ var componentItem = import_zod17.z.object({
   itemSpacing: import_zod17.z.coerce.number().optional().describe("Spacing between children (default: 0)")
 });
 var fromNodeItem = import_zod17.z.object({
-  nodeId
+  nodeId,
+  exposeText: flexBool(import_zod17.z.boolean()).default(true).describe("Auto-expose text children as editable TEXT properties and bind them (default: true). Set false to skip.")
 });
 var combineItem = import_zod17.z.object({
   componentIds: flexJson(import_zod17.z.array(import_zod17.z.string())).describe("Component IDs to combine (min 2)"),
@@ -941,16 +946,16 @@ var tools15 = [
     description: `CRUD endpoint for components.
   create  \u2192 {type, items, depth?} \u2192 {results: [{id}, ...]}
     type 'component': create from scratch with layout/style params
-    type 'from_node': convert existing nodes to components
+    type 'from_node': convert existing nodes to components. Text children are auto-exposed as editable properties by default (exposeText: true) \u2014 instances can set text directly via properties.
     type 'variant_set': combine components into variant sets
   get     \u2192 {id, fields?} \u2192 component object (full detail, field-filterable)
   list    \u2192 {name?, setsOnly?, fields?, offset?, limit?} \u2192 paginated stubs
-  update  \u2192 {items: [{id, propertyName, type, defaultValue}]} \u2192 {results: ['ok', ...]}`,
+  update  \u2192 {items: [{id, propertyName, type, defaultValue}]} \u2192 creates property AND binds matching text node automatically`,
     schema: (caps2) => endpointSchema(
       ["create", "get", "list", "update"],
       caps2,
       {
-        items: flexJson(import_zod17.z.array(import_zod17.z.any())).optional().describe("create (component): [{name, parentId?, ...layout}]. create (from_node): [{nodeId}]. create (variant_set): [{componentIds, name?}]. update: [{id, propertyName, type, defaultValue}]."),
+        items: flexJson(import_zod17.z.array(import_zod17.z.any())).optional().describe("create (component): [{name, parentId?, ...layout}]. create (from_node): [{nodeId, exposeText?}]. create (variant_set): [{componentIds, name?}]. update: [{id, propertyName, type, defaultValue}]."),
         type: import_zod17.z.enum(["component", "from_node", "variant_set"]).optional().describe("Create type. Required for create: 'component' (from scratch), 'from_node' (convert existing), 'variant_set' (combine as variants)."),
         depth,
         name: import_zod17.z.string().optional().describe("Filter list by name (case-insensitive substring)."),
@@ -1229,6 +1234,45 @@ Transfer content overrides from a source instance to target instances.
       description: "Strategy for transferring overrides between component instances in Figma"
     })
   );
+  server2.registerPrompt(
+    "missing_tools",
+    { description: "Why create or edit tools are missing and how to fix it" },
+    () => ({
+      messages: [{
+        role: "assistant",
+        content: {
+          type: "text",
+          text: `# Missing Create / Edit Tools
+
+If the user asks you to create or modify something in Figma but you cannot find tools like \`create_frame\`, \`create_text\`, \`patch_nodes\`, \`delete_node\`, or \`set_text_content\`, the MCP server was started without the correct access tier flag.
+
+Vibma filters tools at startup based on CLI flags passed in the MCP config \`args\` array:
+
+| Flag | Tools available |
+|------|----------------|
+| _(none)_ | Read-only (inspect, search, export) |
+| \`--create\` | Read + creation tools |
+| \`--edit\` | All tools (read + create + edit + delete) |
+
+Ask the user to add \`--edit\` (or \`--create\`) to their MCP config args:
+
+\`\`\`json
+{
+  "mcpServers": {
+    "Vibma": {
+      "command": "npx",
+      "args": ["-y", "@ufira/vibma", "--edit"]
+    }
+  }
+}
+\`\`\`
+
+After updating, the user must restart their AI tool or reload MCP servers \u2014 stdio-based servers cannot hot-reload.`
+        }
+      }],
+      description: "Why create or edit tools are missing and how to fix it"
+    })
+  );
 }
 
 // src/tools/mcp-registry.ts
@@ -1266,6 +1310,13 @@ try {
         VIBMA_VERSION = pkg.version;
         break;
       }
+      if (pkg.workspaces) {
+        try {
+          VIBMA_VERSION = JSON.parse((0, import_fs.readFileSync)((0, import_path.join)(dir, "packages/core/package.json"), "utf8")).version;
+        } catch {
+        }
+        break;
+      }
     } catch {
       continue;
     }