/**
 * Validation
 *
 * Complete form field validation system with states, error messaging, UI components,
 * and accessibility support (WCAG 2.1 AA compliant).
 *
 * Provides:
 * - Field validation states (error, success, validating)
 * - Error and success message displays
 * - Validation summary panels
 * - Navigation button states
 * - Field wrapper containers
 * - Full accessibility support
 *
 * Used by: SCD.ValidationError.js (client-side validation)
 * Loaded on: pages=wsscd-campaigns, wsscd-analytics; conditionally on action=wizard
 *
 * @package    SmartCycleDiscounts
 * @subpackage SmartCycleDiscounts/resources/assets/css/admin/validation.css
 * @author     Webstepper.io <contact@webstepper.io>
 * @copyright  2025 Webstepper.io
 * @license    GPL-3.0-or-later https://www.gnu.org/licenses/gpl-3.0.html
 * @link       https://webstepper.io/wordpress/plugins/smart-cycle-discounts/
 * @since      1.0.0
 */

/* ==========================================================================
   Field Wrapper Containers
   ========================================================================== */

/**
 * Field wrapper container.
 * Provides consistent spacing and positioning context for field validation states.
 * Used in ValidationError.js as container selector for error state management.
 */
.wsscd-field-wrapper {
	position: relative;
	margin-bottom: var(--wsscd-spacing-lg);
	transition: all var(--wsscd-transition-base) ease;
}

/* ==========================================================================
   Error State - Input Fields
   ========================================================================== */

/**
 * Error state for all input types, select, and textarea elements.
 * Supports two application patterns:
 * 1. Container-based: .has-error class on parent container
 * 2. Direct: .error class on input element itself
 *
 * Specificity: (0,2,1) to override WordPress core input[type] styles (0,1,1)
 */
.has-error input,
.has-error select,
.has-error textarea,
input.error,
select.error,
textarea.error {
	border-color: var(--wsscd-color-danger);
	border-width: var(--wsscd-border-width-thick);
	background-color: var(--wsscd-alert-danger-bg);
	color: var(--wsscd-color-text);
}

/**
 * Focus state for error fields.
 * Maintains error border color without adding ring (mouse clicks).
 */
.has-error input:focus,
.has-error select:focus,
.has-error textarea:focus,
input.error:focus,
select.error:focus,
textarea.error:focus {
	border-color: var(--wsscd-color-danger);
	outline: none;
}

/**
 * Focus-visible state for error fields.
 * Border color change is sufficient - no outline ring needed.
 */
.has-error input:focus-visible,
.has-error select:focus-visible,
.has-error textarea:focus-visible,
input.error:focus-visible,
select.error:focus-visible,
textarea.error:focus-visible {
	outline: none;
}

/* ==========================================================================
   Error State - Tom Select Integration
   ========================================================================== */

/**
 * Tom Select error state override.
 * WordPress core applies .error styles globally, but Tom Select wrapper needs
 * to remain transparent so only the .ts-control receives styling.
 */
.ts-wrapper.error {
	background: transparent;
	border: none;
	box-shadow: none;
	margin: 0;
	padding: 0;
}

/* ==========================================================================
   Success State
   ========================================================================== */

/**
 * Success state for validated fields.
 * Applied after successful validation to provide positive feedback.
 */
.wsscd-field-container.has-success input,
.wsscd-field-container.has-success select,
.wsscd-field-container.has-success textarea,
.has-success input,
.has-success select,
.has-success textarea,
.wsscd-wizard-page .has-success input,
.wsscd-wizard-page .has-success select,
.wsscd-wizard-page .has-success textarea {
	border-color: var(--wsscd-color-success);
	border-width: var(--wsscd-border-width-thick);
	background-color: var(--wsscd-alert-success-bg);
}

/**
 * Success state checkmark indicator.
 * Displays visual checkmark after field when validation succeeds.
 */
.has-success::after {
	content: '✓';
	position: absolute;
	right: var(--wsscd-spacing-sm);
	top: 50%;
	transform: translateY(-50%);
	color: var(--wsscd-color-success);
	font-size: var(--wsscd-font-size-xxl);
	font-weight: var(--wsscd-font-weight-bold);
	animation: wsscd-fade-in var(--wsscd-transition-base) ease;
}

/* ==========================================================================
   Validating State
   ========================================================================== */

/**
 * Validating state indicator.
 * Shows animated spinner while async validation is in progress.
 * Uses CSS mask for theme color support - spinner inherits primary color.
 */
.wsscd-field--validating input,
.wsscd-field--validating select,
.wsscd-field--validating textarea {
	padding-right: var(--wsscd-spacing-xxl);
	position: relative;
}

