<?php
/**
 * Pauses synchronization while the plugin writes to translations itself
 * (creating a translation, saving translated SEO fields, propagating a change),
 * so its own writes are not pushed around again. A counter: pauses nest.
 */

declare( strict_types = 1 );

namespace AddBlack\Lang\Translation;

defined( 'ABSPATH' ) || exit;

final class SyncGuard {

	private int $depth = 0;

	public function pause(): void {
		++$this->depth;
	}

	public function resume(): void {
		$this->depth = max( 0, $this->depth - 1 );
	}

	public function is_paused(): bool {
		return $this->depth > 0;
	}

	/**
	 * Run a callback with sync paused.
	 *
	 * @template T
	 * @param callable(): T $callback
	 * @return T
	 */
	public function paused( callable $callback ): mixed {
		$this->pause();
		try {
			return $callback();
		} finally {
			$this->resume();
		}
	}
}