MokoConsulting/MokoCassiopeia
1
1
Fork 0
Code Issues 2 Pull Requests Actions Packages Releases 1 Activity

Add mobile-responsive overrides for 20 modules and 7 component views #81

Merged
Copilot merged 14 commits from copilot/make-mod-search-mobile-responsive into main 2026-02-26 15:49:03 +00:00
Conversation 2 Commits 14 Files Changed 70 +450
2 changed files with 450 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
Showing only changes of commit c8213dc6cb - Show all commits

134
scripts/README.md Normal file
View File

@@ -0,0 +1,134 @@
# MokoCassiopeia Scripts Directory
This directory contains utility scripts for maintaining and managing the MokoCassiopeia template repository.
## Available Scripts
### cleanup-naming.sh
**Purpose**: Standardizes naming convention by renaming all instances of "Moko-Cassiopeia" (hyphenated) to "MokoCassiopeia" (camelCase).
**Usage**:
```bash
# Preview changes (dry-run mode - default)
./scripts/cleanup-naming.sh --dry-run
# Execute changes with backup files
./scripts/cleanup-naming.sh --execute --backup
# Execute changes without backup
./scripts/cleanup-naming.sh --execute
# Show help
./scripts/cleanup-naming.sh --help
```
**Features**:
- 🔍 **Dry-run mode**: Preview all changes before executing
- 💾 **Backup option**: Create `.bak` files before modification
- 📊 **Statistics**: Track files scanned, modified, and replacements made
- 🎨 **Colored output**: Easy-to-read console output
- ⚠️ **Safety checks**: Validates git repository and warns about uncommitted changes
- 📝 **Comprehensive logging**: Shows exactly what will be changed
**What it changes**:
- `Moko-Cassiopeia` → `MokoCassiopeia` (display name)
- `moko-cassiopeia` → `mokocassiopeia` (identifiers, paths)
**Files affected**:
- Documentation files (`.md`)
- PHP files (`.php`)
- XML files (`.xml`)
- Language files (`.ini`)
- JavaScript files (`.js`)
- CSS files (`.css`)
- Configuration files (`.json`, `.yml`, `.yaml`)
- Text files (`.txt`)
- Shell scripts (`.sh`)
**Safety**:
- Skips `.git` directory and `node_modules`
- Skips the cleanup script itself
- Requires explicit confirmation in execute mode
- Warns about uncommitted changes
**Example Output**:
```
╔════════════════════════════════════════════════════════════════╗
║ MokoCassiopeia Naming Cleanup Script v1.0.0 ║
║ Moko-Cassiopeia → MokoCassiopeia ║
╚════════════════════════════════════════════════════════════════╝
[INFO] Scanning repository: /path/to/repo
[INFO] Would modify: CHANGELOG.md (6 occurrences)
[INFO] Would modify: docs/README.md (2 occurrences)
╔════════════════════════════════════════════════════════════════╗
║ Summary ║
╠════════════════════════════════════════════════════════════════╣
║ Files Scanned: 106 ║
║ Files Modified: 11 ║
║ Replacements: 21 ║
╚════════════════════════════════════════════════════════════════╝
```
---
### create-client-fork.sh
**Purpose**: Automates the creation of client-specific forks of the MokoCassiopeia template.
**Usage**:
See [CLIENT_FORK_WORKFLOW.md](../docs/CLIENT_FORK_WORKFLOW.md) for detailed documentation.
```bash
./scripts/create-client-fork.sh
```
**Features**:
- Sets up custom color schemes
- Prepares client-specific documentation
- Removes template files
- Configures fork for client use
---
## Script Development Guidelines
When creating new scripts for this repository:
1. **Shebang**: Start with `#!/bin/bash`
2. **Documentation**: Include comprehensive header comments
3. **Options**: Support `--help` flag
4. **Safety**: Include dry-run mode for destructive operations
5. **Feedback**: Provide clear, colored output
6. **Error Handling**: Use `set -e` and proper error messages
7. **Git Awareness**: Check for git repository and uncommitted changes
8. **Portability**: Test on both Linux and macOS
## Testing Scripts
Before committing a new script:
1. Test in dry-run mode
2. Test with actual execution
3. Verify error handling
4. Check help output
5. Test on sample files
6. Document in this README
## Contributing
If you create a new script:
1. Add it to this directory
2. Make it executable: `chmod +x scripts/your-script.sh`
3. Document it in this README
4. Update CHANGELOG.md
5. Create a PR with thorough testing notes
---
**Last Updated**: 2026-02-22
**Repository**: https://github.com/mokoconsulting-tech/MokoCassiopeia

