@polymorphism-tech/morph-spec 3.2.0 → 4.3.0

package/src/commands/{validate-blazor.js → validation/validate-blazor.js}

@@ -1,156 +1,156 @@
-/**
- * validate-blazor command
- *
- * Validates Fluent UI Blazor patterns and icons in Razor files.
- *
- * Usage:
- *   morph-spec validate-blazor [path]
- *   morph-spec validate-blazor src/Components --verbose
- */
-
-import { glob } from 'glob';
-import { readFileSync, existsSync, statSync } from 'fs';
-import { join, resolve } from 'path';
-import chalk from 'chalk';
-import ora from 'ora';
-
-import {
-  validateBlazorFile,
-  formatIssues,
-  countIssues,
-} from '../lib/blazor-validator.js';
-
-/**
- * Main command handler for validate-blazor.
- *
- * @param {string} [targetPath] - Path to validate (file or directory)
- * @param {Object} options - Command options
- * @param {boolean} [options.verbose] - Show detailed output
- * @param {boolean} [options.fix] - Auto-fix issues where possible
- */
-export async function validateBlazorCommand(targetPath, options = {}) {
-  const { verbose = false } = options;
-
-  console.log('');
-  console.log(
-    chalk.cyan('\uD83D\uDD0D Validating Fluent UI Blazor patterns...')
-  );
-  console.log('');
-
-  // Determine target path
-  const basePath = targetPath ? resolve(targetPath) : process.cwd();
-
-  if (!existsSync(basePath)) {
-    console.log(chalk.red(`\u274C Path not found: ${basePath}`));
-    process.exit(1);
-  }
-
-  const spinner = ora('Scanning for Razor files...').start();
-
-  let files = [];
-
-  try {
-    const stats = statSync(basePath);
-
-    if (stats.isFile()) {
-      // Single file
-      if (
-        basePath.endsWith('.razor') ||
-        basePath.endsWith('.razor.cs') ||
-        basePath.endsWith('.cs')
-      ) {
-        files = [basePath];
-      } else {
-        spinner.fail('File must be .razor or .cs');
-        process.exit(1);
-      }
-    } else {
-      // Directory - find all Razor files
-      const pattern = join(basePath, '**/*.{razor,razor.cs}');
-      files = await glob(pattern, {
-        ignore: ['**/node_modules/**', '**/bin/**', '**/obj/**'],
-        windowsPathsNoEscape: true,
-      });
-    }
-
-    spinner.succeed(`Found ${files.length} Razor file(s)`);
-  } catch (error) {
-    spinner.fail(`Error scanning files: ${error.message}`);
-    process.exit(1);
-  }
-
-  if (files.length === 0) {
-    console.log(chalk.yellow('\n\u26A0\uFE0F No Razor files found to validate'));
-    return;
-  }
-
-  // Validate each file
-  const allIssues = [];
-  const fileResults = [];
-
-  for (const file of files) {
-    try {
-      const content = readFileSync(file, 'utf-8');
-      const issues = validateBlazorFile(content, file);
-
-      if (issues.length > 0) {
-        allIssues.push(...issues);
-        fileResults.push({ file, issues });
-      }
-    } catch (error) {
-      console.log(chalk.red(`\u274C Error reading ${file}: ${error.message}`));
-    }
-  }
-
-  // Output results
-  console.log('');
-
-  if (allIssues.length === 0) {
-    console.log(
-      chalk.green('\u2705 No issues found! All patterns look correct.')
-    );
-    console.log('');
-    return;
-  }
-
-  // Group and display issues
-  if (verbose) {
-    // Verbose: show all issues with details
-    fileResults.forEach(({ file, issues }) => {
-      console.log(chalk.white.bold(`\n${file}`));
-      console.log(chalk.gray('-'.repeat(60)));
-      console.log(formatIssues(issues));
-    });
-  } else {
-    // Compact: just list issues
-    allIssues.forEach((issue) => {
-      const icon = issue.type === 'error' ? '\u274C' : '\u26A0\uFE0F';
-      const location = issue.line ? `${issue.file}:${issue.line}` : issue.file;
-
-      console.log(`${icon} ${issue.message}`);
-      if (issue.suggestion) {
-        console.log(chalk.gray(`   \u2192 ${issue.suggestion}`));
-      }
-      console.log(chalk.dim(`   ${location}`));
-      console.log('');
-    });
-  }
-
-  // Summary
-  const { errors, warnings } = countIssues(allIssues);
-  const summaryColor = errors > 0 ? chalk.red : chalk.yellow;
-
-  console.log(chalk.gray('-'.repeat(60)));
-  console.log(
-    summaryColor(
-      `\n${files.length} arquivo(s) validado(s) | ${errors} erro(s) | ${warnings} warning(s)\n`
-    )
-  );
-
-  // Exit with error code if there are errors
-  if (errors > 0) {
-    process.exit(1);
-  }
-}
-
-export default validateBlazorCommand;
+/**
+ * validate-blazor command
+ *
+ * Validates Fluent UI Blazor patterns and icons in Razor files.
+ *
+ * Usage:
+ *   morph-spec validate-blazor [path]
+ *   morph-spec validate-blazor src/Components --verbose
+ */
+
+import { glob } from 'glob';
+import { readFileSync, existsSync, statSync } from 'fs';
+import { join, resolve } from 'path';
+import chalk from 'chalk';
+import ora from 'ora';
+
+import {
+  validateBlazorFile,
+  formatIssues,
+} from '../../lib/validators/blazor/blazor-validator.js';
+import { countIssues } from '../../lib/validators/shared/index.js';
+
+/**
+ * Main command handler for validate-blazor.
+ *
+ * @param {string} [targetPath] - Path to validate (file or directory)
+ * @param {Object} options - Command options
+ * @param {boolean} [options.verbose] - Show detailed output
+ * @param {boolean} [options.fix] - Auto-fix issues where possible
+ */
+export async function validateBlazorCommand(targetPath, options = {}) {
+  const { verbose = false } = options;
+
+  console.log('');
+  console.log(
+    chalk.cyan('\uD83D\uDD0D Validating Fluent UI Blazor patterns...')
+  );
+  console.log('');
+
+  // Determine target path
+  const basePath = targetPath ? resolve(targetPath) : process.cwd();
+
+  if (!existsSync(basePath)) {
+    console.log(chalk.red(`\u274C Path not found: ${basePath}`));
+    process.exit(1);
+  }
+
+  const spinner = ora('Scanning for Razor files...').start();
+
+  let files = [];
+
+  try {
+    const stats = statSync(basePath);
+
+    if (stats.isFile()) {
+      // Single file
+      if (
+        basePath.endsWith('.razor') ||
+        basePath.endsWith('.razor.cs') ||
+        basePath.endsWith('.cs')
+      ) {
+        files = [basePath];
+      } else {
+        spinner.fail('File must be .razor or .cs');
+        process.exit(1);
+      }
+    } else {
+      // Directory - find all Razor files
+      const pattern = join(basePath, '**/*.{razor,razor.cs}');
+      files = await glob(pattern, {
+        ignore: ['**/node_modules/**', '**/bin/**', '**/obj/**'],
+        windowsPathsNoEscape: true,
+      });
+    }
+
+    spinner.succeed(`Found ${files.length} Razor file(s)`);
+  } catch (error) {
+    spinner.fail(`Error scanning files: ${error.message}`);
+    process.exit(1);
+  }
+
+  if (files.length === 0) {
+    console.log(chalk.yellow('\n\u26A0\uFE0F No Razor files found to validate'));
+    return;
+  }
+
+  // Validate each file
+  const allIssues = [];
+  const fileResults = [];
+
+  for (const file of files) {
+    try {
+      const content = readFileSync(file, 'utf-8');
+      const issues = validateBlazorFile(content, file);
+
+      if (issues.length > 0) {
+        allIssues.push(...issues);
+        fileResults.push({ file, issues });
+      }
+    } catch (error) {
+      console.log(chalk.red(`\u274C Error reading ${file}: ${error.message}`));
+    }
+  }
+
+  // Output results
+  console.log('');
+
+  if (allIssues.length === 0) {
+    console.log(
+      chalk.green('\u2705 No issues found! All patterns look correct.')
+    );
+    console.log('');
+    return;
+  }
+
+  // Group and display issues
+  if (verbose) {
+    // Verbose: show all issues with details
+    fileResults.forEach(({ file, issues }) => {
+      console.log(chalk.white.bold(`\n${file}`));
+      console.log(chalk.gray('-'.repeat(60)));
+      console.log(formatIssues(issues));
+    });
+  } else {
+    // Compact: just list issues
+    allIssues.forEach((issue) => {
+      const icon = issue.type === 'error' ? '\u274C' : '\u26A0\uFE0F';
+      const location = issue.line ? `${issue.file}:${issue.line}` : issue.file;
+
+      console.log(`${icon} ${issue.message}`);
+      if (issue.suggestion) {
+        console.log(chalk.gray(`   \u2192 ${issue.suggestion}`));
+      }
+      console.log(chalk.dim(`   ${location}`));
+      console.log('');
+    });
+  }
+
+  // Summary
+  const { errors, warnings } = countIssues(allIssues);
+  const summaryColor = errors > 0 ? chalk.red : chalk.yellow;
+
+  console.log(chalk.gray('-'.repeat(60)));
+  console.log(
+    summaryColor(
+      `\n${files.length} arquivo(s) validado(s) | ${errors} erro(s) | ${warnings} warning(s)\n`
+    )
+  );
+
+  // Exit with error code if there are errors
+  if (errors > 0) {
+    process.exit(1);
+  }
+}
+
+export default validateBlazorCommand;

