<?php
/**
 * Customify Dashboard v2
 *
 * Top-level admin page (`customify`) powered by
 * `@pressmaximum/dashboard-kit`. Old PHP dashboard lives at
 * `customify-legacy` under Appearance — see inc/admin/dashboard.php.
 *
 * @package Customify
 */

declare(strict_types=1);

if ( ! defined( 'ABSPATH' ) ) {
	exit;
}

if ( ! class_exists( '\\PressMaximum\\DashboardKit\\Admin\\AssetEnqueue' ) ) {
	// Composer autoload missing — nothing to do. functions.php skips the
	// require when vendor/ is absent, so this branch is the developer-
	// without-composer-install case. Bail out silently; the menu just
	// doesn't appear.
	return;
}

use PressMaximum\DashboardKit\Admin\AssetEnqueue;

/**
 * Page slug for the new top-level dashboard.
 */
const CUSTOMIFY_DASHBOARD_V2_SLUG = 'customify';

/**
 * Bundle handle (also script + style handle).
 */
const CUSTOMIFY_DASHBOARD_V2_HANDLE = 'customify-dashboard';

/**
 * Register the top-level menu.
 *
 * Icon is the SVG asset served from the theme. `get_theme_file_uri()`
 * is the WP-native lookup (child-theme aware). WP renders icon URLs in
 * an `<img>` tag without sizing it, so the companion `admin_head` CSS
 * below constrains the rendered size to the standard 20px menu icon.
 * Falls back to a dashicon if the build artifact is missing.
 */
function customify_dashboard_v2_add_menu(): void {
	$icon_rel  = 'build/images/admin/menu.svg';
	$icon_path = get_theme_file_path( $icon_rel );
	$icon      = is_readable( $icon_path )
		? get_theme_file_uri( $icon_rel )
		: 'dashicons-admin-customizer';

	add_menu_page(
		__( 'Customify', 'customify' ),
		__( 'Customify', 'customify' ),
		'manage_options',
		CUSTOMIFY_DASHBOARD_V2_SLUG,
		'customify_dashboard_v2_render',
		$icon,
		59
	);
}

/**
 * Size the top-level menu icon. WP only auto-sizes SVG icons passed as
 * `data:image/svg+xml;base64,` URIs (the `.wp-menu-image.svg` class
 * path); URL-based icons render in `<img>` at intrinsic size, which is
 * huge for our viewBox-only SVG without explicit width/height.
 */
function customify_dashboard_v2_menu_icon_style(): void {
	?>
	<style>
		#adminmenu #toplevel_page_<?php echo esc_attr( CUSTOMIFY_DASHBOARD_V2_SLUG ); ?> .wp-menu-image {
			display: flex;
			align-items: center;
			justify-content: center;
		}
		#adminmenu #toplevel_page_<?php echo esc_attr( CUSTOMIFY_DASHBOARD_V2_SLUG ); ?> .wp-menu-image img {
			width: 20px;
			height: 20px;
			padding: 0;
			opacity: 1;
		}
	</style>
	<?php
}
add_action( 'admin_head', 'customify_dashboard_v2_menu_icon_style' );
// Priority 9 (one before default 10) ensures the `customify` parent
// menu exists in $menu by the time WP core's `_add_post_type_submenus`
// (admin_menu prio 10) iterates CPTs that declared `show_in_menu =>
// 'customify'` (e.g. the Pro Hooks module's `customify_hook` CPT). If
// the parent is missing at that moment, WP still appends the CPT entry
// to $submenu['customify'][0] but the subsequent `add_submenu_page`
// from this theme's submenu registration overwrites that index with
// the parent-mirror auto-row — silently dropping the CPT entry.
add_action( 'admin_menu', 'customify_dashboard_v2_add_menu', 9 );

/**
 * Mirror the in-page tabs as WP admin sidebar submenu entries (Dashboard
 * + Settings). The Changelog top tab stays available in-page but isn't
 * mirrored to the sidebar — it sees less direct navigation than the
 * Welcome / Settings flows and the sidebar prefers a tight surface.
 *
 * The "Dashboard" submenu entry points at `#welcome` so it still routes
 * to the Welcome tab; the visible label diverges from the in-page tab
 * label deliberately because the WP sidebar reads better as "Dashboard"
 * than "Welcome" once the user is past first-run.
 *
 * WP's native active-state detection compares `?page=` query strings
 * only and can't see the hash, so the live highlight is reapplied
 * client-side by customify_dashboard_v2_sync_submenu(). Mirrors
 * Blocksify's pattern (class-blocksify-dashboard-surfaces-spike.php
 * lines 70-86).
 */
