@sociallane/elements 1.0.0

package/widgets/faq/faq.php

@@ -0,0 +1,253 @@
+<?php
+/**
+ * Widget: FAQ
+ *
+ * Accordion-style FAQ section with multiple layouts: stacked, split, and centered.
+ * Supports optional section title/description and FAQPage schema for SEO.
+ *
+ * @package SocialLane_Elements
+ */
+
+namespace SocialLane\Elements;
+
+use Elementor\Widget_Base;
+use Elementor\Controls_Manager;
+use Elementor\Repeater;
+use SocialLane\Elements\Traits\Animation_Controls;
+
+if ( ! defined( 'ABSPATH' ) ) {
+	exit;
+}
+
+/**
+ * FAQ Widget
+ */
+class Faq extends Widget_Base {
+
+	use Animation_Controls;
+
+	public function get_name(): string {
+		return 'faq';
+	}
+
+	public function get_title(): string {
+		return esc_html__( 'FAQ', 'sociallane-elements' );
+	}
+
+	public function get_icon(): string {
+		return 'eicon-accordion';
+	}
+
+	public function get_categories(): array {
+		return [ 'sociallane-content' ];
+	}
+
+	public function get_keywords(): array {
+		return [ 'faq', 'accordion', 'questions', 'answers', 'expandable' ];
+	}
+
+	protected function register_controls(): void {
+		$this->register_header_section();
+		$this->register_items_section();
+		$this->register_layout_section();
+		$this->register_animation_controls( true, true );
+	}
+
+	private function register_header_section(): void {
+		$this->start_controls_section(
+			'section_header',
+			[
+				'label' => esc_html__( 'Header', 'sociallane-elements' ),
+				'tab'   => Controls_Manager::TAB_CONTENT,
+			]
+		);
+
+		$this->add_control(
+			'show_title',
+			[
+				'label'   => esc_html__( 'Show Title', 'sociallane-elements' ),
+				'type'    => Controls_Manager::SWITCHER,
+				'default' => 'yes',
+			]
+		);
+
+		$this->add_control(
+			'title',
+			[
+				'label'       => esc_html__( 'Title', 'sociallane-elements' ),
+				'type'        => Controls_Manager::TEXT,
+				'default'     => esc_html__( 'Frequently asked questions', 'sociallane-elements' ),
+				'label_block' => true,
+				'placeholder' => esc_html__( 'Lorem ipsum dolor sit amet', 'sociallane-elements' ),
+			]
+		);
+
+		$this->add_control(
+			'title_tag',
+			[
+				'label'   => esc_html__( 'Title Tag', 'sociallane-elements' ),
+				'type'    => Controls_Manager::SELECT,
+				'default' => 'h2',
+				'options' => [
+					'h1' => 'H1',
+					'h2' => 'H2',
+					'h3' => 'H3',
+				],
+			]
+		);
+
+		$this->add_control(
+			'show_description',
+			[
+				'label'   => esc_html__( 'Show Description', 'sociallane-elements' ),
+				'type'    => Controls_Manager::SWITCHER,
+				'default' => 'yes',
+			]
+		);
+
+		$this->add_control(
+			'description',
+			[
+				'label'   => esc_html__( 'Description', 'sociallane-elements' ),
+				'type'    => Controls_Manager::TEXTAREA,
+				'default' => esc_html__( 'Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.', 'sociallane-elements' ),
+				'placeholder' => esc_html__( 'Lorem ipsum dolor sit amet...', 'sociallane-elements' ),
+			]
+		);
+
+		$this->end_controls_section();
+	}
+
+	private function register_items_section(): void {
+		$this->start_controls_section(
+			'section_items',
+			[
+				'label' => esc_html__( 'FAQ Items', 'sociallane-elements' ),
+				'tab'   => Controls_Manager::TAB_CONTENT,
+			]
+		);
+
+		$repeater = new Repeater();
+
+		$repeater->add_control(
+			'question',
+			[
+				'label'       => esc_html__( 'Question', 'sociallane-elements' ),
+				'type'        => Controls_Manager::TEXT,
+				'default'     => esc_html__( 'Lorem ipsum dolor sit amet?', 'sociallane-elements' ),
+				'label_block' => true,
+			]
+		);
+
+		$repeater->add_control(
+			'answer',
+			[
+				'label'   => esc_html__( 'Answer', 'sociallane-elements' ),
+				'type'    => Controls_Manager::TEXTAREA,
+				'default' => esc_html__( 'Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.', 'sociallane-elements' ),
+			]
+		);
+
+		$repeater->add_control(
+			'button_label',
+			[
+				'label'       => esc_html__( 'Button Label', 'sociallane-elements' ),
+				'type'        => Controls_Manager::TEXT,
+				'placeholder' => esc_html__( 'Lorem ipsum', 'sociallane-elements' ),
+			]
+		);
+
+		$repeater->add_control(
+			'button_url',
+			[
+				'label' => esc_html__( 'Button Link', 'sociallane-elements' ),
+				'type'  => Controls_Manager::URL,
+			]
+		);
+
+		$this->add_control(
+			'faq_items',
+			[
+				'label'       => esc_html__( 'Items', 'sociallane-elements' ),
+				'type'        => Controls_Manager::REPEATER,
+				'fields'      => $repeater->get_controls(),
+				'default'     => [
+					[
+						'question' => esc_html__( 'Lorem ipsum dolor sit amet?', 'sociallane-elements' ),
+						'answer'   => esc_html__( 'Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.', 'sociallane-elements' ),
+					],
+					[
+						'question' => esc_html__( 'Consectetur adipiscing elit?', 'sociallane-elements' ),
+						'answer'   => esc_html__( 'Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.', 'sociallane-elements' ),
+					],
+					[
+						'question' => esc_html__( 'Sed do eiusmod tempor?', 'sociallane-elements' ),
+						'answer'   => esc_html__( 'Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur.', 'sociallane-elements' ),
+					],
+				],
+				'title_field' => '{{{ question }}}',
+			]
+		);
+
+		$this->end_controls_section();
+	}
+
+	private function register_layout_section(): void {
+		$this->start_controls_section(
+			'section_layout',
+			[
+				'label' => esc_html__( 'Layout', 'sociallane-elements' ),
+				'tab'   => Controls_Manager::TAB_CONTENT,
+			]
+		);
+
+		$this->add_control(
+			'layout',
+			[
+				'label'   => esc_html__( 'Layout', 'sociallane-elements' ),
+				'type'    => Controls_Manager::SELECT,
+				'default' => 'stacked',
+				'options' => [
+					'stacked'  => esc_html__( 'Stacked', 'sociallane-elements' ),
+					'split'    => esc_html__( 'Split', 'sociallane-elements' ),
+					'centered' => esc_html__( 'Centered', 'sociallane-elements' ),
+				],
+			]
+		);
+
+		$this->add_control(
+			'content_position',
+			[
+				'label'     => esc_html__( 'Header Position', 'sociallane-elements' ),
+				'type'      => Controls_Manager::SELECT,
+				'default'   => 'left',
+				'options'   => [
+					'left'  => esc_html__( 'Left', 'sociallane-elements' ),
+					'right' => esc_html__( 'Right', 'sociallane-elements' ),
+				],
+				'condition' => [
+					'layout' => 'split',
+				],
+			]
+		);
+
+		$this->add_control(
+			'first_open',
+			[
+				'label'        => esc_html__( 'First item open by default', 'sociallane-elements' ),
+				'type'         => Controls_Manager::SWITCHER,
+				'default'      => 'yes',
+				'return_value' => 'yes',
+			]
+		);
+
+		$this->end_controls_section();
+	}
+
+	protected function render(): void {
+		$settings = $this->get_settings_for_display();
+		require_once __DIR__ . '/data/view.php';
+		$view = prepare_faq_view( $settings, $this->get_id() );
+		include __DIR__ . '/templates/wrapper.php';
+	}
+}

