@react-spa-scaffold/mcp 1.1.3 → 1.2.1

package/dist/utils/examples/hook-patterns.js

@@ -0,0 +1,55 @@
+export const hookPatterns = {
+    'hook-state': {
+        file: 'src/hooks/useMediaQuery.ts',
+        description: 'State hook with browser API and cleanup',
+        keyPoints: [
+            'useRef for persistent MediaQueryList',
+            'useState with SSR-safe initialization',
+            'useEffect with cleanup function',
+            'Exports constants alongside hook (BREAKPOINTS)',
+            'Convenience wrapper hooks (useIsMobile, useIsDesktop)',
+        ],
+    },
+    'hook-query': {
+        file: 'src/hooks/useExampleQuery.ts',
+        description: 'TanStack Query hook for data fetching',
+        keyPoints: [
+            'Separate async fetchFn outside hook',
+            'Typed with generics (useQuery<Todo[]>)',
+            'Namespaced queryKey array',
+            'Uses centralized API client',
+        ],
+    },
+    'hook-form': {
+        file: 'src/hooks/useRegisterForm.ts',
+        description: 'React Hook Form + Zod validation hook',
+        keyPoints: [
+            'zodResolver for Zod integration',
+            'Type-safe with inferred RegisterFormData',
+            'Returns form object + handlers + reset',
+            'Extracts commonly used state (isSubmitting, errors)',
+            'Uses schema with refine() for cross-field validation',
+        ],
+    },
+    'hook-effect': {
+        file: 'src/hooks/useThemeEffect.ts',
+        description: 'Effect-only hook with no return value',
+        keyPoints: [
+            'useEffect with conditional listener',
+            'Zustand store subscription',
+            'Cleanup function for event listener',
+            'DOM manipulation (classList)',
+        ],
+    },
+    'use-language-hook': {
+        file: 'src/hooks/useLanguage.ts',
+        description: 'Hook for language/locale management',
+        keyPoints: [
+            'Integrates with Lingui i18n',
+            'useCallback for memoized async function',
+            'Persists to localStorage',
+            'Returns object with state + action',
+        ],
+    },
+};
+//# sourceMappingURL=hook-patterns.js.map

package/dist/utils/examples/hook-patterns.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-patterns.js","sourceRoot":"","sources":["../../../src/utils/examples/hook-patterns.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,YAAY,GAAe;IACtC,YAAY,EAAE;QACZ,IAAI,EAAE,4BAA4B;QAClC,WAAW,EAAE,yCAAyC;QACtD,SAAS,EAAE;YACT,sCAAsC;YACtC,uCAAuC;YACvC,iCAAiC;YACjC,gDAAgD;YAChD,uDAAuD;SACxD;KACF;IACD,YAAY,EAAE;QACZ,IAAI,EAAE,8BAA8B;QACpC,WAAW,EAAE,uCAAuC;QACpD,SAAS,EAAE;YACT,qCAAqC;YACrC,wCAAwC;YACxC,2BAA2B;YAC3B,6BAA6B;SAC9B;KACF;IACD,WAAW,EAAE;QACX,IAAI,EAAE,8BAA8B;QACpC,WAAW,EAAE,uCAAuC;QACpD,SAAS,EAAE;YACT,iCAAiC;YACjC,0CAA0C;YAC1C,wCAAwC;YACxC,qDAAqD;YACrD,sDAAsD;SACvD;KACF;IACD,aAAa,EAAE;QACb,IAAI,EAAE,6BAA6B;QACnC,WAAW,EAAE,uCAAuC;QACpD,SAAS,EAAE;YACT,qCAAqC;YACrC,4BAA4B;YAC5B,qCAAqC;YACrC,8BAA8B;SAC/B;KACF;IACD,mBAAmB,EAAE;QACnB,IAAI,EAAE,0BAA0B;QAChC,WAAW,EAAE,qCAAqC;QAClD,SAAS,EAAE;YACT,6BAA6B;YAC7B,yCAAyC;YACzC,0BAA0B;YAC1B,oCAAoC;SACrC;KACF;CACF,CAAC"}

package/dist/utils/examples/i18n-patterns.d.ts

