[WebLink] Add type doc for link attributes

GromNaN · GromNaN · commit aa7ddb9c0f99 · 2025-05-15T15:50:16.000+02:00
diff --git a/src/Symfony/Component/WebLink/Link.php b/src/Symfony/Component/WebLink/Link.php
@@ -175,6 +175,11 @@ public function getRels(): array
         return array_values($this->rel);
     }
 
+    /**
+     * Returns a list of attributes that describe the target URI.
+     *
+     * @return array<string, scalar|\Stringable|list<scalar|\Stringable>>
+     */
     public function getAttributes(): array
     {
         return $this->attributes;
@@ -204,6 +209,14 @@ public function withoutRel(string $rel): static
         return $that;
     }
 
+    /**
+     * Returns an instance with the specified attribute added.
+     *
+     * If the specified attribute is already present, it will be overwritten
+     * with the new value.
+     *
+     * @param scalar|\Stringable|list<scalar|\Stringable> $value
+     */
     public function withAttribute(string $attribute, string|\Stringable|int|float|bool|array $value): static
     {
         $that = clone $this;

Original file line number	Diff line number	Diff line change
`@@ -175,6 +175,11 @@ public function getRels(): array`
`175`	`175`	`return array_values($this->rel);`
`176`	`176`	`}`
`177`	`177`
	`178`	`+ /**`
	`179`	`+ * Returns a list of attributes that describe the target URI.`
	`180`	`+ *`
	`181`	`+ * @return array<string, scalar\|\Stringable\|list<scalar\|\Stringable>>`
	`182`	`+ */`
`178`	`183`	`public function getAttributes(): array`
`179`	`184`	`{`
`180`	`185`	`return $this->attributes;`
`@@ -204,6 +209,14 @@ public function withoutRel(string $rel): static`
`204`	`209`	`return $that;`
`205`	`210`	`}`
`206`	`211`
	`212`	`+ /**`
	`213`	`+ * Returns an instance with the specified attribute added.`
	`214`	`+ *`
	`215`	`+ * If the specified attribute is already present, it will be overwritten`
	`216`	`+ * with the new value.`
	`217`	`+ *`
	`218`	`+ * @param scalar\|\Stringable\|list<scalar\|\Stringable> $value`
	`219`	`+ */`
`207`	`220`	`public function withAttribute(string $attribute, string\|\Stringable\|int\|float\|bool\|array $value): static`
`208`	`221`	`{`
`209`	`222`	`$that = clone $this;`