@eui/mcp 1.0.3 → 1.3.0

package/dist/query/__tests__/result-formatter-deprecation.test.js

@@ -0,0 +1,159 @@
+import { ResultFormatter } from '../result-formatter';
+describe('ResultFormatter - Deprecation Methods', () => {
+    let formatter;
+    beforeEach(() => {
+        formatter = new ResultFormatter();
+    });
+    describe('formatDeprecatedList', () => {
+        it('should return message when no deprecated items', () => {
+            const result = formatter.formatDeprecatedList([], false);
+            expect(result).toBe('No deprecated items found.');
+        });
+        it('should format single deprecated item', () => {
+            const items = [
+                {
+                    name: 'OldButton',
+                    type: 'component',
+                    deprecationMessage: 'Use NewButton instead',
+                },
+            ];
+            const result = formatter.formatDeprecatedList(items, false);
+            expect(result).toContain('Found 1 deprecated item(s)');
+            expect(result).toContain('## Components');
+            expect(result).toContain('### OldButton');
+            expect(result).toContain('- **Message**: Use NewButton instead');
+        });
+        it('should group items by type', () => {
+            const items = [
+                {
+                    name: 'OldButton',
+                    type: 'component',
+                    deprecationMessage: 'Deprecated',
+                },
+                {
+                    name: 'OldPipe',
+                    type: 'pipe',
+                    deprecationMessage: 'Deprecated',
+                },
+            ];
+            const result = formatter.formatDeprecatedList(items, false);
+            expect(result).toContain('## Components');
+            expect(result).toContain('## Pipes');
+        });
+        it('should include version when available', () => {
+            const items = [
+                {
+                    name: 'OldButton',
+                    type: 'component',
+                    deprecationMessage: 'Deprecated',
+                    versionDeprecated: '2.0.0',
+                },
+            ];
+            const result = formatter.formatDeprecatedList(items, false);
+            expect(result).toContain('- **Deprecated in**: v2.0.0');
+        });
+        it('should include replacement when requested', () => {
+            const items = [
+                {
+                    name: 'OldButton',
+                    type: 'component',
+                    deprecationMessage: 'Deprecated',
+                    replacementSuggestion: 'NewButton',
+                },
+            ];
+            const result = formatter.formatDeprecatedList(items, true);
+            expect(result).toContain('- **Replacement**: NewButton');
+        });
+        it('should not include replacement when not requested', () => {
+            const items = [
+                {
+                    name: 'OldButton',
+                    type: 'component',
+                    deprecationMessage: 'Deprecated',
+                    replacementSuggestion: 'NewButton',
+                },
+            ];
+            const result = formatter.formatDeprecatedList(items, false);
+            expect(result).not.toContain('- **Replacement**: NewButton');
+        });
+        it('should handle multiple items of same type', () => {
+            const items = [
+                {
+                    name: 'OldButton',
+                    type: 'component',
+                    deprecationMessage: 'Deprecated 1',
+                },
+                {
+                    name: 'OldInput',
+                    type: 'component',
+                    deprecationMessage: 'Deprecated 2',
+                },
+            ];
+            const result = formatter.formatDeprecatedList(items, false);
+            expect(result).toContain('### OldButton');
+            expect(result).toContain('### OldInput');
+        });
+    });
+    describe('formatDeprecationInfo', () => {
+        it('should format non-deprecated component', () => {
+            const info = {
+                name: 'ActiveButton',
+                type: 'component',
+                isDeprecated: false,
+            };
+            const result = formatter.formatDeprecationInfo(info);
+            expect(result).toBe('ActiveButton (component) is not deprecated.');
+        });
+        it('should format deprecated component with minimal info', () => {
+            const info = {
+                name: 'OldButton',
+                type: 'component',
+                isDeprecated: true,
+                deprecationMessage: 'This is deprecated',
+            };
+            const result = formatter.formatDeprecationInfo(info);
+            expect(result).toContain('# OldButton (component)');
+            expect(result).toContain('**Status**: DEPRECATED');
+            expect(result).toContain('**Message**: This is deprecated');
+        });
+        it('should include version when available', () => {
+            const info = {
+                name: 'OldButton',
+                type: 'component',
+                isDeprecated: true,
+                deprecationMessage: 'Deprecated',
+                versionDeprecated: '2.0.0',
+            };
+            const result = formatter.formatDeprecationInfo(info);
+            expect(result).toContain('**Deprecated in**: v2.0.0');
+        });
+        it('should include replacement when available', () => {
+            const info = {
+                name: 'OldButton',
+                type: 'component',
+                isDeprecated: true,
+                deprecationMessage: 'Deprecated',
+                replacementSuggestion: 'NewButton',
+            };
+            const result = formatter.formatDeprecationInfo(info);
+            expect(result).toContain('**Recommended replacement**: NewButton');
+        });
+        it('should format complete deprecation info', () => {
+            const info = {
+                name: 'OldButton',
+                type: 'component',
+                isDeprecated: true,
+                deprecationMessage: 'Use NewButton instead',
+                versionDeprecated: '2.0.0',
+                replacementSuggestion: 'NewButton',
+            };
+            const result = formatter.formatDeprecationInfo(info);
+            expect(result).toContain('# OldButton (component)');
+            expect(result).toContain('**Status**: DEPRECATED');
+            expect(result).toContain('**Message**: Use NewButton instead');
+            expect(result).toContain('**Deprecated in**: v2.0.0');
+            expect(result).toContain('**Recommended replacement**: NewButton');
+        });
+    });
+});
+//# sourceMappingURL=result-formatter-deprecation.test.js.map

