@schandlergarcia/sf-web-components 1.9.43 → 1.9.44

package/scripts/verify-consistency.sh

@@ -0,0 +1,238 @@
+#!/bin/bash
+
+# Verification script to ensure consistency between:
+# 1. .a4drules documentation
+# 2. Component implementations
+# 3. Template imports
+# 4. Barrel exports
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+
+echo "🔍 Verifying sf-web-components consistency..."
+echo ""
+
+ERRORS=0
+
+# Color codes
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+NC='\033[0m' # No Color
+
+# Check 1: UIButton and UIInput must exist as .tsx files
+echo "📦 Checking UI component files..."
+if [ -f "$ROOT/src/components/library/ui/UIButton.tsx" ]; then
+  echo -e "  ${GREEN}✓${NC} UIButton.tsx exists"
+else
+  echo -e "  ${RED}✗${NC} UIButton.tsx missing (required by documentation)"
+  ERRORS=$((ERRORS + 1))
+fi
+
+if [ -f "$ROOT/src/components/library/ui/UIInput.tsx" ]; then
+  echo -e "  ${GREEN}✓${NC} UIInput.tsx exists"
+else
+  echo -e "  ${RED}✗${NC} UIInput.tsx missing (required by documentation)"
+  ERRORS=$((ERRORS + 1))
+fi
+
+# Check 2: Button.jsx and Input.jsx should NOT exist in ui/
+if [ -f "$ROOT/src/components/library/ui/Button.jsx" ] || [ -f "$ROOT/src/components/library/ui/Button.tsx" ]; then
+  echo -e "  ${RED}✗${NC} Button.jsx/tsx exists in ui/ (should be UIButton.tsx)"
+  ERRORS=$((ERRORS + 1))
+fi
+
+if [ -f "$ROOT/src/components/library/ui/Input.jsx" ] || [ -f "$ROOT/src/components/library/ui/Input.tsx" ]; then
+  echo -e "  ${RED}✗${NC} Input.jsx/tsx exists in ui/ (should be UIInput.tsx)"
+  ERRORS=$((ERRORS + 1))
+fi
+
+echo ""
+
+# Check 3: Barrel export consistency
+echo "📚 Checking barrel export (index.jsx)..."
+if grep -q 'from "./ui/UIButton"' "$ROOT/src/components/library/index.jsx"; then
+  echo -e "  ${GREEN}✓${NC} UIButton exported correctly"
+else
+  echo -e "  ${RED}✗${NC} UIButton export incorrect or missing"
+  ERRORS=$((ERRORS + 1))
+fi
+
+if grep -q 'from "./ui/UIInput"' "$ROOT/src/components/library/index.jsx"; then
+  echo -e "  ${GREEN}✓${NC} UIInput exported correctly"
+else
+  echo -e "  ${RED}✗${NC} UIInput export incorrect or missing"
+  ERRORS=$((ERRORS + 1))
+fi
+
+# Check for wrong paths
+if grep -q 'from "./ui/Button"' "$ROOT/src/components/library/index.jsx"; then
+  echo -e "  ${RED}✗${NC} Incorrect export path: ./ui/Button (should be ./ui/UIButton)"
+  ERRORS=$((ERRORS + 1))
+fi
+
+if grep -q 'from "./ui/Input"' "$ROOT/src/components/library/index.jsx"; then
+  echo -e "  ${RED}✗${NC} Incorrect export path: ./ui/Input (should be ./ui/UIInput)"
+  ERRORS=$((ERRORS + 1))
+fi
+
+echo ""
+
+# Check 4: Template imports
+echo "📄 Checking template imports..."
+TEMPLATE_ERRORS=0
+
+# Check NotFound.tsx.template
+if [ -f "$ROOT/src/templates/pages/NotFound.tsx.template" ]; then
+  if grep -q "from '@/components/library/ui/UIButton'" "$ROOT/src/templates/pages/NotFound.tsx.template"; then
+    echo -e "  ${GREEN}✓${NC} NotFound.tsx.template imports UIButton correctly"
+  else
+    echo -e "  ${RED}✗${NC} NotFound.tsx.template does not import UIButton correctly"
+    TEMPLATE_ERRORS=$((TEMPLATE_ERRORS + 1))
+  fi
+fi
+
+# Check Home.tsx.template
+if [ -f "$ROOT/src/templates/pages/Home.tsx.template" ]; then
+  if grep -q "from '@/components/library/ui/UIInput'" "$ROOT/src/templates/pages/Home.tsx.template"; then
+    echo -e "  ${GREEN}✓${NC} Home.tsx.template imports UIInput correctly"
+  else
+    echo -e "  ${RED}✗${NC} Home.tsx.template does not import UIInput correctly"
+    TEMPLATE_ERRORS=$((TEMPLATE_ERRORS + 1))
+  fi
+
+  if grep -q "from '@/components/library/ui/UIButton'" "$ROOT/src/templates/pages/Home.tsx.template"; then
+    echo -e "  ${GREEN}✓${NC} Home.tsx.template imports UIButton correctly"
+  else
+    echo -e "  ${RED}✗${NC} Home.tsx.template does not import UIButton correctly"
+    TEMPLATE_ERRORS=$((TEMPLATE_ERRORS + 1))
+  fi
+fi
+
+# Check Search.tsx.template
+if [ -f "$ROOT/src/templates/pages/Search.tsx.template" ]; then
+  if grep -q "from '@/components/library/ui/UIInput'" "$ROOT/src/templates/pages/Search.tsx.template"; then
+    echo -e "  ${GREEN}✓${NC} Search.tsx.template imports UIInput correctly"
+  else
+    echo -e "  ${YELLOW}⚠${NC} Search.tsx.template does not import UIInput (may not need it)"
+  fi
+fi
+
+# Check for wrong imports in templates
+WRONG_IMPORTS=$(grep -r "from '@/components/library/ui/Button'" "$ROOT/src/templates/" 2>/dev/null || true)
+if [ -n "$WRONG_IMPORTS" ]; then
+  echo -e "  ${RED}✗${NC} Templates importing Button instead of UIButton:"
+  echo "$WRONG_IMPORTS" | sed 's/^/    /'
+  TEMPLATE_ERRORS=$((TEMPLATE_ERRORS + 1))
+fi
+
+WRONG_IMPORTS=$(grep -r "from '@/components/library/ui/Input'" "$ROOT/src/templates/" 2>/dev/null || true)
+if [ -n "$WRONG_IMPORTS" ]; then
+  echo -e "  ${RED}✗${NC} Templates importing Input instead of UIInput:"
+  echo "$WRONG_IMPORTS" | sed 's/^/    /'
+  TEMPLATE_ERRORS=$((TEMPLATE_ERRORS + 1))
+fi
+
+ERRORS=$((ERRORS + TEMPLATE_ERRORS))
+
+echo ""
+
+# Check 5: Internal library imports
+echo "🔗 Checking internal library imports..."
+INTERNAL_ERRORS=0
+
+# Check cards/ for wrong imports
+WRONG_CARDS=$(grep -r 'from "../ui/Button"' "$ROOT/src/components/library/cards/" 2>/dev/null || true)
+if [ -n "$WRONG_CARDS" ]; then
+  echo -e "  ${RED}✗${NC} Card components importing Button instead of UIButton:"
+  echo "$WRONG_CARDS" | sed 's/^/    /'
+  INTERNAL_ERRORS=$((INTERNAL_ERRORS + 1))
+fi
+
+WRONG_CARDS=$(grep -r 'from "../ui/Input"' "$ROOT/src/components/library/cards/" 2>/dev/null || true)
+if [ -n "$WRONG_CARDS" ]; then
+  echo -e "  ${RED}✗${NC} Card components importing Input instead of UIInput:"
+  echo "$WRONG_CARDS" | sed 's/^/    /'
+  INTERNAL_ERRORS=$((INTERNAL_ERRORS + 1))
+fi
+
+# Check if UIButton/UIInput are imported correctly
+CORRECT_IMPORTS=$(grep -r 'from "../ui/UIButton"' "$ROOT/src/components/library/cards/" 2>/dev/null | wc -l)
+if [ "$CORRECT_IMPORTS" -gt 0 ]; then
+  echo -e "  ${GREEN}✓${NC} Found $CORRECT_IMPORTS correct UIButton imports in cards/"
+fi
+
+CORRECT_IMPORTS=$(grep -r 'from "../ui/UIInput"' "$ROOT/src/components/library/cards/" 2>/dev/null | wc -l)
+if [ "$CORRECT_IMPORTS" -gt 0 ]; then
+  echo -e "  ${GREEN}✓${NC} Found $CORRECT_IMPORTS correct UIInput imports in cards/"
+fi
+
+ERRORS=$((ERRORS + INTERNAL_ERRORS))
+
+echo ""
+
+# Check 6: Documentation exists
+echo "📖 Checking documentation..."
+if [ -f "$ROOT/.a4drules/skills/component-library/ui-primitives.md" ]; then
+  # Check if UIButton is documented
+  if grep -q "UIButton" "$ROOT/.a4drules/skills/component-library/ui-primitives.md"; then
+    echo -e "  ${GREEN}✓${NC} UIButton documented in ui-primitives.md"
+  else
+    echo -e "  ${RED}✗${NC} UIButton not found in ui-primitives.md"
+    ERRORS=$((ERRORS + 1))
+  fi
+
+  # Check if UIInput is documented
+  if grep -q "UIInput" "$ROOT/.a4drules/skills/component-library/ui-primitives.md"; then
+    echo -e "  ${GREEN}✓${NC} UIInput documented in ui-primitives.md"
+  else
+    echo -e "  ${RED}✗${NC} UIInput not found in ui-primitives.md"
+    ERRORS=$((ERRORS + 1))
+  fi
+else
+  echo -e "  ${RED}✗${NC} Documentation file missing: .a4drules/skills/component-library/ui-primitives.md"
+  ERRORS=$((ERRORS + 1))
+fi
+
+echo ""
+
+# Check 7: Package.json files array includes necessary directories
+echo "📦 Checking package.json files array..."
+if grep -q '"src/templates"' "$ROOT/package.json"; then
+  echo -e "  ${GREEN}✓${NC} src/templates included in package.json files"
+else
+  echo -e "  ${RED}✗${NC} src/templates missing from package.json files array"
+  ERRORS=$((ERRORS + 1))
+fi
+
+if grep -q '"src/components"' "$ROOT/package.json"; then
+  echo -e "  ${GREEN}✓${NC} src/components included in package.json files"
+else
+  echo -e "  ${RED}✗${NC} src/components missing from package.json files array"
+  ERRORS=$((ERRORS + 1))
+fi
+
+if grep -q '".a4drules"' "$ROOT/package.json"; then
+  echo -e "  ${GREEN}✓${NC} .a4drules included in package.json files"
+else
+  echo -e "  ${RED}✗${NC} .a4drules missing from package.json files array"
+  ERRORS=$((ERRORS + 1))
+fi
+
+echo ""
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+
+if [ $ERRORS -eq 0 ]; then
+  echo -e "${GREEN}✅ All consistency checks passed!${NC}"
+  echo ""
+  echo "Safe to publish."
+  exit 0
+else
+  echo -e "${RED}❌ Found $ERRORS error(s)${NC}"
+  echo ""
+  echo "Fix these errors before publishing."
+  echo "See CONTRIBUTING.md for guidance."
+  exit 1
+fi