@@ -0,0 +1,3 @@
+import type { PatternMap } from './types.js';
+export declare const i18nPatterns: PatternMap;
+//# sourceMappingURL=i18n-patterns.d.ts.map

package/dist/utils/examples/i18n-patterns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n-patterns.d.ts","sourceRoot":"","sources":["../../../src/utils/examples/i18n-patterns.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,eAAO,MAAM,YAAY,EAAE,UAyC1B,CAAC"}

package/dist/utils/examples/i18n-patterns.js

@@ -0,0 +1,43 @@
+export const i18nPatterns = {
+    'i18n-index': {
+        file: 'src/i18n/index.ts',
+        description: 'i18n barrel export with initialization functions',
+        keyPoints: [
+            'Re-exports i18n instance from @lingui/core',
+            'initI18n() async function for app initialization',
+            'getLocale() returns current active locale',
+            'Re-exports config, detectLanguage, and dynamicActivate',
+        ],
+    },
+    'trans-component': {
+        file: 'src/components/layout/Header.tsx',
+        description: 'Trans component usage for JSX text',
+        keyPoints: [
+            'Import from @lingui/react/macro',
+            'comment prop is REQUIRED (ESLint enforced)',
+            'Wraps user-visible text',
+            'Can contain JSX children',
+        ],
+    },
+    't-function': {
+        file: 'src/components/shared/ThemeToggle/ThemeToggle.tsx',
+        description: 't() function for programmatic text',
+        keyPoints: [
+            'useLingui() hook for t function',
+            'Object syntax: t({ message, comment })',
+            'comment is REQUIRED',
+            'Use for dynamic text, attributes',
+        ],
+    },
+    'language-switcher': {
+        file: 'src/components/shared/LanguageSwitcher/LanguageSwitcher.tsx',
+        description: 'Language selection component',
+        keyPoints: [
+            'useLanguage() hook',
+            'DropdownMenu for selection',
+            'supportedLocales array',
+            'changeLanguage async function',
+        ],
+    },
+};
+//# sourceMappingURL=i18n-patterns.js.map

package/dist/utils/examples/i18n-patterns.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n-patterns.js","sourceRoot":"","sources":["../../../src/utils/examples/i18n-patterns.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,YAAY,GAAe;IACtC,YAAY,EAAE;QACZ,IAAI,EAAE,mBAAmB;QACzB,WAAW,EAAE,kDAAkD;QAC/D,SAAS,EAAE;YACT,4CAA4C;YAC5C,kDAAkD;YAClD,2CAA2C;YAC3C,wDAAwD;SACzD;KACF;IACD,iBAAiB,EAAE;QACjB,IAAI,EAAE,kCAAkC;QACxC,WAAW,EAAE,oCAAoC;QACjD,SAAS,EAAE;YACT,iCAAiC;YACjC,4CAA4C;YAC5C,yBAAyB;YACzB,0BAA0B;SAC3B;KACF;IACD,YAAY,EAAE;QACZ,IAAI,EAAE,mDAAmD;QACzD,WAAW,EAAE,oCAAoC;QACjD,SAAS,EAAE;YACT,iCAAiC;YACjC,wCAAwC;YACxC,qBAAqB;YACrB,kCAAkC;SACnC;KACF;IACD,mBAAmB,EAAE;QACnB,IAAI,EAAE,6DAA6D;QACnE,WAAW,EAAE,8BAA8B;QAC3C,SAAS,EAAE;YACT,oBAAoB;YACpB,4BAA4B;YAC5B,wBAAwB;YACxB,+BAA+B;SAChC;KACF;CACF,CAAC"}

package/dist/utils/examples/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Code examples - provides real code patterns from the react-spa-scaffold repository.
+ */
+import type { CodeExample } from './types.js';
+export type { CodeExample } from './types.js';
+/** Get all available pattern names. */
+export declare function getAvailablePatterns(): string[];
+/** Get code example for a pattern. */
+export declare function getCodeExample(pattern: string): Promise<CodeExample | null>;
+/** Get all examples for a list of patterns (parallel). */
+export declare function getFeatureExamples(patterns: string[]): Promise<CodeExample[]>;
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/examples/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/examples/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EAAE,WAAW,EAAc,MAAM,YAAY,CAAC;AAY1D,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAkB9C,uCAAuC;AACvC,wBAAgB,oBAAoB,IAAI,MAAM,EAAE,CAE/C;AAED,sCAAsC;AACtC,wBAAsB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAwBjF;AAED,0DAA0D;AAC1D,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAGnF"}