package/dist/query/__tests__/result-formatter-deprecation.test.js.map

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

package/dist/query/__tests__/result-formatter.integration.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=result-formatter.integration.test.d.ts.map

package/dist/query/__tests__/result-formatter.integration.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result-formatter.integration.test.d.ts","sourceRoot":"","sources":["../../../src/query/__tests__/result-formatter.integration.test.ts"],"names":[],"mappings":""}

package/dist/query/__tests__/result-formatter.integration.test.js

@@ -0,0 +1,140 @@
+/**
+ * Integration test for prefer-raw-description feature
+ * Validates: Requirements 5.1, 5.2, 5.3, 5.4, 5.5
+ */
+import { describe, it, expect } from '@jest/globals';
+import { GetComponentDocsTool } from '../../tools/get-component-docs.js';
+import { ListComponentsTool } from '../../tools/list-components.js';
+import { ComponentQuery } from '../component-query.js';
+import { ResultFormatter } from '../result-formatter.js';
+import { IndexBuilder } from '../index-builder.js';
+describe('Integration: prefer-raw-description', () => {
+    // Create sample documentation with rawdescription
+    const sampleDoc = {
+        components: [
+            {
+                name: 'TestComponent',
+                id: 'test-1',
+                file: 'test.ts',
+                type: 'component',
+                selector: 'app-test',
+                description: '<p>HTML description with <strong>markup</strong></p>',
+                rawdescription: 'Raw markdown description with **bold**',
+                deprecated: false,
+                inputsClass: [
+                    {
+                        name: 'testInput',
+                        type: 'string',
+                        description: '<p>HTML input description</p>',
+                        rawdescription: 'Raw input description',
+                        deprecated: false,
+                    },
+                ],
+                methods: [
+                    {
+                        name: 'testMethod',
+                        description: '<p>HTML method description</p>',
+                        rawdescription: 'Raw method description',
+                        deprecated: false,
+                    },
+                ],
+            },
+        ],
+        directives: [],
+        pipes: [],
+        injectables: [],
+        interfaces: [],
+        classes: [],
+        modules: [],
+    };
+    const indexBuilder = new IndexBuilder();
+    const index = indexBuilder.build(sampleDoc);
+    const query = new ComponentQuery(index);
+    const formatter = new ResultFormatter();
+    describe('get-component-docs tool', () => {
+        it('should use rawdescription in component details', () => {
+            const tool = new GetComponentDocsTool(query, formatter);
+            const result = tool.execute({ name: 'TestComponent' });
+            expect(result.component.description).toBe('Raw markdown description with **bold**');
+            expect(result.component.description).not.toContain('<p>');
+            expect(result.component.description).not.toContain('</p>');
+        });
+        it('should use rawdescription in input descriptions', () => {
+            const tool = new GetComponentDocsTool(query, formatter);
+            const result = tool.execute({ name: 'TestComponent' });
+            expect(result.component.inputs).toHaveLength(1);
+            expect(result.component.inputs[0].description).toBe('Raw input description');
+            expect(result.component.inputs[0].description).not.toContain('<p>');
+        });
+        it('should use rawdescription in method descriptions', () => {
+            const tool = new GetComponentDocsTool(query, formatter);
+            const result = tool.execute({ name: 'TestComponent' });
+            expect(result.component.methods).toHaveLength(1);
+            expect(result.component.methods[0].description).toBe('Raw method description');
+            expect(result.component.methods[0].description).not.toContain('<p>');
+        });
+    });
+    describe('list-components tool', () => {
+        it('should use rawdescription in component summaries', () => {
+            const tool = new ListComponentsTool(query, formatter);
+            const result = tool.execute({});
+            expect(result.items).toHaveLength(1);
+            expect(result.items[0].description).toBe('Raw markdown description with **bold**');
+            expect(result.items[0].description).not.toContain('<p>');
+        });
+    });
+    describe('fallback behavior', () => {
+        const docWithoutRaw = {
+            components: [
+                {
+                    name: 'LegacyComponent',
+                    id: 'legacy-1',
+                    file: 'legacy.ts',
+                    type: 'component',
+                    description: '<p>Only HTML description available</p>',
+                    deprecated: false,
+                },
+            ],
+            directives: [],
+            pipes: [],
+            injectables: [],
+            interfaces: [],
+            classes: [],
+            modules: [],
+        };
+        const legacyIndex = indexBuilder.build(docWithoutRaw);
+        const legacyQuery = new ComponentQuery(legacyIndex);
+        it('should fall back to description when rawdescription is not available', () => {
+            const tool = new GetComponentDocsTool(legacyQuery, formatter);
+            const result = tool.execute({ name: 'LegacyComponent' });
+            expect(result.component.description).toBe('<p>Only HTML description available</p>');
+        });
+    });
+    describe('empty description handling', () => {
+        const docWithoutDesc = {
+            components: [
+                {
+                    name: 'NoDescComponent',
+                    id: 'nodesc-1',
+                    file: 'nodesc.ts',
+                    type: 'component',
+                    deprecated: false,
+                },
+            ],
+            directives: [],
+            pipes: [],
+            injectables: [],
+            interfaces: [],
+            classes: [],
+            modules: [],
+        };
+        const noDescIndex = indexBuilder.build(docWithoutDesc);
+        const noDescQuery = new ComponentQuery(noDescIndex);
+        it('should return empty string when neither description exists', () => {
+            const tool = new GetComponentDocsTool(noDescQuery, formatter);
+            const result = tool.execute({ name: 'NoDescComponent' });
+            expect(result.component.description).toBe('');
+        });
+    });
+});
+//# sourceMappingURL=result-formatter.integration.test.js.map

