# /lib/MyApp/Plugin/Icons.pm

package MyApp::Plugin::Icons;
use Mojo::Base 'Mojolicious::Plugin';

# Centralized Icon Management Plugin
# Provides a helper to render standardized icons (currently emojis) across the application.
# Future-proofs the codebase for potential migration to SVG or FontAwesome.

sub register {
    my ($self, $app) = @_;

    # Map of semantic names to their display symbols
    my %icons = (
        # Actions
        'edit'      => '✎',
        'delete'    => '🗑️',
        'add'       => '➕',
        'save'      => '💾',
        'cancel'    => '❌',
        'view'      => '👁️',
        'copy'      => '📋',
        'check'     => '✅',
        'close'     => '×',
        'upload'    => '📤',
        'download'  => '📥',
        'settings'  => '⚙️',
        'bonus'     => '🎁',
        
        # Navigation / UI
        'home'      => '🏠',
        'menu'      => '☰',
        'user'      => '👤',
        'logout'    => '🚪',
        'search'    => '🔍',
        'back'      => '←',
        'clock'     => '🕒',
        'calendar'  => '📅',
        'link'      => '🔗',
        'kangaroo'  => '🦘',
        'uno'       => '🃏',
        'chess'     => '♟️',
        'chelsea'   => '🏖️',
        
        # Permissions
        'perm_admin'  => '🛡️',
        'perm_family' => '🏠',
        'perm_user'   => '👤',
        'perm_guest'  => '🌍',
        
        # Modules
        'shopping'  => '🛒',
        'todo'      => '✅',
        'timers'    => '⏱️',
        'birthdays' => '🎂',
        'swear'     => '🤬',
        'imposter'  => '🎭',
        'uno'       => '🃏',
        'connect4'  => '🔴',
        'chess'     => '♟️',
        'files'     => '📁',
        
        # Status
        'warning'   => '⚠️',
        'info'      => 'ℹ️',
        'success'   => '✅',
        'error'     => '❌',
        'running'   => '▶️',
        'paused'    => '⏸️',
        'idle'      => '⏺️',
    );

    # Helper: icon('name')
    # Returns the icon string for a given semantic name.
    # Returns the name itself if not found (fallback).
    $app->helper(icon => sub {
        my ($c, $name) = @_;
        return $icons{lc($name)} // $name;
    });
}

1;