new Metabox([
    'id'     => 'taw_hero',
    'title'  => 'Hero Section',
    'screens' => ['page'],
    'fields' => [
        // Layout with widths
        [
            'id' => 'heading',     
            'label' => 'Heading',     
            'type' => 'text',     
            'width' => '50', 
            'required' => true
        ],
        [
            'id' => 'subheading',  
            'label' => 'Subheading',  
            'type' => 'text',     
            'width' => '50'
        ],

        // Rich text
        [
            'id' => 'body',        
            'label' => 'Body',        
            'type' => 'wysiwyg', 
            'rows' => 6
        ],

        // Select with options
        [
            'id' => 'style',
            'label' => 'Style',
            'type' => 'select',
            'options' => ['light' => 'Light', 'dark' => 'Dark']
        ],

        // Toggle
        [
            'id' => 'show_cta',    
            'label' => 'Show CTA',    
            'type' => 'checkbox'
        ],

        // Color picker
        [
            'id' => 'bg_color',    
            'label' => 'Background',  
            'type' => 'color', 
            'default' => '#ffffff'
        ],

        // Range slider
        [
            'id' => 'min_height',
            'label' => 'Min Height',
            'type' => 'range',
            'min' => 400,
            'max' => 900,
            'step' => 50,
            'unit' => 'px',
            'default' => 600
        ],

        // Image
        [
            'id' => 'image',       
            'label' => 'Background Image', 
            'type' => 'image'
        ],

        // Post selector (single)
        [
            'id' => 'featured_post', 
            'label' => 'Featured Post', 
            'type' => 'post_select', 
            'post_type' => 'post'
        ],

        // Post selector (multi, with max)
        [
            'id' => 'related',
            'label' => 'Related Posts',
            'type' => 'post_select',
            'post_type' => 'post',
            'multiple' => true,
            'max' => 3
        ],
    ],
]);

'fields' => [
    ['id' => 'show_cta',   'label' => 'Show CTA',    'type' => 'checkbox'],
    ['id' => 'cta_text',   'label' => 'CTA Text',    'type' => 'text',
     'conditions' => [
         ['field' => 'show_cta', 'operator' => '==', 'value' => '1'],
     ]],
    ['id' => 'cta_url',    'label' => 'CTA URL',     'type' => 'url',
     'conditions' => [
         ['field' => 'show_cta', 'operator' => '==', 'value' => '1'],
     ]],
],

new Metabox([
    'id'     => 'taw_hero',
    'title'  => 'Hero Section',
    'screens' => ['page'],
    'fields' => [
        ['id' => 'heading',   'label' => 'Heading',   'type' => 'text'],
        ['id' => 'image',     'label' => 'Image',     'type' => 'image'],
        ['id' => 'bg_color',  'label' => 'Background','type' => 'color'],
        ['id' => 'show_cta',  'label' => 'Show CTA',  'type' => 'checkbox'],
        ['id' => 'cta_text',  'label' => 'CTA Text',  'type' => 'text'],
    ],
    'tabs' => [
        ['id' => 'content', 'label' => 'Content', 'fields' => ['heading', 'image']],
        ['id' => 'design',  'label' => 'Design',  'fields' => ['bg_color']],
        ['id' => 'cta',     'label' => 'CTA',     'fields' => ['show_cta', 'cta_text']],
    ],
]);

use TAW\Core\Metabox\Metabox;

// Plain text / any scalar value
$heading = Metabox::get($postId, 'hero_heading');

// Checkbox → boolean (saves as '1'/'0', returns bool)
$showCta = Metabox::get_bool($postId, 'show_cta');

// Image attachment ID → URL
$imageUrl = Metabox::get_image_url($postId, 'hero_image', 'large');

// Color with fallback
$bgColor = Metabox::get_color($postId, 'bg_color', '#ffffff');

// post_select → array of post IDs (works for single and multi)
$featuredId  = Metabox::get_posts($postId, 'featured_post')[0] ?? null;
$relatedIds  = Metabox::get_posts($postId, 'related_posts');

// repeater → array of rows, each an associative array
$teamMembers = Metabox::get_repeater($postId, 'team_members');
foreach ($teamMembers as $member) {
    echo esc_html($member['name'] ?? '');
    echo esc_html($member['role'] ?? '');
}

use TAW\Core\Form\Form;

// In your MetaBlock::boot():
public static function boot(): void
{
    add_action('init', static function () {
        Form::register([
            'id'           => 'contact',
            'submit_label' => 'Send Message',
            'messages'     => ['success' => "Thanks! We'll be in touch."],
            'email' => [
                'to_self'   => ['subject' => 'New contact',      'template' => 'contact-self'],
                'to_client' => ['subject' => 'Got your message', 'template' => 'contact-client'],
            ],
            'fields' => [
                ['id' => 'name',    'label' => 'Name',    'type' => 'text',     'required' => true],
                ['id' => 'email',   'label' => 'Email',   'type' => 'email',    'required' => true],
                ['id' => 'message', 'label' => 'Message', 'type' => 'textarea', 'required' => true],
            ],
        ]);
    });
}

// In the block's index.php template:
Form::display('contact');

