<?php

namespace ChargeForms\Admin;

use ChargeForms\Includes\Form;
use ChargeForms\Includes\Icon;

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

/**
 * ChargeForms > New Form — a template picker. Picking a card creates the form
 * immediately (via Form::create) and sends the user straight into the
 * builder, the same flow the reference product uses instead of starting on a blank
 * unsaved canvas.
 */
class New_Form_Page {

	public function __construct() {
		add_action( 'admin_menu', [ $this, 'register' ] );
		add_action( 'admin_post_chargeforms_create_from_template', [ $this, 'handle_create' ] );
		add_action( 'admin_post_chargeforms_import_form', [ $this, 'handle_import' ] );
	}

	public function register() {
		add_submenu_page(
			'chargeforms',
			__( 'New Form', 'chargeforms' ),
			__( 'New Form', 'chargeforms' ),
			'chargeforms_manage_forms',
			'chargeforms-new',
			[ $this, 'render' ]
		);
	}

	/**
	 * Categories mirror the same set used on the marketing site's
	 * /templates gallery — this list and that one should stay in sync so
	 * "Templates" means the same thing in both places.
	 */
	public static function categories() {
		return [
			'business'        => __( 'Business', 'chargeforms' ),
			'registration'    => __( 'Registration', 'chargeforms' ),
			'survey'          => __( 'Survey & Quiz', 'chargeforms' ),
			'payment'         => __( 'Payment', 'chargeforms' ),
			'event'           => __( 'Event', 'chargeforms' ),
			'education'       => __( 'Education', 'chargeforms' ),
			'booking'         => __( 'Booking', 'chargeforms' ),
			'application'     => __( 'Application', 'chargeforms' ),
			'lead_generation' => __( 'Lead Generation', 'chargeforms' ),
			'healthcare'      => __( 'Healthcare', 'chargeforms' ),
			'nonprofit'       => __( 'Non-profit', 'chargeforms' ),
			'developer'       => __( 'Developer / QA', 'chargeforms' ),
		];
	}

	/**
	 * Per-category tag color — matches the mockup's own catColor map
	 * (design_handoff_chargeforms's New Form screen) for every category
	 * that has a direct equivalent there: survey, payment, education,
	 * healthcare, nonprofit, developer, and event ("Events" in the
	 * mockup). ChargeForms' own category set has four categories with no
	 * mockup equivalent (registration, booking, application,
	 * lead_generation) — those fall back to the same neutral gray the
	 * mockup uses for "General" rather than inventing new brand colors
	 * the design never specified.
	 */
	private static function category_color( $category ) {
		$colors = [
			'business'    => '#606266',
			'survey'      => '#00b27f',
			'payment'     => '#6c4ef5',
			'education'   => '#8a6d2f',
			'healthcare'  => '#e0538a',
			'nonprofit'   => '#00805c',
			'developer'   => '#1e1f21',
			'event'       => '#0d8a8a',
		];
		return $colors[ $category ] ?? '#606266';
	}

	/** Whether a template has a real payment field — drives the mockup's "PAYMENT" badge. */
	private static function template_has_payment( array $template ) {
		foreach ( $template['fields'] ?? [] as $field ) {
			if ( in_array( $field['type'] ?? '', [ 'payment_item', 'custom_amount', 'payment_method' ], true ) ) {
				return true;
			}
		}
		return false;
	}

	/**
	 * Industry "Packs" — a curated view over the same templates() registry
	 * below, grouped by industry instead of by generic field-category. A
	 * template can belong to a pack via its own 'packs' key (an array of
	 * these slugs) without needing a separate/duplicated data source.
	 */
	public static function packs() {
		return [
			'real_estate' => [
				'label'       => __( 'Real Estate', 'chargeforms' ),
				'description' => __( 'Property inquiries, viewing requests, and rental applications.', 'chargeforms' ),
				'icon'        => 'dashicons-admin-home',
			],
			'healthcare'  => [
				'label'       => __( 'Healthcare', 'chargeforms' ),
				'description' => __( 'Patient intake, appointment requests, and consultation forms with consent built in.', 'chargeforms' ),
				'icon'        => 'dashicons-heart',
			],
			'education'   => [
				'label'       => __( 'Education', 'chargeforms' ),
				'description' => __( 'Course enrollment and scholarship applications with document uploads.', 'chargeforms' ),
				'icon'        => 'dashicons-welcome-learn-more',
			],
			'legal'       => [
				'label'       => __( 'Legal', 'chargeforms' ),
				'description' => __( 'Consultation requests and client intake with case details and consent.', 'chargeforms' ),
				'icon'        => 'dashicons-hammer',
			],
			'restaurant'  => [
				'label'       => __( 'Restaurant', 'chargeforms' ),
				'description' => __( 'Table reservations and catering requests.', 'chargeforms' ),
				'icon'        => 'dashicons-store',
			],
			'events'      => [
				'label'       => __( 'Events', 'chargeforms' ),
				'description' => __( 'Registration, RSVPs, and payment-ready ticketing.', 'chargeforms' ),
				'icon'        => 'dashicons-calendar-alt',
			],
			'nonprofit'   => [
				'label'       => __( 'Non-profit', 'chargeforms' ),
				'description' => __( 'Donations, volunteer applications, and grant requests.', 'chargeforms' ),
				'icon'        => 'dashicons-groups',
			],
		];
	}

	/** Templates belonging to a given pack, in registry order. */
	public static function templates_for_pack( $pack_key ) {
		return array_filter( self::templates(), function ( $template ) use ( $pack_key ) {
			return in_array( $pack_key, $template['packs'] ?? [], true );
		} );
	}