package/dist/query/__tests__/result-formatter.integration.test.js.map

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

package/dist/query/__tests__/result-formatter.property.test.d.ts

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

package/dist/query/__tests__/result-formatter.property.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result-formatter.property.test.d.ts","sourceRoot":"","sources":["../../../src/query/__tests__/result-formatter.property.test.ts"],"names":[],"mappings":""}

package/dist/query/__tests__/result-formatter.property.test.js

@@ -0,0 +1,163 @@
+/**
+ * Property-based tests for ResultFormatter
+ * Feature: prefer-raw-description
+ */
+import { describe, it, expect } from '@jest/globals';
+import * as fc from 'fast-check';
+import { ResultFormatter } from '../result-formatter.js';
+describe('ResultFormatter - Property Tests', () => {
+    const formatter = new ResultFormatter();
+    /**
+     * Property 1: Description Preference for Document Summaries
+     * Validates: Requirements 1.1, 1.2, 1.3, 1.4, 1.5, 1.6
+     */
+    describe('Property 1: Description preference for document summaries', () => {
+        const componentArbitrary = fc.record({
+            name: fc.string({ minLength: 1, maxLength: 50 }),
+            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 }),
+            rawdescription: fc.option(fc.string(), { nil: undefined }),
+            deprecated: fc.boolean(),
+        });
+        it('should prefer rawdescription over description for all documents', () => {
+            fc.assert(fc.property(componentArbitrary, (doc) => {
+                const result = formatter.formatSummary(doc);
+                // Determine expected description based on preference logic
+                const expectedDescription = doc.rawdescription ?? doc.description ?? '';
+                expect(result.description).toBe(expectedDescription);
+            }), { numRuns: 100 });
+        });
+        it('should prefer rawdescription in formatDetails', () => {
+            fc.assert(fc.property(componentArbitrary, (doc) => {
+                const result = formatter.formatDetails(doc);
+                const expectedDescription = doc.rawdescription ?? doc.description ?? '';
+                expect(result.description).toBe(expectedDescription);
+            }), { numRuns: 100 });
+        });
+    });
+    /**
+     * Property 2: Description Preference for Properties
+     * Validates: Requirements 2.1, 2.2, 2.3, 2.4
+     */
+    describe('Property 2: Description preference for properties', () => {
+        const propertyArbitrary = fc.record({
+            name: fc.string({ minLength: 1, maxLength: 50 }),
+            type: fc.string({ minLength: 1 }),
+            optional: fc.boolean(),
+            description: fc.option(fc.string(), { nil: undefined }),
+            rawdescription: fc.option(fc.string(), { nil: undefined }),
+            defaultValue: fc.option(fc.string(), { nil: undefined }),
+            deprecated: fc.boolean(),
+        });
+        const componentWithInputsArbitrary = fc.record({
+            name: fc.string({ minLength: 1 }),
+            id: fc.string({ minLength: 1 }),
+            file: fc.string({ minLength: 1 }),
+            type: fc.constant('component'),
+            deprecated: fc.boolean(),
+            inputsClass: fc.array(propertyArbitrary, { minLength: 1, maxLength: 5 }),
+        });
+        it('should prefer rawdescription over description for properties', () => {
+            fc.assert(fc.property(componentWithInputsArbitrary, (doc) => {
+                const inputs = formatter.formatInputs(doc);
+                inputs.forEach((input, index) => {
+                    const originalProp = doc.inputsClass[index];
+                    const expectedDescription = originalProp.rawdescription ?? originalProp.description ?? '';
+                    expect(input.description).toBe(expectedDescription);
+                });
+            }), { numRuns: 100 });
+        });
+    });
+    /**
+     * Property 3: Description Preference for Methods
+     * Validates: Requirements 3.1, 3.2
+     */
+    describe('Property 3: Description preference for methods', () => {
+        const argumentArbitrary = fc.record({
+            name: fc.string({ minLength: 1 }),
+            type: fc.string({ minLength: 1 }),
+            optional: fc.boolean(),
+            defaultValue: fc.option(fc.string(), { nil: undefined }),
+            deprecated: fc.boolean(),
+        });
+        const methodArbitrary = fc.record({
+            name: fc.string({ minLength: 1, maxLength: 50 }),
+            description: fc.option(fc.string(), { nil: undefined }),
+            rawdescription: fc.option(fc.string(), { nil: undefined }),
+            args: fc.option(fc.array(argumentArbitrary), { nil: undefined }),
+            returnType: fc.option(fc.string(), { nil: undefined }),
+            deprecated: fc.boolean(),
+        });
+        const componentWithMethodsArbitrary = fc.record({
+            name: fc.string({ minLength: 1 }),
+            id: fc.string({ minLength: 1 }),
+            file: fc.string({ minLength: 1 }),
+            type: fc.constant('component'),
+            deprecated: fc.boolean(),
+            methods: fc.array(methodArbitrary, { minLength: 1, maxLength: 5 }),
+        });
+        it('should prefer rawdescription over description for methods', () => {
+            fc.assert(fc.property(componentWithMethodsArbitrary, (doc) => {
+                const methods = formatter.formatMethods(doc);
+                methods.forEach((method, index) => {
+                    const originalMethod = doc.methods[index];
+                    const expectedDescription = originalMethod.rawdescription ?? originalMethod.description ?? '';
+                    expect(method.description).toBe(expectedDescription);
+                });
+            }), { numRuns: 100 });
+        });
+    });
+    /**
+     * Property 4: Output Structure Consistency
+     * Validates: Requirements 4.1, 4.3
+     */
+    describe('Property 4: Output structure consistency', () => {
+        const componentArbitrary = fc.record({
+            name: fc.string({ minLength: 1 }),
+            id: fc.string({ minLength: 1 }),
+            file: fc.string({ minLength: 1 }),
+            type: fc.constant('component'),
+            selector: fc.option(fc.string(), { nil: undefined }),
+            description: fc.option(fc.string(), { nil: undefined }),
+            rawdescription: fc.option(fc.string(), { nil: undefined }),
+            deprecated: fc.boolean(),
+        });
+        it('should maintain consistent output structure in formatSummary', () => {
+            fc.assert(fc.property(componentArbitrary, (doc) => {
+                const result = formatter.formatSummary(doc);
+                // Verify expected fields exist
+                expect(result).toHaveProperty('name');
+                expect(result).toHaveProperty('type');
+                expect(result).toHaveProperty('description');
+                expect(result).toHaveProperty('deprecated');
+                // Verify no unexpected fields (only check known fields)
+                const expectedKeys = ['name', 'type', 'selector', 'description', 'deprecated'];
+                const actualKeys = Object.keys(result);
+                actualKeys.forEach(key => {
+                    expect(expectedKeys).toContain(key);
+                });
+            }), { numRuns: 100 });
+        });
+        it('should maintain consistent output structure in formatDetails', () => {
+            fc.assert(fc.property(componentArbitrary, (doc) => {
+                const result = formatter.formatDetails(doc);
+                // Verify expected fields exist
+                expect(result).toHaveProperty('name');
+                expect(result).toHaveProperty('type');
+                expect(result).toHaveProperty('description');
+                expect(result).toHaveProperty('deprecated');
+                expect(result).toHaveProperty('inputs');
+                expect(result).toHaveProperty('outputs');
+                expect(result).toHaveProperty('methods');
+                expect(result).toHaveProperty('examples');
+                // Verify description field contains preferred value
+                const expectedDescription = doc.rawdescription ?? doc.description ?? '';
+                expect(result.description).toBe(expectedDescription);
+            }), { numRuns: 100 });
+        });
+    });
+});
+//# sourceMappingURL=result-formatter.property.test.js.map