package/dist/utils/examples/index.js

@@ -0,0 +1,65 @@
+/**
+ * Code examples - provides real code patterns from the react-spa-scaffold repository.
+ */
+import { readFile } from 'fs/promises';
+import { resolveTemplatePath } from '../paths.js';
+import { componentPatterns } from './component-patterns.js';
+import { hookPatterns } from './hook-patterns.js';
+import { mobilePatterns } from './mobile-patterns.js';
+import { storePatterns } from './store-patterns.js';
+import { pagePatterns } from './page-patterns.js';
+import { contextPatterns } from './context-patterns.js';
+import { apiPatterns } from './api-patterns.js';
+import { testPatterns } from './test-patterns.js';
+import { i18nPatterns } from './i18n-patterns.js';
+import { utilityPatterns } from './utility-patterns.js';
+/** All pattern definitions merged at startup. */
+const PATTERN_MAP = {
+    ...componentPatterns,
+    ...hookPatterns,
+    ...mobilePatterns,
+    ...storePatterns,
+    ...pagePatterns,
+    ...contextPatterns,
+    ...apiPatterns,
+    ...testPatterns,
+    ...i18nPatterns,
+    ...utilityPatterns,
+};
+const PATTERN_NAMES = Object.keys(PATTERN_MAP).sort();
+/** Get all available pattern names. */
+export function getAvailablePatterns() {
+    return PATTERN_NAMES;
+}
+/** Get code example for a pattern. */
+export async function getCodeExample(pattern) {
+    const mapping = PATTERN_MAP[pattern];
+    if (!mapping)
+        return null;
+    const fullPath = resolveTemplatePath(mapping.file);
+    try {
+        const code = await readFile(fullPath, 'utf-8');
+        return {
+            pattern,
+            description: mapping.description,
+            filePath: mapping.file,
+            code,
+            keyPoints: mapping.keyPoints,
+        };
+    }
+    catch {
+        return {
+            pattern,
+            description: mapping.description,
+            filePath: mapping.file,
+            code: `// File not found: ${mapping.file}\n// Run MCP server from within react-spa-scaffold repository`,
+            keyPoints: mapping.keyPoints,
+        };
+    }
+}
+/** Get all examples for a list of patterns (parallel). */
+export async function getFeatureExamples(patterns) {
+    const examples = await Promise.all(patterns.map(getCodeExample));
+    return examples.filter((e) => e !== null);
+}
+//# sourceMappingURL=index.js.map

package/dist/utils/examples/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/examples/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAElD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAIxD,iDAAiD;AACjD,MAAM,WAAW,GAAe;IAC9B,GAAG,iBAAiB;IACpB,GAAG,YAAY;IACf,GAAG,cAAc;IACjB,GAAG,aAAa;IAChB,GAAG,YAAY;IACf,GAAG,eAAe;IAClB,GAAG,WAAW;IACd,GAAG,YAAY;IACf,GAAG,YAAY;IACf,GAAG,eAAe;CACnB,CAAC;AAEF,MAAM,aAAa,GAAG,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,IAAI,EAAE,CAAC;AAEtD,uCAAuC;AACvC,MAAM,UAAU,oBAAoB;IAClC,OAAO,aAAa,CAAC;AACvB,CAAC;AAED,sCAAsC;AACtC,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,OAAe;IAClD,MAAM,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;IACrC,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAE1B,MAAM,QAAQ,GAAG,mBAAmB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnD,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC/C,OAAO;YACL,OAAO;YACP,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,QAAQ,EAAE,OAAO,CAAC,IAAI;YACtB,IAAI;YACJ,SAAS,EAAE,OAAO,CAAC,SAAS;SAC7B,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO;YACL,OAAO;YACP,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,QAAQ,EAAE,OAAO,CAAC,IAAI;YACtB,IAAI,EAAE,sBAAsB,OAAO,CAAC,IAAI,+DAA+D;YACvG,SAAS,EAAE,OAAO,CAAC,SAAS;SAC7B,CAAC;IACJ,CAAC;AACH,CAAC;AAED,0DAA0D;AAC1D,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,QAAkB;IACzD,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC;IACjE,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAoB,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;AAC9D,CAAC"}

