canicode 0.8.4 → 0.8.5

package/dist/mcp/server.js

@@ -178,7 +178,7 @@ var RULE_CONFIGS = {
     }
   },
   // ============================================
-  // Component (6 rules)
+  // Component (7 rules)
   // ============================================
   "missing-component": {
     severity: "risk",
@@ -213,6 +213,11 @@ var RULE_CONFIGS = {
     score: -1,
     enabled: true
   },
+  "missing-component-description": {
+    severity: "missing-info",
+    score: -2,
+    enabled: true
+  },
   // ============================================
   // Naming (5 rules)
   // ============================================
@@ -795,6 +800,20 @@ function transformNode(node) {
   }
   return base;
 }
+function transformFileNodesResponse(fileKey, response) {
+  const entries = Object.values(response.nodes);
+  const first = entries[0];
+  if (!first) throw new Error("No nodes returned from Figma API");
+  return {
+    fileKey,
+    name: response.name,
+    lastModified: response.lastModified,
+    version: response.version,
+    document: transformNode(first.document),
+    components: transformComponents(first.components),
+    styles: transformStyles(first.styles)
+  };
+}
 function transformComponents(components) {
   const result = {};
   for (const [id, component] of Object.entries(components)) {
@@ -952,6 +971,13 @@ async function loadFromApi(fileKey, nodeId, token) {
     );
   }
   const client = new FigmaClient({ token: figmaToken });
+  if (nodeId) {
+    const response2 = await client.getFileNodes(fileKey, [nodeId.replace(/-/g, ":")]);
+    return {
+      file: transformFileNodesResponse(fileKey, response2),
+      nodeId
+    };
+  }
   const response = await client.getFile(fileKey);
   return {
     file: transformFigmaResponse(fileKey, response),
@@ -1362,7 +1388,7 @@ function parseDesignData(data, fileKey, fileName) {
 }
 
 // package.json
-var version = "0.8.4";
+var version = "0.8.5";
 var AnalysisNodeTypeSchema = z.enum([
   "DOCUMENT",
   "CANVAS",
@@ -2175,6 +2201,35 @@ defineRule({
   definition: singleUseComponentDef,
   check: singleUseComponentCheck
 });
+var seenMissingDescriptionComponentIds = /* @__PURE__ */ new Set();
+var missingComponentDescriptionDef = {
+  id: "missing-component-description",
+  name: "Missing Component Description",
+  category: "component",
+  why: "Component descriptions in Figma are the primary channel for communicating intent, usage guidelines, and prop expectations to developers. Without them, developers must reverse-engineer purpose from visual appearance alone.",
+  impact: "Increases implementation ambiguity, especially for icon-only components, compound components with multiple variants, and components whose names are variant key strings that give no prose context.",
+  fix: "Open the component in Figma, select it, and add a description in the right-hand panel under the component's properties. Include: what the component is, when to use it, any accessibility or interaction notes, and the owning team or design token set if applicable."
+};
+var missingComponentDescriptionCheck = (node, context) => {
+  if (node.type !== "INSTANCE") return null;
+  const componentId = node.componentId;
+  if (!componentId) return null;
+  const componentMeta = context.file.components[componentId];
+  if (!componentMeta) return null;
+  if (componentMeta.description.trim() !== "") return null;
+  if (seenMissingDescriptionComponentIds.has(componentId)) return null;
+  seenMissingDescriptionComponentIds.add(componentId);
+  return {
+    ruleId: missingComponentDescriptionDef.id,
+    nodeId: node.id,
+    nodePath: context.path.join(" > "),
+    message: `Component "${componentMeta.name}" has no description. Descriptions help developers understand purpose and usage.`
+  };
+};
+defineRule({
+  definition: missingComponentDescriptionDef,
+  check: missingComponentDescriptionCheck
+});
 
 // src/core/rules/naming/index.ts
 var DEFAULT_NAME_PATTERNS = [