MediaWiki:Common.js: Difference between revisions

Revision as of 13:59, 16 July 2026

/* site-wide JS — VoteNY toggle is handled in Vote.js */

/* Document: / Reference: page layout
 *
 * On Document: (ns 3000) and Reference: (ns 3002) pages:
 *  – Moves all .gplx-infobox tables into a right-hand sidebar column.
 *  – On Reference: pages additionally:
 *      • Removes the redundant "Document Information" h2.
 *      • Converts the raw "Reference Details" wikitable to gplx-infobox style
 *        and moves it into the sidebar.
 *      • Renames the "Text" section heading to "Content".
 *  – Wraps sidebar + main content in a CSS-flex two-column layout.
 */
( function () {
	var ns = mw.config.get( 'wgNamespaceNumber' );
	if ( ns !== 3000 && ns !== 3002 ) { return; }

	$( function () {
		var output = document.querySelector( '.mw-parser-output' );
		if ( !output ) { return; }

		function findH2ById( id ) {
			var headings = output.querySelectorAll( 'h2' );
			for ( var i = 0; i < headings.length; i++ ) {
				var span = headings[ i ].querySelector( '.mw-headline' );
				if ( span && span.id === id ) { return headings[ i ]; }
			}
			return null;
		}

		var sidebar = document.createElement( 'div' );
		sidebar.className = 'gplx-sidebar';

		function pinToSidebar( table ) {
			table.style.setProperty( 'float',  'none',         'important' );
			table.style.setProperty( 'clear',  'none',         'important' );
			table.style.setProperty( 'margin', '0 0 1rem 0',   'important' );
			table.style.setProperty( 'width',  '100%',         'important' );
			sidebar.appendChild( table );
		}

		/* --- Move all gplx-infobox tables to sidebar --- */
		Array.from( output.querySelectorAll( 'table.gplx-infobox' ) ).forEach( pinToSidebar );

		/* --- Reference: page extras --- */
		if ( ns === 3002 ) {
			/* Remove "Document Information" h2 (table header is sufficient) */
			var docInfoH2 = findH2ById( 'Document_Information' );
			if ( docInfoH2 ) { docInfoH2.remove(); }

			/* Convert Reference Details wikitable to gplx-infobox style */
			var refDetailsH2 = findH2ById( 'Reference_Details' );
			if ( refDetailsH2 ) {
				var refTable = refDetailsH2.nextElementSibling;
				if ( refTable && refTable.tagName === 'TABLE' ) {
					refTable.classList.add( 'wikitable', 'gplx-infobox', 'gplx-ref-details' );
					refTable.removeAttribute( 'style' );
					refTable.querySelectorAll( 'th[style]' ).forEach( function ( th ) {
						th.removeAttribute( 'style' );
					} );
					/* Prepend header row identical to gplx-infobox-header */
					var tbody = refTable.querySelector( 'tbody' ) || refTable;
					var headerRow = document.createElement( 'tr' );
					var headerCell = document.createElement( 'th' );
					headerCell.colSpan = 2;
					headerCell.className = 'gplx-infobox-header';
					headerCell.textContent = 'Reference details';
					headerRow.appendChild( headerCell );
					tbody.insertBefore( headerRow, tbody.firstChild );
					pinToSidebar( refTable );
				}
				refDetailsH2.remove();
			}

			/* Rename "Text" section heading to "Content" */
			var textH2 = findH2ById( 'Text' );
			if ( textH2 ) {
				var span = textH2.querySelector( '.mw-headline' );
				if ( span ) {
					span.textContent = 'Content';
					span.id = 'Content';
				}
			}
		}

		/* --- Wrap in two-column flex layout --- */
		var layout = document.createElement( 'div' );
		layout.className = 'gplx-page-layout';

		var main = document.createElement( 'div' );
		main.className = 'gplx-main';

		while ( output.firstChild ) {
			main.appendChild( output.firstChild );
		}

		layout.appendChild( main );
		layout.appendChild( sidebar );
		output.appendChild( layout );
	} );
}() );