package/widgets/faq/templates/partials/accordion.php

@@ -0,0 +1,74 @@
+<?php
+/**
+ * FAQ: Accordion list
+ *
+ * Renders FAQ items as <details>/<summary> for accessibility and no-JS support.
+ * Expects $view with items and classes.
+ *
+ * @package SocialLane_Elements
+ */
+
+if ( ! defined( 'ABSPATH' ) ) {
+	exit;
+}
+
+if ( ! is_array( $view ?? null ) || ! is_array( $view['items'] ?? null ) || empty( $view['items'] ) ) {
+	return;
+}
+
+$items       = $view['items'];
+$faq_classes = is_array( $view['classes'] ?? null ) ? $view['classes'] : [
+	'item_border'   => 'border-neutral-200 dark:border-blue-chill-100/0',
+	'item_bg'       => 'bg-transparent',
+	'question'      => 'text-zinc-900 dark:text-neutral-200',
+	'answer'        => 'text-zinc-900 dark:text-neutral-200',
+	'summary_focus' => 'focus:ring-primary focus:ring-offset-2 focus:ring-offset-white dark:focus:ring-offset-neutral-900',
+	'chevron'       => 'bg-blue-chill-300 dark:bg-neutral-800 text-neutral-600 dark:text-blue-chill-300',
+];
+$elements_path = defined( 'SOCIALLANE_ELEMENTS_PATH' ) ? SOCIALLANE_ELEMENTS_PATH . 'elements' : '';
+$stagger_attrs = isset( $stagger_attrs ) ? $stagger_attrs : '';
+?>
+
+<div class="space-y-0"<?php echo $stagger_attrs !== '' ? ' ' . $stagger_attrs : ''; ?>>
+	<?php foreach ( $items as $item ) : ?>
+		<?php if ( ! is_array( $item ) ) : ?>
+			<?php continue; ?>
+		<?php endif; ?>
+		<?php
+		$question = $item['question'] ?? '';
+		$answer   = $item['answer'] ?? '';
+		?>
+		<details
+			class="faq-details group border-b <?php echo esc_attr( $faq_classes['item_border'] ); ?> <?php echo esc_attr( $faq_classes['item_bg'] ); ?>"
+			<?php if ( ! empty( $item['open'] ) ) : ?>open<?php endif; ?>
+			id="<?php echo esc_attr( $item['id'] ); ?>"
+		>
+			<summary
+				class="flex items-center justify-between gap-4 list-none cursor-pointer py-4 md:py-5 pr-8 md:pr-10 text-left font-semibold <?php echo esc_attr( $faq_classes['question'] ); ?> text-base md:text-lg focus:outline-none focus:ring-2 <?php echo esc_attr( $faq_classes['summary_focus'] ); ?> rounded"
+				aria-expanded="<?php echo ! empty( $item['open'] ) ? 'true' : 'false'; ?>"
+			>
+				<span><?php echo $question; ?></span>
+				<span class="shrink-0 w-6 h-6 flex items-center justify-center rounded-full <?php echo esc_attr( $faq_classes['chevron'] ); ?> group-open:rotate-180 transition-transform duration-200" aria-hidden="true">
+					<svg class="w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg">
+						<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M19 9l-7 7-7-7" />
+					</svg>
+				</span>
+			</summary>
+			<div class="faq-answer-wrapper">
+				<div class="faq-answer-content min-h-0 overflow-hidden">
+					<div class="pb-4 md:pb-5 pl-0 pr-8 md:pr-10 <?php echo esc_attr( $faq_classes['answer'] ); ?> text-base md:text-lg leading-relaxed">
+						<?php echo $answer; ?>
+						<?php if ( ! empty( $item['button'] ) && $elements_path !== '' ) : ?>
+							<p class="mt-4">
+								<?php
+								$button = $item['button'];
+								include $elements_path . '/button/templates/render.php';
+								?>
+							</p>
+						<?php endif; ?>
+					</div>
+				</div>
+			</div>
+		</details>
+	<?php endforeach; ?>
+</div>