package/src/commands/{validate-css.js → validation/validate-css.js}

@@ -1,84 +1,84 @@
-/**
- * MORPH-SPEC validate-css Command
- *
- * Validates that all CSS classes used in Razor files are defined in CSS files.
- * Helps catch missing CSS definitions before runtime.
- *
- * Usage:
- *   morph-spec validate-css [path]
- *   morph-spec validate-css src/MyApp.Web
- *   morph-spec validate-css --verbose
- *   morph-spec validate-css --generate-stub
- */
-
-import chalk from 'chalk';
-import { existsSync, writeFileSync } from 'fs';
-import { resolve, join } from 'path';
-import {
-  validateCssClasses,
-  formatValidationResults,
-  generateCssStub
-} from '../lib/css-validator.js';
-
-/**
- * Execute the validate-css command
- * @param {string} path - Project path to validate
- * @param {Object} options - Command options
- */
-export async function validateCssCommand(path, options = {}) {
-  const projectPath = resolve(path || '.');
-  const { verbose, generateStub, includeUtilities } = options;
-
-  // Validate path exists
-  if (!existsSync(projectPath)) {
-    console.error(chalk.red(`\n Error: Path does not exist: ${projectPath}\n`));
-    process.exit(1);
-  }
-
-  console.log(chalk.cyan('\n Validating CSS classes...\n'));
-  console.log(chalk.gray(`  Path: ${projectPath}`));
-  console.log('');
-
-  try {
-    // Run validation
-    const results = await validateCssClasses(projectPath, {
-      verbose,
-      includeUtilities
-    });
-
-    // Output results
-    const formatted = formatValidationResults(results, verbose);
-    console.log(formatted);
-
-    // Generate stub if requested
-    if (generateStub && !results.valid) {
-      const stubContent = generateCssStub(results);
-      const stubPath = join(projectPath, 'missing-classes.css');
-
-      writeFileSync(stubPath, stubContent, 'utf8');
-      console.log(chalk.green(`\n Generated stub file: ${stubPath}\n`));
-    }
-
-    // Summary with colors
-    if (results.valid) {
-      console.log(chalk.green('\n All CSS classes are properly defined!\n'));
-      process.exit(0);
-    } else {
-      console.log(chalk.yellow(`\n Found ${results.missingClasses.length} missing CSS class(es)\n`));
-
-      // Suggestions
-      console.log(chalk.cyan('Suggestions:'));
-      console.log(chalk.gray('  1. Add the missing classes to your design-system.css'));
-      console.log(chalk.gray('  2. Run with --generate-stub to create a template file'));
-      console.log(chalk.gray('  3. If using utility frameworks (Tailwind), add --include-utilities\n'));
-
-      process.exit(1);
-    }
-  } catch (error) {
-    console.error(chalk.red(`\n Error: ${error.message}\n`));
-    if (verbose) {
-      console.error(error.stack);
-    }
-    process.exit(1);
-  }
-}
+/**
+ * MORPH-SPEC validate-css Command
+ *
+ * Validates that all CSS classes used in Razor files are defined in CSS files.
+ * Helps catch missing CSS definitions before runtime.
+ *
+ * Usage:
+ *   morph-spec validate-css [path]
+ *   morph-spec validate-css src/MyApp.Web
+ *   morph-spec validate-css --verbose
+ *   morph-spec validate-css --generate-stub
+ */
+
+import chalk from 'chalk';
+import { existsSync, writeFileSync } from 'fs';
+import { resolve, join } from 'path';
+import {
+  validateCssClasses,
+  formatValidationResults,
+  generateCssStub
+} from '../../lib/validators/css/css-validator.js';
+
+/**
+ * Execute the validate-css command
+ * @param {string} path - Project path to validate
+ * @param {Object} options - Command options
+ */
+export async function validateCssCommand(path, options = {}) {
+  const projectPath = resolve(path || '.');
+  const { verbose, generateStub, includeUtilities } = options;
+
+  // Validate path exists
+  if (!existsSync(projectPath)) {
+    console.error(chalk.red(`\n Error: Path does not exist: ${projectPath}\n`));
+    process.exit(1);
+  }
+
+  console.log(chalk.cyan('\n Validating CSS classes...\n'));
+  console.log(chalk.gray(`  Path: ${projectPath}`));
+  console.log('');
+
+  try {
+    // Run validation
+    const results = await validateCssClasses(projectPath, {
+      verbose,
+      includeUtilities
+    });
+
+    // Output results
+    const formatted = formatValidationResults(results, verbose);
+    console.log(formatted);
+
+    // Generate stub if requested
+    if (generateStub && !results.valid) {
+      const stubContent = generateCssStub(results);
+      const stubPath = join(projectPath, 'missing-classes.css');
+
+      writeFileSync(stubPath, stubContent, 'utf8');
+      console.log(chalk.green(`\n Generated stub file: ${stubPath}\n`));
+    }
+
+    // Summary with colors
+    if (results.valid) {
+      console.log(chalk.green('\n All CSS classes are properly defined!\n'));
+      process.exit(0);
+    } else {
+      console.log(chalk.yellow(`\n Found ${results.missingClasses.length} missing CSS class(es)\n`));
+
+      // Suggestions
+      console.log(chalk.cyan('Suggestions:'));
+      console.log(chalk.gray('  1. Add the missing classes to your design-system.css'));
+      console.log(chalk.gray('  2. Run with --generate-stub to create a template file'));
+      console.log(chalk.gray('  3. If using utility frameworks (Tailwind), add --include-utilities\n'));
+
+      process.exit(1);
+    }
+  } catch (error) {
+    console.error(chalk.red(`\n Error: ${error.message}\n`));
+    if (verbose) {
+      console.error(error.stack);
+    }
+    process.exit(1);
+  }
+}