	public static function templates() {
		return [
			'blank'         => [
				'label'       => __( 'Blank Form', 'chargeforms' ),
				'description' => __( 'Start from scratch and drag in the fields you need.', 'chargeforms' ),
				'icon'        => 'dashicons-media-default',
				'category'    => 'business',
				'fields'      => [],
			],
			'contact'       => [
				'label'       => __( 'Simple Contact Form', 'chargeforms' ),
				'description' => __( 'Name, email, and a message — the classic contact form.', 'chargeforms' ),
				'icon'        => 'dashicons-email-alt',
				'category'    => 'business',
				'fields'      => [
					[ 'id' => 'f_name', 'type' => 'text', 'label' => __( 'Name', 'chargeforms' ), 'required' => true ],
					[ 'id' => 'f_email', 'type' => 'email', 'label' => __( 'Email', 'chargeforms' ), 'required' => true ],
					[ 'id' => 'f_message', 'type' => 'textarea', 'label' => __( 'Message', 'chargeforms' ), 'required' => true ],
				],
			],
			'subject'       => [
				'label'       => __( 'Contact Form with Subject', 'chargeforms' ),
				'description' => __( 'Adds a subject dropdown so replies get routed faster.', 'chargeforms' ),
				'icon'        => 'dashicons-index-card',
				'category'    => 'business',
				'fields'      => [
					[ 'id' => 'f_name', 'type' => 'text', 'label' => __( 'Name', 'chargeforms' ), 'required' => true ],
					[ 'id' => 'f_email', 'type' => 'email', 'label' => __( 'Email', 'chargeforms' ), 'required' => true ],
					[
						'id'       => 'f_subject',
						'type'     => 'select',
						'label'    => __( 'Subject', 'chargeforms' ),
						'required' => true,
						'options'  => [ __( 'General Inquiry', 'chargeforms' ), __( 'Support', 'chargeforms' ), __( 'Sales', 'chargeforms' ) ],
					],
					[ 'id' => 'f_message', 'type' => 'textarea', 'label' => __( 'Message', 'chargeforms' ), 'required' => true ],
				],
			],
			'quote_request' => [
				'label'       => __( 'Quote Request Form', 'chargeforms' ),
				'description' => __( 'Collect project details and budget range before a sales call.', 'chargeforms' ),
				'icon'        => 'dashicons-clipboard',
				'category'    => 'business',
				'fields'      => [
					[ 'id' => 'f_name', 'type' => 'text', 'label' => __( 'Name', 'chargeforms' ), 'required' => true ],
					[ 'id' => 'f_email', 'type' => 'email', 'label' => __( 'Email', 'chargeforms' ), 'required' => true ],
					[ 'id' => 'f_company', 'type' => 'text', 'label' => __( 'Company', 'chargeforms' ) ],
					[
						'id'      => 'f_budget',
						'type'    => 'select',
						'label'   => __( 'Budget Range', 'chargeforms' ),
						'options' => [ __( 'Under $1,000', 'chargeforms' ), __( '$1,000–$5,000', 'chargeforms' ), __( '$5,000+', 'chargeforms' ) ],
					],
					[ 'id' => 'f_details', 'type' => 'textarea', 'label' => __( 'Project Details', 'chargeforms' ), 'required' => true ],
				],
			],
			'job_application' => [
				'label'       => __( 'Job Application Form', 'chargeforms' ),
				'description' => __( 'Resume upload, work history, and screening questions in one flow.', 'chargeforms' ),
				'icon'        => 'dashicons-id-alt',
				'category'    => 'application',
				'fields'      => [
					[ 'id' => 'f_name', 'type' => 'text', 'label' => __( 'Full Name', 'chargeforms' ), 'required' => true ],
					[ 'id' => 'f_email', 'type' => 'email', 'label' => __( 'Email', 'chargeforms' ), 'required' => true ],
					[ 'id' => 'f_phone', 'type' => 'phone', 'label' => __( 'Phone', 'chargeforms' ) ],
					[ 'id' => 'f_position', 'type' => 'select', 'label' => __( 'Position Applying For', 'chargeforms' ), 'required' => true, 'options' => [ __( 'Engineering', 'chargeforms' ), __( 'Design', 'chargeforms' ), __( 'Marketing', 'chargeforms' ), __( 'Support', 'chargeforms' ) ] ],
					[ 'id' => 'f_resume', 'type' => 'file', 'label' => __( 'Resume', 'chargeforms' ), 'required' => true, 'allowedExtensions' => 'pdf,doc,docx' ],
					[ 'id' => 'f_cover_letter', 'type' => 'textarea', 'label' => __( 'Cover Letter', 'chargeforms' ) ],
				],
			],
			'event_registration' => [
				'label'       => __( 'Event Registration Form', 'chargeforms' ),
				'description' => __( 'Ticket tiers, dietary preferences, and a payment step in one form.', 'chargeforms' ),
				'icon'        => 'dashicons-calendar-alt',
				'category'    => 'event',
				'packs'       => [ 'events' ],
				'fields'      => [
					[ 'id' => 'f_name', 'type' => 'text', 'label' => __( 'Name', 'chargeforms' ), 'required' => true ],
					[ 'id' => 'f_email', 'type' => 'email', 'label' => __( 'Email', 'chargeforms' ), 'required' => true ],
					[ 'id' => 'f_dietary', 'type' => 'textarea', 'label' => __( 'Dietary Restrictions', 'chargeforms' ) ],
					[ 'id' => 'f_ticket', 'type' => 'payment_item', 'label' => __( 'Ticket', 'chargeforms' ), 'amount' => 25 ],
					[ 'id' => 'f_card', 'type' => 'payment_method', 'label' => __( 'Card', 'chargeforms' ) ],
				],
			],
			'satisfaction_survey' => [
				'label'       => __( 'Customer Satisfaction Survey', 'chargeforms' ),
				'description' => __( 'NPS scale plus open-ended feedback, ready to analyze in Reports.', 'chargeforms' ),
				'icon'        => 'dashicons-chart-bar',
				'category'    => 'survey',
				'fields'      => [
					[ 'id' => 'f_nps', 'type' => 'nps', 'label' => __( 'How likely are you to recommend us to a friend or colleague?', 'chargeforms' ), 'lowLabel' => __( 'Not likely', 'chargeforms' ), 'highLabel' => __( 'Very likely', 'chargeforms' ) ],
					[ 'id' => 'f_rating', 'type' => 'ratings', 'label' => __( 'Overall satisfaction', 'chargeforms' ), 'maxStars' => 5 ],
					[ 'id' => 'f_feedback', 'type' => 'textarea', 'label' => __( 'What could we do better?', 'chargeforms' ) ],
				],
			],
			'donation'      => [
				'label'       => __( 'Donation Form', 'chargeforms' ),
				'description' => __( 'Preset and custom donation amounts with a real Stripe payment step.', 'chargeforms' ),
				'icon'        => 'dashicons-heart',
				'category'    => 'nonprofit',
				'packs'       => [ 'nonprofit' ],
				'fields'      => [
					[ 'id' => 'f_name', 'type' => 'text', 'label' => __( 'Name', 'chargeforms' ), 'required' => true ],
					[ 'id' => 'f_email', 'type' => 'email', 'label' => __( 'Email', 'chargeforms' ), 'required' => true ],
					[ 'id' => 'f_amount', 'type' => 'custom_amount', 'label' => __( 'Donation Amount', 'chargeforms' ), 'minAmount' => 5 ],
					[ 'id' => 'f_card', 'type' => 'payment_method', 'label' => __( 'Card', 'chargeforms' ) ],
				],
			],
			'volunteer_application' => [
				'label'       => __( 'Volunteer Application Form', 'chargeforms' ),
				'description' => __( 'Multi-step application with role-specific questions.', 'chargeforms' ),
				'icon'        => 'dashicons-groups',
				'category'    => 'nonprofit',
				'packs'       => [ 'nonprofit' ],
				'fields'      => [
					[ 'id' => 'f_name', 'type' => 'text', 'label' => __( 'Name', 'chargeforms' ), 'required' => true ],
					[ 'id' => 'f_email', 'type' => 'email', 'label' => __( 'Email', 'chargeforms' ), 'required' => true ],
					[ 'id' => 'f_phone', 'type' => 'phone', 'label' => __( 'Phone', 'chargeforms' ) ],
					[ 'id' => 'f_role', 'type' => 'select', 'label' => __( 'Role Interested In', 'chargeforms' ), 'required' => true, 'options' => [ __( 'Event Support', 'chargeforms' ), __( 'Mentoring', 'chargeforms' ), __( 'Administration', 'chargeforms' ), __( 'Fundraising', 'chargeforms' ) ] ],
					[ 'id' => 'f_page_break_1', 'type' => 'page_break', 'label' => '' ],
					[ 'id' => 'f_availability', 'type' => 'multiple_choice', 'label' => __( 'Availability', 'chargeforms' ), 'options' => [ __( 'Weekdays', 'chargeforms' ), __( 'Weekends', 'chargeforms' ), __( 'Evenings', 'chargeforms' ) ] ],
					[ 'id' => 'f_why', 'type' => 'textarea', 'label' => __( 'Why do you want to volunteer with us?', 'chargeforms' ), 'required' => true ],
				],
			],
			'course_enrollment' => [
				'label'       => __( 'Course Enrollment Form', 'chargeforms' ),
				'description' => __( 'Student details, course selection, and payment in one submission.', 'chargeforms' ),
				'icon'        => 'dashicons-welcome-learn-more',
				'category'    => 'education',
				'packs'       => [ 'education' ],
				'fields'      => [
					[ 'id' => 'f_name', 'type' => 'text', 'label' => __( 'Student Name', 'chargeforms' ), 'required' => true ],
					[ 'id' => 'f_email', 'type' => 'email', 'label' => __( 'Email', 'chargeforms' ), 'required' => true ],
					[ 'id' => 'f_course', 'type' => 'payment_item', 'label' => __( 'Course', 'chargeforms' ), 'amount' => 199 ],
					[ 'id' => 'f_card', 'type' => 'payment_method', 'label' => __( 'Card', 'chargeforms' ) ],
				],
			],
			'appointment_booking' => [
				'label'       => __( 'Appointment Booking Form', 'chargeforms' ),
				'description' => __( 'Service selection with a deposit payment.', 'chargeforms' ),
				'icon'        => 'dashicons-clock',
				'category'    => 'booking',
				'fields'      => [
					[ 'id' => 'f_name', 'type' => 'text', 'label' => __( 'Name', 'chargeforms' ), 'required' => true ],
					[ 'id' => 'f_email', 'type' => 'email', 'label' => __( 'Email', 'chargeforms' ), 'required' => true ],
					[ 'id' => 'f_phone', 'type' => 'phone', 'label' => __( 'Phone', 'chargeforms' ) ],
					[ 'id' => 'f_date', 'type' => 'date', 'label' => __( 'Preferred Date', 'chargeforms' ), 'required' => true ],
					[ 'id' => 'f_deposit', 'type' => 'custom_amount', 'label' => __( 'Deposit', 'chargeforms' ), 'minAmount' => 10 ],
					[ 'id' => 'f_card', 'type' => 'payment_method', 'label' => __( 'Card', 'chargeforms' ) ],
				],
			],
			'newsletter'    => [
				'label'       => __( 'Newsletter Signup Form', 'chargeforms' ),
				'description' => __( 'A minimal two-field form optimized for conversion.', 'chargeforms' ),
				'icon'        => 'dashicons-email',
				'category'    => 'lead_generation',
				'fields'      => [
					[ 'id' => 'f_name', 'type' => 'text', 'label' => __( 'First Name', 'chargeforms' ) ],
					[ 'id' => 'f_email', 'type' => 'email', 'label' => __( 'Email', 'chargeforms' ), 'required' => true ],
				],
			],
			'consultation'  => [
				'label'       => __( 'Consultation Request Form', 'chargeforms' ),
				'description' => __( 'Intake questionnaire for a healthcare or wellness consultation.', 'chargeforms' ),
				'icon'        => 'dashicons-heart',
				'category'    => 'healthcare',
				'packs'       => [ 'healthcare' ],
				'settings'    => [ 'double_optin' => 'on' ],
				'fields'      => [
					[ 'id' => 'f_name', 'type' => 'text', 'label' => __( 'Name', 'chargeforms' ), 'required' => true ],
					[ 'id' => 'f_email', 'type' => 'email', 'label' => __( 'Email', 'chargeforms' ), 'required' => true ],
					[ 'id' => 'f_phone', 'type' => 'phone', 'label' => __( 'Phone', 'chargeforms' ), 'required' => true ],
					[ 'id' => 'f_reason', 'type' => 'textarea', 'label' => __( 'Reason for Consultation', 'chargeforms' ), 'required' => true ],
					[ 'id' => 'f_consent', 'type' => 'gdpr', 'label' => __( 'I consent to my information being processed for this consultation request.', 'chargeforms' ), 'required' => true ],
				],
			],
			'membership'    => [
				'label'       => __( 'Membership Signup Form', 'chargeforms' ),
				'description' => __( 'Tiered membership plans with a recurring-friendly payment field.', 'chargeforms' ),
				'icon'        => 'dashicons-awards',
				'category'    => 'payment',
				'fields'      => [
					[ 'id' => 'f_name', 'type' => 'text', 'label' => __( 'Name', 'chargeforms' ), 'required' => true ],
					[ 'id' => 'f_email', 'type' => 'email', 'label' => __( 'Email', 'chargeforms' ), 'required' => true ],
					[ 'id' => 'f_plan', 'type' => 'payment_item', 'label' => __( 'Membership Plan', 'chargeforms' ), 'amount' => 15 ],
					[ 'id' => 'f_card', 'type' => 'payment_method', 'label' => __( 'Card', 'chargeforms' ) ],
				],
			],
			'registration'  => [
				'label'       => __( 'Event Attendee Registration', 'chargeforms' ),
				'description' => __( 'A straightforward attendee sign-up with an address block.', 'chargeforms' ),
				'icon'        => 'dashicons-forms',
				'category'    => 'registration',
				'fields'      => [
					[ 'id' => 'f_name', 'type' => 'text', 'label' => __( 'Full Name', 'chargeforms' ), 'required' => true ],
					[ 'id' => 'f_email', 'type' => 'email', 'label' => __( 'Email', 'chargeforms' ), 'required' => true ],
					[ 'id' => 'f_address', 'type' => 'address', 'label' => __( 'Mailing Address', 'chargeforms' ) ],
				],
			],

			// --- Industry pack-only templates (no standalone category tab;
			// only reachable via a pack's own view, see templates_for_pack()) ---
			'property_inquiry'      => [
				'label'       => __( 'Property Inquiry Form', 'chargeforms' ),
				'description' => __( 'Capture buyer/renter interest in a specific listing.', 'chargeforms' ),
				'icon'        => 'dashicons-admin-home',
				'category'    => 'business',
				'packs'       => [ 'real_estate' ],
				'fields'      => [
					[ 'id' => 'f_name', 'type' => 'text', 'label' => __( 'Name', 'chargeforms' ), 'required' => true ],
					[ 'id' => 'f_email', 'type' => 'email', 'label' => __( 'Email', 'chargeforms' ), 'required' => true ],
					[ 'id' => 'f_phone', 'type' => 'phone', 'label' => __( 'Phone', 'chargeforms' ) ],
					[ 'id' => 'f_property', 'type' => 'text', 'label' => __( 'Property Address / Listing ID', 'chargeforms' ), 'required' => true ],
					[ 'id' => 'f_inquiry_type', 'type' => 'select', 'label' => __( 'I am interested in', 'chargeforms' ), 'options' => [ __( 'Buying', 'chargeforms' ), __( 'Renting', 'chargeforms' ), __( 'Selling', 'chargeforms' ) ] ],
					[ 'id' => 'f_message', 'type' => 'textarea', 'label' => __( 'Message', 'chargeforms' ) ],
				],
			],
			'schedule_viewing'       => [
				'label'       => __( 'Schedule a Viewing Form', 'chargeforms' ),
				'description' => __( 'Let prospects request a property viewing time.', 'chargeforms' ),
				'icon'        => 'dashicons-calendar-alt',
				'category'    => 'booking',
				'packs'       => [ 'real_estate' ],
				'fields'      => [
					[ 'id' => 'f_name', 'type' => 'text', 'label' => __( 'Name', 'chargeforms' ), 'required' => true ],
					[ 'id' => 'f_email', 'type' => 'email', 'label' => __( 'Email', 'chargeforms' ), 'required' => true ],
					[ 'id' => 'f_phone', 'type' => 'phone', 'label' => __( 'Phone', 'chargeforms' ), 'required' => true ],
					[ 'id' => 'f_property', 'type' => 'text', 'label' => __( 'Property Address / Listing ID', 'chargeforms' ), 'required' => true ],
					[ 'id' => 'f_date', 'type' => 'date', 'label' => __( 'Preferred Date', 'chargeforms' ), 'required' => true ],
					[ 'id' => 'f_time', 'type' => 'select', 'label' => __( 'Preferred Time', 'chargeforms' ), 'options' => [ __( 'Morning', 'chargeforms' ), __( 'Afternoon', 'chargeforms' ), __( 'Evening', 'chargeforms' ) ] ],
				],
			],
			'rental_application'    => [
				'label'       => __( 'Rental Application Form', 'chargeforms' ),
				'description' => __( 'Employment, income, and ID verification for a rental application.', 'chargeforms' ),
				'icon'        => 'dashicons-media-document',
				'category'    => 'application',
				'packs'       => [ 'real_estate' ],
				'settings'    => [ 'double_optin' => 'on' ],
				'fields'      => [
					[ 'id' => 'f_name', 'type' => 'text', 'label' => __( 'Full Name', 'chargeforms' ), 'required' => true ],
					[ 'id' => 'f_email', 'type' => 'email', 'label' => __( 'Email', 'chargeforms' ), 'required' => true ],
					[ 'id' => 'f_phone', 'type' => 'phone', 'label' => __( 'Phone', 'chargeforms' ), 'required' => true ],
					[ 'id' => 'f_address', 'type' => 'address', 'label' => __( 'Current Address', 'chargeforms' ) ],
					[ 'id' => 'f_employment', 'type' => 'select', 'label' => __( 'Employment Status', 'chargeforms' ), 'options' => [ __( 'Employed', 'chargeforms' ), __( 'Self-Employed', 'chargeforms' ), __( 'Student', 'chargeforms' ), __( 'Unemployed', 'chargeforms' ) ] ],
					[ 'id' => 'f_income', 'type' => 'numeric', 'label' => __( 'Monthly Income', 'chargeforms' ), 'required' => true ],
					[ 'id' => 'f_id_document', 'type' => 'file', 'label' => __( 'ID Document', 'chargeforms' ), 'required' => true, 'allowedExtensions' => 'pdf,jpg,jpeg,png' ],
					[ 'id' => 'f_consent', 'type' => 'gdpr', 'label' => __( 'I consent to a background and credit check as part of this application.', 'chargeforms' ), 'required' => true ],
				],
			],
			'patient_intake'         => [
				'label'       => __( 'Patient Intake Form', 'chargeforms' ),
				'description' => __( 'New patient details, reason for visit, and consent.', 'chargeforms' ),
				'icon'        => 'dashicons-heart',
				'category'    => 'healthcare',
				'packs'       => [ 'healthcare' ],
				'settings'    => [ 'double_optin' => 'on' ],
				'fields'      => [
					[ 'id' => 'f_name', 'type' => 'text', 'label' => __( 'Full Name', 'chargeforms' ), 'required' => true ],
					[ 'id' => 'f_email', 'type' => 'email', 'label' => __( 'Email', 'chargeforms' ), 'required' => true ],
					[ 'id' => 'f_phone', 'type' => 'phone', 'label' => __( 'Phone', 'chargeforms' ), 'required' => true ],
					[ 'id' => 'f_dob', 'type' => 'date', 'label' => __( 'Date of Birth', 'chargeforms' ), 'required' => true ],
					[ 'id' => 'f_insurance', 'type' => 'text', 'label' => __( 'Insurance Provider', 'chargeforms' ) ],
					[ 'id' => 'f_reason', 'type' => 'textarea', 'label' => __( 'Reason for Visit', 'chargeforms' ), 'required' => true ],
					[ 'id' => 'f_consent', 'type' => 'gdpr', 'label' => __( 'I consent to my health information being processed for this visit.', 'chargeforms' ), 'required' => true ],
				],
			],
			'scholarship_application' => [
				'label'       => __( 'Scholarship Application Form', 'chargeforms' ),
				'description' => __( 'Academic details and supporting documents for a scholarship application.', 'chargeforms' ),
				'icon'        => 'dashicons-awards',
				'category'    => 'education',
				'packs'       => [ 'education' ],
				'fields'      => [
					[ 'id' => 'f_name', 'type' => 'text', 'label' => __( 'Full Name', 'chargeforms' ), 'required' => true ],
					[ 'id' => 'f_email', 'type' => 'email', 'label' => __( 'Email', 'chargeforms' ), 'required' => true ],
					[ 'id' => 'f_school', 'type' => 'text', 'label' => __( 'School / Institution', 'chargeforms' ), 'required' => true ],
					[ 'id' => 'f_gpa', 'type' => 'numeric', 'label' => __( 'GPA', 'chargeforms' ) ],
					[ 'id' => 'f_essay', 'type' => 'textarea', 'label' => __( 'Personal Essay', 'chargeforms' ), 'required' => true ],
					[ 'id' => 'f_transcript', 'type' => 'file', 'label' => __( 'Transcript', 'chargeforms' ), 'allowedExtensions' => 'pdf' ],
				],
			],
			'legal_consultation'     => [
				'label'       => __( 'Legal Consultation Request', 'chargeforms' ),
				'description' => __( 'Case type and details for an initial legal consultation.', 'chargeforms' ),
				'icon'        => 'dashicons-hammer',
				'category'    => 'business',
				'packs'       => [ 'legal' ],
				'settings'    => [ 'double_optin' => 'on' ],
				'fields'      => [
					[ 'id' => 'f_name', 'type' => 'text', 'label' => __( 'Full Name', 'chargeforms' ), 'required' => true ],
					[ 'id' => 'f_email', 'type' => 'email', 'label' => __( 'Email', 'chargeforms' ), 'required' => true ],
					[ 'id' => 'f_phone', 'type' => 'phone', 'label' => __( 'Phone', 'chargeforms' ), 'required' => true ],
					[ 'id' => 'f_case_type', 'type' => 'select', 'label' => __( 'Case Type', 'chargeforms' ), 'required' => true, 'options' => [ __( 'Family Law', 'chargeforms' ), __( 'Business', 'chargeforms' ), __( 'Real Estate', 'chargeforms' ), __( 'Criminal', 'chargeforms' ), __( 'Other', 'chargeforms' ) ] ],
					[ 'id' => 'f_details', 'type' => 'textarea', 'label' => __( 'Case Details', 'chargeforms' ), 'required' => true ],
					[ 'id' => 'f_consent', 'type' => 'gdpr', 'label' => __( 'I understand this does not establish an attorney-client relationship.', 'chargeforms' ), 'required' => true ],
				],
			],
			'client_intake'          => [
				'label'       => __( 'Client Intake Form', 'chargeforms' ),
				'description' => __( 'Full intake for a new legal client, with document upload.', 'chargeforms' ),
				'icon'        => 'dashicons-portfolio',
				'category'    => 'application',
				'packs'       => [ 'legal' ],
				'settings'    => [ 'double_optin' => 'on' ],
				'fields'      => [
					[ 'id' => 'f_name', 'type' => 'text', 'label' => __( 'Full Name', 'chargeforms' ), 'required' => true ],
					[ 'id' => 'f_email', 'type' => 'email', 'label' => __( 'Email', 'chargeforms' ), 'required' => true ],
					[ 'id' => 'f_phone', 'type' => 'phone', 'label' => __( 'Phone', 'chargeforms' ), 'required' => true ],
					[ 'id' => 'f_address', 'type' => 'address', 'label' => __( 'Address', 'chargeforms' ) ],
					[ 'id' => 'f_case_type', 'type' => 'select', 'label' => __( 'Case Type', 'chargeforms' ), 'required' => true, 'options' => [ __( 'Family Law', 'chargeforms' ), __( 'Business', 'chargeforms' ), __( 'Real Estate', 'chargeforms' ), __( 'Criminal', 'chargeforms' ), __( 'Other', 'chargeforms' ) ] ],
					[ 'id' => 'f_opposing_party', 'type' => 'text', 'label' => __( 'Opposing Party (if any)', 'chargeforms' ) ],
					[ 'id' => 'f_details', 'type' => 'textarea', 'label' => __( 'Case Details', 'chargeforms' ), 'required' => true ],
					[ 'id' => 'f_documents', 'type' => 'file', 'label' => __( 'Supporting Documents', 'chargeforms' ), 'allowedExtensions' => 'pdf,doc,docx' ],
					[ 'id' => 'f_consent', 'type' => 'gdpr', 'label' => __( 'I consent to my information being used for this intake.', 'chargeforms' ), 'required' => true ],
				],
			],
			'table_reservation'      => [
				'label'       => __( 'Table Reservation Form', 'chargeforms' ),
				'description' => __( 'Party size, date, and time for a dining reservation.', 'chargeforms' ),
				'icon'        => 'dashicons-store',
				'category'    => 'booking',
				'packs'       => [ 'restaurant' ],
				'fields'      => [
					[ 'id' => 'f_name', 'type' => 'text', 'label' => __( 'Name', 'chargeforms' ), 'required' => true ],
					[ 'id' => 'f_email', 'type' => 'email', 'label' => __( 'Email', 'chargeforms' ), 'required' => true ],
					[ 'id' => 'f_phone', 'type' => 'phone', 'label' => __( 'Phone', 'chargeforms' ), 'required' => true ],
					[ 'id' => 'f_party_size', 'type' => 'numeric', 'label' => __( 'Party Size', 'chargeforms' ), 'required' => true ],
					[ 'id' => 'f_date', 'type' => 'date', 'label' => __( 'Reservation Date', 'chargeforms' ), 'required' => true ],
					[ 'id' => 'f_time', 'type' => 'select', 'label' => __( 'Reservation Time', 'chargeforms' ), 'options' => [ '5:00 PM', '6:00 PM', '7:00 PM', '8:00 PM', '9:00 PM' ] ],
					[ 'id' => 'f_requests', 'type' => 'textarea', 'label' => __( 'Special Requests', 'chargeforms' ) ],
				],
			],
			'catering_request'       => [
				'label'       => __( 'Catering Request Form', 'chargeforms' ),
				'description' => __( 'Event details and menu preferences for a catering quote.', 'chargeforms' ),
				'icon'        => 'dashicons-carrot',
				'category'    => 'event',
				'packs'       => [ 'restaurant' ],
				'fields'      => [
					[ 'id' => 'f_name', 'type' => 'text', 'label' => __( 'Name', 'chargeforms' ), 'required' => true ],
					[ 'id' => 'f_email', 'type' => 'email', 'label' => __( 'Email', 'chargeforms' ), 'required' => true ],
					[ 'id' => 'f_phone', 'type' => 'phone', 'label' => __( 'Phone', 'chargeforms' ), 'required' => true ],
					[ 'id' => 'f_event_date', 'type' => 'date', 'label' => __( 'Event Date', 'chargeforms' ), 'required' => true ],
					[ 'id' => 'f_guest_count', 'type' => 'numeric', 'label' => __( 'Guest Count', 'chargeforms' ), 'required' => true ],
					[ 'id' => 'f_menu', 'type' => 'textarea', 'label' => __( 'Menu Preferences', 'chargeforms' ) ],
					[ 'id' => 'f_budget', 'type' => 'select', 'label' => __( 'Budget Range', 'chargeforms' ), 'options' => [ __( 'Under $500', 'chargeforms' ), __( '$500–$1,500', 'chargeforms' ), __( '$1,500+', 'chargeforms' ) ] ],
				],
			],
			'rsvp_form'              => [
				'label'       => __( 'RSVP Form', 'chargeforms' ),
				'description' => __( 'A simple attending/not-attending response with guest count.', 'chargeforms' ),
				'icon'        => 'dashicons-yes-alt',
				'category'    => 'event',
				'packs'       => [ 'events' ],
				'fields'      => [
					[ 'id' => 'f_name', 'type' => 'text', 'label' => __( 'Name', 'chargeforms' ), 'required' => true ],
					[ 'id' => 'f_email', 'type' => 'email', 'label' => __( 'Email', 'chargeforms' ), 'required' => true ],
					[ 'id' => 'f_attending', 'type' => 'radio', 'label' => __( 'Will you attend?', 'chargeforms' ), 'required' => true, 'options' => [ __( 'Yes', 'chargeforms' ), __( 'No', 'chargeforms' ), __( 'Maybe', 'chargeforms' ) ] ],
					[ 'id' => 'f_guest_count', 'type' => 'numeric', 'label' => __( 'Number of Guests', 'chargeforms' ) ],
					[ 'id' => 'f_dietary', 'type' => 'textarea', 'label' => __( 'Dietary Restrictions', 'chargeforms' ) ],
				],
			],
			'grant_application'      => [
				'label'       => __( 'Grant Application Form', 'chargeforms' ),
				'description' => __( 'Organization details, project description, and requested amount.', 'chargeforms' ),
				'icon'        => 'dashicons-awards',
				'category'    => 'nonprofit',
				'packs'       => [ 'nonprofit' ],
				'fields'      => [
					[ 'id' => 'f_org_name', 'type' => 'text', 'label' => __( 'Organization Name', 'chargeforms' ), 'required' => true ],
					[ 'id' => 'f_name', 'type' => 'text', 'label' => __( 'Contact Name', 'chargeforms' ), 'required' => true ],
					[ 'id' => 'f_email', 'type' => 'email', 'label' => __( 'Email', 'chargeforms' ), 'required' => true ],
					[ 'id' => 'f_phone', 'type' => 'phone', 'label' => __( 'Phone', 'chargeforms' ) ],
					[ 'id' => 'f_amount', 'type' => 'numeric', 'label' => __( 'Requested Amount', 'chargeforms' ), 'required' => true ],
					[ 'id' => 'f_description', 'type' => 'textarea', 'label' => __( 'Project Description', 'chargeforms' ), 'required' => true ],
					[ 'id' => 'f_budget_doc', 'type' => 'file', 'label' => __( 'Budget Document', 'chargeforms' ), 'allowedExtensions' => 'pdf,xls,xlsx' ],
				],
			],

			// --- Internal QA/developer template — not a customer-facing form.
			// Loads every completed builder capability (layout nesting,
			// containers, varied field settings, legacy + new-schema
			// conditional logic with nested AND/OR/NOT) into one canvas so it
			// can be manually exercised — see docs/research/ for the audit
			// this was built to support. Reuses the exact same template/
			// Form::create/builder pipeline every other template already
			// goes through; nothing new was built to expose this. ---
			'showcase_qa' => self::showcase_qa_template(),
		];
	}

