figma-code-agent-mcp 1.0.0

package/dist/toolRegistry.js

@@ -0,0 +1,729 @@
+/**
+ * Registry of all figma.* methods available in the execute sandbox.
+ * Powers the search_tools tool for progressive API discovery.
+ */
+const registry = [
+    // === CREATE ===
+    {
+        name: 'figma.createFrame',
+        category: 'create',
+        description: 'Create a new frame (container) with optional auto-layout, fill, stroke, and corner radius. Supports CSS-like layout config and hex colors.',
+        parameters: {
+            name: { type: 'string', description: 'Name of the frame', required: true },
+            x: { type: 'number', description: 'X position', default: 0 },
+            y: { type: 'number', description: 'Y position', default: 0 },
+            width: { type: 'number', description: 'Width in pixels', default: 100 },
+            height: { type: 'number', description: 'Height in pixels', default: 100 },
+            parentId: { type: 'string', description: 'Parent node ID or target specifier ("selection", "name:Foo")' },
+            cornerRadius: { type: 'number', description: 'Corner radius' },
+            layout: { type: 'object', description: 'CSS-like layout: { direction: "row"|"column", gap, padding, alignItems, justifyContent, wrap }' },
+            fillColor: { type: 'string | { r, g, b, a? }', description: 'Fill color: hex "#FF0000", rgb(), or {r,g,b} (0-1). Alias: fill' },
+            strokeColor: { type: 'string | { r, g, b, a? }', description: 'Stroke color: hex, rgb(), or {r,g,b} (0-1). Alias: stroke' },
+            strokeWeight: { type: 'number', description: 'Stroke width in pixels' },
+            strokeAlign: { type: "'INSIDE' | 'OUTSIDE' | 'CENTER'", description: 'Stroke alignment' },
+            strokeCap: { type: "'NONE' | 'ROUND' | 'SQUARE'", description: 'Stroke cap style' },
+            strokeJoin: { type: "'MITER' | 'BEVEL' | 'ROUND'", description: 'Stroke join style' },
+            dashPattern: { type: 'number[]', description: 'Dash pattern e.g. [8, 4]' },
+            topLeftRadius: { type: 'number', description: 'Top-left corner radius' },
+            topRightRadius: { type: 'number', description: 'Top-right corner radius' },
+            bottomLeftRadius: { type: 'number', description: 'Bottom-left corner radius' },
+            bottomRightRadius: { type: 'number', description: 'Bottom-right corner radius' },
+            effects: { type: 'Effect[]', description: 'Effects: [{type:"DROP_SHADOW", color:"#00000033", offset:{x:0,y:4}, radius:12}] or [{type:"LAYER_BLUR", radius:10}]' },
+            gradient: { type: 'object', description: 'Gradient fill: {type:"LINEAR", angle:90, stops:[{position:0, color:"#F00"}, {position:1, color:"#00F"}]}' },
+            rotation: { type: 'number', description: 'Rotation in degrees' },
+            blendMode: { type: 'string', description: 'Blend mode: NORMAL, MULTIPLY, SCREEN, OVERLAY, etc.' },
+            opacity: { type: 'number', description: 'Opacity (0-1)' },
+            constraints: { type: 'object', description: 'Constraints: {horizontal: "STRETCH", vertical: "MIN"}' },
+            minWidth: { type: 'number', description: 'Minimum width' },
+            maxWidth: { type: 'number', description: 'Maximum width' },
+            minHeight: { type: 'number', description: 'Minimum height' },
+            maxHeight: { type: 'number', description: 'Maximum height' },
+            layoutMode: { type: "'NONE' | 'HORIZONTAL' | 'VERTICAL'", description: 'Auto-layout direction' },
+            primaryAxisSizingMode: { type: "'FIXED' | 'AUTO'", description: 'Primary axis sizing' },
+            counterAxisSizingMode: { type: "'FIXED' | 'AUTO'", description: 'Counter axis sizing' },
+            primaryAxisAlignItems: { type: "'MIN' | 'CENTER' | 'MAX' | 'SPACE_BETWEEN'", description: 'Primary axis alignment' },
+            counterAxisAlignItems: { type: "'MIN' | 'CENTER' | 'MAX' | 'BASELINE'", description: 'Counter axis alignment' },
+            itemSpacing: { type: 'number', description: 'Gap between children' },
+            padding: { type: 'number', description: 'Padding on all sides' },
+            paddingTop: { type: 'number', description: 'Top padding' },
+            paddingBottom: { type: 'number', description: 'Bottom padding' },
+            paddingLeft: { type: 'number', description: 'Left padding' },
+            paddingRight: { type: 'number', description: 'Right padding' },
+            layoutSizingHorizontal: { type: "'FIXED' | 'HUG' | 'FILL'", description: 'Horizontal sizing in auto-layout parent' },
+            layoutSizingVertical: { type: "'FIXED' | 'HUG' | 'FILL'", description: 'Vertical sizing in auto-layout parent' },
+        },
+        returns: '{ id, name, type, x, y, width, height }',
+        example: `const frame = await figma.createFrame({
+  name: "Card",
+  width: 300, height: 200,
+  fillColor: { r: 1, g: 1, b: 1 },
+  layoutMode: "VERTICAL",
+  padding: 16, itemSpacing: 8
+});`,
+    },
+    {
+        name: 'figma.createRectangle',
+        category: 'create',
+        description: 'Create a rectangle shape with optional fill, stroke, and corner radius.',
+        parameters: {
+            name: { type: 'string', description: 'Name of the rectangle' },
+            x: { type: 'number', description: 'X position', default: 0 },
+            y: { type: 'number', description: 'Y position', default: 0 },
+            width: { type: 'number', description: 'Width', default: 100 },
+            height: { type: 'number', description: 'Height', default: 100 },
+            fillColor: { type: 'string | { r, g, b, a? }', description: 'Fill color: hex "#FF0000", rgb(), or {r,g,b} (0-1). Alias: fill' },
+            parentId: { type: 'string', description: 'Parent node ID' },
+            cornerRadius: { type: 'number', description: 'Corner radius' },
+            strokeColor: { type: 'string | { r, g, b, a? }', description: 'Stroke color: hex, rgb(), or {r,g,b} (0-1). Alias: stroke' },
+            strokeWeight: { type: 'number', description: 'Stroke width' },
+            strokeAlign: { type: "'INSIDE' | 'OUTSIDE' | 'CENTER'", description: 'Stroke alignment' },
+            strokeCap: { type: "'NONE' | 'ROUND' | 'SQUARE'", description: 'Stroke cap style' },
+            strokeJoin: { type: "'MITER' | 'BEVEL' | 'ROUND'", description: 'Stroke join style' },
+            dashPattern: { type: 'number[]', description: 'Dash pattern e.g. [8, 4]' },
+            topLeftRadius: { type: 'number', description: 'Top-left corner radius' },
+            topRightRadius: { type: 'number', description: 'Top-right corner radius' },
+            bottomLeftRadius: { type: 'number', description: 'Bottom-left corner radius' },
+            bottomRightRadius: { type: 'number', description: 'Bottom-right corner radius' },
+            effects: { type: 'Effect[]', description: 'Effects array (shadows, blur)' },
+            gradient: { type: 'object', description: 'Gradient fill: {type, angle, stops}' },
+            rotation: { type: 'number', description: 'Rotation in degrees' },
+            blendMode: { type: 'string', description: 'Blend mode' },
+            opacity: { type: 'number', description: 'Opacity (0-1)' },
+            layoutSizingHorizontal: { type: "'FIXED' | 'HUG' | 'FILL'", description: 'Horizontal sizing in auto-layout parent' },
+            layoutSizingVertical: { type: "'FIXED' | 'HUG' | 'FILL'", description: 'Vertical sizing in auto-layout parent' },
+        },
+        returns: '{ id, name, type, x, y, width, height }',
+        example: `const rect = await figma.createRectangle({
+  name: "Background",
+  width: 200, height: 100,
+  fillColor: { r: 0.2, g: 0.4, b: 0.8 },
+  cornerRadius: 8
+});`,
+    },
+    {
+        name: 'figma.createText',
+        category: 'create',
+        description: 'Create a text node with font, size, color, and content.',
+        parameters: {
+            text: { type: 'string', description: 'Text content', required: true },
+            name: { type: 'string', description: 'Node name' },
+            x: { type: 'number', description: 'X position', default: 0 },
+            y: { type: 'number', description: 'Y position', default: 0 },
+            fontSize: { type: 'number', description: 'Font size in pixels', default: 16 },
+            fontFamily: { type: 'string', description: 'Font family', default: 'Inter' },
+            fontWeight: { type: 'string | number', description: 'Font weight: string ("Regular", "Bold") or number (400, 700)', default: 'Regular' },
+            fillColor: { type: 'string | { r, g, b, a? }', description: 'Text color: hex "#000000", rgb(), or {r,g,b} (0-1). Alias: fill' },
+            parentId: { type: 'string', description: 'Parent node ID' },
+            textAlign: { type: 'string', description: 'Text alignment: "left", "center", "right", "justified"' },
+            textColor: { type: 'string | {r,g,b,a?}', description: 'Text color (overrides fill if both set)' },
+            textAutoResize: { type: "'NONE' | 'WIDTH_AND_HEIGHT' | 'HEIGHT' | 'TRUNCATE'", description: 'Text auto-resize mode' },
+            lineHeight: { type: 'number | string | object', description: 'Line height: pixels (24), percent ("150%"), or {value, unit}' },
+            letterSpacing: { type: 'number | string | object', description: 'Letter spacing: pixels (2), percent ("5%"), or {value, unit}' },
+            textDecoration: { type: "'NONE' | 'UNDERLINE' | 'STRIKETHROUGH'", description: 'Text decoration' },
+            textCase: { type: "'ORIGINAL' | 'UPPER' | 'LOWER' | 'TITLE'", description: 'Text case transform' },
+            effects: { type: 'Effect[]', description: 'Effects array (shadows, blur)' },
+            rotation: { type: 'number', description: 'Rotation in degrees' },
+            blendMode: { type: 'string', description: 'Blend mode' },
+            opacity: { type: 'number', description: 'Opacity (0-1)' },
+            layoutSizingHorizontal: { type: "'FIXED' | 'HUG' | 'FILL'", description: 'Horizontal sizing in auto-layout parent (FILL auto-enables text wrapping)' },
+            layoutSizingVertical: { type: "'FIXED' | 'HUG' | 'FILL'", description: 'Vertical sizing in auto-layout parent' },
+        },
+        returns: '{ id, name, type, x, y, width, height }',
+        example: `const title = await figma.createText({
+  text: "Hello World",
+  fontSize: 24, fontWeight: "Bold",
+  fillColor: { r: 0, g: 0, b: 0 },
+  parentId: frame.id
+});`,
+    },
+    {
+        name: 'figma.createEllipse',
+        category: 'create',
+        description: 'Create an ellipse (circle) shape with optional fill, stroke, and effects.',
+        parameters: {
+            name: { type: 'string', description: 'Name of the ellipse' },
+            x: { type: 'number', description: 'X position', default: 0 },
+            y: { type: 'number', description: 'Y position', default: 0 },
+            width: { type: 'number', description: 'Width', default: 100 },
+            height: { type: 'number', description: 'Height', default: 100 },
+            fillColor: { type: 'string | { r, g, b, a? }', description: 'Fill color: hex "#FF0000", rgb(), or {r,g,b} (0-1). Alias: fill' },
+            parentId: { type: 'string', description: 'Parent node ID' },
+            strokeColor: { type: 'string | { r, g, b, a? }', description: 'Stroke color. Alias: stroke' },
+            strokeWeight: { type: 'number', description: 'Stroke width' },
+            effects: { type: 'Effect[]', description: 'Effects array (shadows, blur)' },
+            rotation: { type: 'number', description: 'Rotation in degrees' },
+            blendMode: { type: 'string', description: 'Blend mode' },
+            opacity: { type: 'number', description: 'Opacity (0-1)' },
+            constraints: { type: 'object', description: 'Constraints: {horizontal, vertical}' },
+            layoutSizingHorizontal: { type: "'FIXED' | 'HUG' | 'FILL'", description: 'Horizontal sizing in auto-layout parent' },
+            layoutSizingVertical: { type: "'FIXED' | 'HUG' | 'FILL'", description: 'Vertical sizing in auto-layout parent' },
+        },
+        returns: '{ id, name, type, x, y, width, height }',
+        example: `const circle = await figma.createEllipse({
+  name: "Avatar",
+  width: 48, height: 48,
+  fillColor: "#E0E0E0"
+});`,
+    },
+    {
+        name: 'figma.createLine',
+        category: 'create',
+        description: 'Create a line with optional stroke color and weight. Defaults to a black 1px stroke.',
+        parameters: {
+            name: { type: 'string', description: 'Name of the line' },
+            x: { type: 'number', description: 'X position', default: 0 },
+            y: { type: 'number', description: 'Y position', default: 0 },
+            width: { type: 'number', description: 'Line length', default: 100 },
+            parentId: { type: 'string', description: 'Parent node ID' },
+            strokeColor: { type: 'string | { r, g, b, a? }', description: 'Stroke color. Alias: stroke' },
+            strokeWeight: { type: 'number', description: 'Stroke width', default: 1 },
+            strokeCap: { type: "'NONE' | 'ROUND' | 'SQUARE'", description: 'Stroke cap style' },
+            dashPattern: { type: 'number[]', description: 'Dash pattern e.g. [8, 4]' },
+            effects: { type: 'Effect[]', description: 'Effects array (shadows, blur)' },
+            rotation: { type: 'number', description: 'Rotation in degrees' },
+            blendMode: { type: 'string', description: 'Blend mode' },
+            opacity: { type: 'number', description: 'Opacity (0-1)' },
+            constraints: { type: 'object', description: 'Constraints: {horizontal, vertical}' },
+            layoutSizingHorizontal: { type: "'FIXED' | 'HUG' | 'FILL'", description: 'Horizontal sizing in auto-layout parent' },
+            layoutSizingVertical: { type: "'FIXED' | 'HUG' | 'FILL'", description: 'Vertical sizing in auto-layout parent' },
+        },
+        returns: '{ id, name, type, x, y, width, height }',
+        example: `const divider = await figma.createLine({
+  name: "Divider",
+  width: 400,
+  strokeColor: "#CCCCCC",
+  strokeWeight: 1
+});`,
+    },
+    {
+        name: 'figma.createInstance',
+        category: 'create',
+        description: 'Create an instance of a component (local or published library).',
+        parameters: {
+            componentKey: { type: 'string', description: 'Component key (for published components)' },
+            componentId: { type: 'string', description: 'Node ID of a local component' },
+            x: { type: 'number', description: 'X position', default: 0 },
+            y: { type: 'number', description: 'Y position', default: 0 },
+            parentId: { type: 'string', description: 'Parent node ID' },
+        },
+        returns: '{ id, name, type, componentId }',
+        example: `const btn = await figma.createInstance({
+  componentId: "1:234",
+  parentId: frame.id
+});`,
+    },
+    {
+        name: 'figma.cloneNode',
+        category: 'create',
+        description: 'Clone/duplicate a node with optional modifications and offset.',
+        parameters: {
+            nodeId: { type: 'string', description: 'ID of node to clone', required: true },
+            count: { type: 'number', description: 'Number of clones', default: 1 },
+            parentId: { type: 'string', description: 'Parent for clones (default: same as original)' },
+            offsetX: { type: 'number', description: 'X offset per clone', default: 0 },
+            offsetY: { type: 'number', description: 'Y offset per clone', default: 0 },
+            modifications: { type: 'object', description: 'Properties to modify on clones' },
+        },
+        returns: '{ nodes: [{ id, name, type }] }',
+        example: `const clones = await figma.cloneNode({
+  nodeId: "1:23",
+  count: 3,
+  offsetY: 50
+});`,
+    },
+    // === READ ===
+    {
+        name: 'figma.getNode',
+        category: 'read',
+        description: 'Get info about a node. Use depth to control children traversal. Use detailed=true for full styling.',
+        parameters: {
+            nodeId: { type: 'string', description: 'Node ID, Figma URL, or target specifier ("selection", "name:Foo")', required: true },
+            depth: { type: 'number', description: 'Children depth (0=none, 1=direct)', default: 0 },
+            childLimit: { type: 'number', description: 'Max children per node', default: 20 },
+            detailed: { type: 'boolean', description: 'Include full styling details', default: false },
+        },
+        returns: '{ id, name, type, x, y, width, height, children?, ... }',
+        example: `const node = await figma.getNode({
+  nodeId: "1:23",
+  depth: 1, detailed: true
+});`,
+    },
+    {
+        name: 'figma.getSelection',
+        category: 'read',
+        description: 'Get the currently selected nodes in Figma.',
+        parameters: {},
+        returns: '[{ id, name, type, x, y, width, height }]',
+        example: `const sel = await figma.getSelection();
+console.log("Selected:", sel.length, "nodes");`,
+    },
+    {
+        name: 'figma.getCurrentPage',
+        category: 'read',
+        description: 'Get a lightweight tree of the current page with id, name, type, and text content.',
+        parameters: {
+            depth: { type: 'number', description: 'Max traversal depth', default: 10 },
+        },
+        returns: '{ id, name, type, children: [...] }',
+        example: `const page = await figma.getCurrentPage({ depth: 2 });`,
+    },
+    {
+        name: 'figma.getStyles',
+        category: 'read',
+        description: 'Get local styles (colors, text, effects, grids).',
+        parameters: {
+            type: { type: "'PAINT' | 'TEXT' | 'EFFECT' | 'GRID' | 'ALL'", description: 'Style type filter', default: 'ALL' },
+        },
+        returns: '[{ id, name, type, ... }]',
+        example: `const colors = await figma.getStyles({ type: "PAINT" });`,
+    },
+    {
+        name: 'figma.getLocalComponents',
+        category: 'read',
+        description: 'Get all local components and component sets.',
+        parameters: {
+            nameFilter: { type: 'string', description: 'Filter by name (case-insensitive)' },
+            limit: { type: 'number', description: 'Max results', default: 50 },
+        },
+        returns: '[{ id, name, type, componentId, key, ... }]',
+        example: `const buttons = await figma.getLocalComponents({
+  nameFilter: "Button"
+});`,
+    },
+    {
+        name: 'figma.getVariables',
+        category: 'read',
+        description: 'Get variables and variable collections (design tokens).',
+        parameters: {
+            collectionName: { type: 'string', description: 'Filter by collection name' },
+            type: { type: "'COLOR' | 'FLOAT' | 'STRING' | 'BOOLEAN' | 'ALL'", description: 'Variable type filter', default: 'ALL' },
+            limit: { type: 'number', description: 'Max results', default: 100 },
+        },
+        returns: '{ collections: [...], variables: [...] }',
+        example: `const tokens = await figma.getVariables({ type: "COLOR" });`,
+    },
+    {
+        name: 'figma.searchNodes',
+        category: 'read',
+        description: 'Search nodes by name, type, or text content.',
+        parameters: {
+            query: { type: 'string', description: 'Search query (case-insensitive)' },
+            type: { type: 'string', description: "Node type filter (FRAME, TEXT, RECTANGLE, INSTANCE, COMPONENT, etc.)" },
+            caseSensitive: { type: 'boolean', description: 'Case-sensitive search', default: false },
+            limit: { type: 'number', description: 'Max results', default: 50 },
+        },
+        returns: '[{ id, name, type, path }]',
+        example: `const headers = await figma.searchNodes({
+  query: "Header", type: "FRAME"
+});`,
+    },
+    {
+        name: 'figma.captureScreenshot',
+        category: 'read',
+        description: 'Capture a screenshot of a node. Returns base64 data (not MCP image type — use capture_screenshot tool for visual output).',
+        parameters: {
+            nodeId: { type: 'string', description: 'Node ID to capture', required: true },
+            scale: { type: 'number', description: 'Scale factor (1-4)', default: 1 },
+            format: { type: "'PNG' | 'JPG' | 'SVG' | 'PDF'", description: 'Export format', default: 'PNG' },
+        },
+        returns: '{ data: "<base64>", format: "PNG" }',
+        example: `const shot = await figma.captureScreenshot({
+  nodeId: frame.id, scale: 2
+});`,
+    },
+    // === UPDATE ===
+    {
+        name: 'figma.updateNode',
+        category: 'update',
+        description: 'Update properties of an existing node. Colors accept hex strings. Supports CSS-like layout config.',
+        parameters: {
+            nodeId: { type: 'string', description: 'Node ID or target specifier ("selection", "name:Foo")', required: true },
+            properties: { type: 'object', description: 'Properties to update: name, description, x, y, width, height, fillColor/fill, strokeColor/stroke, gradient, opacity, visible, locked, text, fontSize, fontWeight (string or number), cornerRadius, topLeftRadius/topRightRadius/bottomLeftRadius/bottomRightRadius, strokeWeight, strokeAlign, strokeCap, strokeJoin, dashPattern, effects, rotation, blendMode, constraints, minWidth/maxWidth/minHeight/maxHeight, copyFillsFrom, copyStrokesFrom, textAlign, textColor, textAutoResize, lineHeight, letterSpacing, textDecoration, textCase, layout, layoutMode, primaryAxisSizingMode, counterAxisSizingMode, primaryAxisAlignItems, counterAxisAlignItems, itemSpacing, paddingTop/Bottom/Left/Right, layoutWrap, layoutSizingHorizontal, layoutSizingVertical', required: true },
+        },
+        returns: '{ id, name, type, ... }',
+        example: `await figma.updateNode({
+  nodeId: "1:23",
+  properties: {
+    fillColor: { r: 1, g: 0, b: 0 },
+    cornerRadius: 12,
+    layoutMode: "VERTICAL",
+    itemSpacing: 8
+  }
+});`,
+    },
+    {
+        name: 'figma.moveNode',
+        category: 'update',
+        description: 'Move a node to a new parent or reorder within its current parent.',
+        parameters: {
+            nodeId: { type: 'string', description: 'Node ID to move', required: true },
+            parentId: { type: 'string', description: 'New parent node ID' },
+            index: { type: 'number', description: 'Position among siblings (0 = first)' },
+        },
+        returns: '{ id, name, type, parentId }',
+        example: `await figma.moveNode({
+  nodeId: "1:23",
+  parentId: frame.id,
+  index: 0
+});`,
+    },
+    {
+        name: 'figma.swapComponent',
+        category: 'update',
+        description: 'Swap a component instance to a different component or variant.',
+        parameters: {
+            instanceId: { type: 'string', description: 'Instance node ID', required: true },
+            newComponentId: { type: 'string', description: 'New component ID (local)' },
+            newComponentKey: { type: 'string', description: 'New component key (library)' },
+        },
+        returns: '{ id, name, type, componentId }',
+        example: `await figma.swapComponent({
+  instanceId: "1:23",
+  newComponentId: "1:45"
+});`,
+    },
+    // === DELETE ===
+    {
+        name: 'figma.deleteNode',
+        category: 'delete',
+        description: 'Delete a node from the canvas.',
+        parameters: {
+            nodeId: { type: 'string', description: 'Node ID to delete', required: true },
+        },
+        returns: '{ success: true }',
+        example: `await figma.deleteNode({ nodeId: "1:23" });`,
+    },
+    // === UNIFIED CREATE ===
+    {
+        name: 'figma.create',
+        category: 'create',
+        description: 'Unified create with semantic presets and recursive children. Works in both Figma Design and FigJam. In FigJam, frame→section and rectangle→shape are auto-remapped, but prefer explicit FigJam types.',
+        parameters: {
+            type: { type: 'string', description: 'Element type: frame, text, rectangle/rect, ellipse, line, card, button, nav, input, form. FigJam: section, sticky, shape/shape_with_text', required: true },
+            name: { type: 'string', description: 'Node name' },
+            x: { type: 'number', description: 'X position' },
+            y: { type: 'number', description: 'Y position' },
+            width: { type: 'number', description: 'Width (preset provides default)' },
+            height: { type: 'number', description: 'Height (preset provides default)' },
+            parentId: { type: 'string', description: 'Parent node ID or target specifier ("selection", "name:Foo")' },
+            fillColor: { type: 'string | {r,g,b,a?}', description: 'Fill color: hex "#FF0000", rgb "rgb(255,0,0)", or {r,g,b,a?} (0-1). Alias: fill' },
+            strokeColor: { type: 'string | {r,g,b,a?}', description: 'Stroke color (same formats). Alias: stroke' },
+            strokeWeight: { type: 'number', description: 'Stroke width' },
+            strokeAlign: { type: "'INSIDE' | 'OUTSIDE' | 'CENTER'", description: 'Stroke alignment' },
+            dashPattern: { type: 'number[]', description: 'Dash pattern e.g. [8, 4]' },
+            cornerRadius: { type: 'number', description: 'Uniform corner radius' },
+            topLeftRadius: { type: 'number', description: 'Top-left corner radius' },
+            topRightRadius: { type: 'number', description: 'Top-right corner radius' },
+            bottomLeftRadius: { type: 'number', description: 'Bottom-left corner radius' },
+            bottomRightRadius: { type: 'number', description: 'Bottom-right corner radius' },
+            effects: { type: 'Effect[]', description: 'Effects: shadows, blur' },
+            gradient: { type: 'object', description: 'Gradient fill: {type, angle, stops}' },
+            rotation: { type: 'number', description: 'Rotation in degrees' },
+            blendMode: { type: 'string', description: 'Blend mode' },
+            opacity: { type: 'number', description: 'Opacity (0-1)' },
+            constraints: { type: 'object', description: 'Constraints: {horizontal, vertical}' },
+            textAlign: { type: 'string', description: 'Text alignment (text nodes)' },
+            textColor: { type: 'string | {r,g,b,a?}', description: 'Text color (text nodes, overrides fill)' },
+            lineHeight: { type: 'number | string', description: 'Line height (text nodes)' },
+            letterSpacing: { type: 'number | string', description: 'Letter spacing (text nodes)' },
+            textDecoration: { type: 'string', description: 'Text decoration (text nodes)' },
+            textCase: { type: 'string', description: 'Text case (text nodes)' },
+            layout: { type: 'object', description: 'CSS-like layout: { direction: "row"|"column", gap, padding, alignItems, justifyContent, wrap }' },
+            layoutSizingHorizontal: { type: "'FIXED' | 'HUG' | 'FILL'", description: 'Horizontal sizing in auto-layout parent' },
+            layoutSizingVertical: { type: "'FIXED' | 'HUG' | 'FILL'", description: 'Vertical sizing in auto-layout parent' },
+            children: { type: 'CreateParams[]', description: 'Nested children to create recursively (max depth 10)' },
+        },
+        returns: '{ id, name, type, ... , createdChildren? }',
+        example: `const card = await figma.create({
+  type: "card",
+  name: "Profile Card",
+  children: [
+    { type: "text", content: "John Doe", fontSize: 24, fontWeight: "Bold" },
+    { type: "text", content: "Software Engineer", fontSize: 14, fill: "#666666" },
+    { type: "button", children: [
+      { type: "text", content: "Follow", fill: "#FFFFFF" }
+    ]}
+  ]
+});`,
+    },
+    // === TOKENS ===
+    {
+        name: 'figma.createToken',
+        category: 'tokens',
+        description: 'Create a Figma variable (design token). Finds or creates the collection by name.',
+        parameters: {
+            collection: { type: 'string', description: 'Variable collection name', required: true },
+            name: { type: 'string', description: 'Variable name', required: true },
+            type: { type: "'COLOR' | 'NUMBER' | 'STRING' | 'BOOLEAN'", description: 'Variable type', default: 'COLOR' },
+            value: { type: 'string | number | boolean', description: 'Value (COLOR accepts hex strings)', required: true },
+        },
+        returns: '{ id, name, type, collection }',
+        example: `await figma.createToken({
+  collection: "Colors",
+  name: "primary",
+  type: "COLOR",
+  value: "#0066FF"
+});`,
+    },
+    {
+        name: 'figma.bindToken',
+        category: 'tokens',
+        description: 'Bind a variable to a node property. Finds variable by name (exact → suffix → partial match).',
+        parameters: {
+            target: { type: 'string', description: 'Node ID or target specifier', default: 'selection' },
+            token: { type: 'string', description: 'Variable name to bind', required: true },
+            property: { type: 'string', description: 'Property to bind: fill, stroke, cornerRadius, gap, paddingTop/Bottom/Left/Right, fontSize', required: true },
+        },
+        returns: '{ bound: true, node, variable, property }',
+        example: `await figma.bindToken({
+  target: "selection",
+  property: "fill",
+  token: "primary"
+});`,
+    },
+    // === COMPONENTS ===
+    {
+        name: 'figma.toComponent',
+        category: 'components',
+        description: 'Convert a node to a component. Frames/groups convert directly; other types are wrapped first.',
+        parameters: {
+            target: { type: 'string', description: 'Node ID or target specifier', default: 'selection' },
+            name: { type: 'string', description: 'Optional new component name' },
+        },
+        returns: '{ id, name, type: "COMPONENT", ... }',
+        example: `await figma.toComponent({
+  target: "selection",
+  name: "Card"
+});`,
+    },
+    {
+        name: 'figma.createVariants',
+        category: 'components',
+        description: 'Create a component variant set. Supports single property or multi-dimensional (cartesian product).',
+        parameters: {
+            target: { type: 'string', description: 'Node ID or target specifier', default: 'selection' },
+            property: { type: 'string', description: 'Single variant property name (simple form)' },
+            values: { type: 'string[]', description: 'Variant values for single property (min 2)' },
+            properties: { type: 'Record<string, string[]>', description: 'Multi-dimensional: { state: ["default","hover"], size: ["sm","lg"] }' },
+        },
+        returns: '{ componentSetId, componentSetName, variantCount, variants: [{id, name}] }',
+        example: `// Single property
+await figma.createVariants({
+  target: "selection",
+  property: "state",
+  values: ["default", "hover", "disabled"]
+});
+
+// Multi-dimensional (creates 6 variants)
+await figma.createVariants({
+  target: "selection",
+  properties: {
+    state: ["default", "hover", "disabled"],
+    size: ["small", "large"]
+  }
+});`,
+    },
+    {
+        name: 'figma.addComponentProperty',
+        category: 'components',
+        description: 'Add a property definition to a component (text override, boolean toggle, instance swap).',
+        parameters: {
+            target: { type: 'string', description: 'Component node ID or target specifier', default: 'selection' },
+            name: { type: 'string', description: 'Property name (e.g. "Label")', required: true },
+            type: { type: "'TEXT' | 'BOOLEAN' | 'INSTANCE_SWAP'", description: 'Property type', default: 'TEXT' },
+            defaultValue: { type: 'string | boolean', description: 'Default value', default: '""' },
+        },
+        returns: '{ propertyName, type, defaultValue, nodeId }',
+        example: `// Add text and boolean properties to a component
+await figma.addComponentProperty({
+  target: "selection",
+  name: "Label",
+  type: "TEXT",
+  defaultValue: "Button"
+});
+await figma.addComponentProperty({
+  target: "selection",
+  name: "showIcon",
+  type: "BOOLEAN",
+  defaultValue: true
+});`,
+    },
+    {
+        name: 'figma.setInstanceOverride',
+        category: 'components',
+        description: 'Set property overrides on a component instance. Matches property names by prefix (no need for #id suffix).',
+        parameters: {
+            target: { type: 'string', description: 'Instance node ID or target specifier', default: 'selection' },
+            properties: { type: 'Record<string, string | boolean>', description: 'Property overrides: { "Label": "Click me", "showIcon": false }', required: true },
+        },
+        returns: '{ id, name, type, componentProperties }',
+        example: `await figma.setInstanceOverride({
+  target: "selection",
+  properties: {
+    "Label": "Submit",
+    "showIcon": false
+  }
+});`,
+    },
+    // === FIGJAM ===
+    {
+        name: 'figma.createSection',
+        category: 'figjam',
+        description: 'Create a FigJam section — a container that holds stickies, shapes, and text. Sections support nesting and can have fill colors. Use sections as the primary container type in FigJam (replaces frames).',
+        parameters: {
+            name: { type: 'string', description: 'Section name', required: true },
+            x: { type: 'number', description: 'X position', default: 0 },
+            y: { type: 'number', description: 'Y position', default: 0 },
+            width: { type: 'number', description: 'Width in pixels', default: 400 },
+            height: { type: 'number', description: 'Height in pixels', default: 300 },
+            fillColor: { type: 'string | {r,g,b,a?}', description: 'Fill color: hex "#FF0000", rgb(), or {r,g,b}. Alias: fill' },
+            opacity: { type: 'number', description: 'Opacity (0-1)' },
+            parentId: { type: 'string', description: 'Parent node ID (for nesting sections)' },
+        },
+        returns: '{ id, name, type: "SECTION", x, y, width, height }',
+        example: `const section = await figma.createSection({
+  name: "User Research",
+  width: 800, height: 600,
+  fillColor: "#F5F5F5"
+});`,
+    },
+    {
+        name: 'figma.createSticky',
+        category: 'figjam',
+        description: 'Create a FigJam sticky note with text. Stickies are fixed-size (square or wide). Great for text-heavy content, notes, and brainstorming items.',
+        parameters: {
+            text: { type: 'string', description: 'Text content', required: true },
+            x: { type: 'number', description: 'X position', default: 0 },
+            y: { type: 'number', description: 'Y position', default: 0 },
+            fillColor: { type: 'string | {r,g,b,a?}', description: 'Sticky color: hex, rgb(), or {r,g,b}. Alias: fill' },
+            fontSize: { type: 'number', description: 'Font size' },
+            isWideWidth: { type: 'boolean', description: 'Wide rectangular sticky (true) vs square (false)', default: false },
+            opacity: { type: 'number', description: 'Opacity (0-1)' },
+            parentId: { type: 'string', description: 'Parent section ID' },
+        },
+        returns: '{ id, name, type: "STICKY", x, y, width, height, characters }',
+        example: `const note = await figma.createSticky({
+  text: "Key insight from user interview",
+  fillColor: "#FFF9B1",
+  isWideWidth: true,
+  parentId: section.id
+});`,
+    },
+    {
+        name: 'figma.createShape',
+        category: 'figjam',
+        description: 'Create a FigJam shape with optional text. Supports multiple shape types. Use for diagrams, flowcharts, and visual containers.',
+        parameters: {
+            shapeType: { type: 'string', description: 'Shape type. Valid values: SQUARE, ELLIPSE, ROUNDED_RECTANGLE, DIAMOND, TRIANGLE_UP, TRIANGLE_DOWN, PARALLELOGRAM_RIGHT, PARALLELOGRAM_LEFT, ENG_DATABASE, ENG_QUEUE, ENG_FILE, ENG_FOLDER, TRAPEZOID, PREDEFINED_PROCESS, SHIELD, DOCUMENT_SINGLE, DOCUMENT_MULTIPLE, MANUAL_INPUT, HEXAGON, CHEVRON, PENTAGON, OCTAGON, STAR, PLUS, ARROW_LEFT, ARROW_RIGHT, SUMMING_JUNCTION, OR, SPEECH_BUBBLE, INTERNAL_STORAGE', default: 'ROUNDED_RECTANGLE' },
+            text: { type: 'string', description: 'Text content inside the shape' },
+            name: { type: 'string', description: 'Node name' },
+            x: { type: 'number', description: 'X position', default: 0 },
+            y: { type: 'number', description: 'Y position', default: 0 },
+            width: { type: 'number', description: 'Width in pixels', default: 208 },
+            height: { type: 'number', description: 'Height in pixels', default: 208 },
+            fillColor: { type: 'string | {r,g,b,a?}', description: 'Fill color: hex, rgb(), or {r,g,b}. Alias: fill' },
+            strokeColor: { type: 'string | {r,g,b,a?}', description: 'Stroke color. Alias: stroke' },
+            strokeWeight: { type: 'number', description: 'Stroke width' },
+            fontSize: { type: 'number', description: 'Text font size' },
+            opacity: { type: 'number', description: 'Opacity (0-1)' },
+            parentId: { type: 'string', description: 'Parent section ID' },
+        },
+        returns: '{ id, name, type: "SHAPE_WITH_TEXT", x, y, width, height, characters, shapeType }',
+        example: `const box = await figma.createShape({
+  shapeType: "ROUNDED_RECTANGLE",
+  text: "Authentication Service",
+  width: 200, height: 100,
+  fillColor: "#E8F0FE",
+  strokeColor: "#4285F4",
+  parentId: section.id
+});`,
+    },
+    {
+        name: 'figma.createConnector',
+        category: 'figjam',
+        description: 'Create a FigJam connector line between two nodes. Use for flowcharts, diagrams, and showing relationships. Supports arrows, labels, and line styles.',
+        parameters: {
+            startNodeId: { type: 'string', description: 'ID of the node where the connector starts', required: true },
+            endNodeId: { type: 'string', description: 'ID of the node where the connector ends', required: true },
+            startMagnet: { type: 'string', description: 'Start connection point: AUTO, TOP, BOTTOM, LEFT, RIGHT, CENTER', default: 'AUTO' },
+            endMagnet: { type: 'string', description: 'End connection point: AUTO, TOP, BOTTOM, LEFT, RIGHT, CENTER', default: 'AUTO' },
+            connectorLineType: { type: 'string', description: 'Line type: ELBOWED (default, right-angle), STRAIGHT, CURVED' },
+            startStrokeCap: { type: 'string', description: 'Start arrow: NONE, ARROW_LINES, ARROW_EQUILATERAL, CIRCLE_FILLED, DIAMOND_FILLED', default: 'NONE' },
+            endStrokeCap: { type: 'string', description: 'End arrow: NONE, ARROW_LINES, ARROW_EQUILATERAL, CIRCLE_FILLED, DIAMOND_FILLED', default: 'ARROW_LINES' },
+            strokeColor: { type: 'string | {r,g,b,a?}', description: 'Line color. Alias: stroke' },
+            strokeWeight: { type: 'number', description: 'Line width in pixels' },
+            dashPattern: { type: 'number[]', description: 'Dash pattern e.g. [8, 4] for dashed lines' },
+            text: { type: 'string', description: 'Text label on the connector. Alias: label' },
+            name: { type: 'string', description: 'Node name' },
+            opacity: { type: 'number', description: 'Opacity (0-1)' },
+        },
+        returns: '{ id, name, type: "CONNECTOR", connectorStart, connectorEnd, connectorLineType, characters }',
+        example: `const shapeA = await figma.createShape({ text: "Start", fillColor: "#E8F0FE" });
+const shapeB = await figma.createShape({ text: "End", x: 400, fillColor: "#FCE8E6" });
+const connector = await figma.createConnector({
+  startNodeId: shapeA.id,
+  endNodeId: shapeB.id,
+  endStrokeCap: "ARROW_EQUILATERAL",
+  text: "sends data",
+  strokeColor: "#333333"
+});`,
+    },
+    {
+        name: 'figma.getEditorType',
+        category: 'read',
+        description: 'Get the current editor type. Returns "figma" for Figma Design files or "figjam" for FigJam files. Use this to decide which create methods to use.',
+        parameters: {},
+        returns: '{ editorType: "figma" | "figjam" }',
+        example: `const { editorType } = await figma.getEditorType();
+if (editorType === "figjam") {
+  await figma.createSticky({ text: "Hello FigJam!" });
+} else {
+  await figma.createFrame({ name: "Hello Figma!" });
+}`,
+    },
+    // === ACCESSIBILITY ===
+    {
+        name: 'figma.checkAccessibility',
+        category: 'accessibility',
+        description: 'Check accessibility issues: text contrast (WCAG) and touch target sizes (44x44px minimum).',
+        parameters: {
+            target: { type: 'string', description: 'Node ID or target specifier', default: 'page' },
+            level: { type: "'AA' | 'AAA'", description: 'WCAG level', default: 'AA' },
+            autoFix: { type: 'boolean', description: 'Auto-fix issues (adjust text color, resize small targets)', default: false },
+        },
+        returns: '{ issues: [...], totalIssues, fixedCount, passed, level }',
+        example: `const result = await figma.checkAccessibility({
+  target: "page",
+  level: "AA",
+  autoFix: false
+});
+console.log(result.passed ? "All good!" : result.totalIssues + " issues found");`,
+    },
+];
+export function searchRegistry(query, category, detailLevel = 'description') {
+    // Split query into words — an entry matches if ANY word matches (OR logic)
+    const words = query.toLowerCase().split(/\s+/).filter(Boolean);
+    let results = registry.filter((entry) => {
+        const name = entry.name.toLowerCase();
+        const desc = entry.description.toLowerCase();
+        const matchesQuery = words.length === 0 ||
+            words.some((w) => name.includes(w) || desc.includes(w));
+        const matchesCategory = !category || entry.category === category;
+        return matchesQuery && matchesCategory;
+    });
+    switch (detailLevel) {
+        case 'name':
+            return results.map((e) => ({
+                name: e.name,
+                category: e.category,
+            }));
+        case 'description':
+            return results.map((e) => ({
+                name: e.name,
+                category: e.category,
+                description: e.description,
+            }));
+        case 'full':
+            return results;
+    }
+}