package/src/core/index.js

@@ -0,0 +1,10 @@
+/**
+ * Core Framework Logic
+ *
+ * Central hub for state management, templates, and workflows.
+ * Separated from shared libraries (lib/) for clear architectural boundaries.
+ */
+
+export * from './state/index.js';
+export * from './templates/index.js';
+export * from './workflows/index.js';

package/src/{orchestrator.js → core/orchestrator.js}

@@ -4,18 +4,18 @@
  */
 
 import chalk from 'chalk';
-import { ProjectScanner } from './scanner/project-scanner.js';
-import { ContextSanitizer } from './sanitizer/context-sanitizer.js';
-import { LLMAnalyzer } from './llm/analyzer.js';
-import { ConfigGenerator } from './generator/config-generator.js';
-import { UserReview } from './ui/user-review.js';
-import { InteractiveWizard } from './ui/interactive-wizard.js';
-import { FileWriter } from './writer/file-writer.js';
+import { ProjectScanner } from '../scanner/project-scanner.js';
+import { ContextSanitizer } from '../sanitizer/context-sanitizer.js';
+import { LLMAnalyzer } from '../llm/analyzer.js';
+import { ConfigGenerator } from '../generator/config-generator.js';
+import { UserReview } from '../ui/user-review.js';
+import { InteractiveWizard } from '../ui/interactive-wizard.js';
+import { FileWriter } from '../writer/file-writer.js';
 import { readFile, access } from 'fs/promises';
 import { join } from 'path';
 
 /**
- * @typedef {import('./types/index.js').GeneratedConfigs} GeneratedConfigs
+ * @typedef {import('../types/index.js').GeneratedConfigs} GeneratedConfigs
  */
 
 /**