@react-spa-scaffold/mcp 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (173) hide show
  1. package/README.md +423 -0
  2. package/dist/features/index.d.ts +5 -0
  3. package/dist/features/index.d.ts.map +1 -0
  4. package/dist/features/index.js +3 -0
  5. package/dist/features/index.js.map +1 -0
  6. package/dist/features/registry.d.ts +10 -0
  7. package/dist/features/registry.d.ts.map +1 -0
  8. package/dist/features/registry.js +508 -0
  9. package/dist/features/registry.js.map +1 -0
  10. package/dist/features/types.d.ts +45 -0
  11. package/dist/features/types.d.ts.map +1 -0
  12. package/dist/features/types.js +5 -0
  13. package/dist/features/types.js.map +1 -0
  14. package/dist/features/versions.d.ts +16 -0
  15. package/dist/features/versions.d.ts.map +1 -0
  16. package/dist/features/versions.js +46 -0
  17. package/dist/features/versions.js.map +1 -0
  18. package/dist/features/versions.json +5 -0
  19. package/dist/index.d.ts +22 -0
  20. package/dist/index.d.ts.map +1 -0
  21. package/dist/index.js +43 -0
  22. package/dist/index.js.map +1 -0
  23. package/dist/resources/docs.d.ts +29 -0
  24. package/dist/resources/docs.d.ts.map +1 -0
  25. package/dist/resources/docs.js +105 -0
  26. package/dist/resources/docs.js.map +1 -0
  27. package/dist/resources/index.d.ts +2 -0
  28. package/dist/resources/index.d.ts.map +1 -0
  29. package/dist/resources/index.js +2 -0
  30. package/dist/resources/index.js.map +1 -0
  31. package/dist/server.d.ts +12 -0
  32. package/dist/server.d.ts.map +1 -0
  33. package/dist/server.js +115 -0
  34. package/dist/server.js.map +1 -0
  35. package/dist/tools/get-example.d.ts +51 -0
  36. package/dist/tools/get-example.d.ts.map +1 -0
  37. package/dist/tools/get-example.js +90 -0
  38. package/dist/tools/get-example.js.map +1 -0
  39. package/dist/tools/get-features.d.ts +30 -0
  40. package/dist/tools/get-features.d.ts.map +1 -0
  41. package/dist/tools/get-features.js +46 -0
  42. package/dist/tools/get-features.js.map +1 -0
  43. package/dist/tools/get-scaffold.d.ts +77 -0
  44. package/dist/tools/get-scaffold.d.ts.map +1 -0
  45. package/dist/tools/get-scaffold.js +153 -0
  46. package/dist/tools/get-scaffold.js.map +1 -0
  47. package/dist/tools/index.d.ts +4 -0
  48. package/dist/tools/index.d.ts.map +1 -0
  49. package/dist/tools/index.js +4 -0
  50. package/dist/tools/index.js.map +1 -0
  51. package/dist/utils/docs.d.ts +14 -0
  52. package/dist/utils/docs.d.ts.map +1 -0
  53. package/dist/utils/docs.js +64 -0
  54. package/dist/utils/docs.js.map +1 -0
  55. package/dist/utils/examples.d.ts +27 -0
  56. package/dist/utils/examples.d.ts.map +1 -0
  57. package/dist/utils/examples.js +399 -0
  58. package/dist/utils/examples.js.map +1 -0
  59. package/dist/utils/index.d.ts +5 -0
  60. package/dist/utils/index.d.ts.map +1 -0
  61. package/dist/utils/index.js +5 -0
  62. package/dist/utils/index.js.map +1 -0
  63. package/dist/utils/paths.d.ts +28 -0
  64. package/dist/utils/paths.d.ts.map +1 -0
  65. package/dist/utils/paths.js +40 -0
  66. package/dist/utils/paths.js.map +1 -0
  67. package/dist/utils/scaffold.d.ts +50 -0
  68. package/dist/utils/scaffold.d.ts.map +1 -0
  69. package/dist/utils/scaffold.js +500 -0
  70. package/dist/utils/scaffold.js.map +1 -0
  71. package/dist/version.d.ts +5 -0
  72. package/dist/version.d.ts.map +1 -0
  73. package/dist/version.js +19 -0
  74. package/dist/version.js.map +1 -0
  75. package/package.json +63 -0
  76. package/templates/.bundled +0 -0
  77. package/templates/CLAUDE.md +145 -0
  78. package/templates/docs/API_REFERENCE.md +58 -0
  79. package/templates/docs/ARCHITECTURE.md +185 -0
  80. package/templates/docs/CODING_STANDARDS.md +53 -0
  81. package/templates/docs/COMPONENT_GUIDELINES.md +301 -0
  82. package/templates/docs/E2E_TESTING.md +116 -0
  83. package/templates/docs/INTERNATIONALIZATION.md +67 -0
  84. package/templates/docs/TESTING.md +259 -0
  85. package/templates/docs/WORKFLOW.md +170 -0
  86. package/templates/src/App.tsx +42 -0
  87. package/templates/src/components/layout/Header.tsx +19 -0
  88. package/templates/src/components/layout/index.ts +1 -0
  89. package/templates/src/components/shared/ErrorBoundary/ErrorBoundary.tsx +104 -0
  90. package/templates/src/components/shared/ErrorBoundary/index.ts +1 -0
  91. package/templates/src/components/shared/LanguageSwitcher/LanguageSwitcher.tsx +45 -0
  92. package/templates/src/components/shared/LanguageSwitcher/index.ts +1 -0
  93. package/templates/src/components/shared/SEO/SEO.tsx +55 -0
  94. package/templates/src/components/shared/SEO/index.ts +1 -0
  95. package/templates/src/components/shared/ThemeToggle/ThemeToggle.tsx +41 -0
  96. package/templates/src/components/shared/ThemeToggle/index.ts +1 -0
  97. package/templates/src/components/shared/index.ts +4 -0
  98. package/templates/src/components/ui/button.tsx +48 -0
  99. package/templates/src/components/ui/dropdown-menu.tsx +228 -0
  100. package/templates/src/components/ui/form-error.tsx +95 -0
  101. package/templates/src/components/ui/loading.tsx +58 -0
  102. package/templates/src/components/ui/skeleton.tsx +52 -0
  103. package/templates/src/components/ui/sonner.tsx +34 -0
  104. package/templates/src/components/ui/spinner.tsx +40 -0
  105. package/templates/src/components/ui/visually-hidden.tsx +51 -0
  106. package/templates/src/contexts/mobileContext.tsx +66 -0
  107. package/templates/src/contexts/queryContext.tsx +28 -0
  108. package/templates/src/hooks/index.ts +7 -0
  109. package/templates/src/hooks/useContactForm.ts +33 -0
  110. package/templates/src/hooks/useExampleQuery.ts +20 -0
  111. package/templates/src/hooks/useLanguage.ts +23 -0
  112. package/templates/src/hooks/useMediaQuery.ts +53 -0
  113. package/templates/src/hooks/useThemeEffect.ts +31 -0
  114. package/templates/src/hooks/useTouchSizes.ts +16 -0
  115. package/templates/src/i18n/config.ts +11 -0
  116. package/templates/src/i18n/detectLanguage.ts +57 -0
  117. package/templates/src/i18n/index.ts +20 -0
  118. package/templates/src/i18n/loadCatalog.ts +30 -0
  119. package/templates/src/index.css +98 -0
  120. package/templates/src/lib/api.ts +142 -0
  121. package/templates/src/lib/config.ts +15 -0
  122. package/templates/src/lib/constants.ts +8 -0
  123. package/templates/src/lib/env.ts +53 -0
  124. package/templates/src/lib/format.ts +119 -0
  125. package/templates/src/lib/index.ts +24 -0
  126. package/templates/src/lib/routes.ts +11 -0
  127. package/templates/src/lib/storage.ts +91 -0
  128. package/templates/src/lib/storageKeys.ts +10 -0
  129. package/templates/src/lib/utils.ts +6 -0
  130. package/templates/src/lib/validations.ts +39 -0
  131. package/templates/src/locales/de.po +65 -0
  132. package/templates/src/locales/en.po +65 -0
  133. package/templates/src/locales/es.po +65 -0
  134. package/templates/src/main.tsx +107 -0
  135. package/templates/src/mocks/fixtures/index.ts +1 -0
  136. package/templates/src/mocks/fixtures/todos.ts +40 -0
  137. package/templates/src/mocks/handlers/index.ts +7 -0
  138. package/templates/src/mocks/handlers/todos.ts +59 -0
  139. package/templates/src/mocks/index.ts +3 -0
  140. package/templates/src/mocks/node.ts +9 -0
  141. package/templates/src/pages/Home.tsx +27 -0
  142. package/templates/src/pages/NotFound.tsx +28 -0
  143. package/templates/src/pages/index.ts +2 -0
  144. package/templates/src/stores/index.ts +2 -0
  145. package/templates/src/stores/preferencesStore.ts +85 -0
  146. package/templates/src/test/index.ts +8 -0
  147. package/templates/src/test/mocks.ts +17 -0
  148. package/templates/src/test/providers.tsx +54 -0
  149. package/templates/src/test-setup.ts +54 -0
  150. package/templates/src/types/api.ts +31 -0
  151. package/templates/src/types/index.ts +2 -0
  152. package/templates/src/types/preferences.ts +5 -0
  153. package/templates/src/vite-env.d.ts +10 -0
  154. package/templates/tests/unit/components/ErrorBoundary.test.tsx +193 -0
  155. package/templates/tests/unit/components/Header.test.tsx +33 -0
  156. package/templates/tests/unit/components/LanguageSwitcher.test.tsx +40 -0
  157. package/templates/tests/unit/components/Loading.test.tsx +76 -0
  158. package/templates/tests/unit/components/SEO.test.tsx +80 -0
  159. package/templates/tests/unit/components/ThemeToggle.test.tsx +62 -0
  160. package/templates/tests/unit/contexts/mobileContext.test.tsx +54 -0
  161. package/templates/tests/unit/hooks/useContactForm.test.ts +60 -0
  162. package/templates/tests/unit/hooks/useExampleQuery.test.tsx +94 -0
  163. package/templates/tests/unit/hooks/useLanguage.test.tsx +75 -0
  164. package/templates/tests/unit/hooks/useMediaQuery.test.ts +57 -0
  165. package/templates/tests/unit/hooks/useThemeEffect.test.ts +42 -0
  166. package/templates/tests/unit/i18n/detectLanguage.test.ts +40 -0
  167. package/templates/tests/unit/i18n/loadCatalog.test.ts +70 -0
  168. package/templates/tests/unit/lib/api.test.ts +142 -0
  169. package/templates/tests/unit/lib/format.test.ts +100 -0
  170. package/templates/tests/unit/lib/storage.test.ts +90 -0
  171. package/templates/tests/unit/lib/utils.test.ts +19 -0
  172. package/templates/tests/unit/lib/validations.test.ts +56 -0
  173. package/templates/tests/unit/stores/preferencesStore.test.ts +75 -0