/* Spinner using CSS mask for theme color support */
.wsscd-field--validating::after {
	content: '';
	position: absolute;
	right: var(--wsscd-spacing-sm);
	top: 50%;
	transform: translateY(-50%);
	width: var(--wsscd-icon-small);
	height: var(--wsscd-icon-small);
	border: 2px solid var(--wsscd-color-border-light);
	border-top-color: var(--wsscd-color-primary);
	border-radius: 50%;
	animation: wsscd-spin 0.8s linear infinite;
	pointer-events: none;
}

/**
 * Container state for validating fields.
 * Provides positioning context for validation indicators.
 */
.wsscd-field--validating {
	position: relative;
}

/* ==========================================================================
   Error Messages
   ========================================================================== */

/**
 * Error message element.
 * Displayed below invalid fields with animation for visual feedback.
 * Forces full width and new line in flex layouts.
 */
.wsscd-field-error {
	display: block;
	width: 100%;
	flex-basis: 100%;
	margin-top: var(--wsscd-spacing-xs);
	margin-bottom: 0;
	font-size: var(--wsscd-font-size-small);
	line-height: var(--wsscd-line-height-base);
	color: var(--wsscd-color-danger);
	animation: wsscd-fade-in var(--wsscd-transition-base) ease;
}

/**
 * Inline error message variant.
 * Used for compact layouts where error appears inline with field.
 */
.wsscd-field-error--inline {
	font-weight: var(--wsscd-font-weight-medium);
}

/**
 * Stock-sufficiency hint.
 * Shown live as the merchant configures tier/BOGO/BXGY/bundle quantities
 * and the configured values exceed what current product stock can support.
 * Informational (warning colour), not a hard error.
 */