package/dist/utils/examples/mobile-patterns.d.ts

@@ -0,0 +1,3 @@
+import type { PatternMap } from './types.js';
+export declare const mobilePatterns: PatternMap;
+//# sourceMappingURL=mobile-patterns.d.ts.map

package/dist/utils/examples/mobile-patterns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mobile-patterns.d.ts","sourceRoot":"","sources":["../../../src/utils/examples/mobile-patterns.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,eAAO,MAAM,cAAc,EAAE,UAoC5B,CAAC"}

package/dist/utils/examples/mobile-patterns.js

@@ -0,0 +1,38 @@
+export const mobilePatterns = {
+    'mobile-context': {
+        file: 'src/contexts/mobileContext.tsx',
+        description: 'Mobile viewport detection context with optimized resize handling',
+        keyPoints: [
+            'MobileProvider tracks viewport width via window.innerWidth',
+            'useMobileContext hook returns isMobile, isTablet, isDesktop, width',
+            'requestAnimationFrame debouncing for performance',
+            'Only re-renders when width actually changes',
+            'SSR-safe with BREAKPOINTS.lg fallback',
+            'Throws error when used outside provider',
+        ],
+    },
+    'use-media-query': {
+        file: 'src/hooks/useMediaQuery.ts',
+        description: 'Media query hook with breakpoint constants',
+        keyPoints: [
+            'BREAKPOINTS: sm (640), md (768), lg (1024), xl (1280)',
+            'useMediaQuery(query) for custom media queries',
+            'useIsMobile() returns true if width < md breakpoint',
+            'useIsDesktop() returns true if width >= lg breakpoint',
+            'Uses useRef to persist MediaQueryList object',
+            'SSR-safe initialization',
+        ],
+    },
+    'use-touch-sizes': {
+        file: 'src/hooks/useTouchSizes.ts',
+        description: 'Touch-aware component sizing hook',
+        keyPoints: [
+            'Returns size variants based on device type (mobile vs desktop)',
+            'Integrates with MobileProvider via useMobileContext',
+            'Provides: button, buttonSm, iconButton, iconButtonLg, input, select, toggle, textarea',
+            'Mobile uses "touch" variants for larger tap targets',
+            'Desktop uses "default" or smaller variants',
+        ],
+    },
+};
+//# sourceMappingURL=mobile-patterns.js.map

package/dist/utils/examples/mobile-patterns.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mobile-patterns.js","sourceRoot":"","sources":["../../../src/utils/examples/mobile-patterns.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,cAAc,GAAe;IACxC,gBAAgB,EAAE;QAChB,IAAI,EAAE,gCAAgC;QACtC,WAAW,EAAE,kEAAkE;QAC/E,SAAS,EAAE;YACT,4DAA4D;YAC5D,oEAAoE;YACpE,kDAAkD;YAClD,6CAA6C;YAC7C,uCAAuC;YACvC,yCAAyC;SAC1C;KACF;IACD,iBAAiB,EAAE;QACjB,IAAI,EAAE,4BAA4B;QAClC,WAAW,EAAE,4CAA4C;QACzD,SAAS,EAAE;YACT,uDAAuD;YACvD,+CAA+C;YAC/C,qDAAqD;YACrD,uDAAuD;YACvD,8CAA8C;YAC9C,yBAAyB;SAC1B;KACF;IACD,iBAAiB,EAAE;QACjB,IAAI,EAAE,4BAA4B;QAClC,WAAW,EAAE,mCAAmC;QAChD,SAAS,EAAE;YACT,gEAAgE;YAChE,qDAAqD;YACrD,uFAAuF;YACvF,qDAAqD;YACrD,4CAA4C;SAC7C;KACF;CACF,CAAC"}

