@ufira/vibma 0.3.2 → 1.0.0-rc1

package/dist/tools/registry.cjs

@@ -22,6 +22,7 @@ __export(registry_exports, {
   registerTools: () => registerTools
 });
 module.exports = __toCommonJS(registry_exports);
+var import_zod = require("zod");
 
 // src/tools/types.ts
 var MAX_RESPONSE_CHARS = 5e4;
@@ -46,21 +47,964 @@ function mcpError(prefix, error) {
   return { content: [{ type: "text", text: `${prefix}: ${msg}` }] };
 }
 
+// src/tools/generated/help.ts
+var helpDirectory = `# Available Endpoints
+
+[design-system]
+  components               Create and manage reusable components and variant sets.
+  fonts                    Search available fonts in Figma.
+  instances                Create and manage component instances.
+  styles                   CRUD for local paint, text, effect, and grid styles.
+  variable_collections     CRUD for variable collections \u2014 the document-level API for design tokens.
+  variables                Search and update design variables within a collection.
+
+[connection]
+  connection               Manage the Figma plugin connection.
+
+[document]
+  document                 Navigate and manage Figma pages (canvases) in the document.
+  version_history          Save named versions to the Figma file's version history.
+
+[creation]
+  frames                   Create and manage frames, shapes, auto-layout containers, sections, and SVG nodes.
+  text                     Create and manage text nodes.
+
+[quality]
+  lint                     Run design quality and accessibility checks.
+
+[interaction]
+  prototyping              Manage prototype interactions, reactions, and navigation flows.
+
+[node-inspection]
+  selection                Read and set the current Figma selection.
+
+Topics:
+  missing_tools            Why create or edit tools are missing and how to fix it
+
+Use help(topic: "<endpoint>") for endpoint details.
+Use help(topic: "<endpoint>.<method>") for method details.`;
+var helpEndpoints = {
+  "components": {
+    "summary": '# components\nCreate and manage reusable components and variant sets.\n\nMethods:\n  clone                Duplicate nodes [create]\n  audit                Run lint on a node \u2014 returns severity-ranked findings [read]\n  reparent             Move nodes into a new parent [edit]\n  list                 List local component names (variant sets as single entries) [read]\n  get                  Get component detail \u2014 property definitions + ID for instances.create [read]\n  create               Create components [create]\n  update               Add, edit, or delete component properties [edit]\n  delete               Delete components or component sets [edit]\n\n// depth: omit \u2192 id+name stubs | 0 \u2192 props + child stubs | N \u2192 recurse N | -1 \u2192 full tree\n// fields: whitelist e.g. ["fills","opacity"] \u2014 id, name, type always included. Pass ["*"] for all.\n// layoutSizingHorizontal/Vertical: FIXED | HUG | FILL \u2014 how the node sizes within auto-layout.\n// Colors: fillVariableName/strokeVariableName bind by name \u2014 preferred over raw color values.\n// Note: node-based endpoints (frames, text, instances, components) use `results` as the list key.\n//   Standalone endpoints (styles, variables, variable_collections) use `items`. Components.list uses `items` (catalog view).\n// ---\n// visible: false hides the node. Omitted from response when true (the default).\n// locked: true prevents editing in Figma UI. Omitted when false (the default).\n// rotation: degrees (0-360). Omitted when 0.\n// blendMode: layer blend mode. Omitted when PASS_THROUGH (the default).\n// layoutPositioning: ABSOLUTE = floating inside auto-layout parent. Omitted when AUTO (the default).\n// minWidth/maxWidth/minHeight/maxHeight: responsive constraints for auto-layout children.\n// constraints: position behavior in non-auto-layout parents. Ignored inside auto-layout frames.\n// bindings: bind design variables to node properties. field uses slash path: "fills/0/color" (first fill), "strokes/0/color", "opacity", "width", "height", "cornerRadius", "paddingLeft", "itemSpacing".\n// explicitMode: pin a variable mode on this node. Use { collectionName, modeName } (preferred) or { collectionId, modeId }.\n// properties: escape hatch \u2014 set any Figma node property directly. Use only when no dedicated field exists.\ninterface Node {\n  id: string; name: string; type: string;\n  visible?: boolean;       // omitted when true\n  locked?: boolean;        // omitted when false\n  opacity?: number;        // omitted when 1\n  rotation?: number;       // omitted when 0\n  blendMode?: string;      // omitted when PASS_THROUGH\n  layoutPositioning?: "AUTO" | "ABSOLUTE";\n  layoutSizingHorizontal?: "FIXED" | "HUG" | "FILL";\n  layoutSizingVertical?: "FIXED" | "HUG" | "FILL";\n  minWidth?: number; maxWidth?: number; minHeight?: number; maxHeight?: number;\n  absoluteBoundingBox: { x: number; y: number; width: number; height: number };\n  fills?: Paint[];         // solid: {type: "SOLID", color: {r, g, b, a}}\n  strokes?: Paint[];\n  effects?: Effect[];      // DROP_SHADOW | INNER_SHADOW | LAYER_BLUR | BACKGROUND_BLUR\n  children?: NodeStub[];   // stubs: {id, name, type} \u2014 use depth to expand\n}\n// PatchItem uses flat params matching create shape \u2014 no nested sub-objects.\n// Fill/stroke/corner/layout/text params are identical to frames.create and text.create.\n// Unknown keys produce a warning, preventing silent failures.\n// Components are reusable design elements. Instances stay linked to the component and inherit changes.\n// Workflow: create component (with properties) \u2192 add children \u2192 create instances via instances.create.\n// ---\n// A component set (variant set) groups related components as variants (e.g. Button/Primary, Button/Secondary).\n// Property types: BOOLEAN (toggle visibility), TEXT (editable text), INSTANCE_SWAP (swap child instance), VARIANT (variant picker).\n// exposeText: when creating from_node, text children become editable TEXT properties on the component.\n// Auto-bind: TEXT properties auto-bind to text children with matching names (case-insensitive).\n// Example: properties:[{propertyName:"Label", type:"TEXT", defaultValue:"Click"}] binds to a child text node named "Label".\n// text.create accepts componentPropertyName to bind on creation \u2014 walks up ancestors to find the nearest component.\n//   For nested text (text inside frames inside a component), componentPropertyName resolves via ancestor walk. Alternatively, pass componentId explicitly.\n//   For existing nodes with many text children, prefer components(method:"create", type:"from_node", exposeText:true) \u2014 it auto-discovers, creates TEXT properties, and binds all text nodes in one operation.\n// Property keys: read returns clean names ("Label"), write requires the #suffix ("Label#1:0"). Call components.get(id) to discover exact keys before edit/delete.\n// ComponentItem accepts the same params as FrameItem (layout, fill, stroke, sizing, min/max).\n// A component IS a frame \u2014 create it directly with all layout properties, then add children.\n// SIZING: Components with text need a width constraint \u2014 set width + layoutSizingHorizontal:"FIXED".\n//   Without it, text won\'t wrap and the component grows unboundedly.\n//   HUG on both axes is only correct for intrinsically-sized elements (buttons, badges, icons).\n// action: "add" (default) \u2014 requires type + defaultValue. "edit" \u2014 pass defaultValue to change value, name to rename property. "delete" \u2014 just propertyName#suffix.\n// action: "rename_variant" \u2014 renames a variant option VALUE (not the property). Pass defaultValue=current option name, name=new option name.\n// For VARIANT properties: "edit" with defaultValue reorders children to set the default variant.\n\nUse components(method: "help", topic: "<method>") for method details.',
+    "methods": {
+      "clone": "# components.clone\nDuplicate nodes\n\nParams:\n    id (string, required) \u2014 Node ID\n    parentId (string, optional) \u2014 Parent node ID. Omit to place on current page.\n    x (number, optional) \u2014 X position (default: 0)\n    y (number, optional) \u2014 Y position (default: 0)\n    depth (number, optional) \u2014 Response detail: omit for id+name only. 0=properties + child stubs. N=recurse N levels. -1=unlimited.",
+      "audit": '# components.audit\nRun lint on a node \u2014 returns severity-ranked findings\n\nParams:\n    id (string, required) \u2014 Node ID to audit\n    rules (string[], optional) \u2014 Rules to check. Default: ["all"]. Categories: "component", "composition", "token", "naming", "wcag".\n    maxDepth (number, optional) \u2014 Max tree depth (default: 10)\n    maxFindings (number, optional) \u2014 Max findings (default: 50)',
+      "reparent": "# components.reparent\nMove nodes into a new parent\n\nParams:\n    items (array, required) \u2014 Array of {id, parentId, index?}\n      id (string, required)\n      parentId (string, required)\n      index (number, optional)",
+      "list": "# components.list\nList local component names (variant sets as single entries)\n\nParams:\n    query (string, optional) \u2014 Name search query (case-insensitive substring match)\n    offset (number, optional) \u2014 Skip N items for pagination (default 0)\n    limit (number, optional) \u2014 Max items per page (default 100)",
+      "get": "# components.get\nGet component detail \u2014 property definitions + ID for instances.create\n\nParams:\n    id (string, optional) \u2014 Component or component set ID\n    names (string[], optional) \u2014 Batch lookup by name (case-insensitive). Either id or names is required.",
+      "create": `# components.create
+Create components
+
+Example: components(method:"create", type:"component", items:[{name:"Card", layoutMode:"VERTICAL", padding:"16", itemSpacing:"8", fillVariableName:"bg/surface", children:[{type:"text", text:"Title", componentPropertyName:"Title"}, {type:"text", text:"Description", fontSize:14, componentPropertyName:"Description"}], properties:[{propertyName:"Show Icon", type:"BOOLEAN", defaultValue:true}]}])
+
+Discriminant: type (component | from_node | variant_set)
+
+  ## component \u2014 Create component with full frame properties (layout, fill, stroke, sizing). A component IS a frame \u2014 build directly, no need to create a frame first.
+    name (string, required) \u2014 Component name
+    parentId (string, optional) \u2014 Parent node ID. Omit to place on current page.
+    x (number, optional) \u2014 X position (default: 0)
+    y (number, optional) \u2014 Y position (default: 0)
+    width (number, optional) \u2014 Width (default: 100)
+    height (number, optional) \u2014 Height (default: 100)
+    rotation (number, optional) \u2014 Rotation in degrees (0-360)
+    opacity (string, optional) \u2014 Opacity (0-1) or variable name
+    visible (boolean, optional) \u2014 Show/hide (default true)
+    locked (boolean, optional) \u2014 Lock/unlock (default false)
+    blendMode (PASS_THROUGH | NORMAL | DARKEN | MULTIPLY | LINEAR_BURN | COLOR_BURN | LIGHTEN | SCREEN | LINEAR_DODGE | COLOR_DODGE | OVERLAY | SOFT_LIGHT | HARD_LIGHT | DIFFERENCE | EXCLUSION | HUE | SATURATION | COLOR | LUMINOSITY, optional)
+    layoutPositioning (AUTO | ABSOLUTE, optional) \u2014 ABSOLUTE = floating inside auto-layout parent
+    fills (array, optional) \u2014 Fill paints array \u2014 e.g. [{type: 'SOLID', color: '#hex'}] or [] for transparent. Primary way to set fills.
+    fillColor (Color, optional) \u2014 Shorthand \u2014 sets a single solid fill (auto-binds to matching variable/style)
+    fillStyleName (string, optional) \u2014 Paint style name for fill
+    fillVariableName (string, optional) \u2014 Color variable by name e.g. 'bg/primary'
+    strokes (array, optional) \u2014 Stroke paints array \u2014 e.g. [{type: 'SOLID', color: '#hex'}] or [] to clear. Primary way to set strokes.
+    strokeColor (Color, optional) \u2014 Shorthand \u2014 sets a single solid stroke (auto-binds to matching variable/style)
+    strokeStyleName (string, optional) \u2014 Paint style name for stroke
+    strokeVariableName (string, optional) \u2014 Color variable by name for stroke
+    strokeWeight (string, optional) \u2014 All sides (number) or variable name (string). Per-side: strokeTopWeight, strokeBottomWeight, strokeLeftWeight, strokeRightWeight.
+    strokeTopWeight (string, optional)
+    strokeBottomWeight (string, optional)
+    strokeLeftWeight (string, optional)
+    strokeRightWeight (string, optional)
+    strokeAlign (INSIDE | OUTSIDE | CENTER, optional) \u2014 Stroke position (default: INSIDE)
+    strokesIncludedInLayout (boolean, optional) \u2014 Include stroke width in layout measurements (default: false)
+    cornerRadius (string, optional) \u2014 All corners (number) or variable name (string). Per-corner: topLeftRadius, topRightRadius, bottomRightRadius, bottomLeftRadius.
+    topLeftRadius (string, optional)
+    topRightRadius (string, optional)
+    bottomRightRadius (string, optional)
+    bottomLeftRadius (string, optional)
+    effectStyleName (string, optional) \u2014 Effect style name (e.g. 'Shadow/Card') for shadows, blurs
+    layoutMode (NONE | HORIZONTAL | VERTICAL, optional) \u2014 Layout direction (default: NONE)
+    layoutWrap (NO_WRAP | WRAP, optional)
+    padding (string, optional) \u2014 All edges (number) or variable name (string). Per-edge: paddingTop, paddingRight, paddingBottom, paddingLeft.
+    paddingTop (string, optional)
+    paddingRight (string, optional)
+    paddingBottom (string, optional)
+    paddingLeft (string, optional)
+    primaryAxisAlignItems (MIN | MAX | CENTER | SPACE_BETWEEN, optional)
+    counterAxisAlignItems (MIN | MAX | CENTER | BASELINE, optional)
+    layoutSizingHorizontal (FIXED | HUG | FILL, optional)
+    layoutSizingVertical (FIXED | HUG | FILL, optional)
+    itemSpacing (string, optional) \u2014 Spacing between children (number or variable name string, default: 0)
+    counterAxisSpacing (string, optional) \u2014 Gap between wrapped rows (requires layoutWrap: WRAP)
+    minWidth (number, optional) \u2014 Min width for responsive auto-layout
+    maxWidth (number, optional) \u2014 Max width for responsive auto-layout
+    minHeight (number, optional) \u2014 Min height for responsive auto-layout
+    maxHeight (number, optional) \u2014 Max height for responsive auto-layout
+    overflowDirection (NONE | HORIZONTAL | VERTICAL | BOTH, optional) \u2014 Scroll overflow in prototype (default: NONE)
+    description (string, optional) \u2014 Component description (shown in Figma's component panel)
+    children (array, optional) \u2014 Inline child nodes. Text: {type:"text", text, componentPropertyName?, fontFamily?, fontSize?, fontColor?}. Frame: {type:"frame", name?, layoutMode?, fillColor?, children?}. Text with componentPropertyName auto-creates and binds a TEXT property \u2014 no need to add it to properties separately.
+    properties (array, optional) \u2014 Component properties to define at creation: [{propertyName, type, defaultValue}]. TEXT properties for inline children with componentPropertyName are created automatically.
+      propertyName (string, required) \u2014 Property name
+      type (BOOLEAN | TEXT | INSTANCE_SWAP, required) \u2014 Property type
+      defaultValue (string_or_boolean, required) \u2014 Default value
+      preferredValues (array, optional) \u2014 Preferred values for INSTANCE_SWAP
+
+  ## from_node \u2014 Convert existing nodes to components. Text children auto-exposed as editable properties (exposeText: true).
+    nodeId (string, required) \u2014 Node ID to convert
+    exposeText (boolean, optional) \u2014 Auto-expose text as editable properties (default: true)
+
+  ## variant_set \u2014 Combine components into a variant set. The resulting set is a frame \u2014 accepts all frame properties for layout/styling.
+    name (string, optional) \u2014 Node name
+    parentId (string, optional) \u2014 Parent node ID. Omit to place on current page.
+    x (number, optional) \u2014 X position (default: 0)
+    y (number, optional) \u2014 Y position (default: 0)
+    width (number, optional) \u2014 Width (default: 100)
+    height (number, optional) \u2014 Height (default: 100)
+    rotation (number, optional) \u2014 Rotation in degrees (0-360)
+    opacity (string, optional) \u2014 Opacity (0-1) or variable name
+    visible (boolean, optional) \u2014 Show/hide (default true)
+    locked (boolean, optional) \u2014 Lock/unlock (default false)
+    blendMode (PASS_THROUGH | NORMAL | DARKEN | MULTIPLY | LINEAR_BURN | COLOR_BURN | LIGHTEN | SCREEN | LINEAR_DODGE | COLOR_DODGE | OVERLAY | SOFT_LIGHT | HARD_LIGHT | DIFFERENCE | EXCLUSION | HUE | SATURATION | COLOR | LUMINOSITY, optional)
+    layoutPositioning (AUTO | ABSOLUTE, optional) \u2014 ABSOLUTE = floating inside auto-layout parent
+    fills (array, optional) \u2014 Fill paints array \u2014 e.g. [{type: 'SOLID', color: '#hex'}] or [] for transparent. Primary way to set fills.
+    fillColor (Color, optional) \u2014 Shorthand \u2014 sets a single solid fill (auto-binds to matching variable/style)
+    fillStyleName (string, optional) \u2014 Paint style name for fill
+    fillVariableName (string, optional) \u2014 Color variable by name e.g. 'bg/primary'
+    strokes (array, optional) \u2014 Stroke paints array \u2014 e.g. [{type: 'SOLID', color: '#hex'}] or [] to clear. Primary way to set strokes.
+    strokeColor (Color, optional) \u2014 Shorthand \u2014 sets a single solid stroke (auto-binds to matching variable/style)
+    strokeStyleName (string, optional) \u2014 Paint style name for stroke
+    strokeVariableName (string, optional) \u2014 Color variable by name for stroke
+    strokeWeight (string, optional) \u2014 All sides (number) or variable name (string). Per-side: strokeTopWeight, strokeBottomWeight, strokeLeftWeight, strokeRightWeight.
+    strokeTopWeight (string, optional)
+    strokeBottomWeight (string, optional)
+    strokeLeftWeight (string, optional)
+    strokeRightWeight (string, optional)
+    strokeAlign (INSIDE | OUTSIDE | CENTER, optional) \u2014 Stroke position (default: INSIDE)
+    strokesIncludedInLayout (boolean, optional) \u2014 Include stroke width in layout measurements (default: false)
+    cornerRadius (string, optional) \u2014 All corners (number) or variable name (string). Per-corner: topLeftRadius, topRightRadius, bottomRightRadius, bottomLeftRadius.
+    topLeftRadius (string, optional)
+    topRightRadius (string, optional)
+    bottomRightRadius (string, optional)
+    bottomLeftRadius (string, optional)
+    effectStyleName (string, optional) \u2014 Effect style name (e.g. 'Shadow/Card') for shadows, blurs
+    layoutMode (NONE | HORIZONTAL | VERTICAL, optional) \u2014 Layout direction (default: NONE)
+    layoutWrap (NO_WRAP | WRAP, optional)
+    padding (string, optional) \u2014 All edges (number) or variable name (string). Per-edge: paddingTop, paddingRight, paddingBottom, paddingLeft.
+    paddingTop (string, optional)
+    paddingRight (string, optional)
+    paddingBottom (string, optional)
+    paddingLeft (string, optional)
+    primaryAxisAlignItems (MIN | MAX | CENTER | SPACE_BETWEEN, optional)
+    counterAxisAlignItems (MIN | MAX | CENTER | BASELINE, optional)
+    layoutSizingHorizontal (FIXED | HUG | FILL, optional)
+    layoutSizingVertical (FIXED | HUG | FILL, optional)
+    itemSpacing (string, optional) \u2014 Spacing between children (number or variable name string, default: 0)
+    counterAxisSpacing (string, optional) \u2014 Gap between wrapped rows (requires layoutWrap: WRAP)
+    minWidth (number, optional) \u2014 Min width for responsive auto-layout
+    maxWidth (number, optional) \u2014 Max width for responsive auto-layout
+    minHeight (number, optional) \u2014 Min height for responsive auto-layout
+    maxHeight (number, optional) \u2014 Max height for responsive auto-layout
+    overflowDirection (NONE | HORIZONTAL | VERTICAL | BOTH, optional) \u2014 Scroll overflow in prototype (default: NONE)
+    componentIds (string[], required) \u2014 Component IDs to combine (min 2)
+    variantPropertyName (string, optional) \u2014 Rename the auto-generated variant property (default: 'Property 1')`,
+      "update": '# components.update\nAdd, edit, or delete component properties\n\nExample: components(method:"update", items:[{id:"1:23", propertyName:"Label", action:"edit", defaultValue:"Click Me"}])\n\nParams:\n    items (UpdatePropertyItem[], required) \u2014 Array of {id, propertyName, action?, type?, defaultValue?, name?, preferredValues?}\n      id (string, required) \u2014 Component or component set ID\n      propertyName (string, required) \u2014 Property name with #suffix for edit/delete (e.g. "Label#1:0"). Call components.get to find exact keys. For add, plain name works.\n      action (add | edit | delete | rename_variant, optional) \u2014 "add" (default): requires type + defaultValue. "edit": pass defaultValue to change default, name to rename property. "delete": just propertyName. "rename_variant": pass defaultValue=current option name, name=new option name.\n      type (BOOLEAN | TEXT | INSTANCE_SWAP | VARIANT, optional) \u2014 Property type (required for add)\n      defaultValue (string_or_boolean, optional) \u2014 Default value (add/edit). For rename_variant: the CURRENT option name to rename\n      name (string, optional) \u2014 New name \u2014 for edit: renames the property itself, for rename_variant: the new option value name\n      preferredValues (array, optional) \u2014 Preferred values for INSTANCE_SWAP\n    depth (number, optional) \u2014 Response detail: omit for id+name only. 0=properties + child stubs. N=recurse N levels. -1=unlimited.',
+      "delete": "# components.delete\nDelete components or component sets\n\nParams:\n    id (string, required) \u2014 Component or component set ID"
+    }
+  },
+  "connection": {
+    "summary": '# connection\nManage the Figma plugin connection.\n\nMethods:\n  create               Join a relay channel (required first step before any other tool) [read]\n  get                  Verify end-to-end connection to Figma [read]\n  list                 Inspect which clients (MCP, plugin) are connected to each channel [read]\n  delete               Disconnect all clients (MCP server and Figma plugin) from a channel and reset its state [edit]\n\n// Connection manages the WebSocket link between the MCP server and the Figma plugin.\n// Channels are named rooms \u2014 both the MCP server and Figma plugin must join the same channel to communicate.\n// Workflow: connection(method:"create") to join a channel \u2192 connection(method:"get") to verify Figma plugin is connected.\n// If get times out (5s), the Figma plugin is not running or not on the same channel.\n// list shows all active channels and their connected clients. delete factory-resets a channel.\n\nUse connection(method: "help", topic: "<method>") for method details.',
+    "methods": {
+      "create": "# connection.create\nJoin a relay channel (required first step before any other tool)\n\nParams:\n    channel (string, optional) \u2014 The channel name displayed in the Figma plugin panel. Defaults to 'vibma' if omitted.",
+      "get": "# connection.get\nVerify end-to-end connection to Figma\n\nNo params.",
+      "list": "# connection.list\nInspect which clients (MCP, plugin) are connected to each channel\n\nNo params.",
+      "delete": "# connection.delete\nDisconnect all clients (MCP server and Figma plugin) from a channel and reset its state\n\nParams:\n    channel (string, optional) \u2014 Channel to reset. Defaults to 'vibma'."
+    }
+  },
+  "document": {
+    "summary": '# document\nNavigate and manage Figma pages (canvases) in the document.\n\nMethods:\n  get                  Get current page with top-level children [read]\n  list                 Get document name and list all pages [read]\n  set                  Switch to a page by ID or name. At least one of pageId or pageName must be provided. [read]\n  create               Create a new page [create]\n  update               Rename a page [edit]\n\n// A Figma document contains pages \u2014 each page is an independent canvas with its own node tree.\n// The "current page" is where all node operations happen. Use document.set to switch pages before working with nodes.\n// Page IDs look like "0:1", "1:1", etc. The first page is always "0:1".\n// get returns the current page with its top-level children as stubs. list returns all pages in the document.\n\nUse document(method: "help", topic: "<method>") for method details.',
+    "methods": {
+      "get": "# document.get\nGet current page with top-level children\n\nNo params.",
+      "list": "# document.list\nGet document name and list all pages\n\nNo params.",
+      "set": "# document.set\nSwitch to a page by ID or name. At least one of pageId or pageName must be provided.\n\nParams:\n    pageId (string, optional) \u2014 Page ID\n    pageName (string, optional) \u2014 Page name (case-insensitive, substring match)",
+      "create": "# document.create\nCreate a new page\n\nParams:\n    name (string, optional) \u2014 Page name (default: 'New Page')",
+      "update": "# document.update\nRename a page\n\nParams:\n    newName (string, required) \u2014 New page name\n    pageId (string, optional) \u2014 Page ID (default: current page)"
+    }
+  },
+  "fonts": {
+    "summary": '# fonts\nSearch available fonts in Figma.\n\nMethods:\n  list                 List available font families, optionally filtered by name [read]\n\n// Returns font family names installed in the Figma environment. Use to verify a fontFamily before text.create or styles.create.\n// query filters by family name substring (case-insensitive), e.g. query:"inter" matches "Inter", "Inter Tight".\n// ---\n// Default response: just family names. Set includeStyles:true to also get available styles per family (e.g. "Regular", "Bold", "Italic").\n// Use fonts.list with query to narrow results before creating text with specific fontFamily + fontStyle.\n\nUse fonts(method: "help", topic: "<method>") for method details.',
+    "methods": {
+      "list": '# fonts.list\nList available font families, optionally filtered by name\n\nExample: fonts(method:"list", query:"inter")\n\nParams:\n    query (string, optional) \u2014 Filter by family name (case-insensitive substring)\n    includeStyles (boolean, optional) \u2014 Include available styles per family (default: false)\n    offset (number, optional) \u2014 Skip N items for pagination (default 0)\n    limit (number, optional) \u2014 Max items per page (default 100)'
+    }
+  },
+  "frames": {
+    "summary": '# frames\nCreate and manage frames, shapes, auto-layout containers, sections, and SVG nodes.\n\nMethods:\n  get                  Get serialized node data [read]\n  list                 Search for nodes (returns stubs only \u2014 use get with depth for full properties) [read]\n  update               Patch node properties [edit]\n  delete               Delete nodes [edit]\n  clone                Duplicate nodes [create]\n  audit                Run lint on a node \u2014 returns severity-ranked findings [read]\n  reparent             Move nodes into a new parent [edit]\n  create               Create frame-like containers [create]\n  export               Export a node as PNG, JPG, SVG, SVG_STRING, or PDF [read]\n\n// depth: omit \u2192 id+name stubs | 0 \u2192 props + child stubs | N \u2192 recurse N | -1 \u2192 full tree\n// fields: whitelist e.g. ["fills","opacity"] \u2014 id, name, type always included. Pass ["*"] for all.\n// layoutSizingHorizontal/Vertical: FIXED | HUG | FILL \u2014 how the node sizes within auto-layout.\n// Colors: fillVariableName/strokeVariableName bind by name \u2014 preferred over raw color values.\n// Note: node-based endpoints (frames, text, instances, components) use `results` as the list key.\n//   Standalone endpoints (styles, variables, variable_collections) use `items`. Components.list uses `items` (catalog view).\n// ---\n// visible: false hides the node. Omitted from response when true (the default).\n// locked: true prevents editing in Figma UI. Omitted when false (the default).\n// rotation: degrees (0-360). Omitted when 0.\n// blendMode: layer blend mode. Omitted when PASS_THROUGH (the default).\n// layoutPositioning: ABSOLUTE = floating inside auto-layout parent. Omitted when AUTO (the default).\n// minWidth/maxWidth/minHeight/maxHeight: responsive constraints for auto-layout children.\n// constraints: position behavior in non-auto-layout parents. Ignored inside auto-layout frames.\n// bindings: bind design variables to node properties. field uses slash path: "fills/0/color" (first fill), "strokes/0/color", "opacity", "width", "height", "cornerRadius", "paddingLeft", "itemSpacing".\n// explicitMode: pin a variable mode on this node. Use { collectionName, modeName } (preferred) or { collectionId, modeId }.\n// properties: escape hatch \u2014 set any Figma node property directly. Use only when no dedicated field exists.\ninterface Node {\n  id: string; name: string; type: string;\n  visible?: boolean;       // omitted when true\n  locked?: boolean;        // omitted when false\n  opacity?: number;        // omitted when 1\n  rotation?: number;       // omitted when 0\n  blendMode?: string;      // omitted when PASS_THROUGH\n  layoutPositioning?: "AUTO" | "ABSOLUTE";\n  layoutSizingHorizontal?: "FIXED" | "HUG" | "FILL";\n  layoutSizingVertical?: "FIXED" | "HUG" | "FILL";\n  minWidth?: number; maxWidth?: number; minHeight?: number; maxHeight?: number;\n  absoluteBoundingBox: { x: number; y: number; width: number; height: number };\n  fills?: Paint[];         // solid: {type: "SOLID", color: {r, g, b, a}}\n  strokes?: Paint[];\n  effects?: Effect[];      // DROP_SHADOW | INNER_SHADOW | LAYER_BLUR | BACKGROUND_BLUR\n  children?: NodeStub[];   // stubs: {id, name, type} \u2014 use depth to expand\n}\n// PatchItem uses flat params matching create shape \u2014 no nested sub-objects.\n// Fill/stroke/corner/layout/text params are identical to frames.create and text.create.\n// Unknown keys produce a warning, preventing silent failures.\n// Frames are the primary container in Figma. Use auto_layout for responsive containers.\n// Sizing: FIXED = explicit size, HUG = shrink to children, FILL = expand to fill parent.\n// Fill: pass fills:[{type:"SOLID", color:"#hex"}] or [] for transparent. Shorthand: fillColor:"#3B82F6" (auto-binds to matching variable/style).\n// Also: fillVariableName:"bg/primary", fillStyleName:"Surface/Primary".\n// Stroke: pass strokes:[{type:"SOLID", color:"#hex"}] or [] to clear. Shorthand: strokeColor:"#000", strokeVariableName:"border/default".\n// Token fields (cornerRadius, opacity, itemSpacing, padding, strokeWeight): pass number for value, string for variable name/ID.\n// ---\n// SIZING: Always think about both axes. Containers with text need a width constraint \u2014 set width + layoutSizingHorizontal:"FIXED".\n//   HUG/HUG is only correct for intrinsically-sized elements (buttons, badges, icons).\n//   Smart defaults inside auto-layout parent: cross-axis defaults to FILL, primary axis stays HUG.\n//   FILL only works inside an auto-layout parent. Use FIXED for top-level frames.\n// minWidth/maxWidth/minHeight/maxHeight: responsive constraints for auto-layout children.\n// clipsContent: true (default) clips children to the frame bounds. Set false for overflow-visible.\n// Sections are top-level organizers (like artboards) \u2014 they cannot be nested inside frames.\n// Shape primitives: rectangle, ellipse, line \u2014 for decorative/visual elements (not containers).\n// group: wraps existing nodes into a Group. boolean_operation: UNION/SUBTRACT/INTERSECT/EXCLUDE combines shapes.\n// SVG create: pass raw SVG markup string (e.g. "<svg>...</svg>") \u2014 Figma converts it to vector nodes.\n\nUse frames(method: "help", topic: "<method>") for method details.',
+    "methods": {
+      "get": '# frames.get\nGet serialized node data\n\nParams:\n    id (string, required) \u2014 Node ID\n    fields (string[], optional) \u2014 Property whitelist. Identity fields (id, name, type) always included. Omit for stubs on list, full on get. Pass ["*"] for all.\n    depth (number, optional) \u2014 Response detail: omit for id+name only. 0=properties + child stubs. N=recurse N levels. -1=unlimited.\n    verbose (boolean, optional) \u2014 Include all properties (bounding box, constraints, text style details). Default false \u2014 returns slim, actionable output.',
+      "list": '# frames.list\nSearch for nodes (returns stubs only \u2014 use get with depth for full properties)\n\nParams:\n    query (string, optional) \u2014 Name search query (case-insensitive substring match)\n    types (string[], optional) \u2014 Filter by node types (e.g. ["FRAME", "TEXT"])\n    parentId (string, optional) \u2014 Search only within this subtree\n    fields (string[], optional) \u2014 Property whitelist. Identity fields (id, name, type) always included. Omit for stubs on list, full on get. Pass ["*"] for all.\n    offset (number, optional) \u2014 Skip N items for pagination (default 0)\n    limit (number, optional) \u2014 Max items per page (default 100)',
+      "update": `# frames.update
+Patch node properties
+
+Params:
+    items (PatchItem[], required) \u2014 Array of {id, ...properties} to patch
+      fills (array, optional) \u2014 Fill paints array \u2014 e.g. [{type: 'SOLID', color: '#hex'}] or [] for transparent. Primary way to set fills.
+      fillColor (Color, optional) \u2014 Shorthand \u2014 sets a single solid fill (auto-binds to matching variable/style)
+      fillStyleName (string, optional) \u2014 Paint style name for fill
+      fillVariableName (string, optional) \u2014 Color variable by name e.g. 'bg/primary'
+      strokes (array, optional) \u2014 Stroke paints array \u2014 e.g. [{type: 'SOLID', color: '#hex'}] or [] to clear. Primary way to set strokes.
+      strokeColor (Color, optional) \u2014 Shorthand \u2014 sets a single solid stroke (auto-binds to matching variable/style)
+      strokeStyleName (string, optional) \u2014 Paint style name for stroke
+      strokeVariableName (string, optional) \u2014 Color variable by name for stroke
+      strokeWeight (string, optional) \u2014 All sides (number) or variable name (string). Per-side: strokeTopWeight, strokeBottomWeight, strokeLeftWeight, strokeRightWeight.
+      strokeTopWeight (string, optional)
+      strokeBottomWeight (string, optional)
+      strokeLeftWeight (string, optional)
+      strokeRightWeight (string, optional)
+      strokeAlign (INSIDE | OUTSIDE | CENTER, optional) \u2014 Stroke position (default: INSIDE)
+      strokesIncludedInLayout (boolean, optional) \u2014 Include stroke width in layout measurements (default: false)
+      cornerRadius (string, optional) \u2014 All corners (number) or variable name (string). Per-corner: topLeftRadius, topRightRadius, bottomRightRadius, bottomLeftRadius.
+      topLeftRadius (string, optional)
+      topRightRadius (string, optional)
+      bottomRightRadius (string, optional)
+      bottomLeftRadius (string, optional)
+      opacity (string, optional) \u2014 Opacity (0-1) or variable name
+      visible (boolean, optional) \u2014 Show/hide (default true)
+      locked (boolean, optional) \u2014 Lock/unlock (default false)
+      blendMode (PASS_THROUGH | NORMAL | DARKEN | MULTIPLY | LINEAR_BURN | COLOR_BURN | LIGHTEN | SCREEN | LINEAR_DODGE | COLOR_DODGE | OVERLAY | SOFT_LIGHT | HARD_LIGHT | DIFFERENCE | EXCLUSION | HUE | SATURATION | COLOR | LUMINOSITY, optional)
+      effectStyleName (string, optional) \u2014 Effect style name (e.g. 'Shadow/Card') for shadows, blurs
+      layoutMode (NONE | HORIZONTAL | VERTICAL, optional) \u2014 Layout direction (default: NONE)
+      layoutWrap (NO_WRAP | WRAP, optional)
+      padding (string, optional) \u2014 All edges (number) or variable name (string). Per-edge: paddingTop, paddingRight, paddingBottom, paddingLeft.
+      paddingTop (string, optional)
+      paddingRight (string, optional)
+      paddingBottom (string, optional)
+      paddingLeft (string, optional)
+      primaryAxisAlignItems (MIN | MAX | CENTER | SPACE_BETWEEN, optional)
+      counterAxisAlignItems (MIN | MAX | CENTER | BASELINE, optional)
+      itemSpacing (string, optional) \u2014 Spacing between children (number or variable name string, default: 0)
+      counterAxisSpacing (string, optional) \u2014 Gap between wrapped rows (requires layoutWrap: WRAP)
+      layoutSizingHorizontal (FIXED | HUG | FILL, optional)
+      layoutSizingVertical (FIXED | HUG | FILL, optional)
+      layoutPositioning (AUTO | ABSOLUTE, optional) \u2014 ABSOLUTE = floating inside auto-layout parent
+      minWidth (number, optional) \u2014 Min width for responsive auto-layout
+      maxWidth (number, optional) \u2014 Max width for responsive auto-layout
+      minHeight (number, optional) \u2014 Min height for responsive auto-layout
+      maxHeight (number, optional) \u2014 Max height for responsive auto-layout
+      fontSize (number, optional) \u2014 Font size
+      fontFamily (string, optional) \u2014 Font family
+      fontStyle (string, optional) \u2014 Font variant e.g. "Bold", "Italic" \u2014 overrides fontWeight
+      fontWeight (number, optional) \u2014 100-900. Ignored when fontStyle is set.
+      fontColor (Color, optional) \u2014 Shorthand \u2014 sets text color (auto-binds to matching variable/style)
+      fontColorVariableName (string, optional) \u2014 Bind color variable by name e.g. 'text/primary'
+      fontColorStyleName (string, optional) \u2014 Apply paint style \u2014 overrides fontColor
+      textStyleId (string, optional) \u2014 Apply text style by ID \u2014 overrides fontSize/fontWeight
+      textStyleName (string, optional) \u2014 Text style by name (case-insensitive)
+      textAlignHorizontal (LEFT | CENTER | RIGHT | JUSTIFIED, optional)
+      textAlignVertical (TOP | CENTER | BOTTOM, optional)
+      textAutoResize (NONE | WIDTH_AND_HEIGHT | HEIGHT | TRUNCATE, optional)
+      id (string, required)
+      name (string, optional) \u2014 Rename node
+      rotation (number, optional) \u2014 Degrees (0-360)
+      x (number, optional)
+      y (number, optional)
+      width (number, optional)
+      height (number, optional)
+      clearFill (boolean, optional) \u2014 Remove all fills
+      effects (array, optional) \u2014 Effect array (DROP_SHADOW, INNER_SHADOW, LAYER_BLUR, BACKGROUND_BLUR)
+      overflowDirection (NONE | HORIZONTAL | VERTICAL | BOTH, optional) \u2014 Scroll overflow in prototype (default: NONE)
+      constraints (object, optional)
+      bindings (array, optional) \u2014 Bind variables to properties. field path examples: 'fills/0/color', 'strokes/0/color', 'opacity', 'width', 'cornerRadius', 'itemSpacing'.
+        field (string, required)
+        variableName (string, optional)
+        variableId (string, optional)
+      explicitMode (object, optional) \u2014 Pin variable mode \u2014 use { collectionName, modeName } (preferred) or { collectionId, modeId }
+      exportSettings (array, optional) \u2014 Export settings
+      properties (object, optional) \u2014 Direct Figma API props (escape hatch)`,
+      "delete": "# frames.delete\nDelete nodes\n\nParams:\n    id (string, optional) \u2014 Single node ID\n    items (array, optional) \u2014 Batch: [{id}, ...]\n      id (string, optional)",
+      "clone": "# frames.clone\nDuplicate nodes\n\nParams:\n    id (string, required) \u2014 Node ID\n    parentId (string, optional) \u2014 Parent node ID. Omit to place on current page.\n    x (number, optional) \u2014 X position (default: 0)\n    y (number, optional) \u2014 Y position (default: 0)\n    depth (number, optional) \u2014 Response detail: omit for id+name only. 0=properties + child stubs. N=recurse N levels. -1=unlimited.",
+      "audit": '# frames.audit\nRun lint on a node \u2014 returns severity-ranked findings\n\nParams:\n    id (string, required) \u2014 Node ID to audit\n    rules (string[], optional) \u2014 Rules to check. Default: ["all"]. Categories: "component", "composition", "token", "naming", "wcag".\n    maxDepth (number, optional) \u2014 Max tree depth (default: 10)\n    maxFindings (number, optional) \u2014 Max findings (default: 50)',
+      "reparent": "# frames.reparent\nMove nodes into a new parent\n\nParams:\n    items (array, required) \u2014 Array of {id, parentId, index?}\n      id (string, required)\n      parentId (string, required)\n      index (number, optional)",
+      "create": `# frames.create
+Create frame-like containers
+
+Example: frames(method:"create", type:"auto_layout", layoutMode:"VERTICAL", itemSpacing:16, padding:24)
+
+Discriminant: type (frame | auto_layout | section | rectangle | ellipse | line | group | boolean_operation | svg)
+
+  ## frame \u2014 Static frame with fixed dimensions
+    name (string, optional) \u2014 Node name
+    parentId (string, optional) \u2014 Parent node ID. Omit to place on current page.
+    x (number, optional) \u2014 X position (default: 0)
+    y (number, optional) \u2014 Y position (default: 0)
+    width (number, optional) \u2014 Width (default: 100)
+    height (number, optional) \u2014 Height (default: 100)
+    rotation (number, optional) \u2014 Rotation in degrees (0-360)
+    opacity (string, optional) \u2014 Opacity (0-1) or variable name
+    visible (boolean, optional) \u2014 Show/hide (default true)
+    locked (boolean, optional) \u2014 Lock/unlock (default false)
+    blendMode (PASS_THROUGH | NORMAL | DARKEN | MULTIPLY | LINEAR_BURN | COLOR_BURN | LIGHTEN | SCREEN | LINEAR_DODGE | COLOR_DODGE | OVERLAY | SOFT_LIGHT | HARD_LIGHT | DIFFERENCE | EXCLUSION | HUE | SATURATION | COLOR | LUMINOSITY, optional)
+    layoutPositioning (AUTO | ABSOLUTE, optional) \u2014 ABSOLUTE = floating inside auto-layout parent
+    fills (array, optional) \u2014 Fill paints array \u2014 e.g. [{type: 'SOLID', color: '#hex'}] or [] for transparent. Primary way to set fills.
+    fillColor (Color, optional) \u2014 Shorthand \u2014 sets a single solid fill (auto-binds to matching variable/style)
+    fillStyleName (string, optional) \u2014 Paint style name for fill
+    fillVariableName (string, optional) \u2014 Color variable by name e.g. 'bg/primary'
+    strokes (array, optional) \u2014 Stroke paints array \u2014 e.g. [{type: 'SOLID', color: '#hex'}] or [] to clear. Primary way to set strokes.
+    strokeColor (Color, optional) \u2014 Shorthand \u2014 sets a single solid stroke (auto-binds to matching variable/style)
+    strokeStyleName (string, optional) \u2014 Paint style name for stroke
+    strokeVariableName (string, optional) \u2014 Color variable by name for stroke
+    strokeWeight (string, optional) \u2014 All sides (number) or variable name (string). Per-side: strokeTopWeight, strokeBottomWeight, strokeLeftWeight, strokeRightWeight.
+    strokeTopWeight (string, optional)
+    strokeBottomWeight (string, optional)
+    strokeLeftWeight (string, optional)
+    strokeRightWeight (string, optional)
+    strokeAlign (INSIDE | OUTSIDE | CENTER, optional) \u2014 Stroke position (default: INSIDE)
+    strokesIncludedInLayout (boolean, optional) \u2014 Include stroke width in layout measurements (default: false)
+    cornerRadius (string, optional) \u2014 All corners (number) or variable name (string). Per-corner: topLeftRadius, topRightRadius, bottomRightRadius, bottomLeftRadius.
+    topLeftRadius (string, optional)
+    topRightRadius (string, optional)
+    bottomRightRadius (string, optional)
+    bottomLeftRadius (string, optional)
+    effectStyleName (string, optional) \u2014 Effect style name (e.g. 'Shadow/Card') for shadows, blurs
+    layoutMode (NONE | HORIZONTAL | VERTICAL, optional) \u2014 Layout direction (default: NONE)
+    layoutWrap (NO_WRAP | WRAP, optional)
+    padding (string, optional) \u2014 All edges (number) or variable name (string). Per-edge: paddingTop, paddingRight, paddingBottom, paddingLeft.
+    paddingTop (string, optional)
+    paddingRight (string, optional)
+    paddingBottom (string, optional)
+    paddingLeft (string, optional)
+    primaryAxisAlignItems (MIN | MAX | CENTER | SPACE_BETWEEN, optional)
+    counterAxisAlignItems (MIN | MAX | CENTER | BASELINE, optional)
+    layoutSizingHorizontal (FIXED | HUG | FILL, optional)
+    layoutSizingVertical (FIXED | HUG | FILL, optional)
+    itemSpacing (string, optional) \u2014 Spacing between children (number or variable name string, default: 0)
+    counterAxisSpacing (string, optional) \u2014 Gap between wrapped rows (requires layoutWrap: WRAP)
+    minWidth (number, optional) \u2014 Min width for responsive auto-layout
+    maxWidth (number, optional) \u2014 Max width for responsive auto-layout
+    minHeight (number, optional) \u2014 Min height for responsive auto-layout
+    maxHeight (number, optional) \u2014 Max height for responsive auto-layout
+    overflowDirection (NONE | HORIZONTAL | VERTICAL | BOTH, optional) \u2014 Scroll overflow in prototype (default: NONE)
+    clipsContent (boolean, optional)
+
+  ## auto_layout \u2014 Auto-layout frame that arranges children automatically
+    name (string, optional) \u2014 Node name
+    parentId (string, optional) \u2014 Parent node ID. Omit to place on current page.
+    x (number, optional) \u2014 X position (default: 0)
+    y (number, optional) \u2014 Y position (default: 0)
+    width (number, optional) \u2014 Width (default: 100)
+    height (number, optional) \u2014 Height (default: 100)
+    rotation (number, optional) \u2014 Rotation in degrees (0-360)
+    opacity (string, optional) \u2014 Opacity (0-1) or variable name
+    visible (boolean, optional) \u2014 Show/hide (default true)
+    locked (boolean, optional) \u2014 Lock/unlock (default false)
+    blendMode (PASS_THROUGH | NORMAL | DARKEN | MULTIPLY | LINEAR_BURN | COLOR_BURN | LIGHTEN | SCREEN | LINEAR_DODGE | COLOR_DODGE | OVERLAY | SOFT_LIGHT | HARD_LIGHT | DIFFERENCE | EXCLUSION | HUE | SATURATION | COLOR | LUMINOSITY, optional)
+    layoutPositioning (AUTO | ABSOLUTE, optional) \u2014 ABSOLUTE = floating inside auto-layout parent
+    fills (array, optional) \u2014 Fill paints array \u2014 e.g. [{type: 'SOLID', color: '#hex'}] or [] for transparent. Primary way to set fills.
+    fillColor (Color, optional) \u2014 Shorthand \u2014 sets a single solid fill (auto-binds to matching variable/style)
+    fillStyleName (string, optional) \u2014 Paint style name for fill
+    fillVariableName (string, optional) \u2014 Color variable by name e.g. 'bg/primary'
+    strokes (array, optional) \u2014 Stroke paints array \u2014 e.g. [{type: 'SOLID', color: '#hex'}] or [] to clear. Primary way to set strokes.
+    strokeColor (Color, optional) \u2014 Shorthand \u2014 sets a single solid stroke (auto-binds to matching variable/style)
+    strokeStyleName (string, optional) \u2014 Paint style name for stroke
+    strokeVariableName (string, optional) \u2014 Color variable by name for stroke
+    strokeWeight (string, optional) \u2014 All sides (number) or variable name (string). Per-side: strokeTopWeight, strokeBottomWeight, strokeLeftWeight, strokeRightWeight.
+    strokeTopWeight (string, optional)
+    strokeBottomWeight (string, optional)
+    strokeLeftWeight (string, optional)
+    strokeRightWeight (string, optional)
+    strokeAlign (INSIDE | OUTSIDE | CENTER, optional) \u2014 Stroke position (default: INSIDE)
+    strokesIncludedInLayout (boolean, optional) \u2014 Include stroke width in layout measurements (default: false)
+    cornerRadius (string, optional) \u2014 All corners (number) or variable name (string). Per-corner: topLeftRadius, topRightRadius, bottomRightRadius, bottomLeftRadius.
+    topLeftRadius (string, optional)
+    topRightRadius (string, optional)
+    bottomRightRadius (string, optional)
+    bottomLeftRadius (string, optional)
+    effectStyleName (string, optional) \u2014 Effect style name (e.g. 'Shadow/Card') for shadows, blurs
+    layoutMode (HORIZONTAL | VERTICAL, required) \u2014 Primary axis direction
+    layoutWrap (NO_WRAP | WRAP, optional)
+    padding (string, optional) \u2014 All edges (number) or variable name (string). Per-edge: paddingTop, paddingRight, paddingBottom, paddingLeft.
+    paddingTop (string, optional)
+    paddingRight (string, optional)
+    paddingBottom (string, optional)
+    paddingLeft (string, optional)
+    primaryAxisAlignItems (MIN | MAX | CENTER | SPACE_BETWEEN, optional)
+    counterAxisAlignItems (MIN | MAX | CENTER | BASELINE, optional)
+    layoutSizingHorizontal (FIXED | HUG | FILL, optional)
+    layoutSizingVertical (FIXED | HUG | FILL, optional)
+    itemSpacing (string, optional) \u2014 Spacing between children (number or variable name string, default: 0)
+    counterAxisSpacing (string, optional) \u2014 Gap between wrapped rows (requires layoutWrap: WRAP)
+    minWidth (number, optional) \u2014 Min width for responsive auto-layout
+    maxWidth (number, optional) \u2014 Max width for responsive auto-layout
+    minHeight (number, optional) \u2014 Min height for responsive auto-layout
+    maxHeight (number, optional) \u2014 Max height for responsive auto-layout
+    overflowDirection (NONE | HORIZONTAL | VERTICAL | BOTH, optional) \u2014 Scroll overflow in prototype (default: NONE)
+    clipsContent (boolean, optional)
+    nodeIds (string[], optional) \u2014 Existing node IDs to wrap into auto-layout
+
+  ## section \u2014 Figma section (top-level organizer)
+    name (string, required) \u2014 Section name
+    parentId (string, optional) \u2014 Parent node ID. Omit to place on current page.
+    x (number, optional) \u2014 X position (default: 0)
+    y (number, optional) \u2014 Y position (default: 0)
+    width (number, optional) \u2014 Width (default: 500)
+    height (number, optional) \u2014 Height (default: 500)
+    fills (array, optional) \u2014 Fill paints array \u2014 e.g. [{type: 'SOLID', color: '#hex'}] or [] for transparent
+    fillColor (Color, optional) \u2014 Shorthand \u2014 sets a single solid fill (auto-binds to matching variable/style)
+    fillStyleName (string, optional) \u2014 Paint style name for fill
+    fillVariableName (string, optional) \u2014 Color variable by name e.g. 'bg/primary'
+
+  ## rectangle \u2014 Rectangle shape node
+    name (string, optional) \u2014 Layer name (default: 'Rectangle')
+    parentId (string, optional) \u2014 Parent node ID. Omit to place on current page.
+    x (number, optional) \u2014 X position (default: 0)
+    y (number, optional) \u2014 Y position (default: 0)
+    width (number, optional) \u2014 Width in px (default: 100)
+    height (number, optional) \u2014 Height in px (default: 100)
+    fills (array, optional) \u2014 Fill paints array \u2014 e.g. [{type: 'SOLID', color: '#hex'}] or [] for transparent
+    fillColor (Color, optional) \u2014 Shorthand \u2014 sets a single solid fill (auto-binds to matching variable/style)
+    fillStyleName (string, optional) \u2014 Paint style name for fill
+    fillVariableName (string, optional) \u2014 Color variable by name e.g. 'bg/primary'
+    strokes (array, optional) \u2014 Stroke paints array \u2014 e.g. [{type: 'SOLID', color: '#hex'}] or [] to clear
+    strokeColor (Color, optional) \u2014 Shorthand \u2014 sets a single solid stroke (auto-binds to matching variable/style)
+    strokeVariableName (string, optional) \u2014 Color variable by name for stroke
+    strokeWeight (string, optional)
+    cornerRadius (string, optional) \u2014 All corners (number) or variable name (string). Per-corner: topLeftRadius, topRightRadius, bottomRightRadius, bottomLeftRadius.
+    topLeftRadius (string, optional)
+    topRightRadius (string, optional)
+    bottomRightRadius (string, optional)
+    bottomLeftRadius (string, optional)
+    opacity (string, optional)
+    layoutSizingHorizontal (FIXED | FILL, optional) \u2014 Horizontal sizing in auto-layout parent
+    layoutSizingVertical (FIXED | FILL, optional) \u2014 Vertical sizing in auto-layout parent
+
+  ## ellipse \u2014 Ellipse/circle shape node
+    name (string, optional) \u2014 Layer name (default: 'Ellipse')
+    parentId (string, optional) \u2014 Parent node ID. Omit to place on current page.
+    x (number, optional) \u2014 X position (default: 0)
+    y (number, optional) \u2014 Y position (default: 0)
+    width (number, optional) \u2014 Width in px (default: 100)
+    height (number, optional) \u2014 Height in px (default: 100, same as width for circle)
+    fills (array, optional) \u2014 Fill paints array \u2014 e.g. [{type: 'SOLID', color: '#hex'}] or [] for transparent
+    fillColor (Color, optional) \u2014 Shorthand \u2014 sets a single solid fill (auto-binds to matching variable/style)
+    fillStyleName (string, optional) \u2014 Paint style name for fill
+    fillVariableName (string, optional) \u2014 Color variable by name e.g. 'bg/primary'
+    strokes (array, optional) \u2014 Stroke paints array \u2014 e.g. [{type: 'SOLID', color: '#hex'}] or [] to clear
+    strokeColor (Color, optional) \u2014 Shorthand \u2014 sets a single solid stroke (auto-binds to matching variable/style)
+    strokeVariableName (string, optional) \u2014 Color variable by name for stroke
+    strokeWeight (string, optional)
+    opacity (string, optional)
+    layoutSizingHorizontal (FIXED | FILL, optional) \u2014 Horizontal sizing in auto-layout parent
+    layoutSizingVertical (FIXED | FILL, optional) \u2014 Vertical sizing in auto-layout parent
+
+  ## line \u2014 Line shape node
+    name (string, optional) \u2014 Layer name (default: 'Line')
+    parentId (string, optional) \u2014 Parent node ID. Omit to place on current page.
+    x (number, optional) \u2014 X position (default: 0)
+    y (number, optional) \u2014 Y position (default: 0)
+    length (number, optional) \u2014 Line length in px (default: 100)
+    rotation (number, optional) \u2014 Rotation in degrees (default: 0 = horizontal)
+    strokes (array, optional) \u2014 Stroke paints array \u2014 e.g. [{type: 'SOLID', color: '#hex'}] or [] to clear
+    strokeColor (Color, optional) \u2014 Line color (default: black, auto-binds to matching variable/style)
+    strokeVariableName (string, optional) \u2014 Color variable by name for stroke
+    strokeWeight (string, optional) \u2014 Line thickness (default: 1)
+    opacity (string, optional)
+    layoutSizingHorizontal (FIXED | FILL, optional) \u2014 Horizontal sizing in auto-layout parent (defaults to FILL in vertical auto-layout)
+
+  ## group \u2014 Group existing nodes together
+    nodeIds (string[], required) \u2014 Node IDs to group (min 1)
+    name (string, optional) \u2014 Group name
+    parentId (string, optional) \u2014 Parent node ID. Omit to place on current page.
+
+  ## boolean_operation \u2014 Combine shapes with boolean operations (union, subtract, intersect, exclude)
+    operation (UNION | SUBTRACT | INTERSECT | EXCLUDE, required) \u2014 Boolean operation type
+    nodeIds (string[], required) \u2014 Node IDs to combine (min 2, first node is the base for SUBTRACT)
+    name (string, optional) \u2014 Result node name
+    parentId (string, optional) \u2014 Parent node ID. Omit to place on current page.
+
+  ## svg \u2014 Create node from SVG markup
+    svg (string, required) \u2014 SVG markup string
+    name (string, optional) \u2014 Layer name (default: 'SVG')
+    parentId (string, optional) \u2014 Parent node ID. Omit to place on current page.
+    x (number, optional) \u2014 X position (default: 0)
+    y (number, optional) \u2014 Y position (default: 0)
+    fillStyleName (string, optional) \u2014 Paint style to apply to vector fills
+    fillVariableName (string, optional) \u2014 Color variable by name for vector fills
+    strokeStyleName (string, optional) \u2014 Paint style to apply to vector strokes
+    strokeVariableName (string, optional) \u2014 Color variable by name for vector strokes`,
+      "export": "# frames.export\nExport a node as PNG, JPG, SVG, SVG_STRING, or PDF\n\nParams:\n    id (string, required) \u2014 Node ID to export\n    format (PNG | JPG | SVG | SVG_STRING | PDF, optional) \u2014 Export format (default: PNG). SVG_STRING returns raw SVG text.\n    scale (number, optional) \u2014 Export scale (default: 1, only for PNG/JPG)"
+    }
+  },
+  "instances": {
+    "summary": '# instances\nCreate and manage component instances.\n\nMethods:\n  list                 Search for nodes (returns stubs only \u2014 use get with depth for full properties) [read]\n  delete               Delete nodes [edit]\n  clone                Duplicate nodes [create]\n  audit                Run lint on a node \u2014 returns severity-ranked findings [read]\n  reparent             Move nodes into a new parent [edit]\n  get                  Get instance detail with component properties and overrides [read]\n  create               Create component instances [create]\n  update               Set instance properties [edit]\n  swap                 Swap instance component (preserves overrides) [edit]\n  detach               Detach instances from their component (converts to frame) [edit]\n  reset_overrides      Reset all overrides on instances to match their main component [edit]\n\n// depth: omit \u2192 id+name stubs | 0 \u2192 props + child stubs | N \u2192 recurse N | -1 \u2192 full tree\n// fields: whitelist e.g. ["fills","opacity"] \u2014 id, name, type always included. Pass ["*"] for all.\n// layoutSizingHorizontal/Vertical: FIXED | HUG | FILL \u2014 how the node sizes within auto-layout.\n// Colors: fillVariableName/strokeVariableName bind by name \u2014 preferred over raw color values.\n// Note: node-based endpoints (frames, text, instances, components) use `results` as the list key.\n//   Standalone endpoints (styles, variables, variable_collections) use `items`. Components.list uses `items` (catalog view).\n// ---\n// visible: false hides the node. Omitted from response when true (the default).\n// locked: true prevents editing in Figma UI. Omitted when false (the default).\n// rotation: degrees (0-360). Omitted when 0.\n// blendMode: layer blend mode. Omitted when PASS_THROUGH (the default).\n// layoutPositioning: ABSOLUTE = floating inside auto-layout parent. Omitted when AUTO (the default).\n// minWidth/maxWidth/minHeight/maxHeight: responsive constraints for auto-layout children.\n// constraints: position behavior in non-auto-layout parents. Ignored inside auto-layout frames.\n// bindings: bind design variables to node properties. field uses slash path: "fills/0/color" (first fill), "strokes/0/color", "opacity", "width", "height", "cornerRadius", "paddingLeft", "itemSpacing".\n// explicitMode: pin a variable mode on this node. Use { collectionName, modeName } (preferred) or { collectionId, modeId }.\n// properties: escape hatch \u2014 set any Figma node property directly. Use only when no dedicated field exists.\ninterface Node {\n  id: string; name: string; type: string;\n  visible?: boolean;       // omitted when true\n  locked?: boolean;        // omitted when false\n  opacity?: number;        // omitted when 1\n  rotation?: number;       // omitted when 0\n  blendMode?: string;      // omitted when PASS_THROUGH\n  layoutPositioning?: "AUTO" | "ABSOLUTE";\n  layoutSizingHorizontal?: "FIXED" | "HUG" | "FILL";\n  layoutSizingVertical?: "FIXED" | "HUG" | "FILL";\n  minWidth?: number; maxWidth?: number; minHeight?: number; maxHeight?: number;\n  absoluteBoundingBox: { x: number; y: number; width: number; height: number };\n  fills?: Paint[];         // solid: {type: "SOLID", color: {r, g, b, a}}\n  strokes?: Paint[];\n  effects?: Effect[];      // DROP_SHADOW | INNER_SHADOW | LAYER_BLUR | BACKGROUND_BLUR\n  children?: NodeStub[];   // stubs: {id, name, type} \u2014 use depth to expand\n}\n// PatchItem uses flat params matching create shape \u2014 no nested sub-objects.\n// Fill/stroke/corner/layout/text params are identical to frames.create and text.create.\n// Unknown keys produce a warning, preventing silent failures.\n// Instances are linked copies of components. Changes to the component propagate to all instances.\n// Overrides: instance-level changes (text, fills, visibility) that differ from the component. Shown in overrides array.\n// variantProperties: when creating from a component set, pick which variant e.g. {"Style":"Secondary","Size":"Large"}.\n// ---\n// Property keys: read returns clean names ("Label"), write requires the #suffix ("Label#1:0"). Call instances.get(id) to discover exact keys before update.\n// swap: change which component an instance points to while preserving compatible overrides.\n// detach: permanently converts an instance to a regular frame, breaking the component link.\n// reset_overrides: reverts all instance overrides to match the main component.\n// Workflow: components.list \u2192 instances.create with componentId + properties (one call). No separate update needed for text/boolean overrides.\n// Instances support frame-level overrides: layoutSizingHorizontal/Vertical (FIXED, FILL, HUG), opacity, width/height, min/max.\n// Use layoutSizingHorizontal: "FILL" to make instances stretch in auto-layout parents.\n\nUse instances(method: "help", topic: "<method>") for method details.',
+    "methods": {
+      "list": '# instances.list\nSearch for nodes (returns stubs only \u2014 use get with depth for full properties)\n\nParams:\n    query (string, optional) \u2014 Name search query (case-insensitive substring match)\n    types (string[], optional) \u2014 Filter by node types (e.g. ["FRAME", "TEXT"])\n    parentId (string, optional) \u2014 Search only within this subtree\n    fields (string[], optional) \u2014 Property whitelist. Identity fields (id, name, type) always included. Omit for stubs on list, full on get. Pass ["*"] for all.\n    offset (number, optional) \u2014 Skip N items for pagination (default 0)\n    limit (number, optional) \u2014 Max items per page (default 100)',
+      "delete": "# instances.delete\nDelete nodes\n\nParams:\n    id (string, optional) \u2014 Single node ID\n    items (array, optional) \u2014 Batch: [{id}, ...]\n      id (string, optional)",
+      "clone": "# instances.clone\nDuplicate nodes\n\nParams:\n    id (string, required) \u2014 Node ID\n    parentId (string, optional) \u2014 Parent node ID. Omit to place on current page.\n    x (number, optional) \u2014 X position (default: 0)\n    y (number, optional) \u2014 Y position (default: 0)\n    depth (number, optional) \u2014 Response detail: omit for id+name only. 0=properties + child stubs. N=recurse N levels. -1=unlimited.",
+      "audit": '# instances.audit\nRun lint on a node \u2014 returns severity-ranked findings\n\nParams:\n    id (string, required) \u2014 Node ID to audit\n    rules (string[], optional) \u2014 Rules to check. Default: ["all"]. Categories: "component", "composition", "token", "naming", "wcag".\n    maxDepth (number, optional) \u2014 Max tree depth (default: 10)\n    maxFindings (number, optional) \u2014 Max findings (default: 50)',
+      "reparent": "# instances.reparent\nMove nodes into a new parent\n\nParams:\n    items (array, required) \u2014 Array of {id, parentId, index?}\n      id (string, required)\n      parentId (string, required)\n      index (number, optional)",
+      "get": '# instances.get\nGet instance detail with component properties and overrides\n\nParams:\n    id (string, required) \u2014 Instance node ID\n    fields (string[], optional) \u2014 Property whitelist. Identity fields (id, name, type) always included. Omit for stubs on list, full on get. Pass ["*"] for all.\n    depth (number, optional) \u2014 Response detail: omit for id+name only. 0=properties + child stubs. N=recurse N levels. -1=unlimited.\n    verbose (boolean, optional) \u2014 Include all properties (bounding box, constraints, text style details). Default false \u2014 returns slim, actionable output.',
+      "create": `# instances.create
+Create component instances
+
+Example: instances(method:"create", items:[{componentId:"1:23", variantProperties:{"Size":"Large"}, properties:{"Label":"Click me"}, parentId:"2:45", layoutSizingHorizontal:"FILL"}])
+
+Params:
+    items (InstanceCreateItem[], required) \u2014 Array of {componentId, variantProperties?, x?, y?, parentId?, layoutSizingHorizontal?, ...}
+      opacity (string, optional) \u2014 Opacity (0-1) or variable name
+      visible (boolean, optional) \u2014 Show/hide (default true)
+      locked (boolean, optional) \u2014 Lock/unlock (default false)
+      blendMode (PASS_THROUGH | NORMAL | DARKEN | MULTIPLY | LINEAR_BURN | COLOR_BURN | LIGHTEN | SCREEN | LINEAR_DODGE | COLOR_DODGE | OVERLAY | SOFT_LIGHT | HARD_LIGHT | DIFFERENCE | EXCLUSION | HUE | SATURATION | COLOR | LUMINOSITY, optional)
+      effectStyleName (string, optional) \u2014 Effect style name (e.g. 'Shadow/Card') for shadows, blurs
+      layoutSizingHorizontal (FIXED | HUG | FILL, optional)
+      layoutSizingVertical (FIXED | HUG | FILL, optional)
+      layoutPositioning (AUTO | ABSOLUTE, optional) \u2014 ABSOLUTE = floating inside auto-layout parent
+      minWidth (number, optional) \u2014 Min width for responsive auto-layout
+      maxWidth (number, optional) \u2014 Max width for responsive auto-layout
+      minHeight (number, optional) \u2014 Min height for responsive auto-layout
+      maxHeight (number, optional) \u2014 Max height for responsive auto-layout
+      componentId (string, required) \u2014 Component or component set ID
+      variantProperties (object, optional) \u2014 Pick variant e.g. {"Style":"Secondary"}
+      properties (object, optional) \u2014 Set component properties inline e.g. {"Label":"Click me", "ShowIcon":true}. Same as instances.update properties.
+      name (string, optional) \u2014 Instance layer name
+      x (number, optional)
+      y (number, optional)
+      width (number, optional) \u2014 Override width (resize)
+      height (number, optional) \u2014 Override height (resize)
+      parentId (string, optional) \u2014 Parent node ID. Omit to place on current page.
+    depth (number, optional) \u2014 Response detail: omit for id+name only. 0=properties + child stubs. N=recurse N levels. -1=unlimited.`,
+      "update": `# instances.update
+Set instance properties
+
+Example: instances(method:"update", items:[{id:"1:23", properties:{"Label#4:0":"Submit"}, fillColor:"#3B82F6", layoutSizingHorizontal:"FILL"}])
+
+Params:
+    items (InstanceUpdateItem[], required) \u2014 Array of {id, properties: {"Label#1:0":"text"}, fillColor?: ...}
+      fills (array, optional) \u2014 Fill paints array \u2014 e.g. [{type: 'SOLID', color: '#hex'}] or [] for transparent. Primary way to set fills.
+      fillColor (Color, optional) \u2014 Shorthand \u2014 sets a single solid fill (auto-binds to matching variable/style)
+      fillStyleName (string, optional) \u2014 Paint style name for fill
+      fillVariableName (string, optional) \u2014 Color variable by name e.g. 'bg/primary'
+      strokes (array, optional) \u2014 Stroke paints array \u2014 e.g. [{type: 'SOLID', color: '#hex'}] or [] to clear. Primary way to set strokes.
+      strokeColor (Color, optional) \u2014 Shorthand \u2014 sets a single solid stroke (auto-binds to matching variable/style)
+      strokeStyleName (string, optional) \u2014 Paint style name for stroke
+      strokeVariableName (string, optional) \u2014 Color variable by name for stroke
+      strokeWeight (string, optional) \u2014 All sides (number) or variable name (string). Per-side: strokeTopWeight, strokeBottomWeight, strokeLeftWeight, strokeRightWeight.
+      strokeTopWeight (string, optional)
+      strokeBottomWeight (string, optional)
+      strokeLeftWeight (string, optional)
+      strokeRightWeight (string, optional)
+      strokeAlign (INSIDE | OUTSIDE | CENTER, optional) \u2014 Stroke position (default: INSIDE)
+      strokesIncludedInLayout (boolean, optional) \u2014 Include stroke width in layout measurements (default: false)
+      cornerRadius (string, optional) \u2014 All corners (number) or variable name (string). Per-corner: topLeftRadius, topRightRadius, bottomRightRadius, bottomLeftRadius.
+      topLeftRadius (string, optional)
+      topRightRadius (string, optional)
+      bottomRightRadius (string, optional)
+      bottomLeftRadius (string, optional)
+      opacity (string, optional) \u2014 Opacity (0-1) or variable name
+      visible (boolean, optional) \u2014 Show/hide (default true)
+      locked (boolean, optional) \u2014 Lock/unlock (default false)
+      blendMode (PASS_THROUGH | NORMAL | DARKEN | MULTIPLY | LINEAR_BURN | COLOR_BURN | LIGHTEN | SCREEN | LINEAR_DODGE | COLOR_DODGE | OVERLAY | SOFT_LIGHT | HARD_LIGHT | DIFFERENCE | EXCLUSION | HUE | SATURATION | COLOR | LUMINOSITY, optional)
+      effectStyleName (string, optional) \u2014 Effect style name (e.g. 'Shadow/Card') for shadows, blurs
+      layoutMode (NONE | HORIZONTAL | VERTICAL, optional) \u2014 Layout direction (default: NONE)
+      layoutWrap (NO_WRAP | WRAP, optional)
+      padding (string, optional) \u2014 All edges (number) or variable name (string). Per-edge: paddingTop, paddingRight, paddingBottom, paddingLeft.
+      paddingTop (string, optional)
+      paddingRight (string, optional)
+      paddingBottom (string, optional)
+      paddingLeft (string, optional)
+      primaryAxisAlignItems (MIN | MAX | CENTER | SPACE_BETWEEN, optional)
+      counterAxisAlignItems (MIN | MAX | CENTER | BASELINE, optional)
+      itemSpacing (string, optional) \u2014 Spacing between children (number or variable name string, default: 0)
+      counterAxisSpacing (string, optional) \u2014 Gap between wrapped rows (requires layoutWrap: WRAP)
+      layoutSizingHorizontal (FIXED | HUG | FILL, optional)
+      layoutSizingVertical (FIXED | HUG | FILL, optional)
+      layoutPositioning (AUTO | ABSOLUTE, optional) \u2014 ABSOLUTE = floating inside auto-layout parent
+      minWidth (number, optional) \u2014 Min width for responsive auto-layout
+      maxWidth (number, optional) \u2014 Max width for responsive auto-layout
+      minHeight (number, optional) \u2014 Min height for responsive auto-layout
+      maxHeight (number, optional) \u2014 Max height for responsive auto-layout
+      fontSize (number, optional) \u2014 Font size
+      fontFamily (string, optional) \u2014 Font family
+      fontStyle (string, optional) \u2014 Font variant e.g. "Bold", "Italic" \u2014 overrides fontWeight
+      fontWeight (number, optional) \u2014 100-900. Ignored when fontStyle is set.
+      fontColor (Color, optional) \u2014 Shorthand \u2014 sets text color (auto-binds to matching variable/style)
+      fontColorVariableName (string, optional) \u2014 Bind color variable by name e.g. 'text/primary'
+      fontColorStyleName (string, optional) \u2014 Apply paint style \u2014 overrides fontColor
+      textStyleId (string, optional) \u2014 Apply text style by ID \u2014 overrides fontSize/fontWeight
+      textStyleName (string, optional) \u2014 Text style by name (case-insensitive)
+      textAlignHorizontal (LEFT | CENTER | RIGHT | JUSTIFIED, optional)
+      textAlignVertical (TOP | CENTER | BOTTOM, optional)
+      textAutoResize (NONE | WIDTH_AND_HEIGHT | HEIGHT | TRUNCATE, optional)
+      id (string, required) \u2014 Instance node ID
+      properties (object, optional) \u2014 Component property key\u2192value map
+      componentProperties (object, optional) \u2014 Alias for properties (matches instances.get response shape)
+      name (string, optional) \u2014 Rename node
+      rotation (number, optional) \u2014 Degrees (0-360)
+      x (number, optional)
+      y (number, optional)
+      width (number, optional)
+      height (number, optional)
+      clearFill (boolean, optional) \u2014 Remove all fills
+      effects (array, optional) \u2014 Effect array (DROP_SHADOW, INNER_SHADOW, LAYER_BLUR, BACKGROUND_BLUR)
+      constraints (object, optional)
+      bindings (array, optional) \u2014 Bind variables to properties. field path examples: 'fills/0/color', 'strokes/0/color', 'opacity', 'width', 'cornerRadius', 'itemSpacing'.
+        field (string, required)
+        variableName (string, optional)
+        variableId (string, optional)
+      explicitMode (object, optional) \u2014 Pin variable mode \u2014 use { collectionName, modeName } (preferred) or { collectionId, modeId }
+      exportSettings (array, optional) \u2014 Export settings`,
+      "swap": "# instances.swap\nSwap instance component (preserves overrides)\n\nParams:\n    items (array, required) \u2014 Array of {id, componentId}\n      id (string, required) \u2014 Instance node ID\n      componentId (string, required) \u2014 New component or component set ID",
+      "detach": "# instances.detach\nDetach instances from their component (converts to frame)\n\nParams:\n    items (array, required) \u2014 Array of {id}\n      id (string, required) \u2014 Instance node ID",
+      "reset_overrides": "# instances.reset_overrides\nReset all overrides on instances to match their main component\n\nParams:\n    items (array, required) \u2014 Array of {id}\n      id (string, required) \u2014 Instance node ID"
+    }
+  },
+  "lint": {
+    "summary": `# lint
+Run design quality and accessibility checks.
+
+Methods:
+  check                Run design linter on a node tree [read]
+  fix                  Auto-fix frames to auto-layout [edit]
+
+// Lint runs automated design quality and accessibility checks on a node tree.
+// ---
+// Rules: "all" (default), or filter by category or specific rule names.
+// Category meta-rules (expand to all rules in that category):
+//   "component" \u2014 component property binding checks
+//   "composition" \u2014 layout and positioning checks
+//   "token" \u2014 design token / style usage checks
+//   "naming" \u2014 layer naming checks
+//   "wcag" / "accessibility" \u2014 all WCAG accessibility checks
+// ---
+// Severity levels (output is sorted by severity, highest first):
+//   "error" \u2014 definite bug, must fix
+//   "unsafe" \u2014 likely causes layout/accessibility problems
+//   "heuristic" \u2014 probably worth fixing, context-dependent
+//   "style" \u2014 opinionated, nice-to-have (leaf nodes, decorative elements often downgraded here)
+// Context-aware: leaf nodes (text, shapes, small frames) are treated differently from containers.
+//   Small labels with HUG sizing, leaf nodes on cross-axis \u2014 downgraded to "style" instead of "heuristic".
+//   Per-finding severity overrides appear on individual nodes when context changes the default.
+// ---
+// Component rules [component]:
+//   "no-text-property" \u2014 component text not exposed as editable property [heuristic]
+//   "component-bindings" \u2014 unbound text, orphaned properties, unexposed nested text [heuristic; orphaned\u2192unsafe, nested\u2192style]
+// Composition rules [composition]:
+//   "no-autolayout" \u2014 frames with manually positioned children [heuristic; leaf-only containers\u2192style]
+//   "overlapping-children" \u2014 children stacked at same position [heuristic]
+//   "shape-instead-of-frame" \u2014 shapes used as containers [style]
+//   "fixed-in-autolayout" \u2014 FIXED-size children in auto-layout parents [heuristic]
+//   "unbounded-hug" \u2014 HUG on both axes [unsafe; short leaf text\u2192style]
+//   "hug-cross-axis" \u2014 HUG on cross-axis of constrained parent [heuristic; leaf nodes\u2192style]
+//   "empty-container" \u2014 empty frames [style]
+// Token rules [token]:
+//   "hardcoded-color" \u2014 colors not using styles or variables [heuristic]
+//   "hardcoded-token" \u2014 numeric values not bound to FLOAT variable [heuristic]
+//   "no-text-style" \u2014 text without a text style [heuristic]
+// Naming rules [naming]:
+//   "default-name" \u2014 default names like "Frame 1" [style]
+//   "stale-text-name" \u2014 text node name doesn't match content [style]
+// Accessibility rules [wcag]:
+//   "wcag-contrast" \u2014 AA contrast ratio [unsafe]
+//   "wcag-contrast-enhanced" \u2014 AAA contrast ratio [style]
+//   "wcag-non-text-contrast" \u2014 non-text 3:1 contrast [heuristic]
+//   "wcag-target-size" \u2014 targets below 24x24px [unsafe]
+//   "wcag-text-size" \u2014 text below 12px [unsafe]
+//   "wcag-line-height" \u2014 line height below 1.5x [style]
+// ---
+// maxDepth limits how deep the tree traversal goes (default: 10). maxFindings caps total findings (default: 50).
+// fix: auto-converts frames to auto-layout. Use after lint.check identifies "no-autolayout" issues.
+
+Use lint(method: "help", topic: "<method>") for method details.`,
+    "methods": {
+      "check": '# lint.check\nRun design linter on a node tree\n\nExample: lint(method:"check", nodeId:"0:1", rules:["wcag","hardcoded-color"])\n\nParams:\n    nodeId (string, optional) \u2014 Node ID to lint. If omitted: 1 selected node \u2192 lints that node, 2+ selected \u2192 lints entire page (not the selection), 0 selected \u2192 error. Always pass nodeId explicitly for reliable targeting.\n    rules (string[], optional) \u2014 Rules to run. Default: ["all"]. Categories: "component", "composition", "token", "naming", "wcag"/"accessibility". Or specific rule names.\n    maxDepth (number, optional) \u2014 Max tree depth (default: 10)\n    maxFindings (number, optional) \u2014 Max findings (default: 50)',
+      "fix": "# lint.fix\nAuto-fix frames to auto-layout\n\nParams:\n    items (array, required) \u2014 Array of {nodeId, layoutMode?, itemSpacing?}\n      nodeId (string, required) \u2014 Frame node ID\n      layoutMode (VERTICAL | HORIZONTAL, optional) \u2014 Direction (default: auto-detected)\n      itemSpacing (number, optional) \u2014 Spacing between children\n    depth (number, optional) \u2014 Response detail for fixed nodes: omit for stubs, 0=properties, -1=full tree"
+    }
+  },
+  "prototyping": {
+    "summary": '# prototyping\nManage prototype interactions, reactions, and navigation flows.\n\nMethods:\n  get                  Get reactions and overflow direction on a node [read]\n  add                  Add a prototype reaction to a node [edit]\n  set                  Replace all reactions on a node (raw reactions array) [edit]\n  remove               Remove a reaction from a node by index [edit]\n\n// Reactions wire up interactions: trigger (ON_CLICK, ON_HOVER, ...) \u2192 action (navigate, swap, overlay).\n// Common patterns: button ON_CLICK \u2192 NAVIGATE to detail frame; card ON_HOVER \u2192 CHANGE_TO hover variant.\n// Multi-action: pass actions[] array to run multiple actions on one trigger (e.g. navigate + set variable mode).\n// ---\n// TRIGGERS: ON_CLICK | ON_HOVER | ON_PRESS | ON_DRAG | AFTER_TIMEOUT(timeout) | MOUSE_ENTER(delay) | MOUSE_LEAVE(delay) | ON_KEY_DOWN(keyCodes)\n// NAVIGATION: NAVIGATE (go to frame) | SWAP (swap overlay) | OVERLAY (show overlay) | SCROLL_TO | CHANGE_TO (swap component variant)\n// TRANSITIONS: DISSOLVE | SMART_ANIMATE | MOVE_IN | MOVE_OUT | PUSH | SLIDE_IN | SLIDE_OUT (+ direction for directional)\n// EASING: EASE_IN | EASE_OUT | EASE_IN_AND_OUT | LINEAR | GENTLE | QUICK | BOUNCY | SLOW\n// ACTIONS: NODE (navigate/swap) | BACK (go back) | CLOSE (close overlay) | URL (open link) | SET_VARIABLE_MODE (switch theme/mode)\n\nUse prototyping(method: "help", topic: "<method>") for method details.',
+    "methods": {
+      "get": "# prototyping.get\nGet reactions and overflow direction on a node\n\nParams:\n    id (string, required) \u2014 Node ID",
+      "add": '# prototyping.add\nAdd a prototype reaction to a node\n\nExample: prototyping(method:"add", id:"btn-1", trigger:"ON_CLICK", destination:"detail-frame-id", navigation:"NAVIGATE")\n\nParams:\n    id (string, required) \u2014 Node ID\n    trigger (ON_CLICK | ON_HOVER | ON_PRESS | ON_DRAG | AFTER_TIMEOUT | MOUSE_ENTER | MOUSE_LEAVE | ON_KEY_DOWN, required) \u2014 Trigger type\n    triggerDelay (number, optional) \u2014 Delay in ms for AFTER_TIMEOUT / MOUSE_ENTER / MOUSE_LEAVE triggers\n    triggerKeyCodes (number[], optional) \u2014 Key codes for ON_KEY_DOWN trigger\n    triggerDevice (KEYBOARD | XBOX_ONE | PS4 | SWITCH_PRO, optional) \u2014 Device for ON_KEY_DOWN (default: KEYBOARD)\n    destination (string, optional) \u2014 Target node ID (required for NODE actions)\n    navigation (NAVIGATE | SWAP | OVERLAY | SCROLL_TO | CHANGE_TO, optional) \u2014 Navigation type (default: NAVIGATE)\n    transition (DISSOLVE | SMART_ANIMATE | MOVE_IN | MOVE_OUT | PUSH | SLIDE_IN | SLIDE_OUT | INSTANT, optional) \u2014 Transition animation (default: DISSOLVE). INSTANT = no animation.\n    transitionDirection (LEFT | RIGHT | TOP | BOTTOM, optional) \u2014 Direction for MOVE_IN, MOVE_OUT, PUSH, SLIDE_IN, SLIDE_OUT\n    duration (number, optional) \u2014 Transition duration in seconds (default: 0.3)\n    easing (EASE_IN | EASE_OUT | EASE_IN_AND_OUT | LINEAR | GENTLE | QUICK | BOUNCY | SLOW, optional) \u2014 Easing function (default: EASE_OUT)\n    actionType (NODE | BACK | CLOSE | URL | SET_VARIABLE_MODE, optional) \u2014 Action type (default: NODE). SET_VARIABLE_MODE switches a variable collection mode.\n    url (string, optional) \u2014 URL for URL action type\n    collectionName (string, optional) \u2014 Variable collection name (for SET_VARIABLE_MODE)\n    modeName (string, optional) \u2014 Mode name to switch to (for SET_VARIABLE_MODE)\n    resetScrollPosition (boolean, optional) \u2014 Reset scroll position on navigate (default: true)\n    actions (array, optional) \u2014 Multi-action: [{actionType, destination?, navigation?, collectionName?, modeName?, ...}]. Overrides single-action params.',
+      "set": "# prototyping.set\nReplace all reactions on a node (raw reactions array)\n\nParams:\n    id (string, required) \u2014 Node ID\n    reactions (array, required) \u2014 Full reactions array \u2014 [{trigger:{type}, actions:[{type, destinationId, navigation, transition}]}]",
+      "remove": "# prototyping.remove\nRemove a reaction from a node by index\n\nParams:\n    id (string, required) \u2014 Node ID\n    index (number, required) \u2014 Reaction index (0-based)"
+    }
+  },
+  "selection": {
+    "summary": '# selection\nRead and set the current Figma selection.\n\nMethods:\n  get                  Get the current selection [read]\n  set                  Set selection to nodes and scroll viewport to show them [read]\n\n// Selection is the set of nodes currently highlighted in the Figma canvas.\n// get returns the current selection. Without depth, returns stubs ({id, name, type}). With depth=0, returns full properties.\n// _truncated: true when the response was cut short due to node budget limits. Use depth=0 or specific fields to reduce payload.\n// set replaces the entire selection AND scrolls the viewport to show the selected nodes.\n\nUse selection(method: "help", topic: "<method>") for method details.',
+    "methods": {
+      "get": "# selection.get\nGet the current selection\n\nParams:\n    depth (number, optional) \u2014 Child recursion depth. Omit for stubs only, 0=selected nodes' properties, -1=unlimited.\n    verbose (boolean, optional) \u2014 Include all properties (bounding box, constraints, text style details). Default false \u2014 returns slim, actionable output.",
+      "set": '# selection.set\nSet selection to nodes and scroll viewport to show them\n\nParams:\n    nodeIds (string[], required) \u2014 Array of node IDs to select. Example: ["1:2","1:3"]'
+    }
+  },
+  "styles": {
+    "summary": '# styles\nCRUD for local paint, text, effect, and grid styles.\n\nMethods:\n  list                 List local styles with optional type filter [read]\n  get                  Get full style detail by ID [read]\n  create               Create local styles [create]\n  update               Update styles by ID or name [edit]\n  delete               Delete styles [edit]\n\n// Styles are named, reusable design properties that can be applied to nodes. Four types:\n//   paint: a named color (applied to fills/strokes), text: typography settings, effect: shadows/blurs, grid: layout grids.\n// All ID params accept both IDs and display names (case-insensitive). Use whichever you have.\n// ---\n// leadingTrim: "CAP_HEIGHT" trims line-height to cap height (tighter text boxes), "NONE" is default.\n// fontStyle: font variant name like "Bold", "Italic", "Bold Italic". Use fonts.list to find available styles.\n//\n// Effect object shape (for effect styles):\n//   { type: "DROP_SHADOW"|"INNER_SHADOW"|"LAYER_BLUR"|"BACKGROUND_BLUR",\n//     color?: Color, offset?: {x, y}, radius: number, spread?: number,\n//     visible?: boolean, blendMode?: string }\n//   DROP_SHADOW/INNER_SHADOW require color, offset, radius. LAYER_BLUR/BACKGROUND_BLUR require radius only.\n//   Example: { type: "DROP_SHADOW", color: "#00000040", offset: {x:0,y:4}, radius: 8 }\n//\n// LayoutGrid object shape (for grid styles):\n//   Rows/Columns: { pattern: "ROWS"|"COLUMNS", alignment: "MIN"|"MAX"|"STRETCH"|"CENTER",\n//     gutterSize: number, count: number, sectionSize?: number, offset?: number, visible?: boolean, color?: Color }\n//   Grid: { pattern: "GRID", sectionSize: number, visible?: boolean, color?: Color }\n//   Example: { pattern: "COLUMNS", alignment: "STRETCH", gutterSize: 20, count: 12, offset: 40 }\n\nUse styles(method: "help", topic: "<method>") for method details.',
+    "methods": {
+      "list": '# styles.list\nList local styles with optional type filter\n\nParams:\n    type (paint | text | effect | grid, optional) \u2014 Filter by style type\n    fields (string[], optional) \u2014 Property whitelist. Identity fields (id, name, type) always included. Omit for stubs on list, full on get. Pass ["*"] for all.\n    offset (number, optional) \u2014 Skip N items for pagination (default 0)\n    limit (number, optional) \u2014 Max items per page (default 100)',
+      "get": '# styles.get\nGet full style detail by ID\n\nParams:\n    id (string, required) \u2014 Style ID or name\n    fields (string[], optional) \u2014 Property whitelist. Identity fields (id, name, type) always included. Omit for stubs on list, full on get. Pass ["*"] for all.',
+      "create": '# styles.create\nCreate local styles\n\nExample: styles(method:"create", type:"effect", name:"Shadow/Medium", effects:[{type:"DROP_SHADOW", color:"#00000040", offset:{x:0,y:4}, radius:8}])\n\nDiscriminant: type (paint | text | effect | grid)\n\n  ## paint \u2014 Paint/color style\n    name (string, required) \u2014 Style name\n    color (Color, required) \u2014 Color value\n    colorVariableName (string, optional) \u2014 Bind to a COLOR variable by name (style tracks the variable)\n    description (string, optional) \u2014 Style description\n\n  ## text \u2014 Text style\n    name (string, required) \u2014 Style name\n    fontFamily (string, required) \u2014 Font family\n    fontStyle (string, optional) \u2014 Font style (default: Regular)\n    fontSize (number, required) \u2014 Font size\n    lineHeight (line_height, optional)\n    letterSpacing (letter_spacing, optional)\n    textCase (ORIGINAL | UPPER | LOWER | TITLE | SMALL_CAPS | SMALL_CAPS_FORCED, optional)\n    textDecoration (NONE | UNDERLINE | STRIKETHROUGH, optional)\n    paragraphIndent (number, optional) \u2014 Paragraph indent (px)\n    paragraphSpacing (number, optional) \u2014 Paragraph spacing (px)\n    leadingTrim (CAP_HEIGHT | NONE, optional) \u2014 Leading trim mode\n    description (string, optional) \u2014 Style description\n\n  ## effect \u2014 Effect style\n    name (string, required) \u2014 Style name\n    effects (array, required) \u2014 Array of Effect objects\n    description (string, optional) \u2014 Style description\n\n  ## grid \u2014 Grid/layout grid style\n    name (string, required) \u2014 Style name\n    layoutGrids (array, required) \u2014 Array of LayoutGrid objects\n    description (string, optional) \u2014 Style description',
+      "update": '# styles.update\nUpdate styles by ID or name\n\nExample: styles(method:"update", items:[{id:"Surface/Primary", color:"#F5F5F5"}])\n\nParams:\n    type (paint | text | effect | grid, optional) \u2014 Style type hint for strict validation (optional, auto-detected)\n    items (PatchStyleItem[], required) \u2014 Array of {id, ...fields} to update\n      id (string, required) \u2014 Style ID or name\n      name (string, optional) \u2014 Rename the style\n      description (string, optional) \u2014 Style description\n      color (Color, optional) \u2014 New color (paint styles)\n      colorVariableName (string, optional) \u2014 Bind to a COLOR variable by name (paint styles)\n      fontFamily (string, optional)\n      fontStyle (string, optional)\n      fontSize (number, optional)\n      lineHeight (line_height, optional)\n      letterSpacing (letter_spacing, optional)\n      textCase (ORIGINAL | UPPER | LOWER | TITLE | SMALL_CAPS | SMALL_CAPS_FORCED, optional)\n      textDecoration (NONE | UNDERLINE | STRIKETHROUGH, optional)\n      paragraphIndent (number, optional) \u2014 Paragraph indent (px)\n      paragraphSpacing (number, optional) \u2014 Paragraph spacing (px)\n      leadingTrim (CAP_HEIGHT | NONE, optional)\n      effects (array, optional) \u2014 Array of Effect objects\n      layoutGrids (array, optional) \u2014 Array of LayoutGrid objects (grid styles)',
+      "delete": "# styles.delete\nDelete styles\n\nParams:\n    id (string, optional) \u2014 Style ID or name\n    items (array, optional) \u2014 Batch: [{id}, ...]\n      id (string, required) \u2014 Style ID or name"
+    }
+  },
+  "text": {
+    "summary": '# text\nCreate and manage text nodes.\n\nMethods:\n  get                  Get serialized node data [read]\n  list                 Search for nodes (returns stubs only \u2014 use get with depth for full properties) [read]\n  update               Patch node properties [edit]\n  delete               Delete nodes [edit]\n  clone                Duplicate nodes [create]\n  audit                Run lint on a node \u2014 returns severity-ranked findings [read]\n  reparent             Move nodes into a new parent [edit]\n  create               Create text nodes [create]\n  set_content          Replace text content on existing text nodes [edit]\n  scan                 Scan all text nodes within a subtree [read]\n\n// depth: omit \u2192 id+name stubs | 0 \u2192 props + child stubs | N \u2192 recurse N | -1 \u2192 full tree\n// fields: whitelist e.g. ["fills","opacity"] \u2014 id, name, type always included. Pass ["*"] for all.\n// layoutSizingHorizontal/Vertical: FIXED | HUG | FILL \u2014 how the node sizes within auto-layout.\n// Colors: fillVariableName/strokeVariableName bind by name \u2014 preferred over raw color values.\n// Note: node-based endpoints (frames, text, instances, components) use `results` as the list key.\n//   Standalone endpoints (styles, variables, variable_collections) use `items`. Components.list uses `items` (catalog view).\n// ---\n// visible: false hides the node. Omitted from response when true (the default).\n// locked: true prevents editing in Figma UI. Omitted when false (the default).\n// rotation: degrees (0-360). Omitted when 0.\n// blendMode: layer blend mode. Omitted when PASS_THROUGH (the default).\n// layoutPositioning: ABSOLUTE = floating inside auto-layout parent. Omitted when AUTO (the default).\n// minWidth/maxWidth/minHeight/maxHeight: responsive constraints for auto-layout children.\n// constraints: position behavior in non-auto-layout parents. Ignored inside auto-layout frames.\n// bindings: bind design variables to node properties. field uses slash path: "fills/0/color" (first fill), "strokes/0/color", "opacity", "width", "height", "cornerRadius", "paddingLeft", "itemSpacing".\n// explicitMode: pin a variable mode on this node. Use { collectionName, modeName } (preferred) or { collectionId, modeId }.\n// properties: escape hatch \u2014 set any Figma node property directly. Use only when no dedicated field exists.\ninterface Node {\n  id: string; name: string; type: string;\n  visible?: boolean;       // omitted when true\n  locked?: boolean;        // omitted when false\n  opacity?: number;        // omitted when 1\n  rotation?: number;       // omitted when 0\n  blendMode?: string;      // omitted when PASS_THROUGH\n  layoutPositioning?: "AUTO" | "ABSOLUTE";\n  layoutSizingHorizontal?: "FIXED" | "HUG" | "FILL";\n  layoutSizingVertical?: "FIXED" | "HUG" | "FILL";\n  minWidth?: number; maxWidth?: number; minHeight?: number; maxHeight?: number;\n  absoluteBoundingBox: { x: number; y: number; width: number; height: number };\n  fills?: Paint[];         // solid: {type: "SOLID", color: {r, g, b, a}}\n  strokes?: Paint[];\n  effects?: Effect[];      // DROP_SHADOW | INNER_SHADOW | LAYER_BLUR | BACKGROUND_BLUR\n  children?: NodeStub[];   // stubs: {id, name, type} \u2014 use depth to expand\n}\n// PatchItem uses flat params matching create shape \u2014 no nested sub-objects.\n// Fill/stroke/corner/layout/text params are identical to frames.create and text.create.\n// Unknown keys produce a warning, preventing silent failures.\n// Text nodes display text content with typography styling. They inherit node methods (get, list, update, delete, clone, reparent).\n// textAutoResize: NONE (fixed box), WIDTH_AND_HEIGHT (grow both), HEIGHT (fixed width, auto height), TRUNCATE (fixed + ellipsis).\n// Prefer textStyleName for typography, fontColorVariableName/fontColorStyleName for color.\n// Aliases: fillColor \u2192 fontColor, fillVariableName \u2192 fontColorVariableName, fillStyleName \u2192 fontColorStyleName (consistent with frames API).\n// ---\n// Smart defaults inside auto-layout parent: layoutSizingHorizontal defaults to FILL, layoutSizingVertical to HUG, textAutoResize to HEIGHT.\n//   Text fills parent width and wraps automatically. Override with explicit values if needed.\n// fontStyle vs fontWeight: fontStyle is a named variant like "Bold", "Italic", "SemiBold". When set, fontWeight is ignored.\n//   Use fonts.list to find available fontFamily + fontStyle combinations.\n// scan: finds all text nodes in a subtree. path (when includePath:true) shows the layer hierarchy e.g. "Frame > Card > Label".\n// ScanResult (per-item): { nodeId, count, truncated, textNodes: [{ id, name, characters, fontSize, fontFamily, fontStyle, path?, depth?, absoluteX?, absoluteY?, width?, height? }] }\n\nUse text(method: "help", topic: "<method>") for method details.',
+    "methods": {
+      "get": '# text.get\nGet serialized node data\n\nParams:\n    id (string, required) \u2014 Node ID\n    fields (string[], optional) \u2014 Property whitelist. Identity fields (id, name, type) always included. Omit for stubs on list, full on get. Pass ["*"] for all.\n    depth (number, optional) \u2014 Response detail: omit for id+name only. 0=properties + child stubs. N=recurse N levels. -1=unlimited.\n    verbose (boolean, optional) \u2014 Include all properties (bounding box, constraints, text style details). Default false \u2014 returns slim, actionable output.',
+      "list": '# text.list\nSearch for nodes (returns stubs only \u2014 use get with depth for full properties)\n\nParams:\n    query (string, optional) \u2014 Name search query (case-insensitive substring match)\n    types (string[], optional) \u2014 Filter by node types (e.g. ["FRAME", "TEXT"])\n    parentId (string, optional) \u2014 Search only within this subtree\n    fields (string[], optional) \u2014 Property whitelist. Identity fields (id, name, type) always included. Omit for stubs on list, full on get. Pass ["*"] for all.\n    offset (number, optional) \u2014 Skip N items for pagination (default 0)\n    limit (number, optional) \u2014 Max items per page (default 100)',
+      "update": `# text.update
+Patch node properties
+
+Params:
+    items (PatchItem[], required) \u2014 Array of {id, ...properties} to patch
+      fills (array, optional) \u2014 Fill paints array \u2014 e.g. [{type: 'SOLID', color: '#hex'}] or [] for transparent. Primary way to set fills.
+      fillColor (Color, optional) \u2014 Shorthand \u2014 sets a single solid fill (auto-binds to matching variable/style)
+      fillStyleName (string, optional) \u2014 Paint style name for fill
+      fillVariableName (string, optional) \u2014 Color variable by name e.g. 'bg/primary'
+      strokes (array, optional) \u2014 Stroke paints array \u2014 e.g. [{type: 'SOLID', color: '#hex'}] or [] to clear. Primary way to set strokes.
+      strokeColor (Color, optional) \u2014 Shorthand \u2014 sets a single solid stroke (auto-binds to matching variable/style)
+      strokeStyleName (string, optional) \u2014 Paint style name for stroke
+      strokeVariableName (string, optional) \u2014 Color variable by name for stroke
+      strokeWeight (string, optional) \u2014 All sides (number) or variable name (string). Per-side: strokeTopWeight, strokeBottomWeight, strokeLeftWeight, strokeRightWeight.
+      strokeTopWeight (string, optional)
+      strokeBottomWeight (string, optional)
+      strokeLeftWeight (string, optional)
+      strokeRightWeight (string, optional)
+      strokeAlign (INSIDE | OUTSIDE | CENTER, optional) \u2014 Stroke position (default: INSIDE)
+      strokesIncludedInLayout (boolean, optional) \u2014 Include stroke width in layout measurements (default: false)
+      cornerRadius (string, optional) \u2014 All corners (number) or variable name (string). Per-corner: topLeftRadius, topRightRadius, bottomRightRadius, bottomLeftRadius.
+      topLeftRadius (string, optional)
+      topRightRadius (string, optional)
+      bottomRightRadius (string, optional)
+      bottomLeftRadius (string, optional)
+      opacity (string, optional) \u2014 Opacity (0-1) or variable name
+      visible (boolean, optional) \u2014 Show/hide (default true)
+      locked (boolean, optional) \u2014 Lock/unlock (default false)
+      blendMode (PASS_THROUGH | NORMAL | DARKEN | MULTIPLY | LINEAR_BURN | COLOR_BURN | LIGHTEN | SCREEN | LINEAR_DODGE | COLOR_DODGE | OVERLAY | SOFT_LIGHT | HARD_LIGHT | DIFFERENCE | EXCLUSION | HUE | SATURATION | COLOR | LUMINOSITY, optional)
+      effectStyleName (string, optional) \u2014 Effect style name (e.g. 'Shadow/Card') for shadows, blurs
+      layoutMode (NONE | HORIZONTAL | VERTICAL, optional) \u2014 Layout direction (default: NONE)
+      layoutWrap (NO_WRAP | WRAP, optional)
+      padding (string, optional) \u2014 All edges (number) or variable name (string). Per-edge: paddingTop, paddingRight, paddingBottom, paddingLeft.
+      paddingTop (string, optional)
+      paddingRight (string, optional)
+      paddingBottom (string, optional)
+      paddingLeft (string, optional)
+      primaryAxisAlignItems (MIN | MAX | CENTER | SPACE_BETWEEN, optional)
+      counterAxisAlignItems (MIN | MAX | CENTER | BASELINE, optional)
+      itemSpacing (string, optional) \u2014 Spacing between children (number or variable name string, default: 0)
+      counterAxisSpacing (string, optional) \u2014 Gap between wrapped rows (requires layoutWrap: WRAP)
+      layoutSizingHorizontal (FIXED | HUG | FILL, optional)
+      layoutSizingVertical (FIXED | HUG | FILL, optional)
+      layoutPositioning (AUTO | ABSOLUTE, optional) \u2014 ABSOLUTE = floating inside auto-layout parent
+      minWidth (number, optional) \u2014 Min width for responsive auto-layout
+      maxWidth (number, optional) \u2014 Max width for responsive auto-layout
+      minHeight (number, optional) \u2014 Min height for responsive auto-layout
+      maxHeight (number, optional) \u2014 Max height for responsive auto-layout
+      fontSize (number, optional) \u2014 Font size
+      fontFamily (string, optional) \u2014 Font family
+      fontStyle (string, optional) \u2014 Font variant e.g. "Bold", "Italic" \u2014 overrides fontWeight
+      fontWeight (number, optional) \u2014 100-900. Ignored when fontStyle is set.
+      fontColor (Color, optional) \u2014 Shorthand \u2014 sets text color (auto-binds to matching variable/style)
+      fontColorVariableName (string, optional) \u2014 Bind color variable by name e.g. 'text/primary'
+      fontColorStyleName (string, optional) \u2014 Apply paint style \u2014 overrides fontColor
+      textStyleId (string, optional) \u2014 Apply text style by ID \u2014 overrides fontSize/fontWeight
+      textStyleName (string, optional) \u2014 Text style by name (case-insensitive)
+      textAlignHorizontal (LEFT | CENTER | RIGHT | JUSTIFIED, optional)
+      textAlignVertical (TOP | CENTER | BOTTOM, optional)
+      textAutoResize (NONE | WIDTH_AND_HEIGHT | HEIGHT | TRUNCATE, optional)
+      id (string, required)
+      name (string, optional) \u2014 Rename node
+      rotation (number, optional) \u2014 Degrees (0-360)
+      x (number, optional)
+      y (number, optional)
+      width (number, optional)
+      height (number, optional)
+      clearFill (boolean, optional) \u2014 Remove all fills
+      effects (array, optional) \u2014 Effect array (DROP_SHADOW, INNER_SHADOW, LAYER_BLUR, BACKGROUND_BLUR)
+      overflowDirection (NONE | HORIZONTAL | VERTICAL | BOTH, optional) \u2014 Scroll overflow in prototype (default: NONE)
+      constraints (object, optional)
+      bindings (array, optional) \u2014 Bind variables to properties. field path examples: 'fills/0/color', 'strokes/0/color', 'opacity', 'width', 'cornerRadius', 'itemSpacing'.
+        field (string, required)
+        variableName (string, optional)
+        variableId (string, optional)
+      explicitMode (object, optional) \u2014 Pin variable mode \u2014 use { collectionName, modeName } (preferred) or { collectionId, modeId }
+      exportSettings (array, optional) \u2014 Export settings
+      properties (object, optional) \u2014 Direct Figma API props (escape hatch)`,
+      "delete": "# text.delete\nDelete nodes\n\nParams:\n    id (string, optional) \u2014 Single node ID\n    items (array, optional) \u2014 Batch: [{id}, ...]\n      id (string, optional)",
+      "clone": "# text.clone\nDuplicate nodes\n\nParams:\n    id (string, required) \u2014 Node ID\n    parentId (string, optional) \u2014 Parent node ID. Omit to place on current page.\n    x (number, optional) \u2014 X position (default: 0)\n    y (number, optional) \u2014 Y position (default: 0)\n    depth (number, optional) \u2014 Response detail: omit for id+name only. 0=properties + child stubs. N=recurse N levels. -1=unlimited.",
+      "audit": '# text.audit\nRun lint on a node \u2014 returns severity-ranked findings\n\nParams:\n    id (string, required) \u2014 Node ID to audit\n    rules (string[], optional) \u2014 Rules to check. Default: ["all"]. Categories: "component", "composition", "token", "naming", "wcag".\n    maxDepth (number, optional) \u2014 Max tree depth (default: 10)\n    maxFindings (number, optional) \u2014 Max findings (default: 50)',
+      "reparent": "# text.reparent\nMove nodes into a new parent\n\nParams:\n    items (array, required) \u2014 Array of {id, parentId, index?}\n      id (string, required)\n      parentId (string, required)\n      index (number, optional)",
+      "create": `# text.create
+Create text nodes
+
+Example: text(method:"create", items:[{text:"Hello", fontFamily:"Inter", fontSize:16, textStyleName:"body/medium"}])
+
+Params:
+    items (TextItem[], required) \u2014 Array of text items to create
+      text (string, optional) \u2014 Text content
+      name (string, optional) \u2014 Layer name
+      x (number, optional)
+      y (number, optional)
+      width (number, optional) \u2014 Fixed width in px \u2014 implies layoutSizingHorizontal: FIXED and textAutoResize: HEIGHT
+      parentId (string, optional) \u2014 Parent node ID. Omit to place on current page.
+      fontFamily (string, optional) \u2014 Font family (default: Inter). Use fonts.list to find installed fonts.
+      fontStyle (string, optional) \u2014 Font variant e.g. "Bold", "Italic" \u2014 overrides fontWeight
+      fontSize (number, optional) \u2014 Font size (default: 14)
+      fontWeight (number, optional) \u2014 100-900 (default: 400). Ignored when fontStyle is set.
+      fills (array, optional) \u2014 Text color paints \u2014 e.g. [{type: 'SOLID', color: '#hex'}]. Same as node fills.
+      fontColor (Color, optional) \u2014 Shorthand \u2014 sets text color (auto-binds to matching variable/style)
+      fontColorVariableName (string, optional) \u2014 Bind color variable by name e.g. 'text/primary'
+      fontColorStyleName (string, optional) \u2014 Apply paint style \u2014 overrides fontColor
+      textStyleId (string, optional) \u2014 Text style ID or name (case-insensitive) \u2014 overrides fontSize/fontWeight
+      textStyleName (string, optional) \u2014 Alias for textStyleId \u2014 accepts name (case-insensitive)
+      textAlignHorizontal (LEFT | CENTER | RIGHT | JUSTIFIED, optional)
+      textAlignVertical (TOP | CENTER | BOTTOM, optional)
+      layoutSizingHorizontal (FIXED | HUG | FILL, optional)
+      layoutSizingVertical (FIXED | HUG | FILL, optional)
+      textAutoResize (NONE | WIDTH_AND_HEIGHT | HEIGHT | TRUNCATE, optional) \u2014 NONE (fixed box), WIDTH_AND_HEIGHT (grow both), HEIGHT (fixed width, auto height), TRUNCATE (fixed + ellipsis)
+      componentPropertyName (string, optional) \u2014 Bind to a component TEXT property by name. Walks up ancestors to find the nearest component, or targets the component specified by componentId. For deeply nested text, consider using components(method:'create', type:'from_node') with exposeText:true instead \u2014 it auto-discovers and binds all text nodes.
+      componentId (string, optional) \u2014 Target component ID for componentPropertyName binding. When omitted, walks up ancestors to find the nearest COMPONENT or COMPONENT_SET.
+    depth (number, optional) \u2014 Response detail: omit for id+name only. 0=properties + child stubs. N=recurse N levels. -1=unlimited.`,
+      "set_content": "# text.set_content\nReplace text content on existing text nodes\n\nParams:\n    items (array, required) \u2014 Array of {nodeId, text}\n      nodeId (string, required) \u2014 Text node ID\n      text (string, required) \u2014 New text content\n    depth (number, optional) \u2014 Response detail: omit for id+name only. 0=properties + child stubs. N=recurse N levels. -1=unlimited.",
+      "scan": "# text.scan\nScan all text nodes within a subtree\n\nParams:\n    items ({ nodeId: string; limit?: number; includePath?: boolean; includeGeometry?: boolean }[], required) \u2014 Array of subtrees to scan"
+    }
+  },
+  "variable_collections": {
+    "summary": '# variable_collections\nCRUD for variable collections \u2014 the document-level API for design tokens.\n\nMethods:\n  list                 List variable collections [read]\n  get                  Get collection with all variables and values (full document) [read]\n  create               Create a collection with modes and variables in one call [create]\n  update               Rename collections [edit]\n  delete               Delete collections [edit]\n  add_mode             Add a mode to a collection [create]\n  rename_mode          Rename a mode [edit]\n  remove_mode          Remove a mode from a collection [edit]\n\n// Variable collections group design tokens and define their modes (e.g. Light/Dark, Desktop/Mobile).\n// All ID params accept both IDs and display names.\n// ---\n// valuesByMode: values keyed by mode name, e.g. {"Light": "#FFF", "Dark": "#111"}.\n// Aliases: {type: "VARIABLE_ALIAS", name: "other/variable"}.\n// scopes: see variables endpoint for full list.\n// Deleting a collection deletes all variables inside it.\n// The default mode cannot be removed. Use add_mode/remove_mode for additional modes.\n\nUse variable_collections(method: "help", topic: "<method>") for method details.',
+    "methods": {
+      "list": '# variable_collections.list\nList variable collections\n\nParams:\n    fields (string[], optional) \u2014 Property whitelist. Identity fields (id, name, type) always included. Omit for stubs on list, full on get. Pass ["*"] for all.\n    offset (number, optional) \u2014 Skip N items for pagination (default 0)\n    limit (number, optional) \u2014 Max items per page (default 100)',
+      "get": '# variable_collections.get\nGet collection with all variables and values (full document)\n\nParams:\n    id (string, required) \u2014 Collection ID or name\n    fields (string[], optional) \u2014 Property whitelist. Identity fields (id, name, type) always included. Omit for stubs on list, full on get. Pass ["*"] for all.',
+      "create": `# variable_collections.create
+Create a collection with modes and variables in one call
+
+Example: variable_collections(method:"create", items:[{name:"Tokens", modes:["Light","Dark"], variables:[{name:"bg/primary", type:"COLOR", valuesByMode:{"Light":"#FFF","Dark":"#111"}, scopes:["ALL_FILLS"]}, {name:"text/primary", type:"COLOR", valuesByMode:{"Light":"#111","Dark":"#F0F0F0"}, scopes:["TEXT_FILL"]}, {name:"space/16", type:"FLOAT", value:16, scopes:["GAP","WIDTH_HEIGHT"]}, {name:"radius/8", type:"FLOAT", value:8, scopes:["CORNER_RADIUS"]}]}])
+
+Params:
+    items (array, required) \u2014 Array of collection documents
+      name (string, required) \u2014 Collection name
+      modes (string[], optional) \u2014 Mode names (e.g. ['Light', 'Dark']). Omit for single-mode collection.
+      variables (array, optional) \u2014 Variables to create inside this collection
+        name (string, required) \u2014 Variable name (unique within collection)
+        type (COLOR | FLOAT | STRING | BOOLEAN, required) \u2014 Variable type
+        value (variable_value, optional) \u2014 Shorthand \u2014 sets the default mode value. Use valuesByMode for multi-mode.
+        valuesByMode (object, optional) \u2014 Values keyed by mode name (e.g. {"Light": "#FFF", "Dark": "#111"})
+        description (string, optional)
+        scopes (string[], optional) \u2014 Restrict where variable can be applied (default: ALL_SCOPES)`,
+      "update": "# variable_collections.update\nRename collections\n\nParams:\n    items (array, required) \u2014 Array of {id, name}\n      id (string, required) \u2014 Collection ID or name\n      name (string, required) \u2014 New name",
+      "delete": "# variable_collections.delete\nDelete collections\n\nParams:\n    id (string, optional) \u2014 Collection ID or name\n    items (array, optional) \u2014 Batch: [{id}, ...]\n      id (string, required)",
+      "add_mode": "# variable_collections.add_mode\nAdd a mode to a collection\n\nParams:\n    items (array, required) \u2014 Array of {collectionId, name}\n      collectionId (string, required) \u2014 Collection ID or name\n      name (string, required) \u2014 Mode name",
+      "rename_mode": '# variable_collections.rename_mode\nRename a mode\n\nParams:\n    items (array, required) \u2014 Array of {collectionId, modeId, name}\n      collectionId (string, required) \u2014 Collection ID or name\n      modeId (string, required) \u2014 Mode ID or name (e.g. "Dark")\n      name (string, required) \u2014 New name',
+      "remove_mode": '# variable_collections.remove_mode\nRemove a mode from a collection\n\nParams:\n    items (array, required) \u2014 Array of {collectionId, modeId}\n      collectionId (string, required) \u2014 Collection ID or name\n      modeId (string, required) \u2014 Mode ID or name (e.g. "Dark")'
+    }
+  },
+  "variables": {
+    "summary": '# variables\nSearch and update design variables within a collection.\n\nMethods:\n  list                 Search variables within a collection [read]\n  get                  Get variable detail by name [read]\n  create               Create variables in a collection. Use valuesByMode for multi-mode, or value for default mode only. [create]\n  update               Update variable metadata and/or set values [edit]\n  delete               Delete variables [edit]\n\n// Search and update variables within a collection. collectionId is required on all methods.\n// Use variable_collections to create full token sets (collection + modes + variables in one call).\n// ---\n// query: prefix match first, then substring. "bg/" matches bg/canvas, bg/surface, etc.\n// valuesByMode: values keyed by mode name. value is shorthand for the default mode.\n// Aliases: {type: "VARIABLE_ALIAS", name: "other/variable"}.\n// scopes: ALL_SCOPES, TEXT_CONTENT, WIDTH_HEIGHT, GAP, CORNER_RADIUS, ALL_FILLS, FRAME_FILL, SHAPE_FILL,\n//   TEXT_FILL, STROKE_COLOR, STROKE_FLOAT, EFFECT_FLOAT, EFFECT_COLOR, OPACITY, FONT_FAMILY, FONT_STYLE,\n//   FONT_WEIGHT, FONT_SIZE, LINE_HEIGHT, LETTER_SPACING, PARAGRAPH_SPACING, PARAGRAPH_INDENT\n\nUse variables(method: "help", topic: "<method>") for method details.',
+    "methods": {
+      "list": '# variables.list\nSearch variables within a collection\n\nExample: variables(method:"list", collectionId:"Colors", query:"bg/")\n\nParams:\n    collectionId (string, required) \u2014 Collection ID or name\n    query (string, optional) \u2014 Search query \u2014 prefix match first, then substring fallback\n    type (COLOR | FLOAT | STRING | BOOLEAN, optional) \u2014 Filter by variable type\n    fields (string[], optional) \u2014 Property whitelist. Identity fields (id, name, type) always included. Omit for stubs on list, full on get. Pass ["*"] for all.\n    offset (number, optional) \u2014 Skip N items for pagination (default 0)\n    limit (number, optional) \u2014 Max items per page (default 100)',
+      "get": '# variables.get\nGet variable detail by name\n\nParams:\n    name (string, required) \u2014 Variable name (unique within collection)\n    collectionId (string, required) \u2014 Collection ID or name\n    fields (string[], optional) \u2014 Property whitelist. Identity fields (id, name, type) always included. Omit for stubs on list, full on get. Pass ["*"] for all.',
+      "create": '# variables.create\nCreate variables in a collection. Use valuesByMode for multi-mode, or value for default mode only.\n\nExample: variables(method:"create", collectionId:"Colors", items:[{name:"bg/primary", type:"COLOR", valuesByMode:{"Light":"#FFF","Dark":"#111"}, scopes:["ALL_FILLS"]}])\n\nParams:\n    collectionId (string, required) \u2014 Collection ID or name\n    items (VariableCreateItem[], required) \u2014 Array of variables to create\n      name (string, required) \u2014 Variable name (must be unique within collection)\n      type (COLOR | FLOAT | STRING | BOOLEAN, required) \u2014 Variable type\n      value (variable_value, optional) \u2014 Shorthand \u2014 sets the default mode value. Use valuesByMode for multi-mode.\n      valuesByMode (object, optional) \u2014 Values keyed by mode name (e.g. {"Light": "#FFF", "Dark": "#111"}). Takes precedence over value.\n      description (string, optional) \u2014 Variable description\n      scopes (string[], optional) \u2014 Restrict where variable can be applied (default: ALL_SCOPES)',
+      "update": '# variables.update\nUpdate variable metadata and/or set values\n\nExample: variables(method:"update", collectionId:"Colors", items:[{name:"bg/primary", valuesByMode:{"Light":"#FFF","Dark":"#222"}}])\n\nParams:\n    collectionId (string, required) \u2014 Collection ID or name\n    items (VariableUpdateItem[], required) \u2014 Array of variable updates\n      name (string, required) \u2014 Variable name\n      rename (string, optional) \u2014 Rename the variable\n      description (string, optional) \u2014 Set description\n      scopes (string[], optional) \u2014 Update scopes\n      value (variable_value, optional) \u2014 Shorthand \u2014 sets the default mode value. Use valuesByMode for multi-mode.\n      valuesByMode (object, optional) \u2014 Values keyed by mode name. Takes precedence over value.',
+      "delete": "# variables.delete\nDelete variables\n\nParams:\n    collectionId (string, required) \u2014 Collection ID or name\n    name (string, optional) \u2014 Variable name\n    items (array, optional) \u2014 Batch: [{name}, ...]\n      name (string, required)"
+    }
+  },
+  "version_history": {
+    "summary": `# version_history
+Save named versions to the Figma file's version history.
+
+Methods:
+  save                 Save a named version to the file's version history [edit]
+
+// Version history lets you create named snapshots of a Figma file.
+// Use this after completing design tasks to create an audit trail of changes.
+// Equivalent to Figma's File \u2192 Save to Version History (Cmd+Opt+S).
+
+Use version_history(method: "help", topic: "<method>") for method details.`,
+    "methods": {
+      "save": `# version_history.save
+Save a named version to the file's version history
+
+Params:
+    title (string, required) \u2014 Version title (e.g., "Added hero sections with website copy")
+    description (string, optional) \u2014 Optional longer description of what changed`
+    }
+  }
+};
+var helpTopics = {
+  "missing_tools": '# Missing Create / Edit Tools\n\nIf the user asks you to create or modify something in Figma but you cannot find create/edit methods on endpoint tools, the MCP server was started without the correct access tier flag.\n\nVibma filters available methods at startup based on CLI flags passed in the MCP config `args` array:\n\n| Flag | Methods available |\n|------|-----------------|\n| _(none)_ | Read-only (get, list, check, scan, export) |\n| `--create` | Read + creation methods (create, clone) |\n| `--edit` | All methods (read + create + update + delete) |\n\nAsk the user to add `--edit` (or `--create`) to their MCP config args:\n\n```json\n{\n  "mcpServers": {\n    "Vibma": {\n      "command": "npx",\n      "args": ["-y", "@ufira/vibma", "--edit"]\n    }\n  }\n}\n```\n\nAfter updating, the user must restart their AI tool or reload MCP servers \u2014 stdio-based servers cannot hot-reload.'
+};
+var allEndpointNames = Object.keys(helpEndpoints);
+var allTopicNames = Object.keys(helpTopics);
+function resolveHelp(topic) {
+  if (!topic) return helpDirectory;
+  const dot = topic.indexOf(".");
+  if (dot === -1) {
+    const ep2 = helpEndpoints[topic];
+    if (ep2) return ep2.summary;
+    const t = helpTopics[topic];
+    if (t) return t;
+    const all = [...allEndpointNames, ...allTopicNames];
+    return "Unknown topic: " + topic + ". Available: " + all.join(", ");
+  }
+  const epName = topic.slice(0, dot);
+  const methodName = topic.slice(dot + 1);
+  const ep = helpEndpoints[epName];
+  if (!ep) {
+    const all = [...allEndpointNames, ...allTopicNames];
+    return "Unknown topic: " + epName + ". Available: " + all.join(", ");
+  }
+  const method = ep.methods[methodName];
+  if (method) return method;
+  return "Unknown method: " + methodName + " on " + epName + ". Available methods: " + Object.keys(ep.methods).join(", ");
+}
+function resolveEndpointHelp(endpoint, topic) {
+  const ep = helpEndpoints[endpoint];
+  if (!ep) return null;
+  if (!topic) return ep.summary;
+  const method = ep.methods[topic];
+  if (method) return method;
+  return "Unknown method: " + topic + ". Available methods on " + endpoint + ": " + Object.keys(ep.methods).join(", ");
+}
+
 // src/tools/registry.ts
