<?php
/**
 * The options engine: the shared addon_boss_* primitives that make a product
 * offer choices.
 *
 * Everything here is part of the plugin proper and present in every build. It
 * holds the option-set store and schema, the field-type registry, the
 * sanitiser, the value and fee resolvers, the field renderer, virtual
 * variations and the grid split.
 */

defined( 'ABSPATH' ) || exit;

// =================================================================
// Field schema - types, def sanitiser, option parser. Lifted UNCHANGED from
// the earlier bundle-side layout; shared by the bundle personalisation
// surface and the standalone product-options surface.
// =================================================================

/**
 * The add-on field types.
 *
 * The engine's own types are listed here; a type whose machinery lives in a
 * module (a file field needs somewhere for the file to go, a measured size
 * field the measurement maths) registers itself on the filter from that
 * module, carrying its own callbacks:
 *   sanitize_def  the type's extra config, raw row to stored def
 *   resolve       a submitted value to { value, display, ... } or null
 *   render        the type's input markup
 *   seed          the reverse of resolve, for the cart edit loop: a frozen
 *                 snapshot back into the posted shape its input expects (a
 *                 measured size stores "3x2" and posts w and h). A type
 *                 without one seeds its stored value string, which is the
 *                 posted shape for every plain type.
 *   menu          wording for the product panel's "Add a field" menu
 *   own_fee_mode  a type whose charge is its own maths names the display mode
 *                 its inputs wear instead of the shared fee modes
 *
 * A stored field of a type nothing registers is inert rather than deleted:
 * never rendered, priced or required, its saved config untouched, so it
 * returns whole the moment the module that owns it is installed.
 *
 * @return array<string,array{label:string,has_options?:bool,per_char?:bool,display_only?:bool}>
 */
function addon_boss_personalisation_field_types(): array {
	$own = array(
		'text'     => array( 'label' => __( 'Text', 'addon-boss' ), 'per_char' => true, 'menu' => __( 'Name or text to print', 'addon-boss' ) ),
		'textarea' => array( 'label' => __( 'Message', 'addon-boss' ), 'per_char' => true, 'menu' => __( 'Message', 'addon-boss' ) ),
		'number'   => array( 'label' => __( 'Number', 'addon-boss' ), 'menu' => __( 'Number', 'addon-boss' ) ),
		'date'     => array( 'label' => __( 'Date', 'addon-boss' ) ),
		'time'     => array( 'label' => __( 'Time', 'addon-boss' ) ),
		'select'   => array( 'label' => __( 'Dropdown', 'addon-boss' ), 'has_options' => true ),
		'checkbox' => array( 'label' => __( 'Tick box', 'addon-boss' ), 'menu' => __( 'Tick box', 'addon-boss' ) ),
		'color'    => array( 'label' => __( 'Colour', 'addon-boss' ), 'menu' => __( 'Colour', 'addon-boss' ), 'color_options' => true, 'rule_answer' => 'addon_boss_colour_rule_answer' ),
		// "Name your price" is what this is CALLED, everywhere it is sold. It was
		// "Their price", which is our shorthand and nobody else's: it names the
		// figure rather than the thing, so a merchant scanning the field list has
		// to open it to find out what it does. The trade already has a name for a
		// box the shopper types an amount into, and a merchant who wants one
		// searches for that name, not for ours. (His find, 7 Sept.)
		'price'    => array( 'label' => __( 'Name your price', 'addon-boss' ), 'menu' => __( 'Name your price', 'addon-boss' ), 'own_amount' => true ),
		'email'    => array( 'label' => __( 'Email', 'addon-boss' ), 'menu' => __( 'Email address', 'addon-boss' ) ),
		'url'      => array( 'label' => __( 'Web address', 'addon-boss' ), 'menu' => __( 'Web address', 'addon-boss' ) ),
		'hidden'   => array( 'label' => __( 'Hidden', 'addon-boss' ), 'menu' => __( 'Hidden value', 'addon-boss' ), 'admin_only' => true ),
		'heading'  => array( 'label' => __( 'Heading', 'addon-boss' ), 'display_only' => true, 'menu' => __( 'Heading', 'addon-boss' ) ),
		'html'     => array( 'label' => __( 'Info block', 'addon-boss' ), 'display_only' => true, 'menu' => __( 'Info block', 'addon-boss' ) ),
	);
	return (array) apply_filters( 'addon_boss_field_types', $own );
}

/**
 * The fee modes a field can charge by, as mode => menu wording. The engine's
 * own two are a flat fee for each item and a fee charged once per order line;
 * richer modes register from the module that implements their maths, which
 * answers the addon_boss_fee_modes_fee filter with the amount they resolve to.
 *
 * A stored mode nothing registers charges nothing and is never rewritten, so
 * the field keeps its input and its price comes back with the module.
 *
 * @return array<string,string>
 */
function addon_boss_fee_modes(): array {
	$own = array(
		'once' => __( 'Flat fee', 'addon-boss' ),
		'unit' => __( 'Quantity based', 'addon-boss' ),
	);
	return (array) apply_filters( 'addon_boss_fee_modes', $own );
}

/**
 * The same modes as short phrases, for the closed row's summary line, where
 * the mode reads AFTER an amount: "+£2.50 for each" is a sentence, while
 * "+£2.50 Quantity based" is a label read aloud. The menu takes the
 * category's names (Flat fee, Quantity based); this keeps the reading.
 *
 * @return array<string,string> mode key to phrase.
 */
function addon_boss_fee_mode_shorts(): array {
	$own = array(
		'once' => __( 'once', 'addon-boss' ),
		'unit' => __( 'for each', 'addon-boss' ),
	);
	return (array) apply_filters( 'addon_boss_fee_mode_shorts', $own );
}

/**
 * What ONE charge mode does, in a sentence a merchant can act on.
 *
 * The Charge control used to carry a single sentence explaining "for each" and
 * "once" together, sitting full-width above the controls. It was a wall of text
 * AND incomplete: the menu offers five modes, and the three it never mentioned
 * are exactly the ones nobody guesses. A merchant only ever needs the one they
 * have picked, which is the rule the repeatable panel already follows.
 *
 * Filterable for the same reason the menu is: a module that registers a mode
 * says what it does here, so the note can never fall behind the menu.
 *
 * @param string $mode The stored fee mode.
 * @return string Empty when nothing has claimed the mode.
 */
function addon_boss_fee_mode_note( string $mode ): string {
	$own = array(
		'unit' => __( 'Charged per item: two shirts, twice.', 'addon-boss' ),
		'once' => __( 'Charged once, however many they buy.', 'addon-boss' ),
	);
	$notes = (array) apply_filters( 'addon_boss_fee_mode_notes', $own );
	return isset( $notes[ $mode ] ) ? (string) $notes[ $mode ] : '';
}

/**
 * Sanitise raw personalisation field-def rows (the admin repeater's POST shape)
 * into stored field definitions. The ONE sanitiser shared by the per-item save
 * and the whole-order save, so both apply identical rules (types, labels,
 * unique keys, requirement, fees, options, limits).
 *
 * Idempotent on its own output: re-sanitising a STORED def (which carries
 * required/require_when instead of the raw `require`) preserves the requirement,
 * so an import or a wizard-edit round trip never drops it. Raw rows carry
 * neither key, so per-item save behaviour is byte-identical.
 *
 * @param array $raw_addons Raw field rows.
 * @return array[] Clean stored field definitions.
 */
function addon_boss_personalisation_sanitize_field_defs( array $raw_addons ): array {
	$types = addon_boss_personalisation_field_types();
	$clean = array();
	$used  = array();

	foreach ( $raw_addons as $f ) {
		if ( ! is_array( $f ) ) {
			continue;
		}
		$type = sanitize_key( $f['type'] ?? '' );
		if ( '' === $type ) {
			continue;
		}
		// A type this build has no module for is stored, not judged: the shared
		// core below is sanitised as usual and, at the end, every other key the
		// row carries rides through as submitted. What arrives here has already
		// been leaf-sanitised at the request boundary, and nothing on this build
		// ever renders, prices or requires such a field, so the config simply
		// waits, whole, for the module that owns it.
		$known = isset( $types[ $type ] );
		$label = sanitize_text_field( $f['label'] ?? '' );
		// An info/HTML block carries its body in `content` and can stand with no
		// label (the body speaks for itself), so it survives the empty-label drop.
		$content = ( 'html' === $type ) ? wp_kses_post( (string) ( $f['content'] ?? '' ) ) : '';
		if ( '' === $label && '' === $content ) {
			continue; // a field with nothing to show is meaningless
		}

		// Stable, unique key per item. Prefer a submitted key, else derive.
		$key = sanitize_title( $f['key'] ?? '' ) ?: sanitize_title( $label );
		if ( '' === $key ) {
			$key = 'field';
		}
		$base = $key;
		$n    = 2;
		while ( isset( $used[ $key ] ) ) {
			$key = $base . '-' . $n++;
		}
		$used[ $key ] = true;

		$def = array(
			'key'   => $key,
			'label' => $label,
			'type'  => $type,
		);

		if ( ! empty( $types[ $type ]['display_only'] ) ) {
			if ( 'html' === $type && '' !== $content ) {
				$def['content'] = $content; // the sanitised HTML body
			}
			// An info block's label does two jobs: it names the row in the editor
			// and, until a merchant says otherwise, it heads the body on the page.
			// Those come apart here, because plenty of blocks are a sentence of
			// guidance with nothing to head.
			//
			// HIDING is the key that has to be present, never showing. The editor
			// posts show_title through a hidden zero paired with the tick box, so
			// unticking arrives as a fact; a STORED def carries hide_title and no
			// show_title at all, and reading that absence as "hide" would strip the
			// heading off every block an import or a wizard edit passes through.
			if ( 'html' === $type ) {
				$bb_hide_title = ! empty( $f['hide_title'] )
					|| ( isset( $f['show_title'] ) && ! (int) $f['show_title'] );
				if ( $bb_hide_title ) {
					$def['hide_title'] = true;
				}
			}
			$clean[] = $def; // heading / info block: nothing else to store
			continue;
		}

		// The merchant's own sentence under the field, and the category's own name
		// for it: Gravity Forms, WPForms, Product Add-Ons, PPOM, Ninja Forms and
		// Meta Box all call this control Description, it is WordPress's own admin
		// idiom (`<p class="description">`) and it is already the argument name in
		// WooCommerce's own wp_*_input helpers. ACF's "Instructions" is that one
		// plugin's dialect; even the field builder that copies the label stores it
		// under `description` underneath.
		//
		// Stored only when written, like every optional string in these defs, so a
		// cleared box removes the key and the storefront falls silent again. Plain
		// text on purpose: this is guidance, not a place to build markup, and it
		// shares a slot with lines the engine WORKS OUT (a number's fence, a date's
		// earliest day) which are escaped as text too.
		$bb_desc = sanitize_text_field( (string) ( $f['description'] ?? '' ) );
		if ( '' !== $bb_desc ) {
			$def['description'] = $bb_desc;
		}

		$def['scope'] = ( ( $f['scope'] ?? 'unit' ) === 'item' ) ? 'item' : 'unit';
		// Requirement: optional (default) / always / only once personalising. A
		// re-sanitised STORED def carries required/require_when instead of the raw
		// `require`; derive from them so an import or wizard-edit round trip keeps
		// the rule. Raw rows have neither key, so per-item save is byte-identical.
		$require = $f['require'] ?? '';
		if ( '' === $require && ! empty( $f['required'] ) ) {
			$require = 'always';
		} elseif ( '' === $require && ( $f['require_when'] ?? '' ) === 'engaged' ) {
			$require = 'engaged';
		}
		$require              = in_array( $require, array( 'always', 'engaged' ), true ) ? $require : '';
		$def['required']      = ( 'always' === $require );
		$def['require_when']  = ( 'engaged' === $require ) ? 'engaged' : '';
		// Money typed in the product's panel reads as the set editors read it
		// (addon_boss_typed_amount()): "2,50" is 2.50, never 250.
		$def['fee']           = max( 0.0, (float) addon_boss_typed_amount( $f['fee'] ?? 0 ) );
		// The mode is kept as stored even when this build has no module for it:
		// an unregistered mode charges nothing (the fee resolver has no maths to
		// answer with), and a save must never reprice a field to "for each"
		// just because the module that priced it is not installed today.
		$bb_fee_mode     = sanitize_key( (string) ( $f['fee_mode'] ?? '' ) );
		$def['fee_mode'] = '' === $bb_fee_mode ? 'unit' : $bb_fee_mode;

		// Repeatable: the shopper fills this field more than once on one line.
		// 'add' lets them add as many as they want (up to a maximum); 'per_item'
		// asks once for every unit bought, so a run of six shirts asks for six
		// names. Anything else, including the absent key every field built before
		// this carries, means the field asks exactly once, as it always has.
		//
		// Stored WITHOUT asking whether the plan is active, deliberately: gating
		// the save would rewrite a merchant's configuration the moment a licence
		// lapsed and a field was re-saved. The capability is asked at the two
		// places it can be honoured, the editor's panel and the storefront, so a
		// free build asks once and leaves the setting alone for the plan's return.
		$repeat = (string) ( $f['repeat'] ?? '' );
		if ( in_array( $repeat, array( 'add', 'per_item' ), true ) ) {
			$def['repeat'] = $repeat;
			// A ceiling on 'add' so a shopper cannot open a thousand cards. Absent
			// or nonsense means the built-in ceiling, never unlimited.
			$rmax = (int) ( $f['repeat_max'] ?? 0 );
			if ( $rmax > 0 ) {
				$def['repeat_max'] = min( ADDON_BOSS_REPEAT_CEILING, $rmax );
			}
			// What each one is called on the page, in the cart and on the order:
			// "Shirt %d", "Name %d". The %d is filled with the instance number; a
			// label without one still reads sensibly because the number is
			// appended when it is missing.
			$rlabel = sanitize_text_field( (string) ( $f['repeat_label'] ?? '' ) );
			if ( '' !== $rlabel ) {
				$def['repeat_label'] = $rlabel;
			}
		}

		// Which variations this field applies to. Empty means every one, which is
		// what every field built before this existed resolves to, so nothing has
		// to be migrated and a simple product is unaffected.
		$only = array();
		foreach ( (array) ( $f['only_variations'] ?? array() ) as $vid ) {
			$vid = absint( $vid );
			if ( $vid && ! in_array( $vid, $only, true ) ) {
				$only[] = $vid;
			}
		}
		if ( $only ) {
			$def['only_variations'] = $only;
		}

		if ( in_array( $type, array( 'text', 'textarea' ), true ) ) {
			$def['maxlength'] = max( 0, (int) ( $f['maxlength'] ?? 0 ) );
		}
		if ( 'select' === $type ) {
			// A dropdown prices by the chosen option. A field-level fee here was
			// promised on three surfaces and charged on none; it never survives.
			$def['fee'] = 0.0;
		}
		if ( 'number' === $type ) {
			// Bounds are optional; the zero floor at resolve is not. Stored
			// only when set, like every optional fence in these defs.
			foreach ( array( 'num_min', 'num_max' ) as $bb_bk ) {
				if ( '' !== (string) ( $f[ $bb_bk ] ?? '' ) && is_numeric( $f[ $bb_bk ] ) ) {
					$def[ $bb_bk ] = (float) $f[ $bb_bk ];
				}
			}
			// Counting things, not measuring them. Stored only when ticked, so
			// every field built before this keeps taking decimals.
			if ( ! empty( $f['num_whole'] ) ) {
				$def['num_whole'] = true;
			}
			if ( isset( $def['num_min'], $def['num_max'] ) && $def['num_max'] < $def['num_min'] ) {
				// A ceiling below the floor is nonsense; the floor wins.
				unset( $def['num_max'] );
			}
		}
		if ( 'color' === $type ) {
			$def['options'] = addon_boss_personalisation_parse_color_options( $f['options'] ?? '' );
			// The custom pick is an extra swatch the merchant switches ON; its own
			// charge is separate because a colour match costs work the presets do not.
			$def['allow_custom'] = ! empty( $f['allow_custom'] );
			$def['custom_fee']   = max( 0.0, (float) addon_boss_typed_amount( $f['custom_fee'] ?? 0 ) );
			$def['fee']          = 0.0; // the swatches carry the money; a field-level fee never applies.
		}
		if ( 'price' === $type ) {
			// The shopper's amount IS the charge, so the field's own fee input never
			// applies; min/max/suggested bound it and the chips are typed as one
			// comma list, capped at five so the row stays a row.
			$def['fee'] = 0.0;
			foreach ( array( 'price_min', 'price_max', 'price_suggested' ) as $bb_pk ) {
				$bb_pv = trim( (string) ( $f[ $bb_pk ] ?? '' ) );
				if ( '' !== $bb_pv && is_numeric( addon_boss_typed_amount( $bb_pv ) ) ) {
					$def[ $bb_pk ] = max( 0.0, (float) addon_boss_typed_amount( $bb_pv ) );
				}
			}
			if ( isset( $def['price_min'], $def['price_max'] ) && $def['price_max'] < $def['price_min'] ) {
				unset( $def['price_max'] ); // a ceiling under the floor is a typo, not a rule.
			}
			$bb_amounts = array();
			foreach ( explode( ',', (string) ( $f['price_amounts'] ?? '' ) ) as $bb_a ) {
				$bb_a = trim( $bb_a );
				if ( '' !== $bb_a && is_numeric( wc_format_decimal( $bb_a ) ) && (float) wc_format_decimal( $bb_a ) > 0 ) {
					$bb_amounts[] = (float) wc_format_decimal( $bb_a );
				}
			}
			if ( $bb_amounts ) {
				$def['price_amounts'] = array_slice( array_values( array_unique( $bb_amounts ) ), 0, 5 );
			}
		}
		if ( 'hidden' === $type ) {
			// Invisible things carry no requirement and no charge, ever: a shopper
			// cannot complete what they cannot see, and invisible money is exactly
			// the pattern this plugin exists to refuse.
			$def['required'] = false;
			unset( $def['require_when'] );
			$def['fee']      = 0.0;
			$def['value']    = sanitize_text_field( (string) ( $f['value'] ?? '' ) );
			$def['url_fill'] = ! empty( $f['url_fill'] );
		}
	// A field's on-photo placement is the drawing module's data: it registers
	// the sanitiser for its own config on this seam. With nothing registered a
	// stored placement rides through a save untouched (the row reposts it
	// whole), so it returns with its module.
	$bb_preview = apply_filters( 'addon_boss_sanitize_field_preview', is_array( $f['preview'] ?? null ) ? $f['preview'] : array(), $f, $type );
	if ( is_array( $bb_preview ) && $bb_preview ) {
		$def['preview'] = $bb_preview;
	}
		if ( ! empty( $types[ $type ]['has_options'] ) ) {
			$def['options'] = addon_boss_personalisation_parse_options( $f['options'] ?? '' );
		}
		// A type's own extra config (the unit a size is measured in, an upload
		// field's accept rules) is sanitised by the callback its module
		// registered alongside the type.
		if ( $known && is_callable( $types[ $type ]['sanitize_def'] ?? null ) ) {
			$def = (array) call_user_func( $types[ $type ]['sanitize_def'], $def, $f );
		} elseif ( isset( ADDON_BOSS_SCHEDULING_KEYS[ $type ] ) ) {
			// A scheduling field's own rules (a date's lead time, cut-off, closed
			// days and rush ladder; a time's hours, slot step and priced windows)
			// belong to a module this build may not have. They ride through a save
			// untouched rather than being wiped, on exactly the reasoning the
			// repeat setting above is stored on: a licence that lapses and a field
			// that is re-saved must not cost a shop its whole calendar or its
			// opening hours. The editor reposts them on hidden carriers; nothing
			// here reads or honours them.
			//
			// The list is keyed by type rather than written out per field because
			// the date field carried this protection from the day it shipped and
			// the time field, written days later, did not: a merchant on a lapsed
			// licence lost every window on the first save. One table, and the next
			// scheduling type cannot repeat it.
			foreach ( ADDON_BOSS_SCHEDULING_KEYS[ $type ] as $bb_dk ) {
				if ( isset( $f[ $bb_dk ] ) ) {
					$def[ $bb_dk ] = map_deep( $f[ $bb_dk ], 'sanitize_text_field' );
				}
			}
		}
		if ( ! $known ) {
			// The rest of an unregistered type's row is that module's data, not
			// ours to rewrite; it rides through as submitted, minus the raw-only
			// control keys the shared core above already consumed.
			$def = array_merge(
				array_diff_key(
					$f,
					array(
						'require'         => 1,
						'label'           => 1,
						'key'             => 1,
						'type'            => 1,
						'fee'             => 1,
						'fee_mode'        => 1,
						'scope'           => 1,
						'required'        => 1,
						'require_when'    => 1,
						'only_variations' => 1,
						'maxlength'       => 1,
						'description'     => 1,
						'preview'         => 1,
						'options'         => 1,
						'content'         => 1,
					)
				),
				$def
			);
		}

		$clean[] = $def;
	}

	return $clean;
}

/**
 * Sanitise the structured option rows from the admin repeater. Each row is
 * [ label, fee ]; the stored value (slug) is derived from the label so the
 * merchant never types one. Keys are kept unique within the field.
 *
 * @return array<int,array{value:string,label:string,fee:float}>
 */
function addon_boss_personalisation_parse_options( $raw ): array {
	$out = array();
	if ( ! is_array( $raw ) ) {
		return $out;
	}
	$used = array();
	foreach ( $raw as $row ) {
		if ( ! is_array( $row ) ) {
			continue;
		}
		$label = sanitize_text_field( $row['label'] ?? '' );
		if ( '' === $label ) {
			continue;
		}
		$value = sanitize_title( $row['value'] ?? '' ) ?: sanitize_title( $label );
		if ( '' === $value ) {
			$value = 'option';
		}
		$base = $value;
		$n    = 2;
		while ( isset( $used[ $value ] ) ) {
			$value = $base . '-' . $n++;
		}
		$used[ $value ] = true;
		$out[]          = array(
			'value' => $value,
			'label' => $label,
			'fee'   => max( 0.0, (float) addon_boss_typed_amount( $row['fee'] ?? 0 ) ),
		);
	}
	return $out;
}

// =================================================================
// Value + fee resolution (the money math). Lifted UNCHANGED from
// the earlier bundle-side layout; shared by both surfaces.
// =================================================================

/**
 * Sanitise the structured colour rows from the admin repeater. Each row is
 * [ label, color, fee ]; the slug derives from the label like every option.
 * A row without a real hex colour is dropped rather than stored blank, so a
 * stored swatch can always be painted.
 *
 * @return array<int,array{value:string,label:string,color:string,fee:float}>
 */
function addon_boss_personalisation_parse_color_options( $raw ): array {
	$out = array();
	if ( ! is_array( $raw ) ) {
		return $out;
	}
	$used = array();
	foreach ( $raw as $row ) {
		if ( ! is_array( $row ) ) {
			continue;
		}
		$label = sanitize_text_field( $row['label'] ?? '' );
		$hex   = addon_boss_normalise_hex( (string) ( $row['color'] ?? '' ) );
		if ( '' === $label || '' === $hex ) {
			continue;
		}
		$value = sanitize_title( $row['value'] ?? '' ) ?: sanitize_title( $label );
		if ( '' === $value ) {
			$value = 'colour';
		}
		$base = $value;
		$n    = 2;
		while ( isset( $used[ $value ] ) ) {
			$value = $base . '-' . $n++;
		}
		$used[ $value ] = true;
		$out[]          = array(
			'value' => $value,
			'label' => $label,
			'color' => $hex,
			'fee'   => max( 0.0, (float) addon_boss_typed_amount( $row['fee'] ?? 0 ) ),
		);
	}
	return $out;
}

/**
 * One hex shape everywhere: #RRGGBB lower-case, or '' for anything else.
 * Accepts a missing #, and the #RGB short form browsers never send but
 * people paste.
 */
function addon_boss_normalise_hex( string $raw ): string {
	$raw = strtolower( trim( $raw ) );
	if ( '' !== $raw && '#' !== $raw[0] ) {
		$raw = '#' . $raw;
	}
	if ( preg_match( '/^#([0-9a-f]{3})$/', $raw, $m ) ) {
		return '#' . $m[1][0] . $m[1][0] . $m[1][1] . $m[1][1] . $m[1][2] . $m[1][2];
	}
	return preg_match( '/^#[0-9a-f]{6}$/', $raw ) ? $raw : '';
}

/**
 * Sanitise a raw submitted value against a field definition.
 *
 * A WP_Error is the third answer, for a value the shopper DID type that the
 * field cannot accept (an amount under the minimum, an address that is not
 * an address). null stays "left empty": dropping typed-but-wrong input
 * silently would either lose their answer or, on a priced field, their money.
 *
 * @return array{value:string,display:string,opt_fee?:float}|WP_Error|null  null = empty.
 */
function addon_boss_personalisation_resolve_value( array $def, $raw, $product = null ) {
	$bb_type  = (string) ( $def['type'] ?? 'text' );
	$bb_types = addon_boss_personalisation_field_types();
	// A type that registered its own resolver (a measured size, an upload)
	// answers through it. A type nothing registered resolves to nothing, the
	// same as any other value the engine has no code to read.
	if ( is_callable( $bb_types[ $bb_type ]['resolve'] ?? null ) ) {
		return call_user_func( $bb_types[ $bb_type ]['resolve'], $def, $raw );
	}
	switch ( $bb_type ) {
		case 'textarea':
			$val = trim( sanitize_textarea_field( (string) $raw ) );
			if ( '' === $val ) {
				return null;
			}
			$bb_over = addon_boss_personalisation_too_long( $val, $def );
			if ( $bb_over instanceof WP_Error ) {
				return $bb_over;
			}
			return array( 'value' => $val, 'display' => $val );

		case 'text':
			$val = trim( sanitize_text_field( (string) $raw ) );
			if ( '' === $val ) {
				return null;
			}
			$bb_over = addon_boss_personalisation_too_long( $val, $def );
			if ( $bb_over instanceof WP_Error ) {
				return $bb_over;
			}
			return array( 'value' => $val, 'display' => $val );

		case 'number':
			if ( null === $raw || '' === $raw ) {
				return null;
			}
			if ( ! is_numeric( $raw ) ) {
				// Typed but not a number. This used to resolve to null, so somebody
				// who wrote "two" got silence while somebody who wrote 1e9 got a
				// sentence. One wrong answer, one behaviour.
				return new WP_Error(
					'addon_boss',
					sprintf(
						/* translators: %s: the name of whatever is unanswered, a field or a dimension */
						__( '%s: enter a number.', 'addon-boss' ),
						(string) ( $def['label'] ?? '' )
					)
				);
			}
			$bb_num = (float) $raw;
			// The floor is zero even with no bounds set: a typed -3 on a
			// per-value charge priced NEGATIVE money before this. Typed but
			// out of the fence speaks, never silently drops.
			$bb_lo = isset( $def['num_min'] ) ? max( 0.0, (float) $def['num_min'] ) : 0.0;
			$bb_hi = isset( $def['num_max'] ) ? (float) $def['num_max'] : null;
			if ( $bb_num < $bb_lo || ( null !== $bb_hi && $bb_num > $bb_hi ) ) {
				$bb_words = null !== $bb_hi
					/* translators: 1: the field's label, 2: the lowest allowed number, 3: the highest allowed number */
					? sprintf( __( '%1$s: enter a number between %2$s and %3$s.', 'addon-boss' ), (string) ( $def['label'] ?? '' ), (string) ( $bb_lo + 0 ), (string) ( $bb_hi + 0 ) )
					/* translators: 1: the field's label, 2: the lowest allowed number */
					: sprintf( __( '%1$s: enter a number of at least %2$s.', 'addon-boss' ), (string) ( $def['label'] ?? '' ), (string) ( $bb_lo + 0 ) );
				return new WP_Error( 'bundle_boss', $bb_words );
			}
			if ( ! empty( $def['num_whole'] ) && floor( $bb_num ) !== $bb_num ) {
				// "7.5 stems" is orderable without this. A shop that COUNTS things
				// ticks the box; one that measures in metres leaves it clear.
				return new WP_Error(
					'addon_boss',
					sprintf(
						/* translators: %s: the name of whatever is unanswered, a field or a dimension */
						__( '%s: enter a whole number.', 'addon-boss' ),
						(string) ( $def['label'] ?? '' )
					)
				);
			}
			$val = (string) ( $raw + 0 );
			return array( 'value' => $val, 'display' => $val );

		case 'date':
			// A real calendar date, not merely something date-shaped: 2026-02-31
			// passes a regex and fails checkdate, and letting it through would put
			// an impossible delivery date on a real order.
			$raw = trim( sanitize_text_field( (string) $raw ) );
			if ( ! preg_match( '/^(\d{4})-(\d{2})-(\d{2})$/', $raw, $dm ) ) {
				return null;
			}
			if ( ! checkdate( (int) $dm[2], (int) $dm[3], (int) $dm[1] ) ) {
				return null;
			}
			// Shown in the store's own date format, stored ISO so it sorts and
			// travels safely.
			$fmt = function_exists( 'wc_date_format' ) ? wc_date_format() : get_option( 'date_format', 'Y-m-d' );
			return array( 'value' => $raw, 'display' => date_i18n( $fmt, strtotime( $raw . ' 12:00:00' ) ) );

		case 'time':
			$raw = trim( sanitize_text_field( (string) $raw ) );
			// Browsers send H:i, and H:i:s when seconds are enabled.
			if ( ! preg_match( '/^([01]\d|2[0-3]):([0-5]\d)(?::[0-5]\d)?$/', $raw, $tm ) ) {
				return null;
			}
			$hhmm = $tm[1] . ':' . $tm[2];
			$tfmt = function_exists( 'wc_time_format' ) ? wc_time_format() : get_option( 'time_format', 'H:i' );
			return array( 'value' => $hhmm, 'display' => date_i18n( $tfmt, strtotime( '1970-01-01 ' . $hhmm . ':00' ) ) );

		case 'select':
			$bb_typed = trim( (string) $raw );
			$slug     = sanitize_title( $bb_typed );
			if ( '' === $slug ) {
				return null;
			}
			foreach ( (array) ( $def['options'] ?? array() ) as $opt ) {
				// The sanitised form OR the value exactly as stored, for the same
				// reason as the colour swatches above: a value that arrived by a
				// road other than the editor can carry a character sanitize_title
				// rewrites, and no answer would ever match it again.
				$stored = (string) ( $opt['value'] ?? ( $opt['label'] ?? '' ) ); // no value saved: its label, as the field draws it
				if ( '' !== $stored && ( $stored === $slug || $stored === $bb_typed ) ) {
					return array( 'value' => $stored, 'display' => $opt['label'] ?? $stored, 'opt_fee' => (float) ( $opt['fee'] ?? 0 ) );
				}
			}
			return null; // not a defined option

		case 'checkbox':
			return empty( $raw ) ? null : array( 'value' => '1', 'display' => __( 'Yes', 'addon-boss' ) );

		case 'email':
			$val   = trim( sanitize_text_field( (string) $raw ) );
			$bb_at = strrpos( $val, '@' );
			if ( false !== $bb_at ) {
				// The domain is case-blind; the part before the @ is theirs to spell.
				$val = substr( $val, 0, $bb_at ) . strtolower( substr( $val, $bb_at ) );
			}
			if ( '' === $val ) {
				return null;
			}
			if ( ! is_email( $val ) ) {
				return new WP_Error(
					'addon_boss',
					sprintf(
						/* translators: %s: the name of whatever is unanswered, a field or a dimension */
						__( '%s: enter an email address like name@example.com.', 'addon-boss' ),
						(string) ( $def['label'] ?? __( 'Email', 'addon-boss' ) )
					)
				);
			}
			return array( 'value' => $val, 'display' => $val );

		case 'url':
			$val = trim( sanitize_text_field( (string) $raw ) );
			if ( '' === $val ) {
				return null;
			}
			// People type "mysite.com". The strict native check rejects exactly the
			// commonest correct input, so the scheme is supplied rather than demanded.
			if ( ! preg_match( '#^https?://#i', $val ) ) {
				$val = 'https://' . $val;
			}
			$bb_host = (string) wp_parse_url( $val, PHP_URL_HOST );
			if ( false === strpos( $bb_host, '.' ) || ! filter_var( $val, FILTER_VALIDATE_URL ) ) {
				return new WP_Error(
					'addon_boss',
					sprintf(
						/* translators: %s: the name of whatever is unanswered, a field or a dimension */
						__( '%s: enter a web address like example.com.', 'addon-boss' ),
						(string) ( $def['label'] ?? __( 'Web address', 'addon-boss' ) )
					)
				);
			}
			$val = esc_url_raw( $val );
			return array( 'value' => $val, 'display' => $val );

		case 'color':
			$val = trim( sanitize_text_field( (string) $raw ) );
			if ( '' === $val ) {
				return null;
			}
			if ( 0 === strpos( $val, 'custom:' ) ) {
				if ( empty( $def['allow_custom'] ) ) {
					return null; // the escape hatch is off: not a defined choice.
				}
				$hex = addon_boss_normalise_hex( substr( $val, 7 ) );
				if ( '' === $hex ) {
					return new WP_Error(
						'addon_boss',
						sprintf(
							/* translators: %s: the name of whatever is unanswered, a field or a dimension */
							__( '%s: pick a colour or enter a code like #1A2B3C.', 'addon-boss' ),
							(string) ( $def['label'] ?? __( 'Colour', 'addon-boss' ) )
						)
					);
				}
				return array(
					'value'   => 'custom:' . $hex,
					// The hex is the truth a printer can work from; "Custom" is the word.
					'display' => sprintf( /* translators: %s: a colour code like #1A2B3C */ __( 'Custom (%s)', 'addon-boss' ), $hex ),
					'opt_fee' => (float) ( $def['custom_fee'] ?? 0 ),
					'hex'     => $hex,
				);
			}
			$slug = sanitize_title( $val );
			foreach ( (array) ( $def['options'] ?? array() ) as $opt ) {
				// The sanitised form OR the value exactly as stored. The editor
				// slugs every value it saves, so the two are normally the same
				// string and this changes nothing. They come apart only when a
				// value arrived by some other road (an import, an older format,
				// a hand-written fixture) carrying a character sanitize_title
				// rewrites: a swatch stored as "#c9a227" can then never be
				// matched by the "#c9a227" the page posts back, and the field
				// becomes permanently unanswerable. Required, that is a dead
				// Add to basket refusing a colour the shopper can see selected,
				// with nothing in the message to explain it. Same family as the
				// hidden required choice that blocked the grid.
				$stored = (string) ( $opt['value'] ?? ( $opt['label'] ?? '' ) ); // no value saved: its label, as the field draws it
				if ( '' !== $stored && ( $stored === $slug || $stored === $val ) ) {
					$bb_label = (string) ( $opt['label'] ?? $stored );
					$bb_hex   = (string) ( $opt['color'] ?? '' );
					return array(
						'value'   => $stored,
						// The code in brackets is for the person making the thing,
						// and only earns its place when there is one. A swatch that
						// reached us without a colour printed "Gold ()" on the cart
						// line and on the order, an empty bracket nobody can read.
						'display' => '' !== $bb_hex ? sprintf( '%1$s (%2$s)', $bb_label, $bb_hex ) : $bb_label,
						'opt_fee' => (float) ( $opt['fee'] ?? 0 ),
						'hex'     => $bb_hex,
					);
				}
			}
			return null; // not a defined swatch

		case 'price':
			$val = trim( (string) ( is_scalar( $raw ) ? $raw : '' ) );
			if ( '' === $val ) {
				return null;
			}
			// Read as the page reads it: "19,50" is 19.50 and "1,950" is 1950.
			// The page said £19.50 for "19,50" while this charged £1,950.
			$bb_amount = addon_boss_typed_amount( $val );
			if ( '' === (string) $bb_amount || ! is_numeric( $bb_amount ) ) {
				return new WP_Error(
					'addon_boss',
					sprintf(
						/* translators: 1: the field's label, 2: a money amount */
						__( '%1$s: enter an amount like %2$s.', 'addon-boss' ),
						(string) ( $def['label'] ?? __( 'Name your price', 'addon-boss' ) ),
						// aob-money-raw: an example of the FORMAT to type in, not a charge.
						addon_boss_plain_price( 10 )
					)
				);
			}
			$bb_amount = (float) $bb_amount;
			if ( $bb_amount <= 0 ) {
				// Zero or less is no charge at all, and no charge is an empty answer,
				// never a negative line. The zero-floor rule, same as everywhere.
				return null;
			}
			// THE SHOPPER TYPED THE FIGURE THEY WERE READING.
			//
			// The box speaks the shop's display basis, like every other price on
			// the page, so the typed figure arrives in that basis. The bounds the
			// merchant set are entry-basis like every Woo price, so they convert
			// to the shopper's basis for the comparison and for the sentence: the
			// refusal must quote figures the shopper can see on their screen. The
			// charge converts the other way and rides the fee pipeline as the
			// entry-basis figure every configured fee already is. On a shop whose
			// two bases coincide, none of this moves anything. (His call, 7 Sept.)
			$bb_pp = $product instanceof WC_Product ? $product : null;
			// The basis the page declared, or the shop's display setting where no
			// declaration arrived (an API add, an order-again): the same default
			// the page renders with.
			$bb_basis = isset( $_POST['bb_own_basis'] ) ? sanitize_key( wp_unslash( $_POST['bb_own_basis'] ) ) : ''; // phpcs:ignore WordPress.Security.NonceVerification.Missing -- read-only basis declaration; the add-to-cart nonce guards the request.
			if ( ! in_array( $bb_basis, array( 'incl', 'excl' ), true ) ) {
				$bb_basis = 'incl' === get_option( 'woocommerce_tax_display_shop', 'excl' ) ? 'incl' : 'excl';
			}
			if ( isset( $def['price_min'] ) ) {
				$bb_min_shown = $bb_pp ? addon_boss_entry_to_basis( (float) $def['price_min'], $bb_pp, $bb_basis ) : (float) $def['price_min'];
				if ( round( $bb_amount, 4 ) < round( $bb_min_shown, 4 ) ) {
					return new WP_Error(
						'addon_boss',
						sprintf(
							/* translators: 1: the field's label, 2: the smallest amount accepted */
							__( '%1$s: enter at least %2$s.', 'addon-boss' ),
							(string) ( $def['label'] ?? '' ),
							// aob-money-raw: the bound in the basis the shopper reads.
							addon_boss_plain_price( $bb_min_shown )
						)
					);
				}
			}
			if ( isset( $def['price_max'] ) ) {
				$bb_max_shown = $bb_pp ? addon_boss_entry_to_basis( (float) $def['price_max'], $bb_pp, $bb_basis ) : (float) $def['price_max'];
				if ( round( $bb_amount, 4 ) > round( $bb_max_shown, 4 ) ) {
					return new WP_Error(
						'addon_boss',
						sprintf(
							/* translators: 1: the field's label, 2: the largest amount accepted */
							__( '%1$s: enter at most %2$s.', 'addon-boss' ),
							(string) ( $def['label'] ?? '' ),
							// aob-money-raw: the upper twin of price_min, same reason.
							addon_boss_plain_price( $bb_max_shown )
						)
					);
				}
			}
			return array(
				'value'   => (string) wc_format_decimal( $bb_amount, wc_get_price_decimals() ),
				// aob-money-raw: the figure they typed, echoed back to them, in the
				// basis they typed it in.
				'display' => addon_boss_plain_price( $bb_amount ),
				// Their amount IS the charge, converted to the entry basis so it
				// rides the same pipeline every configured fee does. Downstream tax
				// puts it back to exactly the figure they typed.
				'opt_fee' => $bb_pp ? addon_boss_basis_to_entry( $bb_amount, $bb_pp, $bb_basis ) : $bb_amount,
			);

		case 'hidden':
			// The stored value is the truth; the page never asked anything. Posted
			// input counts only when fill-from-link is on, and even then it is
			// plain text with a hard cap, never markup, never unbounded.
			$bb_fixed = (string) ( $def['value'] ?? '' );
			$val      = $bb_fixed;
			if ( ! empty( $def['url_fill'] ) ) {
				$bb_posted = trim( sanitize_text_field( (string) ( is_scalar( $raw ) ? $raw : '' ) ) );
				if ( '' !== $bb_posted ) {
					$val = mb_substr( $bb_posted, 0, 200 );
				}
			}
			if ( '' === $val ) {
				return null;
			}
			return array( 'value' => $val, 'display' => $val, 'admin_only' => true );
	}
	return null;
}

/**
 * Storefront field polish: keep every capped field's character count in step, and
 * mark a field the shopper has completed with a quiet edge.
 *
 * Pure sugar over the fields that already carry the values, and it degrades to
 * nothing when absent. File fields are deliberately left out of the done state:
 * theirs arrives with the upload chip, so an empty file field can never read as
 * finished.
 */
function addon_boss_standalone_fields_polish(): void {
	if ( ! function_exists( 'is_product' ) || ! is_product() ) {
		return;
	}
	?>
	<?php ob_start(); try { ?>
	( function () {
		var root = document.querySelector( '.bb-standalone-options' );
		if ( ! root ) { return; }

		// Delegated from the document, one copy for the page, so an instance
		// an add-another clones AFTER boot behaves exactly like one the
		// server rendered. Per-element binding at boot was how a cloned
		// engraving's count sat frozen at 0/20 while its twin counted.
		function counterUpd( input ) {
			var field = input.closest( '.bb-addon-field' );
			var c     = field ? field.querySelector( '.bb-addon-counter' ) : null;
			if ( ! c ) { return; }
			var max = parseInt( c.getAttribute( 'data-bb-max' ), 10 ) || 0;
			var n   = ( input.value || '' ).length;
			c.textContent = n + '/' + max;
			// Amber as the cap approaches, bold once it is reached. The last
			// stretch is proportional, so a 30 box and a 500 box both warn
			// with room to act; a flat two characters was no notice at all on
			// a long one. The cap state matters because maxlength stops the
			// keys silently: it is what explains why typing stopped. It is not
			// an error, so it is not drawn as one.
			var tail = !! max ? Math.min( 20, Math.max( 2, Math.round( max * 0.1 ) ) ) : 0;
			c.classList.toggle( 'is-near', !! max && n >= max - tail && n < max );
			c.classList.toggle( 'is-at', !! max && n >= max );
		}
		function filledOf( g ) {
			// A file field's done state belongs to its chip, not to this.
			if ( g.querySelector( '.bb-addon-file-ref' ) ) { return false; }
			var cb = g.querySelector( 'input[type="checkbox"].bb-addon-input' );
			if ( cb ) { return cb.checked; }
			var input = g.querySelector( '.bb-addon-input' );
			return !! ( input && input.value && input.value.trim() );
		}
		function groupSync( g ) {
			if ( ! g || g.querySelector( '.bb-addon-file-ref' ) ) { return; }
			g.classList.toggle( 'is-filled', filledOf( g ) );
		}
		function onEdit( e ) {
			var input = e.target && e.target.classList && e.target.classList.contains( 'bb-addon-input' ) ? e.target : null;
			if ( ! input || ! root.contains( input ) ) { return; }
			counterUpd( input );
			groupSync( input.closest( '.bb-field-group' ) );
		}
		document.addEventListener( 'input', onEdit );
		document.addEventListener( 'change', onEdit );
		// First paint: the server may have prefilled any of them.
		root.querySelectorAll( '.bb-addon-input' ).forEach( function ( input ) {
			counterUpd( input );
			groupSync( input.closest( '.bb-field-group' ) );
		} );
	} )();
	<?php } finally { addon_boss_inline_js( ob_get_clean() ); } ?>
	<?php
}
add_action( 'wp_footer', 'addon_boss_standalone_fields_polish', 29 );

/**
 * The winner fields' storefront behaviour, plus the searchable long list.
 *
 * Everything here is an enhancement over controls that already work without
 * it: the colour presets are plain radios, the typed amount is a plain box,
 * the long list is a native select. The script opens the custom-colour hatch
 * and the amount chips (both rendered hidden so no dead control ever shows),
 * offers the email typo nudge, and upgrades any option list past the chip
 * threshold into a searchable combobox in place - the native select stays in
 * the form as the single source of truth, so pruning, pricing and validation
 * never learn this exists.
 */
function addon_boss_winner_fields_js(): void {
	if ( ! function_exists( 'is_product' ) || ! is_product() ) {
		return;
	}
	$bb_i18n = array(
		/* translators: %s: the closest matching choice, offered as a correction */
		'mean'    => __( 'Did you mean %s?', 'addon-boss' ),
		'unavail' => __( 'Unavailable', 'addon-boss' ),
		/* translators: %s: how many choices the list holds */
		'nomatch' => __( 'No matching options. Clear your text to see all %s options.', 'addon-boss' ),
		/* translators: 1: results shown, 2: of them unavailable */
		'results' => __( '%1$s results (%2$s unavailable). Use up and down arrows.', 'addon-boss' ),
	);
	?>
	<?php ob_start(); try { ?>
	( function () {
		var root = document.querySelector( '.bb-standalone-options' );
		if ( ! root ) { return; }
		var I18N = <?php echo wp_json_encode( $bb_i18n ); ?>;

		// ── Colour: the custom swatch opens only once this script exists. ──
		root.querySelectorAll( '.bb-addon-colour .bb-colour-custom' ).forEach( function ( cw ) {
			cw.hidden = false;
			var radio  = cw.querySelector( 'input[type=radio]' );
			var pickw  = cw.querySelector( '.bb-colour-pick' );
			var picker = cw.querySelector( '.bb-colour-picker' );
			var hexin  = cw.querySelector( '.bb-colour-hex' );
			var group  = cw.closest( '.bb-addon-colour' );
			function norm( v ) {
				v = ( v || '' ).trim().toLowerCase();
				if ( v && '#' !== v[ 0 ] ) { v = '#' + v; }
				if ( /^#[0-9a-f]{3}$/.test( v ) ) { v = '#' + v[ 1 ] + v[ 1 ] + v[ 2 ] + v[ 2 ] + v[ 3 ] + v[ 3 ]; }
				return /^#[0-9a-f]{6}$/.test( v ) ? v : '';
			}
			function sync( from ) {
				var hex = norm( 'picker' === from ? picker.value : hexin.value );
				if ( ! hex ) { return; }
				if ( 'picker' === from ) { hexin.value = hex; } else { picker.value = hex; }
				// The radio's value IS the answer the form posts; painting it here is
				// what lets a no-surprises native POST carry the exact colour.
				radio.value   = 'custom:' + hex;
				radio.checked = true;
				radio.dispatchEvent( new Event( 'change', { bubbles: true } ) );
			}
			picker && picker.addEventListener( 'input', function () { sync( 'picker' ); } );
			// Live on input too: the chip takes the colour the moment the sixth
			// character lands, not when the box loses focus. Partial codes fall
			// out of norm() and change nothing.
			hexin && hexin.addEventListener( 'input', function () { sync( 'hex' ); } );
			hexin && hexin.addEventListener( 'change', function () { sync( 'hex' ); } );
			group && group.addEventListener( 'change', function ( e ) {
				if ( e.target && 'radio' === e.target.type ) {
					pickw.hidden = ( e.target !== radio );
				}
			} );
		} );

		// ── Name your price: chips fill the box; the box stays the truth. ──
		//
		// A chip shows the display-basis figure and pressing it writes exactly
		// that figure. On a shop with a tax toggle the figure a chip SHOWS moves
		// with the switch, so what it writes has to move too: the -ex/-in pair
		// carries both, and the toggle plugin's own active class says which side
		// the shopper is reading. No tax maths happens here.
		root.querySelectorAll( '.bb-addon-ownprice' ).forEach( function ( w ) {
			var chips = w.querySelector( '.bb-price-chips' );
			var input = w.querySelector( '.bb-price-input' );
			if ( ! chips || ! input ) { return; }
			chips.hidden = false;
			function curAmount( c ) {
				var on = document.querySelector( '.wts-price-incl.wts-active' );
				var off = document.querySelector( '.wts-price-excl.wts-active' );
				if ( on ) { return c.dataset.bbAmountIn || c.dataset.bbAmount; }
				if ( off ) { return c.dataset.bbAmountEx || c.dataset.bbAmount; }
				return c.dataset.bbAmount;
			}
			function mark() {
				var now = parseFloat( ( input.value || '' ).replace( ',', '.' ) );
				chips.querySelectorAll( '.bb-price-chip' ).forEach( function ( c ) {
					// A chip is "on" when the box holds its figure in ANY basis, so
					// the tick survives a toggle flip that rewrites both of them.
					c.classList.toggle(
						'is-on',
						parseFloat( c.dataset.bbAmount ) === now
							|| parseFloat( c.dataset.bbAmountEx ) === now
							|| parseFloat( c.dataset.bbAmountIn ) === now
					);
				} );
			}
			chips.addEventListener( 'click', function ( e ) {
				var b = e.target.closest( '.bb-price-chip' );
				if ( ! b ) { return; }
				input.value = curAmount( b );
				input.dispatchEvent( new Event( 'input', { bubbles: true } ) );
				input.dispatchEvent( new Event( 'change', { bubbles: true } ) );
				mark();
			} );
			input.addEventListener( 'input', mark );
			mark();
		} );

		// ── E-mail: the did-you-mean nudge. Never blocks, one tap accepts. ──
		var DOMAINS = [ 'gmail.com', 'googlemail.com', 'hotmail.com', 'hotmail.co.uk', 'outlook.com', 'yahoo.com', 'yahoo.co.uk', 'icloud.com', 'live.com', 'aol.com', 'protonmail.com', 'msn.com' ];
		function nearDomain( d ) {
			if ( -1 !== DOMAINS.indexOf( d ) ) { return ''; }
			for ( var i = 0; i < DOMAINS.length; i++ ) {
				var t = DOMAINS[ i ];
				if ( Math.abs( t.length - d.length ) > 1 ) { continue; }
				var edits = 0, a = 0, b = 0;
				while ( a < d.length && b < t.length ) {
					if ( d[ a ] === t[ b ] ) { a++; b++; continue; }
					// gmial -> gmail: the classic typo is two adjacent letters
					// swapped, and it is ONE mistake, not two.
					if ( a + 1 < d.length && b + 1 < t.length && d[ a ] === t[ b + 1 ] && d[ a + 1 ] === t[ b ] ) {
						edits++; a += 2; b += 2;
						if ( edits > 1 ) { break; }
						continue;
					}
					edits++;
					if ( edits > 1 ) { break; }
					if ( d.length > t.length ) { a++; } else if ( d.length < t.length ) { b++; } else { a++; b++; }
				}
				edits += ( d.length - a ) + ( t.length - b );
				if ( edits === 1 ) { return t; }
			}
			return '';
		}
		root.querySelectorAll( 'input[type=email].bb-addon-input' ).forEach( function ( inp ) {
			var hint = root.querySelector( '.bb-addon-mailhint[data-bb-for="' + inp.id + '"]' );
			if ( ! hint ) { return; }
			inp.addEventListener( 'blur', function () {
				hint.hidden = true;
				hint.textContent = '';
				var v  = ( inp.value || '' ).trim();
				var at = v.lastIndexOf( '@' );
				if ( at < 1 ) { return; }
				var fix = nearDomain( v.slice( at + 1 ).toLowerCase() );
				if ( ! fix ) { return; }
				var whole = v.slice( 0, at + 1 ) + fix;
				hint.textContent = I18N.mean.replace( '%s', whole );
				hint.hidden = false;
				hint.onclick = function () {
					inp.value   = whole;
					hint.hidden = true;
					inp.dispatchEvent( new Event( 'change', { bubbles: true } ) );
				};
			} );
		} );

		// ── Long lists search themselves. ──────────────────────────────
		// The native select stays in the form and stays the single truth: the
		// combobox only reads its options (fresh on every open, because pruning
		// disables options live) and writes its value back. No script, or a
		// script failure, leaves the working select exactly as it renders today.
		var THRESHOLD = 12;
		function fold( s ) {
			// Case- and accent-insensitive matching: "Metallic" finds "métallic".
			s = ( s || '' ).toLowerCase();
			try { s = s.normalize( 'NFD' ).replace( /[̀-ͯ]/g, '' ); } catch ( e ) {}
			return s;
		}
		function enhance( sel ) {
			if ( sel.dataset.bbCombo || 'off' === sel.dataset.bbSearch || sel.multiple ) { return; }
			var real = 0;
			for ( var i = 0; i < sel.options.length; i++ ) {
				if ( '' !== sel.options[ i ].value ) { real++; }
			}
			if ( real <= THRESHOLD ) { return; }
			sel.dataset.bbCombo = '1';
			var wrap  = document.createElement( 'span' );
			wrap.className = 'bb-combo';
			var input = document.createElement( 'input' );
			// BOTH classes. It only ever carried bb-combo-input, so the one control
			// we build in script wore raw browser chrome while every field beside
			// it wore the panel's. Next to a dressed field it read as something
			// from another decade, which is exactly what it was. (His find.)
			input.type = 'text';
			input.className = 'bb-addon-input bb-combo-input';
			input.setAttribute( 'role', 'combobox' );
			input.setAttribute( 'aria-expanded', 'false' );
			input.setAttribute( 'aria-autocomplete', 'list' );
			input.setAttribute( 'autocomplete', 'off' );
			input.setAttribute( 'spellcheck', 'false' );
			var lbid = ( sel.id || sel.name || 'bb' ).replace( /[^a-z0-9_-]/gi, '' ) + '-listbox';
			input.setAttribute( 'aria-controls', lbid );
			// The select's accessible name carries over, so the combobox answers
			// to the same label the select did.
			var owner = sel.closest( 'label' ) || document.querySelector( 'label[for="' + sel.id + '"]' );
			if ( owner && owner.id ) { input.setAttribute( 'aria-labelledby', owner.id ); }
			var chev = document.createElement( 'span' );
			chev.className = 'bb-combo-chev';
			chev.setAttribute( 'aria-hidden', 'true' );
			var list = document.createElement( 'ul' );
			list.className = 'bb-combo-list';
			list.id = lbid;
			list.setAttribute( 'role', 'listbox' );
			list.hidden = true;
			var live = document.createElement( 'span' );
			live.className = 'screen-reader-text';
			live.setAttribute( 'aria-live', 'polite' );
			sel.parentNode.insertBefore( wrap, sel );
			wrap.appendChild( input );
			wrap.appendChild( chev );
			wrap.appendChild( list );
			wrap.appendChild( live );
			sel.style.display = 'none';
			sel.setAttribute( 'tabindex', '-1' );
			sel.setAttribute( 'aria-hidden', 'true' );

			var committed = sel.selectedOptions && sel.selectedOptions[ 0 ] && sel.value ? sel.selectedOptions[ 0 ].text : '';
			input.value = committed;
			var items = [], hl = -1, liveTimer = 0;

			function snapshot() {
				var out = [];
				for ( var i = 0; i < sel.options.length; i++ ) {
					var o = sel.options[ i ];
					if ( '' === o.value ) { continue; }
					out.push( { value: o.value, label: o.text, dis: o.disabled } );
				}
				return out;
			}
			function render( q ) {
				var all = snapshot();
				var f   = fold( q );
				var starts = [], has = [];
				all.forEach( function ( o ) {
					var l = fold( o.label );
					if ( '' === f || 0 === l.indexOf( f ) ) { starts.push( o ); }
					else if ( -1 !== l.indexOf( f ) ) { has.push( o ); }
					// A shopper types what they know, and that is not always the
					// words on the row. A collection time is stored 09:30 and
					// written "9:30 am", so typing the time found nothing; a size
					// or a finish is often known by its code. The value is the
					// option's other half, so it answers too, ranked last so a
					// real label match always leads.
					else if ( -1 !== fold( o.value ).indexOf( f ) ) { has.push( o ); }
				} );
				items = starts.concat( has );
				list.textContent = '';
				hl = -1;
				if ( ! items.length ) {
					var none = document.createElement( 'li' );
					none.className = 'bb-combo-none';
					none.textContent = I18N.nomatch.replace( '%s', String( all.length ) );
					list.appendChild( none );
				}
				var un = 0;
				items.forEach( function ( o, ix ) {
					if ( o.dis ) { un++; }
					var li = document.createElement( 'li' );
					// is-on marks what is chosen NOW. Opening on the whole list is
					// only half the job: a shopper also has to see which row they
					// are already on without reading the box above.
					var bbOn = sel.value && o.value === sel.value;
					li.className = 'bb-combo-opt' + ( o.dis ? ' is-dis' : '' ) + ( bbOn ? ' is-on' : '' );
					li.id = lbid + '-' + ix;
					li.setAttribute( 'role', 'option' );
					li.setAttribute( 'aria-selected', bbOn ? 'true' : 'false' );
					if ( o.dis ) { li.setAttribute( 'aria-disabled', 'true' ); }
					// Highlight the matched letters without trusting the label as HTML.
					var l = fold( o.label ), at = '' === f ? -1 : l.indexOf( f );
					if ( at >= 0 ) {
						li.appendChild( document.createTextNode( o.label.slice( 0, at ) ) );
						var m = document.createElement( 'mark' );
						m.textContent = o.label.slice( at, at + q.length );
						li.appendChild( m );
						li.appendChild( document.createTextNode( o.label.slice( at + q.length ) ) );
					} else {
						li.textContent = o.label;
					}
					if ( o.dis ) {
						var u = document.createElement( 'span' );
						u.className = 'bb-combo-unav';
						u.textContent = I18N.unavail;
						li.appendChild( u );
					}
					li.dataset.bbValue = o.value;
					list.appendChild( li );
				} );
				clearTimeout( liveTimer );
				liveTimer = setTimeout( function () {
					live.textContent = I18N.results.replace( '%1$s', String( items.length ) ).replace( '%2$s', String( un ) );
				}, 900 );
			}
			function open( q ) {
				render( q );
				list.hidden = false;
				input.setAttribute( 'aria-expanded', 'true' );
			}
			function close() {
				list.hidden = true;
				input.setAttribute( 'aria-expanded', 'false' );
				input.removeAttribute( 'aria-activedescendant' );
				hl = -1;
			}
			function commit( ix ) {
				var o = items[ ix ];
				if ( ! o || o.dis ) { return; }
				sel.value   = o.value;
				committed   = o.label;
				input.value = o.label;
				sel.dispatchEvent( new Event( 'change', { bubbles: true } ) );
				close();
			}
			function move( dir ) {
				if ( list.hidden ) { open( input.value ); }
				var n = hl;
				for ( var g = 0; g < items.length; g++ ) {
					n += dir;
					if ( n < 0 ) { n = items.length - 1; }
					if ( n >= items.length ) { n = 0; }
					if ( ! items[ n ].dis ) { break; }
				}
				if ( n < 0 || ! items.length || items[ n ].dis ) { return; }
				var prev = list.querySelector( '.is-hl' );
				prev && prev.classList.remove( 'is-hl' );
				hl = n;
				var el = document.getElementById( lbid + '-' + n );
				if ( el ) {
					el.classList.add( 'is-hl' );
					input.setAttribute( 'aria-activedescendant', el.id );
					el.scrollIntoView( { block: 'nearest' } );
				}
			}
			input.addEventListener( 'input', function () { open( input.value ); } );
			input.addEventListener( 'keydown', function ( e ) {
				// YOUR ANSWER IS REPLACEABLE, NOT EDITABLE.
				//
				// While the box shows the committed pick it is a statement of what
				// you chose, not text to amend. Backspacing into it left
				// "9:30 am (+GBP 4.0" on screen while the field underneath still
				// held 09:30: the box saying something the form did not mean.
				// Nothing unsafe could be submitted, because blur reverts and free
				// text never posts, but a control that can be made to lie about
				// your own answer is not one to trust. (His find, 7 Sept.)
				//
				// So the first key on a committed box clears it and starts a fresh
				// search. Escape and blur still put the answer back.
				if ( committed && input.value === committed
					&& ! e.ctrlKey && ! e.metaKey && ! e.altKey
					&& ( 1 === String( e.key ).length || 'Backspace' === e.key || 'Delete' === e.key ) ) {
					input.value = '';
					if ( 'Backspace' === e.key || 'Delete' === e.key ) { e.preventDefault(); open( '' ); }
				}
				if ( 'ArrowDown' === e.key ) { e.preventDefault(); move( 1 ); }
				else if ( 'ArrowUp' === e.key ) { e.preventDefault(); move( -1 ); }
				else if ( 'Enter' === e.key ) { if ( ! list.hidden && hl >= 0 ) { e.preventDefault(); commit( hl ); } }
				else if ( 'Escape' === e.key ) { input.value = committed; close(); }
			} );
			input.addEventListener( 'blur', function () {
				// Unconfirmed text reverts: free text can never submit, the exact
				// contract that keeps this a select underneath.
				setTimeout( function () {
					if ( document.activeElement && wrap.contains( document.activeElement ) ) { return; }
					input.value = committed;
					close();
				}, 120 );
			} );
			chev.addEventListener( 'mousedown', function ( e ) {
				e.preventDefault();
				if ( list.hidden ) { input.focus(); open( '' ); } else { close(); }
			} );
			// PRESSING THE BOX OPENS THE WHOLE LIST, and highlights what is in it.
			//
			// It used to open filtered by input.value, which after a pick IS the
			// chosen label: the list came back holding one row, the row already
			// chosen. So the only ways to see the other choices were to press the
			// little arrow, or to delete your own answer first. It read as a search
			// box that had forgotten it was a dropdown. (His find, 7 Sept.)
			//
			// Selecting the text is the other half: the next keystroke replaces the
			// old answer instead of being appended to it, which is what every
			// combobox a shopper has ever used does.
			input.addEventListener( 'click', function () {
				if ( ! list.hidden ) { return; }
				open( '' );
				input.select();
			} );
			list.addEventListener( 'mousedown', function ( e ) {
				var li = e.target.closest( '.bb-combo-opt' );
				if ( ! li || li.classList.contains( 'is-dis' ) ) { e.preventDefault(); return; }
				e.preventDefault();
				commit( items.findIndex( function ( o ) { return o.value === li.dataset.bbValue; } ) );
			} );
			// The select's value can move without us (prefill, another driver):
			// mirror it so the box never lies about the committed pick.
			sel.addEventListener( 'change', function () {
				var o = sel.selectedOptions && sel.selectedOptions[ 0 ];
				committed = sel.value && o ? o.text : '';
				if ( document.activeElement !== input ) { input.value = committed; }
			} );
			// THE BOX IS A COPY, AND A COPY GOES STALE.
			//
			// This input holds the chosen option's TEXT, taken once at the moment
			// it was chosen. The tax toggle rewrites every <option> in the hidden
			// select, so the rows behind the box answer the switch and the box
			// itself does not: on a field with a price in every row, flipping VAT
			// moved every figure EXCEPT the one the shopper had actually picked,
			// which is the only one they were reading. (His find, 7 Sept.)
			//
			// The select's own value has not moved, so no 'change' fires and the
			// mirror above cannot help. The repaint says when it is done instead.
			document.addEventListener( 'bb-choice-fees-repainted', function () {
				var o   = sel.selectedOptions && sel.selectedOptions[ 0 ];
				var was = committed;
				committed = sel.value && o ? o.text : '';
				// The box is rewritten when it is SHOWING the committed pick, not
				// only when it is unfocused. Choosing from the list leaves focus
				// in the box, so an unfocused-only guard skips the one case the
				// shopper is looking at, which is how this stayed broken. A box
				// holding anything else is a half-typed search: leave it alone.
				if ( input.value === was || document.activeElement !== input ) { input.value = committed; }
				// An open list is showing the old figures too. Keep whatever the
				// shopper was typing; they have not finished choosing.
				if ( ! list.hidden ) { render( input.value === committed ? '' : input.value ); }
			} );
		}
		root.querySelectorAll( 'select.bb-list-sel, select.bb-addon-input' ).forEach( enhance );
	} )();
	<?php } finally { addon_boss_inline_js( ob_get_clean() ); } ?>
	<?php
}
add_action( 'wp_footer', 'addon_boss_winner_fields_js', 29 );

/**
 * Does this field apply to the variation being bought?
 *
 * A field with no list applies to every variation, which is what everything
 * built before per-variation fields existed resolves to. A field restricted to
 * specific variations is INERT for the others: never rendered, never required,
 * never charged, which is the same discipline a hidden conditional field
 * follows.
 */
function addon_boss_field_applies_to_variation( array $def, int $variation_id ): bool {
	$only = (array) ( $def['only_variations'] ?? array() );
	if ( ! $only ) {
		return true;
	}
	// No variation chosen yet (a simple product, or the parent page): the field
	// stands, and the choice narrows it once one is picked.
	if ( $variation_id <= 0 ) {
		return true;
	}
	return in_array( $variation_id, array_map( 'absint', $only ), true );
}

/** Clip a string value to the field's maxlength (0 = no limit). */
function addon_boss_personalisation_clip( string $val, array $def ): string {
	$max = (int) ( $def['maxlength'] ?? 0 );
	if ( $max <= 0 ) {
		return $val;
	}
	return function_exists( 'mb_substr' ) ? mb_substr( $val, 0, $max ) : substr( $val, 0, $max );
}

/**
 * Is this longer than the field allows?
 *
 * The cap used to be enforced by CLIPPING, which quietly threw away whatever
 * ran over: forty characters sent to a twenty-character field stored twenty
 * and said nothing about the rest. Numbers already refuse and explain, and
 * this resolver's own contract is that typed-but-wrong never silently drops.
 * Text keeps that promise now too. clip() stays for callers that only need to
 * shorten something for display.
 *
 * @param string $val The submitted value, already sanitised and trimmed.
 * @param array  $def The field def.
 * @return WP_Error|null WP_Error when it is too long, null when it fits.
 */
function addon_boss_personalisation_too_long( string $val, array $def ) {
	$max = (int) ( $def['maxlength'] ?? 0 );
	if ( $max <= 0 ) {
		return null;
	}
	$len = function_exists( 'mb_strlen' ) ? mb_strlen( $val ) : strlen( $val );
	if ( $len <= $max ) {
		return null;
	}
	return new WP_Error(
		'addon_boss',
		sprintf(
			/* translators: 1: the field's label, 2: the most characters allowed */
			__( '%1$s: use %2$s characters or fewer.', 'addon-boss' ),
			(string) ( $def['label'] ?? '' ),
			(string) $max
		)
	);
}

/**
 * Resolve a single add-on's fee for this selection, honouring fee mode.
 * Mutates $once_charged so a "once" fee is taken a single time per item+field.
 *
 * $base_price is the line's per-unit base in the store's entry basis, and is
 * only consulted by the 'percent' mode. Callers that have no unambiguous base
 * (the bundle's per-item and whole-order paths) leave it at zero, and a percent
 * fee then resolves to nothing rather than guessing at a base: the admin only
 * offers percent where a product's own price is the obvious thing to take it
 * from, so this is a belt-and-braces floor, not a live path.
 */
function addon_boss_personalisation_resolve_fee( array $def, array $resolved, $item_index, array &$once_charged, float $base_price = 0.0 ): float {
	$decimals = function_exists( 'wc_get_price_decimals' ) ? wc_get_price_decimals() : 2;

	// A field type or fee mode this build does not offer charges nothing: the
	// field keeps its input, its price stays inert, and the stored fee is left
	// untouched for when the module arrives. An unavailable field TYPE is also
	// dropped upstream (never priced), so this is the belt to that braces.
	if ( ! addon_boss_field_type_available( (string) ( $def['type'] ?? '' ) )
		|| ! addon_boss_fee_mode_available( (string) ( $def['fee_mode'] ?? '' ) ) ) {
		return 0.0;
	}

	// Selects price by the chosen option; a colour by its swatch; a their-price
	// field by the amount the shopper typed. All three carry the money in the
	// resolved value, so the field-level fee never applies.
	if ( in_array( $def['type'] ?? '', array( 'select', 'color', 'price' ), true ) ) {
		return addon_boss_round_money( (float) ( $resolved['opt_fee'] ?? 0 ), $decimals );
	}

	// A type whose charge comes from the answer and the item's own price rather
	// than from an amount typed on the field (a date priced by how far forward
	// it was pulled) answers here, BEFORE the per-field amount is read, because
	// it has no amount to read. Returning null leaves the fee to the modes
	// below, so a type that does not price this way costs nothing extra.
	$bb_by_basis = apply_filters( 'addon_boss_field_type_line_fee', null, $def, $resolved, $base_price );
	if ( null !== $bb_by_basis ) {
		return addon_boss_round_money( (float) $bb_by_basis, $decimals );
	}

	$amount = (float) ( $def['fee'] ?? 0 );
	if ( $amount <= 0 ) {
		return 0.0;
	}

	// A type whose charge is its own maths (a measured size prices by the area
	// the shopper entered) answers through the module that registered it, and
	// short circuits like a select: no fee mode applies.
	$bb_own = apply_filters( 'addon_boss_field_type_fee', null, $def, $resolved, $amount );
	if ( null !== $bb_own ) {
		return addon_boss_round_money( (float) $bb_own, $decimals );
	}

	$bb_mode = (string) ( $def['fee_mode'] ?? 'unit' );
	if ( '' === $bb_mode ) {
		$bb_mode = 'unit'; // a field with no mode at all has always charged per item.
	}
	switch ( $bb_mode ) {
		case 'once':
			$ck = $item_index . '|' . ( $def['key'] ?? '' );
			if ( ! empty( $once_charged[ $ck ] ) ) {
				return 0.0;
			}
			$once_charged[ $ck ] = true;
			return addon_boss_round_money( $amount, $decimals );
		case 'unit':
			return addon_boss_round_money( $amount, $decimals );
		default:
			// A mode beyond the engine's own two resolves through the module
			// that registered it; a mode with no module behind it charges
			// nothing, and the field keeps its input for when one arrives.
			$bb_fee = apply_filters( 'addon_boss_fee_mode_fee', null, $bb_mode, $amount, $def, $resolved, $base_price );
			return null === $bb_fee ? 0.0 : addon_boss_round_money( (float) $bb_fee, $decimals );
	}
}

// =================================================================
// Field render. Lifted UNCHANGED from the earlier bundle-side layout; the
// standalone product-options surface renders through this too (via
// addon_boss_render_standalone_field).
// =================================================================

/**
 * Print HTML attributes, escaping each one where it is output.
 *
 * Takes a map rather than a ready-made string on purpose. A prebuilt string is
 * only provably safe to someone willing to read its composition further up.
 * Here the escaping happens at the point of output, one value at a time, so
 * there is nothing left to take on trust and nothing to suppress.
 *
 * true prints a bare boolean attribute. null and false print nothing.
 *
 * @param array<string,string|int|float|bool|null> $attrs Attribute map.
 */
function addon_boss_print_attrs( array $attrs ): void {
	foreach ( $attrs as $key => $value ) {
		if ( null === $value || false === $value ) {
			continue;
		}
		if ( true === $value ) {
			echo ' ' . esc_attr( $key );
			continue;
		}
		echo ' ' . esc_attr( $key ) . '="' . esc_attr( (string) $value ) . '"';
	}
}

/**
 * Render one add-on field. data-bb-* attributes let the configurator JS mirror
 * the fee into the live total.
 *
 * $product is what the printed fee is converted AGAINST. A stored fee is a raw
 * number in the shop's entry basis, and turning it into the shopper's basis
 * needs the product's tax status and class. Without it the label printed the
 * raw figure while the cart suffix, which has always had the product, printed
 * the converted one, so a shop with a VAT display toggle showed two different
 * prices for the same add-on. Optional, and unconverted when absent, so a
 * caller with no product in hand behaves exactly as before.
 */
function addon_boss_personalisation_render_field( array $def, string $name, $value = null, string $context = 'block', $product = null ) {
	$type  = $def['type'] ?? 'text';
	$label = $def['label'] ?? '';
	$cell  = ( 'cell' === $context ); // table-cell mode: no label/wrapper (the column header carries the label).

	// A field type's render callback takes a fixed shape with no product in it,
	// so the money it prints can only find one here. Set, never restored: every
	// field in a panel belongs to the same product, and the panel that opened
	// the basis closes it again.
	if ( $product instanceof WC_Product ) {
		addon_boss_money_product( $product );
	}

	if ( 'heading' === $type ) {
		if ( ! $cell ) {
			echo '<div class="bb-addon-note">' . esc_html( $label ) . '</div>';
		}
		return;
	}

	// A hidden field is the merchant talking to their own order screen. The page
	// prints an input only when fill-from-link is on (so the parameter has
	// somewhere to land in the post), and never a label, never chrome.
	if ( 'hidden' === $type ) {
		if ( ! empty( $def['url_fill'] ) ) {
			$bb_seed = (string) ( $value ?? '' );
			if ( '' === $bb_seed && isset( $_GET[ (string) ( $def['key'] ?? '' ) ] ) ) { // phpcs:ignore WordPress.Security.NonceVerification.Recommended
				$bb_seed = mb_substr( trim( sanitize_text_field( wp_unslash( (string) $_GET[ (string) ( $def['key'] ?? '' ) ] ) ) ), 0, 200 ); // phpcs:ignore WordPress.Security.NonceVerification.Recommended
			}
			printf( '<input type="hidden" name="%s" value="%s">', esc_attr( $name ), esc_attr( $bb_seed ) );
		}
		return;
	}

	// An info / HTML block: display only, no input, no fee, no chrome. The body
	// carries its own markup, so it is emitted as-is (kses-cleaned); an optional
	// label reads as a plain note above it, unless the merchant has kept the
	// label for the editor's list and asked for no heading on the page.
	if ( 'html' === $type ) {
		if ( ! $cell ) {
			if ( '' !== (string) $label && empty( $def['hide_title'] ) ) {
				echo '<div class="bb-addon-note">' . esc_html( $label ) . '</div>';
			}
			echo wp_kses_post( (string) ( $def['content'] ?? '' ) );
		}
		return;
	}

	$fee   = (float) ( $def['fee'] ?? 0 );
	$types = addon_boss_personalisation_field_types();
	// A select prices by its option, and a type whose charge is its own maths
	// (a measured size prices by area) wears the mode its registration names,
	// rather than the fee mode the other types share.
	$bb_own_mode = (string) ( $types[ $type ]['own_fee_mode'] ?? '' );
	$mode        = ( 'select' === $type ) ? 'select' : ( '' !== $bb_own_mode ? $bb_own_mode : (string) ( $def['fee_mode'] ?? 'unit' ) );
	// A shared mode this build has no maths for charges nothing at add-to-cart,
	// so the page must not promise a fee either: the shown price and the taken
	// price are the same fact.
	if ( 'select' !== $mode && '' === $bb_own_mode && ! isset( addon_boss_fee_modes()[ '' === $mode ? 'unit' : $mode ] ) ) {
		$fee = 0.0;
	}
	$req   = ! empty( $def['required'] );
	$id    = 'bb-add-' . substr( md5( $name ), 0, 8 );
	// The input's own data attributes, carried as a map and printed through
	// addon_boss_print_attrs() so each value is escaped where it lands.
	//
	// NOTHING is concatenated in raw here. This used to accept an $extra_attrs
	// parameter appended straight into the tag; no caller ever passed one, but
	// an unescaped path is a hole even while it is unreachable. The parameter is
	// gone rather than sanitised, because a caller-supplied attribute blob has
	// no legitimate use here.
	$attr_map = array(
		'data-bb-addon'    => '1',
		'data-bb-fee'      => (string) $fee,
		'data-bb-fee-mode' => $mode,
	);
	if ( 'select' === $type && 'once' === (string) ( $def['fee_mode'] ?? '' ) ) {
		// A dropdown's mode attribute stays "select": it is what tells every
		// reader to price by the CHOSEN option. WHEN it charges follows the
		// field's own stored mode, and the server spreads a 'once' select's
		// option fee across the units (one setup charge however many are
		// bought), so the whole-line fact rides its own marker for the live
		// total to read. Without it the page multiplied the fee by the
		// quantity and promised 195.50 where 171.50 was charged.
		$attr_map['data-bb-fee-once'] = '1';
	}
	if ( $fee > 0 && 'select' !== $mode && '' === $bb_own_mode && ! in_array( $mode, array( 'unit', 'once' ), true ) ) {
		// A mode whose live maths lives in a module starts at nothing and is
		// recomputed by that module's script; the flat fallback must not count
		// the bare rate as the charge.
		$attr_map['data-bb-live-fee'] = '0';
		// A value already there (the cart's Edit options, a failed add sent
		// back) is priced now, as the till will: the module's script sets it
		// only after the total is first drawn, so "THE OLD MILL" read £34.00
		// where the cart said £44.20 until a key was pressed.
		$bb_had = is_scalar( $value ) ? trim( (string) $value ) : '';
		if ( '' !== $bb_had && 'char' === $mode ) {
			$attr_map['data-bb-live-fee'] = (string) ( $fee * ( function_exists( 'mb_strlen' ) ? mb_strlen( (string) $value ) : strlen( (string) $value ) ) );
		} elseif ( '' !== $bb_had && 'per_value' === $mode && is_numeric( $bb_had ) && (float) $bb_had > 0 ) {
			$attr_map['data-bb-live-fee'] = (string) ( $fee * (float) $bb_had );
		}
	}
	if ( 'engaged' === ( $def['require_when'] ?? '' ) ) {
		$attr_map['data-bb-follower'] = '1'; // a modifier; only counts when an anchor field is filled
	}
	// The programmatic half of the required marking: aria-required rides the
	// CONTROL the shopper uses, so assistive tech announces the requirement at
	// the field rather than nowhere at all. Only the perceivable controls carry
	// it (a hidden reference or area carrier has no reader to tell), which is
	// why it is its own map rather than a line in $attr_map above.
	$attr_req = $attr_map;
	if ( $req ) {
		$attr_req['aria-required'] = 'true';
	}

	// The merchant's own sentence, wired to the control with aria-describedby so
	// a screen reader hears it AS PART OF the field rather than as loose text
	// somewhere after it. Of every comparable plugin read for this, Gravity Forms
	// is the only one that bothers, and it is the whole difference between help
	// text and decoration. A table cell has no label and no room, so it says
	// nothing there: the column header is doing that job.
	$bb_desc    = $cell ? '' : trim( (string) ( $def['description'] ?? '' ) );
	$bb_desc_id = $id . '-desc';
	if ( '' !== $bb_desc ) {
		$attr_req['aria-describedby'] = $bb_desc_id;
	}

	if ( ! $cell ) {
		echo '<div class="bb-addon-field bb-addon-' . esc_attr( $type ) . '">';
	}

	if ( 'checkbox' === $type ) {
		if ( $cell ) {
			// Bare checkbox; the column header carries the label.
			printf( '<input type="checkbox" name="%s" value="1"%s', esc_attr( $name ), checked( ! empty( $value ), true, false ) );
			addon_boss_print_attrs( $attr_req );
			echo '>';
			return;
		}
		printf(
			'<label class="bb-addon-check"><input type="checkbox" name="%s" value="1"%s',
			esc_attr( $name ),
			checked( ! empty( $value ), true, false )
		);
		addon_boss_print_attrs( $attr_req );
		echo '> <span>' . esc_html( $label ) . '</span>';
		// The same one marking system the labelled fields wear.
		echo wp_kses(
			$req
				? ' <span class="bb-addon-req">' . esc_html__( 'Required', 'addon-boss' ) . '</span>'
				: addon_boss_optional_marker( $label ),
			addon_boss_kses_allowed()
		);
		if ( $fee > 0 ) {
			echo '<span class="bb-addon-fee">' . wp_kses_post( addon_boss_money( $fee, $product, array( 'sign' => true ) ) ) . '</span>';
		}
		echo '</label>';
		echo '</div>';
		return;
	}

	if ( ! $cell ) {
		// A heading right above already wears this field's exact words (the
		// per-item accordion header carrying "Shirt 1"): the label keeps the
		// ACCESSIBLE name and leaves the screen, the heading-stutter rule the
		// group section applies. Never stored; stamped by the caller that
		// drew the heading.
		$bb_label_sr = ! empty( $def['_bb_label_sr'] );
		// A capped field carries its own count, so a shopper naming a shirt can see
		// how much room is left instead of typing into a silent stop.
		printf( '<label class="bb-addon-label%s" for="%s">%s', $bb_label_sr ? ' screen-reader-text' : '', esc_attr( $id ), esc_html( $label ) );
		// One marking system for the whole page, the one the sets settled: the
		// word "Required" (the platform's own word) or "(optional)", both
		// visible and both readable, and neither repeated when the label
		// already says it. The old red asterisk was aria-hidden, so
		// assistive tech heard no requirement at all, and it was a second
		// grammar beside the sets' on the same panel.
		echo wp_kses(
			$req
				? ' <span class="bb-addon-req">' . esc_html__( 'Required', 'addon-boss' ) . '</span>'
				: addon_boss_optional_marker( $label ),
			addon_boss_kses_allowed()
		);
		$bb_counter = '';
		if ( ! empty( $def['maxlength'] ) && in_array( $type, array( 'text', 'textarea' ), true ) ) {
			$bb_counter = sprintf(
				' <span class="bb-addon-counter" data-bb-max="%d" aria-hidden="true">%s</span>',
				(int) $def['maxlength'],
				esc_html( mb_strlen( (string) ( $value ?? '' ) ) . '/' . (int) $def['maxlength'] )
			);
		}
		if ( ! $bb_label_sr && '' !== $bb_counter ) {
			echo wp_kses( $bb_counter, addon_boss_kses_allowed() );
		}
		// THE ANSWER, BESIDE THE QUESTION, once the row is a folded head. A
		// folded SET's head says what was chosen; a folded FIELD's said only
		// its own name, so a stack of shut rows had two that reported nothing.
		// The two words ride the markup, so the line the script rebuilds is the
		// translated one rather than an English fragment assembled in the
		// browser. Hidden until a fold layout reveals it: on a stacked page the
		// control is directly below and the repeat would be noise.
		if ( ! $bb_label_sr ) {
			printf(
				' <span class="bb-fecho" hidden aria-hidden="true" data-todo="%s" data-none="%s"></span>',
				esc_attr__( 'Choose', 'addon-boss' ),
				esc_attr__( 'None', 'addon-boss' )
			);
		}
		echo '</label>';
		if ( $bb_label_sr && '' !== $bb_counter ) {
			// The room-left count must not leave the screen with the label it
			// used to ride in; it stands beside the control instead.
			echo wp_kses( $bb_counter, addon_boss_kses_allowed() );
		}
	}

	switch ( $type ) {
		case 'textarea':
			printf( '<textarea id="%s" name="%s" class="bb-addon-input"', esc_attr( $id ), esc_attr( $name ) );
			if ( ! empty( $def['maxlength'] ) ) {
				printf( ' maxlength="%d"', (int) $def['maxlength'] );
			}
			addon_boss_print_attrs( $attr_req );
			echo '>' . esc_textarea( (string) ( $value ?? '' ) ) . '</textarea>';
			break;

		case 'number':
			$bb_nlo = isset( $def['num_min'] ) ? max( 0.0, (float) $def['num_min'] ) : 0.0;
			$bb_nhi = isset( $def['num_max'] ) ? (float) $def['num_max'] : null;
			printf(
				'<input type="number" id="%s" name="%s" class="bb-addon-input" value="%s" min="%s" step="%s"%s',
				esc_attr( $id ),
				esc_attr( $name ),
				esc_attr( (string) ( $value ?? '' ) ),
				esc_attr( (string) ( $bb_nlo + 0 ) ),
				empty( $def['num_whole'] ) ? 'any' : '1',
				null !== $bb_nhi ? ' max="' . esc_attr( (string) ( $bb_nhi + 0 ) ) . '"' : '' // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- esc_attr'd where built.
			);
			addon_boss_print_attrs( $attr_req );
			echo '>';
			// The fence is said up front, never discovered by refusal.
			if ( $bb_nlo > 0 || null !== $bb_nhi ) {
				$bb_nhint = null !== $bb_nhi
					? ( $bb_nlo > 0
						/* translators: 1: the lowest allowed number, 2: the highest allowed number */
						? sprintf( __( 'Between %1$s and %2$s', 'addon-boss' ), (string) ( $bb_nlo + 0 ), (string) ( $bb_nhi + 0 ) )
						/* translators: %s: the highest allowed number */
						: sprintf( __( 'Up to %s', 'addon-boss' ), (string) ( $bb_nhi + 0 ) ) )
					/* translators: %s: the lowest allowed number */
					: sprintf( __( 'At least %s', 'addon-boss' ), (string) ( $bb_nlo + 0 ) );
				echo '<span class="bb-addon-help">' . esc_html( $bb_nhint ) . '</span>';
			}
			break;

		case 'date':
		case 'time':
			// A module may take over a type this switch already draws: the paid
			// plan turns the plain date box into a priced one. Its registered
			// markup wins here, exactly as it does in the default arm below.
			// Without this the case would draw the plain box and the module's
			// input would never reach a storefront, while every direct call of
			// it in a test passed.
			if ( is_callable( $types[ $type ]['render'] ?? null ) ) {
				call_user_func( $types[ $type ]['render'], $def, $name, $value, $id, $attr_req );
				break;
			}
			printf(
				'<input type="%1$s" id="%2$s" name="%3$s" class="bb-addon-input" value="%4$s"',
				esc_attr( $type ),
				esc_attr( $id ),
				esc_attr( $name ),
				esc_attr( (string) ( $value ?? '' ) )
			);
			addon_boss_print_attrs( $attr_req );
			echo '>';
			break;

		case 'select':
			printf( '<select id="%s" name="%s" class="bb-addon-input"', esc_attr( $id ), esc_attr( $name ) );
			addon_boss_print_attrs( $attr_req );
			echo '>';
			echo '<option value="">' . esc_html__( 'Choose…', 'addon-boss' ) . '</option>';
			foreach ( (array) ( $def['options'] ?? array() ) as $opt ) {
				$ofee = (float) ( $opt['fee'] ?? 0 );
				// What the CHARGE reads as on this shop: the raw figure is what a
				// tax-inclusive store charges on top, not what it shows. Said in
				// the display basis the receipt below already speaks, or the
				// dropdown promises one number and the tray charges another.
				$ofee_shown = addon_boss_fee_shown( $ofee, $product );
				// An option saved without a value (an import, an old field) is
				// posted as its label: it warned "Undefined array key" on every
				// page that drew it.
				$oval       = (string) ( $opt['value'] ?? ( $opt['label'] ?? '' ) );
				$olabel     = (string) ( $opt['label'] ?? $oval );
				printf(
					// data-bb-fee stays the RAW fee: the grid and the fee modes
					// price from it. data-delta is the shown one, so the VAT
					// toggle can repaint this label the way it repaints the total.
					'<option value="%s"%s data-bb-fee="%s" data-delta="%s" data-label="%s">%s%s</option>',
					esc_attr( $oval ),
					selected( (string) $value, $oval, false ),
					esc_attr( (string) $ofee ),
					esc_attr( (string) $ofee_shown ),
					esc_attr( $olabel ),
					esc_html( $olabel ),
					$ofee > 0 ? ' (' . esc_html( addon_boss_money( $ofee_shown, null, array( 'plain' => true, 'sign' => true, 'convert' => false ) ) ) . ')' : ''
				);
			}
			echo '</select>';
			break;

		case 'email':
			// The sentence the server refuses a wrong address with, printed on the
			// field, so the page can say it the moment the shopper leaves the box
			// and the two can never disagree.
			printf(
				'<input type="email" id="%s" name="%s" class="bb-addon-input" value="%s" autocomplete="email" spellcheck="false" data-bb-bad="%s"',
				esc_attr( $id ),
				esc_attr( $name ),
				esc_attr( (string) ( $value ?? '' ) ),
				/* translators: %s: the name of whatever is unanswered, a field or a dimension */
				esc_attr( sprintf( __( '%s: enter an email address like name@example.com.', 'addon-boss' ), (string) $label ) )
			);
			addon_boss_print_attrs( $attr_req );
			echo '>';
			// The nudge lands here: one quiet line, filled by the typo check, never
			// blocking anything. Empty = absent to every reader.
			printf( '<button type="button" class="bb-addon-mailhint" data-bb-for="%s" aria-live="polite" hidden></button>', esc_attr( $id ) );
			// The complaint sits beside the box it is about, as the amount's does.
			echo '<p class="bb-gmiss-note bb-gmiss-here" role="status" aria-live="polite" hidden></p>';
			break;

		case 'url':
			// type="text" on purpose: the strict native url check rejects
			// "mysite.com", which is how people actually type their site.
			printf(
				'<input type="text" inputmode="url" id="%s" name="%s" class="bb-addon-input" value="%s" spellcheck="false" placeholder="%s" data-bb-bad="%s"',
				esc_attr( $id ),
				esc_attr( $name ),
				esc_attr( (string) ( $value ?? '' ) ),
				esc_attr__( 'example.com', 'addon-boss' ),
				/* translators: %s: the name of whatever is unanswered, a field or a dimension */
				esc_attr( sprintf( __( '%s: enter a web address like example.com.', 'addon-boss' ), (string) $label ) )
			);
			addon_boss_print_attrs( $attr_req );
			echo '>';
			echo '<p class="bb-gmiss-note bb-gmiss-here" role="status" aria-live="polite" hidden></p>';
			break;

		case 'color':
			$bb_val    = (string) ( $value ?? '' );
			$bb_is_cus = 0 === strpos( $bb_val, 'custom:' );
			// data-pmode names the voice these swatches speak, so a shopper
			// flipping the tax toggle repaints them in it. Without the host the
			// repaint reads whichever priced control rendered first on the page.
			printf( '<div class="bb-addon-colour" id="%s" role="radiogroup" aria-label="%s" data-pmode="delta">', esc_attr( $id ), esc_attr( $label ) );
			foreach ( (array) ( $def['options'] ?? array() ) as $opt ) {
				$ofee = (float) ( $opt['fee'] ?? 0 );
				$oval = (string) ( $opt['value'] ?? ( $opt['label'] ?? '' ) ); // no value saved: its label
				printf(
					'<label class="bb-colour-sw"><input type="radio" name="%1$s" value="%2$s"%3$s data-bb-fee="%4$s" data-delta="%9$s"%5$s><span class="bb-colour-disc" style="background:%6$s"></span><span class="bb-colour-name">%7$s%8$s</span></label>',
					esc_attr( $name ),
					esc_attr( $oval ),
					checked( $bb_val, $oval, false ),
					esc_attr( (string) $ofee ),
					$req ? ' required' : '',
					esc_attr( $opt['color'] ?? '#cccccc' ),
					esc_html( (string) ( $opt['label'] ?? $oval ) ),
					// The figure sits in its own span so the repaint can rewrite it
					// without eating the brackets around it.
					$ofee > 0 ? ' <span class="bb-colour-fee">(<span class="bb-chip-delta">' . esc_html( addon_boss_money( $ofee, $product, array( 'plain' => true, 'sign' => true ) ) ) . '</span>)</span>' : '',
					esc_attr( (string) addon_boss_fee_shown( $ofee, $product ) )
				);
			}
			if ( ! empty( $def['allow_custom'] ) ) {
				$bb_cfee = (float) ( $def['custom_fee'] ?? 0 );
				$bb_hex  = $bb_is_cus ? addon_boss_normalise_hex( substr( $bb_val, 7 ) ) : '';
				// The whole custom row waits for the script that makes it work:
				// without it the presets stand alone, complete, rather than a
				// dead swatch beside a picker nothing reads.
				printf(
					'<span class="bb-colour-custom" data-bb-fee="%s" hidden>'
					. '<label class="bb-colour-sw bb-colour-customsw"><input type="radio" name="%s" value="%s"%s data-bb-fee="%1$s" data-delta="%12$s" data-bb-rule-value="custom"><span class="bb-colour-disc bb-colour-anydisc" aria-hidden="true"></span><span class="bb-colour-name">%s%s</span></label>'
					. '<span class="bb-colour-pick"%s><input type="color" class="bb-colour-picker" value="%s" aria-label="%s"><input type="text" class="bb-colour-hex" value="%s" placeholder="#1A2B3C" maxlength="7" aria-label="%s" spellcheck="false"></span>'
					. '</span>',
					esc_attr( (string) $bb_cfee ),
					esc_attr( $name ),
					esc_attr( $bb_is_cus ? $bb_val : 'custom:' ),
					checked( $bb_is_cus, true, false ),
					esc_html__( 'Custom', 'addon-boss' ),
					$bb_cfee > 0 ? ' <span class="bb-colour-fee">(<span class="bb-chip-delta">' . esc_html( addon_boss_money( $bb_cfee, $product, array( 'plain' => true, 'sign' => true ) ) ) . '</span>)</span>' : '',
					$bb_is_cus ? '' : ' hidden',
					esc_attr( '' !== $bb_hex ? $bb_hex : '#1a2b3c' ),
					esc_attr__( 'Pick a colour', 'addon-boss' ),
					esc_attr( $bb_hex ),
					esc_attr__( 'Colour code', 'addon-boss' ),
					esc_attr( (string) addon_boss_fee_shown( $bb_cfee, $product ) )
				);
			}
			echo '</div>';
			break;

		case 'price':
			$bb_cur = function_exists( 'get_woocommerce_currency_symbol' ) ? get_woocommerce_currency_symbol() : '';
			// THE BOX TAKES THE FIGURE THE SHOPPER IS READING.
			//
			// Every other price on the page converts to the shop's display basis,
			// and for a while this field alone did not: it took the ENTRY basis and
			// a line under it apologised ("Type the amount without VAT"). On a shop
			// showing inc-VAT prices, typing 5 charged 6. His call, 7 Sept: the box
			// speaks the shopper's basis, the apology goes, and the server converts
			// what was typed back to the entry basis for the charge.
			//
			// So every figure on this field is DISPLAY basis: the chips, the
			// bounds, the refusal sentences, and the number the box takes.
			// data-pmode="whole" hands the lot to the tax toggle's repaint, and the
			// -ex/-in attribute pairs carry both bases so the client can follow a
			// live flip without re-deriving any tax maths of its own.
			$bb_ep   = $product instanceof WC_Product ? $product : null;
			$bb_dec  = function_exists( 'wc_get_price_decimals' ) ? wc_get_price_decimals() : 2;
			$bb_show = static function ( float $bb_v ) use ( $bb_ep ): float {
				return $bb_ep ? addon_boss_fee_shown( $bb_v, $bb_ep ) : $bb_v;
			};
			$bb_ex = static function ( float $bb_v ) use ( $bb_ep ): float {
				return $bb_ep && function_exists( 'wc_get_price_excluding_tax' )
					? (float) wc_get_price_excluding_tax( $bb_ep, array( 'price' => $bb_v, 'qty' => 1 ) )
					: $bb_v;
			};
			$bb_in = static function ( float $bb_v ) use ( $bb_ep ): float {
				return $bb_ep && function_exists( 'wc_get_price_including_tax' )
					? (float) wc_get_price_including_tax( $bb_ep, array( 'price' => $bb_v, 'qty' => 1 ) )
					: $bb_v;
			};
			echo '<div class="bb-addon-ownprice" data-pmode="whole">';
			$bb_chips = (array) ( $def['price_amounts'] ?? array() );
			if ( $bb_chips ) {
				// Buttons that only work by script stay hidden until the script is
				// there; the typed box below is the whole feature without it.
				// A chip shows the display-basis figure, and PRESSING it writes that
				// same figure into the box: one number for one amount, in the basis
				// the shopper is reading. Both bases ride along so a live toggle
				// flip can keep the promise without any client-side tax maths.
				echo '<span class="bb-price-chips" role="group" aria-label="' . esc_attr__( 'Suggested amounts', 'addon-boss' ) . '" hidden>';
				foreach ( $bb_chips as $bb_chip ) {
					printf(
						'<button type="button" class="bb-price-chip" data-delta="%s" data-bb-amount="%s" data-bb-amount-ex="%s" data-bb-amount-in="%s">%s</button>',
						esc_attr( (string) $bb_show( (float) $bb_chip ) ),
						esc_attr( (string) addon_boss_round_money( $bb_show( (float) $bb_chip ), $bb_dec ) ),
						esc_attr( (string) addon_boss_round_money( $bb_ex( (float) $bb_chip ), $bb_dec ) ),
						esc_attr( (string) addon_boss_round_money( $bb_in( (float) $bb_chip ), $bb_dec ) ),
						esc_html( addon_boss_money( (float) $bb_chip, $product, array( 'plain' => true ) ) )
					);
				}
				echo '</span>';
			}
			// A BOUND ONLY THE TILL KNOWS ABOUT IS NOT A BOUND.
			//
			// Minimum and maximum were printed under the box as words and enforced on
			// the server, with nothing in between. The box took any figure without
			// complaint, the running total quoted it, and the refusal arrived only at
			// Add to basket. (His find, 7 Sept.)
			//
			// The box carries its bounds in the display basis the shopper reads, in
			// both bases for a live toggle flip, plus the sentence as a template the
			// client fills with the current-basis figure. The prefilled -say twin is
			// the fallback for a page with no money formatter to hand. The server
			// stays the enforcer; this only moves the news to the field.
			$bb_bounds = '';
			if ( isset( $def['price_min'] ) ) {
				$bb_bounds .= sprintf(
					' data-bb-pmin="%s" data-bb-pmin-ex="%s" data-bb-pmin-in="%s" data-bb-pmin-say="%s"',
					esc_attr( (string) $bb_show( (float) $def['price_min'] ) ),
					esc_attr( (string) $bb_ex( (float) $def['price_min'] ) ),
					esc_attr( (string) $bb_in( (float) $def['price_min'] ) ),
					esc_attr(
						sprintf(
							// AT THE FIELD, SAY THE RULE. The till's sentence names the field,
							// because a cart notice arrives with no context. Here the label sits
							// an inch above, so repeating it reads as a stutter. (His look, 7 Sept.)
							/* translators: %s: the smallest amount accepted */
							__( 'Enter at least %s.', 'addon-boss' ),
							// aob-money-raw: the bound in the basis the shopper reads,
							// exactly as the server compares it.
							addon_boss_plain_price( $bb_show( (float) $def['price_min'] ) )
						)
					)
				);
			}
			if ( isset( $def['price_max'] ) ) {
				$bb_bounds .= sprintf(
					' data-bb-pmax="%s" data-bb-pmax-ex="%s" data-bb-pmax-in="%s" data-bb-pmax-say="%s"',
					esc_attr( (string) $bb_show( (float) $def['price_max'] ) ),
					esc_attr( (string) $bb_ex( (float) $def['price_max'] ) ),
					esc_attr( (string) $bb_in( (float) $def['price_max'] ) ),
					esc_attr(
						sprintf(
							/* translators: %s: the largest amount accepted */
							__( 'Enter at most %s.', 'addon-boss' ),
							// aob-money-raw: the upper twin of price_min, same reason.
							addon_boss_plain_price( $bb_show( (float) $def['price_max'] ) )
						)
					)
				);
			}
			if ( isset( $def['price_min'] ) || isset( $def['price_max'] ) ) {
				/* translators: %s: the smallest amount accepted */
				$bb_bounds .= ' data-bb-say-min="' . esc_attr__( 'Enter at least %s.', 'addon-boss' ) . '"';
				/* translators: %s: the largest amount accepted */
				$bb_bounds .= ' data-bb-say-max="' . esc_attr__( 'Enter at most %s.', 'addon-boss' ) . '"';
			}
			printf(
				'<span class="bb-price-entry"><span class="bb-price-symbol" data-pmode="hidden" aria-hidden="true">%s</span><input type="text" inputmode="decimal" id="%s" name="%s" class="bb-addon-input bb-price-input" value="%s" data-bb-own-amount="1" data-bb-fee="0" data-bb-fee-mode="' . esc_attr( (string) ( $def['fee_mode'] ?? 'unit' ) ) . '"%s',
				esc_html( $bb_cur ),
				esc_attr( $id ),
				esc_attr( $name ),
				esc_attr( (string) ( $value ?? '' ) ),
				$bb_bounds // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- assembled from esc_attr parts above.
			);
			addon_boss_print_attrs( $attr_req );
			echo '></span>';
			// WHICH BASIS THE SHOPPER WAS READING travels with the form. A tax
			// toggle keeps its state in the browser, so the server cannot know
			// which side the page showed when the amount was typed; this field
			// says so, and the script updates it on every flip. Declaring it is
			// money-safe: bounds and charge convert together, so whatever basis
			// is claimed, the shopper pays the figure they saw against the bounds
			// they saw.
			printf(
				'<input type="hidden" class="bb-own-basis" name="bb_own_basis" value="%s">',
				esc_attr( 'incl' === get_option( 'woocommerce_tax_display_shop', 'excl' ) ? 'incl' : 'excl' )
			);
			$bb_pmin = isset( $def['price_min'] ) ? (float) $def['price_min'] : null;
			$bb_psug = isset( $def['price_suggested'] ) ? (float) $def['price_suggested'] : null;
			// The bounds are always said, never a guessing game after a refusal.
			if ( null !== $bb_pmin || null !== $bb_psug ) {
				// The ladder reads in order: minimum, suggestion, maximum. All three
				// describe the box below them in the basis the shopper reads, and
				// each figure carries data-delta so the toggle repaint moves it with
				// every other price on the page.
				$bb_bit = static function ( string $bb_tpl, float $bb_v ) use ( $bb_show ): string {
					return sprintf(
						$bb_tpl,
						'<span data-delta="' . esc_attr( (string) $bb_show( $bb_v ) ) . '">'
							. esc_html( addon_boss_plain_price( $bb_show( $bb_v ) ) ) . '</span>' // aob-money-raw: the bound in the shopper's display basis, converted by bb_show above.
					);
				};
				$bb_bits = array();
				if ( null !== $bb_pmin ) {
					/* translators: %s: a money amount */
					$bb_bits[] = $bb_bit( __( 'Minimum %s', 'addon-boss' ), $bb_pmin ); // aob-money-raw: display basis, converted above.
				}
				if ( null !== $bb_psug ) {
					/* translators: %s: a money amount */
					$bb_bits[] = $bb_bit( __( 'Suggested: %s', 'addon-boss' ), $bb_psug ); // aob-money-raw: display basis, converted above.
				}
				$bb_pmax = (float) ( $def['price_max'] ?? 0 );
				if ( $bb_pmax > 0 ) {
					/* translators: %s: a money amount */
					$bb_bits[] = $bb_bit( __( 'Maximum %s', 'addon-boss' ), $bb_pmax ); // aob-money-raw: display basis, converted above.
				}
				echo '<span class="bb-addon-help">' . wp_kses( implode( ' · ', $bb_bits ), array( 'span' => array( 'data-delta' => true ) ) ) . '</span>';
			}
			// THE COMPLAINT SITS BESIDE THE RULE IT BROKE.
			//
			// The group's refusal line renders at the TOP of the card, which is right
			// for a missing choice: the whole card is the offender. A bounded amount
			// is different: its rule is printed at the bottom, under the box, so the
			// complaint lands there too, and the group's own line stays for
			// everything else. (His look, 7 Sept.)
			if ( isset( $def['price_min'] ) || isset( $def['price_max'] ) ) {
				echo '<p class="bb-gmiss-note bb-gmiss-here" role="status" aria-live="polite" hidden></p>';
			}
			echo '</div>';
			break;

		case 'text':
		default:
			// A type that registered its own input markup renders through it.
			if ( is_callable( $types[ $type ]['render'] ?? null ) ) {
				call_user_func( $types[ $type ]['render'], $def, $name, $value, $id, $attr_map );
				break;
			}
			printf(
				'<input type="text" id="%s" name="%s" class="bb-addon-input" value="%s"',
				esc_attr( $id ),
				esc_attr( $name ),
				esc_attr( (string) ( $value ?? '' ) )
			);
			if ( ! empty( $def['maxlength'] ) ) {
				printf( ' maxlength="%d"', (int) $def['maxlength'] );
			}
			addon_boss_print_attrs( $attr_req );
			echo '>';
			break;
	}

	if ( ! $cell && $fee > 0 && ! in_array( $type, array( 'select', 'color' ), true ) ) {
		// A dropdown and a colour price by the chosen option; a stored field fee
		// from before the sanitiser zeroed them must not be promised here either.
		// A rate has to say what it is a rate OF, or the shopper reads it as the
		// whole charge: "+£12.00" on a size field that will actually bill £72 for
		// six square metres is the exact mismatch this suffix prevents. Each
		// rate-shaped mode's wording rides with the module that does its maths;
		// a flat fee needs no qualifier and says nothing.
		$suffix = (string) apply_filters( 'addon_boss_fee_rate_suffix', '', $mode, $def );
		echo ' <span class="bb-addon-fee" data-bb-rate="1">' . wp_kses_post( addon_boss_money( $fee, $product, array( 'sign' => true ) ) ) . esc_html( $suffix ) . '</span>';
	}

	if ( '' !== $bb_desc ) {
		// The same slot and the same dress the engine's OWN computed lines use (a
		// number's fence, a date's earliest day), so the two read as one voice
		// under the field. Never merged with them, though, and never seeded from
		// them: what the engine works out stays the engine's and is always true of
		// the settings; what the merchant typed stays theirs and is never written
		// for them. Gravity Forms settled this exact question the same way, by
		// rendering its generated file rules as their own line wearing the
		// description class beside the merchant's text.
		printf(
			'<span class="bb-addon-help bb-addon-desc" id="%s">%s</span>',
			esc_attr( $bb_desc_id ),
			esc_html( $bb_desc )
		);
	}

	if ( ! $cell ) {
		echo '</div>';
	}
}

// =================================================================
// Option-set store, schema + measured maths. Lifted UNCHANGED from
// the earlier bundle-side layout; the option-set library both surfaces draw
// from, plus the measured-set pricing maths.
// =================================================================

const ADDON_BOSS_OPTION_SETS_STORE = 'bundle_boss_option_sets';
const ADDON_BOSS_PRODUCT_OPTIONS_META = '_bundle_boss_product_options';

/**
 * The one reader for "which side is the VAT toggle showing", as a script
 * fragment every surface that paints money embeds.
 *
 * Asked of the TOGGLE'S OWN MEMORY rather than of the page, because reading the
 * page is a race and on a reload we lose it: the plugin restores the shopper's
 * choice in its own script, and whichever of us paints first wins. That is the
 * whole of the reload defect - the switch reads Incl VAT, our figures read Ex,
 * and the two agree again the moment somebody toggles, because a toggle fires
 * the event we already listen for. Nothing was ever wrong with the arithmetic.
 *
 * What the plugin stores is "switched away from the shop's own basis", so that
 * flag and the basis together answer the question with no timing in it at all.
 * With nothing stored (nobody has toggled in this browser) the page is showing
 * the shop's own basis, and the DOM agrees, so the DOM is read instead.
 *
 * One copy, emitted three times, so the two cannot drift apart.
 */
function addon_boss_wts_reader_js(): string {
	return <<<'JS'
	function bbWtsIncl( basis ) {
		var raw = null;
		try {
			raw = window.localStorage.getItem( "wdevs_tax_switch_is_switched" );
		} catch ( e ) {
			raw = null; // a browser refusing storage: fall through to the page.
		}
		if ( null !== raw ) {
			var switched = "true" === String( raw ).trim();
			return ( "incl" === basis && ! switched ) || ( "excl" === basis && switched );
		}
		var active = document.querySelector( ".wts-price-wrapper .wts-active" );
		if ( active ) { return active.classList.contains( "wts-price-incl" ); }
		return "incl" === basis;
	}
JS;
}

/**
 * The VAT-toggle attributes for a surface that paints its own money.
 *
 * 🔴 Whether the Tax Switch plugin runs is decided HERE, server-side, rather
 * than by sniffing its JS globals. Its wtsCompatibilityObject only exists
 * where one of ITS OWN compat shims happens to load, and its switch block
 * loads nothing unless the merchant placed it, while its server side wraps
 * every static price in the incl/excl pair unconditionally. So on David's
 * shop (23 Aug) the page was covered in dual prices while the one figure
 * carrying the option and embroidery money, our live total, painted a single
 * basis: the pair "only carried the base". The base rate rides along for the
 * same reason: the compat object that used to supply it is not there to ask.
 *
 * Empty when the plugin is absent or the product carries no tax, so every
 * consumer can echo it unconditionally and nothing changes on shops without
 * the toggle. Escaped within.
 */
function addon_boss_wts_attrs( WC_Product $product ): string {
	if ( ! defined( 'WDEVS_TAX_SWITCH_VERSION' ) || ! function_exists( 'wc_tax_enabled' ) || ! wc_tax_enabled() || 'taxable' !== $product->get_tax_status() ) {
		return '';
	}
	$rate = array_sum( array_map( 'floatval', array_column( WC_Tax::get_base_tax_rates( $product->get_tax_class() ), 'rate' ) ) );
	// The shop's OWN display basis rides along, because the toggle plugin
	// remembers "switched away from it" rather than "showing tax": the two
	// together are the only way to answer which side is on without waiting to
	// see what the plugin does to the page.
	return ' data-wts="1" data-wts-rate="' . esc_attr( (string) $rate ) . '"'
		. ' data-tax-basis="' . esc_attr( get_option( 'woocommerce_tax_display_shop', 'excl' ) ) . '"';
}

// -----------------------------------------------------------------
// Keys
// -----------------------------------------------------------------

/**
 * A stable, immutable key for an option or a set. Generated once at row
 * creation and preserved by the sanitiser forever after; renaming a label
 * never changes the key.
 */
function addon_boss_option_key( string $prefix = 'op' ): string {
	return $prefix . '_' . substr( md5( uniqid( (string) wp_rand(), true ) ), 0, 10 );
}

/** True when a key looks like one of ours (or a sane hand-written slug). */
function addon_boss_option_key_valid( $key ): bool {
	return is_string( $key ) && '' !== $key && (bool) preg_match( '/^[a-z0-9_\-]{1,40}$/', $key );
}

// -----------------------------------------------------------------
// Sets store (CRUD)
// -----------------------------------------------------------------

/**
 * All saved option sets, keyed by set id.
 *
 * Read once per request and remembered until the library is written. WordPress
 * unserialises a stored option afresh on every get_option(), and this reader
 * is called once per choice while a page or editor draws: one bundle's items
 * panel asked for the library 5,852 times, a whole library each time, which
 * was 3.3 of its 3.7 seconds on a 287-set library and grows with every set a
 * shop adds (a supplier-built library made a bundle take about 45 seconds to
 * open for editing). Any save, add or delete of the store forgets the copy,
 * so a write and a read in the same request still agree.
 *
 * The copy lives in a non-persistent object cache group rather than a PHP
 * global, so it is kept per site after switch_to_blog() on a network and is
 * dropped by wp_cache_flush() along with WordPress's own option cache.
 *
 * @return array<string,array{name:string,options:array[]}>
 */
function addon_boss_option_sets(): array {
	$found = false;
	$sets  = wp_cache_get( 'option_sets', ADDON_BOSS_OPTION_SETS_MEMO, false, $found );
	if ( $found && is_array( $sets ) ) {
		return $sets;
	}
	$sets = addon_boss_option_sets_read();
	wp_cache_set( 'option_sets', $sets, ADDON_BOSS_OPTION_SETS_MEMO );
	return $sets;
}

/** Forget the remembered library, so the next read comes from the store. */
function addon_boss_option_sets_forget(): void {
	wp_cache_delete( 'option_sets', ADDON_BOSS_OPTION_SETS_MEMO );
}

/**
 * Change the library as the database holds it now, one writer at a time.
 *
 * Every set lives in one option, so a writer reads the whole library and
 * writes the whole library back. One that read it early in its request (an
 * editor save reads it long before it writes) put back a library without
 * whatever another admin saved in between: a tester's new set vanished,
 * "saved", while two others were saving theirs (18 Oct 2026). A writer now
 * holds a database lock, re-reads the store past every cache, changes it
 * and writes it, so two saves land one after the other. Where the database
 * has no named locks, the fresh read alone narrows the gap to milliseconds.
 *
 * @param callable $change Gets the library; returns the library to store, or
 *                         anything else (a WP_Error, null) to store nothing.
 * @return mixed What $change returned.
 */
function addon_boss_option_sets_change( callable $change ) {
	global $wpdb;
	$bb_lock = substr( $wpdb->prefix . 'addon_boss_option_sets', 0, 64 );
	$bb_was  = $wpdb->suppress_errors( true );
	$bb_held = '1' === (string) $wpdb->get_var( $wpdb->prepare( 'SELECT GET_LOCK( %s, 5 )', $bb_lock ) ); // phpcs:ignore WordPress.DB.DirectDatabaseQuery.DirectQuery, WordPress.DB.DirectDatabaseQuery.NoCaching -- a named lock, not data: there is nothing to cache.
	$wpdb->suppress_errors( $bb_was );
	try {
		wp_cache_delete( ADDON_BOSS_OPTION_SETS_STORE, 'options' );
		addon_boss_option_sets_forget();
		$bb_out = $change( addon_boss_option_sets() );
		if ( is_array( $bb_out ) ) {
			// update_option() keeps the existing autoload flag, so seed the
			// row with autoload off and update after.
			if ( false === get_option( ADDON_BOSS_OPTION_SETS_STORE, false ) ) {
				add_option( ADDON_BOSS_OPTION_SETS_STORE, array(), '', false );
			}
			update_option( ADDON_BOSS_OPTION_SETS_STORE, $bb_out, false );
		}
		return $bb_out;
	} finally {
		if ( $bb_held ) {
			$wpdb->query( $wpdb->prepare( 'SELECT RELEASE_LOCK( %s )', $bb_lock ) ); // phpcs:ignore WordPress.DB.DirectDatabaseQuery.DirectQuery, WordPress.DB.DirectDatabaseQuery.NoCaching -- releases the named lock above.
		}
	}
}
const ADDON_BOSS_OPTION_SETS_MEMO = 'addon_boss_memo';
wp_cache_add_non_persistent_groups( array( ADDON_BOSS_OPTION_SETS_MEMO ) );
add_action( 'add_option_' . ADDON_BOSS_OPTION_SETS_STORE, 'addon_boss_option_sets_forget' );
add_action( 'update_option_' . ADDON_BOSS_OPTION_SETS_STORE, 'addon_boss_option_sets_forget' );
add_action( 'delete_option_' . ADDON_BOSS_OPTION_SETS_STORE, 'addon_boss_option_sets_forget' );

/**
 * The library as stored, shape-checked. Use addon_boss_option_sets().
 *
 * @return array<string,array{name:string,options:array[]}>
 */
function addon_boss_option_sets_read(): array {
	$sets = get_option( ADDON_BOSS_OPTION_SETS_STORE, array() );
	if ( ! is_array( $sets ) ) {
		return array();
	}
	// Stored data is historical fact: an older build wrote table sets with no
	// options key, and one such set took the whole library screen down with a
	// TypeError. The reader guarantees the shape every consumer assumes, so a
	// set written by any past version renders, opens and can be put right.
	foreach ( $sets as $id => $set ) {
		if ( ! is_array( $set ) ) {
			unset( $sets[ $id ] );
			continue;
		}
		if ( ! isset( $set['options'] ) || ! is_array( $set['options'] ) ) {
			$sets[ $id ]['options'] = array();
			continue;
		}
		// The same goes for a row. One written outside the set editor (an
		// import, a fixture, an older build) can carry a key and a label and
		// nothing else, and the readers of a row read its colour, photo and
		// charge straight: the library card's chip and the product resolver
		// both logged "Undefined array key" for every such row on every load.
		// Each key the editor writes is filled with what its absence already
		// meant, and a key a row does carry is left exactly as it is. Stock is
		// not filled: no stock key means unlimited.
		foreach ( $set['options'] as $i => $opt ) {
			if ( is_array( $opt ) ) {
				$sets[ $id ]['options'][ $i ] = $opt + array(
					'swatch'   => '',
					'swatch2'  => '',
					'desc'     => '',
					'image_id' => 0,
					'delta'    => 0.0,
					'dims'     => array(),
				);
			}
		}
	}
	return $sets;
}

/** One saved set, or null. */
function addon_boss_option_set( string $id ): ?array {
	$sets = addon_boss_option_sets();
	return $sets[ $id ] ?? null;
}

/**
 * The kinds an option set can be.
 *
 * The engine's own kind is 'choices': a named list, each entry with an
 * optional charge. A kind priced by other means registers here from the module
 * that implements it, carrying the callbacks the engine calls at each seam:
 *   label        the kind picker's wording
 *   desc         the sentence under the picker saying what the kind is for
 *   uses_options whether the set's option rows apply (a kind priced off its
 *                own panel says no and the editor hides them)
 *   collect      read the kind's own fields from the save form into raw shape
 *   sanitize     raw shape to the stored keys to merge over the base set
 *   editor       print the kind's panel inside the set editor
 *   snapshot     resolve one request against a set of this kind into a cart
 *                snapshot (null = nothing picked, WP_Error = refuse the add)
 *   seed         the reverse of snapshot, for the cart edit loop: one frozen
 *                snapshot back into the request fields (name => value) that
 *                would have produced it, so an edited line arrives prefilled.
 *                The engine's own 'choices' kind needs none (its one field
 *                carries the option's key); a kind without one seeds nothing.
 *   render       print the set's body on the product page
 *   save_notice  something worth saying about the set just saved, or null
 *   own_sections the kind's editor draws whole sections of its own, rows and
 *                all; the shared Price section and the choice rows stand
 *                down for it, and the rows do not post while it is picked
 *   start        the kind's card on the new-set start screen, as a callback
 *                returning title, line, example (one worked price from a
 *                template's own numbers), order, blank (the recipe that opens
 *                the kind empty) and recipes: recipe id => label and the set
 *                that recipe starts from. A kind without one still gets a
 *                card, from its label and desc, opening it empty
 *
 * A stored set whose kind nothing registers is INERT: it stays stored and
 * listed, offers nothing, charges nothing, and is never sanitised away, so it
 * returns whole the moment the module that owns it is installed.
 *
 * @return array<string,array>
 */
function addon_boss_option_set_kinds(): array {
	$own = array(
		'choices' => array(
			'label'        => __( 'a list of choices', 'addon-boss' ),
			'desc'         => __( 'Named options, each with its own price.', 'addon-boss' ),
			'uses_options' => true,
			'start'        => 'addon_boss_choices_start_card',
		),
	);
	return (array) apply_filters( 'addon_boss_option_set_kinds', $own );
}

/**
 * The list of choices' card on the new-set start screen: first, because it
 * is the set most shops make. Its templates are the starter sets, each tile
 * summed up from its own choices, so a tile never shows a number its
 * template does not have.
 *
 * @return array<string,mixed>
 */
function addon_boss_choices_start_card(): array {
	$recipes = array();
	foreach ( addon_boss_option_starter_sets() as $bb_rid => $bb_starter ) {
		$recipes[ (string) $bb_rid ] = array(
			'label' => (string) $bb_starter['name'],
			'set'   => $bb_starter,
		) + addon_boss_choices_tile( (array) $bb_starter['options'] );
	}
	return array(
		'order'   => 10,
		'title'   => __( 'List of choices', 'addon-boss' ),
		'line'    => __( 'Colours, sizes, finishes or extras, each with its own price', 'addon-boss' ),
		'pic'     => addon_boss_choices_start_picture(),
		'blank'   => 'scratch',
		'recipes' => $recipes,
	);
}

/**
 * A starter list summed up for its template tile: its first charged choice
 * and how many more are charged, or else how many choices it holds (colours,
 * when every choice is one), with a small picture of its first few.
 *
 * @param array $options The template's choices.
 * @return array{say:string,mini:array}
 */
function addon_boss_choices_tile( array $options ): array {
	$priced = array();
	$dots   = array();
	$labels = array();
	foreach ( $options as $bb_opt ) {
		$bb_label = (string) ( $bb_opt['label'] ?? '' );
		if ( '' !== $bb_label ) {
			$labels[] = $bb_label;
		}
		if ( (float) ( $bb_opt['delta'] ?? 0 ) > 0 ) {
			$priced[] = $bb_opt;
		}
		if ( '' !== (string) ( $bb_opt['swatch'] ?? '' ) ) {
			$dots[] = (string) $bb_opt['swatch'];
		}
	}
	$n       = count( $options );
	$colours = $n > 0 && count( $dots ) === $n;
	if ( $priced ) {
		$say  = (string) $priced[0]['label'] . ' ' . addon_boss_editor_money_text( (float) $priced[0]['delta'], true );
		$more = count( $priced ) - 1;
		if ( $more > 0 ) {
			/* translators: 1: the first ones, named, 2: how many more there are */
			$say = sprintf( _n( '%1$s and %2$d more', '%1$s and %2$d more', $more, 'addon-boss' ), $say, $more );
		}
	} elseif ( $colours ) {
		/* translators: %d: how many colours */
		$say = sprintf( _n( '%d colour', '%d colours', $n, 'addon-boss' ), $n );
	} else {
		/* translators: %d: how many choices a template holds */
		$say = sprintf( _n( '%d choice', '%d choices', $n, 'addon-boss' ), $n );
	}
	return array(
		'say'  => $say,
		'mini' => $colours ? array( 'dots' => array_slice( $dots, 0, 7 ) ) : array( 'chips' => array_slice( $labels, 0, 4 ) ),
	);
}

/**
 * The list of choices drawn as the shape shoppers meet, nothing more: a row
 * of colours with one picked and a row of sizes with one picked. Plain
 * shapes, so the card stands for any shop's choices rather than one
 * product's photo.
 *
 * @return string
 */
function addon_boss_choices_start_picture(): string {
	return '<svg viewBox="0 0 320 176" aria-hidden="true" class="bb-start-svg">'
		. '<rect class="pk-paper" x="38" y="20" width="244" height="190" rx="12"/>'
		. '<rect class="pk-head" x="62" y="40" width="58" height="7" rx="3.5"/>'
		. '<circle class="pk-c1" cx="76" cy="74" r="13"/>'
		. '<circle class="pk-c2" cx="111" cy="74" r="13"/>'
		. '<circle class="pk-ring" cx="146" cy="74" r="17"/>'
		. '<circle class="pk-c3" cx="146" cy="74" r="13"/>'
		. '<circle class="pk-c4" cx="181" cy="74" r="13"/>'
		. '<circle class="pk-c5" cx="216" cy="74" r="13"/>'
		. '<circle class="pk-c6" cx="251" cy="74" r="13"/>'
		. '<rect class="pk-head" x="62" y="106" width="44" height="7" rx="3.5"/>'
		. '<rect class="pk-cell" x="62" y="122" width="36" height="28" rx="8"/>'
		. '<rect class="pk-bar" x="73" y="133" width="14" height="6" rx="3"/>'
		. '<rect class="pk-on" x="104" y="122" width="36" height="28" rx="8"/>'
		. '<rect class="pk-bar-on" x="115" y="133" width="14" height="6" rx="3"/>'
		. '<rect class="pk-cell" x="146" y="122" width="36" height="28" rx="8"/>'
		. '<rect class="pk-bar" x="157" y="133" width="14" height="6" rx="3"/>'
		. '<rect class="pk-cell" x="188" y="122" width="44" height="28" rx="8"/>'
		. '<rect class="pk-bar" x="199" y="133" width="22" height="6" rx="3"/>'
		. '</svg>';
}

/**
 * The markup an option's note may carry.
 *
 * A note that runs to a few sentences reads as a wall without bold, a
 * break or a short list, so a shop gets those, and a link for "see the size
 * guide". Nothing that can run, embed or restyle the page.
 *
 * @return array<string,array<string,bool>>
 */
function addon_boss_note_allowed_html(): array {
	return array(
		'b'      => array(),
		'strong' => array(),
		'i'      => array(),
		'em'     => array(),
		'br'     => array(),
		'p'      => array(),
		'ul'     => array(),
		'ol'     => array(),
		'li'     => array(),
		'a'      => array(
			'href'   => true,
			'title'  => true,
			'target' => true,
			'rel'    => true,
		),
	);
}

/**
 * An option's note, cleaned to the markup above.
 *
 * Run on save and again on every display, because a note can also arrive
 * by import or from before notes took markup, and a page must never print
 * what the save would have refused.
 */
function addon_boss_note_html( $note ): string {
	return trim( wp_kses( (string) $note, addon_boss_note_allowed_html() ) );
}

/**
 * An option's note as it reads straight after the option's own name.
 *
 * Three places print a choice's name in bold with its note beside it: the
 * quantity panel above a design's cells, the grid's whole-order choices and
 * the named lines of a several-of set. A shop whose notes open with that
 * same name, as a design catalogue's often do, saw the name twice, one copy
 * stacked on the other. So a first line that says the name and nothing else
 * is left out here, with any blank paragraph it leaves at the top. A note
 * that only starts with the name, or never says it, prints as written, and
 * so does a first line holding a link, which would take the link with it.
 * Where a note prints on its own, nothing names it, and it keeps every word.
 *
 * @param string $name The choice's name, as printed beside the note.
 * @param mixed  $note The choice's stored note.
 */
function addon_boss_note_after_name( $name, $note ): string {
	$html = addon_boss_note_html( $note );
	$want = addon_boss_note_words( (string) $name );
	if ( '' === $html || '' === $want ) {
		return $html;
	}
	$only_name = static function ( string $line ) use ( $want ): bool {
		return false === stripos( $line, '<a' ) && addon_boss_note_words( $line ) === $want;
	};
	// Leading blanks: spaces, breaks and paragraphs holding nothing else.
	$drop_blanks = static function ( string $html ): string {
		$out = preg_replace( '#^(?:\s|&nbsp;|\x{00A0}|<br\s*/?>|<p>(?:\s|&nbsp;|\x{00A0}|<br\s*/?>)*</p>)+#iu', '', $html );
		return null === $out ? $html : $out;
	};
	if ( preg_match( '#^<p>(.*?)</p>#is', $html, $para ) ) {
		// The note opens with a paragraph: its first line runs to a break
		// inside that paragraph, or to its end.
		$lines = preg_split( '#<br\s*/?>#i', $para[1], 2 );
		if ( ! $only_name( (string) $lines[0] ) ) {
			return $html;
		}
		$rest = substr( $html, strlen( $para[0] ) );
		$more = isset( $lines[1] ) ? $drop_blanks( (string) $lines[1] ) : '';
		if ( '' !== trim( $more ) ) {
			$rest = '<p>' . $more . '</p>' . $rest;
		}
	} else {
		// The note opens with plain words: its first line runs to the first
		// break, paragraph or list.
		$line = $html;
		$rest = '';
		if ( preg_match( '#<br\s*/?>|<(?:p|ul|ol)\b#i', $html, $stop, PREG_OFFSET_CAPTURE ) ) {
			$line = substr( $html, 0, (int) $stop[0][1] );
			$rest = substr( $html, (int) $stop[0][1] );
		}
		if ( ! $only_name( $line ) ) {
			return $html;
		}
	}
	return trim( $drop_blanks( $rest ) );
}

/**
 * What a stretch of note markup says, for comparing one with another: tags
 * gone, entities read, and every run of space (a no-break space too) one.
 */
function addon_boss_note_words( string $html ): string {
	$text = html_entity_decode( wp_strip_all_tags( $html ), ENT_QUOTES | ENT_HTML5, 'UTF-8' );
	$text = preg_replace( '/[\s\x{00A0}]+/u', ' ', $text );
	return trim( (string) $text );
}

/**
 * Sanitise a set definition. Options with an empty label are dropped;
 * existing valid keys are PRESERVED (stability is the contract), missing or
 * invalid keys are generated; swatches must be real hex colours; deltas are
 * floats and may be negative. Order is the submitted order.
 */
function addon_boss_sanitize_option_set( array $raw ): array {
	$options = array();
	foreach ( (array) ( $raw['options'] ?? array() ) as $opt ) {
		if ( ! is_array( $opt ) ) {
			continue;
		}
		$label = sanitize_text_field( (string) ( $opt['label'] ?? '' ) );
		if ( '' === $label ) {
			continue;
		}
		$swatch = sanitize_hex_color( (string) ( $opt['swatch'] ?? '' ) );
		// A colour the merchant took away stays away. The name guess below
		// fills an empty swatch, so "empty" alone cannot say "no colour":
		// the editor's clear control posts 'none' and the row keeps a mark.
		$bb_no_swatch = ! $swatch && ( 'none' === (string) ( $opt['swatch'] ?? '' ) || ! empty( $opt['no_swatch'] ) );
		// An optional second colour for two-tone options (a "Navy/Red" jacket):
		// when set, the swatch renders as a split of the two.
		$swatch2 = sanitize_hex_color( (string) ( $opt['swatch2'] ?? '' ) );
		$row = array(
			'key'      => addon_boss_option_key_valid( $opt['key'] ?? '' ) ? (string) $opt['key'] : addon_boss_option_key(),
			'label'    => $label,
			'swatch'   => $swatch ? $swatch : '',
			'swatch2'  => $swatch2 ? $swatch2 : '',
			// An optional note shown when the shopper picks this option
			// (e.g. "Print protection" -> "adds a clear laminate..."). It may
			// carry simple markup: bold, a break, a list, a link.
			'desc'     => addon_boss_note_html( $opt['desc'] ?? '' ),
			'image_id' => absint( $opt['image_id'] ?? 0 ),
			// Read as the editor reads it: "2,50" is 2.50 in any shop, never 250.
			'delta'    => (float) addon_boss_typed_amount( $opt['delta'] ?? '0' ),
			'dims'     => array_map(
				static function ( $v ) {
					return (float) wc_format_decimal( (string) $v );
				},
				array_slice( array_values( (array) ( $opt['dims'] ?? array() ) ), 0, 3 )
			),
		);
		// Per-option stock: an integer count this option is limited to. Present,
		// even 0 (sold out), means tracked; absent means unlimited (the default,
		// so every existing set is untouched). The actual number lives on a hidden
		// WooCommerce backing product provisioned on save, so Woo owns the count.
		if ( isset( $opt['stock'] ) && '' !== $opt['stock'] && is_numeric( $opt['stock'] ) ) {
			$row['stock'] = max( 0, (int) $opt['stock'] );
		}
		if ( $bb_no_swatch ) {
			$row['swatch2']   = '';
			$row['no_swatch'] = 1;
		}
		$options[] = $row;
	}

	// Type "Navy" and the swatch fills itself from the shared name map, but
	// only when the WHOLE row resolves: every option carrying its own colour
	// or a recognised name. A lone hit in a row of strangers (Lavender among
	// scents) painted one tile in a row of pills, so a row that cannot be
	// uniform in dots stores no guesses at all and stays uniform in pills.
	// Colours the merchant typed themselves are already in place above.
	if ( function_exists( 'addon_boss_swatch_row_uniform' ) && addon_boss_swatch_row_uniform( $options ) ) {
		foreach ( $options as &$bb_row_opt ) {
			if ( '' === $bb_row_opt['swatch'] && empty( $bb_row_opt['no_swatch'] ) ) {
				$bb_row_opt['swatch'] = (string) sanitize_hex_color( addon_boss_swatch_from_name( $bb_row_opt['label'] ) );
			}
		}
		unset( $bb_row_opt );
	}

	// The set's kind. The engine's own is 'choices'; a richer kind sanitises
	// through the callback its module registered. A stored kind nothing
	// registers is carried through INERT, payload and all: the merchant's data
	// is not this build's to rewrite, and nothing here ever reads it. The
	// payload arrives leaf-sanitised at the request boundary, exactly like
	// every other admin-shaped array this function receives.
	$kinds = addon_boss_option_set_kinds();
	$kind  = sanitize_key( (string) ( $raw['kind'] ?? 'choices' ) );
	if ( '' === $kind ) {
		$kind = 'choices';
	}
	$out = array(
		'name'    => sanitize_text_field( (string) ( $raw['name'] ?? '' ) ),
		// What the PRODUCT PAGE calls this set, when that should differ from
		// the library name. A feed files sets under searchable names ("GD56 -
		// ... Colour", the style code leading so a decorator can find them at
		// two hundred products), and that name worn as the shopper's group
		// heading read as a part number. Empty means the name serves both,
		// which is every hand-made set today.
		'label'   => sanitize_text_field( (string) ( $raw['label'] ?? '' ) ),
		'kind'    => $kind,
		'measure' => array(),
		'table'   => array(),
		'options' => $options,
		// The group (folder) a set is filed under on the list page. Empty means
		// Ungrouped. Managed by drag on the list, never in the set editor.
		'group'   => sanitize_text_field( (string) ( $raw['group'] ?? '' ) ),
		// Where the set came from: a supplier integration writes its own name
		// here when it creates the set. Empty means the merchant built it, and
		// empty is deliberately never given a word of its own on the page:
		// absence is the marking, and only the supplier's rows wear a badge.
		'source'  => sanitize_text_field( (string) ( $raw['source'] ?? '' ) ),
		// Whether a picked choice's photo also becomes the product's main
		// image. Absent means yes, so every set that existed before this
		// switch keeps doing exactly what it did.
		'photo_swaps' => ! isset( $raw['photo_swaps'] ) || ! empty( $raw['photo_swaps'] ),
		// On a several-of set: whether the latest pick's photo becomes the
		// product's main image. Absent means no, so a several-of set saved
		// before this switch keeps its photo exactly as it was.
		'photo_latest' => ! empty( $raw['photo_latest'] ),
		// The swatch shape (display only): square, circle or the photo card.
		// Empty means the merchant never chose, which is a REAL state: it
		// renders square, except that a set whose options carry photos
		// prefers the card by itself. Nothing is migrated to a word here,
		// or that preference would die on the first unrelated save.
		'shape'   => in_array( (string) ( $raw['shape'] ?? '' ), array( 'square', 'circle', 'card' ), true ) ? (string) $raw['shape'] : '',
		// D6, display only: past the threshold a long set renders as the
		// list control; this pin keeps the chips regardless, per set.
		'pin_chips' => ! empty( $raw['pin_chips'] ),
		// Whether the storefront shows this set's stock (Sold out / Only N left).
		// Absent means yes - the useful default and downgrade-safe. The guard that
		// prevents overselling is independent of this and always on; turning this
		// off just hides the numbers (and quietly drops a sold-out option).
		'show_stock' => ! isset( $raw['show_stock'] ) || ! empty( $raw['show_stock'] ),
		// Several-of: the shopper may pick MORE THAN ONE choice from this set
		// ("choose up to 3 toppings"), each pick charged its own fee. The
		// bounds are optional; zero means unbounded on that side. A build that
		// never heard of the keys simply reads the set as pick-one, which is
		// the downgrade-safe shape on purpose.
		'multi'     => ! empty( $raw['multi'] ),
		'min'       => 0,
		'max'       => 0,
	);
	if ( $out['multi'] ) {
		$bb_min = min( 100, absint( $raw['min'] ?? 0 ) );
		$bb_max = min( 100, absint( $raw['max'] ?? 0 ) );
		// Bounds that cannot both be met are made lawful, never guessed past:
		// an at-least above the up-to clamps down to it.
		if ( $bb_max > 0 && $bb_min > $bb_max ) {
			$bb_min = $bb_max;
		}
		$out['min'] = $bb_min;
		$out['max'] = $bb_max;
	}
	if ( 'choices' !== $kind ) {
		if ( is_callable( $kinds[ $kind ]['sanitize'] ?? null ) ) {
			$out = array_merge( $out, (array) call_user_func( $kinds[ $kind ]['sanitize'], $raw ) );
		} else {
			$out['measure'] = is_array( $raw['measure'] ?? null ) ? $raw['measure'] : array();
			$out['table']   = is_array( $raw['table'] ?? null ) ? $raw['table'] : array();
		}
	}
	// Modules may carry their own per-set keys through the same sanitise pass,
	// so a set never stores a key nothing cleaned.
	return (array) apply_filters( 'addon_boss_sanitize_option_set', $out, $raw );
}

// =================================================================
// Option-set resolution + snapshot + config sanitisers. Lifted UNCHANGED from
// the earlier bundle-side layout; the option-set library, the cart-snapshot
// contract, the product-options config sanitisers and the active-set resolver.
// =================================================================

/**
 * The per-set keys this build knows how to write, and so may remove. The
 * engine's own, plus whatever its modules declare. A stored key outside the
 * list is carried through every save untouched.
 *
 * @return string[]
 */
function addon_boss_option_set_owned_keys(): array {
	$keys = array( 'name', 'label', 'kind', 'measure', 'table', 'options', 'group', 'source', 'photo_swaps', 'photo_latest', 'shape', 'pin_chips', 'show_stock', 'multi', 'min', 'max' );
	return array_values( array_unique( array_map( 'strval', (array) apply_filters( 'addon_boss_option_set_owned_keys', $keys ) ) ) );
}

/**
 * A set exactly as saving it would store it, without storing it. Fields the
 * caller never mentions ride through from the stored copy, the result is
 * sanitised, and a stored key no module on this build owns is kept. The save
 * and the editor's preview both read through here, so "Your changes" never
 * draws a set the save would not store. The preview used to sanitise the
 * form alone, skipping the carry, and headed a supplier's set with its
 * library name ("RX101 - Pro RTX Polo Shirt Colour") where the page and
 * the saved set say "Colour".
 *
 * @param array  $set  The set as the caller sends it.
 * @param string $id   The set's id; a new set has no stored copy.
 * @param array  $sets The whole store.
 * @return array The set as the store would hold it.
 */
function addon_boss_option_set_as_saved( array $set, string $id, array $sets ): array {
	// The set editor has no group control (grouping lives on the list page), so
	// carry the existing group through an edit rather than clearing it.
	if ( ! isset( $set['group'] ) && isset( $sets[ $id ]['group'] ) ) {
		$set['group'] = $sets[ $id ]['group'];
	}
	// Where the set came from (a supplier feed writes its name here; a set the
	// merchant builds carries none). Carried through edits the same way, so a
	// rename or a reprice never launders a supplier's set into an unmarked one.
	if ( ! isset( $set['source'] ) && isset( $sets[ $id ]['source'] ) ) {
		$set['source'] = $sets[ $id ]['source'];
	} elseif ( isset( $set['source'] ) ) {
		$set['source'] = sanitize_text_field( (string) $set['source'] );
		if ( '' === $set['source'] ) {
			unset( $set['source'] );
		}
	}
	// The words shoppers read when they differ from the library name (a
	// supplier feed writes "Colour" over "RX101 - Pro RTX Polo Shirt
	// Colour"). The set editor has no field for them, so an edit carries
	// them through like the group and the source. Until 2.6.x one Save
	// wiped them and the product page, the cart and the order fell back to
	// the library name (AOB #123). A caller that sends a label, empty
	// included, still decides.
	if ( ! isset( $set['label'] ) && isset( $sets[ $id ]['label'] ) ) {
		$set['label'] = $sets[ $id ]['label'];
	}
	// The same for a caller that never mentions the swatch shape (imports,
	// bulk paths): an explicit shape survives; it is never wiped by omission.
	if ( ! isset( $set['shape'] ) && isset( $sets[ $id ]['shape'] ) ) {
		$set['shape'] = $sets[ $id ]['shape'];
	}
	// And the chip pin: a save that never mentions the toggle must not undo
	// a merchant's explicit "keep the buttons".
	if ( ! isset( $set['pin_chips'] ) && ! empty( $sets[ $id ]['pin_chips'] ) ) {
		$set['pin_chips'] = true;
	}
	// The same for the several-of photo switch.
	if ( ! isset( $set['photo_latest'] ) && ! empty( $sets[ $id ]['photo_latest'] ) ) {
		$set['photo_latest'] = true;
	}
	// Per-option stock rides through untouched whenever this save cannot speak
	// for it: a build without the plan prints no stock boxes and no display
	// toggle, so its form posts neither. Without this, one Save on a free build
	// would wipe every number the merchant set while on the plan. Stored values
	// are restored by option KEY, so reordering or renaming options is safe.
	if ( ! addon_boss_option_stock_enabled() && isset( $sets[ $id ] ) ) {
		if ( ! isset( $set['show_stock'] ) && isset( $sets[ $id ]['show_stock'] ) ) {
			$set['show_stock'] = $sets[ $id ]['show_stock'];
		}
		$bb_stored_stock = array();
		foreach ( (array) ( $sets[ $id ]['options'] ?? array() ) as $bb_old ) {
			if ( isset( $bb_old['key'], $bb_old['stock'] ) ) {
				$bb_stored_stock[ (string) $bb_old['key'] ] = (int) $bb_old['stock'];
			}
		}
		if ( $bb_stored_stock && ! empty( $set['options'] ) ) {
			foreach ( $set['options'] as &$bb_new ) {
				$bb_k = (string) ( $bb_new['key'] ?? '' );
				if ( '' !== $bb_k && ! isset( $bb_new['stock'] ) && isset( $bb_stored_stock[ $bb_k ] ) ) {
					$bb_new['stock'] = $bb_stored_stock[ $bb_k ];
				}
			}
			unset( $bb_new );
		}
	}
	// The several-of setting and its bounds ride through a save that never
	// mentions them (imports, bulk paths), exactly like the shape and the pin.
	if ( ! isset( $set['multi'] ) && ! empty( $sets[ $id ]['multi'] ) ) {
		$set['multi'] = true;
		foreach ( array( 'min', 'max' ) as $bb_bound ) {
			if ( ! isset( $set[ $bb_bound ] ) && isset( $sets[ $id ][ $bb_bound ] ) ) {
				$set[ $bb_bound ] = $sets[ $id ][ $bb_bound ];
			}
		}
	}
	// A kind this build has no module for cannot repost its own payload (no
	// panel printed a form for it), so the stored payload rides into the save.
	// Losing a merchant's dimensions or price grid to a Save press would be
	// unforgivable; the data waits, whole, for the module that reads it.
	$bb_kind = sanitize_key( (string) ( $set['kind'] ?? 'choices' ) );
	if ( 'choices' !== $bb_kind && '' !== $bb_kind && ! isset( addon_boss_option_set_kinds()[ $bb_kind ] ) && isset( $sets[ $id ] ) ) {
		foreach ( array( 'measure', 'table' ) as $bb_carry ) {
			if ( empty( $set[ $bb_carry ] ) && ! empty( $sets[ $id ][ $bb_carry ] ) ) {
				$set[ $bb_carry ] = $sets[ $id ][ $bb_carry ];
			}
		}
	}
	$bb_clean = addon_boss_sanitize_option_set( $set );
	// A stored key no module on this build owns rides through untouched: a
	// newer version's data, or a module this build does not carry, is not
	// this save's to delete. A key a module does own stays that module's to
	// remove (clearing every can't-go-together rule removes them).
	if ( isset( $sets[ $id ] ) && is_array( $sets[ $id ] ) ) {
		$bb_owned = addon_boss_option_set_owned_keys();
		foreach ( $sets[ $id ] as $bb_key => $bb_value ) {
			if ( ! array_key_exists( $bb_key, $bb_clean ) && ! in_array( (string) $bb_key, $bb_owned, true ) ) {
				$bb_clean[ $bb_key ] = $bb_value;
			}
		}
	}
	return $bb_clean;
}

/**
 * Save a set (new when $id is empty). Returns the set id. The store is
 * written with autoload OFF: option sets are looked up on demand, never
 * dragged into every request.
 */
function addon_boss_save_option_set( array $set, string $id = '' ): string {
	$id   = addon_boss_option_key_valid( $id ) ? $id : addon_boss_option_key( 'set' );
	$sets = addon_boss_option_sets_change(
		static function ( array $sets ) use ( $set, $id ): array {
			$sets[ $id ] = addon_boss_option_set_as_saved( $set, $id, $sets );
			return $sets;
		}
	);
	// Sync the hidden backing product behind each stock-limited option, so Woo
	// owns the count from the moment the merchant sets one.
	addon_boss_provision_option_stock( $id, $sets[ $id ] );
	return $id;
}

/**
 * The sets a file holds, in the order they can be saved. A measured part
 * priced by another list (glass by its thickness) keeps that list only when
 * the list is already in the library, so a file listing the glass first
 * landed it priced at one flat rate for every thickness. A set that follows
 * another set in the same file now lands after the rest; everything else
 * keeps its place, keys and all. The list a part follows is a list of
 * choices, never itself a follower, so one pass is enough.
 *
 * @param array $sets Id => set, as the file holds them.
 * @return array The same sets, keys kept.
 */
function addon_boss_option_sets_landing_order( array $sets ): array {
	$first = array();
	$after = array();
	foreach ( $sets as $id => $set ) {
		$follows = false;
		foreach ( is_array( $set ) ? (array) ( $set['measure']['parts'] ?? array() ) : array() as $part ) {
			// The list a part is priced by, and the list its sides follow.
			foreach ( is_array( $part ) ? array( $part['from']['set'] ?? '', $part['sides']['set'] ?? '' ) : array() as $from ) {
				if ( is_scalar( $from ) && '' !== (string) $from && (string) $from !== (string) $id && array_key_exists( (string) $from, $sets ) ) {
					$follows = true;
				}
			}
		}
		if ( $follows ) {
			$after[ $id ] = $set;
		} else {
			$first[ $id ] = $set;
		}
	}
	return $first + $after;
}

/** Delete a set. Product attachments referencing it resolve to nothing. */
function addon_boss_delete_option_set( string $id ): bool {
	$gone = addon_boss_option_sets_change(
		static function ( array $sets ) use ( $id ) {
			if ( ! isset( $sets[ $id ] ) ) {
				return null;
			}
			unset( $sets[ $id ] );
			return $sets;
		}
	);
	if ( ! is_array( $gone ) ) {
		return false;
	}
	// A deleted set leaves no counters behind (the old build left its hidden
	// backing products orphaned here, which nothing ever cleaned).
	if ( function_exists( 'addon_boss_option_stock_prune' ) ) {
		addon_boss_option_stock_prune( $id, array() );
	}
	return true;
}

// -----------------------------------------------------------------
// Per-option stock. A stock-limited option's count lives in ONE ROW of
// our own small table, never in a product. The engine enforces the
// merchant's "stock N on this choice" contract at add-to-cart and at
// checkout (counting the cart), draws the count down on the sale, and
// gives it back on a cancel or a restocking refund.
//
// The count deliberately does NOT live on a WooCommerce product. An
// earlier build minted a hidden product per stocked option "so Woo owns
// the counting", and the audit of what shipped showed Woo never did:
// the backing product was never a line item on any order, so Woo's own
// stock pass, its low-stock mails, its checkout holds and its reports
// never touched it, while the catalogue gained mystery entries the
// founding customer reported as a bug on day one. The one primitive it
// provided was a relative SQL update, which is exactly what the table
// does, minus the product wrapped around it. Every plugin in the
// category that links options to products links products the merchant
// ALREADY SELLS; none of them mint products, and neither do we.
// -----------------------------------------------------------------

// Where the old build kept its counters: an option-name to post-id map, and a
// stamp on each hidden product. Read ONLY by the one-time migration below.
const ADDON_BOSS_OPTION_STOCK_MAP          = 'addon_boss_option_stock_products';
const ADDON_BOSS_OPTION_STOCK_BACKING_META = '_addon_boss_option_stock_backing';

/**
 * Is per-option stock offered by this build? A Pro capability: without it the
 * engine neither tracks nor shows option stock, and every stored number is left
 * exactly as the merchant set it, ready for the plan returning.
 */
function addon_boss_option_stock_enabled(): bool {
	return addon_boss_engine_can( 'option-stock' );
}

/** The counters' table name. */
function addon_boss_option_stock_table(): string {
	global $wpdb;
	return $wpdb->prefix . 'addon_boss_option_stock';
}

/**
 * Create the counters' table. Self-healing on first write rather than an
 * activation hook, so a copied database, a multisite subsite or a build that
 * skipped activation all work the same; the flag keeps the DDL to once.
 */
function addon_boss_option_stock_install(): void {
	global $wpdb;
	if ( '1' === get_option( 'addon_boss_option_stock_db' ) ) {
		return;
	}
	$table = addon_boss_option_stock_table();
	// phpcs:ignore WordPress.DB.DirectDatabaseQuery.DirectQuery, WordPress.DB.DirectDatabaseQuery.NoCaching, WordPress.DB.PreparedSQL.InterpolatedNotPrepared -- our own table; identifiers cannot be placeholdered.
	$wpdb->query(
		"CREATE TABLE IF NOT EXISTS {$table} (
			set_id     VARCHAR(64) NOT NULL,
			option_key VARCHAR(64) NOT NULL,
			qty        INT NOT NULL DEFAULT 0,
			PRIMARY KEY (set_id, option_key)
		) {$wpdb->get_charset_collate()}"
	);
	update_option( 'addon_boss_option_stock_db', '1', false );
}

/**
 * How many of one option are left, or null when the option tracks no stock
 * (which includes every option on a build without the capability: stored
 * numbers wait untouched, nothing is tracked, nothing is blocked).
 *
 * Floored at zero: a racing pair of orders can take the stored count below
 * zero exactly as WooCommerce's own products allow, and nothing downstream
 * needs the negative, only "none left".
 */
function addon_boss_option_stock_left( string $set_id, string $key ): ?int {
	if ( ! addon_boss_option_stock_enabled() || '1' !== get_option( 'addon_boss_option_stock_db' ) ) {
		return null;
	}
	$rows = addon_boss_option_stock_rows( $set_id );
	return isset( $rows[ $key ] ) ? max( 0, $rows[ $key ] ) : null;
}

/**
 * Every count one set holds, read in one query and remembered for the request.
 *
 * A bundle of garments asks for each choice's count while drawing the chips,
 * again for the stock line, again for the basket check: thousands of single-row
 * reads on one page, which a shared host turns into tens of seconds. The memo
 * lives in the non-persistent group, so it never outlives the request, and
 * every write, sale and prune forgets it, so a count is never older than the
 * request reading it.
 *
 * @return array<string,int> option key => stored count (not floored).
 */
function addon_boss_option_stock_rows( string $set_id ): array {
	$found = false;
	$rows  = wp_cache_get( 'stock:' . $set_id, ADDON_BOSS_OPTION_SETS_MEMO, false, $found );
	if ( $found && is_array( $rows ) ) {
		return $rows;
	}
	global $wpdb;
	$table = addon_boss_option_stock_table();
	// phpcs:ignore WordPress.DB.DirectDatabaseQuery.DirectQuery, WordPress.DB.DirectDatabaseQuery.NoCaching, WordPress.DB.PreparedSQL.InterpolatedNotPrepared -- one read of our own table per set per request; never a persistent cache, see above.
	$got  = $wpdb->get_results( $wpdb->prepare( "SELECT option_key, qty FROM {$table} WHERE set_id = %s", $set_id ), ARRAY_A );
	$rows = array();
	foreach ( (array) $got as $row ) {
		$rows[ (string) $row['option_key'] ] = (int) $row['qty'];
	}
	wp_cache_set( 'stock:' . $set_id, $rows, ADDON_BOSS_OPTION_SETS_MEMO );
	return $rows;
}

/** Forget one set's remembered counts, so the next read comes from the table. */
function addon_boss_option_stock_forget( string $set_id ): void {
	wp_cache_delete( 'stock:' . $set_id, ADDON_BOSS_OPTION_SETS_MEMO );
	// Every write, sale and prune passes through here, so this is the one
	// place a listener can learn that a set's counts (or, for a "bbpair:<id>"
	// bucket, one product's pair counts) have moved.
	do_action( 'addon_boss_option_stock_changed', $set_id );
}

/** Set one option's live count (the merchant's typed number, and the migration). */
function addon_boss_option_stock_write( string $set_id, string $key, int $qty ): void {
	addon_boss_option_stock_install();
	global $wpdb;
	$table = addon_boss_option_stock_table();
	// phpcs:ignore WordPress.DB.DirectDatabaseQuery.DirectQuery, WordPress.DB.DirectDatabaseQuery.NoCaching, WordPress.DB.PreparedSQL.InterpolatedNotPrepared -- upsert into our own table.
	$wpdb->query( $wpdb->prepare( "INSERT INTO {$table} (set_id, option_key, qty) VALUES (%s, %s, %d) ON DUPLICATE KEY UPDATE qty = %d", $set_id, $key, $qty, $qty ) );
	addon_boss_option_stock_forget( $set_id );
}

/**
 * Move one option's live count by a signed amount, in a single relative
 * UPDATE so two orders landing together each take their own units (the same
 * arithmetic wc_update_product_stock does for a product). A row that does not
 * exist moves nothing: an option whose number was cleared takes no decrements
 * and no give-backs, which is what "not tracked" means.
 */
function addon_boss_option_stock_adjust( string $set_id, string $key, int $delta ): void {
	if ( 0 === $delta || '1' !== get_option( 'addon_boss_option_stock_db' ) ) {
		return;
	}
	global $wpdb;
	$table = addon_boss_option_stock_table();
	// phpcs:ignore WordPress.DB.DirectDatabaseQuery.DirectQuery, WordPress.DB.DirectDatabaseQuery.NoCaching, WordPress.DB.PreparedSQL.InterpolatedNotPrepared -- one relative update of our own table; relative on purpose, see above.
	$wpdb->query( $wpdb->prepare( "UPDATE {$table} SET qty = qty + %d WHERE set_id = %s AND option_key = %s", $delta, $set_id, $key ) );
	addon_boss_option_stock_forget( $set_id );
}

/*
 * =================================================================
 * COMBINATION counters: a colour AND a size together.
 *
 * Per-option counters answer "how many Navy" and "how many XXL", and for a
 * shop holding one pile per choice that is the whole truth. A garment
 * supplier holds a pile per PAIR: forty Black Small, none in Navy Small.
 * Per-option counters cannot say that, and the gap is not cosmetic - a
 * shopper can buy five Navy Small while Navy (fifty, mostly Large) and
 * Small (forty, mostly Black) both look healthy, and the order goes to a
 * supplier who has none.
 *
 * So a product may declare that its counts are kept per combination. The
 * rows live in the SAME table as the option counters, in a bucket of the
 * product's own, which is what makes every seam that already works keep
 * working: the cart's demand walk, the sale-time decrement, the give-back
 * on a refund, the checkout re-read. Only the key is new.
 *
 * Declaring is per product and explicit, because it says WHICH sets the
 * pairs are made of: a tee with Colour, Size and Printing is tracked on
 * colour x size, and the printing choice is not part of the pile.
 *
 * Nothing declares it by hand. A supplier feed does (SupplierBoss writes the
 * pairs it already holds per item code), and a product that declares
 * nothing behaves exactly as it did before: per-option counters, or
 * nothing at all.
 * =================================================================
 */

/** The sets a product's counts are kept in pairs of, or none. */
const ADDON_BOSS_COMBO_SETS_META = '_addon_boss_combo_sets';

/**
 * Which sets this product tracks combinations across, in a fixed order.
 *
 * @return string[]
 */
function addon_boss_combo_sets( $product ): array {
	if ( ! $product instanceof WC_Product ) {
		$product = function_exists( 'wc_get_product' ) ? wc_get_product( (int) $product ) : null;
	}
	if ( ! $product instanceof WC_Product ) {
		return array();
	}
	$sets = $product->get_meta( ADDON_BOSS_COMBO_SETS_META );
	if ( ! is_array( $sets ) ) {
		return array();
	}
	$out = array();
	foreach ( $sets as $sid ) {
		$sid = (string) $sid;
		if ( '' !== $sid ) {
			$out[] = $sid;
		}
	}
	sort( $out ); // one order, whoever wrote it, so a key never depends on the writer.
	return $out;
}

/** One product's bucket in the counter table. */
function addon_boss_combo_bucket( int $product_id ): string {
	return 'bbpair:' . $product_id;
}

/**
 * The key one combination is counted under.
 *
 * Hashed rather than joined, because two option keys can be 38 characters
 * each and the column holds 64. The pairs a key stands for are always
 * recoverable from the picks themselves, so nothing is lost by hashing.
 *
 * @param array<string,string> $picks set id => option key.
 * @param string[]             $sets  The sets to key on, in their fixed order.
 */
function addon_boss_combo_key( array $picks, array $sets ): string {
	$parts = array();
	foreach ( $sets as $sid ) {
		if ( ! isset( $picks[ $sid ] ) || '' === (string) $picks[ $sid ] ) {
			return ''; // an incomplete pair is not a pair.
		}
		$parts[] = $sid . '::' . $picks[ $sid ];
	}
	return $parts ? substr( sha1( implode( '|', $parts ) ), 0, 40 ) : '';
}

/**
 * The combination a line's option snapshots land on, as a counter row.
 *
 * Returns null when this product tracks no pairs, or when the snapshots do
 * not name every set a pair is made of. The label is the shopper's own
 * words for it ("Deep Black / XXL"), because a refusal that says
 * "bbpair:263" would be useless to everybody.
 *
 * @param array<int,array> $snaps
 * @return array{set:string,key:string,label:string}|null
 */
function addon_boss_combo_row( $product, array $snaps ): ?array {
	$sets = addon_boss_combo_sets( $product );
	if ( ! $sets ) {
		return null;
	}
	$picks  = array();
	$labels = array();
	foreach ( $snaps as $snap ) {
		if ( ! is_array( $snap ) ) {
			continue;
		}
		$sid = (string) ( $snap['set'] ?? '' );
		if ( '' === $sid || ! in_array( $sid, $sets, true ) ) {
			continue;
		}
		$picks[ $sid ]  = (string) ( $snap['key'] ?? '' );
		$labels[ $sid ] = (string) ( $snap['label'] ?? $picks[ $sid ] );
	}
	$key = addon_boss_combo_key( $picks, $sets );
	if ( '' === $key ) {
		return null;
	}
	$words = array();
	foreach ( $sets as $sid ) {
		$words[] = $labels[ $sid ];
	}
	$pid = $product instanceof WC_Product ? $product->get_id() : (int) $product;
	return array(
		'set'   => addon_boss_combo_bucket( $pid ),
		'key'   => $key,
		'label' => implode( ' / ', array_filter( $words ) ),
	);
}

/**
 * Does this product's CHOOSING carry its own counts?
 *
 * True when the pairs are tracked, or when any set the product wears holds a
 * counter of its own. It is the question behind one piece of copy: whether
 * the product-wide "6,454 in stock" means anything to a shopper.
 *
 * On a product whose colours and sizes each carry a number, that figure is
 * every colour and size added together. It answers a question nobody asked,
 * it dwarfs anything anybody can actually buy, and it contradicts the very
 * counts beside it, where the size they want reads sold out. So a product
 * that counts per choice stops printing the total, and a product that
 * counts nothing per choice keeps it, because there the total IS the truth.
 */
function addon_boss_product_counts_per_choice( $product ): bool {
	if ( ! $product instanceof WC_Product ) {
		return false;
	}
	if ( addon_boss_combo_sets( $product ) ) {
		return true;
	}
	if ( ! function_exists( 'addon_boss_standalone_option_sets' ) || ! function_exists( 'addon_boss_option_stock_left' ) ) {
		return false;
	}
	foreach ( (array) addon_boss_standalone_option_sets( $product ) as $set ) {
		foreach ( (array) ( $set['options'] ?? array() ) as $opt ) {
			if ( null !== addon_boss_option_stock_left( (string) ( $set['id'] ?? '' ), (string) ( $opt['key'] ?? '' ) ) ) {
				return true;
			}
		}
	}
	return false;
}

/**
 * A product whose choices carry counts never shows the product-wide one.
 *
 * @param mixed $html    What WooCommerce was going to print.
 * @param mixed $product The product it was printing it for.
 * @return mixed
 */
function addon_boss_no_whole_count( $html, $product = null ) {
	if ( $product instanceof WC_Product
		&& ( addon_boss_product_counts_per_choice( $product )
			|| ( function_exists( 'addon_boss_product_uses_grid' ) && addon_boss_product_uses_grid( $product ) ) ) ) {
		return '';
	}
	return $html;
}
add_filter( 'woocommerce_get_stock_html', 'addon_boss_no_whole_count', 10, 2 );

/**
 * Every tracked pair of a product, keyed by the option keys a shopper picks.
 *
 * The stored key is a hash, which the counters do not need to reverse but a
 * SCREEN does: the chips have to know that Bottle Green plus S is the pile
 * with none in it, before the shopper presses anything. So the cartesian is
 * walked once here and matched against a single read of the bucket, rather
 * than asking the database once per pair.
 *
 * @return array<string,int> "c_bot|s_s" => qty, in the declared set order.
 */
function addon_boss_combo_stock_all( $product ): array {
	$sets = addon_boss_combo_sets( $product );
	if ( ! $sets || ! function_exists( 'addon_boss_option_set' ) ) {
		return array();
	}
	if ( ! $product instanceof WC_Product ) {
		$product = function_exists( 'wc_get_product' ) ? wc_get_product( (int) $product ) : null;
	}
	if ( ! $product instanceof WC_Product || '1' !== get_option( 'addon_boss_option_stock_db' ) ) {
		return array();
	}

	global $wpdb;
	$table = addon_boss_option_stock_table();
	// phpcs:ignore WordPress.DB.DirectDatabaseQuery.DirectQuery, WordPress.DB.DirectDatabaseQuery.NoCaching, WordPress.DB.PreparedSQL.InterpolatedNotPrepared -- one read of our own table; a live count must not be served from cache.
	$rows = $wpdb->get_results( $wpdb->prepare( "SELECT option_key, qty FROM {$table} WHERE set_id = %s", addon_boss_combo_bucket( $product->get_id() ) ), ARRAY_A );
	if ( ! $rows ) {
		return array();
	}
	$held = array();
	foreach ( $rows as $row ) {
		$held[ (string) $row['option_key'] ] = max( 0, (int) $row['qty'] );
	}

	// The cartesian of the declared sets, in their declared order.
	$combos = array( array() );
	foreach ( $sets as $sid ) {
		$set  = addon_boss_option_set( $sid );
		$next = array();
		foreach ( (array) ( $set['options'] ?? array() ) as $opt ) {
			$key = (string) ( $opt['key'] ?? '' );
			if ( '' === $key ) {
				continue;
			}
			foreach ( $combos as $combo ) {
				$next[] = $combo + array( $sid => $key );
			}
		}
		$combos = $next;
	}

	$out = array();
	foreach ( $combos as $combo ) {
		$hash = addon_boss_combo_key( $combo, $sets );
		if ( '' === $hash || ! array_key_exists( $hash, $held ) ) {
			continue; // this pair tracks nothing.
		}
		$parts = array();
		foreach ( $sets as $sid ) {
			$parts[] = $combo[ $sid ];
		}
		$out[ implode( '|', $parts ) ] = $held[ $hash ];
	}
	return $out;
}

/**
 * How many of one combination are left, or null when this pair is not tracked.
 *
 * A pair the table does not hold reads as NONE rather than as unlimited, and
 * the difference is a real one: the table is written whole every run, so a
 * missing pair is not an unknown, it is a combination the supplier does not
 * make. Half the range is like this - a shop's White tee stops at XXL while
 * its Black one runs to 6XL - and reading those as untracked let a shopper
 * order five White 6XL, which nobody anywhere has.
 *
 * A product whose table is empty is a different thing entirely: nothing is
 * tracked, and everything is offered exactly as it was before.
 */
function addon_boss_combo_stock_left( $product, array $snaps ): ?int {
	$row = addon_boss_combo_row( $product, $snaps );
	if ( null === $row ) {
		return null;
	}
	return addon_boss_counted_left( $row['set'], $row['key'] );
}

/**
 * How many of one COUNTED thing are left, option or pair.
 *
 * The one reader every guard uses, because the two kinds differ in exactly
 * one way and it matters at the till: a missing option row means the option
 * counts nothing, while a missing PAIR row on a product that holds a table
 * means that combination is not made. Reading them the same way is what let
 * five White 6XL through.
 */
function addon_boss_counted_left( string $set_id, string $key ): ?int {
	$left = addon_boss_option_stock_left( $set_id, $key );
	if ( null !== $left || 0 !== strpos( $set_id, 'bbpair:' ) ) {
		return $left;
	}
	return addon_boss_combo_stock_any( $set_id ) ? 0 : null;
}

/**
 * Does this product hold any pairs at all?
 *
 * Asked once per product per request, because it is the difference between
 * "this combination is not made" and "this shop counts nothing", and the
 * cartesian above would otherwise ask it per cell.
 */
function addon_boss_combo_stock_any( string $bucket ): bool {
	static $seen = array();
	if ( isset( $seen[ $bucket ] ) ) {
		return $seen[ $bucket ];
	}
	if ( '1' !== get_option( 'addon_boss_option_stock_db' ) ) {
		$seen[ $bucket ] = false;
		return false;
	}
	global $wpdb;
	$table = addon_boss_option_stock_table();
	// phpcs:ignore WordPress.DB.DirectDatabaseQuery.DirectQuery, WordPress.DB.DirectDatabaseQuery.NoCaching, WordPress.DB.PreparedSQL.InterpolatedNotPrepared -- one existence check of our own table.
	$seen[ $bucket ] = (bool) $wpdb->get_var( $wpdb->prepare( "SELECT 1 FROM {$table} WHERE set_id = %s LIMIT 1", $bucket ) );
	return $seen[ $bucket ];
}

/**
 * Write one product's whole pair table at once, and say which sets it is
 * keyed on. Whole-table on purpose: a feed knows every pair it holds, and
 * a pair that has left the range should stop being counted rather than
 * linger at its last figure.
 *
 * @param array<int,array{picks:array<string,string>,qty:int}> $pairs
 * @param string[]                                             $sets
 */
function addon_boss_combo_stock_put( $product, array $sets, array $pairs ): void {
	if ( ! $product instanceof WC_Product ) {
		$product = function_exists( 'wc_get_product' ) ? wc_get_product( (int) $product ) : null;
	}
	if ( ! $product instanceof WC_Product || ! function_exists( 'addon_boss_option_stock_write' ) ) {
		return;
	}
	$clean = array();
	foreach ( $sets as $sid ) {
		$sid = (string) $sid;
		if ( '' !== $sid ) {
			$clean[] = $sid;
		}
	}
	sort( $clean );

	$bucket = addon_boss_combo_bucket( $product->get_id() );
	if ( ! $clean || ! $pairs ) {
		// Tracking withdrawn: the declaration goes and so do the rows, so
		// nothing is left half-counted.
		$product->delete_meta_data( ADDON_BOSS_COMBO_SETS_META );
		$product->save();
		addon_boss_option_stock_prune( $bucket, array() );
		return;
	}

	$product->update_meta_data( ADDON_BOSS_COMBO_SETS_META, $clean );
	$product->save();

	$kept = array();
	foreach ( $pairs as $pair ) {
		$key = addon_boss_combo_key( (array) ( $pair['picks'] ?? array() ), $clean );
		if ( '' === $key ) {
			continue;
		}
		$kept[] = $key;
		addon_boss_option_stock_write( $bucket, $key, max( 0, (int) ( $pair['qty'] ?? 0 ) ) );
	}
	addon_boss_option_stock_prune( $bucket, $kept );
}

/**
 * Delete a set's counters, except the keys named. An empty keep-list clears
 * the whole set (a deleted set leaves no counters behind).
 *
 * @param string[] $keep Option keys that still carry a number.
 */
function addon_boss_option_stock_prune( string $set_id, array $keep ): void {
	if ( '1' !== get_option( 'addon_boss_option_stock_db' ) ) {
		return; // no table, nothing to prune.
	}
	global $wpdb;
	$table = addon_boss_option_stock_table();
	addon_boss_option_stock_forget( $set_id );
	if ( ! $keep ) {
		// phpcs:ignore WordPress.DB.DirectDatabaseQuery.DirectQuery, WordPress.DB.DirectDatabaseQuery.NoCaching, WordPress.DB.PreparedSQL.InterpolatedNotPrepared -- deleting our own rows.
		$wpdb->query( $wpdb->prepare( "DELETE FROM {$table} WHERE set_id = %s", $set_id ) );
		return;
	}
	$holes = implode( ', ', array_fill( 0, count( $keep ), '%s' ) );
	// phpcs:ignore WordPress.DB.DirectDatabaseQuery.DirectQuery, WordPress.DB.DirectDatabaseQuery.NoCaching, WordPress.DB.PreparedSQL.InterpolatedNotPrepared, WordPress.DB.PreparedSQLPlaceholders -- deleting our own rows; the placeholder list is built from count() alone.
	$wpdb->query( $wpdb->prepare( "DELETE FROM {$table} WHERE set_id = %s AND option_key NOT IN ( {$holes} )", array_merge( array( $set_id ), array_values( $keep ) ) ) );
}

/**
 * Keep the counters in step with the merchant's numbers, on every set save.
 *
 * The box in the editor IS the count: typing 10 makes it 10, and emptying the
 * box deletes the row, so an empty box means unlimited everywhere at once and
 * there is no counter left anywhere to go stale. On a build without the plan
 * nothing here runs and the stored numbers ride through the save whole.
 */
function addon_boss_provision_option_stock( string $set_id, array $set ): void {
	if ( ! addon_boss_option_stock_enabled() ) {
		return;
	}
	$tracked = array();
	foreach ( (array) ( $set['options'] ?? array() ) as $opt ) {
		$key = (string) ( $opt['key'] ?? '' );
		if ( '' === $key || ! isset( $opt['stock'] ) || ! is_numeric( $opt['stock'] ) ) {
			continue;
		}
		$tracked[] = $key;
		addon_boss_option_stock_write( $set_id, $key, max( 0, (int) $opt['stock'] ) );
	}
	addon_boss_option_stock_prune( $set_id, $tracked );
}

/**
 * Move every counter out of the old hidden backing products, then remove the
 * products themselves. Runs once (the flag), and belt-and-braces: after the
 * map walk it sweeps for any product still carrying the backing stamp, so a
 * store whose map lost an entry is cleaned too. Counts are only carried over
 * for counters WooCommerce was still managing; a stood-down one was already
 * "cleared" and gets no row.
 */
function addon_boss_migrate_option_stock_backing(): void {
	if ( get_option( 'addon_boss_option_stock_migrated' ) || ! function_exists( 'wc_get_product' ) ) {
		return;
	}
	$map = get_option( ADDON_BOSS_OPTION_STOCK_MAP, null );
	foreach ( is_array( $map ) ? $map : array() as $map_key => $bp_id ) {
		$parts = explode( '::', (string) $map_key, 2 );
		$bp    = wc_get_product( (int) $bp_id );
		if ( $bp instanceof WC_Product ) {
			if ( 2 === count( $parts ) && $bp->managing_stock() ) {
				addon_boss_option_stock_write( $parts[0], $parts[1], max( 0, (int) $bp->get_stock_quantity() ) );
			}
			$bp->delete( true );
		}
	}
	// Strays the map forgot: anything still stamped as a backing product goes.
	global $wpdb;
	// phpcs:ignore WordPress.DB.DirectDatabaseQuery.DirectQuery, WordPress.DB.DirectDatabaseQuery.NoCaching -- a one-time migration sweep.
	$stray_ids = $wpdb->get_col( $wpdb->prepare( "SELECT post_id FROM {$wpdb->postmeta} WHERE meta_key = %s", ADDON_BOSS_OPTION_STOCK_BACKING_META ) );
	foreach ( array_map( 'intval', (array) $stray_ids ) as $stray ) {
		$bp = wc_get_product( $stray );
		if ( $bp instanceof WC_Product ) {
			$bp->delete( true );
		}
	}
	delete_option( ADDON_BOSS_OPTION_STOCK_MAP );
	update_option( 'addon_boss_option_stock_migrated', '1', false );
}
add_action( 'admin_init', 'addon_boss_migrate_option_stock_backing', 5 );

/**
 * The cart line this request is replacing, when the options form posted its
 * "edit this line" marker AND that marker really names a line of this product
 * in this visitor's own cart. Anything else excludes nothing, so a stale or
 * crossed-up marker can never discount stock that stays in the cart. The test
 * is deliberately the same one addon_boss_edit_apply_replace makes before it
 * removes the old line, so we only ever discount a line that is about to go.
 */
function addon_boss_editing_cart_line( int $product_id ): string {
	if ( ! isset( $_REQUEST['bb_edit_line'] ) || ! function_exists( 'WC' ) || null === WC()->cart ) { // phpcs:ignore WordPress.Security.NonceVerification.Recommended -- presence check; the key still has to resolve to this visitor's own line below.
		return '';
	}
	$key = sanitize_text_field( wp_unslash( (string) $_REQUEST['bb_edit_line'] ) ); // phpcs:ignore WordPress.Security.NonceVerification.Recommended
	if ( '' === $key ) {
		return '';
	}
	$line = WC()->cart->get_cart_item( $key );
	if ( ! is_array( $line ) || (int) ( $line['product_id'] ?? 0 ) !== $product_id ) {
		return '';
	}
	return $key;
}

/**
 * The set an interop snapshot came from, back out of its axis name.
 *
 * A bundle's component picks ride the neutral house shape, which names the set
 * by the axis addon_boss_virtual_attr_name() minted rather than by id, and the
 * asking plugin slugifies that name because it becomes a form field. Rather
 * than assume the round trip survives slugification, the known sets are asked
 * which of them mints this axis.
 */
function addon_boss_set_id_from_axis( string $axis ): string {
	if ( '' === $axis ) {
		return '';
	}
	foreach ( array_keys( addon_boss_option_sets() ) as $id ) {
		$mine = addon_boss_virtual_attr_name( (string) $id );
		if ( $axis === $mine || $axis === sanitize_title( $mine ) ) {
			return (string) $id;
		}
	}
	return '';
}

/**
 * What a BundleBoss bundle's validated selections ask of stocked options.
 *
 * A bundle is one cart line holding several components, so demand is each
 * component's own quantity times the line's. Returns [ "set::key" => row ].
 *
 * @param mixed $selections The bundle payload's selections (cart or order line).
 * @param int   $line_qty   How many of that bundle.
 */
function addon_boss_bundle_option_demand( $selections, int $line_qty = 1 ): array {
	$out = array();
	foreach ( (array) $selections as $sel ) {
		$unit = max( 1, (int) ( $sel['qty'] ?? 1 ) );
		foreach ( (array) ( ( is_array( $sel ) ? ( $sel['options'] ?? null ) : null ) ?? array() ) as $snap ) {
			$set = addon_boss_set_id_from_axis( (string) ( $snap['axis'] ?? '' ) );
			$key = (string) ( $snap['key'] ?? '' );
			if ( '' === $set || '' === $key ) {
				continue;
			}
			$mk = $set . '::' . $key;
			if ( ! isset( $out[ $mk ] ) ) {
				$out[ $mk ] = array(
					'set'   => $set,
					'key'   => $key,
					'label' => (string) ( $snap['label'] ?? $key ),
					'qty'   => 0,
				);
			}
			$out[ $mk ]['qty'] += $unit * max( 1, $line_qty );
		}
	}
	return $out;
}

/**
 * Everything the whole cart currently asks of stocked options, keyed
 * "set::key". Counts BOTH a product bought on its own page and the same
 * product bought inside a bundle: one shelf, however the sale is dressed.
 */
function addon_boss_cart_option_demand( string $exclude_key = '' ): array {
	$out = array();
	if ( ! function_exists( 'WC' ) || null === WC()->cart ) {
		return $out;
	}
	$add = static function ( array &$out, string $set, string $key, string $label, int $qty ): void {
		if ( '' === $set || '' === $key || $qty < 1 ) {
			return;
		}
		$mk = $set . '::' . $key;
		if ( ! isset( $out[ $mk ] ) ) {
			$out[ $mk ] = array(
				'set'   => $set,
				'key'   => $key,
				'label' => $label,
				'qty'   => 0,
			);
		}
		$out[ $mk ]['qty'] += $qty;
	};

	foreach ( WC()->cart->get_cart() as $cart_key => $item ) {
		if ( '' !== $exclude_key && $cart_key === $exclude_key ) {
			continue;
		}
		$line_qty = max( 0, (int) ( $item['quantity'] ?? 0 ) );
		if ( $line_qty < 1 ) {
			continue;
		}
		$bb_snaps = (array) ( $item[ ADDON_BOSS_STANDALONE_OPTIONS_KEY ] ?? array() );
		foreach ( $bb_snaps as $snap ) {
			$add( $out, (string) ( $snap['set'] ?? '' ), (string) ( $snap['key'] ?? '' ), (string) ( $snap['label'] ?? '' ), $line_qty );
		}
		// The pair this line lands on, when the product counts in pairs. It
		// rides the same demand list as any option, so the cart re-read, the
		// sale-time decrement and the give-back all reach it unchanged.
		$bb_pair = addon_boss_combo_row( (int) ( $item['product_id'] ?? 0 ), $bb_snaps );
		if ( null !== $bb_pair ) {
			$add( $out, $bb_pair['set'], $bb_pair['key'], $bb_pair['label'], $line_qty );
		}
		foreach ( addon_boss_bundle_option_demand( $item['bundle_boss']['selections'] ?? array(), $line_qty ) as $row ) {
			$add( $out, $row['set'], $row['key'], $row['label'], (int) $row['qty'] );
		}
	}
	return $out;
}

/**
 * Is there room for this many of one counted thing, counting the cart?
 *
 * One voice for an option and for a pair, because the arithmetic and the
 * apology are identical and only the name differs.
 *
 * @param array{set:string,key:string,label:string} $row
 * @return WP_Error|null
 */
function addon_boss_stock_shortfall( array $row, int $add_qty, string $exclude_key = '' ) {
	$have = addon_boss_counted_left( $row['set'], $row['key'] );
	if ( null === $have ) {
		return null; // not tracked: unlimited.
	}
	$label = (string) ( $row['label'] ?? '' );
	if ( $have <= 0 ) {
		/* translators: %s: the choice, or the colour and size together */
		return new WP_Error( 'addon_boss', sprintf( __( 'Sorry, "%s" is out of stock.', 'addon-boss' ), $label ) );
	}
	$in = addon_boss_option_qty_in_cart( $row['set'], $row['key'], $exclude_key );
	if ( $in + $add_qty > $have ) {
		$left = max( 0, $have - $in );
		return new WP_Error(
			'addon_boss',
			sprintf(
				/* translators: 1: units still available, 2: the choice, or the colour and size together */
				_n( 'Sorry, only %1$d of "%2$s" is left.', 'Sorry, only %1$d of "%2$s" are left.', $left, 'addon-boss' ),
				$left,
				$label
			)
		);
	}
	return null;
}

/** How many of one option the cart already holds, on its own page or in a bundle. */
function addon_boss_option_qty_in_cart( string $set_id, string $key, string $exclude_key = '' ): int {
	$demand = addon_boss_cart_option_demand( $exclude_key );
	return (int) ( $demand[ $set_id . '::' . $key ]['qty'] ?? 0 );
}

/**
 * Refuse an add that would sell more of a stock-limited option than exist,
 * counting what the cart already holds. Returns true when every picked option
 * has room (or tracks no stock), or a WP_Error naming the short option.
 */
function addon_boss_check_option_stock( $product, $snaps, int $add_qty, string $exclude_key = '' ) {
	if ( ! is_array( $snaps ) || $add_qty < 1 ) {
		return true;
	}
	// The pair first, because it is the most specific thing anybody can be
	// short of: "Deep Black / XXL" is a truer refusal than "XXL", and a shop
	// that counts pairs has already said the per-option totals are not the
	// question.
	$bb_pair = addon_boss_combo_row( $product, $snaps );
	if ( null !== $bb_pair ) {
		$bb_err = addon_boss_stock_shortfall( $bb_pair, $add_qty, $exclude_key );
		if ( is_wp_error( $bb_err ) ) {
			return $bb_err;
		}
	}
	foreach ( $snaps as $snap ) {
		$set_id = (string) ( $snap['set'] ?? '' );
		$key    = (string) ( $snap['key'] ?? '' );
		if ( '' === $set_id || '' === $key ) {
			continue;
		}
		$have = addon_boss_option_stock_left( $set_id, $key );
		if ( null === $have ) {
			continue; // this option tracks no stock: unlimited.
		}
		$label = (string) ( $snap['label'] ?? $key );
		if ( $have <= 0 ) {
			/* translators: %s: the choice, or the colour and size together */
			return new WP_Error( 'addon_boss', sprintf( __( 'Sorry, "%s" is out of stock.', 'addon-boss' ), $label ) );
		}
		$in = addon_boss_option_qty_in_cart( $set_id, $key, $exclude_key );
		if ( $in + $add_qty > $have ) {
			$left = max( 0, $have - $in );
			return new WP_Error(
				'addon_boss',
				sprintf(
					/* translators: 1: units still available, 2: the choice, or the colour and size together */
					_n( 'Sorry, only %1$d of "%2$s" is left.', 'Sorry, only %1$d of "%2$s" are left.', $left, 'addon-boss' ),
					$left,
					$label
				)
			);
		}
	}
	return true;
}

// The add-to-cart gate is not the last word: a shopper can raise the quantity
// box on the cart page, and a cart restored from a session can outlive the
// stock it was built against. WooCommerce re-reads its own products here, on
// the way to checkout, so option stock is re-read at the same seam - counting
// the WHOLE cart, since two lines can draw on one option.
add_action( 'woocommerce_check_cart_items', 'addon_boss_check_cart_option_stock' );

function addon_boss_check_cart_option_stock(): void {
	if ( ! function_exists( 'WC' ) || null === WC()->cart ) {
		return;
	}
	foreach ( addon_boss_cart_option_demand() as $row ) {
		$have = addon_boss_counted_left( $row['set'], $row['key'] );
		if ( null === $have ) {
			continue; // this option tracks no stock: unlimited.
		}
		if ( $have <= 0 ) {
			wc_add_notice(
				sprintf(
					/* translators: %s: the choice, or the colour and size together */
					__( 'Sorry, "%s" is out of stock. Please remove it from your cart.', 'addon-boss' ),
					$row['label']
				),
				'error'
			);
			continue;
		}
		if ( $row['qty'] > $have ) {
			wc_add_notice(
				sprintf(
					/* translators: 1: units still available, 2: the choice, or the colour and size together */
					_n(
						'Sorry, only %1$d of "%2$s" is left. Please lower the quantity in your cart.',
						'Sorry, only %1$d of "%2$s" are left. Please lower the quantity in your cart.',
						max( 0, $have ),
						'addon-boss'
					),
					max( 0, $have ),
					$row['label']
				),
				'error'
			);
		}
	}
}

// Decrement at the sale, restore on a cancel. An option is never a line item,
// so WooCommerce's own stock pass never sees it: we ride the SAME order-stock
// actions WC fires, once per order (guarded by an order flag, exactly like
// WC's _order_stock_reduced), and move each counter with one relative UPDATE,
// the same arithmetic WC's own stock update runs for a product.
add_action( 'woocommerce_reduce_order_stock', 'addon_boss_reduce_order_option_stock', 10, 1 );
add_action( 'woocommerce_restore_order_stock', 'addon_boss_restore_order_option_stock', 10, 1 );

function addon_boss_reduce_order_option_stock( $order ): void {
	addon_boss_adjust_order_option_stock( $order, 'decrease' );
}

function addon_boss_restore_order_option_stock( $order ): void {
	addon_boss_adjust_order_option_stock( $order, 'increase' );
}

/**
 * What one order line asks of stocked options, keyed "set::key".
 *
 * A line is either a product bought on its own page, which froze its picks
 * under our own key, or a BundleBoss bundle, which froze its components' picks
 * under BundleBoss's. Both are sales of the same jars off the same shelf.
 *
 * @param WC_Order_Item $item     The order line.
 * @param int           $line_qty How many of that line.
 */
function addon_boss_order_item_option_demand( $item, int $line_qty ): array {
	$out       = array();
	$bb_snaps  = (array) $item->get_meta( '_bundle_boss_standalone_options' );
	$bb_pair   = addon_boss_combo_row( (int) $item->get_product_id(), $bb_snaps );
	if ( null !== $bb_pair ) {
		// Counted like any option, so a sale takes the pair down and a refund
		// puts it back, through the machinery that already does both.
		$out[ $bb_pair['set'] . '::' . $bb_pair['key'] ] = array(
			'set'   => $bb_pair['set'],
			'key'   => $bb_pair['key'],
			'label' => $bb_pair['label'],
			'qty'   => $line_qty,
		);
	}
	foreach ( $bb_snaps as $snap ) {
		$set = (string) ( is_array( $snap ) ? ( $snap['set'] ?? '' ) : '' );
		$key = (string) ( is_array( $snap ) ? ( $snap['key'] ?? '' ) : '' );
		if ( '' === $set || '' === $key ) {
			continue;
		}
		$out[ $set . '::' . $key ] = array(
			'set'   => $set,
			'key'   => $key,
			'label' => (string) ( $snap['label'] ?? $key ),
			'qty'   => $line_qty,
		);
	}
	foreach ( addon_boss_bundle_option_demand( $item->get_meta( '_bundle_boss_selections' ), $line_qty ) as $mk => $row ) {
		if ( isset( $out[ $mk ] ) ) {
			$out[ $mk ]['qty'] += (int) $row['qty'];
			continue;
		}
		$out[ $mk ] = $row;
	}
	return $out;
}

/**
 * Move every stocked option in an order by its ordered quantity, once. The flag
 * mirrors WooCommerce's reduce-once discipline, so a re-fired hook, a status
 * bounce or a manual "reduce stock" never double-counts.
 */
function addon_boss_adjust_order_option_stock( $order, string $direction ): void {
	if ( ! $order instanceof WC_Order ) {
		$order = wc_get_order( $order );
	}
	if ( ! $order ) {
		return;
	}
	$flag    = '_addon_boss_option_stock_reduced';
	$reduced = 'yes' === $order->get_meta( $flag );
	if ( 'decrease' === $direction && $reduced ) {
		return; // already off stock.
	}
	if ( 'increase' === $direction && ! $reduced ) {
		return; // nothing of ours to give back.
	}
	foreach ( $order->get_items() as $item ) {
		$qty = (int) $item->get_quantity();
		if ( $qty < 1 ) {
			continue;
		}
		foreach ( addon_boss_order_item_option_demand( $item, $qty ) as $row ) {
			if ( null === addon_boss_option_stock_left( $row['set'], $row['key'] ) ) {
				continue; // not tracked: nothing to move.
			}
			addon_boss_option_stock_adjust( $row['set'], $row['key'], ( 'decrease' === $direction ? -1 : 1 ) * (int) $row['qty'] );
		}
	}
	$order->update_meta_data( $flag, 'decrease' === $direction ? 'yes' : 'no' );
	$order->save();
}

// A refund with "restock refunded items" gives option stock back too. WC's own
// wc_restock_refunded_items only touches real line items, so we ride the refund
// event and lift each stocked option by the refunded quantity - honouring the
// merchant's restock choice ($args['restock_items']) exactly as WooCommerce does.
add_action( 'woocommerce_create_refund', 'addon_boss_restock_refunded_option_stock', 10, 2 );

function addon_boss_restock_refunded_option_stock( $refund, $args ): void {
	if ( empty( $args['restock_items'] ) || empty( $args['line_items'] ) ) {
		return;
	}
	$order_id = (int) ( $args['order_id'] ?? ( $refund instanceof WC_Order_Refund ? $refund->get_parent_id() : 0 ) );
	$order    = $order_id ? wc_get_order( $order_id ) : null;
	if ( ! $order ) {
		return;
	}
	// Only give back what a sale actually took off.
	if ( 'yes' !== $order->get_meta( '_addon_boss_option_stock_reduced' ) ) {
		return;
	}
	foreach ( (array) $args['line_items'] as $item_id => $data ) {
		$qty = abs( (int) round( (float) ( $data['qty'] ?? 0 ) ) );
		if ( $qty < 1 ) {
			continue;
		}
		$item = $order->get_item( (int) $item_id );
		if ( ! $item ) {
			continue;
		}
		// The refunded quantity is a count of LINES, so a bundle gives back
		// whatever each bundle held, exactly as the sale took it off.
		foreach ( addon_boss_order_item_option_demand( $item, $qty ) as $row ) {
			if ( null === addon_boss_option_stock_left( $row['set'], $row['key'] ) ) {
				continue; // not tracked (or cleared since the sale): nothing to give back.
			}
			addon_boss_option_stock_adjust( $row['set'], $row['key'], (int) $row['qty'] );
		}
	}
}

// -----------------------------------------------------------------
// Starter library — ready-made sets a shop imports as its OWN copy
// -----------------------------------------------------------------

/**
 * The shipped ready-made sets. Swatches resolve through the engine's
 * colour-name map where it exists, so garment colours arrive with correct
 * chips and zero typing. These are templates: importing COPIES one into the
 * shop's saved sets, where it is fully editable and deletable.
 *
 * @return array<string,array{name:string,options:array[]}>
 */
function addon_boss_option_starter_sets(): array {
	$swatch = static function ( string $name ): string {
		return function_exists( 'addon_boss_swatch_from_name' ) ? addon_boss_swatch_from_name( $name ) : '';
	};
	$colours = static function ( array $names ) use ( $swatch ): array {
		$out = array();
		foreach ( $names as $name ) {
			$out[] = array( 'label' => $name, 'swatch' => $swatch( $name ) );
		}
		return $out;
	};
	$plain = static function ( array $labels ): array {
		$out = array();
		foreach ( $labels as $label ) {
			$out[] = array( 'label' => $label );
		}
		return $out;
	};

	return array(
		'starter_garment_colours' => array(
			'name'    => __( 'Garment colours', 'addon-boss' ),
			'purpose' => __( 'For apparel and workwear', 'addon-boss' ),
			'options' => $colours( array( 'Black', 'White', 'Navy', 'Royal Blue', 'Red', 'Burgundy', 'Charcoal', 'Heather Grey', 'Forest Green', 'Orange', 'Yellow', 'Pink' ) ),
		),
		'starter_sizes_s_4xl'     => array(
			'name'    => __( 'Sizes S to 4XL', 'addon-boss' ),
			'purpose' => __( 'Clothing sizes', 'addon-boss' ),
			'options' => $plain( array( 'S', 'M', 'L', 'XL', '2XL', '3XL', '4XL' ) ),
		),
		'starter_shoe_sizes_uk'   => array(
			'name'    => __( 'UK shoe sizes', 'addon-boss' ),
			'purpose' => __( 'Footwear', 'addon-boss' ),
			'options' => $plain( array( 'UK 6', 'UK 7', 'UK 8', 'UK 9', 'UK 10', 'UK 11', 'UK 12' ) ),
		),
		'starter_paper_sizes'     => array(
			'name'    => __( 'Paper and board sizes', 'addon-boss' ),
			'purpose' => __( 'Print and signage', 'addon-boss' ),
			'options' => $plain( array( 'A6', 'A5', 'A4', 'A3', 'A2', 'A1', 'A0' ) ),
		),
		'starter_bag_weights'     => array(
			'name'    => __( 'Bag weights', 'addon-boss' ),
			'purpose' => __( 'Sweets and food', 'addon-boss' ),
			'options' => $plain( array( '100g', '250g', '500g', '1kg' ) ),
		),
		'starter_finishes'        => array(
			'name'    => __( 'Finishes', 'addon-boss' ),
			'purpose' => __( 'Print, signs and framing', 'addon-boss' ),
			// Real starting numbers, like the price-table templates: the plain
			// finishes free, the laminates carrying a modest charge, every one
			// editable the moment the set is the shop's own.
			'options' => array(
				array( 'label' => __( 'Matt', 'addon-boss' ) ),
				array( 'label' => __( 'Gloss', 'addon-boss' ) ),
				array( 'label' => __( 'Satin', 'addon-boss' ) ),
				array(
					'label' => __( 'Matt laminated', 'addon-boss' ),
					'delta' => 3.0,
				),
				array(
					'label' => __( 'Gloss laminated', 'addon-boss' ),
					'delta' => 3.0,
				),
			),
		),
		'starter_addons'          => array(
			'name'    => __( 'Add-ons', 'addon-boss' ),
			'purpose' => __( 'Charged extras for any shop', 'addon-boss' ),
			// A true extras list is several-of: shoppers may take more than one,
			// each pick charged its own fee, so the set imports that way.
			'multi'   => true,
			'options' => array(
				array(
					'label' => __( 'Gift wrap', 'addon-boss' ),
					'delta' => 3.5,
				),
				array(
					'label' => __( 'Gift box', 'addon-boss' ),
					'delta' => 5.0,
				),
				array(
					'label' => __( 'Handwritten card', 'addon-boss' ),
					'delta' => 1.5,
				),
				array(
					'label' => __( 'Priority dispatch', 'addon-boss' ),
					'delta' => 9.95,
				),
			),
		),
	);
}

/**
 * The id of a saved set whose name matches, or '' when none does. The starter
 * shelf uses it so a ready-made set already imported reads as "Added", and
 * re-importing opens the existing copy instead of silently making a duplicate.
 */
function addon_boss_option_set_id_by_name( string $name ): string {
	foreach ( addon_boss_option_sets() as $id => $set ) {
		if ( isset( $set['name'] ) && (string) $set['name'] === $name ) {
			return (string) $id;
		}
	}
	return '';
}

/**
 * Import a starter set as a new saved set the shop owns. Returns the new
 * set id, or '' for an unknown starter.
 */
function addon_boss_import_starter_set( string $starter_id ): string {
	$starters = addon_boss_option_starter_sets();
	if ( ! isset( $starters[ $starter_id ] ) ) {
		return '';
	}
	return addon_boss_save_option_set( $starters[ $starter_id ] );
}

// -----------------------------------------------------------------
// Product attachment (Shape B: options live on the product)
// -----------------------------------------------------------------

/**
 * The raw attachment config on a product: which sets it comes in, whether
 * each is required, and any per-product delta and photo overrides.
 *
 * @return array<int,array{set:string,required:bool,deltas:array<string,float>,images:array<string,int>}>
 */
/**
 * Whether anything is offering choices and fields ON A PRODUCT'S OWN TERMS.
 *
 * Inside AddOnBoss the feature is always its own, so the default is simply
 * true; the filter stays so a site can switch the surface off. Same shape,
 * and the same reasoning, as addon_boss_positions_available().
 */
function addon_boss_options_available(): bool {
	return (bool) apply_filters( 'addon_boss_options_available', true );
}

/**
 * The words a SHOPPER sees for a set: its display label, else its name.
 *
 * One function because the words surface in five places (the group heading,
 * the pick snapshot the cart and order print, the virtual attribute label,
 * the required and bounds messages), and five copies of "label or name"
 * would drift.
 */
function addon_boss_set_shopper_name( array $set ): string {
	$bb_label = (string) ( $set['label'] ?? '' );
	return '' !== $bb_label ? $bb_label : (string) ( $set['name'] ?? '' );
}

/**
 * The product's attached rows.
 *
 * @param WC_Product|mixed $product The product.
 * @param bool             $stored  True for the rows exactly as saved: the
 *                                  screens that edit and save them, and the
 *                                  copies. Otherwise the rows the shop page
 *                                  asks, with the lists a set's prices follow
 *                                  (addon_boss_config_with_companions).
 */
function addon_boss_product_option_config( $product, bool $stored = false ): array {
	// The chokepoint. Both the option-set resolver and the product-field
	// resolver read through here, so one gate makes the whole per-product
	// feature inert: no sets, no fields, no grid, no standalone surface, and
	// nothing chargeable. Stored data simply lies dormant rather than being
	// migrated or deleted, exactly as it does for positions.
	if ( ! $product instanceof WC_Product || ! addon_boss_options_available() ) {
		return array();
	}
	$cfg = $product->get_meta( ADDON_BOSS_PRODUCT_OPTIONS_META );
	$cfg = is_array( $cfg ) ? $cfg : array();
	return $stored ? $cfg : addon_boss_config_with_companions( $cfg );
}

/**
 * The lists a set's prices follow (a glass priced by its edge polish, a
 * shutter's handle side): each set type names its own through the filter
 * addon_boss_set_preview_companions. Only stored sets, never the set itself.
 *
 * @param array $set A stored set, with its id under 'id' or passed apart.
 * @param string $set_id The set's id.
 * @return string[]
 */
function addon_boss_set_companions( array $set, string $set_id ): array {
	$out = array();
	foreach ( (array) apply_filters( 'addon_boss_set_preview_companions', array(), $set ) as $bb_cid ) {
		$bb_cid = (string) $bb_cid;
		if ( '' !== $bb_cid && $bb_cid !== $set_id && ! in_array( $bb_cid, $out, true ) && addon_boss_option_set( $bb_cid ) ) {
			$out[] = $bb_cid;
		}
	}
	return $out;
}

/**
 * Attached rows with the lists their sets' prices follow, each right after
 * the set that follows it and asked as that set is (required, and shown by
 * the same rule). A list the product carries already stays where it is.
 *
 * A glass priced "A price for each Edge polish" on a product without the
 * Edge polish list showed no choice and charged the cheapest polish, while
 * the editor's preview showed and charged the one picked: £166.17 on the
 * page against £215.16 in the preview (walk 3, 30 Oct 2026). The list now
 * comes with the set wherever the set goes, in the order the preview draws.
 *
 * @param array $config Stored rows (top level, groups holding children).
 * @return array
 */
function addon_boss_config_with_companions( array $config ): array {
	$have = array();
	foreach ( addon_boss_flatten_option_config( $config ) as $bb_row ) {
		if ( is_array( $bb_row ) && '' !== (string) ( $bb_row['set'] ?? '' ) ) {
			$have[ (string) $bb_row['set'] ] = true;
		}
	}
	if ( ! $have ) {
		return $config;
	}
	$walk = static function ( array $rows ) use ( &$walk, &$have ): array {
		$out = array();
		foreach ( $rows as $bb_k => $bb_row ) {
			if ( is_array( $bb_row ) && 'group' === ( $bb_row['row_type'] ?? '' ) ) {
				$bb_row['children'] = $walk( (array) ( $bb_row['children'] ?? array() ) );
			}
			$out[] = $bb_row;
			$bb_sid = is_array( $bb_row ) && 'field' !== ( $bb_row['row_type'] ?? '' ) ? (string) ( $bb_row['set'] ?? '' ) : '';
			$bb_set = '' !== $bb_sid ? addon_boss_option_set( $bb_sid ) : null;
			if ( ! $bb_set ) {
				continue;
			}
			foreach ( addon_boss_set_companions( (array) $bb_set, $bb_sid ) as $bb_cid ) {
				if ( isset( $have[ $bb_cid ] ) ) {
					continue;
				}
				$have[ $bb_cid ] = true;
				$out[]           = array(
					'set'       => $bb_cid,
					'required'  => ! empty( $bb_row['required'] ),
					'when'      => is_array( $bb_row['when'] ?? null ) ? $bb_row['when'] : array(),
					'deltas'    => array(),
					'images'    => array(),
					'hide'      => array(),
					'companion' => $bb_sid,
				);
			}
		}
		return $out;
	};
	return $walk( $config );
}

/**
 * Sanitise + save the attachment config. Override deltas keep an explicit
 * zero (it is a value that beats the set default) and drop empty strings
 * (absence, meaning "use the default").
 */
function addon_boss_save_product_option_config( $product, array $raw ): void {
	if ( ! $product instanceof WC_Product ) {
		return;
	}
	$clean = addon_boss_sanitize_product_option_config( $raw );
	if ( $clean ) {
		$product->update_meta_data( ADDON_BOSS_PRODUCT_OPTIONS_META, $clean );
	} else {
		$product->delete_meta_data( ADDON_BOSS_PRODUCT_OPTIONS_META );
	}
	$product->save();
}

// How a product with several option groups lays them out. Stacked is plain
// block flow, so it is theme-proof and stays the default for every product that
// has never been told otherwise.
const ADDON_BOSS_OPTIONS_LAYOUT_META = '_bundle_boss_options_layout';

/**
 * The layouts this build can actually draw.
 *
 * Every key here MUST be honoured by the renderer. "Step by step" was listed
 * before it was built: the menu offered it, the save accepted it, and the page
 * came out identical to stacked, so a merchant chose a layout and got nothing.
 * A control that does not do its job is worse than an absent one, because the
 * merchant spends their time wondering what they did wrong. It comes back when
 * there is a renderer behind it, and LayoutsRenderTest fails the moment this
 * list grows a key the renderer does not branch on.
 *
 * Deliberately no tabs. They are the worst of the options for a form: they hide
 * sibling groups behind a click, so a shopper cannot see what is left to decide,
 * and they are the most fragile thing to put inside a page builder's column.
 *
 * @return array<string,string> Layout key => the merchant-facing name.
 */
function addon_boss_options_layouts(): array {
	$out = array( 'stacked' => __( 'One after another', 'addon-boss' ) );
	// A layout beyond the engine's own flow registers from the module that
	// draws it, so the menu can never offer a page this build cannot render.
	return (array) apply_filters( 'addon_boss_options_layouts', $out );
}

/**
 * The layout to draw a product's option groups in.
 *
 * Anything this build cannot draw falls back to stacked, which can render any
 * configuration. The STORED value is left alone, exactly as a repeatable field's
 * setting is, so a lapsed licence shows the plain layout for a while rather than
 * losing what the merchant chose.
 *
 * @param WC_Product|int|null $product
 * @return string
 */
function addon_boss_options_layout( $product ): string {
	$product = $product instanceof WC_Product ? $product : ( $product ? wc_get_product( $product ) : null );
	if ( ! $product instanceof WC_Product ) {
		return 'stacked';
	}
	$want = (string) $product->get_meta( ADDON_BOSS_OPTIONS_LAYOUT_META );
	return isset( addon_boss_options_layouts()[ $want ] ) ? $want : 'stacked';
}

/**
 * Store the chosen layout. An unknown value, or the default, stores nothing, so
 * a product only carries this meta once it actually differs from plain flow.
 *
 * @param WC_Product $product
 * @param string     $layout
 */
function addon_boss_save_options_layout( WC_Product $product, string $layout ): void {
	// Validated against what this build OFFERS, plus whatever the product
	// already carries: a repost of the stored value on a build without the
	// module keeps the merchant's choice rather than resetting it, while a
	// layout nothing registered and nothing stored is refused, because
	// accepting it would store a choice that can never show up on the page.
	// (The caller only reaches here when the picker was actually on the
	// screen that posted, so an absent control can never blank a choice.)
	$known  = array_keys( addon_boss_options_layouts() );
	$stored = (string) $product->get_meta( ADDON_BOSS_OPTIONS_LAYOUT_META );
	if ( '' !== $stored && ! in_array( $stored, $known, true ) ) {
		$known[] = $stored;
	}
	if ( in_array( $layout, $known, true ) && 'stacked' !== $layout ) {
		$product->update_meta_data( ADDON_BOSS_OPTIONS_LAYOUT_META, $layout );
	} else {
		$product->delete_meta_data( ADDON_BOSS_OPTIONS_LAYOUT_META );
	}
}

/**
 * The picker's own behaviour, owned by the engine that draws the picker.
 *
 * WHY NOT THE ADMIN SCRIPT. The product-options panel loads its script from
 * whichever plugin got there first: the engine steps aside when the host's
 * admin handle is already enqueued, because a pre-split host binds the same
 * generic behaviours. That is fine for behaviours both copies have. It is not
 * fine for a control only one of them knows about, which on the other's copy
 * is either dead or, worse, swept up by a generic selector. This panel is the
 * engine's, so its script is too.
 *
 * Everything here is progressive: the select and the two tick-boxes are what
 * post, and they are hidden only once their cards are wired.
 *
 * @return string
 */
function addon_boss_options_picker_js(): string {
	return <<<'JS'
jQuery( function ( $ ) {
	$( '.bb-lookcards[data-for]' ).each( function () {
		var $cards  = $( this );
		var $select = $( '#' + $cards.data( 'for' ) );
		if ( ! $select.length ) { $cards.remove(); return; }
		$select.addClass( 'bb-look-carded' );
		// The heading above these cards IS a <label for>, so that the plain
		// select is labelled when this script does not run. Hiding it with the
		// select took the word "Arrangement" off the screen and left a bare
		// "(pick one)". Cut the tie instead and keep the heading; a label
		// somewhere else, with nothing left to point at, still goes.
		$( 'label[for="' + $cards.data( 'for' ) + '"]' ).each( function () {
			if ( $( this ).closest( '.bb-look-lab' ).length ) {
				$( this ).removeAttr( 'for' );
			} else {
				$( this ).addClass( 'bb-look-carded' );
			}
		} );
		$cards.attr( { role: 'group', 'aria-label': $.trim( $cards.prevAll( '.bb-look-lab' ).first().text() ) } );
		function paint() {
			var v = String( $select.val() );
			$cards.find( '.bb-lookcard' ).each( function () {
				var on = String( $( this ).data( 'value' ) ) === v;
				$( this ).toggleClass( 'is-on', on ).attr( 'aria-pressed', on ? 'true' : 'false' );
			} );
		}
		$cards.on( 'click', '.bb-lookcard', function () {
			$select.val( $( this ).data( 'value' ) ).trigger( 'change' );
			paint();
		} );
		$select.on( 'change', paint );
		paint();
	} );

	$( '.bb-lookcards-many .bb-lookcard-many' ).each( function () {
		var $card = $( this );
		var $box  = $( '#' + $card.data( 'check' ) );
		if ( ! $box.length ) { $card.remove(); return; }
		$box.closest( '.form-field' ).addClass( 'bb-look-carded' );
		function paint() {
			var on = $box.is( ':checked' );
			$card.toggleClass( 'is-on', on ).attr( 'aria-pressed', on ? 'true' : 'false' );
		}
		$card.on( 'click', function () {
			$box.prop( 'checked', ! $box.is( ':checked' ) ).trigger( 'change' );
			paint();
		} );
		$box.on( 'change', paint );
		paint();
	} );

	// A shut header that goes stale the moment a card is clicked is worse than
	// one that never spoke: it is then wrong rather than silent.
	$( '.bb-lookshelf' ).each( function () {
		var $shelf = $( this );
		var $state = $shelf.find( '.bb-look-state' ).first();
		var $lay   = $shelf.find( 'select.bb-layout-sel' ).first();
		if ( ! $state.length || ! $lay.length ) { return; }
		function line() {
			var bits = [ $lay.find( 'option:selected' ).text() ];
			// A MAP, NEVER A TERNARY. This was `review ? rev : num`, so the
			// third switch arriving read its word off the numbered one and the
			// shut line said "numbered" twice while never mentioning the photo.
			// Its twin, the switch saver, had the same shape and wrote a third
			// switch into a second one's meta. An unknown name now contributes
			// nothing rather than borrowing a neighbour's word.
			var words = {
				bb_options_numbered:  'num',
				bb_options_review:    'rev',
				bb_options_photoview: 'pho'
			};
			$shelf.find( '.bb-lookcards-many .bb-lookcard-many' ).each( function () {
				var id = $( this ).data( 'check' );
				if ( ! words.hasOwnProperty( id ) ) { return; }
				var word = $state.data( words[ id ] );
				if ( word && $( '#' + id ).is( ':checked' ) ) { bits.push( word ); }
			} );
			$state.text( bits.join( ' · ' ) );
			// The shut row's drawing follows the lit card, cloned from it so
			// the picker stays the one place the arrangements are drawn.
			var $thumb = $shelf.find( '.bb-look-thumb' ).first();
			var $lit   = $shelf.find( '.bb-lookcards:not(.bb-lookcards-many) .bb-lookcard[aria-pressed="true"] svg' ).first();
			if ( $thumb.length && $lit.length ) {
				$thumb.empty().append( $lit.clone() );
			}
		}
		$shelf.on( 'change', 'select.bb-layout-sel, input[type="checkbox"]', line );
		line();

		// A CONTROL ONLY ONE ARRANGEMENT READS IS ONLY ON SCREEN FOR IT. The
		// row ships visible in the markup when the STORED arrangement is the
		// one that reads it, so a merchant whose script never runs sees the
		// truth rather than a control that can never appear; the script only
		// keeps it honest while they click between the cards.
		var $when = $shelf.find( '[data-bb-when]' );
		if ( $when.length ) {
			var arrive = function () {
				var now = String( $lay.val() || '' );
				$when.each( function () {
					this.hidden = ( String( $( this ).attr( 'data-bb-when' ) || '' ) !== now );
				} );
			};
			$shelf.on( 'change', 'select.bb-layout-sel', arrive );
			arrive();
		}
	} );
} );
JS;
}

/**
 * The picture and the one-line hint for each layout on the picker.
 *
 * A NAME IS NOT ENOUGH. "Folding sections" tells a merchant nothing about the
 * page a shopper will meet, and a list of names in a dropdown asks them to
 * imagine four pages at once. A small drawing of the arrangement answers the
 * only question they actually have, which is what it will look like.
 *
 * Meta is kept apart from addon_boss_options_layouts() so that registry stays
 * the plain key => name contract the storefront and the saver read, and so a
 * module that registers a layout supplies its own card rather than leaving art
 * for it in core. A layout with no entry here still draws, on the neutral
 * placeholder below: a missing picture must never cost a merchant the choice.
 *
 * @return array<string,array{hint:string,wf:string}>
 */
function addon_boss_options_layout_cards(): array {
	$cards = array(
		'stacked' => array(
			'hint' => __( 'Every question open, top to bottom.', 'addon-boss' ),
			'wf'   => '<svg viewBox="0 0 100 52" aria-hidden="true">'
				. '<rect class="wfb" x="7" y="4" width="30" height="5" rx="1.5"/>'
				. '<rect class="wfr" x="7" y="13" width="21" height="8" rx="2"/>'
				. '<rect class="wfr" x="31" y="13" width="21" height="8" rx="2"/>'
				. '<rect class="wfr" x="55" y="13" width="21" height="8" rx="2"/>'
				. '<rect class="wfb" x="7" y="28" width="25" height="5" rx="1.5"/>'
				. '<rect class="wfr" x="7" y="37" width="21" height="8" rx="2"/>'
				. '<rect class="wfr" x="31" y="37" width="21" height="8" rx="2"/>'
				. '</svg>',
		),
	);
	return (array) apply_filters( 'addon_boss_options_layout_cards', $cards );
}

/**
 * The drawing shown for a layout that registered no card of its own.
 *
 * @return string
 */
function addon_boss_options_card_placeholder(): string {
	return '<svg viewBox="0 0 100 52" aria-hidden="true">'
		. '<rect class="wfr" x="7" y="7" width="86" height="38" rx="3"/>'
		. '</svg>';
}

/**
 * Let a drawing through to the page without letting anything else through.
 *
 * The cards arrive on a filter, so they are code, not merchant input. They are
 * still run past an allow list rather than printed raw: the shapes we draw with
 * are four elements and a handful of geometry attributes, and nothing that can
 * carry script belongs in a wireframe. (The HTML parser restores the camel case
 * in viewBox, which kses lowercases.)
 *
 * @param string $svg
 * @return string
 */
function addon_boss_options_card_svg( string $svg ): string {
	return wp_kses(
		$svg,
		array(
			'svg'     => array(
				'viewbox'     => true,
				'aria-hidden' => true,
				'class'       => true,
			),
			'rect'    => array(
				'class'  => true,
				'x'      => true,
				'y'      => true,
				'width'  => true,
				'height' => true,
				'rx'     => true,
			),
			'circle'  => array(
				'class' => true,
				'cx'    => true,
				'cy'    => true,
				'r'     => true,
			),
			'polygon' => array(
				'class'  => true,
				'points' => true,
			),
		)
	);
}

/**
 * The state of all three controls in one line, for the shut section header.
 *
 * A folded section that says nothing is a section a merchant has to open to
 * learn anything, which is the whole failure this one is folded to avoid. The
 * line is built on the server so it is already right with JavaScript off; the
 * picker rewrites it in place as cards are clicked.
 *
 * @param WC_Product|null $product
 * @return string
 */
function addon_boss_options_look_line( $product ): string {
	$layouts = addon_boss_options_layouts();
	$key     = $product ? addon_boss_options_layout( $product ) : 'stacked';
	$bits    = array( isset( $layouts[ $key ] ) ? $layouts[ $key ] : $layouts['stacked'] );
	if ( $product && addon_boss_options_numbered( $product ) ) {
		$bits[] = __( 'numbered', 'addon-boss' );
	}
	if ( $product && addon_boss_options_review( $product ) ) {
		$bits[] = __( 'with a review', 'addon-boss' );
	}
	if ( $product && addon_boss_options_photo_in_view( $product ) ) {
		$bits[] = __( 'with the photo in view', 'addon-boss' );
	}
	return implode( ' · ', $bits );
}

/**
 * Cards that drive a select: one of them is on, exactly as a radio group.
 *
 * The select keeps its name, its id and its change event, so saving, hydrating
 * and anything else bound to it behave exactly as before. The cards set its
 * value and fire change. Without JavaScript the cards never appear and the
 * plain menu is still sitting there, which is why the select is hidden by a
 * class the script adds rather than by a rule in the stylesheet.
 *
 * @param string               $select_id Id of the select these cards drive.
 * @param array<string,string> $options   value => merchant-facing name.
 * @param array<string,array>  $meta      value => { hint, wf }.
 * @param string               $current   The value that is on.
 */
function addon_boss_options_pick_cards( string $select_id, array $options, array $meta, string $current ): void {
	// bb-lookcards, NOT bb-selcards. The generic card binding lives in an
	// admin script that the host plugin may own: on a store running the
	// sibling plugin this panel's behaviour comes from ITS copy, which knows
	// nothing about toggle cards and deletes any card set it cannot drive.
	// Our own class keeps that binding away and the engine drives its own
	// panel, which is the only arrangement that behaves the same in every
	// combination of the two plugins.
	echo '<div class="bb-lookcards" data-for="' . esc_attr( $select_id ) . '">';
	foreach ( $options as $value => $label ) {
		$card = isset( $meta[ $value ] ) ? (array) $meta[ $value ] : array();
		$wf   = isset( $card['wf'] ) ? (string) $card['wf'] : addon_boss_options_card_placeholder();
		$hint = isset( $card['hint'] ) ? (string) $card['hint'] : '';
		printf(
			'<button type="button" class="bb-look bb-lookcard%s" data-value="%s" aria-pressed="%s">',
			( (string) $value === $current ) ? ' is-on' : '',
			esc_attr( (string) $value ),
			( (string) $value === $current ) ? 'true' : 'false'
		);
		echo '<span class="bb-look-tick" aria-hidden="true"></span>';
		echo '<span class="bb-look-wf">' . addon_boss_options_card_svg( $wf ) . '</span>'; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- run past the allow list on the line above.
		echo '<span class="bb-look-name">' . esc_html( (string) $label ) . '</span>';
		if ( '' !== $hint ) {
			echo '<span class="bb-look-hint">' . esc_html( $hint ) . '</span>';
		}
		echo '</button>';
	}
	echo '</div>';
}

/**
 * Cards that drive their own tick-box: any of them, or none.
 *
 * A DIFFERENT SHAPE ON PURPOSE. These wear a square tick where the arrangement
 * cards wear a round dot, because that is the standing meaning of the two
 * shapes everywhere else a person meets a form: round means pick one of us,
 * square means switch me on. Numbering and the review are not alternatives to
 * an arrangement and not to each other, so they must not look like a choice.
 *
 * @param array<int,array{id:string,label:string,hint:string,wf:string,on:bool}> $switches
 */
function addon_boss_options_toggle_cards( array $switches ): void {
	echo '<div class="bb-lookcards bb-lookcards-many">';
	foreach ( $switches as $sw ) {
		$id   = isset( $sw['id'] ) ? (string) $sw['id'] : '';
		$on   = ! empty( $sw['on'] );
		$hint = isset( $sw['hint'] ) ? (string) $sw['hint'] : '';
		$wf   = isset( $sw['wf'] ) ? (string) $sw['wf'] : addon_boss_options_card_placeholder();
		if ( '' === $id ) {
			continue;
		}
		printf(
			'<button type="button" class="bb-look bb-lookcard bb-lookcard-many%s" data-check="%s" aria-pressed="%s">',
			$on ? ' is-on' : '',
			esc_attr( $id ),
			$on ? 'true' : 'false'
		);
		echo '<span class="bb-look-tick" aria-hidden="true"></span>';
		echo '<span class="bb-look-wf">' . addon_boss_options_card_svg( $wf ) . '</span>'; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- run past the allow list on the line above.
		echo '<span class="bb-look-name">' . esc_html( isset( $sw['label'] ) ? (string) $sw['label'] : '' ) . '</span>';
		if ( '' !== $hint ) {
			echo '<span class="bb-look-hint">' . esc_html( $hint ) . '</span>';
		}
		echo '</button>';
	}
	echo '</div>';
}

// TWO SWITCHES THAT RIDE ANY LAYOUT.
//
// These started life welded together as a third layout, "Numbered steps with a
// review". They are not a layout: a numbered page is the stacked page with a
// number on each card, and the review is one more block above the button. Welded
// to a menu entry they cost every other combination, because a merchant who
// wanted a review without numbers could not have one and the folding layout
// could never have either. Two switches beside the menu give four real pages
// instead of three mutually exclusive ones, and the storefront reads exactly the
// same two flags it always did.
const ADDON_BOSS_OPTIONS_NUMBERED_META = '_bundle_boss_options_numbered';
const ADDON_BOSS_OPTIONS_REVIEW_META   = '_bundle_boss_options_review';
const ADDON_BOSS_OPTIONS_OPENSTATE_META = '_bundle_boss_options_openstate';
const ADDON_BOSS_OPTIONS_PHOTOVIEW_META = '_bundle_boss_options_photoview';

/**
 * Whether this product numbers the questions the shopper has to answer.
 *
 * Pro, and stood down whole without the plan: the stored value stays put, so a
 * lapsed licence shows the plain page for a while rather than losing the
 * merchant's choice, exactly as the layout itself behaves.
 *
 * @param WC_Product|int|null $product
 * @return bool
 */
function addon_boss_options_numbered( $product ): bool {
	$product = $product instanceof WC_Product ? $product : ( $product ? wc_get_product( $product ) : null );
	if ( ! $product instanceof WC_Product || ! addon_boss_engine_can( 'layouts' ) ) {
		return false;
	}
	return '1' === (string) $product->get_meta( ADDON_BOSS_OPTIONS_NUMBERED_META );
}

/**
 * Whether this product keeps its photograph in view while the questions are
 * answered.
 *
 * Off unless the shop asked for it, and the only switch of the round that
 * defaults off: the other two ADD something to a page, this one MOVES a
 * theme's own gallery, and a page nobody asked to change should not change.
 *
 * @param WC_Product|int|null $product Product or its id.
 * @return bool
 */
function addon_boss_options_photo_in_view( $product ): bool {
	$product = $product instanceof WC_Product ? $product : ( $product ? wc_get_product( $product ) : null );
	if ( ! $product instanceof WC_Product || ! addon_boss_engine_can( 'layouts' ) ) {
		return false;
	}
	return '1' === (string) $product->get_meta( ADDON_BOSS_OPTIONS_PHOTOVIEW_META );
}

/**
 * Whether this product prints a review of every answer above the button.
 *
 * @param WC_Product|int|null $product
 * @return bool
 */
function addon_boss_options_review( $product ): bool {
	$product = $product instanceof WC_Product ? $product : ( $product ? wc_get_product( $product ) : null );
	if ( ! $product instanceof WC_Product || ! addon_boss_engine_can( 'layouts' ) ) {
		return false;
	}
	return '1' === (string) $product->get_meta( ADDON_BOSS_OPTIONS_REVIEW_META );
}

/**
 * WHAT A FOLDING PAGE LOOKS LIKE THE MOMENT IT LOADS.
 *
 * Folding sections shipped with every optional group shut, which is the one
 * case the accordion evidence argues against: on a page where the shopper
 * needs all of the content, collapsing it costs a click per question and buys
 * nothing. Fold as you go is the guided version of that idea; the manual one
 * should not also be the hidden one. The default is open, and a merchant who
 * wants the compact page asks for it.
 *
 * "Not collapsible" is deliberately NOT one of these. That is the One after
 * another arrangement, already on the menu, and offering it twice would be
 * two controls doing one job.
 *
 * @param WC_Product|int|null $product Product or its id.
 * @return string One of all, first, none.
 */
function addon_boss_options_open_state( $product ): string {
	$product = $product instanceof WC_Product ? $product : ( $product ? wc_get_product( $product ) : null );
	if ( ! $product instanceof WC_Product || ! addon_boss_engine_can( 'layouts' ) ) {
		return 'all';
	}
	$state = (string) $product->get_meta( ADDON_BOSS_OPTIONS_OPENSTATE_META );
	return in_array( $state, array( 'first', 'none' ), true ) ? $state : 'all';
}

/**
 * The three states, most open first, which is the order a merchant reads them.
 *
 * @return array
 */
function addon_boss_options_open_states(): array {
	return array(
		'all'   => __( 'Everything open', 'addon-boss' ),
		'first' => __( 'First one open', 'addon-boss' ),
		'none'  => __( 'Everything closed', 'addon-boss' ),
	);
}

/**
 * Store the opening state. The default stores nothing, so a product only
 * carries the meta once it asks for something other than open.
 *
 * @param WC_Product $product Product being saved.
 * @param string     $state   The posted state.
 */
function addon_boss_save_options_open_state( WC_Product $product, string $state ): void {
	if ( in_array( $state, array( 'first', 'none' ), true ) ) {
		$product->update_meta_data( ADDON_BOSS_OPTIONS_OPENSTATE_META, $state );
	} else {
		$product->delete_meta_data( ADDON_BOSS_OPTIONS_OPENSTATE_META );
	}
}

// POPULAR SETUPS: a named starting point a shopper can press.
//
// The evidence-backed "better" layout rather than another arrangement of the
// same questions. A configurator asks a shopper to assemble something they
// have never assembled; a setup lets them EDIT something plausible instead,
// which is a far easier job and a better-selling one.
//
// Two things it is deliberately not. It is never applied FOR the shopper: a
// pre-ticked paid extra is not consent, so the page arrives with nothing
// chosen and a press is what applies it. And it does not lock: after the
// press every question is exactly as changeable as it was, which is why the
// card stops claiming to be the answer the moment anything moves.
//
// It is DATA, not a display switch. A product with setups shows them and a
// product without shows nothing, so there is no second setting that can
// disagree with the first about whether they exist.
const ADDON_BOSS_OPTIONS_SETUPS_META = '_bundle_boss_options_setups';

/**
 * This product's setups, cleaned at the boundary.
 *
 * Ungated on purpose, the way the layout choice is: a lapsed build keeps the
 * merchant's work untouched and honours it again the moment the plan is back.
 * Nothing renders from it without the module, so storing it costs a lapsed
 * shop nothing.
 *
 * @param WC_Product|int|mixed $product Product or its id.
 * @return array<int,array<string,mixed>> The stored setups.
 */
function addon_boss_options_setups( $product ): array {
	if ( ! $product instanceof WC_Product ) {
		$product = wc_get_product( $product );
	}
	if ( ! $product instanceof WC_Product ) {
		return array();
	}
	$raw = $product->get_meta( ADDON_BOSS_OPTIONS_SETUPS_META );
	if ( ! is_array( $raw ) ) {
		return array();
	}
	$out = array();
	foreach ( $raw as $row ) {
		if ( ! is_array( $row ) ) {
			continue;
		}
		$name = sanitize_text_field( (string) ( $row['name'] ?? '' ) );
		if ( '' === $name ) {
			continue; // a setup nobody can name is a button with no word on it.
		}
		$picks = array();
		foreach ( (array) ( $row['picks'] ?? array() ) as $bb_sid => $bb_key ) {
			$bb_sid = sanitize_key( (string) $bb_sid );
			$bb_key = sanitize_key( (string) $bb_key );
			if ( '' !== $bb_sid && '' !== $bb_key ) {
				$picks[ $bb_sid ] = $bb_key;
			}
		}
		$out[] = array(
			'id'    => sanitize_key( (string) ( $row['id'] ?? '' ) ),
			'name'  => $name,
			'note'  => sanitize_text_field( (string) ( $row['note'] ?? '' ) ),
			'picks' => $picks,
		);
	}
	return $out;
}

/**
 * Store the setups a merchant posted.
 *
 * A product with none carries no meta at all, so the row never renders from a
 * leftover empty array and an untouched product stays byte-identical.
 *
 * @param WC_Product $product Product being saved.
 * @param array      $rows    The posted rows.
 */
function addon_boss_save_options_setups( WC_Product $product, array $rows ): void {
	$clean = array();
	foreach ( $rows as $row ) {
		$name = sanitize_text_field( (string) ( $row['name'] ?? '' ) );
		if ( '' === $name ) {
			continue;
		}
		$picks = array();
		foreach ( (array) ( $row['picks'] ?? array() ) as $bb_sid => $bb_key ) {
			$bb_sid = sanitize_key( (string) $bb_sid );
			$bb_key = sanitize_key( (string) $bb_key );
			if ( '' !== $bb_sid && '' !== $bb_key ) {
				$picks[ $bb_sid ] = $bb_key;
			}
		}
		$clean[] = array(
			'id'    => addon_boss_option_key(),
			'name'  => $name,
			'note'  => sanitize_text_field( (string) ( $row['note'] ?? '' ) ),
			'picks' => $picks,
		);
	}
	if ( $clean ) {
		$product->update_meta_data( ADDON_BOSS_OPTIONS_SETUPS_META, $clean );
	} else {
		$product->delete_meta_data( ADDON_BOSS_OPTIONS_SETUPS_META );
	}
}

/**
 * What a setup costs, and whether that figure is the whole story.
 *
 * A SETUP CANNOT PRICE EVERY KIND OF QUESTION, and the card has to say so
 * rather than quote a number the page will then contradict. A measured size is
 * a rate times the shopper's own dimensions, an upload has no price until
 * there is a file, and a typed message may be charged per letter: none of
 * those can be answered in advance by a merchant picking from a list. So the
 * reading comes back with a flag, and a setup that leaves anything still
 * asking is shown as a FROM price rather than a price.
 *
 * @param WC_Product $product The product being priced.
 * @param array      $setup   One setup row.
 * @param array      $sets    The product's option sets.
 * RAW, not display basis. The house rule is one conversion, at the print, so
 * this hands back the shop's own figure and addon_boss_money() carries it onto
 * whatever basis and currency the shopper is looking at. Converting here as
 * well is the double-conversion the currency-switcher seam was fixed for.
 *
 * @return array<string,mixed> The raw figure and whether it is complete.
 */
function addon_boss_options_setup_total( WC_Product $product, array $setup, array $sets ): array {
	$total = (float) $product->get_price();
	$exact = true;
	$picks = (array) ( $setup['picks'] ?? array() );
	foreach ( $sets as $set ) {
		$bb_sid = (string) ( $set['id'] ?? '' );
		$bb_key = (string) ( $picks[ $bb_sid ] ?? '' );
		if ( '' === $bb_key ) {
			// Nothing picked here. Only an OPTIONAL group may be left alone
			// quietly; a required one still owed makes the figure a floor.
			if ( ! empty( $set['required'] ) ) {
				$exact = false;
			}
			continue;
		}
		$found = false;
		foreach ( (array) ( $set['options'] ?? array() ) as $bb_opt ) {
			if ( (string) ( $bb_opt['key'] ?? '' ) !== $bb_key ) {
				continue;
			}
			$found  = true;
			$total += (float) ( $bb_opt['delta'] ?? 0 );
			break;
		}
		if ( ! $found ) {
			// The merchant picked a choice that has since been deleted from the
			// set. Say the figure is a floor rather than quote one missing a line.
			$exact = false;
		}
	}
	// A field can be priced too (per letter, a flat fee on a tick) and no setup
	// answers fields, so any product carrying one is quoting a floor.
	if ( addon_boss_standalone_product_fields( $product ) ) {
		$exact = false;
	}
	return array( 'total' => $total, 'exact' => $exact );
}

/**
 * HOW MANY DISCLOSURES THIS PANEL HAS ALREADY DRAWN, so "first one open" knows
 * which one is first. Counted rather than worked out from the stored config,
 * because what actually becomes a disclosure is decided group by group while
 * rendering: a nameless group never is one, and neither is a required group.
 *
 * @param bool $reset True to start the count again.
 * @return int How many came before this one.
 */
function addon_boss_options_fold_seq( bool $reset = false ): int {
	static $seen = 0;
	if ( $reset ) {
		$seen = 0;
		return 0;
	}
	return $seen++;
}

/**
 * THE PRODUCT THIS PANEL IS RENDERING, for the parts that are handed a layout
 * but not the product it came from. Set once when the panel opens.
 *
 * @param WC_Product|null $set The product, when opening a panel.
 * @return WC_Product|null
 */
function addon_boss_options_rendering_product( $set = null ) {
	static $current = null;
	if ( $set instanceof WC_Product ) {
		$current = $set;
	}
	return $current;
}

/**
 * HOW MANY OF A PRODUCT'S QUESTIONS THE SHOPPER MUST ANSWER, out of how many
 * there are. Read from the stored attachment, so the admin can state it while
 * drawing a control rather than only after a render.
 *
 * @param WC_Product|int|null $product Product or its id.
 * @return array Two numbers: how many are required, how many there are.
 */
function addon_boss_options_required_share( $product ): array {
	$rows = $product ? addon_boss_product_option_config( $product ) : array();
	$req  = 0;
	$all  = 0;
	foreach ( (array) $rows as $row ) {
		if ( ! is_array( $row ) ) {
			continue;
		}
		++$all;
		if ( ! empty( $row['required'] ) ) {
			++$req;
		}
	}
	return array( $req, $all );
}

/**
 * Store one of the two switches. Off stores nothing, so a product only carries
 * the meta once it actually differs from the plain page.
 *
 * @param WC_Product $product Product being saved.
 * @param string     $which   Either 'numbered' or 'review'.
 * @param bool       $on      The posted state.
 */
function addon_boss_save_options_switch( WC_Product $product, string $which, bool $on ): void {
	// A MAP, not a chain of guesses. As a ternary this silently stored the
	// numbered flag for any name it did not recognise, so a third switch added
	// later would have written itself into the second one's meta.
	$keys = array(
		'numbered'  => ADDON_BOSS_OPTIONS_NUMBERED_META,
		'review'    => ADDON_BOSS_OPTIONS_REVIEW_META,
		'photoview' => ADDON_BOSS_OPTIONS_PHOTOVIEW_META,
	);
	if ( ! isset( $keys[ $which ] ) ) {
		return;
	}
	$key = $keys[ $which ];
	if ( $on ) {
		$product->update_meta_data( $key, '1' );
	} else {
		$product->delete_meta_data( $key );
	}
}

/**
 * The RESOLVED, render-ready option sets for a product: attachment plus set
 * data merged, cascade applied (set default delta, then product override).
 * Variable PARENTS resolve too: their variations keep owning colour, size,
 * stock and photos, and sets ride on top as extras priced per pick (88% of
 * the founding customer's variable catalogue carries add-on fields).
 * Variation objects resolve nothing (sets live on the parent), and
 * attachments whose set no longer exists degrade silently.
 *
 * Sets lent to the product for one bundle row ($lent, rows shaped like its
 * own attachment rows, see addon_boss_item_lent_rows()) resolve after its
 * own, through the same steps, so they price and validate the same way.
 *
 * @param WC_Product|mixed $product The product.
 * @param array            $lent    Attachment rows lent to it, none by default.
 * @return array<int,array{id:string,name:string,required:bool,options:array[]}>
 */
function addon_boss_product_option_sets( $product, array $lent = array() ): array {
	if ( ! $product instanceof WC_Product || $product->is_type( 'variation' ) ) {
		return array();
	}
	$resolved = array();
	// Flattened so a set inside a GROUP resolves (and prices) exactly like a
	// top-level one; grouping is presentation only.
	foreach ( array_merge( addon_boss_flatten_option_config( addon_boss_product_option_config( $product ) ), $lent ) as $row ) {
		if ( ( $row['row_type'] ?? '' ) === 'field' || ! isset( $row['set'] ) ) {
			continue; // field rows carry no set for this set-only resolver.
		}
		$set = addon_boss_option_set( $row['set'] );
		if ( ! $set ) {
			continue; // deleted set: degrade silently, never fatally.
		}
		// An empty choices set offers nothing; a kind priced off its own panel
		// (its payload stored under measure or table) is whole WITHOUT option
		// rows (pure custom sizing is a real shop). This reads the stored
		// SHAPE only; whatever maths prices the payload lives with its module.
		$bb_kind_whole = 'choices' !== ( $set['kind'] ?? 'choices' )
			&& ( ! empty( $set['measure']['dims'] ) || ! empty( $set['table']['a_labels'] ) );
		if ( empty( $set['options'] ) && ! $bb_kind_whole ) {
			continue;
		}
		// Choices this product does not offer. Applied HERE, in the resolver,
		// so the page, the validation, the price and the cart all read one
		// list: a hidden key is refused at add-to-cart for exactly the reason
		// an invented one is, because by this point they are the same thing.
		// (The discipline is BundleBoss's, ported with the feature.)
		$bb_hidden = array_flip( array_map( 'strval', (array) ( $row['hide'] ?? array() ) ) );
		$options = array();
		foreach ( $set['options'] as $opt ) {
			if ( isset( $bb_hidden[ (string) $opt['key'] ] ) ) {
				continue;
			}
			$options[] = array(
				'key'      => $opt['key'],
				'label'    => $opt['label'],
				'swatch'   => $opt['swatch'],
				'swatch2'  => $opt['swatch2'] ?? '',
				// A colour the merchant cleared travels with the choice, or every
				// reader past this point guesses one from the name again.
				'no_swatch' => ! empty( $opt['no_swatch'] ),
				'desc'     => $opt['desc'] ?? '',
				// The photo cascades exactly like the charge: the set may carry a
				// default, the product override wins (sets are shared, but the
				// blue photo of THIS product is this product's business).
				'image_id' => isset( $row['images'][ $opt['key'] ] ) ? (int) $row['images'][ $opt['key'] ] : (int) $opt['image_id'],
				// A config row need not carry overrides at all: a row written by
				// hand, by an import or by the variation converter is just the
				// set it points at. The other two readers of this key already
				// default it; this one did not, and an absent 'deltas' took the
				// whole product page down with a fatal rather than falling back
				// to the set's own figure.
				'delta'    => array_key_exists( $opt['key'], (array) ( $row['deltas'] ?? array() ) ) ? (float) $row['deltas'][ $opt['key'] ] : (float) $opt['delta'],
				'dims'     => (array) ( $opt['dims'] ?? array() ),
			);
		}
		// Hidden down to nothing: the set is not offered at all. A required set
		// with no choice left would block the product for good, and an empty one
		// is chrome around nothing either way.
		if ( ! $options && ! $bb_kind_whole ) {
			continue;
		}
		// The measured rate cascades exactly like the choice photos and deltas:
		// the set carries the default, and a rate on this product's attachment
		// row wins here alone. Overlaid at the resolver, the one seam every
		// surface reads, so the page, the JS payload, the validation and the
		// cart all price from the same number without the measured module
		// knowing the feature exists.
		$bb_measure = (array) ( $set['measure'] ?? array() );
		if ( isset( $row['rate'] ) && '' !== $row['rate'] && 'measured' === (string) ( $set['kind'] ?? 'choices' ) ) {
			$bb_measure['rate'] = (float) $row['rate'];
		}
		// Modules ride the same seam (the one list every surface reads), with
		// the stored set and the product's own row both in hand for cascades.
		$bb_row = array(
			'id'        => $row['set'],
			'name'      => $set['name'],
			// The shopper-facing heading, when it differs from the library
			// name. Carried or it dies here (see the whitelist note below).
			'label'     => (string) ( $set['label'] ?? '' ),
			'required'  => ! empty( $row['required'] ),
			'when'      => is_array( $row['when'] ?? null ) ? $row['when'] : array(),
			'kind'      => (string) ( $set['kind'] ?? 'choices' ),
			'measure'   => $bb_measure,
			'table'     => (array) ( $set['table'] ?? array() ),
			'shape'     => (string) ( $set['shape'] ?? '' ),
			'pin_chips' => ! empty( $set['pin_chips'] ),
			// Absent means on (downgrade-safe): only an explicit false hides stock.
			'show_stock' => ! isset( $set['show_stock'] ) || ! empty( $set['show_stock'] ),
			// 🔴 This list is a WHITELIST, not a passthrough. A flag added to the
			// set editor and the sanitiser but not to this line is saved, shown
			// ticked in the admin, and then silently absent everywhere the
			// storefront reads it. Same downgrade-safe reading as show_stock:
			// absent means on, only an explicit false stops the swap.
			'photo_swaps' => ! isset( $set['photo_swaps'] ) || ! empty( $set['photo_swaps'] ),
			'photo_latest' => ! empty( $set['photo_latest'] ),
			'multi'     => ! empty( $set['multi'] ),
			'min'       => max( 0, (int) ( $set['min'] ?? 0 ) ),
			'max'       => max( 0, (int) ( $set['max'] ?? 0 ) ),
			'options'   => $options,
		);
		if ( ! empty( $row['lent'] ) ) {
			// Lent for one bundle row: whether the lender charges it once rides
			// with it, since the borrower's own record knows nothing of the set.
			$bb_row['lent_once'] = ! empty( $row['once'] );
		}
		$resolved[] = (array) apply_filters( 'addon_boss_resolved_set_row', $bb_row, $set, $row );
	}
	// A list a required size's part is priced by (glass by its thickness) is
	// required with it: the till already refuses that size until the list is
	// answered ("Please choose Thickness."), so offering it as "(optional)
	// None" left the size red, the bar naming the size, and Add to cart doing
	// nothing (walk 2, 28 Oct 2026). Read from the stored shape alone, like
	// the rate cascade above; what is charged does not change.
	$bb_rate_lists = array();
	foreach ( $resolved as $bb_r ) {
		if ( ! empty( $bb_r['required'] ) && 'measured' === (string) ( $bb_r['kind'] ?? '' ) ) {
			foreach ( (array) ( $bb_r['measure']['parts'] ?? array() ) as $bb_part ) {
				if ( ! empty( $bb_part['from']['set'] ) ) {
					$bb_rate_lists[ (string) $bb_part['from']['set'] ] = true;
				}
				// A list the part's sides follow (a profile by its Handle
				// side) is the same: the till asks for it with the size.
				if ( ! empty( $bb_part['sides']['set'] ) && 'edge' === (string) ( $bb_part['per'] ?? '' ) ) {
					$bb_rate_lists[ (string) $bb_part['sides']['set'] ] = true;
				}
			}
		}
	}
	if ( $bb_rate_lists ) {
		foreach ( $resolved as &$bb_r ) {
			if ( isset( $bb_rate_lists[ (string) $bb_r['id'] ] ) && 'choices' === (string) ( $bb_r['kind'] ?? '' ) && empty( $bb_r['multi'] ) ) {
				$bb_r['required'] = true;
			}
		}
		unset( $bb_r );
	}
	return $resolved;
}

// -----------------------------------------------------------------
// The cart snapshot contract
// -----------------------------------------------------------------

/**
 * Snapshot one pick against a RESOLVED set: the exact array the cart will
 * carry. Null when the key is not in the set — the server-side validation
 * building block (a DOM-invented key never reaches the cart).
 *
 * @return array{set:string,set_name:string,key:string,label:string,delta:float}|null
 */
function addon_boss_option_snapshot( array $resolved_set, string $key ): ?array {
	foreach ( (array) ( $resolved_set['options'] ?? array() ) as $opt ) {
		if ( ( $opt['key'] ?? '' ) === $key ) {
			return array(
				'set'      => (string) ( $resolved_set['id'] ?? '' ),
				'set_name' => addon_boss_set_shopper_name( $resolved_set ),
				'key'      => $key,
				'label'    => (string) $opt['label'],
				'delta'    => (float) $opt['delta'],
			);
		}
	}
	return null;
}

// =================================================================
// Form parsing — pure helpers so the save handlers stay testable
// =================================================================

/**
 * Assemble option rows from the editor form's parallel arrays. Rows arrive
 * in DOM order (the drag-reorder result). The hidden per-row key input is
 * what keeps keys STABLE through every admin round trip; a row without one
 * (a freshly added row) gets a generated key from the sanitiser.
 *
 * @param string[] $labels
 * @param string[] $keys
 * @param string[] $swatches
 * @param string[] $deltas
 * @return array[] raw option rows ready for addon_boss_sanitize_option_set()
 */
function addon_boss_option_rows_from_form( array $labels, array $keys, array $swatches, array $deltas, array $dims = array(), array $swatches2 = array(), array $descs = array(), array $stocks = array(), array $images = array() ): array {
	$rows = array();
	foreach ( array_values( $labels ) as $i => $label ) {
		$row_dims = array();
		foreach ( $dims as $dim_column ) {
			$row_dims[] = (string) ( array_values( (array) $dim_column )[ $i ] ?? '' );
		}
		$row = array(
			'label'   => (string) $label,
			'key'     => (string) ( array_values( $keys )[ $i ] ?? '' ),
			'swatch'  => (string) ( array_values( $swatches )[ $i ] ?? '' ),
			'swatch2' => (string) ( array_values( $swatches2 )[ $i ] ?? '' ),
			'desc'    => (string) ( array_values( $descs )[ $i ] ?? '' ),
			'delta'   => (string) ( array_values( $deltas )[ $i ] ?? '0' ),
			'dims'    => $row_dims,
			// The choice's own picture, carried by the SET, so a library set
			// built once (print positions, finishes, papers) takes its
			// pictures onto every product it is ever put on. A photo set
			// against the same choice on one product still wins there,
			// exactly as a price override does; this is the one underneath.
			'image_id' => absint( array_values( $images )[ $i ] ?? 0 ),
		);
		// Per-option stock: a blank box means unlimited (no key stored); a number
		// (including 0 = sold out) turns tracking on for this option.
		$bb_stock = trim( (string) ( array_values( $stocks )[ $i ] ?? '' ) );
		if ( '' !== $bb_stock && is_numeric( $bb_stock ) ) {
			$row['stock'] = max( 0, (int) $bb_stock );
		}
		$rows[] = $row;
	}
	return $rows;
}

/**
 * The settings each scheduling field type owns, so a build without the module
 * that draws them carries them through a save instead of wiping them.
 *
 * @var array<string,array<int,string>>
 */
const ADDON_BOSS_SCHEDULING_KEYS = array(
	'date' => array( 'prep_days', 'book_ahead', 'cutoff', 'closed_days', 'closed_dates', 'date_face', 'date_bands' ),
	'time' => array( 'time_open', 'time_close', 'time_step', 'time_face', 'time_bands' ),
);

/**
 * Sanitise a product attachment config from raw form arrays (also used by
 * the model's save function, so the two paths can never drift). Groups are
 * real containers: a group row carries its own child rows, so membership is
 * explicit and moving a group never sweeps up its neighbours.
 */
function addon_boss_sanitize_product_option_config( array $raw ): array {
	$clean      = array();
	$field_keys = array();
	// Set ids seen anywhere in this config, top level or inside a group, so one
	// set can only be on a product once however the rows are arranged.
	$set_ids    = array();
	foreach ( $raw as $row ) {
		if ( ! is_array( $row ) ) {
			continue;
		}
		// A GROUP row is a real container: a name and its own child rows (sets
		// and fields). Members belong to the group explicitly, never by
		// position, so moving a group never sweeps up its neighbours. A
		// 'collapsed' key from an older build is read nowhere and simply not
		// carried forward; how a group starts is the layout's call alone.
		if ( ( $row['row_type'] ?? '' ) === 'group' ) {
			$glabel   = sanitize_text_field( (string) ( $row['label'] ?? '' ) );
			$children = array();
			foreach ( (array) ( $row['children'] ?? array() ) as $child ) {
				if ( ! is_array( $child ) || ( $child['row_type'] ?? '' ) === 'group' ) {
					continue; // groups never nest inside groups.
				}
				$c = addon_boss_sanitize_option_row( $child, $field_keys, $set_ids );
				if ( $c ) {
					$children[] = $c;
				}
			}
			// A group keeps its children whether or not it is named; a nameless group
			// is a valid untitled section (no visible title on the front end). Only a
			// group that is BOTH nameless and empty is pointless, so that one is dropped.
			if ( '' === $glabel && ! $children ) {
				continue;
			}
			$bb_grow = array(
				'row_type' => 'group',
				'label'    => $glabel,
				'children' => $children,
			);
			// Repeatable GROUP: all fields in this group repeat together, as one
			// block per instance. Same keys, same whitelist, same ceiling and the
			// same discipline as a field's own repeat: stored WITHOUT asking
			// whether the plan is active, because gating the save would rewrite a
			// merchant's configuration the moment a licence lapsed. The capability
			// is asked where it can be honoured (the editor's panel and the
			// storefront), so a free build renders a plain section and leaves the
			// setting alone for the plan's return.
			$bb_grpt = (string) ( $row['repeat'] ?? '' );
			if ( in_array( $bb_grpt, array( 'add', 'per_item' ), true ) ) {
				$bb_grow['repeat'] = $bb_grpt;
				$bb_grmax          = (int) ( $row['repeat_max'] ?? 0 );
				if ( $bb_grmax > 0 ) {
					$bb_grow['repeat_max'] = min( ADDON_BOSS_REPEAT_CEILING, $bb_grmax );
				}
				$bb_grlabel = sanitize_text_field( (string) ( $row['repeat_label'] ?? '' ) );
				if ( '' !== $bb_grlabel ) {
					$bb_grow['repeat_label'] = $bb_grlabel;
				}
			}
			// The section's own rule: at least one answer anywhere inside it. Only
			// the one value exists; anything else stores nothing, so a section
			// saved before this control reads as no rule. The shop's own sentence
			// rides with it, bounded; empty means the plugin's default.
			if ( 1 === (int) ( $row['min_pick'] ?? 0 ) ) {
				$bb_grow['min_pick'] = 1;
				$bb_gmsg             = mb_substr( sanitize_text_field( (string) ( $row['min_msg'] ?? '' ) ), 0, 200 );
				if ( '' !== $bb_gmsg ) {
					$bb_grow['min_msg'] = $bb_gmsg;
				}
			}
			$clean[] = $bb_grow;
			continue;
		}
		$c = addon_boss_sanitize_option_row( $row, $field_keys, $set_ids );
		if ( $c ) {
			$clean[] = $c;
		}
	}

	// Conditions second pass over EVERY row (top-level and group children). The
	// attached-set list is flattened so a rule may point at a set inside a group.
	// The reveal module validates the rules through this seam; with nothing
	// hooked, a stored rule rides through exactly as it stands.
	$attached = array();
	foreach ( addon_boss_flatten_option_config( $clean ) as $r ) {
		if ( isset( $r['set'] ) ) {
			$attached[] = (string) $r['set'];
		}
	}
	return (array) apply_filters( 'addon_boss_sanitize_option_rows', $clean, $attached );
}

/**
 * Flatten a (possibly grouped) config into a plain list of set/field rows,
 * unwrapping group containers so the MONEY + resolve paths see every row
 * regardless of nesting. A field or set inside a group is priced and captured
 * exactly as a top-level one; grouping is presentation only.
 */
function addon_boss_flatten_option_config( array $config ): array {
	$flat = array();
	foreach ( $config as $row ) {
		if ( ( $row['row_type'] ?? '' ) === 'group' ) {
			foreach ( (array) ( $row['children'] ?? array() ) as $child ) {
				$flat[] = $child;
			}
		} else {
			$flat[] = $row;
		}
	}
	return $flat;
}

/**
 * Flatten a grouped config into a render sequence with explicit group_open /
 * group_close markers, so the storefront render walks one flat list yet still
 * knows each section's exact boundaries (never guessing by position).
 */
function addon_boss_config_render_sequence( array $config ): array {
	$seq = array();
	foreach ( $config as $row ) {
		if ( ( $row['row_type'] ?? '' ) === 'group' ) {
			// The whole group row rides the marker, so a module that draws a
			// group AS a unit (a repeatable group) can see everything the group
			// carries without a second walk.
			$seq[] = array(
				'row_type' => 'group_open',
				'label'    => (string) ( $row['label'] ?? '' ),
				'group'    => $row,
			);
			foreach ( (array) ( $row['children'] ?? array() ) as $child ) {
				$seq[] = $child;
			}
			$seq[] = array( 'row_type' => 'group_close' );
		} else {
			$seq[] = $row;
		}
	}
	return $seq;
}

/**
 * The sentence a shopper meets when a section's "pick at least one" rule is not
 * met and the shop wrote none of its own.
 */
function addon_boss_section_min_default_message(): string {
	return __( 'Please choose at least one option in this section.', 'addon-boss' );
}

/**
 * Is a section's "pick at least one" rule met by these answers?
 *
 * Only the questions on show count: a question a rule has hidden can neither
 * meet the rule nor be owed by it, and a section whose every question is hidden
 * asks for nothing (choose "Blank garments" and the print section has nothing to
 * say). Each question keeps its own Optional / Required, which this never
 * touches; it only adds "at least one answer across these".
 *
 * A section that repeats (one block per shirt) is judged per copy, because each
 * copy is its own order line in the shopper's head: a set's answer is shared by
 * every copy, a field's answer belongs to the copy it was typed into.
 *
 * Any answer counts, a free one included. Whether "No print" means nothing is
 * the shop's wording, and the plugin never reads meaning into a name.
 *
 * @param array $config The product's stored option config (groups intact).
 * @param array $picks  Set id => picked key or keys; field rule ids => answer.
 * @param array $active Same keys => whether the question is on show.
 * @param mixed $posted What the request carries under bb_pf (field answers).
 * @return WP_Error|null The shop's sentence for the first unmet section, or null.
 */
function addon_boss_section_min_unmet( array $config, array $picks, array $active, $posted = null ) {
	$bb_posted = is_array( $posted ) ? $posted : array();
	foreach ( $config as $bb_row ) {
		if ( 'group' !== ( $bb_row['row_type'] ?? '' ) || empty( $bb_row['min_pick'] ) ) {
			continue;
		}
		$bb_shown_any = false;
		$bb_set_said  = false;
		$bb_fields    = array();
		foreach ( (array) ( $bb_row['children'] ?? array() ) as $bb_child ) {
			if ( isset( $bb_child['set'] ) ) {
				$bb_id = (string) $bb_child['set'];
				if ( ! array_key_exists( $bb_id, $picks ) || ! ( $active[ $bb_id ] ?? true ) ) {
					continue; // not on this product any more, or hidden by a rule.
				}
				$bb_shown_any = true;
				$bb_ans       = $picks[ $bb_id ];
				if ( is_array( $bb_ans ) ? (bool) array_filter( $bb_ans, 'strlen' ) : '' !== (string) $bb_ans ) {
					$bb_set_said = true;
				}
				continue;
			}
			$bb_key = (string) ( $bb_child['field']['key'] ?? '' );
			if ( '' === $bb_key || ! defined( 'ADDON_BOSS_FIELD_RULE_KEY' ) ) {
				continue;
			}
			if ( ! ( $active[ ADDON_BOSS_FIELD_RULE_KEY . $bb_key ] ?? true ) ) {
				continue;
			}
			$bb_shown_any       = true;
			$bb_fields[ $bb_key ] = $bb_posted[ $bb_key ] ?? null;
		}
		if ( ! $bb_shown_any || $bb_set_said ) {
			continue;
		}

		// No set answered, so the fields must. One block, or one per copy when
		// the section repeats; a copy is a numbered entry under each field.
		$bb_copies = array( null );
		if ( in_array( (string) ( $bb_row['repeat'] ?? '' ), array( 'add', 'per_item' ), true ) ) {
			$bb_n = 0;
			foreach ( $bb_fields as $bb_raw ) {
				if ( is_array( $bb_raw ) && ! array_diff_key( $bb_raw, array_fill( 0, count( $bb_raw ), 1 ) ) ) {
					$bb_n = max( $bb_n, count( $bb_raw ) );
				}
			}
			$bb_copies = $bb_n > 0 ? range( 0, $bb_n - 1 ) : array( null );
		}
		foreach ( $bb_copies as $bb_i ) {
			$bb_said = false;
			foreach ( $bb_fields as $bb_raw ) {
				$bb_val = ( null !== $bb_i && is_array( $bb_raw ) ) ? ( $bb_raw[ $bb_i ] ?? '' ) : $bb_raw;
				if ( '' !== addon_boss_field_rule_value( $bb_val ) ) {
					$bb_said = true;
					break;
				}
			}
			if ( ! $bb_said ) {
				$bb_msg = (string) ( $bb_row['min_msg'] ?? '' );
				return new WP_Error( 'bundle_boss', '' !== $bb_msg ? $bb_msg : addon_boss_section_min_default_message() );
			}
		}
	}
	return null;
}

/**
 * The product's "pick at least one" sections, handed to the page as data so the
 * browser can say so at the section before the server has to refuse the add.
 * Each section lists its questions by the names the page already uses for them
 * (a set by its data-attribute, a field by its key) and carries the shop's own
 * sentence, defaulted. Empty when no section has the rule, so every other
 * product prints exactly what it printed before.
 *
 * @param WC_Product $product The product being rendered.
 * @return string A ready attribute (leading space) or ''.
 */
function addon_boss_section_rules_attr( $product ): string {
	if ( ! $product instanceof WC_Product ) {
		return '';
	}
	$bb_rules = array();
	foreach ( addon_boss_product_option_config( $product ) as $bb_row ) {
		if ( 'group' !== ( $bb_row['row_type'] ?? '' ) || empty( $bb_row['min_pick'] ) ) {
			continue;
		}
		$bb_members = array();
		foreach ( (array) ( $bb_row['children'] ?? array() ) as $bb_child ) {
			if ( isset( $bb_child['set'] ) ) {
				$bb_members[] = array( 's' => addon_boss_standalone_field_name( (string) $bb_child['set'] ) );
			} elseif ( '' !== (string) ( $bb_child['field']['key'] ?? '' ) ) {
				$bb_members[] = array( 'f' => (string) $bb_child['field']['key'] );
			}
		}
		if ( ! $bb_members ) {
			continue;
		}
		$bb_msg     = (string) ( $bb_row['min_msg'] ?? '' );
		$bb_rules[] = array(
			'm'   => $bb_members,
			'msg' => '' !== $bb_msg ? $bb_msg : addon_boss_section_min_default_message(),
		);
	}
	if ( ! $bb_rules ) {
		return '';
	}
	// The bar above an owed section names its questions as buttons that jump
	// to each one; this is the word in front of them.
	return ' data-bb-sections="' . esc_attr( (string) wp_json_encode( $bb_rules ) ) . '"'
		. ' data-bb-sec-any="' . esc_attr__( 'Any one of:', 'addon-boss' ) . '"';
}

/**
 * The "pick at least one" section each set sits in, by set id: the section's
 * place in the config as its id, its label, and the shop's sentence
 * (defaulted). Only sections carrying the rule are listed, so a product with
 * none hands over nothing new. An asker that puts the product's questions
 * somewhere else (a bundle) holds the same rule across them with this.
 *
 * @param WC_Product|null $product The product.
 * @return array<string,array{id:string,label:string,msg:string}>
 */
function addon_boss_section_rules_by_set( $product ): array {
	if ( ! $product instanceof WC_Product ) {
		return array();
	}
	$bb_out = array();
	foreach ( array_values( addon_boss_product_option_config( $product ) ) as $bb_i => $bb_row ) {
		if ( 'group' !== ( $bb_row['row_type'] ?? '' ) || empty( $bb_row['min_pick'] ) ) {
			continue;
		}
		$bb_msg = (string) ( $bb_row['min_msg'] ?? '' );
		$bb_sec = array(
			'id'    => 'sec' . $bb_i,
			'label' => (string) ( $bb_row['label'] ?? '' ),
			'msg'   => '' !== $bb_msg ? $bb_msg : addon_boss_section_min_default_message(),
		);
		foreach ( (array) ( $bb_row['children'] ?? array() ) as $bb_child ) {
			if ( isset( $bb_child['set'] ) ) {
				$bb_out[ (string) $bb_child['set'] ] = $bb_sec;
			}
		}
	}
	return $bb_out;
}

/**
 * Sanitise ONE set-or-field row into its clean stored shape, or null to drop
 * it. Field keys stay unique across the whole product ($field_keys by ref, so
 * top-level and grouped fields never collide). This is the exact field/set
 * logic the money-tested path has always used, lifted out so a group can reuse
 * it for its children.
 *
 * @return array|null
 */
function addon_boss_sanitize_option_row( array $row, array &$field_keys, array &$set_ids = array() ) {
	// A FIELD row: reuse the personalisation field-def sanitiser wholesale.
	if ( ( $row['row_type'] ?? '' ) === 'field' || is_array( $row['field'] ?? null ) ) {
		if ( ! function_exists( 'addon_boss_personalisation_sanitize_field_defs' ) ) {
			return null; // personalisation engine off: field rows do not persist.
		}
		$defs = addon_boss_personalisation_sanitize_field_defs( array( (array) ( $row['field'] ?? array() ) ) );
		if ( ! $defs ) {
			return null; // no label or unknown type: drop the row.
		}
		$field = $defs[0];
		$base  = $field['key'];
		$n     = 2;
		while ( in_array( $field['key'], $field_keys, true ) ) {
			$field['key'] = $base . '-' . $n++;
		}
		$field_keys[] = $field['key'];
		return array(
			'row_type' => 'field',
			'field'    => $field,
			'when'     => is_array( $row['when'] ?? null ) ? $row['when'] : array(),
		);
	}
	// A SET row: unchanged from before (the money-tested path).
	if ( ! addon_boss_option_key_valid( $row['set'] ?? '' ) ) {
		return null;
	}
	// One row per set. Two rows for the same set share a field name, so the
	// second silently eats the first and the merchant ends up with one answer
	// where they configured two. The first placement wins, which is where they
	// put it; the copy simply does not exist. The picker refuses the click
	// too, but a stale form or a folder taken twice still arrives here.
	if ( in_array( (string) $row['set'], $set_ids, true ) ) {
		return null;
	}
	$set_ids[] = (string) $row['set'];
	$deltas = array();
	foreach ( (array) ( $row['deltas'] ?? array() ) as $key => $val ) {
		if ( ! addon_boss_option_key_valid( $key ) || '' === $val || null === $val ) {
			continue; // absence = use the set default; explicit 0 stays.
		}
		// Read as the set editor reads a choice's price: "2,50" is 2.50.
		$deltas[ $key ] = (float) addon_boss_typed_amount( $val );
	}
	$images = array();
	foreach ( (array) ( $row['images'] ?? array() ) as $key => $att ) {
		$att = absint( $att );
		if ( ! addon_boss_option_key_valid( $key ) || ! $att ) {
			continue; // 0 = no photo (the cleared state), same absence rule as deltas.
		}
		$images[ $key ] = $att;
	}
	// Which of the shared set's choices this product does not offer. Stored as
	// what is HIDDEN, never as what is allowed: a set is shared on purpose, and
	// an allow-list would mean every product silently refusing the colour the
	// set gains next month. A key the set no longer carries is harmless (the
	// resolver matches by key), so nothing has to be pruned when a set changes.
	$hide = array();
	foreach ( (array) ( $row['hide'] ?? array() ) as $key => $val ) {
		// Accepts both shapes: the panel posts key => 1, an import or a
		// programmatic save reads more naturally as a plain list of keys.
		$bb_k = is_string( $key ) ? $key : $val;
		if ( ! is_string( $bb_k ) || ! addon_boss_option_key_valid( $bb_k ) || ! $val ) {
			continue;
		}
		if ( ! in_array( $bb_k, $hide, true ) ) {
			$hide[] = $bb_k;
		}
	}
	// A measured set's per-product rate. Empty = no override, the set's own
	// rate stands (the same absence rule as the deltas above); an explicit 0
	// is a real value, still floored by the set's minimum charge. Junk and
	// negatives are NOT overrides: wc_format_decimal turns word salad into '',
	// and a negative rate would be a negative price path, so both fall back to
	// the set. The '' state is stored, not omitted, so a saved row always
	// carries the key and true absence keeps meaning "row from before this".
	$bb_rate = trim( (string) ( $row['rate'] ?? '' ) );
	if ( '' !== $bb_rate ) {
		$bb_fmt  = wc_format_decimal( $bb_rate );
		$bb_rate = ( '' !== $bb_fmt && is_numeric( $bb_fmt ) && (float) $bb_fmt >= 0 ) ? (float) $bb_fmt : '';
	}
	// Modules carry their own per-row keys through the same pass, so a row
	// never stores a key nothing cleaned.
	return (array) apply_filters( 'addon_boss_sanitize_set_row', array(
		'set'        => (string) $row['set'],
		'required'   => ! empty( $row['required'] ),
		'deltas'     => $deltas,
		'images'     => $images,
		'hide'       => $hide,
		'rate'       => $bb_rate,
		// Which library folder this set arrived from, when it came in with the
		// rest of its folder rather than on its own. Nothing reads it to decide
		// anything today; it is the record a later "this folder gained a set,
		// add it here too" nudge needs, and it costs one string to keep.
		'from_group' => sanitize_text_field( (string) ( $row['from_group'] ?? '' ) ),
		'when'       => is_array( $row['when'] ?? null ) ? $row['when'] : array(),
	), $row );
}

/**
 * Which resolved sets are ACTIVE for one pick state. A set with no rule is
 * active. A set carrying a reveal rule starts inactive and resolves through
 * the module that evaluates such rules; with no evaluator registered a rule
 * was already wiped on read, so everything simply shows. Hidden means INERT
 * everywhere: never required of the shopper, never charged. That is the
 * server-side discipline the whole category keeps re-patching the lack of
 * (hidden fields still charging, hidden required fields blocking checkout,
 * in rival changelogs for years).
 *
 * @param array<int,array>     $sets  Resolved sets carrying 'when'.
 * @param array<string,string> $picks Set id => currently picked option key.
 * @return array<string,bool> Set id => active.
 */
function addon_boss_active_option_sets( array $sets, array $picks ): array {
	$active = array();
	foreach ( $sets as $set ) {
		// A HIDE rule starts the other way round: the set is there until its
		// conditions fire, so it seeds ACTIVE and the module that evaluates
		// rules turns it off. Seeding it inactive like a show rule would leave
		// a hide-ruled set permanently gone, since the activation pass only
		// ever turns things on.
		$bb_when              = (array) ( $set['when'] ?? array() );
		$active[ $set['id'] ] = ! $bb_when || 'hide' === (string) ( $bb_when['act'] ?? '' );
	}
	return (array) apply_filters( 'addon_boss_active_option_sets', $active, $sets, $picks );
}

// =================================================================
// Synthetic variation axes + per-item resolver: the optioned-simple
// engine both surfaces render from (virtual axes + render-seam
// filters), plus the per-item set resolver that virtual_axes calls.
// The cartesian entry list built on those axes is the grid module's.
// =================================================================

/**
 * The product's sets AS THEY APPLY IN ONE BUNDLE ROW. Same shape as
 * addon_boss_product_option_sets(), then narrowed by the item's per-row
 * restrictions ($item['option_restrictions'] = { set_id => { off, options } }):
 * a set switched OFF for this row is dropped, and a set whose options are
 * restricted keeps only the chosen ones (an empty result drops the set too).
 * No restrictions ($item null or empty) returns the product-level sets
 * unchanged, so every existing call site behaves exactly as before.
 *
 * A row may lend the product sets it does not carry ($item['also_sets']):
 * they join its own for this row only, and are narrowed like them.
 */
function addon_boss_product_option_sets_for_item( $product, $item = null ): array {
	$sets = addon_boss_product_option_sets( $product, addon_boss_item_lent_rows( $product, $item ) );
	$rx   = is_array( $item ) ? (array) ( $item['option_restrictions'] ?? array() ) : array();
	if ( ! $rx ) {
		return $sets;
	}
	$out = array();
	foreach ( $sets as $set ) {
		$rule = (array) ( $rx[ $set['id'] ] ?? array() );
		if ( ! empty( $rule['off'] ) ) {
			continue; // this bundle does not offer the set.
		}
		$allow = array_filter( array_map( 'strval', (array) ( $rule['options'] ?? array() ) ) );
		if ( $allow ) {
			$set['options'] = array_values(
				array_filter(
					$set['options'],
					static function ( $opt ) use ( $allow ) {
						return in_array( (string) $opt['key'], $allow, true );
					}
				)
			);
			if ( ! $set['options'] ) {
				continue; // restricted to nothing = not offered.
			}
		}
		$out[] = $set;
	}
	return $out;
}

/**
 * The sets one bundle row lends a product it does not carry anywhere else,
 * as attachment rows: in a kit where the polo and the tee ask the same print
 * and a third garment asks nothing like it, the shop can have the third asked
 * the same print in that kit alone. The asker names each set by id, with
 * whether it is required and the rule it shows by, as the products that
 * carry it ask it.
 *
 * A lent row carries no charges or pictures of its own, so the set's own
 * prices and pictures apply. A set the product already carries is its own,
 * with its own prices, and is not lent.
 *
 * @param WC_Product|mixed $product The product.
 * @param array|null       $item    The row, with 'also_sets' => set id => {required, when}.
 * @return array<int,array{set:string,required:bool,when:array}>
 */
function addon_boss_item_lent_rows( $product, $item ): array {
	$lent = is_array( $item ) ? (array) ( $item['also_sets'] ?? array() ) : array();
	if ( ! $lent || ! $product instanceof WC_Product ) {
		return array();
	}
	$own = array();
	foreach ( addon_boss_flatten_option_config( addon_boss_product_option_config( $product ) ) as $row ) {
		if ( isset( $row['set'] ) ) {
			$own[ (string) $row['set'] ] = true;
		}
	}
	$rows = array();
	foreach ( $lent as $sid => $how ) {
		$sid = sanitize_key( (string) $sid );
		if ( '' === $sid || isset( $own[ $sid ] ) ) {
			continue;
		}
		$how    = (array) $how;
		$rows[] = array(
			'set'      => $sid,
			'required' => ! empty( $how['required'] ),
			'when'     => is_array( $how['when'] ?? null ) ? $how['when'] : array(),
			'lent'     => true,
			// The lender's own page charges it once per order; so does the
			// borrower here, or a setup fee lands on every garment.
			'once'     => ! empty( $how['once'] ),
		);
	}
	return $rows;
}

/**
 * True when a row's rule is an answer the shop set for the shopper ("Set by
 * you" in a bundle): one answer or several, not switched off. The item
 * resolver above narrows such a set to those answers like any restriction;
 * what changes is that nobody is asked it. Every unit carries all of them and
 * every price includes all of them.
 *
 * Several answers from one question is the shop's call, even where the
 * product's own page lets a shopper pick only one: a workwear kit can come
 * with left and right breast embroidery from a "Front" question that asks
 * for one position at a time.
 *
 * A rule without the flag is the released narrowing, one answer or many,
 * and is read exactly as before.
 */
function addon_boss_rule_is_fixed( array $rule ): bool {
	return ! empty( $rule['fixed'] )
		&& empty( $rule['off'] )
		&& count( addon_boss_rule_fixed_keys( $rule ) ) >= 1;
}

/**
 * The answers a fixed rule sets, in the order the shop gave them, each once.
 *
 * @param array $rule A row's rule for one set.
 * @return string[]
 */
function addon_boss_rule_fixed_keys( array $rule ): array {
	return array_values( array_unique( array_filter( array_map( 'strval', (array) ( $rule['options'] ?? array() ) ) ) ) );
}

/**
 * The answers the shop set for this product in one row: set id => the set,
 * its first answer and every answer, read through the same item resolver as
 * every question. An answer this product hides, or a set it does not carry,
 * is simply not here, which is how the asking plugin learns the product
 * cannot take it. A set the shop gave several answers is here only when the
 * product carries every one of them: carrying fewer would sell the kit
 * without part of what the bundle promised.
 *
 * `option` is the first answer, for a reader that knows only one. `options`
 * is all of them, in the shop's order; `delta` is what they add together.
 *
 * `once` is true when the product's own page charges the answer once per
 * order: it is then in no unit's price, and whoever sells the units takes it
 * once.
 *
 * @return array<string,array{set:array,option:array,options:array[],delta:float,once:bool}>
 */
function addon_boss_fixed_answer_options( $product, $item = null ): array {
	if ( ! $product instanceof WC_Product || $product->is_type( 'variable' ) ) {
		return array();
	}
	$rx    = is_array( $item ) ? (array) ( $item['option_restrictions'] ?? array() ) : array();
	$fixed = array();
	foreach ( $rx as $sid => $rule ) {
		if ( addon_boss_rule_is_fixed( (array) $rule ) ) {
			$fixed[ (string) $sid ] = addon_boss_rule_fixed_keys( (array) $rule );
		}
	}
	if ( ! $fixed ) {
		return array();
	}
	$out = array();
	foreach ( addon_boss_product_option_sets_for_item( $product, $item ) as $set ) {
		$sid = (string) $set['id'];
		if ( ! isset( $fixed[ $sid ] ) || 'choices' !== ( $set['kind'] ?? 'choices' ) || empty( $set['options'][0] ) ) {
			continue;
		}
		// The resolver narrowed the set to the shop's answers; put them in the
		// shop's order, and refuse the set unless every one is still there.
		$by_key = array();
		foreach ( (array) $set['options'] as $opt ) {
			$by_key[ (string) ( $opt['key'] ?? '' ) ] = $opt;
		}
		$opts = array();
		foreach ( $fixed[ $sid ] as $key ) {
			if ( isset( $by_key[ $key ] ) ) {
				$opts[] = $by_key[ $key ];
			}
		}
		if ( ! $opts || count( $opts ) !== count( $fixed[ $sid ] ) ) {
			continue;
		}
		$out[ $sid ] = array(
			'set'     => $set,
			'option'  => $opts[0],
			'options' => $opts,
			'delta'   => (float) array_sum( array_map( static fn( $o ) => (float) ( $o['delta'] ?? 0 ), $opts ) ),
			'once'    => ! empty( $set['lent_once'] ) || ( function_exists( 'addon_boss_grid_set_charged_once' ) && addon_boss_grid_set_charged_once( $product, $sid ) ),
		);
	}
	if ( is_array( $item ) && ! empty( $item['with_hidden'] ) ) {
		return $out; // the asker wants the ones behind a rule not met yet as well.
	}
	return addon_boss_fixed_answers_revealed( $product, $rx, $out, addon_boss_item_lent_rows( $product, $item ) );
}

/**
 * Hidden means inert, for an answer the shop set as much as for a pick.
 *
 * A set behind a rule is on the product's own page only while its trigger
 * is answered the way the rule says. An answer the shop set on such a set is
 * honoured on the same terms: its trigger must itself be set, to an answer
 * that reveals it. A trigger that is asked (nobody has answered it yet), or
 * one this row switches off, reveals nothing, and the answer behind it is
 * dropped: not asked, not carried, not charged. A chain is read link by link
 * until it settles, so an answer revealed through a link that is itself
 * hidden is dropped too.
 *
 * @param WC_Product            $product The product.
 * @param array<string,array>   $rx      The row's rules, set id => rule.
 * @param array<string,array>   $fixed   The answers the shop set, as addon_boss_fixed_answer_options() builds them.
 * @param array                 $lent    Sets the row lends the product (addon_boss_item_lent_rows()), on its roster too.
 * @return array<string,array> The answers whose rules are met.
 */
function addon_boss_fixed_answers_revealed( $product, array $rx, array $fixed, array $lent = array() ): array {
	if ( ! $fixed || ! function_exists( 'addon_boss_when_met' ) ) {
		return $fixed;
	}
	$bb_gated = array();
	foreach ( $fixed as $sid => $one ) {
		$bb_when = (array) ( $one['set']['when'] ?? array() );
		if ( $bb_when && ( ! function_exists( 'addon_boss_when_runs_here' ) || addon_boss_when_runs_here( $bb_when ) ) ) {
			$bb_gated[ $sid ] = $bb_when;
		}
	}
	if ( ! $bb_gated ) {
		return $fixed;
	}
	// The roster is every set on the product: one this row switches off is on
	// it but answers nothing, exactly as a hidden trigger does on the page.
	$bb_active = array();
	foreach ( addon_boss_product_option_sets( $product, $lent ) as $set ) {
		$bb_active[ (string) $set['id'] ] = empty( $rx[ $set['id'] ]['off'] );
	}
	for ( $bb_pass = 0; $bb_pass <= count( $bb_gated ); $bb_pass++ ) {
		$bb_picks = array();
		foreach ( $fixed as $sid => $one ) {
			// Every answer the shop set: "is" reads "is among the answers".
			$bb_picks[ $sid ] = array_map( static fn( $o ) => (string) ( $o['key'] ?? '' ), (array) ( $one['options'] ?? array( $one['option'] ) ) );
		}
		$bb_dropped = false;
		foreach ( $bb_gated as $sid => $bb_when ) {
			if ( isset( $fixed[ $sid ] ) && ! addon_boss_when_met( $bb_when, $bb_picks, $bb_active ) ) {
				unset( $fixed[ $sid ] );
				$bb_active[ $sid ] = false; // hidden: it reveals nothing further down the chain.
				$bb_dropped        = true;
			}
		}
		if ( ! $bb_dropped ) {
			break;
		}
	}
	return $fixed;
}

// =================================================================
// SYNTHETIC VARIATIONS: an optioned simple product enters the EXISTING
// variation front end (chips, all-the-same, cards, table, grid) through
// virtual attributes + virtual variation entries. Nothing touches the
// database; picks resolve server-side by stable option KEYS, and the
// virtual variation id is display plumbing only (negative, never loaded).
// =================================================================

/** The virtual attribute name for a set (field: attribute_bbset-<set id>). */
function addon_boss_virtual_attr_name( string $set_id ): string {
	return 'bbset-' . $set_id;
}

/** True when a product renders per-unit choices (real variations or sets). */
function addon_boss_product_has_unit_choices( $product ): bool {
	return $product instanceof WC_Product
		&& ( $product->is_type( 'variable' ) || (bool) addon_boss_product_option_sets( $product ) );
}

/**
 * Virtual axes for the render: attribute name => option KEYS (stable),
 * with label + swatch lookups the render seams consume.
 *
 * @return array<string,array{options:string[],labels:array<string,string>,swatches:array<string,string>,set:array}>
 */
function addon_boss_virtual_axes( $product, $item = null, $only_sets = null, bool $with_rules = false, bool $with_multi = false ): array {
	// Synthetic variations exist to give an optioned SIMPLE the native
	// variation front end. A variable product HAS real variations; its sets
	// render on its own page (the standalone path), never as virtual axes,
	// so every virtual consumer (unit cards, grids, box cards, candidate
	// maps) stays untouched by sets on variables through this one gate.
	if ( $product instanceof WC_Product && $product->is_type( 'variable' ) ) {
		return array();
	}
	// $only_sets (an allowlist of set ids) narrows the axes to a chosen few. The
	// quantity grid uses it to keep the matrix to colour x size, leaving any
	// further set to render as a whole-order choice instead of a cartesian cell.
	$only    = is_array( $only_sets ) ? array_map( 'strval', $only_sets ) : null;
	$rx      = is_array( $item ) ? (array) ( $item['option_restrictions'] ?? array() ) : array();
	$axes    = array();
	$bb_secs = addon_boss_section_rules_by_set( $product );
	foreach ( addon_boss_product_option_sets_for_item( $product, $item ) as $set ) {
		if ( addon_boss_rule_is_fixed( (array) ( $rx[ $set['id'] ] ?? array() ) ) ) {
			continue; // the shop answered it: carried by every unit, never asked.
		}
		if ( 'choices' !== ( $set['kind'] ?? 'choices' ) ) {
			// A kind priced by a continuous dimension (no finite option list)
			// cannot be a cartesian axis. Only the engine's own choices kind
			// qualifies; everything else lives on the product's own page.
			continue;
		}
		$bb_multi = ! empty( $set['multi'] );
		if ( $bb_multi && ! $with_multi ) {
			// A several-of set is no cartesian axis either: a unit is one of
			// each axis, never two. An asker that puts the question itself,
			// once, and takes several answers back ($with_multi) may have it,
			// marked, as a question rather than an axis.
			continue;
		}
		$bb_when = array();
		if ( ! empty( $set['when'] ) ) {
			// A conditional set may be hidden, so it is never a cartesian axis
			// either. An asker that puts the question itself, once, and shows
			// or hides it as its trigger is answered may have it WITH its rule
			// ($with_rules), as long as the rule reads only this product's own
			// pick-one sets; a rule on a field, or one this build does not
			// evaluate, keeps the set on the product's own page as before.
			$bb_rule = $with_rules ? addon_boss_virtual_axis_rule( $set['when'] ) : null;
			if ( null === $bb_rule ) {
				continue;
			}
			$bb_when = $bb_rule;
		}
		if ( null !== $only && ! in_array( (string) $set['id'], $only, true ) ) {
			continue; // not one of the chosen matrix sets.
		}
		$labels    = array();
		$swatches  = array();
		$swatches2 = array();
		$images    = array();
		$keys      = array();
		foreach ( $set['options'] as $opt ) {
			$keys[]                   = $opt['key'];
			$labels[ $opt['key'] ]    = $opt['label'];
			$swatches[ $opt['key'] ]  = $opt['swatch'];
			$swatches2[ $opt['key'] ] = $opt['swatch2'] ?? '';
			$images[ $opt['key'] ]    = (int) ( $opt['image_id'] ?? 0 );
		}
		$axes[ addon_boss_virtual_attr_name( $set['id'] ) ] = array(
			'options'   => $keys,
			'labels'    => $labels,
			'swatches'  => $swatches,
			'swatches2' => $swatches2,
			'images'    => $images,
			'set'       => $set,
		);
		if ( $bb_multi ) {
			$axes[ addon_boss_virtual_attr_name( $set['id'] ) ]['multi'] = true;
		}
		if ( $bb_when ) {
			// The rule in the canonical shape, every condition naming one of
			// this product's sets, for the asker to show or hide the question by.
			$axes[ addon_boss_virtual_attr_name( $set['id'] ) ]['when'] = $bb_when;
		}
		if ( isset( $bb_secs[ (string) $set['id'] ] ) ) {
			// The "pick at least one" section the set sits in, so an asker that
			// puts the question elsewhere holds the rule across the same sets.
			$axes[ addon_boss_virtual_attr_name( $set['id'] ) ]['section'] = $bb_secs[ (string) $set['id'] ];
		}
	}
	return $axes;
}

/**
 * A set's reveal rule as an asker can read it: act + groups of conditions,
 * each naming one of the product's SETS and an answer to it. Null when the
 * rule is not of that shape (a condition on a field, which an asker drawing
 * the sets alone cannot see) and an empty array when this build does not
 * evaluate the rule at all, in which case the set simply shows, here as on
 * the product's own page.
 *
 * @param mixed $when The stored rule, any shape.
 * @return array|null The {act,groups} shape, or null for a rule an asker cannot read.
 */
function addon_boss_virtual_axis_rule( $when ): ?array {
	if ( function_exists( 'addon_boss_when_runs_here' ) && ! addon_boss_when_runs_here( $when ) ) {
		return array(); // not evaluated in this build: unconditional here too.
	}
	$bb_norm = addon_boss_when_to_groups( $when );
	if ( empty( $bb_norm['groups'] ) ) {
		return array();
	}
	foreach ( $bb_norm['groups'] as $bb_group ) {
		foreach ( $bb_group as $bb_cond ) {
			if ( '' === (string) ( $bb_cond['set'] ?? '' )
				|| ! in_array( (string) ( $bb_cond['op'] ?? '' ), array( 'is', 'is_not', 'is_any', 'filled', 'empty' ), true ) ) {
				return null;
			}
		}
	}
	return $bb_norm;
}

// The render seams: pretty labels + real swatches for virtual attributes,
// and a human name for the attribute heading.
add_filter( 'addon_boss_attr_option_labels', 'addon_boss_virtual_option_labels', 10, 3 );
add_filter( 'addon_boss_attr_option_swatches', 'addon_boss_virtual_option_swatches', 10, 3 );
// The CROSS-PLUGIN seam keeps BundleBoss's names. BundleBoss draws a bundle
// component's axes and asks bundle_boss_attr_option_labels / _swatches for
// the pretty words and the real colours, whoever answers: the family
// surface's shape, BB asks and whichever plugin owns the sets replies. The
// namespace sweep renamed the providers along with everything else, which
// unhooked them from their only caller and left an answered component's
// chips printing raw op_* keys. The SAME callbacks answer both spellings;
// the addon_boss_* pair above stays for surfaces of our own.
add_filter( 'bundle_boss_attr_option_labels', 'addon_boss_virtual_option_labels', 10, 3 );
add_filter( 'bundle_boss_attr_option_swatches', 'addon_boss_virtual_option_swatches', 10, 3 );
add_filter( 'woocommerce_attribute_label', 'addon_boss_virtual_attribute_label', 10, 2 );

function addon_boss_virtual_option_labels( $labels, $attr_name, $item_product ) {
	if ( 0 === strpos( (string) $attr_name, 'bbset-' ) && $item_product instanceof WC_Product ) {
		$axes = addon_boss_virtual_axes( $item_product );
		if ( isset( $axes[ $attr_name ] ) ) {
			return $axes[ $attr_name ]['labels'];
		}
	}
	return $labels;
}

function addon_boss_virtual_option_swatches( $swatches, $attr_name, $item_product ) {
	if ( 0 === strpos( (string) $attr_name, 'bbset-' ) && $item_product instanceof WC_Product ) {
		$axes = addon_boss_virtual_axes( $item_product );
		if ( isset( $axes[ $attr_name ] ) ) {
			return array_filter( $axes[ $attr_name ]['swatches'] );
		}
	}
	return $swatches;
}

function addon_boss_virtual_attribute_label( $label, $name ) {
	if ( 0 === strpos( (string) $name, 'bbset-' ) ) {
		$set = addon_boss_option_set( substr( (string) $name, 6 ) );
		if ( $set && '' !== addon_boss_set_shopper_name( $set ) ) {
			return addon_boss_set_shopper_name( $set );
		}
	}
	return $label;
}

// =================================================================
// Griddability: whether this product's own page shows the quantity
// grid at all. The grid itself (the matrix, the set split, its save)
// is the grid module's; the engine keeps only the gate it asks.
// =================================================================

/** Whether this product is set to show the quantity grid on its own page. */
function addon_boss_product_uses_grid( $product ): bool {
	// The standalone quantity grid is a product's-own-page feature and belongs
	// to the plugin whose job that is. The gate sits here because everything the
	// grid does flows through this one question: the page takeover, its assets,
	// the AJAX add and the admin layout control. A variable product used to slip
	// past, because the can-grid check below answers "variable" before ever
	// touching the gated option config.
	if ( ! addon_boss_options_available() ) {
		return false;
	}
	// Without the grid module a product is ordered one at a time. Its stored grid
	// layout is left untouched for when the module arrives.
	if ( ! addon_boss_engine_can( 'grid' ) ) {
		return false;
	}
	if ( ! $product instanceof WC_Product
		|| 'grid' !== (string) $product->get_meta( '_bundle_boss_order_layout' )
		|| ! function_exists( 'addon_boss_grid_render_card_body' ) ) {
		return false;
	}
	// A variable product grids across its variations; an optioned SIMPLE grids
	// across its choice sets (BundleBoss's "options, not variations" flagship).
	if ( ! addon_boss_product_can_grid( $product ) ) {
		return false;
	}
	// An optioned simple grids across its MAIN choices. With every set marked
	// as a whole-order choice there is nothing to draw: the page said "Choose
	// your quantities" over no cells at all. It is ordered one at a time
	// instead, and the panel tells the merchant why.
	if ( ! $product->is_type( 'variable' ) && function_exists( 'addon_boss_grid_split_sets' )
		&& ! addon_boss_grid_split_sets( $product )['matrix_ids'] ) {
		return false;
	}
	// A size the product cannot be sold without, which no grid can ask for.
	// The grid drew the thickness and the finish, dropped the required glass
	// size, and sold "4 mm, No polish" at the product's £12.50 "from" price
	// with no size at all (walk 2, 28 Oct 2026). Such a product is ordered one
	// at a time, where the size is asked, and its grid add is refused.
	if ( addon_boss_grid_cannot_ask( $product ) ) {
		return false;
	}
	return true;
}

/**
 * The names of the REQUIRED sets on a product that no quantity grid can ask
 * for: a kind priced off its own panel (a measured size, a price table) is
 * never a grid axis nor a whole-order choice, so the grid drops it. Empty
 * where the product has none, which is every grid product a shop had when
 * this was written (a founding customer's 654 grid products: none).
 *
 * @param WC_Product|mixed $product The product.
 * @return string[]
 */
function addon_boss_grid_cannot_ask( $product ): array {
	if ( ! $product instanceof WC_Product || ! function_exists( 'addon_boss_product_option_sets' ) ) {
		return array();
	}
	$out = array();
	foreach ( addon_boss_product_option_sets( $product ) as $bb_set ) {
		if ( ! empty( $bb_set['required'] ) && 'choices' !== (string) ( $bb_set['kind'] ?? 'choices' ) ) {
			$out[] = addon_boss_set_shopper_name( $bb_set );
		}
	}
	return $out;
}

/**
 * Whether a product has something to grid: real variations, or 2+ griddable
 * choice sets on a simple product (colour, size...). A single griddable set
 * still grids as one row of option cells, so one axis is enough.
 */
function addon_boss_product_can_grid( $product ): bool {
	if ( ! $product instanceof WC_Product ) {
		return false;
	}
	// A bundle is never griddable, whatever meta it carries. It has picks, not
	// variations, and it prices itself from what its own configurator collects.
	// The grid takes the page over, so laid on a bundle it removes the
	// configurator: no picks, nothing to price, and the shopper gets a £0.00
	// product with a dead Add to cart (BundleBoss #31).
	//
	// The meta reaches a bundle by outliving its product. Turn the grid on for a
	// variable product or an optioned simple, change that product into a bundle
	// later, and '_bundle_boss_order_layout' stays behind; BundleBoss's own
	// exporter already calls that meta "never on a bundle". Without this line the
	// checks below answer "has it a griddable set?", and one leftover option set
	// is enough to say yes.
	if ( $product->is_type( 'bundle' ) ) {
		return false;
	}
	if ( $product->is_type( 'variable' ) ) {
		return true;
	}
	return function_exists( 'addon_boss_virtual_axes' )
		&& count( addon_boss_virtual_axes( $product ) ) >= 1;
}

// =================================================================
// STANDALONE SURFACE (product options on a plain product, no bundle).
// Lifted from the earlier bundle-side layout into the shared engine so both
// plugins expose it and it registers exactly once. Part 1: resolvers + key.
// =================================================================

const ADDON_BOSS_STANDALONE_OPTIONS_KEY = 'bundle_boss_standalone_options';

/**
 * The sets a product offers on its OWN page: simple products only. The
 * resolver already refuses variable products (variations own that job);
 * this also refuses bundles and every other composite type.
 */
/**
 * The form field for one set's pick on a STANDALONE page. Deliberately
 * OUTSIDE WooCommerce's attribute_ namespace: on a variable product,
 * anything named attribute_* is treated by WooCommerce's scripts and its
 * variable add handler as a variation attribute, so our hidden selects
 * were read as unchosen attributes and the add button locked with
 * "please select some product options". Inside bundles the native
 * virtual-variation path keeps its attribute_ names; that is a different
 * form with different owners.
 */
function addon_boss_standalone_field_name( string $set_id ): string {
	return 'bbpick_' . sanitize_title( addon_boss_virtual_attr_name( $set_id ) );
}

/**
 * An option delta carried onto the DISPLAY basis, sign intact.
 *
 * wc_get_price_to_display() floors any passed price at zero, so a
 * cheaper-choice delta (a plain garment at -3.00 on a printed product)
 * silently became 0 in every figure built from it: the page total held at
 * the base price while the cart correctly charged less, and the till and
 * the page disagreed. The conversion runs on the magnitude and the sign
 * rides around it, so a reduction converts exactly as a surcharge does.
 */
function addon_boss_delta_to_display( $product, float $delta ): float {
	if ( 0.0 === $delta ) {
		return 0.0;
	}
	$bb_disp = (float) wc_get_price_to_display( $product, array( 'price' => abs( $delta ), 'qty' => 1 ) );
	return $delta < 0 ? -$bb_disp : $bb_disp;
}

function addon_boss_standalone_option_sets( $product ): array {
	// The sets render on the product's own page (below the variations form on a
	// variable parent, the placement every rival converged on). A product type
	// this build does not carry sets for renders nothing, and its stored config
	// is left untouched for when the module that does arrives.
	if ( ! $product instanceof WC_Product
		|| ! in_array( $product->get_type(), addon_boss_options_product_types(), true ) ) {
		return array();
	}
	$bb_sets = addon_boss_product_option_sets( $product );
	// A set of a kind nothing registered is dropped from the offer: the build
	// has no maths to price it, and offering it would sell an unchargeable
	// thing. Its stored config is untouched.
	$bb_kinds = addon_boss_option_set_kinds();
	$bb_sets  = array_values(
		array_filter(
			$bb_sets,
			static function ( $bb_s ) use ( $bb_kinds ) {
				return isset( $bb_kinds[ (string) ( $bb_s['kind'] ?? 'choices' ) ] );
			}
		)
	);
	// A rule this build does not evaluate is dropped from the offer whole, so
	// the set simply shows: the basic vocabulary runs everywhere, the numeric
	// compares only where the reveal module answers for them, and a build with
	// no module at all still shows everything.
	foreach ( $bb_sets as &$bb_set ) {
		if ( ! empty( $bb_set['when'] )
			&& ( ! function_exists( 'addon_boss_when_runs_here' ) || ! addon_boss_when_runs_here( $bb_set['when'] ) ) ) {
			$bb_set['when'] = array();
		}
	}
	unset( $bb_set );
	return $bb_sets;
}

/**
 * How a field's answer is named in the rule state. Sets are keyed by their own
 * id, so fields take a prefix nothing else can collide with: a set id is a
 * sanitised key and can never contain a colon.
 */
const ADDON_BOSS_FIELD_RULE_KEY = 'field:';

/**
 * What "there is an answer" and "there is not" are CALLED, for one field type.
 *
 * Two stored operators, four or five pairs of words. A tick box is ticked, not
 * "answered"; a text box is filled in; an upload has a file. One generic pair
 * for all of them reads like nothing anybody says out loud, and a rule you
 * cannot say out loud is a rule you cannot check.
 *
 * @param string $type The trigger field's type.
 * @return array{filled:string,empty:string}
 */
function addon_boss_field_op_words( string $type ): array {
	switch ( $type ) {
		case 'checkbox':
			$words = array( 'filled' => __( 'is ticked', 'addon-boss' ), 'empty' => __( 'is not ticked', 'addon-boss' ) );
			break;
		case 'file':
			$words = array( 'filled' => __( 'has a file', 'addon-boss' ), 'empty' => __( 'has no file', 'addon-boss' ) );
			break;
		case 'select':
		case 'color':
			$words = array( 'filled' => __( 'is chosen', 'addon-boss' ), 'empty' => __( 'is not chosen', 'addon-boss' ) );
			break;
		default:
			// Text, message, number, date, time, and any type a module adds
			// without saying otherwise.
			$words = array( 'filled' => __( 'is filled in', 'addon-boss' ), 'empty' => __( 'is left blank', 'addon-boss' ) );
	}
	// A module with a field type of its own names its own two words here.
	return (array) apply_filters( 'addon_boss_field_op_words', $words, $type );
}

/**
 * A stored reveal rule read into the one canonical shape: act + groups of
 * conditions. Conditions inside a group must all hold; any one group holding
 * fires the rule. Pure data traversal with bounds — nothing here evaluates,
 * repairs or judges; that is the reveal module's job. It exists in the engine
 * so the hidden carriers and the save reader can round-trip every stored shape
 * even in a build with no reveal module at all.
 *
 * Shapes read: legacy {set,is}; flat {match,conditions}, where match 'any'
 * becomes one group per condition (OR of singles is exactly what any meant);
 * and {groups:[...]} as itself. Bounded so a hand-crafted post cannot balloon:
 * six groups of eight conditions, twenty values in a list.
 *
 * @param mixed $when The stored rule, any shape.
 * @return array{act:string,groups:array<int,array<int,array{set:string,field:string,op:string,value:mixed}>>}
 */
function addon_boss_when_to_groups( $when ): array {
	$when   = is_array( $when ) ? $when : array();
	$act    = ( 'hide' === (string) ( $when['act'] ?? '' ) ) ? 'hide' : 'show';
	$bb_ops = array( 'is', 'is_not', 'is_any', 'filled', 'empty', 'more', 'less', 'exact' );

	$bb_cond = static function ( $c ) use ( $bb_ops ) {
		if ( ! is_array( $c ) ) {
			return null;
		}
		$bb_set   = sanitize_text_field( (string) ( $c['set'] ?? '' ) );
		$bb_field = '' === $bb_set ? sanitize_text_field( (string) ( $c['field'] ?? '' ) ) : '';
		if ( '' === $bb_set && '' === $bb_field ) {
			return null;
		}
		$op     = in_array( $c['op'] ?? 'is', $bb_ops, true ) ? (string) $c['op'] : 'is';
		$bb_val = $c['value'] ?? '';
		if ( is_array( $bb_val ) ) {
			$bb_list = array();
			foreach ( $bb_val as $bb_v ) {
				if ( is_scalar( $bb_v ) && count( $bb_list ) < 20 ) {
					$bb_list[] = sanitize_text_field( (string) $bb_v );
				}
			}
			$bb_val = $bb_list;
		} else {
			$bb_val = is_scalar( $bb_val ) ? sanitize_text_field( (string) $bb_val ) : '';
		}
		return array( 'set' => $bb_set, 'field' => $bb_field, 'op' => $op, 'value' => $bb_val );
	};

	$groups = array();
	if ( isset( $when['groups'] ) && is_array( $when['groups'] ) ) {
		foreach ( $when['groups'] as $bb_g ) {
			if ( count( $groups ) >= 6 ) {
				break;
			}
			$bb_conds = array();
			foreach ( (array) ( is_array( $bb_g ) && isset( $bb_g['conditions'] ) ? $bb_g['conditions'] : $bb_g ) as $c ) {
				if ( count( $bb_conds ) >= 8 ) {
					break;
				}
				$bb_c = $bb_cond( $c );
				if ( null !== $bb_c ) {
					$bb_conds[] = $bb_c;
				}
			}
			if ( $bb_conds ) {
				$groups[] = $bb_conds;
			}
		}
	} elseif ( isset( $when['conditions'] ) && is_array( $when['conditions'] ) ) {
		$bb_conds = array();
		foreach ( $when['conditions'] as $c ) {
			if ( count( $bb_conds ) >= 8 ) {
				break;
			}
			$bb_c = $bb_cond( $c );
			if ( null !== $bb_c ) {
				$bb_conds[] = $bb_c;
			}
		}
		if ( $bb_conds ) {
			if ( 'any' === ( $when['match'] ?? 'all' ) ) {
				foreach ( $bb_conds as $bb_c ) {
					$groups[] = array( $bb_c );
				}
			} else {
				$groups[] = $bb_conds;
			}
		}
	} elseif ( isset( $when['set'] ) && array_key_exists( 'is', $when ) && '' !== (string) $when['set'] ) {
		$groups[] = array(
			array(
				'set'   => sanitize_text_field( (string) $when['set'] ),
				'field' => '',
				'op'    => 'is',
				'value' => sanitize_text_field( (string) $when['is'] ),
			),
		);
	}

	return array( 'act' => $act, 'groups' => $groups );
}

/**
 * The storage shape for a canonical act+groups rule: the SMALLEST shape that
 * says it. One plain show "is" on a set stores in the legacy {set,is}, so an
 * ordinary single rule is byte-identical on disk to one saved years ago and
 * every older reader keeps reading it. One group stores flat; only a rule that
 * genuinely says "or when" stores groups. Hide rides an 'act' prefix.
 *
 * @param array $norm The {act,groups} shape (see addon_boss_when_to_groups()).
 * @return array The array to store on the row; empty for no rule.
 */
function addon_boss_when_store_shape( array $norm ): array {
	$act    = ( 'hide' === (string) ( $norm['act'] ?? '' ) ) ? 'hide' : 'show';
	$groups = array_values( array_filter( array_map( 'array_values', (array) ( $norm['groups'] ?? array() ) ) ) );
	if ( ! $groups ) {
		return array();
	}
	if ( 1 === count( $groups ) && 1 === count( $groups[0] ) && 'show' === $act
		&& 'is' === (string) ( $groups[0][0]['op'] ?? '' )
		&& '' === (string) ( $groups[0][0]['field'] ?? '' )
		&& ! is_array( $groups[0][0]['value'] ) ) {
		return array(
			'set' => (string) $groups[0][0]['set'],
			'is'  => (string) $groups[0][0]['value'],
		);
	}
	if ( 1 === count( $groups ) ) {
		$when = array(
			'match'      => 'all',
			'conditions' => $groups[0],
		);
		return 'hide' === $act ? array( 'act' => 'hide' ) + $when : $when;
	}
	$when = array( 'groups' => $groups );
	return 'hide' === $act ? array( 'act' => 'hide' ) + $when : $when;
}

/**
 * The operators ONE trigger offers, worded so the rule reads as a sentence a
 * person would say out loud — and no more than four of them, because eleven
 * operators on screen at once is how the rivals' builders got their support
 * queues. A single-pick set speaks is / is not / is any of / is answered; a
 * several-of set speaks includes / does not include; a text box is filled in
 * or left blank; a number compares. The stored operator vocabulary is wider
 * than any one trigger's menu, which is the point: the menu fits the trigger.
 *
 * @param string $kind        'set' or 'field'.
 * @param string $type        The field's type when kind is 'field'.
 * @param bool   $multi       Whether a set trigger takes several answers.
 * @param bool   $has_options Whether a set trigger has a pickable option list.
 * @return array<string,string> Operator => the word it prints as, in menu order.
 */
function addon_boss_trigger_op_choices( string $kind, string $type = '', bool $multi = false, bool $has_options = true ): array {
	if ( 'set' === $kind ) {
		if ( ! $has_options ) {
			// A set priced off its own panel (a size grid, a measured size) has
			// no option list to compare against, but "answered at all" is still
			// a fact about it worth ruling on.
			return array( 'filled' => __( 'is answered', 'addon-boss' ) );
		}
		if ( $multi ) {
			return array(
				'is'     => __( 'includes', 'addon-boss' ),
				'is_not' => __( 'does not include', 'addon-boss' ),
			);
		}
		return array(
			'is'     => __( 'is', 'addon-boss' ),
			'is_not' => __( 'is not', 'addon-boss' ),
			'is_any' => __( 'is any of', 'addon-boss' ),
			'filled' => __( 'is answered', 'addon-boss' ),
		);
	}
	if ( 'number' === $type ) {
		// The numeric compares are the deep half of the vocabulary. A build
		// without them still rules on a number field the basic way: answered
		// or not. A stored numeric rule is not rewritten by this menu; it is
		// simply not evaluated, and its row shows.
		if ( ! addon_boss_engine_can( 'reveal' ) ) {
			$bb_words = addon_boss_field_op_words( $type );
			return array(
				'filled' => (string) $bb_words['filled'],
				'empty'  => (string) $bb_words['empty'],
			);
		}
		return array(
			'more'  => __( 'is more than', 'addon-boss' ),
			'less'  => __( 'is less than', 'addon-boss' ),
			'exact' => __( 'is exactly', 'addon-boss' ),
		);
	}
	$bb_types = function_exists( 'addon_boss_personalisation_field_types' ) ? addon_boss_personalisation_field_types() : array();
	$bb_words = addon_boss_field_op_words( $type );
	if ( ! empty( $bb_types[ $type ]['has_options'] ) || ! empty( $bb_types[ $type ]['color_options'] ) ) {
		// A dropdown field and a colour field are picked from a list, so they
		// speak the same four words a single-pick set does — worded by type.
		return array(
			'is'     => __( 'is', 'addon-boss' ),
			'is_not' => __( 'is not', 'addon-boss' ),
			'is_any' => __( 'is any of', 'addon-boss' ),
			'filled' => (string) $bb_words['filled'],
		);
	}
	return array(
		'filled' => (string) $bb_words['filled'],
		'empty'  => (string) $bb_words['empty'],
	);
}

/**
 * A field's answer flattened to the one string a rule compares against.
 *
 * A field asked several times (repeatable, several uploads) answers with the
 * FIRST thing it was actually given, so "is filled in" means "they filled in at
 * least one", which is what a merchant writing the rule means by it.
 *
 * @param mixed $raw Whatever the request carries for the field.
 * @return string
 */
function addon_boss_field_rule_value( $raw ): string {
	if ( is_array( $raw ) ) {
		foreach ( $raw as $bb_v ) {
			$bb_flat = addon_boss_field_rule_value( $bb_v );
			if ( '' !== $bb_flat ) {
				return $bb_flat;
			}
		}
		return '';
	}
	if ( is_bool( $raw ) ) {
		return $raw ? '1' : '';
	}
	return is_scalar( $raw ) ? trim( (string) $raw ) : '';
}

/**
 * A colour field's answer as a RULE sees it: any custom pick answers plainly
 * as "custom", whatever hex it carries. A rule can offer the merchant's own
 * swatches and the one word Custom; it can never name a specific free-typed
 * hex, because "when they pick #37b24d" is not a rule anyone can keep true.
 *
 * Registered on the colour type as its rule_answer callback — the engine's
 * generic seam, so the rule state never knows what a colour is.
 *
 * @param string $answer The posted answer.
 * @return string
 */
function addon_boss_colour_rule_answer( string $answer ): string {
	return 0 === strpos( $answer, 'custom:' ) ? 'custom' : $answer;
}

/**
 * Add every field's answer to the rule state, so a rule can be triggered by a
 * field and not only by a set.
 *
 * Walked in ROW ORDER, and a field's own rule is judged against what came
 * BEFORE it. That is why the builder only offers earlier fields as triggers: it
 * removes the need for a fixpoint over field answers, and it makes a cycle
 * impossible by construction rather than by detection. It is also honest in the
 * merchant's own terms, because a rule cannot depend on an answer nobody has
 * been asked for yet.
 *
 * A field that is itself hidden is marked inactive, so a stale answer nobody
 * can see never satisfies the next rule along. That is the same discipline sets
 * have always had.
 *
 * @param array $fields The product's fields, in row order.
 * @param mixed $posted What the request carries under bb_pf.
 * @param array $picks  Set id => picked keys; gains one entry per field.
 * @param array $active Set id => active; gains one entry per field.
 */
function addon_boss_add_field_rule_state( array $fields, $posted, array &$picks, array &$active ): void {
	$bb_types = addon_boss_personalisation_field_types();
	foreach ( $fields as $bb_def ) {
		$bb_key = (string) ( $bb_def['key'] ?? '' );
		if ( '' === $bb_key ) {
			continue;
		}
		$bb_id   = ADDON_BOSS_FIELD_RULE_KEY . $bb_key;
		$bb_when = is_array( $bb_def['when'] ?? null ) ? $bb_def['when'] : array();
		// Judged against the state so far, which is exactly the rows above it.
		$bb_vis = ! $bb_when || (bool) apply_filters( 'addon_boss_when_met', true, $bb_when, $picks, $active );
		$bb_ans = addon_boss_field_rule_value( is_array( $posted ) ? ( $posted[ $bb_key ] ?? null ) : null );
		// A type may restate its answer in rule terms (a custom colour answers
		// as the one word "custom"), through its own registered callback.
		$bb_map = $bb_types[ (string) ( $bb_def['type'] ?? '' ) ]['rule_answer'] ?? null;
		if ( '' !== $bb_ans && $bb_map && is_callable( $bb_map ) ) {
			$bb_ans = (string) call_user_func( $bb_map, $bb_ans );
		}
		$picks[ $bb_id ]  = $bb_ans;
		$active[ $bb_id ] = $bb_vis;
	}
}

/**
 * Does a fired rule take this row out of the MARKUP, rather than just out of
 * sight? It never does, and this function exists to be the one place that says
 * why.
 *
 * A rule that can fire can also un-fire. Tick the box and the upload goes;
 * untick it and the upload has to come back, which it cannot do if the server
 * left it out of the page. So every conditional row is drawn and the stylesheet
 * decides what is on screen, which is what lets the storefront script move a
 * row either way without a reload.
 *
 * Nothing about the money changes. A hidden row is inert on the server whatever
 * its input happens to be carrying, so a stale value in a hidden field is read
 * by nobody, charged by nobody and required of nobody.
 *
 * @param array $when   The stored rule.
 * @param bool  $active Whether the rule currently leaves the row available.
 * @return bool Always false.
 */
function addon_boss_rule_removes_row( $when, bool $active ): bool {
	unset( $when, $active );
	return false;
}

/**
 * One set's posted picks, cleaned: an array of sanitised keys in the SET'S
 * OWN option order, so the same picks always snapshot in the same order and
 * the cart id they hash to can never depend on click order. Duplicates
 * collapse to one. A pick-one set reads its scalar exactly as before, and an
 * array posted against one reads as no answer (a crafted shape, never a
 * fatal). A key the set does not carry is KEPT, at the end, so the resolver
 * still refuses it by name. Bounded before any work, so a crafted
 * thousand-entry payload costs nothing.
 *
 * @param array $set The resolved set (its 'multi' flag and options).
 * @param mixed $raw What the request carries for the set's field (slashed).
 * @return string[] Picked keys; empty when nothing was picked.
 */
function addon_boss_standalone_posted_picks( array $set, $raw ): array {
	$bb_multi = ! empty( $set['multi'] );
	if ( is_array( $raw ) ) {
		if ( ! $bb_multi ) {
			return array();
		}
		$bb_vals = array_slice( array_values( $raw ), 0, 100 );
	} else {
		$bb_vals = array( $raw );
	}
	$bb_picked = array();
	foreach ( $bb_vals as $bb_v ) {
		if ( is_array( $bb_v ) ) {
			continue; // a nested array is noise, never a pick.
		}
		$bb_v = sanitize_text_field( wp_unslash( (string) $bb_v ) );
		if ( '' !== $bb_v ) {
			$bb_picked[] = $bb_v;
		}
	}
	$bb_picked = array_values( array_unique( $bb_picked ) );
	if ( ! $bb_multi ) {
		return array_slice( $bb_picked, 0, 1 );
	}
	$bb_order = array();
	foreach ( (array) ( $set['options'] ?? array() ) as $bb_opt ) {
		$bb_order[] = (string) ( $bb_opt['key'] ?? '' );
	}
	return array_merge(
		array_values( array_intersect( $bb_order, $bb_picked ) ),
		array_values( array_diff( $bb_picked, $bb_order ) )
	);
}

/**
 * Resolve one request's standalone picks into cart snapshots via the SAME
 * resolver the bundle gate uses (addon_boss_option_snapshot), reading the
 * native field names (attribute_bbset-<set id>) from $source. WP_Error
 * naming the set when a required set has no pick or a posted key is not in
 * its set; the snapshot array otherwise (empty when nothing was picked). A
 * several-of set resolves every posted key and enforces its own bounds here,
 * server-side, whatever any client allowed.
 *
 * @param array $source Raw request fields (slashed; sanitised per field).
 * @return array|WP_Error
 */
/**
 * A several-of set's picks, checked against its bounds, as snapshots.
 *
 * Every posted key becomes its own snapshot carrying its own fee, and the
 * bounds are enforced HERE, whatever any client allowed. An optional set left
 * entirely alone is no answer rather than a short answer, so its at-least only
 * speaks once the shopper has engaged with it.
 *
 * This lives on its own because TWO surfaces order these sets: the product's
 * own page and the quantity grid's whole-order block. Two copies of a rule
 * about what a shopper may pick, and what each pick costs, is two rules that
 * drift, and the drift shows up as money.
 *
 * @param array $set  A resolved set with multi set.
 * @param array $keys The keys the shopper picked, in any order.
 * @return array|WP_Error One snapshot per pick, or the shopper's own message.
 */
function addon_boss_multi_pick_snapshots( array $set, array $keys ) {
	$name  = addon_boss_set_shopper_name( $set );
	$count = count( $keys );
	$min   = max( 0, (int) ( $set['min'] ?? 0 ) );
	$max   = max( 0, (int) ( $set['max'] ?? 0 ) );

	if ( 0 === $count ) {
		if ( ! empty( $set['required'] ) ) {
			return new WP_Error(
				'bundle_boss',
				$min > 1
					/* translators: 1: the smallest number of choices, 2: option set name */
					? sprintf( __( 'Choose at least %1$s for %2$s.', 'addon-boss' ), number_format_i18n( $min ), $name )
					/* translators: %s: option set name */
					: sprintf( __( 'Please choose %s.', 'addon-boss' ), $name )
			);
		}
		return array();
	}
	if ( $count < $min ) {
		return new WP_Error(
			'bundle_boss',
			/* translators: 1: the smallest number of choices, 2: option set name */
			sprintf( __( 'Choose at least %1$s for %2$s.', 'addon-boss' ), number_format_i18n( $min ), $name )
		);
	}
	if ( $max > 0 && $count > $max ) {
		return new WP_Error(
			'bundle_boss',
			/* translators: 1: the largest number of choices, 2: option set name */
			sprintf( __( 'Choose up to %1$s for %2$s.', 'addon-boss' ), number_format_i18n( $max ), $name )
		);
	}

	// One veto seam for anything reasoning about the picks TOGETHER, in the
	// same chokepoint the bounds hold, so a refusal is a refusal on the page
	// and at the till alike. Null objects to nothing; a WP_Error is the
	// shopper's own sentence.
	$bb_stop = apply_filters( 'addon_boss_multi_pick_stop', null, $set, $keys );
	if ( is_wp_error( $bb_stop ) ) {
		return $bb_stop;
	}

	$snapshots = array();
	foreach ( $keys as $key ) {
		$snap = addon_boss_option_snapshot( $set, (string) $key );
		if ( null === $snap ) {
			return new WP_Error(
				'bundle_boss',
				/* translators: %s: option set name */
				sprintf( __( 'That %s choice is not available any more. Please pick another.', 'addon-boss' ), $name )
			);
		}
		$snapshots[] = $snap;
	}
	return $snapshots;
}

function addon_boss_standalone_option_snapshots( WC_Product $product, array $source ) {
	$sets = addon_boss_standalone_option_sets( $product );

	// Every set's raw pick first, then the activity map: a hidden set is
	// INERT, so its posted value is discarded (never charged, the crafted
	// POST case) and its required flag never fires (the blocked-checkout
	// case). Both are the category's admitted failure classes. A pick-one
	// set's entry stays the string it always was; a several-of set's entry
	// is its array of keys.
	$picks = array();
	foreach ( $sets as $set ) {
		$field = addon_boss_standalone_field_name( $set['id'] );
		$bb_pp = addon_boss_standalone_posted_picks( $set, $source[ $field ] ?? '' );
		$picks[ $set['id'] ] = ! empty( $set['multi'] ) ? $bb_pp : (string) ( $bb_pp[0] ?? '' );
	}
	$active = addon_boss_active_option_sets( $sets, $picks );

	$snapshots = array();
	foreach ( $sets as $set ) {
		if ( empty( $active[ $set['id'] ] ) ) {
			continue; // hidden means inert.
		}

		// A kind priced off its own panel (a measured size, a price table)
		// resolves through the module that registered it; the sets list above
		// already dropped any kind nothing did.
		$bb_kind = (string) ( $set['kind'] ?? 'choices' );
		if ( 'choices' !== $bb_kind ) {
			$bb_cb = addon_boss_option_set_kinds()[ $bb_kind ]['snapshot'] ?? null;
			if ( ! is_callable( $bb_cb ) ) {
				continue;
			}
			$bb_snap = call_user_func( $bb_cb, $set, $source );
			if ( is_wp_error( $bb_snap ) ) {
				return $bb_snap;
			}
			if ( is_array( $bb_snap ) ) {
				// A module can adjust a panel-priced snapshot off the OTHER
				// answers on the page (a table's named uplift when Two colours
				// is picked). It runs HERE because this is the one place the
				// picks and the activity map stand beside the freshly priced
				// snapshot; with nothing hooked it passes byte-identical.
				$bb_snap = apply_filters( 'addon_boss_kind_snapshot_adjust', $bb_snap, $set, $picks, $active, $source );
				if ( is_wp_error( $bb_snap ) ) {
					return $bb_snap;
				}
				$snapshots[] = $bb_snap;
			}
			continue;
		}

		// Several-of: the bounds and the snapshots come from the one helper that
		// both ordering surfaces call, so the single-pick page and the quantity
		// grid can never disagree about what is allowed or what it costs.
		if ( ! empty( $set['multi'] ) ) {
			$bb_multi = addon_boss_multi_pick_snapshots( $set, (array) $picks[ $set['id'] ] );
			if ( is_wp_error( $bb_multi ) ) {
				return $bb_multi;
			}
			foreach ( $bb_multi as $bb_snap ) {
				$snapshots[] = $bb_snap;
			}
			continue;
		}

		$picked = $picks[ $set['id'] ];
		if ( '' === $picked ) {
			if ( $set['required'] ) {
				return new WP_Error(
					'bundle_boss',
					/* translators: %s: option set name */
					sprintf( __( 'Please choose %s.', 'addon-boss' ), addon_boss_set_shopper_name( $set ) )
				);
			}
			continue;
		}
		$snap = addon_boss_option_snapshot( $set, $picked );
		if ( null === $snap ) {
			return new WP_Error(
				'bundle_boss',
				/* translators: %s: option set name */
				sprintf( __( 'That %s choice is not available any more. Please pick another.', 'addon-boss' ), addon_boss_set_shopper_name( $set ) )
			);
		}
		$snapshots[] = $snap;
	}

	// A section that asks for at least one answer, judged on the same activity
	// map, with the field answers joined so a typed name counts as an answer.
	// Here, at the one resolve boundary, so the product page, a Store API add
	// and any programmatic add are refused alike.
	$bb_cfg = addon_boss_product_option_config( $product );
	if ( $bb_cfg && array_filter( $bb_cfg, static function ( $r ) { return 'group' === ( $r['row_type'] ?? '' ) && ! empty( $r['min_pick'] ); } ) ) {
		$bb_posted = isset( $source['bb_pf'] ) && is_array( $source['bb_pf'] ) ? wp_unslash( $source['bb_pf'] ) : null;
		$bb_fp     = $picks;
		$bb_fa     = $active;
		addon_boss_add_field_rule_state( addon_boss_standalone_product_fields( $product ), $bb_posted, $bb_fp, $bb_fa );
		$bb_unmet = addon_boss_section_min_unmet( $bb_cfg, $bb_fp, $bb_fa, $bb_posted );
		if ( is_wp_error( $bb_unmet ) ) {
			return $bb_unmet;
		}
	}

	/**
	 * The resolved snapshots, before anything charges off them. A module may
	 * re-cut deltas that belong TOGETHER (per-combination pricing charges a
	 * colour and size pair as one exact cell); with no subscriber they pass
	 * through untouched. Filtered HERE, at the one resolve boundary, so the
	 * add-to-cart check, the cart line, the order rows and the emails can
	 * never disagree about what a pair costs.
	 *
	 * @param array<int,array> $snapshots
	 * @param WC_Product       $product
	 */
	return apply_filters( 'addon_boss_standalone_option_snapshots_resolved', $snapshots, $product );
}

/**
 * Whether one picked option's price REPLACES the product's own price rather
 * than adding to it: a look-up table on the "sets the whole price" basis
 * (table_basis), or a measured size on a whole-price set (basis). Every
 * other option adds on.
 *
 * @param array $snap One frozen pick.
 */
function addon_boss_snap_replaces_base( array $snap ): bool {
	return 'set' === ( $snap['table_basis'] ?? '' ) || 'set' === ( $snap['basis'] ?? '' );
}

/**
 * A snapshot's charge as a display suffix, or '' for no charge. The helper
 * that converts it is the one every bundle option figure goes through
 * (addon_boss_price_to_display); it only converts positive amounts, so the
 * magnitude converts and the sign is reapplied (deltas may be negative).
 */
function addon_boss_standalone_charge_suffix( array $snap, $product, string $context ): string {
	$fee = (float) ( $snap['delta'] ?? 0 );
	if ( 0.0 === $fee || ! $product instanceof WC_Product ) {
		return '';
	}
	$shown = addon_boss_price_to_display( $product, abs( $fee ), $context );
	// A look-up table on the "sets the whole price" basis is not a surcharge: the
	// cell REPLACES the product price, so the line and this figure are the same
	// money. Printing "+£115.20" beside a £115.20 line reads as a double charge.
	// Plain text for the same reason the field suffix is: meta renders where
	// our CSS never follows, and wc_price invites dual-basis tax markup. A
	// whole-price measured size reads the same way.
	if ( addon_boss_snap_replaces_base( $snap ) ) {
		return ' (' . addon_boss_money( $shown, null, array( 'plain' => true, 'convert' => false ) ) . ')';
	}
	// A charge taken once for the line says so, in the word the editor's
	// Charge control already uses, so "+£50.00" beside a line of four does
	// not read as four charges.
	$bb_once = ! empty( $snap['once'] ) ? ' ' . addon_boss_fee_mode_shorts()['once'] : '';
	return ' (' . ( $fee > 0 ? '+' : '-' ) . addon_boss_money( $shown, null, array( 'plain' => true, 'convert' => false ) ) . $bb_once . ')';
}

/**
 * The SAME charge suffix as plain text, for the readable order rows. The one
 * formatter builds the suffix (above); this only takes its markup off.
 * wp_strip_all_tags() ends in trim(), which ate the suffix's leading space:
 * the cart read "Sandalwood (+£2.00)" while the thank-you page, the order
 * screen and the emails read "Sandalwood(+£2.00)". The space is the suffix's
 * own first character, so it is put back after the strip; an empty suffix
 * stays exactly empty.
 */
function addon_boss_standalone_suffix_text( string $suffix ): string {
	if ( '' === $suffix ) {
		return '';
	}
	return ' ' . trim( wp_strip_all_tags( $suffix ) );
}

/**
 * A charge suffix that never breaks inside its brackets, for the rows the
 * cart and the checkout print. "(+£8.00)" broke after its sign on a phone,
 * "Full back (+" above "£8.00)" (tester round 4, 18 Oct 2026): a sign before
 * a currency symbol is a place a line may break, and so is the space before
 * a symbol written after the number, or after the comma in "+15%, £5.99".
 * A word joiner after the sign and no-break spaces hold it together; a
 * semicolon between two charges still lets a long one wrap. Display only:
 * the order's rows keep plain text for exports and invoices.
 *
 * @param string $suffix A suffix as addon_boss_standalone_charge_suffix() builds it.
 * @return string
 */
function addon_boss_suffix_nowrap( string $suffix ): string {
	if ( '' === $suffix ) {
		return '';
	}
	$bb_out = (string) preg_replace( '/([+\-])(?=[^\s\d])/u', "\$1\u{2060}", $suffix );
	$bb_out = (string) preg_replace( '/([\d%,]) (?=\S)/u', "\$1\u{00A0}", $bb_out );
	return (string) preg_replace( '/(?<=\S) (?=\d)/u', "\u{00A0}", $bb_out ); // "€ 8,00": a symbol set before the number with a space.
}

// ---- Product fields: priced custom inputs on the product's own page ----
//
// A field shares the set's shape exactly: optional / required (or "required
// once personalising"), an "available only when a set is picked" reveal, and a
// charge. The money joins the SAME cart line as the sets (one set_price), so
// the two paths can never drift. A hidden field (its reveal rule unmet) is
// INERT: never resolved, never charged, its required flag never fires, the
// same server-side discipline the sets keep.

const ADDON_BOSS_PRODUCT_FIELDS_KEY  = 'bundle_boss_product_fields';
const ADDON_BOSS_PRODUCT_FIELDS_META = '_bundle_boss_product_fields';

// The most instances one repeatable field can ever open, whatever the merchant
// typed and whatever the browser posts. A shopper cannot be allowed to grow the
// payload without limit, but the ceiling has to sit ABOVE the size runs
// merchants actually take: quantity discounts make 100 and 150 normal
// quantities, and a per-item field's promise is one entry per unit. Past a
// handful the storefront folds the list into one paste-the-list box and the
// cart folds the rows into a summary, so nothing ever draws hundreds of cards
// however much this allows.
const ADDON_BOSS_REPEAT_CEILING = 200;


/**
 * One posted field value, cleaned to what its type is allowed to carry.
 *
 * The single-instance path and each instance of a repeatable one go through
 * this same function, so a repeated measured field cannot accept a shape the
 * plain one refuses.
 *
 * @param array  $types  The field type register.
 * @param string $type   This field's type.
 * @param mixed  $posted What arrived for it.
 * @return array|string|null
 */
function addon_boss_field_normalise_posted( array $types, string $type, $posted ) {
	if ( null === $posted ) {
		return null;
	}
	if ( is_array( $posted ) ) {
		// Only a MEASURED field posts an array (its two dimensions). Every
		// other type stays scalar-only, so an array smuggled in against a
		// text or file field is still dropped exactly as before.
		if ( empty( $types[ $type ]['is_measure'] ) ) {
			return null;
		}
		return array(
			'w' => isset( $posted['w'] ) ? sanitize_text_field( wp_unslash( (string) $posted['w'] ) ) : '',
			'h' => isset( $posted['h'] ) ? sanitize_text_field( wp_unslash( (string) $posted['h'] ) ) : '',
		);
	}
	return wp_unslash( (string) $posted );
}


/**
 * The priced fields a product offers on its OWN page, each field def carrying
 * its reveal rule ('when') folded in. Same surfaces as the sets (simple
 * products and variable parents); anything else offers none.
 *
 * @return array<int,array>
 */
function addon_boss_standalone_product_fields( $product ): array {
	if ( ! $product instanceof WC_Product || ! ( $product->is_type( 'simple' ) || $product->is_type( 'variable' ) ) ) {
		return array();
	}
	$out = array();
	// One field row to its read-ready def, or null when this build cannot
	// offer its type. The exact logic the flat walk has always applied.
	$bb_read = static function ( array $row ) {
		if ( ( $row['row_type'] ?? '' ) !== 'field' || ! is_array( $row['field'] ?? null ) ) {
			return null;
		}
		$def         = $row['field'];
		// A rule this build does not evaluate is dropped whole, so the field
		// simply shows. The stored rule itself is left untouched.
		$def['when'] = ( is_array( $row['when'] ?? null )
			&& function_exists( 'addon_boss_when_runs_here' )
			&& addon_boss_when_runs_here( $row['when'] ) ) ? $row['when'] : array();
		// A field TYPE this build does not offer is inert: dropped from the set
		// every downstream reader uses, so it never prices, validates/blocks or
		// renders. A field priced by an unavailable fee MODE is KEPT (its input
		// still works; the fee is zeroed in resolve_fee). The stored config is
		// never rewritten, so the field returns whole with its module.
		if ( ! addon_boss_field_type_available( (string) ( $def['type'] ?? '' ) ) ) {
			return null;
		}
		return $def;
	};
	// The walk keeps each group's identity in hand: a field inside a GROUP is
	// captured + priced exactly like a top-level one (grouping is presentation,
	// never a money boundary), and when the group is marked repeatable its
	// members are STAMPED with the group's repeat facts under '_grp', a derived
	// read-time key that is never stored. The module that owns repeats reads
	// the stamp; with no module the stamp is inert and every field asks once.
	// A quantity-grid product is never stamped: the grid captures a quantity
	// per variation and nothing per line, so there is no line quantity for a
	// block to follow and no per-line blocks to draw (the same deferral the
	// per-field per_item mode already makes there).
	$bb_grid = function_exists( 'addon_boss_product_uses_grid' ) && addon_boss_product_uses_grid( $product );
	$bb_gi   = -1;
	foreach ( (array) addon_boss_product_option_config( $product ) as $row ) {
		if ( ( $row['row_type'] ?? '' ) === 'group' ) {
			++$bb_gi;
			$bb_gmode = (string) ( $row['repeat'] ?? '' );
			$bb_stamp = ! $bb_grid && in_array( $bb_gmode, array( 'add', 'per_item' ), true );
			$bb_kids  = (array) ( $row['children'] ?? array() );
			// The member keys, in order, so the module can read the whole
			// block's posted lists from any one member's seam call.
			$bb_keys = array();
			if ( $bb_stamp ) {
				foreach ( $bb_kids as $bb_kid ) {
					$bb_kdef = is_array( $bb_kid ) ? $bb_read( $bb_kid ) : null;
					if ( null !== $bb_kdef && '' !== (string) ( $bb_kdef['key'] ?? '' ) ) {
						$bb_keys[] = (string) $bb_kdef['key'];
					}
				}
			}
			foreach ( $bb_kids as $bb_kid ) {
				$def = is_array( $bb_kid ) ? $bb_read( $bb_kid ) : null;
				if ( null === $def ) {
					continue;
				}
				if ( $bb_stamp ) {
					$def['_grp'] = array(
						'index'        => $bb_gi,
						'label'        => (string) ( $row['label'] ?? '' ),
						'repeat'       => $bb_gmode,
						'repeat_max'   => (int) ( $row['repeat_max'] ?? 0 ),
						'repeat_label' => (string) ( $row['repeat_label'] ?? '' ),
						'keys'         => $bb_keys,
					);
				}
				$out[] = $def;
			}
			continue;
		}
		$def = $bb_read( $row );
		if ( null !== $def ) {
			$out[] = $def;
		}
	}
	return $out;
}

/**
 * Resolve one request's field inputs into cart snapshots via the SAME
 * personalisation resolvers the bundle add-ons use, so text / number / tick /
 * dropdown / file behave identically here and there. A field revealed "only
 * when" a set is picked reads its activity off the SAME set picks the option
 * snapshots use: hidden means INERT (its posted value discarded, never
 * charged; its required flag never fires). Returns WP_Error naming the field
 * when a required (or "required once personalising") field is left empty; the
 * snapshot array otherwise (empty when nothing was filled).
 *
 * Each snapshot freezes the resolved fee. A 'once' fee is a WHOLE-LINE charge
 * (the price seam spreads it across the line quantity so quantity can never
 * multiply it); every other mode is per-unit and multiplies natively.
 *
 * @param array $source Raw request fields (slashed; sanitised per field).
 * @return array|WP_Error
 */
function addon_boss_standalone_field_snapshots( WC_Product $product, array $source ) {
	$fields = addon_boss_standalone_product_fields( $product );
	if ( ! $fields ) {
		return array();
	}
	$types = function_exists( 'addon_boss_personalisation_field_types' ) ? addon_boss_personalisation_field_types() : array();

	// Field reveal rides on the SAME set picks the option snapshots resolve, so
	// a field shown "only when Style is Printed" is inert while Plain is picked.
	// The same reader as the resolver: a several-of set's entry is its array.
	$sets  = addon_boss_standalone_option_sets( $product );
	$picks = array();
	foreach ( $sets as $set ) {
		$f     = addon_boss_standalone_field_name( $set['id'] );
		$bb_pp = addon_boss_standalone_posted_picks( $set, $source[ $f ] ?? '' );
		$picks[ $set['id'] ] = ! empty( $set['multi'] ) ? $bb_pp : (string) ( $bb_pp[0] ?? '' );
	}
	$active_sets = addon_boss_active_option_sets( $sets, $picks );
	// Fields join the rule state too, so a rule can be triggered by a tick box
	// and not only by an option set.
	addon_boss_add_field_rule_state( $fields, $source['bb_pf'] ?? null, $picks, $active_sets );

	// The variation being bought, so a field restricted to certain variations
	// stays inert for the rest.
	$chosen_variation = isset( $source['variation_id'] ) ? absint( $source['variation_id'] ) : 0;
	// A typed amount converts at the rate of the line it rides: the chosen
	// variation's own where it has one. With the product's, a £20 donation
	// typed on a zero-rated Kids size was charged £24.00 (the £20 read as
	// without 20% VAT, then charged at 0%), while the shopper had named £20.
	$bb_line_product = $product;
	if ( $chosen_variation && $product instanceof WC_Product ) {
		$bb_line_var = wc_get_product( $chosen_variation );
		if ( $bb_line_var instanceof WC_Product_Variation && (int) $bb_line_var->get_parent_id() === (int) $product->get_id() ) {
			$bb_line_product = $bb_line_var;
		}
	}

	// First pass: resolve every ACTIVE, input-bearing field. A section label is
	// display-only, so it carries no value and never resolves.
	$resolved_rows = array();
	$any_filled    = false;
	foreach ( $fields as $def ) {
		$key  = (string) ( $def['key'] ?? '' );
		$type = (string) ( $def['type'] ?? '' );
		if ( '' === $key || ! empty( $types[ $type ]['display_only'] ) ) {
			continue;
		}
		if ( ! addon_boss_field_applies_to_variation( $def, $chosen_variation ) ) {
			continue; // inert for this variation: never required, never charged.
		}
		$when = is_array( $def['when'] ?? null ) ? $def['when'] : array();
		if ( $when && ! (bool) apply_filters( 'addon_boss_when_met', true, $when, $picks, $active_sets ) ) {
			// The module that evaluates reveal rules answered no: hidden means
			// inert, never resolved, never charged, never blocking. With no
			// evaluator registered a rule was already wiped on read, and the
			// default answer keeps everything visible.
			continue;
		}
		$posted = $source['bb_pf'][ $key ] ?? null;
		// A module that asks one field several times (repeatable fields)
		// answers this seam with one entry per instance: the posted value,
		// the instance's own label, its number from 1, and whether its money
		// is whole-line (a per-item repeat already scales with the quantity).
		// With nothing registered every field asks exactly once, as it always
		// has, and a stored repeat setting waits, unhonoured and untouched.
		$bb_instances = apply_filters( 'addon_boss_field_instances', null, $def, $posted, $source );
		if ( is_array( $bb_instances ) ) {
			foreach ( $bb_instances as $bb_inst ) {
				$resolved = addon_boss_personalisation_resolve_value(
					$def,
					addon_boss_field_normalise_posted( $types, $type, $bb_inst['value'] ?? null ),
					$bb_line_product
				);
				if ( is_wp_error( $resolved ) ) {
					// Typed but wrong is its own state: the message says what to fix.
					// Dropping it as if empty would lose the answer, or the money.
					return $resolved;
				}
				if ( null !== $resolved ) {
					$any_filled = true;
				}
				$resolved_rows[] = array(
					'def'      => $def,
					'resolved' => $resolved,
					'instance' => (int) ( $bb_inst['instance'] ?? 0 ),
					'label'    => (string) ( $bb_inst['label'] ?? '' ),
					'spread'   => ! empty( $bb_inst['spread'] ),
				);
			}
			continue;
		}
		$resolved = addon_boss_personalisation_resolve_value(
			$def,
			addon_boss_field_normalise_posted( $types, $type, $posted ),
			$bb_line_product
		);
		if ( is_wp_error( $resolved ) ) {
			return $resolved; // typed but wrong: the message says what to fix.
		}
		if ( null !== $resolved ) {
			$any_filled = true;
		}
		$resolved_rows[] = array( 'def' => $def, 'resolved' => $resolved );
	}

	// A module that resolves several fields as ONE block (a repeatable group)
	// reorders the rows here so the line reads block by block, the way the
	// shopper filled it in, and the required gate below accuses the first gap
	// in READING order. With nothing registered the rows stand exactly as the
	// loop built them, which is the order every line has always had.
	$resolved_rows = (array) apply_filters( 'addon_boss_field_resolved_rows', $resolved_rows );

	// Second pass: gate required / "required once personalising", then freeze
	// the fee for each filled field into a snapshot.
	$once_charged = array();
	$snapshots    = array();
	foreach ( $resolved_rows as $row ) {
		$def      = $row['def'];
		$resolved = $row['resolved'];
		$instance = (int) ( $row['instance'] ?? 0 );
		// A repeatable field names each one (the instances seam carried the
		// name), so an unfilled third card reads "Please complete Name 3" and
		// the shopper knows which to go back to rather than being sent to
		// look at the field in general.
		$label = '' !== (string) ( $row['label'] ?? '' )
			? (string) $row['label']
			: (string) ( $def['label'] ?? '' );
		if ( null === $resolved ) {
			$blocks = ! empty( $def['required'] )
				|| ( 'engaged' === ( $def['require_when'] ?? '' ) && $any_filled );
			if ( $blocks ) {
				return new WP_Error(
					'bundle_boss',
					/* translators: %s: the name of whatever is unanswered, a field or a dimension */
					sprintf( __( 'Please complete %s.', 'addon-boss' ), $label )
				);
			}
			continue;
		}
		// A floor on the file count ("send at least two views"). Checked HERE, on
		// the server, because the browser count is a courtesy: the add-to-cart post
		// is what decides, and a short set must not reach the cart at all. Only a
		// field that WAS filled is measured, so an optional upload left empty is
		// still optional.
		$min_files = max( 0, (int) ( $def['min_files'] ?? 0 ) );
		if ( $min_files > 1 && 'file' === ( $def['type'] ?? '' ) ) {
			$sent = count( array_filter( array_map( 'trim', explode( ',', (string) $resolved['value'] ) ) ) );
			if ( $sent < $min_files ) {
				return new WP_Error(
					'bundle_boss',
					sprintf(
						/* translators: 1: the field's label, 2: the smallest number of files accepted, 3: how many arrived */
						__( '%1$s needs at least %2$s files. You have added %3$s.', 'addon-boss' ),
						(string) ( $def['label'] ?? '' ),
						number_format_i18n( $min_files ),
						number_format_i18n( $sent )
					)
				);
			}
		}
		// The product's own per-unit base, so a percent field takes its share of
		// the same figure the line is priced from.
		// The instance number is what a "once" fee is counted against, so each one
		// the shopper opens carries its own setup charge. Passing 0 for every
		// instance, as a field that asks once does, would let the first engraving
		// charge and silently give away the rest.
		//
		// This is also where the merchant chooses between the two ways a repeated
		// charge can behave, using the fee mode they already set:
		//   unit  a charge per instance ON EVERY ITEM. Two mugs, three engravings,
		//         six charges. The category's usual reading of a per-item fee.
		//   once  a charge per instance for the WHOLE LINE. Three engravings cost
		//         three setups however many mugs are bought, because the price seam
		//         spreads a "once" fee across the units.
		$fee  = addon_boss_personalisation_resolve_fee( $def, $resolved, $instance, $once_charged, addon_boss_options_base_price( $product ) );
		$snap = array(
			'key'      => (string) $def['key'],
			'label'    => $label,
			'type'     => (string) ( $def['type'] ?? 'text' ),
			'value'    => (string) $resolved['value'],
			'display'  => (string) $resolved['display'],
			'url'      => (string) ( $resolved['url'] ?? '' ),
			'fee'      => (float) $fee,
			'fee_mode' => (string) ( $def['fee_mode'] ?? 'unit' ),
		);
		// A colour's code rides beside its words so the admin order can paint a
		// real chip; a hidden field's row is marked for the admin's eyes so no
		// customer surface ever prints it. Absent keys stay absent, keeping every
		// other field's snapshot byte-identical to the one it has always written.
		if ( '' !== (string) ( $resolved['hex'] ?? '' ) ) {
			$snap['hex'] = (string) $resolved['hex'];
		}
		if ( '' !== (string) ( $resolved['display_cart'] ?? '' ) ) {
			// A type's shorter cart-only form rides beside the full display.
			$snap['display_cart'] = (string) $resolved['display_cart'];
		}
		if ( ! empty( $resolved['admin_only'] ) ) {
			$snap['admin_only'] = true;
		}
		// Whatever a module froze alongside the value (the typeface and colour
		// pick for a placement field that offers one) rides this seam, so the
		// cart row, the order line and a reorder all state the exact print.
		// With nothing registered the snapshot stays byte-identical to the one
		// this engine has always written.
		$snap = (array) apply_filters( 'addon_boss_standalone_field_snapshot', $snap, $def, $source );
		if ( $instance > 0 ) {
			// Which one of several this is. Written ONLY for a repeatable field,
			// so an ordinary field's snapshot stays byte-identical to the one it
			// has always written and every order already placed reads back
			// unchanged.
			$snap['instance'] = $instance;
			if ( ! empty( $row['spread'] ) ) {
				// A per-item repeat opens one instance for every unit bought, so
				// the instances already scale with the quantity. WooCommerce then
				// multiplies the unit price by that same quantity, which would
				// charge six names on six shirts thirty-six times over. Marked to
				// be spread across the units, exactly as a "once" fee is, so the
				// line lands back on one charge per name.
				$snap['spread'] = true;
			}
		}
		$snapshots[] = $snap;
	}
	return $snapshots;
}

/**
 * A field snapshot's frozen charge as a display suffix, or '' for no charge.
 * Fees are never negative (the sanitiser floors at zero), so the sign is
 * always '+'. Converts through the SAME helper the option rows use, so a
 * field's money reads in the same basis as a set's on the same line.
 */
function addon_boss_standalone_field_charge_suffix( array $fsnap, $product, string $context ): string {
	$fee = (float) ( $fsnap['fee'] ?? 0 );
	if ( $fee <= 0.0 || ! $product instanceof WC_Product ) {
		return '';
	}
	// Plain text, never wc_price markup: this suffix rides in cart meta and
	// order rows, which render wherever our CSS does not follow (the block
	// cart, the emails), and a dual-basis tax plugin filtering wc_price
	// prints both of its figures mashed together there.
	$shown = addon_boss_money( $fee, $product, array( 'plain' => true, 'context' => $context ) );

	// NEVER THE SAME FIGURE TWICE ON ONE LINE. Where a shopper names the amount
	// themselves, the answer already IS the charge, and the cart read
	// "Add a tip for the maker: GBP 5.00 (+GBP 5.00)". Said once is the whole
	// truth. They part company only where the answer was typed in one basis and
	// the cart is read in another, and then the pair is worth printing: GBP 5.00
	// named, GBP 6.00 to pay.
	if ( isset( $fsnap['display'] ) && (string) $fsnap['display'] === $shown ) {
		return '';
	}

	return ' (' . addon_boss_money( $fee, $product, array( 'plain' => true, 'sign' => true, 'context' => $context ) ) . ')';
}

// =================================================================
// STANDALONE SURFACE part 2: native-WooCommerce cart/order path (validate,
// capture, price, cart display, order line, order-again). Lifted from
// slot-options; registers once via the load-once engine (no double-charge).
// =================================================================

// ---- Validate + capture -----------------------------------------

add_filter( 'woocommerce_add_to_cart_validation', 'addon_boss_validate_standalone_options', 10, 6 );

function addon_boss_validate_standalone_options( $passed, $product_id, $quantity = 1, $variation_id = 0, $variations = array(), $cart_item_data = array() ) {
	if ( ! $passed ) {
		return $passed;
	}
	// A bundle add configures its components through the bundle's own gate.
	if ( isset( $_REQUEST['bundle_selections'] ) || isset( $_REQUEST['bundle_id'] ) ) { // phpcs:ignore WordPress.Security.NonceVerification.Recommended -- presence check only, to stand down for the bundle's own flow.
		return $passed;
	}
	// Order again hands the restored snapshots through (6th argument): they
	// were validated at the original add and deliberately keep their charge.
	if ( is_array( $cart_item_data )
		&& ( ! empty( $cart_item_data['bundle_boss'] ) || isset( $cart_item_data[ ADDON_BOSS_STANDALONE_OPTIONS_KEY ] ) || isset( $cart_item_data[ ADDON_BOSS_STANDALONE_UPLOAD_KEY ] ) || isset( $cart_item_data[ ADDON_BOSS_PRODUCT_FIELDS_KEY ] ) ) ) {
		return $passed;
	}
	$product = wc_get_product( absint( $product_id ) );
	if ( ! $product || ( ! addon_boss_standalone_option_sets( $product ) && ! addon_boss_standalone_product_fields( $product ) ) ) {
		return $passed;
	}
	$result = addon_boss_standalone_option_snapshots( $product, $_REQUEST ); // phpcs:ignore WordPress.Security.NonceVerification.Recommended -- WooCommerce's add-to-cart flow carries no nonce; each field is sanitised and resolved against the stored set inside.
	if ( is_wp_error( $result ) ) {
		wc_add_notice( $result->get_error_message(), 'error' );
		return false;
	}
	// Per-option stock: refuse an over-order, counting what the cart already
	// holds, less the line this request is replacing.
	$bb_stock = addon_boss_check_option_stock(
		$product,
		is_array( $result ) ? $result : array(),
		(int) $quantity,
		addon_boss_editing_cart_line( absint( $product_id ) )
	);
	if ( is_wp_error( $bb_stock ) ) {
		wc_add_notice( $bb_stock->get_error_message(), 'error' );
		return false;
	}
	// Fields share the gate: a required (or "required once personalising")
	// field left empty blocks the add, unless it is hidden by an unmet reveal
	// rule, in which case it is inert and never asked for.
	if ( addon_boss_standalone_product_fields( $product ) ) {
		$fields = addon_boss_standalone_field_snapshots( $product, $_REQUEST ); // phpcs:ignore WordPress.Security.NonceVerification.Recommended -- each field sanitised and resolved inside.
		if ( is_wp_error( $fields ) ) {
			wc_add_notice( $fields->get_error_message(), 'error' );
			return false;
		}
	}
	return $passed;
}

/**
 * Whether a product cannot go in the cart until the shopper answers something
 * on its page: the add-to-cart check above, asked with nothing picked.
 *
 * Shop and category pages then offer "Select options" and open the product,
 * as WooCommerce does for a product with variations and as the add-on plugins
 * shoppers know do. Their Add to cart went to the product page with a red
 * "Please choose ..." instead (fresh testers, 18 Oct 2026). Optional sets
 * never stop an add, so a product with only those keeps its Add to cart.
 *
 * @param mixed $product The product a listing shows.
 */
function addon_boss_listing_needs_choices( $product ): bool {
	if ( ! $product instanceof WC_Product || ! $product->is_purchasable() || ! $product->is_in_stock() ) {
		return false;
	}
	if ( addon_boss_standalone_option_sets( $product ) && is_wp_error( addon_boss_standalone_option_snapshots( $product, array() ) ) ) {
		return true;
	}
	return addon_boss_standalone_product_fields( $product ) && is_wp_error( addon_boss_standalone_field_snapshots( $product, array() ) );
}

add_filter(
	'woocommerce_product_add_to_cart_text',
	static function ( $text, $product = null ) {
		return addon_boss_listing_needs_choices( $product ) ? __( 'Select options', 'addon-boss' ) : $text;
	},
	20,
	2
);
// What a screen reader hears on that button, as WooCommerce says it for a
// product with variations: it read "Add to cart: ..." under "Select options".
add_filter(
	'woocommerce_product_add_to_cart_description',
	static function ( $text, $product = null ) {
		/* translators: %s: the product's name */
		return addon_boss_listing_needs_choices( $product ) ? sprintf( __( 'Select options for “%s”', 'addon-boss' ), $product->get_name() ) : $text;
	},
	20,
	2
);
add_filter(
	'woocommerce_product_add_to_cart_url',
	static function ( $url, $product = null ) {
		return addon_boss_listing_needs_choices( $product ) ? $product->get_permalink() : $url;
	},
	20,
	2
);
add_filter(
	'woocommerce_product_supports',
	static function ( $supports, $feature = '', $product = null ) {
		return ( 'ajax_add_to_cart' === $feature && addon_boss_listing_needs_choices( $product ) ) ? false : $supports;
	},
	20,
	3
);


add_filter( 'woocommerce_add_cart_item_data', 'addon_boss_capture_standalone_options', 10, 4 );

function addon_boss_capture_standalone_options( $cart_item_data, $product_id, $variation_id = 0, $quantity = 1 ) {
	if ( ! is_array( $cart_item_data ) ) {
		$cart_item_data = array();
	}
	// A bundle add configures its components through the bundle's own gate, so
	// the picks are not re-read here. The one thing that gate cannot know is
	// our per-option count, and a jar sold inside a bundle comes off the same
	// shelf as one sold on its own page, so that is checked before the bundle
	// reaches the cart. The payload already carries validated selections.
	if ( ! empty( $cart_item_data['bundle_boss'] ) ) {
		$bb_demand = addon_boss_bundle_option_demand(
			$cart_item_data['bundle_boss']['selections'] ?? array(),
			max( 1, (int) $quantity )
		);
		foreach ( $bb_demand as $bb_row ) {
			$bb_short = addon_boss_check_option_stock(
				null,
				array(
					array(
						'set'   => $bb_row['set'],
						'key'   => $bb_row['key'],
						'label' => $bb_row['label'],
					),
				),
				(int) $bb_row['qty']
			);
			if ( is_wp_error( $bb_short ) ) {
				throw new Exception( esc_html( $bb_short->get_error_message() ) );
			}
		}
		return $cart_item_data;
	}
	// A line arriving with snapshots already made (order again, or any
	// programmatic add that built its own picks) keeps them: they were
	// resolved and priced once and must not be re-read from the request.
	// Stock is the exception. What was on the shelf when the first order was
	// placed can be gone now, so the count is asked again even though the
	// picks are not.
	if ( isset( $cart_item_data[ ADDON_BOSS_STANDALONE_OPTIONS_KEY ] ) || isset( $cart_item_data[ ADDON_BOSS_STANDALONE_UPLOAD_KEY ] ) || isset( $cart_item_data[ ADDON_BOSS_PRODUCT_FIELDS_KEY ] ) ) {
		$bb_restored = $cart_item_data[ ADDON_BOSS_STANDALONE_OPTIONS_KEY ] ?? array();
		$bb_product  = is_array( $bb_restored ) && $bb_restored ? wc_get_product( absint( $product_id ) ) : null;
		if ( $bb_product ) {
			$bb_stock = addon_boss_check_option_stock( $bb_product, $bb_restored, max( 1, (int) $quantity ) );
			if ( is_wp_error( $bb_stock ) ) {
				throw new Exception( esc_html( $bb_stock->get_error_message() ) );
			}
		}
		return $cart_item_data;
	}
	$product = wc_get_product( absint( $product_id ) );
	if ( ! $product || ( ! addon_boss_standalone_option_sets( $product ) && ! addon_boss_standalone_product_fields( $product ) ) ) {
		return $cart_item_data;
	}
	$result = addon_boss_standalone_option_snapshots( $product, $_REQUEST ); // phpcs:ignore WordPress.Security.NonceVerification.Recommended -- WooCommerce's add-to-cart flow carries no nonce; each field is sanitised and resolved against the stored set inside.
	if ( is_wp_error( $result ) ) {
		// Direct adds (Store API, programmatic) skip the form handler's
		// validation gate; throwing keeps a required choice from selling
		// unchosen, the same discipline as addon_boss_require_configuration.
		throw new Exception( esc_html( $result->get_error_message() ) );
	}
	// Per-option stock enforced here, because this is the only seam every add
	// passes through: WC_Cart::add_to_cart never fires the validation filter
	// itself, so a Store API, quick-order or otherwise programmatic add would
	// reach the cart unchecked. The quantity being added arrives as this
	// filter's own argument, which is the only number worth checking: a posted
	// one can be absent (a JSON request carries none) or simply differ.
	$bb_stock = addon_boss_check_option_stock(
		$product,
		is_array( $result ) ? $result : array(),
		max( 1, (int) $quantity ),
		addon_boss_editing_cart_line( absint( $product_id ) )
	);
	if ( is_wp_error( $bb_stock ) ) {
		throw new Exception( esc_html( $bb_stock->get_error_message() ) );
	}
	if ( $result ) {
		// Distinct picks make distinct cart_item_data, which WooCommerce's
		// generate_cart_id() hashes: different combinations never merge
		// into one line, identical ones still do. No extra key needed.
		$cart_item_data[ ADDON_BOSS_STANDALONE_OPTIONS_KEY ] = $result;
	}
	// Fields resolve and freeze the same way, under their own key so a
	// fields-only line still hashes distinctly per input (the frozen fee is
	// what the price seam charges).
	$fields = addon_boss_standalone_product_fields( $product );
	if ( $fields ) {
		$fresult = addon_boss_standalone_field_snapshots( $product, $_REQUEST ); // phpcs:ignore WordPress.Security.NonceVerification.Recommended -- each field sanitised and resolved inside.
		if ( is_wp_error( $fresult ) ) {
			// Direct adds (Store API, programmatic) skip the form gate; throwing
			// keeps a required field from selling unfilled, the same discipline
			// the option snapshots keep above.
			throw new Exception( esc_html( $fresult->get_error_message() ) );
		}
		if ( $fresult ) {
			$cart_item_data[ ADDON_BOSS_PRODUCT_FIELDS_KEY ] = $fresult;
		}
	}
	return $cart_item_data;
}

// Order again: restore the snapshots from the order line so the re-order
// charges what the original charged (the reorder-undercharge lesson; the
// bundle path restores its selections the same way).
add_filter( 'woocommerce_order_again_cart_item_data', 'addon_boss_standalone_order_again', 10, 2 );

function addon_boss_standalone_order_again( $cart_item_data, $item ) {
	$snaps = $item->get_meta( '_bundle_boss_standalone_options' );
	if ( ! empty( $snaps ) && is_array( $snaps ) ) {
		$cart_item_data[ ADDON_BOSS_STANDALONE_OPTIONS_KEY ] = $snaps;
	}
	// The upload comes back only if its file still exists (kept uploads
	// survive cleanup; a vanished file restores as no file, never an error).
	$up = $item->get_meta( ADDON_BOSS_STANDALONE_UPLOAD_META );
	if ( is_array( $up ) && function_exists( 'addon_boss_personalisation_resolve_upload' )
		&& addon_boss_personalisation_resolve_upload( (string) ( $up['ref'] ?? '' ) ) ) {
		$cart_item_data[ ADDON_BOSS_STANDALONE_UPLOAD_KEY ] = $up;
	}
	// The fields restore straight from the frozen snapshots, so a re-order
	// charges exactly what the original did (a file field carries its
	// reference; a vanished upload simply reads as no file when re-resolved).
	$fsnaps = $item->get_meta( ADDON_BOSS_PRODUCT_FIELDS_META );
	if ( ! empty( $fsnaps ) && is_array( $fsnaps ) ) {
		$cart_item_data[ ADDON_BOSS_PRODUCT_FIELDS_KEY ] = $fsnaps;
	}
	return $cart_item_data;
}

// ---- Price ------------------------------------------------------

/**
 * The product's price in the STORE'S BASE currency, for building a cart
 * price that a currency switcher then converts exactly once.
 *
 * get_price() returns the VIEW price, which a switcher (WOOCS, Aelia, FOX,
 * WPML multi-currency) has already converted to the active currency. Adding
 * raw option fees to that and handing the sum to set_price() lets the
 * switcher convert the whole line AGAIN, a confirmed double charge (a
 * banner that should cost the equivalent of 37 was billed 134 instead of
 * 74 under WOOCS). When the active currency differs from the store's base,
 * we read the UNCONVERTED base (the 'edit' context bypasses the price
 * filters) so base + fees is one clean base-currency figure the switcher
 * converts once. When no switcher is converting, which is every ordinary
 * store and even a switcher store viewing in its base currency, active
 * equals base and this returns exactly get_price(), so nothing else is
 * touched: sales, tax, and role-based pricing all behave as before.
 */
function addon_boss_options_base_price( WC_Product $product ): float {
	// One currency rule for the whole plugin: the bundle sum reads components
	// through addon_boss_base_price() (core) with this exact logic, so the
	// standalone line shares it rather than keeping a second copy that can drift.
	return addon_boss_base_price( $product );
}

add_action( 'woocommerce_before_calculate_totals', 'addon_boss_price_standalone_options', 10 );

/*
 * 🔴 PRICED ON LOAD TOO, NOT ONLY WHEN TOTALS ARE CALCULATED.
 *
 * WooCommerce's mini-cart prints each line from the line's own product object,
 * and the request that refreshes it (and every theme's side cart built on it)
 * rebuilds the cart from the session without calculating totals. Priced only in
 * before_calculate_totals, the drawer showed the bare product price: "7 x
 * £19.00" on a shop whose line was really £63.88 (12 Oct 2026, AOB #106), with
 * the correct total right underneath it. Pricing again here is safe: each pass
 * starts from a fresh product, so nothing is added twice.
 */
add_action( 'woocommerce_cart_loaded_from_session', 'addon_boss_price_standalone_options', 20 );

function addon_boss_price_standalone_options( $cart ): void {
	if ( is_admin() && ! defined( 'DOING_AJAX' ) ) {
		return;
	}
	foreach ( $cart->get_cart() as $item ) {
		$bb_pos_snaps = defined( 'ADDON_BOSS_POSITIONS_KEY' ) ? (array) ( $item[ ADDON_BOSS_POSITIONS_KEY ] ?? array() ) : array();
		// A module can claim a line that carries no option data at all (a
		// quantity-banded product bought plain still needs its unit repriced).
		// Bundled lines are never claimable: the bundle owns their price.
		$bb_forced = apply_filters( 'addon_boss_price_line_forced', false, $item );
		if ( ! empty( $item['bundle_boss'] )
			|| ( ! $bb_forced && empty( $item[ ADDON_BOSS_STANDALONE_OPTIONS_KEY ] ) && empty( $item[ ADDON_BOSS_PRODUCT_FIELDS_KEY ] ) && ! $bb_pos_snaps ) ) {
			continue;
		}
		// A FRESH product each pass: this hook runs repeatedly and the line's
		// own object already carries the previous pass's price, so deriving
		// from it would compound the fees. On a variable line the VARIATION
		// is the base (the parent would answer with its cheapest variation,
		// the exact undercharge every rival's changelog admits to).
		$base_id = (int) ( $item['variation_id'] ?? 0 );
		$base    = wc_get_product( $base_id ? $base_id : (int) ( $item['product_id'] ?? 0 ) );
		if ( ! $base ) {
			continue;
		}
		// Fees accumulate in THREE buckets, because a discount module must be
		// able to tell them apart: unit fees scale with the quantity (an option
		// delta, a per-item charge) and may fairly be discounted with the
		// product; position fees are per-item print and embroidery money, held
		// apart so a shop can tier its options while its needlework holds firm
		// (Stefanos, 23 Aug); spread fees are whole-line charges divided across
		// the units (a setup charge is one piece of work at any quantity) and
		// must never be touched by anything.
		$unit_fees     = 0.0;
		$position_fees = 0.0;
		$spread_fees   = 0.0;
		// The same per-item money, fee by fee. A module that takes a percentage
		// off rounds each fee to the penny, as the page prints each one on its
		// own line; the sums above cannot tell it where one fee ends.
		$unit_fee_list     = array();
		$position_fee_list = array();
		$qty         = max( 1, (int) ( $item['quantity'] ?? 1 ) );
		$table_set_base = null;
		foreach ( (array) ( $item[ ADDON_BOSS_STANDALONE_OPTIONS_KEY ] ?? array() ) as $snap ) {
			// A look-up table on the "sets the whole price" basis REPLACES the product
			// base (a 60x90 sign IS 68.00, not the product price plus 68), and so
			// does a whole-price measured size. Every other option (an add-basis
			// table, a choice delta, an older measured charge) adds on.
			if ( addon_boss_snap_replaces_base( $snap ) ) {
				$table_set_base = (float) ( $snap['delta'] ?? 0 );
				// A once-for-the-line adjustment (a rush charge on a priced grid)
				// is a whole-line amount whatever the quantity, exactly like a
				// 'once' field fee, so it spreads the same way and WooCommerce's
				// per-unit times quantity lands back on the one charge.
				$spread_fees += (float) ( $snap['adj_once'] ?? 0 ) / $qty;
				continue;
			}
			// A set the shop charges once (a design service, an artwork setup)
			// is whole-line money like a 'once' field: spread across the units
			// so WooCommerce's per-unit times quantity lands back on the one
			// charge. The flag was set when the line was resolved.
			if ( ! empty( $snap['once'] ) ) {
				$spread_fees += (float) ( $snap['delta'] ?? 0 ) / $qty;
				$spread_fees += (float) ( $snap['adj_once'] ?? 0 ) / $qty;
				continue;
			}
			$unit_fees += (float) ( $snap['delta'] ?? 0 );
			$unit_fee_list[] = (float) ( $snap['delta'] ?? 0 );
			$spread_fees += (float) ( $snap['adj_once'] ?? 0 ) / $qty;
		}
		// Product-field fees fold into the SAME per-unit price. A 'once' field is
		// a whole-line charge, so it is spread across the units (fee / qty) and
		// WooCommerce's per-unit x quantity lands back on exactly one fee; every
		// other mode is per-unit and multiplies natively. Deliberately NOT
		// rounded here: the unit price is an intermediate WooCommerce rounds into
		// the line total (£12 over 7 units is £1.714…, and pre-rounding loses 3p).
		foreach ( (array) ( $item[ ADDON_BOSS_PRODUCT_FIELDS_KEY ] ?? array() ) as $fsnap ) {
			$fee = (float) ( $fsnap['fee'] ?? 0 );
			if ( 0.0 === $fee ) {
				continue;
			}
			// A per-item repeat opened one instance for every unit being bought,
			// and the instances were frozen at that moment. Lower the quantity in
			// the cart afterwards and the instances above the new one are not
			// being bought any more, so they must stop charging: six names on a
			// line cut to two shirts is two names. The stored values are left
			// alone, so putting the quantity back puts the names back.
			if ( ! empty( $fsnap['spread'] ) && (int) ( $fsnap['instance'] ?? 0 ) > $qty ) {
				continue;
			}
			// Two things are whole-line charges and so are spread across the units:
			// a "once" fee by its mode, and one instance of a per-item repeatable
			// field, because those instances ALREADY scale with the quantity and
			// would otherwise be multiplied by it a second time.
			$spread = ( 'once' === ( $fsnap['fee_mode'] ?? 'unit' ) ) || ! empty( $fsnap['spread'] );
			if ( $spread ) {
				$spread_fees += $fee / $qty;
			} else {
				$unit_fees += $fee;
				$unit_fee_list[] = $fee;
			}
		}
		// Chosen positions charge exactly the same way: 'once' is a setup charge for
		// the line however many are bought, so it is spread across the units and
		// WooCommerce's per-unit times quantity lands back on one fee; 'unit' is per
		// item and multiplies natively. Same seam, same tax treatment, so a position
		// can never be taxed differently from the thing it is printed on.
		foreach ( $bb_pos_snaps as $psnap ) {
			$pfee = (float) ( $psnap['fee'] ?? 0 );
			if ( 0.0 !== $pfee ) {
				if ( 'once' === ( $psnap['fee_mode'] ?? 'once' ) ) {
					$spread_fees += $pfee / $qty;
				} else {
					$position_fees += $pfee;
					$position_fee_list[] = $pfee;
				}
			}
			// Tidying up a logo is one piece of work on one file, so it is charged
			// once whatever the position's own mode is. Folded into the fee it
			// followed that mode, and a per-item position multiplied it.
			$phelp = (float) ( $psnap['help_fee'] ?? 0 );
			if ( 0.0 !== $phelp ) {
				$spread_fees += $phelp / $qty;
			}
		}
		// Raw plus raw, exactly like the bundle's unit seam: set_price() takes
		// the store's entry basis and WooCommerce taxes it natively. Per unit;
		// the line quantity multiplies through WooCommerce's own maths. Floored
		// at zero: a merchant can price an option BELOW zero (a "strip it back,
		// -5" choice), and a line cheaper than its own options must read as free,
		// never a negative price that quietly discounts the rest of the cart.
		//
		// The parts pass through one filter before they are summed, so a module
		// can band the base by quantity or discount the per-unit money, each
		// kind under its own tick, while the spread fees stay exactly as
		// computed. With nothing hooked the sum is identical to base + fees.
		$line_base = ( null !== $table_set_base ) ? $table_set_base : addon_boss_options_base_price( $base );
		$bb_parts  = apply_filters(
			'addon_boss_line_price_parts',
			array(
				'base'          => $line_base,
				'unit_fees'     => $unit_fees,
				'position_fees' => $position_fees,
				'spread_fees'   => $spread_fees,
				// True when an option (a table set to own the whole price)
				// replaced the product's base, so a module knows the base is
				// not the product's own price. Informational; never summed.
				'base_is_replaced' => ( null !== $table_set_base ),
				// Each per-item fee on its own, in the order it was added.
				// Informational; never summed.
				'unit_fee_list'     => $unit_fee_list,
				'position_fee_list' => $position_fee_list,
			),
			$item,
			$base,
			$qty
		);
		$bb_price = max( 0.0, (float) $bb_parts['base'] + (float) $bb_parts['unit_fees'] + (float) ( $bb_parts['position_fees'] ?? 0 ) + (float) $bb_parts['spread_fees'] );
		$item['data']->set_price( $bb_price );
		// THE LINE'S OWN "WAS" PRICE, NEVER THE PRODUCT'S. The Cart block and
		// anything reading the Store API strike through the line product's
		// regular price wherever it is above the price, and that was still the
		// bare product's: an acrylic sign at £29.82 whose small custom size
		// came to £25.00 read "£29.82 £25.00, Save £4.82", a sale that never
		// was (tester round 3, 18 Oct 2026). The regular price is now this
		// same line at the product's regular price, before any quantity break,
		// so only a real saving reads as one: a sale on the product, or a
		// band. A size that sets the whole price has no product price in it.
		$bb_reg_raw  = get_option( 'woocommerce_currency' ) !== get_woocommerce_currency() ? $base->get_regular_price( 'edit' ) : $base->get_regular_price();
		$bb_reg_base = ( null === $table_set_base && '' !== (string) $bb_reg_raw ) ? max( $line_base, (float) $bb_reg_raw ) : $line_base;
		$bb_full     = $bb_reg_base + $unit_fees + $position_fees + $spread_fees;
		// Compared to the penny, so float dust never draws a "Save £0.00".
		$bb_on_sale  = addon_boss_round_money( $bb_full ) > addon_boss_round_money( $bb_price );
		$item['data']->set_regular_price( $bb_on_sale ? $bb_full : $bb_price );
		$item['data']->set_sale_price( $bb_on_sale ? $bb_price : '' );
	}
}

// ---- Display + order --------------------------------------------

/**
 * Give every cart meta row the 'key' the Store API reads. The classic cart
 * backfills it from 'name' (wc_get_formatted_cart_item_data); the Store API
 * does not, so on a block-theme cart each row printed "undefined" where its
 * label belongs. Applied at every exit of the item-data filter below.
 *
 * @param array $data The filter's rows so far.
 * @return array The same rows, each with a key.
 */
function addon_boss_cart_rows_keyed( array $data ): array {
	foreach ( $data as &$bb_row ) {
		if ( is_array( $bb_row ) && ! isset( $bb_row['key'] ) && isset( $bb_row['name'] ) ) {
			$bb_row['key'] = $bb_row['name'];
		}
	}
	unset( $bb_row );
	return $data;
}

/**
 * The snapshot as its own row prices it. A priced grid with named adjustments
 * prints each adjustment as a row of its own, so the size's row shows the
 * grid's own price, the figure those rows are added to. Showing the grown
 * price there read "(£94.30)" above "Blackout lining: +15% (£12.30)": rows
 * that add to £106.60 on a £94.30 line. A snapshot from before adj_base
 * existed keeps its old row.
 *
 * @param array $snap One option snapshot.
 * @return array The snapshot whose delta is the money its row shows.
 */
function addon_boss_snap_row_money( array $snap ): array {
	if ( ! empty( $snap['adj_lines'] ) && isset( $snap['adj_base'] ) ) {
		$snap['delta'] = (float) $snap['adj_base'];
	}
	return $snap;
}

/**
 * Where each answer sits on the product page: 'set:<id>' and 'field:<key>'
 * to its position, in the merchant's row order, with a quantity grid's own
 * colour and size first because the grid draws them above everything else.
 *
 * @param mixed $product The line's product (the parent, never a variation).
 * @return array<string,int>
 */
function addon_boss_line_row_positions( $product ): array {
	if ( ! $product instanceof WC_Product ) {
		return array();
	}
	$bb_at = array();
	$bb_i  = 0;
	if ( function_exists( 'addon_boss_product_uses_grid' ) && function_exists( 'addon_boss_grid_split_sets' ) && addon_boss_product_uses_grid( $product ) ) {
		foreach ( (array) addon_boss_grid_split_sets( $product )['matrix_ids'] as $bb_sid ) {
			$bb_at[ 'set:' . $bb_sid ] = $bb_i++;
		}
	}
	foreach ( addon_boss_flatten_option_config( (array) addon_boss_product_option_config( $product ) ) as $bb_row ) {
		if ( '' !== (string) ( $bb_row['set'] ?? '' ) ) {
			$bb_k = 'set:' . $bb_row['set'];
		} elseif ( '' !== (string) ( $bb_row['field']['key'] ?? '' ) ) {
			$bb_k = 'field:' . $bb_row['field']['key'];
		} else {
			continue;
		}
		if ( ! isset( $bb_at[ $bb_k ] ) ) {
			$bb_at[ $bb_k ] = $bb_i++;
		}
	}
	return $bb_at;
}

/**
 * A line's answer rows in the order the product page asks them.
 *
 * The rows were written fields first and choices second, so a cap's
 * embroidery came after the initials stitched under it and a hoodie's
 * artwork tick box read above its colour (tester round 3, 18 Oct 2026).
 *
 * Each list is already in its own right order and is never re-sorted: the
 * field rows were ordered at capture, a repeated group block by block
 * ("Engraving 1: Words, Engraving 1: Font, Engraving 2: ..."), and the option
 * rows follow their sets. The two lists are MERGED, each row carrying the
 * position of the answer it came from; a row whose answer has left the
 * product since waits for the other list rather than jump ahead of it.
 *
 * @param array<int,array{at:?int,row:array}> $fields  The field rows, in order.
 * @param array<int,array{at:?int,row:array}> $options The option rows, in order.
 * @return array<int,array> The rows alone, in page order.
 */
function addon_boss_line_rows_in_page_order( array $fields, array $options ): array {
	$fields  = array_values( $fields );
	$options = array_values( $options );
	$bb_pos  = static function ( array $r ): int {
		return null === $r['at'] ? PHP_INT_MAX : (int) $r['at'];
	};
	$out = array();
	$fi  = 0;
	$oi  = 0;
	while ( $fi < count( $fields ) || $oi < count( $options ) ) {
		$bb_take_field = $oi >= count( $options )
			|| ( $fi < count( $fields ) && $bb_pos( $fields[ $fi ] ) <= $bb_pos( $options[ $oi ] ) );
		$out[] = $bb_take_field ? $fields[ $fi++ ]['row'] : $options[ $oi++ ]['row'];
	}
	return $out;
}

/**
 * A line's option rows: one per answered set, in its snapshots' order. A set
 * where the shopper picks several reads its name once with the picks after
 * it ("Print positions: Left chest (+£4.00), Full back (+£8.00)"), where it
 * repeated the name for every pick, in the cart, at checkout and on the
 * order (tester round 3). A priced grid's named adjustment reads on the row
 * of the choice that triggered it, the way a choice's own price does:
 * "Material: Dibond (+45%, £9.90)", "Card extras: Rounded corners (+£6.00),
 * Spot UV (+15%, £5.99)". It read as a row of its own named by the
 * adjustment, above the choice's row when the table came first on the page,
 * and the choice's row said its name with no price (tester round 4). An
 * adjustment whose choice no row of this line prints (a line saved before
 * the trigger was kept on it) keeps a row of its own after its size.
 *
 * The cart's rows also carry a display copy whose prices never break inside
 * their brackets (addon_boss_suffix_nowrap()); the order's rows stay plain.
 *
 * @param array      $snaps   The line's option snapshots.
 * @param mixed      $product The product, for the display basis.
 * @param array      $at      The page positions (addon_boss_line_row_positions).
 * @param bool       $plain   True for the order's plain-text rows.
 * @return array<int,array{at:?int,row:array}>
 */
function addon_boss_line_option_rows( array $snaps, $product, array $at, bool $plain ): array {
	// Which choices this line prints a row for, and the adjustments each says.
	$bb_picked = array();
	foreach ( $snaps as $snap ) {
		if ( '' !== (string) ( $snap['label'] ?? '' ) ) {
			$bb_picked[ (string) ( $snap['set'] ?? '' ) . '|' . (string) ( $snap['key'] ?? '' ) ] = true;
		}
	}
	$bb_folds = array(); // "set|key" => the adjustment lines that choice's row says.
	if ( function_exists( 'addon_boss_table_adj_choice_text' ) ) {
		foreach ( $snaps as $snap ) {
			foreach ( (array) ( $snap['adj_lines'] ?? array() ) as $bb_adj ) {
				$bb_trig = (string) ( $bb_adj['set'] ?? '' ) . '|' . (string) ( $bb_adj['value'] ?? '' );
				if ( '' !== (string) ( $bb_adj['set'] ?? '' ) && isset( $bb_picked[ $bb_trig ] ) ) {
					$bb_folds[ $bb_trig ][] = (array) $bb_adj;
				}
			}
		}
	}
	$bb_rows = array();
	$bb_prev = null; // the set whose row the next pick of the same set joins.
	foreach ( $snaps as $snap ) {
		$label = (string) ( $snap['label'] ?? '' );
		if ( '' === $label ) {
			continue;
		}
		$bb_sid    = (string) ( $snap['set'] ?? '' );
		$bb_suffix = addon_boss_standalone_charge_suffix( addon_boss_snap_row_money( $snap ), $product, 'cart' );
		$bb_fold   = $bb_folds[ $bb_sid . '|' . (string) ( $snap['key'] ?? '' ) ] ?? array();
		// A size that prices the whole product says no price of its own: the
		// line's price is that size's price, and "(£29.81)" beside it said it
		// twice (owner, 30 Oct 2026).
		if ( 'measure' === (string) ( $snap['key'] ?? '' ) && 'set' === (string) ( $snap['basis'] ?? '' ) ) {
			$bb_suffix = '';
		}
		if ( $bb_fold ) {
			// The choice's own price first, then each adjustment it triggers;
			// a semicolon parts two charges, as a comma already parts picks.
			$bb_bits = '' !== $bb_suffix ? array( substr( trim( wp_strip_all_tags( $bb_suffix ) ), 1, -1 ) ) : array();
			foreach ( $bb_fold as $bb_adj ) {
				$bb_bits[] = addon_boss_table_adj_choice_text( $bb_adj, $product, 'cart' );
			}
			$bb_suffix = ' (' . implode( '; ', $bb_bits ) . ')';
		}
		// A line saved before each size charged had a row of its own carries
		// it at the end of its label, and reads as it always did: the price
		// rides the size typed, then the size charged follows, "1800 × 450 mm
		// (£2,503.83); Glass charged as 6 × 1.5 ft" (walk 2, 28 Oct 2026).
		$bb_tail = is_string( $snap['charged'] ?? null ) ? (string) $snap['charged'] : '';
		if ( '' !== $bb_tail && '' !== $bb_suffix && strlen( $label ) > strlen( $bb_tail ) + 2
			&& '; ' . $bb_tail === substr( $label, -( strlen( $bb_tail ) + 2 ) ) ) {
			$bb_head    = substr( $label, 0, -( strlen( $bb_tail ) + 2 ) );
			$bb_value   = $bb_head . ( $plain ? addon_boss_standalone_suffix_text( $bb_suffix ) : $bb_suffix ) . '; ' . $bb_tail;
			$bb_display = $bb_head . addon_boss_suffix_nowrap( $bb_suffix ) . '; ' . $bb_tail;
		} else {
			$bb_value   = $label . ( $plain ? addon_boss_standalone_suffix_text( $bb_suffix ) : $bb_suffix );
			$bb_display = $label . addon_boss_suffix_nowrap( $bb_suffix );
		}
		if ( null !== $bb_prev && '' !== $bb_sid && $bb_sid === $bb_prev ) {
			$bb_last = count( $bb_rows ) - 1;
			$bb_rows[ $bb_last ]['row']['value'] .= ', ' . $bb_value;
			if ( ! $plain ) {
				$bb_rows[ $bb_last ]['row']['display'] .= ', ' . $bb_display;
			}
			continue;
		}
		$bb_row = array(
			'name'  => '' !== (string) ( $snap['set_name'] ?? '' ) ? (string) $snap['set_name'] : __( 'Option', 'addon-boss' ),
			'value' => $bb_value,
		);
		if ( ! $plain ) {
			$bb_row['display'] = $bb_display;
		}
		$bb_rows[] = array(
			'at'  => $at[ 'set:' . $bb_sid ] ?? null,
			'row' => $bb_row,
		);
		$bb_prev = $bb_sid;
		// Each size a measured size is charged as, a row of its own under it:
		// "Charged as: 650 × 570 mm (50 mm added)" (measured_charge).
		if ( is_array( $snap['charged'] ?? null ) ) {
			foreach ( $snap['charged'] as $bb_ch ) {
				if ( ! is_array( $bb_ch ) || '' === (string) ( $bb_ch['name'] ?? '' ) || '' === (string) ( $bb_ch['value'] ?? '' ) ) {
					continue;
				}
				$bb_ch_row = array(
					'name'  => (string) $bb_ch['name'],
					'value' => (string) $bb_ch['value'],
				);
				if ( ! $plain ) {
					$bb_ch_row['display'] = (string) $bb_ch['value'];
				}
				$bb_rows[] = array(
					'at'  => $at[ 'set:' . $bb_sid ] ?? null,
					'row' => $bb_ch_row,
				);
				$bb_prev = null;
			}
		}
		// An adjustment whose choice has no row here reads as a row of its
		// own after its size, so "Second colour +10% (5.80)" is auditable at
		// every hop rather than vanishing into one grown figure. The module
		// that computed it owns the wording; without it the line does not print.
		if ( ! empty( $snap['adj_lines'] ) && function_exists( 'addon_boss_table_adj_line_text' ) ) {
			foreach ( (array) $snap['adj_lines'] as $bb_adj ) {
				$bb_trig = (string) ( $bb_adj['set'] ?? '' ) . '|' . (string) ( $bb_adj['value'] ?? '' );
				if ( isset( $bb_folds[ $bb_trig ] ) ) {
					continue;
				}
				$bb_adj_text = addon_boss_table_adj_line_text( (array) $bb_adj, $product, 'cart' );
				$bb_adj_row  = array(
					'name'  => (string) ( $bb_adj['name'] ?? '' ),
					'value' => $bb_adj_text,
				);
				if ( ! $plain ) {
					$bb_adj_row['display'] = addon_boss_suffix_nowrap( $bb_adj_text );
				}
				$bb_rows[] = array(
					'at'  => $at[ 'set:' . $bb_sid ] ?? null,
					'row' => $bb_adj_row,
				);
				$bb_prev = null; // a pick after the adjustments starts a row of its own.
			}
		}
	}
	return $bb_rows;
}

add_filter( 'woocommerce_get_item_data', 'addon_boss_standalone_option_item_data', 10, 2 );

/**
 * The product a line's option words are shown through: the one the basket
 * taxes the line as.
 *
 * The words are worked out from a fresh copy of the product, at its own tax
 * class. A module may dress the line in a class of its own for the length of
 * the basket (a printer job whose configuration is zero-rated on a product
 * that is standard-rated), and the line's money is then taxed at that class:
 * a "+£5.00" check charged £6.00 on a zero-rated job. So the words are shown
 * at the class the line wears. A line in its product's own class, which is
 * every line no module touches, gets the product back unchanged.
 *
 * @param mixed $product The product (or variation) the line is for.
 * @param mixed $line    The cart line, or the values an order line is made from.
 * @return mixed
 */
function addon_boss_line_tax_lens( $product, $line ) {
	$data = is_array( $line ) ? ( $line['data'] ?? null ) : null;
	if ( ! $product instanceof WC_Product || ! $data instanceof WC_Product
		|| $data->get_tax_class() === $product->get_tax_class() ) {
		return $product;
	}
	$lens = clone $product;
	$lens->set_tax_class( $data->get_tax_class() );
	return $lens;
}

function addon_boss_standalone_option_item_data( $data, $cart_item ) {
	if ( ! empty( $cart_item['bundle_boss'] ) ) {
		return $data;
	}
	// The upload's cart row, whether or not the line also carries options.
	$up = $cart_item[ ADDON_BOSS_STANDALONE_UPLOAD_KEY ] ?? null;
	if ( is_array( $up ) && '' !== (string) ( $up['name'] ?? '' ) ) {
		$data[] = array(
			'name'  => '' !== (string) ( $up['label'] ?? '' ) ? (string) $up['label'] : __( 'Your file', 'addon-boss' ),
			'value' => (string) $up['name'],
		);
	}
	// The variation when there is one: charge suffixes convert to display basis
	// through the class the basket taxes the line at (addon_boss_line_tax_lens).
	// Resolved before the options guard so a fields-only line (no option sets)
	// still shows its field rows.
	$vid     = (int) ( $cart_item['variation_id'] ?? 0 );
	$product = addon_boss_line_tax_lens( wc_get_product( $vid ? $vid : (int) ( $cart_item['product_id'] ?? 0 ) ), $cart_item );
	// The field and option rows are gathered first and then listed in the
	// order the product page asks them (addon_boss_line_rows_in_page_order).
	$bb_at   = addon_boss_line_row_positions( wc_get_product( (int) ( $cart_item['product_id'] ?? 0 ) ) );
	$bb_rows = array();

	// Product-field rows: Label -> the shopper's value (a file as a link), with
	// any per-unit charge shown in the same basis the option rows use. One
	// field asked per unit becomes a WALL at trade quantities (fifty shirts,
	// fifty rows), so past a handful one field's instances fold into a single
	// summary row HERE, in the cart display only: the first few values quoted,
	// the rest counted, the whole charge on the one row. The order line keeps
	// every row untouched, because the packing bench works from those.
	// Bucket by field key to decide what folds, but WALK THE SNAPSHOTS IN THE
	// ORDER THEY WERE FILLED IN. Emitting bucket by bucket instead reordered
	// the whole list into field-major, so a tankard with two engravings read
	// "Engraving 1: Words, Engraving 2: Words, Engraving 1: Font, ..." and
	// whoever engraves it reads across the blocks rather than down one. Money
	// was never wrong; the instruction was. A folded bucket takes the place of
	// its FIRST member and its later members are skipped, so folding still
	// collapses a wall of rows without shuffling everything around it.
	$bb_fsnaps = (array) ( $cart_item[ ADDON_BOSS_PRODUCT_FIELDS_KEY ] ?? array() );

	// The order is decided once, at CAPTURE, and must not be second-guessed
	// here. A repeatable group reorders its own members into block order as
	// they are resolved (the addon_boss_field_resolved_rows seam), and it does
	// that IN PLACE: each group is sorted where the merchant put it and every
	// other field keeps its own position.
	//
	// This used to re-sort the whole list by instance number instead. It got
	// the blocks right and everything else wrong, because a field outside a
	// group carries no instance number, so it read as instance zero and was
	// lifted above block one. A merchant who put "Delivery note" last saw it
	// printed first. Reading the stored order is both simpler and correct.
	$bb_buckets = array();
	foreach ( $bb_fsnaps as $bb_fi => $fsnap ) {
		$bb_buckets[ (string) ( $fsnap['key'] ?? $bb_fi ) ][] = $fsnap;
	}
	$bb_folded = array();
	foreach ( $bb_fsnaps as $bb_fi => $bb_snap ) {
		if ( ! empty( $bb_snap['admin_only'] ) ) {
			continue; // the merchant talking to their own order screen, not a cart row.
		}
		$bb_key   = (string) ( $bb_snap['key'] ?? $bb_fi );
		$bb_bunch = $bb_buckets[ $bb_key ] ?? array( $bb_snap );
		$bb_fold  = count( $bb_bunch ) > 8 && ! empty( $bb_bunch[0]['spread'] );
		if ( $bb_fold ) {
			if ( isset( $bb_folded[ $bb_key ] ) ) {
				continue; // this bucket already printed its summary row
			}
			$bb_folded[ $bb_key ] = true;
		} else {
			$bb_bunch = array( $bb_snap ); // one row for this one snapshot
		}
		if ( $bb_fold ) {
			$bb_names = array();
			$bb_sum   = 0.0;
			foreach ( $bb_bunch as $fsnap ) {
				$bb_d = trim( (string) ( $fsnap['display'] ?? '' ) );
				if ( '' !== $bb_d ) {
					$bb_names[] = $bb_d;
				}
				$bb_sum += (float) ( $fsnap['fee'] ?? 0 );
			}
			// "Shirt × 12": the instance word (the label with its number taken
			// back off) and how many the row holds.
			$bb_word  = trim( (string) preg_replace( '/\s*[\d,.\x{00a0}]+$/u', '', (string) ( $bb_bunch[0]['label'] ?? '' ) ) );
			$bb_word  = '' !== $bb_word ? $bb_word : __( 'Detail', 'addon-boss' );
			$bb_shown = array_slice( $bb_names, 0, 3 );
			$bb_rest  = count( $bb_bunch ) - count( $bb_shown );
			$bb_syn   = $bb_bunch[0];
			$bb_syn['fee'] = $bb_sum;
			$bb_fold_row = array(
				// 🔴 COUNT FIRST, because the storefront receipt's own template
				// further down this file fills the SAME msgid the other way
				// round: its script does replace( '%1$s', n ) then
				// replace( '%2$s', thing ). One msgid cannot mean (name, count)
				// here and (count, name) there, because a locale gets exactly
				// one msgstr and no translators note can describe both. The two
				// sites had contradictory notes, which is how it was found.
				// Reading is unchanged in English either way; what changes is
				// that a translator can now reorder the pair deliberately
				// instead of breaking one screen to fix the other.
				/* translators: 1: how many are being bought, 2: what each one is. e.g. "3 × Team shirt" */
				'name'  => sprintf( __( '%1$s × %2$s', 'addon-boss' ), number_format_i18n( count( $bb_bunch ) ), $bb_word ),
				'value' => esc_html( implode( ', ', $bb_shown ) )
					/* translators: %s: how many more there are beyond the ones named */
					. ( $bb_rest > 0 ? ' ' . esc_html( sprintf( __( 'and %s more', 'addon-boss' ), number_format_i18n( $bb_rest ) ) ) : '' ),
			);
			$bb_fold_charge          = addon_boss_standalone_field_charge_suffix( $bb_syn, $product, 'cart' );
			$bb_fold_row['display']  = $bb_fold_row['value'] . addon_boss_suffix_nowrap( $bb_fold_charge );
			$bb_fold_row['value']   .= $bb_fold_charge;
			$bb_rows[] = array(
				'at'  => $bb_at[ 'field:' . $bb_key ] ?? null,
				'row' => $bb_fold_row,
			);
			continue;
		}
		foreach ( $bb_bunch as $fsnap ) {
			$disp = trim( (string) ( $fsnap['display'] ?? '' ) );
			if ( '' === $disp ) {
				continue;
			}
			$val = ! empty( $fsnap['url'] )
				? '<a href="' . esc_url( $fsnap['url'] ) . '" target="_blank" rel="noopener">' . esc_html( $disp ) . '</a>'
				: esc_html( $disp );
			$bb_style  = esc_html( addon_boss_standalone_field_style_suffix( $fsnap ) );
			$bb_charge = addon_boss_standalone_field_charge_suffix( $fsnap, $product, 'cart' );
			$bb_tail   = $bb_style . $bb_charge;
			$bb_row    = array(
				'name'  => '' !== (string) ( $fsnap['label'] ?? '' ) ? (string) $fsnap['label'] : __( 'Detail', 'addon-boss' ),
				'value' => $val . $bb_tail,
			);
			// A type may carry a shorter cart-only form (a date reads
			// "Mon 8 Sep 2026" here and the store's full format everywhere
			// else); both carts prefer a row's display over its value, and the
			// display's price never breaks inside its brackets.
			$bb_row['display'] = ( '' !== (string) ( $fsnap['display_cart'] ?? '' ) ? esc_html( (string) $fsnap['display_cart'] ) : $val )
				. $bb_style . addon_boss_suffix_nowrap( $bb_charge );
			$bb_rows[] = array(
				'at'  => $bb_at[ 'field:' . (string) ( $fsnap['key'] ?? $bb_key ) ] ?? null,
				'row' => $bb_row,
			);
		}
	}

	$bb_opt_rows = empty( $cart_item[ ADDON_BOSS_STANDALONE_OPTIONS_KEY ] )
		? array()
		: addon_boss_line_option_rows( (array) $cart_item[ ADDON_BOSS_STANDALONE_OPTIONS_KEY ], $product, $bb_at, false );
	return addon_boss_cart_rows_keyed( array_merge( $data, addon_boss_line_rows_in_page_order( $bb_rows, $bb_opt_rows ) ) );
}

add_action( 'woocommerce_checkout_create_order_line_item', 'addon_boss_standalone_order_line_meta', 10, 3 );

function addon_boss_standalone_order_line_meta( $item, $cart_item_key, $values ): void {
	if ( ! empty( $values['bundle_boss'] ) ) {
		return;
	}
	// The upload persists onto the order line and its file is marked kept,
	// so the orphan cleanup never eats an ordered file.
	$up = $values[ ADDON_BOSS_STANDALONE_UPLOAD_KEY ] ?? null;
	if ( is_array( $up ) && '' !== (string) ( $up['ref'] ?? '' ) ) {
		$item->add_meta_data( ADDON_BOSS_STANDALONE_UPLOAD_META, $up, true );
		$item->add_meta_data(
			'' !== (string) ( $up['label'] ?? '' ) ? (string) $up['label'] : __( 'Your file', 'addon-boss' ),
			(string) ( $up['name'] ?? '' )
		);
		if ( function_exists( 'addon_boss_personalisation_keep_upload' ) ) {
			addon_boss_personalisation_keep_upload( (string) $up['ref'] );
		}
	}
	// Product fields: the structured copy (the reorder source of truth) plus a
	// readable row per filled field. Persisted even when the line carries no
	// option sets, so a fields-only product reorders and reads on the order
	// screen and in emails.
	//
	// The readable rows, fields and options alike, are written in the order
	// the product page asks them, the order the cart shows them in.
	$vid     = (int) ( $values['variation_id'] ?? 0 );
	$product = addon_boss_line_tax_lens( wc_get_product( $vid ? $vid : (int) ( $values['product_id'] ?? 0 ) ), $values );
	$bb_at   = addon_boss_line_row_positions( wc_get_product( (int) ( $values['product_id'] ?? 0 ) ) );
	$bb_rows = array();
	$fsnaps  = $values[ ADDON_BOSS_PRODUCT_FIELDS_KEY ] ?? array();
	if ( ! empty( $fsnaps ) && is_array( $fsnaps ) ) {
		$item->add_meta_data( ADDON_BOSS_PRODUCT_FIELDS_META, array_values( $fsnaps ), true );
		foreach ( $fsnaps as $fsnap ) {
			$flabel = (string) ( $fsnap['label'] ?? '' );
			$fdisp  = (string) ( $fsnap['display'] ?? '' );
			if ( '' === $flabel || '' === $fdisp ) {
				continue;
			}
			if ( ! empty( $fsnap['admin_only'] ) ) {
				// The structured copy above already carries it; a readable row would
				// print it on the customer's order page and in their emails, which
				// is exactly what a hidden field promises never to do. The admin
				// order screen prints these from the structured copy instead.
				continue;
			}
			$bb_rows[] = array(
				'at'  => $bb_at[ 'field:' . (string) ( $fsnap['key'] ?? '' ) ] ?? null,
				'row' => array(
					'name'  => $flabel,
					'value' => $fdisp . addon_boss_standalone_field_style_suffix( $fsnap ) . addon_boss_standalone_suffix_text( addon_boss_standalone_field_charge_suffix( $fsnap, $product, 'cart' ) ),
				),
			);
		}
	}
	$snaps = $values[ ADDON_BOSS_STANDALONE_OPTIONS_KEY ] ?? array();
	if ( ! empty( $snaps ) && is_array( $snaps ) ) {
		// The structured copy is the reorder source of truth; the readable rows
		// mirror the cart lines for the order screen and emails. The named
		// adjustments reach the order line by name too: the packing bench and
		// the printer read "Second colour: +10% (5.80)" exactly as the shopper
		// did in the cart.
		$item->add_meta_data( '_bundle_boss_standalone_options', array_values( $snaps ), true );
	}
	$bb_opt_rows = ( ! empty( $snaps ) && is_array( $snaps ) ) ? addon_boss_line_option_rows( $snaps, $product, $bb_at, true ) : array();
	foreach ( addon_boss_line_rows_in_page_order( $bb_rows, $bb_opt_rows ) as $bb_row ) {
		$item->add_meta_data( $bb_row['name'], $bb_row['value'] );
	}
}

// ---- Admin order screen extras ---------------------------------
//
// Two things only the merchant sees. A hidden field's row (kept off every
// customer surface above) prints here, because the order screen is who it was
// written for. A colour field's row gains a painted chip beside its words,
// because "#9b111e" is a code and a red square is a colour.

add_action( 'woocommerce_after_order_itemmeta', 'addon_boss_field_admin_order_extras', 15, 2 );

function addon_boss_field_admin_order_extras( $item_id, $item ): void {
	if ( ! is_admin() || ! $item instanceof WC_Order_Item_Product ) {
		return;
	}
	$fsnaps = $item->get_meta( ADDON_BOSS_PRODUCT_FIELDS_META, true );
	if ( ! is_array( $fsnaps ) || ! $fsnaps ) {
		return;
	}
	$bb_rows = array();
	foreach ( $fsnaps as $fsnap ) {
		if ( ! is_array( $fsnap ) ) {
			continue;
		}
		if ( ! empty( $fsnap['admin_only'] ) && '' !== (string) ( $fsnap['display'] ?? '' ) ) {
			$bb_rows[] = '<span class="bb-admin-hiddenrow" style="display:block;font-size:12px;color:#646970;">'
				. esc_html( (string) ( $fsnap['label'] ?? '' ) ) . ': '
				. esc_html( (string) $fsnap['display'] )
				. ' <em>' . esc_html__( '(not shown to the customer)', 'addon-boss' ) . '</em></span>';
			continue;
		}
		if ( '' !== (string) ( $fsnap['hex'] ?? '' ) ) {
			$bb_rows[] = '<span class="bb-admin-colourrow" style="display:inline-flex;align-items:center;gap:5px;font-size:12px;color:#646970;margin-right:10px;">'
				. '<span style="width:12px;height:12px;border-radius:3px;border:1px solid #dcdce4;background:' . esc_attr( (string) $fsnap['hex'] ) . ';display:inline-block;"></span>'
				. esc_html( (string) ( $fsnap['label'] ?? '' ) ) . ': ' . esc_html( (string) ( $fsnap['display'] ?? '' ) )
				. '</span>';
		}
	}
	if ( $bb_rows ) {
		echo '<div class="bb-admin-field-extras" style="margin-top:4px;">' . wp_kses_post( implode( '', $bb_rows ) ) . '</div>';
	}
}

// =================================================================
// The cart edit loop: a configured line offers "Edit options", the product
// page comes back with every choice prefilled, and saving REPLACES the line.
//
// The prefill IS the failed-add machinery: the render already restores
// whatever the request carries (bb_pf values, set picks, style picks, upload
// references), so the edit only has to write the line's snapshots back into
// $_REQUEST and the page draws itself filled in. Each option-set kind can
// register a 'seed' callback that turns its snapshot back into its own
// request fields, and a field type can do the same for its posted shape; the
// engine's own kinds and types need neither.
//
// The replace is atomic on WooCommerce's own terms: the update is an
// ordinary add-to-cart, validated by the same gates as any add, and only
// AFTER it succeeds is the original line removed (and the new line stood in
// its place). A refused update therefore leaves the original exactly as it
// was, with the reason on screen. Identical picks hash to the identical cart
// id, so an edit that changes nothing merges back into the very line being
// edited and only the quantity is pinned to what was posted.
//
// Free in every build. A line inside a bundle is not offered the link (the
// bundle's own edit flow owns it), and BundleBoss can join through the same
// filters when it does.
// =================================================================

/**
 * Does this cart line carry anything this engine configured onto it?
 *
 * The edit link is contextual: a plain line offers nothing to edit. A bundle
 * line stands down here however much it carries, because the bundle's own
 * edit flow owns it. Filterable so another plugin (BundleBoss) can claim its
 * own lines into, or out of, the loop.
 *
 * @param array $item One cart line.
 * @return bool
 */
function addon_boss_cart_line_carries_options( array $item ): bool {
	$carries = false;
	if ( empty( $item['bundle_boss'] ) ) {
		$carries = ! empty( $item[ ADDON_BOSS_STANDALONE_OPTIONS_KEY ] )
			|| ! empty( $item[ ADDON_BOSS_PRODUCT_FIELDS_KEY ] )
			|| ! empty( $item[ ADDON_BOSS_STANDALONE_UPLOAD_KEY ] )
			|| ( defined( 'ADDON_BOSS_POSITIONS_KEY' ) && ! empty( $item[ ADDON_BOSS_POSITIONS_KEY ] ) );
	}
	return (bool) apply_filters( 'addon_boss_cart_line_carries_options', $carries, $item );
}

/**
 * The cart line being edited in THIS request, or null.
 *
 * Two spellings mean the same line: bb_edit rides the link from the cart, and
 * bb_edit_line rides the form's own hidden field, so a refused update
 * re-renders still wearing its edit state. The key is only ever trusted after
 * it resolves to a real line in this visitor's own cart (the cart is bound to
 * their session, so a key from anywhere else resolves to nothing).
 *
 * @return array{key:string,item:array}|null
 */
function addon_boss_edit_line_state(): ?array {
	$key = '';
	foreach ( array( 'bb_edit', 'bb_edit_line' ) as $bb_param ) {
		// Read ONCE, through the boundary, and judged afterwards. Testing the
		// raw value and sanitising it on the next line reads the input twice
		// and leaves the comparison looking at bytes nothing has cleaned.
		// phpcs:ignore WordPress.Security.NonceVerification.Recommended -- read-only lookup; the key must resolve inside this visitor's own session cart to mean anything.
		$bb_asked = isset( $_REQUEST[ $bb_param ] ) ? sanitize_text_field( wp_unslash( (string) $_REQUEST[ $bb_param ] ) ) : '';
		if ( '' !== $bb_asked ) {
			$key = $bb_asked;
			break;
		}
	}
	if ( '' === $key || ! function_exists( 'WC' ) || null === WC()->cart ) {
		return null;
	}
	$item = WC()->cart->get_cart_item( $key );
	if ( ! $item || ! is_array( $item ) || ! addon_boss_cart_line_carries_options( $item ) ) {
		return null;
	}
	return array( 'key' => $key, 'item' => $item );
}

/**
 * The edit state ONLY when this product page is the edited line's own
 * product, which is what the chrome (banner, hidden field, button wording,
 * quantity) keys off. A stray bb_edit for some other product changes nothing.
 *
 * @param WC_Product|null $product The product being rendered, when the caller has it.
 * @return array{key:string,item:array}|null
 */
function addon_boss_edit_page_state( $product = null ): ?array {
	$state = addon_boss_edit_line_state();
	if ( ! $state ) {
		return null;
	}
	$line_pid = (int) ( $state['item']['product_id'] ?? 0 );
	$page_pid = 0;
	if ( $product instanceof WC_Product ) {
		$page_pid = $product->get_id();
	} elseif ( isset( $GLOBALS['product'] ) && $GLOBALS['product'] instanceof WC_Product ) {
		$page_pid = $GLOBALS['product']->get_id();
	} elseif ( function_exists( 'is_product' ) && is_product() ) {
		$page_pid = (int) get_queried_object_id();
	}
	return $line_pid === $page_pid ? $state : null;
}

/**
 * The URL that opens a line for editing: the product's own page, the chosen
 * variation carried as WooCommerce's native attribute parameters (its form
 * preselects from them), and the line named by its cart item key.
 */
function addon_boss_edit_line_url( array $item, string $key ): string {
	$product = wc_get_product( (int) ( $item['product_id'] ?? 0 ) );
	if ( ! $product || ! $product->is_purchasable() ) {
		return '';
	}
	$args = array();
	foreach ( (array) ( $item['variation'] ?? array() ) as $bb_attr => $bb_val ) {
		if ( '' !== (string) $bb_val ) {
			$args[ (string) $bb_attr ] = (string) $bb_val;
		}
	}
	$args['bb_edit'] = $key;
	return add_query_arg( urlencode_deep( $args ), $product->get_permalink() );
}

add_filter( 'woocommerce_cart_item_name', 'addon_boss_edit_cart_link', 20, 3 );

/**
 * The "Edit options" link under a configured line's name, on the cart page
 * and in the classic mini cart (both print their names through this same
 * filter). Contextual: only a line that actually carries options offers it.
 * The checkout review table is for checking, not editing, so it stays clean.
 * A grid product's lines are made by the grid and edited through the grid.
 */
function addon_boss_edit_cart_link( $name, $cart_item = null, $cart_item_key = '' ) {
	if ( ! is_array( $cart_item ) || '' === (string) $cart_item_key ) {
		return $name;
	}
	if ( function_exists( 'is_checkout' ) && is_checkout() ) {
		return $name;
	}
	if ( ! addon_boss_cart_line_carries_options( $cart_item ) ) {
		return $name;
	}
	$bb_parent = wc_get_product( (int) ( $cart_item['product_id'] ?? 0 ) );
	if ( ! $bb_parent || addon_boss_product_uses_grid( $bb_parent ) ) {
		return $name;
	}
	$url = addon_boss_edit_line_url( $cart_item, (string) $cart_item_key );
	if ( '' === $url ) {
		return $name;
	}
	$link = '<a class="bb-edit-line" href="' . esc_url( $url ) . '">' . esc_html__( 'Edit options', 'addon-boss' ) . '</a>';
	/**
	 * The rendered edit link, for another plugin to reword, restyle or veto
	 * (return '' to offer nothing for this line).
	 *
	 * @param string $link          The anchor markup.
	 * @param array  $cart_item     The cart line.
	 * @param string $cart_item_key Its key.
	 * @param string $url           The edit URL.
	 */
	$link = (string) apply_filters( 'addon_boss_edit_line_link', $link, $cart_item, (string) $cart_item_key, $url );
	if ( '' === $link ) {
		return $name;
	}
	static $bb_css = false;
	if ( ! $bb_css ) {
		$bb_css = true;
		addon_boss_inline_css( '.bb-edit-line{display:block;width:max-content;margin-top:2px;font-size:.85em;font-weight:600;text-decoration:underline;text-underline-offset:2px;opacity:.85;}.bb-edit-line:hover{opacity:1;}' );
	}
	return $name . ' ' . $link;
}

/**
 * Write one line's frozen choices back into $_REQUEST, exactly where the
 * failed-add prefill machinery reads them, so the product page renders
 * already filled in: set picks, field values (each repeat instance under its
 * own index), a size field's two dimensions, upload references (the render
 * turns them back into their chips), style picks, chosen positions.
 *
 * Values are wp_slash()ed on the way in because everything that reads the
 * request unslashes, exactly as it would a browser's own post.
 *
 * @param array $item The cart line.
 */
function addon_boss_edit_seed_request( array $item ): void {
	$product = wc_get_product( (int) ( $item['product_id'] ?? 0 ) );
	if ( ! $product ) {
		return;
	}

	// A crafted scalar where an array belongs (?bb_pf=x on the edit URL) must
	// not fatal the array writes below; the seed owns these keys on an edit
	// arrival, so a scalar imposter is simply cleared.
	foreach ( array( 'bb_pf', 'bb_pf_style', 'bb_pos' ) as $bb_arr_key ) {
		if ( isset( $_REQUEST[ $bb_arr_key ] ) && ! is_array( $_REQUEST[ $bb_arr_key ] ) ) { // phpcs:ignore WordPress.Security.NonceVerification.Recommended -- shape guard only.
			unset( $_REQUEST[ $bb_arr_key ] );
		}
	}

	// The chosen variation, in WooCommerce's own attribute parameters; its
	// form preselects from the request natively.
	foreach ( (array) ( $item['variation'] ?? array() ) as $bb_attr => $bb_val ) {
		if ( '' !== (string) $bb_val ) {
			$_REQUEST[ (string) $bb_attr ] = wp_slash( (string) $bb_val );
		}
	}

	// Option sets: each snapshot back through its kind. The engine's own
	// 'choices' kind is one field carrying the option's key; a several-of
	// set carries EVERY pick, so its snapshots accumulate into the array its
	// multi control posts rather than overwriting to the last one standing.
	// A kind priced off its own panel (a measured set, a price table)
	// answers through the 'seed' callback its module registered, and a kind
	// with neither seeds nothing rather than guessing.
	$bb_sets_by_id = array();
	foreach ( addon_boss_standalone_option_sets( $product ) as $bb_set ) {
		$bb_sets_by_id[ (string) $bb_set['id'] ] = $bb_set;
	}
	$bb_kinds      = addon_boss_option_set_kinds();
	$bb_multi_seed = array(); // field name => every picked key, in snapshot order.
	foreach ( (array) ( $item[ ADDON_BOSS_STANDALONE_OPTIONS_KEY ] ?? array() ) as $bb_snap ) {
		if ( ! is_array( $bb_snap ) ) {
			continue;
		}
		$bb_set = $bb_sets_by_id[ (string) ( $bb_snap['set'] ?? '' ) ] ?? null;
		if ( ! $bb_set ) {
			continue; // the set has since left the product: nothing to prefill it into.
		}
		$bb_kind = (string) ( $bb_set['kind'] ?? 'choices' );
		$bb_cb   = $bb_kinds[ $bb_kind ]['seed'] ?? null;
		if ( is_callable( $bb_cb ) ) {
			$bb_fields = (array) call_user_func( $bb_cb, $bb_set, $bb_snap );
		} elseif ( 'choices' === $bb_kind ) {
			if ( ! empty( $bb_set['multi'] ) ) {
				$bb_multi_seed[ addon_boss_standalone_field_name( (string) $bb_set['id'] ) ][] = (string) ( $bb_snap['key'] ?? '' );
				continue;
			}
			$bb_fields = array( addon_boss_standalone_field_name( (string) $bb_set['id'] ) => (string) ( $bb_snap['key'] ?? '' ) );
		} else {
			$bb_fields = array();
		}
		foreach ( $bb_fields as $bb_k => $bb_v ) {
			$_REQUEST[ (string) $bb_k ] = wp_slash( (string) $bb_v );
		}
	}
	foreach ( $bb_multi_seed as $bb_k => $bb_keys ) {
		$_REQUEST[ (string) $bb_k ] = wp_slash( array_values( $bb_keys ) );
	}

	// Product fields: snapshots regrouped by field, a repeatable field's
	// instances back into the list shape it posts (bb_pf[key][0], [1], ...),
	// everything else back to its scalar. A type whose posted shape is not
	// its stored value (a measured size stores "3x2" and posts w and h)
	// answers through the 'seed' callback its module registered against the
	// type. A frozen style pick (typeface, colour) rides back under
	// bb_pf_style, where the picker's own prefill reads.
	$bb_defs_by_key = array();
	foreach ( addon_boss_standalone_product_fields( $product ) as $bb_def ) {
		$bb_defs_by_key[ (string) ( $bb_def['key'] ?? '' ) ] = $bb_def;
	}
	$bb_types  = addon_boss_personalisation_field_types();
	$bb_groups = array();
	foreach ( (array) ( $item[ ADDON_BOSS_PRODUCT_FIELDS_KEY ] ?? array() ) as $bb_fsnap ) {
		if ( is_array( $bb_fsnap ) && '' !== (string) ( $bb_fsnap['key'] ?? '' ) ) {
			$bb_groups[ (string) $bb_fsnap['key'] ][] = $bb_fsnap;
		}
	}
	foreach ( $bb_groups as $bb_fkey => $bb_snaps ) {
		$bb_def = $bb_defs_by_key[ $bb_fkey ] ?? null;
		if ( ! $bb_def ) {
			continue; // the field has since left the product.
		}
		$bb_seed_cb = $bb_types[ (string) ( $bb_def['type'] ?? 'text' ) ]['seed'] ?? null;
		$bb_repeat  = false;
		$bb_vals    = array();
		foreach ( $bb_snaps as $bb_fsnap ) {
			$bb_inst = (int) ( $bb_fsnap['instance'] ?? 0 );
			if ( $bb_inst > 0 ) {
				$bb_repeat = true;
			}
			// SLOT-TRUE: an instance's value seeds back into its own numbered
			// slot, never packed down into a hole a skipped instance left. In a
			// repeatable GROUP the members share the block numbering, so a font
			// picked only on block two must land under [1] for both the render
			// and the resolver to reunite it with block two's other fields.
			$bb_vals[ max( 0, $bb_inst - 1 ) ] = is_callable( $bb_seed_cb )
				? call_user_func( $bb_seed_cb, $bb_def, $bb_fsnap )
				: (string) ( $bb_fsnap['value'] ?? '' );
			if ( isset( $bb_fsnap['font'] ) || isset( $bb_fsnap['colour'] ) ) {
				$_REQUEST['bb_pf_style'][ $bb_fkey ] = wp_slash(
					array(
						'font'   => (string) ( $bb_fsnap['font'] ?? '' ),
						'colour' => (string) ( $bb_fsnap['colour'] ?? '' ),
					)
				);
			}
		}
		if ( $bb_repeat ) {
			// Fill the gaps with the empty string a blank input would have
			// posted, so the list is contiguous and every renderer's positional
			// read stays true to the blocks the shopper actually had.
			$bb_top = max( array_keys( $bb_vals ) );
			for ( $bb_s = 0; $bb_s <= $bb_top; $bb_s++ ) {
				if ( ! isset( $bb_vals[ $bb_s ] ) ) {
					$bb_vals[ $bb_s ] = '';
				}
			}
			ksort( $bb_vals );
		}
		$_REQUEST['bb_pf'][ $bb_fkey ] = wp_slash( $bb_repeat ? array_values( $bb_vals ) : reset( $bb_vals ) );
	}

	// The product-level upload box, by its stored reference.
	$bb_up = $item[ ADDON_BOSS_STANDALONE_UPLOAD_KEY ] ?? null;
	if ( is_array( $bb_up ) && '' !== (string) ( $bb_up['ref'] ?? '' ) ) {
		$_REQUEST['bb_standalone_upload_ref'] = wp_slash( (string) $bb_up['ref'] );
	}

	// Chosen positions, back into the bb_pos shape their panels post.
	if ( defined( 'ADDON_BOSS_POSITIONS_KEY' ) ) {
		foreach ( (array) ( $item[ ADDON_BOSS_POSITIONS_KEY ] ?? array() ) as $bb_psnap ) {
			if ( ! is_array( $bb_psnap ) ) {
				continue;
			}
			$bb_pkey = (string) ( $bb_psnap['set'] ?? '' ) . ':' . (string) ( $bb_psnap['id'] ?? '' );
			if ( ':' === $bb_pkey ) {
				continue;
			}
			$_REQUEST['bb_pos'][ $bb_pkey ] = wp_slash(
				array(
					'text'   => (string) ( $bb_psnap['text'] ?? '' ),
					'file'   => (string) ( $bb_psnap['file'] ?? '' ),
					'method' => (string) ( $bb_psnap['method'] ?? '' ),
					'help'   => ! empty( $bb_psnap['help'] ) ? '1' : '',
				)
			);
		}
	}

	/**
	 * Whatever else a module or another plugin froze onto this line, seeded
	 * back the same way. BundleBoss joins the loop here.
	 *
	 * @param array $item The cart line being edited.
	 */
	do_action( 'addon_boss_edit_seed', $item );
}

add_action( 'template_redirect', 'addon_boss_edit_prefill_boot' );

/**
 * Arriving on a product page from an edit link: seed the request from the
 * line so the page renders prefilled. Only on a plain arrival; a posted form
 * (a refused update re-rendering) carries the shopper's own values, and
 * overwriting those with the line's stored ones would throw away exactly the
 * typing the failed-add machinery exists to keep.
 */
function addon_boss_edit_prefill_boot(): void {
	if ( ! function_exists( 'is_product' ) || ! is_product() ) {
		return;
	}
	$bb_method = isset( $_SERVER['REQUEST_METHOD'] ) ? strtoupper( sanitize_text_field( wp_unslash( (string) $_SERVER['REQUEST_METHOD'] ) ) ) : 'GET';
	// phpcs:ignore WordPress.Security.NonceVerification.Recommended -- presence check only: a posted form keeps its own values.
	if ( 'POST' === $bb_method || isset( $_REQUEST['add-to-cart'] ) ) {
		return;
	}
	if ( ! isset( $_REQUEST['bb_edit'] ) ) { // phpcs:ignore WordPress.Security.NonceVerification.Recommended -- presence check only.
		return;
	}
	$state = addon_boss_edit_page_state();
	if ( ! $state ) {
		// The link outlived the line (bought, removed, or another tab got
		// there first). Say so kindly and render the page fresh.
		if ( function_exists( 'wc_add_notice' ) ) {
			wc_add_notice( __( 'That item is not in your cart any more, so this page starts fresh.', 'addon-boss' ), 'notice' );
		}
		return;
	}
	addon_boss_edit_seed_request( $state['item'] );
}

add_action( 'woocommerce_before_add_to_cart_form', 'addon_boss_edit_banner' );

/**
 * The banner above the form, so the page says plainly that this is an edit:
 * what is being changed, that nothing happens until it is saved, and the way
 * back out. role="status" so assistive tech announces the mode.
 */
function addon_boss_edit_banner(): void {
	$state = addon_boss_edit_page_state();
	if ( ! $state ) {
		return;
	}
	addon_boss_inline_css(
		'.bb-edit-banner{display:flex;flex-wrap:wrap;align-items:baseline;gap:6px 14px;margin:0 0 18px;padding:12px 16px;border-radius:10px;border:1.5px solid color-mix(in srgb,var(--aob-accent,#fd4730) 35%,transparent);background:color-mix(in srgb,var(--aob-accent,#fd4730) 6%,var(--aob-surface,#fff));}'
		. '.bb-edit-banner strong{font-weight:700;}'
		. '.bb-edit-banner .bb-edit-cancel{margin-left:auto;font-weight:600;text-decoration:underline;text-underline-offset:2px;white-space:nowrap;}'
	);
	echo '<div class="bb-edit-banner" role="status">';
	echo '<strong>' . esc_html__( 'You are changing an item from your cart.', 'addon-boss' ) . '</strong> ';
	// The button's own words, so the banner and the button name one action:
	// "save" here beside a button reading "Update cart" was two (tester
	// round 4). Read off the button itself, in every language.
	$bb_edit_product = wc_get_product( (int) ( $state['item']['product_id'] ?? 0 ) );
	$bb_edit_button  = $bb_edit_product ? $bb_edit_product->single_add_to_cart_text() : __( 'Update cart', 'addon-boss' );
	echo '<span>' . esc_html(
		sprintf(
			/* translators: %s: the words on the button that saves the change, "Update cart" */
			__( 'Your choices are filled in below. Nothing changes until you press %s.', 'addon-boss' ),
			$bb_edit_button
		)
	) . '</span>';
	echo '<a class="bb-edit-cancel" href="' . esc_url( wc_get_cart_url() ) . '">' . esc_html__( 'Back to the cart without changes', 'addon-boss' ) . '</a>';
	echo '</div>';
}

add_action( 'woocommerce_before_add_to_cart_button', 'addon_boss_edit_hidden_field', 5 );

/**
 * The hidden field naming the line this form replaces. Inside the native
 * add-to-cart form, so it rides the update post however the theme submits.
 */
function addon_boss_edit_hidden_field(): void {
	$state = addon_boss_edit_page_state();
	if ( ! $state ) {
		return;
	}
	echo '<input type="hidden" name="bb_edit_line" value="' . esc_attr( $state['key'] ) . '">';
}

add_filter( 'woocommerce_product_single_add_to_cart_text', 'addon_boss_edit_button_text', 20, 2 );

/**
 * The button says what it will do: update, not add. The platform's own verb
 * (the cart page's own button is "Update cart"), so the shopper meets one
 * vocabulary. The live total beside it already shows the recalculated price.
 */
function addon_boss_edit_button_text( $text, $product = null ) {
	return addon_boss_edit_page_state( $product instanceof WC_Product ? $product : null )
		? __( 'Update cart', 'addon-boss' )
		: $text;
}

add_filter( 'woocommerce_quantity_input_args', 'addon_boss_edit_link_off_quantity_label', 10, 2 );

/**
 * The classic cart names each line's quantity box after the line's name, and
 * that name carries the "Edit options" link, so a screen reader announced
 * "QA270 Floor Board Edit options quantity" (tester round 3, 18 Oct 2026).
 * The link comes back off the box's label; the line's name keeps it.
 *
 * @param array           $args    The quantity box's arguments.
 * @param WC_Product|null $product The line's product.
 * @return array
 */
function addon_boss_edit_link_off_quantity_label( $args, $product = null ) {
	if ( is_array( $args ) && false !== strpos( (string) ( $args['product_name'] ?? '' ), 'bb-edit-line' ) ) {
		$args['product_name'] = trim( (string) preg_replace( '#\s*<a\b[^>]*\bbb-edit-line\b[^>]*>.*?</a>#is', '', (string) $args['product_name'] ) );
	}
	return $args;
}

add_filter( 'woocommerce_quantity_input_args', 'addon_boss_edit_quantity_prefill', 10, 2 );

/**
 * The quantity box starts at the line's own quantity, so saving untouched
 * keeps it. A posted quantity (a refused update re-rendering) wins, exactly
 * as it does for every other field.
 */
function addon_boss_edit_quantity_prefill( $args, $product = null ) {
	if ( isset( $_POST['quantity'] ) ) { // phpcs:ignore WordPress.Security.NonceVerification.Missing -- presence check only: the template already honours a posted quantity.
		return $args;
	}
	$state = addon_boss_edit_page_state( $product instanceof WC_Product ? $product : null );
	if ( $state && is_array( $args ) ) {
		$args['input_value'] = max( 1, (int) ( $state['item']['quantity'] ?? 1 ) );
	}
	return $args;
}

add_filter( 'woocommerce_add_to_cart_sold_individually_found_in_cart', 'addon_boss_edit_sold_individually', 10, 5 );

/**
 * A sold-individually product refuses a second identical line, but the line
 * being EDITED is not "another one": the update replaces it. Only that exact
 * line is excused; everything else keeps WooCommerce's answer.
 */
function addon_boss_edit_sold_individually( $found, $product_id = 0, $variation_id = 0, $cart_item_data = array(), $cart_id = '' ) {
	if ( ! $found || ! isset( $_REQUEST['bb_edit_line'] ) ) { // phpcs:ignore WordPress.Security.NonceVerification.Recommended -- presence check; the key still has to resolve to this visitor's own line below.
		return $found;
	}
	$edit_key = sanitize_text_field( wp_unslash( (string) $_REQUEST['bb_edit_line'] ) ); // phpcs:ignore WordPress.Security.NonceVerification.Recommended
	if ( '' === $edit_key || null === WC()->cart ) {
		return $found;
	}
	return WC()->cart->find_product_in_cart( (string) $cart_id ) === $edit_key ? false : $found;
}

/**
 * Whether THIS request replaced a line (and which product), for the redirect
 * and the message. A request-scoped latch, set only by the replace below.
 *
 * @param bool|null $set Pass true to latch; null to read.
 * @return bool
 */
function addon_boss_edit_replaced( ?bool $set = null ): bool {
	static $bb_replaced = false;
	if ( null !== $set ) {
		$bb_replaced = $set;
	}
	return $bb_replaced;
}

/**
 * The money a cart line's options carry, keyed by WHICH option it is.
 *
 * Every snapshot is a frozen quote: the rate at the moment it was added. That
 * is deliberate, and it is why a line keeps the price it was sold at when a
 * merchant edits an option afterwards. The map here lets two lines be compared
 * choice by choice, so a rate that moved can be told apart from a shopper who
 * simply picked something else.
 *
 * Identity is taken from whatever the snapshot carries, in order, so a shape
 * that gains a field later still lines up rather than silently comparing
 * nothing to nothing.
 *
 * @param array $item A cart item.
 * @return array<string,float> identity => money.
 */
function addon_boss_edit_option_money( array $item ): array {
	$bb_out = array();
	$bb_id  = static function ( array $bb_s, string $bb_kind, int $bb_i ): string {
		foreach ( array( 'set', 'set_id', 'field', 'key', 'name', 'label' ) as $bb_f ) {
			if ( '' !== (string) ( $bb_s[ $bb_f ] ?? '' ) ) {
				return $bb_kind . ':' . (string) $bb_s[ $bb_f ]
					. ( isset( $bb_s['instance'] ) ? '#' . (int) $bb_s['instance'] : '' );
			}
		}
		return $bb_kind . ':@' . $bb_i;
	};
	foreach ( array_values( (array) ( $item[ ADDON_BOSS_STANDALONE_OPTIONS_KEY ] ?? array() ) ) as $bb_i => $bb_s ) {
		if ( ! is_array( $bb_s ) ) {
			continue;
		}
		$bb_out[ $bb_id( $bb_s, 'opt', (int) $bb_i ) ] =
			(float) ( $bb_s['delta'] ?? 0 ) + (float) ( $bb_s['adj_once'] ?? 0 );
	}
	foreach ( array_values( (array) ( $item[ ADDON_BOSS_PRODUCT_FIELDS_KEY ] ?? array() ) ) as $bb_i => $bb_s ) {
		if ( ! is_array( $bb_s ) ) {
			continue;
		}
		$bb_out[ $bb_id( $bb_s, 'fld', (int) $bb_i ) ] = (float) ( $bb_s['fee'] ?? 0 );
	}
	return $bb_out;
}

/**
 * Did a choice the shopper KEPT change price between adding and saving?
 *
 * Only the identities present on both sides are compared, so changing a pick
 * is never mistaken for a rate moving: what is measured is the same option,
 * before and after.
 *
 * @param array $old The line as it was.
 * @param array $new The line as it now is.
 * @return bool
 */
function addon_boss_edit_rates_moved( array $old, array $new ): bool {
	$bb_before = addon_boss_edit_option_money( $old );
	$bb_after  = addon_boss_edit_option_money( $new );
	foreach ( $bb_before as $bb_k => $bb_was ) {
		if ( ! array_key_exists( $bb_k, $bb_after ) ) {
			continue; // they changed this choice; nothing to compare.
		}
		if ( abs( $bb_was - $bb_after[ $bb_k ] ) >= 0.005 ) {
			return true;
		}
	}
	return false;
}

add_action( 'woocommerce_add_to_cart', 'addon_boss_edit_apply_replace', 20, 6 );

/**
 * The atomic half of the update: runs only AFTER WooCommerce accepted the
 * add, so a refused update never reaches here and the original line stands
 * untouched with the reason on screen.
 *
 * Three shapes, one outcome each:
 * - Identical picks merged back into the edited line itself (same cart id):
 *   the posted quantity is the whole answer, so it is pinned rather than
 *   summed, and the line is byte-identical to before.
 * - New picks made a new line: the original is removed and the new line
 *   stands exactly where it stood, so the cart reads as updated in place.
 *   Nothing is left in the removed pile, so there is no ghost to restore.
 * - New picks merged into ANOTHER existing identical line: the original is
 *   removed and the merge stands, which is how WooCommerce has always
 *   folded identical lines together.
 */
function addon_boss_edit_apply_replace( $cart_item_key, $product_id = 0, $quantity = 1, $variation_id = 0, $variation = array(), $cart_item_data = array() ): void {
	if ( ! isset( $_REQUEST['bb_edit_line'] ) ) { // phpcs:ignore WordPress.Security.NonceVerification.Recommended -- the key must resolve to a line of the same product in this visitor's own cart below.
		return;
	}
	$edit_key = sanitize_text_field( wp_unslash( (string) $_REQUEST['bb_edit_line'] ) ); // phpcs:ignore WordPress.Security.NonceVerification.Recommended
	$cart     = function_exists( 'WC' ) ? WC()->cart : null;
	if ( '' === $edit_key || ! $cart ) {
		return;
	}
	$old = $cart->get_cart_item( $edit_key );
	if ( ! $old || ! is_array( $old ) ) {
		// THE LINK OUTLIVED THE LINE. The shopper opened Edit options, and
		// before they saved, that line left the cart: emptied in another tab,
		// removed, or the session rolled. The update then quietly became an
		// ordinary add, so they came back to a cart with a SECOND line and a
		// message saying their product had been added, having set out to
		// change one they already had.
		//
		// The add stands, because it is their own configuration and throwing
		// it away to punish a race would be worse. What changes is that the
		// page stops claiming an edit happened. Their work is kept and the
		// cart's state is stated.
		if ( function_exists( 'wc_add_notice' ) ) {
			wc_add_notice(
				esc_html__( 'The line you were editing was no longer in your cart, so your choices have been added as a new line.', 'addon-boss' ),
				'notice'
			);
		}
		return;
	}
	// Only a line of the same product can be replaced by this form. A stale
	// or crossed-up marker must never eat an unrelated line.
	if ( (int) ( $old['product_id'] ?? 0 ) !== (int) $product_id ) {
		return;
	}

	// A RE-PRICE IS NOT A SILENT EVENT. Every option snapshot is a quote
	// frozen at the moment it was added, which is why an untouched line keeps
	// the price it was sold at when a merchant changes a rate afterwards. An
	// edit re-runs add to cart, so it takes a FRESH snapshot at today's
	// rates: come back a week later, change only the quantity, and the gloss
	// finish quietly costs what it costs now instead of what was quoted.
	//
	// Re-pricing is the right answer, because the shopper is choosing again
	// and the shop must be able to sell at today's prices. Doing it without
	// a word is not. Only choices they KEPT are compared, so picking
	// something else is never mistaken for a rate moving.
	$bb_now = $cart->get_cart_item( (string) $cart_item_key );
	if ( is_array( $bb_now ) && addon_boss_edit_rates_moved( $old, $bb_now ) && function_exists( 'wc_add_notice' ) ) {
		wc_add_notice(
			esc_html__( 'Some prices have changed since you added this, so your cart now shows the current ones.', 'addon-boss' ),
			'notice'
		);
	}

	if ( $edit_key === (string) $cart_item_key ) {
		// Nothing about the picks changed, so WooCommerce merged the update
		// into the very line being edited (its quantity plus the posted one).
		// The posted quantity is the whole answer.
		$cart->set_quantity( $cart_item_key, max( 1, (int) $quantity ) );
		addon_boss_edit_replaced( true );
		return;
	}

	$bb_keys = array_keys( $cart->cart_contents );
	$bb_pos  = array_search( $edit_key, $bb_keys, true );
	$cart->remove_cart_item( $edit_key );
	// Atomic replace: nothing waits in the removed pile to be restored.
	unset( $cart->removed_cart_contents[ $edit_key ] );

	// A fresh line lands at the end of the cart; stand it where the original
	// stood so the cart reads as updated in place. A merge into another
	// existing line keeps that line's own place.
	$bb_contents = $cart->cart_contents;
	if ( false !== $bb_pos && array_key_last( $bb_contents ) === (string) $cart_item_key && isset( $bb_contents[ $cart_item_key ] ) ) {
		$bb_new = $bb_contents[ $cart_item_key ];
		unset( $bb_contents[ $cart_item_key ] );
		$cart->cart_contents = array_slice( $bb_contents, 0, (int) $bb_pos, true )
			+ array( (string) $cart_item_key => $bb_new )
			+ array_slice( $bb_contents, (int) $bb_pos, null, true );
	}
	addon_boss_edit_replaced( true );
}

add_filter( 'woocommerce_add_to_cart_redirect', 'addon_boss_edit_redirect_to_cart', 20 );

/**
 * A saved update goes back to the cart, where the shopper came from and
 * where the changed line is. An ordinary add keeps whatever the store does.
 */
function addon_boss_edit_redirect_to_cart( $url ) {
	return addon_boss_edit_replaced() ? wc_get_cart_url() : $url;
}

add_filter( 'wc_add_to_cart_message_html', 'addon_boss_edit_update_message', 10, 2 );

/**
 * The message says what happened: updated, not added.
 */
function addon_boss_edit_update_message( $message, $products = array() ) {
	if ( ! addon_boss_edit_replaced() ) {
		return $message;
	}
	$bb_titles = array();
	foreach ( array_keys( (array) $products ) as $bb_pid ) {
		$bb_t = get_the_title( (int) $bb_pid );
		if ( '' !== $bb_t ) {
			$bb_titles[] = $bb_t;
		}
	}
	if ( ! $bb_titles ) {
		return $message;
	}
	/* translators: %s: the product's name */
	return esc_html( sprintf( __( '%s has been updated in your cart.', 'addon-boss' ), implode( ', ', $bb_titles ) ) );
}

// =================================================================
// STANDALONE SURFACE part 3: file-upload field config (upload meta/key,
// config reader, sanitiser, active-rule check). Lifted from slot-options.
// =================================================================

const ADDON_BOSS_STANDALONE_UPLOAD_META = '_bundle_boss_standalone_upload';
const ADDON_BOSS_STANDALONE_UPLOAD_KEY  = 'bundle_boss_standalone_upload';


// =================================================================
// STANDALONE SURFACE part 4: front-end render + styles + boot JS. Lifted
// from slot-options; registers once via the load-once engine. The one
// external stylesheet is provided per-host via the addon_boss_engine_frontend_css
// filter (BundleBoss -> css/bundle.css), so BundleBoss renders identically.
// =================================================================

// ---- Render -----------------------------------------------------

/**
 * The merchant's Colours choices, sanitised: hex per known token, nothing
 * else. The skin has three layers: neutral defaults that work anywhere, a
 * block theme's published palette flowing in through the var() chains, and
 * these choices over both. Only the four named tokens store, each as a hex
 * colour or not at all.
 *
 * @param array $raw The posted (or stored) map.
 * @return array<string,string>
 */
function addon_boss_sanitize_colours( array $raw ): array {
	$clean = array();
	foreach ( array( 'accent', 'sel', 'receipt', 'wrap' ) as $bb_key ) {
		$bb_val = $raw[ $bb_key ] ?? '';
		$bb_hex = is_string( $bb_val ) ? sanitize_hex_color( trim( $bb_val ) ) : '';
		if ( $bb_hex ) {
			$clean[ $bb_key ] = $bb_hex;
		}
	}
	return $clean;
}

/**
 * The merchant Colours overrides as one inline CSS block, or '' with none
 * set. It only ever RE-STATES tokens (plus the wrapper's panel chrome when
 * the optional tint is on: a tinted wrapper reads as a deliberate panel
 * again, padding and hairline back). Every value passes sanitize_hex_color
 * again at output, so a corrupted store prints nothing unsafe.
 */
function addon_boss_colour_override_css(): string {
	$stored = get_option( 'addon_boss_colours', array() );
	$cols   = addon_boss_sanitize_colours( is_array( $stored ) ? $stored : array() );
	if ( ! $cols ) {
		return '';
	}
	$css    = '';
	$tokens = '';
	foreach ( array( 'accent', 'sel', 'receipt' ) as $bb_key ) {
		if ( isset( $cols[ $bb_key ] ) ) {
			$tokens .= '--aob-' . $bb_key . ':' . $cols[ $bb_key ] . ';';
		}
	}
	if ( '' !== $tokens ) {
		// Every surface the colours are supposed to dress has to carry the
		// tokens, or a merchant sets them and one whole kind of product ignores
		// them. The quantity grid was missing: a grid product has no
		// .bb-standalone-options wrapper at all, so --aob-accent was unset there
		// and the Colours screen appeared to do nothing to anyone selling by
		// grid. Same lesson as the stylesheet enqueue above, which had to list
		// its surfaces for the same reason.
		//
		// This list must MATCH the skin block in css/options.css, which derives
		// the legacy --bb-* accent from --aob-accent. A custom property resolves
		// on the element that declares it, so if the skin derives one level up
		// from where these tokens land, the merchant's colour never reaches the
		// derived values. Listing .bb-quantity-grid here while the stylesheet
		// said .bb-standalone-grid is exactly how the grid kept its old accent
		// while appearing to be covered. Both names, in both places.
		//
		// .bundle-boss-form is deliberately NOT in the stylesheet's derive list:
		// bundles are BundleBoss's surface and keep their own brand-colour
		// setting, which writes --bb-accent at :root. Carrying --aob-* there is
		// harmless and long-standing; deriving the legacy palette there would
		// repaint another plugin's pages from this screen.
		//
		/**
		 * Which storefront surfaces the merchant's colours dress.
		 *
		 * Filterable so a sibling plugin can put its own surface in the list
		 * without this file learning that plugin's name. SupplierBoss's supplier
		 * price grid is the first taker: it sits on a merchant's own product
		 * page, and a brand colour that dressed everything except it would read
		 * as a broken settings screen.
		 *
		 * A surface joining this list has to declare these same token names at
		 * ZERO specificity of its own, via :where(), or the two plain class
		 * rules tie and the winner comes down to which stylesheet happened to
		 * print last.
		 *
		 * @param array<int,string> $surfaces CSS selectors.
		 */
		$surfaces = (array) apply_filters(
			'addon_boss_colour_surfaces',
			array( '.bb-standalone-options', '.bb-standalone-grid', '.bb-quantity-grid', '.bb-tray-peek.bb-st-peek', '.bundle-boss-form' )
		);
		$surfaces = array_filter( array_map( 'strval', $surfaces ) );
		if ( $surfaces ) {
			$css .= implode( ',', $surfaces ) . '{' . $tokens . '}';
		}
	}
	if ( isset( $cols['wrap'] ) ) {
		// A grid product has no options panel, so the tint has to name the grid's
		// own wrapper too or "Options background" does nothing to a grid seller.
		$css .= '.bb-standalone-options,.bb-standalone-grid{--aob-wrap:' . $cols['wrap'] . ';padding:12px;border:1px solid var(--aob-line,#e6e4df);}';
	}
	return $css;
}

add_action( 'wp_enqueue_scripts', 'addon_boss_standalone_options_styles', 21 );

function addon_boss_standalone_options_styles(): void {
	if ( ! function_exists( 'is_product' ) || ! is_product() ) {
		return;
	}
	$queried = wc_get_product( get_queried_object_id() );
	// Every surface this stylesheet dresses has to be listed, or a product using
	// only one of them renders with none of it. Positions and product fields were
	// both missing: a product offering only areas to personalise loaded no
	// stylesheet at all and its tiles came out as bare theme buttons.
	$bb_has_positions = function_exists( 'addon_boss_product_positions' ) && addon_boss_product_positions( $queried );
	$bb_has_fields    = function_exists( 'addon_boss_standalone_product_fields' ) && addon_boss_standalone_product_fields( $queried );

	/**
	 * A sibling surface asking to be DRESSED, and nothing more.
	 *
	 * Distinct from addon_boss_standalone_has_extra on purpose. has_extra means
	 * "render the options panel, I have something to sell in it", and the
	 * receipt renders with it. SupplierBoss's supplier configurator needs only the
	 * stylesheet and the merchant's colours (it joined addon_boss_colour_surfaces
	 * above); when it answered has_extra instead, every supplier-priced product
	 * grew an EMPTY options panel whose receipt echoed the meaningless base
	 * price as a Grand total. Two totals on one screen and only one of them real.
	 *
	 * @param bool       $dresses
	 * @param WC_Product $queried
	 */
	$bb_dress_only = (bool) apply_filters( 'addon_boss_standalone_worth_dressing', false, $queried );

	if ( ! addon_boss_standalone_option_sets( $queried ) && ! apply_filters( 'addon_boss_standalone_has_extra', false, $queried ) && ! $bb_has_positions && ! $bb_has_fields && ! $bb_dress_only ) {
		return;
	}
	addon_boss_standalone_options_dress();
}

/**
 * Dress the options surfaces: the base stylesheet, the skin on top of it, the
 * merchant's colours last, and the boot script. A product page that needs
 * them calls this (above), and so does the set editor's customer page, which
 * must look exactly like the shop it previews.
 */
function addon_boss_standalone_options_dress(): void {
	// The chip/swatch base styles, provided through the filter (AddOnBoss ->
	// css/options.css): register with that URL when given, else a bare handle
	// to carry the inline styles.
	$bb_css = (string) apply_filters( 'addon_boss_engine_frontend_css', '' );
	wp_register_style( 'addon-boss-options-front', '' !== $bb_css ? $bb_css : false, array(), ADDON_BOSS_VERSION );
	wp_enqueue_style( 'addon-boss-options-front' );
	wp_add_inline_style(
		'addon-boss-options-front',
		// The owner-approved hybrid skin: each group is a white card (surface,
		// hairline, the 15px radius, a soft double shadow) standing DIRECTLY
		// on the theme's own page; group names read as treatment B's tracked
		// uppercase labels. The wrapper paints nothing by default (his
		// correction: a fixed tint fights somebody's store, transparent fights
		// nobody's), so --aob-wrap resolves to transparent and the border and
		// padding stay off. The Colours screen's optional tint sets the token
		// AND restores the panel chrome, in its own later rule. Every colour
		// and shape rides a --aob-* token (defined in css/options.css, with a
		// theme-inherit chain and the merchant Colours overrides); the literal
		// fallbacks here keep the surface styled even with no stylesheet.
		'.bb-standalone-options{margin:0 0 1.1em;padding:0;border:0;border-radius:calc(var(--aob-radius,15px) + 4px);background:var(--aob-wrap,transparent);color:var(--aob-text,#3a3f47);font-size:max(16px,1em);}'
		// The card. Groups nested inside a titled section stand down to plain
		// rows (a card in a card is noise); the section carries the chrome.
		. '.bb-standalone-options .bb-attr-group{margin:0 0 12px;padding:15px 16px;border:1px solid var(--aob-line,#e6e4df);border-radius:var(--aob-radius,15px);background:var(--aob-surface,#fff);box-shadow:0 1px 2px rgba(24,26,30,.04),0 10px 28px rgba(24,26,30,.05);}'
		. '.bb-standalone-options > .bb-attr-group:last-child,.bb-standalone-options .bb-po-section:last-child{margin-bottom:0;}'
		. '.bb-standalone-options .bb-attr-group[hidden]{display:none !important;}'
		. '.bb-standalone-options .bb-chip-delta{color:inherit;opacity:.75;font-size:0.85em;font-variant-numeric:tabular-nums;}'
		// A stock-limited option that has sold out renders as a dimmed, disabled
		// chip with a "Sold out" line; a low one carries a quiet "Only N left".
		. '.bb-standalone-options .bb-chips .bb-chip{flex-wrap:wrap;}'
		. '.bb-standalone-options .bb-chips .bb-chip.bb-chip--soldout{opacity:.6;}'
		. '.bb-standalone-options .bb-chips .bb-chip[disabled]{cursor:not-allowed;}'
		// A full-width flex line drops the stock note onto its own row, centred
		// under the name, so it never butts against the label.
		. '.bb-standalone-options .bb-chip-stock{flex-basis:100%;width:100%;margin:3px 0 0;line-height:1;text-align:center;font-size:.72em;font-weight:700;letter-spacing:.02em;}'
		. '.bb-standalone-options .bb-chip-stock--out{color:#b3261e;}'
		. '.bb-standalone-options .bb-chip-stock--low{color:#8a6d00;}'
		// A choice's note is information, so it wears the page's quiet greys.
		// In the accent it was a pink box with a red bar, the same look as
		// "Choose Print first." (tester round 4): red is for what is wrong.
		. '.bb-standalone-options .bb-opt-note{margin:9px 0 2px;padding:9px 12px;border-left:3px solid color-mix(in srgb,var(--aob-mut,#7d8590) 50%,var(--aob-line,#e6e4df));background:var(--aob-soft,#faf9f7);border-radius:0 8px 8px 0;font-size:0.9em;color:var(--aob-text,#3a3f47);line-height:1.45;}'
		. '.bb-standalone-options .bb-opt-note[hidden]{display:none;}'
		// Several-of: the sentence that states the rule ("Choose up to 3.")
		// sits quietly under the chips; a refused pick hands it the accent for
		// a moment, so the answer arrives at the control, not in a theme
		// notice at the top of the page.
		. '.bb-standalone-options .bb-multi-hint{margin:8px 0 0;font-size:0.85em;color:var(--aob-mut,#7d8590);transition:color .2s ease;}'
		. '.bb-standalone-options .bb-multi-hint.is-refused{color:var(--aob-bad,#b3261e);font-weight:700;}'
		// A several-of long set's checkbox rows: plain native ticks in a quiet
		// column, each row a comfortable touch target with its price at rest
		// on the right, the same anatomy as the chips laid on its side.
		. '.bb-standalone-options .bb-checks{display:flex;flex-direction:column;gap:2px;max-width:420px;}'
		. '.bb-standalone-options .bb-check-row{display:flex;align-items:center;gap:10px;margin:0;padding:8px 10px;border-radius:9px;font-size:0.95em;color:var(--aob-text,#3a3f47);cursor:pointer;}'
		. '.bb-standalone-options .bb-check-row:hover{background:var(--aob-soft,#faf9f7);}'
		. '.bb-standalone-options .bb-check-row input{margin:0;accent-color:var(--aob-accent,#fd4730);width:17px;height:17px;flex:none;}'
		. '.bb-standalone-options .bb-check-row .bb-check-name{flex:1 1 auto;min-width:0;}'
		. '.bb-standalone-options .bb-check-row .bb-chip-delta{white-space:nowrap;}'
		// A look-up table on the storefront: an axis label + a row of size
		// buttons (the shared chip), and a live price line that never shifts.
		. '.bb-standalone-options .bb-tbl-store{display:flex;flex-direction:column;gap:12px;}'
		// WIDTH AND HEIGHT ARE ONE MEASUREMENT, SO THEY SIT ON ONE LINE.
		//
		// The two axis rows were stacked at every width: two 112px boxes one
		// above the other in a 511px panel. The measured set beside them has
		// always paired its boxes and stacked only on a phone, so the same
		// product could ask for a size in two different shapes.
		//
		// Evidence for the pair: a single column is the rule for forms, and
		// 2 to 3 inputs on one line is the accepted exception when they are
		// one coherent entity (Baymard: dates, name parts, card number and
		// expiry). W x H is that, and the trade writes it horizontally. Of
		// the made-to-measure shops walked in L5, the ones that type a size
		// pair the boxes and stack them on a phone.
		//
		// Scoped with :has() so only the typed-in case changes: a table that
		// offers a list or a dropdown keeps the column it needs. Anything
		// that is not an axis (the price line) takes a full row of its own.
		. '.bb-standalone-options .bb-tbl-store:has(> .bb-tbl-typedrow){flex-flow:row wrap;align-items:flex-start;gap:12px 20px;}'
		. '.bb-standalone-options .bb-tbl-store:has(> .bb-tbl-typedrow) > :not(.bb-tbl-typedrow){flex:1 0 100%;}'
		. '.bb-standalone-options .bb-tbl-axisrow{display:flex;flex-wrap:wrap;align-items:center;gap:8px 12px;}'
		. '.bb-standalone-options .bb-tbl-axislab{font-size:0.9em;color:var(--aob-mut,#7d8590);min-width:56px;}'
		. '.bb-standalone-options .bb-tbl-priceline{font-size:1.05em;color:var(--aob-ink,#16181d);font-variant-numeric:tabular-nums;}'
		. '.bb-standalone-options .bb-tbl-priceline b{font-weight:700;}'
		. '.bb-standalone-options .bb-tbl-priceline[hidden]{display:none;}'
		. '.bb-standalone-options .bb-tbl-pricenote{color:#b91c1c;font-size:0.9em;}'
		// Typed sizes: a number box per option, with the band it landed in stated
		// beside it, so the shopper reads which row of the price list they are on.
		. '.bb-standalone-options .bb-tbl-typedlab{display:inline-flex;align-items:center;gap:8px;margin:0;}'
		. '.bb-standalone-options .bb-tbl-typedin{width:112px;padding:9px 11px;border:1.5px solid var(--aob-line,#e6e4df);border-radius:10px;background:var(--aob-surface,#fff);color:var(--aob-ink,#16181d);font-size:max(16px,0.95em);line-height:1.3;box-sizing:border-box;font-variant-numeric:tabular-nums;}'
		. '.bb-standalone-options .bb-tbl-typedin:focus{border-color:var(--aob-ink,#16181d);outline:none;box-shadow:0 0 0 3px color-mix(in srgb,var(--aob-ink,#16181d) 7%,transparent);}'
		. '.bb-standalone-options .bb-tbl-unit{font-size:0.85em;color:var(--aob-mut,#7d8590);font-weight:700;}'
		// A list: the native control, themed only as far as the box around it, so the
		// platform's own picker (and its type-ahead) is left alone.
		. '.bb-standalone-options .bb-tbl-listlab{display:inline-flex;align-items:center;gap:8px;margin:0;}'
		. '.bb-standalone-options .bb-tbl-sel{min-width:150px;max-width:100%;padding:10px 11px;border:1.5px solid var(--aob-line,#e6e4df);border-radius:10px;background:var(--aob-surface,#fff);color:var(--aob-ink,#16181d);font-size:max(16px,0.95em);line-height:1.3;}'
		. '.bb-standalone-options .bb-tbl-sel:focus{border-color:var(--aob-ink,#16181d);outline:none;box-shadow:0 0 0 3px color-mix(in srgb,var(--aob-ink,#16181d) 7%,transparent);}'
		. '.bb-standalone-options .bb-tbl-sel option:disabled{color:var(--aob-mut,#7d8590);}'
		// A long choices set rendered as the list control (D6): the same
		// themed select, block-level at a comfortable reading width.
		. '.bb-standalone-options select.bb-list-sel{display:block;width:100%;max-width:420px;}'
		// The colour field: real radios under painted discs, the house tick on the
		// picked one, the custom hatch folded until the script opens it.
		. '.bb-addon-colour{display:flex;flex-wrap:wrap;gap:10px 14px;align-items:center;}'
		// A display rule on a class quietly beats the [hidden] attribute's UA
		// display:none; these keep "hidden" meaning hidden for every flexed
		// piece the script reveals.
		. '.bb-colour-custom[hidden],.bb-colour-pick[hidden],.bb-price-chips[hidden]{display:none;}'
		. '.bb-colour-sw{display:inline-flex;align-items:center;gap:7px;cursor:pointer;margin:0;}'
		. '.bb-colour-sw input{position:absolute;opacity:0;width:1px;height:1px;}'
		. '.bb-colour-disc{width:26px;height:26px;border-radius:8px;border:2px solid rgba(0,0,0,.12);box-sizing:border-box;display:inline-block;position:relative;}'
		. '.bb-colour-sw input:checked + .bb-colour-disc{border-color:currentColor;box-shadow:0 0 0 2px #fff inset,0 0 0 1.5px currentColor;}'
		. '.bb-colour-sw input:focus-visible + .bb-colour-disc{outline:2px solid currentColor;outline-offset:2px;}'
		. '.bb-colour-name{font-size:0.92em;}'
		. '.bb-colour-fee{opacity:.75;}'
		. '.bb-colour-anydisc{background:conic-gradient(#e85c46,#f5d547,#4c9e6e,#3d5a80,#e85c46);}'
		// The custom cluster takes a line of its OWN, deliberately. It is wide
		// (chip, words, fee, and the code pill holding its place), so left in
		// the flow it wrapped as a unit and left a hole in the middle of the
		// swatch row. Its own line reads as a considered second step, and the
		// space that follows it is ordinary trailing space nobody sees.
		. '.bb-colour-custom{display:flex;flex-basis:100%;align-items:center;gap:12px;flex-wrap:nowrap;margin-top:2px;}'
		// ONE pill, not two boxes: the wrap wears the border, the chip and the
		// code sit borderless inside it. Typed selectors so a theme's own
		// input dress (full width, tall boxes) cannot inflate the pair.
		. '.bb-colour-pick{display:inline-flex;align-items:center;gap:2px;padding:3px 4px;border:1px solid rgba(0,0,0,.18);border-radius:10px;background:#fff;}'
		. '.bb-colour-pick input[type=color].bb-colour-picker{width:30px;height:30px;min-height:30px;max-width:30px;padding:1px;border:0;border-radius:7px;background:none;box-sizing:border-box;flex:0 0 auto;cursor:pointer;}'
		. '.bb-colour-pick input[type=text].bb-colour-hex{width:6.4em;max-width:6.4em;min-height:30px;height:30px;padding:0 8px;font-size:15px;border:0;box-shadow:none;outline:none;background:transparent;box-sizing:border-box;flex:0 0 auto;}'
		. '.bb-colour-pick:focus-within{border-color:currentColor;}'
		// The pair keeps its place while hidden, so picking Custom reveals it
		// IN PLACE: nothing below the row moves.
		. '.bb-colour-custom .bb-colour-pick[hidden]{display:inline-flex;visibility:hidden;}'
		// Name your price: chips above a currency-prefixed box; chips hidden until the
		// script that makes them work exists.
		. '.bb-addon-ownprice .bb-price-chips{display:flex;gap:8px;flex-wrap:wrap;margin:0 0 8px;}'
		// color:inherit matters: themes paint button text white for their own
		// filled buttons, and white on our transparent chip is an empty pill.
		. '.bb-price-chip{border:1.5px solid rgba(0,0,0,.2);border-radius:8px;background:transparent;color:inherit;padding:6px 14px;font:inherit;cursor:pointer;}'
		. '.bb-price-chip.is-on{border-color:currentColor;box-shadow:inset 0 0 0 1px currentColor;font-weight:600;}'
		. '.bb-price-entry{display:inline-flex;align-items:center;gap:6px;}'
		. '.bb-price-symbol{opacity:.7;}'
		. '.bb-price-input{max-width:9em;font-size:16px;}'
		. '.bb-addon-ownprice .bb-addon-help{display:block;margin-top:6px;}'
		. '.bb-addon-mailhint{display:block;font-size:.85em;margin-top:4px;text-decoration:underline;text-underline-offset:2px;cursor:pointer;background:none;border:0;padding:0;font-family:inherit;color:inherit;}'
		// The combobox a long list upgrades into. 16px input so phones never zoom;
		// the list scrolls inside itself; unavailable options stay listed, dimmed.
		// Dressed in the panel's own tokens, not in hardcoded greys. It was a
		// white box with a hairline and a 8px tick, which beside our own
		// controls read as a browser default somebody forgot to style, and made
		// the whole control look like a search box rather than a dropdown.
		. '.bb-combo{position:relative;display:block;max-width:420px;}'
		. '.bb-combo-input{width:100%;font-size:16px;box-sizing:border-box;padding-right:40px;cursor:pointer;}'
		// A real chevron, big enough to read as one, and it turns over when the
		// list is open so the control says which way it is facing.
		. '.bb-combo-chev{position:absolute;inset-inline-end:14px;top:50%;width:10px;height:10px;border-right:2px solid currentColor;border-bottom:2px solid currentColor;'
		. 'transform:translateY(-75%) rotate(45deg);opacity:.55;cursor:pointer;transition:transform .16s ease,opacity .16s ease;pointer-events:auto;}'
		. '.bb-combo:hover .bb-combo-chev{opacity:.9;}'
		. '.bb-combo-input[aria-expanded="true"] ~ .bb-combo-chev{transform:translateY(-25%) rotate(225deg);opacity:.9;}'
		// The list matches the BOX, not the page. Theme body type can be 20px and
		// more, which turned sixteen slots into a wall you scroll rather than a
		// list you scan, and made the soft panel disagree with the hard square
		// control above it. 16px is the input's own size, set so phones never
		// zoom, and the two now read as one control.
		. '.bb-combo-list{position:absolute;z-index:30;left:0;right:0;top:calc(100% + 4px);margin:0;padding:4px;list-style:none;font-size:16px;line-height:1.4;'
		. 'background:var(--aob-surface,#fff);color:var(--aob-text,#1f2328);border:1px solid var(--aob-line,#e6e4df);border-radius:10px;'
		. 'max-height:17.5em;overflow-y:auto;overscroll-behavior:contain;box-shadow:0 2px 6px rgba(24,26,30,.06),0 18px 40px -12px rgba(24,26,30,.28);}'
		. '.bb-combo-opt{display:flex;align-items:baseline;gap:8px;padding:7px 10px;border-radius:7px;cursor:pointer;color:inherit;line-height:1.4;}'
		. '.bb-combo-opt mark{background:none;color:inherit;font-weight:700;text-decoration:underline;text-underline-offset:2px;}'
		// Keyboard and pointer land on the same state, so arrowing down looks
		// exactly like hovering. Ink tint, never the accent: coral is for things
		// you press, not for marking where you are.
		. '.bb-combo-opt:hover,.bb-combo-opt.is-hl{background:color-mix(in srgb,var(--aob-ink,#16181d) 8%,transparent);}'
		// What you are on already, marked with a tick rather than a colour, so it
		// survives a dark theme and a colour-blind eye alike.
		. '.bb-combo-opt.is-on{font-weight:600;}'
		. '.bb-combo-opt.is-on::after{content:"\\2713";margin-inline-start:auto;opacity:.75;font-weight:400;}'
		. '.bb-combo-opt.is-dis{color:var(--aob-mut,#7d8590);cursor:default;}'
		. '.bb-combo-opt.is-dis:hover{background:none;}'
		. '.bb-combo-unav{margin-inline-start:auto;font-size:.85em;opacity:.8;}'
		. '.bb-combo-none{padding:9px 11px;color:var(--aob-mut,#7d8590);}'
		// A wallet button held back while an optional answer is on the page.
		// It is a HIDE and not a remove, so clearing the last answer brings
		// the fast checkout straight back. !important because the gateway
		// sets its own display on that node and the alternative to winning
		// is a button that sells the wrong thing.
		//
		// It lives HERE, away from the focus rules, because those carry a pin
		// forbidding !important anywhere near them: a focus ring must win on
		// specificity so a merchant's own CSS can still beat it, and a hammer
		// parked in that block would have quietly made the pin meaningless
		// rather than failed it.
		. '.bb-xp-held{display:none !important;}'
		. '.bb-standalone-options .bb-tbl-bandnote{font-size:0.85em;color:var(--aob-mut,#7d8590);}'
		. '.bb-standalone-options .bb-tbl-bandnote:empty{display:none;}'
		// The quantity box's own label, over it, once it counts packs.
		. 'form.cart .quantity .bb-qty-say{display:block;margin:0 0 4px;font-size:13px;font-weight:600;line-height:1.3;color:var(--aob-ink,#16181d);}'
		// A size past the list's limits: the box and the line under it, in
		// the page's own red, with a mark that is not colour alone.
		. '.bb-standalone-options .bb-tbl-typedin.bb-tbl-bad{border-color:var(--aob-bad,#b3261e);background:color-mix(in srgb,var(--aob-bad,#b3261e) 5%,var(--aob-surface,#fff));}'
		. '.bb-standalone-options .bb-tbl-bandnote.is-bad{color:var(--aob-bad,#b3261e);font-weight:700;}'
		. '.bb-standalone-options .bb-tbl-bandnote.is-bad::before{content:"!"/"";display:inline-grid;place-items:center;width:1.25em;height:1.25em;margin-right:.4em;border-radius:50%;background:var(--aob-bad,#b3261e);color:#fff;font-size:.8em;line-height:1;vertical-align:.1em;}'
		// NOTHING MOVES WHILE THEY TYPE. The band note lives inside its axis
		// row, and the row is a centred flex line, so the moment the note
		// arrived ("priced as up to 40cm") the row grew from 201px to 339px,
		// which is past half the store: width and height stopped sharing a
		// line and height dropped underneath, taking the price with it. A
		// measurement and its note are one column, and the pair keeps its
		// halves: each row takes an equal share and is forbidden to grow out
		// of it, the note sits under its own box, and its line is held open
		// from the start so the note's arrival cannot push anything down
		// either. Measured after: both rows stay at their own half, top
		// unchanged, through an empty box, a typed figure and a cleared one.
		. '.bb-standalone-options .bb-tbl-store:has(> .bb-tbl-typedrow) > .bb-tbl-typedrow'
			. '{flex:1 1 0;min-width:0;flex-flow:column nowrap;align-items:flex-start;gap:4px;}'
		. '.bb-standalone-options .bb-tbl-typedrow > .bb-tbl-typedlab{max-inline-size:100%;}'
		// A NARROW COLUMN (Storefront's summary, a phone): each half is then
		// about 155px, but a label, the 112px box and its unit need about 203,
		// so the unit landed on the next half's label ("Heicmght") and the
		// second box ran off the card (issue 104). Below the width two inline
		// halves need, each label goes above its own box, so the box and its
		// unit keep one line; wider, nothing changes.
		. '.bb-standalone-options .bb-tbl-store:has(> .bb-tbl-typedrow){container-type:inline-size;}'
		. '@container (max-width:439px){'
			. '.bb-standalone-options .bb-tbl-typedrow > .bb-tbl-typedlab{flex-wrap:wrap;row-gap:4px;}'
			. '.bb-standalone-options .bb-tbl-typedrow .bb-tbl-axislab{flex:1 0 100%;}'
			. '.bb-standalone-options .bb-tbl-typedrow .bb-tbl-typedin{flex:0 1 112px;min-width:0;}'
		. '}'
		// Beats the :empty hide above on source order, and only inside a
		// typed row: elsewhere an absent note still takes no room at all.
		// The reservation has to be the note's OWN rendered height, not a
		// guess at it: at 1.25em it was 4px short of the line the note draws
		// and the price below still stepped down by that much. Setting the
		// line-height here as well makes the two the same number by
		// construction, and takes a theme's own line-height out of it.
		. '.bb-standalone-options .bb-tbl-typedrow > .bb-tbl-bandnote'
			. '{display:block;line-height:1.5;min-block-size:1.5em;}'
		// An unsold combination: the option greys out and cannot be picked, so a
		// shopper never reaches a dead end (the same signal as a sold-out variation).
		. '.bb-standalone-options .bb-tbl-opt:disabled,.bb-standalone-options .bb-tbl-opt.bb-tbl-off{opacity:.45;cursor:not-allowed;text-decoration:line-through;box-shadow:none;}'
		. '.bb-standalone-options .bb-when-revealed{box-shadow:inset 3px 0 0 var(--aob-accent,#fd4730),0 1px 2px rgba(24,26,30,.04),0 10px 28px rgba(24,26,30,.05);}'
		// A group renders as a titled section: ONE card owning its members,
		// which sit inside as plain rows split by hairlines.
		. '.bb-standalone-options .bb-po-section{margin:0 0 12px;border:1px solid var(--aob-line,#e6e4df);border-radius:var(--aob-radius,15px);background:var(--aob-surface,#fff);box-shadow:0 1px 2px rgba(24,26,30,.04),0 10px 28px rgba(24,26,30,.05);overflow:hidden;}'
		. '.bb-standalone-options .bb-po-section .bb-attr-group{margin:0;border:0;border-radius:0;box-shadow:none;background:none;}'
		. '.bb-standalone-options .bb-po-section .bb-attr-group + .bb-attr-group{border-top:1px solid var(--aob-line,#e6e4df);}'
		. '.bb-standalone-options .bb-po-section .bb-when-revealed{box-shadow:inset 3px 0 0 var(--aob-accent,#fd4730);}'
		// The edge says a list has just appeared. Once it is answered it has
		// said so: kept, it ran down a whole step beside two green ticks, in a
		// red shop's accent the same red as a refusal (walk, 27 Oct 2026). A
		// refused group keeps its own edge, whatever its header says.
		. '.bb-standalone-options .bb-when-revealed:not(.bb-gmiss):has(> .bb-ghead .bb-gecho-done){box-shadow:0 1px 2px rgba(24,26,30,.04),0 10px 28px rgba(24,26,30,.05);}'
		. '.bb-standalone-options .bb-po-section .bb-when-revealed:not(.bb-gmiss):has(> .bb-ghead .bb-gecho-done){box-shadow:none;}'
		. '.bb-standalone-options .bb-po-section.bb-po-idle{display:none;}'
		. '.bb-standalone-options .bb-po-sectionname{padding:14px 16px 4px;}'
		// ── NUMBERED STEPS WITH A REVIEW ──────────────────────────────────
		// THE NUMBER IS NOT A CSS COUNTER, AND MUST NOT BECOME ONE AGAIN.
		//
		// It was. A counter reads the box tree, and an element with
		// display:none is not in it, so the moment a layout took a card off
		// the screen the count broke: under step by step the earlier steps
		// never incremented and the visible one always rendered "1". Every
		// step read step one, with no error anywhere to say so.
		//
		// bbStepMark writes the digit from the walk it already does, which
		// knows the position whatever any layout is doing to the boxes, and
		// skips a card carrying `hidden` so a conditional question still
		// waiting for its trigger burns no number and nobody reads 1, 2, 4.
		// EVERY BADGE HOST IS A ROW. A section name and a field's label are
		// blocks, so a 26px badge took the first line to itself and the name
		// wrapped underneath it. This rule has always been here; nothing ever
		// wore the class. It carries the row and nothing else, because each
		// head already owns its own padding.
		. '.bb-standalone-options .bb-step-head{display:flex;align-items:center;gap:11px;}'
		// A NUMBERED RUN IS ONE LADDER, so every rung is lettered the same.
		// A set's head is its own 11px tracked uppercase name; a field's head
		// is the field's label, 13px sentence case. Unnumbered that is right,
		// because the two are different things in different places. Numbered
		// they stand in one column under 1, 2, 3, and the badge measures the
		// same 12px from both while the tracked name reads as attached to it
		// and the plain one reads as adrift. So a field's label wears the
		// step-head treatment only while it IS a step head; everywhere else
		// it is untouched. The optional and required markers keep their own
		// casing, which is why they are not uppercased with it.
		. '.bb-standalone-options .bb-addon-label.bb-step-head{font-size:11px;font-weight:800;'
			. 'text-transform:uppercase;letter-spacing:.09em;color:var(--aob-mut,#7d8590);}'
		. '.bb-standalone-options .bb-addon-label.bb-step-head .bb-po-optflag,'
			. '.bb-standalone-options .bb-addon-label.bb-step-head .bb-addon-req,'
			. '.bb-standalone-options .bb-addon-label.bb-step-head .bb-po-reqflag'
			. '{text-transform:none;letter-spacing:0;}'
		. '.bb-standalone-options .bb-po-review .bb-attr-name{font-size:15px;font-weight:800;letter-spacing:0;text-transform:none;color:var(--aob-ink,#16181d);}'
		. '.bb-standalone-options .bb-po-review .bb-gecho{margin-inline-start:auto;}'
		. '.bb-standalone-options .bb-step-n{flex:none;inline-size:26px;block-size:26px;border-radius:50%;'
			. 'display:inline-grid;place-items:center;vertical-align:middle;margin-inline-end:9px;'
			. 'background:var(--aob-ink,#16181d);color:var(--aob-surface,#fff);'
			. 'font-size:13px;font-weight:800;font-variant-numeric:tabular-nums;line-height:1;letter-spacing:0;'
			. 'text-transform:none;}'
		// Inside a card head the badge is one more flex child, so the head owns
		// the gap and the badge drops its own. A set head spreads its children
		// apart (name left, echo right), which floated the NAME into the middle
		// of the card the moment a badge joined it: the name is pushed back
		// against its number and the echo keeps the far end.
		. '.bb-standalone-options .bb-ghead > .bb-step-n,'
			. '.bb-standalone-options .bb-step-head > .bb-step-n{margin-inline-end:0;}'
		// EXCEPT ON A FIELD'S LABEL, WHERE THE GAP IS DELIBERATELY ZERO.
		// A field label carries its name as bare text followed by its own
		// "(optional)" marker, and that text already ends in a word space, so
		// the row sets gap:0 to keep the marker against the name it qualifies.
		// The badge was then spaced by nothing at all: the gap it was told to
		// rely on does not exist here, and its own margin had already been
		// zeroed for the heads that do have one. It keeps its margin instead,
		// at the same 11px its lettered siblings take from their gap, so one
		// ladder measures the same from every rung.
		. '.bb-standalone-options .bb-addon-label.bb-step-head > .bb-step-n{margin-inline-end:11px;}'
		// WHAT GETS PUSHED TO THE FAR END IS THE ECHO, never the name. Pushing
		// the name meant the free space sat in a different place depending on
		// whether a badge was present, and a second pusher (the fold chevron)
		// split it with the first, so "Choose" landed at a different x on
		// every card down the page. The review row has always done it this
		// way; now every head does.
		. '.bb-standalone-options .bb-ghead > .bb-gecho{margin-inline-start:auto;}'
		// A FINISHED STEP KEEPS ITS NUMBER and goes green. Swapping the number
		// for a tick is the convention in a one-step-at-a-time checkout, where
		// only one number is on screen; on a page showing all of them at once
		// it reads "tick tick tick 5 tick tick 8", and the sequence the layout
		// exists to give stops being a sequence. The green is the same one the
		// rest of the page already means done with, so nothing is lost.
		. '.bb-standalone-options .bb-step-n.is-done{background:var(--aob-good,#1a7f37);}'
		// STEP BY STEP. The hide is a class the script adds, never a rule that
		// matches a section by its own name: a page whose script never ran has
		// nothing wearing this, so every step is on screen and the product is
		// still buyable.
		//
		// UNDER THE GRID AS WELL AS THE PANEL, here and on every rail rule
		// below. On a quantity grid the quantities are step one and they sit
		// beside the panel, not inside it, so the step being put away and the
		// rail standing above it are both children of the grid.
		. ':is(.bb-standalone-options,.bb-standalone-grid) .bb-step-off{display:none;}'
		// A place found from the rules wraps its lists for the walk only: laid
		// out as if it were not there, so every list keeps its own card.
		. '.bb-standalone-options > .bb-po-autoplace:not(.bb-step-off):not(.bb-step-wait){display:contents;}'
		// The met marker, and the bar's way back to the first thing still owed.
		// Under the grid too, where a whole-order set wears the same pill. It
		// names the pill's own classes so it outranks the pill's look further
		// down this sheet: at equal weight that later rule won, and an answered
		// question kept its Required beside the tick on every page.
		. ':is(.bb-standalone-options,.bb-standalone-grid) :is(.bb-addon-req,.bb-po-reqflag).bb-req-met{display:none;}'
		// THE SAME BUTTON LIVES IN TWO HOSTS, so it is reset in both. The bar
		// at the foot is `.bb-st-peek`, a child of the BODY and not of the
		// panel, so a rule scoped to the panel alone never reaches it and the
		// THEME styles the button instead: measured at 127x46 with 30px of
		// padding and the theme's own blue, which made a foreign slab louder
		// than Add to cart, and wide enough to sit on top of the sentence it
		// belongs to. Every other rule for that bar already carries the
		// `.bb-st-peek` prefix; this one did not.
		//
		// A word, not a slab: this is the way BACK to something unanswered, so
		// it must not outweigh the price beside it or the basket button. The
		// size comes from the host, which is smaller in the bar than in the
		// panel, so the word sits at the bar's own scale without a rule per
		// host.
		. '.bb-standalone-options .bb-st-show,.bb-st-peek .bb-st-show{'
			. 'font:inherit;font-size:inherit;padding:0;border:0;'
			. 'background:none;color:inherit;cursor:pointer;text-decoration:underline;text-underline-offset:3px;}'
		// AND BIG ENOUGH TO PRESS. A bare word measured 54x21, under the 24px
		// WCAG 2.5.8 asks for, and the row it sits in has the height to give:
		// the padding goes sideways and the target grows with a negative
		// margin, so the words stay where they were and only the hit area
		// changes.
		. '.bb-standalone-options .bb-st-show,.bb-st-peek .bb-st-show{'
			. 'min-height:24px;padding-inline:4px;margin-inline:-4px;}'
		// To a finger, 44px, the size Apple asks (24px measured on a phone, walk,
		// 27 Oct 2026). The negative margin gives the extra back to the line, so
		// the bar does not grow and the word does not move.
		. '@media (pointer:coarse){.bb-standalone-options .bb-st-show,.bb-st-peek .bb-st-show{'
			. 'min-height:44px;margin-block:-10px;vertical-align:middle;}}'
		. '.bb-standalone-options .bb-st-show:focus-visible,.bb-st-peek .bb-st-show:focus-visible{'
			. 'outline:2px solid currentColor;outline-offset:2px;border-radius:3px;}'
		// THE RAIL, as a card above the questions: which step this is, what it
		// is called, and a bar per step with the names under them where there
		// is room. Nothing wears any of this until the script builds it, so a
		// page whose script never ran has no rail and no gap where one would be.
		. ':is(.bb-standalone-options,.bb-standalone-grid) .bb-steprail{margin:0 0 12px;padding:14px 16px 13px;'
			. 'border:1px solid var(--aob-line,#e6e4df);border-radius:var(--aob-radius,15px);'
			. 'background:var(--aob-surface,#fff);'
			. 'box-shadow:0 1px 2px rgba(24,26,30,.04),0 10px 28px rgba(24,26,30,.05);}'
		. ':is(.bb-standalone-options,.bb-standalone-grid) .bb-rail-of{margin:0;font-size:12px;font-weight:700;'
			. 'letter-spacing:.09em;text-transform:uppercase;color:var(--aob-mut,#7d8590);}'
		. ':is(.bb-standalone-options,.bb-standalone-grid) .bb-rail-now{margin:2px 0 0;font-size:21px;font-weight:800;'
			. 'letter-spacing:-.01em;line-height:1.2;color:var(--aob-ink,#16181d);}'
		. ':is(.bb-standalone-options,.bb-standalone-grid) .bb-rail-now:focus{outline:none;}'
		. ':is(.bb-standalone-options,.bb-standalone-grid) .bb-rail-now:focus-visible{outline:2px solid var(--aob-ink,#16181d);'
			. 'outline-offset:3px;border-radius:4px;}'
		// The heading takes focus on every move so a screen reader is told. A
		// box round a line of large bold text reads as an editable field, so a
		// press that was not a keyboard press never draws one, whatever the
		// engine's own :focus-visible heuristic would have done.
		. ':is(.bb-standalone-options,.bb-standalone-grid) .bb-rail-now.bb-rail-quiet:focus-visible{outline:none;}'
		// EQUAL COLUMNS, which is what makes the bars read as a measure of the
		// journey rather than a decoration, and what gives every name exactly
		// the same room. min-width:0 all the way down, or a grid item refuses
		// to shrink below its own content and the row silently widens instead
		// of cutting anything, which is the thing the script measures.
		// NO GAP BETWEEN THE COLUMNS, and the spacing moved inside the cell
		// instead. A grid gap belongs to nothing, so with four steps it left
		// 21px of the row dead: press there and nothing happens, which on a
		// row this thin is most of what a finger finds. The step now owns its
		// whole column edge to edge and the bar carries the visual gap.
		. ':is(.bb-standalone-options,.bb-standalone-grid) .bb-rail-bars{display:grid;grid-auto-flow:column;'
			. 'grid-auto-columns:1fr;gap:0;margin:8px 0 0;padding:0;list-style:none;}'
		// display:block, not the list item an li is by default: a theme that
		// restores list numbering inside its content area (Divi does) gave
		// every bar a "1." above it, list-style:none on the row or not.
		. ':is(.bb-standalone-options,.bb-standalone-grid) .bb-rail-cell{display:block;min-width:0;}'
		// THE PRESS AREA IS THE PADDING. WCAG 2.2 asks 24px, Apple asks 44 and
		// Android 48, and a 5px bar answers none of them: on a phone, where the
		// names come off and the bar is all that is left, this row was 5px tall
		// to a finger. The padding is real rather than an invisible overlay, so
		// nothing overlaps its neighbours and the thing pressed is the thing
		// seen. The card's own spacing gives most of it back, so the rail grows
		// by a few pixels, not by forty.
		. ':is(.bb-standalone-options,.bb-standalone-grid) .bb-rail-step{display:block;inline-size:100%;min-width:0;'
			. 'border:0;background:none;padding:10px 0 11px;font:inherit;text-align:start;'
			. 'cursor:pointer;border-radius:7px;}'
		. ':is(.bb-standalone-options,.bb-standalone-grid) .bb-rail-bar{display:block;block-size:5px;border-radius:999px;'
			. 'margin-inline-end:7px;background:var(--aob-line,#e6e4df);}'
		. ':is(.bb-standalone-options,.bb-standalone-grid) .bb-rail-cell:last-child .bb-rail-bar{margin-inline-end:0;}'
		// IT ANSWERS A POINTER WITHOUT GROWING ANY FURNITURE. A tile behind each
		// step was tried and it does read as a button, but it puts four boxes
		// on a card that had none, and the row stops looking like a journey and
		// starts looking like a toolbar. So the control IS the bar and its name,
		// and those two are what respond: the bar swells and deepens, the name
		// goes to ink. Nothing appears that was not already there.
		//
		// scaleY, never a height: a height change would move the name under it
		// and shove the whole card down by a pixel on every hover.
		. ':is(.bb-standalone-options,.bb-standalone-grid) .bb-rail-bar{transform-origin:center;'
			. 'transition:background .16s ease, transform .16s ease;}'
		. ':is(.bb-standalone-options,.bb-standalone-grid) .bb-rail-nm,:is(.bb-standalone-options,.bb-standalone-grid) .bb-rail-n{'
			. 'transition:color .16s ease;}'
		. '@media (hover:hover){'
			. ':is(.bb-standalone-options,.bb-standalone-grid) .bb-rail-step:hover .bb-rail-bar{transform:scaleY(1.9);}'
			. ':is(.bb-standalone-options,.bb-standalone-grid) .bb-rail-step:hover .bb-rail-nm,'
			. ':is(.bb-standalone-options,.bb-standalone-grid) .bb-rail-step:hover .bb-rail-n{color:var(--aob-ink,#16181d);}'
			// Only a step still AHEAD needs darkening. Done is already green and
			// current is already ink, and recolouring either would say the hover
			// had changed what the step is.
			// A waiting step is not ahead either: darkening its dashes into a
			// solid bar would say it can be walked to.
			. ':is(.bb-standalone-options,.bb-standalone-grid) .bb-rail-step:not(.is-done):not(.is-now):not(.is-owed):not(.is-wait):hover'
				. ' .bb-rail-bar{background:color-mix(in srgb, var(--aob-ink,#16181d) 42%,'
				. ' var(--aob-line,#e6e4df));}}'
		// The press itself, so a finger gets an answer on a device with no hover.
		. ':is(.bb-standalone-options,.bb-standalone-grid) .bb-rail-step:active .bb-rail-bar{transform:scaleY(.7);}'
		. '@media (prefers-reduced-motion:reduce){'
			. ':is(.bb-standalone-options,.bb-standalone-grid) .bb-rail-bar,:is(.bb-standalone-options,.bb-standalone-grid) .bb-rail-nm,'
			. ':is(.bb-standalone-options,.bb-standalone-grid) .bb-rail-n{transition:none;}'
			. ':is(.bb-standalone-options,.bb-standalone-grid) .bb-rail-step:hover .bb-rail-bar{transform:none;}}'
		// Green for done, ink for here, and the marker's own colour for a step
		// the shopper walked away from owing something. Ahead is the plain bar.
		. ':is(.bb-standalone-options,.bb-standalone-grid) .bb-rail-step.is-done .bb-rail-bar{background:var(--aob-good,#1a7f37);}'
		. ':is(.bb-standalone-options,.bb-standalone-grid) .bb-rail-step.is-now .bb-rail-bar{background:var(--aob-ink,#16181d);}'
		. ':is(.bb-standalone-options,.bb-standalone-grid) .bb-rail-step.is-owed .bb-rail-bar{background:var(--aob-bad,#b3261e);}'
		. ':is(.bb-standalone-options,.bb-standalone-grid) .bb-rail-nm,:is(.bb-standalone-options,.bb-standalone-grid) .bb-rail-n{display:block;'
			. 'margin-top:7px;padding-inline-end:7px;font-size:12.5px;font-weight:700;'
			. 'color:var(--aob-mut,#7d8590);white-space:nowrap;overflow:hidden;text-overflow:ellipsis;}'
		. ':is(.bb-standalone-options,.bb-standalone-grid) .bb-rail-n{font-variant-numeric:tabular-nums;}'
		. ':is(.bb-standalone-options,.bb-standalone-grid) .bb-rail-cell:last-child .bb-rail-nm,'
			. ':is(.bb-standalone-options,.bb-standalone-grid) .bb-rail-cell:last-child .bb-rail-n{padding-inline-end:0;}'
		. ':is(.bb-standalone-options,.bb-standalone-grid) .bb-rail-step.is-done .bb-rail-nm::before,'
			. ':is(.bb-standalone-options,.bb-standalone-grid) .bb-rail-step.is-done .bb-rail-n::before{content:"\\2713\\A0";}'
		. ':is(.bb-standalone-options,.bb-standalone-grid) .bb-rail-step.is-done .bb-rail-nm,'
			. ':is(.bb-standalone-options,.bb-standalone-grid) .bb-rail-step.is-done .bb-rail-n,'
			. ':is(.bb-standalone-options,.bb-standalone-grid) .bb-rail-step.is-now .bb-rail-nm,'
			. ':is(.bb-standalone-options,.bb-standalone-grid) .bb-rail-step.is-now .bb-rail-n{color:var(--aob-ink,#16181d);}'
		. ':is(.bb-standalone-options,.bb-standalone-grid) .bb-rail-step.is-owed .bb-rail-nm,'
			. ':is(.bb-standalone-options,.bb-standalone-grid) .bb-rail-step.is-owed .bb-rail-n{color:var(--aob-bad,#b3261e);}'
		// A STEP STILL WAITING ON AN EARLIER ANSWER is drawn and never walked
		// (see bbRailSteps): a dashed bar, a quieter name, and the help cursor,
		// because pressing it explains rather than moves. The plain dashes go
		// first, for an engine without color-mix, so the bar is never missing.
		. ':is(.bb-standalone-options,.bb-standalone-grid) .bb-rail-step.is-wait{cursor:help;}'
		. ':is(.bb-standalone-options,.bb-standalone-grid) .bb-rail-step.is-wait .bb-rail-bar{'
			. 'background:repeating-linear-gradient(90deg,var(--aob-line,#e6e4df) 0 7px,transparent 7px 11px);'
			. 'background:repeating-linear-gradient(90deg,'
			. 'color-mix(in srgb,var(--aob-ink,#16181d) 6%,var(--aob-line,#e6e4df)) 0 7px,transparent 7px 11px);}'
		. ':is(.bb-standalone-options,.bb-standalone-grid) .bb-rail-step.is-wait .bb-rail-nm{font-weight:600;color:var(--aob-mut,#7d8590);'
			. 'color:color-mix(in srgb,var(--aob-mut,#7d8590) 60%,var(--aob-surface,#fff));}'
		// It has no number, and an empty line would leave it shorter than its
		// neighbours to a finger where the names are off: a space holds the row.
		. ':is(.bb-standalone-options,.bb-standalone-grid) .bb-rail-step.is-wait .bb-rail-n::before{content:"\\A0";}'
		// A RAIL OF PLACES (a product whose steps are named sections; see
		// bbStepPlaces) never draws a step waiting: every place is a plain
		// step, and one the answers rule out slides away. Flex rather than the
		// grid, because a column cannot be animated out of a grid and a flex
		// item's share can. Equal shares all the same: 1 1 0 with min-width 0
		// is the grid's 1fr. The clip is only for a cell on its way in or
		// out, or it would cut a focus ring off the cell at rest.
		. ':is(.bb-standalone-options,.bb-standalone-grid) .bb-rail-places .bb-rail-bars{display:flex;}'
		// A theme pads every list in its content (Divi: 23px under an ol, on a
		// selector with an id in it), which left an empty band under the bars
		// inside the rail's card (walk, 27 Oct 2026). Nothing short of
		// !important outranks an id from a stylesheet we do not own.
		. ':is(.bb-standalone-options,.bb-standalone-grid) .bb-steprail .bb-rail-bars{padding:0 !important;}'
		. '.bb-standalone-options > .bb-step-wait{display:none;}'
		. ':is(.bb-standalone-options,.bb-standalone-grid) .bb-rail-places .bb-rail-cell{flex:1 1 0;'
			. 'transition:flex-grow .2s ease,opacity .2s ease;}'
		. ':is(.bb-standalone-options,.bb-standalone-grid) .bb-rail-places .bb-rail-cell.is-gone{flex-grow:0;opacity:0;}'
		. ':is(.bb-standalone-options,.bb-standalone-grid) .bb-rail-places .bb-rail-cell.is-gone,'
			. ':is(.bb-standalone-options,.bb-standalone-grid) .bb-rail-places .bb-rail-cell.is-moving{overflow:hidden;}'
		// The last place STILL ON the rail ends it flush, which is not always
		// the last cell: that one may have slid away.
		. ':is(.bb-standalone-options,.bb-standalone-grid) .bb-rail-places .bb-rail-cell.is-end .bb-rail-bar{margin-inline-end:0;}'
		. ':is(.bb-standalone-options,.bb-standalone-grid) .bb-rail-places .bb-rail-cell.is-end .bb-rail-nm,'
			. ':is(.bb-standalone-options,.bb-standalone-grid) .bb-rail-places .bb-rail-cell.is-end .bb-rail-n{padding-inline-end:0;}'
		// THE PLACE YOU ARE IN KEEPS ITS NAME. Five names are the plan; a gap
		// in them reads as a step missing, and once the step is answered the
		// gap held a lone tick that read as a stray mark.
		. ':is(.bb-standalone-options,.bb-standalone-grid) .bb-rail-places .bb-rail-step.is-now .bb-rail-nm{visibility:visible;}'
		. '@media (prefers-reduced-motion:reduce){'
			. ':is(.bb-standalone-options,.bb-standalone-grid) .bb-rail-places .bb-rail-cell{transition:none;}}'
		// What it is waiting for, under the bars, once the step is pressed.
		// Empty, it takes no room.
		. ':is(.bb-standalone-options,.bb-standalone-grid) .bb-rail-why{display:flex;gap:7px;align-items:flex-start;margin:0;'
			. 'font-size:13px;line-height:1.4;color:var(--aob-ink,#16181d);'
			. 'color:color-mix(in srgb,var(--aob-ink,#16181d) 72%,var(--aob-surface,#fff));}'
		. ':is(.bb-standalone-options,.bb-standalone-grid) .bb-rail-why:not(:empty){margin-top:1px;}'
		. ':is(.bb-standalone-options,.bb-standalone-grid) .bb-rail-why-i{flex:none;box-sizing:border-box;inline-size:16px;block-size:16px;'
			. 'margin-top:1px;border:1.5px solid currentColor;border-radius:50%;font-size:10px;font-weight:700;'
			. 'font-style:normal;line-height:13px;text-align:center;opacity:.75;}'
		// THE STEP THE SHOPPER IS ON IS ALREADY THE HEADING an inch above this
		// row, so the row does not write it a second time. The heading is then
		// where you are and the list is what is ahead, each said once.
		//
		// visibility, NOT font-size and NOT display, for three reasons. The box
		// stays laid out, so the fit measurement still reads this name at its
		// full width and cannot decide a rail fits because the one name too
		// long for it happens to be the current one. The line box keeps its
		// height, so the rail does not move as the shopper walks. And a hidden
		// box is still a box, so the tick below can be handed its own back.
		//
		// A screen reader loses nothing: the button carries an aria-label of
		// the step's name whatever this row shows, and aria-current says which
		// step it is.
		. ':is(.bb-standalone-options,.bb-standalone-grid) .bb-rail-step.is-now .bb-rail-nm{visibility:hidden;}'
		// THE TICK IS NOT THE NAME. A step can be both current and answered,
		// and the only mark saying so hangs off this element, so it asks for
		// itself.
		. ':is(.bb-standalone-options,.bb-standalone-grid) .bb-rail-step.is-now .bb-rail-nm::before{visibility:visible;}'
		// THE MEASUREMENT SWAPS A NAME FOR A NUMBER, never for nothing. The
		// bars stay either way, so the shape of the journey survives a column
		// with no room to write in, and the number keeps the row tall enough
		// to press and says which step each bar is.
		. ':is(.bb-standalone-options,.bb-standalone-grid) .bb-rail-n{display:none;}'
		. ':is(.bb-standalone-options,.bb-standalone-grid) .bb-rail-bare .bb-rail-nm{display:none;}'
		. ':is(.bb-standalone-options,.bb-standalone-grid) .bb-rail-bare .bb-rail-n{display:block;}'
		. ':is(.bb-standalone-options,.bb-standalone-grid) .bb-rail-step:focus-visible{border-radius:5px;'
			. 'outline:2px solid var(--aob-ink,#16181d);outline-offset:3px;}'
		// THE RING IS FOR A KEYBOARD HERE TOO. A press on a waiting step keeps
		// the focus where it is, and a theme that rings every focused button
		// (Storefront does, in its accent colour) then boxed the step a finger
		// had just tapped. Every other press moves the focus to the heading, so
		// this never showed before steps could wait.
		. ':is(.bb-standalone-options,.bb-standalone-grid) .bb-rail-step:focus:not(:focus-visible){outline:none;}'
		// THE STEP'S NAME IS THE RAIL'S HEADING, so the section does not print
		// it again three lines below it. Under this layout a step IS a section,
		// so the two were always the same words, twice, within an inch.
		//
		// HIDDEN, NOT DROPPED. The walk still reads this row to know the
		// section is one card, and the numbering still writes into it. That is
		// only safe because the number comes from the walk now: a CSS counter
		// does not increment for a box with display:none, which is exactly the
		// bug that made every step read "1".
		. '.bb-standalone-options[data-bb-layout="stepbystep"] > .bb-po-section:not(.bb-po-review)'
			. ' > .bb-po-sectionname{display:none;}'
		// The review keeps its row, because the verdict lives in it and that is
		// the one thing on the page saying whether the basket will take this.
		. '.bb-standalone-options[data-bb-layout="stepbystep"] > .bb-po-review'
			. ' > .bb-po-sectionname > .bb-attr-name{display:none;}'
		. '.bb-standalone-options .bb-stepnav{display:flex;align-items:center;gap:14px;'
			. 'margin:18px 0 4px;padding-top:15px;border-top:1px solid var(--aob-line,#e6e4df);}'
		. '.bb-standalone-options .bb-stepnav[hidden]{display:none;}'
		// Continue takes the slack, so it is the whole row on the first step
		// and the far end of it once Back joins. It also carries the longest
		// words on the panel, because it names the step it goes to.
		. '.bb-standalone-options .bb-stepnext{flex:1 1 auto;}'
		. '.bb-standalone-options .bb-stepbtn{font:inherit;font-size:15px;font-weight:700;'
			. 'padding:11px 20px;border-radius:9px;cursor:pointer;border:1px solid var(--aob-line,#e6e4df);'
			. 'background:var(--aob-surface,#fff);color:var(--aob-ink,#16181d);min-width:112px;}'
		. '.bb-standalone-options .bb-stepnext{border-color:var(--aob-ink,#16181d);'
			. 'background:var(--aob-ink,#16181d);color:var(--aob-surface,#fff);}'
		. '.bb-standalone-options .bb-stepbtn[hidden]{display:none;}'
		// Back leaves, and the count must not slide across to fill the hole it
		// left: the number would move every time the shopper moved a step.
		. '.bb-standalone-options .bb-stepbtn:focus-visible{outline:2px solid var(--aob-ink,#16181d);outline-offset:2px;}'
		// THE REVIEW: the last step, and the reason the layout exists. Every
		// question and what it holds, in one block right above the button.
		. '.bb-standalone-options .bb-review-rows{padding:0 16px 6px;}'
		. '.bb-standalone-options .bb-review-row{display:grid;'
			. 'grid-template-columns:minmax(0,1fr) minmax(0,1.3fr) auto;gap:4px 14px;align-items:baseline;'
			. 'padding:10px 0;border-top:1px solid var(--aob-line,#e6e4df);font-size:14.5px;}'
		. '.bb-standalone-options .bb-review-row:first-child{border-top:0;}'
		. '.bb-standalone-options .bb-review-k{min-width:0;font-size:12.5px;font-weight:700;'
			. 'letter-spacing:.04em;text-transform:uppercase;color:var(--aob-mut,#7d8590);}'
		. '.bb-standalone-options .bb-review-v{min-width:0;color:var(--aob-ink,#16181d);font-weight:600;overflow-wrap:anywhere;}'
		// A blank answer SAYS so rather than sitting empty. It shouts ONLY when
		// the button will refuse over it: an optional field left alone is not a
		// problem, and a column of coral beside a basket that is perfectly
		// ready is the error screen this layout exists to replace.
		. '.bb-standalone-options .bb-review-row.is-blank .bb-review-v{color:var(--aob-mut,#7d8590);font-weight:500;}'
		. '.bb-standalone-options .bb-review-row.is-owed .bb-review-v{color:var(--aob-accent,#fd4730);font-weight:700;}'
		// The way back. A quiet text button, because it repeats down every row
		// and a column of coral would drown the answers standing beside it.
		. '.bb-standalone-options .bb-review-go{margin:0;padding:0;border:0;background:none;box-shadow:none;'
			. 'font:inherit;font-size:12.5px;font-weight:700;line-height:1.3;color:var(--aob-mut,#7d8590);'
			. 'text-decoration:underline;text-underline-offset:2px;cursor:pointer;}'
		. '.bb-standalone-options .bb-review-go:hover,.bb-standalone-options .bb-review-go:focus-visible{color:var(--aob-accent,#fd4730);}'
		. '.bb-standalone-options .bb-review-go:focus-visible{outline:2px solid var(--aob-accent,#fd4730);outline-offset:3px;border-radius:4px;}'
		. '.bb-standalone-options .bb-step-verdict.is-owed{color:var(--aob-accent,#fd4730);font-weight:700;}'
		. '.bb-standalone-options .bb-step-verdict.is-ready{color:var(--aob-good,#1a7f37);font-weight:700;}'
		// On a narrow screen the three columns become two lines: the question
		// over its answer, the way back in the corner. Three columns at 320px
		// left the answer 60px and broke every value onto four lines.
		. '@media (max-width:600px){'
			. '.bb-standalone-options .bb-review-row{grid-template-columns:minmax(0,1fr) auto;}'
			. '.bb-standalone-options .bb-review-k{grid-column:1;}'
			. '.bb-standalone-options .bb-review-v{grid-column:1;}'
			. '.bb-standalone-options .bb-review-go{grid-column:2;grid-row:1/span 2;align-self:center;}'
		. '}'
		// The header row: name left, echo right. The echo is the receipt and
		// the required marking in one: accent "Choose" while unanswered, the
		// value and its money once answered, the good green once done.
		. '.bb-standalone-options .bb-ghead{display:flex;width:100%;justify-content:space-between;align-items:center;gap:12px;margin:0;padding:0;background:none;border:0;font:inherit;color:inherit;text-align:left;box-shadow:none;}'
		. 'button.bb-ghead{cursor:pointer;}'
		. '.bb-standalone-options .bb-ghead:focus-visible{outline:2px solid var(--aob-accent,#fd4730);outline-offset:2px;border-radius:6px;}'
		// Treatment B's group label: a small tracked uppercase eyebrow in a
		// tone between muted and ink, and the "(optional)" suffix stepping
		// back out of the uppercase into its own quiet weight.
		// A FIELD'S LABEL ACTING AS A FOLD HEAD IS A HEAD, not a form label.
		// Left to itself it renders at 13px in sentence case, so a folded
		// stack that mixes set names with field labels had two of its seven
		// rows speaking in a different voice. The label keeps its own voice
		// everywhere else; it borrows this one only in the head position.
		// TWO THINGS WERE SPACING ONE PAIR. A marker inside a label already
		// carries a 6px word space of its own; making the label a flex row
		// added the row gap on top, so "(optional)" drifted 16px off the
		// name it qualifies while a set's marker sat right against it. The
		// row keeps no gap: the declared word space is the whole spacing,
		// and the chevron is placed by an auto margin, not by the gap.
		. '.bb-standalone-options .bb-addon-label.bb-fg-head{gap:0;}'
		. '.bb-standalone-options .bb-attr-name,'
		. '.bb-standalone-options .bb-addon-label.bb-fg-head{font-size:11px;font-weight:800;letter-spacing:.09em;text-transform:uppercase;color:color-mix(in srgb,var(--aob-mut,#7d8590) 80%,var(--aob-ink,#16181d));margin:0;}'
		. '.bb-standalone-options .bb-gopt{text-transform:none;letter-spacing:normal;}'
		// The field echo rides INSIDE the label, so it inherits the head's
		// tracked caps and its heavy weight unless it says otherwise: the
		// sets read "None" and the fields shouted "NONE" beside them.
		. '.bb-standalone-options .bb-fecho{text-transform:none;letter-spacing:normal;font-weight:400;}'
		. '.bb-gopt{font-weight:600;color:var(--aob-mut,#7d8590);font-size:11.5px;}'
		// The Required flag: one pill everywhere the word appears (set heads,
		// field labels, the fold family's section rows). Accent ink on the
		// accent-soft ground, small caps, never plain red text. The literal
		// ground declares first, so a browser without color-mix() keeps a
		// readable pill instead of dropping the declaration.
		. '.bb-standalone-options .bb-addon-req,.bb-standalone-options .bb-po-reqflag{display:inline-block;color:var(--aob-accent,#fd4730);background:#fff1ee;background:color-mix(in srgb,var(--aob-accent,#fd4730) 9%,var(--aob-surface,#fff));border:0;border-radius:99px;padding:2px 9px;font-size:10.5px;font-weight:700;letter-spacing:.05em;line-height:1.5;text-transform:none;font-variant-caps:all-small-caps;white-space:nowrap;vertical-align:middle;}'
		. '.bb-gecho,.bb-fecho{font-size:12.5px;color:var(--aob-mut,#7d8590);text-align:right;font-variant-numeric:tabular-nums;}'
		. '.bb-gecho.bb-gecho-todo{color:var(--aob-accent,#fd4730);font-weight:700;}'
		. '.bb-gecho.bb-gecho-done{color:var(--aob-good,#1a7f37);font-weight:600;}'
		// THE TICK: the STATE of a group, beside its own name.
		//
		// The echo says what was picked, which is the answer, not the state. A
		// shopper scanning a long panel for what is still owed had to read every
		// value on it to find the empty one, and a fill-in field had no marking
		// of any kind: nothing said "done" but the words they had typed
		// themselves. The tick is one glance.
		//
		// Drawn, not written. A glyph in generated content is read out by some
		// screen readers as a word beside a name that is already marked
		// "Required" or "(optional)", and it would fall back to a box in a font
		// without it; two borders on a rotated box always draw.
		. '.bb-standalone-options .bb-tick::before{content:"";display:inline-block;vertical-align:middle;'
			. 'width:10px;height:6px;margin-block-start:-3px;margin-inline-end:7px;'
			. 'border-left:2px solid var(--aob-good,#1a7f37);border-bottom:2px solid var(--aob-good,#1a7f37);'
			. 'transform:rotate(-45deg);}'
		// A REFUSAL IS NOT THE BRAND COLOUR.
		//
		// This block wore --aob-accent, the merchant's own colour, on the theory
		// that a refusal should match the Choose echo. On a shop whose accent is
		// green (#0f6b52 on the dev store) that painted every refusal green, which
		// reads as a tick. Worse, .bb-when-revealed draws the SAME inset edge in
		// the SAME colour, so a group that had just been refused and a group that
		// had just appeared were indistinguishable. His find, 7 Sept: "there's no
		// real indication as to why it's not letting you add to cart". There was
		// one. It was green, 12.5px, and looked like everything else.
		//
		// --aob-bad never derives from the accent. A merchant can set a house red;
		// they cannot accidentally set the refusal colour to their brand colour by
		// picking one on the Colours screen.
		. '.bb-standalone-options .bb-attr-group.bb-gmiss{box-shadow:inset 3px 0 0 var(--aob-bad,#b3261e),0 1px 2px rgba(24,26,30,.04),0 10px 28px rgba(24,26,30,.05);background:color-mix(in srgb,var(--aob-bad,#b3261e) 4%,var(--aob-surface,#fff));}'
		. '.bb-standalone-options .bb-po-section .bb-attr-group.bb-gmiss{box-shadow:inset 3px 0 0 var(--aob-bad,#b3261e);}'
		// The words of the block, at the offender: filled by the gate and gone the
		// moment the group is answered. Empty and [hidden] until then.
		. '.bb-standalone-options .bb-gmiss-note{margin:6px 0 0;font-size:13px;font-weight:700;color:var(--aob-bad,#b3261e);}'
		. '.bb-standalone-options .bb-gmiss-note[hidden]{display:none;}'
		. '.bb-standalone-options .bb-gmiss .bb-addon-ownprice .bb-addon-help{color:var(--aob-bad,#b3261e);}'
		. '.bb-standalone-options .bb-gmiss-here{margin-top:3px;}'
		// A SECTION OWED AN ANSWER IS ONE PROBLEM, NOT THREE. Its sentence sits
		// once, in a bar above the section, with each of its questions as a
		// button that jumps there; the questions wear one quiet edge between
		// them, never three pink cards, because none of them alone is wrong.
		. '.bb-sec-band{display:flex;gap:12px;align-items:flex-start;margin:0 0 12px;padding:13px 15px;border-radius:12px;background:color-mix(in srgb,var(--aob-bad,#b3261e) 6%,var(--aob-surface,#fff));border:1px solid color-mix(in srgb,var(--aob-bad,#b3261e) 26%,transparent);animation:bbSecIn .2s ease-out;}'
		. '.bb-sec-band[hidden]{display:none;}'
		. '.bb-sec-band-icon{flex:none;width:22px;height:22px;margin-top:1px;border-radius:50%;background:var(--aob-bad,#b3261e);color:#fff;font:700 13px/22px system-ui,sans-serif;text-align:center;}'
		. '.bb-sec-band-body{min-width:0;flex:1;}'
		. '.bb-sec-band-msg{margin:0;font-size:14.5px;font-weight:600;line-height:1.4;color:var(--aob-bad,#b3261e);}'
		. '.bb-sec-band-go{display:flex;flex-wrap:wrap;align-items:center;gap:6px;margin-top:9px;font-size:13px;color:#646a73;}'
		. '.bb-sec-band-go[hidden]{display:none;}'
		. '.bb-sec-band .bb-sec-band-chip{appearance:none;margin:0;min-height:30px;padding:4px 12px;border:1px solid color-mix(in srgb,var(--aob-bad,#b3261e) 30%,transparent);border-radius:999px;background:var(--aob-surface,#fff);color:#1b1d22;font:inherit;font-size:13px;font-weight:600;line-height:1.3;text-transform:none;letter-spacing:0;cursor:pointer;box-shadow:none;transition:border-color .15s,box-shadow .15s;}'
		. '.bb-sec-band .bb-sec-band-chip::after{content:"\2193";margin-left:6px;opacity:.55;}'
		. '.bb-sec-band .bb-sec-band-chip:hover,.bb-sec-band .bb-sec-band-chip:focus-visible{border-color:var(--aob-bad,#b3261e);outline:none;box-shadow:0 0 0 3px color-mix(in srgb,var(--aob-bad,#b3261e) 14%,transparent);}'
		. '.bb-standalone-options .bb-attr-group.bb-sec-member,.bb-standalone-options .bb-attr-group.bb-sec-member.bb-gmiss,.bb-grid-woset.bb-sec-member,.bb-grid-woset.bb-sec-member.bb-gmiss{box-shadow:inset 3px 0 0 color-mix(in srgb,var(--aob-bad,#b3261e) 70%,transparent);background:var(--aob-surface,#fff);}'
		. '.bb-sec-member.bb-sec-flash{animation:bbSecFlash .9s ease-out;}'
		. '@keyframes bbSecIn{from{opacity:0;transform:translateY(-4px);}to{opacity:1;transform:none;}}'
		. '@keyframes bbSecFlash{0%{box-shadow:inset 3px 0 0 var(--aob-bad,#b3261e),0 0 0 4px color-mix(in srgb,var(--aob-bad,#b3261e) 22%,transparent);}100%{box-shadow:inset 3px 0 0 color-mix(in srgb,var(--aob-bad,#b3261e) 70%,transparent),0 0 0 0 transparent;}}'
		. '@media (prefers-reduced-motion:reduce){.bb-sec-band,.bb-sec-member.bb-sec-flash{animation:none;}}'
		. '.bb-st-line.bb-st-bad .bb-st-line-n,.bb-st-line.bb-st-bad .bb-st-free-v{color:var(--aob-bad,#b3261e);font-weight:600;}'
		// AND THE CONTROL HOLDING THE OFFENDING ANSWER SAYS SO ITSELF.
		//
		// aria-invalid was set on it and nothing was drawn: assistive tech knew,
		// and a shopper looking straight at a box holding 500 against a maximum of
		// 20 saw a box that looked exactly like every other box on the page.
		. '.bb-standalone-options .bb-gmiss .bb-addon-input[aria-invalid="true"],'
		. '.bb-standalone-options .bb-gmiss .bb-tbl-sel[aria-invalid="true"],'
		. '.bb-standalone-options .bb-gmiss .bb-tbl-typedin[aria-invalid="true"],'
		. '.bb-standalone-options .bb-gmiss select.bundle-attr-select[aria-invalid="true"]'
		. '{border-color:var(--aob-bad,#b3261e);background:color-mix(in srgb,var(--aob-bad,#b3261e) 5%,var(--aob-surface,#fff));}'
		. '.bb-standalone-options .bb-gmiss .bb-price-symbol{color:var(--aob-bad,#b3261e);}'
		. '.bb-gbody{padding-top:11px;}'
		// A conditional group stays out of sight until its trigger is picked,
		// then appears in place. No "available when" line on the front end.
		// (This is the hiding-versus-visibility round's outcome. The paragraph
		// that used to sit here still described the visible-locked design the
		// stylesheet had already stopped drawing, which is exactly how a reader
		// ends up trusting a comment over the CSS underneath it.)
		. '.bb-attr-group.bb-glocked{display:none;}'
		. '.bb-lockline{display:none;}'
		// Scope disclosure: how many decisions the page holds, so the visible
		// groups never read as "that is all there is". Green once every one
		// of them is answered.
		. '.bb-progress{font-size:12.5px;color:var(--aob-mut,#7d8590);text-align:right;padding:0 4px 9px;font-variant-numeric:tabular-nums;}'
		. '.bb-progress.bb-prog-done{color:var(--aob-good,#1a7f37);font-weight:700;}'
		. '.bb-progress[hidden]{display:none;}'
		. '.bb-mdims{display:flex;gap:10px 16px;flex-wrap:wrap;margin:8px 0 6px;}'
		. '.bb-mdims[hidden]{display:none;}'
		. '.bb-mdim{display:inline-flex;align-items:center;gap:6px;font-size:0.92em;color:var(--aob-mut,#7d8590);}'
		. '.bb-mdim input{width:96px;border:1.5px solid var(--aob-line,#e6e4df);border-radius:10px;padding:9px 11px;text-align:right;font-size:max(16px,0.92em);background:var(--aob-surface,#fff);color:var(--aob-ink,#16181d);font-variant-numeric:tabular-nums;}'
		. '.bb-mdim input:focus{border-color:var(--aob-ink,#16181d);outline:none;box-shadow:0 0 0 3px color-mix(in srgb,var(--aob-ink,#16181d) 7%,transparent);}'
		// The size echo panel: the soft ground, the money in ink, per gallery.
		. '.bb-mprice{margin:8px 0 4px;padding:8px 11px;background:var(--aob-soft,#faf9f7);border:1px solid var(--aob-line,#e6e4df);border-radius:9px;font-size:0.9em;font-variant-numeric:tabular-nums;}'
		. '.bb-mprice b{font-size:1.1em;color:var(--aob-ink,#16181d);}'
		. '.bb-mprice[hidden]{display:none;}'
		. '.bb-mprice-note{color:var(--aob-mut,#7d8590);font-size:0.88em;}'
		// How the price is made, one line per part, under the price that sums them.
		. '.bb-mlines{display:grid;gap:6px;margin-top:8px;padding-top:8px;border-top:1px solid var(--aob-line,#e6e4df);font-size:0.92em;}'
		. '.bb-mlines:empty{display:none;}'
		. '.bb-mline{display:grid;grid-template-columns:1fr auto;gap:1px 12px;align-items:baseline;}'
		. '.bb-mline-name{color:var(--aob-ink,#16181d);font-weight:600;}'
		. '.bb-mline-money{color:var(--aob-ink,#16181d);text-align:right;}'
		. '.bb-mline-how{grid-column:1/-1;color:var(--aob-mut,#7d8590);}'
		. '.bb-mline-note{margin:2px 0 0;color:var(--aob-mut,#7d8590);font-size:0.92em;line-height:1.45;}'
		. '.bb-mline-stop{margin:0;color:var(--aob-warn,#9a6700);}'
		. '.bb-mprice.is-stopped .bb-mlines{margin-top:0;padding-top:0;border-top:0;}'
		. '.bb-mchips{margin-bottom:4px;}'
		// A chip is a flex row, so the whitespace the markup puts between the
		// label and this note is dropped entirely: "A4" and "210 × 297 mm" met
		// with no gap at all, reading as one run-on word. Space between flex
		// items has to be spacing, never a space character.
		. '.bb-mdims-note{color:inherit;opacity:.7;font-size:0.82em;font-weight:400;margin-left:.5em;}'
		. '.bb-mchip .bb-chip-delta{margin-left:.5em;}'
		// A list a size's part is priced by shows that price on its choices
		// (bbMRateChips): beneath a card's name, beside a chip's. A part at one
		// rate of its own wears it the same way, beside its name on its line.
		. '.bb-chip .bb-chip-rate,.bb-mline-name .bb-chip-rate{margin-left:.5em;opacity:.75;font-size:0.85em;font-weight:400;font-variant-numeric:tabular-nums;white-space:nowrap;}'
		. '.bb-chip:has(.bb-cc-name) .bb-chip-rate{display:block;margin:2px 0 0;white-space:normal;}'
		// "+£0.67 on top" after a rate: the list's own amount said as one.
		. '.bb-chip .bb-chip-delta[data-ontop]{white-space:nowrap;}'
		. '.bb-chip .bb-chip-delta[data-ontop]::after{content:" " attr(data-ontop);font-weight:400;opacity:.75;}'
		// On the line a real space reads "Glass £41.67" aloud and on a copy,
		// so the margin only tops it up to the chip's gap.
		. '.bb-mline-name .bb-chip-rate{margin-left:.25em;}'
		. '.bb-mchip-custom{border-style:dashed;}'
		. '.bb-mchips[hidden]{display:none!important;}'
		// The receipt card: per-source lines in the muted tone, an explicit
		// Total row in the ink, everything tabular, sitting immediately
		// above the theme's own add-to-cart button (which is never
		// repainted). The card enters with a deliberate HAND-OFF (his
		// correction: the options run must visibly finish before the money
		// starts): a spacing shift, then treatment B's ledger rule drawn
		// across the card's top, 2px in the ink unless the merchant's
		// receipt-highlight colour recolours it. On narrow screens it may
		// pin to the bottom of the options flow, but only when the peek bar
		// has NOT mounted: two pinned totals stacking is worse than either
		// alone.
		. '.bb-standalone-total{display:flex;flex-direction:column;gap:2px;margin:20px 0 0;padding:16px 16px 14px;border:1px solid var(--aob-line,#e6e4df);border-top:2px solid var(--aob-receipt,var(--aob-ink,#16181d));border-radius:var(--aob-radius,15px);background:var(--aob-surface,#fff);box-shadow:0 1px 2px rgba(24,26,30,.04),0 10px 28px rgba(24,26,30,.05);font-size:1em;color:var(--aob-ink,#16181d);font-variant-numeric:tabular-nums;}'
		. '.bb-standalone-total .bb-st-lines{display:flex;flex-direction:column;gap:3px;}'
		// A free answer is what they CHOSE, not what they are paying for: it
		// names itself and leaves the money column empty, so the eye still runs
		// down one clean column of figures.
		// A charged line wears its answer the same way, so "Collection time:
		// 9:30 am   £4.00" reads as one sentence with the free lines above it.
		//
		// Scoped on the class alone, NOT under .bb-standalone-total. The separator
		// is the only thing standing between the label and the answer, and the
		// sticky peek bar shows a COPY of these lines outside that container: with
		// an ancestor in the selector every line in the bar read "Any date, no
		// rules at allThu, 10 Sept 2026". A rule that draws a word boundary has to
		// travel with the markup, wherever it is shown.
		. '.bb-st-free-v{color:var(--aob-mut,#7d8590);}'
		. '.bb-st-line{display:flex;justify-content:space-between;align-items:baseline;gap:12px;font-size:0.82em;color:var(--aob-mut,#7d8590);}'
		. '.bb-st-line-n{min-width:0;overflow-wrap:anywhere;}'
		. '.bb-st-line-a{white-space:nowrap;}'
		// The product, then each choice under it: indented and a step smaller,
		// their money in the same right-hand column as the product's.
		. '.bb-st-line.bb-st-item{font-size:0.9em;color:var(--aob-ink,#16181d);}'
		. '.bb-st-line.bb-st-choice{padding-left:12px;font-size:0.8em;}'
		. '.bb-st-line.bb-st-qans{padding-left:24px;}'
		. '.bb-st-sr{position:absolute!important;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border:0;}'
		. '.bb-st-row{display:flex;flex-wrap:wrap;justify-content:space-between;align-items:baseline;gap:0 12px;padding-top:7px;font-weight:800;}'
		// The Grand total row holds its words together: "Grand / total" broke over
		// two lines beside a struck total, and "You / save £297.20" split on a
		// phone (walk, 27 Oct 2026). The struck and the new total share one line,
		// what the break saves reads on its own line under them, and a row too
		// narrow for both wraps the sum under the words instead of breaking either.
		. '.bb-st-lab{font-size:1em;white-space:nowrap;}'
		. '.bb-st-sum{text-align:right;margin-left:auto;}'
		. '.bb-standalone-total b{font-size:1.25em;font-weight:800;}'
		. '.bb-st-total{white-space:nowrap;}'
		. '.bb-st-note{display:block;white-space:nowrap;color:var(--aob-mut,#7d8590);font-size:0.88em;text-align:right;font-weight:400;}'
		. '.bb-st-note:empty{display:none;}'
		// WHAT IS STILL OWED, where the button is.
		//
		// The count at the top of the panel scrolls away, and the bar that
		// replaces it talks only about money. A shopper who has scrolled to the
		// button has no way of knowing whether pressing it will work, short of
		// scrolling back up and reading every group. This line is the missing
		// half, and it sits last in the bar so it is the nearest thing to the
		// button it is about.
		//
		// Ink and weight, never the accent: this repeats nothing and shouts
		// nothing, it is a state, and coral belongs to things you press.
		. '.bb-standalone-total .bb-st-left{margin-top:3px;text-align:right;font-size:12.5px;font-weight:700;color:var(--aob-ink,#16181d);}'
		. '.bb-standalone-total .bb-st-left[hidden]{display:none;}'
		// An offer the basket applies (another plugin's, see bbTotalAdjust):
		// its own line in the receipt in the "done" green, the figure before
		// it struck beside the new one, and under the total either what it
		// saves or what one more would. A state, so never the accent.
		. '.bb-st-ico{width:14px;height:14px;flex:none;fill:none;stroke:currentColor;stroke-width:2;stroke-linejoin:round;margin-top:2px;}'
		. '.bb-st-line.bb-st-offer{font-size:0.9em;color:var(--aob-good,#1a7f37);font-weight:600;}'
		. '.bb-st-offer .bb-st-line-n{display:flex;gap:6px;align-items:flex-start;}'
		. '.bb-st-offer-note{display:block;font-size:0.88em;font-weight:400;color:var(--aob-mut,#7d8590);}'
		. '.bb-st-was{color:var(--aob-mut,#7d8590);font-size:0.72em;font-weight:500;margin-right:4px;}'
		. '.bb-standalone-total .bb-st-adj{display:flex;flex-direction:column;align-items:flex-end;margin-top:4px;}'
		. '.bb-standalone-total .bb-st-adj[hidden]{display:none;}'
		. '.bb-st-save{background:color-mix(in srgb,var(--aob-good,#1a7f37) 11%,#fff);color:var(--aob-good,#1a7f37);font-weight:700;font-size:0.8em;padding:3px 10px;border-radius:999px;}'
		. '.bb-st-nudge{align-self:stretch;display:flex;gap:8px;align-items:flex-start;font-size:0.82em;color:var(--aob-ink,#16181d);background:color-mix(in srgb,var(--aob-good,#1a7f37) 6%,#fff);border:1px dashed color-mix(in srgb,var(--aob-good,#1a7f37) 45%,#fff);border-radius:8px;padding:8px 10px;}'
		. '.bb-st-nudge .bb-st-ico{color:var(--aob-good,#1a7f37);}'
		. '.bb-standalone-total .bb-st-nudge b{font-weight:700;font-size:inherit;}'
		. '.bb-standalone-total[hidden]{display:none;}'
		. '@media (max-width:782px){.bb-standalone-total:not(.bb-has-peek){position:sticky;bottom:10px;z-index:5;}}'
		// The standalone peek bar reuses the bundle bar's shell; only the CTA
		// needs its own paint (filled, never outline: themes force text
		// white). It stands in for the theme's own add button, so it wears
		// the ink/surface pair: readable by construction on any theme, where
		// an accent fill went white-on-highlighter the moment a theme's
		// palette lent us something pale.
		. '.bb-st-peek .bb-peek-cta{background:var(--aob-ink,#16181d);color:var(--aob-surface,#fff);border:0;border-radius:10px;padding:11px 18px;min-height:44px;font-weight:700;font-size:0.95em;cursor:pointer;box-shadow:0 4px 12px -8px var(--aob-ink,#16181d);}'
		. '.bb-st-peek .bb-peek-cta:hover{filter:brightness(0.95);}'
		// A grid disables its own Add button until the order is complete, and
		// the bar's stand-in follows it. It has to LOOK unwilling too, or the
		// shopper taps a button that looks ready and nothing happens.
		// Its words stay readable while it waits: dark grey on pale grey,
		// 6.2:1 (white on #c4cad4 was 1.6:1, tester round 4).
		. '.bb-st-peek .bb-peek-cta[disabled]{background:#e6e8ec;color:#4b5563;box-shadow:none;cursor:not-allowed;}'
		. '.bb-st-peek .bb-peek-cta[disabled]:hover{filter:none;}'
		// The owed line rides the phone bar too, under the figure, in the shape
		// the bundle tray's own second line already uses. The figure becomes a
		// two-line stack so the chevron stays beside both rather than beside the
		// money alone.
		. '.bb-st-peek .bb-peek-stack{display:flex;flex-direction:column;align-items:flex-start;gap:1px;min-width:0;}'
		. '.bb-st-peek .bb-peek-left{font-size:0.78em;font-weight:600;line-height:1.2;color:var(--aob-ink,#16181d);}'
		// The figure before an offer, struck, keeps its size in the bar (the
		// copy leaves the grid's large figure style behind).
		. '.bb-st-peek .bb-peek-info .bb-st-was,.bb-st-peek .bb-peek-info .bb-grid-was{font-size:0.82em;margin-right:6px;}'
		. '.bb-st-peek .bb-peek-left[hidden]{display:none;}'
		// THE MISSING-CHOICES SHEET. Phone furniture, so it is built like phone
		// furniture: a grab bar the thumb reads as draggable, a heading that
		// says how much is left, the real groups, and the money beside the
		// button at the bottom where the thumb already is.
		. '.bb-sheet-scrim{position:fixed;inset:0;background:rgba(24,26,30,.45);z-index:99990;}'
		// margin:0 overrides the panel's own bottom margin, which the sheet
		// inherits along with the panel's name.
		. '.bb-sheet{position:fixed;left:0;right:0;bottom:0;z-index:99991;box-sizing:border-box;margin:0;'
			. 'background:var(--aob-surface,#fff);color:var(--aob-ink,#16181d);'
			. 'border-radius:18px 18px 0 0;box-shadow:0 -10px 34px rgba(24,26,30,.2);'
			// The safe-area inset keeps the button clear of a phone's home bar.
			. 'padding:10px 16px calc(16px + env(safe-area-inset-bottom,0px));max-height:82vh;overflow:auto;}'
		. '.bb-sheet-grab{width:40px;height:4px;border-radius:4px;background:var(--aob-line,#e6e4df);margin:0 auto 14px;}'
		. '.bb-sheet-h{display:flex;justify-content:space-between;align-items:baseline;gap:12px;margin:0 2px 4px;}'
		. '.bb-sheet-h b{font-size:19px;font-weight:800;}'
		. '.bb-sheet-x{background:none;border:0;padding:6px;font:inherit;font-size:15px;color:inherit;cursor:pointer;text-decoration:underline;text-underline-offset:3px;}'
		. '.bb-sheet-sub{font-size:14px;color:var(--aob-mut,#7d8590);margin:0 2px 14px;}'
		. '.bb-sheet-body .bb-attr-group{margin:0 0 12px;}'
		. '.bb-sheet .bb-sheet-quiet .bb-gmiss-note{display:none;}'
		. '.bb-sheet-foot{display:flex;align-items:center;gap:14px;border-top:1px solid var(--aob-line,#e6e4df);padding-top:14px;margin-top:6px;}'
		. '.bb-sheet-total{font-size:21px;font-weight:800;font-variant-numeric:tabular-nums;}'
		// The same ink/surface pair the peek bar's button wears, for the same
		// reason: readable by construction on any theme.
		. '.bb-sheet-cta{flex:1;background:var(--aob-ink,#16181d);color:var(--aob-surface,#fff);border:0;border-radius:10px;padding:15px;min-height:44px;font-weight:700;font-size:16px;cursor:pointer;}'
		. '.bb-sheet-cta[disabled]{background:#e6e8ec;color:#4b5563;cursor:not-allowed;}'
		// A sheet is a phone shape. On a wide screen the page IS the sheet, and
		// the script never opens one, but the rule stands as the second lock.
		. '@media (min-width:783px){.bb-sheet,.bb-sheet-scrim{display:none;}}'
		// ── KEYBOARD FOCUS, HELD AGAINST THE THEME ──────────────────────────
		//
		// Measured on a stock Astra shop with WooCommerce: the theme ships
		// blanket form rules that outrank every focus style above.
		//
		//   input:focus{border-style:dotted;border-width:thin}   takes the border
		//   .woocommerce input[type=text]:focus{box-shadow:none} deletes the ring
		//   .woocommerce-js input[type=text]:focus{outline-style:unset}  and the outline
		//
		// The result was a panel where NOT ONE text control showed where the
		// keyboard was, and where a refused answer read WEAKER while it was
		// being corrected than while it was being ignored: solid red at rest,
		// a dotted hairline the moment it had focus.
		//
		// Our rules were one step short on specificity, so this block wins it
		// outright and restates border-style and border-width, which a focus
		// rule that sets only a colour leaves for any theme to claim. The
		// class is repeated to buy that step without naming an ancestor the
		// sheet may have re-parented away.
		. '.bb-standalone-options input.bb-addon-input.bb-addon-input:focus,'
		. '.bb-standalone-options select.bb-addon-input.bb-addon-input:focus,'
		. '.bb-standalone-options textarea.bb-addon-input.bb-addon-input:focus,'
		. '.bb-standalone-options input.bb-tbl-typedin.bb-tbl-typedin:focus,'
		. '.bb-standalone-options select.bb-tbl-sel.bb-tbl-sel:focus,'
		. '.bb-standalone-options .bb-mdim.bb-mdim input:focus'
		. '{border-style:solid;border-width:1.5px;border-color:var(--aob-ink,#16181d);outline:none;box-shadow:0 0 0 3px color-mix(in srgb,var(--aob-ink,#16181d) 7%,transparent);}'
		// A measured size's box is the control and wears the focus ring; the
		// figure inside it wears none, or the box showed two borders, one
		// inside the other (fresh tester, 18 Oct 2026).
		. '.bb-standalone-options .bb-mdim-box.bb-mdim-box input:focus{border:0;outline:none;box-shadow:none;}'
		// An answer the page has refused keeps its own colour while it is being
		// corrected. Focus may not withdraw the one mark saying which box is
		// the problem, so this sits above the block that turns a border to ink.
		. '.bb-standalone-options .bb-gmiss input[aria-invalid="true"][aria-invalid="true"]:focus,'
		. '.bb-standalone-options .bb-gmiss select[aria-invalid="true"][aria-invalid="true"]:focus,'
		. '.bb-standalone-options .bb-gmiss textarea[aria-invalid="true"][aria-invalid="true"]:focus'
		. '{border-color:var(--aob-bad,#b3261e);box-shadow:0 0 0 3px color-mix(in srgb,var(--aob-bad,#b3261e) 12%,transparent);}'
		// Two controls where the thing a shopper looks at is not the thing that
		// takes focus: an upload button is a label wrapped around a 1px input,
		// and a tickbox is the browser's own. Both draw on what is visible.
		. '.bb-standalone-options .bb-addon-file-btn:focus-within{outline:2px solid var(--aob-ink,#16181d);outline-offset:2px;}'
		. '.bb-standalone-options .bb-addon-check.bb-addon-check input:focus-visible{outline:2px solid var(--aob-ink,#16181d);outline-offset:2px;}'
	);
	// The merchant's Colours choices land LAST, as their own block, so they
	// override the neutral defaults and the theme inherit alike.
	$bb_colour_css = addon_boss_colour_override_css();
	if ( '' !== $bb_colour_css ) {
		wp_add_inline_style( 'addon-boss-options-front', $bb_colour_css );
	}
	// The boot rides the script loader, NEVER inline hook output: block
	// themes pass that output through content filters that entity-encode
	// ampersands (&& arrived as &#038;&#038; on Twenty Twenty-Five and the
	// whole script died on a syntax error). Loader-printed footer scripts
	// bypass content filtering entirely; the handle dedupes the once-only.
	addon_boss_enqueue_standalone_boot();
}

/**
 * The engine's boot script, from whichever surface asks first.
 *
 * The boot rode the standalone options renderer alone, and the grid takeover
 * removes that renderer because the grid IS the picker. That left every grid
 * page rendering image-swap attributes no script was listening for: the tick
 * did nothing on exactly the layout built around the photographs, while the
 * tiles dutifully announced picks into an empty room. The grid's asset path
 * now asks for the same boot.
 *
 * The guard keeps it one printing when a page ever hosts both surfaces:
 * wp_enqueue_script dedupes on the handle, but wp_add_inline_script APPENDS,
 * and a second copy of the boot would double-bind every engine listener.
 */
function addon_boss_enqueue_standalone_boot(): void {
	static $bb_done = false;
	if ( $bb_done ) {
		return;
	}
	$bb_done = true;
	wp_register_script( 'addon-boss-standalone', false, array(), ADDON_BOSS_VERSION, true );
	wp_enqueue_script( 'addon-boss-standalone' );
	// One handle, one order: the engine's own driver first, then whatever each
	// module appends on the filter, so a module's script can lean on the
	// conventions the driver establishes (the live-charge and echo data
	// attributes, and the bb-pick-change / bb-group-clear / bb-live-change
	// events) without sharing a scope with it.
	wp_add_inline_script( 'addon-boss-standalone', (string) apply_filters( 'addon_boss_standalone_boot_js', addon_boss_standalone_boot_js() ) );
}

add_action( 'woocommerce_before_add_to_cart_button', 'addon_boss_render_standalone_options' );

/**
 * D6: how many choices a chip row carries before the set switches to the
 * list control. Past this, chips sprawl into a wall; the native select
 * scans, searches (type-ahead) and fits a phone. Display only, and the
 * merchant can pin the chips per set.
 */
const ADDON_BOSS_CHIP_LIST_THRESHOLD = 12;

/**
 * The swatch shape a choices set renders with (D1, display only).
 *
 * An explicit merchant choice always wins. Absent means square, except that
 * a set whose options carry photos prefers the photo card by itself: a
 * merchant who mapped photos onto choices meant them to be seen.
 *
 * @param array $set A resolved (or stored) set.
 * @return string 'square', 'circle' or 'card'.
 */
function addon_boss_option_set_shape( array $set ): string {
	$explicit = (string) ( $set['shape'] ?? '' );
	if ( in_array( $explicit, array( 'square', 'circle', 'card' ), true ) ) {
		return $explicit;
	}
	foreach ( (array) ( $set['options'] ?? array() ) as $bb_o ) {
		if ( ! empty( $bb_o['image_id'] ) ) {
			return 'card';
		}
	}
	return 'square';
}

/**
 * The shape a set is DRAWN in for a shopper. The same as the set's own
 * shape, except that a set set to Photo card with no photo on any choice
 * draws as plain swatches, as its editor tells the merchant it will: it drew
 * a row of empty grey frames instead. The editor keeps reading
 * addon_boss_option_set_shape(), so the merchant's choice stays on show.
 *
 * @param array $set A resolved option set.
 */
function addon_boss_option_set_drawn_shape( array $set ): string {
	$shape = addon_boss_option_set_shape( $set );
	if ( 'card' !== $shape ) {
		return $shape;
	}
	foreach ( (array) ( $set['options'] ?? array() ) as $bb_o ) {
		if ( ! empty( $bb_o['image_id'] ) ) {
			return 'card';
		}
	}
	return 'square';
}

/**
 * Whether a label already says "optional" in its own words. Such a label is
 * its own marking, and the "(optional)" suffix beside it would read as a
 * stutter: "Optional extras (optional)". The comparison uses the same
 * translated word the suffix prints, so it follows the store's language.
 */
function addon_boss_label_says_optional( string $label ): bool {
	$word = trim( __( '(optional)', 'addon-boss' ), '() ' );
	return '' !== $word && false !== mb_stripos( $label, $word );
}

/**
 * The "(optional)" marker for a label, or '' when the label already carries
 * the word itself. The one source of truth for the suffix: field labels, set
 * headers and fold summaries all mark themselves through here.
 *
 * @param string $label The label being marked.
 * @param string $class The class the marker wears where it renders.
 */
function addon_boss_optional_marker( string $label, string $class = 'bb-gopt' ): string {
	if ( addon_boss_label_says_optional( $label ) ) {
		return '';
	}
	return ' <span class="' . esc_attr( $class ) . '">' . esc_html__( '(optional)', 'addon-boss' ) . '</span>';
}

/**
 * Whether a group's name and its only member's name are near-duplicates
 * ("How it is finished" holding "Finish"), so stacking both headings would
 * say the same thing twice. Case-insensitive containment either way round;
 * the shorter name must have some substance (three characters), so a trivial
 * fragment can never collapse an unrelated pair.
 */
function addon_boss_labels_near_duplicate( string $a, string $b ): bool {
	$a = trim( $a );
	$b = trim( $b );
	if ( '' === $a || '' === $b ) {
		return false;
	}
	$needle = mb_strlen( $a ) <= mb_strlen( $b ) ? $a : $b;
	$stack  = ( $needle === $a ) ? $b : $a;
	return mb_strlen( $needle ) >= 3 && false !== mb_stripos( $stack, $needle );
}

/**
 * A group's header row: the name on the left, the live echo on the right.
 * The heading marks the STATE in the same grammar the field labels wear:
 * the platform's word "Required" (drawn by the skin as the accent-soft
 * pill) or "(optional)", unless the name already says so in its own words.
 * The echo stays the VALUE half of the marking: "Choose" in the accent
 * while an answer is owed, the pick and its money once given, "None" for
 * an optional group left alone, and NOTHING while a conditional group
 * waits for its trigger (the greyed body plus its availability line carry
 * that state; the research is clear that a status word like "Locked" is
 * mechanism language a shopper should not have to read). A plain row, not
 * a control: every group stays open, so there is nothing to toggle.
 */
function addon_boss_standalone_group_head( string $name, bool $required ): string {
	return '<div class="bb-ghead">'
		. '<span class="bb-attr-name">' . esc_html( $name )
		. ( $required ? ' <span class="bb-addon-req">' . esc_html__( 'Required', 'addon-boss' ) . '</span>' : addon_boss_optional_marker( $name ) )
		. '</span>'
		. '<span class="bb-gecho" data-choose="' . esc_attr__( 'Choose', 'addon-boss' ) . '" data-none="' . esc_attr__( 'None', 'addon-boss' ) . '"'
		/* translators: %s: how many choices the shopper has picked in this set */
		. ' data-chosen="' . esc_attr__( '%s chosen', 'addon-boss' ) . '"></span>'
		. '</div>';
}

/**
 * The tags and attributes wp_kses() is allowed to keep in the option-set and
 * field markup this engine prints. One shared allowlist for every sink on this
 * surface: the structural elements, the form controls with their own
 * attributes, links and images, and the global class, id, style, data and aria set.
 * Every value is still escaped at its sink (esc_attr/esc_html); this is the
 * outer gate that proves it to a reader, and to Plugin Check, at the echo.
 */
function addon_boss_kses_allowed(): array {
	$global = array(
		'class'            => true,
		'id'               => true,
		'style'            => true,
		'title'            => true,
		'role'             => true,
		'hidden'           => true,
		'tabindex'         => true,
		'data-*'           => true,
		'aria-label'       => true,
		'aria-hidden'      => true,
		'aria-live'        => true,
		'aria-pressed'     => true,
		'aria-checked'     => true,
		// A sold-out choice carries both `disabled` and `aria-disabled`. The
		// first is allowed on form elements below; without this one kses would
		// strip the second silently, so the chip would look and behave disabled
		// while telling a screen reader nothing at all.
		'aria-disabled'    => true,
		'aria-expanded'    => true,
		'aria-describedby' => true,
		'aria-required'    => true,
		'aria-labelledby'  => true,
	);
	$form   = array_merge(
		$global,
		array(
			'type'         => true,
			'name'         => true,
			'value'        => true,
			'checked'      => true,
			'selected'     => true,
			'disabled'     => true,
			'required'     => true,
			'placeholder'  => true,
			'min'          => true,
			'max'          => true,
			'step'         => true,
			'maxlength'    => true,
			'minlength'    => true,
			'pattern'      => true,
			'accept'       => true,
			'multiple'     => true,
			'readonly'     => true,
			'inputmode'    => true,
			'autocomplete' => true,
			'size'         => true,
			'rows'         => true,
			'cols'         => true,
			'for'          => true,
			'form'         => true,
		)
	);
	return array(
		'div'      => $global,
		'span'     => $global,
		'p'        => $global,
		'section'  => $global,
		'fieldset' => $global,
		'legend'   => $global,
		'ul'       => $global,
		'ol'       => $global,
		'li'       => $global,
		'strong'   => $global,
		'em'       => $global,
		'b'        => $global,
		'i'        => $global,
		'small'    => $global,
		'code'     => $global,
		'br'       => $global,
		'hr'       => $global,
		'abbr'     => $global,
		'h2'       => $global,
		'h3'       => $global,
		'h4'       => $global,
		'label'    => $form,
		'input'    => $form,
		'select'   => $form,
		'option'   => $form,
		'optgroup' => $form,
		'textarea' => $form,
		'button'   => $form,
		'a'        => array_merge(
			$global,
			array(
				'href'   => true,
				'target' => true,
				'rel'    => true,
			)
		),
		'img'      => array_merge(
			$global,
			array(
				'src'     => true,
				'alt'     => true,
				'width'   => true,
				'height'  => true,
				'loading' => true,
				'srcset'  => true,
				'sizes'   => true,
			)
		),
		'table'    => $global,
		'thead'    => $global,
		'tbody'    => $global,
		'tfoot'    => $global,
		'tr'       => $global,
		'th'       => array_merge(
			$global,
			array(
				'scope'   => true,
				'colspan' => true,
				'rowspan' => true,
			)
		),
		'td'       => array_merge(
			$global,
			array(
				'colspan' => true,
				'rowspan' => true,
			)
		),
	);
}

/**
 * The pieces a group wears when it carries a reveal rule: the data attributes
 * the reveal script reads, the locked-or-revealed class, and the availability
 * line stating the condition in the customer's words. All three come from the
 * module that evaluates such rules; with nothing registered a rule was
 * already wiped on read, and a group wears none of them.
 *
 * @param array $when   The stored rule.
 * @param bool  $active Whether the group is currently active.
 * @param array $sets   The resolved sets (for the trigger's name and option).
 * @return array{attrs:string,class:string,lock:string}
 */
function addon_boss_standalone_reveal_bits( array $when, bool $active, array $sets ): array {
	$bits = array(
		'attrs' => '',
		'class' => '',
		'lock'  => '',
	);
	if ( ! $when ) {
		return $bits;
	}
	return (array) apply_filters( 'addon_boss_reveal_group_bits', $bits, $when, $active, $sets );
}

/**
 * A field snapshot's frozen style as a display suffix, or '' when the field
 * carries none. Rides the same rows the charge suffix does, so the cart line
 * and the order line both read "Maria (Script, #d4af37) (+5.00)".
 */
function addon_boss_standalone_field_style_suffix( array $fsnap ): string {
	$style = trim( (string) ( $fsnap['style'] ?? '' ) );
	return '' !== $style ? ' (' . $style . ')' : '';
}

/**
 * One product-FIELD group on the standalone product page. Reuses the shared
 * personalisation field renderer verbatim; the field posts inside the native
 * add-to-cart form as bb_pf[<key>], and its data-bb-fee feeds the live total.
 * Wrapped in a .bb-attr-group so it flows with the option-set groups (and, in
 * Phase 2, can carry the same reveal rule the sets do).
 */
function addon_boss_render_standalone_field( $product, array $field, array $when = array(), array $sets = array(), bool $active = true ): void {
	if ( ! function_exists( 'addon_boss_personalisation_render_field' ) || empty( $field['type'] ) || empty( $field['key'] ) ) {
		return;
	}
	// A field for the admin's eyes only (a hidden merchant note) draws NO card:
	// an empty white shell on the product page is exactly the shelf-of-nothing
	// this page must never show. The bare renderer still runs, so a
	// fill-from-link input can land in the form when that switch is on.
	$bb_all_types = addon_boss_personalisation_field_types();
	if ( ! empty( $bb_all_types[ (string) $field['type'] ]['admin_only'] ) ) {
		addon_boss_personalisation_render_field( $field, 'bb_pf[' . $field['key'] . ']', null, 'block', $product );
		return;
	}
	// Prefill on a failed add re-render so the shopper never loses what they
	// typed. Display only, on the storefront where WooCommerce's add-to-cart
	// carries no nonce; the submitted value is re-resolved and re-validated
	// server-side at add-to-cart, and every render path escapes at output.
	$posted = null;
	// phpcs:ignore WordPress.Security.NonceVerification.Recommended
	if ( isset( $_REQUEST['bb_pf'][ $field['key'] ] ) ) {
		// phpcs:ignore WordPress.Security.NonceVerification.Recommended
		$posted = map_deep( wp_unslash( $_REQUEST['bb_pf'][ $field['key'] ] ), 'sanitize_textarea_field' );
	}
	// Extra group attributes (a placement's settings for the module that
	// draws on the product photo) ride this seam, escaped by the module that
	// builds them; with nothing registered a group carries none.
	$bb_extra_attrs = (string) apply_filters( 'addon_boss_field_group_extra_attrs', '', $field, $product );

	// The same reveal rule the sets carry: a field shown "only when" a set is
	// picked renders VISIBLE and LOCKED until then (never hidden), reads its
	// trigger off the same select, carries a plain availability line, and its
	// fee drops out of the live total while locked. The reveal module's script
	// keeps it in step with the picks client-side, mirroring the server.
	$bb_reveal   = addon_boss_standalone_reveal_bits( $when, $active, $sets );
	$when_attrs  = $bb_reveal['attrs'];
	// The group states its field kind (bb-fk-text, bb-fk-number, ...) so the
	// stylesheet can lay kinds out by nature: two short fields standing next
	// to each other pair onto one row where the wrapper is wide enough (D5),
	// with no admin control and no script. Which kinds pair is entirely the
	// stylesheet's decision; the markup just stops hiding what each group is.
	$group_class = 'bundle-item-attribute bb-attr-group bb-field-group bb-fk-' . sanitize_html_class( (string) $field['type'] ) . $bb_reveal['class'];
	// Which variations this field is for, carried onto the group so the page
	// scripts can mirror the server's inertness rule: a field restricted to
	// other variations must not gate the add, count in the progress line or
	// price into the live total while a variation it does not apply to is the
	// one being bought. The server has always stood such a field down; the
	// page just had no way to know.
	$bb_vars_attr = '';
	if ( ! empty( $field['only_variations'] ) ) {
		$bb_vars_attr = ' data-bb-vars="' . esc_attr( implode( ',', array_map( 'absint', (array) $field['only_variations'] ) ) ) . '"';
	}
	$when_attrs .= $bb_vars_attr;
	// A type whose group carries its own wiring (an upload field's endpoint
	// attributes) rides the callback its module registered.
	$bb_ftypes    = addon_boss_personalisation_field_types();
	$upload_attrs = is_callable( $bb_ftypes[ (string) $field['type'] ]['group_attrs'] ?? null )
		? (string) call_user_func( $bb_ftypes[ (string) $field['type'] ]['group_attrs'], $field, $product )
		: '';
	// The words a blocked add says at this field, in the field's own label
	// (gauntlet P1); the sets' twin above explains the pattern. Only a
	// required field can block, so only a required field carries them.
	$bb_miss_attr = '';
	if ( ! empty( $field['required'] ) ) {
		/* translators: %s: the field's own label, e.g. "Engraving" */
		$bb_miss_attr = ' data-bb-miss="' . esc_attr( sprintf( __( 'Fill in %s first.', 'addon-boss' ), (string) ( $field['label'] ?? '' ) ) ) . '"';
	}
	echo wp_kses( '<div class="' . esc_attr( $group_class ) . '" data-req="' . ( ! empty( $field['required'] ) ? '1' : '0' ) . '"' . $when_attrs . $upload_attrs . $bb_extra_attrs . $bb_miss_attr . '>', addon_boss_kses_allowed() );
	// A FIELD THAT CAN BLOCK NEEDS SOMEWHERE TO SAY WHY.
	//
	// This note used to belong to required fields alone, because only a required
	// field could hold up the basket. A name-your-price box with a minimum or a
	// maximum can hold it up too, optional or not, and without this line it did
	// so in silence: the field went red and said nothing. Closing a limit
	// changes three things, and this is the third.
	if ( '' !== $bb_miss_attr || isset( $field['price_min'] ) || isset( $field['price_max'] ) ) {
		echo '<p class="bb-gmiss-note" role="status" aria-live="polite" hidden></p>';
	}
	if ( '' !== $bb_reveal['lock'] ) {
		echo '<div class="bb-lockline">' . esc_html( $bb_reveal['lock'] ) . '</div>';
	}
	// A mode that displays as something other than its stored self (a percent
	// charge resolves to its actual money, off the same base the server prices
	// from) is adjusted by the module that owns the mode, so the shopper reads
	// "+£3.00" rather than a percentage they have to do arithmetic on and the
	// live total needs no maths of its own. The server recomputes the exact
	// charge at add-to-cart, so what is shown is what is charged.
	$render_field = (array) apply_filters( 'addon_boss_render_field_def', $field, $product );
	echo '<div class="bb-gwrap"><div class="bb-gbody">';
	// A field the merchant set to repeat asks several times, through the
	// module that owns repeats: it answers true when it drew the cards. Every
	// other field renders exactly the single input it always has.
	if ( ! (bool) apply_filters( 'addon_boss_render_repeat_field', false, $render_field, $posted ) ) {
		echo wp_kses( (string) addon_boss_personalisation_render_field( $render_field, 'bb_pf[' . $field['key'] . ']', $posted, 'block', $product ), addon_boss_kses_allowed() );
	}
	// Whatever a module offers inside this group beyond the input itself (the
	// typeface and colour chips of a placement field) renders here, through
	// the module's own listener; a build without one prints nothing.
	do_action( 'addon_boss_standalone_field_extra', $field, $product );
	echo '</div></div>';
	echo '</div>';
}

/**
 * Whether anything on the product BESIDES its option sets can move the price:
 * a field that charges (a fee, a priced choice, the shopper's own amount, a
 * rush date or time) or a print position with a fee. A whole-price chip is
 * only true where its list is the one thing that moves the price, so one of
 * these turns the chips to what they add.
 *
 * @param WC_Product $product The product being rendered.
 * @return bool
 */
function addon_boss_product_has_priced_extras( $product ): bool {
	if ( ! $product instanceof WC_Product ) {
		return false;
	}
	foreach ( addon_boss_standalone_product_fields( $product ) as $bb_def ) {
		if ( (float) ( $bb_def['fee'] ?? 0 ) > 0 || (float) ( $bb_def['custom_fee'] ?? 0 ) > 0
			|| 'price' === ( $bb_def['type'] ?? '' ) || ! empty( $bb_def['date_bands'] ) || ! empty( $bb_def['time_bands'] ) ) {
			return true;
		}
		foreach ( (array) ( $bb_def['options'] ?? array() ) as $bb_fo ) {
			if ( is_array( $bb_fo ) && 0.0 !== (float) ( $bb_fo['fee'] ?? 0 ) ) {
				return true;
			}
		}
	}
	if ( function_exists( 'addon_boss_product_positions' ) ) {
		foreach ( (array) addon_boss_product_positions( $product ) as $bb_pos ) {
			if ( ! is_array( $bb_pos ) ) {
				continue;
			}
			if ( (float) ( $bb_pos['fee'] ?? 0 ) > 0 ) {
				return true;
			}
			foreach ( (array) ( $bb_pos['methods'] ?? array() ) as $bb_pm ) {
				if ( is_array( $bb_pm ) && (float) ( $bb_pm['fee'] ?? 0 ) > 0 ) {
					return true;
				}
			}
		}
	}
	return false;
}

/**
 * A choice's badge in the "what it adds" voice: its own price with any flat
 * table adjustment it triggers folded in ("+£14.00"), then a percentage it
 * triggers ("+15%"), then a once-per-line amount ("+£15.00 (once)"). Empty
 * when the choice adds nothing. The percentage is printed as a percentage:
 * it is taken from the size the shopper picks, so before a size there is no
 * money to quote. Once a size is priced the table's script says it as money
 * (bbTblAdjBadges), the same figure as the receipt line.
 *
 * @param WC_Product $product The product, for the display basis.
 * @param float      $delta   The choice's own price (entry basis).
 * @param array      $adj     The adjustment sums: amt and once (entry basis), pct.
 * @return string Badge HTML, escaped.
 */
function addon_boss_choice_badge_html( $product, float $delta, array $adj ): string {
	$bb_parts = array();
	$bb_flat  = addon_boss_round_money( $delta + (float) ( $adj['amt'] ?? 0 ) );
	if ( 0.0 !== $bb_flat ) {
		$bb_parts[] = addon_boss_money( $bb_flat, $product, array( 'sign' => true ) );
	}
	$bb_tail = addon_boss_choice_badge_tail( $product, $adj );
	if ( '' !== $bb_tail ) {
		$bb_parts[] = $bb_tail;
	}
	return implode( ' ', $bb_parts );
}

/**
 * The words after a choice's money that a table adjustment adds: the
 * percentage ("+15%") and a once-per-line amount ("+£15.00 (once)").
 *
 * @param WC_Product $product The product, for the display basis.
 * @param array      $adj     The adjustment sums: once (entry basis) and pct.
 * @return string Escaped HTML, or ''.
 */
function addon_boss_choice_badge_tail( $product, array $adj ): string {
	$bb_parts = array();
	$bb_pct   = (float) ( $adj['pct'] ?? 0 );
	if ( 0.0 !== $bb_pct ) {
		$bb_parts[] = esc_html(
			sprintf(
				/* translators: 1: a plus or minus sign, 2: a percentage number. Reads "+15%". */
				__( '%1$s%2$s%%', 'addon-boss' ),
				$bb_pct > 0 ? '+' : '-',
				rtrim( rtrim( number_format( abs( $bb_pct ), 2 ), '0' ), '.' )
			)
		);
	}
	$bb_once = addon_boss_round_money( (float) ( $adj['once'] ?? 0 ) );
	if ( 0.0 !== $bb_once ) {
		/* translators: %s: the adjustment amount, e.g. "+15.00" */
		$bb_parts[] = sprintf( __( '%s (once)', 'addon-boss' ), addon_boss_money( $bb_once, $product, array( 'sign' => true ) ) );
	}
	return implode( ' ', $bb_parts );
}

/**
 * The adjustment a choice triggers, as data for a script that repaints the
 * badge (the VAT switch): the flat money in the display basis, which joins
 * the choice's own figure, and the words that follow it. Escaped, with a
 * leading space.
 *
 * @param WC_Product $product The product, for the display basis.
 * @param array      $adj     The adjustment sums: amt and once (entry basis), pct.
 * @return string
 */
function addon_boss_choice_adj_attrs( $product, array $adj ): string {
	return ' data-bb-adj-amt="' . esc_attr( (string) addon_boss_delta_to_display( $product, (float) ( $adj['amt'] ?? 0 ) ) ) . '"'
		. ' data-bb-adj-tail="' . esc_attr( trim( wp_strip_all_tags( addon_boss_choice_badge_tail( $product, $adj ) ) ) ) . '"';
}

function addon_boss_render_standalone_options(): void {
	global $product;
	if ( ! $product instanceof WC_Product || ! $product->is_purchasable() ) {
		return;
	}
	$sets = addon_boss_standalone_option_sets( $product );
	if ( ! $sets && ! addon_boss_standalone_product_fields( $product ) && ! apply_filters( 'addon_boss_standalone_has_extra', false, $product ) ) {
		return; // nothing to show: no sets, no fill-in fields, and no module with something of its own.
	}
	// Whose money this panel is about to print, said once, so a field type whose
	// render callback has no product in its shape still converts what it shows.
	// Restored at the end of the panel, so a second product later in the request
	// (a shop loop, a related-products row) can never inherit this one's basis.
	$bb_money_was = addon_boss_money_product( $product );
	// Prefill picks first (a failed add re-renders in the same request, and an
	// edit arrival seeds the line's picks), then the activity map, so a
	// conditional set arrives hidden or revealed in the same state the server
	// will enforce. A several-of set's entry is its array of keys; a pick-one
	// set's stays the string it always was.
	// Cleaned HERE, at the boundary, rather than trusting the helpers to do it
	// out of sight. Both are also called with an already-collected $source
	// array, so the boundary is the caller's job at every one of their sites
	// and only these two read the request directly.
	$prefill = array();
	foreach ( $sets as $set ) {
		$field = addon_boss_standalone_field_name( $set['id'] );
		// phpcs:ignore WordPress.Security.NonceVerification.Recommended -- display prefill only; picks are validated against the stored set on submit.
		$bb_raw = isset( $_REQUEST[ $field ] ) ? map_deep( wp_unslash( $_REQUEST[ $field ] ), 'sanitize_text_field' ) : '';
		$bb_pp  = addon_boss_standalone_posted_picks( $set, $bb_raw );
		$prefill[ $set['id'] ] = ! empty( $set['multi'] ) ? $bb_pp : (string) ( $bb_pp[0] ?? '' );
	}
	$active = addon_boss_active_option_sets( $sets, $prefill );
	// Fields join the rule state, so the first paint already agrees with what
	// the server will enforce for a rule triggered by a tick box.
	// sanitize_textarea_field, not its one-line sibling: a message field's
	// newlines are part of the answer, and stripping them here would make the
	// first paint disagree with the value the box is about to show.
	// phpcs:ignore WordPress.Security.NonceVerification.Recommended -- display prefill only; every answer is re-read and validated on submit.
	$bb_pf = isset( $_REQUEST['bb_pf'] ) ? map_deep( wp_unslash( $_REQUEST['bb_pf'] ), 'sanitize_textarea_field' ) : null;
	addon_boss_add_field_rule_state( addon_boss_standalone_product_fields( $product ), $bb_pf, $prefill, $active );

	// The panel owns every group. A scope line announces how many decisions
	// exist so the visible groups never read as the whole story (the
	// illusion-of-completeness risk the visibility research named). Answered
	// groups refine in place; conditional groups render VISIBLE-LOCKED, never
	// hidden, so a dependent choice is always discoverable.

	// The pairs, for the chips. A product that counts per combination hands
	// its whole table to the page, so picking a colour can grey the sizes that
	// colour has none of, at the moment of the pick rather than at the button.
	// An attribute rather than a script tag: a block theme's summary region
	// content-filters what it finds there, and an inline script has already
	// been mangled into a syntax error once.
	$bb_pairs      = function_exists( 'addon_boss_combo_stock_all' ) ? addon_boss_combo_stock_all( $product ) : array();
	$bb_pairs_attr = '';
	if ( $bb_pairs ) {
		$bb_pairs_attr = ' data-bb-pairs="' . esc_attr( (string) wp_json_encode( array( 'sets' => addon_boss_combo_sets( $product ), 'q' => $bb_pairs ) ) ) . '"';
	}
	// Whether the pairs also carry PRICES is the price module's own business
	// (Pro): it prints its map through the options-extra hook below, in the
	// same wire shape the counts travel in.
	// The sheet is a SETTING, off unless the shop asked for it, and the page
	// only ever reads this flag: no build learns the option's name twice.
	$bb_sheet_on = '1' === (string) get_option( 'addon_boss_missing_sheet', '0' );
	// The layout and the two switches, so the page can dress the cards the way
	// the merchant asked without a second round trip or a second source of
	// truth about what is on.
	// A fresh count of the disclosures, so "first one open" means the first
	// one on THIS panel and not on whichever one rendered before it.
	addon_boss_options_fold_seq( true );
	addon_boss_options_rendering_product( $product );
	echo '<div class="bb-standalone-options" data-bb-layout="' . esc_attr( addon_boss_options_layout( $product ) ) . '"'
		. ( addon_boss_options_numbered( $product ) ? ' data-bb-numbered="1"' : '' )
		. ( addon_boss_options_photo_in_view( $product ) ? ' data-bb-photoview="1"' : '' )
		. ( $bb_sheet_on ? ' data-bb-sheet="1"' : '' ) . wp_kses_data( $bb_pairs_attr )
		. addon_boss_section_rules_attr( $product ) . addon_boss_qty_say_attr( $product ) . '>'; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- the attribute value is esc_attr'd inside.
	if ( $bb_sheet_on ) {
		// Every word the sheet can say, printed by the server so it is
		// translated with the rest of the page rather than assembled in the
		// browser out of English fragments.
		echo '<span class="bb-sheet-words" hidden'
			. ' data-one="' . esc_attr__( 'One more choice', 'addon-boss' ) . '"'
			/* translators: %s: how many answers the shopper still owes */
			. ' data-many="' . esc_attr__( '%s more choices', 'addon-boss' ) . '"'
			. ' data-done="' . esc_attr__( 'All set', 'addon-boss' ) . '"'
			. ' data-sub-one="' . esc_attr__( 'Choose this, then add to cart from here.', 'addon-boss' ) . '"'
			. ' data-sub-many="' . esc_attr__( 'Choose these, then add to cart from here.', 'addon-boss' ) . '"'
			. ' data-sub-done="' . esc_attr__( 'Everything this product needs is chosen.', 'addon-boss' ) . '"'
			. ' data-close="' . esc_attr__( 'Close', 'addon-boss' ) . '"'
			. ' data-add="' . esc_attr__( 'Add to cart', 'addon-boss' ) . '"></span>';
	}
	/* translators: 1: how many required questions are on the page, 2: how many of them the shopper has answered so far */
	echo '<div class="bb-progress" data-tpl="' . esc_attr__( '%2$s of %1$s chosen', 'addon-boss' ) . '" hidden></div>';
	// ABOVE THE QUESTIONS, whatever arrangement they are in. A starting point
	// that appears below the things it would fill in is a starting point nobody
	// starts from. Nothing renders here without the module that draws it, so a
	// build that cannot honour setups shows no sign of them.
	do_action( 'addon_boss_standalone_options_top', $product, $sets );
	// Display-basis base price, shared by the chips (which state each choice as
	// a whole price) and the total line below. Empty on a variable product,
	// whose base only exists once a variation is chosen.
	$base_disp = $product->is_type( 'variable' ) ? '' : (string) wc_get_price_to_display( $product );
	// Whole-price chips ("4XL is £26") read well for ONE priced set, where the
	// choice IS the product's price. On a product with SEVERAL priced sets
	// (add-ons: print +£35, design +£40, lamination +£16.67...) every set would
	// repeat the base and no option would read as the add-on it is. So with two
	// or more priced sets, chips show the "+£35" surcharge instead.
	//
	// A size priced off its own panel (a price table, a measured size) is a
	// priced set whatever its rows hold, and so is a priced field or print
	// position: each moves the price the chips would claim to be. Counted as
	// rows, the table's size was invisible here, so a bracket on a £65 sign
	// read "£110.00" while the 500 x 500 size made the sign £85 and the line
	// £130 (tester round 3, 18 Oct 2026).
	$priced_sets = addon_boss_product_has_priced_extras( $product ) ? 1 : 0;
	foreach ( $sets as $s ) {
		if ( 'choices' !== (string) ( $s['kind'] ?? 'choices' ) ) {
			++$priced_sets;
			continue;
		}
		foreach ( $s['options'] as $o ) {
			if ( 0.0 !== (float) $o['delta'] ) {
				++$priced_sets;
				break;
			}
		}
	}
	// What a choice adds through ANOTHER set's rules: a price table's
	// adjustment ("Blackout adds 15%") belongs to the choice that triggers it,
	// so the choice's badge says it. Set id => choice key => the sums.
	$bb_adj_map = (array) apply_filters( 'addon_boss_choice_adjustments', array(), $product, $sets );
	// What the required whole-price sizes add above the product's own price at
	// their cheapest, for the receipt's first paint (data-bb-from-charge).
	$bb_rcpt_from      = 0.0;
	$bb_rcpt_from_seen = false;
			$bb_sets_by_id = array();
		foreach ( $sets as $bb_s ) {
			$bb_sets_by_id[ $bb_s['id'] ] = $bb_s;
		}
		// Walk the unified config so fields interleave with sets in the merchant's
		// arranged order. Set rows resolve to their prepared entry; field rows
		// render inline. A set that no longer resolves (deleted) is skipped, as
		// before.
		// One render sequence with explicit group_open / group_close markers, so
		// each section's boundaries are exact (never guessed by position). A
		// group is a real container; its children render between the markers.
		// The layout to draw in, and, in the order the groups will render, whether
		// each one holds something the shopper has to answer. Worked out from the
		// config rather than from the render sequence, so the guarantee that a
		// required group is never folded away does not depend on a marker.
		$bb_layout_now   = addon_boss_options_layout( $product );
		$bb_fold_open    = array();
		$bb_grp_meta     = array();
		foreach ( (array) addon_boss_product_option_config( $product ) as $bb_grow ) {
			if ( ( $bb_grow['row_type'] ?? '' ) !== 'group' ) {
				continue;
			}
			$bb_gkids = (array) ( $bb_grow['children'] ?? array() );
			$bb_greq  = false;
			foreach ( $bb_gkids as $bb_gkid ) {
				if ( ! empty( $bb_gkid['required'] ) || ! empty( $bb_gkid['field']['required'] ) ) {
					$bb_greq = true;
					break;
				}
			}
			// One heading, not two. A group holding exactly ONE set whose name
			// near-duplicates its own ("How it is finished" holding "Finish")
			// collapses into a single card wearing the group's richer name:
			// stacked, both headings would say the same thing twice. Decided
			// here from the config, so the walk below needs no lookahead.
			$bb_gkid_one = ( 1 === count( $bb_gkids ) && is_array( $bb_gkids[0] ?? null ) ) ? $bb_gkids[0] : array();
			$bb_gcollapse = '' !== (string) ( $bb_gkid_one['set'] ?? '' )
				&& isset( $bb_sets_by_id[ (string) $bb_gkid_one['set'] ] )
				&& addon_boss_labels_near_duplicate( (string) ( $bb_grow['label'] ?? '' ), (string) $bb_sets_by_id[ (string) $bb_gkid_one['set'] ]['name'] );
			$bb_grp_meta[] = array(
				'req'      => $bb_greq,
				'collapse' => $bb_gcollapse,
				// A section that asks for at least one answer folds like a
				// required one: never drawn shut over the sentence it owes.
				'min'      => 1 === (int) ( $bb_grow['min_pick'] ?? 0 ),
			);
		}
		$bb_collapse_label = null;
		$bb_repeat_grp     = false; // inside a group whose FIELDS a module drew as one repeating block.
		foreach ( addon_boss_config_render_sequence( addon_boss_product_option_config( $product ) ) as $bb_cfg ) {
			if ( ( $bb_cfg['row_type'] ?? '' ) === 'group_open' ) {
				$g_label = (string) ( $bb_cfg['label'] ?? '' );
				// What the config prepass decided for this group, taken in the
				// same order the groups render, so it needs no key on the sequence.
				$bb_gm = (array) array_shift( $bb_grp_meta );
				$g_req = ! empty( $bb_gm['req'] );
				// A group marked repeatable renders AS A UNIT through the module
				// that owns repeats: the module opens the section and draws every
				// field child inside the instance blocks, so the walk must not
				// draw them again; a set child is not part of the block and still
				// renders below, and the close is the plain section's own. With
				// no module registered the answer stays false and the group is
				// the plain always-open section it has always been.
				if ( (bool) apply_filters( 'addon_boss_render_repeat_group', false, (array) ( $bb_cfg['group'] ?? array() ), $product, $g_req ) ) {
					$bb_fold_open[] = false;
					$bb_repeat_grp  = true;
					continue;
				}
				if ( ! empty( $bb_gm['collapse'] ) ) {
					// The near-duplicate 1:1 case draws NO group chrome under any
					// layout: a section (or a one-question fold) whose title repeats
					// its content's heading is noise, not structure. The member set
					// renders as its own card, wearing the group's name.
					$bb_fold_open[]    = 'collapsed';
					$bb_collapse_label = $g_label;
					continue;
				}
				// A layout beyond the engine's own stacked flow draws its own group
				// chrome through the module that registered it, answering with
				// whether this group FOLDED so the closer knows which tag to close.
				// With nothing registered (or the module standing aside for this
				// group) every group is the engine's plain section.
				$bb_go = apply_filters( 'addon_boss_render_group_open', null, $bb_layout_now, $g_label, $g_req || ! empty( $bb_gm['min'] ) );
				if ( is_array( $bb_go ) ) {
					$bb_fold_open[] = ! empty( $bb_go['fold'] );
					continue;
				}
				$bb_fold_open[] = false;
				// A group is a plain section: an optional title, then its body. It is
				// not collapsible, and shows no title at all when it is nameless.
				echo '<section class="bb-po-section' . ( '' === $g_label ? ' bb-po-untitled' : '' ) . '">';
				if ( '' !== $g_label ) {
					echo '<div class="bb-po-sectionname"><span class="bb-attr-name">' . esc_html( $g_label ) . '</span></div>';
				}
				echo '<div class="bb-po-sectionbody">';
				continue;
			}
			if ( ( $bb_cfg['row_type'] ?? '' ) === 'group_close' ) {
				$bb_closed = array_pop( $bb_fold_open );
				if ( 'collapsed' !== $bb_closed ) {
					echo '</div>' . ( $bb_closed ? '</details>' : '</section>' );
				}
				$bb_collapse_label = null; // a collapsed group is spent once closed.
				$bb_repeat_grp     = false;
				continue;
			}
			if ( ( $bb_cfg['row_type'] ?? '' ) === 'field' ) {
				if ( $bb_repeat_grp ) {
					continue; // drawn inside the group's instance blocks already.
				}
				$bb_fdef = (array) ( $bb_cfg['field'] ?? array() );
				// A field type this build does not offer is inert: not rendered (it
				// is dropped from pricing and validation in the same breath, via
				// addon_boss_standalone_product_fields).
				if ( ! addon_boss_field_type_available( (string) ( $bb_fdef['type'] ?? '' ) ) ) {
					continue;
				}
				// A rule this build does not evaluate is dropped whole, so the
				// field renders unlocked (its data left the priced set too).
				$bb_fwhen   = ( is_array( $bb_cfg['when'] ?? null )
					&& function_exists( 'addon_boss_when_runs_here' )
					&& addon_boss_when_runs_here( $bb_cfg['when'] ) ) ? $bb_cfg['when'] : array();
				$bb_factive = ! $bb_fwhen || (bool) apply_filters( 'addon_boss_when_met', true, $bb_fwhen, $prefill, $active );
				if ( addon_boss_rule_removes_row( $bb_fwhen, $bb_factive ) ) {
					continue; // a fired HIDE rule takes the row off the page, not just out of reach.
				}
				addon_boss_render_standalone_field( $product, $bb_fdef, $bb_fwhen, $sets, $bb_factive );
				continue;
			}
			$set = $bb_sets_by_id[ (string) ( $bb_cfg['set'] ?? '' ) ] ?? null;
			if ( ! $set ) {
				continue;
			}
			if ( addon_boss_rule_removes_row( $set['when'] ?? array(), ! empty( $active[ $set['id'] ] ) ) ) {
				continue; // a fired HIDE rule takes the set off the page, not just out of reach.
			}
			$field    = addon_boss_standalone_field_name( $set['id'] );
			$selected = $prefill[ $set['id'] ];
			// Several-of: the selected keys as a list (one entry or none on a
			// pick-one set), the bounds, and the sentence that states them.
			// The sentence is the control's own always-visible words: it is
			// how a shopper learns the chips take more than one, and it is
			// the copy standing right there when a pick past the bound is
			// refused.
			$bb_sel_keys = array_values( array_filter( array_map( 'strval', (array) $selected ), 'strlen' ) );
			$bb_is_multi = ! empty( $set['multi'] );
			$bb_min      = $bb_is_multi ? max( 0, (int) ( $set['min'] ?? 0 ) ) : 0;
			$bb_max      = $bb_is_multi ? max( 0, (int) ( $set['max'] ?? 0 ) ) : 0;
			// The same sentence the set editor quotes under One / Several.
			$bb_hint     = $bb_is_multi ? addon_boss_multi_hint( $bb_min, $bb_max, ! empty( $set['required'] ) ) : '';
			$bb_hint_html   = $bb_is_multi
				? '<div class="bb-multi-hint" aria-live="polite">' . esc_html( $bb_hint ) . '</div>'
				: '';
			$bb_multi_attrs = $bb_is_multi
				? ' data-multi="1" data-min="' . esc_attr( (string) $bb_min ) . '" data-max="' . esc_attr( (string) $bb_max ) . '"'
				: '';

		$bb_sreveal  = addon_boss_standalone_reveal_bits(
			is_array( $set['when'] ?? null ) ? $set['when'] : array(),
			! empty( $active[ $set['id'] ] ),
			$sets
		);
		$when_attrs  = $bb_sreveal['attrs'];
		$group_class = 'bundle-item-attribute bb-attr-group' . $bb_sreveal['class'];
		// A collapsed 1:1 group hands the set its own name: the one heading
		// wears the group's words, and everything else about the set (its
		// field name, its echo, its required marking) is exactly itself.
		//
		// The set's display label beats its library name here. A supplier
		// feed names sets to be FOUND ("GD56 - ... Colour", the code leading,
		// asked 23 Aug); worn as the heading that read as a part number on
		// the product page (seen 14 Sept, the Printful shop). The shopper's
		// word and the decorator's word are different jobs, so a set may
		// carry both.
		$bb_head_name = addon_boss_set_shopper_name( $set );
		if ( null !== $bb_collapse_label ) {
			$bb_head_name      = (string) $bb_collapse_label;
			$bb_collapse_label = null;
		}
		// The words a blocked add says AT this group (gauntlet P1: the coral
		// outline alone was wordless). Composed server-side so the copy ships
		// translated, exactly the shrink notice's discipline; the gate script
		// fills the live slot below with it and retires it on answer. Only a
		// group that can actually block carries one: required, or several-of
		// with an at-least bound the server would refuse a short pick against.
		$bb_miss_attr = '';
		if ( ! empty( $set['required'] ) || ( $bb_is_multi && $bb_min > 1 ) ) {
			/* translators: %s: the option set's name, e.g. "Candle scent" */
			$bb_miss_attr = ' data-bb-miss="' . esc_attr( sprintf( __( 'Choose %s first.', 'addon-boss' ), $bb_head_name ) ) . '"';
		}
		// A set the shop charges once for the line (the Charge control's
		// "Once") says so on its group, so the live receipt puts its money
		// with the whole-line charges and never multiplies it by the
		// quantity. The server charges it the same way from the snapshot.
		$bb_once = function_exists( 'addon_boss_grid_set_charged_once' )
			&& addon_boss_grid_set_charged_once( $product, (string) ( $set['id'] ?? '' ) );
		// A required size that sets the whole price says what its cheapest
		// size charges above the product's own price, so the receipt starts
		// there until a size is picked: "from £12.00", never the £10.00 of a
		// product no size of which costs that (tester round 3, 18 Oct 2026).
		$bb_from_attr = '';
		if ( '' !== $base_disp && ! empty( $set['required'] ) && empty( $set['when'] ) ) {
			$bb_whole = apply_filters( 'addon_boss_set_whole_cheapest', null, $set );
			if ( null !== $bb_whole ) {
				$bb_from_charge = (float) wc_get_price_to_display( $product, array( 'price' => (float) $bb_whole, 'qty' => 1 ) ) - (float) $base_disp;
				$bb_from_attr   = ' data-bb-from-charge="' . esc_attr( (string) addon_boss_round_money( $bb_from_charge, 6 ) ) . '"';
				$bb_rcpt_from     += $bb_from_charge;
				$bb_rcpt_from_seen = true;
			}
		}
		echo wp_kses(
			'<div class="' . esc_attr( $group_class ) . '"'
			// Which set this group is, so anything reasoning about sets
			// TOGETHER (the pair counters) can find its two groups without
			// guessing at field names.
			. ' data-set="' . esc_attr( (string) ( $set['id'] ?? '' ) ) . '"'
			. ' data-req="' . ( ! empty( $set['required'] ) ? '1' : '0' ) . '"' . $bb_multi_attrs . $when_attrs . $bb_miss_attr
			. ( $bb_once ? ' data-bb-once="1"' : '' ) . $bb_from_attr . '>',
			addon_boss_kses_allowed()
		);
		echo wp_kses( addon_boss_standalone_group_head( $bb_head_name, ! empty( $set['required'] ) ), addon_boss_kses_allowed() );
		if ( '' !== $bb_miss_attr ) {
			echo '<p class="bb-gmiss-note" role="status" aria-live="polite" hidden></p>';
		}
		if ( '' !== $bb_sreveal['lock'] ) {
			echo '<div class="bb-lockline">' . esc_html( $bb_sreveal['lock'] ) . '</div>';
		}
		echo '<div class="bb-gwrap"><div class="bb-gbody">';

		// A kind priced off its own panel renders through the module that
		// registered it; the sets list already dropped any kind nothing did.
		if ( 'choices' !== ( $set['kind'] ?? 'choices' ) ) {
			$bb_kcb = addon_boss_option_set_kinds()[ (string) $set['kind'] ]['render'] ?? null;
			if ( is_callable( $bb_kcb ) ) {
				call_user_func( $bb_kcb, $product, $set );
			}
			echo '</div></div></div>';
			continue;
		}

		// The bundle component's shape exactly: a hidden select the form
		// posts natively, driven by the chip row below.
		// The price wording each choice carries, shared by the chip row and the
		// list control below. A set that varies in price states each choice as
		// a WHOLE price (base + that choice's delta), so a dearer size reads
		// as "£26", never "+£2" aimed at the shopper; every choice in the set
		// then shows its price, so no single choice is singled out as the
		// expensive one. A flat set (colours at £0) states nothing; a variable
		// product has no base here, so it keeps the +/- bump. The HTML
		// survives for dual-basis (ex/inc VAT) price plugins; attributes and
		// option text get the plain string.
		//
		// A SEVERAL-OF set never qualifies, however few priced sets the page
		// has: whole prices are the one-of-these-is-your-price story, and its
		// picks STACK, so three chips each dressed as the finished price would
		// promise three different totals for one line. Its choices keep the
		// +delta form, which stays true whatever else is ticked.
		$set_varies = false;
		foreach ( $set['options'] as $o ) {
			if ( 0.0 !== (float) $o['delta'] ) {
				$set_varies = true;
				break;
			}
		}
		// The merchant's Prices on choices setting (Pro) overrides the automatic
		// pick: 'delta' forces the +bump, 'full' forces whole prices wherever a
		// base exists, 'hidden' shows no figures at all. The several-of stacking
		// truth holds under EVERY mode: its picks add up, so its chips never
		// dress as a finished price. Hidden only silences the printed badge;
		// the delta DATA still rides the control, so the total and the charge
		// are untouched by a display choice.
		// A set charged once for the line keeps the +delta form too: "£91"
		// on a chip would promise that price on every panel, when the
		// £50 inside it is paid one time however many are bought.
		// "Full price on the first list" ('full') dresses ONE list in whole
		// prices: the first priced pick-one list on the product (the size on
		// a sign, the mattress size), chosen by addon_boss_full_price_list().
		// Every list after it keeps the "+" it truly adds, because a whole
		// price there would be the product's price plus that choice alone, a
		// figure nobody pays once the first list's pick costs more.
		// A list kept under Hidden prints as Automatic (addon_boss_list_prices_mode).
		$bb_spmode     = function_exists( 'addon_boss_list_prices_mode' ) ? addon_boss_list_prices_mode( $product, (string) ( $set['id'] ?? '' ) ) : '';
		$absolute      = '' === $bb_spmode || 'hidden' === $bb_spmode
			? ( $set_varies && '' !== $base_disp && $priced_sets <= 1 && ! $bb_is_multi && ! $bb_once )
			: ( 'full' === $bb_spmode && '' !== $base_disp && ! $bb_is_multi && ! $bb_once
				&& function_exists( 'addon_boss_is_full_price_list' )
				&& addon_boss_is_full_price_list( $product, (string) ( $set['id'] ?? '' ) ) );
		// A choice that triggers a price table's adjustment is never dressed
		// as a whole price: what it adds depends on the size picked.
		$bb_set_adj = (array) ( $bb_adj_map[ (string) ( $set['id'] ?? '' ) ] ?? array() );
		if ( $bb_set_adj ) {
			$absolute = false;
		}
		// An answer that shows a whole-price size of its own ("Enter my own
		// size") prints no figure on a whole-price list: its price is the size
		// typed, never the product's own price.
		$bb_quiet      = $absolute && function_exists( 'addon_boss_full_price_quiet' ) ? addon_boss_full_price_quiet( $product, (string) ( $set['id'] ?? '' ) ) : array();
		$bb_price_bits = function ( array $opt ) use ( $absolute, $base_disp, $product, $bb_spmode, $bb_set_adj, $bb_quiet ) {
			$delta     = (float) $opt['delta'];
			$bb_oadj   = (array) ( $bb_set_adj[ (string) ( $opt['key'] ?? '' ) ] ?? array() );
			$bump_html = '';
			$bb_hush   = in_array( (string) ( $opt['key'] ?? '' ), $bb_quiet, true );
			if ( 'hidden' === $bb_spmode || $bb_hush ) {
				$bump_html = '';
			} elseif ( $absolute ) {
				// Both halves are already in the display basis, so the seam formats
				// rather than converts a second time.
				$bump_html = addon_boss_money( (float) $base_disp + addon_boss_delta_to_display( $product, $delta ), null, array( 'convert' => false ) );
			} else {
				$bump_html = addon_boss_choice_badge_html( $product, $delta, $bb_oadj );
			}
			return array(
				'html'  => $bump_html,
				'text'  => $bump_html ? addon_boss_badge_text( $bump_html ) : '',
				// The display-basis delta rides the control as data, so the page
				// total can reconcile product + options without re-deriving.
				'delta' => addon_boss_delta_to_display( $product, $delta ),
				// What a table adjustment adds, as data, so a script repainting
				// the badge (the VAT switch) says it again: the flat money in the
				// display basis, the percentage, and a once-per-line amount.
				'adj'   => ( $bb_oadj ? addon_boss_choice_adj_attrs( $product, $bb_oadj ) : '' ) . ( $bb_hush ? ' data-bb-quiet="1"' : '' ),
			);
		};
		// The reveal region for per-option notes: shown for the chosen option,
		// only rendered when at least one option in the set carries a note.
		// Shared by both controls, so a long set keeps its notes.
		//
		// A several-of set keeps a line PER PICK, each named. One region held
		// one note, so ticking a second choice silently replaced the first
		// one's description: pick Front chest and then Left sleeve and what
		// the chest print actually is disappeared off the screen. Naming them
		// is not decoration either; with several answers up at once, an
		// unattributed sentence belongs to nobody.
		$bb_has_desc = false;
		$bb_sel_desc = '';
		$bb_lines    = array();
		foreach ( $set['options'] as $bb_o ) {
			if ( ! empty( $bb_o['desc'] ) ) {
				$bb_has_desc = true;
			}
			if ( in_array( (string) $bb_o['key'], $bb_sel_keys, true ) && '' !== (string) ( $bb_o['desc'] ?? '' ) ) {
				$bb_sel_desc = addon_boss_note_html( $bb_o['desc'] );
				// The line names the pick, so its note leaves out a first
				// line that only repeats that name.
				$bb_named = addon_boss_note_after_name( (string) $bb_o['label'], $bb_o['desc'] );
				if ( '' !== $bb_named ) {
					$bb_lines[] = '<span class="bb-opt-noteline"><b>' . esc_html( $bb_o['label'] ) . '</b> '
						. $bb_named . '</span>';
				}
			}
		}
		if ( ! $bb_has_desc ) {
			$bb_note = '';
		} elseif ( $bb_is_multi ) {
			$bb_note = '<div class="bb-opt-note bb-opt-note--many"' . ( $bb_lines ? '' : ' hidden' ) . '>'
				. implode( '', $bb_lines ) . '</div>';
		} else {
			$bb_note = '<div class="bb-opt-note"' . ( '' === $bb_sel_desc ? ' hidden' : '' ) . '>'
				. $bb_sel_desc . '</div>';
		}

		// D6: past the threshold a chip row sprawls, so the set renders as the
		// same NATIVE list control the price tables use (the platform's own
		// picker, whose type-ahead is the search), unless the merchant pinned
		// the chips for this set. The select is the same posted field wearing
		// the same classes the gate, the answered reading and the miss marking
		// already drive; each option carries the label, the display-basis
		// delta and the note for the scripts, and states its price in words.
		// A several-of long set cannot be a single select, and the platform's
		// multiple select is a control shoppers famously fight, so it renders
		// as plain checkbox rows instead: each row posts the same field
		// natively and carries the same data the page scripts read.
		// A colour or photo set stays as chips no matter how many options it
		// holds. Pouring eighteen colours into a <select> hides the very
		// swatches that make the choice legible, and no merchant should have to
		// find an obscure "keep as chips" switch to stop that happening. The
		// many-options list exists for TEXT options, whose long labels a chip
		// row cannot hold; a visual set wraps its dots or cards down the page and
		// reads fine at any count. So the list gate fires only for a set that is
		// not visual: no uniform swatch row (every option a colour or a name the
		// vocabulary knows) and no photo mapped on any option.
		$bb_set_visual = addon_boss_swatch_row_uniform( $set['options'] );
		if ( ! $bb_set_visual ) {
			foreach ( $set['options'] as $bb_visual_opt ) {
				if ( ! empty( $bb_visual_opt['image_id'] ) ) {
					$bb_set_visual = true;
					break;
				}
			}
		}
		if ( count( $set['options'] ) > ADDON_BOSS_CHIP_LIST_THRESHOLD && empty( $set['pin_chips'] ) && ! $bb_set_visual ) {
			if ( $bb_is_multi ) {
				// Same money voice as the chip row and the dropdown carry, so a
				// module redrawing these labels (per-combination pricing, the VAT
				// toggle) knows whether a tick states a whole price or a bump.
				echo '<div class="bb-checks" data-attribute="' . esc_attr( $field ) . '"'
					. ' data-pmode="' . esc_attr( 'hidden' === $bb_spmode ? 'hidden' : ( $absolute ? 'full' : 'delta' ) ) . '">';
				foreach ( $set['options'] as $opt ) {
					$bb_p = $bb_price_bits( $opt );
					// A ticked row is named beside its note, so the note
					// leaves out a first line that only repeats the name.
					$bb_row_note = ! empty( $opt['desc'] ) ? addon_boss_note_after_name( (string) $opt['label'], $opt['desc'] ) : '';
					echo '<label class="bb-check-row">'
						. '<input type="checkbox" name="' . esc_attr( $field ) . '[]" value="' . esc_attr( $opt['key'] ) . '"'
						. ( in_array( (string) $opt['key'], $bb_sel_keys, true ) ? ' checked="checked"' : '' )
						. ' data-delta="' . esc_attr( (string) $bb_p['delta'] ) . '"' . $bb_p['adj'] // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- esc_attr'd inside addon_boss_choice_adj_attrs().
						. ' data-label="' . esc_attr( $opt['label'] ) . '"'
						. ( '' !== $bb_row_note ? ' data-desc="' . esc_attr( $bb_row_note ) . '"' : '' )
						. '>'
						. '<span class="bb-check-name">' . esc_html( $opt['label'] ) . '</span>'
						. ( '' !== $bb_p['text'] ? ' <span class="bb-chip-delta">' . wp_kses_post( $bb_p['html'] ) . '</span>' : '' )
						. '</label>';
				}
				echo '</div>';
				echo wp_kses( $bb_hint_html . $bb_note . '</div></div></div>', addon_boss_kses_allowed() );
				continue;
			}
			echo '<select name="' . esc_attr( $field ) . '" class="bundle-attr-select bb-tbl-sel bb-list-sel" data-attribute="' . esc_attr( $field ) . '"'
				// How this set states its money (a whole price, a +bump, or
				// nothing), said as data so a module re-pricing choices live
				// (per-combination pricing) redraws them in the same voice.
				. ' data-pmode="' . esc_attr( 'hidden' === $bb_spmode ? 'hidden' : ( $absolute ? 'full' : 'delta' ) ) . '"'
				. ( ! empty( $set['required'] ) ? ' aria-required="true"' : '' ) . '>';
			echo '<option value="">' . esc_html__( 'Choose…', 'addon-boss' ) . '</option>';
			foreach ( $set['options'] as $opt ) {
				$bb_p = $bb_price_bits( $opt );
				echo '<option value="' . esc_attr( $opt['key'] ) . '"' . selected( $opt['key'], $selected, false )
					. ' data-delta="' . esc_attr( (string) $bb_p['delta'] ) . '"' . $bb_p['adj'] // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- esc_attr'd inside addon_boss_choice_adj_attrs().
					. ' data-label="' . esc_attr( $opt['label'] ) . '"'
					. ( ! empty( $opt['desc'] ) ? ' data-desc="' . esc_attr( addon_boss_note_html( $opt['desc'] ) ) . '"' : '' )
					. '>' . esc_html( $opt['label'] . ( '' !== $bb_p['text'] ? ' (' . $bb_p['text'] . ')' : '' ) ) . '</option>';
			}
			echo '</select>';
			echo wp_kses( $bb_note . '</div></div></div>', addon_boss_kses_allowed() );
			continue;
		}

		// The bundle component's shape exactly: a hidden select the form
		// posts natively, driven by the chip row below. A several-of set's is
		// the same select made multiple (its name picks up the array brackets,
		// its data-attribute stays the bare field the chip driver looks up),
		// so every pick posts natively and nothing else changes shape.
		// autocomplete="off" asks the browser not to restore this control on
		// reload (the chips it mirrors come back clean, so a restored select
		// is a pick the screen never shows); the boot reconcile is the
		// backstop for browsers that restore it anyway.
		echo '<select name="' . esc_attr( $field ) . ( $bb_is_multi ? '[]' : '' ) . '" class="bundle-attr-select" data-attribute="' . esc_attr( $field ) . '"'
			. ( $bb_is_multi ? ' multiple' : '' ) . ' autocomplete="off" style="display:none;">';
		if ( ! $bb_is_multi ) {
			echo '<option value=""></option>';
		}
		foreach ( $set['options'] as $opt ) {
			$bb_osel = $bb_is_multi
				? ( in_array( (string) $opt['key'], $bb_sel_keys, true ) ? ' selected="selected"' : '' )
				: selected( $opt['key'], $selected, false );
			echo wp_kses( '<option value="' . esc_attr( $opt['key'] ) . '"' . $bb_osel . '>' . esc_html( $opt['label'] ) . '</option>', addon_boss_kses_allowed() );
		}
		echo '</select>';
		// The swatch shape (D1, display only): square and circle ride the row
		// as a class the stylesheet reads; the photo card rebuilds each
		// chip's own anatomy (the visual filling it, name and price
		// beneath). Same button, same classes the scripts drive, same data
		// attributes, same hidden select: the shape never touches keys,
		// money or the form.
		$bb_shape = addon_boss_option_set_drawn_shape( $set ); // Photo card with no photo draws plain swatches, as its editor says.
		// The whole-row rule at render: a row that cannot be uniform in dots
		// renders uniform pills. That now gates STORED swatches too, not just
		// the name guess: a supplier feed (or a merchant mid-edit) can hand
		// one option a colour and its siblings none, and the one dot chip in
		// a row of pills was exactly the mixed-shape defect the sanitiser's
		// comment warns about (the camo cap: one white tile, two bare pills).
		// Storage is untouched; the dot returns the moment the row completes.
		// The card shape keeps every swatch either way: every option cards
		// alike there, so a colour fill mixes no shapes.
		$bb_row_dots = addon_boss_swatch_row_uniform( $set['options'] );
		echo '<div class="bb-chips bb-shape-' . esc_attr( $bb_shape ) . ( $bb_is_multi ? ' bb-multi' : '' ) . '" data-for-select="' . esc_attr( $field ) . '"'
			// How this set states its money (a whole price, a +bump, or
			// nothing), said as data so a module re-pricing choices live
			// (per-combination pricing) redraws them in the same voice.
			. ' data-pmode="' . esc_attr( 'hidden' === $bb_spmode ? 'hidden' : ( $absolute ? 'full' : 'delta' ) ) . '"' . '>';
		foreach ( $set['options'] as $opt ) {
			$swatch = ( $bb_row_dots || 'card' === $bb_shape )
				? ( $opt['swatch'] ? $opt['swatch'] : ( empty( $opt['no_swatch'] ) ? addon_boss_swatch_from_name( $opt['label'] ) : '' ) )
				: '';
			$is_sel = in_array( (string) $opt['key'], $bb_sel_keys, true );
			// Per-option stock: read the live count, so a sold-out option renders
			// as a disabled "Sold out" chip up front (the add-to-cart guard stays
			// the backstop) and a low one nudges with what is left. The low
			// threshold is the store's own, the one WooCommerce products use.
			$bb_soldout = false;
			$bb_left    = null;
			$bb_ql      = addon_boss_option_stock_left( (string) ( $set['id'] ?? '' ), (string) $opt['key'] );
			// A product rebuilt from variations keeps its counts per PAIR, in
			// its own bucket, which is why a chip cannot normally speak for
			// them: "Black" is not sold out because Black/XL is. On a single
			// axis there is no such gap, the pair IS the choice, so the figure
			// that already exists can be shown instead of leaving a sold-out
			// size looking buyable until the till says otherwise.
			if ( null === $bb_ql && isset( $product ) && $product instanceof WC_Product ) {
				$bb_csets = function_exists( 'addon_boss_combo_sets' ) ? addon_boss_combo_sets( $product ) : array();
				if ( 1 === count( $bb_csets ) && (string) ( $set['id'] ?? '' ) === (string) $bb_csets[0] ) {
					$bb_pairs = addon_boss_combo_stock_all( $product );
					if ( array_key_exists( (string) $opt['key'], $bb_pairs ) ) {
						$bb_ql = (int) $bb_pairs[ (string) $opt['key'] ];
					}
				}
			}
			if ( null !== $bb_ql ) {
				$bb_soldout = $bb_ql <= 0;
				if ( ! $bb_soldout ) {
					$bb_low = (int) get_option( 'woocommerce_notify_low_stock_amount', 2 );
					if ( $bb_ql <= max( 1, $bb_low ) ) {
						$bb_left = $bb_ql;
					}
				}
			}
			// The set's display toggle: when off, the numbers stay hidden and a
			// sold-out option is simply not offered (the add-to-cart guard still
			// blocks it). Absent means on, so existing sets are unchanged.
			if ( isset( $set['show_stock'] ) && empty( $set['show_stock'] ) ) {
				if ( $bb_soldout ) {
					continue;
				}
				$bb_left = null;
			}
			$bb_p   = $bb_price_bits( $opt );
			// No live price engine on a plain product page, so the price rides
			// the chip itself; a dot-only chip carries it in the title.
			$bump_html  = $bb_p['html'];
			$bump       = $bb_p['text'];
			$title      = $opt['label'] . ( $bump ? ' ' . $bump : '' );
			$bb_card    = ( 'card' === $bb_shape );
			$classes    = 'bb-chip' . ( $bb_card ? ' bb-chip--card' : ( $swatch ? ' bb-chip--swatch' : '' ) ) . ( $is_sel ? ' is-selected' : '' ) . ( $bb_soldout ? ' bb-chip--soldout' : '' );
			$delta_disp = $bb_p['delta'];
			// A mapped photo rides the chip through the module that owns the
			// swap; a build without one puts no image on any chip, and the
			// stored image id is untouched. The SET goes with it, because
			// whether picking should move the product's own photograph is a
			// property of the set rather than of one choice.
			$img_attrs = (string) apply_filters( 'addon_boss_option_photo_attrs', '', $opt, $product, $set );
			// A several-of pick is named beside its note once ticked, so its
			// note leaves out a first line that only repeats the name. A
			// pick-one note prints on its own and keeps every word.
			$bb_desc_attr = '';
			if ( ! empty( $opt['desc'] ) ) {
				$bb_chip_note = $bb_is_multi ? addon_boss_note_after_name( (string) $opt['label'], $opt['desc'] ) : addon_boss_note_html( $opt['desc'] );
				if ( ! $bb_is_multi || '' !== $bb_chip_note ) {
					$bb_desc_attr = ' data-desc="' . esc_attr( $bb_chip_note ) . '"';
				}
			}
			echo wp_kses(
				'<button type="button" class="' . esc_attr( $classes ) . '"'
				. ' data-value="' . esc_attr( $opt['key'] ) . '"'
				. ' data-label="' . esc_attr( $opt['label'] ) . '"'
				. ' data-delta="' . esc_attr( (string) $delta_disp ) . '"' . $bb_p['adj']
				. $bb_desc_attr
				. $img_attrs
				. ' aria-label="' . esc_attr( $title ) . '"'
				. ' title="' . esc_attr( $title ) . '"'
				. ' aria-pressed="' . ( $is_sel ? 'true' : 'false' ) . '"'
				. ( $bb_soldout ? ' disabled aria-disabled="true"' : '' ) . '>',
				addon_boss_kses_allowed()
			);
			if ( $bb_card ) {
				// The photo card: the image fills the chip's visual with the
				// name and price beneath. This is display; the SWAP of the
				// main gallery image stays where its own gate put it, so
				// showing the picture here never fights a variable page's
				// variation gallery. A photo wins; a plain colour fills the
				// same block; an option with neither keeps the block, empty.
				// 🔴 'medium', NOT 'woocommerce_thumbnail'. WooCommerce ships
				// with thumbnail cropping set to 1:1, so asking for that size hands
				// back a SQUARE file cut from the middle of whatever the merchant
				// uploaded, before any CSS could be blamed. Two branches hit it from
				// opposite ends: a portrait garment shot arrived as a band of fabric
				// that read like a tee, and David's 640x480 cutting diagram arrived
				// 300x300 with its top and bottom already gone, which is exactly the
				// "cut on the top and bottom" he reported. WordPress's medium is
				// scaled, not cropped, so the whole picture arrives and the card
				// decides how to fit it.
				$bb_card_img = ! empty( $opt['image_id'] ) ? wp_get_attachment_image_url( absint( $opt['image_id'] ), 'medium' ) : '';
				if ( $bb_card_img ) {
					echo '<img class="bb-cc-img" src="' . esc_url( $bb_card_img ) . '" alt="" loading="lazy">';
				} elseif ( $swatch ) {
					echo '<span class="bb-cc-img bb-cc-fill" style="background:' . esc_attr( addon_boss_swatch_css( $opt ) ) . '"></span>';
				} else {
					// No photo and no colour still gets the frame, left empty.
					// Without it the card was its name alone: a "No base required"
					// answer stood a third of the height of the photo cards beside
					// it and read as squashed. BundleBoss draws the same empty
					// frame for a bundle's questions, so one set looks the same on
					// the product page and in a bundle.
					echo '<span class="bb-cc-img bb-cc-none" aria-hidden="true"></span>';
				}
				echo '<span class="bb-cc-name">' . esc_html( $opt['label'] ) . '</span>';
				if ( $bump ) {
					echo '<span class="bb-chip-delta">' . wp_kses_post( $bump_html ) . '</span>';
				}
			} elseif ( $swatch ) {
				echo '<span class="bb-swatch-dot" style="background:' . esc_attr( addon_boss_swatch_css( $opt ) ) . '"></span>';
				// The gallery anatomy: the name (and the price where one is
				// carried) stands visibly beneath the swatch. A hover tooltip
				// was the only place they lived, which is no place at all on
				// a touch screen, and a priced material hid its price.
				echo '<span class="bb-sw-name">' . esc_html( $opt['label'] ) . '</span>';
				if ( $bump ) {
					echo '<span class="bb-chip-delta">' . wp_kses_post( $bump_html ) . '</span>';
				}
			} else {
				echo esc_html( $opt['label'] );
				if ( $bump ) {
					echo ' <span class="bb-chip-delta">' . wp_kses_post( $bump_html ) . '</span>';
				}
			}
			if ( $bb_soldout ) {
				echo '<span class="bb-chip-stock bb-chip-stock--out">' . esc_html__( 'Sold out', 'addon-boss' ) . '</span>';
			} elseif ( null !== $bb_left ) {
				/* translators: %d: units of this option still available */
				echo '<span class="bb-chip-stock bb-chip-stock--low">' . esc_html( sprintf( _n( 'Only %d left', 'Only %d left', $bb_left, 'addon-boss' ), $bb_left ) ) . '</span>';
			}
			echo '</button>';
		}
		echo wp_kses( '</div>' . $bb_hint_html . $bb_note . '</div></div></div>', addon_boss_kses_allowed() );
	}

	// Whatever a module offers on this surface beyond the sets and fields
	// (the artwork upload box) renders here, after the sets, through the
	// module's own listener.
	do_action( 'addon_boss_standalone_options_extra', $product, $sets, $prefill );

	// The receipt the category calls a breakdown: per-source lines (the base
	// with its size where one is measured, each fee-bearing choice, repeats
	// as "N × thing") above an explicit Total row, live with every pick, so
	// the number on the chip, the number in the receipt and the number in
	// the cart are one story. The server paints the first state (a simple
	// product arrives with its base line and total filled, no script
	// needed); the script rebuilds the lines from the same per-control walk
	// that computes the figure. On a variable page the whole receipt joins
	// the moment a variation is chosen.
	$bb_rcpt_name = $product->get_name();
	// HELD, not printed here. A receipt is a summary, so it belongs after
	// everything it summarises. Printed inline it came out at priority 10,
	// which put it ABOVE the decoration panel that renders at 14: the page
	// asked a shopper to total up before it had finished asking what they
	// wanted. Held now and printed on a late hook, so any module adding to
	// this surface lands above the total instead of below it.
	// Until a required whole-price size is picked, the line and the total
	// start at its cheapest size and say so.
	$bb_rcpt_first = '';
	if ( '' !== $base_disp ) {
		$bb_rcpt_first = wp_kses_post( addon_boss_money( (float) $base_disp + $bb_rcpt_from, null, array( 'convert' => false ) ) );
		if ( $bb_rcpt_from_seen ) {
			/* translators: %s: the cheapest price this can come to, e.g. £4.00 */
			$bb_rcpt_first = sprintf( esc_html__( 'from %s', 'addon-boss' ), $bb_rcpt_first );
		}
	}
	ob_start();
	echo '<div class="bb-standalone-total" data-base="' . esc_attr( $base_disp ) . '"'
		/* translators: %s: the cheapest price this can come to, e.g. £4.00 */
		. ' data-from="' . esc_attr__( 'from %s', 'addon-boss' ) . '"'
		. ' data-name="' . esc_attr( $bb_rcpt_name ) . '"'
		/* translators: 1: how many are being bought, 2: what each one is. e.g. "3 × Team shirt" */
		. ' data-qty-tpl="' . esc_attr__( '%1$s × %2$s', 'addon-boss' ) . '"'
		. ' data-symbol="' . esc_attr( get_woocommerce_currency_symbol() ) . '"'
		. ' data-decimals="' . esc_attr( (string) wc_get_price_decimals() ) . '"'
		. ' data-bb-k="' . esc_attr( (string) addon_boss_tax_factor( $product ) ) . '"'
		// The whole money format, not just the symbol: a Euro store writes
		// "155,00 €", and a receipt answering it with "€155.00" reads like a
		// different shop's till.
		. ' data-ds="' . esc_attr( wc_get_price_decimal_separator() ) . '"'
		. ' data-ts="' . esc_attr( wc_get_price_thousand_separator() ) . '"'
		. ' data-pos="' . esc_attr( get_option( 'woocommerce_currency_pos', 'left' ) ) . '"'
		// The shop's display basis rides in with the toggle attributes below,
		// which is the only place it is ever read: with no toggle plugin there is
		// one basis on the page and nothing to convert anything to.
		. addon_boss_wts_attrs( $product ) // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- escaped within.
		. ( '' === $base_disp ? ' hidden' : '' ) . '>'
		. '<div class="bb-st-lines">'
		. ( '' !== $base_disp
			? '<div class="bb-st-line bb-st-item"><span class="bb-st-line-n">' . esc_html( $bb_rcpt_name ) . '</span><span class="bb-st-line-a">' . $bb_rcpt_first . '</span></div>' // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- wp_kses_post'd and esc_html__'d where built.
			: '' )
		. '</div>'
		// "Grand total", not "Total": the receipt above it already shows a price
		// against the product and against each option, so a bare "Total" reads
		// like one more line rather than the sum of all of them.
		. '<div class="bb-st-row"><span class="bb-st-lab">' . esc_html__( 'Grand total', 'addon-boss' ) . '</span>'
		. '<span class="bb-st-sum"><b class="bb-st-total">' . $bb_rcpt_first . '</b> <span class="bb-st-note"></span></span></div>' // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- wp_kses_post'd and esc_html__'d where built.
		// Both plural forms, because the number is only known in the browser.
		// _n() rather than two separate strings, so a translator gets ONE entry
		// with its forms tied together rather than two that can drift apart.
		// The picker in the page reads form one or form two; every locale this
		// plugin ships has exactly those two.
		//
		// The SINGULAR carries the placeholder as well, which reads redundant
		// in English and is not: a language whose plural rule uses form one for
		// numbers other than 1 would otherwise be handed a sentence with
		// nowhere to put the number. The platform's own i18n gate refuses the
		// other spelling, and it is right to.
		// dir="auto", because this sentence OPENS WITH A NUMBER. On a
		// right-to-left page the bidi algorithm reads a leading digit as
		// neutral and throws it to the far end, so an untranslated English line
		// renders as "still to choose 3". Letting the element take its
		// direction from its own first strong character keeps English reading
		// left-to-right inside an RTL page, and a translated right-to-left
		// sentence reading right-to-left, with no branch in the code.
		/* translators: %s: how many answers the shopper still owes before the product can be added */
		. '<div class="bb-st-left" dir="auto" data-one="' . esc_attr( _n( '%s still to choose', '%s still to choose', 1, 'addon-boss' ) ) . '"'
		/* translators: %s: how many answers the shopper still owes before the product can be added */
		. ' data-many="' . esc_attr( _n( '%s still to choose', '%s still to choose', 2, 'addon-boss' ) ) . '"'
		// NAMING THEM BEATS COUNTING THEM. "2 still to choose" tells a shopper
		// they are not finished; it does not tell them what to do, and on a long
		// page the two questions could be anywhere. The names are the answer, and
		// they cost nothing: the page already reads every group's name for the
		// review rows and the fold summaries.
		//
		// The count sentence above STAYS, and is still used whenever a name
		// cannot be read (an unnamed group), so no shop ever gets a bar that
		// says "Still to choose:" and then nothing.
		/* translators: %s: the names of the questions still to answer, separated by commas */
		. ' data-which="' . esc_attr__( 'Still to choose: %s', 'addon-boss' ) . '"'
		// Only the first two are named. A shopper on a twenty-question product
		// does not read a bar listing eighteen things, and a sentence that long
		// stops being a sentence and becomes a wall the eye skips.
		/* translators: %s: how many more there are beyond the ones named */
		. ' data-more="' . esc_attr__( 'and %s more', 'addon-boss' ) . '"'
		. ' data-show="' . esc_attr__( 'Show me', 'addon-boss' ) . '" hidden></div>'
		. '<span class="bb-st-tpl-total" hidden>' . /* translators: %s: the total price */ esc_attr__( '%s total', 'addon-boss' ) . '</span>'
		. '<span class="bb-st-tpl-opts" hidden>' . /* translators: %s: the options subtotal price */ esc_attr__( '+ %s options', 'addon-boss' ) . '</span>'
		. '<span class="bb-st-tpl-save" hidden>' . /* translators: %s: what a quantity break takes off the total, like £24.60 */ esc_html__( 'You save %s', 'addon-boss' ) . '</span>'
		. '</div>';
	addon_boss_standalone_receipt_held( (string) ob_get_clean() );
	echo '</div>';
	addon_boss_money_product( $bb_money_was ); // the panel is done; hand the basis back.
}

/**
 * The receipt's markup, held between the options render and the late hook
 * that prints it. A getter with no argument; pass a string to store one.
 *
 * @param string|null $set Markup to hold, or null to read and clear.
 * @return string The held markup; '' once read.
 */
function addon_boss_standalone_receipt_held( ?string $set = null ): string {
	static $held = '';
	if ( null !== $set ) {
		$held = $set;
		return '';
	}
	$out  = $held;
	$held = '';
	return $out;
}

add_action( 'woocommerce_before_add_to_cart_button', 'addon_boss_print_standalone_receipt', 20 );

/**
 * Print the held receipt, last on this surface.
 *
 * Priority 20 leaves the whole 10-to-19 band for blocks that a shopper is
 * still ANSWERING: the option sets and fields at 10, the print areas at 14,
 * and whatever a later module adds. The sum comes after the questions.
 */
function addon_boss_print_standalone_receipt(): void {
	$bb_held = addon_boss_standalone_receipt_held();
	if ( '' === $bb_held ) {
		return;
	}
	// Its own wrapper, because the options panel has closed by now and the
	// receipt's styling is scoped to that class.
	echo '<div class="bb-standalone-options bb-so-receipt">' . $bb_held . '</div>'; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- built and escaped above.
}

/**
 * The chip driver as a STRING for the script loader. bundle.js only boots
 * inside a bundle form and no BundleBoss script loads on a plain product
 * page, so this self-contained binding mirrors its chip-to-select contract
 * (same markup, same toggle-off semantics, change event for themes that
 * listen). It attaches via wp_add_inline_script in the enqueue, because
 * printing it inline into hook output let block themes content-filter it
 * into a syntax error.
 */
function addon_boss_standalone_boot_js(): string {
	ob_start();
	try {
	?>
	( function () {
		<?php echo addon_boss_money_round_js(); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- generated JS, no variables. ?>
		<?php echo addon_boss_typed_amount_js(); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- generated JS, no variables. ?>
		// An amount a shopper typed (name your price), read as the cart reads
		// it (addon_boss_typed_amount()): "19,50" is 19.50 and "1,950" is 1950,
		// here and at the till. The page read "1,950" as 1.95 while the cart
		// charged 1950, and "19,50" as 19.50 while the cart charged 1950.
		var bbShopDs = <?php echo wp_json_encode( (string) wc_get_price_decimal_separator() ); ?>;
		function bbOwnNum( v ) { return parseFloat( window.bbTypedAmount( v, bbShopDs ) ); }
		// Clearing a group's own pick keeps the page honest with the server,
		// The hidden select is the form carrier the chips drive, and a browser
		// restores form controls on reload while the chips' classes come back
		// clean. Left alone, the restored select posts (and prices) a pick the
		// screen never showed, and the exclusion rules grey partners of a
		// choice nobody made. The chips are the control, so the select is made
		// to agree with them at boot and again after the browser's late
		// restore; only when a ghost was actually cleared does the select say
		// change, so the receipt and the rules re-settle.
		function bbChipReconcile() {
			document.querySelectorAll( ".bb-standalone-options .bb-chips[data-for-select]" ).forEach( function ( wrap ) {
				var group = wrap.closest( ".bb-attr-group" );
				var sel   = group ? group.querySelector( "select[data-attribute=\"" + wrap.dataset.forSelect + "\"]" ) : null;
				if ( ! sel ) { return; }
				var keys = [];
				wrap.querySelectorAll( ".bb-chip.is-selected" ).forEach( function ( c ) { keys.push( c.getAttribute( "data-value" ) || "" ); } );
				var moved = false;
				for ( var i = 0; i < sel.options.length; i++ ) {
					var want = sel.multiple
						? keys.indexOf( sel.options[ i ].value ) !== -1
						: sel.options[ i ].value === ( keys[0] || "" );
					if ( sel.options[ i ].selected !== want ) { sel.options[ i ].selected = want; moved = true; }
				}
				if ( moved ) { sel.dispatchEvent( new Event( "change", { bubbles: true } ) ); }
			} );
		}
		bbChipReconcile();
		window.addEventListener( "load", bbChipReconcile );
		// The restore has no event of its own and can land after load; two
		// quiet retries cover it, and agreeing is free.
		setTimeout( bbChipReconcile, 400 );
		setTimeout( bbChipReconcile, 1200 );
		// which discards a hidden group's value anyway. A module that decides a
		// group must clear (the reveal evaluator hiding one) asks through the
		// bb-clear-group event rather than reaching into this driver.
		function bbClearGroup( group ) {
			var select = group.querySelector( 'select.bundle-attr-select' );
			if ( select && select.multiple ) {
				Array.prototype.forEach.call( select.options, function ( o ) { o.selected = false; } );
			} else if ( select && select.value ) { select.value = ''; }
			group.querySelectorAll( '.bb-chip.is-selected' ).forEach( function ( c ) {
				c.classList.remove( 'is-selected' );
				c.setAttribute( 'aria-pressed', 'false' );
			} );
			// A several-of long set's checkbox rows blank the same way.
			group.querySelectorAll( '.bb-checks input:checked' ).forEach( function ( c ) { c.checked = false; } );
			// A field group blanks its own input so a hidden field submits
			// nothing (the server treats it as inert regardless; the page
			// just stays honest and the fee leaves the live total).
			if ( group.classList.contains( 'bb-field-group' ) ) {
				group.querySelectorAll( '[name^="bb_pf"]' ).forEach( function ( el ) {
					if ( 'checkbox' === el.type || 'radio' === el.type ) { el.checked = false; }
					else { el.value = ''; }
				} );
			}
			// Whatever a module keeps inside this group (typed dimensions, a live
			// charge it computed) is its own to clear; the event says now is the
			// moment.
			group.dispatchEvent( new CustomEvent( 'bb-group-clear', { bubbles: true } ) );
		}
		document.addEventListener( 'bb-clear-group', function ( e ) {
			if ( e.target && e.target.classList ) { bbClearGroup( e.target ); }
		} );
		// A refused pick points at the sentence that already states the bound:
		// the hint takes the accent for a moment, and its aria-live region has
		// just been re-read, so the answer arrives at the control, kindly.
		function bbHintRefuse( group ) {
			var hint = group.querySelector( '.bb-multi-hint' );
			if ( ! hint ) { return; }
			hint.classList.add( 'is-refused' );
			setTimeout( function () { hint.classList.remove( 'is-refused' ); }, 1200 );
		}
		// The note region, rebuilt from what is CHOSEN rather than from what
		// was just clicked. A several-of set keeps a line per pick, each
		// named: one region holding one note meant a second tick silently
		// wiped the first one's description off the page.
		function bbNotes( group ) {
			var note = group.querySelector( '.bb-opt-note' );
			if ( ! note ) { return; }
			var many = note.classList.contains( 'bb-opt-note--many' );
			var on   = group.querySelectorAll( '.bb-chip.is-selected, .bb-checks input:checked' );
			if ( ! many ) {
				// Pick-one: the chosen option's note, exactly as before. A
				// select-driven long set answers through its own handler.
				// The note is markup the server already cleaned to the note
				// allow-list (addon_boss_note_html), so it goes in as markup.
				var one = on[ on.length - 1 ];
				var txt = one ? ( one.dataset.desc || '' ) : '';
				note.innerHTML = txt;
				note.hidden = ( '' === txt );
				return;
			}
			var html = '';
			Array.prototype.forEach.call( on, function ( el ) {
				var d = el.dataset.desc || '';
				if ( ! d ) { return; }
				var line = document.createElement( 'span' );
				line.className = 'bb-opt-noteline';
				var b = document.createElement( 'b' );
				b.textContent = el.dataset.label || '';
				line.appendChild( b );
				line.insertAdjacentHTML( 'beforeend', ' ' + d );
				html += line.outerHTML;
			} );
			note.innerHTML = html;
			note.hidden = ( '' === html );
		}
		// ── Pairs: a colour AND a size ────────────────────────────────────
		// A product whose counts are kept per combination hands its table to
		// the page. Picking a colour then re-reads every size against THAT
		// colour, so the size the supplier has none of in it goes dim at the
		// moment of the pick. With nothing picked yet a choice is dimmed only
		// when it is gone in every combination, because it is still available
		// in some of them and dimming it would be a lie.
		//
		// A courtesy, not the rule: the server counts the same pairs again on
		// add, and it is the server that decides what a shopper buys.
		var bbPairsRoot = document.querySelector( '.bb-standalone-options[data-bb-pairs]' );
		var bbPairs     = null;
		if ( bbPairsRoot ) {
			try { bbPairs = JSON.parse( bbPairsRoot.getAttribute( 'data-bb-pairs' ) ); } catch ( err ) { bbPairs = null; }
		}

		function bbPairGroups() {
			var out = {};
			if ( ! bbPairs || ! bbPairs.sets ) { return out; }
			bbPairs.sets.forEach( function ( sid ) {
				var g = bbPairsRoot.querySelector( '.bb-attr-group[data-set="' + sid + '"]' );
				if ( g ) { out[ sid ] = g; }
			} );
			return out;
		}

		function bbPairPicked( group ) {
			var chip = group ? group.querySelector( '.bb-chip.is-selected' ) : null;
			if ( chip ) { return chip.dataset.value || ''; }
			var sel = group ? group.querySelector( 'select.bundle-attr-select' ) : null;
			return sel && sel.value ? sel.value : '';
		}

		function bbPairsApply() {
			if ( ! bbPairs || ! bbPairs.sets || bbPairs.sets.length < 2 ) { return; }
			var groups = bbPairGroups();
			var sets   = bbPairs.sets.filter( function ( sid ) { return groups[ sid ]; } );
			if ( sets.length < 2 ) { return; }

			sets.forEach( function ( sid, idx ) {
				var others = sets.filter( function ( o ) { return o !== sid; } );
				groups[ sid ].querySelectorAll( '.bb-chip' ).forEach( function ( chip ) {
					var key   = chip.dataset.value || '';
					var any   = false;   // available in at least one live combination
					var known = false;   // this choice appears in the table at all
					Object.keys( bbPairs.q ).forEach( function ( pair ) {
						var parts = pair.split( '|' );
						if ( parts[ idx ] !== key ) { return; }
						// Every other set that HAS a pick must match it; a set
						// with no pick yet matches anything.
						var fits = true;
						others.forEach( function ( o ) {
							var oi = sets.indexOf( o );
							var on = bbPairPicked( groups[ o ] );
							if ( on && parts[ oi ] !== on ) { fits = false; }
						} );
						if ( ! fits ) { return; }
						known = true;
						if ( bbPairs.q[ pair ] > 0 ) { any = true; }
					} );
					// A pair the table does not hold is a combination the supplier
					// does not make, so it is dimmed exactly like an empty one:
					// White stopping at XXL is as real as White XXL selling out.
					// Only a product holding no table at all leaves chips alone.
					if ( ! known && ! bbPairs.q ) { return; }
					if ( ! known && ! Object.keys( bbPairs.q ).length ) { return; }
					chip.classList.toggle( 'bb-chip--soldout', ! any );
					if ( any ) {
						chip.removeAttribute( 'disabled' );
						chip.removeAttribute( 'aria-disabled' );
					} else {
						chip.setAttribute( 'disabled', 'disabled' );
						chip.setAttribute( 'aria-disabled', 'true' );
						// A pick that has just become impossible cannot stand:
						// leaving it selected would send a shopper to a button
						// that refuses them.
						if ( chip.classList.contains( 'is-selected' ) ) {
							chip.classList.remove( 'is-selected' );
							chip.setAttribute( 'aria-pressed', 'false' );
							var sel = groups[ sid ].querySelector( 'select.bundle-attr-select' );
							if ( sel ) { sel.value = ''; sel.dispatchEvent( new Event( 'change', { bubbles: true } ) ); }
						}
					}
				} );
			} );
		}

		if ( bbPairs ) {
			bbPairsApply();
			document.addEventListener( 'bb-pick-change', bbPairsApply );
		}

		document.addEventListener( 'click', function ( e ) {
			var chip = e.target.closest ? e.target.closest( '.bb-standalone-options .bb-chip' ) : null;
			if ( ! chip ) { return; }
			var wrap   = chip.closest( '.bb-chips' );
			var group  = chip.closest( '.bb-attr-group' );
			var select = group && wrap ? group.querySelector( 'select[data-attribute="' + wrap.dataset.forSelect + '"]' ) : null;
			if ( ! select ) { return; }
			if ( '1' === ( group.dataset.multi || '' ) ) {
				// Several-of: each chip toggles for itself and the picks
				// accumulate. Going past the up-to bound is refused HERE, at
				// the chip, with the hint's own words; the server enforces
				// the same bound regardless.
				var on  = chip.classList.contains( 'is-selected' );
				var max = parseInt( group.dataset.max, 10 ) || 0;
				if ( ! on && max > 0 && wrap.querySelectorAll( '.bb-chip.is-selected' ).length >= max ) {
					bbHintRefuse( group );
					return;
				}
				chip.classList.toggle( 'is-selected', ! on );
				chip.setAttribute( 'aria-pressed', on ? 'false' : 'true' );
				var onKeys = [];
				wrap.querySelectorAll( '.bb-chip.is-selected' ).forEach( function ( c ) { onKeys.push( c.dataset.value ); } );
				Array.prototype.forEach.call( select.options, function ( o ) { o.selected = onKeys.indexOf( o.value ) >= 0; } );
			} else if ( chip.classList.contains( 'is-selected' ) ) {
				chip.classList.remove( 'is-selected' );
				chip.setAttribute( 'aria-pressed', 'false' );
				select.value = '';
			} else {
				wrap.querySelectorAll( '.bb-chip' ).forEach( function ( c ) {
					c.classList.remove( 'is-selected' );
					c.setAttribute( 'aria-pressed', 'false' );
				} );
				chip.classList.add( 'is-selected' );
				chip.setAttribute( 'aria-pressed', 'true' );
				select.value = chip.dataset.value;
			}
			bbNotes( group );
			select.dispatchEvent( new Event( 'change', { bubbles: true } ) );
			// Modules that react to a pick (a reveal chain re-evaluating) listen
			// for this rather than reaching into the driver.
			group.dispatchEvent( new CustomEvent( 'bb-pick-change', { bubbles: true, detail: { chip: chip } } ) );
			bbTotal();
		} );
		// A several-of long set's checkbox rows: a tick is a pick, the up-to
		// bound refuses the tick that would pass it, and the same pick event
		// fires for the modules.
		document.addEventListener( 'change', function ( e ) {
			var c = e.target;
			if ( ! c || ! c.matches || ! c.matches( '.bb-standalone-options .bb-checks input' ) ) { return; }
			var group = c.closest( '.bb-attr-group' );
			if ( ! group ) { return; }
			if ( c.checked ) {
				var max = parseInt( group.dataset.max, 10 ) || 0;
				if ( max > 0 && group.querySelectorAll( '.bb-checks input:checked' ).length > max ) {
					c.checked = false;
					bbHintRefuse( group );
					return;
				}
			}
			bbNotes( group );
			group.dispatchEvent( new CustomEvent( 'bb-pick-change', { bubbles: true, detail: {} } ) );
			bbTotal();
		} );
		// A long set's list control (D6) is its own select: a change is the
		// pick. The note follows the chosen option exactly as it follows a
		// chip, the same pick event fires for the modules, and the total
		// refigures.
		document.addEventListener( 'change', function ( e ) {
			var s = e.target;
			if ( ! s || ! s.matches || ! s.matches( '.bb-standalone-options select.bb-list-sel' ) ) { return; }
			var group  = s.closest( '.bb-attr-group' );
			var noteEl = group ? group.querySelector( '.bb-opt-note' ) : null;
			if ( noteEl ) {
				var o = s.selectedOptions && s.selectedOptions[ 0 ];
				var t = ( s.value && o ) ? ( o.dataset.desc || '' ) : '';
				noteEl.innerHTML = t; // cleaned on the server, as in bbNotes.
				noteEl.hidden = ( '' === t );
			}
			if ( group ) { group.dispatchEvent( new CustomEvent( 'bb-pick-change', { bubbles: true, detail: {} } ) ); }
			bbTotal();
		} );
		// The reconciliation: product plus options equals total, one story
		// from the top of the page to the cart. The base is the product's
		// display price on a simple, the chosen variation's on a variable.
		var bbVarBase = null;
		// The chosen variation's own tax factor, where it is not the product's
		// (a zero-rated Kids size under a standard-rated product): the server
		// hands it over only then, so null means the product's own rate.
		var bbVarK = null;
		// The chosen variation's own tax rate in percent, sent whenever it is
		// not the product's (with or without bbVarK: a shop showing prices as
		// it enters them has no factor to send): the VAT toggle's other side is
		// worked out at it. null means the product's rate.
		var bbVarRate = null;
		// Whether the chosen variation prices at a rate of its own, by factor
		// or by rate: the labels are repainted for it either way.
		function bbVarOwn() { return !! bbVarK || null !== bbVarRate; }
		// The rate a figure on this page converts at for the toggle's other side.
		function bbRateNow( box ) {
			if ( null !== bbVarRate && isFinite( bbVarRate ) ) { return bbVarRate; }
			// ABSENCE, NEVER FALSINESS: a zero-rated product's own rate is 0.
			var r = box ? parseFloat( box.dataset.wtsRate ) : NaN;
			if ( isFinite( r ) ) { return r; }
			return parseFloat( ( window.wtsCompatibilityObject || {} ).baseTaxRate ) || 0;
		}
		// The rate the product being built answers the toggle at right now (the
		// chosen variation's own, else the product's), for a module that paints
		// its own figures: a quantity break's echo, a measured size's line.
		window.bbPageRate = function () { return bbRateNow( document.querySelector( '.bb-standalone-total' ) ); };
		// A figure printed at the product's rate, at the chosen variation's own
		// (bbVarFee below), for a module painting its own money.
		window.bbVarFeeAmt = function ( d ) {
			var box = document.querySelector( '.bb-standalone-total' );
			return box ? bbVarFee( box, d ) : d;
		};
		function bbFmt( box, amount ) {
			// The merchant's own money format, the same recipe the printed
			// prices use: separators, decimals and symbol position, so the
			// receipt's figures read exactly like the rest of the page.
			var neg = amount < 0;
			// Each of these is always printed, so an empty value is the
			// merchant's setting, not a missing attribute. Two of those
			// settings are falsy: a zero-decimal currency (SEK, JPY, HUF,
			// ISK) and a blank thousands separator. An `||` default
			// overrules precisely the merchants who chose them.
			var dec = parseInt( box.dataset.decimals, 10 );
			if ( ! isFinite( dec ) || dec < 0 ) { dec = 2; }
			var ts  = undefined === box.dataset.ts ? ',' : box.dataset.ts;
			var ds  = undefined === box.dataset.ds ? '.' : box.dataset.ds;
			var s   = Math.abs( window.bbMoneyRound( amount, dec ) ).toFixed( dec );
			var parts = s.split( '.' );
			parts[ 0 ] = parts[ 0 ].replace( /\B(?=(\d{3})+(?!\d))/g, ts );
			s = parts.join( ds );
			var sym = box.dataset.symbol || '', out;
			switch ( box.dataset.pos ) {
				case 'right': out = s + sym; break;
				case 'left_space': out = sym + ' ' + s; break;
				case 'right_space': out = s + ' ' + sym; break;
				default: out = sym + s;
			}
			return ( neg ? '-' : '' ) + out;
		}
		// VAT-toggle compatibility (Tax Switch for WooCommerce and its kind):
		// paint the toggle plugin's own dual-basis markup so a computed total
		// answers the ex/inc switch, exactly as the bundle total does. Without
		// it the number froze in one basis after every repaint.
		function bbToggleActive() {
			if ( window.wtsCompatibilityObject ) { return true; }
			var b = document.querySelector( ".bb-standalone-total" );
			return !! ( b && "1" === b.dataset.wts ); // the server said the toggle plugin runs here.
		}
		function bbEscape( s ) { var d = document.createElement( "i" ); d.textContent = String( s ); return d.innerHTML; }
		function bbOtherBasis( box, amount ) {
			// Our own server-computed rate first: the toggle plugin's compat
			// object only exists where one of its shims loads, and a page can
			// be covered in its dual prices without one (see data-wts).
			var f = 1 + bbRateNow( box ) / 100;
			return ( "incl" === box.dataset.taxBasis ) ? amount / f : amount * f;
		}
		<?php echo addon_boss_wts_reader_js(); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- a literal script fragment this plugin wrote. ?>
		function bbInclActive() {
			var box = document.querySelector( ".bb-standalone-total" );
			return bbWtsIncl( box ? ( box.dataset.taxBasis || "excl" ) : "excl" );
		}
		// other: the figure on the switch's other side when the caller knows it
		// better than a turn at the rate can (an offer's saving, worked out
		// by the basket on each side); otherwise it is turned here.
		function bbMoneyHTML( box, amount, other ) {
			var turned = isFinite( parseFloat( other ) ) ? parseFloat( other ) : bbOtherBasis( box, amount );
			var incl   = ( "incl" === box.dataset.taxBasis ) ? amount : turned;
			var excl   = ( "incl" === box.dataset.taxBasis ) ? turned : amount;
			var inclOn = bbInclActive(); // hide the off-basis side with wts-inactive, not just mark the shown side active (Tax Switch hides .wts-inactive)
			return "<span class=\"wts-price-container\"><span class=\"wts-price-wrapper\">"
				+ "<span class=\"wts-price-excl " + ( inclOn ? "wts-inactive" : "wts-active" ) + "\">" + bbEscape( bbFmt( box, excl ) ) + "</span>"
				+ "<span class=\"wts-price-incl " + ( inclOn ? "wts-active" : "wts-inactive" ) + "\">" + bbEscape( bbFmt( box, incl ) ) + "</span>"
				+ "</span></span>";
		}
		// Write money into an element; template may carry one %s ("%s total").
		// Plain textContent with no toggle plugin, dual markup with one.
		function bbSetMoney( el, box, amount, template ) {
			if ( ! el ) { return; }
			if ( ! bbToggleActive() ) {
				var text = bbFmt( box, amount );
				el.textContent = template ? template.replace( "%s", text ) : text;
				return;
			}
			var html = bbMoneyHTML( box, amount );
			el.innerHTML = template ? bbEscape( template ).replace( "%s", html ) : html;
		}
		// wdevs-tax-switch-changed: the toggle event for late painters. Re-point
		// every dual-basis price we drew (total, and the peek copy of it) to the
		// chosen side; both bases are already in the markup so we only move the
		// active/inactive classes, idempotent with the plugin document-wide pass.
		// Both figures of a toggle pair, from one amount in the shop's basis.
		function bbPaintPair( wrap, box, amount ) {
			var other = bbOtherBasis( box, amount );
			var shopIncl = "incl" === ( box.dataset.taxBasis || "excl" );
			var x = wrap.querySelector( ".wts-price-excl" ), i = wrap.querySelector( ".wts-price-incl" );
			if ( x ) { x.textContent = bbFmt( box, Math.abs( shopIncl ? other : amount ) ); }
			if ( i ) { i.textContent = bbFmt( box, Math.abs( shopIncl ? amount : other ) ); }
		}
		function bbRepointTax( incl ) {
			document.querySelectorAll( ".wts-price-wrapper" ).forEach( function ( w ) {
				var i = w.querySelector( ".wts-price-incl" ), x = w.querySelector( ".wts-price-excl" );
				if ( i ) { i.classList.toggle( "wts-active", incl ); i.classList.toggle( "wts-inactive", ! incl ); }
				if ( x ) { x.classList.toggle( "wts-active", ! incl ); x.classList.toggle( "wts-inactive", incl ); }
			} );
		}
		// A fee printed at the product's tax rate, at the chosen variation's
		// own where that differs: back to its entered penny, then forward. The
		// receipt prices the same fee by the same rule, so a label and its
		// receipt line read one figure.
		function bbVarFee( box, d ) {
			var k = parseFloat( box.dataset.bbK ) || 1;
			if ( ! bbVarK || bbVarK === k ) { return d; }
			return window.bbMoneyRound( d / k, parseInt( box.dataset.decimals, 10 ) ) * bbVarK;
		}
		// Set while the labels read a variation's own rate, so picking a
		// variation on the product's rate again paints them back.
		var bbVarPainted = false;
		// The same words for a module that paints its own figure (the print
		// positions' subtotal); null while there is nothing to convert.
		window.bbVarFeeWords = function ( d ) {
			var box = document.querySelector( ".bb-standalone-total" );
			return box && bbVarK && bbVarK !== ( parseFloat( box.dataset.bbK ) || 1 ) ? bbFmt( box, bbVarFee( box, d ) ) : null;
		};
		function bbVarFees() {
			if ( ! bbVarOwn() && ! bbVarPainted ) { return; }
			bbVarPainted = bbVarOwn();
			bbSyncChoiceFees( bbInclActive(), true );
			try { document.dispatchEvent( new Event( "bb-var-rate" ) ); } catch ( e ) {}
			// A field's own fee and a print position's are labels with no figure
			// of their own to read back: their control carries the figure each
			// was printed from, and only the money in the words is rewritten.
			var box = document.querySelector( ".bb-standalone-total" );
			if ( ! box ) { return; }
			document.querySelectorAll( ".bb-addon-field .bb-addon-fee .woocommerce-Price-amount" ).forEach( function ( a ) {
				var f = a.closest( ".bb-addon-field" ).querySelector( "[data-bb-fee]" );
				var d = f ? ( parseFloat( f.dataset.bbFee ) || 0 ) * ( parseFloat( box.dataset.bbK ) || 1 ) : NaN; // entered, shown at the product's rate.
				if ( ! ( d > 0 ) ) { return; }
				// A pair the toggle plugin wrote is rewritten at the variation's rate.
				var w = a.querySelector( ".wts-price-wrapper" );
				if ( w ) { bbPaintPair( w, box, bbVarFee( box, d ) ); return; }
				a.textContent = bbFmt( box, bbVarFee( box, d ) );
			} );
			document.querySelectorAll( ".bb-pp-tile[data-bb-fee] .bb-pp-fee" ).forEach( function ( s ) {
				var d = parseFloat( s.closest( ".bb-pp-tile" ).getAttribute( "data-bb-fee" ) );
				if ( ! ( d > 0 ) ) { return; }
				if ( undefined === s.dataset.bbWords ) { s.dataset.bbWords = s.textContent; }
				s.textContent = s.dataset.bbWords.replace( bbFmt( box, d ), bbFmt( box, bbVarFee( box, d ) ) );
			} );
		}
		// The labels a shopper reads BEFORE picking: "Hat box (+£9.00)" in a
		// dropdown, the badge on a chip or a tick row. The server writes them
		// once, in the shop's own basis, so on their own they cannot answer the
		// VAT toggle: the dropdown went on promising +£9.00 while the receipt
		// line under it, which does answer, charged £10.80. Two figures for one
		// choice, on one screen.
		//
		// The dual-basis pair cannot be planted here the way it is in the total:
		// an <option> holds TEXT, not elements, so there is nowhere to hang the
		// toggle plugin's incl/excl spans. The figure is recomputed instead from
		// the data-delta already riding every control in the shop's basis, in
		// the voice data-pmode names (a whole price, or a bump).
		//
		// A badge the toggle plugin already turned into its own pair is left
		// alone: it answers the switch by itself, and overwriting it with flat
		// text would take that away.
		//
		// The same repaint answers a variation on its own tax rate (force, or
		// a factor in bbVarK): see bbVarFees() above.
		function bbSyncChoiceFees( incl, force ) {
			var box = document.querySelector( ".bb-standalone-total" );
			if ( ! box || ( ! bbToggleActive() && ! force && ! bbVarOwn() ) ) { return; }
			var shopIncl = "incl" === ( box.dataset.taxBasis || "excl" );
			var base     = parseFloat( box.dataset.base );
			var flip     = bbToggleActive() && incl !== shopIncl;
			// Document-wide, not just the option-set root: a personalisation
			// field is drawn by its own renderer and can sit outside it. The
			// early return above already confines this to a standalone product
			// page carrying our receipt.
			document.querySelectorAll( "[data-delta]" ).forEach( function ( el ) {
				// An <option> asks its own <select> and nothing else. Falling
				// back to the group would send a personalisation dropdown, which
				// sits outside every attribute group, to the whole document, and
				// there it borrowed the voice of whichever priced set happened to
				// render first: a "+£3.00" printed as a whole price.
				// The control's OWN host first, walking up. Searching a group for
				// the first priced thing in it answers correctly only while a group
				// holds one; a colour field beside a chip row borrowed the chip
				// row's voice. Walking up asks the element which host it is in,
				// which is the question that was meant all along.
				var host = "OPTION" === el.tagName
					? el.closest( "select" )
					: ( el.closest( "[data-pmode]" )
						|| ( el.closest( ".bb-attr-group" ) || document )
							.querySelector( ".bb-chips[data-pmode], .bb-checks[data-pmode], select[data-pmode], .bb-price-chips[data-pmode]" ) );
				var pmode = ( host && host.dataset ) ? ( host.dataset.pmode || "delta" ) : "delta";
				if ( "hidden" === pmode ) { return; }
				// An answer that shows a size priced by what is typed prints no figure.
				if ( el.dataset && el.dataset.bbQuiet ) { return; }
				var d = parseFloat( el.dataset.delta );
				if ( isNaN( d ) ) { return; }
				// A suggested amount is the figure that goes in the box, in the
				// basis the shopper types; every other figure is a fee.
				if ( "whole" !== pmode ) { d = bbVarFee( box, d ); }
				// The same figure in the shop's basis, before any flip, for a badge
				// that carries the toggle plugin's own pair (bbPaintPair below).
				var dPair = d;
				var adjPair = parseFloat( el.dataset.bbAdjAmt );
				if ( ! isNaN( adjPair ) && 0 !== adjPair ) { dPair += bbVarFee( box, adjPair ); }
				if ( "full" === pmode && ! isNaN( base ) ) { dPair += base; }
				if ( flip ) { d = bbOtherBasis( box, d ); }
				var text = "";
				if ( "full" === pmode && ! isNaN( base ) ) {
					text = bbFmt( box, ( flip ? bbOtherBasis( box, base ) : base ) + d );
				} else if ( "delta" === pmode ) {
					// A price table's adjustment the choice triggers says itself
					// too: its flat money joins the figure, and its percentage
					// follows in the words the server printed.
					var adj = parseFloat( el.dataset.bbAdjAmt );
					if ( ! isNaN( adj ) && 0 !== adj ) { adj = bbVarFee( box, adj ); d += flip ? bbOtherBasis( box, adj ) : adj; }
					if ( 0 !== d ) { text = ( d > 0 ? "+" : "-" ) + bbFmt( box, Math.abs( d ) ); }
					if ( el.dataset.bbAdjTail ) { text = text ? text + " " + el.dataset.bbAdjTail : el.dataset.bbAdjTail; }
				} else if ( "whole" === pmode ) {
					// A suggested amount stands on its own: no sign, no base
					// added. The chip said GBP 2.00 while pressing it put GBP
					// 2.40 on the receipt beside it, which is the two-figures
					// -for-one-choice fault this whole function exists to end.
					text = bbFmt( box, d );
				}
				if ( "OPTION" === el.tagName ) {
					el.textContent = ( el.dataset.label || el.textContent.replace( /\s*\(.*\)\s*$/, "" ) )
						+ ( text ? " (" + text + ")" : "" );
					return;
				}
				// A suggested amount IS its own label, so it has no badge beside
				// it to write into: the figure is the whole button. Where there IS
				// a badge, the words around it are the merchant's ("Minimum %s")
				// and only the figure inside may be rewritten.
				if ( "whole" === pmode ) {
					var only = el.querySelector && el.querySelector( ".bb-chip-delta" );
					if ( only ) {
						if ( text && ! only.querySelector( ".wts-price-wrapper" ) ) { only.textContent = text; }
						return;
					}
					if ( text && ! el.querySelector( ".wts-price-wrapper" ) ) { el.textContent = text; }
					return;
				}
				// A tick row's and a colour swatch's badge sits beside their input
				// in the label; a chip's sits inside the chip. Only an input looks
				// beside itself: a free chip has no badge, and looking beside it
				// found the priced chip next to it and blanked that one.
				var badge = ( el.querySelector && el.querySelector( ".bb-chip-delta" ) )
					|| ( "INPUT" === el.tagName && el.parentElement && el.parentElement.querySelector( ".bb-chip-delta" ) );
				if ( ! badge ) { return; }
				// The toggle plugin already wrote this badge as its own pair. It
				// answers the switch by itself, but at the PRODUCT's rate: on a
				// variation with a rate of its own (a zero-rated Kids size) both of
				// its figures are rewritten at the variation's, and put back when a
				// variation on the product's rate is picked again.
				var wrap = badge.querySelector( ".wts-price-wrapper" );
				if ( wrap ) {
					if ( ( bbVarOwn() || force ) && "whole" !== pmode ) { bbPaintPair( wrap, box, dPair ); }
					return;
				}
				badge.textContent = text;
				badge.hidden = "" === text;
			} );
			// A searchable dropdown keeps a COPY of its chosen option's text in a
			// visible input, and rewriting the <option> behind it does not touch
			// that copy. Say the repaint is finished so those boxes re-read it,
			// or the one figure a shopper is actually looking at is the one that
			// never moves.
			try { document.dispatchEvent( new CustomEvent( "bb-choice-fees-repainted" ) ); } catch ( e ) {}
		}
		document.addEventListener( "wdevs-tax-switch-changed", function ( ev ) {
			var d = ( ev && ev.detail ) || {};
			var incl = typeof d.displayIncludingTax === "boolean" ? d.displayIncludingTax
				: typeof d.displayIncludingVat === "boolean" ? d.displayIncludingVat
				: bbInclActive();
			bbRepointTax( incl );
			bbSyncChoiceFees( incl );
		} );
		// On arrival too: the toggle remembers its answer per browser, so a
		// shopper who chose inc-VAT last visit lands on a page the server drew
		// in the shop's basis. Same reason the totals reconcile on boot.
		if ( "loading" === document.readyState ) {
			document.addEventListener( "DOMContentLoaded", function () { bbSyncChoiceFees( bbInclActive() ); } );
		} else {
			bbSyncChoiceFees( bbInclActive() );
		}
		// The quantity being bought, read from the THEME'S OWN field (the same
		// selector the repeat script follows), because a second quantity control
		// of ours is how these plugins break on page builders. The live total
		// multiplies exactly as the cart will: at qty 3 a page quoting one
		// unit's figure while the cart adds three units' worth is the
		// category's classic one-star trigger.
		function bbQty() {
			var root = document.querySelector( '.bb-standalone-options' );
			var form = ( root && root.closest ) ? root.closest( 'form' ) : null;
			if ( ! form ) { form = document.querySelector( 'form.cart' ); }
			var q = form ? form.querySelector( 'input.qty, input[name="quantity"]' ) : null;
			return q ? Math.max( 1, parseInt( q.value, 10 ) || 1 ) : 1;
		}
		// A field restricted to certain variations is INERT for the rest: the
		// server never requires it and never charges it, so the page must not
		// gate on it, count it or price it either. No variation chosen yet
		// means the field stands, the server's own rule.
		function bbVarInert( group ) {
			var only = ( group.dataset.bbVars || '' ).trim();
			if ( ! only ) { return false; }
			var form = group.closest ? group.closest( 'form' ) : null;
			var vin  = form ? form.querySelector( 'input[name="variation_id"]' ) : null;
			var vid  = vin ? parseInt( vin.value, 10 ) || 0 : 0;
			if ( vid <= 0 ) { return false; }
			return ( ',' + only + ',' ).indexOf( ',' + vid + ',' ) < 0;
		}
		// A money cell for one receipt line: plain text normally, the VAT
		// toggle plugin's dual-basis markup when one is on, exactly as
		// bbSetMoney paints the total itself.
		function bbMoneyCell( box, amount, other ) {
			return bbToggleActive() ? bbMoneyHTML( box, amount, other ) : bbEscape( bbFmt( box, amount ) );
		}
		// An offer's figures on the switch's other side: its saving as the
		// basket works it out there (saveOther), and the total turned and
		// rounded less that. A fifth on top of the saving read £7.00 where a
		// £13.99 hoodie at half price saves £6.99 with VAT. now: this side's
		// figure the same way, the total rounded less the saving, so the line
		// above and the figure under it add up.
		function bbAdjOther( box, total, save, other ) {
			var dec = parseInt( box.dataset.decimals, 10 );
			if ( ! isFinite( dec ) || dec < 0 ) { dec = 2; }
			var out = { now: window.bbMoneyRound( total, dec ) - save, save: undefined, total: undefined };
			if ( isFinite( parseFloat( other ) ) ) {
				out.save  = parseFloat( other );
				out.total = window.bbMoneyRound( bbOtherBasis( box, total ), dec ) - out.save;
			}
			return out;
		}
		// ANOTHER PLUGIN'S WORD ON THE TOTAL. An offer changes what the basket
		// charges (buy 2, get 1 half price: three hoodies at £102 come to £87),
		// and only the plugin that runs it knows by how much. So each time the
		// figure is drawn, window.addonBossTotalAdjust is asked with it, and the
		// first answer wins: { save, label, note, saveLbl } takes save off the
		// figure on a line of its own; { nudge: { lead, save, tpl } } says what
		// one more would save. Its money is in the figure's basis and its words
		// are its own; the drawing is ours. A plugin that throws is passed over.
		function bbTotalAdjust( ctx ) {
			var got = null;
			( window.addonBossTotalAdjust || [] ).some( function ( f ) {
				try { got = 'function' === typeof f ? f( ctx ) || null : null; } catch ( e ) { got = null; }
				return !! got;
			} );
			if ( ! got ) { return null; }
			got.save = parseFloat( got.save ) || 0;
			if ( got.nudge ) { got.nudge.save = parseFloat( got.nudge.save ) || 0; }
			return got;
		}
		function bbOfferIco() { return '<svg class="bb-st-ico" viewBox="0 0 24 24" aria-hidden="true" focusable="false"><path d="M3 12V4h8l10 10-8 8z"/><circle cx="7.5" cy="8.5" r="1.3"/></svg>'; }
		// Under the figure: what the offer saves, or what one more would.
		function bbAdjFoot( box, adj ) {
			var row  = box.querySelector( '.bb-st-row' );
			var foot = box.querySelector( '.bb-st-adj' );
			if ( ! row ) { return; }
			if ( ! foot ) {
				foot = document.createElement( 'div' );
				foot.className = 'bb-st-adj';
				row.parentNode.insertBefore( foot, row.nextSibling );
			}
			var html = '';
			if ( adj && adj.save > 0 && adj.saveLbl ) {
				html = '<span class="bb-st-save">' + bbEscape( adj.saveLbl ) + ' ' + bbMoneyCell( box, adj.save, adj.saveOther ) + '</span>';
			} else if ( adj && adj.nudge && adj.nudge.save > 0 && adj.nudge.lead ) {
				html = '<div class="bb-st-nudge">' + bbOfferIco() + '<span>' + bbEscape( adj.nudge.lead ) + ': <b>'
					+ bbEscape( adj.nudge.tpl || '%s' ).replace( '%s', bbMoneyCell( box, adj.nudge.save, adj.nudge.saveOther ) ) + '</b></span></div>';
			}
			if ( foot.innerHTML !== html ) { foot.innerHTML = html; }
			foot.hidden = '' === html;
		}
		// The label a fee-bearing FIELD control lines under: the field's own
		// label (its first text node, before the Required word and the
		// counter), or the tick-box's caption.
		function bbFeeLabel( el ) {
			var f = el.closest ? el.closest( '.bb-addon-field' ) : null;
			if ( ! f ) { return ''; }
			var lab = f.querySelector( '.bb-addon-label' ) || f.querySelector( '.bb-addon-check span' );
			if ( ! lab ) { return ''; }
			var n = lab.childNodes[ 0 ];
			return ( ( n && 3 === n.nodeType ) ? n.nodeValue : ( lab.textContent || '' ) ).trim();
		}
		// What a repeatable field's instances are collectively called, read
		// off the wrap's own naming pattern ("Engraving %d" -> "Engraving"),
		// so the receipt speaks the merchant's word for the thing.
		// The question a pick answers: its group's own name, before the Required
		// or optional word, so a receipt line reads "Poster size: A3".
		function bbQName( el ) {
			var g = el && el.closest ? el.closest( '.bb-attr-group' ) : null;
			var h = g ? g.querySelector( '.bb-attr-name' ) : null;
			if ( ! h ) { return ''; }
			var t = h.childNodes[ 0 ];
			return ( ( t && 3 === t.nodeType ) ? t.nodeValue : ( h.textContent || '' ) ).trim();
		}
		function bbRepThing( wrap ) {
			return ( wrap.getAttribute( 'data-bb-repeat-label' ) || '' ).replace( '%d', '' ).trim();
		}
		function bbTotal() {
			var box = document.querySelector( '.bb-standalone-total' );
			if ( ! box ) { return; }
			// Two pots, exactly the split the price seam makes: per-unit money
			// multiplies by the quantity; whole-line money joins the total once
			// however many are bought (the server spreads it across the units,
			// so per-unit times quantity lands back on this same figure).
			// Alongside the figure, the same walk now collects the receipt's
			// per-source lines, so the breakdown and the total are one pass
			// and can never disagree.
			var opts = 0;
			var flat = 0;
			var perLines  = []; // per-unit sources: multiply with the quantity.
			var flatLines = []; // whole-line sources: once for the line.
			var repAgg    = []; // repeatable fields, aggregated per wrap.
			var sizeTexts  = []; // a measured or table size joins the BASE line.
			var sizeCharge = 0;
			var qdOff      = 0; // per unit: what a quantity break takes off, the item and its option fees.
			var fromCharge = 0; // a required whole-price size not picked yet: its cheapest.
			var fromSeen   = false;
			// The base line's words in PAGE order, each with the control it
			// came from: a free pick and a size wherever each sits on the page.
			// They read picks first and sizes last ("Dibond Sign Board, Matt,
			// Height 450mm × Width 600mm") while the cart read page order
			// (tester round 4).
			var baseBits   = [];
			// A free pick whose price table adjustment has a line of its own on
			// the receipt ("Spot UV +15%") is named by that line. On the base
			// line it read as if the size's price held it: "Business cards, Spot
			// UV, Quantity 100, Finish Matt £19.50" (tester round 4).
			function bbAdjLined( field, value ) {
				if ( ! field || ! value ) { return false; }
				var ls = document.querySelectorAll( '.bb-tbl-adjfee[data-bb-adj-field="' + field + '"]' );
				for ( var i = 0; i < ls.length; i++ ) {
					if ( ls[ i ].dataset.bbAdjValue === value && 0 !== ( parseFloat( ls[ i ].dataset.bbXfee ) || 0 ) ) { return true; }
				}
				return false;
			}
			// FIELD answers that cost nothing. A free CHIP joins the base line
			// ("Team shirt, M, Navy") because a colour is part of what the thing
			// IS; a field's answer is not. A delivery date, a name to engrave and
			// a quantity are things the shopper decided, and a receipt that lists
			// only what costs money leaves them off the page entirely: a rush
			// charge then reads as "Sooner than usual, 40.00" with nothing saying
			// which day it bought. These get their own lines, with no money in
			// the amount column.
			var freeLines  = [];
			// The human answer behind a control: the words a shopper would use,
			// not the posted value. A date input holds ISO, a select holds a
			// slug, and neither is what they picked as far as they are concerned.
			function bbFreeAnswer( el ) {
				if ( 'SELECT' === el.tagName ) {
					var o = el.selectedOptions && el.selectedOptions[ 0 ];
					return o ? String( o.textContent || '' ).replace( /\s*\([^)]*\)\s*$/, '' ).trim() : '';
				}
				if ( 'radio' === el.type || 'checkbox' === el.type ) {
					var lab = el.closest ? el.closest( 'label' ) : null;
					// A ticked box says everything by being ticked; its label is
					// already the line's name, so it needs no second word.
					return 'checkbox' === el.type ? '' : ( lab ? String( lab.textContent || '' ).replace( /\s*\([^)]*\)\s*$/, '' ).trim() : String( el.value || '' ) );
				}
				// AN UPLOAD IS NAMED BY ITS NAME. The field posts a storage
				// reference ("O6vnCpL2ZkXnnIca/bossmage-logo.png"), and the total
				// box printed that folder beside the line while the upload box
				// above it said "bossmage-logo.png" (#102). Say what the upload
				// box says; failing that, the name the server sent; failing that,
				// the last part of each reference, never the folder.
				if ( el.classList && el.classList.contains( 'bb-addon-file-ref' ) ) {
					if ( '' === String( el.value || '' ).trim() ) { return ''; }
					var upWrap  = el.closest ? ( el.closest( '.bb-addon-upload' ) || el.closest( '.bb-addon-field' ) ) : null;
					var upNames = [];
					if ( upWrap ) {
						upWrap.querySelectorAll( '.bb-file-fn' ).forEach( function ( f ) {
							var t = String( f.textContent || '' ).trim();
							if ( t ) { upNames.push( t ); }
						} );
					}
					if ( upNames.length ) { return upNames.join( ', ' ); }
					if ( el.dataset && el.dataset.bbFilename ) { return el.dataset.bbFilename; }
					return String( el.value ).split( ',' ).map( function ( r ) {
						r = r.trim();
						return r.slice( r.lastIndexOf( '/' ) + 1 );
					} ).filter( function ( r ) { return '' !== r; } ).join( ', ' );
				}
				// A MEASURED FIELD STORES ITS AREA, and the area is not the answer.
				// A 124 by 123 plaque was read back as "Plaque size 15252": a number
				// the shopper never typed, that no workshop can cut to, and that
				// changes unit silently the moment the merchant switches from cm to
				// m. Say back the two figures they entered, with the unit beside
				// them, exactly as the field asked for them. (His find, 7 Sept.)
				var bbFld = el.closest ? el.closest( '.bb-addon-field' ) : null;
				var bbW   = bbFld && bbFld.querySelector( '.bb-size-w' );
				var bbH   = bbFld && bbFld.querySelector( '.bb-size-h' );
				if ( bbW && bbH ) {
					if ( ! bbW.value || ! bbH.value ) { return ''; }
					var bbUn = bbFld.querySelector( '.bb-size-unit' );
					return bbW.value + ' × ' + bbH.value + ( bbUn ? ' ' + bbUn.textContent.trim() : '' );
				}
				var v = String( el.value || '' ).trim();
				// AN AMOUNT THEY NAMED IS MONEY, and reads as money. The receipt
				// said "Add a tip for the maker 5" beside a charge of GBP 6.00,
				// while the cart the same answer reaches says "GBP 5.00". One
				// answer, two spellings, and the bare number reads like a quantity.
				// In the entry basis, because that is the basis they typed it in.
				if ( undefined !== el.dataset.bbOwnAmount ) {
					var ownN = bbOwnNum( v );
					if ( ! isFinite( ownN ) || ownN <= 0 ) { return ''; }
					var ownBox = document.querySelector( '.bb-standalone-total' );
					return ownBox ? bbFmt( ownBox, ownN ) : v;
				}
				if ( 'date' === el.type && /^\d{4}-\d{2}-\d{2}$/.test( v ) ) {
					// Read back in the shopper's own locale. The cart and the order
					// carry the store's format; this panel is the live estimate.
					var d = new Date( v + 'T12:00:00' );
					if ( ! isNaN( d.getTime() ) ) {
						return d.toLocaleDateString( undefined, { weekday: 'short', day: 'numeric', month: 'short', year: 'numeric' } );
					}
				}
				return v;
			}
			// One receipt line for an answer that cost nothing. Deduped by field,
			// because a group's block can hold the same control more than once.
			function bbFreeLine( el ) {
				var filled = ( 'checkbox' === el.type ) ? el.checked : ( String( el.value || '' ).trim() !== '' );
				if ( ! filled ) { return; }
				if ( el.closest && el.closest( '.bb-repeat' ) ) { return; } // instances aggregate elsewhere
				// A field that is CHARGING for this answer says it once, on its
				// charge line, where the money is. Without this a date field
				// printed twice over: a free line naming the field, and a charge
				// line beside it (his find, 6 September). A free answer on the
				// same field still lands here, because then no charge line
				// exists to carry it.
				var fld = el.closest ? el.closest( '.bb-addon-field' ) : null;
				var own = fld ? fld.querySelector( '.bb-pp-xfee[data-bb-xfee]' ) : null;
				if ( own && 0 !== ( parseFloat( own.dataset.bbXfee ) || 0 ) ) { return; }
				var n = bbFeeLabel( el );
				if ( ! n ) { return; }
				var a = bbFreeAnswer( el );
				for ( var i = 0; i < freeLines.length; i++ ) {
					if ( freeLines[ i ].n === n && freeLines[ i ].v === a ) { return; }
				}
				freeLines.push( { el: el, n: n, v: a } );
			}
			// The client half of the price-parts seam: a module may take a share
			// off PER-UNIT option money (the quantity-discount toggle), exactly
			// as the server's parts filter does, and the same figure feeds the
			// line and the total so the receipt still reconciles. Whole-line
			// money is never offered to it, and a module's own negative store
			// charge passes through each function's own sign guard untouched.
			// Empty by default: a no-op.
			// Alongside the share cut, keep the RAW per-unit fee sum. Every
			// per-unit fee source passes through here exactly once (whole-line
			// money is guarded away at every call site), so this one line is
			// the whole accounting. Positive only: a module's own negative
			// store charge (the quantity-discount share) is a reduction of the
			// base, not an option fee, and counting it would fold the discount
			// into the very figure other modules price options FROM.
			var bbRawUnit = 0;
			var bbRawPos  = 0;
			var bbRawUnitList = [];
			var bbRawPosList  = [];
			// EVERY PRICE IS MULTIPLIED FROM ITS ENTERED PENNY. Where the shop
			// shows prices in the other tax basis, a shown unit price is already
			// rounded (13.34 shows as 16.01) and the basket taxes the line
			// (four are 64.03, not four times 16.01). Each figure this walk
			// reads is put back on its entered penny first, so the lines and the
			// total below are the basket's. One basis, or no tax: unchanged.
			var bbK    = parseFloat( box.dataset.bbK ) || 1;
			var bbKDec = parseInt( box.dataset.decimals, 10 );
			// A VARIATION ON ITS OWN TAX RATE. Every fee here was printed at the
			// product's rate and the basket taxes the line at the chosen
			// variation's: a zero-rated Kids size at £10 with a £5 print read
			// £16 and was charged £15. So a fee goes back to its entered penny
			// at the product's rate and comes forward at the variation's, and
			// the variation's own price, shown at its own rate, stays on it.
			// The same rate, which is every product whose variations share
			// its tax class: exactly as before.
			var bbKv   = bbVarK || bbK;
			function bbX( a ) {
				if ( bbKv === bbK ) { return 1 === bbK ? a : window.bbTaxExact( a, bbK, bbKDec ); }
				return window.bbMoneyRound( a / bbK, bbKDec ) * bbKv;
			}
			function bbXv( a ) { return 1 === bbKv ? a : window.bbTaxExact( a, bbKv, bbKDec ); }
			function bbFeeShare( a, kind ) {
				kind = kind || 'opt';
				// ...and each fee on its own, for a module that rounds its share
				// fee by fee (a percentage break): the sum cannot say where one
				// fee ends and the next begins.
				if ( a > 0 ) { if ( 'pos' === kind ) { bbRawPos += a; bbRawPosList.push( a ); } else { bbRawUnit += a; bbRawUnitList.push( a ); } }
				var whole = a;
				( window.addonBossFeeShare || [] ).forEach( function ( f ) { a = f( a, kind ); } );
				// What a quantity break took off this fee, for the total's "You save".
				if ( whole > 0 && a < whole ) { qdOff += bbX( whole ) - bbX( a ); }
				return bbX( a );
			}
			// A set the shop charges once for the line (its group wears
			// data-bb-once) is whole-line money: it joins flat, never the
			// per-unit sum a module discounts or the quantity multiplies.
			// The server spreads the same charge across the units.
			function bbOnceGroup( el ) {
				var g = el.closest ? el.closest( '.bb-attr-group' ) : null;
				return !! ( g && '1' === ( g.dataset.bbOnce || '' ) );
			}
			function bbOnceLine( el, label ) {
				var od = bbX( parseFloat( el.dataset.delta ) || 0 );
				flat += od;
				if ( 0 !== od ) { flatLines.push( { el: el, n: bbQName( el ), v: label || '', a: od } ); }
			}
			document.querySelectorAll( '.bb-standalone-options .bb-attr-group:not([hidden]):not(.bb-glocked) .bb-chip.is-selected[data-delta]' ).forEach( function ( c ) {
				if ( bbOnceGroup( c ) && 0 !== ( parseFloat( c.dataset.delta ) || 0 ) ) {
					if ( ! c.closest( '.bb-style-chips' ) ) { bbOnceLine( c, c.dataset.label ); }
					return;
				}
				var d = bbFeeShare( parseFloat( c.dataset.delta ) || 0 );
				opts += d;
				if ( 0 !== d && ! c.closest( '.bb-style-chips' ) ) {
					perLines.push( { el: c, n: bbQName( c ), v: c.dataset.label || '', a: d } );
				} else if ( 0 === d && ! c.closest( '.bb-style-chips' ) && c.dataset.label ) {
					// A free pick earns no line of its own, but it IS what is
					// being bought: the colour and the size join the base line,
					// so the receipt says "Team shirt, M, Navy", not just the
					// product's name.
					var cf = c.closest( '.bb-chips[data-for-select]' );
					if ( bbAdjLined( cf ? cf.getAttribute( 'data-for-select' ) : '', c.dataset.value || '' ) ) { return; }
					baseBits.push( { el: c, n: c.dataset.label } );
				}
			} );
			// A long set's list control (D6): the chosen option carries the same
			// display-basis delta a chip would, and lines under its own label.
			document.querySelectorAll( '.bb-standalone-options .bb-attr-group:not([hidden]):not(.bb-glocked) select.bb-list-sel' ).forEach( function ( s ) {
				var o = s.selectedOptions && s.selectedOptions[ 0 ];
				if ( ! s.value || ! o ) { return; }
				if ( bbOnceGroup( s ) && 0 !== ( parseFloat( o.dataset.delta ) || 0 ) ) { bbOnceLine( o, o.dataset.label ); return; }
				var d = bbFeeShare( parseFloat( o.dataset.delta ) || 0 );
				opts += d;
				if ( 0 !== d ) {
					perLines.push( { el: s, n: bbQName( s ), v: o.dataset.label || '', a: d } );
				} else if ( o.dataset.label && ! bbAdjLined( s.getAttribute( 'data-attribute' ) || '', o.value ) ) {
					baseBits.push( { el: s, n: o.dataset.label } );
				}
			} );
			// A several-of long set's checkbox rows: every tick adds its own
			// fee and lines under its own label, exactly like a selected chip.
			document.querySelectorAll( '.bb-standalone-options .bb-attr-group:not([hidden]):not(.bb-glocked) .bb-checks input:checked[data-delta]' ).forEach( function ( c ) {
				if ( bbOnceGroup( c ) && 0 !== ( parseFloat( c.dataset.delta ) || 0 ) ) { bbOnceLine( c, c.dataset.label ); return; }
				var d = bbFeeShare( parseFloat( c.dataset.delta ) || 0 );
				opts += d;
				if ( 0 !== d ) {
					perLines.push( { el: c, n: bbQName( c ), v: c.dataset.label || '', a: d } );
				}
			} );
				// A module that computes its own live figure (a measured size, a
				// price-table cell) writes it onto its store element as
				// data-bb-live-charge; this driver only ever reads the number. The
				// words for the receipt ride beside it as data-bb-size-text, so a
				// priced size joins the base line the way the group itself tells
				// the band-price story.
				document.querySelectorAll( '.bb-standalone-options .bb-attr-group:not([hidden]):not(.bb-glocked) [data-bb-live-charge]' ).forEach( function ( g ) {
					var c = bbFeeShare( parseFloat( g.dataset.bbLiveCharge ) || 0 );
					opts += c;
					// A quantity break's store carries what the break takes off the
					// item (a negative charge): the item's part of "You save".
					if ( c < 0 && g.classList.contains( 'bb-qdx-store' ) ) { qdOff -= c; }
					if ( '' !== ( g.dataset.bbLiveCharge || '' ) ) {
						sizeCharge += c;
						if ( g.dataset.bbSizeText ) {
							sizeTexts.push( g.dataset.bbSizeText );
							baseBits.push( { el: g, n: g.dataset.bbSizeText } );
						}
					}
				} );
				// A required size that sets the whole price and is not picked
				// yet: the line and the total start at its cheapest size and say
				// "from", never the product's own price below every size. Its
				// store's echo is empty until a size is whole. Not a charge, so
				// nothing that prices around the options ever reads it.
				document.querySelectorAll( '.bb-standalone-options .bb-attr-group[data-bb-from-charge]:not([hidden]):not(.bb-glocked)' ).forEach( function ( g ) {
					var st = g.querySelector( '[data-bb-echo]' );
					// A size typed while a choice its price waits on is not made
					// yet (data-bb-wait) is no price either: still "from".
					if ( st && '' !== ( st.dataset.bbEcho || '' ) && ! st.dataset.bbWait ) { return; }
					fromCharge += bbX( parseFloat( g.dataset.bbFromCharge ) || 0 );
					fromSeen = true;
				} );
				// Product-field fees, one CONTROL at a time, each priced by the
				// same rule the server charges by. A dropdown prices by its CHOSEN
				// option only (every option carries its own fee, and summing the
				// lot as descendants was the every-option bug). A mode whose maths
				// lives in a module pre-computes onto data-bb-live-fee and this
				// driver reads that instead; a filled or ticked flat fee adds as
				// itself. Per-unit charges multiply with the quantity. Two things
				// are whole-line money and join FLAT instead: a 'once' fee (a
				// setup charge for the line however many are bought), and any
				// instance of a per-item repeatable field, whose instances
				// already scale with the quantity and must not be multiplied by
				// it a second time. This is the live estimate; the server
				// re-resolves the exact charge at add-to-cart (spreading
				// once-fees, rejecting tampering).
				var bbWholeLine = function ( el, mode ) {
					if ( 'once' === mode ) { return true; }
					// A once-mode DROPDOWN wears mode "select" (price by the
					// chosen option), so its whole-line fact rides the marker.
					if ( el.dataset && '1' === ( el.dataset.bbFeeOnce || '' ) ) { return true; }
					return !! ( el.closest && el.closest( '.bb-repeat[data-bb-repeat="per_item"]' ) );
				};
				// One receipt entry for a fee a field control earned. Instances
				// of a repeatable field aggregate under their wrap ("2 ×
				// engraving"); everything else lines under the field's label.
				// The count is INSTANCES, not controls: a group's block holds
				// several priced fields and is still one engraving.
				var bbFeeLine = function ( el, due, whole ) {
					if ( due <= 0 ) { return; }
					var wrap = el.closest ? el.closest( '.bb-repeat' ) : null;
					if ( wrap ) {
						var it = el.closest( '[data-bb-repeat-item]' );
						for ( var ri = 0; ri < repAgg.length; ri++ ) {
							if ( repAgg[ ri ].wrap === wrap ) {
								repAgg[ ri ].sum += due;
								if ( it && -1 === repAgg[ ri ].items.indexOf( it ) ) { repAgg[ ri ].items.push( it ); }
								return;
							}
						}
						repAgg.push( { wrap: wrap, items: it ? [ it ] : [], sum: due, whole: whole } );
						return;
					}
					// The answer rides with the charge. A free pick already names
					// itself on its own line, so a shopper who picked noon read
					// "Collection time: 12:00 pm" while one who picked half nine
					// read "Collection time  £4.00" and was never told which time
					// they were paying for. Same helper the free line uses, so the
					// two read alike; a ticked box still answers with nothing,
					// because being ticked is the whole answer.
					( whole ? flatLines : perLines ).push( { el: el, n: bbFeeLabel( el ), v: bbFreeAnswer( el ), a: due, own: !! ( el.dataset && el.dataset.bbOwnAmount ) } );
				};
				// A field's fee rides its control as ENTERED: data-bb-fee stays the
				// stored figure, because the fee modes, the repeats and the size
				// fields price from it. Read as if it were shown, a £5 + VAT name
				// field counted £5.00 here beside its own "+£6.00" label, and the
				// basket took £6.00. So it is shown at the product's rate first,
				// like every other figure this walk reads. One basis: unchanged.
				document.querySelectorAll( '.bb-standalone-options .bb-attr-group:not([hidden]):not(.bb-glocked) [data-bb-fee]' ).forEach( function ( el ) {
					// A field inert for the chosen variation never charges, so its
					// fee must leave the figure the moment that variation is picked.
					var vg = el.closest ? el.closest( '.bb-attr-group' ) : null;
					if ( vg && bbVarInert( vg ) ) { return; }
					if ( 'OPTION' === el.tagName ) { return; } // priced through its select, below.
					if ( 'SELECT' === el.tagName ) {
						var opt = el.selectedOptions && el.selectedOptions[ 0 ];
						if ( el.value && opt ) {
							var sfee  = ( parseFloat( opt.dataset.bbFee ) || 0 ) * bbK;
							var swhole = bbWholeLine( el, el.dataset.bbFeeMode || '' );
							sfee = swhole ? bbX( sfee ) : bbFeeShare( sfee );
							if ( swhole ) { flat += sfee; } else { opts += sfee; }
							bbFeeLine( el, sfee, swhole );
							// A free choice still says what was chosen.
							if ( sfee <= 0 ) { bbFreeLine( el ); }
						}
						return;
					}
					// A radio group prints its fee on every option; only the picked
					// one is money. Without this, an unpicked swatch's value (never
					// empty on a radio) would read as "filled" below and charge.
					if ( 'radio' === el.type && ! el.checked ) { return; }
					var fee = ( parseFloat( el.dataset.bbFee ) || 0 ) * bbK;
					if ( undefined !== el.dataset.bbOwnAmount ) {
						// THE TOTAL NEVER QUOTES A PRICE THE TILL WILL REFUSE.
						//
						// An amount outside the field's bounds used to ride into the total
						// like any other: type 500 against a maximum of 20 and the page
						// cheerfully offered a GBP 520 basket that could never be bought.
						// It now counts nothing and the receipt line says why instead of
						// showing a figure. The box still holds what was typed: that is the
						// shopper's text, and the field beside it is already saying no.
						// (His call, 7 Sept.)
						var ownBad = bbAmountRefused( el );
						if ( ownBad ) {
							var badName = bbFeeLabel( el );
							// The receipt says the same short sentence the field is showing. "Outside
							// the limits" was a fact, not an instruction: it told a shopper something
							// was wrong and nothing about how to make it right.
							if ( badName ) { freeLines.push( { n: badName, v: ownBad, bad: true } ); }
							return;
						}
						// The shopper's own typed amount IS the charge (name your price).
						// The server re-resolves and fences it at add-to-cart; this is
						// the honest live estimate, floored at zero like everywhere.
						//
						// The box speaks the CURRENT display basis, and this total is
						// computed in the RENDER basis with the toggle picking a side at
						// the end, so a figure typed after a live flip converts here or
						// the one hand-typed number on the page rides in the wrong basis.
						var ownAmt   = bbOwnNum( el.value ) || 0;
						var ownBox   = document.querySelector( '.bb-standalone-total' );
						if ( ownBox && bbToggleActive() && ownAmt > 0 ) {
							var ownRenderIncl = 'incl' === ( ownBox.dataset.taxBasis || 'excl' );
							if ( bbInclActive() !== ownRenderIncl ) {
								var ownRate = bbRateNow( ownBox );
								var ownF    = 1 + ownRate / 100;
								ownAmt      = ownRenderIncl ? ownAmt * ownF : ownAmt / ownF;
							}
						}
						var ownMode  = el.dataset.bbFeeMode || '';
						var ownWhole = bbWholeLine( el, ownMode );
						var ownDue   = ownAmt > 0 ? ownAmt : 0;
						if ( ! ownWhole ) {
							// bbFeeShare reads a fee printed at the product's rate and moves
							// it to the chosen variation's. A typed amount is already the
							// figure on screen for this line, so it goes in at the product's
							// rate and comes out as typed: a £20 donation on a zero-rated
							// Kids size counted £24.00 before, and the till charged it.
							if ( bbKv !== bbK && ownDue > 0 ) { ownDue = ownDue / bbKv * bbK; }
							ownDue = bbFeeShare( ownDue );
						}
						if ( ownWhole ) { flat += ownDue; } else { opts += ownDue; }
						bbFeeLine( el, ownDue, ownWhole );
						return;
					}
					// Costs nothing, but they still answered it: the date, the
					// name, the count. Named on its own line with an empty
					// amount, so the receipt says what is being bought and not
					// merely what is being charged for.
					if ( fee <= 0 ) { bbFreeLine( el ); return; }
					var mode  = el.dataset.bbFeeMode || '';
					var whole = bbWholeLine( el, mode );
					var due   = 0;
					if ( undefined !== el.dataset.bbLiveFee ) {
						// A mode whose maths lives in a module pre-computed its
						// figure onto the control; this driver only reads it.
						due = ( parseFloat( el.dataset.bbLiveFee ) || 0 ) * bbK;
					} else {
						var filled = ( 'checkbox' === el.type ) ? el.checked : ( ( el.value || '' ).trim() !== '' );
						if ( filled ) { due = fee; }
					}
					due = whole ? bbX( due ) : bbFeeShare( due );
					if ( whole ) { flat += due; } else { opts += due; }
					bbFeeLine( el, due, whole );
				} );
				// Fees a companion module (positions) pre-computed and tagged by
				// mode. The receipt is the one true total on the page, so it folds
				// them in with the SAME once-versus-per-item rule its own fields
				// use: a 'once' fee joins the flat whole-line money, a per-item fee
				// joins opts and multiplies with the quantity. The server re-resolves
				// the exact charge at add-to-cart; this is the honest live estimate.
				document.querySelectorAll( '.bb-pp-xfee[data-bb-xfee]' ).forEach( function ( el ) {
					var xamt = parseFloat( el.dataset.bbXfee ) || 0;
					// Zero is silence; a NEGATIVE line is a table adjustment's
					// deduction and reads on the receipt like any named line.
					if ( 0 === xamt ) { return; }
					var xwhole = 'once' === ( el.dataset.bbXfeeMode || '' );
					var xdue   = xwhole ? bbX( xamt ) : bbFeeShare( xamt, 'pos' );
					if ( xwhole ) { flat += xdue; } else { opts += xdue; }
					// A price table's price change hangs off the table, but it belongs
					// to the choice that sets it off ("Spot UV" in Card extras): the
					// receipt names it by that choice's question and lists it in that
					// question's place (QA walk, 19 Oct 2026).
					var xel = el;
					var xn  = el.dataset.bbXfeeLabel || '';
					var xv  = '';
					if ( el.classList.contains( 'bb-tbl-adjfee' ) && el.dataset.bbAdjField ) {
						var xesc = ( window.CSS && window.CSS.escape ) ? window.CSS.escape : function ( v ) { return v; };
						var xf   = xesc( el.dataset.bbAdjField );
						var xval = xesc( el.dataset.bbAdjValue || '' );
						var xa   = document.querySelector( '.bb-chips[data-for-select="' + xf + '"] .bb-chip.is-selected[data-value="' + xval + '"]' ) || document.querySelector( 'select[data-attribute="' + xf + '"]' );
						var xq   = xa ? bbQName( xa ) : '';
						if ( xq ) { xel = xa; xv = xn; xn = xq; }
					}
					( xwhole ? flatLines : perLines ).push( { el: xel, n: xn, v: xv, a: xdue } );
				} );
			var qty  = bbQty();
			var base = '' !== box.dataset.base ? parseFloat( box.dataset.base ) : bbVarBase;
			if ( null !== base && ! isNaN( base ) ) { base = bbXv( base ); }
			var totalEl = box.querySelector( '.bb-st-total' );
			var noteEl  = box.querySelector( '.bb-st-note' );
			var tpl     = function ( sel ) { var el = box.querySelector( sel ); return el ? el.textContent : '%s'; };
			// ── The receipt lines, from the walk above. ────────────────────
			var linesEl = box.querySelector( '.bb-st-lines' );
			var qtyTpl  = box.dataset.qtyTpl || '%1$s × %2$s';
			function bbQtyLabel( n, thing ) {
				return qtyTpl.replace( '%1$s', String( n ) ).replace( '%2$s', thing );
			}
			var out  = [];
			function bbItemLine( labelHtml, amount ) {
				out.push( '<div class="bb-st-line bb-st-item"><span class="bb-st-line-n">' + labelHtml + '</span><span class="bb-st-line-a">' + bbMoneyCell( box, amount ) + '</span></div>' );
			}
			if ( null !== base && ! isNaN( base ) ) {
				// The product on its own line, at its price (a measured or table
				// size's charge included: the size is what the product is bought
				// at). Every choice follows on a line of its own, in page order,
				// named by its question: "Poster size: A3", money only where it
				// costs something (his call, 19 Oct 2026).
				var bn = bbEscape( box.dataset.name || '' );
				if ( fromSeen ) {
					out.push(
						'<div class="bb-st-line bb-st-item"><span class="bb-st-line-n">' + ( qty > 1 ? bbQtyLabel( qty, bn ) : bn )
						+ '</span><span class="bb-st-line-a">' + bbEscape( box.dataset.from || '%s' ).replace( '%s', bbMoneyCell( box, ( base + sizeCharge + fromCharge ) * qty ) ) + '</span></div>'
					);
				} else {
					bbItemLine( qty > 1 ? bbQtyLabel( qty, bn ) : bn, ( base + sizeCharge ) * qty );
				}
			} else if ( 0 !== sizeCharge && sizeTexts.length ) {
				bbItemLine( bbEscape( sizeTexts.join( ', ' ) ), sizeCharge * qty );
				baseBits = [];
			}
			var picks = [];
			baseBits.forEach( function ( b ) { picks.push( { el: b.el, n: bbQName( b.el ), v: b.n, a: 0 } ); } );
			freeLines.forEach( function ( l ) { picks.push( { el: l.el, n: l.n, v: l.v, a: 0, bad: l.bad } ); } );
			perLines.forEach( function ( l ) { picks.push( { el: l.el, n: l.n, v: l.v, a: l.a * qty, q: qty, own: l.own } ); } );
			flatLines.forEach( function ( l ) { picks.push( { el: l.el, n: l.n, v: l.v, a: l.a, own: l.own } ); } );
			picks.forEach( function ( p, i ) { p.i = i; } );
			picks.sort( function ( x, y ) {
				if ( ! x.el || ! y.el || x.el === y.el || ! x.el.compareDocumentPosition ) { return x.i - y.i; }
				return ( x.el.compareDocumentPosition( y.el ) & 4 ) ? -1 : 1; // 4: y follows x on the page.
			} );
			// Several answers to one question read under ONE label ("Embroidery",
			// then each pick), as the grid does; a single answer keeps its one line
			// ("Poster size: A3"). The label line is hidden from screen readers and
			// each answer carries the label as hidden text, so a reader still hears
			// "Embroidery: Left Breast Embroidery, +£5.00".
			var bbQCount = [];
			picks.forEach( function ( p ) {
				p.g = ( p.el && p.el.closest ) ? p.el.closest( '.bb-attr-group' ) : null;
				if ( ! p.g || p.bad || ! p.n || ! p.v ) { return; }
				var hit = null;
				bbQCount.forEach( function ( c ) { if ( c.g === p.g ) { hit = c; } } );
				if ( hit ) { hit.n++; } else { bbQCount.push( { g: p.g, n: 1, said: false } ); }
			} );
			function bbQGroup( p ) {
				if ( ! p.g || p.bad || ! p.n || ! p.v ) { return null; }
				var hit = null;
				bbQCount.forEach( function ( c ) { if ( c.g === p.g && c.n > 1 ) { hit = c; } } );
				return hit;
			}
			picks.forEach( function ( p ) {
				var v = p.v || '';
				if ( p.q > 1 ) { v = v ? bbQtyLabel( p.q, v ) : ''; }
				var grp = bbQGroup( p );
				if ( grp && ! grp.said ) {
					grp.said = true;
					out.push( '<div class="bb-st-line bb-st-choice bb-st-qhead" aria-hidden="true"><span class="bb-st-line-n">' + bbEscape( p.n ) + '</span><span class="bb-st-line-a"></span></div>' );
				}
				var n = p.n || '';
				if ( p.q > 1 && ! v ) { n = bbQtyLabel( p.q, n ); }
				// The separator is TEXT, so a copy and a screen reader say "Poster
				// size: A3" too; a line that is short of an answer says " · ".
				var sep  = p.bad ? ' \u00b7 ' : ': ';
				var name = n
					? bbEscape( n ) + ( v ? '<span class="bb-st-free-v">' + sep + bbEscape( v ) + '</span>' : '' )
					: bbEscape( v );
				if ( grp ) {
					name = '<span class="bb-st-sr">' + bbEscape( n ) + ': </span>' + bbEscape( v );
				}
				// A price the shopper typed is the answer AND the money: said once
				// ("Add a donation: £19.50"), unless a quantity multiplies it, and
				// only while the money on screen IS the typed figure. On a variation
				// at its own rate, or under a quantity band that cuts option fees,
				// the line counts a different amount, and hiding it left the lines
				// short of the total they add up to.
				var said = false;
				if ( p.own && v && ! ( p.q > 1 ) ) {
					var shopIn = 'incl' === ( box.dataset.taxBasis || 'excl' );
					var onScr  = bbToggleActive() && bbInclActive() !== shopIn ? bbOtherBasis( box, p.a ) : p.a;
					said = bbFmt( box, Math.abs( onScr ) ).replace( /\s+/g, '' ) === String( v ).replace( /\s+/g, '' );
				}
				out.push(
					'<div class="bb-st-line bb-st-choice' + ( grp ? ' bb-st-qans' : '' ) + ( p.bad ? ' bb-st-bad' : '' ) + ( p.a ? '' : ' bb-st-free' ) + '"><span class="bb-st-line-n">' + name
					+ '</span><span class="bb-st-line-a">' + ( p.a && ! said ? ( p.a > 0 ? '+' : '' ) + bbMoneyCell( box, p.a ) : '' ) + '</span></div>'
				);
			} );
			repAgg.forEach( function ( r ) {
				var thing = bbEscape( bbRepThing( r.wrap ) );
				var cnt   = r.items.length || 1;
				var n     = cnt > 1 ? bbQtyLabel( cnt, thing ) : thing;
				// A per-item repeat's instances already scale with the
				// quantity (whole-line money); an add-another repeat is
				// per-unit and multiplies like any other option.
				var ra = r.whole ? r.sum : r.sum * qty;
				out.push( '<div class="bb-st-line bb-st-choice"><span class="bb-st-line-n">' + n + '</span><span class="bb-st-line-a">' + ( ra > 0 ? '+' : '' ) + bbMoneyCell( box, ra ) + '</span></div>' );
			} );
			var bbAdjSum = ( null !== base && ! isNaN( base ) && ! fromSeen ) ? ( base + opts + fromCharge ) * qty + flat : null;
			var bbAdj    = null !== bbAdjSum ? bbTotalAdjust( { kind: 'page', total: bbAdjSum, units: qty, productId: box.dataset.productId || '' } ) : null;
			var bbAdjOff = bbAdj && bbAdj.save > 0 ? Math.min( bbAdj.save, bbAdjSum ) : 0;
			var bbAdjAlt = bbAdjOther( box, null !== bbAdjSum ? bbAdjSum : 0, bbAdjOff, bbAdjOff ? bbAdj.saveOther : undefined );
			if ( bbAdjOff ) {
				out.push(
					'<div class="bb-st-line bb-st-offer"><span class="bb-st-line-n">' + bbOfferIco() + '<span>' + bbEscape( bbAdj.label || '' )
					+ ( bbAdj.note ? '<small class="bb-st-offer-note">' + bbEscape( bbAdj.note ) + '</small>' : '' )
					+ '</span></span><span class="bb-st-line-a">&minus;' + bbMoneyCell( box, bbAdjOff, bbAdjAlt.save ) + '</span></div>'
				);
			}
			if ( linesEl ) { linesEl.innerHTML = out.join( '' ); }
			// A quantity break's saving on the whole line, to the penny: the total
			// before the break, struck, and "You save", as a bundle's saving reads.
			//
			// The struck figure is one item's full price to the penny times the
			// quantity, the each the price list prints multiplied out: 25 ×
			// £22.56 strikes £564.00, never £563.96 (walk 2, 28 Oct 2026). The
			// saving is the struck figure less the one charged, so the three
			// figures on the row agree to the penny. Where prices are typed in
			// one basis and shown in the other, each is a rounded conversion,
			// and this can differ by pennies from the basket's own "Save" line
			// (each less each, times the quantity); the figures on the page agree
			// with each other first. On the VAT switch's other side the same sum
			// is made there, each item turned and rounded before it multiplies.
			var qdSave = 0, qdWas = 0, qdWasO, qdSaveO;
			if ( qdOff > 0 && null !== bbAdjSum ) {
				var qdDec = parseInt( box.dataset.decimals, 10 );
				if ( ! isFinite( qdDec ) || qdDec < 0 ) { qdDec = 2; }
				qdWas  = window.bbMoneyRound( window.bbMoneyRound( base + opts + fromCharge + qdOff, qdDec ) * qty + flat, qdDec );
				qdSave = window.bbMoneyRound( qdWas - window.bbMoneyRound( bbAdjSum, qdDec ), qdDec );
				if ( qdSave <= 0 ) { qdSave = 0; }
				if ( qdSave > 0 && bbToggleActive() ) {
					qdWasO  = window.bbMoneyRound( window.bbMoneyRound( bbOtherBasis( box, base + opts + fromCharge + qdOff ), qdDec ) * qty + bbOtherBasis( box, flat ), qdDec );
					qdSaveO = window.bbMoneyRound( qdWasO - window.bbMoneyRound( bbOtherBasis( box, bbAdjSum ), qdDec ), qdDec );
				}
			}
			if ( null !== base && ! isNaN( base ) ) {
				if ( bbAdjOff ) {
					// The figure before the offer, struck, then what the basket charges.
					totalEl.innerHTML = '<s class="bb-st-was">' + ( qdSave > 0 ? bbMoneyCell( box, qdWas, qdWasO ) : bbMoneyCell( box, bbAdjSum ) ) + '</s> ' + bbMoneyCell( box, bbAdjAlt.now, bbAdjAlt.total );
				} else if ( qdSave > 0 ) {
					totalEl.innerHTML = '<s class="bb-st-was">' + bbMoneyCell( box, qdWas, qdWasO ) + '</s> ' + bbMoneyCell( box, bbAdjSum );
				} else {
					bbSetMoney( totalEl, box, ( base + opts + fromCharge ) * qty + flat, fromSeen ? ( box.dataset.from || '' ) : '' );
				}
				// The lines above carry the reconciliation now; the Total row
				// states the figure plainly, and a quantity break's saving.
				if ( qdSave > 0 ) {
					noteEl.innerHTML = bbEscape( tpl( '.bb-st-tpl-save' ) ).replace( '%s', bbMoneyCell( box, qdSave + bbAdjOff, bbAdjOff || undefined === qdSaveO ? undefined : qdSaveO ) );
				} else {
					noteEl.textContent = '';
				}
				box.hidden = false;
			} else if ( opts > 0 || flat > 0 ) {
				bbSetMoney( totalEl, box, opts * qty + flat, tpl( '.bb-st-tpl-opts' ) );
				noteEl.textContent  = '';
				box.hidden = false;
			} else {
				box.hidden = true;
			}
			// The figure the page states, for another plugin's button to build
			// on: BundleBoss's bought-together box adds its ticked extras to it
			// ("Add both to cart · £40.30"). Only a definite total, never while
			// a "from" price stands, and said when it changes.
			var bbGrand = null !== base && ! isNaN( base ) && ! fromSeen ? ( bbAdjOff ? bbAdjAlt.now : bbAdjSum ) : null;
			if ( null !== bbGrand && isFinite( bbGrand ) ) { box.dataset.grand = String( bbGrand ); } else { delete box.dataset.grand; }
			box.dispatchEvent( new CustomEvent( 'bb-grand-change', { bubbles: true } ) );
			bbAdjFoot( box, bbAdjOff ? bbAdj : ( bbAdj && bbAdj.nudge ? { nudge: bbAdj.nudge } : null ) );
			// Publish the raw per-unit fee sum for any module that prices
			// AROUND the options (the quantity block's loaded figures read
			// it), and say the walk settled. One computation, one number,
			// every reader: re-walking the controls elsewhere is how two
			// figures on one page learn to disagree.
			var bbOptsRoot = document.querySelector( '.bb-standalone-options' );
			if ( bbOptsRoot ) {
				bbOptsRoot.dataset.bbUnitFees     = String( bbRawUnit );
				bbOptsRoot.dataset.bbPositionFees = String( bbRawPos );
				bbOptsRoot.dataset.bbUnitFeeList     = JSON.stringify( bbRawUnitList );
				bbOptsRoot.dataset.bbPositionFeeList = JSON.stringify( bbRawPosList );
				bbOptsRoot.dispatchEvent( new CustomEvent( 'bb-fees-settled', { bubbles: true, detail: { unitFees: bbRawUnit, positionFees: bbRawPos, unitFeeList: bbRawUnitList.slice(), positionFeeList: bbRawPosList.slice() } } ) );
			}
			bbRawUnit = 0;
			bbRawPos  = 0;
			bbRawUnitList = [];
			bbRawPosList  = [];
		}
		// A product field changing (typed text, a tick, an uploaded file ref)
			// re-figures the live total the same as picking a chip does.
			document.addEventListener( 'input', function ( e ) { if ( e.target && e.target.dataset && undefined !== e.target.dataset.bbFee ) { bbTotal(); } } );
			document.addEventListener( 'change', function ( e ) { if ( e.target && e.target.dataset && undefined !== e.target.dataset.bbFee ) { bbTotal(); } } );
				// A companion module (positions) recomputed its personalisation fees.
				document.addEventListener( 'bb-xfee-changed', bbTotal );
				// A plugin's answer about the total came back (see bbTotalAdjust).
				document.addEventListener( 'addon-boss-total-adjust', bbTotal );
			// The theme's quantity field re-figures it too. Deferred a tick, so
			// when the repeat script grows or shrinks its per-item cards on this
			// same event, the recount sees the field list as it ends up rather
			// than as it was. Input as well as change: a shopper who TYPES six
			// must watch the figure move, not only one who clicks the stepper.
			function bbQtyPing( e ) {
				if ( e.target && e.target.matches && e.target.matches( 'input.qty, input[name="quantity"]' ) ) {
					setTimeout( bbTotal, 0 );
				}
			}
			document.addEventListener( 'input', bbQtyPing );
			document.addEventListener( 'change', bbQtyPing );
			// Adding or removing a repeatable card changes which fee inputs
			// exist at all, and a removed card fires no input event of its own,
			// so the recount rides the click that did it.
			document.addEventListener( 'click', function ( e ) {
				if ( e.target && e.target.closest && e.target.closest( '[data-bb-repeat-add], [data-bb-repeat-remove]' ) ) {
					setTimeout( bbTotal, 0 );
				}
			} );
			// On a variable page the native form announces the chosen variation.
			// The recount is deferred a tick (the quantity listener's idiom):
			// this handler binds at ready, BEFORE the deferred variation script
			// binds its own, so it runs first on the event, while the form's
			// variation_id input still holds the previous pick. Everything that
			// reads the input (the variation-inert stand-down, the scope line,
			// the gate marks) would judge against the stale variation; a tick
			// later the form is settled and the recount reads what the server
			// will see. bbVarBase needs no wait, the event payload carries it.
		if ( window.jQuery ) {
			window.jQuery( function ( $ ) {
				$( '.variations_form' )
					.on( 'found_variation', function ( e, variation ) {
						bbVarBase = variation && undefined !== variation.display_price ? parseFloat( variation.display_price ) : null;
						bbVarK    = variation && variation.bb_k ? ( parseFloat( variation.bb_k ) || null ) : null;
						bbVarRate = variation && undefined !== variation.bb_rate && null !== variation.bb_rate ? parseFloat( variation.bb_rate ) : null;
						bbVarFees();
						setTimeout( bbTotal, 0 );
					} )
					.on( 'reset_data hide_variation', function () {
						bbVarBase = null;
						bbVarK    = null;
						bbVarRate = null;
						bbVarFees();
						setTimeout( bbTotal, 0 );
					} )
					// The attribute controls themselves, because the count has
					// to move on a HALF-answered form too: Woo fires
					// found_variation only once every attribute is in, and a
					// shopper who has picked Size and not Colour is exactly the
					// person the old count told they were finished.
					.on( 'change', 'select[name^="attribute_"], input[name^="attribute_"]', function () {
						setTimeout( bbTotal, 0 );
					} );
			} );
		}
		// A line on a tax rate of its own that is not a variation's: a module
		// pricing the product per configuration (a printer job, where plain
		// stock is zero-rated and laminated is standard) says which rate the
		// basket line will wear, as a factor and a rate in the shape the
		// variation data carries them. Every fee, the base and the toggle's
		// other side then read it exactly as they read a zero-rated Kids size.
		// A null detail hands the line back to the product's own rate.
		document.addEventListener( 'bb-line-tax', function ( e ) {
			var t = e && e.detail ? e.detail : null;
			var k = t ? parseFloat( t.k ) : NaN;
			var r = t ? parseFloat( t.rate ) : NaN;
			bbVarK    = k > 0 ? k : null;
			bbVarRate = isFinite( r ) && r >= 0 ? r : null;
			bbVarFees();
			bbTotal();
		} );
		// A module recomputing its own live figure says so; the driver refigures
		// the one total everything reads.
		document.addEventListener( 'bb-live-change', function () { bbTotal(); } );
		// Picks prefilled from a failed add (the page re-rendered with a chip
		// already selected) get their state on load; each module boots its own
		// the same way.
		// ── A BORROWED COLOUR IS NOT A READABLE COLOUR.
		//
		// The panel lends `--aob-accent` from the theme's own palette
		// (`--wp--preset--color--primary`, then `--accent`, then our own as the
		// last resort), so a shop's calls to action wear the shop's colour.
		// That is right, and it has a hole: nothing checked that the borrowed
		// colour can be READ on the surface it is painted on. A pale-lime
		// primary measured 1.55:1 on white, where the guideline asks 4.5, which
		// made "Use this" on a setup card invisible and read as disabled.
		//
		// The stylesheet already refused the theme's NUMBERED accent slots for
		// exactly this reason ("a pale yellow ... highlighter-coloured prompts
		// are unreadable"). The semantic slug can be just as pale; the lesson
		// was only half learnt.
		//
		// SO THE COLOUR IS KEPT AND MADE READABLE, never swapped. Stepping the
		// merchant's own hue toward the far end of the surface keeps the shop
		// looking like itself: a pale lime becomes an olive, not our coral. A
		// colour that already passes is left exactly alone, which is every
		// well-set-up shop.
		function bbHueRead( el, raw ) {
			// The browser normalises the value for us, whatever notation the
			// theme wrote it in (hex, rgb(), color(srgb ...), oklch()). A
			// sentinel first, so an invalid value is refused rather than read
			// as whatever the probe inherited.
			var probe = document.createElement( 'span' );
			probe.style.cssText = 'display:none;color:rgb(1,2,3);';
			el.appendChild( probe );
			probe.style.color = raw;
			var out = window.getComputedStyle( probe ).color;
			probe.remove();
			return 'rgb(1, 2, 3)' === out ? '' : out;
		}
		function bbHueBits( css ) {
			var n = String( css ).match( /[\d.]+/g );
			if ( ! n || n.length < 3 ) { return null; }
			// A color() notation gives 0-1 channels; rgb() gives 0-255.
			var one = ( n[0] <= 1 && n[1] <= 1 && n[2] <= 1 && /color\(/.test( css ) );
			return [ 0, 1, 2 ].map( function ( i ) {
				return Math.max( 0, Math.min( 255, one ? parseFloat( n[ i ] ) * 255 : parseFloat( n[ i ] ) ) );
			} );
		}
		function bbHueLum( bits ) {
			var c = bits.map( function ( v ) {
				var s = v / 255;
				return s <= 0.03928 ? s / 12.92 : Math.pow( ( s + 0.055 ) / 1.055, 2.4 );
			} );
			return 0.2126 * c[0] + 0.7152 * c[1] + 0.0722 * c[2];
		}
		function bbHueRatio( a, b ) {
			var x = bbHueLum( a ), y = bbHueLum( b );
			if ( y > x ) { var t = x; x = y; y = t; }
			return ( x + 0.05 ) / ( y + 0.05 );
		}
		function bbAccentFloor() {
			// The same hosts the stylesheet lends the accent to, so a page
			// cannot get the check on one surface and not another.
			var hosts = document.querySelectorAll(
				'.bb-standalone-options,.bb-standalone-grid,.bb-quantity-grid,.bb-st-peek'
			);
			Array.prototype.forEach.call( hosts, function ( host ) {
				if ( host.dataset.bbAccentOk ) { return; }
				var cs   = window.getComputedStyle( host );
				var acc  = bbHueBits( bbHueRead( host, cs.getPropertyValue( '--aob-accent' ).trim() ) );
				var surf = bbHueBits( bbHueRead( host, cs.getPropertyValue( '--aob-surface' ).trim() ) );
				// No reading, no opinion: a surface we cannot measure (an image,
				// a gradient, a notation this browser does not parse) is left
				// alone rather than corrected on a guess.
				if ( ! acc || ! surf ) { return; }
				host.dataset.bbAccentOk = '1';
				if ( bbHueRatio( acc, surf ) >= 4.5 ) { return; }
				// Toward black on a light surface, toward white on a dark one,
				// decided by the surface and not assumed: our own panel can be
				// either, and a dark shop needs the accent LIGHTER.
				var to = bbHueLum( surf ) > 0.5 ? [ 0, 0, 0 ] : [ 255, 255, 255 ];
				for ( var step = 1; step <= 20; step++ ) {
					var mix = acc.map( function ( v, i ) {
						return v + ( to[ i ] - v ) * ( step * 0.05 );
					} );
					if ( bbHueRatio( mix, surf ) >= 4.5 ) {
						host.style.setProperty( '--aob-accent',
							'rgb(' + mix.map( Math.round ).join( ',' ) + ')' );
						return;
					}
				}
				// Twenty steps is the whole way to black or white, so this is
				// only reached when the surface itself is mid-grey and nothing
				// of that hue can pass. Ink is readable there by construction.
				host.style.setProperty( '--aob-accent', cs.getPropertyValue( '--aob-ink' ).trim() || '#16181d' );
			} );
		}
		document.addEventListener( 'DOMContentLoaded', function () {
			bbTotal();
			bbAccentFloor();
		} );
		// ── The configurator frame: header echoes, the growth discipline,
		// the peek bar. The echo is the receipt and the required marking in
		// one; folding compresses answered groups at four-plus groups only.
		// 🔴 THE FOUNDING CUSTOMER, 1 Sept 2026: the peek bar never appeared on his site. It is a
		// quantity-grid product, and a grid replaces the whole add-to-cart form
		// (grid__premium_only removes woocommerce_template_single_add_to_cart and
		// the options panel with it). So there was no .bb-standalone-total to
		// mirror and no .single_add_to_cart_button to stand in for, and the bar
		// simply declined to mount. Nothing was broken on his side.
		//
		// A grid is a bulk-order screen with a running total and a button at the
		// bottom of a long page, which is the case the bar exists FOR. So it
		// takes the grid's own total and the grid's own button, and the rest of
		// the driver never learns there are two kinds of page.
		function bbStBox() {
			return document.querySelector( '.bb-standalone-total' ) || document.querySelector( '.bb-grid-total' );
		}
		/** The button the bar stands in for while it is off screen. */
		function bbStRealAdd() {
			// 🔴 The GRID's button first, not the theme's. A grid page still
			// carries form.cart's add button, but as a leftover with no height,
			// parked at the top of the document: anchoring to it meant the bar
			// judged itself against a control the shopper can neither see nor
			// scroll past, so it read "off screen" everywhere including the top
			// of the page. The button the shopper is actually reaching for is
			// the grid's own Add, at the bottom of the matrix.
			return document.querySelector( '.bb-standalone-grid .bb-grid-add-all' )
				|| document.querySelector( 'form.cart .single_add_to_cart_button' );
		}
		/**
		 * The figure, and the lines behind it.
		 *
		 * The options receipt keeps its money in .bb-st-total and its breakdown
		 * in .bb-st-lines. The grid's total IS the figure (money and note in one
		 * row) and its breakdown is the per-row summary above it. Both are read
		 * as markup, not text, so a dual-basis VAT total carries whole.
		 */
		function bbStFigure( box ) { return box.querySelector( '.bb-st-total' ) || box; }
		function bbStLines( box ) {
			return box.querySelector( '.bb-st-lines' ) || document.querySelector( '.bb-standalone-grid .bb-grid-summary' );
		}
		/**
		 * Is there anything to show yet?
		 *
		 * An options receipt hides itself when it has nothing to say. A grid
		 * total is simply empty until the shopper types a quantity, and its
		 * button stays disabled until then, so an empty box is the grid saying
		 * the same thing. Copying it anyway would pin a blank bar to the screen
		 * with a button that does nothing.
		 */
		function bbStHasFigure( box ) {
			return !! box && ! box.hidden && '' !== ( box.textContent || '' ).trim();
		}
		// EVERY GROUP, WHEREVER IT CURRENTLY SITS. The phone sheet lifts the
		// unanswered ones out of the panel and into a bar at the foot of the
		// screen, which has to live on <body> or a transformed ancestor captures
		// its fixed positioning. Read only the panel and the page goes blind to
		// exactly the questions the shopper is looking at: the sheet announced
		// "All set" with three of them open in front of it, the count fell to
		// zero, and the add gate stopped refusing. A group is the group.
		function bbGroups() { return document.querySelectorAll( '.bb-standalone-options .bb-attr-group, .bb-sheet .bb-attr-group' ); }
		// A conditional group is LOCKED (visible, disabled, its reason shown)
		// rather than hidden, by the module that evaluates such rules; this
		// driver only ever reads the class.
		function bbActionable( group ) { return ! group.classList.contains( 'bb-glocked' ); }
		function bbAnswered( group ) {
			// A pick the till cannot price is no answer yet: no tick beside it.
			if ( group.dataset && group.dataset.bbStop ) { return false; }
			// A quantity grid's whole-order set: its pills are its control.
			if ( group.classList.contains( 'bb-grid-woset' ) ) { return !! group.querySelector( '.bb-grid-wopill.is-sel' ); }
			// A module that owns this group's state says whether it is answered
			// through the echo attribute it maintains: empty means not yet.
			var own = group.querySelector( '[data-bb-echo]' );
			if ( own ) { return '' !== ( own.dataset.bbEcho || '' ); }
			// A several-of long set's checkbox rows: any tick is an answer.
			var checks = group.querySelector( '.bb-checks' );
			if ( checks ) { return !! checks.querySelector( 'input:checked' ); }
			var sel = group.querySelector( 'select.bundle-attr-select' );
			if ( sel ) { return !! sel.value; }
			// A FIELD group. Its fold echo already computes answered-ness (typed
			// text, a tick, an uploaded file, a chosen option), so the same
			// reading serves the scope line and the add-to-cart gate: without
			// this branch a shopper who had finished every field still read an
			// unfinished count. null means the group asks nothing at all (a
			// heading or an info block), which is never answered and never asked.
			var t = bbFieldEcho( group );
			return null !== t && '' !== t;
		}
		// Does this group ask the shopper anything? Display-only groups (a
		// heading, an info block) must not count in any denominator.
		function bbAsks( group ) {
			if ( group.querySelector( '.bb-gecho' ) ) { return true; }
			return null !== bbFieldEcho( group );
		}
		/*
		 * Woo's OWN variation form is a decision too, and it renders outside
		 * our panel, so the count never saw it.
		 *
		 * On a variable product with personalisation fields (garments with a
		 * Size or a Colour, which is the commonest shape there is) a shopper
		 * could answer both of our required fields, leave Colour unchosen, and
		 * read "2 of 2 chosen" in the finished green while Woo's Add to cart
		 * sat refused. The page said done and the button disagreed.
		 *
		 * Each of its questions counts as one, exactly as each of ours does.
		 * It was counted as ONE decision however many attributes it had, so a
		 * hoodie with Colour, Size and a print set read "0 of 2 chosen", stayed
		 * at 0 with Colour picked and reached 1 only with Size as well (tester
		 * round 4): the shopper counts the questions they can see. Read off the
		 * controls rather than the found_variation event, because the controls
		 * are the state the server will be sent and they need no event to have
		 * fired.
		 */
		function bbVarForm() {
			var f = document.querySelector( '.variations_form' );
			if ( ! f || f.hidden || ! f.offsetParent ) { return null; }
			var ctl = f.querySelectorAll( 'select[name^="attribute_"], input[name^="attribute_"]' );
			return ctl.length ? ctl : null;
		}
		// One question per attribute, by its field name: a swatch plugin's
		// radios are several controls for one question, and a radio carries its
		// value whether it is picked or not, so it counts only when checked.
		function bbVarFormCount( ctl ) {
			var seen = {};
			var out = { total: 0, done: 0 };
			Array.prototype.forEach.call( ctl, function ( c ) {
				var n = c.name || '';
				if ( ! Object.prototype.hasOwnProperty.call( seen, n ) ) { seen[ n ] = false; out.total++; }
				var on = ( 'radio' === c.type || 'checkbox' === c.type ) ? c.checked : '' !== ( c.value || '' );
				if ( on && ! seen[ n ] ) { seen[ n ] = true; out.done++; }
			} );
			return out;
		}
		// A several-of group's picked labels, whichever control it wears, in
		// the order the controls stand (the set's own order). Null for any
		// other group, so callers can branch on the shape once.
		function bbMultiPicks( group ) {
			if ( '1' !== ( group.dataset.multi || '' ) ) { return null; }
			var labels = [];
			// On a quantity grid the picks are the chosen pills.
			if ( group.classList.contains( 'bb-grid-woset' ) ) {
				group.querySelectorAll( '.bb-grid-wopill.is-sel' ).forEach( function ( p ) { labels.push( p.dataset.opt || '' ); } );
				return labels;
			}
			var sel = group.querySelector( 'select.bundle-attr-select[multiple]' );
			if ( sel ) {
				Array.prototype.forEach.call( sel.selectedOptions, function ( o ) { labels.push( o.textContent || '' ); } );
			} else {
				group.querySelectorAll( '.bb-checks input:checked' ).forEach( function ( c ) { labels.push( c.dataset.label || '' ); } );
			}
			return labels;
		}
		// Engaged but short of the at-least bound: the server would refuse
		// this exact submit, so the gate holds it at the control instead.
		function bbMultiShort( group ) {
			var picks = bbMultiPicks( group );
			if ( null === picks ) { return false; }
			var min = parseInt( group.dataset.min, 10 ) || 0;
			return picks.length > 0 && picks.length < min;
		}
		// A TYPED AMOUNT OUTSIDE ITS BOUNDS, and the sentence the till would say.
		//
		// The bounds on a name-your-price box were printed as words and enforced on
		// the server, with nothing joining the two: the box took anything, the total
		// quoted it, and the refusal arrived at Add to basket. This is the join. It
		// reads the box's own data-bb-pmin/pmax, compares them against the typed
		// figure UNCONVERTED (both are in the basis the box takes), and hands back
		// the server's own wording, so nobody meets two phrasings of one rule.
		// An empty box is not out of range, it is no answer, and the required gate
		// already owns that question.
		// One box, read against its own bounds, in the basis the shopper is
		// CURRENTLY reading. The box speaks the display basis, so on a shop with
		// a tax toggle the bound to compare against moves with the switch: the
		// -ex/-in attribute pairs carry both, and the sentence is rebuilt from
		// its template with the current-basis figure so the words on the field
		// never quote a basis the shopper is not looking at. With no toggle, the
		// prefilled render-basis attributes are the whole story. Zero, negative
		// and nonsense are the server's own answers and pass through untouched.
		function bbAmountRefused( b ) {
			if ( ! b || b.disabled || null === b.offsetParent ) { return ''; }
			var raw = String( b.value || '' ).trim();
			if ( '' === raw ) { return ''; }
			var n = bbOwnNum( raw );
			if ( isNaN( n ) || n <= 0 ) { return ''; }
			var box  = document.querySelector( '.bb-standalone-total' );
			var live = !! box && bbToggleActive();
			var incl = live ? bbInclActive() : false;
			var mn   = live ? ( ( incl ? b.dataset.bbPminIn : b.dataset.bbPminEx ) || b.dataset.bbPmin || '' ) : ( b.dataset.bbPmin || '' );
			var mx   = live ? ( ( incl ? b.dataset.bbPmaxIn : b.dataset.bbPmaxEx ) || b.dataset.bbPmax || '' ) : ( b.dataset.bbPmax || '' );
			function say( tpl, bound, fallback ) {
				if ( live && tpl && -1 !== tpl.indexOf( '%s' ) ) { return tpl.replace( '%s', bbFmt( box, parseFloat( bound ) ) ); }
				return fallback || ' ';
			}
			if ( '' !== mn && n < parseFloat( mn ) ) { return say( b.dataset.bbSayMin, mn, b.dataset.bbPminSay ); }
			if ( '' !== mx && n > parseFloat( mx ) ) { return say( b.dataset.bbSayMax, mx, b.dataset.bbPmaxSay ); }
			return '';
		}
		function bbPriceOut( group ) {
			// A pick the till cannot price (a choice with no rate on the size
			// it prices) carries the till's sentence (bbMOwes, measured).
			if ( group.dataset && group.dataset.bbStop ) { return group.dataset.bbStop; }
			var say = '';
			var boxes = group.querySelectorAll( 'input.bb-price-input' );
			for ( var i = 0; i < boxes.length; i++ ) {
				if ( ! say ) { say = bbAmountRefused( boxes[ i ] ); }
			}
			return say;
		}
		// A WRONGLY TYPED EMAIL OR WEB ADDRESS IS ANSWERED WRONGLY, NOT ANSWERED.
		// Typing anything earned the tick, and the first word about the shape of
		// it came from the browser's own bubble at Add to cart, in the browser's
		// words, not the page's (found in QA, 3 October 2026). The server's test
		// is the one that counts, so this mirrors it rather than inventing a
		// stricter one: an email has one @ with something either side and a dot
		// in the domain; a web address, with or without https://, has a dot in
		// its host, because "mysite.com" is how people type their site. The
		// sentence is the server's, printed on the field, so the page and the
		// refused submit say the same thing. Empty is not wrong: Required is a
		// separate question, answered by the gap reader.
		function bbFieldBad( group ) {
			var inp = group.querySelector( '.bb-addon-input[data-bb-bad]' );
			if ( ! inp ) { return ''; }
			var v = ( inp.value || '' ).trim();
			if ( '' === v ) { return ''; }
			var ok;
			if ( 'email' === inp.type || 'email' === inp.getAttribute( 'inputmode' ) ) {
				ok = /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test( v );
			} else {
				var host = v.replace( /^https?:\/\//i, '' ).split( /[\/?#]/ )[0];
				ok = /^[^\s.]+(\.[^\s.]+)+$/.test( host );
			}
			return ok ? '' : ( inp.dataset.bbBad || ' ' );
		}
		function bbEchoGroup( group ) {
			var echo = group.querySelector( '.bb-gecho' );
			if ( ! echo ) { return; }
			if ( group.classList.contains( 'bb-glocked' ) ) {
				echo.textContent = '';
				echo.classList.remove( 'bb-gecho-todo' );
				echo.classList.remove( 'bb-gecho-done' );
				return;
			}
			var text = '';
			var own  = group.querySelector( '[data-bb-echo]' );
			var multi = bbMultiPicks( group );
			if ( null !== multi && multi.length ) {
				// A several-of group's echo IS its pick list: the labels while
				// they fit on a breath, the count once they stop ("3 chosen").
				echo.textContent = multi.length > 2
					? ( echo.dataset.chosen || '%s chosen' ).replace( '%s', String( multi.length ) )
					: multi.map( function ( t ) { return t.trim(); } ).join( ', ' );
				echo.classList.remove( 'bb-gecho-todo' );
				echo.classList.add( 'bb-gecho-done' );
				return;
			}
			if ( own ) {
				// A module writes its own receipt (the size and its money, the band
				// and its cell) onto the store element it maintains.
				text = own.dataset.bbEcho || '';
			} else if ( null === multi ) {
				// A long set's list control (D6): the chosen option IS the echo,
				// price and all (its text already states both, translated).
				var lsel = group.querySelector( 'select.bb-list-sel' );
				if ( lsel ) {
					if ( lsel.value && lsel.selectedOptions.length ) {
						echo.textContent = ( lsel.selectedOptions[ 0 ].textContent || '' ).trim();
						echo.classList.remove( 'bb-gecho-todo' );
						echo.classList.add( 'bb-gecho-done' );
						return;
					}
				}
				var chip = group.querySelector( '.bb-chip.is-selected' );
				if ( chip ) {
					// Mirror the chip: its label plus its OWN rendered price, so a
					// dual-basis price plugin's markup (and its ex/inc toggle)
					// survives instead of the stripped title mashing the two
					// figures into "£29.17£35.00". Label rides in as text (safe),
					// the price as the chip's already-escaped markup.
					var deltaEl = chip.querySelector( '.bb-chip-delta' );
					echo.textContent = chip.dataset.label || '';
					if ( deltaEl && deltaEl.innerHTML ) {
						echo.insertAdjacentHTML( 'beforeend', ' ' + deltaEl.innerHTML );
					}
					// A pick the till cannot price is named, but not as done.
					var bbStopped = !! group.dataset.bbStop;
					echo.classList.toggle( 'bb-gecho-todo', bbStopped );
					echo.classList.toggle( 'bb-gecho-done', ! bbStopped );
					return;
				}
				// A quantity grid's whole-order set, read the same way: the
				// chosen pill's label and the price badge it is already wearing.
				var pill = group.querySelector( '.bb-grid-wopill.is-sel' );
				if ( pill ) {
					var pillD = pill.querySelector( '.bb-grid-wopill-d' );
					echo.textContent = pill.dataset.opt || '';
					if ( pillD && pillD.innerHTML ) {
						echo.insertAdjacentHTML( 'beforeend', ' ' + pillD.innerHTML );
					}
					echo.classList.remove( 'bb-gecho-todo' );
					echo.classList.add( 'bb-gecho-done' );
					return;
				}
			}
			// An answered group's echo is DONE (the skin reads it green); the
			// "None" an optional group falls back to is a state, not an answer.
			var done = '' !== text && ! ( own && own.dataset.bbWait );
			var todo = false;
			if ( '' === text ) {
				todo = '1' === group.dataset.req;
				text = todo ? ( echo.dataset.choose || '' ) : ( echo.dataset.none || '' );
			}
			echo.textContent = text;
			echo.classList.toggle( 'bb-gecho-todo', todo );
			echo.classList.toggle( 'bb-gecho-done', done );
		}
		function bbEchoAll() { bbGroups().forEach( bbEchoGroup ); }
		// A fold shut after a pick must still show the pick, so each summary
		// mirrors its children's echoes. Set, measured, table and upload
		// children already keep a body echo; FIELD children have none, so
		// their value is read straight off the input.
		function bbEsc( t ) {
			var i = document.createElement( 'i' );
			i.textContent = t;
			return i.innerHTML;
		}
		// A field group's contribution: null when it asks nothing (a heading
		// or an info block), '' while unanswered, the value once answered.
		function bbFieldEcho( group ) {
			var chk = group.querySelector( '.bb-addon-check input[type="checkbox"]' );
			if ( chk ) {
				if ( ! chk.checked ) { return ''; }
				var lab = group.querySelector( '.bb-addon-check span' );
				return lab ? lab.textContent.trim() : '';
			}
			var fref = group.querySelector( '.bb-addon-file-ref' );
			if ( fref ) {
				if ( ! fref.value ) { return ''; }
				var fn = group.querySelector( '.bb-file-fn' );
				return fn ? fn.textContent.trim() : ( fref.dataset.bbFilename || '' );
			}
			var w = group.querySelector( '.bb-size-w' ), h = group.querySelector( '.bb-size-h' );
			if ( w && h ) { return ( w.value && h.value ) ? w.value + ' × ' + h.value : ''; }
			// Colour radios carry no input class, which made a colour field
			// invisible here: never counted, never caught when required.
			var swat = group.querySelector( '[role="radiogroup"]' );
			if ( swat ) {
				var son = swat.querySelector( 'input:checked' );
				if ( ! son ) { return ''; }
				var sl = son.closest( 'label' );
				return sl ? sl.textContent.trim() : '';
			}
			var inp = group.querySelector( '.bb-addon-input' );
			if ( ! inp ) { return null; }
			if ( 'SELECT' === inp.tagName ) {
				return inp.value && inp.selectedOptions.length ? inp.selectedOptions[ 0 ].textContent.trim() : '';
			}
			var v = ( inp.value || '' ).trim();
			if ( '' === v ) { return ''; }
			// Typed words read back in quotes, the receipt convention for free
			// text; a number or a date is already its own value.
			return ( 'TEXTAREA' === inp.tagName || 'text' === inp.type ) ? '“' + v + '”' : v;
		}
		// A SECTION WITH NOTHING LEFT IN IT GOES WITH ITS QUESTIONS. A rule
		// that hides every question under a heading used to leave the heading:
		// a section name over an empty box, and under Folding sections a fold
		// that opened and shut on nothing. Read off the same lock the rule
		// puts on each question, so the two cannot disagree.
		//
		// Not under Step by step: there a section is a step, and a step that
		// is waiting on an earlier answer keeps its place in the row of steps.
		function bbIdleSections() {
			document.querySelectorAll( '.bb-standalone-options .bb-po-section:not(.bb-po-review)' ).forEach( function ( sec ) {
				var host = sec.closest( '.bb-standalone-options' );
				if ( host && 'stepbystep' === host.getAttribute( 'data-bb-layout' ) ) { sec.classList.remove( 'bb-po-idle' ); return; }
				var kids = sec.querySelectorAll( '.bb-attr-group' ), live = false;
				kids.forEach( function ( g ) { if ( bbActionable( g ) ) { live = true; } } );
				sec.classList.toggle( 'bb-po-idle', kids.length > 0 && ! live );
			} );
		}
		function bbEchoFolds() {
			bbIdleSections();
			document.querySelectorAll( '.bb-standalone-options details.bb-po-fold' ).forEach( function ( sec ) {
				var out = sec.querySelector( 'summary .bb-po-foldecho' );
				if ( ! out ) { return; }
				var parts = [], todo = false, askable = 0;
				sec.querySelectorAll( '.bb-attr-group' ).forEach( function ( g ) {
					if ( ! bbActionable( g ) ) { return; }
					var e = g.querySelector( '.bb-gecho' );
					if ( e ) {
						askable++;
						// The body echo's own markup, so a price rendered by a
						// dual-basis plugin survives into the summary too.
						if ( bbAnswered( g ) ) { parts.push( e.innerHTML ); }
						else if ( e.classList.contains( 'bb-gecho-todo' ) ) { todo = true; }
						return;
					}
					var t = bbFieldEcho( g );
					if ( null === t ) { return; }
					askable++;
					if ( '' !== t ) { parts.push( bbEsc( t ) ); }
					else if ( '1' === g.dataset.req ) { todo = true; }
				} );
				if ( ! askable ) { out.textContent = ''; out.classList.remove( 'bb-gecho-todo' ); out.classList.remove( 'bb-gecho-done' ); return; }
				if ( parts.length ) {
					out.innerHTML = parts.join( ', ' );
					out.classList.remove( 'bb-gecho-todo' );
					out.classList.add( 'bb-gecho-done' );
					return;
				}
				out.textContent = todo ? ( out.dataset.choose || '' ) : ( out.dataset.none || '' );
				out.classList.toggle( 'bb-gecho-todo', todo );
				out.classList.remove( 'bb-gecho-done' );
			} );
		}
		// WHERE A GROUP'S TICK HANGS: on the group's own name, so the mark and
		// the thing it is about read as one line.
		//
		// Three dresses, one question. A set group wears a header; a fill-in
		// field carries its label inside its body instead, and that label IS the
		// group's name; a whole-order set on the QUANTITY GRID wears a head of
		// its own. All three are marked, because they stand in one column on the
		// same page: on a grid, the fields were ticking while the set beside them
		// never could, which reads as a broken mark rather than an unanswered
		// one.
		//
		// Three shapes take none. A label that has left the screen (the card
		// whose heading already says the same words) has nothing to mark. A group
		// of REPEATING cards has no name of its own, only one per card. And a
		// group whose whole control is a TICK-BOX is already showing its state in
		// the box; a second tick beside it says the same thing twice.
		function bbTickName( group ) {
			if ( group.querySelector( '[data-bb-repeat]' ) ) { return null; }
			return group.querySelector( '.bb-ghead .bb-attr-name' )
				|| group.querySelector( '.bb-grid-woset-head .bb-grid-woset-name' )
				|| group.querySelector( '.bb-addon-label:not(.screen-reader-text)' );
		}
		// A QUESTION THAT IS ANSWERED STOPS BEING ASKED FOR. "Required" is a
		// demand, and a demand that stays on a finished question reads as an
		// accusation: the shopper sees a tick and the word Required on the same
		// line and cannot tell which one the page means. The word goes the
		// moment the answer lands and comes straight back if it is cleared, so
		// it is never wrong in either direction.
		//
		// Only THIS group's marker. A nested group keeps its own, because the
		// question it speaks for is a different question.
		function bbReqMet( group, done ) {
			group.querySelectorAll( '.bb-addon-req, .bb-po-reqflag' ).forEach( function ( m ) {
				var owner = m.closest ? m.closest( '.bb-attr-group' ) : null;
				if ( owner && owner !== group ) { return; }
				m.classList.toggle( 'bb-req-met', !! done );
			} );
		}
		function bbTick( group, done ) {
			// Before the badge branch below, because the word is wrong on a
			// finished question under EVERY layout, not only the unnumbered one.
			bbReqMet( group, done );
			var el = bbTickName( group );
			if ( ! el ) { return; }
			// Under the numbered layout this line already wears a step badge,
			// and the badge grows a tick of its own. Two ticks side by side say
			// the same thing twice.
			if ( el.parentNode && el.parentNode.querySelector( '.bb-step-n' ) ) { el.classList.remove( 'bb-tick' ); return; }
			el.classList.toggle( 'bb-tick', done );
		}
		// A GRID SET'S ANSWER IS ITS OWN PILLS, read the way the grid's own
		// footer reads them, bound and all: a several-of set short of its
		// at-least is not answered, and the grid already refuses the add for
		// exactly that reason. Reading the grid's truth here keeps the mark and
		// the refusal from ever disagreeing, and costs the shared readers no
		// second control to learn.
		function bbGridSetDone( group ) {
			if ( ! bbActionable( group ) ) { return false; }
			var picks = group.querySelectorAll( '.bb-grid-wopill.is-sel' ).length;
			if ( ! picks ) { return false; }
			var min = parseInt( group.getAttribute( 'data-min' ), 10 ) || 0;
			return min <= 0 || picks >= min;
		}
		// ── A QUANTITY GRID UNDER A LAYOUT ────────────────────────────────
		//
		// A grid product draws its own page: the colour tiles and the size
		// steppers first, then the questions asked once for the whole order.
		// That second part IS this panel, so the three layouts drive it the
		// way they drive any panel, reading a whole-order set as one more kind
		// of card. Only Step by step needs to know more than that: the
		// quantities are its first step, and they live OUTSIDE the panel,
		// beside it in the grid.
		//
		// These are the only readers that know a grid is there. The grid wraps
		// its quantities in one block when the look is Step by step and at no
		// other time, so "is there such a block" is the whole test, and a page
		// without one never takes any of the branches below.
		function bbGridOf( root ) {
			return ( root && root.closest ) ? root.closest( '.bb-standalone-grid' ) : null;
		}
		function bbGridQty( root ) {
			var grid = bbGridOf( root );
			return grid ? grid.querySelector( ':scope > .bb-grid-quantities' ) : null;
		}
		// THE QUANTITIES LEAD THE WALK. They are not a card of the panel, so
		// the walk that reads the panel never finds them: they go at the front
		// of whatever it found, for the walk and for the rail alike.
		function bbGridLead( root, cards ) {
			var qty = bbGridQty( root );
			if ( qty ) { cards.unshift( qty ); }
			return cards;
		}
		// HOW MANY ITEMS THE QUANTITIES STEP IS HOLDING, and null for every
		// other card, so one call answers both "is this the quantities" and
		// "is anything chosen". The grid's own inputs are the reading: they
		// are what its total sums and what its button posts.
		function bbGridStep( card ) {
			if ( ! card || ! card.classList || ! card.classList.contains( 'bb-grid-quantities' ) ) { return null; }
			var units = 0;
			card.querySelectorAll( '.bb-grid-qty' ).forEach( function ( i ) { units += Math.max( 0, parseInt( i.value, 10 ) || 0 ); } );
			return units;
		}
		// WHERE THE RAIL STANDS. Above the questions, which on a grid walking
		// its quantities means above the quantities: they are step one, and a
		// rail under its own first step would be a heading in the wrong place.
		function bbRailHost( root ) {
			return bbGridQty( root ) ? bbGridOf( root ) : root;
		}
		// THE QUANTITIES ON THE REVIEW: the first row, because they are the
		// first step. Read off the grid's own summary, colour by colour, so the
		// review can never state a quantity the grid is not holding, and
		// offered back through the same Change every other row has.
		function bbGridReviewRow() {
			var root = bbStepsOnly();
			var qty  = root ? bbGridQty( root ) : null;
			if ( ! qty ) { return null; }
			var bits = [];
			bbGridOf( root ).querySelectorAll( '.bb-grid-summary .bb-grid-crow:not(.bb-grid-crow-save)' ).forEach( function ( row ) {
				var name  = row.querySelector( '.bb-grid-cnm' );
				var sizes = [];
				row.querySelectorAll( '.bb-grid-sz' ).forEach( function ( sz ) {
					var n     = sz.querySelector( 'b' );
					var label = sz.firstChild ? ( sz.firstChild.textContent || '' ).trim() : '';
					sizes.push( ( ( n ? n.textContent + ' ' : '' ) + label ).trim() );
				} );
				bits.push( bbEsc( ( name ? name.textContent + ': ' : '' ) + sizes.join( ', ' ) ) );
			} );
			return { g: qty, k: bbAskName( qty ), vals: bits.length ? [ bits.join( '; ' ) ] : [], owed: 0 === bbGridStep( qty ) };
		}
		// ── NUMBERED STEPS AND THEIR REVIEW ───────────────────────────────
		//
		// WHAT COUNTS AS A STEP: every question on the page, in the order the
		// shopper meets them. Numbering only the merchant's GROUPS numbered
		// three cards out of eight on a real product and left five questions
		// unnumbered in between, which reads as a page with pieces missing
		// rather than a page with steps. Grouping in this plugin is a CARD
		// device, not a step device, and most products carry no groups at all.
		//
		// So the page marks the cards, once, from one reader. Every printer of
		// a card (a set, a field, an upload, whatever a module adds later) is
		// covered by the same walk, instead of each one having to remember to
		// print a badge it knows nothing about.
		function bbStepsOn() {
			var root = document.querySelector( '.bb-standalone-options' );
			return ( root && '1' === ( root.dataset.bbNumbered || '' ) ) ? root : null;
		}
		// WHERE A CARD'S BADGE HANGS: on the line its name is on, so the number
		// and the thing it numbers read as one. A numbered section wears a head
		// of its own; a set wears its group head; a field carries its label
		// inside its body, and that label IS its name.
		function bbStepBadgeHost( card ) {
			// A place found from the rules (bbAutoPlaces) numbers the list it shows.
			if ( card.classList.contains( 'bb-po-autoplace' ) ) {
				card = bbPlaceShows( card ) || card.firstElementChild || card;
			}
			return card.querySelector( ':scope > summary' )
				|| card.querySelector( ':scope > .bb-po-sectionname' )
				|| card.querySelector( '.bb-ghead' )
				|| card.querySelector( '.bb-grid-woset-head' )
				|| card.querySelector( '.bb-addon-label:not(.screen-reader-text)' )
				|| card.querySelector( '.bb-addon-check' )
				|| null;
		}
		/*
		 * Does this hold anything a shopper can actually touch?
		 *
		 * 🔴 NUMBERING AND SHOWING ARE TWO QUESTIONS, and giving them one
		 * answer is what put three unnumbered sections on the screen at the
		 * same time as step 1. His words, 29 Sept: "if you are on the first
		 * part and you click something that unhides then shows steps in random
		 * places its confusing you have to go back and forth."
		 *
		 * bbAsks answers "does the gate count anything here", which is the
		 * right test for a badge and for a denominator, and the WRONG test for
		 * "does this belong on this screen". A quantity grid owes the gate
		 * nothing and is still a question. A conditional section whose trigger
		 * has not fired owes nothing and has nothing in it to show either.
		 *
		 * So this reads the DOM rather than the gate: a control the shopper can
		 * reach, enabled, not display:none. Deliberately NOT offsetParent,
		 * because a card the stepper has already put away is legitimately
		 * unpainted, and reading that would stop it being a step the moment the
		 * shopper left it.
		 *
		 * 🔴 A CONTROL IN A GROUP A RULE HAS LOCKED IS NOT LIVE. The lock is a
		 * class (bb-glocked, display:none on the GROUP), and a control's own
		 * computed display stays what it was under a hidden parent, so the test
		 * above counted every locked control as reachable. That made "Where the
		 * logo goes" and "Artwork" steps before "Add print or embroidery" was
		 * chosen, and after "Blank garments" too: two steps in the rail that
		 * opened on nothing. Locked controls count only when `locked` asks for
		 * them, which is the painter's question (is this a question at all, or
		 * furniture) and the rail's (is this a step of the whole journey), not
		 * the walk's (is this being asked now).
		 *
		 * A pill counts beside a chip: it is the control a quantity grid's
		 * whole-order set is answered on.
		 */
		function bbStepHolds( el, locked ) {
			var hits = el.querySelectorAll(
				'input:not([type=hidden]):not(:disabled), select:not(:disabled),'
				+ ' textarea:not(:disabled), button.bb-chip:not(:disabled), button.bb-grid-wopill:not(:disabled)'
			);
			for ( var i = 0; i < hits.length; i++ ) {
				var c = hits[ i ];
				if ( c.closest( '[hidden]' ) ) { continue; }
				if ( ! locked && c.closest( '.bb-glocked' ) ) { continue; }
				if ( 'none' === getComputedStyle( c ).display ) { continue; }
				return true;
			}
			return false;
		}
		// THE CARDS, top to bottom. A NAMED group is one card whichever layout
		// drew it, because a fold shut hides its members: numbering what is
		// inside a fold would renumber the page every time one opened. A
		// NAMELESS group draws a plain section with no heading to hang a badge
		// on, so its members are the cards instead.
		//
		// `locked` asks a different question of the same walk: which cards
		// WOULD there be if every rule on the page had fired. That is the whole
		// journey, and it is what the step rail draws (see bbRailSteps). The
		// walk itself, the numbering and every count still ask without it.
		function bbStepCards( root, locked ) {
			var out = [];
			var ask = function ( g ) {
				return ! g.hidden && ( locked || bbActionable( g ) ) && ! bbVarInert( g ) && bbAsks( g );
			};
			Array.prototype.forEach.call( root.children, function ( el ) {
				// The review is not a question, so it takes no number: its own
				// verdict already says where the shopper stands.
				if ( el.classList.contains( 'bb-po-review' ) ) { return; }
				if ( el.classList.contains( 'bb-po-section' ) || 'DETAILS' === el.tagName ) {
					var inner = Array.prototype.filter.call( el.querySelectorAll( '.bb-attr-group' ), ask );
					// A SECTION WITH NOTHING LEFT TO ASK IS NOT A CARD. Every
					// question inside it is waiting on a trigger that has not
					// fired, so numbering it would have the shopper reading
					// 1, 2, 4, and stepping to it would put a dead screen
					// between two live ones. This is what "steps the shopper's
					// own choices emptied are skipped" comes down to.
					if ( bbStepBadgeHost( el ) ) {
						// ...BUT A SECTION HOLDING CONTROLS IS A CARD EVEN IF
						// THE GATE COUNTS NOTHING IN IT. Measured on the
						// showcase: "Where the logo goes" and "Artwork" hold
						// eleven and seven controls between them and every
						// one of their inner groups failed ask(), so neither
						// was a card, so neither was ever put away, so both
						// sat under step 1. Empty is the case the paragraph
						// above is about; full is this one. A control in a
						// group a rule has locked does not count (see
						// bbStepHolds): until the trigger fires, a section
						// like that is the empty case.
						if ( inner.length || bbStepHolds( el, locked ) ) { out.push( el ); }
						return;
					}
					inner.forEach( function ( g ) { out.push( g ); } );
					return;
				}
					// A GROUP THE GATE COUNTS NOTHING IN IS STILL A QUESTION IF
					// IT HAS CONTROLS. The quantity grid is the case: it owes
					// the gate nothing, so ask() turned it down, so it was
					// never a card, so it never got put away, so it sat on the
					// screen under every other step at once.
					if ( el.classList.contains( 'bb-attr-group' )
						&& ! el.hidden && ( locked || bbActionable( el ) ) && ! bbVarInert( el )
						&& ( bbAsks( el ) || bbStepHolds( el, locked ) ) ) {
						out.push( el );
					}
			} );
			return out;
		}
		/*
		 * Every root child this layout is responsible for putting away.
		 *
		 * 🔴 THE LEAK. bbStepShow toggled bb-step-off across the CARDS, so a
		 * child that was not a card was never given the class and therefore
		 * showed on every step. Measured on the showcase: standing on step 1
		 * of 2, "Where the logo goes", "Artwork" and "Quantity pricing" were
		 * all on screen as well, unnumbered and absent from the rail. Then
		 * answering the personalisation question turned them into steps 3, 4
		 * and 5, so the rail grew from two to five around questions the
		 * shopper could already see. That is the whole of what he reported.
		 *
		 * A card is shown when it is the one being asked. Anything else in
		 * this list is put away, always. An emptied conditional section has
		 * nothing in it to see, so putting it away costs the shopper nothing
		 * and stops the page showing a heading with no question under it
		 * (which is the related gap in a-group-with-every-child-hidden).
		 *
		 * The rail, the nav and the review stay out: they are the frame the
		 * walk is drawn in, not places the walk goes.
		 */
		function bbStepHosts( root ) {
			return Array.prototype.filter.call( root.children, function ( el ) {
				return el.classList.contains( 'bb-attr-group' )
					|| el.classList.contains( 'bb-po-section' )
					|| 'DETAILS' === el.tagName;
			} );
		}
		// One place decides what is on the screen, so the two callers cannot
		// drift apart: bbStepShow when the shopper moves, bbStepSync when an
		// answer changes the shape of the walk under them.
		function bbStepPaint( cards, at ) {
			var root = bbStepsOnly();
			var here = cards[ at ] || null;
			cards.forEach( function ( c, i ) {
				c.classList.toggle( 'bb-step-off', i !== at );
			} );
			if ( ! root ) { return; }
			bbStepHosts( root ).forEach( function ( el ) {
				if ( cards.indexOf( el ) > -1 ) { return; }
				// It holds the card the shopper is standing on, which is what
				// a nameless section looks like: its members are the cards.
				if ( here && el.contains( here ) ) {
					el.classList.remove( 'bb-step-off' );
					return;
				}
				/*
				 * 🔴 FURNITURE IS NOT A STEP AND MUST NOT BE PUT AWAY. The
				 * quantity price table holds no controls at all: it is a
				 * reading, like the receipt bar. Sweeping it up with the
				 * questions took the shopper's price table off every screen,
				 * which is a worse page than the leak. So only a host with
				 * something to ANSWER is put away, and it is put away because
				 * it belongs to a step that is not this one. A section whose
				 * every group a rule has locked still holds questions, waiting
				 * on their trigger, so it is put away too: left out, it would
				 * show its heading with nothing under it on every step.
				 */
				if ( ! bbStepHolds( el, true ) ) {
					el.classList.remove( 'bb-step-off' );
					return;
				}
				el.classList.add( 'bb-step-off' );
			} );
		}
		function bbStepMark() {
			var root = bbStepsOn();
			if ( ! root ) { return; }
			var cards = bbStepCards( root );
			// A page with ONE question is a page with no steps: "1" beside the
			// only thing on the screen counts nothing.
			// A CARD THE PAGE IS NOT ASKING TAKES NO NUMBER. A conditional
			// section still waiting for its trigger carries `hidden`, and
			// numbering it would have the shopper reading 1, 2, 4.
			//
			// The step hide is a CLASS and this one is a property, which is
			// what keeps them apart: bb-step-off is a question still being
			// asked that simply is not on this screen, and it keeps its number.
			var shown = cards.filter( function ( c ) { return ! c.hidden; } );
			var lone  = shown.length < 2;
			cards.forEach( function ( card ) {
				var host = bbStepBadgeHost( card );
				if ( ! host ) { return; }
				var badge = host.querySelector( ':scope > .bb-step-n' );
				var at    = shown.indexOf( card );
				if ( lone || at < 0 ) {
					if ( badge ) { badge.remove(); }
					host.classList.remove( 'bb-step-head' );
					return;
				}
				// The host becomes a row, or a block host puts the number on one
				// line and the name it numbers on the next.
				host.classList.add( 'bb-step-head' );
				if ( ! badge ) {
					badge = document.createElement( 'span' );
					badge.className = 'bb-step-n';
					// A number read out before every heading is noise: the heading
					// and the echo already say what the step is and where it stands.
					badge.setAttribute( 'aria-hidden', 'true' );
					host.insertBefore( badge, host.firstChild );
				}
				// THE NUMBER IS WRITTEN FROM THIS WALK, NEVER A CSS COUNTER.
				//
				// It was a counter, and that broke the moment a layout took a
				// card off the screen: an element with display:none does not
				// increment counters, so under step by step the earlier steps
				// never counted and the only visible one always rendered "1".
				// Every step read step one.
				//
				// The walk already knows the position, so writing it is both
				// correct and immune to whatever any layout does to the boxes.
				// Written on every pass rather than only at creation, so a
				// conditional question appearing or leaving renumbers the rest.
				badge.textContent = String( at + 1 );
			} );
		}
		// WHAT ONE STEP IS ASKING: the card's own questions. A numbered section
		// holds several; a loose card is one.
		function bbStepAsk( card ) {
			var out = [];
			var take = function ( g ) {
				if ( g.hidden || ! bbActionable( g ) || bbVarInert( g ) || ! bbAsks( g ) ) { return; }
				out.push( g );
			};
			if ( card.classList.contains( 'bb-attr-group' ) ) { take( card ); }
			card.querySelectorAll( '.bb-attr-group' ).forEach( take );
			return out;
		}
		// ── STEP BY STEP: one question on the screen, Continue to move on. ──
		//
		// Opt-in, and never the default. The one thing a stepper takes away is
		// the overview, which is the only objection to it anybody has ever put
		// in writing, so it is a page a merchant chooses for a long form and
		// nobody else ever meets.
		//
		// IT STEPS THE SAME CARDS THE NUMBERING NUMBERS. Reading a different
		// set would put the badge "2" on something that is not step two, and a
		// group-only walk would make one step of an eight-question product.
		// The review, if the shop turned it on, is the LAST step: the shopper
		// walks the questions, reads back what they chose, and the button is
		// there.
		var bbStepAt = 0;
		// The card the shopper is standing on. The index above is only a
		// position in a list that their own answers can reorder, so the CARD is
		// what the page remembers and the index is re-derived from it.
		var bbStepCard = null;
		function bbStepsOnly() {
			var root = document.querySelector( '.bb-standalone-options' );
			if ( ! root || 'stepbystep' !== ( root.dataset.bbLayout || '' ) ) { return null; }
			bbAutoPlaces( root );
			return root;
		}
		// ── PLACES: A JOURNEY MADE OF NAMED SECTIONS. ──────────────────
		//
		// A product whose steps are sections ("Shape", "Size", "Finish") is a
		// short list of places, fixed by the merchant, and what is asked
		// INSIDE a place changes with the answers. So the place itself never
		// waits: it is walked like any other step, and if everything in it is
		// still waiting on an earlier answer it says so, in the rule module's
		// own line. A place the answers have RULED OUT leaves the walk and
		// slides off the rail; changing that answer brings it back. His call,
		// 22 Oct, from the mock beside the dashed rail: a faded or dashed step
		// is one a shopper goes looking for the way to unlock.
		//
		// A product WITHOUT sections is made of places too (bbAutoPlaces): the
		// owner, 23 Oct, on a copy of David's floor stickers drawn as one step,
		// four dashed size lists and a last step, "the steps are never gonna be
		// more than three".
		function bbStepPlaces( root ) {
			if ( '2' === root.dataset.bbAutoPlaces ) { return true; }
			return Array.prototype.some.call( root.children, function ( el ) {
				return ( el.classList.contains( 'bb-po-section' ) || 'DETAILS' === el.tagName ) && !! bbStepBadgeHost( el );
			} );
		}
		// ── PLACES FOR LOOSE STEPS, found from the rules themselves. ──────────
		//
		// What a merchant draws as sections, the rules of a loose product say
		// already: lists that are shown INSTEAD OF EACH OTHER (circle sizes,
		// square sizes, a box for a custom shape: the same question answered
		// differently opens each) are one place, "Size". A list that follows an
		// answer of one of them ("Enter my own size" opens the diameter) opens
		// inside that place, so the rail never grows under the shopper. Each
		// place is wrapped, once, in a section the stylesheet lays out as if it
		// were not there (display: contents), and from then on it is walked
		// exactly as a merchant's section is: never dashed, a waiting place says
		// what it waits for, a place the answers rule out slides off the rail.
		//
		// Only lists side by side join, and only show rules made of "is" and
		// "is any of": anything else keeps a step of its own, as before.
		function bbRuleSig( g ) {
			var rule;
			try { rule = JSON.parse( g.dataset.bbRule || '' ); } catch ( e ) { return null; }
			if ( ! rule || 'show' !== rule.act || ! rule.groups || 1 !== rule.groups.length || ! rule.groups[ 0 ].length ) { return null; }
			var sig = {};
			for ( var i = 0; i < rule.groups[ 0 ].length; i++ ) {
				var c = rule.groups[ 0 ][ i ];
				if ( 'is' !== c.op && 'is_any' !== c.op ) { return null; }
				var key = c.field ? 'f:' + c.field : 's:' + c.sel;
				sig[ key ] = ( Array.isArray( c.value ) ? c.value : [ c.value ] ).map( String );
				sig[ key ].cond = c;
			}
			return sig;
		}
		function bbAutoPlaces( root ) {
			if ( root.dataset.bbAutoPlaces ) { return; }
			root.dataset.bbAutoPlaces = '1';
			// A merchant's own sections say where the places are.
			if ( bbStepPlaces( root ) ) { return; }
			var groups = Array.prototype.filter.call( root.children, function ( el ) { return el.classList.contains( 'bb-attr-group' ); } );
			if ( ! groups.some( function ( g ) { return !! g.dataset.bbRule; } ) ) { return; }
			var owner = function ( c ) {
				var el = c.field ? root.querySelector( '[name="bb_pf[' + c.field + ']"]' ) : root.querySelector( '[data-attribute="' + c.sel + '"]' );
				return el ? el.closest( '.bb-attr-group' ) : null;
			};
			var keys = function ( s ) { return Object.keys( s ).sort().join( '|' ); };
			// Two lists can never both be open: one question they both ask is
			// answered differently by each.
			var apart = function ( a, b ) {
				return Object.keys( a ).some( function ( k ) {
					return b[ k ] && a[ k ].every( function ( v ) { return b[ k ].indexOf( v ) < 0; } );
				} );
			};
			var places = [];
			var place  = null;
			groups.forEach( function ( g ) {
				var sig  = bbRuleSig( g );
				var last = place ? place.members[ place.members.length - 1 ] : null;
				if ( sig && last && last.nextElementSibling === g && place.sigs[ 0 ] ) {
					var first = place.sigs[ 0 ];
					// Shown instead of every list already in the place.
					var sibling = keys( sig ) === keys( first ) && place.sigs.every( function ( s ) { return ! s || apart( sig, s ); } );
					// Opened by an answer to a list in the place, and by nothing
					// from outside it but the question the place itself turns on.
					var follow = Object.keys( sig ).some( function ( k ) {
						var o = owner( sig[ k ].cond );
						return o && place.members.indexOf( o ) > -1;
					} ) && Object.keys( sig ).every( function ( k ) {
						var o = owner( sig[ k ].cond );
						return o && ( place.members.indexOf( o ) > -1 || !! first[ k ] );
					} );
					if ( sibling || follow ) {
						place.members.push( g );
						place.sigs.push( sibling ? sig : null );
						return;
					}
				}
				place = { members: [ g ], sigs: [ sig ] };
				places.push( place );
			} );
			places.forEach( function ( p ) {
				if ( p.members.length < 2 ) { return; }
				var wrap = document.createElement( 'div' );
				wrap.className = 'bb-po-section bb-po-autoplace';
				p.members[ 0 ].parentNode.insertBefore( wrap, p.members[ 0 ] );
				p.members.forEach( function ( g ) { wrap.appendChild( g ); } );
			} );
			root.dataset.bbAutoPlaces = '2';
		}
		// The list a place is showing now: its first one not locked, else its
		// first. Its name is the place's name, and its head carries the number.
		function bbPlaceShows( card ) {
			if ( ! card.classList.contains( 'bb-po-autoplace' ) ) { return card; }
			var gs = Array.prototype.slice.call( card.children );
			for ( var i = 0; i < gs.length; i++ ) {
				if ( ! gs[ i ].classList.contains( 'bb-glocked' ) && ! gs[ i ].hidden ) { return gs[ i ]; }
			}
			return null;
		}
		// Holds questions, and every one of them is locked: on the screen it
		// would be a heading over nothing, so it says what it waits for. And a
		// place left while it waits was not SEEN (bbStepShow): nothing in it
		// could be answered, so marking it owed once it opens would blame the
		// shopper for questions they were never shown.
		function bbStepWaits( card ) {
			return ! bbStepHolds( card, false ) && bbStepHolds( card, true );
		}
		// Every question in it locked, and every lock RULED OUT by an answer
		// already given (the rule module decides; see bbRuleOut). Nothing the
		// shopper does next can open it short of changing that answer.
		function bbStepGone( card ) {
			if ( 'function' !== typeof window.bbRuleOut ) { return false; }
			var gs = card.classList.contains( 'bb-attr-group' ) ? [ card ] : Array.prototype.slice.call( card.querySelectorAll( '.bb-attr-group' ) );
			gs = gs.filter( function ( g ) { return ! g.hidden && ! bbVarInert( g ); } );
			return gs.length > 0 && gs.every( function ( g ) {
				return g.classList.contains( 'bb-glocked' ) && window.bbRuleOut( g );
			} );
		}
		function bbSteps() {
			var root = bbStepsOnly();
			if ( ! root ) { return []; }
			var cards = bbStepPlaces( root )
				? bbStepCards( root, true ).filter( function ( c ) { return ! bbStepGone( c ); } )
				: bbStepCards( root );
			// On a quantity grid the quantities are step one.
			bbGridLead( root, cards );
			var rev   = root.querySelector( '.bb-po-review' );
			if ( rev ) { cards.push( rev ); }
			return cards;
		}
		function bbStepHolding( g ) {
			var cards = bbSteps();
			for ( var i = 0; i < cards.length; i++ ) {
				if ( cards[ i ] === g || cards[ i ].contains( g ) ) { return i; }
			}
			return -1;
		}
		// A STEP IS HIDDEN BY A CLASS, NEVER BY `hidden`. THIS IS THE WHOLE
		// SAFETY OF THE LAYOUT. `hidden` is exactly what bbActionable reads to
		// mean "this is not being asked", so hiding a step with it would take
		// every unanswered question on every other step out of bbAllMissing,
		// and Add to cart would accept a half-answered product: the shopper
		// pays and the shop gets an order it cannot make. A class the gate does
		// not read leaves them owed the whole way through.
		//
		// And it is added HERE, at runtime, rather than sitting in the
		// stylesheet: a page whose script never ran shows every step, which is
		// the ordinary stacked page, which is a page somebody can buy from.
		function bbStepShow( n, moved, byKey ) {
			var cards = bbSteps();
			if ( ! cards.length ) { return; }
			var to = Math.max( 0, Math.min( n, cards.length - 1 ) );
			// REMEMBER THE CARD, NOT THE INDEX. A conditional question arriving
			// or leaving renumbers every step after it, and a mark that moved
			// to a different question because an unrelated one appeared would
			// be worse than no mark.
			if ( to !== bbStepAt && cards[ bbStepAt ] && bbStepSeen.indexOf( cards[ bbStepAt ] ) < 0 && ! bbStepWaits( cards[ bbStepAt ] ) ) {
				bbStepSeen.push( cards[ bbStepAt ] );
			}
			// The line explaining a waiting step belongs to the screen it was
			// asked on. A shopper who has moved on has moved past it.
			if ( to !== bbStepAt ) { bbRailWhy( null ); }
			bbStepAt = to;
			bbStepCard = cards[ to ] || null;
			bbStepPaint( cards, bbStepAt );
			bbStepNav( cards );
			bbRailPaint( moved, byKey );
		}
		function bbStepGo( dir, byKey ) {
			var cards = bbSteps();
			if ( ! cards.length ) { return; }
			if ( dir > 0 ) {
				// CONTINUE CHECKS, SAYS SO, AND MOVES ANYWAY.
				//
				// It used to refuse. Refusing did stop a shopper leaving a
				// question unanswered, and it also stopped them LOOKING at what
				// the rest of the form was going to ask, because the only way
				// forward was to finish. That is the overview a stepper takes
				// away and the one thing designers hold against steppers, and
				// the two are separable: looking costs nothing, because moving
				// between steps answers nothing and skips nothing.
				//
				// So the check stays and the block goes. The gaps are marked as
				// the shopper leaves them, the rail carries that mark the whole
				// way, the receipt bar names them, and Add to cart is still the
				// only thing that decides. What this cannot become is silent:
				// a stepper that waves somebody past a question and says
				// nothing until the basket is worse than no stepper at all.
				//
				// THE GATE'S OWN LIST, narrowed to this step, never a second
				// opinion: bbStepAsk says which questions are on this card and
				// bbAllMissing says which of the page's questions are owed. A
				// private reader here is how a Continue and an Add to cart end
				// up disagreeing about the same product.
				var mine = bbStepAsk( cards[ bbStepAt ] );
				bbAllMissing().forEach( function ( g ) {
					if ( mine.indexOf( g ) > -1 ) { bbMissPaint( g, bbPriceOut( g ) ); }
				} );
			}
			bbStepShow( bbStepAt + dir, true, byKey );
		}
		// The frame comes from the page (its words are the only part a
		// translator can reach); the controls are built here, so a page with no
		// script never shows a Back and a Continue that cannot do anything.
		function bbStepNav( cards ) {
			var root = bbStepsOnly();
			if ( ! root ) { return; }
			var nav = root.querySelector( '.bb-stepnav' );
			if ( ! nav ) { return; }
			// ONE step is not a journey. A Continue under the only question on
			// the page is a button that does nothing but look like it should.
			if ( cards.length < 2 ) { nav.hidden = true; return; }
			if ( ! nav.dataset.bbWired ) {
				nav.dataset.bbWired = '1';
				var back = document.createElement( 'button' );
				back.type      = 'button';
				back.className = 'bb-stepbtn bb-stepback';
				back.textContent = nav.dataset.back || '';
				var next = document.createElement( 'button' );
				next.type      = 'button';
				next.className = 'bb-stepbtn bb-stepnext';
				next.textContent = nav.dataset.next || '';
				// NO COUNT BETWEEN THEM. The rail above says which step this
				// is, and one screen saying "Step 2 of 4" twice is one fact the
				// reader then has to check against itself.
				nav.appendChild( back );
				nav.appendChild( next );
				// 0 === detail means the press came from the keyboard, which is
				// the only press that wants a ring drawn where the focus lands.
				back.addEventListener( 'click', function ( ev ) { bbStepGo( -1, 0 === ev.detail ); } );
				next.addEventListener( 'click', function ( ev ) { bbStepGo( 1, 0 === ev.detail ); } );
			}
			nav.hidden = false;
			// No Continue on the last step: the Add to cart button is the next
			// thing on the page, and two ways forward is one too many.
			nav.querySelector( '.bb-stepback' ).hidden = ( 0 === bbStepAt );
			var next2 = nav.querySelector( '.bb-stepnext' );
			var last  = ( bbStepAt === cards.length - 1 );
			next2.hidden = last;
			// THE ONE STEP CONTINUE WAITS ON: a quantity grid with nothing in
			// it. An empty order is not a gap to mark and come back to, every
			// later step asks about items that do not exist yet. Any other
			// card answers null here, so the button is never held anywhere
			// else and the rule above it stands: check, say so, move.
			next2.disabled = 0 === bbGridStep( cards[ bbStepAt ] );
			if ( ! last ) {
				// CONTINUE SAYS WHERE IT GOES. "Continue" asks the shopper to
				// press a button and find out; "Continue to material and
				// finish" is most of the overview a stepper costs them, given
				// back for the price of a word. The bare word stays for a step
				// whose name cannot be read.
				var to = bbAskName( cards[ bbStepAt + 1 ] );
				next2.textContent = to
					? ( nav.dataset.nextTo || '%s' ).replace( '%s', to )
					: ( nav.dataset.next || '' );
			}
		}
		// THE RAIL ABOVE THE QUESTIONS: where the shopper stands, what is
		// coming, and a way to any of it.
		//
		// A STEPPER'S ONE REAL COST IS THE OVERVIEW. Shut inside a step, a
		// shopper cannot see what the rest of the form is going to ask, so the
		// only way to find out is to finish. That is the single complaint
		// designers make about steppers and it is the reason this card exists
		// and the reason the rail goes FORWARD as well as back. Pressing a
		// step answers nothing and skips nothing: the basket gate is untouched
		// and still the only thing that decides whether this product can be
		// bought.
		//
		// THE NAMES SHOW WHEN THE NAMES FIT, AND THE RAIL MEASURES ITSELF TO
		// FIND OUT. Not a step count, and not a media query. The rail lives in
		// the product summary column, which a theme sets to about 545px wide
		// and about 334px on a phone, and the names share that equally: four
		// fit in either, seven fit in neither, and five or six fit in one and
		// not the other. A count rule is wrong in the middle of that, a width
		// rule is wrong at both ends, and both are wrong the first time a
		// merchant writes a longer question name or a translation runs long.
		// Measuring is the only rule with nothing in it to keep true.
		//
		// THE BARS STAY WHATEVER THE NAMES DO. Even with no room for a single
		// name the shopper still has the shape of the journey and how far
		// along it they are, and the heading above still names where they are.
		var bbStepSeen = [];
		function bbRail( root, cards ) {
			// The words live on the nav frame the layout module prints. No
			// frame, no words: a row of unlabelled circles says nothing at all
			// to a shopper who is not looking at the screen, so there is no
			// rail without them.
			var nav  = root.querySelector( '.bb-stepnav' );
			var host = bbRailHost( root );
			var rail = host.querySelector( ':scope > .bb-steprail' );
			// ONE step is not a journey, which is the reading the nav makes too.
			if ( ! nav || cards.length < 2 ) {
				if ( rail ) { rail.remove(); }
				return null;
			}
			if ( ! rail ) {
				rail = document.createElement( 'div' );
				rail.className = 'bb-steprail';
				var of = document.createElement( 'p' );
				of.className = 'bb-rail-of';
				// The one place the page says which step this is. The nav at
				// the foot used to say it too, and a fact said twice on one
				// screen is a fact the reader starts checking against itself.
				of.setAttribute( 'role', 'status' );
				of.setAttribute( 'aria-live', 'polite' );
				var now = document.createElement( 'h3' );
				now.className = 'bb-rail-now';
				// Focus lands here on a move, so it has to be able to take
				// focus without joining the tab order.
				now.tabIndex = -1;
				var bars = document.createElement( 'ol' );
				bars.className = 'bb-rail-bars';
				bars.setAttribute( 'aria-label', nav.dataset.rail || '' );
				// Where a waiting step says what it is waiting for. Always in
				// the page and empty until asked, because a live region that
				// arrives with its words already in it is one a screen reader
				// may never read out.
				var why = document.createElement( 'div' );
				why.className = 'bb-rail-why';
				why.setAttribute( 'role', 'status' );
				rail.appendChild( of );
				rail.appendChild( now );
				rail.appendChild( bars );
				rail.appendChild( why );
				// Above the questions, but BELOW the starting points where the
				// shop offers them: those are a way to begin, not a step of the
				// walk, and they stay on screen the whole way through.
				var setups = host.querySelector( ':scope > .bb-setups' );
				host.insertBefore( rail, setups ? setups.nextSibling : host.firstChild );
			}
			return rail;
		}
		function bbRailFit( rail, nameless ) {
			// Measured with the names IN, so the question asked is the real one:
			// would these names, in this column, at this font, have to be cut?
			rail.classList.remove( 'bb-rail-bare' );
			var cut = nameless;
			rail.querySelectorAll( '.bb-rail-nm' ).forEach( function ( nm ) {
				// A place off the rail, or still sliding, has no width of its
				// own to read: it is measured once it lands (bbRailSlide).
				if ( nm.closest( '.is-gone, .is-moving' ) ) { return; }
				// A pixel of tolerance: a sub-pixel width is not a truncation,
				// and treating one as a truncation would drop the names on a
				// page where they fit perfectly well.
				if ( nm.scrollWidth > nm.clientWidth + 1 ) { cut = true; }
			} );
			if ( cut ) { rail.classList.add( 'bb-rail-bare' ); }
		}
		// A PLACE LEAVES OR COMES BACK IN A FIFTH OF A SECOND. A jump makes the
		// rail twitch under the shopper; a slow fade is the change people miss
		// most, and it leaves a half-there step to wonder about. The shopper is
		// looking at the answer they just gave, so the slide only has to keep
		// the rail true without a jolt. None at all for a shopper who asked
		// for less motion (the stylesheet).
		//
		// A cell built on this paint takes its place without moving: the
		// first screen is not a change. One in flight is left out of the name
		// measurement and measured once it lands, since mid-slide its width
		// is neither the old one nor the new.
		function bbRailSlide( rail, cell, gone, fresh ) {
			if ( cell.classList.contains( 'is-gone' ) === gone ) { return; }
			cell.classList.toggle( 'is-gone', gone );
			// Off the rail is off the keyboard and out of a screen reader's
			// list too, not merely out of sight.
			cell.inert = gone;
			if ( gone ) { cell.setAttribute( 'aria-hidden', 'true' ); } else { cell.removeAttribute( 'aria-hidden' ); }
			if ( fresh ) { return; }
			cell.classList.add( 'is-moving' );
			clearTimeout( cell.bbLand );
			cell.bbLand = setTimeout( function () {
				cell.classList.remove( 'is-moving' );
				bbRailFit( rail, '1' === rail.dataset.bbBlank );
			}, 260 );
		}
		// A MEASUREMENT TAKEN ONCE OUTLIVES THE THING IT MEASURED. This column
		// belongs to the theme and it settles again after our script has run: a
		// gallery image lands, a font swaps, a sidebar folds, a block editor
		// lays out. None of those fire a resize event on the window.
		function bbRailWatch( rail ) {
			if ( rail.dataset.bbWatch || 'function' !== typeof window.ResizeObserver ) { return; }
			rail.dataset.bbWatch = '1';
			var was = Math.round( rail.clientWidth );
			new window.ResizeObserver( function () {
				var now = Math.round( rail.clientWidth );
				// Guarded on the rounded width so writing the class can never
				// feed the observer that wrote it.
				if ( now === was ) { return; }
				was = now;
				bbRailFit( rail, '1' === rail.dataset.bbBlank );
			} ).observe( rail );
		}
		// ── EVERY STEP STAYS. ────────────────────────────────────────────
		//
		// The rail draws the WHOLE journey, the steps still waiting on an
		// earlier answer included, so it keeps one length from the first
		// screen to the last. It used to draw only the live steps, and on the
		// showcase that made answering "Add print or embroidery" grow the rail
		// from two steps to four around the shopper: a stepper whose length
		// changes under you is one you cannot trust to say how far you have to
		// go. Chosen 2 Oct from the two shapes mocked side by side.
		//
		// A waiting step is drawn and never walked. It has no number, because
		// it is not a step of this walk yet; Continue and Back pass it, because
		// bbSteps never held it; and "Step x of y" counts only the live ones.
		// Pressing it says what it is waiting for and moves nothing.
		function bbRailSteps() {
			var root = bbStepsOnly();
			if ( ! root ) { return []; }
			var all = bbStepCards( root, true );
			bbGridLead( root, all );
			var rev = root.querySelector( '.bb-po-review' );
			if ( rev ) { all.push( rev ); }
			return all;
		}
		// WHAT A WAITING STEP IS WAITING FOR, in the words the rule module
		// already printed on the locked group ("Available when Personalisation
		// is Add print or embroidery"), so the rail says nothing a translator
		// has not already seen. The frame's plain line stands in for a group
		// that carries none.
		//
		// A SECTION HOLDS SEVERAL, and they need not wait on the same answer:
		// "Size" holds the circle sizes and the square sizes, one line each.
		// Naming the first would tell a shopper who wants a square that only a
		// circle opens it. So one line is used only when every locked question
		// in the step says the same thing; otherwise the plain line, which is
		// true of all of them.
		function bbStepWhy( card, nav ) {
			if ( ! card ) { return ''; }
			var gs   = card.classList.contains( 'bb-glocked' ) ? [ card ] : Array.prototype.slice.call( card.querySelectorAll( '.bb-glocked' ) );
			var says = [];
			gs.forEach( function ( g ) {
				var line = g.querySelector( '.bb-lockline' );
				var say  = line ? ( line.textContent || '' ).replace( /\s+/g, ' ' ).trim() : '';
				if ( say && says.indexOf( say ) < 0 ) { says.push( say ); }
			} );
			return 1 === says.length ? says[ 0 ] : ( nav ? ( nav.dataset.wait || '' ) : '' );
		}
		// The step the line under the bars is explaining, so the paint can take
		// the line away the moment that step opens.
		var bbRailWhyCard = null;
		// A PRESS ON A WAITING STEP EXPLAINS AND STAYS PUT. There is nowhere to
		// go: everything on that step waits on an answer the shopper has not
		// given yet. So the line under the bars names the answer, and they stay
		// on the step they were on. Null takes the line away.
		function bbRailWhy( card ) {
			var root = bbStepsOnly();
			var why  = root ? bbRailHost( root ).querySelector( ':scope > .bb-steprail > .bb-rail-why' ) : null;
			var nav  = root ? root.querySelector( '.bb-stepnav' ) : null;
			var say  = card ? bbStepWhy( card, nav ) : '';
			bbRailWhyCard = say ? card : null;
			if ( ! why ) { return; }
			why.textContent = '';
			if ( ! say ) { return; }
			var mark = document.createElement( 'span' );
			mark.className = 'bb-rail-why-i';
			mark.setAttribute( 'aria-hidden', 'true' );
			mark.textContent = 'i';
			var words = document.createElement( 'span' );
			words.setAttribute( 'dir', 'auto' );
			words.textContent = say;
			why.appendChild( mark );
			why.appendChild( words );
		}
		function bbRailPaint( moved, byKey ) {
			var root = bbStepsOnly();
			if ( ! root ) { return; }
			var cards = bbSteps();
			var all   = bbRailSteps();
			var rail  = bbRail( root, all );
			if ( ! rail ) { return; }
			var nav   = root.querySelector( '.bb-stepnav' );
			var names = cards.map( bbAskName );
			var every = all.map( bbAskName );
			var ol    = rail.querySelector( '.bb-rail-bars' );
			// REBUILT ONLY WHEN THE JOURNEY ITSELF CHANGED. A rebuild throws
			// away whatever the shopper had focused, and this paints on every
			// answer, so the nodes are made once per shape and only the state
			// is written each time. The shape is the WHOLE journey, so a step
			// opening or closing again changes no node at all: only the state
			// written below moves.
			var sig = every.length + '|' + every.join( '\u001f' );
			var fresh  = ol.dataset.bbSig !== sig;
			var places = bbStepPlaces( root );
			rail.classList.toggle( 'bb-rail-places', places );
			if ( fresh ) {
				ol.dataset.bbSig = sig;
				ol.textContent = '';
				every.forEach( function ( name, k ) {
					var cell = document.createElement( 'li' );
					cell.className = 'bb-rail-cell';
					// EVERY step is a live button, forward ones included. A row
					// that changed which elements it is made of as the shopper
					// moved would have to be rebuilt on every move, and the
					// rebuild is what costs them their focus.
					var btn = document.createElement( 'button' );
					btn.type      = 'button';
					btn.className = 'bb-rail-step';
					// The bar is the step. It stays whatever happens to the
					// names, so the shape of the journey survives a column with
					// no room to write in.
					var bar = document.createElement( 'span' );
					bar.className = 'bb-rail-bar';
					var nm = document.createElement( 'span' );
					nm.className = 'bb-rail-nm';
					nm.setAttribute( 'dir', 'auto' );
					nm.textContent = name;
					// THE NUMBER IS WHAT SHOWS WHERE THE NAME CANNOT. A name
					// needs room a narrow column does not have; a number never
					// does. It also gives the row back its height, which is the
					// difference between a step you can press and a 5px line
					// you have to aim at. Written on every paint below, since a
					// step opening further up moves every number after it.
					var n = document.createElement( 'span' );
					n.className = 'bb-rail-n';
					btn.appendChild( bar );
					btn.appendChild( nm );
					btn.appendChild( n );
					cell.appendChild( btn );
					ol.appendChild( cell );
					// 0 === detail means the button was worked from the keyboard,
					// which is the only case that wants a ring drawn where the
					// focus lands.
					//
					// WHERE A PRESS GOES IS READ AT THE PRESS. The row outlives
					// a step opening, so this cell's place in the walk is only
					// known now. A step still waiting has no place in it, so
					// the press explains instead of moving.
					btn.addEventListener( 'click', function ( ev ) {
						var card = bbRailSteps()[ k ];
						var to   = card ? bbSteps().indexOf( card ) : -1;
						bbRailWhy( to < 0 ? card : null );
						if ( to < 0 ) { return; }
						bbStepShow( to, true, 0 === ev.detail );
					} );
				} );
			}
			// THE OWED MARK READS THE GATE, never a private opinion, so what
			// the rail says is short is exactly what the basket will refuse
			// over. Read once for the whole paint.
			var missing = bbAllMissing();
			var blank   = false;
			ol.querySelectorAll( '.bb-rail-step' ).forEach( function ( btn, k ) {
				// ONE NAMELESS STEP AND THE NAMES ARE OFF, waiting ones too:
				// their names are on the row as well.
				// A place found from the rules is nameless only while it waits.
				if ( '' === every[ k ] && ! all[ k ].classList.contains( 'bb-po-autoplace' ) ) { blank = true; }
				// THIS CELL'S PLACE IN THE WALK, or -1 for a step still waiting
				// on an earlier answer. Everything below that reads `i` reads
				// the walk, exactly as it did before the rail drew the rest.
				var i = cards.indexOf( all[ k ] );
				// A PLACE THE ANSWERS RULED OUT slides off the rail. It keeps
				// its node, so bringing it back is the same slide the other
				// way and the shopper's focus is never thrown away.
				var gone = places && i < 0 && bbStepGone( all[ k ] );
				bbRailSlide( rail, btn.parentNode, gone, fresh );
				if ( gone ) {
					btn.classList.remove( 'is-wait', 'is-done', 'is-owed', 'is-now' );
					btn.removeAttribute( 'aria-current' );
					btn.removeAttribute( 'title' );
					return;
				}
				btn.classList.toggle( 'is-wait', i < 0 );
				btn.querySelector( '.bb-rail-n' ).textContent = i < 0 ? '' : String( i + 1 );
				if ( i < 0 ) {
					// NOT A STEP OF THIS WALK YET, so no number (the stylesheet
					// keeps the row's height), no state, and a label and tooltip
					// that say what it is waiting for.
					btn.classList.remove( 'is-done' );
					btn.classList.remove( 'is-owed' );
					btn.classList.remove( 'is-now' );
					btn.removeAttribute( 'aria-current' );
					var why = bbStepWhy( all[ k ], nav );
					if ( why ) {
						btn.setAttribute( 'title', why );
					} else {
						btn.removeAttribute( 'title' );
					}
					btn.setAttribute( 'aria-label', ( every[ k ] && why ) ? every[ k ] + '. ' + why : ( every[ k ] || why ) );
					return;
				}
				btn.removeAttribute( 'title' );
				var ask  = bbStepAsk( cards[ i ] );
				// OWED AND DONE READ THE SAME LIST, or one row carries two
				// scales at once. Done used to mean "every question here has
				// an answer", which held an OPTIONAL question against the
				// shopper: answer the required ones, leave the optional one
				// alone, and the step stayed unfinished while Add to cart was
				// perfectly happy to take it. Green now means what the mark
				// means in reverse, which is the only thing a rail can
				// honestly say: nothing here is owed.
				//
				// It follows that a step whose questions are ALL optional
				// owes nothing from the start: the step stays open, and an
				// extra can be added whenever the shopper likes.
				var owes = ask.some( function ( g ) { return missing.indexOf( g ) > -1; } );
				// A step with no question in it is never done, the same reading
				// the card badges make: a tick beside a paragraph, or beside the
				// review, is a tick that means nothing.
				//
				// BUT A TICK ALSO READS AS "YOU DID THIS". A step ahead that
				// the shopper has neither opened nor answered anything in is
				// not finished, it is untouched, and a row of ticks on steps
				// nobody has seen says the walk is over before it starts. So
				// green waits for one of the two: they have been through the
				// step, or something in it is answered. Nothing is owed either
				// way, so the gate and the amber mark are unchanged.
				var been = bbStepSeen.indexOf( cards[ i ] ) > -1 || ask.some( bbAnswered );
				var done = ask.length > 0 && ! owes && been;
				// A GRID'S QUANTITIES STEP holds no question the gate counts,
				// so it answers for itself: owed while the grid is empty, done
				// once it holds an item. One reading for both, as above.
				var held = bbGridStep( cards[ i ] );
				if ( null !== held ) { owes = held < 1; done = ! owes; }
				// LEFT OWING: a step the shopper has been past and did not
				// finish. Not ahead, not done, and saying so HERE is the whole
				// reason Continue no longer has to block. The mark travels with
				// them instead of waiting at the basket.
				//
				// Only once they have left it. Marking every unfinished step on
				// arrival would paint the entire rail amber on a page nobody
				// has touched, which tells a shopper they have done something
				// wrong before they have done anything at all.
				var seen = bbStepSeen.indexOf( cards[ i ] ) > -1;
				// The same reading as done, negated, so the two can never
				// disagree about one step.
				var owed = seen && owes && i !== bbStepAt;
				btn.classList.toggle( 'is-done', done );
				btn.classList.toggle( 'is-owed', owed );
				btn.classList.toggle( 'is-now', i === bbStepAt );
				if ( i === bbStepAt ) {
					btn.setAttribute( 'aria-current', 'step' );
				} else {
					btn.removeAttribute( 'aria-current' );
				}
				// THE LABEL CARRIES THE WHOLE BURDEN WHERE THE NAMES ARE OFF:
				// all that is left on the screen then is a bar. A step with no
				// readable name falls back to its place in the walk, which is a
				// true thing to say about it, and one left owing says so.
				var name = names[ i ];
				var say = name || ( nav.dataset.of || '' )
					.replace( '%1$s', String( i + 1 ) )
					.replace( '%2$s', String( cards.length ) );
				if ( owed ) {
					say = ( nav.dataset.owed || '%s' ).replace( '%s', say );
				} else if ( i !== bbStepAt ) {
					say = ( nav.dataset.goto || '%s' ).replace( '%s', say );
				}
				btn.setAttribute( 'aria-label', say );
			} );
			// A LINE EXPLAINING A STEP THAT HAS SINCE OPENED is no longer true,
			// and neither is one about a step the page no longer has.
			if ( places ) {
				// A PLACE STILL WAITING IS WALKED, so the line belongs to the
				// place the shopper is standing on, and only while it waits.
				var here = cards[ bbStepAt ] || null;
				var wait = ( here && bbStepWaits( here ) ) ? here : null;
				if ( wait !== bbRailWhyCard ) { bbRailWhy( wait ); }
				// Its shell holds nothing on show, so it would draw an empty
				// box under the line. A class the gate never reads, as with
				// bb-step-off.
				cards.forEach( function ( c ) { c.classList.toggle( 'bb-step-wait', c === wait ); } );
				// The last place still on the rail ends it flush, whichever
				// cell that is now.
				var cells = ol.querySelectorAll( '.bb-rail-cell' );
				var end   = null;
				cells.forEach( function ( c ) { if ( ! c.classList.contains( 'is-gone' ) ) { end = c; } } );
				cells.forEach( function ( c ) { c.classList.toggle( 'is-end', c === end ); } );
			} else if ( bbRailWhyCard && ( cards.indexOf( bbRailWhyCard ) > -1 || all.indexOf( bbRailWhyCard ) < 0 ) ) {
				bbRailWhy( null );
			}
			// WHICH STEP THIS IS, said once on the page. The heading is the
			// thing a shopper reads to know where they are, which is why the
			// names row is allowed to disappear and this is not.
			var of = rail.querySelector( '.bb-rail-of' );
			var at = rail.querySelector( '.bb-rail-now' );
			of.textContent = ( nav.dataset.of || '' )
				.replace( '%1$s', String( bbStepAt + 1 ) )
				.replace( '%2$s', String( cards.length ) );
			at.textContent = names[ bbStepAt ] || '';
			at.hidden = ( '' === at.textContent );
			// ONE NAMELESS STEP AND THE NAMES ARE OFF, the same rule the
			// receipt bar keeps: a row reading "Size, Frame, , Delivery" is
			// worse than a row of plain bars.
			rail.dataset.bbBlank = blank ? '1' : '0';
			// MEASURED IN THE SAME TURN AS THE PAINT, never in a timeout or a
			// frame callback: the browser lays out twice and paints once, so
			// the shopper never sees the names flash in and drop out again.
			bbRailFit( rail, blank );
			bbRailWatch( rail );
			// FOCUS FOLLOWS A DELIBERATE MOVE, and only that. Moving it on
			// every paint would take it off whatever the shopper is typing in;
			// moving it on the first paint would drag the page down to our
			// panel before they have touched anything.
			//
			// FOCUS MOVES EITHER WAY, THE RING ONLY FOR A KEYBOARD. Focus has
			// to land on the heading whatever pressed the step, or a screen
			// reader is never told the page changed under it. A focus ring on
			// a line of large bold text is a different matter: it reads as an
			// editable field.
			//
			// Whether one appears after a programmatic focus is the browser's
			// own :focus-visible heuristic, and the engines do not agree. So
			// the press says which it was and the ring follows that, rather
			// than the ring being whatever the engine happens to decide. The
			// focus itself is never conditional.
			if ( moved && ! at.hidden ) {
				at.classList.toggle( 'bb-rail-quiet', ! byKey );
				at.focus();
			}
		}
		function bbStepMount() {
			if ( ! bbStepsOnly() ) { return; }
			bbStepShow( 0 );
		}
		// THE NAME ON A REVIEW ROW is the question's name and nothing else. The
		// heading it is read from carries the marking pill beside it and, on a
		// capped field, a LIVE character counter; copied whole they became
		// "Name to print (optional) 8/20", which is not what anybody calls that
		// question.
		function bbStepClean( el ) {
			var c = el.cloneNode( true );
			c.querySelectorAll( '.bb-addon-req, .bb-po-reqflag, .bb-gopt, .bb-po-optflag, .bb-addon-counter, .bb-addon-fee, .bb-chip-stock, .screen-reader-text, .bb-step-n' )
				.forEach( function ( x ) { x.remove(); } );
			return ( c.textContent || '' ).replace( /\s+/g, ' ' ).trim();
		}
		function bbStepRowName( group ) {
			var el = bbTickName( group ) || group.querySelector( '.bb-addon-check' );
			var own = el ? bbStepClean( el ) : '';
			if ( own ) { return own; }
			var sec = group.closest ? group.closest( '.bb-po-section' ) : null;
			var h = sec ? sec.querySelector( '.bb-po-sectionname .bb-attr-name, summary .bb-attr-name' ) : null;
			return h ? bbStepClean( h ) : '';
		}
		// WHAT A QUESTION IS HOLDING, as markup, taken from the echo the page
		// already keeps for it: a price rendered by a dual-basis plugin survives
		// into the review instead of being flattened into one figure. A field has
		// no echo, so its own value is read and escaped.
		function bbStepRowVal( group, rows ) {
			var e = group.querySelector( '.bb-gecho' );
			if ( e ) { return bbAnswered( group ) ? e.innerHTML : ''; }
			// A TICK-BOX ANSWERS ITSELF. Its label is the question AND the
			// answer, so the row came out "Gift wrap = Gift wrap". What the
			// shopper wants to read back is whether it is on.
			var chk = group.querySelector( '.bb-addon-check input[type="checkbox"]' );
			if ( chk ) { return chk.checked ? bbEsc( rows.dataset.yes || '' ) : ''; }
			var t = bbFieldEcho( group );
			return ( null === t || '' === t ) ? '' : bbEsc( t );
		}
		// THE REVIEW IS NOT A SECOND RECEIPT. The total below it already prints
		// the money, line by line. What the review adds is the two things a
		// receipt can never show: the questions with NOTHING in them, and a way
		// back to each one.
		//
		// Rebuilt only when something it shows has changed, because a rebuild
		// throws away the keyboard: a shopper tabbing down the rows would lose
		// their place on every keystroke typed three steps above.
		function bbStepReview( rows ) {
			var owed = bbAllMissing();
			var seen = [];
			var byKey = {};
			bbGroups().forEach( function ( g ) {
				if ( g.hidden || ! bbActionable( g ) || bbVarInert( g ) || ! bbAsks( g ) ) { return; }
				if ( g.closest && g.closest( '.bb-po-review' ) ) { return; }
				var name = bbStepRowName( g );
				if ( ! name ) { return; }
				var val = bbStepRowVal( g, rows );
				// ONE ROW PER QUESTION AS THE SHOPPER NAMES IT. Two tick-boxes
				// in a group called "Finishing" have no names of their own, so
				// both fell back to the group's and the review printed
				// "Finishing" twice with different answers beside it, which
				// reads as a bug. They are one question with two answers.
				if ( byKey[ name ] ) {
					if ( val ) { byKey[ name ].vals.push( val ); }
					// Still owed if ANY of them is.
					byKey[ name ].owed = byKey[ name ].owed || owed.indexOf( g ) !== -1;
					return;
				}
				byKey[ name ] = { g: g, k: name, vals: val ? [ val ] : [], owed: owed.indexOf( g ) !== -1 };
				seen.push( byKey[ name ] );
			} );
			// On a quantity grid walking its quantities, they are the first row.
			var lead = bbGridReviewRow();
			if ( lead ) { seen.unshift( lead ); }
			var sig = seen.map( function ( r ) { return r.k + '\u0001' + r.vals.join( ', ' ) + '\u0001' + ( r.owed ? '1' : '0' ); } ).join( '\u0002' );
			if ( rows.dataset.bbSig === sig ) { return; }
			rows.dataset.bbSig = sig;
			rows.textContent = '';
			seen.forEach( function ( r ) {
				var blank = ! r.vals.length;
				var row = document.createElement( 'div' );
				// OWED MEANS THE BUTTON WILL REFUSE, not merely "empty". Twelve
				// optional fields left alone are not twelve problems, and a
				// review shouting at a shopper whose basket is perfectly ready
				// is the error screen this layout exists to replace.
				row.className = 'bb-review-row' + ( r.owed ? ' is-owed' : '' ) + ( blank ? ' is-blank' : '' );
				var k = document.createElement( 'span' );
				k.className = 'bb-review-k';
				k.setAttribute( 'dir', 'auto' );
				k.textContent = r.k;
				var v = document.createElement( 'span' );
				v.className = 'bb-review-v';
				v.setAttribute( 'dir', 'auto' );
				// A blank answer SAYS so rather than sitting empty: a gap in a
				// review reads as a bug even when nothing is wrong.
				if ( blank ) { v.textContent = rows.dataset.none || ''; } else { v.innerHTML = r.vals.join( ', ' ); }
				var b = document.createElement( 'button' );
				b.type = 'button';
				b.className = 'bb-review-go';
				b.textContent = ( blank ? rows.dataset.choose : rows.dataset.change ) || '';
				// Twelve buttons all reading "Change" is one button to a screen
				// reader, so each one says which question it is for.
				b.setAttribute( 'aria-label', ( ( blank ? rows.dataset.chooseLabel : rows.dataset.changeLabel ) || '%s' ).replace( '%s', r.k ) );
				// THE QUESTION IS ON ANOTHER SCREEN. In Step by step every card
				// but the current one is off the page, and the review is the
				// last card, so every row here points at a hidden group. bbGoTo
				// only scrolls and focuses, which a hidden group cannot do:
				// measured on the pet portrait, Choose and Change did nothing
				// at all. Walk to the step holding the group (and open its
				// fold) the way the gate does for a gap, then land on it.
				b.addEventListener( 'click', function () { bbReveal( r.g ); bbGoTo( r.g ); } );
				row.appendChild( k );
				row.appendChild( v );
				row.appendChild( b );
				rows.appendChild( row );
			} );
		}
		function bbStepSync() {
			// THE POSITION IS A CARD, NEVER A NUMBER, and this is where that
			// matters. A conditional rule can empty a whole step: bbStepCards
			// counts only questions actually being asked, so answering "we
			// already hold your artwork" removes the artwork step from the
			// walk. bbStepAt is an index into that list, and the list just got
			// shorter, so the shopper standing on Finish was silently moved
			// onto Check your answers with the same number under them.
			//
			// Re-seat on the card they were on. If their OWN step is the one
			// that went, the clamp lands them on the step that took its place,
			// which is the nearest true answer to where they were.
			var live = bbSteps();
			if ( bbStepCard && live.length ) {
				var seat = live.indexOf( bbStepCard );
				if ( seat > -1 ) {
					bbStepAt = seat;
				} else {
					bbStepAt = Math.min( bbStepAt, live.length - 1 );
					bbStepCard = live[ bbStepAt ] || null;
				}
				bbStepPaint( live, bbStepAt );
				bbStepNav( live );
			}
			// The rail's ticks and its names both move with the answers, so it
			// repaints on the same wave as everything else rather than only
			// when the shopper changes step.
			bbRailPaint();
			// The two switches are independent: a page can number without a
			// review, review without numbers, or do both.
			var root = bbStepsOn();
			if ( root ) {
				bbStepMark();
				bbStepCards( root ).forEach( function ( card ) {
					var badge = card.querySelector( '.bb-step-n' );
					if ( ! badge ) { return; }
					var ask = bbStepAsk( card );
					// A step with no question in it is never done: a tick beside
					// a paragraph is a tick that means nothing.
					badge.classList.toggle( 'is-done', ask.length > 0 && ask.every( bbAnswered ) );
				} );
			}
			var rev = document.querySelector( '.bb-standalone-options .bb-po-review' );
			if ( ! rev ) { return; }
			var rows = rev.querySelector( '.bb-review-rows' );
			if ( rows ) { bbStepReview( rows ); }
			// The review's verdict is the bar's own count, so the two figures on
			// one screen are one reading: Ready is what the button will accept.
			var owed = bbLeftCount();
			// An empty quantity grid is one more thing still to choose: its
			// button refuses over it exactly as it does over a missing answer.
			var gridRoot = bbStepsOnly();
			if ( gridRoot && 0 === bbGridStep( bbGridQty( gridRoot ) ) ) { owed++; }
			var say = rev.querySelector( '.bb-step-verdict' );
			if ( ! say ) { return; }
			say.textContent = owed
				? ( say.dataset.left || '' ).replace( '%s', String( owed ) )
				: ( say.dataset.ready || '' );
			say.classList.toggle( 'is-owed', owed > 0 );
			say.classList.toggle( 'is-ready', 0 === owed );
		}
		// WHAT THE BAR STILL OWES, counted from the gate's own reading so the
		// two can never disagree: what this number says is owed is exactly what
		// the button will refuse over.
		//
		// Minus one case. A box whose number is out of its bounds is not
		// something still to CHOOSE, it is something already answered wrongly,
		// and it is already shouting in red at the field in its own words.
		// Counting it here would put a figure on the bar that no amount of
		// choosing brings down.
		//
		// A typed size the box itself is refusing is the same case: past a
		// price list's limits, off a measurement's rails, a size the list
		// cannot price, or letters where a number goes. The box already says
		// which, so the bar saying "Still to choose" about a size the shopper
		// has just typed contradicted it.
		function bbAnsweredWrong( g ) {
			return !! ( g.dataset && g.dataset.bbStop ) || !! g.querySelector( '[data-bb-refused], .bb-tbl-bad, .bb-mdim-box.is-bad' );
		}
		function bbLeftAsks( g ) {
			return ! bbPriceOut( g ) && ! bbFieldBad( g ) && ! bbAnsweredWrong( g );
		}
		function bbLeftCount() {
			return bbAllMissing().filter( bbLeftAsks ).length;
		}
		// A control that has to go while it holds the focus hands it on to the
		// next one along, as Tab would have, never to the top of the page.
		function bbFocusOnward( from ) {
			var all = document.querySelectorAll( 'a[href], button, input, select, textarea, [tabindex]' );
			for ( var i = 0; i < all.length; i++ ) {
				var c = all[ i ];
				if ( from.contains( c ) || ! ( from.compareDocumentPosition( c ) & 4 ) ) { continue; }
				if ( c.disabled || c.tabIndex < 0 || 'hidden' === c.type || ! c.getClientRects().length ) { continue; }
				c.focus();
				return;
			}
		}
		// The sentence, in both places it belongs: the receipt's own bar, and
		// the phone bar standing in for it. One reading, so the two cannot
		// contradict each other on the same screen.
		// WHICH ONES. The group's own name, read the way the review rows read
		// it, so the bar and the review can never call the same question two
		// different things. A group with no readable name gives nothing back,
		// and the whole sentence falls to the plain count.
		// THE NAME ELEMENT, NOT THE HEADING ROW. A group's head carries the name
		// AND the live echo beside it, so reading the row whole gave "SO Colours
		// Choose": the word the echo prints while nothing is picked, glued to
		// the question it belongs to. bbStepClean strips the marking pills and
		// the counter, which is what it was written for, but the echo is a
		// SIBLING of the name, not part of it.
		//
		// ONE reader for every place a question is named back to the shopper:
		// the bar, the rail above the questions, and the review rows. Two
		// readers is how the same question ends up with two names on one screen.
		// The first two branches are the section heads, which only a card that
		// IS a whole section has.
		function bbAskName( card ) {
			// A place found from the rules is named by the list it shows; while
			// all of them wait it has no name of its own (the line under the
			// rail says what it waits for), never the name of one it may not be.
			if ( card.classList.contains( 'bb-po-autoplace' ) ) {
				card = bbPlaceShows( card );
				if ( ! card ) { return ''; }
			}
			var host = card.querySelector( ':scope > summary .bb-attr-name' )
				|| card.querySelector( ':scope > .bb-po-sectionname .bb-attr-name' )
				|| card.querySelector( '.bb-ghead .bb-attr-name' )
				|| card.querySelector( '.bb-grid-woset-head .bb-grid-woset-name' )
				|| card.querySelector( '.bb-addon-label:not(.screen-reader-text)' )
				// A quantity grid's quantities step is named by its own heading.
				|| card.querySelector( ':scope > .bb-grid-head .bb-grid-instruction' );
			return host ? bbStepClean( host ) : '';
		}
		function bbLeftNames( owed ) {
			var out = [];
			for ( var i = 0; i < owed.length; i++ ) {
				var name = bbAskName( owed[ i ] );
				if ( '' === name ) { return []; } // one nameless question and naming is off.
				out.push( name );
			}
			return out;
		}
		// A REFUSED BOX IS NAMED IN ITS OWN WORDS. A size past its limit is not
		// still to choose, but it still stops the add, and the bar said nothing
		// at all: Width 1600 on a list that ends at 1500 left the summary at
		// "from £45.00" with Add to cart looking ready (tester round 4). The bar
		// says what the box says, "Width: Maximum 1500 mm", with its Show me.
		function bbWrongWords( g ) {
			// The till's own sentence names the choice ("Bevelling cannot be
			// ordered online yet."), so it is said as it stands.
			if ( g.dataset && g.dataset.bbStop ) { return g.dataset.bbStop; }
			var bad = g.querySelector( '.bb-tbl-bad, [data-bb-refused], .bb-mdim-box.is-bad' );
			if ( ! bad ) { return ''; }
			// A box that already says why at the box says the same here: a size
			// off the steps read "Width: 100 to 2440 mm" beside its own line
			// naming 600 or 601 (walk 5, 30 Oct 2026).
			var said = g.querySelector( '[data-bb-snap]' );
			if ( said && said.dataset.bbSnap ) { return said.dataset.bbSnap; }
			// Pieces turned to fit say their limits once, for the pair.
			var pair = g.querySelector( '.bb-mturn-say' );
			if ( pair && pair.textContent ) { return String( pair.textContent ).trim(); }
			var lab  = bad.closest( 'label' );
			var name = lab ? lab.querySelector( '.bb-tbl-axislab, .bb-mdim-name' ) : null;
			var nid  = bad.getAttribute( 'aria-describedby' ) || '';
			var note = '' !== nid ? document.getElementById( nid ) : ( lab ? lab.querySelector( '.bb-mdim-range' ) : null );
			var unit = ( '' === nid && lab ) ? lab.querySelector( '.bb-mdim-unit' ) : null;
			var says = note ? String( note.textContent || '' ).trim() : '';
			if ( '' === says ) {
				// A size no limit explains: the list's own sentence under the box.
				var pn = g.querySelector( '.bb-tbl-pricenote' );
				says = pn ? String( pn.textContent || '' ).trim() : '';
			} else if ( unit && unit.textContent ) {
				// A hint that names its unit already ("Min: 100 mm · Max:
				// 1830 mm") is not given it twice.
				var ut = String( unit.textContent ).trim();
				if ( says.slice( -ut.length ) !== ut ) { says += ' ' + ut; }
			}
			if ( '' === says ) { return ''; }
			var who = name ? String( name.textContent || '' ).trim() : '';
			return '' !== who ? who + ': ' + says : says;
		}
		function bbLeftSay() {
			// ON A QUANTITY GRID the line names what the grid's own button waits
			// for, which the grid publishes on every tally (nothing until there
			// is an order to hold), so the line and the button read one list.
			var grid = document.querySelector( '.bb-standalone-grid' );
			var owed = grid ? ( grid.bbGridOwed || [] ).slice() : bbAllMissing().filter( bbLeftAsks );
			var n    = owed.length;
			var el   = document.querySelector( '.bb-standalone-total .bb-st-left' ) || ( grid ? grid.querySelector( '.bb-grid-left' ) : null );
			var say  = '';
			var wrong = grid ? [] : bbAllMissing().filter( bbAnsweredWrong );
			var why   = wrong.length ? bbWrongWords( wrong[0] ) : '';
			if ( '' !== why && el ) {
				say = why;
				// Show me goes to the first thing that stops the add, in page order.
				owed = bbAllMissing().filter( function ( g ) { return bbLeftAsks( g ) || bbAnsweredWrong( g ); } );
			} else if ( n > 0 && el ) {
				// Two are named and the rest counted, but a count of one is no
				// shorter than the name it stands for: "Sign size, Thickness and
				// 1 more" names all three now (tester round 4).
				var names = bbLeftNames( owed.slice( 0, 3 === n ? 3 : 2 ) );
				if ( names.length ) {
					say = ( el.dataset.which || '' ).replace( '%s', names.join( ', ' ) );
					if ( n > names.length ) {
						say += ' ' + ( el.dataset.more || '' ).replace( '%s', String( n - names.length ) );
					}
				} else {
					// Both forms carry the placeholder, so the fill is the same
					// step whichever the language picked.
					say = ( ( 1 === n ? el.dataset.one : el.dataset.many ) || '' ).replace( '%s', String( n ) );
				}
			}
			// A BUTTON, NOT A LINK, and built rather than printed: it only means
			// anything while something is owed, and a printed one would sit on a
			// finished page pointing at nothing. It goes to the FIRST owed
			// question through the gate's own walk, so pressing it lands exactly
			// where Add to cart would have sent them.
			//
			// ONE BUTTON, KEPT. The line used to be rewritten on every change,
			// throwing its Show me away and building a new one. Leaving a size
			// box is such a change, so a shopper who pressed Tab out of the box
			// landed on a Show me that was removed under them, and the keyboard
			// fell to the top of the page. The words change in place; the button
			// stays the same element and reads its target when pressed.
			var wire = function ( host, word ) {
				if ( ! host ) { return; }
				host.hidden = ( '' === say );
				var b = host.querySelector( '.bb-st-show' );
				if ( '' === say || ! word ) {
					if ( b && b === document.activeElement ) { bbFocusOnward( host ); }
					host.textContent = say;
					return;
				}
				var t = host.firstChild;
				if ( ! t || 3 !== t.nodeType ) {
					host.textContent = '';
					t = host.appendChild( document.createTextNode( '' ) );
					b = null;
				}
				if ( t.nodeValue !== say + ' ' ) { t.nodeValue = say + ' '; }
				if ( ! b ) {
					b = document.createElement( 'button' );
					b.type      = 'button';
					b.className = 'bb-st-show';
					b.addEventListener( 'click', function () { if ( b.bbOwed ) { bbMissMark( b.bbOwed, false ); } } );
					host.appendChild( b );
				}
				if ( b.textContent !== word ) { b.textContent = word; }
				b.bbOwed = owed[0];
			};
			wire( el, el ? el.dataset.show : '' );
			if ( bbPeekBar ) {
				// Nothing owed means the line GOES, rather than announcing that
				// it is finished: the button is right there and says the rest.
				wire( bbPeekBar.querySelector( '.bb-peek-left' ), el ? el.dataset.show : '' );
			}
		}
		// The scope line: how many REQUIRED questions are on show and how many
		// are answered. It counted every question once, optional ones too, so a
		// shopper with everything required done read "1 of 3 chosen" as two
		// still to go, and a page of optional extras read "0 of 2" as two owed.
		// An optional question is never a debt, so it is not in the count, and
		// the line goes green on the gate's own word: nothing left that Add to
		// cart would refuse over. The ticks ride the same walk, every question
		// included, so a mark can never disagree with the line, and they are
		// painted BEFORE the line's own early exits: a panel with a single group
		// still marks it, and a page with no line at all still marks every one.
		function bbScope() {
			var total = 0, done = 0;
			bbGroups().forEach( function ( g ) {
				// A grid's whole-order set is marked from the grid's own reading
				// and counted by the grid's own footer, so it takes the tick and
				// leaves the scope line alone. (A grid page prints no scope line
				// at all; counting it here would invent a second tally.)
				if ( g.classList.contains( 'bb-grid-woset' ) ) { bbTick( g, ! g.hidden && bbGridSetDone( g ) ); return; }
				// A group nobody is being asked right now carries no tick: a
				// conditional set that closed again must not keep the one it
				// earned while it was open.
				if ( g.hidden || ! bbActionable( g ) || bbVarInert( g ) || ! bbAsks( g ) ) { bbTick( g, false ); return; }
				// Answered, and answered with something the shop can use: a
				// wrongly typed email is not a finished question and must not
				// wear the tick.
				// Nor a size whose price still waits on another choice (a
				// shutter before its handle side): named, but not done.
				// The count still counts that size: typed and inside the limits,
				// it is chosen ("0 of 2 chosen" stood under a typed size, walk 3).
				var given = bbAnswered( g ) && ! bbFieldBad( g ) && ! g.querySelector( '[data-bb-refused]' );
				var ok = given && ! g.querySelector( '[data-bb-wait]' );
				bbTick( g, ok );
				if ( '1' !== g.dataset.req ) { return; }
				total++;
				if ( given ) { done++; }
			} );
			bbLeftSay();
			bbStepSync();
			bbSheetSync();
			var prog = document.querySelector( '.bb-standalone-options .bb-progress' );
			if ( ! prog ) { return; }
			// Woo's variation form, a question per attribute, so the line can
			// never read finished while the basket is still refusing the submit.
			// A quantity grid draws no such form: its variations ARE the grid,
			// and it prints no line of this kind at all.
			var bbVf = bbVarForm();
			if ( bbVf ) {
				var bbVq = bbVarFormCount( bbVf );
				total += bbVq.total;
				done += bbVq.done;
			}
			// Step by step, the rail is the count ("Step 2 of 3"), and this line
			// under it read "1 of 3 chosen", then "2 of 4" as an answer opened
			// another list (walk, 27 Oct 2026). What is still owed is named in
			// the bar by the basket button either way.
			if ( total < 2 || bbStepsOnly() ) { prog.hidden = true; return; }
			prog.hidden = false;
			prog.textContent = ( prog.dataset.tpl || '' ).replace( '%1$s', String( total ) ).replace( '%2$s', String( done ) );
			// Finished scope reads in the good green, the gallery's language,
			// and only when the gate agrees: green is "nothing owed", never
			// "every box has something in it".
			prog.classList.toggle( 'bb-prog-done', done === total && ! bbAllMissing().length );
		}
		// ── The add-to-cart gate: a courtesy, never the authority. ─────────
		// The server's validation stays the enforcer, exactly as it is; this
		// only saves the shopper the round trip that lands the answer in a
		// theme notice at the top of the page, far from the field. The button
		// stays enabled (a disabled submit is a dead control with no
		// explanation); a blocked attempt marks EVERY unanswered required group
		// with the same accent the Choose echo already wears, then scrolls to
		// the first of them and moves focus there.
		//
		// EVERY GAP, NOT THE FIRST ONE. Naming one at a time turns a form with
		// three holes in it into three trips to the button, and the shopper
		// only learns how much is left by finishing it. The page knows them all
		// at the moment of the press, so it says them all. Only the first is
		// scrolled to and focused, because a summons to three places at once is
		// no summons at all.
		// A SECTION THAT ASKS FOR AT LEAST ONE ANSWER. The panel carries the
		// rule as data (its questions by the names this page already reads, and
		// the shop's sentence); a section is owed when none of the questions
		// on show has an answer. Only what is on show counts, exactly as the
		// server judges it, so a section a rule has emptied asks for nothing.
		// The FIRST question on show carries the sentence, because that is
		// where the eye lands and one summons is better than three.
		function bbSectionOwed() {
			var out = [];
			document.querySelectorAll( '.bb-standalone-options[data-bb-sections]' ).forEach( function ( host, hi ) {
				var rules = [];
				try { rules = JSON.parse( host.dataset.bbSections || '[]' ) || []; } catch ( e ) { rules = []; }
				var scope = host.closest( '.bb-standalone-grid' ) || host.closest( 'form' ) || document;
				rules.forEach( function ( r, ri ) {
					var shown = [], said = false;
					( r.m || [] ).forEach( function ( m ) {
						var sel = m.f
							? '[name="bb_pf[' + m.f + ']"], [name^="bb_pf[' + m.f + ']["]'
							: '[data-attribute="' + m.s + '"]';
						// The phone sheet lifts a card out of the form onto <body>, so
						// a card it holds is still this section's.
						var el = scope.querySelector( sel ) || ( bbSheet ? bbSheet.querySelector( sel ) : null );
						var g = el && el.closest ? el.closest( '.bb-attr-group' ) : null;
						if ( ! g || g.hidden || ! bbActionable( g ) ) { return; }
						shown.push( g );
						if ( ! said && bbAnswered( g ) ) { said = true; }
					} );
					if ( shown.length && ! said ) { out.push( { g: shown[0], msg: r.msg || '', all: shown, key: hi + ':' + ri, host: host } ); }
				} );
			} );
			return out;
		}
		window.bbSectionOwed = bbSectionOwed;
		// WHAT THE ADD WOULD REFUSE OVER, INSIDE ONE SCOPE, for a surface that
		// keeps its own button. The quantity grid asks it for the questions in
		// its whole-order area: it counted its sets and sections and never its
		// fields, so a required one left empty was refused at the till. The
		// bar's own reading, so the grid's line and button name the same gaps.
		window.bbOwedIn = function ( scope ) {
			return bbAllMissing().filter( function ( g ) { return !! scope && scope.contains( g ) && bbLeftAsks( g ); } );
		};
		// THE BAR OVER AN OWED SECTION. One sentence for the section, above its
		// first question on show, and each of its questions as a button that
		// jumps there, because "at least one of these" is a choice of where to
		// go, not a fault in the first card. Its members wear one quiet edge.
		// Called with exactly the sections that should show a bar now; every
		// other bar this page drew goes, and its members lose the edge.
		function bbSecName( g ) {
			var h = g.querySelector( '.bb-grid-woset-name' ) || g.querySelector( '.bb-ghead .bb-attr-name' ) || g.querySelector( '.bb-attr-name' );
			if ( ! h ) { return ''; }
			var t = '';
			h.childNodes.forEach( function ( n ) { if ( 3 === n.nodeType ) { t += n.textContent; } } );
			return t.replace( /\s+/g, ' ' ).trim();
		}
		function bbSecBands( list, owner ) {
			owner = owner || 'page';
			var want = {};
			list.forEach( function ( o ) { want[ o.key ] = o; } );
			document.querySelectorAll( '.bb-sec-band' ).forEach( function ( band ) {
				if ( want[ band.dataset.bbSecKey ] || ( band.dataset.bbSecOwner || 'page' ) !== owner ) { return; }
				( band.bbMembers || [] ).forEach( function ( m ) { m.classList.remove( 'bb-sec-member', 'bb-sec-flash' ); m.removeAttribute( 'aria-describedby' ); } );
				if ( band.bbFirst ) { band.bbFirst.bbSecBand = null; }
				band.remove();
			} );
			list.forEach( function ( o ) {
				var band = document.querySelector( '.bb-sec-band[data-bb-sec-key="' + o.key + '"]' );
				if ( ! band ) {
					band = document.createElement( 'div' );
					band.className = 'bb-sec-band';
					band.id = 'bb-sec-band-' + o.key.replace( ':', '-' );
					band.dataset.bbSecKey = o.key;
					band.dataset.bbSecOwner = owner;
					band.setAttribute( 'role', 'status' );
					band.setAttribute( 'aria-live', 'polite' );
					band.innerHTML = '<span class="bb-sec-band-icon" aria-hidden="true">!</span><div class="bb-sec-band-body"><p class="bb-sec-band-msg"></p><div class="bb-sec-band-go"></div></div>';
				}
				// Always directly above the first question on show: a rule can
				// hide the one it sat over, and the phone sheet can move them.
				if ( o.g.parentNode && band.nextSibling !== o.g ) { o.g.parentNode.insertBefore( band, o.g ); }
				if ( band.bbFirst && band.bbFirst !== o.g ) { band.bbFirst.bbSecBand = null; }
				band.bbFirst = o.g;
				o.g.bbSecBand = band;
				band.querySelector( '.bb-sec-band-msg' ).textContent = o.msg;
				var go = band.querySelector( '.bb-sec-band-go' );
				var sig = o.all.map( bbSecName ).join( '\u0001' );
				if ( go.dataset.bbSig !== sig ) {
					go.dataset.bbSig = sig;
					go.textContent = '';
					var lead = document.createElement( 'span' );
					lead.textContent = ( o.host && o.host.dataset.bbSecAny ) || '';
					go.appendChild( lead );
					o.all.forEach( function ( m ) {
						var name = bbSecName( m );
						if ( ! name ) { return; }
						var b = document.createElement( 'button' );
						b.type = 'button';
						b.className = 'bb-sec-band-chip';
						b.textContent = name;
						b.addEventListener( 'click', function () {
							bbGoTo( m );
							m.classList.remove( 'bb-sec-flash' );
							void m.offsetWidth;
							m.classList.add( 'bb-sec-flash' );
						} );
						go.appendChild( b );
					} );
					go.hidden = go.querySelectorAll( 'button' ).length < 2;
				}
				( band.bbMembers || [] ).forEach( function ( m ) {
					if ( o.all.indexOf( m ) === -1 ) { m.classList.remove( 'bb-sec-member', 'bb-sec-flash' ); m.removeAttribute( 'aria-describedby' ); }
				} );
				band.bbMembers = o.all.slice();
				o.all.forEach( function ( m ) {
					m.classList.add( 'bb-sec-member' );
					m.setAttribute( 'aria-describedby', band.id );
				} );
			} );
		}
		window.bbSecBands = bbSecBands;
		// On the page a bar shows once the shopper has tried to add (the same
		// moment every other gap is marked) and stays until the section is met.
		var bbSecShown = {};
		function bbSecRefresh() {
			var owed = bbSectionOwed();
			var live = {};
			owed.forEach( function ( o ) { live[ o.key ] = 1; } );
			Object.keys( bbSecShown ).forEach( function ( k ) { if ( ! live[ k ] ) { delete bbSecShown[ k ]; } } );
			bbSecBands( owed.filter( function ( o ) { return bbSecShown[ o.key ] && ! o.g.closest( '.bb-standalone-grid' ); } ) );
		}
		// ONE ANSWER IS NOT A QUESTION (#121). A required set that is showing,
		// has nothing picked and can be answered only one way (the other
		// choices sold out, ruled out, or simply not there) is answered for the
		// shopper: a shopper once stood in front of a frame set offering one
		// profile and did not realise it still had to be picked. It goes
		// through the same click a shopper makes, so the price, the echo, the
		// photo and the rules all follow.
		//
		// - Never an optional set: that would add a charge nobody asked for. A
		//   several-of set short of its "at least" counts as required.
		// - An answer the page arrived with (from the cart, or the address) is
		//   a pick, so the set is answered and left alone.
		// - The only answer a required set has stays picked when tapped: taking
		//   it back left the shopper at "Choose" with nothing to choose (fresh
		//   tester, 18 Oct 2026). An answer that is one of several again (a rule
		//   lifted, a size back in stock) can be taken back, and that set is not
		//   answered for them again until it hides and shows again.
		// - Picking one can reveal another such set, so it looks again, a few
		//   passes at most.
		var bbAutoBusy = false;
		function bbAutoOne( g ) {
			if ( g.hidden || g.dataset.bbAutoNo || ! bbActionable( g ) || bbAnswered( g ) ) { return null; }
			if ( '1' !== g.dataset.req && ! bbMultiShort( g ) ) { return null; }
			var box = g.querySelector( '.bb-chips' );
			if ( ! box || box.closest( '.bb-standalone-grid' ) ) { return null; }
			var open = Array.prototype.filter.call( box.querySelectorAll( '.bb-chip' ), function ( c ) {
				return ! c.disabled && 'true' !== c.getAttribute( 'aria-disabled' ) && ! c.hidden && c.getClientRects().length > 0;
			} );
			return 1 === open.length ? open[ 0 ] : null;
		}
		function bbAutoPick() {
			if ( bbAutoBusy ) { return; }
			bbAutoBusy = true;
			try {
				for ( var pass = 0; pass < 5; pass++ ) {
					var picked = false;
					bbGroups().forEach( function ( g ) {
						var only = bbAutoOne( g );
						if ( ! only ) { return; }
						g.dataset.bbAuto = only.dataset.value || '1';
						only.click();
						picked = true;
					} );
					if ( ! picked ) { break; }
				}
			} finally {
				bbAutoBusy = false;
			}
		}
		document.addEventListener( 'bb-reveal-change', function () { bbAutoPick(); } );
		// The shopper's own tap on the picked answer, which takes it back. Heard
		// before the pick handler, whose rules would otherwise answer the set
		// again in the same tap.
		document.addEventListener( 'click', function ( e ) {
			if ( ! e.isTrusted ) { return; }
			var chip = e.target.closest ? e.target.closest( '.bb-chip.is-selected' ) : null;
			var g    = chip ? chip.closest( '.bb-attr-group[data-bb-auto]' ) : null;
			if ( ! g ) { return; }
			if ( bbOnlyAnswer( g, chip ) ) {
				e.preventDefault();
				e.stopPropagation();
				return;
			}
			g.dataset.bbAutoNo = '1';
		}, true );
		function bbOnlyAnswer( g, chip ) {
			if ( '1' !== g.dataset.req ) { return false; }
			var box = g.querySelector( '.bb-chips' );
			var open = box ? Array.prototype.filter.call( box.querySelectorAll( '.bb-chip' ), function ( c ) {
				return ! c.disabled && 'true' !== c.getAttribute( 'aria-disabled' ) && ! c.hidden && c.getClientRects().length > 0;
			} ) : [];
			return 1 === open.length && open[ 0 ] === chip;
		}
		// A set that hides takes its answer with it, auto-picked or not, and is
		// a fresh question when it shows again.
		document.addEventListener( 'bb-clear-group', function ( e ) {
			var g = e.target && e.target.closest ? e.target.closest( '.bb-attr-group' ) : null;
			if ( g ) { delete g.dataset.bbAuto; delete g.dataset.bbAutoNo; }
		} );
		// WHAT THE QUANTITY BOX COUNTS. On a product priced by a pack list the
		// box counts packs and says so over it, in the panel's words. The
		// theme's own label for the box is reused, shown and renamed, so a
		// screen reader hears one name for it, not two.
		function bbQtySay() {
			var root = document.querySelector( '.bb-standalone-options[data-bb-qty-say]' );
			if ( ! root ) { return; }
			var form = root.closest( 'form' ) || document.querySelector( 'form.cart' );
			var qty  = form ? form.querySelector( '.quantity input.qty' ) : null;
			if ( ! qty || 'hidden' === qty.type ) { return; }
			var lab = qty.id ? form.querySelector( 'label[for="' + qty.id + '"]' ) : null;
			if ( ! lab ) {
				lab = document.createElement( 'label' );
				if ( qty.id ) { lab.htmlFor = qty.id; }
				qty.parentNode.insertBefore( lab, qty );
			}
			lab.classList.remove( 'screen-reader-text' );
			lab.classList.add( 'bb-qty-say' );
			lab.textContent = root.dataset.bbQtySay;
		}
		function bbAllMissing() {
			var out = [];
			// The section's sentence rides the card it is painted on, and only
			// while the section is owed.
			document.querySelectorAll( '.bb-attr-group[data-bb-sec-msg]' ).forEach( function ( g ) { delete g.dataset.bbSecMsg; } );
			bbSectionOwed().forEach( function ( o ) {
				o.g.dataset.bbSecMsg = o.msg;
				o.g.dataset.bbSecKey = o.key;
				o.g.dataset.bbSecMark = '1';
				o.g.bbSecAll = o.all;
				out.push( o.g );
			} );
			bbGroups().forEach( function ( g ) {
				if ( out.indexOf( g ) > -1 ) { return; }
				if ( g.hidden || ! bbActionable( g ) || bbVarInert( g ) || ! bbAsks( g ) ) { return; }
				// A box holding something the server would refuse (a size past a
				// price list's limits) blocks too, required or not.
				if ( g.querySelector( '[data-bb-refused]' ) ) { out.push( g ); return; }
				if ( '1' === g.dataset.req && ! bbAnswered( g ) ) { out.push( g ); return; }
				// A several-of group short of its at-least bound blocks too,
				// required or not: the server would refuse this exact submit.
				if ( bbMultiShort( g ) ) { out.push( g ); return; }
				// So does an amount outside the bounds the field prints under it:
				// same reason, and the shopper is reading those bounds right there.
				if ( bbPriceOut( g ) || bbFieldBad( g ) ) { out.push( g ); }
			} );
			// Page order, so the first gap named is the first one on the page.
			out.sort( function ( a, b ) { return ( a.compareDocumentPosition( b ) & 4 ) ? -1 : 1; } );
			return out;
		}
		// Kept as the one-group reader the rest of the page asks for.
		function bbFirstMissing() {
			return bbAllMissing()[0] || null;
		}
		// The mark leaves the moment the group is answered (or stops being
		// asked at all), so nobody finishes a field that stays accused; its
		// sentence leaves with it.
		function bbMissSync() {
			var bbOwedNow = null;
			document.querySelectorAll( '.bb-standalone-options .bb-attr-group.bb-gmiss' ).forEach( function ( g ) {
				// A card marked for its SECTION stays marked only while the section
				// is owed: answering any other question in it settles it.
				var bySection = '1' === g.dataset.bbSecMark && '1' !== g.dataset.req;
				if ( bySection ) {
					if ( null === bbOwedNow ) { bbOwedNow = bbSectionOwed().map( function ( o ) { return o.g; } ); }
					if ( ! g.hidden && bbActionable( g ) && bbOwedNow.indexOf( g ) > -1 ) { return; }
					delete g.dataset.bbSecMark;
				} else if ( ! g.hidden && bbActionable( g ) && ! bbVarInert( g )
				&& ( ! bbAnswered( g ) || bbMultiShort( g ) || bbPriceOut( g ) || bbFieldBad( g ) ) ) { return; }
				g.classList.remove( 'bb-gmiss' );
				g.querySelectorAll( '[aria-invalid="true"]' ).forEach( function ( el ) { el.removeAttribute( 'aria-invalid' ); } );
				g.querySelectorAll( '.bb-gmiss-note' ).forEach( function ( gnote ) {
					gnote.textContent = '';
					gnote.hidden = true;
				} );
			} );
			// A section's bar leaves with the section's debt, whichever of its
			// questions settled it.
			bbSecRefresh();
		}
		// The paint and the sentence, with no scroll and no focus grab: this half
		// is safe to run while the shopper is still moving around the form.
		// A MARKED CARD THAT IS HIDDEN IS A CONTRADICTION, so being marked and
		// being visible are one act.
		//
		// This used to live in bbGoTo, and the gate only reaches bbGoTo for the
		// FIRST gap, after a branch: on a phone whose shop turned the missing
		// choices sheet on, the gate lifts the gaps to the button and returns
		// before summoning anything. Fold as you go then left the page behind the
		// sheet entirely folded, with three cards marked as gaps the shopper
		// could not see, and closing the sheet gave them nothing to look at. The
		// same hole was already open on the folding layout for a bound violation
		// painted without a scroll.
		//
		// Revealing is cheap and has no single place to land, so it belongs with
		// the mark, where every caller gets it: the gate, the fee repaint and the
		// blur on a price box.
		function bbReveal( g ) {
			// A STEPPER HAS EVERY OTHER STEP OFF THE SCREEN, so a gap marked on
			// one the shopper is not looking at is a refusal with no reason in
			// sight. Walk to the step holding it first, then open whatever is
			// folded inside. The gate paints every gap and summons the first
			// one LAST, so the page settles on the step it is pointing at.
			var si = bbStepHolding( g );
			if ( si > -1 ) { bbStepShow( si ); }
			var d = g.closest ? g.closest( 'details' ) : null;
			while ( d ) {
				d.open = true;
				d = d.parentElement ? d.parentElement.closest( 'details' ) : null;
			}
			// Fold as you go shuts a card with a class, not a disclosure. Held,
			// so the next wave cannot fold a problem back out of sight.
			var c = g.closest ? g.closest( '.bb-fg-shut' ) : null;
			while ( c ) {
				c.classList.remove( 'bb-fg-shut' );
				c.dataset.bbHeld = '1';
				var head = bbStepBadgeHost( c );
				if ( head ) { head.setAttribute( 'aria-expanded', 'true' ); }
				c = c.parentElement ? c.parentElement.closest( '.bb-fg-shut' ) : null;
			}
		}
		function bbMissPaint( g, say ) {
			g.classList.add( 'bb-gmiss' );
			bbReveal( g );
			// A box holding something the list cannot make (a size past a price
			// list's limits) already says why, at the box: its card is marked
			// and opened, and takes no "please choose" on top.
			if ( g.querySelector( '[data-bb-refused]' ) ) { return; }
			// Say it, at the offender: the group's own server-composed sentence
			// lands in its live region, so the refusal is words as well as paint.
			// A bound gives its own sentence, because "Fill in Add a tip first" is
			// not what is wrong with an amount that is filled in and too big.
			// A bound's complaint goes in the slot beside the bound, under the box.
			// Everything else uses the group's line at the top of the card, which is
			// right when the whole card is the offender.
			var note = ( say && g.querySelector( '.bb-gmiss-here' ) ) || g.querySelector( '.bb-gmiss-note' );
			// A card owed by its SECTION says nothing itself: the section's
			// sentence goes once, in the bar above the section, because none of
			// its questions alone is the one at fault. A card that is itself
			// required keeps its own "Please choose".
			var bySection = '1' !== g.dataset.req && g.dataset.bbSecMsg;
			if ( bySection ) {
				bbSecShown[ g.dataset.bbSecKey ] = 1;
				bbSecRefresh();
			}
			var line = say || ( bySection ? '' : g.dataset.bbMiss );
			if ( note && line ) {
				note.textContent = line;
				note.hidden = false;
			}
			g.querySelectorAll( 'select.bundle-attr-select, .bb-checks input, .bb-addon-input:not([type="hidden"]), .bb-tbl-sel, .bb-tbl-typedin' ).forEach( function ( el ) {
				el.setAttribute( 'aria-invalid', 'true' );
			} );
		}
		// TAKE ME TO THIS GROUP: scroll it into the middle and put the keyboard
		// on the first control a keyboard can drive, without yanking the smooth
		// scroll off course. One reader, because the refused submit and the
		// review's Change button are the same journey and must not differ.
		// ── FOLD AS YOU GO ────────────────────────────────
		// One question open at a time: answer it and the next opens itself. The
		// folding layout stays the manual version, where the shopper opens what
		// they like and nothing moves under them.
		//
		// IT FOLDS EVERY QUESTION, NOT EVERY GROUP, and it has to. Folding has
		// only ever been group chrome, and grouping here is something a merchant
		// opts into: on a real eight-question sign product exactly ONE card is a
		// group, so a group-only version folded one question and left seven
		// sitting open. That is the same shape as the numbering defect, and it
		// takes the same answer, the reader that walks every top-level card.
		//
		// NOTHING IS REPARENTED. A card is shut by a class that hides its body,
		// never by being wrapped in a disclosure, because a great many handlers on
		// this page address cards by their place in the panel and moving one would
		// quietly unbind them.
		//
		// THE THREE THINGS THAT MAKE IT SAFE, each of which was a way to trap or
		// annoy a shopper before it was closed:
		//
		//  1. A card the SHOPPER opened is theirs. It is marked held and never
		//     shut by us again, so going back to change an answer does not fight a
		//     script that keeps re-shutting it.
		//  2. Nothing folds under their hands. A card holding the focused control
		//     is left alone, or typing the first letter into a text field would
		//     shut the box being typed in.
		//  3. A refusal opens what it points at, in bbGoTo below.
		function bbFoldGoRoot() {
			var root = document.querySelector( '.bb-standalone-options' );
			return ( root && 'foldgo' === ( root.dataset.bbLayout || '' ) ) ? root : null;
		}
		function bbFoldDone( card ) {
			// A card that IS a question answers for itself; a section holding
			// several is done when all of them are. A card that asks nothing is
			// never "next": it is not in anyone's way.
			if ( card.classList.contains( 'bb-attr-group' ) ) { return bbAnswered( card ); }
			var asks = false, all = true;
			card.querySelectorAll( '.bb-attr-group' ).forEach( function ( g ) {
				if ( g.hidden || ! bbActionable( g ) || bbVarInert( g ) || ! bbAsks( g ) ) { return; }
				asks = true;
				if ( ! bbAnswered( g ) ) { all = false; }
			} );
			return asks ? all : true;
		}
		function bbFoldOpen( card ) {
			return 'DETAILS' === card.tagName ? card.open : ! card.classList.contains( 'bb-fg-shut' );
		}
		function bbFoldSet( card, want ) {
			if ( 'DETAILS' === card.tagName ) {
				if ( card.open === want ) { return; }
				card.dataset.bbAuto = '1'; // toggle fires later; its handler clears this.
				card.open = want;
				return;
			}
			card.classList.toggle( 'bb-fg-shut', ! want );
			var head = bbStepBadgeHost( card );
			if ( head ) { head.setAttribute( 'aria-expanded', want ? 'true' : 'false' ); }
		}
		function bbFoldGoWire( cards ) {
			cards.forEach( function ( card ) {
				if ( card.dataset.bbFgWired ) { return; }
				card.dataset.bbFgWired = '1';
				if ( 'DETAILS' === card.tagName ) {
					card.addEventListener( 'toggle', function () {
						if ( card.dataset.bbAuto ) { delete card.dataset.bbAuto; return; }
						if ( card.open ) { card.dataset.bbHeld = '1'; } else { delete card.dataset.bbHeld; }
					} );
					return;
				}
				var head = bbStepBadgeHost( card );
				if ( ! head ) { return; }
				// The card's own name row becomes the handle. It has to answer to a
				// keyboard as well as a tap, so it takes a tab stop rather than a
				// bare click listener.
				head.classList.add( 'bb-fg-head' );
				// A HEAD IS NOT ALWAYS THE CARD'S OWN CHILD. A set wears its head
				// at the top of the card; a FIELD carries its label inside its
				// body, one or more levels down. Shutting hides the card's
				// children, so the branch holding that label went with the rest of
				// the body and the card rendered as an empty bordered box. Marking
				// the branch keeps that one path open while everything beside it
				// goes away.
				var hop = head.parentElement;
				while ( hop && hop !== card ) {
					hop.classList.add( 'bb-fg-path' );
					hop = hop.parentElement;
				}
				// A FIELD'S HEAD CAN REPORT TOO. Its answer is already computed for
				// the gate and for the section summary; the head just had nowhere
				// to print it. Only a head that ASKS something keeps its span: an
				// info block or a heading drops it and stays quiet.
				var fech = head.querySelector( '.bb-fecho' );
				if ( fech && null === bbFieldEcho( card ) ) { fech.remove(); fech = null; }
				if ( fech ) { fech.hidden = false; }
				// The chevron only has to push itself when there is no echo to do
				// the pushing; two things pushing share the gap between them and
				// the echo stops reaching the far end.
				if ( ! head.querySelector( '.bb-gecho' ) && ! fech ) { head.classList.add( 'bb-fg-noecho' ); }
				// A <label for> already has a job: it names the control it points
				// at. Calling it a button takes that name away from the control,
				// so a labelling head keeps its own role and takes the tab stop
				// alone.
				if ( ! ( 'LABEL' === head.tagName && head.getAttribute( 'for' ) ) ) {
					head.setAttribute( 'role', 'button' );
				}
				head.setAttribute( 'tabindex', '0' );
				var flip = function ( ev ) {
					// A control inside the head is doing its own job; only the head
					// itself toggles.
					if ( ev.target !== head && ev.target.closest( 'input, select, textarea, button, a, label' ) ) { return; }
					ev.preventDefault();
					var want = ! bbFoldOpen( card );
					bbFoldSet( card, want );
					if ( want ) { card.dataset.bbHeld = '1'; } else { delete card.dataset.bbHeld; }
				};
				head.addEventListener( 'click', flip );
				head.addEventListener( 'keydown', function ( ev ) {
					if ( 'Enter' === ev.key || ' ' === ev.key || 'Spacebar' === ev.key ) { flip( ev ); }
				} );
			} );
		}
		// A field head's own echo, kept in step with its answer. Empty reads as
		// the page's own two words: a required one still owes a choice, an
		// optional one simply has none.
		function bbFoldFieldEcho( card ) {
			var fe = card.querySelector( '.bb-fecho' );
			if ( ! fe || fe.hidden ) { return; }
			var t   = bbFieldEcho( card );
			var owe = ( null === t || '' === t ) && '1' === card.dataset.req;
			fe.textContent = ( null === t || '' === t )
				? ( owe ? ( fe.dataset.todo || '' ) : ( fe.dataset.none || '' ) )
				: t;
			fe.classList.toggle( 'bb-gecho-todo', owe );
		}
		// ── PHOTO KEPT IN VIEW: the product stays on screen while it is built. ──
		//
		// Of 24 made-to-measure configurators walked, the ones that read best all
		// keep the thing being bought visible while it is being decided, and no
		// options plugin in this category offers it.
		//
		// ONLY WHERE IT CAN ACTUALLY WORK, measured rather than assumed. A theme
		// that stacks the gallery above the panel would push every question off
		// the screen if its photo were pinned, so the page checks that the two are
		// genuinely side by side and that the photo is shorter than the window
		// before it pins anything. Where the check fails nothing changes at all,
		// which is the right outcome: a layout we cannot improve we leave alone.
		function bbPhotoRoot() {
			return document.querySelector( '.bb-standalone-options[data-bb-photoview="1"]' );
		}
		// CLASS NAMES ARE A GUESS ABOUT A THEME; GEOMETRY IS A FACT ABOUT THIS
		// PAGE. The three names below cover core, the block editor and the
		// slider plugin this store happens to run, and a shop running anything
		// else would have been silently skipped. So when none of them matches,
		// the page finds the product's own biggest picture and takes the
		// column it sits in, which works whatever the markup is called.
		function bbPhotoGallery() {
			var known = document.querySelector( '.woocommerce-product-gallery, .wp-block-woocommerce-product-image-gallery, .wcgs-woocommerce-product-gallery' );
			if ( known ) { return known; }
			var root = document.querySelector( '.bb-standalone-options' );
			var best = null;
			Array.prototype.forEach.call( document.images, function ( img ) {
				if ( root && root.contains( img ) ) { return; }      // our own chips are not the product
				// A looping carousel parks copies of its slides off to the
				// side; they measure like the photo but are never on screen.
				if ( img.closest( '.swiper-slide-duplicate, .slick-cloned' ) ) { return; }
				var r = img.getBoundingClientRect();
				if ( r.width < 180 || r.height < 180 ) { return; }
				if ( r.right <= 0 || r.left >= window.innerWidth ) { return; }
				if ( ! best || r.width * r.height > best.w ) { best = { el: img, w: r.width * r.height }; }
			} );
			if ( ! best ) { return null; }
			// A CAROUSEL IS ONE PICTURE. Climbing from a slide found the slide
			// itself (its track is far wider than it), and a carousel clips its
			// own overflow, so the stick refused and the photo scrolled away on
			// a page-builder template with its own slider (found live on a Divi
			// shop, 11 October 2026). The climb starts at the carousel's frame.
			var start = best.el.closest( '.swiper, .swiper-container, .slick-slider, .flickity-enabled, .owl-carousel, .splide' ) || best.el;
			// Up to the block that is a COLUMN: narrower than two thirds of the
			// page, and not an ancestor of the questions.
			var n = start === best.el ? best.el.parentElement : start;
			var lim = document.documentElement.clientWidth * 0.66;
			while ( n && n !== document.body ) {
				var w = n.getBoundingClientRect().width;
				var holdsUs = root && n.contains( root );
				if ( holdsUs ) { return null; }                       // one stacked column: nothing to pin
				if ( w > lim ) { return null; }
				if ( n.parentElement && n.parentElement.getBoundingClientRect().width > w + 40 ) {
					// A builder stretches its columns to the row's height, so the
					// column is as tall as the questions beside it and gives its
					// own photo nowhere to travel. When it is much taller than
					// the block holding the picture, that block is what follows
					// the shopper, inside the column.
					var holder = start;
					while ( holder.parentElement && holder.parentElement !== n ) { holder = holder.parentElement; }
					if ( holder !== n && n.getBoundingClientRect().height - holder.getBoundingClientRect().height > window.innerHeight * 0.25 ) {
						return holder;
					}
					return n;
				}
				n = n.parentElement;
			}
			return null;
		}
		function bbPhotoMainSrc() {
			var g = bbPhotoGallery();
			if ( ! g ) { return ''; }
			// The slide the shopper is looking at, whichever slider the theme uses;
			// the first image is the honest fallback, never a guess at a URL.
			var img = g.querySelector( '.flex-active-slide img' )
				|| g.querySelector( '.swiper-slide-active img' )
				|| g.querySelector( '.woocommerce-product-gallery__image img' )
				|| g.querySelector( 'img' );
			if ( ! img ) { return ''; }
			var src = img.currentSrc || img.src || '';
			// A lazy loader holds a blank placeholder in src until the picture
			// scrolls into view; the real address waits in its own attribute.
			if ( /^data:/i.test( src ) ) {
				src = img.getAttribute( 'data-src' ) || img.getAttribute( 'data-lazy-src' ) || '';
			}
			return src;
		}
		function bbPhotoStick() {
			var root = bbPhotoRoot();
			var g    = root ? bbPhotoGallery() : null;
			if ( ! g ) { return; }
			var gr = g.getBoundingClientRect();
			var pr = root.getBoundingClientRect();
			// Two COLUMNS, not one stack: they have to sit apart horizontally.
			var twoCol = ( gr.right <= pr.left + 1 ) || ( pr.right <= gr.left + 1 );
			var wide   = window.innerWidth >= 1024;
			// A photo taller than the window cannot follow anything; pinning it
			// would just freeze its top edge and hide its own bottom.
			var fits = ( gr.height + 40 ) < window.innerHeight;
			// A CLIPPING ANCESTOR SCOPES THE STICK TO ITSELF, SILENTLY. Driven
			// across eighteen themes: on three of them the switch was on, the
			// declaration was set, and the photo still scrolled away like any
			// other block, because an ancestor carried overflow-y:hidden and a
			// sticky element sticks inside its nearest scrolling ancestor
			// rather than the window. overflow-x:hidden alone is harmless and
			// common (it computes overflow-y to auto, which sticks fine), so
			// the test is the Y axis, which is exactly what separated the
			// themes that worked from the ones that did not.
			//
			// EXCEPT BELOW THE BODY. That claim holds for body and html, whose
			// overflow passes to the window; on any other element overflow-x:
			// hidden turns overflow-y to auto and makes the element the box the
			// stick follows. When that box never scrolls (it is as tall as its
			// content), the photo is pinned to something that never moves and
			// scrolls away like any block: Divi's page wrapper does exactly this
			// (found live, 11 October 2026). overflow-x:clip cuts the same
			// sideways overflow without becoming that box, so while the photo
			// is held such a wrapper is switched to clip, and switched back the
			// moment the stick lets go. A wrapper that really scrolls is left
			// alone, and the stick stands down as before.
			//
			// AND A WRAPPER THAT CLIPS ONLY TO HOLD ITS FLOATS. Storefront sets
			// overflow:hidden on both axes of the product wrapper so that the
			// floated gallery and summary stay inside it, and the photo scrolled
			// away like any block. overflow:clip paints exactly what hidden
			// paints but is no box the stick follows, and display:flow-root
			// holds the floats the way hidden did, so the page looks the same
			// while the photo is held. Only a wrapper that cuts nothing off at
			// the bottom (as tall as its content) and lays out as a block, flex
			// or grid is switched, and all of it goes back the moment the stick
			// lets go.
			var free   = true;
			var traps  = [];
			var canClip = !! ( window.CSS && window.CSS.supports && window.CSS.supports( 'overflow-x', 'clip' ) );
			var canFlow = canClip && window.CSS.supports( 'display', 'flow-root' );
			for ( var an = g.parentElement; an && an !== document.documentElement; an = an.parentElement ) {
				if ( an.hasAttribute( 'data-bb-stick-clip' ) ) { traps.push( an ); continue; }
				var acs = window.getComputedStyle( an );
				if ( an !== document.body && 'hidden' === acs.overflowX && 'auto' === acs.overflowY ) {
					if ( canClip && an.scrollHeight <= an.clientHeight + 1 ) { traps.push( an ); continue; }
					free = false;
					break;
				}
				if ( an !== document.body && 'hidden' === acs.overflowX && 'hidden' === acs.overflowY ) {
					if ( canFlow && /^(block|flow-root|flex|grid)$/.test( acs.display ) && an.scrollHeight <= an.clientHeight + 1 ) { traps.push( an ); continue; }
					free = false;
					break;
				}
				if ( 'hidden' === acs.overflowY || 'clip' === acs.overflowY || 'clip' === acs.overflowX ) {
					free = false;
					break;
				}
			}
			// AND THE BOX HAS TO GIVE IT SOMEWHERE TO GO. One theme wraps the
			// gallery in a box only 30px taller than the photo: the stick is
			// real, it just runs out after 30px and the whole wrapper leaves
			// the screen, which looks exactly like nothing happening. The
			// themes it works on give it 1,200px or more, so the floor is a
			// quarter of the window: enough to be worth doing, low enough to
			// admit any honest two-column layout.
			//
			// AND NOTHING OF ITS OWN COLUMN UNDER IT. A sticky element stays in
			// the flow: whatever sits below it in the same box keeps its place
			// and scrolls up OVER the held photo. A page-builder column with FAQ
			// accordions and a suggested-products block under the photo had the
			// photo held and its own column sliding across it (found live, 11
			// October 2026). So the travel ends at the first block beneath the
			// photo in its own column, not at the bottom of the box; a block
			// beside it (the questions, a floated summary) is no obstacle. It is
			// measured where the photo sits unheld, so a re-check while it is
			// held reads the same layout.
			var host  = g.parentElement;
			var was   = g.style.position;
			if ( 'sticky' === was ) { g.style.position = ''; }
			var gn    = g.getBoundingClientRect();
			var room  = host ? ( host.getBoundingClientRect().bottom - gn.bottom ) : 0;
			var stop  = null;
			for ( var sib = g.nextElementSibling; sib; sib = sib.nextElementSibling ) {
				var sr = sib.getBoundingClientRect();
				var sp = window.getComputedStyle( sib ).position;
				if ( sr.height < 1 || 'absolute' === sp || 'fixed' === sp ) { continue; }
				if ( sr.right <= gn.left + 1 || sr.left >= gn.right - 1 || sr.top < gn.bottom - 1 ) { continue; }
				if ( sr.top - gn.bottom < room ) { stop = sib; }
				room = Math.min( room, sr.top - gn.bottom );
			}
			g.style.position = was;
			var roomy = room > ( window.innerHeight * 0.25 );
			var on = !! ( wide && twoCol && fits && free && roomy );
			g.classList.toggle( 'bb-photo-stick', on );
			// SET HERE, NOT IN THE STYLESHEET. The element belongs to whatever
			// gallery the shop runs, and that plugin has already styled it: the
			// slider on this store sets position:relative at the same specificity
			// our class could reach, so a rule would win or lose on load order.
			// The decision is made in this function, so the declaration is made
			// here too, and it is removed again the moment the answer changes.
			if ( on ) {
				g.style.position  = 'sticky';
				g.style.top       = '24px';
				g.style.alignSelf = 'flex-start';
				traps.forEach( function ( t ) {
					if ( t.hasAttribute( 'data-bb-stick-clip' ) ) { return; }
					var tcs = window.getComputedStyle( t );
					// Both axes hidden: both become clip, and a block holds its
					// floats as flow-root. Each inline value is kept to go back.
					if ( 'hidden' === tcs.overflowY ) {
						t.setAttribute( 'data-bb-stick-clip-y', t.style.overflowY || '' );
						t.style.overflowY = 'clip';
						if ( 'block' === tcs.display ) {
							t.setAttribute( 'data-bb-stick-flow', t.style.display || '' );
							t.style.display = 'flow-root';
						}
					}
					t.setAttribute( 'data-bb-stick-clip', t.style.overflowX || '' );
					t.style.overflowX = 'clip';
				} );
			} else {
				g.style.position  = '';
				g.style.top       = '';
				g.style.alignSelf = '';
				Array.prototype.forEach.call( document.querySelectorAll( '[data-bb-stick-clip]' ), function ( t ) {
					t.style.overflowX = t.getAttribute( 'data-bb-stick-clip' );
					t.removeAttribute( 'data-bb-stick-clip' );
					if ( t.hasAttribute( 'data-bb-stick-clip-y' ) ) {
						t.style.overflowY = t.getAttribute( 'data-bb-stick-clip-y' );
						t.removeAttribute( 'data-bb-stick-clip-y' );
					}
					if ( t.hasAttribute( 'data-bb-stick-flow' ) ) {
						t.style.display = t.getAttribute( 'data-bb-stick-flow' );
						t.removeAttribute( 'data-bb-stick-flow' );
					}
				} );
			}
			// THE PHOTO STOPS WHERE THE QUESTIONS STOP. A sticky element may
			// travel the whole height of its containing block, and on most themes
			// that block is the product article, which carries on past the
			// questions into the description tabs and the related products. So
			// the photo kept riding beside the Description tab, 445px below the
			// last question, until the article itself ran out (found in QA on the
			// demo sign, 3 October 2026). The floor is the COLUMN the questions
			// live in, found by geometry like everything else here: the root's
			// ancestor that is a direct child of the lowest block holding both
			// the photo and the questions. bbPhotoFloor pulls the sticky offset
			// up with that column's bottom edge, so the photo leaves the screen
			// together with the last question and never beside anything else.
			bbPhotoColumn = null;
			// And never past the first block beneath the photo in its own
			// column: a room above the quarter-window floor lets the stick on,
			// and the photo then stops above that block rather than riding
			// over it on the way to the end of the questions.
			bbPhotoStop = on ? stop : null;
			if ( on ) {
				var common = host;
				while ( common && common !== document.body && ! common.contains( root ) ) { common = common.parentElement; }
				for ( var col = root; common && col && col !== document.body; col = col.parentElement ) {
					if ( col.parentElement === common ) { bbPhotoColumn = col; break; }
				}
				if ( ! bbPhotoColumn ) { bbPhotoColumn = root; }
				if ( window.ResizeObserver && ! bbPhotoWatch ) {
					// A step that opens, a fold that closes or a card that grows
					// moves the column's end without a scroll, so the floor is
					// re-read whenever the column changes size as well.
					bbPhotoWatch = new ResizeObserver( bbPhotoFloor );
				}
				if ( bbPhotoWatch ) {
					bbPhotoWatch.disconnect();
					bbPhotoWatch.observe( bbPhotoColumn );
				}
			} else if ( bbPhotoWatch ) {
				bbPhotoWatch.disconnect();
			}
			bbPhotoFloor();
		}
		var bbPhotoColumn = null;
		var bbPhotoStop   = null;
		var bbPhotoWatch  = null;
		var bbPhotoTop    = '';
		function bbPhotoFloor() {
			var g = bbPhotoGallery();
			if ( ! g || ! bbPhotoColumn || ! g.classList.contains( 'bb-photo-stick' ) ) { return; }
			// The column's bottom edge, in viewport terms, less the photo's own
			// height: while that is above 24px the photo's resting offset would
			// put its bottom edge past the last question, so the offset follows
			// the edge up instead. Scrolling back down restores 24px by itself.
			// A block beneath the photo in its own column ends it sooner.
			var end = bbPhotoColumn.getBoundingClientRect().bottom;
			if ( bbPhotoStop ) { end = Math.min( end, bbPhotoStop.getBoundingClientRect().top ); }
			var limit = end - g.getBoundingClientRect().height;
			var top   = Math.min( 24, Math.floor( limit ) ) + 'px';
			if ( top !== bbPhotoTop ) {
				bbPhotoTop  = top;
				g.style.top = top;
			}
		}
		// A PHONE HAS NO COLUMN TO SPARE, so the photo rides the bar we already
		// own rather than taking a strip of the page away from the questions.
		function bbPhotoThumb() {
			if ( ! bbPhotoRoot() || ! bbPeekBar ) { return; }
			var src = bbPhotoMainSrc();
			if ( ! src ) { return; }
			var row = bbPeekBar.querySelector( '.bb-peek-row' ) || bbPeekBar.firstElementChild;
			if ( ! row ) { return; }
			var img = row.querySelector( '.bb-peek-thumb' );
			if ( ! img ) {
				img = document.createElement( 'img' );
				img.className = 'bb-peek-thumb';
				img.alt = '';            // decorative: the product name is already on the page.
				img.setAttribute( 'aria-hidden', 'true' );
				row.insertBefore( img, row.firstChild );
			}
			if ( img.getAttribute( 'src' ) !== src ) { img.setAttribute( 'src', src ); }
		}
		function bbPhotoView() {
			bbPhotoStick();
			bbPhotoThumb();
		}
		if ( window.addEventListener ) {
			// The measurement depends on the window, so it is taken again whenever
			// the window changes rather than once at boot.
			window.addEventListener( 'resize', bbPhotoStick );
			// The floor depends on where the page is scrolled to, so it is read on
			// every scroll. Two rectangles and, most frames, no write: cheap, and
			// only wired at all when the switch is on.
			if ( bbPhotoRoot() ) {
				window.addEventListener( 'scroll', bbPhotoFloor, { passive: true } );
				// AND ONCE THE PAGE HAS SETTLED. The first measurement runs when
				// this script does, which on a page-builder template is before the
				// theme's own slider has built itself and before its lazy photo
				// has a size: there is no picture to find yet, the switch quietly
				// does nothing, and nothing asks again until the window is
				// resized (found live on a Divi shop, 11 October 2026). The page
				// load is the moment the slider and its first photo exist; the
				// second look covers a slider that builds itself just after.
				window.addEventListener( 'load', function () {
					bbPhotoView();
					window.setTimeout( bbPhotoView, 800 );
				} );
			}
		}

		// ── POPULAR SETUPS: a named starting point the shopper presses. ──
		//
		// Nothing is applied on arrival. A press is what fills anything in,
		// because a pre-ticked paid extra is not consent and a page that answers
		// its own questions leaves a total nobody can account for.
		function bbSetupPicks( card ) {
			try { return JSON.parse( card.dataset.bbPicks || '{}' ) || {}; } catch ( e ) { return {}; }
		}
		// A CHIP IS PRESSED, NOT SET. Going through the shopper's own path means
		// every consequence follows on its own: the photo swap, the exclusions,
		// the pair narrowing and the conditional reveal all run exactly as they
		// would on a tap, and not one of them has to know setups exist.
		//
		// The names and keys were sanitize_key'd by the server, so they hold only
		// a-z, 0-9 and underscores and can go straight into a selector.
		// THE CARD THE SHOPPER LAST PRESSED. Not persisted, not read by the gate
		// and not read by the basket: it decides one thing only, which of two
		// cards that both hold gets to say so. See bbSetupsSync.
		var bbSetupPressed = null;
		function bbSetupApply( card ) {
			var picks = bbSetupPicks( card );
			Object.keys( picks ).forEach( function ( name ) {
				var want  = picks[ name ];
				var chips = document.querySelector( '.bb-standalone-options .bb-chips[data-for-select="' + name + '"]' );
				var chip  = chips ? chips.querySelector( '.bb-chip[data-value="' + want + '"]' ) : null;
				if ( chip && ! chip.classList.contains( 'bb-chip--soldout' ) ) {
					// A PICK-MANY QUESTION IS CLEARED BEFORE IT IS ANSWERED, and
					// this was a MONEY defect. A pick-one row swaps its own
					// answer when the new chip is pressed, so pressing is enough
					// there. A pick-many row only ever ADDS, so whatever the
					// previous setup put in that question stayed on the page and
					// on the bill: press "Most popular" (drilled holes) and then
					// "Hard wearing" (standoff kit) and the shopper was charged
					// for BOTH, 63.50 against the 59.00 the card offered.
					//
					// Cleared by PRESSING, like everything else in here, so the
					// exclusions, the narrowing, the photo swap and the live
					// total all run exactly as they would on a tap. Done only
					// once the wanted chip is known to be there and sellable, so
					// a setup naming a sold-out choice can never empty a
					// question it cannot then answer.
					if ( chips.classList.contains( 'bb-multi' ) ) {
						Array.prototype.slice.call( chips.querySelectorAll( '.bb-chip.is-selected' ) )
							.forEach( function ( other ) {
								if ( ( other.dataset.value || '' ) !== want ) { other.click(); }
							} );
					}
					if ( ! chip.classList.contains( 'is-selected' ) ) { chip.click(); }
					return;
				}
				var sel = document.querySelector( '.bb-standalone-options select[name="' + name + '"]' );
				if ( ! sel ) { return; }
				var has = Array.prototype.some.call( sel.options, function ( o ) { return o.value === want; } );
				if ( has && sel.value !== want ) {
					sel.value = want;
					sel.dispatchEvent( new Event( 'change', { bubbles: true } ) );
				}
			} );
			// A STARTING POINT IS THE WHOLE PAGE, NOT AN OVERLAY, and this was
			// the other half of the money defect above. The card's figure counts
			// every OPTIONAL question it does not name as nothing, so the press
			// has to make that true: an extra left over from an earlier card, or
			// ticked by hand, stayed on the bill under a card quoting a total
			// without it. Found in QA, 3 October 2026: "Hard wearing" (standoff
			// kit, 9.00) and then "Best value" (from 30.00) read 39.00 with the
			// card lit Applied.
			//
			// Only the optional choice questions the card leaves out. A REQUIRED
			// question it leaves out is exactly what its "from" stands for, so
			// the shopper's answer there is kept, and typed answers (a measured
			// size, a message) are never a card's to clear. Cleared by pressing,
			// like everything else in here, so every consequence still runs.
			Array.prototype.forEach.call( document.querySelectorAll( '.bb-standalone-options .bb-chips[data-for-select]' ), function ( chips ) {
				var name  = chips.getAttribute( 'data-for-select' ) || '';
				var group = chips.closest ? chips.closest( '.bb-attr-group' ) : null;
				if ( ! group || Object.prototype.hasOwnProperty.call( picks, name ) ) { return; }
				if ( '1' === ( group.dataset.req || '' ) ) { return; }
				Array.prototype.slice.call( chips.querySelectorAll( '.bb-chip.is-selected' ) )
					.forEach( function ( left ) { left.click(); } );
			} );
			bbSetupsSync();
		}
		// THE PRESSED STATE IS READ OFF THE PAGE, never remembered. A card that
		// stored "I am the one" would go on saying so after the shopper changed
		// a choice under it; derived, it cannot lie, and a shopper who arrives at
		// the same combination by hand lights the card up, which is true.
		function bbSetupHolds( card ) {
			var picks = bbSetupPicks( card );
			var names = Object.keys( picks );
			if ( ! names.length ) { return false; }
			return names.every( function ( name ) {
				var sel = document.querySelector( '.bb-standalone-options select[name="' + name + '"]' );
				if ( sel ) { return sel.value === picks[ name ]; }
				var chips = document.querySelector( '.bb-standalone-options .bb-chips[data-for-select="' + name + '"]' );
				if ( ! chips ) { return false; }
				// EXACTLY THE SETUP'S ANSWER, never merely including it.
				//
				// This asked querySelector for the FIRST selected chip and
				// compared that one, so a pick-many question holding two
				// answers could not satisfy ANY setup: the card said "Use this"
				// the instant after it was pressed, which is why pressing it
				// again and again looked like a control that sometimes worked.
				//
				// One selected value, and it is the wanted one. Two is not the
				// setup's answer even when one of them is: the shopper would be
				// buying something the card does not describe, and the card must
				// not claim otherwise.
				var on = Array.prototype.map.call(
					chips.querySelectorAll( '.bb-chip.is-selected' ),
					function ( c ) { return c.dataset.value || ''; }
				);
				return 1 === on.length && on[0] === picks[ name ];
			} );
		}
		// A SETUP THAT IS PART OF ANOTHER ONE IS NOT THE CURRENT SETUP.
		//
		// Holding is not enough. A setup naming Foamex and Matt is satisfied by
		// every page a setup naming Foamex, Matt and Drilled holes is satisfied
		// by, so pressing the longer one lit both cards and the shopper could
		// not tell which one they had pressed. It is not a duplicate: it is a
		// subset, and real shops write overlapping starting points all the
		// time, a cheap one and a fuller one sharing most of their choices.
		//
		// These cards are aria-pressed buttons, so two lit is not only
		// confusing to look at: a screen reader announces both as pressed
		// after one press, which is a state the page is not in.
		//
		// So a card is current when it holds AND no other holding card names
		// strictly more. Two holders that name different things (one picks a
		// material, another picks a finish) both stay lit, because the page
		// genuinely is both and neither is the fuller answer. Still derived,
		// never remembered, so it cannot go on claiming to be current after a
		// choice changes underneath it.
		function bbSetupCovers( a, b ) {
			var pa = bbSetupPicks( a );
			var pb = bbSetupPicks( b );
			var ka = Object.keys( pa );
			var kb = Object.keys( pb );
			if ( kb.length >= ka.length ) { return false; } // not STRICTLY more.
			return kb.every( function ( k ) { return pa[ k ] === pb[ k ]; } );
		}
		function bbSetupsSync() {
			var cards   = Array.prototype.slice.call( document.querySelectorAll( '.bb-standalone-options .bb-setup' ) );
			var holding = cards.filter( bbSetupHolds );
			// THE CARD THE SHOPPER PRESSED IS THE CARD THAT LIGHTS, for as long
			// as it still holds.
			//
			// The subset rule below is right about a page nobody pressed, and it
			// answered a press with silence. "Best value" names a material and a
			// finish; "Most popular" names those two and a fixing. Press the
			// second and then the first: every chip Best value wants is already
			// selected, so nothing is clicked, nothing on the page moves, and
			// the subset rule keeps Most popular lit. The shopper pressed a
			// button and the page did not acknowledge it in any way.
			//
			// STILL DERIVED. Holding is computed first and the press only breaks
			// the tie, so the moment an answer changes underneath and the card
			// stops holding, the remembered press counts for nothing and the
			// rule below takes over again. A card can never go on claiming to be
			// the one after the page has moved off it.
			var chose = ( bbSetupPressed && holding.indexOf( bbSetupPressed ) !== -1 ) ? bbSetupPressed : null;
			cards.forEach( function ( card ) {
				var on = chose ? ( card === chose ) : ( holding.indexOf( card ) !== -1 && ! holding.some( function ( other ) {
					return other !== card && bbSetupCovers( other, card );
				} ) );
				card.setAttribute( 'aria-pressed', on ? 'true' : 'false' );
				var word = card.querySelector( '.bb-setup-do' );
				if ( word ) {
					word.textContent = on ? ( word.dataset.on || '' ) : ( word.dataset.use || '' );
				}
			} );
		}
		function bbSetupsWire() {
			var row = document.querySelector( '.bb-standalone-options .bb-setups' );
			if ( ! row || row.dataset.bbWired ) { return; }
			row.dataset.bbWired = '1';
			row.addEventListener( 'click', function ( ev ) {
				var card = ev.target.closest ? ev.target.closest( '.bb-setup' ) : null;
				if ( card ) {
					// Remembered BEFORE the apply, because the apply ends in
					// bbSetupsSync and the sync is what reads it.
					bbSetupPressed = card;
					bbSetupApply( card );
				}
			} );
			bbSetupsSync();
		}
		function bbFoldGo() {
			var root = bbFoldGoRoot();
			if ( ! root ) { return; }
			var cards = bbStepCards( root );
			bbFoldGoWire( cards );
			var next = null;
			cards.forEach( function ( card ) {
				var done = bbFoldDone( card );
				card.classList.toggle( 'bb-fold-done', done );
				bbFoldFieldEcho( card );
				if ( ! done && ! next ) { next = card; }
			} );
			cards.forEach( function ( card ) {
				if ( '1' === card.dataset.bbHeld ) { return; }
				if ( card.contains( document.activeElement ) ) { return; }
				bbFoldSet( card, card === next );
			} );
		}
		function bbGoTo( g ) {
			// OPENING WHAT IS SHUT IS NOT DONE HERE. It is done in bbMissPaint,
			// where the mark is made. The scroll and the focus can land in only
			// one place, which is why the gate summons a single group; being
			// visible is owed to every marked group, on every path.
			g.scrollIntoView( { behavior: 'smooth', block: 'center' } );
			// A pick the till cannot price is the one to change: the keyboard
			// lands on it, not on the list's first choice.
			var f = g.querySelector( '[data-bb-refused]' ) || ( g.dataset.bbStop ? g.querySelector( '.bb-chip.is-selected' ) : null ) || g.querySelector( '.bb-chip, .bb-tbl-opt, .bb-mchip, .bb-checks input, .bb-addon-input:not([type="hidden"]), .bb-tbl-sel, .bb-tbl-typedin, .bb-up-pick, .bb-addon-file-input, .bb-grid-wopill, .bb-grid-tile, .bb-mdims:not([hidden]) input' )
				// A tick field's box carries no class of its own: Show me left the
				// keyboard on itself (walk 2, P13). Any control a field holds.
				|| g.querySelector( '.bb-addon-field input:not([type="hidden"]), .bb-addon-field select, .bb-addon-field textarea' );
			if ( f && f.focus ) {
				try { f.focus( { preventScroll: true } ); } catch ( _ ) { f.focus(); }
			}
		}
		function bbMissMark( g, say ) {
			bbMissPaint( g, say );
			bbGoTo( g );
		}
		// ── THE MISSING CHOICES, LIFTED TO THE BUTTON. Off unless asked for. ──
		//
		// A phone shopper who presses Add to cart with three things unanswered is
		// sent back up the page to find them, one scroll at a time, losing the
		// button and the total on the way. This brings the unanswered ones down
		// to where the thumb already is.
		//
		// It carries THE REAL GROUPS, not copies: a copy would be a second set of
		// controls with its own state, and the two would disagree the moment
		// either was touched. Each one remembers the exact spot it left, so
		// closing puts the page back as it was.
		//
		// It is a SETTING, off by default, and this is the only change of the
		// round that gets one: the others add information to a page that had
		// none, while this replaces the scroll that shops already have.
		var bbSheet = null;
		function bbSheetWanted() {
			var root = document.querySelector( '.bb-standalone-options' );
			return !! root && '1' === ( root.dataset.bbSheet || '' )
				// The phone shape only. On a wide screen the page is the sheet.
				&& !! ( window.matchMedia && window.matchMedia( '(max-width: 782px)' ).matches );
		}
		function bbSheetSay( host, gaps ) {
			var left = gaps.filter( function ( g ) { return bbAllMissing().indexOf( g ) !== -1; } ).length;
			var h = host.querySelector( '.bb-sheet-h b' );
			var sub = host.querySelector( '.bb-sheet-sub' );
			var cta = host.querySelector( '.bb-sheet-cta' );
			var d = host.dataset;
			if ( h ) { h.textContent = left ? ( 1 === left ? d.one : ( d.many || '' ).replace( '%s', String( left ) ) ) : d.done; }
			if ( sub ) { sub.textContent = left ? ( 1 === left ? d.subOne : d.subMany ) : d.subDone; }
			// The stand-in is never more willing than the button it stands for.
			if ( cta ) { cta.disabled = !! left; }
			var fig = host.querySelector( '.bb-sheet-total' );
			var box = bbStBox();
			if ( fig && box ) { fig.innerHTML = bbStFigure( box ).innerHTML; }
		}
		function bbSheetShut() {
			if ( ! bbSheet ) { return; }
			// Every group goes back to the exact spot it left, marks and all.
			( bbSheet.bbBack || [] ).forEach( function ( pair ) {
				pair.el.classList.remove( 'bb-sheet-quiet' );
				if ( pair.mark && pair.mark.parentNode ) { pair.mark.parentNode.insertBefore( pair.el, pair.mark ); pair.mark.remove(); }
			} );
			if ( bbSheet.bbScrim ) { bbSheet.bbScrim.remove(); }
			bbSheet.remove();
			bbSheet = null;
			document.documentElement.style.removeProperty( 'overflow' );
			// The bar went with the sheet; the page draws it again above the
			// section, if the section is still owed.
			bbSecRefresh();
		}
		function bbSheetOpen( gaps ) {
			if ( bbSheet || ! gaps.length || ! bbSheetWanted() ) { return false; }
			var tpl = document.querySelector( '.bb-sheet-words' );
			if ( ! tpl ) { return false; }
			var scrim = document.createElement( 'div' );
			scrim.className = 'bb-sheet-scrim';
			var sh = document.createElement( 'div' );
			// IT WEARS THE PANEL'S OWN CLASS, and that is the whole trick.
			//
			// Seventy-odd handlers and rules on this page address their targets
			// as ".bb-standalone-options something": the chip click, the swatch,
			// the several-of bound, the skin. Lift a group out of the panel and
			// every one of them stops seeing it, so the sheet renders a group
			// whose controls are dead furniture: driven, a chip inside it
			// swallowed the tap and nothing happened. The sheet has to live on
			// <body> or a transformed ancestor captures its fixed positioning,
			// so it takes the panel's name with it instead of taking the panel.
			sh.className = 'bb-sheet bb-standalone-options';
			sh.setAttribute( 'role', 'dialog' );
			sh.setAttribute( 'aria-modal', 'true' );
			Object.keys( tpl.dataset ).forEach( function ( k ) { sh.dataset[ k ] = tpl.dataset[ k ]; } );
			sh.setAttribute( 'aria-label', tpl.dataset.one || '' );
			var grab = document.createElement( 'div' );
			grab.className = 'bb-sheet-grab';
			grab.setAttribute( 'aria-hidden', 'true' );
			var head = document.createElement( 'div' );
			head.className = 'bb-sheet-h';
			var ttl = document.createElement( 'b' );
			var shut = document.createElement( 'button' );
			shut.type = 'button';
			shut.className = 'bb-sheet-x';
			shut.textContent = tpl.dataset.close || '';
			head.appendChild( ttl );
			head.appendChild( shut );
			var sub = document.createElement( 'p' );
			sub.className = 'bb-sheet-sub';
			var body = document.createElement( 'div' );
			body.className = 'bb-sheet-body';
			sh.appendChild( grab );
			sh.appendChild( head );
			sh.appendChild( sub );
			sh.appendChild( body );
			// A marker stays behind in the page so the group can go home to the
			// same place even if the panel re-orders around it.
			// A section owed an answer comes up whole: any of its questions
			// settles it, so the shopper gets all of them, not just the one
			// carrying the sentence. Only the gaps are counted.
			var lift = [];
			gaps.forEach( function ( g ) {
				( g.bbSecAll || [ g ] ).forEach( function ( x ) { if ( lift.indexOf( x ) === -1 ) { lift.push( x ); } } );
				if ( lift.indexOf( g ) === -1 ) { lift.push( g ); }
			} );
			sh.bbBack = lift.map( function ( g ) {
				var mark = document.createElement( 'span' );
				mark.className = 'bb-sheet-home';
				mark.hidden = true;
				g.parentNode.insertBefore( mark, g );
				body.appendChild( g );
				// THE SHEET IS THE SUMMONS, so the group stops repeating it.
				// Three cards each saying "Choose Size first." under a heading
				// that already says "3 more choices" is one message four times,
				// and it turns a helpful sheet into an error screen. The rail
				// stays, because that is the STATE. A bounds sentence stays too:
				// "between 10 and 200" is information the heading does not have.
				if ( ! bbPriceOut( g ) ) { g.classList.add( 'bb-sheet-quiet' ); }
				return { el: g, mark: mark };
			} );
			var foot = document.createElement( 'div' );
			foot.className = 'bb-sheet-foot';
			var fig = document.createElement( 'span' );
			fig.className = 'bb-sheet-total';
			var cta = document.createElement( 'button' );
			cta.type = 'button';
			cta.className = 'bb-sheet-cta';
			cta.textContent = tpl.dataset.add || '';
			foot.appendChild( fig );
			foot.appendChild( cta );
			sh.appendChild( foot );
			sh.bbScrim = scrim;
			document.body.appendChild( scrim );
			document.body.appendChild( sh );
			bbSheet = sh;
			// A section's bar follows its questions into the sheet: its sentence
			// ("or select blank garments") names a way out the heading cannot.
			// Only now, with the sheet in the page: before, its questions are
			// in neither place and the section reads as settled.
			bbSecRefresh();
			// The page behind must not scroll under the sheet: a shopper dragging
			// the sheet's own list would otherwise move the page instead.
			document.documentElement.style.overflow = 'hidden';
			shut.addEventListener( 'click', bbSheetShut );
			scrim.addEventListener( 'click', bbSheetShut );
			document.addEventListener( 'keydown', function ( ev ) {
				if ( 'Escape' === ev.key && bbSheet ) { bbSheetShut(); }
			} );
			cta.addEventListener( 'click', function () {
				var real = bbStRealAdd();
				bbSheetShut();
				if ( real ) { real.click(); }
			} );
			bbSheetSay( sh, gaps );
			sh.bbGaps = gaps;
			// The first thing they came for takes the focus, so a screen reader
			// lands on the question rather than on the furniture.
			// A section bar's jump chips are a way round, not the question.
			var first = [].slice.call( body.querySelectorAll( 'button, select, input, textarea' ) ).filter( function ( el ) { return ! el.closest( '.bb-sec-band' ); } )[0];
			if ( first && first.focus ) { first.focus(); }
			return true;
		}
		// The sheet rides the same wave as everything else: its heading, its
		// sentence, its money and its button all re-read from the page's own
		// state, so it can never say one thing while the page says another.
		function bbSheetSync() {
			if ( bbSheet ) { bbSheetSay( bbSheet, bbSheet.bbGaps || [] ); }
		}
		// Capture phase, the lightbox override's idiom, so an AJAX-add theme's
		// own submit handler never fires on an add the server would refuse.
		document.addEventListener( 'submit', function ( e ) {
			var form = e.target;
			if ( ! form || ! form.querySelector || ! form.querySelector( '.bb-standalone-options' ) ) { return; }
			// Modules that wait for the shopper to leave a box before telling
			// them (a size too small) tell it now.
			document.dispatchEvent( new CustomEvent( 'bb-before-submit' ) );
			var gaps = bbAllMissing();
			if ( ! gaps.length ) { return; }
			e.preventDefault();
			e.stopPropagation();
			// Paint them all first, so the page tells the whole truth in one
			// go, then summon only the first: the scroll and the focus can
			// only land in one place, and the others are already marked for
			// when the shopper gets there.
			gaps.forEach( function ( g ) { bbMissPaint( g, bbPriceOut( g ) || bbFieldBad( g ) ); } );
			// On a phone, a shop that asked for it lifts the missing ones to the
			// button instead. The marks are painted either way, so closing the
			// sheet leaves the page exactly as the scroll would have found it.
			if ( bbSheetOpen( gaps ) ) { return; }
			bbMissMark( gaps[0], bbPriceOut( gaps[0] ) || bbFieldBad( gaps[0] ) );
		}, true );
		// TELL THEM AT THE BOX, NOT AT THE BUTTON.
		//
		// The bounds are printed directly under this field, so the moment a figure
		// outside them is left there, the field says so itself. On the way OUT of
		// the box, not on every keystroke: marking mid-typing would accuse "5" on
		// its way to "50". Paint only, never the scroll and the focus grab, because
		// the shopper is on their way somewhere and this is news, not a summons.
		// A TOGGLE FLIP RE-READS THE BOUNDS. The typed figure keeps its digits
		// but changes meaning with the switch, so a mark that was right can stop
		// being right and the sentence must requote in the basis now showing.
		// bbTotal() re-runs too, so the receipt's refusal line follows.
		document.addEventListener( 'bb-choice-fees-repainted', function () {
			var basisNow = bbInclActive() ? 'incl' : 'excl';
			document.querySelectorAll( '.bb-own-basis' ).forEach( function ( h ) { h.value = basisNow; } );
			document.querySelectorAll( '.bb-standalone-options .bb-attr-group' ).forEach( function ( g ) {
				if ( ! g.querySelector( 'input.bb-price-input' ) ) { return; }
				var say = bbPriceOut( g );
				if ( say ) { bbMissPaint( g, say ); }
			} );
			bbTotal();
		} );
		document.addEventListener( 'blur', function ( e ) {
			var b = e.target;
			if ( ! b || ! b.classList ) { return; }
			// The same way out of the box for an email or a web address: told
			// at the field, on leaving it, in the server's words.
			if ( ! b.classList.contains( 'bb-price-input' ) && ! b.hasAttribute( 'data-bb-bad' ) ) { return; }
			var g = b.closest ? b.closest( '.bb-attr-group' ) : null;
			if ( ! g ) { return; }
			var say = bbPriceOut( g ) || bbFieldBad( g );
			if ( say ) { bbMissPaint( g, say ); } else { bbMissSync(); }
		}, true );
		// THE BROWSER'S OWN BUBBLE IS NOT THE PAGE'S VOICE. The email box keeps
		// type="email" for the phone keyboard and the typo hint, and with it the
		// browser refuses a malformed address at Add to cart, in a bubble of its
		// own words, before the gate above has run at all. The refusal stays;
		// the bubble goes: the gap is painted in the server's sentence and
		// summoned the way every other gap is, once, at the first of them.
		var bbBadMarkTimer = 0;
		document.addEventListener( 'invalid', function ( e ) {
			var b = e.target;
			if ( ! b || ! b.hasAttribute || ! b.hasAttribute( 'data-bb-bad' ) ) { return; }
			e.preventDefault();
			var g = b.closest ? b.closest( '.bb-attr-group' ) : null;
			if ( ! g ) { return; }
			bbMissPaint( g, bbFieldBad( g ) );
			if ( ! bbBadMarkTimer ) {
				bbBadMarkTimer = setTimeout( function () {
					bbBadMarkTimer = 0;
					var first = document.querySelector( '.bb-standalone-options .bb-attr-group.bb-gmiss' );
					if ( first ) { bbMissMark( first, bbPriceOut( first ) || bbFieldBad( first ) ); }
				}, 0 );
			}
		}, true );
			// Every state change funnels through bbTotal; the echoes, the scope
			// line and the peek bar ride the same wave, so none can go stale.
		var bbTotalCore = bbTotal;
		bbTotal = function () {
			bbTotalCore();
			bbEchoAll();
			bbEchoFolds();
			bbFoldGo();
			bbScope();
			bbMissSync();
			bbStPeekSync();
			bbSetupsSync();
			bbPhotoThumb();
		};
				// The peek bar: the bundle bar's shell standing in for the theme's add
		// button while it is off screen. Appended to <body> so no transformed
		// ancestor can capture its fixed positioning.
		var bbPeekBar = null;
		// Fold the tapped-open lines away: whenever the bar itself hides,
		// an open peek would otherwise reappear pre-opened later.
		function bbStPeekFold() {
			if ( ! bbPeekBar ) { return; }
			var l = bbPeekBar.querySelector( '.bb-peek-lines' );
			var o = bbPeekBar.querySelector( '.bb-peek-open' );
			if ( l ) { l.hidden = true; }
			if ( o ) { o.setAttribute( 'aria-expanded', 'false' ); }
			bbPeekBar.classList.remove( 'is-open' );
		}
		// THE BAR NEVER HIDES THE FOCUS. While it is up, the page keeps room
		// the height of the bar at the foot of the screen (scroll-padding), so
		// a choice reached with Tab is scrolled clear of the bar instead of
		// lighting up underneath it. Measured, not guessed: the bar's height
		// plus whatever it stands on (a theme's own phone bar). The page's own
		// setting comes back the moment the bar goes.
		var bbRoomSet = false;
		function bbPeekRoom() {
			var de = document.documentElement;
			if ( ! bbPeekBar || ! bbPeekBar.classList.contains( 'is-shown' ) ) {
				if ( bbRoomSet ) { de.style.removeProperty( 'scroll-padding-bottom' ); bbRoomSet = false; }
				return;
			}
			var lift = parseFloat( window.getComputedStyle( bbPeekBar ).bottom ) || 0;
			de.style.setProperty( 'scroll-padding-bottom', Math.ceil( bbPeekBar.offsetHeight + lift + 8 ) + 'px' );
			bbRoomSet = true;
		}
		function bbStPeekSync() {
			if ( ! bbPeekBar ) { return; }
			var box = bbStBox();
			// A grid total is empty until a quantity is typed, and its button
			// stays disabled until then. Both say the same thing, so an empty
			// box hides the bar rather than pinning a blank figure and a dead
			// button to the bottom of the screen.
			if ( ! bbStHasFigure( box ) ) {
				bbPeekBar.bbHasTotal = false;
				bbPeekBar.classList.remove( 'is-shown' );
				bbStPeekFold();
				bbPeekRoom();
				return;
			}
			// innerHTML, not textContent: carry the total's dual-basis markup (when
			// a VAT toggle is on) to the peek bar so it answers the switch too.
			bbPeekBar.querySelector( '.bb-peek-info' ).innerHTML = bbStFigure( box ).innerHTML;
			// The stand-in is never more willing than the button it stands for.
			// A grid disables its own button while the order is incomplete, and
			// a copy that stayed live would be a button that quietly does
			// nothing, which is worse than no button.
			var bbReal = bbStRealAdd();
			var bbCta  = bbPeekBar.querySelector( '.bb-peek-cta' );
			if ( bbReal && bbCta ) { bbCta.disabled = !! bbReal.disabled; }
			bbPeekBar.bbHasTotal = true;
			bbPeekBar.classList.toggle( 'is-shown', !! bbPeekBar.bbOff );
			if ( ! bbPeekBar.classList.contains( 'is-shown' ) ) {
				bbStPeekFold();
			} else {
				// An open peek rides the same wave as the total: re-copy the
				// lines on every change, so it can never show a stale receipt.
				var bbPl = bbPeekBar.querySelector( '.bb-peek-lines' );
				var bbSrc = bbStLines( box );
				if ( bbPl && ! bbPl.hidden && bbSrc ) { bbPl.innerHTML = bbSrc.innerHTML; }
			}
			bbPeekRoom();
		}
		// The boot prints inside the form BEFORE the add button parses, so the
		// bar mounts at DOM-ready, when the button it stands in for exists.
		function bbStPeekMount() {
			if ( bbPeekBar || ! bbStBox() || ! ( 'IntersectionObserver' in window ) ) { return; }
			var real = bbStRealAdd();
			if ( ! real ) { return; }
			bbPeekBar = document.createElement( 'div' );
			bbPeekBar.className = 'bb-tray-peek bb-st-peek';
			// Tap-to-peek: the total is a button that lifts the receipt's own
			// lines up out of the bar, so the shopper can check what is in the
			// number without scrolling back. The lines are the receipt's very
			// markup, copied on open and on every later change.
			var lines = document.createElement( 'div' );
			lines.className = 'bb-peek-lines';
			lines.id     = 'bb-peek-lines';
			lines.hidden = true;
			var row  = document.createElement( 'div' );
			row.className = 'bb-peek-row';
			var info = document.createElement( 'span' );
			info.className = 'bb-peek-info';
			var open = document.createElement( 'button' );
			open.type      = 'button';
			open.className = 'bb-peek-open';
			open.setAttribute( 'aria-expanded', 'false' );
			open.setAttribute( 'aria-controls', 'bb-peek-lines' );
			var chev = document.createElement( 'span' );
			chev.className = 'bb-peek-chev';
			chev.setAttribute( 'aria-hidden', 'true' );
			chev.textContent = '\u25B2';
			// No label: the figure and the chevron say it all (his trim).
			// The button still announces itself to screen readers.
			open.setAttribute( 'aria-label', '<?php echo esc_js( __( 'Grand total', 'addon-boss' ) ); ?>' );
			// The money and what is still owed, stacked, with the chevron beside
			// the pair rather than beside the money alone.
			var left = document.createElement( 'span' );
			left.className = 'bb-peek-left';
			// The receipt's twin carries dir="auto" for the same reason: this
			// sentence opens with a number, which a right-to-left page throws
			// to the far end unless the element owns its own direction.
			left.setAttribute( 'dir', 'auto' );
			left.hidden = true;
			var stack = document.createElement( 'span' );
			stack.className = 'bb-peek-stack';
			stack.appendChild( info );
			stack.appendChild( left );
			var figr = document.createElement( 'span' );
			figr.className = 'bb-peek-figure';
			figr.appendChild( stack );
			figr.appendChild( chev );
			open.appendChild( figr );
			var cta  = document.createElement( 'button' );
			cta.type = 'button';
			cta.className   = 'bb-peek-cta';
			cta.textContent = ( real.textContent || '' ).trim() || 'Add to cart';
			row.appendChild( open );
			row.appendChild( cta );
			bbPeekBar.appendChild( lines );
			bbPeekBar.appendChild( row );
			document.body.appendChild( bbPeekBar );
			// The bar is a HOST of the borrowed accent and it is built here,
			// after the page-load check has already run, so it asks for the
			// check itself. Idempotent: a host that has been read carries a
			// flag and is not read twice.
			bbAccentFloor();
			open.addEventListener( 'click', function () {
				var src = bbStBox() && bbStLines( bbStBox() );
				lines.hidden = ! lines.hidden;
				if ( ! lines.hidden && src ) { lines.innerHTML = src.innerHTML; }
				open.setAttribute( 'aria-expanded', lines.hidden ? 'false' : 'true' );
				bbPeekBar.classList.toggle( 'is-open', ! lines.hidden );
				bbPeekRoom();
			} );
			// The peek bar owns the pinned total from here: the receipt stands
			// down to a plain block (bb-has-peek), so the figure is never
			// pinned to the viewport twice at once.
			var stbox = bbStBox();
			if ( stbox ) { stbox.classList.add( 'bb-has-peek' ); }
			cta.addEventListener( 'click', function () { real.click(); } );
			new IntersectionObserver( function ( entries ) {
				bbPeekBar.bbOff = ! entries[ 0 ].isIntersecting;
				bbPeekBar.classList.toggle( 'is-shown', !! ( bbPeekBar.bbOff && bbPeekBar.bbHasTotal ) );
				if ( ! bbPeekBar.classList.contains( 'is-shown' ) ) { bbStPeekFold(); }
				bbPeekRoom();
			} ).observe( real );
			// On a grid the options driver never runs, so nothing would ever call
			// bbStPeekSync again.
			//
			// 🔴 WATCH THE FIGURE, do not listen for the announcement. The grid
			// dispatches bb-grid-recount partway through its own tally, BEFORE
			// it writes the new total: a listener on it reads the figure that
			// was there a moment ago. On the first quantity of a fresh page
			// that is the empty string, so the bar concluded there was no total
			// yet, hid itself, and — no further event ever coming — stayed
			// hidden for the rest of the visit however much was ordered.
			// Stefanos saw exactly that on the club polo, 1 September, against
			// David's live shop where the bar does appear.
			//
			// The total element is the thing the bar mirrors, so observing it
			// is the honest seam and it cannot be raced: whenever the figure is
			// written, whoever wrote it and whenever, the bar follows.
			var bbStTotalBox = bbStBox();
			if ( bbStTotalBox && 'MutationObserver' in window ) {
				new MutationObserver( bbStPeekSync ).observe( bbStTotalBox, {
					childList: true,
					characterData: true,
					subtree: true,
					attributes: true,
					attributeFilter: [ 'hidden', 'class' ]
				} );
			}
			// The events still carry the button's own state, because a grid can
			// go from addable back to nothing (clearing every quantity) without
			// the total's markup being the thing that changed. They run after
			// the observer has had its say, never instead of it.
			var bbGridRoot = document.querySelector( '.bb-standalone-grid' );
			if ( bbGridRoot ) {
				bbGridRoot.addEventListener( 'bb-grid-recount', bbStPeekSync );
				bbGridRoot.addEventListener( 'bb-fees-settled', bbStPeekSync );
				// The grid's picks travel on its own wave, not on bbTotal's, so
				// the marks have to ride it too: a shopper who touched nothing
				// but a whole-order pill would otherwise watch that set stay
				// unmarked while the fields around it marked themselves.
				bbGridRoot.addEventListener( 'bb-grid-recount', bbScope );
				bbGridRoot.addEventListener( 'bb-fees-settled', bbScope );
				// A set the bar's Show me marked lets go of its mark once it is
				// answered, on the same wave, as a marked question does on the
				// one-at-a-time page.
				bbGridRoot.addEventListener( 'bb-fees-settled', bbMissSync );
			}
			bbStPeekSync();
		}
		if ( 'loading' !== document.readyState ) {
			bbStPeekMount();
		} else {
			document.addEventListener( 'DOMContentLoaded', bbStPeekMount );
		}
		// A QUANTITY GRID DRAWN IN ONE OF THE LAYOUTS. Its picks are pills and
		// its quantities are steppers, and neither travels on bbTotal's wave:
		// the grid tallies for itself and says when it has finished. Everything
		// a layout shows (the echoes, the folds, the steps, the review) re-reads
		// then. Only on a grid that names a look, so a plain grid is left with
		// exactly the listeners it has always had.
		var bbGridLook = document.querySelector( '.bb-standalone-grid .bb-grid-personalise[data-bb-layout]' );
		if ( bbGridLook ) {
			bbGridOf( bbGridLook ).addEventListener( 'bb-grid-settled', function () {
				bbEchoAll();
				bbEchoFolds();
				bbFoldGo();
				bbScope();
				bbMissSync();
			} );
		}
		// A percentage badge that turned into money after the total ran (the
		// tables module's bbTblAdjBadges): the headers re-read the badges, so a
		// chosen choice's header says what its chip says.
		document.addEventListener( 'bb-adj-badges-painted', function () {
			bbEchoAll();
			bbEchoFolds();
		} );
		// First paint: the echoes and the scope line tell the story straight
		// away, on the fold summaries too, so a shut group never starts blank.
		( function () {
			bbEchoAll();
			bbEchoFolds();
			bbQtySay();
			bbAutoPick();
			bbFoldGo();
			// After the echoes and the folds, because a step counts the cards
			// as the page has actually settled them, and last of the layouts
			// because it is the one that takes cards off the screen.
			bbStepMount();
			bbScope();
			bbStPeekSync();
			bbSetupsWire();
			bbPhotoView();
		} )();
		} )();
	<?php
	} finally {
		// Closes whether this returns or throws. The buffer holds the WHOLE boot
		// script, so leaving it open does not lose a stylesheet, it swallows the
		// rest of the page.
		$bb_js = (string) ob_get_clean();
	}
	return $bb_js;
}

// =================================================================
// ADMIN: the Option Sets library screen + the per-product "Product options"
// tab. Lifted from slot-options at the split. Menu parent + admin CSS come
// from includes/admin-menu.php via the addon_boss_menu_parent /
// addon_boss_engine_admin_css filters.
// =================================================================

// =================================================================
// Admin: the Option sets screen
// =================================================================

add_action( 'admin_menu', 'addon_boss_register_option_sets_page', 12 );

/** The page's hook suffix, captured at registration for the asset gate. */
function addon_boss_option_sets_hook( string $set = '' ): string {
	static $hook = '';
	if ( '' !== $set ) {
		$hook = $set;
	}
	return $hook;
}

function addon_boss_register_option_sets_page(): void {
	// A library nobody can attach to anything is a menu item that only puzzles a
	// merchant, so the screen goes with the feature.
	if ( ! addon_boss_options_available() ) {
		return;
	}
	// The Option Sets library page attaches under the AddOnBoss menu, provided
	// by includes/admin-menu.php through this filter.
	$parent = (string) apply_filters( 'addon_boss_menu_parent', '' );
	if ( '' === $parent ) {
		return;
	}
	addon_boss_option_sets_hook(
		(string) add_submenu_page(
			$parent,
			__( 'Option sets', 'addon-boss' ),
			__( 'Option sets', 'addon-boss' ),
			'manage_woocommerce',
			'addon-boss-option-sets',
			'addon_boss_render_option_sets_page'
		)
	);
}

add_action( 'admin_enqueue_scripts', 'addon_boss_option_sets_assets' );

/**
 * The version for an engine asset URL. The host plugin already owns a
 * cache-busting helper (addon-boss.php: plugin version in production,
 * the file's mtime under WP_DEBUG) - the bug was that these enqueues
 * never called it, so a dev store served edited stylesheets from the
 * browser cache under the same version string. This adapter maps the
 * filtered URL back to the host-relative path the helper expects, and
 * steps aside for files some other host's filter pointed elsewhere.
 */
function addon_boss_engine_asset_version( string $url ): string {
	if ( function_exists( 'addon_boss_asset_version' ) && defined( 'ADDON_BOSS_URL' ) && 0 === strpos( $url, ADDON_BOSS_URL ) ) {
		return addon_boss_asset_version( substr( $url, strlen( ADDON_BOSS_URL ) ) );
	}
	return defined( 'ADDON_BOSS_VERSION' ) ? ADDON_BOSS_VERSION : '1';
}

function addon_boss_option_sets_assets( string $hook ): void {
	if ( '' === $hook || $hook !== addon_boss_option_sets_hook() ) {
		return;
	}
	// The admin stylesheet arrives through the filter (css/admin.css), so the
	// Option Sets page styles correctly.
	$css = (string) apply_filters( 'addon_boss_engine_admin_css', '' );
	if ( '' !== $css ) {
		wp_enqueue_style( 'addon-boss-options-admin', $css, array(), addon_boss_engine_asset_version( $css ) );
		// The tag chips ride the same sheet, so a build without the module
		// ships no rules for a thing it cannot draw.
		if ( function_exists( 'addon_boss_tag_styles' ) ) {
			wp_add_inline_style( 'addon-boss-options-admin', addon_boss_tag_styles() );
		}
	}
}

// The product-options tab lives on every product-edit screen (not just the
// Option Sets page), so the engine loads its admin stylesheet + JS there too.
// Priority 20 runs after other plugins' admin enqueues. The stylesheet always
// comes with the panel: a post-split BundleBoss styles only its own bundle
// panels, so nobody else owns these rules any more (loading after a pre-split
// BundleBoss is harmless, the rules are same-lineage). The script still steps
// aside when the bundle-boss-admin handle is present, because a pre-split
// BundleBoss binds the same generic admin behaviours.
add_action( 'admin_enqueue_scripts', 'addon_boss_options_product_admin_assets', 20 );

function addon_boss_options_product_admin_assets( $hook ): void {
	if ( ! in_array( $hook, array( 'post.php', 'post-new.php' ), true ) ) {
		return;
	}
	$screen = function_exists( 'get_current_screen' ) ? get_current_screen() : null;
	if ( ! $screen || 'product' !== $screen->id ) {
		return;
	}
	$css = (string) apply_filters( 'addon_boss_engine_admin_css', '' );
	if ( '' !== $css ) {
		wp_enqueue_style( 'addon-boss-options-admin', $css, array(), addon_boss_engine_asset_version( $css ) );
	}
	if ( ! wp_script_is( 'bundle-boss-admin', 'enqueued' ) ) {
		$js = (string) apply_filters( 'addon_boss_engine_admin_js', '' );
		if ( '' !== $js ) {
			wp_enqueue_script( 'addon-boss-options-admin', $js, array( 'jquery', 'select2', 'jquery-ui-sortable' ), addon_boss_engine_asset_version( $js ), true );
			wp_localize_script(
				'addon-boss-options-admin',
				'addonBossAdmin',
				(array) apply_filters(
					'addon_boss_engine_admin_localize',
					array(
						'ajaxUrl' => admin_url( 'admin-ajax.php' ),
						'nonce'   => wp_create_nonce( 'addon_boss_admin' ),
						'i18n'    => array(),
					)
				)
			);
		}
	}

	// LAST, because it attaches to a handle the block above may have only just
	// enqueued. The look picker is drawn by this engine, so its script ships
	// with it rather than riding whichever admin bundle a host plugin happened
	// to register first: on a store running the sibling plugin, that bundle is
	// the sibling's, and it knows nothing about these controls.
	$bb_pick_on = wp_script_is( 'addon-boss-options-admin', 'enqueued' ) ? 'addon-boss-options-admin'
		: ( wp_script_is( 'bundle-boss-admin', 'enqueued' ) ? 'bundle-boss-admin' : '' );
	if ( '' === $bb_pick_on ) {
		wp_enqueue_script( 'jquery' );
		$bb_pick_on = 'jquery-core';
	}
	wp_add_inline_script( $bb_pick_on, addon_boss_options_picker_js() );
}

// The saved order of option-set groups (names), kept apart from the sets so an
// empty group a merchant just made is still there after a reload.
const ADDON_BOSS_OPTION_SET_GROUPS_STORE = 'bundle_boss_option_set_groups';

function addon_boss_option_set_groups(): array {
	$saved = get_option( ADDON_BOSS_OPTION_SET_GROUPS_STORE, array() );
	return is_array( $saved ) ? array_values( array_filter( array_map( 'strval', $saved ) ) ) : array();
}

/**
 * The library arranged the way a merchant sees it: folder name => [set id =>
 * name], in the order the list page put the folders in, with everything in no
 * folder last under an empty key.
 *
 * A folder holding nothing is not listed: it is real on the library page (an
 * empty folder a merchant just made is still theirs) but there is nothing to
 * attach from it, and offering "everything in here" over an empty folder is a
 * control that does nothing.
 *
 * @return array<string,array<string,string>>
 */
function addon_boss_option_sets_by_group(): array {
	$sets   = addon_boss_option_sets();
	$out    = array();
	$loose  = array();
	$known  = addon_boss_option_set_groups();
	foreach ( $known as $bb_g ) {
		$out[ $bb_g ] = array();
	}
	foreach ( $sets as $bb_id => $bb_set ) {
		$bb_g = (string) ( $bb_set['group'] ?? '' );
		if ( '' === $bb_g ) {
			$loose[ $bb_id ] = (string) ( $bb_set['name'] ?? $bb_id );
			continue;
		}
		// A set naming a folder the order list never heard of still belongs
		// somewhere, so its folder joins the end rather than swallowing the set.
		if ( ! isset( $out[ $bb_g ] ) ) {
			$out[ $bb_g ] = array();
		}
		$out[ $bb_g ][ $bb_id ] = (string) ( $bb_set['name'] ?? $bb_id );
	}
	$out = array_filter( $out ); // drop the folders with nothing in them
	if ( $loose ) {
		$out[''] = $loose;
	}
	return $out;
}

add_action( 'wp_ajax_addon_boss_save_set_groups', 'addon_boss_ajax_save_set_groups' );
/**
 * Persist the grouping from the list page: which group each set sits in, plus
 * the ordered list of group names. One full-state write, so a drop, a rename
 * and a delete all travel the same path (the client sends the whole picture).
 */
function addon_boss_ajax_save_set_groups(): void {
	if ( ! current_user_can( 'manage_woocommerce' ) ) {
		wp_send_json_error( 'forbidden', 403 );
	}
	check_ajax_referer( 'addon_boss_set_groups' );

	$assignments = ( isset( $_POST['assignments'] ) && is_array( $_POST['assignments'] ) )
		? wp_unslash( $_POST['assignments'] ) // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized -- each id + value sanitised in the loop.
		: array();
	$order = ( isset( $_POST['order'] ) && is_array( $_POST['order'] ) )
		? array_map( 'sanitize_text_field', wp_unslash( $_POST['order'] ) )
		: array();

	// A set MOVING INTO a group is the moment worth noticing: products already
	// carrying that group do not have it yet, and hunting them down by hand is
	// the job the group was supposed to save. Recorded here and handed back, so
	// the page can offer rather than a group silently changing live products.
	$bb_joined = array();
	addon_boss_option_sets_change(
		static function ( array $sets ) use ( $assignments, &$bb_joined ): array {
			foreach ( $assignments as $set_id => $group ) {
				$set_id = sanitize_text_field( (string) $set_id );
				if ( ! isset( $sets[ $set_id ] ) ) {
					continue;
				}
				$bb_group = sanitize_text_field( (string) $group );
				$bb_was   = (string) ( $sets[ $set_id ]['group'] ?? '' );
				if ( '' !== $bb_group && $bb_group !== $bb_was ) {
					$bb_missing = addon_boss_products_missing_set( $bb_group, $set_id );
					if ( $bb_missing ) {
						$bb_joined[] = array(
							'set'   => $set_id,
							'name'  => (string) ( $sets[ $set_id ]['name'] ?? $set_id ),
							'group' => $bb_group,
							'count' => count( $bb_missing ),
						);
					}
				}
				$sets[ $set_id ]['group'] = $bb_group;
			}
			return $sets;
		}
	);

	// Keep unique, non-empty names in the given order.
	$clean = array();
	foreach ( $order as $name ) {
		$name = trim( $name );
		if ( '' !== $name && ! in_array( $name, $clean, true ) ) {
			$clean[] = $name;
		}
	}
	update_option( ADDON_BOSS_OPTION_SET_GROUPS_STORE, $clean, false );

	wp_send_json_success( array( 'joined' => $bb_joined ) );
}

/**
 * Products carrying a group that do NOT yet have one of its sets.
 *
 * Findable because every row attached through the group picker records the
 * group it arrived with, which is the whole reason that was stored.
 *
 * @param string $group  The group name.
 * @param string $set_id The set they may be missing.
 * @return int[] Product ids.
 */
function addon_boss_products_missing_set( string $group, string $set_id ): array {
	if ( '' === $group || '' === $set_id ) {
		return array();
	}
	$bb_q = new WP_Query(
		array(
			'post_type'      => 'product',
			'post_status'    => array( 'publish', 'draft', 'private', 'pending' ),
			'posts_per_page' => 200,
			'fields'         => 'ids',
			'meta_key'       => ADDON_BOSS_PRODUCT_OPTIONS_META, // phpcs:ignore WordPress.DB.SlowDBQuery.slow_db_query_meta_key -- a bounded admin-only lookup, not a front-end query.
		)
	);
	$out = array();
	foreach ( $bb_q->posts as $bb_pid ) {
		$bb_rows  = addon_boss_flatten_option_config( (array) get_post_meta( (int) $bb_pid, ADDON_BOSS_PRODUCT_OPTIONS_META, true ) );
		$bb_from  = false;
		$bb_hasit = false;
		foreach ( $bb_rows as $bb_r ) {
			if ( ( $bb_r['set'] ?? '' ) === $set_id ) {
				$bb_hasit = true;
				break;
			}
			if ( (string) ( $bb_r['from_group'] ?? '' ) === $group ) {
				$bb_from = true;
			}
		}
		if ( $bb_from && ! $bb_hasit ) {
			$out[] = (int) $bb_pid;
		}
	}
	return $out;
}

add_action( 'wp_ajax_addon_boss_apply_set_to_group', 'addon_boss_ajax_apply_set_to_group' );
/**
 * Add one set to every product carrying its group and missing it.
 *
 * Only ever runs because somebody pressed the offer. Nothing about a group
 * reaches a live product on its own, which is the line between this and simply
 * linking the group, where editing the library would change what is on sale.
 */
function addon_boss_ajax_apply_set_to_group(): void {
	if ( ! current_user_can( 'manage_woocommerce' ) ) {
		wp_send_json_error( 'forbidden', 403 );
	}
	check_ajax_referer( 'addon_boss_set_groups' );

	$bb_set   = isset( $_POST['set'] ) ? sanitize_text_field( wp_unslash( $_POST['set'] ) ) : '';
	$bb_group = isset( $_POST['group'] ) ? sanitize_text_field( wp_unslash( $_POST['group'] ) ) : '';
	if ( '' === $bb_set || '' === $bb_group || ! addon_boss_option_set( $bb_set ) ) {
		wp_send_json_error( 'unknown set', 400 );
	}

	$bb_done = 0;
	foreach ( addon_boss_products_missing_set( $bb_group, $bb_set ) as $bb_pid ) {
		$bb_product = wc_get_product( $bb_pid );
		if ( ! $bb_product instanceof WC_Product ) {
			continue;
		}
		// Appended, never inserted mid-list: the merchant's own arrangement is
		// theirs, and a set arriving in the middle of it would be a second
		// surprise on top of the one they asked for.
		$bb_rows   = addon_boss_product_option_config( $bb_product, true );
		$bb_rows[] = array( 'set' => $bb_set, 'from_group' => $bb_group );
		addon_boss_save_product_option_config( $bb_product, $bb_rows );
		$bb_done++;
	}
	wp_send_json_success( array( 'applied' => $bb_done ) );
}

function addon_boss_render_option_sets_page(): void {
	if ( ! current_user_can( 'manage_woocommerce' ) ) {
		wp_die( esc_html__( 'Sorry, you are not allowed to do that.', 'addon-boss' ) );
	}
	$notice = get_transient( 'bundle_boss_option_sets_notice_' . get_current_user_id() );
	if ( $notice ) {
		delete_transient( 'bundle_boss_option_sets_notice_' . get_current_user_id() );
		// Tolerate the old plain-string shape as well as the {m,t} array.
		$msg  = is_array( $notice ) ? (string) ( $notice['m'] ?? '' ) : (string) $notice;
		$type = is_array( $notice ) ? (string) ( $notice['t'] ?? 'success' ) : 'success';
		// A notice may carry its one next action (label + URL): the checklist's
		// "now attach it" after a first save. Escaped here, where it prints.
		$act  = is_array( $notice ) && is_array( $notice['a'] ?? null ) ? $notice['a'] : array();
		$link = '';
		if ( '' !== (string) ( $act['l'] ?? '' ) && '' !== (string) ( $act['u'] ?? '' ) ) {
			$link = ' <a class="button button-small bb-notice-act" href="' . esc_url( (string) $act['u'] ) . '">' . esc_html( (string) $act['l'] ) . '</a>';
		}
		printf(
			'<div class="notice notice-%1$s is-dismissible"><p>%2$s%3$s</p></div>',
			esc_attr( $type ),
			esc_html( $msg ),
			wp_kses( $link, addon_boss_kses_allowed() )
		);
	}

	$editing = isset( $_GET['set'] ) ? sanitize_text_field( wp_unslash( $_GET['set'] ) ) : ''; // phpcs:ignore WordPress.Security.NonceVerification.Recommended -- read-only routing.
	$recipe  = isset( $_GET['recipe'] ) ? sanitize_key( wp_unslash( $_GET['recipe'] ) ) : ''; // phpcs:ignore WordPress.Security.NonceVerification.Recommended -- read-only routing.
	echo '<div class="wrap">';
	if ( 'new' === $editing && '' === $recipe ) {
		// Never a blank page: a brand-new set opens on the starting points, the
		// same on-ramp idiom the price-table gallery established. Every stored
		// set, and a picked recipe, goes straight to the editor.
		addon_boss_render_new_set_onramp();
	} elseif ( '' !== $editing ) {
		// The editor and the customer's page side by side on a wide screen,
		// one under the other on a narrow one (css/editor.css).
		echo '<div class="bb-ed2" id="bb-ed2"><div class="bb-ed2-main">';
		addon_boss_render_option_set_editor( $editing, 'new' === $editing ? addon_boss_new_set_recipe_seed( $recipe ) : null );
		echo '</div><aside class="bb-ed2-side" aria-label="' . esc_attr__( 'Customer page', 'addon-boss' ) . '">';
		addon_boss_set_preview_panel();
		echo '</aside></div>';
	} else {
		addon_boss_render_option_sets_list();
	}
	echo '</div>';
}

/**
 * What WooCommerce's own quantity box counts on this product, when that is
 * not the product itself: on a product priced by a pack list ("100 cards",
 * "500 cards") each one is a pack, and the box says "Number of packs" over
 * it. Print shops label it that way; none puts a second plain "Quantity"
 * by the button. The module that knows the list decides, through the
 * filter; the page's script puts the words on the theme's own label.
 *
 * @param WC_Product $product The product.
 * @return string The attribute for the panel, or ''.
 */
function addon_boss_qty_say_attr( $product ): string {
	$say = (string) apply_filters( 'addon_boss_qty_counts', '', $product );
	return '' !== $say ? ' data-bb-qty-say="' . esc_attr( $say ) . '"' : '';
}

/**
 * The cards on the new-set start screen: one per set kind this build
 * registers, in the order the kinds ask for, so a free build shows the list
 * of choices alone and never advertises what it cannot do. A kind without a
 * card of its own still gets one, from its own label and line, opening it
 * empty: a kind can never be registered and out of reach.
 *
 * @return array<string,array<string,mixed>> kind => card.
 */
function addon_boss_new_set_start_cards(): array {
	$cards = array();
	foreach ( addon_boss_option_set_kinds() as $bb_k => $bb_spec ) {
		$bb_k    = (string) $bb_k;
		$bb_card = is_callable( $bb_spec['start'] ?? null ) ? (array) call_user_func( $bb_spec['start'] ) : array();
		$bb_tt   = (string) ( $bb_card['title'] ?? '' );
		if ( '' === $bb_tt ) {
			$bb_tt = ucfirst( (string) ( $bb_spec['label'] ?? $bb_k ) );
		}
		$cards[ $bb_k ] = array(
			'order'   => (int) ( $bb_card['order'] ?? 50 ),
			'title'   => $bb_tt,
			'line'    => (string) ( $bb_card['line'] ?? ( $bb_spec['desc'] ?? '' ) ),
			'pic'     => (string) ( $bb_card['pic'] ?? '' ),
			'blank'   => (string) ( $bb_card['blank'] ?? ( 'choices' === $bb_k ? 'scratch' : 'kind_' . $bb_k ) ),
			'recipes' => (array) ( $bb_card['recipes'] ?? array() ),
			'ask'     => (string) ( $bb_card['ask'] ?? '' ),
		);
	}
	uasort(
		$cards,
		static function ( array $a, array $b ): int {
			return $a['order'] <=> $b['order'];
		}
	);
	return $cards;
}

/**
 * The seed a new-set recipe pre-fills the editor with, or null for a scratch
 * start (and for anything unrecognised, which must never block the editor).
 *
 * Two families of recipe, both fully editable before anything saves:
 *  - a template from a start card (a starter list, a price table), arriving
 *    with its rows, prices and pick rule filled in, as the card's own kind;
 *  - a registered set kind ('kind_<kind>'), arriving empty but with the kind
 *    already chosen. Only kinds this build registers qualify, so a stripped
 *    build offers exactly the kinds it can honour.
 */
function addon_boss_new_set_recipe_seed( string $recipe ): ?array {
	if ( '' === $recipe || 'scratch' === $recipe ) {
		return null;
	}
	if ( 0 === strpos( $recipe, 'kind_' ) ) {
		$kind = substr( $recipe, 5 );
		if ( 'choices' !== $kind && isset( addon_boss_option_set_kinds()[ $kind ] ) ) {
			// The kind goes on AFTER the sanitiser. A kind's own sanitiser turns
			// a set with nothing of its own yet (no sizes, no grid) back into a
			// plain list, which is right for a save and wrong for a blank start:
			// the old on-ramp's "Priced by a rate" tile opened a list of choices.
			$seed         = addon_boss_sanitize_option_set(
				array(
					'name'    => '',
					'options' => array(),
				)
			);
			$seed['kind'] = $kind;
			return $seed;
		}
		return null;
	}
	foreach ( addon_boss_new_set_start_cards() as $bb_k => $bb_card ) {
		$bb_set = $bb_card['recipes'][ $recipe ]['set'] ?? null;
		if ( is_array( $bb_set ) ) {
			$bb_set['kind'] = $bb_k;
			// Through the set sanitiser, so the seed carries the exact stored
			// shape the editor expects: generated option keys, resolved name-map
			// swatches, lawful bounds. The keys ride the form and persist on save.
			return addon_boss_sanitize_option_set( $bb_set );
		}
	}
	return null;
}

/**
 * The new-set start screen: "What kind of set?", one card per kind of set
 * this build can make, in a fixed order with the list of choices first.
 *
 * - The card is the button: one click opens that kind of set, blank. Most
 *   products start a new thing that way (blank first, or by default, in 16
 *   of the 25 we checked).
 * - Templates wait one click away under each card, "or use a template (n)",
 *   never on show by default: forced galleries are what merchants complain
 *   about. Each tile is summed up from its own numbers.
 * - "Most used" marks the list of choices for someone who has not made a set
 *   here yet; after that, "Last used" marks the kind they made last. The
 *   cards never move, because a fixed layout is faster than one that
 *   reorders.
 * - A build with one kind shows its card with the templates already open.
 *
 * Server-rendered links throughout, so it all works before a line of script
 * arrives; the script only opens and shuts the template panels in place.
 * Nothing saves until Save set in the editor, which says so.
 */
function addon_boss_render_new_set_onramp(): void {
	$base  = admin_url( 'admin.php?page=addon-boss-option-sets&set=new' );
	$group = isset( $_GET['group'] ) ? sanitize_text_field( wp_unslash( $_GET['group'] ) ) : ''; // phpcs:ignore WordPress.Security.NonceVerification.Recommended -- carried to the editor, which validates it on save.
	if ( '' !== $group ) {
		$base .= '&group=' . rawurlencode( $group );
	}
	// Opened from a product's own link: the set goes back to it.
	if ( addon_boss_for_product_param() ) {
		$base .= '&for_product=' . addon_boss_for_product_param();
	}
	$cards = addon_boss_new_set_start_cards();
	$one   = 1 === count( $cards );
	$open  = isset( $_GET['open'] ) ? sanitize_key( wp_unslash( $_GET['open'] ) ) : ''; // phpcs:ignore WordPress.Security.NonceVerification.Recommended -- which template panel shows; nothing changes.
	if ( $one ) {
		$open = (string) array_key_first( $cards );
	} elseif ( ! isset( $cards[ $open ] ) ) {
		$open = '';
	}
	$badge = array();
	if ( ! $one ) {
		$last = addon_boss_last_new_set_kind();
		if ( isset( $cards[ $last ] ) ) {
			$badge[ $last ] = array( 'last', __( 'Last used', 'addon-boss' ) );
		} elseif ( isset( $cards['choices'] ) ) {
			$badge['choices'] = array( 'most', __( 'Most used', 'addon-boss' ) );
		}
	}

	echo '<div class="bb-optsets bb-start" id="bb-start">';
	echo '<h1 class="screen-reader-text">' . esc_html__( 'New option set', 'addon-boss' ) . '</h1>';
	addon_boss_optsets_header(
		__( 'Option sets / New set', 'addon-boss' ),
		'<a href="' . esc_url( admin_url( 'admin.php?page=addon-boss-option-sets' ) ) . '" class="button">' . esc_html__( 'Back to sets', 'addon-boss' ) . '</a>'
	);
	echo '<h2 class="bb-start-q">' . esc_html( $one && isset( $cards['choices'] ) ? __( 'Start a new list of choices', 'addon-boss' ) : __( 'What kind of set?', 'addon-boss' ) ) . '</h2>';
	echo '<div class="bb-start-kinds' . ( $one ? ' is-one' : '' ) . '" id="bb-start-cards">';
	// The coral Start blank goes to the card the badge marks, so one card
	// stands out, not two (fresh tester, 18 Oct 2026: "Last used" on one
	// card, the coral button on another).
	$bb_star = $badge ? (string) array_key_first( $badge ) : (string) array_key_first( $cards );
	foreach ( $cards as $bb_k => $bb_card ) {
		$bb_k     = (string) $bb_k;
		$bb_n     = count( $bb_card['recipes'] );
		$bb_shown = $open === $bb_k;
		echo '<div class="bb-start-col" data-kind="' . esc_attr( $bb_k ) . '">';
		echo '<a class="bb-start-card' . ( $bb_k === $bb_star ? ' is-first' : '' ) . '" href="' . esc_url( $base . '&recipe=' . rawurlencode( $bb_card['blank'] ) ) . '" data-recipe="' . esc_attr( $bb_card['blank'] ) . '">';
		// The drawing is code, not merchant input, and still goes through the
		// drawing allow list.
		echo '<span class="bb-start-stage">' . addon_boss_options_card_svg( $bb_card['pic'] ) . '</span>'; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- wp_kses'd by addon_boss_options_card_svg().
		echo '<span class="bb-start-text"><span class="bb-start-name">' . esc_html( $bb_card['title'] );
		if ( isset( $badge[ $bb_k ] ) ) {
			echo ' <span class="bb-start-badge is-' . esc_attr( $badge[ $bb_k ][0] ) . '">' . esc_html( $badge[ $bb_k ][1] ) . '</span>';
		}
		echo '</span>';
		if ( '' !== $bb_card['line'] ) {
			echo '<span class="bb-start-line">' . esc_html( $bb_card['line'] ) . '</span>';
		}
		echo '<span class="bb-start-go">' . esc_html__( 'Start blank', 'addon-boss' ) . ' <span class="bb-start-arr" aria-hidden="true">&rarr;</span></span>';
		echo '</span></a>';
		if ( $bb_n && ! $one ) {
			echo '<a class="bb-start-more" href="' . esc_url( $bb_shown ? $base : $base . '&open=' . rawurlencode( $bb_k ) ) . '" data-open="' . esc_attr( $bb_k ) . '" aria-controls="bb-start-panel-' . esc_attr( $bb_k ) . '" aria-expanded="' . ( $bb_shown ? 'true' : 'false' ) . '">'
				/* translators: %d: how many templates this kind of set has */
				. esc_html( sprintf( __( 'or use a template (%d)', 'addon-boss' ), $bb_n ) ) . '</a>';
		}
		echo '</div>';
		if ( $bb_n ) {
			/* translators: %s: a kind of option set, like "Price table" */
			$bb_head = sprintf( __( '%s templates', 'addon-boss' ), $bb_card['title'] );
			echo '<div class="bb-start-panel" id="bb-start-panel-' . esc_attr( $bb_k ) . '" data-kind="' . esc_attr( $bb_k ) . '" role="region" aria-label="' . esc_attr( $bb_head ) . '"' . ( $one ? ' data-stay="1"' : '' ) . ( $bb_shown ? '' : ' hidden' ) . '>';
			echo '<div class="bb-start-phead"><h3>' . esc_html( $bb_head ) . '</h3>';
			if ( ! $one ) {
				echo '<a class="bb-start-close" href="' . esc_url( $base ) . '" data-close="' . esc_attr( $bb_k ) . '" aria-label="' . esc_attr__( 'Close templates', 'addon-boss' ) . '">&times;</a>';
			}
			echo '</div><div class="bb-start-tiles">';
			foreach ( $bb_card['recipes'] as $bb_rid => $bb_r ) {
				echo '<a class="bb-start-tile" href="' . esc_url( $base . '&recipe=' . rawurlencode( (string) $bb_rid ) ) . '" data-recipe="' . esc_attr( (string) $bb_rid ) . '">';
				echo '<span class="bb-start-mini" aria-hidden="true">' . addon_boss_new_set_mini_html( (array) ( $bb_r['mini'] ?? array() ) ) . '</span>'; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- every value escaped inside.
				echo '<span class="bb-start-tname">' . esc_html( (string) ( $bb_r['label'] ?? $bb_rid ) ) . '</span>';
				if ( '' !== (string) ( $bb_r['say'] ?? '' ) ) {
					echo '<span class="bb-start-tsay">' . esc_html( (string) $bb_r['say'] ) . '</span>';
				}
				echo '</a>';
			}
			echo '</div>';
			if ( '' !== $bb_card['ask'] ) {
				echo '<p class="bb-start-ask">' . esc_html__( 'Not seeing what you sell?', 'addon-boss' ) . ' <a href="' . esc_url( $bb_card['ask'] ) . '" target="_blank" rel="noopener">' . esc_html__( 'Tell us what to add.', 'addon-boss' ) . '</a></p>';
			}
			echo '</div>';
		}
	}
	echo '</div></div>';
	addon_boss_inline_js( addon_boss_new_set_onramp_js() );
}

/**
 * A template tile's small picture, from the plain description its kind
 * gives: colour dots, a few chips, or a grid with one cell picked.
 *
 * @param array $mini { dots?: string[], chips?: string[], grid?: int[] } The grid is rows, columns and the picked cell.
 * @return string Markup with every value escaped.
 */
function addon_boss_new_set_mini_html( array $mini ): string {
	$h = '';
	foreach ( (array) ( $mini['dots'] ?? array() ) as $bb_hex ) {
		$bb_hex = sanitize_hex_color( (string) $bb_hex );
		if ( $bb_hex ) {
			$h .= '<span class="bb-start-dot" style="background:' . esc_attr( $bb_hex ) . '"></span>';
		}
	}
	foreach ( (array) ( $mini['chips'] ?? array() ) as $bb_chip ) {
		$h .= '<span class="bb-start-chip">' . esc_html( (string) $bb_chip ) . '</span>';
	}
	if ( ! empty( $mini['grid'] ) ) {
		$bb_g    = array_values( array_map( 'intval', (array) $mini['grid'] ) );
		$bb_rows = max( 1, min( 4, $bb_g[0] ?? 1 ) );
		$bb_cols = max( 1, min( 4, $bb_g[1] ?? 1 ) );
		$bb_on   = $bb_g[2] ?? -1;
		$h      .= '<span class="bb-start-grid" style="grid-template-columns:repeat(' . (int) $bb_cols . ',16px)">';
		for ( $bb_i = 0; $bb_i < $bb_rows * $bb_cols; $bb_i++ ) {
			$h .= '<span' . ( $bb_i === $bb_on ? ' class="is-on"' : '' ) . '></span>';
		}
		$h .= '</span>';
	}
	return $h;
}

/**
 * The kind of set this person made last, for the start screen's "Last used".
 * Per person, because two people running one shop make different things.
 *
 * @return string A kind, or '' before their first new set.
 */
function addon_boss_last_new_set_kind(): string {
	$bb_user = get_current_user_id();
	return $bb_user ? sanitize_key( (string) get_user_meta( $bb_user, 'addon_boss_last_set_kind', true ) ) : '';
}

/**
 * Remember the kind of a set this person just made, for the start screen.
 *
 * @param string $kind The new set's kind.
 */
function addon_boss_remember_new_set_kind( string $kind ): void {
	$bb_user = get_current_user_id();
	$kind    = sanitize_key( $kind );
	if ( $bb_user && '' !== $kind ) {
		update_user_meta( $bb_user, 'addon_boss_last_set_kind', $kind );
	}
}

/**
 * The start screen's script: it opens and shuts the template panels in
 * place of the links' page loads. One panel at a time; Escape shuts it and
 * puts focus back on the link that opened it. A build with one kind keeps
 * its panel open.
 *
 * @return string
 */
function addon_boss_new_set_onramp_js(): string {
	return <<<'JS'
( function () {
	var root = document.getElementById( 'bb-start' );
	if ( ! root ) { return; }
	function shut( back ) {
		var open = root.querySelector( '.bb-start-panel:not([hidden])' );
		if ( ! open || open.hasAttribute( 'data-stay' ) ) { return; }
		var k = open.getAttribute( 'data-kind' ), t = root.querySelector( '[data-open="' + k + '"]' );
		open.hidden = true;
		if ( t ) {
			t.setAttribute( 'aria-expanded', 'false' );
			if ( back ) { t.focus(); }
		}
	}
	root.querySelectorAll( '[data-open]' ).forEach( function ( t ) { t.setAttribute( 'role', 'button' ); } );
	root.addEventListener( 'click', function ( e ) {
		var t = e.target.closest ? e.target.closest( '[data-open], [data-close]' ) : null;
		if ( ! t ) { return; }
		e.preventDefault();
		if ( t.hasAttribute( 'data-close' ) ) { shut( true ); return; }
		var p = document.getElementById( 'bb-start-panel-' + t.getAttribute( 'data-open' ) );
		if ( ! p ) { return; }
		var was = ! p.hidden;
		shut( false );
		if ( ! was ) {
			p.hidden = false;
			t.setAttribute( 'aria-expanded', 'true' );
		}
	} );
	root.addEventListener( 'keydown', function ( e ) {
		if ( ' ' === e.key && e.target.hasAttribute && e.target.hasAttribute( 'data-open' ) ) {
			e.preventDefault();
			e.target.click();
		}
	} );
	document.addEventListener( 'keydown', function ( e ) {
		if ( 'Escape' === e.key ) { shut( true ); }
	} );
} )();
JS;
}

/**
 * The one pass behind every usage figure: each product's option config read
 * once per request, and each set mapped to the DISTINCT products that attach
 * it. A row's own set counts; a rule's trigger mentioning a set does not, so
 * "Used on N products" and the list behind it always tell the same story.
 *
 * A product in the bin does not count (his call, 5 Sept): its config rides
 * along only in case it is restored, and a figure that counted it would
 * disagree with the Products screen, whose All view never shows the bin.
 * Drafts and every other live status count, named beside the name.
 *
 * The pass is remembered for the request; pass true to forget it, which a
 * test or a long import does after changing what products carry.
 *
 * @param bool $forget Drop the remembered pass and return empty.
 * @return array<string,array<int,true>> set id => [ product id => true ].
 */
function addon_boss_option_set_usage_map( bool $forget = false ): array {
	static $map = null;
	if ( $forget ) {
		$map = null;
		return array();
	}
	if ( null !== $map ) {
		return $map;
	}
	$map = array();
	global $wpdb;
	$bb_rows = $wpdb->get_results( // phpcs:ignore WordPress.DB.DirectDatabaseQuery.DirectQuery, WordPress.DB.DirectDatabaseQuery.NoCaching -- one prepared read per request over our own meta key; mapped in PHP and static-cached.
		$wpdb->prepare(
			"SELECT pm.post_id, pm.meta_value
			 FROM {$wpdb->postmeta} pm
			 INNER JOIN {$wpdb->posts} p ON p.ID = pm.post_id
			 WHERE pm.meta_key = %s AND p.post_status NOT IN ( 'trash', 'auto-draft' )",
			ADDON_BOSS_PRODUCT_OPTIONS_META
		)
	);
	foreach ( (array) $bb_rows as $bb_meta ) {
		$bb_cfg = maybe_unserialize( $bb_meta->meta_value );
		if ( ! is_array( $bb_cfg ) ) {
			continue;
		}
		foreach ( addon_boss_flatten_option_config( $bb_cfg ) as $bb_row ) {
			$bb_sid = (string) ( $bb_row['set'] ?? '' );
			if ( '' !== $bb_sid ) {
				$map[ $bb_sid ][ (int) $bb_meta->post_id ] = true; // once per product, however many rows.
			}
		}
	}
	return $map;
}

/**
 * How many products attach this set. See the map above for what counts.
 *
 * @param string $set_id The set.
 * @return int
 */
function addon_boss_option_set_usage( string $set_id ): int {
	return count( addon_boss_option_set_usage_map()[ $set_id ] ?? array() );
}

/**
 * Which options a bundle includes for the shopper, asked of BundleBoss
 * through the shared seam (addon_boss_fixed_answers_in_use): set id =>
 * option key => id => name. Deleting one of those options leaves the
 * products there waiting until the shop chooses another, so the set's editor
 * and the library say so first. Once per request, like the usage map; with
 * nobody answering, nothing is included.
 *
 * @param bool $forget Drop the cached answer (tests, after a change).
 */
function addon_boss_fixed_answers_in_use_map( bool $forget = false ): array {
	static $map = null;
	if ( $forget ) {
		$map = null;
		return array();
	}
	if ( null === $map ) {
		$map = apply_filters( 'addon_boss_fixed_answers_in_use', array() );
		$map = is_array( $map ) ? $map : array();
		// BundleBoss 6.2.0 and older answer only the name this seam had before,
		// which carries BundleBoss's prefix, and a hook fired under another
		// plugin's prefix is one AddOnBoss no longer fires. So their answer is
		// asked for directly. A BundleBoss that answers the name above is not
		// asked twice.
		if ( function_exists( 'bundle_boss_fixed_answers_in_use' ) && false === has_filter( 'addon_boss_fixed_answers_in_use', 'bundle_boss_fixed_answers_in_use' ) ) {
			$older = bundle_boss_fixed_answers_in_use( $map );
			$map   = is_array( $older ) ? $older : $map;
		}
	}
	return $map;
}

/**
 * The names of the bundles that include an option, quoted, five at most.
 *
 * @param array $places Id => name.
 */
function addon_boss_included_in_names( array $places ): string {
	$names = array();
	foreach ( $places as $name ) {
		/* translators: %s: the name of a bundle */
		$names[] = sprintf( __( '&#8220;%s&#8221;', 'addon-boss' ), sanitize_text_field( (string) $name ) );
	}
	$more  = count( $names ) - 5;
	$names = implode( ', ', array_slice( $names, 0, 5 ) );
	if ( $more > 0 ) {
		/* translators: 1: the first ones, named, 2: how many more there are */
		$names = sprintf( _n( '%1$s and %2$d more', '%1$s and %2$d more', $more, 'addon-boss' ), $names, $more );
	}
	return $names;
}

/**
 * What removing one option costs, asked before it goes. Empty when nothing
 * includes it.
 *
 * @param array $places Id => name of each bundle that includes the option.
 */
function addon_boss_option_removal_warning( array $places ): string {
	if ( ! $places ) {
		return '';
	}
	return sprintf(
		/* translators: %s: bundle names, e.g. "Starter kit", "Team kit" */
		_n(
			'Remove this option? The bundle %s includes it. Products there that use it are not available until you choose another option in that bundle.',
			'Remove this option? The bundles %s include it. Products there that use it are not available until you choose another option in each bundle.',
			count( $places ),
			'addon-boss'
		),
		addon_boss_included_in_names( $places )
	);
}

/**
 * What deleting a whole set costs the bundles that include one of its
 * options. Empty when none does. Only options the set still has count: an
 * option deleted earlier has already left its products waiting.
 *
 * @param string $set_id The set.
 * @param array  $set    The stored set.
 */
function addon_boss_set_removal_warning( string $set_id, array $set ): string {
	$keys = array();
	foreach ( (array) ( $set['options'] ?? array() ) as $opt ) {
		$keys[ (string) ( $opt['key'] ?? '' ) ] = true;
	}
	$places = array();
	foreach ( (array) ( addon_boss_fixed_answers_in_use_map()[ $set_id ] ?? array() ) as $key => $ids ) {
		if ( isset( $keys[ (string) $key ] ) ) {
			$places += (array) $ids;
		}
	}
	if ( ! $places ) {
		return '';
	}
	return sprintf(
		/* translators: %s: bundle names, e.g. "Starter kit", "Team kit" */
		_n(
			'The bundle %s includes an option from it. Products there that use it are not available until you update that bundle.',
			'The bundles %s include options from it. Products there that use them are not available until you update each bundle.',
			count( $places ),
			'addon-boss'
		),
		addon_boss_included_in_names( $places )
	);
}

/**
 * WHICH products attach this set: the same truth as the count, as ids.
 *
 * @param string $set_id The set.
 * @return int[]
 */
function addon_boss_option_set_used_on( string $set_id ): array {
	return array_keys( addon_boss_option_set_usage_map()[ $set_id ] ?? array() );
}

/**
 * The list behind "Used on N products": a handful of named, linked products
 * for the card's own fold, the true total, and the route to the whole list
 * on the Products screen.
 *
 * @param string $set_id The set.
 * @param int    $cap    How many named products the fold shows.
 * @return array
 */
function addon_boss_set_products_payload( string $set_id, int $cap = 20, string $q = '', int $page = 1 ): array {
	$bb_ids = addon_boss_option_set_used_on( $set_id );

	// One primary-key read for the names and statuses, then everything in
	// PHP: the ids ARE the truth the figure counted, and WP_Query's default
	// status rules would quietly drop the drafts the count includes.
	$bb_rows = array();
	if ( $bb_ids ) {
		global $wpdb;
		$bb_in   = implode( ',', array_map( 'intval', $bb_ids ) );
		$bb_rows = (array) $wpdb->get_results( // phpcs:ignore WordPress.DB.DirectDatabaseQuery.DirectQuery, WordPress.DB.DirectDatabaseQuery.NoCaching, WordPress.DB.PreparedSQL.InterpolatedNotPrepared -- a primary-key IN over our own integer ids.
			"SELECT ID, post_title, post_status FROM {$wpdb->posts} WHERE ID IN ( {$bb_in} )"
		);
	}
	usort(
		$bb_rows,
		static function ( $a, $b ) {
			return strcasecmp( (string) $a->post_title, (string) $b->post_title );
		}
	);

	$q = trim( $q );
	if ( '' !== $q ) {
		$bb_rows = array_values( array_filter(
			$bb_rows,
			static function ( $bb_row ) use ( $q ) {
				if ( function_exists( 'mb_stripos' ) ? false !== mb_stripos( (string) $bb_row->post_title, $q ) : false !== stripos( (string) $bb_row->post_title, $q ) ) {
					return true;
				}
				return ltrim( $q, '#' ) === (string) $bb_row->ID; // "#123" or "123" finds the product by id.
			}
		) );
	}

	$cap      = max( 1, $cap );
	$page     = max( 1, $page );
	$bb_found = count( $bb_rows );
	$bb_items = array();
	foreach ( array_slice( $bb_rows, ( $page - 1 ) * $cap, $cap ) as $bb_row ) {
		$bb_title = (string) $bb_row->post_title;
		if ( '' === $bb_title ) {
			$bb_title = '#' . (int) $bb_row->ID;
		}
		// A product the shop cannot sell right now says so beside its name,
		// in the status word core already translated.
		if ( 'publish' !== (string) $bb_row->post_status ) {
			$bb_obj = get_post_status_object( (string) $bb_row->post_status );
			if ( $bb_obj && ! empty( $bb_obj->label ) ) {
				$bb_title = sprintf( '%1$s (%2$s)', $bb_title, $bb_obj->label );
			}
		}
		$bb_url     = get_edit_post_link( (int) $bb_row->ID, 'raw' );
		$bb_items[] = array(
			'title' => $bb_title,
			'url'   => $bb_url ? $bb_url : admin_url( 'post.php?post=' . (int) $bb_row->ID . '&action=edit' ),
		);
	}
	return array(
		'items'     => $bb_items,
		'total'     => count( $bb_ids ),
		'found'     => $bb_found,
		'more'      => ( $page * $cap ) < $bb_found,
		'all_url'   => admin_url( 'edit.php?post_type=product&aob_set=' . rawurlencode( $set_id ) ),
		/* translators: %s: how many products carry the set. */
		'all_label' => sprintf( __( 'All %s in Products', 'addon-boss' ), number_format_i18n( count( $bb_ids ) ) ),
	);
}

add_action( 'wp_ajax_addon_boss_set_products', 'addon_boss_ajax_set_products' );
/** The list above, spoken over admin-ajax. */
function addon_boss_ajax_set_products(): void {
	if ( ! current_user_can( 'manage_woocommerce' ) ) {
		wp_send_json_error( 'forbidden', 403 );
	}
	check_ajax_referer( 'addon_boss_set_groups' );
	wp_send_json_success( addon_boss_set_products_payload(
		sanitize_text_field( wp_unslash( $_POST['set'] ?? '' ) ),
		20,
		sanitize_text_field( wp_unslash( $_POST['q'] ?? '' ) ),
		max( 1, absint( $_POST['page'] ?? 1 ) )
	) );
}

add_action( 'pre_get_posts', 'addon_boss_products_by_set_query' );
/**
 * The Products screen, filtered to one set: exactly the ids the usage figure
 * counted, so the count and the screen can never disagree.
 *
 * @param WP_Query $query The list's main query.
 */
function addon_boss_products_by_set_query( $query ): void {
	if ( ! is_admin() || wp_doing_ajax() || ! $query->is_main_query() ) {
		return;
	}
	if ( 'product' !== (string) $query->get( 'post_type' ) ) {
		return;
	}
	$bb_set = isset( $_GET['aob_set'] ) ? sanitize_text_field( wp_unslash( $_GET['aob_set'] ) ) : ''; // phpcs:ignore WordPress.Security.NonceVerification.Recommended -- a read-only list filter, like any list-table filter link.
	if ( '' === $bb_set ) {
		return;
	}
	$bb_ids = addon_boss_option_set_used_on( $bb_set );
	$query->set( 'post__in', $bb_ids ? $bb_ids : array( 0 ) );
}

add_action( 'admin_notices', 'addon_boss_products_by_set_notice' );
/** The filtered Products screen says which set it is showing, and the ways back. */
function addon_boss_products_by_set_notice(): void {
	$bb_screen = function_exists( 'get_current_screen' ) ? get_current_screen() : null;
	if ( ! $bb_screen || 'edit-product' !== $bb_screen->id ) {
		return;
	}
	$bb_set = isset( $_GET['aob_set'] ) ? sanitize_text_field( wp_unslash( $_GET['aob_set'] ) ) : ''; // phpcs:ignore WordPress.Security.NonceVerification.Recommended -- names the read-only filter already applied above.
	if ( '' === $bb_set ) {
		return;
	}
	$bb_sets = addon_boss_option_sets();
	$bb_name = (string) ( $bb_sets[ $bb_set ]['name'] ?? $bb_set );
	echo '<div class="notice notice-info"><p>'
		. sprintf(
			/* translators: %s: the option set's name. */
			esc_html__( 'Products carrying %s.', 'addon-boss' ),
			'<strong>' . esc_html( $bb_name ) . '</strong>'
		)
		. ' <a href="' . esc_url( admin_url( 'edit.php?post_type=product' ) ) . '">' . esc_html__( 'Show every product', 'addon-boss' ) . '</a>'
		. ' &middot; <a href="' . esc_url( admin_url( 'admin.php?page=addon-boss-option-sets' ) ) . '">' . esc_html__( 'Back to Option sets', 'addon-boss' ) . '</a>'
		. '</p></div>';
}

/**
 * A badge's words as plain text, for a title or an aria-label: the figure on
 * screen, once. A VAT-toggle plugin writes its badge as a pair (the price
 * without VAT and with it, one of them hidden), and stripping the markup ran
 * both together: "Front print +£5.00£6.00" in the tooltip and the screen
 * reader. The hidden side of the pair is dropped first.
 *
 * @param string $html The badge's markup.
 * @return string Its visible words.
 */
function addon_boss_badge_text( string $html ): string {
	if ( false === strpos( $html, 'wts-inactive' ) || ! class_exists( 'DOMDocument' ) ) {
		return trim( wp_strip_all_tags( $html ) );
	}
	$doc  = new DOMDocument();
	$prev = libxml_use_internal_errors( true );
	// A charset meta, not an XML prolog: the prolog's closing mark reads as the end of PHP to
	// the inline-script gate that scans this file.
	$doc->loadHTML( '<meta http-equiv="Content-Type" content="text/html; charset=utf-8"><div>' . $html . '</div>', LIBXML_HTML_NODEFDTD );
	libxml_clear_errors();
	libxml_use_internal_errors( $prev );
	$xp = new DOMXPath( $doc );
	foreach ( iterator_to_array( $xp->query( '//*[contains(concat(" ", normalize-space(@class), " "), " wts-inactive ")]' ) ) as $off ) {
		$off->parentNode->removeChild( $off );
	}
	return trim( html_entity_decode( (string) $doc->textContent, ENT_QUOTES, 'UTF-8' ) );
}

/**
 * A price string WITHOUT the wc_price filters, so a VAT-toggle plugin cannot
 * wrap it in its dual-basis markup. Mirrors wc_price symbol placement and
 * separators; for admin previews and anywhere one plain figure is wanted.
 *
 * 🔴 Originally built for the admin preview chips; the STOREFRONT kept
 * stripping filtered wc_price output, so on David's shop every measured
 * size chip printed two numbers side by side (his acrylic panel, 2 Sept).
 * Every wp_strip_all_tags( wc_price( … ) ) in the engine now routes here.
 */
function addon_boss_plain_price( float $amount ): string {
	$formatted = number_format(
		$amount,
		wc_get_price_decimals(),
		wc_get_price_decimal_separator(),
		wc_get_price_thousand_separator()
	);
	return sprintf( get_woocommerce_price_format(), get_woocommerce_currency_symbol(), $formatted );
}

/** One preview chip (shared by the list cards and the product panel). */
function addon_boss_option_preview_chip( array $opt, string $class = '' ): string {
	$dot = $opt['swatch']
		? '<span class="bb-opt-dot" style="background:' . esc_attr( addon_boss_swatch_css( $opt ) ) . '"></span>'
		: '';
	// wc_price runs through a VAT-toggle plugin filter that, in wp-admin, wraps
	// it in dual-basis markup WITHOUT the CSS that hides the off-side, so the two
	// figures run together. The admin preview only needs the plain surcharge, so
	// bypass wc_price there; keep it on the front end where the toggle can switch.
	$delta = (float) $opt['delta'];
	if ( 0.0 === $delta ) {
		$bump = '';
	} elseif ( is_admin() ) {
		// esc_html, not a bare concatenation. addon_boss_plain_price() builds its
		// string from get_woocommerce_price_format() and
		// get_woocommerce_currency_symbol(), and both of those are filter values,
		// so anything hooking them lands here. Nothing between that helper and
		// this echo escaped it, and "escaped inside" is what the comment on the
		// two call sites claimed. It was not.
		// aob-money-raw: the merchant's own configured surcharge, on their own
		// screen. An admin preview states what was typed in, not what a shopper
		// would be charged after tax.
		$bump = ' <b>' . esc_html( ( $delta > 0 ? '+' : '-' ) . addon_boss_plain_price( abs( $delta ) ) ) . '</b>';
	} else {
		// The storefront twin, where it IS what a shopper pays, so it converts.
		$bump = ' <b>' . wp_kses_post( addon_boss_money( $delta, null, array( 'sign' => true ) ) ) . '</b>';
	}
	$cls = 'bb-opt-chip' . ( $bump ? ' has-bump' : '' ) . ( '' !== $class ? ' ' . $class : '' );
	return '<span class="' . esc_attr( $cls ) . '">' . $dot . esc_html( $opt['label'] ) . $bump . '</span>';
}

/**
 * A whole preview row: the first $cap chips visible, the rest behind a
 * clickable "+N" that expands the row in place (and collapses it again).
 * With $cap or fewer options there is no button and nothing to expand.
 */
function addon_boss_option_preview_row( array $options, int $cap, array $need = array() ): string {
	$html = '';
	foreach ( array_values( $options ) as $i => $opt ) {
		// $need: the labels addon_boss_swatch_unmatched() found, marked so a
		// merchant scanning the list sees which choice wants a colour.
		$bb_cls = trim( ( $i >= $cap ? 'bb-chip-overflow' : '' ) . ( in_array( trim( (string) ( $opt['label'] ?? '' ) ), $need, true ) ? ' bb-chip-need' : '' ) );
		$html  .= addon_boss_option_preview_chip( $opt, $bb_cls );
	}
	$hidden = count( $options ) - $cap;
	if ( $hidden > 0 ) {
		$more  = sprintf( '+%d', $hidden );
		$html .= '<button type="button" class="bb-opt-chip bb-opt-more" aria-expanded="false"'
			. ' data-more-label="' . esc_attr( $more ) . '"'
			. ' data-less-label="' . esc_attr__( 'Show fewer', 'addon-boss' ) . '">'
			. esc_html( $more ) . '</button>';
	}
	return $html;
}

/** The BundleBoss page header (brand square + crumb + action). */
function addon_boss_optsets_header( string $crumb, string $action_html = '' ): void {
	echo '<div class="bb-optsets-head">';
	// The host's own mark, when it has one. An <img> src only: the seam hands
	// over a URL rather than markup, so a host can never post HTML into this
	// header. Empty leaves the name on its own exactly as before, which is what
	// a host without a mark still gets.
	$bb_mark = esc_url_raw( (string) apply_filters( 'addon_boss_engine_brand_mark', '' ) );
	echo '<span class="bb-brandmark">';
	if ( '' !== $bb_mark ) {
		echo '<img class="bb-brand-mark" src="' . esc_url( $bb_mark ) . '" alt="" width="18" height="18">';
	}
	echo esc_html( (string) apply_filters( 'addon_boss_engine_brand_name', '' ) ) . '</span>';
	echo '<span class="bb-crumb">/ ' . esc_html( $crumb ) . '</span>';
	// kses rather than a promise. Every caller builds this from esc_url and
	// esc_html already, but "the callers escape it" is an assertion nobody can
	// verify at this line. wp_kses_post allows the links and buttons the header
	// actually uses and drops anything else.
	echo '<span class="bb-head-spacer"></span>' . wp_kses_post( $action_html ) . '</div>';
}

/** One set card, extracted so the grouped list (and any later view) share it. */
function addon_boss_render_option_set_card( string $id, array $set ): void {
    $edit   = admin_url( 'admin.php?page=addon-boss-option-sets&set=' . rawurlencode( $id ) );
    $delete = wp_nonce_url( admin_url( 'admin-post.php?action=addon_boss_delete_option_set_form&set=' . rawurlencode( $id ) ), 'addon_boss_delete_option_set' );
    $dupe   = wp_nonce_url( admin_url( 'admin-post.php?action=addon_boss_duplicate_option_set_form&set=' . rawurlencode( $id ) ), 'addon_boss_duplicate_option_set' );
    $usage  = addon_boss_option_set_usage( $id );

    // A lowercase haystack for the client-side search: the set name + every label.
    $hay = strtolower( (string) ( $set['name'] ?? '' ) );
    foreach ( (array) ( $set['options'] ?? array() ) as $hopt ) {
        $hay .= ' ' . strtolower( (string) ( $hopt['label'] ?? '' ) );
    }

    echo '<div class="bb-setcard" draggable="true" data-set-id="' . esc_attr( $id ) . '" data-search="' . esc_attr( $hay ) . '">';
    echo '<button type="button" class="bb-card-menu-btn" aria-haspopup="true" aria-expanded="false" aria-label="' . esc_attr__( 'File this set', 'addon-boss' ) . '">&#8943;</button>';
    echo '<h3><a href="' . esc_url( $edit ) . '">' . esc_html( $set['name'] ?: $id ) . '</a></h3>';
    // Colours this set is missing, where they cost it its dots: said on the
    // card and marked on the chips, so the list answers "which sets?"
    // without opening each one.
    $bb_need      = function_exists( 'addon_boss_swatch_unmatched' ) ? addon_boss_swatch_unmatched( $set ) : array();
    $bb_need_meta = $bb_need
        ? ' &middot; <span class="bb-sw-need-meta">' . esc_html(
            /* translators: %d: how many choices in the set have no colour */
            sprintf( _n( '%d colour to pick', '%d colours to pick', count( $bb_need ), 'addon-boss' ), count( $bb_need ) )
        ) . '</span>'
        : '';
    if ( $usage ) {
        // The figure is a door: it opens the products themselves, in the
        // same house dialog the Move and Copy pickers use, so two products
        // and three thousand read the same way.
        echo '<div class="bb-setmeta"><button type="button" class="bb-setuse" aria-haspopup="dialog">' . esc_html(
            /* translators: %d: number of products */
            sprintf( _n( 'Used on %d product', 'Used on %d products', $usage, 'addon-boss' ), $usage )
        ) . '</button>' . $bb_need_meta . '</div>'; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- $bb_need_meta is escaped where it is built.
    } else {
        echo '<div class="bb-setmeta">' . esc_html__( 'Not attached to a product yet', 'addon-boss' ) . $bb_need_meta . '</div>'; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- $bb_need_meta is escaped where it is built.
    }
    echo '<div class="bb-chiprow">';
    // Stored data is historical fact: an older build wrote table sets with no
    // options key at all, and one such set took this whole screen down with a
    // TypeError. Every set must render, malformed or not, or the merchant has
    // no way to open it and put it right.
    echo wp_kses( addon_boss_option_preview_row( (array) ( $set['options'] ?? array() ), 8, $bb_need ), addon_boss_kses_allowed() );
    echo '</div>';
    echo '<div class="bb-setfoot">';
    echo '<button type="button" class="button bb-cta bb-bulk-toggle" aria-expanded="false">' . esc_html__( 'Attach to products', 'addon-boss' ) . '</button>';
    echo '<span class="bb-setacts">';
    echo '<a class="bb-edit" href="' . esc_url( $edit ) . '">' . esc_html__( 'Edit', 'addon-boss' ) . '</a>';
    echo '<a class="bb-dupe" href="' . esc_url( $dupe ) . '">' . esc_html__( 'Duplicate', 'addon-boss' ) . '</a>';
    // A bundle that includes one of the set's options is named before it goes.
    $bb_del = trim( __( 'Delete this set? Products stop offering these options. Existing carts and orders are not affected.', 'addon-boss' ) . ' ' . addon_boss_set_removal_warning( $id, $set ) );
    echo '<a class="bb-del" href="' . esc_url( $delete ) . '" onclick="return confirm(\'' . esc_js( $bb_del ) . '\')">' . esc_html__( 'Delete', 'addon-boss' ) . '</a>';
    echo '</span>';
    echo '</div>';
    echo '<form class="bb-bulkrow" method="post" action="' . esc_url( admin_url( 'admin-post.php' ) ) . '" hidden>';
    echo '<input type="hidden" name="action" value="addon_boss_bulk_attach_set">';
    echo '<input type="hidden" name="set" value="' . esc_attr( $id ) . '">';
    wp_nonce_field( 'addon_boss_bulk_attach_set' );
    echo '<span>' . esc_html__( 'Every product in', 'addon-boss' ) . '</span>';
    wp_dropdown_categories(
        array(
            'taxonomy'          => 'product_cat',
            'name'              => 'bulk_category',
            'hide_empty'        => true,
            'hierarchical'      => true,
            'show_option_none'  => __( 'Choose a category…', 'addon-boss' ),
            'option_none_value' => '',
        )
    );
    echo '<button type="submit" class="button bb-bulk-go">' . esc_html__( 'Attach', 'addon-boss' ) . '</button>';
    // The panel offers the category route only, so the one-product case needs
    // its signpost RIGHT HERE, always visible, in the words the checklist
    // teaches. Without it this panel is a dead door for a store wanting the
    // set on a single product (or holding no categories at all).
    echo '<span class="bb-bulk-single">' . esc_html__( 'To attach to a single product, open its edit screen and use the Product options tab.', 'addon-boss' ) . '</span>';
    echo '</form>';
    echo '</div>';
}

/** One collapsible group section (a drop target) on the option-sets list. */
/**
 * Where one set came from: its stored source, offered to the plugin that wrote
 * it. A supplier integration stamps 'source' when it writes a set and can also
 * answer here for sets it wrote before it stamped them. A set the merchant
 * built answers '', and '' is deliberately never given a word of its own on
 * the page: the survey behind this screen found no shipping product that
 * badges the user's own records, so absence IS the marking.
 *
 * @param string $id  The set's id.
 * @param array  $set The stored set.
 * @return string The source's display name, or '' for the merchant's own.
 */
function addon_boss_option_set_source( string $id, array $set ): string {
	return sanitize_text_field( (string) apply_filters( 'addon_boss_option_set_source', (string) ( $set['source'] ?? '' ), $id, $set ) );
}

/**
 * The library, shaped for one page of the list: searched, filtered by source,
 * ordered (registry first, then unregistered names, Ungrouped last) and
 * sliced. Pure on its inputs so the shape is testable without a screen.
 *
 * Search matches a group's name, a set's name, or an option label inside a
 * set — the same reach the search box promises. The source buckets are
 * counted AFTER the search and BEFORE the source filter, so each choice in
 * the dropdown says what picking it would show under the current search: a
 * filter narrows a search here, it never resets one.
 *
 * @param array $sets     The whole library, id => set.
 * @param array $registry The ordered group names.
 * @param array $args     s, source ('' | 'none' | a source name), paged, per_page.
 * @return array rows (one per group on this page), total (groups), set_count
 *               (the sets in them, every page), pages, paged,
 *               buckets (source => group count, post-search), searched (group
 *               count post-search), group_names (every named group, unfiltered).
 */
function addon_boss_option_library_view( array $sets, array $registry, array $args ): array {
	$bb_q      = strtolower( trim( (string) ( $args['s'] ?? '' ) ) );
	$bb_source = (string) ( $args['source'] ?? '' );
	$bb_tags   = array_values( array_filter( array_map( 'sanitize_key', (array) ( $args['tags'] ?? array() ) ) ) );
	$bb_paged  = max( 1, (int) ( $args['paged'] ?? 1 ) );
	$bb_pp     = max( 1, (int) ( $args['per_page'] ?? 25 ) );
	// "Colours to pick": only the sets addon_boss_swatch_unmatched() names,
	// and in their groups only those sets, so Ungrouped's three hundred come
	// down to the one that needs a hand.
	$bb_need_on = ! empty( $args['colours'] ) && function_exists( 'addon_boss_swatch_unmatched' );

	$bb_by   = array();
	$bb_need = 0;
	foreach ( $sets as $bb_id => $bb_set ) {
		$bb_by[ (string) ( $bb_set['group'] ?? '' ) ][ (string) $bb_id ] = $bb_set;
		// The whole library's count, whatever else narrows the list: it is
		// what the filter's own pill says.
		if ( function_exists( 'addon_boss_swatch_unmatched' ) && addon_boss_swatch_unmatched( (array) $bb_set ) ) {
			++$bb_need;
		}
	}

	// Registry order first, then names in use the registry never learned,
	// then Ungrouped last — the order the page has always drawn.
	$bb_names = array();
	foreach ( $registry as $bb_n ) {
		$bb_n = (string) $bb_n;
		if ( '' !== $bb_n ) {
			$bb_names[ $bb_n ] = true;
		}
	}
	foreach ( array_keys( $bb_by ) as $bb_n ) {
		if ( '' !== $bb_n ) {
			$bb_names[ (string) $bb_n ] = true;
		}
	}
	$bb_group_names = array_keys( $bb_names );

	$bb_rows = array();
	foreach ( array_merge( $bb_group_names, array( '' ) ) as $bb_name ) {
		$bb_gsets = $bb_by[ $bb_name ] ?? array();
		if ( $bb_need_on ) {
			$bb_gsets = array_filter( $bb_gsets, static function ( $bb_s ) {
				return (bool) addon_boss_swatch_unmatched( (array) $bb_s );
			} );
			if ( ! $bb_gsets ) {
				continue;
			}
		}
		if ( '' === $bb_name && ! $bb_gsets ) {
			continue; // an empty Ungrouped says nothing worth a row.
		}
		// The group as a whole, for its source badge: a search narrows what
		// the row lists, never what the group is.
		$bb_whole = $bb_gsets;
		// The search: the group's name keeps the whole group; otherwise the
		// group keeps only the sets that match, by name or by a choice inside,
		// as "Colours to pick" does. A match in a 290-set Ungrouped is the one
		// set, not the 290 around it.
		if ( '' !== $bb_q && false === strpos( strtolower( $bb_name ), $bb_q ) ) {
			$bb_gsets = array_filter( $bb_gsets, static function ( $bb_s ) use ( $bb_q ) {
				$bb_hay = strtolower( (string) ( $bb_s['name'] ?? '' ) );
				foreach ( (array) ( $bb_s['options'] ?? array() ) as $bb_o ) {
					$bb_hay .= ' ' . strtolower( (string) ( $bb_o['label'] ?? '' ) );
				}
				return false !== strpos( $bb_hay, $bb_q );
			} );
			if ( ! $bb_gsets ) {
				continue;
			}
		}
		// The group's source: unanimous and non-empty, or nothing. A group
		// mixing a supplier's sets with the merchant's own is not the
		// supplier's to badge.
		$bb_src = null;
		foreach ( $bb_whole as $bb_sid => $bb_s ) {
			$bb_one = addon_boss_option_set_source( (string) $bb_sid, (array) $bb_s );
			if ( null === $bb_src ) {
				$bb_src = $bb_one;
			} elseif ( $bb_src !== $bb_one ) {
				$bb_src = '';
				break;
			}
		}
		$bb_src     = (string) ( $bb_src ?? '' );
		$bb_preview = array();
		foreach ( $bb_gsets as $bb_s ) {
			$bb_preview[] = (string) ( $bb_s['name'] ?? '' );
		}
		$bb_rows[] = array(
			'slug'      => $bb_name,
			'label'     => '' === $bb_name ? __( 'Ungrouped', 'addon-boss' ) : $bb_name,
			'sets'      => $bb_gsets,
			'ungrouped' => '' === $bb_name,
			'source'    => $bb_src,
			'preview'   => implode( ' · ', array_filter( $bb_preview ) ),
		);
	}

	// Buckets from the searched rows, then the source filter narrows.
	$bb_buckets = array();
	foreach ( $bb_rows as $bb_r ) {
		$bb_key                = '' === $bb_r['source'] ? 'none' : $bb_r['source'];
		$bb_buckets[ $bb_key ] = ( $bb_buckets[ $bb_key ] ?? 0 ) + 1;
	}
	// Tags narrow after the source does, and MORE tags narrow further: two
	// chosen means the groups wearing both, never the groups wearing
	// either. Discontinued and Schools together is the question a
	// merchant actually has (his agreement, 6 September).
	if ( $bb_tags && addon_boss_library_tags_on() ) {
		$bb_keep = addon_boss_groups_tagged( $bb_tags );
		$bb_rows = array_values( array_filter( $bb_rows, static function ( $bb_r ) use ( $bb_keep ) {
			return in_array( (string) $bb_r['slug'], $bb_keep, true );
		} ) );
	}
	$bb_searched = count( $bb_rows );
	if ( '' !== $bb_source ) {
		$bb_rows = array_values( array_filter( $bb_rows, static function ( $bb_r ) use ( $bb_source ) {
			return 'none' === $bb_source ? '' === $bb_r['source'] : $bb_r['source'] === $bb_source;
		} ) );
	}

	$bb_total = count( $bb_rows );
	// The sets the list holds, across every page: what the count under it
	// says. It counted groups, so three sets in Ungrouped read "1 item"
	// (blinds tester, 18 Oct 2026). The pages still turn by group.
	$bb_set_n = (int) array_sum( array_map( static function ( $bb_r ) { return count( (array) $bb_r['sets'] ); }, $bb_rows ) );
	$bb_pages = max( 1, (int) ceil( $bb_total / $bb_pp ) );
	$bb_paged = min( $bb_paged, $bb_pages );
	$bb_rows  = array_slice( $bb_rows, ( $bb_paged - 1 ) * $bb_pp, $bb_pp );
	foreach ( $bb_rows as $bb_i => $bb_r ) {
		// Its place in the WHOLE filtered list, so assistive tech says
		// "7 of 100" and never "7 of 25".
		$bb_rows[ $bb_i ]['pos'] = ( $bb_paged - 1 ) * $bb_pp + $bb_i + 1;
	}

	return array(
		'rows'        => $bb_rows,
		'total'       => $bb_total,
		'set_count'   => $bb_set_n,
		'pages'       => $bb_pages,
		'paged'       => $bb_paged,
		'buckets'     => $bb_buckets,
		'searched'    => $bb_searched,
		'group_names' => $bb_group_names,
		'colour_need' => $bb_need,
		'searching'   => '' !== $bb_q,
	);
}

/**
 * The pill that narrows the list to sets with a colour to pick, or nothing
 * when no set has one and the filter is off. Pressed again it lets go.
 *
 * @param int      $count How many sets need a colour, across the library.
 * @param bool     $on    Whether the list is narrowed to them now.
 * @param callable $url   The page's URL builder, carrying every other filter.
 */
function addon_boss_colour_need_pill( int $count, bool $on, callable $url ): string {
	if ( ! $count && ! $on ) {
		return '';
	}
	$href  = $on ? remove_query_arg( 'colours', $url( array( 'paged' => 1 ) ) ) : $url( array( 'colours' => 'todo', 'paged' => 1 ) );
	$label = sprintf(
		/* translators: %d: how many option sets have a colour the merchant still needs to pick */
		_n( '%d set has a colour to pick', '%d sets have a colour to pick', $count, 'addon-boss' ),
		$count
	);
	return '<div class="bb-sw-need-row"><a class="bb-sw-need-pill' . ( $on ? ' is-on' : '' ) . '" href="' . esc_url( $href ) . '" aria-pressed="' . ( $on ? 'true' : 'false' ) . '">! ' . esc_html( $label ) . '</a></div>';
}

/**
 * Reorder one set among its group's sets, in the flat store. Every other
 * group's sets keep their exact slots: the group's slots are refilled in the
 * new order and nothing else is touched.
 *
 * @param array  $sets     The whole library, id => set.
 * @param string $set_id   The set being placed (already in $group).
 * @param string $group    The group whose order is being written.
 * @param int    $position Target index among the group's sets, 0-based, clamped.
 * @return array The library, reordered.
 */
function addon_boss_reorder_set_in_group( array $sets, string $set_id, string $group, int $position ): array {
	$bb_ids = array();
	foreach ( $sets as $bb_id => $bb_s ) {
		if ( (string) ( $bb_s['group'] ?? '' ) === $group ) {
			$bb_ids[] = (string) $bb_id;
		}
	}
	if ( ! in_array( $set_id, $bb_ids, true ) ) {
		return $sets;
	}
	$bb_ids   = array_values( array_diff( $bb_ids, array( $set_id ) ) );
	$position = max( 0, min( $position, count( $bb_ids ) ) );
	array_splice( $bb_ids, $position, 0, array( $set_id ) );

	$bb_out = array();
	foreach ( $sets as $bb_id => $bb_s ) {
		if ( (string) ( $bb_s['group'] ?? '' ) === $group ) {
			$bb_next            = array_shift( $bb_ids );
			$bb_out[ $bb_next ] = $sets[ $bb_next ];
		} else {
			$bb_out[ $bb_id ] = $bb_s;
		}
	}
	return $bb_out;
}

/**
 * Move ONE set into a group (or out, with ''), optionally to a position in
 * it. This names exactly what changed, which is what lets the list paginate:
 * the old whole-picture save read every card on the page, and on a paged list
 * the page no longer holds every card.
 *
 * @param string   $set_id   The set to move.
 * @param string   $group    Destination group name, '' for Ungrouped.
 * @param int|null $position Optional 0-based position among the group's sets.
 * @return array|WP_Error joined-offer rows (see the group save), or the refusal.
 */
function addon_boss_move_set_apply( string $set_id, string $group, ?int $position = null ) {
	$bb_was  = '';
	$bb_sets = addon_boss_option_sets_change(
		static function ( array $bb_sets ) use ( $set_id, $group, $position, &$bb_was ) {
			if ( ! isset( $bb_sets[ $set_id ] ) ) {
				return new WP_Error( 'bundle_boss', __( 'That option set no longer exists.', 'addon-boss' ) );
			}
			$bb_was                      = (string) ( $bb_sets[ $set_id ]['group'] ?? '' );
			$bb_sets[ $set_id ]['group'] = $group;
			if ( '' !== $group ) {
				$bb_reg = addon_boss_option_set_groups();
				if ( ! in_array( $group, $bb_reg, true ) ) {
					$bb_reg[] = $group;
					update_option( ADDON_BOSS_OPTION_SET_GROUPS_STORE, $bb_reg, false );
				}
			}
			if ( null !== $position ) {
				$bb_sets = addon_boss_reorder_set_in_group( $bb_sets, $set_id, $group, $position );
			}
			return $bb_sets;
		}
	);
	if ( is_wp_error( $bb_sets ) ) {
		return $bb_sets;
	}

	// A set that just JOINED a group, on products already carrying that
	// group: the same offer the old save made, because it is the moment the
	// grouping exists to catch.
	$bb_joined = array();
	if ( '' !== $group && $group !== $bb_was ) {
		$bb_missing = addon_boss_products_missing_set( $group, $set_id );
		if ( $bb_missing ) {
			$bb_joined[] = array(
				'set'   => $set_id,
				'name'  => (string) ( $bb_sets[ $set_id ]['name'] ?? $set_id ),
				'group' => $group,
				'count' => count( $bb_missing ),
			);
		}
	}
	return $bb_joined;
}

add_action( 'wp_ajax_addon_boss_move_set', 'addon_boss_ajax_move_set' );
/** The move above, spoken over admin-ajax. */
function addon_boss_ajax_move_set(): void {
	if ( ! current_user_can( 'manage_woocommerce' ) ) {
		wp_send_json_error( 'forbidden', 403 );
	}
	check_ajax_referer( 'addon_boss_set_groups' );
	$bb_set   = sanitize_text_field( wp_unslash( $_POST['set'] ?? '' ) );
	$bb_group = sanitize_text_field( wp_unslash( $_POST['group'] ?? '' ) );
	$bb_pos   = isset( $_POST['position'] ) && '' !== $_POST['position'] ? max( 0, absint( $_POST['position'] ) ) : null;
	$bb_out   = addon_boss_move_set_apply( $bb_set, $bb_group, $bb_pos );
	if ( is_wp_error( $bb_out ) ) {
		wp_send_json_error( array( 'message' => $bb_out->get_error_message() ) );
	}
	wp_send_json_success( array( 'joined' => $bb_out ) );
}

/**
 * Copy ONE set into a group ('' for Ungrouped): a fresh id, the merchant's
 * own set from the moment it exists. The supplier stamp stays behind on the
 * original - a feed refreshes the set it wrote by id, and this id it has
 * never seen - so the badge never predicts a lock that will not come. A name
 * already taken in the destination gains "(copy)" after it; anywhere else
 * the name travels as is.
 *
 * @param string $set_id The set to copy.
 * @param string $group  Destination group name, '' for Ungrouped.
 * @return array|WP_Error the new set's id, name and group, or the refusal.
 */
function addon_boss_copy_set_apply( string $set_id, string $group ) {
	$bb_sets = addon_boss_option_sets();
	if ( ! isset( $bb_sets[ $set_id ] ) ) {
		return new WP_Error( 'bundle_boss', __( 'That option set no longer exists.', 'addon-boss' ) );
	}
	$bb_new           = $bb_sets[ $set_id ];
	$bb_new['group']  = $group;
	$bb_new['source'] = '';

	$bb_taken = array();
	foreach ( $bb_sets as $bb_s ) {
		if ( (string) ( $bb_s['group'] ?? '' ) === $group ) {
			$bb_taken[] = (string) ( $bb_s['name'] ?? '' );
		}
	}
	$bb_name = (string) ( $bb_new['name'] ?? $set_id );
	if ( in_array( $bb_name, $bb_taken, true ) ) {
		/* translators: %s: the name being copied. */
		$bb_try = sprintf( __( '%s (copy)', 'addon-boss' ), $bb_name );
		$bb_n   = 2;
		while ( in_array( $bb_try, $bb_taken, true ) ) {
			/* translators: 1: the name being copied, 2: which copy this is. */
			$bb_try = sprintf( __( '%1$s (copy %2$d)', 'addon-boss' ), $bb_name, $bb_n );
			++$bb_n;
		}
		$bb_name = $bb_try;
	}
	$bb_new['name'] = $bb_name;

	$bb_id = addon_boss_save_option_set( $bb_new, '' );
	if ( '' !== $group ) {
		$bb_reg = addon_boss_option_set_groups();
		if ( ! in_array( $group, $bb_reg, true ) ) {
			$bb_reg[] = $group;
			update_option( ADDON_BOSS_OPTION_SET_GROUPS_STORE, $bb_reg, false );
		}
	}
	return array( 'set' => $bb_id, 'name' => $bb_name, 'group' => $group );
}

add_action( 'wp_ajax_addon_boss_copy_set', 'addon_boss_ajax_copy_set' );
/** The copy above, spoken over admin-ajax. */
function addon_boss_ajax_copy_set(): void {
	if ( ! current_user_can( 'manage_woocommerce' ) ) {
		wp_send_json_error( 'forbidden', 403 );
	}
	check_ajax_referer( 'addon_boss_set_groups' );
	$bb_out = addon_boss_copy_set_apply(
		sanitize_text_field( wp_unslash( $_POST['set'] ?? '' ) ),
		sanitize_text_field( wp_unslash( $_POST['group'] ?? '' ) )
	);
	if ( is_wp_error( $bb_out ) ) {
		wp_send_json_error( array( 'message' => $bb_out->get_error_message() ) );
	}
	wp_send_json_success( $bb_out );
}

/**
 * A group's name, rewritten wherever a product row remembers arriving from
 * it. Bounded exactly like the missing-set lookup: this is an admin action on
 * an admin screen, not a migration.
 *
 * @param string $from The old name.
 * @param string $to   The new name.
 * @return int How many products were rewritten.
 */
function addon_boss_rename_group_on_products( string $from, string $to ): int {
	if ( '' === $from || '' === $to || $from === $to ) {
		return 0;
	}
	$bb_q = new WP_Query(
		array(
			'post_type'      => 'product',
			'post_status'    => array( 'publish', 'draft', 'private', 'pending' ),
			'posts_per_page' => 200,
			'fields'         => 'ids',
			'meta_key'       => ADDON_BOSS_PRODUCT_OPTIONS_META, // phpcs:ignore WordPress.DB.SlowDBQuery.slow_db_query_meta_key -- a bounded admin-only lookup, not a front-end query.
		)
	);
	$bb_walk = static function ( $rows ) use ( &$bb_walk, $from, $to, &$bb_changed ) {
		foreach ( (array) $rows as $bb_k => $bb_row ) {
			if ( ! is_array( $bb_row ) ) {
				continue;
			}
			if ( (string) ( $bb_row['from_group'] ?? '' ) === $from ) {
				$bb_row['from_group'] = $to;
				$bb_changed           = true;
			}
			foreach ( array( 'rows', 'children' ) as $bb_kids ) {
				if ( isset( $bb_row[ $bb_kids ] ) && is_array( $bb_row[ $bb_kids ] ) ) {
					$bb_row[ $bb_kids ] = $bb_walk( $bb_row[ $bb_kids ] );
				}
			}
			$rows[ $bb_k ] = $bb_row;
		}
		return $rows;
	};
	$bb_done = 0;
	foreach ( $bb_q->posts as $bb_pid ) {
		$bb_cfg = get_post_meta( (int) $bb_pid, ADDON_BOSS_PRODUCT_OPTIONS_META, true );
		if ( ! is_array( $bb_cfg ) ) {
			continue;
		}
		$bb_changed = false;
		$bb_cfg     = $bb_walk( $bb_cfg );
		if ( $bb_changed ) {
			update_post_meta( (int) $bb_pid, ADDON_BOSS_PRODUCT_OPTIONS_META, $bb_cfg );
			++$bb_done;
		}
	}
	return $bb_done;
}

/**
 * One group operation, named: create, rename, empty (its sets to Ungrouped,
 * the name kept), delete (the same, the name gone), duplicate (the group and
 * every set in it copied, "(copy)" names, fresh ids, filed right after the
 * original). Named operations are what survive pagination: each says exactly
 * what changed and touches nothing else.
 *
 * @param string $op   create|rename|empty|delete|duplicate.
 * @param array  $args group, and 'to' for rename.
 * @return array|WP_Error Details per op, or the refusal.
 */
function addon_boss_group_op_apply( string $op, array $args ) {
	$bb_group = trim( (string) ( $args['group'] ?? '' ) );
	if ( '' === $bb_group ) {
		return new WP_Error( 'bundle_boss', __( 'Name the group first.', 'addon-boss' ) );
	}
	$bb_reg  = addon_boss_option_set_groups();
	$bb_sets = addon_boss_option_sets();

	if ( 'create' === $op ) {
		if ( ! in_array( $bb_group, $bb_reg, true ) ) {
			$bb_reg[] = $bb_group;
			update_option( ADDON_BOSS_OPTION_SET_GROUPS_STORE, $bb_reg, false );
		}
		return array( 'group' => $bb_group );
	}

	if ( 'rename' === $op ) {
		$bb_to = trim( (string) ( $args['to'] ?? '' ) );
		if ( '' === $bb_to || $bb_to === $bb_group ) {
			return new WP_Error( 'bundle_boss', __( 'Give the group a new name.', 'addon-boss' ) );
		}
		$bb_out = array();
		foreach ( $bb_reg as $bb_n ) {
			$bb_n = ( $bb_n === $bb_group ) ? $bb_to : $bb_n;
			if ( ! in_array( $bb_n, $bb_out, true ) ) {
				$bb_out[] = $bb_n;
			}
		}
		update_option( ADDON_BOSS_OPTION_SET_GROUPS_STORE, $bb_out, false );
		addon_boss_option_sets_change(
			static function ( array $bb_sets ) use ( $bb_group, $bb_to ): array {
				foreach ( $bb_sets as $bb_id => $bb_s ) {
					if ( (string) ( $bb_s['group'] ?? '' ) === $bb_group ) {
						$bb_sets[ $bb_id ]['group'] = $bb_to;
					}
				}
				return $bb_sets;
			}
		);
		// Product rows remember the group they arrived with; the offer that
		// reads that memory must survive the rename.
		addon_boss_rename_group_on_products( $bb_group, $bb_to );
		return array( 'group' => $bb_to );
	}

	if ( 'empty' === $op || 'delete' === $op ) {
		// Deleting the sets as well is asked for, never assumed: it is the one
		// verb here that destroys work, and a set can be on any number of
		// products. Those products degrade silently rather than fatally (see
		// addon_boss_product_option_sets), so this is safe to offer, but the
		// screen has to say what it costs before anyone presses it.
		$bb_take = ( 'delete' === $op ) && ! empty( $args['sets'] );
		$bb_gone = 0;
		addon_boss_option_sets_change(
			static function ( array $bb_sets ) use ( $bb_group, $bb_take, &$bb_gone ): array {
				foreach ( $bb_sets as $bb_id => $bb_s ) {
					if ( (string) ( $bb_s['group'] ?? '' ) !== $bb_group ) {
						continue;
					}
					if ( $bb_take ) {
						unset( $bb_sets[ $bb_id ] );
						++$bb_gone;
					} else {
						$bb_sets[ $bb_id ]['group'] = '';
					}
				}
				return $bb_sets;
			}
		);
		if ( 'delete' === $op ) {
			update_option( ADDON_BOSS_OPTION_SET_GROUPS_STORE, array_values( array_diff( $bb_reg, array( $bb_group ) ) ), false );
		}
		if ( $bb_gone ) {
			// The usage figures counted sets that no longer exist.
			addon_boss_option_set_usage_map( true );
		}
		return array( 'group' => $bb_group, 'sets_deleted' => $bb_gone );
	}

	if ( 'duplicate' === $op ) {
		/* translators: %s: the name being copied. */
		$bb_copy = sprintf( __( '%s (copy)', 'addon-boss' ), $bb_group );
		$bb_n    = 2;
		while ( in_array( $bb_copy, $bb_reg, true ) ) {
			/* translators: 1: the name being copied, 2: which copy this is. */
			$bb_copy = sprintf( __( '%1$s (copy %2$d)', 'addon-boss' ), $bb_group, $bb_n );
			++$bb_n;
		}
		$bb_made = 0;
		foreach ( $bb_sets as $bb_id => $bb_s ) {
			if ( (string) ( $bb_s['group'] ?? '' ) !== $bb_group ) {
				continue;
			}
			$bb_new          = $bb_s;
			/* translators: %s: the name being copied. */
			$bb_new['name']  = sprintf( __( '%s (copy)', 'addon-boss' ), (string) ( $bb_s['name'] ?? $bb_id ) );
			$bb_new['group'] = $bb_copy;
			// A fresh id is a set the feed will never refresh: the supplier
			// stamp stays on the originals, so the badge keeps its promise.
			$bb_new['source'] = '';
			addon_boss_save_option_set( $bb_new, '' );
			++$bb_made;
		}
		if ( ! $bb_made ) {
			return new WP_Error( 'bundle_boss', __( 'That group has no sets to copy.', 'addon-boss' ) );
		}
		// Filed right after the original, so the copy lands where the eye is.
		$bb_reg = addon_boss_option_set_groups();
		$bb_reg = array_values( array_diff( $bb_reg, array( $bb_copy ) ) );
		$bb_at  = array_search( $bb_group, $bb_reg, true );
		array_splice( $bb_reg, false === $bb_at ? count( $bb_reg ) : $bb_at + 1, 0, array( $bb_copy ) );
		update_option( ADDON_BOSS_OPTION_SET_GROUPS_STORE, $bb_reg, false );
		return array( 'group' => $bb_copy, 'sets' => $bb_made );
	}

	return new WP_Error( 'bundle_boss', __( 'That is not a group action.', 'addon-boss' ) );
}

add_action( 'wp_ajax_addon_boss_group_op', 'addon_boss_ajax_group_op' );
/** The group operations above, spoken over admin-ajax. */
function addon_boss_ajax_group_op(): void {
	if ( ! current_user_can( 'manage_woocommerce' ) ) {
		wp_send_json_error( 'forbidden', 403 );
	}
	check_ajax_referer( 'addon_boss_set_groups' );
	$bb_op = sanitize_text_field( wp_unslash( $_POST['op'] ?? '' ) );

	// A selection does the same verbs, on each of its groups, in one trip. A
	// merchant clearing a supplier they dropped has two hundred of them, and
	// two hundred round trips is a screen that looks broken while it works.
	// phpcs:disable WordPress.Security.NonceVerification.Missing -- checked above.
	$bb_many = isset( $_POST['groups'] )
		? array_values( array_filter( array_map( 'sanitize_text_field', (array) wp_unslash( $_POST['groups'] ) ), static function ( $bb_g ) {
			return '' !== $bb_g;
		} ) )
		: array();
	// phpcs:enable
	// What a delete would actually cost, so the question can be asked with
	// real numbers instead of a warning in the abstract. Read only.
	if ( 'weigh' === $bb_op ) {
		// phpcs:disable WordPress.Security.NonceVerification.Missing -- checked above.
		$bb_names = $bb_many ? $bb_many : array( sanitize_text_field( wp_unslash( $_POST['group'] ?? '' ) ) );
		// phpcs:enable
		$bb_n_sets = 0;
		$bb_n_used = 0;
		$bb_prods  = array();
		foreach ( addon_boss_option_sets() as $bb_sid => $bb_set ) {
			if ( ! in_array( (string) ( $bb_set['group'] ?? '' ), $bb_names, true ) ) {
				continue;
			}
			++$bb_n_sets;
			$bb_on = addon_boss_option_set_used_on( (string) $bb_sid );
			if ( $bb_on ) {
				++$bb_n_used;
				foreach ( $bb_on as $bb_pid ) {
					$bb_prods[ (int) $bb_pid ] = true;
				}
			}
		}
		wp_send_json_success( array(
			'groups'   => count( $bb_names ),
			'sets'     => $bb_n_sets,
			'used'     => $bb_n_used,
			'products' => count( $bb_prods ),
		) );
	}

	// phpcs:disable WordPress.Security.NonceVerification.Missing -- checked above.
	$bb_with_sets = ! empty( $_POST['sets'] );
	// phpcs:enable

	if ( $bb_many ) {
		// Only the verbs that make sense on many at once. Rename and create
		// name ONE thing, and a bulk rename would have to invent the names.
		if ( ! in_array( $bb_op, array( 'delete', 'duplicate', 'empty' ), true ) ) {
			wp_send_json_error( array( 'message' => __( 'That is not something to do to several groups at once.', 'addon-boss' ) ), 400 );
		}
		$bb_did  = 0;
		$bb_stop = null;
		foreach ( $bb_many as $bb_group ) {
			$bb_one = addon_boss_group_op_apply( $bb_op, array( 'group' => $bb_group, 'sets' => $bb_with_sets ) );
			if ( is_wp_error( $bb_one ) ) {
				// Say which one stopped it and how far it got, rather than
				// leaving a merchant to guess what half-happened.
				$bb_stop = $bb_group;
				break;
			}
			++$bb_did;
		}
		if ( null !== $bb_stop ) {
			wp_send_json_error( array(
				'message' => sprintf(
					/* translators: 1: how many groups were done, 2: the group it stopped on. */
					_n( '%1$s done, then it stopped at %2$s.', '%1$s done, then it stopped at %2$s.', $bb_did, 'addon-boss' ),
					number_format_i18n( $bb_did ),
					$bb_stop
				),
				'done'    => $bb_did,
			), 400 );
		}
		wp_send_json_success( array( 'done' => $bb_did ) );
	}

	$bb_out = addon_boss_group_op_apply(
		$bb_op,
		array(
			'group' => sanitize_text_field( wp_unslash( $_POST['group'] ?? '' ) ),
			'to'    => sanitize_text_field( wp_unslash( $_POST['to'] ?? '' ) ),
			'sets'  => $bb_with_sets,
		)
	);
	if ( is_wp_error( $bb_out ) ) {
		wp_send_json_error( array( 'message' => $bb_out->get_error_message() ) );
	}
	wp_send_json_success( $bb_out );
}

/**
 * Whether this build offers tags in the Option Sets library.
 *
 * Asks the build, not the disk. A paid build whose licence has lapsed keeps
 * the tags file but offers no tags, so it draws the library the free build
 * draws: no selection ticks, no tag chips, no tag filter, and no tag left in
 * a bookmarked link narrowing the list with nothing on screen to say why.
 * The tags a shop made while paid stay stored, untouched, for the day the
 * licence returns.
 */
function addon_boss_library_tags_on(): bool {
	return function_exists( 'addon_boss_tags' ) && addon_boss_engine_can( 'option-tags' );
}

function addon_boss_render_option_set_group( string $slug, string $label, array $sets, bool $is_ungrouped, array $ctx = array() ): void {
    $bb_collapsed = ! empty( $ctx['collapsed'] );
    $bb_aria      = '';
    if ( ! empty( $ctx['pos'] ) && ! empty( $ctx['size'] ) ) {
        // Its place in the WHOLE list, not the page: "7 of 100", never "7 of 25".
        $bb_aria = ' aria-posinset="' . (int) $ctx['pos'] . '" aria-setsize="' . (int) $ctx['size'] . '"';
    }
    echo '<section class="bb-optgroup' . ( $is_ungrouped ? ' is-ungrouped' : '' ) . ( $sets ? '' : ' is-empty' ) . ( $bb_collapsed ? ' is-collapsed' : '' ) . '" data-group="' . esc_attr( $slug ) . '"' . $bb_aria . '>'; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- $bb_aria is two ints cast above.
    // The tick that puts this group in a selection, for tagging a run of them
    // at once. In its OWN gutter beside the row rather than inside the header:
    // the whole header folds the group when pressed, and a tick sitting in it
    // meant aiming at a small box inside a large button that does something
    // else. Only where tags exist to apply, so a shop without them is not
    // shown a control that does nothing.
    if ( addon_boss_library_tags_on() ) {
        echo '<label class="bb-grp-pickwrap"><input type="checkbox" class="bb-grp-pick" aria-label="' . esc_attr(
            /* translators: %s: the group's name. */
            sprintf( __( 'Select %s', 'addon-boss' ), $label )
        ) . '"></label>';
    }
    echo '<div class="bb-optgroup-h">';
    echo '<button type="button" class="bb-grp-caret" aria-expanded="' . ( $bb_collapsed ? 'false' : 'true' ) . '" aria-label="' . esc_attr__( 'Show or hide this group', 'addon-boss' ) . '">&#9662;</button>';
    echo '<span class="bb-grp-mid">';
    echo '<span class="bb-grp-name"' . ( $is_ungrouped ? '' : ' title="' . esc_attr__( 'Double-click to rename', 'addon-boss' ) . '"' ) . '>' . esc_html( $label ) . '</span>';
    // What the group holds, said on the closed row: with a hundred groups the
    // set names ARE the index, and a header that previews nothing does not
    // get opened.
    if ( '' !== (string) ( $ctx['preview'] ?? '' ) ) {
        echo '<span class="bb-grp-preview">' . esc_html( (string) $ctx['preview'] ) . '</span>';
    }
    echo '</span>';
    // The garment's own tags, on its header, so what it came from and what
    // has become of it read without opening anything.
    if ( ! $is_ungrouped && addon_boss_library_tags_on() ) {
        echo addon_boss_group_tag_chips( $label, (string) ( $ctx['source'] ?? '' ) ); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- escaped within.
    }
    echo '<span class="bb-grp-count">' . (int) count( $sets ) . '</span>';
    // Only a set that came from somewhere carries a badge; the merchant's own
    // are simply unmarked. The name is the warning that the next feed run
    // owns this row.
    if ( '' !== (string) ( $ctx['source'] ?? '' ) ) {
        echo '<span class="bb-grp-src">' . esc_html( (string) $ctx['source'] ) . '</span>';
    }
    if ( ! $is_ungrouped ) {
        echo '<span class="bb-grp-menuwrap">';
        echo '<button type="button" class="bb-grp-menu-btn" aria-haspopup="true" aria-expanded="false" aria-label="' . esc_attr__( 'Group actions', 'addon-boss' ) . '">&#8943;</button>';
        echo '<span class="bb-grp-menu" hidden>';
        echo '<button type="button" class="bb-grp-rename">' . esc_html__( 'Rename…', 'addon-boss' ) . '</button>';
        echo '<button type="button" class="bb-grp-dup">' . esc_html__( 'Duplicate', 'addon-boss' ) . '</button>';
        echo '<a class="bb-grp-newset" href="' . esc_url( admin_url( 'admin.php?page=addon-boss-option-sets&set=new&recipe=scratch&group=' . rawurlencode( $slug ) ) ) . '">' . esc_html__( '+ New set', 'addon-boss' ) . '</a>';
        echo '<button type="button" class="bb-grp-emptyop">' . esc_html__( 'Move all sets to Ungrouped', 'addon-boss' ) . '</button>';
        echo '<button type="button" class="bb-grp-del">' . esc_html__( 'Delete group', 'addon-boss' ) . '</button>';
        echo '</span></span>';
    }
    echo '</div>';
    echo '<div class="bb-setgrid">';
    foreach ( $sets as $id => $set ) {
        addon_boss_render_option_set_card( (string) $id, $set );
    }
    echo '<p class="bb-grp-empty">' . esc_html__( 'Drag sets here', 'addon-boss' ) . '</p>';
    echo '</div>';
    echo '</section>';
}

/** The list-page JS: fold memory, drag-to-file, the group and set menus. Every change is a NAMED operation (move this set, rename this group), because a paged list no longer holds every card and a whole-picture save would drop whatever is not on screen. */
function addon_boss_option_sets_organise_script( array $ctx = array() ): void {
    $labels = array(
        'newGroup'  => __( 'New group', 'addon-boss' ),
        'newGroupGo' => __( 'Create group', 'addon-boss' ),
        'untitled'  => __( 'Untitled group', 'addon-boss' ),
        'rename'    => esc_attr__( 'Double-click to rename', 'addon-boss' ),
        'name'      => esc_attr__( 'Group name', 'addon-boss' ),
        'delTitle'  => __( 'Delete this group?', 'addon-boss' ),
        'delBody'   => __( 'What should happen to the option sets inside?', 'addon-boss' ),
        'delKeep'   => __( 'Keep the sets, remove the group only', 'addon-boss' ),
        'delBoth'   => __( 'Delete the group and its sets', 'addon-boss' ),
        'delCancel' => __( 'Cancel', 'addon-boss' ),
        /* translators: %s: how many groups were picked. */
        'delMany'   => __( 'Delete %s groups?', 'addon-boss' ),
        /* translators: %s: a count of option sets, already worded. */
        'delHas'    => __( 'They hold %s.', 'addon-boss' ),
        /* translators: %s: a count of option sets, already worded. */
        'delHas1'   => __( 'It holds %s.', 'addon-boss' ),
        /* translators: %s: how many option sets. */
        'delSet1'   => __( '%s option set', 'addon-boss' ),
        /* translators: %s: how many option sets. */
        'delSetN'   => __( '%s option sets', 'addon-boss' ),
        // The clause travels WITH the product count, because it is the product
        // that loses the options: "1 product, which loses" against "3 products,
        // which lose". Keeping it in the outer sentence made one of the four
        // combinations ungrammatical whatever was written.
        /* translators: %s: how many products. */
        'delProd1'  => __( '%s product, which loses those options', 'addon-boss' ),
        /* translators: %s: how many products. */
        'delProdN'  => __( '%s products, which lose those options', 'addon-boss' ),
        /* translators: 1: how many sets are in use, 2: a count of products, already worded. */
        'delUsed'   => __( '%1$s of them are on %2$s.', 'addon-boss' ),
        /* translators: %s: a count of products, already worded. */
        'delUsed1'  => __( 'One of them is on %s.', 'addon-boss' ),
        'delNone'   => __( 'None of them is on a product.', 'addon-boss' ),
        'delUndo'   => __( 'Deleting the sets cannot be undone.', 'addon-boss' ),
        // An empty group holds nothing to keep, so there is no choice to
        // offer. It is still worth asking, because a selection can hold
        // twenty of them and a merchant should see the number first.
        'delBare'   => __( 'It holds no option sets.', 'addon-boss' ),
        'delBareN'  => __( 'They hold no option sets.', 'addon-boss' ),
        'delOnly'   => __( 'Delete the group', 'addon-boss' ),
        'delOnlyN'  => __( 'Delete the groups', 'addon-boss' ),
        'moveTo'    => __( 'Move to', 'addon-boss' ),
        'copyTo'    => __( 'Copy to', 'addon-boss' ),
        /* translators: %s: the set being moved, quoted. */
        'moveTitle' => __( 'Move %s to', 'addon-boss' ),
        /* translators: %s: the set being copied, quoted. */
        'copyTitle' => __( 'Copy %s to', 'addon-boss' ),
        'findGroup' => esc_attr__( 'Find a group', 'addon-boss' ),
        'findProduct' => esc_attr__( 'Find a product', 'addon-boss' ),
        'showMore'  => __( 'Show more', 'addon-boss' ),
        'noMatch'   => __( 'No products match.', 'addon-boss' ),
        'ungrouped' => __( 'Ungrouped', 'addon-boss' ),
        'newIn'     => __( '+ New group…', 'addon-boss' ),
        'position'  => __( 'Position', 'addon-boss' ),
        /* translators: %s: how many sets the group holds. */
        'ofN'       => __( 'of %s', 'addon-boss' ),
        /* translators: 1: group name, 2: how many products, 3: the set just added to the group */
        'offer'     => __( '%1$s is on %2$s products that do not have %3$s.', 'addon-boss' ),
        /* translators: %s: how many products */
        'offerYes'  => __( 'Add it to all %s', 'addon-boss' ),
        'offerNo'   => __( 'Not now', 'addon-boss' ),
        /* translators: %s: how many products it was added to */
        'offerDone' => __( 'Added to %s products.', 'addon-boss' ),
        /* translators: %s: how many groups are selected */
        'bulkN'     => __( '%s selected', 'addon-boss' ),
        'bulkAdd'   => __( 'Add a tag to the selected groups', 'addon-boss' ),
        'bulkRm'    => __( 'Take a tag off the selected groups', 'addon-boss' ),
        /* translators: %s: the tag's name */
        'bulkOff'   => __( 'Take %s off the selected groups', 'addon-boss' ),
        /* translators: %s: how many groups are selected */
        'bulkEmptyAsk' => __( 'Empty %s groups?', 'addon-boss' ),
        'bulkEmptyWhy' => __( 'Every set inside moves to Ungrouped. The groups stay, with nothing in them.', 'addon-boss' ),
        'bulkEmptyOk'  => __( 'Move the sets out', 'addon-boss' ),
        'tagFind'   => __( 'Find a tag', 'addon-boss' ),
        'tagFindOrNew' => __( 'Find a tag, or type a new one', 'addon-boss' ),
        /* translators: %s: the word the merchant typed */
        'tagNew'    => __( 'Make a new tag: %s', 'addon-boss' ),
        'tagNone'   => __( 'No tags yet. Type one to make it.', 'addon-boss' ),
        'tagLocked' => __( 'Kept up to date by your supplier feed', 'addon-boss' ),
        'tagRename' => __( 'Rename', 'addon-boss' ),
        'tagRenameGo' => __( 'Rename it', 'addon-boss' ),
        'tagMerge'  => __( 'Merge', 'addon-boss' ),
        /* translators: %s: the tag being folded into another */
        'tagMergeInto' => __( 'Merge %s into which tag?', 'addon-boss' ),
        'tagDelete' => __( 'Delete', 'addon-boss' ),
        /* translators: %s: the tag's name */
        'tagDeleteAsk' => __( 'Delete %s?', 'addon-boss' ),
        /* translators: %s: how many groups wear the tag */
        'tagDeleteWhy' => __( 'It comes off %s groups. The groups and their sets stay exactly as they are.', 'addon-boss' ),
        'tagDeleteWhy1' => __( 'It comes off one group. The group and its sets stay exactly as they are.', 'addon-boss' ),
        'tagDeleteWhy0' => __( 'No group is wearing it.', 'addon-boss' ),
        'tagDeleteOk' => __( 'Delete the tag', 'addon-boss' ),
        'manageTitle' => __( 'Manage tags', 'addon-boss' ),
        'manageSub' => __( 'Rename, recolour, merge or delete your own tags. Tags from a supplier feed are kept up to date by the feed.', 'addon-boss' ),
        'manageDone' => __( 'Done', 'addon-boss' ),
        'tagNewAsk'  => __( 'Name the new tag', 'addon-boss' ),
        'tagNewGo'   => __( 'Add it', 'addon-boss' ),
        'manageNone' => __( 'No tags yet. Select some groups and add one.', 'addon-boss' ),
        /* translators: %s: how many groups wear this tag */
        'onN'       => __( 'on %s', 'addon-boss' ),
    );
    ?>
    <?php ob_start(); try { ?>
    ( function () {
        var wrap = document.getElementById( 'bb-optgroups' );
        if ( ! wrap ) { return; }
        var NONCE  = <?php echo wp_json_encode( wp_create_nonce( 'addon_boss_set_groups' ) ); ?>;
        var L      = <?php echo wp_json_encode( $labels ); ?>;
        var GROUPS = <?php echo wp_json_encode( array_values( array_map( 'strval', (array) ( $ctx['groups'] ?? array() ) ) ) ); ?>;
        var FILTERING = <?php echo ! empty( $ctx['filtering'] ) ? 'true' : 'false'; ?>;
        var FNONCE = <?php echo wp_json_encode( wp_create_nonce( 'addon_boss_option_library' ) ); ?>;

        // ---- Narrowing without a page load.
        //
        // A tag, the source, a page number: each changes one list. Reloading
        // the whole admin to do it costs about ten times what fetching the
        // list costs. The controls stay ordinary links, so this is only ever
        // an improvement on top of something that already works.
        var busy = false;
        function stateFrom( url ) {
            var p = new URL( url, window.location.href ).searchParams;
            // add_query_arg writes an array as bbtag[0]=x&bbtag[1]=y, so take
            // every key that begins bbtag rather than one fixed spelling.
            var tags = [];
            p.forEach( function ( v, k ) {
                if ( 0 === k.indexOf( 'bbtag' ) && v ) { tags.push( v ); }
            } );
            return {
                s: p.get( 's' ) || '',
                source: p.get( 'source' ) || '',
                paged: p.get( 'paged' ) || '1',
                per_page: p.get( 'per_page' ) || '',
                colours: p.get( 'colours' ) || '',
                bbtag: tags
            };
        }
        function narrow( url ) {
            if ( busy ) { return; }
            busy = true;
            var st   = stateFrom( url );
            var body = new URLSearchParams();
            body.append( 'action', 'addon_boss_option_library' );
            body.append( 'nonce', FNONCE );
            body.append( 's', st.s );
            body.append( 'source', st.source );
            body.append( 'paged', st.paged );
            body.append( 'per_page', st.per_page );
            body.append( 'colours', st.colours );
            st.bbtag.forEach( function ( t ) { body.append( 'bbtag[]', t ); } );
            wrap.setAttribute( 'aria-busy', 'true' );
            fetch( ajaxurl, {
                method: 'POST',
                credentials: 'same-origin',
                headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
                body: body.toString()
            } ).then( function ( r ) { return r.json(); } ).then( function ( j ) {
                if ( ! j || ! j.success ) { window.location.href = url; return; }
                // innerHTML, never replacing the element: every handler on this
                // page is delegated from wrap, and swapping wrap would drop
                // the lot — the drag, the menus, the rename.
                wrap.innerHTML = j.data.rows;
                if ( j.data.filtering ) { wrap.setAttribute( 'data-filtering', '1' ); }
                else { wrap.removeAttribute( 'data-filtering' ); }
                var nav = document.querySelector( '.bb-optsets-nav' );
                if ( nav ) { nav.outerHTML = j.data.nav; }
                window.history.pushState( {}, '', j.data.url );
                // Swap the furniture PHP rendered rather than reshaping what is
                // already there: same markup a reload would give, so the two
                // routes into this screen can never disagree.
                var row = document.querySelector( '.bb-tagapplied' );
                if ( row && j.data.applied ) { row.outerHTML = j.data.applied; }
                var pick = document.querySelector( '.bb-tagpick' );
                if ( pick && j.data.menu ) { pick.outerHTML = j.data.menu; }
                // The "colours to pick" pill, pressed or not, with its link
                // carrying whatever else is narrowing now.
                var need = document.querySelector( '.bb-sw-need-row' );
                if ( need && 'string' === typeof j.data.pill ) { need.outerHTML = j.data.pill; }
                syncSearchForm( st );
                wrap.removeAttribute( 'aria-busy' );
                busy = false;
                if ( typeof refresh === 'function' ) { refresh(); }
            } ).catch( function () { window.location.href = url; } );
        }
        // The one thing the swap cannot carry: the search form is part of the
        // toolbar, which narrowing never re-renders. Left alone it would still
        // hold whatever the page FIRST loaded with, and pressing Enter would
        // jump back to a view the person had already moved on from.
        function syncSearchForm( st ) {
            var on   = st.bbtag || [];
            var form = document.querySelector( '.bb-optsets-toolbar' );
            if ( ! form ) { return; }
            form.querySelectorAll( 'input[name="bbtag[]"]' ).forEach( function ( i ) { i.remove(); } );
            on.forEach( function ( t ) {
                var i = document.createElement( 'input' );
                i.type  = 'hidden';
                i.name  = 'bbtag[]';
                i.value = t;
                form.appendChild( i );
            } );
            var box = form.querySelector( 'input[name="s"]' );
            if ( box && box.value !== st.s ) { box.value = st.s; }
            var src = form.querySelector( 'select[name="source"]' );
            if ( src && src.value !== st.source ) { src.value = st.source; }
            var col = form.querySelector( 'input[name="colours"]' );
            if ( st.colours && ! col ) {
                col = document.createElement( 'input' );
                col.type  = 'hidden';
                col.name  = 'colours';
                col.value = 'todo';
                form.appendChild( col );
            } else if ( ! st.colours && col ) {
                col.remove();
            }
        }
        /**
         * Typing in the menu narrows it. A heading with nothing left under it
         * goes too, or the list reads as sections that are not there.
         */
        function filterTagMenu() {
            var pick = document.querySelector( '.bb-tagpick' );
            if ( ! pick ) { return; }
            var box = pick.querySelector( '.bb-tagpick-find' );
            var q   = box ? box.value.trim().toLowerCase() : '';
            var hits = 0;
            pick.querySelectorAll( '.bb-tagpick-opt' ).forEach( function ( o ) {
                var name = ( o.dataset.name || '' ).toLowerCase();
                var hit  = ! q || name.indexOf( q ) > -1;
                o.closest( 'li' ).hidden = ! hit;
                if ( hit ) { hits++; }
            } );
            pick.querySelectorAll( '.bb-tagpick-head' ).forEach( function ( h ) {
                var any = false, n = h.nextElementSibling;
                while ( n && ! n.classList.contains( 'bb-tagpick-head' ) ) {
                    if ( ! n.hidden && n.querySelector( '.bb-tagpick-opt' ) ) { any = true; break; }
                    n = n.nextElementSibling;
                }
                h.hidden = ! any;
            } );
            var none = pick.querySelector( '.bb-tagpick-nohit' );
            if ( none ) { none.hidden = ! ( q && ! hits ); }
        }
        /** Open or shut the menu, and never leave two of them open. */
        function shutTagMenu() {
            document.querySelectorAll( '.bb-tagpick-pop' ).forEach( function ( p ) { p.hidden = true; } );
            document.querySelectorAll( '.bb-tagpick-btn' ).forEach( function ( b ) { b.setAttribute( 'aria-expanded', 'false' ); } );
        }
        document.addEventListener( 'input', function ( e ) {
            if ( e.target && e.target.classList && e.target.classList.contains( 'bb-tagpick-find' ) ) { filterTagMenu(); }
        } );
        document.addEventListener( 'click', function ( e ) {
            var btn = e.target.closest ? e.target.closest( '.bb-tagpick-btn' ) : null;
            if ( btn ) {
                e.preventDefault();
                var pop  = btn.parentNode.querySelector( '.bb-tagpick-pop' );
                var show = pop.hidden;
                shutTagMenu();
                if ( show ) {
                    pop.hidden = false;
                    btn.setAttribute( 'aria-expanded', 'true' );
                    var find = pop.querySelector( '.bb-tagpick-find' );
                    if ( find ) { find.value = ''; filterTagMenu(); find.focus(); }
                }
                return;
            }
            if ( ! e.target.closest || ! e.target.closest( '.bb-tagpick' ) ) { shutTagMenu(); }
        } );
        document.addEventListener( 'keydown', function ( e ) {
            if ( 'Escape' === e.key ) { shutTagMenu(); }
            // The menu's search sits inside the toolbar form. Enter there means
            // "narrow this list of words", never "search the library and throw
            // my menu away".
            if ( 'Enter' === e.key && e.target && e.target.classList
                && e.target.classList.contains( 'bb-tagpick-find' ) ) {
                e.preventDefault();
                var first = document.querySelector( '.bb-tagpick-pop a.bb-tagpick-opt:not([hidden])' );
                if ( first && first.closest( 'li' ) && ! first.closest( 'li' ).hidden ) { first.click(); }
            }
        } );
        // Every control that only changes which sets are listed: the chips on
        // the applied row, the words in the menu, the pager. They stay real
        // links, so this is an improvement on something that already worked.
        document.addEventListener( 'click', function ( e ) {
            var a = e.target.closest
                ? e.target.closest( '.bb-tagapplied a, .bb-tagpick-pop a, .bb-optsets-nav a, a.bb-sw-need-pill' )
                : null;
            if ( ! a || ! a.href || e.metaKey || e.ctrlKey || e.shiftKey || 1 === e.button ) { return; }
            e.preventDefault();
            shutTagMenu();
            narrow( a.href );
        } );
        window.addEventListener( 'popstate', function () { narrow( window.location.href ); } );

        // ---- Tagging a run of groups at once, and keeping the vocabulary.
        //
        // One garment at a time is fine for one garment. A merchant who has
        // just imported a supplier is looking at forty polos that are all for
        // the same school order, and doing that forty times is why people stop
        // tagging things after the first week.
        var TNONCE = <?php echo wp_json_encode( wp_create_nonce( 'addon_boss_tag_op' ) ); ?>;
        var TAGS   = <?php echo wp_json_encode( addon_boss_library_tags_on() ? addon_boss_tags_listed() : array() ); ?>;
        var PALETTE = <?php echo wp_json_encode( addon_boss_library_tags_on() ? array_values( addon_boss_tag_palette() ) : array() ); ?>;
        var bulk = document.getElementById( 'bb-tagbulk' );

        function tagPost( params ) {
            var body = new URLSearchParams();
            body.append( 'action', 'addon_boss_tag_op' );
            body.append( 'nonce', TNONCE );
            Object.keys( params ).forEach( function ( k ) {
                if ( Array.isArray( params[ k ] ) ) {
                    params[ k ].forEach( function ( v ) { body.append( k + '[]', v ); } );
                } else {
                    body.append( k, params[ k ] );
                }
            } );
            return fetch( ajaxurl, {
                method: 'POST', credentials: 'same-origin',
                headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
                body: body.toString()
            } ).then( function ( r ) { return r.json(); } ).then( function ( j ) {
                if ( j && j.data && j.data.tags ) { TAGS = j.data.tags; }
                // A refusal is the supplier-tag rule speaking, and it has a
                // reason worth reading rather than a silent nothing-happened.
                if ( j && ! j.success && j.data && j.data.message ) { window.alert( j.data.message ); }
                return j;
            } );
        }

        function picked() {
            var out = [];
            wrap.querySelectorAll( '.bb-grp-pick:checked' ).forEach( function ( c ) {
                var sec = c.closest( '.bb-optgroup' );
                if ( sec ) { out.push( sec.classList.contains( 'is-ungrouped' ) ? '' : ( sec.getAttribute( 'data-group' ) || '' ) ); }
            } );
            return out;
        }
        function syncBulk() {
            if ( ! bulk ) { return; }
            var n = picked().length;
            bulk.classList.toggle( 'is-on', n > 0 );
            wrap.classList.toggle( 'is-picking', n > 0 );
            bulk.querySelector( '.bb-tagbulk-n' ).textContent = n
                ? L.bulkN.replace( '%s', String( n ) )
                : '';
            paintCarried();
        }

        // What the selection already wears, each one pressable to take it off.
        // Asking "which tag?" in a dialog was asking a question the screen can
        // simply answer: these are the words in front of you, press one to go.
        function paintCarried() {
            if ( ! bulk ) { return; }
            var host = bulk.querySelector( '.bb-tagbulk-on' );
            if ( ! host ) { return; }
            host.textContent = '';
            var seen = {};
            wrap.querySelectorAll( '.bb-grp-pick:checked' ).forEach( function ( c ) {
                var sec = c.closest( '.bb-optgroup' );
                if ( ! sec ) { return; }
                sec.querySelectorAll( '.bb-optgroup-h .bb-tag[data-tag]' ).forEach( function ( t ) {
                    // A locked chip is the feed's word and not a merchant's to
                    // take off, so it is never offered as removable.
                    if ( t.classList.contains( 'is-locked' ) ) { return; }
                    // The chip's NAME, not everything inside it: the chip grew a
                    // remove control of its own, so textContent now carries that
                    // glyph too and the bar was drawing two of them.
                    var nm = '';
                    t.childNodes.forEach( function ( n ) { if ( 3 === n.nodeType ) { nm += n.textContent; } } );
                    seen[ t.dataset.tag ] = { name: nm.trim() || t.textContent.trim(), colour: t.style.getPropertyValue( '--bb-tag' ) };
                } );
            } );
            Object.keys( seen ).forEach( function ( id ) {
                var b = document.createElement( 'button' );
                b.type = 'button';
                b.className = 'bb-tagbulk-off';
                b.style.setProperty( '--bb-tag', seen[ id ].colour );
                b.title = L.bulkOff.replace( '%s', seen[ id ].name );
                b.setAttribute( 'aria-label', b.title );
                b.appendChild( document.createTextNode( seen[ id ].name ) );
                var x = document.createElement( 'span' );
                x.className = 'bb-tagbulk-x';
                x.setAttribute( 'aria-hidden', 'true' );
                x.textContent = '×';
                b.appendChild( x );
                b.addEventListener( 'click', function () {
                    var groups = picked();
                    if ( ! groups.length ) { return; }
                    tagPost( { op: 'apply', tag: id, on: 0, groups: groups } ).then( function ( j ) {
                        if ( j && j.success ) { repaintChips( j.data.chips ); paintCarried(); }
                    } );
                } );
                host.appendChild( b );
            } );
        }
        wrap.addEventListener( 'change', function ( e ) {
            if ( e.target && e.target.classList && e.target.classList.contains( 'bb-grp-pick' ) ) { syncBulk(); }
        } );
        // A tick is not a fold: clicking it must not open the group underneath.
        wrap.addEventListener( 'click', function ( e ) {
            if ( e.target && e.target.classList && e.target.classList.contains( 'bb-grp-pick' ) ) { e.stopPropagation(); }
        }, true );

        // The chooser: what the shop already says, before anything new is made.
        function pickTag( title, opts, done ) {
            var ov = document.createElement( 'div' ); ov.className = 'bb-po-modal-ov';
            ov.innerHTML = '<div class="bb-po-modal bb-pick-modal" role="dialog" aria-modal="true"><p class="bb-po-modal-msg"></p><p class="bb-name-row"><input type="search" class="bb-grp-nameedit bb-name-input bb-pick-find"></p><div class="bb-pick-list"></div><div class="bb-po-modal-acts"><button type="button" class="button bb-po-modal-cancel bb-fd-cancel"></button></div></div>';
            ov.querySelector( '.bb-po-modal-msg' ).textContent = title;
            ov.querySelector( '.bb-fd-cancel' ).textContent = L.delCancel;
            var find = ov.querySelector( '.bb-pick-find' );
            find.placeholder = opts.make ? L.tagFindOrNew : L.tagFind;
            find.setAttribute( 'aria-label', find.placeholder );
            var list = ov.querySelector( '.bb-pick-list' );
            function close() { if ( ov.parentNode ) { ov.parentNode.removeChild( ov ); } document.removeEventListener( 'keydown', esc ); }
            function esc( ev ) { if ( ev.key === 'Escape' ) { close(); } }
            function fill( q ) {
                list.textContent = '';
                q = ( q || '' ).toLowerCase();
                var shown = 0;
                TAGS.forEach( function ( t ) {
                    // A supplier tag is the feed's to apply. Offering it here
                    // would promise something tonight's run takes back.
                    if ( 'supplier' === t.kind ) { return; }
                    if ( opts.skip && opts.skip === t.id ) { return; }
                    if ( q && t.name.toLowerCase().indexOf( q ) === -1 ) { return; }
                    var b = document.createElement( 'button' );
                    b.type = 'button';
                    b.textContent = t.name + ( t.n ? '  (' + t.n + ')' : '' );
                    b.addEventListener( 'click', function () { close(); done( t.id, '' ); } );
                    list.appendChild( b );
                    shown++;
                } );
                // Creating is offered LAST and only once nothing matched what
                // was typed, which is the whole defence against a second
                // spelling of a word the shop already has.
                if ( opts.make && q && ! TAGS.some( function ( t ) { return t.name.toLowerCase() === q; } ) ) {
                    var mk = document.createElement( 'button' );
                    mk.type = 'button'; mk.className = 'bb-menu-new';
                    mk.textContent = L.tagNew.replace( '%s', find.value.trim() );
                    mk.addEventListener( 'click', function () { close(); done( '', find.value.trim() ); } );
                    list.appendChild( mk );
                } else if ( ! shown ) {
                    var none = document.createElement( 'p' );
                    none.className = 'bb-tagman-none';
                    none.textContent = L.tagNone;
                    list.appendChild( none );
                }
            }
            find.addEventListener( 'input', function () { fill( find.value ); } );
            find.addEventListener( 'keydown', function ( ev ) {
                if ( ev.key !== 'Enter' ) { return; }
                ev.preventDefault();
                var top = list.querySelector( 'button' );
                if ( top ) { top.click(); }
            } );
            fill( '' );
            ov.querySelector( '.bb-fd-cancel' ).addEventListener( 'click', close );
            ov.addEventListener( 'click', function ( ev ) { if ( ev.target === ov ) { close(); } } );
            document.addEventListener( 'keydown', esc );
            document.body.appendChild( ov );
            find.focus();
        }

        // Tagging ONE group, from the row itself. Selecting and using the bar
        // is right for forty garments and far too much ceremony for one.
        document.addEventListener( 'click', function ( e ) {
            var b = e.target.closest ? e.target.closest( '.bb-grp-tagadd' ) : null;
            if ( ! b ) { return; }
            e.preventDefault();
            e.stopPropagation(); // it sits in the header, which folds the group.
            var sec = b.closest( '.bb-optgroup' );
            if ( ! sec ) { return; }
            var slug = sec.classList.contains( 'is-ungrouped' ) ? '' : ( sec.getAttribute( 'data-group' ) || '' );
            applyTo( [ slug ], true );
        } );

        // Taking ONE tag off ONE group, pressed on the tag itself. No dialog:
        // the chip already names which tag, and the row it sits on already
        // names which group, so asking either would be asking a question the
        // screen has answered.
        document.addEventListener( 'click', function ( e ) {
            var x = e.target.closest ? e.target.closest( '.bb-tag-off' ) : null;
            if ( ! x ) { return; }
            e.preventDefault();
            e.stopPropagation(); // it sits in the header, which folds the group.
            var chip = x.closest( '.bb-tag[data-tag]' );
            var sec  = x.closest( '.bb-optgroup' );
            if ( ! chip || ! sec ) { return; }
            var slug = sec.classList.contains( 'is-ungrouped' ) ? '' : ( sec.getAttribute( 'data-group' ) || '' );
            tagPost( { op: 'apply', tag: chip.dataset.tag, on: 0, groups: [ slug ] } ).then( function ( j ) {
                if ( ! j || ! j.success ) { return; }
                repaintChips( j.data.chips );
                paintCarried();
            } );
        } );

        function applyToPicked( on ) {
            var groups = picked();
            if ( ! groups.length ) { return; }
            applyTo( groups, on );
        }
        // Repaint from what the server says the group now wears, never from
        // what this screen hoped it would.
        function repaintChips( chips ) {
            Object.keys( chips || {} ).forEach( function ( g ) {
                wrap.querySelectorAll( '.bb-optgroup' ).forEach( function ( sec ) {
                    var slug = sec.classList.contains( 'is-ungrouped' ) ? '' : ( sec.getAttribute( 'data-group' ) || '' );
                    if ( slug !== g ) { return; }
                    var old = sec.querySelector( '.bb-optgroup-h > .bb-tag-row' );
                    var holder = document.createElement( 'div' );
                    holder.innerHTML = chips[ g ];
                    var fresh = holder.firstElementChild;
                    if ( old && fresh ) { old.replaceWith( fresh ); }
                    else if ( old ) { old.remove(); }
                    else if ( fresh ) {
                        var count = sec.querySelector( '.bb-grp-count' );
                        if ( count ) { count.parentNode.insertBefore( fresh, count ); }
                    }
                } );
            } );
        }
        function applyTo( groups, on ) {
            pickTag( on ? L.bulkAdd : L.bulkRm, { make: on }, function ( id, name ) {
                tagPost( { op: 'apply', tag: id, name: name, on: on ? 1 : 0, groups: groups } ).then( function ( j ) {
                    if ( ! j || ! j.success ) { return; }
                    repaintChips( j.data.chips );
                    paintCarried();
                } );
            } );
        }

        // The verbs a selection is expected to have. Each is the same thing the
        // group's own menu already does, asked of all of them in one trip.
        // The one delete question, asked the same way from the row menu and
        // from a selection. It weighs the groups first so it can say what is
        // actually inside, then offers the two real answers. The safe one
        // leads and holds focus; the destructive one is never the default.
        function askGroupDelete( names, go ) {
            post( { action: "addon_boss_group_op", op: "weigh", groups: names, group: names[ 0 ] || "" } ).then( function ( j2 ) {
                var d = ( j2 && j2.success && j2.data ) ? j2.data : { sets: 0, used: 0, products: 0 };
                var bare = ! d.sets;
                var ov = document.createElement( "div" );
                ov.className = "bb-po-modal-ov";
                ov.innerHTML = '<div class="bb-po-modal" role="dialog" aria-modal="true">'
                    + '<p class="bb-po-modal-msg"></p><p class="bb-po-modal-sub"></p>'
                    + '<p class="bb-po-modal-sub bb-po-modal-cost"></p>'
                    + '<div class="bb-po-modal-acts">'
                    + '<button type="button" class="button bb-cta bb-po-modal-keep"></button>'
                    + '<button type="button" class="button bb-po-modal-del"></button>'
                    + '<button type="button" class="button bb-po-modal-cancel"></button>'
                    + '</div></div>';
                var title = 1 === names.length
                    ? ( names[ 0 ] ? ( "\u201C" + names[ 0 ] + "\u201D" ) : L.delTitle )
                    : L.delMany.replace( "%s", String( names.length ) );
                ov.querySelector( ".bb-po-modal-msg" ).textContent = title;
                var keep = ov.querySelector( ".bb-po-modal-keep" );
                var both = ov.querySelector( ".bb-po-modal-del" );
                if ( bare ) {
                    // No sets inside means no choice to make, so the screen
                    // does not stage one: it states the fact and offers the
                    // single action there is.
                    ov.querySelector( ".bb-po-modal-sub" ).textContent = 1 === names.length ? L.delBare : L.delBareN;
                    ov.querySelector( ".bb-po-modal-cost" ).remove();
                    keep.remove();
                    both.textContent = 1 === names.length ? L.delOnly : L.delOnlyN;
                } else {
                    ov.querySelector( ".bb-po-modal-sub" ).textContent = L.delBody;
                    // What it costs, in this shop\u2019s own numbers.
                    // Every number wears its own plural: "1 product" is not "1 products",
                    // and a merchant reading a warning notices which of the two you wrote.
                    var setsWord = ( 1 === d.sets ? L.delSet1 : L.delSetN ).replace( "%s", String( d.sets ) );
                    var prodWord = ( 1 === d.products ? L.delProd1 : L.delProdN ).replace( "%s", String( d.products ) );
                    var has = ( 1 === names.length ? L.delHas1 : L.delHas ).replace( "%s", setsWord );
                    var use = d.used
                        ? ( 1 === d.used
                            ? L.delUsed1.replace( "%s", prodWord )
                            : L.delUsed.replace( "%1$s", String( d.used ) ).replace( "%2$s", prodWord ) )
                        : L.delNone;
                    ov.querySelector( ".bb-po-modal-cost" ).textContent = has + " " + use + " " + L.delUndo;
                    keep.textContent = L.delKeep;
                    both.textContent = L.delBoth;
                }
                ov.querySelector( ".bb-po-modal-cancel" ).textContent = L.delCancel;
                function done() { if ( ov.parentNode ) { ov.parentNode.removeChild( ov ); } document.removeEventListener( "keydown", esc ); }
                function esc( ev ) { if ( "Escape" === ev.key ) { done(); } }
                if ( ! bare ) { keep.addEventListener( "click", function () { done(); go( false ); } ); }
                both.addEventListener( "click", function () { done(); go( bare ? false : true ); } );
                ov.querySelector( ".bb-po-modal-cancel" ).addEventListener( "click", done );
                ov.addEventListener( "click", function ( ev ) { if ( ev.target === ov ) { done(); } } );
                document.addEventListener( "keydown", esc );
                document.body.appendChild( ov );
                // Focus never lands on the destructive answer when a safe one
                // exists; with an empty group there is only the one action.
                ( bare ? ov.querySelector( ".bb-po-modal-cancel" ) : keep ).focus();
            } );
        }
        // A one-answer question in the same frame as the two-answer one, so a
        // merchant is never thrown from our screen into the browser's own box
        // halfway through a job.
        function askPlainly( title, body, okLabel, go ) {
            var ov = document.createElement( 'div' );
            ov.className = 'bb-po-modal-ov';
            ov.innerHTML = '<div class="bb-po-modal" role="dialog" aria-modal="true">'
                + '<p class="bb-po-modal-msg"></p><p class="bb-po-modal-sub"></p>'
                + '<div class="bb-po-modal-acts">'
                + '<button type="button" class="button bb-cta bb-po-modal-ok"></button>'
                + '<button type="button" class="button bb-po-modal-cancel"></button>'
                + '</div></div>';
            ov.querySelector( '.bb-po-modal-msg' ).textContent = title;
            ov.querySelector( '.bb-po-modal-sub' ).textContent = body;
            ov.querySelector( '.bb-po-modal-ok' ).textContent = okLabel;
            ov.querySelector( '.bb-po-modal-cancel' ).textContent = L.delCancel;
            function done() { if ( ov.parentNode ) { ov.parentNode.removeChild( ov ); } document.removeEventListener( 'keydown', esc ); }
            function esc( ev ) { if ( 'Escape' === ev.key ) { done(); } }
            ov.querySelector( '.bb-po-modal-ok' ).addEventListener( 'click', function () { done(); go(); } );
            ov.querySelector( '.bb-po-modal-cancel' ).addEventListener( 'click', done );
            ov.addEventListener( 'click', function ( ev ) { if ( ev.target === ov ) { done(); } } );
            document.addEventListener( 'keydown', esc );
            document.body.appendChild( ov );
            ov.querySelector( '.bb-po-modal-ok' ).focus();
        }
        function bulkGroupOp( op ) {
            var groups = picked();
            if ( ! groups.length ) { return; }
            // Delete is the one verb that can destroy work, so it asks properly
            // rather than through the browser box, which cannot offer a choice.
            if ( 'delete' === op ) { askGroupDelete( groups, function ( withSets ) { runGroupOp( op, groups, withSets ); } ); return; }
            if ( 'empty' === op ) {
                askPlainly(
                    L.bulkEmptyAsk.replace( '%s', String( groups.length ) ),
                    L.bulkEmptyWhy,
                    L.bulkEmptyOk,
                    function () { runGroupOp( op, groups, false ); }
                );
                return;
            }
            runGroupOp( op, groups, false );
        }
        function runGroupOp( op, groups, withSets ) {
            post( { action: "addon_boss_group_op", op: op, groups: groups, sets: withSets ? 1 : 0 } ).then( function ( j ) {
                if ( j && ! j.success && j.data && j.data.message ) { window.alert( j.data.message ); }
                // Groups appeared, vanished or emptied: the list is a different
                // list now, so it is re-read rather than patched in ten places.
                narrow( window.location.href );
            } );
        }
        if ( bulk ) {
            bulk.querySelector( '.bb-tagbulk-add' ).addEventListener( 'click', function () { applyToPicked( true ); } );
            bulk.querySelector( '.bb-tagbulk-dup' ).addEventListener( 'click', function () { bulkGroupOp( 'duplicate' ); } );
            bulk.querySelector( '.bb-tagbulk-empty' ).addEventListener( 'click', function () { bulkGroupOp( 'empty' ); } );
            bulk.querySelector( '.bb-tagbulk-del' ).addEventListener( 'click', function () { bulkGroupOp( 'delete' ); } );
            bulk.querySelector( '.bb-tagbulk-none' ).addEventListener( 'click', function () {
                wrap.querySelectorAll( '.bb-grp-pick:checked' ).forEach( function ( c ) { c.checked = false; } );
                syncBulk();
            } );
        }

        // ---- Housekeeping: rename, recolour, merge, delete.
        function manageTags() {
            var ov = document.createElement( 'div' ); ov.className = 'bb-po-modal-ov';
            ov.innerHTML = '<div class="bb-po-modal bb-pick-modal bb-tagman-modal" role="dialog" aria-modal="true"><p class="bb-po-modal-msg"></p><p class="bb-po-modal-sub"></p><div class="bb-pick-list bb-tagman-list"></div><div class="bb-po-modal-acts"><button type="button" class="button bb-po-modal-cancel bb-fd-cancel"></button></div></div>';
            ov.querySelector( '.bb-po-modal-msg' ).textContent = L.manageTitle;
            ov.querySelector( '.bb-po-modal-sub' ).textContent = L.manageSub;
            ov.querySelector( '.bb-fd-cancel' ).textContent = L.manageDone;
            var list = ov.querySelector( '.bb-tagman-list' );
            function close() {
                if ( ov.parentNode ) { ov.parentNode.removeChild( ov ); }
                document.removeEventListener( 'keydown', esc );
                // The bar, the chips and the counts all came from tags that
                // may have just been renamed or folded together, so the page
                // is re-read rather than patched in six places.
                narrow( window.location.href );
            }
            function esc( ev ) { if ( ev.key === 'Escape' ) { close(); } }
            function act( label, fn ) {
                var b = document.createElement( 'button' );
                b.type = 'button'; b.textContent = label;
                b.addEventListener( 'click', fn );
                return b;
            }
            function draw() {
                list.textContent = '';
                if ( ! TAGS.length ) {
                    var none = document.createElement( 'p' );
                    none.className = 'bb-tagman-none';
                    none.textContent = L.manageNone;
                    list.appendChild( none );
                    return;
                }
                TAGS.forEach( function ( t ) {
                    var row = document.createElement( 'div' );
                    row.className = 'bb-tagman-row';

                    var chip = document.createElement( 'span' );
                    chip.className = 'bb-tagman-name';
                    chip.innerHTML = '<span class="bb-tag" style="--bb-tag:' + t.colour + '"><span class="bb-tag-dot"></span></span>';
                    chip.querySelector( '.bb-tag' ).appendChild( document.createTextNode( t.name ) );
                    row.appendChild( chip );

                    var n = document.createElement( 'span' );
                    n.className = 'bb-tagman-n';
                    n.textContent = L.onN.replace( '%s', String( t.n ) );
                    row.appendChild( n );

                    if ( 'supplier' === t.kind ) {
                        var lk = document.createElement( 'span' );
                        lk.className = 'bb-tagman-locked';
                        lk.textContent = L.tagLocked;
                        row.appendChild( lk );
                        list.appendChild( row );
                        return;
                    }

                    var sw = document.createElement( 'span' );
                    sw.className = 'bb-tagman-sw';
                    PALETTE.forEach( function ( hex ) {
                        var b = document.createElement( 'button' );
                        b.type = 'button';
                        b.style.background = hex;
                        b.setAttribute( 'aria-label', hex );
                        if ( hex.toLowerCase() === String( t.colour ).toLowerCase() ) { b.className = 'is-on'; }
                        b.addEventListener( 'click', function () {
                            tagPost( { op: 'recolour', tag: t.id, colour: hex } ).then( function ( j ) { if ( j && j.success ) { draw(); } } );
                        } );
                        sw.appendChild( b );
                    } );
                    row.appendChild( sw );

                    var acts = document.createElement( 'span' );
                    acts.className = 'bb-tagman-acts';
                    acts.appendChild( act( L.tagRename, function () {
                        askName( L.tagRename, L.tagRenameGo, function ( name ) {
                            tagPost( { op: 'rename', tag: t.id, name: name } ).then( function ( j ) { if ( j && j.success ) { draw(); } } );
                        }, t.name );
                    } ) );
                    acts.appendChild( act( L.tagMerge, function () {
                        pickTag( L.tagMergeInto.replace( '%s', t.name ), { skip: t.id, make: false }, function ( into ) {
                            if ( ! into ) { return; }
                            tagPost( { op: 'merge', tag: t.id, into: into } ).then( function ( j ) { if ( j && j.success ) { draw(); } } );
                        } );
                    } ) );
                    acts.appendChild( act( L.tagDelete, function () {
                        // A delete takes the word off everything wearing it,
                        // so the count is in the question, not discovered after.
                        var why = t.n
                            ? ( 1 === t.n ? L.tagDeleteWhy1 : L.tagDeleteWhy.replace( '%s', String( t.n ) ) )
                            : L.tagDeleteWhy0;
                        askPlainly( L.tagDeleteAsk.replace( '%s', t.name ), why, L.tagDeleteOk, function () {
                            tagPost( { op: 'delete', tag: t.id } ).then( function ( j ) { if ( j && j.success ) { draw(); } } );
                        } );
                    } ) );
                    row.appendChild( acts );
                    list.appendChild( row );
                } );
            }
            draw();
            ov.querySelector( '.bb-fd-cancel' ).addEventListener( 'click', close );
            ov.addEventListener( 'click', function ( ev ) { if ( ev.target === ov ) { close(); } } );
            document.addEventListener( 'keydown', esc );
            document.body.appendChild( ov );
        }
        document.addEventListener( 'click', function ( e ) {
            var b = e.target.closest ? e.target.closest( '.bb-tag-manage' ) : null;
            if ( ! b ) { return; }
            e.preventDefault();
            manageTags();
        } );
        // Coining a word, without needing something to put it on first. It
        // lands under "On nothing yet" until it does, which is where the menu
        // already says such words live.
        document.addEventListener( 'click', function ( e ) {
            var b = e.target.closest ? e.target.closest( '.bb-tag-new' ) : null;
            if ( ! b ) { return; }
            e.preventDefault();
            // The same dialog Rename opens, not the browser's own prompt box.
            // A native prompt is the one thing on this screen that looks like
            // nothing else on it: no house chrome, no styling, and it says the
            // site's hostname across the top as if the page were warning you.
            // askName already handles focus, Enter, Escape and clicking away.
            askName( L.tagNewAsk, L.tagNewGo, function ( name ) {
                b.disabled = true;
                tagPost( { op: 'make', name: name } ).then( function ( j ) {
                    b.disabled = false;
                    if ( j && j.success ) { narrow( window.location.href ); }
                } ).catch( function () { b.disabled = false; } );
            } );
        } );

        function post( params ) {
            var body = new URLSearchParams();
            body.append( '_wpnonce', NONCE );
            Object.keys( params ).forEach( function ( k ) {
                // A list goes over the wire AS a list. Appending it whole turns
                // two group names into one string with a comma in it, and the
                // server then looks for a group nobody has ever created: the
                // request succeeds and the selection is untouched.
                if ( Array.isArray( params[ k ] ) ) {
                    params[ k ].forEach( function ( v ) { body.append( k + '[]', v ); } );
                    return;
                }
                body.append( k, params[ k ] );
            } );
            return fetch( ajaxurl, { method: 'POST', credentials: 'same-origin', headers: { 'Content-Type': 'application/x-www-form-urlencoded' }, body: body.toString() } )
                .then( function ( r ) { return r.json(); } );
        }

        // ---- The folds this user last had open, per browser. A filtered page
        // renders its matches open and is left alone.
        var KEY = 'aobOptsetsOpen';
        function readOpen() { try { return JSON.parse( window.localStorage.getItem( KEY ) || '[]' ); } catch ( _ ) { return []; } }
        function writeOpen() {
            try {
                var open = [];
                wrap.querySelectorAll( '.bb-optgroup:not(.is-collapsed)' ).forEach( function ( g ) { open.push( g.getAttribute( 'data-group' ) || '' ); } );
                window.localStorage.setItem( KEY, JSON.stringify( open ) );
            } catch ( _ ) {}
        }
        function setFold( sec, collapsed ) {
            sec.classList.toggle( 'is-collapsed', collapsed );
            var c = sec.querySelector( '.bb-grp-caret' );
            if ( c ) { c.setAttribute( 'aria-expanded', collapsed ? 'false' : 'true' ); }
        }
        if ( ! FILTERING ) {
            var remembered = readOpen();
            wrap.querySelectorAll( '.bb-optgroup' ).forEach( function ( g ) {
                if ( remembered.indexOf( g.getAttribute( 'data-group' ) || '' ) > -1 ) { setFold( g, false ); }
            } );
        }

        wrap.addEventListener( 'click', function ( e ) {
            var head = e.target.closest ? e.target.closest( '.bb-optgroup-h' ) : null;
            if ( ! head ) { return; }
            // Controls that live IN the header do their own thing; the header
            // itself is the fold. The tag button joined this list the moment
            // it existed, because pressing it also opened the group.
            if ( e.target.closest( '.bb-grp-menuwrap, .bb-grp-nameedit, .bb-grp-tagadd, .bb-tag-row, a' ) ) { return; }
            var sec = head.closest( '.bb-optgroup' );
            setFold( sec, ! sec.classList.contains( 'is-collapsed' ) );
            writeOpen(); syncFoldAll();
        } );

        var foldAll = document.querySelector( '.bb-collapse-all' );
        function syncFoldAll() {
            if ( ! foldAll ) { return; }
            var open = 0;
            wrap.querySelectorAll( '.bb-optgroup' ).forEach( function ( g ) { if ( ! g.classList.contains( 'is-collapsed' ) ) { open++; } } );
            foldAll.textContent = open ? foldAll.getAttribute( 'data-say-collapse' ) : foldAll.getAttribute( 'data-say-expand' );
        }
        if ( foldAll ) {
            foldAll.addEventListener( 'click', function () {
                var anyOpen = false;
                wrap.querySelectorAll( '.bb-optgroup' ).forEach( function ( g ) { if ( ! g.classList.contains( 'is-collapsed' ) ) { anyOpen = true; } } );
                wrap.querySelectorAll( '.bb-optgroup' ).forEach( function ( g ) { setFold( g, anyOpen ); } );
                writeOpen(); syncFoldAll();
            } );
            syncFoldAll();
        }

        // The source filter applies itself; the search submits on Enter.
        var srcSel = document.getElementById( 'bb-set-source' );
        if ( srcSel ) {
            srcSel.addEventListener( 'change', function () {
                // Same narrowing, same one list: build the URL the form would
                // have submitted, then fetch it instead of navigating to it.
                var u = new URL( window.location.href );
                u.searchParams.set( 'page', 'addon-boss-option-sets' );
                u.searchParams.delete( 'paged' );
                if ( srcSel.value ) { u.searchParams.set( 'source', srcSel.value ); }
                else { u.searchParams.delete( 'source' ); }
                narrow( u.href );
            } );
        }

        // Typing filters THIS page instantly; Enter asks the whole library.
        // The hint under the box says so whenever the page is not the whole
        // story, so "no matches here" is never mistaken for "no matches".
        var search  = document.getElementById( 'bb-set-search' );
        var typeHint = document.getElementById( 'bb-set-typehint' );
        if ( search ) {
            search.addEventListener( 'input', function () {
                var q = search.value.trim().toLowerCase();
                var hits = [];
                wrap.querySelectorAll( '.bb-optgroup' ).forEach( function ( sec ) {
                    // The group's name keeps the whole group; otherwise only
                    // the sets that match show, as the server narrows on Enter.
                    var whole = ! q || ( sec.getAttribute( 'data-group' ) || '' ).toLowerCase().indexOf( q ) > -1;
                    var any   = false;
                    sec.querySelectorAll( '.bb-setcard' ).forEach( function ( card ) {
                        var hit = whole || ( card.getAttribute( 'data-search' ) || '' ).indexOf( q ) > -1;
                        card.style.display = hit ? '' : 'none';
                        if ( hit ) { any = true; }
                    } );
                    sec.style.display = ( whole || any ) ? '' : 'none';
                    if ( q && ( whole || any ) ) { hits.push( sec ); }
                    // The count says what is showing, as it does after Enter: it read
                    // "Ungrouped 288" over one match (fresh testers, 18 Oct 2026).
                    var cnt = sec.querySelector( '.bb-grp-count' );
                    if ( cnt ) {
                        if ( undefined === cnt.dataset.bbAll ) { cnt.dataset.bbAll = cnt.textContent; }
                        cnt.textContent = q ? String( [].filter.call( sec.querySelectorAll( '.bb-setcard' ), function ( c ) { return 'none' !== c.style.display; } ).length ) : cnt.dataset.bbAll;
                    }
                } );
                // Three groups or fewer open by themselves, and close again
                // when the search moves on; the folds the merchant set by hand
                // are not touched, nor remembered from here.
                var open = hits.length > 0 && hits.length <= 3;
                wrap.querySelectorAll( '.bb-optgroup[data-bb-searchopen]' ).forEach( function ( sec ) {
                    if ( ! open || hits.indexOf( sec ) < 0 ) { setFold( sec, true ); sec.removeAttribute( 'data-bb-searchopen' ); }
                } );
                if ( open ) {
                    hits.forEach( function ( sec ) {
                        if ( sec.classList.contains( 'is-collapsed' ) ) { setFold( sec, false ); sec.setAttribute( 'data-bb-searchopen', '1' ); }
                    } );
                }
                if ( typeHint ) { typeHint.hidden = ! q; }
                syncFoldAll();
            } );
        }

        function refresh() {
            wrap.querySelectorAll( '.bb-optgroup' ).forEach( function ( sec ) {
                var n = sec.querySelectorAll( '.bb-setcard' ).length;
                var c = sec.querySelector( '.bb-grp-count' ); if ( c ) { c.textContent = n; }
                sec.classList.toggle( 'is-empty', n === 0 );
            } );
        }

        // Attach-to-products disclosure (unchanged).
        wrap.addEventListener( 'click', function ( e ) {
            var t = e.target.closest ? e.target.closest( '.bb-bulk-toggle' ) : null;
            if ( ! t ) { return; }
            var form = t.closest( '.bb-setcard' ).querySelector( '.bb-bulkrow' );
            if ( form ) { form.hidden = ! form.hidden; t.setAttribute( 'aria-expanded', form.hidden ? 'false' : 'true' ); }
        } );

        // ---- One menu open at a time.
        function closeMenus() {
            document.querySelectorAll( '.bb-grp-menu:not([hidden])' ).forEach( function ( m ) { m.hidden = true; } );
            document.querySelectorAll( '.bb-grp-menu-btn[aria-expanded="true"], .bb-card-menu-btn[aria-expanded="true"]' ).forEach( function ( b ) { b.setAttribute( 'aria-expanded', 'false' ); } );
            var fl = document.querySelector( '.bb-card-menu' );
            if ( fl ) { fl.remove(); }
        }
        document.addEventListener( 'click', function ( e ) {
            if ( ! e.target.closest || ( ! e.target.closest( '.bb-grp-menuwrap' ) && ! e.target.closest( '.bb-card-menu' ) && ! e.target.closest( '.bb-card-menu-btn' ) ) ) { closeMenus(); }
        } );
        document.addEventListener( 'keydown', function ( e ) { if ( e.key === 'Escape' ) { closeMenus(); } } );

        wrap.addEventListener( 'click', function ( e ) {
            var btn = e.target.closest ? e.target.closest( '.bb-grp-menu-btn' ) : null;
            if ( ! btn ) { return; }
            var menu = btn.parentNode.querySelector( '.bb-grp-menu' );
            var open = menu && menu.hidden;
            closeMenus();
            if ( menu && open ) { menu.hidden = false; btn.setAttribute( 'aria-expanded', 'true' ); }
        } );

        // A name asked for in the house chrome, never the browser's own
        // prompt: one input, Enter or the button commits, Escape walks away.
        function askName( title, go, done, was ) {
            var ov = document.createElement( 'div' ); ov.className = 'bb-po-modal-ov';
            ov.innerHTML = '<div class="bb-po-modal" role="dialog" aria-modal="true"><p class="bb-po-modal-msg"></p><p class="bb-name-row"><input type="text" class="bb-grp-nameedit bb-name-input"></p><div class="bb-po-modal-acts"><button type="button" class="button bb-po-modal-keep bb-fd-ok"></button><button type="button" class="button bb-po-modal-cancel bb-fd-cancel"></button></div></div>';
            ov.querySelector( '.bb-po-modal-msg' ).textContent = title;
            ov.querySelector( '.bb-fd-ok' ).textContent = go;
            ov.querySelector( '.bb-fd-cancel' ).textContent = L.delCancel;
            var inp = ov.querySelector( '.bb-name-input' );
            inp.setAttribute( 'aria-label', L.name );
            // A rename starts from the name it has. Naming something NEW still
            // starts empty, because every caller before this passed nothing.
            if ( was ) { inp.value = was; }
            function close() { if ( ov.parentNode ) { ov.parentNode.removeChild( ov ); } document.removeEventListener( 'keydown', esc ); }
            function esc( ev ) { if ( ev.key === 'Escape' ) { close(); } }
            function commit() {
                var val = ( inp.value || '' ).trim();
                if ( ! val ) { inp.focus(); return; }
                close(); done( val );
            }
            ov.querySelector( '.bb-fd-ok' ).addEventListener( 'click', commit );
            ov.querySelector( '.bb-fd-cancel' ).addEventListener( 'click', close );
            inp.addEventListener( 'keydown', function ( ev ) { if ( ev.key === 'Enter' ) { ev.preventDefault(); commit(); } } );
            ov.addEventListener( 'click', function ( ev ) { if ( ev.target === ov ) { close(); } } );
            document.addEventListener( 'keydown', esc );
            document.body.appendChild( ov );
            inp.focus();
        }

        // ---- The offer when a set joins a group (unchanged endpoint).
        function offerToApply( item ) {
            var bar = document.createElement( 'div' );
            bar.className = 'bb-grp-offer';
            var msg = document.createElement( 'span' );
            msg.textContent = L.offer.replace( '%1$s', item.group ).replace( '%2$s', String( item.count ) ).replace( '%3$s', item.name );
            var yes = document.createElement( 'button' );
            yes.type = 'button'; yes.className = 'button button-primary';
            yes.textContent = L.offerYes.replace( '%s', String( item.count ) );
            var no = document.createElement( 'button' );
            no.type = 'button'; no.className = 'button-link'; no.textContent = L.offerNo;
            no.addEventListener( 'click', function () { bar.remove(); } );
            yes.addEventListener( 'click', function () {
                yes.disabled = true;
                post( { action: 'addon_boss_apply_set_to_group', set: item.set, group: item.group } )
                    .then( function ( j ) { bar.textContent = L.offerDone.replace( '%s', String( ( j && j.data && j.data.applied ) || 0 ) ); } )
                    .catch( function () { yes.disabled = false; } );
            } );
            bar.appendChild( msg ); bar.appendChild( yes ); bar.appendChild( no );
            wrap.insertBefore( bar, wrap.firstChild );
        }

        // ---- Move one set: the operation every route lands on.
        function moveSet( card, groupName, position, destSec, after ) {
            var params = { action: 'addon_boss_move_set', set: card.getAttribute( 'data-set-id' ), group: groupName };
            if ( typeof position === 'number' ) { params.position = String( position ); }
            post( params ).then( function ( j ) {
                if ( ! j || ! j.success ) { return; }
                if ( destSec ) {
                    var grid = destSec.querySelector( '.bb-setgrid' );
                    var ph   = grid.querySelector( '.bb-grp-empty' );
                    if ( ph ) { grid.insertBefore( card, ph ); } else { grid.appendChild( card ); }
                    setFold( destSec, false ); writeOpen();
                } else if ( typeof position !== 'number' ) {
                    // Moved to a group not on this page: the card leaves.
                    card.remove();
                }
                refresh(); syncFoldAll();
                if ( j.data && j.data.joined ) { j.data.joined.forEach( offerToApply ); }
                if ( after ) { after(); }
            } ).catch( function () {} );
        }

        // Drag stays for anyone who likes it, page-local by nature.
        var dragEl = null;
        wrap.addEventListener( 'dragstart', function ( e ) {
            var card = e.target.closest ? e.target.closest( '.bb-setcard' ) : null;
            if ( ! card ) { return; }
            dragEl = card; card.classList.add( 'is-dragging' );
            e.dataTransfer.effectAllowed = 'move';
            try { e.dataTransfer.setData( 'text/plain', card.getAttribute( 'data-set-id' ) ); } catch ( _ ) {}
        } );
        wrap.addEventListener( 'dragend', function () {
            if ( dragEl ) { dragEl.classList.remove( 'is-dragging' ); }
            dragEl = null;
            wrap.querySelectorAll( '.bb-drop-hi' ).forEach( function ( s ) { s.classList.remove( 'bb-drop-hi' ); } );
        } );
        wrap.addEventListener( 'dragover', function ( e ) {
            if ( ! dragEl ) { return; }
            var sec = e.target.closest ? e.target.closest( '.bb-optgroup' ) : null;
            if ( ! sec ) { return; }
            e.preventDefault(); e.dataTransfer.dropEffect = 'move';
            wrap.querySelectorAll( '.bb-drop-hi' ).forEach( function ( s ) { if ( s !== sec ) { s.classList.remove( 'bb-drop-hi' ); } } );
            sec.classList.add( 'bb-drop-hi' );
        } );
        wrap.addEventListener( 'drop', function ( e ) {
            if ( ! dragEl ) { return; }
            var sec = e.target.closest ? e.target.closest( '.bb-optgroup' ) : null;
            if ( ! sec ) { return; }
            e.preventDefault();
            sec.classList.remove( 'bb-drop-hi' );
            moveSet( dragEl, sec.classList.contains( 'is-ungrouped' ) ? '' : ( sec.getAttribute( 'data-group' ) || '' ), undefined, sec );
        } );

        // ---- The destination dialog Move to and Copy to share: the house
        // modal with a search box and every group in the library, never a
        // hundred buttons crammed into a dropdown. Click a group and the
        // verb happens; Enter takes the top match; a group made here comes
        // back flagged so the caller can follow it.
        function pickGroup( title, opts, done ) {
            var ov = document.createElement( 'div' ); ov.className = 'bb-po-modal-ov';
            ov.innerHTML = '<div class="bb-po-modal bb-pick-modal" role="dialog" aria-modal="true"><p class="bb-po-modal-msg"></p><p class="bb-name-row"><input type="search" class="bb-grp-nameedit bb-name-input bb-pick-find"></p><div class="bb-pick-list"></div><div class="bb-po-modal-acts"><button type="button" class="button bb-po-modal-cancel bb-fd-cancel"></button></div></div>';
            ov.querySelector( '.bb-po-modal-msg' ).textContent = title;
            ov.querySelector( '.bb-fd-cancel' ).textContent = L.delCancel;
            var find = ov.querySelector( '.bb-pick-find' );
            find.placeholder = L.findGroup; find.setAttribute( 'aria-label', L.findGroup );
            var list = ov.querySelector( '.bb-pick-list' );
            function close() { if ( ov.parentNode ) { ov.parentNode.removeChild( ov ); } document.removeEventListener( 'keydown', esc ); }
            function esc( ev ) { if ( ev.key === 'Escape' ) { close(); } }
            function secOf( group ) {
                var hit = null;
                wrap.querySelectorAll( '.bb-optgroup' ).forEach( function ( g ) {
                    var slug = g.classList.contains( 'is-ungrouped' ) ? '' : ( g.getAttribute( 'data-group' ) || '' );
                    if ( slug === group ) { hit = g; }
                } );
                return hit;
            }
            function entry( label, group, cls ) {
                var b = document.createElement( 'button' );
                b.type = 'button'; b.textContent = label; if ( cls ) { b.className = cls; }
                b.addEventListener( 'click', function () {
                    if ( '__new__' === group ) {
                        close();
                        askName( L.newGroup, L.newGroupGo, function ( name ) {
                            post( { action: 'addon_boss_group_op', op: 'create', group: name } ).then( function ( j ) {
                                if ( j && j.success ) { done( j.data.group, null, true ); }
                            } );
                        } );
                        return;
                    }
                    close(); done( group, secOf( group ), false );
                } );
                return b;
            }
            function fill( q ) {
                list.textContent = '';
                q = ( q || '' ).toLowerCase();
                GROUPS.forEach( function ( g ) {
                    if ( g === opts.skip ) { return; }
                    if ( q && g.toLowerCase().indexOf( q ) === -1 ) { return; }
                    list.appendChild( entry( g, g ) );
                } );
                list.appendChild( entry( L.newIn, '__new__', 'bb-menu-new' ) );
                if ( opts.ungrouped && ( ! q || L.ungrouped.toLowerCase().indexOf( q ) > -1 ) ) {
                    list.appendChild( entry( L.ungrouped, '', 'bb-menu-ung' ) );
                }
            }
            find.addEventListener( 'input', function () { fill( find.value ); } );
            find.addEventListener( 'keydown', function ( ev ) {
                if ( ev.key !== 'Enter' ) { return; }
                ev.preventDefault();
                var top = list.querySelector( 'button' );
                if ( top ) { top.click(); }
            } );
            fill( '' );
            ov.querySelector( '.bb-fd-cancel' ).addEventListener( 'click', close );
            ov.addEventListener( 'click', function ( ev ) { if ( ev.target === ov ) { close(); } } );
            document.addEventListener( 'keydown', esc );
            document.body.appendChild( ov );
            find.focus();
        }

        // ---- The set's own menu: three verbs, no crammed list. Move to and
        // Copy to open the picker above (the whole library searchable, so
        // pagination can never strand a destination); Position stays, the
        // pointer alternative the drag needs.
        wrap.addEventListener( 'click', function ( e ) {
            var btn = e.target.closest ? e.target.closest( '.bb-card-menu-btn' ) : null;
            if ( ! btn ) { return; }
            closeMenus();
            btn.setAttribute( 'aria-expanded', 'true' );
            var card  = btn.closest( '.bb-setcard' );
            var sec   = card.closest( '.bb-optgroup' );
            var here  = sec.classList.contains( 'is-ungrouped' ) ? '' : ( sec.getAttribute( 'data-group' ) || '' );
            var quoted = ( function () {
                var a = card.querySelector( 'h3 a' );
                return '\u201C' + ( a ? a.textContent.trim() : '' ) + '\u201D';
            } )();
            var menu = document.createElement( 'div' );
            menu.className = 'bb-card-menu';
            menu.setAttribute( 'role', 'menu' );

            function verb( label, run ) {
                var b = document.createElement( 'button' );
                b.type = 'button'; b.className = 'bb-menu-verb'; b.textContent = label;
                b.addEventListener( 'click', function () { closeMenus(); run(); } );
                menu.appendChild( b );
            }
            verb( L.moveTo + '\u2026', function () {
                pickGroup( L.moveTitle.replace( '%s', quoted ), { skip: here, ungrouped: '' !== here }, function ( group, destSec, made ) {
                    moveSet( card, group, undefined, destSec, made ? function () { window.location.reload(); } : null );
                } );
            } );
            verb( L.copyTo + '\u2026', function () {
                pickGroup( L.copyTitle.replace( '%s', quoted ), { ungrouped: true }, function ( group, destSec ) {
                    post( { action: 'addon_boss_copy_set', set: card.getAttribute( 'data-set-id' ), group: group } ).then( function ( j ) {
                        if ( ! j || ! j.success ) { return; }
                        // The copy is server-made; open the destination and
                        // let the reload draw its card.
                        if ( destSec ) { setFold( destSec, false ); writeOpen(); }
                        window.location.reload();
                    } ).catch( function () {} );
                } );
            } );

            // Position among this group's sets: type the place, press Enter.
            var cards = sec.querySelectorAll( '.bb-setcard' );
            var at    = Array.prototype.indexOf.call( cards, card );
            var pos   = document.createElement( 'div' );
            pos.className = 'bb-menu-pos';
            var posLab = document.createElement( 'span' );
            posLab.textContent = L.position;
            var posIn = document.createElement( 'input' );
            posIn.type = 'number'; posIn.min = '1'; posIn.max = String( cards.length );
            posIn.value = String( at + 1 );
            posIn.setAttribute( 'aria-label', L.position );
            var posOf = document.createElement( 'span' );
            posOf.className = 'bb-menu-ofn';
            posOf.textContent = L.ofN.replace( '%s', String( cards.length ) );
            posIn.addEventListener( 'keydown', function ( ev ) {
                if ( ev.key !== 'Enter' ) { return; }
                ev.preventDefault();
                var want = Math.max( 1, Math.min( parseInt( posIn.value, 10 ) || 1, cards.length ) ) - 1;
                moveSet( card, here, want, null );
                var grid = sec.querySelector( '.bb-setgrid' );
                var kids = grid.querySelectorAll( '.bb-setcard' );
                if ( want >= kids.length - 1 ) {
                    var ph = grid.querySelector( '.bb-grp-empty' );
                    grid.insertBefore( card, ph || null );
                } else {
                    var ref = kids[ want ];
                    if ( ref === card ) { ref = kids[ want + 1 ]; }
                    grid.insertBefore( card, ref );
                }
                closeMenus();
            } );
            pos.appendChild( posLab ); pos.appendChild( posIn ); pos.appendChild( posOf );
            menu.appendChild( pos );

            card.appendChild( menu );
            menu.querySelector( 'button' ).focus();
        } );

        // ---- "Used on N products" opens the products themselves, in the
        // same house dialog the pickers use: a search box answered by the
        // server, twenty a page with Show more, and the Products screen in
        // the footer for bulk work. One surface, whatever the scale.
        wrap.addEventListener( 'click', function ( e ) {
            var btn = e.target.closest ? e.target.closest( '.bb-setuse' ) : null;
            if ( ! btn ) { return; }
            var card  = btn.closest( '.bb-setcard' );
            var setId = card.getAttribute( 'data-set-id' );
            var name  = ( card.querySelector( 'h3 a' ) || { textContent: '' } ).textContent.trim();

            var ov = document.createElement( 'div' ); ov.className = 'bb-po-modal-ov';
            ov.innerHTML = '<div class="bb-po-modal bb-pick-modal bb-uses-modal" role="dialog" aria-modal="true"><p class="bb-po-modal-msg"></p><p class="bb-po-modal-sub"></p><p class="bb-name-row"><input type="search" class="bb-grp-nameedit bb-name-input bb-pick-find"></p><div class="bb-pick-list bb-uses-list"></div><p class="bb-uses-foot" hidden><a class="bb-setuse-all"></a></p><div class="bb-po-modal-acts"><button type="button" class="button bb-po-modal-cancel bb-fd-cancel"></button></div></div>';
            ov.querySelector( '.bb-po-modal-msg' ).textContent = '\u201C' + name + '\u201D';
            ov.querySelector( '.bb-po-modal-sub' ).textContent = btn.textContent;
            ov.querySelector( '.bb-fd-cancel' ).textContent = L.delCancel;
            var find = ov.querySelector( '.bb-pick-find' );
            find.placeholder = L.findProduct; find.setAttribute( 'aria-label', L.findProduct );
            var list = ov.querySelector( '.bb-uses-list' );
            var foot = ov.querySelector( '.bb-uses-foot' );

            function close() { if ( ov.parentNode ) { ov.parentNode.removeChild( ov ); } document.removeEventListener( 'keydown', esc ); }
            function esc( ev ) { if ( 'Escape' === ev.key ) { close(); } }

            var page = 1, query = '', timer = null;
            function load( append ) {
                post( { action: 'addon_boss_set_products', set: setId, q: query, page: page } ).then( function ( j ) {
                    if ( ! j || ! j.success ) { return; }
                    var old = list.querySelector( '.bb-uses-more' );
                    if ( old ) { old.remove(); }
                    if ( ! append ) { list.textContent = ''; }
                    ( j.data.items || [] ).forEach( function ( it ) {
                        var a = document.createElement( 'a' );
                        a.href = it.url; a.textContent = it.title;
                        list.appendChild( a );
                    } );
                    if ( ! list.childNodes.length ) {
                        var none = document.createElement( 'span' );
                        none.className = 'bb-uses-none'; none.textContent = L.noMatch;
                        list.appendChild( none );
                    } else if ( j.data.more ) {
                        var more = document.createElement( 'button' );
                        more.type = 'button'; more.className = 'bb-uses-more'; more.textContent = L.showMore;
                        more.addEventListener( 'click', function () { page += 1; load( true ); } );
                        list.appendChild( more );
                    }
                    var all = foot.querySelector( '.bb-setuse-all' );
                    all.href = j.data.all_url; all.textContent = j.data.all_label;
                    foot.hidden = false;
                } ).catch( function () {} );
            }
            find.addEventListener( 'input', function () {
                window.clearTimeout( timer );
                timer = window.setTimeout( function () {
                    query = find.value; page = 1; load( false );
                }, 300 );
            } );
            ov.querySelector( '.bb-fd-cancel' ).addEventListener( 'click', close );
            ov.addEventListener( 'click', function ( ev ) { if ( ev.target === ov ) { close(); } } );
            document.addEventListener( 'keydown', esc );
            document.body.appendChild( ov );
            find.focus();
            load( false );
        } );

        // ---- Group operations, each one named.
        function groupOf( el ) { return el.closest( '.bb-optgroup' ); }
        wrap.addEventListener( 'click', function ( e ) {
            var t = e.target.closest ? e.target.closest( '.bb-grp-dup, .bb-grp-emptyop, .bb-grp-rename' ) : null;
            if ( ! t ) { return; }
            var sec  = groupOf( t );
            var name = sec.getAttribute( 'data-group' ) || '';
            if ( t.classList.contains( 'bb-grp-dup' ) ) {
                post( { action: 'addon_boss_group_op', op: 'duplicate', group: name } ).then( function ( j ) {
                    if ( j && j.success ) { window.location.reload(); }
                } );
            } else if ( t.classList.contains( 'bb-grp-emptyop' ) ) {
                post( { action: 'addon_boss_group_op', op: 'empty', group: name } ).then( function ( j ) {
                    if ( j && j.success ) { window.location.reload(); }
                } );
            } else {
                closeMenus();
                startRename( sec );
            }
        } );

        // Rename in place: the menu starts it, a double-click still works.
        function startRename( sec ) {
            var nameEl = sec.querySelector( '.bb-grp-name' );
            if ( ! nameEl || sec.classList.contains( 'is-ungrouped' ) ) { return; }
            var was = nameEl.textContent;
            var inp = document.createElement( 'input' );
            inp.type = 'text'; inp.className = 'bb-grp-nameedit'; inp.value = was; inp.setAttribute( 'aria-label', L.name );
            nameEl.parentNode.replaceChild( inp, nameEl );
            inp.focus(); inp.select();
            var committed = false;
            function done() {
                if ( committed ) { return; }
                committed = true;
                var val  = ( inp.value || '' ).trim() || L.untitled;
                var span = document.createElement( 'span' );
                span.className = 'bb-grp-name'; span.title = L.rename; span.textContent = val;
                if ( inp.parentNode ) { inp.parentNode.replaceChild( span, inp ); }
                if ( val === was ) { return; }
                sec.setAttribute( 'data-group', val );
                post( { action: 'addon_boss_group_op', op: 'rename', group: was, to: val } ).then( function ( j ) {
                    if ( ! j || ! j.success ) { span.textContent = was; sec.setAttribute( 'data-group', was ); }
                } );
            }
            inp.addEventListener( 'blur', done );
            inp.addEventListener( 'keydown', function ( e ) { if ( e.key === 'Enter' ) { inp.blur(); } } );
        }
        wrap.addEventListener( 'dblclick', function ( e ) {
            var name = e.target.closest ? e.target.closest( '.bb-grp-name' ) : null;
            if ( name ) { startRename( groupOf( name ) ); }
        } );

        // Delete: the modal stays; the operation is named on confirm.
        wrap.addEventListener( 'click', function ( e ) {
            var del = e.target.closest ? e.target.closest( '.bb-grp-del' ) : null;
            if ( ! del ) { return; }
            closeMenus();
            var sec  = groupOf( del );
            var name = sec.getAttribute( 'data-group' ) || '';
            function doDelete( withSets ) {
                post( { action: 'addon_boss_group_op', op: 'delete', group: name, sets: withSets ? 1 : 0 } ).then( function ( j ) {
                    if ( j && j.success ) { window.location.reload(); }
                } );
            }
            // An empty group just goes; a full one is asked about, in the same
            // words a selection is asked in, by the same function.
            if ( ! sec.querySelector( '.bb-setcard' ) ) { doDelete( false ); return; }
            askGroupDelete( [ name ], doDelete );
            return;
            var ov = document.createElement( 'div' ); ov.className = 'bb-po-modal-ov';
            ov.innerHTML = '<div class="bb-po-modal" role="dialog" aria-modal="true"><p class="bb-po-modal-msg"></p><p class="bb-po-modal-sub"></p><div class="bb-po-modal-acts"><button type="button" class="button bb-po-modal-keep bb-fd-ok"></button><button type="button" class="button bb-po-modal-cancel bb-fd-cancel"></button></div></div>';
            ov.querySelector( '.bb-po-modal-msg' ).textContent = name ? ( '\u201C' + name + '\u201D' ) : L.delTitle;
            ov.querySelector( '.bb-po-modal-sub' ).textContent = L.delBody;
            ov.querySelector( '.bb-fd-ok' ).textContent = L.delOk;
            ov.querySelector( '.bb-fd-cancel' ).textContent = L.delCancel;
            function done() { if ( ov.parentNode ) { ov.parentNode.removeChild( ov ); } document.removeEventListener( 'keydown', esc ); }
            function esc( ev ) { if ( ev.key === 'Escape' ) { done(); } }
            ov.querySelector( '.bb-fd-ok' ).addEventListener( 'click', function () { doDelete(); done(); } );
            ov.querySelector( '.bb-fd-cancel' ).addEventListener( 'click', done );
            ov.addEventListener( 'click', function ( ev ) { if ( ev.target === ov ) { done(); } } );
            document.addEventListener( 'keydown', esc );
            document.body.appendChild( ov );
            ov.querySelector( '.bb-fd-ok' ).focus();
        } );

        // Make a new group: named on creation, then the page shows it where
        // it will actually live.
        var newBtn = document.querySelector( '.bb-newgroup' );
        if ( newBtn ) {
            newBtn.addEventListener( 'click', function () {
                askName( L.newGroup, L.newGroupGo, function ( name ) {
                    post( { action: 'addon_boss_group_op', op: 'create', group: name } ).then( function ( j ) {
                        if ( j && j.success ) { window.location.reload(); }
                    } );
                } );
            } );
        }

        refresh();
    } )();
    <?php } finally { addon_boss_inline_js( ob_get_clean() ); } ?>
    <?php
}

/**
 * The rows of the library, and nothing around them: exactly what lives inside
 * #bb-optgroups. The page prints this on arrival and the filter endpoint
 * returns the same string, so the two can never drift.
 *
 * @param array $view The library view.
 * @return string
 */
function addon_boss_option_library_rows_html( array $view ): string {
	ob_start();
	try {
		foreach ( $view['rows'] as $bb_row ) {
			addon_boss_render_option_set_group(
				(string) $bb_row['slug'],
				(string) $bb_row['label'],
				$bb_row['sets'],
				! empty( $bb_row['ungrouped'] ),
				array(
					'preview'   => $bb_row['preview'],
					'source'    => $bb_row['source'],
					'pos'       => $bb_row['pos'],
					'size'      => $view['total'],
					// A search that leaves three groups or fewer opens them, each
					// already narrowed to its matches. More stay closed: the
					// preview line carries the context, and a search that flings
					// twenty groups open is a wall, not an answer.
					'collapsed' => ! ( ! empty( $view['searching'] ) && count( $view['rows'] ) <= 3 ),
				)
			);
		}
		if ( ! $view['rows'] ) {
			echo '<p class="bb-setnomatch" id="bb-set-nomatch">' . esc_html__( 'No sets match. Clear the search to see them all.', 'addon-boss' ) . '</p>';
		}
	} finally {
		$bb_html = ob_get_clean();
	}
	return (string) $bb_html;
}

/**
 * The count, the per-page ladder and the pager.
 *
 * @param array    $view The library view.
 * @param callable $url  Builds a page URL carrying the whole current state.
 * @param int      $pp   The per-page in force.
 * @return string
 */
function addon_boss_option_library_nav_html( array $view, callable $url, int $pp ): string {
	// The sets, not the groups they sit in: three sets in Ungrouped read
	// "1 item" (blinds tester, 18 Oct 2026). A page holds groups, so the
	// ladder says groups.
	$bb_sets_n = (int) ( $view['set_count'] ?? $view['total'] );

	$bb_out  = '<div class="tablenav bb-optsets-nav">';
	$bb_out .= '<span class="displaying-num">' . esc_html( sprintf(
		/* translators: %s: how many option sets the list holds. */
		_n( '%s set', '%s sets', $bb_sets_n, 'addon-boss' ),
		number_format_i18n( $bb_sets_n )
	) ) . '</span>';
	$bb_out .= '<span class="bb-pp-wrap">' . esc_html__( 'Groups per page', 'addon-boss' ) . '<span class="bb-pp-segs">';
	foreach ( array( 10, 25, 50, 100 ) as $bb_n ) {
		$bb_out .= '<a' . ( $bb_n === $pp ? ' class="is-on" aria-current="true"' : '' ) . ' href="' . esc_url( $url( array( 'per_page' => $bb_n, 'paged' => 1 ) ) ) . '">' . (int) $bb_n . '</a>';
	}
	$bb_out .= '</span></span>';
	if ( $view['pages'] > 1 ) {
		$bb_links = paginate_links( array(
			'base'      => str_replace( '999999999', '%#%', esc_url_raw( $url( array( 'paged' => 999999999 ) ) ) ),
			'format'    => '',
			'current'   => (int) $view['paged'],
			'total'     => (int) $view['pages'],
			'mid_size'  => 2,
			'prev_text' => '&lsaquo;',
			'next_text' => '&rsaquo;',
		) );
		if ( $bb_links ) {
			$bb_out .= '<span class="bb-pg">' . wp_kses_post( $bb_links ) . '</span>';
		}
	}
	return $bb_out . '</div>';
}

/**
 * Narrow the library without rebuilding the admin around it.
 *
 * A chip, the source, a page number: each of those changes one list, and until
 * now each cost a whole page load — the menu, the styles, every screen this
 * admin draws, about six hundred milliseconds of it, to swap a list that takes
 * seventy. The controls stay real links, so nothing here is required; this
 * hands back the same markup the page would have printed, and the browser puts
 * it where the old list was.
 */
function addon_boss_option_library_filter_ajax(): void {
	if ( ! current_user_can( 'manage_woocommerce' ) ) {
		wp_send_json_error( array( 'why' => 'cap' ), 403 );
	}
	check_ajax_referer( 'addon_boss_option_library', 'nonce' );

	// phpcs:disable WordPress.Security.NonceVerification.Missing -- checked above.
	$bb_q      = isset( $_POST['s'] ) ? sanitize_text_field( wp_unslash( $_POST['s'] ) ) : '';
	$bb_source = isset( $_POST['source'] ) ? sanitize_text_field( wp_unslash( $_POST['source'] ) ) : '';
	$bb_paged  = isset( $_POST['paged'] ) ? max( 1, absint( $_POST['paged'] ) ) : 1;
	$bb_tag_on = isset( $_POST['bbtag'] ) ? array_values( array_filter( array_map( 'sanitize_key', (array) wp_unslash( $_POST['bbtag'] ) ) ) ) : array();
	$bb_pp     = isset( $_POST['per_page'] ) ? absint( $_POST['per_page'] ) : 0;
	$bb_colours = isset( $_POST['colours'] ) && 'todo' === sanitize_key( wp_unslash( $_POST['colours'] ) );
	// phpcs:enable
	// The same rules the page load uses, for the same reasons: a build that
	// offers no tags narrows by none, and a word that is gone must not narrow
	// to nothing with nothing on screen to say why.
	if ( ! addon_boss_library_tags_on() ) {
		$bb_tag_on = array();
	} elseif ( $bb_tag_on ) {
		$bb_known  = addon_boss_tags();
		$bb_tag_on = array_values( array_filter( $bb_tag_on, static function ( $bb_id ) use ( $bb_known ) {
			return isset( $bb_known[ $bb_id ] );
		} ) );
	}
	if ( in_array( $bb_pp, array( 10, 25, 50, 100 ), true ) ) {
		update_user_meta( get_current_user_id(), 'addon_boss_optsets_per_page', $bb_pp );
	} else {
		$bb_pp = (int) get_user_meta( get_current_user_id(), 'addon_boss_optsets_per_page', true );
		$bb_pp = in_array( $bb_pp, array( 10, 25, 50, 100 ), true ) ? $bb_pp : 25;
	}

	$bb_view = addon_boss_option_library_view( addon_boss_option_sets(), addon_boss_option_set_groups(), array(
		's'        => $bb_q,
		'source'   => $bb_source,
		'tags'     => $bb_tag_on,
		'paged'    => $bb_paged,
		'per_page' => $bb_pp,
		'colours'  => $bb_colours,
	) );

	$bb_url = static function ( array $over = array() ) use ( $bb_q, $bb_source, $bb_pp, $bb_tag_on, $bb_colours ) {
		$bb_args = array( 'page' => 'addon-boss-option-sets', 'per_page' => $bb_pp );
		if ( '' !== $bb_q ) {
			$bb_args['s'] = $bb_q;
		}
		if ( '' !== $bb_source ) {
			$bb_args['source'] = $bb_source;
		}
		if ( $bb_tag_on ) {
			$bb_args['bbtag'] = $bb_tag_on;
		}
		if ( $bb_colours ) {
			$bb_args['colours'] = 'todo';
		}
		return add_query_arg( array_merge( $bb_args, $over ), admin_url( 'admin.php' ) );
	};

	// The filter row and the menu come back rendered rather than being
	// reproduced in the browser. Which chip leads, which carries a cross, how
	// many offers are left over: those are layout rules, and a second copy of
	// them in JavaScript is a second copy to keep in step. It never is.
	$bb_carry = array( 's' => $bb_q, 'source' => $bb_source, 'per_page' => $bb_pp );
	if ( $bb_colours ) {
		$bb_carry['colours'] = 'todo';
	}
	$bb_furn = array( 'pill' => addon_boss_colour_need_pill( (int) $bb_view['colour_need'], $bb_colours, $bb_url ) );
	if ( addon_boss_library_tags_on() ) {
		$bb_furn['applied'] = addon_boss_tag_applied_row( $bb_tag_on, $bb_carry );
		$bb_furn['menu']    = addon_boss_tag_filter_control( $bb_tag_on, $bb_carry );
	}

	wp_send_json_success( array_merge( array(
		'rows'      => addon_boss_option_library_rows_html( $bb_view ),
		'nav'       => addon_boss_option_library_nav_html( $bb_view, $bb_url, $bb_pp ),
		'url'       => $bb_url( array( 'paged' => (int) $bb_view['paged'] ) ),
		'filtering' => ( '' !== $bb_q || '' !== $bb_source || $bb_tag_on || $bb_colours ) ? 1 : 0,
		'total'     => (int) $bb_view['total'],
	), $bb_furn ) );
}
add_action( 'wp_ajax_addon_boss_option_library', 'addon_boss_option_library_filter_ajax' );

/** The list: set cards + the starter shelf. */
function addon_boss_render_option_sets_list(): void {
	$sets = addon_boss_option_sets();
	echo '<div class="bb-optsets">';
	// A real page heading for screen-reader and skip-link navigation; the
	// visible brand header renders just below.
	echo '<h1 class="screen-reader-text">' . esc_html__( 'Option sets', 'addon-boss' ) . '</h1>';
	addon_boss_optsets_header(
		__( 'Option sets', 'addon-boss' ),
		// New set + New group sit together in the toolbar once sets exist; on
		// first run New set is the header's primary action beside the starter shelf.
		$sets ? '' : '<a href="' . esc_url( admin_url( 'admin.php?page=addon-boss-option-sets&set=new' ) ) . '" class="button bb-cta">' . esc_html__( 'New set', 'addon-boss' ) . '</a>'
	);
	echo '<p class="bb-lede">' . esc_html__( 'Build a list of choices once and reuse it everywhere. Attach a set to your products and every bundle that includes them offers it automatically, so you never rebuild the same colours or sizes for each product.', 'addon-boss' ) . '</p>';

	if ( $sets ) {
        // What the URL asks of the library. GET filters carry no nonce, the
        // same as every list table; each value is sanitised here, and the
        // per-page choice is remembered per user.
        // phpcs:disable WordPress.Security.NonceVerification.Recommended
        $bb_q      = isset( $_GET['s'] ) ? sanitize_text_field( wp_unslash( $_GET['s'] ) ) : '';
        $bb_source = isset( $_GET['source'] ) ? sanitize_text_field( wp_unslash( $_GET['source'] ) ) : '';
        $bb_paged  = isset( $_GET['paged'] ) ? max( 1, absint( $_GET['paged'] ) ) : 1;
        // Tags chosen from the chip bar. More than one NARROWS.
        $bb_tag_on = isset( $_GET['bbtag'] ) ? array_values( array_filter( array_map( 'sanitize_key', (array) wp_unslash( $_GET['bbtag'] ) ) ) ) : array();
        $bb_pp     = isset( $_GET['per_page'] ) ? absint( $_GET['per_page'] ) : 0;
        // Narrowed to the sets with a colour to pick (the pill under the tags).
        $bb_colours = isset( $_GET['colours'] ) && 'todo' === sanitize_key( wp_unslash( $_GET['colours'] ) );
        // phpcs:enable
        // A word that is gone narrows to nothing, and nothing is what the
        // screen then shows: no rows, and no chip to explain them, because the
        // row only draws chips for words it can name. A bookmark kept past a
        // deleted tag, or a merge, lands exactly there. Drop what we cannot
        // name and filter by the rest. A build that offers no tags narrows by
        // none: with no chip on screen, a tag kept in a link would hide groups
        // for a reason the merchant cannot see.
        if ( ! addon_boss_library_tags_on() ) {
            $bb_tag_on = array();
        } elseif ( $bb_tag_on ) {
            $bb_known  = addon_boss_tags();
            $bb_tag_on = array_values( array_filter( $bb_tag_on, static function ( $bb_id ) use ( $bb_known ) {
                return isset( $bb_known[ $bb_id ] );
            } ) );
        }
        if ( in_array( $bb_pp, array( 10, 25, 50, 100 ), true ) ) {
            update_user_meta( get_current_user_id(), 'addon_boss_optsets_per_page', $bb_pp );
        } else {
            $bb_pp = (int) get_user_meta( get_current_user_id(), 'addon_boss_optsets_per_page', true );
            $bb_pp = in_array( $bb_pp, array( 10, 25, 50, 100 ), true ) ? $bb_pp : 25;
        }
        $bb_view = addon_boss_option_library_view( $sets, addon_boss_option_set_groups(), array(
            's'        => $bb_q,
            'source'   => $bb_source,
            'tags'     => $bb_tag_on,
            'paged'    => $bb_paged,
            'per_page' => $bb_pp,
            'colours'  => $bb_colours,
        ) );
        // One URL builder, so every control carries the whole current state:
        // a filter NARROWS a search here, it never resets one.
        $bb_url = static function ( array $over = array() ) use ( $bb_q, $bb_source, $bb_pp, $bb_tag_on, $bb_colours ) {
            $bb_args = array( 'page' => 'addon-boss-option-sets', 'per_page' => $bb_pp );
            if ( '' !== $bb_q ) {
                $bb_args['s'] = $bb_q;
            }
            if ( '' !== $bb_source ) {
                $bb_args['source'] = $bb_source;
            }
            // Chosen tags travel with every other control. Turning to page two
            // of "Discontinued" must not quietly hand back the whole library.
            if ( $bb_tag_on ) {
                $bb_args['bbtag'] = $bb_tag_on;
            }
            if ( $bb_colours ) {
                $bb_args['colours'] = 'todo';
            }
            return add_query_arg( array_merge( $bb_args, $over ), admin_url( 'admin.php' ) );
        };

        echo '<form method="get" action="' . esc_url( admin_url( 'admin.php' ) ) . '" class="bb-optsets-toolbar">';
        echo '<input type="hidden" name="page" value="addon-boss-option-sets">';
        // Chosen tags ride the search with everything else. A GET form posts
        // only its own fields, so without these, pressing Enter on a narrowed
        // library silently threw the tags away and answered a question nobody
        // had asked. The links carry them through $bb_url; this is the same
        // job on the form side.
        foreach ( $bb_tag_on as $bb_on ) {
            echo '<input type="hidden" name="bbtag[]" value="' . esc_attr( $bb_on ) . '">';
        }
        // The same for "colours to pick": a search inside it stays inside it.
        if ( $bb_colours ) {
            echo '<input type="hidden" name="colours" value="todo">';
        }
        echo '<label class="bb-setsearch"><span class="bb-setsearch-ico" aria-hidden="true">&#128269;</span>';
        echo '<input type="search" id="bb-set-search" name="s" value="' . esc_attr( $bb_q ) . '" placeholder="' . esc_attr__( 'Search sets by name or by an option inside them', 'addon-boss' ) . '" aria-label="' . esc_attr__( 'Search option sets', 'addon-boss' ) . '"></label>';
        // A form with no submit button only submits on Enter while it holds a
        // single text field. The tags menu put a second one inside it, and the
        // search box went quiet: Enter did nothing at all, no error, no clue.
        // A real submit button restores it however many fields land here next.
        echo '<button type="submit" class="bb-setsearch-go screen-reader-text">' . esc_html__( 'Search', 'addon-boss' ) . '</button>';
        // The source filter appears once there is more than one place sets
        // come from, and a source with nothing under the current search is
        // not offered at all.
        $bb_bucket_names = array_keys( $bb_view['buckets'] );
        sort( $bb_bucket_names );
        if ( count( $bb_bucket_names ) > 1 || '' !== $bb_source ) {
            echo '<label class="bb-src-filter"><span class="bb-src-lab">' . esc_html__( 'Source:', 'addon-boss' ) . '</span>';
            echo '<select name="source" id="bb-set-source">';
            echo '<option value="">' . esc_html( sprintf( /* translators: %s: how many groups. */ __( 'All sources (%s)', 'addon-boss' ), number_format_i18n( $bb_view['searched'] ) ) ) . '</option>';
            foreach ( $bb_bucket_names as $bb_b ) {
                if ( 'none' === $bb_b ) {
                    continue;
                }
                echo '<option value="' . esc_attr( $bb_b ) . '"' . selected( $bb_source, $bb_b, false ) . '>' . esc_html( $bb_b . ' (' . number_format_i18n( (int) $bb_view['buckets'][ $bb_b ] ) . ')' ) . '</option>';
            }
            if ( isset( $bb_view['buckets']['none'] ) ) {
                echo '<option value="none"' . selected( $bb_source, 'none', false ) . '>' . esc_html( sprintf( /* translators: %s: how many groups. */ __( 'Not from a supplier (%s)', 'addon-boss' ), number_format_i18n( (int) $bb_view['buckets']['none'] ) ) ) . '</option>';
            }
            echo '</select></label>';
        }
        // Tags sits beside Source because they do the same job: narrow one list.
        // It used to be a wall of chips under the toolbar instead.
        if ( addon_boss_library_tags_on() ) {
            echo addon_boss_tag_filter_control( $bb_tag_on, array( // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- escaped within.
                's'        => $bb_q,
                'source'   => $bb_source,
                'per_page' => $bb_pp,
            ) );
        }
        echo '<a href="' . esc_url( admin_url( 'admin.php?page=addon-boss-option-sets&set=new' ) ) . '" class="button bb-cta bb-newset">' . esc_html__( '+ New set', 'addon-boss' ) . '</a>';
        echo '<button type="button" class="button bb-newgroup">' . esc_html__( '+ New group', 'addon-boss' ) . '</button>';
        // One press folds the whole library to its group headers (David, 23
        // Aug: at two hundred built products the list cannot be scanned open).
        echo '<button type="button" class="button bb-collapse-all" data-say-collapse="' . esc_attr__( 'Collapse all', 'addon-boss' ) . '" data-say-expand="' . esc_attr__( 'Expand all', 'addon-boss' ) . '">' . esc_html__( 'Expand all', 'addon-boss' ) . '</button>';
        echo '</form>';
        // The tag chips sit WITH the search, never as a tree down the side: on
        // a library of 253 garments a person searches for the one they want,
        // and tags answer the questions search cannot. What has been dropped,
        // what is new, what still needs looking at. Choosing two narrows to the
        // groups wearing both (his agreement, 6 September).
        if ( addon_boss_library_tags_on() ) {
            echo addon_boss_tag_applied_row( $bb_tag_on, array_merge( array( // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- escaped within.
                's'        => $bb_q,
                'source'   => $bb_source,
                'per_page' => $bb_pp,
            ), $bb_colours ? array( 'colours' => 'todo' ) : array() ) );
        }
        // Sets that lost their dots to a colour we could not find, one press
        // from a list of just those (the set editor says which choice).
        echo addon_boss_colour_need_pill( (int) $bb_view['colour_need'], $bb_colours, $bb_url ); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- escaped within.
        echo '<p class="bb-type-hint" id="bb-set-typehint" hidden>' . esc_html( sprintf(
            /* translators: %s: how many groups the whole library holds. */
            __( 'Filtering this page. Press Enter to search all %s groups.', 'addon-boss' ),
            number_format_i18n( (int) $bb_view['total'] )
        ) ) . '</p>';
        // The applied row says all of this with chips that come off, so the
        // sentence and its Reset would be a second, quieter answer to the same
        // question, one line below and clearing only some of it. Kept for the
        // build that has no applied row.
        if ( ! addon_boss_library_tags_on() && ( '' !== $bb_q || '' !== $bb_source ) ) {
            echo '<p class="subtitle bb-optsets-subtitle">';
            if ( '' !== $bb_q ) {
                printf(
                    /* translators: %s: what was searched for. */
                    esc_html__( 'Search results for: %s', 'addon-boss' ),
                    '<strong>' . esc_html( $bb_q ) . '</strong>'
                );
            } else {
                echo '<strong>' . esc_html( 'none' === $bb_source ? __( 'Not from a supplier', 'addon-boss' ) : $bb_source ) . '</strong>';
            }
            echo ' <a class="bb-optsets-reset" href="' . esc_url( add_query_arg( array( 'page' => 'addon-boss-option-sets', 'per_page' => $bb_pp ), admin_url( 'admin.php' ) ) ) . '">' . esc_html__( 'Reset', 'addon-boss' ) . '</a></p>';
        }
        addon_boss_render_sets_io( $sets );

        // A filtered page renders its matches OPEN (that is what was asked
        // for); an unfiltered page renders closed and the browser reopens
        // what this user last had open.
        $bb_filtering = ( '' !== $bb_q || '' !== $bb_source || $bb_tag_on || $bb_colours );
        echo '<div id="bb-optgroups"' . ( $bb_filtering ? ' data-filtering="1"' : '' ) . '>';
        echo addon_boss_option_library_rows_html( $bb_view ); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- escaped within.
        echo '</div>';
        echo addon_boss_option_library_nav_html( $bb_view, $bb_url, $bb_pp ); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- escaped within.
        if ( addon_boss_library_tags_on() ) {
            echo addon_boss_tag_bulk_bar(); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- escaped within.
        }

        addon_boss_option_sets_organise_script( array(
            'groups'    => $bb_view['group_names'],
            'filtering' => $bb_filtering,
        ) );
	} else {
		// First run: a real empty state above the shelf, which becomes the hero.
		echo '<div class="bb-optsets-empty">';
		echo '<h2>' . esc_html__( 'Add your first option set', 'addon-boss' ) . '</h2>';
		echo '<p>' . esc_html__( 'An option set is a reusable list of choices, like colours or sizes, that you attach to products. Start from a ready-made set below, or build your own.', 'addon-boss' ) . '</p>';
		// A variations shop's colours and sizes already exist as variations;
		// pitching generic starters first sends them the long way round.
		if ( wc_get_products( array( 'type' => 'variable', 'status' => 'publish', 'limit' => 1, 'return' => 'ids' ) ) ) {
			echo '<p class="bb-optsets-fromvars">' . wp_kses(
				sprintf(
					/* translators: %s: link to the AddOnBoss home screen carrying the variation checklist. */
					__( 'Selling with variations? Your colours and sizes already exist. <a href="%s">The variation checklist</a> can bring them over, stock and photos included.', 'addon-boss' ),
					esc_url( admin_url( 'admin.php?page=addon-boss' ) )
				),
				array( 'a' => array( 'href' => array() ) )
			) . '</p>';
		}
		// The first-product checklist's compact echo (and any other host note)
		// renders inside the empty state, so the blank library says where this
		// first set is heading.
		do_action( 'addon_boss_option_sets_empty_state' );
		echo '</div>';
		addon_boss_render_sets_io( $sets );
	}

	// The starter shelf. On first run it leads (open, primary Add buttons); once
	// the shop has its own sets it steps back into a collapsed disclosure. No
	// rival ships ready-made sets, so first-run leans into ours.
	$bb_names = array();
	foreach ( $sets as $bb_set ) {
		if ( isset( $bb_set['name'] ) ) {
			$bb_names[ (string) $bb_set['name'] ] = true;
		}
	}
	$starters = addon_boss_option_starter_sets();
	if ( $sets ) {
		echo '<details class="bb-shelf bb-shelf-disc">';
		echo '<summary class="bb-shelf-sum">' . esc_html__( 'Add a ready-made set', 'addon-boss' ) . '</summary>';
		echo '<div class="bb-shelf-body">';
		addon_boss_render_starter_cards( $starters, $bb_names );
		echo '</div></details>';
	} else {
		echo '<div class="bb-shelf bb-shelf-hero">';
		addon_boss_render_starter_cards( $starters, $bb_names );
		echo '<p class="bb-shelf-scratch">' . wp_kses_post(
			sprintf(
				/* translators: %s: a link labelled "Create a set from scratch" */
				__( 'Prefer to start clean? %s.', 'addon-boss' ),
				// Straight to the blank editor: this line PROMISES scratch, so it
				// skips the starting-points on-ramp the plain New set button opens.
				'<a href="' . esc_url( admin_url( 'admin.php?page=addon-boss-option-sets&set=new&recipe=scratch' ) ) . '">' . esc_html__( 'Create a set from scratch', 'addon-boss' ) . '</a>'
			)
		) . '</p>';
		echo '</div>';
	}

	// (The library import/export line renders up top now; see
	// addon_boss_render_sets_io.)

	echo '</div>';
}

/**
 * Move the whole library between stores, one quiet line. It lived at the
 * page's foot and nobody found it there (his call, 2 Sept); it now sits
 * under the toolbar, and on a blank shop right under the first-run hero,
 * where importing an existing library IS the likely first action.
 */
function addon_boss_render_sets_io( array $sets ): void {
	$export_url = wp_nonce_url( admin_url( 'admin-post.php?action=addon_boss_export_option_sets' ), 'addon_boss_export_option_sets' );
	// No surveyed export screen leads with a question, and naming one motive
	// (moving) undersold the others - a backup, staging to live, a file for
	// support. The sentence describes the artifact and the round-trip; the
	// import half carries the one fact that matters there, the update rule.
	$io_lead    = $sets
		? __( 'All sets export to one JSON file, ready to import on any store. Importing updates a set that is already here.', 'addon-boss' )
		: __( 'A sets file exported from another store imports here.', 'addon-boss' );
	echo '<div class="bb-sets-io bb-sets-io-top"><span class="bb-sets-io-lead">' . esc_html( $io_lead ) . '</span>';
	if ( $sets ) {
		echo '<a href="' . esc_url( $export_url ) . '" class="button">' . esc_html__( 'Export all sets', 'addon-boss' ) . '</a>';
	}
	echo '<form method="post" enctype="multipart/form-data" action="' . esc_url( admin_url( 'admin-post.php' ) ) . '" class="bb-sets-import-form">';
	echo '<input type="hidden" name="action" value="addon_boss_import_option_sets">';
	wp_nonce_field( 'addon_boss_import_option_sets' );
	echo '<label class="button bb-choose">' . esc_html__( 'Choose file…', 'addon-boss' );
	echo '<input type="file" name="bb_sets_file" accept="application/json,.json" required>';
	echo '</label>';
	echo '<span class="bb-choose-name"></span>';
	echo '<button type="submit" class="button">' . esc_html__( 'Import sets', 'addon-boss' ) . '</button>';
	echo '</form></div>';
	ob_start();
	try {
		?>
		document.querySelectorAll( '.bb-choose input[type=file]' ).forEach( function ( f ) {
			f.addEventListener( 'change', function () {
				var name = f.closest( 'form, p, div' ).querySelector( '.bb-choose-name' );
				if ( name && f.files.length ) { name.textContent = f.files[0].name; }
			} );
		} );
		<?php
	} finally {
		addon_boss_inline_js( ob_get_clean() );
	}
}

/**
 * The starter cards: a wrapping grid of ready-made sets. A starter already
 * imported (matched by name in $existing_names) reads as "Added" with a link to
 * the copy the shop owns, so a second click can never make a silent duplicate.
 */
function addon_boss_render_starter_cards( array $starters, array $existing_names ): void {
	echo '<div class="bb-shelfrow">';
	foreach ( $starters as $starter_id => $starter ) {
		$added = isset( $existing_names[ (string) $starter['name'] ] );
		echo '<div class="bb-starter' . ( $added ? ' is-added' : '' ) . '">';
		echo '<h4>' . esc_html( $starter['name'] ) . '</h4>';
		if ( ! empty( $starter['purpose'] ) ) {
			echo '<div class="bb-starter-purpose">' . esc_html( $starter['purpose'] ) . '</div>';
		}
		echo '<div class="bb-mini">';
		foreach ( array_slice( $starter['options'], 0, 12 ) as $opt ) {
			echo ! empty( $opt['swatch'] )
				? '<span class="bb-mini-dot" style="background:' . esc_attr( addon_boss_swatch_css( $opt ) ) . '"></span>'
				: '<span class="bb-mini-txt">' . esc_html( $opt['label'] ) . '</span>';
		}
		echo '</div>';
		echo '<div class="bb-starter-act">';
		if ( $added ) {
			$edit_url = admin_url( 'admin.php?page=addon-boss-option-sets&set=' . rawurlencode( addon_boss_option_set_id_by_name( (string) $starter['name'] ) ) );
			echo '<span class="bb-added">' . esc_html__( 'Added', 'addon-boss' ) . '</span>';
			echo '<a class="bb-added-edit" href="' . esc_url( $edit_url ) . '">' . esc_html__( 'Edit', 'addon-boss' ) . '</a>';
		} else {
			$url = wp_nonce_url( admin_url( 'admin-post.php?action=addon_boss_import_starter_set&starter=' . rawurlencode( $starter_id ) ), 'addon_boss_import_starter_set' );
			echo '<a href="' . esc_url( $url ) . '" class="button bb-cta">' . esc_html__( 'Add to my sets', 'addon-boss' ) . '</a>';
		}
		echo '</div></div>';
	}
	echo '</div>';
}

/**
 * A name inside quotes, so a list of names reads apart even where a name has
 * a comma of its own: “Glass size” and “Glass size (Clear Glass 8 mm)”.
 *
 * @param string $name A set's name.
 */
function addon_boss_quoted_name( $name ): string {
	/* translators: %s: a set's name, inside the language's own quotation marks */
	return sprintf( __( '“%s”', 'addon-boss' ), (string) $name );
}

/**
 * What a new list is for, when a measured set's part opened it with "+ New
 * list…" (for_part, for_set, for_what in the address): the crumb ("New list
 * for Edge polish (Glass size)"), the way back ("Back to Glass size"), a name
 * to start from, and whether the list prices the part. Empty otherwise.
 *
 * @return array<string,mixed>
 */
function addon_boss_new_list_for(): array {
	// phpcs:disable WordPress.Security.NonceVerification.Recommended -- read-only routing: what the new list was opened for, shown as words.
	$part = isset( $_GET['for_part'] ) ? sanitize_text_field( wp_unslash( $_GET['for_part'] ) ) : '';
	$set  = isset( $_GET['for_set'] ) ? sanitize_text_field( wp_unslash( $_GET['for_set'] ) ) : '';
	$what = isset( $_GET['for_what'] ) ? sanitize_key( wp_unslash( $_GET['for_what'] ) ) : '';
	$sid  = isset( $_GET['for_id'] ) ? preg_replace( '/[^A-Za-z0-9_\-]/', '', sanitize_text_field( wp_unslash( $_GET['for_id'] ) ) ) : '';
	// phpcs:enable WordPress.Security.NonceVerification.Recommended
	if ( '' === $part || '' === $set ) {
		return array();
	}
	return array(
		'crumb'    => sprintf(
			/* translators: 1: a part of a measured set, like Edge polish, 2: the set, like Glass size */
			__( 'Option sets / New list for %1$s (%2$s)', 'addon-boss' ),
			$part,
			$set
		),
		/* translators: %s: the set the new list was opened from, like Glass size */
		'back'     => sprintf( __( 'Back to %s', 'addon-boss' ), $set ),
		'back_url' => admin_url( 'admin.php?page=addon-boss-option-sets' . ( '' !== (string) $sid ? '&set=' . rawurlencode( (string) $sid ) : '' ) ),
		// A list of prices for a part starts named for it, as shoppers will
		// read it over the choices; a list of sides starts blank.
		'name'     => 'f' === $what ? $part : '',
		'priced'   => 'f' === $what,
		'set'      => $set,
	);
}

/**
 * The editor: name + option rows (drag to reorder; keys ride hidden inputs).
 *
 * A new set may arrive with a $seed: a recipe from the on-ramp, pre-filled but
 * unsaved, every row editable and nothing stored until Save. A stored set
 * ignores the seed entirely.
 */
function addon_boss_render_option_set_editor( string $id, ?array $seed = null ): void {
	$is_new = ( 'new' === $id );
	$set    = $is_new ? ( $seed ? $seed : array( 'name' => '', 'options' => array() ) ) : addon_boss_option_set( $id );
	if ( null === $set ) {
		echo '<p>' . esc_html__( 'That set no longer exists.', 'addon-boss' ) . '</p>';
		return;
	}
	wp_enqueue_script( 'jquery-ui-sortable' );

	echo '<div class="bb-optsets bb-ed2-edit">';
	echo '<h1 class="screen-reader-text">' . esc_html( $is_new ? __( 'New option set', 'addon-boss' ) : $set['name'] ) . '</h1>';
	echo '<form method="post" action="' . esc_url( admin_url( 'admin-post.php' ) ) . '" id="bb-option-set-form" class="bb-editor bb-ed2-card">';
	// The crumb bar sits on the card itself: where this set lives, and the
	// one way back to the list. A list made from a measured part's "+ New
	// list…" says what it is for, and the way back is to that set (walk 6).
	$bb_list_for = $is_new ? addon_boss_new_list_for() : array();
	addon_boss_optsets_header(
		$bb_list_for ? $bb_list_for['crumb'] : ( $is_new ? __( 'Option sets / New set', 'addon-boss' ) : sprintf( /* translators: %s: the option set's name */ __( 'Option sets / %s', 'addon-boss' ), $set['name'] ) ),
		$bb_list_for
			? '<a href="' . esc_url( $bb_list_for['back_url'] ) . '" class="button" data-bb-back-tab="1">' . esc_html( $bb_list_for['back'] ) . '</a>'
			: '<a href="' . esc_url( admin_url( 'admin.php?page=addon-boss-option-sets' ) ) . '" class="button">' . esc_html__( 'Back to sets', 'addon-boss' ) . '</a>'
	);
	if ( $bb_list_for ) {
		// Opened in its own tab by the set's editor, which is still open:
		// back closes this tab, and the set picks the new list up when it is
		// looked at again. Where the browser keeps the tab, the link goes on.
		echo '<script>document.addEventListener("click",function(e){var a=e.target.closest?e.target.closest("[data-bb-back-tab]"):null;if(!a){return;}window.close();},true);</script>';
		if ( '' === (string) ( $set['name'] ?? '' ) ) {
			$set['name'] = $bb_list_for['name'];
		}
	}
	wp_nonce_field( 'addon_boss_save_option_set_form' );
	echo '<input type="hidden" name="action" value="addon_boss_save_option_set_form">';
	echo '<input type="hidden" name="set_id" value="' . esc_attr( $is_new ? '' : $id ) . '">';

	addon_boss_editor_sec_open( 'set', __( 'Set', 'addon-boss' ) );
	echo '<div class="bb-ed2-namerow">';
	// The name is the heading shoppers read over the choices and in the cart,
	// so its example is a heading, by kind, and the line under it says so
	// (fresh testers, 18 Oct 2026: "I would have typed Size").
	$bb_ph  = array(
		'choices'  => __( 'Colour', 'addon-boss' ),
		'table'    => __( 'Size', 'addon-boss' ),
		'measured' => __( 'Banner size', 'addon-boss' ),
	);
	$bb_now = (string) ( $set['kind'] ?? 'choices' );
	echo '<input type="text" class="bb-edname" name="set_name" required aria-label="' . esc_attr__( 'Set name', 'addon-boss' ) . '" aria-describedby="bb-edname-say" value="' . esc_attr( $set['name'] ) . '" placeholder="' . esc_attr( $bb_ph[ $bb_now ] ?? $bb_ph['choices'] ) . '"';
	foreach ( $bb_ph as $bb_pk => $bb_pv ) {
		echo ' data-ph-' . esc_attr( $bb_pk ) . '="' . esc_attr( $bb_pv ) . '"';
	}
	echo '>';
	$bb_heading = trim( (string) ( $set['label'] ?? '' ) );
	if ( '' !== $bb_heading && $bb_heading !== (string) $set['name'] ) {
		/* translators: %s: the heading shoppers read, e.g. Colour */
		$bb_name_say = sprintf( __( 'Shoppers see “%s” on the product page and in the cart.', 'addon-boss' ), $bb_heading );
	} else {
		$bb_name_say = __( 'Shoppers see this name on the product page and in the cart.', 'addon-boss' );
	}
	// A set opened from a group's own menu arrives already filed there. New
	// sets only; the value is validated on save.
	if ( $is_new && isset( $_GET['group'] ) ) { // phpcs:ignore WordPress.Security.NonceVerification.Recommended -- a prefill for the form, sanitised on the way through and validated on save.
		echo '<input type="hidden" name="bb_new_group" value="' . esc_attr( sanitize_text_field( wp_unslash( $_GET['group'] ) ) ) . '">'; // phpcs:ignore WordPress.Security.NonceVerification.Recommended
	}
	// A set opened from a product's own link goes back to that product,
	// attached, when its tab is looked at again (addon_boss_attach_menu_ajax).
	$bb_for = $is_new ? addon_boss_for_product_param() : 0;
	if ( $bb_for ) {
		echo '<input type="hidden" name="bb_for_product" value="' . esc_attr( (string) $bb_for ) . '">';
	}
	echo '</div>';
	echo '<p class="bb-cquiet bb-edname-say" id="bb-edname-say"><span class="bb-edname-text">' . esc_html( $bb_name_say ) . '</span>';
	// Words of their own (a copy keeps the heading shoppers read; a supplier
	// feed writes one): one click shows the set's name instead, from the next
	// save, and one more puts the words back. Both named, so the owner knows
	// which words the page will show (walk 6, 30 Oct 2026).
	if ( '' !== $bb_heading && $bb_heading !== (string) $set['name'] ) {
		/* translators: %s: a name shoppers could see instead, like Glass size */
		$bb_show = __( 'Show “%s” instead', 'addon-boss' );
		/* translators: %s: the heading shoppers read, e.g. Colour */
		$bb_sees = __( 'Shoppers see “%s” on the product page and in the cart.', 'addon-boss' );
		echo ' <button type="button" class="button-link bb-edname-own" data-heading="' . esc_attr( $bb_heading ) . '" data-say="' . esc_attr( $bb_sees ) . '" data-show="' . esc_attr( $bb_show ) . '">' . esc_html( sprintf( $bb_show, (string) $set['name'] ) ) . '</button>'
			. '<input type="hidden" name="set_label" value="" disabled>';
		ob_start();
		?>
		( function () {
			var b = document.querySelector( '.bb-edname-own' );
			if ( ! b ) { return; }
			var p = b.parentNode, f = p.querySelector( 'input[name="set_label"]' ), t = p.querySelector( '.bb-edname-text' );
			var n = document.querySelector( 'input[name="set_name"]' ), own = false;
			var name = function () { return n && n.value.trim() ? n.value.trim() : ''; };
			var put = function ( tpl, s ) { return String( tpl ).replace( '%s', s ); };
			var draw = function () {
				var h = b.getAttribute( 'data-heading' );
				t.textContent = put( b.getAttribute( 'data-say' ), own ? name() : h );
				b.textContent = put( b.getAttribute( 'data-show' ), own ? h : name() );
			};
			b.addEventListener( 'click', function () {
				own = ! own;
				// Posted empty, the set's name is what shoppers read; not posted,
				// the words of its own stay.
				f.disabled = ! own;
				draw();
				f.dispatchEvent( new Event( 'change', { bubbles: true } ) );
			} );
			if ( n ) { n.addEventListener( 'input', function () { draw(); } ); }
		}() );
		<?php
		addon_boss_inline_js( (string) ob_get_clean() );
	}
	echo '</p>';
	$usage = $is_new ? 0 : addon_boss_option_set_usage( $id );


	// The set's kind. The engine's own is a list of choices; each registered
	// kind adds its own option to this menu and prints its own panel below. A
	// stored kind this build has no module for stays on the menu, named
	// plainly, so a save reposts it rather than quietly turning the set into a
	// plain list; its payload rides through that save untouched.
	$kind  = (string) ( $set['kind'] ?? 'choices' );
	$kinds = addon_boss_option_set_kinds();
	echo '<div class="bb-edkind' . ( 'choices' !== $kind ? ' bb-kind-' . esc_attr( $kind ) : '' ) . '">';
	echo '<label>' . esc_html__( 'This set is', 'addon-boss' ) . ' ';
	echo '<select name="set_kind" id="bb-set-kind" class="bb-seg-auto">';
	$bb_menu = $kinds;
	if ( ! isset( $bb_menu[ $kind ] ) ) {
		$bb_menu[ $kind ] = array(
			'label'        => $kind,
			'uses_options' => true,
		);
	}
	foreach ( $bb_menu as $bb_k => $bb_spec ) {
		echo '<option value="' . esc_attr( $bb_k ) . '"' . selected( $bb_k, $kind, false )
			. ' data-desc="' . esc_attr( (string) ( $bb_spec['desc'] ?? '' ) ) . '"'
			. ' data-uses-options="' . ( empty( $bb_spec['uses_options'] ) ? '0' : '1' ) . '"'
			. ( empty( $bb_spec['own_sections'] ) ? '' : ' data-own-sections="1"' ) . '>'
			. esc_html( (string) ( $bb_spec['label'] ?? $bb_k ) ) . '</option>';
	}
	echo '</select></label>';
	// A new set can still go back to the templates: nothing is saved yet.
	if ( $is_new ) {
		echo '<a class="bb-ed2-tpl" href="' . esc_url( admin_url( 'admin.php?page=addon-boss-option-sets&set=new' . ( $bb_for ? '&for_product=' . $bb_for : '' ) ) ) . '">' . esc_html__( 'Start from a template', 'addon-boss' ) . '</a>';
	}
	if ( $usage ) {
		/* translators: %d: number of products */
		echo '<span class="bb-edlive">' . esc_html( sprintf( _n( 'Used on %d product', 'Used on %d products', $usage, 'addon-boss' ), $usage ) ) . '</span>';
	}
	echo '</div>';
	// Say what each kind is FOR, right at the fork, so a merchant who wants
	// flat per-item prices reaches for choices and one who sells by size
	// reaches for the kind that does. The first paint is the server's, so the
	// line is there before a script runs; the editor script keeps it in step
	// with the menu from the picked option's own words.
	echo '<p class="bb-kind-desc" id="bb-kind-desc">' . esc_html( (string) ( $bb_menu[ $kind ]['desc'] ?? '' ) ) . '</p>';
	addon_boss_editor_sec_close();

	// A kind whose editor draws whole sections of its own (the redesigned
	// editors, own_sections) prints them here, outside any section. Its
	// wrapper wears data-bb-kind-panel="<kind>" like any panel, so the picker
	// shows exactly one kind at a time.
	$bb_own = ! empty( $bb_menu[ $kind ]['own_sections'] );
	// A stored set is keyed by its id and does not carry it, so the kind
	// editors are handed it here: without it they cannot find the products
	// the set is on ('' for a set not saved yet).
	$bb_kset       = $set;
	$bb_kset['id'] = $is_new ? '' : $id;
	foreach ( $kinds as $bb_spec ) {
		if ( ! empty( $bb_spec['own_sections'] ) && is_callable( $bb_spec['editor'] ?? null ) ) {
			call_user_func( $bb_spec['editor'], $bb_kset, $kind );
		}
	}
	// Every other kind's panel, printed by the module that owns it, in the
	// section that prices a set off its own panel. The section hides with
	// nothing in it: a list of choices prices each choice on its row, and a
	// kind with its own sections priced itself above.
	addon_boss_editor_sec_open(
		'price',
		__( 'Price', 'addon-boss' ),
		__( 'How one item is priced', 'addon-boss' ),
		array(
			'data-bb-kind-sec' => 'priced',
			'hidden'           => 'choices' === $kind || $bb_own,
		)
	);
	addon_boss_editor_print_vat_line();
	foreach ( $kinds as $bb_spec ) {
		if ( empty( $bb_spec['own_sections'] ) && is_callable( $bb_spec['editor'] ?? null ) ) {
			call_user_func( $bb_spec['editor'], $bb_kset, $kind );
		}
	}
	addon_boss_editor_sec_close();

	// D1: the swatch shape, a display-only choice for a list of choices. The
	// seg shows the shape the set will ACTUALLY use (the resolved default
	// while the merchant has never chosen); only a real click writes the
	// hidden explicit field, so the photo-card auto preference survives
	// every unrelated save instead of dying to a phantom "square".
	$bb_shape_now      = addon_boss_option_set_shape( $set );
	$bb_shape_explicit = (string) ( $set['shape'] ?? '' );
	// The list-of-choices settings print into two sections, Picking and Look,
	// which come AFTER the choices themselves (the order a merchant thinks
	// in: what is offered, then how it is picked, then how it looks). The
	// markup is captured here and placed below the rows.
	ob_start();
	echo '<div class="bb-cseg bb-shape-seg" id="bb-shape-seg" role="radiogroup" aria-label="' . esc_attr__( 'Swatch shape', 'addon-boss' ) . '">';
	$bb_shapes = array(
		'square' => __( 'Square', 'addon-boss' ),
		'circle' => __( 'Circle', 'addon-boss' ),
		'card'   => __( 'Photo card', 'addon-boss' ),
	);
	foreach ( $bb_shapes as $bb_sv => $bb_sl ) {
		echo '<label class="bb-seg' . ( $bb_shape_now === $bb_sv ? ' is-on' : '' ) . '"><input type="radio" name="__bb_set_shape" value="' . esc_attr( $bb_sv ) . '"' . checked( $bb_shape_now, $bb_sv, false ) . '> ' . esc_html( $bb_sl ) . '</label>';
	}
	echo '</div>';
	echo '<input type="hidden" name="set_shape" id="bb-set-shape" value="' . esc_attr( $bb_shape_explicit ) . '">';
	// A look the set was never told is said as chosen for it, and a card with
	// no photo of its own is counted: "Look changed itself to Photo card", and
	// the choice without a photo read as broken on the shop (fresh tester,
	// 18 Oct 2026).
	echo '<p class="bb-cquiet bb-shape-auto" id="bb-shape-auto" hidden'
		. ' data-auto="' . esc_attr__( 'Chosen for you, because a choice has a photo.', 'addon-boss' ) . '"'
		. ' data-one="' . esc_attr(
			/* translators: %d: how many choices have no photo */
			_n( '%d choice has no photo yet and shows an empty card.', '%d choices have no photo yet and show an empty card.', 1, 'addon-boss' )
		) . '"'
		. ' data-many="' . esc_attr(
			/* translators: %d: how many choices have no photo */
			_n( '%d choice has no photo yet and shows an empty card.', '%d choices have no photo yet and show an empty card.', 2, 'addon-boss' )
		) . '"></p>';
	/*
	 * A picture that will never be drawn, said where the picture was added.
	 *
	 * The product panel has warned about this for as long as a photo could be
	 * pinned per product. Pictures now live on the set itself, so the set
	 * editor is where a merchant attaches them and where the silence bites: a
	 * set someone once clicked Square or Circle on keeps every picture and
	 * shows none of them, with nothing on this screen saying so. The same
	 * sentence as the product panel, plus the one click that fixes it, on the
	 * screen the merchant is already looking at.
	 */
	$bb_pin_photo = false;
	foreach ( (array) ( $set['options'] ?? array() ) as $bb_o ) {
		if ( ! empty( $bb_o['image_id'] ) ) {
			$bb_pin_photo = true;
			break;
		}
	}
	$bb_pin_flat = in_array( $bb_shape_explicit, array( 'square', 'circle' ), true );
	// Unless picking a choice puts its photo on the product: then customers
	// do see it, and the warning said they never did (set_f08868ce51, fresh
	// tester, 18 Oct 2026). The switch shown is the one for One or Several.
	$bb_can_pick = (bool) has_action( 'addon_boss_option_photo_controls' );
	$bb_swaps    = ! isset( $set['photo_swaps'] ) || ! empty( $set['photo_swaps'] );
	$bb_latest   = ! empty( $set['photo_latest'] );
	$bb_many     = ! empty( $set['multi'] );
	$bb_shown    = $bb_can_pick && ( $bb_many ? $bb_latest : $bb_swaps );
	echo '<p class="bb-calert bb-shape-warn" id="bb-shape-warn"' . ( $bb_pin_flat && $bb_pin_photo && ! $bb_shown ? '' : ' hidden' ) . '>';
	echo '<span>' . esc_html__( 'These choices have photos, but swatches are on, so customers never see them.', 'addon-boss' ) . '</span>';
	echo '<button type="button" class="bb-cbtn bb-shape-warn-fix" id="bb-shape-warn-fix">' . esc_html__( 'Show photo cards', 'addon-boss' ) . '</button>';
	echo '</p>';
	/*
	 * And the same silence the other way round, which is the one a merchant
	 * reports as a bug.
	 *
	 * Photo card over choices that have no picture falls back to a plain
	 * swatch, everywhere it is drawn: each choice asks for its photograph and
	 * takes a swatch dot when there is none. Nothing said so. So the setting
	 * reads as chosen, the storefront shows swatches, and picking a colour
	 * cannot change a photograph that was never attached, which arrived twice
	 * as "photo card is selected and it's showing the swatches" and "it doesn't
	 * change to that image" (24 September, on an eighteen-colour sweatshirt
	 * whose set carried image_id 0 on every choice).
	 *
	 * Only where a picker exists, which is the paid build: a build that cannot
	 * attach a photograph must not ask for one.
	 */
	$bb_pin_card = 'card' === $bb_shape_explicit && $bb_can_pick;
	echo '<p class="bb-calert bb-photo-missing" id="bb-photo-missing"'
		. ' data-bb-pickable="' . ( $bb_can_pick ? '1' : '' ) . '"'
		. ( $bb_pin_card && ! $bb_pin_photo ? '' : ' hidden' ) . '>';
	echo '<span>' . esc_html__( 'Photo card is on, but no choice has a photo yet, so customers see plain swatches. Add a photo in each choice\'s Details.', 'addon-boss' ) . '</span>';
	echo '</p>';

	// 🔴 THE FOUNDING CUSTOMER, 2 Sept 2026: "is there something to say I don't want to change
	// the main image to the selected option?" There was not. A photo on a
	// pick-one choice always replaced the product's main image, and for a
	// colour set that is the whole point: pick blue, see the blue shirt.
	//
	// But a set like Cutting options carries pictures that EXPLAIN the choice
	// rather than pictures of the product. Swapping a photograph of the panel
	// for a diagram of a corner radius tells a shopper their acrylic panel is
	// now a line drawing. The module already reasons this way for several-of
	// sets, where three picks fought over one gallery; a pick-one set of
	// diagrams has the same character and no way to say so. Now it has one.
	//
	// Ticked by default and when absent, so no existing set moves. Only a
	// build that can swap the product photo offers the switch; any other
	// carries the stored answer through its save untouched.
	//
	// A several-of set has its own switch, off until the shop turns it on:
	// with several picks, the latest one's photo shows. Its own key, so a
	// several-of set saved before it (whose pick-one switch reads on when
	// absent) keeps its photo exactly as it was. One of the two shows at a
	// time, following One / Several; both always post. (Both read above.)
	if ( $bb_can_pick ) {
		echo '<div class="bb-cgroup" id="bb-photo-one"' . ( $bb_many ? ' hidden' : '' ) . '>';
		addon_boss_editor_toggle(
			'<input type="checkbox" name="set_photo_swaps" value="1"' . checked( $bb_swaps, true, false ) . '>',
			__( 'Picking a choice changes the product photo', 'addon-boss' ),
			__( 'Turn on when each photo shows the product itself, like a colour.', 'addon-boss' )
		);
		echo '</div><div class="bb-cgroup" id="bb-photo-many"' . ( $bb_many ? '' : ' hidden' ) . '>';
		// Off, its line says what off does, so a set flipped to Several does
		// not read as having lost its photos: print positions with diagrams
		// took the product photo over by default (workwear tester, 18 Oct 2026).
		addon_boss_editor_toggle(
			'<input type="checkbox" name="set_photo_latest" value="1"' . checked( $bb_latest, true, false ) . '>',
			__( 'Picking a choice changes the product photo', 'addon-boss' ),
			__( 'With several picks, the latest photo shows.', 'addon-boss' ),
			__( 'Off: with several picks, the product photo stays as it is.', 'addon-boss' ),
			$bb_latest
		);
		echo '</div>';
	} else {
		if ( $bb_swaps ) {
			echo '<input type="hidden" name="set_photo_swaps" value="1">';
		}
		if ( $bb_latest ) {
			echo '<input type="hidden" name="set_photo_latest" value="1">';
		}
	}
	// The storefront stock display: on shows "Only 2 left" and "Sold out"; off
	// hides the numbers and simply drops a sold-out choice. The oversell guard is
	// independent of this and always on. A build without the plan prints
	// nothing here at all: it cannot offer the feature, so it does not
	// advertise it either.
	if ( addon_boss_option_stock_enabled() ) {
		$bb_show_stock = ! isset( $set['show_stock'] ) || ! empty( $set['show_stock'] );
		addon_boss_editor_toggle(
			'<input type="hidden" name="set_show_stock" value="0"><input type="checkbox" name="set_show_stock" value="1"' . checked( $bb_show_stock, true, false ) . '>',
			__( 'Show stock numbers and sold-out choices', 'addon-boss' ),
			__( 'Low stock shows as "Only 2 left", and a sold-out choice as "Sold out".', 'addon-boss' ),
			__( 'Stock numbers stay hidden and sold-out choices are left out.', 'addon-boss' ),
			$bb_show_stock
		);
	}
	// D6: long lists switch themselves to a searchable dropdown on the
	// product page; this pin keeps the buttons for this set regardless.
	addon_boss_editor_toggle(
		'<input type="checkbox" name="set_pin_chips" value="1"' . checked( ! empty( $set['pin_chips'] ), true, false ) . '>',
		__( 'Keep buttons for long lists', 'addon-boss' ),
		sprintf(
			/* translators: %s: how many choices fit before the switch, e.g. 12 */
			__( 'Over %s choices become a searchable dropdown. Turn on to keep them as buttons.', 'addon-boss' ),
			number_format_i18n( ADDON_BOSS_CHIP_LIST_THRESHOLD )
		)
	);
	$bb_look_html = (string) ob_get_clean();
	ob_start();
	// Several-of: turn the set from pick-one into pick-many, with optional
	// bounds that only appear once "several" is on. The line under it quotes
	// the words customers will read, from the same function the product page
	// uses, so the two never disagree.
	$bb_is_multi = ! empty( $set['multi'] );
	echo '<div class="bb-cseg bb-multi-seg" id="bb-multi-seg" role="radiogroup" aria-label="' . esc_attr__( 'Customers choose', 'addon-boss' ) . '">';
	echo '<label class="bb-seg' . ( $bb_is_multi ? '' : ' is-on' ) . '"><input type="radio" name="set_multi" value=""' . checked( $bb_is_multi, false, false ) . '> ' . esc_html__( 'One', 'addon-boss' ) . '</label>';
	echo '<label class="bb-seg' . ( $bb_is_multi ? ' is-on' : '' ) . '"><input type="radio" name="set_multi" value="1"' . checked( $bb_is_multi, true, false ) . '> ' . esc_html__( 'Several', 'addon-boss' ) . '</label>';
	echo '</div>';
	echo '<div class="bb-multi-bounds" id="bb-multi-bounds"' . ( $bb_is_multi ? '' : ' hidden' ) . '>';
	echo '<label class="bb-multi-bound">' . esc_html__( 'At least', 'addon-boss' )
		. ' <input type="number" name="set_min" min="0" max="100" step="1" value="' . esc_attr( (int) ( $set['min'] ?? 0 ) > 0 ? (string) (int) $set['min'] : '' ) . '" placeholder="' . esc_attr__( 'any', 'addon-boss' ) . '"></label>';
	echo '<label class="bb-multi-bound">' . esc_html__( 'Up to', 'addon-boss' )
		. ' <input type="number" name="set_max" min="0" max="100" step="1" value="' . esc_attr( (int) ( $set['max'] ?? 0 ) > 0 ? (string) (int) $set['max'] : '' ) . '" placeholder="' . esc_attr__( 'any', 'addon-boss' ) . '"></label>';
	echo '</div>';
	// The set's own bounds, then what a product that requires it prints:
	// required or optional is each product's to say, as the Shop page card
	// beside it reads it.
	$bb_cfacts = addon_boss_choices_facts_data( $is_new ? '' : $id );
	echo '<p class="bb-cquiet" id="bb-pick-say">' . esc_html( addon_boss_editor_pick_say( $bb_is_multi, (int) ( $set['min'] ?? 0 ), (int) ( $set['max'] ?? 0 ) ) ) . '</p>';
	// Controls that only mean something on a several-of set print here, under
	// the bounds, and mind the same One/Several switch themselves.
	do_action( 'addon_boss_set_editor_multi', $set );
	$bb_pick_html = (string) ob_get_clean();

	// What customers pick from: the rows of a list of choices. A kind without
	// rows, or one that draws its own (a measured size's Sizes), hides the
	// section from the first paint.
	addon_boss_editor_sec_open(
		'rows',
		__( 'Choices', 'addon-boss' ),
		__( 'What customers pick from', 'addon-boss' ),
		array(
			'id'     => 'bb-sec-rows',
			'hidden' => empty( $bb_menu[ $kind ]['uses_options'] ) || $bb_own,
		)
	);
	if ( 'choices' === $kind ) {
		addon_boss_editor_print_vat_line();
		// A list another set prices choice by choice (a measured glass priced
		// by its edge finish): an amount in Adds is charged on top of that
		// price. £0.80 typed here added a silent £0.67 to every polished pane
		// (walk 5, 30 Oct 2026).
		$bb_by = $is_new ? array() : (array) apply_filters( 'addon_boss_list_priced_by', array(), (string) $id );
		if ( $bb_by ) {
			// Each name in quotes: a name with a comma of its own ("Glass
			// size (Clear Glass 8 mm)" once read "Glass size, for Clear Glass
			// 8 mm") never reads as two (walk 6).
			echo '<p class="bb-vat-line bb-ed-pricedby">' . esc_html(
				sprintf(
					/* translators: %s: the sets that price these choices, each in quotes, like “Glass size” and “Glass size (Clear Glass 8 mm)” */
					_n( '%s prices these choices by size. An amount in Adds is charged on top.', '%s price these choices by size. An amount in Adds is charged on top.', count( $bb_by ), 'addon-boss' ),
					wp_sprintf( '%l', array_map( 'addon_boss_quoted_name', $bb_by ) )
				)
			) . '</p>';
		} elseif ( ! empty( $bb_list_for['priced'] ) ) {
			// A new list for a part's prices: its rates are set in the size.
			echo '<p class="bb-vat-line bb-ed-pricedby">' . esc_html(
				sprintf(
					/* translators: %s: the set whose part this list prices, like Glass size */
					__( 'Rates are set in %s. An amount in Adds is charged on top.', 'addon-boss' ),
					$bb_list_for['set']
				)
			) . '</p>';
		}
	}

	// The rows sit in a fieldset that is disabled from the first paint while
	// the set's kind draws its own rows, so nothing of theirs is posted or
	// previewed before a script has even run.
	echo '<fieldset class="bb-ed2-fs" id="bb-rows-fs"' . ( $bb_own ? ' disabled' : '' ) . '>';
	// How many colours this set is missing, over the rows, for a set long
	// enough that the row saying so can be off screen. The script below fills
	// it as the merchant types; it says nothing until a set needs it.
	echo '<div class="bb-sw-need-sum" id="bb-sw-need-sum" role="status" hidden><span class="bb-sw-need-text"></span>'
		/* translators: a link that scrolls to the one choice with no colour */
		. '<button type="button" class="button-link" id="bb-sw-need-show">' . esc_html__( 'Show it', 'addon-boss' ) . '</button></div>';

	// The rows, under one header row that names their columns once: the
	// stock column only where this build offers stock, and its "0 = sold
	// out" said where the number is typed.
	// A set with no colour or photo anywhere draws no picture column.
	$bb_pictured = false;
	foreach ( (array) $set['options'] as $bb_o ) {
		$bb_sw = (string) ( $bb_o['swatch'] ?? '' );
		if ( ( '' !== $bb_sw && 'none' !== $bb_sw ) || ( ! empty( $bb_o['image_id'] ) && has_action( 'addon_boss_option_photo_controls' ) ) ) {
			$bb_pictured = true;
			break;
		}
	}
	// A long list opens short: a find box above it and "Show all" under it.
	echo '<div class="bb-cfind" id="bb-cfind" hidden><span class="bb-cfind-ico" aria-hidden="true"></span><input type="search" id="bb-cfind-in" autocomplete="off" aria-controls="bb-option-rows" aria-label="' . esc_attr__( 'Find a choice', 'addon-boss' ) . '" placeholder="' . esc_attr__( 'Find a choice', 'addon-boss' ) . '"></div>';
	echo '<div class="bb-clist' . ( addon_boss_option_stock_enabled() ? ' has-stock' : '' ) . ( $bb_pictured ? '' : ' no-thumbs' ) . '" id="bb-clist">';
	echo '<div class="bb-ccols" aria-hidden="true"><span></span><span></span><span>' . esc_html__( 'Choice', 'addon-boss' ) . '</span><span class="bb-ccol-price">' . esc_html__( 'Adds', 'addon-boss' ) . '</span>'
		. ( addon_boss_option_stock_enabled() ? '<span class="bb-ccol-stock">' . esc_html__( 'Stock, 0 = sold out', 'addon-boss' ) . '</span>' : '' )
		. '<span></span></div>';
	echo '<div class="bb-edrows" id="bb-option-rows">';
	// An option a bundle includes asks before it is removed, naming the bundles.
	$bb_in_use = $is_new ? array() : (array) ( addon_boss_fixed_answers_in_use_map()[ $id ] ?? array() );
	// What another set adds for a choice (a price table's "+15%"), said
	// beside the choice; a module that prices off this set answers.
	$bb_adj_notes = $is_new ? array() : (array) apply_filters( 'addon_boss_choice_editor_notes', array(), (string) $id );
	foreach ( $set['options'] as $opt ) {
		$bb_adj_key = sanitize_title( (string) ( $opt['key'] ?? '' ) );
		if ( ! empty( $bb_adj_notes[ $bb_adj_key ] ) ) {
			$opt['adj_note'] = implode( ' · ', array_map( 'strval', (array) $bb_adj_notes[ $bb_adj_key ] ) );
		}
		addon_boss_option_editor_row( $opt, addon_boss_option_removal_warning( (array) ( $bb_in_use[ (string) ( $opt['key'] ?? '' ) ] ?? array() ) ) );
	}
	echo '</div>';
	echo '<p class="bb-cnomatch" id="bb-cnomatch" role="status" hidden>' . esc_html__( 'No choices match. Clear the search to see them all.', 'addon-boss' ) . '</p>';
	/* translators: %d: how many choices the set holds */
	$bb_all_say = __( 'Show all %d choices', 'addon-boss' );
	echo '<button type="button" class="bb-cmore" id="bb-cmore" aria-controls="bb-option-rows" aria-expanded="false" data-all="' . esc_attr( $bb_all_say ) . '" data-fewer="' . esc_attr__( 'Show fewer', 'addon-boss' ) . '" hidden></button>';
	echo '<p class="bb-cempty" id="bb-cempty"' . ( $set['options'] ? ' hidden' : '' ) . '><b>' . esc_html__( 'No choices yet.', 'addon-boss' ) . '</b> ' . esc_html__( 'Add the first one; the customer page beside fills in as you type.', 'addon-boss' ) . '</p>';
	echo '</div>';
	echo '<div class="bb-edadd"><button type="button" class="bb-cbtn bb-cbtn-add" id="bb-add-option">' . esc_html__( '+ Add a choice', 'addon-boss' ) . '</button>';
	echo '<button type="button" class="bb-clink" id="bb-same-open"' . ( count( $set['options'] ) > 1 ? '' : ' hidden' ) . '>' . esc_html__( 'Same price for every choice', 'addon-boss' ) . '</button>';
	/* translators: %s: the drag handle, drawn as a symbol */
	$bb_drag = esc_html__( 'Drag %s to change the order.', 'addon-boss' );
	echo '<span class="bb-edhint" id="bb-add-hint">' . sprintf( $bb_drag, '<span aria-hidden="true">&#10495;</span>' ) . '</span></div>'; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- an escaped string around a fixed symbol.
	// Every choice at one price, in one go: the box opens under the list, and
	// a choice added afterwards takes the same price.
	/* translators: %d: how many choices the price is put on */
	$bb_apply_say = __( 'Apply to all %d', 'addon-boss' );
	echo '<div class="bb-csame" id="bb-csame" hidden><label>' . esc_html__( 'Set every choice to', 'addon-boss' )
		. ' <span class="bb-cprice"><i aria-hidden="true">+' . esc_html( html_entity_decode( get_woocommerce_currency_symbol() ) ) . '</i><input type="text" inputmode="decimal" id="bb-same-price" aria-label="' . esc_attr__( 'Price for every choice', 'addon-boss' ) . '" placeholder="0.00"></span></label>'
		. '<button type="button" class="bb-cbtn bb-cbtn-dark" id="bb-same-apply" data-say="' . esc_attr( $bb_apply_say ) . '">' . esc_html__( 'Apply to all', 'addon-boss' ) . '</button>'
		. '<button type="button" class="bb-clink" id="bb-same-cancel">' . esc_html__( 'Cancel', 'addon-boss' ) . '</button></div>';
	echo '</fieldset>';
	addon_boss_editor_sec_close();

	// How a list of choices is picked, then how it looks: two sections that
	// only a list of choices has.
	$bb_choices_only = array(
		'data-bb-kind-panel' => 'choices',
		'hidden'             => 'choices' !== $kind,
	);
	addon_boss_editor_sec_open( 'picking', __( 'Picking', 'addon-boss' ), __( 'One or several', 'addon-boss' ), $bb_choices_only );
	echo $bb_pick_html; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- markup built above from escaped parts and module hooks that escape their own.
	addon_boss_editor_sec_close();
	addon_boss_editor_sec_open( 'look', __( 'Look', 'addon-boss' ), __( 'How choices look', 'addon-boss' ), array( 'id' => 'bb-shape-panel' ) + $bb_choices_only );
	echo $bb_look_html; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- markup built above from escaped parts.
	addon_boss_editor_sec_close();
	// What the shop page will show, worked out live from this form: the
	// product's price, the most choices can add, and whether customers must
	// choose, with a warning wherever the product cannot be bought as set.
	ob_start();
	addon_boss_editor_sec_open( 'cshop', __( 'Shop page', 'addon-boss' ), __( 'What customers see', 'addon-boss' ), array( 'id' => 'bb-sec-cshop' ) + $bb_choices_only );
	echo '<div class="bb-cfacts" id="bb-cfacts" aria-live="polite"></div>';
	echo '<script type="application/json" id="bb-cfacts-data">' . wp_json_encode( $bb_cfacts, JSON_HEX_TAG | JSON_HEX_AMP | JSON_HEX_APOS | JSON_HEX_QUOT ) . '</script>';
	addon_boss_editor_sec_close();
	$bb_shop_html = (string) ob_get_clean();
	// Rules: choices that can't go together, printed by the module that
	// enforces them. A build without one has no Rules section at all.
	ob_start();
	do_action( 'addon_boss_set_editor_rules', $set );
	$bb_rules_html = (string) ob_get_clean();
	if ( '' !== trim( $bb_rules_html ) ) {
		addon_boss_editor_sec_open( 'rules', __( 'Rules', 'addon-boss' ), __( 'Choices that can\'t go together', 'addon-boss' ), array( 'id' => 'bb-sec-rules' ) + $bb_choices_only );
		echo $bb_rules_html; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- printed by the module, which escapes its own.
		addon_boss_editor_sec_close();
	}
	echo $bb_shop_html; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- built above from escaped parts and json.

	// A template arrives named; an empty start (from scratch, or a kind
	// opened blank) does not.
	addon_boss_editor_save_bar( $is_new ? ( '' !== (string) ( $seed['name'] ?? '' ) ? 'template' : 'new' ) : 'saved' );
	echo '</form></div>';

	// Row template + sortable + a fresh blank row for new sets.
	?>
	<?php // A <template>, like every other row template on these screens, rather than a script tag holding markup: there is no JavaScript in it. ?>
	<template id="bb-option-row-template"><?php addon_boss_option_editor_row( array( 'key' => '', 'label' => '', 'swatch' => '', 'delta' => 0.0 ) ); ?></template>
	<?php ob_start(); try { ?>
	jQuery( function ( $ ) {
		$( '#bb-option-rows' ).sortable( { handle: '.bb-opt-grip', axis: 'y', items: '> .bb-edrow' } );
		// Keyboard reorder: the grip is mouse-only, so each row also has Move up
		// and Move down buttons. Delegated, so it works for rows added later.
		$( '#bb-option-rows' ).on( 'click', '.bb-edmove-up', function () {
			var row = $( this ).closest( '.bb-edrow' );
			var prev = row.prev( '.bb-edrow' );
			if ( prev.length ) { row.insertBefore( prev ); this.focus(); }
		} );
		$( '#bb-option-rows' ).on( 'click', '.bb-edmove-down', function () {
			var row = $( this ).closest( '.bb-edrow' );
			var next = row.next( '.bb-edrow' );
			if ( next.length ) { row.insertAfter( next ); this.focus(); }
		} );
		// The kind switcher, generic on purpose: each option on the menu carries
		// its own description and whether the option rows apply, and each kind's
		// panel wears data-bb-kind-panel, so a kind registered tomorrow behaves
		// without this script learning its name. The form wears bb-kind-<kind>
		// for the panel's own styles.
		function bbKindSync() {
			var sel = document.getElementById( 'bb-set-kind' );
			if ( ! sel ) { return; }
			var kind = sel.value;
			var opt  = sel.options[ sel.selectedIndex ];
			var form = $( '#bb-option-set-form' );
			( form.attr( 'class' ) || '' ).split( /\s+/ ).forEach( function ( c ) {
				if ( 0 === c.indexOf( 'bb-kind-' ) ) { form.removeClass( c ); }
			} );
			if ( 'choices' !== kind ) { form.addClass( 'bb-kind-' + kind ); }
			$( '[data-bb-kind-panel]' ).each( function () {
				this.hidden = this.getAttribute( 'data-bb-kind-panel' ) !== kind;
			} );
			$( '#bb-kind-desc' ).text( opt ? ( opt.getAttribute( 'data-desc' ) || '' ) : '' );
			// A kind priced off its own panel has no use for the option rows.
			// .toggle() sets inline display, which beats the list's own display
			// rule (prop hidden alone loses to it).
			var uses = ! opt || '0' !== opt.getAttribute( 'data-uses-options' );
			$( '#bb-rows-fs .bb-clist, #bb-rows-fs .bb-edadd' ).toggle( uses );
		}
		$( '#bb-set-kind' ).on( 'change', bbKindSync );
		bbKindSync();
		// The swatch shape seg: a click is what makes the choice explicit
		// (the hidden field is the one the save reads), and the highlight
		// follows the checked radio exactly as the other segs do.
		function bbShapeShow( value ) {
			$( '#bb-shape-seg input[type=radio]' ).each( function () {
				var on = ( this.value === value );
				this.checked = on;
				$( this ).closest( '.bb-seg' ).toggleClass( 'is-on', on );
			} );
		}
		$( '#bb-shape-seg' ).on( 'change', 'input[type=radio]', function () {
			$( '#bb-set-shape' ).val( this.value );
			bbShapeShow( this.value );
			bbShapeSync();
		} );
		// The seg shows the shape the set will ACTUALLY use, so attaching the
		// first picture has to move it: the resolved shape just became the
		// photo card, and a seg still reading "Square" is the screen telling
		// the merchant their pictures will not be drawn when they will. The
		// hidden pin is never written here, only the highlight, so the auto
		// preference survives. Where the pin IS square or circle the pictures
		// really are dead, and the warning says so with the one click that
		// fixes it. Photos are a Pro feature; with no picker on the page
		// nothing ever changes and this simply agrees with the server.
		function bbShapeSync() {
			var photos = 0;
			$( '#bb-option-rows .bb-ovr-imgid' ).each( function () {
				if ( this.value && '0' !== this.value ) {
					photos++;
				}
			} );
			var pin = $( '#bb-set-shape' ).val();
			if ( ! pin ) {
				bbShapeShow( photos ? 'card' : 'square' );
			}
			// Swatches hide the photos, unless picking a choice puts its photo
			// on the product (the switch for One or Several, whichever shows).
			var shown = $( '#bb-photo-one:not([hidden]), #bb-photo-many:not([hidden])' ).find( 'input[type="checkbox"]' ).is( ':checked' );
			document.getElementById( 'bb-shape-warn' ).hidden =
				! ( photos && ( 'square' === pin || 'circle' === pin ) && ! shown );
			// The same question the other way round, live, so a merchant who
			// clicks Photo card over a set of bare colours is told there while
			// they are looking at it rather than on the storefront. Only where
			// this build has a picker, which the server states on the line
			// itself: asking for a photograph that cannot be attached would be
			// worse than the silence it replaces.
			var miss = document.getElementById( 'bb-photo-missing' );
			if ( miss ) {
				miss.hidden = ! ( miss.getAttribute( 'data-bb-pickable' ) && ! photos && 'card' === pin );
			}
			// Cards, chosen or chosen for it: say which, and how many choices
			// still have no photo of their own.
			var auto = document.getElementById( 'bb-shape-auto' );
			if ( auto ) {
				var named = 0, rowsEl = document.getElementById( 'bb-option-rows' );
				$( '#bb-option-rows input[name="opt_label[]"]' ).each( function () {
					if ( '' !== $.trim( this.value ) ) { named++; }
				} );
				var lines = [], card = 'card' === pin || ( ! pin && photos );
				if ( ! pin && photos ) { lines.push( auto.getAttribute( 'data-auto' ) ); }
				var bare = Math.max( 0, named - photos );
				if ( card && photos && bare ) { lines.push( auto.getAttribute( 1 === bare ? 'data-one' : 'data-many' ).replace( '%d', bare ) ); }
				auto.textContent = lines.join( ' ' );
				auto.hidden = ! lines.length || ! rowsEl;
			}
		}
		$( '#bb-option-rows' ).on( 'bb:photos', bbShapeSync ).on( 'input', 'input[name="opt_label[]"]', bbShapeSync );
		// A percentage in an amount box saved as that many pounds: "10%"
		// became £10.00 (fresh tester, 18 Oct 2026). The box says so and Save
		// waits, with the reason in the Save bar, until it holds an amount.
		// Where this build has price tables, the reason says where a percentage
		// does go: it refused "15%" for blackout fabric and left it there
		// (fresh tester, blinds, 18 Oct 2026).
		var bbPctSay = <?php echo wp_json_encode( isset( addon_boss_option_set_kinds()['table'] ) ? __( 'A price here is an amount, like 2.50. For a percentage of a size\'s price, use a price table\'s price changes.', 'addon-boss' ) : __( 'A price here is an amount, like 2.50, not a percentage.', 'addon-boss' ) ); ?>;
		$( '#bb-option-rows' ).on( 'input', '.bb-edbump', function () {
			var bad = /%/.test( this.value );
			$( this ).toggleClass( 'is-bad', bad ).attr( 'aria-invalid', bad ? 'true' : null ).attr( 'title', bad ? bbPctSay : null );
			var any = $( '#bb-option-rows .bb-edbump' ).filter( function () { return /%/.test( this.value ); } ).length > 0;
			var bar = document.getElementById( 'bb-savebar' );
			if ( ! bar ) { return; }
			var held = bar.getAttribute( 'data-block' ) || '';
			if ( any && ! held ) { bar.setAttribute( 'data-block', bbPctSay ); }
			if ( ! any && held === bbPctSay ) { bar.removeAttribute( 'data-block' ); }
		} );
		bbShapeSync();
		$( '#bb-shape-warn-fix' ).on( 'click', function () {
			$( '#bb-set-shape' ).val( 'card' );
			bbShapeShow( 'card' );
			bbShapeSync();
		} );
		// The several-of seg: the same highlight discipline, and the bounds
		// row only exists while "several" is the answer.
		$( '#bb-multi-seg' ).on( 'change', 'input[type=radio]', function () {
			$( '#bb-multi-seg .bb-seg' ).each( function () {
				$( this ).toggleClass( 'is-on', $( this ).find( 'input' ).prop( 'checked' ) );
			} );
			document.getElementById( 'bb-multi-bounds' ).hidden = ( '1' !== this.value );
			var bbOne  = document.getElementById( 'bb-photo-one' );
			var bbMany = document.getElementById( 'bb-photo-many' );
			if ( bbOne && bbMany ) {
				// A switch the merchant set by hand keeps its state across the
				// flip. A default does not travel: the pick-one switch is on
				// until turned off, and carried over it made every new
				// several-pick set swap the product photo, so print-position
				// diagrams replaced the shirt (workwear tester, 18 Oct 2026).
				// The several-of switch's own line says what off does.
				var bbFrom    = bbOne.hidden ? bbMany : bbOne;
				var bbTo      = '1' === this.value ? bbMany : bbOne;
				var bbFromBox = bbFrom.querySelector( 'input[type="checkbox"]' );
				var bbToBox   = bbTo.querySelector( 'input[type="checkbox"]' );
				if ( bbFrom !== bbTo && bbFromBox && bbToBox && bbFromBox.hasAttribute( 'data-bb-by-hand' ) && bbToBox.checked !== bbFromBox.checked ) {
					bbToBox.checked = bbFromBox.checked;
					bbToBox.setAttribute( 'data-bb-by-hand', '1' );
					$( bbToBox ).trigger( 'change' );
				}
				bbOne.hidden  = ( '1' === this.value );
				bbMany.hidden = ( '1' !== this.value );
				bbShapeSync();
			}
		} );
		$( '#bb-photo-one, #bb-photo-many' ).on( 'change', 'input[type="checkbox"]', function ( e ) {
			if ( ! e.isTrigger ) { this.setAttribute( 'data-bb-by-hand', '1' ); }
			bbShapeSync();
		} );
		// The line under One / Several: what a customer meets, in the words
		// addon_boss_multi_hint() prints on the product page.
		var BBPICK = <?php
		echo wp_json_encode(
			array(
				'one'  => __( 'Customers pick one. Tapping another replaces it.', 'addon-boss' ),
				/* translators: %s: the sentence customers read over the choices, e.g. Choose up to 3. */
				'read' => __( 'Customers read it as “%s”', 'addon-boss' ),
				/* translators: %s: the sentence customers read over the choices on a product that requires the set, e.g. Choose at least 1. */
				'req'  => __( 'Where a product requires it: “%s”', 'addon-boss' ),
				/* translators: 1: the smallest number of choices, 2: the largest number of choices */
				'both' => __( 'Choose at least %1$s and up to %2$s.', 'addon-boss' ),
				/* translators: %s: the smallest number of choices */
				'min'  => __( 'Choose at least %s.', 'addon-boss' ),
				/* translators: %s: the largest number of choices */
				'max'  => __( 'Choose up to %s.', 'addon-boss' ),
				'any'  => __( 'Choose as many as you like.', 'addon-boss' ),
			)
		);
		?>;
		// addon_boss_multi_hint(): a required set takes one at least.
		function bbPickHint( mn, mx, req ) {
			mn = req ? Math.max( 1, mn ) : mn;
			var fl = mn > 1 || req;
			return fl && mx > 0 ? BBPICK.both.replace( '%1$s', mn ).replace( '%2$s', mx )
				: ( fl ? BBPICK.min.replace( '%s', mn ) : ( mx > 0 ? BBPICK.max.replace( '%s', mx ) : BBPICK.any ) );
		}
		// The set's own bounds, then a requiring product's sentence where it
		// differs, as addon_boss_editor_pick_say() prints it.
		function bbPickSay() {
			var say = document.getElementById( 'bb-pick-say' );
			if ( ! say ) { return; }
			if ( '1' !== $( '#bb-multi-seg input:checked' ).val() ) { say.textContent = BBPICK.one; return; }
			var mn  = Math.max( 0, parseInt( $( 'input[name="set_min"]' ).val(), 10 ) || 0 );
			var mx  = Math.max( 0, parseInt( $( 'input[name="set_max"]' ).val(), 10 ) || 0 );
			var own = bbPickHint( mn, mx, false );
			var req = bbPickHint( mn, mx, true );
			say.textContent = BBPICK.read.replace( '%s', own ) + ( req !== own ? ' ' + BBPICK.req.replace( '%s', req ) : '' );
		}
		$( '#bb-multi-seg' ).on( 'change', 'input[type=radio]', bbPickSay );
		$( 'input[name="set_min"], input[name="set_max"]' ).on( 'input change', bbPickSay );
		// A switch whose line says what each side does.
		$( '#bb-option-set-form' ).on( 'change', '.bb-ctoggle input[type=checkbox]', function () {
			var d = $( this ).closest( '.bb-ctoggle' ).find( '.bb-ctoggle-d' );
			if ( d.attr( 'data-on' ) ) { d.text( d.attr( this.checked ? 'data-on' : 'data-off' ) ); }
		} );
		// The list's own furniture follows its rows: the empty line when there
		// are none, and one price for every choice once there are two.
		function bbRowsSay() {
			var n = $( '#bb-option-rows .bb-edrow' ).length;
			$( '#bb-cempty' ).prop( 'hidden', n > 0 );
			$( '#bb-same-open' ).prop( 'hidden', n < 2 );
			if ( n < 2 ) { $( '#bb-csame' ).prop( 'hidden', true ); }
			bbThumbsMode();
			bbFold();
		}
		// A long list opens short (the first 12 choices) with "Show all" under
		// it and a find box over it, so a 40-colour set does not make the page
		// as long as the set. Folded rows stay in the form and save as ever; an
		// open row, a search hit, a new row and a field the browser refuses are
		// always shown.
		var BB_FOLD_FROM = 16;
		var BB_FOLD_SHOW = 12;
		var bbAllShown   = false;
		// A row the merchant must see: open, or holding a field that cannot be
		// saved (a refused "15%", a stock the browser rejects). Folding it would
		// leave Save held with the reason out of sight.
		function bbRowKeep( row ) {
			return row.hasClass( 'is-open' ) || row.find( '.is-bad, [aria-invalid="true"]' ).length > 0
				|| row.find( 'input, select, textarea' ).filter( function () { return this.validity && ! this.validity.valid; } ).length > 0;
		}
		function bbFold() {
			var rows = $( '#bb-option-rows > .bb-edrow' ), n = rows.length;
			var q    = $.trim( $( '#bb-cfind-in' ).val() || '' ).toLowerCase();
			var long = n >= BB_FOLD_FROM, more = $( '#bb-cmore' );
			$( '#bb-cfind' ).prop( 'hidden', ! long && '' === q );
			if ( '' !== q ) {
				var hits = 0;
				rows.each( function () {
					var row = $( this );
					var say = ( ( row.find( '.bb-edlabel' ).val() || '' ) + ' ' + ( row.find( '.bb-ednote' ).val() || '' ) ).toLowerCase();
					var on  = -1 !== say.indexOf( q ) || bbRowKeep( row );
					row.toggleClass( 'is-folded', ! on );
					if ( on ) { hits++; }
				} );
				$( '#bb-cnomatch' ).prop( 'hidden', hits > 0 );
				more.prop( 'hidden', true );
				return;
			}
			$( '#bb-cnomatch' ).prop( 'hidden', true );
			rows.each( function ( i ) {
				$( this ).toggleClass( 'is-folded', long && ! bbAllShown && i >= BB_FOLD_SHOW && ! bbRowKeep( $( this ) ) );
			} );
			more.prop( 'hidden', ! long ).attr( 'aria-expanded', bbAllShown ? 'true' : 'false' )
				.text( bbAllShown ? more.attr( 'data-fewer' ) : ( more.attr( 'data-all' ) || '' ).replace( '%d', n ) );
		}
		function bbFoldOpen() {
			bbAllShown = true;
			$( '#bb-cfind-in' ).val( '' );
			bbFold();
		}
		$( '#bb-cmore' ).on( 'click', function () {
			bbAllShown = ! bbAllShown;
			bbFold();
			// The rows it revealed sit above the button now: take the keyboard
			// to the first of them rather than leave it below 28 new rows.
			if ( bbAllShown ) {
				$( '#bb-option-rows > .bb-edrow' ).eq( BB_FOLD_SHOW ).find( '.bb-edlabel' ).trigger( 'focus' );
			}
			if ( ! bbAllShown ) {
				var top = document.getElementById( 'bb-clist' );
				if ( top && top.getBoundingClientRect().top < 0 ) { top.scrollIntoView( { block: 'start' } ); }
			}
		} );
		$( '#bb-cfind-in' ).on( 'input', bbFold ).on( 'keydown', function ( e ) {
			if ( 'Escape' === e.key && this.value ) { e.preventDefault(); this.value = ''; bbFold(); }
			// Enter means "search", not "save the set": the box sits inside the
			// set's form, and the browser would submit it.
			if ( 'Enter' === e.key ) { e.preventDefault(); bbFold(); }
		} );
		// Moving a row (drag, Move up, Move down, a paste) re-folds by position.
		$( '#bb-option-rows' ).on( 'sortupdate', bbFold ).on( 'click', '.bb-edmove', function () { setTimeout( bbFold, 0 ); } );
		// A field the browser will not save cannot sit in a folded row: open the
		// list so the browser can show it.
		document.getElementById( 'bb-option-set-form' ).addEventListener( 'invalid', function ( e ) {
			if ( $( e.target ).closest( '.bb-edrow.is-folded' ).length ) { bbFoldOpen(); }
		}, true );
		// One row's Details, opened or closed. The button says which.
		function bbRowOpen( row, open ) {
			var btn = row.find( '.bb-cdetails' );
			row.toggleClass( 'is-open', open ).find( '.bb-cedit' ).prop( 'hidden', ! open );
			// A row opened from elsewhere ("Show it" for a colour the page cannot
			// guess) may be folded away or filtered out: an open row is shown.
			if ( open ) { row.removeClass( 'is-folded' ); }
			btn.attr( 'aria-expanded', open ? 'true' : 'false' ).text( btn.attr( open ? 'data-close' : 'data-open' ) );
		}
		$( '#bb-option-rows' ).on( 'click', '.bb-cdetails', function () {
			var row = $( this ).closest( '.bb-edrow' );
			bbRowOpen( row, ! row.hasClass( 'is-open' ) );
		} );
		// The row's head opens it too, anywhere that is not one of its fields.
		$( '#bb-option-rows' ).on( 'click', '.bb-chead', function ( e ) {
			if ( $( e.target ).closest( 'input, button, label, a, .bb-opt-grip' ).length ) { return; }
			var row = $( this ).closest( '.bb-edrow' );
			bbRowOpen( row, ! row.hasClass( 'is-open' ) );
		} );
		// A choice gets its key the moment it exists, the same shape the save
		// gives one, so a rule can name it before the set is ever saved; the
		// save keeps any valid key it is sent.
		function bbNewKey() {
			var k = 'op_', hex = '0123456789abcdef';
			for ( var i = 0; i < 10; i++ ) { k += hex.charAt( Math.floor( Math.random() * 16 ) ); }
			return k;
		}
		$( '#bb-option-rows input[name="opt_key[]"]' ).each( function () {
			if ( ! this.value ) { this.value = bbNewKey(); }
		} );
		// A new choice opens ready to name, and adds nothing until a price is
		// typed. It used to take the price the others shared, so Spot UV came
		// in at the +£6.00 of Rounded corners, unseen in a closed row: a charge
		// nobody set (print shop tester, 18 Oct 2026). "Same price for every
		// choice" is there for one price across the list.
		$( '#bb-add-option' ).on( 'click', function () {
			var row = $( $( '#bb-option-row-template' ).html() ).appendTo( '#bb-option-rows' );
			row.find( 'input[name="opt_key[]"]' ).val( bbNewKey() );
			bbAllShown = true;
			$( '#bb-cfind-in' ).val( '' );
			bbRowsSay();
			// The blank row a fresh set opens with waits for its name: only a
			// merchant's own click opens a row's details.
			if ( this.getAttribute( 'data-bb-auto' ) ) {
				this.removeAttribute( 'data-bb-auto' );
				return;
			}
			bbRowOpen( row, true );
			row.find( '.bb-edlabel' ).trigger( 'focus' );
		} );
		$( document ).on( 'click', '.bb-opt-remove', function () {
			// An option a bundle includes names the bundles before it goes.
			var warn = this.getAttribute( 'data-bb-confirm' );
			if ( warn && ! window.confirm( warn ) ) {
				return;
			}
			$( this ).closest( '.bb-edrow' ).remove();
			bbRowsSay();
		} );
		// Every choice at one price.
		$( '#bb-same-open' ).on( 'click', function () {
			var box = $( '#bb-csame' ), btn = $( '#bb-same-apply' );
			btn.text( ( btn.attr( 'data-say' ) || '' ).replace( '%d', $( '#bb-option-rows .bb-edrow' ).length ) );
			box.prop( 'hidden', false );
			$( '#bb-same-price' ).val( '' ).trigger( 'focus' );
		} );
		$( '#bb-same-cancel' ).on( 'click', function () {
			$( '#bb-csame' ).prop( 'hidden', true );
			$( '#bb-same-open' ).trigger( 'focus' );
		} );
		$( '#bb-same-apply' ).on( 'click', function () {
			var v = $.trim( $( '#bb-same-price' ).val() || '' );
			if ( '' === v ) { $( '#bb-same-price' ).trigger( 'focus' ); return; }
			$( '#bb-option-rows .bb-edbump' ).val( v ).trigger( 'input' );
			$( '#bb-csame' ).prop( 'hidden', true );
			$( '#bb-same-open' ).trigger( 'focus' );
		} );
		$( '#bb-same-price' ).on( 'keydown', function ( e ) {
			if ( 'Enter' === e.key ) { e.preventDefault(); $( '#bb-same-apply' ).trigger( 'click' ); }
			if ( 'Escape' === e.key ) { $( '#bb-same-cancel' ).trigger( 'click' ); }
		} );
		// What the row's head shows follows its details: the note under the
		// name, a sold-out stock box, and the small picture.
		$( '#bb-option-rows' ).on( 'input', '.bb-ednote', function () {
			$( this ).closest( '.bb-edrow' ).find( '.bb-cnote' ).text( this.value );
		} );
		$( '#bb-option-rows' ).on( 'input change', '.bb-edstock', function () {
			$( this ).toggleClass( 'is-out', '0' === $.trim( this.value ) );
		} );
		function bbThumb( row ) {
			var t = row.find( '.bb-cthumb' ), img = row.find( '.bb-ovr-img.has-img' );
			var a = row.find( 'input[name="opt_swatch[]"]' ).val() || '', b = row.find( 'input[name="opt_swatch2[]"]' ).val() || '';
			t.css( { background: '', 'background-image': '' } );
			if ( img.length && img.css( 'background-image' ) && 'none' !== img.css( 'background-image' ) ) {
				t.removeClass( 'is-none' ).css( 'background-image', img.css( 'background-image' ) );
			} else if ( a && 'none' !== a ) {
				t.removeClass( 'is-none' ).css( 'background', b ? 'linear-gradient(135deg,' + a + ' 50%,' + b + ' 50%)' : a );
			} else {
				t.addClass( 'is-none' );
			}
			bbThumbsMode();
		}
		// The picture column comes and goes with the set: there while any
		// choice has a colour or a photo, gone while none does.
		function bbThumbsMode() {
			var any = false;
			$( '#bb-option-rows .bb-cthumb' ).each( function () {
				if ( ! $( this ).hasClass( 'is-none' ) ) { any = true; return false; }
			} );
			$( '#bb-clist' ).toggleClass( 'no-thumbs', ! any );
		}
		$( '#bb-option-rows' ).on( 'bb:photos', function () {
			$( '#bb-option-rows .bb-edrow' ).each( function () { bbThumb( $( this ) ); } );
		} );
		// A colour typed as a name ("Navy") or a code ("#1e2a52"). Nothing
		// changes until the words name a colour.
		function bbColourOf( text ) {
			var t = $.trim( text || '' );
			if ( /^#?([0-9a-f]{3}|[0-9a-f]{6})$/i.test( t ) ) {
				t = t.replace( /^#?/, '#' ).toLowerCase();
				return 4 === t.length ? '#' + t[1] + t[1] + t[2] + t[2] + t[3] + t[3] : t;
			}
			return bbSwGuess( t );
		}
		function bbColourSet( bub, hidden, picker, value ) {
			bub.removeClass( 'is-none' ).css( 'background', value );
			bub.find( hidden ).val( value );
			bub.find( picker ).val( value );
		}
		$( '#bb-option-rows' ).on( 'input', '.bb-swtext', function () {
			var c = bbColourOf( this.value );
			if ( ! c ) { return; }
			var row = $( this ).closest( '.bb-edrow' );
			bbColourSet( row.find( '.bb-swbub1' ), 'input[name="opt_swatch[]"]', '.bb-swpick', c );
			bbThumb( row );
			bbSwSoon();
		} );
		$( '#bb-option-rows' ).on( 'input', '.bb-swtext2', function () {
			var c = bbColourOf( this.value );
			if ( ! c ) { return; }
			var row = $( this ).closest( '.bb-edrow' );
			bbColourSet( row.find( '.bb-swbub2' ), 'input[name="opt_swatch2[]"]', '.bb-swpick2', c );
			bbThumb( row );
		} );
		$( '#bb-option-rows' ).on( 'click', '.bb-sw2-add', function () {
			var pair = $( this ).closest( '.bb-swpair' );
			$( this ).prop( 'hidden', true );
			pair.find( '.bb-swline2' ).prop( 'hidden', false ).find( '.bb-swtext2' ).trigger( 'focus' );
		} );
		// The colour bubble: the native picker writes through to the hidden
		// swatch field the form actually submits.
		$( document ).on( 'input change', '.bb-swpick', function () {
			var bub = $( this ).closest( '.bb-swbub' );
			bub.removeClass( 'is-none' ).css( 'background', this.value );
			bub.find( 'input[name="opt_swatch[]"]' ).val( this.value );
			bub.closest( '.bb-swline' ).find( '.bb-swtext' ).val( this.value );
			bbThumb( $( this ).closest( '.bb-edrow' ) );
		} );
		// The optional second colour (two-tone): its own picker writes through,
		// and the small clear control drops back to a single-colour swatch.
		$( document ).on( 'input change', '.bb-swpick2', function () {
			var bub = $( this ).closest( '.bb-swbub2' );
			bub.removeClass( 'is-none' ).css( 'background', this.value );
			bub.find( 'input[name="opt_swatch2[]"]' ).val( this.value );
			bub.closest( '.bb-swline' ).find( '.bb-swtext2' ).val( this.value );
			bbThumb( $( this ).closest( '.bb-edrow' ) );
		} );
		$( document ).on( 'click', '.bb-sw2-clear', function ( e ) {
			e.preventDefault();
			var bub = $( this ).closest( '.bb-swbub2' );
			bub.addClass( 'is-none' ).css( 'background', '' );
			bub.find( 'input[name="opt_swatch2[]"]' ).val( '' );
			var pair = bub.closest( '.bb-swpair' );
			pair.find( '.bb-swtext2' ).val( '' );
			pair.find( '.bb-swline2' ).prop( 'hidden', true );
			pair.find( '.bb-sw2-add' ).prop( 'hidden', false );
			bbThumb( bub.closest( '.bb-edrow' ) );
		} );
		// THE FIRST COLOUR CAN BE TAKEN BACK TOO. A native colour picker has no
		// empty state, so once a colour was chosen the swatch could never return
		// to having none (a merchant's report, 11 October 2026). Clearing it
		// clears the second colour with it: two-tone is a second colour beside a
		// first, and a lone second colour would sit in the form unseen. It posts
		// 'none', not empty: an empty swatch on a colour name ("Red") is filled
		// from the name on save, which would hand the colour straight back.
		$( document ).on( 'click', '.bb-sw1-clear', function ( e ) {
			e.preventDefault();
			var pair = $( this ).closest( '.bb-swpair' );
			pair.find( '.bb-swbub' ).addClass( 'is-none' ).css( 'background', '' );
			pair.find( 'input[name="opt_swatch[]"]' ).val( 'none' );
			pair.find( 'input[name="opt_swatch2[]"]' ).val( '' );
			pair.find( '.bb-swtext, .bb-swtext2' ).val( '' );
			pair.find( '.bb-swline2' ).prop( 'hidden', true );
			pair.find( '.bb-sw2-add' ).prop( 'hidden', false );
			bbThumb( pair.closest( '.bb-edrow' ) );
		} );
		// A fresh option list gets one blank row; a kind priced off its own
		// panel never needs one.
		var bbKindOpt = $( '#bb-set-kind option:selected' );
		if ( ( ! bbKindOpt.length || '0' !== bbKindOpt.attr( 'data-uses-options' ) ) && ! $( '#bb-option-rows .bb-edrow' ).length ) {
			$( '#bb-add-option' ).attr( 'data-bb-auto', '1' ).trigger( 'click' );
		}

		// COLOURS WE COULD NOT FIND, said as the merchant types. One name the
		// colour list does not know ("Heather Mist") turns the whole set into
		// plain buttons on the shop, Navy and Red with it, and the empty
		// bubble was the only sign. The same rule as
		// addon_boss_swatch_unmatched(): only where some choice has a colour,
		// none was cleared on purpose, and the set is not photo cards.
		var BBSW = {
			map: <?php echo wp_json_encode( addon_boss_colour_map() ); ?>,
			line: <?php echo wp_json_encode( /* translators: %s: a choice's name the colour list does not know, e.g. Heather Mist */ __( 'No colour matches “%s”, so this set shows as plain buttons. Pick a colour for it.', 'addon-boss' ) ); ?>,
			one: <?php echo wp_json_encode( /* translators: said when exactly one choice in the set has no colour; no placeholder, the 1 is written out */ __( '1 colour has no swatch, so this set shows as plain buttons.', 'addon-boss' ) ); ?>,
			many: <?php echo wp_json_encode( /* translators: %d: how many choices have no colour, always more than one */ __( '%d colours have no swatch, so this set shows as plain buttons.', 'addon-boss' ) ); ?>,
			showOne: <?php echo wp_json_encode( /* translators: a link that scrolls to the one choice with no colour */ __( 'Show it', 'addon-boss' ) ); ?>,
			showMany: <?php echo wp_json_encode( /* translators: a link that scrolls to the first of several choices with no colour */ __( 'Show the first', 'addon-boss' ) ); ?>
		};
		var bbSwFirst = null;
		// addon_boss_swatch_from_name(): the whole name, then each word from
		// the last ("Heather Grey" is grey).
		function bbSwGuess( name ) {
			var key = $.trim( name ).toLowerCase();
			if ( ! key ) { return ''; }
			if ( BBSW.map[ key ] ) { return BBSW.map[ key ]; }
			var words = key.split( /[\s\-_\/]+/ ).reverse();
			for ( var i = 0; i < words.length; i++ ) {
				if ( words[ i ] && BBSW.map[ words[ i ] ] ) { return BBSW.map[ words[ i ] ]; }
			}
			return '';
		}
		function bbSwNeed() {
			var rows = $( '#bb-option-rows .bb-edrow' );
			rows.removeClass( 'bb-sw-need' ).find( '.bb-sw-need-line' ).remove();
			var photos = rows.filter( function () { return parseInt( $( this ).find( '.bb-ovr-imgid' ).val(), 10 ) > 0; } ).length;
			var shape  = $( '#bb-set-shape' ).val() || ( photos ? 'card' : 'square' );
			var need = [], own = false, guessed = 0, total = 0, cleared = false;
			// Rows a kind drawing its own does not post (a measured size's)
			// have no colours to ask about.
			if ( $( '#bb-rows-fs' ).prop( 'disabled' ) ) { rows = $(); }
			rows.each( function () {
				var row = $( this );
				var sw = row.find( 'input[name="opt_swatch[]"]' ).val() || '';
				if ( 'none' === sw ) { cleared = true; return; }
				var label = $.trim( row.find( '.bb-edlabel' ).val() || '' );
				total++;
				if ( sw ) { own = true; } else if ( bbSwGuess( label ) ) { guessed++; } else if ( label ) { need.push( { row: row, label: label } ); }
			} );
			// addon_boss_swatch_set_is_colours(): a colour of the merchant's
			// own, a name that says colour, or mostly colour names. "Frame:
			// Print only, Oak, Black, White" is none of those.
			var colours = own || ( guessed > 0 && ( /\b(colou?rs?|shades?)\b/i.test( $( 'input[name="set_name"]' ).val() || '' ) || guessed * 2 > total ) );
			if ( 'card' === shape || cleared || ! colours ) { need = []; }
			need.forEach( function ( n ) {
				n.row.addClass( 'bb-sw-need' );
				var line = $( '<p class="bb-sw-need-line"><span></span></p>' );
				line.find( 'span' ).text( BBSW.line.replace( '%s', n.label ) );
				// Under the row's head, where it shows with the details shut.
				n.row.find( '.bb-chead' ).after( line );
			} );
			bbSwFirst = need.length ? need[ 0 ].row : null;
			var sum = document.getElementById( 'bb-sw-need-sum' );
			if ( sum ) {
				sum.hidden = ! need.length;
				$( sum ).find( '.bb-sw-need-text' ).text( 1 === need.length ? BBSW.one : BBSW.many.replace( '%d', need.length ) );
				$( '#bb-sw-need-show' ).text( 1 === need.length ? BBSW.showOne : BBSW.showMany );
			}
		}
		// After every other handler has written its value.
		function bbSwSoon() { window.setTimeout( bbSwNeed, 0 ); }
		$( document ).on( 'input', '#bb-option-rows .bb-edlabel', bbSwSoon );
		$( document ).on( 'input change', '#bb-option-rows .bb-swpick', bbSwSoon );
		$( document ).on( 'click', '.bb-sw1-clear, .bb-opt-remove, #bb-add-option', bbSwSoon );
		$( '#bb-set-shape, #bb-set-kind' ).on( 'change', bbSwSoon );
		$( 'input[name="set_name"]' ).on( 'input', bbSwSoon );
		$( '#bb-option-rows' ).on( 'bb:photos', bbSwSoon );
		$( '#bb-sw-need-show' ).on( 'click', function () {
			if ( ! bbSwFirst ) { return; }
			bbRowOpen( bbSwFirst, true );
			bbSwFirst[ 0 ].scrollIntoView( { block: 'center', behavior: 'smooth' } );
			bbSwFirst.find( '.bb-swtext' ).trigger( 'focus' );
		} );
		bbSwNeed();
		bbRowsSay();

		// ---- The Shop page facts, worked out from the form as it stands ----
		// Money the way this shop prints it: its symbol, decimals and separators.
		var bbChMoney = ( function () {
			<?php echo addon_boss_admin_money_js( 'money' ); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- generated JS, values json-encoded. ?>
			return money;
		} )();
		var BBF = ( function () {
			try { return JSON.parse( ( document.getElementById( 'bb-cfacts-data' ) || {} ).textContent || '{}' ); } catch ( e ) { return {}; }
		} )();
		<?php echo addon_boss_typed_amount_js(); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- generated JS, no variables. ?>
		var bbChDs = <?php echo wp_json_encode( (string) wc_get_price_decimal_separator() ); ?>;
		// A price as the save reads it (addon_boss_typed_amount()). A box the
		// save refuses counts as nothing: a refused "15%" still counted as £15
		// in "Choices add at most" (print shop tester, 18 Oct 2026).
		function bbNum( v ) {
			if ( /%/.test( String( v || '' ) ) ) { return 0; }
			var n = parseFloat( window.bbTypedAmount( v, bbChDs ) );
			return isFinite( n ) ? n : 0;
		}
		// The product the customer page is showing, so the two agree.
		function bbFactsProduct() {
			var ps = BBF.products || [], pick = document.getElementById( 'bb-epv-product' ), id = pick ? parseInt( pick.value, 10 ) : 0;
			for ( var i = 0; i < ps.length; i++ ) { if ( ps[ i ].id === id ) { return ps[ i ]; } }
			return ps[ 0 ] || null;
		}
		function bbChoicesNow() {
			var out = [];
			$( '#bb-option-rows .bb-edrow' ).each( function () {
				var r = $( this ), st = r.find( 'input[name="opt_stock[]"]' );
				out.push( {
					key: r.find( 'input[name="opt_key[]"]' ).val() || '',
					name: $.trim( r.find( 'input[name="opt_label[]"]' ).val() || '' ) || BBF.w.unnamed,
					price: bbNum( r.find( 'input[name="opt_delta[]"]' ).val() ),
					out: !! ( BBF.stock && st.length && '0' === $.trim( st.val() || '' ) )
				} );
			} );
			return out;
		}
		// The rules, read from the very fields the save posts.
		function bbRulesNow() {
			var groups = {}, alone = [];
			$( '#bb-excl-post input' ).each( function () {
				var m = /^excl_gkeys\[(\d+)\]\[\]$/.exec( this.name );
				if ( m ) { ( groups[ m[ 1 ] ] = groups[ m[ 1 ] ] || [] ).push( this.value ); } else if ( 'excl_alone[]' === this.name ) { alone.push( this.value ); }
			} );
			return { groups: Object.keys( groups ).map( function ( k ) { return groups[ k ]; } ), alone: alone };
		}
		// The dearest pick the rules and bounds allow, and the most choices
		// the rules let a customer take together. A pruned search, not every
		// combination: a long list has more combinations than a page can try.
		function bbBest( items, rules, multi, lo, hi ) {
			if ( ! multi ) {
				var top = 0;
				items.forEach( function ( i ) { top = Math.max( top, i.price ); } );
				return { add: top, most: items.length ? 1 : 0 };
			}
			var clash = {}, budget = 200000;
			items.forEach( function ( i ) { clash[ i.key ] = {}; } );
			rules.groups.forEach( function ( g ) {
				g.forEach( function ( a ) { g.forEach( function ( b ) { if ( a !== b && clash[ a ] && clash[ b ] ) { clash[ a ][ b ] = 1; } } ); } );
			} );
			var lone = items.filter( function ( i ) { return rules.alone.indexOf( i.key ) !== -1; } );
			var free = items.filter( function ( i ) { return rules.alone.indexOf( i.key ) === -1; } ).sort( function ( a, b ) { return b.price - a.price; } );
			var most = lone.length ? 1 : 0, best = null, cap = hi > 0 ? hi : free.length, low = Math.max( 1, lo );
			lone.forEach( function ( i ) { if ( low <= 1 ) { best = null === best ? i.price : Math.max( best, i.price ); } } );
			function fits( picked, k ) {
				for ( var j = 0; j < picked.length; j++ ) { if ( clash[ k ][ picked[ j ] ] ) { return false; } }
				return true;
			}
			( function count( i, picked ) {
				if ( --budget < 0 ) { return; }
				if ( picked.length > most ) { most = picked.length; }
				if ( i >= free.length || picked.length + ( free.length - i ) <= most ) { return; }
				if ( fits( picked, free[ i ].key ) ) { picked.push( free[ i ].key ); count( i + 1, picked ); picked.pop(); }
				count( i + 1, picked );
			} )( 0, [] );
			( function dear( i, picked, sum ) {
				if ( --budget < 0 ) { return; }
				if ( picked.length >= low && picked.length <= cap && ( null === best || sum > best ) ) { best = sum; }
				if ( i >= free.length || picked.length >= cap ) { return; }
				var room = cap - picked.length, bound = sum;
				for ( var j = i; j < free.length && room > 0; j++ ) { if ( free[ j ].price > 0 ) { bound += free[ j ].price; room--; } }
				if ( null !== best && bound <= best && picked.length >= low ) { return; }
				if ( fits( picked, free[ i ].key ) ) { picked.push( free[ i ].key ); dear( i + 1, picked, sum + free[ i ].price ); picked.pop(); }
				dear( i + 1, picked, sum );
			} )( 0, [], 0 );
			return { add: null === best ? 0 : best, most: most };
		}
		function bbFacts() {
			var box = document.getElementById( 'bb-cfacts' );
			if ( ! box || ! BBF.w ) { return; }
			var W = BBF.w, prod = bbFactsProduct(), items = bbChoicesNow(), live = items.filter( function ( i ) { return ! i.out; } );
			var multi = '1' === $( '#bb-multi-seg input:checked' ).val();
			var lo = multi ? Math.max( 0, parseInt( $( 'input[name="set_min"]' ).val(), 10 ) || 0 ) : 0;
			var hi = multi ? Math.max( 0, parseInt( $( 'input[name="set_max"]' ).val(), 10 ) || 0 ) : 0;
			var best = bbBest( live, bbRulesNow(), multi, lo, hi ), any = items.some( function ( i ) { return i.price > 0; } );
			var ps = BBF.products || [], nReq = ps.filter( function ( p ) { return p.required; } ).length;
			var req = prod ? prod.required : true, cheap = null;
			live.forEach( function ( i ) { if ( null === cheap || i.price < cheap.price ) { cheap = i; } } );
			var say = function ( s ) { return $( '<div>' ).text( String( s ) ).html(); };
			var fact = function ( cls, small, big, line, extra ) {
				return '<div class="bb-cfact' + ( cls ? ' ' + cls : '' ) + '"><small>' + say( small ) + '</small><b>' + say( big ) + '</b><span>' + say( line ) + '</span>' + ( extra || '' ) + '</div>';
			};
			var f = [];
			// The top of the page: the product's own price, and a warning when
			// it is lower than anything a customer can actually buy.
			if ( ! prod ) {
				f.push( fact( '', W.top, W.noProduct, W.noProductS ) );
			} else if ( null !== prod.price ) {
				if ( req && cheap && cheap.price > 0 ) {
					f.push( fact( 'warn', W.top, bbChMoney( prod.price ),
						W.lower.replace( '%1$s', bbChMoney( cheap.price ) ).replace( '%2$s', bbChMoney( prod.price + cheap.price ) ),
						'<button type="button" class="bb-cbtn" data-bb-free="' + say( cheap.key ) + '">' + say( W.makeFree.replace( '%s', cheap.name ) ) + '</button>' ) );
				} else {
					f.push( fact( '', W.top, bbChMoney( prod.price ), any ? W.adds : W.noChange ) );
				}
			}
			if ( any ) {
				var line = W.mostMulti;
				if ( ! multi ) {
					var tied = items.filter( function ( i ) { return i.price === best.add; } );
					line = tied.length === items.length ? W.mostSame : ( tied.length > 1 ? W.mostTied.replace( '%d', tied.length ) : W.mostOne.replace( '%s', tied[ 0 ] ? tied[ 0 ].name : '' ) );
				}
				// Several picks add up: the figure is a combination, not one choice.
				f.push( fact( '', multi ? W.mostMany : W.most, bbChMoney( best.add ), line ) );
			}
			var need = multi ? Math.max( lo, req ? 1 : 0 ) : 0;
			if ( items.length && ! live.length ) {
				f.push( fact( 'warn', W.customers, W.cantBuy, req ? W.allOutReq : W.allOut ) );
			} else if ( multi && need > best.most ) {
				f.push( fact( 'warn', W.atLeast.replace( '%d', need ), W.cantMeet, W.cantMeetS.replace( '%d', best.most ) ) );
			} else if ( ps.length > 1 && nReq > 0 && nReq < ps.length ) {
				f.push( fact( 'ok', W.choosing, W.mixed.replace( '%1$d', nReq ).replace( '%2$d', ps.length ), W.mixedS ) );
			} else {
				f.push( fact( 'ok', W.choosing, req ? W.required : W.optional, req ? W.reqS : W.optS ) );
			}
			box.innerHTML = f.join( '' );
		}
		var bbFactsTimer = 0;
		function bbFactsSoon() { clearTimeout( bbFactsTimer ); bbFactsTimer = setTimeout( bbFacts, 120 ); }
		$( '#bb-option-set-form' ).on( 'input change click', bbFactsSoon );
		$( document ).on( 'change', '#bb-epv-product', bbFactsSoon );
		$( '#bb-option-rows' ).on( 'sortupdate', bbFactsSoon );
		// "Make X free": the cheapest choice stops adding to the price.
		$( '#bb-cfacts' ).on( 'click', '[data-bb-free]', function () {
			var key = this.getAttribute( 'data-bb-free' );
			$( '#bb-option-rows .bb-edrow' ).each( function () {
				if ( $( this ).find( 'input[name="opt_key[]"]' ).val() === key ) {
					$( this ).find( '.bb-edbump' ).val( '' ).trigger( 'input' );
				}
			} );
		} );
		bbFacts();
	} );
	<?php } finally { addon_boss_inline_js( ob_get_clean() ); } ?>
	<?php
	/*
	 * Whatever drives the per-choice picture controls this screen just
	 * printed. The engine owns the stored id and the hidden input; choosing a
	 * picture is the photo module's job, on this screen exactly as on the
	 * product panel, so the module binds here rather than the engine learning
	 * what a media frame is.
	 */
	do_action( 'addon_boss_option_set_editor_js' );
	?>
	<?php
}

/**
 * What the Shop page facts of a list of choices need from the server: the
 * products the set is on (the customer page offers the same ones), each with
 * the one price its shop page shows and whether it makes the set required,
 * and the words the facts are written in.
 *
 * A product's price counts only where it is one number (a simple product);
 * a product whose price moves with its variations has no single figure to
 * compare the choices against, so the facts leave its price out.
 *
 * @param string $set_id The set ('' for one not saved yet).
 */
function addon_boss_choices_facts_data( string $set_id ): array {
	$products = array();
	foreach ( addon_boss_set_preview_products( $set_id ) as $bb_pid => $bb_title ) {
		$bb_p = wc_get_product( (int) $bb_pid );
		if ( ! $bb_p instanceof WC_Product ) {
			continue;
		}
		$bb_req = true;
		foreach ( addon_boss_product_option_sets( $bb_p ) as $bb_row ) {
			if ( (string) ( $bb_row['id'] ?? '' ) === $set_id ) {
				$bb_req = ! empty( $bb_row['required'] );
				break;
			}
		}
		$bb_price   = $bb_p->is_type( 'simple' ) ? (string) $bb_p->get_price( 'edit' ) : '';
		$products[] = array(
			'id'       => (int) $bb_pid,
			'title'    => (string) $bb_title,
			'price'    => '' === $bb_price ? null : (float) $bb_price,
			'required' => $bb_req,
		);
	}
	return array(
		'products' => $products,
		'stock'    => addon_boss_option_stock_enabled(),
		'w'        => array(
			'top'        => __( 'Top of the page', 'addon-boss' ),
			'noProduct'  => __( 'Not on a product yet', 'addon-boss' ),
			'noProductS' => __( 'Put this set on a product and its price shows here.', 'addon-boss' ),
			'adds'       => __( 'The product price. Choices add to it.', 'addon-boss' ),
			'noChange'   => __( 'No choice changes the price.', 'addon-boss' ),
			/* translators: 1: the smallest amount any choice adds, 2: the cheapest a customer can pay */
			'lower'      => __( 'Lower than anything customers can buy: every choice adds at least %1$s, so the cheapest is %2$s.', 'addon-boss' ),
			/* translators: %s: a choice's name */
			'makeFree'   => __( 'Make %s free', 'addon-boss' ),
			'most'       => __( 'The most a choice adds', 'addon-boss' ),
			'mostMany'   => __( 'Choices add at most', 'addon-boss' ),
			'mostMulti'  => __( 'The dearest combination your rules allow.', 'addon-boss' ),
			'mostSame'   => __( 'Every choice adds the same.', 'addon-boss' ),
			/* translators: %d: how many choices share the highest price, always more than one */
			'mostTied'   => __( '%d choices share the top price.', 'addon-boss' ),
			/* translators: %s: a choice's name */
			'mostOne'    => __( '%s costs the most.', 'addon-boss' ),
			'customers'  => __( 'Customers', 'addon-boss' ),
			'cantBuy'    => __( 'Can\'t buy it', 'addon-boss' ),
			'allOut'     => __( 'Every choice is sold out.', 'addon-boss' ),
			'allOutReq'  => __( 'Every choice is sold out and the set is required.', 'addon-boss' ),
			/* translators: %d: the fewest choices a customer must pick */
			'atLeast'    => __( '"At least %d"', 'addon-boss' ),
			'cantMeet'   => __( 'Can\'t be met', 'addon-boss' ),
			/* translators: %d: the most choices a customer can pick together under the set's rules */
			'cantMeetS'  => __( 'Your rules let customers pick %d at most, so nobody could buy it.', 'addon-boss' ),
			'choosing'   => __( 'Choosing', 'addon-boss' ),
			'required'   => __( 'Required', 'addon-boss' ),
			'optional'   => __( 'Optional', 'addon-boss' ),
			// Each product says required or optional, never the set: "Required"
			// here read as the set's own setting, with nowhere to change it
			// (print shop tester, 18 Oct 2026).
			'reqS'       => __( 'Add to cart waits for a choice. Each product can make it optional.', 'addon-boss' ),
			'optS'       => __( 'Customers can skip it. Each product can make it required.', 'addon-boss' ),
			/* translators: 1: how many of the products require the set, 2: how many products carry it */
			'mixed'      => __( 'Required on %1$d of %2$d products', 'addon-boss' ),
			'mixedS'     => __( 'The others let customers skip it.', 'addon-boss' ),
			'unnamed'    => __( 'Unnamed choice', 'addon-boss' ),
		),
	);
}

/**
 * One editor row. The hidden key input is the stability contract.
 *
 * @param array  $opt     The option.
 * @param string $confirm Asked before the row is removed; empty removes it straight away.
 */
function addon_boss_option_editor_row( array $opt, string $confirm = '' ): void {
	$swatch  = (string) ( $opt['swatch'] ?? '' );
	$swatch2 = (string) ( $opt['swatch2'] ?? '' );
	$desc    = (string) ( $opt['desc'] ?? '' );
	$dims    = array_values( (array) ( $opt['dims'] ?? array() ) );

	/*
	 * The choice's picture, next to its colour, because they are the same
	 * question: what does this choice LOOK like. It could only be answered on
	 * one product at a time before, which is no answer at all for a set built
	 * to be shared: four print positions meant re-picking the same four
	 * photographs on every garment in the shop.
	 *
	 * The picker itself belongs to the photo module and arrives through the
	 * same action the product panel uses; the stored id is the engine's own
	 * hidden input, so a build with no picker still carries the pictures
	 * through a save untouched.
	 */
	ob_start();
	do_action( 'addon_boss_option_photo_controls', absint( $opt['image_id'] ?? 0 ) );
	$photo_controls = (string) ob_get_clean();
	// Its own narrow wrapper, not the override grid's field row: the clear
	// control is positioned against its corner, and in a wide flex cell it
	// ended up floating in the middle of the row beside the option's name.
	$photo = '<span class="bb-edphoto">' . $photo_controls
		. '<input type="hidden" class="bb-ovr-imgid" name="opt_image[]" value="'
		. esc_attr( ! empty( $opt['image_id'] ) ? (string) absint( $opt['image_id'] ) : '' ) . '"></span>';
	$dcells = '';
	for ( $d = 0; $d < 3; $d++ ) {
		$dval = isset( $dims[ $d ] ) && 0.0 !== (float) $dims[ $d ] ? (string) (float) $dims[ $d ] : '';
		/* translators: %d: dimension number, 1 to 3 */
		$dlabel  = sprintf( __( 'Preset size, dimension %d', 'addon-boss' ), $d + 1 );
		$dcells .= '<input type="number" step="any" name="opt_dim' . $d . '[]" class="bb-eddim bb-eddim-' . $d . '" aria-label="' . esc_attr( $dlabel ) . '" value="' . esc_attr( $dval ) . '">';
	}
	// The colour: a swatch to click for the system picker, a box to type a
	// colour's name or #code into, and a second colour for two-tone, offered
	// only once asked for. The hidden fields are the ones the form submits; a
	// cleared colour posts 'none' again on the next save, so the name guess
	// never paints it back.
	$pair = sprintf(
		'<span class="bb-swpair">'
		. '<span class="bb-swline"><span class="bb-swbub bb-swbub1%1$s" style="%2$s"><input type="color" class="bb-swpick" aria-label="%3$s" value="%4$s"><input type="hidden" name="opt_swatch[]" value="%5$s"><button type="button" class="bb-sw1-clear" aria-label="%6$s" title="%6$s">&times;</button></span>'
		. '<input type="text" class="bb-swtext" aria-label="%13$s" placeholder="%14$s" value="%15$s"></span>'
		. '<span class="bb-swline bb-swline2"%16$s><span class="bb-swbub bb-swbub2%7$s" style="%8$s" title="%9$s"><input type="color" class="bb-swpick2" aria-label="%9$s" value="%10$s"><input type="hidden" name="opt_swatch2[]" value="%11$s"><button type="button" class="bb-sw2-clear" aria-label="%12$s" title="%12$s">&times;</button></span>'
		. '<input type="text" class="bb-swtext2" aria-label="%17$s" placeholder="%14$s" value="%18$s"></span>'
		. '<button type="button" class="bb-sw2-add"%19$s>%20$s</button>'
		. '</span>',
		$swatch && 'none' !== $swatch ? '' : ' is-none',
		$swatch && 'none' !== $swatch ? 'background:' . esc_attr( $swatch ) : '',
		esc_attr__( 'Swatch colour', 'addon-boss' ),
		esc_attr( $swatch && 'none' !== $swatch ? $swatch : '#dddddd' ),
		esc_attr( $swatch ? $swatch : ( empty( $opt['no_swatch'] ) ? '' : 'none' ) ),
		esc_attr__( 'Clear colour', 'addon-boss' ),
		$swatch2 ? '' : ' is-none',
		$swatch2 ? 'background:' . esc_attr( $swatch2 ) : '',
		esc_attr__( 'Second colour (two-tone)', 'addon-boss' ),
		esc_attr( $swatch2 ? $swatch2 : '#dddddd' ),
		esc_attr( $swatch2 ),
		esc_attr__( 'Clear second colour', 'addon-boss' ),
		esc_attr__( 'Colour: a name or a code', 'addon-boss' ),
		/* translators: placeholder in the box where a colour is typed, as a name ("Navy") or a code ("#1e2a52") */
		esc_attr__( 'Name or #code', 'addon-boss' ),
		esc_attr( $swatch && 'none' !== $swatch ? $swatch : '' ),
		$swatch2 ? '' : ' hidden',
		esc_attr__( 'Second colour: a name or a code', 'addon-boss' ),
		esc_attr( $swatch2 ),
		$swatch2 ? ' hidden' : '',
		esc_html__( 'Add a second colour', 'addon-boss' )
	);
	// The small picture at the head of the row: the choice's photo where it
	// has one and this build can show it, else its colour (two colours split
	// corner to corner). The editor's script redraws it as either changes.
	$stock    = isset( $opt['stock'] ) && is_numeric( $opt['stock'] ) ? (string) (int) $opt['stock'] : '';
	$has_pics = '' !== trim( (string) preg_replace( '#<input[^>]*type="hidden"[^>]*>#', '', $photo_controls ) );
	// A price reads as money ("2.00"), unless it holds finer detail than the
	// shop's decimals, which stays exactly as stored so a save never moves it.
	$delta     = (float) ( $opt['delta'] ?? 0 );
	$decimals  = function_exists( 'wc_get_price_decimals' ) ? wc_get_price_decimals() : 2;
	$delta_txt = 0.0 === $delta ? '' : ( abs( addon_boss_round_money( $delta, $decimals ) - $delta ) < 1e-9 ? number_format( $delta, $decimals, '.', '' ) : (string) $delta );
	$thumb     = '';
	$img_url  = $has_pics && ! empty( $opt['image_id'] ) ? (string) wp_get_attachment_image_url( absint( $opt['image_id'] ), 'thumbnail' ) : '';
	if ( '' !== $img_url ) {
		$thumb = 'background-image:url(' . esc_url( $img_url ) . ')';
	} elseif ( $swatch && 'none' !== $swatch ) {
		$thumb = 'background:' . ( $swatch2 ? 'linear-gradient(135deg,' . $swatch . ' 50%,' . $swatch2 . ' 50%)' : $swatch );
	}

	// AddOnBoss #122: one compact row that edits in place (the choice's
	// picture, name, price and stock) and a Details panel for the rest (its
	// colour or photo, the note shown when picked, what it cannot go with,
	// moving and removing). Every field keeps its name and every control its
	// class, so the save and the editor's scripts read it as they always did.
	// The key comes first: everything that reads a row finds its key before
	// its controls. Every field carries an aria-label: a placeholder alone
	// vanishes on type.
	echo '<div class="bb-edrow">';
	echo '<input type="hidden" name="opt_key[]" value="' . esc_attr( $opt['key'] ?? '' ) . '">';
	echo '<div class="bb-chead">';
	echo '<span class="bb-opt-grip" aria-hidden="true">&#10495;</span>';
	echo '<span class="bb-cthumb' . ( '' === $thumb ? ' is-none' : '' ) . '"' . ( '' === $thumb ? '' : ' style="' . esc_attr( $thumb ) . '"' ) . ' aria-hidden="true"></span>';
	echo '<span class="bb-cname"><input type="text" name="opt_label[]" class="bb-edlabel" aria-label="' . esc_attr__( 'Option name', 'addon-boss' ) . '" value="' . esc_attr( $opt['label'] ?? '' ) . '" placeholder="' . esc_attr__( 'Name this choice', 'addon-boss' ) . '">'
		. '<small class="bb-cnote">' . esc_html( wp_strip_all_tags( $desc ) ) . '</small>'
		// What a price table adds for this choice ("+15% on Roller blind size").
		. ( '' !== (string) ( $opt['adj_note'] ?? '' ) ? '<small class="bb-cadj">' . esc_html( (string) $opt['adj_note'] ) . '</small>' : '' )
		. '</span>';
	echo '<span class="bb-cprice"><i aria-hidden="true">+' . esc_html( html_entity_decode( get_woocommerce_currency_symbol() ) ) . '</i>'
		. '<input type="text" inputmode="decimal" name="opt_delta[]" class="bb-edbump" aria-label="' . esc_attr__( 'Extra charge', 'addon-boss' ) . '" value="' . esc_attr( $delta_txt ) . '" placeholder="0.00"></span>';
	if ( addon_boss_option_stock_enabled() ) {
		echo '<input type="number" min="0" step="1" inputmode="numeric" name="opt_stock[]" class="bb-edstock' . ( '0' === $stock ? ' is-out' : '' ) . '" aria-label="' . esc_attr__( 'Stock (leave blank for unlimited)', 'addon-boss' ) . '" value="' . esc_attr( $stock ) . '" placeholder="' . esc_attr__( 'Unlimited', 'addon-boss' ) . '">';
	}
	echo '<button type="button" class="bb-cdetails" aria-expanded="false" data-close="' . esc_attr__( 'Close', 'addon-boss' ) . '" data-open="' . esc_attr__( 'Edit details', 'addon-boss' ) . '">' . esc_html__( 'Edit details', 'addon-boss' ) . '</button>';
	echo '</div>';
	echo '<div class="bb-cedit" hidden>';
	echo '<div class="bb-cfld bb-cfld-colour"><span class="bb-cfld-h">' . esc_html__( 'Colour', 'addon-boss' ) . '</span>' . $pair . '</div>'; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- built above from escaped parts.
	// The picture: the photo module's own controls and the engine's hidden id,
	// which rides whether or not this build offers a picker.
	echo '<div class="bb-cfld bb-cfld-photo"' . ( $has_pics ? '' : ' hidden' ) . '><span class="bb-cfld-h">' . esc_html__( 'Photo', 'addon-boss' ) . '</span>' . wp_kses( $photo, addon_boss_kses_allowed() ) . '</div>';
	echo '<label class="bb-cfld bb-cfld-wide"><span class="bb-cfld-h">' . esc_html__( 'Note shown when picked', 'addon-boss' ) . '</span>'
		. '<input type="text" name="opt_desc[]" class="bb-ednote" aria-label="' . esc_attr__( 'Note shown when this option is picked (optional)', 'addon-boss' ) . '" value="' . esc_attr( $desc ) . '" placeholder="' . esc_attr__( 'Optional. For example: allow 3 extra days', 'addon-boss' ) . '"></label>';
	/**
	 * More of one choice's details, printed by the module that owns them:
	 * what the choice cannot be picked with.
	 *
	 * @param array $opt The option.
	 */
	do_action( 'addon_boss_option_row_details', $opt );
	echo '<div class="bb-cacts"><span class="bb-edmoves"><button type="button" class="button-link bb-edmove bb-edmove-up">' . esc_html__( 'Move up', 'addon-boss' ) . '</button>'
		. '<button type="button" class="button-link bb-edmove bb-edmove-down">' . esc_html__( 'Move down', 'addon-boss' ) . '</button></span>'
		. '<button type="button" class="button-link bb-opt-remove"' . ( '' !== $confirm ? ' data-bb-confirm="' . esc_attr( $confirm ) . '"' : '' ) . '>' . esc_html__( 'Remove choice', 'addon-boss' ) . '</button></div>';
	echo '</div>';
	echo wp_kses( $dcells, addon_boss_kses_allowed() );
	echo '</div>';
}

// ---- admin-post handlers ----------------------------------------

add_action( 'admin_post_addon_boss_save_option_set_form', 'addon_boss_handle_save_option_set_form' );
add_action( 'admin_post_addon_boss_delete_option_set_form', 'addon_boss_handle_delete_option_set_form' );
add_action( 'admin_post_addon_boss_import_starter_set', 'addon_boss_handle_import_starter_set' );
add_action( 'admin_post_addon_boss_duplicate_option_set_form', 'addon_boss_handle_duplicate_option_set_form' );
add_action( 'admin_post_addon_boss_bulk_attach_set', 'addon_boss_handle_bulk_attach_set' );

/**
 * Attach one set to every product in a category. Products already offering
 * it are left EXACTLY as they are, overrides, photos and rules included;
 * the attachment stays removable per product. A starting point, never a
 * lock: 303 optioned products cannot be configured one at a time.
 *
 * One run is bounded. Loading and re-saving every product happens inside a
 * single request, and past a point that request times out halfway with the
 * category half-attached, which is worse than not starting. The ids query is
 * cheap, so the size is counted first; a category past the cap is refused
 * whole, with both numbers named, and nothing is touched. The refusal rides
 * the result as 'refused' so the handler can show it as it stands.
 */
function addon_boss_bulk_attach_set( string $set_id, int $term_id ): array {
	$attached = 0;
	$skipped  = 0;
	if ( ! addon_boss_option_set( $set_id ) || $term_id <= 0 ) {
		return array( 'attached' => 0, 'skipped' => 0 );
	}
	$ids = get_posts(
		array(
			'post_type'      => 'product',
			'post_status'    => array( 'publish', 'draft', 'private' ),
			'posts_per_page' => -1,
			'fields'         => 'ids',
			'tax_query'      => array( // phpcs:ignore WordPress.DB.SlowDBQuery.slow_db_query_tax_query -- an explicit admin action, not a storefront query.
				array(
					'taxonomy' => 'product_cat',
					'terms'    => $term_id,
				),
			),
		)
	);

	/**
	 * The most products one bulk-attach run will take on.
	 *
	 * 200 finishes comfortably inside an ordinary request. A host with more
	 * headroom can raise it, and zero or less removes the bound entirely.
	 *
	 * @param int $cap The bound. Default 200.
	 */
	$cap = (int) apply_filters( 'addon_boss_bulk_attach_cap', 200 );
	if ( $cap > 0 && count( $ids ) > $cap ) {
		return array(
			'attached' => 0,
			'skipped'  => 0,
			'refused'  => sprintf(
				/* translators: 1: how many products the category holds, 2: the most one run will attach to */
				__( 'That category holds %1$s products. To finish reliably in one go, this tool attaches to at most %2$s at a time, so nothing was attached. Please try a smaller category or a subcategory.', 'addon-boss' ),
				number_format_i18n( count( $ids ) ),
				number_format_i18n( $cap )
			),
		);
	}

	$first_id = 0;
	foreach ( $ids as $pid ) {
		$product = wc_get_product( $pid );
		if ( ! $product || ! ( $product->is_type( 'simple' ) || $product->is_type( 'variable' ) ) ) {
			continue;
		}
		$config = addon_boss_product_option_config( $product, true );
		if ( in_array( $set_id, array_column( $config, 'set' ), true ) ) {
			++$skipped;
			if ( 0 === $first_id ) {
				$first_id = (int) $pid;
			}
			continue;
		}
		$config[] = array( 'set' => $set_id, 'required' => false );
		addon_boss_save_product_option_config( $product, $config );
		++$attached;
		if ( 0 === $first_id ) {
			$first_id = (int) $pid;
		}
	}
	return array( 'attached' => $attached, 'skipped' => $skipped, 'first_id' => $first_id );
}

function addon_boss_handle_bulk_attach_set(): void {
	if ( ! current_user_can( 'manage_woocommerce' ) ) {
		wp_die( esc_html__( 'Sorry, you are not allowed to do that.', 'addon-boss' ) );
	}
	check_admin_referer( 'addon_boss_bulk_attach_set' );
	$result = addon_boss_bulk_attach_set(
		sanitize_text_field( wp_unslash( $_POST['set'] ?? '' ) ),
		absint( $_POST['bulk_category'] ?? 0 )
	);
	if ( isset( $result['refused'] ) ) {
		// The category is past the bound: the worker refused it whole and its
		// message names the count and the cap. A warning, not an error, because
		// nothing broke and nothing was half-done.
		addon_boss_option_sets_redirect( (string) $result['refused'], 'warning' );
	}
	if ( 0 === (int) $result['attached'] && 0 === (int) $result['skipped'] ) {
		// Nothing happened: no category chosen, or the category held no eligible
		// products. A green "Attached to 0 products" read as a silent success.
		addon_boss_option_sets_redirect(
			__( 'Pick a category first, or that one has no eligible products. Nothing was attached.', 'addon-boss' ),
			'warning'
		);
	}
	addon_boss_option_sets_redirect(
		$result['skipped']
			? sprintf(
				/* translators: 1: products attached, 2: products that already offered the set */
				__( 'Attached to %1$d products. %2$d already offered it and were left untouched.', 'addon-boss' ),
				$result['attached'],
				$result['skipped']
			)
			/* translators: %d: products attached */
			: sprintf( __( 'Attached to %d products.', 'addon-boss' ), $result['attached'] ),
		'success',
		// Until a product page has been seen, the first attach offers the view.
		function_exists( 'addon_boss_onboarding_next_action' )
			? addon_boss_onboarding_next_action( 'attached', (int) ( $result['first_id'] ?? 0 ) )
			: array()
	);
}

/**
 * A copy of a set, saved under a new id. Shoppers keep reading the words
 * they read before: the copy's library name says "copy", and the set name
 * was also the heading on the product page, so "Glass size copy" reached
 * the shop (walk 5, 30 Oct 2026). The words shoppers read ride the set's
 * own label (addon_boss_set_shopper_name), as a supplier's sets already do.
 *
 * @param string $id   The set to copy.
 * @param string $name The copy's library name; '' for "<name> copy".
 * @return string The copy's id, or '' where the set is gone.
 */
function addon_boss_duplicate_option_set( string $id, string $name = '' ): string {
	$src = addon_boss_option_set( $id );
	if ( ! $src ) {
		return '';
	}
	$src['label'] = addon_boss_set_shopper_name( $src );
	/* translators: %s: the copied set's name */
	$src['name'] = '' !== $name ? $name : sprintf( __( '%s copy', 'addon-boss' ), $src['name'] );
	unset( $src['id'] );
	return addon_boss_save_option_set( $src );
}

function addon_boss_handle_duplicate_option_set_form(): void {
	if ( ! current_user_can( 'manage_woocommerce' ) ) {
		wp_die( esc_html__( 'Sorry, you are not allowed to do that.', 'addon-boss' ) );
	}
	check_admin_referer( 'addon_boss_duplicate_option_set' );
	$copy = addon_boss_duplicate_option_set( sanitize_text_field( wp_unslash( $_GET['set'] ?? '' ) ) );
	// The copy opens, ready to change: it landed on the whole library, not
	// opened, with nothing saying where it was (walk 5, 30 Oct 2026).
	addon_boss_option_sets_redirect(
		'' !== $copy ? __( 'Set duplicated. Attach the copy to a product in place of the original.', 'addon-boss' ) : __( 'That set no longer exists.', 'addon-boss' ),
		'' !== $copy ? 'success' : 'error',
		array(),
		'' !== $copy ? admin_url( 'admin.php?page=addon-boss-option-sets&set=' . rawurlencode( $copy ) ) : ''
	);
}

function addon_boss_option_sets_redirect( string $notice, string $type = 'success', array $action = array(), string $to = '' ): void {
	// The message carries its own type so a failure never wears the green
	// success tick. "That set no longer exists" and a bad file import used to
	// render exactly like "Option set saved". An optional action ({l,u}) rides
	// along so a notice can carry its one next step; the printer escapes it.
	$payload = array(
		'm' => $notice,
		't' => in_array( $type, array( 'success', 'error', 'warning' ), true ) ? $type : 'success',
	);
	if ( '' !== (string) ( $action['l'] ?? '' ) && '' !== (string) ( $action['u'] ?? '' ) ) {
		$payload['a'] = array(
			'l' => (string) $action['l'],
			'u' => (string) $action['u'],
		);
	}
	set_transient( 'bundle_boss_option_sets_notice_' . get_current_user_id(), $payload, MINUTE_IN_SECONDS );
	// The library by default; a save lands back on the set it saved.
	wp_safe_redirect( '' !== $to ? $to : admin_url( 'admin.php?page=addon-boss-option-sets' ) );
	exit;
}

function addon_boss_handle_save_option_set_form(): void {
	if ( ! current_user_can( 'manage_woocommerce' ) ) {
		wp_die( esc_html__( 'Sorry, you are not allowed to do that.', 'addon-boss' ) );
	}
	check_admin_referer( 'addon_boss_save_option_set_form' );

	// The whole form-to-set assembly lives in addon_boss_option_set_from_form()
	// (set-preview.php), shared with the preview endpoint so a preview can
	// never drift from what saving stores.
	$bb_raw = addon_boss_option_set_from_form();
	$bb_sid = sanitize_text_field( wp_unslash( $_POST['set_id'] ?? '' ) );
	// A set born from a group's own menu lands in that group. New sets only:
	// an edit never rewrites its group from a stray parameter.
	if ( '' === $bb_sid && isset( $_POST['bb_new_group'] ) ) {
		$bb_raw['group'] = sanitize_text_field( wp_unslash( $_POST['bb_new_group'] ) );
	}
	// The save alone, never the preview: a kind may make what the set needs
	// first (a template's own lists, addon_boss_measured_template_lists).
	$bb_raw = (array) apply_filters( 'addon_boss_option_set_before_save', $bb_raw, $bb_sid );
	$id     = addon_boss_save_option_set( $bb_raw, $bb_sid );
	// A new set marks its kind "Last used" on the start screen, for this
	// person only.
	if ( '' === $bb_sid ) {
		addon_boss_remember_new_set_kind( (string) ( addon_boss_option_set( $id )['kind'] ?? 'choices' ) );
		// Made from a product's own link: that product's tab attaches it when
		// it is looked at again (addon_boss_attach_menu_ajax).
		$bb_for = absint( $_POST['bb_for_product'] ?? 0 );
		if ( $bb_for && current_user_can( 'edit_post', $bb_for ) ) {
			addon_boss_remember_made_for( $bb_for, $id );
		}
	}
	// "Use £X" on a Shop page facts card queued a product's own price; it is
	// set here, with the set, like everything else on the page.
	$bb_priced = '';
	if ( isset( $_POST['bb_use_price'] ) && is_array( $_POST['bb_use_price'] ) && function_exists( 'addon_boss_editor_use_prices' ) ) {
		foreach ( addon_boss_editor_use_prices( wp_unslash( $_POST['bb_use_price'] ) ) as $bb_pid => $bb_price ) { // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized -- each id and price is sanitised inside.
			$bb_product = wc_get_product( $bb_pid );
			/* translators: 1: a product's name, 2: its new price */
			$bb_priced .= ' ' . sprintf( __( '%1$s now costs %2$s.', 'addon-boss' ), $bb_product ? $bb_product->get_name() : '#' . $bb_pid, html_entity_decode( addon_boss_plain_price( $bb_price ), ENT_QUOTES, 'UTF-8' ) ); // aob-money-raw: the regular price just stored, as the merchant entered it.
		}
	}
	// Saving stays on the set, the way a post stays on its editor: a library
	// of three hundred sets is no place to land after every save.
	$bb_back = admin_url( 'admin.php?page=addon-boss-option-sets&set=' . rawurlencode( $id ) );
	// A kind may have something worth saying about the set just saved (a price
	// table warns about overlapping bands). Never blocks the save.
	$saved_set = addon_boss_option_set( $id );
	if ( $saved_set ) {
		$bb_spec = addon_boss_option_set_kinds()[ (string) ( $saved_set['kind'] ?? 'choices' ) ] ?? null;
		if ( $bb_spec && is_callable( $bb_spec['save_notice'] ?? null ) ) {
			$bb_notice = call_user_func( $bb_spec['save_notice'], $saved_set );
			if ( is_array( $bb_notice ) && '' !== (string) ( $bb_notice['message'] ?? '' ) ) {
				addon_boss_option_sets_redirect( (string) $bb_notice['message'] . $bb_priced, (string) ( $bb_notice['type'] ?? 'warning' ), array(), $bb_back );
			}
		}
	}
	// While nothing is attached yet, the saved-set notice carries the next
	// step, so the first success points straight at the second.
	addon_boss_option_sets_redirect(
		__( 'Option set saved.', 'addon-boss' ) . $bb_priced,
		'success',
		function_exists( 'addon_boss_onboarding_next_action' ) ? addon_boss_onboarding_next_action( 'set_saved' ) : array(),
		$bb_back
	);
}

function addon_boss_handle_delete_option_set_form(): void {
	if ( ! current_user_can( 'manage_woocommerce' ) ) {
		wp_die( esc_html__( 'Sorry, you are not allowed to do that.', 'addon-boss' ) );
	}
	check_admin_referer( 'addon_boss_delete_option_set' );
	addon_boss_delete_option_set( sanitize_text_field( wp_unslash( $_GET['set'] ?? '' ) ) );
	addon_boss_option_sets_redirect( __( 'Option set deleted.', 'addon-boss' ) );
}

function addon_boss_handle_import_starter_set(): void {
	if ( ! current_user_can( 'manage_woocommerce' ) ) {
		wp_die( esc_html__( 'Sorry, you are not allowed to do that.', 'addon-boss' ) );
	}
	check_admin_referer( 'addon_boss_import_starter_set' );
	$starter_id = sanitize_text_field( wp_unslash( $_GET['starter'] ?? '' ) );
	$starters   = addon_boss_option_starter_sets();
	if ( ! isset( $starters[ $starter_id ] ) ) {
		addon_boss_option_sets_redirect( __( 'Unknown ready-made set.', 'addon-boss' ), 'error' );
	}
	// Already imported: don't make a silent duplicate. Say so plainly and leave
	// the copy the shop already owns untouched.
	if ( '' !== addon_boss_option_set_id_by_name( $starters[ $starter_id ]['name'] ) ) {
		addon_boss_option_sets_redirect( __( 'You already have that set, so it was not added again.', 'addon-boss' ), 'warning' );
	}
	addon_boss_import_starter_set( $starter_id );
	// An import is a saved set by another route, so it earns the same next step.
	addon_boss_option_sets_redirect(
		__( 'Ready-made set imported. It is your own copy now, edit it however you like.', 'addon-boss' ),
		'success',
		function_exists( 'addon_boss_onboarding_next_action' ) ? addon_boss_onboarding_next_action( 'set_saved' ) : array()
	);
}

// -----------------------------------------------------------------
// Export / import the whole option-sets library as one JSON file, so a
// store's colours and sizes move to another store (the concierge
// migration story). Sets keep their stable ids, so a product's saved
// attachment resolves on the other side without any re-keying.
//
// PHOTOS DO NOT TRAVEL AS BYTES, AND THAT IS DELIBERATE. A choice's photo
// is an attachment id, which means nothing on another site. The product
// transfer packs the image bytes because it carries one product; a whole
// library cannot. Measured on a modest library: 49 photos, 36 MB of
// files, 49 MB once base64'd into JSON, against a 64 MB upload ceiling
// here and 2 to 8 MB on plenty of hosts. Packing them would produce an
// export nobody could import, which is a worse feature than an honest
// one.
//
// So the file carries each photo's FILENAME, and the import resolves it
// against the media library it is landing in. The rule that matters:
// a photo is either matched to a real image on this site or cleared. An
// id is never carried across sites unresolved, because an id that points
// at a stranger's image renders a wrong photo silently, and a merchant
// with a wrong photo is worse off than one with no photo.
// -----------------------------------------------------------------

const ADDON_BOSS_OPTION_SETS_EXPORT_FORMAT = 'bundleboss-option-sets';

/**
 * Every attachment id referenced by a set's choices, and its filename.
 *
 * @param array<string,mixed> $sets
 * @return array<int,array{name:string}>
 */
function addon_boss_option_sets_photo_manifest( array $sets ): array {
	$out = array();
	foreach ( $sets as $set ) {
		foreach ( (array) ( $set['options'] ?? array() ) as $opt ) {
			$aid = (int) ( $opt['image_id'] ?? 0 );
			if ( ! $aid || isset( $out[ $aid ] ) ) {
				continue;
			}
			$file = get_attached_file( $aid );
			if ( $file ) {
				$out[ $aid ] = array( 'name' => basename( $file ) );
			}
		}
	}
	return $out;
}

/**
 * Find an attachment on THIS site by the filename it was exported under.
 *
 * Two passes, because WordPress renames a re-uploaded file: an exact
 * basename first, then the same name with a trailing "-2" style suffix
 * allowed, so a library uploaded twice still matches.
 *
 * @return int Attachment id, or 0 when this site does not have it.
 */
function addon_boss_option_sets_find_photo( string $name ): int {
	global $wpdb;
	$name = trim( $name );
	if ( '' === $name ) {
		return 0;
	}
	$exact = $wpdb->get_var(
		$wpdb->prepare(
			"SELECT post_id FROM {$wpdb->postmeta} WHERE meta_key = '_wp_attached_file' AND meta_value LIKE %s ORDER BY post_id ASC LIMIT 1",
			'%' . $wpdb->esc_like( '/' . $name )
		)
	);
	if ( $exact ) {
		return (int) $exact;
	}
	$dot  = strrpos( $name, '.' );
	$stem = false === $dot ? $name : substr( $name, 0, $dot );
	$ext  = false === $dot ? '' : substr( $name, $dot );
	$like = $wpdb->get_var(
		$wpdb->prepare(
			"SELECT post_id FROM {$wpdb->postmeta} WHERE meta_key = '_wp_attached_file' AND meta_value REGEXP %s ORDER BY post_id ASC LIMIT 1",
			'/' . preg_quote( $stem, '/' ) . '(-[0-9]+)?' . preg_quote( $ext, '/' ) . '$'
		)
	);
	return (int) $like;
}

/**
 * Point a library's photos at this site's own attachments.
 *
 * @param array<string,mixed>            $sets
 * @param array<int|string,array{name:string}> $manifest old id => filename
 * @return array{sets:array<string,mixed>,matched:int,cleared:int}
 */
function addon_boss_option_sets_land_photos( array $sets, array $manifest ): array {
	$map     = array();
	$matched = 0;
	foreach ( $manifest as $old => $info ) {
		$found = addon_boss_option_sets_find_photo( (string) ( $info['name'] ?? '' ) );
		if ( $found ) {
			$map[ (int) $old ] = $found;
			++$matched;
		}
	}
	$cleared = 0;
	foreach ( $sets as $sid => $set ) {
		foreach ( (array) ( $set['options'] ?? array() ) as $i => $opt ) {
			$aid = (int) ( $opt['image_id'] ?? 0 );
			if ( ! $aid ) {
				continue;
			}
			if ( isset( $map[ $aid ] ) ) {
				$sets[ $sid ]['options'][ $i ]['image_id'] = $map[ $aid ];
			} else {
				// Cleared, never carried: see the rule in the block comment above.
				$sets[ $sid ]['options'][ $i ]['image_id'] = 0;
				++$cleared;
			}
		}
	}
	return array(
		'sets'    => $sets,
		'matched' => $matched,
		'cleared' => $cleared,
	);
}

add_action( 'admin_post_addon_boss_export_option_sets', 'addon_boss_handle_export_option_sets' );
add_action( 'admin_post_addon_boss_import_option_sets', 'addon_boss_handle_import_option_sets' );

function addon_boss_handle_export_option_sets(): void {
	if ( ! current_user_can( 'manage_woocommerce' ) ) {
		wp_die( esc_html__( 'Sorry, you are not allowed to do that.', 'addon-boss' ) );
	}
	check_admin_referer( 'addon_boss_export_option_sets' );
	$bb_sets = addon_boss_option_sets();
	$doc     = array(
		'format'  => ADDON_BOSS_OPTION_SETS_EXPORT_FORMAT,
		'version' => 2,
		'site'    => home_url(),
		'sets'    => $bb_sets, // id => { name, options[] }
		// Filenames, not bytes. The import resolves these against its own
		// media library; see the block comment above for why.
		'photos'  => addon_boss_option_sets_photo_manifest( $bb_sets ),
	);
	nocache_headers();
	header( 'Content-Type: application/json; charset=utf-8' );
	header( 'Content-Disposition: attachment; filename="bundleboss-option-sets.json"' );
	echo wp_json_encode( $doc, JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE );
	exit;
}

function addon_boss_handle_import_option_sets(): void {
	if ( ! current_user_can( 'manage_woocommerce' ) ) {
		wp_die( esc_html__( 'Sorry, you are not allowed to do that.', 'addon-boss' ) );
	}
	check_admin_referer( 'addon_boss_import_option_sets' );

	if ( empty( $_FILES['bb_sets_file']['tmp_name'] ) || ! is_uploaded_file( $_FILES['bb_sets_file']['tmp_name'] ) ) { // phpcs:ignore WordPress.Security.ValidatedSanitizedInput -- path checked by is_uploaded_file; contents validated below.
		addon_boss_option_sets_redirect( __( 'No file was uploaded. Choose a JSON file and try again.', 'addon-boss' ), 'error' );
	}
	$raw  = (string) file_get_contents( $_FILES['bb_sets_file']['tmp_name'] ); // phpcs:ignore WordPress.WP.AlternativeFunctions.file_get_contents_file_get_contents, WordPress.Security -- just-uploaded temp file; path validated by is_uploaded_file above.
	$doc  = json_decode( $raw, true );
	if ( ! is_array( $doc ) || ( $doc['format'] ?? '' ) !== ADDON_BOSS_OPTION_SETS_EXPORT_FORMAT || empty( $doc['sets'] ) || ! is_array( $doc['sets'] ) ) {
		addon_boss_option_sets_redirect( __( 'That is not an option-sets file.', 'addon-boss' ), 'error' );
	}

	// A file from THIS site still holds valid attachment ids, so a re-import
	// in place keeps its photos untouched. A file from anywhere else has ids
	// that mean nothing here, so every photo is resolved by filename or
	// cleared. Never carried: an unresolved id renders somebody else's image.
	$bb_sets   = (array) $doc['sets'];
	$bb_same   = untrailingslashit( (string) ( $doc['site'] ?? '' ) ) === untrailingslashit( home_url() );
	$bb_photos = 0;
	$bb_lost   = 0;
	if ( ! $bb_same ) {
		$bb_landed = addon_boss_option_sets_land_photos( $bb_sets, (array) ( $doc['photos'] ?? array() ) );
		$bb_sets   = $bb_landed['sets'];
		$bb_photos = $bb_landed['matched'];
		$bb_lost   = $bb_landed['cleared'];
	}

	$imported = 0;
	// A set that follows another set in the file lands after it.
	foreach ( addon_boss_option_sets_landing_order( $bb_sets ) as $id => $set ) {
		if ( ! is_array( $set ) ) {
			continue;
		}
		// Keep the file's id so product attachments resolve; the sanitiser
		// regenerates any missing option keys and drops junk. An existing set
		// with the same id is overwritten (a re-import updates in place).
		addon_boss_save_option_set( $set, is_string( $id ) ? $id : '' );
		++$imported;
	}
	$bb_said = $imported
		/* translators: %d: number of option sets imported */
		? sprintf( _n( '%d option set imported.', '%d option sets imported.', $imported, 'addon-boss' ), $imported )
		: __( 'No option sets were found in that file.', 'addon-boss' );
	if ( $imported && ( $bb_photos || $bb_lost ) ) {
		$bb_said .= ' ' . sprintf(
			/* translators: 1: photos found in this shop's media library, 2: photos that could not be found */
			_n( '%1$d photo was matched to an image already in your library, and %2$d could not be found, so those choices came in without a picture.', '%1$d photos were matched to images already in your library, and %2$d could not be found, so those choices came in without a picture.', $bb_photos, 'addon-boss' ),
			$bb_photos,
			$bb_lost
		);
	}
	addon_boss_option_sets_redirect(
		$bb_said,
		$imported ? 'success' : 'warning'
	);
}

// =================================================================
// Admin: the product panel ("Options this product comes in")
// =================================================================

add_filter( 'woocommerce_product_data_tabs', 'addon_boss_product_options_tab' );
add_action( 'woocommerce_product_data_panels', 'addon_boss_product_options_panel' );
add_action( 'woocommerce_admin_process_product_object', 'addon_boss_product_options_save' );

function addon_boss_product_options_tab( array $tabs ): array {
	// No tab, no panel, no save handler reached. The stored config is left
	// exactly as it is, so switching the feature back on restores every product
	// untouched rather than to an empty one.
	if ( ! addon_boss_options_available() ) {
		return $tabs;
	}
	$tabs['bundle_boss_options'] = array(
		// "Product options": the feature's public name (docs, website), and
		// unambiguous next to WooCommerce's own Attributes tab. His call.
		'label'    => __( 'Product options', 'addon-boss' ),
		'target'   => 'bundle_boss_options_panel',
		'class'    => array( 'show_if_simple', 'show_if_variable' ), // sets ride on variables as extras; variations keep stock and photos.
		'priority' => 65,
	);
	return $tabs;
}

// -----------------------------------------------------------------
// Suggest photos: deterministic option-to-image matching. The engine
// proposes, a review sheet shows every proposal WITH its reason, and
// nothing persists until the merchant applies and saves. Trust order:
// the product's own photos first, then the media library by file name
// and title. Options that already carry a photo are never touched.
// -----------------------------------------------------------------


/**
 * Hidden inputs reposting a stored value tree exactly as it stands, so a save
 * from a build that cannot edit the thing carries it whole rather than
 * quietly dropping it. Data only: names are escaped path segments, leaves are
 * scalars; nothing here reads or interprets what it carries.
 *
 * @param string $name  The input name prefix, e.g. bb_pf[3].
 * @param mixed  $value The stored subtree.
 */
function addon_boss_hidden_carriers( string $name, $value ): void {
	if ( is_array( $value ) ) {
		foreach ( $value as $k => $v ) {
			addon_boss_hidden_carriers( $name . '[' . $k . ']', $v );
		}
		return;
	}
	if ( is_bool( $value ) ) {
		$value = $value ? '1' : '';
	}
	echo '<input type="hidden" name="' . esc_attr( $name ) . '" value="' . esc_attr( (string) $value ) . '">';
}

/**
 * Hidden inputs reposting a field row's stored reveal rule in the exact shape
 * the rule editor posts, so a build with no editor for it still carries the
 * rule through a save. Both stored shapes serialise: the legacy single rule
 * and the canonical multi-condition one. Data traversal only; nothing here
 * evaluates anything.
 *
 * @param string $ix   The row index.
 * @param array  $when The stored rule.
 */
function addon_boss_field_when_carriers( string $ix, array $when ): void {
	if ( ! $when ) {
		return;
	}
	// One carrier, the canonical shape as json. Every stored shape — legacy
	// single, flat list, groups — reads into it whole, so a rule of any age or
	// richness survives a save from a build that cannot edit it.
	$bb_norm = addon_boss_when_to_groups( $when );
	if ( ! $bb_norm['groups'] ) {
		return;
	}
	echo '<input type="hidden" name="bb_pf_when_json[' . esc_attr( $ix ) . ']" value="' . esc_attr( (string) wp_json_encode( $bb_norm ) ) . '">';
}

/**
 * A field whose TYPE this build has no module for: a plain card naming it, a
 * remove control, and hidden carriers reposting the stored def and rule
 * whole, so pressing Update rewrites nothing and the field returns intact the
 * moment its module is installed. Nothing here is editable, because the build
 * has no controls that could honestly edit it.
 *
 * @param mixed $i     The row index.
 * @param array $field The stored def.
 * @param array $when  The stored reveal rule.
 */
function addon_boss_render_inert_field_row( $i, array $field, array $when = array() ): void {
	$ix    = esc_attr( (string) $i );
	$type  = (string) ( $field['type'] ?? '' );
	$label = (string) ( $field['label'] ?? '' );
	?>
	<div class="bb-po-row bb-po-fieldrow bb-po-inertrow" data-idx="<?php echo (int) $ix; ?>" data-type="<?php echo esc_attr( $type ); ?>">
		<div class="bb-po-line">
			<span class="bb-po-caret" aria-hidden="true">&#9656;</span>
			<span class="bb-po-fieldpill"><?php esc_html_e( 'Field', 'addon-boss' ); ?></span>
			<b class="bb-pf-headlabel"><?php echo esc_html( '' !== $label ? $label : $type ); ?></b>
			<span class="bb-po-sum bb-pf-sum"><?php
				/* translators: %s: the stored field type, e.g. size */
				echo esc_html( sprintf( __( '%s. This build does not offer it; its settings are kept as saved.', 'addon-boss' ), $type ) );
			?></span>
			<button type="button" class="bb-po-remove" aria-label="<?php esc_attr_e( 'Remove this field', 'addon-boss' ); ?>">&#10005;</button>
			<?php
			addon_boss_hidden_carriers( 'bb_pf[' . (string) $ix . ']', $field );
			addon_boss_field_when_carriers( (string) $ix, $when );
			?>
			<input type="hidden" class="bb-po-orderkey" value="field-<?php echo (int) $ix; ?>">
		</div>
	</div>
	<?php
}

/**
 * One FIELD row in the unified product-options list, in the same .bb-po-row
 * shell as a set row so it folds, removes and sorts with them. The editor
 * reuses the personalisation field-def field NAMES (label/type/require/fee/
 * fee_mode/maxlength/max_size) so the shared sanitiser handles it verbatim.
 * $i may be the placeholder '__PFIDX__' when rendered into the JS template.
 *
 * @param bool $force_when Render the rule editor even with nothing to point at
 *                         YET. True only for the new-row TEMPLATE: what a row
 *                         cloned from it may point at depends on where it lands,
 *                         which is not knowable when the template is printed.
 *                         Gating it on the template's own (empty) lists is what
 *                         left a fields-only product unable to rule at all.
 */
function addon_boss_render_product_field_row( $i, array $field, array $when = array(), array $sibling_sets = array(), array $sibling_fields = array(), bool $force_when = false ): void {
	$types   = function_exists( 'addon_boss_personalisation_field_types' ) ? addon_boss_personalisation_field_types() : array();
	$type    = (string) ( $field['type'] ?? 'text' );
	// A stored type nothing registered gets the preserved card instead of an
	// editor this build could not honestly offer.
	if ( '' !== $type && ! isset( $types[ $type ] ) ) {
		addon_boss_render_inert_field_row( $i, $field, $when );
		return;
	}
	$label   = (string) ( $field['label'] ?? '' );
	$reqmode = ! empty( $field['required'] ) ? 'always' : '';
	$fee     = (float) ( $field['fee'] ?? 0 );
	$mode    = (string) ( $field['fee_mode'] ?? 'unit' );
	$sym     = html_entity_decode( get_woocommerce_currency_symbol() );
	$heading = ! empty( $types[ $type ]['display_only'] );
	// NEVER cast this to (int) at an echo: $i may be the literal '__PFIDX__'
	// placeholder rendered into the add-a-field <template>, and a cast turns it
	// into 0, so every row the button adds posts under bb_pf[0] and the save
	// clones one row's data over the others. Proven as real admin data loss
	// (ProductFieldRowTemplateTest pins the placeholder's survival).
	$ix      = esc_attr( (string) $i );
	$mode_lbls = addon_boss_fee_modes();
	$bits    = array( $heading ? __( 'Heading', 'addon-boss' ) : ( 'always' === $reqmode ? __( 'Required', 'addon-boss' ) : __( 'Optional', 'addon-boss' ) ) );
	// A block whose label is only for this list says so on its closed line, or a
	// merchant hunting a heading that will not appear has nothing to go on.
	if ( 'html' === $type && ! empty( $field['hide_title'] ) ) {
		$bits[] = __( 'Label hidden', 'addon-boss' );
	}
	if ( $fee > 0 && ! $heading ) {
		$num = rtrim( rtrim( number_format( $fee, 2 ), '0' ), '.' );
		// A type or mode whose charge reads in its own words (per square metre,
		// a share of the price) says so through the module that owns it; the
		// engine's own modes read from the menu wording, and a mode this build
		// has no module for is named plainly.
		$bb_bit = (string) apply_filters( 'addon_boss_field_fee_bit', '', $field, $num, $sym );
		// The summary reads the SHORT form ("+£2.50 for each"); the menu keeps
		// the category's names ("Quantity based"), which read as labels, not
		// as the tail of a sentence.
		$mode_shorts = addon_boss_fee_mode_shorts();
		$bits[]      = '' !== $bb_bit ? $bb_bit : '+' . $sym . $num . ' ' . ( $mode_shorts[ $mode ] ?? $mode_lbls[ $mode ] ?? $mode );
	}
	// A module with something to say about this row on its closed line (a
	// placement announcing itself, a rule owning up) says it through this seam.
	$bits = (array) apply_filters( 'addon_boss_field_row_bits', $bits, $field, $type, $when );
	?>
	<div class="bb-po-row bb-po-fieldrow" data-idx="<?php echo esc_attr( (string) $ix ); ?>" data-type="<?php echo esc_attr( $type ); ?>">
		<div class="bb-po-line">
			<span class="bb-po-caret" aria-hidden="true">&#9656;</span>
			<span class="bb-po-fieldpill"><?php esc_html_e( 'Field', 'addon-boss' ); ?></span>
			<b class="bb-pf-headlabel"><?php echo esc_html( '' !== $label ? $label : __( 'New field', 'addon-boss' ) ); ?></b>
			<span class="bb-po-sum bb-pf-sum"><?php echo esc_html( implode( ' · ', $bits ) ); ?></span>
			<button type="button" class="bb-po-remove" aria-label="<?php esc_attr_e( 'Remove this field', 'addon-boss' ); ?>">&#10005;</button>
			<input type="hidden" name="bb_pf[<?php echo esc_attr( (string) $ix ); ?>][key]" value="<?php echo esc_attr( (string) ( $field['key'] ?? '' ) ); ?>">
			<input type="hidden" class="bb-po-orderkey" value="field-<?php echo esc_attr( (string) $ix ); ?>">
		</div>
		<div class="bb-po-body"<?php echo '' !== $label ? ' hidden' : ''; ?>>
			<div class="bb-pf-editor">
				<div class="bb-pf-line">
					<input type="text" name="bb_pf[<?php echo esc_attr( (string) $ix ); ?>][label]" value="<?php echo esc_attr( $label ); ?>"
						class="bb-pf-label" placeholder="<?php esc_attr_e( 'Field label, e.g. Name to print', 'addon-boss' ); ?>">
					<select name="bb_pf[<?php echo esc_attr( (string) $ix ); ?>][type]" class="bb-pf-type">
						<?php
						// The SAME list the add bar offers, in the same words. These
						// two were written separately and drifted: this one showed
						// types the build has no code for, and printed each type's
						// bare label where the add bar printed its menu wording, so
						// one control had two names depending on where you met it.
						// The field's own type rides along even when the build no
						// longer offers it, or the row would show somebody else's
						// type and change the field on the next save.
						foreach ( addon_boss_field_type_menu( $type ) as $tk => $twords ) :
							?>
							<option value="<?php echo esc_attr( $tk ); ?>" <?php selected( $type, $tk ); ?>><?php echo esc_html( $twords ); ?></option>
						<?php endforeach; ?>
					</select>
				</div>
				<div class="bb-pf-settings"<?php echo $heading ? ' hidden' : ''; ?>>
				<?php
				// One level of labelled groups, never tabs: we sit inside a WooCommerce
				// Product Data tab (nesting is out) and these settings are
				// interdependent (type drives fee mode drives the rest), which is the
				// documented test for when tabs are the wrong control. A group hides
				// itself when the field type makes every control in it irrelevant, and
				// a single remaining group drops its heading so a simple field still
				// reads as one flat row.
				?>
				<?php
				// Group visibility is decided HERE, not only in JS, so the very first
				// paint is already correct: a text field must never flash (or keep, if
				// JS fails) an empty "Image size" heading. Only a file field has more
				// than one group, so it is also what decides whether the headings earn
				// their space at all.
				// Escaped where they are printed below, not because either can hold
				// anything but the two literals above, but because an echoed
				// variable should be verifiably safe at the line that echoes it,
				// without tracing it back here to be sure.
				// The General heading only earns its space when a module's own groups
				// share the row with it (a file field's accept and image rules).
				$grp_solo = (bool) apply_filters( 'addon_boss_field_row_groups_visible', false, $type ) ? '' : ' hidden';
				?>
				<div class="bb-pf-grp" data-grp="ask">
					<h5 class="bb-pf-grph"<?php echo esc_attr( $grp_solo ); ?>><?php esc_html_e( 'General', 'addon-boss' ); ?></h5>
					<div class="bb-pf-grprow">
					<?php
					// First control under the label, which is where every comparable
					// builder puts it: Gravity Forms, WPForms, ACF, Product Add-Ons,
					// PPOM and ThemeHigh all place Description directly beneath the
					// field's name. It starts empty and stays empty until the merchant
					// writes something. NOTHING is ever seeded here, not even as
					// placeholder text: no product in this category pre-fills the box,
					// and a sentence nobody wrote that ships anyway is exactly the trap
					// that has one free delivery plugin promising "we will try our best
					// to deliver your order on the specified date" on every checkout
					// that ever installed it, true or not.
					//
					// The hint names WHO reads it, because half the category's version
					// of this control is admin-only guidance (ACF's Instructions is
					// read by whoever edits the post, never by a customer), and one
					// word settles which of the two this is.
					?>
					<label class="bb-pf-ctl bb-pf-desc"><span><?php esc_html_e( 'Description', 'addon-boss' ); ?></span>
						<input type="text" name="bb_pf[<?php echo esc_attr( (string) $ix ); ?>][description]" value="<?php echo esc_attr( (string) ( $field['description'] ?? '' ) ); ?>" class="bb-pf-desc-in">
						<span class="description bb-pf-deschint"><?php esc_html_e( 'Shown to shoppers below the field.', 'addon-boss' ); ?></span>
					</label>
					<?php
					// "Required" as a tick, the whole category's shape (Gravity,
					// WPForms, APF, PPOM, EPO and core's own `required` flag all
					// name it exactly this). Ticked posts 'always', unticked posts
					// nothing, which is precisely what the sanitiser already reads,
					// so stored fields round-trip untouched.
					?>
					<label class="bb-pf-ctl bb-pf-reqctl"><span><?php esc_html_e( 'Required', 'addon-boss' ); ?></span>
						<input type="checkbox" name="bb_pf[<?php echo esc_attr( (string) $ix ); ?>][require]" value="always" <?php checked( 'always', $reqmode ); ?> class="bb-pf-require">
					</label>
					<label class="bb-pf-ctl bb-pf-charge"<?php echo in_array( $type, array( 'color', 'price', 'hidden', 'select' ), true ) ? ' hidden' : ''; ?>><span><?php esc_html_e( 'Price', 'addon-boss' ); ?></span>
						<span class="bb-pf-feebox">
							<span class="bb-pf-feesym"<?php echo 'percent' === $mode ? ' hidden' : ''; ?>><?php echo esc_html( $sym ); ?></span>
							<input type="text" name="bb_pf[<?php echo esc_attr( (string) $ix ); ?>][fee]" value="<?php echo $fee > 0 ? esc_attr( rtrim( rtrim( number_format( $fee, 2 ), '0' ), '.' ) ) : ''; ?>" class="bb-pf-fee" placeholder="0">
							<span class="bb-pf-feepct"<?php echo 'percent' === $mode ? '' : ' hidden'; ?>>%</span>
						</span>
					</label>
					<?php
					// A type whose charge is its own maths hides the shared mode
					// menu (its own control renders through the seam below).
					$bb_own_fm = '' !== (string) ( $types[ $type ]['own_fee_mode'] ?? '' );
					// "Price type" beside "Price", the shape the category settled on
					// (Extra Product Options names it exactly this; Product Add-Ons
					// and Advanced Product Fields both pair an amount with a type
					// menu). It carries .bb-pf-charge too, so the one rule that
					// hides the charge for a colour or a dropdown hides both.
					?>
					<label class="bb-pf-ctl bb-pf-charge bb-pf-pricetype"<?php echo in_array( $type, array( 'color', 'price', 'hidden', 'select' ), true ) ? ' hidden' : ''; ?>><span><?php esc_html_e( 'Price type', 'addon-boss' ); ?></span>
						<select name="bb_pf[<?php echo esc_attr( (string) $ix ); ?>][fee_mode]" class="bb-pf-feemode"<?php echo $bb_own_fm ? ' hidden' : ''; ?>>
							<?php
							// The menu lists exactly the modes this build has maths for.
							// A field already saved with a mode nothing registered keeps
							// its own entry, named plainly, so opening the editor can
							// never silently reprice it.
							$bb_menu_modes = addon_boss_fee_modes();
							if ( '' !== $mode && ! isset( $bb_menu_modes[ $mode ] ) ) {
								$bb_menu_modes[ $mode ] = $mode;
							}
							foreach ( $bb_menu_modes as $bb_fm => $bb_fm_label ) {
								printf(
									'<option value="%1$s" %2$s>%3$s</option>',
									esc_attr( $bb_fm ),
									selected( $mode, $bb_fm, false ),
									esc_html( $bb_fm_label )
								);
							}
							?>
						</select>
						<?php
						// A type's own charge control (a measured size's per-square unit
						// picker) rides in from the module that registered the type.
						do_action( 'addon_boss_field_row_fee_extra', $ix, $field, $type );

						// WHAT THE CHOSEN MODE DOES, and only that one.
						//
						// The label used to carry a sentence explaining "for each"
						// and "once" together, above the controls. It was a wall of
						// text AND incomplete: this menu offers five modes, and the
						// three it never mentioned are the ones a merchant is least
						// likely to guess. A merchant only needs the one they picked,
						// which is the rule the repeatable panel already follows.
						$bb_fm_attrs = '';
						foreach ( addon_boss_fee_modes() as $bb_fmk => $bb_fml ) {
							$bb_n = addon_boss_fee_mode_note( (string) $bb_fmk );
							if ( '' !== $bb_n ) {
								$bb_fm_attrs .= ' data-note-' . esc_attr( $bb_fmk ) . '="' . esc_attr( $bb_n ) . '"';
							}
						}
						$bb_fm_now = addon_boss_fee_mode_note( (string) $mode );
						?>
						<span class="description bb-pf-charge-note"<?php
							echo $bb_fm_attrs; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- name and value are esc_attr'd as each pair is built above.
							// A type with a charge of its own (a size, per square
							// unit) shows no menu, so no note about one: "Charged per
							// item: two shirts, twice." stood under glass (walk 5).
							echo '' === $bb_fm_now || $bb_own_fm ? ' hidden' : '';
						?>><?php echo esc_html( $bb_fm_now ); ?></span>
					</label>
					<label class="bb-pf-ctl bb-pf-max"<?php echo in_array( $type, array( 'text', 'textarea' ), true ) ? '' : ' hidden'; ?>><span><?php esc_html_e( 'Max length', 'addon-boss' ); ?></span>
						<input type="number" min="0" step="1" name="bb_pf[<?php echo esc_attr( (string) $ix ); ?>][maxlength]" value="<?php echo ! empty( $field['maxlength'] ) ? (int) $field['maxlength'] : ''; ?>" class="bb-pf-maxlength">
					</label>
					<label class="bb-pf-ctl bb-pf-numlo"<?php echo 'number' === $type ? '' : ' hidden'; ?>><span><?php esc_html_e( 'Minimum', 'addon-boss' ); ?></span>
						<input type="number" step="any" name="bb_pf[<?php echo esc_attr( (string) $ix ); ?>][num_min]" value="<?php echo isset( $field['num_min'] ) ? esc_attr( (string) ( $field['num_min'] + 0 ) ) : ''; ?>" class="bb-pf-shortnum" placeholder="0">
					</label>
					<label class="bb-pf-ctl bb-pf-numhi"<?php echo 'number' === $type ? '' : ' hidden'; ?>><span><?php esc_html_e( 'Maximum', 'addon-boss' ); ?></span>
						<input type="number" step="any" name="bb_pf[<?php echo esc_attr( (string) $ix ); ?>][num_max]" value="<?php echo isset( $field['num_max'] ) ? esc_attr( (string) ( $field['num_max'] + 0 ) ) : ''; ?>" class="bb-pf-shortnum" placeholder="<?php esc_attr_e( 'none', 'addon-boss' ); ?>">
					</label>
					<label class="bb-pf-ctl bb-pf-numwhole"<?php echo 'number' === $type ? '' : ' hidden'; ?>><span><?php esc_html_e( 'Whole numbers only', 'addon-boss' ); ?></span>
						<input type="checkbox" name="bb_pf[<?php echo esc_attr( (string) $ix ); ?>][num_whole]" value="1" <?php checked( ! empty( $field['num_whole'] ) ); ?> class="bb-pf-numwhole-in">
					</label>
					<?php
					// Name your price: the shopper types the amount, so there is no Charge
					// box; the merchant sets the fences and, if they like, a few
					// suggested amounts typed as one comma list. Every control on one
					// row, every helper in the placeholder, nothing to read first.
					$bb_is_price = ( 'price' === $type );
					?>
					<label class="bb-pf-ctl bb-pf-pricemin"<?php echo $bb_is_price ? '' : ' hidden'; ?>><span><?php esc_html_e( 'Minimum', 'addon-boss' ); ?></span>
						<input type="text" inputmode="decimal" name="bb_pf[<?php echo esc_attr( (string) $ix ); ?>][price_min]" value="<?php echo isset( $field['price_min'] ) ? esc_attr( (string) $field['price_min'] ) : ''; ?>" class="bb-pf-shortnum" placeholder="<?php esc_attr_e( 'none', 'addon-boss' ); ?>">
					</label>
					<label class="bb-pf-ctl bb-pf-pricemax"<?php echo $bb_is_price ? '' : ' hidden'; ?>><span><?php esc_html_e( 'Maximum', 'addon-boss' ); ?></span>
						<input type="text" inputmode="decimal" name="bb_pf[<?php echo esc_attr( (string) $ix ); ?>][price_max]" value="<?php echo isset( $field['price_max'] ) ? esc_attr( (string) $field['price_max'] ) : ''; ?>" class="bb-pf-shortnum" placeholder="<?php esc_attr_e( 'none', 'addon-boss' ); ?>">
					</label>
					<label class="bb-pf-ctl bb-pf-pricesug"<?php echo $bb_is_price ? '' : ' hidden'; ?>><span><?php esc_html_e( 'Suggested', 'addon-boss' ); ?></span>
						<input type="text" inputmode="decimal" name="bb_pf[<?php echo esc_attr( (string) $ix ); ?>][price_suggested]" value="<?php echo isset( $field['price_suggested'] ) ? esc_attr( (string) $field['price_suggested'] ) : ''; ?>" class="bb-pf-shortnum" placeholder="<?php esc_attr_e( 'none', 'addon-boss' ); ?>">
					</label>
					<label class="bb-pf-ctl bb-pf-priceamts"<?php echo $bb_is_price ? '' : ' hidden'; ?>><span><?php esc_html_e( 'Suggested amounts', 'addon-boss' ); ?><?php
						addon_boss_options_addctl_tip( __( 'Up to five one-tap amounts. Shoppers can still type their own.', 'addon-boss' ) );
					?></span>
						<input type="text" name="bb_pf[<?php echo esc_attr( (string) $ix ); ?>][price_amounts]" value="<?php echo esc_attr( implode( ', ', array_map( 'strval', (array) ( $field['price_amounts'] ?? array() ) ) ) ); ?>" class="bb-pf-priceamounts" placeholder="5, 10, 20">
					</label>
					<?php
					// Hidden: a note from the merchant to their own order screen. One
					// value, and an off-by-default switch for filling it from a link.
					$bb_is_hidden = ( 'hidden' === $type );
					?>
					<label class="bb-pf-ctl bb-pf-hiddenval"<?php echo $bb_is_hidden ? '' : ' hidden'; ?>><span><?php esc_html_e( 'Value', 'addon-boss' ); ?><?php
						addon_boss_options_addctl_tip( __( 'Saved on every order, shown only to you.', 'addon-boss' ) );
					?></span>
						<input type="text" name="bb_pf[<?php echo esc_attr( (string) $ix ); ?>][value]" value="<?php echo esc_attr( (string) ( $field['value'] ?? '' ) ); ?>" class="bb-pf-hiddenvalue" placeholder="<?php esc_attr_e( 'e.g. DTF-B', 'addon-boss' ); ?>">
					</label>
					<label class="bb-pf-ctl bb-pf-hiddenurl"<?php echo $bb_is_hidden ? '' : ' hidden'; ?>><span><?php esc_html_e( 'Allow fill from link', 'addon-boss' ); ?><?php
						addon_boss_options_addctl_tip( __( 'Links ending ?fieldkey=value set it. Leave off unless you send them.', 'addon-boss' ) );
					?></span>
						<input type="checkbox" name="bb_pf[<?php echo esc_attr( (string) $ix ); ?>][url_fill]" value="1" <?php checked( ! empty( $field['url_fill'] ) ); ?> class="bb-pf-hiddenurlfill">
					</label>
					</div>
				</div>
					<?php
					// The colour field's swatches: label + the colour itself + an
					// optional charge, one row each. Its own group BESIDE the ask row
					// (never inside it) because a swatch list is taller than a control
					// slot, and group visibility is derived from a group's own children.
					$bb_is_color   = ( 'color' === $type );
					$bb_color_opts = $bb_is_color ? (array) ( $field['options'] ?? array() ) : array();
					?>
					<div class="bb-pf-grp bb-pf-colourgrp" data-grp="colours"<?php echo $bb_is_color ? '' : ' hidden'; ?>>
						<h5 class="bb-pf-grph"><?php esc_html_e( 'The colours', 'addon-boss' ); ?></h5>
						<div class="bb-pf-colourrows">
						<?php
						$bb_ci = 0;
						foreach ( $bb_color_opts as $bb_copt ) {
							printf(
								'<div class="bb-pf-colourrow">'
								. '<input type="text" name="bb_pf[%1$s][options][%2$d][label]" value="%3$s" class="bb-pf-colourlabel" placeholder="%4$s">'
								. '<input type="color" name="bb_pf[%1$s][options][%2$d][color]" value="%5$s" class="bb-pf-colourpick">'
								. '<span class="bb-pf-feebox"><span class="bb-pf-feesym">%6$s</span><input type="text" name="bb_pf[%1$s][options][%2$d][fee]" value="%7$s" class="bb-pf-colourfee" placeholder="0"></span>'
								. '<input type="hidden" name="bb_pf[%1$s][options][%2$d][value]" value="%8$s">'
								. '<button type="button" class="bb-po-remove bb-pf-colourdel" aria-label="%9$s">&#10005;</button>'
								. '</div>',
								esc_attr( (string) $ix ),
								(int) $bb_ci,
								esc_attr( (string) ( $bb_copt['label'] ?? '' ) ),
								esc_attr__( 'Colour name, e.g. Ruby', 'addon-boss' ),
								esc_attr( (string) ( $bb_copt['color'] ?? '#cccccc' ) ),
								esc_html( $sym ),
								(float) ( $bb_copt['fee'] ?? 0 ) > 0 ? esc_attr( rtrim( rtrim( number_format( (float) $bb_copt['fee'], 2 ), '0' ), '.' ) ) : '',
								esc_attr( (string) ( $bb_copt['value'] ?? '' ) ),
								esc_attr__( 'Remove this colour', 'addon-boss' )
							);
							$bb_ci++;
						}
						?>
						</div>
						<button type="button" class="bb-po-ghostbtn bb-pf-colouradd" data-ix="<?php echo esc_attr( (string) $ix ); ?>"><?php esc_html_e( '+ Add a colour', 'addon-boss' ); ?></button>
						<label class="bb-pf-ctl bb-pf-colourcustom"<?php echo $bb_is_color ? '' : ' hidden'; ?>><span><?php esc_html_e( 'Also allow any colour', 'addon-boss' ); ?><?php
							addon_boss_options_addctl_tip( __( 'Adds a Custom swatch: shoppers pick any colour.', 'addon-boss' ) );
						?></span>
							<input type="checkbox" name="bb_pf[<?php echo esc_attr( (string) $ix ); ?>][allow_custom]" value="1" <?php checked( ! empty( $field['allow_custom'] ) ); ?> class="bb-pf-colourallow">
							<span class="bb-pf-feebox bb-pf-colourcfee"<?php echo empty( $field['allow_custom'] ) ? ' hidden' : ''; ?>><span class="bb-pf-feesym"><?php echo esc_html( $sym ); ?></span><input type="text" name="bb_pf[<?php echo esc_attr( (string) $ix ); ?>][custom_fee]" value="<?php echo (float) ( $field['custom_fee'] ?? 0 ) > 0 ? esc_attr( rtrim( rtrim( number_format( (float) $field['custom_fee'], 2 ), '0' ), '.' ) ) : ''; ?>" class="bb-pf-colourcustomfee" placeholder="0"></span>
						</label>
					</div>
						<?php
						// The dropdown field's choices: label + an optional charge, one
						// row each — the colour repeater minus the swatch. Until this
						// group existed a Dropdown could only be authored by import or
						// code: the storefront rendered its choices while the editor
						// offered nowhere to see or change them. Both repeaters post the
						// same options[] names; only the ACTIVE type's group holds rows,
						// and the sanitiser reads label, value and fee from either.
						$bb_is_select   = ( 'select' === $type );
						$bb_select_opts = $bb_is_select ? (array) ( $field['options'] ?? array() ) : array();
						?>
						<div class="bb-pf-grp bb-pf-choicegrp" data-grp="choices"<?php echo $bb_is_select ? '' : ' hidden'; ?>>
							<h5 class="bb-pf-grph"><?php esc_html_e( 'The choices', 'addon-boss' ); ?></h5>
							<div class="bb-pf-choicerows"<?php echo $bb_is_select ? '' : ' hidden'; ?>>
							<?php
							$bb_si = 0;
							foreach ( $bb_select_opts as $bb_sopt ) {
								printf(
									'<div class="bb-pf-colourrow bb-pf-choicerow">'
									. '<input type="text" name="bb_pf[%1$s][options][%2$d][label]" value="%3$s" class="bb-pf-colourlabel bb-pf-choicelabel" placeholder="%4$s">'
									. '<span class="bb-pf-feebox"><span class="bb-pf-feesym">%5$s</span><input type="text" name="bb_pf[%1$s][options][%2$d][fee]" value="%6$s" class="bb-pf-colourfee bb-pf-choicefee" placeholder="0"></span>'
									. '<input type="hidden" name="bb_pf[%1$s][options][%2$d][value]" value="%7$s">'
									. '<button type="button" class="bb-po-remove bb-pf-choicedel" aria-label="%8$s">&#10005;</button>'
									. '</div>',
									esc_attr( (string) $ix ),
									(int) $bb_si,
									esc_attr( (string) ( $bb_sopt['label'] ?? '' ) ),
									esc_attr__( 'Choice name, e.g. New artwork', 'addon-boss' ),
									esc_html( $sym ),
									(float) ( $bb_sopt['fee'] ?? 0 ) > 0 ? esc_attr( rtrim( rtrim( number_format( (float) $bb_sopt['fee'], 2 ), '0' ), '.' ) ) : '',
									esc_attr( (string) ( $bb_sopt['value'] ?? '' ) ),
									esc_attr__( 'Remove this choice', 'addon-boss' )
								);
								$bb_si++;
							}
							?>
							</div>
							<button type="button" class="bb-po-ghostbtn bb-pf-choiceadd" data-ix="<?php echo esc_attr( (string) $ix ); ?>"><?php esc_html_e( '+ Add a choice', 'addon-boss' ); ?></button>
						</div>
				<?php
				// The repeat panel (ask this field several times) rides in from the
				// module that owns repeats; a build without one reposts a stored
				// repeat setting through hidden carriers instead, so a save never
				// drops what the merchant chose while they had it.
				if ( ! (bool) apply_filters( 'addon_boss_field_row_repeat_editor', false, $ix, $field, $mode ) ) {
					addon_boss_hidden_carriers( 'bb_pf[' . (string) $ix . ']', array_intersect_key( $field, array( 'repeat' => 1, 'repeat_max' => 1, 'repeat_label' => 1 ) ) );
				}
				// The same rule for a date field's calendar: a build without the
				// module draws none of its controls, so the stored settings repost
				// on carriers instead of disappearing at the next save.
				if ( 'date' === $type && ! is_callable( addon_boss_personalisation_field_types()['date']['sanitize_def'] ?? null ) ) {
					addon_boss_hidden_carriers(
						'bb_pf[' . (string) $ix . ']',
						array_intersect_key(
							$field,
							array(
								'prep_days'    => 1,
								'book_ahead'   => 1,
								'cutoff'       => 1,
								'closed_days'  => 1,
								'closed_dates' => 1,
								'date_face'    => 1,
								'date_bands'   => 1,
								)
						)
					);
				}
				?>
				<?php
				// The upload module's own groups (what it accepts, the image size,
				// tidying what they send) ride in from that module; a build without
				// it offers none of these controls.
				do_action( 'addon_boss_field_row_extra_groups', $ix, $field, $type );
				?>
				</div>
				<?php
				// Which variations this field is for needs the product, fetched
				// once here for the block below.
				$bb_post = get_post();
				?>
				<?php
				// Which variations this field is for. Only worth asking on a variable
				// product that actually has variations, so a simple product's panel
				// never grows a control about something it does not have.
				$bb_vars = array();
				if ( $bb_post ) {
					$bb_vprod = wc_get_product( $bb_post->ID );
					if ( $bb_vprod instanceof WC_Product && $bb_vprod->is_type( 'variable' ) ) {
						foreach ( $bb_vprod->get_children() as $bb_vid ) {
							$bb_v = wc_get_product( $bb_vid );
							if ( $bb_v ) {
								$bb_vlab = wc_get_formatted_variation( $bb_v, true, false );
								$bb_vars[ (int) $bb_vid ] = '' !== $bb_vlab ? $bb_vlab : ( '#' . (int) $bb_vid );
							}
						}
					}
				}
				$bb_only = array_map( 'absint', (array) ( $field['only_variations'] ?? array() ) );
				?>
				<?php if ( $bb_vars ) : ?>
				<div class="bb-pf-vars">
					<span class="bb-pfp-lab"><?php esc_html_e( 'Which variations is it for', 'addon-boss' ); ?></span>
					<label class="bb-pf-varall">
						<input type="checkbox" class="bb-pf-varall-cb" <?php checked( empty( $bb_only ) ); ?>>
						<span><?php esc_html_e( 'All of them', 'addon-boss' ); ?></span>
					</label>
					<div class="bb-pf-varlist"<?php echo empty( $bb_only ) ? ' hidden' : ''; ?>>
						<?php foreach ( $bb_vars as $bb_vid => $bb_vlabel ) : ?>
							<label class="bb-pf-var">
								<input type="checkbox" name="bb_pf[<?php echo esc_attr( (string) $ix ); ?>][only_variations][]" value="<?php echo (int) $bb_vid; ?>" <?php checked( in_array( (int) $bb_vid, $bb_only, true ) ); ?>>
								<span><?php echo esc_html( $bb_vlabel ); ?></span>
							</label>
						<?php endforeach; ?>
					</div>
				</div>
				<?php endif; ?>
					<?php
					// The placement editor (show this field on the product photo)
					// rides in from the module that draws placements; a build
					// without one reposts a stored placement through hidden
					// carriers instead, so a save never drops it.
					if ( ! (bool) apply_filters( 'addon_boss_field_row_placement_editor', false, $ix, $field, $type )
						&& is_array( $field['preview'] ?? null ) && $field['preview'] ) {
						addon_boss_hidden_carriers( 'bb_pf[' . (string) $ix . '][preview]', $field['preview'] );
					}
					?>
				<div class="bb-pf-htmlbox"<?php echo 'html' === $type ? '' : ' hidden'; ?>>
					<label class="bb-pf-ctl bb-pf-contentctl"><span><?php esc_html_e( 'Content (text or HTML)', 'addon-boss' ); ?></span>
						<textarea name="bb_pf[<?php echo esc_attr( (string) $ix ); ?>][content]" class="bb-pf-content" rows="4" placeholder="<?php esc_attr_e( 'Shown to customers. Basic HTML is allowed: bold, lists, links.', 'addon-boss' ); ?>"><?php echo esc_textarea( (string) ( $field['content'] ?? '' ) ); ?></textarea>
					</label>
					<?php
					// The zero carrier goes FIRST so unticking the box posts a
					// fact rather than an absence: an absent key is what a stored
					// block re-sanitised through an import looks like, and that
					// must leave the heading alone.
					?>
					<input type="hidden" name="bb_pf[<?php echo esc_attr( (string) $ix ); ?>][show_title]" value="0">
					<label class="bb-pf-cbhint">
						<input type="checkbox" name="bb_pf[<?php echo esc_attr( (string) $ix ); ?>][show_title]" value="1" <?php checked( empty( $field['hide_title'] ) ); ?>>
						<?php esc_html_e( 'Show the label above this block', 'addon-boss' ); ?>
						<em class="bb-po-hint"><?php esc_html_e( 'The label always names this block in the list here. Untick and the customer sees the content on its own.', 'addon-boss' ); ?></em>
					</label>
				</div>
				<?php
				// The reveal-rule builder rides in from the module that evaluates
				// such rules; a build without one reposts a stored rule through
				// hidden carriers instead, so a save never drops it.
				if ( ! (bool) apply_filters( 'addon_boss_field_row_when_editor', false, $ix, $when, $sibling_sets, $sibling_fields, $force_when ) ) {
					addon_boss_field_when_carriers( (string) $ix, $when );
				}
				?>
			</div>
		</div>
	</div>
	<?php
}

/**
 * One GROUP header row in the admin list. A section marker: its members are
 * the rows dragged beneath it (positional), so it holds only a name. It
 * carries its own bb_po_order key (group-<i>) so the save stores it in the
 * arranged sequence.
 */
function addon_boss_render_product_group_head( $i, array $group ): void {
	// $i may be the '__PGIDX__' template placeholder; see the field row's note.
	$ix    = esc_attr( (string) $i );
	$label = (string) ( $group['label'] ?? '' );
	?>
		<div class="bb-po-line">
			<span class="bb-po-caret bb-po-grip" aria-hidden="true">&#9776;</span>
			<span class="bb-po-grouppill"><?php esc_html_e( 'Section', 'addon-boss' ); ?></span>
			<input type="text" name="bb_po_group_label[<?php echo esc_attr( (string) $ix ); ?>]" value="<?php echo esc_attr( $label ); ?>"
				class="bb-po-grouplabel" placeholder="<?php esc_attr_e( 'Section name (optional)', 'addon-boss' ); ?>">
			<button type="button" class="bb-po-remove" aria-label="<?php esc_attr_e( 'Remove this section', 'addon-boss' ); ?>">&#10005;</button>
			<input type="hidden" class="bb-po-orderkey" value="group-<?php echo esc_attr( (string) $ix ); ?>">
		</div>
		<?php
		// The section's own rule: none, or at least one answer anywhere inside it.
		// Each question keeps its own Optional / Required, which this never
		// overrides, so the control is named for what it adds rather than worded
		// as a second "Optional" that could read as switching a question off.
		$bb_min = ! empty( $group['min_pick'] );
		?>
		<div class="bb-pg-rule" data-bb-pg-rule>
			<span class="bb-pg-rule-lab"><?php esc_html_e( 'Section rule', 'addon-boss' ); ?></span>
			<select class="bb-seg-auto bb-pg-min" name="bb_po_group_min[<?php echo esc_attr( (string) $ix ); ?>]" aria-label="<?php esc_attr_e( 'Section rule', 'addon-boss' ); ?>">
				<option value=""><?php esc_html_e( 'None', 'addon-boss' ); ?></option>
				<option value="1" <?php selected( $bb_min ); ?>><?php esc_html_e( 'Pick at least one', 'addon-boss' ); ?></option>
			</select>
			<span class="bb-pg-rule-met" data-bb-pg-met hidden></span>
			<?php // A div, not a label: WooCommerce floats every label in a product data panel 150px to the left. ?>
			<div class="bb-pg-rule-msg" data-bb-pg-msg<?php echo $bb_min ? '' : ' hidden'; ?>>
				<span id="bb-pg-msg-lab-<?php echo esc_attr( (string) $ix ); ?>"><?php esc_html_e( 'If nothing is picked, say', 'addon-boss' ); ?></span>
				<input type="text" maxlength="200" name="bb_po_group_min_msg[<?php echo esc_attr( (string) $ix ); ?>]" value="<?php echo esc_attr( (string) ( $group['min_msg'] ?? '' ) ); ?>"
					aria-labelledby="bb-pg-msg-lab-<?php echo esc_attr( (string) $ix ); ?>"
					placeholder="<?php echo esc_attr( addon_boss_section_min_default_message() ); ?>">
			</div>
		</div>
	<?php
	// The group's repeat panel rides in from the module that owns repeats; a
	// build without one reposts a stored setting through hidden carriers
	// instead, so a save from the wrong build never drops what the merchant
	// chose while nothing on the page invites setting it up.
	if ( ! (bool) apply_filters( 'addon_boss_group_row_repeat_editor', false, $i, $group )
		&& in_array( (string) ( $group['repeat'] ?? '' ), array( 'add', 'per_item' ), true ) ) {
		echo '<input type="hidden" name="bb_po_group_repeat[' . esc_attr( (string) $ix ) . ']" value="' . esc_attr( (string) $group['repeat'] ) . '">';
		if ( ! empty( $group['repeat_max'] ) ) {
			echo '<input type="hidden" name="bb_po_group_repeat_max[' . esc_attr( (string) $ix ) . ']" value="' . (int) $group['repeat_max'] . '">';
		}
		if ( '' !== (string) ( $group['repeat_label'] ?? '' ) ) {
			echo '<input type="hidden" name="bb_po_group_repeat_label[' . esc_attr( (string) $ix ) . ']" value="' . esc_attr( (string) $group['repeat_label'] ) . '">';
		}
	}
}

/**
 * One SET row in the admin product-options list. Extracted so a group can
 * render it as a child exactly like a top-level one. $attached is the
 * [id => name] map of sets on this product, for the reveal-rule siblings.
 */
function addon_boss_render_product_set_row( $i, array $row, array $sets, array $attached ): void {
	$set = $sets[ $row['set'] ?? '' ] ?? null;
	if ( ! $set ) {
		return; // deleted set: degrade silently.
	}
	$ix = (int) $i;
	?>
	<div class="bb-po-row" data-idx="<?php echo esc_attr( (string) $ix ); ?>">
		<div class="bb-po-line">
			<span class="bb-po-caret" aria-hidden="true">&#9656;</span>
			<b><?php echo esc_html( $set['name'] ); ?></b>
			<?php // Straight into the set's own editor, in a new tab so the product's unsaved work stays put (his ask, 4 Sept: stop the trip back through the Option Sets page). ?>
			<a class="bb-po-editset" href="<?php echo esc_url( admin_url( 'admin.php?page=addon-boss-option-sets&set=' . rawurlencode( (string) $row['set'] ) ) ); ?>" target="_blank" rel="noopener">
				<?php esc_html_e( 'Edit set', 'addon-boss' ); ?><span aria-hidden="true">&#8599;</span><span class="screen-reader-text"><?php esc_html_e( '(opens in a new tab)', 'addon-boss' ); ?></span>
			</a>
			<span class="bb-chiprow bb-chiprow-mini">
			<?php echo wp_kses( addon_boss_option_preview_row( (array) ( $set['options'] ?? array() ), 6 ), addon_boss_kses_allowed() ); ?>
			</span>
			<select class="bb-seg-auto bb-po-req" name="bb_po_required[<?php echo esc_attr( (string) $ix ); ?>]" aria-label="<?php esc_attr_e( 'Is a pick required?', 'addon-boss' ); ?>">
				<option value=""><?php esc_html_e( 'Optional', 'addon-boss' ); ?></option>
				<option value="1" <?php selected( ! empty( $row['required'] ) ); ?>><?php esc_html_e( 'Required', 'addon-boss' ); ?></option>
			</select>
			<?php
			/**
			 * A module's own controls for THIS set, on the row that already
			 * names it.
			 *
			 * The quantity grid used to print a second list of every attached
			 * set above this one, carrying the main-choice star and the
			 * charging pick. On a product with 28 questions that duplicate ran
			 * to 2,072px, a third of the whole panel, and it printed the same
			 * names the list below was about to print. One set, one row.
			 *
			 * The field names are unchanged, so the save path neither knows
			 * nor cares that the inputs moved.
			 *
			 * @param string $set_id The option set this row is for.
			 */
			do_action( 'addon_boss_option_row_controls', (string) $row['set'] );
			?>
			<button type="button" class="bb-po-remove" aria-label="<?php esc_attr_e( 'Remove this set from the product', 'addon-boss' ); ?>">&#10005;</button>
			<input type="hidden" name="bb_po_set[<?php echo esc_attr( (string) $ix ); ?>]" value="<?php echo esc_attr( $row['set'] ); ?>">
			<?php // The origin folder rides back through the save, so a re-save never forgets where the set came from. ?>
			<input type="hidden" class="bb-po-fromgroup" name="bb_po_fromgroup[<?php echo esc_attr( (string) $ix ); ?>]" value="<?php echo esc_attr( (string) ( $row['from_group'] ?? '' ) ); ?>">
			<input type="hidden" class="bb-po-orderkey" value="set-<?php echo esc_attr( (string) $ix ); ?>">
		</div>
		<div class="bb-po-body" hidden>
			<?php if ( 'measured' === (string) ( $set['kind'] ?? 'choices' ) && ! empty( $set['measure']['parts'] ) ) : ?>
				<?php
				// A set priced by its parts has no one rate to overrule here. A
				// rate this product kept from before the set had parts rides
				// through the save, unused, in case the set goes back to one.
				if ( isset( $row['rate'] ) && '' !== $row['rate'] ) :
					?>
					<input type="hidden" name="bb_po_rate[<?php echo esc_attr( (string) $ix ); ?>]" value="<?php echo esc_attr( (string) $row['rate'] ); ?>">
				<?php endif; ?>
				<p class="bb-po-hint"><?php esc_html_e( 'This set\'s parts price it the same on every product. To charge this product differently, give it a set of its own.', 'addon-boss' ); ?></p>
			<?php elseif ( 'measured' === (string) ( $set['kind'] ?? 'choices' ) ) : ?>
				<?php
				// A measured set prices by ONE number, so the per-product
				// override is one number too: this product's rate, in place of
				// the per-choice grid a choices set gets. Blank means the set's
				// own rate, shown as the placeholder so the merchant can see
				// exactly what they would be overruling. Reuses the override
				// grid's cells so the row reads like its siblings.
				$bb_rate_val = ( isset( $row['rate'] ) && '' !== $row['rate'] ) ? (string) $row['rate'] : '';
				$bb_rate_id  = 'bb-po-rate-' . sanitize_html_class( (string) $ix );
				?>
				<div class="bb-po-bodytop">
					<div class="bb-po-ovlab"><?php esc_html_e( 'Rate for this product only', 'addon-boss' ); ?></div>
				</div>
				<div class="bb-ovr-grid">
					<div class="bb-ovr-cell<?php echo '' !== $bb_rate_val ? ' is-overridden' : ''; ?>">
						<label class="bb-ovr-name" for="<?php echo esc_attr( $bb_rate_id ); ?>"><?php esc_html_e( 'Rate', 'addon-boss' ); ?></label>
						<span class="bb-ovr-fields">
							<input type="text" id="<?php echo esc_attr( $bb_rate_id ); ?>" name="bb_po_rate[<?php echo esc_attr( (string) $ix ); ?>]"
								value="<?php echo esc_attr( $bb_rate_val ); ?>"
								placeholder="<?php echo esc_attr( (string) ( $set['measure']['rate'] ?? '' ) ); ?>">
						</span>
					</div>
				</div>
				<p class="bb-po-hint"><?php esc_html_e( 'Blank uses the set\'s own rate. A figure here prices this product alone; the set\'s minimum charge still applies.', 'addon-boss' ); ?></p>
			<?php else : ?>
			<div class="bb-po-bodytop">
				<?php
				// The photo module names the override grid (and adds its suggest
				// control); a build without one talks about charges alone.
				$bb_po_copy = (array) apply_filters(
					'addon_boss_option_overrides_copy',
					array(
						'label' => __( 'Extra charge per option, for this product only', 'addon-boss' ),
						'hint'  => __( 'Blank uses the set\'s own charge. A 0 here makes it free for this product.', 'addon-boss' ),
					)
				);
				?>
				<div class="bb-po-ovlab"><?php echo esc_html( (string) $bb_po_copy['label'] ); ?></div>
				<?php do_action( 'addon_boss_option_suggest_control' ); ?>
			</div>
			<div class="bb-ovr-grid">
			<?php
			$bb_hidden = array_flip( array_map( 'strval', (array) ( $row['hide'] ?? array() ) ) );
			foreach ( $set['options'] as $opt ) :
				$override = $row['deltas'][ $opt['key'] ] ?? '';
				$img_id   = absint( $row['images'][ $opt['key'] ] ?? 0 );
				$thumb    = $img_id ? wp_get_attachment_image_url( $img_id, 'thumbnail' ) : '';
				$bb_off   = isset( $bb_hidden[ (string) $opt['key'] ] );
				// The cell holds two controls now, so it is a container with a
				// label each rather than one label wrapped around both: nested,
				// every click on the tick box's wording would land in the charge
				// field instead, which is what a label points at by default.
				$bb_cell_id = 'bb-ovr-' . sanitize_html_class( (string) $ix . '-' . $opt['key'] );
				?>
				<div class="bb-ovr-cell<?php echo '' !== $override ? ' is-overridden' : ''; ?><?php echo $bb_off ? ' is-off' : ''; ?>">
					<label class="bb-ovr-name" for="<?php echo esc_attr( $bb_cell_id ); ?>"><?php echo esc_html( $opt['label'] ); ?></label>
					<span class="bb-ovr-fields">
						<input type="text" id="<?php echo esc_attr( $bb_cell_id ); ?>" name="bb_po_delta[<?php echo esc_attr( (string) $ix ); ?>][<?php echo esc_attr( $opt['key'] ); ?>]"
							value="<?php echo esc_attr( '' === $override ? '' : (string) $override ); ?>"
							placeholder="<?php echo esc_attr( 0.0 === (float) $opt['delta'] ? '0' : (string) $opt['delta'] ); ?>">
						<?php do_action( 'addon_boss_option_photo_controls', $img_id ); ?>
						<?php // The stored id rides along whether or not this build offers the picker, so saving the panel never quietly drops a photo the merchant set. ?>
						<input type="hidden" class="bb-ovr-imgid" name="bb_po_image[<?php echo esc_attr( (string) $ix ); ?>][<?php echo esc_attr( $opt['key'] ); ?>]" value="<?php echo $img_id ? (int) $img_id : ''; ?>">
					</span>
					<?php
					// Tick to REFUSE, never to allow. A merchant hiding two of forty
					// colours ticks two, and a choice the shared set gains next month
					// is offered here without anyone coming back to permit it.
					?>
					<label class="bb-ovr-off">
						<input type="checkbox" class="bb-ovr-offcb"
							name="bb_po_hide[<?php echo esc_attr( (string) $ix ); ?>][<?php echo esc_attr( $opt['key'] ); ?>]" value="1" <?php checked( $bb_off ); ?>>
						<span><?php esc_html_e( 'Not on this product', 'addon-boss' ); ?></span>
					</label>
				</div>
			<?php endforeach; ?>
			</div>
			<p class="bb-po-hint"><?php echo esc_html( (string) $bb_po_copy['hint'] ); ?></p>
			<?php
			// Per-row controls a module owns print under the overrides, with the
			// stored set, this product's row and the row's index in hand.
			do_action( 'addon_boss_product_set_row_extra', $set, $row, $ix );
			?>
			<?php endif; ?>
			<?php
			/*
			 * A picture that will never be drawn.
			 *
			 * The set's swatch shape decides whether a choice draws as a photo.
			 * Left alone it works the obliging way round: the first photo turns
			 * the row into photo cards by itself. But a merchant who once
			 * clicked Square or Circle has PINNED it, and from then on every
			 * photo attached here is stored, kept, and silently never shown.
			 * Nothing on the screen said so, which is a whole afternoon of
			 * uploading swatches and wondering what is broken.
			 *
			 * Read through the same merged view the storefront resolves, so a
			 * photo set only for THIS product counts exactly like one on the
			 * shared set.
			 */
			$bb_shape_pin = (string) ( $set['shape'] ?? '' );
			if ( in_array( $bb_shape_pin, array( 'square', 'circle' ), true ) ) {
				$bb_has_photo = false;
				foreach ( (array) $set['options'] as $bb_o ) {
					if ( ! empty( $bb_o['image_id'] ) || ! empty( $row['images'][ $bb_o['key'] ] ) ) {
						$bb_has_photo = true;
						break;
					}
				}
				if ( $bb_has_photo ) {
					printf(
						'<p class="bb-po-hint bb-po-warn">%s</p>',
						esc_html(
							sprintf(
								/* translators: %s: the set's swatch shape, either Square or Circle. */
								__( 'These choices are drawn as %s swatches, so the photos above are not shown to shoppers. To show them, open this set and set its Swatch shape to Photo card.', 'addon-boss' ),
								'square' === $bb_shape_pin ? __( 'Square', 'addon-boss' ) : __( 'Circle', 'addon-boss' )
							)
						)
					);
				}
			}
			/*
			 * And the mistake in the other direction, which looks like a broken
			 * feature rather than a setting: Photo card over choices that have
			 * no picture anywhere, so every one of them falls back to a swatch
			 * dot and picking a colour has no photograph to swap in. The same
			 * merged view as above, so a photo pinned for THIS product counts,
			 * and only where this build has a picker to attach one with.
			 */
			if ( 'card' === $bb_shape_pin && has_action( 'addon_boss_option_photo_controls' ) ) {
				$bb_any_photo = false;
				foreach ( (array) $set['options'] as $bb_o ) {
					if ( ! empty( $bb_o['image_id'] ) || ! empty( $row['images'][ $bb_o['key'] ] ) ) {
						$bb_any_photo = true;
						break;
					}
				}
				if ( ! $bb_any_photo ) {
					printf(
						'<p class="bb-po-hint bb-po-warn bb-po-nophoto">%s</p>',
						esc_html__( 'This set draws photo cards, but none of these choices has a picture, so shoppers see plain swatches and picking one cannot change the product image. Add a picture above, or on the set itself.', 'addon-boss' )
					);
				}
			}
			$siblings = array();
			foreach ( $attached as $sid => $sname ) {
				if ( $sid !== ( $row['set'] ?? '' ) ) {
					$siblings[ $sid ] = is_array( $sname ) ? ( $sname['name'] ?? $sid ) : $sname;
				}
			}
			// The reveal-rule editor rides in from the module that evaluates
			// such rules; a build without one reposts a stored rule through
			// hidden carriers instead, so a save never drops it.
			$bb_row_when = is_array( $row['when'] ?? null ) ? $row['when'] : array();
			if ( ! (bool) apply_filters( 'addon_boss_set_row_when_editor', false, $ix, $bb_row_when, $siblings, $sets ) ) {
				$bb_when_norm = addon_boss_when_to_groups( $bb_row_when );
				if ( $bb_when_norm['groups'] ) {
					echo '<input type="hidden" name="bb_po_when_json[' . (int) $ix . ']" value="' . esc_attr( (string) wp_json_encode( $bb_when_norm ) ) . '">';
				}
			}
			?>
		</div>
	</div>
	<?php
}

/**
 * Remember a row's field, so the rows BELOW it may point a rule at it.
 *
 * Carries the TYPE as well as the name, because the operator a rule offers is
 * worded from what it points at: a tick box is ticked, a text box is filled in.
 *
 * @param mixed $row     A config row.
 * @param array $earlier Field key => [label, type]; gains this row's field.
 */
function addon_boss_note_earlier_field( $row, array &$earlier ): void {
	$row = is_array( $row ) ? $row : array();
	$key = (string) ( $row['field']['key'] ?? '' );
	if ( '' === $key ) {
		return;
	}
	$label = (string) ( $row['field']['label'] ?? '' );
	$type  = (string) ( $row['field']['type'] ?? '' );
	// A display-only row (a section label, an info block) has no answer to
	// test, so it is never offered as a trigger. A hidden field is deliberately
	// no trigger either direction (its value is the merchant's own note), and
	// an amount they choose must never gate what they see: pay-more-see-more
	// is the pattern this fence exists to make unbuildable.
	$types = addon_boss_personalisation_field_types();
	if ( ! empty( $types[ $type ]['display_only'] ) || ! empty( $types[ $type ]['admin_only'] ) || ! empty( $types[ $type ]['own_amount'] ) ) {
		return;
	}
	$earlier[ $key ] = array(
		'label' => '' !== $label ? $label : $key,
		'type'  => $type,
	);
}

/**
 * One sibling-field entry read whichever way it was handed over: the map is
 * [label, type] now, and a bare string is still read as a name.
 *
 * @param mixed $entry The map entry.
 * @param string $key  Its key, as the last-resort name.
 * @return array{label:string,type:string}
 */
function addon_boss_sibling_field( $entry, string $key ): array {
	if ( is_array( $entry ) ) {
		return array(
			'label' => (string) ( $entry['label'] ?? $key ),
			'type'  => (string) ( $entry['type'] ?? '' ),
		);
	}
	return array( 'label' => '' !== (string) $entry ? (string) $entry : $key, 'type' => '' );
}

/** A set-or-field CHILD row (used both top-level and inside a group). */
function addon_boss_render_product_child_row( $i, array $row, array $sets, array $attached, array $sibling_fields = array() ): void {
	if ( ( $row['row_type'] ?? '' ) === 'field' ) {
		addon_boss_render_product_field_row( $i, (array) ( $row['field'] ?? array() ), (array) ( $row['when'] ?? array() ), $attached, $sibling_fields );
		return;
	}
	addon_boss_render_product_set_row( $i, $row, $sets, $attached );
}

/** The product-editor JS for field rows: add, type-change, live summary. */
function addon_boss_product_fields_admin_script(): void {
	if ( ! function_exists( 'addon_boss_personalisation_field_types' ) ) {
		return;
	}
	$sym = html_entity_decode( get_woocommerce_currency_symbol() );
	?>
	<?php ob_start(); try { ?>
	<?php echo addon_boss_plural_js(); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- generated JS, no variables. ?>
	jQuery( function ( $ ) {
		var panel = $( '#bundle_boss_options_panel' );
		if ( ! panel.length ) { return; }

		// "Not on this product" answers as it is ticked. The is-off class was
		// only ever printed by PHP, so ticking the box struck nothing through
		// and dimmed nothing until the product was saved and the page came
		// back: the only feedback was the focus ring sitting on the box until
		// it moved to the next one, which reads as a stuck highlight rather
		// than a choice being refused.
		panel.on( 'change', '.bb-ovr-offcb', function () {
			$( this ).closest( '.bb-ovr-cell' ).toggleClass( 'is-off', this.checked );
		} );

		var pfNext = 100000; // field rows take a high, non-colliding index base
		var L = {
			newField: <?php echo wp_json_encode( __( 'New field', 'addon-boss' ) ); ?>,
			optional: <?php echo wp_json_encode( __( 'Optional', 'addon-boss' ) ); ?>,
			required: <?php echo wp_json_encode( __( 'Required', 'addon-boss' ) ); ?>,
			sym: <?php echo wp_json_encode( $sym ); ?>,
			modes: <?php echo wp_json_encode( addon_boss_fee_modes() ); ?>,
			shorts: <?php echo wp_json_encode( addon_boss_fee_mode_shorts() ); ?>
		};
		function summarise( row ) {
			var lbl = $.trim( row.find( '.bb-pf-label' ).val() || '' );
			row.find( '.bb-pf-headlabel' ).text( lbl || L.newField );
			var reqmode = row.find( '.bb-pf-require' ).prop( 'checked' ) ? 'always' : '';
			var bits = [ reqmode === 'always' ? L.required : L.optional ];
			var fee = parseFloat( row.find( '.bb-pf-fee' ).val() );
			var fmode = row.find( '.bb-pf-feemode' ).val();
			var ftype = row.find( '.bb-pf-type' ).val();
			if ( fee > 0 ) {
				// A type or mode whose charge reads in its own words says so
				// through the module that registered it; the fallback reads from
				// the mode menu's own wording.
				var ownBit = null;
				( window.addonBossFeeBits || [] ).some( function ( f ) {
					var b = f( ftype, fmode, fee, row, L );
					if ( null !== b && undefined !== b ) { ownBit = b; return true; }
					return false;
				} );
				bits.push( null !== ownBit ? ownBit : '+' + L.sym + fee + ' ' + ( L.shorts[ fmode ] || L.modes[ fmode ] || fmode || '' ) );
			}
			// A module's own summary bits (an upload field's image-handling note)
			// join here, after the engine's.
			( window.addonBossSummarise || [] ).forEach( function ( f ) { bits = f( bits, ftype, row ) || bits; } );
			row.find( '.bb-pf-sum' ).text( bits.join( ' · ' ) );
		}
		// The money box wears the currency by default; a mode priced as a share
		// of something (a percentage) swaps it through its module's own sync,
		// registered on addonBossTypeSync below.
		function feeSymSync( row ) {
			row.find( '.bb-pf-feesym' ).prop( 'hidden', false );
			row.find( '.bb-pf-feepct' ).prop( 'hidden', true );
			( window.addonBossFeeSyms || [] ).forEach( function ( f ) { f( row ); } );
		}
		/**
		 * A group is only shown when at least one control inside it is relevant to
		 * this field type, and a LONE remaining group drops its heading so a simple
		 * field still reads as one flat row rather than a lonely titled section.
		 * Type-conditional display is the cheapest disclosure there is: automatic,
		 * predictable, and with no discoverability cost, which is why it does the
		 * heavy lifting here instead of a fold.
		 */
		function grpSync( row ) {
			var shown = [];
			row.find( '.bb-pf-grp' ).each( function () {
				var g    = $( this );
				// A summary line IS the group's content when its controls are folded
				// away behind Edit. Without it the ancestor test above (correctly)
				// finds every control inside a closed panel and hides the whole
				// group, summary and all, which is the opposite of the point.
				var kids = g.find( '.bb-pf-ctl, .bb-pf-imgrow, .bb-pf-sumbar, .bb-pf-choicerows' );
				var any  = false;
				kids.each( function () {
					// A control inside a hidden PANEL is not on screen, even though it
					// carries no hidden flag of its own. Reading only its own flag is
					// why "Tidying what they send" stood as a heading over NOTHING on
					// every field type that is not a file: the crop, rotate, shrink and
					// quality controls live inside .bb-pf-imgpanel, which is hidden,
					// and each of them answered "not hidden" for itself.
					//
					// parentsUntil( g ) so the group's own flag, set on the previous
					// pass, cannot make every group look empty forever.
					if ( $( this ).prop( 'hidden' ) ) { return; }
					if ( $( this ).parentsUntil( g ).filter( '[hidden]' ).length ) { return; }
					any = true;
				} );
				g.prop( 'hidden', ! any );
				if ( any ) { shown.push( g ); }
			} );
			// Heading only earns its space once there is more than one group to tell
			// apart.
			var solo = shown.length < 2;
			shown.forEach( function ( g ) { g.find( '> .bb-pf-grph' ).prop( 'hidden', solo ); } );
		}
		function typeSync( row ) {
			var t = row.find( '.bb-pf-type' ).val();
			row.attr( 'data-type', t );
			row.find( '.bb-pf-settings' ).prop( 'hidden', t === 'heading' || t === 'html' );
			row.find( '.bb-pf-htmlbox' ).prop( 'hidden', t !== 'html' );
			row.find( '.bb-pf-max' ).prop( 'hidden', ! ( t === 'text' || t === 'textarea' ) );
			// Types that carry their money in the value (a colour's swatch, the
			// shopper's own amount) or carry none at all (hidden) lose the Charge
			// box; hidden loses the Answer control too, because an invisible thing cannot be
			// required. Each type's own controls appear in the same breath.
			row.find( '.bb-pf-charge' ).prop( 'hidden', t === 'color' || t === 'price' || t === 'hidden' || t === 'select' );
			row.find( '.bb-pf-require' ).closest( '.bb-pf-ctl' ).prop( 'hidden', t === 'hidden' );
			row.find( '.bb-pf-numlo, .bb-pf-numhi, .bb-pf-numwhole' ).prop( 'hidden', t !== 'number' );
			row.find( '.bb-pf-pricemin, .bb-pf-pricemax, .bb-pf-pricesug, .bb-pf-priceamts' ).prop( 'hidden', t !== 'price' );
			row.find( '.bb-pf-hiddenval, .bb-pf-hiddenurl' ).prop( 'hidden', t !== 'hidden' );
			row.find( '.bb-pf-colourgrp' ).prop( 'hidden', t !== 'color' )
				.find( '.bb-pf-ctl' ).prop( 'hidden', t !== 'color' );
			// The choices content carries the type flag itself, the same as the
			// colour rows: grpSync derives a group's visibility from its CHILDREN,
			// so a group whose only content is rows and a button was re-hidden in
			// the same tick that showed it, and a Dropdown offered nowhere to
			// type its choices.
			row.find( '.bb-pf-choicegrp' ).prop( 'hidden', t !== 'select' )
				.find( '.bb-pf-choicerows' ).prop( 'hidden', t !== 'select' );
			// Each module's own type behaviours (a measured size's unit picker, a
			// mode that only suits certain types) run here, after the engine's
			// own decisions and before the groups settle.
			( window.addonBossTypeSync || [] ).forEach( function ( f ) { f( row, t ); } );
			feeSymSync( row );
			// Groups settle AFTER every per-control decision above, since a group's
			// visibility is derived from its children's.
			grpSync( row );
			// The charge reads differently per type ("per square m" vs "for
			// each"), so the summary follows the type, not just the fee.
			summarise( row );
		}
		panel.on( 'change', '.bb-pf-add', function () {
			var t = $( this ).val();
			if ( ! t ) { return; }
			var tmpl = document.getElementById( 'bb-pf-row-template' );
			if ( ! tmpl ) { return; }
			var row = $( tmpl.innerHTML.replace( /__PFIDX__/g, String( pfNext ) ) );
			row.find( '.bb-pf-type' ).val( t );
			// A new field lands in the ungrouped area, before the first group, so
			// it never auto-joins a group; the merchant drags it in deliberately.
			var $pfRows = $( '#bb-product-option-rows' ), $pfG = $pfRows.children( '.bb-po-grouprow' ).first();
			if ( $pfG.length ) { $pfG.before( row ); } else { $pfRows.append( row ); }
			row.find( '.bb-po-body' ).prop( 'hidden', false );
			typeSync( row );
			feeSymSync( row );
			var bbSegs = window.addonBossBuildSegs || window.bundleBossBuildSegs; // theirs, when BundleBoss's admin.js was the one loaded
			if ( bbSegs ) { bbSegs( row ); }
			row.find( '.bb-pf-label' ).trigger( 'focus' );
			$( this ).val( '' ).trigger( 'change.select2' );
			pfNext++;
			panel.trigger( 'bb-pf-changed' );
		} );
		panel.on( 'change', '.bb-pf-type', function () { typeSync( $( this ).closest( '.bb-po-fieldrow' ) ); } );
		// The note under Charge follows the menu, so what it says is what this
		// field will actually do.
		function chargeNoteSync( row ) {
			row.find( '.bb-pf-charge-note' ).each( function () {
				var mode = row.find( '.bb-pf-feemode' ).val() || '';
				var txt  = this.getAttribute( 'data-note-' + mode ) || '';
				this.textContent = txt;
				this.hidden = ( '' === txt ) || row.find( '.bb-pf-feemode' ).prop( 'hidden' );
			} );
		}
		panel.on( 'change', '.bb-pf-feemode', function () {
			var row = $( this ).closest( '.bb-po-fieldrow' );
			feeSymSync( row );
			chargeNoteSync( row );
		} );
		panel.find( '.bb-po-fieldrow' ).each( function () { chargeNoteSync( $( this ) ); } );

		// The add bar's hint line speaks for whichever control the merchant is
		// on, and goes back to the general line when they leave it.
		( function () {
			var bar  = panel.find( '.bb-po-addbar' );
			var line = panel.find( '.bb-po-addhint' );
			if ( ! bar.length || ! line.length ) { return; }
			line.attr( 'data-bb-default', $.trim( line.text() ) );
			function say( wrap ) {
				var t = wrap ? $.trim( wrap.find( '.bb-ctl-hint-onfocus' ).text() ) : '';
				line.text( t || line.attr( 'data-bb-default' ) );
			}
			bar.on( 'mouseenter focusin', '.bb-po-addctl-wrap', function () { say( $( this ) ); } );
			bar.on( 'mouseleave focusout', '.bb-po-addctl-wrap', function () { say( null ); } );
		} )();
		// ---- the colour field's swatch rows ---------------------------------
		panel.on( 'click', '.bb-pf-colouradd', function () {
			var ix   = $( this ).data( 'ix' );
			var rows = $( this ).siblings( '.bb-pf-colourrows' );
			var n    = rows.children().length;
			// Names mirror the server-rendered rows exactly; the value slug is
			// derived from the label on save, so the hidden carrier posts empty.
			var sym  = $( this ).closest( '.bb-po-fieldrow' ).find( '.bb-pf-feesym' ).first().text() || '';
			rows.append(
				'<div class="bb-pf-colourrow">'
				+ '<input type="text" name="bb_pf[' + ix + '][options][' + n + '][label]" value="" class="bb-pf-colourlabel" placeholder="' + ( window.addonBossAdmin && addonBossAdmin.colourNamePh ? addonBossAdmin.colourNamePh : 'Colour name' ) + '">'
				+ '<input type="color" name="bb_pf[' + ix + '][options][' + n + '][color]" value="#cccccc" class="bb-pf-colourpick">'
				+ '<span class="bb-pf-feebox"><span class="bb-pf-feesym">' + sym + '</span><input type="text" name="bb_pf[' + ix + '][options][' + n + '][fee]" value="" class="bb-pf-colourfee" placeholder="0"></span>'
				+ '<input type="hidden" name="bb_pf[' + ix + '][options][' + n + '][value]" value="">'
				+ '<button type="button" class="bb-po-remove bb-pf-colourdel">&#10005;</button>'
				+ '</div>'
			);
			rows.children().last().find( '.bb-pf-colourlabel' ).trigger( 'focus' );
			panel.trigger( 'bb-pf-changed' );
		} );
		panel.on( 'click', '.bb-pf-colourdel', function () {
			$( this ).closest( '.bb-pf-colourrow' ).remove();
			panel.trigger( 'bb-pf-changed' );
		} );
		// ---- the dropdown field's choice rows -------------------------------
		panel.on( 'click', '.bb-pf-choiceadd', function () {
			var ix   = $( this ).data( 'ix' );
			var rows = $( this ).siblings( '.bb-pf-choicerows' );
			var n    = rows.children().length;
			var sym  = $( this ).closest( '.bb-po-fieldrow' ).find( '.bb-pf-feesym' ).first().text() || '';
			rows.append(
				'<div class="bb-pf-colourrow bb-pf-choicerow">'
				+ '<input type="text" name="bb_pf[' + ix + '][options][' + n + '][label]" value="" class="bb-pf-colourlabel bb-pf-choicelabel" placeholder="' + ( window.addonBossAdmin && addonBossAdmin.choiceNamePh ? addonBossAdmin.choiceNamePh : 'Choice name' ) + '">'
				+ '<span class="bb-pf-feebox"><span class="bb-pf-feesym">' + sym + '</span><input type="text" name="bb_pf[' + ix + '][options][' + n + '][fee]" value="" class="bb-pf-colourfee bb-pf-choicefee" placeholder="0"></span>'
				+ '<input type="hidden" name="bb_pf[' + ix + '][options][' + n + '][value]" value="">'
				+ '<button type="button" class="bb-po-remove bb-pf-choicedel">&#10005;</button>'
				+ '</div>'
			);
			rows.children().last().find( '.bb-pf-choicelabel' ).trigger( 'focus' );
			panel.trigger( 'bb-pf-changed' );
		} );
		panel.on( 'click', '.bb-pf-choicedel', function () {
			$( this ).closest( '.bb-pf-choicerow' ).remove();
			panel.trigger( 'bb-pf-changed' );
		} );
		panel.on( 'change', '.bb-pf-colourallow', function () {
			$( this ).siblings( '.bb-pf-colourcfee' ).prop( 'hidden', ! this.checked );
		} );
		// A module whose controls appear or leave (the repeat panel following
		// its mode menu) says so through this event, and the grouping is
		// resettled the same way the summary is refreshed.
		panel.on( 'bb-pf-regroup', '.bb-po-fieldrow', function () { grpSync( $( this ) ); } );

		// ---- which variations a field is for --------------------------------
		// "All of them" is the plain-English default. Unticking it reveals the
		// list; ticking it again clears every pick, so the stored rule and what
		// the merchant sees can never disagree.
		panel.on( 'change', '.bb-pf-varall-cb', function () {
			var wrap = $( this ).closest( '.bb-pf-vars' );
			var list = wrap.find( '.bb-pf-varlist' );
			if ( this.checked ) {
				list.prop( 'hidden', true ).find( 'input[type=checkbox]' ).prop( 'checked', false );
			} else {
				list.prop( 'hidden', false );
			}
		} );
		// Unticking every variation means "all of them" again, rather than a rule
		// that matches nothing and silently hides the field everywhere.
		panel.on( 'change', '.bb-pf-varlist input[type=checkbox]', function () {
			var wrap = $( this ).closest( '.bb-pf-vars' );
			if ( ! wrap.find( '.bb-pf-varlist input[type=checkbox]:checked' ).length ) {
				wrap.find( '.bb-pf-varall-cb' ).prop( 'checked', true );
				wrap.find( '.bb-pf-varlist' ).prop( 'hidden', true );
			}
		} );

		panel.on( 'input change', '.bb-po-fieldrow .bb-pf-label, .bb-po-fieldrow .bb-pf-fee, .bb-po-fieldrow .bb-pf-feemode, .bb-po-fieldrow .bb-pf-unit, .bb-po-fieldrow select[name$="[require]"]', function () {
			summarise( $( this ).closest( '.bb-po-fieldrow' ) );
		} );
		// A module that changed something the closed row summarises asks for a
		// rewrite through this event rather than reaching into this scope.
		panel.on( 'bb-pf-resummarise', '.bb-po-fieldrow', function () { summarise( $( this ) ); } );

		// ---- popular setups -------------------------------------------------
		// The blank row comes from the server's own template, so a row added here
		// is the same markup as a row that was stored: one description of a row,
		// not two that drift apart.
		function bbSetupCount() {
			var shelf = panel.find( '.bb-setupshelf' );
			if ( ! shelf.length ) { return; }
			var n   = shelf.find( '.bb-setup-row' ).length;
			var out = shelf.find( '.bb-setup-count' );
			// The count in the language's own plural form (addon_boss_js_plural).
			out.text( n ? String( window.bbPlural( out.data( 'some' ), n ) ).replace( '%s', n ) : out.data( 'none' ) );
		}
		panel.on( 'click', '.bb-setup-add', function () {
			var shelf = $( this ).closest( '.bb-setupshelf' );
			var tpl   = shelf.find( '.bb-setup-tpl' ).html() || '';
			var next  = 0;
			shelf.find( '.bb-setup-row' ).each( function () {
				$( this ).find( '[name^="bb_setups["]' ).each( function () {
					var m = /bb_setups\[(\d+)\]/.exec( this.name || '' );
					if ( m ) { next = Math.max( next, parseInt( m[ 1 ], 10 ) + 1 ); }
				} );
			} );
			shelf.find( '.bb-setup-rows' ).append( tpl.split( '__i__' ).join( String( next ) ) );
			shelf.find( '.bb-setup-row' ).last().find( '.bb-setup-name-in' ).trigger( 'focus' );
			bbSetupCount();
		} );
		panel.on( 'click', '.bb-setup-del', function () {
			$( this ).closest( '.bb-setup-row' ).remove();
			bbSetupCount();
		} );
		bbSetupCount();
	} );
	<?php } finally { addon_boss_inline_js( ob_get_clean() ); } ?>
	<?php
}

/**
 * One setup's row in the editor: its name, its line, and a choice per set.
 *
 * A row per setup rather than a screen per setup: a merchant writing three of
 * these is comparing them, and comparing means seeing them at once.
 *
 * Index -1 draws the blank template the Add button clones, so there is ONE
 * description of a row rather than one in PHP and a second in JavaScript that
 * drifts from it the first time a set gains a field.
 *
 * @param int   $index The row's position, or -1 for the template.
 * @param array $row   The stored setup, empty for a new one.
 * @param array $sets  The product's option sets.
 * @return void
 */
function addon_boss_setup_editor_row( int $index, array $row, array $sets ): void {
	$bb_n     = $index < 0 ? '__i__' : (string) $index;
	$bb_picks = (array) ( $row['picks'] ?? array() );
	echo '<div class="bb-setup-row">';
	echo '<div class="bb-setup-head">';
	printf(
		'<input type="text" class="bb-setup-name-in" name="bb_setups[%s][name]" value="%s" placeholder="%s" />',
		esc_attr( $bb_n ),
		esc_attr( (string) ( $row['name'] ?? '' ) ),
		esc_attr__( 'Most popular', 'addon-boss' )
	);
	printf(
		'<input type="text" class="bb-setup-note-in" name="bb_setups[%s][note]" value="%s" placeholder="%s" />',
		esc_attr( $bb_n ),
		esc_attr( (string) ( $row['note'] ?? '' ) ),
		esc_attr__( 'One line about it (optional)', 'addon-boss' )
	);
	printf(
		'<button type="button" class="button-link bb-setup-del" aria-label="%s">%s</button>',
		esc_attr__( 'Remove this setup', 'addon-boss' ),
		esc_html__( 'Remove', 'addon-boss' )
	);
	echo '</div>';
	echo '<div class="bb-setup-picks">';
	foreach ( $sets as $bb_set ) {
		$bb_sid = (string) ( $bb_set['id'] ?? '' );
		if ( '' === $bb_sid ) {
			continue;
		}
		$bb_has = (string) ( $bb_picks[ $bb_sid ] ?? '' );
		echo '<label class="bb-setup-pick">';
		echo '<span class="bb-setup-pick-lab">' . esc_html( (string) ( $bb_set['name'] ?? '' ) ) . '</span>';
		printf( '<select name="bb_setups[%s][picks][%s]">', esc_attr( $bb_n ), esc_attr( $bb_sid ) );
		// LEAVING ONE ALONE IS A REAL ANSWER. A setup that names three of five
		// choices still saves a shopper three decisions, and forcing a pick per
		// set would make an optional extra look compulsory to the merchant.
		echo '<option value="">' . esc_html__( 'Not part of this setup', 'addon-boss' ) . '</option>';
		foreach ( (array) ( $bb_set['options'] ?? array() ) as $bb_opt ) {
			$bb_k = (string) ( $bb_opt['key'] ?? '' );
			printf(
				'<option value="%s"%s>%s</option>',
				esc_attr( $bb_k ),
				selected( $bb_k, $bb_has, false ),
				esc_html( (string) ( $bb_opt['label'] ?? '' ) )
			);
		}
		echo '</select></label>';
	}
	echo '</div></div>';
}

/**
 * The guidance under a Product options control: said out loud, on the screen.
 *
 * This used to be a 15px circle with an "i" in it that opened a bubble on
 * hover. It dodged the letter of the house rule, which bans NATIVE tooltips,
 * while breaking the whole point of it: nine real sentences a merchant needs
 * were hidden behind a hover, unreadable on a touch screen and invisible to
 * anyone scanning the form. "Your server allows up to 20 MB" is exactly the
 * kind of thing that stops someone typing 25 and wondering why it will not
 * stick, and it cannot do that from inside a tooltip.
 *
 * The panel already talks this way everywhere else -- the upload field prints
 * "Shoppers will see: JPG, PNG, GIF, WebP, PDF, up to 20 MB" as plain text an
 * inch away -- so this is the odd one out being brought into line rather than
 * a new pattern being invented.
 */
function addon_boss_options_addctl_tip( string $text, string $when = 'always' ): void {
	// 'always' is the house standard: guidance a merchant reads without hunting
	// for it, never a tooltip.
	//
	// 'focus' is for a ROW of controls. Three sentences sitting beside three
	// controls made each one 600 to 850px wide inside an 878px bar, so the row
	// broke into a column and the menus were squeezed to nothing. The words are
	// still on the page and still plain text; they are shown on the one hint
	// line under the bar, for the control the merchant is actually on.
	printf(
		'<em class="bb-hint bb-ctl-hint%1$s"%2$s>%3$s</em>',
		'focus' === $when ? ' bb-ctl-hint-onfocus' : '',
		'focus' === $when ? ' hidden' : '',
		esc_html( $text )
	);
}


/**
 * The least a shopper can pay for a simple product as its saved sets stand,
 * for the product screen's price advice (fresh testers, 18 Oct 2026: a shop
 * page showed £10.00 above "from £12.00", and £12.00 for a polo whose
 * required print added at least £4.00, and only the set editor said so).
 *
 * Where a set prices the whole product (a price table or a measured size on
 * the whole price), its cheapest size stands in for the product's own price.
 * Each set the product requires then adds the least any of its choices adds.
 * A set shown only on a condition counts for nothing: it depends on a pick.
 *
 * What the cheapest is called comes from the set it came from: a size, a
 * pack, or a choice where a price list counts in two directions. "Set it to
 * the cheapest size" read wrong over business cards priced by quantity and
 * finish (fresh tester, print shop, 18 Oct 2026).
 *
 * @param WC_Product $product The product.
 * @param array|null $config  Rows to read in place of the product's saved
 *                            ones (the Options tab before it is saved, with
 *                            the lists a set follows); null for the saved.
 * @return array{price:float,whole:bool,noun?:string}|null Null where there is nothing to say.
 */
function addon_boss_product_price_floor( WC_Product $product, ?array $config = null ): ?array {
	if ( ! $product->is_type( 'simple' ) ) {
		return null;
	}
	$whole = null;
	$noun  = 'size';
	$kind  = '';
	$adds  = 0.0;
	// A group row holds its sets as children: they count like any other.
	$rows = array();
	foreach ( null === $config ? addon_boss_product_option_config( $product ) : $config as $row ) {
		if ( 'group' === ( $row['row_type'] ?? '' ) ) {
			foreach ( (array) ( $row['children'] ?? array() ) as $child ) {
				$rows[] = (array) $child;
			}
		} else {
			$rows[] = (array) $row;
		}
	}
	foreach ( $rows as $row ) {
		$sid = (string) ( $row['set'] ?? '' );
		$set = addon_boss_option_set( $sid );
		if ( ! $set || ! empty( $row['when'] ) ) {
			continue;
		}
		$cheap = apply_filters( 'addon_boss_set_whole_cheapest', null, $set );
		if ( null !== $cheap ) {
			if ( null === $whole || (float) $cheap < $whole ) {
				$noun = (string) apply_filters( 'addon_boss_set_whole_noun', 'size', $set );
				$kind = (string) ( $set['kind'] ?? 'choices' );
			}
			$whole = null === $whole ? (float) $cheap : min( $whole, (float) $cheap );
			continue;
		}
		if ( empty( $row['required'] ) || 'choices' !== (string) ( $set['kind'] ?? 'choices' ) ) {
			continue;
		}
		$least = null;
		foreach ( (array) ( $set['options'] ?? array() ) as $opt ) {
			$key  = (string) ( $opt['key'] ?? '' );
			$left = addon_boss_option_stock_left( $sid, $key );
			if ( null !== $left && $left <= 0 ) {
				continue; // Sold out: nobody can pick it.
			}
			$delta = array_key_exists( $key, (array) ( $row['deltas'] ?? array() ) ) ? (float) $row['deltas'][ $key ] : (float) ( $opt['delta'] ?? 0 );
			$least = null === $least ? $delta : min( $least, $delta );
		}
		$adds += max( 0.0, (float) $least );
	}
	if ( null !== $whole ) {
		return array(
			'price' => $whole + $adds,
			'whole' => true,
			'noun'  => in_array( $noun, array( 'size', 'pack', 'choice' ), true ) ? $noun : 'size',
			// The kind of set that prices the whole of it: a measured size's
			// "From" is always worked out (addon_boss_from_price_html).
			'kind'  => $kind,
		);
	}
	return $adds > 0 ? array( 'price' => (float) $product->get_price( 'edit' ) + $adds, 'whole' => false ) : null;
}

/**
 * The price a product prints (its page headline, the shop and category
 * pages) when its own price is 0 or empty and a set prices the whole of it:
 * what the cheapest size costs, "From £10.08", worded as the editor's shop
 * facts word it. It printed "£0.00" over a glass priced only by its size
 * (owner walk, 29 Oct 2026). A product with a price of its own, or with
 * nothing that prices the whole of it, prints exactly as before.
 *
 * @param string     $html    What WooCommerce prints.
 * @param WC_Product $product The product.
 */
function addon_boss_from_price_html( $html, $product = null ) {
	if ( ! $product instanceof WC_Product || ! $product->is_type( 'simple' ) ) {
		return $html;
	}
	$own   = (string) $product->get_price( 'edit' );
	$floor = addon_boss_product_price_floor( $product );
	if ( ! $floor || empty( $floor['whole'] ) || (float) $floor['price'] <= 0 ) {
		return $html;
	}
	// A measured size that prices the whole product: the headline is always
	// what its cheapest size costs. A price typed on the product (the editor's
	// old "Use £1.40") read £1.17 with no "From", and was wrong the day the
	// set changed (walk 3, 30 Oct 2026). Any other set prints the product's
	// own price where it has one, as before.
	if ( '' !== $own && (float) $own > 0 && 'measured' !== ( $floor['kind'] ?? '' ) ) {
		return $html;
	}
	// With the shop's own price suffix ("inc. VAT"), as WooCommerce prints
	// every price, worked out on the price shown rather than the product's 0.
	/* translators: %s: a price */
	$from = sprintf( esc_html__( 'From %s', 'addon-boss' ), addon_boss_money( (float) $floor['price'], $product ) ) . $product->get_price_suffix( (float) $floor['price'] );
	// The From stands where WooCommerce's own figure stood, so every filter
	// that dressed that figure dresses this one: those after it run on it in
	// turn, and those that ran before it at the first priority (a VAT switch's
	// "Excl. VAT") are run again on it here. At 10 the From replaced what they
	// had added: a fixed-price card read "£25.00 Excl. VAT" beside a bare
	// "From £1.17" (walk 3, 30 Oct 2026).
	$hook = $GLOBALS['wp_filter']['woocommerce_get_price_html'] ?? null;
	if ( $hook instanceof WP_Hook && isset( $hook->callbacks[ PHP_INT_MIN ] ) && doing_filter( 'woocommerce_get_price_html' ) ) {
		foreach ( $hook->callbacks[ PHP_INT_MIN ] as $bb_cb ) {
			if ( 'addon_boss_from_price_html' === $bb_cb['function'] ) {
				break;
			}
			$from = (string) call_user_func_array( $bb_cb['function'], array_slice( array( $from, $product ), 0, max( 1, (int) $bb_cb['accepted_args'] ) ) );
		}
	}
	return $from;
}
add_filter( 'woocommerce_get_price_html', 'addon_boss_from_price_html', PHP_INT_MIN, 2 );

/**
 * What the Options tab says over a product with no price, escaped, with its
 * "Use £X" button where there is one price to offer. The advice depends on
 * what the sets do with the price. A set pricing the whole product makes its
 * cheapest size the price; told "0 if the options are the whole price", a
 * shop showed £0.00 on every listing (fresh tester, sign shop, 18 Oct 2026).
 *
 * @param WC_Product $product The product.
 * @param array|null $config  The tab's rows before they are saved (the
 *                            attach menu asks again as sets come and go);
 *                            null for the saved rows.
 */
function addon_boss_noprice_advice( WC_Product $product, ?array $config = null ): string {
	$floor = addon_boss_product_price_floor( $product, null === $config ? null : addon_boss_config_with_companions( $config ) );
	$use   = addon_boss_price_floor_use( $floor );
	if ( $floor && $floor['whole'] && 'measured' === ( $floor['kind'] ?? '' ) ) {
		// The size sets the price and shop pages already show "From" its
		// cheapest, in the figures they show: any price makes the product
		// buyable, 0 is the plain one. One plain figure: built from a price
		// page's markup, a VAT switch's pair read "From £0.71£0.85" (walk 5).
		$from = addon_boss_money( (float) $floor['price'], $product, array( 'plain' => true ) );
		/* translators: %s: a price */
		$from = sprintf( __( 'From %s', 'addon-boss' ), html_entity_decode( $from, ENT_QUOTES, 'UTF-8' ) );
		/* translators: %s: the price shop pages show, like From £1.17 */
		$none = sprintf( __( 'This product has no price, so its options will not show. Set its price to 0: the size sets the price, and shop pages show %s.', 'addon-boss' ), $from );
		$use  = '';
	} elseif ( $floor && $floor['whole'] && 'pack' === ( $floor['noun'] ?? 'size' ) ) {
		/* translators: %s: the cheapest pack's price */
		$none = sprintf( __( 'This product has no price, so its options will not show. Shop pages show its price, so set it to the cheapest pack: %s.', 'addon-boss' ), addon_boss_price_floor_money( $floor['price'] ) );
	} elseif ( $floor && $floor['whole'] && 'choice' === ( $floor['noun'] ?? 'size' ) ) {
		/* translators: %s: the cheapest choice's price, like 100 cards in matt */
		$none = sprintf( __( 'This product has no price, so its options will not show. Shop pages show its price, so set it to the cheapest choice: %s.', 'addon-boss' ), addon_boss_price_floor_money( $floor['price'] ) );
	} elseif ( $floor && $floor['whole'] ) {
		/* translators: %s: the cheapest size's price */
		$none = sprintf( __( 'This product has no price, so its options will not show. Shop pages show its price, so set it to the cheapest size: %s.', 'addon-boss' ), addon_boss_price_floor_money( $floor['price'] ) );
	} elseif ( null === $config ? addon_boss_product_option_config( $product, true ) : $config ) {
		$none = __( 'This product has no price, so its options will not show. Set its price on the General tab; each option adds to it.', 'addon-boss' );
	} else {
		$none = __( 'This product has no price, so its options will not show. Set its price on the General tab.', 'addon-boss' );
	}
	return esc_html( $none ) . $use;
}

/**
 * The advice again, for the rows on the tab now: a measured size attached
 * and not yet saved got "Set its price on the General tab", and the true
 * advice only after Update (walk 5, 30 Oct 2026). Rows are the sets in tab
 * order with their Required switch; nothing is saved.
 */
function addon_boss_noprice_advice_ajax(): void {
	$pid = absint( $_POST['product'] ?? 0 );
	if ( ! check_ajax_referer( 'addon_boss_noprice_advice', '_wpnonce', false ) || ! current_user_can( 'edit_post', $pid ) ) {
		wp_send_json_error( array( 'message' => __( 'Sorry, you are not allowed to do that.', 'addon-boss' ) ), 403 );
	}
	$product = wc_get_product( $pid );
	if ( ! $product instanceof WC_Product ) {
		wp_send_json_error();
	}
	// A row already saved keeps what the tab does not post (its prices for
	// this product, its condition); the switch on the tab wins.
	$saved = array();
	foreach ( addon_boss_flatten_option_config( addon_boss_product_option_config( $product, true ) ) as $bb_have ) {
		if ( is_array( $bb_have ) && '' !== (string) ( $bb_have['set'] ?? '' ) ) {
			$saved[ (string) $bb_have['set'] ] = $bb_have;
		}
	}
	$rows = array();
	foreach ( (array) wp_unslash( $_POST['rows'] ?? array() ) as $bb_row ) { // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized -- each leaf is sanitised below.
		$bb_sid = sanitize_text_field( (string) ( is_array( $bb_row ) ? ( $bb_row['set'] ?? '' ) : '' ) );
		if ( '' !== $bb_sid && addon_boss_option_set( $bb_sid ) ) {
			$rows[] = array(
				'set'      => $bb_sid,
				'required' => ! empty( $bb_row['required'] ),
			) + ( $saved[ $bb_sid ] ?? array( 'deltas' => array() ) );
		}
	}
	wp_send_json_success( array( 'html' => addon_boss_noprice_advice( $product, $rows ) ) );
}
add_action( 'wp_ajax_addon_boss_noprice_advice', 'addon_boss_noprice_advice_ajax' );

/**
 * Where a set made from a product's own link is remembered until that
 * product's tab asks (addon_boss_attach_menu_ajax): per person, per product.
 *
 * @param int $product_id The product the link was on.
 */
function addon_boss_made_for_key( int $product_id ): string {
	return 'addon_boss_made_for_' . get_current_user_id() . '_' . $product_id;
}

/**
 * Each set that brings lists along (addon_boss_set_companions: a glass
 * priced by its edge finish), with those lists, for the attach menu to say
 * "Already included through Glass size" instead of adding a second row.
 *
 * @return array<string,string[]> Set id => the lists it brings.
 */
function addon_boss_attach_companions(): array {
	$out = array();
	foreach ( addon_boss_option_sets() as $bb_id => $bb_set ) {
		$bb_with = addon_boss_set_companions( (array) $bb_set, (string) $bb_id );
		if ( $bb_with ) {
			$out[ (string) $bb_id ] = $bb_with;
		}
	}
	return $out;
}

/** The product a new set was opened from (?for_product=), or 0. */
function addon_boss_for_product_param(): int {
	$pid = isset( $_GET['for_product'] ) ? absint( $_GET['for_product'] ) : 0; // phpcs:ignore WordPress.Security.NonceVerification.Recommended -- read-only routing; the save checks its own nonce and the capability again.
	return $pid && 'product' === get_post_type( $pid ) && current_user_can( 'edit_post', $pid ) ? $pid : 0;
}

/**
 * The attach menu again, for a product tab left open while a set was made
 * in another tab: the new set was missing until a reload, and reloading a
 * product not yet saved loses it (walk 5, 30 Oct 2026). The sets by folder
 * as the menu draws them, and the sets made from this product's own link
 * since it last asked, which the tab attaches.
 */
function addon_boss_attach_menu_ajax(): void {
	$pid = absint( $_POST['product'] ?? 0 );
	if ( ! check_ajax_referer( 'addon_boss_noprice_advice', '_wpnonce', false ) || ! current_user_can( 'edit_post', $pid ) ) {
		wp_send_json_error( array( 'message' => __( 'Sorry, you are not allowed to do that.', 'addon-boss' ) ), 403 );
	}
	wp_send_json_success( addon_boss_attach_menu_data( $pid ) );
}

/**
 * What the attach menu asks for: the sets by folder, and the sets made from
 * this product's own link since it last asked (each told once).
 *
 * @param int $pid The product.
 * @return array{groups:array,made:string[]}
 */
function addon_boss_attach_menu_data( int $pid ): array {
	$groups = array();
	foreach ( addon_boss_option_sets_by_group() as $bb_g => $bb_sets ) {
		$bb_list = array();
		foreach ( $bb_sets as $bb_id => $bb_name ) {
			$bb_list[] = array( (string) $bb_id, (string) $bb_name );
		}
		$groups[] = array(
			'g'    => (string) $bb_g,
			'sets' => $bb_list,
		);
	}
	$made = array_values( array_filter( array_map( 'strval', (array) get_transient( addon_boss_made_for_key( $pid ) ) ), 'addon_boss_option_set' ) );
	delete_transient( addon_boss_made_for_key( $pid ) );
	return array(
		'groups' => $groups,
		'made'   => $made,
	);
}

/**
 * Remembers a set made from a product's own link, for that product's tab
 * (addon_boss_attach_menu_data).
 *
 * @param int    $pid The product.
 * @param string $id  The set made.
 */
function addon_boss_remember_made_for( int $pid, string $id ): void {
	$made   = (array) get_transient( addon_boss_made_for_key( $pid ) );
	$made[] = $id;
	set_transient( addon_boss_made_for_key( $pid ), array_values( array_unique( array_filter( array_map( 'strval', $made ) ) ) ), DAY_IN_SECONDS );
}
add_action( 'wp_ajax_addon_boss_attach_menu', 'addon_boss_attach_menu_ajax' );

/** A price for the product screen's advice, as the price box takes it. */
function addon_boss_price_floor_money( float $v ): string {
	// aob-money-raw: the product screen speaks in the price box's own basis, the one the merchant types.
	return html_entity_decode( addon_boss_plain_price( $v ), ENT_QUOTES, 'UTF-8' );
}

/**
 * "Use £X" where a set prices the whole product: it fills the price box, and
 * Update saves it. '' where there is no one price to offer.
 *
 * @param array|null $floor From addon_boss_product_price_floor().
 */
function addon_boss_price_floor_use( ?array $floor ): string {
	if ( ! $floor || ! $floor['whole'] ) {
		return '';
	}
	$money = addon_boss_price_floor_money( (float) $floor['price'] );
	return ' <button type="button" class="bb-po-ghostbtn bb-po-useprice" data-price="' . esc_attr( wc_format_localized_price( (string) $floor['price'] ) ) . '"'
		. ' data-done="' . esc_attr( sprintf( /* translators: %s: a price */ __( '%s is in the price box. Update saves it.', 'addon-boss' ), $money ) ) . '">'
		. esc_html( sprintf( /* translators: %s: a price */ __( 'Use %s', 'addon-boss' ), $money ) ) . '</button>';
}

/**
 * The warning that shop pages show a price nobody can pay, for the product's
 * AddOnBoss tab and, under the price box, its General tab: the sign tester
 * typed £5.00 there and was told nothing (18 Oct 2026). '' when the price is
 * one a shopper can pay, or there is no price yet.
 *
 * @param WC_Product $product The product.
 */
function addon_boss_price_floor_note( WC_Product $product ): string {
	if ( '' === (string) $product->get_price( 'edit' ) ) {
		return '';
	}
	$floor = addon_boss_product_price_floor( $product );
	$own   = (float) $product->get_price( 'edit' );
	$sized = $floor && $floor['whole'] && 'measured' === ( $floor['kind'] ?? '' );
	if ( ! $floor || ( ! $sized && abs( $floor['price'] - $own ) < 0.005 ) || ( ! $floor['whole'] && $floor['price'] <= $own ) ) {
		return '';
	}
	// A measured size that prices the whole product: shop pages show "From"
	// its cheapest size whatever price the product holds, so there is nothing
	// to set. "Shop pages show £0.00 ... Use £1.40" was false on both counts in
	// a shop that shows prices without VAT (walk 3, 30 Oct 2026).
	// But a price typed there is not used, and the owner is told so where
	// it is typed, never left to find out (walk 6, 30 Oct 2026). 0 is the
	// plain setting and says nothing.
	if ( $floor['whole'] && 'measured' === ( $floor['kind'] ?? '' ) ) {
		if ( abs( $own ) < 0.005 ) {
			return '';
		}
		$from = html_entity_decode( addon_boss_money( (float) $floor['price'], $product, array( 'plain' => true ) ), ENT_QUOTES, 'UTF-8' );
		/* translators: %s: the price shop pages show, like From £1.17 */
		$say = sprintf( __( 'The size sets the whole price, so this price is not used. Shop pages show %s.', 'addon-boss' ), sprintf( /* translators: %s: a price */ __( 'From %s', 'addon-boss' ), $from ) );
		return '<p class="bb-po-pricefloor bb-po-sizeprice" data-floor="0">' . esc_html( $say ) . '</p>';
	}
	if ( $floor['whole'] ) {
		$own_money   = addon_boss_price_floor_money( $own );
		$floor_money = addon_boss_price_floor_money( (float) $floor['price'] );
		if ( 'pack' === ( $floor['noun'] ?? 'size' ) ) {
			/* translators: 1: the product's own price, 2: the cheapest pack's price */
			$say = sprintf( __( 'Shop pages show %1$s. The cheapest pack is %2$s.', 'addon-boss' ), $own_money, $floor_money );
		} elseif ( 'choice' === ( $floor['noun'] ?? 'size' ) ) {
			/* translators: 1: the product's own price, 2: the cheapest choice's price, like 100 cards in matt */
			$say = sprintf( __( 'Shop pages show %1$s. The cheapest choice is %2$s.', 'addon-boss' ), $own_money, $floor_money );
		} else {
			/* translators: 1: the product's own price, 2: the cheapest size's price */
			$say = sprintf( __( 'Shop pages show %1$s. The cheapest size is %2$s.', 'addon-boss' ), $own_money, $floor_money );
		}
	} else {
		/* translators: 1: the product's own price, 2: the least a shopper can pay for it */
		$say = sprintf( __( 'Shop pages show %1$s, but the choices this product requires make the cheapest %2$s.', 'addon-boss' ), addon_boss_price_floor_money( $own ), addon_boss_price_floor_money( (float) $floor['price'] ) );
	}
	return '<p class="bb-po-pricefloor" data-floor="' . esc_attr( (string) $floor['price'] ) . '">' . esc_html( $say ) . addon_boss_price_floor_use( $floor ) . '</p>';
}

/** The same warning under the General tab's price box, where the price is typed. */
function addon_boss_price_floor_under_price(): void {
	global $product_object;
	if ( $product_object instanceof WC_Product && $product_object->is_type( 'simple' ) ) {
		echo addon_boss_price_floor_note( $product_object ); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- built from escaped parts.
	}
}
add_action( 'woocommerce_product_options_pricing', 'addon_boss_price_floor_under_price' );

function addon_boss_product_options_panel(): void {
	global $post;
	$product = $post ? wc_get_product( $post->ID ) : null;
	$config  = $product ? addon_boss_product_option_config( $product, true ) : array();
	$sets    = addon_boss_option_sets();
	// The sets attached to THIS product: the reveal-rule triggers a field may
	// point at (a field shown "only when" one of these is picked a certain way).
	$bb_attached = array();
	foreach ( addon_boss_flatten_option_config( $config ) as $bb_crow ) {
		$bb_csid = (string) ( $bb_crow['set'] ?? '' );
		if ( '' !== $bb_csid && isset( $sets[ $bb_csid ] ) ) {
			$bb_attached[ $bb_csid ] = $sets[ $bb_csid ];
		}
	}
	?>
	<div id="bundle_boss_options_panel" class="panel woocommerce_options_panel"
		data-bb-product="<?php echo (int) ( $post ? $post->ID : 0 ); ?>"
		<?php do_action( 'addon_boss_options_panel_attrs', $post ); ?>>
		<?php
		// A module with something to say before the attach UI says it here: the
		// converted-draft check card renders first because it is the reason the
		// merchant landed on this screen.
		do_action( 'addon_boss_options_panel_before', $product );
		?>
		<?php
		/**
		 * ONE BAND HOLDS EVERY SETTING, ABOVE THE LIST.
		 *
		 * These used to be scattered down the whole panel: two folds at the
		 * top, an always-open card in the middle, and three more folds
		 * stranded BELOW the list, which on a busy product put them nearly
		 * four thousand pixels down. Nobody scrolls past their own work to
		 * look for a setting, so in practice the ones at the bottom were not
		 * there at all.
		 *
		 * Collected here they are cheap, because each one is a fold whose
		 * shut line already states its own answer. Shut, the band reads as a
		 * summary of how this product behaves; open, the controls are right
		 * here with no trip anywhere.
		 *
		 * The band opens OUTSIDE the layout condition below, because that
		 * condition governs two of the folds and none of the others.
		 */
		?>
		<div class="options_group bb-behave" id="bb-behave">
			<p class="bb-behave-head"><?php esc_html_e( 'How this product behaves', 'addon-boss' ); ?></p>
			<p class="bb-behave-sub"><?php esc_html_e( 'All optional. Each row shows what it is set to.', 'addon-boss' ); ?></p>
		<?php
		// How the groups are arranged, offered once there is more than one group
		// to arrange. A single group has nothing to fold or step through, so the
		// control would be a decision about nothing.
		$bb_layouts = addon_boss_options_layouts();
		$bb_layout  = $product ? addon_boss_options_layout( $product ) : 'stacked';
		if ( count( $bb_layouts ) > 1 && count( addon_boss_flatten_option_config( $config ) ) > 1 ) :
			?>
		<div class="options_group bb-product-layout">
			<?php
			// ONE FOLDED SECTION AT THE TOP, NOT THREE NAKED ROWS.
			//
			// These are set once and then never touched again, while the
			// builder underneath is the reason the merchant opened the tab, on
			// a panel that runs past 1700px on a product with a dozen fields.
			// Above the builder and unfolded they are three rows of furniture
			// in front of the work every single time.
			//
			// Folded is only safe because the shut line states the answer. The
			// sibling plugin moved this decision out to a tab of its own for
			// exactly the opposite case: a fold at the BOTTOM of a long panel,
			// saying nothing, which nobody ever found.
			?>
			<details class="bb-shelf-disc bb-lookshelf">
				<summary class="bb-shelf-sum">
					<?php
					// THE SHUT ROW HAS TO ADVERTISE WHAT IS INSIDE IT. This
					// control is the first thing in the panel and still gets
					// missed, because it sits above fourteen bordered rows that
					// shout and it says nothing a merchant would open it for. A
					// row of text cannot say "there are pictures in here"; a
					// picture can. The script swaps it from the lit card, so
					// there is one source for the drawings and no second copy
					// to fall out of step.
					$bb_thumb_cards = addon_boss_options_layout_cards();
					$bb_thumb       = isset( $bb_thumb_cards[ $bb_layout ]['wf'] )
						? $bb_thumb_cards[ $bb_layout ]['wf']
						: addon_boss_options_card_placeholder();
					?>
					<span class="bb-look-thumb" aria-hidden="true"><?php echo addon_boss_options_card_svg( $bb_thumb ); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- run through an allow list inside the helper. ?></span>
					<span class="bb-look-titles">
						<span class="bb-look-h"><?php esc_html_e( 'How this page looks', 'addon-boss' ); ?></span>
						<?php // The line its neighbours all have. Naming the value without naming the choice is why nobody opens it. ?>
						<?php
						// NO SUBTITLE. It said what the label already says, on
						// the one row in the band still carrying three things
						// instead of two. The thumbnail stays: a row of text
						// cannot say "there are pictures in here", and that is
						// the affordance this control was missed without. The
						// value on the right says what it is set to.
						?>
					</span>
					<?php // The two words ride the markup so the line the script rebuilds is the translated one, not an English literal baked into a script file. ?>
					<span class="bb-look-state"
						data-num="<?php esc_attr_e( 'numbered', 'addon-boss' ); ?>"
						data-rev="<?php esc_attr_e( 'with a review', 'addon-boss' ); ?>"
						data-pho="<?php esc_attr_e( 'with the photo in view', 'addon-boss' ); ?>"><?php echo esc_html( addon_boss_options_look_line( $product ) ); ?></span>
				</summary>
				<div class="bb-lookbody">
					<p class="bb-look-lab">
						<label for="bb_options_layout"><?php esc_html_e( 'Arrangement', 'addon-boss' ); ?></label>
						<span class="bb-look-sub"><?php esc_html_e( '(pick one)', 'addon-boss' ); ?></span>
					</p>
					<select id="bb_options_layout" name="bb_options_layout" class="bb-layout-sel">
						<?php foreach ( $bb_layouts as $bb_lk => $bb_ln ) : ?>
							<option value="<?php echo esc_attr( $bb_lk ); ?>" <?php selected( $bb_layout, $bb_lk ); ?>><?php echo esc_html( $bb_ln ); ?></option>
						<?php endforeach; ?>
					</select>
					<?php addon_boss_options_pick_cards( 'bb_options_layout', $bb_layouts, addon_boss_options_layout_cards(), $bb_layout ); ?>
					<p class="description bb-layout-note">
						<?php // Half of what this used to say is now on the folding card itself, where a merchant reads it while choosing rather than after. ?>
						<?php esc_html_e( 'A folded group\'s header always shows the current choice.', 'addon-boss' ); ?>
					</p>

					<?php
					// ONLY MEANINGFUL ON THE FOLDING ARRANGEMENT, so it is only
					// on screen for that one. One after another has nothing to
					// fold, and Fold as you go decides its own opening state:
					// offering a choice either would ignore is worse than
					// offering none at all.
					$bb_open_now = $product ? addon_boss_options_open_state( $product ) : 'all';
					$bb_req_all  = addon_boss_options_required_share( $product );
					?>
					<div class="bb-look-arrive" data-bb-when="accordion"<?php echo 'accordion' === $bb_layout ? '' : ' hidden'; ?>>
						<p class="bb-look-lab"><?php esc_html_e( 'When the page opens', 'addon-boss' ); ?></p>
						<select id="bb_options_openstate" name="bb_options_openstate" class="bb-openstate-sel">
							<?php foreach ( addon_boss_options_open_states() as $bb_ok => $bb_on ) : ?>
								<option value="<?php echo esc_attr( $bb_ok ); ?>" <?php selected( $bb_open_now, $bb_ok ); ?>><?php echo esc_html( $bb_on ); ?></option>
							<?php endforeach; ?>
						</select>
						<p class="description">
							<?php
								// NOT "any section". A group holding something the
								// shopper must answer is never a disclosure at all,
								// so it cannot fold, and the mirror line below says
								// how many of those this product has. Claiming every
								// section folds and then correcting it one line
								// later is how a merchant reads their own demo as
								// broken instead of reading the rule.
								esc_html_e( 'This sets how the page arrives. A shopper can fold and unfold from there.', 'addon-boss' );
								?>
						</p>
						<?php
						// THE MIRROR. A group holding something the shopper must
						// answer is never a disclosure at all, by design, so it
						// cannot be shut. On a mostly-required product the two
						// compact choices barely change the page, and a merchant
						// who is not told that reports a setting that looks
						// ignored.
						if ( $bb_req_all[1] > 0 && $bb_req_all[0] === $bb_req_all[1] ) :
							?>
							<p class="bb-look-mirror">
								<?php esc_html_e( 'Every question on this product must be answered, so none of them can be closed. This page looks the same whichever you pick.', 'addon-boss' ); ?>
							</p>
						<?php elseif ( $bb_req_all[0] > 0 ) : ?>
							<p class="bb-look-mirror">
								<?php
								printf(
									/* translators: 1: how many questions must be answered, 2: how many questions there are in total */
									esc_html__( '%1$s of this product&#8217;s %2$s questions must be answered. Those stay open whatever you pick here.', 'addon-boss' ),
									esc_html( number_format_i18n( $bb_req_all[0] ) ),
									esc_html( number_format_i18n( $bb_req_all[1] ) )
								);
								?>
							</p>
						<?php endif; ?>
					</div>

					<p class="bb-look-lab">
						<?php esc_html_e( 'Also show', 'addon-boss' ); ?>
						<span class="bb-look-sub"><?php esc_html_e( '(any of these)', 'addon-boss' ); ?></span>
					</p>
					<?php
					// TWO SWITCHES, NOT A THIRD LAYOUT. Numbering and the review
					// are independent of each other and of the menu above, so
					// every combination a merchant might want is reachable.
					// Welded into one menu entry they came as a pair and the
					// folding layout could never have either.
					//
					// Drawn with WooCommerce's own field helper as well as with
					// cards: the helper's markup is what a merchant gets when
					// the script does not run, and it is what actually posts.
					// The cards only set it.
					$bb_num_on = $product && addon_boss_options_numbered( $product );
					$bb_rev_on = $product && addon_boss_options_review( $product );
					$bb_pho_on = $product && addon_boss_options_photo_in_view( $product );
					woocommerce_wp_checkbox(
						array(
							'id'          => 'bb_options_numbered',
							'label'       => __( 'Number every question', 'addon-boss' ),
							'value'       => $bb_num_on ? 'yes' : 'no',
							'description' => __( 'In the order the shopper meets them.', 'addon-boss' ),
						)
					);
					woocommerce_wp_checkbox(
						array(
							'id'          => 'bb_options_review',
							'label'       => __( 'Show a review before the button', 'addon-boss' ),
							'value'       => $bb_rev_on ? 'yes' : 'no',
							'description' => __( 'Every question and what was chosen, with a way back to each one.', 'addon-boss' ),
						)
					);
					woocommerce_wp_checkbox(
						array(
							'id'          => 'bb_options_photoview',
							'label'       => __( 'Keep the photo in view', 'addon-boss' ),
							'value'       => $bb_pho_on ? 'yes' : 'no',
							'description' => __( 'On a wide screen the photo stays in view as the page scrolls. On a phone it shows in the price bar.', 'addon-boss' ),
						)
					);
					addon_boss_options_toggle_cards(
						array(
							array(
								'id'    => 'bb_options_numbered',
								'label' => __( 'Numbered', 'addon-boss' ),
								'hint'  => __( '1, 2, 3 beside every question.', 'addon-boss' ),
								'on'    => $bb_num_on,
								'wf'    => '<svg viewBox="0 0 100 52" aria-hidden="true">'
									. '<circle class="wfb" cx="13" cy="9" r="5.5"/>'
									. '<rect class="wfr" x="24" y="5" width="56" height="8" rx="2"/>'
									. '<circle class="wfb" cx="13" cy="26" r="5.5"/>'
									. '<rect class="wfr" x="24" y="22" width="47" height="8" rx="2"/>'
									. '<circle class="wfb" cx="13" cy="43" r="5.5"/>'
									. '<rect class="wfr" x="24" y="39" width="56" height="8" rx="2"/>'
									. '</svg>',
							),
							array(
								'id'    => 'bb_options_review',
								'label' => __( 'Review', 'addon-boss' ),
								'hint'  => __( 'Every choice listed, above the button.', 'addon-boss' ),
								'on'    => $bb_rev_on,
								'wf'    => '<svg viewBox="0 0 100 52" aria-hidden="true">'
									. '<rect class="wfr" x="7" y="4" width="34" height="5" rx="1.5"/>'
									. '<rect class="wfr" x="7" y="14" width="28" height="5" rx="1.5"/>'
									. '<rect class="wfr" x="45" y="14" width="24" height="5" rx="1.5"/>'
									. '<rect class="wfr" x="7" y="24" width="28" height="5" rx="1.5"/>'
									. '<rect class="wfr" x="45" y="24" width="32" height="5" rx="1.5"/>'
									. '<rect class="wfr" x="7" y="34" width="28" height="5" rx="1.5"/>'
									. '<rect class="wfr" x="45" y="34" width="18" height="5" rx="1.5"/>'
									. '<rect class="wfb" x="7" y="43" width="38" height="8" rx="2"/>'
									. '</svg>',
							),
							array(
								'id'    => 'bb_options_photoview',
								'label' => __( 'Photo kept in view', 'addon-boss' ),
								'hint'  => __( 'The picture follows as they scroll.', 'addon-boss' ),
								'on'    => $bb_pho_on,
								'wf'    => '<svg viewBox="0 0 100 52" aria-hidden="true">'
									. '<rect class="wfb" x="5" y="6" width="38" height="30" rx="3"/>'
									. '<rect class="wfr" x="52" y="4" width="43" height="7" rx="2"/>'
									. '<rect class="wfr" x="52" y="16" width="36" height="7" rx="2"/>'
									. '<rect class="wfr" x="52" y="28" width="43" height="7" rx="2"/>'
									. '<rect class="wfr" x="52" y="40" width="29" height="7" rx="2"/>'
									. '</svg>',
							),
						)
					);
					?>
				</div>
			</details>
			<?php
			// POPULAR SETUPS: the merchant's own starting points.
			//
			// Its own shelf rather than a line inside "How this page looks",
			// because these are not a look: they are content, with names a
			// shopper reads and picks a shopper gets. Folded, because a product
			// with none should cost no height at all.
			$bb_setup_sets = $product ? addon_boss_standalone_option_sets( $product ) : array();
			$bb_setup_rows = $product ? addon_boss_options_setups( $product ) : array();
			if ( $bb_setup_sets ) :
				?>
			<details class="bb-shelf-disc bb-setupshelf">
				<summary class="bb-shelf-sum">
					<?php
					// NAME AND STATE, nothing else. Every other row in the band
					// is a name on the left and what it is doing on the right,
					// and this one carried a third thing: a sentence explaining
					// the feature, on a row whose whole job is to be scanned.
					// The explanation is inside, where someone who opened the
					// row has asked for it.
					//
					// "Popular" also went. Nothing counts presses, so it claimed
					// something we do not measure; these are whatever the
					// merchant wrote. Ready-made is true and says the same.
					?>
					<span class="bb-look-titles">
						<span class="bb-look-h"><?php esc_html_e( 'Ready-made setups', 'addon-boss' ); ?></span>
					</span>
					<span class="bb-look-state bb-setup-count"
						data-none="<?php esc_attr_e( 'None yet', 'addon-boss' ); ?>"
						data-some="<?php
						echo esc_attr(
							(string) wp_json_encode(
								addon_boss_js_plural(
									static function ( $n ) {
										/* translators: %s: how many setups this product offers */
										return _n( '%s offered', '%s offered', $n, 'addon-boss' );
									}
								)
							)
						);
						?>"></span>
				</summary>
				<div class="bb-shelf-body">
					<?php
					addon_boss_options_addctl_tip(
						__( 'A setup fills in the choices you name here, in one press. The page still arrives blank, and a shopper can change anything afterwards.', 'addon-boss' )
					);
					?>
					<div class="bb-setup-rows">
						<?php foreach ( $bb_setup_rows as $bb_i => $bb_row ) : ?>
							<?php addon_boss_setup_editor_row( (int) $bb_i, $bb_row, $bb_setup_sets ); ?>
						<?php endforeach; ?>
					</div>
					<template class="bb-setup-tpl"><?php addon_boss_setup_editor_row( -1, array(), $bb_setup_sets ); ?></template>
					<?php
					// The panel's own add control, not WordPress's stock button.
					// This is the same act as "Add a section" in the add bar, so
					// it wears the same chrome; "button" stays on it only so a
					// theme that styles bare buttons cannot strip it back.
					?>
					<button type="button" class="button bb-po-addctl bb-setup-add"><?php esc_html_e( 'Add a setup', 'addon-boss' ); ?></button>
				</div>
			</details>
			<?php endif; ?>
		</div>
		<?php endif; ?>
			<?php
			// For a variable product: one clean toggle to order every colour and
			// size at once (the quantity grid) instead of one variation per add.
			// A build without the grid orders one at a time, so it offers no
			// control for a choice it cannot carry out.
			if ( addon_boss_engine_can( 'grid' ) && function_exists( 'addon_boss_order_layout_control' ) ) {
				addon_boss_order_layout_control( $product );
			}
			?>
			<?php
			// MOVED UP, out from under the list. A module's own settings used to
			// print after the add bar, which put them below however many rows
			// the merchant had built. Same call, same order between the
			// modules, so a module needs to know nothing about the move.
			do_action( 'addon_boss_options_panel_extras', $product );
			?>
			<?php
			// Which named areas this product offers, taken from the reusable
			// library, with its own prices and its own aim. Still rendered right
			// after the sides manager, because a position lives ON a side and the
			// wording leans on them being visible just above.
			if ( function_exists( 'addon_boss_product_positions_control' ) ) {
				addon_boss_product_positions_control( $product );
			}
			?>
			<?php
			/**
			 * ONE FOLD OPEN AT A TIME, INSIDE THE BAND ONLY.
			 *
			 * Left independent, a merchant who opened three settings would push
			 * their own list back down the page, which is the exact problem the
			 * band exists to fix. Opening one shuts the rest, so the band has a
			 * ceiling whatever is in it.
			 *
			 * Rows in the LIST below stay independent on purpose: those are the
			 * merchant's content, and comparing two at once is a real thing to
			 * want.
			 *
			 * This is inline rather than in a plugin's admin.js because the
			 * engine renders inside whichever plugin is hosting it, and that
			 * host's script is the one the page loads. Inline travels with the
			 * markup.
			 *
			 * Capturing, because `toggle` does not bubble. Nothing is stored:
			 * a reload starts with the band shut, which is the summary view it
			 * is meant to be read as.
			 */
			ob_start();
			try {
				?>
				jQuery( function () {
					var band = document.getElementById( 'bb-behave' );
					if ( ! band ) { return; }
					band.addEventListener( 'toggle', function ( e ) {
						var d = e.target;
						if ( ! d || 'DETAILS' !== d.tagName || ! d.open ) { return; }
						Array.prototype.forEach.call(
							band.querySelectorAll( 'details[open]' ),
							function ( o ) {
								// Never an ancestor or a descendant of the one
								// just opened: shutting an ancestor would shut
								// what was clicked.
								if ( o !== d && ! o.contains( d ) && ! d.contains( o ) ) {
									o.open = false;
								}
							}
						);
					}, true );
				} );
				<?php
			} finally {
				addon_boss_inline_js( ob_get_clean() );
			}
			?>
		</div>
		<div class="options_group bb-product-options">
			<div class="bb-panelhead">
				<b><?php esc_html_e( 'Options this product comes in', 'addon-boss' ); ?></b>
				<span class="bb-by-badge"><?php echo esc_html( (string) apply_filters( 'addon_boss_engine_brand_name', '' ) ); ?></span>
			</div>
			<p class="bb-panel-sub">
				<?php if ( $product && $product->is_type( 'variable' ) ) : ?>
					<?php
					// The panel is not gated by product type, but the STOREFRONT is:
					// without the module that reconciles two choice systems on one
					// page, a variable parent offers no sets. Saying so here is the
					// difference between a limit and a dead end - the tab used to
					// promise the paid behaviour to every build, so a merchant
					// attached a set, saved, and found out from their own product
					// page. Same register as the converter's stock note: what this
					// build does, never what another one costs.
					if ( addon_boss_engine_can( 'variable-options' ) ) {
						esc_html_e( 'This product is variable. Its variations keep owning colour, size, stock and photos; option sets ride along as extras on top, priced per pick.', 'addon-boss' );
					} else {
						esc_html_e( 'This build offers option sets on simple products, so a set attached here will not show on the page. The rebuild below makes a copy that can carry them.', 'addon-boss' );
					}
					?>
				<?php else : ?>
					<?php
					// The engine is shared, but the sentence is not: AddOnBoss has no
					// bundles, so promising that "every bundle inherits them" there
					// describes a feature the merchant does not have.
					if ( addon_boss_engine_host_has_bundles() ) {
						esc_html_e( 'Attach the sets this product offers. Every bundle that includes it inherits them; shoppers pick for each one they buy. No variations are created.', 'addon-boss' );
					} else {
						esc_html_e( 'Attach the sets this product offers. Shoppers pick from them on the product page. No variations are created.', 'addon-boss' );
					}
					?>
				<?php endif; ?>
				<?php // New tab: this link leaves a half-edited product, and losing the page mid-setup was his walk's sorest point. ?>
				<a href="<?php echo esc_url( admin_url( 'admin.php?page=addon-boss-option-sets' ) ); ?>" target="_blank" rel="noopener"><?php esc_html_e( 'Manage option sets', 'addon-boss' ); ?> &rarr;</a>
			</p>
			<?php
			// A simple product with no price is not purchasable, so WooCommerce
			// renders no add-to-cart area and the options never show. Warn right
			// here, and let JS clear the notice the moment a price is typed.
			if ( $product instanceof WC_Product && ! $product->is_type( 'variable' ) ) :
				$bb_has_price = '' !== (string) $product->get_price( 'edit' );
				?>
				<p class="bb-po-noprice"<?php echo $bb_has_price ? ' hidden' : ''; ?> data-nonce="<?php echo esc_attr( wp_create_nonce( 'addon_boss_noprice_advice' ) ); ?>"><?php echo addon_boss_noprice_advice( $product ); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- built from escaped parts. ?></p>
				<?php
				// A price nobody can pay, said where the price and the Required
				// switches are; the General tab says it under the price box too.
				echo addon_boss_price_floor_note( $product ); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- built from escaped parts.
				?>
				<?php ob_start(); try { ?>
				jQuery( function ( $ ) {
					var $rp = $( '#_regular_price' );
					if ( ! $rp.length ) { return; }
					function bbNoPriceSync() {
						var v = $.trim( $rp.val() || '' );
						$( '.bb-po-noprice:not(.is-done)' ).prop( 'hidden', '' !== v );
						// The warning goes once the box holds the price it asks for.
						$( '.bb-po-pricefloor:not(.is-done)' ).each( function () {
							$( this ).prop( 'hidden', '' === v || Math.abs( parseFloat( v.replace( ',', '.' ) ) - parseFloat( $( this ).attr( 'data-floor' ) ) ) < 0.005 );
						} );
					}
					// "Use £X" fills the price box; Update saves it, and the note says
					// so in place of the warning (it went quiet before, and nothing
					// said the price still had to be saved).
					// Only the notes that were showing say so, once in each place:
					// the tab's hidden "no price" note came back with the same
					// words as the one beside it (fresh tester, 18 Oct 2026).
					$( document ).on( 'click', '.bb-po-useprice', function () {
						var $b   = $( this );
						var $all = $( '.bb-po-noprice, .bb-po-pricefloor' );
						var $on  = $all.filter( function () { return ! this.hidden; } );
						$all.addClass( 'is-done' );
						$rp.val( $b.attr( 'data-price' ) ).trigger( 'change' );
						$on.prop( 'hidden', false ).text( $b.attr( 'data-done' ) );
					} );
					$rp.on( 'input change', bbNoPriceSync );
					bbNoPriceSync();
				} );
				<?php } finally { addon_boss_inline_js( ob_get_clean() ); } ?>
			<?php endif; ?>
			<?php if ( ! $sets ) : ?>
				<p class="bb-po-empty" style="padding:0 12px"><em><?php
				echo wp_kses_post(
					sprintf(
						/* translators: %s: a link labelled "the Option sets library" */
						__( 'No option sets exist yet. Start one in %s, where ready-made starting points are a click away.', 'addon-boss' ),
						'<a href="' . esc_url( admin_url( 'admin.php?page=addon-boss-option-sets' ) ) . '" target="_blank" rel="noopener">' . esc_html__( 'the Option sets library', 'addon-boss' ) . '</a>'
					)
				);
				?></em></p>
			<?php endif; ?>
									<div class="bb-po-list" id="bb-product-option-rows">
						<?php
						// The one arranged list. A GROUP renders as a real container: its header
						// plus a .bb-po-grouplist holding its children, so drag in/out is explicit
						// and moving a group never sweeps up neighbours. Every row gets a unique
						// DOM index; the save reads its data by that index.
						$bb_ri = 0;
						// Field key => label, of every field ALREADY drawn. A rule
						// may only point at one of these, which is what makes a
						// cycle impossible and reads as "you cannot depend on an
						// answer that has not been asked yet".
						$bb_earlier = array();
						foreach ( $config as $bb_lrow ) {
							if ( ( $bb_lrow['row_type'] ?? '' ) === 'group' ) {
								echo '<div class="bb-po-row bb-po-grouprow" data-idx="' . (int) $bb_ri . '">';
								addon_boss_render_product_group_head( $bb_ri, (array) $bb_lrow );
								echo '<div class="bb-po-grouplist" data-empty="' . esc_attr__( 'Drag sets and fields in here', 'addon-boss' ) . '">';
								$bb_ri++;
								foreach ( (array) ( $bb_lrow['children'] ?? array() ) as $bb_child ) {
									addon_boss_render_product_child_row( $bb_ri, (array) $bb_child, $sets, $bb_attached, $bb_earlier );
									addon_boss_note_earlier_field( $bb_child, $bb_earlier );
									$bb_ri++;
								}
								echo '</div></div>';
							} else {
								addon_boss_render_product_child_row( $bb_ri, (array) $bb_lrow, $sets, $bb_attached, $bb_earlier );
								addon_boss_note_earlier_field( $bb_lrow, $bb_earlier );
								$bb_ri++;
							}
						}
						?>
				</div>
				<div class="bb-po-addbar">
						<?php
						// Fields and sections need no set to exist, so the editor never
						// hides behind an empty library; only this picker does, because
						// a picker with nothing to pick is a dead control.
						if ( $sets ) :
							?>
						<span class="bb-po-addctl-wrap">
							<select id="bb-po-attach" class="bb-po-addctl bb-po-attach">
								<option value=""><?php esc_html_e( 'Attach an option set…', 'addon-boss' ); ?></option>
								<?php
								// Folder-aware, but only where folders exist: a library
								// with none renders exactly the flat list it always did.
								$bb_by_group = addon_boss_option_sets_by_group();
								$bb_folders  = array_diff( array_keys( $bb_by_group ), array( '' ) );
								foreach ( $bb_by_group as $bb_gname => $bb_gsets ) :
									if ( '' === $bb_gname ) :
										// Loose sets: under a heading of their own only when
										// there are folders for them to stand apart from.
										if ( $bb_folders ) :
											?>
											<optgroup label="<?php esc_attr_e( 'Ungrouped', 'addon-boss' ); ?>">
											<?php
										endif;
										foreach ( $bb_gsets as $bb_sid => $bb_sname ) :
											?>
											<option value="<?php echo esc_attr( $bb_sid ); ?>"><?php echo esc_html( $bb_sname ); ?></option>
											<?php
										endforeach;
										if ( $bb_folders ) :
											?>
											</optgroup>
											<?php
										endif;
										continue;
									endif;
									?>
									<optgroup label="<?php echo esc_attr( $bb_gname ); ?>">
										<?php
										// The whole folder in one pick. It carries its members
										// so the row builder never has to ask the server what
										// is in there, and they arrive in library order.
										?>
										<option value="bbfolder:<?php echo esc_attr( $bb_gname ); ?>" data-bb-folder="<?php echo esc_attr( implode( ',', array_keys( $bb_gsets ) ) ); ?>">
											<?php
											printf(
												/* translators: %d: how many option sets the folder holds */
												esc_html( _n( 'Everything in here (%d set)', 'Everything in here (%d sets)', count( $bb_gsets ), 'addon-boss' ) ),
												(int) count( $bb_gsets )
											);
											?>
										</option>
										<?php foreach ( $bb_gsets as $bb_sid => $bb_sname ) : ?>
											<option value="<?php echo esc_attr( $bb_sid ); ?>"><?php echo esc_html( $bb_sname ); ?></option>
										<?php endforeach; ?>
									</optgroup>
								<?php endforeach; ?>
								<?php // A set made here comes back attached, under "Just made" (walk 6). ?>
								<option value="bbnew:"><?php esc_html_e( '+ New set…', 'addon-boss' ); ?></option>
							</select>
							<?php addon_boss_options_addctl_tip( __( 'A reusable list of choices, like Size or Colour.', 'addon-boss' ), 'focus' ); ?>
						</span>
						<span class="bb-po-attachsay" role="status" hidden></span>
						<?php endif; ?>
						<?php if ( function_exists( 'addon_boss_personalisation_field_types' ) ) : ?>
						<span class="bb-po-addctl-wrap">
							<select id="bb-pf-add" class="bb-po-addctl bb-pf-add" aria-label="<?php esc_attr_e( 'Add a field customers fill in', 'addon-boss' ); ?>">
								<option value=""><?php esc_html_e( 'Add a field…', 'addon-boss' ); ?></option>
									<?php
									// Every type the registry offers, in the registry's own menu
									// words. This list was once written by hand and fell seven
									// types behind the registry, so half the fields could only be
									// reached by adding a text field and changing its type inside
									// the row (his QA, 2 Sept). It now shares one list with the
									// picker inside each field's row, so neither can drift again.
									foreach ( addon_boss_field_type_menu() as $bb_ftype => $bb_fwords ) :
										?>
									<option value="<?php echo esc_attr( (string) $bb_ftype ); ?>"><?php echo esc_html( $bb_fwords ); ?></option>
									<?php endforeach; ?>
							</select>
							<?php addon_boss_options_addctl_tip( __( 'A box the customer fills in: a name, a message, a logo.', 'addon-boss' ), 'focus' ); ?>
						</span>
						<?php endif; ?>
						<span class="bb-po-addctl-wrap">
							<button type="button" id="bb-po-add-group" class="bb-po-addctl bb-po-add-group"><?php esc_html_e( 'Add a section', 'addon-boss' ); ?></button>
							<?php addon_boss_options_addctl_tip( __( 'Groups options under one title. Can repeat the whole block.', 'addon-boss' ), 'focus' ); ?>
						</span>
						<?php
						// A module with an add-bar entry of its own (the sides
						// manager) prints it here, beside the engine's.
						do_action( 'addon_boss_options_addbar_extra', $product );
						?>
					</div>
					<p class="bb-po-hint bb-po-addhint" data-bb-default=""><?php
						echo esc_html( (string) apply_filters(
							'addon_boss_options_addbar_hint',
							$sets
								? __( 'Add an option set, a field, or a section.', 'addon-boss' )
								: __( 'Add a field or a section.', 'addon-boss' ),
							$product
						) );
						?></p>
				<?php
				// The module SETTINGS used to render here, under the add bar.
				// They live in the band at the top now, because down here they
				// sat below however many rows the merchant had built, and nobody
				// scrolls past their own work to find a setting.
				//
				// What belongs here is an ACTION. "Start from another product"
				// is a verb: it does a thing once, to this product, and is then
				// finished. In the band it was the only row whose shut line was
				// a sentence rather than a state, which is the tell that it was
				// never a setting. Beside the Add controls it is with its kind.
				do_action( 'addon_boss_options_after_addbar', $product );
				?>
				<template id="bb-po-group-template"><div class="bb-po-row bb-po-grouprow" data-idx="__PGIDX__"><?php addon_boss_render_product_group_head( '__PGIDX__', array() ); ?><div class="bb-po-grouplist" data-empty="<?php esc_attr_e( 'Drag sets and fields in here', 'addon-boss' ); ?>"></div></div></template>
				<?php if ( function_exists( 'addon_boss_personalisation_field_types' ) ) : ?>
				<template id="bb-pf-row-template"><?php addon_boss_render_product_field_row( '__PFIDX__', array(), array(), $bb_attached, array(), true ); ?></template>
				<?php addon_boss_product_fields_admin_script(); ?>
				<?php endif; ?>
					<p class="bb-po-hint bb-po-foot" data-shared="<?php esc_attr_e( 'Sets are shared: edit one once and every product offering it follows.', 'addon-boss' ); ?>" data-copies="<?php esc_attr_e( 'The copies you take belong to this product only.', 'addon-boss' ); ?>"><?php esc_html_e( 'Sets are shared: edit one once and every product offering it follows.', 'addon-boss' ); ?></p>
				
				<?php ob_start(); try { ?>
				jQuery( function ( $ ) {
					var next = <?php echo (int) count( $config ); ?>;
					// Set id => name, so a whole folder can build its rows with real
					// names on them without a round trip to the server.
					window.addonBossSetNames = <?php echo wp_json_encode( wp_list_pluck( $sets, 'name' ) ); ?>;
					<?php
					// Field key => the two words that type uses for "there is an
					// answer" and "there is not", so a rule builder can re-word
					// itself the moment its trigger changes.
					$bb_op_words = array();
					foreach ( addon_boss_standalone_product_fields( $product ) as $bb_fd ) {
						$bb_fkey = (string) ( $bb_fd['key'] ?? '' );
						if ( '' === $bb_fkey ) {
							continue;
						}
						$bb_w                   = addon_boss_field_op_words( (string) ( $bb_fd['type'] ?? '' ) );
						$bb_op_words[ $bb_fkey ] = array( $bb_w['filled'], $bb_w['empty'] );
					}
					?>
					window.addonBossFieldOps = <?php echo wp_json_encode( $bb_op_words ); ?>;
					
					// The rows fold like every other family row; controls do not toggle.
					$( '#bundle_boss_options_panel' ).on( 'click', '.bb-po-line', function ( e ) {
						if ( $( e.target ).closest( 'select, button, input, label, a, .bb-seg' ).length ) {
							return;
						}
						var body = $( this ).siblings( '.bb-po-body' )[ 0 ];
						if ( body ) {
							body.hidden = ! body.hidden;
							$( this ).find( '.bb-po-caret' ).html( body.hidden ? '&#9656;' : '&#9662;' );
						}
					} );
					// Nested drag: the top-level list and every group's list are connected, so
					// a row drags between them. A group header stays a top-level item and never
					// nests inside another group. The container IS the boundary, so moving a
					// group carries its members and can never sweep up neighbours.
					var bbSortOpts = {
						handle: '.bb-po-line',
						items: '> .bb-po-row',
						distance: 6,
						cancel: 'select, button, input, textarea, a, label, .bb-seg',
						placeholder: 'bb-po-placeholder',
						forcePlaceholderSize: true,
						connectWith: '.bb-po-list, .bb-po-grouplist',
						over: function () { $( this ).closest( '.bb-po-grouprow' ).addClass( 'bb-po-groupactive' ); },
						out: function () { $( '.bb-po-grouprow' ).removeClass( 'bb-po-groupactive' ); },
						stop: function () { $( '.bb-po-grouprow' ).removeClass( 'bb-po-groupactive' ); },
						receive: function ( e, ui ) {
							if ( ui.item.hasClass( 'bb-po-grouprow' ) && $( this ).hasClass( 'bb-po-grouplist' ) ) { $( ui.sender ).sortable( 'cancel' ); }
						}
					};
					function bbMakeSortable( el ) { if ( el && $.fn.sortable && ! $( el ).hasClass( 'ui-sortable' ) ) { $( el ).sortable( bbSortOpts ); } }
					function bbInitSortables() { bbMakeSortable( document.getElementById( 'bb-product-option-rows' ) ); $( '.bb-po-grouplist' ).each( function () { bbMakeSortable( this ); } ); }
					bbInitSortables();
					// On save, serialise the DOM tree into bb_po_order[] with group / gend
					// markers so the exact nesting is stored.
					function bbRowKey( $el ) { return $el.children( '.bb-po-line' ).find( '.bb-po-orderkey' ).val() || ''; }
					$( '#bundle_boss_options_panel' ).closest( 'form' ).on( 'submit', function () {
						var $list = $( '#bb-product-option-rows' );
						$list.find( 'input[name="bb_po_order[]"]' ).remove();
						var seq = [];
						$list.children( '.bb-po-row' ).each( function () {
							var $el = $( this );
							seq.push( bbRowKey( $el ) );
							if ( $el.hasClass( 'bb-po-grouprow' ) ) {
								$el.children( '.bb-po-grouplist' ).children( '.bb-po-row' ).each( function () { seq.push( bbRowKey( $( this ) ) ); } );
								seq.push( 'gend-' + bbRowKey( $el ).replace( 'group-', '' ) );
							}
						} );
						var frag = document.createDocumentFragment();
						seq.forEach( function ( k ) { var inp = document.createElement( 'input' ); inp.type = 'hidden'; inp.name = 'bb_po_order[]'; inp.value = k; frag.appendChild( inp ); } );
						$list[0].appendChild( frag );
					} );
					// Add a group: append a fresh section header to name, then drag
					// sets and fields beneath it.
					var pgNext = 200000;
					$( '#bb-po-add-group' ).on( 'click', function () {
						var tmpl = document.getElementById( 'bb-po-group-template' );
						if ( ! tmpl ) { return; }
						var row = $( tmpl.innerHTML.replace( /__PGIDX__/g, String( pgNext ) ) );
						$( '#bb-product-option-rows' ).append( row );
						row.find( '.bb-po-grouplabel' ).trigger( 'focus' );
						bbMakeSortable( row.find( '.bb-po-grouplist' )[0] ); // connect the new group's drop zone
						var bbSegsG = window.addonBossBuildSegs || window.bundleBossBuildSegs;
						if ( bbSegsG ) { bbSegsG( row[0] ); }
						pgNext++;
					} );
					// The section rule: the message box only while the rule is on, and an
					// honest line when a Required question inside already meets it, so
					// the switch never looks like it is doing work it is not.
					var bbRuleMet = <?php echo wp_json_encode( /* translators: %s: the name of an option set marked Required inside the section. */ __( 'Already met: %s is required.', 'addon-boss' ) ); ?>;
					function bbSectionRuleSync( g ) {
						var on  = '1' === String( g.find( '> .bb-pg-rule select.bb-pg-min' ).val() || '' );
						g.find( '> .bb-pg-rule [data-bb-pg-msg]' ).prop( 'hidden', ! on );
						var met = '';
						g.find( '.bb-po-grouplist select.bb-po-req' ).each( function () {
							if ( ! met && '1' === String( $( this ).val() ) ) {
								met = $.trim( $( this ).closest( '.bb-po-row' ).find( '.bb-po-line b' ).first().text() );
							}
						} );
						g.find( '> .bb-pg-rule [data-bb-pg-met]' ).text( on && met ? bbRuleMet.replace( '%s', met ) : '' ).prop( 'hidden', ! ( on && met ) );
					}
					$( '#bb-product-option-rows' ).on( 'change', 'select.bb-pg-min, select.bb-po-req', function () {
						bbSectionRuleSync( $( this ).closest( '.bb-po-grouprow' ) );
					} ).on( 'sortupdate sortreceive', '.bb-po-grouplist', function () {
						bbSectionRuleSync( $( this ).closest( '.bb-po-grouprow' ) );
					} );
					$( '#bb-product-option-rows > .bb-po-grouprow' ).each( function () { bbSectionRuleSync( $( this ) ); } );
					// Searchable, consistent add controls: hundreds of option sets stay
					// usable. select2 (loaded on the product screen) powers the search;
					// the field picker keeps its short list with no search box.
					// A folder is found by ITS name, not only by its members'.
					//
					// select2 matches an option's own text. A folder's heading is an
					// optgroup label, which no browser lets anyone select, and the
					// "Everything in here" row inside it does not repeat the folder's
					// name. So searching "Sweatshirt" showed the heading with the one
					// row that answers it filtered out, and the only way through was to
					// clear the search and scroll (a founding customer's find, 7 Sept).
					//
					// A folder whose name matches now keeps ALL of its rows, so the
					// search answers both questions a merchant asks: which set, and
					// which folder.
					function bbFolderAwareMatch( params, data ) {
						var term = $.trim( ( params && params.term ) || '' ).toLowerCase();
						if ( '' === term ) { return data; }
						var mine = ( data.text || '' ).toLowerCase().indexOf( term ) > -1;
						if ( ! data.children ) { return mine ? data : null; }
						if ( mine ) { return data; } // the folder itself, whole
						var kept = [];
						for ( var k = 0; k < data.children.length; k++ ) {
							if ( ( data.children[ k ].text || '' ).toLowerCase().indexOf( term ) > -1 ) {
								kept.push( data.children[ k ] );
							}
						}
						if ( ! kept.length ) { return null; }
						// A shallow copy: handing back the original with its children
						// replaced would edit the list every later keystroke filters.
						var few = $.extend( {}, data );
						few.children = kept;
						return few;
					}
					if ( $.fn.select2 ) {
						$( '#bb-po-attach' ).select2( { width: '205px', placeholder: $( '#bb-po-attach option:first' ).text(), dropdownCssClass: 'bb-po-dropdown', matcher: bbFolderAwareMatch } );
						if ( $( '#bb-pf-add' ).length ) {
							$( '#bb-pf-add' ).select2( { width: '168px', placeholder: $( '#bb-pf-add option:first' ).text(), minimumResultsForSearch: Infinity, dropdownCssClass: 'bb-po-dropdown' } );
						}
					}
					function bbPoIdNow() { return parseInt( $( '#post_ID' ).val(), 10 ) || 0; }
					// The set on the tab that brings this list along, by name, or ''.
					var bbPoComp = <?php echo wp_json_encode( (object) addon_boss_attach_companions() ); ?>;
					function bbIncludedThrough( setId ) {
						var hit = '';
						$( '#bb-product-option-rows' ).find( 'input[name^="bb_po_set"]' ).each( function () {
							var have = this.value;
							if ( ! hit && have && have !== setId && ( bbPoComp[ have ] || [] ).indexOf( setId ) > -1 ) {
								hit = $.trim( $( this ).closest( '.bb-po-row' ).find( '.bb-po-line > b' ).first().text() ) || ( window.addonBossSetNames || {} )[ have ] || have;
							}
						} );
						return hit;
					}
					// One row per set, whether it arrived alone or with its folder.
					function bbAttachSet( setId, label, folder ) {
						if ( ! setId ) { return false; }
						// Already here: two rows for one set share a field name, so the
						// second silently eats the first. Say so on the row that exists
						// rather than making a broken one.
						var $have = $( '#bb-product-option-rows' ).find( 'input[name^="bb_po_set"]' ).filter( function () {
							return $( this ).val() === setId;
						} ).first();
						if ( $have.length ) {
							var $seen = $have.closest( '.bb-po-row' );
							$seen.addClass( 'bb-po-already' );
							window.setTimeout( function () { $seen.removeClass( 'bb-po-already' ); }, 1400 );
							return false;
						}
						var row = $(
							'<div class="bb-po-row"><div class="bb-po-line"><span class="bb-po-caret" aria-hidden="true">&#9656;</span><b></b>' +
							'<a class="bb-po-editset" target="_blank" rel="noopener"><?php echo esc_js( __( 'Edit set', 'addon-boss' ) ); ?><span aria-hidden="true">&#8599;</span></a>' +
							'<span class="bb-po-note"><?php echo esc_js( __( 'Prices just for this product can be set once you save it.', 'addon-boss' ) ); ?></span>' +
							'<select class="bb-seg-auto bb-po-req" name="bb_po_required[' + next + ']">' +
							'<option value=""><?php echo esc_js( __( 'Optional', 'addon-boss' ) ); ?></option>' +
							'<option value="1" selected><?php echo esc_js( __( 'Required', 'addon-boss' ) ); ?></option></select>' +
							'<button type="button" class="bb-po-remove" aria-label="<?php echo esc_attr( esc_js( __( 'Remove this set from the product', 'addon-boss' ) ) ); ?>">&#10005;</button>' +
							'<input type="hidden" name="bb_po_set[' + next + ']">' +
							'<input type="hidden" class="bb-po-fromgroup" name="bb_po_fromgroup[' + next + ']">' +
							'<input type="hidden" class="bb-po-orderkey" value="set-' + next + '"></div></div>'
						);
						row.find( 'b' ).text( label );
						row.find( '.bb-po-editset' ).attr( 'href', '<?php echo esc_js( admin_url( 'admin.php?page=addon-boss-option-sets&set=' ) ); ?>' + encodeURIComponent( setId ) );
						// Set ONLY the set-id input; the .bb-po-orderkey carrier must keep
						// its "set-<n>" value or the save drops the row (it fails the
						// "set-" prefix check). Blanket-setting every hidden input here was
						// the 4.16.0 regression that stopped newly attached sets saving.
						row.find( 'input[name^="bb_po_set"]' ).val( setId );
						row.find( '.bb-po-fromgroup' ).val( folder || '' );
						// A new set lands in the ungrouped area too, before any group.
						var $poRows = $( '#bb-product-option-rows' ), $poG = $poRows.children( '.bb-po-grouprow' ).first();
						if ( $poG.length ) { $poG.before( row ); } else { $poRows.append( row ); }
						var bbSegs2 = window.addonBossBuildSegs || window.bundleBossBuildSegs; // theirs, when BundleBoss's admin.js was the one loaded
						if ( bbSegs2 ) {
							bbSegs2( row );
						}
						next++;
						return true;
					}
					$( '#bb-po-attach' ).on( 'change', function () {
						var sel = $( this ), val = sel.val();
						if ( ! val ) {
							return;
						}
						var $opt = sel.find( 'option:selected' );
						// "+ New set…": the set editor in a new tab, for this product;
						// the set comes back attached when this tab is looked at again
						// (bbMenuAgain, "Just made").
						if ( 'bbnew:' === val ) {
							sel.val( '' ).trigger( 'change.select2' );
							window.open( <?php echo wp_json_encode( admin_url( 'admin.php?page=addon-boss-option-sets&set=new&for_product=' ) ); ?> + bbPoIdNow(), '_blank', 'noopener' );
							return;
						}
						// A list a set on the tab brings along already (a glass's
						// edge finish): said, never a second row (walk 6).
						var through = bbIncludedThrough( val );
						if ( through ) {
							var $say = $( '.bb-po-attachsay' );
							$say.text( <?php echo wp_json_encode( /* translators: %s: the set that already brings this list, like Shutter size */ __( 'Already included through %s', 'addon-boss' ) ); ?>.replace( '%s', through ) ).prop( 'hidden', false );
							window.clearTimeout( $say.data( 'bbT' ) );
							$say.data( 'bbT', window.setTimeout( function () { $say.prop( 'hidden', true ); }, 4000 ) );
							sel.val( '' ).trigger( 'change.select2' );
							return;
						}
						if ( val.indexOf( 'bbfolder:' ) === 0 ) {
							// The whole folder. Its members ride on the option, so the
							// order they were arranged in is the order they arrive in,
							// and anything already on the product is left alone.
							var folder = val.slice( 9 );
							var ids = ( $opt.attr( 'data-bb-folder' ) || '' ).split( ',' );
							var names = window.addonBossSetNames || {};
							$.each( ids, function ( i, id ) {
								id = $.trim( id );
								if ( id ) { bbAttachSet( id, names[ id ] || id, folder ); }
							} );
						} else {
							bbAttachSet( val, $opt.text(), $opt.closest( 'optgroup' ).attr( 'label' ) || '' );
						}
						sel.val( '' ).trigger( 'change.select2' );
						bbNoPriceAgain();
					} );
					// The advice over a product with no price follows the sets on the
					// tab, not the last save: a measured size attached said "Set its
					// price on the General tab" until Update (walk 5, 30 Oct 2026).
					var bbPoNonce = <?php echo wp_json_encode( wp_create_nonce( 'addon_boss_noprice_advice' ) ); ?>;
					var bbPoId    = parseInt( $( '#post_ID' ).val(), 10 ) || 0;
					function bbNoPriceAgain() {
						var $np = $( '.bb-po-noprice:not(.is-done)' );
						if ( ! $np.length || ! bbPoId || ! window.ajaxurl ) { return; }
						var rows = [];
						$( '#bb-product-option-rows' ).find( 'input[name^="bb_po_set"]' ).each( function () {
							var $r = $( this ).closest( '.bb-po-row' );
							if ( this.value ) { rows.push( { set: this.value, required: '1' === String( $r.find( 'select.bb-po-req' ).first().val() || '' ) ? 1 : '' } ); }
						} );
						$.post( window.ajaxurl, { action: 'addon_boss_noprice_advice', _wpnonce: bbPoNonce, product: bbPoId, rows: rows } ).done( function ( res ) {
							if ( res && res.success && res.data ) { $np.html( res.data.html ); }
						} );
					}
					$( '#bb-product-option-rows' ).on( 'change', 'select.bb-po-req', bbNoPriceAgain );
					$( document ).on( 'click', '.bb-po-remove', function () { window.setTimeout( bbNoPriceAgain, 0 ); } );
					// A set made in another tab joins the attach menu when this tab is
					// looked at again, at the top, newest first; one made from this
					// product's own link (the Size field's "Measured size") comes back
					// attached. It was missing until a reload, and reloading a product
					// not yet saved loses it (walk 5, 30 Oct 2026).
					var bbMenuAsked = 0;
					function bbMenuAgain() {
						if ( document.hidden || ! bbPoId || ! window.ajaxurl || Date.now() - bbMenuAsked < 2000 ) { return; }
						bbMenuAsked = Date.now();
						$.post( window.ajaxurl, { action: 'addon_boss_attach_menu', _wpnonce: bbPoNonce, product: bbPoId } ).done( function ( res ) {
							if ( ! res || ! res.success || ! res.data ) { return; }
							var $sel = $( '#bb-po-attach' ), names = window.addonBossSetNames = window.addonBossSetNames || {};
							var known = {}, fresh = [];
							$sel.find( 'option' ).each( function () { known[ this.value ] = true; } );
							$.each( res.data.groups || [], function ( gi, grp ) {
								$.each( grp.sets || [], function ( si, s ) {
									names[ s[ 0 ] ] = s[ 1 ];
									if ( ! known[ s[ 0 ] ] ) { fresh.push( s ); }
								} );
							} );
							if ( fresh.length && $sel.length ) {
								// Stored in the order made, the newest last: each goes on top.
								var $top = $sel.find( 'optgroup.bb-po-newsets' );
								if ( ! $top.length ) {
									$top = $( '<optgroup class="bb-po-newsets"></optgroup>' ).attr( 'label', <?php echo wp_json_encode( __( 'Just made', 'addon-boss' ) ); ?> );
									$sel.find( 'option' ).first().after( $top );
								}
								$.each( fresh, function ( fi, s ) { $( '<option></option>' ).val( s[ 0 ] ).text( s[ 1 ] ).prependTo( $top ); } );
								$sel.trigger( 'change.select2' );
							}
							var took = false;
							$.each( res.data.made || [], function ( mi, id ) {
								if ( bbAttachSet( id, names[ id ] || id, '' ) ) {
									took = true;
									var $row = $( '#bb-product-option-rows' ).find( 'input[name^="bb_po_set"]' ).filter( function () { return this.value === id; } ).closest( '.bb-po-row' );
									$row.addClass( 'bb-po-already' );
									window.setTimeout( function () { $row.removeClass( 'bb-po-already' ); }, 2400 );
								}
							} );
							if ( took ) { bbNoPriceAgain(); }
						} );
					}
					document.addEventListener( 'visibilitychange', bbMenuAgain );
					window.addEventListener( 'focus', bbMenuAgain );
					$( document ).on( 'click', '.bb-po-remove', function () {
						var $row = $( this ).closest( '.bb-po-row' );
						if ( ! $row.hasClass( 'bb-po-grouprow' ) ) { $row.remove(); return; }
						var $items = $row.children( '.bb-po-grouplist' ).children( '.bb-po-row' );
						if ( ! $items.length ) { $row.remove(); return; } // an empty group just goes.
						bbGroupDelete( $row, $items.length ); // non-empty: ask before losing work.
					} );
					var bbGL = {
						sub: <?php echo wp_json_encode( __( 'What should happen to the items inside?', 'addon-boss' ) ); ?>,
						keep: <?php echo wp_json_encode( __( 'Keep the items, remove the group only', 'addon-boss' ) ); ?>,
						del: <?php echo wp_json_encode( __( 'Delete the group and its items', 'addon-boss' ) ); ?>,
						cancel: <?php echo wp_json_encode( __( 'Cancel', 'addon-boss' ) ); ?>,
						group: <?php echo wp_json_encode( __( 'This group', 'addon-boss' ) ); ?>
					};
					function bbGroupDelete( $group, n ) {
						var name = $.trim( $group.find( '.bb-po-grouplabel' ).val() || '' ) || bbGL.group;
						var $ov = $( '<div class="bb-po-modal-ov"></div>' );
						var $m = $( '<div class="bb-po-modal" role="dialog" aria-modal="true"></div>' ).appendTo( $ov );
						$( '<p class="bb-po-modal-msg"></p>' ).text( '“' + name + '”' ).appendTo( $m );
						$( '<p class="bb-po-modal-sub"></p>' ).text( bbGL.sub ).appendTo( $m );
						var $a = $( '<div class="bb-po-modal-acts"></div>' ).appendTo( $m );
						var $keep = $( '<button type="button" class="button bb-cta bb-po-modal-keep"></button>' ).text( bbGL.keep ).appendTo( $a );
						$( '<button type="button" class="button bb-po-modal-del"></button>' ).text( bbGL.del ).appendTo( $a );
						$( '<button type="button" class="button bb-po-modal-cancel"></button>' ).text( bbGL.cancel ).appendTo( $a );
						function close() { $ov.remove(); $( document ).off( 'keydown.bbgd' ); }
						$a.on( 'click', '.bb-po-modal-keep', function () {
							$group.after( $group.children( '.bb-po-grouplist' ).children( '.bb-po-row' ) ); // extract to top level
							$group.remove();
							if ( $.fn.sortable ) { $( '#bb-product-option-rows' ).sortable( 'refresh' ); }
							close();
						} );
						$a.on( 'click', '.bb-po-modal-del', function () { $group.remove(); close(); } );
						$a.on( 'click', '.bb-po-modal-cancel', close );
						$ov.on( 'click', function ( e ) { if ( e.target === $ov[0] ) { close(); } } );
						$( document ).on( 'keydown.bbgd', function ( e ) { if ( e.key === 'Escape' ) { close(); } } );
						$( 'body' ).append( $ov );
						$keep.trigger( 'focus' );
					}

				} );
				<?php } finally { addon_boss_inline_js( ob_get_clean() ); } ?>
		</div>
		<?php
		// The variation rebuild offer renders last: the tab leads with what is
		// already attached and working on top of the variations; the way out is
		// the card below it, never the room itself.
		do_action( 'addon_boss_options_panel_after', $product );
		?>
	</div>
	<?php
}

// =================================================================
// ADMIN (cont.): option-image suggest AJAX, the product-options save handler,
// and the product-options tab chrome (icon CSS + chip expander). Lifted from
// slot-options at the split.
// =================================================================


/**
 * Save the panel via Woo's product-object hook (Woo persists once, after).
 *
 * The nonce is verified here rather than relied upon. WooCommerce checks this
 * same nonce in its product-data metabox before it fires the hook we are on, so
 * nothing that reaches this function could have skipped it, which makes the
 * check below free in production. What it buys is that the verification is
 * visible IN the function that reads the request, instead of being an assertion
 * about a caller. Every superglobal read after it is provably behind a verified
 * nonce.
 */
function addon_boss_product_options_save( $product ): void {
	if ( ! isset( $_POST['woocommerce_meta_nonce'] )
		|| ! wp_verify_nonce( sanitize_key( wp_unslash( $_POST['woocommerce_meta_nonce'] ) ), 'woocommerce_save_data' ) ) {
		return;
	}
	// The last clause runs the one-time artwork-box migration on any product
	// still carrying the retired upload config.
	if ( ! $product instanceof WC_Product || ( ! isset( $_POST['bb_po_set'] ) && ! isset( $_POST['bb_pf'] ) && ! isset( $_POST['bb_po_group_label'] ) && ! isset( $_POST['bb_po_upload_mode'] ) && ! $product->get_meta( ADDON_BOSS_STANDALONE_UPLOAD_META ) ) ) {
		return;
	}
	// Every panel input is read ONCE, unslashed and sanitised here at the
	// boundary, into plain locals the builders below close over. Flat scalar
	// arrays (ids, labels, keys, rule values) take sanitize_text_field per
	// leaf; attachment ids take absint; the field definitions take
	// wp_kses_post per leaf, because an info block's content is legitimate
	// markup that a text sanitiser would destroy. The structured sanitisers
	// further down then enforce shape, types and money on the result, exactly
	// as before; nothing below this block touches the request again.
	$raw          = array();
	$set_rows     = isset( $_POST['bb_po_set'] ) ? array_map( 'sanitize_text_field', wp_unslash( (array) $_POST['bb_po_set'] ) ) : array();
	$field_rows   = isset( $_POST['bb_pf'] ) ? map_deep( wp_unslash( (array) $_POST['bb_pf'] ), 'wp_kses_post' ) : array();
	$group_lbls   = isset( $_POST['bb_po_group_label'] ) ? array_map( 'sanitize_text_field', wp_unslash( (array) $_POST['bb_po_group_label'] ) ) : array();
	$group_rpt    = isset( $_POST['bb_po_group_repeat'] ) ? array_map( 'sanitize_text_field', wp_unslash( (array) $_POST['bb_po_group_repeat'] ) ) : array();
	$group_rmax   = isset( $_POST['bb_po_group_repeat_max'] ) ? array_map( 'absint', wp_unslash( (array) $_POST['bb_po_group_repeat_max'] ) ) : array();
	$group_rlbl   = isset( $_POST['bb_po_group_repeat_label'] ) ? array_map( 'sanitize_text_field', wp_unslash( (array) $_POST['bb_po_group_repeat_label'] ) ) : array();
	$group_min    = isset( $_POST['bb_po_group_min'] ) ? array_map( 'absint', wp_unslash( (array) $_POST['bb_po_group_min'] ) ) : array();
	$group_minmsg = isset( $_POST['bb_po_group_min_msg'] ) ? array_map( 'sanitize_text_field', wp_unslash( (array) $_POST['bb_po_group_min_msg'] ) ) : array();
	$set_required = isset( $_POST['bb_po_required'] ) ? array_map( 'absint', wp_unslash( (array) $_POST['bb_po_required'] ) ) : array();
	$set_deltas   = isset( $_POST['bb_po_delta'] ) ? map_deep( wp_unslash( (array) $_POST['bb_po_delta'] ), 'sanitize_text_field' ) : array();
	$set_images   = isset( $_POST['bb_po_image'] ) ? map_deep( wp_unslash( (array) $_POST['bb_po_image'] ), 'absint' ) : array();
	// A measured set's rate for THIS product, one per row; empty means the
	// set's own rate. The row sanitiser owns the number rules.
	$set_rate     = isset( $_POST['bb_po_rate'] ) ? array_map( 'sanitize_text_field', wp_unslash( (array) $_POST['bb_po_rate'] ) ) : array();
	// Which choices this product refuses: set index => option key => 1. Absent
	// means nothing refused, which is what a form from any older build (or one
	// saved before this control existed) posts, so a save can never invent a
	// restriction the merchant did not ask for.
	$set_hide     = isset( $_POST['bb_po_hide'] ) ? map_deep( wp_unslash( (array) $_POST['bb_po_hide'] ), 'absint' ) : array();
	$set_fromgrp  = isset( $_POST['bb_po_fromgroup'] ) ? array_map( 'sanitize_text_field', wp_unslash( (array) $_POST['bb_po_fromgroup'] ) ) : array();
	$set_when_set = isset( $_POST['bb_po_when_set'] ) ? array_map( 'sanitize_text_field', wp_unslash( (array) $_POST['bb_po_when_set'] ) ) : array();
	$set_when_is  = isset( $_POST['bb_po_when_is'] ) ? array_map( 'sanitize_text_field', wp_unslash( (array) $_POST['bb_po_when_is'] ) ) : array();
	// The builder posts a whole rule as ONE json field per row; the shape
	// mapper is its sanitiser (whitelisted operators, bounded lists, every
	// string through sanitize_text_field). The scattered per-condition names
	// below stay readable for older forms and hidden carriers.
	// phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized -- decoded and sanitised leaf by leaf in addon_boss_when_to_groups().
	$set_when_json = isset( $_POST['bb_po_when_json'] ) ? wp_unslash( (array) $_POST['bb_po_when_json'] ) : array();
	// phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized -- decoded and sanitised leaf by leaf in addon_boss_when_to_groups().
	$pf_when_json  = isset( $_POST['bb_pf_when_json'] ) ? wp_unslash( (array) $_POST['bb_pf_when_json'] ) : array();
	// One posted json rule, read to the storage shape, or null when the row
	// posted none (an older form): the caller then falls back to the scattered
	// names. An unreadable json is an EMPTY rule rather than a fallback,
	// because the builder always posts it; half of it surviving as a stale
	// scattered-field rule would resurrect what the merchant just deleted.
	$bb_when_from_json = static function ( $i, array $bag ) {
		if ( ! isset( $bag[ $i ] ) || ! is_string( $bag[ $i ] ) ) {
			return null;
		}
		$bb_decoded = json_decode( (string) $bag[ $i ], true );
		return addon_boss_when_store_shape( addon_boss_when_to_groups( is_array( $bb_decoded ) ? $bb_decoded : array() ) );
	};
	$pf_when_set  = isset( $_POST['bb_pf_when_set'] ) ? array_map( 'sanitize_text_field', wp_unslash( (array) $_POST['bb_pf_when_set'] ) ) : array();
	$pf_when_is   = isset( $_POST['bb_pf_when_is'] ) ? array_map( 'sanitize_text_field', wp_unslash( (array) $_POST['bb_pf_when_is'] ) ) : array();
	$pf_when_op   = isset( $_POST['bb_pf_when_op'] ) ? array_map( 'sanitize_text_field', wp_unslash( (array) $_POST['bb_pf_when_op'] ) ) : array();
	$pf_when_more = isset( $_POST['bb_pf_when_more'] ) ? map_deep( wp_unslash( (array) $_POST['bb_pf_when_more'] ), 'sanitize_text_field' ) : array();
	$pf_when_match = isset( $_POST['bb_pf_when_match'] ) ? array_map( 'sanitize_text_field', wp_unslash( (array) $_POST['bb_pf_when_match'] ) ) : array();
	// Show or hide. Absent is show, which is what every form built before this
	// posts and what every rule already stored means.
	$pf_when_act   = isset( $_POST['bb_pf_when_act'] ) ? array_map( 'sanitize_text_field', wp_unslash( (array) $_POST['bb_pf_when_act'] ) ) : array();
	// The merchant's arrangement rides bb_po_order[]: one key per row in DOM
	// order, with group-<i> / gend-<i> markers bounding each group's children,
	// so the exact nesting is stored (a group is a real container). An older
	// form with no order keys falls back to the flat numeric index.
	$order     = isset( $_POST['bb_po_order'] ) ? array_map( 'sanitize_text_field', wp_unslash( (array) $_POST['bb_po_order'] ) ) : array();
	$cur_group = null; // index into $raw of the currently open group, or null.
	$build_set = static function ( $i ) use ( $set_rows, $set_required, $set_deltas, $set_images, $set_hide, $set_rate, $set_fromgrp, $set_when_set, $set_when_is, $set_when_json, $bb_when_from_json ) {
		$bb_when = $bb_when_from_json( $i, $set_when_json );
		if ( null === $bb_when ) {
			$bb_when = array(
				'set' => (string) ( $set_when_set[ $i ] ?? '' ),
				'is'  => (string) ( $set_when_is[ $i ] ?? '' ),
			);
		}
		// Modules read their own per-row fields off the same form by index, so
		// a row never posts a control nothing collects.
		return (array) apply_filters( 'addon_boss_collect_set_row', array(
			'set'        => (string) $set_rows[ $i ],
			'required'   => ! empty( $set_required[ $i ] ),
			'deltas'     => (array) ( $set_deltas[ $i ] ?? array() ),
			'images'     => (array) ( $set_images[ $i ] ?? array() ),
			'hide'       => (array) ( $set_hide[ $i ] ?? array() ),
			'rate'       => (string) ( $set_rate[ $i ] ?? '' ),
			'from_group' => (string) ( $set_fromgrp[ $i ] ?? '' ),
			'when'       => $bb_when,
		), (int) $i );
	};
	$build_field = static function ( $i ) use ( $field_rows, $pf_when_set, $pf_when_is, $pf_when_op, $pf_when_more, $pf_when_match, $pf_when_act, $pf_when_json, $bb_when_from_json ) {
		// The builder's whole rule rides one json field when present.
		$bb_json_when = $bb_when_from_json( $i, $pf_when_json );
		if ( null !== $bb_json_when ) {
			return array(
				'row_type' => 'field',
				'field'    => (array) $field_rows[ $i ],
				'when'     => $bb_json_when,
			);
		}
		// The first condition still posts in the original two fields, so an older
		// form (or a browser with the extras stripped) saves exactly as it did.
		// Any further conditions ride bb_pf_when_more, and the whole lot is handed
		// to the canonical normaliser.
		$first_set = (string) ( $pf_when_set[ $i ] ?? '' );
		$first_is  = (string) ( $pf_when_is[ $i ] ?? '' );
		$first_op  = in_array( (string) ( $pf_when_op[ $i ] ?? '' ), array( 'is', 'is_not', 'filled', 'empty' ), true ) ? (string) $pf_when_op[ $i ] : 'is';
		// The trigger dropdown carries sets and fields in one list; a field's
		// entry wears the prefix, so one control posts either kind.
		$bb_cond = static function ( string $trigger, string $op, string $value ): array {
			$bb_field = 0 === strpos( $trigger, ADDON_BOSS_FIELD_RULE_KEY )
				? substr( $trigger, strlen( ADDON_BOSS_FIELD_RULE_KEY ) )
				: '';
			return array(
				'set'   => '' === $bb_field ? $trigger : '',
				'field' => $bb_field,
				'op'    => in_array( $op, array( 'is', 'is_not', 'filled', 'empty' ), true ) ? $op : 'is',
				'value' => $value,
			);
		};

		$conds = array();
		if ( '' !== $first_set ) {
			$conds[] = $bb_cond( $first_set, $first_op, $first_is );
		}
		foreach ( (array) ( $pf_when_more[ $i ] ?? array() ) as $extra ) {
			if ( ! is_array( $extra ) ) {
				continue;
			}
			$set = (string) ( $extra['set'] ?? '' );
			if ( '' === $set ) {
				continue; // a half-finished row is dropped rather than saved broken
			}
			$conds[] = $bb_cond( $set, (string) ( $extra['op'] ?? '' ), (string) ( $extra['value'] ?? '' ) );
		}
		$bb_act = ( 'hide' === (string) ( $pf_when_act[ $i ] ?? '' ) ) ? 'hide' : 'show';
		// One plain SHOW condition on a set stores in the legacy shape, so
		// nothing about an ordinary single-rule field changes on disk.
		if ( 1 === count( $conds ) && 'is' === $conds[0]['op'] && '' === $conds[0]['field'] && 'show' === $bb_act ) {
			$when = array( 'set' => $conds[0]['set'], 'is' => $conds[0]['value'] );
		} elseif ( $conds ) {
			$when = array(
				'match'      => ( 'any' === (string) ( $pf_when_match[ $i ] ?? 'all' ) ) ? 'any' : 'all',
				'conditions' => $conds,
			);
			if ( 'hide' === $bb_act ) {
				$when = array( 'act' => 'hide' ) + $when;
			}
		} else {
			$when = array();
		}

		return array(
			'row_type' => 'field',
			'field'    => (array) $field_rows[ $i ],
			'when'     => $when,
		);
	};
	if ( $order ) {
		foreach ( $order as $okey ) {
			$okey = sanitize_text_field( (string) $okey );
			if ( 0 === strpos( $okey, 'gend-' ) ) {
				$cur_group = null; // close the current group container.
				continue;
			}
			if ( 0 === strpos( $okey, 'group-' ) && isset( $group_lbls[ substr( $okey, 6 ) ] ) ) {
				$gi        = substr( $okey, 6 );
				$raw[]     = array(
					'row_type'     => 'group',
					'label'        => sanitize_text_field( (string) ( $group_lbls[ $gi ] ?? '' ) ),
					'children'     => array(),
					// The group's repeat panel (or its hidden carriers); the
					// structured sanitiser whitelists and bounds these below.
					'repeat'       => (string) ( $group_rpt[ $gi ] ?? '' ),
					'repeat_max'   => (int) ( $group_rmax[ $gi ] ?? 0 ),
					'repeat_label' => (string) ( $group_rlbl[ $gi ] ?? '' ),
					'min_pick'     => (int) ( $group_min[ $gi ] ?? 0 ),
					'min_msg'      => (string) ( $group_minmsg[ $gi ] ?? '' ),
				);
				$cur_group = count( $raw ) - 1;
				continue;
			}
			$rowdata = null;
			if ( 0 === strpos( $okey, 'set-' ) && isset( $set_rows[ substr( $okey, 4 ) ] ) ) {
				$rowdata = $build_set( substr( $okey, 4 ) );
			} elseif ( 0 === strpos( $okey, 'field-' ) && isset( $field_rows[ substr( $okey, 6 ) ] ) ) {
				$rowdata = $build_field( substr( $okey, 6 ) );
			}
			if ( null === $rowdata ) {
				continue;
			}
			if ( null !== $cur_group ) {
				$raw[ $cur_group ]['children'][] = $rowdata; // a child of the open group.
			} else {
				$raw[] = $rowdata; // top-level, ungrouped.
			}
		}
	} else {
		// No order keys (an old cached form): flat numeric index, no groups.
		$indices = array_keys( $set_rows + $field_rows );
		sort( $indices, SORT_NUMERIC );
		foreach ( $indices as $i ) {
			$raw[] = isset( $set_rows[ $i ] ) ? $build_set( $i ) : $build_field( $i );
		}
	}
	// Fold a retired artwork box into a file field, once. The dedicated box is
	// gone from the admin; a product that still carries the old upload config
	// keeps working via back-compat read until it is next saved, when the
	// config converts to a file-field row and the old meta is dropped. This is
	// non-destructive: no bulk rewrite runs, only this per-product pass, and
	// the file field carries the same label, required-ness, template link and
	// reveal rule the box had.
	$bb_old_upload = $product->get_meta( ADDON_BOSS_STANDALONE_UPLOAD_META );
	if ( is_array( $bb_old_upload ) && '' !== (string) ( $bb_old_upload['mode'] ?? '' ) ) {
		$raw[] = array(
			'row_type' => 'field',
			'field'    => array(
				'type'      => 'file',
				'label'     => '' !== (string) ( $bb_old_upload['label'] ?? '' ) ? (string) $bb_old_upload['label'] : __( 'Your artwork', 'addon-boss' ),
				'require'   => 'required' === ( $bb_old_upload['mode'] ?? '' ) ? 'always' : '',
				'template'  => (string) ( $bb_old_upload['template'] ?? '' ),
				'filetypes' => (string) ( $bb_old_upload['filetypes'] ?? '' ),
			),
			'when'     => is_array( $bb_old_upload['when'] ?? null ) ? $bb_old_upload['when'] : array(),
		);
		$product->delete_meta_data( ADDON_BOSS_STANDALONE_UPLOAD_META );
	}
	// How the groups are arranged on the page. Read only when the control was
	// actually on the screen that posted, so a surface without the picker can
	// never blank a choice made somewhere that has it.
	if ( isset( $_POST['bb_options_layout'] ) ) {
		addon_boss_save_options_layout( $product, sanitize_key( wp_unslash( $_POST['bb_options_layout'] ) ) );
		// The two switches ride the same control block, so an unticked box is
		// an absent key and that is the OFF state. Reading them only when the
		// layout posted means a screen without the block can never blank them.
		$bb_sw_num = isset( $_POST['bb_options_numbered'] ) ? sanitize_key( wp_unslash( $_POST['bb_options_numbered'] ) ) : '';
		$bb_sw_rev = isset( $_POST['bb_options_review'] ) ? sanitize_key( wp_unslash( $_POST['bb_options_review'] ) ) : '';
		addon_boss_save_options_switch( $product, 'numbered', 'yes' === $bb_sw_num );
		addon_boss_save_options_switch( $product, 'review', 'yes' === $bb_sw_rev );
		$bb_sw_pho = isset( $_POST['bb_options_photoview'] ) ? sanitize_key( wp_unslash( $_POST['bb_options_photoview'] ) ) : '';
		addon_boss_save_options_switch( $product, 'photoview', 'yes' === $bb_sw_pho );
		// The opening state rides the same block. An absent key is the default,
		// and the default is the one that hides nothing.
		addon_boss_save_options_open_state(
			$product,
			isset( $_POST['bb_options_openstate'] ) ? sanitize_key( wp_unslash( $_POST['bb_options_openstate'] ) ) : 'all'
		);
		// The setups ride the same block, so a screen that never drew the editor
		// cannot blank a merchant's work by posting without it. Every field is
		// cleaned inside the writer rather than here, so the one boundary is the
		// one place to read when asking what a stored setup can contain.
		$bb_setups_in = isset( $_POST['bb_setups'] ) ? wp_unslash( $_POST['bb_setups'] ) : array(); // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized -- every leaf is sanitised in the writer.
		addon_boss_save_options_setups( $product, is_array( $bb_setups_in ) ? $bb_setups_in : array() );
	}
	$clean = addon_boss_sanitize_product_option_config( $raw );
	if ( $clean ) {
		$product->update_meta_data( ADDON_BOSS_PRODUCT_OPTIONS_META, $clean );
	} else {
		$product->delete_meta_data( ADDON_BOSS_PRODUCT_OPTIONS_META );
	}
}

// The product-tab icon rule used to live here. It was dead: it was guarded on
// function_exists( 'addon_boss_menu_icon' ), and no such function exists in this
// plugin or in BundleBoss, so the whole thing returned at the first line and had
// never once run. What it left behind was a phpcs:ignore sitting on an echo into
// a CSS url(), a context where neither esc_attr nor esc_url is the right
// escaper, waiting for someone to define that name and make it live.
//
// Deleted rather than repointed. The coral square in admin.css was always doing
// this job; nothing on screen changes.

add_action( 'admin_footer', 'addon_boss_option_chip_expander_js' );

function addon_boss_option_chip_expander_js(): void {
	$screen = function_exists( 'get_current_screen' ) ? get_current_screen() : null;
	if ( ! $screen ) {
		return;
	}
	$is_ours = 'product' === $screen->id
		|| false !== strpos( (string) $screen->id, 'addon-boss-option-sets' );
	if ( ! $is_ours ) {
		return;
	}
	?>
	<?php ob_start(); try { ?>
	jQuery( function ( $ ) {
		$( document ).on( 'click', 'button.bb-opt-more', function () {
			var b = $( this ), row = b.closest( '.bb-chiprow' );
			var open = row.toggleClass( 'is-expanded' ).hasClass( 'is-expanded' );
			b.attr( 'aria-expanded', open ? 'true' : 'false' )
				.text( open ? b.data( 'lessLabel' ) : b.data( 'moreLabel' ) );
		} );
	} );
	<?php } finally { addon_boss_inline_js( ob_get_clean() ); } ?>
	<?php
}

// -----------------------------------------------------------------
// GDPR: export and erase what a shopper typed.
//
// This plugin has custom fields, so it stores names to engrave and messages to
// print. That is personal data by any reading, and readme.txt tells people that
// a data request returns it and an erase request deletes it, so the handlers
// belong here, in the plugin proper, next to the code that wrote the data.
//
// The one call that touches a file on disk is guarded on the upload module,
// since only a build with uploads has a file to find. Nothing else here needs
// anything beyond the order metas it walks.
//
// The metas keep their historical `_bundle_boss_*` key names on purpose, so
// orders taken before the plugins split stay covered.
// -----------------------------------------------------------------

/**
 * Delete a stored upload if this build has the module that can resolve one.
 *
 * A multi-file field stores its references comma joined in a single string, so
 * split before resolving. Passing the joined string straight through resolves
 * to nothing, which silently left every file of a multi-file field on disk
 * after a valid erasure request. The gathering side has always split; this side
 * did not.
 */
function addon_boss_privacy_forget_upload( string $ref ): void {
	if ( '' === $ref || ! function_exists( 'addon_boss_standalone_delete_upload_file' ) ) {
		return;
	}
	foreach ( explode( ',', $ref ) as $one ) {
		$one = trim( $one );
		if ( '' !== $one ) {
			addon_boss_standalone_delete_upload_file( $one );
		}
	}
}

add_filter( 'wp_privacy_personal_data_exporters', 'addon_boss_standalone_register_exporter' );

function addon_boss_standalone_register_exporter( $exporters ) {
	$exporters['addon-boss-standalone'] = array(
		'exporter_friendly_name' => __( 'Product options and personalisation', 'addon-boss' ),
		'callback'               => 'addon_boss_standalone_exporter',
	);
	return $exporters;
}

function addon_boss_standalone_exporter( $email, $page = 1 ) {
	$orders = wc_get_orders(
		array(
			'billing_email' => $email,
			'limit'         => 20,
			'paged'         => max( 1, (int) $page ),
			'type'          => 'shop_order',
			'orderby'       => 'ID',
			'order'         => 'ASC',
		)
	);
	$export = array();
	foreach ( (array) $orders as $order ) {
		foreach ( $order->get_items() as $item ) {
			$rows = addon_boss_standalone_privacy_rows( $item );
			if ( $rows ) {
				$export[] = array(
					'group_id'    => 'addon-boss-standalone',
					'group_label' => __( 'Product options and personalisation', 'addon-boss' ),
					'item_id'     => 'order-' . $order->get_id(),
					'data'        => $rows,
				);
			}
		}
	}
	return array(
		'data' => $export,
		'done' => count( (array) $orders ) < 20,
	);
}

/**
 * Flatten one order line's personal data (entered fields, option picks, and on
 * a build with the upload module, the upload and chosen areas) into WordPress exporter rows.
 */
function addon_boss_standalone_privacy_rows( $item ): array {
	$rows = array();

	$up = $item->get_meta( ADDON_BOSS_STANDALONE_UPLOAD_META );
	if ( is_array( $up ) && '' !== (string) ( $up['name'] ?? '' ) ) {
		$value = (string) $up['name'];
		if ( ! empty( $up['url'] ) ) {
			$value .= ' (' . $up['url'] . ')';
		}
		$rows[] = array(
			'name'  => '' !== (string) ( $up['label'] ?? '' ) ? (string) $up['label'] : __( 'Your file', 'addon-boss' ),
			'value' => $value,
		);
	}

	foreach ( (array) $item->get_meta( ADDON_BOSS_PRODUCT_FIELDS_META ) as $f ) {
		$disp = (string) ( $f['display'] ?? '' );
		if ( '' === $disp ) {
			continue;
		}
		if ( ! empty( $f['url'] ) ) {
			$disp .= ' (' . $f['url'] . ')';
		}
		$rows[] = array(
			'name'  => '' !== (string) ( $f['label'] ?? '' ) ? (string) $f['label'] : __( 'Detail', 'addon-boss' ),
			'value' => $disp,
		);
	}

	foreach ( (array) $item->get_meta( '_bundle_boss_standalone_options' ) as $s ) {
		$label = (string) ( $s['label'] ?? '' );
		if ( '' === $label ) {
			continue;
		}
		$rows[] = array(
			'name'  => '' !== (string) ( $s['set_name'] ?? '' ) ? (string) $s['set_name'] : __( 'Option', 'addon-boss' ),
			'value' => $label,
		);
	}

	// Chosen areas. A shopper's own logo and the words they asked to have
	// printed are as personal as anything above, and were being left out of
	// both the export and the erasure.
	foreach ( (array) $item->get_meta( '_bundle_boss_positions' ) as $pos ) {
		$parts = array();
		if ( '' !== (string) ( $pos['text'] ?? '' ) ) {
			$parts[] = (string) $pos['text'];
		}
		if ( '' !== (string) ( $pos['file_name'] ?? '' ) ) {
			$file = (string) $pos['file_name'];
			if ( ! empty( $pos['file_url'] ) ) {
				$file .= ' (' . $pos['file_url'] . ')';
			}
			$parts[] = $file;
		}
		if ( ! $parts ) {
			continue;
		}
		$rows[] = array(
			'name'  => '' !== (string) ( $pos['name'] ?? '' ) ? (string) $pos['name'] : __( 'Print area', 'addon-boss' ),
			'value' => implode( ', ', $parts ),
		);
	}

	return $rows;
}

add_filter( 'wp_privacy_personal_data_erasers', 'addon_boss_standalone_register_eraser' );

function addon_boss_standalone_register_eraser( $erasers ) {
	$erasers['addon-boss-standalone'] = array(
		'eraser_friendly_name' => __( 'Product options and personalisation', 'addon-boss' ),
		'callback'             => 'addon_boss_standalone_eraser',
	);
	return $erasers;
}

function addon_boss_standalone_eraser( $email, $page = 1 ) {
	$orders  = wc_get_orders(
		array(
			'billing_email' => $email,
			'limit'         => 20,
			'paged'         => max( 1, (int) $page ),
			'type'          => 'shop_order',
			'orderby'       => 'ID',
			'order'         => 'ASC',
		)
	);
	$removed = false;
	foreach ( (array) $orders as $order ) {
		foreach ( $order->get_items() as $item ) {
			$changed = false;

			// The standalone artwork upload: delete the file, drop the meta and
			// its readable row.
			$up = $item->get_meta( ADDON_BOSS_STANDALONE_UPLOAD_META );
			if ( is_array( $up ) ) {
				addon_boss_privacy_forget_upload( (string) ( $up['ref'] ?? '' ) );
				$item->delete_meta_data( ADDON_BOSS_STANDALONE_UPLOAD_META );
				if ( ! empty( $up['label'] ) ) {
					$item->delete_meta_data( (string) $up['label'] );
				}
				$changed = true;
			}

			// Product fields: entered text and any uploaded files are personal.
			// A file field stores its reference as the field value, so try both
			// keys; resolving returns nothing for a plain text value, so text
			// fields are simply skipped by the deleter and dropped below.
			$fsnaps = $item->get_meta( ADDON_BOSS_PRODUCT_FIELDS_META );
			if ( is_array( $fsnaps ) && $fsnaps ) {
				foreach ( $fsnaps as $f ) {
					foreach ( array( $f['value'] ?? '', $f['ref'] ?? '' ) as $maybe_ref ) {
						if ( '' !== (string) $maybe_ref ) {
							addon_boss_privacy_forget_upload( (string) $maybe_ref );
						}
					}
					if ( ! empty( $f['label'] ) ) {
						$item->delete_meta_data( (string) $f['label'] );
					}
				}
				$item->delete_meta_data( ADDON_BOSS_PRODUCT_FIELDS_META );
				$changed = true;
			}

			// Chosen areas: the artwork they uploaded and the words they asked to
			// have printed. Both the structured snapshot and the readable row the
			// order screen shows have to go, or an erasure leaves the personal
			// data sitting in plain sight on the order.
			$psnaps = $item->get_meta( '_bundle_boss_positions' );
			if ( is_array( $psnaps ) && $psnaps ) {
				foreach ( $psnaps as $pos ) {
					if ( '' !== (string) ( $pos['file'] ?? '' ) ) {
						addon_boss_privacy_forget_upload( (string) $pos['file'] );
					}
					if ( ! empty( $pos['name'] ) ) {
						$item->delete_meta_data( (string) $pos['name'] );
					}
				}
				$item->delete_meta_data( '_bundle_boss_positions' );
				$changed = true;
			}

			if ( $changed ) {
				$item->save();
				$removed = true;
			}
		}

		// The per-order copy folder. Deleting the originals above does not touch
		// it, because it holds COPIES, and the orphan sweep skips it on purpose.
		// Without this an honoured erasure left a complete second copy of the
		// customer's artwork on disk. Only a build with the uploads module has
		// such a folder, so the call is guarded like the file deleter above.
		if ( function_exists( 'addon_boss_standalone_forget_order_folder' ) ) {
			addon_boss_standalone_forget_order_folder( (int) $order->get_id() );
		}
	}
	return array(
		'items_removed'  => $removed,
		'items_retained' => false,
		'messages'       => array(),
		'done'           => count( (array) $orders ) < 20,
	);
}
// =================================================================
// Apply this setup to other products: a COPY, never a live link.
// The merchant perfects one product, picks the parts and a category,
// reads a review naming what happens to every product, then applies.
// Receivers end up with their own editable setup; house precedent
// (the starter shelf, the price-table gallery) is copy-not-link, so
// nothing a merchant owns ever changes behind their back.
// =================================================================

/**
 * The parts a copy can carry. Photo overrides never travel with the
 * option rows: the blue photo of this polo is not the blue photo of
 * that hoodie, so each row's images stay behind by design.
 *
 * @return array<string,string> part key => merchant-facing name.
 */
function addon_boss_copy_parts(): array {
	return array(
		// Sets and fields are TWO parts, not one. Taking a setup used to write
		// over everything the receiver had, so the fix was to let a merchant
		// take one kind and keep the other. 'positions' keeps its key, so the
		// setups already saved still resolve, and wears the name the rest of
		// the admin now uses.
		'sets'      => __( 'Option sets', 'addon-boss' ),
		'fields'    => __( 'Fields', 'addon-boss' ),
		'positions' => __( 'Print areas', 'addon-boss' ),
		'breaks'    => __( 'Quantity breaks', 'addon-boss' ),
		'layout'    => __( 'Layout', 'addon-boss' ),
	);
}

/**
 * Which part a stored row belongs to: 'sets', 'fields', or '' for a row that
 * is neither, which today means a section.
 */
function addon_boss_copy_row_part( $row ): string {
	if ( ! is_array( $row ) ) {
		return '';
	}
	if ( 'field' === ( $row['row_type'] ?? '' ) ) {
		return 'fields';
	}
	if ( isset( $row['set'] ) && '' !== $row['set'] ) {
		return 'sets';
	}
	return '';
}

/**
 * Keep only the rows belonging to the wanted parts, sections included.
 *
 * A section is a container, so it survives when any of its children do and
 * carries just those children. Lifting a field out of its heading would land
 * it loose at the end of the list under nothing, which is not the arrangement
 * it came from.
 *
 * Sections are NESTED in storage: one 'group' row holding 'children'. The flat
 * group_open / group_close pair belongs to the render sequence
 * (addon_boss_config_render_sequence) and never reaches the database.
 */
function addon_boss_copy_filter_rows( array $config, array $parts ): array {
	$out = array();
	foreach ( $config as $row ) {
		if ( ! is_array( $row ) ) {
			continue;
		}
		if ( 'group' === ( $row['row_type'] ?? '' ) ) {
			$kids = addon_boss_copy_filter_rows( (array) ( $row['children'] ?? array() ), $parts );
			if ( $kids ) {
				$row['children'] = $kids;
				$out[]           = $row;
			}
			continue;
		}
		if ( in_array( addon_boss_copy_row_part( $row ), $parts, true ) ) {
			$out[] = $row;
		}
	}
	return $out;
}

/**
 * Photo overrides never travel: the blue photo of this polo is not the blue
 * photo of that hoodie. Recursive, so a section's children are stripped too.
 */
function addon_boss_copy_strip_images( array $row ): array {
	unset( $row['images'] );
	if ( isset( $row['children'] ) && is_array( $row['children'] ) ) {
		$row['children'] = array_map(
			static function ( $kid ) {
				return is_array( $kid ) ? addon_boss_copy_strip_images( $kid ) : $kid;
			},
			$row['children']
		);
	}
	return $row;
}

/**
 * The products a category offers as receivers: anything a merchant is
 * still working on counts (published, draft, pending, private), the
 * source itself never does.
 *
 * @return int[] Product ids.
 */
function addon_boss_copy_targets( int $source_id, int $term_id ): array {
	$ids = get_posts(
		array(
			'post_type'      => 'product',
			'post_status'    => array( 'publish', 'draft', 'pending', 'private' ),
			'posts_per_page' => 200,
			'fields'         => 'ids',
			'orderby'        => 'title',
			'order'          => 'ASC',
			'tax_query'      => array( // phpcs:ignore WordPress.DB.SlowDBQuery.slow_db_query_tax_query -- the one honest way to list a category.
				array(
					'taxonomy' => 'product_cat',
					'terms'    => $term_id,
				),
			),
		)
	);
	return array_values( array_filter( array_map( 'intval', $ids ), static fn( $id ) => $id !== $source_id ) );
}

/**
 * What the apply WOULD do, product by product, before anything does:
 * the review the bulk-editing pattern libraries call for and the same
 * look-it-over-first habit the SupplierBoss bulk build keeps.
 *
 * @return array<int,array{id:int,name:string,has_own:bool,will:bool}>
 */
function addon_boss_copy_outcomes( int $source_id, int $term_id, bool $replace ): array {
	$out = array();
	foreach ( addon_boss_copy_targets( $source_id, $term_id ) as $id ) {
		$target = wc_get_product( $id );
		if ( ! $target instanceof WC_Product ) {
			continue;
		}
		$has_own = (bool) addon_boss_product_option_config( $target, true );
		$out[]   = array(
			'id'      => $id,
			'name'    => $target->get_name(),
			'has_own' => $has_own,
			'will'    => $replace || ! $has_own,
		);
	}
	return $out;
}

/**
 * The copy itself. Each ticked part lands on every willing receiver as
 * the source has it - a part the source carries copies over, a part the
 * source does not carry clears, which is what "apply THIS setup" means.
 * Receivers that already have an options setup are skipped unless the
 * merchant ticked replace, and the source is never touched.
 *
 * @param int   $source_id The product being copied from.
 * @param int   $term_id   The receiving category.
 * @param array $parts     Part keys from addon_boss_copy_parts().
 * @param bool  $replace   Overwrite receivers that have their own setup.
 * @return array{applied:int,skipped:int}
 */
function addon_boss_copy_apply( int $source_id, int $term_id, array $parts, bool $replace ): array {
	$source = wc_get_product( $source_id );
	if ( ! $source instanceof WC_Product ) {
		return array( 'applied' => 0, 'skipped' => 0 );
	}
	$parts = array_values( array_intersect( array_keys( addon_boss_copy_parts() ), array_map( 'strval', $parts ) ) );

	// The source's options config with every per-row photo override
	// stripped, prepared once for all receivers.
	$config = array();
	foreach ( addon_boss_product_option_config( $source, true ) as $row ) {
		if ( is_array( $row ) ) {
			unset( $row['images'] );
			$config[] = $row;
		}
	}
	// Storage names, not module constants: a free build carries no positions
	// or breaks module, and copying their stored rows as dormant data is
	// exactly how the engine treats every setup a build cannot speak for.
	$raw_metas = addon_boss_copy_raw_metas();

	$applied = 0;
	$skipped = 0;
	foreach ( addon_boss_copy_outcomes( $source_id, $term_id, $replace ) as $row ) {
		if ( ! $row['will'] ) {
			++$skipped;
			continue;
		}
		$target = wc_get_product( $row['id'] );
		if ( ! $target instanceof WC_Product ) {
			continue;
		}
		// The same merge the single-product take uses: an unticked kind on the
		// receiver is kept, never written over. $config is the source's rows,
		// already photo-stripped above.
		$taking = array_values( array_intersect( array( 'sets', 'fields' ), $parts ) );
		if ( $taking ) {
			$keeping = array_values( array_diff( array( 'sets', 'fields' ), $taking ) );
			$merged  = addon_boss_copy_filter_rows( addon_boss_product_option_config( $target, true ), $keeping );
			foreach ( addon_boss_copy_filter_rows( $config, $taking ) as $incoming ) {
				$merged[] = $incoming;
			}
			addon_boss_save_product_option_config( $target, $merged );
			$target = wc_get_product( $row['id'] ); // the save persisted; reread so raw metas stack cleanly.
		}
		foreach ( $raw_metas as $part => $keys ) {
			if ( ! in_array( $part, $parts, true ) ) {
				continue;
			}
			foreach ( $keys as $key ) {
				$value = get_post_meta( $source_id, $key, true );
				if ( '' === $value || null === $value || array() === $value ) {
					delete_post_meta( $row['id'], $key );
				} else {
					update_post_meta( $row['id'], $key, $value );
				}
			}
		}
		++$applied;
	}
	return array( 'applied' => $applied, 'skipped' => $skipped );
}

/**
 * "Take the setup from another product" - the pull surface, Stefanos's
 * Design A (23 Aug 2026). It stands on the product BEING SET UP and
 * takes a finished product's setup; nothing here ever edits another
 * product, per the house rule. The engine above (parts, outcomes,
 * apply) is unchanged; a future Products-list bulk action would reuse
 * it from the list screen, never from inside a product.
 */

/** The stored meta keys each raw part travels by. */
function addon_boss_copy_raw_metas(): array {
	return array(
		'positions' => array(
			'_bundle_boss_position_sets',
			'_bundle_boss_position_overrides',
			'_bundle_boss_positions_label',
			'_bundle_boss_positions_entry',
		),
		'breaks'    => array( '_addon_boss_qty_discount' ),
		'layout'    => array( ADDON_BOSS_OPTIONS_LAYOUT_META ),
	);
}

/**
 * A retired artwork box, spoken as the file-field row the save path folds it
 * into. The box is gone from the admin and a product's next save converts it,
 * but that fold lives in the FORM handler, so a product nobody has re-saved
 * since the box retired still carries the old meta and nothing else. The copy
 * engine and the transfer file both read the config, where such a product's
 * upload does not appear — so without this they hand a setup over with the
 * artwork question silently missing: mode, label, template link and reveal
 * rule, all of it. Same mapping as the save-path fold, and the meta is left
 * in place: only a real save retires it.
 *
 * @param WC_Product $product The product whose meta to read.
 * @return array<string,mixed>|null The field row, or null when there is none.
 */
function addon_boss_legacy_upload_field_row( WC_Product $product ): ?array {
	$old = $product->get_meta( ADDON_BOSS_STANDALONE_UPLOAD_META );
	if ( ! is_array( $old ) || '' === (string) ( $old['mode'] ?? '' ) ) {
		return null;
	}
	return array(
		'row_type' => 'field',
		'field'    => array(
			'type'      => 'file',
			'label'     => '' !== (string) ( $old['label'] ?? '' ) ? (string) $old['label'] : __( 'Your artwork', 'addon-boss' ),
			'require'   => 'required' === ( $old['mode'] ?? '' ) ? 'always' : '',
			'template'  => (string) ( $old['template'] ?? '' ),
			'filetypes' => (string) ( $old['filetypes'] ?? '' ),
		),
		'when'     => is_array( $old['when'] ?? null ) ? $old['when'] : array(),
	);
}

/**
 * Land the source's ticked parts on ONE receiver, as the source has
 * them: photo overrides stripped, a ticked part the source lacks
 * CLEARS (taking THIS setup includes its absences), unticked parts are
 * never touched, and the source is never written. A take is explicit,
 * so it always replaces what the receiver had in the ticked parts.
 */
function addon_boss_copy_apply_one( int $source_id, int $receiver_id, array $parts ): bool {
	$source   = wc_get_product( $source_id );
	$receiver = wc_get_product( $receiver_id );
	if ( ! $source instanceof WC_Product || ! $receiver instanceof WC_Product || $source_id === $receiver_id ) {
		return false;
	}
	$parts = array_values( array_intersect( array_keys( addon_boss_copy_parts() ), array_map( 'strval', $parts ) ) );
	if ( ! $parts ) {
		return false;
	}
	// Option sets and fields share one ordered list on the product, so taking
	// one kind without the other is a MERGE, never a write-over. It used to be
	// a write-over: taking the fields off another product silently replaced
	// whatever sets the receiver had, and the loss only showed on the
	// storefront. David, 1 Sept.
	$taking = array_values( array_intersect( array( 'sets', 'fields' ), $parts ) );
	if ( $taking ) {
		$keeping = array_values( array_diff( array( 'sets', 'fields' ), $taking ) );

		// What the receiver keeps, in the order it already had.
		$config = addon_boss_copy_filter_rows(
			addon_boss_product_option_config( $receiver, true ),
			$keeping
		);

		// What arrives, in the source's order, photo overrides left behind:
		// the blue photo of this polo is not the blue photo of that hoodie.
		foreach ( addon_boss_copy_filter_rows( addon_boss_product_option_config( $source, true ), $taking ) as $row ) {
			$config[] = addon_boss_copy_strip_images( $row );
		}

		// A source not saved since the artwork box retired carries its upload
		// only as the old meta; taking the fields hands it over as the row it
		// folds into. And taking the fields includes the RECEIVER'S old box's
		// absence, or the receiver would answer the artwork question twice.
		if ( in_array( 'fields', $taking, true ) ) {
			$bb_legacy = addon_boss_legacy_upload_field_row( $source );
			if ( $bb_legacy ) {
				$config[] = addon_boss_copy_strip_images( $bb_legacy );
			}
			delete_post_meta( $receiver_id, ADDON_BOSS_STANDALONE_UPLOAD_META );
		}

		addon_boss_save_product_option_config( $receiver, $config );
	}
	foreach ( addon_boss_copy_raw_metas() as $part => $keys ) {
		if ( ! in_array( $part, $parts, true ) ) {
			continue;
		}
		foreach ( $keys as $key ) {
			$value = get_post_meta( $source_id, $key, true );
			if ( '' === $value || null === $value || array() === $value ) {
				delete_post_meta( $receiver_id, $key );
			} else {
				update_post_meta( $receiver_id, $key, $value );
			}
		}
	}
	return true;
}

/**
 * What a product's setup carries, part by part, in shop words: the
 * ticks' captions and the search rows' chips both read from this, so
 * the merchant can tell they have the right product BEFORE taking.
 *
 * @return array<int,array{key:string,label:string,have:bool,bits:string}>
 */
function addon_boss_take_summary( int $product_id ): array {
	$product = wc_get_product( $product_id );
	if ( ! $product instanceof WC_Product ) {
		return array();
	}
	$out = array();
	foreach ( addon_boss_copy_parts() as $key => $label ) {
		$have = false;
		$bits = '';
		if ( 'sets' === $key || 'fields' === $key ) {
			// Sections hold rows too, so read the flattened sequence: a set
			// living under a heading still counts as a set the product carries.
			$names = array();
			foreach ( addon_boss_config_render_sequence( addon_boss_product_option_config( $product, true ) ) as $row ) {
				if ( ! is_array( $row ) || addon_boss_copy_row_part( $row ) !== $key ) {
					continue;
				}
				if ( 'sets' === $key ) {
					$set = addon_boss_option_set( (string) $row['set'] );
					if ( $set ) {
						$names[] = (string) $set['name'];
					}
					continue;
				}
				// Its own variable: reusing $label here clobbered the PART's
				// caption, so the "Fields" tick was titled after whichever
				// field happened to come last.
				$field_label = trim( (string) ( $row['field']['label'] ?? '' ) );
				$names[]     = '' !== $field_label ? $field_label : __( 'Field', 'addon-boss' );
			}
			$have = (bool) $names;
			$keep = array_slice( $names, 0, 3 );
			if ( count( $names ) > 3 ) {
				/* translators: %s: how many more there are beyond the ones shown */
				$keep[] = sprintf( __( '+%s more', 'addon-boss' ), number_format_i18n( count( $names ) - 3 ) );
			}
			$bits = implode( ', ', $keep );
		} elseif ( 'positions' === $key ) {
			$sets = get_post_meta( $product_id, '_bundle_boss_position_sets', true );
			$n    = is_array( $sets ) ? count( $sets ) : 0;
			$have = $n > 0;
			/* translators: %s: how many print/embroidery positions the product carries. */
			$bits = $have ? sprintf( _n( '%s position', '%s print areas', $n, 'addon-boss' ), number_format_i18n( $n ) ) : '';
		} elseif ( 'breaks' === $key ) {
			$meta = get_post_meta( $product_id, '_addon_boss_qty_discount', true );
			$have = is_array( $meta ) && ! empty( $meta['enabled'] );
			if ( $have ) {
				$list  = ! empty( $meta['source'] ) && function_exists( 'addon_boss_break_list' ) ? addon_boss_break_list( (string) $meta['source'] ) : null;
				$bands = count( (array) ( $meta['bands'] ?? array() ) );
				if ( $list ) {
					/* translators: %s: the saved break list's name. */
					$bits = sprintf( __( 'list: %s', 'addon-boss' ), (string) $list['name'] );
				} elseif ( $bands > 0 ) {
					/* translators: %s: how many quantity bands the product carries. */
					$bits = sprintf( _n( '%s band', '%s bands', $bands, 'addon-boss' ), number_format_i18n( $bands ) );
				}
				// Enabled with no bands and no list says nothing beyond the label.
			}
		} else {
			$have = '' !== (string) get_post_meta( $product_id, ADDON_BOSS_OPTIONS_LAYOUT_META, true );
		}
		$out[] = array(
			'key'   => (string) $key,
			'label' => (string) $label,
			'have'  => $have,
			'bits'  => $bits,
		);
	}
	return $out;
}

/**
 * Products worth taking from: they HAVE a setup, they are not the
 * product being edited, and they match by name OR by SKU (a shop that
 * lives in SKUs finds by SKU). An empty search suggests the edited
 * product's own categories first, so the likely source is one tap
 * away even in a big catalogue.
 *
 * @return int[] Product ids, best first, capped.
 */
function addon_boss_take_candidates( string $q, int $receiver_id, int $cap = 20 ): array {
	$base = array(
		'type'   => array( 'simple', 'variable' ),
		'status' => 'publish',
		'limit'  => $cap * 3,
		'return' => 'ids',
	);
	$ids = array();
	if ( '' !== $q ) {
		$byname = wc_get_products( array_merge( $base, array( 's' => $q ) ) );
		$bysku  = wc_get_products( array_merge( $base, array( 'sku' => $q ) ) );
		$ids    = array_merge( (array) $byname, (array) $bysku );
	} else {
		$cats = wc_get_product_term_ids( $receiver_id, 'product_cat' );
		if ( $cats ) {
			$ids = (array) wc_get_products( array_merge( $base, array( 'category' => array_map( static fn( $t ) => get_term( $t, 'product_cat' )->slug ?? '', $cats ) ) ) );
		}
		$ids = array_merge( $ids, (array) wc_get_products( array_merge( $base, array( 'orderby' => 'date', 'order' => 'DESC' ) ) ) );
	}
	$out = array();
	foreach ( array_unique( array_map( 'intval', $ids ) ) as $id ) {
		if ( $id === $receiver_id ) {
			continue;
		}
		$candidate = wc_get_product( $id );
		if ( ! $candidate instanceof WC_Product || ! addon_boss_product_option_config( $candidate, true ) ) {
			continue;
		}
		$out[] = $id;
		if ( count( $out ) >= $cap ) {
			break;
		}
	}
	return $out;
}

/** Search, for the picker: rows with name, SKU and what-it-carries chips. */
function addon_boss_take_search_ajax(): void {
	check_ajax_referer( 'bb_take' );
	if ( ! current_user_can( 'manage_woocommerce' ) ) {
		wp_send_json_error( array( 'message' => __( 'You are not allowed to do that.', 'addon-boss' ) ), 403 );
	}
	$q        = isset( $_GET['q'] ) ? sanitize_text_field( wp_unslash( $_GET['q'] ) ) : '';
	$receiver = isset( $_GET['product'] ) ? (int) $_GET['product'] : 0;
	wp_send_json( array( 'results' => addon_boss_take_search_rows( $q, $receiver ) ) );
}
add_action( 'wp_ajax_addon_boss_take_search', 'addon_boss_take_search_ajax' );

/**
 * The picker's rows: each product with a setup, its SKU, and what it carries.
 *
 * @param string $q        What was typed.
 * @param int    $receiver The product being edited.
 * @return array<int,array>
 */
function addon_boss_take_search_rows( string $q, int $receiver ): array {
	$rows = array();
	foreach ( addon_boss_take_candidates( $q, $receiver ) as $id ) {
		$candidate = wc_get_product( $id );
		$chips     = array();
		foreach ( addon_boss_take_summary( $id ) as $part ) {
			if ( ! $part['have'] ) {
				continue;
			}
			// Sets and fields now name themselves in $part['bits'], so the chip
			// is the same shape for every part. It used to count config rows as
			// "sets", which counted fields and sections as sets too.
			if ( 'layout' !== $part['key'] ) {
				$chips[] = '' !== $part['bits'] ? $part['bits'] : $part['label'];
			}
		}
		// Plain text: the picker sets it as text, so a name stored with
		// entities read "Mirrored &amp; Metallic" (walk 5, 30 Oct 2026).
		$rows[] = array(
			'id'   => $id,
			'text' => html_entity_decode( (string) $candidate->get_name(), ENT_QUOTES, 'UTF-8' ),
			'sku'  => html_entity_decode( (string) $candidate->get_sku(), ENT_QUOTES, 'UTF-8' ),
			'bits' => array_map(
				static function ( $bit ) {
					return html_entity_decode( (string) $bit, ENT_QUOTES, 'UTF-8' );
				},
				$chips
			),
		);
	}
	return $rows;
}

/** Peek, for the ticks: the picked source's parts with captions. */
function addon_boss_take_peek_ajax(): void {
	check_ajax_referer( 'bb_take' );
	if ( ! current_user_can( 'manage_woocommerce' ) ) {
		wp_send_json_error( array( 'message' => __( 'You are not allowed to do that.', 'addon-boss' ) ), 403 );
	}
	$source   = isset( $_POST['source'] ) ? (int) $_POST['source'] : 0;
	$receiver = isset( $_POST['product'] ) ? (int) $_POST['product'] : 0;
	wp_send_json_success( array(
		'parts'   => addon_boss_take_summary( $source ),
		'collide' => addon_boss_take_collisions( $source, $receiver ),
	) );
}
add_action( 'wp_ajax_addon_boss_take_peek', 'addon_boss_take_peek_ajax' );

/**
 * Copying a set whose choices mirror the receiver's variations would put two
 * "pick your colour" controls on one page: the variations deciding the
 * product, the set charging for the answer again. Name the overlap so the
 * merchant decides knowingly. A hit is a set whose name matches a variation
 * attribute's label, or that shares two or more choice labels with one
 * attribute's values; single-word overlaps stay quiet because "Black" in a
 * finishes set is not a colour chooser.
 *
 * @return string[] One sentence per colliding set.
 */
function addon_boss_take_collisions( int $source_id, int $receiver_id ): array {
	$source   = wc_get_product( $source_id );
	$receiver = wc_get_product( $receiver_id );
	if ( ! $source instanceof WC_Product || ! $receiver instanceof WC_Product || ! $receiver->is_type( 'variable' ) ) {
		return array();
	}
	$attrs = array();
	foreach ( $receiver->get_variation_attributes() as $bb_attr => $bb_values ) {
		$bb_label = wc_attribute_label( str_replace( 'attribute_', '', (string) $bb_attr ), $receiver );
		$attrs[ $bb_label ] = array_map( 'strtolower', array_map( 'trim', array_map( 'strval', (array) $bb_values ) ) );
	}
	if ( ! $attrs ) {
		return array();
	}
	$out = array();
	foreach ( addon_boss_config_render_sequence( addon_boss_product_option_config( $source, true ) ) as $row ) {
		if ( 'sets' !== addon_boss_copy_row_part( $row ) ) {
			continue;
		}
		$set = addon_boss_option_set( (string) $row['set'] );
		if ( ! $set ) {
			continue;
		}
		$labels = array();
		foreach ( (array) ( $set['options'] ?? array() ) as $bb_opt ) {
			$bb_l = strtolower( trim( (string) ( $bb_opt['label'] ?? '' ) ) );
			if ( '' !== $bb_l ) {
				$labels[] = $bb_l;
			}
		}
		foreach ( $attrs as $bb_label => $bb_values ) {
			$name_hit = strtolower( trim( (string) $set['name'] ) ) === strtolower( trim( (string) $bb_label ) );
			if ( $name_hit || count( array_intersect( $labels, $bb_values ) ) >= 2 ) {
				// This sentence travels as JSON and lands via textContent,
				// so it carries real characters, never HTML entities.
				$out[] = sprintf(
					/* translators: 1: the option set's name. 2: the variation attribute it overlaps. */
					__( 'The set “%1$s” shares its choices with this product’s %2$s variations. Variations stay the shopper’s main pick; taking this set would ask for %2$s again as a paid extra.', 'addon-boss' ),
					(string) $set['name'],
					(string) $bb_label
				);
				break;
			}
		}
	}
	return $out;
}

/** The take itself: the ticked parts land on the product being edited. */
function addon_boss_take_apply_ajax(): void {
	check_ajax_referer( 'bb_take' );
	if ( ! current_user_can( 'manage_woocommerce' ) ) {
		wp_send_json_error( array( 'message' => __( 'You are not allowed to do that.', 'addon-boss' ) ), 403 );
	}
	$source   = isset( $_POST['source'] ) ? (int) $_POST['source'] : 0;
	$receiver = isset( $_POST['product'] ) ? (int) $_POST['product'] : 0;
	$parts    = isset( $_POST['parts'] ) ? array_map( 'sanitize_key', (array) wp_unslash( $_POST['parts'] ) ) : array();
	if ( ! addon_boss_copy_apply_one( $source, $receiver, $parts ) ) {
		wp_send_json_error( array( 'message' => __( 'Nothing was taken. Pick a product and at least one part.', 'addon-boss' ) ), 400 );
	}
	$bb_title = sanitize_text_field( wp_unslash( (string) ( $_POST['title'] ?? '' ) ) );
	if ( ! empty( $_POST['copies'] ) && in_array( 'sets', $parts, true ) ) {
		addon_boss_take_copies( $source, $receiver, $bb_title );
	}
	$bb_edit = addon_boss_take_keep_new( $receiver, $bb_title );
	wp_send_json_success( '' !== $bb_edit ? array( 'edit' => $bb_edit ) : null );
}

/**
 * "Copies of the sets, for this product only": each set the take brought
 * from the source is copied (addon_boss_duplicate_option_set) and the
 * product's row points at the copy, so its prices can change without
 * touching the source's. Rows keep everything else (Required, prices for
 * this product, conditions): the copy has the same choices, keys and all.
 *
 * @param int    $source   The product taken from.
 * @param int    $receiver The product taken onto.
 * @param string $title    The receiver's title as typed ('' for its own).
 * @return array<string,string> Set id => its copy's id.
 */
function addon_boss_take_copies( int $source, int $receiver, string $title = '' ): array {
	$from = wc_get_product( $source );
	$to   = wc_get_product( $receiver );
	if ( ! $from instanceof WC_Product || ! $to instanceof WC_Product ) {
		return array();
	}
	$theirs = array();
	foreach ( addon_boss_flatten_option_config( addon_boss_product_option_config( $from, true ) ) as $bb_row ) {
		if ( is_array( $bb_row ) && 'field' !== ( $bb_row['row_type'] ?? '' ) && '' !== (string) ( $bb_row['set'] ?? '' ) ) {
			$theirs[ (string) $bb_row['set'] ] = true;
		}
	}
	$name = '' !== $title ? $title : $to->get_name();
	$map  = array();
	$swap = static function ( array $rows ) use ( &$swap, &$map, $theirs, $name ): array {
		foreach ( $rows as $bb_k => $bb_row ) {
			if ( ! is_array( $bb_row ) ) {
				continue;
			}
			if ( 'group' === ( $bb_row['row_type'] ?? '' ) ) {
				$rows[ $bb_k ]['children'] = $swap( (array) ( $bb_row['children'] ?? array() ) );
				continue;
			}
			$bb_sid = (string) ( $bb_row['set'] ?? '' );
			if ( '' === $bb_sid || 'field' === ( $bb_row['row_type'] ?? '' ) || ! isset( $theirs[ $bb_sid ] ) ) {
				continue;
			}
			if ( ! isset( $map[ $bb_sid ] ) ) {
				$bb_set          = addon_boss_option_set( $bb_sid );
				$map[ $bb_sid ] = $bb_set ? addon_boss_duplicate_option_set(
					$bb_sid,
					'' !== $name
						/* translators: 1: a set's name, like Glass size, 2: the product its copy is for, like Clear Glass 8 mm */
						? sprintf( __( '%1$s (%2$s)', 'addon-boss' ), (string) $bb_set['name'], $name )
						: ''
				) : '';
			}
			if ( '' !== $map[ $bb_sid ] ) {
				$rows[ $bb_k ]['set'] = $map[ $bb_sid ];
			}
		}
		return $rows;
	};
	$rows = $swap( addon_boss_product_option_config( $to, true ) );
	if ( array_filter( $map ) ) {
		addon_boss_save_product_option_config( $to, $rows );
	}
	return array_filter( $map );
}

/**
 * A product not saved yet (Add new product) is WordPress's auto-draft: the
 * reload after a take opened a fresh, empty one, the title typed was lost,
 * and the setup sat on a draft nobody could find (walk 3, 30 Oct 2026). It is
 * saved as a draft under the title typed, and the page opens it.
 *
 * @param int    $id    The product the setup was taken onto.
 * @param string $title The title typed on the page.
 * @return string Its edit link where it was kept, '' where it was saved already.
 */
function addon_boss_take_keep_new( int $id, string $title ): string {
	$post = get_post( $id );
	if ( ! $post || 'auto-draft' !== $post->post_status || ! current_user_can( 'edit_post', $id ) ) {
		return '';
	}
	wp_update_post(
		array(
			'ID'          => $id,
			'post_status' => 'draft',
			'post_title'  => $title,
		)
	);
	return (string) get_edit_post_link( $id, 'raw' );
}
add_action( 'wp_ajax_addon_boss_take_apply', 'addon_boss_take_apply_ajax' );

/**
 * The card on the Options tab. A product with no setup gets it open,
 * ready; a product that already has one keeps it folded behind a quiet
 * "Start from another product" line, because then it is the rarer path.
 */
function addon_boss_take_panel( $product ): void {
	if ( ! $product instanceof WC_Product || ! current_user_can( 'manage_woocommerce' ) ) {
		return;
	}
	$has_own = (bool) addon_boss_product_option_config( $product, true );
	// A card offering to copy from nothing misleads, so the store is asked
	// directly: does any OTHER product carry a setup? The search cannot
	// answer this (it scans recent and same-category products up to a cap,
	// so a shop whose one configured product is old would get a false
	// "none"). One bounded existence probe, exact by construction: saving
	// an empty config deletes the meta, so EXISTS means a real setup.
	$sources_exist = (bool) get_posts(
		array(
			'post_type'      => 'product',
			'post_status'    => 'publish',
			'posts_per_page' => 1,
			'fields'         => 'ids',
			'post__not_in'   => array( $product->get_id() ),
			'no_found_rows'  => true,
			'meta_query'     => array( array( 'key' => ADDON_BOSS_PRODUCT_OPTIONS_META, 'compare' => 'EXISTS' ) ), // phpcs:ignore WordPress.DB.SlowDBQuery.slow_db_query_meta_query -- one admin-only existence probe, limit 1.
		)
	);
	if ( ! $sources_exist ) {
		// The shop's only configured product offers nothing to take; on an
		// unconfigured one the card explains itself instead of presenting a
		// search whose every answer would be a refusal.
		if ( $has_own ) {
			return;
		}
		?>
		<div class="bb-take" id="bb-take">
			<h4><?php esc_html_e( 'Take the setup from another product', 'addon-boss' ); ?></h4>
			<p class="bb-take-why bb-take-nothing"><?php esc_html_e( 'No product has a setup to copy yet. Build one product&#8217;s options first, then bring them into others from here.', 'addon-boss' ); ?></p>
		</div>
		<?php
		return;
	}
	$card = static function () use ( $product, $has_own ): void {
		?>
		<div class="bb-take" id="bb-take"
			data-product="<?php echo esc_attr( (string) $product->get_id() ); ?>"
			data-nonce="<?php echo esc_attr( wp_create_nonce( 'bb_take' ) ); ?>"
			data-has-own="<?php echo esc_attr( $has_own ? '1' : '0' ); ?>"
			data-say-none="<?php esc_attr_e( 'none to take', 'addon-boss' ); ?>"
			data-say-search="<?php esc_attr_e( 'Search finished products by name or SKU', 'addon-boss' ); ?>"
			<?php /* translators: %s: the product name whose setup already exists here. */ ?>
			data-say-warn="<?php esc_attr_e( 'This product already has a setup. Taking these parts replaces it; anything not ticked is left as it is.', 'addon-boss' ); ?>"
			data-say-nomatch="<?php esc_attr_e( 'Only products that already have a setup can be copied. Nothing here matches.', 'addon-boss' ); ?>">
			<h4><?php esc_html_e( 'Take the setup from another product', 'addon-boss' ); ?></h4>
			<?php
			// True to what a take does: the rows are copied, the sets they
			// point at stay shared. "A copy, not a link" stood over a take
			// that attached the very same set (walk 3, 30 Oct 2026). Taking a
			// shared glass setup onto the 8 mm product and then wanting the 8
			// mm prices took a trip through the library, a Duplicate, and a
			// swap nothing pointed at (walk 5): the copies are one tick here,
			// in the take itself (addon_boss_take_copies).
			?>
			<?php // The line swaps while copies are ticked: it said "Sets stay shared" over a take that copied them (walk 6). ?>
			<p class="bb-take-why" id="bb-take-why" data-copies="<?php esc_attr_e( 'This product gets its own copies of the sets: a change to a copy reaches only this product. Photo overrides stay behind.', 'addon-boss' ); ?>" data-shared="<?php esc_attr_e( 'Sets stay shared: a change to one reaches every product with it. Photo overrides stay behind.', 'addon-boss' ); ?>"><?php esc_html_e( 'Sets stay shared: a change to one reaches every product with it. Photo overrides stay behind.', 'addon-boss' ); ?></p>
			<?php if ( $product->is_type( 'variable' ) ) : ?>
			<p class="bb-take-why bb-take-model"><?php esc_html_e( 'This product is variable: its variations stay the shopper&#8217;s main pick. Anything you take rides on top as a paid extra.', 'addon-boss' ); ?></p>
			<?php endif; ?>
			<select id="bb-take-src" style="width:380px"></select>
			<div class="bb-take-parts" id="bb-take-parts" hidden></div>
			<label class="bb-take-part bb-take-copies" id="bb-take-copies" hidden><input type="checkbox" id="bb-take-copies-in" value="1"> <span><b><?php esc_html_e( 'Make copies only for this product', 'addon-boss' ); ?></b></span></label>
			<div class="bb-take-warn" id="bb-take-warn" hidden></div>
			<p class="bb-take-acts">
				<button type="button" class="button bb-cta" id="bb-take-go" disabled><?php esc_html_e( 'Take these parts', 'addon-boss' ); ?></button>
				<button type="button" class="button" id="bb-take-cancel" hidden><?php esc_html_e( 'Cancel', 'addon-boss' ); ?></button>
			</p>
			<div class="bb-take-dirty" id="bb-take-dirty" hidden>
				<p class="bb-take-dirty-say"><?php esc_html_e( 'This page has unsaved changes. Taking this setup reloads the page and loses them.', 'addon-boss' ); ?></p>
				<p class="bb-take-dirty-acts">
					<button type="button" class="button bb-cta" id="bb-take-force"><?php esc_html_e( 'Take anyway', 'addon-boss' ); ?></button>
					<button type="button" class="button" id="bb-take-keep"><?php esc_html_e( 'Keep my changes', 'addon-boss' ); ?></button>
				</p>
			</div>
		</div>
		<?php
	};
	if ( $has_own ) {
		echo '<details class="bb-take-fold"><summary class="bb-take-fold-sum">'
			. '<span class="bb-take-fold-chev" aria-hidden="true">&#9656;</span>'
			// One name, open or shut (walk 5: "Start from another product" shut,
			// "Take the setup from another product" open). Not "Copy": the
			// sets stay shared unless copies are ticked.
			. '<span class="bb-take-fold-word"><b>' . esc_html__( 'Take the setup from another product', 'addon-boss' ) . '</b>'
			. '<i>' . esc_html__( 'Use the sets, print areas and breaks of a finished product here.', 'addon-boss' ) . '</i></span>'
			. '</summary>';
		$card();
		echo '</details>';
	} else {
		$card();
	}
	addon_boss_take_panel_js();
}
// Below the add bar, not in the settings band: this is an action, not a
// setting. The seam is its own so a module cannot land here by accident.
add_action( 'addon_boss_options_after_addbar', 'addon_boss_take_panel', 5 );

/** The card's behaviour: search, peek, take, then reload to show it. */
function addon_boss_take_panel_js(): void {
	ob_start();
	?>
	( function () {
		var root = document.getElementById( 'bb-take' );
		if ( ! root || root.dataset.bbTakeBooted || ! window.jQuery || ! jQuery.fn.select2 ) { return; }
		root.dataset.bbTakeBooted = '1';
		var $src  = jQuery( '#bb-take-src' );
		var parts = document.getElementById( 'bb-take-parts' );
		var warn  = document.getElementById( 'bb-take-warn' );
		var go    = document.getElementById( 'bb-take-go' );
		var stop  = document.getElementById( 'bb-take-cancel' );
		var dirty = document.getElementById( 'bb-take-dirty' );
		var force = document.getElementById( 'bb-take-force' );
		var keep  = document.getElementById( 'bb-take-keep' );
		var acts  = root.querySelector( '.bb-take-acts' );
		// Taking a setup reloads the page, and a reload throws away whatever
		// the merchant typed elsewhere on it: the page's own form is printed
		// once it has settled and compared again at the click. Unchanged
		// reloads freely; changed asks first. Nonces refresh on their own
		// heartbeat and this card is part of the flow, so neither counts as
		// the merchant's work.
		function formPrint() {
			var form = document.getElementById( 'post' );
			if ( ! form ) { return ''; }
			if ( window.tinyMCE && window.tinyMCE.triggerSave ) { window.tinyMCE.triggerSave(); }
			var out = [];
			Array.prototype.forEach.call( form.querySelectorAll( 'input, select, textarea' ), function ( el ) {
				// The title travels with the take, so it is never lost to it.
				// WordPress's own bookkeeping is not the merchant's work: its
				// autosave clears auto_draft and fills the slug once a title is
				// typed, and "This page has unsaved changes" stood over a page
				// with only a title on it (walk 5, 30 Oct 2026).
				if ( ! el.name || /nonce|_wp_http_referer/i.test( el.name ) || /^(post_title|auto_draft|post_name)$/.test( el.name ) ) { return; }
				if ( root.contains( el ) ) { return; }
				if ( ( 'checkbox' === el.type || 'radio' === el.type ) && ! el.checked ) { return; }
				out.push( el.name + '=' + el.value );
			} );
			return out.join( '&' );
		}
		// The snapshot waits for ready: this script runs mid-form, before the
		// fields below the panel have even parsed.
		var cleanPrint = null;
		jQuery( function () { cleanPrint = formPrint(); } );
		function calm() {
			dirty.hidden = true;
			acts.hidden  = false;
		}
		$src.select2( {
			placeholder: root.dataset.saySearch,
			allowClear: true,
			language: { noResults: function () { return root.dataset.sayNomatch; } },
			// Its own dropdown class only: bb-po-dropdown carries a blue
			// highlighted-row rule that erases the carries-line.
			dropdownCssClass: 'bb-take-drop',
			ajax: {
				url: window.ajaxurl,
				delay: 250,
				data: function ( q ) {
					return { action: 'addon_boss_take_search', _wpnonce: root.dataset.nonce, product: root.dataset.product, q: q.term || '' };
				}
			},
			templateResult: function ( row ) {
				if ( ! row.id ) { return row.text; }
				var el = document.createElement( 'div' );
				el.className = 'bb-take-row';
				var top = document.createElement( 'span' );
				top.className = 'bb-take-row-top';
				var nm = document.createElement( 'b' );
				nm.textContent = row.text;
				top.appendChild( nm );
				if ( row.sku ) {
					var sk = document.createElement( 'small' );
					sk.textContent = row.sku;
					top.appendChild( sk );
				}
				el.appendChild( top );
				var line = document.createElement( 'span' );
				line.className = 'bb-take-row-sub';
				line.textContent = ( row.bits || [] ).join( ' \u00b7 ' );
				el.appendChild( line );
				return jQuery( el );
			}
		} );
		// The lines that say whether sets stay shared follow the copies tick,
		// over the take and under the tab alike.
		function whySync() {
			var tick = document.getElementById( 'bb-take-copies-in' ), box = document.getElementById( 'bb-take-copies' );
			var on = !! tick && tick.checked && ! box.hidden;
			var why = document.getElementById( 'bb-take-why' );
			if ( why ) { why.textContent = on ? why.dataset.copies : why.dataset.shared; }
			document.querySelectorAll( '.bb-po-foot[data-copies]' ).forEach( function ( f ) { f.textContent = on ? f.dataset.copies : f.dataset.shared; } );
		}
		document.getElementById( 'bb-take-copies-in' ).addEventListener( 'change', whySync );
		function reset() {
			parts.hidden = true;
			parts.textContent = '';
			document.getElementById( 'bb-take-copies' ).hidden = true;
			document.getElementById( 'bb-take-copies-in' ).checked = false;
			whySync();
			warn.hidden = true;
			go.disabled = true;
			stop.hidden = true;
			calm();
		}
		$src.on( 'select2:clear', reset );
		$src.on( 'select2:select', function ( e ) {
			calm();
			var data = new FormData();
			data.append( 'action', 'addon_boss_take_peek' );
			data.append( '_wpnonce', root.dataset.nonce );
			data.append( 'source', String( e.params.data.id ) );
			data.append( 'product', root.dataset.product );
			fetch( window.ajaxurl, { method: 'POST', body: data, credentials: 'same-origin' } )
				.then( function ( r ) { return r.json(); } )
				.then( function ( res ) {
					if ( ! res || ! res.success ) { return; }
					parts.textContent = '';
					res.data.parts.forEach( function ( p ) {
						var row = document.createElement( 'label' );
						row.className = 'bb-take-part' + ( p.have ? '' : ' is-empty' );
						var cb = document.createElement( 'input' );
						cb.type    = 'checkbox';
						cb.value   = p.key;
						cb.checked = p.have && 'layout' !== p.key;
						cb.disabled = ! p.have;
						row.appendChild( cb );
						var txt = document.createElement( 'span' );
						var nm  = document.createElement( 'b' );
						nm.textContent = p.label;
						txt.appendChild( nm );
						var bits = document.createElement( 'i' );
						bits.textContent = ' · ' + ( p.have ? ( p.bits || '' ) : root.dataset.sayNone );
						if ( p.have && ! p.bits ) { bits.textContent = ''; }
						txt.appendChild( bits );
						row.appendChild( txt );
						parts.appendChild( row );
					} );
					parts.hidden = false;
					stop.hidden  = false;
					go.disabled  = false;
					// Copies are offered while sets are being taken.
					var setsTick = parts.querySelector( 'input[value="sets"]' );
					var copies   = document.getElementById( 'bb-take-copies' );
					var copySync = function () { copies.hidden = ! ( setsTick && setsTick.checked ); whySync(); };
					if ( setsTick ) { setsTick.addEventListener( 'change', copySync ); }
					copySync();
					var says = [];
					if ( '1' === root.dataset.hasOwn ) { says.push( root.dataset.sayWarn ); }
					( res.data.collide || [] ).forEach( function ( c ) { says.push( c ); } );
					if ( says.length ) {
						warn.textContent = says.join( ' ' );
						warn.hidden = false;
					}
				} );
		} );
		stop.addEventListener( 'click', function () {
			$src.val( null ).trigger( 'change' );
			reset();
		} );
		function apply() {
			var picked = $src.select2( 'data' );
			if ( ! picked || ! picked.length ) { return; }
			go.disabled    = true;
			force.disabled = true;
			var data = new FormData();
			data.append( 'action', 'addon_boss_take_apply' );
			data.append( '_wpnonce', root.dataset.nonce );
			data.append( 'source', String( picked[ 0 ].id ) );
			data.append( 'product', root.dataset.product );
			// A product not saved yet keeps the title typed (the take saves it
			// as a draft under it).
			var title = document.getElementById( 'title' );
			data.append( 'title', title ? title.value : '' );
			root.querySelectorAll( '#bb-take-parts .bb-take-part input:checked' ).forEach( function ( c ) { data.append( 'parts[]', c.value ); } );
			var copyIn = document.getElementById( 'bb-take-copies-in' );
			if ( copyIn && copyIn.checked && ! copyIn.closest( '[hidden]' ) ) { data.append( 'copies', '1' ); }
			fetch( window.ajaxurl, { method: 'POST', body: data, credentials: 'same-origin' } )
				.then( function ( r ) { return r.json(); } )
				.then( function ( res ) {
					if ( res && res.success ) {
						// The taken setup is best shown by the editor itself: the
						// saved draft where the product was new.
						if ( res.data && res.data.edit ) { window.location.href = res.data.edit; return; }
						// WordPress may have saved the new product as a draft
						// already (its autosave, once a title is typed): a reload
						// of Add new product would still open an empty one.
						if ( /post-new\.php/.test( window.location.pathname ) ) {
							window.location.href = window.location.pathname.replace( 'post-new.php', 'post.php' ) + '?post=' + encodeURIComponent( root.dataset.product ) + '&action=edit';
							return;
						}
						window.location.reload();
					} else {
						go.disabled    = false;
						force.disabled = false;
					}
				} );
		}
		go.addEventListener( 'click', function () {
			if ( null !== cleanPrint && formPrint() !== cleanPrint ) {
				acts.hidden  = true;
				dirty.hidden = false;
				return;
			}
			apply();
		} );
		force.addEventListener( 'click', apply );
		keep.addEventListener( 'click', calm );
	} )();
	<?php
	addon_boss_inline_js( (string) ob_get_clean() );
}

// -----------------------------------------------------------------
// The express-pay guard: hidden exactly where it would lie.
//
// An Apple Pay or Google Pay button on the PRODUCT PAGE skips the option
// form entirely: the sheet buys the bare product, the required engraving is
// never asked for, and the order arrives unmakeable (or, gateway depending,
// mispriced - the documented Stripe sheet drops fees). So on a product that
// REQUIRES an answer, the product-page express buttons are removed - hidden,
// never greyed, because a disabled Pay button breaks the wallets' own brand
// rules and absence is the WooCommerce convention. Products whose options
// are all optional KEEP their buttons: a skipped optional gift wrap is
// foregone revenue on an honest fast sale, not a corrupt order. Cart,
// mini-cart and checkout express stay untouched everywhere - they purchase
// the existing cart, whose lines already carry the chosen options.
//
// Zero settings. One filter for developers, addon_boss_allow_express_pay,
// to force the buttons back on (or off) per product.
// -----------------------------------------------------------------

/**
 * Must this product be answered before it can be bought?
 *
 * True when any attached option set or personalisation field is REQUIRED -
 * including a conditional one, because a rule can fire and make it due. The
 * result is what the express guard acts on, inverted through the developer
 * filter so a site can overrule either way.
 */
function addon_boss_express_blocked( $product ): bool {
	if ( ! $product instanceof WC_Product ) {
		$product = wc_get_product( $product );
	}
	if ( ! $product instanceof WC_Product ) {
		return false;
	}
	static $bb_cache = array();
	$bb_id = $product->get_id();
	if ( isset( $bb_cache[ $bb_id ] ) ) {
		return $bb_cache[ $bb_id ];
	}
	// A quantity-grid product sells through its cells and pills: an express
	// sheet buys one bare unit with nothing picked, so the buttons lie there
	// whatever the required flags say.
	$bb_need = addon_boss_product_uses_grid( $product );
	if ( ! $bb_need ) {
		foreach ( addon_boss_standalone_option_sets( $product ) as $bb_set ) {
			if ( ! empty( $bb_set['required'] ) ) {
				$bb_need = true;
				break;
			}
		}
	}
	if ( ! $bb_need ) {
		foreach ( addon_boss_standalone_product_fields( $product ) as $bb_f ) {
			if ( ! empty( $bb_f['required'] ) ) {
				$bb_need = true;
				break;
			}
		}
	}
	// THE UPLOAD BOX IS A REQUIRED QUESTION TOO. It is not a field and not a
	// set, so it lives in its own config and the predicate never read it: a
	// product whose only compulsory answer was "send us your artwork" kept
	// its wallet buttons and sold an order with nothing to print.
	if ( ! $bb_need && function_exists( 'addon_boss_standalone_upload_config' ) ) {
		$bb_up   = addon_boss_standalone_upload_config( $product );
		$bb_need = is_array( $bb_up ) && 'required' === ( $bb_up['mode'] ?? '' );
	}
	/**
	 * Whether express-pay buttons may show on this product's page.
	 *
	 * @param bool       $allow   True unless the product requires an answer.
	 * @param WC_Product $product The product.
	 */
	$bb_allow           = (bool) apply_filters( 'addon_boss_allow_express_pay', ! $bb_need, $product );
	$bb_cache[ $bb_id ] = ! $bb_allow;
	return $bb_cache[ $bb_id ];
}

/**
 * Every product this request is SELLING, not just the one it queried.
 *
 * is_product() is false on a page built with [product_page id="12"], and that
 * page carries a real add-to-cart form and a real wallet button. The guard
 * covered the single-product template only, so a shortcode page sold the
 * unanswerable order the template refused to.
 *
 * Cart and checkout are never in this list: their wallets buy lines that
 * already carry the answers, which is the whole point of guarding the
 * product page and nothing else.
 *
 * @return int[] Product ids, possibly empty.
 */
function addon_boss_express_page_products(): array {
	if ( ! function_exists( 'is_product' ) ) {
		return array();
	}
	if ( ( function_exists( 'is_cart' ) && is_cart() ) || ( function_exists( 'is_checkout' ) && is_checkout() ) ) {
		return array();
	}
	if ( is_product() ) {
		return array( (int) get_queried_object_id() );
	}
	$bb_post = get_post();
	if ( ! $bb_post instanceof WP_Post || ! has_shortcode( (string) $bb_post->post_content, 'product_page' ) ) {
		return array();
	}
	$bb_ids = array();
	if ( preg_match_all( '/\[product_page\b([^\]]*)\]/i', (string) $bb_post->post_content, $bb_m ) ) {
		foreach ( (array) $bb_m[1] as $bb_atts ) {
			$bb_a = shortcode_parse_atts( (string) $bb_atts );
			if ( ! is_array( $bb_a ) ) {
				continue;
			}
			if ( ! empty( $bb_a['id'] ) ) {
				$bb_ids[] = (int) $bb_a['id'];
				continue;
			}
			// The shortcode also takes a sku, which is the merchant's own word
			// for the product; resolving it is the difference between guarding
			// that page and quietly not.
			if ( ! empty( $bb_a['sku'] ) && function_exists( 'wc_get_product_id_by_sku' ) ) {
				$bb_by_sku = (int) wc_get_product_id_by_sku( (string) $bb_a['sku'] );
				if ( $bb_by_sku ) {
					$bb_ids[] = $bb_by_sku;
				}
			}
		}
	}
	return array_values( array_unique( array_filter( $bb_ids ) ) );
}

/** The guard applies to THIS page: a page selling a guarded product. */
function addon_boss_express_guard_here(): bool {
	foreach ( addon_boss_express_page_products() as $bb_id ) {
		if ( addon_boss_express_blocked( $bb_id ) ) {
			return true;
		}
	}
	return false;
}

/**
 * Is THIS page selling THIS product?
 *
 * The page-scoped test the per-product seams need. It was written first as
 * "any surface except cart and checkout", which was wrong in the direction
 * that matters: asked with no page context at all, that answered yes and the
 * guard withdrew support for a product the page was not selling, including
 * from a cart sheet whose lines already carry their options.
 *
 * Membership in the page's own product list is the honest test. It is true on
 * the single-product template, true on a [product_page] page naming this
 * product, and false everywhere else, which is what the cart needs.
 */
function addon_boss_express_page_sells( $product ): bool {
	if ( ! $product instanceof WC_Product ) {
		return false;
	}
	return in_array( (int) $product->get_id(), addon_boss_express_page_products(), true );
}

// WooPayments: its own per-product seam, on the page actually selling it.
add_filter(
	'wcpay_payment_request_is_product_supported',
	function ( $supported, $product = null ) {
		if ( $supported && addon_boss_express_page_sells( $product )
			&& addon_boss_express_blocked( $product ) ) {
			return false;
		}
		return $supported;
	},
	20,
	2
);

// WooPay has a SECOND seam of its own, which we never hooked: the express
// button and the WooPay button are separate features of the same plugin, so
// guarding one left the other selling the unanswerable order.
add_filter(
	'wcpay_woopay_button_is_product_supported',
	function ( $supported, $product = null ) {
		if ( $supported && addon_boss_express_page_sells( $product )
			&& addon_boss_express_blocked( $product ) ) {
			return false;
		}
		return $supported;
	},
	20,
	2
);

// Stripe: the product-page hide filter, deprecated once and un-deprecated
// for exactly this dynamic case. The post it hands us is the QUERIED post,
// which on a [product_page] page is the page and not the product - so that
// id is asked first and the page's own products second, or a shortcode page
// kept its Apple Pay button while the template next to it lost one.
add_filter(
	'wc_stripe_hide_payment_request_on_product_page',
	function ( $hide, $post = null ) {
		if ( $hide ) {
			return $hide;
		}
		if ( $post instanceof WP_Post && addon_boss_express_blocked( $post->ID ) ) {
			return true;
		}
		return addon_boss_express_guard_here() ? true : $hide;
	},
	20,
	2
);

// PayPal Payments: its per-product support seam for the smart buttons.
add_filter(
	'woocommerce_paypal_payments_product_supports_payment_request_button',
	function ( $supports, $product = null ) {
		if ( $supports && $product instanceof WC_Product && addon_boss_express_blocked( $product ) ) {
			return false;
		}
		return $supports;
	},
	20,
	2
);

// Square: wallets are enabled per PAGE, so on a guarded product page the
// 'product' entry is taken out of the list for that request only.
add_filter(
	'wc_square_display_digital_wallet_on_pages',
	function ( $pages ) {
		if ( is_array( $pages ) && addon_boss_express_guard_here() ) {
			$pages = array_values( array_diff( $pages, array( 'product' ) ) );
		}
		return $pages;
	},
	20
);

/**
 * The last resort for gateways with no per-product seam (Mollie's wallet
 * button, a standalone Amazon Pay): remove their known product-page wrappers
 * from the DOM, and keep watching, because wallet buttons render themselves
 * asynchronously after their eligibility checks. Robust rather than
 * contract-backed - which is why the majors above ride real filters and this
 * list is filterable.
 */
function addon_boss_express_dom_selectors(): array {
	// THESE IDS WERE WRONG, SO THE FALLBACK NEVER MATCHED ANYTHING. Read off
	// the live plugins: Mollie's direct Apple Pay button is
	// #mollie-applepayDirect-button (camel case, and present since at least
	// 7.3.0) and its PayPal button is #mollie-PayPal-button; Amazon Pay's
	// product button is #pay_with_amazon_product (present since at least
	// 2.4.0). The bare #pay_with_amazon we used to target is dropped rather
	// than kept, because it is not the product button and this list is a
	// remove. The old Mollie guesses stay: they cost nothing and an older
	// release may still use them.
	//
	// ONE list, because two copies of it is one copy that stops being
	// maintained: the remove-guard and the optional watcher sweep the same
	// buttons and must never disagree about which ones those are.
	$bb_selectors = apply_filters(
		'addon_boss_express_dom_selectors',
		array(
			'#pay_with_amazon_product',
			'.amazon-pay-button',
			'#mollie-applepayDirect-button',
			'#mollie-PayPal-button',
			'#mollie-applepay-button',
			'.mollie-applepay-direct-button',
		)
	);
	$bb_selectors = array_map( 'strval', (array) $bb_selectors );
	return array_values(
		array_filter(
			$bb_selectors,
			static function ( $bb_one ) {
				return '' !== trim( $bb_one );
			}
		)
	);
}

function addon_boss_express_guard_script(): void {
	if ( ! addon_boss_express_guard_here() ) {
		return;
	}
	$bb_selectors = addon_boss_express_dom_selectors();
	if ( ! $bb_selectors ) {
		return;
	}
	ob_start();
	?>
	( function () {
		var kill = <?php echo wp_json_encode( implode( ',', array_map( 'strval', (array) $bb_selectors ) ) ); ?>;
		function sweep( root ) {
			( root.querySelectorAll ? root : document ).querySelectorAll( kill ).forEach( function ( n ) { n.remove(); } );
		}
		sweep( document );
		if ( window.MutationObserver ) {
			new MutationObserver( function () { sweep( document ); } )
				.observe( document.body, { childList: true, subtree: true } );
		}
	} )();
	<?php
	addon_boss_inline_js( (string) ob_get_clean() );
}
add_action( 'wp_footer', 'addon_boss_express_guard_script', 5 );

/**
 * THE OPTIONAL ANSWER LEAK, which is the market complaint itself.
 *
 * A product whose questions are ALL optional keeps its wallet buttons, and
 * that is right until the moment a shopper answers one. Tick gift wrap, tap
 * Apple Pay, and the order arrives with no gift wrap and the base price in
 * the sheet: the wallet bought the bare product and the answer went nowhere.
 * Sixteen of the thirty-seven reports gathered on this are exactly that.
 *
 * So the guard becomes conditional instead of fixed. The button is hidden
 * the moment any answer exists and comes back the moment the last one is
 * cleared, which is why this hides rather than removes: a shopper who
 * changes their mind gets their fast checkout back.
 *
 * SCOPE, STATED PLAINLY: this drives the same selector list as the fallback
 * above, which covers the gateways whose product-page markup we have read.
 * WooPayments, Stripe, PayPal and Square are guarded by their own filters
 * for the required case; carrying an optional answer THROUGH those four is
 * the next phase and wants a drive against each real gateway, not a guess
 * at their markup from here.
 */
function addon_boss_express_optional_watch(): void {
	if ( addon_boss_express_guard_here() ) {
		return; // already removed outright: nothing to toggle.
	}
	$bb_any = false;
	foreach ( addon_boss_express_page_products() as $bb_id ) {
		$bb_p = wc_get_product( $bb_id );
		if ( ! $bb_p instanceof WC_Product ) {
			continue;
		}
		if ( addon_boss_standalone_option_sets( $bb_p ) || addon_boss_standalone_product_fields( $bb_p ) ) {
			$bb_any = true;
			break;
		}
		// An optional upload box is neither a set nor a field, and it is the
		// answer most worth losing: a shopper who sends artwork and then pays
		// through a wallet buys a blank product with their file orphaned.
		if ( function_exists( 'addon_boss_standalone_upload_config' )
			&& addon_boss_standalone_upload_config( $bb_p ) ) {
			$bb_any = true;
			break;
		}
	}
	if ( ! $bb_any ) {
		return;
	}
	$bb_selectors = addon_boss_express_dom_selectors();
	if ( ! $bb_selectors ) {
		return;
	}
	ob_start();
	?>
	( function () {
		var sel = <?php echo wp_json_encode( implode( ',', array_map( 'strval', $bb_selectors ) ) ); ?>;
		var panel = document.querySelector( '.bb-standalone-options' );
		if ( ! panel ) { return; }

		// AN ANSWER IS ANYTHING A SHOPPER PUT THERE. A chip they pressed, a
		// box they ticked, a word they typed, a file they sent. Read off the
		// page rather than remembered, so a reset by any route is seen.
		function answered() {
			if ( panel.querySelector( '.bb-chip.is-selected, .bb-grid-tile.is-selected, .bb-mchip.is-selected' ) ) { return true; }
			var boxes = panel.querySelectorAll( 'input[type="checkbox"], input[type="radio"]' );
			for ( var i = 0; i < boxes.length; i++ ) { if ( boxes[ i ].checked ) { return true; } }
			var typed = panel.querySelectorAll( 'input:not([type="checkbox"]):not([type="radio"]):not([type="hidden"]), textarea, select' );
			for ( var j = 0; j < typed.length; j++ ) {
				var v = String( typed[ j ].value || '' ).trim();
				if ( '' !== v && '0' !== v ) { return true; }
			}
			return !! panel.querySelector( '.bb-up-file, .bb-addon-file-name' );
		}

		function paint() {
			var on = answered();
			document.querySelectorAll( sel ).forEach( function ( n ) {
				n.classList.toggle( 'bb-xp-held', on );
			} );
		}

		// The buttons render themselves after their own eligibility checks,
		// so the sweep has to outlive the first paint exactly as the
		// remove-guard's does.
		paint();
		panel.addEventListener( 'change', paint );
		panel.addEventListener( 'input', paint );
		if ( window.MutationObserver ) {
			new MutationObserver( paint ).observe( document.body, { childList: true, subtree: true } );
		}
	} )();
	<?php
	addon_boss_inline_js( (string) ob_get_clean() );
}
add_action( 'wp_footer', 'addon_boss_express_optional_watch', 6 );