/**

	 * @return HtmlDocInfos[]

	 */

	private function buildHtmlDoc(): array {

		$htmlDocs = array();

		foreach ($this->jsFiles as $jsFile) {

			$jsPath = realpath($jsFile);

			$jsContent = file_get_contents($jsPath);

			if (!preg_match_all(

					'~(?:/\\*\\*' .

					'((?:\\n\\s+\\*\\s+(?:.*))+)' .

					'\\n\\s*\\*/)?' .

					'\\n\\tdocument\\.querySelectorAll\\(\'(.+)\'\\)~m',

					$jsContent,

					$docs,

					PREG_SET_ORDER)) {

				continue;

			}

			foreach ($docs as $doc) {

				$htmlDoc = new HtmlDocInfos();

				$htmlDoc->file = $this->htmlDocUrlForPath($jsFile);

				$htmlDoc->documentation = trim(

						preg_replace_callback(

								'~\\n\\s+\\* (.)~',

								static function (array $match): string {

									return (strtoupper($match[1]) === $match[1] ? "\n" : " ") . $match[1];

								},

								$doc[1] ?? ''));

				$htmlDoc->selector = $doc[2];

				$htmlDocs[] = $htmlDoc;

			}

		}

		

		return $htmlDocs;

	}

	/**

	 * @return object

	 * @throws ReflectionException

	 */

	private function getOpenApiPaths(): object {

		$paths = array();

		

		$iterator = new RecursiveIteratorIterator(

				new RecursiveDirectoryIterator(

						$this->endpointsDirectory,

						RecursiveDirectoryIterator::SKIP_DOTS

						| RecursiveDirectoryIterator::CURRENT_AS_PATHNAME

						| RecursiveDirectoryIterator::UNIX_PATHS),

				RecursiveIteratorIterator::LEAVES_ONLY);

		foreach ($iterator as $it) {

			if (strpos($it, 'Endpoint.php') === false) {

				// Ignore non endpoint files

				continue;

			}

			

			$endpointRelativePath = substr($it, strlen($this->endpointsDirectory), -4);

			$endpointClass = $this->endpointBaseClass . str_replace('/', '\\', $endpointRelativePath);

			$reflection = new ReflectionClass($endpointClass);

			

			if ($reflection->isAbstract() || $reflection->isInterface()) {

				// Don't treat interfaces or abstract classes, since they are utility classes

				continue;

			}

			

			$endpointConstructor = $reflection->getConstructor();

			if ($endpointConstructor !== null && count($endpointConstructor->getParameters()) > 0) {

				// Endpoint requires a parameter: it cannot be a web endpoint (it's more like a CLI one) so ignore

				continue;

			}

			

			$endpoint = new $endpointClass();

			

			$skipEndpoint = $this->doSkipEndpoint($endpoint);

			

			if ($skipEndpoint === true) {

				continue;

			} else if ($skipEndpoint === null) {

				// Unexpected class!

				throw new LogicException("The endpoint $endpointClass does not extend a known abstract class");

			}

			

			$path = array();

			$classDoc = $this->cleanDocCommentLines($reflection->getDocComment());

			$path['summary'] = $classDoc

					? $classDoc[0]

					: 'Not documented';

			$path['description'] = $classDoc && count($classDoc) > 1

					? implode("\n", array_slice($classDoc, 1))

					: 'Not documented';

			

			$parameters = array();

			foreach ($reflection->getReflectionConstants() as $const) {

				if (strpos($const->getName(), 'PARAM_') === 0) {

					$parameters[] = (object)array(

							'name' => $const->getValue(),

							'in' => 'query',

							'description' => implode("\n", $this->cleanDocCommentLines($const->getDocComment())) ?: 'Not documented'

							/*'required' => true*/

					);

				}

			}

			

			$responses = array();

			//			$operation['responses'][200] = (object)array(

			//					'description' => 'Not documented',

			//					'content' => array(

			//							'text/html' => (object)array(),

			//							'application/json' => (object)array()));

			

			$operation = array(

					'operationId' => basename($it, '.php'),

					'parameters' => $parameters,

					'responses' => (object)$responses);

			

			$verb = $this->getEndpointVerb($endpoint);

			if ($verb === null) {

				throw new LogicException("The web endpoint $endpointClass has unknown HTTP verb");

			}

			$path[$verb] = (object)$operation;

			

			$paths['/' . dirname($endpointRelativePath) . '/'] = (object)$path;

		}

		return (object)$paths;

	}

	

class MapMapcaseConstructionConstructionSubmitEndpoint extends AWebSimpleFormEndpoint {

	public const PARAM_ID_MAPCASE = 'idMapcase';

	public const PARAM_ID_BUILDING = 'idBuilding';

	

	protected function httpPost(IConfig $config): IWebUrlResponder {

		try {

			$bean = PdoProcedure::call(

					$config->getDb(),

					$config->getSessionManager()->mustBeLoggedIn(),

					Param::requiredPostId(static:ARAM_ID_MAPCASE)->getValue(),

					Param::requiredPostId(static:ARAM_ID_BUILDING)->getValue());

			return TitlemessageTemplate:uccess(

					"Chantier lancé",

					"Le chantier \"" . BuildingHtml::getLabel($bean->building->id) . "\" a été lancé.");

		} catch (NotAllowedSqlException $e) {

			return TitlemessageTemplate::forbidden(

					"Action impossible",

					"Vous ne pouvez pas construire ce bâtiment sur cette case.");

		}

	}

}