package/dist/query/__tests__/result-formatter.property.test.js.map

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

package/dist/query/__tests__/result-formatter.test.d.ts

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

package/dist/query/__tests__/result-formatter.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result-formatter.test.d.ts","sourceRoot":"","sources":["../../../src/query/__tests__/result-formatter.test.ts"],"names":[],"mappings":""}

package/dist/query/__tests__/result-formatter.test.js

@@ -0,0 +1,85 @@
+/**
+ * Unit tests for ResultFormatter
+ */
+import { describe, it, expect } from '@jest/globals';
+import { ResultFormatter } from '../result-formatter.js';
+describe('ResultFormatter', () => {
+    const formatter = new ResultFormatter();
+    describe('getPreferredDescription', () => {
+        it('should use rawdescription when only rawdescription exists', () => {
+            const doc = {
+                name: 'TestComponent',
+                id: 'test-1',
+                file: 'test.ts',
+                type: 'component',
+                rawdescription: 'Raw description text',
+                deprecated: false,
+            };
+            const result = formatter.formatSummary(doc);
+            expect(result.description).toBe('Raw description text');
+        });
+        it('should use description when only description exists', () => {
+            const doc = {
+                name: 'TestComponent',
+                id: 'test-1',
+                file: 'test.ts',
+                type: 'component',
+                description: 'HTML description text',
+                deprecated: false,
+            };
+            const result = formatter.formatSummary(doc);
+            expect(result.description).toBe('HTML description text');
+        });
+        it('should prefer rawdescription over description when both exist', () => {
+            const doc = {
+                name: 'TestComponent',
+                id: 'test-1',
+                file: 'test.ts',
+                type: 'component',
+                rawdescription: 'Raw description text',
+                description: 'HTML description text',
+                deprecated: false,
+            };
+            const result = formatter.formatSummary(doc);
+            expect(result.description).toBe('Raw description text');
+        });
+        it('should return empty string when neither exists', () => {
+            const doc = {
+                name: 'TestComponent',
+                id: 'test-1',
+                file: 'test.ts',
+                type: 'component',
+                deprecated: false,
+            };
+            const result = formatter.formatSummary(doc);
+            expect(result.description).toBe('');
+        });
+        it('should treat empty string rawdescription as valid', () => {
+            const doc = {
+                name: 'TestComponent',
+                id: 'test-1',
+                file: 'test.ts',
+                type: 'component',
+                rawdescription: '',
+                description: 'HTML description text',
+                deprecated: false,
+            };
+            const result = formatter.formatSummary(doc);
+            expect(result.description).toBe('');
+        });
+        it('should use description when rawdescription is undefined', () => {
+            const doc = {
+                name: 'TestComponent',
+                id: 'test-1',
+                file: 'test.ts',
+                type: 'component',
+                rawdescription: undefined,
+                description: 'HTML description text',
+                deprecated: false,
+            };
+            const result = formatter.formatSummary(doc);
+            expect(result.description).toBe('HTML description text');
+        });
+    });
+});
+//# sourceMappingURL=result-formatter.test.js.map

package/dist/query/__tests__/result-formatter.test.js.map

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

package/dist/query/__tests__/search-engine.property.test.d.ts

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

package/dist/query/__tests__/search-engine.property.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-engine.property.test.d.ts","sourceRoot":"","sources":["../../../src/query/__tests__/search-engine.property.test.ts"],"names":[],"mappings":""}