@polymorphism-tech/morph-spec 4.12.0 → 4.13.0

package/src/lib/validators/blazor/blazor-state-validator.js

@@ -1,279 +0,0 @@
-/**
- * Blazor State Validator
- *
- * Validates SessionState patterns in Blazor Server applications.
- * Ensures proper Persist + Reload pattern implementation.
- *
- * @module blazor-state-validator
- */
-
-import { countIssues } from '../shared/index.js';
-
-/**
- * @typedef {Object} StateIssue
- * @property {'error' | 'warning' | 'info'} type
- * @property {string} message
- * @property {string} [suggestion]
- * @property {string} file
- * @property {number} [line]
- * @property {string} [code]
- */
-
-// SessionState class patterns
-const SESSION_STATE_CLASS_PATTERNS = [
-  /class\s+SessionState/,
-  /public\s+class\s+\w*Session\w*State/,
-  /public\s+class\s+\w*State\w*Session/,
-];
-
-// LoadFrom method pattern
-const LOAD_FROM_PATTERN = /void\s+LoadFrom|LoadFrom\s*\(/;
-
-// IsLoaded property pattern
-const IS_LOADED_PATTERN = /bool\s+IsLoaded|IsLoaded\s*\{/;
-
-// Session middleware patterns
-const SESSION_MIDDLEWARE_PATTERNS = [
-  /SessionMiddleware/,
-  /UseSessionTracking/,
-  /X-Session-Id/,
-  /SessionId/,
-];
-
-// OnInitializedAsync with session reload pattern
-const ON_INITIALIZED_RELOAD_PATTERN = /OnInitializedAsync.*Session.*LoadFrom|Session\.IsLoaded/s;
-
-/**
- * Validates SessionState class implementation.
- *
- * @param {string} content - File content
- * @param {string} filePath - Path to the file
- * @returns {StateIssue[]}
- */
-export function validateSessionStateClass(content, filePath) {
-  const issues = [];
-
-  // Check if this is a SessionState class
-  const isSessionStateClass = SESSION_STATE_CLASS_PATTERNS.some((pattern) =>
-    pattern.test(content)
-  );
-
-  if (!isSessionStateClass) {
-    return issues;
-  }
-
-  // Check for LoadFrom method
-  if (!LOAD_FROM_PATTERN.test(content)) {
-    issues.push({
-      type: 'error',
-      message: 'SessionState sem metodo LoadFrom()',
-      suggestion:
-        'Adicione um metodo LoadFrom(entity) para carregar estado do banco. Ver framework/standards/frontend/blazor/state.md',
-      file: filePath,
-    });
-  }
-
-  // Check for IsLoaded property
-  if (!IS_LOADED_PATTERN.test(content)) {
-    issues.push({
-      type: 'warning',
-      message: 'SessionState sem propriedade IsLoaded',
-      suggestion:
-        'Adicione propriedade IsLoaded para evitar reloads desnecessarios',
-      file: filePath,
-    });
-  }
-
-  // Check for ToEntity method
-  if (!content.includes('ToEntity')) {
-    issues.push({
-      type: 'info',
-      message: 'SessionState sem metodo ToEntity()',
-      suggestion:
-        'Considere adicionar ToEntity() para facilitar persistencia',
-      file: filePath,
-    });
-  }
-
-  return issues;
-}
-
-/**
- * Validates Program.cs for session middleware setup.
- *
- * @param {string} content - File content
- * @param {string} filePath - Path to the file
- * @returns {StateIssue[]}
- */
-export function validateProgramCsSetup(content, filePath) {
-  const issues = [];
-
-  // Only check Program.cs
-  if (!filePath.toLowerCase().includes('program.cs')) {
-    return issues;
-  }
-
-  // Check if project uses SessionState
-  if (!content.includes('SessionState') && !content.includes('ISessionRepository')) {
-    return issues; // Project doesn't seem to use session state
-  }
-
-  // Check for session middleware
-  const hasSessionMiddleware = SESSION_MIDDLEWARE_PATTERNS.some((pattern) =>
-    pattern.test(content)
-  );
-
-  if (!hasSessionMiddleware) {
-    issues.push({
-      type: 'warning',
-      message: 'SessionMiddleware nao encontrado em Program.cs',
-      suggestion:
-        'Adicione app.UseSessionTracking() antes de UseRouting(). Ver framework/standards/frontend/blazor/state.md',
-      file: filePath,
-    });
-  }
-
-  // Check for IHttpContextAccessor
-  if (!content.includes('AddHttpContextAccessor')) {
-    issues.push({
-      type: 'warning',
-      message: 'IHttpContextAccessor nao registrado',
-      suggestion:
-        'Adicione builder.Services.AddHttpContextAccessor() para acessar SessionId em componentes',
-      file: filePath,
-    });
-  }
-
-  return issues;
-}
-
-/**
- * Validates Blazor pages for session reload pattern.
- *
- * @param {string} content - File content
- * @param {string} filePath - Path to the file
- * @returns {StateIssue[]}
- */
-export function validatePageSessionReload(content, filePath) {
-  const issues = [];
-
-  // Only check .razor files
-  if (!filePath.endsWith('.razor')) {
-    return issues;
-  }
-
-  // Check if page uses SessionState
-  const usesSessionState =
-    content.includes('SessionState') ||
-    content.includes('@inject SessionState') ||
-    content.includes('[Inject] SessionState');
-
-  if (!usesSessionState) {
-    return issues;
-  }
-
-  // Check for OnInitializedAsync
-  if (!content.includes('OnInitializedAsync')) {
-    issues.push({
-      type: 'warning',
-      message: 'Pagina usa SessionState mas nao tem OnInitializedAsync',
-      suggestion:
-        'Adicione OnInitializedAsync para verificar e recarregar SessionState',
-      file: filePath,
-    });
-    return issues;
-  }
-
-  // Check for IsLoaded check or LoadFrom in OnInitializedAsync
-  if (!content.includes('IsLoaded') && !content.includes('LoadFrom')) {
-    issues.push({
-      type: 'warning',
-      message: 'Pagina usa SessionState sem verificar IsLoaded',
-      suggestion:
-        'Verifique Session.IsLoaded e chame LoadFrom() em OnInitializedAsync se necessario',
-      file: filePath,
-    });
-  }
-
-  return issues;
-}
-
-/**
- * Validates session repository implementation.
- *
- * @param {string} content - File content
- * @param {string} filePath - Path to the file
- * @returns {StateIssue[]}
- */
-export function validateSessionRepository(content, filePath) {
-  const issues = [];
-
-  // Check if this is a session repository
-  const isSessionRepo =
-    content.includes('ISessionRepository') ||
-    content.includes('SessionRepository') ||
-    content.includes('GetBySessionIdAsync');
-
-  if (!isSessionRepo) {
-    return issues;
-  }
-
-  // Check for essential methods
-  if (!content.includes('GetBySessionIdAsync')) {
-    issues.push({
-      type: 'error',
-      message: 'SessionRepository sem GetBySessionIdAsync',
-      suggestion: 'Adicione metodo para buscar sessao por ID',
-      file: filePath,
-    });
-  }
-
-  if (!content.includes('SaveAsync') && !content.includes('UpsertAsync')) {
-    issues.push({
-      type: 'warning',
-      message: 'SessionRepository sem metodo de persistencia (SaveAsync/UpsertAsync)',
-      suggestion: 'Adicione metodo para salvar estado da sessao',
-      file: filePath,
-    });
-  }
-
-  // Check for cleanup method
-  if (!content.includes('CleanupExpiredAsync') && !content.includes('DeleteExpired')) {
-    issues.push({
-      type: 'info',
-      message: 'SessionRepository sem metodo de limpeza de sessoes expiradas',
-      suggestion:
-        'Considere adicionar CleanupExpiredAsync() para remover sessoes antigas',
-      file: filePath,
-    });
-  }
-
-  return issues;
-}
-
-/**
- * Runs all state validations on a file.
- *
- * @param {string} content - File content
- * @param {string} filePath - Path to the file
- * @returns {StateIssue[]}
- */
-export function validateBlazorState(content, filePath) {
-  const issues = [];
-
-  issues.push(...validateSessionStateClass(content, filePath));
-  issues.push(...validateProgramCsSetup(content, filePath));
-  issues.push(...validatePageSessionReload(content, filePath));
-  issues.push(...validateSessionRepository(content, filePath));
-
-  return issues;
-}
-
-export default {
-  validateBlazorState,
-  validateSessionStateClass,
-  validateProgramCsSetup,
-  validatePageSessionReload,
-  validateSessionRepository,
-  countIssues,
-};

package/src/lib/validators/blazor/blazor-validator.js

@@ -1,369 +0,0 @@
-/**
- * Blazor Validator - Fluent UI Blazor Pattern Validation
- *
- * Validates Blazor/Razor files for common Fluent UI patterns and issues.
- *
- * @module blazor-validator
- */
-
-import { countIssues } from '../shared/index.js';
-
-// Valid icon sizes in Fluent UI Blazor
-export const VALID_ICON_SIZES = [20, 24, 28, 32, 48];
-
-// Icons that don't exist and their alternatives
-export const ICON_ALTERNATIVES = {
-  Compass: 'CompassNorthwest',
-  Instagram: 'Camera',
-  WhatsApp: 'Chat',
-  Facebook: 'Share',
-  Twitter: 'Share',
-  X: 'Share',
-  LinkedIn: 'Person',
-};
-
-// Async methods that don't exist in IToastService
-export const INVALID_TOAST_METHODS = [
-  'ShowSuccessAsync',
-  'ShowErrorAsync',
-  'ShowWarningAsync',
-  'ShowInfoAsync',
-];
-
-// Async methods that don't exist in FluentDialog
-export const INVALID_DIALOG_METHODS = ['ShowAsync', 'HideAsync'];
-
-/**
- * @typedef {Object} ValidationIssue
- * @property {'error' | 'warning'} type - Severity of the issue
- * @property {string} message - Description of the issue
- * @property {string} [suggestion] - How to fix the issue
- * @property {string} file - File path
- * @property {number} [line] - Line number (1-indexed)
- * @property {string} [code] - The problematic code snippet
- */
-
-/**
- * Validates icon usage in Fluent UI Blazor files.
- * Detects invalid sizes and non-existent icons.
- *
- * @param {string} content - File content
- * @param {string} filePath - Path to the file
- * @returns {ValidationIssue[]} Array of validation issues
- */
-export function validateIconUsage(content, filePath) {
-  const issues = [];
-  const lines = content.split('\n');
-
-  // Pattern: Icons.(Regular|Filled).Size{N}.{IconName}()
-  const iconRegex = /Icons\.(Regular|Filled)\.Size(\d+)\.(\w+)\(\)/g;
-
-  lines.forEach((line, index) => {
-    const lineNumber = index + 1;
-    let match;
-
-    // Reset regex lastIndex for each line
-    iconRegex.lastIndex = 0;
-
-    while ((match = iconRegex.exec(line)) !== null) {
-      const [fullMatch, type, sizeStr, iconName] = match;
-      const size = parseInt(sizeStr, 10);
-
-      // Check for invalid size
-      if (!VALID_ICON_SIZES.includes(size)) {
-        issues.push({
-          type: 'error',
-          message: `Icons.${type}.Size${size} - Size${size} nao e valido`,
-          suggestion: `Use Size20, Size24, Size28, Size32 ou Size48`,
-          file: filePath,
-          line: lineNumber,
-          code: fullMatch,
-        });
-      }
-
-      // Check for non-existent icons
-      if (ICON_ALTERNATIVES[iconName]) {
-        issues.push({
-          type: 'error',
-          message: `Icons.${type}.Size${size}.${iconName} - Icone nao existe`,
-          suggestion: `Use ${ICON_ALTERNATIVES[iconName]} como alternativa`,
-          file: filePath,
-          line: lineNumber,
-          code: fullMatch,
-        });
-      }
-    }
-  });
-
-  return issues;
-}
-
-/**
- * Validates FluentDialog patterns.
- * Detects missing Hidden="true" and invalid async methods.
- *
- * @param {string} content - File content
- * @param {string} filePath - Path to the file
- * @returns {ValidationIssue[]} Array of validation issues
- */
-export function validateDialogPatterns(content, filePath) {
-  const issues = [];
-  const lines = content.split('\n');
-
-  lines.forEach((line, index) => {
-    const lineNumber = index + 1;
-
-    // Check for FluentDialog without Hidden="true"
-    // Match <FluentDialog that has @ref but no Hidden="true"
-    if (line.includes('<FluentDialog') && !line.includes('Hidden=')) {
-      // Check if it's a self-closing tag or opening tag
-      if (line.includes('@ref=') || line.includes('Modal=')) {
-        issues.push({
-          type: 'warning',
-          message: `FluentDialog sem Hidden="true" - modal sera visivel ao carregar`,
-          suggestion: `Adicione Hidden="true" ao FluentDialog`,
-          file: filePath,
-          line: lineNumber,
-          code: line.trim(),
-        });
-      }
-    }
-
-    // Check for invalid async methods
-    INVALID_DIALOG_METHODS.forEach((method) => {
-      if (line.includes(`_dialog.${method}`) || line.includes(`.${method}(`)) {
-        if (line.includes('dialog') || line.includes('Dialog')) {
-          issues.push({
-            type: 'error',
-            message: `FluentDialog.${method}() nao existe`,
-            suggestion:
-              method === 'ShowAsync'
-                ? `Use Show() (sincrono)`
-                : `Use CloseAsync() em vez de HideAsync()`,
-            file: filePath,
-            line: lineNumber,
-            code: line.trim(),
-          });
-        }
-      }
-    });
-  });
-
-  return issues;
-}
-
-/**
- * Validates Toast Service usage.
- * Detects non-existent async methods.
- *
- * @param {string} content - File content
- * @param {string} filePath - Path to the file
- * @returns {ValidationIssue[]} Array of validation issues
- */
-export function validateToastUsage(content, filePath) {
-  const issues = [];
-  const lines = content.split('\n');
-
-  lines.forEach((line, index) => {
-    const lineNumber = index + 1;
-
-    INVALID_TOAST_METHODS.forEach((method) => {
-      if (line.includes(method)) {
-        const syncMethod = method.replace('Async', '');
-        issues.push({
-          type: 'error',
-          message: `ToastService.${method}() nao existe`,
-          suggestion: `Use ToastService.${syncMethod}() (sincrono)`,
-          file: filePath,
-          line: lineNumber,
-          code: line.trim(),
-        });
-      }
-    });
-  });
-
-  return issues;
-}
-
-/**
- * Validates Icon namespace usage.
- * Detects missing alias requirement.
- *
- * @param {string} content - File content
- * @param {string} filePath - Path to the file
- * @returns {ValidationIssue[]} Array of validation issues
- */
-export function validateNamespaceAlias(content, filePath) {
-  const issues = [];
-  const lines = content.split('\n');
-
-  // Check if using icons without alias
-  const usesIcons =
-    content.includes('Icons.Regular') || content.includes('Icons.Filled');
-
-  if (usesIcons) {
-    // Check for proper alias
-    const hasCorrectAlias = content.includes(
-      '@using Icons = Microsoft.FluentUI.AspNetCore.Components.Icons'
-    );
-
-    // Check for incorrect using (without alias)
-    const hasIncorrectUsing =
-      content.includes('@using Microsoft.FluentUI.AspNetCore.Components.Icons') &&
-      !hasCorrectAlias;
-
-    if (hasIncorrectUsing) {
-      // Find the line with the incorrect using
-      lines.forEach((line, index) => {
-        if (
-          line.includes('@using Microsoft.FluentUI.AspNetCore.Components.Icons') &&
-          !line.includes('Icons =')
-        ) {
-          issues.push({
-            type: 'error',
-            message: `Namespace de Icons sem alias`,
-            suggestion: `Use @using Icons = Microsoft.FluentUI.AspNetCore.Components.Icons`,
-            file: filePath,
-            line: index + 1,
-            code: line.trim(),
-          });
-        }
-      });
-    }
-
-    // Check if uses icons but has no using at all (might be in _Imports.razor)
-    if (
-      !hasCorrectAlias &&
-      !hasIncorrectUsing &&
-      !content.includes('@using Icons =')
-    ) {
-      // This is just informational - might be defined in _Imports.razor
-      // Don't flag as error, but could be a warning
-    }
-  }
-
-  return issues;
-}
-
-/**
- * Validates FluentToastProvider and FluentDialogProvider presence.
- * Only checks layout files.
- *
- * @param {string} content - File content
- * @param {string} filePath - Path to the file
- * @returns {ValidationIssue[]} Array of validation issues
- */
-export function validateProviders(content, filePath) {
-  const issues = [];
-  const isLayout =
-    filePath.toLowerCase().includes('layout') ||
-    filePath.toLowerCase().includes('app.razor');
-
-  if (!isLayout) {
-    return issues;
-  }
-
-  if (
-    content.includes('FluentDialog') &&
-    !content.includes('<FluentDialogProvider')
-  ) {
-    issues.push({
-      type: 'warning',
-      message: `FluentDialogProvider nao encontrado no layout`,
-      suggestion: `Adicione <FluentDialogProvider /> ao layout`,
-      file: filePath,
-      line: 1,
-    });
-  }
-
-  if (
-    content.includes('ToastService') &&
-    !content.includes('<FluentToastProvider')
-  ) {
-    issues.push({
-      type: 'warning',
-      message: `FluentToastProvider nao encontrado no layout`,
-      suggestion: `Adicione <FluentToastProvider /> ao layout`,
-      file: filePath,
-      line: 1,
-    });
-  }
-
-  return issues;
-}
-
-/**
- * Runs all validations on a Blazor file.
- *
- * @param {string} content - File content
- * @param {string} filePath - Path to the file
- * @returns {ValidationIssue[]} Array of all validation issues
- */
-export function validateBlazorFile(content, filePath) {
-  const issues = [];
-
-  issues.push(...validateIconUsage(content, filePath));
-  issues.push(...validateDialogPatterns(content, filePath));
-  issues.push(...validateToastUsage(content, filePath));
-  issues.push(...validateNamespaceAlias(content, filePath));
-  issues.push(...validateProviders(content, filePath));
-
-  return issues;
-}
-
-/**
- * Formats validation issues for console output.
- *
- * @param {ValidationIssue[]} issues - Array of validation issues
- * @returns {string} Formatted output string
- */
-export function formatIssues(issues) {
-  if (issues.length === 0) {
-    return '';
-  }
-
-  const lines = [];
-
-  issues.forEach((issue) => {
-    const icon = issue.type === 'error' ? '\u274C' : '\u26A0\uFE0F';
-    const label = issue.type === 'error' ? 'Error' : 'Warning';
-
-    lines.push(`${icon} ${label}: ${issue.message}`);
-
-    if (issue.suggestion) {
-      lines.push(`   Sugestao: ${issue.suggestion}`);
-    }
-
-    const location = issue.line ? `${issue.file}:${issue.line}` : issue.file;
-    lines.push(`   Arquivo: ${location}`);
-
-    if (issue.code) {
-      lines.push(`   Codigo: ${issue.code}`);
-    }
-
-    lines.push('');
-  });
-
-  return lines.join('\n');
-}
-
-/**
- * Counts issues by type.
- *
- * @param {ValidationIssue[]} issues - Array of validation issues
- * @returns {{ errors: number, warnings: number }} Count by type
- */
-export default {
-  VALID_ICON_SIZES,
-  ICON_ALTERNATIVES,
-  INVALID_TOAST_METHODS,
-  INVALID_DIALOG_METHODS,
-  validateIconUsage,
-  validateDialogPatterns,
-  validateToastUsage,
-  validateNamespaceAlias,
-  validateProviders,
-  validateBlazorFile,
-  formatIssues,
-  countIssues,
-};

package/src/lib/validators/blazor/index.js

@@ -1,9 +0,0 @@
-/**
- * Blazor Validators
- *
- * Validators specific to Blazor Server and Fluent UI Blazor patterns.
- */
-
-export * from './blazor-validator.js';
-export * from './blazor-state-validator.js';
-export * from './blazor-concurrency-analyzer.js';