@eui/mcp 1.0.3 → 1.2.0

package/dist/tools/__tests__/get-component-docs.test.js

@@ -0,0 +1,137 @@
+/**
+ * Unit tests for GetComponentDocsTool
+ */
+import { describe, it, expect, beforeEach } from '@jest/globals';
+import { GetComponentDocsTool } from '../get-component-docs.js';
+import { ComponentQuery } from '../../query/component-query.js';
+import { ResultFormatter } from '../../query/result-formatter.js';
+import { IndexBuilder } from '../../query/index-builder.js';
+describe('GetComponentDocsTool', () => {
+    let tool;
+    let documentation;
+    beforeEach(() => {
+        // Create sample documentation
+        documentation = {
+            components: [
+                {
+                    name: 'TestComponent',
+                    id: 'test-component',
+                    file: 'test.component.ts',
+                    type: 'component',
+                    selector: 'app-test',
+                    description: 'A test component',
+                    deprecated: false,
+                    inputs: [
+                        {
+                            name: 'value',
+                            type: 'string',
+                            optional: false,
+                            description: 'The value input',
+                            deprecated: false,
+                            defaultValue: 'default',
+                        },
+                    ],
+                    outputs: [
+                        {
+                            name: 'change',
+                            type: 'EventEmitter<string>',
+                            optional: false,
+                            description: 'Change event',
+                            deprecated: false,
+                        },
+                    ],
+                    examples: [
+                        {
+                            title: 'Basic usage',
+                            description: 'How to use the component',
+                            example: '<app-test [value]="myValue"></app-test>',
+                            language: 'html',
+                        },
+                    ],
+                    standalone: true,
+                    imports: ['CommonModule'],
+                },
+            ],
+            directives: [],
+            pipes: [],
+            injectables: [],
+            interfaces: [],
+            classes: [],
+            modules: [],
+        };
+        // Build index and create tool
+        const builder = new IndexBuilder();
+        const index = builder.build(documentation);
+        const query = new ComponentQuery(index);
+        const formatter = new ResultFormatter();
+        tool = new GetComponentDocsTool(query, formatter);
+    });
+    describe('execute', () => {
+        it('should retrieve component documentation by name', () => {
+            const result = tool.execute({ name: 'TestComponent' });
+            expect(result.component).toBeDefined();
+            expect(result.component.name).toBe('TestComponent');
+            expect(result.component.selector).toBe('app-test');
+            expect(result.component.description).toBe('A test component');
+        });
+        it('should include inputs in the result', () => {
+            const result = tool.execute({ name: 'TestComponent' });
+            expect(result.component.inputs).toHaveLength(1);
+            expect(result.component.inputs[0].name).toBe('value');
+            expect(result.component.inputs[0].type).toBe('string');
+            expect(result.component.inputs[0].required).toBe(true);
+            expect(result.component.inputs[0].defaultValue).toBe('default');
+        });
+        it('should include outputs in the result', () => {
+            const result = tool.execute({ name: 'TestComponent' });
+            expect(result.component.outputs).toHaveLength(1);
+            expect(result.component.outputs[0].name).toBe('change');
+            expect(result.component.outputs[0].type).toBe('EventEmitter<string>');
+        });
+        it('should include examples in the result', () => {
+            const result = tool.execute({ name: 'TestComponent' });
+            expect(result.component.examples).toHaveLength(1);
+            expect(result.component.examples[0].title).toBe('Basic usage');
+            expect(result.component.examples[0].example).toContain('app-test');
+        });
+        it('should include standalone flag', () => {
+            const result = tool.execute({ name: 'TestComponent' });
+            expect(result.component.standalone).toBe(true);
+        });
+        it('should include imports', () => {
+            const result = tool.execute({ name: 'TestComponent' });
+            expect(result.component.imports).toEqual(['CommonModule']);
+        });
+        it('should throw error for non-existent component', () => {
+            expect(() => {
+                tool.execute({ name: 'NonExistentComponent' });
+            }).toThrow('Component "NonExistentComponent" not found in documentation');
+        });
+        it('should throw error for empty name', () => {
+            expect(() => {
+                tool.execute({ name: '' });
+            }).toThrow('Component name is required and must be a non-empty string');
+        });
+        it('should throw error for whitespace-only name', () => {
+            expect(() => {
+                tool.execute({ name: '   ' });
+            }).toThrow('Component name is required and must be a non-empty string');
+        });
+        it('should trim component name before lookup', () => {
+            const result = tool.execute({ name: '  TestComponent  ' });
+            expect(result.component.name).toBe('TestComponent');
+        });
+    });
+    describe('getToolDefinition', () => {
+        it('should return valid tool definition', () => {
+            const definition = GetComponentDocsTool.getToolDefinition();
+            expect(definition.name).toBe('get-component-docs');
+            expect(definition.description).toBeDefined();
+            expect(definition.inputSchema).toBeDefined();
+            expect(definition.inputSchema.type).toBe('object');
+            expect(definition.inputSchema.properties).toBeDefined();
+            expect(definition.inputSchema.required).toContain('name');
+        });
+    });
+});
+//# sourceMappingURL=get-component-docs.test.js.map

