@iress-oss/ids-mcp-server 0.0.1 → 5.14.2

package/dist/utils.test.js

@@ -0,0 +1,286 @@
+/**
+ * Tests for utility functions
+ */
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import * as fs from 'fs';
+import { getMarkdownFiles, mapIressComponentToFile, extractIressComponents, readFileContent, fileExists, } from './utils.js';
+// Mock fs module
+vi.mock('fs');
+vi.mock('./config.js', () => ({
+    DOCS_DIR: '/mock/docs/dir',
+}));
+const mockedFs = vi.mocked(fs);
+// Test helper functions and types
+const createComponentMapping = (componentName, filePath) => ({
+    componentName,
+    filePath,
+});
+const mockFileList = [
+    'components-button-docs.md',
+    'components-input-docs.md',
+    'components-card-docs.md',
+];
+// Type for fs.readdirSync return value to avoid repetitive eslint-disable comments
+const createMockFileArray = (...files) => files.filter((file) => file != null);
+describe('utils', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    describe('getMarkdownFiles', () => {
+        it('should return empty array when docs directory does not exist', () => {
+            mockedFs.existsSync.mockReturnValue(false);
+            const result = getMarkdownFiles();
+            expect(result).toEqual([]);
+            expect(fs.existsSync).toHaveBeenCalledWith('/mock/docs/dir');
+        });
+        it('should return markdown files when directory exists', () => {
+            mockedFs.existsSync.mockReturnValue(true);
+            mockedFs.readdirSync.mockReturnValue(createMockFileArray('components-button-docs.md', 'components-input-docs.md', 'other-file.txt', 'nested/components-card-docs.md', Buffer.from('buffer-file')));
+            const result = getMarkdownFiles();
+            expect(result).toEqual([
+                'components-button-docs.md',
+                'components-input-docs.md',
+                'nested/components-card-docs.md',
+            ]);
+            expect(fs.readdirSync).toHaveBeenCalledWith('/mock/docs/dir', {
+                recursive: true,
+            });
+        });
+        it('should handle errors gracefully', () => {
+            mockedFs.existsSync.mockReturnValue(true);
+            mockedFs.readdirSync.mockImplementation(() => {
+                throw new Error('Read error');
+            });
+            const consoleSpy = vi
+                .spyOn(console, 'error')
+                .mockImplementation(() => { });
+            const result = getMarkdownFiles();
+            expect(result).toEqual([]);
+            expect(consoleSpy).toHaveBeenCalledWith('Error reading docs directory:', expect.any(Error));
+        });
+        it('should filter out non-string entries from directory listing', () => {
+            mockedFs.existsSync.mockReturnValue(true);
+            mockedFs.readdirSync.mockReturnValue(createMockFileArray('file1.md', Buffer.from('buffer'), 'file2.md', null, undefined, 'file3.txt'));
+            const result = getMarkdownFiles();
+            expect(result).toEqual(['file1.md', 'file2.md']);
+        });
+    });
+    describe('mapIressComponentToFile', () => {
+        beforeEach(() => {
+            mockedFs.existsSync.mockReturnValue(true);
+        });
+        it('should find exact match for component', () => {
+            mockedFs.readdirSync.mockReturnValue(createMockFileArray(...mockFileList));
+            const mapping = createComponentMapping('IressButton', 'components-button-docs.md');
+            const result = mapIressComponentToFile(mapping.componentName);
+            expect(result).toBe(mapping.filePath);
+        });
+        it('should find partial match when exact match is not available', () => {
+            mockedFs.readdirSync.mockReturnValue(createMockFileArray('components-button-advanced-docs.md', 'components-input-docs.md'));
+            const mapping = createComponentMapping('IressButton', 'components-button-advanced-docs.md');
+            const result = mapIressComponentToFile(mapping.componentName);
+            expect(result).toBe(mapping.filePath);
+        });
+        it('should find fuzzy match when exact and partial matches are not available', () => {
+            mockedFs.readdirSync.mockReturnValue(createMockFileArray('components-custom-button-docs.md', 'components-input-docs.md'));
+            const mapping = createComponentMapping('IressButton', 'components-custom-button-docs.md');
+            const result = mapIressComponentToFile(mapping.componentName);
+            expect(result).toBe(mapping.filePath);
+        });
+        it('should return null when no match is found', () => {
+            mockedFs.readdirSync.mockReturnValue(createMockFileArray('components-input-docs.md', 'components-card-docs.md'));
+            const mapping = createComponentMapping('IressButton', null);
+            const result = mapIressComponentToFile(mapping.componentName);
+            expect(result).toBe(mapping.filePath);
+        });
+        it('should handle component names without Iress prefix', () => {
+            mockedFs.readdirSync.mockReturnValue(createMockFileArray('components-button-docs.md'));
+            const mapping = createComponentMapping('Button', 'components-button-docs.md');
+            const result = mapIressComponentToFile(mapping.componentName);
+            expect(result).toBe(mapping.filePath);
+        });
+        it('should handle camelCase to lowercase conversion correctly', () => {
+            mockedFs.readdirSync.mockReturnValue(createMockFileArray('components-datepicker-docs.md'));
+            const mapping = createComponentMapping('IressDatePicker', 'components-datepicker-docs.md');
+            const result = mapIressComponentToFile(mapping.componentName);
+            expect(result).toBe(mapping.filePath);
+        });
+        it('should prioritize exact match over partial match', () => {
+            mockedFs.readdirSync.mockReturnValue(createMockFileArray('components-button-docs.md', 'components-button-advanced-docs.md'));
+            const mapping = createComponentMapping('IressButton', 'components-button-docs.md');
+            const result = mapIressComponentToFile(mapping.componentName);
+            expect(result).toBe(mapping.filePath);
+        });
+        it('should prioritize partial match over fuzzy match', () => {
+            mockedFs.readdirSync.mockReturnValue(createMockFileArray('components-custom-button-docs.md', 'components-button-advanced-docs.md'));
+            const mapping = createComponentMapping('IressButton', 'components-button-advanced-docs.md');
+            const result = mapIressComponentToFile(mapping.componentName);
+            expect(result).toBe(mapping.filePath);
+        });
+    });
+    describe('extractIressComponents', () => {
+        it('should extract Iress component names from text', () => {
+            const text = `
+        Use IressButton for actions and IressInput for text entry.
+        You can also use IressCard to display content.
+      `;
+            const result = extractIressComponents(text);
+            expect(result).toEqual(['IressButton', 'IressInput', 'IressCard']);
+        });
+        it('should handle empty text', () => {
+            const result = extractIressComponents('');
+            expect(result).toEqual([]);
+        });
+        it('should handle text without Iress components', () => {
+            const text = 'This is just regular text with no components.';
+            const result = extractIressComponents(text);
+            expect(result).toEqual([]);
+        });
+        it('should remove duplicate component names', () => {
+            const text = `
+        Use IressButton here and IressButton there.
+        Also use IressInput and IressButton again.
+      `;
+            const result = extractIressComponents(text);
+            expect(result).toEqual(['IressButton', 'IressInput']);
+        });
+        it('should match component names with various cases', () => {
+            const text = `
+        IressA, IressB, IressC, IressABC, IressXYZ,
+        IressCamelCase, IressPascalCase
+      `;
+            const result = extractIressComponents(text);
+            expect(result).toEqual([
+                'IressA',
+                'IressB',
+                'IressC',
+                'IressABC',
+                'IressXYZ',
+                'IressCamelCase',
+                'IressPascalCase',
+            ]);
+        });
+        it('should match component names according to current implementation', () => {
+            const text = 'ThisIressButtonIsNotValid and IressButton is valid';
+            const result = extractIressComponents(text);
+            // Current implementation matches any "Iress" followed by capital letter and additional letters
+            // This includes compound words like "IressButtonIsNotValid"
+            expect(result).toEqual(['IressButtonIsNotValid', 'IressButton']);
+        });
+        it('should handle special characters and boundaries', () => {
+            const text = `
+        <IressButton>Click me</IressButton>
+        {IressInput}
+        IressCard.
+        IressModal,
+        IressDialog;
+        IressTooltip!
+        IressForm?
+      `;
+            const result = extractIressComponents(text);
+            expect(result).toEqual([
+                'IressButton',
+                'IressInput',
+                'IressCard',
+                'IressModal',
+                'IressDialog',
+                'IressTooltip',
+                'IressForm',
+            ]);
+        });
+    });
+    describe('readFileContent', () => {
+        it('should read file content successfully', () => {
+            const mockContent = 'Mock file content';
+            mockedFs.readFileSync.mockReturnValue(mockContent);
+            const result = readFileContent('/path/to/file.txt');
+            expect(result).toBe(mockContent);
+            expect(fs.readFileSync).toHaveBeenCalledWith('/path/to/file.txt', 'utf-8');
+        });
+        it('should propagate file system errors', () => {
+            const error = new Error('File not found');
+            mockedFs.readFileSync.mockImplementation(() => {
+                throw error;
+            });
+            expect(() => readFileContent('/nonexistent/file.txt')).toThrow('File not found');
+        });
+        it('should handle different file paths', () => {
+            mockedFs.readFileSync.mockReturnValue('content');
+            readFileContent('/absolute/path/file.txt');
+            expect(fs.readFileSync).toHaveBeenCalledWith('/absolute/path/file.txt', 'utf-8');
+            readFileContent('relative/path/file.txt');
+            expect(fs.readFileSync).toHaveBeenCalledWith('relative/path/file.txt', 'utf-8');
+        });
+    });
+    describe('fileExists', () => {
+        it('should return true when file exists', () => {
+            mockedFs.existsSync.mockReturnValue(true);
+            const result = fileExists('/path/to/file.txt');
+            expect(result).toBe(true);
+            expect(fs.existsSync).toHaveBeenCalledWith('/path/to/file.txt');
+        });
+        it('should return false when file does not exist', () => {
+            mockedFs.existsSync.mockReturnValue(false);
+            const result = fileExists('/nonexistent/file.txt');
+            expect(result).toBe(false);
+            expect(fs.existsSync).toHaveBeenCalledWith('/nonexistent/file.txt');
+        });
+        it('should handle different file paths', () => {
+            mockedFs.existsSync.mockReturnValue(true);
+            fileExists('/absolute/path/file.txt');
+            expect(fs.existsSync).toHaveBeenCalledWith('/absolute/path/file.txt');
+            fileExists('relative/path/file.txt');
+            expect(fs.existsSync).toHaveBeenCalledWith('relative/path/file.txt');
+        });
+        it('should handle edge cases', () => {
+            mockedFs.existsSync.mockReturnValue(false);
+            expect(fileExists('')).toBe(false);
+            expect(fileExists(' ')).toBe(false);
+            expect(fileExists('.')).toBe(false);
+            expect(fileExists('..')).toBe(false);
+        });
+    });
+    describe('type safety and helper functions', () => {
+        it('should create valid ComponentMapping objects', () => {
+            const validMapping = createComponentMapping('IressButton', 'components-button-docs.md');
+            const nullMapping = createComponentMapping('IressNonExistent', null);
+            expect(validMapping).toEqual({
+                componentName: 'IressButton',
+                filePath: 'components-button-docs.md',
+            });
+            expect(nullMapping).toEqual({
+                componentName: 'IressNonExistent',
+                filePath: null,
+            });
+        });
+        it('should work with mock file list type', () => {
+            const mockFile = 'components-button-docs.md';
+            expect(mockFileList).toContain(mockFile);
+            // Type checking ensures we can only use valid file names
+            expect(typeof mockFile).toBe('string');
+            expect(mockFile.endsWith('.md')).toBe(true);
+        });
+        it('should demonstrate type-safe component mapping workflow', () => {
+            mockedFs.existsSync.mockReturnValue(true);
+            mockedFs.readdirSync.mockReturnValue(createMockFileArray(...mockFileList));
+            const componentMappings = [
+                createComponentMapping('IressButton', null),
+                createComponentMapping('IressInput', null),
+                createComponentMapping('IressCard', null),
+            ];
+            // Test that all components get properly mapped
+            const results = componentMappings.map((mapping) => ({
+                ...mapping,
+                filePath: mapIressComponentToFile(mapping.componentName),
+            }));
+            expect(results).toEqual([
+                { componentName: 'IressButton', filePath: 'components-button-docs.md' },
+                { componentName: 'IressInput', filePath: 'components-input-docs.md' },
+                { componentName: 'IressCard', filePath: 'components-card-docs.md' },
+            ]);
+        });
+    });
+});