.wsscd-stock-hint {
	display: block;
	width: 100%;
	flex-basis: 100%;
	margin-top: var(--wsscd-spacing-xs);
	padding: var(--wsscd-spacing-xs) var(--wsscd-spacing-sm);
	font-size: var(--wsscd-font-size-small);
	line-height: var(--wsscd-line-height-base);
	color: var(--wsscd-color-warning, #8a6d3b);
	background-color: rgba( 255, 193, 7, 0.08 );
	border-left: 3px solid var(--wsscd-color-warning, #ffc107);
	border-radius: var(--wsscd-radius-sm, 3px);
	animation: wsscd-fade-in var(--wsscd-transition-base) ease;
}

/**
 * Blocking variant: configuration cannot produce a valid discount
 * (e.g. fixed discount exceeds product price). Red severity to signal
 * the merchant must resolve before saving yields an effective campaign.
 */
.wsscd-stock-hint--blocking {
	color: var(--wsscd-color-danger, #a94442);
	background-color: rgba( 220, 53, 69, 0.08 );
	border-left-color: var(--wsscd-color-danger, #dc3545);
}

/* ==========================================================================
   Success Messages
   ========================================================================== */

/**
 * Success message element.
 * Displayed below fields after successful validation.
 * Hidden by default, shown with .wsscd-success--visible class.
 */
.wsscd-field-success {
	display: none;
	margin-top: var(--wsscd-spacing-xs);
	font-size: var(--wsscd-font-size-small);
	color: var(--wsscd-color-success);
}

.wsscd-field-success.wsscd-success--visible {
	display: block;
	animation: wsscd-fade-in var(--wsscd-transition-base) ease;
}

/* ==========================================================================
   Validation Summary Panel
   ========================================================================== */

/**
 * Validation summary panel.
 * Displays list of all validation errors at top of form.
 * WordPress 6.4+ admin notice styling.
 */
.wsscd-validation-summary {
	margin: var(--wsscd-spacing-lg) 0;
	padding: var(--wsscd-spacing-md);
	background-color: var(--wsscd-color-error-bg);
	border: 1px solid var(--wsscd-color-danger);
	border-left-width: var(--wsscd-border-width-accent);
	border-radius: var(--wsscd-radius-md);
	animation: wsscd-fade-in var(--wsscd-transition-base) ease;
	box-shadow: var(--wsscd-shadow-sm);
}

.wsscd-validation-summary__header {
	display: flex;
	align-items: center;
	gap: var(--wsscd-spacing-md);
	margin-bottom: var(--wsscd-spacing-md);
}

.wsscd-validation-summary__header .wsscd-icon {
	color: var(--wsscd-color-danger);
	font-size: var(--wsscd-font-size-xxxl);
}

.wsscd-validation-summary__header h4 {
	margin: 0;
	font-size: 1rem;
	font-weight: var(--wsscd-font-weight-semibold);
	color: var(--wsscd-color-danger);
}

.wsscd-validation-summary__list {
	margin: 0;
	padding-left: 2rem;
	list-style-type: disc;
}

.wsscd-validation-summary__list li {
	margin-bottom: var(--wsscd-spacing-xs);
	color: var(--wsscd-color-text);
	font-size: var(--wsscd-font-size-base);
}

.wsscd-validation-summary__list a {
	color: var(--wsscd-color-primary);
	text-decoration: none;
	font-weight: var(--wsscd-font-weight-medium);
}

.wsscd-validation-summary__list a:hover,
.wsscd-validation-summary__list a:focus {
	text-decoration: underline;
	color: var(--wsscd-color-primary-hover);
}

/* ==========================================================================
   Navigation Button States
   ========================================================================== */

/**
 * Disabled navigation button state.
 * Applied when validation fails and navigation should be prevented.
 */
.wsscd-wizard-page .wsscd-nav-btn--next:disabled {
	opacity: 0.3;
	cursor: not-allowed;
	background-color: var(--wsscd-color-surface);
	color: var(--wsscd-color-text-lighter);
	border-color: var(--wsscd-color-border);
}

.wsscd-wizard-page .wsscd-nav-btn--next:disabled:hover {
	background-color: var(--wsscd-color-surface);
	color: var(--wsscd-color-text-lighter);
	box-shadow: none;
}

/* ==========================================================================
   WordPress Admin Integration
   ========================================================================== */

/**
 * WordPress admin compatibility.
 * Ensures error messages display correctly in WordPress admin contexts.
 */
.wp-admin .wsscd-field-error,
.wp-admin .field-error {
	clear: both;
	display: block;
}

/**
 * Form table integration.
 * Highlights table header label when field in same row has error.
 */
.form-table .has-error th {
	color: var(--wsscd-color-danger);
	font-weight: var(--wsscd-font-weight-semibold);
}

/* ==========================================================================
   Accessibility Support
   ========================================================================== */

/**
 * Screen reader only text.
 * Visually hidden but available to assistive technologies.
 * Uses clip method for maximum compatibility.
 */
.screen-reader-text {
	position: absolute !important;
	clip: rect(1px, 1px, 1px, 1px);
	height: 1px;
	width: 1px;
	overflow: hidden;
	word-wrap: normal !important;
}

/* ==========================================================================
   Media Queries - Accessibility & Responsive
   ========================================================================== */

/**
 * High Contrast Mode
 * Enhanced visibility for users with visual impairments or high contrast preferences.
 */
@media (prefers-contrast: high) {
	.has-error input,
	.has-error select,
	.has-error textarea,
	input.error,
	select.error,
	textarea.error,
	.ts-wrapper.error .ts-control {
		outline: 3px solid var(--wsscd-color-danger);
		outline-offset: 2px;
	}

	.wsscd-field-error {
		font-weight: var(--wsscd-font-weight-bold);
		text-decoration: underline;
	}
}

/**
 * Reduced Motion
 * Respects user preference for reduced animations (accessibility, vestibular disorders).
 */
@media (prefers-reduced-motion: reduce) {
	.wsscd-field-error,
	.wsscd-field-success,
	.wsscd-validation-summary,
	.has-success::after {
		animation: none;
		transition: none;
	}
}

/**
 * Dark Mode
 * Automatic dark mode support for users with dark color scheme preference.
 */
@media (prefers-color-scheme: dark) {
	.has-error input,
	.has-error select,
	.has-error textarea,
	input.error,
	select.error,
	textarea.error,
	.ts-wrapper.error .ts-control {
		background-color: var(--wsscd-color-danger-alpha-15);
		border-color: var(--wsscd-color-danger-light);
	}

	.wsscd-field-error {
		color: var(--wsscd-color-danger-light);
	}
}

/**
 * Mobile & Responsive
 * WordPress admin breakpoint at 782px.
 */
@media screen and (max-width: 782px) {
	.wsscd-field-error {
		font-size: 0.8125em;
	}

	.has-error input,
	.has-error select,
	.has-error textarea {
		margin-bottom: var(--wsscd-spacing-xs);
	}
}

/**
 * Print Styles
 * Ensure validation errors are clearly visible when printed.
 */
@media print {
	.wsscd-field-error::before {
		content: "[Error] ";
		position: static;
		background: none;
		color: inherit;
	}

	.has-error input,
	.has-error select,
	.has-error textarea,
	.ts-wrapper.error .ts-control {
		border: 1px solid var(--wsscd-color-text);
		background: none;
	}
}