+function resolveCommand(tool, params) {
+  if (tool.commandMap && params.method) {
+    const cmd = tool.commandMap[params.method];
+    if (cmd) return cmd;
+  }
+  return tool.command ?? tool.name;
+}
 function registerTools(server, sendCommand, caps, tools) {
   for (const tool of tools) {
     if (tool.tier === "create" && !caps.create) continue;
     if (tool.tier === "edit" && !caps.edit) continue;
     const schema = typeof tool.schema === "function" ? tool.schema(caps) : tool.schema;
-    const command = tool.command ?? tool.name;
     const timeout = tool.timeout;
-    const format = tool.formatResponse ?? mcpJson;
+    const defaultFormat = tool.formatResponse ?? mcpJson;
     server.registerTool(tool.name, { description: tool.description, inputSchema: schema }, async (params) => {
       try {
+        if (params.method === "help") {
+          const text = resolveEndpointHelp(tool.name, params.topic) ?? resolveHelp(tool.name);
+          return { content: [{ type: "text", text }] };
+        }
         if (tool.validate) tool.validate(params);
+        const command = resolveCommand(tool, params);
         const result = await sendCommand(command, params, timeout);
+        const format = tool.methodFormatters?.[params.method] ?? defaultFormat;
         return format(result);
       } catch (e) {
+        if (e instanceof import_zod.ZodError) {
+          const hints = e.issues.map((i) => {
+            const path = i.path.join(".");
+            return `[${path}] ${i.message}`;
+          });
+          return mcpError(`${tool.name} validation error`, hints.join("; "));
+        }
         return mcpError(`${tool.name} error`, e);
       }
     });