figma-coder-mcp 0.3.0 → 0.4.0

package/README.md

@@ -80,7 +80,7 @@ one.
 
 | Tool | What it does |
 |------|--------------|
-| `get_figma_data` | Returns a **compact, token-efficient design tree** for the agent to reason about and generate code from. Repeated styles are deduped into `globalVars.styles` (each node carries a short `style` ref), per-node position/size stays inline as `box`, and repeated subtrees are hoisted into `elements` (occurrences become `{ref}`) — typically 30–45% smaller than the raw per-node CSS. Small results come back inline; large ones are written to a JSON file and summarised. |
+| `get_figma_data` | Returns a **compact, token-efficient design tree** for the agent to reason about and generate code from. Repeated styles are deduped into `globalVars.styles` (each node carries a short `style` ref), per-node position/size stays inline as `box`, and repeated subtrees are hoisted into `elements` (occurrences become `{ref}`) — typically 30–45% smaller than the raw per-node CSS. Returned as **minified JSON** (most token-efficient); pass `format:"yaml"` for a more readable (but larger) form. Small results come back inline; large ones are written to a file and summarised. |
 | `convert_figma_to_html` | Produces finished, self-contained **HTML + Tailwind**. Asset inlining is **off by default** (placeholders shown for images/vectors); pass `assets:true` to render & inline them. The HTML is written to a file and a compact summary + path is returned to keep the agent's context small. Args: `mode` (`tailwind`/`inline`), `document`, `assets`, `assetScale`, `round`, `llm`, `outFile`. |
 
 ### Conversion fidelity
@@ -91,7 +91,7 @@ The deterministic converter preserves a lot of Figma intent automatically:
 - **Images**: image fills honor `scaleMode` (FILL/FIT/TILE/STRETCH) and crop transforms. Icon/illustration groups collapse into a single SVG (fewer renders); image-filled ellipses become CSS circles.
 - **Styles**: per-corner radius, stroke alignment (OUTSIDE/CENTER via `outline`), per-side borders, all gradient types (linear/radial/conic), blend modes, shadows, backdrop blur, opacity.
 - **Text**: font, line-height, letter-spacing, alignment (incl. vertical), decoration/case, gradient text, and **mixed-style runs** (a bold/colored word becomes its own `<span>`).
-- **`round`** (on by default): snaps on-grid values to idiomatic Tailwind tokens (`p-4`, `gap-6`, `rounded-lg`, `text-2xl`, `font-bold`); off-grid values stay exact, so it never silently changes real sizes. Pass `round:false` (or `--no-round` on the CLI) for exact arbitrary values everywhere.
+- **`round`** (on by default): snaps on-grid values to idiomatic Tailwind tokens (`p-4`, `gap-6`, `rounded-lg`, `text-2xl`, `font-bold`, and exact palette colors → `bg-blue-500`); off-grid values and non-palette colors stay exact, so it never silently changes real sizes or colors. Pass `round:false` (or `--no-round` on the CLI) for exact arbitrary values everywhere.
 
 ## Configuration
 
@@ -146,7 +146,7 @@ default), `--no-round` (idiomatic Tailwind snapping is on by default), `--llm`,
 |---------|--------------|
 | `figma-coder-mcp` | Start the MCP server over stdio (the default command). |
 | `convert <url\|key>` | One-off convert to a self-contained HTML file. |
-| `data <url\|key>` | Print or save the compact design tree (deduped styles + repeated-subtree templates). |
+| `data <url\|key>` | Print or save the compact design tree (deduped styles + repeated-subtree templates). `--format json` (default) or `yaml`. |
 | `set-token <PAT>` | Store a Figma personal access token globally (local mode). |
 | `login` | Sign in with Figma via OAuth, stored globally (remote mode). |
 | `status` | Show how requests will be served. No secrets printed. |