@testgorilla/tgo-ui 8.15.0 → 8.17.0

package/mcp/server.mjs

@@ -21116,7 +21116,9 @@ var CatalogStore = class {
       moduleName: c.moduleName,
       inputCount: c.inputs.length,
       outputCount: c.outputs.length,
-      supportsTheme: c.supportsTheme
+      supportsTheme: c.supportsTheme,
+      whenToUse: c.whenToUse ?? [],
+      whenNotToUse: c.whenNotToUse ?? []
     }));
   }
   getByCategory(category) {
@@ -21142,7 +21144,7 @@ function handleListComponents(store, params) {
 function registerListComponentsTool(server, store) {
   server.tool(
     "list_components",
-    "List all available tgo-canopy-ui components. Returns name, selector, category, import path, and input/output counts for each component.",
+    'List all available tgo-canopy-ui components. Returns name, selector, category, import path, description, input/output counts, and "when to use" / "when not to use" guidance for each component.',
     {
       category: external_exports.string().optional().describe(
         'Filter by category. Categories are auto-inferred from Storybook story titles (e.g., "forms", "charts", "dialog", "bars"). Call without category first to discover available categories.'
@@ -21209,6 +21211,8 @@ function calculateScore(component, terms) {
       score += 30;
     } else if (description.includes(term)) {
       score += 10;
+    } else if ((component.whenToUse ?? []).some((b) => b.toLowerCase().includes(term)) || (component.whenNotToUse ?? []).some((b) => b.toLowerCase().includes(term))) {
+      score += 8;
     } else if (component.inputs.some((i) => i.name.toLowerCase().includes(term)) || component.outputs.some((o) => o.name.toLowerCase().includes(term))) {
       score += 5;
     }
@@ -21220,7 +21224,7 @@ function calculateScore(component, terms) {
 function registerSearchComponentsTool(server, store) {
   server.tool(
     "search_components",
-    "Search tgo-canopy-ui components by keyword. Searches across component names, selectors, descriptions, and categories. Returns matching components ranked by relevance.",
+    `Search tgo-canopy-ui components by keyword. Searches across component names, selectors, descriptions, categories, and the "when to use" / "when not to use" usage guidance. Returns matching components ranked by relevance, including each component's usage guidance.`,
     {
       query: external_exports.string().describe('Search query (e.g., "input", "chart", "modal", "form validation")'),
       category: external_exports.string().optional().describe(
@@ -21238,7 +21242,9 @@ function registerSearchComponentsTool(server, store) {
         moduleName: c.moduleName,
         inputCount: c.inputs.length,
         outputCount: c.outputs.length,
-        supportsTheme: c.supportsTheme
+        supportsTheme: c.supportsTheme,
+        whenToUse: c.whenToUse ?? [],
+        whenNotToUse: c.whenNotToUse ?? []
       }));
       return {
         content: [{ type: "text", text: JSON.stringify(summaries, null, 2) }]
@@ -21255,6 +21261,24 @@ function generateUsageGuide(c) {
   lines.push("");
   lines.push(c.description);
   lines.push("");
+  const whenToUse = c.whenToUse ?? [];
+  const whenNotToUse = c.whenNotToUse ?? [];
+  if (whenToUse.length > 0) {
+    lines.push("## When to use");
+    lines.push("");
+    for (const item of whenToUse) {
+      lines.push(`- ${item}`);
+    }
+    lines.push("");
+  }
+  if (whenNotToUse.length > 0) {
+    lines.push("## When NOT to use");
+    lines.push("");
+    for (const item of whenNotToUse) {
+      lines.push(`- ${item}`);
+    }
+    lines.push("");
+  }
   lines.push("## Import");
   lines.push("");
   lines.push("```typescript");
@@ -21350,7 +21374,7 @@ function generateUsageGuide(c) {
 function registerGetUsageGuideTool(server, store) {
   server.tool(
     "get_usage_guide",
-    "Get a complete usage guide for a tgo-canopy-ui component. Returns a markdown document with: exact import statement, module setup instructions, all inputs/outputs with types, TypeScript type definitions, basic usage template, and real examples from Storybook stories.",
+    'Get a complete usage guide for a tgo-canopy-ui component. Returns a markdown document with: "when to use" / "when not to use" guidance, exact import statement, module setup instructions, all inputs/outputs with types, TypeScript type definitions, basic usage template, and real examples from Storybook stories.',
     {
       name: external_exports.string().describe("Component name, selector, or class name")
     },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@testgorilla/tgo-ui",
-  "version": "8.15.0",
+  "version": "8.17.0",
   "license": "proprietary-license",
   "lint-staged": {
     "{projects,components}/**/*.ts": [