mediawiki-extensions-Cite/src/Parsoid/RefProcessor.php

<?php
declare( strict_types = 1 );

namespace Wikimedia\Parsoid\Ext\Cite;

use DOMElement;
use DOMNode;
use Wikimedia\Parsoid\Ext\DOMProcessor;
use Wikimedia\Parsoid\Ext\ParsoidExtensionAPI;

/**
 * wt -> html DOM PostProcessor
 */
class RefProcessor extends DOMProcessor {

	/**
	 * @inheritDoc
	 */
	public function wtPostprocess(
		ParsoidExtensionAPI $extApi, DOMNode $node, array $options, bool $atTopLevel
	): void {
		if ( $atTopLevel ) {
			$refsData = new ReferencesData();
			References::processRefs( $extApi, $refsData, $node );
			References::insertMissingReferencesIntoDOM( $extApi, $refsData, $node );
			if ( count( $refsData->embeddedErrors ) > 0 ) {
				References::addEmbeddedErrors( $extApi, $refsData, $node );
			}
		}
	}

	/**
	 * html -> wt DOM PreProcessor
	 *
	 * Nothing to do right now.
	 *
	 * But, for example, as part of some future functionality, this could be used to
	 * reconstitute page-level information from local annotations left behind by editing clients.
	 *
	 * @param ParsoidExtensionAPI $extApi
	 * @param DOMElement $root
	 */
	public function htmlPreprocess( ParsoidExtensionAPI $extApi, DOMElement $root ): void {
		// TODO
	}
}