package/{docs/ids → generated/docs}/components-autocomplete-docs.md

@@ -88,7 +88,7 @@ Hide code
 
 \[data-radix-scroll-area-viewport\] { scrollbar-width: none; -ms-overflow-style: none; -webkit-overflow-scrolling: touch; } \[data-radix-scroll-area-viewport\]::-webkit-scrollbar { display: none; } :where(\[data-radix-scroll-area-viewport\]) { display: flex; flex-direction: column; align-items: stretch; } :where(\[data-radix-scroll-area-content\]) { flex-grow: 1; }
 
-import { IressAutocomplete, IressAutocompleteProps } from '@iress/ids-components';
+import { IressAutocomplete, IressAutocompleteProps } from '@iress-oss/ids-components';
 import { useState } from 'react';
 export const AutocompleteUsingState \= () \=> {
   const \[value, setValue\] \= useState('Option 1');
@@ -170,7 +170,7 @@ Hide code
 
 \[data-radix-scroll-area-viewport\] { scrollbar-width: none; -ms-overflow-style: none; -webkit-overflow-scrolling: touch; } \[data-radix-scroll-area-viewport\]::-webkit-scrollbar { display: none; } :where(\[data-radix-scroll-area-viewport\]) { display: flex; flex-direction: column; align-items: stretch; } :where(\[data-radix-scroll-area-content\]) { flex-grow: 1; }
 
-import { IressAutocomplete, IressAutocompleteProps } from '@iress/ids-components';
+import { IressAutocomplete, IressAutocompleteProps } from '@iress-oss/ids-components';
 interface StarWarsCharacter {
   name: string;
   gender: string;
@@ -553,7 +553,7 @@ Hide code
       }
     \]}
     popoverProps\={{
-      container: {}
+      container: document.body
     }}
   />
 </IressStack\>