316
scripts/cleanup-naming.sh Executable file
View File

@@ -0,0 +1,316 @@
#!/bin/bash
################################################################################
# MokoCassiopeia Naming Cleanup Script
################################################################################
#
# DESCRIPTION:
# This script renames all instances of "Moko-Cassiopeia" (hyphenated) to
# "MokoCassiopeia" (camelCase) throughout the repository to ensure consistent
# naming conventions.
#
# USAGE:
# ./scripts/cleanup-naming.sh [OPTIONS]
#
# OPTIONS:
# --dry-run Preview changes without making them (default)
# --execute Actually perform the renaming
# --backup Create backup files before modification (.bak extension)
# --help Show this help message
#
# EXAMPLES:
# # Preview changes
# ./scripts/cleanup-naming.sh --dry-run
#
# # Execute changes with backup
# ./scripts/cleanup-naming.sh --execute --backup
#
# # Execute changes without backup
# ./scripts/cleanup-naming.sh --execute
#
# AUTHOR: MokoConsulting Tech Team
# DATE: 2026-02-22
# VERSION: 1.0.0
#
################################################################################
set -e # Exit on error
# Color codes for output
RED='\033[0;31m'
GREEN='\033[0;32m'
YELLOW='\033[1;33m'
BLUE='\033[0;34m'
NC='\033[0m' # No Color
# Default options
DRY_RUN=true
CREATE_BACKUP=false
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
REPO_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
# Statistics
TOTAL_FILES_SCANNED=0
TOTAL_FILES_MODIFIED=0
TOTAL_REPLACEMENTS=0
################################################################################
# Functions
################################################################################
show_help() {
sed -n '/^# DESCRIPTION:/,/^################################################################################$/p' "$0" | sed 's/^# //; s/^#//'
exit 0
}
log_info() {
echo -e "${BLUE}[INFO]${NC} $1"
}
log_success() {
echo -e "${GREEN}[SUCCESS]${NC} $1"
}
log_warning() {
echo -e "${YELLOW}[WARNING]${NC} $1"
}
log_error() {
echo -e "${RED}[ERROR]${NC} $1"
}
print_banner() {
echo ""
echo "╔════════════════════════════════════════════════════════════════╗"
echo "║ MokoCassiopeia Naming Cleanup Script v1.0.0 ║"
echo "║ Moko-Cassiopeia → MokoCassiopeia ║"
echo "╚════════════════════════════════════════════════════════════════╝"
echo ""
}
print_summary() {
echo ""
echo "╔════════════════════════════════════════════════════════════════╗"
echo "║ Summary ║"
echo "╠════════════════════════════════════════════════════════════════╣"
printf "║ %-20s %-40s ║\n" "Files Scanned:" "$TOTAL_FILES_SCANNED"
printf "║ %-20s %-40s ║\n" "Files Modified:" "$TOTAL_FILES_MODIFIED"
printf "║ %-20s %-40s ║\n" "Replacements:" "$TOTAL_REPLACEMENTS"
echo "╚════════════════════════════════════════════════════════════════╝"
echo ""
}
# Process a single file
process_file() {
local file="$1"
local relative_path="${file#$REPO_ROOT/}"
# Skip .git directory and node_modules
if [[ "$file" == *".git/"* ]] || [[ "$file" == *"node_modules/"* ]]; then
return 0
fi
# Skip the cleanup script itself
if [[ "$file" == *"cleanup-naming.sh" ]]; then
return 0
fi
TOTAL_FILES_SCANNED=$((TOTAL_FILES_SCANNED + 1))
# Check if file contains any of our search patterns
local has_changes=false
local count=0
# Count occurrences
count=$(grep -c "Moko-Cassiopeia\|moko-cassiopeia" "$file" 2>/dev/null || true)
if [ "$count" -gt 0 ]; then
has_changes=true
TOTAL_REPLACEMENTS=$((TOTAL_REPLACEMENTS + count))
if [ "$DRY_RUN" = true ]; then
log_info "Would modify: $relative_path ($count occurrences)"
# Show the lines that would be changed
grep -n "Moko-Cassiopeia\|moko-cassiopeia" "$file" | head -5 | while read -r line; do
echo " $line"
done
if [ "$count" -gt 5 ]; then
echo " ... and $((count - 5)) more"
fi
else
log_info "Modifying: $relative_path ($count occurrences)"
# Create backup if requested
if [ "$CREATE_BACKUP" = true ]; then
cp "$file" "$file.bak"
log_info " Created backup: $file.bak"
fi
# Perform replacements
# Use sed with backup to ensure atomic operation
sed -i.tmp 's/Moko-Cassiopeia/MokoCassiopeia/g; s/moko-cassiopeia/mokocassiopeia/g' "$file"
rm -f "$file.tmp"
log_success " Modified successfully"
fi
TOTAL_FILES_MODIFIED=$((TOTAL_FILES_MODIFIED + 1))
fi
}
# Main processing function
process_files() {
log_info "Scanning repository: $REPO_ROOT"
echo ""
# File patterns to search
local patterns=(
"*.md"
"*.php"
"*.xml"
"*.ini"
"*.txt"
"*.json"
"*.yml"
"*.yaml"
"*.sh"
"*.js"
"*.css"
)
# Build find command with all patterns
local find_cmd="find \"$REPO_ROOT\" -type f \\( "
local first=true
for pattern in "${patterns[@]}"; do
if [ "$first" = true ]; then
find_cmd+="-name \"$pattern\""
first=false
else
find_cmd+=" -o -name \"$pattern\""
fi
done
find_cmd+=" \\)"
# Execute find and process each file
# Use process substitution to avoid subshell
while IFS= read -r file; do
process_file "$file"
done < <(eval "$find_cmd")
echo ""
}
################################################################################
# Main Script
################################################################################
# Parse command line arguments
while [[ $# -gt 0 ]]; do
case $1 in
--dry-run)
DRY_RUN=true
shift
;;
--execute)
DRY_RUN=false
shift
;;
--backup)
CREATE_BACKUP=true
shift
;;
--help|-h)
show_help
;;
*)
log_error "Unknown option: $1"
echo "Use --help for usage information"
exit 1
;;
esac
done
# Print banner
print_banner
# Show mode
if [ "$DRY_RUN" = true ]; then
log_warning "Running in DRY-RUN mode (no changes will be made)"
log_info "Use --execute to actually perform changes"
else
log_warning "Running in EXECUTE mode (changes will be made)"
if [ "$CREATE_BACKUP" = true ]; then
log_info "Backup files will be created (.bak extension)"
else
log_warning "No backups will be created"
fi
# Confirmation prompt
echo ""
read -p "Are you sure you want to proceed? (yes/no): " -r
echo ""
if [[ ! $REPLY =~ ^[Yy][Ee][Ss]$ ]]; then
log_warning "Operation cancelled by user"
exit 0
fi
fi
echo ""
# Change to repo root
cd "$REPO_ROOT"
# Check if git repository
if [ ! -d ".git" ]; then
log_error "Not a git repository. Please run from repository root."
exit 1
fi
# Check for uncommitted changes
if ! git diff-index --quiet HEAD -- 2>/dev/null; then
log_warning "You have uncommitted changes in your repository"
if [ "$DRY_RUN" = false ]; then
read -p "Continue anyway? (yes/no): " -r
echo ""
if [[ ! $REPLY =~ ^[Yy][Ee][Ss]$ ]]; then
log_warning "Operation cancelled by user"
exit 0
fi
fi
fi
# Process files
process_files
# Print summary
print_summary
# Final message
if [ "$DRY_RUN" = true ]; then
echo ""
log_info "This was a dry run. No files were modified."
log_info "To execute changes, run: $0 --execute"
echo ""
else
echo ""
log_success "Cleanup completed successfully!"
log_info "Total files modified: $TOTAL_FILES_MODIFIED"
log_info "Total replacements made: $TOTAL_REPLACEMENTS"
if [ "$CREATE_BACKUP" = true ]; then
echo ""
log_info "Backup files (.bak) have been created."
log_info "To remove backups, run: find . -name '*.bak' -delete"
fi
echo ""
log_warning "Don't forget to:"
echo " 1. Review the changes with: git diff"
echo " 2. Test the modified files"
echo " 3. Commit the changes: git add . && git commit -m 'Clean up naming: Moko-Cassiopeia → MokoCassiopeia'"
echo ""
fi
exit 0