function customify_dashboard_v2_register_submenu(): void {
	$tabs = array(
		array( 'hash' => '#welcome',  'label' => __( 'Dashboard', 'customify' ) ),
		array( 'hash' => '#settings', 'label' => __( 'Settings', 'customify' ) ),
	);
	if ( customify_dashboard_v2_use_starter_templates() ) {
		$tabs[] = array(
			'hash'  => '#starter-templates',
			'label' => __( 'Starter Templates', 'customify' ),
		);
	}
	foreach ( $tabs as $tab ) {
		add_submenu_page(
			CUSTOMIFY_DASHBOARD_V2_SLUG,
			$tab['label'],
			$tab['label'],
			'manage_options',
			'admin.php?page=' . CUSTOMIFY_DASHBOARD_V2_SLUG . $tab['hash'],
			''
		);
	}
	// `add_submenu_page` auto-creates the parent mirror entry at index 0
	// using the parent label ("Customify"). Hide it so the list reads as
	// just the tab labels.
	global $submenu;
	if ( ! isset( $submenu[ CUSTOMIFY_DASHBOARD_V2_SLUG ] ) ) {
		return;
	}
	if ( isset( $submenu[ CUSTOMIFY_DASHBOARD_V2_SLUG ][0] ) ) {
		unset( $submenu[ CUSTOMIFY_DASHBOARD_V2_SLUG ][0] );
	}

	// Re-sort so theme tabs (Dashboard, Settings) sit at the top of the
	// list and any extension submenu entries — e.g. the Customify Pro
	// Hooks module's `customify_hook` CPT submenu, which auto-attaches
	// to this parent via `show_in_menu => 'customify'` — follow in
	// their original order. WP's `_add_post_type_submenus()` runs at
	// admin_menu priority 10 (before this function at 20), so by the
	// time we reach here the CPT entry is already interleaved with the
	// theme entries. Without this sort the Hooks row can land above
	// Settings, which reads as "the module owns the page" instead of
	// "the theme's tabs + the module's extension".
	$tab_slug_prefix = 'admin.php?page=' . CUSTOMIFY_DASHBOARD_V2_SLUG . '#';
	$theme_entries   = array();
	$other_entries   = array();
	foreach ( $submenu[ CUSTOMIFY_DASHBOARD_V2_SLUG ] as $entry ) {
		if ( isset( $entry[2] ) && strpos( $entry[2], $tab_slug_prefix ) === 0 ) {
			$theme_entries[] = $entry;
		} else {
			$other_entries[] = $entry;
		}
	}
	$submenu[ CUSTOMIFY_DASHBOARD_V2_SLUG ] = array_values(
		array_merge( $theme_entries, $other_entries )
	);
}
add_action( 'admin_menu', 'customify_dashboard_v2_register_submenu', 20 );

/**
 * Constrain the WP admin sidebar icon size. The data:image/svg+xml URI
 * carries no intrinsic width/height (viewBox only), so WP falls back to
 * a too-large rendering. Pin to 18×18, the visual weight matches the
 * other admin-menu icons.
 */
function customify_dashboard_v2_menu_icon_css(): void {
	?>
<style>
#adminmenu #toplevel_page_<?php echo esc_html( CUSTOMIFY_DASHBOARD_V2_SLUG ); ?> .wp-menu-image {
	background-size: 18px auto;
	background-position: center center;
}
</style>
	<?php
}
add_action( 'admin_head', 'customify_dashboard_v2_menu_icon_css' );

/**
 * Sync the WP submenu `current` highlight to the active hash route.
 * WP only checks `?page=` server-side, so we re-derive client-side on
 * `hashchange`.
 */
