@mytechtoday/augment-extensions 1.3.0 → 1.4.0

package/augment-extensions/visual-design/__tests__/README.md

@@ -1,119 +1,119 @@
-# Visual Design Module Tests
-
-Comprehensive unit and integration tests for the Visual Design module.
-
-## Test Files
-
-### `style-selector.test.ts`
-Tests for the style selector module, including:
-- Default vendor priority chain (google → microsoft → amazon)
-- Custom priority configuration
-- Vendor preference handling
-- Fallback logic
-- Case-insensitive vendor matching
-- Helper functions (getVendorStyle, hasVendorStyle, getAllVendorStyles)
-
-### `vendor-styles.test.ts`
-Integration tests for all vendor design systems:
-- **Google Modern (Material 3 Expressive)**: Color palette, typography, layout, motion, elevation, components
-- **Microsoft Fluent 2**: Color palette, typography, layout, motion, elevation, components
-- **Amazon Cloudscape**: Color palette, typography, layout, motion, elevation, components
-- **Cross-vendor consistency**: Ensures all vendors implement required properties
-
-## Running Tests
-
-### Prerequisites
-```bash
-npm install --save-dev jest @types/jest ts-jest
-```
-
-### Run All Tests
-```bash
-npm test
-```
-
-### Run Specific Test File
-```bash
-npm test style-selector.test.ts
-npm test vendor-styles.test.ts
-```
-
-### Run with Coverage
-```bash
-npm test -- --coverage
-```
-
-## Test Coverage
-
-The test suite covers:
-- ✅ Style selector creation and configuration
-- ✅ Default vendor priority chain
-- ✅ Custom vendor priority chains
-- ✅ Vendor preference handling
-- ✅ Fallback logic for invalid vendors
-- ✅ Case-insensitive vendor matching
-- ✅ All vendor style implementations
-- ✅ Cross-vendor consistency checks
-- ✅ Required properties validation
-- ✅ Accessibility standards validation
-- ✅ Responsive grid systems
-- ✅ Spacing systems
-
-## Expected Test Results
-
-All tests should pass with 100% coverage of:
-- `style-selector.ts`
-- `domains/web-page-styles/google-modern.ts`
-- `domains/web-page-styles/microsoft-fluent.ts`
-- `domains/web-page-styles/amazon-cloudscape.ts`
-
-## Adding New Tests
-
-When adding new vendor styles or features:
-
-1. **Add vendor style tests** in `vendor-styles.test.ts`:
-   ```typescript
-   describe('New Vendor Style', () => {
-     it('should have correct vendor identifier', () => {
-       expect(NEW_VENDOR.vendor).toBe('vendor-name');
-     });
-     // Add more tests...
-   });
-   ```
-
-2. **Update style selector tests** in `style-selector.test.ts`:
-   ```typescript
-   it('should select new vendor when specified', () => {
-     const style = selectVendorStyle({ vendor: 'new-vendor' });
-     expect(style).toBe(NEW_VENDOR);
-   });
-   ```
-
-3. **Update cross-vendor tests** to include the new vendor in the array.
-
-## Continuous Integration
-
-These tests are designed to run in CI/CD pipelines:
-- Fast execution (< 5 seconds)
-- No external dependencies
-- Deterministic results
-- Clear error messages
-
-## Troubleshooting
-
-### Import Errors
-If you encounter import errors, ensure:
-- TypeScript is configured correctly (`tsconfig.json`)
-- All dependencies are installed
-- File paths are correct
-
-### Type Errors
-If you encounter type errors:
-- Check that `types.ts` exports all required interfaces
-- Verify vendor style implementations match the `VendorStyle` interface
-- Ensure test files import types correctly
-
-## License
-
-Part of Augment Extensions. See repository root for license information.
-
+# Visual Design Module Tests
+
+Comprehensive unit and integration tests for the Visual Design module.
+
+## Test Files
+
+### `style-selector.test.ts`
+Tests for the style selector module, including:
+- Default vendor priority chain (google → microsoft → amazon)
+- Custom priority configuration
+- Vendor preference handling
+- Fallback logic
+- Case-insensitive vendor matching
+- Helper functions (getVendorStyle, hasVendorStyle, getAllVendorStyles)
+
+### `vendor-styles.test.ts`
+Integration tests for all vendor design systems:
+- **Google Modern (Material 3 Expressive)**: Color palette, typography, layout, motion, elevation, components
+- **Microsoft Fluent 2**: Color palette, typography, layout, motion, elevation, components
+- **Amazon Cloudscape**: Color palette, typography, layout, motion, elevation, components
+- **Cross-vendor consistency**: Ensures all vendors implement required properties
+
+## Running Tests
+
+### Prerequisites
+```bash
+npm install --save-dev jest @types/jest ts-jest
+```
+
+### Run All Tests
+```bash
+npm test
+```
+
+### Run Specific Test File
+```bash
+npm test style-selector.test.ts
+npm test vendor-styles.test.ts
+```
+
+### Run with Coverage
+```bash
+npm test -- --coverage
+```
+
+## Test Coverage
+
+The test suite covers:
+- ✅ Style selector creation and configuration
+- ✅ Default vendor priority chain
+- ✅ Custom vendor priority chains
+- ✅ Vendor preference handling
+- ✅ Fallback logic for invalid vendors
+- ✅ Case-insensitive vendor matching
+- ✅ All vendor style implementations
+- ✅ Cross-vendor consistency checks
+- ✅ Required properties validation
+- ✅ Accessibility standards validation
+- ✅ Responsive grid systems
+- ✅ Spacing systems
+
+## Expected Test Results
+
+All tests should pass with 100% coverage of:
+- `style-selector.ts`
+- `domains/web-page-styles/google-modern.ts`
+- `domains/web-page-styles/microsoft-fluent.ts`
+- `domains/web-page-styles/amazon-cloudscape.ts`
+
+## Adding New Tests
+
+When adding new vendor styles or features:
+
+1. **Add vendor style tests** in `vendor-styles.test.ts`:
+   ```typescript
+   describe('New Vendor Style', () => {
+     it('should have correct vendor identifier', () => {
+       expect(NEW_VENDOR.vendor).toBe('vendor-name');
+     });
+     // Add more tests...
+   });
+   ```
+
+2. **Update style selector tests** in `style-selector.test.ts`:
+   ```typescript
+   it('should select new vendor when specified', () => {
+     const style = selectVendorStyle({ vendor: 'new-vendor' });
+     expect(style).toBe(NEW_VENDOR);
+   });
+   ```
+
+3. **Update cross-vendor tests** to include the new vendor in the array.
+
+## Continuous Integration
+
+These tests are designed to run in CI/CD pipelines:
+- Fast execution (< 5 seconds)
+- No external dependencies
+- Deterministic results
+- Clear error messages
+
+## Troubleshooting
+
+### Import Errors
+If you encounter import errors, ensure:
+- TypeScript is configured correctly (`tsconfig.json`)
+- All dependencies are installed
+- File paths are correct
+
+### Type Errors
+If you encounter type errors:
+- Check that `types.ts` exports all required interfaces
+- Verify vendor style implementations match the `VendorStyle` interface
+- Ensure test files import types correctly
+
+## License
+
+Part of Augment Extensions. See repository root for license information.
+