package/{docs/ids → generated/docs}/components-autocomplete-recipes-docs.md

@@ -17,29 +17,13 @@ It has been exposed in case you need it in your application to provide custom se
 
 1.  You want to provide filtering in a certain area of the application (eg. a table).
 
-Name
-
-Gender
-
-Person 1
-
-Male
-
-Person 2
-
-Female
-
-Person 3
-
-Male
-
-Person 4
-
-Female
-
-Person 5
-
-Male
+| Name | Gender |
+| --- | --- |
+| Person 1 | Male |
+| Person 2 | Female |
+| Person 3 | Male |
+| Person 4 | Female |
+| Person 5 | Male |
 
 Hide code
 
@@ -91,45 +75,27 @@ Copy
 
 ### [](#parameters)Parameters
 
-Name
-
-Description
-
-Default
-
-Control
-
-debounceThreshold
-
+| Name | Description | Default | Control |
+| --- | --- | --- | --- |
+| debounceThreshold | 
 \-
 
-\-
-
-\-
-
-initialOptions
+ | \- | \- |
+| initialOptions | 
 
 \-
 
-\-
+ | \- | \- |
+| options | 
 
 \-
 
-options
-
-\-
+ | \- | \- |
+| query | 
 
 \-
 
-\-
-
-query
-
-\-
-
-\-
-
-\-
+ | \- | \- |
 
 On this page
 