function customify_dashboard_v2_sync_submenu(): void {
	?>
<script>
( function () {
	var menu = document.querySelector( '#toplevel_page_<?php echo esc_js( CUSTOMIFY_DASHBOARD_V2_SLUG ); ?> .wp-submenu' );
	if ( ! menu ) { return; }
	var items = Array.prototype.slice.call( menu.querySelectorAll( 'li' ) );
	function sync () {
		var hash = window.location.hash || '#welcome';
		items.forEach( function ( li ) {
			var a = li.querySelector( 'a' );
			if ( ! a ) {
				return;
			}
			var href = a.getAttribute( 'href' ) || '';
			var hashIdx = href.indexOf( '#' );
			var match = false;
			if ( hashIdx !== -1 ) {
				// Match the entry when the current hash is either an
				// exact match OR a sub-route (`#settings/<panelId>`,
				// `#changelog/<sourceId>`, …). Plain `indexOf` ran the
				// wrong direction — the entry's href doesn't contain
				// the longer current hash. The trailing-slash guard
				// avoids matching unrelated hashes that happen to
				// share a prefix (`#settings-extras` shouldn't paint
				// the Settings submenu active).
				var hrefHash = href.substring( hashIdx );
				match = hash === hrefHash
					|| hash.indexOf( hrefHash + '/' ) === 0;
			}
			li.classList.toggle( 'current', match );
			a.classList.toggle( 'current', match );
		} );
	}
	sync();
	window.addEventListener( 'hashchange', sync );
} )();
</script>
	<?php
}
add_action(
	'admin_footer-toplevel_page_' . CUSTOMIFY_DASHBOARD_V2_SLUG,
	'customify_dashboard_v2_sync_submenu'
);

/**
 * Print the SPA root div. JS takes over from there.
 */
function customify_dashboard_v2_render(): void {
	echo '<div id="customify-dashboard" class="customify-dashboard-root"></div>';
}

/**
 * Mark the admin body when we're on the dashboard page. The class is
 * the CSS hook that zeroes out WP's `#wpcontent` / `#wpbody-content`
 * paddings so the dashboard sits flush against the admin sidebar.
 *
 * @param string $classes Existing admin body classes.
 * @return string
 */
function customify_dashboard_v2_admin_body_class( string $classes ): string {
	$screen = function_exists( 'get_current_screen' ) ? get_current_screen() : null;
	if ( $screen && 'toplevel_page_' . CUSTOMIFY_DASHBOARD_V2_SLUG === $screen->id ) {
		$classes .= ' customify-dashboard-page';
	}
	return $classes;
}
add_filter( 'admin_body_class', 'customify_dashboard_v2_admin_body_class' );

/**
 * Whether to expose the Starter Templates tab + activation flow.
 *
 * On by default so the Starter Templates tab + submenu always show — even
 * when the Customify Starter Sites plugin is not installed/active, the tab
 * renders its "Activate plugin" CTA. Two switches can still force it OFF:
 *
 *   1. `define( 'CUSTOMIFY_USE_STARTER_TEMPLATES', false );` in
 *      wp-config.php — the dev/QA escape hatch.
 *   2. `add_filter( 'customify_use_starter_templates', '__return_false' );`
 *      — for programmatic control (Pro, child themes, site-specific MU
 *      plugins).
 *
 * Filter runs last so it can either reveal or hide the flow regardless
 * of the constant.
 */
function customify_dashboard_v2_use_starter_templates(): bool {
	// Default ON. A defined constant (either true/false) takes precedence
	// so a site can still explicitly turn the tab off.
	$enabled = defined( 'CUSTOMIFY_USE_STARTER_TEMPLATES' )
		? (bool) constant( 'CUSTOMIFY_USE_STARTER_TEMPLATES' )
		: true;

	/**
	 * Filter whether the Starter Templates tab + activation CTA are
	 * exposed in the dashboard.
	 *
	 * @param bool $enabled True to show the tab, false to hide it.
	 */
	return (bool) apply_filters( 'customify_use_starter_templates', $enabled );
}

/**
 * Build the boot data payload localized to window.customifyDashboard.
 *
 * @return array<string, mixed>
 */
