@spartan-ng/mcp 0.0.1-alpha.707

package/src/tools/resources.js

@@ -0,0 +1,178 @@
+import { ResourceTemplate } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { KNOWN_COMPONENTS, SPARTAN_COMPONENTS_BASE, extractAPIInfo, extractCodeBlocks, fetchContent } from './utils.js';
+export function registerResourceHandlers(server) {
+    server.resource('Spartan UI Components List', 'spartan://components/list', {
+        description: 'Complete list of all available Spartan UI components with URLs',
+        mimeType: 'application/json',
+    }, async () => {
+        return {
+            contents: [
+                {
+                    uri: 'spartan://components/list',
+                    mimeType: 'application/json',
+                    text: JSON.stringify({
+                        components: KNOWN_COMPONENTS.map((name) => ({
+                            name,
+                            url: `${SPARTAN_COMPONENTS_BASE}/${name}`,
+                            apiResource: `spartan://component/${name}/api`,
+                            examplesResource: `spartan://component/${name}/examples`,
+                            fullResource: `spartan://component/${name}/full`,
+                        })),
+                        totalComponents: KNOWN_COMPONENTS.length,
+                        metadata: {
+                            description: 'Spartan UI is a collection of Angular UI components',
+                            baseUrl: 'https://www.spartan.ng',
+                            documentation: 'https://www.spartan.ng/documentation',
+                        },
+                    }, null, 2),
+                },
+            ],
+        };
+    });
+    const apiTemplate = new ResourceTemplate('spartan://component/{name}/api', {
+        list: async () => {
+            return {
+                resources: KNOWN_COMPONENTS.map((name) => ({
+                    uri: `spartan://component/${name}/api`,
+                    name: `${name} - API Documentation`,
+                    description: `Brain API and Helm API specifications for ${name} component`,
+                    mimeType: 'application/json',
+                })),
+            };
+        },
+        complete: {},
+    });
+    server.resource('Component API Documentation', apiTemplate, {
+        description: 'Brain API and Helm API specifications for Spartan UI components',
+        mimeType: 'application/json',
+    }, async (uri, variables) => {
+        const name = Array.isArray(variables.name) ? variables.name[0] : variables.name;
+        if (!KNOWN_COMPONENTS.includes(name)) {
+            throw new Error(`Unknown component: ${name}`);
+        }
+        const componentUrl = `${SPARTAN_COMPONENTS_BASE}/${name}`;
+        const html = await fetchContent(componentUrl, 'html', false);
+        const apiData = extractAPIInfo(html);
+        return {
+            contents: [
+                {
+                    uri: uri.toString(),
+                    mimeType: 'application/json',
+                    text: JSON.stringify({
+                        component: name,
+                        url: componentUrl,
+                        brainAPI: apiData.brainAPI,
+                        helmAPI: apiData.helmAPI,
+                        metadata: {
+                            brainAPICount: apiData.brainAPI.length,
+                            helmAPICount: apiData.helmAPI.length,
+                            description: 'Brain API provides unstyled, accessible primitives. Helm API provides pre-styled components.',
+                        },
+                    }, null, 2),
+                },
+            ],
+        };
+    });
+    const examplesTemplate = new ResourceTemplate('spartan://component/{name}/examples', {
+        list: async () => {
+            return {
+                resources: KNOWN_COMPONENTS.map((name) => ({
+                    uri: `spartan://component/${name}/examples`,
+                    name: `${name} - Code Examples`,
+                    description: `Working code examples for ${name} component`,
+                    mimeType: 'application/json',
+                })),
+            };
+        },
+        complete: {},
+    });
+    server.resource('Component Code Examples', examplesTemplate, {
+        description: 'Working code examples for Spartan UI components',
+        mimeType: 'application/json',
+    }, async (uri, variables) => {
+        const name = Array.isArray(variables.name) ? variables.name[0] : variables.name;
+        if (!KNOWN_COMPONENTS.includes(name)) {
+            throw new Error(`Unknown component: ${name}`);
+        }
+        const componentUrl = `${SPARTAN_COMPONENTS_BASE}/${name}`;
+        const html = await fetchContent(componentUrl, 'html', false);
+        const codeBlocks = extractCodeBlocks(html);
+        return {
+            contents: [
+                {
+                    uri: uri.toString(),
+                    mimeType: 'application/json',
+                    text: JSON.stringify({
+                        component: name,
+                        url: componentUrl,
+                        examples: codeBlocks.map((block, index) => ({
+                            id: index + 1,
+                            title: block.title || `Example ${index + 1}`,
+                            code: block.code,
+                            language: block.language,
+                        })),
+                        metadata: {
+                            totalExamples: codeBlocks.length,
+                            description: `Working code examples for ${name} component`,
+                        },
+                    }, null, 2),
+                },
+            ],
+        };
+    });
+    const fullTemplate = new ResourceTemplate('spartan://component/{name}/full', {
+        list: async () => {
+            return {
+                resources: KNOWN_COMPONENTS.map((name) => ({
+                    uri: `spartan://component/${name}/full`,
+                    name: `${name} - Complete Documentation`,
+                    description: `Complete documentation including API, examples, and metadata for ${name}`,
+                    mimeType: 'application/json',
+                })),
+            };
+        },
+        complete: {},
+    });
+    server.resource('Component Full Documentation', fullTemplate, {
+        description: 'Complete documentation including API, examples, and metadata',
+        mimeType: 'application/json',
+    }, async (uri, variables) => {
+        const name = Array.isArray(variables.name) ? variables.name[0] : variables.name;
+        if (!KNOWN_COMPONENTS.includes(name)) {
+            throw new Error(`Unknown component: ${name}`);
+        }
+        const componentUrl = `${SPARTAN_COMPONENTS_BASE}/${name}`;
+        const html = await fetchContent(componentUrl, 'html', false);
+        const apiData = extractAPIInfo(html);
+        const codeBlocks = extractCodeBlocks(html);
+        return {
+            contents: [
+                {
+                    uri: uri.toString(),
+                    mimeType: 'application/json',
+                    text: JSON.stringify({
+                        component: name,
+                        url: componentUrl,
+                        api: {
+                            brainAPI: apiData.brainAPI,
+                            helmAPI: apiData.helmAPI,
+                        },
+                        examples: codeBlocks.map((block, index) => ({
+                            id: index + 1,
+                            title: block.title || apiData.examples[index]?.title || `Example ${index + 1}`,
+                            code: block.code,
+                            language: block.language,
+                        })),
+                        metadata: {
+                            brainAPICount: apiData.brainAPI.length,
+                            helmAPICount: apiData.helmAPI.length,
+                            totalExamples: codeBlocks.length,
+                            fetchedAt: new Date().toISOString(),
+                        },
+                    }, null, 2),
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=resources.js.map

package/src/tools/resources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.js","sourceRoot":"","sources":["../../../../../libs/mcp/src/tools/resources.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,yCAAyC,CAAC;AAC3E,OAAO,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,cAAc,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAExH,MAAM,UAAU,wBAAwB,CAAC,MAAiB;IACzD,MAAM,CAAC,QAAQ,CACd,4BAA4B,EAC5B,2BAA2B,EAC3B;QACC,WAAW,EAAE,gEAAgE;QAC7E,QAAQ,EAAE,kBAAkB;KAC5B,EACD,KAAK,IAAI,EAAE;QACV,OAAO;YACN,QAAQ,EAAE;gBACT;oBACC,GAAG,EAAE,2BAA2B;oBAChC,QAAQ,EAAE,kBAAkB;oBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CACnB;wBACC,UAAU,EAAE,gBAAgB,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;4BAC3C,IAAI;4BACJ,GAAG,EAAE,GAAG,uBAAuB,IAAI,IAAI,EAAE;4BACzC,WAAW,EAAE,uBAAuB,IAAI,MAAM;4BAC9C,gBAAgB,EAAE,uBAAuB,IAAI,WAAW;4BACxD,YAAY,EAAE,uBAAuB,IAAI,OAAO;yBAChD,CAAC,CAAC;wBACH,eAAe,EAAE,gBAAgB,CAAC,MAAM;wBACxC,QAAQ,EAAE;4BACT,WAAW,EAAE,qDAAqD;4BAClE,OAAO,EAAE,wBAAwB;4BACjC,aAAa,EAAE,sCAAsC;yBACrD;qBACD,EACD,IAAI,EACJ,CAAC,CACD;iBACD;aACD;SACD,CAAC;IACH,CAAC,CACD,CAAC;IAEF,MAAM,WAAW,GAAG,IAAI,gBAAgB,CAAC,gCAAgC,EAAE;QAC1E,IAAI,EAAE,KAAK,IAAI,EAAE;YAChB,OAAO;gBACN,SAAS,EAAE,gBAAgB,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;oBAC1C,GAAG,EAAE,uBAAuB,IAAI,MAAM;oBACtC,IAAI,EAAE,GAAG,IAAI,sBAAsB;oBACnC,WAAW,EAAE,6CAA6C,IAAI,YAAY;oBAC1E,QAAQ,EAAE,kBAAkB;iBAC5B,CAAC,CAAC;aACH,CAAC;QACH,CAAC;QACD,QAAQ,EAAE,EAAE;KACZ,CAAC,CAAC;IAEH,MAAM,CAAC,QAAQ,CACd,6BAA6B,EAC7B,WAAW,EACX;QACC,WAAW,EAAE,iEAAiE;QAC9E,QAAQ,EAAE,kBAAkB;KAC5B,EACD,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,EAAE;QACxB,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC;QAEhF,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YACtC,MAAM,IAAI,KAAK,CAAC,sBAAsB,IAAI,EAAE,CAAC,CAAC;QAC/C,CAAC;QAED,MAAM,YAAY,GAAG,GAAG,uBAAuB,IAAI,IAAI,EAAE,CAAC;QAC1D,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;QAC7D,MAAM,OAAO,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;QAErC,OAAO;YACN,QAAQ,EAAE;gBACT;oBACC,GAAG,EAAE,GAAG,CAAC,QAAQ,EAAE;oBACnB,QAAQ,EAAE,kBAAkB;oBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CACnB;wBACC,SAAS,EAAE,IAAI;wBACf,GAAG,EAAE,YAAY;wBACjB,QAAQ,EAAE,OAAO,CAAC,QAAQ;wBAC1B,OAAO,EAAE,OAAO,CAAC,OAAO;wBACxB,QAAQ,EAAE;4BACT,aAAa,EAAE,OAAO,CAAC,QAAQ,CAAC,MAAM;4BACtC,YAAY,EAAE,OAAO,CAAC,OAAO,CAAC,MAAM;4BACpC,WAAW,EACV,8FAA8F;yBAC/F;qBACD,EACD,IAAI,EACJ,CAAC,CACD;iBACD;aACD;SACD,CAAC;IACH,CAAC,CACD,CAAC;IAEF,MAAM,gBAAgB,GAAG,IAAI,gBAAgB,CAAC,qCAAqC,EAAE;QACpF,IAAI,EAAE,KAAK,IAAI,EAAE;YAChB,OAAO;gBACN,SAAS,EAAE,gBAAgB,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;oBAC1C,GAAG,EAAE,uBAAuB,IAAI,WAAW;oBAC3C,IAAI,EAAE,GAAG,IAAI,kBAAkB;oBAC/B,WAAW,EAAE,6BAA6B,IAAI,YAAY;oBAC1D,QAAQ,EAAE,kBAAkB;iBAC5B,CAAC,CAAC;aACH,CAAC;QACH,CAAC;QACD,QAAQ,EAAE,EAAE;KACZ,CAAC,CAAC;IAEH,MAAM,CAAC,QAAQ,CACd,yBAAyB,EACzB,gBAAgB,EAChB;QACC,WAAW,EAAE,iDAAiD;QAC9D,QAAQ,EAAE,kBAAkB;KAC5B,EACD,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,EAAE;QACxB,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC;QAEhF,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YACtC,MAAM,IAAI,KAAK,CAAC,sBAAsB,IAAI,EAAE,CAAC,CAAC;QAC/C,CAAC;QAED,MAAM,YAAY,GAAG,GAAG,uBAAuB,IAAI,IAAI,EAAE,CAAC;QAC1D,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;QAC7D,MAAM,UAAU,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAE3C,OAAO;YACN,QAAQ,EAAE;gBACT;oBACC,GAAG,EAAE,GAAG,CAAC,QAAQ,EAAE;oBACnB,QAAQ,EAAE,kBAAkB;oBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CACnB;wBACC,SAAS,EAAE,IAAI;wBACf,GAAG,EAAE,YAAY;wBACjB,QAAQ,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;4BAC3C,EAAE,EAAE,KAAK,GAAG,CAAC;4BACb,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,WAAW,KAAK,GAAG,CAAC,EAAE;4BAC5C,IAAI,EAAE,KAAK,CAAC,IAAI;4BAChB,QAAQ,EAAE,KAAK,CAAC,QAAQ;yBACxB,CAAC,CAAC;wBACH,QAAQ,EAAE;4BACT,aAAa,EAAE,UAAU,CAAC,MAAM;4BAChC,WAAW,EAAE,6BAA6B,IAAI,YAAY;yBAC1D;qBACD,EACD,IAAI,EACJ,CAAC,CACD;iBACD;aACD;SACD,CAAC;IACH,CAAC,CACD,CAAC;IAEF,MAAM,YAAY,GAAG,IAAI,gBAAgB,CAAC,iCAAiC,EAAE;QAC5E,IAAI,EAAE,KAAK,IAAI,EAAE;YAChB,OAAO;gBACN,SAAS,EAAE,gBAAgB,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;oBAC1C,GAAG,EAAE,uBAAuB,IAAI,OAAO;oBACvC,IAAI,EAAE,GAAG,IAAI,2BAA2B;oBACxC,WAAW,EAAE,oEAAoE,IAAI,EAAE;oBACvF,QAAQ,EAAE,kBAAkB;iBAC5B,CAAC,CAAC;aACH,CAAC;QACH,CAAC;QACD,QAAQ,EAAE,EAAE;KACZ,CAAC,CAAC;IAEH,MAAM,CAAC,QAAQ,CACd,8BAA8B,EAC9B,YAAY,EACZ;QACC,WAAW,EAAE,8DAA8D;QAC3E,QAAQ,EAAE,kBAAkB;KAC5B,EACD,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,EAAE;QACxB,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC;QAEhF,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YACtC,MAAM,IAAI,KAAK,CAAC,sBAAsB,IAAI,EAAE,CAAC,CAAC;QAC/C,CAAC;QAED,MAAM,YAAY,GAAG,GAAG,uBAAuB,IAAI,IAAI,EAAE,CAAC;QAC1D,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;QAC7D,MAAM,OAAO,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;QACrC,MAAM,UAAU,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAE3C,OAAO;YACN,QAAQ,EAAE;gBACT;oBACC,GAAG,EAAE,GAAG,CAAC,QAAQ,EAAE;oBACnB,QAAQ,EAAE,kBAAkB;oBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CACnB;wBACC,SAAS,EAAE,IAAI;wBACf,GAAG,EAAE,YAAY;wBACjB,GAAG,EAAE;4BACJ,QAAQ,EAAE,OAAO,CAAC,QAAQ;4BAC1B,OAAO,EAAE,OAAO,CAAC,OAAO;yBACxB;wBACD,QAAQ,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;4BAC3C,EAAE,EAAE,KAAK,GAAG,CAAC;4BACb,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,IAAI,WAAW,KAAK,GAAG,CAAC,EAAE;4BAC9E,IAAI,EAAE,KAAK,CAAC,IAAI;4BAChB,QAAQ,EAAE,KAAK,CAAC,QAAQ;yBACxB,CAAC,CAAC;wBACH,QAAQ,EAAE;4BACT,aAAa,EAAE,OAAO,CAAC,QAAQ,CAAC,MAAM;4BACtC,YAAY,EAAE,OAAO,CAAC,OAAO,CAAC,MAAM;4BACpC,aAAa,EAAE,UAAU,CAAC,MAAM;4BAChC,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;yBACnC;qBACD,EACD,IAAI,EACJ,CAAC,CACD;iBACD;aACD;SACD,CAAC;IACH,CAAC,CACD,CAAC;AACH,CAAC"}

package/src/tools/utils.d.ts

@@ -0,0 +1,84 @@
+export declare const SPARTAN_DOCS_BASE = "https://www.spartan.ng/documentation";
+export declare const SPARTAN_COMPONENTS_BASE = "https://www.spartan.ng/components";
+export declare const SPARTAN_BLOCKS_BASE = "https://www.spartan.ng/blocks";
+/**
+ * Known Spartan components (from docs navigation). Keep this list updated.
+ * Some entries may be marked as "soon" on the site.
+ */
+export declare const KNOWN_COMPONENTS: string[];
+/**
+ * Known Spartan blocks (pre-built UI patterns).
+ */
+export declare const KNOWN_BLOCKS: string[];
+/**
+ * Known documentation topics.
+ */
+export declare const DOCUMENTATION_TOPICS: string[];
+/**
+ * Minimal HTML -> text converter for callers that want plain text.
+ */
+export declare function htmlToText(html: string): string;
+/**
+ * Fetch a URL and return HTML or text with basic caching.
+ */
+export declare function fetchContent(url: string, format?: 'html' | 'text', noCache?: boolean): Promise<string>;
+/**
+ * Represents a formatted code block extracted from documentation.
+ */
+export interface CodeBlock {
+    code: string;
+    language: string;
+    title: string;
+    id: string;
+}
+/**
+ * Extract code blocks from HTML and return as an array of CodeBlock objects.
+ */
+export declare function extractCodeBlocks(html: string): CodeBlock[];
+/**
+ * Extract headings (h1-h3) and return as plain text in order.
+ */
+export declare function extractHeadings(html: string): string[];
+/**
+ * Extract links: { text, href }
+ */
+export interface ExtractedLink {
+    href: string;
+    text: string;
+}
+export declare function extractLinks(html: string): ExtractedLink[];
+export interface APIInput {
+    prop: string;
+    type: string;
+    default: string;
+    description: string;
+}
+export interface APIOutput {
+    prop: string;
+    type: string;
+    description: string;
+}
+export interface APIComponent {
+    name: string;
+    selector: string;
+    inputs: APIInput[];
+    outputs: APIOutput[];
+}
+export interface APIExample {
+    title: string;
+    code: string;
+    language: string;
+}
+export interface APIInfo {
+    brainAPI: APIComponent[];
+    helmAPI: APIComponent[];
+    examples: APIExample[];
+}
+/**
+ * Extract structured API information from component documentation
+ */
+export declare function extractAPIInfo(html: string): APIInfo;
+/**
+ * Simple language detection based on code content
+ */
+export declare function detectLanguage(code: string): string;