package/{docs/ids → generated/docs}/components-card-recipes-docs.md

@@ -46,7 +46,7 @@ import {
   IressCardProps,
   IressStack,
   IressText,
-} from '@iress/ids-components';
+} from '@iress-oss/ids-components';
 import styles from '@iress-storybook/styles.module.scss';
 export const CardUsingHook \= () \=> {
   const cardProps \= composeIDSCard({

package/{docs/ids → generated/docs}/components-checkbox-docs.md

@@ -80,30 +80,17 @@ When using a checkbox without a visible label, you must supply a label and apply
 It is also important to not hide the table headers.
 
 List of investments
-
-Select
-
-Name
-
-Date
-
-Cost
-
+| Select | Name | Date | Cost |
+| --- | --- | --- | --- |
+| 
 Toggle row
 
-Artemis Fund Managers Limited
-
-2019-09-23
-
-23898.12
+ | Artemis Fund Managers Limited | 2019-09-23 | 23898.12 |
+| 
 
 Toggle row
 
-CASH.CASH
-
-2020-06-28
-
-49751.43
+ | CASH.CASH | 2020-06-28 | 49751.43 |
 
 Hide code
 

package/{docs/ids → generated/docs}/components-checkboxgroup-docs.md

@@ -115,7 +115,7 @@ import {
   IressCheckboxGroup,
   IressCheckboxGroupProps,
   IressStack,
-} from '@iress/ids-components';
+} from '@iress-oss/ids-components';
 import { useState } from 'react';
 export const CheckboxGroupUsingState \= () \=> {
   const \[value, setValue\] \= useState<FormControlValue\[\]\>(\[\]);
@@ -197,22 +197,22 @@ Hide code
       stack    </h3\>
     <IressCheckboxGroup layout\="stack"\>
       <IressCheckbox
-        className\="ids-styles--add-border-to-label-v5130"
+        className\="ids-styles--add-border-to-label-v5142"
         value\="google"
       \>
         Google      </IressCheckbox\>
       <IressCheckbox
-        className\="ids-styles--add-border-to-label-v5130"
+        className\="ids-styles--add-border-to-label-v5142"
         value\="newspaper"
       \>
         Newspaper      </IressCheckbox\>
       <IressCheckbox
-        className\="ids-styles--add-border-to-label-v5130"
+        className\="ids-styles--add-border-to-label-v5142"
         value\="friend"
       \>
         Friend      </IressCheckbox\>
       <IressCheckbox
-        className\="ids-styles--add-border-to-label-v5130"
+        className\="ids-styles--add-border-to-label-v5142"
         value\="other"
       \>
         Other      </IressCheckbox\>
@@ -223,22 +223,22 @@ Hide code
       block    </h3\>
     <IressCheckboxGroup layout\="block"\>
       <IressCheckbox
-        className\="ids-styles--add-border-to-label-v5130"
+        className\="ids-styles--add-border-to-label-v5142"
         value\="google"
       \>
         Google      </IressCheckbox\>
       <IressCheckbox
-        className\="ids-styles--add-border-to-label-v5130"
+        className\="ids-styles--add-border-to-label-v5142"
         value\="newspaper"
       \>
         Newspaper      </IressCheckbox\>
       <IressCheckbox
-        className\="ids-styles--add-border-to-label-v5130"
+        className\="ids-styles--add-border-to-label-v5142"
         value\="friend"
       \>
         Friend      </IressCheckbox\>
       <IressCheckbox
-        className\="ids-styles--add-border-to-label-v5130"
+        className\="ids-styles--add-border-to-label-v5142"
         value\="other"
       \>
         Other      </IressCheckbox\>
@@ -249,22 +249,22 @@ Hide code
       inline    </h3\>
     <IressCheckboxGroup layout\="inline"\>
       <IressCheckbox
-        className\="ids-styles--add-border-to-label-v5130"
+        className\="ids-styles--add-border-to-label-v5142"
         value\="google"
       \>
         Google      </IressCheckbox\>
       <IressCheckbox
-        className\="ids-styles--add-border-to-label-v5130"
+        className\="ids-styles--add-border-to-label-v5142"
         value\="newspaper"
       \>
         Newspaper      </IressCheckbox\>
       <IressCheckbox
-        className\="ids-styles--add-border-to-label-v5130"
+        className\="ids-styles--add-border-to-label-v5142"
         value\="friend"
       \>
         Friend      </IressCheckbox\>
       <IressCheckbox
-        className\="ids-styles--add-border-to-label-v5130"
+        className\="ids-styles--add-border-to-label-v5142"
         value\="other"
       \>
         Other      </IressCheckbox\>
@@ -275,22 +275,22 @@ Hide code
       full    </h3\>
     <IressCheckboxGroup layout\="full"\>
       <IressCheckbox
-        className\="ids-styles--add-border-to-label-v5130"
+        className\="ids-styles--add-border-to-label-v5142"
         value\="google"
       \>
         Google      </IressCheckbox\>
       <IressCheckbox
-        className\="ids-styles--add-border-to-label-v5130"
+        className\="ids-styles--add-border-to-label-v5142"
         value\="newspaper"
       \>
         Newspaper      </IressCheckbox\>
       <IressCheckbox
-        className\="ids-styles--add-border-to-label-v5130"
+        className\="ids-styles--add-border-to-label-v5142"
         value\="friend"
       \>
         Friend      </IressCheckbox\>
       <IressCheckbox
-        className\="ids-styles--add-border-to-label-v5130"
+        className\="ids-styles--add-border-to-label-v5142"
         value\="other"
       \>
         Other      </IressCheckbox\>
@@ -445,7 +445,7 @@ Hide code
     }}
   \>
     <div
-      className\="ids-styles--resizable-v5130"
+      className\="ids-styles--resizable-v5142"
       style\={{
         display: 'grid',
         gridAutoRows: '1fr',

package/{docs/ids → generated/docs}/components-checkboxgroup-recipes-docs.md

@@ -11,22 +11,22 @@ Selected values: lemon-drizzle, victoria-sponge
 Required Let them eat cake
 
 Available options
-
-Select
-
-Name
-
+| Select | Name |
+| --- | --- |
+| 
 Select lemon drizzle
 
-Lemon drizzle
+ | Lemon drizzle |
+| 
 
 Select Victoria Sponge
 
-Victoria Sponge
+ | Victoria Sponge |
+| 
 
 Select Carrot Cake
 
-Carrot Cake
+ | Carrot Cake |
 
 Submit
 
@@ -43,7 +43,7 @@ import {
   IressPanel,
   IressStack,
   IressTable,
-} from '@iress/ids-components';
+} from '@iress-oss/ids-components';
 import { IressCheckboxGroup } from '../CheckboxGroup';
 import { toArray } from '../../../helpers/formatting/toArray';
 interface FieldValues {

package/{docs/ids → generated/docs}/components-col-docs.md

@@ -429,7 +429,7 @@ Hide code
 
 <IressContainer\>
   <IressRow
-    className\="ids-styles--set-height-v5130"
+    className\="ids-styles--set-height-v5142"
     gutter\="md"
   \>
     <IressCol alignSelf\="start"\>

package/{docs/ids → generated/docs}/components-combobox-docs.md

@@ -117,7 +117,7 @@ Hide code
 
 \[data-radix-scroll-area-viewport\] { scrollbar-width: none; -ms-overflow-style: none; -webkit-overflow-scrolling: touch; } \[data-radix-scroll-area-viewport\]::-webkit-scrollbar { display: none; } :where(\[data-radix-scroll-area-viewport\]) { display: flex; flex-direction: column; align-items: stretch; } :where(\[data-radix-scroll-area-content\]) { flex-grow: 1; }
 
-import { IressCombobox, IressComboboxProps, LabelValueMeta } from '@iress/ids-components';
+import { IressCombobox, IressComboboxProps, LabelValueMeta } from '@iress-oss/ids-components';
 import { useState } from 'react';
 export const ComboboxUsingState \= () \=> {
   const \[value, setValue\] \= useState<LabelValueMeta | undefined\>();
@@ -211,7 +211,7 @@ Hide code
 
 \[data-radix-scroll-area-viewport\] { scrollbar-width: none; -ms-overflow-style: none; -webkit-overflow-scrolling: touch; } \[data-radix-scroll-area-viewport\]::-webkit-scrollbar { display: none; } :where(\[data-radix-scroll-area-viewport\]) { display: flex; flex-direction: column; align-items: stretch; } :where(\[data-radix-scroll-area-content\]) { flex-grow: 1; }
 
-import { IressCombobox, IressComboboxProps } from '@iress/ids-components';
+import { IressCombobox, IressComboboxProps } from '@iress-oss/ids-components';
 interface StarWarsCharacter {
   name: string;
   gender: string;
@@ -400,7 +400,7 @@ Hide code
     }
   \]}
   popoverProps\={{
-    container: document.body
+    container: {}
   }}
   prepend\={<IressIcon name\="search" />}
   width\="12"
@@ -533,7 +533,7 @@ Hide code
   \]}
   placeholder\="Instant search!"
   popoverProps\={{
-    container: {}
+    container: document.body
   }}
 />