package/widgets/faq/templates/partials/layout-centered.php

@@ -0,0 +1,41 @@
+<?php
+/**
+ * FAQ: Centered layout
+ *
+ * Header centered, accordion full width below (or constrained).
+ * Expects $view.
+ *
+ * @package SocialLane_Elements
+ */
+
+if ( ! defined( 'ABSPATH' ) ) {
+	exit;
+}
+
+$classes = $view['classes'];
+?>
+
+<div class="max-w-4xl mx-auto">
+	<?php if ( ( $view['show_title'] && $view['title'] ) || ( $view['show_description'] && $view['description'] ) ) : ?>
+		<header class="text-center mb-10 md:mb-12">
+			<?php if ( $view['show_title'] && $view['title'] ) : ?>
+				<<?php echo $view['title_tag']; ?>
+					id="faq-title-<?php echo esc_attr( $view['widget_id'] ); ?>"
+					class="<?php echo esc_attr( $classes['title'] ); ?> text-2xl md:text-3xl lg:text-4xl font-bold font-heading leading-tight"
+					<?php echo ! empty( $headline_attrs ) ? ' ' . $headline_attrs : ''; ?>
+				>
+					<?php echo $view['title']; ?>
+				</<?php echo $view['title_tag']; ?>>
+			<?php endif; ?>
+			<?php if ( $view['show_description'] && $view['description'] ) : ?>
+				<div class="<?php echo esc_attr( $classes['description'] ); ?> mt-4 text-lg leading-relaxed max-w-2xl mx-auto">
+					<?php echo $view['description']; ?>
+				</div>
+			<?php endif; ?>
+		</header>
+	<?php endif; ?>
+
+	<div class="faq-accordion">
+		<?php include __DIR__ . '/accordion.php'; ?>
+	</div>
+</div>