@@ -0,0 +1,90 @@
1
+ import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
2
+
3
+ import { clearAppStorage, getStorageItem, removeStorageItem, setStorageItem } from '@/lib/storage';
4
+ import { STORAGE_KEYS } from '@/lib/storageKeys';
5
+
6
+ describe('storage utilities', () => {
7
+ beforeEach(() => localStorage.clear());
8
+ afterEach(() => {
9
+ localStorage.clear();
10
+ vi.restoreAllMocks();
11
+ });
12
+
13
+ describe('setStorageItem', () => {
14
+ it('stores values and returns true', () => {
15
+ expect(setStorageItem(STORAGE_KEYS.preferences, { theme: 'dark' })).toBe(true);
16
+ expect(localStorage.getItem(STORAGE_KEYS.preferences)).toBe('{"theme":"dark"}');
17
+
18
+ expect(setStorageItem(STORAGE_KEYS.locale, 'en')).toBe(true);
19
+ expect(localStorage.getItem(STORAGE_KEYS.locale)).toBe('"en"');
20
+ });
21
+
22
+ it('returns false on storage failure', () => {
23
+ vi.spyOn(console, 'error').mockImplementation(() => {});
24
+ vi.spyOn(Storage.prototype, 'setItem').mockImplementation(() => {
25
+ throw new Error('QuotaExceeded');
26
+ });
27
+
28
+ expect(setStorageItem(STORAGE_KEYS.preferences, {})).toBe(false);
29
+ });
30
+ });
31
+
32
+ describe('getStorageItem', () => {
33
+ it.each([
34
+ { stored: '{"theme":"dark"}', defaultVal: { theme: 'light' }, expected: { theme: 'dark' } },
35
+ { stored: null, defaultVal: { theme: 'light' }, expected: { theme: 'light' } },
36
+ { stored: 'not-json', defaultVal: 'en', expected: 'not-json' },
37
+ ])('retrieves stored value or default', ({ stored, defaultVal, expected }) => {
38
+ if (stored) localStorage.setItem(STORAGE_KEYS.preferences, stored);
39
+ expect(getStorageItem(STORAGE_KEYS.preferences, defaultVal)).toEqual(expected);
40
+ });
41
+
42
+ it('returns default when storage cleared during parse', () => {
43
+ let callCount = 0;
44
+ vi.spyOn(Storage.prototype, 'getItem').mockImplementation(() => {
45
+ callCount++;
46
+ return callCount === 1 ? 'invalid{' : null;
47
+ });
48
+
49
+ expect(getStorageItem(STORAGE_KEYS.locale, 'default')).toBe('default');
50
+ });
51
+ });
52
+
53
+ describe('removeStorageItem', () => {
54
+ it('removes value and returns true', () => {
55
+ localStorage.setItem(STORAGE_KEYS.preferences, '{}');
56
+ expect(removeStorageItem(STORAGE_KEYS.preferences)).toBe(true);
57
+ expect(localStorage.getItem(STORAGE_KEYS.preferences)).toBeNull();
58
+ });
59
+
60
+ it('returns false on failure', () => {
61
+ vi.spyOn(console, 'error').mockImplementation(() => {});
62
+ vi.spyOn(Storage.prototype, 'removeItem').mockImplementation(() => {
63
+ throw new Error();
64
+ });
65
+
66
+ expect(removeStorageItem(STORAGE_KEYS.preferences)).toBe(false);
67
+ });
68
+ });
69
+
70
+ describe('clearAppStorage', () => {
71
+ it('clears only app keys', () => {
72
+ localStorage.setItem(STORAGE_KEYS.preferences, '{}');
73
+ localStorage.setItem(STORAGE_KEYS.locale, '"en"');
74
+ localStorage.setItem('other-key', 'value');
75
+
76
+ expect(clearAppStorage()).toBe(true);
77
+ expect(localStorage.getItem(STORAGE_KEYS.preferences)).toBeNull();
78
+ expect(localStorage.getItem('other-key')).toBe('value');
79
+ });
80
+
81
+ it('returns false on failure', () => {
82
+ vi.spyOn(console, 'error').mockImplementation(() => {});
83
+ vi.spyOn(Storage.prototype, 'removeItem').mockImplementation(() => {
84
+ throw new Error();
85
+ });
86
+
87
+ expect(clearAppStorage()).toBe(false);
88
+ });
89
+ });
90
+ });
@@ -0,0 +1,19 @@
1
+ import { describe, expect, it } from 'vitest';
2
+
3
+ import { cn } from '@/lib/utils';
4
+
5
+ describe('cn utility', () => {
6
+ it('should merge class names', () => {
7
+ expect(cn('foo', 'bar')).toBe('foo bar');
8
+ });
9
+
10
+ it('should handle conditional classes', () => {
11
+ const isHidden = false;
12
+ const isVisible = true;
13
+ expect(cn('base', isHidden && 'hidden', isVisible && 'visible')).toBe('base visible');
14
+ });
15
+
16
+ it('should merge tailwind classes correctly', () => {
17
+ expect(cn('px-2 py-1', 'px-4')).toBe('py-1 px-4');
18
+ });
19
+ });
@@ -0,0 +1,56 @@
1
+ import { describe, expect, it } from 'vitest';
2
+
3
+ import { contactFormSchema, registerFormSchema } from '@/lib/validations';
4
+
5
+ describe('contactFormSchema', () => {
6
+ const validContact = {
7
+ name: 'John Doe',
8
+ email: 'john@example.com',
9
+ message: 'This is a valid message that is long enough.',
10
+ };
11
+
12
+ it('accepts valid data', () => {
13
+ expect(contactFormSchema.safeParse(validContact).success).toBe(true);
14
+ });
15
+
16
+ it.each([
17
+ { field: 'name', value: 'J', errorContains: 'at least 2 characters' },
18
+ { field: 'email', value: 'not-an-email', errorContains: 'valid email' },
19
+ { field: 'message', value: 'Short', errorContains: 'at least 10 characters' },
20
+ ])('rejects invalid $field', ({ field, value, errorContains }) => {
21
+ const data = { ...validContact, [field]: value };
22
+ const result = contactFormSchema.safeParse(data);
23
+
24
+ expect(result.success).toBe(false);
25
+ if (!result.success) {
26
+ expect(result.error.issues[0].message).toContain(errorContains);
27
+ }
28
+ });
29
+ });
30
+
31
+ describe('registerFormSchema', () => {
32
+ const validRegister = {
33
+ username: 'john_doe',
34
+ email: 'john@example.com',
35
+ password: 'SecurePass123',
36
+ confirmPassword: 'SecurePass123',
37
+ };
38
+
39
+ it('accepts valid data', () => {
40
+ expect(registerFormSchema.safeParse(validRegister).success).toBe(true);
41
+ });
42
+
43
+ it.each([
44
+ { field: 'username', value: 'john@doe', errorContains: 'letters, numbers, and underscores' },
45
+ { field: 'password', value: 'weakpass', errorContains: null },
46
+ { fields: { confirmPassword: 'DifferentPass123' }, errorContains: "don't match" },
47
+ ])('rejects invalid input', ({ field, fields, value, errorContains }) => {
48
+ const data = field ? { ...validRegister, [field]: value } : { ...validRegister, ...fields };
49
+ const result = registerFormSchema.safeParse(data);
50
+
51
+ expect(result.success).toBe(false);
52
+ if (!result.success && errorContains) {
53
+ expect(result.error.issues[0].message).toContain(errorContains);
54
+ }
55
+ });
56
+ });
@@ -0,0 +1,75 @@
1
+ import { act } from '@testing-library/react';
2
+ import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
3
+
4
+ import { initPreferencesSync, usePreferencesStore } from '@/stores/preferencesStore';
5
+ import { mockMatchMedia } from '@/test';
6
+
7
+ describe('preferencesStore', () => {
8
+ beforeEach(() => {
9
+ usePreferencesStore.setState({ theme: 'light' });
10
+ window.matchMedia = mockMatchMedia(false);
11
+ });
12
+
13
+ afterEach(() => {
14
+ vi.restoreAllMocks();
15
+ });
16
+
17
+ describe('setTheme', () => {
18
+ it.each(['light', 'dark', 'system'] as const)('sets theme to %s', (theme) => {
19
+ act(() => usePreferencesStore.getState().setTheme(theme));
20
+ expect(usePreferencesStore.getState().theme).toBe(theme);
21
+ });
22
+ });
23
+
24
+ describe('toggleTheme', () => {
25
+ it.each([
26
+ { initial: 'light', systemDark: false, expected: 'dark' },
27
+ { initial: 'dark', systemDark: false, expected: 'light' },
28
+ { initial: 'system', systemDark: false, expected: 'dark' },
29
+ { initial: 'system', systemDark: true, expected: 'light' },
30
+ ] as const)('toggles from $initial to $expected', ({ initial, systemDark, expected }) => {
31
+ window.matchMedia = mockMatchMedia(systemDark);
32
+ usePreferencesStore.setState({ theme: initial });
33
+
34
+ act(() => usePreferencesStore.getState().toggleTheme());
35
+
36
+ expect(usePreferencesStore.getState().theme).toBe(expected);
37
+ });
38
+ });
39
+
40
+ describe('getResolvedTheme', () => {
41
+ it.each([
42
+ { theme: 'light', systemDark: false, expected: 'light' },
43
+ { theme: 'dark', systemDark: false, expected: 'dark' },
44
+ { theme: 'system', systemDark: false, expected: 'light' },
45
+ { theme: 'system', systemDark: true, expected: 'dark' },
46
+ ] as const)('resolves $theme to $expected', ({ theme, systemDark, expected }) => {
47
+ window.matchMedia = mockMatchMedia(systemDark);
48
+ usePreferencesStore.setState({ theme });
49
+ expect(usePreferencesStore.getState().getResolvedTheme()).toBe(expected);
50
+ });
51
+ });
52
+
53
+ describe('reset', () => {
54
+ it('resets to initial state', () => {
55
+ usePreferencesStore.setState({ theme: 'dark' });
56
+ act(() => usePreferencesStore.getState().reset());
57
+ expect(usePreferencesStore.getState().theme).toBe('system');
58
+ });
59
+ });
60
+
61
+ describe('initPreferencesSync', () => {
62
+ it('adds and removes storage event listener', () => {
63
+ const addSpy = vi.spyOn(window, 'addEventListener');
64
+ const removeSpy = vi.spyOn(window, 'removeEventListener');
65
+
66
+ const cleanup = initPreferencesSync();
67
+
68
+ expect(addSpy).toHaveBeenCalledWith('storage', expect.any(Function));
69
+
70
+ cleanup();
71
+
72
+ expect(removeSpy).toHaveBeenCalledWith('storage', expect.any(Function));
73
+ });
74
+ });
75
+ });