@corva/ui 3.77.0-6 → 3.77.0-8

package/README.md

@@ -54,8 +54,8 @@ added or updated. Restart your IDE (or reload its MCP servers) afterward, then a
 component to confirm the tools are picked up.
 
 The full MCP docs (all tools and prompts, per-IDE local / monorepo / global setup, troubleshooting, telemetry and
-privacy) ship inside the package as `node_modules/@corva/ui/MCP_README.md`. The latest published copy is also readable
-online: <https://cdn.jsdelivr.net/npm/@corva/ui/MCP_README.md>.
+privacy) ship inside the package as `node_modules/@corva/ui/MCP_README.md`. You can also
+[read the latest published copy online](https://cdn.jsdelivr.net/npm/@corva/ui/MCP_README.md).
 
 ## Figma Code Connect
 

package/mcp-server/server.mjs

@@ -248,7 +248,7 @@ const validateDsn = dsn => {
 
 const MCP_SERVER_VERSION = '1.5.0';
 
-var version = "3.77.0-6";
+var version = "3.77.0-8";
 
 const CORVA_UI_VERSION = version;
 
@@ -37297,6 +37297,19 @@ const componentDocsToolSchema = {
   name: z.string().describe("Component name (e.g., 'Button', 'Tooltip', 'DatePicker')"),
   category: z.enum(['v2', 'v1']).optional().describe('Component category - v2 for modern, v1 for older')
 };
+const CATALOGUES = {
+  v2: componentsV2,
+  v1: componentsV1
+};
+const otherCategory = category => category === 'v2' ? 'v1' : 'v2';
+const findByName = (catalogue, name) => catalogue.find(c => c.name.toLowerCase() === name.toLowerCase());
+
+/**
+ * The one line that keeps a versioned name from answering as the wrong app: 27 names live in both
+ * catalogues, the lookup prefers v2, and an agent editing a v1 app cannot tell from a v2 page that
+ * it was ever offered a choice.
+ */
+const otherVersionLine = (component, category) => `A ${category} ${component.name} also exists. Pass category: "${category}" to get it.`;
 const handleGetComponentDocs = args => {
   const {
     name,
@@ -37306,10 +37319,10 @@ const handleGetComponentDocs = args => {
   // Search in both V2 and V1 if category not specified
   let component;
   if (!category || category === 'v2') {
-    component = componentsV2.find(c => c.name.toLowerCase() === name.toLowerCase());
+    component = findByName(componentsV2, name);
   }
   if (!component && (!category || category === 'v1')) {
-    component = componentsV1.find(c => c.name.toLowerCase() === name.toLowerCase());
+    component = findByName(componentsV1, name);
   }
 
   // Step 2: Try alias resolution
@@ -37319,10 +37332,10 @@ const handleGetComponentDocs = args => {
     if (aliasResult.wasAliased) {
       const searchCategory = aliasResult.aliasCategory;
       if (!searchCategory || searchCategory === 'v2') {
-        component = componentsV2.find(c => c.name.toLowerCase() === aliasResult.resolvedName.toLowerCase());
+        component = findByName(componentsV2, aliasResult.resolvedName);
       }
       if (!component && (!searchCategory || searchCategory === 'v1')) {
-        component = componentsV1.find(c => c.name.toLowerCase() === aliasResult.resolvedName.toLowerCase());
+        component = findByName(componentsV1, aliasResult.resolvedName);
       }
       if (component) {
         aliasNote = `> **Note:** "${name}" resolved to **${component.name}** (${component.category}).\n\n`;
@@ -37334,7 +37347,12 @@ const handleGetComponentDocs = args => {
   if (!component) {
     const allComponents = [...(!category || category === 'v2' ? componentsV2 : []), ...(!category || category === 'v1' ? componentsV1 : [])];
     const suggestions = findSimilarComponents(name, allComponents);
-    let notFoundMsg = `Component "${name}" not found.`;
+
+    // A category was asked for and the other catalogue holds the exact name: say so, with the
+    // argument that gets it. Without this the caller reads "not found" for a component that exists.
+    const asked = category === 'v2' || category === 'v1' ? category : undefined;
+    const elsewhere = asked && findByName(CATALOGUES[otherCategory(asked)], name);
+    let notFoundMsg = asked && elsewhere ? `Component "${name}" not found in ${asked}. ${otherVersionLine(elsewhere, otherCategory(asked))}` : `Component "${name}" not found.`;
     if (suggestions.length > 0) {
       notFoundMsg += ` Did you mean: ${suggestions.join(', ')}?`;
     }
@@ -37359,11 +37377,15 @@ const handleGetComponentDocs = args => {
     caveat
   } = renderImportRecipe(component.importRecipe);
   const importSection = [statement && `**Import:** \`${statement}\``, caveat].filter(Boolean).join('\n');
+  // Only a call with no category was resolved by preference rather than by request. The default
+  // stays v2; the line tells the caller the choice existed.
+  const twin = category ? undefined : findByName(CATALOGUES[otherCategory(component.category)], component.name);
+  const otherVersionSection = twin ? `**Also in ${twin.category}:** ${otherVersionLine(twin, twin.category)}\n` : '';
   const text = `${aliasNote}# ${component.name}
 
 **Category:** ${component.category}
 ${importSection}
-${component.isExperimental ? '**Experimental** - Recently added component, fully functional and safe to use.\n' : ''}${notice ? `${notice}\n` : ''}
+${otherVersionSection}${component.isExperimental ? '**Experimental** - Recently added component, fully functional and safe to use.\n' : ''}${notice ? `${notice}\n` : ''}
 
 ${component.description}
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@corva/ui",
-  "version": "3.77.0-6",
+  "version": "3.77.0-8",
   "license": "UNLICENSED",
   "description": "Shared components/utils for Corva ui projects",
   "repository": {