<?php
namespace Clusterlane\Admin;
if ( ! defined( 'ABSPATH' ) ) exit;

// phpcs:disable WordPress.DB.DirectDatabaseQuery
// -- Clusterlane's own tables and set-based reads of posts/terms that no WordPress API covers.
//    Every query goes through $wpdb->prepare(): values and ID lists as placeholders, table and
//    column names as %i. Fragments added to a query are code (Scope::sql()) or are prepared
//    where they are built (Scope::type_sql(), Lang::sql(), SeoMeta joins).

/**
 * Admin
 *
 * Registers admin menus and enqueues admin assets.
 */
class Admin {

    public function __construct( private \Clusterlane\Core\Plugin $plugin ) {}

    public function register(): void {
        add_action( 'admin_menu',            [ $this, 'register_menu'  ] );
        add_action( 'admin_menu',            [ $this, 'group_menu' ], 999 );
        add_action( 'admin_enqueue_scripts', [ $this, 'menu_assets' ] );
        add_action( 'admin_enqueue_scripts', [ $this, 'enqueue_assets' ] );
        add_action( 'admin_init',            [ $this, 'handle_settings_save' ], 1 );
    }

    public function handle_settings_save(): void {
        if ( ! isset( $_POST['clusterlane_save_settings'] ) ) return;
        if ( ! check_admin_referer( 'clusterlane_settings_save' ) ) return;
        if ( ! \Clusterlane\Core\Capabilities::can_manage() ) return;

        require_once \CLUSTERLANE_DIR . 'intelligence/admin/class-settings-page.php';
        $page = new \Clusterlane\Admin\SettingsPage( $this->plugin );
        $page->handle_save();

        $args = [ 'settings-updated' => '1' ];
        if ( $page->recomputed ) $args['recomputed'] = '1';
        $tab = sanitize_key( $_POST['clusterlane_tab'] ?? '' );
        if ( in_array( $tab, [ 'general', 'content', 'styles', 'advanced' ], true ) ) $args['tab'] = $tab;   // come back to the same tab
        wp_safe_redirect( add_query_arg( $args, admin_url( 'admin.php?page=clusterlane-settings' ) ) );
        exit;
    }

    public function register_menu(): void {
        // The station mark (as on clusterlane.app), or the white-label logo — see Brand.
        $icon_url = \Clusterlane\Core\Brand::menu_icon();

        add_menu_page(
            \Clusterlane\Core\Brand::name(),
            \Clusterlane\Core\Brand::name(),
            \Clusterlane\Core\Capabilities::USE,
            'clusterlane-dashboard',
            [ $this, 'render_dashboard' ],
            $icon_url,
            30
        );

        add_submenu_page( 'clusterlane-dashboard',
            __( 'Dashboard', 'clusterlane' ), __( 'Dashboard', 'clusterlane' ),
            \Clusterlane\Core\Capabilities::USE, 'clusterlane-dashboard', [ $this, 'render_dashboard' ]
        );

        add_submenu_page( 'clusterlane-dashboard',
            __( 'Cluster Inspector', 'clusterlane' ), __( 'Cluster Inspector', 'clusterlane' ),
            \Clusterlane\Core\Capabilities::USE, 'clusterlane-cluster-inspector', [ $this, 'render_cluster_inspector' ]
        );

        add_submenu_page( 'clusterlane-dashboard',
            __( 'Article Inspector', 'clusterlane' ), __( 'Article Inspector', 'clusterlane' ),
            \Clusterlane\Core\Capabilities::USE, 'clusterlane-article-inspector', [ $this, 'render_article_inspector' ]
        );

        add_submenu_page( 'clusterlane-dashboard',
            __( 'Text Match', 'clusterlane' ), __( 'Text Match', 'clusterlane' ),
            \Clusterlane\Core\Capabilities::USE, 'clusterlane-text-match', [ $this, 'render_text_match' ]
        );

        add_submenu_page( 'clusterlane-dashboard',
            __( 'Link Suggestions', 'clusterlane' ), __( 'Link Suggestions', 'clusterlane' ),
            \Clusterlane\Core\Capabilities::USE, 'clusterlane-link-suggest', [ $this, 'render_link_suggest' ]
        );

        add_submenu_page( 'clusterlane-dashboard',
            __( 'SEO Titles', 'clusterlane' ), __( 'SEO Titles', 'clusterlane' ),
            \Clusterlane\Core\Capabilities::USE, 'clusterlane-seo-titles', [ $this, 'render_seo_titles' ]
        );

        add_submenu_page( 'clusterlane-dashboard',
            __( 'Report', 'clusterlane' ), __( 'Report', 'clusterlane' ),
            \Clusterlane\Core\Capabilities::USE, 'clusterlane-report', [ $this, 'render_report' ]
        );

        add_submenu_page( 'clusterlane-dashboard',
            __( 'Cluster Admin', 'clusterlane' ), __( 'Cluster Admin', 'clusterlane' ),
            \Clusterlane\Core\Capabilities::MANAGE, 'clusterlane-cluster-settings', [ $this, 'render_cluster_settings' ]
        );

        add_submenu_page( 'clusterlane-dashboard',
            __( 'Settings', 'clusterlane' ), __( 'Settings', 'clusterlane' ),
            \Clusterlane\Core\Capabilities::MANAGE, 'clusterlane-settings', [ $this, 'render_settings' ]
        );

        add_submenu_page( 'clusterlane-dashboard',
            __( 'Help', 'clusterlane' ), __( 'Help', 'clusterlane' ),
            \Clusterlane\Core\Capabilities::USE, 'clusterlane-help', [ $this, 'render_help' ]
        );
    }

    /**
     * Left menu in groups (0.98.146): the pages used most on top, then
     * TOOLS and ADMIN as small labels, the way WordPress plugins group a long
     * submenu (submenus have one level — no icons or indents). A label only
     * shows to users who can open a page under it; items other code added
     * keep their place at the end.
     */
    public function group_menu(): void {
        global $submenu;
        if ( empty( $submenu['clusterlane-dashboard'] ) ) return;
        $items = [];
        foreach ( $submenu['clusterlane-dashboard'] as $it ) $items[ $it[2] ] = $it;
        $label = static fn( string $text, string $cap, string $id ) => [ '<span class="clusterlane-menu-group-label">' . esc_html( $text ) . '</span>', $cap, '#' . $id, '', 'clusterlane-menu-group' ];
        $order = [
            'clusterlane-dashboard', 'clusterlane-cluster-inspector', 'clusterlane-article-inspector', 'clusterlane-report', 'clusterlane-help',
            $label( __( 'Tools', 'clusterlane' ), \Clusterlane\Core\Capabilities::USE, 'clusterlane-group-tools' ),
            'clusterlane-text-match', 'clusterlane-link-suggest', 'clusterlane-seo-titles',
            $label( __( 'Admin', 'clusterlane' ), \Clusterlane\Core\Capabilities::MANAGE, 'clusterlane-group-admin' ),
            'clusterlane-cluster-settings', 'clusterlane-settings',
        ];
        $out = [];
        foreach ( $order as $o ) {
            if ( is_array( $o ) ) { $out[] = $o; continue; }
            if ( isset( $items[ $o ] ) ) { $out[] = $items[ $o ]; unset( $items[ $o ] ); }
        }
        $submenu['clusterlane-dashboard'] = array_merge( $out, array_values( $items ) ); // phpcs:ignore WordPress.WP.GlobalVariablesOverride.Prohibited -- reordering our own submenu
    }

    /**
     * The group labels in the admin menu (Tools, Admin) — on every admin page,
     * where the menu is: their style goes with the core menu stylesheet, and
     * the script that takes them out of the tab order (no href, read as a
     * group heading) runs in the footer, after the menu.
     */
    public function menu_assets(): void {
        wp_add_inline_style( 'admin-menu',
            '#adminmenu .clusterlane-menu-group a{pointer-events:none;cursor:default;padding-top:10px !important;padding-bottom:2px !important;box-shadow:none !important}'
            . '#adminmenu .clusterlane-menu-group-label{font-size:10.5px;font-weight:600;letter-spacing:.06em;text-transform:uppercase;opacity:.6}'
            . '#adminmenu .wp-submenu .clusterlane-menu-group a:hover,#adminmenu .wp-submenu .clusterlane-menu-group a:focus{color:inherit;background:none}'
        );
        wp_register_script( 'clusterlane-menu', false, [], CLUSTERLANE_VERSION, true );
        wp_enqueue_script( 'clusterlane-menu' );
        wp_add_inline_script( 'clusterlane-menu',
            "document.querySelectorAll('#adminmenu .clusterlane-menu-group a').forEach(function(a){a.removeAttribute('href');a.setAttribute('role','heading');a.setAttribute('aria-level','3');a.tabIndex=-1;});"
        );
    }

    /**
     * admin.min.css (built from admin.css with clean-css, level 1) unless
     * SCRIPT_DEBUG is on or the minified file is missing — then the source.
     */
    private static function admin_css(): string {
        $min = ! ( defined( 'SCRIPT_DEBUG' ) && SCRIPT_DEBUG ) && is_readable( CLUSTERLANE_DIR . 'admin/css/admin.min.css' );
        return $min ? 'admin/css/admin.min.css' : 'admin/css/admin.css';
    }