function customify_dashboard_v2_boot_data(): array {
	$theme = wp_get_theme();
	if ( $theme->parent() ) {
		$theme = $theme->parent();
	}
	$user      = wp_get_current_user();
	$customize = admin_url( 'customize.php' );

	$boot = array(
		'name'         => 'Customify',
		'themeVersion' => (string) $theme->get( 'Version' ),
		'wpVersion'    => get_bloginfo( 'version' ),
		'user'         => array(
			'id'          => (int) $user->ID,
			'displayName' => (string) $user->display_name,
		),
		'urls'         => array(
			'customize'      => $customize,
			'logoIdentity'   => add_query_arg(
				array( 'autofocus' => array( 'section' => 'title_tagline' ) ),
				$customize
			),
			'layout'         => add_query_arg(
				array( 'autofocus' => array( 'section' => 'global_layout_section' ) ),
				$customize
			),
			'headerBuilder'  => add_query_arg(
				array( 'autofocus' => array( 'panel' => 'header_settings' ) ),
				$customize
			),
			'footerBuilder'  => add_query_arg(
				array( 'autofocus' => array( 'panel' => 'footer_settings' ) ),
				$customize
			),
			// Styling panel retired; deep-link to the top-level "Colors" section
			// (inc/customizer/configs/colors.php) which now owns styling/colors.
			'styling'        => add_query_arg(
				array( 'autofocus' => array( 'section' => 'customify_colors' ) ),
				$customize
			),
			'typography'     => add_query_arg(
				array( 'autofocus' => array( 'section' => 'typography_panel' ) ),
				$customize
			),
			'sidebar'        => add_query_arg(
				array( 'autofocus' => array( 'section' => 'sidebar_layout_section' ) ),
				$customize
			),
			'blog'           => add_query_arg(
				array( 'autofocus' => array( 'panel' => 'blog_panel' ) ),
				$customize
			),
			'homepage'       => add_query_arg(
				array( 'autofocus' => array( 'section' => 'static_front_page' ) ),
				$customize
			),
			'starterTemplatesInstall' => admin_url( 'plugin-install.php?tab=search&s=starter+templates' ),
			'legacyDashboard' => admin_url( 'themes.php?page=customify-legacy' ),
			'docs'           => 'https://pressmaximum.com/docs/customify/',
			'proUpgrade'     => 'https://pressmaximum.com/customify/pro-upgrade/?utm_source=theme_dashboard&utm_medium=links&utm_campaign=pro_modules',
		),
		'rest'         => array(
			'root'        => esc_url_raw( rest_url() ),
			'nonce'       => wp_create_nonce( 'wp_rest' ),
			'settingsEndpoint' => esc_url_raw( rest_url( 'customify/v1/settings' ) ),
			'schemaEndpoint'   => esc_url_raw( rest_url( 'customify/v1/settings/schema' ) ),
		),
		'settings'     => array(
			'faVersion' => (string) get_option( 'customify_fa_ver', 'v4' ),
			'values'    => function_exists( 'customify_dashboard_v2_get_settings' )
				? customify_dashboard_v2_get_settings()
				: array(),
			'schema'    => function_exists( 'customify_dashboard_v2_schema' )
				? customify_dashboard_v2_schema()->buildSchema()
				: array( 'panels' => array() ),
		),
		'changelog'    => customify_dashboard_v2_changelog( (string) $theme->get( 'Version' ) ),
		/**
		 * Toggle the Pro-aware module list in the Welcome tab.
		 *
		 * Customify Pro hooks this to `true` once activated; the JS side
		 * reads `boot.proActive` and renders a ToggleSwitch + Settings
		 * affordance per module instead of the marketing list.
		 */
		'proActive'    => (bool) apply_filters( 'customify_dashboard_pro_active', false ),
		/**
		 * Reveal the Starter Templates tab + activation flow (FameThemes
		 * Demo Importer install/activate CTA). Gated off by default so the
		 * tab + submenu are hidden; flip on via the
		 * `CUSTOMIFY_USE_STARTER_TEMPLATES` constant in wp-config.php for
		 * internal dev/QA, or hook the filter for programmatic control.
		 */
		'useStarterTemplates' => customify_dashboard_v2_use_starter_templates(),
	);

	/**
	 * Filter the dashboard boot payload before it ships to JS.
	 *
	 * @param array  $boot    Boot data.
	 * @param string $context Context (currently always 'dashboard').
	 */
	return (array) apply_filters( 'customify_dashboard_localize', $boot, 'dashboard' );
}

