@react-spa-scaffold/mcp 1.2.0 → 1.2.1

package/dist/utils/scaffold/claude-md/sections.js

@@ -0,0 +1,269 @@
+/**
+ * CLAUDE.md section generators - each function generates one section.
+ */
+import { FEATURE } from '../../../constants.js';
+/** Script descriptions for commands section. */
+const SCRIPT_DESCRIPTIONS = {
+    dev: 'Dev server at localhost:5173',
+    build: 'Production build (typecheck + bundle)',
+    preview: 'Preview production build',
+    typecheck: 'TypeScript only',
+    lint: 'ESLint check',
+    'lint:fix': 'ESLint auto-fix',
+    format: 'Prettier format',
+    'format:check': 'Prettier check',
+    test: 'Vitest once',
+    'test:watch': 'Vitest watch mode',
+    'test:coverage': 'Coverage (80% threshold)',
+    e2e: 'Playwright E2E',
+    'e2e:ui': 'Playwright UI mode',
+    'i18n:extract': 'Extract translations to .po',
+    prepare: 'Initialize Husky hooks',
+};
+export function generateHeader(projectName) {
+    return `# CLAUDE.md
+
+AI assistant guidance for **${projectName}** - a React 19 + TypeScript + Vite 7 codebase.`;
+}
+export function generateCommandsSection(scripts) {
+    const commandLines = Object.keys(scripts)
+        .sort()
+        .map((script) => {
+        const desc = SCRIPT_DESCRIPTIONS[script] || '';
+        const padding = ' '.repeat(Math.max(1, 20 - script.length));
+        return `npm run ${script}${padding}# ${desc}`;
+    });
+    return `
+## Commands
+
+\`\`\`bash
+${commandLines.join('\n')}
+\`\`\``;
+}
+export function generateStructureSection(featureIds) {
+    const parts = ['src/', '├── components/    # ui/ (primitives), layout/, shared/ (features)'];
+    if (featureIds.includes(FEATURE.API) || featureIds.includes(FEATURE.I18N) || featureIds.includes(FEATURE.MOBILE)) {
+        parts.push('├── contexts/      # React Context providers');
+    }
+    parts.push('├── hooks/         # Custom hooks');
+    const libParts = ['config', 'utils', 'format'];
+    if (featureIds.includes(FEATURE.API))
+        libParts.push('api');
+    if (featureIds.includes(FEATURE.ROUTING))
+        libParts.push('routes');
+    if (featureIds.includes(FEATURE.STATE))
+        libParts.push('storage');
+    parts.push(`├── lib/           # ${libParts.join(', ')}`);
+    if (featureIds.includes(FEATURE.ROUTING))
+        parts.push('├── pages/         # Lazy-loaded route components');
+    if (featureIds.includes(FEATURE.STATE))
+        parts.push('├── stores/        # Zustand stores');
+    if (featureIds.includes(FEATURE.I18N)) {
+        parts.push('├── i18n/          # LinguiJS config and catalogs');
+        parts.push('├── locales/       # Translation files (.po)');
+    }
+    parts.push('└── types/         # TypeScript definitions');
+    if (featureIds.includes(FEATURE.TESTING)) {
+        parts.push('', '# Unit tests co-located: *.test.ts/tsx next to source');
+        parts.push('e2e/tests/         # Playwright functional E2E tests');
+        if (featureIds.includes(FEATURE.PERFORMANCE)) {
+            parts.push('e2e/performance/   # Performance regression tests');
+        }
+    }
+    return `
+## Project Structure
+
+See [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) for full structure and data flow.
+
+\`\`\`
+${parts.join('\n')}
+\`\`\``;
+}
+export function generateCodePatternsSection(featureIds) {
+    const stateHierarchy = [];
+    if (featureIds.includes(FEATURE.STATE))
+        stateHierarchy.push('Zustand (persisted)');
+    if (featureIds.includes(FEATURE.API))
+        stateHierarchy.push('TanStack Query (server)');
+    stateHierarchy.push('Context (UI)', 'useState (local)');
+    return `
+## Code Patterns
+
+**Imports**: Always use \`@/\` path alias
+
+**Components**: Named exports + \`Props\` interface. Pages use default exports for lazy loading.
+
+**TypeScript**: \`type\` for unions, \`interface\` for objects
+
+**State hierarchy**: ${stateHierarchy.join(' → ')}
+
+See [docs/CODING_STANDARDS.md](docs/CODING_STANDARDS.md) and [docs/COMPONENT_GUIDELINES.md](docs/COMPONENT_GUIDELINES.md).`;
+}
+export function generateUiSection() {
+    return `
+## UI Components (Shadcn/UI)
+
+This project uses **Shadcn/UI** with radix-nova style. Components live in \`src/components/ui/\`.
+
+### Adding New Components
+
+\`\`\`bash
+npx shadcn@latest add button           # Single component
+npx shadcn@latest add dialog card input # Multiple components
+\`\`\`
+
+**Pattern**: Import directly (no barrel exports for UI):
+
+\`\`\`tsx
+import { Button } from '@/components/ui/button';
+import { cn } from '@/lib/utils';
+\`\`\``;
+}
+export function generateMobileSection() {
+    return `
+## Mobile & Responsive Design
+
+This project includes mobile-first responsive utilities.
+
+### Viewport Detection
+
+\`\`\`tsx
+import { MobileProvider, useMobileContext } from '@/contexts/mobileContext';
+
+// Wrap app with MobileProvider
+<MobileProvider>{children}</MobileProvider>
+
+// Use in components
+const { isMobile, isTablet, isDesktop, width } = useMobileContext();
+\`\`\`
+
+### Breakpoints
+
+\`\`\`tsx
+import { BREAKPOINTS, useIsMobile, useIsDesktop } from '@/hooks/useMediaQuery';
+
+// BREAKPOINTS: sm (640), md (768), lg (1024), xl (1280)
+const isMobile = useIsMobile();   // width < 768px
+const isDesktop = useIsDesktop(); // width >= 1024px
+\`\`\`
+
+### Touch-Aware Sizing
+
+\`\`\`tsx
+import { useTouchSizes } from '@/hooks/useTouchSizes';
+
+const sizes = useTouchSizes();
+<Button size={sizes.button}>Click</Button>  // 'touch' on mobile, 'default' on desktop
+\`\`\``;
+}
+export function generateThemingSection() {
+    return `
+## Theming
+
+Light/dark/system theme support with Zustand persistence.
+
+### Usage
+
+\`\`\`tsx
+import { usePreferencesStore } from '@/stores/preferencesStore';
+
+// Get current theme
+const theme = usePreferencesStore((s) => s.theme);
+
+// Toggle theme
+const toggleTheme = usePreferencesStore((s) => s.toggleTheme);
+
+// Get resolved theme (actual light/dark value when 'system')
+const getResolvedTheme = usePreferencesStore((s) => s.getResolvedTheme);
+\`\`\`
+
+The \`useThemeEffect\` hook automatically applies the \`.dark\` class to the document.
+The ThemeToggle component provides a UI for switching between light, dark, and system themes.`;
+}
+export function generateMcpSection(featureIds) {
+    let section = `
+## MCP Servers (PREFER OVER WebSearch)
+
+Use MCP servers for documentation lookup. They provide **structured, version-accurate data** directly from source.`;
+    if (featureIds.includes(FEATURE.UI)) {
+        section += `
+
+### Shadcn MCP (UI Components)
+
+| Need                | Tool                                             |
+| ------------------- | ------------------------------------------------ |
+| Find component      | \`mcp__shadcn__search_items_in_registries\`        |
+| View component code | \`mcp__shadcn__view_items_in_registries\`          |
+| Usage examples      | \`mcp__shadcn__get_item_examples_from_registries\` |
+| CLI add command     | \`mcp__shadcn__get_add_command_for_items\`         |`;
+    }
+    section += `
+
+### Context7 MCP (All Libraries)
+
+Use for **any npm package** documentation:
+
+\`\`\`
+resolve-library-id → get-library-docs
+\`\`\`
+
+**Examples**: react-hook-form, @tanstack/react-query, zustand, zod, date-fns
+
+### Decision Flow
+
+\`\`\`
+Need UI component?     → Shadcn MCP
+Need library docs?     → Context7 MCP (any npm package)
+Need general info?     → WebSearch (fallback only)
+\`\`\``;
+    return section;
+}
+export function generateI18nSection() {
+    return `
+## Translations (CRITICAL)
+
+All user-facing text MUST have translator comments. ESLint enforces this.
+
+\`\`\`tsx
+<Trans comment="Dashboard heading">Welcome back</Trans>
+t({ message: 'Close', comment: 'Close button' })
+\`\`\`
+
+See [docs/INTERNATIONALIZATION.md](docs/INTERNATIONALIZATION.md).`;
+}
+export function generateTestingSection() {
+    return `
+## Testing
+
+See [docs/TESTING.md](docs/TESTING.md) and [docs/E2E_TESTING.md](docs/E2E_TESTING.md).
+
+Unit tests are **co-located** with source files (\`*.test.ts/tsx\`). 80% coverage required.
+
+\`\`\`typescript
+import { describe, it, expect, vi } from 'vitest';
+import { screen, renderHook } from '@testing-library/react';
+import { render, mockMatchMedia, server } from '@/test';
+\`\`\`
+
+MSW handlers auto-reset after each test.`;
+}
+export function generateGotchasSection(featureIds) {
+    const gotchas = [];
+    if (featureIds.includes(FEATURE.DEVTOOLS)) {
+        gotchas.push('**Node.js >= 22.0.0** required (check `.nvmrc`)');
+        gotchas.push('**Conventional commits** enforced by commitlint');
+    }
+    if (featureIds.includes(FEATURE.MOBILE)) {
+        gotchas.push('**Context hooks throw** outside provider (e.g., `useMobileContext()`)');
+    }
+    gotchas.push('**Barrel exports** in each directory via `index.ts`');
+    if (featureIds.includes(FEATURE.UI)) {
+        gotchas.push('**UI components** import directly: `@/components/ui/button` (no barrel)');
+    }
+    return `
+## Common Gotchas
+
+${gotchas.map((g, i) => `${i + 1}. ${g}`).join('\n')}
+`;
+}
+//# sourceMappingURL=sections.js.map