	/**
	 * Internal showcase/QA form — demonstrates every completed Milestone
	 * 1-6 Phase A capability in one canvas:
	 *  - Layout Engine / Nested Sections / Columns / Containers: a Section
	 *    containing a two-column Row, one column holding a plain Container
	 *    wrapping two more fields (so Section, Row, Column, and Container
	 *    are all present and nested inside each other, not just siblings).
	 *  - Universal Field Capabilities / Settings Categories: a deliberately
	 *    varied spread of field types (choice, file, date, range, payment)
	 *    so every settings-panel section (General/Advanced/Conditional) has
	 *    something real to show for a range of field types, not just text
	 *    inputs.
	 *  - Conditional Logic: one field left on the OLD field.conditional
	 *    shape (exercises the "Enable conditional logic" auto-migration
	 *    path the first time someone opens it) and one field pre-populated
	 *    with a NEW-schema field.logicRule containing nested AND/OR/NOT
	 *    groups (exercises the full Rule Builder, Live Preview/Rule
	 *    Debugger, and Rule Inspector immediately on open, no setup needed).
	 * Drag & drop, multi-selection, keyboard shortcuts, copy/paste,
	 * duplicate, and the floating toolbar are pure canvas interactions —
	 * they work on any loaded form, so this template just needs to have
	 * enough varied, nested content for those to be worth trying, which it
	 * does by construction (7+ top-level items, 3 levels of nesting).
	 */
	private static function showcase_qa_template() {
		return [
			'label'       => __( 'Builder Showcase (QA/Dev)', 'chargeforms' ),
			'description' => __( 'Every completed builder capability in one form — layout nesting, containers, varied field settings, and both the legacy and new conditional-logic Rule Builder. Internal testing use.', 'chargeforms' ),
			'icon'        => 'dashicons-screenoptions',
			'category'    => 'developer',
			'fields'      => [
				[ 'id' => 'f_showcase_heading', 'type' => 'html', 'content' => '<h3>' . __( 'Builder Capability Showcase', 'chargeforms' ) . '</h3><p>' . __( 'This form exists to manually exercise every completed builder feature. Drag fields to reorder, shift-click to multi-select, Ctrl/Cmd+D to duplicate, Ctrl/Cmd+C/V to copy-paste, and open the two conditional-logic fields near the bottom to test the Rule Builder.', 'chargeforms' ) . '</p>' ],

				// Layout Engine: Section > Row > [Column, Column], one Column
				// holding a plain Container wrapping two more fields — Section,
				// Row, Column, and Container all present and nested, not flat.
				[
					'id'       => 'f_showcase_section',
					'type'     => 'section',
					'label'    => __( 'Layout Engine: Nested Sections, Columns & Containers', 'chargeforms' ),
					'children' => [
						[
							'id'       => 'f_showcase_row',
							'type'     => 'row',
							'children' => [
								[
									'id'         => 'f_showcase_col_1',
									'type'       => 'column',
									'width'      => '50',
									'widthMobile' => '100',
									'children'   => [
										[ 'id' => 'f_showcase_first_name', 'type' => 'text', 'label' => __( 'First Name', 'chargeforms' ), 'required' => true ],
										[ 'id' => 'f_showcase_last_name', 'type' => 'text', 'label' => __( 'Last Name', 'chargeforms' ), 'required' => true ],
									],
								],
								[
									'id'         => 'f_showcase_col_2',
									'type'       => 'column',
									'width'      => '50',
									'widthMobile' => '100',
									'children'   => [
										[
											'id'       => 'f_showcase_container',
											'type'     => 'container',
											'label'    => __( 'Container (nested inside a Column, inside a Row, inside a Section)', 'chargeforms' ),
											'children' => [
												[ 'id' => 'f_showcase_email', 'type' => 'email', 'label' => __( 'Email', 'chargeforms' ), 'required' => true ],
												[ 'id' => 'f_showcase_phone', 'type' => 'phone', 'label' => __( 'Phone', 'chargeforms' ) ],
											],
										],
									],
								],
							],
						],
					],
				],

				// Universal Field Capabilities / Settings Categories — a
				// deliberately varied spread so General/Advanced/Conditional
				// settings panels all have something real to inspect across
				// several field types, not just plain text inputs.
				[ 'id' => 'f_country', 'type' => 'select', 'label' => __( 'Country', 'chargeforms' ), 'required' => true, 'options' => [ __( 'Germany', 'chargeforms' ), __( 'France', 'chargeforms' ), __( 'United States', 'chargeforms' ), __( 'Other', 'chargeforms' ) ] ],
				[ 'id' => 'f_customer_type', 'type' => 'radio', 'label' => __( 'Customer Type', 'chargeforms' ), 'required' => true, 'options' => [ __( 'Individual', 'chargeforms' ), __( 'Business', 'chargeforms' ) ] ],
				[ 'id' => 'f_signup_date', 'type' => 'date', 'label' => __( 'Preferred Start Date', 'chargeforms' ) ],
				[ 'id' => 'f_satisfaction', 'type' => 'range_slider', 'label' => __( 'Expected Satisfaction', 'chargeforms' ), 'min' => 0, 'max' => 100, 'step' => 10 ],
				[ 'id' => 'f_attachment', 'type' => 'file', 'label' => __( 'Supporting Document', 'chargeforms' ), 'allowedExtensions' => 'pdf,doc,docx', 'maxSizeMb' => 5 ],
				[ 'id' => 'f_plan', 'type' => 'payment_item', 'label' => __( 'Plan', 'chargeforms' ), 'amount' => 25 ],

				// Conditional Logic — legacy shape (auto-migrates to the new
				// engine schema the first time "Enable conditional logic" is
				// toggled off/on in the builder).
				[
					'id'          => 'f_newsletter_topic',
					'type'        => 'select',
					'label'       => __( 'Newsletter Topic', 'chargeforms' ),
					'options'     => [ __( 'Product Updates', 'chargeforms' ), __( 'Company News', 'chargeforms' ) ],
					'conditional' => [
						'enabled' => true,
						'action'  => 'show',
						'groups'  => [
							[ 'logic' => 'all', 'rules' => [ [ 'field' => 'f_country', 'operator' => 'is_not_empty', 'value' => '' ] ] ],
						],
					],
				],

				// Conditional Logic — new engine schema, pre-populated with
				// nested AND/OR/NOT groups so opening this field's settings
				// immediately shows the full Rule Builder, Live Preview/Rule
				// Debugger, and Rule Inspector with real content to inspect,
				// no manual setup required to start testing.
				[
					'id'        => 'f_vat_number',
					'type'      => 'text',
					'label'     => __( 'VAT Number', 'chargeforms' ),
					'logicRule' => [
						'id'            => 'rule_showcase_vat',
						'schemaVersion' => 1,
						'name'          => 'Show VAT for EU business customers',
						'enabled'       => true,
						'scope'         => 'field',
						'trigger'       => [
							'id'         => 'g_showcase_root',
							'type'       => 'group',
							'combinator' => 'AND',
							'not'        => false,
							'children'   => [
								[
									'id'         => 'g_showcase_country',
									'type'       => 'group',
									'combinator' => 'OR',
									'not'        => false,
									'children'   => [
										[ 'id' => 'c_showcase_de', 'type' => 'condition', 'source' => 'field', 'ref' => 'f_country', 'operator' => 'is', 'value' => 'Germany' ],
										[ 'id' => 'c_showcase_fr', 'type' => 'condition', 'source' => 'field', 'ref' => 'f_country', 'operator' => 'is', 'value' => 'France' ],
									],
								],
								[
									'id'         => 'g_showcase_not_individual',
									'type'       => 'group',
									'combinator' => 'AND',
									'not'        => true,
									'children'   => [
										[ 'id' => 'c_showcase_individual', 'type' => 'condition', 'source' => 'field', 'ref' => 'f_customer_type', 'operator' => 'is', 'value' => 'Individual' ],
									],
								],
							],
						],
						'actions'  => [ [ 'type' => 'show', 'target' => 'f_vat_number' ] ],
						'priority' => 0,
					],
				],
			],
		];
	}