package/widgets/faq/templates/partials/layout-split.php

@@ -0,0 +1,47 @@
+<?php
+/**
+ * FAQ: Split layout
+ *
+ * Two columns — header (title + description) on one side, accordion on the other.
+ * Expects $view with header_order, accordion_order.
+ *
+ * @package SocialLane_Elements
+ */
+
+if ( ! defined( 'ABSPATH' ) ) {
+	exit;
+}
+
+$classes = $view['classes'];
+?>
+
+<div class="grid grid-cols-1 lg:grid-cols-2 gap-8 lg:gap-12 xl:gap-16 items-start">
+	<?php // ----- Header column ----- ?>
+	<div class="<?php echo esc_attr( $view['header_order'] ); ?>">
+		<?php if ( ( $view['show_title'] && $view['title'] ) || ( $view['show_description'] && $view['description'] ) ) : ?>
+			<header>
+				<?php if ( $view['show_title'] && $view['title'] ) : ?>
+					<<?php echo $view['title_tag']; ?>
+						id="faq-title-<?php echo esc_attr( $view['widget_id'] ); ?>"
+						class="<?php echo esc_attr( $classes['title'] ); ?> text-2xl md:text-3xl lg:text-4xl font-bold font-heading leading-tight"
+						<?php echo ! empty( $headline_attrs ) ? ' ' . $headline_attrs : ''; ?>
+					>
+						<?php echo $view['title']; ?>
+					</<?php echo $view['title_tag']; ?>>
+				<?php endif; ?>
+				<?php if ( $view['show_description'] && $view['description'] ) : ?>
+					<div class="<?php echo esc_attr( $classes['description'] ); ?> mt-4 text-lg leading-relaxed">
+						<?php echo $view['description']; ?>
+					</div>
+				<?php endif; ?>
+			</header>
+		<?php endif; ?>
+	</div>
+
+	<?php // ----- Accordion column ----- ?>
+	<div class="<?php echo esc_attr( $view['accordion_order'] ); ?>">
+		<div class="faq-accordion">
+			<?php include __DIR__ . '/accordion.php'; ?>
+		</div>
+	</div>
+</div>

package/widgets/faq/templates/partials/layout-stacked.php

@@ -0,0 +1,57 @@
+<?php
+/**
+ * FAQ: Stacked layout
+ *
+ * Header on top, accordion list split into two columns below (responsive: one column on small screens).
+ * Expects $view.
+ *
+ * @package SocialLane_Elements
+ */
+
+if ( ! defined( 'ABSPATH' ) ) {
+	exit;
+}
+
+$classes = $view['classes'];
+$items   = $view['items'] ?? [];
+$mid     = (int) ceil( count( $items ) / 2 );
+$items_left  = array_slice( $items, 0, $mid );
+$items_right = array_slice( $items, $mid, null );
+?>
+
+<div class="max-w-full mx-auto">
+	<?php if ( ( $view['show_title'] && $view['title'] ) || ( $view['show_description'] && $view['description'] ) ) : ?>
+		<header class="mb-8 md:mb-10">
+			<?php if ( $view['show_title'] && $view['title'] ) : ?>
+				<<?php echo $view['title_tag']; ?>
+					id="faq-title-<?php echo esc_attr( $view['widget_id'] ); ?>"
+					class="<?php echo esc_attr( $classes['title'] ); ?> text-2xl md:text-3xl lg:text-4xl font-bold font-heading leading-tight"
+					<?php echo ! empty( $headline_attrs ) ? ' ' . $headline_attrs : ''; ?>
+				>
+					<?php echo $view['title']; ?>
+				</<?php echo $view['title_tag']; ?>>
+			<?php endif; ?>
+			<?php if ( $view['show_description'] && $view['description'] ) : ?>
+				<div class="<?php echo esc_attr( $classes['description'] ); ?> mt-4 text-lg leading-relaxed">
+					<?php echo $view['description']; ?>
+				</div>
+			<?php endif; ?>
+		</header>
+	<?php endif; ?>
+
+	<div class="faq-accordion grid grid-cols-1 md:grid-cols-2 gap-6 md:gap-8 lg:gap-10">
+		<div class="faq-accordion__col">
+			<?php
+			$view['items'] = $items_left;
+			include __DIR__ . '/accordion.php';
+			?>
+		</div>
+		<div class="faq-accordion__col">
+			<?php
+			$view['items'] = $items_right;
+			include __DIR__ . '/accordion.php';
+			?>
+		</div>
+	</div>
+	<?php $view['items'] = $items; ?>
+</div>

