@rinova/playground-mcp 0.1.5 → 0.5.0

package/README.md

@@ -46,7 +46,7 @@ export default defineConfig({
 
 ## 工具
 
-| 工具 | 入参 | 返回 |
+| 工具 | 输入 | 返回 |
 |---|---|---|
 | `capability_search` | `query`、`limit?` | 命中的组件 + prop 名 + 场景数 |
 | `capability_get` | `component` | props/events/slots/exposed 全量契约，每个 prop 带 `文件:行号`，附相关场景与未覆盖 props |

package/dist/index.js

@@ -11,9 +11,15 @@ const locate = (root, rel, needle) => {
     if (!fs.existsSync(abs))
         return rel;
     const lines = fs.readFileSync(abs, 'utf8').split('\n');
-    const pattern = new RegExp(`\\b${needle.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}\\b`);
-    const index = lines.findIndex((line) => pattern.test(line));
-    return index >= 0 ? `${rel}:${index + 1}` : rel;
+    const escaped = needle.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    // 先找声明行（`rows?:` / `rows:` / `rows =`），避免命中 JSDoc 里提到的同名词
+    const declaration = new RegExp(`^\\s*(?:readonly\\s+)?${escaped}\\??\\s*[:=]`);
+    const word = new RegExp(`\\b${escaped}\\b`);
+    const isComment = (line) => /^\s*(?:\*|\/\/|<!--)/.test(line);
+    const codeLines = lines.map((line, index) => ({ line, index })).filter((item) => !isComment(item.line));
+    const hit = codeLines.find((item) => declaration.test(item.line)) ??
+        codeLines.find((item) => word.test(item.line));
+    return hit ? `${rel}:${hit.index + 1}` : rel;
 };
 const parseArgs = (argv) => {
     const args = argv.slice(2);
@@ -47,13 +53,39 @@ const formatComponent = (root, component, manifest) => {
         lines.push(`- ${prop.name}: ${prop.type}${flags ? ` (${flags})` : ''}  ← ${locate(root, component.rel, prop.name)}`);
         if (prop.description)
             lines.push(`  ${prop.description}`);
+        for (const field of prop.fields ?? []) {
+            lines.push(`  · ${field.name}: ${field.type}${field.required ? ' (必填)' : ''}${field.description ? ` — ${field.description}` : ''}`);
+        }
+    }
+    if (component.events.length) {
+        lines.push('', '## Events');
+        for (const event of component.events) {
+            lines.push(`- ${event.name} ${event.type}${event.description ? ` — ${event.description}` : ''}`);
+            if (event.signature)
+                lines.push(`  ${event.signature}`);
+            for (const field of event.fields ?? []) {
+                lines.push(`  · ${field.name}: ${field.type}${field.description ? ` — ${field.description}` : ''}`);
+            }
+        }
+    }
+    if (component.slots.length) {
+        lines.push('', '## Slots');
+        for (const slot of component.slots) {
+            lines.push(`- ${slot.name}${slot.description ? ` — ${slot.description}` : ''}`);
+        }
+    }
+    if (component.exposed.length) {
+        lines.push('', '## Exposed');
+        for (const item of component.exposed) {
+            lines.push(`- ${item.name}: ${item.type}${item.description ? ` — ${item.description}` : ''}`);
+        }
+    }
+    if (component.types?.length) {
+        lines.push('', '## Types');
+        for (const item of component.types) {
+            lines.push(`- ${item.name}（${item.kind}，${item.file}）`, '```ts', item.code, '```');
+        }
     }
-    if (component.events.length)
-        lines.push('', `## Events`, ...component.events.map((name) => `- ${name}`));
-    if (component.slots.length)
-        lines.push('', `## Slots`, ...component.slots.map((name) => `- ${name}`));
-    if (component.exposed.length)
-        lines.push('', `## Exposed`, ...component.exposed.map((name) => `- ${name}`));
     const scenes = manifest.scenes.filter((scene) => component.scenes.includes(scene.id));
     lines.push('', '## 相关场景');
     if (!scenes.length)
@@ -84,7 +116,7 @@ const main = async () => {
         process.exitCode = 1;
         return;
     }
-    const server = new McpServer({ name: 'rinova-playground', version: '0.1.0' });
+    const server = new McpServer({ name: 'rinova-playground', version: '0.5.0' });
     server.registerTool('capability_search', {
         title: '搜索组件能力',
         description: '按组件名 / prop 名 / 场景 id 搜索，返回带文件行号的摘要',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rinova/playground-mcp",
-  "version": "0.1.5",
+  "version": "0.5.0",
   "description": "rinova-playground 的 MCP server：把契约清单暴露给 AI 编码工具",
   "type": "module",
   "license": "MIT",