react-docs-mcp 1.0.6 → 1.2.0

package/dist/index.js

@@ -1,272 +1,21 @@
 #!/usr/bin/env node
 /**
  * index.ts
- * MCP server entry point implementing the protocol
+ * react-docs-mcp entry point: configures the shared engine for react.dev
+ * and starts the MCP server.
  */
-import { Server } from '@modelcontextprotocol/sdk/server/index.js';
-import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
-import { CallToolRequestSchema, ListResourcesRequestSchema, ListToolsRequestSchema, ReadResourceRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
-import { z } from 'zod';
-import { DocsManager } from './docsManager.js';
-import { SearchEngine } from './searchEngine.js';
-import { summarizeContent, extractStructure } from './summarizer.js';
-import CONFIG from './config.js';
-// Initialize components
-const docsManager = new DocsManager();
-const searchEngine = new SearchEngine(docsManager);
-// Create MCP server
-const server = new Server({
-    name: CONFIG.server.name,
-    version: CONFIG.server.version,
-}, {
-    capabilities: {
-        resources: {},
-        tools: {},
-    },
-});
-// Tool input schemas
-const searchDocsSchema = z.object({
-    query: z.string().describe('Search query string'),
-    section: z.string().optional().describe('Filter by section (learn, reference, blog, community)'),
-    limit: z.number().min(1).max(CONFIG.search.maxLimit).optional().describe('Maximum number of results'),
-});
-const getDocSchema = z.object({
-    path: z.string().describe('Document path (e.g., "learn/hooks/useState")'),
-});
-// Register list resources handler
-server.setRequestHandler(ListResourcesRequestSchema, async () => {
-    return {
-        resources: [
-            {
-                uri: 'react-docs://learn',
-                name: 'React Learn Documentation',
-                description: 'Interactive React tutorial and learning materials',
-                mimeType: 'text/plain',
-            },
-            {
-                uri: 'react-docs://reference',
-                name: 'React API Reference',
-                description: 'Complete React API reference documentation',
-                mimeType: 'text/plain',
-            },
-            {
-                uri: 'react-docs://blog',
-                name: 'React Blog',
-                description: 'React team blog posts and announcements',
-                mimeType: 'text/plain',
-            },
-        ],
-    };
-});
-// Register read resource handler
-server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
-    const uri = request.params.uri.toString();
-    // Parse URI: react-docs://{section}/{path}
-    const match = uri.match(/^react-docs:\/\/(.+)$/);
-    if (!match) {
-        throw new Error(`Invalid resource URI: ${uri}`);
-    }
-    const resourcePath = match[1];
-    // If requesting just a section, list docs in that section
-    if (CONFIG.sections.includes(resourcePath)) {
-        const docs = await searchEngine.getDocsBySection(resourcePath);
-        const docList = docs
-            .map(doc => `- ${doc.metadata.title} (${doc.path})`)
-            .join('\n');
-        return {
-            contents: [
-                {
-                    uri,
-                    mimeType: 'text/plain',
-                    text: `# ${resourcePath} Documentation\n\nAvailable documents:\n\n${docList}`,
-                },
-            ],
-        };
-    }
-    // Otherwise, fetch specific document
-    const doc = await searchEngine.getDocByPath(resourcePath);
-    if (!doc) {
-        throw new Error(`Document not found: ${resourcePath}`);
-    }
-    return {
-        contents: [
-            {
-                uri,
-                mimeType: 'text/markdown',
-                text: `# ${doc.metadata.title}\n\n${doc.content}`,
-            },
-        ],
-    };
-});
-// Register list tools handler
-server.setRequestHandler(ListToolsRequestSchema, async () => {
-    return {
-        tools: [
-            {
-                name: 'search_react_docs',
-                description: 'Search across React documentation. Returns relevant documentation pages with snippets.',
-                inputSchema: {
-                    type: 'object',
-                    properties: {
-                        query: {
-                            type: 'string',
-                            description: 'Search query string',
-                        },
-                        section: {
-                            type: 'string',
-                            description: 'Filter by section (learn, reference, blog, community)',
-                            enum: [...CONFIG.sections],
-                        },
-                        limit: {
-                            type: 'number',
-                            description: 'Maximum number of results',
-                            minimum: 1,
-                            maximum: CONFIG.search.maxLimit,
-                        },
-                    },
-                    required: ['query'],
-                },
-            },
-            {
-                name: 'list_sections',
-                description: 'List all available documentation sections',
-                inputSchema: {
-                    type: 'object',
-                    properties: {},
-                },
-            },
-            {
-                name: 'get_doc',
-                description: 'Get a concise summary of a documentation page (~1500 chars). Use search_react_docs first - only call this if you need more detail than the search snippet provides.',
-                inputSchema: {
-                    type: 'object',
-                    properties: {
-                        path: {
-                            type: 'string',
-                            description: 'Document path (e.g., "learn/hooks/useState")',
-                        },
-                    },
-                    required: ['path'],
-                },
-            },
-            {
-                name: 'update_docs',
-                description: 'Pull latest documentation from Git repository',
-                inputSchema: {
-                    type: 'object',
-                    properties: {},
-                },
-            },
-        ],
-    };
-});
-// Register call tool handler
-server.setRequestHandler(CallToolRequestSchema, async (request) => {
-    const { name, arguments: args } = request.params;
-    try {
-        switch (name) {
-            case 'search_react_docs': {
-                const { query, section, limit } = searchDocsSchema.parse(args);
-                const results = await searchEngine.search(query, { section, limit });
-                return {
-                    content: [
-                        {
-                            type: 'text',
-                            text: JSON.stringify(results.map(r => ({
-                                path: r.doc.path,
-                                title: r.doc.metadata.title,
-                                snippet: r.snippet,
-                                score: r.score,
-                                url: `https://react.dev/${r.doc.path}`,
-                            })), null, 2),
-                        },
-                    ],
-                };
-            }
-            case 'list_sections': {
-                const sections = searchEngine.getSections();
-                return {
-                    content: [
-                        {
-                            type: 'text',
-                            text: JSON.stringify(sections, null, 2),
-                        },
-                    ],
-                };
-            }
-            case 'get_doc': {
-                const { path } = getDocSchema.parse(args);
-                const doc = await searchEngine.getDocByPath(path);
-                if (!doc) {
-                    throw new Error(`Document not found: ${path}`);
-                }
-                // Return concise summary instead of full content
-                const summary = summarizeContent(doc.content, 1500);
-                const structure = extractStructure(doc.content);
-                return {
-                    content: [
-                        {
-                            type: 'text',
-                            text: JSON.stringify({
-                                path: doc.path,
-                                section: doc.section,
-                                title: doc.metadata.title,
-                                description: doc.metadata.description,
-                                summary,
-                                structure,
-                                url: `https://react.dev/${doc.path}`,
-                                note: 'This is a summary. Visit the URL for full documentation.',
-                            }, null, 2),
-                        },
-                    ],
-                };
-            }
-            case 'update_docs': {
-                const updated = await docsManager.updateRepo();
-                if (updated) {
-                    // Re-index documents after update
-                    await searchEngine.indexDocuments();
-                }
-                return {
-                    content: [
-                        {
-                            type: 'text',
-                            text: JSON.stringify({
-                                updated,
-                                message: updated
-                                    ? 'Documentation updated successfully'
-                                    : 'Documentation already up to date',
-                            }, null, 2),
-                        },
-                    ],
-                };
-            }
-            default:
-                throw new Error(`Unknown tool: ${name}`);
-        }
-    }
-    catch (error) {
-        if (error instanceof z.ZodError) {
-            throw new Error(`Invalid arguments: ${error.message}`);
-        }
-        throw error;
-    }
-});
-// Start server
-async function main() {
-    console.error('Initializing React Docs MCP Server...');
-    try {
-        // Initialize repository
-        await docsManager.initialize();
-        // Start server with stdio transport
-        const transport = new StdioServerTransport();
-        await server.connect(transport);
-        console.error('React Docs MCP Server running');
-    }
-    catch (error) {
-        console.error('Failed to start server:', error);
-        process.exit(1);
-    }
+import { configure } from './config.js';
+import { reactDocsPreset } from './presets/reactDocs.js';
+import { createServer } from './server.js';
+// package.json's postinstall runs `node dist/index.js --version`; without this
+// guard that would start the server and clone the docs repo during npm install.
+if (process.argv.includes('--version') || process.argv.includes('-v')) {
+    console.log(reactDocsPreset.server.version);
+    process.exit(0);
 }
-main();
+configure(reactDocsPreset);
+createServer().catch(error => {
+    console.error('Failed to start server:', error);
+    process.exit(1);
+});
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;GAGG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EACL,qBAAqB,EACrB,0BAA0B,EAC1B,sBAAsB,EACtB,yBAAyB,GAC1B,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACrE,OAAO,MAAM,MAAM,aAAa,CAAC;AAEjC,wBAAwB;AACxB,MAAM,WAAW,GAAG,IAAI,WAAW,EAAE,CAAC;AACtC,MAAM,YAAY,GAAG,IAAI,YAAY,CAAC,WAAW,CAAC,CAAC;AAEnD,oBAAoB;AACpB,MAAM,MAAM,GAAG,IAAI,MAAM,CACvB;IACE,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI;IACxB,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO;CAC/B,EACD;IACE,YAAY,EAAE;QACZ,SAAS,EAAE,EAAE;QACb,KAAK,EAAE,EAAE;KACV;CACF,CACF,CAAC;AAEF,qBAAqB;AACrB,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qBAAqB,CAAC;IACjD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uDAAuD,CAAC;IAChG,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2BAA2B,CAAC;CACtG,CAAC,CAAC;AAEH,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8CAA8C,CAAC;CAC1E,CAAC,CAAC;AAEH,kCAAkC;AAClC,MAAM,CAAC,iBAAiB,CAAC,0BAA0B,EAAE,KAAK,IAAI,EAAE;IAC9D,OAAO;QACL,SAAS,EAAE;YACT;gBACE,GAAG,EAAE,oBAAoB;gBACzB,IAAI,EAAE,2BAA2B;gBACjC,WAAW,EAAE,mDAAmD;gBAChE,QAAQ,EAAE,YAAY;aACvB;YACD;gBACE,GAAG,EAAE,wBAAwB;gBAC7B,IAAI,EAAE,qBAAqB;gBAC3B,WAAW,EAAE,4CAA4C;gBACzD,QAAQ,EAAE,YAAY;aACvB;YACD;gBACE,GAAG,EAAE,mBAAmB;gBACxB,IAAI,EAAE,YAAY;gBAClB,WAAW,EAAE,yCAAyC;gBACtD,QAAQ,EAAE,YAAY;aACvB;SACF;KACF,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,iCAAiC;AACjC,MAAM,CAAC,iBAAiB,CAAC,yBAAyB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;IACpE,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;IAE1C,2CAA2C;IAC3C,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC;IACjD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,yBAAyB,GAAG,EAAE,CAAC,CAAC;IAClD,CAAC;IAED,MAAM,YAAY,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IAE9B,0DAA0D;IAC1D,IAAI,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,YAAmB,CAAC,EAAE,CAAC;QAClD,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC,gBAAgB,CAAC,YAAY,CAAC,CAAC;QAC/D,MAAM,OAAO,GAAG,IAAI;aACjB,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,KAAK,GAAG,CAAC,QAAQ,CAAC,KAAK,KAAK,GAAG,CAAC,IAAI,GAAG,CAAC;aACnD,IAAI,CAAC,IAAI,CAAC,CAAC;QAEd,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,GAAG;oBACH,QAAQ,EAAE,YAAY;oBACtB,IAAI,EAAE,KAAK,YAAY,6CAA6C,OAAO,EAAE;iBAC9E;aACF;SACF,CAAC;IACJ,CAAC;IAED,qCAAqC;IACrC,MAAM,GAAG,GAAG,MAAM,YAAY,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC;IAE1D,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CAAC,uBAAuB,YAAY,EAAE,CAAC,CAAC;IACzD,CAAC;IAED,OAAO;QACL,QAAQ,EAAE;YACR;gBACE,GAAG;gBACH,QAAQ,EAAE,eAAe;gBACzB,IAAI,EAAE,KAAK,GAAG,CAAC,QAAQ,CAAC,KAAK,OAAO,GAAG,CAAC,OAAO,EAAE;aAClD;SACF;KACF,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,8BAA8B;AAC9B,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,IAAI,EAAE;IAC1D,OAAO;QACL,KAAK,EAAE;YACL;gBACE,IAAI,EAAE,mBAAmB;gBACzB,WAAW,EAAE,wFAAwF;gBACrG,WAAW,EAAE;oBACX,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE;wBACV,KAAK,EAAE;4BACL,IAAI,EAAE,QAAQ;4BACd,WAAW,EAAE,qBAAqB;yBACnC;wBACD,OAAO,EAAE;4BACP,IAAI,EAAE,QAAQ;4BACd,WAAW,EAAE,uDAAuD;4BACpE,IAAI,EAAE,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC;yBAC3B;wBACD,KAAK,EAAE;4BACL,IAAI,EAAE,QAAQ;4BACd,WAAW,EAAE,2BAA2B;4BACxC,OAAO,EAAE,CAAC;4BACV,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,QAAQ;yBAChC;qBACF;oBACD,QAAQ,EAAE,CAAC,OAAO,CAAC;iBACpB;aACF;YACD;gBACE,IAAI,EAAE,eAAe;gBACrB,WAAW,EAAE,2CAA2C;gBACxD,WAAW,EAAE;oBACX,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE,EAAE;iBACf;aACF;YACD;gBACE,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,qKAAqK;gBAClL,WAAW,EAAE;oBACX,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE;wBACV,IAAI,EAAE;4BACJ,IAAI,EAAE,QAAQ;4BACd,WAAW,EAAE,8CAA8C;yBAC5D;qBACF;oBACD,QAAQ,EAAE,CAAC,MAAM,CAAC;iBACnB;aACF;YACD;gBACE,IAAI,EAAE,aAAa;gBACnB,WAAW,EAAE,+CAA+C;gBAC5D,WAAW,EAAE;oBACX,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE,EAAE;iBACf;aACF;SACF;KACF,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,6BAA6B;AAC7B,MAAM,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;IAChE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAEjD,IAAI,CAAC;QACH,QAAQ,IAAI,EAAE,CAAC;YACb,KAAK,mBAAmB,CAAC,CAAC,CAAC;gBACzB,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,gBAAgB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAC/D,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;gBAErE,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;gCAChB,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI;gCAChB,KAAK,EAAE,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK;gCAC3B,OAAO,EAAE,CAAC,CAAC,OAAO;gCAClB,KAAK,EAAE,CAAC,CAAC,KAAK;gCACd,GAAG,EAAE,qBAAqB,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE;6BACvC,CAAC,CAAC,EACH,IAAI,EACJ,CAAC,CACF;yBACF;qBACF;iBACF,CAAC;YACJ,CAAC;YAED,KAAK,eAAe,CAAC,CAAC,CAAC;gBACrB,MAAM,QAAQ,GAAG,YAAY,CAAC,WAAW,EAAE,CAAC;gBAE5C,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;yBACxC;qBACF;iBACF,CAAC;YACJ,CAAC;YAED,KAAK,SAAS,CAAC,CAAC,CAAC;gBACf,MAAM,EAAE,IAAI,EAAE,GAAG,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAC1C,MAAM,GAAG,GAAG,MAAM,YAAY,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;gBAElD,IAAI,CAAC,GAAG,EAAE,CAAC;oBACT,MAAM,IAAI,KAAK,CAAC,uBAAuB,IAAI,EAAE,CAAC,CAAC;gBACjD,CAAC;gBAED,iDAAiD;gBACjD,MAAM,OAAO,GAAG,gBAAgB,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;gBACpD,MAAM,SAAS,GAAG,gBAAgB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;gBAEhD,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;gCACE,IAAI,EAAE,GAAG,CAAC,IAAI;gCACd,OAAO,EAAE,GAAG,CAAC,OAAO;gCACpB,KAAK,EAAE,GAAG,CAAC,QAAQ,CAAC,KAAK;gCACzB,WAAW,EAAE,GAAG,CAAC,QAAQ,CAAC,WAAW;gCACrC,OAAO;gCACP,SAAS;gCACT,GAAG,EAAE,qBAAqB,GAAG,CAAC,IAAI,EAAE;gCACpC,IAAI,EAAE,0DAA0D;6BACjE,EACD,IAAI,EACJ,CAAC,CACF;yBACF;qBACF;iBACF,CAAC;YACJ,CAAC;YAED,KAAK,aAAa,CAAC,CAAC,CAAC;gBACnB,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,UAAU,EAAE,CAAC;gBAE/C,IAAI,OAAO,EAAE,CAAC;oBACZ,kCAAkC;oBAClC,MAAM,YAAY,CAAC,cAAc,EAAE,CAAC;gBACtC,CAAC;gBAED,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;gCACE,OAAO;gCACP,OAAO,EAAE,OAAO;oCACd,CAAC,CAAC,oCAAoC;oCACtC,CAAC,CAAC,kCAAkC;6BACvC,EACD,IAAI,EACJ,CAAC,CACF;yBACF;qBACF;iBACF,CAAC;YACJ,CAAC;YAED;gBACE,MAAM,IAAI,KAAK,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,CAAC,CAAC,QAAQ,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CAAC,sBAAsB,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QACzD,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,eAAe;AACf,KAAK,UAAU,IAAI;IACjB,OAAO,CAAC,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAEvD,IAAI,CAAC;QACH,wBAAwB;QACxB,MAAM,WAAW,CAAC,UAAU,EAAE,CAAC;QAE/B,oCAAoC;QACpC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;QAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAEhC,OAAO,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC;IACjD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,yBAAyB,EAAE,KAAK,CAAC,CAAC;QAChD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;GAIG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,+EAA+E;AAC/E,gFAAgF;AAChF,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;IACtE,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC5C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,SAAS,CAAC,eAAe,CAAC,CAAC;AAE3B,YAAY,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE;IAC3B,OAAO,CAAC,KAAK,CAAC,yBAAyB,EAAE,KAAK,CAAC,CAAC;IAChD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/markdownParser.d.ts

@@ -22,4 +22,13 @@ export declare function markdownToPlainText(markdown: string): Promise<string>;
  * E.g., "learn/hooks/useState.md" -> "learn"
  */
 export declare function extractSection(path: string): string;
+/**
+ * Normalize path (forward slashes, no leading slash, no .md extension for display)
+ */
+export declare function normalizePath(filePath: string): string;
+/**
+ * Convert a kebab-case or snake_case slug to Title Case
+ * E.g., "the-new-architecture" -> "The New Architecture"
+ */
+export declare function titleCase(slug: string): string;
 //# sourceMappingURL=markdownParser.d.ts.map

package/dist/markdownParser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"markdownParser.d.ts","sourceRoot":"","sources":["../src/markdownParser.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EAAe,SAAS,EAAE,MAAM,YAAY,CAAC;AAEzD;;;;;GAKG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,SAAS,CAAC,CA2BpB;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAQ3E;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAInD"}
+{"version":3,"file":"markdownParser.d.ts","sourceRoot":"","sources":["../src/markdownParser.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EAAe,SAAS,EAAE,MAAM,YAAY,CAAC;AAEzD;;;;;GAKG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,SAAS,CAAC,CA2BpB;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAQ3E;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAInD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAKtD;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAM9C"}

package/dist/markdownParser.js

@@ -61,11 +61,22 @@ export function extractSection(path) {
 /**
  * Normalize path (forward slashes, no leading slash, no .md extension for display)
  */
-function normalizePath(filePath) {
+export function normalizePath(filePath) {
     return filePath
         .replace(/\\/g, '/') // Convert backslashes to forward slashes
         .replace(/^\/+/, '') // Remove leading slashes
-        .replace(/\.md$/, ''); // Remove .md extension for cleaner paths
+        .replace(/\.mdx?$/, ''); // Remove .md/.mdx extension for cleaner paths
+}
+/**
+ * Convert a kebab-case or snake_case slug to Title Case
+ * E.g., "the-new-architecture" -> "The New Architecture"
+ */
+export function titleCase(slug) {
+    return slug
+        .replace(/[-_]/g, ' ')
+        .split(' ')
+        .map(word => word.charAt(0).toUpperCase() + word.slice(1))
+        .join(' ');
 }
 /**
  * Extract title from path if not in frontmatter
@@ -75,11 +86,6 @@ function extractTitleFromPath(filePath) {
     const normalized = normalizePath(filePath);
     const parts = normalized.split('/');
     const filename = parts[parts.length - 1] || 'Untitled';
-    // Convert kebab-case or snake_case to Title Case
-    return filename
-        .replace(/[-_]/g, ' ')
-        .split(' ')
-        .map(word => word.charAt(0).toUpperCase() + word.slice(1))
-        .join(' ');
+    return titleCase(filename);
 }
 //# sourceMappingURL=markdownParser.js.map

package/dist/markdownParser.js.map

@@ -1 +1 @@
-{"version":3,"file":"markdownParser.js","sourceRoot":"","sources":["../src/markdownParser.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,MAAM,MAAM,aAAa,CAAC;AACjC,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,aAAa,MAAM,gBAAgB,CAAC;AAG3C;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,OAAe,EACf,IAAY;IAEZ,oBAAoB;IACpB,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,eAAe,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IAE3D,mBAAmB;IACnB,MAAM,QAAQ,GAAgB;QAC5B,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,oBAAoB,CAAC,IAAI,CAAC;QAC/C,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,GAAG,IAAI;KACR,CAAC;IAEF,mCAAmC;IACnC,MAAM,SAAS,GAAG,MAAM,mBAAmB,CAAC,eAAe,CAAC,CAAC;IAE7D,4BAA4B;IAC5B,MAAM,OAAO,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;IAErC,OAAO;QACL,IAAI,EAAE,aAAa,CAAC,IAAI,CAAC;QACzB,OAAO;QACP,QAAQ;QACR,OAAO,EAAE,eAAe;QACxB,SAAS;KACV,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,QAAgB;IACxD,MAAM,MAAM,GAAG,MAAM,MAAM,EAAE;SAC1B,GAAG,CAAC,aAAa,CAAC;SAClB,OAAO,CAAC,QAAQ,CAAC,CAAC;IAErB,OAAO,MAAM,CAAC,MAAM,CAAC;SAClB,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,uBAAuB;SAC5C,IAAI,EAAE,CAAC;AACZ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,MAAM,UAAU,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IACvC,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACpC,OAAO,KAAK,CAAC,CAAC,CAAC,IAAI,SAAS,CAAC;AAC/B,CAAC;AAED;;GAEG;AACH,SAAS,aAAa,CAAC,QAAgB;IACrC,OAAO,QAAQ;SACZ,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,yCAAyC;SAC7D,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,yBAAyB;SAC7C,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC,yCAAyC;AACpE,CAAC;AAED;;;GAGG;AACH,SAAS,oBAAoB,CAAC,QAAgB;IAC5C,MAAM,UAAU,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;IAC3C,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACpC,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,UAAU,CAAC;IAEvD,iDAAiD;IACjD,OAAO,QAAQ;SACZ,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC;SACrB,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;SACzD,IAAI,CAAC,GAAG,CAAC,CAAC;AACf,CAAC"}
+{"version":3,"file":"markdownParser.js","sourceRoot":"","sources":["../src/markdownParser.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,MAAM,MAAM,aAAa,CAAC;AACjC,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,aAAa,MAAM,gBAAgB,CAAC;AAG3C;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,OAAe,EACf,IAAY;IAEZ,oBAAoB;IACpB,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,eAAe,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IAE3D,mBAAmB;IACnB,MAAM,QAAQ,GAAgB;QAC5B,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,oBAAoB,CAAC,IAAI,CAAC;QAC/C,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,GAAG,IAAI;KACR,CAAC;IAEF,mCAAmC;IACnC,MAAM,SAAS,GAAG,MAAM,mBAAmB,CAAC,eAAe,CAAC,CAAC;IAE7D,4BAA4B;IAC5B,MAAM,OAAO,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;IAErC,OAAO;QACL,IAAI,EAAE,aAAa,CAAC,IAAI,CAAC;QACzB,OAAO;QACP,QAAQ;QACR,OAAO,EAAE,eAAe;QACxB,SAAS;KACV,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,QAAgB;IACxD,MAAM,MAAM,GAAG,MAAM,MAAM,EAAE;SAC1B,GAAG,CAAC,aAAa,CAAC;SAClB,OAAO,CAAC,QAAQ,CAAC,CAAC;IAErB,OAAO,MAAM,CAAC,MAAM,CAAC;SAClB,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,uBAAuB;SAC5C,IAAI,EAAE,CAAC;AACZ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,MAAM,UAAU,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IACvC,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACpC,OAAO,KAAK,CAAC,CAAC,CAAC,IAAI,SAAS,CAAC;AAC/B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,QAAgB;IAC5C,OAAO,QAAQ;SACZ,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,yCAAyC;SAC7D,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,yBAAyB;SAC7C,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,CAAC,8CAA8C;AAC3E,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,OAAO,IAAI;SACR,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC;SACrB,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;SACzD,IAAI,CAAC,GAAG,CAAC,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,SAAS,oBAAoB,CAAC,QAAgB;IAC5C,MAAM,UAAU,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;IAC3C,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACpC,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,UAAU,CAAC;IAEvD,OAAO,SAAS,CAAC,QAAQ,CAAC,CAAC;AAC7B,CAAC"}

package/dist/presets/reactDocs.d.ts

@@ -0,0 +1,7 @@
+/**
+ * reactDocs.ts
+ * Preset for the default react-docs-mcp package: github.com/reactjs/react.dev.git
+ */
+import type { DocsMcpPreset } from '../config.js';
+export declare const reactDocsPreset: DocsMcpPreset;
+//# sourceMappingURL=reactDocs.d.ts.map

package/dist/presets/reactDocs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reactDocs.d.ts","sourceRoot":"","sources":["../../src/presets/reactDocs.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAGlD,eAAO,MAAM,eAAe,EAAE,aAqC7B,CAAC"}

package/dist/presets/reactDocs.js

@@ -0,0 +1,44 @@
+/**
+ * reactDocs.ts
+ * Preset for the default react-docs-mcp package: github.com/reactjs/react.dev.git
+ */
+import { DEFAULT_SEARCH } from './searchDefaults.js';
+export const reactDocsPreset = {
+    cacheDirName: 'react-docs-mcp',
+    repoFolderName: 'react-dev-repo',
+    repo: {
+        url: 'https://github.com/reactjs/react.dev.git',
+        contentPath: 'src/content',
+    },
+    search: { ...DEFAULT_SEARCH },
+    server: {
+        name: 'react-docs-mcp',
+        version: '1.2.0',
+    },
+    sections: ['learn', 'reference', 'blog', 'community'],
+    resourceUriScheme: 'react-docs',
+    docsLabel: 'React',
+    searchToolName: 'search_react_docs',
+    searchToolDescription: 'Search across React documentation. Returns relevant documentation pages with snippets.',
+    pathExample: 'reference/react/useState',
+    docUrl: { base: 'https://react.dev', useFrontmatterId: false },
+    sectionResourceOverrides: {
+        learn: {
+            name: 'React Learn Documentation',
+            description: 'Interactive React tutorial and learning materials',
+        },
+        reference: {
+            name: 'React API Reference',
+            description: 'Complete React API reference documentation',
+        },
+        blog: {
+            name: 'React Blog',
+            description: 'React team blog posts and announcements',
+        },
+        community: {
+            name: 'React Community Documentation',
+            description: 'Community resources, code of conduct, and translations',
+        },
+    },
+};
+//# sourceMappingURL=reactDocs.js.map

package/dist/presets/reactDocs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reactDocs.js","sourceRoot":"","sources":["../../src/presets/reactDocs.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD,MAAM,CAAC,MAAM,eAAe,GAAkB;IAC5C,YAAY,EAAE,gBAAgB;IAC9B,cAAc,EAAE,gBAAgB;IAChC,IAAI,EAAE;QACJ,GAAG,EAAE,0CAA0C;QAC/C,WAAW,EAAE,aAAa;KAC3B;IACD,MAAM,EAAE,EAAE,GAAG,cAAc,EAAE;IAC7B,MAAM,EAAE;QACN,IAAI,EAAE,gBAAgB;QACtB,OAAO,EAAE,OAAO;KACjB;IACD,QAAQ,EAAE,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW,CAAC;IACrD,iBAAiB,EAAE,YAAY;IAC/B,SAAS,EAAE,OAAO;IAClB,cAAc,EAAE,mBAAmB;IACnC,qBAAqB,EAAE,wFAAwF;IAC/G,WAAW,EAAE,0BAA0B;IACvC,MAAM,EAAE,EAAE,IAAI,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,KAAK,EAAE;IAC9D,wBAAwB,EAAE;QACxB,KAAK,EAAE;YACL,IAAI,EAAE,2BAA2B;YACjC,WAAW,EAAE,mDAAmD;SACjE;QACD,SAAS,EAAE;YACT,IAAI,EAAE,qBAAqB;YAC3B,WAAW,EAAE,4CAA4C;SAC1D;QACD,IAAI,EAAE;YACJ,IAAI,EAAE,YAAY;YAClB,WAAW,EAAE,yCAAyC;SACvD;QACD,SAAS,EAAE;YACT,IAAI,EAAE,+BAA+B;YACrC,WAAW,EAAE,wDAAwD;SACtE;KACF;CACF,CAAC"}

package/dist/presets/reactNativeDocs.d.ts

@@ -0,0 +1,21 @@
+/**
+ * reactNativeDocs.ts
+ * Preset for react-native-docs-mcp: github.com/facebook/react-native-website.git
+ *
+ * Structure verified directly against the repo (Docusaurus-based):
+ * - Docs live at root `docs/` (not under `website/`), 230 .md + 9 .mdx files.
+ * - 213 of 241 files sit flat at `docs/` root with no section; only
+ *   `the-new-architecture/`, `legacy/`, and `releases/` are real subfolders
+ *   (older versioned snapshots may lack some — the server filters advertised
+ *   sections to those that exist on disk at runtime).
+ * - "latest" targets the unversioned root `docs/` folder; pinned versions
+ *   target `website/versioned_docs/version-X.YY/` inside the same clone.
+ * - Docusaurus routes by frontmatter `id` when present (in all versions), so
+ *   the engine resolves ids into canonical doc paths/slugs at index time
+ *   (docUrl.useFrontmatterId).
+ * - website/blog/ is a separate content root and is out of scope for v1.
+ */
+import type { DocsMcpPreset } from '../config.js';
+export declare const LATEST_VERSION = "latest";
+export declare function resolveReactNativeDocsPreset(version?: string): DocsMcpPreset;
+//# sourceMappingURL=reactNativeDocs.d.ts.map

package/dist/presets/reactNativeDocs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reactNativeDocs.d.ts","sourceRoot":"","sources":["../../src/presets/reactNativeDocs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAGlD,eAAO,MAAM,cAAc,WAAW,CAAC;AAEvC,wBAAgB,4BAA4B,CAAC,OAAO,GAAE,MAAuB,GAAG,aAAa,CAkC5F"}

package/dist/presets/reactNativeDocs.js

@@ -0,0 +1,51 @@
+/**
+ * reactNativeDocs.ts
+ * Preset for react-native-docs-mcp: github.com/facebook/react-native-website.git
+ *
+ * Structure verified directly against the repo (Docusaurus-based):
+ * - Docs live at root `docs/` (not under `website/`), 230 .md + 9 .mdx files.
+ * - 213 of 241 files sit flat at `docs/` root with no section; only
+ *   `the-new-architecture/`, `legacy/`, and `releases/` are real subfolders
+ *   (older versioned snapshots may lack some — the server filters advertised
+ *   sections to those that exist on disk at runtime).
+ * - "latest" targets the unversioned root `docs/` folder; pinned versions
+ *   target `website/versioned_docs/version-X.YY/` inside the same clone.
+ * - Docusaurus routes by frontmatter `id` when present (in all versions), so
+ *   the engine resolves ids into canonical doc paths/slugs at index time
+ *   (docUrl.useFrontmatterId).
+ * - website/blog/ is a separate content root and is out of scope for v1.
+ */
+import { DEFAULT_SEARCH } from './searchDefaults.js';
+export const LATEST_VERSION = 'latest';
+export function resolveReactNativeDocsPreset(version = LATEST_VERSION) {
+    const isLatest = version === LATEST_VERSION;
+    if (!isLatest && !/^\d+\.\d+$/.test(version)) {
+        throw new Error(`Invalid React Native docs version "${version}". Expected a release like "0.77" or "${LATEST_VERSION}".`);
+    }
+    return {
+        cacheDirName: 'react-native-docs-mcp',
+        repoFolderName: 'react-native-website-repo',
+        repo: {
+            url: 'https://github.com/facebook/react-native-website.git',
+            contentPath: isLatest ? 'docs' : `website/versioned_docs/version-${version}`,
+        },
+        search: { ...DEFAULT_SEARCH },
+        server: {
+            name: 'react-native-docs-mcp',
+            version: '0.2.0',
+        },
+        sections: ['the-new-architecture', 'legacy', 'releases'],
+        resourceUriScheme: 'react-native-docs',
+        docsLabel: 'React Native',
+        searchToolName: 'search_react_native_docs',
+        searchToolDescription: 'Search across React Native documentation. Returns relevant documentation pages with snippets.',
+        pathExample: 'the-new-architecture/using-codegen',
+        docUrl: {
+            base: isLatest ? 'https://reactnative.dev/docs' : `https://reactnative.dev/docs/${version}`,
+            // Frontmatter-id routing is a property of the Docusaurus content format,
+            // not of the version — versioned snapshots carry the same id overrides
+            useFrontmatterId: true,
+        },
+    };
+}
+//# sourceMappingURL=reactNativeDocs.js.map

package/dist/presets/reactNativeDocs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reactNativeDocs.js","sourceRoot":"","sources":["../../src/presets/reactNativeDocs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD,MAAM,CAAC,MAAM,cAAc,GAAG,QAAQ,CAAC;AAEvC,MAAM,UAAU,4BAA4B,CAAC,UAAkB,cAAc;IAC3E,MAAM,QAAQ,GAAG,OAAO,KAAK,cAAc,CAAC;IAE5C,IAAI,CAAC,QAAQ,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAC7C,MAAM,IAAI,KAAK,CACb,sCAAsC,OAAO,yCAAyC,cAAc,IAAI,CACzG,CAAC;IACJ,CAAC;IAED,OAAO;QACL,YAAY,EAAE,uBAAuB;QACrC,cAAc,EAAE,2BAA2B;QAC3C,IAAI,EAAE;YACJ,GAAG,EAAE,sDAAsD;YAC3D,WAAW,EAAE,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,kCAAkC,OAAO,EAAE;SAC7E;QACD,MAAM,EAAE,EAAE,GAAG,cAAc,EAAE;QAC7B,MAAM,EAAE;YACN,IAAI,EAAE,uBAAuB;YAC7B,OAAO,EAAE,OAAO;SACjB;QACD,QAAQ,EAAE,CAAC,sBAAsB,EAAE,QAAQ,EAAE,UAAU,CAAC;QACxD,iBAAiB,EAAE,mBAAmB;QACtC,SAAS,EAAE,cAAc;QACzB,cAAc,EAAE,0BAA0B;QAC1C,qBAAqB,EAAE,+FAA+F;QACtH,WAAW,EAAE,oCAAoC;QACjD,MAAM,EAAE;YACN,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,8BAA8B,CAAC,CAAC,CAAC,gCAAgC,OAAO,EAAE;YAC3F,yEAAyE;YACzE,uEAAuE;YACvE,gBAAgB,EAAE,IAAI;SACvB;KACF,CAAC;AACJ,CAAC"}

package/dist/presets/searchDefaults.d.ts

@@ -0,0 +1,9 @@
+/**
+ * searchDefaults.ts
+ * Shared search tuning used by all presets — single source of truth so a
+ * ranking change can't silently apply to one published server but not the other.
+ * (Type-only import from config.js keeps this module free of runtime cycles.)
+ */
+import type { SearchConfig } from '../config.js';
+export declare const DEFAULT_SEARCH: SearchConfig;
+//# sourceMappingURL=searchDefaults.d.ts.map

package/dist/presets/searchDefaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"searchDefaults.d.ts","sourceRoot":"","sources":["../../src/presets/searchDefaults.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEjD,eAAO,MAAM,cAAc,EAAE,YAQ5B,CAAC"}

package/dist/presets/searchDefaults.js

@@ -0,0 +1,16 @@
+/**
+ * searchDefaults.ts
+ * Shared search tuning used by all presets — single source of truth so a
+ * ranking change can't silently apply to one published server but not the other.
+ * (Type-only import from config.js keeps this module free of runtime cycles.)
+ */
+export const DEFAULT_SEARCH = {
+    defaultLimit: 10,
+    maxLimit: 50,
+    minScore: 0.1,
+    semanticSearchEnabled: true,
+    semanticMinSimilarity: 0.3,
+    hybridKeywordWeight: 0.3,
+    hybridSemanticWeight: 0.7,
+};
+//# sourceMappingURL=searchDefaults.js.map

package/dist/presets/searchDefaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"searchDefaults.js","sourceRoot":"","sources":["../../src/presets/searchDefaults.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,CAAC,MAAM,cAAc,GAAiB;IAC1C,YAAY,EAAE,EAAE;IAChB,QAAQ,EAAE,EAAE;IACZ,QAAQ,EAAE,GAAG;IACb,qBAAqB,EAAE,IAAI;IAC3B,qBAAqB,EAAE,GAAG;IAC1B,mBAAmB,EAAE,GAAG;IACxB,oBAAoB,EAAE,GAAG;CAC1B,CAAC"}

package/dist/searchEngine.d.ts

@@ -4,6 +4,12 @@
  */
 import { DocsManager } from './docsManager.js';
 import type { ParsedDoc, SearchOptions, SearchResult } from './types.js';
+/**
+ * Resolve the canonical slug for a doc: Docusaurus-style sites route by
+ * frontmatter `id` when present, overriding the file-path-derived slug.
+ * Returns the path unchanged for missing/non-string ids.
+ */
+export declare function resolveDocSlug(path: string, id: unknown): string;
 export declare class SearchEngine {
     private docsManager;
     private embeddingService;
@@ -54,10 +60,6 @@ export declare class SearchEngine {
      * @returns Parsed document or null if not found
      */
     getDocByPath(path: string): Promise<ParsedDoc | null>;
-    /**
-     * List all available sections
-     */
-    getSections(): string[];
     /**
      * Get all documents in a section
      */

package/dist/searchEngine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"searchEngine.d.ts","sourceRoot":"","sources":["../src/searchEngine.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAI/C,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAEzE,qBAAa,YAAY;IACvB,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,aAAa,CAAqC;IAC1D,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,mBAAmB,CAAkB;IAE7C;;;OAGG;gBACS,WAAW,EAAE,WAAW;IAKpC;;;OAGG;IACG,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAoBrC;;;OAGG;IACG,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC;IA6BzC;;;;;OAKG;IACG,MAAM,CACV,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,YAAY,EAAE,CAAC;IAsB1B;;OAEG;YACW,aAAa;IAsC3B;;OAEG;YACW,cAAc;IA0D5B;;OAEG;IACH,OAAO,CAAC,aAAa;IAkCrB;;OAEG;IACH,OAAO,CAAC,eAAe;IAkCvB;;;;OAIG;IACG,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IAY3D;;OAEG;IACH,WAAW,IAAI,MAAM,EAAE;IAIvB;;OAEG;IACG,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;CAiB9D"}
+{"version":3,"file":"searchEngine.d.ts","sourceRoot":"","sources":["../src/searchEngine.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAI/C,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAEzE;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,GAAG,MAAM,CAYhE;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,aAAa,CAAqC;IAC1D,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,mBAAmB,CAAkB;IAE7C;;;OAGG;gBACS,WAAW,EAAE,WAAW;IAKpC;;;OAGG;IACG,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IA2BrC;;;OAGG;IACG,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC;IA6BzC;;;;;OAKG;IACG,MAAM,CACV,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,YAAY,EAAE,CAAC;IAsB1B;;OAEG;YACW,aAAa;IAsC3B;;OAEG;YACW,cAAc;IA0D5B;;OAEG;IACH,OAAO,CAAC,aAAa;IAkCrB;;OAEG;IACH,OAAO,CAAC,eAAe;IAkCvB;;;;OAIG;IACG,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IAS3D;;OAEG;IACG,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;CAiB9D"}