    /**
     * Onboarding step 2 (0.98.177): post types with published pages (pre-ticked:
     * the scanned ones and any with 5+ pages, pages aside), whether their text has
     * links, and cluster candidates from categories and every other hierarchical
     * taxonomy of that content (2+ pages each).
     *
     * @return array{types: array<int, array{name: string, label: string, count: int, checked: bool, recommended: bool}>, groups: array<int, array{taxonomy: string, label: string, types: string[], terms: array<int, array{id: int, name: string, count: int}>}>, hubs: array<int, array{type: string, singular: string, label: string, pages: int, with: string[], types: string[], checked: bool}>}
     */
    private function onboarding_data( \Clusterlane\Core\Settings $settings ): array {
        $objs = get_post_types( [ 'public' => true ], 'objects' ) + get_post_types( [ 'publicly_queryable' => true ], 'objects' );
        unset( $objs['attachment'] );
        $counts  = \Clusterlane\Core\PageReader::text_link_density( array_keys( $objs ) );
        $scanned = $settings->post_types();
        $types   = [];
        foreach ( $objs as $name => $o ) {
            $n = (int) ( $counts[ $name ]['posts'] ?? 0 );
            if ( ! $n ) continue;
            $types[] = [
                'name'        => $name,
                'label'       => html_entity_decode( (string) $o->labels->name, ENT_QUOTES, 'UTF-8' ),
                'count'       => $n,
                'checked'     => in_array( $name, $scanned, true ) || ( $name !== 'page' && $n >= 5 ),
                'recommended' => \Clusterlane\Core\PageReader::is_recommended( $counts[ $name ] ),
            ];
        }
        usort( $types, fn( $a, $b ) => ( $a['name'] === 'post' ? -1 : ( $b['name'] === 'post' ? 1 : 0 ) ) ?: $b['count'] <=> $a['count'] );

        $groups = [];
        $taxes  = [ 'category' => get_taxonomy( 'category' ) ] + array_filter( \Clusterlane\Core\ClusterTypes::extra_taxonomies( array_keys( $objs ) ), fn( $t ) => $t->hierarchical );
        foreach ( $taxes as $tax => $obj ) {
            if ( ! $obj ) continue;
            $terms = get_terms( [ 'taxonomy' => $tax, 'hide_empty' => true, 'orderby' => 'count', 'order' => 'DESC', 'number' => 200 ] );
            if ( is_wp_error( $terms ) ) continue;
            $list = [];
            foreach ( $terms as $t ) {
                if ( (int) $t->count < 2 || ( $tax === 'category' && (int) $t->term_id === (int) get_option( 'default_category' ) && (int) $t->count < 5 ) ) continue;
                // Pre-ticked (0.98.185): the 15 largest categories with 3+ pages, so
                // "Save & continue" never gives an empty map by accident.
                $pick   = $tax === 'category' && (int) $t->count >= 3 && count( array_filter( $list, fn( $x ) => $x['checked'] ) ) < 15;
                $list[] = [ 'id' => (int) $t->term_id, 'name' => html_entity_decode( $t->name, ENT_QUOTES, 'UTF-8' ), 'count' => (int) $t->count, 'checked' => $pick ];
            }
            if ( ! $list ) continue;
            usort( $list, fn( $a, $b ) => strcasecmp( $a['name'], $b['name'] ) );
            $groups[] = [
                'taxonomy' => $tax,
                'label'    => html_entity_decode( (string) $obj->labels->name, ENT_QUOTES, 'UTF-8' ),
                'types'    => array_values( (array) $obj->object_type ),
                'terms'    => $list,
            ];
        }
        // Two taxonomies both called "Categories" (posts and a custom type):
        // name the content they belong to, "Categories · Attractions".
        if ( count( $groups ) > 1 ) {
            $labels = [];
            foreach ( $types as $t ) $labels[ $t['name'] ] = $t['label'];
            foreach ( $groups as &$g ) {
                $of = array_values( array_filter( array_map( fn( $pt ) => $labels[ $pt ] ?? '', $g['types'] ) ) );
                if ( $of ) $g['label'] .= ' · ' . implode( ', ', $of );
            }
            unset( $g );
        }
        // Pages as clusters (0.98.180): post types the others point to through custom fields.
        $labels = [];
        foreach ( $types as $t ) $labels[ $t['name'] ] = $t['label'];
        $hubs  = [];
        $cands = \Clusterlane\Core\HubClusters::candidates( array_keys( $objs ) );
        foreach ( $cands as $pt => $c ) {
            $from = [];
            foreach ( $c['paths'] as $p ) $from[ $p['from'] ] = true;
            // Ticked from the start: the top of the hierarchy (islands), not what points to it (areas).
            $top = true;
            foreach ( $cands as $other => $oc ) {
                foreach ( $oc['paths'] as $p ) if ( $other !== $pt && $p['from'] === $pt && ! isset( $p['via'] ) ) $top = false;
            }
            $names = array_values( array_filter( array_map( fn( $t ) => $labels[ $t ] ?? '', array_keys( $from ) ) ) );
            $hubs[] = [ 'type' => $pt, 'singular' => $c['singular'], 'label' => $c['label'], 'pages' => $c['pages'], 'with' => $names, 'types' => array_merge( [ $pt ], array_keys( $from ) ), 'checked' => $top ];
        }
        return [ 'types' => $types, 'groups' => $groups, 'hubs' => $hubs ];
    }