package/dist/utils/scaffold/claude-md/sections.js.map

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

package/dist/utils/scaffold/commands.d.ts

@@ -1,11 +1,7 @@
 /**
- * Setup commands utility
- *
- * Generates the npm commands needed to set up a scaffolded project.
+ * Setup commands utility - generates npm commands for scaffolded projects.
  */
 import type { FeatureId } from '../../features/types.js';
-/**
- * Generate setup commands based on selected features
- */
+/** Generate setup commands based on selected features. */
 export declare function getSetupCommands(featureIds: FeatureId[]): string[];
 //# sourceMappingURL=commands.d.ts.map

package/dist/utils/scaffold/commands.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../../src/utils/scaffold/commands.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAEzD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,SAAS,EAAE,GAAG,MAAM,EAAE,CAgBlE"}
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../../src/utils/scaffold/commands.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAEzD,0DAA0D;AAC1D,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,SAAS,EAAE,GAAG,MAAM,EAAE,CAgBlE"}

package/dist/utils/scaffold/commands.js

@@ -1,21 +1,18 @@
 /**
- * Setup commands utility
- *
- * Generates the npm commands needed to set up a scaffolded project.
- */
-/**
- * Generate setup commands based on selected features
+ * Setup commands utility - generates npm commands for scaffolded projects.
  */