package/dist/utils/examples/page-patterns.d.ts

@@ -0,0 +1,3 @@
+import type { PatternMap } from './types.js';
+export declare const pagePatterns: PatternMap;
+//# sourceMappingURL=page-patterns.d.ts.map

package/dist/utils/examples/page-patterns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-patterns.d.ts","sourceRoot":"","sources":["../../../src/utils/examples/page-patterns.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,eAAO,MAAM,YAAY,EAAE,UAgC1B,CAAC"}

package/dist/utils/examples/page-patterns.js

@@ -0,0 +1,34 @@
+export const pagePatterns = {
+    'page-component': {
+        file: 'src/pages/Home.tsx',
+        description: 'Page component with i18n and SEO',
+        keyPoints: [
+            'Named export (PageNamePage convention)',
+            'SEO component for page-specific meta tags',
+            'Trans component for all user text',
+            'Container layout classes',
+            'Minimal logic (pages are thin)',
+        ],
+    },
+    'lazy-page': {
+        file: 'src/App.tsx',
+        description: 'Lazy loading pattern for pages with default SEO',
+        keyPoints: [
+            'React.lazy() with dynamic import',
+            'Transform named to default: .then(m => ({ default: m.PageName }))',
+            'Suspense boundary with fallback',
+            'Route constants from lib/routes.ts',
+            'Default SEO component for site-wide meta tags',
+        ],
+    },
+    'route-constants': {
+        file: 'src/lib/routes.ts',
+        description: 'Typed route constants',
+        keyPoints: [
+            'ROUTES object with as const',
+            'AppRoute type for type-safe navigation',
+            'Centralized route definitions',
+        ],
+    },
+};
+//# sourceMappingURL=page-patterns.js.map

package/dist/utils/examples/page-patterns.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-patterns.js","sourceRoot":"","sources":["../../../src/utils/examples/page-patterns.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,YAAY,GAAe;IACtC,gBAAgB,EAAE;QAChB,IAAI,EAAE,oBAAoB;QAC1B,WAAW,EAAE,kCAAkC;QAC/C,SAAS,EAAE;YACT,wCAAwC;YACxC,2CAA2C;YAC3C,mCAAmC;YACnC,0BAA0B;YAC1B,gCAAgC;SACjC;KACF;IACD,WAAW,EAAE;QACX,IAAI,EAAE,aAAa;QACnB,WAAW,EAAE,iDAAiD;QAC9D,SAAS,EAAE;YACT,kCAAkC;YAClC,mEAAmE;YACnE,iCAAiC;YACjC,oCAAoC;YACpC,+CAA+C;SAChD;KACF;IACD,iBAAiB,EAAE;QACjB,IAAI,EAAE,mBAAmB;QACzB,WAAW,EAAE,uBAAuB;QACpC,SAAS,EAAE;YACT,6BAA6B;YAC7B,wCAAwC;YACxC,+BAA+B;SAChC;KACF;CACF,CAAC"}

package/dist/utils/examples/patterns.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Pattern definition validation tests.
+ * Ensures all pattern file paths exist and definitions are complete.
+ */
+export {};
+//# sourceMappingURL=patterns.test.d.ts.map