package/dist/tools/__tests__/get-component-docs.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-component-docs.test.js","sourceRoot":"","sources":["../../../src/tools/__tests__/get-component-docs.test.ts"],"names":[],"mappings":"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"}

package/dist/tools/__tests__/get-component-examples.property.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=get-component-examples.property.test.d.ts.map

package/dist/tools/__tests__/get-component-examples.property.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-component-examples.property.test.d.ts","sourceRoot":"","sources":["../../../src/tools/__tests__/get-component-examples.property.test.ts"],"names":[],"mappings":""}

package/dist/tools/__tests__/get-component-examples.property.test.js

@@ -0,0 +1,245 @@
+/**
+ * Property-based tests for GetComponentExamplesTool
+ */
+import { describe, it, expect } from '@jest/globals';
+import * as fc from 'fast-check';
+import { GetComponentExamplesTool } from '../get-component-examples.js';
+import { ComponentQuery } from '../../query/component-query.js';
+import { ResultFormatter } from '../../query/result-formatter.js';
+import { IndexBuilder } from '../../query/index-builder.js';
+// Arbitraries for generating test data
+/**
+ * Generate an example with various formatting
+ */
+const exampleArbitrary = fc.record({
+    title: fc.option(fc.string({ minLength: 1, maxLength: 100 }), { nil: undefined }),
+    description: fc.option(fc.string({ minLength: 1, maxLength: 200 }), { nil: undefined }),
+    example: fc.oneof(
+    // HTML examples with various formatting
+    fc.string({ minLength: 1, maxLength: 500 }).map(s => `<div>\n  ${s}\n</div>`), fc.string({ minLength: 1, maxLength: 500 }).map(s => `<app-component>${s}</app-component>`), 
+    // TypeScript examples with various formatting
+    fc.string({ minLength: 1, maxLength: 500 }).map(s => `function test() {\n  ${s}\n}`), fc.string({ minLength: 1, maxLength: 500 }).map(s => `const x = ${s};`), 
+    // Plain text
+    fc.string({ minLength: 1, maxLength: 500 }), 
+    // Examples with special characters and whitespace
+    fc.string({ minLength: 1, maxLength: 500 }).map(s => `  ${s}  \n\n  ${s}  `)),
+    language: fc.option(fc.oneof(fc.constant('html'), fc.constant('typescript'), fc.constant('javascript'), fc.constant('css'), fc.constant('json')), { nil: undefined }),
+});
+/**
+ * Generate a valid component with examples
+ */
+const componentArbitrary = fc.record({
+    name: fc.string({ minLength: 1, maxLength: 50 }).filter((s) => s.trim().length > 0 && s === s.trim()),
+    id: fc.string({ minLength: 1 }),
+    file: fc.string({ minLength: 1 }),
+    type: fc.constant('component'),
+    selector: fc.option(fc.string({ minLength: 1 }), { nil: undefined }),
+    description: fc.option(fc.string(), { nil: undefined }),
+    deprecated: fc.boolean(),
+    deprecationMessage: fc.option(fc.string(), { nil: undefined }),
+    examples: fc.option(fc.array(exampleArbitrary, { minLength: 0, maxLength: 10 }), { nil: undefined }),
+});
+/**
+ * Generate a valid directive (directives don't have examples in Compodoc)
+ */
+const directiveArbitrary = fc.record({
+    name: fc.string({ minLength: 1, maxLength: 50 }).filter((s) => s.trim().length > 0 && s === s.trim()),
+    id: fc.string({ minLength: 1 }),
+    file: fc.string({ minLength: 1 }),
+    type: fc.constant('directive'),
+    selector: fc.option(fc.string({ minLength: 1 }), { nil: undefined }),
+    description: fc.option(fc.string(), { nil: undefined }),
+    deprecated: fc.boolean(),
+    deprecationMessage: fc.option(fc.string(), { nil: undefined }),
+});
+/**
+ * Generate a valid pipe
+ */
+const pipeArbitrary = fc.record({
+    name: fc.string({ minLength: 1, maxLength: 50 }).filter((s) => s.trim().length > 0 && s === s.trim()),
+    id: fc.string({ minLength: 1 }),
+    file: fc.string({ minLength: 1 }),
+    type: fc.constant('pipe'),
+    description: fc.option(fc.string(), { nil: undefined }),
+    deprecated: fc.boolean(),
+});
+/**
+ * Generate a valid injectable (service)
+ */
+const injectableArbitrary = fc.record({
+    name: fc.string({ minLength: 1, maxLength: 50 }).filter((s) => s.trim().length > 0 && s === s.trim()),
+    id: fc.string({ minLength: 1 }),
+    file: fc.string({ minLength: 1 }),
+    type: fc.constant('injectable'),
+    description: fc.option(fc.string(), { nil: undefined }),
+    deprecated: fc.boolean(),
+});
+/**
+ * Generate valid Compodoc documentation with unique names
+ */
+const documentationArbitrary = fc
+    .record({
+    components: fc.array(componentArbitrary, { maxLength: 20 }),
+    directives: fc.array(directiveArbitrary, { maxLength: 20 }),
+    pipes: fc.array(pipeArbitrary, { maxLength: 20 }),
+    injectables: fc.array(injectableArbitrary, { maxLength: 20 }),
+    interfaces: fc.constant([]),
+    classes: fc.constant([]),
+    modules: fc.constant([]),
+})
+    .filter((doc) => {
+    // Ensure all names are unique across all types
+    const allNames = new Set();
+    const items = [
+        ...doc.components,
+        ...doc.directives,
+        ...doc.pipes,
+        ...doc.injectables,
+    ];
+    for (const item of items) {
+        if (allNames.has(item.name)) {
+            return false;
+        }
+        allNames.add(item.name);
+    }
+    return items.length > 0; // Ensure at least one item
+});
+describe('GetComponentExamplesTool Property Tests', () => {
+    describe('Property 16: Example completeness', () => {
+        /**
+         * Feature: eui-compodoc-mcp, Property 16: Example completeness
+         * Validates: Requirements 5.1, 5.5
+         *
+         * For any component with examples in the documentation, requesting examples
+         * should return all available examples.
+         */
+        it('should return all available examples for components', () => {
+            fc.assert(fc.property(documentationArbitrary, (documentation) => {
+                // Build index
+                const builder = new IndexBuilder();
+                const index = builder.build(documentation);
+                // Create tool
+                const query = new ComponentQuery(index);
+                const formatter = new ResultFormatter();
+                const tool = new GetComponentExamplesTool(query, formatter);
+                // Test components
+                for (const component of documentation.components) {
+                    const result = tool.execute({ name: component.name });
+                    // Verify result structure
+                    expect(result.componentName).toBe(component.name);
+                    expect(result.examples).toBeDefined();
+                    expect(Array.isArray(result.examples)).toBe(true);
+                    // Verify all examples are present
+                    const expectedExampleCount = component.examples?.length || 0;
+                    expect(result.examples.length).toBe(expectedExampleCount);
+                    // If component has examples, verify each one is present
+                    if (component.examples && component.examples.length > 0) {
+                        for (let i = 0; i < component.examples.length; i++) {
+                            const originalExample = component.examples[i];
+                            const resultExample = result.examples[i];
+                            // Verify the example is present
+                            expect(resultExample).toBeDefined();
+                            expect(resultExample.example).toBe(originalExample.example);
+                            // Verify optional fields are preserved
+                            if (originalExample.title !== undefined) {
+                                expect(resultExample.title).toBe(originalExample.title);
+                            }
+                            if (originalExample.description !== undefined) {
+                                expect(resultExample.description).toBe(originalExample.description);
+                            }
+                            if (originalExample.language !== undefined) {
+                                expect(resultExample.language).toBe(originalExample.language);
+                            }
+                        }
+                    }
+                }
+                // Test directives (directives don't have examples in Compodoc)
+                for (const directive of documentation.directives) {
+                    const result = tool.execute({ name: directive.name });
+                    // Verify result structure
+                    expect(result.componentName).toBe(directive.name);
+                    expect(result.examples).toBeDefined();
+                    expect(Array.isArray(result.examples)).toBe(true);
+                    // Directives don't have examples, so should return empty array
+                    expect(result.examples.length).toBe(0);
+                }
+                // Test pipes and services (which don't have examples)
+                for (const pipe of documentation.pipes) {
+                    const result = tool.execute({ name: pipe.name });
+                    expect(result.examples).toEqual([]);
+                }
+                for (const service of documentation.injectables) {
+                    const result = tool.execute({ name: service.name });
+                    expect(result.examples).toEqual([]);
+                }
+            }), { numRuns: 100 });
+        });
+    });
+    describe('Property 7: Example format preservation', () => {
+        /**
+         * Feature: eui-compodoc-mcp, Property 7: Example format preservation
+         * Validates: Requirements 2.5, 5.2, 5.3
+         *
+         * For any component with code examples, retrieving the examples should
+         * preserve their formatting and structure.
+         */
+        it('should preserve formatting and structure of examples', () => {
+            fc.assert(fc.property(documentationArbitrary, (documentation) => {
+                // Build index
+                const builder = new IndexBuilder();
+                const index = builder.build(documentation);
+                // Create tool
+                const query = new ComponentQuery(index);
+                const formatter = new ResultFormatter();
+                const tool = new GetComponentExamplesTool(query, formatter);
+                // Test components with examples
+                for (const component of documentation.components) {
+                    if (component.examples && component.examples.length > 0) {
+                        const result = tool.execute({ name: component.name });
+                        // Verify each example preserves its exact formatting
+                        for (let i = 0; i < component.examples.length; i++) {
+                            const originalExample = component.examples[i];
+                            const resultExample = result.examples[i];
+                            // The example text must be exactly the same (byte-for-byte)
+                            expect(resultExample.example).toBe(originalExample.example);
+                            // Verify whitespace is preserved
+                            expect(resultExample.example.length).toBe(originalExample.example.length);
+                            // Verify newlines are preserved
+                            const originalNewlines = (originalExample.example.match(/\n/g) || []).length;
+                            const resultNewlines = (resultExample.example.match(/\n/g) || []).length;
+                            expect(resultNewlines).toBe(originalNewlines);
+                            // Verify leading/trailing whitespace is preserved
+                            if (originalExample.example.startsWith(' ') || originalExample.example.startsWith('\t')) {
+                                expect(resultExample.example[0]).toBe(originalExample.example[0]);
+                            }
+                            if (originalExample.example.endsWith(' ') || originalExample.example.endsWith('\n')) {
+                                expect(resultExample.example[resultExample.example.length - 1])
+                                    .toBe(originalExample.example[originalExample.example.length - 1]);
+                            }
+                            // Verify special characters are preserved
+                            const specialChars = ['<', '>', '{', '}', '[', ']', '(', ')', '"', "'", '`', '\\'];
+                            for (const char of specialChars) {
+                                const originalCount = (originalExample.example.match(new RegExp(`\\${char}`, 'g')) || []).length;
+                                const resultCount = (resultExample.example.match(new RegExp(`\\${char}`, 'g')) || []).length;
+                                expect(resultCount).toBe(originalCount);
+                            }
+                            // Verify language field is preserved if present
+                            if (originalExample.language !== undefined) {
+                                expect(resultExample.language).toBe(originalExample.language);
+                            }
+                            // Verify title and description are preserved if present
+                            if (originalExample.title !== undefined) {
+                                expect(resultExample.title).toBe(originalExample.title);
+                            }
+                            if (originalExample.description !== undefined) {
+                                expect(resultExample.description).toBe(originalExample.description);
+                            }
+                        }
+                    }
+                }
+                // Note: Directives don't have examples in Compodoc, so we only test components
+            }), { numRuns: 100 });
+        });
+    });
+});
+//# sourceMappingURL=get-component-examples.property.test.js.map