+import { FEATURE, SCRIPT } from '../../constants.js';
+/** Generate setup commands based on selected features. */
 export function getSetupCommands(featureIds) {
     const commands = ['npm install'];
-    if (featureIds.includes('devtools')) {
-        commands.push('npm run prepare'); // Initialize husky
+    if (featureIds.includes(FEATURE.DEVTOOLS)) {
+        commands.push(`npm run ${SCRIPT.PREPARE}`);
     }
-    if (featureIds.includes('testing')) {
-        commands.push('npx playwright install chromium'); // Install Playwright browser
+    if (featureIds.includes(FEATURE.TESTING)) {
+        commands.push('npx playwright install chromium');
     }
-    if (featureIds.includes('i18n')) {
-        commands.push('npm run i18n:extract'); // Extract initial translations
+    if (featureIds.includes(FEATURE.I18N)) {
+        commands.push(`npm run ${SCRIPT.I18N_EXTRACT}`);
     }
     return commands;
 }

package/dist/utils/scaffold/commands.js.map

@@ -1 +1 @@
-{"version":3,"file":"commands.js","sourceRoot":"","sources":["../../../src/utils/scaffold/commands.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,UAAuB;IACtD,MAAM,QAAQ,GAAa,CAAC,aAAa,CAAC,CAAC;IAE3C,IAAI,UAAU,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QACpC,QAAQ,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,CAAC,mBAAmB;IACvD,CAAC;IAED,IAAI,UAAU,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QACnC,QAAQ,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC,CAAC,6BAA6B;IACjF,CAAC;IAED,IAAI,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QAChC,QAAQ,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC,CAAC,+BAA+B;IACxE,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}
+{"version":3,"file":"commands.js","sourceRoot":"","sources":["../../../src/utils/scaffold/commands.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAGrD,0DAA0D;AAC1D,MAAM,UAAU,gBAAgB,CAAC,UAAuB;IACtD,MAAM,QAAQ,GAAa,CAAC,aAAa,CAAC,CAAC;IAE3C,IAAI,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1C,QAAQ,CAAC,IAAI,CAAC,WAAW,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;IAC7C,CAAC;IAED,IAAI,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACzC,QAAQ,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC;IACnD,CAAC;IAED,IAAI,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACtC,QAAQ,CAAC,IAAI,CAAC,WAAW,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC;IAClD,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/utils/scaffold/compute.d.ts

@@ -1,18 +1,15 @@
 /**
- * Scaffold computation orchestrator
+ * Scaffold computation orchestrator - coordinates all components.
  *
- * Coordinates all scaffold components to produce the final scaffold result.
+ * Returns paths only for configFiles and docs (lazy loading).
+ * Use get_file tool to fetch actual content.
  */
 import type { ScaffoldResult } from '../../features/types.js';
 /**
  * Computes complete scaffold for selected features.
  *
- * Orchestrates dependency resolution, file structure computation,
- * and dynamic content generation to produce a complete project scaffold.
- *
- * @example
- * const scaffold = await computeScaffold(['routing', 'ui'], 'my-app');
- * // Returns: { packageJson, structure, configFiles, claudeMd, ... }
+ * Returns paths only for configFiles and docs (lazy loading).
+ * Use get_file tool to fetch actual content when needed.
  */
 export declare function computeScaffold(selectedFeatures: string[], projectName?: string): Promise<ScaffoldResult>;
 //# sourceMappingURL=compute.d.ts.map

package/dist/utils/scaffold/compute.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compute.d.ts","sourceRoot":"","sources":["../../../src/utils/scaffold/compute.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAe9D;;;;;;;;;GASG;AACH,wBAAsB,eAAe,CACnC,gBAAgB,EAAE,MAAM,EAAE,EAC1B,WAAW,GAAE,MAAiB,GAC7B,OAAO,CAAC,cAAc,CAAC,CA6DzB"}
+{"version":3,"file":"compute.d.ts","sourceRoot":"","sources":["../../../src/utils/scaffold/compute.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAe9D;;;;;GAKG;AACH,wBAAsB,eAAe,CACnC,gBAAgB,EAAE,MAAM,EAAE,EAC1B,WAAW,GAAE,MAAiB,GAC7B,OAAO,CAAC,cAAc,CAAC,CA2CzB"}

package/dist/utils/scaffold/compute.js

@@ -1,13 +1,15 @@
 /**
- * Scaffold computation orchestrator
+ * Scaffold computation orchestrator - coordinates all components.
  *
- * Coordinates all scaffold components to produce the final scaffold result.
+ * Returns paths only for configFiles and docs (lazy loading).
+ * Use get_file tool to fetch actual content.
  */
 import { readFile } from 'fs/promises';
-import { computeDocsContent, computeDocsForFeatures } from '../docs.js';
+import { FEATURE } from '../../constants.js';
+import { computeDocsForFeatures } from '../docs.js';
 import { resolveTemplatePath } from '../paths.js';
 import { resolveFeatureDependencies, mergeDependencies, mergeScripts } from './dependencies.js';
-import { computeFileStructure, getConfigFiles, readConfigFileContent } from './file-structure.js';
+import { computeFileStructure, getConfigFiles } from './file-structure.js';
 import { getSetupCommands } from './commands.js';
 import { generateClaudeMd, generateViteEnvDts, generateEnvTs, generateRoutesTs } from './generators.js';
 async function readSourcePackageJson() {
@@ -18,53 +20,36 @@ async function readSourcePackageJson() {
 /**
  * Computes complete scaffold for selected features.
  *
- * Orchestrates dependency resolution, file structure computation,
- * and dynamic content generation to produce a complete project scaffold.
- *
- * @example
- * const scaffold = await computeScaffold(['routing', 'ui'], 'my-app');
- * // Returns: { packageJson, structure, configFiles, claudeMd, ... }
+ * Returns paths only for configFiles and docs (lazy loading).
+ * Use get_file tool to fetch actual content when needed.
  */
 export async function computeScaffold(selectedFeatures, projectName = 'my-app') {
-    // Resolve all dependencies
+    // Resolve all dependencies (sync)
     const resolvedFeatures = resolveFeatureDependencies(selectedFeatures);
-    // Read engines from source package.json
-    const sourcePackageJson = await readSourcePackageJson();
+    // Parallel async operations: package.json and dependencies
+    const [sourcePackageJson, depsResult] = await Promise.all([
+        readSourcePackageJson(),
+        mergeDependencies(resolvedFeatures),
+    ]);
     const engines = sourcePackageJson.engines || {};
-    // Merge all dependencies (async to read versions from source package.json)
-    const { dependencies, devDependencies } = await mergeDependencies(resolvedFeatures);
-    // Merge all scripts
-    const scripts = mergeScripts(resolvedFeatures);
-    // Get file structure (add CLAUDE.md which is generated, not from patterns)
-    // Also add docs based on selected features
-    const docPaths = computeDocsForFeatures(resolvedFeatures);
-    const structure = [...computeFileStructure(resolvedFeatures), 'CLAUDE.md', ...docPaths];
-    // Get config files with actual content read from templates
-    const configFiles = {};
-    const configPaths = getConfigFiles(resolvedFeatures);
-    for (const config of configPaths) {
-        configFiles[config] = await readConfigFileContent(config);
+    const { dependencies, devDependencies, warnings } = depsResult;
+    if (warnings.length > 0) {
+        console.error('[MCP] Dependency warnings:', warnings.join('; '));
     }
-    // Get setup commands
+    // Sync operations
+    const scripts = mergeScripts(resolvedFeatures);
+    const docs = computeDocsForFeatures(resolvedFeatures);
+    const structure = [...computeFileStructure(resolvedFeatures), 'CLAUDE.md', ...docs];
     const setupCommands = getSetupCommands(resolvedFeatures);
-    // Generate CLAUDE.md content
+    // Config files: paths only (lazy loading)
+    const configFiles = getConfigFiles(resolvedFeatures);
+    // Generate content (sync)
     const claudeMd = generateClaudeMd(resolvedFeatures, projectName, scripts);
-    // Generate vite-env.d.ts content
     const viteEnvDts = generateViteEnvDts(resolvedFeatures);
-    // Generate env.ts content
     const envTs = generateEnvTs(resolvedFeatures);
-    // Generate routes.ts content (only if routing feature is selected)
-    const routesTs = resolvedFeatures.includes('routing') ? generateRoutesTs() : undefined;
-    // Get docs with content filtered by features
-    const docs = await computeDocsContent(resolvedFeatures);
+    const routesTs = resolvedFeatures.includes(FEATURE.ROUTING) ? generateRoutesTs() : undefined;
     return {
-        packageJson: {
-            name: projectName,
-            dependencies,
-            devDependencies,
-            scripts,
-            engines,
-        },
+        packageJson: { name: projectName, dependencies, devDependencies, scripts, engines },
         structure,
         configFiles,
         setupCommands,

package/dist/utils/scaffold/compute.js.map

@@ -1 +1 @@
-{"version":3,"file":"compute.js","sourceRoot":"","sources":["../../../src/utils/scaffold/compute.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"compute.js","sourceRoot":"","sources":["../../../src/utils/scaffold/compute.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAE7C,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAElD,OAAO,EAAE,0BAA0B,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAChG,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC3E,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAExG,KAAK,UAAU,qBAAqB;IAClC,MAAM,IAAI,GAAG,mBAAmB,CAAC,cAAc,CAAC,CAAC;IACjD,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC9C,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;AAC7B,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,gBAA0B,EAC1B,cAAsB,QAAQ;IAE9B,kCAAkC;IAClC,MAAM,gBAAgB,GAAG,0BAA0B,CAAC,gBAAgB,CAAC,CAAC;IAEtE,2DAA2D;IAC3D,MAAM,CAAC,iBAAiB,EAAE,UAAU,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACxD,qBAAqB,EAAE;QACvB,iBAAiB,CAAC,gBAAgB,CAAC;KACpC,CAAC,CAAC;IAEH,MAAM,OAAO,GAAI,iBAAiB,CAAC,OAAkC,IAAI,EAAE,CAAC;IAC5E,MAAM,EAAE,YAAY,EAAE,eAAe,EAAE,QAAQ,EAAE,GAAG,UAAU,CAAC;IAE/D,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,OAAO,CAAC,KAAK,CAAC,4BAA4B,EAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACnE,CAAC;IAED,kBAAkB;IAClB,MAAM,OAAO,GAAG,YAAY,CAAC,gBAAgB,CAAC,CAAC;IAC/C,MAAM,IAAI,GAAG,sBAAsB,CAAC,gBAAgB,CAAC,CAAC;IACtD,MAAM,SAAS,GAAG,CAAC,GAAG,oBAAoB,CAAC,gBAAgB,CAAC,EAAE,WAAW,EAAE,GAAG,IAAI,CAAC,CAAC;IACpF,MAAM,aAAa,GAAG,gBAAgB,CAAC,gBAAgB,CAAC,CAAC;IAEzD,0CAA0C;IAC1C,MAAM,WAAW,GAAG,cAAc,CAAC,gBAAgB,CAAC,CAAC;IAErD,0BAA0B;IAC1B,MAAM,QAAQ,GAAG,gBAAgB,CAAC,gBAAgB,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;IAC1E,MAAM,UAAU,GAAG,kBAAkB,CAAC,gBAAgB,CAAC,CAAC;IACxD,MAAM,KAAK,GAAG,aAAa,CAAC,gBAAgB,CAAC,CAAC;IAC9C,MAAM,QAAQ,GAAG,gBAAgB,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,gBAAgB,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IAE7F,OAAO;QACL,WAAW,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,YAAY,EAAE,eAAe,EAAE,OAAO,EAAE,OAAO,EAAE;QACnF,SAAS;QACT,WAAW;QACX,aAAa;QACb,QAAQ;QACR,UAAU;QACV,KAAK;QACL,QAAQ;QACR,IAAI;KACL,CAAC;AACJ,CAAC"}

package/dist/utils/scaffold/dependencies.d.ts

@@ -1,30 +1,23 @@
 /**
- * Dependency resolution utilities
- *
- * Handles merging dependencies from features and resolving versions
- * from the source package.json at runtime.
+ * Dependency resolution - merges features and resolves versions from package.json.
  */
 import type { FeatureId } from '../../features/types.js';
 /**
  * Resolves feature dependencies and auto-includes required features.
- *
- * - Core is always included
- * - Theming auto-includes state (for Zustand persistence)
- *
- * @param selectedFeatures - Array of feature IDs selected by user
- * @returns Array of resolved FeatureIds including auto-included dependencies
+ * Core is always included. Dependencies declared via `requires` field are resolved recursively.
  */
 export declare function resolveFeatureDependencies(selectedFeatures: string[]): FeatureId[];
+/** Result of merging dependencies with any warnings. */
+export interface MergeDependenciesResult {
+    dependencies: Record<string, string>;
+    devDependencies: Record<string, string>;
+    warnings: string[];
+}
 /**
  * Merges dependencies from multiple features.
- *
- * Resolves package versions from the source package.json at runtime.
- * This ensures scaffolded projects always use up-to-date dependency versions.
+ * Returns structured warnings instead of logging to console.
  */
-export declare function mergeDependencies(featureIds: FeatureId[]): Promise<{
-    dependencies: Record<string, string>;
-    devDependencies: Record<string, string>;
-}>;
+export declare function mergeDependencies(featureIds: FeatureId[]): Promise<MergeDependenciesResult>;
 /**
  * Merge scripts from multiple features
  */

package/dist/utils/scaffold/dependencies.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dependencies.d.ts","sourceRoot":"","sources":["../../../src/utils/scaffold/dependencies.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AA4BzD;;;;;;;;GAQG;AACH,wBAAgB,0BAA0B,CAAC,gBAAgB,EAAE,MAAM,EAAE,GAAG,SAAS,EAAE,CAmBlF;AAED;;;;;GAKG;AACH,wBAAsB,iBAAiB,CAAC,UAAU,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC;IACxE,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACzC,CAAC,CAwCD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAW5E"}
+{"version":3,"file":"dependencies.d.ts","sourceRoot":"","sources":["../../../src/utils/scaffold/dependencies.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAwBzD;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,gBAAgB,EAAE,MAAM,EAAE,GAAG,SAAS,EAAE,CA2BlF;AAED,wDAAwD;AACxD,MAAM,WAAW,uBAAuB;IACtC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,UAAU,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAuCjG;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAW5E"}

package/dist/utils/scaffold/dependencies.js

@@ -1,75 +1,69 @@
 /**
- * Dependency resolution utilities
- *
- * Handles merging dependencies from features and resolving versions
- * from the source package.json at runtime.
+ * Dependency resolution - merges features and resolves versions from package.json.
  */
 import { readFile } from 'fs/promises';
 import { FEATURES, isFeatureId } from '../../features/index.js';
+import { createSingletonCache } from '../cache.js';
 import { resolveTemplatePath } from '../paths.js';
-// Cache for source package.json to avoid repeated file reads
-let cachedSourcePackageJson = null;
-/**
- * Read and cache the source package.json dependencies
- */
+const sourceDepsCache = createSingletonCache();
+/** Read and cache the source package.json dependencies. */
 async function getSourceDependencies() {
-    if (!cachedSourcePackageJson) {
+    return sourceDepsCache.getOrSet(async () => {
         const path = resolveTemplatePath('package.json');
         const content = await readFile(path, 'utf-8');
         const pkg = JSON.parse(content);
-        cachedSourcePackageJson = {
+        return {
             dependencies: (pkg.dependencies || {}),
             devDependencies: (pkg.devDependencies || {}),
         };
-    }
-    return cachedSourcePackageJson;
+    });
 }
 /**
  * Resolves feature dependencies and auto-includes required features.
- *
- * - Core is always included
- * - Theming auto-includes state (for Zustand persistence)
- *
- * @param selectedFeatures - Array of feature IDs selected by user
- * @returns Array of resolved FeatureIds including auto-included dependencies
+ * Core is always included. Dependencies declared via `requires` field are resolved recursively.
  */
 export function resolveFeatureDependencies(selectedFeatures) {
     const resolved = new Set();
-    // Always include core
+    function addWithDeps(featureId) {
+        if (resolved.has(featureId))
+            return;
+        resolved.add(featureId);
+        // Recursively add dependencies declared in `requires`
+        const feature = FEATURES[featureId];
+        if (feature.requires) {
+            for (const dep of feature.requires) {
+                addWithDeps(dep);
+            }
+        }
+    }
+    // Always include core first
     resolved.add('core');
-    // Add all selected features (no recursive dependency resolution)
+    // Add selected features with their dependencies
     for (const featureId of selectedFeatures) {
         if (isFeatureId(featureId)) {
-            resolved.add(featureId);
+            addWithDeps(featureId);
         }
     }
-    // Theming requires state feature for Zustand persistence
-    if (resolved.has('theming') && !resolved.has('state')) {
-        resolved.add('state');
-    }
     return Array.from(resolved);
 }
 /**
  * Merges dependencies from multiple features.
- *
- * Resolves package versions from the source package.json at runtime.
- * This ensures scaffolded projects always use up-to-date dependency versions.
+ * Returns structured warnings instead of logging to console.
  */
 export async function mergeDependencies(featureIds) {
     const dependencies = {};
     const devDependencies = {};
-    // Get source package.json for version lookup
+    const warnings = [];
     const sourcePkg = await getSourceDependencies();
     for (const featureId of featureIds) {
         const feature = FEATURES[featureId];
-        // Look up dependency versions from source package.json
         if (feature.dependencyNames) {
             for (const name of feature.dependencyNames) {
                 if (sourcePkg.dependencies[name]) {
                     dependencies[name] = sourcePkg.dependencies[name];
                 }
                 else {
-                    console.warn(`Dependency "${name}" not found in source package.json`);
+                    warnings.push(`Dependency "${name}" not found in source package.json (feature: ${featureId})`);
                 }
             }
         }
@@ -79,16 +73,16 @@ export async function mergeDependencies(featureIds) {
                     devDependencies[name] = sourcePkg.devDependencies[name];
                 }
                 else {
-                    console.warn(`DevDependency "${name}" not found in source package.json`);
+                    warnings.push(`DevDependency "${name}" not found in source package.json (feature: ${featureId})`);
                 }
             }
         }
     }
-    // Sort alphabetically
     const sortObject = (obj) => Object.fromEntries(Object.entries(obj).sort(([a], [b]) => a.localeCompare(b)));
     return {
         dependencies: sortObject(dependencies),
         devDependencies: sortObject(devDependencies),
+        warnings,
     };
 }
 /**