package/dist/utils/examples/patterns.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"patterns.test.d.ts","sourceRoot":"","sources":["../../../src/utils/examples/patterns.test.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/utils/examples/patterns.test.js

@@ -0,0 +1,75 @@
+/**
+ * Pattern definition validation tests.
+ * Ensures all pattern file paths exist and definitions are complete.
+ */
+import { existsSync } from 'fs';
+import { describe, it, expect } from 'vitest';
+import { resolveTemplatePath } from '../paths.js';
+import { getAvailablePatterns, getCodeExample } from './index.js';
+// Import all pattern maps to test
+import { componentPatterns } from './component-patterns.js';
+import { hookPatterns } from './hook-patterns.js';
+import { mobilePatterns } from './mobile-patterns.js';
+import { storePatterns } from './store-patterns.js';
+import { pagePatterns } from './page-patterns.js';
+import { contextPatterns } from './context-patterns.js';
+import { apiPatterns } from './api-patterns.js';
+import { testPatterns } from './test-patterns.js';
+import { i18nPatterns } from './i18n-patterns.js';
+import { utilityPatterns } from './utility-patterns.js';
+const ALL_PATTERNS = {
+    ...componentPatterns,
+    ...hookPatterns,
+    ...mobilePatterns,
+    ...storePatterns,
+    ...pagePatterns,
+    ...contextPatterns,
+    ...apiPatterns,
+    ...testPatterns,
+    ...i18nPatterns,
+    ...utilityPatterns,
+};
+describe('pattern definitions', () => {
+    const patterns = Object.entries(ALL_PATTERNS);
+    it.each(patterns)('pattern "%s" points to existing file', (_, def) => {
+        const fullPath = resolveTemplatePath(def.file);
+        expect(existsSync(fullPath), `File not found: ${def.file}`).toBe(true);
+    });
+    it.each(patterns)('pattern "%s" has description', (_, def) => {
+        expect(def.description).toBeTruthy();
+        expect(def.description.length).toBeGreaterThan(10);
+    });
+    it.each(patterns)('pattern "%s" has keyPoints array', (_, def) => {
+        expect(Array.isArray(def.keyPoints)).toBe(true);
+        expect(def.keyPoints.length).toBeGreaterThan(0);
+    });
+});
+describe('getAvailablePatterns', () => {
+    it('returns sorted array of pattern names', () => {
+        const patterns = getAvailablePatterns();
+        expect(patterns.length).toBeGreaterThan(0);
+        expect(patterns).toEqual([...patterns].sort());
+    });
+    it('includes all pattern categories', () => {
+        const patterns = getAvailablePatterns();
+        expect(patterns).toContain('component-ui');
+        expect(patterns).toContain('hook-state');
+        expect(patterns).toContain('zustand-store');
+        expect(patterns).toContain('test-component');
+    });
+});
+describe('getCodeExample', () => {
+    it('returns null for unknown pattern', async () => {
+        const result = await getCodeExample('non-existent-pattern');
+        expect(result).toBeNull();
+    });
+    it('returns complete example for valid pattern', async () => {
+        const result = await getCodeExample('component-ui');
+        expect(result).not.toBeNull();
+        expect(result?.pattern).toBe('component-ui');
+        expect(result?.code).toBeTruthy();
+        expect(result?.description).toBeTruthy();
+        expect(result?.keyPoints.length).toBeGreaterThan(0);
+    });
+});
+//# sourceMappingURL=patterns.test.js.map

package/dist/utils/examples/patterns.test.js.map

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

package/dist/utils/examples/store-patterns.d.ts

@@ -0,0 +1,3 @@
+import type { PatternMap } from './types.js';
+export declare const storePatterns: PatternMap;
+//# sourceMappingURL=store-patterns.d.ts.map

package/dist/utils/examples/store-patterns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store-patterns.d.ts","sourceRoot":"","sources":["../../../src/utils/examples/store-patterns.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,eAAO,MAAM,aAAa,EAAE,UAsC3B,CAAC"}

package/dist/utils/examples/store-patterns.js

@@ -0,0 +1,40 @@
+export const storePatterns = {
+    'zustand-store': {
+        file: 'src/stores/preferencesStore.ts',
+        description: 'Zustand store with persistence and devtools',
+        keyPoints: [
+            'Separate type and interface definitions',
+            'Middleware stack: devtools(persist(...))',
+            'partialize for selective persistence',
+            'Computed getter (getResolvedTheme)',
+            'reset() action for initial state',
+            'Multi-tab sync function export',
+        ],
+    },
+    'store-persistence': {
+        file: 'src/stores/preferencesStore.ts',
+        description: 'Zustand persist middleware',
+        keyPoints: [
+            'persist() middleware with name key',
+            'partialize to select what to persist',
+            'Storage key naming convention',
+        ],
+    },
+    'multi-tab-sync': {
+        file: 'src/stores/preferencesStore.ts',
+        description: 'Multi-tab state synchronization',
+        keyPoints: ['Storage event listener', 'Rehydrate on storage change', 'Cleanup function for HMR'],
+    },
+    'storage-utility': {
+        file: 'src/lib/storage.ts',
+        description: 'Type-safe localStorage utilities',
+        keyPoints: [
+            'SSR-safe (typeof window check)',
+            'JSON serialization',
+            'Generic type parameter',
+            'Error handling with fallback',
+            'clearAppStorage for all prefixed keys',
+        ],
+    },
+};
+//# sourceMappingURL=store-patterns.js.map

package/dist/utils/examples/store-patterns.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store-patterns.js","sourceRoot":"","sources":["../../../src/utils/examples/store-patterns.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,aAAa,GAAe;IACvC,eAAe,EAAE;QACf,IAAI,EAAE,gCAAgC;QACtC,WAAW,EAAE,6CAA6C;QAC1D,SAAS,EAAE;YACT,yCAAyC;YACzC,0CAA0C;YAC1C,sCAAsC;YACtC,oCAAoC;YACpC,kCAAkC;YAClC,gCAAgC;SACjC;KACF;IACD,mBAAmB,EAAE;QACnB,IAAI,EAAE,gCAAgC;QACtC,WAAW,EAAE,4BAA4B;QACzC,SAAS,EAAE;YACT,oCAAoC;YACpC,sCAAsC;YACtC,+BAA+B;SAChC;KACF;IACD,gBAAgB,EAAE;QAChB,IAAI,EAAE,gCAAgC;QACtC,WAAW,EAAE,iCAAiC;QAC9C,SAAS,EAAE,CAAC,wBAAwB,EAAE,6BAA6B,EAAE,0BAA0B,CAAC;KACjG;IACD,iBAAiB,EAAE;QACjB,IAAI,EAAE,oBAAoB;QAC1B,WAAW,EAAE,kCAAkC;QAC/C,SAAS,EAAE;YACT,gCAAgC;YAChC,oBAAoB;YACpB,wBAAwB;YACxB,8BAA8B;YAC9B,uCAAuC;SACxC;KACF;CACF,CAAC"}

package/dist/utils/examples/test-patterns.d.ts

@@ -0,0 +1,3 @@
+import type { PatternMap } from './types.js';
+export declare const testPatterns: PatternMap;
+//# sourceMappingURL=test-patterns.d.ts.map

package/dist/utils/examples/test-patterns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-patterns.d.ts","sourceRoot":"","sources":["../../../src/utils/examples/test-patterns.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,eAAO,MAAM,YAAY,EAAE,UAwD1B,CAAC"}

package/dist/utils/examples/test-patterns.js

@@ -0,0 +1,58 @@
+export const testPatterns = {
+    'test-component': {
+        file: 'src/components/layout/Header.test.tsx',
+        description: 'Component test with Testing Library',
+        keyPoints: [
+            'Import from vitest (describe, it, expect)',
+            'Custom render from @/test',
+            'screen queries (getByRole, getByText)',
+            'Semantic role assertions',
+            'Co-located with component source file',
+        ],
+    },
+    'test-hook': {
+        file: 'src/hooks/useMediaQuery.test.ts',
+        description: 'Hook test with renderHook',
+        keyPoints: [
+            'renderHook from Testing Library',
+            'mockMatchMedia utility',
+            'beforeEach for setup',
+            'it.each for parameterized tests',
+            'act() for state updates',
+            'Co-located with hook source file',
+        ],
+    },
+    'test-store': {
+        file: 'src/stores/preferencesStore.test.ts',
+        description: 'Zustand store test',
+        keyPoints: [
+            'Direct store access: useStore.getState()',
+            'act() wrapper for state changes',
+            'Reset state in beforeEach',
+            'Test actions and computed values',
+            'Co-located with store source file',
+        ],
+    },
+    'test-utility': {
+        file: 'src/lib/utils.test.ts',
+        description: 'Utility function test',
+        keyPoints: ['Simple describe/it/expect pattern', 'Test edge cases', 'No mocking needed'],
+    },
+    'msw-handler': {
+        file: 'src/mocks/handlers/todos.ts',
+        description: 'MSW request handler',
+        keyPoints: [
+            'http.get/post from msw',
+            'HttpResponse.json() for responses',
+            'URL parameter extraction',
+            'delay() for realistic timing',
+            'Error responses with status codes',
+        ],
+    },
+    'test-fixture': {
+        file: 'src/mocks/fixtures/todos.ts',
+        description: 'Test data fixtures',
+        keyPoints: ['Typed mock data', 'Realistic test values', 'Reusable across tests'],
+    },
+};
+//# sourceMappingURL=test-patterns.js.map

package/dist/utils/examples/test-patterns.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-patterns.js","sourceRoot":"","sources":["../../../src/utils/examples/test-patterns.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,YAAY,GAAe;IACtC,gBAAgB,EAAE;QAChB,IAAI,EAAE,uCAAuC;QAC7C,WAAW,EAAE,qCAAqC;QAClD,SAAS,EAAE;YACT,2CAA2C;YAC3C,2BAA2B;YAC3B,uCAAuC;YACvC,0BAA0B;YAC1B,uCAAuC;SACxC;KACF;IACD,WAAW,EAAE;QACX,IAAI,EAAE,iCAAiC;QACvC,WAAW,EAAE,2BAA2B;QACxC,SAAS,EAAE;YACT,iCAAiC;YACjC,wBAAwB;YACxB,sBAAsB;YACtB,iCAAiC;YACjC,yBAAyB;YACzB,kCAAkC;SACnC;KACF;IACD,YAAY,EAAE;QACZ,IAAI,EAAE,qCAAqC;QAC3C,WAAW,EAAE,oBAAoB;QACjC,SAAS,EAAE;YACT,0CAA0C;YAC1C,iCAAiC;YACjC,2BAA2B;YAC3B,kCAAkC;YAClC,mCAAmC;SACpC;KACF;IACD,cAAc,EAAE;QACd,IAAI,EAAE,uBAAuB;QAC7B,WAAW,EAAE,uBAAuB;QACpC,SAAS,EAAE,CAAC,mCAAmC,EAAE,iBAAiB,EAAE,mBAAmB,CAAC;KACzF;IACD,aAAa,EAAE;QACb,IAAI,EAAE,6BAA6B;QACnC,WAAW,EAAE,qBAAqB;QAClC,SAAS,EAAE;YACT,wBAAwB;YACxB,mCAAmC;YACnC,0BAA0B;YAC1B,8BAA8B;YAC9B,mCAAmC;SACpC;KACF;IACD,cAAc,EAAE;QACd,IAAI,EAAE,6BAA6B;QACnC,WAAW,EAAE,oBAAoB;QACjC,SAAS,EAAE,CAAC,iBAAiB,EAAE,uBAAuB,EAAE,uBAAuB,CAAC;KACjF;CACF,CAAC"}

package/dist/utils/examples/types.d.ts

@@ -0,0 +1,17 @@
+/** Code example returned by get_example tool. */
+export interface CodeExample {
+    pattern: string;
+    description: string;
+    filePath: string;
+    code: string;
+    keyPoints: string[];
+}
+/** Pattern definition mapping. */
+export interface PatternDef {
+    file: string;
+    description: string;
+    keyPoints: string[];
+}
+/** Pattern map type. */
+export type PatternMap = Record<string, PatternDef>;
+//# sourceMappingURL=types.d.ts.map

package/dist/utils/examples/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/utils/examples/types.ts"],"names":[],"mappings":"AAAA,iDAAiD;AACjD,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,kCAAkC;AAClC,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,wBAAwB;AACxB,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC"}

package/dist/utils/examples/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/utils/examples/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/utils/examples/types.ts"],"names":[],"mappings":""}

package/dist/utils/examples/utility-patterns.d.ts

@@ -0,0 +1,3 @@
+import type { PatternMap } from './types.js';
+export declare const utilityPatterns: PatternMap;
+//# sourceMappingURL=utility-patterns.d.ts.map

package/dist/utils/examples/utility-patterns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utility-patterns.d.ts","sourceRoot":"","sources":["../../../src/utils/examples/utility-patterns.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,eAAO,MAAM,eAAe,EAAE,UA2E7B,CAAC"}