Automatically generated hook interfaces

Add hook interfaces which were generated by a script which parses
hooks.txt and identifies caller namespaces and directories.

Hook interfaces are mostly placed in a Hook/ subdirectory
relative to the caller location. When there are callers in multiple
directories, a "primary" caller was manually selected. The exceptions to
this are:

* The source root, maintenance and tests, which use includes/Hook. Test
  hooks need to be autoloadable in a non-test request so that
  implementing test interfaces in a generic handler will not fail.
* resources uses includes/resourceloader/Hook
* The following third-level subdirectories had their hooks placed in
  the parent ../Hook:
    * includes/filerepo/file
    * includes/search/searchwidgets
    * includes/specials/forms
    * includes/specials/helpers
    * includes/specials/pagers

Parameters marked as legacy references in hooks.txt are passed
by value in the interfaces.

Bug: T240307
Change-Id: I6efe2e7dd1f0c6a3d0f4d100a4c34e41f8428720

1 files changed, 24 insertions, 0 deletions

diff --git a/includes/diff/Hook/DifferenceEngineShowDiffPageMaybeShowMissingRevisionHook.php b/includes/diff/Hook/DifferenceEngineShowDiffPageMaybeShowMissingRevisionHook.php
new file mode 100644
index 000000000000..0ccc3576437e
--- /dev/null
+++ b/includes/diff/Hook/DifferenceEngineShowDiffPageMaybeShowMissingRevisionHook.php
@@ -0,0 +1,24 @@
+<?php
+
+namespace MediaWiki\Diff\Hook;
+
+/**
+ * @stable for implementation
+ * @ingroup Hooks
+ */
+interface DifferenceEngineShowDiffPageMaybeShowMissingRevisionHook {
+	/**
+	 * called in
+	 * DifferenceEngine::showDiffPage() when revision data cannot be loaded.
+	 * Return false in order to prevent displaying the missing revision message
+	 * (i.e. to prevent DifferenceEngine::showMissingRevision() from being called).
+	 *
+	 * @since 1.35
+	 *
+	 * @param ?mixed $differenceEngine DifferenceEngine object
+	 * @return bool|void True or no return value to continue or false to abort
+	 */
+	public function onDifferenceEngineShowDiffPageMaybeShowMissingRevision(
+		$differenceEngine
+	);
+}