package/widgets/faq/templates/wrapper.php

@@ -0,0 +1,76 @@
+<?php
+/**
+ * Template: FAQ Wrapper
+ *
+ * FAQ section with stacked, split, or centered layout.
+ * Outputs FAQPage schema when items exist.
+ *
+ * AVAILABLE DATA ($view):
+ * - show_title, show_description, title, title_tag, description
+ * - items (array of id, question, answer, open)
+ * - layout (stacked | split | centered)
+ * - header_order, accordion_order (split only)
+ * - classes, widget_id, schema_items
+ *
+ * @package SocialLane_Elements
+ */
+
+if ( ! defined( 'ABSPATH' ) ) {
+	exit;
+}
+
+if ( empty( $view ) ) {
+	return;
+}
+
+$anim          = $view['animation'] ?? [];
+$section_attrs = sociallane_section_animation_attrs( $anim );
+$headline_attrs = sociallane_headline_animation_attrs( $anim );
+$layout      = $view['layout'] ?? 'stacked';
+$partials_dir = __DIR__ . '/partials';
+?>
+
+<?php // ========== FAQ START ========== ?>
+
+<section
+	class="<?php echo esc_attr( $view['classes']['section'] ); ?> py-16 md:py-20 lg:py-24"
+	<?php echo $section_attrs ? ' ' . $section_attrs : ''; ?>
+	<?php if ( ! empty( $view['show_title'] ) && ! empty( $view['title'] ) ) : ?>
+		aria-labelledby="faq-title-<?php echo esc_attr( $view['widget_id'] ); ?>"
+	<?php endif; ?>
+>
+	<div class="container mx-auto px-4 sm:px-6 lg:px-8">
+		<?php
+		$stagger_attrs = sociallane_stagger_attrs( $anim );
+		$layout_file = $partials_dir . '/layout-' . $layout . '.php';
+		if ( file_exists( $layout_file ) ) {
+			include $layout_file;
+		} else {
+			include $partials_dir . '/layout-stacked.php';
+		}
+		?>
+	</div>
+</section>
+
+<?php
+// FAQPage schema for SEO
+if ( ! empty( $view['schema_items'] ) ) {
+	$schema = [
+		'@context'   => 'https://schema.org',
+		'@type'     => 'FAQPage',
+		'mainEntity' => array_map( function ( $item ) {
+			return [
+				'@type' => 'Question',
+				'name'  => $item['question'],
+				'acceptedAnswer' => [
+					'@type' => 'Answer',
+					'text'  => $item['answer'],
+				],
+			];
+		}, $view['schema_items'] ),
+	];
+	echo '<script type="application/ld+json">' . wp_json_encode( $schema, JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE ) . '</script>';
+}
+?>
+
+<?php // ========== FAQ END ========== ?>

package/widgets/feature-grid/data/view.php