/**
 * Parse the changelog.txt file into a list of releases consumable by
 * the kit's `ReleaseBlock`.
 *
 * @param string $current_version Current theme version (marks the
 *                                matching release with the Current pill).
 * @return array<int, array<string, mixed>>
 */
function customify_dashboard_v2_changelog( string $current_version ): array {
	$file = get_template_directory() . '/changelog.txt';
	if ( ! file_exists( $file ) ) {
		return array();
	}
	$contents = file_get_contents( $file );
	if ( ! $contents ) {
		return array();
	}

	$releases = array();
	$current  = null;
	$category_map = array(
		'new'      => 'new',
		'added'    => 'new',
		'improved' => 'improved',
		'improve'  => 'improved',
		'fixed'    => 'fixed',
		'fix'      => 'fixed',
		'updated'  => 'updated',
		'update'   => 'updated',
		'removed'  => 'removed',
		'remove'   => 'removed',
		'security' => 'security',
	);

	foreach ( preg_split( '/\r?\n/', $contents ) as $line ) {
		$line = trim( $line );
		if ( '' === $line ) {
			continue;
		}
		if ( preg_match( '/^=\s*([0-9][0-9A-Za-z\.\-]*)\s*=$/', $line, $m ) ) {
			if ( $current ) {
				$releases[] = $current;
			}
			$version = $m[1];
			$current = array(
				'version' => $version,
				'current' => version_compare( $version, $current_version, '==' ),
				'items'   => array(),
			);
			continue;
		}
		if ( ! $current ) {
			continue;
		}
		if ( preg_match( '/^\*\s*([A-Za-z]+)\s*:\s*(.+)$/', $line, $m ) ) {
			$tag = strtolower( $m[1] );
			$tone = $category_map[ $tag ] ?? 'neutral';
			$current['items'][] = array(
				'category' => $tone,
				'text'     => $m[2],
			);
		} elseif ( preg_match( '/^\*\s*(.+)$/', $line, $m ) ) {
			$current['items'][] = array(
				'category' => 'neutral',
				'text'     => $m[1],
			);
		}
	}
	if ( $current ) {
		$releases[] = $current;
	}

	return $releases;
}

/**
 * Enqueue the SPA bundle on the dashboard admin page.
 *
 * @param string $hook Current admin page hook.
 */
function customify_dashboard_v2_enqueue( string $hook ): void {
	if ( 'toplevel_page_' . CUSTOMIFY_DASHBOARD_V2_SLUG !== $hook ) {
		return;
	}
	AssetEnqueue::enqueueOn(
		$hook,
		array(
			'handle'      => CUSTOMIFY_DASHBOARD_V2_HANDLE,
			'src_js'      => get_template_directory_uri() . '/build/js/backend/admin/dashboard-v2.js',
			'src_css'     => get_template_directory_uri() . '/build/css/backend/admin/dashboard-v2.css',
			'asset_php'   => get_template_directory() . '/build/js/backend/admin/dashboard-v2.asset.php',
			'boot_global' => 'customifyDashboard',
			'boot_data'   => 'customify_dashboard_v2_boot_data',
			'text_domain' => 'customify',
		)
	);

	// wp-scripts splits any `import 'pkg/style.css'` into a `style-`
	// prefixed sibling output (its block-style convention). The kit ships
	// its tokens + component CSS through this path, so we enqueue the
	// sibling chunk alongside the main bundle so kit components render
	// styled.
	$kit_css_path = get_template_directory() . '/build/css/backend/admin/style-dashboard-v2.css';
	if ( file_exists( $kit_css_path ) ) {
		$theme_version = wp_get_theme()->get( 'Version' );
		wp_enqueue_style(
			CUSTOMIFY_DASHBOARD_V2_HANDLE . '-kit',
			get_template_directory_uri() . '/build/css/backend/admin/style-dashboard-v2.css',
			array(),
			$theme_version . '-' . filemtime( $kit_css_path )
		);
	}
}
add_action( 'admin_enqueue_scripts', 'customify_dashboard_v2_enqueue' );