package/dist/tools/__tests__/get-component-examples.property.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-component-examples.property.test.js","sourceRoot":"","sources":["../../../src/tools/__tests__/get-component-examples.property.test.ts"],"names":[],"mappings":"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"}

package/dist/tools/__tests__/get-component-examples.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=get-component-examples.test.d.ts.map

package/dist/tools/__tests__/get-component-examples.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-component-examples.test.d.ts","sourceRoot":"","sources":["../../../src/tools/__tests__/get-component-examples.test.ts"],"names":[],"mappings":""}

package/dist/tools/__tests__/get-component-examples.test.js

@@ -0,0 +1,128 @@
+/**
+ * Unit tests for GetComponentExamplesTool
+ */
+import { describe, it, expect, beforeEach } from '@jest/globals';
+import { GetComponentExamplesTool } from '../get-component-examples.js';
+import { ComponentQuery } from '../../query/component-query.js';
+import { ResultFormatter } from '../../query/result-formatter.js';
+import { IndexBuilder } from '../../query/index-builder.js';
+describe('GetComponentExamplesTool', () => {
+    let tool;
+    let query;
+    let formatter;
+    const createDocumentation = (components) => ({
+        components,
+        directives: [],
+        pipes: [],
+        injectables: [],
+        interfaces: [],
+        classes: [],
+        modules: [],
+    });
+    beforeEach(() => {
+        const builder = new IndexBuilder();
+        const documentation = createDocumentation([
+            {
+                name: 'ButtonComponent',
+                id: 'button-1',
+                file: 'button.ts',
+                type: 'component',
+                selector: 'app-button',
+                description: 'A button component',
+                deprecated: false,
+                examples: [
+                    {
+                        title: 'Basic Usage',
+                        description: 'Simple button example',
+                        example: '<app-button>Click me</app-button>',
+                        language: 'html',
+                    },
+                    {
+                        title: 'With TypeScript',
+                        description: 'Button with event handler',
+                        example: 'this.button.click();',
+                        language: 'typescript',
+                    },
+                ],
+            },
+            {
+                name: 'InputComponent',
+                id: 'input-1',
+                file: 'input.ts',
+                type: 'component',
+                selector: 'app-input',
+                description: 'An input component',
+                deprecated: false,
+                examples: [],
+            },
+            {
+                name: 'CardComponent',
+                id: 'card-1',
+                file: 'card.ts',
+                type: 'component',
+                selector: 'app-card',
+                description: 'A card component',
+                deprecated: false,
+                // No examples field
+            },
+        ]);
+        const index = builder.build(documentation);
+        query = new ComponentQuery(index);
+        formatter = new ResultFormatter();
+        tool = new GetComponentExamplesTool(query, formatter);
+    });
+    describe('execute', () => {
+        it('should retrieve examples for a component with examples', () => {
+            const result = tool.execute({ name: 'ButtonComponent' });
+            expect(result.componentName).toBe('ButtonComponent');
+            expect(result.examples).toHaveLength(2);
+            expect(result.examples[0].title).toBe('Basic Usage');
+            expect(result.examples[0].example).toBe('<app-button>Click me</app-button>');
+            expect(result.examples[0].language).toBe('html');
+            expect(result.examples[1].title).toBe('With TypeScript');
+            expect(result.examples[1].language).toBe('typescript');
+        });
+        it('should return empty array for component with no examples', () => {
+            const result = tool.execute({ name: 'InputComponent' });
+            expect(result.componentName).toBe('InputComponent');
+            expect(result.examples).toEqual([]);
+        });
+        it('should return empty array for component without examples field', () => {
+            const result = tool.execute({ name: 'CardComponent' });
+            expect(result.componentName).toBe('CardComponent');
+            expect(result.examples).toEqual([]);
+        });
+        it('should throw error for non-existent component', () => {
+            expect(() => {
+                tool.execute({ name: 'NonExistentComponent' });
+            }).toThrow('Component "NonExistentComponent" not found in documentation');
+        });
+        it('should throw error for empty name', () => {
+            expect(() => {
+                tool.execute({ name: '' });
+            }).toThrow('Component name is required and must be a non-empty string');
+        });
+        it('should throw error for whitespace-only name', () => {
+            expect(() => {
+                tool.execute({ name: '   ' });
+            }).toThrow('Component name is required and must be a non-empty string');
+        });
+        it('should handle name with leading/trailing whitespace', () => {
+            const result = tool.execute({ name: '  ButtonComponent  ' });
+            expect(result.componentName).toBe('ButtonComponent');
+            expect(result.examples).toHaveLength(2);
+        });
+    });
+    describe('getToolDefinition', () => {
+        it('should return valid tool definition', () => {
+            const definition = GetComponentExamplesTool.getToolDefinition();
+            expect(definition.name).toBe('get-component-examples');
+            expect(definition.description).toBeDefined();
+            expect(definition.inputSchema).toBeDefined();
+            expect(definition.inputSchema.type).toBe('object');
+            expect(definition.inputSchema.properties.name).toBeDefined();
+            expect(definition.inputSchema.required).toContain('name');
+        });
+    });
+});
+//# sourceMappingURL=get-component-examples.test.js.map

package/dist/tools/__tests__/get-component-examples.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-component-examples.test.js","sourceRoot":"","sources":["../../../src/tools/__tests__/get-component-examples.test.ts"],"names":[],"mappings":"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"}

package/dist/tools/__tests__/get-component-inputs.property.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=get-component-inputs.property.test.d.ts.map

package/dist/tools/__tests__/get-component-inputs.property.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-component-inputs.property.test.d.ts","sourceRoot":"","sources":["../../../src/tools/__tests__/get-component-inputs.property.test.ts"],"names":[],"mappings":""}