nextcloud / server

apps/workflowengine/lib/Check/FileSize.php

Spacing +1 added lines, -1 removed lines

@@ -155,7 +155,7 @@
 	}
 
 	public function supportedEntities(): array {
-		return [ File::class ];
+		return [File::class];
 	}
 
 	public function isAvailableForScope(int $scope): bool {

Indentation +71 added lines, -71 removed lines

@@ -13,86 +13,86 @@
 
 class FileSize implements ICheck {
 
-	/** @var int */
-	protected $size;
+    /** @var int */
+    protected $size;
 
-	/**
-	 * @param IL10N $l
-	 * @param IRequest $request
-	 */
-	public function __construct(
-		protected IL10N $l,
-		protected IRequest $request,
-	) {
-	}
+    /**
+     * @param IL10N $l
+     * @param IRequest $request
+     */
+    public function __construct(
+        protected IL10N $l,
+        protected IRequest $request,
+    ) {
+    }
 
-	/**
-	 * @param string $operator
-	 * @param string $value
-	 * @return bool
-	 */
-	public function executeCheck($operator, $value) {
-		$size = $this->getFileSizeFromHeader();
+    /**
+     * @param string $operator
+     * @param string $value
+     * @return bool
+     */
+    public function executeCheck($operator, $value) {
+        $size = $this->getFileSizeFromHeader();
 
-		$value = Util::computerFileSize($value);
-		if ($size !== false) {
-			switch ($operator) {
-				case 'less':
-					return $size < $value;
-				case '!less':
-					return $size >= $value;
-				case 'greater':
-					return $size > $value;
-				case '!greater':
-					return $size <= $value;
-			}
-		}
-		return false;
-	}
+        $value = Util::computerFileSize($value);
+        if ($size !== false) {
+            switch ($operator) {
+                case 'less':
+                    return $size < $value;
+                case '!less':
+                    return $size >= $value;
+                case 'greater':
+                    return $size > $value;
+                case '!greater':
+                    return $size <= $value;
+            }
+        }
+        return false;
+    }
 
-	/**
-	 * @param string $operator
-	 * @param string $value
-	 * @throws \UnexpectedValueException
-	 */
-	public function validateCheck($operator, $value) {
-		if (!in_array($operator, ['less', '!less', 'greater', '!greater'])) {
-			throw new \UnexpectedValueException($this->l->t('The given operator is invalid'), 1);
-		}
+    /**
+     * @param string $operator
+     * @param string $value
+     * @throws \UnexpectedValueException
+     */
+    public function validateCheck($operator, $value) {
+        if (!in_array($operator, ['less', '!less', 'greater', '!greater'])) {
+            throw new \UnexpectedValueException($this->l->t('The given operator is invalid'), 1);
+        }
 
-		if (!preg_match('/^[0-9]+[ ]?[kmgt]?b$/i', $value)) {
-			throw new \UnexpectedValueException($this->l->t('The given file size is invalid'), 2);
-		}
-	}
+        if (!preg_match('/^[0-9]+[ ]?[kmgt]?b$/i', $value)) {
+            throw new \UnexpectedValueException($this->l->t('The given file size is invalid'), 2);
+        }
+    }
 
-	/**
-	 * @return string
-	 */
-	protected function getFileSizeFromHeader() {
-		if ($this->size !== null) {
-			return $this->size;
-		}
+    /**
+     * @return string
+     */
+    protected function getFileSizeFromHeader() {
+        if ($this->size !== null) {
+            return $this->size;
+        }
 
-		$size = $this->request->getHeader('OC-Total-Length');
-		if ($size === '') {
-			if (in_array($this->request->getMethod(), ['POST', 'PUT'])) {
-				$size = $this->request->getHeader('Content-Length');
-			}
-		}
+        $size = $this->request->getHeader('OC-Total-Length');
+        if ($size === '') {
+            if (in_array($this->request->getMethod(), ['POST', 'PUT'])) {
+                $size = $this->request->getHeader('Content-Length');
+            }
+        }
 
-		if ($size === '') {
-			$size = false;
-		}
+        if ($size === '') {
+            $size = false;
+        }
 
-		$this->size = $size;
-		return $this->size;
-	}
+        $this->size = $size;
+        return $this->size;
+    }
 
-	public function supportedEntities(): array {
-		return [ File::class ];
-	}
+    public function supportedEntities(): array {
+        return [ File::class ];
+    }
 
-	public function isAvailableForScope(int $scope): bool {
-		return true;
-	}
+    public function isAvailableForScope(int $scope): bool {
+        return true;
+    }
 }

apps/workflowengine/lib/Check/FileName.php

Spacing +1 added lines, -1 removed lines

@@ -155,7 +155,7 @@
 	}
 
 	public function supportedEntities(): array {
-		return [ File::class ];
+		return [File::class];
 	}
 
 	public function isAvailableForScope(int $scope): bool {

Indentation +51 added lines, -51 removed lines

@@ -16,60 +16,60 @@
 use OCP\WorkflowEngine\IFileCheck;
 
 class FileName extends AbstractStringCheck implements IFileCheck {
-	use TFileCheck;
+    use TFileCheck;
 
-	/**
-	 * @param IL10N $l
-	 * @param IRequest $request
-	 */
-	public function __construct(
-		IL10N $l,
-		protected IRequest $request,
-		private IMountManager $mountManager,
-	) {
-		parent::__construct($l);
-	}
+    /**
+     * @param IL10N $l
+     * @param IRequest $request
+     */
+    public function __construct(
+        IL10N $l,
+        protected IRequest $request,
+        private IMountManager $mountManager,
+    ) {
+        parent::__construct($l);
+    }
 
-	/**
-	 * @return string
-	 */
-	protected function getActualValue(): string {
-		$fileName = $this->path === null ? '' : basename($this->path);
-		if ($fileName === '' && (!$this->storage->isLocal() || $this->storage->instanceOfStorage(Local::class))) {
-			// Return the mountpoint name of external storage that are not mounted as user home
-			$mountPoints = $this->mountManager->findByStorageId($this->storage->getId());
-			if (empty($mountPoints) || $mountPoints[0]->getMountType() !== 'external') {
-				return $fileName;
-			}
-			$mountPointPath = rtrim($mountPoints[0]->getMountPoint(), '/');
-			$mountPointPieces = explode('/', $mountPointPath);
-			$mountPointName = array_pop($mountPointPieces);
-			if (!empty($mountPointName) && $mountPointName !== 'files' && count($mountPointPieces) !== 2) {
-				return $mountPointName;
-			}
-		}
-		return $fileName;
-	}
+    /**
+     * @return string
+     */
+    protected function getActualValue(): string {
+        $fileName = $this->path === null ? '' : basename($this->path);
+        if ($fileName === '' && (!$this->storage->isLocal() || $this->storage->instanceOfStorage(Local::class))) {
+            // Return the mountpoint name of external storage that are not mounted as user home
+            $mountPoints = $this->mountManager->findByStorageId($this->storage->getId());
+            if (empty($mountPoints) || $mountPoints[0]->getMountType() !== 'external') {
+                return $fileName;
+            }
+            $mountPointPath = rtrim($mountPoints[0]->getMountPoint(), '/');
+            $mountPointPieces = explode('/', $mountPointPath);
+            $mountPointName = array_pop($mountPointPieces);
+            if (!empty($mountPointName) && $mountPointName !== 'files' && count($mountPointPieces) !== 2) {
+                return $mountPointName;
+            }
+        }
+        return $fileName;
+    }
 
-	/**
-	 * @param string $operator
-	 * @param string $checkValue
-	 * @param string $actualValue
-	 * @return bool
-	 */
-	protected function executeStringCheck($operator, $checkValue, $actualValue): bool {
-		if ($operator === 'is' || $operator === '!is') {
-			$checkValue = mb_strtolower($checkValue);
-			$actualValue = mb_strtolower($actualValue);
-		}
-		return parent::executeStringCheck($operator, $checkValue, $actualValue);
-	}
+    /**
+     * @param string $operator
+     * @param string $checkValue
+     * @param string $actualValue
+     * @return bool
+     */
+    protected function executeStringCheck($operator, $checkValue, $actualValue): bool {
+        if ($operator === 'is' || $operator === '!is') {
+            $checkValue = mb_strtolower($checkValue);
+            $actualValue = mb_strtolower($actualValue);
+        }
+        return parent::executeStringCheck($operator, $checkValue, $actualValue);
+    }
 
-	public function supportedEntities(): array {
-		return [ File::class ];
-	}
+    public function supportedEntities(): array {
+        return [ File::class ];
+    }
 
-	public function isAvailableForScope(int $scope): bool {
-		return true;
-	}
+    public function isAvailableForScope(int $scope): bool {
+        return true;
+    }
 }

apps/settings/composer/composer/ClassLoader.php

Spacing +8 added lines, -8 removed lines

@@ -370,18 +370,18 @@ 
     private function findFileWithExtension($class, $ext)
     {
         // PSR-4 lookup
-        $logicalPathPsr4 = strtr($class, '\\', DIRECTORY_SEPARATOR) . $ext;
+        $logicalPathPsr4 = strtr($class, '\\', DIRECTORY_SEPARATOR).$ext;
 
         $first = $class[0];
         if (isset($this->prefixLengthsPsr4[$first])) {
             $subPath = $class;
             while (false !== $lastPos = strrpos($subPath, '\\')) {
                 $subPath = substr($subPath, 0, $lastPos);
-                $search = $subPath . '\\';
+                $search = $subPath.'\\';
                 if (isset($this->prefixDirsPsr4[$search])) {
-                    $pathEnd = DIRECTORY_SEPARATOR . substr($logicalPathPsr4, $lastPos + 1);
+                    $pathEnd = DIRECTORY_SEPARATOR.substr($logicalPathPsr4, $lastPos + 1);
                     foreach ($this->prefixDirsPsr4[$search] as $dir) {
-                        if (file_exists($file = $dir . $pathEnd)) {
+                        if (file_exists($file = $dir.$pathEnd)) {
                             return $file;
                         }
                     }
@@ -391,7 +391,7 @@ 
 
         // PSR-4 fallback dirs
         foreach ($this->fallbackDirsPsr4 as $dir) {
-            if (file_exists($file = $dir . DIRECTORY_SEPARATOR . $logicalPathPsr4)) {
+            if (file_exists($file = $dir.DIRECTORY_SEPARATOR.$logicalPathPsr4)) {
                 return $file;
             }
         }
@@ -403,14 +403,14 @@ 
                 . strtr(substr($logicalPathPsr4, $pos + 1), '_', DIRECTORY_SEPARATOR);
         } else {
             // PEAR-like class name
-            $logicalPathPsr0 = strtr($class, '_', DIRECTORY_SEPARATOR) . $ext;
+            $logicalPathPsr0 = strtr($class, '_', DIRECTORY_SEPARATOR).$ext;
         }
 
         if (isset($this->prefixesPsr0[$first])) {
             foreach ($this->prefixesPsr0[$first] as $prefix => $dirs) {
                 if (0 === strpos($class, $prefix)) {
                     foreach ($dirs as $dir) {
-                        if (file_exists($file = $dir . DIRECTORY_SEPARATOR . $logicalPathPsr0)) {
+                        if (file_exists($file = $dir.DIRECTORY_SEPARATOR.$logicalPathPsr0)) {
                             return $file;
                         }
                     }
@@ -420,7 +420,7 @@ 
 
         // PSR-0 fallback dirs
         foreach ($this->fallbackDirsPsr0 as $dir) {
-            if (file_exists($file = $dir . DIRECTORY_SEPARATOR . $logicalPathPsr0)) {
+            if (file_exists($file = $dir.DIRECTORY_SEPARATOR.$logicalPathPsr0)) {
                 return $file;
             }
         }

apps/settings/composer/composer/autoload_psr4.php

Spacing +1 added lines, -1 removed lines

@@ -6,5 +6,5 @@
 $baseDir = $vendorDir;
 
 return array(
-    'OCA\\Settings\\' => array($baseDir . '/../lib'),
+    'OCA\\Settings\\' => array($baseDir.'/../lib'),
 );

apps/files_versions/lib/Sabre/Plugin.php

Spacing +3 added lines, -3 removed lines

@@ -73,10 +73,10 @@
 				Request::USER_AGENT_ANDROID_MOBILE_CHROME,
 				Request::USER_AGENT_FREEBOX,
 			])) {
-			$response->addHeader('Content-Disposition', 'attachment; filename="' . rawurlencode($filename) . '"');
+			$response->addHeader('Content-Disposition', 'attachment; filename="'.rawurlencode($filename).'"');
 		} else {
-			$response->addHeader('Content-Disposition', 'attachment; filename*=UTF-8\'\'' . rawurlencode($filename)
-				. '; filename="' . rawurlencode($filename) . '"');
+			$response->addHeader('Content-Disposition', 'attachment; filename*=UTF-8\'\''.rawurlencode($filename)
+				. '; filename="'.rawurlencode($filename).'"');
 		}
 	}
 

Indentation +67 added lines, -67 removed lines

@@ -22,71 +22,71 @@
 use Sabre\HTTP\ResponseInterface;
 
 class Plugin extends ServerPlugin {
-	private Server $server;
-
-	public const VERSION_LABEL = '{http://nextcloud.org/ns}version-label';
-
-	public const VERSION_AUTHOR = '{http://nextcloud.org/ns}version-author'; // dav property for author
-
-	public function __construct(
-		private IRequest $request,
-		private IPreview $previewManager,
-	) {
-		$this->request = $request;
-	}
-
-	public function initialize(Server $server) {
-		$this->server = $server;
-
-		$server->on('afterMethod:GET', [$this, 'afterGet']);
-		$server->on('propFind', [$this, 'propFind']);
-		$server->on('propPatch', [$this, 'propPatch']);
-	}
-
-	public function afterGet(RequestInterface $request, ResponseInterface $response) {
-		$path = $request->getPath();
-		if (!str_starts_with($path, 'versions')) {
-			return;
-		}
-
-		try {
-			$node = $this->server->tree->getNodeForPath($path);
-		} catch (NotFound $e) {
-			return;
-		}
-
-		if (!($node instanceof VersionFile)) {
-			return;
-		}
-
-		$filename = $node->getVersion()->getSourceFileName();
-
-		if ($this->request->isUserAgent(
-			[
-				Request::USER_AGENT_IE,
-				Request::USER_AGENT_ANDROID_MOBILE_CHROME,
-				Request::USER_AGENT_FREEBOX,
-			])) {
-			$response->addHeader('Content-Disposition', 'attachment; filename="' . rawurlencode($filename) . '"');
-		} else {
-			$response->addHeader('Content-Disposition', 'attachment; filename*=UTF-8\'\'' . rawurlencode($filename)
-				. '; filename="' . rawurlencode($filename) . '"');
-		}
-	}
-
-	public function propFind(PropFind $propFind, INode $node): void {
-		if ($node instanceof VersionFile) {
-			$propFind->handle(self::VERSION_LABEL, fn () => $node->getMetadataValue('label'));
-			$propFind->handle(self::VERSION_AUTHOR, fn () => $node->getMetadataValue('author'));
-			$propFind->handle(FilesPlugin::HAS_PREVIEW_PROPERTYNAME, fn () => $this->previewManager->isMimeSupported($node->getContentType()));
-		}
-	}
-
-	public function propPatch($path, PropPatch $propPatch): void {
-		$node = $this->server->tree->getNodeForPath($path);
-
-		if ($node instanceof VersionFile) {
-			$propPatch->handle(self::VERSION_LABEL, fn (string $label) => $node->setMetadataValue('label', $label));
-		}
-	}
+    private Server $server;
+
+    public const VERSION_LABEL = '{http://nextcloud.org/ns}version-label';
+
+    public const VERSION_AUTHOR = '{http://nextcloud.org/ns}version-author'; // dav property for author
+
+    public function __construct(
+        private IRequest $request,
+        private IPreview $previewManager,
+    ) {
+        $this->request = $request;
+    }
+
+    public function initialize(Server $server) {
+        $this->server = $server;
+
+        $server->on('afterMethod:GET', [$this, 'afterGet']);
+        $server->on('propFind', [$this, 'propFind']);
+        $server->on('propPatch', [$this, 'propPatch']);
+    }
+
+    public function afterGet(RequestInterface $request, ResponseInterface $response) {
+        $path = $request->getPath();
+        if (!str_starts_with($path, 'versions')) {
+            return;
+        }
+
+        try {
+            $node = $this->server->tree->getNodeForPath($path);
+        } catch (NotFound $e) {
+            return;
+        }
+
+        if (!($node instanceof VersionFile)) {
+            return;
+        }
+
+        $filename = $node->getVersion()->getSourceFileName();
+
+        if ($this->request->isUserAgent(
+            [
+                Request::USER_AGENT_IE,
+                Request::USER_AGENT_ANDROID_MOBILE_CHROME,
+                Request::USER_AGENT_FREEBOX,
+            ])) {
+            $response->addHeader('Content-Disposition', 'attachment; filename="' . rawurlencode($filename) . '"');
+        } else {
+            $response->addHeader('Content-Disposition', 'attachment; filename*=UTF-8\'\'' . rawurlencode($filename)
+                . '; filename="' . rawurlencode($filename) . '"');
+        }
+    }
+
+    public function propFind(PropFind $propFind, INode $node): void {
+        if ($node instanceof VersionFile) {
+            $propFind->handle(self::VERSION_LABEL, fn () => $node->getMetadataValue('label'));
+            $propFind->handle(self::VERSION_AUTHOR, fn () => $node->getMetadataValue('author'));
+            $propFind->handle(FilesPlugin::HAS_PREVIEW_PROPERTYNAME, fn () => $this->previewManager->isMimeSupported($node->getContentType()));
+        }
+    }
+
+    public function propPatch($path, PropPatch $propPatch): void {
+        $node = $this->server->tree->getNodeForPath($path);
+
+        if ($node instanceof VersionFile) {
+            $propPatch->handle(self::VERSION_LABEL, fn (string $label) => $node->setMetadataValue('label', $label));
+        }
+    }
 }

lib/private/AppFramework/Routing/RouteActionHandler.php

Indentation +15 added lines, -15 removed lines

@@ -29,21 +29,21 @@
 use OC\AppFramework\DependencyInjection\DIContainer;
 
 class RouteActionHandler {
-	private $controllerName;
-	private $actionName;
-	private $container;
+    private $controllerName;
+    private $actionName;
+    private $container;
 
-	/**
-	 * @param string $controllerName
-	 * @param string $actionName
-	 */
-	public function __construct(DIContainer $container, $controllerName, $actionName) {
-		$this->controllerName = $controllerName;
-		$this->actionName = $actionName;
-		$this->container = $container;
-	}
+    /**
+     * @param string $controllerName
+     * @param string $actionName
+     */
+    public function __construct(DIContainer $container, $controllerName, $actionName) {
+        $this->controllerName = $controllerName;
+        $this->actionName = $actionName;
+        $this->container = $container;
+    }
 
-	public function __invoke($params) {
-		App::main($this->controllerName, $this->actionName, $this->container, $params);
-	}
+    public function __invoke($params) {
+        App::main($this->controllerName, $this->actionName, $this->container, $params);
+    }
 }

apps/files_trashbin/lib/Sabre/RestoreFolder.php

Indentation +33 added lines, -33 removed lines

@@ -30,48 +30,48 @@
 use Sabre\DAV\INode;
 
 class RestoreFolder implements ICollection, IMoveTarget {
-	public function createFile($name, $data = null) {
-		throw new Forbidden();
-	}
+    public function createFile($name, $data = null) {
+        throw new Forbidden();
+    }
 
-	public function createDirectory($name) {
-		throw new Forbidden();
-	}
+    public function createDirectory($name) {
+        throw new Forbidden();
+    }
 
-	public function getChild($name) {
-		return null;
-	}
+    public function getChild($name) {
+        return null;
+    }
 
-	public function delete() {
-		throw new Forbidden();
-	}
+    public function delete() {
+        throw new Forbidden();
+    }
 
-	public function getName() {
-		return 'restore';
-	}
+    public function getName() {
+        return 'restore';
+    }
 
-	public function setName($name) {
-		throw new Forbidden();
-	}
+    public function setName($name) {
+        throw new Forbidden();
+    }
 
-	public function getLastModified(): int {
-		return 0;
-	}
+    public function getLastModified(): int {
+        return 0;
+    }
 
-	public function getChildren(): array {
-		return [];
-	}
+    public function getChildren(): array {
+        return [];
+    }
 
-	public function childExists($name): bool {
-		return false;
-	}
+    public function childExists($name): bool {
+        return false;
+    }
 
-	public function moveInto($targetName, $sourcePath, INode $sourceNode): bool {
-		if (!($sourceNode instanceof ITrash)) {
-			return false;
-		}
+    public function moveInto($targetName, $sourcePath, INode $sourceNode): bool {
+        if (!($sourceNode instanceof ITrash)) {
+            return false;
+        }
 
-		return $sourceNode->restore();
-	}
+        return $sourceNode->restore();
+    }
 
 }

core/Command/Group/Add.php

Spacing +3 added lines, -3 removed lines

@@ -65,7 +65,7 @@ 
 		$gid = $input->getArgument('groupid');
 		$group = $this->groupManager->get($gid);
 		if ($group) {
-			$output->writeln('<error>Group "' . $gid . '" already exists.</error>');
+			$output->writeln('<error>Group "'.$gid.'" already exists.</error>');
 			return 1;
 		} else {
 			$group = $this->groupManager->createGroup($gid);
@@ -73,9 +73,9 @@ 
 				$output->writeln('<error>Could not create group</error>');
 				return 2;
 			}
-			$output->writeln('Created group "' . $group->getGID() . '"');
+			$output->writeln('Created group "'.$group->getGID().'"');
 
-			$displayName = trim((string)$input->getOption('display-name'));
+			$displayName = trim((string) $input->getOption('display-name'));
 			if ($displayName !== '') {
 				$group->setDisplayName($displayName);
 			}

Indentation +41 added lines, -41 removed lines

@@ -36,48 +36,48 @@
 use Symfony\Component\Console\Output\OutputInterface;
 
 class Add extends Base {
-	public function __construct(
-		protected IGroupManager $groupManager,
-	) {
-		parent::__construct();
-	}
+    public function __construct(
+        protected IGroupManager $groupManager,
+    ) {
+        parent::__construct();
+    }
 
-	protected function configure() {
-		$this
-			->setName('group:add')
-			->setDescription('Add a group')
-			->addArgument(
-				'groupid',
-				InputArgument::REQUIRED,
-				'Group id'
-			)
-			->addOption(
-				'display-name',
-				null,
-				InputOption::VALUE_REQUIRED,
-				'Group name used in the web UI (can contain any characters)'
-			);
-	}
+    protected function configure() {
+        $this
+            ->setName('group:add')
+            ->setDescription('Add a group')
+            ->addArgument(
+                'groupid',
+                InputArgument::REQUIRED,
+                'Group id'
+            )
+            ->addOption(
+                'display-name',
+                null,
+                InputOption::VALUE_REQUIRED,
+                'Group name used in the web UI (can contain any characters)'
+            );
+    }
 
-	protected function execute(InputInterface $input, OutputInterface $output): int {
-		$gid = $input->getArgument('groupid');
-		$group = $this->groupManager->get($gid);
-		if ($group) {
-			$output->writeln('<error>Group "' . $gid . '" already exists.</error>');
-			return 1;
-		} else {
-			$group = $this->groupManager->createGroup($gid);
-			if (!$group instanceof IGroup) {
-				$output->writeln('<error>Could not create group</error>');
-				return 2;
-			}
-			$output->writeln('Created group "' . $group->getGID() . '"');
+    protected function execute(InputInterface $input, OutputInterface $output): int {
+        $gid = $input->getArgument('groupid');
+        $group = $this->groupManager->get($gid);
+        if ($group) {
+            $output->writeln('<error>Group "' . $gid . '" already exists.</error>');
+            return 1;
+        } else {
+            $group = $this->groupManager->createGroup($gid);
+            if (!$group instanceof IGroup) {
+                $output->writeln('<error>Could not create group</error>');
+                return 2;
+            }
+            $output->writeln('Created group "' . $group->getGID() . '"');
 
-			$displayName = trim((string)$input->getOption('display-name'));
-			if ($displayName !== '') {
-				$group->setDisplayName($displayName);
-			}
-		}
-		return 0;
-	}
+            $displayName = trim((string)$input->getOption('display-name'));
+            if ($displayName !== '') {
+                $group->setDisplayName($displayName);
+            }
+        }
+        return 0;
+    }
 }

lib/public/WorkflowEngine/EntityContext/IUrl.php

Indentation +6 added lines, -6 removed lines

@@ -32,10 +32,10 @@
  * @since 18.0.0
  */
 interface IUrl {
-	/**
-	 * returns a URL that is related to the entity, e.g. the link to a share
-	 *
-	 * @since 18.0.0
-	 */
-	public function getUrl(): string;
+    /**
+     * returns a URL that is related to the entity, e.g. the link to a share
+     *
+     * @since 18.0.0
+     */
+    public function getUrl(): string;
 }