    public function enqueue_assets( string $hook ): void {
        if ( strpos( $hook, 'clusterlane-' ) === false ) return;

        // Network Admin overview: styles only — the site scripts and their
        // clusterlaneData belong to a single site's admin, not the network.
        if ( is_network_admin() ) {
            wp_enqueue_style( 'clusterlane-admin', CLUSTERLANE_URL . self::admin_css(), [], CLUSTERLANE_VERSION );
            return;
        }

        // "?" tooltips — loaded in <head> so every page script can call
        // window.clusterlaneTip() while rendering. Definitions: clusterlane_tip_definitions().
        wp_enqueue_script( 'clusterlane-tips', CLUSTERLANE_URL . 'admin/js/clusterlane-tips.js', [], CLUSTERLANE_VERSION, false );

        // Edition (Free/Pro/Agency) — also in <head> so page scripts can ask
        // clusterlaneHas( 'ai' ). Free gets the example data shown instead of AI output.
        require_once CLUSTERLANE_DIR . 'intelligence/admin/class-pro-examples.php';
        wp_enqueue_script( 'clusterlane-edition', CLUSTERLANE_URL . 'admin/js/clusterlane-edition.js', [], CLUSTERLANE_VERSION, false );
        wp_localize_script( 'clusterlane-edition', 'clusterlaneBrand', \Clusterlane\Core\Brand::to_js() );
        wp_localize_script( 'clusterlane-edition', 'clusterlaneClusterTypes', \Clusterlane\Core\ClusterTypes::for_js() ); // 0.98.177: labels for any taxonomy
        wp_localize_script( 'clusterlane-edition', 'clusterlaneEditionData', array_merge( \Clusterlane\Core\Edition::for_js(), [
            'labels'   => \Clusterlane\Admin\ProExamples::labels(),
            'can'      => \Clusterlane\Core\Capabilities::for_js() + [
                'linksNote' => \Clusterlane\Core\Capabilities::no_right_message( \Clusterlane\Core\Capabilities::LINKS ),
                'seoNote'   => \Clusterlane\Core\Capabilities::no_right_message( \Clusterlane\Core\Capabilities::SEO ),
            ],
            'examples' => \Clusterlane\Core\Edition::has( 'ai' ) ? new \stdClass() : \Clusterlane\Admin\ProExamples::data(),
        ] ) );
        wp_localize_script( 'clusterlane-tips', 'clusterlaneTipsData', [
            'defs'   => clusterlane_tip_definitions(),
            'glyphs' => clusterlane_glyph_paths(),
            'thumbs' => \Clusterlane\Core\Thumbs::enabled() ? 1 : 0,
            'labels' => [
                'good' => __( 'Good:', 'clusterlane' ),
                'fix'  => __( 'Improve:', 'clusterlane' ),
                /* translators: %s: term */
                'what' => __( 'What is %s?', 'clusterlane' ),
            ],
        ] );

        $settings = $this->plugin->get( 'settings' );

        // Onboarding trigger — computed here so wp_localize_script can use it.
        $show_onboarding = false;
        $ob_categories   = [];
        $is_dashboard    = strpos( $hook, 'clusterlane-dashboard' ) !== false || strpos( $hook, 'toplevel_page_clusterlane' ) !== false;
        if ( $is_dashboard && $settings && \Clusterlane\Core\Capabilities::can_manage() && ! $settings->cluster_terms_configured() ) {
            $scanner = $this->plugin->get( 'scanner' );
            $summary = $scanner ? $scanner->get_summary() : [];
            if ( ( (int) ( $summary['total_scanned'] ?? 0 ) ) === 0 ) {
                $show_onboarding = true;
                $terms = get_categories( [ 'hide_empty' => true, 'orderby' => 'name', 'order' => 'ASC', 'number' => 200 ] );
                if ( ! is_wp_error( $terms ) ) {
                    foreach ( $terms as $t ) {
                        if ( (int) ( $t->count ?? 0 ) >= 2 ) {
                            $ob_categories[] = [ 'id' => (int) $t->term_id, 'name' => html_entity_decode( $t->name, ENT_QUOTES ), 'count' => (int) $t->count ];
                        }
                    }
                }
            }
        }

        wp_enqueue_style( 'clusterlane-admin', CLUSTERLANE_URL . self::admin_css(), [], CLUSTERLANE_VERSION );

        // Sticky bar — loaded on every Clusterlane page.
        wp_enqueue_script( 'clusterlane-sticky-bar', CLUSTERLANE_URL . 'admin/js/clusterlane-sticky-bar.js', [], CLUSTERLANE_VERSION, true );
        wp_localize_script( 'clusterlane-sticky-bar', 'clusterlaneStickyBar', [
            'restUrl'            => esc_url_raw( rest_url( 'clusterlane/v1/' ) ),
            'nonce'              => wp_create_nonce( 'wp_rest' ),
            'articleInspectorUrl'=> esc_url_raw( admin_url( 'admin.php?page=clusterlane-article-inspector' ) ),
            'clusterInspectorUrl'=> esc_url_raw( admin_url( 'admin.php?page=clusterlane-cluster-inspector' ) ),
            'batchSize'          => (int) ( $settings ? $settings->get( 'batch_size', 25 ) : 25 ),
            'siteName'           => get_bloginfo( 'name' ),
            'pages'              => \Clusterlane\Core\PageReader::status(), // published pages still to read (0.98.178)
        ] );

        // vis-network 9.1.2 (minified, bundled — WordPress.org doesn't allow
        // loading scripts from other servers, so there is no CDN fallback).
        // The file once shipped as 0 bytes after a zip round-trip, which left
        // the graphs stuck on "Loading graph…" — so a broken copy raises a
        // clear admin notice instead of failing silently.
        $vis_path = CLUSTERLANE_DIR . 'admin/js/clusterlane-graph-lib.js';
        wp_register_script( 'clusterlane-vis', CLUSTERLANE_URL . 'admin/js/clusterlane-graph-lib.js', [], '9.1.2', true );
        if ( ! is_readable( $vis_path ) || (int) filesize( $vis_path ) < 100 * 1024 ) {
            add_action( 'admin_notices', function () {
                if ( ! current_user_can( 'manage_options' ) ) return;
                echo '<div class="notice notice-error"><p><strong>' . esc_html( \Clusterlane\Core\Brand::name() ) . ':</strong> '
                    . esc_html__( 'the bundled graph library (admin/js/clusterlane-graph-lib.js) is missing or incomplete, so graphs cannot be drawn. Upload the plugin again to restore it.', 'clusterlane' )
                    . '</p></div>';
            } );
        }

        // dashboard.js only on non-inspector pages; inspector has its own
        // clusterlaneData and doesn't need the dashboard init code running.
        if ( strpos( $hook, 'clusterlane-article-inspector' ) === false && strpos( $hook, 'clusterlane-cluster-inspector' ) === false ) {
            wp_enqueue_script( 'clusterlane-admin', CLUSTERLANE_URL . 'admin/js/dashboard.js',
                ['clusterlane-vis'],
                CLUSTERLANE_VERSION,
                true
            );
        } else {
            // On the inspector page we still need vis-network — enqueue it directly.
            wp_enqueue_script( 'clusterlane-vis' );
        }

        // Cluster quick view (0.98.200) — the eye button in Report's cluster table and the Cluster Inspector list.
        if ( strpos( $hook, 'clusterlane-report' ) !== false || strpos( $hook, 'clusterlane-cluster-inspector' ) !== false ) {
            wp_enqueue_script( 'clusterlane-cluster-quick', CLUSTERLANE_URL . 'admin/js/clusterlane-cluster-quick.js', [ 'clusterlane-tips' ], CLUSTERLANE_VERSION, true );
            wp_localize_script( 'clusterlane-cluster-quick', 'clusterlaneQuickData', [
                'rest'         => esc_url_raw( rest_url( 'clusterlane/v1/' ) ),
                'nonce'        => wp_create_nonce( 'wp_rest' ),
                'inspectorUrl' => esc_url_raw( admin_url( 'admin.php?page=clusterlane-cluster-inspector' ) ),
            ] );
        }

        // Report — Print button, "Show all clusters" and (Pro) the AI summary.
        if ( strpos( $hook, 'clusterlane-report' ) !== false ) {
            wp_enqueue_script( 'clusterlane-report', CLUSTERLANE_URL . 'admin/js/report.js', [ 'clusterlane-edition' ], CLUSTERLANE_VERSION, true );
            wp_localize_script( 'clusterlane-report', 'clusterlaneReport', [
                'restUrl'     => esc_url_raw( rest_url( 'clusterlane/v1/' ) ),
                'nonce'       => wp_create_nonce( 'wp_rest' ),
                'settingsUrl' => esc_url_raw( admin_url( 'admin.php?page=clusterlane-settings' ) ),
                'canManage'   => (int) \Clusterlane\Core\Capabilities::can_manage(),
                'labels'      => [
                    'less'    => __( 'Show fewer clusters', 'clusterlane' ),
                    'write'   => __( 'Write summary with AI', 'clusterlane' ),
                    'rewrite' => __( 'Write again', 'clusterlane' ),
                    'writing' => __( 'Writing…', 'clusterlane' ),
                    'failed'  => __( 'The summary could not be written.', 'clusterlane' ),
                    'toSettings' => __( 'Go to Settings →', 'clusterlane' ),
                    /* translators: 1: model name, 2: date and time */
                    'meta'    => __( 'Written by %1$s · %2$s', 'clusterlane' ),
                    'stale'   => __( 'The figures have changed since — write it again for an up-to-date summary.', 'clusterlane' ),
                ],
            ] );
        }

        // Settings — tabs + save bar.
        if ( strpos( $hook, 'clusterlane-settings' ) !== false ) {
            wp_enqueue_script( 'clusterlane-settings-page', CLUSTERLANE_URL . 'admin/js/settings-page.js', [], CLUSTERLANE_VERSION, true );
        }

        // Cluster Admin — save bar + custom cluster editor.
        if ( strpos( $hook, 'clusterlane-cluster-settings' ) !== false ) {
            wp_enqueue_script( 'clusterlane-cluster-admin', CLUSTERLANE_URL . 'admin/js/cluster-admin.js', [ 'clusterlane-admin' ], CLUSTERLANE_VERSION, true );
            wp_add_inline_script( 'clusterlane-cluster-admin', 'window.clusterlaneData = window.clusterlaneData || {}; clusterlaneData.adminUrl = ' . wp_json_encode( admin_url() ) . ';', 'before' );
            wp_enqueue_script( 'clusterlane-cluster-review', CLUSTERLANE_URL . 'admin/js/cluster-review.js', [ 'clusterlane-edition' ], CLUSTERLANE_VERSION, true );
            wp_localize_script( 'clusterlane-cluster-review', 'clusterlaneReview', [
                'restUrl' => esc_url_raw( rest_url( 'clusterlane/v1/' ) ),
                'nonce'   => wp_create_nonce( 'wp_rest' ),
                'ciUrl'   => esc_url_raw( admin_url( 'admin.php?page=clusterlane-cluster-inspector' ) ),
            ] );
        }

        // Text Match Scanner — only load on TMS page.
        if ( strpos( $hook, 'clusterlane-text-match' ) !== false ) {
            wp_enqueue_script( 'clusterlane-tms', CLUSTERLANE_URL . 'admin/js/text-match.js',
                [], CLUSTERLANE_VERSION, true );
            wp_localize_script( 'clusterlane-tms', 'clusterlaneData', [
                'restUrl'    => esc_url_raw( rest_url( 'clusterlane/v1/' ) ),
                'nonce'      => wp_create_nonce( 'wp_rest' ),
                'version'    => CLUSTERLANE_VERSION,
                'settingsUrl'=> esc_url_raw( admin_url( 'admin.php?page=clusterlane-settings' ) ),
                'canManage'  => (int) \Clusterlane\Core\Capabilities::can_manage(),
                'adminUrl'   => esc_url_raw( admin_url() ),
                'skipped'    => (int) $GLOBALS['wpdb']->get_var( "SELECT COUNT(*) FROM {$GLOBALS['wpdb']->prefix}clusterlane_tms_skipped" ), // phpcs:ignore
                'categories' => ( function() {
                    global $wpdb;
                    $rows = $wpdb->get_results(
                        "SELECT t.term_id AS id, t.name, tt.count
                         FROM {$wpdb->terms} t
                         INNER JOIN {$wpdb->term_taxonomy} tt ON tt.term_id = t.term_id
                         WHERE tt.taxonomy = 'category' AND tt.count > 0
                         ORDER BY t.name ASC
                         LIMIT 200"
                    );
                    return array_map( fn( $r ) => [
                        'id'    => (int) $r->id,
                        'name'  => html_entity_decode( $r->name, ENT_QUOTES, 'UTF-8' ),
                        'count' => (int) $r->count,
                    ], $rows );
                } )(),
            ] );
        }

        // Cluster Inspector — only load on its own page.
        if ( strpos( $hook, 'clusterlane-cluster-inspector' ) !== false ) {
            wp_enqueue_script( 'clusterlane-vis' );
            wp_enqueue_script( 'clusterlane-cluster-inspector',
                CLUSTERLANE_URL . 'admin/js/cluster-inspector.js',
                [ 'clusterlane-vis' ], CLUSTERLANE_VERSION, true );
            wp_enqueue_script( 'clusterlane-cluster-split', CLUSTERLANE_URL . 'admin/js/cluster-split.js', [ 'clusterlane-cluster-inspector' ], CLUSTERLANE_VERSION, true );
            wp_localize_script( 'clusterlane-cluster-inspector', 'clusterlaneData', [
                'restUrl'             => esc_url_raw( rest_url( 'clusterlane/v1/' ) ),
                'nonce'               => wp_create_nonce( 'wp_rest' ),
                'version'             => CLUSTERLANE_VERSION,
                'inspectorUrl'        => esc_url_raw( admin_url( 'admin.php?page=clusterlane-article-inspector' ) ),
                'titleTrunc'          => $settings ? $settings->title_truncation() : 'none',
                'titleTruncCustom'    => $settings ? $settings->title_truncation_custom() : '',
                'settingsUrl'         => esc_url_raw( admin_url( 'admin.php?page=clusterlane-settings' ) ),
                'canManage'           => (int) \Clusterlane\Core\Capabilities::can_manage(),
                'linkTemplates'       => array_map(
                    fn( $t ) => [ 'id' => $t['id'], 'name' => $t['name'] ],
                    ( $settings ? $settings->link_templates() : [] )
                ),
            ] );
        }

        // SEO Titles (0.98.154) — clusterlaneData comes from clusterlane-admin below (restUrl, nonce, titleTrunc …).
        if ( strpos( $hook, 'clusterlane-seo-titles' ) !== false ) {
            wp_enqueue_script( 'clusterlane-seo-titles', CLUSTERLANE_URL . 'admin/js/seo-titles.js', [ 'clusterlane-admin' ], CLUSTERLANE_VERSION, true );
        }

        // Article Inspector — only load on its own page.
        if ( strpos( $hook, 'clusterlane-article-inspector' ) !== false ) {
            wp_enqueue_script( 'clusterlane-article-inspector',
                CLUSTERLANE_URL . 'admin/js/article-inspector.js',
                [ 'clusterlane-vis' ], CLUSTERLANE_VERSION, true );
            wp_localize_script( 'clusterlane-article-inspector', 'clusterlaneData', [
                'restUrl'             => esc_url_raw( rest_url( 'clusterlane/v1/' ) ),
                'nonce'               => wp_create_nonce( 'wp_rest' ),
                'version'             => CLUSTERLANE_VERSION,
                'titleTrunc'          => $settings ? $settings->title_truncation() : 'none',
                'titleTruncCustom'    => $settings ? $settings->title_truncation_custom() : '',
                'clusterInspectorUrl' => esc_url_raw( admin_url( 'admin.php?page=clusterlane-cluster-inspector' ) ),
                'settingsUrl'         => esc_url_raw( admin_url( 'admin.php?page=clusterlane-settings' ) ),
                'linkSuggestUrl'      => esc_url_raw( admin_url( 'admin.php?page=clusterlane-link-suggest' ) ),
                'clusterAdminUrl'     => esc_url_raw( admin_url( 'admin.php?page=clusterlane-cluster-settings' ) ),
                'canManage'           => (int) \Clusterlane\Core\Capabilities::can_manage(),
            ] );
        }

        wp_localize_script( 'clusterlane-admin', 'clusterlaneData', [
            'restUrl'             => esc_url_raw( rest_url( 'clusterlane/v1/' ) ),
            'nonce'               => wp_create_nonce( 'wp_rest' ),
            'version'             => CLUSTERLANE_VERSION,
            'clusterInspectorUrl' => esc_url_raw( admin_url( 'admin.php?page=clusterlane-cluster-inspector' ) ),
            'articleInspectorUrl' => esc_url_raw( admin_url( 'admin.php?page=clusterlane-article-inspector' ) ),
            'titleTrunc'          => $settings ? $settings->title_truncation() : 'none',
            'titleTruncCustom'    => $settings ? $settings->title_truncation_custom() : '',
            'onboarding'          => $show_onboarding,
            'canManage'           => (int) \Clusterlane\Core\Capabilities::can_manage(),
            'onboardingCategories'=> $ob_categories,
            'categories'   => ( function() {
                global $wpdb;
                $rows = $wpdb->get_results(
                    "SELECT t.term_id AS id, t.name, tt.count
                     FROM {$wpdb->terms} t
                     INNER JOIN {$wpdb->term_taxonomy} tt ON tt.term_id = t.term_id
                     WHERE tt.taxonomy = 'category' AND tt.count > 0
                     ORDER BY t.name ASC
                     LIMIT 200"
                );
                return array_map( fn( $r ) => [
                    'id'    => (int) $r->id,
                    'name'  => html_entity_decode( $r->name, ENT_QUOTES, 'UTF-8' ),
                    'count' => (int) $r->count,
                ], $rows );
            } )(),
            'themeStyleUrl'=> esc_url_raw( get_stylesheet_uri() ),
            'linkTemplates'=> array_map(
                fn( $t ) => [ 'id' => $t['id'], 'name' => $t['name'] ],
                ( $this->plugin->get('settings') ? $this->plugin->get('settings')->link_templates() : [] )
            ),
            'batchSize'   => (int) ( $this->plugin->get('settings') ? $this->plugin->get('settings')->get('batch_size', 25) : 25 ),
            'settingsUrl' => esc_url_raw( admin_url( 'admin.php?page=clusterlane-settings' ) ),
            'graphSettings' => array_merge( [
                'avoid_overlap'   => 1.1,
                'spring_length'   => 180,
                'central_gravity' => 0.12,
                'repulsion'       => 320,
                'iterations'      => 220,
                'graph_height'    => 420,
            ], (array) ( $this->plugin->get('settings') ? $this->plugin->get('settings')->get('graph_display', []) : [] ) ),
            'i18n'      => [
                'scanning' => __( 'Scanning…', 'clusterlane' ),
                'complete' => __( 'Scan complete', 'clusterlane' ),
                'error'    => __( 'Error — check console', 'clusterlane' ),
            ],
        ] );

        // Premium scripts (AI Link Suggestions, link modal, Link Card Templates, AI UI handlers).
        do_action( 'clusterlane_enqueue_assets', $hook, $this->plugin );
    }