/* GxPlex Search — chainable filter buttons with pagination */
( function () {
	if ( mw.config.get( 'wgPageName' ) !== 'GxPlex_Search' ) {
		return;
	}

	var PAGE_SIZE = 50;

	var FILTER_GROUPS = [
		{ key: 'type',         label: 'Type' },
		{ key: 'validityArea', label: 'Validity area' },
		{ key: 'scopes',       label: 'Scope(s)' },
		{ key: 'status',       label: 'Status' },
		{ key: 'docType',      label: 'Document type' },
		{ key: 'language',     label: 'Language' },
		{ key: 'restricted',   label: 'Restricted access' }
	];

	var DOC_QUERY = '[[Document:+]]'
		+ '|?DocReference=reference'
		+ '|?DocValidityArea=validityArea'
		+ '|?DocScopes=scopes'
		+ '|?DocName=docName'
		+ '|?DocVersion=version'
		+ '|?DocStatus=status'
		+ '|?DocType=docType'
		+ '|?DocLanguage=language'
		+ '|?DocDescription=description'
		+ '|?DocRestricted=restricted'
		+ '|?DocSubmittedBy=submittedBy'
		+ '|?DocContributors=contributors'
		+ '|limit=500'
		+ '|sort=DocName'
		+ '|order=asc';

	var REF_QUERY = '[[Reference:+]]'
		+ '|?HasDocument=linkedDoc'
		+ '|?HasDocument.DocReference=reference'
		+ '|?HasDocument.DocValidityArea=validityArea'
		+ '|?HasDocument.DocScopes=scopes'
		+ '|?HasDocument.DocName=docName'
		+ '|?HasDocument.DocVersion=version'
		+ '|?HasDocument.DocStatus=status'
		+ '|?HasDocument.DocType=docType'
		+ '|?HasDocument.DocLanguage=language'
		+ '|?HasDocument.DocDescription=description'
		+ '|?HasDocument.DocRestricted=restricted'
		+ '|?HasDocument.DocSubmittedBy=submittedBy'
		+ '|?HasDocument.DocContributors=contributors'
		+ '|?RefScope=refScope'
		+ '|?RefLanguage=refLanguage'
		+ '|?RefTags=refTags'
		+ '|limit=500';

	var GLOSSARY_QUERY = '[[Glossary:+]]'
		+ '|?GlossaryShort=short'
		+ '|?GlossaryTagID=tagId'
		+ '|limit=500';

	var allResults      = [];
	var filteredResults = [];
	var currentPage     = 1;
	var activeFilters   = { keywords: {} };
	var extractsCache   = {};   // fulltext → 250-char preview string
	var renderToken     = 0;    // incremented on every renderPage; cancels stale extract callbacks

	/* ---- helpers ---- */

	function esc( str ) {
		return String( str || '' )
			.replace( /&/g, '&amp;' )
			.replace( /</g, '&lt;' )
			.replace( />/g, '&gt;' )
			.replace( /"/g, '&quot;' );
	}

	function getProp( printouts, key ) {
		var arr = printouts[ key ];
		if ( !arr || !arr.length ) { return ''; }
		return arr.map( function ( v ) {
			if ( typeof v === 'string' ) { return v; }
			return v.item !== undefined ? v.item : ( v.fulltext || '' );
		} ).filter( Boolean ).join( ', ' );
	}

	function splitValues( str ) {
		return String( str || '' ).split( /\s*[,;]\s*/ ).map( function ( v ) { return v.trim(); } ).filter( Boolean );
	}

	function splitTagIds( str ) {
		return String( str || '' ).split( '++' ).map( function ( v ) { return v.trim(); } ).filter( Boolean );
	}

	/* ---- parse SMW responses ---- */

	function parseResults( data, type ) {
		var raw = ( data.query && data.query.results ) || {};
		return Object.keys( raw ).map( function ( key ) {
			var page = raw[ key ];
			var p    = page.printouts || {};
			var docName = getProp( p, 'docName' );
			return {
				_type:        type,
				fulltext:     page.fulltext,
				url:          page.fullurl,
				displayName:  type === 'Document'
					? ( docName || page.fulltext.replace( /^Document:/, '' ) )
					: page.fulltext.replace( /^Reference:/, '' ),
				reference:    getProp( p, 'reference' ),
				validityArea: getProp( p, 'validityArea' ),
				scopes:       getProp( p, 'scopes' ),
				docName:      docName,
				version:      getProp( p, 'version' ),
				status:       getProp( p, 'status' ),
				docType:      getProp( p, 'docType' ),
				language:     getProp( p, 'language' ),
				description:  getProp( p, 'description' ),
				restricted:   getProp( p, 'restricted' ),
				submittedBy:  getProp( p, 'submittedBy' ),
				contributors: getProp( p, 'contributors' ),
				tagIds:       type === 'Reference' ? splitTagIds( getProp( p, 'refTags' ) ) : [],
				preview:      ''
			};
		} );
	}

	function parseGlossary( data ) {
		var raw = ( data.query && data.query.results ) || {};
		return Object.keys( raw ).map( function ( key ) {
			var p = raw[ key ].printouts || {};
			return {
				short: getProp( p, 'short' ),
				tagId: getProp( p, 'tagId' )
			};
		} ).filter( function ( g ) { return g.short && g.tagId; } );
	}

	/* ---- text extracts – lazy per page, cached ---- */

	function fetchPageExtracts( results, token, callback ) {
		var missing = results.filter( function ( r ) { return !( r.fulltext in extractsCache ); } );
		if ( !missing.length ) { callback( token ); return; }
		var api = new mw.Api();
		api.get( {
			action: 'query', prop: 'extracts',
			exchars: 250, exintro: true, explaintext: true,
			titles: missing.map( function ( r ) { return r.fulltext; } ).join( '|' ),
			format: 'json'
		} ).always( function ( data ) {
			if ( data && data.query && data.query.pages ) {
				Object.keys( data.query.pages ).forEach( function ( id ) {
					var pg = data.query.pages[ id ];
					extractsCache[ pg.title ] = ( pg.extract || '' )
						.replace( /\s+/g, ' ' ).trim().slice( 0, 250 );
				} );
			}
			callback( token );
		} );
	}

	/* ---- filter button data ---- */

	function collectFieldValues( results ) {
		var values = {};
		FILTER_GROUPS.forEach( function ( g ) { values[ g.key ] = {}; } );
		results.forEach( function ( r ) {
			FILTER_GROUPS.forEach( function ( g ) {
				var raw = g.key === 'type' ? r._type : r[ g.key ];
				splitValues( raw ).forEach( function ( v ) { values[ g.key ][ v ] = true; } );
			} );
		} );
		return values;
	}

	/* ---- render filter buttons ---- */

	function renderFilterButtons( filterSection, values, glossaryMatches, clearBtn ) {
		filterSection.innerHTML = '';
		activeFilters = { keywords: {} };

		var hasAnyValue = FILTER_GROUPS.some( function ( g ) {
			return Object.keys( values[ g.key ] || {} ).length > 0;
		} ) || glossaryMatches.length > 0;

		if ( !hasAnyValue ) {
			var msg = document.createElement( 'p' );
			msg.className = 'gplx-no-results';
			msg.textContent = 'No documents or references indexed yet. Import data to enable filters.';
			filterSection.appendChild( msg );
			if ( clearBtn ) { clearBtn.style.display = 'none'; }
			return;
		}

		if ( clearBtn ) { clearBtn.style.display = ''; }

		FILTER_GROUPS.forEach( function ( g ) {
			activeFilters[ g.key ] = {};
			var vals = Object.keys( values[ g.key ] || {} ).sort();
			if ( !vals.length ) { return; }

			var group = document.createElement( 'div' );
			group.className = 'gplx-filter-group';

			var label = document.createElement( 'span' );
			label.className = 'gplx-filter-label';
			label.textContent = g.label;

			var row = document.createElement( 'div' );
			row.className = 'gplx-filter-btn-row';

			vals.forEach( function ( v ) {
				var btn = document.createElement( 'button' );
				btn.type = 'button';
				btn.className = 'gplx-filter-btn';
				btn.textContent = v;
				btn.setAttribute( 'aria-pressed', 'false' );
				btn.addEventListener( 'click', function () {
					if ( activeFilters[ g.key ][ v ] ) {
						delete activeFilters[ g.key ][ v ];
						btn.classList.remove( 'is-active' );
						btn.setAttribute( 'aria-pressed', 'false' );
					} else {
						activeFilters[ g.key ][ v ] = true;
						btn.classList.add( 'is-active' );
						btn.setAttribute( 'aria-pressed', 'true' );
					}
					refresh();
				} );
				row.appendChild( btn );
			} );

			group.appendChild( label );
			group.appendChild( row );
			filterSection.appendChild( group );
		} );

		if ( glossaryMatches.length ) {
			var kwGroup = document.createElement( 'div' );
			kwGroup.className = 'gplx-filter-group';

			var kwLabel = document.createElement( 'span' );
			kwLabel.className = 'gplx-filter-label';
			kwLabel.textContent = 'Keywords';

			var kwRow = document.createElement( 'div' );
			kwRow.className = 'gplx-filter-btn-row';

			glossaryMatches
				.slice()
				.sort( function ( a, b ) { return a.short.localeCompare( b.short ); } )
				.forEach( function ( g ) {
					var btn = document.createElement( 'button' );
					btn.type = 'button';
					btn.className = 'gplx-filter-btn';
					btn.textContent = g.short;
					btn.setAttribute( 'aria-pressed', 'false' );
					btn.addEventListener( 'click', function () {
						if ( activeFilters.keywords[ g.tagId ] ) {
							delete activeFilters.keywords[ g.tagId ];
							btn.classList.remove( 'is-active' );
							btn.setAttribute( 'aria-pressed', 'false' );
						} else {
							activeFilters.keywords[ g.tagId ] = true;
							btn.classList.add( 'is-active' );
							btn.setAttribute( 'aria-pressed', 'true' );
						}
						refresh();
					} );
					kwRow.appendChild( btn );
				} );

			kwGroup.appendChild( kwLabel );
			kwGroup.appendChild( kwRow );
			filterSection.appendChild( kwGroup );
		}
	}

	/* ---- filter logic: AND across groups, OR within group ---- */

	function matchesFilters( result ) {
		var standardOk = FILTER_GROUPS.every( function ( g ) {
			var active = Object.keys( activeFilters[ g.key ] || {} );
			if ( !active.length ) { return true; }
			var fieldVal = g.key === 'type' ? result._type : ( result[ g.key ] || '' );
			var parts    = splitValues( fieldVal );
			return active.some( function ( av ) {
				return parts.some( function ( p ) {
					return p.toLowerCase() === av.toLowerCase();
				} );
			} );
		} );
		if ( !standardOk ) { return false; }

		var activeTagIds = Object.keys( activeFilters.keywords || {} );
		if ( activeTagIds.length ) {
			var resultTagIds = result.tagIds || [];
			var tagMatch = activeTagIds.some( function ( t ) {
				return resultTagIds.indexOf( t ) !== -1;
			} );
			if ( !tagMatch ) { return false; }
		}
		return true;
	}

	function applyFilters( results ) {
		var textEl = document.getElementById( 'gplx-filter-text' );
		var text   = textEl ? textEl.value.trim().toLowerCase() : '';
		return results.filter( function ( r ) {
			if ( !matchesFilters( r ) ) { return false; }
			if ( text ) {
				var hay = [
					r.displayName, r.reference, r.validityArea, r.scopes,
					r.docName, r.version, r.status, r.docType, r.language,
					r.description, r.restricted, r.submittedBy, r.contributors,
					r.preview
				].join( ' ' ).toLowerCase();
				if ( hay.indexOf( text ) === -1 ) { return false; }
			}
			return true;
		} );
	}

	/* ---- pagination ---- */

	function getPageRange( current, total ) {
		if ( total <= 7 ) {
			var pages = [];
			for ( var i = 1; i <= total; i++ ) { pages.push( i ); }
			return pages;
		}
		var result = [ 1 ];
		var left   = current - 2;
		var right  = current + 2;
		if ( left > 2 )         { result.push( '...' ); }
		for ( var j = Math.max( 2, left ); j <= Math.min( total - 1, right ); j++ ) {
			result.push( j );
		}
		if ( right < total - 1 ) { result.push( '...' ); }
		result.push( total );
		return result;
	}

	function renderPagination( total ) {
		var el = document.getElementById( 'gplx-pagination' );
		if ( !el ) { return; }
		var totalPages = Math.ceil( total / PAGE_SIZE );
		if ( totalPages <= 1 ) { el.innerHTML = ''; return; }

		var frag = document.createDocumentFragment();

		function pageBtn( label, page, isCurrent, isDisabled ) {
			var btn = document.createElement( 'button' );
			btn.type = 'button';
			btn.className = 'gplx-page-btn' + ( isCurrent ? ' gplx-page-btn--current' : '' );
			btn.textContent = label;
			btn.disabled = isDisabled || isCurrent;
			if ( isCurrent ) { btn.setAttribute( 'aria-current', 'page' ); }
			if ( !isDisabled && !isCurrent ) {
				btn.addEventListener( 'click', function () {
					currentPage = page;
					renderPage();
					var s = document.getElementById( 'gplx-search-status' );
					if ( s ) { s.scrollIntoView( { behavior: 'smooth', block: 'nearest' } ); }
				} );
			}
			return btn;
		}

		frag.appendChild( pageBtn( '‹ Previous', currentPage - 1, false, currentPage === 1 ) );

		getPageRange( currentPage, totalPages ).forEach( function ( p ) {
			if ( p === '...' ) {
				var span = document.createElement( 'span' );
				span.className = 'gplx-page-ellipsis';
				span.textContent = '…';
				frag.appendChild( span );
			} else {
				frag.appendChild( pageBtn( String( p ), p, p === currentPage, false ) );
			}
		} );

		frag.appendChild( pageBtn( 'Next ›', currentPage + 1, false, currentPage === totalPages ) );

		el.innerHTML = '';
		el.appendChild( frag );
	}

	/* ---- render results table ---- */

	function renderTable( pageResults ) {
		var container = document.getElementById( 'gplx-search-results' );
		if ( !pageResults.length ) {
			container.innerHTML = '<p class="gplx-no-results">No results match the selected filters.</p>';
			return;
		}
		var rows = pageResults.map( function ( r ) {
			var typeBadge  = r._type === 'Document'
				? '<span class="gplx-badge-doc">Document</span>'
				: '<span class="gplx-badge-ref">Reference</span>';
			var restricted = r.restricted && r.restricted.toLowerCase() === 'yes'
				? ' <span class="gplx-badge-restricted">Restricted</span>' : '';
			var preview    = r.preview
				? '<div class="gplx-result-preview">' + esc( r.preview ) + '</div>' : '';
			return '<tr>'
				+ '<td>' + typeBadge + '</td>'
				+ '<td><a href="' + esc( r.url ) + '">' + esc( r.displayName ) + '</a>'
				+ restricted + preview + '</td>'
				+ '<td>' + esc( r.validityArea ) + '</td>'
				+ '<td>' + esc( r.status ) + '</td>'
				+ '<td>' + esc( r.language ) + '</td>'
				+ '<td>' + esc( r.docType ) + '</td>'
				+ '</tr>';
		} );
		container.innerHTML = '<table class="wikitable sortable gplx-results-table">'
			+ '<thead><tr>'
			+ '<th>Type</th><th>Title</th>'
			+ '<th>Validity area</th><th>Status</th><th>Language</th><th>Document type</th>'
			+ '</tr></thead>'
			+ '<tbody>' + rows.join( '' ) + '</tbody>'
			+ '</table>';
	}

	function setStatus( msg, busy ) {
		var s = document.getElementById( 'gplx-search-status' );
		if ( !s ) { return; }
		s.textContent = msg;
		s.className   = 'gplx-search-status' + ( busy ? ' gplx-search-busy' : '' );
	}

	function renderPage() {
		var token     = ++renderToken;
		var total     = filteredResults.length;
		var totalPages = Math.ceil( total / PAGE_SIZE );
		currentPage   = Math.max( 1, Math.min( currentPage, totalPages || 1 ) );
		var start     = ( currentPage - 1 ) * PAGE_SIZE;
		var end       = Math.min( start + PAGE_SIZE, total );

		if ( total === 0 ) {
			setStatus( '0 results', false );
		} else {
			setStatus(
				'Showing ' + ( start + 1 ) + '–' + end + ' of ' + total
				+ ' result' + ( total !== 1 ? 's' : '' ),
				false
			);
		}

		var pageResults = filteredResults.slice( start, end );

		// Render immediately with any already-cached previews
		pageResults.forEach( function ( r ) { r.preview = extractsCache[ r.fulltext ] || ''; } );
		renderTable( pageResults );
		renderPagination( total );

		// Fetch extracts for this page in the background; re-render only if still on this page
		fetchPageExtracts( pageResults, token, function ( t ) {
			if ( renderToken !== t ) { return; }
			pageResults.forEach( function ( r ) { r.preview = extractsCache[ r.fulltext ] || ''; } );
			renderTable( pageResults );
		} );
	}

	function refresh() {
		filteredResults = applyFilters( allResults );
		currentPage     = 1;
		renderPage();
	}

	/* ---- spinner ---- */

	function showSpinner() {
		var el = document.getElementById( 'gplx-search-spinner' );
		if ( el ) { el.style.display = ''; }
	}

	function hideSpinner() {
		var el = document.getElementById( 'gplx-search-spinner' );
		if ( el ) { el.style.display = 'none'; }
	}

	/* ---- build container UI ---- */

	function buildUI( container ) {
		var filterSection = document.createElement( 'div' );
		filterSection.className = 'gplx-filter-buttons';

		var clearBtn = document.createElement( 'button' );
		clearBtn.type = 'button';
		clearBtn.className = 'gplx-filter-clear';
		clearBtn.textContent = 'Clear all filters';
		clearBtn.style.display = 'none';
		clearBtn.addEventListener( 'click', function () {
			FILTER_GROUPS.forEach( function ( g ) { activeFilters[ g.key ] = {}; } );
			activeFilters.keywords = {};
			document.querySelectorAll( '.gplx-filter-btn' ).forEach( function ( b ) {
				b.classList.remove( 'is-active' );
				b.setAttribute( 'aria-pressed', 'false' );
			} );
			refresh();
		} );

		var searchLabel = document.createElement( 'label' );
		searchLabel.className = 'gplx-filter-label';
		searchLabel.htmlFor = 'gplx-filter-text';
		searchLabel.textContent = 'Search in titles and text';

		var textInput = document.createElement( 'input' );
		textInput.type = 'search';
		textInput.id = 'gplx-filter-text';
		textInput.className = 'gplx-filter-input';
		textInput.placeholder = 'Search…';
		textInput.setAttribute( 'aria-label', 'Search in titles and text' );

		var searchBtn = document.createElement( 'button' );
		searchBtn.type = 'button';
		searchBtn.id = 'gplx-search-btn';
		searchBtn.className = 'gplx-filter-clear gplx-search-btn';
		searchBtn.textContent = 'Search';

		var spinner = document.createElement( 'span' );
		spinner.id = 'gplx-search-spinner';
		spinner.className = 'gplx-spinner';
		spinner.style.display = 'none';
		spinner.setAttribute( 'aria-hidden', 'true' );

		var searchRow = document.createElement( 'div' );
		searchRow.className = 'gplx-search-input-row';
		searchRow.appendChild( textInput );
		searchRow.appendChild( searchBtn );
		searchRow.appendChild( spinner );

		var searchGroup = document.createElement( 'div' );
		searchGroup.className = 'gplx-filter-group gplx-filter-group--grow';
		searchGroup.style.marginBottom = '0.5rem';
		searchGroup.appendChild( searchLabel );
		searchGroup.appendChild( searchRow );

		var status     = document.createElement( 'p' );
		status.id      = 'gplx-search-status';
		status.className = 'gplx-search-status';

		var results    = document.createElement( 'div' );
		results.id     = 'gplx-search-results';
		results.innerHTML = '<p class="gplx-no-results">Enter a search term and press Enter, or click Search to browse all documents and references.</p>';

		var pagination = document.createElement( 'nav' );
		pagination.id  = 'gplx-pagination';
		pagination.className = 'gplx-pagination';
		pagination.setAttribute( 'aria-label', 'Results pages' );

		container.innerHTML = '';
		container.appendChild( filterSection );
		container.appendChild( clearBtn );
		container.appendChild( searchGroup );
		container.appendChild( status );
		container.appendChild( results );
		container.appendChild( pagination );

		return { filterSection: filterSection, textInput: textInput, searchBtn: searchBtn, clearBtn: clearBtn };
	}

	/* ---- load data ---- */

	function load( controls ) {
		showSpinner();
		controls.searchBtn.disabled = true;
		setStatus( 'Loading…', true );
		var api             = new mw.Api();
		var docResults      = [], refResults = [], glossaryResults = [];
		var docDone         = false, refDone = false, glossaryDone = false;

		function onAllDone() {
			allResults = docResults.concat( refResults );
			var values = collectFieldValues( allResults );

			var tagIdSet = {};
			refResults.forEach( function ( r ) {
				( r.tagIds || [] ).forEach( function ( t ) { tagIdSet[ t ] = true; } );
			} );
			var glossaryMatches = glossaryResults.filter( function ( g ) {
				return tagIdSet[ g.tagId ];
			} );

			renderFilterButtons( controls.filterSection, values, glossaryMatches, controls.clearBtn );

			controls.searchBtn.disabled = false;
			hideSpinner();

			if ( allResults.length ) {
				refresh();
			} else {
				setStatus( '', false );
				document.getElementById( 'gplx-search-results' ).innerHTML =
					'<p class="gplx-no-results">No documents or references indexed yet. Import data to enable filters.</p>';
			}
		}

		api.get( { action: 'ask', query: DOC_QUERY, format: 'json' } )
			.always( function ( data ) {
				if ( data && data.query ) { docResults = parseResults( data, 'Document' ); }
				docDone = true;
				if ( refDone && glossaryDone ) { onAllDone(); }
			} );

		api.get( { action: 'ask', query: REF_QUERY, format: 'json' } )
			.always( function ( data ) {
				if ( data && data.query ) { refResults = parseResults( data, 'Reference' ); }
				refDone = true;
				if ( docDone && glossaryDone ) { onAllDone(); }
			} );

		api.get( { action: 'ask', query: GLOSSARY_QUERY, format: 'json' } )
			.always( function ( data ) {
				if ( data && data.query ) { glossaryResults = parseGlossary( data ); }
				glossaryDone = true;
				if ( docDone && refDone ) { onAllDone(); }
			} );
	}

	/* ---- init ---- */

	mw.loader.using( [ 'mediawiki.api' ], function () {
		$( function () {
			var container = document.getElementById( 'gplx-search-app' );
			if ( !container ) { return; }
			var controls = buildUI( container );

			function doSearch() {
				load( controls );
			}

			controls.searchBtn.addEventListener( 'click', doSearch );
			controls.textInput.addEventListener( 'keydown', function ( e ) {
				if ( e.key === 'Enter' ) {
					e.preventDefault();
					doSearch();
				}
			} );
		} );
	} );
}() );

/* Special:SpecialPages — add a short description under each link, since core
 * MediaWiki only shows the link text itself with no explanation. */
( function () {
	if ( mw.config.get( 'wgCanonicalSpecialPageName' ) !== 'Specialpages' ) { return; }

	var descriptions = {
		// Maintenance reports
		'Broken redirects': 'Pages that redirect to a page which no longer exists.',
		'Dead-end pages': 'Pages that contain no links to other pages.',
		'Double redirects': 'Pages that redirect to another redirect page.',
		'Long pages': 'Pages sorted by wikitext size, longest first.',
		'Oldest pages': 'Pages sorted by last-edit date, oldest first.',
		'Orphaned pages': 'Pages that no other page links to.',
		'Pages with the fewest revisions': 'Pages sorted by number of edits, fewest first.',
		'Pages without language links': 'Pages missing interlanguage links.',
		'Protected pages': 'Pages that are locked against editing or moving.',
		'Protected titles': 'Titles that are prevented from being created.',
		'Short pages': 'Pages sorted by wikitext size, shortest first.',
		'Uncategorized categories': 'Categories that are not themselves in a category.',
		'Uncategorized files': 'Uploaded files not assigned to any category.',
		'Uncategorized pages': 'Pages not assigned to any category.',
		'Uncategorized templates': 'Templates not assigned to any category.',
		'Unused categories': 'Categories that exist but contain no pages.',
		'Unused files': 'Uploaded files not used on any page.',
		'Unused templates': 'Templates not transcluded on any page.',
		'Wanted categories': 'Categories that are linked to but do not exist yet.',
		'Wanted files': 'Files that are linked to but have not been uploaded.',
		'Wanted pages': 'Pages that are linked to but do not exist yet.',
		'Wanted templates': 'Templates that are linked to but do not exist yet.',

		// Lists of pages
		'All pages': 'Alphabetical list of every page in a chosen namespace.',
		'All pages with prefix': 'Pages whose title starts with a given prefix.',
		'Approved revisions': 'Overview of pages and which revision is currently approved (ApprovedRevs).',
		'Categories': 'List of all categories and how many pages are in each.',
		'External links search': 'Find pages that link to a given external URL or domain.',
		'List of redirects': 'All pages that redirect to another page.',
		'Pages with a page property': 'Pages that have a specific technical property set.',
		'Search': 'Full-text search across the wiki.',
		'Tracking categories': 'System-generated categories used for maintenance tracking.',

		// Account management
		'Bot passwords': 'Create limited-access passwords for automated logins.',
		'Change credentials': 'Change your login credentials.',
		'Change or remove email address': 'Update or remove the email address on your account.',
		'Log in': 'Sign in to your account.',
		'Log out': 'Sign out of your account.',
		'Preferences': 'Your personal account settings.',
		'Remove credentials': 'Remove a login credential from your account.',
		'Reset password': 'Request a password reset.',
		'Reset tokens': 'Invalidate saved login tokens for your account.',

		// Users and rights
		'Active users list': 'Users who have been active recently.',
		'Autoblocks': 'IP addresses currently autoblocked because of a blocked user.',
		'Blocked users': 'List of currently blocked users and IP addresses.',
		'Create account': 'Register a new user account.',
		'Email user': 'Send another user an email, if they allow it.',
		'Grants': 'Overview of OAuth / API permission grants.',
		'Password policies': 'Password strength requirements per user group.',
		'User contributions': 'All edits made by a given user.',
		'User group rights': 'What each user group (sysop, reviewer, ...) is allowed to do.',
		'User list': 'List of all registered users.',
		'User rights': 'Change a user’s group membership, e.g. promote to reviewer.',

		// Recent changes and logs
		'Gallery of new files': 'Thumbnail gallery of recently uploaded files.',
		'Logs': 'All administrative actions: blocks, deletions, uploads, approvals, ...',
		'New pages': 'Recently created pages.',
		'Recent changes': 'Recent edits across the wiki.',
		'Related changes': 'Recent edits to pages linked from a given page.',
		'Valid change tags': 'Tags that can be attached to edits.',

		// Media reports and uploads
		'File list': 'All uploaded files.',
		'List of files with duplicates': 'Files that have duplicate copies.',
		'MIME search': 'Find files by MIME type.',
		'Media statistics': 'Counts of uploaded files by type.',
		'Search for duplicate files': 'Find files identical to a given file.',

		// Data and tools
		'API sandbox': 'Try out API requests interactively.',
		'Book sources': 'Find a book by its ISBN.',
		'Expand templates': 'See wikitext with all templates expanded.',
		'Namespace information': 'Overview of all namespaces on the wiki.',
		'Statistics': 'Wiki-wide statistics: pages, edits, users.',
		'System messages': 'All interface text messages used by MediaWiki.',
		'Version': 'Installed MediaWiki, PHP, database and extension versions.',

		// Redirecting special pages
		'Delete a page': 'Jump to the delete form for a page by name.',
		'Differences': 'Jump to a diff between two revisions.',
		'Edit a page': 'Jump to the edit form for a page by name.',
		'New section': 'Jump to adding a new talk-page section.',
		'Page history': 'Jump to a page’s revision history.',
		'Page info': 'Jump to a page’s technical information.',
		'Permanent link': 'Jump to one specific, fixed revision.',
		'Protect a page': 'Jump to the protection form for a page.',
		'Purge': 'Clear the cache for a page.',
		'Random page': 'Go to a random page.',
		'Random page in category': 'Go to a random page within a chosen category.',
		'Random redirect': 'Go to a random redirect page.',
		'Random root page': 'Go to a random top-level (non-subpage) page.',
		'Redirect by file, user, page, revision, or log ID': 'Jump directly to an item by its internal ID.',

		// High use pages
		'Most linked-to categories': 'Categories used on the most pages.',
		'Most linked-to files': 'Files used on the most pages.',
		'Most linked-to pages': 'Pages linked to from the most other pages.',
		'Most transcluded pages': 'Templates or pages transcluded the most often.',
		'Pages with the most categories': 'Pages sorted by number of categories assigned.',
		'Pages with the most interwikis': 'Pages with the most interwiki/interlanguage links.',
		'Pages with the most revisions': 'Pages sorted by edit count.',

		// Page tools
		'Compare pages': 'Compare the wikitext of two pages or revisions.',
		'Export pages': 'Download pages as a MediaWiki XML file.',
		'What links here': 'All pages that link to a given page.',

		// Semantic MediaWiki
		'Export pages to RDF': 'Download semantic data as RDF.',
		'Browse wiki': 'Browse a page’s semantic properties and values.',
		'Faceted search': 'Filter pages by their semantic properties.',
		'Search by property': 'Find pages by a specific property value.',
		'Semantic search': 'Run a structured #ask query.',
		'Concepts': 'Saved, query-defined page collections.',
		'Properties': 'List of all Semantic MediaWiki properties.',
		'Property label similarity report': 'Detect possibly duplicate or misspelled properties.',
		'Types': 'Data types available for properties.',
		'Unused properties': 'Properties that were declared but are not used on any page.',
		'Wanted properties': 'Properties used on pages but never formally declared.',
		'Constraint error list': 'Pages that violate a defined property constraint.',
		'Missing redirect annotations': 'Redirects missing their semantic annotation.',
		'Processing error list': 'Pages where a semantic query or annotation failed.',

		// Page Forms
		'Create a category': 'Set up a new category, with an optional form and template.',
		'Create a class': 'Set up a linked category, template and form as one unit.',
		'Create a form': 'Build a new PageForms form.',
		'Create a property': 'Declare a new Semantic MediaWiki property.',
		'Create a template': 'Build a new template, optionally with #set: fields.',
		'Edit multiple pages': 'Bulk-edit several pages at once via a form.',
		'Forms': 'List of all PageForms forms on the wiki.',
		'Run query': 'Build and run a semantic query interactively.',
		'Start of form': 'Pick a form and a page name to start creating a page.',
		'Templates': 'List of all templates and the forms that edit them.',

		// Other special pages
		'Contribute': 'Overview of your contributions and ratings.',
		'Top rated pages': 'Pages ranked by user rating.'
	};

	$( function () {
		var links = document.querySelectorAll( '.mw-specialpages-list li a' );
		links.forEach( function ( a ) {
			var desc = descriptions[ a.textContent.trim() ];
			if ( !desc ) { return; }
			var descEl = document.createElement( 'div' );
			descEl.className = 'gplx-sp-desc';
			descEl.textContent = desc;
			a.parentNode.appendChild( descEl );
		} );
	} );
}() );