package/augment-extensions/visual-design/__tests__/style-selector.test.ts

@@ -1,172 +1,172 @@
-/**
- * Style Selector Tests
- *
- * Comprehensive unit and integration tests for the style selector module,
- * including vendor priority, fallback logic, and preference handling.
- */
-
-import {
-  createStyleSelector,
-  defaultStyleSelector,
-  selectVendorStyle,
-  getVendorStyle,
-  getAllVendorStyles,
-  hasVendorStyle,
-  DEFAULT_VENDOR_PRIORITY
-} from '../style-selector';
-import { GOOGLE_MODERN } from '../domains/web-page-styles/google-modern';
-import { MICROSOFT_FLUENT } from '../domains/web-page-styles/microsoft-fluent';
-import { AMAZON_CLOUDSCAPE } from '../domains/web-page-styles/amazon-cloudscape';
-
-describe('Style Selector', () => {
-  describe('DEFAULT_VENDOR_PRIORITY', () => {
-    it('should have correct default priority order', () => {
-      expect(DEFAULT_VENDOR_PRIORITY).toEqual(['google', 'microsoft', 'amazon']);
-    });
-  });
-
-  describe('createStyleSelector', () => {
-    it('should create selector with default priority', () => {
-      const selector = createStyleSelector();
-      expect(selector.vendorPriority).toEqual(['google', 'microsoft', 'amazon']);
-      expect(selector.fallbackChain).toEqual(['google', 'microsoft', 'amazon']);
-    });
-
-    it('should create selector with custom priority', () => {
-      const customPriority = ['amazon', 'microsoft', 'google'];
-      const selector = createStyleSelector(customPriority);
-      expect(selector.vendorPriority).toEqual(customPriority);
-      expect(selector.fallbackChain).toEqual(customPriority);
-    });
-  });
-
-  describe('defaultStyleSelector', () => {
-    it('should be initialized with default priority', () => {
-      expect(defaultStyleSelector.vendorPriority).toEqual(['google', 'microsoft', 'amazon']);
-    });
-
-    it('should select Google Modern by default', () => {
-      const style = defaultStyleSelector.selectStyle();
-      expect(style).toBe(GOOGLE_MODERN);
-      expect(style.vendor).toBe('google');
-    });
-  });
-
-  describe('selectStyle with preferences', () => {
-    it('should select Google Modern when vendor is "google"', () => {
-      const style = defaultStyleSelector.selectStyle({ vendor: 'google' });
-      expect(style).toBe(GOOGLE_MODERN);
-      expect(style.vendor).toBe('google');
-    });
-
-    it('should select Microsoft Fluent when vendor is "microsoft"', () => {
-      const style = defaultStyleSelector.selectStyle({ vendor: 'microsoft' });
-      expect(style).toBe(MICROSOFT_FLUENT);
-      expect(style.vendor).toBe('microsoft');
-    });
-
-    it('should select Amazon Cloudscape when vendor is "amazon"', () => {
-      const style = defaultStyleSelector.selectStyle({ vendor: 'amazon' });
-      expect(style).toBe(AMAZON_CLOUDSCAPE);
-      expect(style.vendor).toBe('amazon');
-    });
-
-    it('should be case-insensitive for vendor names', () => {
-      const styleUpper = defaultStyleSelector.selectStyle({ vendor: 'GOOGLE' });
-      const styleMixed = defaultStyleSelector.selectStyle({ vendor: 'GoOgLe' });
-      expect(styleUpper).toBe(GOOGLE_MODERN);
-      expect(styleMixed).toBe(GOOGLE_MODERN);
-    });
-
-    it('should fallback to priority chain for invalid vendor', () => {
-      const style = defaultStyleSelector.selectStyle({ vendor: 'invalid' });
-      expect(style).toBe(GOOGLE_MODERN); // First in default priority
-    });
-
-    it('should fallback to Google Modern when no vendor matches', () => {
-      const selector = createStyleSelector(['nonexistent']);
-      const style = selector.selectStyle();
-      expect(style).toBe(GOOGLE_MODERN);
-    });
-  });
-
-  describe('selectStyle with custom priority', () => {
-    it('should respect custom priority order', () => {
-      const selector = createStyleSelector(['amazon', 'microsoft', 'google']);
-      const style = selector.selectStyle();
-      expect(style).toBe(AMAZON_CLOUDSCAPE);
-    });
-
-    it('should fallback through custom chain', () => {
-      const selector = createStyleSelector(['invalid1', 'microsoft', 'google']);
-      const style = selector.selectStyle();
-      expect(style).toBe(MICROSOFT_FLUENT);
-    });
-  });
-
-  describe('selectVendorStyle', () => {
-    it('should select Google Modern by default', () => {
-      const style = selectVendorStyle();
-      expect(style).toBe(GOOGLE_MODERN);
-    });
-
-    it('should respect vendor preference', () => {
-      const style = selectVendorStyle({ vendor: 'microsoft' });
-      expect(style).toBe(MICROSOFT_FLUENT);
-    });
-  });
-
-  describe('getVendorStyle', () => {
-    it('should return Google Modern for "google"', () => {
-      expect(getVendorStyle('google')).toBe(GOOGLE_MODERN);
-    });
-
-    it('should return Microsoft Fluent for "microsoft"', () => {
-      expect(getVendorStyle('microsoft')).toBe(MICROSOFT_FLUENT);
-    });
-
-    it('should return Amazon Cloudscape for "amazon"', () => {
-      expect(getVendorStyle('amazon')).toBe(AMAZON_CLOUDSCAPE);
-    });
-
-    it('should return undefined for invalid vendor', () => {
-      expect(getVendorStyle('invalid')).toBeUndefined();
-    });
-
-    it('should be case-insensitive', () => {
-      expect(getVendorStyle('GOOGLE')).toBe(GOOGLE_MODERN);
-      expect(getVendorStyle('MicroSoft')).toBe(MICROSOFT_FLUENT);
-    });
-  });
-
-  describe('getAllVendorStyles', () => {
-    it('should return all three vendor styles', () => {
-      const styles = getAllVendorStyles();
-      expect(styles).toHaveLength(3);
-      expect(styles).toContain(GOOGLE_MODERN);
-      expect(styles).toContain(MICROSOFT_FLUENT);
-      expect(styles).toContain(AMAZON_CLOUDSCAPE);
-    });
-  });
-
-  describe('hasVendorStyle', () => {
-    it('should return true for valid vendors', () => {
-      expect(hasVendorStyle('google')).toBe(true);
-      expect(hasVendorStyle('microsoft')).toBe(true);
-      expect(hasVendorStyle('amazon')).toBe(true);
-    });
-
-    it('should return false for invalid vendors', () => {
-      expect(hasVendorStyle('invalid')).toBe(false);
-      expect(hasVendorStyle('apple')).toBe(false);
-      expect(hasVendorStyle('')).toBe(false);
-    });
-
-    it('should be case-insensitive', () => {
-      expect(hasVendorStyle('GOOGLE')).toBe(true);
-      expect(hasVendorStyle('MicroSoft')).toBe(true);
-      expect(hasVendorStyle('AMAZON')).toBe(true);
-    });
-  });
-});
-
+/**
+ * Style Selector Tests
+ *
+ * Comprehensive unit and integration tests for the style selector module,
+ * including vendor priority, fallback logic, and preference handling.
+ */
+
+import {
+  createStyleSelector,
+  defaultStyleSelector,
+  selectVendorStyle,
+  getVendorStyle,
+  getAllVendorStyles,
+  hasVendorStyle,
+  DEFAULT_VENDOR_PRIORITY
+} from '../style-selector';
+import { GOOGLE_MODERN } from '../domains/web-page-styles/google-modern';
+import { MICROSOFT_FLUENT } from '../domains/web-page-styles/microsoft-fluent';
+import { AMAZON_CLOUDSCAPE } from '../domains/web-page-styles/amazon-cloudscape';
+
+describe('Style Selector', () => {
+  describe('DEFAULT_VENDOR_PRIORITY', () => {
+    it('should have correct default priority order', () => {
+      expect(DEFAULT_VENDOR_PRIORITY).toEqual(['google', 'microsoft', 'amazon']);
+    });
+  });
+
+  describe('createStyleSelector', () => {
+    it('should create selector with default priority', () => {
+      const selector = createStyleSelector();
+      expect(selector.vendorPriority).toEqual(['google', 'microsoft', 'amazon']);
+      expect(selector.fallbackChain).toEqual(['google', 'microsoft', 'amazon']);
+    });
+
+    it('should create selector with custom priority', () => {
+      const customPriority = ['amazon', 'microsoft', 'google'];
+      const selector = createStyleSelector(customPriority);
+      expect(selector.vendorPriority).toEqual(customPriority);
+      expect(selector.fallbackChain).toEqual(customPriority);
+    });
+  });
+
+  describe('defaultStyleSelector', () => {
+    it('should be initialized with default priority', () => {
+      expect(defaultStyleSelector.vendorPriority).toEqual(['google', 'microsoft', 'amazon']);
+    });
+
+    it('should select Google Modern by default', () => {
+      const style = defaultStyleSelector.selectStyle();
+      expect(style).toBe(GOOGLE_MODERN);
+      expect(style.vendor).toBe('google');
+    });
+  });
+
+  describe('selectStyle with preferences', () => {
+    it('should select Google Modern when vendor is "google"', () => {
+      const style = defaultStyleSelector.selectStyle({ vendor: 'google' });
+      expect(style).toBe(GOOGLE_MODERN);
+      expect(style.vendor).toBe('google');
+    });
+
+    it('should select Microsoft Fluent when vendor is "microsoft"', () => {
+      const style = defaultStyleSelector.selectStyle({ vendor: 'microsoft' });
+      expect(style).toBe(MICROSOFT_FLUENT);
+      expect(style.vendor).toBe('microsoft');
+    });
+
+    it('should select Amazon Cloudscape when vendor is "amazon"', () => {
+      const style = defaultStyleSelector.selectStyle({ vendor: 'amazon' });
+      expect(style).toBe(AMAZON_CLOUDSCAPE);
+      expect(style.vendor).toBe('amazon');
+    });
+
+    it('should be case-insensitive for vendor names', () => {
+      const styleUpper = defaultStyleSelector.selectStyle({ vendor: 'GOOGLE' });
+      const styleMixed = defaultStyleSelector.selectStyle({ vendor: 'GoOgLe' });
+      expect(styleUpper).toBe(GOOGLE_MODERN);
+      expect(styleMixed).toBe(GOOGLE_MODERN);
+    });
+
+    it('should fallback to priority chain for invalid vendor', () => {
+      const style = defaultStyleSelector.selectStyle({ vendor: 'invalid' });
+      expect(style).toBe(GOOGLE_MODERN); // First in default priority
+    });
+
+    it('should fallback to Google Modern when no vendor matches', () => {
+      const selector = createStyleSelector(['nonexistent']);
+      const style = selector.selectStyle();
+      expect(style).toBe(GOOGLE_MODERN);
+    });
+  });
+
+  describe('selectStyle with custom priority', () => {
+    it('should respect custom priority order', () => {
+      const selector = createStyleSelector(['amazon', 'microsoft', 'google']);
+      const style = selector.selectStyle();
+      expect(style).toBe(AMAZON_CLOUDSCAPE);
+    });
+
+    it('should fallback through custom chain', () => {
+      const selector = createStyleSelector(['invalid1', 'microsoft', 'google']);
+      const style = selector.selectStyle();
+      expect(style).toBe(MICROSOFT_FLUENT);
+    });
+  });
+
+  describe('selectVendorStyle', () => {
+    it('should select Google Modern by default', () => {
+      const style = selectVendorStyle();
+      expect(style).toBe(GOOGLE_MODERN);
+    });
+
+    it('should respect vendor preference', () => {
+      const style = selectVendorStyle({ vendor: 'microsoft' });
+      expect(style).toBe(MICROSOFT_FLUENT);
+    });
+  });
+
+  describe('getVendorStyle', () => {
+    it('should return Google Modern for "google"', () => {
+      expect(getVendorStyle('google')).toBe(GOOGLE_MODERN);
+    });
+
+    it('should return Microsoft Fluent for "microsoft"', () => {
+      expect(getVendorStyle('microsoft')).toBe(MICROSOFT_FLUENT);
+    });
+
+    it('should return Amazon Cloudscape for "amazon"', () => {
+      expect(getVendorStyle('amazon')).toBe(AMAZON_CLOUDSCAPE);
+    });
+
+    it('should return undefined for invalid vendor', () => {
+      expect(getVendorStyle('invalid')).toBeUndefined();
+    });
+
+    it('should be case-insensitive', () => {
+      expect(getVendorStyle('GOOGLE')).toBe(GOOGLE_MODERN);
+      expect(getVendorStyle('MicroSoft')).toBe(MICROSOFT_FLUENT);
+    });
+  });
+
+  describe('getAllVendorStyles', () => {
+    it('should return all three vendor styles', () => {
+      const styles = getAllVendorStyles();
+      expect(styles).toHaveLength(3);
+      expect(styles).toContain(GOOGLE_MODERN);
+      expect(styles).toContain(MICROSOFT_FLUENT);
+      expect(styles).toContain(AMAZON_CLOUDSCAPE);
+    });
+  });
+
+  describe('hasVendorStyle', () => {
+    it('should return true for valid vendors', () => {
+      expect(hasVendorStyle('google')).toBe(true);
+      expect(hasVendorStyle('microsoft')).toBe(true);
+      expect(hasVendorStyle('amazon')).toBe(true);
+    });
+
+    it('should return false for invalid vendors', () => {
+      expect(hasVendorStyle('invalid')).toBe(false);
+      expect(hasVendorStyle('apple')).toBe(false);
+      expect(hasVendorStyle('')).toBe(false);
+    });
+
+    it('should be case-insensitive', () => {
+      expect(hasVendorStyle('GOOGLE')).toBe(true);
+      expect(hasVendorStyle('MicroSoft')).toBe(true);
+      expect(hasVendorStyle('AMAZON')).toBe(true);
+    });
+  });
+});
+