    /* ------------------------------------------------------------------
       Shared sub-navigation bar (shown on every page except dashboard)
    ------------------------------------------------------------------ */

    private function render_subnav( string $active ): void {
        clusterlane_render_sticky_bar( $active );
    }

    /* ------------------------------------------------------------------
       Dashboard
    ------------------------------------------------------------------ */

    public function render_dashboard(): void {
        $settings    = $this->plugin->get('settings');
        $scanner     = $this->plugin->get('scanner');
        $engine      = $this->plugin->get('cluster_engine');
        $summary     = $scanner ? $scanner->get_summary() : [];
        $csumm       = $engine  ? $engine->get_summary()  : [];
        $clusters    = $engine  ? $engine->get_clusters()  : [];

        $th          = $settings ? $settings->get( 'thresholds', [] ) : [];
        $health_green  = (int) ( $th['health_green']  ?? 70 );
        $health_orange = (int) ( $th['health_orange'] ?? 50 );

        $total    = $summary['total_posts']   ?? 0;
        $scanned  = $summary['total_scanned'] ?? 0;
        $score    = $summary['avg_score']     ?? 0;
        $inbound  = $summary['avg_inbound']   ?? 0;
        $orphans  = $summary['orphan_count']  ?? 0;
        $last     = $summary['last_scan']     ?? null;

        $total_clusters = $csumm['total_clusters'] ?? 0;
        $avg_health     = $csumm['avg_health']     ?? 0;

        // Archetype distribution + a member-weighted health average for
        // the two new overview panels below (a 43-article cluster should
        // count for more than a 5-article one, unlike the simple
        // per-cluster average already shown in the KPI cards above).
        $arch_colors = [
            'Authority Pyramid'    => '#3b82f6',
            'Balanced Mesh'        => '#10b981',
            'Developed Cluster'    => '#0ea5e9',
            'Over-Centralized Hub' => '#ef4444',
            'Fragmented'           => '#f59e0b',
            'Weak Structure'       => '#8b5cf6',
            'Emerging Cluster'     => '#64748b',
            'Mixed'                => '#94a3b8',
            'Unclassified'         => '#cbd5e1', // never computed
        ];
        $arch_counts = array_fill_keys( array_keys( $arch_colors ), 0 );
        foreach ( $clusters as $c ) {
            $arch = $c->archetype ?: 'Unclassified';
            if ( isset( $arch_counts[ $arch ] ) ) $arch_counts[ $arch ]++;
        }
        $avg_cluster_health = \Clusterlane\Core\ClusterEngine::weighted_health( $clusters );

        $ring_color    = $avg_cluster_health >= 70 ? '#10b981' : ( $avg_cluster_health >= 50 ? '#f59e0b' : '#ef4444' );

        // Big ring for the hero (separate radius from the old standalone
        // panel version, which has been folded into the hero below).
        $hero_r             = 54;
        $hero_circumference = 2 * M_PI * $hero_r;
        $hero_dash_offset   = $hero_circumference - ( $avg_cluster_health / 100 ) * $hero_circumference;

        // Stacked-bar segments for the archetype mix — proportional to
        // the TOTAL cluster count (so segments sum to 100%), unlike the
        // old per-archetype mini bars which were each scaled to the
        // largest single archetype instead.
        $arch_total = array_sum( $arch_counts ) ?: 1;

        $ci_url  = admin_url( 'admin.php?page=clusterlane-cluster-inspector' );
        $ai_url  = admin_url( 'admin.php?page=clusterlane-article-inspector' );

        // Focus next on the Dashboard too (0.98.185) — the same pick as in Cluster
        // Inspector: clusters under 70% with 2+ articles, low health weighted by
        // size, plus 4 points per orphan. Dashboard is the start page, so the
        // next step belongs here as well.
        $focus = [];
        if ( $clusters ) {
            global $wpdb;
            $orph = [];
            foreach ( (array) $wpdb->get_results( "SELECT cluster_key, COUNT(*) AS n FROM {$wpdb->prefix}clusterlane_cluster_post_class WHERE content_class = 'orphan' GROUP BY cluster_key" ) as $r ) { // phpcs:ignore WordPress.DB.DirectDatabaseQuery
                $orph[ $r->cluster_key ] = (int) $r->n;
            }
            foreach ( $clusters as $c ) {
                $h = (int) $c->health_score; $m = (int) $c->total_members; $o = $orph[ $c->cluster_key ] ?? 0;
                if ( $h >= $health_green || $m < 2 || ! (int) ( $c->is_active ?? 1 ) ) continue;
                $focus[] = [ 'key' => $c->cluster_key, 'label' => $c->cluster_label, 'h' => $h, 'm' => $m, 'o' => $o, 'score' => ( $health_green - $h ) * log( $m + 1, 2 ) + $o * 4 ];
            }
            usort( $focus, fn( $a, $b ) => $b['score'] <=> $a['score'] ?: $a['h'] <=> $b['h'] );
            $focus = array_slice( $focus, 0, 3 );
        }
        $tms_url = admin_url( 'admin.php?page=clusterlane-text-match' );

        // Show first-run onboarding if never configured and nothing scanned yet.
        // Onboarding saves cluster config → admins (manage_clusterlane) only.
        $show_onboarding = \Clusterlane\Core\Capabilities::can_manage() && ! $settings->cluster_terms_configured() && $scanned === 0;
        $ob = $show_onboarding ? $this->onboarding_data( $settings ) : [ 'types' => [], 'groups' => [], 'hubs' => [] ];

        // 0.98.177: scanned post types with almost no links in their text whose
        // published pages are not read — the theme probably links them.
        $low_link = [];
        if ( $scanned > 0 && \Clusterlane\Core\Capabilities::can_manage() ) {
            foreach ( array_diff( \Clusterlane\Core\PageReader::recommended( $settings->post_types() ), $settings->rendered_types() ) as $pt ) {
                $obj = get_post_type_object( $pt );
                $low_link[] = $obj ? $obj->labels->name : $pt;
            }
        }
        ?>
        <div class="wrap clusterlane-wrap">
            <?php clusterlane_render_sticky_bar( 'dashboard' ); ?>
            <?php if ( $low_link ): ?>
            <div class="clusterlane-low-links" role="note">
                <?php clusterlane_glyph_e( 'link' ); ?>
                <p><strong><?php
                    /* translators: %s: post type names, e.g. "Attractions, Areas" */
                    echo esc_html( sprintf( __( '%s have almost no links in their text.', 'clusterlane' ), implode( ', ', $low_link ) ) );
                ?></strong> <?php esc_html_e( 'If your theme links them through lists, cards or related sections, Clusterlane only sees those links on the published page — until then they may show up as orphans.', 'clusterlane' ); ?>
                <a href="<?php echo esc_url( admin_url( 'admin.php?page=clusterlane-settings&tab=content#clusterlane-rendered-row' ) ); ?>"><?php esc_html_e( 'Read the published pages →', 'clusterlane' ); ?></a></p>
            </div>
            <?php endif; ?>

            <div class="clusterlane-hero">
                <div class="clusterlane-hero-top">
                    <div class="clusterlane-hero-title">
                        <span class="clusterlane-hero-mark"><?php \Clusterlane\Core\Brand::mark_e( 40, '#fff', \Clusterlane\Core\Brand::INK ); ?></span>
                        <div>
                            <h1><?php echo esc_html( \Clusterlane\Core\Brand::name() ); ?></h1>
                            <span class="clusterlane-hero-version">v<?php echo esc_html( CLUSTERLANE_VERSION ); ?></span>
                        </div>
                    </div>
                    <?php if ( $last ): ?>
                    <div class="clusterlane-hero-lastscan">
                        <?php $last_ts = strtotime( $last . ' +0000' ); printf( /* translators: %s: text */ esc_html__( 'Last scan: %s', 'clusterlane' ), esc_html( human_time_diff( $last_ts, time() ) . ' ago' ) ); ?>
                    </div>
                    <?php endif; ?>
                </div>

                <div class="clusterlane-hero-body">
                    <div class="clusterlane-hero-stats">
                        <?php // One figure when everything is scanned (0.98.187; "91 Total posts · 91 Scanned" said the same twice). ?>
                        <div class="clusterlane-hero-stat">
                            <span class="clusterlane-hero-stat-value"><?php echo esc_html( $scanned >= $total ? (string) $total : $scanned . ' / ' . $total ); ?></span>
                            <span class="clusterlane-hero-stat-label"><?php $scanned >= $total ? esc_html_e( 'Articles', 'clusterlane' ) : esc_html_e( 'Scanned', 'clusterlane' ); ?></span>
                        </div>
                        <div class="clusterlane-hero-stat">
                            <span class="clusterlane-hero-stat-value clusterlane-hero-stat-value--<?php echo $score >= 80 ? 'green' : ( $score >= 60 ? 'amber' : 'red' ); ?>"><?php echo esc_html( $score ); ?></span>
                            <span class="clusterlane-hero-stat-label"><?php esc_html_e( 'Avg score', 'clusterlane' ); ?><?php clusterlane_tip( 'avg_score' ); ?></span>
                        </div>
                        <div class="clusterlane-hero-stat">
                            <span class="clusterlane-hero-stat-value"><?php echo esc_html( $inbound ); ?></span>
                            <span class="clusterlane-hero-stat-label"><?php esc_html_e( 'Avg inbound', 'clusterlane' ); ?><?php clusterlane_tip( 'avg_inbound' ); ?></span>
                        </div>
                        <div class="clusterlane-hero-stat">
                            <span class="clusterlane-hero-stat-value clusterlane-hero-stat-value--<?php echo $orphans > 0 ? 'red' : 'green'; ?>"><?php echo esc_html( $orphans ); ?></span>
                            <span class="clusterlane-hero-stat-label"><?php esc_html_e( 'Orphans', 'clusterlane' ); ?><?php clusterlane_tip( 'orphans' ); ?></span>
                        </div>
                        <div class="clusterlane-hero-stat">
                            <span class="clusterlane-hero-stat-value"><?php echo esc_html( $total_clusters ); ?></span>
                            <span class="clusterlane-hero-stat-label"><?php esc_html_e( 'Clusters', 'clusterlane' ); ?></span>
                        </div>
                    </div>

                    <div class="clusterlane-hero-health">
                        <div class="clusterlane-hero-ring">
                            <svg width="132" height="132" viewBox="0 0 132 132">
                                <circle class="clusterlane-hero-ring-bg" cx="66" cy="66" r="<?php echo (int) $hero_r; ?>"/>
                                <circle class="clusterlane-hero-ring-fill"
                                    cx="66" cy="66" r="<?php echo (int) $hero_r; ?>"
                                    stroke="<?php echo esc_attr( $ring_color ); ?>"
                                    stroke-dasharray="<?php echo esc_attr( (string) round( $hero_circumference, 2 ) ); ?>"
                                    stroke-dashoffset="<?php echo esc_attr( (string) round( $hero_dash_offset, 2 ) ); ?>"/>
                            </svg>
                            <div class="clusterlane-hero-ring-label">
                                <span class="clusterlane-hero-ring-value" style="color:<?php echo esc_attr( $ring_color ); ?>"><?php echo (int) $avg_cluster_health; ?>%</span>
                                <span class="clusterlane-hero-ring-sub"><?php esc_html_e( 'health', 'clusterlane' ); ?></span>
                            </div>
                        </div>
                        <div class="clusterlane-hero-health-desc">
                            <?php clusterlane_tip( 'health' ); ?>
                            <?php
                            if ( $avg_cluster_health >= 70 )      esc_html_e( 'Clusters are well-structured.', 'clusterlane' );
                            elseif ( $avg_cluster_health >= 50 )  esc_html_e( 'Some clusters need attention — see Focus next below.', 'clusterlane' );
                            else                                  esc_html_e( 'Significant structural gaps.', 'clusterlane' );
                            ?>
                        </div>
                    </div>

                    <div class="clusterlane-hero-archetypes">
                        <div class="clusterlane-hero-archetypes-label"><?php esc_html_e( 'Archetype mix', 'clusterlane' ); ?><?php clusterlane_tip( 'archetype_mix' ); ?></div>
                        <div class="clusterlane-arch-stacked-bar">
                            <?php foreach ( $arch_counts as $arch => $count ):
                                if ( $count === 0 ) continue;
                                $color = $arch_colors[ $arch ] ?? '#777';
                                $pct   = round( ( $count / $arch_total ) * 100, 2 );
                            ?>
                            <div class="clusterlane-arch-seg" style="width:<?php echo esc_attr( (string) $pct ); ?>%;background:<?php echo esc_attr( $color ); ?>"
                                 title="<?php echo esc_attr( $arch . ': ' . $count ); ?>"></div>
                            <?php endforeach; ?>
                        </div>
                        <div class="clusterlane-arch-stacked-legend">
                            <?php foreach ( $arch_counts as $arch => $count ):
                                if ( $count === 0 ) continue;
                                $color = $arch_colors[ $arch ] ?? '#777';
                            ?>
                            <span class="clusterlane-arch-legend-item">
                                <span class="clusterlane-arch-dot" style="background:<?php echo esc_attr( $color ); ?>"></span>
                                <?php echo esc_html( $arch ); ?> <strong><?php echo (int) $count; ?></strong>
                            </span>
                            <?php endforeach; ?>
                        </div>
                    </div>
                </div>

            <?php if ( empty( $summary['total_scanned'] ) ): ?>
            <p class="clusterlane-hero-firstscan"><?php clusterlane_glyph_e( 'arrow' ); ?><?php esc_html_e( 'No articles scanned yet — click Scan in the bar above to start. It lists every article, measures it and builds your clusters.', 'clusterlane' ); ?></p>
            <?php endif; ?>

            </div><!-- /clusterlane-hero -->

            <?php if ( $clusters && $scanned > 0 ): ?>
            <!-- Focus next (0.98.185): the same three clusters as in Cluster Inspector; when none
                 is under the green line, say so (0.98.186) instead of leaving the card out. -->
            <section class="clusterlane-panel-card clusterlane-dash-focus" aria-labelledby="clusterlane-dash-focus-h">
                <div class="clusterlane-dash-focus__head">
                    <h2 id="clusterlane-dash-focus-h"><?php clusterlane_glyph_e( 'target' ); ?><?php esc_html_e( 'Focus next', 'clusterlane' ); ?><?php clusterlane_tip( 'focus_next' ); ?></h2>
                    <span class="clusterlane-tm-note"><?php esc_html_e( 'Clusters where a few links make the biggest difference', 'clusterlane' ); ?></span>
                </div>
                <?php if ( ! $focus ): ?>
                <p class="clusterlane-ci-focus-done"><?php clusterlane_glyph_e( 'check' ); ?><?php
                    /* translators: %d: health threshold, e.g. 70 */
                    echo esc_html( sprintf( __( 'All clusters are at %d%% health or more — nothing urgent. Cluster Inspector has the full list.', 'clusterlane' ), $health_green ) );
                ?></p>
                <?php endif; ?>
                <div class="clusterlane-ci-focus-grid">
                    <?php foreach ( $focus as $i => $f ):
                        $band = $f['h'] >= $health_green ? 'good' : ( $f['h'] >= $health_orange ? 'fair' : 'weak' );
                        /* translators: %d: number of articles */
                        $why = $f['o'] ? sprintf( _n( '%d article has no links pointing to it', '%d articles have no links pointing to them', $f['o'], 'clusterlane' ), $f['o'] ) : __( 'Its articles link to each other too little', 'clusterlane' );
                    ?>
                    <a class="clusterlane-ci-focus-card clusterlane-ci-detail-health--<?php echo esc_attr( $band ); ?>" href="<?php echo esc_url( add_query_arg( 'open', rawurlencode( $f['key'] ), $ci_url ) ); ?>">
                        <span class="clusterlane-ci-focus-top">
                            <span class="clusterlane-ci-focus-rank"><?php echo (int) ( $i + 1 ); ?></span>
                            <span class="clusterlane-ci-health-cell clusterlane-ci-detail-health--<?php echo esc_attr( $band ); ?>"><span class="clusterlane-ci-health-node" aria-hidden="true"></span><?php echo (int) $f['h']; ?>%</span>
                            <span class="clusterlane-ci-focus-size"><?php echo esc_html( sprintf( /* translators: %d: number */ _n( '%d article', '%d articles', $f['m'], 'clusterlane' ), $f['m'] ) ); ?></span>
                        </span>
                        <strong class="clusterlane-ci-focus-name"><?php echo esc_html( $f['label'] ); ?></strong>
                        <span class="clusterlane-ci-focus-why"><?php echo esc_html( $why ); ?></span>
                        <span class="clusterlane-ci-focus-go"><?php esc_html_e( 'Improve', 'clusterlane' ); ?> <?php clusterlane_glyph_e( 'arrow' ); ?></span>
                    </a>
                    <?php endforeach; ?>
                </div>
            </section>
            <?php endif; ?>

            <!-- Site map: every cluster at a glance (treemap; area = articles, colour = health or orphan share) -->
            <details class="clusterlane-panel-card clusterlane-dash-graph-details clusterlane-sm-card" id="clusterlane-sm-card" open>
                <summary class="clusterlane-site-analysis-header">
                    <div class="clusterlane-site-analysis-title">
                        <span class="clusterlane-site-analysis-icon"><?php clusterlane_glyph_e( 'layers' ); ?></span>
                        <div>
                            <strong><?php esc_html_e( 'Site map', 'clusterlane' ); ?></strong><?php clusterlane_tip( 'site_map' ); ?>
                            <span class="clusterlane-site-analysis-sub"><?php esc_html_e( 'Every cluster at a glance. Click one to show it in the graph below.', 'clusterlane' ); ?></span>
                        </div>
                    </div>
                    <div class="clusterlane-dash-graph-controls">
                        <span class="clusterlane-toolbar-label"><?php esc_html_e( 'Colour', 'clusterlane' ); ?></span>
                        <div class="clusterlane-seg" id="clusterlane-sm-mode" role="group" aria-label="<?php esc_attr_e( 'Colour by', 'clusterlane' ); ?>">
                            <button type="button" class="clusterlane-seg-btn is-active" data-mode="health" aria-pressed="true"><?php esc_html_e( 'Health', 'clusterlane' ); ?></button>
                            <button type="button" class="clusterlane-seg-btn" data-mode="orphans" aria-pressed="false"><?php esc_html_e( 'Orphans', 'clusterlane' ); ?></button>
                        </div>
                    </div>
                </summary>
                <div class="clusterlane-sm-body">
                    <div class="clusterlane-sm-canvas" id="clusterlane-sm-canvas"><p class="clusterlane-sm-empty"><?php esc_html_e( 'Loading…', 'clusterlane' ); ?></p></div>
                    <div class="clusterlane-sm-foot">
                        <div class="clusterlane-sm-legend" id="clusterlane-sm-legend"></div>
                        <p class="clusterlane-sm-takeaway" id="clusterlane-sm-takeaway"></p>
                    </div>
                </div>
            </details>

            <!-- Cluster Graph -->
            <details class="clusterlane-panel-card clusterlane-dash-graph-details" id="clusterlane-dash-graph-card" open>
                <summary class="clusterlane-site-analysis-header">
                    <div class="clusterlane-site-analysis-title">
                        <span class="clusterlane-site-analysis-icon"><?php clusterlane_glyph_e( 'nodes' ); ?></span>
                        <div>
                            <strong><?php esc_html_e( 'Cluster Graph', 'clusterlane' ); ?><?php clusterlane_tip( 'graph_layout' ); ?></strong>
                        </div>
                    </div>
                    <div class="clusterlane-dash-graph-controls">
                        <label for="clusterlane-dash-graph-select"><?php esc_html_e( 'Cluster:', 'clusterlane' ); ?></label>
                        <select id="clusterlane-dash-graph-select">
                            <option value=""><?php esc_attr_e( 'Loading clusters…', 'clusterlane' ); ?></option>
                        </select>
                        <a id="clusterlane-dash-graph-ci-link" href="<?php echo esc_url( $ci_url ); ?>" class="clusterlane-action-btn clusterlane-dash-graph-ci-btn" style="display:none;text-decoration:none;">
                            <?php esc_html_e( 'Open in Inspector →', 'clusterlane' ); ?>
                        </a>
                    </div>
                </summary>
                <div id="clusterlane-dash-graph-notice" style="display:none;"></div>
                <div id="clusterlane-dash-graph-container"></div>
                <div id="clusterlane-dash-graph-info" style="display:none;"></div>
            </details>


            <details class="clusterlane-site-analysis-card" id="clusterlane-site-analysis-card">
                <summary class="clusterlane-site-analysis-header">
                    <div class="clusterlane-site-analysis-title">
                        <span class="clusterlane-site-analysis-icon"><?php clusterlane_glyph_e( 'sparkle' ); ?></span>
                        <div>
                            <strong><?php esc_html_e( 'Site Intelligence Analysis', 'clusterlane' ); ?></strong>
                            <span class="clusterlane-site-analysis-sub"><?php esc_html_e( 'AI-powered overview of your content structure — strengths, gaps and opportunities across all clusters. Read-only: nothing is changed without your approval.', 'clusterlane' ); ?></span>
                        </div>
                    </div>
                    <div class="clusterlane-site-analysis-actions">
                        <span id="clusterlane-site-analysis-meta" class="clusterlane-site-analysis-meta"></span>
                        <div class="clusterlane-sa-btn-wrap">
                            <button id="clusterlane-site-analysis-btn" class="clusterlane-action-btn clusterlane-action-btn--secondary" style="min-width:0;">
                                <?php clusterlane_glyph_e( 'sparkle' ); ?><?php esc_html_e( 'Analyse site', 'clusterlane' ); ?>
                            </button>
                            <span class="clusterlane-sa-ai-badge"><?php esc_html_e( 'AI · uses ~2 k tokens', 'clusterlane' ); ?></span>
                        </div>
                        <button id="clusterlane-site-analysis-regen" class="clusterlane-action-btn clusterlane-action-btn--secondary" style="min-width:0;display:none;" title="<?php esc_attr_e( 'Write the analysis again — a new AI call', 'clusterlane' ); ?>">
                            <?php clusterlane_glyph_e( 'sparkle' ); ?><?php esc_html_e( 'Regenerate', 'clusterlane' ); ?>
                        </button>
                        <button id="clusterlane-sa-print" class="clusterlane-action-btn clusterlane-action-btn--tertiary" style="min-width:0;display:none;" title="Save as PDF / Print" onclick="window.print()">
                            <?php clusterlane_glyph_e( 'printer' ); ?>
                        </button>
                    </div>
                </summary>
                <div id="clusterlane-site-analysis-body">
                    <div id="clusterlane-site-analysis-result"></div>
                </div>
            </details>

            <?php if ( ! empty( $clusters ) ): ?>
            <!-- Edit cluster modal -->
                <div id="clusterlane-edit-modal" style="display:none;position:fixed;inset:0;background:rgba(0,0,0,.5);z-index:100000;align-items:center;justify-content:center;">
                    <div id="clusterlane-modal-inner" style="background:#fff;border-radius:8px;padding:28px;width:1100px;max-width:96vw;min-height:75vh;max-height:92vh;overflow-y:auto;position:relative;">
                        <button id="clusterlane-modal-close" style="position:absolute;top:12px;right:16px;background:none;border:none;font-size:1.4rem;cursor:pointer;color:#888;">×</button>
                        <div id="clusterlane-modal-header" class="clusterlane-modal-header">
                            <h2 id="clusterlane-modal-title" class="clusterlane-modal-title"></h2>
                            <div id="clusterlane-modal-stats" class="clusterlane-modal-stats"></div>
                        </div>

                        <!-- Members panel -->
                        <div id="clusterlane-modal-members-panel">
                            <div id="clusterlane-modal-rename" style="margin-bottom:16px;display:none;">
                                <label style="display:block;font-weight:600;margin-bottom:4px;"><?php esc_html_e( 'Cluster name', 'clusterlane' ); ?></label>
                                <input type="text" id="clusterlane-modal-label-input" class="regular-text">
                                <button id="clusterlane-modal-rename-btn" class="button" style="margin-left:8px;"><?php esc_html_e( 'Rename', 'clusterlane' ); ?></button>
                            </div>

                            <div style="margin-bottom:16px;">
                                <label style="display:block;font-weight:600;margin-bottom:4px;"><?php esc_html_e( 'Add articles', 'clusterlane' ); ?></label>
                                <div class="clusterlane-search-wrap" style="max-width:100%;">
                                    <svg class="clusterlane-search-icon" width="15" height="15" viewBox="0 0 20 20" fill="none" xmlns="http://www.w3.org/2000/svg" aria-hidden="true">
                                        <circle cx="9" cy="9" r="6.5" stroke="currentColor" stroke-width="1.8"/>
                                        <path d="M18 18L14 14" stroke="currentColor" stroke-width="1.8" stroke-linecap="round"/>
                                    </svg>
                                    <input type="text" id="clusterlane-modal-search" class="clusterlane-search-input" placeholder="<?php esc_attr_e( 'Search by title…', 'clusterlane' ); ?>">
                                </div>
                                <div id="clusterlane-modal-search-results" style="display:none;border:1px solid #ddd;border-radius:8px;margin-top:6px;max-height:180px;overflow-y:auto;background:#fff;position:relative;z-index:1;"></div>
                            </div>

                            <div>
                                <label style="display:block;font-weight:600;margin-bottom:8px;"><?php esc_html_e( 'Current members', 'clusterlane' ); ?></label>
                                <div id="clusterlane-modal-members" style="max-height:250px;overflow-y:auto;border:1px solid #eee;border-radius:4px;"></div>
                            </div>
                        </div>

                        <!-- Graph panel (injected by JS) -->
                        <div id="clusterlane-modal-graph-panel" style="display:none;">
                            <div id="clusterlane-graph-canvas-wrap" style="position:relative;">
                                <div id="clusterlane-vis-graph" style="width:100%;height:420px;border:1px solid #eee;border-radius:4px;background:#fafafa;"></div>
                                <button id="clusterlane-expand-btn" class="clusterlane-graph-expand-btn" style="display:none;"><?php clusterlane_glyph_e( 'search' ); ?>Expand</button>
                                <div id="clusterlane-graph-overlay" class="clusterlane-graph-overlay">
                                    <div id="clusterlane-graph-status" class="clusterlane-graph-status"></div>
                                </div>
                            </div>
                        </div>

                        <!-- Gap Analysis panel (content injected by JS) -->
                        <div id="clusterlane-modal-gap-panel" style="display:none;">
                            <div id="clusterlane-gap-content"></div>
                        </div>

                        <div id="clusterlane-modal-status" style="margin-top:12px;font-size:.85rem;min-height:20px;"></div>
                    </div>
                </div>

            <?php else: ?>
            <div class="clusterlane-scan-section" style="margin-top:24px;">
                <p><?php esc_html_e( 'No clusters yet. Pick your clusters in Cluster Admin, then click Scan in the bar at the top.', 'clusterlane' ); ?></p>
            </div>
            <?php endif; ?>


        </div><!-- /.clusterlane-wrap -->

        <?php if ( $show_onboarding ): ?>
        <!-- First-run onboarding modal -->
        <div id="clusterlane-onboarding-overlay" class="clusterlane-onboarding-overlay">
            <div class="clusterlane-onboarding-modal">

                <!-- Step 1: Welcome -->
                <div class="clusterlane-ob-step" id="clusterlane-ob-step-1">
                    <div class="clusterlane-ob-icon" style="display:inline-flex;align-items:center;justify-content:center;width:56px;height:56px;background:linear-gradient(135deg,#3b82f6,#1e40af);border-radius:14px;margin:0 auto 16px;">
                        <svg xmlns="http://www.w3.org/2000/svg" width="30" height="30" viewBox="0 0 24 24" fill="none" stroke="#fff" stroke-width="2.5" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><polygon points="13 2 3 14 12 14 11 22 21 10 12 10 13 2"/></svg>
                    </div>
                    <h2 class="clusterlane-ob-title"><?php esc_html_e( 'Welcome to Clusterlane', 'clusterlane' ); ?></h2>
                    <p class="clusterlane-ob-desc"><?php esc_html_e( 'Clusterlane helps you build a stronger internal link structure by grouping your articles into content clusters — topic hubs that search engines (and readers) love.', 'clusterlane' ); ?></p>
                    <p class="clusterlane-ob-desc"><?php esc_html_e( "Pick what to analyse, run the first scan, and your content map is ready — usually in a minute or two.", 'clusterlane' ); ?></p>
                    <div class="clusterlane-ob-actions">
                        <button class="clusterlane-action-btn clusterlane-action-btn--primary clusterlane-ob-next" data-next="2">
                            <?php esc_html_e( "Let's go →", 'clusterlane' ); ?>
                        </button>
                    </div>
                </div>

                <!-- Step 2: What to analyse (0.98.177: content types, published pages, clusters from any taxonomy) -->
                <div class="clusterlane-ob-step" id="clusterlane-ob-step-2" style="display:none;">
                    <h2 class="clusterlane-ob-title"><?php clusterlane_glyph_e( 'folder' ); ?><?php esc_html_e( 'What should Clusterlane analyse?', 'clusterlane' ); ?></h2>
                    <div class="clusterlane-ob-scroll">
                        <h3 class="clusterlane-ob-sub"><?php esc_html_e( 'Content', 'clusterlane' ); ?></h3>
                        <p class="clusterlane-ob-hint"><?php esc_html_e( 'The kinds of pages to scan.', 'clusterlane' ); ?></p>
                        <div class="clusterlane-ob-category-list clusterlane-ob-types">
                            <?php foreach ( $ob['types'] as $t ): ?>
                            <label class="clusterlane-ob-category-item">
                                <input type="checkbox" class="clusterlane-ob-type" value="<?php echo esc_attr( $t['name'] ); ?>" data-label="<?php echo esc_attr( $t['label'] ); ?>" data-rec="<?php echo $t['recommended'] ? '1' : '0'; ?>" <?php checked( $t['checked'] ); ?>>
                                <span class="clusterlane-ob-cat-name"><?php echo esc_html( $t['label'] ); ?></span>
                                <span class="clusterlane-ob-cat-count"><?php echo esc_html( sprintf( /* translators: %d: number */ _n( '%d page', '%d pages', $t['count'], 'clusterlane' ), $t['count'] ) ); ?></span>
                            </label>
                            <?php endforeach; ?>
                        </div>
                        <div class="clusterlane-ob-rendered" id="clusterlane-ob-rendered" hidden>
                            <label>
                                <input type="checkbox" id="clusterlane-ob-rendered-check" checked>
                                <span><?php esc_html_e( 'Also read the published pages of', 'clusterlane' ); ?> <strong id="clusterlane-ob-rendered-names"></strong> <?php esc_html_e( '(recommended)', 'clusterlane' ); ?></span>
                            </label>
                            <p class="clusterlane-ob-hint"><?php esc_html_e( 'These pages have almost no links in their text, so your theme probably links them through lists or cards. Clusterlane can only see those links on the published page. The first scan takes a little longer — about a second per page. You can change this later under Settings → Content.', 'clusterlane' ); ?></p>
                        </div>

                        <h3 class="clusterlane-ob-sub"><?php esc_html_e( 'Clusters', 'clusterlane' ); ?></h3>
                        <p class="clusterlane-ob-hint"><?php esc_html_e( 'Topic groups Clusterlane tracks — pick your main ones. Tags, custom clusters and AI ideas can be added any time in Cluster Admin.', 'clusterlane' ); ?></p>
                        <?php if ( $ob['hubs'] ): ?>
                        <div class="clusterlane-ob-group clusterlane-ob-hubs" data-types="<?php echo esc_attr( implode( ' ', array_unique( array_merge( ...array_map( fn( $h ) => $h['types'], $ob['hubs'] ) ) ) ) ); ?>">
                            <div class="clusterlane-ob-group-head"><span><?php esc_html_e( 'Pages as clusters', 'clusterlane' ); ?></span></div>
                            <div class="clusterlane-ob-category-list">
                                <?php foreach ( $ob['hubs'] as $h ): ?>
                                <label class="clusterlane-ob-category-item clusterlane-ob-hub" data-types="<?php echo esc_attr( implode( ' ', $h['types'] ) ); ?>">
                                    <input type="checkbox" class="clusterlane-ob-hub-check" value="<?php echo esc_attr( $h['type'] ); ?>" <?php checked( $h['checked'] ); ?>>
                                    <span class="clusterlane-ob-cat-name"><?php
                                        /* translators: 1: post type, e.g. "Islands", 2: post types, e.g. "areas, attractions" */
                                        echo esc_html( sprintf( __( '%1$s — each page a cluster, with its %2$s', 'clusterlane' ), $h['label'], mb_strtolower( implode( ', ', $h['with'] ) ) ) );
                                    ?></span>
                                    <span class="clusterlane-ob-cat-count"><?php echo esc_html( sprintf( /* translators: %d: number */ _n( '%d page', '%d pages', $h['pages'], 'clusterlane' ), $h['pages'] ) ); ?></span>
                                </label>
                                <?php endforeach; ?>
                            </div>
                        </div>
                        <?php endif; ?>
                        <?php foreach ( $ob['groups'] as $g ): ?>
                        <div class="clusterlane-ob-group" data-types="<?php echo esc_attr( implode( ' ', $g['types'] ) ); ?>">
                            <div class="clusterlane-ob-group-head">
                                <span><?php echo esc_html( $g['label'] ); ?></span>
                                <button type="button" class="clusterlane-ob-group-all"><?php esc_html_e( 'Select all', 'clusterlane' ); ?></button>
                            </div>
                            <div class="clusterlane-ob-category-list">
                                <?php foreach ( $g['terms'] as $term ): ?>
                                <label class="clusterlane-ob-category-item">
                                    <input type="checkbox" class="clusterlane-ob-cat-check" data-tax="<?php echo esc_attr( $g['taxonomy'] ); ?>" value="<?php echo esc_attr( (string) $term['id'] ); ?>" <?php checked( ! empty( $term['checked'] ) ); ?>>
                                    <span class="clusterlane-ob-cat-name"><?php echo esc_html( $term['name'] ); ?></span>
                                    <span class="clusterlane-ob-cat-count"><?php echo esc_html( sprintf( /* translators: %d: number */ _n( '%d page', '%d pages', $term['count'], 'clusterlane' ), $term['count'] ) ); ?></span>
                                </label>
                                <?php endforeach; ?>
                            </div>
                        </div>
                        <?php endforeach; ?>
                        <p class="clusterlane-ob-hint clusterlane-ob-no-groups" id="clusterlane-ob-no-groups" hidden><?php esc_html_e( 'No categories with two or more pages for this content yet. Continue without — you can add clusters in Cluster Admin, or let AI suggest some.', 'clusterlane' ); ?></p>
                    </div>
                    <div id="clusterlane-ob-step2-status" class="clusterlane-ob-status"></div>
                    <div class="clusterlane-ob-actions">
                        <button class="clusterlane-action-btn clusterlane-action-btn--secondary clusterlane-ob-back" data-back="1" style="min-width:0;">← <?php esc_html_e( 'Back', 'clusterlane' ); ?></button>
                        <button class="clusterlane-action-btn clusterlane-action-btn--primary" id="clusterlane-ob-save-clusters">
                            <?php esc_html_e( 'Save & continue →', 'clusterlane' ); ?>
                        </button>
                    </div>
                </div>

                <!-- Step 3: Scan -->
                <div class="clusterlane-ob-step" id="clusterlane-ob-step-3" style="display:none;">
                    <h2 class="clusterlane-ob-title"><?php clusterlane_glyph_e( 'search' ); ?><?php esc_html_e( 'Scan your site', 'clusterlane' ); ?></h2>
                    <p class="clusterlane-ob-desc"><?php esc_html_e( 'Clusterlane will now read through all your published articles to map their internal links and measure their content quality.', 'clusterlane' ); ?></p>
                    <div class="clusterlane-ob-progress-wrap" id="clusterlane-ob-progress-wrap" style="display:none;">
                        <div class="clusterlane-progress-bar-wrap">
                            <div class="clusterlane-progress-bar" id="clusterlane-ob-progress-bar" style="width:0%;"></div>
                        </div>
                        <div class="clusterlane-ob-progress-label" id="clusterlane-ob-progress-label"></div>
                    </div>
                    <div id="clusterlane-ob-step3-status" class="clusterlane-ob-status"></div>
                    <div class="clusterlane-ob-actions">
                        <button class="clusterlane-action-btn clusterlane-action-btn--primary" id="clusterlane-ob-start-scan">
                            <?php esc_html_e( 'Start scan', 'clusterlane' ); ?>
                        </button>
                    </div>
                </div>

                <!-- Step 4: Compute -->
                <div class="clusterlane-ob-step" id="clusterlane-ob-step-4" style="display:none;">
                    <h2 class="clusterlane-ob-title"><?php clusterlane_glyph_e( 'bolt' ); ?><?php esc_html_e( 'Computing cluster health', 'clusterlane' ); ?></h2>
                    <p class="clusterlane-ob-desc"><?php esc_html_e( "Almost done — Clusterlane is working out each cluster's health and the role of every article.", 'clusterlane' ); ?></p>
                    <div class="clusterlane-ob-spinner-wrap">
                        <span class="clusterlane-spinner"></span>
                    </div>
                    <div id="clusterlane-ob-step4-status" class="clusterlane-ob-status"></div>
                </div>

                <!-- Step 5: Done -->
                <div class="clusterlane-ob-step" id="clusterlane-ob-step-5" style="display:none;">
                    <div class="clusterlane-ob-icon"><?php clusterlane_glyph_e( 'check' ); ?></div>
                    <h2 class="clusterlane-ob-title"><?php esc_html_e( "You're all set!", 'clusterlane' ); ?></h2>
                    <p class="clusterlane-ob-desc" id="clusterlane-ob-done-summary"></p>
                    <p class="clusterlane-ob-desc"><?php esc_html_e( 'Start by exploring your clusters — see which articles are your pillars, which need more links, and where the gaps are.', 'clusterlane' ); ?></p>
                    <div class="clusterlane-ob-actions">
                        <a href="<?php echo esc_url( $ci_url ); ?>" class="clusterlane-action-btn clusterlane-action-btn--primary">
                            <?php esc_html_e( 'Explore your clusters →', 'clusterlane' ); ?>
                        </a>
                        <button class="clusterlane-action-btn clusterlane-action-btn--secondary" id="clusterlane-ob-close" style="min-width:0;">
                            <?php esc_html_e( 'Stay on Dashboard', 'clusterlane' ); ?>
                        </button>
                    </div>
                </div>

                <!-- Step indicator -->
                <div class="clusterlane-ob-steps-indicator">
                    <span class="clusterlane-ob-dot clusterlane-ob-dot--active" data-step="1"></span>
                    <span class="clusterlane-ob-dot" data-step="2"></span>
                    <span class="clusterlane-ob-dot" data-step="3"></span>
                    <span class="clusterlane-ob-dot" data-step="4"></span>
                    <span class="clusterlane-ob-dot" data-step="5"></span>
                </div>

            </div>
        </div>
        <?php endif; ?>
        <?php
    }

