@iress-oss/ids-mcp-server 0.0.1-dev.5 → 0.0.1-dev.7

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/generated/docs/components-autocomplete-docs.md

@@ -29,7 +29,7 @@ Hide code
     }
   \]}
   popoverProps\={{
-    container: {}
+    container: document.body
   }}
 />
 
@@ -203,6 +203,50 @@ export const AutocompleteUsingAsync \= () \=> (
 
 Copy
 
+#### [](#minimum-search-length-for-async-options)Minimum search length for async options
+
+When using asynchronous options, you can set a minimum number of characters required before triggering the search using the `minSearchLength` prop. This prevents unnecessary API calls and loading states for very short queries.
+
+By default, async searches are triggered after 1 character. Setting a higher value (e.g., 3) means no search request will be made and no loading spinner will appear until the user types at least that many characters.
+
+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-oss/ids-components';
+interface StarWarsCharacter {
+  name: string;
+  gender: string;
+}
+interface StarWarsCharacterApi {
+  results: StarWarsCharacter\[\];
+}
+export const AutocompleteUsingAsync \= () \=> (
+  <IressAutocomplete
+    {...{
+  popoverProps: {
+    container: document.body,
+  },
+  minSearchLength: 3,
+}}
+    options\={async (query: string) \=> {
+      if (query \=== 'error') {
+        throw new Error('This is an error');
+      }
+      const data \= await fetch(
+        \`https://swapi.py4e.com/api/people/?search=${query}\`,
+      ).then((response) \=> response.json() as Promise<StarWarsCharacterApi\>);
+      return data.results.map((character: StarWarsCharacter) \=> ({
+        label: character.name,
+        value: character.name,
+        meta: character.gender,
+      }));
+    }}
+  />
+);
+
+Copy
+
 #### [](#initialoptions)`initialOptions`
 
 If you want to provide initial options to the user, you can use the `initialOptions` prop. This is useful when you want to provide a list of options to the user before they start typing (eg. recommended search terms).
@@ -241,7 +285,7 @@ Hide code
     }
   \]}
   popoverProps\={{
-    container: {}
+    container: document.body
   }}
 />
 
@@ -450,7 +494,7 @@ Hide code
   \]}
   placeholder\="Instant search!"
   popoverProps\={{
-    container: document.body
+    container: {}
   }}
 />
 

package/generated/docs/components-checkboxgroup-docs.md

@@ -197,22 +197,22 @@ Hide code
       stack    </h3\>
     <IressCheckboxGroup layout\="stack"\>
       <IressCheckbox
-        className\="ids-styles--add-border-to-label-v5150"
+        className\="ids-styles--add-border-to-label-v5200"
         value\="google"
       \>
         Google      </IressCheckbox\>
       <IressCheckbox
-        className\="ids-styles--add-border-to-label-v5150"
+        className\="ids-styles--add-border-to-label-v5200"
         value\="newspaper"
       \>
         Newspaper      </IressCheckbox\>
       <IressCheckbox
-        className\="ids-styles--add-border-to-label-v5150"
+        className\="ids-styles--add-border-to-label-v5200"
         value\="friend"
       \>
         Friend      </IressCheckbox\>
       <IressCheckbox
-        className\="ids-styles--add-border-to-label-v5150"
+        className\="ids-styles--add-border-to-label-v5200"
         value\="other"
       \>
         Other      </IressCheckbox\>
@@ -223,22 +223,22 @@ Hide code
       block    </h3\>
     <IressCheckboxGroup layout\="block"\>
       <IressCheckbox
-        className\="ids-styles--add-border-to-label-v5150"
+        className\="ids-styles--add-border-to-label-v5200"
         value\="google"
       \>
         Google      </IressCheckbox\>
       <IressCheckbox
-        className\="ids-styles--add-border-to-label-v5150"
+        className\="ids-styles--add-border-to-label-v5200"
         value\="newspaper"
       \>
         Newspaper      </IressCheckbox\>
       <IressCheckbox
-        className\="ids-styles--add-border-to-label-v5150"
+        className\="ids-styles--add-border-to-label-v5200"
         value\="friend"
       \>
         Friend      </IressCheckbox\>
       <IressCheckbox
-        className\="ids-styles--add-border-to-label-v5150"
+        className\="ids-styles--add-border-to-label-v5200"
         value\="other"
       \>
         Other      </IressCheckbox\>
@@ -249,22 +249,22 @@ Hide code
       inline    </h3\>
     <IressCheckboxGroup layout\="inline"\>
       <IressCheckbox
-        className\="ids-styles--add-border-to-label-v5150"
+        className\="ids-styles--add-border-to-label-v5200"
         value\="google"
       \>
         Google      </IressCheckbox\>
       <IressCheckbox
-        className\="ids-styles--add-border-to-label-v5150"
+        className\="ids-styles--add-border-to-label-v5200"
         value\="newspaper"
       \>
         Newspaper      </IressCheckbox\>
       <IressCheckbox
-        className\="ids-styles--add-border-to-label-v5150"
+        className\="ids-styles--add-border-to-label-v5200"
         value\="friend"
       \>
         Friend      </IressCheckbox\>
       <IressCheckbox
-        className\="ids-styles--add-border-to-label-v5150"
+        className\="ids-styles--add-border-to-label-v5200"
         value\="other"
       \>
         Other      </IressCheckbox\>
@@ -275,22 +275,22 @@ Hide code
       full    </h3\>
     <IressCheckboxGroup layout\="full"\>
       <IressCheckbox
-        className\="ids-styles--add-border-to-label-v5150"
+        className\="ids-styles--add-border-to-label-v5200"
         value\="google"
       \>
         Google      </IressCheckbox\>
       <IressCheckbox
-        className\="ids-styles--add-border-to-label-v5150"
+        className\="ids-styles--add-border-to-label-v5200"
         value\="newspaper"
       \>
         Newspaper      </IressCheckbox\>
       <IressCheckbox
-        className\="ids-styles--add-border-to-label-v5150"
+        className\="ids-styles--add-border-to-label-v5200"
         value\="friend"
       \>
         Friend      </IressCheckbox\>
       <IressCheckbox
-        className\="ids-styles--add-border-to-label-v5150"
+        className\="ids-styles--add-border-to-label-v5200"
         value\="other"
       \>
         Other      </IressCheckbox\>
@@ -445,7 +445,7 @@ Hide code
     }}
   \>
     <div
-      className\="ids-styles--resizable-v5150"
+      className\="ids-styles--resizable-v5200"
       style\={{
         display: 'grid',
         gridAutoRows: '1fr',

package/generated/docs/components-col-docs.md

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

package/generated/docs/components-combobox-docs.md

@@ -44,7 +44,7 @@ Hide code
     }
   \]}
   popoverProps\={{
-    container: {}
+    container: document.body
   }}
 />
 
@@ -195,7 +195,7 @@ Hide code
     }
   \]}
   popoverProps\={{
-    container: document.body
+    container: {}
   }}
 />
 
@@ -533,7 +533,7 @@ Hide code
   \]}
   placeholder\="Instant search!"
   popoverProps\={{
-    container: {}
+    container: document.body
   }}
 />
 
@@ -794,7 +794,7 @@ Hide code
     }
   \]}
   popoverProps\={{
-    container: document.body
+    container: {}
   }}
   selectedOptionsTagText\="options selected"
 />

package/generated/docs/components-filter-docs.md

@@ -39,7 +39,7 @@ Hide code
     }
   \]}
   popoverProps\={{
-    container: {}
+    container: document.body
   }}
 />
 
@@ -538,7 +538,7 @@ Hide code
     }
   \]}
   popoverProps\={{
-    container: {}
+    container: document.body
   }}
 />
 
@@ -850,7 +850,7 @@ Hide code
     }
   \]}
   popoverProps\={{
-    container: document.body
+    container: {}
   }}
   searchable
 />

package/generated/docs/components-form-docs.md

@@ -205,6 +205,8 @@ Salad
 
 Type to copy an existing character's name
 
+Type at least 1 character to search
+
 \*Required Your star wars sidekick
 
 None selected
@@ -466,42 +468,7 @@ Enter a maximum length of 5 characters
 
 Validate
 
-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; }
-
-<IressForm\>
-  <IressStack gutter\="lg"\>
-    <IressFormField
-      hint\="Enter a maximum length of 5 characters"
-      label\="Default message"
-      name\="IressInput-default"
-      render\={(controlledProps) \=> <IressInput {...controlledProps} />}
-      rules\={{
-        maxLength: 5
-      }}
-    />
-    <IressFormField
-      hint\="Enter a maximum length of 5 characters"
-      label\="Custom message"
-      name\="IressInput-custom"
-      render\={(controlledProps) \=> <IressInput {...controlledProps} />}
-      rules\={{
-        maxLength: {
-          message: 'Please enter a max length of 5 characters!',
-          value: 5
-        }
-      }}
-    />
-    <IressButton
-      mode\="primary"
-      type\="submit"
-    \>
-      Validate    </IressButton\>
-  </IressStack\>
-</IressForm\>
-
-Copy
+Show code
 
 #### [](#minlength)`minLength`
 
@@ -747,7 +714,7 @@ Hide code
       name\="IressInputDate-default"
       render\={(controlledProps) \=> <IressInput {...controlledProps} />}
       rules\={{
-        minDate: new Date('2025-07-10T05:30:17.621Z')
+        minDate: new Date('2025-09-11T06:12:16.799Z')
       }}
     />
     <IressFormField
@@ -758,7 +725,7 @@ Hide code
       rules\={{
         minDate: {
           message: 'Please enter a date after today!',
-          value: new Date('2025-07-10T05:30:17.621Z')
+          value: new Date('2025-09-11T06:12:16.799Z')
         }
       }}
     />
@@ -800,7 +767,7 @@ Hide code
       name\="IressInputDate-default"
       render\={(controlledProps) \=> <IressInput {...controlledProps} />}
       rules\={{
-        maxDate: new Date('2025-07-10T05:30:17.621Z')
+        maxDate: new Date('2025-09-11T06:12:16.799Z')
       }}
     />
     <IressFormField
@@ -811,7 +778,7 @@ Hide code
       rules\={{
         maxDate: {
           message: 'Please enter a date before today!',
-          value: new Date('2025-07-10T05:30:17.621Z')
+          value: new Date('2025-09-11T06:12:16.799Z')
         }
       }}
     />

package/generated/docs/components-icon-docs.md

@@ -467,13 +467,13 @@ Hide code
     \>
       Default width    </IressText\>
     <IressIcon
-      className\="ids-styles--alt-background-v5150"
+      className\="ids-styles--alt-background-v5200"
       name\="space-shuttle"
       size\="3x"
     />
     <br />
     <IressIcon
-      className\="ids-styles--alt-background-v5150"
+      className\="ids-styles--alt-background-v5200"
       name\="wine-glass-alt"
       size\="3x"
     />
@@ -485,14 +485,14 @@ Hide code
     \>
       Fixed width    </IressText\>
     <IressIcon
-      className\="ids-styles--alt-background-v5150"
+      className\="ids-styles--alt-background-v5200"
       fixedWidth
       name\="space-shuttle"
       size\="3x"
     />
     <br />
     <IressIcon
-      className\="ids-styles--alt-background-v5150"
+      className\="ids-styles--alt-background-v5200"
       fixedWidth
       name\="wine-glass-alt"
       size\="3x"