	public function render() {
		$view = isset( $_GET['view'] ) ? sanitize_key( wp_unslash( $_GET['view'] ) ) : 'picker'; // phpcs:ignore WordPress.Security.NonceVerification.Recommended
		if ( ! in_array( $view, [ 'templates', 'packs' ], true ) ) {
			$view = 'picker';
		}
		$pack_key = isset( $_GET['pack'] ) ? sanitize_key( wp_unslash( $_GET['pack'] ) ) : ''; // phpcs:ignore WordPress.Security.NonceVerification.Recommended
		$packs    = self::packs();
		?>
		<div class="wrap chargeforms-wrap">
			<?php Page_Header::render( 'chargeforms-new' ); ?>

			<?php if ( 'packs' === $view ) : ?>
				<a href="<?php echo esc_url( admin_url( 'admin.php?page=chargeforms-new' ) ); ?>" class="chargeforms-back-link">&larr; <?php esc_html_e( 'Back', 'chargeforms' ); ?></a>
				<h1><?php esc_html_e( 'Industry Packs', 'chargeforms' ); ?></h1>
				<p><?php esc_html_e( 'A curated set of templates for your specific industry — click a pack to see its templates, no extra page to load. Every form is fully editable afterward, same as any other template.', 'chargeforms' ); ?></p>

				<div class="chargeforms-pack-accordion" id="chargeforms-pack-accordion">
					<?php foreach ( $packs as $pack_slug => $pack ) : ?>
						<?php $pack_templates = self::templates_for_pack( $pack_slug ); ?>
						<div class="chargeforms-pack-section<?php echo ( $pack_key === $pack_slug ) ? ' is-expanded' : ''; ?>" data-pack="<?php echo esc_attr( $pack_slug ); ?>">
							<button type="button" class="chargeforms-pack-section-head">
								<span class="chargeforms-pack-card-icon">
									<?php Icon::render( str_replace( 'dashicons-', '', $pack['icon'] ) ); ?>
								</span>
								<span class="chargeforms-pack-section-title">
									<h3><?php echo esc_html( $pack['label'] ); ?></h3>
									<p><?php echo esc_html( $pack['description'] ); ?></p>
								</span>
								<span class="chargeforms-pack-card-count">
									<?php
									printf(
										/* translators: %d: number of templates in this pack */
										esc_html( _n( '%d template', '%d templates', count( $pack_templates ), 'chargeforms' ) ),
										count( $pack_templates )
									);
									?>
								</span>
								<?php Icon::render( 'chevron-down', 16, 'chargeforms-pack-section-chevron' ); ?>
							</button>
							<div class="chargeforms-pack-section-body">
								<div class="chargeforms-template-grid">
									<?php foreach ( $pack_templates as $key => $template ) :
										?>
										<form method="post" action="<?php echo esc_url( admin_url( 'admin-post.php' ) ); ?>" class="chargeforms-template-card">
											<input type="hidden" name="action" value="chargeforms_create_from_template">
											<input type="hidden" name="template" value="<?php echo esc_attr( $key ); ?>">
											<?php wp_nonce_field( 'chargeforms_create_from_template' ); ?>
											<?php Icon::render( str_replace( 'dashicons-', '', $template['icon'] ) ); ?>
											<div class="chargeforms-template-tags">
												<span class="chargeforms-template-cat-tag" style="color:<?php echo esc_attr( self::category_color( $template['category'] ) ); ?>;background:<?php echo esc_attr( self::category_color( $template['category'] ) ); ?>1a;"><?php echo esc_html( self::categories()[ $template['category'] ] ?? $template['category'] ); ?></span>
												<?php if ( self::template_has_payment( $template ) ) : ?>
													<span class="chargeforms-template-payment-tag"><?php esc_html_e( 'PAYMENT', 'chargeforms' ); ?></span>
												<?php endif; ?>
											</div>
											<h3><?php echo esc_html( $template['label'] ); ?></h3>
											<p><?php echo esc_html( $template['description'] ); ?></p>
											<button type="submit" class="button button-primary"><?php esc_html_e( 'Use this template', 'chargeforms' ); ?></button>
										</form>
									<?php endforeach; ?>
								</div>
							</div>
						</div>
					<?php endforeach; ?>
				</div>

				<?php
				wp_add_inline_script( 'chargeforms-admin', '				( function () {
					var sections = document.querySelectorAll( \'#chargeforms-pack-accordion .chargeforms-pack-section\' );
					Array.prototype.forEach.call( sections, function ( section ) {
						section.querySelector( \'.chargeforms-pack-section-head\' ).addEventListener( \'click\', function () {
							var wasExpanded = section.classList.contains( \'is-expanded\' );
							Array.prototype.forEach.call( sections, function ( s ) { s.classList.remove( \'is-expanded\' ); } );
							if ( ! wasExpanded ) {
								section.classList.add( \'is-expanded\' );
								section.scrollIntoView( { behavior: \'smooth\', block: \'nearest\' } );
							}
						} );
					} );
				} )();'
				);
				?>

			<?php elseif ( 'templates' === $view ) : ?>
				<a href="<?php echo esc_url( admin_url( 'admin.php?page=chargeforms-new' ) ); ?>" class="chargeforms-back-link">&larr; <?php esc_html_e( 'Back', 'chargeforms' ); ?></a>
				<h1><?php esc_html_e( 'Choose a Template', 'chargeforms' ); ?></h1>
				<p><?php esc_html_e( 'Pick a pre-made form template and customize it. Every template is fully editable in the builder afterward.', 'chargeforms' ); ?></p>

				<?php
				// The design source (design_handoff_chargeforms/ChargeForms
				// Screens.dc.html, `isNewForm`) lays this out as a 210px
				// category sidebar beside the template grid, each category
				// carrying its own count — not the horizontal pill row this
				// used to render. The buttons keep their existing
				// `data-category` contract so the filter JS below is
				// unchanged; only their container and styling move.
				$category_counts = [];
				foreach ( self::templates() as $counted_template ) {
					$counted_cat                     = $counted_template['category'];
					$category_counts[ $counted_cat ] = ( $category_counts[ $counted_cat ] ?? 0 ) + 1;
				}
				?>
				<div class="chargeforms-template-shell">
				<div class="chargeforms-template-categories" id="chargeforms-template-categories">
					<div class="chargeforms-template-categories-head"><?php esc_html_e( 'Categories', 'chargeforms' ); ?></div>
					<button type="button" class="chargeforms-template-category-btn is-active" data-category="all">
						<?php esc_html_e( 'All', 'chargeforms' ); ?>
						<span class="chargeforms-template-category-count"><?php echo (int) count( self::templates() ); ?></span>
					</button>
					<?php foreach ( self::categories() as $cat_key => $cat_label ) : ?>
						<button type="button" class="chargeforms-template-category-btn" data-category="<?php echo esc_attr( $cat_key ); ?>">
							<?php echo esc_html( $cat_label ); ?>
							<span class="chargeforms-template-category-count"><?php echo (int) ( $category_counts[ $cat_key ] ?? 0 ); ?></span>
						</button>
					<?php endforeach; ?>
				</div>

				<div class="chargeforms-template-main">
				<div class="chargeforms-template-grid" id="chargeforms-template-grid">
					<?php foreach ( self::templates() as $key => $template ) :
						?>
						<form method="post" action="<?php echo esc_url( admin_url( 'admin-post.php' ) ); ?>" class="chargeforms-template-card" data-category="<?php echo esc_attr( $template['category'] ); ?>">
							<input type="hidden" name="action" value="chargeforms_create_from_template">
							<input type="hidden" name="template" value="<?php echo esc_attr( $key ); ?>">
							<?php wp_nonce_field( 'chargeforms_create_from_template' ); ?>
							<?php Icon::render( str_replace( 'dashicons-', '', $template['icon'] ) ); ?>
							<div class="chargeforms-template-tags">
								<span class="chargeforms-template-cat-tag" style="color:<?php echo esc_attr( self::category_color( $template['category'] ) ); ?>;background:<?php echo esc_attr( self::category_color( $template['category'] ) ); ?>1a;"><?php echo esc_html( self::categories()[ $template['category'] ] ?? $template['category'] ); ?></span>
								<?php if ( self::template_has_payment( $template ) ) : ?>
									<span class="chargeforms-template-payment-tag"><?php esc_html_e( 'PAYMENT', 'chargeforms' ); ?></span>
								<?php endif; ?>
							</div>
							<h3><?php echo esc_html( $template['label'] ); ?></h3>
							<p><?php echo esc_html( $template['description'] ); ?></p>
							<button type="submit" class="button button-primary"><?php esc_html_e( 'Use this template', 'chargeforms' ); ?></button>
						</form>
					<?php endforeach; ?>
				</div>
				<p class="chargeforms-template-empty" id="chargeforms-template-empty" style="display:none;"><?php esc_html_e( 'No templates in this category yet.', 'chargeforms' ); ?></p>
				</div><?php // .chargeforms-template-main ?>
				</div><?php // .chargeforms-template-shell ?>

				<?php
				wp_add_inline_script( 'chargeforms-admin', '				( function () {
					var buttons = document.querySelectorAll( \'#chargeforms-template-categories .chargeforms-template-category-btn\' );
					var cards = document.querySelectorAll( \'#chargeforms-template-grid .chargeforms-template-card\' );
					var empty = document.getElementById( \'chargeforms-template-empty\' );
					Array.prototype.forEach.call( buttons, function ( btn ) {
						btn.addEventListener( \'click\', function () {
							Array.prototype.forEach.call( buttons, function ( b ) { b.classList.remove( \'is-active\' ); } );
							btn.classList.add( \'is-active\' );
							var category = btn.getAttribute( \'data-category\' );
							var visible = 0;
							Array.prototype.forEach.call( cards, function ( card ) {
								var show = category === \'all\' || card.getAttribute( \'data-category\' ) === category;
								card.style.display = show ? \'\' : \'none\';
								if ( show ) visible++;
							} );
							empty.style.display = visible === 0 ? \'\' : \'none\';
						} );
					} );
				} )();'
				);
				?>

			<?php else : ?>
				<div class="chargeforms-new-form-topbar">
					<div class="chargeforms-page-title-block">
						<h1><?php esc_html_e( 'Create A New Form', 'chargeforms' ); ?></h1>
						<div class="chargeforms-page-subtitle"><?php esc_html_e( 'Start blank, pick a template, or import a form you exported earlier.', 'chargeforms' ); ?></div>
					</div>
					<button type="button" class="button" id="chargeforms-import-form-btn"><?php esc_html_e( 'Import Form', 'chargeforms' ); ?></button>
				</div>

				<form method="post" action="<?php echo esc_url( admin_url( 'admin-post.php' ) ); ?>" enctype="multipart/form-data" id="chargeforms-import-form" style="display:none;">
					<input type="hidden" name="action" value="chargeforms_import_form">
					<?php wp_nonce_field( 'chargeforms_import_form' ); ?>
					<input type="file" name="chargeforms_import_file" accept="application/json" id="chargeforms-import-file-input">
				</form>
				<?php
				wp_add_inline_script( 'chargeforms-admin', '				( function () {
					var btn = document.getElementById( \'chargeforms-import-form-btn\' );
					var input = document.getElementById( \'chargeforms-import-file-input\' );
					var form = document.getElementById( \'chargeforms-import-form\' );
					if ( ! btn || ! input || ! form ) { return; }
					btn.addEventListener( \'click\', function () { input.click(); } );
					input.addEventListener( \'change\', function () { if ( input.files.length ) { form.submit(); } } );
				} )();'
				);
				?>

				<div class="chargeforms-new-form-grid">
					<form method="post" action="<?php echo esc_url( admin_url( 'admin-post.php' ) ); ?>" class="chargeforms-new-form-card">
						<input type="hidden" name="action" value="chargeforms_create_from_template">
						<input type="hidden" name="template" value="blank">
						<?php wp_nonce_field( 'chargeforms_create_from_template' ); ?>
						<button type="submit" class="chargeforms-new-form-card-btn">
							<span class="chargeforms-new-form-card-icon chargeforms-new-form-card-icon-dashed">
								<?php Icon::render( 'plus' ); ?>
							</span>
							<h3><?php esc_html_e( 'New Blank Form', 'chargeforms' ); ?></h3>
							<p><?php esc_html_e( 'Create a New Blank form from scratch.', 'chargeforms' ); ?></p>
						</button>
					</form>

					<a href="<?php echo esc_url( admin_url( 'admin.php?page=chargeforms-new&view=templates' ) ); ?>" class="chargeforms-new-form-card">
						<span class="chargeforms-new-form-card-icon">
							<?php Icon::render( 'layout' ); ?>
						</span>
						<h3><?php esc_html_e( 'Choose a Template', 'chargeforms' ); ?></h3>
						<p><?php esc_html_e( 'Choose a pre-made form template and customize it.', 'chargeforms' ); ?></p>
					</a>

					<a href="<?php echo esc_url( admin_url( 'admin.php?page=chargeforms-new&view=packs' ) ); ?>" class="chargeforms-new-form-card chargeforms-new-form-card-highlight">
						<span class="chargeforms-new-form-card-icon chargeforms-new-form-card-icon-packs">
							<?php Icon::render( 'store' ); ?>
						</span>
						<h3><?php esc_html_e( 'Industry Packs', 'chargeforms' ); ?> <span class="chargeforms-badge-new"><?php esc_html_e( 'New', 'chargeforms' ); ?></span></h3>
						<p><?php esc_html_e( 'Ready-made template sets for Real Estate, Healthcare, Education, Legal, Restaurant, Events, and Non-profit.', 'chargeforms' ); ?></p>
					</a>

					<a href="<?php echo esc_url( admin_url( 'admin.php?page=chargeforms-new' ) ); ?>" class="chargeforms-new-form-card">
						<span class="chargeforms-new-form-card-icon">
							<?php Icon::render( 'message-square' ); ?>
						</span>
						<h3><?php esc_html_e( 'Create Conversational Form', 'chargeforms' ); ?> <span class="chargeforms-badge-new"><?php esc_html_e( 'Available', 'chargeforms' ); ?></span></h3>
						<p><?php esc_html_e( 'Turn your form into a one-question-at-a-time conversation.', 'chargeforms' ); ?></p>
					</a>

					<a href="<?php echo esc_url( admin_url( 'admin.php?page=chargeforms-new' ) ); ?>" class="chargeforms-new-form-card">
						<span class="chargeforms-new-form-card-icon">
							<?php Icon::render( 'file-text' ); ?>
						</span>
						<h3><?php esc_html_e( 'Create a Post Form', 'chargeforms' ); ?> <span class="chargeforms-badge-new"><?php esc_html_e( 'Available', 'chargeforms' ); ?></span></h3>
						<p><?php esc_html_e( 'Add Post Title and Post Content fields, then enable post creation in form settings.', 'chargeforms' ); ?></p>
					</a>

					<a href="<?php echo esc_url( admin_url( 'admin.php?page=chargeforms-settings&section=mcp' ) ); ?>" class="chargeforms-new-form-card chargeforms-new-form-card-highlight">
						<span class="chargeforms-new-form-card-icon chargeforms-new-form-card-icon-ai">
							<?php Icon::render( 'sparkles' ); ?>
						</span>
						<h3><?php esc_html_e( 'Create Using AI', 'chargeforms' ); ?> <span class="chargeforms-badge-new"><?php esc_html_e( 'MCP', 'chargeforms' ); ?></span></h3>
						<p><?php esc_html_e( 'Connect your own AI client through MCP and build forms with a preview before changes are saved.', 'chargeforms' ); ?></p>
					</a>
				</div>
			<?php endif; ?>
		</div>
		<?php
	}

	/** Imports a form from a JSON file previously produced by Forms_List_Page's per-form export — round-trips { title, fields, settings }. */
	public function handle_import() {
		if ( ! current_user_can( 'chargeforms_manage_forms' ) || ! check_admin_referer( 'chargeforms_import_form' ) ) {
			wp_die( esc_html__( 'Not allowed.', 'chargeforms' ), 403 );
		}

		if ( empty( $_FILES['chargeforms_import_file']['tmp_name'] ) || UPLOAD_ERR_OK !== ( $_FILES['chargeforms_import_file']['error'] ?? UPLOAD_ERR_NO_FILE ) ) { // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized -- checked against the UPLOAD_ERR_OK constant, not used as data.
			wp_die( esc_html__( 'No file was uploaded, or the upload failed.', 'chargeforms' ), 400 );
		}

		// tmp_name is PHP's own upload-tmp-dir path, not attacker-supplied content.
		$contents = file_get_contents( $_FILES['chargeforms_import_file']['tmp_name'] ); // phpcs:ignore WordPress.WP.AlternativeFunctions.file_system_operations_file_get_contents, WordPress.Security.ValidatedSanitizedInput.InputNotSanitized
		$data     = json_decode( $contents, true );

		if ( ! is_array( $data ) || empty( $data['fields'] ) || ! is_array( $data['fields'] ) ) {
			wp_die( esc_html__( 'That file doesn\'t look like a valid ChargeForms export.', 'chargeforms' ), 400 );
		}

		// An export made before the field.conditional -> field.logicRule
		// migration could still carry the legacy shape — no special
		// handling needed here though: Form::create() migrates every
		// field at the write boundary (see class-form.php), so nothing
		// un-migrated can land in the database via this or any other path.
		$form = Form::create( [
			'title'    => ! empty( $data['title'] ) ? sanitize_text_field( $data['title'] ) . ' (Imported)' : __( 'Imported Form', 'chargeforms' ),
			'fields'   => $data['fields'],
			'settings' => is_array( $data['settings'] ?? null ) ? $data['settings'] : [],
		] );

		if ( is_wp_error( $form ) ) {
			wp_die( esc_html( $form->get_error_message() ), 400 );
		}

		wp_safe_redirect( admin_url( 'admin.php?page=chargeforms-builder&form_id=' . $form['id'] ) );
		exit;
	}

	public function handle_create() {
		if ( ! current_user_can( 'chargeforms_manage_forms' ) || ! check_admin_referer( 'chargeforms_create_from_template' ) ) {
			wp_die( esc_html__( 'Not allowed.', 'chargeforms' ), 403 );
		}

		$key       = isset( $_POST['template'] ) ? sanitize_key( $_POST['template'] ) : 'blank';
		$templates = self::templates();
		$template  = $templates[ $key ] ?? $templates['blank'];

		$form = Form::create( [
			'title'    => $template['label'],
			'fields'   => $template['fields'],
			'settings' => $template['settings'] ?? [],
		] );

		if ( is_wp_error( $form ) ) {
			wp_die( esc_html( $form->get_error_message() ), 400 );
		}

		wp_safe_redirect( admin_url( 'admin.php?page=chargeforms-builder&form_id=' . $form['id'] ) );
		exit;
	}
}