    /* ------------------------------------------------------------------
       AI Link Suggestions — filter/picker page
    ------------------------------------------------------------------ */

    public function render_link_suggest(): void {
        ?>
        <div class="wrap clusterlane-wrap">
            <?php $this->render_subnav( 'link-suggest' ); ?>

            <div class="clusterlane-page-hero">
                <?php clusterlane_icon_e( 'link' ); ?>
                <div>
                    <h1><?php esc_html_e( 'Link Suggestions', 'clusterlane' ); ?></h1>
                    <span class="clusterlane-page-hero-sub"><?php esc_html_e( 'Let AI draft anchor text and find the best placement for internal links.', 'clusterlane' ); ?></span>
                </div>
            </div>

            <?php
            // Premium: LinkSuggestPage renders the real tool; Free shows an example.
            if ( \Clusterlane\Core\Edition::has( 'ai' ) && has_action( 'clusterlane_render_link_suggest' ) ) {
                do_action( 'clusterlane_render_link_suggest' );
            } else {
                require_once CLUSTERLANE_DIR . 'intelligence/admin/class-pro-examples.php';
                \Clusterlane\Admin\ProExamples::render_link_suggest();
            }
            ?>
        </div>
        <?php
    }

    /* ------------------------------------------------------------------
       Settings (placeholder)
    ------------------------------------------------------------------ */

