faux-studio 0.3.5 → 0.3.6

package/dist/index.js

@@ -25422,6 +25422,107 @@ function annotate(tool) {
   if (!annotations) return tool;
   return { ...tool, annotations };
 }
+var RESOURCES = [
+  {
+    uri: "figma://file",
+    name: "Current File",
+    description: "File name, pages, and current page info",
+    mimeType: "application/json",
+    script: `
+      const root = figma.root;
+      const page = figma.currentPage;
+      return {
+        name: root.name,
+        currentPage: { id: page.id, name: page.name },
+        pages: root.children.map(p => ({
+          id: p.id,
+          name: p.name,
+          childCount: p.children.length,
+        })),
+      };
+    `
+  },
+  {
+    uri: "figma://selection",
+    name: "Current Selection",
+    description: "Nodes the user has selected in Figma",
+    mimeType: "application/json",
+    script: `
+      const sel = figma.currentPage.selection;
+      return {
+        count: sel.length,
+        selection: sel.map(n => ({
+          id: n.id,
+          name: n.name,
+          type: n.type,
+          x: 'x' in n ? n.x : undefined,
+          y: 'y' in n ? n.y : undefined,
+          width: 'width' in n ? n.width : undefined,
+          height: 'height' in n ? n.height : undefined,
+        })),
+      };
+    `
+  },
+  {
+    uri: "figma://variables",
+    name: "Design Tokens",
+    description: "All variable collections and their variables (colors, spacing, typography tokens)",
+    mimeType: "application/json",
+    script: `
+      const collections = figma.variables.getLocalVariableCollections();
+      return collections.map(c => ({
+        id: c.id,
+        name: c.name,
+        modes: c.modes,
+        variableCount: c.variableIds.length,
+        variables: c.variableIds.map(vid => {
+          const v = figma.variables.getVariableById(vid);
+          if (!v) return null;
+          return {
+            id: v.id,
+            name: v.name,
+            resolvedType: v.resolvedType,
+            valuesByMode: v.valuesByMode,
+          };
+        }).filter(Boolean),
+      }));
+    `
+  },
+  {
+    uri: "figma://components",
+    name: "Components",
+    description: "Local components and component sets in the file",
+    mimeType: "application/json",
+    script: `
+      const nodes = figma.root.findAllWithCriteria({ types: ['COMPONENT', 'COMPONENT_SET'] });
+      return nodes.map(c => ({
+        id: c.id,
+        name: c.name,
+        type: c.type,
+        description: c.description || undefined,
+        parent: c.parent ? { id: c.parent.id, name: c.parent.name } : undefined,
+      }));
+    `
+  },
+  {
+    uri: "figma://styles",
+    name: "Styles",
+    description: "Text styles, paint styles, and effect styles defined in the file",
+    mimeType: "application/json",
+    script: `
+      const textStyles = figma.getLocalTextStyles();
+      const paintStyles = figma.getLocalPaintStyles();
+      const effectStyles = figma.getLocalEffectStyles();
+      return {
+        textStyles: textStyles.map(s => ({
+          id: s.id, name: s.name, fontSize: s.fontSize, fontName: s.fontName,
+        })),
+        paintStyles: paintStyles.map(s => ({ id: s.id, name: s.name })),
+        effectStyles: effectStyles.map(s => ({ id: s.id, name: s.name })),
+      };
+    `
+  }
+];
 var INSTRUCTIONS = `You are connected to Figma Desktop via faux-studio. You can create, modify, and inspect designs using the tools below.
 
 ## Workflow
@@ -25449,6 +25550,14 @@ var INSTRUCTIONS = `You are connected to Figma Desktop via faux-studio. You can
 - \`get_components\` \u2014 list available components
 - \`get_screenshot\` \u2014 visual capture of the canvas
 
+## Resources (via @mentions)
+Resources provide quick read-only access to Figma state without tool calls:
+- \`figma://file\` \u2014 file name, pages, current page
+- \`figma://selection\` \u2014 currently selected nodes
+- \`figma://variables\` \u2014 all design tokens and variable collections
+- \`figma://components\` \u2014 local component library
+- \`figma://styles\` \u2014 text, paint, and effect styles
+
 ## Best Practices
 - Always read the existing design system before creating new elements.
 - Use auto-layout (horizontal/vertical) for responsive layouts \u2014 avoid absolute positioning.
@@ -25457,9 +25566,9 @@ var INSTRUCTIONS = `You are connected to Figma Desktop via faux-studio. You can
 - Create components for reusable UI patterns.`;
 function createMcpServer(deps) {
   const server2 = new Server(
-    { name: "faux-studio", version: "0.3.5" },
+    { name: "faux-studio", version: "0.3.6" },
     {
-      capabilities: { tools: { listChanged: true }, logging: {} },
+      capabilities: { tools: { listChanged: true }, resources: {}, logging: {} },
       instructions: INSTRUCTIONS
     }
   );
@@ -25598,6 +25707,27 @@ Run the \`login\` tool to re-authenticate.` : `Error: ${message}`
       };
     }
   });
+  server2.setRequestHandler(ListResourcesRequestSchema, async () => ({
+    resources: RESOURCES.map(({ uri, name, description, mimeType }) => ({
+      uri,
+      name,
+      description,
+      mimeType
+    }))
+  }));
+  server2.setRequestHandler(ReadResourceRequestSchema, async (request) => {
+    const { uri } = request.params;
+    const resource = RESOURCES.find((r) => r.uri === uri);
+    if (!resource) {
+      throw new Error(`Unknown resource: ${uri}`);
+    }
+    log(`Reading resource: ${uri}`);
+    const result = await deps.executeScript(resource.script);
+    const text = result === void 0 || result === null ? "{}" : typeof result === "string" ? result : JSON.stringify(result, null, 2);
+    return {
+      contents: [{ uri, mimeType: resource.mimeType, text }]
+    };
+  });
   return server2;
 }
 async function startServer(server2) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "faux-studio",
-  "version": "0.3.5",
+  "version": "0.3.6",
   "description": "AI-powered Figma design via MCP — connect any AI client to Figma Desktop",
   "type": "module",
   "bin": {