'fields' => [
    ['id' => 'name',    'type' => 'text',     'label' => 'Name',    'width' => 50],
    ['id' => 'company', 'type' => 'text',     'label' => 'Company', 'width' => 50],
    ['id' => 'phone',   'type' => 'tel',      'label' => 'Phone',   'width' => 33],
    ['id' => 'email',   'type' => 'email',    'label' => 'Email',   'width' => 67],
    ['id' => 'message', 'type' => 'textarea', 'label' => 'Message', 'width' => 100],
],

['type' => 'heading', 'label' => '1. Personal Data', 'subtitle' => 'General identification'],
['type' => 'divider'],
['type' => 'html', 'content' => '<p class="text-sm text-gray-500">All fields marked * are required.</p>'],

// AND logic (default) — show 'cta_text' only when 'show_cta' is checked
['id' => 'show_cta',  'label' => 'Show CTA',  'type' => 'checkbox'],
['id' => 'cta_text',  'label' => 'CTA Text',  'type' => 'text',
 'conditions' => [
     ['field' => 'show_cta', 'operator' => '==', 'value' => '1'],
 ]],

// OR logic — show 'spouse_name' when married OR cohabiting
['id' => 'spouse_name', 'label' => 'Spouse / Partner name', 'type' => 'text',
 'conditions' => [
     'relation' => 'any',
     'rules'    => [
         ['field' => 'estado_civil', 'operator' => '==', 'value' => 'married'],
         ['field' => 'estado_civil', 'operator' => '==', 'value' => 'cohabiting'],
     ],
 ]],

Form::register([
    'id'           => 'application',
    'submit_label' => 'Submit',
    'next_label'   => 'Continue',   // optional; default "Next"
    'prev_label'   => 'Back',       // optional; default "Back"
    'messages'     => ['success' => 'Your form has been received.'],
    'steps' => [
        [
            'title'  => 'Personal Info',
            'fields' => [
                ['type' => 'heading', 'label' => '1. General Data'],
                ['id' => 'nombre',    'label' => 'Name',  'type' => 'text',  'required' => true, 'width' => 50],
                ['id' => 'email',     'label' => 'Email', 'type' => 'email', 'required' => true, 'width' => 50],
            ],
        ],
        [
            'title'  => 'Declaration',
            'fields' => [
                ['type' => 'html', 'content' => '<p>I declare that all information provided is true.</p>'],
                ['id' => 'confirm', 'label' => 'I confirm', 'type' => 'checkbox', 'required' => true],
            ],
        ],
    ],
]);

new OptionsPage([
    'id'         => 'taw_settings',
    'title'      => 'TAW Settings',
    'menu_title' => 'TAW Settings',
    'capability' => 'manage_options',
    'icon'       => 'dashicons-screenoptions',
    'position'   => 2,
    'fields'     => [
        ['id' => 'company_name',  'label' => 'Company Name',  'type' => 'text', 'width' => '33.33'],
        ['id' => 'company_phone', 'label' => 'Phone Number',  'type' => 'text', 'width' => '33.33'],
        ['id' => 'company_email', 'label' => 'Email Address', 'type' => 'text', 'width' => '33.33'],
        ['id' => 'footer_text',   'label' => 'Footer Text',   'type' => 'textarea'],
        ['id' => 'logo',          'label' => 'Logo',          'type' => 'image'],
    ],
    'tabs' => [
        ['label' => 'General', 'fields' => ['company_name', 'company_phone', 'company_email']],
        ['label' => 'Footer',  'fields' => ['footer_text']],
    ],
]);

use TAW\Core\OptionsPage\OptionsPage;

$phone = OptionsPage::get('company_phone');
$logo  = OptionsPage::get_image_url('logo', 'medium');

use TAW\Core\Menu\Menu;

$menu = Menu::get('primary');
if ($menu && $menu->hasItems()) {
    foreach ($menu->items() as $item) {
        echo '<a href="' . esc_url($item->url()) . '"';
        if ($item->openInNewTab()) echo ' target="_blank" rel="noopener"';
        echo '>' . esc_html($item->title()) . '</a>';

        if ($item->hasChildren()) {
            foreach ($item->children() as $child) {
                // render child item
            }
        }
    }
}

// functions.php — before Theme::boot()
use TAW\Core\Editor\VisualEditor;

VisualEditor::enable();
Theme::boot();

// Wrap a value so it's directly clickable on the page
<?= Editor::field($data['headline'], 'hero', 'headline', 'h2') ?>

// Add data attributes to an existing element (e.g. <img>)
<img <?= Editor::attrs('hero', 'hero_image') ?> src="...">

use TAW\Core\Mail\Mailer;

$sent = (new Mailer())
    ->to('support@acme-agency.test')
    ->subject('New contact form submission')
    ->template('contact')          // → mails/html/contact.html (prod) or mails/contact.mjml (dev)
    ->setVariables([
        'name'    => 'Jane Chen',
        'email'   => 'jane@acme.com',
        'message' => 'I would like to discuss a new project.',
    ])
    ->send();

if (! $sent) {
    // Handle failed mail transport (log, retry, etc.).
}