    /* ------------------------------------------------------------------
       Text Match Scanner
    ------------------------------------------------------------------ */

    public function render_text_match(): void {
        ?>
        <div class="wrap clusterlane-wrap">
            <?php $this->render_subnav( 'text-match' ); ?>

            <div class="clusterlane-page-hero">
                <?php clusterlane_icon_e( 'text-match' ); ?>
                <div>
                    <h1><?php esc_html_e( 'Text Match', 'clusterlane' ); ?></h1>
                    <span class="clusterlane-page-hero-sub"><?php esc_html_e( 'Find unlinked mentions of your articles and turn them into internal links.', 'clusterlane' ); ?></span>
                </div>
            </div>

            <div class="clusterlane-panel-card clusterlane-tm-setup" style="margin-bottom:20px;">
                <div class="clusterlane-tm-question">
                    <label for="clusterlane-tms-scan-cat"><?php esc_html_e( 'Find mentions in', 'clusterlane' ); ?></label>
                    <select id="clusterlane-tms-scan-cat" class="clusterlane-tms-select">
                        <option value="0"><?php esc_html_e( 'all articles', 'clusterlane' ); ?></option>
                    </select>
                    <label for="clusterlane-tms-match-cat"><?php esc_html_e( 'of articles in', 'clusterlane' ); ?></label>
                    <select id="clusterlane-tms-match-cat" class="clusterlane-tms-select">
                        <option value="0"><?php esc_html_e( 'any category', 'clusterlane' ); ?></option>
                    </select>
                </div>
                <p class="clusterlane-tm-hint"><?php esc_html_e( 'Clusterlane looks for article titles written in your text without a link. Nothing changes until you click Apply.', 'clusterlane' ); ?></p>

                <div class="clusterlane-tm-actions-bar">
                    <button id="clusterlane-tms-start" class="clusterlane-action-btn clusterlane-action-btn--primary">
                        <span class="clusterlane-action-btn__icon"><?php clusterlane_glyph_e( 'search' ); ?></span>
                        <span class="clusterlane-action-btn__label"><?php esc_html_e( 'Find unlinked mentions', 'clusterlane' ); ?></span>
                    </button>
                    <button id="clusterlane-tms-stop" class="clusterlane-action-btn clusterlane-action-btn--tertiary" style="display:none;">
                        <span class="clusterlane-action-btn__label"><?php esc_html_e( 'Stop', 'clusterlane' ); ?></span>
                    </button>
                    <button id="clusterlane-tms-clear" class="clusterlane-action-btn clusterlane-action-btn--tertiary" style="display:none;">
                        <span class="clusterlane-action-btn__label"><?php esc_html_e( 'Clear results', 'clusterlane' ); ?></span>
                    </button>
                    <span id="clusterlane-tms-status" class="clusterlane-tm-status" aria-live="polite"></span>
                    <button type="button" id="clusterlane-tms-clear-skipped" class="clusterlane-tm-linkbtn" style="display:none;"></button>
                </div>

                <div id="clusterlane-tms-progress-wrap" style="display:none;margin-top:14px;">
                    <div class="clusterlane-progress-bar-wrap">
                        <div class="clusterlane-progress-bar" id="clusterlane-tms-bar" style="width:0%;"></div>
                    </div>
                    <div id="clusterlane-tms-progress-label" class="clusterlane-tm-progress-label"></div>
                </div>
            </div>

            <!-- Before the first scan: what a result looks like -->
            <div class="clusterlane-tm-preview" id="clusterlane-tm-preview" aria-hidden="true">
                <p class="clusterlane-tm-preview-label"><?php esc_html_e( 'What you will see', 'clusterlane' ); ?></p>
                <div class="clusterlane-tm-group">
                    <div class="clusterlane-tm-group-head"><span><?php esc_html_e( 'In', 'clusterlane' ); ?> <strong>Skansen</strong></span></div>
                    <div class="clusterlane-tm-row">
                        <div class="clusterlane-tm-row-main">
                            <p class="clusterlane-tm-sentence">…an open-air museum on <span class="clusterlane-tm-hit">Djurgården</span>, next to Gröna Lund…</p>
                            <p class="clusterlane-tm-target"><?php clusterlane_glyph_e( 'arrow' ); ?><?php esc_html_e( 'link to', 'clusterlane' ); ?> <strong>Djurgården</strong> <span class="clusterlane-role-pill"><span class="clusterlane-role-dot clusterlane-role-dot--orphan"></span>Orphan</span></p>
                        </div>
                        <div class="clusterlane-tm-row-actions"><span class="clusterlane-tm-btn clusterlane-tm-btn--apply"><?php esc_html_e( 'Apply', 'clusterlane' ); ?></span><span class="clusterlane-tm-btn"><?php esc_html_e( 'Skip', 'clusterlane' ); ?></span></div>
                    </div>
                </div>
            </div>

            <div class="clusterlane-tm-summary" id="clusterlane-tm-summary" style="display:none;">
                <span id="clusterlane-tm-summary-text"></span>
                <div class="clusterlane-browse__roles" id="clusterlane-tm-filter" role="group" aria-label="<?php esc_attr_e( 'Show', 'clusterlane' ); ?>">
                    <button type="button" data-f="all" class="is-active"><?php esc_html_e( 'All', 'clusterlane' ); ?> <em></em></button>
                    <button type="button" data-f="orphan"><span class="clusterlane-role-dot clusterlane-role-dot--orphan"></span><?php esc_html_e( 'To orphans', 'clusterlane' ); ?> <em></em></button>
                </div>
            </div>

            <div id="clusterlane-tms-results"></div>
        </div>
        <?php
    }