@@ -0,0 +1,121 @@
+<?php
+/**
+ * Data Preparation: Feature Grid
+ *
+ * Transforms raw Elementor settings into clean, template-ready data.
+ * ALL sanitization, defaults, and data transformation happens here.
+ *
+ * @package SocialLane_Elements
+ * @since   1.0.0
+ */
+
+if ( ! defined( 'ABSPATH' ) ) {
+	exit;
+}
+
+/**
+ * Prepare view data for Feature Grid widget
+ *
+ * @param array  $settings  Raw Elementor settings
+ * @param string $widget_id Unique widget ID for accessibility
+ * @return array Template-ready data
+ */
+function prepare_feature_grid_view( array $settings, string $widget_id ): array {
+	$show_headline    = ( $settings['show_headline'] ?? 'no' ) === 'yes';
+	$show_subtitle    = ( $settings['show_subtitle'] ?? 'no' ) === 'yes';
+	$show_description = ( $settings['show_description'] ?? 'no' ) === 'yes';
+
+	$headline    = $show_headline ? esc_html( $settings['headline'] ?? '' ) : '';
+	$subtitle    = $show_subtitle ? esc_html( $settings['subtitle'] ?? '' ) : '';
+	$description = $show_description ? esc_html( $settings['description'] ?? '' ) : '';
+	$headline_tag = in_array( $settings['headline_tag'] ?? 'h2', [ 'h1', 'h2', 'h3' ], true )
+		? $settings['headline_tag']
+		: 'h2';
+
+	$layout = ( $settings['layout'] ?? 'default' ) === 'centered_2x2' ? 'centered_2x2' : 'default';
+
+	$columns = in_array( $settings['columns'] ?? '4', [ '2', '3', '4' ], true )
+		? $settings['columns']
+		: '4';
+	$grid_cols = [
+		'2' => 'grid-cols-1 sm:grid-cols-2',
+		'3' => 'grid-cols-1 sm:grid-cols-2 lg:grid-cols-3',
+		'4' => 'grid-cols-1 sm:grid-cols-2 lg:grid-cols-4',
+	];
+	$grid_class = $grid_cols[ $columns ] ?? $grid_cols['4'];
+
+	$features_raw = $settings['features'] ?? [];
+	$features     = [];
+
+	foreach ( $features_raw as $item ) {
+		$link_url    = $item['link_url'] ?? [];
+		$href        = esc_url( $link_url['url'] ?? '#' );
+		$is_external = ! empty( $link_url['is_external'] );
+		$nofollow    = ! empty( $link_url['nofollow'] );
+
+		$attrs = [];
+		if ( $is_external ) {
+			$attrs[] = 'target="_blank"';
+			$attrs[] = 'rel="noopener noreferrer"';
+		}
+		if ( $nofollow ) {
+			$attrs[] = 'rel="nofollow"';
+		}
+
+		$show_link = ( $item['show_link'] ?? 'yes' ) === 'yes';
+		$features[] = [
+			'icon'        => $item['icon'] ?? null,
+			'title'       => esc_html( $item['title'] ?? '' ),
+			'description' => esc_html( $item['description'] ?? '' ),
+			'show_link'   => $show_link && $layout !== 'centered_2x2',
+			'link_text'   => $show_link ? esc_html( $item['link_text'] ?? '' ) : '',
+			'link_url'    => $href,
+			'link_attrs'  => implode( ' ', $attrs ),
+		];
+	}
+
+	// Centered 2x2: use first 4 features only; no links in layout
+	if ( $layout === 'centered_2x2' ) {
+		$features = array_slice( $features, 0, 4 );
+	}
+
+	$animation = sociallane_animation_view_data( $settings, [ 'headline' => true, 'stagger' => true ] );
+
+	/*
+	|--------------------------------------------------------------------------
+	| Theme Classes (light + dark)
+	|--------------------------------------------------------------------------
+	|
+	| ALL color, background, border-color, and text-color Tailwind classes
+	| are defined HERE — never in templates. Templates only echo these
+	| pre-built strings via $view['classes'].
+	|
+	*/
+	$classes = [
+		'section'     => 'bg-neutral-100 dark:bg-zinc-900',
+		'headline'    => 'text-zinc-900 dark:text-neutral-200',
+		'subtitle'    => 'text-zinc-900 dark:text-neutral-200',
+		'eyebrow'     => 'text-zinc-900 dark:text-neutral-200',
+		'description' => 'text-zinc-900 dark:text-neutral-200',
+		'title'       => 'text-zinc-900 dark:text-neutral-200',
+		'link'        => 'text-zinc-900 dark:text-neutral-200 hover:underline focus:outline-none focus:ring-2 focus:ring-primary focus:ring-offset-2 focus:ring-offset-white dark:focus:ring-offset-neutral-900',
+		'icon_box'    => 'bg-zinc-400 dark:bg-zinc-700 text-zinc-900 rounded-lg',
+		'icon'        => 'w-6 h-6 text-white',
+	];
+
+	return [
+		'layout'          => $layout,
+		'show_headline'   => $show_headline,
+		'show_subtitle'   => $show_subtitle,
+		'show_description' => $show_description,
+		'headline'        => $headline,
+		'headline_tag'    => $headline_tag,
+		'subtitle'        => $subtitle,
+		'description'     => $description,
+		'grid_class'      => $grid_class,
+		'features'        => $features,
+		'classes'         => $classes,
+		'widget_id'       => $widget_id,
+		'animation'       => $animation,
+	];
+}