    /* ------------------------------------------------------------------
       Article Inspector
    ------------------------------------------------------------------ */

    public function render_cluster_inspector(): void {
        require_once CLUSTERLANE_DIR . 'intelligence/admin/class-cluster-inspector-page.php';
        ( new \Clusterlane\Admin\ClusterInspectorPage() )->render();
    }

    public function render_seo_titles(): void {
        require_once CLUSTERLANE_DIR . 'intelligence/admin/class-seo-titles-page.php';
        ( new \Clusterlane\Admin\SeoTitlesPage() )->render();
    }

    public function render_article_inspector(): void {
        require_once CLUSTERLANE_DIR . 'intelligence/admin/class-article-inspector-page.php';
        ( new \Clusterlane\Admin\ArticleInspectorPage() )->render();
    }

    /* ------------------------------------------------------------------
       Settings Page
    ------------------------------------------------------------------ */

    public function render_settings(): void {
        require_once CLUSTERLANE_DIR . 'intelligence/admin/class-settings-page.php';
        ( new \Clusterlane\Admin\SettingsPage( $this->plugin ) )->render();
    }

    public function render_help(): void {
        $admin_section = null;
        if ( \Clusterlane\Core\Capabilities::can_manage() ) {
            require_once CLUSTERLANE_DIR . 'intelligence/admin/class-support-panel.php';
            $panel         = new \Clusterlane\Admin\SupportPanel( $this->plugin );
            $admin_section = [ $panel, 'render' ];
        }
        clusterlane_render_help_page( $admin_section );
    }

    public function render_report(): void {
        require_once CLUSTERLANE_DIR . 'intelligence/admin/class-pro-examples.php';
        require_once CLUSTERLANE_DIR . 'intelligence/admin/class-report-page.php';
        ( new \Clusterlane\Admin\ReportPage() )->render();
    }

    public function render_cluster_settings(): void {
        require_once CLUSTERLANE_DIR . 'intelligence/admin/class-cluster-settings-page.php';
        ( new \Clusterlane\Admin\ClusterSettingsPage( $this->plugin ) )->render();
    }
}